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
« 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."""
3from dataclasses import dataclass
5from copytrading_engine.diagnostics.redaction import JsonValue
6from copytrading_engine.shared.payload_capture import CaptureKind, CaptureStatus, ProviderName
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
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
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)
65def safe_ledger_event(name: str) -> str:
66 return name if name in _LEDGER_EVENTS else "other"
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