@prom.codes/memory-mcp 0.11.2 → 0.11.4

package/dist/bin.js

@@ -34,11 +34,43 @@ var LANGUAGE_IDS = [
 ];
 
 // ../shared/dist/update-check.js
+import { exec } from "node:child_process";
 import { mkdir, readFile, rm, writeFile } from "node:fs/promises";
 import { homedir } from "node:os";
 import { join } from "node:path";
 import { fileURLToPath } from "node:url";
-var UPGRADE_COMMAND = "npm install -g @prom.codes/context-mcp @prom.codes/memory-mcp @prom.codes/saver --ignore-scripts=false --foreground-scripts";
+var UPGRADE_BASE = "npm install -g @prom.codes/context-mcp @prom.codes/memory-mcp @prom.codes/saver";
+var NATIVE_BUILD_PACKAGES = "better-sqlite3,tree-sitter";
+function upgradeCommandFor(npmMajor) {
+  if (npmMajor !== null && npmMajor >= 12) {
+    return `${UPGRADE_BASE} --allow-scripts=${NATIVE_BUILD_PACKAGES}`;
+  }
+  return `${UPGRADE_BASE} --ignore-scripts=false --foreground-scripts`;
+}
+var UPGRADE_COMMAND = upgradeCommandFor(null);
+var npmMajorPromise;
+function detectNpmMajor(execImpl = exec) {
+  if (npmMajorPromise === void 0) {
+    npmMajorPromise = new Promise((resolvePromise) => {
+      try {
+        execImpl("npm --version", { timeout: 4e3, windowsHide: true }, (err, stdout) => {
+          if (err) {
+            resolvePromise(null);
+            return;
+          }
+          const m = /(\d+)\./.exec(String(stdout).trim());
+          resolvePromise(m ? Number(m[1]) : null);
+        });
+      } catch {
+        resolvePromise(null);
+      }
+    });
+  }
+  return npmMajorPromise;
+}
+async function resolveUpgradeCommand(execImpl = exec) {
+  return upgradeCommandFor(await detectNpmMajor(execImpl));
+}
 async function packageIdentity(binImportMetaUrl) {
   try {
     const binPath = fileURLToPath(binImportMetaUrl);
@@ -108,7 +140,7 @@ async function syncAvailabilityMarker(dir, name, current, latest, updateAvailabl
         name,
         current,
         latest,
-        command: UPGRADE_COMMAND,
+        command: await resolveUpgradeCommand(),
         notedAt: Date.now()
       };
       await mkdir(dir, { recursive: true }).catch(() => void 0);
@@ -231,7 +263,7 @@ function notify(log, name, current, latest) {
 
 // ../shared/dist/update-info.js
 async function buildUpdateStatus(pkgName, currentVersion, options = {}) {
-  const base = { current: currentVersion, command: UPGRADE_COMMAND };
+  const base = { current: currentVersion, command: await resolveUpgradeCommand() };
   if (options.isDevBuild === true) {
     return {
       ...base,
@@ -261,7 +293,7 @@ async function buildUpdateStatus(pkgName, currentVersion, options = {}) {
 
 // ../shared/dist/workspace-root.js
 import { homedir as homedir2 } from "node:os";
-import { dirname, resolve } from "node:path";
+import { dirname, join as join2, resolve } from "node:path";
 function isHomeOrFilesystemRoot(root) {
   const abs = resolve(root);
   if (abs === "")
@@ -276,18 +308,18 @@ function isHomeOrFilesystemRoot(root) {
 // ../shared/dist/heartbeat.js
 import { mkdirSync, readdirSync, readFileSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { homedir as homedir3 } from "node:os";
-import { join as join2 } from "node:path";
+import { join as join3 } from "node:path";
 var DEFAULT_HEARTBEAT_INTERVAL_MS = 6e4;
 var STALE_AFTER_MS = 5 * 6e4;
 function defaultStatusDir(env = process.env) {
   const override = (env.PROMETHEUS_STATUS_DIR ?? "").trim();
   if (override !== "")
     return override;
-  return join2(homedir3(), ".prometheus", "status");
+  return join3(homedir3(), ".prometheus", "status");
 }
 function startHeartbeat(options) {
   const dir = options.dir ?? defaultStatusDir(options.env ?? process.env);
-  const file = join2(dir, `${options.server}-${process.pid}.json`);
+  const file = join3(dir, `${options.server}-${process.pid}.json`);
   const intervalMs = options.intervalMs ?? DEFAULT_HEARTBEAT_INTERVAL_MS;
   let record = {
     server: options.server,
@@ -397,7 +429,7 @@ function createIdleWatchdog(options) {
 // dist/composition.js
 import { createHash } from "node:crypto";
 import { homedir as homedir4 } from "node:os";
-import { basename, join as join3, resolve as resolve2 } from "node:path";
+import { basename, join as join4, resolve as resolve2 } from "node:path";
 
 // ../embeddings-openai-compat/dist/index.js
 var DEFAULT_BATCH = 96;
@@ -676,6 +708,7 @@ var DEFAULT_BATCH2 = 128;
 var DEFAULT_BATCH_CHARS = 4e5;
 var DEFAULT_RETRIES2 = 4;
 var DEFAULT_BACKOFF2 = 250;
+var DEFAULT_TIMEOUT_MS2 = 15e3;
 function sleep2(ms, signal) {
   return new Promise((resolve3, reject) => {
     if (signal?.aborted === true) {
@@ -707,6 +740,7 @@ var PrometheusEmbeddingProvider = class {
   #maxBatchChars;
   #maxRetries;
   #retryBaseMs;
+  #timeoutMs;
   #fetch;
   #identity = null;
   #identityPromise = null;
@@ -721,8 +755,12 @@ var PrometheusEmbeddingProvider = class {
     this.#url = `${(opts.baseUrl ?? DEFAULT_BASE).replace(/\/+$/, "")}/embed`;
     this.#batchSize = opts.batchSize ?? DEFAULT_BATCH2;
     this.#maxBatchChars = opts.maxBatchChars ?? DEFAULT_BATCH_CHARS;
+    if (opts.timeoutMs !== void 0 && (!Number.isInteger(opts.timeoutMs) || opts.timeoutMs < 0)) {
+      throw new Error(`PrometheusEmbeddingProvider: timeoutMs must be a non-negative integer (0 disables), got ${opts.timeoutMs}`);
+    }
     this.#maxRetries = opts.maxRetries ?? DEFAULT_RETRIES2;
     this.#retryBaseMs = opts.retryBaseMs ?? DEFAULT_BACKOFF2;
+    this.#timeoutMs = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS2;
     this.#fetch = opts.fetch ?? fetch;
   }
   /**
@@ -792,8 +830,6 @@ var PrometheusEmbeddingProvider = class {
       method: "GET",
       headers: { authorization: `Bearer ${this.#apiKey}` }
     };
-    if (signal !== void 0)
-      init.signal = signal;
     const payload = await this.#requestJson(init, signal);
     if (payload?.ok !== true || typeof payload.fingerprint !== "string" || payload.fingerprint === "" || !Number.isInteger(payload.dimension) || payload.dimension <= 0) {
       throw nonRetryable2("prometheus-embed: malformed identity response");
@@ -827,8 +863,6 @@ var PrometheusEmbeddingProvider = class {
       },
       body: JSON.stringify({ input: batch, inputType })
     };
-    if (signal !== void 0)
-      init.signal = signal;
     const payload = await this.#requestJson(init, signal);
     if (payload?.ok !== true || !Array.isArray(payload.embeddings)) {
       throw nonRetryable2("prometheus-embed: malformed embed response");
@@ -864,8 +898,25 @@ var PrometheusEmbeddingProvider = class {
     let attempt = 0;
     let lastError = null;
     while (attempt <= this.#maxRetries) {
+      const controller = new AbortController();
+      let timedOut = false;
+      let timer;
+      if (this.#timeoutMs > 0) {
+        timer = setTimeout(() => {
+          timedOut = true;
+          controller.abort();
+        }, this.#timeoutMs);
+        timer.unref?.();
+      }
+      const onParentAbort = () => controller.abort();
+      if (signal !== void 0) {
+        if (signal.aborted)
+          controller.abort();
+        else
+          signal.addEventListener("abort", onParentAbort, { once: true });
+      }
       try {
-        const res = await this.#fetch(this.#url, init);
+        const res = await this.#fetch(this.#url, { ...init, signal: controller.signal });
         if (res.status >= 500 && res.status < 600) {
           lastError = new Error(`prometheus-embed: HTTP ${res.status}`);
           attempt += 1;
@@ -881,15 +932,21 @@ var PrometheusEmbeddingProvider = class {
         }
         return await res.json();
       } catch (err) {
-        if (err?.name === "AbortError")
+        if (err?.name === "AbortError" && !timedOut)
           throw err;
         if (err?.nonRetryable === true)
           throw err;
+        const retryErr = timedOut ? new Error(`prometheus-embed: request timed out after ${this.#timeoutMs}ms`) : err;
         if (attempt >= this.#maxRetries)
-          throw err;
-        lastError = err;
+          throw retryErr;
+        lastError = retryErr;
         attempt += 1;
         await sleep2(this.#retryBaseMs * 2 ** (attempt - 1), signal);
+      } finally {
+        if (timer !== void 0)
+          clearTimeout(timer);
+        if (signal !== void 0)
+          signal.removeEventListener("abort", onParentAbort);
       }
     }
     throw lastError instanceof Error ? lastError : new Error(`prometheus-embed: exhausted ${this.#maxRetries} retries`);
@@ -1076,7 +1133,7 @@ var DEFAULT_BATCH4 = 100;
 var DEFAULT_BATCH_CHARS2 = 4e5;
 var DEFAULT_RETRIES4 = 4;
 var DEFAULT_BACKOFF4 = 250;
-var DEFAULT_TIMEOUT_MS2 = 15e3;
+var DEFAULT_TIMEOUT_MS3 = 15e3;
 function sleep4(ms, signal) {
   return new Promise((resolve3, reject) => {
     if (signal?.aborted === true) {
@@ -1131,7 +1188,7 @@ var PrometheusRerankProvider = class {
     }
     this.#maxRetries = opts.maxRetries ?? DEFAULT_RETRIES4;
     this.#retryBaseMs = opts.retryBaseMs ?? DEFAULT_BACKOFF4;
-    this.#timeoutMs = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS2;
+    this.#timeoutMs = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS3;
     this.#fetch = opts.fetch ?? fetch;
   }
   /** Cumulative credits charged across all rerank calls of this instance. */
@@ -2453,7 +2510,7 @@ function projectIdFor(workspaceRoot) {
   return createHash("sha256").update(abs).digest("hex").slice(0, 16);
 }
 function defaultMemoryDbPath() {
-  return join3(homedir4(), ".prometheus", "memory.db");
+  return join4(homedir4(), ".prometheus", "memory.db");
 }
 function intEnv(env, name, def) {
   const raw = env[name];
@@ -2896,7 +2953,7 @@ function assertNoSecrets(text) {
 // dist/setup.js
 import { existsSync, readFileSync as readFileSync2 } from "node:fs";
 import { mkdir as mkdir3, readFile as readFile3, writeFile as writeFile3 } from "node:fs/promises";
-import { dirname as dirname3, join as join5 } from "node:path";
+import { dirname as dirname3, join as join6 } from "node:path";
 var MEMORY_RUNTIMES = [
   "claude-code",
   "cursor",
@@ -2940,13 +2997,13 @@ alwaysApply: true
 var TARGETS = {
   "claude-code": { relPath: "CLAUDE.md", mode: "block", detect: "CLAUDE.md" },
   cursor: {
-    relPath: join5(".cursor", "rules", "prometheus-memory.mdc"),
+    relPath: join6(".cursor", "rules", "prometheus-memory.mdc"),
     mode: "file",
     fileContent: CURSOR_FRONTMATTER + withMarkers(RULE_BLOCK) + "\n",
     detect: ".cursor"
   },
   augment: {
-    relPath: join5(".augment", "rules", "prometheus-memory.md"),
+    relPath: join6(".augment", "rules", "prometheus-memory.md"),
     mode: "file",
     fileContent: withMarkers(RULE_BLOCK) + "\n",
     detect: ".augment"
@@ -2954,15 +3011,15 @@ var TARGETS = {
   agents: { relPath: "AGENTS.md", mode: "block", detect: "AGENTS.md" }
 };
 function detectRuntimes(workspaceRoot) {
-  const found = MEMORY_RUNTIMES.filter((rt) => existsSync(join5(workspaceRoot, TARGETS[rt].detect)));
+  const found = MEMORY_RUNTIMES.filter((rt) => existsSync(join6(workspaceRoot, TARGETS[rt].detect)));
   return found.length > 0 ? found : ["agents"];
 }
 function existingRuntimes(workspaceRoot) {
-  return MEMORY_RUNTIMES.filter((rt) => existsSync(join5(workspaceRoot, TARGETS[rt].detect)));
+  return MEMORY_RUNTIMES.filter((rt) => existsSync(join6(workspaceRoot, TARGETS[rt].detect)));
 }
 function installedRuntimes(workspaceRoot) {
   return MEMORY_RUNTIMES.filter((rt) => {
-    const p = join5(workspaceRoot, TARGETS[rt].relPath);
+    const p = join6(workspaceRoot, TARGETS[rt].relPath);
     if (!existsSync(p))
       return false;
     try {
@@ -2991,7 +3048,7 @@ function upsertBlock(existing, block) {
 }
 async function installRuntime(workspaceRoot, runtime) {
   const target = TARGETS[runtime];
-  const absPath = join5(workspaceRoot, target.relPath);
+  const absPath = join6(workspaceRoot, target.relPath);
   const exists = existsSync(absPath);
   const before = exists ? await readFile3(absPath, "utf-8") : "";
   const after = target.mode === "file" ? target.fileContent : upsertBlock(before, RULE_BLOCK);
@@ -3398,7 +3455,7 @@ ${f.value}`);
         embeddingsError = err instanceof Error ? err.message : String(err);
       }
     }
-    const update = await buildUpdateStatus("@prom.codes/memory-mcp", "0.11.2", { isDevBuild: false });
+    const update = await buildUpdateStatus("@prom.codes/memory-mcp", "0.11.4", { isDevBuild: false });
     const summary = deps.rootIsHomeOrFsRoot ? `Memory at ${dbPath}: ${stats.total} records, but the workspace resolved to ${workspaceRoot} (home/root) \u2014 open a project folder so memories scope and mirror correctly.` : `Memory at ${dbPath}: ${stats.total} records for project "${projectName}".${update.updateAvailable === true ? ` Update available: ${update.current} \u2192 ${update.latest} (ask me to run update via the context server's update_servers tool).` : ""}`;
     return textResult({
       installed: true,
@@ -3434,7 +3491,7 @@ ${f.value}`);
 // dist/server.js
 var SERVER_IDENTITY = {
   name: "prometheus-memory-mcp",
-  version: "0.11.2",
+  version: "0.11.4",
   title: "prom.codes Memory"
 };
 var SERVER_INSTRUCTIONS = "Persistent agent memory for this workspace \u2014 USE IT PROACTIVELY; the user will not tell you to. Protocol:\n1. ONE-TIME: if this workspace has no Prometheus memory rule yet, call memory_setup now (idempotent) so the protocol is installed into the runtime rule files and survives future sessions. (The server also auto-installs it on startup when a project rule file already exists \u2014 memory_setup covers the rest.)\n2. SESSION START: before any non-trivial task, call memory_read to recall facts, decisions and procedures from earlier sessions.\n3. DURING WORK: when the user states a durable preference, decision, correction or project fact, store it with memory_write (semantic for facts, procedural for how-tos) \u2014 without being asked.\n4. LOOK-UP: use memory_search for keyword recall when memory_read is not specific enough.\n5. SESSION END: consolidate what was learned with memory_capture.\nCall memory_status anytime to check what is stored and whether the rule is installed. Never store secrets, API keys or credentials \u2014 such writes are rejected.";
@@ -3443,7 +3500,7 @@ var SERVER_INSTRUCTIONS = "Persistent agent memory for this workspace \u2014 USE
 function looksLikeMissingNativeBinding(msg) {
   return /bindings file|better_sqlite3\.node|could not locate the bindings|node_module_version|was compiled against a different|invalid elf|\.node['"\s]/i.test(msg);
 }
-var NATIVE_BINDING_HINT = '\nThis looks like the native `better-sqlite3` module failed to load \u2014 usually\nbecause npm `ignore-scripts=true` (corporate hardening) made `npx` skip the\nnative build, so the binary was never produced. Fix it once, keeping your\nhardening intact:\n  npm install -g @prom.codes/memory-mcp --ignore-scripts=false --foreground-scripts\nthen point Claude Code at the built binary instead of npx:\n  claude mcp add memory -- node "$(npm root -g)/@prom.codes/memory-mcp/dist/bin.js"\nDocs: https://prom.codes/docs/mcp/claude-code\n';
+var NATIVE_BINDING_HINT = '\nThis looks like the native `better-sqlite3` module failed to load \u2014 the\ninstall script that builds it was skipped, so the binary was never produced.\nOn npm v12+ install scripts are opt-in by default; on older npm it\'s usually\n`ignore-scripts=true` hardening. Install globally, allowing the native build,\nthen point Claude Code at the built binary instead of npx:\n  npm v12+:  npm install -g @prom.codes/memory-mcp --allow-scripts=better-sqlite3\n  npm \u2264 11:  npm install -g @prom.codes/memory-mcp --ignore-scripts=false --foreground-scripts\n  claude mcp add memory -- node "$(npm root -g)/@prom.codes/memory-mcp/dist/bin.js"\nDocs: https://prom.codes/docs/guides/troubleshooting#could-not-locate-the-bindings-file\n';
 async function main() {
   const env = process.env;
   const explicitRoot = (env.PROMETHEUS_WORKSPACE_ROOT ?? "").trim();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prom.codes/memory-mcp",
-  "version": "0.11.2",
+  "version": "0.11.4",
   "description": "prom.codes Memory — persistent, local-first agent memory as an MCP server.",
   "type": "module",
   "bin": {