cf-memory-mcp 3.32.0 → 3.34.0

package/bin/cf-memory-mcp.js

@@ -418,7 +418,8 @@ const TOOLS_LIST = [
                 session_id: { type: 'string', description: 'Full session UUID to delete (not a prefix).' },
                 status: { description: 'Status filter: single string or array of statuses (in_progress, blocked, completed, abandoned).' },
                 older_than_days: { type: 'number', description: 'Delete sessions older than N days.' },
-                repo_path: { type: 'string', description: 'Restrict to a specific repo_path.' }
+                repo_path: { type: 'string', description: 'Restrict to a specific repo_path.' },
+                dry_run: { type: 'boolean', description: 'When true, preview what would be deleted without actually deleting.' }
             }
         }
     }
@@ -3869,6 +3870,8 @@ function parseCliArgs(rest) {
             flags.md_path = rest[++i];
         } else if (a.startsWith('--md=')) {
             flags.md_path = a.slice('--md='.length);
+        } else if (a === '--next-only') {
+            flags.next_only = true;
         } else if (a === '--older-than') {
             // Accept "7d" / "30d" / "12h" / raw number (days).
             const raw = rest[++i] || '';
@@ -3894,6 +3897,10 @@ function parseCliArgs(rest) {
             flags.repo_path = rest[++i];
         } else if (a.startsWith('--repo=')) {
             flags.repo_path = a.slice('--repo='.length);
+        } else if (a === '--since') {
+            flags.since = rest[++i];
+        } else if (a.startsWith('--since=')) {
+            flags.since = a.slice('--since='.length);
         } else if (a === '--yes' || a === '-y') {
             flags.yes = true;
         } else positional.push(a);
@@ -3947,6 +3954,21 @@ async function runResumeCli() {
         // offline-fallback cache, not just MCP-stdio usage.
         if (found) server.saveResumeToDisk(response);
 
+        // --next-only: print just the first next_step. Useful for
+        // shell prompts, status bars, one-liner scripting:
+        //   $ cf-memory-mcp resume --next-only
+        if (flags.next_only) {
+            const next = (payload.next_actions && payload.next_actions[0])
+                || (payload.resume_handoff?.handoff?.next_steps && payload.resume_handoff.handoff.next_steps[0])
+                || '';
+            if (next) {
+                process.stdout.write(next + '\n');
+                process.exit(0);
+            } else {
+                process.exit(3);
+            }
+        }
+
         // --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.
@@ -4006,9 +4028,19 @@ async function runListCli() {
         const args = { resume: true };
         if (meta.repo_path) args.repo_path = meta.repo_path;
         if (meta.branch) args.branch = meta.branch;
-        const fake = { params: { name: 'retrieve_context', arguments: {} } };
-        await server.maybeFillProjectId(fake);
-        if (fake.params.arguments.project_id) args.project_id = fake.params.arguments.project_id;
+        // Pass-through server-side filters when set on the CLI.
+        if (flags.status) args.status_filter = flags.status;
+        if (flags.since) args.since = flags.since;
+        if (flags.repo_path) {
+            // --repo overrides cwd → skip cwd's project_id too. Otherwise
+            // tier-1 project_id_exact would short-circuit the lookup and
+            // return cwd's handoff regardless of repo_path.
+            args.repo_path = flags.repo_path;
+        } else {
+            const fake = { params: { name: 'retrieve_context', arguments: {} } };
+            await server.maybeFillProjectId(fake);
+            if (fake.params.arguments.project_id) args.project_id = fake.params.arguments.project_id;
+        }
 
         const response = await server.makeRequest({
             jsonrpc: '2.0',
@@ -4025,8 +4057,10 @@ async function runListCli() {
 
         if (flags.json) {
             process.stdout.write(JSON.stringify({
-                repo_path: meta.repo_path,
-                branch: meta.branch,
+                repo_path: args.repo_path || meta.repo_path,
+                branch: args.branch || meta.branch,
+                status_filter: flags.status,
+                since: flags.since,
                 count: list.length,
                 handoffs: list,
                 empty_hint: list.length === 0 ? payload.empty_hint : undefined,
@@ -4047,8 +4081,10 @@ async function runListCli() {
         const countSummary = Object.entries(counts)
             .map(([s, n]) => `${n} ${s}`)
             .join(', ');
-        // Render a compact table to terminal.
-        process.stdout.write(`Recent handoffs for ${meta.repo_path || 'this cwd'} (${countSummary}):\n\n`);
+        // Render a compact table to terminal. Show the actual filter
+        // applied (--repo override, or cwd default).
+        const displayRepo = args.repo_path || 'this cwd';
+        process.stdout.write(`Recent handoffs for ${displayRepo} (${countSummary}):\n\n`);
         const fmtAge = (iso) => {
             if (!iso) return '?';
             const min = Math.round((Date.now() - new Date(iso).getTime()) / 60000);
@@ -4094,22 +4130,69 @@ async function runDeleteCli() {
     server.logDebug = () => {};
     try {
         if (bulkMode) {
-            // Bulk delete path. First dry-run: query matching sessions
-            // count via list, then confirm with --yes for >5.
             const args = {};
             if (flags.status) args.status = flags.status;
             if (flags.older_than_days !== undefined) args.older_than_days = flags.older_than_days;
             if (flags.repo_path) args.repo_path = flags.repo_path;
 
-            // Preview: do an initial delete_session with the same filters
-            // to count matches via the response's deleted_session_ids
-            // (capped at 50). For larger counts we accept the cap as an
-            // approximation; the server handles all of them anyway.
-            // Use --yes to skip the preview/confirm prompt.
+            // Dry-run preview when --yes is missing. The server returns
+            // {deleted:false, deleted_count, deleted_session_ids[]} so the
+            // user can see what WOULD be deleted before committing.
             if (!flags.yes) {
-                process.stderr.write(`Dry-run: previewing matches without confirm prompt is not supported yet.\n`);
-                process.stderr.write(`Run again with --yes to confirm: cf-memory-mcp delete ${process.argv.slice(3).join(' ')} --yes\n`);
-                process.exit(2);
+                const previewRes = await server.makeRequest({
+                    jsonrpc: '2.0', id: `cli-delete-preview-${Date.now()}`,
+                    method: 'tools/call',
+                    params: { name: 'delete_session', arguments: { ...args, dry_run: true } },
+                });
+                const previewText = previewRes?.result?.content?.[0]?.text;
+                const preview = JSON.parse(previewText || '{}');
+                if (flags.json) {
+                    process.stdout.write(JSON.stringify({ ...preview, would_delete: true }, null, 2) + '\n');
+                    process.exit(2);
+                }
+                if (preview.deleted_count === 0) {
+                    process.stderr.write(`No sessions match the filters. Nothing to delete.\n`);
+                    process.exit(3);
+                }
+                process.stderr.write(`Would delete ${preview.deleted_count} session${preview.deleted_count === 1 ? '' : 's'}:\n`);
+                const previewIds = preview.deleted_session_ids || [];
+                for (const id of previewIds.slice(0, 10)) {
+                    process.stderr.write(`  ${id.slice(0, 8)}\n`);
+                }
+                if (previewIds.length > 10) {
+                    process.stderr.write(`  ... and ${preview.deleted_count - 10} more\n`);
+                }
+                // Interactive TTY: prompt for confirmation instead of
+                // requiring --yes. Piped/non-TTY stdin falls through to
+                // the "re-run with --yes" path (avoids hangs in scripts).
+                if (process.stdin.isTTY && process.stderr.isTTY) {
+                    process.stderr.write(`\nProceed with deletion? [y/N] `);
+                    const answer = await new Promise((resolve) => {
+                        process.stdin.setEncoding('utf8');
+                        let buf = '';
+                        const onData = (chunk) => {
+                            buf += chunk;
+                            const nl = buf.indexOf('\n');
+                            if (nl !== -1) {
+                                process.stdin.removeListener('data', onData);
+                                process.stdin.pause();
+                                resolve(buf.slice(0, nl).trim().toLowerCase());
+                            }
+                        };
+                        process.stdin.on('data', onData);
+                        process.stdin.resume();
+                    });
+                    if (answer === 'y' || answer === 'yes') {
+                        // Fall through to the actual delete below.
+                    } else {
+                        process.stderr.write(`Aborted.\n`);
+                        process.exit(2);
+                    }
+                } else {
+                    process.stderr.write(`\nRe-run with --yes to confirm:\n`);
+                    process.stderr.write(`  cf-memory-mcp delete ${process.argv.slice(3).join(' ')} --yes\n`);
+                    process.exit(2);
+                }
             }
 
             const deleteRes = await server.makeRequest({
@@ -4284,14 +4367,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] [--json]
+    resume: `cf-memory-mcp resume [<session-id-prefix>] [--md path] [--next-only] [--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.`,
-    list: `cf-memory-mcp list [--limit N] [--json]
-  List recent handoffs for the current cwd, status-ranked.
+    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.
+    --status S            Restrict to a given status (in_progress, completed, ...).
+    --since ISO           Lower bound on handoff timestamp (ISO 8601).
+    --repo PATH           Override the cwd's repo (peek at another repo).
     --limit N, -n N       Max number of entries (default 5, max 50).
     --json, -j            Emit a JSON array for scripts.`,
     checkpoint: `cf-memory-mcp checkpoint ["<goal>"] [--force] [--json]

package/package.json

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