cf-memory-mcp 3.53.0 → 3.55.0

package/bin/cf-memory-mcp.js

@@ -4030,6 +4030,8 @@ function parseCliArgs(rest) {
             flags.files_only = true;
         } else if (a === '--anchors-only') {
             flags.anchors_only = true;
+        } else if (a === '--absolute') {
+            flags.absolute = true;
         } else if (a === '--decisions-only') {
             flags.decisions_only = true;
         } else if (a === '--blockers-only') {
@@ -4196,11 +4198,15 @@ async function runResumeCli() {
         // --files-only: list files_touched paths, one per line. Designed
         // for xargs / cat pipelines:
         //   $ cat $(cf-memory-mcp resume --files-only)
+        // --absolute: prepend handoff.repo_path so paths work from any cwd.
         if (flags.files_only) {
             const files = payload.resume_handoff?.handoff?.files_touched || [];
             if (files.length === 0) process.exit(3);
+            const repoRoot = payload.resume_handoff?.handoff?.repo_path;
+            const toAbs = (p) => (flags.absolute && repoRoot && !path.isAbsolute(p))
+                ? path.join(repoRoot, p) : p;
             for (const f of files) {
-                if (f.path) process.stdout.write(f.path + '\n');
+                if (f.path) process.stdout.write(toAbs(f.path) + '\n');
             }
             process.exit(0);
         }
@@ -4212,8 +4218,12 @@ async function runResumeCli() {
                 || payload.resume_handoff?.handoff?.code_anchors
                 || [];
             if (anchors.length === 0) process.exit(3);
+            const repoRoot = payload.resume_handoff?.handoff?.repo_path;
+            const toAbs = (p) => (flags.absolute && repoRoot && !path.isAbsolute(p))
+                ? path.join(repoRoot, p) : p;
             for (const a of anchors) {
-                const where = a.lines ? `${a.file_path}:${a.lines}` : a.file_path;
+                const filePath = toAbs(a.file_path);
+                const where = a.lines ? `${filePath}:${a.lines}` : filePath;
                 const sym = a.name ? ` ${a.name}` : '';
                 const staleMarker = a.stale ? ' [STALE]' : '';
                 process.stdout.write(`${where}${sym}${staleMarker}\n`);
@@ -4464,25 +4474,54 @@ async function runResumeCli() {
 
             const aShort = (payload.resume_handoff.session_id || '').slice(0, 8);
             const bShort = (otherPayload.resume_handoff.session_id || '').slice(0, 8);
-            const lines = [`Diff: ${aShort} (this) vs ${bShort} (other)`, ''];
-            // Scalar fields
-            const scalars = ['goal', 'status', 'branch', 'repo_path'];
-            for (const f of scalars) {
+
+            // Build a structured diff first; render either as JSON or
+            // as the human-readable +/- output.
+            const scalarDiff = {};
+            for (const f of ['goal', 'status', 'branch', 'repo_path']) {
                 if (h[f] !== otherHandoff[f]) {
-                    lines.push(`  ~ ${f}: "${otherHandoff[f] || ''}" → "${h[f] || ''}"`);
+                    scalarDiff[f] = { from: otherHandoff[f] ?? null, to: h[f] ?? null };
                 }
             }
-            // Array fields
-            const arrDiff = diffArr('next_steps', h.next_steps, otherHandoff.next_steps);
-            if (arrDiff) lines.push(arrDiff);
-            const blockerDiff = diffArr('blockers', h.blockers, otherHandoff.blockers);
-            if (blockerDiff) lines.push(blockerDiff);
-            const decisionDiff = diffArr('decisions', h.decisions, otherHandoff.decisions);
-            if (decisionDiff) lines.push(decisionDiff);
-            const fileDiff = diffArr('files_touched', h.files_touched, otherHandoff.files_touched, 'path');
-            if (fileDiff) lines.push(fileDiff);
-            const anchorDiff = diffArr('code_anchors', h.code_anchors, otherHandoff.code_anchors, 'file_path');
-            if (anchorDiff) lines.push(anchorDiff);
+            const arrayDiffObj = (a, b, key) => {
+                const A = setOf(a, key); const B = setOf(b, key);
+                return {
+                    added: [...A].filter(x => !B.has(x)),
+                    removed: [...B].filter(x => !A.has(x)),
+                };
+            };
+            const arrayDiffs = {
+                next_steps: arrayDiffObj(h.next_steps, otherHandoff.next_steps),
+                blockers: arrayDiffObj(h.blockers, otherHandoff.blockers),
+                decisions: arrayDiffObj(h.decisions, otherHandoff.decisions),
+                files_touched: arrayDiffObj(h.files_touched, otherHandoff.files_touched, 'path'),
+                code_anchors: arrayDiffObj(h.code_anchors, otherHandoff.code_anchors, 'file_path'),
+            };
+
+            if (flags.json) {
+                // Strip empty arrays from arrayDiffs for compactness.
+                const compactArrays = Object.fromEntries(
+                    Object.entries(arrayDiffs)
+                        .filter(([, v]) => v.added.length > 0 || v.removed.length > 0)
+                );
+                process.stdout.write(JSON.stringify({
+                    this: payload.resume_handoff.session_id,
+                    other: otherPayload.resume_handoff.session_id,
+                    scalars: scalarDiff,
+                    arrays: compactArrays,
+                    unchanged: Object.keys(scalarDiff).length === 0 && Object.keys(compactArrays).length === 0,
+                }, null, 2) + '\n');
+                process.exit(0);
+            }
+
+            const lines = [`Diff: ${aShort} (this) vs ${bShort} (other)`, ''];
+            for (const [f, v] of Object.entries(scalarDiff)) {
+                lines.push(`  ~ ${f}: "${v.from || ''}" → "${v.to || ''}"`);
+            }
+            for (const [label, v] of Object.entries(arrayDiffs)) {
+                if (v.added.length > 0) lines.push(`  + ${label}: ${v.added.join(', ')}`);
+                if (v.removed.length > 0) lines.push(`  - ${label}: ${v.removed.join(', ')}`);
+            }
             if (lines.length === 2) lines.push('  (no differences)');
             process.stdout.write(lines.join('\n') + '\n');
             process.exit(0);
@@ -5147,6 +5186,31 @@ function runCompletionCli() {
     const shell = process.argv[3] || 'bash';
     const install = process.argv.includes('--install');
     const uninstall = process.argv.includes('--uninstall');
+    const allShells = process.argv.includes('--all-shells');
+
+    // --install --all-shells: iterate every shell whose config dir is
+    // detectable and install completion for each. Convenience for users
+    // who use multiple shells. Re-spawns runCompletionCli per shell so
+    // we get clean per-shell install messages.
+    if (install && allShells) {
+        const shells = ['bash', 'zsh', 'fish', 'powershell'];
+        const { execFileSync } = require('child_process');
+        let installed = 0;
+        for (const s of shells) {
+            try {
+                const out = execFileSync(process.execPath, [__filename, 'completion', s, '--install'], {
+                    encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'],
+                });
+                if (out) process.stdout.write(out);
+                process.stderr.write(`  installed ${s}\n`);
+                installed++;
+            } catch (err) {
+                process.stderr.write(`  ${s}: ${err.message.split('\n')[0]}\n`);
+            }
+        }
+        process.stderr.write(`\nDone. Installed completion for ${installed} shell${installed === 1 ? '' : 's'}.\n`);
+        process.exit(installed > 0 ? 0 : 1);
+    }
     const commands = ['resume', 'list', 'history', 'checkpoint', 'link', 'explain', 'status', 'clean', 'export', 'import', 'delete', 'doctor', 'env', 'completion'];
     const flags = ['--json', '-j', '--limit', '-n', '--md', '--all', '--force', '-f', '--version', '-v', '--help', '-h', '--diagnose'];
 
@@ -5322,6 +5386,8 @@ const PER_COMMAND_HELP = {
     --next-steps          All next_steps, numbered.
     --files-only          files_touched paths, one per line (xargs-friendly).
     --anchors-only        code_anchors as "file:lines symbol".
+    --absolute            With --files-only/--anchors-only: prepend repo_path
+                          so paths work from any cwd.
     --decisions-only      decisions, one per line.
     --blockers-only       open blockers, one per line.
     --chain               Walk parent_session_id back; show the thread history.
@@ -5382,8 +5448,11 @@ 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|powershell]
-  Output shell completion script. Pipe to your shell's completion dir.`,
+    completion: `cf-memory-mcp completion [bash|zsh|fish|powershell] [--install [--all-shells] | --uninstall]
+  Output shell completion script (or install/uninstall it).
+    --install            Write to user-local config dir (no sudo).
+    --uninstall          Remove a previously-installed script.
+    --all-shells         With --install: install for every shell at once.`,
     delete: `cf-memory-mcp delete <session-id-or-prefix> [--json]
   cf-memory-mcp delete [--status STATUS] [--older-than 30d] [--repo PATH] --yes [--json]
   Delete session row(s) and any session_summary memories tied to them.

package/package.json

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