cf-memory-mcp 3.17.0 → 3.18.0

package/bin/cf-memory-mcp.js

@@ -213,8 +213,9 @@ const TOOLS_LIST = [
                 repo_path: { type: 'string', description: 'Absolute project root path. Bridge auto-fills from cwd if omitted.' },
                 project_id: { type: 'string', description: 'Canonical project id (proj_...). Used before repo_path when set.' },
                 branch: { type: 'string', description: 'Current git branch. Mismatch downgrades match_confidence but does not hide. Bridge auto-fills from git.' },
-                session_id_hint: { type: 'string', description: 'Resume a specific session by id (overrides repo/branch matching). Useful after seeing recent_handoffs.' },
-                max_age_minutes: { type: 'number', description: 'Hard cutoff: hide handoffs older than this many minutes. Without it, older handoffs surface with reduced confidence.' }
+                session_id_hint: { type: 'string', description: 'Resume a specific session by id (overrides repo/branch matching). Full UUID or short prefix (>=8 chars). Useful after seeing recent_handoffs.' },
+                max_age_minutes: { type: 'number', description: 'Hard cutoff: hide handoffs older than this many minutes. Without it, older handoffs surface with reduced confidence.' },
+                goal_contains: { type: 'string', description: 'Substring filter on handoff content (goal/notes/decisions). Case-insensitive. Lets agents find a specific thread by what it was about.' }
             }
         }
     },
@@ -2637,10 +2638,63 @@ class CFMemoryMCP {
         // sees the recent trajectory ("what was I doing").
         const timelineNote = this.formatActivityTimeline();
         const baseNote = `Auto-synthesized by cf-memory-mcp bridge. Agent did not provide a handoff. Tool calls observed: ${this._toolCallCount || 0}. Set CF_MEMORY_AUTO_HANDOFF=off to disable.`;
-        handoff.notes = timelineNote ? `${baseNote}\n\nRecent activity:\n${timelineNote}` : baseNote;
+
+        // Workspace state: uncommitted changes + recent commits give the
+        // next chat real signal about what's been happening in the repo,
+        // not just what tools the agent called.
+        const workspaceState = this.getGitWorkspaceState();
+        const sections = [baseNote];
+        if (timelineNote) sections.push(`Recent activity:\n${timelineNote}`);
+        if (workspaceState) sections.push(`Workspace state:\n${workspaceState}`);
+        handoff.notes = sections.join('\n\n');
         return handoff;
     }
 
+    /**
+     * Snapshot the local git workspace: uncommitted file count, top
+     * changed files, last 3 commit messages. Used by auto-synthesized
+     * handoffs so the next chat sees real workspace state, not just
+     * tool-call activity. Best-effort: returns "" when git unavailable.
+     */
+    getGitWorkspaceState() {
+        try {
+            const meta = this.getRepoMetadata();
+            if (!meta.repo_path) return '';
+            const { execSync } = require('child_process');
+            const run = (cmd) => execSync(cmd, {
+                cwd: meta.repo_path,
+                encoding: 'utf8',
+                stdio: ['ignore', 'pipe', 'ignore'],
+                timeout: 500,
+            });
+            const lines = [];
+            // Uncommitted: `git status --porcelain` is one line per changed file.
+            try {
+                const status = run('git status --porcelain').trim();
+                if (status) {
+                    const files = status.split('\n').slice(0, 8);
+                    const more = status.split('\n').length > 8 ? ` (+ ${status.split('\n').length - 8} more)` : '';
+                    lines.push(`  Uncommitted changes:${more}`);
+                    files.forEach(f => lines.push(`    ${f}`));
+                } else {
+                    lines.push('  Working tree clean.');
+                }
+            } catch (_) { /* git status failed */ }
+            // Last 3 commits — short hash + subject only.
+            try {
+                const log = run('git log -3 --pretty=format:%h\\ %s').trim();
+                if (log) {
+                    lines.push('  Recent commits:');
+                    log.split('\n').forEach(c => lines.push(`    ${c}`));
+                }
+            } catch (_) { /* git log failed */ }
+            return lines.join('\n');
+        } catch (err) {
+            this.logDebug(`getGitWorkspaceState failed: ${err && err.message}`);
+            return '';
+        }
+    }
+
     /**
      * Condense an MCP tool call into a single-line summary. Used for the
      * activity timeline so the synthesized handoff includes "what was I

package/package.json

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