From f269610babb80a6f7914eac5600c058e62396085 Mon Sep 17 00:00:00 2001
From: "Jonathan D.A. Jewell" <6759885+hyperpolymath@users.noreply.github.com>
Date: Wed, 26 Aug 2026 16:52:51 +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: MAINTAINERS.md->MAINTAINERS.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.
---
 playground/hives/me/scripts/verify-rsr.sh | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/playground/hives/me/scripts/verify-rsr.sh b/playground/hives/me/scripts/verify-rsr.sh
index c3ee0ff..3cacb3a 100755
--- a/playground/hives/me/scripts/verify-rsr.sh
+++ b/playground/hives/me/scripts/verify-rsr.sh
@@ -141,7 +141,7 @@ fi
 check_file "SECURITY.md"
 check_file "CONTRIBUTING.md"
 check_file "CODE_OF_CONDUCT.md"
-check_file "MAINTAINERS.md"
+check_file "MAINTAINERS.adoc"
 check_file "CHANGELOG.md"
 echo ""
 
@@ -223,16 +223,16 @@ echo ""
 echo "8. TPCF (Tri-Perimeter Contribution Framework)"
 echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
 
-if [ -f "MAINTAINERS.md" ]; then
-    if grep -q "Perimeter 1" MAINTAINERS.md && \
-       grep -q "Perimeter 2" MAINTAINERS.md && \
-       grep -q "Perimeter 3" MAINTAINERS.md; then
+if [ -f "MAINTAINERS.adoc" ]; then
+    if grep -q "Perimeter 1" MAINTAINERS.adoc && \
+       grep -q "Perimeter 2" MAINTAINERS.adoc && \
+       grep -q "Perimeter 3" MAINTAINERS.adoc; then
         pass "TPCF structure defined"
     else
         fail "TPCF structure incomplete"
     fi
 
-    if grep -q "Community Sandbox" MAINTAINERS.md; then
+    if grep -q "Community Sandbox" MAINTAINERS.adoc; then
         pass "Community Sandbox (Perimeter 3) active"
     else
         warn "Community Sandbox not explicitly mentioned"