crbro-memory 1.10.0 → 1.11.0

package/bin/crbro.mjs

@@ -1,424 +1,485 @@
-#!/usr/bin/env node
-
-// ─── CRBRO CLI ───────────────────────────────────────────────────
-// Command-line interface for CRBRO memory system
-// Supports: init, status, mine, setup-miner, miner-status,
-//           remove-miner, and MCP server mode (default)
-
-import { platform, homedir } from 'os';
-import { join, dirname } from 'path';
-import { existsSync, readFileSync } from 'fs';
-import { fileURLToPath } from 'url';
-
-// The release that is running, read from the package itself. The manifest
-// version stamps the brain format and has not moved since 1.0.0, so showing
-// only that one told everyone they were on 1.0.0 forever.
-function pkgVersion() {
-  try {
-    const here = dirname(fileURLToPath(import.meta.url));
-    return JSON.parse(readFileSync(join(here, '..', 'package.json'), 'utf8')).version;
-  } catch {
-    return 'unknown';
-  }
-}
-
-const args = process.argv.slice(2);
-const command = args[0];
-
-// ─── IDE Detection ──────────────────────────────────────────────
-const IDE_CONFIGS = [
-  {
-    name: 'Antigravity (Google Gemini)',
-    id: 'antigravity',
-    configPath: () => join(homedir(), '.gemini', 'antigravity', 'mcp_config.json'),
-    configFormat: 'mcpServers',
-  },
-  {
-    name: 'Cursor',
-    id: 'cursor',
-    configPath: () => join(homedir(), '.cursor', 'mcp.json'),
-    configFormat: 'mcpServers',
-  },
-  {
-    name: 'Windsurf',
-    id: 'windsurf',
-    configPath: () => join(homedir(), '.windsurf', 'mcp.json'),
-    configFormat: 'mcpServers',
-  },
-  {
-    name: 'Claude Desktop',
-    id: 'claude-desktop',
-    configPath: () => {
-      if (platform() === 'win32') {
-        return join(process.env.APPDATA || '', 'Claude', 'claude_desktop_config.json');
-      }
-      return join(homedir(), 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json');
-    },
-    configFormat: 'mcpServers',
-  },
-  {
-    name: 'Claude Code (user scope)',
-    id: 'claude-code',
-    configPath: () => join(homedir(), '.claude.json'),
-    configFormat: 'mcpServers',
-  },
-  {
-    name: 'VS Code + Continue',
-    id: 'continue',
-    configPath: () => join(homedir(), '.continue', 'config.json'),
-    configFormat: 'mcpServers',
-  },
-  {
-    name: 'ChatGPT Desktop',
-    id: 'chatgpt',
-    configPath: () => {
-      if (platform() === 'win32') {
-        return join(process.env.APPDATA || '', 'ChatGPT', 'mcp_config.json');
-      }
-      return join(homedir(), 'Library', 'Application Support', 'ChatGPT', 'mcp_config.json');
-    },
-    configFormat: 'mcpServers',
-  },
-];
-
-function detectIDEs() {
-  const detected = [];
-  for (const ide of IDE_CONFIGS) {
-    try {
-      const configPath = ide.configPath();
-      if (existsSync(configPath)) {
-        detected.push({ ...ide, configPath: configPath, exists: true });
-      } else {
-        // Check if the parent directory exists (IDE installed but no config yet)
-        const parentDir = configPath.split(/[/\\]/).slice(0, -1).join(platform() === 'win32' ? '\\' : '/');
-        if (existsSync(parentDir)) {
-          detected.push({ ...ide, configPath: configPath, exists: false });
-        }
-      }
-    } catch { /* skip */ }
-  }
-  return detected;
-}
-
-function generateMCPSnippet(envVars) {
-  return JSON.stringify({
-    "crbro": {
-      "command": "npx",
-      "args": ["-y", "crbro-memory"],
-      ...(envVars ? { "env": envVars } : {})
-    }
-  }, null, 2);
-}
-
-// ─── Commands ───────────────────────────────────────────────────
-
-if (command === 'init') {
-  // ─── Initialize brain + IDE detection ──────────────────────────
-  import('../dist/engine/brain.js').then(async ({ Brain }) => {
-    const brain = new Brain();
-    const manifest = await brain.initialize();
-
-    console.log('');
-    console.log('  🧠 CRBRO brain initialized!');
-    console.log(`     Path: ${manifest.brain_path}`);
-    console.log('');
-
-    // Detect IDEs
-    const ides = detectIDEs();
-
-    if (ides.length > 0) {
-      console.log('  📡 Detected IDEs:');
-      console.log('');
-      for (const ide of ides) {
-        const status = ide.exists ? '✅ config exists' : '📝 needs config';
-        console.log(`     ${ide.name}: ${status}`);
-        console.log(`       → ${ide.configPath}`);
-      }
-      console.log('');
-      console.log('  Add this to your MCP config (inside "mcpServers"):');
-    } else {
-      console.log('  ⚠️  No IDE detected. Add this to your MCP config manually:');
-    }
-
-    console.log('');
-    console.log('  ' + generateMCPSnippet().split('\n').join('\n  '));
-    console.log('');
-    console.log('  Next steps:');
-    console.log('    1. Add the config above to your IDE\'s MCP settings');
-    console.log('    2. (Optional) npx crbro-memory setup-miner');
-    console.log('    3. Restart your IDE — CRBRO boots automatically!');
-    console.log('');
-  }).catch(console.error);
-
-} else if (command === 'status') {
-  // ─── Show brain status ─────────────────────────────────────────
-  import('../dist/engine/brain.js').then(async ({ Brain }) => {
-    const brain = new Brain();
-    try {
-      const manifest = await brain.getManifest();
-      console.log('');
-      console.log('  🧠 CRBRO Brain Status');
-      console.log('  ─────────────────────');
-      console.log(`  CRBRO:           ${pkgVersion()}`);
-      console.log(`  Brain format:    ${manifest.version}`);
-      console.log(`  Path:            ${manifest.brain_path}`);
-      console.log(`  Neurons:         ${manifest.total_neurons}`);
-      console.log(`  Synapses:        ${manifest.total_synapses}`);
-      console.log(`  Sessions:        ${manifest.total_sessions}`);
-      console.log(`  Last Boot:       ${manifest.last_boot || 'never'}`);
-      console.log(`  Last Consolidate: ${manifest.last_consolidation || 'never'}`);
-      console.log('');
-
-      // Show detected IDEs
-      const ides = detectIDEs();
-      if (ides.length > 0) {
-        console.log('  📡 Connected IDEs:');
-        for (const ide of ides) {
-          console.log(`     ${ide.exists ? '✅' : '⚠️ '} ${ide.name}`);
-        }
-        console.log('');
-      }
-    } catch {
-      console.log('');
-      console.log('  🧠 CRBRO brain not initialized.');
-      console.log('     Run: npx crbro-memory init');
-      console.log('');
-    }
-  }).catch(console.error);
-
-} else if (command === 'activate') {
-  // ─── Legacy command (pre-1.4.0) — CRBRO is now fully free ──────
-  console.log('');
-  console.log('  ✅ Good news: since v1.4.0 CRBRO is fully free.');
-  console.log('     All 15 tools are available — no license key needed.');
-  console.log('');
-
-} else if (command === 'mine') {
-  // ─── One-shot mining ───────────────────────────────────────────
-  const targetDir = args[1];
-
-  import('../dist/miner/index.js').then(async ({ Miner }) => {
-    console.log('');
-    console.log('  ⛏️  CRBRO Miner — Scanning for knowledge...');
-    console.log('');
-
-    const miner = new Miner();
-    const result = await miner.mine(targetDir);
-
-    console.log('  ────────────────────────────────');
-    console.log(`  Files scanned:      ${result.scanned}`);
-    console.log(`  New files mined:    ${result.new_files}`);
-    console.log(`  Neurons created:    ${result.neurons_created}`);
-    console.log(`  Neurons updated:    ${result.neurons_updated}`);
-    console.log(`  Facts added:        ${result.facts_added}`);
-    console.log(`  Decisions found:    ${result.decisions_added}`);
-
-    if (result.technologies_found.length > 0) {
-      console.log(`  Technologies:       ${result.technologies_found.slice(0, 10).join(', ')}`);
-    }
-
-    if (result.errors.length > 0) {
-      console.log('');
-      console.log('  ⚠️  Errors:');
-      for (const err of result.errors.slice(0, 5)) {
-        console.log(`     ${err}`);
-      }
-    }
-
-    console.log('');
-  }).catch(console.error);
-
-} else if (command === 'setup-miner') {
-  // ─── Setup automatic mining ────────────────────────────────────
-  import('../dist/miner/scheduler.js').then(async ({ setupScheduler }) => {
-    console.log('');
-    console.log('  ⏰ Setting up CRBRO Auto-Miner...');
-    console.log('');
-
-    const result = await setupScheduler();
-    console.log(result.message);
-    console.log('');
-  }).catch(console.error);
-
-} else if (command === 'miner-status') {
-  // ─── Check miner status ────────────────────────────────────────
-  Promise.all([
-    import('../dist/miner/scheduler.js'),
-    import('../dist/miner/index.js'),
-  ]).then(async ([{ getSchedulerStatus }, { Miner }]) => {
-    console.log('');
-    console.log('  ⛏️  CRBRO Miner Status');
-    console.log('  ─────────────────────');
-
-    // Scheduler status
-    const schedStatus = await getSchedulerStatus();
-    console.log(`  Scheduler:   ${schedStatus.installed ? '✅ Installed' : '❌ Not installed'}`);
-    console.log(`  Platform:    ${schedStatus.platform}`);
-    if (schedStatus.details) {
-      console.log(`  Details:     ${schedStatus.details}`);
-    }
-
-    // Miner state
-    const miner = new Miner();
-    const status = await miner.getStatus();
-    console.log('');
-    console.log(`  Last run:    ${status.state.last_run || 'never'}`);
-    console.log(`  Total mined: ${status.state.total_mined} files`);
-    console.log(`  Tracked:     ${Object.keys(status.state.mined_files).length} files`);
-    console.log('');
-
-    if (status.detected_dirs.length > 0) {
-      console.log('  📂 Scan directories:');
-      for (const dir of status.detected_dirs) {
-        console.log(`     ${dir}`);
-      }
-    } else {
-      console.log('  ⚠️  No IDE directories detected.');
-    }
-    console.log('');
-  }).catch(console.error);
-
-} else if (command === 'remove-miner') {
-  // ─── Remove automatic mining ───────────────────────────────────
-  import('../dist/miner/scheduler.js').then(async ({ removeScheduler }) => {
-    const result = await removeScheduler();
-    console.log('');
-    console.log(result.success ? `  ✅ ${result.message}` : `  ❌ ${result.message}`);
-    console.log('');
-  }).catch(console.error);
-
-} else if (command === 'reindex') {
-  // ─── Rebuild the search index from the cortex ──────────────────
-  Promise.all([
-    import('../dist/engine/brain.js'),
-    import('../dist/search/index.js'),
-  ]).then(async ([{ Brain }, { SearchEngine }]) => {
-    const brain = new Brain();
-    const engine = new SearchEngine(brain);
-
-    console.log('');
-    console.log('  🔁 Rebuilding the CRBRO search index...');
-    const started = Date.now();
-    const indexed = await engine.rebuild();
-    const seconds = ((Date.now() - started) / 1000).toFixed(1);
-
-    console.log('');
-    console.log(`  ✅ ${indexed} chunks indexed in ${seconds}s`);
-    console.log('     Every fact, decision and pattern is now searchable on its own,');
-    console.log('     so a big neuron is no longer buried by short ones.');
-    console.log('');
-  }).catch(console.error);
-
-} else if (command === 'eval') {
-  // ─── Measure retrieval quality against a query set ─────────────
-  //
-  // Without a number you cannot tell a fix from a feeling. The file is
-  // .crbro/.eval/queries.json — a list of { query, expect_neuron } and
-  // optionally expect_contains, the substring the matched fact should carry.
-  Promise.all([
-    import('../dist/engine/brain.js'),
-    import('../dist/search/index.js'),
-    import('fs/promises'),
-  ]).then(async ([{ Brain }, { SearchEngine }, fsp]) => {
-    const brain = new Brain();
-    const evalPath = join(brain.paths.root, '.eval', 'queries.json');
-
-    let queries;
-    try {
-      queries = JSON.parse(await fsp.readFile(evalPath, 'utf-8'));
-    } catch {
-      console.log('');
-      console.log(`  No query set found at ${evalPath}`);
-      console.log('  Create it as a JSON array, for example:');
-      console.log('');
-      console.log('  [');
-      console.log('    { "query": "how we deploy the api", "expect_neuron": "project_octochat",');
-      console.log('      "expect_contains": "Cloud Run" }');
-      console.log('  ]');
-      console.log('');
-      console.log('  Build it from facts you already saved: take six or eight words');
-      console.log('  out of a real fact and name the neuron that holds it.');
-      console.log('');
-      return;
-    }
-
-    const engine = new SearchEngine(brain);
-    await engine.init();
-
-    let atOne = 0, atThree = 0, reciprocal = 0, contentOk = 0;
-    const misses = [];
-
-    for (const q of queries) {
-      const results = await engine.search(q.query, { limit: 10 });
-      const rank = results.findIndex(r => r.neuron_id === q.expect_neuron);
-
-      if (rank === 0) atOne++;
-      if (rank >= 0 && rank < 3) atThree++;
-      if (rank >= 0) reciprocal += 1 / (rank + 1);
-
-      if (rank === 0 && q.expect_contains) {
-        if (results[0].matching_content.includes(q.expect_contains)) contentOk++;
-        else misses.push(`  ~ "${q.query}" — right neuron, wrong fact returned`);
-      }
-
-      if (rank !== 0) {
-        const got = results[0] ? results[0].neuron_id : '(nothing)';
-        misses.push(`  ✗ "${q.query}" — expected ${q.expect_neuron}, got ${got}` +
-                    (rank > 0 ? ` (it was #${rank + 1})` : ''));
-      }
-    }
-
-    const n = queries.length;
-    const pct = (x) => `${((x / n) * 100).toFixed(1)}%`;
-
-    console.log('');
-    console.log('  📊 CRBRO retrieval eval');
-    console.log('  ───────────────────────');
-    console.log(`  Queries:          ${n}`);
-    console.log(`  Right first hit:  ${atOne}/${n}  (${pct(atOne)})`);
-    console.log(`  In the top 3:     ${atThree}/${n}  (${pct(atThree)})`);
-    console.log(`  MRR:              ${(reciprocal / n).toFixed(3)}`);
-    if (queries.some(q => q.expect_contains)) {
-      const withContent = queries.filter(q => q.expect_contains).length;
-      console.log(`  Right fact shown: ${contentOk}/${withContent}`);
-    }
-
-    if (misses.length > 0) {
-      console.log('');
-      console.log('  Misses:');
-      for (const m of misses.slice(0, 25)) console.log(m);
-      if (misses.length > 25) console.log(`  ... and ${misses.length - 25} more`);
-    }
-    console.log('');
-  }).catch(console.error);
-
-} else if (command === '--help' || command === '-h') {
-  // ─── Help ──────────────────────────────────────────────────────
-  console.log('');
-  console.log('  🧠 CRBRO — Persistent Neural Memory for AI');
-  console.log('  ═══════════════════════════════════════════');
-  console.log('');
-  console.log('  Setup:');
-  console.log('    npx crbro-memory init             Initialize brain + detect IDEs');
-  console.log('    npx crbro-memory status           Show brain status');
-  console.log('');
-  console.log('  Auto-Mining:');
-  console.log('    npx crbro-memory mine [dir]       One-shot mining of artifacts');
-  console.log('    npx crbro-memory setup-miner      Install scheduled auto-miner');
-  console.log('    npx crbro-memory miner-status     Check auto-miner status');
-  console.log('    npx crbro-memory remove-miner     Remove auto-miner');
-  console.log('');
-  console.log('  Search:');
-  console.log('    npx crbro-memory reindex          Rebuild the search index');
-  console.log('    npx crbro-memory eval             Measure retrieval against .crbro/.eval/queries.json');
-  console.log('');
-  console.log('  Server:');
-  console.log('    npx crbro-memory                  Start MCP server (stdio)');
-  console.log('');
-  console.log('  Open source (MIT) — https://github.com/Octonove/crbro-memory');
-  console.log('');
-
-} else {
-  // ─── Default: start MCP server ─────────────────────────────────
-  import('../dist/index.js').catch(console.error);
-}
+#!/usr/bin/env node
+
+// ─── CRBRO CLI ───────────────────────────────────────────────────
+// Command-line interface for CRBRO memory system
+// Supports: init, status, mine, setup-miner, miner-status,
+//           remove-miner, and MCP server mode (default)
+
+import { platform, homedir } from 'os';
+import { join, dirname } from 'path';
+import { existsSync, readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+
+// The release that is running, read from the package itself. The manifest
+// version stamps the brain format and has not moved since 1.0.0, so showing
+// only that one told everyone they were on 1.0.0 forever.
+function pkgVersion() {
+  try {
+    const here = dirname(fileURLToPath(import.meta.url));
+    return JSON.parse(readFileSync(join(here, '..', 'package.json'), 'utf8')).version;
+  } catch {
+    return 'unknown';
+  }
+}
+
+const args = process.argv.slice(2);
+const command = args[0];
+
+// ─── IDE Detection ──────────────────────────────────────────────
+const IDE_CONFIGS = [
+  {
+    name: 'Antigravity (Google Gemini)',
+    id: 'antigravity',
+    configPath: () => join(homedir(), '.gemini', 'antigravity', 'mcp_config.json'),
+    configFormat: 'mcpServers',
+  },
+  {
+    name: 'Cursor',
+    id: 'cursor',
+    configPath: () => join(homedir(), '.cursor', 'mcp.json'),
+    configFormat: 'mcpServers',
+  },
+  {
+    name: 'Windsurf',
+    id: 'windsurf',
+    configPath: () => join(homedir(), '.windsurf', 'mcp.json'),
+    configFormat: 'mcpServers',
+  },
+  {
+    name: 'Claude Desktop',
+    id: 'claude-desktop',
+    configPath: () => {
+      if (platform() === 'win32') {
+        return join(process.env.APPDATA || '', 'Claude', 'claude_desktop_config.json');
+      }
+      return join(homedir(), 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json');
+    },
+    configFormat: 'mcpServers',
+  },
+  {
+    name: 'Claude Code (user scope)',
+    id: 'claude-code',
+    configPath: () => join(homedir(), '.claude.json'),
+    configFormat: 'mcpServers',
+  },
+  {
+    name: 'VS Code + Continue',
+    id: 'continue',
+    configPath: () => join(homedir(), '.continue', 'config.json'),
+    configFormat: 'mcpServers',
+  },
+  {
+    name: 'ChatGPT Desktop',
+    id: 'chatgpt',
+    configPath: () => {
+      if (platform() === 'win32') {
+        return join(process.env.APPDATA || '', 'ChatGPT', 'mcp_config.json');
+      }
+      return join(homedir(), 'Library', 'Application Support', 'ChatGPT', 'mcp_config.json');
+    },
+    configFormat: 'mcpServers',
+  },
+];
+
+function detectIDEs() {
+  const detected = [];
+  for (const ide of IDE_CONFIGS) {
+    try {
+      const configPath = ide.configPath();
+      if (existsSync(configPath)) {
+        detected.push({ ...ide, configPath: configPath, exists: true });
+      } else {
+        // Check if the parent directory exists (IDE installed but no config yet)
+        const parentDir = configPath.split(/[/\\]/).slice(0, -1).join(platform() === 'win32' ? '\\' : '/');
+        if (existsSync(parentDir)) {
+          detected.push({ ...ide, configPath: configPath, exists: false });
+        }
+      }
+    } catch { /* skip */ }
+  }
+  return detected;
+}
+
+function generateMCPSnippet(envVars) {
+  return JSON.stringify({
+    "crbro": {
+      "command": "npx",
+      "args": ["-y", "crbro-memory"],
+      ...(envVars ? { "env": envVars } : {})
+    }
+  }, null, 2);
+}
+
+// ─── Commands ───────────────────────────────────────────────────
+
+if (command === 'init') {
+  // ─── Initialize brain + IDE detection ──────────────────────────
+  import('../dist/engine/brain.js').then(async ({ Brain }) => {
+    const brain = new Brain();
+    const manifest = await brain.initialize();
+
+    console.log('');
+    console.log('  🧠 CRBRO brain initialized!');
+    console.log(`     Path: ${manifest.brain_path}`);
+    console.log('');
+
+    // Detect IDEs
+    const ides = detectIDEs();
+
+    if (ides.length > 0) {
+      console.log('  📡 Detected IDEs:');
+      console.log('');
+      for (const ide of ides) {
+        const status = ide.exists ? '✅ config exists' : '📝 needs config';
+        console.log(`     ${ide.name}: ${status}`);
+        console.log(`       → ${ide.configPath}`);
+      }
+      console.log('');
+      console.log('  Add this to your MCP config (inside "mcpServers"):');
+    } else {
+      console.log('  ⚠️  No IDE detected. Add this to your MCP config manually:');
+    }
+
+    console.log('');
+    console.log('  ' + generateMCPSnippet().split('\n').join('\n  '));
+    console.log('');
+    console.log('  Next steps:');
+    console.log('    1. Add the config above to your IDE\'s MCP settings');
+    console.log('    2. (Optional) npx crbro-memory setup-miner');
+    console.log('    3. Restart your IDE — CRBRO boots automatically!');
+    console.log('');
+  }).catch(console.error);
+
+} else if (command === 'status') {
+  // ─── Show brain status ─────────────────────────────────────────
+  import('../dist/engine/brain.js').then(async ({ Brain }) => {
+    const brain = new Brain();
+    try {
+      const manifest = await brain.getManifest();
+      console.log('');
+      console.log('  🧠 CRBRO Brain Status');
+      console.log('  ─────────────────────');
+      console.log(`  CRBRO:           ${pkgVersion()}`);
+      console.log(`  Brain format:    ${manifest.version}`);
+      console.log(`  Path:            ${manifest.brain_path}`);
+      console.log(`  Neurons:         ${manifest.total_neurons}`);
+      console.log(`  Synapses:        ${manifest.total_synapses}`);
+      console.log(`  Sessions:        ${manifest.total_sessions}`);
+      console.log(`  Last Boot:       ${manifest.last_boot || 'never'}`);
+      console.log(`  Last Consolidate: ${manifest.last_consolidation || 'never'}`);
+      console.log('');
+
+      // Show detected IDEs
+      const ides = detectIDEs();
+      if (ides.length > 0) {
+        console.log('  📡 Connected IDEs:');
+        for (const ide of ides) {
+          console.log(`     ${ide.exists ? '✅' : '⚠️ '} ${ide.name}`);
+        }
+        console.log('');
+      }
+    } catch {
+      console.log('');
+      console.log('  🧠 CRBRO brain not initialized.');
+      console.log('     Run: npx crbro-memory init');
+      console.log('');
+    }
+  }).catch(console.error);
+
+} else if (command === 'activate') {
+  // ─── Legacy command (pre-1.4.0) — CRBRO is now fully free ──────
+  console.log('');
+  console.log('  ✅ Good news: since v1.4.0 CRBRO is fully free.');
+  console.log('     All 15 tools are available — no license key needed.');
+  console.log('');
+
+} else if (command === 'mine') {
+  // ─── One-shot mining ───────────────────────────────────────────
+  const targetDir = args[1];
+
+  import('../dist/miner/index.js').then(async ({ Miner }) => {
+    console.log('');
+    console.log('  ⛏️  CRBRO Miner — Scanning for knowledge...');
+    console.log('');
+
+    const miner = new Miner();
+    const result = await miner.mine(targetDir);
+
+    console.log('  ────────────────────────────────');
+    console.log(`  Files scanned:      ${result.scanned}`);
+    console.log(`  New files mined:    ${result.new_files}`);
+    console.log(`  Neurons created:    ${result.neurons_created}`);
+    console.log(`  Neurons updated:    ${result.neurons_updated}`);
+    console.log(`  Facts added:        ${result.facts_added}`);
+    console.log(`  Decisions found:    ${result.decisions_added}`);
+
+    if (result.technologies_found.length > 0) {
+      console.log(`  Technologies:       ${result.technologies_found.slice(0, 10).join(', ')}`);
+    }
+
+    if (result.errors.length > 0) {
+      console.log('');
+      console.log('  ⚠️  Errors:');
+      for (const err of result.errors.slice(0, 5)) {
+        console.log(`     ${err}`);
+      }
+    }
+
+    console.log('');
+  }).catch(console.error);
+
+} else if (command === 'setup-miner') {
+  // ─── Setup automatic mining ────────────────────────────────────
+  import('../dist/miner/scheduler.js').then(async ({ setupScheduler }) => {
+    console.log('');
+    console.log('  ⏰ Setting up CRBRO Auto-Miner...');
+    console.log('');
+
+    const result = await setupScheduler();
+    console.log(result.message);
+    console.log('');
+  }).catch(console.error);
+
+} else if (command === 'miner-status') {
+  // ─── Check miner status ────────────────────────────────────────
+  Promise.all([
+    import('../dist/miner/scheduler.js'),
+    import('../dist/miner/index.js'),
+  ]).then(async ([{ getSchedulerStatus }, { Miner }]) => {
+    console.log('');
+    console.log('  ⛏️  CRBRO Miner Status');
+    console.log('  ─────────────────────');
+
+    // Scheduler status
+    const schedStatus = await getSchedulerStatus();
+    console.log(`  Scheduler:   ${schedStatus.installed ? '✅ Installed' : '❌ Not installed'}`);
+    console.log(`  Platform:    ${schedStatus.platform}`);
+    if (schedStatus.details) {
+      console.log(`  Details:     ${schedStatus.details}`);
+    }
+
+    // Miner state
+    const miner = new Miner();
+    const status = await miner.getStatus();
+    console.log('');
+    console.log(`  Last run:    ${status.state.last_run || 'never'}`);
+    console.log(`  Total mined: ${status.state.total_mined} files`);
+    console.log(`  Tracked:     ${Object.keys(status.state.mined_files).length} files`);
+    console.log('');
+
+    if (status.detected_dirs.length > 0) {
+      console.log('  📂 Scan directories:');
+      for (const dir of status.detected_dirs) {
+        console.log(`     ${dir}`);
+      }
+    } else {
+      console.log('  ⚠️  No IDE directories detected.');
+    }
+    console.log('');
+  }).catch(console.error);
+
+} else if (command === 'remove-miner') {
+  // ─── Remove automatic mining ───────────────────────────────────
+  import('../dist/miner/scheduler.js').then(async ({ removeScheduler }) => {
+    const result = await removeScheduler();
+    console.log('');
+    console.log(result.success ? `  ✅ ${result.message}` : `  ❌ ${result.message}`);
+    console.log('');
+  }).catch(console.error);
+
+} else if (command === 'reindex') {
+  // ─── Rebuild the search index from the cortex ──────────────────
+  Promise.all([
+    import('../dist/engine/brain.js'),
+    import('../dist/search/index.js'),
+  ]).then(async ([{ Brain }, { SearchEngine }]) => {
+    const brain = new Brain();
+    const engine = new SearchEngine(brain);
+
+    console.log('');
+    console.log('  🔁 Rebuilding the CRBRO search index...');
+    const started = Date.now();
+    const indexed = await engine.rebuild();
+    const seconds = ((Date.now() - started) / 1000).toFixed(1);
+
+    console.log('');
+    console.log(`  ✅ ${indexed} chunks indexed in ${seconds}s`);
+    console.log('     Every fact, decision and pattern is now searchable on its own,');
+    console.log('     so a big neuron is no longer buried by short ones.');
+    console.log('');
+  }).catch(console.error);
+
+} else if (command === 'eval') {
+  // ─── Measure retrieval quality against a query set ─────────────
+  //
+  // Without a number you cannot tell a fix from a feeling. The file is
+  // .crbro/.eval/queries.json — a list of { query, expect_neuron } and
+  // optionally expect_contains, the substring the matched fact should carry.
+  Promise.all([
+    import('../dist/engine/brain.js'),
+    import('../dist/search/index.js'),
+    import('fs/promises'),
+  ]).then(async ([{ Brain }, { SearchEngine }, fsp]) => {
+    const brain = new Brain();
+    const evalPath = join(brain.paths.root, '.eval', 'queries.json');
+
+    let queries;
+    try {
+      queries = JSON.parse(await fsp.readFile(evalPath, 'utf-8'));
+    } catch {
+      console.log('');
+      console.log(`  No query set found at ${evalPath}`);
+      console.log('  Create it as a JSON array, for example:');
+      console.log('');
+      console.log('  [');
+      console.log('    { "query": "how we deploy the api", "expect_neuron": "project_octochat",');
+      console.log('      "expect_contains": "Cloud Run" }');
+      console.log('  ]');
+      console.log('');
+      console.log('  Build it from facts you already saved: take six or eight words');
+      console.log('  out of a real fact and name the neuron that holds it.');
+      console.log('');
+      return;
+    }
+
+    const engine = new SearchEngine(brain);
+    await engine.init();
+
+    let atOne = 0, atThree = 0, reciprocal = 0, contentOk = 0;
+    const misses = [];
+
+    for (const q of queries) {
+      const results = await engine.search(q.query, { limit: 10 });
+      const rank = results.findIndex(r => r.neuron_id === q.expect_neuron);
+
+      if (rank === 0) atOne++;
+      if (rank >= 0 && rank < 3) atThree++;
+      if (rank >= 0) reciprocal += 1 / (rank + 1);
+
+      if (rank === 0 && q.expect_contains) {
+        if (results[0].matching_content.includes(q.expect_contains)) contentOk++;
+        else misses.push(`  ~ "${q.query}" — right neuron, wrong fact returned`);
+      }
+
+      if (rank !== 0) {
+        const got = results[0] ? results[0].neuron_id : '(nothing)';
+        misses.push(`  ✗ "${q.query}" — expected ${q.expect_neuron}, got ${got}` +
+                    (rank > 0 ? ` (it was #${rank + 1})` : ''));
+      }
+    }
+
+    const n = queries.length;
+    const pct = (x) => `${((x / n) * 100).toFixed(1)}%`;
+
+    console.log('');
+    console.log('  📊 CRBRO retrieval eval');
+    console.log('  ───────────────────────');
+    console.log(`  Queries:          ${n}`);
+    console.log(`  Right first hit:  ${atOne}/${n}  (${pct(atOne)})`);
+    console.log(`  In the top 3:     ${atThree}/${n}  (${pct(atThree)})`);
+    console.log(`  MRR:              ${(reciprocal / n).toFixed(3)}`);
+    if (queries.some(q => q.expect_contains)) {
+      const withContent = queries.filter(q => q.expect_contains).length;
+      console.log(`  Right fact shown: ${contentOk}/${withContent}`);
+    }
+
+    if (misses.length > 0) {
+      console.log('');
+      console.log('  Misses:');
+      for (const m of misses.slice(0, 25)) console.log(m);
+      if (misses.length > 25) console.log(`  ... and ${misses.length - 25} more`);
+    }
+    console.log('');
+  }).catch(console.error);
+
+} else if (command === 'install-hooks') {
+  // ─── Wire the SubagentStart hook into Claude Code ──────────────
+  //
+  // SessionStart context never reaches Task-spawned subagents, so without
+  // this every subagent runs without the behavioral protocols the session
+  // was booted with. This registers hooks/crbro-subagent.mjs, which reads
+  // the same protocol neurons crbro_boot reads — one source of truth.
+  //
+  // Merges into ~/.claude/settings.json without touching anything else.
+  // Idempotent: running it twice changes nothing the second time.
+  import('fs').then(async fs => {
+    const settingsPath = join(homedir(), '.claude', 'settings.json');
+    const here = dirname(fileURLToPath(import.meta.url));
+    const source = join(here, '..', 'hooks', 'crbro-subagent.mjs');
+
+    // Copy the hook to a stable location. When CRBRO runs from the npx
+    // cache, `here` changes with every release and the stale path would
+    // break the hook silently on the next update.
+    const hookDir = join(homedir(), '.claude', 'crbro-hooks');
+    const hookScript = join(hookDir, 'crbro-subagent.mjs');
+    fs.mkdirSync(hookDir, { recursive: true });
+    fs.copyFileSync(source, hookScript);
+    const hookCmd = `node "${hookScript.split('\\').join('/')}"`;
+
+    let settings = {};
+    try {
+      settings = JSON.parse(fs.readFileSync(settingsPath, 'utf8').replace(/^/, ''));
+    } catch (e) {
+      if (fs.existsSync(settingsPath)) {
+        console.error(`  ❌ ${settingsPath} exists but could not be parsed — not touching it.`);
+        console.error(`     ${e.message}`);
+        process.exit(1);
+      }
+    }
+
+    settings.hooks = settings.hooks || {};
+    const list = settings.hooks.SubagentStart = settings.hooks.SubagentStart || [];
+    const yaEsta = JSON.stringify(list).includes('crbro-subagent');
+    if (yaEsta) {
+      console.log('  ✅ SubagentStart hook already installed. Nothing to do.');
+      return;
+    }
+    list.push({
+      hooks: [{
+        type: 'command',
+        command: hookCmd,
+        timeout: 5,
+        statusMessage: 'Inyectando protocolos CRBRO en el subagente...',
+      }],
+    });
+
+    const tmp = settingsPath + '.' + process.pid + '.tmp';
+    fs.writeFileSync(tmp, JSON.stringify(settings, null, 2), 'utf8');
+    fs.renameSync(tmp, settingsPath);
+    console.log('  ✅ SubagentStart hook installed.');
+    console.log(`     ${settingsPath}`);
+    console.log('     Every Task-spawned subagent now receives the same behavioral');
+    console.log('     protocols the session boots with. Scope it with the');
+    console.log('     CRBRO_SUBAGENT_MATCHER env var (regex on agent_type) if needed.');
+  }).catch(console.error);
+
+} else if (command === '--help' || command === '-h') {
+  // ─── Help ──────────────────────────────────────────────────────
+  console.log('');
+  console.log('  🧠 CRBRO — Persistent Neural Memory for AI');
+  console.log('  ═══════════════════════════════════════════');
+  console.log('');
+  console.log('  Setup:');
+  console.log('    npx crbro-memory init             Initialize brain + detect IDEs');
+  console.log('    npx crbro-memory status           Show brain status');
+  console.log('');
+  console.log('  Auto-Mining:');
+  console.log('    npx crbro-memory mine [dir]       One-shot mining of artifacts');
+  console.log('    npx crbro-memory setup-miner      Install scheduled auto-miner');
+  console.log('    npx crbro-memory miner-status     Check auto-miner status');
+  console.log('    npx crbro-memory remove-miner     Remove auto-miner');
+  console.log('');
+  console.log('  Search:');
+  console.log('    npx crbro-memory reindex          Rebuild the search index');
+  console.log('    npx crbro-memory eval             Measure retrieval against .crbro/.eval/queries.json');
+  console.log('');
+  console.log('  Server:');
+  console.log('    npx crbro-memory                  Start MCP server (stdio)');
+  console.log('');
+  console.log('  Open source (MIT) — https://github.com/Octonove/crbro-memory');
+  console.log('');
+
+} else {
+  // ─── Default: start MCP server ─────────────────────────────────
+  import('../dist/index.js').catch(console.error);
+}