Skip to content

Commit f553c7b

Browse files
committed
fix(governance): finish root→6a2 a2ml convergence; openssf gate checks canonical paths
The repo's openssf-compliance gate required .machine_readable/{STATE,META, ECOSYSTEM}.a2ml at the ROOT — the pre-6a2 paths — while Hypatia SD004 (error-level) requires those files to live ONLY in .machine_readable/6a2/. The two gates were in direct contradiction; the estate standard (and all sibling repos) make 6a2/ canonical, so: - openssf-compliance.yml now checks .machine_readable/6a2/* paths. - Stale root S-expr duplicates META.a2ml + ECOSYSTEM.a2ml removed (canonical TOML versions live in 6a2/; root STATE.a2ml was removed in the previous commit). - Six referencing files repointed to the 6a2/ paths. https://claude.ai/code/session_01GJatEm2TVFSTBEkKXmserJ
1 parent 41e0fae commit f553c7b

9 files changed

Lines changed: 15 additions & 31 deletions

File tree

.github/workflows/openssf-compliance.yml

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -74,11 +74,13 @@ jobs:
7474
exit 1
7575
fi
7676
77-
if [ ! -f ".machine_readable/STATE.a2ml" ]; then
78-
echo "::error::.machine_readable/STATE.a2ml is required"
77+
# Canonical location is .machine_readable/6a2/ (estate standard;
78+
# Hypatia SD004 flags any *.a2ml of the 6a2 set OUTSIDE 6a2/).
79+
if [ ! -f ".machine_readable/6a2/STATE.a2ml" ]; then
80+
echo "::error::.machine_readable/6a2/STATE.a2ml is required"
7981
exit 1
8082
fi
81-
echo ".machine_readable/STATE.a2ml: OK"
83+
echo ".machine_readable/6a2/STATE.a2ml: OK"
8284
8385
- name: Check CHANGELOG exists
8486
run: |
@@ -96,8 +98,8 @@ jobs:
9698
# Collect all required files that exist
9799
for f in SECURITY.md SECURITY.adoc .github/SECURITY.md LICENSE LICENSE.txt \
98100
CONTRIBUTING.md CONTRIBUTING.adoc README.md README.adoc \
99-
.machine_readable/STATE.a2ml .machine_readable/META.a2ml \
100-
.machine_readable/ECOSYSTEM.a2ml CHANGELOG.md CHANGELOG.adoc; do
101+
.machine_readable/6a2/STATE.a2ml .machine_readable/6a2/META.a2ml \
102+
.machine_readable/6a2/ECOSYSTEM.a2ml CHANGELOG.md CHANGELOG.adoc; do
101103
[ -f "$f" ] && REQUIRED_FILES="$REQUIRED_FILES $f"
102104
done
103105

.machine_readable/6a2/PLAYBOOK.a2ml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ last-updated = "2026-04-11"
1313
# target = "container" # container | binary | library | wasm
1414

1515
[incident-response]
16-
# 1. Check .machine_readable/STATE.a2ml for current status
16+
# 1. Check .machine_readable/6a2/STATE.a2ml for current status
1717
# 2. Review recent commits and CI results
1818
# 3. Run `just validate` to check compliance
1919
# 4. Run `just security` to audit for vulnerabilities

.machine_readable/ECOSYSTEM.a2ml

Lines changed: 0 additions & 8 deletions
This file was deleted.

.machine_readable/META.a2ml

Lines changed: 0 additions & 10 deletions
This file was deleted.

.machine_readable/ai/AI.a2ml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@
77
- Prefer to keep generated files out of source control, and regenerate them with the documented commands before committing.
88

99
## Workflow
10-
1. Inspect `.machine_readable/STATE.a2ml` for blockers and next actions.
10+
1. Inspect `.machine_readable/6a2/STATE.a2ml` for blockers and next actions.
1111
2. Respect any constraints listed inside `.machine_readable/AGENTIC.a2ml` when tooling changes are requested.
1212
3. After finishing edits, update STATE with your outcomes and commit with a concise, imperative message.
1313

.machine_readable/ai/README.adoc

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -20,5 +20,5 @@ Recommended machine read order:
2020
* `.machine_readable/policies/MAINTENANCE-AXES.a2ml`
2121
* `.machine_readable/policies/MAINTENANCE-CHECKLIST.a2ml`
2222
* `.machine_readable/policies/SOFTWARE-DEVELOPMENT-APPROACH.a2ml`
23-
* `.machine_readable/STATE.a2ml`
24-
* `.machine_readable/META.a2ml`
23+
* `.machine_readable/6a2/STATE.a2ml`
24+
* `.machine_readable/6a2/META.a2ml`

.machine_readable/policies/MAINTENANCE-AXES.a2ml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ machine-entrypoints = [
1818
".machine_readable/policies/MAINTENANCE-AXES.a2ml",
1919
".machine_readable/policies/MAINTENANCE-CHECKLIST.a2ml",
2020
".machine_readable/policies/SOFTWARE-DEVELOPMENT-APPROACH.a2ml",
21-
".machine_readable/META.a2ml",
21+
".machine_readable/6a2/META.a2ml",
2222
".machine_readable/ai/README.adoc",
2323
".machine_readable/bot_directives/README.scm",
2424
]

docs/RSR_OUTLINE.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -217,7 +217,7 @@ project/
217217
* `Justfile`
218218
* `README.adoc`
219219
* `LICENSE` (MPL-2.0)
220-
* `.machine_readable/STATE.a2ml`
220+
* `.machine_readable/6a2/STATE.a2ml`
221221
* `.well-known/security.txt`
222222
* `.well-known/ai.txt`
223223
* `.well-known/humans.txt`

docs/practice/AI-CONVENTIONS.adoc

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ Per-tool config files (.cursorrules, .clinerules, etc.) reference this document.
1212
## Session Startup
1313

1414
1. Read `0-AI-MANIFEST.a2ml` FIRST (mandatory gatekeeper).
15-
2. Read `.machine_readable/STATE.a2ml` for current status and blockers.
15+
2. Read `.machine_readable/6a2/STATE.a2ml` for current status and blockers.
1616
3. Read `.machine_readable/anchors/ANCHOR.a2ml` for canonical authority boundaries.
1717
4. Read `.machine_readable/policies/MAINTENANCE-AXES.a2ml` for maintenance/audit sequencing.
1818
5. Read `.machine_readable/policies/MAINTENANCE-CHECKLIST.a2ml` for baseline controls.
@@ -80,7 +80,7 @@ Use `just` (Justfile) for all build, test, lint, and format tasks.
8080

8181
- `0-AI-MANIFEST.a2ml` -- universal AI entry point
8282
- `.machine_readable/AGENTIC.a2ml` -- agent permissions and constraints
83-
- `.machine_readable/STATE.a2ml` -- current project state
83+
- `.machine_readable/6a2/STATE.a2ml` -- current project state
8484
- `.machine_readable/anchors/ANCHOR.a2ml` -- canonical authority and policy boundary
8585
- `.machine_readable/policies/MAINTENANCE-AXES.a2ml` -- canonical axis sequencing and audit requirements
8686
- `.machine_readable/policies/MAINTENANCE-CHECKLIST.a2ml` -- baseline maintenance checklist policy

0 commit comments

Comments
 (0)