docs

Active Inference Ontology Documentation

This folder documents the source data, generated export, archive material, and operational workflows for the Active Inference Ontology repository.

Documentation Map

Document	Use it for
Source Data Contract	CSV column meanings, row requirements, and term identity rules.
JSON Export Contract	Shape of ontology.json, term records, graph nodes, and graph edges.
Build and Validation	How to regenerate and check the machine-readable export.
Curation Workflow	Review steps for adding, editing, or retiring ontology terms.
Curation Governance	Roles, approval criteria, and release sign-off expectations.
Archive and Provenance	How historical releases are stored and how to preserve lineage.
SUMO Integration	Scope and handling notes for the Sigma/SUMO mapping material.
SUMO Mapping Contract	Durable mapping fields and review statuses for SUMO alignment.
Downstream Integration	Guidance for tools consuming the CSV, JSON, and derived graph.
Release Workflow	Steps for publishing a new ontology CSV, JSON export, archive snapshot, and release manifest entry.
Version Diff	How to compare ontology CSV snapshots across releases.

Repository Surfaces

Path	Role
../Ontology_v5_May_25_2023.csv	Canonical repository source for the current ontology release.
../ontology.json	Generated JSON export for tools and dashboards.
../releases.json	Machine-readable release manifest for current and archived versions.
../scripts/build_json.py	Regenerates and checks ontology.json.
../scripts/diff_releases.py	Compares two ontology CSV releases.
../Archived versions/	Versioned historical snapshots retained for auditability.
../SUMO/	Sigma/SUMO setup notes and mapping-support material.
../SUMO/mapping-template.csv	CSV template for reviewed SUMO mappings.
../TODO.md	Scoped backlog grouped into minor, medium, and major improvements.

The CSV remains the source of truth. The JSON export is derived and should be rebuilt with python3 scripts/build_json.py whenever the CSV changes.