Status: Draft Draft

Available formats: HTML, Markdown

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.md
  2. AEON-spec-v1.md
  3. AEOS-spec-v1.md
  4. Canonical companion references:
  1. contracts/ baseline contract documents
  2. 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

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

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.