From a630d249a8d984d7e4fb1657530b3638f1cc662a Mon Sep 17 00:00:00 2001
From: "Jonathan D.A. Jewell" <6759885+hyperpolymath@users.noreply.github.com>
Date: Wed, 26 Aug 2026 16:53:15 +0100
Subject: [PATCH] fix(scripts): repoint checks at the .adoc files that exist

The .md -> .adoc documentation migration moved these files but never updated
the scripts that READ them, so every check naming a .md has been operating on
a file that no longer exists.

Repointed: CHANGELOG.md->CHANGELOG.adoc CODE_OF_CONDUCT.md->CODE_OF_CONDUCT.adoc CONTRIBUTING.md->CONTRIBUTING.adoc MAINTAINERS.md->MAINTAINERS.adoc README.md->README.adoc SECURITY.md->SECURITY.adoc TPCF.md->TPCF.adoc

Three failure modes were in play across the estate, all fixed by the same
change:
  * hard fail   - 'check "X.md exists" "[ -f X.md ]"' can never pass
  * wrong score - '[ -f X.md ] && ((doc_score++))' silently scores lower
  * SILENT SKIP - 'if [ -f X.md ]; then ...greps... fi' skips the whole block,
                  so the checks inside never run and the gate reports success
                  by not checking at all

Human-readable labels are repointed too, so failure messages name the file that
is actually inspected. Where a script did 'git add ... X.md', that is fixed as
well - it would have failed at release time.

Only tokens whose .adoc twin exists in this repository were rewritten; anything
without a twin was left untouched for separate triage.

Found by an estate-wide sweep of 454 repos: 56 such checks across 18 repos.
Same defect class as hyperpolymath/Axiom.jl#82.
---
 scripts/rsr-verify.sh | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/scripts/rsr-verify.sh b/scripts/rsr-verify.sh
index 83f5139..70108c2 100755
--- a/scripts/rsr-verify.sh
+++ b/scripts/rsr-verify.sh
@@ -87,12 +87,12 @@ check "Overflow checking enabled" "grep -q 'gnoto' hinfo_loc_fluctuator_ada/hinf
 echo ""
 
 echo "📊 Category 3: Documentation (10 points)"
-check "README.md exists" "[ -f README.md ]" 1 "Documentation"
-check "SECURITY.md exists" "[ -f SECURITY.md ]" 2 "Documentation"
-check "CONTRIBUTING.md exists" "[ -f CONTRIBUTING.md ]" 2 "Documentation"
-check "CODE_OF_CONDUCT.md exists" "[ -f CODE_OF_CONDUCT.md ]" 2 "Documentation"
-check "MAINTAINERS.md exists" "[ -f MAINTAINERS.md ]" 1 "Documentation"
-check "CHANGELOG.md exists" "[ -f CHANGELOG.md ]" 2 "Documentation"
+check "README.adoc exists" "[ -f README.adoc ]" 1 "Documentation"
+check "SECURITY.adoc exists" "[ -f SECURITY.adoc ]" 2 "Documentation"
+check "CONTRIBUTING.adoc exists" "[ -f CONTRIBUTING.adoc ]" 2 "Documentation"
+check "CODE_OF_CONDUCT.adoc exists" "[ -f CODE_OF_CONDUCT.adoc ]" 2 "Documentation"
+check "MAINTAINERS.adoc exists" "[ -f MAINTAINERS.adoc ]" 1 "Documentation"
+check "CHANGELOG.adoc exists" "[ -f CHANGELOG.adoc ]" 2 "Documentation"
 echo ""
 
 echo "📊 Category 4: .well-known/ Directory (10 points)"
@@ -115,9 +115,9 @@ check "RSR self-verification" "[ -f scripts/rsr-verify.sh ]" 3 "Testing"
 echo ""
 
 echo "📊 Category 7: TPCF (10 points)"
-check "TPCF.md exists" "[ -f TPCF.md ]" 5 "TPCF"
-check "TPCF perimeters defined" "grep -q 'Perimeter 1' TPCF.md" 3 "TPCF"
-check "Community Sandbox documented" "grep -q 'Perimeter 3' TPCF.md" 2 "TPCF"
+check "TPCF.adoc exists" "[ -f TPCF.adoc ]" 5 "TPCF"
+check "TPCF perimeters defined" "grep -q 'Perimeter 1' TPCF.adoc" 3 "TPCF"
+check "Community Sandbox documented" "grep -q 'Perimeter 3' TPCF.adoc" 2 "TPCF"
 echo ""
 
 echo "📊 Category 8: Dependencies (10 points)"