content-explorer/contracts/SNAPSHOT.md

13 lines
745 B
Markdown
Raw Normal View History

# Snapshot format 0.1
Normative files:
- `contracts/snapshot.schema.json` — entity, relation, source, and claim document.
- `contracts/manifest.schema.json` — presentation. Kind names, facet names, and relation wording live here.
- `contracts/MIGRATIONS.md` — version gate.
- `contracts/fact-policy.md` — missing, unknown, and contradiction.
Identifiers for entities are `urn:ce:<dataspace>:<kind>:<key>`. The same key in another dataspace is a different entity. Relation ids are local to the snapshot.
A published example must contain at least three kinds and eight entities. `scripts/validate_fixtures.py` enforces that, plus the schema, dangling references, duplicate ids, missing sources, and cycles on `acyclicPredicates` only.