nano-brain 2026.8.2 → 2026.8.4

package/README.md

@@ -636,17 +636,15 @@ nano-brain status             # Show index health, collections, model status
 
 ```bash
 nano-brain mcp                                      # Start MCP server (stdio)
-nano-brain mcp --http --port=3100 --host=0.0.0.0   # Start MCP server (HTTP/SSE)
+nano-brain mcp --http                               # Start MCP server (HTTP/SSE, default port 8282)
+nano-brain mcp --http --port=3100 --host=0.0.0.0   # Custom port (e.g. Docker default 3100)
 ```
 
 ### Remote Server (Daemon)
 
 ```bash
-nano-brain serve              # Start SSE server as background daemon (port 3100)
-nano-brain serve status       # Check if server is running
-nano-brain serve stop         # Stop the daemon
-nano-brain serve --foreground # Run in foreground (for debugging)
-nano-brain serve --port=8080  # Custom port
+nano-brain mcp --http --daemon --port=8282   # Start HTTP/SSE server as background daemon
+nano-brain mcp --http --daemon --port=3100   # Custom port (e.g. Docker default)
 ```
 
 ### Docker Deployment
@@ -666,6 +664,10 @@ Environment variables for volume mounts:
 - `NANO_BRAIN_HOME` — Path to data directory (default: `~/.nano-brain`)
 - `NANO_BRAIN_WORKSPACE` — Path to your project workspace to index as codebase (mounted read-only, passed as `--root`)
 
+Runtime environment variables:
+- `OPENCODE_STORAGE_DIR` — Override OpenCode session storage path (useful in Docker where container homedir differs from host). Example: `/Users/tamlh/.local/share/opencode/storage`
+- `NANO_BRAIN_EMBEDDING_CONCURRENCY` — Number of parallel embedding requests to Ollama (default: `3`)
+
 ### Search
 
 ```bash
@@ -691,7 +693,7 @@ nano-brain tags                     # List all tags with counts
 
 ```bash
 nano-brain update               # Reindex all collections
-nano-brain index-codebase       # Index codebase in current workspace
+nano-brain reindex              # Index codebase in current workspace
 nano-brain reset --confirm      # Reset all data (requires confirmation)
 nano-brain reset --dry-run      # Preview what would be deleted
 ```
@@ -737,11 +739,26 @@ nano-brain cache stats          # Show cache statistics
 
 ### Benchmarking
 
+Measures search quality (P@5, R@10, MRR) and latency across FTS, vector, and hybrid modes.
+
 ```bash
-nano-brain bench                # Run default benchmark suite
-nano-brain bench --suite=search # Run specific suite
-nano-brain bench --iterations=100 --json --save
-nano-brain bench --compare=baseline.json  # Compare with baseline
+nano-brain bench generate               # Generate fixtures (scale-100)
+nano-brain bench generate --scale=1000  # Larger corpus (valid: 100,1000,5000,10000,100000)
+nano-brain bench run                    # Run benchmark suite (scale-100)
+nano-brain bench run --scale=1000       # Run at larger scale
+nano-brain bench compare new.json baseline.json  # Regression check
+nano-brain bench compare new.json baseline.json --save=baseline.json --force  # Save + force
+```
+
+See [`benchmarks/README.md`](benchmarks/README.md) for full explanation of metrics, corpus generation, and regression detection.
+
+Current results on v2026.8.3 (100 docs, Ollama local):
+
+```
+Mode      P@5     R@10    MRR     Latency (p50)
+FTS       0.975   0.985   1.000   1ms
+Vector    0.875   0.925   1.000   29ms
+Hybrid    0.835   0.970   1.000   34ms
 ```
 
 ### Logging
@@ -755,6 +772,23 @@ nano-brain logs --clear         # Delete all log files
 nano-brain logs path            # Print log directory path
 ```
 
+### Code Intelligence
+
+```bash
+nano-brain context <symbol>            # 360° view of a code symbol (callers, callees, flows)
+nano-brain code-impact <symbol>        # Analyze impact of changing a symbol
+nano-brain detect-changes              # Map current git changes to affected symbols and flows
+nano-brain wake-up                     # Generate a compact context briefing for session start
+```
+
+### Memory Intelligence
+
+```bash
+nano-brain consolidate                 # Run consolidation job manually
+nano-brain categorize-backfill         # Backfill LLM categorization on existing documents
+nano-brain learning rollback [id]      # Manage self-learning system; rollback to a previous config version
+```
+
 ## Project Structure
 
 ```

package/docker-compose.yml

@@ -33,7 +33,7 @@ services:
       - nano-brain-node-modules:/app/node_modules
       - ${NANO_BRAIN_HOME:-~/.nano-brain}:/root/.nano-brain
       - ${NANO_BRAIN_WORKSPACE:-/Users/tamlh/workspaces/NUSTechnology/Projects/zengamingx}:${NANO_BRAIN_WORKSPACE:-/Users/tamlh/workspaces/NUSTechnology/Projects/zengamingx}:ro
-      - ${OPENCODE_SESSION_DIR:-~/.ai-sandbox/tools/opencode/home/.local/share/opencode/storage}:/root/.local/share/opencode/storage:ro
+      - ${OPENCODE_DATA_DIR:-~/.ai-sandbox/tools/opencode/home/.local/share/opencode}:/root/.local/share/opencode:ro
     environment:
       - NODE_ENV=production
       - OLLAMA_HOST=http://host.docker.internal:11434

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nano-brain",
-  "version": "2026.8.2",
+  "version": "2026.8.4",
   "description": "Persistent memory and code intelligence for AI coding agents. Local MCP server with self-learning hybrid search (BM25 + vector + knowledge graph + LLM reranking), automatic session ingestion, codebase indexing, and 22 tools. Learns your preferences over time. Works with OpenCode, Claude, Cursor, Windsurf, and any MCP client.",
   "type": "module",
   "bin": {

package/src/bench/runner.ts

@@ -212,9 +212,21 @@ async function measureQuality(
 
 async function insertDocs(
   dbPath: string,
-  fixturesDir: string
+  fixturesDir: string,
+  ollamaUrl: string | null
 ): Promise<LatencyStats> {
   const store = createStore(dbPath);
+  store.ensureVecTable(768);
+
+  let embedder: { embed(text: string): Promise<{ embedding: number[] }>; dispose(): void } | null = null;
+  if (ollamaUrl) {
+    try {
+      embedder = await createEmbeddingProvider({ embeddingConfig: { url: ollamaUrl } });
+    } catch {
+      embedder = null;
+    }
+  }
+
   const docsDir = path.join(fixturesDir, 'docs');
   const docFiles = fs.readdirSync(docsDir).filter(f => f.endsWith('.md'));
   const insertTimes: number[] = [];
@@ -240,9 +252,14 @@ async function insertDocs(
         active: true,
         projectHash,
       });
+      if (embedder) {
+        const { embedding } = await embedder.embed(content);
+        store.insertEmbedding(hash, 0, 0, embedding, 'nomic-embed-text');
+      }
       insertTimes.push(Date.now() - t0);
     }
   } finally {
+    embedder?.dispose();
     store.close();
   }
 
@@ -427,7 +444,7 @@ export async function runBenchmarkSuite(opts: RunOptions): Promise<BenchResult>
       }
 
       console.log('  Inserting docs...');
-      const insertLatency = await insertDocs(testDbPath, fixturesDir);
+      const insertLatency = await insertDocs(testDbPath, fixturesDir, ollamaUrl);
 
       console.log('  Running quality metrics...');
       const { quality, latency: queryLatency } = await measureQuality(testDbPath, groundTruth, ollamaUrl);

package/src/cli/utils.ts

@@ -54,6 +54,8 @@ export function getHttpPort(): number {
 }
 
 export function resolveOpenCodeStorageDir(): string {
+  // Explicit override (useful in Docker where homedir != host homedir)
+  if (process.env.OPENCODE_STORAGE_DIR) return process.env.OPENCODE_STORAGE_DIR;
   // XDG path (Linux): ~/.local/share/opencode/storage
   const xdgData = process.env.XDG_DATA_HOME || path.join(os.homedir(), '.local', 'share');
   const xdgPath = path.join(xdgData, 'opencode', 'storage');

package/src/jobs/watcher.ts

@@ -129,7 +129,7 @@ export function startWatcher(options: WatcherOptions): Watcher {
     pollIntervalMs = 300000,
     sessionPollMs = 120000,
     embedIntervalMs = 60000,
-    sessionStorageDir = path.join(os.homedir(), '.local/share/opencode/storage'),
+    sessionStorageDir = process.env.OPENCODE_STORAGE_DIR ?? path.join(os.homedir(), '.local/share/opencode/storage'),
     outputDir = path.join(os.homedir(), '.nano-brain/sessions'),
     storageConfig,
     dbPath,