cf-memory-mcp 3.62.0 → 3.64.0

package/bin/cf-memory-mcp.js

@@ -3955,7 +3955,7 @@ if (process.argv.includes('--version') || process.argv.includes('-v')) {
 
 // Global --help only when no subcommand is present. With a subcommand, fall
 // through to the per-command help dispatch below.
-const SUBCOMMANDS = new Set(['resume', 'list', 'checkpoint', 'status', 'clean', 'export', 'import', 'doctor', 'completion', 'delete', 'env', 'history', 'link', 'explain', 'gha']);
+const SUBCOMMANDS = new Set(['resume', 'list', 'search', 'checkpoint', 'status', 'clean', 'export', 'import', 'doctor', 'completion', 'delete', 'env', 'history', 'link', 'explain', 'gha']);
 const hasSubcommand = process.argv[2] && SUBCOMMANDS.has(process.argv[2]);
 
 if (!hasSubcommand && (process.argv.includes('--help') || process.argv.includes('-h'))) {
@@ -3968,6 +3968,7 @@ Usage:
   npx cf-memory-mcp                 Start the MCP server
   npx cf-memory-mcp resume [id]     Print the prior resume handoff (markdown)
   npx cf-memory-mcp list            List recent handoffs for cwd (status-ranked)
+  npx cf-memory-mcp search <query>  Find handoffs by goal/notes/decisions text (cross-repo default)
   npx cf-memory-mcp history         List all handoffs for cwd, chronological
   npx cf-memory-mcp checkpoint ["<goal>"]  Snapshot current state (keep_open)
   npx cf-memory-mcp link <child> --parent <id>  Retroactively link a child session to a parent
@@ -4144,6 +4145,10 @@ function parseCliArgs(rest) {
             flags.repo_path = rest[++i];
         } else if (a.startsWith('--repo=')) {
             flags.repo_path = a.slice('--repo='.length);
+        } else if (a === '--repo-prefix') {
+            flags.repo_path_prefix = rest[++i];
+        } else if (a.startsWith('--repo-prefix=')) {
+            flags.repo_path_prefix = a.slice('--repo-prefix='.length);
         } else if (a === '--project-id') {
             flags.project_id = rest[++i];
         } else if (a.startsWith('--project-id=')) {
@@ -4158,6 +4163,10 @@ function parseCliArgs(rest) {
             flags.since = a.slice('--since='.length);
         } else if (a === '--yes' || a === '-y') {
             flags.yes = true;
+        } else if (a === '--ids-only') {
+            flags.ids_only = true;
+        } else if (a === '--here') {
+            flags.here = true;
         } else positional.push(a);
     }
     return { positional, flags };
@@ -4995,6 +5004,116 @@ async function runListCli() {
     }
 }
 
+async function runSearchCli() {
+    if (!API_KEY) {
+        console.error('Error: CF_MEMORY_API_KEY environment variable is required');
+        process.exit(1);
+    }
+    const { positional, flags } = parseCliArgs(process.argv.slice(3));
+    const query = positional[0];
+    if (!query) {
+        console.error('Usage: cf-memory-mcp search <query> [--repo <path>] [--project-id <id>] [--status <s>] [--since <iso>] [--limit N] [--json] [--ids-only]');
+        console.error('Searches across goal/next_steps/notes/decisions/blockers (case-insensitive substring).');
+        console.error('Defaults to ALL your handoffs (cross-repo). Use --repo or --project-id to scope.');
+        process.exit(1);
+    }
+    const server = new CFMemoryMCP();
+    server.logDebug = () => {};
+    server.logError = (...a) => process.stderr.write(a.join(' ') + '\n');
+    try {
+        // Server-side substring filter via goal_contains (which actually
+        // matches the whole serialized handoff JSON — goal, next_steps,
+        // notes, decisions, blockers, code_anchors, files_touched).
+        const args = { resume: true, goal_contains: query };
+        // Default: NO repo/project scoping — search is meant to be global.
+        // Opt-in via --repo or --project-id (or --here for cwd's repo).
+        if (flags.repo_path) args.repo_path = flags.repo_path;
+        if (flags.project_id) args.project_id = flags.project_id;
+        if (flags.here) {
+            const meta = server.getRepoMetadata();
+            if (meta.repo_path) args.repo_path = meta.repo_path;
+            if (meta.branch) args.branch = meta.branch;
+        }
+        if (flags.status) args.status_filter = flags.status;
+        if (flags.since) args.since = flags.since;
+
+        const response = await server.makeRequest({
+            jsonrpc: '2.0',
+            id: `cli-search-${Date.now()}`,
+            method: 'tools/call',
+            params: { name: 'get_context_bootstrap', arguments: args },
+        });
+        const text = response?.result?.content?.[0]?.text;
+        const payload = JSON.parse(text || '{}');
+        const allList = Array.isArray(payload.recent_handoffs) ? payload.recent_handoffs : [];
+        const list = flags.limit ? allList.slice(0, flags.limit) : allList;
+
+        if (flags.ids_only) {
+            for (const h of list) process.stdout.write(`${h.session_id || ''}\n`);
+            process.exit(list.length === 0 ? 3 : 0);
+        }
+        if (flags.json) {
+            process.stdout.write(JSON.stringify({
+                query,
+                scope: args.repo_path ? 'repo' : args.project_id ? 'project' : 'global',
+                repo_path: args.repo_path,
+                project_id: args.project_id,
+                status_filter: flags.status,
+                since: flags.since,
+                count: list.length,
+                handoffs: list,
+            }, null, 2) + '\n');
+            process.exit(list.length === 0 ? 3 : 0);
+        }
+        if (list.length === 0) {
+            process.stderr.write(`No handoffs match "${query}".\n`);
+            process.exit(3);
+        }
+        // Render with terminal highlight (ANSI bold) when stdout is a TTY.
+        const tty = process.stdout.isTTY;
+        const lcQuery = query.toLowerCase();
+        const highlight = (str) => {
+            if (!str) return str;
+            if (!tty) return str;
+            const idx = str.toLowerCase().indexOf(lcQuery);
+            if (idx < 0) return str;
+            const before = str.slice(0, idx);
+            const match = str.slice(idx, idx + query.length);
+            const after = str.slice(idx + query.length);
+            return `${before}\x1b[1;33m${match}\x1b[0m${after}`;
+        };
+        const fmtAge = (iso) => {
+            if (!iso) return '?';
+            const min = Math.round((Date.now() - new Date(iso).getTime()) / 60000);
+            if (min < 60) return `${min}m`;
+            if (min < 1440) return `${Math.round(min/60)}h`;
+            return `${Math.round(min/1440)}d`;
+        };
+        const scopeLabel = args.repo_path ? `in repo ${args.repo_path}` : args.project_id ? `in project ${args.project_id}` : 'across all your handoffs';
+        process.stdout.write(`Found ${list.length} handoff${list.length === 1 ? '' : 's'} matching "${query}" ${scopeLabel}:\n\n`);
+        for (const h of list) {
+            const shortId = (h.session_id || '').slice(0, 8);
+            const age = fmtAge(h.ended_at || h.started_at);
+            const status = (h.status || 'unknown').padEnd(11);
+            const branch = h.branch ? `[${h.branch}] ` : '';
+            const goal = highlight((h.goal || '(no goal)').slice(0, 100));
+            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: ${highlight(h.next_step.slice(0, 100))}\n`);
+            // If the repo differs from the user's cwd, surface it so they
+            // know which project the handoff belongs to.
+            if (h.repo_path && !args.repo_path) {
+                process.stdout.write(`              repo: ${h.repo_path}\n`);
+            }
+        }
+        process.stdout.write(`\n(Run "npx cf-memory-mcp resume <id>" to load one, or pipe to "xargs -I{} npx cf-memory-mcp resume {}" with --ids-only)\n`);
+        process.exit(0);
+    } catch (err) {
+        console.error('search command failed:', err.message);
+        process.exit(1);
+    }
+}
+
 async function runLinkCli() {
     if (!API_KEY) {
         console.error('Error: CF_MEMORY_API_KEY environment variable is required');
@@ -5165,14 +5284,15 @@ async function runDeleteCli() {
     }
     const { positional, flags } = parseCliArgs(process.argv.slice(3));
     const idArg = positional[0];
-    const bulkMode = !idArg && (flags.older_than_days !== undefined || flags.status || flags.repo_path);
+    const bulkMode = !idArg && (flags.older_than_days !== undefined || flags.status || flags.repo_path || flags.repo_path_prefix);
     if (!idArg && !bulkMode) {
         console.error('Usage:');
         console.error('  cf-memory-mcp delete <session-id-or-prefix>          # single delete');
         console.error('  cf-memory-mcp delete --older-than 30d                # bulk delete by age');
         console.error('  cf-memory-mcp delete --status abandoned              # bulk by status');
-        console.error('  cf-memory-mcp delete --repo /path/to/repo            # bulk by repo');
-        console.error('  Combine filters; use --yes to confirm >5 deletions.');
+        console.error('  cf-memory-mcp delete --repo /path/to/repo            # bulk by exact repo');
+        console.error('  cf-memory-mcp delete --repo-prefix /tmp/cfm-         # bulk by repo prefix');
+        console.error('  Combine filters; without --yes you get a dry-run preview.');
         process.exit(1);
     }
     const server = new CFMemoryMCP();
@@ -5183,6 +5303,7 @@ async function runDeleteCli() {
             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;
+            if (flags.repo_path_prefix) args.repo_path_prefix = flags.repo_path_prefix;
 
             // Dry-run preview when --yes is missing. The server returns
             // {deleted:false, deleted_count, deleted_session_ids[]} so the
@@ -5193,6 +5314,16 @@ async function runDeleteCli() {
                     method: 'tools/call',
                     params: { name: 'delete_session', arguments: { ...args, dry_run: true } },
                 });
+                // Surface JSON-RPC errors (e.g. "repo_path_prefix too short")
+                // instead of swallowing them into a "no matches" message.
+                if (previewRes?.error) {
+                    if (flags.json) {
+                        process.stdout.write(JSON.stringify({ error: previewRes.error }, null, 2) + '\n');
+                    } else {
+                        process.stderr.write(`Error: ${previewRes.error.message || JSON.stringify(previewRes.error)}\n`);
+                    }
+                    process.exit(1);
+                }
                 const previewText = previewRes?.result?.content?.[0]?.text;
                 const preview = JSON.parse(previewText || '{}');
                 if (flags.json) {
@@ -5249,6 +5380,14 @@ async function runDeleteCli() {
                 method: 'tools/call',
                 params: { name: 'delete_session', arguments: args },
             });
+            if (deleteRes?.error) {
+                if (flags.json) {
+                    process.stdout.write(JSON.stringify({ error: deleteRes.error }, null, 2) + '\n');
+                } else {
+                    process.stderr.write(`Error: ${deleteRes.error.message || JSON.stringify(deleteRes.error)}\n`);
+                }
+                process.exit(1);
+            }
             const deleteText = deleteRes?.result?.content?.[0]?.text;
             const payload = JSON.parse(deleteText || '{}');
             // Implicit-cache invalidation: if any deleted id matches the
@@ -5294,6 +5433,14 @@ async function runDeleteCli() {
             method: 'tools/call',
             params: { name: 'delete_session', arguments: { session_id: fullId } },
         });
+        if (deleteRes?.error) {
+            if (flags.json) {
+                process.stdout.write(JSON.stringify({ error: deleteRes.error, session_id: fullId }, null, 2) + '\n');
+            } else {
+                process.stderr.write(`Error: ${deleteRes.error.message || JSON.stringify(deleteRes.error)}\n`);
+            }
+            process.exit(1);
+        }
         const deleteText = deleteRes?.result?.content?.[0]?.text;
         const payload = JSON.parse(deleteText || '{}');
         // Drop the implicit-session disk cache if the deleted id matches
@@ -5389,7 +5536,7 @@ function runCompletionCli() {
         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', 'gha', 'status', 'clean', 'export', 'import', 'delete', 'doctor', 'env', 'completion'];
+    const commands = ['resume', 'list', 'search', 'history', 'checkpoint', 'link', 'explain', 'gha', 'status', 'clean', 'export', 'import', 'delete', 'doctor', 'env', 'completion'];
     const flags = ['--json', '-j', '--limit', '-n', '--md', '--all', '--force', '-f', '--version', '-v', '--help', '-h', '--diagnose'];
 
     // Determine the install target for each shell. Use user-local paths
@@ -5593,6 +5740,23 @@ const PER_COMMAND_HELP = {
     --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.`,
+    search: `cf-memory-mcp search <query> [--here | --repo PATH | --project-id ID] [--status S] [--since ISO] [--limit N] [--json|--ids-only]
+  Find handoffs matching <query> across goal, next_steps, notes,
+  decisions, blockers, code_anchors, and files_touched (case-insensitive
+  substring). Default scope is ALL your handoffs (cross-repo). Highlights
+  the matched substring in terminal output.
+    <query>               Required substring to search for.
+    --here                Scope to cwd's repo (otherwise: global).
+    --repo PATH           Scope to a specific repo path.
+    --project-id ID       Scope to a specific project.
+    --status S            Filter by status (in_progress, completed, ...).
+    --since ISO           Lower bound on handoff timestamp (ISO 8601).
+    --limit N             Max entries to render (server may cap at 50).
+    --ids-only            Print only session_ids (xargs-friendly).
+    --json, -j            Emit JSON for scripts.
+  Exit codes: 0 = matches, 3 = no matches.
+  Example: cf-memory-mcp search "OAuth" --status in_progress
+           cf-memory-mcp search "migration" --ids-only | xargs -I{} cfm resume {}`,
     checkpoint: `cf-memory-mcp checkpoint ["<goal>"] [--force] [--json]
   Snapshot current state to a fresh handoff with keep_open:true. The
   session stays active for future checkpoints. The final end_session (or
@@ -5634,12 +5798,15 @@ const PER_COMMAND_HELP = {
     --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]
+  cf-memory-mcp delete [--status STATUS] [--older-than 30d] [--repo PATH] [--repo-prefix PFX] --yes [--json]
   Delete session row(s) and any session_summary memories tied to them.
     <session-id>          Single delete: full UUID or short prefix (>=8 chars).
     --status STATUS       Bulk filter by status (abandoned, completed, ...).
     --older-than 30d      Bulk filter by age (suffixes: d, h, m).
-    --repo PATH           Bulk filter by repo_path.
+    --repo PATH           Bulk filter by repo_path (exact match).
+    --repo-prefix PFX     Bulk filter by repo_path PREFIX (min 4 chars).
+                          E.g. --repo-prefix /tmp/cfm-lifecycle- nukes
+                          accumulated benchmark artifacts in one call.
     --yes, -y             Required for bulk delete to confirm intent.
     --json, -j            Emit JSON.
   Exit codes: 0 = deleted, 2 = bulk missing --yes, 3 = nothing matched.`,
@@ -6428,6 +6595,11 @@ if (process.argv[2] === 'list') {
     return;
 }
 
+if (process.argv[2] === 'search') {
+    runSearchCli();
+    return;
+}
+
 if (process.argv[2] === 'checkpoint') {
     runCheckpointCli();
     return;

package/package.json

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