Skip to content

Commit eae2272

Browse files
fix(ci): unbreak estate-rules + A2ML gates introduced by #49 (#50)
## Summary The tier‑2 bundle (#49) merged with two required gates red; they're now failing on `main` and will fail every subsequent PR's CI. This is a minimal follow‑up that closes both — no functional change to the tier‑2 work. ## Changes - **`estate-rules.yml`** — the "AsciiDoc by default under `docs/`" check flagged the **Documenter source pages** (`docs/src/*.md`) that #49 added for the new docs build. Documenter's native source format is **Markdown** — it cannot consume `.adoc` — so `docs/src/` is a legitimate carve‑out, exactly like the existing `docs/wiki/` GitHub‑wiki mirror. Added `-not -path 'docs/src/*'` to the check and updated the comments/step name to document the carve‑out. - **`.machine_readable/policies/MAINTENANCE-AXES.a2ml`** + **`MAINTENANCE-CHECKLIST.a2ml`** — A2ML validation requires an identity field (`agent-id`/`name`/`project`); these two were missing it. Added `name` + `project` to each `[metadata]` block. ## Verification (local) - `find docs -name '*.md' -not -path 'docs/wiki/*' -not -path 'docs/src/*'` → **empty** (no disallowed `.md`; `docs/legal/*.txt` and `docs/governance/*.adoc` are unaffected). - Both policy files now carry `name` + `project` in `[metadata]` (the exact fields the validator's error named). ## Why this happened Two parallel workers built #49 on disjoint file‑sets; the docs worker added `docs/src/*.md` (Documenter) while the compliance worker wrote the `estate-rules` docs check — neither saw the other's additions. Caught here on the first real CI run and fixed at the workflow level. 🤖 Generated with [Claude Code](https://claude.com/claude-code) https://claude.ai/code/session_01UPFC9YQ7g9gc3VnRox42Q1 --- _Generated by [Claude Code](https://claude.ai/code/session_01UPFC9YQ7g9gc3VnRox42Q1)_ --------- Co-authored-by: Claude <noreply@anthropic.com>
1 parent 4e40494 commit eae2272

4 files changed

Lines changed: 11 additions & 5 deletions

File tree

.github/workflows/estate-rules.yml

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -4,8 +4,9 @@
44
# Estate Rules — enforces hyperpolymath estate-wide conventions relevant to a
55
# Julia numerics package: no-Python (banned estate-wide, replacement is
66
# Julia/Rust/AffineScript), AsciiDoc-by-default under docs/ (excluding the
7-
# docs/wiki/ GitHub-wiki mirror, which is legitimately Markdown because
8-
# GitHub's wiki renderer consumes .md, not .adoc), and no V-lang (vlang.io)
7+
# docs/wiki/ GitHub-wiki mirror and docs/src/ Documenter source, both of which
8+
# are legitimately Markdown — GitHub's wiki renderer and Documenter both consume
9+
# .md, not .adoc), and no V-lang (vlang.io)
910
# references — NOT a ban on Zig. Zig is the current estate default for
1011
# APIs/FFI/gateways (hyperpolymath/standards CLAUDE.md, "Estate default
1112
# 2026-05-28"), and Axiom.jl legitimately ships a Zig compute layer
@@ -47,15 +48,15 @@ jobs:
4748
fi
4849
echo "PASS: no Python files found"
4950
50-
- name: AsciiDoc by default under docs/ (excluding docs/wiki/ GitHub-wiki mirror)
51+
- name: AsciiDoc by default under docs/ (excluding docs/wiki/ mirror + docs/src/ Documenter source)
5152
run: |
52-
HITS=$(find docs -name '*.md' -type f -not -path 'docs/wiki/*' 2>/dev/null || true)
53+
HITS=$(find docs -name '*.md' -type f -not -path 'docs/wiki/*' -not -path 'docs/src/*' 2>/dev/null || true)
5354
if [ -n "$HITS" ]; then
5455
echo "::error::.md files found under docs/ outside the docs/wiki/ mirror (estate rule: AsciiDoc by default):"
5556
echo "$HITS"
5657
exit 1
5758
fi
58-
echo "PASS: no disallowed .md files under docs/ (docs/wiki/ is the GitHub-wiki Markdown mirror, exempt by design)"
59+
echo "PASS: no disallowed .md files under docs/ (docs/wiki/ = GitHub-wiki mirror, docs/src/ = Documenter source; both legitimately Markdown)"
5960
6061
- name: No V-lang references (Zig is the estate default — do not confuse the two)
6162
run: |

.gitignore

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -103,3 +103,4 @@ deps/
103103
.cache/
104104
build/
105105
dist/
106+
docs/Manifest.toml

.machine_readable/policies/MAINTENANCE-AXES.a2ml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,8 @@
44
# Canonical maintenance governance model — Axiom.jl
55

66
[metadata]
7+
name = "axiom-maintenance-governance"
8+
project = "Axiom.jl"
79
version = "1.0.0"
810
last-updated = "2026-07-01"
911
scope = "repo"

.machine_readable/policies/MAINTENANCE-CHECKLIST.a2ml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,8 @@
44
# Maintenance baseline (machine-readable canonical) — Axiom.jl
55

66
[metadata]
7+
name = "axiom-maintenance-checklist"
8+
project = "Axiom.jl"
79
version = "1.0.0"
810
last-updated = "2026-07-01"
911
scope = "repo"

0 commit comments

Comments
 (0)