claude-flow 3.42.2 → 3.42.3

package/.claude/helpers/github-setup.sh

@@ -1,45 +1,45 @@
-#!/bin/bash
-# Security rationale: set -euo pipefail ensures that:
-#   -e  — exit immediately if any command fails (no silent failures)
-#   -u  — treat unset variables as errors (prevents empty-string expansion bugs)
-#   -o pipefail — pipeline fails if any command in it fails (not just last)
-# This matches the ADR-127 Phase 2 requirement for github-setup.sh hardening.
-set -euo pipefail
-
-# Setup GitHub integration for Claude Flow
-
-echo "Setting up GitHub integration..."
-
-# Check for gh CLI
-if ! command -v gh &> /dev/null; then
-    echo "WARNING: GitHub CLI (gh) not found"
-    echo "Install from: https://cli.github.com/"
-    echo "Continuing without GitHub features..."
-else
-    echo "OK: GitHub CLI found"
-
-    # Check auth status and scope sufficiency.
-    # `gh auth status` exits non-zero when not authenticated.
-    # We additionally parse for "Token scopes" to verify we have at least
-    # 'repo' scope, which is required for PR/issue operations.
-    if gh auth status 2>&1 | grep -q "Logged in"; then
-        echo "OK: GitHub authentication active"
-        # Verify repo scope is present for PR/issue operations.
-        if gh auth status 2>&1 | grep -q "repo"; then
-            echo "OK: 'repo' scope available"
-        else
-            echo "WARNING: 'repo' scope not confirmed — PR/issue operations may fail"
-            echo "Run: gh auth login --scopes repo,read:org"
-        fi
-    else
-        echo "WARNING: Not authenticated with GitHub"
-        echo "Run: gh auth login"
-    fi
-fi
-
-echo ""
-echo "GitHub swarm commands available:"
-echo "  - npx claude-flow github swarm"
-echo "  - npx claude-flow repo analyze"
-echo "  - npx claude-flow pr enhance"
-echo "  - npx claude-flow issue triage"
+#!/bin/bash
+# Security rationale: set -euo pipefail ensures that:
+#   -e  — exit immediately if any command fails (no silent failures)
+#   -u  — treat unset variables as errors (prevents empty-string expansion bugs)
+#   -o pipefail — pipeline fails if any command in it fails (not just last)
+# This matches the ADR-127 Phase 2 requirement for github-setup.sh hardening.
+set -euo pipefail
+
+# Setup GitHub integration for Claude Flow
+
+echo "Setting up GitHub integration..."
+
+# Check for gh CLI
+if ! command -v gh &> /dev/null; then
+    echo "WARNING: GitHub CLI (gh) not found"
+    echo "Install from: https://cli.github.com/"
+    echo "Continuing without GitHub features..."
+else
+    echo "OK: GitHub CLI found"
+
+    # Check auth status and scope sufficiency.
+    # `gh auth status` exits non-zero when not authenticated.
+    # We additionally parse for "Token scopes" to verify we have at least
+    # 'repo' scope, which is required for PR/issue operations.
+    if gh auth status 2>&1 | grep -q "Logged in"; then
+        echo "OK: GitHub authentication active"
+        # Verify repo scope is present for PR/issue operations.
+        if gh auth status 2>&1 | grep -q "repo"; then
+            echo "OK: 'repo' scope available"
+        else
+            echo "WARNING: 'repo' scope not confirmed — PR/issue operations may fail"
+            echo "Run: gh auth login --scopes repo,read:org"
+        fi
+    else
+        echo "WARNING: Not authenticated with GitHub"
+        echo "Run: gh auth login"
+    fi
+fi
+
+echo ""
+echo "GitHub swarm commands available:"
+echo "  - npx claude-flow github swarm"
+echo "  - npx claude-flow repo analyze"
+echo "  - npx claude-flow pr enhance"
+echo "  - npx claude-flow issue triage"

package/.claude/helpers/guidance-hook.sh

@@ -1,13 +1,13 @@
-#!/bin/bash
-# Capture hook guidance for Claude visibility
-GUIDANCE_FILE=".claude-flow/last-guidance.txt"
-mkdir -p .claude-flow
-
-case "$1" in
-  "route")
-    npx agentic-flow@alpha hooks route "$2" 2>&1 | tee "$GUIDANCE_FILE"
-    ;;
-  "pre-edit")
-    npx agentic-flow@alpha hooks pre-edit "$2" 2>&1 | tee "$GUIDANCE_FILE"
-    ;;
-esac
+#!/bin/bash
+# Capture hook guidance for Claude visibility
+GUIDANCE_FILE=".claude-flow/last-guidance.txt"
+mkdir -p .claude-flow
+
+case "$1" in
+  "route")
+    npx agentic-flow@alpha hooks route "$2" 2>&1 | tee "$GUIDANCE_FILE"
+    ;;
+  "pre-edit")
+    npx agentic-flow@alpha hooks pre-edit "$2" 2>&1 | tee "$GUIDANCE_FILE"
+    ;;
+esac

package/.claude/helpers/guidance-hooks.sh

@@ -1,102 +1,102 @@
-#!/bin/bash
-# Guidance Hooks for RuFlo V3
-# Provides context and routing for Claude Code operations
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
-CACHE_DIR="$PROJECT_ROOT/.claude-flow"
-
-# Ensure cache directory exists
-mkdir -p "$CACHE_DIR" 2>/dev/null || true
-
-# Color codes
-CYAN='\033[0;36m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-RED='\033[0;31m'
-RESET='\033[0m'
-DIM='\033[2m'
-
-# Get command
-COMMAND="${1:-help}"
-shift || true
-
-case "$COMMAND" in
-    pre-edit)
-        FILE_PATH="$1"
-        if [[ -n "$FILE_PATH" ]]; then
-            if [[ "$FILE_PATH" =~ (config|secret|credential|password|key|auth) ]]; then
-                echo -e "${YELLOW}[Guidance] Security-sensitive file${RESET}"
-            fi
-            if [[ "$FILE_PATH" =~ ^v3/ ]]; then
-                echo -e "${CYAN}[Guidance] V3 module - follow ADR guidelines${RESET}"
-            fi
-        fi
-        exit 0
-        ;;
-
-    post-edit)
-        FILE_PATH="$1"
-        echo "$(date -Iseconds) edit $FILE_PATH" >> "$CACHE_DIR/edit-history.log" 2>/dev/null || true
-        exit 0
-        ;;
-
-    pre-command)
-        COMMAND_STR="$1"
-        if [[ "$COMMAND_STR" =~ (rm -rf|sudo|chmod 777) ]]; then
-            echo -e "${RED}[Guidance] High-risk command${RESET}"
-        fi
-        exit 0
-        ;;
-
-    route)
-        TASK="$1"
-        [[ -z "$TASK" ]] && exit 0
-        if [[ "$TASK" =~ (security|CVE|vulnerability) ]]; then
-            echo -e "${DIM}[Route] security-architect${RESET}"
-        elif [[ "$TASK" =~ (memory|AgentDB|HNSW|vector) ]]; then
-            echo -e "${DIM}[Route] memory-specialist${RESET}"
-        elif [[ "$TASK" =~ (performance|optimize|benchmark) ]]; then
-            echo -e "${DIM}[Route] performance-engineer${RESET}"
-        elif [[ "$TASK" =~ (test|TDD|spec) ]]; then
-            echo -e "${DIM}[Route] test-architect${RESET}"
-        fi
-        exit 0
-        ;;
-
-    session-context)
-        cat << 'EOF'
-## V3 Development Context
-
-**Architecture**: Domain-Driven Design with 15 @claude-flow modules
-**Priority**: Security-first (CVE-1, CVE-2, CVE-3 remediation)
-**Performance Targets**:
-- HNSW search: 150x-12,500x faster
-- Flash Attention: 2.49x-7.47x speedup
-- Memory: 50-75% reduction
-
-**Active Patterns**:
-- Use TDD London School (mock-first)
-- Event sourcing for state changes
-- agentic-flow@alpha as core foundation
-- Bounded contexts with clear interfaces
-
-**Code Quality Rules**:
-- Files under 500 lines
-- No hardcoded secrets
-- Input validation at boundaries
-- Typed interfaces for all public APIs
-
-**Learned Patterns**: 17 available for reference
-EOF
-        exit 0
-        ;;
-
-    user-prompt)
-        exit 0
-        ;;
-
-    *)
-        exit 0
-        ;;
-esac
+#!/bin/bash
+# Guidance Hooks for RuFlo V3
+# Provides context and routing for Claude Code operations
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+CACHE_DIR="$PROJECT_ROOT/.claude-flow"
+
+# Ensure cache directory exists
+mkdir -p "$CACHE_DIR" 2>/dev/null || true
+
+# Color codes
+CYAN='\033[0;36m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+RED='\033[0;31m'
+RESET='\033[0m'
+DIM='\033[2m'
+
+# Get command
+COMMAND="${1:-help}"
+shift || true
+
+case "$COMMAND" in
+    pre-edit)
+        FILE_PATH="$1"
+        if [[ -n "$FILE_PATH" ]]; then
+            if [[ "$FILE_PATH" =~ (config|secret|credential|password|key|auth) ]]; then
+                echo -e "${YELLOW}[Guidance] Security-sensitive file${RESET}"
+            fi
+            if [[ "$FILE_PATH" =~ ^v3/ ]]; then
+                echo -e "${CYAN}[Guidance] V3 module - follow ADR guidelines${RESET}"
+            fi
+        fi
+        exit 0
+        ;;
+
+    post-edit)
+        FILE_PATH="$1"
+        echo "$(date -Iseconds) edit $FILE_PATH" >> "$CACHE_DIR/edit-history.log" 2>/dev/null || true
+        exit 0
+        ;;
+
+    pre-command)
+        COMMAND_STR="$1"
+        if [[ "$COMMAND_STR" =~ (rm -rf|sudo|chmod 777) ]]; then
+            echo -e "${RED}[Guidance] High-risk command${RESET}"
+        fi
+        exit 0
+        ;;
+
+    route)
+        TASK="$1"
+        [[ -z "$TASK" ]] && exit 0
+        if [[ "$TASK" =~ (security|CVE|vulnerability) ]]; then
+            echo -e "${DIM}[Route] security-architect${RESET}"
+        elif [[ "$TASK" =~ (memory|AgentDB|HNSW|vector) ]]; then
+            echo -e "${DIM}[Route] memory-specialist${RESET}"
+        elif [[ "$TASK" =~ (performance|optimize|benchmark) ]]; then
+            echo -e "${DIM}[Route] performance-engineer${RESET}"
+        elif [[ "$TASK" =~ (test|TDD|spec) ]]; then
+            echo -e "${DIM}[Route] test-architect${RESET}"
+        fi
+        exit 0
+        ;;
+
+    session-context)
+        cat << 'EOF'
+## V3 Development Context
+
+**Architecture**: Domain-Driven Design with 15 @claude-flow modules
+**Priority**: Security-first (CVE-1, CVE-2, CVE-3 remediation)
+**Performance Targets**:
+- HNSW search: 150x-12,500x faster
+- Flash Attention: 2.49x-7.47x speedup
+- Memory: 50-75% reduction
+
+**Active Patterns**:
+- Use TDD London School (mock-first)
+- Event sourcing for state changes
+- agentic-flow@alpha as core foundation
+- Bounded contexts with clear interfaces
+
+**Code Quality Rules**:
+- Files under 500 lines
+- No hardcoded secrets
+- Input validation at boundaries
+- Typed interfaces for all public APIs
+
+**Learned Patterns**: 17 available for reference
+EOF
+        exit 0
+        ;;
+
+    user-prompt)
+        exit 0
+        ;;
+
+    *)
+        exit 0
+        ;;
+esac

package/.claude/helpers/health-monitor.sh

@@ -1,108 +1,108 @@
-#!/bin/bash
-# RuFlo V3 - Health Monitor Worker
-# Checks disk space, memory pressure, process health
-
-set -euo pipefail
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
-METRICS_DIR="$PROJECT_ROOT/.claude-flow/metrics"
-HEALTH_FILE="$METRICS_DIR/health.json"
-LAST_RUN_FILE="$METRICS_DIR/.health-last-run"
-
-mkdir -p "$METRICS_DIR"
-
-should_run() {
-  if [ ! -f "$LAST_RUN_FILE" ]; then return 0; fi
-  local last_run=$(cat "$LAST_RUN_FILE" 2>/dev/null || echo "0")
-  local now=$(date +%s)
-  [ $((now - last_run)) -ge 300 ]  # 5 minutes
-}
-
-check_health() {
-  echo "[$(date +%H:%M:%S)] Running health check..."
-
-  # Disk usage
-  local disk_usage=$(df -h "$PROJECT_ROOT" 2>/dev/null | awk 'NR==2 {print $5}' | tr -d '%')
-  local disk_free=$(df -h "$PROJECT_ROOT" 2>/dev/null | awk 'NR==2 {print $4}')
-
-  # Memory usage
-  local mem_total=$(free -m 2>/dev/null | awk '/Mem:/ {print $2}' || echo "0")
-  local mem_used=$(free -m 2>/dev/null | awk '/Mem:/ {print $3}' || echo "0")
-  local mem_pct=$((mem_used * 100 / (mem_total + 1)))
-
-  # Process counts
-  local node_procs=$(pgrep -c node 2>/dev/null || echo "0")
-  local agentic_procs=$(ps aux 2>/dev/null | grep -c "agentic-flow" | grep -v grep || echo "0")
-
-  # CPU load
-  local load_avg=$(cat /proc/loadavg 2>/dev/null | awk '{print $1}' || echo "0")
-
-  # File descriptor usage
-  local fd_used=$(ls /proc/$$/fd 2>/dev/null | wc -l || echo "0")
-
-  # Determine health status
-  local status="healthy"
-  local warnings=""
-
-  if [ "$disk_usage" -gt 90 ]; then
-    status="critical"
-    warnings="$warnings disk_full"
-  elif [ "$disk_usage" -gt 80 ]; then
-    status="warning"
-    warnings="$warnings disk_high"
-  fi
-
-  if [ "$mem_pct" -gt 90 ]; then
-    status="critical"
-    warnings="$warnings memory_full"
-  elif [ "$mem_pct" -gt 80 ]; then
-    [ "$status" != "critical" ] && status="warning"
-    warnings="$warnings memory_high"
-  fi
-
-  # Write health metrics
-  cat > "$HEALTH_FILE" << EOF
-{
-  "status": "$status",
-  "timestamp": "$(date -Iseconds)",
-  "disk": {
-    "usage_pct": $disk_usage,
-    "free": "$disk_free"
-  },
-  "memory": {
-    "total_mb": $mem_total,
-    "used_mb": $mem_used,
-    "usage_pct": $mem_pct
-  },
-  "processes": {
-    "node": $node_procs,
-    "agentic_flow": $agentic_procs
-  },
-  "load_avg": $load_avg,
-  "fd_used": $fd_used,
-  "warnings": "$(echo $warnings | xargs)"
-}
-EOF
-
-  echo "[$(date +%H:%M:%S)] ✓ Health: $status | Disk: ${disk_usage}% | Memory: ${mem_pct}% | Load: $load_avg"
-
-  date +%s > "$LAST_RUN_FILE"
-
-  # Return non-zero if unhealthy
-  [ "$status" = "healthy" ] && return 0 || return 1
-}
-
-case "${1:-check}" in
-  "run") check_health ;;
-  "check") should_run && check_health || echo "[$(date +%H:%M:%S)] Skipping (throttled)" ;;
-  "force") rm -f "$LAST_RUN_FILE"; check_health ;;
-  "status")
-    if [ -f "$HEALTH_FILE" ]; then
-      jq -r '"Status: \(.status) | Disk: \(.disk.usage_pct)% | Memory: \(.memory.usage_pct)% | Load: \(.load_avg)"' "$HEALTH_FILE"
-    else
-      echo "No health data available"
-    fi
-    ;;
-  *) echo "Usage: $0 [run|check|force|status]" ;;
-esac
+#!/bin/bash
+# RuFlo V3 - Health Monitor Worker
+# Checks disk space, memory pressure, process health
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+METRICS_DIR="$PROJECT_ROOT/.claude-flow/metrics"
+HEALTH_FILE="$METRICS_DIR/health.json"
+LAST_RUN_FILE="$METRICS_DIR/.health-last-run"
+
+mkdir -p "$METRICS_DIR"
+
+should_run() {
+  if [ ! -f "$LAST_RUN_FILE" ]; then return 0; fi
+  local last_run=$(cat "$LAST_RUN_FILE" 2>/dev/null || echo "0")
+  local now=$(date +%s)
+  [ $((now - last_run)) -ge 300 ]  # 5 minutes
+}
+
+check_health() {
+  echo "[$(date +%H:%M:%S)] Running health check..."
+
+  # Disk usage
+  local disk_usage=$(df -h "$PROJECT_ROOT" 2>/dev/null | awk 'NR==2 {print $5}' | tr -d '%')
+  local disk_free=$(df -h "$PROJECT_ROOT" 2>/dev/null | awk 'NR==2 {print $4}')
+
+  # Memory usage
+  local mem_total=$(free -m 2>/dev/null | awk '/Mem:/ {print $2}' || echo "0")
+  local mem_used=$(free -m 2>/dev/null | awk '/Mem:/ {print $3}' || echo "0")
+  local mem_pct=$((mem_used * 100 / (mem_total + 1)))
+
+  # Process counts
+  local node_procs=$(pgrep -c node 2>/dev/null || echo "0")
+  local agentic_procs=$(ps aux 2>/dev/null | grep -c "agentic-flow" | grep -v grep || echo "0")
+
+  # CPU load
+  local load_avg=$(cat /proc/loadavg 2>/dev/null | awk '{print $1}' || echo "0")
+
+  # File descriptor usage
+  local fd_used=$(ls /proc/$$/fd 2>/dev/null | wc -l || echo "0")
+
+  # Determine health status
+  local status="healthy"
+  local warnings=""
+
+  if [ "$disk_usage" -gt 90 ]; then
+    status="critical"
+    warnings="$warnings disk_full"
+  elif [ "$disk_usage" -gt 80 ]; then
+    status="warning"
+    warnings="$warnings disk_high"
+  fi
+
+  if [ "$mem_pct" -gt 90 ]; then
+    status="critical"
+    warnings="$warnings memory_full"
+  elif [ "$mem_pct" -gt 80 ]; then
+    [ "$status" != "critical" ] && status="warning"
+    warnings="$warnings memory_high"
+  fi
+
+  # Write health metrics
+  cat > "$HEALTH_FILE" << EOF
+{
+  "status": "$status",
+  "timestamp": "$(date -Iseconds)",
+  "disk": {
+    "usage_pct": $disk_usage,
+    "free": "$disk_free"
+  },
+  "memory": {
+    "total_mb": $mem_total,
+    "used_mb": $mem_used,
+    "usage_pct": $mem_pct
+  },
+  "processes": {
+    "node": $node_procs,
+    "agentic_flow": $agentic_procs
+  },
+  "load_avg": $load_avg,
+  "fd_used": $fd_used,
+  "warnings": "$(echo $warnings | xargs)"
+}
+EOF
+
+  echo "[$(date +%H:%M:%S)] ✓ Health: $status | Disk: ${disk_usage}% | Memory: ${mem_pct}% | Load: $load_avg"
+
+  date +%s > "$LAST_RUN_FILE"
+
+  # Return non-zero if unhealthy
+  [ "$status" = "healthy" ] && return 0 || return 1
+}
+
+case "${1:-check}" in
+  "run") check_health ;;
+  "check") should_run && check_health || echo "[$(date +%H:%M:%S)] Skipping (throttled)" ;;
+  "force") rm -f "$LAST_RUN_FILE"; check_health ;;
+  "status")
+    if [ -f "$HEALTH_FILE" ]; then
+      jq -r '"Status: \(.status) | Disk: \(.disk.usage_pct)% | Memory: \(.memory.usage_pct)% | Load: \(.load_avg)"' "$HEALTH_FILE"
+    else
+      echo "No health data available"
+    fi
+    ;;
+  *) echo "Usage: $0 [run|check|force|status]" ;;
+esac