feat: add test infrastructure and gitbot-fleet integration

Jonathan D.A. Jewell · claude · Jonathan D.A. Jewell · commit 8708e908ac81 · 2026-02-07T13:16:22.000Z
Infrastructure for testing, validation, and bot automation:

1. Bot Directives (.bot_directives/):
   - README.scm - Overview and constraints
   - rhodibot.scm - RSR compliance, repository operations
   - echidnabot.scm - Framework consistency verification
   - glambot.scm - Documentation quality and accessibility
   - sustainabot.scm - Sustainability and community health
   - seambot.scm - Integration and tooling (Hypatia, gitbot-fleet)
   - finishbot.scm - Task completion and milestone tracking
   - robot-repo-automaton.scm - Automated fixes with confidence thresholds

   All bots configured to protect PROMPT framework and heutagogic design.

2. Test Suite (tests/):
   - validate-framework.sh - PROMPT framework, boundary objects, learning pathway
   - validate-documentation.sh - Author attribution, license, consistency
   - validate-installation.sh - Workflows, directory structure, scanning integration
   - run-all-tests.sh - Master test runner

   All tests passing ✅

3. Justfile Updates:
   - test, test-framework, test-docs, test-install commands
   - rsr-check - Verify RSR compliance
   - verify-scanning - Check Hypatia and gitbot-fleet integration
   - validate - Full validation suite

4. License Fixes:
   - Updated .gitattributes, .gitignore, Mustfile to PMPL-1.0-or-later
   - Removed all AGPL-3.0-or-later references

Hypatia scan and gitbot-fleet integration confirmed working.

Co-Authored-By: Claude Sonnet 4.5 &lt;noreply@anthropic.com&gt;
diff --git a/.bot_directives/README.scm b/.bot_directives/README.scm
@@ -0,0 +1,11 @@
+;; SPDX-License-Identifier: PMPL-1.0-or-later
+;; .bot_directives — per-bot rules and constraints for Wayfinder
+;; Media-Type: application/vnd.bot-directives+scm
+
+(bot-directives
+  (version "1.0")
+  (project "Wayfinder: Epistemic Infrastructure for Journalism")
+  (notes
+    "Repo-specific bot constraints for documentation-focused project."
+    "Bots must preserve PROMPT framework integrity and heutagogic design."
+    "Protect core conceptual frameworks while enabling documentation improvements."))
diff --git a/.bot_directives/echidnabot.scm b/.bot_directives/echidnabot.scm
@@ -0,0 +1,7 @@
+;; SPDX-License-Identifier: PMPL-1.0-or-later
+(bot-directive
+  (bot "echidnabot")
+  (scope "formal verification and conceptual consistency")
+  (allow ("framework consistency checks" "logical coherence analysis" "citation verification"))
+  (deny ("framework modifications" "conceptual changes"))
+  (notes "Verify PROMPT framework consistency, boundary objects coherence, heutagogic pathway logic. Report only, no auto-fix."))
diff --git a/.bot_directives/finishbot.scm b/.bot_directives/finishbot.scm
@@ -0,0 +1,7 @@
+;; SPDX-License-Identifier: PMPL-1.0-or-later
+(bot-directive
+  (bot "finishbot")
+  (scope "task completion and milestone tracking")
+  (allow ("STATE.scm updates" "ROADMAP.adoc progress tracking" "milestone completion verification"))
+  (deny ("milestone reordering" "deadline changes without approval"))
+  (notes "Track Week 1-4 plan progress. Update STATE.scm as materials complete. Report blockers."))
diff --git a/.bot_directives/glambot.scm b/.bot_directives/glambot.scm
@@ -0,0 +1,7 @@
+;; SPDX-License-Identifier: PMPL-1.0-or-later
+(bot-directive
+  (bot "glambot")
+  (scope "documentation quality and accessibility")
+  (allow ("grammar fixes" "clarity improvements" "accessibility enhancements" "progressive disclosure optimization"))
+  (deny ("conceptual framework changes" "learning pathway reordering"))
+  (notes "Improve documentation quality while preserving epistemic frameworks. WCAG 2.1 AA compliance required."))
diff --git a/.bot_directives/rhodibot.scm b/.bot_directives/rhodibot.scm
@@ -0,0 +1,7 @@
+;; SPDX-License-Identifier: PMPL-1.0-or-later
+(bot-directive
+  (bot "rhodibot")
+  (scope "rsr-compliance and repository operations")
+  (allow ("metadata updates" "documentation formatting" "repo-structure checks" "citation fixes"))
+  (deny ("PROMPT framework modifications" "core conceptual changes" "destructive edits without approval"))
+  (notes "Auto-fix allowed for formatting, citations, and RSR compliance. Core frameworks require review."))
diff --git a/.bot_directives/robot-repo-automaton.scm b/.bot_directives/robot-repo-automaton.scm
@@ -0,0 +1,7 @@
+;; SPDX-License-Identifier: PMPL-1.0-or-later
+(bot-directive
+  (bot "robot-repo-automaton")
+  (scope "automated fixes with confidence thresholds")
+  (allow ("formatting fixes (confidence > 0.95)" "citation standardization (confidence > 0.90)" "typo fixes (confidence > 0.85)"))
+  (deny ("conceptual changes" "framework modifications" "low-confidence fixes"))
+  (notes "Only auto-fix documentation issues with high confidence. PROMPT framework is protected. Learning materials require review."))
diff --git a/.bot_directives/seambot.scm b/.bot_directives/seambot.scm
@@ -0,0 +1,7 @@
+;; SPDX-License-Identifier: PMPL-1.0-or-later
+(bot-directive
+  (bot "seambot")
+  (scope "integration and tooling")
+  (allow ("workflow optimization" "CI/CD improvements" "cross-repo consistency"))
+  (deny ("hypatia scan removal" "security workflow modifications"))
+  (notes "Ensure Hypatia and gitbot-fleet integration. Maintain RSR compliance. GitLab Pages deployment."))
diff --git a/.bot_directives/sustainabot.scm b/.bot_directives/sustainabot.scm
@@ -0,0 +1,7 @@
+;; SPDX-License-Identifier: PMPL-1.0-or-later
+(bot-directive
+  (bot "sustainabot")
+  (scope "sustainability and community health")
+  (allow ("community metrics" "contributor onboarding docs" "sustainability reporting"))
+  (deny ("governance changes" "funding model changes"))
+  (notes "Monitor community health, beta tester engagement, journalist feedback. Recommend improvements."))
diff --git a/.gitattributes b/.gitattributes
@@ -1,4 +1,4 @@
-# SPDX-License-Identifier: AGPL-3.0-or-later
+# SPDX-License-Identifier: PMPL-1.0-or-later
 # RSR-compliant .gitattributes
 
 * text=auto eol=lf
diff --git a/.gitignore b/.gitignore
@@ -1,4 +1,4 @@
-# SPDX-License-Identifier: AGPL-3.0-or-later
+# SPDX-License-Identifier: PMPL-1.0-or-later
 # RSR-compliant .gitignore
 
 # OS & Editor
diff --git a/Mustfile b/Mustfile
@@ -1,4 +1,4 @@
-# SPDX-License-Identifier: AGPL-3.0-or-later
+# SPDX-License-Identifier: PMPL-1.0-or-later
 # Mustfile - hyperpolymath mandatory checks
 # See: https://github.com/hyperpolymath/mustfile
 
diff --git a/justfile b/justfile
@@ -1,29 +1,67 @@
-# im-docs - Development Tasks
+# SPDX-License-Identifier: PMPL-1.0-or-later
+# Wayfinder (im-docs) - Development Tasks
 set shell := ["bash", "-uc"]
 set dotenv-load := true
 
-project := "im-docs"
+project := "wayfinder"
 
 # Show all recipes
 default:
     @just --list --unsorted
 
-# Build
-build:
-    @echo "TODO: Add build command"
-
-# Test
+# Run all validation tests
 test:
-    @echo "TODO: Add test command"
+    @./tests/run-all-tests.sh
+
+# Validate framework integrity (PROMPT, boundary objects, heutagogic design)
+test-framework:
+    @./tests/validate-framework.sh
+
+# Validate documentation consistency
+test-docs:
+    @./tests/validate-documentation.sh
+
+# Validate installation and setup
+test-install:
+    @./tests/validate-installation.sh
 
-# Clean
+# Build documentation (placeholder for future AsciiDoc → HTML conversion)
+build:
+    @echo "📚 Building documentation..."
+    @echo "✓ AsciiDoc documentation ready"
+    @echo "Note: HTML generation will be added in Phase 2"
+
+# Clean generated files
 clean:
-    @echo "TODO: Add clean command"
+    @echo "🧹 Cleaning generated files..."
+    @rm -f hypatia-findings.json hypatia-report.md
+    @echo "✓ Clean complete"
 
-# Format
+# Format documentation
 fmt:
-    @echo "TODO: Add format command"
+    @echo "📝 Formatting documentation..."
+    @echo "Note: AsciiDoc formatting will be automated in Phase 2"
+
+# Lint documentation and check consistency
+lint: test-docs test-framework
+    @echo "✅ Lint complete"
+
+# Check RSR compliance
+rsr-check:
+    @echo "🔍 Checking RSR compliance..."
+    @[ -d .machine_readable ] || (echo "❌ Missing .machine_readable/" && exit 1)
+    @[ -d .bot_directives ] || (echo "❌ Missing .bot_directives/" && exit 1)
+    @[ -f 0-AI-MANIFEST.a2ml ] || (echo "❌ Missing AI manifest" && exit 1)
+    @[ $$(find .github/workflows -name "*.yml" | wc -l) -eq 17 ] || (echo "❌ Wrong workflow count" && exit 1)
+    @echo "✅ RSR compliant"
+
+# Verify Hypatia and gitbot-fleet integration
+verify-scanning:
+    @echo "🔍 Verifying scanning infrastructure..."
+    @grep -q "hyperpolymath/hypatia" .github/workflows/hypatia-scan.yml && echo "✓ Hypatia configured" || echo "❌ Hypatia missing"
+    @grep -q "gitbot-fleet" .github/workflows/hypatia-scan.yml && echo "✓ gitbot-fleet integrated" || echo "❌ gitbot-fleet missing"
+    @[ -d .bot_directives ] && echo "✓ Bot directives present" || echo "❌ Bot directives missing"
 
-# Lint
-lint:
-    @echo "TODO: Add lint command"
+# Full validation (all checks)
+validate: test rsr-check verify-scanning
+    @echo "🎉 Full validation complete!"
diff --git a/tests/run-all-tests.sh b/tests/run-all-tests.sh
@@ -0,0 +1,50 @@
+#!/usr/bin/env bash
+# SPDX-License-Identifier: PMPL-1.0-or-later
+# run-all-tests.sh - Run all validation tests
+
+set -euo pipefail
+
+echo "🧪 Running All Validation Tests for Wayfinder..."
+echo ""
+
+FAILED_TESTS=0
+
+# Run framework validation
+echo "═══════════════════════════════════════════════"
+if ./tests/validate-framework.sh; then
+    echo "✅ Framework validation passed"
+else
+    echo "❌ Framework validation failed"
+    ((FAILED_TESTS++))
+fi
+echo ""
+
+# Run documentation validation
+echo "═══════════════════════════════════════════════"
+if ./tests/validate-documentation.sh; then
+    echo "✅ Documentation validation passed"
+else
+    echo "❌ Documentation validation failed"
+    ((FAILED_TESTS++))
+fi
+echo ""
+
+# Run installation validation
+echo "═══════════════════════════════════════════════"
+if ./tests/validate-installation.sh; then
+    echo "✅ Installation validation passed"
+else
+    echo "❌ Installation validation failed"
+    ((FAILED_TESTS++))
+fi
+echo ""
+
+# Summary
+echo "═══════════════════════════════════════════════"
+if [ $FAILED_TESTS -eq 0 ]; then
+    echo "🎉 All validation tests passed! Wayfinder is ready."
+    exit 0
+else
+    echo "💥 $FAILED_TESTS test suite(s) failed."
+    exit 1
+fi
diff --git a/tests/validate-documentation.sh b/tests/validate-documentation.sh
@@ -0,0 +1,80 @@
+#!/usr/bin/env bash
+# SPDX-License-Identifier: PMPL-1.0-or-later
+# validate-documentation.sh - Validate documentation consistency
+
+set -euo pipefail
+
+echo "📚 Validating Documentation Consistency..."
+
+ERRORS=0
+
+# Test 1: Author attribution
+echo "✓ Checking author attribution..."
+if grep -r "Hyper Polymath" . --exclude-dir=.git --exclude-dir=tests 2>/dev/null | grep -v ".bot_directives" | grep -q .; then
+    echo "  ✗ Found 'Hyper Polymath' instead of 'Jonathan D.A. Jewell'"
+    ((ERRORS++))
+fi
+
+# Test 2: License consistency
+echo "✓ Checking license consistency..."
+if grep -r "AGPL-3.0" . --exclude-dir=.git --exclude-dir=tests 2>/dev/null | grep -q .; then
+    echo "  ✗ Found outdated AGPL-3.0 license"
+    ((ERRORS++))
+fi
+
+# Test 3: SPDX headers
+echo "✓ Checking SPDX headers..."
+for file in README.adoc ROADMAP.adoc CHANGELOG.adoc; do
+    if [ -f "$file" ] && ! grep -q "SPDX-License-Identifier: PMPL-1.0-or-later" "$file"; then
+        echo "  ✗ Missing SPDX header in $file"
+        ((ERRORS++))
+    fi
+done
+
+# Test 4: Required documentation files
+echo "✓ Checking required documentation files..."
+REQUIRED_DOCS=("README.adoc" "CHANGELOG.adoc" "ROADMAP.adoc" "CONTRIBUTING.adoc"
+               "CODE_OF_CONDUCT.md" "SECURITY.md" "LICENSE")
+for doc in "${REQUIRED_DOCS[@]}"; do
+    if [ ! -f "$doc" ]; then
+        echo "  ✗ Missing required documentation: $doc"
+        ((ERRORS++))
+    fi
+done
+
+# Test 5: AI manifest
+echo "✓ Checking AI manifest..."
+if [ ! -f "0-AI-MANIFEST.a2ml" ]; then
+    echo "  ✗ Missing AI manifest"
+    ((ERRORS++))
+fi
+
+# Test 6: Link validity (basic check for broken internal links)
+echo "✓ Checking internal links..."
+for file in *.adoc *.md; do
+    if [ -f "$file" ]; then
+        while IFS= read -r link; do
+            target=$(echo "$link" | sed -n 's/.*link:\([^[]*\).*/\1/p' | sed 's/^\.\///')
+            if [ -n "$target" ] && [ ! -f "$target" ] && [ ! -d "$target" ]; then
+                echo "  ⚠ Possibly broken link in $file: $target"
+            fi
+        done < <(grep -o 'link:[^[]*\[' "$file" 2>/dev/null || true)
+    fi
+done
+
+# Test 7: Project name consistency
+echo "✓ Checking project name consistency..."
+if ! grep -q "Wayfinder" README.adoc; then
+    echo "  ✗ README missing 'Wayfinder' project name"
+    ((ERRORS++))
+fi
+
+# Summary
+echo ""
+if [ $ERRORS -eq 0 ]; then
+    echo "✅ All documentation validation tests passed!"
+    exit 0
+else
+    echo "❌ Documentation validation failed with $ERRORS error(s)"
+    exit 1
+fi
diff --git a/tests/validate-framework.sh b/tests/validate-framework.sh
@@ -0,0 +1,80 @@
+#!/usr/bin/env bash
+# SPDX-License-Identifier: PMPL-1.0-or-later
+# validate-framework.sh - Validate Wayfinder framework integrity
+
+set -euo pipefail
+
+echo "🔍 Validating Wayfinder Framework Integrity..."
+
+ERRORS=0
+
+# Test 1: PROMPT framework dimensions
+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
+        echo "  ✗ Missing PROMPT dimension: $dim"
+        ((ERRORS++))
+    fi
+done
+
+# Test 2: Four-layer knowledge pipeline
+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
+        echo "  ✗ Missing knowledge layer: $layer"
+        ((ERRORS++))
+    fi
+done
+
+# Test 3: Heutagogic learning pathway (4 levels)
+echo "✓ Checking heutagogic learning pathway..."
+if ! grep -E "Level (1|2A|2B|3|4)" README.adoc >/dev/null 2>&1; then
+    echo "  ✗ Learning pathway incomplete"
+    ((ERRORS++))
+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
+    echo "  ✗ Missing boundary objects theory"
+    ((ERRORS++))
+fi
+
+# Test 5: Cognitive science integration
+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
+        echo "  ✗ Missing cognitive concept: $concept"
+        ((ERRORS++))
+    fi
+done
+
+# Test 6: .machine_readable/ structure
+echo "✓ Checking .machine_readable/ structure..."
+REQUIRED_SCM=("STATE.scm" "META.scm" "ECOSYSTEM.scm" "AGENTIC.scm" "NEUROSYM.scm" "PLAYBOOK.scm")
+for scm in "${REQUIRED_SCM[@]}"; do
+    if [ ! -f ".machine_readable/$scm" ]; then
+        echo "  ✗ Missing SCM file: $scm"
+        ((ERRORS++))
+    fi
+done
+
+# Test 7: Bot directives
+echo "✓ Checking bot directives..."
+if [ ! -d ".bot_directives" ]; then
+    echo "  ✗ Missing .bot_directives directory"
+    ((ERRORS++))
+fi
+
+# Summary
+echo ""
+if [ $ERRORS -eq 0 ]; then
+    echo "✅ All framework validation tests passed!"
+    exit 0
+else
+    echo "❌ Framework validation failed with $ERRORS error(s)"
+    exit 1
+fi
diff --git a/tests/validate-installation.sh b/tests/validate-installation.sh

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-# SPDX-License-Identifier: AGPL-3.0-or-later`
	`1`	`+# SPDX-License-Identifier: PMPL-1.0-or-later`
`2`	`2`	`# RSR-compliant .gitattributes`
`3`	`3`
`4`	`4`	`* text=auto eol=lf`