crbro-memory 1.0.1 → 1.2.0

package/README.md

@@ -1,122 +1,121 @@
-# 🧠 CRBRO — Persistent Neural Memory for AI
-
-**CRBRO** is a local MCP (Model Context Protocol) server that gives your AI assistant **persistent long-term memory** across sessions. It uses a biological neural architecture — cortex, synapses, hippocampus — to store, connect, and retrieve knowledge automatically.
-
-Part of the **[Synthetica Decks](https://synthetica-decks.web.app)** Zero Deck.
-
-## Features
-
-- **🧬 Biological Architecture** — Knowledge organized as neurons (cortex), connections (synapses), and session memory (hippocampus)
-- **🔍 Hybrid Search** — Powered by [Orama](https://orama.com/) for fast BM25 + fuzzy text search
-- **🔥 Heat Scores** — Automatic relevance tracking based on frequency, recency, and connectivity
-- **🗺️ Global Map** — Cluster detection and cross-domain bridge identification *(premium)*
-- **📦 Zero Dependencies** — Pure Node.js, no Python, no Docker, no external databases
-- **💾 File-Based** — All data stored as readable JSON files in `~/.crbro/`
-- **🔌 MCP Native** — Works with Claude Desktop, Cursor, Windsurf, and any MCP-compatible client
-
-## Quick Start
-
-### 1. Initialize
-
-```bash
-npx crbro-memory init
-```
-
-### 2. Add to your MCP config
-
-**Claude Desktop** (`~/AppData/Roaming/Claude/claude_desktop_config.json`):
-```json
-{
-  "mcpServers": {
-    "crbro": {
-      "command": "npx",
-      "args": ["-y", "crbro-memory"]
-    }
-  }
-}
-```
-
-**Cursor** (`.cursor/mcp.json`):
-```json
-{
-  "mcpServers": {
-    "crbro": {
-      "command": "npx",
-      "args": ["-y", "crbro-memory"]
-    }
-  }
-}
-```
-
-### 3. Start using it
-
-Your AI will now have access to 15 memory tools. Start any session with `crbro_boot`.
-
-## Tools
-
-### Free (always available)
-
-| Tool | Description |
-|------|-------------|
-| `crbro_boot` | Boot the brain at session start — loads hot topics and context |
-| `crbro_status` | Brain status — neurons, synapses, sessions count |
-| `crbro_learn` | Store a fact, decision, pattern, or preference |
-| `crbro_neuron` | Read a specific neuron (topic) with all its knowledge |
-| `crbro_neurons` | List neurons with optional filters (domain, type, heat) |
-| `crbro_recall` | Search the brain using hybrid text search |
-| `crbro_connect` | Create or strengthen a connection between neurons |
-| `crbro_connections` | Get all connections for a neuron |
-| `crbro_session_log` | Log a session summary |
-| `crbro_sessions` | List recent sessions |
-| `crbro_context` | Read/update active working context |
-| `crbro_hot_topics` | Get the most active topics by heat score |
-| `crbro_consolidate` | End-of-session consolidation |
-
-### Premium (requires Synthetica Zero Deck license)
-
-| Tool | Description |
-|------|-------------|
-| `crbro_global_map` | View the neural network — clusters and cross-domain bridges |
-| `crbro_maintenance` | Full brain maintenance — archive, prune, rebuild |
-
-## Architecture
-
-```
-~/.crbro/
-├── manifest.json           ← Brain metadata
-├── cortex/                 ← One JSON per neuron (topic)
-│   ├── project_octochat.json
-│   └── tech_firebase.json
-├── synapses/               ← One JSON per connection
-│   └── syn_octochat__firebase.json
-├── hippocampus/            ← One JSON per session
-│   └── session_2026-05-06.json
-├── prefrontal/             ← Working memory
-│   ├── active_context.json
-│   ├── hot_topics.json
-│   └── global_map.json
-├── archives/               ← Cold neurons
-└── .search/                ← Orama search index
-    └── orama.index.json
-```
-
-## Heat Score Algorithm
-
-Each neuron has a heat score (0.0 - 1.0) calculated from:
-
-- **Frequency (35%)** — How often the neuron is accessed
-- **Recency (40%)** — When it was last accessed (today = 1.0, >3 months = 0.05)
-- **Connectivity (25%)** — How many synapses connect to it
-
-## CLI Commands
-
-```bash
-npx crbro-memory          # Start MCP server
-npx crbro-memory init     # Initialize brain
-npx crbro-memory status   # Show brain status
-npx crbro-memory --help   # Help
-```
-
-## License
-
-MIT — Part of [Synthetica Decks](https://synthetica-decks.web.app) by Octonove Agency.
+# 🧠 CRBRO — Persistent Neural Memory for AI
+
+**CRBRO** is a local MCP (Model Context Protocol) server that gives your AI assistant **persistent long-term memory** across sessions. It uses a biological neural architecture — cortex, synapses, hippocampus — to store, connect, and retrieve knowledge automatically.
+
+
+## Features
+
+- **🧬 Biological Architecture** — Knowledge organized as neurons (cortex), connections (synapses), and session memory (hippocampus)
+- **🔍 Hybrid Search** — Powered by [Orama](https://orama.com/) for fast BM25 + fuzzy text search
+- **🔥 Heat Scores** — Automatic relevance tracking based on frequency, recency, and connectivity
+- **🗺️ Global Map** — Cluster detection and cross-domain bridge identification *(premium)*
+- **📦 Zero Dependencies** — Pure Node.js, no Python, no Docker, no external databases
+- **💾 File-Based** — All data stored as readable JSON files in `~/.crbro/`
+- **🔌 MCP Native** — Works with Claude Desktop, Cursor, Windsurf, and any MCP-compatible client
+
+## Quick Start
+
+### 1. Initialize
+
+```bash
+npx crbro-memory init
+```
+
+### 2. Add to your MCP config
+
+**Claude Desktop** (`~/AppData/Roaming/Claude/claude_desktop_config.json`):
+```json
+{
+  "mcpServers": {
+    "crbro": {
+      "command": "npx",
+      "args": ["-y", "crbro-memory"]
+    }
+  }
+}
+```
+
+**Cursor** (`.cursor/mcp.json`):
+```json
+{
+  "mcpServers": {
+    "crbro": {
+      "command": "npx",
+      "args": ["-y", "crbro-memory"]
+    }
+  }
+}
+```
+
+### 3. Start using it
+
+Your AI will now have access to 15 memory tools. Start any session with `crbro_boot`.
+
+## Tools
+
+### Free (always available)
+
+| Tool | Description |
+|------|-------------|
+| `crbro_boot` | Boot the brain at session start — loads hot topics and context |
+| `crbro_status` | Brain status — neurons, synapses, sessions count |
+| `crbro_learn` | Store a fact, decision, pattern, or preference |
+| `crbro_neuron` | Read a specific neuron (topic) with all its knowledge |
+| `crbro_neurons` | List neurons with optional filters (domain, type, heat) |
+| `crbro_recall` | Search the brain using hybrid text search |
+| `crbro_connect` | Create or strengthen a connection between neurons |
+| `crbro_connections` | Get all connections for a neuron |
+| `crbro_session_log` | Log a session summary |
+| `crbro_sessions` | List recent sessions |
+| `crbro_context` | Read/update active working context |
+| `crbro_hot_topics` | Get the most active topics by heat score |
+| `crbro_consolidate` | End-of-session consolidation |
+
+### Premium (requires Synthetica Zero Deck license)
+
+| Tool | Description |
+|------|-------------|
+| `crbro_global_map` | View the neural network — clusters and cross-domain bridges |
+| `crbro_maintenance` | Full brain maintenance — archive, prune, rebuild |
+
+## Architecture
+
+```
+~/.crbro/
+├── manifest.json           ← Brain metadata
+├── cortex/                 ← One JSON per neuron (topic)
+│   ├── project_octochat.json
+│   └── tech_firebase.json
+├── synapses/               ← One JSON per connection
+│   └── syn_octochat__firebase.json
+├── hippocampus/            ← One JSON per session
+│   └── session_2026-05-06.json
+├── prefrontal/             ← Working memory
+│   ├── active_context.json
+│   ├── hot_topics.json
+│   └── global_map.json
+├── archives/               ← Cold neurons
+└── .search/                ← Orama search index
+    └── orama.index.json
+```
+
+## Heat Score Algorithm
+
+Each neuron has a heat score (0.0 - 1.0) calculated from:
+
+- **Frequency (35%)** — How often the neuron is accessed
+- **Recency (40%)** — When it was last accessed (today = 1.0, >3 months = 0.05)
+- **Connectivity (25%)** — How many synapses connect to it
+
+## CLI Commands
+
+```bash
+npx crbro-memory          # Start MCP server
+npx crbro-memory init     # Initialize brain
+npx crbro-memory status   # Show brain status
+npx crbro-memory --help   # Help
+```
+
+## License
+
+MIT — Part of Octonove Agency.

package/bin/crbro.js

@@ -2,98 +2,337 @@
 
 // ─── CRBRO CLI ───────────────────────────────────────────────────
 // Command-line interface for CRBRO memory system
+// Supports: init, status, activate, mine, setup-miner, miner-status,
+//           remove-miner, and MCP server mode (default)
+
+import { platform, homedir } from 'os';
+import { join } from 'path';
+import { existsSync } from 'fs';
 
 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
+  // ─── Initialize brain + IDE detection ──────────────────────────
   import('../dist/engine/brain.js').then(async ({ Brain }) => {
     const brain = new Brain();
     const manifest = await brain.initialize();
-    console.log('🧠 CRBRO brain initialized!');
-    console.log(`   Path: ${manifest.brain_path}`);
+
     console.log('');
-    console.log('Add CRBRO to your MCP config:');
+    console.log('  🧠 CRBRO brain initialized!');
+    console.log(`     Path: ${manifest.brain_path}`);
     console.log('');
-    console.log(JSON.stringify({
-      "mcpServers": {
-        "crbro": {
-          "command": "npx",
-          "args": ["-y", "crbro-memory"]
-        }
+
+    // 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}`);
       }
-    }, null, 2));
+      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. npx crbro-memory activate YOUR-LICENSE-KEY');
+    console.log('    3. (Optional) npx crbro-memory setup-miner');
+    console.log('    4. Restart your IDE — CRBRO boots automatically!');
+    console.log('');
   }).catch(console.error);
 
 } else if (command === 'status') {
-  // Show brain status
+  // ─── Show brain status ─────────────────────────────────────────
   import('../dist/engine/brain.js').then(async ({ Brain }) => {
     const brain = new Brain();
     try {
       const manifest = await brain.getManifest();
-      console.log('🧠 CRBRO Brain Status');
-      console.log(`   Version:  ${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('');
+      console.log('  🧠 CRBRO Brain Status');
+      console.log('  ─────────────────────');
+      console.log(`  Version:         ${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(`  License:         ${manifest.license_key ? '✅ Active' : '❌ Not activated'}`);
+      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('🧠 CRBRO brain not initialized. Run: npx crbro-memory init');
+      console.log('');
+      console.log('  🧠 CRBRO brain not initialized.');
+      console.log('     Run: npx crbro-memory init');
+      console.log('');
     }
   }).catch(console.error);
 
 } else if (command === 'activate') {
-  // Activate license key
+  // ─── Activate license key ──────────────────────────────────────
   const key = args[1];
   if (!key) {
-    console.log('❌ Usage: npx crbro-memory activate SYNTH-ZERO-XXXX-XXXX-XXXX');
     console.log('');
-    console.log('Get your license key at https://synthetica-decks.web.app');
+    console.log('  ❌ Usage: npx crbro-memory activate SYNTH-ZERO-XXXX-XXXX-XXXX');
+    console.log('');
+    console.log('  Get your license key at https://synthetica-decks.web.app');
+    console.log('');
     process.exit(1);
   }
 
   import('../dist/engine/brain.js').then(async ({ Brain }) => {
     const brain = new Brain();
     try {
-      await brain.getManifest(); // Ensure brain exists
+      await brain.getManifest();
     } catch {
-      console.log('🧠 Brain not initialized. Initializing now...');
+      console.log('  🧠 Brain not initialized. Initializing now...');
       await brain.initialize();
     }
 
     // Validate key format
     if (!key.startsWith('SYNTH-ZERO-') || key.length < 20) {
-      console.log('❌ Invalid license key format.');
-      console.log('   Keys start with SYNTH-ZERO- and are at least 20 characters.');
+      console.log('  ❌ Invalid license key format.');
+      console.log('     Keys start with SYNTH-ZERO- and are at least 20 characters.');
       process.exit(1);
     }
 
     // Persist key in manifest
     await brain.updateManifest({ license_key: key });
-    console.log('✅ License key activated!');
     console.log('');
-    console.log('   🔓 Premium features unlocked:');
-    console.log('      • crbro_global_map  — Neural cluster visualization');
-    console.log('      • crbro_maintenance — Automated brain optimization');
+    console.log('  ✅ License key activated!');
+    console.log('');
+    console.log('  🔓 Premium features unlocked:');
+    console.log('     • crbro_global_map  — Neural cluster visualization');
+    console.log('     • crbro_maintenance — Automated brain optimization');
+    console.log('');
+    console.log('  Restart your IDE to apply changes.');
+    console.log('');
+  }).catch(console.error);
+
+} 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('');
-    console.log('   Restart your IDE to apply changes.');
   }).catch(console.error);
 
 } else if (command === '--help' || command === '-h') {
-  console.log('🧠 CRBRO — Persistent Neural Memory for AI');
+  // ─── 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 activate KEY     Activate premium license');
+  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('  Server:');
+  console.log('    npx crbro-memory                  Start MCP server (stdio)');
   console.log('');
-  console.log('Usage:');
-  console.log('  npx crbro-memory              Start MCP server (stdio)');
-  console.log('  npx crbro-memory init         Initialize brain directory');
-  console.log('  npx crbro-memory status       Show brain status');
-  console.log('  npx crbro-memory activate KEY Activate premium license');
-  console.log('  npx crbro-memory --help       Show this help');
+  console.log('  Part of Synthetica Decks — https://synthetica-decks.web.app');
   console.log('');
-  console.log('Part of Synthetica Decks — https://synthetica-decks.web.app');
 
 } else {
-  // Default: start MCP server
+  // ─── Default: start MCP server ─────────────────────────────────
   import('../dist/index.js').catch(console.error);
 }