Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 10 additions & 5 deletions .github/workflows/rhodibot.yml
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
2 changes: 1 addition & 1 deletion .machine_readable/ai/.clinerules
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
16 changes: 10 additions & 6 deletions .machine_readable/svc/k9/examples/setup-repo.k9.ncl
Original file line number Diff line number Diff line change
Expand Up @@ -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
# <repo>_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
Expand Down Expand Up @@ -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 <repo>_chora.deed and .machine_readable/descriptiles/STATE.deed by hand' && exit 1",
],
},

Expand Down
7 changes: 6 additions & 1 deletion docs/RSR_OUTLINE.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -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]`

Expand Down
16 changes: 8 additions & 8 deletions docs/governance/RELEASE-RUNBOOK.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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*

Expand All @@ -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).
Expand Down Expand Up @@ -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.
Expand All @@ -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)
Expand Down Expand Up @@ -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)
Expand Down
Loading