@prom.codes/memory-mcp 0.17.0 → 0.19.0

package/dist/bin.js

@@ -28,9 +28,11 @@ var DOCUMENT_LANGUAGE_IDS = [
   "yaml",
   "toml"
 ];
+var COMPOSITE_LANGUAGE_IDS = ["vue"];
 var LANGUAGE_IDS = [
   ...GRAMMAR_LANGUAGE_IDS,
-  ...DOCUMENT_LANGUAGE_IDS
+  ...DOCUMENT_LANGUAGE_IDS,
+  ...COMPOSITE_LANGUAGE_IDS
 ];
 
 // ../shared/dist/update-check.js
@@ -259,15 +261,19 @@ function notify(log, name, current, latest) {
 
 // ../shared/dist/update-info.js
 async function buildUpdateStatus(pkgName, currentVersion, options = {}) {
-  const base = { current: currentVersion, command: await resolveUpgradeCommand() };
   if (options.isDevBuild === true) {
     return {
-      ...base,
+      current: currentVersion,
+      // A workspace build does not need an npm-version probe: the command is
+      // invariant across supported npm releases, and avoiding the subprocess
+      // keeps status responsive during deferred-root startup.
+      command: UPGRADE_COMMAND,
       latest: null,
       updateAvailable: null,
       note: "dev build (workspace) \u2014 version comparison skipped"
     };
   }
+  const base = { current: currentVersion, command: await resolveUpgradeCommand() };
   let latest = null;
   try {
     latest = await getLatestVersion(pkgName, {
@@ -388,7 +394,12 @@ function startHeartbeat(options) {
 // ../shared/dist/idle-watchdog.js
 var DEFAULT_IDLE_EXIT_MS = 30 * 6e4;
 var IDLE_CHECK_INTERVAL_MS = 6e4;
+var DEFAULT_PROBE_TIMEOUT_MS = 5e3;
+var DEFAULT_PROBE_RETRIES = 2;
+var DEFAULT_MAX_PROBE_EXTENSIONS = 8;
 var IDLE_EXIT_ENV = "PROMETHEUS_IDLE_EXIT_MS";
+var IDLE_MAX_PINGS_ENV = "PROMETHEUS_IDLE_MAX_PINGS";
+var IDLE_PROBE_MS_ENV = "PROMETHEUS_IDLE_PROBE_MS";
 function parseIdleExitMs(env) {
   const raw = (env[IDLE_EXIT_ENV] ?? "").trim();
   if (raw === "")
@@ -396,6 +407,20 @@ function parseIdleExitMs(env) {
   const n = Number(raw);
   return Number.isFinite(n) && n >= 0 ? n : void 0;
 }
+function parseMaxProbeExtensions(env) {
+  const raw = (env[IDLE_MAX_PINGS_ENV] ?? "").trim();
+  if (raw === "")
+    return void 0;
+  const n = Number(raw);
+  return Number.isInteger(n) && n >= 0 ? n : void 0;
+}
+function parseProbeTimeoutMs(env) {
+  const raw = (env[IDLE_PROBE_MS_ENV] ?? "").trim();
+  if (raw === "")
+    return void 0;
+  const n = Number(raw);
+  return Number.isFinite(n) && n > 0 ? n : void 0;
+}
 function createIdleWatchdog(options) {
   const env = options.env ?? process.env;
   const idleMs = options.idleMs ?? parseIdleExitMs(env) ?? DEFAULT_IDLE_EXIT_MS;
@@ -406,18 +431,72 @@ function createIdleWatchdog(options) {
     }, stop() {
     }, idleMs: 0 };
   }
+  const probe = options.probe;
+  const probeTimeoutMs = options.probeTimeoutMs ?? parseProbeTimeoutMs(env) ?? DEFAULT_PROBE_TIMEOUT_MS;
+  const probeRetries = Math.max(1, options.probeRetries ?? DEFAULT_PROBE_RETRIES);
+  const maxProbeExtensions = options.maxProbeExtensions ?? parseMaxProbeExtensions(env) ?? DEFAULT_MAX_PROBE_EXTENSIONS;
+  const yieldToIo = options.yieldToIo ?? ((fn) => {
+    const t = setImmediate(fn);
+    t.unref?.();
+  });
   let lastActivity = now();
   let stopped = false;
   let fired = false;
+  let probing = false;
+  let failedProbes = 0;
+  let probeOnlyExtensions = 0;
+  const fire = (idleFor, why) => {
+    fired = true;
+    clearInterval(timer);
+    const detail = why === "unanswered" ? ` and ${probeRetries} liveness pings went unanswered (${Math.round(probeTimeoutMs / 1e3)}s each)` : why === "capped" ? ` \u2014 the client answered ${probeOnlyExtensions} liveness pings in a row but sent no request in any of those windows, so this server is attached to a session nobody is using (raise or disable with ${IDLE_MAX_PINGS_ENV})` : "";
+    options.onIdle(`idle for ${Math.round(idleFor / 1e3)}s with no client activity` + detail + ` (set ${IDLE_EXIT_ENV}=0 to disable)`);
+  };
+  const launchProbe = () => {
+    probing = true;
+    const startedAt = now();
+    let settled = false;
+    let timeoutTimer = null;
+    const finish = (alive) => {
+      if (settled)
+        return;
+      settled = true;
+      if (timeoutTimer !== null)
+        clearTimeout(timeoutTimer);
+      probing = false;
+      if (stopped || fired)
+        return;
+      if (alive || lastActivity > startedAt) {
+        failedProbes = 0;
+        lastActivity = now();
+        probeOnlyExtensions += 1;
+        if (maxProbeExtensions > 0 && probeOnlyExtensions >= maxProbeExtensions) {
+          fire(idleMs * probeOnlyExtensions, "capped");
+        }
+        return;
+      }
+      failedProbes += 1;
+      if (failedProbes < probeRetries)
+        return;
+      fire(now() - lastActivity, "unanswered");
+    };
+    timeoutTimer = setTimeout(() => {
+      yieldToIo(() => finish(false));
+    }, probeTimeoutMs);
+    timeoutTimer.unref?.();
+    void probe().then(() => finish(true), () => finish(false));
+  };
   const timer = setInterval(() => {
     if (stopped || fired)
       return;
     const idleFor = now() - lastActivity;
-    if (idleFor >= idleMs) {
-      fired = true;
-      clearInterval(timer);
-      options.onIdle(`idle for ${Math.round(idleFor / 1e3)}s with no client activity (set ${IDLE_EXIT_ENV}=0 to disable)`);
+    if (idleFor < idleMs)
+      return;
+    if (probe === void 0) {
+      fire(idleFor, "silent");
+      return;
     }
+    if (!probing)
+      launchProbe();
   }, checkIntervalMs);
   timer.unref?.();
   return {
@@ -426,6 +505,10 @@ function createIdleWatchdog(options) {
       if (stopped)
         return;
       lastActivity = now();
+      if (!probing) {
+        failedProbes = 0;
+        probeOnlyExtensions = 0;
+      }
     },
     stop() {
       if (stopped)
@@ -2200,7 +2283,7 @@ function applyRecorderHooks(opts = {}) {
     hookPath,
     events: opts.uninstall ? [] : [...RECORDER_EVENTS],
     backup,
-    note: opts.uninstall ? "Removed the Prometheus session recorder hooks. Reload your Claude Code window(s)." : "Installed the session recorder (opt-in). Reload / restart your Claude Code window(s). It records LOCALLY to ~/.prometheus/recorder; nothing is uploaded. Uninstall anytime with recorder_setup { uninstall: true }."
+    note: opts.uninstall ? "Removed the prom.codes session recorder hooks. Reload your Claude Code window(s)." : "Installed the session recorder (opt-in). Reload / restart your Claude Code window(s). It records LOCALLY to ~/.prometheus/recorder; nothing is uploaded. Uninstall anytime with recorder_setup { uninstall: true }."
   };
 }
 
@@ -3949,9 +4032,9 @@ var MEMORY_RUNTIMES = [
 ];
 var BLOCK_START = "<!-- prometheus-memory:start -->";
 var BLOCK_END = "<!-- prometheus-memory:end -->";
-var RULE_BLOCK = `## Prometheus Agent Memory
+var RULE_BLOCK = `## prom.codes Agent Memory
 
-This workspace uses the Prometheus memory MCP server (\`memory_*\` tools).
+This workspace uses the prom.codes memory MCP server (\`memory_*\` tools).
 Follow this protocol:
 
 1. **Session start:** call \`memory_read\` once before non-trivial work to
@@ -3976,7 +4059,7 @@ ${block}
 ${BLOCK_END}`;
 }
 var CURSOR_FRONTMATTER = `---
-description: Prometheus agent memory protocol
+description: prom.codes agent memory protocol
 alwaysApply: true
 ---
 
@@ -4531,7 +4614,7 @@ ${f.value}`);
   });
   reg("setup", {
     title: "Install memory rules into runtime configs",
-    description: "Idempotently install the Prometheus memory-protocol rule block into agent runtime configs in this workspace: CLAUDE.md (claude-code), .cursor/rules/prometheus-memory.mdc (cursor), .augment/rules/prometheus-memory.md (augment), AGENTS.md (agents). Without `runtimes` it auto-detects which runtimes are present (fallback: agents). Only the marked block is written \u2014 existing content is never touched. Re-running updates the block in place.",
+    description: "Idempotently install the prom.codes memory-protocol rule block into agent runtime configs in this workspace: CLAUDE.md (claude-code), .cursor/rules/prometheus-memory.mdc (cursor), .augment/rules/prometheus-memory.md (augment), AGENTS.md (agents). Without `runtimes` it auto-detects which runtimes are present (fallback: agents). Only the marked block is written \u2014 existing content is never touched. Re-running updates the block in place.",
     inputSchema: setupInput
   }, async (args) => {
     const deps = await ready();
@@ -4553,7 +4636,7 @@ ${f.value}`);
   });
   reg("recorder_setup", {
     title: "Install the Session Recorder (opt-in)",
-    description: "Install (or, with `uninstall: true`, remove) the Prometheus Session Recorder \u2014 Claude Code hooks that capture your coding sessions LOCALLY so memory-mcp can recall what you did and distil durable knowledge. STRICTLY OPT-IN and reversible: this writes a hook script + 5 hook entries (SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd) into settings.json (backed up first). It records BEHAVIOUR, not code \u2014 tool names + short previews, with secrets redacted and sensitive-file contents skipped \u2014 as append-only JSONL under ~/.prometheus/recorder/. NOTHING is uploaded; it never leaves your machine. `scope`: 'project-local' (default \u2014 this project only, .claude/settings.local.json), 'project' (committed .claude/settings.json), or 'user' (~/.claude/settings.json, every project). After install/uninstall, RELOAD your Claude Code window(s). Claude-Code-specific (Cursor/VS Code do not run hooks).",
+    description: "Install (or, with `uninstall: true`, remove) the prom.codes Session Recorder \u2014 Claude Code hooks that capture your coding sessions LOCALLY so memory-mcp can recall what you did and distil durable knowledge. STRICTLY OPT-IN and reversible: this writes a hook script + 5 hook entries (SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd) into settings.json (backed up first). It records BEHAVIOUR, not code \u2014 tool names + short previews, with secrets redacted and sensitive-file contents skipped \u2014 as append-only JSONL under ~/.prometheus/recorder/. NOTHING is uploaded; it never leaves your machine. `scope`: 'project-local' (default \u2014 this project only, .claude/settings.local.json), 'project' (committed .claude/settings.json), or 'user' (~/.claude/settings.json, every project). After install/uninstall, RELOAD your Claude Code window(s). Claude-Code-specific (Cursor/VS Code do not run hooks).",
     inputSchema: recorderSetupInput
   }, async (args) => {
     const deps = await ready();
@@ -4648,7 +4731,7 @@ ${f.value}`);
         embeddingsError = err instanceof Error ? err.message : String(err);
       }
     }
-    const update = await buildUpdateStatus("@prom.codes/memory-mcp", "0.17.0", { isDevBuild: false });
+    const update = await buildUpdateStatus("@prom.codes/memory-mcp", "0.19.0", { isDevBuild: false });
     let recorder;
     try {
       const scopes = ["project-local", "project", "user"];
@@ -4729,11 +4812,11 @@ ${f.value}`);
 
 // dist/server.js
 var SERVER_IDENTITY = {
-  name: "prometheus-memory-mcp",
-  version: "0.17.0",
+  name: "prom.codes-memory",
+  version: "0.19.0",
   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.";
+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 prom.codes 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.";
 
 // dist/bin.js
 function looksLikeMissingNativeBinding(msg) {
@@ -4784,7 +4867,7 @@ async function main() {
     if (shuttingDown)
       return;
     shuttingDown = true;
-    process.stderr.write(`prometheus-memory-mcp: ${reason}, shutting down
+    process.stderr.write(`prom.codes-memory: ${reason}, shutting down
 `);
     watchdog?.stop();
     if (recorderTimer !== null)
@@ -4803,9 +4886,19 @@ async function main() {
   process.stdin.once("end", () => void shutdown("stdin closed (client exited)"));
   process.stdin.once("close", () => void shutdown("stdin closed (client exited)"));
   server.server.onclose = () => void shutdown("transport closed (client exited)");
-  watchdog = createIdleWatchdog({ onIdle: (reason) => void shutdown(reason), env });
+  watchdog = createIdleWatchdog({
+    onIdle: (reason) => void shutdown(reason),
+    env,
+    // Before reaping, ask the client via MCP ping: a live-but-quiet session
+    // (e.g. Claude Code with deferred tools, no memory call for 30 min —
+    // 2026-08-12) answers and is never dropped; only an abandoned server
+    // whose pong never comes still reaps itself.
+    probe: async () => {
+      await server.server.ping();
+    }
+  });
   if (watchdog.idleMs > 0) {
-    process.stderr.write(`prometheus-memory-mcp: idle self-exit armed (${Math.round(watchdog.idleMs / 6e4)} min of no client activity)
+    process.stderr.write(`prom.codes-memory: idle self-exit armed (${Math.round(watchdog.idleMs / 6e4)} min of no client activity; client is pinged before exit)
 `);
   }
   const armIdleWatch = () => {
@@ -4820,7 +4913,7 @@ async function main() {
       env,
       ...override !== void 0 && override !== "" ? { workspaceRootOverride: override } : {}
     });
-    process.stderr.write(`prometheus-memory-mcp: workspace=${composed.workspaceRoot} (via ${via}) project=${composed.projectName} (${composed.projectId}) db=${composed.dbPath} embed=${composed.embedderId}${composed.embeddingsEnabled ? "" : " (keyword-only)"} rerank=${composed.rerankerId} extract=${composed.extractorId} rewrite=${composed.rewriterId} temporal=${composed.temporalEnabled ? "on" : "off"} dedup=${composed.dedupEnabled ? "on" : "off"}
+    process.stderr.write(`prom.codes-memory: workspace=${composed.workspaceRoot} (via ${via}) project=${composed.projectName} (${composed.projectId}) db=${composed.dbPath} embed=${composed.embedderId}${composed.embeddingsEnabled ? "" : " (keyword-only)"} rerank=${composed.rerankerId} extract=${composed.extractorId} rewrite=${composed.rewriterId} temporal=${composed.temporalEnabled ? "on" : "off"} dedup=${composed.dedupEnabled ? "on" : "off"}
 `);
     heartbeat.update({
       workspaceRoot: composed.workspaceRoot,
@@ -4832,13 +4925,13 @@ async function main() {
       }
     });
     if (composed.rootIsHomeOrFsRoot) {
-      process.stderr.write(`prometheus-memory-mcp: workspace resolved to ${composed.workspaceRoot} (your home directory or a filesystem root) \u2014 project memories will NOT be mirrored to markdown there. Open a project folder (Claude Code passes it via CLAUDE_PROJECT_DIR) or set PROMETHEUS_WORKSPACE_ROOT. Call memory_status for details.
+      process.stderr.write(`prom.codes-memory: workspace resolved to ${composed.workspaceRoot} (your home directory or a filesystem root) \u2014 project memories will NOT be mirrored to markdown there. Open a project folder (Claude Code passes it via CLAUDE_PROJECT_DIR) or set PROMETHEUS_WORKSPACE_ROOT. Call memory_status for details.
 `);
     } else if (composed.autoSetup) {
       void autoInstallExisting(composed.workspaceRoot).then((results) => {
         const wrote = results.filter((r) => r.action !== "unchanged");
         if (wrote.length > 0) {
-          process.stderr.write(`prometheus-memory-mcp: auto-installed the memory rule into ${wrote.map((r) => r.runtime).join(", ")} (set PROMETHEUS_MEMORY_AUTO_SETUP=off to disable)
+          process.stderr.write(`prom.codes-memory: auto-installed the memory rule into ${wrote.map((r) => r.runtime).join(", ")} (set PROMETHEUS_MEMORY_AUTO_SETUP=off to disable)
 `);
         }
       }).catch(() => {
@@ -4849,7 +4942,7 @@ async function main() {
       try {
         const r = await composed.recorder.ingestSpoolDir(composed.projectId, env);
         if (r.events > 0) {
-          process.stderr.write(`prometheus-memory-mcp: recorder ingested ${r.events} event(s) from ${r.sessions} session(s); reclaimed ${r.deletedSpools} spool(s)
+          process.stderr.write(`prom.codes-memory: recorder ingested ${r.events} event(s) from ${r.sessions} session(s); reclaimed ${r.deletedSpools} spool(s)
 `);
         }
         const c = composed;
@@ -4865,7 +4958,7 @@ async function main() {
               mirrorToFiles: !c.rootIsHomeOrFsRoot
             }, s.sessionId);
             if (outcome.curated) {
-              process.stderr.write(`prometheus-memory-mcp: curated session ${s.sessionId} (${outcome.facts ?? 0} facts, ${outcome.procedures ?? 0} procedures)
+              process.stderr.write(`prom.codes-memory: curated session ${s.sessionId} (${outcome.facts ?? 0} facts, ${outcome.procedures ?? 0} procedures)
 `);
             }
           }
@@ -4894,7 +4987,7 @@ async function main() {
       boot(fromRoots ?? process.cwd(), fromRoots !== null ? "MCP roots" : "cwd fallback (client advertised no roots)");
     } catch (err) {
       const message = err instanceof Error ? err.message : String(err);
-      process.stderr.write(`prometheus-memory-mcp: fatal during boot: ${message}
+      process.stderr.write(`prom.codes-memory: fatal during boot: ${message}
 `);
       if (looksLikeMissingNativeBinding(message))
         process.stderr.write(NATIVE_BINDING_HINT);
@@ -4911,7 +5004,7 @@ async function main() {
 }
 main().catch((err) => {
   const message = err instanceof Error ? err.message : String(err);
-  process.stderr.write(`prometheus-memory-mcp: fatal: ${message}
+  process.stderr.write(`prom.codes-memory: fatal: ${message}
 `);
   if (looksLikeMissingNativeBinding(message))
     process.stderr.write(NATIVE_BINDING_HINT);

package/package.json

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