Skip to main content

Module event

cortex_core

Module event 

Source
Expand description

Immutable observed-fact events.

Mirrors BUILD_SPEC §9.1. The struct is the on-disk and on-wire shape: serde field order matches the spec, and rename-style attributes are stable identifiers that may not be silently changed without a crate::SCHEMA_VERSION bump and an ADR (see crate::version).

§Stable wire strings

EventType serializes as cortex.event.<snake_case>.v<N> strings (e.g. cortex.event.user_message.v1). These strings are part of the public contract: renaming a Rust variant must NOT change the wire string. The snapshot test in this module pins every variant’s wire string and fails if a rename leaks through.

Doctrine reference: .doctrine/principles/event-contracts.md §3.

§What this version (v1) does NOT include

  • Attestation (from ADR 0014) — deliberately deferred to schema v2.
  • payload_hash is a String here; the actual BLAKE3 framing lives in cortex-ledger (lane 1.B). cortex-core only owns the typed shape.

Structs§

Event
An immutable observed fact in the Cortex ledger.

Enums§

EventSource
Where an event originated.
EventType
What kind of event was observed.