# Appendix — Annotation Stream Canonical topic owner: AEON v1 Comments and Annotations Reference. If this appendix conflicts with the canonical comments/annotations reference, the canonical comments/annotations reference wins. ## 1. Channel Forms Structured channels: - line: `//#`, `//@`, `//?`, `//{`, `//[`, `//(` - block: `/# ... #/`, `/@ ... @/`, `/? ... ?/`, `/{ ... }/`, `/[ ... ]/`, `/( ... )/` Plain comments: - line: `// ...` - block: `/* ... */` ## 2. Deterministic Binding Continuity Binding target preference remains: - `path` → `span` → `unbound` Indexed element preference behavior for container comments remains deterministic and CTS-enforced. ## 3. Non-influence Rule Comments/annotations/hints MUST NOT alter: - AES semantics - canonical path assignment - reference legality - assignment ordering ## 4. Optional Annotation Emission in Compile Surface For non-tooling pipelines, compile implementations may allow annotation emission to be disabled. Normative expectations: - When disabled, annotation stream output is omitted. - Parse/resolve/mode/reference behavior remains identical. - Event ordering and canonical paths remain unchanged. Tooling/lint/editor flows should keep annotation emission enabled. --- ## Related documents - [AEON v1 Comments and Annotations Reference](./aeon-core-v1-comments-annotations.md) - [Appendix — Assignment Event Stream (AES)](./appendix-aes-v1.md) - [Appendix — Processing Model](./appendix-processing-model-v1.md)