agent-enderun 1.10.2 → 1.11.0

package/dist/framework-mcp/src/tools/search/get_map.js.map

@@ -1 +1 @@
-{"version":3,"file":"get_map.js","sourceRoot":"","sources":["../../../../../framework-mcp/src/tools/search/get_map.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAGxB;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,WAAmB,EAAE,IAAc;IACnE,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC5C,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,KAAK,KAAK,CAAC;IAEjD,MAAM,SAAS,GAAG,CAAC,GAAW,EAAE,KAAa,EAAY,EAAE;QACvD,IAAI,KAAK,GAAG,QAAQ;YAAE,OAAO,EAAE,CAAC;QAEhC,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAElC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;YACjB,IAAI,IAAI,KAAK,cAAc,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;gBAAE,OAAO;YAElG,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YACtC,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACnC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAElC,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;gBACrB,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC;gBACrC,OAAO,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,QAAQ,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;YACpD,CAAC;iBAAM,IAAI,YAAY,EAAE,CAAC;gBACtB,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,MAAM,IAAI,EAAE,CAAC,CAAC;YACxC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,OAAO,OAAO,CAAC;IACnB,CAAC,CAAC;IAEF,IAAI,CAAC;QACD,MAAM,IAAI,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QACvC,OAAO;YACH,OAAO,EAAE,CAAC;oBACN,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,6BAA6B,QAAQ,UAAU,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;iBACzE,CAAC;SACL,CAAC;IACN,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACT,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,0BAA0B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;IACvG,CAAC;AACL,CAAC"}
+{"version":3,"file":"get_map.js","sourceRoot":"","sources":["../../../../../framework-mcp/src/tools/search/get_map.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAGxB;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,WAAmB,EAAE,IAAuB;IAC5E,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC;IACpC,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,KAAK,KAAK,CAAC;IAEjD,MAAM,SAAS,GAAG,CAAC,GAAW,EAAE,KAAa,EAAY,EAAE;QACvD,IAAI,KAAK,GAAG,QAAQ;YAAE,OAAO,EAAE,CAAC;QAEhC,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAElC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;YACjB,IAAI,IAAI,KAAK,cAAc,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;gBAAE,OAAO;YAElG,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YACtC,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACnC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAElC,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;gBACrB,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC;gBACrC,OAAO,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,QAAQ,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;YACpD,CAAC;iBAAM,IAAI,YAAY,EAAE,CAAC;gBACtB,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,MAAM,IAAI,EAAE,CAAC,CAAC;YACxC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,OAAO,OAAO,CAAC;IACnB,CAAC,CAAC;IAEF,IAAI,CAAC;QACD,MAAM,IAAI,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QACvC,OAAO;YACH,OAAO,EAAE,CAAC;oBACN,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,6BAA6B,QAAQ,UAAU,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;iBACzE,CAAC;SACL,CAAC;IACN,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACT,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,0BAA0B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;IACvG,CAAC;AACL,CAAC"}

package/dist/framework-mcp/src/tools/search/grep_search.d.ts

@@ -1,5 +1,5 @@
-import { ToolArgs, ToolResult } from "../types.js";
+import { GrepSearchArgs, ToolResult } from "../types.js";
 /**
  * Searches for a regex pattern within files in the project.
  */
-export declare function handleGrepSearch(projectRoot: string, args: ToolArgs): ToolResult;
+export declare function handleGrepSearch(projectRoot: string, args: GrepSearchArgs): ToolResult;

package/dist/framework-mcp/src/tools/search/grep_search.js

@@ -1,5 +1,6 @@
 import fs from "fs";
 import path from "path";
+import { Metrics } from "../../utils/metrics.js";
 /**
  * Searches for a regex pattern within files in the project.
  */
@@ -8,46 +9,62 @@ export function handleGrepSearch(projectRoot, args) {
     const includePattern = args.includePattern || ""; // e.g., ".ts"
     const excludePattern = args.excludePattern || "node_modules";
     if (!pattern) {
-        throw new Error("Search pattern is required.");
+        const err = "Search pattern is required.";
+        Metrics.logError(projectRoot, "@mcp", "grep_search", err);
+        return { isError: true, content: [{ type: "text", text: `❌ ${err}` }] };
     }
     const results = [];
-    const regex = new RegExp(pattern, "g");
+    let regex;
+    try {
+        regex = new RegExp(pattern, "g");
+    }
+    catch (e) {
+        const err = `Invalid regex pattern: ${String(e)}`;
+        Metrics.logError(projectRoot, "@mcp", "grep_search", err);
+        return { isError: true, content: [{ type: "text", text: `❌ ${err}` }] };
+    }
     const walk = (dir) => {
-        const files = fs.readdirSync(dir);
-        for (const file of files) {
-            const fullPath = path.join(dir, file);
-            const relativePath = path.relative(projectRoot, fullPath);
-            // Skip excluded directories/files
-            if (relativePath.includes(excludePattern))
-                continue;
-            try {
-                const stat = fs.statSync(fullPath);
+        if (results.length > 100)
+            return;
+        try {
+            const files = fs.readdirSync(dir);
+            for (const file of files) {
+                if (results.length > 100)
+                    return;
+                const filePath = path.join(dir, file);
+                if (excludePattern && filePath.includes(excludePattern)) {
+                    continue;
+                }
+                const stat = fs.statSync(filePath);
                 if (stat.isDirectory()) {
-                    walk(fullPath);
+                    walk(filePath);
                 }
                 else if (stat.isFile()) {
-                    // Check include pattern
-                    if (includePattern && !file.endsWith(includePattern))
+                    if (includePattern && !filePath.endsWith(includePattern)) {
                         continue;
-                    const content = fs.readFileSync(fullPath, "utf8");
-                    const lines = content.split("\n");
-                    lines.forEach((line, index) => {
-                        if (regex.test(line)) {
-                            results.push(`${relativePath}:${index + 1}: ${line.trim()}`);
-                            // Reset regex lastIndex because of 'g' flag
-                            regex.lastIndex = 0;
+                    }
+                    const content = fs.readFileSync(filePath, "utf8");
+                    // Create a new regex object for each line to avoid state issues with /g
+                    if (new RegExp(pattern).test(content)) {
+                        if (results.length < 100) {
+                            results.push(filePath);
                         }
-                    });
+                    }
                 }
             }
-            catch {
-                // Ignore read errors
-            }
-            if (results.length > 100)
-                break; // Limit results
+        }
+        catch (e) {
+            // Ignore directories that cannot be read
         }
     };
-    walk(projectRoot);
+    try {
+        walk(projectRoot);
+    }
+    catch (e) {
+        const err = `Search failed: ${String(e)}`;
+        Metrics.logError(projectRoot, "@mcp", "grep_search", err);
+        return { isError: true, content: [{ type: "text", text: `❌ ${err}` }] };
+    }
     return {
         content: [{
                 type: "text",

package/dist/framework-mcp/src/tools/search/grep_search.js.map

@@ -1 +1 @@
-{"version":3,"file":"grep_search.js","sourceRoot":"","sources":["../../../../../framework-mcp/src/tools/search/grep_search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAGxB;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,WAAmB,EAAE,IAAc;IAChE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAiB,CAAC;IACvC,MAAM,cAAc,GAAG,IAAI,CAAC,cAAwB,IAAI,EAAE,CAAC,CAAC,cAAc;IAC1E,MAAM,cAAc,GAAG,IAAI,CAAC,cAAwB,IAAI,cAAc,CAAC;IAEvE,IAAI,CAAC,OAAO,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAEvC,MAAM,IAAI,GAAG,CAAC,GAAW,EAAE,EAAE;QACzB,MAAM,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAClC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACvB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YACtC,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;YAE1D,kCAAkC;YAClC,IAAI,YAAY,CAAC,QAAQ,CAAC,cAAc,CAAC;gBAAE,SAAS;YAEpD,IAAI,CAAC;gBACD,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;gBACnC,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;oBACrB,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACnB,CAAC;qBAAM,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;oBACvB,wBAAwB;oBACxB,IAAI,cAAc,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC;wBAAE,SAAS;oBAE/D,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;oBAClD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;oBAClC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;wBAC1B,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;4BACnB,OAAO,CAAC,IAAI,CAAC,GAAG,YAAY,IAAI,KAAK,GAAG,CAAC,KAAK,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;4BAC7D,4CAA4C;4BAC5C,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC;wBACxB,CAAC;oBACL,CAAC,CAAC,CAAC;gBACP,CAAC;YACL,CAAC;YAAC,MAAM,CAAC;gBACL,qBAAqB;YACzB,CAAC;YAED,IAAI,OAAO,CAAC,MAAM,GAAG,GAAG;gBAAE,MAAM,CAAC,gBAAgB;QACrD,CAAC;IACL,CAAC,CAAC;IAEF,IAAI,CAAC,WAAW,CAAC,CAAC;IAElB,OAAO;QACH,OAAO,EAAE,CAAC;gBACN,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC;oBACpB,CAAC,CAAC,SAAS,OAAO,CAAC,MAAM,gBAAgB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;oBAC7D,CAAC,CAAC,mBAAmB;aAC5B,CAAC;KACL,CAAC;AACN,CAAC"}
+{"version":3,"file":"grep_search.js","sourceRoot":"","sources":["../../../../../framework-mcp/src/tools/search/grep_search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEjD;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,WAAmB,EAAE,IAAoB;IACtE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAiB,CAAC;IACvC,MAAM,cAAc,GAAG,IAAI,CAAC,cAAwB,IAAI,EAAE,CAAC,CAAC,cAAc;IAC1E,MAAM,cAAc,GAAG,IAAI,CAAC,cAAwB,IAAI,cAAc,CAAC;IAEvE,IAAI,CAAC,OAAO,EAAE,CAAC;QACX,MAAM,GAAG,GAAG,6BAA6B,CAAC;QAC1C,OAAO,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,CAAC,CAAC;QAC1D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC;IAC5E,CAAC;IAED,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,KAAa,CAAC;IAClB,IAAI,CAAC;QACD,KAAK,GAAG,IAAI,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACrC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACT,MAAM,GAAG,GAAG,0BAA0B,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QAClD,OAAO,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,CAAC,CAAC;QAC1D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC;IAC5E,CAAC;IAED,MAAM,IAAI,GAAG,CAAC,GAAW,EAAE,EAAE;QACzB,IAAI,OAAO,CAAC,MAAM,GAAG,GAAG;YAAE,OAAO;QACjC,IAAI,CAAC;YACD,MAAM,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;YAClC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACvB,IAAI,OAAO,CAAC,MAAM,GAAG,GAAG;oBAAE,OAAO;gBACjC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;gBACtC,IAAI,cAAc,IAAI,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;oBACtD,SAAS;gBACb,CAAC;gBACD,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;gBACnC,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;oBACrB,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACnB,CAAC;qBAAM,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;oBACvB,IAAI,cAAc,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;wBACvD,SAAS;oBACb,CAAC;oBACD,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;oBAClD,wEAAwE;oBACxE,IAAI,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;wBACpC,IAAI,OAAO,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;4BACvB,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;wBAC3B,CAAC;oBACL,CAAC;gBACL,CAAC;YACL,CAAC;QACL,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACT,yCAAyC;QAC7C,CAAC;IACL,CAAC,CAAC;IACF,IAAI,CAAC;QACD,IAAI,CAAC,WAAW,CAAC,CAAC;IACtB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACT,MAAM,GAAG,GAAG,kBAAkB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1C,OAAO,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,CAAC,CAAC;QAC1D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC;IAC5E,CAAC;IAED,OAAO;QACH,OAAO,EAAE,CAAC;gBACN,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC;oBACpB,CAAC,CAAC,SAAS,OAAO,CAAC,MAAM,gBAAgB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;oBAC7D,CAAC,CAAC,mBAAmB;aAC5B,CAAC;KACL,CAAC;AACN,CAAC"}

package/dist/framework-mcp/src/tools/search/list_dir.d.ts

@@ -1,5 +1,5 @@
-import { ToolArgs, ToolResult } from "../types.js";
+import { ListDirArgs, ToolResult } from "../types.js";
 /**
  * Lists the contents of a directory.
  */
-export declare function handleListDir(projectRoot: string, args: ToolArgs): ToolResult;
+export declare function handleListDir(projectRoot: string, args: ListDirArgs): ToolResult;

package/dist/framework-mcp/src/tools/search/list_dir.js.map

@@ -1 +1 @@
-{"version":3,"file":"list_dir.js","sourceRoot":"","sources":["../../../../../framework-mcp/src/tools/search/list_dir.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAGnD;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,WAAmB,EAAE,IAAc;IAC7D,MAAM,OAAO,GAAG,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC,IAAc,IAAI,GAAG,CAAC,CAAC;IAElE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACnC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,4BAA4B,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,MAAM,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IACtC,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;QAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC1C,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;QAClD,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,GAAG,IAAI,EAAE,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,OAAO;QACH,OAAO,EAAE,CAAC;gBACN,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,yBAAyB,IAAI,CAAC,IAAI,IAAI,GAAG,QAAQ,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;aAC9E,CAAC;KACL,CAAC;AACN,CAAC"}
+{"version":3,"file":"list_dir.js","sourceRoot":"","sources":["../../../../../framework-mcp/src/tools/search/list_dir.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAGnD;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,WAAmB,EAAE,IAAiB;IAChE,MAAM,OAAO,GAAG,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC;IAExD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACnC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,4BAA4B,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,MAAM,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IACtC,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;QAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC1C,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;QAClD,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,GAAG,IAAI,EAAE,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,OAAO;QACH,OAAO,EAAE,CAAC;gBACN,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,yBAAyB,IAAI,CAAC,IAAI,IAAI,GAAG,QAAQ,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;aAC9E,CAAC;KACL,CAAC;AACN,CAAC"}

package/dist/framework-mcp/src/tools/shell/run_command.d.ts

@@ -0,0 +1,2 @@
+import { RunCommandArgs, ToolResult } from "../types.js";
+export declare function handleRunCommand(projectRoot: string, args: RunCommandArgs): Promise<ToolResult>;

package/dist/framework-mcp/src/tools/shell/run_command.js

@@ -0,0 +1,47 @@
+import { exec } from "child_process";
+import { Metrics } from "../../utils/metrics.js";
+const COMMAND_ALLOW_LIST = [
+    "npm test",
+    "npm run lint",
+    "git status",
+    "git diff",
+    "npx vitest run", // From the audit, this is the test command
+    "npm run build", // From the audit
+];
+const TIMEOUT = 30000; // 30 seconds
+export function handleRunCommand(projectRoot, args) {
+    const command = args.command;
+    const isAllowed = COMMAND_ALLOW_LIST.some(allowedCmd => command.startsWith(allowedCmd));
+    if (!isAllowed) {
+        const errorMsg = `Command not allowed: "${command}". Only commands starting with the following are allowed: ${COMMAND_ALLOW_LIST.join(", ")}`;
+        Metrics.logError(projectRoot, "@mcp", `run_shell_command: ${command} (denied)`, errorMsg);
+        return Promise.resolve({
+            content: [{ type: "text", text: `ERROR: ${errorMsg}` }],
+            isError: true,
+        });
+    }
+    return new Promise((resolve) => {
+        exec(command, { cwd: projectRoot, timeout: TIMEOUT }, (error, stdout, stderr) => {
+            const output = stdout + stderr;
+            const tokens = Metrics.estimateTokens(output);
+            Metrics.logUsage(projectRoot, "@mcp", `run_shell_command: ${command}`, tokens);
+            if (error) {
+                const errorMsg = `Command failed with exit code ${error.code}: ${error.message}.`;
+                Metrics.logError(projectRoot, "@mcp", `run_shell_command: ${command}`, errorMsg);
+                resolve({
+                    content: [{ type: "text", text: `ERROR: ${errorMsg}. Output: ${output}` }],
+                    isError: true,
+                });
+                return;
+            }
+            // Truncate long outputs
+            const MAX_OUTPUT_LENGTH = 5000;
+            let truncatedOutput = output;
+            if (output.length > MAX_OUTPUT_LENGTH) {
+                truncatedOutput = output.substring(0, MAX_OUTPUT_LENGTH) + "... [TRUNCATED] ..."; // Simplified
+            }
+            resolve({ content: [{ type: "text", text: truncatedOutput }] });
+        });
+    });
+}
+//# sourceMappingURL=run_command.js.map

package/dist/framework-mcp/src/tools/shell/run_command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run_command.js","sourceRoot":"","sources":["../../../../../framework-mcp/src/tools/shell/run_command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAErC,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEjD,MAAM,kBAAkB,GAAG;IACvB,UAAU;IACV,cAAc;IACd,YAAY;IACZ,UAAU;IACV,gBAAgB,EAAE,2CAA2C;IAC7D,eAAe,EAAE,iBAAiB;CACrC,CAAC;AAEF,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,aAAa;AAEpC,MAAM,UAAU,gBAAgB,CAAC,WAAmB,EAAE,IAAoB;IACtE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;IAE7B,MAAM,SAAS,GAAG,kBAAkB,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC;IAExF,IAAI,CAAC,SAAS,EAAE,CAAC;QACb,MAAM,QAAQ,GAAG,yBAAyB,OAAO,6DAA6D,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9I,OAAO,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,sBAAsB,OAAO,WAAW,EAAE,QAAQ,CAAC,CAAC;QAC1F,OAAO,OAAO,CAAC,OAAO,CAAC;YACnB,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,QAAQ,EAAE,EAAE,CAAC;YACvD,OAAO,EAAE,IAAI;SAChB,CAAC,CAAC;IACP,CAAC;IAED,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC3B,IAAI,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;YAC5E,MAAM,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;YAC/B,MAAM,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;YAC9C,OAAO,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,sBAAsB,OAAO,EAAE,EAAE,MAAM,CAAC,CAAC;YAE/E,IAAI,KAAK,EAAE,CAAC;gBACR,MAAM,QAAQ,GAAG,iCAAiC,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,GAAG,CAAC;gBAClF,OAAO,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,sBAAsB,OAAO,EAAE,EAAE,QAAQ,CAAC,CAAC;gBACjF,OAAO,CAAC;oBACJ,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,QAAQ,aAAa,MAAM,EAAE,EAAE,CAAC;oBAC1E,OAAO,EAAE,IAAI;iBAChB,CAAC,CAAC;gBACH,OAAO;YACX,CAAC;YAED,wBAAwB;YACxB,MAAM,iBAAiB,GAAG,IAAI,CAAC;YAC/B,IAAI,eAAe,GAAG,MAAM,CAAC;YAC7B,IAAI,MAAM,CAAC,MAAM,GAAG,iBAAiB,EAAE,CAAC;gBACpC,eAAe,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,iBAAiB,CAAC,GAAG,qBAAqB,CAAC,CAAC,aAAa;YACnG,CAAC;YAED,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,EAAE,CAAC,CAAC;QACpE,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/framework-mcp/src/tools/types.d.ts

@@ -7,43 +7,109 @@ export interface ToolDefinition {
         required?: string[];
     };
 }
-export interface CallToolRequest {
-    params: {
-        name: string;
-        arguments?: ToolArgs;
-    };
-}
-export interface ToolArgs {
-    path?: string;
-    content?: string;
-    oldText?: string;
-    newText?: string;
+export interface ReadFileArgs {
+    path: string;
     startLine?: number;
     endLine?: number;
-    newContent?: string;
-    section?: string;
-    to?: string;
-    category?: "ACTION" | "DELEGATION" | "INFO" | "ALERT";
-    traceId?: string;
-    agent?: string;
-    action?: string;
-    status?: "SUCCESS" | "FAILURE";
-    summary?: string;
-    findings?: string;
+}
+export interface WriteFileArgs {
+    path: string;
+    content: string;
+}
+export interface ReplaceTextArgs {
+    path: string;
+    oldText: string;
+    newText: string;
     allowMultiple?: boolean;
-    timeout?: number;
-    from?: string;
-    priority?: "HIGH" | "NORMAL" | "LOW";
-    port?: number;
-    pattern?: string;
+}
+export interface PatchFileArgs {
+    path: string;
+    startLine: number;
+    endLine: number;
+    newContent: string;
+}
+export interface BatchSurgicalEditArgs {
+    edits: Array<{
+        path: string;
+        oldText: string;
+        newText: string;
+        allowMultiple?: boolean;
+    }>;
+}
+export interface ListDirArgs {
+    path?: string;
+}
+export interface GrepSearchArgs {
+    pattern: string;
     includePattern?: string;
     excludePattern?: string;
+}
+export interface GetProjectMapArgs {
     maxDepth?: number;
     includeFiles?: boolean;
-    edits?: unknown[];
-    command?: string;
+}
+export interface GetProjectGapsArgs {
+    path?: string;
+}
+export interface SendAgentMessageArgs {
+    from: string;
+    to: string;
+    category: "ACTION" | "DELEGATION" | "SUBTASK" | "REPLY" | "ALERT";
+    content: string;
+    traceId: string;
+    parentId?: string;
+    priority?: "HIGH" | "NORMAL" | "LOW";
+    requiresApproval?: boolean;
+}
+export interface LogAgentActionArgs {
+    agent: string;
+    action: string;
+    traceId: string;
+    status: "SUCCESS" | "FAILURE";
+    summary: string;
+    findings?: string;
+}
+export interface AcquireLockArgs {
+    resource: string;
+    agent: string;
+    ttl?: number;
+}
+export interface ReleaseLockArgs {
+    resource: string;
+    agent: string;
+}
+export interface RegisterAgentArgs {
+    agent: string;
+    role: string;
+    capability?: number;
+}
+export interface StartDashboardArgs {
+    port?: number;
+}
+export interface CheckActivePortsArgs {
     filter?: string;
 }
+export interface RunTestsArgs {
+    command?: string;
+    timeout?: number;
+}
+export interface UpdateProjectMemoryArgs {
+    section: string;
+    content: string;
+}
+export interface GetStatusArgs {
+    timeout?: number;
+}
+export interface OrchestrateArgs {
+    timeout?: number;
+}
+export interface UpdateContractHashArgs {
+    timeout?: number;
+}
+export interface RunCommandArgs {
+    command: string;
+}
+export type ToolArgs = ReadFileArgs | WriteFileArgs | ReplaceTextArgs | PatchFileArgs | BatchSurgicalEditArgs | ListDirArgs | GrepSearchArgs | GetProjectMapArgs | GetProjectGapsArgs | SendAgentMessageArgs | LogAgentActionArgs | AcquireLockArgs | ReleaseLockArgs | RegisterAgentArgs | StartDashboardArgs | CheckActivePortsArgs | RunTestsArgs | UpdateProjectMemoryArgs | GetStatusArgs | OrchestrateArgs | UpdateContractHashArgs;
 export interface ToolResult {
     isError?: boolean;
     content: Array<{
@@ -51,3 +117,4 @@ export interface ToolResult {
         text: string;
     }>;
 }
+export type ToolHandler = (projectRoot: string, args: unknown) => ToolResult | Promise<ToolResult>;

package/dist/framework-mcp/src/utils/metrics.d.ts

@@ -1,3 +1,14 @@
+/**
+ * Token and Metric Tracker for Agent Enderun.
+ * Estimates token usage and logs operational costs.
+ */
+interface MetricEntry {
+    timestamp: string;
+    agent: string;
+    action: string;
+    estimatedTokens: number;
+    error?: string;
+}
 export declare const Metrics: {
     /**
      * Estimates tokens based on character count (rough heuristic: 1 token ~= 4 chars).
@@ -7,4 +18,13 @@ export declare const Metrics: {
      * Logs the token usage and action to the observability metrics file.
      */
     logUsage: (projectRoot: string, agent: string, action: string, tokens: number) => void;
+    /**
+     * Logs an error occurrence to the observability metrics file.
+     */
+    logError: (projectRoot: string, agent: string, action: string, error: string) => void;
+    /**
+     * Internal helper to save metric entries.
+     */
+    saveMetric: (projectRoot: string, entry: MetricEntry) => void;
 };
+export {};

package/dist/framework-mcp/src/utils/metrics.js

@@ -12,6 +12,29 @@ export const Metrics = {
      * Logs the token usage and action to the observability metrics file.
      */
     logUsage: (projectRoot, agent, action, tokens) => {
+        Metrics.saveMetric(projectRoot, {
+            timestamp: new Date().toISOString(),
+            agent,
+            action,
+            estimatedTokens: tokens
+        });
+    },
+    /**
+     * Logs an error occurrence to the observability metrics file.
+     */
+    logError: (projectRoot, agent, action, error) => {
+        Metrics.saveMetric(projectRoot, {
+            timestamp: new Date().toISOString(),
+            agent,
+            action: `ERROR: ${action}`,
+            estimatedTokens: 0,
+            error
+        });
+    },
+    /**
+     * Internal helper to save metric entries.
+     */
+    saveMetric: (projectRoot, entry) => {
         const frameworkDir = resolveFrameworkDir(projectRoot);
         const metricsPath = path.join(projectRoot, frameworkDir, "observability/metrics.json");
         try {
@@ -22,12 +45,7 @@ export const Metrics = {
             if (fs.existsSync(metricsPath)) {
                 currentMetrics = JSON.parse(fs.readFileSync(metricsPath, "utf8"));
             }
-            currentMetrics.push({
-                timestamp: new Date().toISOString(),
-                agent,
-                action,
-                estimatedTokens: tokens
-            });
+            currentMetrics.push(entry);
             // Keep only last 100 entries to save space
             if (currentMetrics.length > 100)
                 currentMetrics.shift();

package/dist/framework-mcp/src/utils/metrics.js.map

@@ -1 +1 @@
-{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../../../framework-mcp/src/utils/metrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAapD,MAAM,CAAC,MAAM,OAAO,GAAG;IACnB;;OAEG;IACH,cAAc,EAAE,CAAC,IAAY,EAAU,EAAE;QACrC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,QAAQ,EAAE,CAAC,WAAmB,EAAE,KAAa,EAAE,MAAc,EAAE,MAAc,EAAE,EAAE;QAC7E,MAAM,YAAY,GAAG,mBAAmB,CAAC,WAAW,CAAC,CAAC;QACtD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,4BAA4B,CAAC,CAAC;QACvF,IAAI,CAAC;YACD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;YAC7C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC;gBAAE,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAE9E,IAAI,cAAc,GAAkB,EAAE,CAAC;YACvC,IAAI,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC7B,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;YACtE,CAAC;YAED,cAAc,CAAC,IAAI,CAAC;gBAChB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,KAAK;gBACL,MAAM;gBACN,eAAe,EAAE,MAAM;aAC1B,CAAC,CAAC;YAEH,2CAA2C;YAC3C,IAAI,cAAc,CAAC,MAAM,GAAG,GAAG;gBAAE,cAAc,CAAC,KAAK,EAAE,CAAC;YAExD,EAAE,CAAC,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3E,CAAC;QAAC,MAAM,CAAC,CAAC,uDAAuD,CAAC,CAAC;IACvE,CAAC;CACJ,CAAC"}
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../../../framework-mcp/src/utils/metrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAcpD,MAAM,CAAC,MAAM,OAAO,GAAG;IACnB;;OAEG;IACH,cAAc,EAAE,CAAC,IAAY,EAAU,EAAE;QACrC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,QAAQ,EAAE,CAAC,WAAmB,EAAE,KAAa,EAAE,MAAc,EAAE,MAAc,EAAE,EAAE;QAC7E,OAAO,CAAC,UAAU,CAAC,WAAW,EAAE;YAC5B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,KAAK;YACL,MAAM;YACN,eAAe,EAAE,MAAM;SAC1B,CAAC,CAAC;IACP,CAAC;IAED;;OAEG;IACH,QAAQ,EAAE,CAAC,WAAmB,EAAE,KAAa,EAAE,MAAc,EAAE,KAAa,EAAE,EAAE;QAC5E,OAAO,CAAC,UAAU,CAAC,WAAW,EAAE;YAC5B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,KAAK;YACL,MAAM,EAAE,UAAU,MAAM,EAAE;YAC1B,eAAe,EAAE,CAAC;YAClB,KAAK;SACR,CAAC,CAAC;IACP,CAAC;IAED;;OAEG;IACH,UAAU,EAAE,CAAC,WAAmB,EAAE,KAAkB,EAAE,EAAE;QACpD,MAAM,YAAY,GAAG,mBAAmB,CAAC,WAAW,CAAC,CAAC;QACtD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,4BAA4B,CAAC,CAAC;QACvF,IAAI,CAAC;YACD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;YAC7C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC;gBAAE,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAE9E,IAAI,cAAc,GAAkB,EAAE,CAAC;YACvC,IAAI,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC7B,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;YACtE,CAAC;YAED,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAE3B,2CAA2C;YAC3C,IAAI,cAAc,CAAC,MAAM,GAAG,GAAG;gBAAE,cAAc,CAAC,KAAK,EAAE,CAAC;YAExD,EAAE,CAAC,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3E,CAAC;QAAC,MAAM,CAAC,CAAC,uDAAuD,CAAC,CAAC;IACvE,CAAC;CACJ,CAAC"}

package/dist/framework-mcp/src/utils/security.d.ts

@@ -5,8 +5,6 @@
 export declare function safePath(projectRoot: string, userPath: string): string;
 /**
  * Resolves the active framework directory.
- * Priority: package.json `enderun.frameworkDir` → `.enderun` → adapter dirs.
- * This ensures the canonical framework directory is always used,
- * even when adapter-specific dirs (e.g. `.gemini`) exist alongside it.
+ * Priority: ENDERUN_TEST_DIR (env) -> package.json `enderun.frameworkDir` -> `.enderun` -> other adapter dirs -> global HOME.
  */
 export declare function resolveFrameworkDir(projectRoot: string): string;

package/dist/framework-mcp/src/utils/security.js

@@ -1,5 +1,7 @@
 import path from "path";
 import fs from "fs";
+import { FRAMEWORK, MCP, UNIFIED_HUB_DIR } from "../constants.js"; // New import
+import os from "os"; // Need os.homedir()
 /**
  * Validates and resolves a user-provided path to prevent path traversal attacks.
  * Ensures the resolved path stays within the project root boundary.
@@ -14,11 +16,13 @@ export function safePath(projectRoot, userPath) {
 }
 /**
  * Resolves the active framework directory.
- * Priority: package.json `enderun.frameworkDir` → `.enderun` → adapter dirs.
- * This ensures the canonical framework directory is always used,
- * even when adapter-specific dirs (e.g. `.gemini`) exist alongside it.
+ * Priority: ENDERUN_TEST_DIR (env) -> package.json `enderun.frameworkDir` -> `.enderun` -> other adapter dirs -> global HOME.
  */
 export function resolveFrameworkDir(projectRoot) {
+    // For test environments, use the explicitly set test directory.
+    const testDir = process.env[MCP.TEST_DIR_ENV];
+    if (testDir)
+        return testDir;
     // 1. Authoritative source: read from package.json if present
     try {
         const pkgPath = path.join(projectRoot, "package.json");
@@ -26,6 +30,11 @@ export function resolveFrameworkDir(projectRoot) {
             const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
             const enderunConfig = pkg["enderun"];
             if (enderunConfig && typeof enderunConfig["frameworkDir"] === "string") {
+                // Ensure the path is relative if it's within the project, otherwise use as-is.
+                const resolvedDir = path.resolve(projectRoot, enderunConfig["frameworkDir"]);
+                if (resolvedDir.startsWith(path.resolve(projectRoot))) {
+                    return path.relative(projectRoot, resolvedDir);
+                }
                 return enderunConfig["frameworkDir"];
             }
         }
@@ -33,26 +42,20 @@ export function resolveFrameworkDir(projectRoot) {
     catch {
         // ignore — fall through to filesystem scan
     }
-    // 2. Filesystem scan
-    const candidates = [
-        ".enderun",
-        ".cursor",
-        ".claude",
-        ".github",
-        ".grok",
-        ".windsurf",
-        ".antigravity",
-        ".agent",
-        ".gemini/antigravity-cli",
-        ".gemini",
-        ".agents",
+    // 2. Filesystem scan in projectRoot for common framework directories
+    const localCandidates = [
+        FRAMEWORK.CORE_DIR, // .enderun
+        UNIFIED_HUB_DIR, // .agents
+        // Add other adapter specific directories if needed, or remove if unified is strictly enforced
     ];
-    for (const candidate of candidates) {
+    for (const candidate of localCandidates) {
         const candidatePath = path.join(projectRoot, candidate);
         if (fs.existsSync(candidatePath)) {
             return candidate;
         }
     }
-    return ".gemini";
+    // 3. Fallback to global home directory.
+    const homeDir = os.homedir();
+    return path.join(homeDir, FRAMEWORK.CORE_DIR);
 }
 //# sourceMappingURL=security.js.map

package/dist/framework-mcp/src/utils/security.js.map

@@ -1 +1 @@
-{"version":3,"file":"security.js","sourceRoot":"","sources":["../../../../framework-mcp/src/utils/security.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,IAAI,CAAC;AAEpB;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,WAAmB,EAAE,QAAgB;IAC1D,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IACrD,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAEjD,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,QAAQ,KAAK,cAAc,EAAE,CAAC;QACjF,MAAM,IAAI,KAAK,CAAC,wBAAwB,QAAQ,yBAAyB,CAAC,CAAC;IAC/E,CAAC;IAED,OAAO,QAAQ,CAAC;AACpB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,WAAmB;IACnD,6DAA6D;IAC7D,IAAI,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;QACvD,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACzB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAA4B,CAAC;YACpF,MAAM,aAAa,GAAG,GAAG,CAAC,SAAS,CAAwC,CAAC;YAC5E,IAAI,aAAa,IAAI,OAAO,aAAa,CAAC,cAAc,CAAC,KAAK,QAAQ,EAAE,CAAC;gBACrE,OAAO,aAAa,CAAC,cAAc,CAAC,CAAC;YACzC,CAAC;QACL,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACL,2CAA2C;IAC/C,CAAC;IAED,qBAAqB;IACrB,MAAM,UAAU,GAAG;QACf,UAAU;QACV,SAAS;QACT,SAAS;QACT,SAAS;QACT,OAAO;QACP,WAAW;QACX,cAAc;QACd,QAAQ;QACR,yBAAyB;QACzB,SAAS;QACT,SAAS;KACZ,CAAC;IAEF,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACjC,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;QACxD,IAAI,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;YAC/B,OAAO,SAAS,CAAC;QACrB,CAAC;IACL,CAAC;IAED,OAAO,SAAS,CAAC;AACrB,CAAC"}
+{"version":3,"file":"security.js","sourceRoot":"","sources":["../../../../framework-mcp/src/utils/security.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC,CAAC,aAAa;AAChF,OAAO,EAAE,MAAM,IAAI,CAAC,CAAC,oBAAoB;AAEzC;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,WAAmB,EAAE,QAAgB;IAC1D,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IACrD,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAEjD,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,QAAQ,KAAK,cAAc,EAAE,CAAC;QACjF,MAAM,IAAI,KAAK,CAAC,wBAAwB,QAAQ,yBAAyB,CAAC,CAAC;IAC/E,CAAC;IAED,OAAO,QAAQ,CAAC;AACpB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,WAAmB;IACnD,gEAAgE;IAChE,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAC9C,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC;IAE5B,6DAA6D;IAC7D,IAAI,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;QACvD,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACzB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAA4B,CAAC;YACpF,MAAM,aAAa,GAAG,GAAG,CAAC,SAAS,CAAwC,CAAC;YAC5E,IAAI,aAAa,IAAI,OAAO,aAAa,CAAC,cAAc,CAAC,KAAK,QAAQ,EAAE,CAAC;gBACrE,+EAA+E;gBAC/E,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,aAAa,CAAC,cAAc,CAAC,CAAC,CAAC;gBAC7E,IAAI,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC;oBACpD,OAAO,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;gBACnD,CAAC;gBACD,OAAO,aAAa,CAAC,cAAc,CAAC,CAAC;YACzC,CAAC;QACL,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACL,2CAA2C;IAC/C,CAAC;IAED,qEAAqE;IACrE,MAAM,eAAe,GAAG;QACpB,SAAS,CAAC,QAAQ,EAAE,WAAW;QAC/B,eAAe,EAAK,UAAU;QAC9B,8FAA8F;KACjG,CAAC;IAEF,KAAK,MAAM,SAAS,IAAI,eAAe,EAAE,CAAC;QACtC,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;QACxD,IAAI,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;YAC/B,OAAO,SAAS,CAAC;QACrB,CAAC;IACL,CAAC;IAED,wCAAwC;IACxC,MAAM,OAAO,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;IAC7B,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC;AAClD,CAAC"}

package/dist/framework-mcp/tests/tools/file_system/file_system_tools.test.js

@@ -5,12 +5,17 @@ import { handleReplaceText } from "../../../src/tools/file_system/replace_text.j
 import { handlePatchFile } from "../../../src/tools/file_system/patch_file.js";
 import { handleReadFile } from "../../../src/tools/file_system/read_file.js";
 import { handleWriteFile } from "../../../src/tools/file_system/write_file.js";
-const TEST_DIR = path.join(__dirname, "../_temp_test_files");
-const TEST_FILE = path.join(TEST_DIR, "test_file.txt");
-const MEMORY_DIR = path.join(TEST_DIR, ".gemini/memory");
-const MEMORY_FILE = path.join(MEMORY_DIR, "PROJECT_MEMORY.md");
+import os from "os"; // Need to import os
+let TEST_DIR; // Declare as let
+let TEST_FILE;
+let MEMORY_DIR;
+let MEMORY_FILE;
 beforeEach(() => {
-    fs.mkdirSync(TEST_DIR, { recursive: true });
+    TEST_DIR = fs.mkdtempSync(path.join(os.tmpdir(), "fs-tools-test-")); // Unique temp dir
+    fs.mkdirSync(path.join(TEST_DIR, ".enderun"));
+    TEST_FILE = path.join(TEST_DIR, "test_file.txt");
+    MEMORY_DIR = path.join(TEST_DIR, ".enderun/memory");
+    MEMORY_FILE = path.join(MEMORY_DIR, "PROJECT_MEMORY.md");
 });
 afterEach(() => {
     fs.rmSync(TEST_DIR, { recursive: true, force: true });
@@ -25,8 +30,8 @@ describe("File System Tools", () => {
                 newText: "there",
             };
             const result = handleReplaceText(TEST_DIR, args);
-            expect(result.content[0].text).toContain("✅ Surgical edit successful");
-            expect(fs.readFileSync(TEST_FILE, "utf8")).toBe("hello there");
+            expect(result.content[0].text).toContain("✅ Surgical edit successful in");
+            expect(fs.readFileSync(TEST_FILE, "utf8")).toBe("hello there\n");
         });
         it("should throw an error if text is not found", () => {
             fs.writeFileSync(TEST_FILE, "hello world", "utf8");
@@ -56,8 +61,8 @@ describe("File System Tools", () => {
                 allowMultiple: true,
             };
             const result = handleReplaceText(TEST_DIR, args);
-            expect(result.content[0].text).toContain("✅ Surgical edit successful");
-            expect(fs.readFileSync(TEST_FILE, "utf8")).toBe("hello there there");
+            expect(result.content[0].text).toContain("✅ Surgical edit successful in");
+            expect(fs.readFileSync(TEST_FILE, "utf8")).toBe("hello there there\n");
         });
         it("should log usage to metrics.json upon replace", () => {
             fs.writeFileSync(TEST_FILE, "hello world", "utf8");
@@ -67,7 +72,7 @@ describe("File System Tools", () => {
                 newText: "there",
             };
             handleReplaceText(TEST_DIR, args);
-            const metricsPath = path.join(TEST_DIR, ".gemini/observability/metrics.json");
+            const metricsPath = path.join(TEST_DIR, ".enderun/observability/metrics.json");
             expect(fs.existsSync(metricsPath)).toBe(true);
             const metrics = JSON.parse(fs.readFileSync(metricsPath, "utf8"));
             expect(metrics[0].action).toContain("replace_text");
@@ -115,7 +120,7 @@ describe("File System Tools", () => {
                 newContent: "patched2\npatched3",
             };
             handlePatchFile(TEST_DIR, args);
-            const metricsPath = path.join(TEST_DIR, ".gemini/observability/metrics.json");
+            const metricsPath = path.join(TEST_DIR, ".enderun/observability/metrics.json");
             expect(fs.existsSync(metricsPath)).toBe(true);
             const metrics = JSON.parse(fs.readFileSync(metricsPath, "utf8"));
             expect(metrics[0].action).toContain("patch_file");
@@ -155,8 +160,8 @@ describe("File System Tools", () => {
                 content: "hello world"
             };
             const result = handleWriteFile(TEST_DIR, args);
-            expect(result.content[0].text).toContain("✅ File written");
-            expect(fs.readFileSync(TEST_FILE, "utf8")).toBe("hello world");
+            expect(result.content[0].text).toContain("✅ File written:");
+            expect(fs.readFileSync(TEST_FILE, "utf8")).toBe("hello world\n");
         });
         it("should write new file and log usage to metrics.json", () => {
             const args = {
@@ -164,7 +169,7 @@ describe("File System Tools", () => {
                 content: "hello world"
             };
             handleWriteFile(TEST_DIR, args);
-            const metricsPath = path.join(TEST_DIR, ".gemini/observability/metrics.json");
+            const metricsPath = path.join(TEST_DIR, ".enderun/observability/metrics.json");
             expect(fs.existsSync(metricsPath)).toBe(true);
             const metrics = JSON.parse(fs.readFileSync(metricsPath, "utf8"));
             expect(metrics[0].action).toContain("write_file");