@lotargo/memory_plugin 1.6.4 → 1.6.6

package/opencode-plugin/index.js

@@ -152,254 +152,269 @@ export function formatInjectedFacts(entries, limit, now = Date.now()) {
   const formattedLines = [];
   for (let i = 0; i < sliced.length; i++) {
     formattedLines.push(`${i + 1}. ${displayFact(sliced[i], now)}`);
-  }
-
+  }
+
   if (hasLimit && activeEntries.length > Number(limit)) {
     const remaining = activeEntries.length - Number(limit);
-    formattedLines.push(`... and ${remaining} more of ${activeEntries.length} memories (use recall tool to fetch all)`);
-  }
-
-  return formattedLines.join("\n");
-}
-
+    formattedLines.push(`... and ${remaining} more of ${activeEntries.length} memories (use recall tool to fetch all)`);
+  }
+
+  return formattedLines.join("\n");
+}
+
 export function buildMemoryContext(globalFacts, projectFacts, projectKey, injectLimit, now = Date.now()) {
-  const parts = [MEMORY_INSTRUCTION];
-
-  if (globalFacts.length) {
-    const formatted = formatInjectedFacts(globalFacts, injectLimit, now);
-    if (formatted) parts.push("## Global\n" + formatted);
-  }
-  if (projectFacts.length) {
-    const formatted = formatInjectedFacts(projectFacts, injectLimit, now);
-    if (formatted) parts.push(`## Project: ${projectKey}\n` + formatted);
-  }
-  return `<MEMORY>\n${parts.join("\n\n")}\n</MEMORY>`;
-}
-
-const MCP_SERVERS = [
-  { id: "context7", desc: "Документация библиотек и фреймворков (Context7)" },
-  { id: "supabase", desc: "БД Supabase — SQL, миграции, edge functions" },
-  { id: "stitch", desc: "UI дизайн — генерация и редактирование экранов" },
-  { id: "neon", desc: "БД Neon — PostgreSQL, схемы, миграции" },
-  { id: "linear", desc: "Linear — задачи, проекты, документы" },
-  { id: "grep", desc: "Поиск примеров кода на GitHub" },
-  { id: "skills-anthropic", desc: "Скиллы Anthropic — дизайн, доки, MCP, PDF/PPTX/XLSX" },
-  { id: "skills-vercel", desc: "Скиллы mattpocock — engineering workflow (grill, tdd, triage, architecture)" },
-  { id: "playwright", desc: "Браузерные тесты — навигация, скриншоты, клики" },
-  { id: "github", desc: "GitHub API — PRs, issues, репозитории" },
-];
-
-export const MemoryPlugin = async ({ directory, worktree, client }) => {
-  installExitHook();
-  await ensureDir();
-  let activeProjectKey = await scopeKey("project", worktree, directory);
-  let identityResolveAt = 0;
-
-  const currentProjectKey = async () => {
-    const now = Date.now();
-    if (now < identityResolveAt) return activeProjectKey;
-    identityResolveAt = now + 2000;
-    try {
-      const path = client?.path?.get ? await client.path.get() : null;
-      const wt = path?.worktree || worktree;
-      const dir = path?.directory || directory;
-      const key = await scopeKey("project", wt, dir);
-      if (key !== activeProjectKey) activeProjectKey = key;
-    } catch (e) {}
-    return activeProjectKey;
-  };
-
-  return {
-    "experimental.chat.messages.transform": async (_input, output) => {
-      if (!output.messages?.length) return;
-      const firstUser = output.messages.find((m) => m?.info?.role === "user");
-      if (!firstUser?.parts?.length) return;
-
-      if (firstUser.parts.some((p) => p.type === "text" && p.text.includes("<MEMORY>"))) return;
-
-      const [globalFacts, projectFacts] = await Promise.all([
-        readMemory(GLOBAL_KEY),
-        readMemory(await currentProjectKey()),
-      ]);
-
+  const parts = [MEMORY_INSTRUCTION];
+
+  if (globalFacts.length) {
+    const formatted = formatInjectedFacts(globalFacts, injectLimit, now);
+    if (formatted) parts.push("## Global\n" + formatted);
+  }
+  if (projectFacts.length) {
+    const formatted = formatInjectedFacts(projectFacts, injectLimit, now);
+    if (formatted) parts.push(`## Project: ${projectKey}\n` + formatted);
+  }
+  return `<MEMORY>\n${parts.join("\n\n")}\n</MEMORY>`;
+}
+
+const MCP_SERVERS = [
+  { id: "context7", desc: "Документация библиотек и фреймворков (Context7)" },
+  { id: "supabase", desc: "БД Supabase — SQL, миграции, edge functions" },
+  { id: "stitch", desc: "UI дизайн — генерация и редактирование экранов" },
+  { id: "neon", desc: "БД Neon — PostgreSQL, схемы, миграции" },
+  { id: "linear", desc: "Linear — задачи, проекты, документы" },
+  { id: "grep", desc: "Поиск примеров кода на GitHub" },
+  { id: "skills-anthropic", desc: "Скиллы Anthropic — дизайн, доки, MCP, PDF/PPTX/XLSX" },
+  { id: "skills-vercel", desc: "Скиллы mattpocock — engineering workflow (grill, tdd, triage, architecture)" },
+  { id: "playwright", desc: "Браузерные тесты — навигация, скриншоты, клики" },
+  { id: "github", desc: "GitHub API — PRs, issues, репозитории" },
+];
+
+export const MemoryPlugin = async ({ directory, worktree, client }) => {
+  installExitHook();
+  await ensureDir();
+  let activeProjectKey = await scopeKey("project", worktree, directory);
+  let identityResolveAt = 0;
+
+  const currentProjectKey = async () => {
+    const now = Date.now();
+    if (now < identityResolveAt) return activeProjectKey;
+    identityResolveAt = now + 2000;
+    try {
+      const path = client?.path?.get ? await client.path.get() : null;
+      const wt = path?.worktree || worktree;
+      const dir = path?.directory || directory;
+      const key = await scopeKey("project", wt, dir);
+      if (key !== activeProjectKey) activeProjectKey = key;
+    } catch (e) {}
+    return activeProjectKey;
+  };
+
+  return {
+    "experimental.chat.messages.transform": async (_input, output) => {
+      if (!output.messages?.length) return;
+      const firstUser = output.messages.find((m) => m?.info?.role === "user");
+      if (!firstUser?.parts?.length) return;
+
+      if (firstUser.parts.some((p) => p.type === "text" && p.text.includes("<MEMORY>"))) return;
+
+      const [globalFacts, projectFacts] = await Promise.all([
+        readMemory(GLOBAL_KEY),
+        readMemory(await currentProjectKey()),
+      ]);
+
       const context = buildMemoryContext(globalFacts, projectFacts, activeProjectKey, null);
-      const ref = firstUser.parts[0];
-      firstUser.parts.unshift({ ...ref, type: "text", text: context });
-    },
-
-    tool: {
-      "list-mcp-tools": {
-        description: "Показать список всех подключённых MCP серверов и их назначение",
-        args: {},
-        async execute() {
-          const lines = MCP_SERVERS.map((s) => `  ${s.id.padEnd(20)} ${s.desc}`);
-          return "Доступные MCP серверы:\n" + lines.join("\n");
-        },
-      },
-      "mcp-reminder": {
-        description: "Напомнить какие MCP инструменты подходят для текущей задачи. Вызови когда сомневаешься что выбрать.",
-        args: {
-          task: {
-            type: "string",
-            description: "Описание того что собираешься делать (опционально)",
-          },
-        },
-        async execute({ task }) {
-          if (task) {
-            return `Для задачи "${task}" рекомендую посмотреть список через list-mcp-tools. Основные сценарии:\n- Работа с кодом → skills-vercel (grill, tdd, review), github\n- UI/дизайн → stitch, skills-anthropic (frontend-design, webapp-testing)\n- База данных → supabase, neon\n- Документы → skills-anthropic (docx, pdf, pptx, xlsx)\n- Поиск примеров → grep`;
-          }
-          return "Вызови list-mcp-tools чтобы увидеть все доступные MCP серверы";
-        },
-      },
-      "remember": {
-        description:
-          "Save an important, durable fact to memory. Only use for high-signal information " +
-          "(name, goals, constraints, tech preferences, project conventions). " +
-          "docId/startLine/endLine/relationType are OPTIONAL and only used to link the fact to a " +
-          "Knowledge Base document or line range; omit them when no linking is needed. " +
-          "ttl is OPTIONAL (e.g. \x2790d\x27, \x272w\x27, \x2724h\x27) — expired facts are shown with [EXPIRED] but not auto-deleted. " +
-          "keep=true protects the fact from forget deletion unless force=true. " +
-          "tags is OPTIONAL comma-separated text for filtering. " +
-          "supersedes is OPTIONAL: a number, id, or text of a fact this one replaces. " +
-          "Translate the fact into English and keep it concise. " +
-          "scope: \x27project\x27 (default) or \x27global\x27",
-        args: {
-          fact: { type: "string", description: "The fact to remember, written in English" },
-          title: { type: "string", description: "Optional title for the fact" },
-          scope: {
-            type: "string",
-            description: "\x27project\x27 (default) or \x27global\x27",
-            default: "project",
-          },
-          docId: { type: "string", description: "Optional document ID, title, or path to link this fact to" },
-          startLine: { type: "number", description: "Optional starting line number in target document" },
-          endLine: { type: "number", description: "Optional ending line number in target document" },
-          relationType: {
-            type: "string",
-            description: "Relation type (e.g. \x27RULES_FOR\x27, \x27IMPLEMENTS\x27, \x27REFERENCES\x27)",
-            default: "LINKS_TO",
-          },
-          ttl: { type: "string", description: "Optional time-to-live, e.g. \x2790d\x27, \x272w\x27, \x2724h\x27, \x2712m\x27" },
-          keep: { type: "boolean", description: "Protect the fact from forget deletion unless force=true" },
-          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(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. " +
-          "scope: \x27project\x27, \x27global\x27, \x27all\x27 (default), or \x27list_projects\x27. " +
-          "Use project: \x27<directory path>\x27 to read facts of a specific project from any working directory. " +
-          "query filters by keyword, tags by comma-separated tags, since/until by date (YYYY-MM-DD). " +
-          "The response includes the store file paths.",
-        args: {
-          scope: {
-            type: "string",
-            description: "project, global, all (по умолчанию) или list_projects",
-            default: "all",
-          },
-          project: { type: "string", description: "Directory path of the project to read facts from (e.g. \x27F:/projects/plugins/memory\x27)" },
-          query: { type: "string", description: "Optional keyword filter; all space-separated terms must match" },
-          tags: { type: "string", description: "Optional comma-separated tag filter (any match)" },
-          since: { type: "string", description: "Optional start date filter, YYYY-MM-DD (inclusive)" },
-          until: { type: "string", description: "Optional end date filter, YYYY-MM-DD (inclusive)" },
-          mode: { type: "string", description: "Result mode: 'full' (with body, default) or 'headers' (title and badges only)", default: "full" },
-          offset: { type: "number", description: "Pagination offset (optional)" },
+      const ref = firstUser.parts[0];
+      firstUser.parts.unshift({ ...ref, type: "text", text: context });
+    },
+
+    tool: {
+      "list-mcp-tools": {
+        description: "Показать список всех подключённых MCP серверов и их назначение",
+        args: {},
+        async execute() {
+          const lines = MCP_SERVERS.map((s) => `  ${s.id.padEnd(20)} ${s.desc}`);
+          return "Доступные MCP серверы:\n" + lines.join("\n");
+        },
+      },
+      "mcp-reminder": {
+        description: "Напомнить какие MCP инструменты подходят для текущей задачи. Вызови когда сомневаешься что выбрать.",
+        args: {
+          task: {
+            type: "string",
+            description: "Описание того что собираешься делать (опционально)",
+          },
+        },
+        async execute({ task }) {
+          if (task) {
+            return `Для задачи "${task}" рекомендую посмотреть список через list-mcp-tools. Основные сценарии:\n- Работа с кодом → skills-vercel (grill, tdd, review), github\n- UI/дизайн → stitch, skills-anthropic (frontend-design, webapp-testing)\n- База данных → supabase, neon\n- Документы → skills-anthropic (docx, pdf, pptx, xlsx)\n- Поиск примеров → grep`;
+          }
+          return "Вызови list-mcp-tools чтобы увидеть все доступные MCP серверы";
+        },
+      },
+      "remember": {
+        description:
+          "Save an important, durable fact to memory. Only use for high-signal information " +
+          "(name, goals, constraints, tech preferences, project conventions). " +
+          "docId/startLine/endLine/relationType are OPTIONAL and only used to link the fact to a " +
+          "Knowledge Base document or line range; omit them when no linking is needed. " +
+          "ttl is OPTIONAL (e.g. \x2790d\x27, \x272w\x27, \x2724h\x27) — expired facts are shown with [EXPIRED] but not auto-deleted. " +
+          "keep=true protects the fact from forget deletion unless force=true. " +
+          "tags is OPTIONAL comma-separated text for filtering. " +
+          "supersedes is OPTIONAL: a number, id, or text of a fact this one replaces. " +
+          "Translate the fact into English and keep it concise. " +
+          "scope: \x27project\x27 (default) or \x27global\x27",
+        args: {
+          fact: { type: "string", description: "The fact to remember, written in English" },
+          title: { type: "string", description: "Optional title for the fact" },
+          scope: {
+            type: "string",
+            description: "\x27project\x27 (default) or \x27global\x27",
+            default: "project",
+          },
+          directory: { type: "string", description: "Optional workspace/project directory path to target when scope='project' (e.g. 'F:/projects/my-app')" },
+          project: { type: "string", description: "Alias for directory" },
+          docId: { type: "string", description: "Optional document ID, title, or path to link this fact to" },
+          startLine: { type: "number", description: "Optional starting line number in target document" },
+          endLine: { type: "number", description: "Optional ending line number in target document" },
+          relationType: {
+            type: "string",
+            description: "Relation type (e.g. \x27RULES_FOR\x27, \x27IMPLEMENTS\x27, \x27REFERENCES\x27)",
+            default: "LINKS_TO",
+          },
+          ttl: { type: "string", description: "Optional time-to-live, e.g. \x2790d\x27, \x272w\x27, \x2724h\x27, \x2712m\x27" },
+          keep: { type: "boolean", description: "Protect the fact from forget deletion unless force=true" },
+          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(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. " +
+          "scope: \x27project\x27, \x27global\x27, \x27all\x27 (default), or \x27list_projects\x27. " +
+          "Use directory: \x27<directory path>\x27 to read facts of a specific project from any working directory. " +
+          "query filters by keyword, tags by comma-separated tags, since/until by date (YYYY-MM-DD). " +
+          "The response includes the store file paths.",
+        args: {
+          scope: {
+            type: "string",
+            description: "project, global, all (по умолчанию) или list_projects",
+            default: "all",
+          },
+          directory: { type: "string", description: "Directory path of the project to read facts from (e.g. \x27F:/projects/plugins/memory\x27)" },
+          project: { type: "string", description: "Alias for directory" },
+          query: { type: "string", description: "Optional keyword filter; all space-separated terms must match" },
+          tags: { type: "string", description: "Optional comma-separated tag filter (any match)" },
+          since: { type: "string", description: "Optional start date filter, YYYY-MM-DD (inclusive)" },
+          until: { type: "string", description: "Optional end date filter, YYYY-MM-DD (inclusive)" },
+          mode: { type: "string", description: "Result mode: 'full' (with body, default) or 'headers' (title and badges only)", default: "full" },
+          offset: { type: "number", description: "Pagination offset (optional)" },
           limit: { type: "number", description: "Pagination limit (optional)" },
           includeSuperseded: { type: "boolean", description: "Include superseded historical facts (excluded by default)", default: false },
-        },
-        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(args, { worktree, directory }) {
-          return await getFactById(args, { worktree, directory });
-        },
-      },
-      "forget": {
-        description: "Удалить факт по номеру (см. recall), по диапазону (например '3-30', включительно) или тексту. Защищённые факты (remember с keep=true) пропускаются, если не передан force=true",
-        args: {
-          query: { type: "string", description: "Номер факта, диапазон вида '3-30' или текст для поиска" },
-          scope: {
-            type: "string",
-            description: "project (по умолчанию) или global",
-            default: "project",
-          },
-          force: { type: "boolean", description: "Удалить также защищённые (keep) факты" },
-        },
-        async execute(args, { worktree, directory }) {
-          const result = await forgetFacts(args, { worktree, directory });
-          if (result.startsWith("Memory updated")) await notify(client, result);
-          return result;
-        },
-      },
-      "update_fact": {
-        description:
-          "Update the text of an existing fact by number (from recall), id, or text match, " +
-          "preserving its original date and metadata. Linked Knowledge Base documents are re-pointed to the new text.",
-        args: {
-          id: { type: "string", description: "Number (from recall), metadata id, or text of the fact to update" },
-          newText: { type: "string", description: "New fact text" },
-          title: { type: "string", description: "Optional new title for the fact" },
-          scope: { type: "string", description: "\x27project\x27 (default) or \x27global\x27", default: "project" },
-        },
-        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(_args, ctx = {}) {
-          return await memoryInfo({}, { worktree: ctx.worktree ?? worktree, directory: ctx.directory ?? directory });
-        },
-      },
-      "link_knowledge": {
-        description:
-          "Explicitly link a Notebook memory fact to a Knowledge Base document, section, or line range. " +
-          "Creates Agent-driven Graph Edges connecting memory to RAG documents.",
-        args: {
-          action: {
-            type: "string",
-            description: "Action type: 'link' (default), 'list_links', 'get_doc_links'",
-            default: "link",
-          },
-          factText: { type: "string", description: "Memory fact text or keyword" },
-          docId: { type: "string", description: "Document ID, title, or file path" },
-          scope: { type: "string", description: "'project' (default) or 'global'", default: "project" },
-          startLine: { type: "number", description: "Starting line number in target document" },
-          endLine: { type: "number", description: "Ending line number in target document" },
-          relationType: {
-            type: "string",
-            description: "Relation type (e.g. 'RULES_FOR', 'IMPLEMENTS', 'EXPLAINS')",
-            default: "LINKS_TO",
-          },
-        },
-        async execute({ action, factText, docId, scope, startLine, endLine, relationType }, { worktree, directory }) {
-          const { linkFactToDocument, getLinksForDoc, listAllLinks } = await import("../mcp-server/graph/knowledge_linker.js");
-          const key = await scopeKey(scope || "project", worktree, directory);
-          const act = action || "link";
-
-          if (act === "link" || act === "list_links") {
-            requireProjectKey(key);
-          }
-
+        },
+        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" },
+          directory: { type: "string", description: "Optional workspace/project directory path" },
+          project: { type: "string", description: "Alias for directory" },
+        },
+        async execute(args, { worktree, directory }) {
+          return await getFactById(args, { worktree, directory });
+        },
+      },
+      "forget": {
+        description: "Удалить факт по номеру (см. recall), по диапазону (например '3-30', включительно) или тексту. Защищённые факты (remember с keep=true) пропускаются, если не передан force=true",
+        args: {
+          query: { type: "string", description: "Номер факта, диапазон вида '3-30' или текст для поиска" },
+          scope: {
+            type: "string",
+            description: "project (по умолчанию) или global",
+            default: "project",
+          },
+          directory: { type: "string", description: "Optional workspace/project directory path" },
+          project: { type: "string", description: "Alias for directory" },
+          force: { type: "boolean", description: "Удалить также защищённые (keep) факты" },
+        },
+        async execute(args, { worktree, directory }) {
+          const result = await forgetFacts(args, { worktree, directory });
+          if (result.startsWith("Memory updated")) await notify(client, result);
+          return result;
+        },
+      },
+      "update_fact": {
+        description:
+          "Update the text of an existing fact by number (from recall), id, or text match, " +
+          "preserving its original date and metadata. Linked Knowledge Base documents are re-pointed to the new text.",
+        args: {
+          id: { type: "string", description: "Number (from recall), metadata id, or text of the fact to update" },
+          newText: { type: "string", description: "New fact text" },
+          title: { type: "string", description: "Optional new title for the fact" },
+          scope: { type: "string", description: "\x27project\x27 (default) or \x27global\x27", default: "project" },
+          directory: { type: "string", description: "Optional workspace/project directory path" },
+          project: { type: "string", description: "Alias for directory" },
+        },
+        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: {
+          directory: { type: "string", description: "Optional workspace/project directory path to inspect (default: current directory)" },
+          project: { type: "string", description: "Alias for directory" },
+        },
+        async execute(args, ctx = {}) {
+          return await memoryInfo(args, { worktree: ctx.worktree ?? worktree, directory: ctx.directory ?? directory });
+        },
+      },
+      "link_knowledge": {
+        description:
+          "Explicitly link a Notebook memory fact to a Knowledge Base document, section, or line range. " +
+          "Creates Agent-driven Graph Edges connecting memory to RAG documents.",
+        args: {
+          action: {
+            type: "string",
+            description: "Action type: 'link' (default), 'list_links', 'get_doc_links'",
+            default: "link",
+          },
+          factText: { type: "string", description: "Memory fact text or keyword" },
+          docId: { type: "string", description: "Document ID, title, or file path" },
+          scope: { type: "string", description: "'project' (default) or 'global'", default: "project" },
+          directory: { type: "string", description: "Optional workspace/project directory path" },
+          project: { type: "string", description: "Alias for directory" },
+          startLine: { type: "number", description: "Starting line number in target document" },
+          endLine: { type: "number", description: "Ending line number in target document" },
+          relationType: {
+            type: "string",
+            description: "Relation type (e.g. 'RULES_FOR', 'IMPLEMENTS', 'EXPLAINS')",
+            default: "LINKS_TO",
+          },
+        },
+        async execute({ action, factText, docId, scope, directory, project, startLine, endLine, relationType }, { worktree, directory: ctxDir }) {
+          const { linkFactToDocument, getLinksForDoc, listAllLinks } = await import("../mcp-server/graph/knowledge_linker.js");
+          const effectiveDir = directory || project || ctxDir;
+          const key = await scopeKey(scope || "project", worktree, effectiveDir);
+          const act = action || "link";
+
+          if (act === "link" || act === "list_links") {
+            requireProjectKey(key);
+          }
+
           if (act === "link") {
             if (!factText || !docId) {
               throw new Error("factText and docId are required parameters for link action");
@@ -416,118 +431,124 @@ export const MemoryPlugin = async ({ directory, worktree, client }) => {
             const res = await linkFactToDocument({
               factKey: key,
               factText: resolvedFactText,
-              docId,
-              startLine,
-              endLine,
-              relationType: relationType || "LINKS_TO",
-            });
-            return JSON.stringify(res, null, 2);
-          }
-
+              docId,
+              startLine,
+              endLine,
+              relationType: relationType || "LINKS_TO",
+            });
+            return JSON.stringify(res, null, 2);
+          }
+
           if (act === "get_doc_links") {
             if (!docId) throw new Error("docId parameter is required for get_doc_links action");
             const allowedScopes = key === GLOBAL_KEY ? [GLOBAL_KEY] : [GLOBAL_KEY, key];
             const links = await getLinksForDoc(docId, allowedScopes);
-            return JSON.stringify(links, null, 2);
-          }
-
-          if (act === "list_links") {
-            const links = await listAllLinks(key);
-            return JSON.stringify(links, null, 2);
-          }
-
-          throw new Error(`Unknown action: ${act}`);
-        },
-      },
-      "ingest_document": {
+            return JSON.stringify(links, null, 2);
+          }
+
+          if (act === "list_links") {
+            const links = await listAllLinks(key);
+            return JSON.stringify(links, null, 2);
+          }
+
+          throw new Error(`Unknown action: ${act}`);
+        },
+      },
+      "ingest_document": {
         description:
           "Selectively preserve a reliable, reusable source in the RAG knowledge base; do not ingest everything encountered. " +
-          "Accepts local file paths, web URLs, or raw Markdown/text content. " +
-          "For type='url' the page is fetched and its content is indexed (not just the URL). " +
-          "Processes document through 3-tier hierarchy chunking (Big/Medium/Small), " +
-          "computes dense vectors, and extracts GraphRAG code symbols.",
-        args: {
-          content: { type: "string", description: "Raw text content, file path, or web URL" },
-          type: { type: "string", description: "Input content type: 'text', 'file', 'url' (url fetches the page content)", default: "text" },
-          title: { type: "string", description: "Document title" },
+          "Accepts local file paths, web URLs, or raw Markdown/text content. " +
+          "For type='url' the page is fetched and its content is indexed (not just the URL). " +
+          "Processes document through 3-tier hierarchy chunking (Big/Medium/Small), " +
+          "computes dense vectors, and extracts GraphRAG code symbols.",
+        args: {
+          content: { type: "string", description: "Raw text content, file path, or web URL" },
+          type: { type: "string", description: "Input content type: 'text', 'file', 'url' (url fetches the page content)", default: "text" },
+          title: { type: "string", description: "Document title" },
           path: { type: "string", description: "Original document file path" },
           scope: { type: "string", description: "RAG visibility: current Git project (default) or global", default: "project" },
+          directory: { type: "string", description: "Optional workspace/project directory path to target" },
+          project: { type: "string", description: "Alias for directory" },
           generateEmbeddings: { type: "boolean", description: "Compute dense vector embeddings", default: true },
         },
-        async execute({ content, type, title, path, scope, generateEmbeddings }, { worktree, directory }) {
+        async execute({ content, type, title, path, scope, directory, project, generateEmbeddings }, { worktree, directory: ctxDir }) {
           const { ingestDocument } = await import("../mcp-server/ingest/pipeline.js");
-          const projectScope = await resolveRagScopeKey(scope || "project", { worktree, directory });
+          const effectiveDir = directory || project || ctxDir;
+          const projectScope = await resolveRagScopeKey(scope || "project", { worktree, directory: effectiveDir });
           const result = await ingestDocument({
-            content,
-            type: type || "text",
-            title: title || null,
-            path: path || null,
+            content,
+            type: type || "text",
+            title: title || null,
+            path: path || null,
             generateEmbeddings: generateEmbeddings !== false,
             projectScope,
-          });
-          return JSON.stringify(
-            {
-              status: "success",
-              docId: result.docId,
-              title: result.title,
-              sectionsCount: result.sectionsCount,
-              microChunksCount: result.microChunksCount,
+          });
+          return JSON.stringify(
+            {
+              status: "success",
+              docId: result.docId,
+              title: result.title,
+              sectionsCount: result.sectionsCount,
+              microChunksCount: result.microChunksCount,
               deduplicated: result.deduplicated,
               scope: result.projectScope,
-            },
-            null,
-            2
-          );
-        },
-      },
+            },
+            null,
+            2
+          );
+        },
+      },
       "query_knowledge_base": {
         description:
           "Perform project-isolated hybrid search (RSF/RRF BM25 full-text + dense vector similarity) across the RAG knowledge base. " +
-          "Returns top-ranked candidate document sections with breadcrumbs, GraphRAG defined code symbols, and relevance scores.",
-        args: {
-          query: { type: "string", description: "Search query in natural language or symbol name" },
-          limit: { type: "number", description: "Maximum number of sections to return", default: 5 },
-          instruction: {
-            type: "string",
-            description: "Optional task-specific retrieval instruction shaping embedding focus",
-          },
+          "Returns top-ranked candidate document sections with breadcrumbs, GraphRAG defined code symbols, and relevance scores.",
+        args: {
+          query: { type: "string", description: "Search query in natural language or symbol name" },
+          limit: { type: "number", description: "Maximum number of sections to return", default: 5 },
+          instruction: {
+            type: "string",
+            description: "Optional task-specific retrieval instruction shaping embedding focus",
+          },
           generateEmbeddings: { type: "boolean", description: "Use vector search alongside BM25", default: true },
           scope: { type: "string", description: "Search global + current project (default), project only, or global only", default: "all" },
+          directory: { type: "string", description: "Optional workspace/project directory path to target" },
+          project: { type: "string", description: "Alias for directory" },
         },
-        async execute({ query, limit, instruction, generateEmbeddings, scope }, { worktree, directory }) {
-          const { hybridQuery } = await import("../mcp-server/retrieval/retriever.js");
-          const { getConfig } = await import("../mcp-server/config/config_manager.js");
+        async execute({ query, limit, instruction, generateEmbeddings, scope, directory, project }, { worktree, directory: ctxDir }) {
+          const { hybridQuery } = await import("../mcp-server/retrieval/retriever.js");
+          const { getConfig } = await import("../mcp-server/config/config_manager.js");
           const activeConfig = getConfig();
-          const scopeKeys = await resolveRagScopeKeys(scope || "all", { worktree, directory });
-
-          const results = await hybridQuery({
-            query,
-            limit: limit || 5,
-            generateEmbeddings: generateEmbeddings !== false,
+          const effectiveDir = directory || project || ctxDir;
+          const scopeKeys = await resolveRagScopeKeys(scope || "all", { worktree, directory: effectiveDir });
+
+          const results = await hybridQuery({
+            query,
+            limit: limit || 5,
+            generateEmbeddings: generateEmbeddings !== false,
             instruction: instruction || null,
             scopeKeys,
-          });
-
-          if (!results || results.length === 0) {
-            return `[Active Model: ${activeConfig.embeddingModel}]\nNo matching knowledge found for query.`;
-          }
-
-          const headerNote = `[Active Model: ${activeConfig.embeddingModel} | Fusion: ${activeConfig.fusionAlgorithm.toUpperCase()}]\n\n`;
-
-          const formatted = results
-            .map((r, i) => {
-              let header = `### [${i + 1}] ${r.doc_title || "Untitled"}`;
-              if (r.heading) header += ` > ${r.heading}`;
-              if (r.breadcrumbs) header += ` (${r.breadcrumbs})`;
-              let body = `Score: ${(r.score || 0).toFixed(4)}\n`;
-              if (r.defined_symbols && r.defined_symbols.length > 0) {
-                body += `Defined Symbols: ${r.defined_symbols.join(", ")}\n`;
-              }
-              body += `\n${r.snippet || r.full_section_content || ""}`;
-              return `${header}\n${body}`;
-            })
-            .join("\n\n---\n\n");
-
+          });
+
+          if (!results || results.length === 0) {
+            return `[Active Model: ${activeConfig.embeddingModel}]\nNo matching knowledge found for query.`;
+          }
+
+          const headerNote = `[Active Model: ${activeConfig.embeddingModel} | Fusion: ${activeConfig.fusionAlgorithm.toUpperCase()}]\n\n`;
+
+          const formatted = results
+            .map((r, i) => {
+              let header = `### [${i + 1}] ${r.doc_title || "Untitled"}`;
+              if (r.heading) header += ` > ${r.heading}`;
+              if (r.breadcrumbs) header += ` (${r.breadcrumbs})`;
+              let body = `Score: ${(r.score || 0).toFixed(4)}\n`;
+              if (r.defined_symbols && r.defined_symbols.length > 0) {
+                body += `Defined Symbols: ${r.defined_symbols.join(", ")}\n`;
+              }
+              body += `\n${r.snippet || r.full_section_content || ""}`;
+              return `${header}\n${body}`;
+            })
+            .join("\n\n---\n\n");
+
           return headerNote + formatted;
         },
       },
@@ -541,12 +562,15 @@ export const MemoryPlugin = async ({ directory, worktree, client }) => {
           instruction: { type: "string", description: "Optional retrieval instruction applied to every query" },
           generateEmbeddings: { type: "boolean", description: "Use vector search alongside BM25", default: true },
           scope: { type: "string", description: "Search global + current project (default), project only, or global only", default: "all" },
+          directory: { type: "string", description: "Optional workspace/project directory path to target" },
+          project: { type: "string", description: "Alias for directory" },
         },
-        async execute({ queries, limit, instruction, generateEmbeddings, scope }, { worktree, directory }) {
+        async execute({ queries, limit, instruction, generateEmbeddings, scope, directory, project }, { worktree, directory: ctxDir }) {
           const { batchHybridQuery } = await import("../mcp-server/retrieval/retriever.js");
           const { getConfig } = await import("../mcp-server/config/config_manager.js");
           const activeConfig = getConfig();
-          const scopeKeys = await resolveRagScopeKeys(scope || "all", { worktree, directory });
+          const effectiveDir = directory || project || ctxDir;
+          const scopeKeys = await resolveRagScopeKeys(scope || "all", { worktree, directory: effectiveDir });
           const allResults = await batchHybridQuery(queries, {
             limit: limit || 5,
             generateEmbeddings: generateEmbeddings !== false,
@@ -579,20 +603,23 @@ export const MemoryPlugin = async ({ directory, worktree, client }) => {
       "manage_knowledge_base": {
         description:
           "Manage the project-isolated RAG knowledge base: inspect stats, list documents, read full raw document, unlink/delete documents, or export/import complete snapshots.",
-        args: {
-          action: {
-            type: "string",
-            description: "Management action: 'stats', 'list', 'read_document', 'delete', 'export_snapshot', 'import_snapshot'",
-          },
-          docId: { type: "string", description: "Document ID, title, or path (required for read_document and delete)" },
+        args: {
+          action: {
+            type: "string",
+            description: "Management action: 'stats', 'list', 'read_document', 'delete', 'export_snapshot', 'import_snapshot'",
+          },
+          docId: { type: "string", description: "Document ID, title, or path (required for read_document and delete)" },
           snapshotPath: { type: "string", description: "File path for snapshot export/import" },
           scope: { type: "string", description: "For stats/list/read: global + current project by default. Delete defaults to the current project (or global outside Git); pass all/global explicitly for broader removal" },
+          directory: { type: "string", description: "Optional workspace/project directory path to target" },
+          project: { type: "string", description: "Alias for directory" },
         },
-        async execute({ action, docId, snapshotPath, scope }, { worktree, directory }) {
+        async execute({ action, docId, snapshotPath, scope, directory, project }, { worktree, directory: ctxDir }) {
           const { getDatabase } = await import("../mcp-server/db/database.js");
           const db = await getDatabase();
+          const effectiveDir = directory || project || ctxDir;
           const scopeKeys = ["stats", "list", "read_document", "delete"].includes(action)
-            ? await resolveManageRagScopeKeys(action, scope, { worktree, directory })
+            ? await resolveManageRagScopeKeys(action, scope, { worktree, directory: effectiveDir })
             : null;
           const placeholders = scopeKeys ? scopeKeys.map(() => "?").join(",") : "";
           const visibleDocWhere = scopeKeys