Format Specification
Machine Schemas
JSON Schema Draft 2020-12 files for OCTX v0.1 and the boundary of semantic validation.
OCTX v0.1 uses JSON Schema Draft 2020-12 to validate individual JSON structures:
Each line of a JSONL file uses the corresponding record schema. All schemas allow unknown optional fields to support forward compatibility and round trips.
JSON Schema covers only the structural constraints of an individual JSON object. The OCTX semantic validator must handle:
- ZIP paths, entry types, and resource limits.
- File-manifest completeness and path uniqueness.
- The presence of at least one OKF Concept Document.
- UUID uniqueness within a Package.
- Cross-record JSONL references and relation-combination uniqueness.
- Event hierarchy, cycles, and
level. - Complete SAG-Structured coverage.
- Arrow schemas and vector coverage.
- Arrow IPC message boundaries, batch counts, row counts, total vector values, and the vectors v0.1 prohibition on body compression.
- Per-file SHA-256 and the Package Digest.
Normative sources: