diff --git a/.github/workflows/rhodibot.yml b/.github/workflows/rhodibot.yml index d1067ce..23fb3bc 100644 --- a/.github/workflows/rhodibot.yml +++ b/.github/workflows/rhodibot.yml @@ -54,11 +54,16 @@ jobs: for f in *-STATUS-*.md *-COMPLETION-*.md *-COMPLETE.md *-VERIFIED-*.md; do [ -f "$f" ] && warn "stale snapshot present: $f (would be deleted)" done - # retired: A2ML manifests (the front door is 0-AI-MANIFEST.deed; - # docs/history/A2ML-REMOVED.adoc) - for f in AI.a2ml 0-AI-MANIFEST.a2ml; do - [ -f "$f" ] && warn "retired A2ML manifest present: $f (the front door is 0-AI-MANIFEST.deed)" - done + # retired: A2ML. No .a2ml file may exist anywhere in the tree, + # 9-archive/ included, except the three kept files listed in + # docs/history/A2ML-REMOVED.adoc. The front door is 0-AI-MANIFEST.deed. + while IFS= read -r -d '' f; do + f="${f#./}" + case "$f" in + verisim/config.a2ml|verisim/seed/clades.a2ml|verisim/seed/forges.a2ml) ;; + *) warn "retired A2ML file present: $f (A2ML is retired; only the three kept files in docs/history/A2ML-REMOVED.adoc may remain)" ;; + esac + done < <(find . -path ./.git -prune -o \( -type f -o -type l \) -iname '*.a2ml' -print0) # would-DELETE: duplicate community files [ -f "CONTRIBUTING.md" ] && [ -f "CONTRIBUTING.adoc" ] && warn "duplicate CONTRIBUTING.md + CONTRIBUTING.adoc (one would be removed)" if [ -f "README.md" ] && [ -f "README.adoc" ] && [ "$(wc -l < README.md)" -lt 5 ]; then diff --git a/.machine_readable/ai/.clinerules b/.machine_readable/ai/.clinerules index b3a79a0..24a9b30 100644 --- a/.machine_readable/ai/.clinerules +++ b/.machine_readable/ai/.clinerules @@ -13,7 +13,7 @@ # STATE FILES (.machine_readable/descriptiles/ ONLY) # Repo metadata is deed (chora-registry_chora.deed, descriptiles/STATE.deed). # A2ML is retired: never create a .a2ml file. -# The .machine_readable/ directory is the single source of truth. +# Identity is the root chora-registry_chora.deed; descriptive deeds live in .machine_readable/descriptiles/. # BANNED PATTERNS # Idris2: believe_me, assert_total, assert_smaller, unsafePerformIO diff --git a/.machine_readable/svc/k9/examples/setup-repo.k9.ncl b/.machine_readable/svc/k9/examples/setup-repo.k9.ncl index df79a55..6126d9a 100644 --- a/.machine_readable/svc/k9/examples/setup-repo.k9.ncl +++ b/.machine_readable/svc/k9/examples/setup-repo.k9.ncl @@ -48,7 +48,12 @@ K9! # RSR compliance features to enable features = { - checkpoint_files | Bool = true, # STATE.a2ml, ECOSYSTEM.a2ml, META.a2ml + # Off: A2ML is retired, and these checkpoint files were STATE.a2ml, + # ECOSYSTEM.a2ml and META.a2ml. Repo facts now live in the root + # _chora.deed and descriptive state in + # .machine_readable/descriptiles/STATE.deed, written by hand against + # the standards deed grammar, not by this recipe. + checkpoint_files | Bool = false, security_workflows | Bool = true, # CodeQL, Scorecard, etc. quality_checks | Bool = true, # Linting, formatting mirroring | Bool = false, # GitLab/Bitbucket mirrors @@ -119,13 +124,12 @@ K9! ], }, + # Retired with A2ML: this recipe used to write STATE.a2ml, ECOSYSTEM.a2ml + # and META.a2ml. It now refuses, and points at the deed instead. "create-checkpoint-files" = { - description = "Create STATE.a2ml, ECOSYSTEM.a2ml, META.a2ml", + description = "Retired: A2ML checkpoint files are no longer created", commands = [ - "echo '(state (version \"1.0.0\") (project \"%{config.repo_name}\"))' > STATE.a2ml", - "echo '(ecosystem (version \"1.0.0\") (name \"%{config.repo_name}\"))' > ECOSYSTEM.a2ml", - "echo '(meta (version \"1.0.0\") (project \"%{config.repo_name}\"))' > META.a2ml", - "echo '✓ Checkpoint files created'", + "echo 'A2ML is retired: write _chora.deed and .machine_readable/descriptiles/STATE.deed by hand' && exit 1", ], }, diff --git a/docs/RSR_OUTLINE.adoc b/docs/RSR_OUTLINE.adoc index c24cab8..176b158 100644 --- a/docs/RSR_OUTLINE.adoc +++ b/docs/RSR_OUTLINE.adoc @@ -119,7 +119,12 @@ The template Justfile provides: * **Cookbook generation**: `just cookbook` -> `docs/just-cookbook.adoc` * **Man page generation**: `just man` -> `docs/man/project.1` * **RSR validation**: `just validate-rsr` -* **STATE.a2ml management**: `just state-touch`, `just state-phase` +* **STATE.deed review**: `just state-phase` reads the lifecycle phase from + `.machine_readable/descriptiles/STATE.deed`, and `just validate-state` checks + it. There is no `state-touch`: the deed's `:affirmed` date and + `:affirmed-by` record a review, so you change them by hand, and only after + re-checking the values (`docs/history/A2ML-REMOVED.adoc` records where each + came from), never as a timestamp bump. * **Container support**: `just container-build`, `just container-push` * **CI matrix**: `just ci-matrix [stage] [depth]` diff --git a/docs/governance/RELEASE-RUNBOOK.adoc b/docs/governance/RELEASE-RUNBOOK.adoc index e8ae182..fd8b5f1 100644 --- a/docs/governance/RELEASE-RUNBOOK.adoc +++ b/docs/governance/RELEASE-RUNBOOK.adoc @@ -18,9 +18,9 @@ to update it. Filed as #31. start until the go-gate of every earlier phase that is not withdrawn is signed off here. * **Status bookkeeping is part of the work.** Merging a phase changes three - records in the same PR or the follow-up that closes the phase: - `[route-to-mvp]` completion in `STATE.a2ml`, the README phase table, and - the phase checklist below. + records in the same PR or the follow-up that closes the phase: the + phase's Status cell in the phase table of the root `ROADMAP.adoc`, the + README phase table, and the phase checklist below. * **Dry-run first, always.** Every batch script in `sync/` has a dry-run or refuses to run without an explicit target. Use it before every real pass. * **The registry never lies.** `scripts/check-registry.sh` must pass before @@ -112,7 +112,7 @@ declares its pointer authority per `verisim/config.a2ml`. *Depends on:* Phase 0 (done). *Known blocker:* no VPS instance exists yet. Provisioning decision (Verpex -VPS per `STATE.a2ml`) is the platform operator's. +VPS per `docs/SPEC-clade-verisim-portal.adoc`, Layer 3) is the platform operator's. *Procedure* @@ -135,7 +135,7 @@ VPS per `STATE.a2ml`) is the platform operator's. - [ ] seed reports 0 errors; document counts match the seed - [ ] TLS + auth verified from outside the VPS - [ ] scratch Worker serves `ready` from VeriSimDB -- [ ] `STATE.a2ml` blockers list: drop "VeriSimDB not stood up", Phase 2 completion updated +- [ ] `ROADMAP.adoc`: Phase 2 status updated; the VeriSimDB item dropped from "External prerequisites" and "Current status" *Rollback:* the Worker degrades to the KV snapshot by design — shutting the VPS off is itself the rollback. Re-seed is idempotent (PUT per document). @@ -183,7 +183,7 @@ scope; `CLOUDFLARE_ACCOUNT_ID` if the token spans accounts). Until set, - [ ] staging + production `/v1/ready` green (or honestly `degraded` with Phase 2 open) - [ ] worker-ci + governance + hypatia-scan + staleness all green on main - [ ] contract served/linked from the API index matches `docs/api/openapi.yaml` version -- [ ] `STATE.a2ml` Phase 3 completion = 100; README table updated +- [ ] `ROADMAP.adoc` Phase 3 status = *Complete*; README table updated *Rollback:* `wrangler rollback` (worker-level) or redeploy previous `compatibility_date`; KV snapshot is untouched by deploys. @@ -204,7 +204,7 @@ build-time snapshot export (`sync/export-json.sh` → static JSON). Default: build-time snapshot for first paint, API for live search. *Go-gate:* every `portal_url` emitted by the API resolves to a rendered -page; the 327-repo set renders without console errors; `STATE.a2ml` updated. +page; the 327-repo set renders without console errors; `ROADMAP.adoc` Phase 4 status updated. [[phase-5]] == Phase 5 — LLM query endpoint (LLM tier) @@ -235,7 +235,7 @@ collection namespace (`observation`), cap body size, and require the staleness/Hypatia gates green before enabling. *Go-gate:* a bot can create an observation, a human can see it in -`bot-findings.vcl` output; a forged/replayed JWT fails; `STATE.a2ml` updated. +`bot-findings.vcl` output; a forged/replayed JWT fails; `ROADMAP.adoc` Phase 6 status updated. [[phase-7]] == Phase 7 — Contributor OAuth (CONTRIB tier)