From 7614232b528e3bb2a6d9e05b1889cbf75c9e634f Mon Sep 17 00:00:00 2001 From: "Jonathan D.A. Jewell" <6759885+hyperpolymath@users.noreply.github.com> Date: Mon, 24 Aug 2026 21:07:11 +0100 Subject: [PATCH] refactor(metadata): migrate 6a2 to descriptiles --- .hypatia-baseline.json | 9 ------ .machine_readable/REGISTRY.a2ml | 28 +++++++++---------- .../contractiles/adjust/adjust.k9.ncl | 4 +-- .../contractiles/bust/bust.k9.ncl | 4 +-- .../contractiles/dust/dust.k9.ncl | 4 +-- .../contractiles/intend/intend.k9.ncl | 8 +++--- .../contractiles/must/must.k9.ncl | 4 +-- .../contractiles/trust/trust.k9.ncl | 6 ++-- .../{6a2 => descriptiles}/AGENTIC.a2ml | 2 +- .../{6a2 => descriptiles}/ECOSYSTEM.a2ml | 0 .../{6a2 => descriptiles}/META.a2ml | 0 .../{6a2 => descriptiles}/NEUROSYM.a2ml | 0 .../{6a2 => descriptiles}/PLAYBOOK.a2ml | 0 .../{6a2 => descriptiles}/STATE.a2ml | 25 +++++++++++++++-- .../k9-coordination-protocol.scorecard.a2ml | 2 +- .../template-capability-gates.toml | 2 +- .meta/REQUIRED-FILES.adoc | 2 +- 0-AI-MANIFEST.a2ml | 24 ++++++++-------- .../{6a2 => descriptiles}/AGENTIC.a2ml | 0 .../{6a2 => descriptiles}/ECOSYSTEM.a2ml | 0 .../{6a2 => descriptiles}/META.a2ml | 0 .../{6a2 => descriptiles}/NEUROSYM.a2ml | 0 .../{6a2 => descriptiles}/PLAYBOOK.a2ml | 0 .../{6a2 => descriptiles}/STATE.a2ml | 0 .../docs/AI-MANIFEST-SPEC.adoc | 14 +++++----- .../{6a2 => descriptiles}/AGENTIC.a2ml | 0 .../{6a2 => descriptiles}/ECOSYSTEM.a2ml | 0 .../{6a2 => descriptiles}/META.a2ml | 0 .../{6a2 => descriptiles}/NEUROSYM.a2ml | 0 .../{6a2 => descriptiles}/PLAYBOOK.a2ml | 0 .../{6a2 => descriptiles}/STATE.a2ml | 0 .../{6a2 => descriptiles}/AGENTIC.a2ml | 0 .../{6a2 => descriptiles}/ECOSYSTEM.a2ml | 0 .../{6a2 => descriptiles}/META.a2ml | 0 .../{6a2 => descriptiles}/NEUROSYM.a2ml | 0 .../{6a2 => descriptiles}/PLAYBOOK.a2ml | 0 .../{6a2 => descriptiles}/STATE.a2ml | 0 AGENTS.adoc | 2 +- CANONICAL-NAMES.adoc | 7 +++-- CONTRIBUTING.adoc | 4 +-- QUICKSTART-DEV.adoc | 12 ++++---- QUICKSTART-USER.adoc | 2 +- README.adoc | 8 +++--- REGISTRY.adoc | 10 +++---- REORGANIZATION-PLAN.adoc | 2 +- TEMPLATE-APPLICABILITY-POLICY.adoc | 2 +- TEST-NEEDS.adoc | 2 +- TOPOLOGY.adoc | 2 +- .../{6a2 => descriptiles}/AGENTIC.a2ml | 0 .../{6a2 => descriptiles}/ECOSYSTEM.a2ml | 0 .../{6a2 => descriptiles}/META.a2ml | 0 .../{6a2 => descriptiles}/NEUROSYM.a2ml | 0 .../{6a2 => descriptiles}/PLAYBOOK.a2ml | 0 .../{6a2 => descriptiles}/STATE.a2ml | 0 a2ml/READINESS.adoc | 2 +- a2ml/SPEC.adoc | 4 +-- .../{6a2 => descriptiles}/AGENTIC.a2ml | 0 .../{6a2 => descriptiles}/ECOSYSTEM.a2ml | 0 .../{6a2 => descriptiles}/META.a2ml | 0 .../{6a2 => descriptiles}/NEUROSYM.a2ml | 0 .../{6a2 => descriptiles}/PLAYBOOK.a2ml | 0 .../{6a2 => descriptiles}/STATE.a2ml | 0 .../{6a2 => descriptiles}/AGENTIC.a2ml | 0 .../{6a2 => descriptiles}/ECOSYSTEM.a2ml | 0 .../{6a2 => descriptiles}/META.a2ml | 0 .../{6a2 => descriptiles}/NEUROSYM.a2ml | 0 .../{6a2 => descriptiles}/PLAYBOOK.a2ml | 0 .../{6a2 => descriptiles}/STATE.a2ml | 0 .../{6a2 => descriptiles}/AGENTIC.a2ml | 0 .../{6a2 => descriptiles}/ECOSYSTEM.a2ml | 0 .../{6a2 => descriptiles}/META.a2ml | 0 .../{6a2 => descriptiles}/NEUROSYM.a2ml | 0 .../{6a2 => descriptiles}/PLAYBOOK.a2ml | 0 .../{6a2 => descriptiles}/STATE.a2ml | 0 .../{6a2 => descriptiles}/AGENTIC.a2ml | 0 .../{6a2 => descriptiles}/ECOSYSTEM.a2ml | 0 .../{6a2 => descriptiles}/META.a2ml | 0 .../{6a2 => descriptiles}/NEUROSYM.a2ml | 0 .../{6a2 => descriptiles}/PLAYBOOK.a2ml | 0 .../{6a2 => descriptiles}/STATE.a2ml | 0 a2ml/bindings/rust/tests/crg_c_tests.rs | 2 +- .../{6a2 => descriptiles}/AGENTIC.a2ml | 0 .../{6a2 => descriptiles}/ECOSYSTEM.a2ml | 0 .../{6a2 => descriptiles}/META.a2ml | 0 .../{6a2 => descriptiles}/NEUROSYM.a2ml | 0 .../{6a2 => descriptiles}/PLAYBOOK.a2ml | 0 .../{6a2 => descriptiles}/STATE.a2ml | 0 .../{6a2 => descriptiles}/AGENTIC.a2ml | 0 .../{6a2 => descriptiles}/ECOSYSTEM.a2ml | 0 .../{6a2 => descriptiles}/META.a2ml | 0 .../{6a2 => descriptiles}/NEUROSYM.a2ml | 0 .../{6a2 => descriptiles}/PLAYBOOK.a2ml | 0 .../{6a2 => descriptiles}/STATE.a2ml | 0 a2ml/profiles/README.adoc | 4 +-- a2ml/profiles/a2ml-agentic/PROFILE.a2ml | 2 +- a2ml/profiles/a2ml-anchor/PROFILE.a2ml | 2 +- a2ml/profiles/a2ml-ecosystem/PROFILE.a2ml | 2 +- a2ml/profiles/a2ml-meta/PROFILE.a2ml | 2 +- a2ml/profiles/a2ml-neurosym/PROFILE.a2ml | 2 +- a2ml/profiles/a2ml-playbook/PROFILE.a2ml | 2 +- a2ml/profiles/a2ml-state/PROFILE.a2ml | 2 +- a2ml/src/A2ML/Profiles.idr | 2 +- .../{6a2 => descriptiles}/AGENTIC.a2ml | 0 .../{6a2 => descriptiles}/ECOSYSTEM.a2ml | 0 .../{6a2 => descriptiles}/META.a2ml | 0 .../{6a2 => descriptiles}/NEUROSYM.a2ml | 0 .../{6a2 => descriptiles}/PLAYBOOK.a2ml | 0 .../{6a2 => descriptiles}/STATE.a2ml | 0 .../docs/ADR-002-methodology-layer.adoc | 4 +-- agentic-a2ml/examples/comprehensive.a2ml | 8 +++--- ai-instruction/README.adoc | 2 +- ai-instruction/opus.adoc | 2 +- .../{6a2 => descriptiles}/AGENTIC.a2ml | 0 .../{6a2 => descriptiles}/ECOSYSTEM.a2ml | 0 .../{6a2 => descriptiles}/META.a2ml | 0 .../{6a2 => descriptiles}/NEUROSYM.a2ml | 0 .../{6a2 => descriptiles}/PLAYBOOK.a2ml | 0 .../{6a2 => descriptiles}/STATE.a2ml | 0 .../{6a2 => descriptiles}/ECOSYSTEM.a2ml | 0 .../{6a2 => descriptiles}/META.a2ml | 0 .../{6a2 => descriptiles}/STATE.a2ml | 0 docs/INNERVATION.adoc | 2 +- docs/SEAMS-SPEC.adoc | 2 +- .../ADR-005-extract-consent-aware-web.adoc | 2 +- docs/reorg/STREAM-PROMPTS.adoc | 18 ++++++------ docs/wikis/README.adoc | 2 +- docs/wikis/maintainers/index.adoc | 8 +++--- docs/wikis/users/index.adoc | 2 +- .../{6a2 => descriptiles}/AGENTIC.a2ml | 0 .../{6a2 => descriptiles}/ECOSYSTEM.a2ml | 0 .../{6a2 => descriptiles}/META.a2ml | 0 .../{6a2 => descriptiles}/NEUROSYM.a2ml | 0 .../{6a2 => descriptiles}/PLAYBOOK.a2ml | 0 .../{6a2 => descriptiles}/STATE.a2ml | 0 hooks/pre-commit | 4 +-- hypatia-rules/README.adoc | 10 +++---- hypatia-rules/crg-overclaim-detector.a2ml | 14 +++++----- hypatia-rules/profile-drift-detector.a2ml | 12 ++++---- hypatia-rules/registry-staleness.a2ml | 8 +++--- .../tools/k9-init/Cargo.toml | 2 +- .../tools/k9-init/batch-init.sh | 8 +++--- .../tools/k9-init/src/main.rs | 12 ++++---- .../{6a2 => descriptiles}/AGENTIC.a2ml | 0 .../{6a2 => descriptiles}/ECOSYSTEM.a2ml | 0 .../{6a2 => descriptiles}/META.a2ml | 0 .../{6a2 => descriptiles}/NEUROSYM.a2ml | 0 .../{6a2 => descriptiles}/PLAYBOOK.a2ml | 0 .../{6a2 => descriptiles}/STATE.a2ml | 0 .../{6a2 => descriptiles}/AGENTIC.a2ml | 0 .../{6a2 => descriptiles}/ECOSYSTEM.a2ml | 0 .../{6a2 => descriptiles}/META.a2ml | 0 .../{6a2 => descriptiles}/NEUROSYM.a2ml | 0 .../{6a2 => descriptiles}/PLAYBOOK.a2ml | 0 .../{6a2 => descriptiles}/STATE.a2ml | 0 .../{6a2 => descriptiles}/AGENTIC.a2ml | 0 .../{6a2 => descriptiles}/ECOSYSTEM.a2ml | 0 .../{6a2 => descriptiles}/META.a2ml | 0 .../{6a2 => descriptiles}/NEUROSYM.a2ml | 0 .../{6a2 => descriptiles}/PLAYBOOK.a2ml | 0 .../{6a2 => descriptiles}/STATE.a2ml | 0 .../{6a2 => descriptiles}/AGENTIC.a2ml | 0 .../{6a2 => descriptiles}/ECOSYSTEM.a2ml | 0 .../{6a2 => descriptiles}/META.a2ml | 0 .../{6a2 => descriptiles}/NEUROSYM.a2ml | 0 .../{6a2 => descriptiles}/PLAYBOOK.a2ml | 0 .../{6a2 => descriptiles}/STATE.a2ml | 0 .../{6a2 => descriptiles}/AGENTIC.a2ml | 0 .../{6a2 => descriptiles}/ECOSYSTEM.a2ml | 0 .../{6a2 => descriptiles}/META.a2ml | 0 .../{6a2 => descriptiles}/NEUROSYM.a2ml | 0 .../{6a2 => descriptiles}/PLAYBOOK.a2ml | 0 .../{6a2 => descriptiles}/STATE.a2ml | 0 .../{6a2 => descriptiles}/AGENTIC.a2ml | 0 .../{6a2 => descriptiles}/ECOSYSTEM.a2ml | 0 .../{6a2 => descriptiles}/META.a2ml | 0 .../{6a2 => descriptiles}/NEUROSYM.a2ml | 0 .../{6a2 => descriptiles}/PLAYBOOK.a2ml | 0 .../{6a2 => descriptiles}/STATE.a2ml | 0 .../{6a2 => descriptiles}/AGENTIC.a2ml | 0 .../{6a2 => descriptiles}/ECOSYSTEM.a2ml | 0 .../{6a2 => descriptiles}/META.a2ml | 0 .../{6a2 => descriptiles}/NEUROSYM.a2ml | 0 .../{6a2 => descriptiles}/PLAYBOOK.a2ml | 0 .../{6a2 => descriptiles}/STATE.a2ml | 0 llm-warmup-dev.adoc | 6 ++-- .../{6a2 => descriptiles}/AGENTIC.a2ml | 0 .../{6a2 => descriptiles}/ECOSYSTEM.a2ml | 0 .../{6a2 => descriptiles}/META.a2ml | 0 .../{6a2 => descriptiles}/NEUROSYM.a2ml | 0 .../{6a2 => descriptiles}/PLAYBOOK.a2ml | 0 .../{6a2 => descriptiles}/STATE.a2ml | 0 meta-a2ml/.claude/CLAUDE.md | 14 +++++----- .../{6a2 => descriptiles}/AGENTIC.a2ml | 0 .../{6a2 => descriptiles}/ECOSYSTEM.a2ml | 0 .../{6a2 => descriptiles}/META.a2ml | 0 .../{6a2 => descriptiles}/NEUROSYM.a2ml | 0 .../{6a2 => descriptiles}/PLAYBOOK.a2ml | 0 .../{6a2 => descriptiles}/STATE.a2ml | 0 .../{6a2 => descriptiles}/AGENTIC.a2ml | 0 .../{6a2 => descriptiles}/ECOSYSTEM.a2ml | 0 .../{6a2 => descriptiles}/META.a2ml | 0 .../{6a2 => descriptiles}/NEUROSYM.a2ml | 0 .../{6a2 => descriptiles}/PLAYBOOK.a2ml | 0 .../{6a2 => descriptiles}/STATE.a2ml | 0 .../{6a2 => descriptiles}/AGENTIC.a2ml | 0 .../{6a2 => descriptiles}/ECOSYSTEM.a2ml | 0 .../{6a2 => descriptiles}/META.a2ml | 0 .../{6a2 => descriptiles}/NEUROSYM.a2ml | 0 .../{6a2 => descriptiles}/PLAYBOOK.a2ml | 0 .../{6a2 => descriptiles}/STATE.a2ml | 0 .../{6a2 => descriptiles}/ECOSYSTEM.a2ml | 0 .../{6a2 => descriptiles}/META.a2ml | 0 .../{6a2 => descriptiles}/STATE.a2ml | 0 .../{6a2 => descriptiles}/AGENTIC.a2ml | 0 .../{6a2 => descriptiles}/ECOSYSTEM.a2ml | 0 .../{6a2 => descriptiles}/META.a2ml | 0 .../{6a2 => descriptiles}/NEUROSYM.a2ml | 0 .../{6a2 => descriptiles}/PLAYBOOK.a2ml | 0 .../{6a2 => descriptiles}/STATE.a2ml | 0 playbook-a2ml/examples/comprehensive.a2ml | 4 +-- release-pre-flight/v1-audit.sh | 2 +- .../{6a2 => descriptiles}/AGENTIC.a2ml | 0 .../{6a2 => descriptiles}/ECOSYSTEM.a2ml | 0 .../{6a2 => descriptiles}/META.a2ml | 0 .../{6a2 => descriptiles}/NEUROSYM.a2ml | 0 .../{6a2 => descriptiles}/PLAYBOOK.a2ml | 0 .../{6a2 => descriptiles}/STATE.a2ml | 0 rhodium-standard-repositories/README.adoc | 16 +++++------ .../spec/LANGUAGE-POLICY.adoc | 2 +- rhodium-standard-repositories/spec/TIERS.adoc | 12 ++++---- .../spec/VERSION.adoc | 14 +++++----- scripts/build-registry.sh | 2 +- scripts/check-canonical-names.sh | 19 +++++++------ scripts/tests/wave6-canonical-names-test.sh | 9 ++++++ .../{6a2 => descriptiles}/AGENTIC.a2ml | 0 .../{6a2 => descriptiles}/ECOSYSTEM.a2ml | 0 .../{6a2 => descriptiles}/META.a2ml | 0 .../{6a2 => descriptiles}/NEUROSYM.a2ml | 0 .../{6a2 => descriptiles}/PLAYBOOK.a2ml | 0 .../{6a2 => descriptiles}/STATE.a2ml | 0 .../{6a2 => descriptiles}/AGENTIC.a2ml | 0 .../{6a2 => descriptiles}/ECOSYSTEM.a2ml | 0 .../{6a2 => descriptiles}/META.a2ml | 0 .../{6a2 => descriptiles}/NEUROSYM.a2ml | 0 .../{6a2 => descriptiles}/PLAYBOOK.a2ml | 0 .../{6a2 => descriptiles}/STATE.a2ml | 0 state-a2ml/spec/IANA-MEDIA-TYPE.adoc | 2 +- state-a2ml/spec/STATE-FORMAT-SPEC.adoc | 4 +-- 248 files changed, 234 insertions(+), 213 deletions(-) rename .machine_readable/{6a2 => descriptiles}/AGENTIC.a2ml (97%) rename .machine_readable/{6a2 => descriptiles}/ECOSYSTEM.a2ml (100%) rename .machine_readable/{6a2 => descriptiles}/META.a2ml (100%) rename .machine_readable/{6a2 => descriptiles}/NEUROSYM.a2ml (100%) rename .machine_readable/{6a2 => descriptiles}/PLAYBOOK.a2ml (100%) rename .machine_readable/{6a2 => descriptiles}/STATE.a2ml (78%) rename 0-ai-gatekeeper-protocol/.machine_readable/{6a2 => descriptiles}/AGENTIC.a2ml (100%) rename 0-ai-gatekeeper-protocol/.machine_readable/{6a2 => descriptiles}/ECOSYSTEM.a2ml (100%) rename 0-ai-gatekeeper-protocol/.machine_readable/{6a2 => descriptiles}/META.a2ml (100%) rename 0-ai-gatekeeper-protocol/.machine_readable/{6a2 => descriptiles}/NEUROSYM.a2ml (100%) rename 0-ai-gatekeeper-protocol/.machine_readable/{6a2 => descriptiles}/PLAYBOOK.a2ml (100%) rename 0-ai-gatekeeper-protocol/.machine_readable/{6a2 => descriptiles}/STATE.a2ml (100%) rename 0-ai-gatekeeper-protocol/mcp-repo-guardian/.machine_readable/{6a2 => descriptiles}/AGENTIC.a2ml (100%) rename 0-ai-gatekeeper-protocol/mcp-repo-guardian/.machine_readable/{6a2 => descriptiles}/ECOSYSTEM.a2ml (100%) rename 0-ai-gatekeeper-protocol/mcp-repo-guardian/.machine_readable/{6a2 => descriptiles}/META.a2ml (100%) rename 0-ai-gatekeeper-protocol/mcp-repo-guardian/.machine_readable/{6a2 => descriptiles}/NEUROSYM.a2ml (100%) rename 0-ai-gatekeeper-protocol/mcp-repo-guardian/.machine_readable/{6a2 => descriptiles}/PLAYBOOK.a2ml (100%) rename 0-ai-gatekeeper-protocol/mcp-repo-guardian/.machine_readable/{6a2 => descriptiles}/STATE.a2ml (100%) rename 0-ai-gatekeeper-protocol/repo-guardian-fs/.machine_readable/{6a2 => descriptiles}/AGENTIC.a2ml (100%) rename 0-ai-gatekeeper-protocol/repo-guardian-fs/.machine_readable/{6a2 => descriptiles}/ECOSYSTEM.a2ml (100%) rename 0-ai-gatekeeper-protocol/repo-guardian-fs/.machine_readable/{6a2 => descriptiles}/META.a2ml (100%) rename 0-ai-gatekeeper-protocol/repo-guardian-fs/.machine_readable/{6a2 => descriptiles}/NEUROSYM.a2ml (100%) rename 0-ai-gatekeeper-protocol/repo-guardian-fs/.machine_readable/{6a2 => descriptiles}/PLAYBOOK.a2ml (100%) rename 0-ai-gatekeeper-protocol/repo-guardian-fs/.machine_readable/{6a2 => descriptiles}/STATE.a2ml (100%) rename a2ml/.machine_readable/{6a2 => descriptiles}/AGENTIC.a2ml (100%) rename a2ml/.machine_readable/{6a2 => descriptiles}/ECOSYSTEM.a2ml (100%) rename a2ml/.machine_readable/{6a2 => descriptiles}/META.a2ml (100%) rename a2ml/.machine_readable/{6a2 => descriptiles}/NEUROSYM.a2ml (100%) rename a2ml/.machine_readable/{6a2 => descriptiles}/PLAYBOOK.a2ml (100%) rename a2ml/.machine_readable/{6a2 => descriptiles}/STATE.a2ml (100%) rename a2ml/actions/validate/.machine_readable/{6a2 => descriptiles}/AGENTIC.a2ml (100%) rename a2ml/actions/validate/.machine_readable/{6a2 => descriptiles}/ECOSYSTEM.a2ml (100%) rename a2ml/actions/validate/.machine_readable/{6a2 => descriptiles}/META.a2ml (100%) rename a2ml/actions/validate/.machine_readable/{6a2 => descriptiles}/NEUROSYM.a2ml (100%) rename a2ml/actions/validate/.machine_readable/{6a2 => descriptiles}/PLAYBOOK.a2ml (100%) rename a2ml/actions/validate/.machine_readable/{6a2 => descriptiles}/STATE.a2ml (100%) rename a2ml/bindings/deno/.machine_readable/{6a2 => descriptiles}/AGENTIC.a2ml (100%) rename a2ml/bindings/deno/.machine_readable/{6a2 => descriptiles}/ECOSYSTEM.a2ml (100%) rename a2ml/bindings/deno/.machine_readable/{6a2 => descriptiles}/META.a2ml (100%) rename a2ml/bindings/deno/.machine_readable/{6a2 => descriptiles}/NEUROSYM.a2ml (100%) rename a2ml/bindings/deno/.machine_readable/{6a2 => descriptiles}/PLAYBOOK.a2ml (100%) rename a2ml/bindings/deno/.machine_readable/{6a2 => descriptiles}/STATE.a2ml (100%) rename a2ml/bindings/haskell/.machine_readable/{6a2 => descriptiles}/AGENTIC.a2ml (100%) rename a2ml/bindings/haskell/.machine_readable/{6a2 => descriptiles}/ECOSYSTEM.a2ml (100%) rename a2ml/bindings/haskell/.machine_readable/{6a2 => descriptiles}/META.a2ml (100%) rename a2ml/bindings/haskell/.machine_readable/{6a2 => descriptiles}/NEUROSYM.a2ml (100%) rename a2ml/bindings/haskell/.machine_readable/{6a2 => descriptiles}/PLAYBOOK.a2ml (100%) rename a2ml/bindings/haskell/.machine_readable/{6a2 => descriptiles}/STATE.a2ml (100%) rename a2ml/bindings/rust/.machine_readable/{6a2 => descriptiles}/AGENTIC.a2ml (100%) rename a2ml/bindings/rust/.machine_readable/{6a2 => descriptiles}/ECOSYSTEM.a2ml (100%) rename a2ml/bindings/rust/.machine_readable/{6a2 => descriptiles}/META.a2ml (100%) rename a2ml/bindings/rust/.machine_readable/{6a2 => descriptiles}/NEUROSYM.a2ml (100%) rename a2ml/bindings/rust/.machine_readable/{6a2 => descriptiles}/PLAYBOOK.a2ml (100%) rename a2ml/bindings/rust/.machine_readable/{6a2 => descriptiles}/STATE.a2ml (100%) rename a2ml/editors/vscode/.machine_readable/{6a2 => descriptiles}/AGENTIC.a2ml (100%) rename a2ml/editors/vscode/.machine_readable/{6a2 => descriptiles}/ECOSYSTEM.a2ml (100%) rename a2ml/editors/vscode/.machine_readable/{6a2 => descriptiles}/META.a2ml (100%) rename a2ml/editors/vscode/.machine_readable/{6a2 => descriptiles}/NEUROSYM.a2ml (100%) rename a2ml/editors/vscode/.machine_readable/{6a2 => descriptiles}/PLAYBOOK.a2ml (100%) rename a2ml/editors/vscode/.machine_readable/{6a2 => descriptiles}/STATE.a2ml (100%) rename a2ml/pandoc/.machine_readable/{6a2 => descriptiles}/AGENTIC.a2ml (100%) rename a2ml/pandoc/.machine_readable/{6a2 => descriptiles}/ECOSYSTEM.a2ml (100%) rename a2ml/pandoc/.machine_readable/{6a2 => descriptiles}/META.a2ml (100%) rename a2ml/pandoc/.machine_readable/{6a2 => descriptiles}/NEUROSYM.a2ml (100%) rename a2ml/pandoc/.machine_readable/{6a2 => descriptiles}/PLAYBOOK.a2ml (100%) rename a2ml/pandoc/.machine_readable/{6a2 => descriptiles}/STATE.a2ml (100%) rename agentic-a2ml/.machine_readable/{6a2 => descriptiles}/AGENTIC.a2ml (100%) rename agentic-a2ml/.machine_readable/{6a2 => descriptiles}/ECOSYSTEM.a2ml (100%) rename agentic-a2ml/.machine_readable/{6a2 => descriptiles}/META.a2ml (100%) rename agentic-a2ml/.machine_readable/{6a2 => descriptiles}/NEUROSYM.a2ml (100%) rename agentic-a2ml/.machine_readable/{6a2 => descriptiles}/PLAYBOOK.a2ml (100%) rename agentic-a2ml/.machine_readable/{6a2 => descriptiles}/STATE.a2ml (100%) rename anchor-a2ml/.machine_readable/{6a2 => descriptiles}/AGENTIC.a2ml (100%) rename anchor-a2ml/.machine_readable/{6a2 => descriptiles}/ECOSYSTEM.a2ml (100%) rename anchor-a2ml/.machine_readable/{6a2 => descriptiles}/META.a2ml (100%) rename anchor-a2ml/.machine_readable/{6a2 => descriptiles}/NEUROSYM.a2ml (100%) rename anchor-a2ml/.machine_readable/{6a2 => descriptiles}/PLAYBOOK.a2ml (100%) rename anchor-a2ml/.machine_readable/{6a2 => descriptiles}/STATE.a2ml (100%) rename axel-protocol/.machine_readable/{6a2 => descriptiles}/ECOSYSTEM.a2ml (100%) rename axel-protocol/.machine_readable/{6a2 => descriptiles}/META.a2ml (100%) rename axel-protocol/.machine_readable/{6a2 => descriptiles}/STATE.a2ml (100%) rename ecosystem-a2ml/.machine_readable/{6a2 => descriptiles}/AGENTIC.a2ml (100%) rename ecosystem-a2ml/.machine_readable/{6a2 => descriptiles}/ECOSYSTEM.a2ml (100%) rename ecosystem-a2ml/.machine_readable/{6a2 => descriptiles}/META.a2ml (100%) rename ecosystem-a2ml/.machine_readable/{6a2 => descriptiles}/NEUROSYM.a2ml (100%) rename ecosystem-a2ml/.machine_readable/{6a2 => descriptiles}/PLAYBOOK.a2ml (100%) rename ecosystem-a2ml/.machine_readable/{6a2 => descriptiles}/STATE.a2ml (100%) rename k9-svc/.machine_readable/{6a2 => descriptiles}/AGENTIC.a2ml (100%) rename k9-svc/.machine_readable/{6a2 => descriptiles}/ECOSYSTEM.a2ml (100%) rename k9-svc/.machine_readable/{6a2 => descriptiles}/META.a2ml (100%) rename k9-svc/.machine_readable/{6a2 => descriptiles}/NEUROSYM.a2ml (100%) rename k9-svc/.machine_readable/{6a2 => descriptiles}/PLAYBOOK.a2ml (100%) rename k9-svc/.machine_readable/{6a2 => descriptiles}/STATE.a2ml (100%) rename k9-svc/actions/validate/.machine_readable/{6a2 => descriptiles}/AGENTIC.a2ml (100%) rename k9-svc/actions/validate/.machine_readable/{6a2 => descriptiles}/ECOSYSTEM.a2ml (100%) rename k9-svc/actions/validate/.machine_readable/{6a2 => descriptiles}/META.a2ml (100%) rename k9-svc/actions/validate/.machine_readable/{6a2 => descriptiles}/NEUROSYM.a2ml (100%) rename k9-svc/actions/validate/.machine_readable/{6a2 => descriptiles}/PLAYBOOK.a2ml (100%) rename k9-svc/actions/validate/.machine_readable/{6a2 => descriptiles}/STATE.a2ml (100%) rename k9-svc/bindings/deno/.machine_readable/{6a2 => descriptiles}/AGENTIC.a2ml (100%) rename k9-svc/bindings/deno/.machine_readable/{6a2 => descriptiles}/ECOSYSTEM.a2ml (100%) rename k9-svc/bindings/deno/.machine_readable/{6a2 => descriptiles}/META.a2ml (100%) rename k9-svc/bindings/deno/.machine_readable/{6a2 => descriptiles}/NEUROSYM.a2ml (100%) rename k9-svc/bindings/deno/.machine_readable/{6a2 => descriptiles}/PLAYBOOK.a2ml (100%) rename k9-svc/bindings/deno/.machine_readable/{6a2 => descriptiles}/STATE.a2ml (100%) rename k9-svc/bindings/haskell/.machine_readable/{6a2 => descriptiles}/AGENTIC.a2ml (100%) rename k9-svc/bindings/haskell/.machine_readable/{6a2 => descriptiles}/ECOSYSTEM.a2ml (100%) rename k9-svc/bindings/haskell/.machine_readable/{6a2 => descriptiles}/META.a2ml (100%) rename k9-svc/bindings/haskell/.machine_readable/{6a2 => descriptiles}/NEUROSYM.a2ml (100%) rename k9-svc/bindings/haskell/.machine_readable/{6a2 => descriptiles}/PLAYBOOK.a2ml (100%) rename k9-svc/bindings/haskell/.machine_readable/{6a2 => descriptiles}/STATE.a2ml (100%) rename k9-svc/bindings/rust/.machine_readable/{6a2 => descriptiles}/AGENTIC.a2ml (100%) rename k9-svc/bindings/rust/.machine_readable/{6a2 => descriptiles}/ECOSYSTEM.a2ml (100%) rename k9-svc/bindings/rust/.machine_readable/{6a2 => descriptiles}/META.a2ml (100%) rename k9-svc/bindings/rust/.machine_readable/{6a2 => descriptiles}/NEUROSYM.a2ml (100%) rename k9-svc/bindings/rust/.machine_readable/{6a2 => descriptiles}/PLAYBOOK.a2ml (100%) rename k9-svc/bindings/rust/.machine_readable/{6a2 => descriptiles}/STATE.a2ml (100%) rename k9-svc/editors/vscode/.machine_readable/{6a2 => descriptiles}/AGENTIC.a2ml (100%) rename k9-svc/editors/vscode/.machine_readable/{6a2 => descriptiles}/ECOSYSTEM.a2ml (100%) rename k9-svc/editors/vscode/.machine_readable/{6a2 => descriptiles}/META.a2ml (100%) rename k9-svc/editors/vscode/.machine_readable/{6a2 => descriptiles}/NEUROSYM.a2ml (100%) rename k9-svc/editors/vscode/.machine_readable/{6a2 => descriptiles}/PLAYBOOK.a2ml (100%) rename k9-svc/editors/vscode/.machine_readable/{6a2 => descriptiles}/STATE.a2ml (100%) rename k9-svc/pandoc/.machine_readable/{6a2 => descriptiles}/AGENTIC.a2ml (100%) rename k9-svc/pandoc/.machine_readable/{6a2 => descriptiles}/ECOSYSTEM.a2ml (100%) rename k9-svc/pandoc/.machine_readable/{6a2 => descriptiles}/META.a2ml (100%) rename k9-svc/pandoc/.machine_readable/{6a2 => descriptiles}/NEUROSYM.a2ml (100%) rename k9-svc/pandoc/.machine_readable/{6a2 => descriptiles}/PLAYBOOK.a2ml (100%) rename k9-svc/pandoc/.machine_readable/{6a2 => descriptiles}/STATE.a2ml (100%) rename lol/.machine_readable/{6a2 => descriptiles}/AGENTIC.a2ml (100%) rename lol/.machine_readable/{6a2 => descriptiles}/ECOSYSTEM.a2ml (100%) rename lol/.machine_readable/{6a2 => descriptiles}/META.a2ml (100%) rename lol/.machine_readable/{6a2 => descriptiles}/NEUROSYM.a2ml (100%) rename lol/.machine_readable/{6a2 => descriptiles}/PLAYBOOK.a2ml (100%) rename lol/.machine_readable/{6a2 => descriptiles}/STATE.a2ml (100%) rename meta-a2ml/.machine_readable/{6a2 => descriptiles}/AGENTIC.a2ml (100%) rename meta-a2ml/.machine_readable/{6a2 => descriptiles}/ECOSYSTEM.a2ml (100%) rename meta-a2ml/.machine_readable/{6a2 => descriptiles}/META.a2ml (100%) rename meta-a2ml/.machine_readable/{6a2 => descriptiles}/NEUROSYM.a2ml (100%) rename meta-a2ml/.machine_readable/{6a2 => descriptiles}/PLAYBOOK.a2ml (100%) rename meta-a2ml/.machine_readable/{6a2 => descriptiles}/STATE.a2ml (100%) rename neurosym-a2ml/.machine_readable/{6a2 => descriptiles}/AGENTIC.a2ml (100%) rename neurosym-a2ml/.machine_readable/{6a2 => descriptiles}/ECOSYSTEM.a2ml (100%) rename neurosym-a2ml/.machine_readable/{6a2 => descriptiles}/META.a2ml (100%) rename neurosym-a2ml/.machine_readable/{6a2 => descriptiles}/NEUROSYM.a2ml (100%) rename neurosym-a2ml/.machine_readable/{6a2 => descriptiles}/PLAYBOOK.a2ml (100%) rename neurosym-a2ml/.machine_readable/{6a2 => descriptiles}/STATE.a2ml (100%) rename outreach/.machine_readable/{6a2 => descriptiles}/AGENTIC.a2ml (100%) rename outreach/.machine_readable/{6a2 => descriptiles}/ECOSYSTEM.a2ml (100%) rename outreach/.machine_readable/{6a2 => descriptiles}/META.a2ml (100%) rename outreach/.machine_readable/{6a2 => descriptiles}/NEUROSYM.a2ml (100%) rename outreach/.machine_readable/{6a2 => descriptiles}/PLAYBOOK.a2ml (100%) rename outreach/.machine_readable/{6a2 => descriptiles}/STATE.a2ml (100%) rename overlay-protocol/.machine_readable/{6a2 => descriptiles}/ECOSYSTEM.a2ml (100%) rename overlay-protocol/.machine_readable/{6a2 => descriptiles}/META.a2ml (100%) rename overlay-protocol/.machine_readable/{6a2 => descriptiles}/STATE.a2ml (100%) rename playbook-a2ml/.machine_readable/{6a2 => descriptiles}/AGENTIC.a2ml (100%) rename playbook-a2ml/.machine_readable/{6a2 => descriptiles}/ECOSYSTEM.a2ml (100%) rename playbook-a2ml/.machine_readable/{6a2 => descriptiles}/META.a2ml (100%) rename playbook-a2ml/.machine_readable/{6a2 => descriptiles}/NEUROSYM.a2ml (100%) rename playbook-a2ml/.machine_readable/{6a2 => descriptiles}/PLAYBOOK.a2ml (100%) rename playbook-a2ml/.machine_readable/{6a2 => descriptiles}/STATE.a2ml (100%) rename rhodium-standard-repositories/.machine_readable/{6a2 => descriptiles}/AGENTIC.a2ml (100%) rename rhodium-standard-repositories/.machine_readable/{6a2 => descriptiles}/ECOSYSTEM.a2ml (100%) rename rhodium-standard-repositories/.machine_readable/{6a2 => descriptiles}/META.a2ml (100%) rename rhodium-standard-repositories/.machine_readable/{6a2 => descriptiles}/NEUROSYM.a2ml (100%) rename rhodium-standard-repositories/.machine_readable/{6a2 => descriptiles}/PLAYBOOK.a2ml (100%) rename rhodium-standard-repositories/.machine_readable/{6a2 => descriptiles}/STATE.a2ml (100%) rename standards-update/.machine_readable/{6a2 => descriptiles}/AGENTIC.a2ml (100%) rename standards-update/.machine_readable/{6a2 => descriptiles}/ECOSYSTEM.a2ml (100%) rename standards-update/.machine_readable/{6a2 => descriptiles}/META.a2ml (100%) rename standards-update/.machine_readable/{6a2 => descriptiles}/NEUROSYM.a2ml (100%) rename standards-update/.machine_readable/{6a2 => descriptiles}/PLAYBOOK.a2ml (100%) rename standards-update/.machine_readable/{6a2 => descriptiles}/STATE.a2ml (100%) rename state-a2ml/.machine_readable/{6a2 => descriptiles}/AGENTIC.a2ml (100%) rename state-a2ml/.machine_readable/{6a2 => descriptiles}/ECOSYSTEM.a2ml (100%) rename state-a2ml/.machine_readable/{6a2 => descriptiles}/META.a2ml (100%) rename state-a2ml/.machine_readable/{6a2 => descriptiles}/NEUROSYM.a2ml (100%) rename state-a2ml/.machine_readable/{6a2 => descriptiles}/PLAYBOOK.a2ml (100%) rename state-a2ml/.machine_readable/{6a2 => descriptiles}/STATE.a2ml (100%) diff --git a/.hypatia-baseline.json b/.hypatia-baseline.json index 50d9444a..2b0561ba 100644 --- a/.hypatia-baseline.json +++ b/.hypatia-baseline.json @@ -890,15 +890,6 @@ "file_pattern": "**/zig-gateway/**", "note": "FFI boundary. A Zig shim crossing into a foreign runtime must reinterpret opaque pointers; the cast is unavoidable in the host language and the guarantee holds on the core's side of the boundary. Architectural, not deferred \u2014 it does not shrink over time." }, - { - "severity": "critical", - "rule_module": "structural_drift", - "type": "SD004", - "file_pattern": ".machine_readable/6a2/*.a2ml", - "note": "TEMPORARY AUTHORITY CONFLICT (2026-08-24): Hypatia says the 6a2 directory is retired, but standards' registry generator, topology generator, readiness rules, template capability gates, and canonical documentation still consume this path. Do not move normative files to satisfy one downstream rule before the authority sources agree.", - "expires_at": "2026-09-30", - "tracking_issue": "hyperpolymath/standards#399" - }, { "severity": "medium", "rule_module": "structural_drift", diff --git a/.machine_readable/REGISTRY.a2ml b/.machine_readable/REGISTRY.a2ml index 96aaba9d..f3fa0c17 100644 --- a/.machine_readable/REGISTRY.a2ml +++ b/.machine_readable/REGISTRY.a2ml @@ -45,7 +45,7 @@ name = "A2ML — Attested Markup Language" stream = "foundation" home = "a2ml/" canonical_doc = "a2ml/README.adoc" -source_hash = "sha256:01e65e3c955746526e47b8a313070c13647228a1f6c453ad1b43d147789e664a" +source_hash = "sha256:b5e1457a23b681f7c3eb49e0541f62912d13e2400a0a62e5e06b16235ac0dfa0" route = "the typed/verified machine-readable document format" [[spec]] @@ -54,7 +54,7 @@ name = "K9 Self-Validating Components" stream = "foundation" home = "k9-svc/" canonical_doc = "k9-svc/README.adoc" -source_hash = "sha256:1c750e457184efd404a92a3faec4989cc4e59fb54302d50040ff88711750a6e6" +source_hash = "sha256:6bcd9a401b27600886129a8b644746fff23e4633b51936b965f51238afb9fa04" route = "self-validating components with embedded contracts + deploy logic" [[spec]] @@ -72,7 +72,7 @@ name = "META.a2ml spec" stream = "foundation" home = "meta-a2ml/" canonical_doc = "meta-a2ml/README.adoc" -source_hash = "sha256:3398ac0350915f7267fae8ebb6314fcca9d4e8146a25c5396781813bc71851b2" +source_hash = "sha256:d82f71b656ff6e034ba0d6e344bb61dea0bf4a0d3750264ea66e93a87347c6de" route = "architecture decisions / governance metadata format" [[spec]] @@ -81,7 +81,7 @@ name = "STATE.a2ml spec" stream = "foundation" home = "state-a2ml/" canonical_doc = "state-a2ml/README.adoc" -source_hash = "sha256:a9396d04d530329257d4739b488427383ca4d50ef581c617159cd679e012dd47" +source_hash = "sha256:212feae0be60d3cfd625cfb0c46cc6c501f651d5a4103ea120512162d58ce5d0" route = "project-state metadata format (drives this registry's topology)" [[spec]] @@ -90,7 +90,7 @@ name = "ECOSYSTEM.a2ml spec" stream = "foundation" home = "ecosystem-a2ml/" canonical_doc = "ecosystem-a2ml/README.adoc" -source_hash = "sha256:258b20df64d5eefb6164ce673f55df24b2336044691a4ffddf4aca62bc925b22" +source_hash = "sha256:a0d9c7728e32a36d4eaa0ddf22bb2fc7b60a85e9b50d267673e1abb2e2ef94c9" route = "ecosystem-positioning metadata format" [[spec]] @@ -99,7 +99,7 @@ name = "AGENTIC.a2ml spec" stream = "foundation" home = "agentic-a2ml/" canonical_doc = "agentic-a2ml/README.adoc" -source_hash = "sha256:cbfbb9d836e5bd78bb6ec159d5686fbf8488645e2bf0f543690ce2b8cb2e179e" +source_hash = "sha256:8e39bc9402b39341e3b21ca45083f697a00a6618a72c7d85ab0ea852dc26883b" route = "AI-agent operational gating / entropy budgets" [[spec]] @@ -108,7 +108,7 @@ name = "NEUROSYM.a2ml spec" stream = "foundation" home = "neurosym-a2ml/" canonical_doc = "neurosym-a2ml/README.adoc" -source_hash = "sha256:6597b2a597c3aeb78b16eca98d744ae3b449b1d45a285acd8aa6d0b3b63d7ac6" +source_hash = "sha256:be62099578501b961a948d2218e4ab07ee2b575d8affd03724df493fb63d2e8e" route = "symbolic semantics / proof obligations" [[spec]] @@ -117,7 +117,7 @@ name = "PLAYBOOK.a2ml spec" stream = "foundation" home = "playbook-a2ml/" canonical_doc = "playbook-a2ml/README.adoc" -source_hash = "sha256:351da5ba66b38d8463a10e94c7b971b7d11aaff451b79ceb8c81f719363762d9" +source_hash = "sha256:5881b4de48735bd0d934342a037a8d83c3eced43c983b11f97f15fc3ef8342b0" route = "executable operational runbooks" [[spec]] @@ -126,7 +126,7 @@ name = "ANCHOR.a2ml spec" stream = "foundation" home = "anchor-a2ml/" canonical_doc = "anchor-a2ml/README.adoc" -source_hash = "sha256:3e447e1fac78311a9c466abaa9c5995a40783b8a23a12d74ce32c7906b0ee2e9" +source_hash = "sha256:3948f88c03367bd21992dd068b6ea4d0a9c86a98ea6a51567eaff4990df9a70a" route = "project-recalibration intervention format" [[spec]] @@ -135,7 +135,7 @@ name = "0-AI Gatekeeper Protocol" stream = "protocol" home = "0-ai-gatekeeper-protocol/" canonical_doc = "0-ai-gatekeeper-protocol/README.adoc" -source_hash = "sha256:9e77212dd6a6cc027345bfd9f71cf5bdda5c12d2424515c0d0b838700442cd25" +source_hash = "sha256:e126780b42539020b1214547bb1dd496f1dab6e93cec5b4e531303be77eb071a" route = "the AI-agent entry/gating protocol behind 0-AI-MANIFEST" [[spec]] @@ -162,7 +162,7 @@ name = "AXEL Protocol" stream = "protocol" home = "axel-protocol/" canonical_doc = "axel-protocol/README.adoc" -source_hash = "sha256:678e7e99899809bfd3211a392ea718446bd80d1bed2650ee7bb090537c88dd21" +source_hash = "sha256:2076ab707c155dddc70601c72380327f49d905ea37d1c67b6eb345bfef628ce6" route = "age-gating + explicit-content enforcement" [[spec]] @@ -170,8 +170,8 @@ id = "overlay-protocol" name = "Overlay Protocol" stream = "protocol" home = "overlay-protocol/" -canonical_doc = "overlay-protocol/.machine_readable/6a2/ECOSYSTEM.a2ml" -source_hash = "sha256:b52752056328cc77708e1cbe9446324bc60d8e34d08471318a786d1e732521d3" +canonical_doc = "overlay-protocol/.machine_readable/descriptiles/ECOSYSTEM.a2ml" +source_hash = "sha256:a4864b45d3cc12ca541b09ed7042285d6ff0d4231f89e3438fd1e0045e72becf" route = "layered overlay composition spec" [[spec]] @@ -216,7 +216,7 @@ name = "RSR — Rhodium Standard Repositories" stream = "governance" home = "rhodium-standard-repositories/" canonical_doc = "rhodium-standard-repositories/README.adoc" -source_hash = "sha256:4e8ff4f5ff07dece3ecd714221e84f2354137e0ded7c291d71c5edac529e696e" +source_hash = "sha256:d1f99236a07a31aaa4395248093558fc20debac359d7f7f1d76c9660cb162aaf" route = "the repository-compliance standard every repo is graded against" [[spec]] diff --git a/.machine_readable/contractiles/adjust/adjust.k9.ncl b/.machine_readable/contractiles/adjust/adjust.k9.ncl index 9ff26c94..0f1561ea 100644 --- a/.machine_readable/contractiles/adjust/adjust.k9.ncl +++ b/.machine_readable/contractiles/adjust/adjust.k9.ncl @@ -85,7 +85,7 @@ let base = import "../_base.ncl" in { kind = 'verisimdb, table = "contractile_executions", schema = "contractile_execution_v1", aux_tables = [ "adjust_drift_history" ] }, - { kind = 'drift_log, path = ".machine_readable/6a2/DRIFT.a2ml", + { kind = 'drift_log, path = ".machine_readable/descriptiles/DRIFT.a2ml", append_only = true }, ], @@ -140,7 +140,7 @@ let base = import "../_base.ncl" in signature_required = true, }, ], - signed_record_destination = ".machine_readable/6a2/ratification-.a2ml", + signed_record_destination = ".machine_readable/descriptiles/ratification-.a2ml", must_precede_work = true, }, diff --git a/.machine_readable/contractiles/bust/bust.k9.ncl b/.machine_readable/contractiles/bust/bust.k9.ncl index c60a0aec..3d28c22d 100644 --- a/.machine_readable/contractiles/bust/bust.k9.ncl +++ b/.machine_readable/contractiles/bust/bust.k9.ncl @@ -81,7 +81,7 @@ let base = import "../_base.ncl" in { kind = 'verisimdb, table = "contractile_executions", schema = "contractile_execution_v1", aux_tables = [ "bust_triggers_history" ] }, - { kind = 'drift_log, path = ".machine_readable/6a2/DRIFT.a2ml", + { kind = 'drift_log, path = ".machine_readable/descriptiles/DRIFT.a2ml", append_only = true }, ], @@ -134,7 +134,7 @@ let base = import "../_base.ncl" in signature_required = true, }, ], - signed_record_destination = ".machine_readable/6a2/ratification-.a2ml", + signed_record_destination = ".machine_readable/descriptiles/ratification-.a2ml", must_precede_work = true, }, diff --git a/.machine_readable/contractiles/dust/dust.k9.ncl b/.machine_readable/contractiles/dust/dust.k9.ncl index ef21668c..183fc077 100644 --- a/.machine_readable/contractiles/dust/dust.k9.ncl +++ b/.machine_readable/contractiles/dust/dust.k9.ncl @@ -91,7 +91,7 @@ let base = import "../_base.ncl" in { kind = 'verisimdb, table = "contractile_executions", schema = "contractile_execution_v1", aux_tables = [ "dust_retirement_history" ] }, - { kind = 'drift_log, path = ".machine_readable/6a2/DRIFT.a2ml", + { kind = 'drift_log, path = ".machine_readable/descriptiles/DRIFT.a2ml", append_only = true }, ], @@ -144,7 +144,7 @@ let base = import "../_base.ncl" in signature_required = true, }, ], - signed_record_destination = ".machine_readable/6a2/ratification-.a2ml", + signed_record_destination = ".machine_readable/descriptiles/ratification-.a2ml", must_precede_work = true, }, diff --git a/.machine_readable/contractiles/intend/intend.k9.ncl b/.machine_readable/contractiles/intend/intend.k9.ncl index 5b0c2951..41960f36 100644 --- a/.machine_readable/contractiles/intend/intend.k9.ncl +++ b/.machine_readable/contractiles/intend/intend.k9.ncl @@ -23,7 +23,7 @@ # (feedback_audit_tool_suppression_design.md — structural > markers). # * Sessional drift detection hooks (on_close, on_open). # * Ratification at session open; drift log at session close. -# * Evidence sinks: VeriSimDB (queryable) + 6a2/DRIFT.a2ml (repo-local). +# * Evidence sinks: VeriSimDB (queryable) + descriptiles/DRIFT.a2ml (repo-local). # * Failure-mode defenses cross-referenced to the AI failure catalog. let base_k9 = import "../k9/template-hunt.k9.ncl" in @@ -111,7 +111,7 @@ let base = import "../_base.ncl" in # Evidence sinks — BOTH written, every execution. # VeriSimDB = queryable machine record (feedback_verisimdb_policy.md). - # 6a2/DRIFT.a2ml = repo-local append-only drift log (feedback_sessional_ + # descriptiles/DRIFT.a2ml = repo-local append-only drift log (feedback_sessional_ # drift_detection.md + user_6a2_is_contractile_ought.md descriptive role). evidence_sinks = [ { @@ -121,7 +121,7 @@ let base = import "../_base.ncl" in }, { kind = 'drift_log, - path = ".machine_readable/6a2/DRIFT.a2ml", + path = ".machine_readable/descriptiles/DRIFT.a2ml", append_only = true, }, ], @@ -213,7 +213,7 @@ let base = import "../_base.ncl" in # the AI is the holder of the line against enthusiasm drift. }, ], - signed_record_destination = ".machine_readable/6a2/ratification-.a2ml", + signed_record_destination = ".machine_readable/descriptiles/ratification-.a2ml", must_precede_work = true, }, diff --git a/.machine_readable/contractiles/must/must.k9.ncl b/.machine_readable/contractiles/must/must.k9.ncl index 6bb51fcd..f139ef37 100644 --- a/.machine_readable/contractiles/must/must.k9.ncl +++ b/.machine_readable/contractiles/must/must.k9.ncl @@ -118,7 +118,7 @@ let base = import "../_base.ncl" in }, { kind = 'drift_log, - path = ".machine_readable/6a2/DRIFT.a2ml", + path = ".machine_readable/descriptiles/DRIFT.a2ml", append_only = true, }, ], @@ -193,7 +193,7 @@ let base = import "../_base.ncl" in signature_required = true, }, ], - signed_record_destination = ".machine_readable/6a2/ratification-.a2ml", + signed_record_destination = ".machine_readable/descriptiles/ratification-.a2ml", must_precede_work = true, }, diff --git a/.machine_readable/contractiles/trust/trust.k9.ncl b/.machine_readable/contractiles/trust/trust.k9.ncl index 6e61ed33..72ca2714 100644 --- a/.machine_readable/contractiles/trust/trust.k9.ncl +++ b/.machine_readable/contractiles/trust/trust.k9.ncl @@ -38,7 +38,7 @@ # * Plain-language translation — user never authors a Nickel schema for # a cipher suite; AI does the spec work, user reviews in domain # language ("TLS 1.3 with PQ key exchange, HSTS preload, 1yr"). -# * Evidence sinks: VeriSimDB (queryable) + 6a2/DRIFT.a2ml (repo-local). +# * Evidence sinks: VeriSimDB (queryable) + descriptiles/DRIFT.a2ml (repo-local). # * Failure-mode defenses cross-referenced — trust carries the most # defenses of any verb because the threat surface is widest. @@ -142,7 +142,7 @@ let base = import "../_base.ncl" in }, { kind = 'drift_log, - path = ".machine_readable/6a2/DRIFT.a2ml", + path = ".machine_readable/descriptiles/DRIFT.a2ml", append_only = true, }, ], @@ -232,7 +232,7 @@ let base = import "../_base.ncl" in signature_required = true, }, ], - signed_record_destination = ".machine_readable/6a2/ratification-.a2ml", + signed_record_destination = ".machine_readable/descriptiles/ratification-.a2ml", must_precede_work = true, }, diff --git a/.machine_readable/6a2/AGENTIC.a2ml b/.machine_readable/descriptiles/AGENTIC.a2ml similarity index 97% rename from .machine_readable/6a2/AGENTIC.a2ml rename to .machine_readable/descriptiles/AGENTIC.a2ml index 63f5c9c3..e87fe992 100644 --- a/.machine_readable/6a2/AGENTIC.a2ml +++ b/.machine_readable/descriptiles/AGENTIC.a2ml @@ -36,4 +36,4 @@ release-claim-requires-hard-pass = true [automation-hooks] # on-enter: Read 0-AI-MANIFEST.a2ml, then STATE.a2ml # on-exit: Update STATE.a2ml with session outcomes -# on-commit: Run just validate-rsr +# on-commit: Run just validate diff --git a/.machine_readable/6a2/ECOSYSTEM.a2ml b/.machine_readable/descriptiles/ECOSYSTEM.a2ml similarity index 100% rename from .machine_readable/6a2/ECOSYSTEM.a2ml rename to .machine_readable/descriptiles/ECOSYSTEM.a2ml diff --git a/.machine_readable/6a2/META.a2ml b/.machine_readable/descriptiles/META.a2ml similarity index 100% rename from .machine_readable/6a2/META.a2ml rename to .machine_readable/descriptiles/META.a2ml diff --git a/.machine_readable/6a2/NEUROSYM.a2ml b/.machine_readable/descriptiles/NEUROSYM.a2ml similarity index 100% rename from .machine_readable/6a2/NEUROSYM.a2ml rename to .machine_readable/descriptiles/NEUROSYM.a2ml diff --git a/.machine_readable/6a2/PLAYBOOK.a2ml b/.machine_readable/descriptiles/PLAYBOOK.a2ml similarity index 100% rename from .machine_readable/6a2/PLAYBOOK.a2ml rename to .machine_readable/descriptiles/PLAYBOOK.a2ml diff --git a/.machine_readable/6a2/STATE.a2ml b/.machine_readable/descriptiles/STATE.a2ml similarity index 78% rename from .machine_readable/6a2/STATE.a2ml rename to .machine_readable/descriptiles/STATE.a2ml index d6046fa5..5a5cdda6 100644 --- a/.machine_readable/6a2/STATE.a2ml +++ b/.machine_readable/descriptiles/STATE.a2ml @@ -10,9 +10,9 @@ [metadata] project = "standards" version = "0.3.0" -last-updated = "2026-06-03T00:00:00Z" +last-updated = "2026-08-24T00:00:00Z" status = "active" -session = "2026-06-03 AffineScript external-pointer registry + registry-verify repair + workflow startup_failure fixes" +session = "2026-08-24 standards descriptiles canonical-path migration" [project-context] name = "Standards" @@ -39,9 +39,28 @@ actions = [ ] [maintenance-status] -last-run-utc = "2026-06-03T00:00:00Z" +last-run-utc = "2026-08-24T00:00:00Z" last-result = "pass" # unknown | pass | warn | fail +[session-history-2026-08-24] +session = "2026-08-24 standards descriptiles canonical-path migration" +capabilities-added = [ + "Migrated active .machine_readable/6a2 directories to the canonical .machine_readable/descriptiles path throughout the standards monorepo.", + "Repointed live generators, release checks, Hypatia rule definitions, normative RSR/A2ML documentation, examples, and agent entry points to descriptiles.", + "Removed the temporary Hypatia SD004 baseline exception after the authority sources converged on the canonical path." +] +verification = [ + "just validate: pass", + "Wave-6 canonical-names regression: 4 passed, 0 failed", + "registry/topology generator --check: pass", + "A2ML Rust tests: 50 passed, 0 failed", + "K9 Rust tests: 45 passed, 0 failed" +] +notes = [ + "The archived standards-update/.machine_readable/6scm-archive payload retains its historical pre-descriptiles directory name.", + "Explicit legacy-input readers and banned-token positive controls retain the deprecated spelling by design." +] + [session-history-2026-06-03] session = "2026-06-03 AffineScript external-pointer registry + registry-verify repair + workflow startup_failure fixes" prs-merged = [ diff --git a/.machine_readable/scorecards/k9-coordination-protocol.scorecard.a2ml b/.machine_readable/scorecards/k9-coordination-protocol.scorecard.a2ml index 9dde563f..0f0e9182 100644 --- a/.machine_readable/scorecards/k9-coordination-protocol.scorecard.a2ml +++ b/.machine_readable/scorecards/k9-coordination-protocol.scorecard.a2ml @@ -36,7 +36,7 @@ effects = "A malformed coordination.k9 (missing id/rule/reason on an invariant) [[must]] id = "M4" -text = "The k9-init tool MUST correctly extract languages/banned/practices from existing .machine_readable/6a2 A2ML files and MUST refuse to overwrite an existing coordination.k9 unless --force is passed." +text = "The k9-init tool MUST correctly extract languages/banned/practices from existing .machine_readable/descriptiles A2ML files and MUST refuse to overwrite an existing coordination.k9 unless --force is passed." system = "tools/k9-init/src/main.rs unit tests (cargo test): extracts_list_from_scheme, extracts_pairs_from_scheme, missing_key_returns_empty, render_includes_header_and_sections, slug_normalises" status = "pass" evidence = "Ran cargo test in tools/k9-init: 5 passed, 0 failed (extracts_list_from_scheme, extracts_pairs_from_scheme, missing_key_returns_empty, render_includes_header_and_sections, slug_normalises); overwrite guard implemented at main.rs:42-48 (checks out_path.exists() && !force)" diff --git a/.machine_readable/template-capability-gates.toml b/.machine_readable/template-capability-gates.toml index 99f023ef..275be7a6 100644 --- a/.machine_readable/template-capability-gates.toml +++ b/.machine_readable/template-capability-gates.toml @@ -23,7 +23,7 @@ known = ["rust", "zig", "agda", "idris2", "haskell", "gleam", "elixir", "affines [baseline] # Always carried (gate = empty). Globs/dirs allowed; not capability-gated. -paths = ["README.adoc", "EXPLAINME.adoc", "LICENSE", "SECURITY.md", "CONTRIBUTING.md", "CODE_OF_CONDUCT.md", "CHANGELOG.md", "0-AI-MANIFEST.a2ml", ".machine_readable/6a2/", ".machine_readable/rsr-profile.a2ml", ".well-known/", ".gitignore", "Justfile"] +paths = ["README.adoc", "EXPLAINME.adoc", "LICENSE", "SECURITY.md", "CONTRIBUTING.md", "CODE_OF_CONDUCT.md", "CHANGELOG.md", "0-AI-MANIFEST.a2ml", ".machine_readable/descriptiles/", ".machine_readable/rsr-profile.a2ml", ".well-known/", ".gitignore", "Justfile"] [gates] # "module path (file, dir/, or glob)" = "gating capability" diff --git a/.meta/REQUIRED-FILES.adoc b/.meta/REQUIRED-FILES.adoc index 694c7b68..345225e4 100644 --- a/.meta/REQUIRED-FILES.adoc +++ b/.meta/REQUIRED-FILES.adoc @@ -21,7 +21,7 @@ The following files *MUST* be present and kept up-to-date in every repository: ==== These files use the `.a2ml` extension. Earlier versions of this doc listed them as `.scm`; that was stale drift. `.scm` is reserved exclusively -for Guix-related files (`guix.scm`, `.guix-channel`). All 6a2 metadata +for Guix-related files (`guix.scm`, `.guix-channel`). All descriptiles metadata files use `.a2ml`. ==== diff --git a/0-AI-MANIFEST.a2ml b/0-AI-MANIFEST.a2ml index de7b7539..15fdb573 100644 --- a/0-AI-MANIFEST.a2ml +++ b/0-AI-MANIFEST.a2ml @@ -2,7 +2,7 @@ **This is the canonical machine front door for `hyperpolymath/standards`.** The canonical *human* front door is `README.adoc`. Every other "what is this -repo" doc (EXPLAINME.adoc, TOPOLOGY.md, QUICKSTART-*.adoc, llm-warmup-*.md) is a +repo" doc (EXPLAINME.adoc, TOPOLOGY.adoc, QUICKSTART-*.adoc, llm-warmup-*.md) is a thin pointer back to one of these two. ## WHAT IS THIS REPO? @@ -27,15 +27,15 @@ content-addressed `source_hash`. Prose explanation: `REGISTRY.adoc`. | Readiness grades | `adoption-readiness-grades/`, `foundations-readiness-grades/`, `component-readiness-grades/`, `toolchain-readiness-grades/` | | Enforcement / CI | `.github/workflows/`, `hooks/` | | Drift / staleness automation | `REGISTRY.adoc`, `hypatia-rules/` (HYP-S006); reusable-pin freshness: `docs/decisions/ADR-003-workflow-pin-staleness-window.adoc`, `scripts/check-workflow-staleness.sh`, `scripts/propagate-workflow-pins.sh` | -| Derived architecture map | `TOPOLOGY.md` (generated — do not edit) | -| Current project state | `.machine_readable/6a2/STATE.a2ml` | +| Derived architecture map | `TOPOLOGY.adoc` (generated — do not edit) | +| Current project state | `.machine_readable/descriptiles/STATE.a2ml` | | Education layer (deep docs, by audience) | `docs/wikis/` (Users / Developers / Maintainers); machine mirror `docs/wikis/0.2-AI-MANIFEST.a2ml` | ## CANONICAL LOCATIONS (UNIVERSAL RULE) -### Machine-readable metadata lives in `.machine_readable/6a2/` ONLY +### Machine-readable metadata lives in `.machine_readable/descriptiles/` ONLY -The 7 A2ML files MUST exist under `.machine_readable/6a2/` (this repo's +The 7 A2ML files MUST exist under `.machine_readable/descriptiles/` (this repo's absorbed-satellite layout), never in the repo root: 1. **STATE.a2ml** — project state, progress, blockers @@ -51,17 +51,17 @@ absorbed-satellite layout), never in the repo root: ### Generated files — DO NOT EDIT BY HAND - `.machine_readable/REGISTRY.a2ml` — regenerate with `just registry` -- `TOPOLOGY.md` — regenerated by the same generator (`scripts/build-registry.sh`) +- `TOPOLOGY.adoc` — regenerated by the same generator (`scripts/build-registry.sh`) CI (`registry-verify.yml`) fails the build if either drifts from the file tree. ## CORE INVARIANTS 1. **No A2ML duplication** — root must NOT contain STATE.a2ml, META.a2ml, etc. -2. **Single source of truth** — `.machine_readable/6a2/` is authoritative for state. +2. **Single source of truth** — `.machine_readable/descriptiles/` is authoritative for state. 3. **Registry is generated, not authored** — edit the `SPECS` table in `scripts/build-registry.sh`, then run `just registry`; never hand-edit - `REGISTRY.a2ml` or `TOPOLOGY.md`. + `REGISTRY.a2ml` or `TOPOLOGY.adoc`. 4. **Licence is Manual-Only for agents** — every file's licence/SPDX is set by the owner. Agents NEVER edit, sweep, or relicense `LICENSE` files or SPDX headers; licence drift is FLAG-ONLY (`:review`). See `LICENSE`, @@ -72,14 +72,14 @@ CI (`registry-verify.yml`) fails the build if either drifts from the file tree. - Read THIS file, then `README.adoc`. - Read `.machine_readable/REGISTRY.a2ml` to locate the spec you need. -- Read `.machine_readable/6a2/STATE.a2ml` for current status + blockers. -- Read `.machine_readable/6a2/AGENTIC.a2ml` for interaction patterns. +- Read `.machine_readable/descriptiles/STATE.a2ml` for current status + blockers. +- Read `.machine_readable/descriptiles/AGENTIC.a2ml` for interaction patterns. - Read `.claude/CLAUDE.md` for the language + licence policy (binding). ## DRIFT AUTOMATION (how this repo stays honest) ``` -file tree + STATE.a2ml ──► scripts/build-registry.sh ──► REGISTRY.a2ml ──► TOPOLOGY.md +file tree + STATE.a2ml ──► scripts/build-registry.sh ──► REGISTRY.a2ml ──► TOPOLOGY.adoc ▲ │ │ ▼ just registry / registry-verify.yml HYP-S006 (registry-staleness) @@ -90,7 +90,7 @@ file tree + STATE.a2ml ──► scripts/build-registry.sh ──► REGISTRY.a2 After reading, state: **"I have read the standards manifest. The human front door is README.adoc and the machine index is .machine_readable/REGISTRY.a2ml. -A2ML state lives in .machine_readable/6a2/ only. REGISTRY.a2ml and TOPOLOGY.md +A2ML state lives in .machine_readable/descriptiles/ only. REGISTRY.a2ml and TOPOLOGY.adoc are generated — I will not hand-edit them. Licence/SPDX is Manual-Only — I will flag, never edit."** diff --git a/0-ai-gatekeeper-protocol/.machine_readable/6a2/AGENTIC.a2ml b/0-ai-gatekeeper-protocol/.machine_readable/descriptiles/AGENTIC.a2ml similarity index 100% rename from 0-ai-gatekeeper-protocol/.machine_readable/6a2/AGENTIC.a2ml rename to 0-ai-gatekeeper-protocol/.machine_readable/descriptiles/AGENTIC.a2ml diff --git a/0-ai-gatekeeper-protocol/.machine_readable/6a2/ECOSYSTEM.a2ml b/0-ai-gatekeeper-protocol/.machine_readable/descriptiles/ECOSYSTEM.a2ml similarity index 100% rename from 0-ai-gatekeeper-protocol/.machine_readable/6a2/ECOSYSTEM.a2ml rename to 0-ai-gatekeeper-protocol/.machine_readable/descriptiles/ECOSYSTEM.a2ml diff --git a/0-ai-gatekeeper-protocol/.machine_readable/6a2/META.a2ml b/0-ai-gatekeeper-protocol/.machine_readable/descriptiles/META.a2ml similarity index 100% rename from 0-ai-gatekeeper-protocol/.machine_readable/6a2/META.a2ml rename to 0-ai-gatekeeper-protocol/.machine_readable/descriptiles/META.a2ml diff --git a/0-ai-gatekeeper-protocol/.machine_readable/6a2/NEUROSYM.a2ml b/0-ai-gatekeeper-protocol/.machine_readable/descriptiles/NEUROSYM.a2ml similarity index 100% rename from 0-ai-gatekeeper-protocol/.machine_readable/6a2/NEUROSYM.a2ml rename to 0-ai-gatekeeper-protocol/.machine_readable/descriptiles/NEUROSYM.a2ml diff --git a/0-ai-gatekeeper-protocol/.machine_readable/6a2/PLAYBOOK.a2ml b/0-ai-gatekeeper-protocol/.machine_readable/descriptiles/PLAYBOOK.a2ml similarity index 100% rename from 0-ai-gatekeeper-protocol/.machine_readable/6a2/PLAYBOOK.a2ml rename to 0-ai-gatekeeper-protocol/.machine_readable/descriptiles/PLAYBOOK.a2ml diff --git a/0-ai-gatekeeper-protocol/.machine_readable/6a2/STATE.a2ml b/0-ai-gatekeeper-protocol/.machine_readable/descriptiles/STATE.a2ml similarity index 100% rename from 0-ai-gatekeeper-protocol/.machine_readable/6a2/STATE.a2ml rename to 0-ai-gatekeeper-protocol/.machine_readable/descriptiles/STATE.a2ml diff --git a/0-ai-gatekeeper-protocol/docs/AI-MANIFEST-SPEC.adoc b/0-ai-gatekeeper-protocol/docs/AI-MANIFEST-SPEC.adoc index 9d1a2892..c7148c9b 100644 --- a/0-ai-gatekeeper-protocol/docs/AI-MANIFEST-SPEC.adoc +++ b/0-ai-gatekeeper-protocol/docs/AI-MANIFEST-SPEC.adoc @@ -185,7 +185,7 @@ This is the AI manifest for **[REPO-NAME]**. It declares: ### Machine-Readable Metadata: `.machine_readable/` ONLY -These 6 A2ML files MUST exist in `.machine_readable/6a2/` directory ONLY +These 6 A2ML files MUST exist in `.machine_readable/descriptiles/` directory ONLY (migrated from Guile Scheme on 2026-04-12): 1. **STATE.a2ml** - Project state, progress, blockers 2. **META.a2ml** - Architecture decisions, governance @@ -212,7 +212,7 @@ These 6 A2ML files MUST exist in `.machine_readable/6a2/` directory ONLY ## CORE INVARIANTS 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 +2. **Single source of truth** - `.machine_readable/descriptiles/` 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 ---- @@ -239,8 +239,8 @@ repo-name/ ├── 0-AI-MANIFEST.a2ml # THIS FILE (start here) ├── README.md # Project overview ├── src/ # Source code -├── .machine_readable/ # A2ML files (6 files in 6a2/ subdirectory) -│ └── 6a2/ +├── .machine_readable/ # A2ML files (6 files in descriptiles/ subdirectory) +│ └── descriptiles/ │ ├── STATE.a2ml │ └── ... └── .bot_directives/ # Bot instructions @@ -267,7 +267,7 @@ repo-name/ ✅ Read THIS file (0-AI-MANIFEST.a2ml) first ✅ Understand canonical locations ✅ Know the invariants -✅ Read `.machine_readable/6a2/STATE.a2ml` +✅ Read `.machine_readable/descriptiles/STATE.a2ml` ---- === Lifecycle Hooks @@ -295,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/6a2/STATE.a2ml` +3. Read `.machine_readable/descriptiles/STATE.a2ml` ### on-exit (Session End) When ending a session: -1. Update `.machine_readable/6a2/STATE.a2ml` if changes made +1. Update `.machine_readable/descriptiles/STATE.a2ml` if changes made 2. Log session end 3. Document new blockers ---- diff --git a/0-ai-gatekeeper-protocol/mcp-repo-guardian/.machine_readable/6a2/AGENTIC.a2ml b/0-ai-gatekeeper-protocol/mcp-repo-guardian/.machine_readable/descriptiles/AGENTIC.a2ml similarity index 100% rename from 0-ai-gatekeeper-protocol/mcp-repo-guardian/.machine_readable/6a2/AGENTIC.a2ml rename to 0-ai-gatekeeper-protocol/mcp-repo-guardian/.machine_readable/descriptiles/AGENTIC.a2ml diff --git a/0-ai-gatekeeper-protocol/mcp-repo-guardian/.machine_readable/6a2/ECOSYSTEM.a2ml b/0-ai-gatekeeper-protocol/mcp-repo-guardian/.machine_readable/descriptiles/ECOSYSTEM.a2ml similarity index 100% rename from 0-ai-gatekeeper-protocol/mcp-repo-guardian/.machine_readable/6a2/ECOSYSTEM.a2ml rename to 0-ai-gatekeeper-protocol/mcp-repo-guardian/.machine_readable/descriptiles/ECOSYSTEM.a2ml diff --git a/0-ai-gatekeeper-protocol/mcp-repo-guardian/.machine_readable/6a2/META.a2ml b/0-ai-gatekeeper-protocol/mcp-repo-guardian/.machine_readable/descriptiles/META.a2ml similarity index 100% rename from 0-ai-gatekeeper-protocol/mcp-repo-guardian/.machine_readable/6a2/META.a2ml rename to 0-ai-gatekeeper-protocol/mcp-repo-guardian/.machine_readable/descriptiles/META.a2ml diff --git a/0-ai-gatekeeper-protocol/mcp-repo-guardian/.machine_readable/6a2/NEUROSYM.a2ml b/0-ai-gatekeeper-protocol/mcp-repo-guardian/.machine_readable/descriptiles/NEUROSYM.a2ml similarity index 100% rename from 0-ai-gatekeeper-protocol/mcp-repo-guardian/.machine_readable/6a2/NEUROSYM.a2ml rename to 0-ai-gatekeeper-protocol/mcp-repo-guardian/.machine_readable/descriptiles/NEUROSYM.a2ml diff --git a/0-ai-gatekeeper-protocol/mcp-repo-guardian/.machine_readable/6a2/PLAYBOOK.a2ml b/0-ai-gatekeeper-protocol/mcp-repo-guardian/.machine_readable/descriptiles/PLAYBOOK.a2ml similarity index 100% rename from 0-ai-gatekeeper-protocol/mcp-repo-guardian/.machine_readable/6a2/PLAYBOOK.a2ml rename to 0-ai-gatekeeper-protocol/mcp-repo-guardian/.machine_readable/descriptiles/PLAYBOOK.a2ml diff --git a/0-ai-gatekeeper-protocol/mcp-repo-guardian/.machine_readable/6a2/STATE.a2ml b/0-ai-gatekeeper-protocol/mcp-repo-guardian/.machine_readable/descriptiles/STATE.a2ml similarity index 100% rename from 0-ai-gatekeeper-protocol/mcp-repo-guardian/.machine_readable/6a2/STATE.a2ml rename to 0-ai-gatekeeper-protocol/mcp-repo-guardian/.machine_readable/descriptiles/STATE.a2ml diff --git a/0-ai-gatekeeper-protocol/repo-guardian-fs/.machine_readable/6a2/AGENTIC.a2ml b/0-ai-gatekeeper-protocol/repo-guardian-fs/.machine_readable/descriptiles/AGENTIC.a2ml similarity index 100% rename from 0-ai-gatekeeper-protocol/repo-guardian-fs/.machine_readable/6a2/AGENTIC.a2ml rename to 0-ai-gatekeeper-protocol/repo-guardian-fs/.machine_readable/descriptiles/AGENTIC.a2ml diff --git a/0-ai-gatekeeper-protocol/repo-guardian-fs/.machine_readable/6a2/ECOSYSTEM.a2ml b/0-ai-gatekeeper-protocol/repo-guardian-fs/.machine_readable/descriptiles/ECOSYSTEM.a2ml similarity index 100% rename from 0-ai-gatekeeper-protocol/repo-guardian-fs/.machine_readable/6a2/ECOSYSTEM.a2ml rename to 0-ai-gatekeeper-protocol/repo-guardian-fs/.machine_readable/descriptiles/ECOSYSTEM.a2ml diff --git a/0-ai-gatekeeper-protocol/repo-guardian-fs/.machine_readable/6a2/META.a2ml b/0-ai-gatekeeper-protocol/repo-guardian-fs/.machine_readable/descriptiles/META.a2ml similarity index 100% rename from 0-ai-gatekeeper-protocol/repo-guardian-fs/.machine_readable/6a2/META.a2ml rename to 0-ai-gatekeeper-protocol/repo-guardian-fs/.machine_readable/descriptiles/META.a2ml diff --git a/0-ai-gatekeeper-protocol/repo-guardian-fs/.machine_readable/6a2/NEUROSYM.a2ml b/0-ai-gatekeeper-protocol/repo-guardian-fs/.machine_readable/descriptiles/NEUROSYM.a2ml similarity index 100% rename from 0-ai-gatekeeper-protocol/repo-guardian-fs/.machine_readable/6a2/NEUROSYM.a2ml rename to 0-ai-gatekeeper-protocol/repo-guardian-fs/.machine_readable/descriptiles/NEUROSYM.a2ml diff --git a/0-ai-gatekeeper-protocol/repo-guardian-fs/.machine_readable/6a2/PLAYBOOK.a2ml b/0-ai-gatekeeper-protocol/repo-guardian-fs/.machine_readable/descriptiles/PLAYBOOK.a2ml similarity index 100% rename from 0-ai-gatekeeper-protocol/repo-guardian-fs/.machine_readable/6a2/PLAYBOOK.a2ml rename to 0-ai-gatekeeper-protocol/repo-guardian-fs/.machine_readable/descriptiles/PLAYBOOK.a2ml diff --git a/0-ai-gatekeeper-protocol/repo-guardian-fs/.machine_readable/6a2/STATE.a2ml b/0-ai-gatekeeper-protocol/repo-guardian-fs/.machine_readable/descriptiles/STATE.a2ml similarity index 100% rename from 0-ai-gatekeeper-protocol/repo-guardian-fs/.machine_readable/6a2/STATE.a2ml rename to 0-ai-gatekeeper-protocol/repo-guardian-fs/.machine_readable/descriptiles/STATE.a2ml diff --git a/AGENTS.adoc b/AGENTS.adoc index 6fb5d530..46a25a10 100644 --- a/AGENTS.adoc +++ b/AGENTS.adoc @@ -15,7 +15,7 @@ machine-readable. Canonical sources include `+constitution/+`, domain standard sources, profile sources, and the registry source consumed by `+scripts/build-registry.sh+`. `+.machine_readable/REGISTRY.a2ml+` and -`+TOPOLOGY.md+` are generated: never edit them directly. Preserve +`+TOPOLOGY.adoc+` are generated: never edit them directly. Preserve licences, coined names, MAA’s independent authority, and current language/build conventions. Do not add TypeScript or Deno, weaken validation, or describe draft/tested work as proven. diff --git a/CANONICAL-NAMES.adoc b/CANONICAL-NAMES.adoc index b1d4102a..ec46b2b5 100644 --- a/CANONICAL-NAMES.adoc +++ b/CANONICAL-NAMES.adoc @@ -118,9 +118,10 @@ estate-wide, `standards` included. | The descriptive machine-readable metadata family: `STATE`, `META`, `ECOSYSTEM`, `AGENTIC`, `NEUROSYM`, `PLAYBOOK`, plus `CLADE` and `anchors/ANCHOR`. Canonical directory `.machine_readable/descriptiles/`. - `rsr-template-repo` leads (rename merged); `standards` still carries `6a2` - in ~81 files and is being migrated. The `.machine_readable/6a2/` path is a - 404 on repos that have migrated — repoint links to `descriptiles/`. + `rsr-template-repo` and `standards` use the canonical directory. The + deprecated `.machine_readable/6a2/` spelling remains only in explicit + migration inputs, historical records, and the reintroduction guard's + positive controls. | **`agent_instructions`** | **`bot_directives`** diff --git a/CONTRIBUTING.adoc b/CONTRIBUTING.adoc index 70b97c78..805b18b3 100644 --- a/CONTRIBUTING.adoc +++ b/CONTRIBUTING.adoc @@ -100,8 +100,8 @@ every tracked file under a spec home, so _any_ edit under one (including [source,sh] ---- -just registry # regenerates REGISTRY.a2ml + TOPOLOGY.md -git add .machine_readable/REGISTRY.a2ml TOPOLOGY.md +just registry # regenerates REGISTRY.a2ml + TOPOLOGY.adoc +git add .machine_readable/REGISTRY.a2ml TOPOLOGY.adoc ---- If you skip this, the required "`Registry + topology in sync`" check diff --git a/QUICKSTART-DEV.adoc b/QUICKSTART-DEV.adoc index d9a5d63d..68ca75ab 100644 --- a/QUICKSTART-DEV.adoc +++ b/QUICKSTART-DEV.adoc @@ -72,8 +72,8 @@ standards/ ├── *-protocol/ # Protocol specs ├── *-readiness-grades/ # ARG / FRG / CRG / TRG frameworks ├── hypatia-rules/ # Dogfooding rules incl. HYP-S006 (drift) -├── scripts/build-registry.sh # Generator for REGISTRY.a2ml + TOPOLOGY.md -├── .machine_readable/ # State (6a2/), REGISTRY.a2ml, contractiles +├── scripts/build-registry.sh # Generator for REGISTRY.a2ml + TOPOLOGY.adoc +├── .machine_readable/ # State (descriptiles/), REGISTRY.a2ml, contractiles ├── Justfile # Task runner recipes ├── guix.scm / flake.nix # Guix (primary) / Nix (fallback) env └── .github/workflows/ # Enforcement + registry-verify CI @@ -81,13 +81,13 @@ standards/ == Registry workflow (important) -`.machine_readable/REGISTRY.a2ml` and `TOPOLOGY.md` are *generated*. To add or +`.machine_readable/REGISTRY.a2ml` and `TOPOLOGY.adoc` are *generated*. To add or move a spec, edit the `SPECS` table in link:scripts/build-registry.sh[`scripts/build-registry.sh`], then: [source,bash] ---- -just registry # regenerate REGISTRY.a2ml + TOPOLOGY.md +just registry # regenerate REGISTRY.a2ml + TOPOLOGY.adoc just registry-check # what CI enforces — fails on drift ---- @@ -117,8 +117,8 @@ just panic-scan # No new security issues Read `.machine_readable/MUST.contractile` before making changes. Key invariants that must never be violated: -* A2ML state files live in `.machine_readable/6a2/` only — never the repo root. -* `REGISTRY.a2ml` + `TOPOLOGY.md` are generated — regenerate, never hand-edit. +* A2ML state files live in `.machine_readable/descriptiles/` only — never the repo root. +* `REGISTRY.a2ml` + `TOPOLOGY.adoc` are generated — regenerate, never hand-edit. * No Makefiles (use Justfile); SPDX header on every source file. * Licence/SPDX is Manual-Only for agents — flag drift, never edit it. diff --git a/QUICKSTART-USER.adoc b/QUICKSTART-USER.adoc index 1f765047..a4a7025b 100644 --- a/QUICKSTART-USER.adoc +++ b/QUICKSTART-USER.adoc @@ -45,4 +45,4 @@ to read first: * *Routing:* the table at the top of link:README.adoc[README.adoc] * *Report a problem:* https://github.com/hyperpolymath/standards/issues -* *Architecture map (derived):* link:TOPOLOGY.md[TOPOLOGY.md] +* *Architecture map (derived):* link:TOPOLOGY.adoc[TOPOLOGY.adoc] diff --git a/README.adoc b/README.adoc index d08988a2..25f04042 100644 --- a/README.adoc +++ b/README.adoc @@ -26,7 +26,7 @@ routes off them: |=== Every other "what is this repo" doc is now a thin pointer back to these two -(link:EXPLAINME.adoc[EXPLAINME.adoc], link:TOPOLOGY.md[TOPOLOGY.md], +(link:EXPLAINME.adoc[EXPLAINME.adoc], link:TOPOLOGY.adoc[TOPOLOGY.adoc], `QUICKSTART-*.adoc`, `llm-warmup-*.md`). === If you want X, go here @@ -60,7 +60,7 @@ Every other "what is this repo" doc is now a thin pointer back to these two | link:REGISTRY.adoc[REGISTRY.adoc] + link:hypatia-rules/[hypatia-rules/] (HYP-S006); reusable-workflow pin freshness: link:docs/decisions/ADR-003-workflow-pin-staleness-window.adoc[ADR-003] (`scripts/check-workflow-staleness.sh` gate + `scripts/propagate-workflow-pins.sh` deliberate-bump) | The **architecture map** (derived, never frozen) -| link:TOPOLOGY.md[TOPOLOGY.md] (generated from STATE + registry) +| link:TOPOLOGY.adoc[TOPOLOGY.adoc] (generated from STATE + registry) | To **stand up a new repo** to these standards | link:A2ML-REPO-TEMPLATE.adoc[A2ML-REPO-TEMPLATE.adoc] + <> @@ -70,7 +70,7 @@ Every other "what is this repo" doc is now a thin pointer back to these two |=== NOTE: link:.machine_readable/REGISTRY.a2ml[REGISTRY.a2ml] and -link:TOPOLOGY.md[TOPOLOGY.md] are **generated** by +link:TOPOLOGY.adoc[TOPOLOGY.adoc] are **generated** by `scripts/build-registry.sh` (`just registry`) and verified in CI by `registry-verify.yml`. Do not hand-edit them. @@ -501,4 +501,4 @@ _Canonical standards for the Hyperpolymath ecosystem._ == Architecture -See link:TOPOLOGY.md[TOPOLOGY.md] for a visual architecture map and completion dashboard. +See link:TOPOLOGY.adoc[TOPOLOGY.adoc] for a visual architecture map and completion dashboard. diff --git a/REGISTRY.adoc b/REGISTRY.adoc index ff5585c9..b8e1ee0d 100644 --- a/REGISTRY.adoc +++ b/REGISTRY.adoc @@ -88,15 +88,15 @@ The registry and the *derived* topology map are produced by one generator: [source,bash] ---- -just registry # writes .machine_readable/REGISTRY.a2ml + TOPOLOGY.md +just registry # writes .machine_readable/REGISTRY.a2ml + TOPOLOGY.adoc just registry-check # verify-only; non-zero exit on drift ---- -Both `.machine_readable/REGISTRY.a2ml` and link:TOPOLOGY.md[TOPOLOGY.md] are +Both `.machine_readable/REGISTRY.a2ml` and link:TOPOLOGY.adoc[TOPOLOGY.adoc] are *generated files — do not edit by hand*. The single source of truth is the `SPECS` table in link:scripts/build-registry.sh[`scripts/build-registry.sh`]. Add a spec there and the hash, the registry entry, and the topology row all -follow automatically. link:TOPOLOGY.md[TOPOLOGY.md] can therefore never +follow automatically. link:TOPOLOGY.adoc[TOPOLOGY.adoc] can therefore never freeze the way the old hand-maintained version did (it sat at `2026-04-04` claiming 80% while the integration layer read 0%). @@ -117,7 +117,7 @@ Drift is caught at two layers that share the same hash algorithm: [source] ---- -file tree + STATE.a2ml ──► scripts/build-registry.sh ──► REGISTRY.a2ml ──► TOPOLOGY.md +file tree + STATE.a2ml ──► scripts/build-registry.sh ──► REGISTRY.a2ml ──► TOPOLOGY.adoc ▲ │ │ ▼ just registry / registry-verify.yml HYP-S006 (registry-staleness) @@ -145,6 +145,6 @@ cap. 1. Edit the `SPECS` table in link:scripts/build-registry.sh[`scripts/build-registry.sh`]. 2. Run `just registry`. -3. Commit the regenerated `REGISTRY.a2ml` + `TOPOLOGY.md` alongside your change. +3. Commit the regenerated `REGISTRY.a2ml` + `TOPOLOGY.adoc` alongside your change. CI will reject the PR if you change a spec's home without regenerating. diff --git a/REORGANIZATION-PLAN.adoc b/REORGANIZATION-PLAN.adoc index 7662e3b8..b7fd81b4 100644 --- a/REORGANIZATION-PLAN.adoc +++ b/REORGANIZATION-PLAN.adoc @@ -98,7 +98,7 @@ rsr-engine-repo/ ==== 3. Machine Readable Specs -*Current:* Mixed in `+.machine_readable/6a2/+` with other files +*Current:* Mixed in `+.machine_readable/descriptiles/+` with other files *Better:* Organize by standard: .... diff --git a/TEMPLATE-APPLICABILITY-POLICY.adoc b/TEMPLATE-APPLICABILITY-POLICY.adoc index 8addb6bd..80f02929 100644 --- a/TEMPLATE-APPLICABILITY-POLICY.adoc +++ b/TEMPLATE-APPLICABILITY-POLICY.adoc @@ -90,7 +90,7 @@ for humans. `README.adoc`, `EXPLAINME.adoc`, `LICENSE`, `SECURITY.md`, `CONTRIBUTING.md`, `CODE_OF_CONDUCT.md`, `CHANGELOG.md`, `0-AI-MANIFEST.a2ml`, -`.machine_readable/6a2/{STATE,META,ECOSYSTEM,AGENTIC,NEUROSYM,PLAYBOOK}.a2ml`, +`.machine_readable/descriptiles/{STATE,META,ECOSYSTEM,AGENTIC,NEUROSYM,PLAYBOOK}.a2ml`, `.machine_readable/rsr-profile.a2ml`, `.well-known/`, `.gitignore`, `Justfile`, and the SPDX licence invariant (`LICENCE-POLICY.adoc`). diff --git a/TEST-NEEDS.adoc b/TEST-NEEDS.adoc index d6dc9b2e..7cd7d0db 100644 --- a/TEST-NEEDS.adoc +++ b/TEST-NEEDS.adoc @@ -165,7 +165,7 @@ bytes no panic, very long directive name no stackoverflow, unicode content, deep blockquote no stackoverflow (6 tests) - [x] *Aspect/Error*: A2mlError::diagnostic non-empty, RenderError diagnostic (2 tests) - [x] *E2E/Reflexive*: parse standards repo -0-AI-MANIFEST.a2ml, parse .machine_readable/6a2/STATE.a2ml (2 tests) +0-AI-MANIFEST.a2ml, parse .machine_readable/descriptiles/STATE.a2ml (2 tests) *Benchmarks*: `+cargo bench+` from `+a2ml/bindings/rust/+` - Parse small/medium/large_manifest throughput - Render medium throughput - diff --git a/TOPOLOGY.adoc b/TOPOLOGY.adoc index 0c331f87..86c6a3a0 100644 --- a/TOPOLOGY.adoc +++ b/TOPOLOGY.adoc @@ -10,7 +10,7 @@ the canonical `+STATE.a2ml+` by `+scripts/build-registry.sh+`. It cannot freeze: every regeneration re-reads ground truth. Do not edit by hand. ____ -* *Phase:* active | *Maturity:* experimental | *STATE last-updated:* 2026-06-03T00:00:00Z +* *Phase:* active | *Maturity:* experimental | *STATE last-updated:* 2026-08-24T00:00:00Z * *Registry entries:* 33 specs across 6 streams * *Front door:* human → link:README.adoc[README.adoc]; machine → link:0-AI-MANIFEST.a2ml[0-AI-MANIFEST.a2ml] * *Registry:* link:.machine_readable/REGISTRY.a2ml[.machine_readable/REGISTRY.a2ml] (index + source hashes) · prose: link:REGISTRY.adoc[REGISTRY.adoc] diff --git a/a2ml/.machine_readable/6a2/AGENTIC.a2ml b/a2ml/.machine_readable/descriptiles/AGENTIC.a2ml similarity index 100% rename from a2ml/.machine_readable/6a2/AGENTIC.a2ml rename to a2ml/.machine_readable/descriptiles/AGENTIC.a2ml diff --git a/a2ml/.machine_readable/6a2/ECOSYSTEM.a2ml b/a2ml/.machine_readable/descriptiles/ECOSYSTEM.a2ml similarity index 100% rename from a2ml/.machine_readable/6a2/ECOSYSTEM.a2ml rename to a2ml/.machine_readable/descriptiles/ECOSYSTEM.a2ml diff --git a/a2ml/.machine_readable/6a2/META.a2ml b/a2ml/.machine_readable/descriptiles/META.a2ml similarity index 100% rename from a2ml/.machine_readable/6a2/META.a2ml rename to a2ml/.machine_readable/descriptiles/META.a2ml diff --git a/a2ml/.machine_readable/6a2/NEUROSYM.a2ml b/a2ml/.machine_readable/descriptiles/NEUROSYM.a2ml similarity index 100% rename from a2ml/.machine_readable/6a2/NEUROSYM.a2ml rename to a2ml/.machine_readable/descriptiles/NEUROSYM.a2ml diff --git a/a2ml/.machine_readable/6a2/PLAYBOOK.a2ml b/a2ml/.machine_readable/descriptiles/PLAYBOOK.a2ml similarity index 100% rename from a2ml/.machine_readable/6a2/PLAYBOOK.a2ml rename to a2ml/.machine_readable/descriptiles/PLAYBOOK.a2ml diff --git a/a2ml/.machine_readable/6a2/STATE.a2ml b/a2ml/.machine_readable/descriptiles/STATE.a2ml similarity index 100% rename from a2ml/.machine_readable/6a2/STATE.a2ml rename to a2ml/.machine_readable/descriptiles/STATE.a2ml diff --git a/a2ml/READINESS.adoc b/a2ml/READINESS.adoc index baf1c91f..25eeca16 100644 --- a/a2ml/READINESS.adoc +++ b/a2ml/READINESS.adoc @@ -59,7 +59,7 @@ dogfooding. hyperpolymath repos - Validates 6 canonical file types: STATE.a2ml, META.a2ml, ECOSYSTEM.a2ml, AGENTIC.a2ml, NEUROSYM.a2ml, PLAYBOOK.a2ml - Language context diversity confirmed: 1. Rust repos (panic-attacker, -januskey, conflow, a2ml-rs, ephapax) — .machine_readable/6a2/ paths 2. +januskey, conflow, a2ml-rs, ephapax) — .machine_readable/descriptiles/ paths 2. Elixir/Phoenix repos (burble, oblibeny, boj-server adapters) — BEAM ecosystem 3. Gleam repos (k9_gleam, a2ml_gleam, polyglot-formalisms-gleam) — typed BEAM 4. Julia repos (7-tentacles, diff --git a/a2ml/SPEC.adoc b/a2ml/SPEC.adoc index cbb65109..626d10c3 100644 --- a/a2ml/SPEC.adoc +++ b/a2ml/SPEC.adoc @@ -640,7 +640,7 @@ relaxation of base invariants). == 11. Reserved Namespaces The `a2ml/*` profile namespace is reserved by this repository. v1.1 ships the -seven `a2ml/*` profiles for the 6a2 metadata family: +seven `a2ml/*` profiles for the descriptiles metadata family: `a2ml/state`, `a2ml/meta`, `a2ml/ecosystem`, `a2ml/agentic`, `a2ml/neurosym`, `a2ml/playbook`, `a2ml/anchor`. @@ -651,7 +651,7 @@ Their definitions live under `a2ml/profiles/` and are indexed in Other components within this repository MAY register additional `a2ml/*` profiles in their own subtrees, each with its own definition file and registry entry. A2ML core neither enumerates nor depends on them: it ships only the -mechanism (Section 8) and the seven 6a2 profiles above. No namespace other than +mechanism (Section 8) and the seven descriptiles profiles above. No namespace other than `a2ml/*` is defined by A2ML core. == 12. Security Considerations diff --git a/a2ml/actions/validate/.machine_readable/6a2/AGENTIC.a2ml b/a2ml/actions/validate/.machine_readable/descriptiles/AGENTIC.a2ml similarity index 100% rename from a2ml/actions/validate/.machine_readable/6a2/AGENTIC.a2ml rename to a2ml/actions/validate/.machine_readable/descriptiles/AGENTIC.a2ml diff --git a/a2ml/actions/validate/.machine_readable/6a2/ECOSYSTEM.a2ml b/a2ml/actions/validate/.machine_readable/descriptiles/ECOSYSTEM.a2ml similarity index 100% rename from a2ml/actions/validate/.machine_readable/6a2/ECOSYSTEM.a2ml rename to a2ml/actions/validate/.machine_readable/descriptiles/ECOSYSTEM.a2ml diff --git a/a2ml/actions/validate/.machine_readable/6a2/META.a2ml b/a2ml/actions/validate/.machine_readable/descriptiles/META.a2ml similarity index 100% rename from a2ml/actions/validate/.machine_readable/6a2/META.a2ml rename to a2ml/actions/validate/.machine_readable/descriptiles/META.a2ml diff --git a/a2ml/actions/validate/.machine_readable/6a2/NEUROSYM.a2ml b/a2ml/actions/validate/.machine_readable/descriptiles/NEUROSYM.a2ml similarity index 100% rename from a2ml/actions/validate/.machine_readable/6a2/NEUROSYM.a2ml rename to a2ml/actions/validate/.machine_readable/descriptiles/NEUROSYM.a2ml diff --git a/a2ml/actions/validate/.machine_readable/6a2/PLAYBOOK.a2ml b/a2ml/actions/validate/.machine_readable/descriptiles/PLAYBOOK.a2ml similarity index 100% rename from a2ml/actions/validate/.machine_readable/6a2/PLAYBOOK.a2ml rename to a2ml/actions/validate/.machine_readable/descriptiles/PLAYBOOK.a2ml diff --git a/a2ml/actions/validate/.machine_readable/6a2/STATE.a2ml b/a2ml/actions/validate/.machine_readable/descriptiles/STATE.a2ml similarity index 100% rename from a2ml/actions/validate/.machine_readable/6a2/STATE.a2ml rename to a2ml/actions/validate/.machine_readable/descriptiles/STATE.a2ml diff --git a/a2ml/bindings/deno/.machine_readable/6a2/AGENTIC.a2ml b/a2ml/bindings/deno/.machine_readable/descriptiles/AGENTIC.a2ml similarity index 100% rename from a2ml/bindings/deno/.machine_readable/6a2/AGENTIC.a2ml rename to a2ml/bindings/deno/.machine_readable/descriptiles/AGENTIC.a2ml diff --git a/a2ml/bindings/deno/.machine_readable/6a2/ECOSYSTEM.a2ml b/a2ml/bindings/deno/.machine_readable/descriptiles/ECOSYSTEM.a2ml similarity index 100% rename from a2ml/bindings/deno/.machine_readable/6a2/ECOSYSTEM.a2ml rename to a2ml/bindings/deno/.machine_readable/descriptiles/ECOSYSTEM.a2ml diff --git a/a2ml/bindings/deno/.machine_readable/6a2/META.a2ml b/a2ml/bindings/deno/.machine_readable/descriptiles/META.a2ml similarity index 100% rename from a2ml/bindings/deno/.machine_readable/6a2/META.a2ml rename to a2ml/bindings/deno/.machine_readable/descriptiles/META.a2ml diff --git a/a2ml/bindings/deno/.machine_readable/6a2/NEUROSYM.a2ml b/a2ml/bindings/deno/.machine_readable/descriptiles/NEUROSYM.a2ml similarity index 100% rename from a2ml/bindings/deno/.machine_readable/6a2/NEUROSYM.a2ml rename to a2ml/bindings/deno/.machine_readable/descriptiles/NEUROSYM.a2ml diff --git a/a2ml/bindings/deno/.machine_readable/6a2/PLAYBOOK.a2ml b/a2ml/bindings/deno/.machine_readable/descriptiles/PLAYBOOK.a2ml similarity index 100% rename from a2ml/bindings/deno/.machine_readable/6a2/PLAYBOOK.a2ml rename to a2ml/bindings/deno/.machine_readable/descriptiles/PLAYBOOK.a2ml diff --git a/a2ml/bindings/deno/.machine_readable/6a2/STATE.a2ml b/a2ml/bindings/deno/.machine_readable/descriptiles/STATE.a2ml similarity index 100% rename from a2ml/bindings/deno/.machine_readable/6a2/STATE.a2ml rename to a2ml/bindings/deno/.machine_readable/descriptiles/STATE.a2ml diff --git a/a2ml/bindings/haskell/.machine_readable/6a2/AGENTIC.a2ml b/a2ml/bindings/haskell/.machine_readable/descriptiles/AGENTIC.a2ml similarity index 100% rename from a2ml/bindings/haskell/.machine_readable/6a2/AGENTIC.a2ml rename to a2ml/bindings/haskell/.machine_readable/descriptiles/AGENTIC.a2ml diff --git a/a2ml/bindings/haskell/.machine_readable/6a2/ECOSYSTEM.a2ml b/a2ml/bindings/haskell/.machine_readable/descriptiles/ECOSYSTEM.a2ml similarity index 100% rename from a2ml/bindings/haskell/.machine_readable/6a2/ECOSYSTEM.a2ml rename to a2ml/bindings/haskell/.machine_readable/descriptiles/ECOSYSTEM.a2ml diff --git a/a2ml/bindings/haskell/.machine_readable/6a2/META.a2ml b/a2ml/bindings/haskell/.machine_readable/descriptiles/META.a2ml similarity index 100% rename from a2ml/bindings/haskell/.machine_readable/6a2/META.a2ml rename to a2ml/bindings/haskell/.machine_readable/descriptiles/META.a2ml diff --git a/a2ml/bindings/haskell/.machine_readable/6a2/NEUROSYM.a2ml b/a2ml/bindings/haskell/.machine_readable/descriptiles/NEUROSYM.a2ml similarity index 100% rename from a2ml/bindings/haskell/.machine_readable/6a2/NEUROSYM.a2ml rename to a2ml/bindings/haskell/.machine_readable/descriptiles/NEUROSYM.a2ml diff --git a/a2ml/bindings/haskell/.machine_readable/6a2/PLAYBOOK.a2ml b/a2ml/bindings/haskell/.machine_readable/descriptiles/PLAYBOOK.a2ml similarity index 100% rename from a2ml/bindings/haskell/.machine_readable/6a2/PLAYBOOK.a2ml rename to a2ml/bindings/haskell/.machine_readable/descriptiles/PLAYBOOK.a2ml diff --git a/a2ml/bindings/haskell/.machine_readable/6a2/STATE.a2ml b/a2ml/bindings/haskell/.machine_readable/descriptiles/STATE.a2ml similarity index 100% rename from a2ml/bindings/haskell/.machine_readable/6a2/STATE.a2ml rename to a2ml/bindings/haskell/.machine_readable/descriptiles/STATE.a2ml diff --git a/a2ml/bindings/rust/.machine_readable/6a2/AGENTIC.a2ml b/a2ml/bindings/rust/.machine_readable/descriptiles/AGENTIC.a2ml similarity index 100% rename from a2ml/bindings/rust/.machine_readable/6a2/AGENTIC.a2ml rename to a2ml/bindings/rust/.machine_readable/descriptiles/AGENTIC.a2ml diff --git a/a2ml/bindings/rust/.machine_readable/6a2/ECOSYSTEM.a2ml b/a2ml/bindings/rust/.machine_readable/descriptiles/ECOSYSTEM.a2ml similarity index 100% rename from a2ml/bindings/rust/.machine_readable/6a2/ECOSYSTEM.a2ml rename to a2ml/bindings/rust/.machine_readable/descriptiles/ECOSYSTEM.a2ml diff --git a/a2ml/bindings/rust/.machine_readable/6a2/META.a2ml b/a2ml/bindings/rust/.machine_readable/descriptiles/META.a2ml similarity index 100% rename from a2ml/bindings/rust/.machine_readable/6a2/META.a2ml rename to a2ml/bindings/rust/.machine_readable/descriptiles/META.a2ml diff --git a/a2ml/bindings/rust/.machine_readable/6a2/NEUROSYM.a2ml b/a2ml/bindings/rust/.machine_readable/descriptiles/NEUROSYM.a2ml similarity index 100% rename from a2ml/bindings/rust/.machine_readable/6a2/NEUROSYM.a2ml rename to a2ml/bindings/rust/.machine_readable/descriptiles/NEUROSYM.a2ml diff --git a/a2ml/bindings/rust/.machine_readable/6a2/PLAYBOOK.a2ml b/a2ml/bindings/rust/.machine_readable/descriptiles/PLAYBOOK.a2ml similarity index 100% rename from a2ml/bindings/rust/.machine_readable/6a2/PLAYBOOK.a2ml rename to a2ml/bindings/rust/.machine_readable/descriptiles/PLAYBOOK.a2ml diff --git a/a2ml/bindings/rust/.machine_readable/6a2/STATE.a2ml b/a2ml/bindings/rust/.machine_readable/descriptiles/STATE.a2ml similarity index 100% rename from a2ml/bindings/rust/.machine_readable/6a2/STATE.a2ml rename to a2ml/bindings/rust/.machine_readable/descriptiles/STATE.a2ml diff --git a/a2ml/bindings/rust/tests/crg_c_tests.rs b/a2ml/bindings/rust/tests/crg_c_tests.rs index 2dee9469..1cda3c3d 100644 --- a/a2ml/bindings/rust/tests/crg_c_tests.rs +++ b/a2ml/bindings/rust/tests/crg_c_tests.rs @@ -614,7 +614,7 @@ fn e2e_dogfood_parse_machine_readable_state() { // Try to find any .a2ml file in .machine_readable/ let state_path = standards_root .join(".machine_readable") - .join("6a2") + .join("descriptiles") .join("STATE.a2ml"); if !state_path.exists() { diff --git a/a2ml/editors/vscode/.machine_readable/6a2/AGENTIC.a2ml b/a2ml/editors/vscode/.machine_readable/descriptiles/AGENTIC.a2ml similarity index 100% rename from a2ml/editors/vscode/.machine_readable/6a2/AGENTIC.a2ml rename to a2ml/editors/vscode/.machine_readable/descriptiles/AGENTIC.a2ml diff --git a/a2ml/editors/vscode/.machine_readable/6a2/ECOSYSTEM.a2ml b/a2ml/editors/vscode/.machine_readable/descriptiles/ECOSYSTEM.a2ml similarity index 100% rename from a2ml/editors/vscode/.machine_readable/6a2/ECOSYSTEM.a2ml rename to a2ml/editors/vscode/.machine_readable/descriptiles/ECOSYSTEM.a2ml diff --git a/a2ml/editors/vscode/.machine_readable/6a2/META.a2ml b/a2ml/editors/vscode/.machine_readable/descriptiles/META.a2ml similarity index 100% rename from a2ml/editors/vscode/.machine_readable/6a2/META.a2ml rename to a2ml/editors/vscode/.machine_readable/descriptiles/META.a2ml diff --git a/a2ml/editors/vscode/.machine_readable/6a2/NEUROSYM.a2ml b/a2ml/editors/vscode/.machine_readable/descriptiles/NEUROSYM.a2ml similarity index 100% rename from a2ml/editors/vscode/.machine_readable/6a2/NEUROSYM.a2ml rename to a2ml/editors/vscode/.machine_readable/descriptiles/NEUROSYM.a2ml diff --git a/a2ml/editors/vscode/.machine_readable/6a2/PLAYBOOK.a2ml b/a2ml/editors/vscode/.machine_readable/descriptiles/PLAYBOOK.a2ml similarity index 100% rename from a2ml/editors/vscode/.machine_readable/6a2/PLAYBOOK.a2ml rename to a2ml/editors/vscode/.machine_readable/descriptiles/PLAYBOOK.a2ml diff --git a/a2ml/editors/vscode/.machine_readable/6a2/STATE.a2ml b/a2ml/editors/vscode/.machine_readable/descriptiles/STATE.a2ml similarity index 100% rename from a2ml/editors/vscode/.machine_readable/6a2/STATE.a2ml rename to a2ml/editors/vscode/.machine_readable/descriptiles/STATE.a2ml diff --git a/a2ml/pandoc/.machine_readable/6a2/AGENTIC.a2ml b/a2ml/pandoc/.machine_readable/descriptiles/AGENTIC.a2ml similarity index 100% rename from a2ml/pandoc/.machine_readable/6a2/AGENTIC.a2ml rename to a2ml/pandoc/.machine_readable/descriptiles/AGENTIC.a2ml diff --git a/a2ml/pandoc/.machine_readable/6a2/ECOSYSTEM.a2ml b/a2ml/pandoc/.machine_readable/descriptiles/ECOSYSTEM.a2ml similarity index 100% rename from a2ml/pandoc/.machine_readable/6a2/ECOSYSTEM.a2ml rename to a2ml/pandoc/.machine_readable/descriptiles/ECOSYSTEM.a2ml diff --git a/a2ml/pandoc/.machine_readable/6a2/META.a2ml b/a2ml/pandoc/.machine_readable/descriptiles/META.a2ml similarity index 100% rename from a2ml/pandoc/.machine_readable/6a2/META.a2ml rename to a2ml/pandoc/.machine_readable/descriptiles/META.a2ml diff --git a/a2ml/pandoc/.machine_readable/6a2/NEUROSYM.a2ml b/a2ml/pandoc/.machine_readable/descriptiles/NEUROSYM.a2ml similarity index 100% rename from a2ml/pandoc/.machine_readable/6a2/NEUROSYM.a2ml rename to a2ml/pandoc/.machine_readable/descriptiles/NEUROSYM.a2ml diff --git a/a2ml/pandoc/.machine_readable/6a2/PLAYBOOK.a2ml b/a2ml/pandoc/.machine_readable/descriptiles/PLAYBOOK.a2ml similarity index 100% rename from a2ml/pandoc/.machine_readable/6a2/PLAYBOOK.a2ml rename to a2ml/pandoc/.machine_readable/descriptiles/PLAYBOOK.a2ml diff --git a/a2ml/pandoc/.machine_readable/6a2/STATE.a2ml b/a2ml/pandoc/.machine_readable/descriptiles/STATE.a2ml similarity index 100% rename from a2ml/pandoc/.machine_readable/6a2/STATE.a2ml rename to a2ml/pandoc/.machine_readable/descriptiles/STATE.a2ml diff --git a/a2ml/profiles/README.adoc b/a2ml/profiles/README.adoc index a12dd04e..0b713588 100644 --- a/a2ml/profiles/README.adoc +++ b/a2ml/profiles/README.adoc @@ -18,7 +18,7 @@ for the normative profile mechanism. definition by sha256. |=== -== The seven `a2ml/*` profiles (6a2 family) +== The seven `a2ml/*` profiles (descriptiles family) [cols="2,4",options="header"] |=== @@ -39,7 +39,7 @@ raise strictness only and grant no capability. == Declaring a profile in a document -A 6a2 document opts in with a single self-closing directive in its preamble: +A descriptiles document opts in with a single self-closing directive in its preamble: ---- @profile(id=a2ml/state) diff --git a/a2ml/profiles/a2ml-agentic/PROFILE.a2ml b/a2ml/profiles/a2ml-agentic/PROFILE.a2ml index 11aa4abe..42789349 100644 --- a/a2ml/profiles/a2ml-agentic/PROFILE.a2ml +++ b/a2ml/profiles/a2ml-agentic/PROFILE.a2ml @@ -3,7 +3,7 @@ SPDX-License-Identifier: MPL-2.0 # A2ML Profile: a2ml/agentic @abstract: -Validation profile for the 6a2 AGENTIC.a2ml metadata record (AI-agent +Validation profile for the descriptiles AGENTIC.a2ml metadata record (AI-agent interaction patterns, permissions, and constraints). Non-executable; five-axis-bounded per SPEC.adoc Section 8.2. @end diff --git a/a2ml/profiles/a2ml-anchor/PROFILE.a2ml b/a2ml/profiles/a2ml-anchor/PROFILE.a2ml index d2c922d1..508ab7a2 100644 --- a/a2ml/profiles/a2ml-anchor/PROFILE.a2ml +++ b/a2ml/profiles/a2ml-anchor/PROFILE.a2ml @@ -23,7 +23,7 @@ min_attestation: checked # Notes @rationale: -ANCHOR is the smallest, most load-bearing 6a2 record: it asserts a repo's +ANCHOR is the smallest, most load-bearing descriptiles record: it asserts a repo's canonical identity. Its dialect is key-based (top-level `key: value`), so here `required_sections` names the required top-level KEYS rather than [section] headers. All four — `id` (canonical authority id), `version`, `clade` diff --git a/a2ml/profiles/a2ml-ecosystem/PROFILE.a2ml b/a2ml/profiles/a2ml-ecosystem/PROFILE.a2ml index d9cc00ec..6ecb6496 100644 --- a/a2ml/profiles/a2ml-ecosystem/PROFILE.a2ml +++ b/a2ml/profiles/a2ml-ecosystem/PROFILE.a2ml @@ -3,7 +3,7 @@ SPDX-License-Identifier: MPL-2.0 # A2ML Profile: a2ml/ecosystem @abstract: -Validation profile for the 6a2 ECOSYSTEM.a2ml metadata record (position in +Validation profile for the descriptiles ECOSYSTEM.a2ml metadata record (position in the ecosystem and related projects). Non-executable; five-axis-bounded per SPEC.adoc Section 8.2. @end diff --git a/a2ml/profiles/a2ml-meta/PROFILE.a2ml b/a2ml/profiles/a2ml-meta/PROFILE.a2ml index d6d07c9a..44208cb3 100644 --- a/a2ml/profiles/a2ml-meta/PROFILE.a2ml +++ b/a2ml/profiles/a2ml-meta/PROFILE.a2ml @@ -3,7 +3,7 @@ SPDX-License-Identifier: MPL-2.0 # A2ML Profile: a2ml/meta @abstract: -Validation profile for the 6a2 META.a2ml metadata record (architecture +Validation profile for the descriptiles META.a2ml metadata record (architecture decisions and development practices). Non-executable: raises validation strictness only, within the five axes of SPEC.adoc Section 8.2. @end diff --git a/a2ml/profiles/a2ml-neurosym/PROFILE.a2ml b/a2ml/profiles/a2ml-neurosym/PROFILE.a2ml index 85dc2189..62dd6d3d 100644 --- a/a2ml/profiles/a2ml-neurosym/PROFILE.a2ml +++ b/a2ml/profiles/a2ml-neurosym/PROFILE.a2ml @@ -3,7 +3,7 @@ SPDX-License-Identifier: MPL-2.0 # A2ML Profile: a2ml/neurosym @abstract: -Validation profile for the 6a2 NEUROSYM.a2ml metadata record (neurosymbolic +Validation profile for the descriptiles NEUROSYM.a2ml metadata record (neurosymbolic integration / Hypatia scan configuration). Non-executable; five-axis-bounded per SPEC.adoc Section 8.2. @end diff --git a/a2ml/profiles/a2ml-playbook/PROFILE.a2ml b/a2ml/profiles/a2ml-playbook/PROFILE.a2ml index 982860eb..60af5ed2 100644 --- a/a2ml/profiles/a2ml-playbook/PROFILE.a2ml +++ b/a2ml/profiles/a2ml-playbook/PROFILE.a2ml @@ -3,7 +3,7 @@ SPDX-License-Identifier: MPL-2.0 # A2ML Profile: a2ml/playbook @abstract: -Validation profile for the 6a2 PLAYBOOK.a2ml metadata record (operational +Validation profile for the descriptiles PLAYBOOK.a2ml metadata record (operational runbook). Non-executable; five-axis-bounded per SPEC.adoc Section 8.2. @end diff --git a/a2ml/profiles/a2ml-state/PROFILE.a2ml b/a2ml/profiles/a2ml-state/PROFILE.a2ml index 5f7d69d7..02eff3ff 100644 --- a/a2ml/profiles/a2ml-state/PROFILE.a2ml +++ b/a2ml/profiles/a2ml-state/PROFILE.a2ml @@ -3,7 +3,7 @@ SPDX-License-Identifier: MPL-2.0 # A2ML Profile: a2ml/state @abstract: -Validation profile for the 6a2 STATE.a2ml metadata record (current project +Validation profile for the descriptiles STATE.a2ml metadata record (current project state and progress). Non-executable: this profile only raises validation strictness. It constrains exactly the five axes permitted by SPEC.adoc Section 8.2. diff --git a/a2ml/src/A2ML/Profiles.idr b/a2ml/src/A2ML/Profiles.idr index 8e542221..12c6fd44 100644 --- a/a2ml/src/A2ML/Profiles.idr +++ b/a2ml/src/A2ML/Profiles.idr @@ -203,7 +203,7 @@ checkProfile pd f = ||| Collect the TOP-LEVEL Section titles of a document. Total by construction: ||| it recurses only on the block-list tail and never descends through section ||| bodies, so it introduces no escape hatch (cf. TypedCore.collectIds, which is -||| `partial`). Flat record dialects — the entire 6a2 family — have only +||| `partial`). Flat record dialects — the entire descriptiles family — have only ||| top-level sections, so this is exact for them. Nested-section extraction for ||| general markup is the translator's responsibility: the translator supplies ||| `DocFacts` directly, so conformance never relies on this helper recursing. diff --git a/agentic-a2ml/.machine_readable/6a2/AGENTIC.a2ml b/agentic-a2ml/.machine_readable/descriptiles/AGENTIC.a2ml similarity index 100% rename from agentic-a2ml/.machine_readable/6a2/AGENTIC.a2ml rename to agentic-a2ml/.machine_readable/descriptiles/AGENTIC.a2ml diff --git a/agentic-a2ml/.machine_readable/6a2/ECOSYSTEM.a2ml b/agentic-a2ml/.machine_readable/descriptiles/ECOSYSTEM.a2ml similarity index 100% rename from agentic-a2ml/.machine_readable/6a2/ECOSYSTEM.a2ml rename to agentic-a2ml/.machine_readable/descriptiles/ECOSYSTEM.a2ml diff --git a/agentic-a2ml/.machine_readable/6a2/META.a2ml b/agentic-a2ml/.machine_readable/descriptiles/META.a2ml similarity index 100% rename from agentic-a2ml/.machine_readable/6a2/META.a2ml rename to agentic-a2ml/.machine_readable/descriptiles/META.a2ml diff --git a/agentic-a2ml/.machine_readable/6a2/NEUROSYM.a2ml b/agentic-a2ml/.machine_readable/descriptiles/NEUROSYM.a2ml similarity index 100% rename from agentic-a2ml/.machine_readable/6a2/NEUROSYM.a2ml rename to agentic-a2ml/.machine_readable/descriptiles/NEUROSYM.a2ml diff --git a/agentic-a2ml/.machine_readable/6a2/PLAYBOOK.a2ml b/agentic-a2ml/.machine_readable/descriptiles/PLAYBOOK.a2ml similarity index 100% rename from agentic-a2ml/.machine_readable/6a2/PLAYBOOK.a2ml rename to agentic-a2ml/.machine_readable/descriptiles/PLAYBOOK.a2ml diff --git a/agentic-a2ml/.machine_readable/6a2/STATE.a2ml b/agentic-a2ml/.machine_readable/descriptiles/STATE.a2ml similarity index 100% rename from agentic-a2ml/.machine_readable/6a2/STATE.a2ml rename to agentic-a2ml/.machine_readable/descriptiles/STATE.a2ml diff --git a/agentic-a2ml/docs/ADR-002-methodology-layer.adoc b/agentic-a2ml/docs/ADR-002-methodology-layer.adoc index b421989e..d6f5e2b0 100644 --- a/agentic-a2ml/docs/ADR-002-methodology-layer.adoc +++ b/agentic-a2ml/docs/ADR-002-methodology-layer.adoc @@ -90,7 +90,7 @@ debt-file = "MEANDER-DEBT.md" [source] ---- .machine_readable/ -├── 6a2/ # Existing: 6 A2ML checkpoint files +├── descriptiles/ # Existing: 6 A2ML checkpoint files ├── bot_directives/ # Existing: gitbot-fleet rules ├── agent_instructions/ # NEW: methodology-aware config │ ├── methodology.a2ml # Mode, invariants, constraints @@ -234,7 +234,7 @@ Agentic Server Architecture: │ 3. READ: agent_instructions/debt.a2ml │ │ → carried debt from last session │ ├─────────────────────────────────────────────────┤ - │ 4. READ: 6a2/STATE.a2ml │ + │ 4. READ: descriptiles/STATE.a2ml │ │ → P1 items, current phase, blockers │ │ ⚠ VALIDATE: not a template placeholder │ ├─────────────────────────────────────────────────┤ diff --git a/agentic-a2ml/examples/comprehensive.a2ml b/agentic-a2ml/examples/comprehensive.a2ml index a6b597ce..ff0a24df 100644 --- a/agentic-a2ml/examples/comprehensive.a2ml +++ b/agentic-a2ml/examples/comprehensive.a2ml @@ -23,7 +23,7 @@ can-create-files = true # - 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 place state files in repository root (must be in .machine_readable/descriptiles/) # - Never use AGPL license (use PMPL-1.0-or-later) # - Never push to mirrors directly (GitHub is the only push target) @@ -112,8 +112,8 @@ release-claim-requires-hard-pass = true # ============================================================== [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-enter: Read 0-AI-MANIFEST.a2ml, then .machine_readable/descriptiles/STATE.a2ml +# on-exit: Update .machine_readable/descriptiles/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 @@ -125,6 +125,6 @@ release-claim-requires-hard-pass = true [decision-recording] record-all-decisions = true format = "a2ml" -location = ".machine_readable/6a2/STATE.a2ml" +location = ".machine_readable/descriptiles/STATE.a2ml" include-rationale = true include-alternatives-considered = true diff --git a/ai-instruction/README.adoc b/ai-instruction/README.adoc index 189ade4d..245ba629 100644 --- a/ai-instruction/README.adoc +++ b/ai-instruction/README.adoc @@ -29,7 +29,7 @@ channel. delegation prompts |Markdown prose |*Repo-local machine-readable directives* |`+/.machine_readable/+` -(`+6a2/+`, `+contractiles/+`, `+anchors/+`, etc.) |`+gitbot-fleet+`, +(`+descriptiles/+`, `+contractiles/+`, `+anchors/+`, etc.) |`+gitbot-fleet+`, `+hypatia+`, `+coordination.k9+`, MCP guardian |A2ML |=== diff --git a/ai-instruction/opus.adoc b/ai-instruction/opus.adoc index 5cff502d..5b493c8d 100644 --- a/ai-instruction/opus.adoc +++ b/ai-instruction/opus.adoc @@ -33,7 +33,7 @@ semantics, dependent types, effect systems) tradeoffs (dependability > security > interop > usability > performance > versatility > functional extension) * Debugging where the bug crosses layers (ABI / FFI / runtime / prover) -* Novel infrastructure: innervation architecture (6a2 → coordination.k9 +* Novel infrastructure: innervation architecture (descriptiles → coordination.k9 + VeriSimDB + Hypatia), new contractile semantics, new claim-grounder design diff --git a/anchor-a2ml/.machine_readable/6a2/AGENTIC.a2ml b/anchor-a2ml/.machine_readable/descriptiles/AGENTIC.a2ml similarity index 100% rename from anchor-a2ml/.machine_readable/6a2/AGENTIC.a2ml rename to anchor-a2ml/.machine_readable/descriptiles/AGENTIC.a2ml diff --git a/anchor-a2ml/.machine_readable/6a2/ECOSYSTEM.a2ml b/anchor-a2ml/.machine_readable/descriptiles/ECOSYSTEM.a2ml similarity index 100% rename from anchor-a2ml/.machine_readable/6a2/ECOSYSTEM.a2ml rename to anchor-a2ml/.machine_readable/descriptiles/ECOSYSTEM.a2ml diff --git a/anchor-a2ml/.machine_readable/6a2/META.a2ml b/anchor-a2ml/.machine_readable/descriptiles/META.a2ml similarity index 100% rename from anchor-a2ml/.machine_readable/6a2/META.a2ml rename to anchor-a2ml/.machine_readable/descriptiles/META.a2ml diff --git a/anchor-a2ml/.machine_readable/6a2/NEUROSYM.a2ml b/anchor-a2ml/.machine_readable/descriptiles/NEUROSYM.a2ml similarity index 100% rename from anchor-a2ml/.machine_readable/6a2/NEUROSYM.a2ml rename to anchor-a2ml/.machine_readable/descriptiles/NEUROSYM.a2ml diff --git a/anchor-a2ml/.machine_readable/6a2/PLAYBOOK.a2ml b/anchor-a2ml/.machine_readable/descriptiles/PLAYBOOK.a2ml similarity index 100% rename from anchor-a2ml/.machine_readable/6a2/PLAYBOOK.a2ml rename to anchor-a2ml/.machine_readable/descriptiles/PLAYBOOK.a2ml diff --git a/anchor-a2ml/.machine_readable/6a2/STATE.a2ml b/anchor-a2ml/.machine_readable/descriptiles/STATE.a2ml similarity index 100% rename from anchor-a2ml/.machine_readable/6a2/STATE.a2ml rename to anchor-a2ml/.machine_readable/descriptiles/STATE.a2ml diff --git a/axel-protocol/.machine_readable/6a2/ECOSYSTEM.a2ml b/axel-protocol/.machine_readable/descriptiles/ECOSYSTEM.a2ml similarity index 100% rename from axel-protocol/.machine_readable/6a2/ECOSYSTEM.a2ml rename to axel-protocol/.machine_readable/descriptiles/ECOSYSTEM.a2ml diff --git a/axel-protocol/.machine_readable/6a2/META.a2ml b/axel-protocol/.machine_readable/descriptiles/META.a2ml similarity index 100% rename from axel-protocol/.machine_readable/6a2/META.a2ml rename to axel-protocol/.machine_readable/descriptiles/META.a2ml diff --git a/axel-protocol/.machine_readable/6a2/STATE.a2ml b/axel-protocol/.machine_readable/descriptiles/STATE.a2ml similarity index 100% rename from axel-protocol/.machine_readable/6a2/STATE.a2ml rename to axel-protocol/.machine_readable/descriptiles/STATE.a2ml diff --git a/docs/INNERVATION.adoc b/docs/INNERVATION.adoc index aa1c0ed9..4bee7f6c 100644 --- a/docs/INNERVATION.adoc +++ b/docs/INNERVATION.adoc @@ -142,5 +142,5 @@ is migrated. - `coordination.k9` — nerve receptor for this repo - `ROADMAP.adoc` — phases A–D of the innervation build-out -- `TOPOLOGY.md` — architecture diagram +- `TOPOLOGY.adoc` — architecture diagram - `component-readiness-grades/SELF-ASSESSMENT.adoc` — why this repo is B diff --git a/docs/SEAMS-SPEC.adoc b/docs/SEAMS-SPEC.adoc index 23162e5f..2e0e4f0f 100644 --- a/docs/SEAMS-SPEC.adoc +++ b/docs/SEAMS-SPEC.adoc @@ -445,7 +445,7 @@ Until `contractile trust verify` is implemented, seam-check enforcement is the responsibility of the per-repository Mustfile `seam-check` target and manual PR review discipline. -Additionally, `6a2/META.a2ml` audit-focus entries may reference +Additionally, `descriptiles/META.a2ml` audit-focus entries may reference "seams/compromises/exception register" as an audit target — this specification is the normative definition of what that means. diff --git a/docs/decisions/ADR-005-extract-consent-aware-web.adoc b/docs/decisions/ADR-005-extract-consent-aware-web.adoc index f4716de0..9ebeb959 100644 --- a/docs/decisions/ADR-005-extract-consent-aware-web.adoc +++ b/docs/decisions/ADR-005-extract-consent-aware-web.adoc @@ -44,7 +44,7 @@ repository and retire the phantom submodule declaration. The registry entry moves from the in-tree spec table to the *external* spec table in `scripts/build-registry.sh`, so this repository holds a verified pointer rather than a copy — the pattern already used for the AffineScript -specs. `REGISTRY.a2ml` and `TOPOLOGY.md` regenerate from that table and were not +specs. `REGISTRY.a2ml` and `TOPOLOGY.adoc` regenerate from that table and were not hand-edited. === Why `consent-aware-web` and not `consent-aware-http` diff --git a/docs/reorg/STREAM-PROMPTS.adoc b/docs/reorg/STREAM-PROMPTS.adoc index 649799fe..2dec96e5 100644 --- a/docs/reorg/STREAM-PROMPTS.adoc +++ b/docs/reorg/STREAM-PROMPTS.adoc @@ -31,12 +31,12 @@ the verifiable registry that Streams 2 and 3 build on. live with the consumer, never in A2ML core. * *Owner decisions captured 2026-06-03:* A2ML v1.1 ships profile mechanism + base record vocabulary + citation primitives (obligation/`contractual` -> v1.2); - profiles declared in-document via `@profile(id)`; the 6a2 family is re-expressed + profiles declared in-document via `@profile(id)`; the descriptiles family is re-expressed as A2ML profiles; K9-SVC finishes alpha -> 1.0.0 stable with capabilities, enforceable leash, pedigree restructure, and A2ML-canonical + JSON-projection evidence receipts. -== Stream 1 — A2ML + K9-SVC foundation (+ 6a2) +== Stream 1 — A2ML + K9-SVC foundation (+ descriptiles) [source,text] ---- @@ -55,7 +55,7 @@ DECISIONS ALREADY MADE (do not relitigate): - A2ML v1.1 ships: (a) the profile mechanism, (b) a shared BASE RECORD VOCABULARY, (c) CodeCite-style citation primitives. Obligation/`contractual` primitives are v1.2. Profiles are declared in-document via an `@profile(id)` directive. -- 6a2 family becomes A2ML profiles: a2ml/state, a2ml/meta, a2ml/ecosystem, +- descriptiles family becomes A2ML profiles: a2ml/state, a2ml/meta, a2ml/ecosystem, a2ml/agentic, a2ml/neurosym, a2ml/playbook, a2ml/anchor — all validated by the one profile mechanism. - K9-SVC finishes alpha -> 1.0.0 STABLE: capability model (default-deny), @@ -82,10 +82,10 @@ A2ML (a2ml/): 5. Opaque-payload crypto: define hashing now (canonical hash form), signing later. 6. Add Idris2 typed-core nodes + decidable checks for profiles and new directives. -6a2 (.machine_readable/): +descriptiles (.machine_readable/): 7. Author the seven profile definitions (a2ml/state ... a2ml/anchor). -8. Add @profile directives to the existing 6a2 files so they validate through the - mechanism. Add a hypatia rule that flags a 6a2 file whose content drifts from its +8. Add @profile directives to the existing descriptiles files so they validate through the + mechanism. Add a hypatia rule that flags a descriptiles file whose content drifts from its declared profile. K9-SVC (k9-svc/): @@ -178,14 +178,14 @@ CONTEXT — confirmed drift to fix (file:line evidence exists): - LICENSE is MPL-2.0 (owner directive 2026-06-02) but README.adoc badge + line 28 + 418, PALIMPSEST.adoc, and both llm-warmup-*.md still say PMPL-1.0. - EXPLAINME.adoc:33 still lists ReScript as a "Primary" language (banned 2026-04-30). -- TOPOLOGY.md + ROADMAP.adoc frozen at 2026-04-04; TOPOLOGY shows integration layer +- TOPOLOGY.adoc + ROADMAP.adoc frozen at 2026-04-04; TOPOLOGY shows integration layer at 0% while claiming 80% overall. - EXPLAINME Evidence table lists groove-protocol/ and palimpsest-license/ as local dirs; neither exists here. - llm-warmup-dev.md and llm-warmup-user.md are byte-identical. - QUICKSTART-*.adoc still contain unfilled {{PLACEHOLDER}} markers. - REORGANIZATION-PLAN.md describes redundancies that no longer match reality. -- Competing entry docs: README.adoc, EXPLAINME.adoc, TOPOLOGY.md, 0-AI-MANIFEST.a2ml, +- Competing entry docs: README.adoc, EXPLAINME.adoc, TOPOLOGY.adoc, 0-AI-MANIFEST.a2ml, QUICKSTART-{DEV,USER,MAINTAINER}.adoc, llm-warmup-*.md, ai-instruction/. CRITICAL GUARDRAIL: per .claude/CLAUDE.md, licence changes are MANUAL, OWNER-ONLY, @@ -207,7 +207,7 @@ TASKS: finding instead of something noticed 60 days later. 4. Fix the confirmed drift (doc badges via owner-reviewed change; ReScript->current policy; dead links -> registry pointers; fill or delete QUICKSTART placeholders). -5. Make TOPOLOGY.md DERIVED/auto-refreshed (from STATE.a2ml / registry) rather than a +5. Make TOPOLOGY.adoc DERIVED/auto-refreshed (from STATE.a2ml / registry) rather than a hand-maintained file that freezes. 6. Supersede or retire REORGANIZATION-PLAN.md. diff --git a/docs/wikis/README.adoc b/docs/wikis/README.adoc index ad6d47e7..dff9e1e1 100644 --- a/docs/wikis/README.adoc +++ b/docs/wikis/README.adoc @@ -63,5 +63,5 @@ The wiki does not replace the canonical front doors — it *teaches* them: * [ ] Flesh out each track's "core concepts" prose beyond the link lists. * [ ] Decide forge-wiki vs in-repo-only hosting. -* [ ] Add a "glossary" page (A2ML, K9, RSR, CRG, contractile, innervation, 6a2). +* [ ] Add a "glossary" page (A2ML, K9, RSR, CRG, contractile, innervation, descriptiles). * [ ] Add worked examples per track (adopt a repo / write a rule / cut a change). diff --git a/docs/wikis/maintainers/index.adoc b/docs/wikis/maintainers/index.adoc index 8e8b0fdf..29220f28 100644 --- a/docs/wikis/maintainers/index.adoc +++ b/docs/wikis/maintainers/index.adoc @@ -23,7 +23,7 @@ NOTE: Scaffold. The link spine is complete; the connective prose is `TODO`. === Generated files are never hand-edited -* `.machine_readable/REGISTRY.a2ml` and `TOPOLOGY.md` are *generated* by +* `.machine_readable/REGISTRY.a2ml` and `TOPOLOGY.adoc` are *generated* by `scripts/build-registry.sh` (`just registry`); edit the `SPECS` table in the generator, then regenerate. CI `registry-verify.yml` fails on drift. * TODO: "add a new spec home end-to-end". @@ -33,7 +33,7 @@ NOTE: Scaffold. The link spine is complete; the connective prose is `TODO`. === 1. The registry + topology pipeline * `scripts/build-registry.sh`, `just registry` / `just registry-check`, - `REGISTRY.adoc`, `TOPOLOGY.md` (derived). + `REGISTRY.adoc`, `TOPOLOGY.adoc` (derived). === 2. Drift / staleness automation @@ -53,9 +53,9 @@ NOTE: Scaffold. The link spine is complete; the connective prose is `TODO`. (DEPENDABOT, TRUSTED-BASE, REMOTE-URL, CODEOWNERS, TOOLING-VERSION-INTEGRITY). * TODO: "when to write an ADR vs a policy". -=== 5. The innervation / contractile stack (6a2) +=== 5. The innervation / contractile stack (descriptiles) -* `.machine_readable/6a2/` (STATE/META/…), `contractiles/`, `contractile.just`, +* `.machine_readable/descriptiles/` (STATE/META/…), `contractiles/`, `contractile.just`, `coordination.k9`, `.verisimdb/`, and Hypatia as the estate-side analyser. * TODO: "how a contractile is registered and fires"; whether estate scripts (e.g. the staleness/propagation pair) should be registered as contractiles. diff --git a/docs/wikis/users/index.adoc b/docs/wikis/users/index.adoc index 8ab7d0f4..8978f4c1 100644 --- a/docs/wikis/users/index.adoc +++ b/docs/wikis/users/index.adoc @@ -20,7 +20,7 @@ NOTE: Scaffold. The link spine is complete; the connective prose is `TODO`. * `EXPLAINME.adoc` — the architecture-decisions narrative. * TODO: one-paragraph "standards in plain language" for newcomers. -=== 2. The machine-readable artefacts (6a2) +=== 2. The machine-readable artefacts (descriptiles) Every Hyperpolymath repo carries six A2ML files (`STATE`, `META`, `ECOSYSTEM`, `AGENTIC`, `NEUROSYM`, `PLAYBOOK`) plus `ANCHOR`. diff --git a/ecosystem-a2ml/.machine_readable/6a2/AGENTIC.a2ml b/ecosystem-a2ml/.machine_readable/descriptiles/AGENTIC.a2ml similarity index 100% rename from ecosystem-a2ml/.machine_readable/6a2/AGENTIC.a2ml rename to ecosystem-a2ml/.machine_readable/descriptiles/AGENTIC.a2ml diff --git a/ecosystem-a2ml/.machine_readable/6a2/ECOSYSTEM.a2ml b/ecosystem-a2ml/.machine_readable/descriptiles/ECOSYSTEM.a2ml similarity index 100% rename from ecosystem-a2ml/.machine_readable/6a2/ECOSYSTEM.a2ml rename to ecosystem-a2ml/.machine_readable/descriptiles/ECOSYSTEM.a2ml diff --git a/ecosystem-a2ml/.machine_readable/6a2/META.a2ml b/ecosystem-a2ml/.machine_readable/descriptiles/META.a2ml similarity index 100% rename from ecosystem-a2ml/.machine_readable/6a2/META.a2ml rename to ecosystem-a2ml/.machine_readable/descriptiles/META.a2ml diff --git a/ecosystem-a2ml/.machine_readable/6a2/NEUROSYM.a2ml b/ecosystem-a2ml/.machine_readable/descriptiles/NEUROSYM.a2ml similarity index 100% rename from ecosystem-a2ml/.machine_readable/6a2/NEUROSYM.a2ml rename to ecosystem-a2ml/.machine_readable/descriptiles/NEUROSYM.a2ml diff --git a/ecosystem-a2ml/.machine_readable/6a2/PLAYBOOK.a2ml b/ecosystem-a2ml/.machine_readable/descriptiles/PLAYBOOK.a2ml similarity index 100% rename from ecosystem-a2ml/.machine_readable/6a2/PLAYBOOK.a2ml rename to ecosystem-a2ml/.machine_readable/descriptiles/PLAYBOOK.a2ml diff --git a/ecosystem-a2ml/.machine_readable/6a2/STATE.a2ml b/ecosystem-a2ml/.machine_readable/descriptiles/STATE.a2ml similarity index 100% rename from ecosystem-a2ml/.machine_readable/6a2/STATE.a2ml rename to ecosystem-a2ml/.machine_readable/descriptiles/STATE.a2ml diff --git a/hooks/pre-commit b/hooks/pre-commit index 7a40ff90..3b03c87a 100755 --- a/hooks/pre-commit +++ b/hooks/pre-commit @@ -82,11 +82,11 @@ done # regenerate.) Catch it locally, before the commit, instead of in CI. if [ -f scripts/build-registry.sh ]; then if ! bash scripts/build-registry.sh --check >/dev/null 2>&1; then - echo -e "${RED}✗ REGISTRY.a2ml / TOPOLOGY.md are stale — regenerate before committing.${NC}" + echo -e "${RED}✗ REGISTRY.a2ml / TOPOLOGY.adoc are stale — regenerate before committing.${NC}" echo " A tracked file under a spec home (or STATE.a2ml) changed without" echo " regenerating the derived registry/topology." echo " Fix: bash scripts/build-registry.sh" - echo " git add .machine_readable/REGISTRY.a2ml TOPOLOGY.md" + echo " git add .machine_readable/REGISTRY.a2ml TOPOLOGY.adoc" ERRORS=$((ERRORS + 1)) fi fi diff --git a/hypatia-rules/README.adoc b/hypatia-rules/README.adoc index ad3682f4..9983f609 100644 --- a/hypatia-rules/README.adoc +++ b/hypatia-rules/README.adoc @@ -16,8 +16,8 @@ tree, and emits Groove `compliance.finding.new` signals. | HYP-S003 | `proof-freshness` | Alert when a proof hasn't been re-verified in > 30 days | | HYP-S004 | `rsr-self-compliance` | Validate standards repo against its own RSR definition | | HYP-S005 | `crg-overclaim-detector` | Alert when a self-declared CRG grade lacks v2.0 evidence artefacts | -| HYP-S006 | `registry-staleness` | Alert when REGISTRY.a2ml source hashes go stale or a DERIVED doc (TOPOLOGY.md) drifts | -| HYP-S007 | `profile-drift-detector` | Flag a 6a2 file whose content drifts from its declared A2ML `@profile` | +| HYP-S006 | `registry-staleness` | Alert when REGISTRY.a2ml source hashes go stale or a DERIVED doc (TOPOLOGY.adoc) drifts | +| HYP-S007 | `profile-drift-detector` | Flag a descriptiles file whose content drifts from its declared A2ML `@profile` | | HYP-S008 | `workflow-allowlist-gap` | Flag a workflow `uses:` an action/reusable not permitted by the repo Actions allowlist (would `startup_failure`) | | HYP-S009 | `implementation-inside-canon` | Flag product/build manifests below a local (non-external) canonical spec home | @@ -29,13 +29,13 @@ evidence artefacts required by CRG v2.0 (STRICT). S006 closes the documentation-drift loop: it recomputes each spec's `source_hash` from the file tree (the same way `scripts/build-registry.sh` does) and emits a `doc.drift` signal when the recorded hash is stale or a -generated file (TOPOLOGY.md) was hand-edited. Its `@router` block defaults +generated file (TOPOLOGY.adoc) was hand-edited. Its `@router` block defaults to `auto_execute` (regenerate), but **caps any licence/SPDX-overlapping drift to `:review`** — honouring the Manual-Only licence guardrail in `.claude/CLAUDE.md`. This is the estate-side mirror of the in-repo `registry-verify.yml` workflow. -HYP-S007 closes the dogfooding loop for the A2ML profile mechanism: every 6a2 +HYP-S007 closes the dogfooding loop for the A2ML profile mechanism: every descriptiles file declares an `@profile(id=…)` (a2ml/SPEC.adoc Section 8), and this rule flags any file that no longer satisfies its declared profile definition in `a2ml/profiles/`. It is FLAG-ONLY (`strategy: review`, `auto_fixable: false`) @@ -83,7 +83,7 @@ Rules read from: - VeriSimDB `proof-status` octads (HYP-S003) - `rhodium-standard-repositories/RSR.adoc` (HYP-S004) - `rsr-template-repo/docs/governance/CRG-AUDIT-TEMPLATE.adoc` (HYP-S005 reference) -- `a2ml/profiles/REGISTRY.a2ml` + `a2ml/profiles/*/PROFILE.a2ml` and the 6a2 +- `a2ml/profiles/REGISTRY.a2ml` + `a2ml/profiles/*/PROFILE.a2ml` and the descriptiles files under `.machine_readable/` (HYP-S007) - `.github/workflows/*` and `rhodium-standard-repositories/actions-allowlist/allowed-actions.json` (HYP-S008) - `.machine_readable/REGISTRY.a2ml` LOCAL homes and their product/build manifests (HYP-S009) diff --git a/hypatia-rules/crg-overclaim-detector.a2ml b/hypatia-rules/crg-overclaim-detector.a2ml index ff35873a..803e5d0b 100644 --- a/hypatia-rules/crg-overclaim-detector.a2ml +++ b/hypatia-rules/crg-overclaim-detector.a2ml @@ -22,7 +22,7 @@ source: standards/hypatia-rules # Ingest the declared grade from every repo with machine-readable state. find: - glob: "**/.machine_readable/STATE.a2ml" - - glob: "**/.machine_readable/6a2/STATE.a2ml" + - glob: "**/.machine_readable/descriptiles/STATE.a2ml" - glob: "**/.machine_readable/**/STATE.scm" @end @@ -50,7 +50,7 @@ steps: D: requires: # RSR D-floor (mandatory for D and above) - - file: ".machine_readable/6a2/STATE.a2ml" + - file: ".machine_readable/descriptiles/STATE.a2ml" or_file: ".machine_readable/STATE.a2ml" reason: "RSR R-040 (A2ML metadata)" - file: "README.adoc" @@ -69,7 +69,7 @@ D: reason: "CI evidence of D" evidence_of: - "test matrix documented in STATE.a2ml ([test-matrix] or total-tests)" - - "scope documented in STATE.a2ml, ROADMAP.adoc or TOPOLOGY.md" + - "scope documented in STATE.a2ml, ROADMAP.adoc or TOPOLOGY.adoc" C: requires_all_of: "D" @@ -83,7 +83,7 @@ C: - file: "docs/EXPLAINME.adoc" reason: "RSR C annotation floor" - state_key: "dogfooding-status" - in_file: ".machine_readable/6a2/STATE.a2ml" + in_file: ".machine_readable/descriptiles/STATE.a2ml" reason: "C requires documented dogfooding evidence" evidence_of: - "CI green in last 7 days (workflow run log)" @@ -95,12 +95,12 @@ B: requires_all_of: "C" requires: - state_key: "external-targets" - in_file: ".machine_readable/6a2/STATE.a2ml" + in_file: ".machine_readable/descriptiles/STATE.a2ml" reason: "B requires 6+ diverse external targets tested (canonical key)" fallback_key: "grade-b-status" fallback_caveat: "legacy key; entries are often internal capabilities and must be re-classified" - state_key: "issues-fed-back" - in_file: ".machine_readable/6a2/STATE.a2ml" + in_file: ".machine_readable/descriptiles/STATE.a2ml" reason: "B requires an issues-fed-back pipeline (canonical key)" evidence_of: - "6+ diverse external-target entries, each with identity + date + outcome" @@ -114,7 +114,7 @@ A: requires_all_of: "B" requires: - state_key: "field-signal" - in_file: ".machine_readable/6a2/STATE.a2ml" + in_file: ".machine_readable/descriptiles/STATE.a2ml" reason: "A requires real-world external feedback confirming value (canonical key)" evidence_of: - "multi-source external usage confirmation (testimonials, third-party writeups, papers citing)" diff --git a/hypatia-rules/profile-drift-detector.a2ml b/hypatia-rules/profile-drift-detector.a2ml index f5b4b07b..4a5d043d 100644 --- a/hypatia-rules/profile-drift-detector.a2ml +++ b/hypatia-rules/profile-drift-detector.a2ml @@ -1,13 +1,13 @@ # SPDX-License-Identifier: MPL-2.0 # HYP-S007 — A2ML Profile Drift Detector -# Flags a 6a2 file whose content has drifted from the A2ML profile it +# Flags a descriptiles file whose content has drifted from the A2ML profile it # declares via @profile(id=...). "Drift" = the file no longer satisfies its # declared profile definition (missing required section, disallowed directive, # cardinality/reference-class violation, or attestation floor not met). # # This rule operates on the A2ML profile mechanism specified in # a2ml/SPEC.adoc Section 8 and the profile definitions in a2ml/profiles/. -# It is the dogfooding check that keeps the 6a2 estate honest about the +# It is the dogfooding check that keeps the descriptiles estate honest about the # profiles it claims to satisfy. # # FLAG-ONLY by construction: strategy :review, auto_fixable: false. This rule @@ -17,7 +17,7 @@ @rule(version="1.0"): id: HYP-S007 name: "A2ML profile drift detector" -description: "Flag a 6a2 file whose content drifts from its declared @profile" +description: "Flag a descriptiles file whose content drifts from its declared @profile" severity: medium category: Dogfooding strategy: review @@ -27,15 +27,15 @@ source: standards/hypatia-rules @scanner(type="file-tree"): find: - - glob: "**/.machine_readable/6a2/*.a2ml" + - glob: "**/.machine_readable/descriptiles/*.a2ml" - glob: "**/.machine_readable/anchors/ANCHOR.a2ml" - glob: "a2ml/profiles/*/PROFILE.a2ml" - glob: "a2ml/profiles/REGISTRY.a2ml" @end @logic(engine="built-in"): -# 1. For each 6a2 file, read the @profile(id=ns/name) declaration in its -# preamble. A 6a2 file with no @profile declaration is itself a finding +# 1. For each descriptiles file, read the @profile(id=ns/name) declaration in its +# preamble. A descriptiles file with no @profile declaration is itself a finding # (undeclared: cannot be validated through the mechanism). # 2. Resolve ns/name against a2ml/profiles/REGISTRY.a2ml; confirm the # definition's sha256 equals the registry-pinned hash. A hash mismatch is a diff --git a/hypatia-rules/registry-staleness.a2ml b/hypatia-rules/registry-staleness.a2ml index db381f12..8804ef3c 100644 --- a/hypatia-rules/registry-staleness.a2ml +++ b/hypatia-rules/registry-staleness.a2ml @@ -1,7 +1,7 @@ # SPDX-License-Identifier: MPL-2.0 # HYP-S006 — Registry Staleness / Doc Drift # Detects when the verifiable spec registry (.machine_readable/REGISTRY.a2ml) -# no longer matches ground truth, or when DERIVED docs (TOPOLOGY.md) were +# no longer matches ground truth, or when DERIVED docs (TOPOLOGY.adoc) were # hand-edited away from their generated form. Drift becomes a routed finding # the moment it lands — not something noticed 60 days later. # @@ -20,7 +20,7 @@ @rule(version="1.0"): id: HYP-S006 name: "Registry staleness / doc drift" -description: "Alert when a spec's recorded source_hash in REGISTRY.a2ml no longer matches a fresh compute (local) or a fresh fetch of canonical_url (external pointer), or a DERIVED doc (TOPOLOGY.md) drifted from its generator" +description: "Alert when a spec's recorded source_hash in REGISTRY.a2ml no longer matches a fresh compute (local) or a fresh fetch of canonical_url (external pointer), or a DERIVED doc (TOPOLOGY.adoc) drifted from its generator" severity: medium category: StandardsCompliance auto_fixable: true @@ -35,7 +35,7 @@ critical_after_days: 60 @scanner(type="file-tree"): find: - glob: ".machine_readable/REGISTRY.a2ml" - - glob: "TOPOLOGY.md" + - glob: "TOPOLOGY.adoc" - glob: "scripts/build-registry.sh" @end @@ -109,7 +109,7 @@ steps: # license_finding_strategy/0. The router MUST honour the cap below. # --------------------------------------------------------------------------- @router: -default_strategy: auto_execute # regenerate REGISTRY.a2ml + TOPOLOGY.md +default_strategy: auto_execute # regenerate REGISTRY.a2ml + TOPOLOGY.adoc recipe: rebuild-registry # Hard cap: any finding whose drift overlaps a licence/SPDX token is demoted # to :review and never auto-applied, mirroring license_finding_strategy/0. diff --git a/k9-coordination-protocol/tools/k9-init/Cargo.toml b/k9-coordination-protocol/tools/k9-init/Cargo.toml index bb4d7e47..ae76978c 100644 --- a/k9-coordination-protocol/tools/k9-init/Cargo.toml +++ b/k9-coordination-protocol/tools/k9-init/Cargo.toml @@ -3,7 +3,7 @@ name = "k9-init" version = "0.1.0" edition = "2021" -description = "Initialise coordination.k9 from 6a2 A2ML files (one-shot migration)" +description = "Initialise coordination.k9 from descriptile A2ML files (one-shot migration)" license = "PMPL-1.0-or-later" authors = ["Jonathan D.A. Jewell "] repository = "https://github.com/hyperpolymath/standards" diff --git a/k9-coordination-protocol/tools/k9-init/batch-init.sh b/k9-coordination-protocol/tools/k9-init/batch-init.sh index c3fba61c..71c66f33 100755 --- a/k9-coordination-protocol/tools/k9-init/batch-init.sh +++ b/k9-coordination-protocol/tools/k9-init/batch-init.sh @@ -23,7 +23,7 @@ K9_INIT="$(dirname "$0")/target/release/k9-init" echo "Scanning $ROOT for repos..." migrated=0 skipped=0 -no_6a2=0 +no_descriptiles=0 for repo in "$ROOT"/*/; do [ -d "$repo" ] || continue @@ -35,8 +35,8 @@ for repo in "$ROOT"/*/; do skipped=$((skipped + 1)) continue fi - if [ ! -d "$repo/.machine_readable/6a2" ]; then - no_6a2=$((no_6a2 + 1)) + if [ ! -d "$repo/.machine_readable/descriptiles" ]; then + no_descriptiles=$((no_descriptiles + 1)) continue fi if [ $DRY_RUN -eq 1 ]; then @@ -52,5 +52,5 @@ echo "" echo "Summary:" echo " migrated: $migrated" echo " already had: $skipped" -echo " no 6a2 dir: $no_6a2" +echo " no descriptile dir: $no_descriptiles" [ $DRY_RUN -eq 1 ] && echo "(dry-run — no files written)" diff --git a/k9-coordination-protocol/tools/k9-init/src/main.rs b/k9-coordination-protocol/tools/k9-init/src/main.rs index c91a4137..36929570 100644 --- a/k9-coordination-protocol/tools/k9-init/src/main.rs +++ b/k9-coordination-protocol/tools/k9-init/src/main.rs @@ -1,9 +1,9 @@ // SPDX-License-Identifier: MPL-2.0 // Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) // -// k9-init — scaffold a coordination.k9 from a repo's existing 6a2 A2ML files. +// k9-init — scaffold a coordination.k9 from a repo's existing descriptile files. // -// Reads .machine_readable/6a2/{AGENTIC,META,NEUROSYM}.a2ml, extracts +// Reads .machine_readable/descriptiles/{AGENTIC,META,NEUROSYM}.a2ml, extracts // language/banned/practice information, and emits a starter coordination.k9 // that the human then refines. This is a one-shot migration tool — it does // not try to be a general A2ML parser. @@ -50,7 +50,7 @@ fn main() -> ExitCode { let facts = gather_facts(&repo_root); if !facts.has_agentic && !facts.has_meta && !facts.has_neurosym { eprintln!( - "k9-init: no 6a2 A2ML files found under {}/.machine_readable/6a2/", + "k9-init: no descriptile A2ML files found under {}/.machine_readable/descriptiles/", repo_root.display() ); eprintln!(" emitting a stub template only"); @@ -101,7 +101,7 @@ fn parse_args(args: &[String]) -> Result<(PathBuf, Option, bool), Strin } fn gather_facts(repo_root: &Path) -> RepoFacts { - let a2ml_dir = repo_root.join(".machine_readable").join("6a2"); + let a2ml_dir = repo_root.join(".machine_readable").join("descriptiles"); let agentic = a2ml_dir.join("AGENTIC.a2ml"); let meta = a2ml_dir.join("META.a2ml"); let neurosym = a2ml_dir.join("NEUROSYM.a2ml"); @@ -269,7 +269,7 @@ fn render_k9(f: &RepoFacts) -> String { "# coordination.k9 — AI Coordination Protocol for {}\n", f.repo_name )); - s.push_str("# Generated by k9-init from 6a2 A2ML files. REVIEW BEFORE USE.\n\n"); + s.push_str("# Generated by k9-init from descriptile A2ML files. REVIEW BEFORE USE.\n\n"); s.push_str("---\n"); s.push_str("metadata:\n"); s.push_str(&format!(" schema: k9-coordination\n")); @@ -299,7 +299,7 @@ fn render_k9(f: &RepoFacts) -> String { " rule: \"No files in banned languages: {}\"\n", f.banned.join(", ") )); - s.push_str(" reason: \"Repo inherited language policy from 6a2 AGENTIC.a2ml\"\n"); + s.push_str(" reason: \"Repo inherited language policy from descriptile AGENTIC.a2ml\"\n"); s.push_str(" severity: high\n"); } for (k, v) in &f.practices { diff --git a/k9-svc/.machine_readable/6a2/AGENTIC.a2ml b/k9-svc/.machine_readable/descriptiles/AGENTIC.a2ml similarity index 100% rename from k9-svc/.machine_readable/6a2/AGENTIC.a2ml rename to k9-svc/.machine_readable/descriptiles/AGENTIC.a2ml diff --git a/k9-svc/.machine_readable/6a2/ECOSYSTEM.a2ml b/k9-svc/.machine_readable/descriptiles/ECOSYSTEM.a2ml similarity index 100% rename from k9-svc/.machine_readable/6a2/ECOSYSTEM.a2ml rename to k9-svc/.machine_readable/descriptiles/ECOSYSTEM.a2ml diff --git a/k9-svc/.machine_readable/6a2/META.a2ml b/k9-svc/.machine_readable/descriptiles/META.a2ml similarity index 100% rename from k9-svc/.machine_readable/6a2/META.a2ml rename to k9-svc/.machine_readable/descriptiles/META.a2ml diff --git a/k9-svc/.machine_readable/6a2/NEUROSYM.a2ml b/k9-svc/.machine_readable/descriptiles/NEUROSYM.a2ml similarity index 100% rename from k9-svc/.machine_readable/6a2/NEUROSYM.a2ml rename to k9-svc/.machine_readable/descriptiles/NEUROSYM.a2ml diff --git a/k9-svc/.machine_readable/6a2/PLAYBOOK.a2ml b/k9-svc/.machine_readable/descriptiles/PLAYBOOK.a2ml similarity index 100% rename from k9-svc/.machine_readable/6a2/PLAYBOOK.a2ml rename to k9-svc/.machine_readable/descriptiles/PLAYBOOK.a2ml diff --git a/k9-svc/.machine_readable/6a2/STATE.a2ml b/k9-svc/.machine_readable/descriptiles/STATE.a2ml similarity index 100% rename from k9-svc/.machine_readable/6a2/STATE.a2ml rename to k9-svc/.machine_readable/descriptiles/STATE.a2ml diff --git a/k9-svc/actions/validate/.machine_readable/6a2/AGENTIC.a2ml b/k9-svc/actions/validate/.machine_readable/descriptiles/AGENTIC.a2ml similarity index 100% rename from k9-svc/actions/validate/.machine_readable/6a2/AGENTIC.a2ml rename to k9-svc/actions/validate/.machine_readable/descriptiles/AGENTIC.a2ml diff --git a/k9-svc/actions/validate/.machine_readable/6a2/ECOSYSTEM.a2ml b/k9-svc/actions/validate/.machine_readable/descriptiles/ECOSYSTEM.a2ml similarity index 100% rename from k9-svc/actions/validate/.machine_readable/6a2/ECOSYSTEM.a2ml rename to k9-svc/actions/validate/.machine_readable/descriptiles/ECOSYSTEM.a2ml diff --git a/k9-svc/actions/validate/.machine_readable/6a2/META.a2ml b/k9-svc/actions/validate/.machine_readable/descriptiles/META.a2ml similarity index 100% rename from k9-svc/actions/validate/.machine_readable/6a2/META.a2ml rename to k9-svc/actions/validate/.machine_readable/descriptiles/META.a2ml diff --git a/k9-svc/actions/validate/.machine_readable/6a2/NEUROSYM.a2ml b/k9-svc/actions/validate/.machine_readable/descriptiles/NEUROSYM.a2ml similarity index 100% rename from k9-svc/actions/validate/.machine_readable/6a2/NEUROSYM.a2ml rename to k9-svc/actions/validate/.machine_readable/descriptiles/NEUROSYM.a2ml diff --git a/k9-svc/actions/validate/.machine_readable/6a2/PLAYBOOK.a2ml b/k9-svc/actions/validate/.machine_readable/descriptiles/PLAYBOOK.a2ml similarity index 100% rename from k9-svc/actions/validate/.machine_readable/6a2/PLAYBOOK.a2ml rename to k9-svc/actions/validate/.machine_readable/descriptiles/PLAYBOOK.a2ml diff --git a/k9-svc/actions/validate/.machine_readable/6a2/STATE.a2ml b/k9-svc/actions/validate/.machine_readable/descriptiles/STATE.a2ml similarity index 100% rename from k9-svc/actions/validate/.machine_readable/6a2/STATE.a2ml rename to k9-svc/actions/validate/.machine_readable/descriptiles/STATE.a2ml diff --git a/k9-svc/bindings/deno/.machine_readable/6a2/AGENTIC.a2ml b/k9-svc/bindings/deno/.machine_readable/descriptiles/AGENTIC.a2ml similarity index 100% rename from k9-svc/bindings/deno/.machine_readable/6a2/AGENTIC.a2ml rename to k9-svc/bindings/deno/.machine_readable/descriptiles/AGENTIC.a2ml diff --git a/k9-svc/bindings/deno/.machine_readable/6a2/ECOSYSTEM.a2ml b/k9-svc/bindings/deno/.machine_readable/descriptiles/ECOSYSTEM.a2ml similarity index 100% rename from k9-svc/bindings/deno/.machine_readable/6a2/ECOSYSTEM.a2ml rename to k9-svc/bindings/deno/.machine_readable/descriptiles/ECOSYSTEM.a2ml diff --git a/k9-svc/bindings/deno/.machine_readable/6a2/META.a2ml b/k9-svc/bindings/deno/.machine_readable/descriptiles/META.a2ml similarity index 100% rename from k9-svc/bindings/deno/.machine_readable/6a2/META.a2ml rename to k9-svc/bindings/deno/.machine_readable/descriptiles/META.a2ml diff --git a/k9-svc/bindings/deno/.machine_readable/6a2/NEUROSYM.a2ml b/k9-svc/bindings/deno/.machine_readable/descriptiles/NEUROSYM.a2ml similarity index 100% rename from k9-svc/bindings/deno/.machine_readable/6a2/NEUROSYM.a2ml rename to k9-svc/bindings/deno/.machine_readable/descriptiles/NEUROSYM.a2ml diff --git a/k9-svc/bindings/deno/.machine_readable/6a2/PLAYBOOK.a2ml b/k9-svc/bindings/deno/.machine_readable/descriptiles/PLAYBOOK.a2ml similarity index 100% rename from k9-svc/bindings/deno/.machine_readable/6a2/PLAYBOOK.a2ml rename to k9-svc/bindings/deno/.machine_readable/descriptiles/PLAYBOOK.a2ml diff --git a/k9-svc/bindings/deno/.machine_readable/6a2/STATE.a2ml b/k9-svc/bindings/deno/.machine_readable/descriptiles/STATE.a2ml similarity index 100% rename from k9-svc/bindings/deno/.machine_readable/6a2/STATE.a2ml rename to k9-svc/bindings/deno/.machine_readable/descriptiles/STATE.a2ml diff --git a/k9-svc/bindings/haskell/.machine_readable/6a2/AGENTIC.a2ml b/k9-svc/bindings/haskell/.machine_readable/descriptiles/AGENTIC.a2ml similarity index 100% rename from k9-svc/bindings/haskell/.machine_readable/6a2/AGENTIC.a2ml rename to k9-svc/bindings/haskell/.machine_readable/descriptiles/AGENTIC.a2ml diff --git a/k9-svc/bindings/haskell/.machine_readable/6a2/ECOSYSTEM.a2ml b/k9-svc/bindings/haskell/.machine_readable/descriptiles/ECOSYSTEM.a2ml similarity index 100% rename from k9-svc/bindings/haskell/.machine_readable/6a2/ECOSYSTEM.a2ml rename to k9-svc/bindings/haskell/.machine_readable/descriptiles/ECOSYSTEM.a2ml diff --git a/k9-svc/bindings/haskell/.machine_readable/6a2/META.a2ml b/k9-svc/bindings/haskell/.machine_readable/descriptiles/META.a2ml similarity index 100% rename from k9-svc/bindings/haskell/.machine_readable/6a2/META.a2ml rename to k9-svc/bindings/haskell/.machine_readable/descriptiles/META.a2ml diff --git a/k9-svc/bindings/haskell/.machine_readable/6a2/NEUROSYM.a2ml b/k9-svc/bindings/haskell/.machine_readable/descriptiles/NEUROSYM.a2ml similarity index 100% rename from k9-svc/bindings/haskell/.machine_readable/6a2/NEUROSYM.a2ml rename to k9-svc/bindings/haskell/.machine_readable/descriptiles/NEUROSYM.a2ml diff --git a/k9-svc/bindings/haskell/.machine_readable/6a2/PLAYBOOK.a2ml b/k9-svc/bindings/haskell/.machine_readable/descriptiles/PLAYBOOK.a2ml similarity index 100% rename from k9-svc/bindings/haskell/.machine_readable/6a2/PLAYBOOK.a2ml rename to k9-svc/bindings/haskell/.machine_readable/descriptiles/PLAYBOOK.a2ml diff --git a/k9-svc/bindings/haskell/.machine_readable/6a2/STATE.a2ml b/k9-svc/bindings/haskell/.machine_readable/descriptiles/STATE.a2ml similarity index 100% rename from k9-svc/bindings/haskell/.machine_readable/6a2/STATE.a2ml rename to k9-svc/bindings/haskell/.machine_readable/descriptiles/STATE.a2ml diff --git a/k9-svc/bindings/rust/.machine_readable/6a2/AGENTIC.a2ml b/k9-svc/bindings/rust/.machine_readable/descriptiles/AGENTIC.a2ml similarity index 100% rename from k9-svc/bindings/rust/.machine_readable/6a2/AGENTIC.a2ml rename to k9-svc/bindings/rust/.machine_readable/descriptiles/AGENTIC.a2ml diff --git a/k9-svc/bindings/rust/.machine_readable/6a2/ECOSYSTEM.a2ml b/k9-svc/bindings/rust/.machine_readable/descriptiles/ECOSYSTEM.a2ml similarity index 100% rename from k9-svc/bindings/rust/.machine_readable/6a2/ECOSYSTEM.a2ml rename to k9-svc/bindings/rust/.machine_readable/descriptiles/ECOSYSTEM.a2ml diff --git a/k9-svc/bindings/rust/.machine_readable/6a2/META.a2ml b/k9-svc/bindings/rust/.machine_readable/descriptiles/META.a2ml similarity index 100% rename from k9-svc/bindings/rust/.machine_readable/6a2/META.a2ml rename to k9-svc/bindings/rust/.machine_readable/descriptiles/META.a2ml diff --git a/k9-svc/bindings/rust/.machine_readable/6a2/NEUROSYM.a2ml b/k9-svc/bindings/rust/.machine_readable/descriptiles/NEUROSYM.a2ml similarity index 100% rename from k9-svc/bindings/rust/.machine_readable/6a2/NEUROSYM.a2ml rename to k9-svc/bindings/rust/.machine_readable/descriptiles/NEUROSYM.a2ml diff --git a/k9-svc/bindings/rust/.machine_readable/6a2/PLAYBOOK.a2ml b/k9-svc/bindings/rust/.machine_readable/descriptiles/PLAYBOOK.a2ml similarity index 100% rename from k9-svc/bindings/rust/.machine_readable/6a2/PLAYBOOK.a2ml rename to k9-svc/bindings/rust/.machine_readable/descriptiles/PLAYBOOK.a2ml diff --git a/k9-svc/bindings/rust/.machine_readable/6a2/STATE.a2ml b/k9-svc/bindings/rust/.machine_readable/descriptiles/STATE.a2ml similarity index 100% rename from k9-svc/bindings/rust/.machine_readable/6a2/STATE.a2ml rename to k9-svc/bindings/rust/.machine_readable/descriptiles/STATE.a2ml diff --git a/k9-svc/editors/vscode/.machine_readable/6a2/AGENTIC.a2ml b/k9-svc/editors/vscode/.machine_readable/descriptiles/AGENTIC.a2ml similarity index 100% rename from k9-svc/editors/vscode/.machine_readable/6a2/AGENTIC.a2ml rename to k9-svc/editors/vscode/.machine_readable/descriptiles/AGENTIC.a2ml diff --git a/k9-svc/editors/vscode/.machine_readable/6a2/ECOSYSTEM.a2ml b/k9-svc/editors/vscode/.machine_readable/descriptiles/ECOSYSTEM.a2ml similarity index 100% rename from k9-svc/editors/vscode/.machine_readable/6a2/ECOSYSTEM.a2ml rename to k9-svc/editors/vscode/.machine_readable/descriptiles/ECOSYSTEM.a2ml diff --git a/k9-svc/editors/vscode/.machine_readable/6a2/META.a2ml b/k9-svc/editors/vscode/.machine_readable/descriptiles/META.a2ml similarity index 100% rename from k9-svc/editors/vscode/.machine_readable/6a2/META.a2ml rename to k9-svc/editors/vscode/.machine_readable/descriptiles/META.a2ml diff --git a/k9-svc/editors/vscode/.machine_readable/6a2/NEUROSYM.a2ml b/k9-svc/editors/vscode/.machine_readable/descriptiles/NEUROSYM.a2ml similarity index 100% rename from k9-svc/editors/vscode/.machine_readable/6a2/NEUROSYM.a2ml rename to k9-svc/editors/vscode/.machine_readable/descriptiles/NEUROSYM.a2ml diff --git a/k9-svc/editors/vscode/.machine_readable/6a2/PLAYBOOK.a2ml b/k9-svc/editors/vscode/.machine_readable/descriptiles/PLAYBOOK.a2ml similarity index 100% rename from k9-svc/editors/vscode/.machine_readable/6a2/PLAYBOOK.a2ml rename to k9-svc/editors/vscode/.machine_readable/descriptiles/PLAYBOOK.a2ml diff --git a/k9-svc/editors/vscode/.machine_readable/6a2/STATE.a2ml b/k9-svc/editors/vscode/.machine_readable/descriptiles/STATE.a2ml similarity index 100% rename from k9-svc/editors/vscode/.machine_readable/6a2/STATE.a2ml rename to k9-svc/editors/vscode/.machine_readable/descriptiles/STATE.a2ml diff --git a/k9-svc/pandoc/.machine_readable/6a2/AGENTIC.a2ml b/k9-svc/pandoc/.machine_readable/descriptiles/AGENTIC.a2ml similarity index 100% rename from k9-svc/pandoc/.machine_readable/6a2/AGENTIC.a2ml rename to k9-svc/pandoc/.machine_readable/descriptiles/AGENTIC.a2ml diff --git a/k9-svc/pandoc/.machine_readable/6a2/ECOSYSTEM.a2ml b/k9-svc/pandoc/.machine_readable/descriptiles/ECOSYSTEM.a2ml similarity index 100% rename from k9-svc/pandoc/.machine_readable/6a2/ECOSYSTEM.a2ml rename to k9-svc/pandoc/.machine_readable/descriptiles/ECOSYSTEM.a2ml diff --git a/k9-svc/pandoc/.machine_readable/6a2/META.a2ml b/k9-svc/pandoc/.machine_readable/descriptiles/META.a2ml similarity index 100% rename from k9-svc/pandoc/.machine_readable/6a2/META.a2ml rename to k9-svc/pandoc/.machine_readable/descriptiles/META.a2ml diff --git a/k9-svc/pandoc/.machine_readable/6a2/NEUROSYM.a2ml b/k9-svc/pandoc/.machine_readable/descriptiles/NEUROSYM.a2ml similarity index 100% rename from k9-svc/pandoc/.machine_readable/6a2/NEUROSYM.a2ml rename to k9-svc/pandoc/.machine_readable/descriptiles/NEUROSYM.a2ml diff --git a/k9-svc/pandoc/.machine_readable/6a2/PLAYBOOK.a2ml b/k9-svc/pandoc/.machine_readable/descriptiles/PLAYBOOK.a2ml similarity index 100% rename from k9-svc/pandoc/.machine_readable/6a2/PLAYBOOK.a2ml rename to k9-svc/pandoc/.machine_readable/descriptiles/PLAYBOOK.a2ml diff --git a/k9-svc/pandoc/.machine_readable/6a2/STATE.a2ml b/k9-svc/pandoc/.machine_readable/descriptiles/STATE.a2ml similarity index 100% rename from k9-svc/pandoc/.machine_readable/6a2/STATE.a2ml rename to k9-svc/pandoc/.machine_readable/descriptiles/STATE.a2ml diff --git a/llm-warmup-dev.adoc b/llm-warmup-dev.adoc index 7cd57199..f064346b 100644 --- a/llm-warmup-dev.adoc +++ b/llm-warmup-dev.adoc @@ -12,11 +12,11 @@ ____ source_hash). * *Add/move a spec:* edit the `+SPECS+` table in `+scripts/build-registry.sh+`, then `+just registry+` (regenerates -`+REGISTRY.a2ml+` + `+TOPOLOGY.md+`). CI rejects a spec change that +`+REGISTRY.a2ml+` + `+TOPOLOGY.adoc+`). CI rejects a spec change that forgets to regenerate (`+registry-verify.yml+`). * *Language + licence policy (binding):* `+.claude/CLAUDE.md+`. Licence/SPDX is *Manual-Only* — flag drift, never edit it. -* *State you must keep current:* `+.machine_readable/6a2/STATE.a2ml+`. +* *State you must keep current:* `+.machine_readable/descriptiles/STATE.a2ml+`. === Key commands @@ -30,5 +30,5 @@ suites * Licence: see `+LICENSE+` (Manual-Only for agents). * Part of the Hyperpolymath ecosystem. -* Architecture map (derived): `+TOPOLOGY.md+`. Drift automation: +* Architecture map (derived): `+TOPOLOGY.adoc+`. Drift automation: `+REGISTRY.adoc+`. diff --git a/lol/.machine_readable/6a2/AGENTIC.a2ml b/lol/.machine_readable/descriptiles/AGENTIC.a2ml similarity index 100% rename from lol/.machine_readable/6a2/AGENTIC.a2ml rename to lol/.machine_readable/descriptiles/AGENTIC.a2ml diff --git a/lol/.machine_readable/6a2/ECOSYSTEM.a2ml b/lol/.machine_readable/descriptiles/ECOSYSTEM.a2ml similarity index 100% rename from lol/.machine_readable/6a2/ECOSYSTEM.a2ml rename to lol/.machine_readable/descriptiles/ECOSYSTEM.a2ml diff --git a/lol/.machine_readable/6a2/META.a2ml b/lol/.machine_readable/descriptiles/META.a2ml similarity index 100% rename from lol/.machine_readable/6a2/META.a2ml rename to lol/.machine_readable/descriptiles/META.a2ml diff --git a/lol/.machine_readable/6a2/NEUROSYM.a2ml b/lol/.machine_readable/descriptiles/NEUROSYM.a2ml similarity index 100% rename from lol/.machine_readable/6a2/NEUROSYM.a2ml rename to lol/.machine_readable/descriptiles/NEUROSYM.a2ml diff --git a/lol/.machine_readable/6a2/PLAYBOOK.a2ml b/lol/.machine_readable/descriptiles/PLAYBOOK.a2ml similarity index 100% rename from lol/.machine_readable/6a2/PLAYBOOK.a2ml rename to lol/.machine_readable/descriptiles/PLAYBOOK.a2ml diff --git a/lol/.machine_readable/6a2/STATE.a2ml b/lol/.machine_readable/descriptiles/STATE.a2ml similarity index 100% rename from lol/.machine_readable/6a2/STATE.a2ml rename to lol/.machine_readable/descriptiles/STATE.a2ml diff --git a/meta-a2ml/.claude/CLAUDE.md b/meta-a2ml/.claude/CLAUDE.md index 73337ebd..f2c3b97a 100644 --- a/meta-a2ml/.claude/CLAUDE.md +++ b/meta-a2ml/.claude/CLAUDE.md @@ -1,14 +1,14 @@ ## Machine-Readable Artefacts -The following files in `.machine_readable/6a2/` contain structured project metadata +The following files in `.machine_readable/descriptiles/` 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 +- `.machine_readable/descriptiles/STATE.a2ml` - Current project state and progress +- `.machine_readable/descriptiles/META.a2ml` - Architecture decisions and development practices +- `.machine_readable/descriptiles/ECOSYSTEM.a2ml` - Position in the ecosystem and related projects +- `.machine_readable/descriptiles/AGENTIC.a2ml` - AI agent interaction patterns +- `.machine_readable/descriptiles/NEUROSYM.a2ml` - Neurosymbolic integration config +- `.machine_readable/descriptiles/PLAYBOOK.a2ml` - Operational runbook --- diff --git a/meta-a2ml/.machine_readable/6a2/AGENTIC.a2ml b/meta-a2ml/.machine_readable/descriptiles/AGENTIC.a2ml similarity index 100% rename from meta-a2ml/.machine_readable/6a2/AGENTIC.a2ml rename to meta-a2ml/.machine_readable/descriptiles/AGENTIC.a2ml diff --git a/meta-a2ml/.machine_readable/6a2/ECOSYSTEM.a2ml b/meta-a2ml/.machine_readable/descriptiles/ECOSYSTEM.a2ml similarity index 100% rename from meta-a2ml/.machine_readable/6a2/ECOSYSTEM.a2ml rename to meta-a2ml/.machine_readable/descriptiles/ECOSYSTEM.a2ml diff --git a/meta-a2ml/.machine_readable/6a2/META.a2ml b/meta-a2ml/.machine_readable/descriptiles/META.a2ml similarity index 100% rename from meta-a2ml/.machine_readable/6a2/META.a2ml rename to meta-a2ml/.machine_readable/descriptiles/META.a2ml diff --git a/meta-a2ml/.machine_readable/6a2/NEUROSYM.a2ml b/meta-a2ml/.machine_readable/descriptiles/NEUROSYM.a2ml similarity index 100% rename from meta-a2ml/.machine_readable/6a2/NEUROSYM.a2ml rename to meta-a2ml/.machine_readable/descriptiles/NEUROSYM.a2ml diff --git a/meta-a2ml/.machine_readable/6a2/PLAYBOOK.a2ml b/meta-a2ml/.machine_readable/descriptiles/PLAYBOOK.a2ml similarity index 100% rename from meta-a2ml/.machine_readable/6a2/PLAYBOOK.a2ml rename to meta-a2ml/.machine_readable/descriptiles/PLAYBOOK.a2ml diff --git a/meta-a2ml/.machine_readable/6a2/STATE.a2ml b/meta-a2ml/.machine_readable/descriptiles/STATE.a2ml similarity index 100% rename from meta-a2ml/.machine_readable/6a2/STATE.a2ml rename to meta-a2ml/.machine_readable/descriptiles/STATE.a2ml diff --git a/neurosym-a2ml/.machine_readable/6a2/AGENTIC.a2ml b/neurosym-a2ml/.machine_readable/descriptiles/AGENTIC.a2ml similarity index 100% rename from neurosym-a2ml/.machine_readable/6a2/AGENTIC.a2ml rename to neurosym-a2ml/.machine_readable/descriptiles/AGENTIC.a2ml diff --git a/neurosym-a2ml/.machine_readable/6a2/ECOSYSTEM.a2ml b/neurosym-a2ml/.machine_readable/descriptiles/ECOSYSTEM.a2ml similarity index 100% rename from neurosym-a2ml/.machine_readable/6a2/ECOSYSTEM.a2ml rename to neurosym-a2ml/.machine_readable/descriptiles/ECOSYSTEM.a2ml diff --git a/neurosym-a2ml/.machine_readable/6a2/META.a2ml b/neurosym-a2ml/.machine_readable/descriptiles/META.a2ml similarity index 100% rename from neurosym-a2ml/.machine_readable/6a2/META.a2ml rename to neurosym-a2ml/.machine_readable/descriptiles/META.a2ml diff --git a/neurosym-a2ml/.machine_readable/6a2/NEUROSYM.a2ml b/neurosym-a2ml/.machine_readable/descriptiles/NEUROSYM.a2ml similarity index 100% rename from neurosym-a2ml/.machine_readable/6a2/NEUROSYM.a2ml rename to neurosym-a2ml/.machine_readable/descriptiles/NEUROSYM.a2ml diff --git a/neurosym-a2ml/.machine_readable/6a2/PLAYBOOK.a2ml b/neurosym-a2ml/.machine_readable/descriptiles/PLAYBOOK.a2ml similarity index 100% rename from neurosym-a2ml/.machine_readable/6a2/PLAYBOOK.a2ml rename to neurosym-a2ml/.machine_readable/descriptiles/PLAYBOOK.a2ml diff --git a/neurosym-a2ml/.machine_readable/6a2/STATE.a2ml b/neurosym-a2ml/.machine_readable/descriptiles/STATE.a2ml similarity index 100% rename from neurosym-a2ml/.machine_readable/6a2/STATE.a2ml rename to neurosym-a2ml/.machine_readable/descriptiles/STATE.a2ml diff --git a/outreach/.machine_readable/6a2/AGENTIC.a2ml b/outreach/.machine_readable/descriptiles/AGENTIC.a2ml similarity index 100% rename from outreach/.machine_readable/6a2/AGENTIC.a2ml rename to outreach/.machine_readable/descriptiles/AGENTIC.a2ml diff --git a/outreach/.machine_readable/6a2/ECOSYSTEM.a2ml b/outreach/.machine_readable/descriptiles/ECOSYSTEM.a2ml similarity index 100% rename from outreach/.machine_readable/6a2/ECOSYSTEM.a2ml rename to outreach/.machine_readable/descriptiles/ECOSYSTEM.a2ml diff --git a/outreach/.machine_readable/6a2/META.a2ml b/outreach/.machine_readable/descriptiles/META.a2ml similarity index 100% rename from outreach/.machine_readable/6a2/META.a2ml rename to outreach/.machine_readable/descriptiles/META.a2ml diff --git a/outreach/.machine_readable/6a2/NEUROSYM.a2ml b/outreach/.machine_readable/descriptiles/NEUROSYM.a2ml similarity index 100% rename from outreach/.machine_readable/6a2/NEUROSYM.a2ml rename to outreach/.machine_readable/descriptiles/NEUROSYM.a2ml diff --git a/outreach/.machine_readable/6a2/PLAYBOOK.a2ml b/outreach/.machine_readable/descriptiles/PLAYBOOK.a2ml similarity index 100% rename from outreach/.machine_readable/6a2/PLAYBOOK.a2ml rename to outreach/.machine_readable/descriptiles/PLAYBOOK.a2ml diff --git a/outreach/.machine_readable/6a2/STATE.a2ml b/outreach/.machine_readable/descriptiles/STATE.a2ml similarity index 100% rename from outreach/.machine_readable/6a2/STATE.a2ml rename to outreach/.machine_readable/descriptiles/STATE.a2ml diff --git a/overlay-protocol/.machine_readable/6a2/ECOSYSTEM.a2ml b/overlay-protocol/.machine_readable/descriptiles/ECOSYSTEM.a2ml similarity index 100% rename from overlay-protocol/.machine_readable/6a2/ECOSYSTEM.a2ml rename to overlay-protocol/.machine_readable/descriptiles/ECOSYSTEM.a2ml diff --git a/overlay-protocol/.machine_readable/6a2/META.a2ml b/overlay-protocol/.machine_readable/descriptiles/META.a2ml similarity index 100% rename from overlay-protocol/.machine_readable/6a2/META.a2ml rename to overlay-protocol/.machine_readable/descriptiles/META.a2ml diff --git a/overlay-protocol/.machine_readable/6a2/STATE.a2ml b/overlay-protocol/.machine_readable/descriptiles/STATE.a2ml similarity index 100% rename from overlay-protocol/.machine_readable/6a2/STATE.a2ml rename to overlay-protocol/.machine_readable/descriptiles/STATE.a2ml diff --git a/playbook-a2ml/.machine_readable/6a2/AGENTIC.a2ml b/playbook-a2ml/.machine_readable/descriptiles/AGENTIC.a2ml similarity index 100% rename from playbook-a2ml/.machine_readable/6a2/AGENTIC.a2ml rename to playbook-a2ml/.machine_readable/descriptiles/AGENTIC.a2ml diff --git a/playbook-a2ml/.machine_readable/6a2/ECOSYSTEM.a2ml b/playbook-a2ml/.machine_readable/descriptiles/ECOSYSTEM.a2ml similarity index 100% rename from playbook-a2ml/.machine_readable/6a2/ECOSYSTEM.a2ml rename to playbook-a2ml/.machine_readable/descriptiles/ECOSYSTEM.a2ml diff --git a/playbook-a2ml/.machine_readable/6a2/META.a2ml b/playbook-a2ml/.machine_readable/descriptiles/META.a2ml similarity index 100% rename from playbook-a2ml/.machine_readable/6a2/META.a2ml rename to playbook-a2ml/.machine_readable/descriptiles/META.a2ml diff --git a/playbook-a2ml/.machine_readable/6a2/NEUROSYM.a2ml b/playbook-a2ml/.machine_readable/descriptiles/NEUROSYM.a2ml similarity index 100% rename from playbook-a2ml/.machine_readable/6a2/NEUROSYM.a2ml rename to playbook-a2ml/.machine_readable/descriptiles/NEUROSYM.a2ml diff --git a/playbook-a2ml/.machine_readable/6a2/PLAYBOOK.a2ml b/playbook-a2ml/.machine_readable/descriptiles/PLAYBOOK.a2ml similarity index 100% rename from playbook-a2ml/.machine_readable/6a2/PLAYBOOK.a2ml rename to playbook-a2ml/.machine_readable/descriptiles/PLAYBOOK.a2ml diff --git a/playbook-a2ml/.machine_readable/6a2/STATE.a2ml b/playbook-a2ml/.machine_readable/descriptiles/STATE.a2ml similarity index 100% rename from playbook-a2ml/.machine_readable/6a2/STATE.a2ml rename to playbook-a2ml/.machine_readable/descriptiles/STATE.a2ml diff --git a/playbook-a2ml/examples/comprehensive.a2ml b/playbook-a2ml/examples/comprehensive.a2ml index a275fd15..f42510a5 100644 --- a/playbook-a2ml/examples/comprehensive.a2ml +++ b/playbook-a2ml/examples/comprehensive.a2ml @@ -107,7 +107,7 @@ can-fail = false [release-process] steps = [ - "Update version in .machine_readable/6a2/STATE.a2ml, META.a2ml, justfile", + "Update version in .machine_readable/descriptiles/STATE.a2ml, META.a2ml, justfile", "Run `just release-preflight` (validate + quality + security + maint-hard-pass)", "Tag and push: `git tag vX.Y.Z && git push origin main --tags`", "Run `just container-push` to publish container image", @@ -125,7 +125,7 @@ P3 = "Minor / cosmetic — respond within 1 week" [incident-response.initial-triage] steps = [ - "Check .machine_readable/6a2/STATE.a2ml for current project status", + "Check .machine_readable/descriptiles/STATE.a2ml for current project status", "Review recent commits and CI results on GitHub", "Run `just validate` to check RSR compliance", "Run `just security` to audit for vulnerabilities", diff --git a/release-pre-flight/v1-audit.sh b/release-pre-flight/v1-audit.sh index 6cac595c..44817edf 100755 --- a/release-pre-flight/v1-audit.sh +++ b/release-pre-flight/v1-audit.sh @@ -353,7 +353,7 @@ check_stable_claims() { check_state_release_stage() { log_section "Release Stage Metadata" local state_paths=( - "$TARGET/.machine_readable/6a2/STATE.a2ml" + "$TARGET/.machine_readable/descriptiles/STATE.a2ml" "$TARGET/.machine_readable/STATE.a2ml" "$TARGET/STATE.a2ml" ) diff --git a/rhodium-standard-repositories/.machine_readable/6a2/AGENTIC.a2ml b/rhodium-standard-repositories/.machine_readable/descriptiles/AGENTIC.a2ml similarity index 100% rename from rhodium-standard-repositories/.machine_readable/6a2/AGENTIC.a2ml rename to rhodium-standard-repositories/.machine_readable/descriptiles/AGENTIC.a2ml diff --git a/rhodium-standard-repositories/.machine_readable/6a2/ECOSYSTEM.a2ml b/rhodium-standard-repositories/.machine_readable/descriptiles/ECOSYSTEM.a2ml similarity index 100% rename from rhodium-standard-repositories/.machine_readable/6a2/ECOSYSTEM.a2ml rename to rhodium-standard-repositories/.machine_readable/descriptiles/ECOSYSTEM.a2ml diff --git a/rhodium-standard-repositories/.machine_readable/6a2/META.a2ml b/rhodium-standard-repositories/.machine_readable/descriptiles/META.a2ml similarity index 100% rename from rhodium-standard-repositories/.machine_readable/6a2/META.a2ml rename to rhodium-standard-repositories/.machine_readable/descriptiles/META.a2ml diff --git a/rhodium-standard-repositories/.machine_readable/6a2/NEUROSYM.a2ml b/rhodium-standard-repositories/.machine_readable/descriptiles/NEUROSYM.a2ml similarity index 100% rename from rhodium-standard-repositories/.machine_readable/6a2/NEUROSYM.a2ml rename to rhodium-standard-repositories/.machine_readable/descriptiles/NEUROSYM.a2ml diff --git a/rhodium-standard-repositories/.machine_readable/6a2/PLAYBOOK.a2ml b/rhodium-standard-repositories/.machine_readable/descriptiles/PLAYBOOK.a2ml similarity index 100% rename from rhodium-standard-repositories/.machine_readable/6a2/PLAYBOOK.a2ml rename to rhodium-standard-repositories/.machine_readable/descriptiles/PLAYBOOK.a2ml diff --git a/rhodium-standard-repositories/.machine_readable/6a2/STATE.a2ml b/rhodium-standard-repositories/.machine_readable/descriptiles/STATE.a2ml similarity index 100% rename from rhodium-standard-repositories/.machine_readable/6a2/STATE.a2ml rename to rhodium-standard-repositories/.machine_readable/descriptiles/STATE.a2ml diff --git a/rhodium-standard-repositories/README.adoc b/rhodium-standard-repositories/README.adoc index 0ac2b29f..33c9aa50 100644 --- a/rhodium-standard-repositories/README.adoc +++ b/rhodium-standard-repositories/README.adoc @@ -61,7 +61,7 @@ Rhodium is the *rarest and most precious* of all metals, chosen for specific sym === AI Context Files RSR repositories include machine-readable A2ML files for AI assistant context preservation, -located in `.machine_readable/6a2/`: +located in `.machine_readable/descriptiles/`: [cols="1,3",options="header"] @@ -69,34 +69,34 @@ located in `.machine_readable/6a2/`: | File | Purpose -| `.machine_readable/6a2/META.a2ml` +| `.machine_readable/descriptiles/META.a2ml` | Architecture decisions (ADRs), development practices, design rationale -| `.machine_readable/6a2/ECOSYSTEM.a2ml` +| `.machine_readable/descriptiles/ECOSYSTEM.a2ml` | Project ecosystem position, relationships, explicit boundaries -| `.machine_readable/6a2/STATE.a2ml` +| `.machine_readable/descriptiles/STATE.a2ml` | Current project state, progress tracking, session continuity -| `.machine_readable/6a2/AGENTIC.a2ml` +| `.machine_readable/descriptiles/AGENTIC.a2ml` | AI agent constraints, gating policies, entropy budgets -| `.machine_readable/6a2/NEUROSYM.a2ml` +| `.machine_readable/descriptiles/NEUROSYM.a2ml` | Neurosymbolic integration config for Hypatia scanning -| `.machine_readable/6a2/PLAYBOOK.a2ml` +| `.machine_readable/descriptiles/PLAYBOOK.a2ml` | Operational runbooks, release and incident procedures |=== NOTE: The estate migrated from Guile Scheme (`.scm`) to A2ML (`.a2ml`) format on -2026-04-12. The canonical path is `.machine_readable/6a2/.a2ml`. Legacy `.scm` +2026-04-12. The canonical path is `.machine_readable/descriptiles/.a2ml`. Legacy `.scm` files are deprecated. See link:../state-a2ml/[state-a2ml] for the A2ML state spec. These files work alongside `.claude/CLAUDE.md` (or similar AI instruction files) to provide structured context that persists across AI conversation sessions. See link:docs/ai-context-files.md[AI Context Files Specification] for complete documentation and links to the specification repositories. diff --git a/rhodium-standard-repositories/spec/LANGUAGE-POLICY.adoc b/rhodium-standard-repositories/spec/LANGUAGE-POLICY.adoc index 1cf73ce8..02561686 100644 --- a/rhodium-standard-repositories/spec/LANGUAGE-POLICY.adoc +++ b/rhodium-standard-repositories/spec/LANGUAGE-POLICY.adoc @@ -100,7 +100,7 @@ NOTE: For full rationale and migration guides, see the link:{source-repo}[CCCP r | *A2ML* | State/meta checkpoint files -| `.machine_readable/6a2/STATE.a2ml`, `META.a2ml`, `ECOSYSTEM.a2ml`, `AGENTIC.a2ml`, +| `.machine_readable/descriptiles/STATE.a2ml`, `META.a2ml`, `ECOSYSTEM.a2ml`, `AGENTIC.a2ml`, `NEUROSYM.a2ml`, `PLAYBOOK.a2ml`. Migration from Guile Scheme completed 2026-04-12. | *Guile Scheme* diff --git a/rhodium-standard-repositories/spec/TIERS.adoc b/rhodium-standard-repositories/spec/TIERS.adoc index eeb890db..5f33268e 100644 --- a/rhodium-standard-repositories/spec/TIERS.adoc +++ b/rhodium-standard-repositories/spec/TIERS.adoc @@ -60,12 +60,12 @@ image:../badges/rsr-gold.svg[RSR Gold,64] *Full RSR compliance.* .Includes all Silver requirements, plus: -* [ ] `.machine_readable/6a2/STATE.a2ml` - Project state tracking -* [ ] `.machine_readable/6a2/META.a2ml` - Architecture decisions -* [ ] `.machine_readable/6a2/ECOSYSTEM.a2ml` - Project relationships -* [ ] `.machine_readable/6a2/AGENTIC.a2ml` - AI agent constraints -* [ ] `.machine_readable/6a2/NEUROSYM.a2ml` - Neurosymbolic integration config -* [ ] `.machine_readable/6a2/PLAYBOOK.a2ml` - Operational runbook +* [ ] `.machine_readable/descriptiles/STATE.a2ml` - Project state tracking +* [ ] `.machine_readable/descriptiles/META.a2ml` - Architecture decisions +* [ ] `.machine_readable/descriptiles/ECOSYSTEM.a2ml` - Project relationships +* [ ] `.machine_readable/descriptiles/AGENTIC.a2ml` - AI agent constraints +* [ ] `.machine_readable/descriptiles/NEUROSYM.a2ml` - Neurosymbolic integration config +* [ ] `.machine_readable/descriptiles/PLAYBOOK.a2ml` - Operational runbook * [ ] OpenSSF Scorecard >= 9.0 * [ ] All 11 compliance categories passing * [ ] .well-known/ai.txt, humans.txt, provenance.json diff --git a/rhodium-standard-repositories/spec/VERSION.adoc b/rhodium-standard-repositories/spec/VERSION.adoc index 707f739b..3aa7c4c2 100644 --- a/rhodium-standard-repositories/spec/VERSION.adoc +++ b/rhodium-standard-repositories/spec/VERSION.adoc @@ -106,7 +106,7 @@ The following components are locked in v1.0. Any changes require a new specifica | *OCaml* | Compilers, formal methods | *Ada* | Safety-critical systems (SPARK verification) | *Julia* | Data processing, batch scripts -| *A2ML* | State/meta files (.machine_readable/6a2/STATE.a2ml, META.a2ml, ECOSYSTEM.a2ml, etc.) +| *A2ML* | State/meta files (.machine_readable/descriptiles/STATE.a2ml, META.a2ml, ECOSYSTEM.a2ml, etc.) | *Guile Scheme* | Build tooling only (guix.scm, manifest.scm) — checkpoint files migrated to A2ML 2026-04-12 | *Nickel* | Configuration language | *Bash/POSIX* | Minimal scripting, automation @@ -147,12 +147,12 @@ The following components are locked in v1.0. Any changes require a new specifica | `FUNDING.yml` | Silver | Funding sources | `.gitignore` | Bronze | Ignored files | `.gitattributes` | Bronze | Git attributes -| `.machine_readable/6a2/STATE.a2ml` | Gold | Project state tracking -| `.machine_readable/6a2/META.a2ml` | Gold | Architecture decisions -| `.machine_readable/6a2/ECOSYSTEM.a2ml` | Gold | Project relationships -| `.machine_readable/6a2/AGENTIC.a2ml` | Gold | AI agent constraints -| `.machine_readable/6a2/NEUROSYM.a2ml` | Gold | Neurosymbolic integration config -| `.machine_readable/6a2/PLAYBOOK.a2ml` | Gold | Operational runbook +| `.machine_readable/descriptiles/STATE.a2ml` | Gold | Project state tracking +| `.machine_readable/descriptiles/META.a2ml` | Gold | Architecture decisions +| `.machine_readable/descriptiles/ECOSYSTEM.a2ml` | Gold | Project relationships +| `.machine_readable/descriptiles/AGENTIC.a2ml` | Gold | AI agent constraints +| `.machine_readable/descriptiles/NEUROSYM.a2ml` | Gold | Neurosymbolic integration config +| `.machine_readable/descriptiles/PLAYBOOK.a2ml` | Gold | Operational runbook |=== ==== .well-known/ Directory diff --git a/scripts/build-registry.sh b/scripts/build-registry.sh index e21bc7a5..96652c6c 100755 --- a/scripts/build-registry.sh +++ b/scripts/build-registry.sh @@ -237,7 +237,7 @@ ENTRY # --------------------------------------------------------------------------- state_field() { # crude TOML-ish field reader for STATE.a2ml - local key="$1" file=".machine_readable/6a2/STATE.a2ml" + local key="$1" file=".machine_readable/descriptiles/STATE.a2ml" # take RHS of `key = value`, drop trailing inline `# comment`, trim, unquote grep -E "^${key}[[:space:]]*=" "$file" 2>/dev/null | head -1 \ | sed -E 's/^[^=]*=[[:space:]]*//; s/[[:space:]]*#.*$//; s/[[:space:]]+$//; s/^"//; s/"$//' diff --git a/scripts/check-canonical-names.sh b/scripts/check-canonical-names.sh index e8173bc9..30d10230 100755 --- a/scripts/check-canonical-names.sh +++ b/scripts/check-canonical-names.sh @@ -31,7 +31,8 @@ declare -A REPL=( ["6a2"]="descriptiles" ["agent_instructions"]="bot_directives" is_excluded() { case "$1" in CANONICAL-NAMES.adoc|scripts/check-canonical-names.sh|scripts/tests/*|\ - *MIGRATION*|*migration*|*CHANGELOG*|*/6a2/*) return 0 ;; + *MIGRATION*|*migration*|*CHANGELOG*|\ + standards-update/.machine_readable/6scm-archive/.machine_readable/6a2/*) return 0 ;; esac return 1 } @@ -43,17 +44,17 @@ rc=0 current_file="" while IFS= read -r line; do case "$line" in - "+++ b/"*) current_file="${line#+++ b/}" ;; + "+++ b/"*) + current_file="${line#+++ b/}" + if ! is_excluded "$current_file" && + [[ "/$current_file/" == */.machine_readable/6a2/* ]]; then + echo "❌ $current_file: reintroduces deprecated '.machine_readable/6a2/' — use '.machine_readable/descriptiles/' (CANONICAL-NAMES.adoc)" + rc=1 + fi + ;; "+"*) is_excluded "$current_file" && continue body="${line#+}" - # Hypatia baselines identify findings by their literal on-disk path. This - # narrow matcher records an existing legacy path; it does not name a new - # product, interface, or source location. - if [ "$current_file" = ".hypatia-baseline.json" ] && - printf '%s' "$body" | grep -Fq '"file_pattern": ".machine_readable/6a2/*.a2ml"'; then - continue - fi # Skip a line that is DESCRIBING the deprecation rather than using the old # name — it also mentions the canonical replacement or the mandate itself # (e.g. tooling comments, this guard's own wiring, docs about the rename). diff --git a/scripts/tests/wave6-canonical-names-test.sh b/scripts/tests/wave6-canonical-names-test.sh index ae88254e..ef9cc137 100755 --- a/scripts/tests/wave6-canonical-names-test.sh +++ b/scripts/tests/wave6-canonical-names-test.sh @@ -37,6 +37,15 @@ git add "$f" 2>/dev/null if bash "$CHK" HEAD >/dev/null 2>&1; then bad "new 'agent_instructions' not blocked"; else ok "new 'agent_instructions' blocked"; fi git reset -q "$f" 2>/dev/null; rm -f "$f" +echo "== guard blocks a newly-added deprecated directory ==" +legacy_dir=".machine_readable/6a2" +mkdir -p "$legacy_dir" +printf '[metadata]\nstatus = "probe"\n' > "$legacy_dir/STATE.a2ml" +git add "$legacy_dir/STATE.a2ml" 2>/dev/null +if bash "$CHK" HEAD >/dev/null 2>&1; then bad "new deprecated directory not blocked"; else ok "new deprecated directory blocked"; fi +git reset -q "$legacy_dir/STATE.a2ml" 2>/dev/null +rm -rf "$legacy_dir" + echo "== guard passes with no offending additions ==" printf 'a perfectly canonical descriptiles + bot_directives line\n' > "$f" git add "$f" 2>/dev/null diff --git a/standards-update/.machine_readable/6a2/AGENTIC.a2ml b/standards-update/.machine_readable/descriptiles/AGENTIC.a2ml similarity index 100% rename from standards-update/.machine_readable/6a2/AGENTIC.a2ml rename to standards-update/.machine_readable/descriptiles/AGENTIC.a2ml diff --git a/standards-update/.machine_readable/6a2/ECOSYSTEM.a2ml b/standards-update/.machine_readable/descriptiles/ECOSYSTEM.a2ml similarity index 100% rename from standards-update/.machine_readable/6a2/ECOSYSTEM.a2ml rename to standards-update/.machine_readable/descriptiles/ECOSYSTEM.a2ml diff --git a/standards-update/.machine_readable/6a2/META.a2ml b/standards-update/.machine_readable/descriptiles/META.a2ml similarity index 100% rename from standards-update/.machine_readable/6a2/META.a2ml rename to standards-update/.machine_readable/descriptiles/META.a2ml diff --git a/standards-update/.machine_readable/6a2/NEUROSYM.a2ml b/standards-update/.machine_readable/descriptiles/NEUROSYM.a2ml similarity index 100% rename from standards-update/.machine_readable/6a2/NEUROSYM.a2ml rename to standards-update/.machine_readable/descriptiles/NEUROSYM.a2ml diff --git a/standards-update/.machine_readable/6a2/PLAYBOOK.a2ml b/standards-update/.machine_readable/descriptiles/PLAYBOOK.a2ml similarity index 100% rename from standards-update/.machine_readable/6a2/PLAYBOOK.a2ml rename to standards-update/.machine_readable/descriptiles/PLAYBOOK.a2ml diff --git a/standards-update/.machine_readable/6a2/STATE.a2ml b/standards-update/.machine_readable/descriptiles/STATE.a2ml similarity index 100% rename from standards-update/.machine_readable/6a2/STATE.a2ml rename to standards-update/.machine_readable/descriptiles/STATE.a2ml diff --git a/state-a2ml/.machine_readable/6a2/AGENTIC.a2ml b/state-a2ml/.machine_readable/descriptiles/AGENTIC.a2ml similarity index 100% rename from state-a2ml/.machine_readable/6a2/AGENTIC.a2ml rename to state-a2ml/.machine_readable/descriptiles/AGENTIC.a2ml diff --git a/state-a2ml/.machine_readable/6a2/ECOSYSTEM.a2ml b/state-a2ml/.machine_readable/descriptiles/ECOSYSTEM.a2ml similarity index 100% rename from state-a2ml/.machine_readable/6a2/ECOSYSTEM.a2ml rename to state-a2ml/.machine_readable/descriptiles/ECOSYSTEM.a2ml diff --git a/state-a2ml/.machine_readable/6a2/META.a2ml b/state-a2ml/.machine_readable/descriptiles/META.a2ml similarity index 100% rename from state-a2ml/.machine_readable/6a2/META.a2ml rename to state-a2ml/.machine_readable/descriptiles/META.a2ml diff --git a/state-a2ml/.machine_readable/6a2/NEUROSYM.a2ml b/state-a2ml/.machine_readable/descriptiles/NEUROSYM.a2ml similarity index 100% rename from state-a2ml/.machine_readable/6a2/NEUROSYM.a2ml rename to state-a2ml/.machine_readable/descriptiles/NEUROSYM.a2ml diff --git a/state-a2ml/.machine_readable/6a2/PLAYBOOK.a2ml b/state-a2ml/.machine_readable/descriptiles/PLAYBOOK.a2ml similarity index 100% rename from state-a2ml/.machine_readable/6a2/PLAYBOOK.a2ml rename to state-a2ml/.machine_readable/descriptiles/PLAYBOOK.a2ml diff --git a/state-a2ml/.machine_readable/6a2/STATE.a2ml b/state-a2ml/.machine_readable/descriptiles/STATE.a2ml similarity index 100% rename from state-a2ml/.machine_readable/6a2/STATE.a2ml rename to state-a2ml/.machine_readable/descriptiles/STATE.a2ml diff --git a/state-a2ml/spec/IANA-MEDIA-TYPE.adoc b/state-a2ml/spec/IANA-MEDIA-TYPE.adoc index 9da48b5b..dd14e81b 100644 --- a/state-a2ml/spec/IANA-MEDIA-TYPE.adoc +++ b/state-a2ml/spec/IANA-MEDIA-TYPE.adoc @@ -137,7 +137,7 @@ files. `.a2ml`:: Current A2ML format extension (RECOMMENDED). Files named `STATE.a2ml`, - placed at `.machine_readable/6a2/STATE.a2ml`. + placed at `.machine_readable/descriptiles/STATE.a2ml`. `.scm`:: DEPRECATED legacy Guile Scheme extension. Preserved for archival reference. diff --git a/state-a2ml/spec/STATE-FORMAT-SPEC.adoc b/state-a2ml/spec/STATE-FORMAT-SPEC.adoc index 55c5d139..3ff68259 100644 --- a/state-a2ml/spec/STATE-FORMAT-SPEC.adoc +++ b/state-a2ml/spec/STATE-FORMAT-SPEC.adoc @@ -94,7 +94,7 @@ document are to be interpreted as described in RFC 2119. STATE file:: A file conforming to this specification. The current format uses A2ML (TOML-like) - syntax and is named `STATE.a2ml`, located in `.machine_readable/6a2/STATE.a2ml`. + syntax and is named `STATE.a2ml`, located in `.machine_readable/descriptiles/STATE.a2ml`. The legacy Guile Scheme format (`STATE.scm`) is deprecated as of 2026-04-12. Section:: @@ -1059,7 +1059,7 @@ Change controller: [TBD] === File Extension The current recommended file extension is `.a2ml` with filename `STATE.a2ml`, -placed at `.machine_readable/6a2/STATE.a2ml`. +placed at `.machine_readable/descriptiles/STATE.a2ml`. The legacy extension `.scm` (Guile Scheme format) is deprecated as of 2026-04-12. Legacy files are preserved for archival reference only.