Coverage for src/copytrading_engine/diagnostics/telemetry/events.py: 100%

28 statements  

« prev     ^ index     » next       coverage.py v7.16.2, created at 2026-11-16 16:55 +0000

1"""The diagnostic events the engine records in its local journal.""" 

2 

3from dataclasses import dataclass 

4 

5from copytrading_engine.diagnostics.redaction import JsonValue 

6from copytrading_engine.shared.payload_capture import CaptureKind, CaptureStatus, ProviderName 

7 

8 

9@dataclass(frozen=True) 

10class DiagnosticEvent: 

11 command_id: str 

12 trace_id: str 

13 stage: str 

14 outcome: str 

15 payload: JsonValue | None 

16 previous_stage: str | None 

17 created_at_ns: int 

18 anchor_exported: bool | None = None 

19 capture_status: CaptureStatus = "complete" 

20 payload_bytes: int = 0 

21 redacted_fields: int = 0 

22 

23 

24@dataclass(frozen=True) 

25class DiagnosticPayloadEvent: 

26 capture_kind: CaptureKind 

27 capture_status: CaptureStatus 

28 workflow_id: str | None 

29 trace_id: str | None 

30 destination_id: str | None 

31 attempt: int | None 

32 provider: ProviderName 

33 payload: JsonValue | None 

34 payload_bytes: int 

35 redacted_fields: int 

36 created_at_ns: int 

37 

38 

39_LEDGER_EVENTS = frozenset( 

40 { 

41 "account_bound", 

42 "signal_rejected", 

43 "message", 

44 "skipped", 

45 "message_done", 

46 "order_prepared", 

47 "submit_started", 

48 "submission_aborted", 

49 "submission_uncertain", 

50 "broker_acknowledged", 

51 "cancel_requested", 

52 "quote_unavailable", 

53 "submit_error", 

54 "submission_quote", 

55 "manual_sale_recorded", 

56 "order_intent_released", 

57 "late_order_incident_cleared", 

58 "order_update", 

59 "late_order_incident_opened", 

60 "late_order_incident_reopened", 

61 } 

62) 

63 

64 

65def safe_ledger_event(name: str) -> str: 

66 return name if name in _LEDGER_EVENTS else "other" 

67 

68 

69@dataclass(frozen=True) 

70class TradingDiagnosticEvent: 

71 operation: str 

72 outcome: str 

73 trace_id: str | None 

74 signal_ref: str | None 

75 ledger_event: str | None 

76 created_at_ns: int 

77 workflow_id: str | None = None 

78 destination_id: str | None = None 

79 attempt: int | None = None 

80 # What a ledger event was about, kept only when each value passes its pattern. 

81 symbol: str | None = None 

82 side: str | None = None 

83 qty: str | None = None 

84 limit_price: str | None = None 

85 source_price: str | None = None 

86 status: str | None = None 

87 filled_qty: str | None = None 

88 filled_avg_price: str | None = None 

89 reason: str | None = None