Skip to content

Machine contracts

MNSTRY.org contracts

These schemas define the public data this site emits. Payloads link to their exact contract, and the schemas close undeclared fields so a consumer can distinguish a compatible addition from an accidental shape change.

Knowledge graph v1 layer compatibility

The v1 graph now carries semantic, navigation, and provenance layers. A consumer that only understands the original semantic view must retain nodes whose layers include semantic and edges whose layer equals semantic.

Node filter
node.layers.includes('semantic')
Edge filter
edge.layer === 'semantic'

No repo-local semantic-only parser is known at this release. The inventory lists every repo-local machine consumer of the complete graph.

  • scripts/kg-check.mjs: Validates the complete layered graph.
  • scripts/contracts-check.mjs: Validates the complete layered graph against its schema and source binding.
  • scripts/semantic-check.mjs: Hashes semantic and navigation meaning while normalizing release-only provenance snapshots.
  • scripts/semantic-cut.mjs: Cuts events from the normalized complete graph.

The machine-readable index is at index.json. Mirrored Atelier contracts remain available in the Atelier namespace.