@folterung/project-memory 0.1.14 → 0.1.16

package/packages/mcp-server/src/index.ts

@@ -5,6 +5,8 @@
  * Log only to stderr so stdout is not corrupted (MCP uses stdin/stdout for JSON-RPC).
  */
 
+import { spawnSync } from "node:child_process";
+import { existsSync } from "node:fs";
 import { appendFileSync, writeFileSync } from "fs";
 import { tmpdir } from "os";
 import { basename, join } from "path";
@@ -148,6 +150,56 @@ async function callExplain(
   }
 }
 
+interface StoreBody {
+  content: string;
+  title?: string;
+  path?: string;
+}
+
+async function callStore(
+  baseUrl: string,
+  body: StoreBody
+): Promise<{ id: string; message: string } | { error: string }> {
+  try {
+    const res = await fetch(`${baseUrl}/store`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(body),
+    });
+    const data = (await res.json()) as { id?: string; message?: string; error?: string };
+    if (!res.ok) {
+      return { error: (data as { message?: string }).message ?? `Store failed: ${res.status}` };
+    }
+    return { id: data.id ?? "", message: data.message ?? "Stored." };
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    return { error: message };
+  }
+}
+
+const REFRESH_TIMEOUT_MS = 300_000;
+
+function getProjectCwd(): string {
+  return process.env.MEM_CWD ?? process.cwd();
+}
+
+function runMemUpdate(cwd: string): { ok: boolean; stdout: string; stderr: string; error?: string } {
+  const cliPath = join(cwd, "node_modules", "@folterung", "project-memory", "packages", "cli", "bin", "mem.js");
+  const useNode = existsSync(cliPath);
+  const result = spawnSync(
+    useNode ? process.execPath : "mem",
+    useNode ? [cliPath, "update"] : ["update"],
+    { cwd, encoding: "utf8", timeout: REFRESH_TIMEOUT_MS }
+  );
+  const errorMsg = result.error?.message;
+  return {
+    ok: result.status === 0,
+    stdout: result.stdout ?? "",
+    stderr: result.stderr ?? "",
+    error: errorMsg,
+  };
+}
+
 async function main(): Promise<void> {
   ensureLogFileExists();
   const baseUrl = getBaseUrl();
@@ -225,6 +277,68 @@ async function main(): Promise<void> {
     }
   );
 
+  server.registerTool(
+    "refresh_project_memory_index",
+    {
+      description:
+        "Re-run the project memory index (Phase 1: file tree, module summaries, entrypoints). Use when the codebase has changed and you want the index updated so search and context stay accurate. Runs 'mem update' in the project.",
+      inputSchema: z.object({}),
+    },
+    async () => {
+      logAsked("refresh_project_memory_index", {});
+      const cwd = getProjectCwd();
+      const { ok, stdout, stderr, error } = runMemUpdate(cwd);
+      const summary = ok
+        ? "Project memory index updated successfully."
+        : "Project memory index update failed.";
+      const detail = [error, stdout, stderr].filter(Boolean).join("\n") || "(no output)";
+      const responseText = `${summary}\n\n${detail}`.slice(0, 4000);
+      logReturned("refresh_project_memory_index", responseText);
+      return { content: [{ type: "text" as const, text: responseText }] };
+    }
+  );
+
+  server.registerTool(
+    "store_project_memory",
+    {
+      description:
+        "Store a summary, note, or finding in project memory so it can be found by future search. Use after research when you have learned something useful that would help answer future questions. Each call adds a new point (idempotent by content, not by call).",
+      inputSchema: z.object({
+        content: z
+          .string()
+          .describe(
+            "The main text to store: summary, finding, or explanation that provides significant context for future questions."
+          ),
+        title: z
+          .string()
+          .optional()
+          .describe("Short label for this note (e.g. 'Sync scripts overview', 'Auth flow summary')."),
+        path: z
+          .string()
+          .optional()
+          .describe("File or path this note relates to (e.g. src/scripts/sync_worker.js)."),
+      }),
+    },
+    async ({ content, title, path }) => {
+      const args = { content: content.slice(0, 200) + (content.length > 200 ? "…" : ""), title, path };
+      logAsked("store_project_memory", args);
+      const trimmed = (content ?? "").trim();
+      if (!trimmed) {
+        const msg = "content is required and must be non-empty.";
+        logReturned("store_project_memory", msg);
+        return { content: [{ type: "text" as const, text: msg }] };
+      }
+      const result = await callStore(getBaseUrl(), { content: trimmed, title, path });
+      if ("error" in result) {
+        logReturned("store_project_memory", result.error);
+        return { content: [{ type: "text" as const, text: result.error }] };
+      }
+      const responseText = `${result.message} (id: ${result.id})`;
+      logReturned("store_project_memory", responseText);
+      return { content: [{ type: "text" as const, text: responseText }] };
+    }
+  );
+
   const transport = new StdioServerTransport();
   await server.connect(transport);
   const logFile = getLogFilePath();

package/packages/server/coverage/lcov-report/index.html

@@ -101,7 +101,7 @@
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2026-02-03T01:24:19.060Z
+                at 2026-02-03T02:33:49.502Z
             </div>
         <script src="prettify.js"></script>
         <script>

package/packages/server/coverage/lcov-report/stub.ts.html

@@ -169,7 +169,7 @@ export function getVectorSize(): number {
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2026-02-03T01:24:19.060Z
+                at 2026-02-03T02:33:49.502Z
             </div>
         <script src="prettify.js"></script>
         <script>