cf-memory-mcp 3.37.0 → 3.39.0

package/bin/cf-memory-mcp.js

@@ -66,6 +66,32 @@ const STREAMABLE_HTTP_URL = `${BASE_URL}/mcp`;
 const LEGACY_SERVER_URL = `${BASE_URL}/mcp/message`;
 const PROGRESS_SSE_URL = `${BASE_URL}/api/indexing/progress`;
 const PACKAGE_VERSION = require('../package.json').version;
+
+/**
+ * Fetch the latest version of cf-memory-mcp from the npm registry.
+ * Returns the latest version string, or null on timeout/error.
+ * Used by `doctor` to flag outdated installs. Bounded by timeoutMs
+ * so an unreachable registry doesn't hang the doctor command.
+ */
+function checkLatestNpmVersion(currentVersion, timeoutMs = 1500) {
+    return new Promise((resolve) => {
+        const req = https.get('https://registry.npmjs.org/cf-memory-mcp/latest', {
+            timeout: timeoutMs,
+            headers: { 'Accept': 'application/json', 'User-Agent': `cf-memory-mcp/${currentVersion}` },
+        }, (res) => {
+            let body = '';
+            res.on('data', (chunk) => { body += chunk; });
+            res.on('end', () => {
+                try {
+                    const parsed = JSON.parse(body);
+                    resolve(parsed.version || null);
+                } catch (_) { resolve(null); }
+            });
+        });
+        req.on('error', () => resolve(null));
+        req.on('timeout', () => { req.destroy(); resolve(null); });
+    });
+}
 // Default per-request timeout. Batch uploads use BATCH_TIMEOUT_MS below.
 const TIMEOUT_MS = 60000;
 // Batch uploads can take longer because the worker processes each file
@@ -3886,6 +3912,8 @@ function parseCliArgs(rest) {
             flags.blockers_only = true;
         } else if (a === '--chain') {
             flags.chain = true;
+        } else if (a === '--validate') {
+            flags.validate = true;
         } else if (a === '--older-than') {
             // Accept "7d" / "30d" / "12h" / raw number (days).
             const raw = rest[++i] || '';
@@ -4092,6 +4120,56 @@ async function runResumeCli() {
             process.exit(0);
         }
 
+        // --validate: verify the handoff's file references still exist
+        // on disk. Resolves each path relative to the handoff's repo_path
+        // (or cwd). Reports per-path status. Useful before resuming to
+        // catch "the file was moved or deleted since the handoff".
+        if (flags.validate) {
+            if (!found) {
+                process.stderr.write('No resume handoff available to validate.\n');
+                process.exit(3);
+            }
+            const handoff = payload.resume_handoff.handoff;
+            const repoRoot = handoff.repo_path || process.env.CF_MEMORY_WATCH_PATH || process.cwd();
+            const results = [];
+            const checkPath = (relPath, kind) => {
+                try {
+                    const full = path.isAbsolute(relPath) ? relPath : path.join(repoRoot, relPath);
+                    const exists = fs.existsSync(full);
+                    results.push({ kind, path: relPath, exists });
+                } catch (_) {
+                    results.push({ kind, path: relPath, exists: false });
+                }
+            };
+            for (const f of (handoff.files_touched || [])) checkPath(f.path, 'touched');
+            for (const a of (handoff.code_anchors || [])) checkPath(a.file_path, 'anchor');
+            const missing = results.filter(r => !r.exists);
+
+            if (flags.json) {
+                process.stdout.write(JSON.stringify({
+                    repo_root: repoRoot,
+                    total: results.length,
+                    missing_count: missing.length,
+                    results,
+                }, null, 2) + '\n');
+                process.exit(missing.length === 0 ? 0 : 4);
+            }
+            process.stdout.write(`Validating ${results.length} file reference${results.length === 1 ? '' : 's'} against ${repoRoot}:\n\n`);
+            for (const r of results) {
+                const mark = r.exists ? '✓' : '✗';
+                process.stdout.write(`  ${mark} [${r.kind}] ${r.path}\n`);
+            }
+            process.stdout.write(`\n`);
+            if (missing.length === 0) {
+                process.stdout.write(`All ${results.length} references exist.\n`);
+                process.exit(0);
+            } else {
+                process.stdout.write(`${missing.length} of ${results.length} references are missing.\n`);
+                process.stdout.write(`The repo has moved or these files were deleted since the handoff was written.\n`);
+                process.exit(4);
+            }
+        }
+
         // --md <path>: write the rendered markdown to a file instead of
         // (or in addition to) stdout. Useful for piping to a markdown
         // viewer or saving to the project.
@@ -4566,8 +4644,10 @@ const PER_COMMAND_HELP = {
     --anchors-only        code_anchors as "file:lines symbol".
     --decisions-only      decisions, one per line.
     --blockers-only       open blockers, one per line.
+    --chain               Walk parent_session_id back; show the thread history.
+    --validate            Check that files_touched + code_anchors still exist locally.
     --json, -j            Full bootstrap payload as JSON.
-  Exit codes: 0 = found, 3 = no handoff / no data.`,
+  Exit codes: 0 = found, 3 = no handoff / no data, 4 = --validate found missing files.`,
     list: `cf-memory-mcp list [--status S] [--since ISO] [--repo PATH] [--limit N] [--json]
   List recent handoffs for the current cwd, status-ranked. Header shows
   a status-count summary.
@@ -4648,6 +4728,20 @@ async function runDoctorCli() {
     const checks = [];
     const add = (label, ok, detail, fix) => checks.push({ label, ok, detail, ...(fix && !ok ? { fix } : {}) });
 
+    // 0. Installed vs latest npm version. Best-effort: skipped on
+    // network failure or when registry is unreachable. Doesn't add to
+    // exit-code failures so doctor still passes if you're just behind.
+    try {
+        const latest = await checkLatestNpmVersion(PACKAGE_VERSION, 1500);
+        if (latest && latest !== PACKAGE_VERSION) {
+            add(`npm version current`, false,
+                `installed v${PACKAGE_VERSION}, latest v${latest}`,
+                `npm install -g cf-memory-mcp@latest  # or: npx cf-memory-mcp@${latest}`);
+        } else if (latest) {
+            add(`npm version current`, true, `v${PACKAGE_VERSION} (latest)`);
+        }
+    } catch (_) { /* network failure or registry timeout — skip */ }
+
     // 1. API key set?
     add('CF_MEMORY_API_KEY set', !!API_KEY,
         API_KEY ? '(redacted)' : 'unset — most commands will fail',

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "cf-memory-mcp",
-	"version": "3.37.0",
+	"version": "3.39.0",
 	"description": "Cloudflare-hosted MCP server for code indexing, retrieval, and assistant memory with a direct remote MCP endpoint and local stdio bridge.",
 	"main": "bin/cf-memory-mcp.js",
 	"bin": {