brainbank 0.2.2 → 0.3.0

package/dist/index.d.ts

@@ -1,9 +1,11 @@
 import { EventEmitter } from 'node:events';
-import { P as ProgressCallback, B as BrainBankConfig, I as Indexer, C as Collection, S as StageProgressCallback, a as IndexResult, D as DocumentCollection, b as SearchResult, c as ContextOptions, d as CoEditSuggestion, e as IndexStats, R as ResolvedConfig, E as EmbeddingProvider, V as VectorIndex, f as SearchHit, g as CodeChunk, h as Database, H as HNSWIndex, L as LearningPattern, i as Reranker } from './base-9vfWRHCV.js';
-export { j as CodeResult, k as CodeResultMetadata, l as CollectionAddOptions, m as CollectionItem, n as CollectionPlugin, o as CollectionResult, p as CollectionSearchOptions, q as CommitResult, r as CommitResultMetadata, s as DistilledStrategy, t as DocChunk, u as DocumentResult, v as DocumentResultMetadata, G as GitCommitRecord, w as IndexablePlugin, x as IndexerContext, y as PatternResult, z as PatternResultMetadata, A as SearchResultType, F as SearchablePlugin, W as WatchablePlugin } from './base-9vfWRHCV.js';
+import { P as ProgressCallback, B as BrainBankConfig, I as Indexer, C as Collection, S as StageProgressCallback, a as IndexResult, D as DocumentCollection, b as SearchResult, c as ContextOptions, d as CoEditSuggestion, e as IndexStats, R as ResolvedConfig, E as EmbeddingProvider, V as VectorIndex, f as SearchHit, g as CodeChunk, h as Database, H as HNSWIndex, L as LearningPattern, i as Reranker } from './base-4SUgeRWT.js';
+export { j as CodeResult, k as CodeResultMetadata, l as CollectionAddOptions, m as CollectionItem, n as CollectionPlugin, o as CollectionResult, p as CollectionSearchOptions, q as CommitResult, r as CommitResultMetadata, s as DistilledStrategy, t as DocChunk, u as DocumentResult, v as DocumentResultMetadata, G as GitCommitRecord, w as IndexablePlugin, x as IndexerContext, y as PatternResult, z as PatternResultMetadata, A as SearchResultType, F as SearchablePlugin, W as WatchablePlugin, J as isCodeResult, K as isCollectionResult, M as isCommitResult, N as isDocumentResult, O as isPatternResult, Q as matchResult } from './base-4SUgeRWT.js';
 export { code } from './code.js';
 export { git } from './git.js';
 export { docs } from './docs.js';
+export { memory } from './memory.js';
+export { notes } from './notes.js';
 import 'better-sqlite3';
 
 /**
@@ -115,7 +117,9 @@ declare class BrainBank extends EventEmitter {
      * Only initializes registered modules.
      * Automatically called by index/search methods if not yet initialized.
      */
-    initialize(): Promise<void>;
+    initialize(options?: {
+        force?: boolean;
+    }): Promise<void>;
     private _runInitialize;
     /**
      * Get or create a dynamic collection.
@@ -217,11 +221,11 @@ declare class BrainBank extends EventEmitter {
         codeK?: number;
         gitK?: number;
         patternK?: number;
-    }): SearchResult[];
+    }): Promise<SearchResult[]>;
     /** Rebuild FTS5 indices. */
     rebuildFTS(): void;
     /** Get git history for a specific file. */
-    fileHistory(filePath: string, limit?: number): Promise<any[]>;
+    fileHistory(filePath: string, limit?: number): Promise<Record<string, unknown>[]>;
     /** Get co-edit suggestions for a file. */
     coEdits(filePath: string, limit?: number): CoEditSuggestion[];
     /** Get statistics for all loaded modules. */
@@ -243,6 +247,7 @@ declare class BrainBank extends EventEmitter {
     /** The resolved configuration. */
     get config(): Readonly<ResolvedConfig>;
     private _requireInit;
+    private _requireDocs;
 }
 
 /**
@@ -275,8 +280,8 @@ declare class LocalEmbedding implements EmbeddingProvider {
      */
     embed(text: string): Promise<Float32Array>;
     /**
-     * Embed multiple texts.
-     * Processes sequentially to avoid OOM on large batches.
+     * Embed multiple texts using real batch processing.
+     * Chunks into groups of BATCH_SIZE to balance throughput vs memory.
      */
     embedBatch(texts: string[]): Promise<Float32Array[]>;
     close(): Promise<void>;
@@ -303,6 +308,8 @@ interface OpenAIEmbeddingOptions {
     dims?: number;
     /** Base URL override (for Azure, proxies, etc.) */
     baseUrl?: string;
+    /** Request timeout in ms. Default: 30000 */
+    timeout?: number;
 }
 declare class OpenAIEmbedding implements EmbeddingProvider {
     readonly dims: number;
@@ -310,12 +317,15 @@ declare class OpenAIEmbedding implements EmbeddingProvider {
     private _model;
     private _baseUrl;
     private _requestDims;
+    private _timeout;
     constructor(options?: OpenAIEmbeddingOptions);
     embed(text: string): Promise<Float32Array>;
     embedBatch(texts: string[]): Promise<Float32Array[]>;
     close(): Promise<void>;
     private _isTokenLimitError;
     private _request;
+    /** Handle API errors with token-limit retry logic. */
+    private _handleApiError;
 }
 
 /**
@@ -440,11 +450,12 @@ declare class CodeIndexer {
     private _repoPath;
     private _maxFileSize;
     constructor(repoPath: string, deps: CodeIndexerDeps, maxFileSize?: number);
-    /**
-     * Index all supported files in the repository.
-     * Skips unchanged files (same content hash).
-     */
+    /** Index all supported files. Skips unchanged files (same content hash). */
     index(options?: CodeIndexOptions): Promise<IndexResult>;
+    /** Remove old chunks and their HNSW vectors for a file. */
+    private _removeOldChunks;
+    /** Chunk, embed, and store a single file. Returns chunk count. */
+    private _indexFile;
     private _walkRepo;
     private _hash;
 }
@@ -477,11 +488,24 @@ declare class GitIndexer {
      * Only processes commits not already in the database.
      */
     index(options?: GitIndexOptions): Promise<IndexResult>;
-    /**
-     * Compute which files tend to be edited together.
-     * Stored in the co_edits table for later suggestion.
-     */
+    /** Initialize simple-git. Returns null if git is unavailable. */
+    private _initGit;
+    /** Prepare all SQL statements (hoisted outside loops). */
+    private _prepareStatements;
+    /** Phase 1: Collect commit data from git (async git calls). */
+    private _collectCommits;
+    /** Extract diff, stat, and text from a single commit. */
+    private _parseCommit;
+    /** Phase 3: Insert commits + vectors in a single transaction. */
+    private _insertCommits;
+    /** Phase 4: Update HNSW index and compute co-edits. */
+    private _updateHnsw;
+    /** Compute which files tend to be edited together. */
     private _computeCoEdits;
+    /** Query commit_files in chunks to stay under SQLite's 999-variable limit. */
+    private _queryCommitFiles;
+    /** Group file paths by commit ID. */
+    private _groupFilesByCommit;
 }
 
 /**
@@ -512,25 +536,28 @@ declare class DocsIndexer {
         skipped: number;
         chunks: number;
     }>;
-    /**
-     * Remove all indexed data for a collection.
-     */
+    /** Walk directory tree and collect matching files. */
+    private _walkFiles;
+    /** Check if a file matches any ignore patterns. */
+    private _isIgnoredFile;
+    /** Check if all chunks for a file match the current hash and have vectors. */
+    private _isUnchanged;
+    /** Remove old chunks and their HNSW vectors for a file. */
+    private _removeOldChunks;
+    /** Index a single file: chunk, embed, store in DB + HNSW. */
+    private _indexFile;
+    /** Remove all indexed data for a collection. */
     removeCollection(collection: string): void;
-    /**
-     * Split document into chunks at natural markdown boundaries.
-     * Uses heading-aware scoring like qmd.
-     */
+    /** Split document into chunks at natural markdown boundaries. */
     private _smartChunk;
-    /**
-     * Find all potential break points in the document with scores.
-     */
+    /** Handle the last chunk: merge if too small, otherwise push. */
+    private _pushLastChunk;
+    /** Find the best break position within the target window. */
+    private _findBestBreak;
+    /** Find all potential break points in the document with scores. */
     private _findBreakPoints;
-    /**
-     * Extract document title from first heading or filename.
-     */
+    /** Extract document title from first heading or filename. */
     private _extractTitle;
-    /** Skip well-known output/vendor directories when walking docs. */
-    private _isIgnoredDocDir;
 }
 
 /**
@@ -694,22 +721,17 @@ declare class NoteStore {
 }
 
 /**
- * BrainBank — Multi-Index Search
+ * BrainBank — Search Types
  *
- * Searches across all three indices (code, git, memory patterns)
- * and returns typed results sorted by relevance.
+ * Shared interface for all search strategies.
+ * Implement SearchStrategy to add a new search backend.
  */
 
-interface SearchConfig {
-    db: Database;
-    codeHnsw?: HNSWIndex;
-    gitHnsw?: HNSWIndex;
-    patternHnsw?: HNSWIndex;
-    codeVecs: Map<number, Float32Array>;
-    gitVecs: Map<number, Float32Array>;
-    patternVecs: Map<number, Float32Array>;
-    embedding: EmbeddingProvider;
-    reranker?: Reranker;
+/** Any search implementation follows this shape. */
+interface SearchStrategy {
+    search(query: string, options?: SearchOptions): Promise<SearchResult[]>;
+    /** Rebuild internal indices (e.g. FTS5). Optional. */
+    rebuild?(): void;
 }
 interface SearchOptions {
     /** Max code results. Default: 6 */
@@ -725,23 +747,6 @@ interface SearchOptions {
     /** MMR lambda. Default: 0.7 */
     mmrLambda?: number;
 }
-declare class MultiIndexSearch {
-    private _config;
-    constructor(config: SearchConfig);
-    /**
-     * Search across all indices.
-     * Returns combined results sorted by score.
-     */
-    search(query: string, options?: SearchOptions): Promise<SearchResult[]>;
-    /**
-     * Re-rank results using position-aware blending.
-     *
-     * Top 1-3:  75% retrieval / 25% reranker (preserves exact matches)
-     * Top 4-10: 60% retrieval / 40% reranker
-     * Top 11+:  40% retrieval / 60% reranker (trust reranker more)
-     */
-    private _rerank;
-}
 
 /**
  * BrainBank — Co-Edit Analyzer
@@ -771,43 +776,77 @@ declare class CoEditAnalyzer {
 declare class ContextBuilder {
     private _search;
     private _coEdits?;
-    constructor(_search: MultiIndexSearch, _coEdits?: CoEditAnalyzer | undefined);
-    /**
-     * Build a full context block for a task.
-     * Returns clean markdown ready for system prompt injection.
-     */
+    constructor(_search: SearchStrategy, _coEdits?: CoEditAnalyzer | undefined);
+    /** Build a full context block for a task. Returns markdown for system prompt. */
     build(task: string, options?: ContextOptions): Promise<string>;
+    /** Format code search results grouped by file. */
+    private _formatCodeResults;
+    /** Format git commit results with diff snippets. */
+    private _formatGitResults;
+    /** Format co-edit suggestions for affected files. */
+    private _formatCoEdits;
+    /** Format memory pattern results. */
+    private _formatPatternResults;
+}
+
+/**
+ * BrainBank — Vector Search Strategy
+ *
+ * Searches across code, git, and memory pattern HNSW indices.
+ * Returns typed results sorted by relevance.
+ */
+
+interface VectorSearchConfig {
+    db: Database;
+    codeHnsw?: HNSWIndex;
+    gitHnsw?: HNSWIndex;
+    patternHnsw?: HNSWIndex;
+    codeVecs: Map<number, Float32Array>;
+    gitVecs: Map<number, Float32Array>;
+    patternVecs: Map<number, Float32Array>;
+    embedding: EmbeddingProvider;
+    reranker?: Reranker;
+}
+declare class VectorSearch implements SearchStrategy {
+    private _config;
+    constructor(config: VectorSearchConfig);
+    /** Search across all indices. Returns combined results sorted by score. */
+    search(query: string, options?: SearchOptions): Promise<SearchResult[]>;
+    /** Vector search across code chunks. */
+    private _searchCode;
+    /** Vector search across git commits. */
+    private _searchGit;
+    /** Vector search across memory patterns. */
+    private _searchPatterns;
 }
 
 /**
- * BrainBank — BM25 Full-Text Search
+ * BrainBank — Keyword Search Strategy
  *
  * Keyword search via SQLite FTS5 with BM25 ranking.
  * Searches across code chunks, git commits, and memory patterns.
  * Uses Porter stemming + unicode61 tokenizer.
  */
 
-interface BM25Options {
-    /** Max code results. Default: 8 */
-    codeK?: number;
-    /** Max git results. Default: 5 */
-    gitK?: number;
-    /** Max pattern results. Default: 4 */
-    patternK?: number;
-}
-declare class BM25Search {
+declare class KeywordSearch implements SearchStrategy {
     private _db;
     constructor(_db: Database);
     /**
      * Full-text keyword search across all FTS5 indices.
      * Uses BM25 scoring — lower scores = better matches.
-     * Query syntax: simple words, OR, NOT, "exact phrases", prefix*
-     */
-    search(query: string, options?: BM25Options): SearchResult[];
-    /**
-     * Rebuild the FTS index from scratch.
-     * Call this after bulk imports or if FTS gets out of sync.
      */
+    search(query: string, options?: SearchOptions): Promise<SearchResult[]>;
+    /** FTS5 search across code chunks + file-path fallback. */
+    private _searchCode;
+    /** File-path fallback: match filenames via LIKE. */
+    private _searchCodeByPath;
+    /** FTS5 search across git commits. */
+    private _searchGit;
+    /** FTS5 search across memory patterns. */
+    private _searchPatterns;
+    /** Map a code_chunks row to a CodeResult. */
+    private _toCodeResult;
+    /** Rebuild the FTS index from scratch. */
     rebuild(): void;
 }
 
@@ -833,4 +872,4 @@ declare class BM25Search {
  */
 declare function reciprocalRankFusion(resultSets: SearchResult[][], k?: number, maxResults?: number): SearchResult[];
 
-export { BM25Search, BrainBank, BrainBankConfig, CoEditAnalyzer, CoEditSuggestion, CodeChunk, CodeChunker, CodeIndexer, Collection, Consolidator, ContextBuilder, ContextOptions, DEFAULTS, DocsIndexer, DocumentCollection, EmbeddingProvider, GitIndexer, HNSWIndex, IGNORE_DIRS, IndexResult, IndexStats, Indexer, LearningPattern, LocalEmbedding, MultiIndexSearch, type NoteDigest, NoteStore, OpenAIEmbedding, type OpenAIEmbeddingOptions, PatternStore, ProgressCallback, type RecallOptions, type ReembedOptions, type ReembedResult, Reranker, ResolvedConfig, SUPPORTED_EXTENSIONS, SearchHit, SearchResult, StageProgressCallback, type StoredNote, VectorIndex, type WatchOptions, type Watcher, cosineSimilarity, getLanguage, isSupported, normalize, reciprocalRankFusion, resolveConfig, searchMMR };
+export { KeywordSearch as BM25Search, BrainBank, BrainBankConfig, CoEditAnalyzer, CoEditSuggestion, CodeChunk, CodeChunker, CodeIndexer, Collection, Consolidator, ContextBuilder, ContextOptions, DEFAULTS, DocsIndexer, DocumentCollection, EmbeddingProvider, GitIndexer, HNSWIndex, IGNORE_DIRS, IndexResult, IndexStats, Indexer, KeywordSearch, LearningPattern, LocalEmbedding, VectorSearch as MultiIndexSearch, type NoteDigest, NoteStore, OpenAIEmbedding, type OpenAIEmbeddingOptions, PatternStore, ProgressCallback, type RecallOptions, type ReembedOptions, type ReembedResult, Reranker, ResolvedConfig, SUPPORTED_EXTENSIONS, SearchHit, type SearchOptions, SearchResult, type SearchStrategy, StageProgressCallback, type StoredNote, VectorIndex, VectorSearch, type WatchOptions, type Watcher, cosineSimilarity, getLanguage, isSupported, normalize, reciprocalRankFusion, resolveConfig, searchMMR };

package/dist/index.js

@@ -1,22 +1,24 @@
 import {
-  NoteStore
-} from "./chunk-OPQ3ZIPV.js";
+  NoteStore,
+  notes
+} from "./chunk-5VUYPNH3.js";
 import {
   Consolidator,
-  PatternStore
-} from "./chunk-X6645UVR.js";
+  PatternStore,
+  memory
+} from "./chunk-FINIFKAY.js";
 import {
-  BM25Search,
   BrainBank,
   Collection,
   ContextBuilder,
   DEFAULTS,
   HNSWIndex,
+  KeywordSearch,
   LocalEmbedding,
-  MultiIndexSearch,
+  VectorSearch,
   resolveConfig,
   searchMMR
-} from "./chunk-ZJ5LLMGM.js";
+} from "./chunk-2BEWWQL2.js";
 import {
   CodeChunker,
   CodeIndexer,
@@ -25,29 +27,68 @@ import {
   code,
   getLanguage,
   isSupported
-} from "./chunk-4DM3XWO6.js";
+} from "./chunk-MGIFEPYZ.js";
 import {
   CoEditAnalyzer,
   GitIndexer,
   git
-} from "./chunk-7JCEW7LT.js";
+} from "./chunk-FI7GWG4W.js";
 import {
   DocsIndexer,
   docs
-} from "./chunk-T2VXF5S5.js";
+} from "./chunk-Y3JKI6QN.js";
 import {
   reciprocalRankFusion
-} from "./chunk-FEAMUZGJ.js";
+} from "./chunk-E6WQM4DN.js";
 import {
   cosineSimilarity,
   normalize
 } from "./chunk-QNHBCOKB.js";
 import {
   OpenAIEmbedding
-} from "./chunk-GUT5MSJT.js";
-import "./chunk-7QVYU63E.js";
+} from "./chunk-CCXVL56V.js";
+import {
+  __name
+} from "./chunk-7QVYU63E.js";
+
+// src/types.ts
+function isCodeResult(r) {
+  return r.type === "code";
+}
+__name(isCodeResult, "isCodeResult");
+function isCommitResult(r) {
+  return r.type === "commit";
+}
+__name(isCommitResult, "isCommitResult");
+function isDocumentResult(r) {
+  return r.type === "document";
+}
+__name(isDocumentResult, "isDocumentResult");
+function isPatternResult(r) {
+  return r.type === "pattern";
+}
+__name(isPatternResult, "isPatternResult");
+function isCollectionResult(r) {
+  return r.type === "collection";
+}
+__name(isCollectionResult, "isCollectionResult");
+function matchResult(result, handlers) {
+  switch (result.type) {
+    case "code":
+      return (handlers.code ?? handlers._)?.(result);
+    case "commit":
+      return (handlers.commit ?? handlers._)?.(result);
+    case "pattern":
+      return (handlers.pattern ?? handlers._)?.(result);
+    case "document":
+      return (handlers.document ?? handlers._)?.(result);
+    case "collection":
+      return (handlers.collection ?? handlers._)?.(result);
+  }
+}
+__name(matchResult, "matchResult");
 export {
-  BM25Search,
+  KeywordSearch as BM25Search,
   BrainBank,
   CoEditAnalyzer,
   CodeChunker,
@@ -60,19 +101,29 @@ export {
   GitIndexer,
   HNSWIndex,
   IGNORE_DIRS,
+  KeywordSearch,
   LocalEmbedding,
-  MultiIndexSearch,
+  VectorSearch as MultiIndexSearch,
   NoteStore,
   OpenAIEmbedding,
   PatternStore,
   SUPPORTED_EXTENSIONS,
+  VectorSearch,
   code,
   cosineSimilarity,
   docs,
   getLanguage,
   git,
+  isCodeResult,
+  isCollectionResult,
+  isCommitResult,
+  isDocumentResult,
+  isPatternResult,
   isSupported,
+  matchResult,
+  memory,
   normalize,
+  notes,
   reciprocalRankFusion,
   resolveConfig,
   searchMMR

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
+{"version":3,"sources":["../src/types.ts"],"sourcesContent":["/**\n * BrainBank — Type Definitions\n * \n * All interfaces and types for the semantic knowledge bank.\n */\n\n\n\n// ── Configuration ───────────────────────────────────\n\nexport interface BrainBankConfig {\n    /** Root path of the repository to index. Default: '.' */\n    repoPath?: string;\n    /** SQLite database path. Default: '.brainbank/brainbank.db' */\n    dbPath?: string;\n\n    /** Max git commits to index. Default: 500 */\n    gitDepth?: number;\n    /** Max file size in bytes to index. Default: 512_000 (500KB) */\n    maxFileSize?: number;\n    /** Max diff bytes per commit. Default: 8192 */\n    maxDiffBytes?: number;\n    /** HNSW M parameter (connections per node). Default: 16 */\n    hnswM?: number;\n    /** HNSW efConstruction (build-time candidates). Default: 200 */\n    hnswEfConstruction?: number;\n    /** HNSW efSearch (query-time candidates). Default: 50 */\n    hnswEfSearch?: number;\n    /** Embedding dimensions. Default: 384 */\n    embeddingDims?: number;\n    /** Max HNSW elements. Default: 2_000_000 */\n    maxElements?: number;\n    /** Custom embedding provider (default: local WASM model) */\n    embeddingProvider?: EmbeddingProvider;\n    /** Optional reranker for improved search quality */\n    reranker?: Reranker;\n}\n\nexport interface ResolvedConfig {\n    repoPath: string;\n    dbPath: string;\n    gitDepth: number;\n    maxFileSize: number;\n    maxDiffBytes: number;\n    hnswM: number;\n    hnswEfConstruction: number;\n    hnswEfSearch: number;\n    embeddingDims: number;\n    maxElements: number;\n    embeddingProvider?: EmbeddingProvider;\n    reranker?: Reranker;\n}\n\n// ── Embedding Provider ──────────────────────────────\n\nexport interface EmbeddingProvider {\n    /** Vector dimensions produced by this provider. */\n    readonly dims: number;\n    /** Embed a single text string. */\n    embed(text: string): Promise<Float32Array>;\n    /** Embed multiple texts (batch). */\n    embedBatch(texts: string[]): Promise<Float32Array[]>;\n    /** Release resources. */\n    close(): Promise<void>;\n}\n\n// ── Reranker ────────────────────────────────────────\n\nexport interface Reranker {\n    /**\n     * Score each document's relevance to the query.\n     * @param query - The search query\n     * @param documents - Document contents to rank\n     * @returns Relevance scores (0.0 - 1.0) in same order as documents\n     */\n    rank(query: string, documents: string[]): Promise<number[]>;\n    /** Release resources (e.g. unload model). */\n    close?(): Promise<void>;\n}\n\n// ── Vector Index ────────────────────────────────────\n\nexport interface SearchHit {\n    id: number;\n    score: number;\n}\n\nexport interface VectorIndex {\n    /** Initialize the index. Must be called before add/search. */\n    init(): Promise<this>;\n    /** Add a vector with an integer ID. Idempotent: duplicate IDs are skipped. */\n    add(vector: Float32Array, id: number): void;\n    /** Mark a vector as deleted so it no longer appears in searches. */\n    remove(id: number): void;\n    /** Search for k nearest neighbors. */\n    search(query: Float32Array, k: number): SearchHit[];\n    /** Clear all vectors and reset to empty state. */\n    reinit(): void;\n    /** Number of vectors in the index. */\n    readonly size: number;\n}\n\n// ── Code Chunking ───────────────────────────────────\n\nexport interface CodeChunk {\n    /** Auto-incremented DB id (set after insert) */\n    id?: number;\n    /** Relative file path from repo root */\n    filePath: string;\n    /** Chunk type: 'file' | 'function' | 'class' | 'block' */\n    chunkType: string;\n    /** Function/class name (if detected) */\n    name?: string;\n    /** Start line (1-indexed) */\n    startLine: number;\n    /** End line (1-indexed, inclusive) */\n    endLine: number;\n    /** Raw content of the chunk */\n    content: string;\n    /** Language identifier */\n    language: string;\n}\n\n// ── Git ─────────────────────────────────────────────\n\nexport interface GitCommitRecord {\n    id?: number;\n    hash: string;\n    shortHash: string;\n    message: string;\n    author: string;\n    date: string;\n    timestamp: number;\n    filesChanged: string[];\n    diff?: string;\n    additions: number;\n    deletions: number;\n    isMerge: boolean;\n}\n\n// ── Agent Learning ─────────────────────────────────────────\n\nexport interface LearningPattern {\n    id?: number;\n    /** Category (e.g. 'api', 'refactor', 'debug') */\n    taskType: string;\n    /** What was the task */\n    task: string;\n    /** How it was approached */\n    approach: string;\n    /** What happened */\n    outcome?: string;\n    /** 0.0 – 1.0 */\n    successRate: number;\n    /** Lessons learned */\n    critique?: string;\n    /** Tokens consumed (optional tracking) */\n    tokensUsed?: number;\n    /** Latency in ms (optional tracking) */\n    latencyMs?: number;\n}\n\nexport interface DistilledStrategy {\n    taskType: string;\n    strategy: string;\n    confidence: number;\n    updatedAt: number;\n}\n\n// ── Search Results ──────────────────────────────────\n\nexport type SearchResultType = 'code' | 'commit' | 'pattern' | 'document' | 'collection';\n\n// Typed metadata per result type\n\nexport interface CodeResultMetadata {\n    chunkType: string;\n    name?: string;\n    startLine: number;\n    endLine: number;\n    language: string;\n    searchType?: string;\n}\n\nexport interface CommitResultMetadata {\n    hash: string;\n    shortHash: string;\n    author: string;\n    date: string;\n    files: string[];\n    additions?: number;\n    deletions?: number;\n    diff?: string;\n    searchType?: string;\n}\n\nexport interface PatternResultMetadata {\n    taskType: string;\n    task: string;\n    outcome?: string;\n    successRate: number;\n    critique?: string;\n    searchType?: string;\n}\n\nexport interface DocumentResultMetadata {\n    collection?: string;\n    title?: string;\n    seq?: number;\n    path?: string;\n    searchType?: string;\n}\n\n// Discriminated union\n\nexport interface CodeResult {\n    type: 'code';\n    score: number;\n    filePath: string;\n    content: string;\n    context?: string;\n    metadata: CodeResultMetadata;\n}\n\nexport interface CommitResult {\n    type: 'commit';\n    score: number;\n    filePath?: string;\n    content: string;\n    context?: string;\n    metadata: CommitResultMetadata;\n}\n\nexport interface PatternResult {\n    type: 'pattern';\n    score: number;\n    filePath?: string;\n    content: string;\n    context?: string;\n    metadata: PatternResultMetadata;\n}\n\nexport interface DocumentResult {\n    type: 'document';\n    score: number;\n    filePath: string;\n    content: string;\n    context?: string;\n    metadata: DocumentResultMetadata;\n}\n\nexport interface CollectionResult {\n    type: 'collection';\n    score: number;\n    filePath?: string;\n    content: string;\n    context?: string;\n    metadata: Record<string, any>;\n}\n\nexport type SearchResult = CodeResult | CommitResult | PatternResult | DocumentResult | CollectionResult;\n\n// ── Type Guards ──────────────────────────────────────\n\n/** Narrow a SearchResult to CodeResult. */\nexport function isCodeResult(r: SearchResult): r is CodeResult {\n    return r.type === 'code';\n}\n/** Narrow a SearchResult to CommitResult. */\nexport function isCommitResult(r: SearchResult): r is CommitResult {\n    return r.type === 'commit';\n}\n/** Narrow a SearchResult to DocumentResult. */\nexport function isDocumentResult(r: SearchResult): r is DocumentResult {\n    return r.type === 'document';\n}\n/** Narrow a SearchResult to PatternResult. */\nexport function isPatternResult(r: SearchResult): r is PatternResult {\n    return r.type === 'pattern';\n}\n/** Narrow a SearchResult to CollectionResult. */\nexport function isCollectionResult(r: SearchResult): r is CollectionResult {\n    return r.type === 'collection';\n}\n\n// ── Match Helper ─────────────────────────────────────\n\ntype MatchHandlers<T> = {\n    code?:       (r: CodeResult)       => T;\n    commit?:     (r: CommitResult)     => T;\n    pattern?:    (r: PatternResult)    => T;\n    document?:   (r: DocumentResult)   => T;\n    collection?: (r: CollectionResult) => T;\n    _?:          (r: SearchResult)     => T;\n};\n\n/**\n * Pattern-match on SearchResult type. Calls the matching handler\n * or the `_` fallback. Returns undefined if no handler matches.\n */\nexport function matchResult<T>(\n    result: SearchResult,\n    handlers: MatchHandlers<T>,\n): T | undefined {\n    switch (result.type) {\n        case 'code':       return (handlers.code       ?? handlers._)?.(result);\n        case 'commit':     return (handlers.commit     ?? handlers._)?.(result);\n        case 'pattern':    return (handlers.pattern    ?? handlers._)?.(result);\n        case 'document':   return (handlers.document   ?? handlers._)?.(result);\n        case 'collection': return (handlers.collection ?? handlers._)?.(result);\n    }\n}\n\n// ── Context Builder ─────────────────────────────────\n\nexport interface ContextOptions {\n    /** Max code chunks to include. Default: 6 */\n    codeResults?: number;\n    /** Max git commits to include. Default: 5 */\n    gitResults?: number;\n    /** Max memory patterns to include. Default: 4 */\n    patternResults?: number;\n    /** Files the agent is about to modify (improves co-edit suggestions) */\n    affectedFiles?: string[];\n    /** Minimum similarity score threshold. Default: 0.25 */\n    minScore?: number;\n    /** Use MMR for diversity. Default: true */\n    useMMR?: boolean;\n    /** MMR lambda (0 = diversity, 1 = relevance). Default: 0.7 */\n    mmrLambda?: number;\n}\n\n// ── Document Collections ────────────────────────────\n\nexport interface DocumentCollection {\n    /** Collection name (e.g. 'notes', 'docs') */\n    name: string;\n    /** Directory path to index */\n    path: string;\n    /** Glob pattern for files (default: all markdown) */\n    pattern?: string;\n    /** Glob patterns to ignore */\n    ignore?: string[];\n    /** Context description for this collection */\n    context?: string;\n}\n\nexport interface DocChunk {\n    id?: number;\n    /** Collection name */\n    collection: string;\n    /** Relative file path within the collection */\n    filePath: string;\n    /** Document title (first heading or filename) */\n    title: string;\n    /** Chunk content */\n    content: string;\n    /** Chunk sequence within the document (0, 1, 2...) */\n    seq: number;\n    /** Character position in original document */\n    pos: number;\n    /** Content hash for incremental updates */\n    contentHash: string;\n}\n\n// ── Stats ───────────────────────────────────────────\n\nexport interface IndexStats {\n    code?: {\n        files: number;\n        chunks: number;\n        hnswSize: number;\n    };\n    git?: {\n        commits: number;\n        filesTracked: number;\n        coEdits: number;\n        hnswSize: number;\n    };\n    memory?: {\n        patterns: number;\n        avgSuccess: number;\n        hnswSize: number;\n    };\n    documents?: {\n        collections: number;\n        documents: number;\n        chunks: number;\n        hnswSize: number;\n    };\n    notes?: {\n        total: number;\n        short: number;\n        long: number;\n    };\n}\n\n// ── Index Progress ──────────────────────────────────\n\n/** File-level progress (used by indexers). */\nexport type ProgressCallback = (file: string, current: number, total: number) => void;\n\n/** Stage-level progress (used by BrainBank.index() orchestrator). */\nexport type StageProgressCallback = (stage: string, message: string) => void;\n\nexport interface IndexResult {\n    indexed: number;\n    skipped: number;\n    chunks?: number;\n}\n\n// ── Co-Edits ────────────────────────────────────────\n\nexport interface CoEditSuggestion {\n    file: string;\n    count: number;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyQO,SAAS,aAAa,GAAkC;AAC3D,SAAO,EAAE,SAAS;AACtB;AAFgB;AAIT,SAAS,eAAe,GAAoC;AAC/D,SAAO,EAAE,SAAS;AACtB;AAFgB;AAIT,SAAS,iBAAiB,GAAsC;AACnE,SAAO,EAAE,SAAS;AACtB;AAFgB;AAIT,SAAS,gBAAgB,GAAqC;AACjE,SAAO,EAAE,SAAS;AACtB;AAFgB;AAIT,SAAS,mBAAmB,GAAwC;AACvE,SAAO,EAAE,SAAS;AACtB;AAFgB;AAmBT,SAAS,YACZ,QACA,UACa;AACb,UAAQ,OAAO,MAAM;AAAA,IACjB,KAAK;AAAc,cAAQ,SAAS,QAAc,SAAS,KAAK,MAAM;AAAA,IACtE,KAAK;AAAc,cAAQ,SAAS,UAAc,SAAS,KAAK,MAAM;AAAA,IACtE,KAAK;AAAc,cAAQ,SAAS,WAAc,SAAS,KAAK,MAAM;AAAA,IACtE,KAAK;AAAc,cAAQ,SAAS,YAAc,SAAS,KAAK,MAAM;AAAA,IACtE,KAAK;AAAc,cAAQ,SAAS,cAAc,SAAS,KAAK,MAAM;AAAA,EAC1E;AACJ;AAXgB;","names":[]}

package/dist/memory.d.ts

@@ -1,4 +1,4 @@
-import { I as Indexer } from './base-9vfWRHCV.js';
+import { I as Indexer } from './base-4SUgeRWT.js';
 import 'better-sqlite3';
 
 /**

package/dist/memory.js

@@ -1,142 +1,8 @@
 import {
-  Consolidator,
-  PatternStore
-} from "./chunk-X6645UVR.js";
+  memory
+} from "./chunk-FINIFKAY.js";
 import "./chunk-QNHBCOKB.js";
-import {
-  __name
-} from "./chunk-7QVYU63E.js";
-
-// src/memory/distiller.ts
-var StrategyDistiller = class {
-  constructor(_db) {
-    this._db = _db;
-  }
-  static {
-    __name(this, "StrategyDistiller");
-  }
-  /**
-   * Distill top patterns for a task type into a strategy.
-   * Updates the distilled_strategies table.
-   */
-  distill(taskType, topK = 10) {
-    const patterns = this._db.prepare(`
-            SELECT task, approach, outcome, critique, success_rate
-            FROM memory_patterns
-            WHERE task_type = ? AND success_rate >= 0.7
-            ORDER BY success_rate DESC, created_at DESC
-            LIMIT ?
-        `).all(taskType, topK);
-    if (patterns.length === 0) return null;
-    const lines = [];
-    const avgSuccess = patterns.reduce((sum, p) => sum + p.success_rate, 0) / patterns.length;
-    lines.push(`Strategy for "${taskType}" (${patterns.length} patterns, avg success ${Math.round(avgSuccess * 100)}%):`);
-    lines.push("");
-    for (const p of patterns) {
-      lines.push(`\u2022 ${p.approach} (${Math.round(p.success_rate * 100)}%)`);
-      if (p.critique) lines.push(`  \u2514 ${p.critique}`);
-    }
-    const strategy = lines.join("\n");
-    const confidence = avgSuccess;
-    const now = Math.floor(Date.now() / 1e3);
-    this._db.prepare(`
-            INSERT INTO distilled_strategies (task_type, strategy, confidence, updated_at)
-            VALUES (?, ?, ?, ?)
-            ON CONFLICT(task_type) DO UPDATE SET
-                strategy = excluded.strategy,
-                confidence = excluded.confidence,
-                updated_at = excluded.updated_at
-        `).run(taskType, strategy, confidence, now);
-    return { taskType, strategy, confidence, updatedAt: now };
-  }
-  /**
-   * Get a distilled strategy for a task type.
-   */
-  get(taskType) {
-    const row = this._db.prepare(
-      "SELECT * FROM distilled_strategies WHERE task_type = ?"
-    ).get(taskType);
-    if (!row) return null;
-    return {
-      taskType: row.task_type,
-      strategy: row.strategy,
-      confidence: row.confidence,
-      updatedAt: row.updated_at
-    };
-  }
-  /**
-   * List all distilled strategies.
-   */
-  list() {
-    const rows = this._db.prepare(
-      "SELECT * FROM distilled_strategies ORDER BY confidence DESC"
-    ).all();
-    return rows.map((r) => ({
-      taskType: r.task_type,
-      strategy: r.strategy,
-      confidence: r.confidence,
-      updatedAt: r.updated_at
-    }));
-  }
-};
-
-// src/indexers/memory/memory-plugin.ts
-var MemoryPlugin = class {
-  static {
-    __name(this, "MemoryPlugin");
-  }
-  name = "memory";
-  hnsw;
-  patternStore;
-  consolidator;
-  distiller;
-  vecCache = /* @__PURE__ */ new Map();
-  _db;
-  async initialize(ctx) {
-    this._db = ctx.db;
-    this.hnsw = await ctx.createHnsw(1e5);
-    ctx.loadVectors("memory_vectors", "pattern_id", this.hnsw, this.vecCache);
-    this.patternStore = new PatternStore({
-      db: ctx.db,
-      hnsw: this.hnsw,
-      vectorCache: this.vecCache,
-      embedding: ctx.embedding
-    });
-    this.consolidator = new Consolidator(ctx.db, this.vecCache);
-    this.distiller = new StrategyDistiller(ctx.db);
-  }
-  /** Store a learned pattern. */
-  async learn(pattern) {
-    const id = await this.patternStore.learn(pattern);
-    if (this.patternStore.count > 0 && this.patternStore.count % 50 === 0) {
-      this.consolidator.consolidate();
-    }
-    return id;
-  }
-  /** Search for similar patterns. */
-  async search(query, k = 4) {
-    return this.patternStore.search(query, k);
-  }
-  /** Consolidate: prune old failures + deduplicate. */
-  consolidate() {
-    return this.consolidator.consolidate();
-  }
-  /** Distill patterns into a strategy. */
-  distill(taskType) {
-    return this.distiller.distill(taskType);
-  }
-  stats() {
-    return {
-      patterns: this.patternStore.count,
-      avgSuccess: this._db.prepare("SELECT AVG(success_rate) as a FROM memory_patterns").get().a ?? 0,
-      hnswSize: this.hnsw.size
-    };
-  }
-};
-function memory() {
-  return new MemoryPlugin();
-}
-__name(memory, "memory");
+import "./chunk-7QVYU63E.js";
 export {
   memory
 };