cf-memory-mcp 3.34.0 → 3.36.0

package/bin/cf-memory-mcp.js

@@ -3872,6 +3872,16 @@ function parseCliArgs(rest) {
             flags.md_path = a.slice('--md='.length);
         } else if (a === '--next-only') {
             flags.next_only = true;
+        } else if (a === '--next-steps') {
+            flags.next_steps = true;
+        } else if (a === '--files-only') {
+            flags.files_only = true;
+        } else if (a === '--anchors-only') {
+            flags.anchors_only = true;
+        } else if (a === '--decisions-only') {
+            flags.decisions_only = true;
+        } else if (a === '--blockers-only') {
+            flags.blockers_only = true;
         } else if (a === '--older-than') {
             // Accept "7d" / "30d" / "12h" / raw number (days).
             const raw = rest[++i] || '';
@@ -3969,6 +3979,62 @@ async function runResumeCli() {
             }
         }
 
+        // --next-steps: print all next_steps, numbered. Good for piping
+        // to a task tracker or quick visual scan.
+        if (flags.next_steps) {
+            const steps = payload.next_actions
+                || payload.resume_handoff?.handoff?.next_steps
+                || [];
+            if (steps.length === 0) process.exit(3);
+            steps.forEach((s, i) => process.stdout.write(`${i + 1}. ${s}\n`));
+            process.exit(0);
+        }
+
+        // --files-only: list files_touched paths, one per line. Designed
+        // for xargs / cat pipelines:
+        //   $ cat $(cf-memory-mcp resume --files-only)
+        if (flags.files_only) {
+            const files = payload.resume_handoff?.handoff?.files_touched || [];
+            if (files.length === 0) process.exit(3);
+            for (const f of files) {
+                if (f.path) process.stdout.write(f.path + '\n');
+            }
+            process.exit(0);
+        }
+
+        // --anchors-only: list code_anchors as "file:lines symbol".
+        // Useful for jump-to-line tooling.
+        if (flags.anchors_only) {
+            const anchors = payload.active_code_context
+                || payload.resume_handoff?.handoff?.code_anchors
+                || [];
+            if (anchors.length === 0) process.exit(3);
+            for (const a of anchors) {
+                const where = a.lines ? `${a.file_path}:${a.lines}` : a.file_path;
+                const sym = a.name ? ` ${a.name}` : '';
+                const staleMarker = a.stale ? ' [STALE]' : '';
+                process.stdout.write(`${where}${sym}${staleMarker}\n`);
+            }
+            process.exit(0);
+        }
+
+        // --decisions-only: list decisions from the handoff, one per line.
+        if (flags.decisions_only) {
+            const decisions = payload.resume_handoff?.handoff?.decisions || [];
+            if (decisions.length === 0) process.exit(3);
+            for (const d of decisions) process.stdout.write(`- ${d}\n`);
+            process.exit(0);
+        }
+
+        // --blockers-only: list open blockers, one per line. Empty list
+        // exits 3 so scripts can branch on "no blockers".
+        if (flags.blockers_only) {
+            const blockers = payload.resume_handoff?.handoff?.blockers || [];
+            if (blockers.length === 0) process.exit(3);
+            for (const b of blockers) process.stdout.write(`- ${b}\n`);
+            process.exit(0);
+        }
+
         // --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.
@@ -4367,13 +4433,19 @@ complete -c cf-memory-mcp -l version -s v -d 'Show version'
 
 // Per-command help texts. Used when "cf-memory-mcp <cmd> --help" is invoked.
 const PER_COMMAND_HELP = {
-    resume: `cf-memory-mcp resume [<session-id-prefix>] [--md path] [--next-only] [--json]
+    resume: `cf-memory-mcp resume [<session-id-prefix>] [--md path] [<extract-flag>] [--json]
   Print the prior resume handoff (markdown by default).
     <session-id-prefix>   Optional: pick a specific session (>=8 char prefix or full UUID).
     --md <path>           Write the markdown to a file instead of stdout.
-    --next-only           Print just the first next_step (for shell prompts / one-liners).
-    --json, -j            Emit the full bootstrap payload as JSON for scripts.
-  Exit codes: 0 = handoff found, 3 = no handoff found.`,
+  Extract flags (pick one; each exits 3 if the section is empty):
+    --next-only           First next_step only (for shell prompts).
+    --next-steps          All next_steps, numbered.
+    --files-only          files_touched paths, one per line (xargs-friendly).
+    --anchors-only        code_anchors as "file:lines symbol".
+    --decisions-only      decisions, one per line.
+    --blockers-only       open blockers, one per line.
+    --json, -j            Full bootstrap payload as JSON.
+  Exit codes: 0 = found, 3 = no handoff / no data.`,
     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.
@@ -4842,11 +4914,14 @@ async function runCheckpointCli() {
         // Optional positional goal argument: `cf-memory-mcp checkpoint "<goal text>"`
         const goalArg = positional.filter(p => p !== '--force' && p !== '-f').join(' ').trim();
 
-        // Duplicate detection: before creating a new implicit session,
-        // check if there's a recent in_progress handoff for the same
-        // repo/branch. If so, suggest resuming it instead of churning a
-        // new one. Skipped with --force.
-        if (!force) {
+        // Duplicate detection + parent linking: before creating a new
+        // implicit session, check if there's a recent in_progress handoff
+        // for the same repo/branch. If so, suggest resuming it instead
+        // of churning a new one. With --force, proceed but record the
+        // existing session id as the new handoff's parent_session_id so
+        // the chain can be traced later.
+        let parentSessionId = null;
+        if (true) { // always probe to capture parent; --force only bypasses the abort
             const meta = server.getRepoMetadata();
             if (meta.repo_path) {
                 const probeArgs = { resume: true, repo_path: meta.repo_path, status_filter: 'in_progress', max_age_minutes: 60 };
@@ -4864,7 +4939,7 @@ async function runCheckpointCli() {
                     // Same-cwd implicit session won't be in the worker yet
                     // unless someone called start_session — we look for
                     // OTHER active threads on the same repo.
-                    if (recent) {
+                    if (recent && !force) {
                         const shortId = (recent.session_id || '').slice(0, 8);
                         const ageMin = recent.handoff_age_minutes ?? '?';
                         const status = recent.handoff?.status || '?';
@@ -4885,6 +4960,9 @@ async function runCheckpointCli() {
                         process.stderr.write(`Resume it: cf-memory-mcp resume ${shortId}\n`);
                         process.stderr.write(`Or re-run with --force to create a new session anyway.\n`);
                         process.exit(4);
+                    } else if (recent && force) {
+                        // --force: proceed, but record the parent link.
+                        parentSessionId = recent.session_id;
                     }
                 } catch (_) { /* probe failure is non-fatal */ }
             }
@@ -4902,6 +4980,7 @@ async function runCheckpointCli() {
         // this is a fresh process).
         const handoff = server.synthesizeMinimalHandoff();
         if (goalArg) handoff.goal = goalArg;
+        if (parentSessionId) handoff.parent_session_id = parentSessionId;
         if (meta.repo_path) handoff.repo_path = meta.repo_path;
         if (meta.branch) handoff.branch = meta.branch;
         const fake = { params: { name: 'retrieve_context', arguments: {} } };

package/package.json

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