ruvnet-kb-first 5.0.0

package/scripts/1.5-hooks-verify.sh

@@ -0,0 +1,252 @@
+#!/bin/bash
+# 1.5 Hooks Verify - Complete hook verification suite
+# Version 1.0.0 | Created 2026-01-01
+#
+# Runs all hook verification checks for Phase 1.5
+
+set -e
+
+echo "=== Phase 1.5: RuVector Hooks Verification ==="
+echo ""
+
+PASS_COUNT=0
+FAIL_COUNT=0
+SKIP_COUNT=0
+
+# Track results
+declare -a RESULTS
+
+check_result() {
+  local name="$1"
+  local status="$2"
+  local message="$3"
+
+  if [ "$status" = "PASS" ]; then
+    PASS_COUNT=$((PASS_COUNT + 1))
+    RESULTS+=("✅ $name: $message")
+  elif [ "$status" = "FAIL" ]; then
+    FAIL_COUNT=$((FAIL_COUNT + 1))
+    RESULTS+=("❌ $name: $message")
+  else
+    SKIP_COUNT=$((SKIP_COUNT + 1))
+    RESULTS+=("⏭️ $name: $message")
+  fi
+}
+
+# ============================================
+# Check 1: Hooks directory exists
+# ============================================
+echo "1. Checking hooks directory..."
+
+if [ -d "$HOME/.claude/hooks" ]; then
+  check_result "Hooks Directory" "PASS" "~/.claude/hooks exists"
+else
+  check_result "Hooks Directory" "FAIL" "~/.claude/hooks not found"
+fi
+
+# ============================================
+# Check 2: Hook scripts exist
+# ============================================
+echo "2. Checking hook scripts..."
+
+HOOKS_FOUND=0
+for hook in pre_tool_use post_tool_use session_end; do
+  if [ -f "$HOME/.claude/hooks/${hook}.py" ]; then
+    HOOKS_FOUND=$((HOOKS_FOUND + 1))
+  fi
+done
+
+if [ $HOOKS_FOUND -eq 3 ]; then
+  check_result "Hook Scripts" "PASS" "All 3 hook scripts found"
+elif [ $HOOKS_FOUND -gt 0 ]; then
+  check_result "Hook Scripts" "FAIL" "Only $HOOKS_FOUND/3 hook scripts found"
+else
+  check_result "Hook Scripts" "FAIL" "No hook scripts found"
+fi
+
+# ============================================
+# Check 3: Hook scripts are executable
+# ============================================
+echo "3. Checking hook permissions..."
+
+EXEC_COUNT=0
+for hook in pre_tool_use post_tool_use session_end; do
+  if [ -x "$HOME/.claude/hooks/${hook}.py" ]; then
+    EXEC_COUNT=$((EXEC_COUNT + 1))
+  fi
+done
+
+if [ $EXEC_COUNT -eq 3 ]; then
+  check_result "Hook Permissions" "PASS" "All hooks are executable"
+elif [ $EXEC_COUNT -gt 0 ]; then
+  check_result "Hook Permissions" "FAIL" "$EXEC_COUNT/3 hooks executable"
+else
+  check_result "Hook Permissions" "FAIL" "No hooks are executable"
+fi
+
+# ============================================
+# Check 4: Hook scripts have valid Python syntax
+# ============================================
+echo "4. Checking hook syntax..."
+
+SYNTAX_OK=0
+for hook in pre_tool_use post_tool_use session_end; do
+  if [ -f "$HOME/.claude/hooks/${hook}.py" ]; then
+    if python3 -m py_compile "$HOME/.claude/hooks/${hook}.py" 2>/dev/null; then
+      SYNTAX_OK=$((SYNTAX_OK + 1))
+    fi
+  fi
+done
+
+if [ $SYNTAX_OK -eq 3 ]; then
+  check_result "Hook Syntax" "PASS" "All hooks pass syntax check"
+elif [ $SYNTAX_OK -gt 0 ]; then
+  check_result "Hook Syntax" "FAIL" "$SYNTAX_OK/3 hooks have valid syntax"
+else
+  check_result "Hook Syntax" "SKIP" "No hooks to check"
+fi
+
+# ============================================
+# Check 5: Settings.json has hooks configured
+# ============================================
+echo "5. Checking settings.json..."
+
+SETTINGS_FILE="$HOME/.claude/settings.json"
+
+if [ -f "$SETTINGS_FILE" ]; then
+  if grep -q '"hooks"' "$SETTINGS_FILE" 2>/dev/null; then
+    # Check for specific hook types
+    HOOK_TYPES=$(python3 -c "
+import json
+try:
+    with open('$SETTINGS_FILE') as f:
+        s = json.load(f)
+    hooks = s.get('hooks', {})
+    print(len(hooks.keys()))
+except:
+    print(0)
+" 2>/dev/null || echo "0")
+
+    if [ "$HOOK_TYPES" -ge 3 ]; then
+      check_result "Settings Hooks" "PASS" "All 3 hook types configured"
+    elif [ "$HOOK_TYPES" -gt 0 ]; then
+      check_result "Settings Hooks" "FAIL" "Only $HOOK_TYPES hook types configured"
+    else
+      check_result "Settings Hooks" "FAIL" "Hooks key exists but empty"
+    fi
+  else
+    check_result "Settings Hooks" "FAIL" "No hooks key in settings.json"
+  fi
+else
+  check_result "Settings Hooks" "FAIL" "~/.claude/settings.json not found"
+fi
+
+# ============================================
+# Check 6: PreToolUse hook returns valid JSON
+# ============================================
+echo "6. Testing PreToolUse hook..."
+
+if [ -f "$HOME/.claude/hooks/pre_tool_use.py" ]; then
+  OUTPUT=$(echo '{"tool_name": "Write", "tool_input": {"file_path": "test.ts"}}' | \
+    python3 "$HOME/.claude/hooks/pre_tool_use.py" 2>/dev/null || echo "ERROR")
+
+  if echo "$OUTPUT" | python3 -c "import json, sys; json.load(sys.stdin)" 2>/dev/null; then
+    DECISION=$(echo "$OUTPUT" | python3 -c "import json, sys; print(json.load(sys.stdin).get('decision', ''))" 2>/dev/null)
+    if [ "$DECISION" = "continue" ] || [ "$DECISION" = "block" ]; then
+      check_result "PreToolUse Test" "PASS" "Returns valid JSON with decision"
+    else
+      check_result "PreToolUse Test" "FAIL" "Missing or invalid decision field"
+    fi
+  else
+    check_result "PreToolUse Test" "FAIL" "Does not return valid JSON"
+  fi
+else
+  check_result "PreToolUse Test" "SKIP" "Hook script not found"
+fi
+
+# ============================================
+# Check 7: ReasoningBank exists and has patterns
+# ============================================
+echo "7. Checking ReasoningBank..."
+
+REASONING_DB=".swarm/memory.db"
+
+if [ -f "$REASONING_DB" ]; then
+  PATTERN_COUNT=$(sqlite3 "$REASONING_DB" "SELECT COUNT(*) FROM reasoning_memory WHERE namespace = 'kb_first_patterns';" 2>/dev/null || echo "0")
+
+  if [ "$PATTERN_COUNT" -ge 5 ]; then
+    check_result "ReasoningBank" "PASS" "$PATTERN_COUNT KB-First patterns found"
+  elif [ "$PATTERN_COUNT" -gt 0 ]; then
+    check_result "ReasoningBank" "FAIL" "Only $PATTERN_COUNT patterns (need ≥5)"
+  else
+    check_result "ReasoningBank" "FAIL" "No KB-First patterns seeded"
+  fi
+else
+  # Check alternative location
+  GLOBAL_DB="$HOME/.claude-flow/memory.db"
+  if [ -f "$GLOBAL_DB" ]; then
+    PATTERN_COUNT=$(sqlite3 "$GLOBAL_DB" "SELECT COUNT(*) FROM reasoning_memory WHERE namespace = 'kb_first_patterns';" 2>/dev/null || echo "0")
+
+    if [ "$PATTERN_COUNT" -ge 5 ]; then
+      check_result "ReasoningBank" "PASS" "$PATTERN_COUNT patterns in global DB"
+    else
+      check_result "ReasoningBank" "FAIL" "Global DB has $PATTERN_COUNT patterns"
+    fi
+  else
+    check_result "ReasoningBank" "SKIP" "ReasoningBank not initialized"
+  fi
+fi
+
+# ============================================
+# Check 8: RuVector CLI available
+# ============================================
+echo "8. Checking RuVector CLI..."
+
+if command -v npx >/dev/null 2>&1; then
+  if npx @ruvector/cli --version >/dev/null 2>&1; then
+    VERSION=$(npx @ruvector/cli --version 2>/dev/null || echo "unknown")
+    check_result "RuVector CLI" "PASS" "Version $VERSION"
+  else
+    check_result "RuVector CLI" "SKIP" "Not installed (optional)"
+  fi
+else
+  check_result "RuVector CLI" "SKIP" "npx not available"
+fi
+
+# ============================================
+# Summary
+# ============================================
+echo ""
+echo "================================================"
+echo "RESULTS SUMMARY"
+echo "================================================"
+echo ""
+
+for result in "${RESULTS[@]}"; do
+  echo "$result"
+done
+
+echo ""
+echo "================================================"
+
+TOTAL=$((PASS_COUNT + FAIL_COUNT))
+
+if [ $FAIL_COUNT -eq 0 ] && [ $PASS_COUNT -ge 5 ]; then
+  echo "PASS: All critical checks passed ($PASS_COUNT passed, $SKIP_COUNT skipped)"
+  exit 0
+elif [ $FAIL_COUNT -eq 0 ]; then
+  echo "PARTIAL: Some checks passed ($PASS_COUNT passed, $SKIP_COUNT skipped)"
+  echo ""
+  echo "Run the following to complete setup:"
+  echo "  npx @ruvector/cli hooks init"
+  echo "  npx @ruvector/cli hooks install"
+  exit 0
+else
+  echo "FAIL: $FAIL_COUNT check(s) failed"
+  echo ""
+  echo "To fix, run:"
+  echo "  npx @ruvector/cli hooks init"
+  echo "  npx @ruvector/cli hooks install"
+  echo "  npx @ruvector/cli reasoningbank seed --kb-first"
+  exit 1
+fi

package/scripts/8.1-code-scan.sh

@@ -0,0 +1,58 @@
+#!/bin/bash
+# 8.1 Code Scan - No hardcoded values in domain logic
+# Version 1.0.0 | Created 2026-01-01
+#
+# This script scans for hardcoded numeric values in domain files.
+# All values should come from KB queries.
+
+set -e
+
+echo "=== 8.1 Code Scan: No Hardcoded Values ==="
+echo ""
+
+VIOLATIONS=0
+DOMAIN_DIR="src/domain"
+
+if [ ! -d "$DOMAIN_DIR" ]; then
+  echo "Domain directory not found: $DOMAIN_DIR"
+  echo "SKIPPED - No domain files to scan"
+  exit 0
+fi
+
+echo "Scanning $DOMAIN_DIR for hardcoded values..."
+echo ""
+
+# Pattern: variable = 0.XX or similar numeric assignments
+while IFS= read -r file; do
+  matches=$(grep -nE "= [0-9]+\.[0-9]+" "$file" 2>/dev/null || true)
+  if [ -n "$matches" ]; then
+    echo "VIOLATION in $file:"
+    echo "$matches" | while read -r line; do
+      echo "  $line"
+      VIOLATIONS=$((VIOLATIONS + 1))
+    done
+    echo ""
+  fi
+done < <(find "$DOMAIN_DIR" -name "*.ts" -o -name "*.js")
+
+# Also check for magic numbers in conditionals
+while IFS= read -r file; do
+  matches=$(grep -nE "(> [0-9]+|< [0-9]+|>= [0-9]+|<= [0-9]+|== [0-9]+)" "$file" 2>/dev/null | grep -v "\.length" || true)
+  if [ -n "$matches" ]; then
+    echo "POTENTIAL MAGIC NUMBER in $file:"
+    echo "$matches" | head -5
+    echo ""
+  fi
+done < <(find "$DOMAIN_DIR" -name "*.ts" -o -name "*.js")
+
+echo "================================================"
+if [ $VIOLATIONS -eq 0 ]; then
+  echo "PASS: No hardcoded values found"
+  exit 0
+else
+  echo "FAIL: $VIOLATIONS hardcoded value(s) found"
+  echo ""
+  echo "Fix: Replace hardcoded values with KB queries:"
+  echo "  const rate = await kb.search('withdrawal rate');"
+  exit 1
+fi

package/scripts/8.2-import-check.sh

@@ -0,0 +1,42 @@
+#!/bin/bash
+# 8.2 Import Check - All domain files import KB
+# Version 1.0.0 | Created 2026-01-01
+#
+# Every domain file must import the KB module.
+
+set -e
+
+echo "=== 8.2 Import Check: KB Import Required ==="
+echo ""
+
+VIOLATIONS=0
+DOMAIN_DIR="src/domain"
+
+if [ ! -d "$DOMAIN_DIR" ]; then
+  echo "Domain directory not found: $DOMAIN_DIR"
+  echo "SKIPPED - No domain files to check"
+  exit 0
+fi
+
+echo "Checking KB imports in $DOMAIN_DIR..."
+echo ""
+
+while IFS= read -r file; do
+  if ! grep -q "from.*kb\|import.*kb\|require.*kb" "$file" 2>/dev/null; then
+    echo "MISSING KB IMPORT: $file"
+    VIOLATIONS=$((VIOLATIONS + 1))
+  fi
+done < <(find "$DOMAIN_DIR" -name "*.ts" -o -name "*.js")
+
+echo ""
+echo "================================================"
+if [ $VIOLATIONS -eq 0 ]; then
+  echo "PASS: All domain files import KB"
+  exit 0
+else
+  echo "FAIL: $VIOLATIONS file(s) missing KB import"
+  echo ""
+  echo "Fix: Add to each domain file:"
+  echo "  import { kb } from '../kb';"
+  exit 1
+fi

package/scripts/8.3-source-returns.sh

@@ -0,0 +1,52 @@
+#!/bin/bash
+# 8.3 Source Returns - All functions return kbSources
+# Version 1.0.0 | Created 2026-01-01
+#
+# Every domain function must include kbSources in its return.
+
+set -e
+
+echo "=== 8.3 Source Returns: kbSources Required ==="
+echo ""
+
+VIOLATIONS=0
+DOMAIN_DIR="src/domain"
+
+if [ ! -d "$DOMAIN_DIR" ]; then
+  echo "Domain directory not found: $DOMAIN_DIR"
+  echo "SKIPPED - No domain files to check"
+  exit 0
+fi
+
+echo "Checking kbSources in return statements..."
+echo ""
+
+while IFS= read -r file; do
+  # Count functions that have return statements
+  RETURN_COUNT=$(grep -c "return {" "$file" 2>/dev/null || echo "0")
+
+  # Count returns that include kbSources
+  SOURCE_COUNT=$(grep -c "kbSources" "$file" 2>/dev/null || echo "0")
+
+  if [ "$RETURN_COUNT" -gt 0 ] && [ "$SOURCE_COUNT" -lt "$RETURN_COUNT" ]; then
+    echo "MISSING kbSources in $file"
+    echo "  Returns: $RETURN_COUNT, With sources: $SOURCE_COUNT"
+    VIOLATIONS=$((VIOLATIONS + 1))
+  fi
+done < <(find "$DOMAIN_DIR" -name "*.ts" -o -name "*.js")
+
+echo ""
+echo "================================================"
+if [ $VIOLATIONS -eq 0 ]; then
+  echo "PASS: All returns include kbSources"
+  exit 0
+else
+  echo "FAIL: $VIOLATIONS file(s) missing kbSources"
+  echo ""
+  echo "Fix: Add kbSources to every return:"
+  echo "  return {"
+  echo "    result: data,"
+  echo "    kbSources: sources"
+  echo "  };"
+  exit 1
+fi

package/scripts/8.4-startup-verify.sh

@@ -0,0 +1,65 @@
+#!/bin/bash
+# 8.4 Startup Verify - Entry point verifies KB connection
+# Version 1.0.0 | Created 2026-01-01
+#
+# The application entry point must verify KB connection before starting.
+
+set -e
+
+echo "=== 8.4 Startup Verify: KB Connection Check ==="
+echo ""
+
+# Find entry point
+ENTRY_POINT=""
+for file in "src/index.ts" "src/index.js" "src/main.ts" "src/app.ts" "index.ts" "index.js"; do
+  if [ -f "$file" ]; then
+    ENTRY_POINT="$file"
+    break
+  fi
+done
+
+if [ -z "$ENTRY_POINT" ]; then
+  echo "No entry point found"
+  echo "SKIPPED - Create src/index.ts or similar"
+  exit 0
+fi
+
+echo "Checking entry point: $ENTRY_POINT"
+echo ""
+
+# Check for verifyConnection call
+if grep -q "verifyConnection\|verifyKb\|checkKb\|kb\.verify\|kb\.connect" "$ENTRY_POINT"; then
+  echo "Found KB verification call"
+
+  # Check for proper error handling
+  if grep -q "process.exit(1)\|throw\|reject" "$ENTRY_POINT"; then
+    echo "Found error handling"
+    echo ""
+    echo "================================================"
+    echo "PASS: Entry point verifies KB and handles errors"
+    exit 0
+  else
+    echo ""
+    echo "================================================"
+    echo "FAIL: KB verification exists but no error handling"
+    echo ""
+    echo "Fix: Add process.exit(1) on KB failure:"
+    echo "  if (!kbOk) {"
+    echo "    console.error('KB unavailable');"
+    echo "    process.exit(1);"
+    echo "  }"
+    exit 1
+  fi
+else
+  echo ""
+  echo "================================================"
+  echo "FAIL: No KB verification at startup"
+  echo ""
+  echo "Fix: Add to entry point:"
+  echo "  const kbOk = await kb.verifyConnection();"
+  echo "  if (!kbOk) {"
+  echo "    console.error('KB unavailable');"
+  echo "    process.exit(1);"
+  echo "  }"
+  exit 1
+fi

package/scripts/8.5-fallback-check.sh

@@ -0,0 +1,63 @@
+#!/bin/bash
+# 8.5 Fallback Check - No || DEFAULT patterns
+# Version 1.0.0 | Created 2026-01-01
+#
+# Domain logic must not use fallback defaults. KB is the source of truth.
+
+set -e
+
+echo "=== 8.5 Fallback Check: No Default Values ==="
+echo ""
+
+VIOLATIONS=0
+DOMAIN_DIR="src/domain"
+
+if [ ! -d "$DOMAIN_DIR" ]; then
+  echo "Domain directory not found: $DOMAIN_DIR"
+  echo "SKIPPED - No domain files to check"
+  exit 0
+fi
+
+echo "Checking for fallback patterns in $DOMAIN_DIR..."
+echo ""
+
+# Pattern: || followed by a default value
+PATTERNS=(
+  '\|\| DEFAULT'
+  '\|\| \[\]'
+  '\|\| \{\}'
+  '\|\| null'
+  '\|\| 0'
+  '\|\| ""'
+  '\|\| '\'''\'''
+  '\?\? \[\]'
+  '\?\? \{\}'
+  '\?\? 0'
+)
+
+for pattern in "${PATTERNS[@]}"; do
+  while IFS= read -r file; do
+    matches=$(grep -n "$pattern" "$file" 2>/dev/null || true)
+    if [ -n "$matches" ]; then
+      echo "FALLBACK PATTERN in $file:"
+      echo "$matches" | while read -r line; do
+        echo "  $line"
+        VIOLATIONS=$((VIOLATIONS + 1))
+      done
+    fi
+  done < <(find "$DOMAIN_DIR" -name "*.ts" -o -name "*.js")
+done
+
+echo ""
+echo "================================================"
+if [ $VIOLATIONS -eq 0 ]; then
+  echo "PASS: No fallback patterns found"
+  exit 0
+else
+  echo "FAIL: Fallback patterns detected"
+  echo ""
+  echo "Fix: Remove fallbacks, require KB to have the data:"
+  echo "  // BAD: const rate = kbRate || 0.04;"
+  echo "  // GOOD: const rate = kbRate; // KB required"
+  exit 1
+fi

package/scripts/8.6-attribution.sh

@@ -0,0 +1,56 @@
+#!/bin/bash
+# 8.6 Attribution - All KB nodes have source_expert
+# Version 1.0.0 | Created 2026-01-01
+#
+# Every KB node must be attributed to an expert source.
+
+set -e
+
+echo "=== 8.6 Attribution: Expert Sources Required ==="
+echo ""
+
+if [ -z "$DATABASE_URL" ]; then
+  echo "DATABASE_URL not set"
+  echo "SKIPPED - Cannot connect to database"
+  exit 0
+fi
+
+echo "Checking KB node attribution..."
+echo ""
+
+# Count nodes without attribution
+RESULT=$(psql "$DATABASE_URL" -t -c "
+  SELECT
+    COUNT(*) as total,
+    SUM(CASE WHEN source_expert IS NULL OR source_expert = '' THEN 1 ELSE 0 END) as missing
+  FROM kb_nodes;
+" 2>/dev/null || echo "0|0")
+
+TOTAL=$(echo "$RESULT" | cut -d'|' -f1 | tr -d ' ')
+MISSING=$(echo "$RESULT" | cut -d'|' -f2 | tr -d ' ')
+
+if [ "$TOTAL" = "0" ]; then
+  echo "No KB nodes found"
+  echo "SKIPPED - KB is empty"
+  exit 0
+fi
+
+PERCENTAGE=$((100 - (MISSING * 100 / TOTAL)))
+
+echo "Total nodes: $TOTAL"
+echo "Missing attribution: $MISSING"
+echo "Attribution rate: $PERCENTAGE%"
+echo ""
+echo "================================================"
+
+if [ "$MISSING" -eq 0 ]; then
+  echo "PASS: All nodes have expert attribution"
+  exit 0
+else
+  echo "FAIL: $MISSING node(s) missing attribution"
+  echo ""
+  echo "Fix: Update nodes with source_expert:"
+  echo "  UPDATE kb_nodes SET source_expert = 'Expert Name'"
+  echo "  WHERE source_expert IS NULL;"
+  exit 1
+fi

package/scripts/8.7-confidence.sh

@@ -0,0 +1,56 @@
+#!/bin/bash
+# 8.7 Confidence - All KB nodes have confidence scores
+# Version 1.0.0 | Created 2026-01-01
+#
+# Every KB node must have a confidence score (0.0 - 1.0).
+
+set -e
+
+echo "=== 8.7 Confidence: Confidence Scores Required ==="
+echo ""
+
+if [ -z "$DATABASE_URL" ]; then
+  echo "DATABASE_URL not set"
+  echo "SKIPPED - Cannot connect to database"
+  exit 0
+fi
+
+echo "Checking KB node confidence scores..."
+echo ""
+
+# Check for nodes without confidence
+RESULT=$(psql "$DATABASE_URL" -t -c "
+  SELECT
+    COUNT(*) as total,
+    SUM(CASE WHEN confidence IS NULL OR confidence = 0 THEN 1 ELSE 0 END) as missing,
+    COALESCE(AVG(confidence), 0) as avg_confidence
+  FROM kb_nodes;
+" 2>/dev/null || echo "0|0|0")
+
+TOTAL=$(echo "$RESULT" | cut -d'|' -f1 | tr -d ' ')
+MISSING=$(echo "$RESULT" | cut -d'|' -f2 | tr -d ' ')
+AVG=$(echo "$RESULT" | cut -d'|' -f3 | tr -d ' ')
+
+if [ "$TOTAL" = "0" ]; then
+  echo "No KB nodes found"
+  echo "SKIPPED - KB is empty"
+  exit 0
+fi
+
+echo "Total nodes: $TOTAL"
+echo "Missing confidence: $MISSING"
+echo "Average confidence: $AVG"
+echo ""
+echo "================================================"
+
+if [ "$MISSING" -eq 0 ]; then
+  echo "PASS: All nodes have confidence scores"
+  exit 0
+else
+  echo "FAIL: $MISSING node(s) missing confidence"
+  echo ""
+  echo "Fix: Update nodes with confidence:"
+  echo "  UPDATE kb_nodes SET confidence = 0.85"
+  echo "  WHERE confidence IS NULL OR confidence = 0;"
+  exit 1
+fi