brainbank 0.5.0 → 0.7.0

package/dist/{chunk-MY36UPPQ.js → chunk-DI3H6JVZ.js}

@@ -1,11 +1,15 @@
+import {
+  providerKey,
+  resolveEmbedding
+} from "./chunk-B77KABWH.js";
 import {
   isIgnoredDir,
   isIgnoredFile,
   isSupported
-} from "./chunk-DDECTPRM.js";
+} from "./chunk-FGL32LUJ.js";
 import {
   rerank
-} from "./chunk-YRGUIRN5.js";
+} from "./chunk-VQ27YUHH.js";
 import {
   normalizeBM25,
   reciprocalRankFusion,
@@ -55,7 +59,7 @@ function resolveConfig(partial = {}) {
 }
 __name(resolveConfig, "resolveConfig");
 
-// src/core/collection.ts
+// src/domain/collection.ts
 var Collection = class {
   constructor(_name, _db, _embedding, _hnsw, _vecs, _reranker) {
     this._name = _name;
@@ -435,76 +439,6 @@ var HNSWIndex = class {
   }
 };
 
-// src/providers/embeddings/local-embedding.ts
-var LocalEmbedding = class {
-  static {
-    __name(this, "LocalEmbedding");
-  }
-  dims = 384;
-  _pipeline = null;
-  _modelName;
-  _cacheDir;
-  constructor(options = {}) {
-    this._modelName = options.model ?? "Xenova/all-MiniLM-L6-v2";
-    this._cacheDir = options.cacheDir ?? ".model-cache";
-  }
-  _pipelinePromise = null;
-  /**
-   * Lazy-load the transformer pipeline.
-   * Singleton — created once and reused.
-   * Promise-deduped to prevent concurrent downloads.
-   */
-  async _getPipeline() {
-    if (this._pipeline) return this._pipeline;
-    if (this._pipelinePromise) return this._pipelinePromise;
-    this._pipelinePromise = (async () => {
-      const { pipeline, env } = await import("@xenova/transformers");
-      env.cacheDir = this._cacheDir;
-      env.allowLocalModels = true;
-      this._pipeline = await pipeline("feature-extraction", this._modelName, {
-        quantized: true
-      });
-      return this._pipeline;
-    })();
-    try {
-      return await this._pipelinePromise;
-    } finally {
-      this._pipelinePromise = null;
-    }
-  }
-  /**
-   * Embed a single text string.
-   * Returns a normalized Float32Array of length 384.
-   */
-  async embed(text) {
-    const pipe = await this._getPipeline();
-    const output = await pipe(text, { pooling: "mean", normalize: true });
-    return output.data;
-  }
-  /**
-   * Embed multiple texts using real batch processing.
-   * Chunks into groups of BATCH_SIZE to balance throughput vs memory.
-   */
-  async embedBatch(texts) {
-    if (texts.length === 0) return [];
-    const BATCH_SIZE = 32;
-    const pipe = await this._getPipeline();
-    const results = [];
-    for (let i = 0; i < texts.length; i += BATCH_SIZE) {
-      const batch = texts.slice(i, i + BATCH_SIZE);
-      const output = await pipe(batch, { pooling: "mean", normalize: true });
-      for (let j = 0; j < batch.length; j++) {
-        const start = j * this.dims;
-        results.push(output.data.slice(start, start + this.dims));
-      }
-    }
-    return results;
-  }
-  async close() {
-    this._pipeline = null;
-  }
-};
-
 // src/search/vector/mmr.ts
 function searchMMR(index, query, vectorCache, k, lambda = 0.7) {
   const candidates = index.search(query, k * 3);
@@ -827,7 +761,7 @@ var KeywordSearch = class {
   }
 };
 
-// src/core/context-builder.ts
+// src/search/context-builder.ts
 var ContextBuilder = class {
   constructor(_search, _coEdits) {
     this._search = _search;
@@ -947,21 +881,21 @@ var ContextBuilder = class {
 // src/brainbank.ts
 import { EventEmitter } from "events";
 
-// src/core/registry.ts
+// src/bootstrap/registry.ts
 var ALIASES = {};
-var IndexerRegistry = class {
+var PluginRegistry = class {
   static {
-    __name(this, "IndexerRegistry");
+    __name(this, "PluginRegistry");
   }
   _map = /* @__PURE__ */ new Map();
   // ── Registration ────────────────────────────────
-  /** Store an indexer. Duplicate names silently overwrite. */
-  register(indexer) {
-    this._map.set(indexer.name, indexer);
+  /** Store a plugin. Duplicate names silently overwrite. */
+  register(plugin) {
+    this._map.set(plugin.name, plugin);
   }
   // ── Lookup ──────────────────────────────────────
   /**
-   * Check whether an indexer is registered.
+   * Check whether a plugin is registered.
    * Supports type-prefix matching: `has('code')` returns true if
    * 'code', 'code:frontend', or 'code:backend' is registered.
    */
@@ -973,7 +907,7 @@ var IndexerRegistry = class {
     return false;
   }
   /**
-   * Get an indexer by name.  Throws a descriptive error if not found.
+   * Get a plugin by name.  Throws a descriptive error if not found.
    *
    * Resolution order:
    *   1. Alias map   (currently empty)
@@ -987,11 +921,11 @@ var IndexerRegistry = class {
     const prefixed = this.firstByType(name);
     if (prefixed) return prefixed;
     throw new Error(
-      `BrainBank: Indexer '${name}' is not loaded. Add .use(${name}()) to your BrainBank instance.`
+      `BrainBank: Plugin '${name}' is not loaded. Add .use(${name}()) to your BrainBank instance.`
     );
   }
   /**
-   * Return every indexer whose name equals `type` or starts with `type + ':'`.
+   * Return every plugin whose name equals `type` or starts with `type + ':'`.
    * Example: allByType('code') → [code, code:frontend, code:backend]
    */
   allByType(type) {
@@ -999,7 +933,7 @@ var IndexerRegistry = class {
       (m) => m.name === type || m.name.startsWith(type + ":")
     );
   }
-  /** Return the first indexer that matches the type prefix, or undefined. */
+  /** Return the first plugin that matches the type prefix, or undefined. */
   firstByType(type) {
     for (const m of this._map.values()) {
       if (m.name === type || m.name.startsWith(type + ":")) return m;
@@ -1007,11 +941,11 @@ var IndexerRegistry = class {
     return void 0;
   }
   // ── Accessors ───────────────────────────────────
-  /** All registered indexer names (insertion order). */
+  /** All registered plugin names (insertion order). */
   get names() {
     return [...this._map.keys()];
   }
-  /** All registered indexer instances (insertion order). */
+  /** All registered plugin instances (insertion order). */
   get all() {
     return [...this._map.values()];
   }
@@ -1023,13 +957,13 @@ var IndexerRegistry = class {
     return this._map;
   }
   // ── Lifecycle ───────────────────────────────────
-  /** Remove all registered indexers. Called by BrainBank.close(). */
+  /** Remove all registered plugins. Called by BrainBank.close(). */
   clear() {
     this._map.clear();
   }
 };
 
-// src/core/initializer.ts
+// src/bootstrap/initializer.ts
 import { dirname as dirname2, join as join2 } from "path";
 
 // src/db/database.ts
@@ -1401,165 +1335,7 @@ var Database = class {
   }
 };
 
-// src/services/reembed.ts
-var TABLES = [
-  {
-    name: "code",
-    textTable: "code_chunks",
-    vectorTable: "code_vectors",
-    idColumn: "id",
-    fkColumn: "chunk_id",
-    textBuilder: /* @__PURE__ */ __name((r) => [
-      `File: ${r.file_path}`,
-      r.name ? `${r.chunk_type}: ${r.name}` : r.chunk_type,
-      r.content
-    ].join("\n"), "textBuilder")
-  },
-  {
-    name: "git",
-    textTable: "git_commits",
-    vectorTable: "git_vectors",
-    idColumn: "id",
-    fkColumn: "commit_id",
-    // Must match git-engine.ts:119-125 exactly
-    textBuilder: /* @__PURE__ */ __name((r) => [
-      `Commit: ${r.message}`,
-      `Author: ${r.author}`,
-      `Date: ${r.date}`,
-      r.files_json && r.files_json !== "[]" ? `Files: ${JSON.parse(r.files_json).join(", ")}` : "",
-      r.diff ? `Changes:
-${r.diff.slice(0, 2e3)}` : ""
-    ].filter(Boolean).join("\n"), "textBuilder")
-  },
-  {
-    name: "memory",
-    textTable: "memory_patterns",
-    vectorTable: "memory_vectors",
-    idColumn: "id",
-    fkColumn: "pattern_id",
-    // Must match memory/pattern-store.ts:49 exactly
-    textBuilder: /* @__PURE__ */ __name((r) => `${r.task_type} ${r.task} ${r.approach}`, "textBuilder")
-  },
-  {
-    name: "notes",
-    textTable: "note_memories",
-    vectorTable: "note_vectors",
-    idColumn: "id",
-    fkColumn: "note_id",
-    // Must match notes/engine.ts:90 exactly
-    textBuilder: /* @__PURE__ */ __name((r) => {
-      const decisions = JSON.parse(r.decisions_json || "[]").join(". ");
-      const patterns = JSON.parse(r.patterns_json || "[]").join(". ");
-      return `${r.title}
-${r.summary}
-${decisions}
-${patterns}`;
-    }, "textBuilder")
-  },
-  {
-    name: "docs",
-    textTable: "doc_chunks",
-    vectorTable: "doc_vectors",
-    idColumn: "id",
-    fkColumn: "chunk_id",
-    // Must match docs-engine.ts:160 exactly
-    textBuilder: /* @__PURE__ */ __name((r) => `title: ${r.title ?? ""} | text: ${r.content}`, "textBuilder")
-  },
-  {
-    name: "kv",
-    textTable: "kv_data",
-    vectorTable: "kv_vectors",
-    idColumn: "id",
-    fkColumn: "data_id",
-    textBuilder: /* @__PURE__ */ __name((r) => r.content, "textBuilder")
-  }
-];
-async function reembedAll(db, embedding, hnswMap, options = {}) {
-  const { batchSize = 50, onProgress } = options;
-  const result = {};
-  let total = 0;
-  for (const table of TABLES) {
-    const count = await reembedTable(db, embedding, table, batchSize, onProgress);
-    result[table.name] = count;
-    total += count;
-    const entry = hnswMap.get(table.name);
-    if (entry && count > 0) {
-      await rebuildHnsw(db, table, entry.hnsw, entry.vecs);
-    }
-  }
-  const meta = {
-    provider: embedding.constructor?.name ?? "unknown",
-    dims: String(embedding.dims),
-    reembedded_at: (/* @__PURE__ */ new Date()).toISOString()
-  };
-  const upsert = db.prepare(
-    "INSERT OR REPLACE INTO embedding_meta (key, value) VALUES (?, ?)"
-  );
-  for (const [k, v] of Object.entries(meta)) {
-    upsert.run(k, v);
-  }
-  return {
-    code: result.code ?? 0,
-    git: result.git ?? 0,
-    memory: result.memory ?? 0,
-    notes: result.notes ?? 0,
-    docs: result.docs ?? 0,
-    kv: result.kv ?? 0,
-    total
-  };
-}
-__name(reembedAll, "reembedAll");
-async function reembedTable(db, embedding, table, batchSize, onProgress) {
-  const totalCount = db.prepare(
-    `SELECT COUNT(*) as c FROM ${table.textTable}`
-  ).get().c;
-  if (totalCount === 0) return 0;
-  const tempTable = `_reembed_${table.vectorTable}`;
-  db.exec(`DROP TABLE IF EXISTS ${tempTable}`);
-  db.exec(`CREATE TABLE ${tempTable} AS SELECT * FROM ${table.vectorTable} WHERE 0`);
-  const insertTemp = db.prepare(
-    `INSERT INTO ${tempTable} (${table.fkColumn}, embedding) VALUES (?, ?)`
-  );
-  let processed = 0;
-  try {
-    for (let offset = 0; offset < totalCount; offset += batchSize) {
-      const batch = db.prepare(
-        `SELECT * FROM ${table.textTable} LIMIT ? OFFSET ?`
-      ).all(batchSize, offset);
-      const texts = batch.map((r) => table.textBuilder(r));
-      const vectors = await embedding.embedBatch(texts);
-      db.transaction(() => {
-        for (let j = 0; j < batch.length; j++) {
-          insertTemp.run(batch[j][table.idColumn], vecToBuffer(vectors[j]));
-        }
-      });
-      processed += batch.length;
-      onProgress?.(table.name, processed, totalCount);
-    }
-    db.transaction(() => {
-      db.exec(`DELETE FROM ${table.vectorTable}`);
-      db.exec(`INSERT INTO ${table.vectorTable} SELECT * FROM ${tempTable}`);
-    });
-  } finally {
-    db.exec(`DROP TABLE IF EXISTS ${tempTable}`);
-  }
-  return processed;
-}
-__name(reembedTable, "reembedTable");
-async function rebuildHnsw(db, table, hnsw, vecs) {
-  vecs.clear();
-  hnsw.reinit();
-  const rows = db.prepare(
-    `SELECT ${table.fkColumn} as id, embedding FROM ${table.vectorTable}`
-  ).all();
-  for (const row of rows) {
-    const buf = Buffer.from(row.embedding);
-    const vec = new Float32Array(buf.buffer.slice(buf.byteOffset, buf.byteOffset + buf.byteLength));
-    hnsw.add(vec, row.id);
-    vecs.set(row.id, vec);
-  }
-}
-__name(rebuildHnsw, "rebuildHnsw");
+// src/services/embedding-meta.ts
 function getEmbeddingMeta(db) {
   try {
     const provider = db.prepare(
@@ -1568,8 +1344,15 @@ function getEmbeddingMeta(db) {
     const dims = db.prepare(
       "SELECT value FROM embedding_meta WHERE key = 'dims'"
     ).get();
+    const key = db.prepare(
+      "SELECT value FROM embedding_meta WHERE key = 'provider_key'"
+    ).get();
     if (!provider || !dims) return null;
-    return { provider: provider.value, dims: Number(dims.value) };
+    return {
+      provider: provider.value,
+      dims: Number(dims.value),
+      providerKey: key?.value ?? "local"
+    };
   } catch {
     return null;
   }
@@ -1581,6 +1364,7 @@ function setEmbeddingMeta(db, embedding) {
   );
   upsert.run("provider", embedding.constructor?.name ?? "unknown");
   upsert.run("dims", String(embedding.dims));
+  upsert.run("provider_key", providerKey(embedding));
   upsert.run("indexed_at", (/* @__PURE__ */ new Date()).toISOString());
 }
 __name(setEmbeddingMeta, "setEmbeddingMeta");
@@ -1597,112 +1381,138 @@ function detectProviderMismatch(db, embedding) {
 }
 __name(detectProviderMismatch, "detectProviderMismatch");
 
-// src/core/initializer.ts
-async function earlyInit(config, emit, options = {}) {
-  const db = new Database(config.dbPath);
-  const embedding = config.embeddingProvider ?? new LocalEmbedding();
-  const mismatch = detectProviderMismatch(db, embedding);
-  if (mismatch?.mismatch && !options.force) {
-    db.close();
-    throw new Error(
-      `BrainBank: Embedding dimension mismatch (stored: ${mismatch.stored}, current: ${mismatch.current}). Run brain.reembed() to re-index with the new provider, or switch back to the original provider.`
-    );
+// src/bootstrap/initializer.ts
+var Initializer = class {
+  static {
+    __name(this, "Initializer");
   }
-  setEmbeddingMeta(db, embedding);
-  const kvHnsw = new HNSWIndex(
-    config.embeddingDims,
-    config.maxElements ?? 5e5,
-    config.hnswM,
-    config.hnswEfConstruction,
-    config.hnswEfSearch
-  );
-  await kvHnsw.init();
-  const skipVectorLoad = !!(options.force && mismatch?.mismatch);
-  return { db, embedding, kvHnsw, skipVectorLoad };
-}
-__name(earlyInit, "earlyInit");
-async function lateInit(early, config, registry, sharedHnsw, kvVecs, getCollection) {
-  const { db, embedding, kvHnsw, skipVectorLoad } = early;
-  if (!skipVectorLoad) {
-    const kvIndexPath = hnswPath(config.dbPath, "kv");
-    const kvCount = countRows(db, "kv_vectors");
-    if (kvHnsw.tryLoad(kvIndexPath, kvCount)) {
-      loadVecCache(db, "kv_vectors", "data_id", kvVecs);
-    } else {
-      loadVectors(db, "kv_vectors", "data_id", kvHnsw, kvVecs);
+  _config;
+  _emit;
+  constructor(config, emit) {
+    this._config = config;
+    this._emit = emit;
+  }
+  /** Phase 1: database, embedding provider, KV HNSW index. */
+  async early(options = {}) {
+    const { _config: config } = this;
+    const db = new Database(config.dbPath);
+    const embedding = await this._resolveEmbedding(db);
+    const mismatch = detectProviderMismatch(db, embedding);
+    if (mismatch?.mismatch && !options.force) {
+      db.close();
+      throw new Error(
+        `BrainBank: Embedding dimension mismatch (stored: ${mismatch.stored}, current: ${mismatch.current}). Run brain.reembed() to re-index with the new provider, or switch back to the original provider.`
+      );
     }
-  }
-  const ctx = buildIndexerContext(db, embedding, config, sharedHnsw, skipVectorLoad, getCollection);
-  for (const mod of registry.all) {
-    await mod.initialize(ctx);
-  }
-  saveAllHnsw(config.dbPath, kvHnsw, sharedHnsw);
-  return buildSearchLayer(db, embedding, config, registry, sharedHnsw);
-}
-__name(lateInit, "lateInit");
-function buildIndexerContext(db, embedding, config, sharedHnsw, skipVectorLoad, getCollection) {
-  return {
-    db,
-    embedding,
-    config,
-    createHnsw: /* @__PURE__ */ __name((maxElements) => new HNSWIndex(
+    setEmbeddingMeta(db, embedding);
+    const kvHnsw = new HNSWIndex(
       config.embeddingDims,
-      maxElements ?? config.maxElements,
+      config.maxElements ?? 5e5,
       config.hnswM,
       config.hnswEfConstruction,
       config.hnswEfSearch
-    ).init(), "createHnsw"),
-    loadVectors: /* @__PURE__ */ __name((table, idCol, hnsw, cache) => {
-      if (skipVectorLoad) return;
-      const indexName = table.replace("_vectors", "").replace("_chunks", "");
-      const indexPath = hnswPath(config.dbPath, indexName);
-      const rowCount = countRows(db, table);
-      if (hnsw.tryLoad(indexPath, rowCount)) {
-        loadVecCache(db, table, idCol, cache);
+    );
+    await kvHnsw.init();
+    const skipVectorLoad = !!(options.force && mismatch?.mismatch);
+    return { db, embedding, kvHnsw, skipVectorLoad };
+  }
+  /** Phase 2: load vectors, run indexers, build search layer. */
+  async late(earlyResult, registry, sharedHnsw, kvVecs, getCollection) {
+    const { _config: config } = this;
+    const { db, embedding, kvHnsw, skipVectorLoad } = earlyResult;
+    if (!skipVectorLoad) {
+      const kvIndexPath = hnswPath(config.dbPath, "kv");
+      const kvCount = countRows(db, "kv_vectors");
+      if (kvHnsw.tryLoad(kvIndexPath, kvCount)) {
+        loadVecCache(db, "kv_vectors", "data_id", kvVecs);
       } else {
-        loadVectors(db, table, idCol, hnsw, cache);
+        loadVectors(db, "kv_vectors", "data_id", kvHnsw, kvVecs);
       }
-    }, "loadVectors"),
-    getOrCreateSharedHnsw: /* @__PURE__ */ __name(async (type, maxElements) => {
-      const existing = sharedHnsw.get(type);
-      if (existing) return { ...existing, isNew: false };
-      const hnsw = await new HNSWIndex(
-        config.embeddingDims,
+    }
+    const ctx = this._buildPluginContext(db, embedding, sharedHnsw, skipVectorLoad, getCollection);
+    for (const mod of registry.all) {
+      await mod.initialize(ctx);
+    }
+    saveAllHnsw(config.dbPath, kvHnsw, sharedHnsw);
+    return this._buildSearchLayer(db, embedding, registry, sharedHnsw);
+  }
+  /** Build the PluginContext passed to each plugin's initialize(). */
+  _buildPluginContext(db, embedding, sharedHnsw, skipVectorLoad, getCollection) {
+    const { _config: config } = this;
+    return {
+      db,
+      embedding,
+      config,
+      createHnsw: /* @__PURE__ */ __name((maxElements, dims) => new HNSWIndex(
+        dims ?? config.embeddingDims,
         maxElements ?? config.maxElements,
         config.hnswM,
         config.hnswEfConstruction,
         config.hnswEfSearch
-      ).init();
-      const vecCache = /* @__PURE__ */ new Map();
-      sharedHnsw.set(type, { hnsw, vecCache });
-      return { hnsw, vecCache, isNew: true };
-    }, "getOrCreateSharedHnsw"),
-    collection: getCollection
-  };
-}
-__name(buildIndexerContext, "buildIndexerContext");
-function buildSearchLayer(db, embedding, config, registry, sharedHnsw) {
-  const codeMod = sharedHnsw.get("code");
-  const gitMod = sharedHnsw.get("git");
-  const memMod = registry.firstByType("memory");
-  if (!codeMod && !gitMod && !memMod) return {};
-  const search = new VectorSearch({
-    db,
-    codeHnsw: codeMod?.hnsw,
-    gitHnsw: gitMod?.hnsw,
-    patternHnsw: memMod?.hnsw,
-    codeVecs: codeMod?.vecCache ?? /* @__PURE__ */ new Map(),
-    gitVecs: gitMod?.vecCache ?? /* @__PURE__ */ new Map(),
-    patternVecs: memMod?.vecCache ?? /* @__PURE__ */ new Map(),
-    embedding,
-    reranker: config.reranker
-  });
-  const bm25 = new KeywordSearch(db);
-  const firstGit = registry.firstByType("git");
-  const contextBuilder = new ContextBuilder(search, firstGit?.coEdits);
-  return { search, bm25, contextBuilder };
-}
-__name(buildSearchLayer, "buildSearchLayer");
+      ).init(), "createHnsw"),
+      loadVectors: /* @__PURE__ */ __name((table, idCol, hnsw, cache) => {
+        if (skipVectorLoad) return;
+        const indexName = table.replace("_vectors", "").replace("_chunks", "");
+        const indexPath = hnswPath(config.dbPath, indexName);
+        const rowCount = countRows(db, table);
+        if (hnsw.tryLoad(indexPath, rowCount)) {
+          loadVecCache(db, table, idCol, cache);
+        } else {
+          loadVectors(db, table, idCol, hnsw, cache);
+        }
+      }, "loadVectors"),
+      getOrCreateSharedHnsw: /* @__PURE__ */ __name(async (type, maxElements, dims) => {
+        const existing = sharedHnsw.get(type);
+        if (existing) return { ...existing, isNew: false };
+        const hnswDims = dims ?? config.embeddingDims;
+        const hnsw = await new HNSWIndex(
+          hnswDims,
+          maxElements ?? config.maxElements,
+          config.hnswM,
+          config.hnswEfConstruction,
+          config.hnswEfSearch
+        ).init();
+        const vecCache = /* @__PURE__ */ new Map();
+        sharedHnsw.set(type, { hnsw, vecCache });
+        return { hnsw, vecCache, isNew: true };
+      }, "getOrCreateSharedHnsw"),
+      collection: getCollection
+    };
+  }
+  /** Build VectorSearch + KeywordSearch + ContextBuilder from initialized plugins. */
+  _buildSearchLayer(db, embedding, registry, sharedHnsw) {
+    const { _config: config } = this;
+    const codeMod = sharedHnsw.get("code");
+    const gitMod = sharedHnsw.get("git");
+    const memMod = registry.firstByType("memory");
+    if (!codeMod && !gitMod && !memMod) return {};
+    const search = new VectorSearch({
+      db,
+      codeHnsw: codeMod?.hnsw,
+      gitHnsw: gitMod?.hnsw,
+      patternHnsw: memMod?.hnsw,
+      codeVecs: codeMod?.vecCache ?? /* @__PURE__ */ new Map(),
+      gitVecs: gitMod?.vecCache ?? /* @__PURE__ */ new Map(),
+      patternVecs: memMod?.vecCache ?? /* @__PURE__ */ new Map(),
+      embedding,
+      reranker: config.reranker
+    });
+    const bm25 = new KeywordSearch(db);
+    const firstGit = registry.firstByType("git");
+    const contextBuilder = new ContextBuilder(search, firstGit?.coEdits);
+    return { search, bm25, contextBuilder };
+  }
+  /** Resolve embedding: explicit config > stored DB key > local default. */
+  async _resolveEmbedding(db) {
+    if (this._config.embeddingProvider) return this._config.embeddingProvider;
+    const meta = getEmbeddingMeta(db);
+    if (meta?.providerKey && meta.providerKey !== "local") {
+      this._emit("progress", `Embedding: auto-resolved '${meta.providerKey}' from DB`);
+      return resolveEmbedding(meta.providerKey);
+    }
+    return resolveEmbedding("local");
+  }
+};
 function hnswPath(dbPath, name) {
   return join2(dirname2(dbPath), `hnsw-${name}.index`);
 }
@@ -1750,7 +1560,7 @@ function loadVecCache(db, table, idCol, cache) {
 }
 __name(loadVecCache, "loadVecCache");
 
-// src/core/search-api.ts
+// src/api/search-api.ts
 var SearchAPI = class {
   constructor(_d) {
     this._d = _d;
@@ -1761,7 +1571,7 @@ var SearchAPI = class {
   // ── Vector ──────────────────────────────────────
   async search(query, options) {
     if (!this._d.search) {
-      return this._d.registry.has("docs") ? this._d.searchDocs(query, { k: 8 }) : [];
+      return this._d.registry.has("docs") ? await this._searchDocs(query, { k: 8 }) : [];
     }
     return this._d.search.search(query, options);
   }
@@ -1789,18 +1599,18 @@ var SearchAPI = class {
     if (this._d.search) {
       const [vec, kw] = await Promise.all([
         this._d.search.search(query, { ...options, codeK, gitK }),
-        Promise.resolve(this._d.bm25.search(query, { codeK, gitK }))
+        Promise.resolve(this._d.bm25?.search(query, { codeK, gitK }) ?? [])
       ]);
       resultLists.push(vec, kw);
     }
     if (this._d.registry.has("docs")) {
-      const docs = await this._d.searchDocs(query, { k: docsK });
+      const docs = await this._searchDocs(query, { k: docsK });
       if (docs.length > 0) resultLists.push(docs);
     }
     await this._searchKvCollections(query, cols, resultLists);
     if (resultLists.length === 0) return [];
     const fused = reciprocalRankFusion(resultLists);
-    return this._applyReranking(query, fused);
+    return this._rerankResults(query, fused);
   }
   /** Search non-reserved KV collections and push results. */
   async _searchKvCollections(query, cols, resultLists) {
@@ -1819,10 +1629,16 @@ var SearchAPI = class {
     }
   }
   /** Apply reranking if a reranker is configured. */
-  async _applyReranking(query, fused) {
+  async _rerankResults(query, fused) {
     if (!this._d.config.reranker || fused.length <= 1) return fused;
     return rerank(query, fused, this._d.config.reranker);
   }
+  /** Search docs directly via the plugin — no circular callback. */
+  async _searchDocs(query, options) {
+    const plugin = this._d.getDocsPlugin();
+    if (!plugin) return [];
+    return plugin.search(query, options);
+  }
   // ── Keyword ─────────────────────────────────────
   async searchBM25(query, options) {
     return this._d.bm25?.search(query, options) ?? [];
@@ -1838,7 +1654,7 @@ var SearchAPI = class {
       if (core) sections.push(core);
     }
     if (this._d.registry.has("docs")) {
-      const docs = await this._d.searchDocs(task, { k: options.codeResults ?? 4 });
+      const docs = await this._searchDocs(task, { k: options.codeResults ?? 4 });
       if (docs.length > 0) {
         const body = docs.map((r) => {
           const m = r.metadata;
@@ -1870,7 +1686,7 @@ function isCollectionPlugin(i) {
 }
 __name(isCollectionPlugin, "isCollectionPlugin");
 
-// src/core/index-api.ts
+// src/api/index-api.ts
 var IndexAPI = class {
   constructor(_d) {
     this._d = _d;
@@ -1953,6 +1769,166 @@ var IndexAPI = class {
   }
 };
 
+// src/services/reembed.ts
+var TABLES = [
+  {
+    name: "code",
+    textTable: "code_chunks",
+    vectorTable: "code_vectors",
+    idColumn: "id",
+    fkColumn: "chunk_id",
+    textBuilder: /* @__PURE__ */ __name((r) => [
+      `File: ${r.file_path}`,
+      r.name ? `${r.chunk_type}: ${r.name}` : r.chunk_type,
+      r.content
+    ].join("\n"), "textBuilder")
+  },
+  {
+    name: "git",
+    textTable: "git_commits",
+    vectorTable: "git_vectors",
+    idColumn: "id",
+    fkColumn: "commit_id",
+    // Must match git-engine.ts:119-125 exactly
+    textBuilder: /* @__PURE__ */ __name((r) => [
+      `Commit: ${r.message}`,
+      `Author: ${r.author}`,
+      `Date: ${r.date}`,
+      r.files_json && r.files_json !== "[]" ? `Files: ${JSON.parse(r.files_json).join(", ")}` : "",
+      r.diff ? `Changes:
+${r.diff.slice(0, 2e3)}` : ""
+    ].filter(Boolean).join("\n"), "textBuilder")
+  },
+  {
+    name: "memory",
+    textTable: "memory_patterns",
+    vectorTable: "memory_vectors",
+    idColumn: "id",
+    fkColumn: "pattern_id",
+    // Must match memory/pattern-store.ts:49 exactly
+    textBuilder: /* @__PURE__ */ __name((r) => `${r.task_type} ${r.task} ${r.approach}`, "textBuilder")
+  },
+  {
+    name: "notes",
+    textTable: "note_memories",
+    vectorTable: "note_vectors",
+    idColumn: "id",
+    fkColumn: "note_id",
+    // Must match notes/engine.ts:90 exactly
+    textBuilder: /* @__PURE__ */ __name((r) => {
+      const decisions = JSON.parse(r.decisions_json || "[]").join(". ");
+      const patterns = JSON.parse(r.patterns_json || "[]").join(". ");
+      return `${r.title}
+${r.summary}
+${decisions}
+${patterns}`;
+    }, "textBuilder")
+  },
+  {
+    name: "docs",
+    textTable: "doc_chunks",
+    vectorTable: "doc_vectors",
+    idColumn: "id",
+    fkColumn: "chunk_id",
+    // Must match docs-engine.ts:160 exactly
+    textBuilder: /* @__PURE__ */ __name((r) => `title: ${r.title ?? ""} | text: ${r.content}`, "textBuilder")
+  },
+  {
+    name: "kv",
+    textTable: "kv_data",
+    vectorTable: "kv_vectors",
+    idColumn: "id",
+    fkColumn: "data_id",
+    textBuilder: /* @__PURE__ */ __name((r) => r.content, "textBuilder")
+  }
+];
+async function reembedAll(db, embedding, hnswMap, options = {}) {
+  const { batchSize = 50, onProgress } = options;
+  const result = {};
+  let total = 0;
+  for (const table of TABLES) {
+    const count = await reembedTable(db, embedding, table, batchSize, onProgress);
+    result[table.name] = count;
+    total += count;
+    const entry = hnswMap.get(table.name);
+    if (entry && count > 0) {
+      await rebuildHnsw(db, table, entry.hnsw, entry.vecs);
+    }
+  }
+  const meta = {
+    provider: embedding.constructor?.name ?? "unknown",
+    dims: String(embedding.dims),
+    reembedded_at: (/* @__PURE__ */ new Date()).toISOString()
+  };
+  const upsert = db.prepare(
+    "INSERT OR REPLACE INTO embedding_meta (key, value) VALUES (?, ?)"
+  );
+  for (const [k, v] of Object.entries(meta)) {
+    upsert.run(k, v);
+  }
+  return {
+    code: result.code ?? 0,
+    git: result.git ?? 0,
+    memory: result.memory ?? 0,
+    notes: result.notes ?? 0,
+    docs: result.docs ?? 0,
+    kv: result.kv ?? 0,
+    total
+  };
+}
+__name(reembedAll, "reembedAll");
+async function reembedTable(db, embedding, table, batchSize, onProgress) {
+  const totalCount = db.prepare(
+    `SELECT COUNT(*) as c FROM ${table.textTable}`
+  ).get().c;
+  if (totalCount === 0) return 0;
+  const tempTable = `_reembed_${table.vectorTable}`;
+  db.exec(`DROP TABLE IF EXISTS ${tempTable}`);
+  db.exec(`CREATE TABLE ${tempTable} AS SELECT * FROM ${table.vectorTable} WHERE 0`);
+  const insertTemp = db.prepare(
+    `INSERT INTO ${tempTable} (${table.fkColumn}, embedding) VALUES (?, ?)`
+  );
+  let processed = 0;
+  try {
+    for (let offset = 0; offset < totalCount; offset += batchSize) {
+      const batch = db.prepare(
+        `SELECT * FROM ${table.textTable} LIMIT ? OFFSET ?`
+      ).all(batchSize, offset);
+      const texts = batch.map((r) => table.textBuilder(r));
+      const vectors = await embedding.embedBatch(texts);
+      db.transaction(() => {
+        for (let j = 0; j < batch.length; j++) {
+          insertTemp.run(batch[j][table.idColumn], vecToBuffer(vectors[j]));
+        }
+      });
+      processed += batch.length;
+      onProgress?.(table.name, processed, totalCount);
+    }
+    db.transaction(() => {
+      db.exec(`DELETE FROM ${table.vectorTable}`);
+      db.exec(`INSERT INTO ${table.vectorTable} SELECT * FROM ${tempTable}`);
+    });
+  } finally {
+    db.exec(`DROP TABLE IF EXISTS ${tempTable}`);
+  }
+  return processed;
+}
+__name(reembedTable, "reembedTable");
+async function rebuildHnsw(db, table, hnsw, vecs) {
+  vecs.clear();
+  hnsw.reinit();
+  const rows = db.prepare(
+    `SELECT ${table.fkColumn} as id, embedding FROM ${table.vectorTable}`
+  ).all();
+  for (const row of rows) {
+    const buf = Buffer.from(row.embedding);
+    const vec = new Float32Array(buf.buffer.slice(buf.byteOffset, buf.byteOffset + buf.byteLength));
+    hnsw.add(vec, row.id);
+    vecs.set(row.id, vec);
+  }
+}
+__name(rebuildHnsw, "rebuildHnsw");
+
 // src/services/watch.ts
 import * as fs2 from "fs";
 import * as path3 from "path";
@@ -1973,7 +1949,7 @@ function createWatcher(reindexFn, indexers, repoPath, options = {}) {
       customPatterns.push({ indexer, patterns: indexer.watchPatterns() });
     }
   }
-  function matchCustomIndexer(filePath) {
+  function matchCustomPlugin(filePath) {
     const rel = path3.relative(repoPath, filePath);
     for (const { indexer, patterns } of customPatterns) {
       for (const pattern of patterns) {
@@ -1982,7 +1958,7 @@ function createWatcher(reindexFn, indexers, repoPath, options = {}) {
     }
     return null;
   }
-  __name(matchCustomIndexer, "matchCustomIndexer");
+  __name(matchCustomPlugin, "matchCustomPlugin");
   function matchGlob(filePath, pattern) {
     if (pattern.startsWith("**/")) {
       const suffix = pattern.slice(3);
@@ -1997,7 +1973,7 @@ function createWatcher(reindexFn, indexers, repoPath, options = {}) {
   }
   __name(matchGlob, "matchGlob");
   let flushing = false;
-  async function flush() {
+  async function processPending() {
     if (flushing || pending.size === 0) return;
     flushing = true;
     try {
@@ -2006,7 +1982,7 @@ function createWatcher(reindexFn, indexers, repoPath, options = {}) {
       let needsReindex = false;
       for (const filePath of files) {
         const absPath = path3.resolve(repoPath, filePath);
-        const customIndexer = matchCustomIndexer(absPath);
+        const customIndexer = matchCustomPlugin(absPath);
         if (customIndexer && isWatchable(customIndexer)) {
           try {
             const handled = await customIndexer.onFileChange(absPath, detectEvent(absPath));
@@ -2033,11 +2009,11 @@ function createWatcher(reindexFn, indexers, repoPath, options = {}) {
     } finally {
       flushing = false;
       if (pending.size > 0) {
-        timer = setTimeout(() => flush(), debounceMs);
+        timer = setTimeout(() => processPending(), debounceMs);
       }
     }
   }
-  __name(flush, "flush");
+  __name(processPending, "processPending");
   function detectEvent(filePath) {
     try {
       fs2.accessSync(filePath);
@@ -2055,7 +2031,7 @@ function createWatcher(reindexFn, indexers, repoPath, options = {}) {
     }
     if (isIgnoredFile(path3.basename(filename))) return false;
     if (isSupported(filename)) return true;
-    if (matchCustomIndexer(path3.resolve(repoPath, filename))) return true;
+    if (matchCustomPlugin(path3.resolve(repoPath, filename))) return true;
     return false;
   }
   __name(shouldWatch, "shouldWatch");
@@ -2068,7 +2044,7 @@ function createWatcher(reindexFn, indexers, repoPath, options = {}) {
         if (!shouldWatch(filename)) return;
         pending.add(filename);
         if (timer) clearTimeout(timer);
-        timer = setTimeout(() => flush(), debounceMs);
+        timer = setTimeout(() => processPending(), debounceMs);
       });
       watcher.on("error", (err) => {
         onError?.(err instanceof Error ? err : new Error(String(err)));
@@ -2101,7 +2077,7 @@ var BrainBank = class extends EventEmitter {
   _config;
   _db;
   _embedding;
-  _registry = new IndexerRegistry();
+  _registry = new PluginRegistry();
   _searchAPI;
   _indexAPI;
   _initialized = false;
@@ -2117,28 +2093,28 @@ var BrainBank = class extends EventEmitter {
     super();
     this._config = resolveConfig(config);
   }
-  // ── Indexer registration ─────────────────────────
+  // ── Plugin registration ──────────────────────────
   /**
-   * Register an indexer. Chainable.
+   * Register a plugin. Chainable.
    *
    *   brain.use(code({ repoPath: '.' })).use(docs());
    */
-  use(indexer) {
+  use(plugin) {
     if (this._initialized)
-      throw new Error(`BrainBank: Cannot add indexer '${indexer.name}' after initialization. Call .use() before any operations.`);
-    this._registry.register(indexer);
+      throw new Error(`BrainBank: Cannot add plugin '${plugin.name}' after initialization. Call .use() before any operations.`);
+    this._registry.register(plugin);
     return this;
   }
-  /** Get the list of registered indexer names. */
-  get indexers() {
+  /** Get the list of registered plugin names. */
+  get plugins() {
     return this._registry.names;
   }
-  /** Check if an indexer is loaded. Also matches type prefix (e.g. 'code' matches 'code:frontend'). */
+  /** Check if a plugin is loaded. Also matches type prefix (e.g. 'code' matches 'code:frontend'). */
   has(name) {
     return this._registry.has(name);
   }
-  /** Get an indexer instance. Throws if not loaded. */
-  indexer(n) {
+  /** Get a plugin instance. Throws if not loaded. */
+  plugin(n) {
     return this._registry.get(n);
   }
   // ── Initialization ───────────────────────────────
@@ -2176,13 +2152,13 @@ var BrainBank = class extends EventEmitter {
   }
   async _runInitialize(options = {}) {
     if (this._initialized) return;
-    const early = await earlyInit(this._config, (e, d) => this.emit(e, d), options);
+    const initializer = new Initializer(this._config, (e, d) => this.emit(e, d));
+    const early = await initializer.early(options);
     this._db = early.db;
     this._embedding = early.embedding;
     this._kvHnsw = early.kvHnsw;
-    const late = await lateInit(
+    const late = await initializer.late(
       early,
-      this._config,
       this._registry,
       this._sharedHnsw,
       this._kvVecs,
@@ -2192,7 +2168,10 @@ var BrainBank = class extends EventEmitter {
       ...late,
       registry: this._registry,
       config: this._config,
-      searchDocs: /* @__PURE__ */ __name((q, o) => this.searchDocs(q, o), "searchDocs"),
+      getDocsPlugin: /* @__PURE__ */ __name(() => {
+        const docs = this._registry.get("docs");
+        return docs && isCollectionPlugin(docs) ? docs : void 0;
+      }, "getDocsPlugin"),
       collection: /* @__PURE__ */ __name((n) => this.collection(n), "collection")
     });
     this._indexAPI = new IndexAPI({
@@ -2201,7 +2180,7 @@ var BrainBank = class extends EventEmitter {
       emit: /* @__PURE__ */ __name((e, d) => this.emit(e, d), "emit")
     });
     this._initialized = true;
-    this.emit("initialized", { indexers: this.indexers });
+    this.emit("initialized", { plugins: this.plugins });
   }
   // ── Collections (KV) ────────────────────────────
   /**
@@ -2336,13 +2315,13 @@ var BrainBank = class extends EventEmitter {
   /** Get git history for a specific file. */
   async fileHistory(filePath, limit = 20) {
     await this.initialize();
-    const gitPlugin = this.indexer("git");
+    const gitPlugin = this.plugin("git");
     return gitPlugin.fileHistory(filePath, limit);
   }
   /** Get co-edit suggestions for a file. */
   coEdits(filePath, limit = 5) {
     this._requireInit("coEdits");
-    const gitPlugin = this.indexer("git");
+    const gitPlugin = this.plugin("git");
     return gitPlugin.suggestCoEdits(filePath, limit);
   }
   // ── Stats ────────────────────────────────────────
@@ -2444,11 +2423,10 @@ export {
   resolveConfig,
   Collection,
   HNSWIndex,
-  LocalEmbedding,
   searchMMR,
   VectorSearch,
   KeywordSearch,
   ContextBuilder,
   BrainBank
 };
-//# sourceMappingURL=chunk-MY36UPPQ.js.map
+//# sourceMappingURL=chunk-DI3H6JVZ.js.map