brainbank 0.2.2 → 0.3.1

package/README.md

@@ -120,7 +120,7 @@ await brain.index();  // indexes code + git history (incremental)
 
 // Search across everything
 const results = await brain.hybridSearch('authentication middleware');
-console.log(results.map(r => `${r.filePath}:${r.line} (${r.score.toFixed(2)})`));
+console.log(results.map(r => `${r.filePath}:L${r.metadata?.startLine} (${r.score.toFixed(2)})`));
 
 // Store agent memory
 const log = brain.collection('decisions');
@@ -134,7 +134,7 @@ await log.add(
 // Recall later: "what did we decide about password hashing?"
 const hits = await log.search('password hashing decision');
 
-await brain.close();
+brain.close();
 ```
 
 Or use the CLI — zero code:
@@ -569,7 +569,7 @@ export default {
   name: 'conversations',
   async initialize(ctx: IndexerContext) {
     const conversations = ctx.collection('conversations');
-    const logsDir = path.join(ctx.repoPath, '.gemini/antigravity/brain');
+    const logsDir = path.join(ctx.config.repoPath, '.gemini/antigravity/brain');
     if (!fs.existsSync(logsDir)) return;
 
     for (const dir of fs.readdirSync(logsDir)) {
@@ -632,6 +632,18 @@ The agent passes the `repo` parameter on each tool call based on the active work
 
 > Optionally set `BRAINBANK_REPO` as a default fallback repo. If omitted, every tool call must include the `repo` parameter (recommended for multi-workspace setups).
 
+> [!CAUTION]
+> **Embedding Provider Consistency is Critical**
+>
+> The embedding provider used by the MCP server **must match** the one used during indexing. Mismatched dimensions cause `initialize()` to throw or search to return empty results.
+>
+> **Common failure scenario:**
+> 1. You index via CLI with `BRAINBANK_EMBEDDING=openai` (1536 dims)
+> 2. MCP server starts without `BRAINBANK_EMBEDDING` env var → defaults to local (384 dims)
+> 3. **Result:** BrainBank throws `Embedding dimension mismatch` on every search
+>
+> **Fix:** Always set `BRAINBANK_EMBEDDING` consistently in your MCP config, CLI, and API usage. If you indexed with OpenAI, your MCP config **must** include `"BRAINBANK_EMBEDDING": "openai"`. If you switch providers, run `brainbank reembed` to regenerate all vectors.
+
 ### Available Tools
 
 | Tool | Description |
@@ -690,7 +702,8 @@ new OpenAIEmbedding({
 });
 ```
 
-> ⚠️ Switching embedding provider requires re-indexing — vectors are not cross-compatible.
+> [!WARNING]
+> Switching embedding provider (e.g. local → OpenAI) changes the vector dimensions. BrainBank will **refuse to initialize** if the stored dimensions don't match the current provider. Use `initialize({ force: true })` and then `reembed()` to migrate, or switch back to the original provider.
 
 ### Reranker
 
@@ -830,7 +843,6 @@ The `LLMProvider` interface works with any framework:
 |----------|-------------|
 | `BRAINBANK_REPO` | Default repository path (optional — auto-detected from `.git/` or passed per tool call) |
 | `BRAINBANK_EMBEDDING` | Embedding provider: `local` (default), `openai` |
-| `BRAINBANK_RERANKER` | Reranker: `none` (default), `qwen3` to enable |
 | `BRAINBANK_DEBUG` | Show full stack traces |
 | `OPENAI_API_KEY` | Required when using `BRAINBANK_EMBEDDING=openai` |
 
@@ -976,11 +988,9 @@ import { BrainBank, OpenAIEmbedding } from 'brainbank';
 const brain = new BrainBank({
   embeddingProvider: new OpenAIEmbedding(),
 });
-await brain.initialize();
 
-// ⚠ BrainBank emits 'warning' event if provider changed.
-brain.on('warning', (w) => console.warn(w.message));
-// → "Embedding provider changed (LocalEmbedding/384 → OpenAIEmbedding/1536). Run brain.reembed()"
+// force: true bypasses the dimension mismatch check for recovery
+await brain.initialize({ force: true });
 
 const result = await brain.reembed({
   onProgress: (table, current, total) => {

package/dist/{base-9vfWRHCV.d.ts → base-4SUgeRWT.d.ts}

@@ -231,7 +231,7 @@ interface PatternResult {
 interface DocumentResult {
     type: 'document';
     score: number;
-    filePath?: string;
+    filePath: string;
     content: string;
     context?: string;
     metadata: DocumentResultMetadata;
@@ -245,6 +245,29 @@ interface CollectionResult {
     metadata: Record<string, any>;
 }
 type SearchResult = CodeResult | CommitResult | PatternResult | DocumentResult | CollectionResult;
+/** Narrow a SearchResult to CodeResult. */
+declare function isCodeResult(r: SearchResult): r is CodeResult;
+/** Narrow a SearchResult to CommitResult. */
+declare function isCommitResult(r: SearchResult): r is CommitResult;
+/** Narrow a SearchResult to DocumentResult. */
+declare function isDocumentResult(r: SearchResult): r is DocumentResult;
+/** Narrow a SearchResult to PatternResult. */
+declare function isPatternResult(r: SearchResult): r is PatternResult;
+/** Narrow a SearchResult to CollectionResult. */
+declare function isCollectionResult(r: SearchResult): r is CollectionResult;
+type MatchHandlers<T> = {
+    code?: (r: CodeResult) => T;
+    commit?: (r: CommitResult) => T;
+    pattern?: (r: PatternResult) => T;
+    document?: (r: DocumentResult) => T;
+    collection?: (r: CollectionResult) => T;
+    _?: (r: SearchResult) => T;
+};
+/**
+ * Pattern-match on SearchResult type. Calls the matching handler
+ * or the `_` fallback. Returns undefined if no handler matches.
+ */
+declare function matchResult<T>(result: SearchResult, handlers: MatchHandlers<T>): T | undefined;
 interface ContextOptions {
     /** Max code chunks to include. Default: 6 */
     codeResults?: number;
@@ -571,4 +594,4 @@ interface CollectionPlugin extends Indexer {
     listContexts?(): any[];
 }
 
-export { type SearchResultType as A, type BrainBankConfig as B, Collection as C, type DocumentCollection as D, type EmbeddingProvider as E, type SearchablePlugin as F, type GitCommitRecord as G, HNSWIndex as H, type Indexer as I, type LearningPattern as L, type ProgressCallback as P, type ResolvedConfig as R, type StageProgressCallback as S, type VectorIndex as V, type WatchablePlugin as W, type IndexResult as a, type SearchResult as b, type ContextOptions as c, type CoEditSuggestion as d, type IndexStats as e, type SearchHit as f, type CodeChunk as g, Database as h, type Reranker as i, type CodeResult as j, type CodeResultMetadata as k, type CollectionAddOptions as l, type CollectionItem as m, type CollectionPlugin as n, type CollectionResult as o, type CollectionSearchOptions as p, type CommitResult as q, type CommitResultMetadata as r, type DistilledStrategy as s, type DocChunk as t, type DocumentResult as u, type DocumentResultMetadata as v, type IndexablePlugin as w, type IndexerContext as x, type PatternResult as y, type PatternResultMetadata as z };
+export { type SearchResultType as A, type BrainBankConfig as B, Collection as C, type DocumentCollection as D, type EmbeddingProvider as E, type SearchablePlugin as F, type GitCommitRecord as G, HNSWIndex as H, type Indexer as I, isCodeResult as J, isCollectionResult as K, type LearningPattern as L, isCommitResult as M, isDocumentResult as N, isPatternResult as O, type ProgressCallback as P, matchResult as Q, type ResolvedConfig as R, type StageProgressCallback as S, type VectorIndex as V, type WatchablePlugin as W, type IndexResult as a, type SearchResult as b, type ContextOptions as c, type CoEditSuggestion as d, type IndexStats as e, type SearchHit as f, type CodeChunk as g, Database as h, type Reranker as i, type CodeResult as j, type CodeResultMetadata as k, type CollectionAddOptions as l, type CollectionItem as m, type CollectionPlugin as n, type CollectionResult as o, type CollectionSearchOptions as p, type CommitResult as q, type CommitResultMetadata as r, type DistilledStrategy as s, type DocChunk as t, type DocumentResult as u, type DocumentResultMetadata as v, type IndexablePlugin as w, type IndexerContext as x, type PatternResult as y, type PatternResultMetadata as z };