cadrumo.core.observability package

Run-trace propagation and JSONL audit logging.

The initializer is inert; import contracts from their defining modules.

Submodules

• cadrumo.core.observability.capture module
  • CAPTURE_SINK
  • capture_envelopes()
  • record_emitted_envelope()
• cadrumo.core.observability.context module
  • RunContextInfo
    • RunContextInfo.run_id
    • RunContextInfo.entrypoint
    • RunContextInfo.started_at
    • RunContextInfo.arguments
    • RunContextInfo.corpus_sha256
    • RunContextInfo.db_sha256
    • RunContextInfo.cert_fingerprint
    • RunContextInfo.initial_step_id
  • RUN_CONTEXT_VAR
  • STEP_CONTEXT_VAR
  • run_context()
• cadrumo.core.observability.errors module
  • RunContextMissingError
    • RunContextMissingError.code
  • RunTraceValidationError
    • RunTraceValidationError.code
  • RunTracePersistenceError
    • RunTracePersistenceError.code
  • GoldenCaptureError
    • GoldenCaptureError.code
  • GoldenReplayMismatchError
    • GoldenReplayMismatchError.code
• cadrumo.core.observability.fingerprint module
  • compute_corpus_sha256()
  • compute_db_sha256()
  • data_root_cache_exclusions()
  • compute_data_root_sha256()
  • read_cert_fingerprint()
• cadrumo.core.observability.models module
  • Audit data policy
  • RUN_ID_PATTERN
  • ArgumentSource
    • ArgumentSource.FLAG
    • ArgumentSource.POSITIONAL
    • ArgumentSource.ENV
    • ArgumentSource.CONFIG
    • ArgumentSource.DEFAULT
  • RunEventKind
    • RunEventKind.STEP_START
    • RunEventKind.STEP_END
    • RunEventKind.NAVIGATION
    • RunEventKind.FORM_FILL
    • RunEventKind.ASSERTION
    • RunEventKind.CACHE_HIT
    • RunEventKind.ERROR
    • RunEventKind.WORKFLOW_STARTED
    • RunEventKind.WORKFLOW_COMPLETED
  • RunOutcome
    • RunOutcome.OK
    • RunOutcome.FAILED
    • RunOutcome.ABORTED
  • ArgumentRecord
    • ArgumentRecord.name
    • ArgumentRecord.value
    • ArgumentRecord.source
  • NavigationPayload
    • NavigationPayload.url
    • NavigationPayload.description
  • FormFillPayload
    • FormFillPayload.form_id
    • FormFillPayload.display_number
    • FormFillPayload.value
  • AssertionPayload
    • AssertionPayload.expectation
    • AssertionPayload.passed
    • AssertionPayload.detail
  • CacheHitPayload
    • CacheHitPayload.cache_name
    • CacheHitPayload.key
  • ErrorPayload
    • ErrorPayload.error_type
    • ErrorPayload.message
  • StepBoundaryPayload
    • StepBoundaryPayload.step_id
    • StepBoundaryPayload.label
  • WorkflowLinkPayload
    • WorkflowLinkPayload.workflow_run_id
  • GenericPayload
    • GenericPayload.fields
  • RunEventPayload
    • RunEventPayload.navigation
    • RunEventPayload.form_fill
    • RunEventPayload.assertion
    • RunEventPayload.cache_hit
    • RunEventPayload.error
    • RunEventPayload.step
    • RunEventPayload.workflow_link
    • RunEventPayload.generic
  • RunEvent
    • RunEvent.run_id
    • RunEvent.step_id
    • RunEvent.kind
    • RunEvent.payload
    • RunEvent.timestamp
    • RunEvent.module
  • RunTrace
    • RunTrace.run_id
    • RunTrace.started_at
    • RunTrace.finished_at
    • RunTrace.entrypoint
    • RunTrace.arguments
    • RunTrace.corpus_sha256
    • RunTrace.db_sha256
    • RunTrace.cert_fingerprint
    • RunTrace.outcome
• cadrumo.core.observability.recorder module
  • record_event()
• cadrumo.core.observability.redaction_rules module
  • diagnostic_rules()
• cadrumo.core.observability.sink module
  • JsonlRunSink
    • JsonlRunSink.run_id
    • JsonlRunSink.emit()
    • JsonlRunSink.close()
• cadrumo.core.observability.store module
  • ENVELOPE_FILENAME
  • validate_run_id()
  • runs_dir()
  • run_dir()
  • save_trace()
  • load_trace()
  • save_envelope()
  • load_envelope_document()
  • save_events_append()
  • iter_events()
  • iter_runs()
  • prune_run_traces()