This documentation describes the v2 source contract, generated exports, release integrity checks, curation process, historical archives, and integration surfaces.
| Document | Use it for |
|---|---|
| Source Data Contract | Structured source fields and validation policy. |
| JSON Export Contract | Version 2 export and graph shape. |
| Migration v2 | Breaking changes and consumer migration. |
| Build and Validation | CLI commands and acceptance gates. |
| Curation Workflow | Editing source terms and relations. |
| Curation Governance | Review roles and release sign-off. |
| Future Curation | Proposal for typed relations and alias-aware mention extraction (not implemented). |
| Archive and Provenance | Immutable historical material and hashes. |
| SUMO Integration | SUMO support scope. |
| SUMO Mapping Contract | Mapping fields and review states. |
| Downstream Integration | Importing JSON, CSV, and schemas. |
| Release Workflow | Publishing a content release. |
| Version Diff | Comparing structured source releases by stable ID. |
| Manuscript | Template-compatible manuscript source, generation, rendering, and integrity checks. |
The canonical source is ../ontology.source.json. The
CSV, JSON, and site are generated artifacts and are checked for freshness by
python3 ../scripts/ontology.py validate --strict; the same gate validates the
published source, export, and release-manifest schemas.
The publication manuscript is generated from the same source and manifest. Run
python3 ../scripts/manuscript.py render --format all to create PDF, HTML, DOCX,
and EPUB outputs, then run python3 ../scripts/manuscript.py validate --strict.