# 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:
   - `value-types-v1.md`
   - `structure-syntax-v1.md`
   - `addressing-references-v1.md`
   - `comments-annotations-v1.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 |

## 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.