@lotargo/memory_plugin 1.5.2 → 1.6.0

package/mcp-server/tools/rag_tools.js

@@ -1,7 +1,14 @@
 import * as z from "zod/v4";
-import { optStr, defBool, defNum } from "./helpers.js";
+import { optStr, defBool, defNum, optNum } from "./helpers.js";
+import { MEMORY_DIR } from "../memory.js";
+import { registerSnapshotDir } from "../admin/snapshot.js";
+import { ensureExportsDir } from "../ingest/exporter.js";
 
 export function registerRagTools(server) {
+  // Restrict snapshot export/import paths to the plugin's own data directories.
+  registerSnapshotDir(ensureExportsDir());
+  registerSnapshotDir(MEMORY_DIR);
+
   server.registerTool(
     "ingest_document",
     {
@@ -118,6 +125,47 @@ export function registerRagTools(server) {
     }
   );
 
+  server.registerTool(
+    "reindex_knowledge_base",
+    {
+      description:
+        "Re-embed all existing documents in the RAG knowledge base with the active (or specified) embedding model and vector dimension. " +
+        "Use after switching the embedding model or vector dimension so previously stored vectors match the new configuration. " +
+        "Preserves documents, sections, FTS index, graph edges, and fact links.",
+      inputSchema: z.object({
+        model: optStr().describe("Embedding model to use (defaults to active config.embeddingModel)"),
+        dimension: optNum().describe(
+          "Fixed vector dimension (defaults to active config.vectorDimension; auto-detect if unset)"
+        ),
+      }),
+    },
+    async ({ model, dimension }) => {
+      const { reindexEmbeddings } = await import("../ingest/pipeline.js");
+      const result = await reindexEmbeddings({
+        model: model || null,
+        dimension: dimension !== undefined && dimension !== null ? dimension : null,
+      });
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(
+              {
+                status: "success",
+                reindexed: result.reindexed,
+                documentsAffected: result.documentsAffected,
+                model: result.model,
+                dimension: result.dimension || "auto",
+              },
+              null,
+              2
+            ),
+          },
+        ],
+      };
+    }
+  );
+
   server.registerTool(
     "manage_knowledge_base",
     {

package/opencode-plugin/index.js

@@ -1,51 +1,56 @@
-const { mkdir, cp, readdir } = await import("fs/promises");
-const { existsSync } = await import("fs");
-const { join, dirname } = await import("path");
-const { homedir } = await import("os");
-const { fileURLToPath } = await import("url");
-const {
+// Static ESM imports: top-level `await import(...)` blocked module evaluation
+// and made this file an async module for every consumer.
+import { mkdir, cp, readdir } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { homedir } from "node:os";
+import { fileURLToPath } from "node:url";
+import {
   parseFactEntry,
   factText,
   factMeta,
-  withMeta,
-  nextFactId,
-  isKeepFact,
   isSuperseded,
   displayFact,
-  formatFactEntry,
-  matchesQuery,
-  matchesTags,
-  inDateRange,
   factTitle,
   factBody,
-  autoGenerateTitle,
   metaBadges,
-} = await import("../mcp-server/fact_format.js");
+} from "../mcp-server/fact_format.js";
 
-const {
+import {
   MEMORY_DIR,
   GLOBAL_KEY,
   canonicalPath,
-  projectName,
   projectKey,
   scopeKey,
   readMemory,
   writeMemory,
-  listProjectStores,
   storeFilePath,
-  today,
-} = await import("../mcp-server/memory.js");
-
-// Resolve a fact reference (1-based number, metadata id, or text) to an index.
-function resolveFactIndex(entries, ref) {
-  const trimmed = String(ref || "").trim();
-  if (!trimmed) return -1;
-  const num = parseInt(trimmed, 10);
-  if (/^\d+$/.test(trimmed) && num >= 1 && num <= entries.length) return num - 1;
-  const idIdx = entries.findIndex((e) => factMeta(e).id === trimmed);
-  if (idIdx !== -1) return idIdx;
-  const textIdx = entries.findIndex((e) => factText(e).toLowerCase().includes(trimmed.toLowerCase()));
-  return textIdx;
+} from "../mcp-server/memory.js";
+
+import { closeDatabase } from "../mcp-server/db/database.js";
+import { requireProjectKey } from "../mcp-server/tools/helpers.js";
+// Shared Notebook tool implementations — the same code the MCP server runs, so
+// a fix in one surface can no longer miss the other.
+import {
+  rememberFact,
+  recallFacts,
+  getFactById,
+  forgetFacts,
+  updateFactText,
+  memoryInfo,
+} from "../mcp-server/tools/core/memory_core.js";
+
+// Registered once when the plugin is instantiated, never at import time:
+// importing this module repeatedly used to stack duplicate "exit" listeners.
+let exitHookInstalled = false;
+function installExitHook() {
+  if (exitHookInstalled) return;
+  exitHookInstalled = true;
+  process.on("exit", () => {
+    try {
+      closeDatabase();
+    } catch {}
+  });
 }
 
 const CONFIG_DIR = process.env.OPENCODE_CONFIG_DIR || join(homedir(), ".config", "opencode");
@@ -109,16 +114,6 @@ const MEMORY_INSTRUCTION =
   "When saving, translate the fact into clear, concise English.\n" +
   "Use `scope: \"global\"` for personal facts, `scope: \"project\"` for project-specific facts.";
 
-function requireProjectKey(key) {
-  if (!key) {
-    throw new Error(
-      "No project memory available: this directory is not inside a git repository. " +
-      "Project memory is tied to a git repo; use scope: 'global' or open a git repository."
-    );
-  }
-  return key;
-}
-
 function sortNewestFirst(entries) {
   return [...entries].sort((a, b) => {
     const pa = parseFactEntry(a);
@@ -205,6 +200,7 @@ const MCP_SERVERS = [
 ];
 
 export const MemoryPlugin = async ({ directory, worktree, client }) => {
+  installExitHook();
   await ensureDir();
   let activeProjectKey = await scopeKey("project", worktree, directory);
   let identityResolveAt = 0;
@@ -302,79 +298,13 @@ export const MemoryPlugin = async ({ directory, worktree, client }) => {
           tags: { type: "string", description: "Optional comma-separated tags, e.g. \x27pref,arch\x27" },
           supersedes: { type: "string", description: "Optional number, id, or text of the fact this one replaces" },
         },
-        async execute({ fact, title, scope, docId, startLine, endLine, relationType, ttl, keep, tags, supersedes }, { worktree, directory }) {
-          const key = requireProjectKey(await scopeKey(scope || "project", worktree, directory));
-          const entries = await readMemory(key);
-
-          const explicitTitle = title ? title.trim() : null;
-          let finalTitle = explicitTitle;
-          let finalFact = fact.trim();
-
-          // If fact already contains a title pattern, extract it
-          const titleMatch = /^\\*\\*([^\x2a]+)\\*\\*\\s*(?:—|--|-|:)?\\s*(.*)$/.exec(finalFact);
-          if (titleMatch) {
-            if (!finalTitle) {
-              finalTitle = titleMatch[1].trim();
-            }
-            finalFact = titleMatch[2].trim();
-          }
-
-          if (!finalTitle) {
-            finalTitle = autoGenerateTitle(finalFact);
-          }
-
-          const text = `**${finalTitle}** — ${finalFact}`;
-          const factBodyNormalized = finalFact.toLowerCase();
-          const duplicate = entries.some((e) => factBody(e).toLowerCase().trim() === factBodyNormalized);
-
-          let supersededInfo = "";
-          if (!duplicate) {
-            const [date, time] = today().split(" ");
-            const meta = { ttl, tags };
-            if (keep) meta.keep = "1";
-            if (supersedes) {
-              const targetIdx = resolveFactIndex(entries, supersedes);
-              if (targetIdx !== -1) {
-                const newId = nextFactId(entries);
-                const targetMeta = factMeta(entries[targetIdx]);
-                const targetId = targetMeta.id || nextFactId(entries);
-                entries[targetIdx] = withMeta(entries[targetIdx], { id: targetId, supersededBy: newId });
-                meta.id = newId;
-                meta.supersedes = targetId;
-                supersededInfo = ` [superseded: "${factText(entries[targetIdx]).slice(0, 60)}"]`;
-              } else {
-                supersededInfo = " (note: supersedes target not found)";
-              }
-            }
-            if (!meta.id) meta.id = nextFactId(entries);
-            entries.push(formatFactEntry({ date, time, text, meta }));
-            await writeMemory(key, entries);
-          }
-
-          let linkInfo = "";
-          if (docId) {
-            try {
-              const { linkFactToDocument } = await import("../mcp-server/graph/knowledge_linker.js");
-              const linkRes = linkFactToDocument({
-                factKey: key,
-                factText: finalFact,
-                docId,
-                startLine,
-                endLine,
-                relationType: relationType || "LINKS_TO",
-              });
-              const linesStr = startLine ? `:L${startLine}${endLine ? `-${endLine}` : ""}` : "";
-              linkInfo = ` [Linked to Doc: "${linkRes.docTitle}"${linesStr}]`;
-            } catch (err) {
-              linkInfo = ` (Note: Fact saved, but document link failed: ${err.message})`;
-            }
-          }
-
-          const result = "Memory updated" + supersededInfo + linkInfo;
+        async execute(args, { worktree, directory }) {
+          const result = await rememberFact(args, { worktree, directory });
           await notify(client, result);
           return result;
         },
       },
+
 "recall": {
         description:
           "Show saved facts with any Agent-linked Knowledge Base documents/lines. " +
@@ -397,154 +327,19 @@ export const MemoryPlugin = async ({ directory, worktree, client }) => {
           offset: { type: "number", description: "Pagination offset (optional)" },
           limit: { type: "number", description: "Pagination limit (optional)" },
         },
-        async execute({ scope, project, query, tags, since, until, mode, offset, limit }, { worktree, directory }) {
-          const results = [];
-          const now = Date.now();
-          const targetMode = mode || "full";
-          const targetOffset = offset !== undefined ? offset : 0;
-
-          let getLinksForFact;
-          try {
-            const linker = await import("../mcp-server/graph/knowledge_linker.js");
-            getLinksForFact = linker.getLinksForFact;
-          } catch (e) {}
-
-          const formatFactWithLinks = async (factLine, index, key) => {
-            const p = parseFactEntry(factLine);
-            if (!p) return factLine;
-
-            const title = factTitle(factLine);
-            const body = factBody(factLine);
-            const meta = p.meta;
-
-            const badges = [];
-            if (isExpiredLine(factLine, now)) badges.push("EXPIRED");
-            if (isKeepFact(factLine)) badges.push("KEEP");
-            if (isSuperseded(factLine)) badges.push("SUPERSEDED");
-            if (meta.inject === "1") badges.push("INJECT");
-            if (meta.id) badges.push(`id:${meta.id}`);
-            if (meta.tags) badges.push(`tags:${meta.tags}`);
-            badges.push(`${p.date} ${p.time}`);
-
-            const badgesStr = badges.length ? ` [${badges.join("] [")}]` : "";
-
-            let lineText;
-            if (targetMode === "headers") {
-              lineText = `**${title}**${badgesStr}`;
-            } else {
-              lineText = p.text;
-            }
-
-            if (getLinksForFact) {
-              try {
-                const links = await getLinksForFact(key, p.text);
-                if (links && links.length > 0) {
-                  const docStr = links
-                    .map((l) => {
-                      const range = l.start_line ? `:L${l.start_line}${l.end_line ? `-${l.end_line}` : ""}` : "";
-                      return `${l.doc_title || l.doc_path}${range}`;
-                    })
-                    .join(", ");
-                  lineText += ` 🔗 [Linked Docs: ${docStr}]`;
-                }
-              } catch (e) {}
-            }
-            return `${index}. ${lineText}`;
-          };
-
-          const target = project ? canonicalPath(project) : await projectKey(worktree, directory);
-          const label = project ? target : await projectName(worktree, directory);
-
-          const collect = async (entries, key) => {
-            const matched = entries.filter(
-              (e) => matchesQuery(e, query) && matchesTags(e, tags) && inDateRange(e, since, until)
-            );
-            if (!matched.length) return;
-            if (results.length) results.push("");
-            results.push(`--- ${key === GLOBAL_KEY ? "Global" : `Project: ${key === target ? label : key}`} ---`);
-
-            const targetLimit = limit !== undefined ? limit : matched.length;
-
-            const paginated = matched.slice(targetOffset, targetOffset + targetLimit);
-            for (let i = 0; i < paginated.length; i++) {
-              results.push(await formatFactWithLinks(paginated[i], targetOffset + i + 1, key));
-            }
-
-            if (limit !== undefined && matched.length > targetLimit) {
-              results.push(`Showing entries ${targetOffset + 1}-${Math.min(targetOffset + targetLimit, matched.length)} of ${matched.length}`);
-            }
-            results.push(`Store file: ${storeFilePath(key)}`);
-          };
-
-          if (scope === "list_projects") {
-            return listProjectStores().then((stores) => {
-              if (!stores.length) return "No project memory stores found.";
-              const lines = stores.map(
-                (s, i) => `${i + 1}. ${s.basename} — ${s.count} fact(s) [${s.file}]${s.path ? ` (bound to ${s.path})` : " (unbound legacy store)"}`
-              );
-              return `Project Memory Stores:\n${lines.join("\n")}\n\nUse recall(scope: "project", project: "<path>") to read a specific store.\n\nMemory dir: ${MEMORY_DIR}`;
-            });
-          }
-
-          if (scope !== "project") {
-            const global = await readMemory(GLOBAL_KEY);
-            await collect(global, GLOBAL_KEY);
-          }
-          if (scope !== "global") {
-            const local = await readMemory(target);
-            await collect(local, target);
-          }
-          const filtered = Boolean(query || tags || since || until);
-          if (!results.length) return filtered ? "No facts match the search." : "Memory is empty.";
-          return results.join("\n") + `\n\nMemory dir: ${MEMORY_DIR}`;
+        async execute(args, { worktree, directory }) {
+          return await recallFacts(args, { worktree, directory });
         },
       },
+
 "get_fact": {
         description: "Get the full text and metadata of a single fact by its metadata id.",
         args: {
           id: { type: "string", description: "The unique metadata id of the fact (e.g. \x278f3a2c\x27)" },
           scope: { type: "string", description: "\x27project\x27, \x27global\x27, or \x27all\x27 (default)", default: "all" },
         },
-        async execute({ id, scope }, { worktree, directory }) {
-          const results = [];
-          const targetId = String(id || "").trim();
-          if (!targetId) throw new Error("ID parameter is required.");
-
-          const check = async (key) => {
-            const entries = await readMemory(key);
-            const match = entries.find((e) => factMeta(e).id === targetId);
-            if (match) {
-              const title = factTitle(match);
-              const body = factBody(match);
-              const meta = factMeta(match);
-              results.push({
-                key,
-                title,
-                body,
-                meta,
-                line: match
-              });
-            }
-          };
-
-          if (scope !== "project") {
-            await check(GLOBAL_KEY);
-          }
-          if (scope !== "global") {
-            const target = await projectKey(worktree, directory);
-            await check(target);
-          }
-
-          if (!results.length) {
-            return `Fact with ID "${targetId}" not found.`;
-          }
-
-          const lines = results.map((r) => {
-            const metaStr = Object.entries(r.meta).map(([k, v]) => `${k}:${v}`).join(", ");
-            return `[Store: ${r.key === GLOBAL_KEY ? "Global" : "Project"}]\nTitle: ${r.title}\nBody: ${r.body}\nMetadata: ${metaStr ? `<!-- ${metaStr} -->` : "none"}`;
-          });
-
-          return lines.join("\n\n");
+        async execute(args, { worktree, directory }) {
+          return await getFactById(args, { worktree, directory });
         },
       },
       "forget": {
@@ -558,37 +353,9 @@ export const MemoryPlugin = async ({ directory, worktree, client }) => {
           },
           force: { type: "boolean", description: "Удалить также защищённые (keep) факты" },
         },
-        async execute({ query, scope, force }, { worktree, directory }) {
-          const key = requireProjectKey(await scopeKey(scope || "project", worktree, directory));
-          const entries = await readMemory(key);
-          const rangeMatch = /^\s*(\d+)\s*-\s*(\d+)\s*$/.exec(query);
-          const num = parseInt(query, 10);
-          let indices = [];
-          if (rangeMatch) {
-            const from = parseInt(rangeMatch[1], 10);
-            const to = parseInt(rangeMatch[2], 10);
-            if (from > 0 && to >= from && to <= entries.length) {
-              for (let i = from - 1; i < to; i++) indices.push(i);
-            }
-          }
-          if (!indices.length && !isNaN(num) && num > 0 && num <= entries.length) {
-            indices.push(num - 1);
-          }
-          if (!indices.length) {
-            const q = query.toLowerCase();
-            indices = entries.reduce((acc, e, i) => (e.toLowerCase().includes(q) ? acc.concat(i) : acc), []);
-          }
-          if (!indices.length) return "Not found.";
-
-          const removable = indices.filter((i) => force || !isKeepFact(entries[i]));
-          const protectedCount = indices.length - removable.length;
-          if (removable.length) {
-            for (const i of removable.sort((a, b) => b - a)) entries.splice(i, 1);
-            await writeMemory(key, entries);
-          }
-          let result = removable.length ? "Memory updated" : "Nothing removed.";
-          if (protectedCount) result += ` (${protectedCount} protected fact(s) skipped; use force=true to override)`;
-          if (removable.length) await notify(client, result);
+        async execute(args, { worktree, directory }) {
+          const result = await forgetFacts(args, { worktree, directory });
+          if (result.startsWith("Memory updated")) await notify(client, result);
           return result;
         },
       },
@@ -602,109 +369,18 @@ export const MemoryPlugin = async ({ directory, worktree, client }) => {
           title: { type: "string", description: "Optional new title for the fact" },
           scope: { type: "string", description: "\x27project\x27 (default) or \x27global\x27", default: "project" },
         },
-        async execute({ id, newText, title, scope }, { worktree, directory }) {
-          const key = requireProjectKey(await scopeKey(scope || "project", worktree, directory));
-          const entries = await readMemory(key);
-          const idx = resolveFactIndex(entries, id);
-          if (idx === -1) throw new Error(`Fact not found: ${id}`);
-          const p = parseFactEntry(entries[idx]);
-          const oldText = p ? p.text : entries[idx];
-          const oldBody = factBody(entries[idx]) || oldText;
-
-          const explicitTitle = title ? title.trim() : null;
-          let finalTitle = explicitTitle;
-          let finalFact = newText.trim();
-
-          // Check if newText has a title
-          const titleMatch = /^\\*\\*([^\x2a]+)\\*\\*\\s*(?:—|--|-|:)?\\s*(.*)$/.exec(finalFact);
-          if (titleMatch) {
-            if (!finalTitle) {
-              finalTitle = titleMatch[1].trim();
-            }
-            finalFact = titleMatch[2].trim();
-          }
-
-          // If no new title is specified, preserve the old title
-          if (!finalTitle) {
-            finalTitle = factTitle(entries[idx]) || autoGenerateTitle(finalFact);
-          }
-
-          const newTextFormatted = `**${finalTitle}** — ${finalFact}`;
-          const newLine = formatFactEntry({ date: p.date, time: p.time, text: newTextFormatted, meta: p.meta });
-          entries[idx] = newLine;
-          await writeMemory(key, entries);
-
-          let linksUpdated = 0;
-          try {
-            const { getDatabase } = await import("../mcp-server/db/database.js");
-            const db = await getDatabase();
-            const res = db
-              .prepare("UPDATE knowledge_links SET fact_text = ? WHERE fact_key = ? AND fact_text = ?")
-              .run(finalFact, key, oldBody);
-            linksUpdated = res.changes;
-          } catch (e) {}
-
-          const result = `Fact updated${linksUpdated ? `, ${linksUpdated} doc link(s) updated` : ""}`;
+        async execute(args, { worktree, directory }) {
+          const result = await updateFactText(args, { worktree, directory });
           await notify(client, result);
           return result;
         },
       },
+
 "memory_info": {
         description: "Show memory storage paths (store files, MEMORY_DIR, SQLite DB), fact counts, and Knowledge Base stats.",
         args: {},
-        async execute() {
-          const dbPath = join(MEMORY_DIR, "storage", "memory.sqlite");
-          let version = "unknown";
-          try {
-            const { readFile } = await import("fs/promises");
-            version = JSON.parse(
-              await readFile(new URL("../package.json", import.meta.url), "utf-8")
-            ).version;
-          } catch (e) {}
-
-          let rag = {};
-          try {
-            const { getDatabase } = await import("../mcp-server/db/database.js");
-            const db = getDatabase();
-            rag.documents = db.prepare("SELECT COUNT(*) AS c FROM documents").get().c;
-            rag.sections = db.prepare("SELECT COUNT(*) AS c FROM sections").get().c;
-            rag.chunks = db.prepare("SELECT COUNT(*) AS c FROM micro_chunks").get().c;
-            rag.edges = db.prepare("SELECT COUNT(*) AS c FROM graph_edges").get().c;
-            rag.links = db.prepare("SELECT COUNT(*) AS c FROM knowledge_links").get().c;
-          } catch (e) {
-            rag.error = e.message;
-          }
-
-          let identityLines = [];
-          try {
-            const { getDatabase } = await import("../mcp-server/db/database.js");
-            const { resolveProjectIdentity, listIdentities } = await import("../mcp-server/identity.js");
-            const db = getDatabase();
-            const identity = await resolveProjectIdentity(directory || process.cwd());
-            const all = await listIdentities(db);
-            identityLines.push(
-              `Identity: ${identity ? "git" : "no-git"}` +
-                (identity ? ` | key: ${identity.key} | name: ${identity.name}${identity.primaryRemote ? ` | remote: ${identity.primaryRemote}` : ""}` : ""),
-              `Known identities: ${all.length}`
-            );
-          } catch (e) {
-            identityLines.push(`Identity: unavailable (${e.message})`);
-          }
-
-          const lines = [
-            `Version: ${version}`,
-            `MEMORY_DIR: ${MEMORY_DIR}`,
-            `SQLite DB: ${dbPath}`,
-            `Global store: ${storeFilePath(GLOBAL_KEY)}`,
-            `Project store: ${storeFilePath(activeProjectKey)}`,
-            ...identityLines,
-          ];
-          if (rag.error) lines.push(`RAG: unavailable (${rag.error})`);
-          else
-            lines.push(
-              `RAG: ${rag.documents} doc(s), ${rag.sections} section(s), ${rag.chunks} chunk(s), ${rag.edges} edge(s), ${rag.links} memory link(s)`
-            );
-          return lines.join("\n");
+        async execute(_args, ctx = {}) {
+          return await memoryInfo({}, { worktree: ctx.worktree ?? worktree, directory: ctx.directory ?? directory });
         },
       },
       "link_knowledge": {
@@ -741,7 +417,7 @@ export const MemoryPlugin = async ({ directory, worktree, client }) => {
             if (!factText || !docId) {
               throw new Error("factText and docId are required parameters for link action");
             }
-            const res = linkFactToDocument({
+            const res = await linkFactToDocument({
               factKey: key,
               factText,
               docId,
@@ -754,12 +430,12 @@ export const MemoryPlugin = async ({ directory, worktree, client }) => {
 
           if (act === "get_doc_links") {
             if (!docId) throw new Error("docId parameter is required for get_doc_links action");
-            const links = getLinksForDoc(docId);
+            const links = await getLinksForDoc(docId);
             return JSON.stringify(links, null, 2);
           }
 
           if (act === "list_links") {
-            const links = listAllLinks(key);
+            const links = await listAllLinks(key);
             return JSON.stringify(links, null, 2);
           }
 
@@ -864,13 +540,17 @@ export const MemoryPlugin = async ({ directory, worktree, client }) => {
         },
         async execute({ action, docId, snapshotPath }) {
           const { getDatabase } = await import("../mcp-server/db/database.js");
-          const db = getDatabase();
+          const db = await getDatabase();
 
           if (action === "stats") {
-            const docCount = db.prepare("SELECT COUNT(*) as cnt FROM documents").get().cnt;
-            const secCount = db.prepare("SELECT COUNT(*) as cnt FROM sections").get().cnt;
-            const chunkCount = db.prepare("SELECT COUNT(*) as cnt FROM micro_chunks").get().cnt;
-            const edgeCount = db.prepare("SELECT COUNT(*) as cnt FROM graph_edges").get().cnt;
+            const docCountRow = await db.prepare("SELECT COUNT(*) as cnt FROM documents").get();
+            const docCount = docCountRow ? docCountRow.cnt : 0;
+            const secCountRow = await db.prepare("SELECT COUNT(*) as cnt FROM sections").get();
+            const secCount = secCountRow ? secCountRow.cnt : 0;
+            const chunkCountRow = await db.prepare("SELECT COUNT(*) as cnt FROM micro_chunks").get();
+            const chunkCount = chunkCountRow ? chunkCountRow.cnt : 0;
+            const edgeCountRow = await db.prepare("SELECT COUNT(*) as cnt FROM graph_edges").get();
+            const edgeCount = edgeCountRow ? edgeCountRow.cnt : 0;
             return JSON.stringify(
               {
                 documents: docCount,
@@ -884,7 +564,7 @@ export const MemoryPlugin = async ({ directory, worktree, client }) => {
           }
 
           if (action === "list") {
-            const docs = db
+            const docs = await db
               .prepare("SELECT id, title, path, blob_hash, created_at FROM documents ORDER BY created_at DESC")
               .all();
             return JSON.stringify(docs, null, 2);
@@ -892,7 +572,7 @@ export const MemoryPlugin = async ({ directory, worktree, client }) => {
 
           if (action === "read_document") {
             if (!docId) throw new Error("docId parameter is required for read_document action");
-            const doc = db
+            const doc = await db
               .prepare("SELECT id, title, path, blob_hash, created_at FROM documents WHERE id = ? OR path = ? OR title = ?")
               .get(docId, docId, docId);
             if (!doc) {
@@ -938,6 +618,34 @@ export const MemoryPlugin = async ({ directory, worktree, client }) => {
           throw new Error(`Unknown action: ${action}`);
         },
       },
+      "reindex_knowledge_base": {
+        description:
+          "Re-embed all existing documents in the RAG knowledge base with the active (or specified) embedding model and vector dimension. " +
+          "Use after switching the embedding model or vector dimension so previously stored vectors match the new configuration. " +
+          "Preserves documents, sections, FTS index, graph edges, and fact links.",
+        args: {
+          model: { type: "string", description: "Embedding model to use (defaults to active config.embeddingModel)" },
+          dimension: { type: "number", description: "Fixed vector dimension (defaults to active config.vectorDimension; auto-detect if unset)" },
+        },
+        async execute({ model, dimension }) {
+          const { reindexEmbeddings } = await import("../mcp-server/ingest/pipeline.js");
+          const result = await reindexEmbeddings({
+            model: model || null,
+            dimension: dimension !== undefined && dimension !== null ? dimension : null,
+          });
+          return JSON.stringify(
+            {
+              status: "success",
+              reindexed: result.reindexed,
+              documentsAffected: result.documentsAffected,
+              model: result.model,
+              dimension: result.dimension || "auto",
+            },
+            null,
+            2
+          );
+        },
+      },
       "link_project_memory": {
         description: "Link the current directory to a Git-based project identity, register aliases, and optionally migrate legacy/path stores.",
         args: {