From 459ebd64d44e35a99f19b147518fbb8efd5e9f35 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:39 +0100
Subject: [PATCH 1/3] 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: claude.md->claude.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.
---
 tests/validate-framework.sh | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/tests/validate-framework.sh b/tests/validate-framework.sh
index 58ac938..3558093 100755
--- a/tests/validate-framework.sh
+++ b/tests/validate-framework.sh
@@ -12,7 +12,7 @@ ERRORS=0
 echo "✓ Checking PROMPT framework (6 dimensions)..."
 PROMPT_DIMS=("Provenance" "Relevance" "Objectivity" "Methods" "Perspective" "Timeliness")
 for dim in "${PROMPT_DIMS[@]}"; do
-    if ! grep -r "$dim" README.adoc claude.md >/dev/null 2>&1; then
+    if ! grep -r "$dim" README.adoc claude.adoc >/dev/null 2>&1; then
         echo "  ✗ Missing PROMPT dimension: $dim"
         ((ERRORS++))
     fi
@@ -22,7 +22,7 @@ done
 echo "✓ Checking four-layer knowledge pipeline..."
 LAYERS=("Data Layer" "Knowledge Layer" "Intelligence Layer" "Wisdom Layer")
 for layer in "${LAYERS[@]}"; do
-    if ! grep -r "$layer" README.adoc claude.md >/dev/null 2>&1; then
+    if ! grep -r "$layer" README.adoc claude.adoc >/dev/null 2>&1; then
         echo "  ✗ Missing knowledge layer: $layer"
         ((ERRORS++))
     fi
@@ -37,7 +37,7 @@ fi
 
 # Test 4: Boundary objects theory reference
 echo "✓ Checking boundary objects theory..."
-if ! grep -i "boundary object" README.adoc claude.md >/dev/null 2>&1; then
+if ! grep -i "boundary object" README.adoc claude.adoc >/dev/null 2>&1; then
     echo "  ✗ Missing boundary objects theory"
     ((ERRORS++))
 fi
@@ -46,7 +46,7 @@ fi
 echo "✓ Checking cognitive science integration..."
 COGNITIVE_CONCEPTS=("cognitive load" "progressive disclosure" "motivated reasoning")
 for concept in "${COGNITIVE_CONCEPTS[@]}"; do
-    if ! grep -i "$concept" claude.md >/dev/null 2>&1; then
+    if ! grep -i "$concept" claude.adoc >/dev/null 2>&1; then
         echo "  ✗ Missing cognitive concept: $concept"
         ((ERRORS++))
     fi

From 5e41ffccfcec2465f4f9c2dc30c2b4a240ec3cb5 Mon Sep 17 00:00:00 2001
From: "Jonathan D.A. Jewell" <6759885+hyperpolymath@users.noreply.github.com>
Date: Wed, 26 Aug 2026 17:14:56 +0100
Subject: [PATCH 2/3] Update tests/validate-framework.sh

Co-authored-by: codacy-production[bot] <61871480+codacy-production[bot]@users.noreply.github.com>
Signed-off-by: Jonathan D.A. Jewell <6759885+hyperpolymath@users.noreply.github.com>
---
 tests/validate-framework.sh | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/validate-framework.sh b/tests/validate-framework.sh
index 3558093..a748f12 100755
--- a/tests/validate-framework.sh
+++ b/tests/validate-framework.sh
@@ -22,7 +22,7 @@ done
 echo "✓ Checking four-layer knowledge pipeline..."
 LAYERS=("Data Layer" "Knowledge Layer" "Intelligence Layer" "Wisdom Layer")
 for layer in "${LAYERS[@]}"; do
-    if ! grep -r "$layer" README.adoc claude.adoc >/dev/null 2>&1; then
+    if ! grep -qi "$layer" README.adoc claude.adoc; then
         echo "  ✗ Missing knowledge layer: $layer"
         ((ERRORS++))
     fi

From 8c6847044144cfe491a5b30a2bcc14918ce445c9 Mon Sep 17 00:00:00 2001
From: "Jonathan D.A. Jewell" <6759885+hyperpolymath@users.noreply.github.com>
Date: Wed, 26 Aug 2026 17:15:07 +0100
Subject: [PATCH 3/3] Update tests/validate-framework.sh

Co-authored-by: codacy-production[bot] <61871480+codacy-production[bot]@users.noreply.github.com>
Signed-off-by: Jonathan D.A. Jewell <6759885+hyperpolymath@users.noreply.github.com>
---
 tests/validate-framework.sh | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/validate-framework.sh b/tests/validate-framework.sh
index a748f12..b382a42 100755
--- a/tests/validate-framework.sh
+++ b/tests/validate-framework.sh
@@ -12,7 +12,7 @@ ERRORS=0
 echo "✓ Checking PROMPT framework (6 dimensions)..."
 PROMPT_DIMS=("Provenance" "Relevance" "Objectivity" "Methods" "Perspective" "Timeliness")
 for dim in "${PROMPT_DIMS[@]}"; do
-    if ! grep -r "$dim" README.adoc claude.adoc >/dev/null 2>&1; then
+    if ! grep -qi "$dim" README.adoc claude.adoc; then
         echo "  ✗ Missing PROMPT dimension: $dim"
         ((ERRORS++))
     fi