brainbank 0.1.1 → 0.2.0

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { EventEmitter } from 'node:events';
-import { P as ProgressCallback, a as BrainBankConfig, I as Indexer, C as Collection, b as IndexResult, D as DocumentCollection, S 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, M as MemoryPattern, i as Reranker } from './types-Da_zLLOl.js';
-export { B as BrainBankModule, j as CollectionAddOptions, k as CollectionItem, l as CollectionSearchOptions, m as DistilledStrategy, n as DocChunk, G as GitCommitRecord, o as IndexerContext, p as ModuleContext, q as SearchResultType } from './types-Da_zLLOl.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-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';
 export { code } from './code.js';
 export { git } from './git.js';
 export { docs } from './docs.js';
@@ -73,31 +73,25 @@ interface ReembedOptions {
 /**
  * BrainBank — Main Orchestrator
  *
- * Composable semantic knowledge bank for AI agents.
- * Enable only the modules you need via .use():
+ * Thin facade that composes four services:
+ *   IndexerRegistry  — registration + lookup
+ *   Initializer      — two-phase startup (earlyInit / lateInit)
+ *   SearchAPI        — all search + context logic
+ *   IndexAPI         — code / git / docs indexing orchestration
  *
- *   import { BrainBank } from 'brainbank';
- *   import { code } from 'brainbank/code';
- *   import { docs } from 'brainbank/docs';
- *   import { notes } from 'brainbank/notes';
- *   import { memory } from 'brainbank/memory';
- *
- *   const brain = new BrainBank()
- *     .use(code({ repoPath: '.' }))
- *     .use(docs())
- *     .use(notes())
- *     .use(memory());
+ * All heavy logic lives in those modules; BrainBank owns state,
+ * guards (requireInit / initialize()), and public API shape.
  */
 
 declare class BrainBank extends EventEmitter {
     private _config;
     private _db;
     private _embedding;
-    private _modules;
-    private _search?;
-    private _bm25?;
-    private _contextBuilder?;
+    private _registry;
+    private _searchAPI?;
+    private _indexAPI?;
     private _initialized;
+    private _initPromise;
     private _watcher?;
     private _collections;
     private _kvHnsw?;
@@ -112,24 +106,17 @@ declare class BrainBank extends EventEmitter {
     use(indexer: Indexer): this;
     /** Get the list of registered indexer names. */
     get indexers(): string[];
-    /** @deprecated Use .indexers instead. */
-    get modules(): string[];
     /** Check if an indexer is loaded. Also matches type prefix (e.g. 'code' matches 'code:frontend'). */
     has(name: string): boolean;
     /** Get an indexer instance. Throws if not loaded. */
-    indexer<T extends Indexer = Indexer>(name: string): T;
-    /** @deprecated Use .indexer() instead. */
-    module(name: string): Indexer;
-    /** Find all indexers whose name equals or starts with the type prefix. */
-    private _findAllByType;
-    /** Find the first indexer that matches the type. */
-    private _findFirstByType;
+    indexer<T extends Indexer = Indexer>(n: string): T;
     /**
      * Initialize database, HNSW indices, and load existing vectors.
      * Only initializes registered modules.
      * Automatically called by index/search methods if not yet initialized.
      */
     initialize(): Promise<void>;
+    private _runInitialize;
     /**
      * Get or create a dynamic collection.
      * Collections are the universal data primitive — store anything, search semantically.
@@ -141,24 +128,26 @@ declare class BrainBank extends EventEmitter {
     collection(name: string): Collection;
     /** List all collection names that have data. */
     listCollectionNames(): string[];
-    /**
-     * Index code and git history in one call.
-     * Incremental — only processes changes since last run.
-     */
     index(options?: {
+        modules?: ('code' | 'git' | 'docs')[];
         gitDepth?: number;
         forceReindex?: boolean;
-        onProgress?: (stage: string, msg: string) => void;
+        onProgress?: StageProgressCallback;
     }): Promise<{
         code?: IndexResult;
         git?: IndexResult;
+        docs?: Record<string, {
+            indexed: number;
+            skipped: number;
+            chunks: number;
+        }>;
     }>;
-    /** Index only code files. */
+    /** Index only code files (all repos in multi-repo mode). */
     indexCode(options?: {
         forceReindex?: boolean;
         onProgress?: ProgressCallback;
     }): Promise<IndexResult>;
-    /** Index only git history. */
+    /** Index only git history (all repos in multi-repo mode). */
     indexGit(options?: {
         depth?: number;
         onProgress?: ProgressCallback;
@@ -203,7 +192,7 @@ declare class BrainBank extends EventEmitter {
     search(query: string, options?: {
         codeK?: number;
         gitK?: number;
-        memoryK?: number;
+        patternK?: number;
         minScore?: number;
         useMMR?: boolean;
     }): Promise<SearchResult[]>;
@@ -216,26 +205,18 @@ declare class BrainBank extends EventEmitter {
      * Best quality — catches both exact keyword matches and conceptual similarities.
      */
     hybridSearch(query: string, options?: {
-        /** @deprecated Use collections: { code: N } instead */
         codeK?: number;
-        /** @deprecated Use collections: { git: N } instead */
         gitK?: number;
-        memoryK?: number;
+        patternK?: number;
         minScore?: number;
         useMMR?: boolean;
-        /**
-         * Sources to include and max results per source.
-         * Reserved keys: "code", "git", "docs" control built-in indexers.
-         * Any other key is treated as a KV collection name.
-         * Example: { code: 8, git: 5, docs: 4, errors: 3, slack: 2 }
-         */
         collections?: Record<string, number>;
     }): Promise<SearchResult[]>;
     /** BM25 keyword search only (no embeddings needed). */
     searchBM25(query: string, options?: {
         codeK?: number;
         gitK?: number;
-        memoryK?: number;
+        patternK?: number;
     }): SearchResult[];
     /** Rebuild FTS5 indices. */
     rebuildFTS(): void;
@@ -248,23 +229,11 @@ declare class BrainBank extends EventEmitter {
     /**
      * Start watching for file changes and auto-re-index.
      * Works with built-in and custom indexers.
-     *
-     *   const watcher = brain.watch({
-     *     onIndex: (file, indexer) => console.log(`${indexer}: ${file}`),
-     *   });
-     *   // later: watcher.close();
      */
     watch(options?: WatchOptions): Watcher;
     /**
      * Re-embed all existing text with the current embedding provider.
      * Use this when switching providers (e.g. Local → OpenAI).
-     * Does NOT re-parse files, git history, or documents — only regenerates vectors.
-     *
-     * @example
-     *   const brain = new BrainBank({ embeddingProvider: new OpenAIEmbedding() });
-     *   await brain.initialize();
-     *   const result = await brain.reembed();
-     *   // → { code: 1200, git: 500, docs: 80, kv: 45, notes: 12, total: 1837 }
      */
     reembed(options?: ReembedOptions): Promise<ReembedResult>;
     /** Close database and release resources. */
@@ -273,8 +242,7 @@ declare class BrainBank extends EventEmitter {
     get isInitialized(): boolean;
     /** The resolved configuration. */
     get config(): Readonly<ResolvedConfig>;
-    /** Load vectors from SQLite into HNSW index. */
-    private _loadVectors;
+    private _requireInit;
 }
 
 /**
@@ -294,9 +262,11 @@ declare class LocalEmbedding implements EmbeddingProvider {
         model?: string;
         cacheDir?: string;
     });
+    private _pipelinePromise;
     /**
      * Lazy-load the transformer pipeline.
      * Singleton — created once and reused.
+     * Promise-deduped to prevent concurrent downloads.
      */
     private _getPipeline;
     /**
@@ -340,7 +310,6 @@ declare class OpenAIEmbedding implements EmbeddingProvider {
     private _model;
     private _baseUrl;
     private _requestDims;
-    private _retrying;
     constructor(options?: OpenAIEmbeddingOptions);
     embed(text: string): Promise<Float32Array>;
     embedBatch(texts: string[]): Promise<Float32Array[]>;
@@ -367,6 +336,14 @@ declare function cosineSimilarity(a: Float32Array, b: Float32Array): number;
  */
 declare function normalize(vec: Float32Array): Float32Array;
 
+declare const DEFAULTS: ResolvedConfig;
+/**
+ * Merge partial config with defaults.
+ * All fields become required.
+ * Relative dbPath is resolved against repoPath.
+ */
+declare function resolveConfig(partial?: BrainBankConfig): ResolvedConfig;
+
 /**
  * BrainBank — Maximum Marginal Relevance (MMR)
  *
@@ -385,11 +362,11 @@ declare function normalize(vec: Float32Array): Float32Array;
 declare function searchMMR(index: VectorIndex, query: Float32Array, vectorCache: Map<number, Float32Array>, k: number, lambda?: number): SearchHit[];
 
 /**
- * BrainBank — Code Chunker
+ * BrainBank — Tree-Sitter Code Chunker
  *
- * Language-aware code splitting into semantic blocks.
- * Detects functions, classes, and methods using regex + brace balancing.
- * Falls back to sliding window for unsupported languages.
+ * AST-aware code splitting using native tree-sitter bindings.
+ * Extracts semantic blocks (functions, classes, methods, interfaces)
+ * from the AST. Falls back to sliding window for unsupported languages.
  */
 
 interface ChunkerConfig {
@@ -404,19 +381,39 @@ declare class CodeChunker {
     private MAX;
     private MIN;
     private OVERLAP;
+    private _parser;
+    private _langCache;
     constructor(config?: ChunkerConfig);
-    /**
-     * Split file content into semantic chunks.
-     * Small files (< maxLines) become a single chunk.
-     * For JS/TS/Python: detects functions and classes.
-     * For other languages: sliding window with overlap.
-     */
-    chunk(filePath: string, content: string, language: string): CodeChunk[];
-    private _chunkJS;
-    private _chunkPython;
+    /** Lazy-init tree-sitter parser. */
+    private _ensureParser;
+    /** Load a language grammar (cached). */
+    private _loadGrammar;
+    /**
+     * Split file content into semantic chunks using tree-sitter AST.
+     * Falls back to sliding window if grammar isn't available.
+     */
+    chunk(filePath: string, content: string, language: string): Promise<CodeChunk[]>;
+    /** Walk AST and extract top-level semantic blocks. */
+    private _extractChunks;
+    /** Classify and process a single AST node. */
+    private _processNode;
+    /** Check which category a node type belongs to. */
+    private _categorize;
+    /** Process a matched declaration: class → split by methods, else → chunk directly. */
+    private _processDeclaration;
+    /** Split a large class into individual method chunks. */
+    private _splitClassIntoMethods;
+    /** Find the class body node. */
+    private _findClassBody;
+    /** Extract name from an AST node. */
+    private _extractName;
+    /** Map category to chunk type. */
+    private _toChunkType;
+    /** Add a node as a chunk, avoiding duplicates. */
+    private _addChunk;
     private _chunkGeneric;
-    private _findBlockEnd;
-    private _splitLarge;
+    /** Split a large block into overlapping sub-chunks. */
+    private _splitLargeBlock;
 }
 
 /**
@@ -493,11 +490,11 @@ declare class GitIndexer {
  * Indexes generic document collections (markdown, text, etc.)
  * with heading-aware smart chunking, inspired by qmd.
  *
- *   const indexer = new DocIndexer(db, embedding, hnsw, vecCache);
+ *   const indexer = new DocsIndexer(db, embedding, hnsw, vecCache);
  *   await indexer.indexCollection('notes', '/path/to/notes', '**\/*.md');
  */
 
-declare class DocIndexer {
+declare class DocsIndexer {
     private _db;
     private _embedding;
     private _hnsw;
@@ -532,6 +529,8 @@ declare class DocIndexer {
      * Extract document title from first heading or filename.
      */
     private _extractTitle;
+    /** Skip well-known output/vendor directories when walking docs. */
+    private _isIgnoredDocDir;
 }
 
 /**
@@ -568,18 +567,18 @@ declare class PatternStore {
      * Store a learned pattern.
      * Returns the pattern ID.
      */
-    learn(pattern: MemoryPattern): Promise<number>;
+    learn(pattern: LearningPattern): Promise<number>;
     /**
      * Search for similar successful patterns.
      * Filters by minimum success rate.
      */
-    search(query: string, k?: number, minSuccess?: number): Promise<(MemoryPattern & {
+    search(query: string, k?: number, minSuccess?: number): Promise<(LearningPattern & {
         score: number;
     })[]>;
     /**
      * Get all patterns for a specific task type.
      */
-    getByTaskType(taskType: string, limit?: number): MemoryPattern[];
+    getByTaskType(taskType: string, limit?: number): LearningPattern[];
     /** Total number of stored patterns. */
     get count(): number;
 }
@@ -695,20 +694,20 @@ declare class NoteStore {
 }
 
 /**
- * BrainBank — Unified Search
+ * BrainBank — Multi-Index Search
  *
- * Searches across all three indices (code, git, memory)
+ * Searches across all three indices (code, git, memory patterns)
  * and returns typed results sorted by relevance.
  */
 
-interface SearchDeps {
+interface SearchConfig {
     db: Database;
     codeHnsw?: HNSWIndex;
     gitHnsw?: HNSWIndex;
-    memHnsw?: HNSWIndex;
+    patternHnsw?: HNSWIndex;
     codeVecs: Map<number, Float32Array>;
     gitVecs: Map<number, Float32Array>;
-    memVecs: Map<number, Float32Array>;
+    patternVecs: Map<number, Float32Array>;
     embedding: EmbeddingProvider;
     reranker?: Reranker;
 }
@@ -717,8 +716,8 @@ interface SearchOptions {
     codeK?: number;
     /** Max git results. Default: 5 */
     gitK?: number;
-    /** Max memory results. Default: 4 */
-    memoryK?: number;
+    /** Max pattern results. Default: 4 */
+    patternK?: number;
     /** Minimum similarity score. Default: 0.25 */
     minScore?: number;
     /** Use MMR for diversity. Default: true */
@@ -726,9 +725,9 @@ interface SearchOptions {
     /** MMR lambda. Default: 0.7 */
     mmrLambda?: number;
 }
-declare class UnifiedSearch {
-    private _deps;
-    constructor(deps: SearchDeps);
+declare class MultiIndexSearch {
+    private _config;
+    constructor(config: SearchConfig);
     /**
      * Search across all indices.
      * Returns combined results sorted by score.
@@ -771,8 +770,8 @@ declare class CoEditAnalyzer {
 
 declare class ContextBuilder {
     private _search;
-    private _coEdits;
-    constructor(_search: UnifiedSearch, _coEdits: CoEditAnalyzer);
+    private _coEdits?;
+    constructor(_search: MultiIndexSearch, _coEdits?: CoEditAnalyzer | undefined);
     /**
      * Build a full context block for a task.
      * Returns clean markdown ready for system prompt injection.
@@ -793,8 +792,8 @@ interface BM25Options {
     codeK?: number;
     /** Max git results. Default: 5 */
     gitK?: number;
-    /** Max memory results. Default: 4 */
-    memoryK?: number;
+    /** Max pattern results. Default: 4 */
+    patternK?: number;
 }
 declare class BM25Search {
     private _db;
@@ -834,12 +833,4 @@ declare class BM25Search {
  */
 declare function reciprocalRankFusion(resultSets: SearchResult[][], k?: number, maxResults?: number): SearchResult[];
 
-declare const DEFAULTS: ResolvedConfig;
-/**
- * Merge partial config with defaults.
- * All fields become required.
- * Relative dbPath is resolved against repoPath.
- */
-declare function resolveConfig(partial?: BrainBankConfig): ResolvedConfig;
-
-export { BM25Search, BrainBank, BrainBankConfig, CoEditAnalyzer, CoEditSuggestion, CodeChunk, CodeChunker, CodeIndexer, Collection, Consolidator, ContextBuilder, ContextOptions, DEFAULTS, DocIndexer, DocumentCollection, EmbeddingProvider, GitIndexer, HNSWIndex, IGNORE_DIRS, IndexResult, IndexStats, Indexer, LocalEmbedding, MemoryPattern, type NoteDigest, NoteStore, OpenAIEmbedding, type OpenAIEmbeddingOptions, PatternStore, ProgressCallback, type RecallOptions, type ReembedOptions, type ReembedResult, Reranker, ResolvedConfig, SUPPORTED_EXTENSIONS, SearchHit, SearchResult, type StoredNote, UnifiedSearch, VectorIndex, type WatchOptions, type Watcher, cosineSimilarity, getLanguage, isSupported, normalize, reciprocalRankFusion, resolveConfig, searchMMR };
+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 };

package/dist/index.js

@@ -1,10 +1,10 @@
 import {
   NoteStore
-} from "./chunk-MJ3Y24H6.js";
+} from "./chunk-FJJY4H2Y.js";
 import {
   Consolidator,
   PatternStore
-} from "./chunk-Z5SU54HP.js";
+} from "./chunk-X6645UVR.js";
 import {
   BM25Search,
   BrainBank,
@@ -13,10 +13,10 @@ import {
   DEFAULTS,
   HNSWIndex,
   LocalEmbedding,
-  UnifiedSearch,
+  MultiIndexSearch,
   resolveConfig,
   searchMMR
-} from "./chunk-YGSEUWLV.js";
+} from "./chunk-6MFTQV3O.js";
 import {
   CodeChunker,
   CodeIndexer,
@@ -25,26 +25,26 @@ import {
   code,
   getLanguage,
   isSupported
-} from "./chunk-EDKSKLX4.js";
+} from "./chunk-WR4WXKJT.js";
 import {
   CoEditAnalyzer,
   GitIndexer,
   git
-} from "./chunk-N6ZMBFDE.js";
+} from "./chunk-7JCEW7LT.js";
 import {
-  DocIndexer,
+  DocsIndexer,
   docs
-} from "./chunk-GOUBW7UA.js";
+} from "./chunk-F6SJ3U4H.js";
 import {
   reciprocalRankFusion
-} from "./chunk-4ZKBQ33J.js";
+} from "./chunk-V4UJKXPK.js";
 import {
   cosineSimilarity,
   normalize
-} from "./chunk-2P3EGY6S.js";
+} from "./chunk-QNHBCOKB.js";
 import {
   OpenAIEmbedding
-} from "./chunk-3GAIDXRW.js";
+} from "./chunk-GUT5MSJT.js";
 import "./chunk-7QVYU63E.js";
 export {
   BM25Search,
@@ -56,16 +56,16 @@ export {
   Consolidator,
   ContextBuilder,
   DEFAULTS,
-  DocIndexer,
+  DocsIndexer,
   GitIndexer,
   HNSWIndex,
   IGNORE_DIRS,
   LocalEmbedding,
+  MultiIndexSearch,
   NoteStore,
   OpenAIEmbedding,
   PatternStore,
   SUPPORTED_EXTENSIONS,
-  UnifiedSearch,
   code,
   cosineSimilarity,
   docs,

package/dist/memory.d.ts

@@ -1,8 +1,8 @@
-import { B as BrainBankModule } from './types-Da_zLLOl.js';
+import { I as Indexer } from './base-9vfWRHCV.js';
 import 'better-sqlite3';
 
 /**
- * BrainBank — Memory Module
+ * BrainBank — Memory Plugin
  *
  * Agent learns from completed tasks — stores patterns,
  * consolidates failures, distills strategies.
@@ -11,9 +11,7 @@ import 'better-sqlite3';
  *   brain.use(memory());
  */
 
-interface MemoryModuleOptions {
-}
-/** Create an agent memory (learning) module. */
-declare function memory(opts?: MemoryModuleOptions): BrainBankModule;
+/** Create an agent memory plugin. */
+declare function memory(): Indexer;
 
-export { type MemoryModuleOptions, memory };
+export { memory };

package/dist/memory.js

@@ -1,13 +1,13 @@
 import {
   Consolidator,
   PatternStore
-} from "./chunk-Z5SU54HP.js";
-import "./chunk-2P3EGY6S.js";
+} from "./chunk-X6645UVR.js";
+import "./chunk-QNHBCOKB.js";
 import {
   __name
 } from "./chunk-7QVYU63E.js";
 
-// src/memory/strategy-distiller.ts
+// src/memory/distiller.ts
 var StrategyDistiller = class {
   constructor(_db) {
     this._db = _db;
@@ -80,13 +80,10 @@ var StrategyDistiller = class {
   }
 };
 
-// src/plugins/memory.ts
-var MemoryModuleImpl = class {
-  constructor(opts = {}) {
-    this.opts = opts;
-  }
+// src/indexers/memory/memory-plugin.ts
+var MemoryPlugin = class {
   static {
-    __name(this, "MemoryModuleImpl");
+    __name(this, "MemoryPlugin");
   }
   name = "memory";
   hnsw;
@@ -111,7 +108,7 @@ var MemoryModuleImpl = class {
   /** Store a learned pattern. */
   async learn(pattern) {
     const id = await this.patternStore.learn(pattern);
-    if (this.patternStore.count % 50 === 0) {
+    if (this.patternStore.count > 0 && this.patternStore.count % 50 === 0) {
       this.consolidator.consolidate();
     }
     return id;
@@ -136,8 +133,8 @@ var MemoryModuleImpl = class {
     };
   }
 };
-function memory(opts) {
-  return new MemoryModuleImpl(opts);
+function memory() {
+  return new MemoryPlugin();
 }
 __name(memory, "memory");
 export {

package/dist/memory.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/memory/strategy-distiller.ts","../src/plugins/memory.ts"],"sourcesContent":["/**\n * BrainBank — Strategy Distiller\n * \n * Aggregates top patterns for a task type into a single strategy text.\n * Analogous to SONA's Deep Loop — periodic knowledge distillation.\n */\n\nimport type { Database } from '../storage/database.ts';\nimport type { DistilledStrategy } from '../types.ts';\n\nexport class StrategyDistiller {\n    constructor(private _db: Database) {}\n\n    /**\n     * Distill top patterns for a task type into a strategy.\n     * Updates the distilled_strategies table.\n     */\n    distill(taskType: string, topK: number = 10): DistilledStrategy | null {\n        const patterns = this._db.prepare(`\n            SELECT task, approach, outcome, critique, success_rate\n            FROM memory_patterns\n            WHERE task_type = ? AND success_rate >= 0.7\n            ORDER BY success_rate DESC, created_at DESC\n            LIMIT ?\n        `).all(taskType, topK) as any[];\n\n        if (patterns.length === 0) return null;\n\n        // Build strategy text from top patterns\n        const lines: string[] = [];\n        const avgSuccess = patterns.reduce((sum: number, p: any) => sum + p.success_rate, 0) / patterns.length;\n\n        lines.push(`Strategy for \"${taskType}\" (${patterns.length} patterns, avg success ${Math.round(avgSuccess * 100)}%):`);\n        lines.push('');\n\n        for (const p of patterns) {\n            lines.push(`• ${p.approach} (${Math.round(p.success_rate * 100)}%)`);\n            if (p.critique) lines.push(`  └ ${p.critique}`);\n        }\n\n        const strategy = lines.join('\\n');\n        const confidence = avgSuccess;\n        const now = Math.floor(Date.now() / 1000);\n\n        this._db.prepare(`\n            INSERT INTO distilled_strategies (task_type, strategy, confidence, updated_at)\n            VALUES (?, ?, ?, ?)\n            ON CONFLICT(task_type) DO UPDATE SET\n                strategy = excluded.strategy,\n                confidence = excluded.confidence,\n                updated_at = excluded.updated_at\n        `).run(taskType, strategy, confidence, now);\n\n        return { taskType, strategy, confidence, updatedAt: now };\n    }\n\n    /**\n     * Get a distilled strategy for a task type.\n     */\n    get(taskType: string): DistilledStrategy | null {\n        const row = this._db.prepare(\n            'SELECT * FROM distilled_strategies WHERE task_type = ?'\n        ).get(taskType) as any;\n\n        if (!row) return null;\n        return {\n            taskType: row.task_type,\n            strategy: row.strategy,\n            confidence: row.confidence,\n            updatedAt: row.updated_at,\n        };\n    }\n\n    /**\n     * List all distilled strategies.\n     */\n    list(): DistilledStrategy[] {\n        const rows = this._db.prepare(\n            'SELECT * FROM distilled_strategies ORDER BY confidence DESC'\n        ).all() as any[];\n\n        return rows.map(r => ({\n            taskType: r.task_type,\n            strategy: r.strategy,\n            confidence: r.confidence,\n            updatedAt: r.updated_at,\n        }));\n    }\n}\n","/**\n * BrainBank — Memory Module\n * \n * Agent learns from completed tasks — stores patterns,\n * consolidates failures, distills strategies.\n * \n *   import { memory } from 'brainbank/memory';\n *   brain.use(memory());\n */\n\nimport type { BrainBankModule, ModuleContext } from './types.ts';\nimport type { HNSWIndex } from '../vector/hnsw.ts';\nimport type { Database } from '../storage/database.ts';\nimport { PatternStore } from '../memory/pattern-store.ts';\nimport { Consolidator } from '../memory/consolidator.ts';\nimport { StrategyDistiller } from '../memory/strategy-distiller.ts';\nimport type { MemoryPattern, DistilledStrategy } from '../types.ts';\n\nexport interface MemoryModuleOptions {}\n\nclass MemoryModuleImpl implements BrainBankModule {\n    readonly name = 'memory';\n    hnsw!: HNSWIndex;\n    patternStore!: PatternStore;\n    consolidator!: Consolidator;\n    distiller!: StrategyDistiller;\n    vecCache = new Map<number, Float32Array>();\n    private _db!: Database;\n\n    constructor(private opts: MemoryModuleOptions = {}) {}\n\n    async initialize(ctx: ModuleContext): Promise<void> {\n        this._db = ctx.db;\n        this.hnsw = await ctx.createHnsw(100_000);\n        ctx.loadVectors('memory_vectors', 'pattern_id', this.hnsw, this.vecCache);\n\n        this.patternStore = new PatternStore({\n            db: ctx.db,\n            hnsw: this.hnsw,\n            vectorCache: this.vecCache,\n            embedding: ctx.embedding,\n        });\n\n        this.consolidator = new Consolidator(ctx.db, this.vecCache);\n        this.distiller = new StrategyDistiller(ctx.db);\n    }\n\n    /** Store a learned pattern. */\n    async learn(pattern: MemoryPattern): Promise<number> {\n        const id = await this.patternStore.learn(pattern);\n\n        // Auto-consolidate every 50 patterns\n        if (this.patternStore.count % 50 === 0) {\n            this.consolidator.consolidate();\n        }\n\n        return id;\n    }\n\n    /** Search for similar patterns. */\n    async search(query: string, k: number = 4): Promise<(MemoryPattern & { score: number })[]> {\n        return this.patternStore.search(query, k);\n    }\n\n    /** Consolidate: prune old failures + deduplicate. */\n    consolidate(): { pruned: number; deduped: number } {\n        return this.consolidator.consolidate();\n    }\n\n    /** Distill patterns into a strategy. */\n    distill(taskType: string): DistilledStrategy | null {\n        return this.distiller.distill(taskType);\n    }\n\n    stats(): Record<string, any> {\n        return {\n            patterns: this.patternStore.count,\n            avgSuccess: (this._db.prepare('SELECT AVG(success_rate) as a FROM memory_patterns').get() as any).a ?? 0,\n            hnswSize: this.hnsw.size,\n        };\n    }\n}\n\n/** Create an agent memory (learning) module. */\nexport function memory(opts?: MemoryModuleOptions): BrainBankModule {\n    return new MemoryModuleImpl(opts);\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/memory/distiller.ts","../src/indexers/memory/memory-plugin.ts"],"sourcesContent":["/**\n * BrainBank — Strategy Distiller\n * \n * Aggregates top patterns for a task type into a single strategy text.\n * Analogous to SONA's Deep Loop — periodic knowledge distillation.\n */\n\nimport type { Database } from '../db/database.ts';\nimport type { DistilledStrategy } from '../types.ts';\n\nexport class StrategyDistiller {\n    constructor(private _db: Database) {}\n\n    /**\n     * Distill top patterns for a task type into a strategy.\n     * Updates the distilled_strategies table.\n     */\n    distill(taskType: string, topK: number = 10): DistilledStrategy | null {\n        const patterns = this._db.prepare(`\n            SELECT task, approach, outcome, critique, success_rate\n            FROM memory_patterns\n            WHERE task_type = ? AND success_rate >= 0.7\n            ORDER BY success_rate DESC, created_at DESC\n            LIMIT ?\n        `).all(taskType, topK) as any[];\n\n        if (patterns.length === 0) return null;\n\n        // Build strategy text from top patterns\n        const lines: string[] = [];\n        const avgSuccess = patterns.reduce((sum: number, p: any) => sum + p.success_rate, 0) / patterns.length;\n\n        lines.push(`Strategy for \"${taskType}\" (${patterns.length} patterns, avg success ${Math.round(avgSuccess * 100)}%):`);\n        lines.push('');\n\n        for (const p of patterns) {\n            lines.push(`• ${p.approach} (${Math.round(p.success_rate * 100)}%)`);\n            if (p.critique) lines.push(`  └ ${p.critique}`);\n        }\n\n        const strategy = lines.join('\\n');\n        const confidence = avgSuccess;\n        const now = Math.floor(Date.now() / 1000);\n\n        this._db.prepare(`\n            INSERT INTO distilled_strategies (task_type, strategy, confidence, updated_at)\n            VALUES (?, ?, ?, ?)\n            ON CONFLICT(task_type) DO UPDATE SET\n                strategy = excluded.strategy,\n                confidence = excluded.confidence,\n                updated_at = excluded.updated_at\n        `).run(taskType, strategy, confidence, now);\n\n        return { taskType, strategy, confidence, updatedAt: now };\n    }\n\n    /**\n     * Get a distilled strategy for a task type.\n     */\n    get(taskType: string): DistilledStrategy | null {\n        const row = this._db.prepare(\n            'SELECT * FROM distilled_strategies WHERE task_type = ?'\n        ).get(taskType) as any;\n\n        if (!row) return null;\n        return {\n            taskType: row.task_type,\n            strategy: row.strategy,\n            confidence: row.confidence,\n            updatedAt: row.updated_at,\n        };\n    }\n\n    /**\n     * List all distilled strategies.\n     */\n    list(): DistilledStrategy[] {\n        const rows = this._db.prepare(\n            'SELECT * FROM distilled_strategies ORDER BY confidence DESC'\n        ).all() as any[];\n\n        return rows.map(r => ({\n            taskType: r.task_type,\n            strategy: r.strategy,\n            confidence: r.confidence,\n            updatedAt: r.updated_at,\n        }));\n    }\n}\n","/**\n * BrainBank — Memory Plugin\n * \n * Agent learns from completed tasks — stores patterns,\n * consolidates failures, distills strategies.\n * \n *   import { memory } from 'brainbank/memory';\n *   brain.use(memory());\n */\n\nimport type { Indexer, IndexerContext } from '../base.ts';\nimport type { HNSWIndex } from '../../providers/vector/hnsw.ts';\nimport type { Database } from '../../db/database.ts';\nimport { PatternStore } from '../../memory/store.ts';\nimport { Consolidator } from '../../memory/consolidator.ts';\nimport { StrategyDistiller } from '../../memory/distiller.ts';\nimport type { LearningPattern, DistilledStrategy } from '../../types.ts';\n\nclass MemoryPlugin implements Indexer {\n    readonly name = 'memory';\n    hnsw!: HNSWIndex;\n    patternStore!: PatternStore;\n    consolidator!: Consolidator;\n    distiller!: StrategyDistiller;\n    vecCache = new Map<number, Float32Array>();\n    private _db!: Database;\n\n    async initialize(ctx: IndexerContext): Promise<void> {\n        this._db = ctx.db;\n        this.hnsw = await ctx.createHnsw(100_000);\n        ctx.loadVectors('memory_vectors', 'pattern_id', this.hnsw, this.vecCache);\n\n        this.patternStore = new PatternStore({\n            db: ctx.db,\n            hnsw: this.hnsw,\n            vectorCache: this.vecCache,\n            embedding: ctx.embedding,\n        });\n\n        this.consolidator = new Consolidator(ctx.db, this.vecCache);\n        this.distiller = new StrategyDistiller(ctx.db);\n    }\n\n    /** Store a learned pattern. */\n    async learn(pattern: LearningPattern): Promise<number> {\n        const id = await this.patternStore.learn(pattern);\n\n        // Auto-consolidate every 50 patterns (guard against count=0)\n        if (this.patternStore.count > 0 && this.patternStore.count % 50 === 0) {\n            this.consolidator.consolidate();\n        }\n\n        return id;\n    }\n\n    /** Search for similar patterns. */\n    async search(query: string, k: number = 4): Promise<(LearningPattern & { score: number })[]> {\n        return this.patternStore.search(query, k);\n    }\n\n    /** Consolidate: prune old failures + deduplicate. */\n    consolidate(): { pruned: number; deduped: number } {\n        return this.consolidator.consolidate();\n    }\n\n    /** Distill patterns into a strategy. */\n    distill(taskType: string): DistilledStrategy | null {\n        return this.distiller.distill(taskType);\n    }\n\n    stats(): Record<string, any> {\n        return {\n            patterns: this.patternStore.count,\n            avgSuccess: (this._db.prepare('SELECT AVG(success_rate) as a FROM memory_patterns').get() as any).a ?? 0,\n            hnswSize: this.hnsw.size,\n        };\n    }\n}\n\n/** Create an agent memory plugin. */\nexport function memory(): Indexer {\n    return new MemoryPlugin();\n}\n"],"mappings":"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","names":[]}

package/dist/notes.d.ts

@@ -1,4 +1,4 @@
-import { B as BrainBankModule } from './types-Da_zLLOl.js';
+import { I as Indexer } from './base-9vfWRHCV.js';
 import 'better-sqlite3';
 
 /**
@@ -11,9 +11,7 @@ import 'better-sqlite3';
  *   brain.use(notes());
  */
 
-interface NotesModuleOptions {
-}
-/** Create a notes memory module. */
-declare function notes(opts?: NotesModuleOptions): BrainBankModule;
+/** Create a notes plugin. */
+declare function notes(): Indexer;
 
-export { type NotesModuleOptions, notes };
+export { notes };

package/dist/notes.js

@@ -1,18 +1,15 @@
 import {
   NoteStore
-} from "./chunk-MJ3Y24H6.js";
-import "./chunk-4ZKBQ33J.js";
+} from "./chunk-FJJY4H2Y.js";
+import "./chunk-V4UJKXPK.js";
 import {
   __name
 } from "./chunk-7QVYU63E.js";
 
-// src/plugins/notes.ts
-var NotesModuleImpl = class {
-  constructor(opts = {}) {
-    this.opts = opts;
-  }
+// src/indexers/notes/notes-plugin.ts
+var NotesPlugin = class {
   static {
-    __name(this, "NotesModuleImpl");
+    __name(this, "NotesPlugin");
   }
   name = "notes";
   hnsw;
@@ -47,8 +44,8 @@ var NotesModuleImpl = class {
     return this.store.count();
   }
 };
-function notes(opts) {
-  return new NotesModuleImpl(opts);
+function notes() {
+  return new NotesPlugin();
 }
 __name(notes, "notes");
 export {