@prom.codes/memory-mcp 0.14.0 → 0.15.1

package/README.md

@@ -55,11 +55,22 @@ work, is a newer version published?). Secrets are rejected on every write.
 Your memories never leave your machine (only short query/record text
 transits when embeddings are enabled).
 
-## Native modules
+## Native modules — no install script needed
 
-Uses `better-sqlite3` (native). Prebuilt binaries are fetched automatically on
-common platforms (macOS x64/arm64, Linux x64/arm64, Windows x64) — no compiler
-needed. On an unsupported platform/Node ABI, install C/C++ build tools so the
-module can compile (Windows: VS Build Tools). Requires Node ≥ 20.10.
+Uses `better-sqlite3` (native), but **nothing is built on your machine and no
+install script runs**. The addon ships prebuilt in a platform package
+(`@prom.codes/native-<platform>`) listed as an optional dependency: npm picks
+the one matching your `os`/`cpu`/`libc` and installs it by copying files. So a
+hardened npm needs no special handling — `ignore-scripts=true` (a sensible
+policy, and npm v12's default) has nothing left to suppress:
+```bash
+npm install -g @prom.codes/memory-mcp
+```
+
+Prebuilt for macOS / Linux (glibc + musl) / Windows on x64 + arm64, Node 22, 24,
+25 and 26. **Requires Node ≥ 22** — upstream `better-sqlite3` publishes no
+prebuild for Node 20's ABI. On an unshipped combination the install still
+succeeds and falls back to building from source, which needs install scripts
+allowed (`--allow-scripts=better-sqlite3`) and C/C++ build tools.
 
 Docs: https://prom.codes/docs/mcp/memory

package/dist/bin.js

@@ -40,12 +40,8 @@ import { homedir } from "node:os";
 import { join } from "node:path";
 import { fileURLToPath } from "node:url";
 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`;
+function upgradeCommandFor(_npmMajor) {
+  return UPGRADE_BASE;
 }
 var UPGRADE_COMMAND = upgradeCommandFor(null);
 var npmMajorPromise;
@@ -209,15 +205,15 @@ async function checkForUpdate(options) {
   const file = cachePath(cacheDir, name);
   const now = Date.now();
   if (!force) {
-    const cached = await readCache(file);
-    if (cached !== null && now - cached.checkedAt < cacheTtlMs && !cachedLatestIsStale(cached.latest, version)) {
-      const updateAvailable2 = cached.latest !== null && isNewerVersion(cached.latest, version);
+    const cached2 = await readCache(file);
+    if (cached2 !== null && now - cached2.checkedAt < cacheTtlMs && !cachedLatestIsStale(cached2.latest, version)) {
+      const updateAvailable2 = cached2.latest !== null && isNewerVersion(cached2.latest, version);
       if (updateAvailable2)
-        notify(log, name, version, cached.latest);
-      await syncAvailabilityMarker(cacheDir, name, version, cached.latest, updateAvailable2);
+        notify(log, name, version, cached2.latest);
+      await syncAvailabilityMarker(cacheDir, name, version, cached2.latest, updateAvailable2);
       return {
         ...base,
-        latest: cached.latest,
+        latest: cached2.latest,
         checked: false,
         updateAvailable: updateAvailable2,
         reason: "throttled"
@@ -239,14 +235,14 @@ async function checkForUpdate(options) {
 async function getLatestVersion(name, options = {}) {
   const { env = process.env, fetch: fetchImpl = globalThis.fetch, cacheDir = join(homedir(), ".prometheus"), cacheTtlMs = DEFAULT_TTL_MS, timeoutMs = DEFAULT_TIMEOUT_MS, minVersion } = options;
   const file = cachePath(cacheDir, name);
-  const cached = await readCache(file);
+  const cached2 = await readCache(file);
   const now = Date.now();
-  const stale = cachedLatestIsStale(cached?.latest ?? null, minVersion);
-  if (cached !== null && cached.latest !== null && now - cached.checkedAt < cacheTtlMs && !stale) {
-    return cached.latest;
+  const stale = cachedLatestIsStale(cached2?.latest ?? null, minVersion);
+  if (cached2 !== null && cached2.latest !== null && now - cached2.checkedAt < cacheTtlMs && !stale) {
+    return cached2.latest;
   }
   if (OPT_OUT_RE.test(env.PROMETHEUS_NO_UPDATE_CHECK ?? "") || typeof fetchImpl !== "function") {
-    return stale ? null : cached?.latest ?? null;
+    return stale ? null : cached2?.latest ?? null;
   }
   const latest = await fetchLatest(name, fetchImpl, timeoutMs);
   if (latest !== null) {
@@ -254,7 +250,7 @@ async function getLatestVersion(name, options = {}) {
     await writeCache(file, { checkedAt: now, latest });
     return latest;
   }
-  return stale ? null : cached?.latest ?? null;
+  return stale ? null : cached2?.latest ?? null;
 }
 function notify(log, name, current, latest) {
   log(`${name}: a newer version (${latest}) is available \u2014 you are on ${current}. npx users get it automatically on the next restart; for a global install run \`npm update -g ${name}\`. (Set PROMETHEUS_NO_UPDATE_CHECK=1 to silence.)
@@ -426,10 +422,58 @@ function createIdleWatchdog(options) {
   };
 }
 
+// ../shared/dist/native-binding.js
+import { createRequire } from "node:module";
+import { dirname as dirname2, join as join4 } from "node:path";
+import { existsSync } from "node:fs";
+var require_ = createRequire(import.meta.url);
+function isMusl() {
+  try {
+    const report = process.report?.getReport();
+    const header = typeof report === "object" && report !== null ? report : {};
+    return header.header?.glibcVersionRuntime === void 0;
+  } catch {
+    return false;
+  }
+}
+function platformToken(platform = process.platform, arch = process.arch, musl = platform === "linux" && isMusl()) {
+  const os = platform === "linux" && musl ? "linuxmusl" : platform;
+  return `${os}-${arch}`;
+}
+function nativePackageName(token = platformToken()) {
+  return `@prom.codes/native-${token}`;
+}
+function addonFileName(abi = process.versions.modules) {
+  return `better_sqlite3/node-v${abi}.node`;
+}
+var cached;
+function resolveNativeBinding() {
+  if (cached !== void 0)
+    return cached ?? void 0;
+  cached = null;
+  const override = process.env.PROMETHEUS_SQLITE_NATIVE_BINDING?.trim();
+  if (override) {
+    cached = existsSync(override) ? override : null;
+    return cached ?? void 0;
+  }
+  try {
+    const manifest = require_.resolve(`${nativePackageName()}/package.json`);
+    const candidate = join4(dirname2(manifest), addonFileName());
+    cached = existsSync(candidate) ? candidate : null;
+  } catch {
+    cached = null;
+  }
+  return cached ?? void 0;
+}
+function nativeBindingOption() {
+  const p = resolveNativeBinding();
+  return p ? { nativeBinding: p } : {};
+}
+
 // dist/composition.js
 import { createHash } from "node:crypto";
 import { homedir as homedir5 } from "node:os";
-import { basename, join as join6, resolve as resolve2 } from "node:path";
+import { basename, join as join7, resolve as resolve2 } from "node:path";
 
 // ../embeddings-openai-compat/dist/index.js
 var DEFAULT_BATCH = 96;
@@ -1763,7 +1807,7 @@ var OpenAICompatRewriter = class {
 // dist/sqlite.js
 import { randomUUID } from "node:crypto";
 import { mkdirSync as mkdirSync3, readdirSync as readdirSync2, readFileSync as readFileSync3, rmSync as rmSync2 } from "node:fs";
-import { dirname as dirname3, join as join5 } from "node:path";
+import { dirname as dirname4, join as join6 } from "node:path";
 import Database from "better-sqlite3";
 
 // dist/security.js
@@ -1810,9 +1854,9 @@ function assertNoSecrets(text) {
 }
 
 // dist/recorder.js
-import { copyFileSync, existsSync, mkdirSync as mkdirSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "node:fs";
+import { copyFileSync, existsSync as existsSync2, mkdirSync as mkdirSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "node:fs";
 import { homedir as homedir4 } from "node:os";
-import { dirname as dirname2, join as join4 } from "node:path";
+import { dirname as dirname3, join as join5 } from "node:path";
 var SPOOL_VERSION = 1;
 var SECRET_PATTERN_SOURCES = [
   "sk-proj-[A-Za-z0-9_-]{20,}",
@@ -1840,8 +1884,8 @@ var REDACT_RE = new RegExp(`(${SECRET_PATTERN_SOURCES.join(")|(")})`, "gi");
 var EVENT_CAP_BYTES = 4 * 1024;
 var SPOOL_CAP_BYTES = 4 * 1024 * 1024;
 function recorderRoot(env = process.env) {
-  const base = env.PROMETHEUS_DIR && env.PROMETHEUS_DIR !== "" ? env.PROMETHEUS_DIR : join4(homedir4(), ".prometheus");
-  return join4(base, "recorder");
+  const base = env.PROMETHEUS_DIR && env.PROMETHEUS_DIR !== "" ? env.PROMETHEUS_DIR : join5(homedir4(), ".prometheus");
+  return join5(base, "recorder");
 }
 function sanitizeSegment(s) {
   return s.replace(/[^A-Za-z0-9._-]/g, "_").slice(0, 128) || "_";
@@ -2001,20 +2045,20 @@ function resolveSettingsPath(opts) {
     return opts.settingsPathOverride;
   const root = opts.projectRoot ?? process.cwd();
   if (opts.scope === "project")
-    return join4(root, ".claude", "settings.json");
+    return join5(root, ".claude", "settings.json");
   if (opts.scope === "project-local")
-    return join4(root, ".claude", "settings.local.json");
-  return join4(homedir4(), ".claude", "settings.json");
+    return join5(root, ".claude", "settings.local.json");
+  return join5(homedir4(), ".claude", "settings.json");
 }
 function resolveHookPath(opts) {
-  const dir = opts.hookDirOverride ?? join4(homedir4(), ".prometheus", "hooks");
-  return join4(dir, RECORDER_HOOK_FILENAME);
+  const dir = opts.hookDirOverride ?? join5(homedir4(), ".prometheus", "hooks");
+  return join5(dir, RECORDER_HOOK_FILENAME);
 }
 function ownsEntry(entry) {
   return Array.isArray(entry.hooks) && entry.hooks.some((h) => typeof h?.command === "string" && h.command.includes(RECORDER_HOOK_FILENAME));
 }
 function readSettings(settingsPath) {
-  if (!existsSync(settingsPath))
+  if (!existsSync2(settingsPath))
     return {};
   const raw = readFileSync2(settingsPath, "utf8").replace(/^/, "");
   if (raw.trim() === "")
@@ -2026,7 +2070,7 @@ function readSettings(settingsPath) {
   return parsed;
 }
 function backupSettings(settingsPath) {
-  if (!existsSync(settingsPath))
+  if (!existsSync2(settingsPath))
     return null;
   const d = /* @__PURE__ */ new Date();
   const p = (n) => String(n).padStart(2, "0");
@@ -2054,7 +2098,7 @@ function recorderStatus(opts = {}) {
     scope: opts.scope ?? "user",
     events: installedEvents,
     settingsPath,
-    hookScriptPresent: existsSync(hookPath)
+    hookScriptPresent: existsSync2(hookPath)
   };
 }
 function applyRecorderHooks(opts = {}) {
@@ -2076,7 +2120,7 @@ function applyRecorderHooks(opts = {}) {
     }
   }
   if (!opts.uninstall) {
-    mkdirSync2(dirname2(hookPath), { recursive: true });
+    mkdirSync2(dirname3(hookPath), { recursive: true });
     writeFileSync2(hookPath, RECORDER_HOOK_SCRIPT, "utf8");
     for (const ev of RECORDER_EVENTS) {
       const matcher = ev === "PostToolUse" ? "*" : "";
@@ -2088,7 +2132,7 @@ function applyRecorderHooks(opts = {}) {
   }
   if (settings.hooks && Object.keys(settings.hooks).length === 0)
     delete settings.hooks;
-  mkdirSync2(dirname2(settingsPath), { recursive: true });
+  mkdirSync2(dirname3(settingsPath), { recursive: true });
   writeFileSync2(settingsPath, `${JSON.stringify(settings, null, 2)}
 `, "utf8");
   JSON.parse(readFileSync2(settingsPath, "utf8"));
@@ -2539,9 +2583,9 @@ var SqliteMemoryBackend = class {
   closed = false;
   constructor(dbPath, opts = {}) {
     if (dbPath !== ":memory:") {
-      mkdirSync3(dirname3(dbPath), { recursive: true });
+      mkdirSync3(dirname4(dbPath), { recursive: true });
     }
-    this.db = new Database(dbPath);
+    this.db = new Database(dbPath, { ...nativeBindingOption() });
     this.db.pragma("journal_mode = WAL");
     this.db.pragma("synchronous = NORMAL");
     this.db.exec(SCHEMA);
@@ -2987,7 +3031,7 @@ ${h.record.value}`
    * spool never aborts the sweep. Returns roll-up counts.
    */
   async ingestSpoolDir(projectId, env = process.env) {
-    const dir = join5(recorderRoot(env), sanitizeSegment(projectId));
+    const dir = join6(recorderRoot(env), sanitizeSegment(projectId));
     let sessions = 0;
     let events = 0;
     let deletedSpools = 0;
@@ -2998,7 +3042,7 @@ ${h.record.value}`
       return { sessions: 0, events: 0, deletedSpools: 0 };
     }
     for (const file of files) {
-      const full = join5(dir, file);
+      const full = join6(dir, file);
       try {
         const raw = readFileSync3(full, "utf8");
         const parsed = parseSpool(raw);
@@ -3171,7 +3215,7 @@ function projectIdFor(workspaceRoot) {
   return createHash("sha256").update(abs).digest("hex").slice(0, 16);
 }
 function defaultMemoryDbPath() {
-  return join6(homedir5(), ".prometheus", "memory.db");
+  return join7(homedir5(), ".prometheus", "memory.db");
 }
 function intEnv(env, name, def) {
   const raw = env[name];
@@ -3764,9 +3808,9 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { z } from "zod";
 
 // dist/setup.js
-import { existsSync as existsSync2, readFileSync as readFileSync4 } from "node:fs";
+import { existsSync as existsSync3, readFileSync as readFileSync4 } from "node:fs";
 import { mkdir as mkdir3, readFile as readFile3, writeFile as writeFile3 } from "node:fs/promises";
-import { dirname as dirname4, join as join8 } from "node:path";
+import { dirname as dirname5, join as join9 } from "node:path";
 var MEMORY_RUNTIMES = [
   "claude-code",
   "cursor",
@@ -3810,13 +3854,13 @@ alwaysApply: true
 var TARGETS = {
   "claude-code": { relPath: "CLAUDE.md", mode: "block", detect: "CLAUDE.md" },
   cursor: {
-    relPath: join8(".cursor", "rules", "prometheus-memory.mdc"),
+    relPath: join9(".cursor", "rules", "prometheus-memory.mdc"),
     mode: "file",
     fileContent: CURSOR_FRONTMATTER + withMarkers(RULE_BLOCK) + "\n",
     detect: ".cursor"
   },
   augment: {
-    relPath: join8(".augment", "rules", "prometheus-memory.md"),
+    relPath: join9(".augment", "rules", "prometheus-memory.md"),
     mode: "file",
     fileContent: withMarkers(RULE_BLOCK) + "\n",
     detect: ".augment"
@@ -3824,16 +3868,16 @@ var TARGETS = {
   agents: { relPath: "AGENTS.md", mode: "block", detect: "AGENTS.md" }
 };
 function detectRuntimes(workspaceRoot) {
-  const found = MEMORY_RUNTIMES.filter((rt) => existsSync2(join8(workspaceRoot, TARGETS[rt].detect)));
+  const found = MEMORY_RUNTIMES.filter((rt) => existsSync3(join9(workspaceRoot, TARGETS[rt].detect)));
   return found.length > 0 ? found : ["agents"];
 }
 function existingRuntimes(workspaceRoot) {
-  return MEMORY_RUNTIMES.filter((rt) => existsSync2(join8(workspaceRoot, TARGETS[rt].detect)));
+  return MEMORY_RUNTIMES.filter((rt) => existsSync3(join9(workspaceRoot, TARGETS[rt].detect)));
 }
 function installedRuntimes(workspaceRoot) {
   return MEMORY_RUNTIMES.filter((rt) => {
-    const p = join8(workspaceRoot, TARGETS[rt].relPath);
-    if (!existsSync2(p))
+    const p = join9(workspaceRoot, TARGETS[rt].relPath);
+    if (!existsSync3(p))
       return false;
     try {
       return readFileSync4(p, "utf-8").includes(BLOCK_START);
@@ -3861,14 +3905,14 @@ function upsertBlock(existing, block) {
 }
 async function installRuntime(workspaceRoot, runtime) {
   const target = TARGETS[runtime];
-  const absPath = join8(workspaceRoot, target.relPath);
-  const exists = existsSync2(absPath);
+  const absPath = join9(workspaceRoot, target.relPath);
+  const exists = existsSync3(absPath);
   const before = exists ? await readFile3(absPath, "utf-8") : "";
   const after = target.mode === "file" ? target.fileContent : upsertBlock(before, RULE_BLOCK);
   if (exists && before === after) {
     return { runtime, path: absPath, action: "unchanged" };
   }
-  await mkdir3(dirname4(absPath), { recursive: true });
+  await mkdir3(dirname5(absPath), { recursive: true });
   await writeFile3(absPath, after, "utf-8");
   return { runtime, path: absPath, action: exists ? "updated" : "created" };
 }
@@ -4389,7 +4433,7 @@ ${f.value}`);
         embeddingsError = err instanceof Error ? err.message : String(err);
       }
     }
-    const update = await buildUpdateStatus("@prom.codes/memory-mcp", "0.14.0", { isDevBuild: false });
+    const update = await buildUpdateStatus("@prom.codes/memory-mcp", "0.15.1", { isDevBuild: false });
     let recorder;
     try {
       const scopes = ["project-local", "project", "user"];
@@ -4471,7 +4515,7 @@ ${f.value}`);
 // dist/server.js
 var SERVER_IDENTITY = {
   name: "prometheus-memory-mcp",
-  version: "0.14.0",
+  version: "0.15.1",
   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.";
@@ -4480,7 +4524,19 @@ 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 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';
+var NATIVE_BINDING_HINT = `
+The native SQLite module failed to load. Since 0.15.0 the addon ships
+prebuilt in a platform package (no install script runs), so this almost always
+means we ship no build for THIS platform + Node combination:
+  you are on ${process.platform}-${process.arch}, Node ${process.versions.node} (ABI v${process.versions.modules})
+  shipped: win32/darwin/linux (glibc+musl) x x64/arm64, on Node 22, 24, 25, 26
+Most likely fix \u2014 use a supported Node (22+); Node 20 has no prebuilt addon
+upstream and must compile from source. To build from source instead, allow the
+install scripts:
+  npm install -g @prom.codes/memory-mcp --allow-scripts=better-sqlite3   # npm v12+
+  npm install -g @prom.codes/memory-mcp --ignore-scripts=false --foreground-scripts  # npm <= 11
+Docs: https://prom.codes/docs/guides/troubleshooting#could-not-locate-the-bindings-file
+`;
 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.14.0",
+  "version": "0.15.1",
   "description": "prom.codes Memory — persistent, local-first agent memory as an MCP server.",
   "type": "module",
   "bin": {
@@ -10,7 +10,7 @@
     "dist"
   ],
   "engines": {
-    "node": ">=20.10"
+    "node": ">=22"
   },
   "license": "UNLICENSED",
   "homepage": "https://prom.codes",
@@ -28,5 +28,15 @@
     "@modelcontextprotocol/sdk": "^1.29.0",
     "better-sqlite3": "^12.10.0",
     "zod": "^4.4.3"
+  },
+  "optionalDependencies": {
+    "@prom.codes/native-darwin-arm64": "0.19.0",
+    "@prom.codes/native-darwin-x64": "0.19.0",
+    "@prom.codes/native-linux-arm64": "0.19.0",
+    "@prom.codes/native-linux-x64": "0.19.0",
+    "@prom.codes/native-linuxmusl-arm64": "0.19.0",
+    "@prom.codes/native-linuxmusl-x64": "0.19.0",
+    "@prom.codes/native-win32-arm64": "0.19.0",
+    "@prom.codes/native-win32-x64": "0.19.0"
   }
 }