# v1 Supersession Table This table defines which documents are canonical when multiple official v1 documents discuss the same topic. ## Rule When a canonical core spec or companion reference conflicts with an appendix or older focused doc, the canonical document wins. Canonical precedence order: 1. [`AEON-v1-compliance`](./aeon-core-v1-compliance.md) 2. [`AEON-spec-v1`](./aeon-core-v1.md) 3. [`AEOS-spec-v1`](./aeos-v1.md) 4. Canonical companion references: - [`value-types-v1`](./aeon-core-v1-value-types.md) - [`structure-syntax-v1`](./aeon-core-v1-structure-syntax.md) - [`addressing-references-v1`](./aeon-core-v1-addressing-references.md) - [`comments-annotations-v1`](./aeon-core-v1-comments-annotations.md) 5. `contracts/` baseline contract documents 6. `appendices/` (informative unless explicitly referenced by a canonical document) ## Superseded Top-Level Docs | Previous document | Canonical replacement | Notes | | :--- | :--- | :--- | | `annotation-binding.md` | `comments-annotations-v1.md` | Removed from canonical v1 surface | *Superseded top-level document replacements* ## Appendix Status | Appendix | Status | Canonical topic owner | | :--- | :--- | :--- | | `appendix-addressing.md` | informative summary | `addressing-references-v1.md` | | `appendix-annotation-stream.md` | informative summary | `comments-annotations-v1.md` | | `appendix-bindings.md` | informative summary | `AEON-spec-v1.md`, `structure-syntax-v1.md` | | | | `addressing-references-v1.md` | | `appendix-canonical-form.md` | informative appendix | canonical-form rules remain appendix-scoped | | `appendix-error-model.md` | informative summary | `AEON-v1-compliance.md`, `AEOS-spec-v1.md` | | `appendix-glossary.md` | informative glossary | canonical terms anchored by the canonical v1 spec set | | `appendix-spans.md` | informative summary | `AEOS-spec-v1.md`, companion refs as applicable | | `appendix-tuples.md` | informative summary | `value-types-v1.md`, `structure-syntax-v1.md` | | | | `addressing-references-v1.md` | | `appendix-aes.md` | normative appendix | AES contract remains appendix-owned unless superseded by `AEON-spec-v1.md` | | `appendix-aeos-charter.md` | decision-needed | expected to align with `AEOS-spec-v1.md` | | `appendix-altopelago-core-profile.md` | informative profile appendix | extension profile, not baseline core spec | | `appendix-insane-profiles.md` | informative appendix | non-normative | | `appendix-integrity-envelope.md` | decision-needed | no canonical replacement yet | | `appendix-json-profile.md` | informative profile appendix | JSON materialization profile | | `appendix-node-model.md` | informative appendix pending final freeze | node model remains separate | | `appendix-pattern-profile.md` | implementation-ahead appendix | no stable canonical replacement yet | | `appendix-processing-model.md` | decision-needed | phase-boundary wording still under cleanup | | `appendix-profiles-framework.md` | informative summary | profile governance also covered by `AEON-spec-v1.md` and contracts docs | | `appendix-reference-philosophy.md` | informative appendix | conceptual only | | `appendix-schema-profile.md` | implementation-ahead appendix | no stable canonical replacement yet | | `appendix-tonic.md` | informative appendix | downstream processor guidance | | `appendix-transport.md` | informative appendix | transport/framing guidance | | `appendix-validator-conformance.md` | decision-needed | validator boundary wording still under cleanup | *Appendix publication status and canonical topic ownership* ## Use Guidance - Implementers targeting AEON Core v1 should start with the canonical core spec set, not the appendices. - Appendices are supporting material, profile notes, or partially consolidated release carryovers. - If an appendix still says "normative" but is listed here as informative or decision-needed, this table controls its authority for the consolidated v1 set. --- ## Related documents - [Official v1 Index](./aeon-v1-official-index.md) - [v1 Consolidation Source Map](./aeon-v1-consolidation-source-map.md) - [AEON Core v1 Compliance Specification](./aeon-core-v1-compliance.md)