Skip to content
GitHub
Reference

Events

Events are how producing contexts notify other contexts (and themselves) that something happened. Each event has a producer-owned typed payload module under <context>.contracts.events.* — the single source of truth for the wire shape per ADR-065. Consumers parse incoming envelope payloads with their own local model (the consumer ACL pattern); bilateral contract tests in tests/contracts/ pin the producer/consumer agreement.

For the substrate doctrine — transactional outbox, LISTEN/NOTIFY mechanics, schema-version + deployment-generation routing — see Event System and Event Substrate.

Wire event typeProducerTrigger
worlds.world_model_card.published (WorldModelCardPublishedEvent)spectral.worldsIn same publication transaction as the WorldModelCard mint
worlds.rule_candidate_outcome_recorded (RuleCandidateOutcomeRecordedPayload)spectral.worldsIn same enshrinement transaction as the terminal outcome record (candidate approved → enshrined, or rejected)
decision.recorded (DecisionRecordedEvent)spectral.platformAfter each /decide invocation completes
override_pattern_signal.aggregated (OverridePatternSignalAggregatedEvent)spectral.platformWhen override-pattern cluster crosses operator-triage threshold
AgentTaskCreatedEventAPINew agent task created via API