From 6701a9766c75f3c2b8f5cf97351eac60ea11e895 Mon Sep 17 00:00:00 2001 From: Claude Date: Tue, 10 Nov 2026 21:39:18 +0000 Subject: [PATCH] chore(descriptiles): move .machine_readable/6a2 to .machine_readable/descriptiles Hypatia reports 5 critical findings in this repository (rule SD004, "Descriptile in retired location"): META, ECOSYSTEM, AGENTIC, NEUROSYM and PLAYBOOK are in .machine_readable/6a2/. The check "Hypatia Neurosymbolic Analysis" fails on them. - git mv .machine_readable/6a2 .machine_readable/descriptiles (11 files, with anchors/) - 35 files that name the old path get the new path: scripts of the arrival pack and of the coaptation, the 6 contractiles, Mustfile.a2ml, the AI manifests, openssf-compliance.yml, the pre-commit pattern, the pull request template and documents - same wording as system-et, which has this layout Not changed: - anytype_chora.deed: 2 comment lines still say 6a2. The arrival pack has the hash of this file, and CLAUDE.md can be made again only with Nickel. - .machine_readable/archive/state-v1.a2ml: its note says where the archived file was. - .machine_readable/coaptation/receipts/latest.a2ml: see below. KNOWN DRIFT, owner decision of 2026-11-10: Mustfile.a2ml changes (its check must name the new folder), so the coaptation receipt is stale: line 89 has must@20748d123686, and the extract script now gives must@fbbcf90bc87f. Run `just coapt` on a machine that has Nickel. Co-Authored-By: Claude Claude-Session: https://claude.ai/code/session_0136P7ZmiFSCoB3UR9Kk56rK --- .github/GOVERNANCE.md | 2 +- .github/pull_request_template.md | 4 ++-- .github/workflows/openssf-compliance.yml | 4 ++-- .machine_readable/0.1-AI-MANIFEST.a2ml | 14 +++++++------- .machine_readable/ai/AI.a2ml | 2 +- .machine_readable/ai/README.adoc | 4 ++-- .machine_readable/arrival-pack/claude-md.k9.ncl | 8 ++++---- .machine_readable/arrival-pack/extract.sh | 2 +- .machine_readable/arrival-pack/generate.sh | 2 +- .machine_readable/arrival-pack/verify.sh | 2 +- .machine_readable/coaptation/coapt.k9.ncl | 8 ++++---- .machine_readable/coaptation/coapt.sh | 2 +- .machine_readable/coaptation/extract-facts.sh | 2 +- .machine_readable/coaptation/verify.sh | 2 +- .machine_readable/coaptation/witness-map.ncl | 2 +- .../contractiles/adjust/adjust.k9.ncl | 4 ++-- .machine_readable/contractiles/bust/bust.k9.ncl | 4 ++-- .machine_readable/contractiles/dust/dust.k9.ncl | 4 ++-- .../contractiles/intend/intend.k9.ncl | 8 ++++---- .machine_readable/contractiles/must/Mustfile.a2ml | 8 ++++---- .machine_readable/contractiles/must/must.k9.ncl | 4 ++-- .machine_readable/contractiles/trust/trust.k9.ncl | 6 +++--- .../{6a2 => descriptiles}/0-AI-MANIFEST.a2ml | 4 ++-- .../{6a2 => descriptiles}/AGENTIC.a2ml | 0 .machine_readable/{6a2 => descriptiles}/CLADE.a2ml | 0 .../{6a2 => descriptiles}/ECOSYSTEM.a2ml | 0 .machine_readable/{6a2 => descriptiles}/META.a2ml | 0 .../{6a2 => descriptiles}/NEUROSYM.a2ml | 0 .../{6a2 => descriptiles}/PLAYBOOK.a2ml | 4 ++-- .../{6a2 => descriptiles}/README.adoc | 2 +- .../anchors/0-AI-MANIFEST.a2ml | 0 .../{6a2 => descriptiles}/anchors/ANCHOR.a2ml | 0 .../{6a2 => descriptiles}/anchors/README.adoc | 0 .machine_readable/policies/MAINTENANCE-AXES.a2ml | 2 +- .../policies/MAINTENANCE-CHECKLIST.a2ml | 2 +- .machine_readable/root-allow.txt | 2 +- .pre-commit-config.yaml | 2 +- AFFIRMATION.adoc | 2 +- docs/RSR_OUTLINE.adoc | 2 +- docs/governance/CRG-AUDIT-TEMPLATE.adoc | 8 ++++---- docs/practice/AI-CONVENTIONS.adoc | 8 ++++---- docs/status/READINESS.adoc | 6 +++--- .../canonical-directory-structure/README.adoc | 4 ++-- scripts/validate-template.sh | 6 +++--- tests/e2e/template_instantiation_test.sh | 2 +- 45 files changed, 77 insertions(+), 77 deletions(-) rename .machine_readable/{6a2 => descriptiles}/0-AI-MANIFEST.a2ml (83%) rename .machine_readable/{6a2 => descriptiles}/AGENTIC.a2ml (100%) rename .machine_readable/{6a2 => descriptiles}/CLADE.a2ml (100%) 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 (97%) rename .machine_readable/{6a2 => descriptiles}/README.adoc (97%) rename .machine_readable/{6a2 => descriptiles}/anchors/0-AI-MANIFEST.a2ml (100%) rename .machine_readable/{6a2 => descriptiles}/anchors/ANCHOR.a2ml (100%) rename .machine_readable/{6a2 => descriptiles}/anchors/README.adoc (100%) diff --git a/.github/GOVERNANCE.md b/.github/GOVERNANCE.md index 677588d..96db3b8 100644 --- a/.github/GOVERNANCE.md +++ b/.github/GOVERNANCE.md @@ -46,7 +46,7 @@ release schedules, contributor access, and community standards. - ADR statuses: `proposed`, `accepted`, `deprecated`, `superseded`, `rejected`. - ADRs provide a historical record of why decisions were made and what alternatives were considered. -- See `.machine_readable/6a2/META.a2ml` for the machine-readable ADR index. +- See `.machine_readable/descriptiles/META.a2ml` for the machine-readable ADR index. --- diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md index c650acd..6fe4951 100644 --- a/.github/pull_request_template.md +++ b/.github/pull_request_template.md @@ -30,8 +30,8 @@ Copyright (c) Jonathan D.A. Jewell ### As Applicable - [ ] `docs/status/JOURNAL.adoc` updated (if the phase, blockers or next action changed) -- [ ] `.machine_readable/6a2/ECOSYSTEM.a2ml` updated (if integrations changed) -- [ ] `.machine_readable/6a2/META.a2ml` updated (if architectural decisions changed) +- [ ] `.machine_readable/descriptiles/ECOSYSTEM.a2ml` updated (if integrations changed) +- [ ] `.machine_readable/descriptiles/META.a2ml` updated (if architectural decisions changed) - [ ] Documentation updated for user-facing changes - [ ] `TOPOLOGY.md` updated (if architecture changed) - [ ] `CHANGELOG` or release notes updated diff --git a/.github/workflows/openssf-compliance.yml b/.github/workflows/openssf-compliance.yml index e2e31aa..08577f7 100644 --- a/.github/workflows/openssf-compliance.yml +++ b/.github/workflows/openssf-compliance.yml @@ -90,8 +90,8 @@ jobs: # Collect all required files that exist for f in SECURITY.md SECURITY.adoc .github/SECURITY.md LICENSE LICENSE.txt \ CONTRIBUTING.md CONTRIBUTING.adoc README.md README.adoc \ - docs/status/JOURNAL.adoc .machine_readable/6a2/META.a2ml \ - .machine_readable/6a2/ECOSYSTEM.a2ml CHANGELOG.md CHANGELOG.adoc; do + docs/status/JOURNAL.adoc .machine_readable/descriptiles/META.a2ml \ + .machine_readable/descriptiles/ECOSYSTEM.a2ml CHANGELOG.md CHANGELOG.adoc; do [ -f "$f" ] && REQUIRED_FILES="$REQUIRED_FILES $f" done diff --git a/.machine_readable/0.1-AI-MANIFEST.a2ml b/.machine_readable/0.1-AI-MANIFEST.a2ml index ac241d9..38ecf0c 100644 --- a/.machine_readable/0.1-AI-MANIFEST.a2ml +++ b/.machine_readable/0.1-AI-MANIFEST.a2ml @@ -13,13 +13,13 @@ description: | canonical_locations: state: "../docs/status/JOURNAL.adoc" - meta: "6a2/META.a2ml" - ecosystem: "6a2/ECOSYSTEM.a2ml" - agentic: "6a2/AGENTIC.a2ml" - neurosym: "6a2/NEUROSYM.a2ml" - playbook: "6a2/PLAYBOOK.a2ml" - clade: "6a2/CLADE.a2ml" - anchors: "6a2/anchors/" + meta: "descriptiles/META.a2ml" + ecosystem: "descriptiles/ECOSYSTEM.a2ml" + agentic: "descriptiles/AGENTIC.a2ml" + neurosym: "descriptiles/NEUROSYM.a2ml" + playbook: "descriptiles/PLAYBOOK.a2ml" + clade: "descriptiles/CLADE.a2ml" + anchors: "descriptiles/anchors/" policies: "policies/" ai_configs: "ai/" compliance: "compliance/" diff --git a/.machine_readable/ai/AI.a2ml b/.machine_readable/ai/AI.a2ml index d1dce13..3a3ba8e 100644 --- a/.machine_readable/ai/AI.a2ml +++ b/.machine_readable/ai/AI.a2ml @@ -8,7 +8,7 @@ ## Workflow 1. Inspect `docs/status/JOURNAL.adoc` for the phase, blockers and next action. -2. Respect any constraints listed inside `.machine_readable/6a2/AGENTIC.a2ml` when tooling changes are requested. +2. Respect any constraints listed inside `.machine_readable/descriptiles/AGENTIC.a2ml` when tooling changes are requested. 3. After finishing edits, update the thin journal (docs/status/JOURNAL.adoc) with your outcomes and commit with a concise, imperative message. ## Delivery Promises diff --git a/.machine_readable/ai/README.adoc b/.machine_readable/ai/README.adoc index 7d1f62e..4e08d29 100644 --- a/.machine_readable/ai/README.adoc +++ b/.machine_readable/ai/README.adoc @@ -16,9 +16,9 @@ Avoid scattering agent instruction files around the repo root. Recommended machine read order: -* `.machine_readable/6a2/anchors/ANCHOR.a2ml` +* `.machine_readable/descriptiles/anchors/ANCHOR.a2ml` * `.machine_readable/policies/MAINTENANCE-AXES.a2ml` * `.machine_readable/policies/MAINTENANCE-CHECKLIST.a2ml` * `.machine_readable/policies/SOFTWARE-DEVELOPMENT-APPROACH.a2ml` * `docs/status/JOURNAL.adoc` -* `.machine_readable/6a2/META.a2ml` +* `.machine_readable/descriptiles/META.a2ml` diff --git a/.machine_readable/arrival-pack/claude-md.k9.ncl b/.machine_readable/arrival-pack/claude-md.k9.ncl index 652f795..122036a 100644 --- a/.machine_readable/arrival-pack/claude-md.k9.ncl +++ b/.machine_readable/arrival-pack/claude-md.k9.ncl @@ -34,11 +34,11 @@ K9! # Inputs the projection reads (single source of truth). inputs = { descriptiles = [ - ".machine_readable/6a2/CLADE.a2ml", - ".machine_readable/6a2/ECOSYSTEM.a2ml", - ".machine_readable/6a2/AGENTIC.a2ml", + ".machine_readable/descriptiles/CLADE.a2ml", + ".machine_readable/descriptiles/ECOSYSTEM.a2ml", + ".machine_readable/descriptiles/AGENTIC.a2ml", "anytype_chora.deed", # lifecycle + maturity (state-v1-decision option B) - ".machine_readable/6a2/anchors/ANCHOR.a2ml", + ".machine_readable/descriptiles/anchors/ANCHOR.a2ml", ], estate_common = "hyperpolymath/manifesto@", # DRAFT-unratified today target = "CLAUDE.md", diff --git a/.machine_readable/arrival-pack/extract.sh b/.machine_readable/arrival-pack/extract.sh index 54db602..bfdca14 100755 --- a/.machine_readable/arrival-pack/extract.sh +++ b/.machine_readable/arrival-pack/extract.sh @@ -15,7 +15,7 @@ # Determinism (no timestamps) is required so the k9 drift check can byte-compare. set -euo pipefail -DIR6A2="${1:-.machine_readable/6a2}" +DIR6A2="${1:-.machine_readable/descriptiles}" CLADE="$DIR6A2/CLADE.a2ml" ECO="$DIR6A2/ECOSYSTEM.a2ml" AGENTIC="$DIR6A2/AGENTIC.a2ml" diff --git a/.machine_readable/arrival-pack/generate.sh b/.machine_readable/arrival-pack/generate.sh index 3caafa9..ac2a859 100755 --- a/.machine_readable/arrival-pack/generate.sh +++ b/.machine_readable/arrival-pack/generate.sh @@ -13,7 +13,7 @@ ROOT="$(git rev-parse --show-toplevel)" AP="$ROOT/.machine_readable/arrival-pack" TARGET="$ROOT/CLAUDE.md" -bash "$AP/extract.sh" "$ROOT/.machine_readable/6a2" > "$AP/claude-md-data.json" +bash "$AP/extract.sh" "$ROOT/.machine_readable/descriptiles" > "$AP/claude-md-data.json" nickel export --format raw "$AP/arrival-pack.ncl" > "$AP/.region.tmp" if [ -f "$TARGET" ] && grep -q 'ARRIVAL-PACK:BEGIN' "$TARGET"; then diff --git a/.machine_readable/arrival-pack/verify.sh b/.machine_readable/arrival-pack/verify.sh index 0763f00..1d90acf 100755 --- a/.machine_readable/arrival-pack/verify.sh +++ b/.machine_readable/arrival-pack/verify.sh @@ -13,7 +13,7 @@ TARGET="$ROOT/CLAUDE.md" [ -f "$TARGET" ] || { echo "DRIFT: CLAUDE.md missing — run \`just claude-md\`"; exit 1; } -bash "$AP/extract.sh" "$ROOT/.machine_readable/6a2" > "$AP/claude-md-data.json" +bash "$AP/extract.sh" "$ROOT/.machine_readable/descriptiles" > "$AP/claude-md-data.json" fresh="$(nickel export --format raw "$AP/arrival-pack.ncl")" committed="$(awk '/