moflo 4.8.25 → 4.8.26

package/bin/hooks.mjs

@@ -1,656 +1,696 @@
-#!/usr/bin/env node
-/**
- * Cross-platform Claude Code hook runner
- * Works on Windows (cmd/powershell) and Linux/WSL (bash)
- *
- * Usage: node .claude/scripts/hooks.mjs <hook-type> [args...]
- *
- * Hook types:
- *   pre-edit --file <path>
- *   post-edit --file <path> --success <bool>
- *   pre-command --command <cmd>
- *   post-command --command <cmd> --success <bool>
- *   pre-task --description <desc>
- *   post-task --task-id <id> --success <bool>
- *   session-start
- *   session-restore --session-id <id>
- *   route --task <prompt>
- *   index-guidance [--file <path>] [--force]
- *   daemon-start
- */
-
-import { spawn } from 'child_process';
-import { existsSync, appendFileSync, readFileSync, writeFileSync, mkdirSync, statSync } from 'fs';
-import { resolve, dirname } from 'path';
-import { fileURLToPath } from 'url';
-import { createProcessManager } from './lib/process-manager.mjs';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-const projectRoot = resolve(__dirname, '../..');
-const logFile = resolve(projectRoot, '.swarm/hooks.log');
-const pm = createProcessManager(projectRoot);
-
-// Parse command line args
-const args = process.argv.slice(2);
-const hookType = args[0];
-
-// Simple log function - writes to .swarm/hooks.log
-function log(level, message) {
-  const timestamp = new Date().toISOString();
-  const line = `[${timestamp}] [${level.toUpperCase()}] [${hookType || 'unknown'}] ${message}\n`;
-
-  // Always log errors to stderr so they're visible in Claude
-  if (level === 'error') {
-    console.error(`[hook:${hookType}] ${message}`);
-  }
-
-  // Also append to log file for history
-  try {
-    appendFileSync(logFile, line);
-  } catch {
-    // Can't write log - that's fine, don't fail
-  }
-}
-
-// Helper to get arg value
-function getArg(name) {
-  const idx = args.indexOf(`--${name}`);
-  if (idx !== -1 && args[idx + 1]) {
-    return args[idx + 1];
-  }
-  // Also check environment variables (Claude sets these)
-  const envName = `TOOL_INPUT_${name}`.replace(/-/g, '_');
-  return process.env[envName] || process.env[name.toUpperCase()] || null;
-}
-
-// Helper to check if arg/flag exists
-function hasArg(name) {
-  return args.includes(`--${name}`);
-}
-
-// Get the local CLI path (preferred - no network/extraction overhead)
-function getLocalCliPath() {
-  const localCli = resolve(projectRoot, 'node_modules/moflo/src/@claude-flow/cli/bin/cli.js');
-  return existsSync(localCli) ? localCli : null;
-}
-
-// Check if running on Windows
-const isWindows = process.platform === 'win32';
-
-// Run a command and return promise with exit code
-function runCommand(cmd, cmdArgs, options = {}) {
-  return new Promise((resolve) => {
-    let stderr = '';
-
-    // Use windowsHide: true directly - no PowerShell wrapper needed
-    // The wrapper can actually cause MORE flashes as PowerShell starts
-    const proc = spawn(cmd, cmdArgs, {
-      stdio: options.silent ? ['ignore', 'ignore', 'pipe'] : 'inherit',
-      shell: false,
-      cwd: projectRoot,
-      env: { ...process.env, ...options.env },
-      detached: options.background || false,
-      windowsHide: true  // This is sufficient on Windows when shell: false
-    });
-
-    // Capture stderr even in silent mode
-    if (proc.stderr) {
-      proc.stderr.on('data', (data) => {
-        stderr += data.toString();
-      });
-    }
-
-    proc.on('close', (code) => {
-      if (code !== 0 && stderr) {
-        log('error', `Command failed (exit ${code}): ${cmd} ${cmdArgs.join(' ')}`);
-        if (stderr.trim()) {
-          log('error', `  stderr: ${stderr.trim().substring(0, 200)}`);
-        }
-      }
-      resolve(code || 0);
-    });
-
-    proc.on('error', (err) => {
-      log('error', `Command error: ${cmd} - ${err.message}`);
-      resolve(1);
-    });
-  });
-}
-
-// Show Windows toast notification (works on native Windows and WSL)
-async function showWindowsToast(title, message) {
-  // PowerShell script to show toast notification
-  const psScript = `
-[Windows.UI.Notifications.ToastNotificationManager, Windows.UI.Notifications, ContentType = WindowsRuntime] | Out-Null
-$template = [Windows.UI.Notifications.ToastNotificationManager]::GetTemplateContent([Windows.UI.Notifications.ToastTemplateType]::ToastText02)
-$text = $template.GetElementsByTagName('text')
-$text.Item(0).AppendChild($template.CreateTextNode('${title.replace(/'/g, "''")}')) | Out-Null
-$text.Item(1).AppendChild($template.CreateTextNode('${message.replace(/'/g, "''")}')) | Out-Null
-$toast = [Windows.UI.Notifications.ToastNotification]::new($template)
-[Windows.UI.Notifications.ToastNotificationManager]::CreateToastNotifier('Claude Code').Show($toast)
-`.trim();
-
-  // Encode script as base64 for -EncodedCommand (avoids shell escaping issues)
-  const encodedScript = Buffer.from(psScript, 'utf16le').toString('base64');
-
-  try {
-    // Detect environment and use appropriate PowerShell command
-    const isWSL = process.platform === 'linux' && existsSync('/proc/version') &&
-      (await import('fs')).readFileSync('/proc/version', 'utf-8').toLowerCase().includes('microsoft');
-
-    if (process.platform === 'win32') {
-      // Native Windows - use powershell with encoded command (avoids cmd.exe escaping issues)
-      await runCommand('powershell', ['-NoProfile', '-WindowStyle', 'Hidden', '-EncodedCommand', encodedScript], { silent: true });
-      log('debug', 'Toast notification sent via PowerShell');
-    } else if (isWSL) {
-      // WSL - use powershell.exe to call Windows PowerShell
-      await runCommand('powershell.exe', ['-NoProfile', '-WindowStyle', 'Hidden', '-EncodedCommand', encodedScript], { silent: true });
-      log('debug', 'Toast notification sent via powershell.exe (WSL)');
-    } else {
-      // Linux/Mac - no Windows toast available, just log
-      log('debug', 'Windows toast not available on this platform');
-    }
-  } catch (err) {
-    // Toast notifications are nice-to-have, don't fail the hook
-    log('debug', `Toast notification failed: ${err.message}`);
-  }
-}
-
-// Run claude-flow CLI command using local installation
-async function runClaudeFlow(subcommand, cliArgs = []) {
-  const localCli = getLocalCliPath();
-
-  if (localCli) {
-    // Use local CLI (fastest, no network/extraction)
-    const fullArgs = [localCli, subcommand, ...cliArgs];
-    const exitCode = await runCommand('node', fullArgs, { silent: true });
-
-    if (exitCode !== 0) {
-      log('warn', `claude-flow ${subcommand} exited with code ${exitCode}`);
-    }
-
-    return exitCode;
-  } else {
-    log('warn', 'Local CLI not found. Install with: npm install @claude-flow/cli');
-    return 1;
-  }
-}
-
-// Main hook dispatcher
-async function main() {
-  if (!hookType) {
-    console.error('Usage: node hooks.mjs <hook-type> [args...]');
-    process.exit(1);
-  }
-
-  try {
-    switch (hookType) {
-      case 'pre-edit': {
-        const file = getArg('file') || process.env.TOOL_INPUT_file_path;
-        if (file) {
-          await runClaudeFlow('hooks', ['pre-edit', '--file', file]);
-        }
-        break;
-      }
-
-      case 'post-edit': {
-        const file = getArg('file') || process.env.TOOL_INPUT_file_path;
-        const success = getArg('success') || process.env.TOOL_SUCCESS || 'true';
-        if (file) {
-          await runClaudeFlow('hooks', ['post-edit', '--file', file, '--success', success]);
-
-          // Check if this is a guidance file that needs indexing (run in background)
-          if (file.includes('.claude/guidance/') || file.includes('.claude/skills/cl/')) {
-            runIndexGuidanceBackground(file);
-          }
-        }
-        break;
-      }
-
-      case 'pre-command': {
-        const command = getArg('command') || process.env.TOOL_INPUT_command;
-        if (command) {
-          await runClaudeFlow('hooks', ['pre-command', '--command', command]);
-        }
-        break;
-      }
-
-      case 'post-command': {
-        const command = getArg('command') || process.env.TOOL_INPUT_command;
-        const success = getArg('success') || process.env.TOOL_SUCCESS || 'true';
-        if (command) {
-          await runClaudeFlow('hooks', ['post-command', '--command', command, '--success', success]);
-        }
-        break;
-      }
-
-      case 'pre-task': {
-        const description = getArg('description') || process.env.TOOL_INPUT_prompt;
-        if (description) {
-          const taskId = `task-${Date.now()}`;
-          await runClaudeFlow('hooks', ['pre-task', '--task-id', taskId, '--description', description]);
-        }
-        break;
-      }
-
-      case 'pre-research': {
-        // Memory-first gate: remind to search memory before exploring codebase
-        // This fires on Glob/Grep to catch research-style queries
-        const pattern = process.env.TOOL_INPUT_pattern || getArg('pattern');
-        const query = process.env.TOOL_INPUT_query || getArg('query');
-        const searchTerm = pattern || query;
-
-        // Only remind if this looks like a research query (not a specific path lookup)
-        if (searchTerm && !searchTerm.includes('/') && !searchTerm.match(/\.(ts|tsx|js|json|md)$/)) {
-          console.log('[MEMORY GATE] Did you search memory first? Run: memory search --query "[topic]" --namespace guidance');
-        }
-        break;
-      }
-
-      case 'post-task': {
-        const taskId = getArg('task-id') || process.env.TOOL_RESULT_agent_id;
-        const success = getArg('success') || process.env.TOOL_SUCCESS || 'true';
-        if (taskId) {
-          await runClaudeFlow('hooks', ['post-task', '--task-id', taskId, '--success', success]);
-        }
-        break;
-      }
-
-      case 'session-start': {
-        // All startup tasks run in background (non-blocking)
-        // Start daemon quietly in background
-        runDaemonStartBackground();
-        // Index guidance files in background
-        runIndexGuidanceBackground();
-        // Generate structural code map in background
-        runCodeMapBackground();
-        // Index test files in background
-        runTestIndexBackground();
-        // Run pretrain in background to extract patterns from repository
-        runBackgroundPretrain();
-        // Force HNSW rebuild to ensure all processes use identical fresh index
-        // This fixes agent search result mismatches (0.61 vs 0.81 similarity)
-        runHNSWRebuildBackground();
-        // Neural patterns now loaded by moflo core routing — no external patching.
-        break;
-      }
-
-      case 'session-restore': {
-        const sessionId = getArg('session-id') || process.env.SESSION_ID;
-        if (sessionId) {
-          await runClaudeFlow('hooks', ['session-restore', '--session-id', sessionId]);
-        }
-        break;
-      }
-
-      case 'route': {
-        const task = getArg('task') || process.env.PROMPT;
-        if (task) {
-          // Check for /cl command and output gate reminder
-          if (task.includes('/cl') || task.match(/^cl\s/)) {
-            const hasHelpFlag = task.includes('-h') || task.includes('--help');
-            const hasNakedFlag = task.includes('-n') || task.includes('--naked');
-
-            if (!hasHelpFlag && !hasNakedFlag) {
-              // Output visible reminder - this appears in Claude's context
-              console.log('[SWARM GATE] /cl detected. Required order: TaskList() → TaskCreate() → swarm init → Task(run_in_background)');
-              console.log('[SWARM GATE] Do NOT call GitHub/Grep/Read until tasks are created.');
-            }
-          }
-          await runClaudeFlow('hooks', ['route', '--task', task]);
-        }
-        break;
-      }
-
-      case 'index-guidance': {
-        const file = getArg('file');
-        await runIndexGuidance(file);
-        break;
-      }
-
-      case 'daemon-start': {
-        if (isDaemonLockHeld()) {
-          log('info', 'Daemon already running (lock held), skipping start');
-        } else if (isDaemonSpawnRecent()) {
-          log('info', 'Daemon spawn debounced (recent attempt), skipping');
-        } else {
-          touchSpawnStamp();
-          await runClaudeFlow('daemon', ['start', '--quiet']);
-        }
-        break;
-      }
-
-      case 'session-end': {
-        // Kill all tracked background processes before ending session
-        const killResult = pm.killAll();
-        if (killResult.killed > 0) {
-          log('info', `Killed ${killResult.killed} background process(es) on session end`);
-        }
-
-        // Run ReasoningBank and MicroLoRA training in background on session end
-        log('info', 'Session ending - starting background learning...');
-
-        // Run session-end hook (persists state)
-        await runClaudeFlow('hooks', ['session-end', '--persist-state', 'true']);
-
-        // Start background training (non-blocking)
-        runBackgroundTraining();
-        break;
-      }
-
-
-      case 'semantic-search': {
-        // Semantic search using embeddings
-        const query = getArg('query') || args[1];
-        const searchLimit = getArg('limit') || '5';
-        const threshold = getArg('threshold') || '0.3';
-        const searchScript = resolve(projectRoot, 'bin/semantic-search.mjs');
-
-        if (query && existsSync(searchScript)) {
-          const searchArgs = [searchScript, query, '--limit', searchLimit, '--threshold', threshold];
-          if (getArg('namespace')) searchArgs.push('--namespace', getArg('namespace'));
-          if (hasArg('json')) searchArgs.push('--json');
-          // semantic-search.mjs uses better-sqlite3
-          await runCommand('node', searchArgs, { silent: false });
-        } else if (!query) {
-          console.log('Usage: node .claude/scripts/hooks.mjs semantic-search --query "your query"');
-        } else {
-          log('error', 'Semantic search script not found');
-        }
-        break;
-      }
-
-      case 'notification': {
-        // Handle notification hook - show Windows toast if possible
-        const message = process.env.NOTIFICATION_MESSAGE || getArg('message') || 'Claude Code needs your attention';
-        const title = getArg('title') || 'Claude Code';
-        await showWindowsToast(title, message);
-        log('info', 'Notification hook triggered');
-        break;
-      }
-
-      default:
-        // Unknown hook type - just pass through to claude-flow
-        log('info', `Passing through unknown hook: ${hookType}`);
-        await runClaudeFlow('hooks', args);
-    }
-  } catch (err) {
-    // Log the error but don't block Claude
-    log('error', `Hook exception: ${err.message}`);
-    process.exit(0);
-  }
-
-  process.exit(0);
-}
-
-// Run the guidance indexer (blocking - used for specific file updates)
-async function runIndexGuidance(specificFile = null) {
-  const indexCandidates = [
-    resolve(dirname(fileURLToPath(import.meta.url)), 'index-guidance.mjs'),
-    resolve(projectRoot, '.claude/scripts/index-guidance.mjs'),
-  ];
-  const indexScript = indexCandidates.find(p => existsSync(p));
-
-  if (indexScript) {
-    const indexArgs = specificFile ? ['--file', specificFile] : [];
-    if (hasArg('force')) indexArgs.push('--force');
-    // index-guidance.mjs uses better-sqlite3
-    const code = await runCommand('node', [indexScript, ...indexArgs], { silent: true });
-    if (code !== 0) {
-      log('warn', `index-guidance.mjs exited with code ${code}`);
-    }
-    return code;
-  }
-
-  log('warn', 'Guidance indexer not found');
-  return 0;
-}
-
-// Spawn a background process via the shared ProcessManager (dedup + PID tracking).
-function spawnWindowless(cmd, args, description) {
-  const result = pm.spawn(cmd, args, description);
-  if (result.skipped) {
-    log('info', `Skipped ${description} (already running, PID: ${result.pid})`);
-  } else if (result.pid) {
-    log('info', `Started ${description} (PID: ${result.pid})`);
-  }
-  return result;
-}
-
-// Resolve a moflo npm bin script, falling back to local .claude/scripts/ copy
-function resolveBinOrLocal(binName, localScript) {
-  // 1. npm bin from moflo package (always up to date with published version)
-  const mofloScript = resolve(projectRoot, 'node_modules/moflo/bin', localScript);
-  if (existsSync(mofloScript)) return mofloScript;
-
-  // 2. npm bin from .bin (symlinked by npm install)
-  const npmBin = resolve(projectRoot, 'node_modules/.bin', binName);
-  if (existsSync(npmBin)) return npmBin;
-
-  // 3. Local .claude/scripts/ copy (may be stale but better than nothing)
-  const localPath = resolve(projectRoot, '.claude/scripts', localScript);
-  if (existsSync(localPath)) return localPath;
-
-  return null;
-}
-
-// Run the guidance indexer in background (non-blocking - used for session start and file changes)
-function runIndexGuidanceBackground(specificFile = null) {
-  // Check auto_index.guidance flag in moflo.yaml (default: true)
-  // Only gate full indexing on session-start; per-file calls from post-edit always run
-  if (!specificFile) {
-    const yamlPath = resolve(projectRoot, 'moflo.yaml');
-    if (existsSync(yamlPath)) {
-      try {
-        const content = readFileSync(yamlPath, 'utf-8');
-        const match = content.match(/auto_index:\s*\n(?:.*\n)*?\s+guidance:\s*(true|false)/);
-        if (match && match[1] === 'false') {
-          log('info', 'Guidance indexing disabled (auto_index.guidance: false)');
-          return;
-        }
-      } catch { /* ignore, proceed with indexing */ }
-    }
-  }
-
-  const indexScript = resolveBinOrLocal('flo-index', 'index-guidance.mjs');
-
-  if (!indexScript) {
-    log('warn', 'Guidance indexer not found (checked npm bin + .claude/scripts/)');
-    return;
-  }
-
-  const indexArgs = [indexScript];
-  if (specificFile) indexArgs.push('--file', specificFile);
-
-  const desc = specificFile ? `background indexing file: ${specificFile}` : 'background indexing (full)';
-  spawnWindowless('node', indexArgs, desc);
-}
-
-// Run structural code map generator in background (non-blocking)
-function runCodeMapBackground() {
-  // Check auto_index.code_map flag in moflo.yaml (default: true)
-  const yamlPath = resolve(projectRoot, 'moflo.yaml');
-  if (existsSync(yamlPath)) {
-    try {
-      const content = readFileSync(yamlPath, 'utf-8');
-      const match = content.match(/auto_index:\s*\n(?:.*\n)*?\s+code_map:\s*(true|false)/);
-      if (match && match[1] === 'false') {
-        log('info', 'Code map generation disabled (auto_index.code_map: false)');
-        return;
-      }
-    } catch { /* ignore, proceed with indexing */ }
-  }
-
-  const codeMapScript = resolveBinOrLocal('flo-codemap', 'generate-code-map.mjs');
-
-  if (!codeMapScript) {
-    log('warn', 'Code map generator not found (checked npm bin + .claude/scripts/)');
-    return;
-  }
-
-  spawnWindowless('node', [codeMapScript], 'background code map generation');
-}
-
-// Run test file indexer in background (non-blocking)
-function runTestIndexBackground() {
-  // Check auto_index.tests flag in moflo.yaml (default: true)
-  const yamlPath = resolve(projectRoot, 'moflo.yaml');
-  if (existsSync(yamlPath)) {
-    try {
-      const content = readFileSync(yamlPath, 'utf-8');
-      const match = content.match(/auto_index:\s*\n(?:.*\n)*?\s+tests:\s*(true|false)/);
-      if (match && match[1] === 'false') {
-        log('info', 'Test indexing disabled (auto_index.tests: false)');
-        return;
-      }
-    } catch { /* ignore, proceed with indexing */ }
-  }
-
-  const testIndexScript = resolveBinOrLocal('flo-testmap', 'index-tests.mjs');
-
-  if (!testIndexScript) {
-    log('info', 'Test indexer not found (checked npm bin + .claude/scripts/)');
-    return;
-  }
-
-  spawnWindowless('node', [testIndexScript], 'background test indexing');
-}
-
-// Run ReasoningBank + MicroLoRA training + EWC++ consolidation in background (non-blocking)
-function runBackgroundTraining() {
-  const localCli = getLocalCliPath();
-  if (!localCli) {
-    log('warn', 'Local CLI not found, skipping background training');
-    return;
-  }
-
-  // Pattern types to train with MicroLoRA
-  const patternTypes = ['coordination', 'routing', 'debugging'];
-
-  for (const ptype of patternTypes) {
-    spawnWindowless('node', [localCli, 'neural', 'train', '--pattern-type', ptype, '--epochs', '2'], `MicroLoRA training: ${ptype}`);
-  }
-
-  // Run pretrain to update ReasoningBank
-  spawnWindowless('node', [localCli, 'hooks', 'pretrain'], 'ReasoningBank pretrain');
-
-  // Run EWC++ memory consolidation (prevents catastrophic forgetting)
-  spawnWindowless('node', [localCli, 'hooks', 'worker', 'dispatch', '--trigger', 'consolidate', '--background'], 'EWC++ consolidation');
-
-  // Run neural optimize (Int8 quantization, memory compression)
-  spawnWindowless('node', [localCli, 'neural', 'optimize'], 'neural optimize');
-}
-
-// Delegate to daemon-lock.js for proper PID + command-line verification.
-// Falls back to a naive kill(0) check if the import fails (e.g. dist not built).
-let _getDaemonLockHolder = null;
-try {
-  const daemonLockPath = resolve(__dirname, '..', 'src', '@claude-flow', 'cli', 'dist', 'src', 'services', 'daemon-lock.js');
-  if (existsSync(daemonLockPath)) {
-    const mod = await import('file://' + daemonLockPath.replace(/\\/g, '/'));
-    _getDaemonLockHolder = mod.getDaemonLockHolder;
-  }
-} catch { /* fallback below */ }
-
-function isDaemonLockHeld() {
-  // Prefer the real daemon-lock module (PID + command-line verification)
-  if (_getDaemonLockHolder) {
-    return _getDaemonLockHolder(projectRoot) !== null;
-  }
-
-  // Fallback: naive PID check (only if daemon-lock.js unavailable)
-  const lockFile = resolve(projectRoot, '.claude-flow', 'daemon.lock');
-  if (!existsSync(lockFile)) return false;
-  try {
-    const data = JSON.parse(readFileSync(lockFile, 'utf-8'));
-    if (typeof data.pid === 'number' && data.pid > 0) {
-      process.kill(data.pid, 0);
-      return true;
-    }
-  } catch {
-    // Dead process or corrupt file — lock is stale
-  }
-  return false;
-}
-
-// Debounce file — prevents thundering-herd spawns when multiple hooks fire
-// within the same second (e.g. subagents each triggering SessionStart).
-const SPAWN_DEBOUNCE_MS = 30_000;
-const SPAWN_STAMP_FILE = resolve(projectRoot, '.claude-flow', 'daemon-spawn.stamp');
-
-function isDaemonSpawnRecent() {
-  try {
-    if (existsSync(SPAWN_STAMP_FILE)) {
-      const age = Date.now() - statSync(SPAWN_STAMP_FILE).mtimeMs;
-      return age < SPAWN_DEBOUNCE_MS;
-    }
-  } catch { /* non-fatal */ }
-  return false;
-}
-
-function touchSpawnStamp() {
-  try {
-    const dir = resolve(projectRoot, '.claude-flow');
-    if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
-    writeFileSync(SPAWN_STAMP_FILE, String(Date.now()));
-  } catch { /* non-fatal */ }
-}
-
-// Run daemon start in background (non-blocking) — skip if already running
-function runDaemonStartBackground() {
-  // 1. Check if a live daemon already holds the lock
-  if (isDaemonLockHeld()) {
-    log('info', 'Daemon already running (lock held), skipping start');
-    return;
-  }
-
-  // 2. Debounce: skip if we spawned recently (prevents thundering herd)
-  if (isDaemonSpawnRecent()) {
-    log('info', 'Daemon spawn debounced (recent attempt), skipping');
-    return;
-  }
-
-  const localCli = getLocalCliPath();
-  if (!localCli) {
-    log('warn', 'Local CLI not found, skipping daemon start');
-    return;
-  }
-
-  // 3. Write stamp BEFORE spawning so concurrent callers see it immediately
-  touchSpawnStamp();
-
-  spawnWindowless('node', [localCli, 'daemon', 'start', '--quiet'], 'daemon');
-}
-
-// Run pretrain in background on session start (non-blocking)
-function runBackgroundPretrain() {
-  const localCli = getLocalCliPath();
-  if (!localCli) {
-    log('warn', 'Local CLI not found, skipping background pretrain');
-    return;
-  }
-
-  spawnWindowless('node', [localCli, 'hooks', 'pretrain'], 'background pretrain');
-}
-
-// Force HNSW rebuild in background to ensure all processes use identical fresh index
-// This fixes the issue where spawned agents return different search results than CLI/MCP
-function runHNSWRebuildBackground() {
-  const localCli = getLocalCliPath();
-  if (!localCli) {
-    log('warn', 'Local CLI not found, skipping HNSW rebuild');
-    return;
-  }
-
-  spawnWindowless('node', [localCli, 'memory', 'rebuild', '--force'], 'HNSW rebuild');
-}
-
-// Neural pattern application — now handled by moflo core routing (learned patterns
-// loaded from routing-outcomes.json by hooks-tools.ts getSemanticRouter).
-// No external patch script needed.
-
-main().catch((err) => {
-  log('error', `Unhandled exception: ${err.message}`);
-  process.exit(0);
-});
+#!/usr/bin/env node
+/**
+ * Cross-platform Claude Code hook runner
+ * Works on Windows (cmd/powershell) and Linux/WSL (bash)
+ *
+ * Usage: node .claude/scripts/hooks.mjs <hook-type> [args...]
+ *
+ * Hook types:
+ *   pre-edit --file <path>
+ *   post-edit --file <path> --success <bool>
+ *   pre-command --command <cmd>
+ *   post-command --command <cmd> --success <bool>
+ *   pre-task --description <desc>
+ *   post-task --task-id <id> --success <bool>
+ *   session-start
+ *   session-restore --session-id <id>
+ *   route --task <prompt>
+ *   index-guidance [--file <path>] [--force]
+ *   daemon-start
+ */
+
+import { spawn } from 'child_process';
+import { existsSync, appendFileSync, readFileSync, writeFileSync, mkdirSync, statSync } from 'fs';
+import { resolve, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { createProcessManager } from './lib/process-manager.mjs';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const projectRoot = resolve(__dirname, '../..');
+const logFile = resolve(projectRoot, '.swarm/hooks.log');
+const pm = createProcessManager(projectRoot);
+
+// Parse command line args
+const args = process.argv.slice(2);
+const hookType = args[0];
+
+// Simple log function - writes to .swarm/hooks.log
+function log(level, message) {
+  const timestamp = new Date().toISOString();
+  const line = `[${timestamp}] [${level.toUpperCase()}] [${hookType || 'unknown'}] ${message}\n`;
+
+  // Always log errors to stderr so they're visible in Claude
+  if (level === 'error') {
+    console.error(`[hook:${hookType}] ${message}`);
+  }
+
+  // Also append to log file for history
+  try {
+    appendFileSync(logFile, line);
+  } catch {
+    // Can't write log - that's fine, don't fail
+  }
+}
+
+// Helper to get arg value
+function getArg(name) {
+  const idx = args.indexOf(`--${name}`);
+  if (idx !== -1 && args[idx + 1]) {
+    return args[idx + 1];
+  }
+  // Also check environment variables (Claude sets these)
+  const envName = `TOOL_INPUT_${name}`.replace(/-/g, '_');
+  return process.env[envName] || process.env[name.toUpperCase()] || null;
+}
+
+// Helper to check if arg/flag exists
+function hasArg(name) {
+  return args.includes(`--${name}`);
+}
+
+// Get the local CLI path (preferred - no network/extraction overhead)
+function getLocalCliPath() {
+  const localCli = resolve(projectRoot, 'node_modules/moflo/src/@claude-flow/cli/bin/cli.js');
+  return existsSync(localCli) ? localCli : null;
+}
+
+// Check if running on Windows
+const isWindows = process.platform === 'win32';
+
+// Run a command and return promise with exit code
+function runCommand(cmd, cmdArgs, options = {}) {
+  return new Promise((resolve) => {
+    let stderr = '';
+
+    // Use windowsHide: true directly - no PowerShell wrapper needed
+    // The wrapper can actually cause MORE flashes as PowerShell starts
+    const proc = spawn(cmd, cmdArgs, {
+      stdio: options.silent ? ['ignore', 'ignore', 'pipe'] : 'inherit',
+      shell: false,
+      cwd: projectRoot,
+      env: { ...process.env, ...options.env },
+      detached: options.background || false,
+      windowsHide: true  // This is sufficient on Windows when shell: false
+    });
+
+    // Capture stderr even in silent mode
+    if (proc.stderr) {
+      proc.stderr.on('data', (data) => {
+        stderr += data.toString();
+      });
+    }
+
+    proc.on('close', (code) => {
+      if (code !== 0 && stderr) {
+        log('error', `Command failed (exit ${code}): ${cmd} ${cmdArgs.join(' ')}`);
+        if (stderr.trim()) {
+          log('error', `  stderr: ${stderr.trim().substring(0, 200)}`);
+        }
+      }
+      resolve(code || 0);
+    });
+
+    proc.on('error', (err) => {
+      log('error', `Command error: ${cmd} - ${err.message}`);
+      resolve(1);
+    });
+  });
+}
+
+// Show Windows toast notification (works on native Windows and WSL)
+async function showWindowsToast(title, message) {
+  // PowerShell script to show toast notification
+  const psScript = `
+[Windows.UI.Notifications.ToastNotificationManager, Windows.UI.Notifications, ContentType = WindowsRuntime] | Out-Null
+$template = [Windows.UI.Notifications.ToastNotificationManager]::GetTemplateContent([Windows.UI.Notifications.ToastTemplateType]::ToastText02)
+$text = $template.GetElementsByTagName('text')
+$text.Item(0).AppendChild($template.CreateTextNode('${title.replace(/'/g, "''")}')) | Out-Null
+$text.Item(1).AppendChild($template.CreateTextNode('${message.replace(/'/g, "''")}')) | Out-Null
+$toast = [Windows.UI.Notifications.ToastNotification]::new($template)
+[Windows.UI.Notifications.ToastNotificationManager]::CreateToastNotifier('Claude Code').Show($toast)
+`.trim();
+
+  // Encode script as base64 for -EncodedCommand (avoids shell escaping issues)
+  const encodedScript = Buffer.from(psScript, 'utf16le').toString('base64');
+
+  try {
+    // Detect environment and use appropriate PowerShell command
+    const isWSL = process.platform === 'linux' && existsSync('/proc/version') &&
+      (await import('fs')).readFileSync('/proc/version', 'utf-8').toLowerCase().includes('microsoft');
+
+    if (process.platform === 'win32') {
+      // Native Windows - use powershell with encoded command (avoids cmd.exe escaping issues)
+      await runCommand('powershell', ['-NoProfile', '-WindowStyle', 'Hidden', '-EncodedCommand', encodedScript], { silent: true });
+      log('debug', 'Toast notification sent via PowerShell');
+    } else if (isWSL) {
+      // WSL - use powershell.exe to call Windows PowerShell
+      await runCommand('powershell.exe', ['-NoProfile', '-WindowStyle', 'Hidden', '-EncodedCommand', encodedScript], { silent: true });
+      log('debug', 'Toast notification sent via powershell.exe (WSL)');
+    } else {
+      // Linux/Mac - no Windows toast available, just log
+      log('debug', 'Windows toast not available on this platform');
+    }
+  } catch (err) {
+    // Toast notifications are nice-to-have, don't fail the hook
+    log('debug', `Toast notification failed: ${err.message}`);
+  }
+}
+
+// Run claude-flow CLI command using local installation
+async function runClaudeFlow(subcommand, cliArgs = []) {
+  const localCli = getLocalCliPath();
+
+  if (localCli) {
+    // Use local CLI (fastest, no network/extraction)
+    const fullArgs = [localCli, subcommand, ...cliArgs];
+    const exitCode = await runCommand('node', fullArgs, { silent: true });
+
+    if (exitCode !== 0) {
+      log('warn', `claude-flow ${subcommand} exited with code ${exitCode}`);
+    }
+
+    return exitCode;
+  } else {
+    log('warn', 'Local CLI not found. Install with: npm install @claude-flow/cli');
+    return 1;
+  }
+}
+
+// Main hook dispatcher
+async function main() {
+  if (!hookType) {
+    console.error('Usage: node hooks.mjs <hook-type> [args...]');
+    process.exit(1);
+  }
+
+  try {
+    switch (hookType) {
+      case 'pre-edit': {
+        const file = getArg('file') || process.env.TOOL_INPUT_file_path;
+        if (file) {
+          await runClaudeFlow('hooks', ['pre-edit', '--file', file]);
+        }
+        break;
+      }
+
+      case 'post-edit': {
+        const file = getArg('file') || process.env.TOOL_INPUT_file_path;
+        const success = getArg('success') || process.env.TOOL_SUCCESS || 'true';
+        if (file) {
+          await runClaudeFlow('hooks', ['post-edit', '--file', file, '--success', success]);
+
+          // Check if this is a guidance file that needs indexing (run in background)
+          if (file.includes('.claude/guidance/') || file.includes('.claude/skills/cl/')) {
+            runIndexGuidanceBackground(file);
+          }
+        }
+        break;
+      }
+
+      case 'pre-command': {
+        const command = getArg('command') || process.env.TOOL_INPUT_command;
+        if (command) {
+          await runClaudeFlow('hooks', ['pre-command', '--command', command]);
+        }
+        break;
+      }
+
+      case 'post-command': {
+        const command = getArg('command') || process.env.TOOL_INPUT_command;
+        const success = getArg('success') || process.env.TOOL_SUCCESS || 'true';
+        if (command) {
+          await runClaudeFlow('hooks', ['post-command', '--command', command, '--success', success]);
+        }
+        break;
+      }
+
+      case 'pre-task': {
+        const description = getArg('description') || process.env.TOOL_INPUT_prompt;
+        if (description) {
+          const taskId = `task-${Date.now()}`;
+          await runClaudeFlow('hooks', ['pre-task', '--task-id', taskId, '--description', description]);
+        }
+        break;
+      }
+
+      case 'pre-research': {
+        // Memory-first gate: remind to search memory before exploring codebase
+        // This fires on Glob/Grep to catch research-style queries
+        const pattern = process.env.TOOL_INPUT_pattern || getArg('pattern');
+        const query = process.env.TOOL_INPUT_query || getArg('query');
+        const searchTerm = pattern || query;
+
+        // Only remind if this looks like a research query (not a specific path lookup)
+        if (searchTerm && !searchTerm.includes('/') && !searchTerm.match(/\.(ts|tsx|js|json|md)$/)) {
+          console.log('[MEMORY GATE] Did you search memory first? Run: memory search --query "[topic]" --namespace guidance');
+        }
+        break;
+      }
+
+      case 'post-task': {
+        const taskId = getArg('task-id') || process.env.TOOL_RESULT_agent_id;
+        const success = getArg('success') || process.env.TOOL_SUCCESS || 'true';
+        if (taskId) {
+          await runClaudeFlow('hooks', ['post-task', '--task-id', taskId, '--success', success]);
+        }
+        break;
+      }
+
+      case 'session-start': {
+        // All startup tasks run in background (non-blocking)
+        // Start daemon quietly in background
+        runDaemonStartBackground();
+        // Initialize embeddings engine (must run before indexers that generate embeddings)
+        runEmbeddingsInitBackground();
+        // Index guidance files in background
+        runIndexGuidanceBackground();
+        // Generate structural code map in background
+        runCodeMapBackground();
+        // Index test files in background
+        runTestIndexBackground();
+        // Index code patterns into patterns namespace
+        runPatternsIndexBackground();
+        // Run pretrain in background to extract patterns from repository
+        runBackgroundPretrain();
+        // Force HNSW rebuild to ensure all processes use identical fresh index
+        // This fixes agent search result mismatches (0.61 vs 0.81 similarity)
+        runHNSWRebuildBackground();
+        // Neural patterns now loaded by moflo core routing — no external patching.
+        break;
+      }
+
+      case 'session-restore': {
+        const sessionId = getArg('session-id') || process.env.SESSION_ID;
+        if (sessionId) {
+          await runClaudeFlow('hooks', ['session-restore', '--session-id', sessionId]);
+        }
+        break;
+      }
+
+      case 'route': {
+        const task = getArg('task') || process.env.PROMPT;
+        if (task) {
+          // Check for /cl command and output gate reminder
+          if (task.includes('/cl') || task.match(/^cl\s/)) {
+            const hasHelpFlag = task.includes('-h') || task.includes('--help');
+            const hasNakedFlag = task.includes('-n') || task.includes('--naked');
+
+            if (!hasHelpFlag && !hasNakedFlag) {
+              // Output visible reminder - this appears in Claude's context
+              console.log('[SWARM GATE] /cl detected. Required order: TaskList() → TaskCreate() → swarm init → Task(run_in_background)');
+              console.log('[SWARM GATE] Do NOT call GitHub/Grep/Read until tasks are created.');
+            }
+          }
+          await runClaudeFlow('hooks', ['route', '--task', task]);
+        }
+        break;
+      }
+
+      case 'index-guidance': {
+        const file = getArg('file');
+        await runIndexGuidance(file);
+        break;
+      }
+
+      case 'daemon-start': {
+        if (isDaemonLockHeld()) {
+          log('info', 'Daemon already running (lock held), skipping start');
+        } else if (isDaemonSpawnRecent()) {
+          log('info', 'Daemon spawn debounced (recent attempt), skipping');
+        } else {
+          touchSpawnStamp();
+          await runClaudeFlow('daemon', ['start', '--quiet']);
+        }
+        break;
+      }
+
+      case 'session-end': {
+        // Kill all tracked background processes before ending session
+        const killResult = pm.killAll();
+        if (killResult.killed > 0) {
+          log('info', `Killed ${killResult.killed} background process(es) on session end`);
+        }
+
+        // Run ReasoningBank and MicroLoRA training in background on session end
+        log('info', 'Session ending - starting background learning...');
+
+        // Run session-end hook (persists state)
+        await runClaudeFlow('hooks', ['session-end', '--persist-state', 'true']);
+
+        // Start background training (non-blocking)
+        runBackgroundTraining();
+        break;
+      }
+
+
+      case 'semantic-search': {
+        // Semantic search using embeddings
+        const query = getArg('query') || args[1];
+        const searchLimit = getArg('limit') || '5';
+        const threshold = getArg('threshold') || '0.3';
+        const searchScript = resolve(projectRoot, 'bin/semantic-search.mjs');
+
+        if (query && existsSync(searchScript)) {
+          const searchArgs = [searchScript, query, '--limit', searchLimit, '--threshold', threshold];
+          if (getArg('namespace')) searchArgs.push('--namespace', getArg('namespace'));
+          if (hasArg('json')) searchArgs.push('--json');
+          // semantic-search.mjs uses better-sqlite3
+          await runCommand('node', searchArgs, { silent: false });
+        } else if (!query) {
+          console.log('Usage: node .claude/scripts/hooks.mjs semantic-search --query "your query"');
+        } else {
+          log('error', 'Semantic search script not found');
+        }
+        break;
+      }
+
+      case 'notification': {
+        // Handle notification hook - show Windows toast if possible
+        const message = process.env.NOTIFICATION_MESSAGE || getArg('message') || 'Claude Code needs your attention';
+        const title = getArg('title') || 'Claude Code';
+        await showWindowsToast(title, message);
+        log('info', 'Notification hook triggered');
+        break;
+      }
+
+      default:
+        // Unknown hook type - just pass through to claude-flow
+        log('info', `Passing through unknown hook: ${hookType}`);
+        await runClaudeFlow('hooks', args);
+    }
+  } catch (err) {
+    // Log the error but don't block Claude
+    log('error', `Hook exception: ${err.message}`);
+    process.exit(0);
+  }
+
+  process.exit(0);
+}
+
+// Run the guidance indexer (blocking - used for specific file updates)
+async function runIndexGuidance(specificFile = null) {
+  const indexCandidates = [
+    resolve(dirname(fileURLToPath(import.meta.url)), 'index-guidance.mjs'),
+    resolve(projectRoot, '.claude/scripts/index-guidance.mjs'),
+  ];
+  const indexScript = indexCandidates.find(p => existsSync(p));
+
+  if (indexScript) {
+    const indexArgs = specificFile ? ['--file', specificFile] : [];
+    if (hasArg('force')) indexArgs.push('--force');
+    // index-guidance.mjs uses better-sqlite3
+    const code = await runCommand('node', [indexScript, ...indexArgs], { silent: true });
+    if (code !== 0) {
+      log('warn', `index-guidance.mjs exited with code ${code}`);
+    }
+    return code;
+  }
+
+  log('warn', 'Guidance indexer not found');
+  return 0;
+}
+
+// Spawn a background process via the shared ProcessManager (dedup + PID tracking).
+function spawnWindowless(cmd, args, description) {
+  const result = pm.spawn(cmd, args, description);
+  if (result.skipped) {
+    log('info', `Skipped ${description} (already running, PID: ${result.pid})`);
+  } else if (result.pid) {
+    log('info', `Started ${description} (PID: ${result.pid})`);
+  }
+  return result;
+}
+
+// Resolve a moflo npm bin script, falling back to local .claude/scripts/ copy
+function resolveBinOrLocal(binName, localScript) {
+  // 1. npm bin from moflo package (always up to date with published version)
+  const mofloScript = resolve(projectRoot, 'node_modules/moflo/bin', localScript);
+  if (existsSync(mofloScript)) return mofloScript;
+
+  // 2. npm bin from .bin (symlinked by npm install)
+  const npmBin = resolve(projectRoot, 'node_modules/.bin', binName);
+  if (existsSync(npmBin)) return npmBin;
+
+  // 3. Local .claude/scripts/ copy (may be stale but better than nothing)
+  const localPath = resolve(projectRoot, '.claude/scripts', localScript);
+  if (existsSync(localPath)) return localPath;
+
+  return null;
+}
+
+// Run the guidance indexer in background (non-blocking - used for session start and file changes)
+function runIndexGuidanceBackground(specificFile = null) {
+  // Check auto_index.guidance flag in moflo.yaml (default: true)
+  // Only gate full indexing on session-start; per-file calls from post-edit always run
+  if (!specificFile) {
+    const yamlPath = resolve(projectRoot, 'moflo.yaml');
+    if (existsSync(yamlPath)) {
+      try {
+        const content = readFileSync(yamlPath, 'utf-8');
+        const match = content.match(/auto_index:\s*\n(?:.*\n)*?\s+guidance:\s*(true|false)/);
+        if (match && match[1] === 'false') {
+          log('info', 'Guidance indexing disabled (auto_index.guidance: false)');
+          return;
+        }
+      } catch { /* ignore, proceed with indexing */ }
+    }
+  }
+
+  const indexScript = resolveBinOrLocal('flo-index', 'index-guidance.mjs');
+
+  if (!indexScript) {
+    log('warn', 'Guidance indexer not found (checked npm bin + .claude/scripts/)');
+    return;
+  }
+
+  const indexArgs = [indexScript];
+  if (specificFile) indexArgs.push('--file', specificFile);
+
+  const desc = specificFile ? `background indexing file: ${specificFile}` : 'background indexing (full)';
+  spawnWindowless('node', indexArgs, desc);
+}
+
+// Run structural code map generator in background (non-blocking)
+function runCodeMapBackground() {
+  // Check auto_index.code_map flag in moflo.yaml (default: true)
+  const yamlPath = resolve(projectRoot, 'moflo.yaml');
+  if (existsSync(yamlPath)) {
+    try {
+      const content = readFileSync(yamlPath, 'utf-8');
+      const match = content.match(/auto_index:\s*\n(?:.*\n)*?\s+code_map:\s*(true|false)/);
+      if (match && match[1] === 'false') {
+        log('info', 'Code map generation disabled (auto_index.code_map: false)');
+        return;
+      }
+    } catch { /* ignore, proceed with indexing */ }
+  }
+
+  const codeMapScript = resolveBinOrLocal('flo-codemap', 'generate-code-map.mjs');
+
+  if (!codeMapScript) {
+    log('warn', 'Code map generator not found (checked npm bin + .claude/scripts/)');
+    return;
+  }
+
+  spawnWindowless('node', [codeMapScript], 'background code map generation');
+}
+
+// Run test file indexer in background (non-blocking)
+function runTestIndexBackground() {
+  // Check auto_index.tests flag in moflo.yaml (default: true)
+  const yamlPath = resolve(projectRoot, 'moflo.yaml');
+  if (existsSync(yamlPath)) {
+    try {
+      const content = readFileSync(yamlPath, 'utf-8');
+      const match = content.match(/auto_index:\s*\n(?:.*\n)*?\s+tests:\s*(true|false)/);
+      if (match && match[1] === 'false') {
+        log('info', 'Test indexing disabled (auto_index.tests: false)');
+        return;
+      }
+    } catch { /* ignore, proceed with indexing */ }
+  }
+
+  const testIndexScript = resolveBinOrLocal('flo-testmap', 'index-tests.mjs');
+
+  if (!testIndexScript) {
+    log('info', 'Test indexer not found (checked npm bin + .claude/scripts/)');
+    return;
+  }
+
+  spawnWindowless('node', [testIndexScript], 'background test indexing');
+}
+
+// Run ReasoningBank + MicroLoRA training + EWC++ consolidation in background (non-blocking)
+function runBackgroundTraining() {
+  const localCli = getLocalCliPath();
+  if (!localCli) {
+    log('warn', 'Local CLI not found, skipping background training');
+    return;
+  }
+
+  // Pattern types to train with MicroLoRA
+  const patternTypes = ['coordination', 'routing', 'debugging'];
+
+  for (const ptype of patternTypes) {
+    spawnWindowless('node', [localCli, 'neural', 'train', '--pattern-type', ptype, '--epochs', '2'], `MicroLoRA training: ${ptype}`);
+  }
+
+  // Run pretrain to update ReasoningBank
+  spawnWindowless('node', [localCli, 'hooks', 'pretrain'], 'ReasoningBank pretrain');
+
+  // Run EWC++ memory consolidation (prevents catastrophic forgetting)
+  spawnWindowless('node', [localCli, 'hooks', 'worker', 'dispatch', '--trigger', 'consolidate', '--background'], 'EWC++ consolidation');
+
+  // Run neural optimize (Int8 quantization, memory compression)
+  spawnWindowless('node', [localCli, 'neural', 'optimize'], 'neural optimize');
+}
+
+// Delegate to daemon-lock.js for proper PID + command-line verification.
+// Falls back to a naive kill(0) check if the import fails (e.g. dist not built).
+let _getDaemonLockHolder = null;
+try {
+  const daemonLockPath = resolve(__dirname, '..', 'src', '@claude-flow', 'cli', 'dist', 'src', 'services', 'daemon-lock.js');
+  if (existsSync(daemonLockPath)) {
+    const mod = await import('file://' + daemonLockPath.replace(/\\/g, '/'));
+    _getDaemonLockHolder = mod.getDaemonLockHolder;
+  }
+} catch { /* fallback below */ }
+
+function isDaemonLockHeld() {
+  // Prefer the real daemon-lock module (PID + command-line verification)
+  if (_getDaemonLockHolder) {
+    return _getDaemonLockHolder(projectRoot) !== null;
+  }
+
+  // Fallback: naive PID check (only if daemon-lock.js unavailable)
+  const lockFile = resolve(projectRoot, '.claude-flow', 'daemon.lock');
+  if (!existsSync(lockFile)) return false;
+  try {
+    const data = JSON.parse(readFileSync(lockFile, 'utf-8'));
+    if (typeof data.pid === 'number' && data.pid > 0) {
+      process.kill(data.pid, 0);
+      return true;
+    }
+  } catch {
+    // Dead process or corrupt file — lock is stale
+  }
+  return false;
+}
+
+// Debounce file — prevents thundering-herd spawns when multiple hooks fire
+// within the same second (e.g. subagents each triggering SessionStart).
+const SPAWN_DEBOUNCE_MS = 30_000;
+const SPAWN_STAMP_FILE = resolve(projectRoot, '.claude-flow', 'daemon-spawn.stamp');
+
+function isDaemonSpawnRecent() {
+  try {
+    if (existsSync(SPAWN_STAMP_FILE)) {
+      const age = Date.now() - statSync(SPAWN_STAMP_FILE).mtimeMs;
+      return age < SPAWN_DEBOUNCE_MS;
+    }
+  } catch { /* non-fatal */ }
+  return false;
+}
+
+function touchSpawnStamp() {
+  try {
+    const dir = resolve(projectRoot, '.claude-flow');
+    if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
+    writeFileSync(SPAWN_STAMP_FILE, String(Date.now()));
+  } catch { /* non-fatal */ }
+}
+
+// Run daemon start in background (non-blocking) — skip if already running
+function runDaemonStartBackground() {
+  // 1. Check if a live daemon already holds the lock
+  if (isDaemonLockHeld()) {
+    log('info', 'Daemon already running (lock held), skipping start');
+    return;
+  }
+
+  // 2. Debounce: skip if we spawned recently (prevents thundering herd)
+  if (isDaemonSpawnRecent()) {
+    log('info', 'Daemon spawn debounced (recent attempt), skipping');
+    return;
+  }
+
+  const localCli = getLocalCliPath();
+  if (!localCli) {
+    log('warn', 'Local CLI not found, skipping daemon start');
+    return;
+  }
+
+  // 3. Write stamp BEFORE spawning so concurrent callers see it immediately
+  touchSpawnStamp();
+
+  spawnWindowless('node', [localCli, 'daemon', 'start', '--quiet'], 'daemon');
+}
+
+// Run pretrain in background on session start (non-blocking)
+function runBackgroundPretrain() {
+  const localCli = getLocalCliPath();
+  if (!localCli) {
+    log('warn', 'Local CLI not found, skipping background pretrain');
+    return;
+  }
+
+  spawnWindowless('node', [localCli, 'hooks', 'pretrain'], 'background pretrain');
+}
+
+// Force HNSW rebuild in background to ensure all processes use identical fresh index
+// This fixes the issue where spawned agents return different search results than CLI/MCP
+function runHNSWRebuildBackground() {
+  const localCli = getLocalCliPath();
+  if (!localCli) {
+    log('warn', 'Local CLI not found, skipping HNSW rebuild');
+    return;
+  }
+
+  spawnWindowless('node', [localCli, 'memory', 'rebuild', '--force'], 'HNSW rebuild');
+}
+
+// Initialize embeddings ONNX engine on session start (non-blocking)
+function runEmbeddingsInitBackground() {
+  const localCli = getLocalCliPath();
+  if (!localCli) {
+    log('warn', 'Local CLI not found, skipping embeddings init');
+    return;
+  }
+
+  spawnWindowless('node', [localCli, 'embeddings', 'init'], 'embeddings init');
+}
+
+// Index code patterns into the patterns namespace (non-blocking)
+// Extracts architectural patterns, idioms, and recurring structures from source
+function runPatternsIndexBackground() {
+  // Check auto_index.patterns flag in moflo.yaml (default: true)
+  const yamlPath = resolve(projectRoot, 'moflo.yaml');
+  if (existsSync(yamlPath)) {
+    try {
+      const content = readFileSync(yamlPath, 'utf-8');
+      const match = content.match(/auto_index:\s*\n(?:.*\n)*?\s+patterns:\s*(true|false)/);
+      if (match && match[1] === 'false') {
+        log('info', 'Patterns indexing disabled (auto_index.patterns: false)');
+        return;
+      }
+    } catch { /* ignore, proceed with indexing */ }
+  }
+
+  const patternsScript = resolveBinOrLocal('flo-patterns', 'index-patterns.mjs');
+  if (!patternsScript) {
+    log('warn', 'Patterns indexer not found (checked npm bin + .claude/scripts/)');
+    return;
+  }
+
+  spawnWindowless('node', [patternsScript], 'background patterns indexing');
+}
+
+// Neural pattern application — now handled by moflo core routing (learned patterns
+// loaded from routing-outcomes.json by hooks-tools.ts getSemanticRouter).
+// No external patch script needed.
+
+main().catch((err) => {
+  log('error', `Unhandled exception: ${err.message}`);
+  process.exit(0);
+});