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:
Canonical companion references:
contracts/baseline contract documentsappendices/(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 |
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 | superseded historical contract | aes.events.v1 Portable AES Event Contract |
appendix-aeos-charter.md | informative charter | AEOS-spec-v1.md and aes.events.v1 own current behavior |
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 | informative integration appendix | signature scope must select an explicit AES contract, profile, projection, and order |
appendix-json-profile.md | informative profile appendix | JSON materialization profile |
appendix-node-model.md | informative AEON projection appendix | AEON owns source-node syntax; aes.events.v1 owns portable node events and addresses |
appendix-pattern-profile.md | implementation-ahead appendix | no stable canonical replacement yet |
appendix-processing-model.md | informative AEON processing appendix | AEON owns production phases; aes.events.v1 owns emitted portable shape |
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 |
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.