Semantic Reference¶
This directory is the durable Phase 1 reference package for DecisionGraph.
Its job is simple: make the current Python implementation explicit enough that a BEAM implementation can prove parity instead of approximating it.
Status¶
The Python implementation under src/decisiongraph is the semantic oracle until an explicit architecture decision says otherwise.
The baseline checkpoint name for this reference package is:
semantic-reference-python-v1
What Is Frozen Here¶
- event envelope structure
- supported event-type vocabulary
- payload shape expectations
- append, idempotency, and trace-sequencing behavior
- projection and replay behavior
- query ordering and staleness rules
- digest construction rules
- backend parity expectations
Machine-Readable Reference Assets¶
- checked-in bundle:
tests/golden/reference_fixture_bundle.json - bundle exporter:
scripts/export_reference_fixture_bundle.py - source fixtures:
tests/golden/*