claude-self-reflect 6.0.5 → 7.1.8

package/docker-compose.yaml

@@ -2,13 +2,16 @@ volumes:
   qdrant_data:
 
 services:
-  # Fix permissions for config directory
+  # 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: chown -R 1000:1000 /config
+    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:-~/.claude-self-reflect/config}:/config
-    profiles: ["watch", "import", "async", "safe-watch"]
+      - ${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
+    # No profiles = starts by default (required for batch services)
 
   # Qdrant vector database - the heart of semantic search
   qdrant:
@@ -20,7 +23,7 @@ services:
       - qdrant_data:/qdrant/storage
       # Note: Using CONFIG_PATH variable to support global npm installs (fixes #71)
       # macOS Docker Desktop restricts mounts to /Users, /Volumes, /private, /tmp
-      - ${CONFIG_PATH:-~/.claude-self-reflect/config}/qdrant-config.yaml:/qdrant/config/config.yaml:ro
+      - ${CONFIG_PATH:-${HOME}/.claude-self-reflect/config}/qdrant-config.yaml:/qdrant/config/config.yaml:ro
     environment:
       - QDRANT__LOG_LEVEL=INFO
       - QDRANT__SERVICE__HTTP_PORT=6333
@@ -38,10 +41,11 @@ services:
       - init-permissions
       - qdrant
     volumes:
-      - ${CLAUDE_LOGS_PATH:-~/.claude/projects}:/logs:ro
-      - ${CONFIG_PATH:-~/.claude-self-reflect/config}:/config
+      - ${CLAUDE_LOGS_PATH:-${HOME}/.claude/projects}:/logs:ro
+      - ${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:-}
@@ -67,11 +71,12 @@ services:
       - init-permissions
       - qdrant
     volumes:
-      - ${CLAUDE_LOGS_PATH:-~/.claude/projects}:/logs:ro
-      - ${CONFIG_PATH:-~/.claude-self-reflect/config}:/config
+      - ${CLAUDE_LOGS_PATH:-${HOME}/.claude/projects}:/logs:ro
+      - ${CONFIG_PATH:-${HOME}/.claude-self-reflect/config}:/config
       - /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:-}
@@ -97,10 +102,11 @@ services:
       - init-permissions
       - qdrant
     volumes:
-      - ${CLAUDE_LOGS_PATH:-~/.claude/projects}:/logs:ro
-      - ${CONFIG_PATH:-~/.claude-self-reflect/config}:/config
+      - ${CLAUDE_LOGS_PATH:-${HOME}/.claude/projects}:/logs:ro
+      - ${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:-}
@@ -136,10 +142,11 @@ services:
     depends_on:
       - qdrant
     volumes:
-      - ${CLAUDE_LOGS_PATH:-~/.claude/projects}:/logs:ro
-      - ${CONFIG_PATH:-~/.claude-self-reflect/config}:/config
+      - ${CLAUDE_LOGS_PATH:-${HOME}/.claude/projects}:/logs:ro
+      - ${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:-}
@@ -171,10 +178,11 @@ services:
       - init-permissions
       - qdrant
     volumes:
-      - ${CLAUDE_LOGS_PATH:-~/.claude/projects}:/logs:ro
-      - ${CONFIG_PATH:-~/.claude-self-reflect/config}:/config
+      - ${CLAUDE_LOGS_PATH:-${HOME}/.claude/projects}:/logs:ro
+      - ${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:-}
@@ -210,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}
@@ -221,6 +230,96 @@ services:
     tty: true
     profiles: ["mcp"]
 
+  # Batch watcher - Queues conversations and triggers batch narrative generation
+  # 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: .
+      dockerfile: Dockerfile.batch-watcher
+    container_name: claude-reflection-batch-watcher
+    depends_on:
+      - init-permissions
+      - qdrant
+    volumes:
+      - ${CLAUDE_LOGS_PATH:-${HOME}/.claude/projects}:/logs:ro
+      - ${CONFIG_PATH:-${HOME}/.claude-self-reflect/config}:/home/appuser/.claude-self-reflect/config
+      - ${CSR_BATCH_QUEUE_DIR:-${HOME}/.claude-self-reflect/batch_queue}:/home/appuser/.claude-self-reflect/batch_queue
+      - ${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
+      - CSR_CONFIG_DIR=/home/appuser/.claude-self-reflect/config
+      - CSR_BATCH_QUEUE_DIR=/home/appuser/.claude-self-reflect/batch_queue
+      - CSR_BATCH_STATE_DIR=/home/appuser/.claude-self-reflect/batch_state
+      - CLAUDE_PROJECTS_DIR=/logs
+      - BATCH_SIZE_TRIGGER=${BATCH_SIZE_TRIGGER:-10}
+      - BATCH_TIME_TRIGGER_MINUTES=${BATCH_TIME_TRIGGER_MINUTES:-30}
+      - HOT_WINDOW_MINUTES=${HOT_WINDOW_MINUTES:-5}
+      - WARM_WINDOW_HOURS=${WARM_WINDOW_HOURS:-24}
+      - MAX_COLD_FILES=${MAX_COLD_FILES:-5}
+      - SUBPROCESS_TIMEOUT_SECONDS=${SUBPROCESS_TIMEOUT_SECONDS:-1800}
+      - PYTHONUNBUFFERED=1
+      - PYTHONPATH=/app
+    restart: unless-stopped
+    # profiles: ["batch-automation"]  # REMOVED - now starts by default
+    mem_limit: 2g
+    memswap_limit: 2g
+    healthcheck:
+      test: ["CMD-SHELL", "kill -0 1 2>/dev/null || exit 1"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 10s
+    logging:
+      driver: "json-file"
+      options:
+        max-size: "10m"
+        max-file: "3"
+        labels: "service=batch-watcher"
+
+  # Batch monitor - Monitors batch API jobs and triggers evaluations
+  # Requires ANTHROPIC_API_KEY. Now starts by default.
+  batch-monitor:
+    build:
+      context: .
+      dockerfile: Dockerfile.batch-monitor
+    container_name: claude-reflection-batch-monitor
+    depends_on:
+      - init-permissions
+      - qdrant
+    volumes:
+      - ${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
+      - CSR_BATCH_STATE_DIR=/home/appuser/.claude-self-reflect/batch_state
+      - CHECK_INTERVAL=${BATCH_MONITOR_INTERVAL:-60}
+      - PYTHONUNBUFFERED=1
+      - PYTHONPATH=/app
+    restart: unless-stopped
+    # profiles: ["batch-automation"]  # REMOVED - now starts by default
+    mem_limit: 512m
+    memswap_limit: 512m
+    healthcheck:
+      test: ["CMD-SHELL", "kill -0 1 2>/dev/null || exit 1"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 10s
+    logging:
+      driver: "json-file"
+      options:
+        max-size: "10m"
+        max-file: "3"
+        labels: "service=batch-monitor"
+
 networks:
   default:
     name: claude-reflection-network

package/installer/setup-wizard-docker.js

@@ -557,6 +557,109 @@ async function enrichMetadata() {
   }
 }
 
+async function setupBatchAutomation() {
+  console.log('\n🚀 AI-Powered Narratives (NEW in v7.0!)...');
+  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+  console.log('Transform your conversations into rich, searchable narratives.');
+  console.log('');
+  console.log('📊 Benefits:');
+  console.log('   • 9.3x better search quality (0.074 → 0.691 relevance score)');
+  console.log('   • 82% token compression while maintaining searchability');
+  console.log('   • 50% cost savings using Anthropic Batch API (~$0.012/conversation)');
+  console.log('   • Automatic extraction: tools used, files modified, concepts');
+  console.log('');
+  console.log('📝 What You Get:');
+  console.log('   • Problem-solution structured summaries');
+  console.log('   • Rich metadata (tools, concepts, files)');
+  console.log('   • Fully automated batch processing');
+  console.log('');
+  console.log('⚙️  How It Works:');
+  console.log('   1. Background watcher queues new conversations');
+  console.log('   2. Auto-triggers batch when threshold reached (default: 10)');
+  console.log('   3. Anthropic Batch API generates narratives');
+  console.log('   4. Enhanced narratives auto-imported to Qdrant');
+  console.log('');
+  console.log('🔐 Privacy: Conversations sent to Anthropic Batch API for narrative generation.');
+  console.log('   Review: https://www.anthropic.com/privacy');
+  console.log('');
+
+  const enableChoice = await question('Enable AI-powered narratives? (y/n) [recommended for best search]: ');
+
+  if (enableChoice.toLowerCase() === 'y') {
+    console.log('\n🔑 Anthropic API Key Required');
+    console.log('   Get your key: https://console.anthropic.com/settings/keys');
+    console.log('   Cost: ~$0.012 per conversation via Batch API');
+
+    const apiKey = await question('\nPaste your Anthropic API key (sk-ant-...): ');
+
+    if (apiKey && apiKey.trim().startsWith('sk-ant-')) {
+      // Read current .env
+      const envPath = path.join(projectRoot, '.env');
+      let envContent = '';
+      try {
+        envContent = await fs.readFile(envPath, 'utf8');
+      } catch {
+        // File doesn't exist yet
+      }
+
+      // Remove existing ANTHROPIC_API_KEY if present
+      envContent = envContent.replace(/ANTHROPIC_API_KEY=.*/g, '');
+
+      // Add new key
+      envContent += `\n# Batch Automation (v7.0 AI-Powered Narratives)\nANTHROPIC_API_KEY=${apiKey.trim()}\n`;
+
+      // Write back
+      await fs.writeFile(envPath, envContent.trim() + '\n');
+
+      console.log('✅ API key saved to .env');
+
+      // Start batch automation services
+      console.log('\n🚀 Starting batch automation services...');
+      try {
+        safeExec('docker', ['compose', '--profile', 'batch-automation', 'up', '-d'], {
+          cwd: projectRoot,
+          stdio: 'inherit'
+        });
+
+        console.log('\n✅ Batch automation enabled!');
+        console.log('   • batch-watcher: Monitors for new conversations');
+        console.log('   • batch-monitor: Processes narrative generation');
+        console.log('');
+        console.log('📊 Monitor Progress:');
+        console.log('   docker compose logs batch-watcher -f');
+        console.log('   docker compose logs batch-monitor -f');
+        console.log('');
+        console.log('🎯 Next: New conversations will be automatically enhanced with narratives');
+
+      } catch (error) {
+        console.log('\n⚠️  Could not start batch services automatically');
+        console.log('   Start manually: docker compose --profile batch-automation up -d');
+      }
+
+    } else if (apiKey && apiKey.trim()) {
+      console.log('\n❌ Invalid API key format. Anthropic keys start with "sk-ant-"');
+      console.log('   Skipping batch automation. You can enable it later by:');
+      console.log('   1. Adding ANTHROPIC_API_KEY to .env');
+      console.log('   2. Running: docker compose --profile batch-automation up -d');
+    } else {
+      console.log('\n📝 Skipping batch automation.');
+      console.log('   You can enable it later by:');
+      console.log('   1. Get API key: https://console.anthropic.com/settings/keys');
+      console.log('   2. Add to .env: ANTHROPIC_API_KEY=sk-ant-...');
+      console.log('   3. Run: docker compose --profile batch-automation up -d');
+    }
+
+  } else {
+    console.log('\n📝 Skipping batch automation (staying with standard search).');
+    console.log('   You can enable AI narratives later by:');
+    console.log('   1. Get API key: https://console.anthropic.com/settings/keys');
+    console.log('   2. Add to .env: ANTHROPIC_API_KEY=sk-ant-...');
+    console.log('   3. Run: docker compose --profile batch-automation up -d');
+    console.log('');
+    console.log('💡 Tip: Even without narratives, you still get excellent local search!');
+  }
+}
+
 async function startWatcher() {
   console.log('\n🔄 Starting the streaming watcher...');
   console.log('   • HOT files (<5 min): 2-second processing');
@@ -577,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');
 }
 
@@ -684,16 +865,22 @@ async function main() {
   
   // Configure Claude
   await configureClaude();
-  
+
   // Import conversations
   await importConversations();
-  
+
   // Enrich metadata (new in v2.5.19)
   await enrichMetadata();
-  
+
+  // 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)