Cairnloop.Governance.Telemetry (cairnloop v0.1.0)

Bounded telemetry for governed tool proposal events.

Metadata is constrained to allow-listed low-cardinality values so telemetry remains safe for observability and never becomes a durable workflow record (D-29).

Telemetry is emitted alongside, never instead of, ToolActionEvent inserts. Emit calls belong AFTER a successful with pipeline — not inside the with clause list (mirrors emit_review_task_event from KnowledgeAutomation).

Events

[:cairnloop, :governance, :proposal_created] — new proposal co-committed
[:cairnloop, :governance, :proposal_blocked] — proposal blocked (and persisted)
[:cairnloop, :governance, :proposal_duplicate] — idempotent duplicate returned

Summary

Functions

emit(event, measurements, metadata)

Emits a governance telemetry event.

Functions

emit(event, measurements, metadata)

Emits a governance telemetry event.

Only accepts events in @events. Unknown events are silently dropped (guard clause). All outcome/tier/mode values are normalized against allow-lists before emission to prevent high-cardinality label leakage.