0-AI-MANIFEST.a2ml

;; SPDX-License-Identifier: MPL-2.0
;; 0-AI-MANIFEST.a2ml — AI Agent Entry Point
;; Repository: hyperpolymath/ShellIntegration.jl

@abstract:
AI manifest for ShellIntegration.jl. Read this file first before any other work.
@end

;; === CANONICAL LOCATIONS ===
;; Machine-readable state: .machine_readable/
;; Documentation: docs/
;; Source code: src/
;; Tests: verification/tests/ or tests/

;; === CRITICAL INVARIANTS ===
;; - SPDX headers on ALL files (MPL-2.0)
;; - No believe_me, assert_total, sorry, Admitted, unsafeCoerce, Obj.magic
;; - SCM files ONLY in .machine_readable/ (never root)
;; - Author: Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>

<!-- BEGIN requires-initialisation -->

## PRIORITY ACTION — this repository is not fully initialised

1 substitution token(s) still have no value. **Read
`REQUIRES_INITIALISATION.md` in the repository root before doing anything
else here** — it lists every outstanding token, what it means, and which
files it belongs in.

Do not fabricate values for them, and do not delete the sections that
contain them to quiet a gate. They are unfilled because they need a
decision, not because they were overlooked. Resolve what you legitimately
can, leave the rest, and delete `REQUIRES_INITIALISATION.md` only when
nothing outstanding remains.

<!-- END requires-initialisation -->