cf-memory-mcp 3.62.0 → 3.63.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
@@ -4158,6 +4159,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 +5000,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');
@@ -5389,7 +5504,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 +5708,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
@@ -6428,6 +6560,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.63.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": {