nano-brain 2026.8.2 → 2026.8.3

package/README.md

@@ -737,13 +737,25 @@ 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 run                    # Run benchmark suite (scale-100)
+nano-brain bench run --scale 500        # Larger corpus
+nano-brain bench compare new.json baseline.json  # Regression check
+```
+
+Current results on v2026.8.2 (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
 ```
 
+See [`benchmarks/README.md`](benchmarks/README.md) for full explanation of metrics, use cases, and regression detection.
+
 ### Logging
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nano-brain",
-  "version": "2026.8.2",
+  "version": "2026.8.3",
   "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,