From 281eb22219757e370dd79ef69a09b28dbd62a9cd 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:57 +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: 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.
---
 install.sh | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/install.sh b/install.sh
index 9eabf61..ee08b30 100755
--- a/install.sh
+++ b/install.sh
@@ -100,7 +100,7 @@ copy_files() {
     cp network-repair "${INSTALL_DIR}/"
 
     # Copy documentation
-    [[ -f README.md ]] && cp README.md "${INSTALL_DIR}/"
+    [[ -f README.adoc ]] && cp README.adoc "${INSTALL_DIR}/"
     [[ -f LICENSE ]] && cp LICENSE "${INSTALL_DIR}/"
 
     print_msg "${GREEN}" "Files copied"