From 016d5e9d149547612f051dbe77800302401dfcc0 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:28 +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: CONTRIBUTING.md->CONTRIBUTING.adoc MAINTAINERS.md->MAINTAINERS.adoc README.md->README.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/check-rsr-compliance.sh | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/scripts/check-rsr-compliance.sh b/scripts/check-rsr-compliance.sh
index e3104e3..043319a 100755
--- a/scripts/check-rsr-compliance.sh
+++ b/scripts/check-rsr-compliance.sh
@@ -73,13 +73,13 @@ echo ""
 
 # Category 1: Documentation
 print_header "1. Documentation Compliance"
-check_file "README.md"
+check_file "README.adoc"
 check_file "LICENSE"
 check_file "LICENSE-PALIMPSEST.txt"
 check_file "SECURITY.md"
 check_file "CODE_OF_CONDUCT.md"
-check_file "CONTRIBUTING.md"
-check_file "MAINTAINERS.md"
+check_file "CONTRIBUTING.adoc"
+check_file "MAINTAINERS.adoc"
 check_file "CHANGELOG.md"
 echo ""
 
@@ -199,22 +199,22 @@ echo ""
 
 # Category 10: Community Governance (TPCF)
 print_header "10. Tri-Perimeter Contribution Framework (TPCF)"
-if grep -q -i "perimeter" MAINTAINERS.md 2>/dev/null; then
-    check_pass "TPCF perimeter definitions found in MAINTAINERS.md"
+if grep -q -i "perimeter" MAINTAINERS.adoc 2>/dev/null; then
+    check_pass "TPCF perimeter definitions found in MAINTAINERS.adoc"
 else
     check_warn "TPCF perimeter definitions not clearly documented"
 fi
 
-if grep -q -i "perimeter" CONTRIBUTING.md 2>/dev/null; then
-    check_pass "TPCF mentioned in CONTRIBUTING.md"
+if grep -q -i "perimeter" CONTRIBUTING.adoc 2>/dev/null; then
+    check_pass "TPCF mentioned in CONTRIBUTING.adoc"
 else
-    check_warn "TPCF should be mentioned in CONTRIBUTING.md"
+    check_warn "TPCF should be mentioned in CONTRIBUTING.adoc"
 fi
 echo ""
 
 # Category 11: Offline-First
 print_header "11. Offline-First Capabilities"
-if grep -q -i "cache" README.md 2>/dev/null || grep -q -i "offline" README.md 2>/dev/null; then
+if grep -q -i "cache" README.adoc 2>/dev/null || grep -q -i "offline" README.adoc 2>/dev/null; then
     check_pass "Caching/offline capabilities mentioned"
 else
     check_warn "Limited offline-first support (requires network APIs)"