cf-memory-mcp 3.38.0 → 3.40.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.
@@ -4247,7 +4299,8 @@ async function runListCli() {
             const status = (h.status || 'unknown').padEnd(11);
             const branch = h.branch ? `[${h.branch}] ` : '';
             const goal = (h.goal || '(no goal)').slice(0, 80);
-            process.stdout.write(`  ${shortId}  ${status}  ${age.padStart(4)} ago  ${branch}${goal}\n`);
+            const q = typeof h.quality_score === 'number' ? ` q=${h.quality_score.toFixed(2)}` : '';
+            process.stdout.write(`  ${shortId}  ${status}  ${age.padStart(4)} ago${q}  ${branch}${goal}\n`);
             if (h.next_step) process.stdout.write(`              next: ${h.next_step.slice(0, 80)}\n`);
         }
         process.stdout.write(`\n(Run "npx cf-memory-mcp resume <id>" to see a specific handoff)\n`);
@@ -4559,6 +4612,26 @@ _cf_memory_mcp() {
     fi
 }
 _cf_memory_mcp "\$@"
+`);
+    } else if (shell === 'powershell' || shell === 'pwsh') {
+        process.stdout.write(`# cf-memory-mcp PowerShell completion
+# Install: cf-memory-mcp completion powershell | Out-String | Invoke-Expression
+# To persist: add the above to your $PROFILE
+Register-ArgumentCompleter -Native -CommandName cf-memory-mcp,cfm -ScriptBlock {
+    param($wordToComplete, $commandAst, $cursorPosition)
+    $commands = @('${commands.join("','")}')
+    $flags = @('${flags.filter(f => f.startsWith('--')).join("','")}')
+    $tokens = $commandAst.CommandElements | ForEach-Object { $_.Extent.Text }
+    if ($tokens.Count -le 2) {
+        $commands | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object {
+            [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_)
+        }
+    } elseif ($wordToComplete.StartsWith('--')) {
+        $flags | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object {
+            [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterName', $_)
+        }
+    }
+}
 `);
     } else if (shell === 'fish') {
         process.stdout.write(`# cf-memory-mcp fish completion
@@ -4573,7 +4646,7 @@ complete -c cf-memory-mcp -l help -s h -d 'Show help'
 complete -c cf-memory-mcp -l version -s v -d 'Show version'
 `);
     } else {
-        process.stderr.write(`Unknown shell "${shell}". Supported: bash, zsh, fish.\n`);
+        process.stderr.write(`Unknown shell "${shell}". Supported: bash, zsh, fish, powershell.\n`);
         process.exit(1);
     }
     process.exit(0);
@@ -4592,8 +4665,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.
@@ -4633,7 +4708,7 @@ const PER_COMMAND_HELP = {
   cache writability, worker reachability, project indexing, resume
   availability. Exit nonzero if any check fails.
     --json, -j            Emit a JSON list of checks.`,
-    completion: `cf-memory-mcp completion [bash|zsh|fish]
+    completion: `cf-memory-mcp completion [bash|zsh|fish|powershell]
   Output shell completion script. Pipe to your shell's completion dir.`,
     delete: `cf-memory-mcp delete <session-id-or-prefix> [--json]
   cf-memory-mcp delete [--status STATUS] [--older-than 30d] [--repo PATH] --yes [--json]

package/package.json

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