cf-memory-mcp 3.8.7 → 3.8.9

package/bin/cf-memory-mcp.js

@@ -155,7 +155,7 @@ const TOOLS_LIST = [
                 file_filter: { type: 'array', items: { type: 'string' }, description: 'Limit to files matching path substrings' },
                 all_projects: { type: 'boolean', description: 'Search across ALL your indexed projects (overrides project_id). Useful for "find X in any of my repos".' },
                 expand_context: { type: 'boolean', description: 'Include file_imports (the file\'s module/imports chunk) with each result. Default: true.' },
-                exclude_docs: { type: 'boolean', description: 'Filter out markdown/docs from code queries. Default: true (auto-disabled if query mentions docs/readme/tutorial).' }
+                exclude_docs: { type: 'boolean', description: 'Filter out markdown/docs from code queries. Default: true (auto-disabled if query mentions docs/readme/tutorial). Response includes docs_filtered_count when chunks were dropped — flip to false to surface them.' }
             },
             required: ['query']
         }
@@ -903,8 +903,17 @@ class CFMemoryMCP {
 
         let filesList = [];
         try {
-            filesList = JSON.parse(listFilesRes.result.content[0].text);
-            if (!Array.isArray(filesList)) filesList = [];
+            const parsed = JSON.parse(listFilesRes.result.content[0].text);
+            if (Array.isArray(parsed)) {
+                filesList = parsed;
+            } else if (parsed && parsed.error) {
+                // Server returned {error, hint} — surface it instead of
+                // pretending there are zero indexed files.
+                return respond({
+                    error: parsed.error,
+                    hint: parsed.hint || `find_stale_files needs a valid project_id; got "${projectIdOrName}"`,
+                });
+            }
         } catch (_) {
             return respond({ error: 'Failed to list indexed files' });
         }
@@ -984,8 +993,15 @@ class CFMemoryMCP {
         });
         let filesList = [];
         try {
-            filesList = JSON.parse(listRes.result.content[0].text);
-            if (!Array.isArray(filesList)) filesList = [];
+            const parsed = JSON.parse(listRes.result.content[0].text);
+            if (Array.isArray(parsed)) {
+                filesList = parsed;
+            } else if (parsed && parsed.error) {
+                return respond({
+                    error: parsed.error,
+                    hint: parsed.hint || `refresh_stale needs a valid project_id; got "${projectIdOrName}"`,
+                });
+            }
         } catch (_) {
             return respond({ error: 'Failed to list indexed files' });
         }
@@ -1084,6 +1100,13 @@ class CFMemoryMCP {
             this.logDebug(`Found ${files.length} files to index.`);
 
             if (files.length === 0) {
+                // Verify the path actually exists so we can tell the user
+                // whether it's "path wrong" or "everything was filtered out".
+                let pathExists = false;
+                try { pathExists = fs.existsSync(resolvedPath); } catch (_) { pathExists = false; }
+                const hint = !pathExists
+                    ? `Path "${resolvedPath}" does not exist. Check the project_path argument.`
+                    : `Path exists but every file was filtered out. The bridge excludes node_modules, dist, build, .git, *.lock, *.min.js, *.d.ts, .augment, .kiro, .intent, .husky, .claude, and generated/ directories. Pass include_patterns to override, or check that the project actually has source files at this path.`;
                 const response = {
                     jsonrpc: '2.0',
                     id: message.id,
@@ -1097,7 +1120,8 @@ class CFMemoryMCP {
                                 files_indexed: 0,
                                 chunks_created: 0,
                                 status: 'complete',
-                                message: 'No matching files found in directory'
+                                message: 'No matching files found in directory',
+                                hint
                             }, null, 2)
                         }]
                     }

package/package.json

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