Module canonical 

Per-item canonical telemetry payloads: expand IngestExportBatch for exporters, future provider pull, and goldens. Primary POST / outbox stay batch-oriented.

Structs

CanonicalEnvelope

Shared context on every expanded item; identity is None until session/workspace wiring fills it.

EventItem

Fully expanded item for a single OutboundEvent row.

RepoSnapshotChunkItem

One repo snapshot chunk with batch context.

ToolSpanItem

One tool span with batch context.

WorkspaceFactSnapshotItem

Workspace-level facts (hashed skill/rule slugs from .cursor/skills and .cursor/rules discovery).

Enums

CanonicalEventName

One logical event name for third-party and docs (print-schema in a later phase).

CanonicalItem

Union of all canonical item shapes for expand_ingest_batch and mappers.

Constants

KAIZEN_SCHEMA_VERSION

Forward evolution marker on exported or pulled items (read old payloads only in migration tools).

Functions

expand_ingest_batch

Expand a redacted ingest batch to one struct per event/span/chunk; never drops rows.