chore: migrate standards repo SCM references and examples to A2ML format

Estate-wide migration from Guile Scheme (.scm) checkpoint files to A2ML
(.a2ml) format completed 2026-04-12. This commit updates all standards
specs, examples, and satellite references to reflect the new format.

- Add comprehensive.a2ml + minimal.a2ml in: meta-a2ml/examples/,
  agentic-a2ml/examples/, neurosym-a2ml/examples/, playbook-a2ml/examples/,
  rhodium-standard-repositories/satellites/META.scm/examples/
- Add DEPRECATED notices to all corresponding .scm example files
- Update rhodium-standard-repositories/README.adoc: AI context files table
  now lists .machine_readable/6a2/*.a2ml paths (6 files, not 3)
- Update spec/TIERS.adoc: Gold tier checklist uses A2ML paths
- Update spec/VERSION.adoc: language table adds A2ML row; required files
  table uses .a2ml paths; deprecation note added
- Update spec/RSR-SPEC.adoc: satellite links updated; Gold description fixed
- Update spec/LANGUAGE-POLICY.adoc: Guile Scheme row split — A2ML for
  checkpoint files, Guile Scheme for build tooling only (guix.scm etc.)
- Update contractiles/k9/README.adoc: STATE/META/ECOSYSTEM references
  use .a2ml paths
- Update ROADMAP.adoc files (4 files): STATE.scm → STATE.a2ml
- Update 0-ai-gatekeeper-protocol/docs/AI-MANIFEST-SPEC.adoc: all
  STATE.scm / .machine_readable/ references use new 6a2/ A2ML paths
- Update state-a2ml/docs/CITATIONS.adoc: citations updated to state-a2ml
- Update state-a2ml/spec/{STATE-FORMAT-SPEC,IANA-MEDIA-TYPE,STANDARDS-TRACK,
  README}.adoc: .scm → .a2ml file extension; deprecated alias entries added

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: hyperpolymath

0-ai-gatekeeper-protocol/docs/AI-MANIFEST-SPEC.adoc

@@ -185,9 +185,10 @@ This is the AI manifest for **[REPO-NAME]**. It declares:
 
 ### Machine-Readable Metadata: `.machine_readable/` ONLY
 
-These 6 SCM files MUST exist in `.machine_readable/` directory ONLY:
-1. **STATE.scm** - Project state, progress, blockers
-2. **META.scm** - Architecture decisions, governance
+These 6 A2ML files MUST exist in `.machine_readable/6a2/` directory ONLY
+(migrated from Guile Scheme on 2026-04-12):
+1. **STATE.a2ml** - Project state, progress, blockers
+2. **META.a2ml** - Architecture decisions, governance
 ...
 
 **CRITICAL:** If ANY of these files exist in the root directory, this is an ERROR.
@@ -210,9 +211,9 @@ These 6 SCM files MUST exist in `.machine_readable/` directory ONLY:
 ----
 ## CORE INVARIANTS
 
-1. **No SCM duplication** - Root must NOT contain STATE.scm, META.scm, etc.
-2. **Single source of truth** - `.machine_readable/` is authoritative
-3. **No stale metadata** - If root SCMs exist, they are OUT OF DATE
+1. **No A2ML duplication** - Root must NOT contain STATE.a2ml, META.a2ml, etc. (or legacy STATE.scm, META.scm)
+2. **Single source of truth** - `.machine_readable/6a2/` is authoritative
+3. **No stale metadata** - If root A2ML/SCM files exist, they are OUT OF DATE
 4. **License consistency** - All code PMPL-1.0-or-later unless platform requires MPL-2.0
 ----
 
@@ -238,9 +239,10 @@ repo-name/
 ├── 0-AI-MANIFEST.a2ml         # THIS FILE (start here)
 ├── README.md                   # Project overview
 ├── src/                        # Source code
-├── .machine_readable/          # SCM files (6 files)
-│   ├── STATE.scm
-│   └── ...
+├── .machine_readable/          # A2ML files (6 files in 6a2/ subdirectory)
+│   └── 6a2/
+│       ├── STATE.a2ml
+│       └── ...
 └── .bot_directives/            # Bot instructions
 ```
 ----
@@ -254,7 +256,7 @@ repo-name/
 **Requirements:**
 * SHOULD use checkbox format
 * MUST include "Read manifest" as first step
-* SHOULD include "Read STATE.scm" step
+* SHOULD include "Read STATE.a2ml" step
 * MAY include platform-specific steps
 
 **Example:**
@@ -265,7 +267,7 @@ repo-name/
 ✅ Read THIS file (0-AI-MANIFEST.a2ml) first
 ✅ Understand canonical locations
 ✅ Know the invariants
-✅ Read `.machine_readable/STATE.scm`
+✅ Read `.machine_readable/6a2/STATE.a2ml`
 ----
 
 === Lifecycle Hooks
@@ -293,13 +295,13 @@ When starting a new session:
 2. Log session start (optional but recommended)
    - Format: `[YYYY-MM-DD HH:MM:SS] Session started: [agent-name]`
    - Location: `.machine_readable/session-log.txt`
-3. Read `.machine_readable/STATE.scm`
+3. Read `.machine_readable/6a2/STATE.a2ml`
 
 ### on-exit (Session End)
 
 When ending a session:
 
-1. Update `.machine_readable/STATE.scm` if changes made
+1. Update `.machine_readable/6a2/STATE.a2ml` if changes made
 2. Log session end
 3. Document new blockers
 ----

agentic-a2ml/docs/ROADMAP.adoc

@@ -11,7 +11,7 @@
 |Component |Description |Status
 
 |RSR Compliance
-|Core RSR files (.editorconfig, justfile, STATE.scm, etc.)
+|Core RSR files (.editorconfig, justfile, STATE.a2ml, etc.)
 |100%
 
 |Security Hardening
@@ -41,7 +41,7 @@
 === Phase 1: Foundation (v0.1 - v0.2) - COMPLETE
 
 * [x] Initial RSR-compliant structure
-* [x] Core SCM files (STATE.scm, META.scm, ECOSYSTEM.scm)
+* [x] Core A2ML files (STATE.a2ml, META.a2ml, ECOSYSTEM.a2ml) — migrated from SCM 2026-04-12
 * [x] Justfile with 50+ recipes
 * [x] GitHub workflows (CodeQL, Scorecard, quality checks)
 * [x] SHA-pinned all GitHub Actions for supply chain security
@@ -61,8 +61,8 @@
 
 * [ ] RSR compliance checker CLI tool
 * [ ] Template scaffolding command (`just scaffold <lang>`)
-* [ ] Automated STATE.scm generation
-* [ ] Badge generation from STATE.scm
+* [ ] Automated STATE.a2ml generation
+* [ ] Badge generation from STATE.a2ml
 
 === Phase 4: Ecosystem Integration (v0.5)
 

agentic-a2ml/examples/comprehensive.a2ml

@@ -0,0 +1,130 @@
+# SPDX-License-Identifier: PMPL-1.0-or-later
+# SPDX-FileCopyrightText: 2026 Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
+#
+# AGENTIC.a2ml — Comprehensive Example with All Sections
+# enterprise-platform
+#
+# Full-featured AGENTIC demonstrating all sections and capabilities.
+# This is the current (A2ML) format. Supersedes comprehensive.scm.
+
+[metadata]
+version = "1.0.0"
+last-updated = "2026-04-12"
+
+[agent-permissions]
+can-edit-source = true
+can-edit-tests = true
+can-edit-docs = true
+can-edit-config = true
+can-create-files = true
+
+[agent-constraints]
+# What AI agents must NOT do:
+# - Never use banned language patterns (believe_me, unsafeCoerce, Obj.magic, etc.)
+# - Never commit secrets or credentials
+# - Never use banned languages (TypeScript, Python, Go, V-lang, ATS2, etc.)
+# - Never place state files in repository root (must be in .machine_readable/6a2/)
+# - Never use AGPL license (use PMPL-1.0-or-later)
+# - Never push to mirrors directly (GitHub is the only push target)
+
+# ==============================================================
+# GATING POLICIES
+# ==============================================================
+
+[gating-policies.default]
+mode = "strict"
+require-explicit-intent = true
+log-all-decisions = true
+subordinate-to = "META.a2ml"
+
+[gating-policies.file-operations]
+read-source = "auto"
+write-source = "requires-intent"
+delete = "requires-explicit-confirmation"
+create-new-file = "requires-intent"
+
+[gating-policies.git-operations]
+commit = "requires-panic-attack-assail-pass"
+push = "requires-explicit-intent"
+force-push = "never"
+branch-delete = "requires-explicit-confirmation"
+
+[gating-policies.network]
+external-requests = "never-without-explicit-intent"
+credential-use = "never-store-credentials"
+
+[gating-policies.infrastructure]
+deploy = "requires-explicit-confirmation"
+modify-ci = "requires-intent"
+modify-branch-protection = "requires-explicit-confirmation"
+
+# ==============================================================
+# ENTROPY BUDGETS
+# ==============================================================
+# Higher entropy = more dangerous / irreversible operation
+
+[entropy-budgets]
+max-per-session = 100
+warn-threshold = 80
+
+[entropy-budgets.operations]
+file-read = 1
+file-write = 5
+file-delete = 20
+git-commit = 10
+git-push = 15
+external-api-call = 10
+infrastructure-change = 30
+data-migration = 40
+
+# ==============================================================
+# RISK THRESHOLDS
+# ==============================================================
+
+[risk-thresholds]
+low = "0-20"
+medium = "21-50"
+high = "51-80"
+critical = "81-100"
+
+[risk-thresholds.auto-approve]
+max-entropy = 20
+
+[risk-thresholds.require-confirmation]
+min-entropy = 21
+
+[risk-thresholds.require-explicit-human]
+min-entropy = 51
+
+# ==============================================================
+# MAINTENANCE INTEGRITY
+# ==============================================================
+
+[maintenance-integrity]
+fail-closed = true
+require-evidence-per-step = true
+allow-silent-skip = false
+require-rerun-after-fix = true
+release-claim-requires-hard-pass = true
+
+# ==============================================================
+# AUTOMATION HOOKS
+# ==============================================================
+
+[automation-hooks]
+# on-enter: Read 0-AI-MANIFEST.a2ml, then .machine_readable/6a2/STATE.a2ml
+# on-exit: Update .machine_readable/6a2/STATE.a2ml with session outcomes
+# on-commit: Run panic-attack assail . before staging
+# on-create-file: Verify SPDX header present
+# on-write: Verify file is within approved paths
+
+# ==============================================================
+# DECISION RECORDING
+# ==============================================================
+
+[decision-recording]
+record-all-decisions = true
+format = "a2ml"
+location = ".machine_readable/6a2/STATE.a2ml"
+include-rationale = true
+include-alternatives-considered = true

agentic-a2ml/examples/comprehensive.scm

@@ -1,5 +1,8 @@
 ;; SPDX-License-Identifier: MPL-2.0-or-later
 ;; SPDX-FileCopyrightText: 2025 Jonathan D.A. Jewell
+;;
+;; DEPRECATED: This file uses the legacy Guile Scheme (.scm) format.
+;; See comprehensive.a2ml for the current A2ML format.
 
 ;;; AGENTIC.scm — Comprehensive Example
 ;;; enterprise-platform

agentic-a2ml/examples/minimal.a2ml

@@ -0,0 +1,26 @@
+# SPDX-License-Identifier: PMPL-1.0-or-later
+# SPDX-FileCopyrightText: 2026 Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
+#
+# AGENTIC.a2ml — Minimal Example
+# minimal-project
+#
+# This is the current (A2ML) format. Supersedes minimal.scm.
+
+[metadata]
+version = "0.1.0"
+last-updated = "2026-04-12"
+
+[agent-permissions]
+can-edit-source = true
+can-edit-tests = true
+can-edit-docs = true
+can-edit-config = false
+can-create-files = false
+
+[gating-policies.default]
+mode = "strict"
+require-explicit-intent = true
+
+[maintenance-integrity]
+fail-closed = true
+require-evidence-per-step = true

agentic-a2ml/examples/minimal.scm

@@ -1,5 +1,8 @@
 ;; SPDX-License-Identifier: MPL-2.0-or-later
 ;; SPDX-FileCopyrightText: 2025 Example Author
+;;
+;; DEPRECATED: This file uses the legacy Guile Scheme (.scm) format.
+;; See minimal.a2ml for the current A2ML format.
 
 ;;; AGENTIC.scm — Minimal Example
 ;;; minimal-project

meta-a2ml/.claude/CLAUDE.md

@@ -1,13 +1,14 @@
 ## Machine-Readable Artefacts
 
-The following files in `.machine_readable/` contain structured project metadata:
-
-- `STATE.scm` - Current project state and progress
-- `META.scm` - Architecture decisions and development practices
-- `ECOSYSTEM.scm` - Position in the ecosystem and related projects
-- `AGENTIC.scm` - AI agent interaction patterns
-- `NEUROSYM.scm` - Neurosymbolic integration config
-- `PLAYBOOK.scm` - Operational runbook
+The following files in `.machine_readable/6a2/` contain structured project metadata
+in A2ML format (migrated from Guile Scheme on 2026-04-12):
+
+- `.machine_readable/6a2/STATE.a2ml` - Current project state and progress
+- `.machine_readable/6a2/META.a2ml` - Architecture decisions and development practices
+- `.machine_readable/6a2/ECOSYSTEM.a2ml` - Position in the ecosystem and related projects
+- `.machine_readable/6a2/AGENTIC.a2ml` - AI agent interaction patterns
+- `.machine_readable/6a2/NEUROSYM.a2ml` - Neurosymbolic integration config
+- `.machine_readable/6a2/PLAYBOOK.a2ml` - Operational runbook
 
 ---