claude-flow-novice 2.18.22 → 2.18.24

package/.claude/hooks/README.md

@@ -1,148 +1,148 @@
-# Claude Code Hooks
-
-This directory contains hooks that integrate with Claude Code's lifecycle events.
-
-## cfn-precompact-enhanced.sh
-
-Enhanced PreCompact hook that preserves context before conversation compaction (manual or auto).
-
-### Features
-
-**Context Preservation:**
-- Captures current git state (branch, status, recent commits)
-- Saves uncommitted and staged changes
-- Records modified files
-
-**Session Metrics:**
-- Counts recently edited files
-- Estimates session duration from git history
-- Detects test execution and status
-- Tracks tool usage (if transcript available)
-- Approximates token usage
-
-**CFN-Specific Detection:**
-- Active CFN Loop tasks
-- Running CFN Docker containers
-- Redis coordination state
-- Recent pre-edit backups
-
-**Output:**
-- Prints structured summary to stdout (injected into Claude's context)
-- Saves detailed JSON log to `.artifacts/precompact/session-{timestamp}.json`
-- Includes CLAUDE.md reminders for best practices
-
-### Configuration
-
-The hook is configured in `.claude/settings.json`:
-
-```json
-{
-  "hooks": {
-    "PreCompact": [
-      {
-        "matcher": "manual",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "/bin/bash .claude/hooks/cfn-precompact-enhanced.sh"
-          }
-        ]
-      },
-      {
-        "matcher": "auto",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "/bin/bash .claude/hooks/cfn-precompact-enhanced.sh"
-          }
-        ]
-      }
-    ]
-  }
-}
-```
-
-### Performance
-
-- **Timeout Protection**: 9-second overall script timeout
-- **Non-Blocking**: Always exits with code 0
-- **Optimized for WSL2**: Limits `find` depth and targets specific directories
-- **Graceful Degradation**: Continues if git/jq unavailable
-
-### Testing
-
-```bash
-# Test without stdin
-./.claude/hooks/cfn-precompact-enhanced.sh
-
-# Test with simulated input
-echo '{"type": "manual", "compact_type": "manual"}' | \
-  CLAUDE_PROJECT_DIR=$(pwd) bash .claude/hooks/cfn-precompact-enhanced.sh
-```
-
-### Output Example
-
-```
-=== PRE-COMPACT CONTEXT PRESERVATION ===
-
-Compact Type: manual
-Timestamp: 2025-12-10 04:46:26
-
-Git State:
-  Branch: feature/auth-system
-  Uncommitted: 3 files
-  Modified: 2 files
-  Staged: 1 files
-  Last commit: abc123 - "Add JWT validation" (2 hours ago)
-
-Session Summary:
-  Recent file edits: 5
-  Duration: 45 minutes
-  Tests run: true
-  Test status: passing
-  Tools used: 12 (Bash: 8, Edit: 4)
-  Approx tokens: ~800
-
-Key Context:
-  - Working directory: /path/to/project
-  - Uncommitted changes
-  - 2 CFN container(s) running
-
-Full context saved to: .artifacts/precompact/session-1765370786.json
-
-=== CLAUDE.md REMINDERS ===
-• Use CFN Loop for multi-step tasks
-• Batch operations in single messages
-• Pre-edit backup required before edits
-• Run tests before commits
-• Use service names in Docker networks
-```
-
-### Artifacts
-
-Session data is preserved in:
-- `.artifacts/precompact/session-{timestamp}.json` - Full JSON context
-- `.artifacts/precompact/{timestamp}-git.diff` - Git diff (if changes exist)
-- `.artifacts/precompact/{timestamp}-commits.txt` - Recent commit history
-- `.artifacts/precompact/backup-{todo-file}-{timestamp}` - Copied todo files
-
-### Environment Variables
-
-- `CLAUDE_PROJECT_DIR` - Project root (defaults to `pwd`)
-- `TRANSCRIPT_PATH` - Path to conversation transcript (optional, for tool usage stats)
-- `INPUT` - JSON input from Claude Code (compact_type, custom_instructions)
-
-### Troubleshooting
-
-**Hook times out:**
-- Check if running on Windows mount (should be Linux filesystem)
-- Verify timeout settings in script (default 9 seconds)
-- Reduce `find` depth or target fewer directories
-
-**No JSON output:**
-- Ensure `.artifacts/precompact/` directory exists
-- Check for `jq` availability (gracefully degrades if missing)
-
-**Line ending issues:**
-- Convert to Unix line endings: `dos2unix .claude/hooks/cfn-precompact-enhanced.sh`
-- Or use: `sed -i 's/\r$//' .claude/hooks/cfn-precompact-enhanced.sh`
+# Claude Code Hooks
+
+This directory contains hooks that integrate with Claude Code's lifecycle events.
+
+## cfn-precompact-enhanced.sh
+
+Enhanced PreCompact hook that preserves context before conversation compaction (manual or auto).
+
+### Features
+
+**Context Preservation:**
+- Captures current git state (branch, status, recent commits)
+- Saves uncommitted and staged changes
+- Records modified files
+
+**Session Metrics:**
+- Counts recently edited files
+- Estimates session duration from git history
+- Detects test execution and status
+- Tracks tool usage (if transcript available)
+- Approximates token usage
+
+**CFN-Specific Detection:**
+- Active CFN Loop tasks
+- Running CFN Docker containers
+- Redis coordination state
+- Recent pre-edit backups
+
+**Output:**
+- Prints structured summary to stdout (injected into Claude's context)
+- Saves detailed JSON log to `.artifacts/precompact/session-{timestamp}.json`
+- Includes CLAUDE.md reminders for best practices
+
+### Configuration
+
+The hook is configured in `.claude/settings.json`:
+
+```json
+{
+  "hooks": {
+    "PreCompact": [
+      {
+        "matcher": "manual",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "/bin/bash .claude/hooks/cfn-precompact-enhanced.sh"
+          }
+        ]
+      },
+      {
+        "matcher": "auto",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "/bin/bash .claude/hooks/cfn-precompact-enhanced.sh"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+### Performance
+
+- **Timeout Protection**: 9-second overall script timeout
+- **Non-Blocking**: Always exits with code 0
+- **Optimized for WSL2**: Limits `find` depth and targets specific directories
+- **Graceful Degradation**: Continues if git/jq unavailable
+
+### Testing
+
+```bash
+# Test without stdin
+./.claude/hooks/cfn-precompact-enhanced.sh
+
+# Test with simulated input
+echo '{"type": "manual", "compact_type": "manual"}' | \
+  CLAUDE_PROJECT_DIR=$(pwd) bash .claude/hooks/cfn-precompact-enhanced.sh
+```
+
+### Output Example
+
+```
+=== PRE-COMPACT CONTEXT PRESERVATION ===
+
+Compact Type: manual
+Timestamp: 2025-12-10 04:46:26
+
+Git State:
+  Branch: feature/auth-system
+  Uncommitted: 3 files
+  Modified: 2 files
+  Staged: 1 files
+  Last commit: abc123 - "Add JWT validation" (2 hours ago)
+
+Session Summary:
+  Recent file edits: 5
+  Duration: 45 minutes
+  Tests run: true
+  Test status: passing
+  Tools used: 12 (Bash: 8, Edit: 4)
+  Approx tokens: ~800
+
+Key Context:
+  - Working directory: /path/to/project
+  - Uncommitted changes
+  - 2 CFN container(s) running
+
+Full context saved to: .artifacts/precompact/session-1765370786.json
+
+=== CLAUDE.md REMINDERS ===
+• Use CFN Loop for multi-step tasks
+• Batch operations in single messages
+• Pre-edit backup required before edits
+• Run tests before commits
+• Use service names in Docker networks
+```
+
+### Artifacts
+
+Session data is preserved in:
+- `.artifacts/precompact/session-{timestamp}.json` - Full JSON context
+- `.artifacts/precompact/{timestamp}-git.diff` - Git diff (if changes exist)
+- `.artifacts/precompact/{timestamp}-commits.txt` - Recent commit history
+- `.artifacts/precompact/backup-{todo-file}-{timestamp}` - Copied todo files
+
+### Environment Variables
+
+- `CLAUDE_PROJECT_DIR` - Project root (defaults to `pwd`)
+- `TRANSCRIPT_PATH` - Path to conversation transcript (optional, for tool usage stats)
+- `INPUT` - JSON input from Claude Code (compact_type, custom_instructions)
+
+### Troubleshooting
+
+**Hook times out:**
+- Check if running on Windows mount (should be Linux filesystem)
+- Verify timeout settings in script (default 9 seconds)
+- Reduce `find` depth or target fewer directories
+
+**No JSON output:**
+- Ensure `.artifacts/precompact/` directory exists
+- Check for `jq` availability (gracefully degrades if missing)
+
+**Line ending issues:**
+- Convert to Unix line endings: `dos2unix .claude/hooks/cfn-precompact-enhanced.sh`
+- Or use: `sed -i 's/\r$//' .claude/hooks/cfn-precompact-enhanced.sh`

package/.claude/hooks/cfn-bash-search-hook.sh

@@ -0,0 +1,87 @@
+#!/bin/bash
+set -euo pipefail
+
+INPUT=$(timeout 1 cat || echo "{}")
+CMD=$(echo "$INPUT" | jq -r '.tool_input.command // empty')
+
+log() { echo "[$(date '+%H:%M:%S')] $*" >> /tmp/ruvector-bash-hook.log; }
+
+# Load API key from .env if not set
+load_api_key() {
+    if [[ -n "${OPENAI_API_KEY:-}" ]] && [[ "${OPENAI_API_KEY:-}" != "your_"* ]]; then
+        return 0
+    fi
+    local env_file="${CLAUDE_PROJECT_DIR:-.}/.env"
+    if [[ -f "$env_file" ]]; then
+        local key=$(grep "^OPENAI_API_KEY=" "$env_file" 2>/dev/null | cut -d= -f2- | tr -d '"' | tr -d "'" || true)
+        if [[ -n "$key" ]] && [[ "$key" != "your_"* ]]; then
+            export OPENAI_API_KEY="$key"
+            return 0
+        fi
+    fi
+    return 1
+}
+
+log "Bash hook: $CMD"
+
+if echo "$CMD" | grep -qE "find\s+/mnt/c"; then
+  echo "🔴 BLOCKED: find on /mnt/c forbidden (memory leak). Use Glob tool instead." >&2
+  exit 2
+fi
+
+if ! echo "$CMD" | grep -qiE "^\s*(grep|rg|find)\s|[|&;]\s*(grep|rg|find)\s"; then
+  exit 0
+fi
+
+PATTERN=""
+
+PATTERN=$(echo "$CMD" | grep -oE '(grep|rg)\s+[^|]+' | grep -oE '"[^"]+"' | head -1 | tr -d '"' || true)
+
+if [ -z "$PATTERN" ]; then
+  PATTERN=$(echo "$CMD" | grep -oE "(grep|rg)\s+(-[a-zA-Z]+\s+)*([a-zA-Z_][a-zA-Z0-9_]*)" | awk '{print $NF}' || true)
+fi
+
+if [ -z "$PATTERN" ]; then
+  PATTERN=$(echo "$CMD" | grep -oE '\-name\s+"[^"]+"' | sed 's/-name\s*"//' | tr -d '"' || true)
+fi
+
+if [ -z "$PATTERN" ] || [ ${#PATTERN} -lt 3 ] || [[ "$PATTERN" == -* ]]; then
+  exit 0
+fi
+
+DB_PATH="$HOME/.local/share/ruvector/index_v2.db"
+PROJECT_ROOT="${CLAUDE_PROJECT_DIR:-$(pwd)}"
+
+CONTEXT=""
+
+# Try SQL first (fast, no API key)
+if [ -f "$DB_PATH" ]; then
+  SAFE_PATTERN=$(echo "$PATTERN" | sed "s/'/''/g")
+  SAFE_ROOT=$(echo "$PROJECT_ROOT" | sed "s/'/''/g")
+
+  RESULTS=$(timeout 3 sqlite3 -separator ':' "$DB_PATH" \
+    "SELECT REPLACE(file_path, '$SAFE_ROOT/', ''), line_number, name FROM entities WHERE project_root = '$SAFE_ROOT' AND (name LIKE '%${SAFE_PATTERN}%' OR file_path LIKE '%${SAFE_PATTERN}%') LIMIT 6" 2>/dev/null || true)
+
+  if [ -n "$RESULTS" ]; then
+    CONTEXT="RuVector indexed matches for '$PATTERN':\n$RESULTS"
+    log "SQL context injected for: $PATTERN"
+  fi
+fi
+
+# Fallback to semantic search if SQL found nothing
+if [ -z "$CONTEXT" ] && command -v local-ruvector >/dev/null 2>&1; then
+  if load_api_key; then
+    log "SQL returned nothing, trying semantic search for: $PATTERN"
+    SEMANTIC=$(timeout 5 local-ruvector query "$PATTERN" --max-results 5 --threshold 0.3 2>/dev/null | sed 's/\x1b\[[0-9;]*m//g' | grep -v "^$" | grep -v "INFO\|ERROR\|WARN" | head -6 || true)
+    if [ -n "$SEMANTIC" ]; then
+      CONTEXT="RuVector semantic matches for '$PATTERN':\n$SEMANTIC"
+      log "Semantic context injected for: $PATTERN"
+    fi
+  fi
+fi
+
+if [ -n "$CONTEXT" ]; then
+  echo "{\"additionalContext\":\"$CONTEXT\"}"
+fi
+
+exit 0

package/.claude/hooks/cfn-smart-search-hook.sh

@@ -0,0 +1,127 @@
+#!/bin/bash
+set -euo pipefail
+exec 2>/tmp/ruvector-search-hook.log
+
+INPUT=$(timeout 1 cat || echo "{}")
+TOOL_NAME=$(echo "$INPUT" | jq -r '.tool_name // empty')
+PATTERN=$(echo "$INPUT" | jq -r '.tool_input.pattern // empty')
+
+log() {
+    echo "[$(date '+%Y-%m-%d %H:%M:%S')] $*" >> /tmp/ruvector-search-hook.log
+}
+
+# Load API key from .env if not set
+load_api_key() {
+    if [[ -n "${OPENAI_API_KEY:-}" ]] && [[ "${OPENAI_API_KEY:-}" != "your_"* ]]; then
+        return 0
+    fi
+    local env_file="${CLAUDE_PROJECT_DIR:-.}/.env"
+    if [[ -f "$env_file" ]]; then
+        local key=$(grep "^OPENAI_API_KEY=" "$env_file" 2>/dev/null | cut -d= -f2- | tr -d '"' | tr -d "'" || true)
+        if [[ -n "$key" ]] && [[ "$key" != "your_"* ]]; then
+            export OPENAI_API_KEY="$key"
+            log "Loaded OPENAI_API_KEY from .env"
+            return 0
+        fi
+    fi
+    return 1
+}
+
+log "Hook triggered: tool=$TOOL_NAME pattern='$PATTERN'"
+
+# Skip if no pattern or tool not Grep/Glob
+if [[ -z "$PATTERN" || -z "$TOOL_NAME" ]]; then
+    log "Missing pattern or tool name, exiting"
+    exit 0
+fi
+
+# Skip conditions
+if [[ ${#PATTERN} -lt 3 ]]; then
+    log "Pattern too short, skipping"
+    exit 0
+fi
+
+# Skip glob patterns (file discovery, not semantic)
+if [[ "$PATTERN" == *"*"* ]] || [[ "$PATTERN" == *"?"* ]] || [[ "$PATTERN" == *"["* ]]; then
+    log "Pattern looks like glob, skipping"
+    exit 0
+fi
+
+# Skip exact paths (contains / and . extension)
+if [[ "$PATTERN" == *"/"* ]] && [[ "$PATTERN" == *"."* ]]; then
+    log "Pattern looks like exact path, skipping"
+    exit 0
+fi
+
+CONTEXT=""
+UNCOMMITTED=""
+
+# Check uncommitted files
+if command -v git >/dev/null 2>&1; then
+    UNCOMMITTED=$(timeout 2 git diff --name-only HEAD 2>/dev/null | grep -i "$PATTERN" || true)
+    if [[ -n "$UNCOMMITTED" ]]; then
+        log "Found uncommitted matches"
+        CONTEXT="Uncommitted files matching pattern:
+$UNCOMMITTED
+
+"
+    fi
+fi
+
+# Query RuVector V2 SQL first (no API key needed)
+RUVECTOR_RESULTS=""
+DB_PATH="$HOME/.local/share/ruvector/index_v2.db"
+PROJECT_ROOT="${CLAUDE_PROJECT_DIR:-$(pwd)}"
+if [[ -f "$DB_PATH" ]]; then
+    log "Querying RuVector SQL for: $PATTERN (project: $PROJECT_ROOT)"
+    # Escape pattern for SQL LIKE
+    SAFE_PATTERN=$(echo "$PATTERN" | sed "s/'/''/g")
+    SAFE_ROOT=$(echo "$PROJECT_ROOT" | sed "s/'/''/g")
+    RUVECTOR_RESULTS=$(timeout 3 sqlite3 -separator ':' "$DB_PATH" \
+        "SELECT REPLACE(file_path, '$SAFE_ROOT/', ''), line_number, name FROM entities WHERE project_root = '$SAFE_ROOT' AND (name LIKE '%${SAFE_PATTERN}%' OR file_path LIKE '%${SAFE_PATTERN}%') LIMIT 8" 2>/dev/null | head -10 || true)
+    if [[ -n "$RUVECTOR_RESULTS" ]]; then
+        log "RuVector SQL returned results"
+        CONTEXT="${CONTEXT}RuVector indexed matches for '$PATTERN':
+$RUVECTOR_RESULTS
+
+"
+    fi
+else
+    log "RuVector index not found at $DB_PATH"
+fi
+
+# Fallback to semantic search if SQL found nothing and API key available
+if [[ -z "$RUVECTOR_RESULTS" ]] && command -v local-ruvector >/dev/null 2>&1; then
+    if load_api_key; then
+        log "SQL returned nothing, trying semantic search for: $PATTERN"
+        # Strip ANSI codes from output
+        SEMANTIC_RESULTS=$(timeout 5 local-ruvector query "$PATTERN" --max-results 5 --threshold 0.3 2>/dev/null | sed 's/\x1b\[[0-9;]*m//g' | grep -v "^$" | grep -v "INFO\|ERROR\|WARN" | head -8 || true)
+        if [[ -n "$SEMANTIC_RESULTS" ]]; then
+            log "Semantic search returned results"
+            CONTEXT="${CONTEXT}RuVector semantic matches for '$PATTERN':
+$SEMANTIC_RESULTS
+
+"
+        else
+            log "Semantic search returned no results"
+        fi
+    else
+        log "No API key available for semantic search"
+    fi
+fi
+
+# Output context if we have any
+if [[ -n "$CONTEXT" ]]; then
+    # Try JSON output first
+    if command -v jq >/dev/null 2>&1; then
+        echo "$INPUT" | jq --arg context "$CONTEXT" '. + {additionalContext: $context}'
+    else
+        # Fallback to plain text
+        echo "$CONTEXT"
+    fi
+    log "Context injected successfully"
+else
+    log "No additional context found"
+fi
+
+exit 0

package/.claude/hooks/deprecated/cfn-SessionStart-cfn-load-openai-key.sh

@@ -0,0 +1,48 @@
+#!/bin/bash
+
+# SessionStart hook: Load OpenAI API key from root .env file
+# This ensures OPENAI_API_KEY is available for embedding generation
+#
+# IMPORTANT: SessionStart hooks must write to CLAUDE_ENV_FILE to set env vars.
+# JSON output and 'export' do NOT work - only CLAUDE_ENV_FILE persists.
+
+set -e
+
+# Path to root .env file
+ROOT_ENV="${PROJECT_ROOT:-.}/.env"
+
+# Check if CLAUDE_ENV_FILE is available (only in SessionStart hooks)
+if [[ -z "$CLAUDE_ENV_FILE" ]]; then
+    echo "⚠️  CLAUDE_ENV_FILE not set - not running as SessionStart hook" >&2
+    exit 0
+fi
+
+# Check if .env exists
+if [[ ! -f "$ROOT_ENV" ]]; then
+    echo "⚠️  Warning: $ROOT_ENV not found. OpenAI embeddings will not work." >&2
+    exit 0
+fi
+
+# Extract OPENAI_API_KEY from .env
+if grep -q "^OPENAI_API_KEY=" "$ROOT_ENV"; then
+    OPENAI_KEY=$(grep "^OPENAI_API_KEY=" "$ROOT_ENV" | cut -d'=' -f2- | tr -d '"' | tr -d "'")
+
+    # Validate key format
+    if [[ -z "$OPENAI_KEY" ]]; then
+        echo "⚠️  Warning: OPENAI_API_KEY found but empty in $ROOT_ENV" >&2
+        exit 0
+    fi
+
+    if [[ ! "$OPENAI_KEY" =~ ^sk- ]]; then
+        echo "⚠️  Warning: OPENAI_API_KEY invalid format (must start with 'sk-')" >&2
+        exit 0
+    fi
+
+    # Write to CLAUDE_ENV_FILE - this is how SessionStart hooks set env vars
+    echo "export OPENAI_API_KEY=\"$OPENAI_KEY\"" >> "$CLAUDE_ENV_FILE"
+    echo "✅ Loaded OPENAI_API_KEY from .env (${OPENAI_KEY:0:10}...)" >&2
+else
+    echo "⚠️  Warning: OPENAI_API_KEY not found in $ROOT_ENV. OpenAI embeddings will not work." >&2
+fi
+
+exit 0