crbro-memory 1.14.0 → 1.16.0

package/bin/crbro.mjs

@@ -1,578 +1,621 @@
-#!/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 === 'semantic') {
-  // ─── Opt-in semantic layer: install the runtime, embed the brain, status ─
-  //
-  // Nothing semantic exists until the user runs `semantic install` AND sets
-  // CRBRO_SEMANTIC=1 in the server's env. The runtime (~380 MB with
-  // onnxruntime) and the model (~118 MB) live in ~/.crbro/.semantic, once per
-  // machine, outside the package — most users never need either.
-  const sub = args[1];
-  import('../dist/search/semantic.js').then(async (sem) => {
-    if (sub === 'install') {
-      const { spawnSync } = await import('child_process');
-      const fs = await import('fs');
-      const home = sem.semanticHome();
-      fs.mkdirSync(home, { recursive: true });
-      const pkg = join(home, 'package.json');
-      if (!fs.existsSync(pkg)) {
-        fs.writeFileSync(pkg, JSON.stringify({ name: 'crbro-semantic', private: true }, null, 2));
-      }
-      console.log('');
-      console.log(`  ⬇️  Installing transformers.js into ${home} (~380 MB with onnxruntime)...`);
-      const r = spawnSync('npm', ['install', '--no-audit', '--no-fund', '@huggingface/transformers@3'],
-        { cwd: home, stdio: 'inherit', shell: true });
-      if (r.status !== 0) {
-        console.log('  ❌ npm install failed. Nothing else changed.');
-        process.exit(1);
-      }
-      console.log('');
-      console.log(`  ✅ Runtime installed. The model (${sem.SEMANTIC_MODEL}, ~118 MB) downloads on first use.`);
-      console.log('     1. Add CRBRO_SEMANTIC=1 to the env of the crbro MCP server in your client config.');
-      console.log('     2. Run once:  npx crbro-memory semantic build   (embeds the whole brain)');
-      console.log('     Recall stays lexical until both are done; new lines are embedded as they are saved.');
-      console.log('');
-    } else if (sub === 'build') {
-      process.env.CRBRO_SEMANTIC = '1';
-      const st = sem.semanticStatus();
-      if (!st.installed) {
-        console.log('');
-        console.log('  ❌ Runtime not installed. Run: npx crbro-memory semantic install');
-        console.log('');
-        return;
-      }
-      const [{ Brain }, { SearchEngine }] = await Promise.all([
-        import('../dist/engine/brain.js'),
-        import('../dist/search/index.js'),
-      ]);
-      const brain = new Brain();
-      const engine = new SearchEngine(brain);
-      console.log('');
-      console.log('  🧭 Embedding the brain (first run also downloads the model, ~118 MB)...');
-      const started = Date.now();
-      const n = await engine.rebuild();
-      await engine.persist();
-      const seconds = ((Date.now() - started) / 1000).toFixed(1);
-      console.log(`  ✅ ${n} chunks indexed · ${engine.semanticCount()} vectors stored · ${seconds}s`);
-      console.log('     From now on each new line is embedded when it is saved.');
-      console.log('');
-    } else {
-      const st = sem.semanticStatus();
-      console.log('');
-      console.log('  🧭 CRBRO semantic layer (opt-in)');
-      console.log('  ─────────────────────────────────');
-      console.log(`  Runtime:  ${st.installed ? '✅ installed' : '❌ not installed  →  npx crbro-memory semantic install'}`);
-      console.log(`  Enabled:  ${st.enabled ? '✅ CRBRO_SEMANTIC=1' : '⚪ off  →  set CRBRO_SEMANTIC=1 in the server env'}`);
-      console.log(`  Home:     ${st.home}`);
-      console.log(`  Model:    ${st.model}`);
-      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);
-    // Injection is OPT-IN since 1.12 (pre-registered consequence of three
-    // clean-control benchmark runs: no measured benefit in any model, harm
-    // and fabricated compliance in small ones — see the benchmarks in the
-    // card repo). `install-hooks` alone installs the machinery inert;
-    // `install-hooks --inject` enables injection for every subagent.
-    const conInyeccion = process.argv.includes('--inject');
-    const hookCmd = (conInyeccion ? 'CRBRO_SUBAGENT_INJECT=full ' : '') + `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. Script refreshed.');
-      if (conInyeccion && !JSON.stringify(list).includes('CRBRO_SUBAGENT_INJECT')) {
-        console.log('     ⚠️  The installed entry does NOT enable injection. To enable it,');
-        console.log('     remove the SubagentStart entry from settings.json and re-run');
-        console.log('     install-hooks --inject.');
-      }
-      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}`);
-    if (conInyeccion) {
-      console.log('     Injection ENABLED: every Task-spawned subagent receives the');
-      console.log('     protocol block. Scope it with CRBRO_SUBAGENT_MATCHER (regex on');
-      console.log('     agent_type) if needed. Measured caveat: on small models the');
-      console.log('     block bought no benchmarked benefit and induced fabricated');
-      console.log('     compliance in some runs — see the benchmarks before scoping.');
-    } else {
-      console.log('     Injection is OPT-IN and currently OFF (the measured default:');
-      console.log('     three clean benchmark runs found no benefit in any model and');
-      console.log('     harm in small ones). Re-run with --inject to enable it.');
-    }
-  }).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('  Semantic layer (opt-in, ~500 MB on disk, measured in benchmarks/):');
-  console.log('    npx crbro-memory semantic install Install transformers.js into ~/.crbro/.semantic');
-  console.log('    npx crbro-memory semantic build   Embed the whole brain once (needs CRBRO_SEMANTIC=1)');
-  console.log('    npx crbro-memory semantic status  Runtime, model and whether it is enabled');
-  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 ───────────────────────────────────────────────────
+
+// ─── Semantic recall: install, download, embed ──────────────────────
+// Installed by `init` since 1.16 (skip with --no-semantic, turn off with
+// CRBRO_SEMANTIC=0). The runtime (~380 MB) and the model (~118 MB) live in
+// ~/.crbro/.semantic once per machine, outside the package.
+async function semanticInstall(sem) {
+  const { spawnSync } = await import('child_process');
+  const fs = await import('fs');
+  const os = await import('os');
+  const home = sem.semanticHome();
+  fs.mkdirSync(home, { recursive: true });
+  const pkg = join(home, 'package.json');
+  if (!fs.existsSync(pkg)) {
+    fs.writeFileSync(pkg, JSON.stringify({ name: 'crbro-semantic', private: true }, null, 2));
+  }
+  if (!sem.resolveRuntime()) {
+    console.log(`  ⬇️  Installing transformers.js into ${home} (~380 MB with onnxruntime)...`);
+    const r = spawnSync('npm', ['install', '--no-audit', '--no-fund', '--loglevel=error', '@huggingface/transformers@3'],
+      { cwd: home, stdio: 'inherit', shell: true });
+    if (r.status !== 0) return false;
+  }
+  const st = sem.semanticStatus();
+  if (!st.model_downloaded) {
+    console.log(`  ⬇️  Downloading the model (${st.model}, ~118 MB)...`);
+    const idx = new sem.SemanticIndex(fs.mkdtempSync(join(os.tmpdir(), 'crbro-warm-')));
+    await idx.upsert([{ id: 'warm', text: 'hello' }]);   // the first use downloads and caches it
+  }
+  return true;
+}
+
+async function semanticBuild() {
+  process.env.CRBRO_SEMANTIC = '1';
+  const [{ Brain }, { SearchEngine }] = await Promise.all([
+    import('../dist/engine/brain.js'),
+    import('../dist/search/index.js'),
+  ]);
+  const brain = new Brain();
+  const engine = new SearchEngine(brain);
+  const started = Date.now();
+  await engine.init();            // loads the stored vectors: unchanged lines are not embedded twice
+  const chunks = await engine.rebuild();
+  await engine.awaitEmbeddings();
+  await engine.persist();
+  return { chunks, vectors: engine.semanticCount(), seconds: ((Date.now() - started) / 1000).toFixed(1) };
+}
+
+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  '));
+    // Semantic recall, installed by default since 1.16: once per machine,
+    // about 500 MB on disk, ~0.5 GB of RAM while a server runs.
+    const skipSemantic = args.includes('--no-semantic')
+      || ['0', 'off', 'false'].includes(String(process.env.CRBRO_SEMANTIC || '').toLowerCase());
+    console.log('');
+    if (skipSemantic) {
+  console.log('    npx crbro-memory semantic status  Semantic recall (installed by init; --no-semantic skips it): status | install | build');
+    } else {
+      console.log('  🧭 Semantic recall: installing (once per machine, ~500 MB)...');
+      try {
+        const sem = await import('../dist/search/semantic.js');
+        const ok = await semanticInstall(sem);
+        if (ok) {
+          const r = await semanticBuild();
+          console.log(`  ✅ Semantic recall ready · ${r.vectors} lines embedded in ${r.seconds}s · CRBRO_SEMANTIC=0 turns it off`);
+        } else {
+          console.log('  ⚠️  Could not install it; recall stays keyword-only. Retry: npx crbro-memory semantic install');
+        }
+      } catch (err) {
+        console.log(`  ⚠️  Semantic recall not installed (${err instanceof Error ? err.message : err}); recall stays keyword-only.`);
+      }
+    }
+    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 === 'semantic') {
+  // ─── Semantic recall: status | install | build ─────────────────
+  const sub = args[1];
+  import('../dist/search/semantic.js').then(async (sem) => {
+    if (sub === 'install') {
+      console.log('');
+      const ok = await semanticInstall(sem);
+      if (!ok) {
+        console.log('  ❌ npm install failed. Nothing else changed.');
+        process.exit(1);
+      }
+      const r = await semanticBuild();
+      console.log(`  ✅ Semantic recall ready · ${r.chunks} chunks indexed · ${r.vectors} vectors · ${r.seconds}s`);
+      console.log('     It is on whenever this runtime is present; CRBRO_SEMANTIC=0 turns it off.');
+      console.log('');
+    } else if (sub === 'build') {
+      const st = sem.semanticStatus();
+      if (!st.installed) {
+        console.log('');
+        console.log('  ❌ Runtime not installed. Run: npx crbro-memory semantic install');
+        console.log('');
+        return;
+      }
+      console.log('');
+      console.log('  🧭 Embedding the brain...');
+      const r = await semanticBuild();
+      console.log(`  ✅ ${r.chunks} chunks indexed · ${r.vectors} vectors stored · ${r.seconds}s`);
+      console.log('     From now on each new line is embedded when it is saved.');
+      console.log('');
+    } else {
+      const st = sem.semanticStatus();
+      const enabled = st.enabled
+        ? (st.mode === 'forced' ? '✅ on (CRBRO_SEMANTIC=1)' : '✅ on (installed; CRBRO_SEMANTIC=0 turns it off)')
+        : (st.mode === 'disabled' ? '⚪ off (CRBRO_SEMANTIC=0)' : '⚪ off (not installed)');
+      console.log('');
+      console.log('  🧭 CRBRO semantic recall');
+      console.log('  ────────────────────────');
+      console.log(`  Runtime:  ${st.installed ? '✅ installed' : '❌ not installed  →  npx crbro-memory init  (or: semantic install)'}`);
+      console.log(`  Model:    ${st.model}${st.model_downloaded ? '' : '  (downloads on first use)'}`);
+      console.log(`  Enabled:  ${enabled}`);
+      console.log(`  Home:     ${st.home}`);
+      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);
+    // Injection is OPT-IN since 1.12 (pre-registered consequence of three
+    // clean-control benchmark runs: no measured benefit in any model, harm
+    // and fabricated compliance in small ones — see the benchmarks in the
+    // card repo). `install-hooks` alone installs the machinery inert;
+    // `install-hooks --inject` enables injection for every subagent.
+    const conInyeccion = process.argv.includes('--inject');
+    const hookCmd = (conInyeccion ? 'CRBRO_SUBAGENT_INJECT=full ' : '') + `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. Script refreshed.');
+      if (conInyeccion && !JSON.stringify(list).includes('CRBRO_SUBAGENT_INJECT')) {
+        console.log('     ⚠️  The installed entry does NOT enable injection. To enable it,');
+        console.log('     remove the SubagentStart entry from settings.json and re-run');
+        console.log('     install-hooks --inject.');
+      }
+      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}`);
+    if (conInyeccion) {
+      console.log('     Injection ENABLED: every Task-spawned subagent receives the');
+      console.log('     protocol block. Scope it with CRBRO_SUBAGENT_MATCHER (regex on');
+      console.log('     agent_type) if needed. Measured caveat: on small models the');
+      console.log('     block bought no benchmarked benefit and induced fabricated');
+      console.log('     compliance in some runs — see the benchmarks before scoping.');
+    } else {
+      console.log('     Injection is OPT-IN and currently OFF (the measured default:');
+      console.log('     three clean benchmark runs found no benefit in any model and');
+      console.log('     harm in small ones). Re-run with --inject to enable it.');
+    }
+  }).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('  Semantic layer (opt-in, ~500 MB on disk, measured in benchmarks/):');
+  console.log('    npx crbro-memory semantic install Install transformers.js into ~/.crbro/.semantic');
+  console.log('    npx crbro-memory semantic build   Embed the whole brain once (needs CRBRO_SEMANTIC=1)');
+  console.log('    npx crbro-memory semantic status  Runtime, model and whether it is enabled');
+  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);
+}