cf-memory-mcp 3.38.0 → 3.39.0

package/bin/cf-memory-mcp.js

@@ -3912,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] || '';
@@ -4118,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.
@@ -4592,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.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "cf-memory-mcp",
-	"version": "3.38.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": {