Aeonite

Neutral specifications and test suites for meaning-aware data interchange.

Status: Draft informative profile appendix for consolidated v1

Available formats: HTML, Markdown

Appendix — Altopelago Core Profile v1

Profile Name: altopelago.core.v1 Status: informative profile appendix for consolidated v1 Determinism: Deterministic Scope: Minimal, form-only interpretation aligned with AEON v1 core

Canonical topic owners: ../AEON-spec-v1.md, ../contracts/

This appendix describes an extension profile, not the baseline AEON Core v1 conformance target. If this appendix conflicts with the canonical v1 spec set or baseline contracts, the canonical v1 documents win.

1. Purpose

The Altopelago Core Profile v1 defines a minimal, stable interpretation layer for AEON documents. It preserves AEON's form-only semantics and exposes the Assignment Event Stream (AES) as the primary output. This profile is intended as the baseline for TypeScript projects that want to parse AEON without introducing application-specific meaning.

2. Profile Declaration

Or shorthand:

3. Enabled Features

This profile enables only AEON core grammar and behavior:

  • All AEON core literals
  • Objects, lists, and tuples
  • Attributes
  • Clone and pointer references
  • Headers and envelope structures

No optional profile extensions are enabled.

4. Interpretation Rules

The profile is intentionally conservative:

  1. No value coercion. Literal forms are preserved as parsed.
  2. No reference resolution. Clone (~) and pointer (~>) references remain

symbolic in AES output. The logical reference graph must be preserved.

  1. No attribute semantics. Attributes are preserved as annotations but are

not interpreted.

  1. No datatype semantics. Type hints are preserved but not interpreted.

5. Schema Interaction

Schema validation is optional:

  • If a schema is provided, it must be applied in validate-only mode.
  • Schema engines must not coerce or transform values.
  • In strict mode, schema coercion is forbidden by the AEON spec.

6. Output Transformation

There is no output transform. The primary output is AES (Assignment Event Stream) emitted by the AEON core compiler.

This profile does not synthesize additional events. Indexed path events are emitted only from core path resolution behavior over list/tuple structure.

7. Error Model

No profile-specific error codes are introduced. Implementations should emit core AEON and AEOS diagnostics.

8. Canonicalization Rules

No additional canonicalization rules are defined beyond AEON core canonical form requirements.

9. Conformance Requirements

An implementation conforming to altopelago.core.v1 MUST:

  • Accept all valid AEON v1 core constructs.
  • Reject invalid AEON documents with diagnostics that reference canonical paths.
  • Emit exactly one Assignment Event per binding (fail-closed on errors).
  • Preserve reference structure (~ and ~>), without resolution or flattening.
  • Preserve attributes and datatype hints as annotations without interpretation.
  • If a schema is provided, apply it in validate-only mode (no coercion).
  • In strict mode, prohibit untyped values and schema coercion.

10. Reference Behavior

The profile preserves AEON reference semantics:

  • Clone references express value intent.
  • Pointer references express identity intent.
  • Pointer chains must not be flattened.

11. Compatibility Notes

This profile is designed to be the default baseline for TypeScript projects. It aligns with AEON v1 core behavior and AEOS v1 form validation.