cf-memory-mcp 3.56.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
@@ -4667,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');
@@ -5243,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
@@ -5519,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) {
@@ -6326,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.56.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": {