claude-self-reflect 7.0.0 → 7.1.8

package/.claude/agents/csr-validator.md

@@ -93,7 +93,79 @@ find . -type f \( -name "*test_*.py" -o -name "test_*.py" -o -name "*benchmark*.
 echo "=== Suggest archiving to: tests/throwaway/ ==="
 ```
 
-### 8. NPM Package Validation (Regression Check for #71)
+### 8. Ralph Loop Integration Validation (v7.1+)
+
+**What is Ralph Loop?**
+The Ralph Wiggum technique helps Claude maintain focus on long, complex tasks. With CSR integration, Ralph loops gain cross-session memory through hooks.
+
+**CRITICAL: Runaway Loop Prevention**
+- ALWAYS use `--max-iterations` (PLURAL!) as safety net
+- `--max-iteration` (singular) is IGNORED - loop runs forever!
+- Setting `active: false` does NOT stop loops - must DELETE file
+- To stop: `rm .claude/ralph-loop.local.md`
+
+**v7.1+ Enhanced Features:**
+- **Error Signature Deduplication**: Normalizes errors to avoid storing duplicates
+- **Output Decline Detection**: Circuit breaker pattern (detects >70% output drop)
+- **Confidence-Based Exit**: 0-100 scoring for exit decisions
+- **Anti-Pattern Injection**: "DON'T RETRY THESE" surfaced first
+- **Work Type Tracking**: IMPLEMENTATION/TESTING/DEBUGGING/DOCUMENTATION
+- **Error-Centric Search**: Find past sessions by error pattern, not just task
+
+```bash
+# Check Ralph hooks in settings.json
+echo "=== Ralph Hooks Validation ==="
+grep -c "session_start_hook\|session_end_hook\|precompact" ~/.claude/settings.json && echo "✅ Hooks configured" || echo "❌ Hooks missing"
+
+# Verify hook scripts exist
+echo "=== Hook Scripts ==="
+ls -la src/runtime/hooks/session_start_hook.py 2>/dev/null && echo "✅ SessionStart" || echo "❌ SessionStart missing"
+ls -la src/runtime/hooks/session_end_hook.py 2>/dev/null && echo "✅ SessionEnd" || echo "❌ SessionEnd missing"
+ls -la src/runtime/precompact-hook.sh 2>/dev/null && echo "✅ PreCompact" || echo "❌ PreCompact missing"
+
+# Test RalphState import (NOT RalphStateParser)
+python3 -c "
+import sys
+sys.path.insert(0, 'src/runtime/hooks')
+from ralph_state import RalphState
+print('✅ RalphState imports')
+" || echo "❌ RalphState import failed"
+
+# Check for Ralph-related CLI integration
+grep -l "ralph" installer/setup-wizard-docker.js && echo "✅ CLI integration" || echo "❌ CLI missing Ralph"
+
+# Test v7.1+ enhanced features
+echo "=== Testing v7.1+ Enhanced Features ==="
+python3 -c "
+import sys
+sys.path.insert(0, 'src/runtime/hooks')
+from ralph_state import RalphState
+
+# Quick feature check
+state = RalphState.create_new('test', 'test')
+state.add_error('Error at line 42')
+state.track_output(1000)
+state.update_confidence({'all_tasks_complete': True})
+state.work_type = 'TESTING'
+
+print('✅ Error dedup:', len(state.error_signatures), 'signatures')
+print('✅ Output tracking:', len(state.output_lengths), 'samples')
+print('✅ Confidence:', state.exit_confidence, '%')
+print('✅ Work type:', state.work_type)
+print('✅ All v7.1+ features work')
+"
+```
+
+**Test CSR Search for Ralph Sessions:**
+```python
+# Search for past Ralph sessions
+results = await csr_reflect_on_past("Ralph loop session", limit=3, min_score=0.3)
+
+# Quick check
+quick = await csr_quick_check("Ralph Wiggum")
+```
+
+### 9. NPM Package Validation (Regression Check for #71)
 ```bash
 echo "=== NPM Package Contents Check ==="
 
@@ -166,6 +238,20 @@ CodeRabbit Analysis: [PASS/FAIL]
 - PR feedback checked: [✓/✗]
 - Issues found: [none/list]
 
+Ralph Loop Integration (v7.1+): [PASS/FAIL]
+- Hooks in settings.json: [✓/✗]
+- SessionStart hook: [✓/✗]
+- SessionEnd hook: [✓/✗]
+- PreCompact hook: [✓/✗]
+- RalphState module: [✓/✗]
+- CLI integration: [✓/✗]
+- CSR search for Ralph: [✓/✗]
+- v7.1+ Enhanced Features:
+  - Error signature dedup: [✓/✗]
+  - Output decline detection: [✓/✗]
+  - Confidence scoring: [✓/✗]
+  - Work type tracking: [✓/✗]
+
 Critical Issues: [none/list]
 
 CLEANUP NEEDED:

package/.env.example

@@ -62,3 +62,18 @@ HOT_CHECK_INTERVAL_S=2                   # Check hot files every N seconds
 NORMAL_CHECK_INTERVAL_S=60               # Normal check interval
 WARM_WINDOW_HOURS=24                     # Files < N hours are warm
 MAX_COLD_FILES=5                         # Max cold files per cycle
+
+# ====================================================================================
+# Evaluation System Configuration (OPTIONAL - Session Health Checks)
+# ====================================================================================
+# Automatically runs health checks on session start to verify MCP tools,
+# search quality, and performance are functioning correctly
+
+# Enable automatic evaluation at session start
+EVAL_ON_STARTUP=false                    # Set to true for session-start health checks
+
+# Evaluation timeout settings
+EVAL_TIMEOUT_SECONDS=30                  # Maximum time for evaluation run
+
+# Performance targets
+EVAL_PERFORMANCE_TARGET_MS=500           # Target search latency in milliseconds

package/README.md

@@ -41,6 +41,7 @@ Claude starts fresh every conversation. You've solved complex bugs, designed arc
 - [Real Examples](#real-examples)
 - [NEW: Real-time Indexing Status](#new-real-time-indexing-status-in-your-terminal)
 - [Key Features](#key-features)
+- [Ralph Loop Memory Integration](#ralph-loop-memory-integration)
 - [Code Quality Insights](#code-quality-insights)
 - [Architecture](#architecture)
 - [Requirements](#requirements)
@@ -324,6 +325,64 @@ Claude: [Searches across ALL your projects]
 
 </details>
 
+<details>
+<summary><b>Ralph Loop Memory Integration (v7.1+)</b></summary>
+
+<div align="center">
+<img src="docs/images/ralph-loop-csr.png" alt="Ralph Loop with CSR Memory - From hamster wheel to upward spiral" width="800"/>
+</div>
+
+Use the [ralph-wiggum plugin](https://github.com/anthropics/claude-code-plugins/tree/main/ralph-wiggum) for long tasks? CSR automatically gives Ralph loops **cross-session memory**:
+
+**Core Features:**
+- **Automatic backup** before context compaction
+- **Past session retrieval** when starting new Ralph loops
+- **Failed approach tracking** - never repeat the same mistakes
+- **Success pattern learning** - reuse what worked before
+
+**v7.1+ Enhanced Features:**
+- **Error Signature Deduplication** - Normalizes errors (removes line numbers, paths, timestamps) to avoid redundant storage
+- **Output Decline Detection** - Circuit breaker pattern that detects >70% drop in output length
+- **Confidence-Based Exit** - 0-100 scoring based on signals (tasks complete, tests passing, no errors)
+- **Anti-Pattern Injection** - "DON'T RETRY THESE" section surfaces failed approaches first
+- **Work Type Tracking** - Categorizes sessions as IMPLEMENTATION/TESTING/DEBUGGING/DOCUMENTATION
+- **Error-Centric Search** - Finds past sessions by error pattern, not just task description
+
+**Setup (one-time):**
+```bash
+./scripts/ralph/install_hooks.sh        # Install CSR hooks
+./scripts/ralph/install_hooks.sh --check  # Verify installation
+```
+
+**How it works:**
+1. Start a Ralph loop: `/ralph-wiggum:ralph-loop "Build feature X"`
+2. Work naturally - state is tracked in `.claude/ralph-loop.local.md`
+3. When compaction occurs, state is backed up to CSR
+4. New sessions retrieve past learnings from CSR automatically
+5. Anti-patterns and winning strategies are surfaced first
+
+**Files created:**
+- `.ralph_past_sessions.md` - Injected context from past sessions (auto-generated)
+
+**Verified proof (2026-01-04):**
+```
+# Session start hook injects past sessions:
+INFO: Found 2 relevant results:
+  - Anti-patterns: 0
+  - Winning strategies: 0
+  - Similar tasks: 2
+
+# Sessions stored in Qdrant:
+{
+  "tags": ["ralph_session", "outcome_completed"],
+  "timestamp": "2026-01-04T18:13:03.711262+00:00"
+}
+```
+
+[Full documentation →](docs/development/ralph-memory-integration.md)
+
+</details>
+
 <details>
 <summary><b>Memory Decay</b></summary>
 

package/docker-compose.yaml

@@ -3,14 +3,15 @@ volumes:
 
 services:
   # Fix permissions for config directory (UID 1001 matches appuser in Dockerfiles)
+  # Now runs by default since batch services are always-on
   init-permissions:
     image: alpine
-    command: sh -c "chown -R 1001:1001 /config && chown -R 1001:1001 /batch_queue && chown -R 1001:1001 /batch_state"
+    command: sh -c "mkdir -p /config /batch_queue /batch_state && chown -R 1001:1001 /config && chown -R 1001:1001 /batch_queue && chown -R 1001:1001 /batch_state"
     volumes:
       - ${CONFIG_PATH:-${HOME}/.claude-self-reflect/config}:/config
       - ${CSR_BATCH_QUEUE_DIR:-${HOME}/.claude-self-reflect/batch_queue}:/batch_queue
       - ${CSR_BATCH_STATE_DIR:-${HOME}/.claude-self-reflect/batch_state}:/batch_state
-    profiles: ["watch", "import", "async", "safe-watch", "batch-automation"]
+    # No profiles = starts by default (required for batch services)
 
   # Qdrant vector database - the heart of semantic search
   qdrant:
@@ -44,6 +45,7 @@ services:
       - ${CONFIG_PATH:-${HOME}/.claude-self-reflect/config}:/config
     environment:
       - QDRANT_URL=http://qdrant:6333
+      - HF_HUB_OFFLINE=1
       - STATE_FILE=/config/imported-files.json
       - LOGS_DIR=/logs
       - OPENAI_API_KEY=${OPENAI_API_KEY:-}
@@ -74,6 +76,7 @@ services:
       - /tmp:/tmp
     environment:
       - QDRANT_URL=http://qdrant:6333
+      - HF_HUB_OFFLINE=1
       - STATE_FILE=/config/imported-files.json
       - OPENAI_API_KEY=${OPENAI_API_KEY:-}
       - VOYAGE_API_KEY=${VOYAGE_API_KEY:-}
@@ -103,6 +106,7 @@ services:
       - ${CONFIG_PATH:-${HOME}/.claude-self-reflect/config}:/config
     environment:
       - QDRANT_URL=http://qdrant:6333
+      - HF_HUB_OFFLINE=1
       - STATE_FILE=/config/streaming-state.json  # FIXED: Use streaming-specific state file
       - VOYAGE_API_KEY=${VOYAGE_API_KEY:-}
       - VOYAGE_KEY=${VOYAGE_KEY:-}
@@ -142,6 +146,7 @@ services:
       - ${CONFIG_PATH:-${HOME}/.claude-self-reflect/config}:/config
     environment:
       - QDRANT_URL=http://qdrant:6333
+      - HF_HUB_OFFLINE=1
       - STATE_FILE=/config/imported-files.json
       - VOYAGE_API_KEY=${VOYAGE_API_KEY:-}
       - VOYAGE_KEY=${VOYAGE_KEY:-}
@@ -177,6 +182,7 @@ services:
       - ${CONFIG_PATH:-${HOME}/.claude-self-reflect/config}:/config
     environment:
       - QDRANT_URL=http://qdrant:6333
+      - HF_HUB_OFFLINE=1
       - STATE_FILE=/config/csr-watcher.json
       - LOGS_DIR=/logs  # Fixed: Point to mounted volume
       - VOYAGE_KEY=${VOYAGE_KEY:-}
@@ -212,6 +218,7 @@ services:
       - qdrant
     environment:
       - QDRANT_URL=http://qdrant:6333
+      - HF_HUB_OFFLINE=1
       - VOYAGE_KEY=${VOYAGE_KEY:-}
       - PREFER_LOCAL_EMBEDDINGS=${PREFER_LOCAL_EMBEDDINGS:-true}
       - ENABLE_MEMORY_DECAY=${ENABLE_MEMORY_DECAY:-true}
@@ -224,8 +231,8 @@ services:
     profiles: ["mcp"]
 
   # Batch watcher - Queues conversations and triggers batch narrative generation
-  # OPTIONAL: Requires ANTHROPIC_API_KEY. Disabled by default.
-  # Enable via CLI during installation or: docker compose --profile batch-automation up -d
+  # Requires ANTHROPIC_API_KEY for AI-powered narratives (9.3x better search quality)
+  # Now starts by default if ANTHROPIC_API_KEY is set
   batch-watcher:
     build:
       context: .
@@ -241,6 +248,7 @@ services:
       - ${CSR_BATCH_STATE_DIR:-${HOME}/.claude-self-reflect/batch_state}:/home/appuser/.claude-self-reflect/batch_state
     environment:
       - QDRANT_URL=http://qdrant:6333
+      - HF_HUB_OFFLINE=1
       - QDRANT_API_KEY=${QDRANT_API_KEY:-}
       - ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY}
       - CSR_HOME=/home/appuser/.claude-self-reflect
@@ -257,11 +265,11 @@ services:
       - PYTHONUNBUFFERED=1
       - PYTHONPATH=/app
     restart: unless-stopped
-    profiles: ["batch-automation"]
+    # profiles: ["batch-automation"]  # REMOVED - now starts by default
     mem_limit: 2g
     memswap_limit: 2g
     healthcheck:
-      test: ["CMD-SHELL", "ps aux | grep -q '[p]ython.*batch_watcher' || exit 1"]
+      test: ["CMD-SHELL", "kill -0 1 2>/dev/null || exit 1"]
       interval: 30s
       timeout: 10s
       retries: 3
@@ -274,7 +282,7 @@ services:
         labels: "service=batch-watcher"
 
   # Batch monitor - Monitors batch API jobs and triggers evaluations
-  # OPTIONAL: Requires ANTHROPIC_API_KEY. Disabled by default.
+  # Requires ANTHROPIC_API_KEY. Now starts by default.
   batch-monitor:
     build:
       context: .
@@ -287,6 +295,7 @@ services:
       - ${CSR_BATCH_STATE_DIR:-${HOME}/.claude-self-reflect/batch_state}:/home/appuser/.claude-self-reflect/batch_state
     environment:
       - QDRANT_URL=http://qdrant:6333
+      - HF_HUB_OFFLINE=1
       - QDRANT_API_KEY=${QDRANT_API_KEY:-}
       - ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY}
       - CSR_HOME=/home/appuser/.claude-self-reflect
@@ -295,11 +304,11 @@ services:
       - PYTHONUNBUFFERED=1
       - PYTHONPATH=/app
     restart: unless-stopped
-    profiles: ["batch-automation"]
+    # profiles: ["batch-automation"]  # REMOVED - now starts by default
     mem_limit: 512m
     memswap_limit: 512m
     healthcheck:
-      test: ["CMD-SHELL", "ps aux | grep -q '[p]ython.*batch_monitor' || exit 1"]
+      test: ["CMD-SHELL", "kill -0 1 2>/dev/null || exit 1"]
       interval: 30s
       timeout: 10s
       retries: 3

package/installer/setup-wizard-docker.js

@@ -680,28 +680,106 @@ async function startWatcher() {
   }
 }
 
+async function setupRalphHooks() {
+  console.log('\n🐻 Ralph Loop Memory Integration (NEW!)...');
+  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+  console.log('The Ralph Wiggum technique helps Claude maintain context across long sessions.');
+  console.log('With CSR integration, Ralph loops gain cross-session memory!');
+  console.log('');
+  console.log('📊 Benefits:');
+  console.log('   • Session state preserved across context compactions');
+  console.log('   • Past learnings automatically injected into new sessions');
+  console.log('   • Failed approaches remembered to avoid repeating mistakes');
+  console.log('   • Works with the ralph-wiggum Claude Code plugin');
+  console.log('');
+  console.log('📝 How It Works:');
+  console.log('   • SessionStart hook: Searches CSR for past Ralph sessions');
+  console.log('   • PreCompact hook: Backs up state before context is lost');
+  console.log('   • SessionEnd hook: Stores session narrative for future reference');
+  console.log('');
+  console.log('⚙️  Requirements:');
+  console.log('   • ralph-wiggum plugin (Claude Code plugin)');
+  console.log('   • Python 3.8+ (for hooks)');
+  console.log('');
+
+  const enableChoice = await question('Enable Ralph Loop memory integration? (y/n) [recommended]: ');
+
+  if (enableChoice.toLowerCase() === 'y') {
+    console.log('\n📦 Installing Ralph hooks...');
+
+    try {
+      // Check if Python 3 is available
+      try {
+        safeExec('python3', ['--version'], { stdio: 'pipe' });
+      } catch {
+        console.log('\n⚠️  Python 3 not found');
+        console.log('   Ralph hooks require Python 3.8+');
+        console.log('   Install Python and run: ./scripts/ralph/install_hooks.sh');
+        return;
+      }
+
+      // Run the hook installation script
+      const installScript = join(projectRoot, 'scripts', 'ralph', 'install_hooks.sh');
+
+      // Make sure the script is executable
+      try {
+        await fs.chmod(installScript, 0o755);
+      } catch {
+        // Ignore if already executable
+      }
+
+      safeExec('bash', [installScript], {
+        cwd: projectRoot,
+        stdio: 'inherit'
+      });
+
+      console.log('\n✅ Ralph hooks installed successfully!');
+      console.log('');
+      console.log('📋 To use Ralph loops with memory:');
+      console.log('   1. Install ralph-wiggum plugin in Claude Code:');
+      console.log('      /plugin install ralph-wiggum@anthropics');
+      console.log('   2. Start a loop: /ralph-wiggum:ralph-loop "Your task"');
+      console.log('   3. Session state will be automatically backed up to CSR');
+      console.log('');
+      console.log('📊 Verify hook installation:');
+      console.log('   ./scripts/ralph/install_hooks.sh --check');
+
+    } catch (error) {
+      console.log('\n⚠️  Could not install Ralph hooks automatically');
+      console.log(`   Error: ${error.message}`);
+      console.log('   You can install manually: ./scripts/ralph/install_hooks.sh');
+    }
+
+  } else {
+    console.log('\n📝 Skipping Ralph hooks installation.');
+    console.log('   You can install later: ./scripts/ralph/install_hooks.sh');
+    console.log('   Docs: https://github.com/ramakay/claude-self-reflect/blob/main/docs/development/ralph-memory-integration.md');
+  }
+}
+
 async function showFinalInstructions() {
   console.log('\n✅ Setup complete!');
-  
+
   console.log('\n🎯 Your Claude Self-Reflect System:');
   console.log('   • 🌐 Qdrant Dashboard: http://localhost:6333/dashboard/');
   console.log('   • 📊 Status: All services running');
   console.log('   • 🔍 Search: Semantic search with memory decay enabled');
   console.log('   • 🚀 Watcher: HOT/WARM/COLD prioritization active');
-  
+
   console.log('\n📋 Quick Reference Commands:');
   console.log('   • Check status: docker compose ps');
   console.log('   • View logs: docker compose logs -f');
   console.log('   • Import conversations: docker compose run --rm importer');
   console.log('   • Enrich metadata: docker compose run --rm importer python /app/scripts/delta-metadata-update-safe.py');
   console.log('   • Start watcher: docker compose --profile watch up -d');
+  console.log('   • Ralph hooks: ./scripts/ralph/install_hooks.sh --check');
   console.log('   • Stop all: docker compose down');
-  
+
   console.log('\n🎯 Next Steps:');
   console.log('1. Restart Claude Code');
   console.log('2. Look for "claude-self-reflect" in the MCP tools');
   console.log('3. Try: "Search my past conversations about Python"');
-  
+
   console.log('\n📚 Documentation: https://github.com/ramakay/claude-self-reflect');
 }
 
@@ -787,7 +865,7 @@ async function main() {
   
   // Configure Claude
   await configureClaude();
-  
+
   // Import conversations
   await importConversations();
 
@@ -797,9 +875,12 @@ async function main() {
   // Setup batch automation (new in v7.0)
   await setupBatchAutomation();
 
+  // Setup Ralph hooks (new in v7.1 - Memory-Augmented Ralph Loops)
+  await setupRalphHooks();
+
   // Start the watcher
   await startWatcher();
-  
+
   // Show final instructions
   await showFinalInstructions();
   

package/installer/update-manager.js

@@ -94,6 +94,48 @@ class UpdateManager {
         }
     }
 
+    async checkRalphHooks() {
+        // Check if Ralph hooks are installed in ~/.claude/settings.json
+        const claudeSettings = path.join(this.homeDir, '.claude', 'settings.json');
+
+        try {
+            if (!fs.existsSync(claudeSettings)) {
+                return {
+                    installed: false,
+                    name: 'Ralph Memory Hooks',
+                    critical: false,  // Optional feature
+                    fix: () => this.installRalphHooks()
+                };
+            }
+
+            const settings = JSON.parse(fs.readFileSync(claudeSettings, 'utf8'));
+
+            // Check for Ralph hooks in SessionStart or SessionEnd
+            const hasRalphHooks = settings.hooks &&
+                (
+                    (settings.hooks.SessionStart &&
+                     JSON.stringify(settings.hooks.SessionStart).includes('ralph')) ||
+                    (settings.hooks.SessionEnd &&
+                     JSON.stringify(settings.hooks.SessionEnd).includes('ralph'))
+                );
+
+            return {
+                installed: hasRalphHooks,
+                name: 'Ralph Memory Hooks',
+                critical: false,  // Optional feature
+                fix: hasRalphHooks ? null : () => this.installRalphHooks()
+            };
+        } catch (error) {
+            return {
+                installed: false,
+                name: 'Ralph Memory Hooks',
+                critical: false,
+                fix: () => this.installRalphHooks(),
+                error: `Could not check Ralph hooks: ${error.message}`
+            };
+        }
+    }
+
     async checkDocker() {
         try {
             execSync('docker info', { stdio: 'ignore' });
@@ -265,6 +307,48 @@ class UpdateManager {
         }
     }
 
+    async installRalphHooks() {
+        this.log('Installing Ralph Memory Hooks...', 'info');
+
+        // Check if Python 3 is available
+        try {
+            execSync('python3 --version', { stdio: 'ignore' });
+        } catch {
+            this.log('Python 3 is required for Ralph hooks', 'error');
+            this.log('Install Python 3.8+ and run: ./scripts/ralph/install_hooks.sh', 'info');
+            return false;
+        }
+
+        const installScript = path.join(this.packageRoot, 'scripts', 'ralph', 'install_hooks.sh');
+
+        if (!fs.existsSync(installScript)) {
+            this.log(`Ralph hooks script not found: ${installScript}`, 'error');
+            return false;
+        }
+
+        try {
+            // Make sure the script is executable
+            fs.chmodSync(installScript, 0o755);
+
+            execSync(`bash "${installScript}"`, {
+                cwd: this.packageRoot,
+                stdio: 'inherit'
+            });
+
+            this.log('Ralph Memory Hooks installed successfully!', 'success');
+            this.log('', 'info');
+            this.log('To use Ralph loops with memory:', 'info');
+            this.log('  1. Install plugin: /plugin install ralph-wiggum@anthropics', 'info');
+            this.log('  2. Start a loop: /ralph-wiggum:ralph-loop "Your task"', 'info');
+            this.log('  3. Session state will be automatically backed up to CSR', 'info');
+            return true;
+        } catch (error) {
+            this.log(`Failed to install Ralph hooks: ${error.message}`, 'error');
+            this.log('You can install manually: ./scripts/ralph/install_hooks.sh', 'info');
+            return false;
+        }
+    }
+
     async startQdrant() {
         this.log('Starting Qdrant...', 'info');
 
@@ -313,7 +397,8 @@ class UpdateManager {
             { name: 'Docker Config', fn: () => this.checkDockerComposeConfig() },
             { name: 'cc-statusline', fn: () => this.checkCCStatusline() },
             { name: 'csr-status', fn: () => this.checkCSRStatusScript() },
-            { name: 'AST-Grep', fn: () => this.checkASTGrep() }
+            { name: 'AST-Grep', fn: () => this.checkASTGrep() },
+            { name: 'Ralph Hooks', fn: () => this.checkRalphHooks() }
         ];
 
         const settledResults = await Promise.allSettled(checks.map(c => c.fn()));
@@ -391,6 +476,8 @@ class UpdateManager {
                             recheckResult = await this.checkCSRStatusScript();
                         } else if (recheckName.includes('ast-grep')) {
                             recheckResult = await this.checkASTGrep();
+                        } else if (recheckName.includes('ralph')) {
+                            recheckResult = await this.checkRalphHooks();
                         }
 
                         // Guard against undefined recheckResult (no matching verifier)