aeat.core.observability package¶

Run-trace observability layer.

Public API for cross-subpackage run_id propagation, JSONL audit logging, and deterministic read-only replay.

Key surface area:

run_context() — the contextvars-backed boundary that mints a run_id, fingerprints corpus / db / cert state, and persists a RunTrace on exit.
record_event() — the single emit primitive every call site uses.
RunEvent, RunEventPayload, RunTrace — strict pydantic v2 record types written to JSONL.
replay_run() — deterministic re-entry into a recorded run with an AeatCorpusDriftError refusal gate.
iter_runs() / iter_events() / load_trace() / load_events() — read-only accessors over persisted traces.

Submodules¶