cf-memory-mcp 3.49.0 → 3.50.0

package/bin/cf-memory-mcp.js

@@ -4399,21 +4399,34 @@ async function runResumeCli() {
         // --diff <other-id>: compare two handoffs. Shows added/removed
         // next_steps, branch shift, status change, files diff. Useful
         // for "what changed between yesterday's session and today's?".
+        // Special value "--parent" diffs against the chain parent.
         if (flags.diff) {
             if (!found) {
                 process.stderr.write('No source handoff available to diff against.\n');
                 process.exit(3);
             }
+            let diffTarget = flags.diff;
+            // --diff --parent: resolve to the parent_session_id from the
+            // current handoff so users can do "what's new since the
+            // last checkpoint" without typing the parent's id.
+            if (diffTarget === '--parent' || diffTarget === 'parent') {
+                const parentId = payload.resume_handoff.handoff?.parent_session_id;
+                if (!parentId) {
+                    process.stderr.write('This handoff has no parent_session_id to diff against.\n');
+                    process.exit(3);
+                }
+                diffTarget = parentId;
+            }
             const otherRes = await server.makeRequest({
                 jsonrpc: '2.0', id: `cli-diff-${Date.now()}`,
                 method: 'tools/call',
-                params: { name: 'get_context_bootstrap', arguments: { resume: true, session_id_hint: flags.diff } },
+                params: { name: 'get_context_bootstrap', arguments: { resume: true, session_id_hint: diffTarget } },
             });
             const otherText = otherRes?.result?.content?.[0]?.text;
             const otherPayload = JSON.parse(otherText || '{}');
             const otherHandoff = otherPayload.resume_handoff?.handoff;
             if (!otherHandoff) {
-                process.stderr.write(`Could not fetch handoff "${flags.diff}" to diff against.\n`);
+                process.stderr.write(`Could not fetch handoff "${diffTarget}" to diff against.\n`);
                 process.exit(3);
             }
             const h = payload.resume_handoff.handoff;
@@ -5359,8 +5372,25 @@ async function runDoctorCli() {
         }
     }
 
+    // Optional: handoff stats summary at the bottom (visibility into
+    // how much resume context is captured for the current user).
+    let handoffStats = null;
+    if (API_KEY) {
+        try {
+            const statsRes = await server.makeRequestOnce({
+                jsonrpc: '2.0', id: `doctor-stats-${Date.now()}`,
+                method: 'tools/call', params: { name: 'get_stats', arguments: {} },
+            });
+            const statsText = statsRes?.result?.content?.[0]?.text;
+            if (statsText) {
+                const statsPayload = JSON.parse(statsText);
+                if (statsPayload?.handoffs) handoffStats = statsPayload.handoffs;
+            }
+        } catch (_) { /* skip on failure */ }
+    }
+
     if (flags.json) {
-        process.stdout.write(JSON.stringify({ checks }, null, 2) + '\n');
+        process.stdout.write(JSON.stringify({ checks, ...(handoffStats ? { handoffs: handoffStats } : {}) }, null, 2) + '\n');
         process.exit(checks.every(c => c.ok) ? 0 : 1);
     }
     process.stdout.write(`cf-memory-mcp v${PACKAGE_VERSION} — doctor\n\n`);
@@ -5373,6 +5403,23 @@ async function runDoctorCli() {
             process.stdout.write(`      → ${c.fix}\n`);
         }
     }
+    if (handoffStats) {
+        process.stdout.write('\nHandoff stats:\n');
+        process.stdout.write(`  total:              ${handoffStats.total}\n`);
+        if (handoffStats.by_status) {
+            const byStatus = Object.entries(handoffStats.by_status)
+                .map(([s, n]) => `${s}=${n}`).join(', ');
+            process.stdout.write(`  by_status:          ${byStatus}\n`);
+        }
+        if (handoffStats.oldest_in_progress) {
+            const o = handoffStats.oldest_in_progress;
+            const shortId = (o.session_id || '').slice(0, 8);
+            process.stdout.write(`  oldest in_progress: ${shortId} (${o.age_minutes}m ago)\n`);
+        }
+        if (handoffStats.by_repo && handoffStats.by_repo.length > 0) {
+            process.stdout.write(`  top repos:          ${handoffStats.by_repo.slice(0, 3).map(r => `${r.repo_path.split('/').pop()}=${r.count}`).join(', ')}\n`);
+        }
+    }
     process.stdout.write('\n');
     process.stdout.write(anyFailed ? 'Some checks failed. See suggestions above.\n' : 'All checks passed.\n');
     process.exit(anyFailed ? 1 : 0);

package/package.json

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