cf-memory-mcp 3.55.0 → 3.57.0

package/bin/cf-memory-mcp.js

@@ -3919,7 +3919,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']);
+const SUBCOMMANDS = new Set(['resume', 'list', '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'))) {
@@ -3936,6 +3936,7 @@ Usage:
   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
   npx cf-memory-mcp explain <id>     Break down the handoff's quality_score
+  npx cf-memory-mcp gha [<id>]       Append rendered resume packet to $GITHUB_STEP_SUMMARY
   npx cf-memory-mcp status          Show bridge state + server resume availability
   npx cf-memory-mcp clean           Delete local disk cache for current cwd
   npx cf-memory-mcp clean --all     Delete ALL local disk caches
@@ -4038,6 +4039,12 @@ function parseCliArgs(rest) {
             flags.blockers_only = true;
         } else if (a === '--chain') {
             flags.chain = true;
+        } else if (a === '--include-chain') {
+            const n = parseInt(rest[++i], 10);
+            flags.include_chain = Number.isFinite(n) && n > 0 ? Math.min(n, 10) : 3;
+        } else if (a.startsWith('--include-chain=')) {
+            const n = parseInt(a.slice('--include-chain='.length), 10);
+            flags.include_chain = Number.isFinite(n) && n > 0 ? Math.min(n, 10) : 3;
         } else if (a === '--validate') {
             flags.validate = true;
         } else if (a === '--raw') {
@@ -4614,6 +4621,32 @@ async function runResumeCli() {
             } else {
                 process.stdout.write(JSON.stringify(payload.resume_handoff, null, 2) + '\n');
             }
+            // --include-chain N: walk parent_session_id back N times and
+            // append each parent's resume_prompt inline so the agent sees
+            // the full thread arc in one output.
+            if (flags.include_chain && flags.include_chain > 0) {
+                let cur = payload.resume_handoff;
+                for (let i = 0; i < flags.include_chain; i++) {
+                    const parentId = cur?.handoff?.parent_session_id;
+                    if (!parentId) break;
+                    const parentRes = await server.makeRequest({
+                        jsonrpc: '2.0', id: `cli-include-chain-${i}-${Date.now()}`,
+                        method: 'tools/call',
+                        params: { name: 'get_context_bootstrap', arguments: { resume: true, session_id_hint: parentId } },
+                    });
+                    const parentText = parentRes?.result?.content?.[0]?.text;
+                    const parentPayload = JSON.parse(parentText || '{}');
+                    if (!parentPayload.resume_handoff) break;
+                    process.stdout.write(`\n---\n## ↑ Parent ${i + 1}: ${(parentPayload.resume_handoff.session_id||'').slice(0,8)}\n\n`);
+                    if (parentPayload.resume_prompt) {
+                        // Strip the parent's own "## Resume context" header
+                        // to avoid duplicated h2s.
+                        const cleaned = parentPayload.resume_prompt.replace(/^## Resume context from previous session\n+/, '');
+                        process.stdout.write(cleaned + '\n');
+                    }
+                    cur = parentPayload.resume_handoff;
+                }
+            }
             if (Array.isArray(payload.recent_handoffs) && payload.recent_handoffs.length > 1) {
                 process.stdout.write('\n---\nOther recent handoffs:\n');
                 for (const h of payload.recent_handoffs.slice(0, 4)) {
@@ -4635,6 +4668,59 @@ async function runResumeCli() {
     }
 }
 
+async function runGhaCli() {
+    if (!API_KEY) {
+        console.error('Error: CF_MEMORY_API_KEY environment variable is required');
+        process.exit(1);
+    }
+    const { positional } = parseCliArgs(process.argv.slice(3));
+    const sessionArg = positional[0]; // optional
+    const server = new CFMemoryMCP();
+    server.logDebug = () => {};
+    try {
+        const meta = server.getRepoMetadata();
+        const args = { resume: true };
+        if (meta.repo_path) args.repo_path = meta.repo_path;
+        if (meta.branch) args.branch = meta.branch;
+        if (sessionArg) args.session_id_hint = sessionArg;
+        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', id: `cli-gha-${Date.now()}`,
+            method: 'tools/call',
+            params: { name: 'get_context_bootstrap', arguments: args },
+        });
+        const text = response?.result?.content?.[0]?.text;
+        const payload = JSON.parse(text || '{}');
+        if (!payload.resume_handoff || !payload.resume_prompt) {
+            process.stderr.write((payload.empty_hint || 'No resume handoff available.') + '\n');
+            process.exit(3);
+        }
+        const summary = process.env.GITHUB_STEP_SUMMARY;
+        const body = payload.resume_prompt + '\n';
+        if (summary) {
+            try {
+                fs.appendFileSync(summary, body);
+                process.stderr.write(`Appended resume packet to $GITHUB_STEP_SUMMARY (${body.length} chars)\n`);
+                process.exit(0);
+            } catch (err) {
+                process.stderr.write(`Failed to write to $GITHUB_STEP_SUMMARY: ${err.message}\n`);
+                process.exit(1);
+            }
+        }
+        // Fallback: outside GHA, print to stdout. Lets users test the
+        // formatting locally before deploying.
+        process.stdout.write(body);
+        process.stderr.write(`(GITHUB_STEP_SUMMARY not set — printed to stdout. In GHA, this would append to the step summary.)\n`);
+        process.exit(0);
+    } catch (err) {
+        console.error('gha command failed:', err.message);
+        process.exit(1);
+    }
+}
+
 async function runExplainCli() {
     if (!API_KEY) {
         console.error('Error: CF_MEMORY_API_KEY environment variable is required');
@@ -5211,7 +5297,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', 'status', 'clean', 'export', 'import', 'delete', 'doctor', 'env', 'completion'];
+    const commands = ['resume', 'list', '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
@@ -5391,6 +5477,7 @@ const PER_COMMAND_HELP = {
     --decisions-only      decisions, one per line.
     --blockers-only       open blockers, one per line.
     --chain               Walk parent_session_id back; show the thread history.
+    --include-chain N     Inline the last N parent handoffs in the rendered output (default 3, max 10).
     --diff <other-id>     Compare this handoff against another (added/removed/changed fields).
     --validate            Check that files_touched + code_anchors still exist locally.
     --raw                 Print just the raw handoff JSON (no envelope metadata).
@@ -5486,6 +5573,10 @@ const PER_COMMAND_HELP = {
   showing what's earned + what's missing. Lets users see why a handoff
   scored 0.5 vs 0.9 — and how to improve it.
     --json, -j            Emit the breakdown as JSON.`,
+    gha: `cf-memory-mcp gha [<session-id-or-prefix>]
+  GitHub Actions integration: append the rendered resume packet to
+  $GITHUB_STEP_SUMMARY. Falls back to stdout when run outside GHA.
+  Useful in a workflow step to surface what the agent was doing.`,
 };
 
 function printPerCommandHelp(cmd) {
@@ -6293,6 +6384,11 @@ if (process.argv[2] === 'explain') {
     return;
 }
 
+if (process.argv[2] === 'gha') {
+    runGhaCli();
+    return;
+}
+
 if (process.argv.includes('--diagnose')) {
     (async () => {
         console.log(`CF Memory MCP v${PACKAGE_VERSION} - Diagnostics`);

package/package.json

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