Repository navigation
Spec Reference
Patrik edited this page Aug 18, 2026
·
4 revisions
Index of all normative AEON v1 specification documents. These live in the aeonite-org/aeonite-specs repository.
| Document | Scope |
|---|---|
| AEON-spec-v1.md | Core v1 overview: document model, value families, structural syntax surface, behaviour modes |
| structure-syntax-v1.md | Binding shape, key syntax, attributes, datatype clarifiers, list/tuple behaviour |
| value-types-v1.md | Value kinds, reserved datatypes, literal families, container forms, reference-bearing values |
| addressing-references-v1.md | Canonical paths, quoted segments, attribute selectors, reference forms, legality rules |
| comments-annotations-v1.md | Plain comments, structured channels, reserved meanings, deterministic attachment |
| aeon-core-compliance-v1.md | Normative conformance requirements for implementations, CTS suite mapping |
| conformance-matrix.md | Pointer to the CTS-owned conformance mapping |
| Document | Scope |
|---|---|
| contracts-v1.md | Contract-layer identifiers, artifact shapes, trusted registry format, resolution algorithm |
| Document | Scope |
|---|---|
| release-governance-v1.md | Release tags, branching, changelog rules, conformance-claim format |
Appendices provide detailed reference material for specific topics. They are informative unless explicitly marked normative.
| Appendix | Topic |
|---|---|
| appendix-processing-model.md | Phase pipeline from lexing through finalisation, assignment events |
| appendix-aes.md | Assignment Event Stream format and guarantees |
| appendix-bindings.md | Binding model details |
| appendix-addressing.md | Path grammar and resolution |
| appendix-canonical-form.md | Canonical rendering rules |
| appendix-error-model.md | Error classification and reporting |
| appendix-spans.md | Source span tracking |
| appendix-whitespace-boundaries.md | Whitespace normalisation rules |
| appendix-transport.md | Transport mode specifics |
| appendix-tuples.md | Tuple model and indexed paths |
| appendix-node-model.md | Node value structure |
| appendix-grammar-flow.md | Parser-context flow cards for keys, attributes, types, containers, references, and comments |
| appendix-reference-philosophy.md | Design rationale for the reference model |
| appendix-glossary.md | Term definitions |
| Appendix | Topic |
|---|---|
| appendix-profiles-framework.md | Profile system architecture, authority model, integration boundaries |
| appendix-tonic.md | Tonic processor governance, phase boundary contract, determinism requirements |
| appendix-validator-conformance.md | AEOS validator conformance requirements |
| appendix-schema-profile.md | Schema profile details |
| appendix-json-profile.md | JSON projection profile |
| appendix-pattern-profile.md | Pattern matching profile |
| appendix-altopelago-core-profile.md | Reference core profile |
| Appendix | Topic |
|---|---|
| appendix-integrity-envelope.md | Integrity hash and signature envelope format |
| appendix-annotation-stream.md | Annotation stream extraction and format |
| Document | Topic |
|---|---|
| conventions/aeon-context-v1.md | Context conventions |
| conventions/aeon-gp-limbo-v1.md | General-purpose limbo and epistemic-state labels |
| conventions/aeon-host-nulls-v1.md | Host null conventions |
- Implementation Website: aeon.altopelago.com
- Specification Website: aeonite.org
- Specifications: aeonite-org/aeonite-specs
- Conformance Tests: aeonite-org/aeonite-cts
- Implementations: AltoPelago/aeon (TypeScript, Rust, Python)
This wiki is the approachable AEON guide. Implementation information lives at aeon.altopelago.com. Specification publication lives at aeonite.org. Normative language behavior lives in aeonite-org/aeonite-specs, and conformance behavior lives in aeonite-org/aeonite-cts.