brainbank 0.1.3 → 0.2.0

package/dist/code.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';
 
 /**
@@ -17,7 +17,7 @@ import 'better-sqlite3';
  *     .use(code({ repoPath: './backend',  name: 'code:backend' }));
  */
 
-interface CodeModuleOptions {
+interface CodePluginOptions {
     /** Repository path to index. Default: '.' */
     repoPath?: string;
     /** Maximum file size in bytes. Default: from config */
@@ -25,7 +25,7 @@ interface CodeModuleOptions {
     /** Custom indexer name for multi-repo (e.g. 'code:frontend'). Default: 'code' */
     name?: string;
 }
-/** Create a code indexing module. */
-declare function code(opts?: CodeModuleOptions): BrainBankModule;
+/** Create a code indexing plugin. */
+declare function code(opts?: CodePluginOptions): Indexer;
 
-export { type CodeModuleOptions, code };
+export { type CodePluginOptions, code };

package/dist/code.js

@@ -1,6 +1,6 @@
 import {
   code
-} from "./chunk-RAEBYV75.js";
+} from "./chunk-WR4WXKJT.js";
 import "./chunk-7QVYU63E.js";
 export {
   code

package/dist/docs.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(docs());
  */
 
-interface DocsModuleOptions {
-}
-/** Create a document collections module. */
-declare function docs(opts?: DocsModuleOptions): BrainBankModule;
+/** Create a document collections plugin. */
+declare function docs(): Indexer;
 
-export { type DocsModuleOptions, docs };
+export { docs };

package/dist/docs.js

@@ -1,6 +1,6 @@
 import {
   docs
-} from "./chunk-GOUBW7UA.js";
+} from "./chunk-F6SJ3U4H.js";
 import "./chunk-7QVYU63E.js";
 export {
   docs

package/dist/git.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';
 
 /**
@@ -15,7 +15,7 @@ import 'better-sqlite3';
  *     .use(git({ repoPath: './backend',  name: 'git:backend' }));
  */
 
-interface GitModuleOptions {
+interface GitPluginOptions {
     /** Repository path. Default: from config */
     repoPath?: string;
     /** Max commits to index. Default: from config */
@@ -25,7 +25,7 @@ interface GitModuleOptions {
     /** Custom indexer name for multi-repo (e.g. 'git:frontend'). Default: 'git' */
     name?: string;
 }
-/** Create a git history module. */
-declare function git(opts?: GitModuleOptions): BrainBankModule;
+/** Create a git history plugin. */
+declare function git(opts?: GitPluginOptions): Indexer;
 
-export { type GitModuleOptions, git };
+export { type GitPluginOptions, git };

package/dist/git.js

@@ -1,6 +1,6 @@
 import {
   git
-} from "./chunk-N6ZMBFDE.js";
+} from "./chunk-7JCEW7LT.js";
 import "./chunk-7QVYU63E.js";
 export {
   git

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,16 +128,11 @@ declare class BrainBank extends EventEmitter {
     collection(name: string): Collection;
     /** List all collection names that have data. */
     listCollectionNames(): string[];
-    /**
-     * Index code, git, and/or docs in one call.
-     * Incremental — only processes changes since last run.
-     * @param modules - Which modules to index. Default: all available (['code', 'git', 'docs'])
-     */
     index(options?: {
         modules?: ('code' | 'git' | 'docs')[];
         gitDepth?: number;
         forceReindex?: boolean;
-        onProgress?: (stage: string, msg: string) => void;
+        onProgress?: StageProgressCallback;
     }): Promise<{
         code?: IndexResult;
         git?: IndexResult;
@@ -160,12 +142,12 @@ declare class BrainBank extends EventEmitter {
             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;
@@ -210,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[]>;
@@ -223,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;
@@ -255,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. */
@@ -280,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;
 }
 
 /**
@@ -301,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;
     /**
@@ -347,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[]>;
@@ -374,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)
  *
@@ -520,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;
@@ -559,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;
 }
 
 /**
@@ -595,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;
 }
@@ -722,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;
 }
@@ -744,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 */
@@ -753,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.
@@ -798,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.
@@ -820,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;
@@ -861,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-TW5NTYYZ.js";
+} from "./chunk-6MFTQV3O.js";
 import {
   CodeChunker,
   CodeIndexer,
@@ -25,26 +25,26 @@ import {
   code,
   getLanguage,
   isSupported
-} from "./chunk-RAEBYV75.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 };