agent-enderun 1.1.9 → 1.10.0

package/framework-mcp/dist/tools/definitions.js

@@ -1,270 +0,0 @@
-export const TOOLS = [
-    {
-        name: "read_file",
-        description: "Read the content of a file within the project. Supports optional line range reading to prevent stream overload.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                path: { type: "string", description: "Path to the file relative to project root" },
-                startLine: { type: "number", description: "Optional starting line number (1-indexed)" },
-                endLine: { type: "number", description: "Optional ending line number (inclusive)" },
-            },
-            required: ["path"],
-        },
-    },
-    {
-        name: "list_dir",
-        description: "List the contents of a directory. Essential for codebase exploration.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                path: { type: "string", description: "Path to the directory relative to project root (default: '.')" },
-            },
-        },
-    },
-    {
-        name: "grep_search",
-        description: "Perform a recursive regex search across the codebase to find functions, variables, or patterns.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                pattern: { type: "string", description: "The regex pattern to search for" },
-                includePattern: { type: "string", description: "Optional: Filter files by extension (e.g., '.ts')" },
-                excludePattern: { type: "string", description: "Optional: Directory pattern to exclude (default: 'node_modules')" },
-            },
-            required: ["pattern"],
-        },
-    },
-    {
-        name: "write_file",
-        description: "Write content to a file. Creates directories if missing.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                path: { type: "string", description: "Path to the file relative to project root" },
-                content: { type: "string", description: "Complete content of the file" },
-            },
-            required: ["path", "content"],
-        },
-    },
-    {
-        name: "replace_text",
-        description: "Surgically replace a string in a file with another string.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                path: { type: "string", description: "Path to the file" },
-                oldText: { type: "string", description: "The exact text to find" },
-                newText: { type: "string", description: "The text to replace it with" },
-                allowMultiple: { type: "boolean", description: "Allow multiple replacements if oldText is not unique." }
-            },
-            required: ["path", "oldText", "newText"],
-        },
-    },
-    {
-        name: "batch_surgical_edit",
-        description: "Perform multiple surgical text replacements across multiple files in a single batch request. More efficient for cross-cutting changes.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                edits: {
-                    type: "array",
-                    items: {
-                        type: "object",
-                        properties: {
-                            path: { type: "string", description: "Path to the file" },
-                            oldText: { type: "string", description: "The exact text to find" },
-                            newText: { type: "string", description: "The text to replace it with" },
-                            allowMultiple: { type: "boolean", description: "Allow multiple replacements in this file." }
-                        },
-                        required: ["path", "oldText", "newText"]
-                    }
-                }
-            },
-            required: ["edits"],
-        },
-    },
-    {
-        name: "patch_file",
-        description: "Safely update a file by replacing a specific line range with new content.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                path: { type: "string", description: "Path to the file" },
-                startLine: { type: "number", description: "Starting line number (1-indexed)" },
-                endLine: { type: "number", description: "Ending line number (inclusive)" },
-                newContent: { type: "string", description: "The new lines to insert" },
-            },
-            required: ["path", "startLine", "endLine", "newContent"],
-        },
-    },
-    {
-        name: "get_project_map",
-        description: "Generate a tree-view map of the project structure to visualize the layout. Useful for onboarding and architectural analysis.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                maxDepth: { type: "number", description: "Maximum directory depth to scan (default: 3)" },
-                includeFiles: { type: "boolean", description: "Whether to include files in the map (default: true)" }
-            }
-        }
-    },
-    {
-        name: "get_project_gaps",
-        description: "Scans the codebase for TODOs, FIXMEs, and empty function bodies. Helps identify what is left and where the agent might have skipped logic.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                path: { type: "string", description: "Path to the source directory (default: 'src')" },
-            },
-        },
-    },
-    {
-        name: "audit_dependencies",
-        description: "Audits package.json for unused, redundant, or duplicate-like packages to ensure a clean dependency tree.",
-        inputSchema: { type: "object", properties: {} },
-    },
-    {
-        name: "run_tests",
-        description: "Execute project test suites (Vitest, Playwright, etc.) and capture detailed pass/fail reports for analysis.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                command: { type: "string", description: "The test command to run (default: 'npm test')" }
-            }
-        }
-    },
-    {
-        name: "get_system_health",
-        description: "Retrieve real-time system metrics like CPU load, RAM usage, and uptime.",
-        inputSchema: { type: "object", properties: {} }
-    },
-    {
-        name: "check_active_ports",
-        description: "Identify which network ports are currently active and listening. Helps verify if the dev server or API is running.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                filter: { type: "string", description: "Optional: Filter results by port number or service name (e.g., ':3000')" }
-            }
-        }
-    },
-    {
-        name: "start_dashboard",
-        description: "Start the Enderun Web Dashboard (Command Center) to visualize real-time agent status, logs, and system metrics in the browser.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                port: { type: "number", description: "Optional: Port to run the dashboard on (default: 5858)" }
-            }
-        }
-    },
-    {
-        name: "get_framework_status",
-        description: "Get the current project phase, active traces, and agent states.",
-        inputSchema: { type: "object", properties: {} },
-    },
-    {
-        name: "read_project_memory",
-        description: "Read the full project central memory (PROJECT_MEMORY.md). Use this at the start of a session to gain context.",
-        inputSchema: { type: "object", properties: {} },
-    },
-    {
-        name: "get_memory_insights",
-        description: "Retrieve a summarized version of the project memory (active phase, trace, and last 5 actions) to save tokens.",
-        inputSchema: { type: "object", properties: {} },
-    },
-    {
-        name: "update_project_memory",
-        description: "Update a specific section in PROJECT_MEMORY.md.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                section: { type: "string", description: "Section name (e.g., HISTORY, ACTIVE TASKS)" },
-                content: { type: "string", description: "Markdown content to append or set" },
-            },
-            required: ["section", "content"],
-        },
-    },
-    {
-        name: "orchestrate_loop",
-        description: "Process the pending Hermes messages and trigger dynamic state transitions.",
-        inputSchema: { type: "object", properties: {} },
-    },
-    {
-        name: "send_agent_message",
-        description: "Send a Hermes protocol message to another agent for collaboration or sub-tasking.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                from: { type: "string", description: "Sender agent (e.g., @manager, @backend)." },
-                to: { type: "string", description: "Target agent (e.g., @backend, @quality)." },
-                category: { type: "string", enum: ["ACTION", "DELEGATION", "SUBTASK", "REPLY", "ALERT"], description: "Message type." },
-                content: { type: "string", description: "Task description or message content." },
-                traceId: { type: "string", description: "Active Trace ID." },
-                parentId: { type: "string", description: "Optional parent task trace ID for hierarchical tracking." },
-                priority: { type: "string", enum: ["HIGH", "NORMAL", "LOW"], description: "Optional priority level (HIGH, NORMAL, LOW). Defaults to HIGH for ALERT/ACTION." },
-            },
-            required: ["from", "to", "category", "content", "traceId"],
-        },
-    },
-    {
-        name: "acquire_lock",
-        description: "Acquire a stateful lock on a shared resource (like PROJECT_MEMORY.md) to prevent concurrent write conflicts.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                resource: { type: "string", description: "The resource name or path to lock (e.g., 'memory')." },
-                agent: { type: "string", description: "The agent requesting the lock (e.g., '@backend')." },
-                ttl: { type: "number", description: "Time-to-live in seconds before the lock auto-expires (default: 60)." }
-            },
-            required: ["resource", "agent"]
-        }
-    },
-    {
-        name: "release_lock",
-        description: "Release a previously acquired lock on a resource.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                resource: { type: "string", description: "The resource name or path." },
-                agent: { type: "string", description: "The agent releasing the lock." }
-            },
-            required: ["resource", "agent"]
-        }
-    },
-    {
-        name: "register_agent",
-        description: "Register an agent instance with the Control Plane and validate its permissions.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                agent: { type: "string", description: "The agent name (e.g., '@backend')." },
-                role: { type: "string", description: "The role of the agent." },
-                capability: { type: "number", description: "The capability score (1-10)." }
-            },
-            required: ["agent", "role"]
-        }
-    },
-    {
-        name: "log_agent_action",
-        description: "Log an agent action to the framework logs.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                agent: { type: "string", description: "The agent name (e.g., @manager, @backend)" },
-                action: { type: "string", description: "Action type or name" },
-                traceId: { type: "string", description: "The active Trace ID" },
-                status: { type: "string", enum: ["SUCCESS", "FAILURE"], description: "The status of the action" },
-                summary: { type: "string", description: "Brief description of the action taken" },
-                findings: { type: "string", description: "Optional comma-separated findings or details" }
-            },
-            required: ["agent", "action", "traceId", "status", "summary"]
-        }
-    },
-    {
-        name: "update_contract_hash",
-        description: "Re-generate and synchronize the backend contract SHA-256 hash.",
-        inputSchema: { type: "object", properties: {} }
-    }
-];

package/framework-mcp/dist/tools/file_system/batch_surgical_edit.js

@@ -1,50 +0,0 @@
-import fs from "fs";
-import { safePath } from "../../utils/security.js";
-import { Metrics } from "../../utils/metrics.js";
-import { verifyCorporateCompliance } from "../../utils/compliance.js";
-/**
- * Performs multiple surgical text replacements across multiple files in a single batch.
- */
-export function handleBatchSurgicalEdit(projectRoot, args) {
-    const edits = args.edits;
-    if (!Array.isArray(edits) || edits.length === 0) {
-        throw new Error("No edits provided in the batch request.");
-    }
-    const results = [];
-    let totalTokens = 0;
-    for (const edit of edits) {
-        const filePath = safePath(projectRoot, edit.path);
-        if (!fs.existsSync(filePath)) {
-            throw new Error(`File not found: ${edit.path}`);
-        }
-        const content = fs.readFileSync(filePath, "utf8");
-        const { oldText, newText, allowMultiple = false } = edit;
-        if (!content.includes(oldText)) {
-            throw new Error(`Text not found in file ${edit.path}: "${oldText.slice(0, 50)}..."`);
-        }
-        // Surgical precision guard
-        if (!allowMultiple) {
-            const firstIndex = content.indexOf(oldText);
-            const lastIndex = content.lastIndexOf(oldText);
-            if (firstIndex !== lastIndex) {
-                throw new Error(`Ambiguous replacement in ${edit.path}: "${oldText.slice(0, 50)}..." found multiple times.`);
-            }
-        }
-        const newContent = allowMultiple
-            ? content.replace(new RegExp(oldText.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"), "g"), newText)
-            : content.replace(oldText, newText);
-        // ENFORCE CORPORATE COMPLIANCE
-        verifyCorporateCompliance(newContent, edit.path);
-        fs.writeFileSync(filePath, newContent);
-        const tokens = Metrics.estimateTokens(newText);
-        totalTokens += tokens;
-        results.push(`✅ Edited ${edit.path}`);
-    }
-    Metrics.logUsage(projectRoot, "@mcp", `batch_surgical_edit: ${edits.length} files`, totalTokens);
-    return {
-        content: [{
-                type: "text",
-                text: `Successfully performed ${edits.length} edits:\n${results.join("\n")}`
-            }]
-    };
-}

package/framework-mcp/dist/tools/file_system/patch_file.js

@@ -1,21 +0,0 @@
-import fs from "fs";
-import { safePath } from "../../utils/security.js";
-import { Metrics } from "../../utils/metrics.js";
-export function handlePatchFile(projectRoot, args) {
-    const filePath = safePath(projectRoot, args.path);
-    const lines = fs.readFileSync(filePath, "utf8").split("\n");
-    const start = args.startLine - 1;
-    const end = args.endLine;
-    const newContent = args.newContent.split("\n");
-    if (start < 0 || start > lines.length) {
-        throw new Error(`Invalid start line: ${start + 1}. File has ${lines.length} lines.`);
-    }
-    if (end < start + 1 || end > lines.length) {
-        throw new Error(`Invalid end line: ${end}. Must be between ${start + 1} and ${lines.length}.`);
-    }
-    lines.splice(start, end - start, ...newContent);
-    fs.writeFileSync(filePath, lines.join("\n"));
-    const tokens = Metrics.estimateTokens(args.newContent);
-    Metrics.logUsage(projectRoot, "@mcp", `patch_file: ${args.path}`, tokens);
-    return { content: [{ type: "text", text: `✅ File patched successfully: ${args.path}` }] };
-}

package/framework-mcp/dist/tools/file_system/read_file.js

@@ -1,34 +0,0 @@
-import fs from "fs";
-import { safePath } from "../../utils/security.js";
-import { Metrics } from "../../utils/metrics.js";
-export function handleReadFile(projectRoot, args) {
-    const filePath = safePath(projectRoot, args.path);
-    const startLine = args.startLine !== undefined ? Number(args.startLine) : undefined;
-    const endLine = args.endLine !== undefined ? Number(args.endLine) : undefined;
-    const content = fs.readFileSync(filePath, "utf8");
-    const lines = content.split(/\r?\n/);
-    if (startLine !== undefined || endLine !== undefined) {
-        const start = startLine !== undefined ? Math.max(1, startLine) - 1 : 0;
-        const end = endLine !== undefined ? Math.min(lines.length, endLine) : lines.length;
-        const sliced = lines.slice(start, end).join("\n");
-        const tokens = Metrics.estimateTokens(sliced);
-        Metrics.logUsage(projectRoot, "@mcp", `read_file: ${args.path}`, tokens);
-        return { content: [{ type: "text", text: sliced }] };
-    }
-    // Default protection limit: 1000 lines
-    const DEFAULT_MAX_LINES = 1000;
-    if (lines.length > DEFAULT_MAX_LINES) {
-        const sliced = lines.slice(0, DEFAULT_MAX_LINES).join("\n");
-        const tokens = Metrics.estimateTokens(sliced);
-        Metrics.logUsage(projectRoot, "@mcp", `read_file: ${args.path} (truncated)`, tokens);
-        return {
-            content: [{
-                    type: "text",
-                    text: `${sliced}\n\n... [TRUNCATED - File is too long (${lines.length} lines). Only the first ${DEFAULT_MAX_LINES} lines are shown. Use startLine and endLine parameters to read other parts of the file.]`
-                }]
-        };
-    }
-    const tokens = Metrics.estimateTokens(content);
-    Metrics.logUsage(projectRoot, "@mcp", `read_file: ${args.path}`, tokens);
-    return { content: [{ type: "text", text: content }] };
-}

package/framework-mcp/dist/tools/file_system/replace_text.js

@@ -1,38 +0,0 @@
-import fs from "fs";
-import { safePath } from "../../utils/security.js";
-import { Metrics } from "../../utils/metrics.js";
-import { verifyCorporateCompliance } from "../../utils/compliance.js";
-export function handleReplaceText(projectRoot, args) {
-    const filePath = safePath(projectRoot, args.path);
-    const content = fs.readFileSync(filePath, "utf8");
-    const oldText = args.oldText;
-    const newText = args.newText;
-    const allowMultiple = args.allowMultiple || false; // Default to false
-    if (!content.includes(oldText)) {
-        throw new Error(`Text not found in file: ${oldText.slice(0, 100)}...`);
-    }
-    // Surgical precision guard: reject ambiguous replacements unless allowMultiple is true.
-    if (!allowMultiple) {
-        const firstIndex = content.indexOf(oldText);
-        const lastIndex = content.lastIndexOf(oldText);
-        if (firstIndex !== lastIndex) {
-            const count = (content.match(new RegExp(oldText.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"), "g")) || []).length;
-            throw new Error(`Ambiguous replacement: "${oldText.slice(0, 80)}..." found ${count} times in ${args.path}. ` +
-                "Provide a longer, unique context string or set 'allow_multiple' to true.");
-        }
-    }
-    // Perform replacement(s)
-    let newContent;
-    if (allowMultiple) {
-        newContent = content.replace(new RegExp(oldText.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"), "g"), newText);
-    }
-    else {
-        newContent = content.replace(oldText, newText);
-    }
-    // ENFORCE CORPORATE COMPLIANCE
-    verifyCorporateCompliance(newContent, args.path);
-    fs.writeFileSync(filePath, newContent);
-    const tokens = Metrics.estimateTokens(newText);
-    Metrics.logUsage(projectRoot, "@mcp", `replace_text: ${args.path}`, tokens);
-    return { content: [{ type: "text", text: `✅ Surgical edit successful in ${args.path}` }] };
-}

package/framework-mcp/dist/tools/file_system/write_file.js

@@ -1,26 +0,0 @@
-import fs from "fs";
-import path from "path";
-import { safePath, resolveFrameworkDir } from "../../utils/security.js";
-import { Metrics } from "../../utils/metrics.js";
-import { verifyCorporateCompliance } from "../../utils/compliance.js";
-export function handleWriteFile(projectRoot, args) {
-    const filePath = safePath(projectRoot, args.path);
-    const content = args.content;
-    // ENFORCE CORPORATE COMPLIANCE
-    verifyCorporateCompliance(content, args.path);
-    fs.mkdirSync(path.dirname(filePath), { recursive: true });
-    fs.writeFileSync(filePath, content);
-    // AUTO-LOGGING & METRICS
-    const tokens = Metrics.estimateTokens(content);
-    Metrics.logUsage(projectRoot, "@mcp", `write_file: ${args.path}`, tokens);
-    try {
-        const frameworkDir = resolveFrameworkDir(projectRoot);
-        const memoryPath = path.join(projectRoot, frameworkDir, "memory/PROJECT_MEMORY.md");
-        if (fs.existsSync(memoryPath)) {
-            const entry = `\n### ${new Date().toISOString().split("T")[0]} — Auto-Update\n- **Action:** wrote file \`${args.path}\` (${tokens} tokens estimated).\n`;
-            fs.appendFileSync(memoryPath, entry);
-        }
-    }
-    catch { /* ignore memory logging errors */ }
-    return { content: [{ type: "text", text: `✅ File written: ${args.path}` }] };
-}

package/framework-mcp/dist/tools/framework/audit_deps.js

@@ -1,41 +0,0 @@
-import fs from "fs";
-import path from "path";
-/**
- * Audits package.json for unused or duplicate-like packages.
- * Focuses on project health and cleanup.
- */
-export function handleAuditDependencies(projectRoot, _args) {
-    const pkgPath = path.join(projectRoot, "package.json");
-    if (!fs.existsSync(pkgPath)) {
-        throw new Error("package.json not found.");
-    }
-    const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
-    const deps = { ...pkg.dependencies, ...pkg.devDependencies };
-    const depNames = Object.keys(deps);
-    const results = [];
-    // 1. Look for similar packages (potential duplicates)
-    const similarityGroups = {
-        "CSS/Styling": ["tailwind", "panda", "styled-components", "emotion", "sass"],
-        "Testing": ["vitest", "jest", "mocha", "jasmine"],
-        "Fetching": ["axios", "ky", "fetch"]
-    };
-    for (const [group, patterns] of Object.entries(similarityGroups)) {
-        const found = depNames.filter(d => patterns.some(p => d.includes(p)));
-        if (found.length > 1) {
-            results.push(`⚠️  Potential redundancy in [${group}]: Found ${found.join(", ")}`);
-        }
-    }
-    // 2. Scan for "any" usage in package names (bad practice markers)
-    const legacyDeps = depNames.filter(d => d.includes("legacy") || d.includes("compat"));
-    if (legacyDeps.length > 0) {
-        results.push(`ℹ️  Legacy compatibility packages detected: ${legacyDeps.join(", ")}`);
-    }
-    return {
-        content: [{
-                type: "text",
-                text: results.length > 0
-                    ? `Dependency Audit Results:\n\n${results.join("\n")}`
-                    : "✅ Dependencies look clean and consolidated."
-            }]
-    };
-}

package/framework-mcp/dist/tools/framework/get_status.js

@@ -1,5 +0,0 @@
-import { safeExec } from "../../utils/cli.js";
-export function handleGetFrameworkStatus(projectRoot, args) {
-    const output = safeExec("npx", ["agent-enderun", "status"], projectRoot, args.timeout);
-    return { content: [{ type: "text", text: output }] };
-}

package/framework-mcp/dist/tools/framework/orchestrate.js

@@ -1,5 +0,0 @@
-import { safeExec } from "../../utils/cli.js";
-export function handleOrchestrateLoop(projectRoot, args) {
-    const output = safeExec("npx", ["agent-enderun", "orchestrate"], projectRoot, args.timeout);
-    return { content: [{ type: "text", text: output }] };
-}

package/framework-mcp/dist/tools/framework/run_tests.js

@@ -1,25 +0,0 @@
-import { execSync } from "child_process";
-/**
- * Executes project tests and returns results for agent analysis.
- */
-export function handleRunTests(projectRoot, args) {
-    const testCommand = args.command || "npm test";
-    try {
-        const output = execSync(testCommand, { cwd: projectRoot, encoding: "utf8", stdio: "pipe" });
-        return {
-            content: [{ type: "text", text: `✅ Tests passed successfully!\n\n${output}` }]
-        };
-    }
-    catch (error) {
-        const err = error;
-        const stderr = err.stderr?.toString() || "";
-        const stdout = err.stdout?.toString() || "";
-        return {
-            isError: true,
-            content: [{
-                    type: "text",
-                    text: `❌ Tests FAILED!\n\n--- STDOUT ---\n${stdout}\n\n--- STDERR ---\n${stderr}`
-                }]
-        };
-    }
-}

package/framework-mcp/dist/tools/framework/update_contract_hash.js

@@ -1,5 +0,0 @@
-import { safeExec } from "../../utils/cli.js";
-export function handleUpdateContractHash(projectRoot, args) {
-    const output = safeExec("npx", ["agent-enderun", "update-contract"], projectRoot, args.timeout);
-    return { content: [{ type: "text", text: output }] };
-}

package/framework-mcp/dist/tools/framework/update_memory.js

@@ -1,8 +0,0 @@
-import { safeExec } from "../../utils/cli.js";
-export function handleUpdateProjectMemory(projectRoot, args) {
-    const section = args.section;
-    const content = args.content;
-    // Using execFileSync with array args prevents command injection
-    safeExec("npx", ["agent-enderun", "update_project_memory", section, content], projectRoot, args.timeout);
-    return { content: [{ type: "text", text: `✅ Section ${section} updated.` }] };
-}

package/framework-mcp/dist/tools/index.js

@@ -1,54 +0,0 @@
-import { TOOLS } from "./definitions.js";
-import { handleReadFile } from "./file_system/read_file.js";
-import { handleWriteFile } from "./file_system/write_file.js";
-import { handleReplaceText } from "./file_system/replace_text.js";
-import { handleBatchSurgicalEdit } from "./file_system/batch_surgical_edit.js";
-import { handlePatchFile } from "./file_system/patch_file.js";
-import { handleGrepSearch } from "./search/grep_search.js";
-import { handleListDir } from "./search/list_dir.js";
-import { handleGetProjectGaps } from "./search/get_gaps.js";
-import { handleGetProjectMap } from "./search/get_map.js";
-import { handleGetFrameworkStatus } from "./framework/get_status.js";
-import { handleUpdateProjectMemory } from "./framework/update_memory.js";
-import { handleAuditDependencies } from "./framework/audit_deps.js";
-import { handleRunTests } from "./framework/run_tests.js";
-import { handleGetSystemHealth } from "./observability/get_health.js";
-import { handleCheckPorts } from "./observability/check_ports.js";
-import { handleStartDashboard } from "./dashboard/start_dashboard.js";
-import { handleOrchestrateLoop } from "./framework/orchestrate.js";
-import { handleUpdateContractHash } from "./framework/update_contract_hash.js";
-import { handleReadProjectMemory } from "./memory/read_memory.js";
-import { handleGetMemoryInsights } from "./memory/get_insights.js";
-import { handleSendAgentMessage } from "./messaging/send_message.js";
-import { handleLogAgentAction } from "./messaging/log_action.js";
-import { handleAcquireLock, handleReleaseLock } from "./control_plane/locking.js";
-import { handleRegisterAgent } from "./control_plane/registry.js";
-// Map of tool names to their handler functions
-export const toolHandlers = {
-    read_file: handleReadFile,
-    list_dir: handleListDir,
-    grep_search: handleGrepSearch,
-    get_project_map: handleGetProjectMap,
-    get_project_gaps: handleGetProjectGaps,
-    write_file: handleWriteFile,
-    replace_text: handleReplaceText,
-    batch_surgical_edit: handleBatchSurgicalEdit,
-    patch_file: handlePatchFile,
-    get_framework_status: handleGetFrameworkStatus,
-    read_project_memory: handleReadProjectMemory,
-    get_memory_insights: handleGetMemoryInsights,
-    update_project_memory: handleUpdateProjectMemory,
-    audit_dependencies: handleAuditDependencies,
-    run_tests: handleRunTests,
-    get_system_health: handleGetSystemHealth,
-    check_active_ports: handleCheckPorts,
-    start_dashboard: handleStartDashboard,
-    orchestrate_loop: handleOrchestrateLoop,
-    send_agent_message: handleSendAgentMessage,
-    log_agent_action: handleLogAgentAction,
-    update_contract_hash: handleUpdateContractHash,
-    acquire_lock: handleAcquireLock,
-    release_lock: handleReleaseLock,
-    register_agent: handleRegisterAgent,
-};
-export { TOOLS };

package/framework-mcp/dist/tools/memory/get_insights.js

@@ -1,34 +0,0 @@
-import fs from "fs";
-import path from "path";
-import { resolveFrameworkDir } from "../../utils/security.js";
-/**
- * Extracts key insights from the project memory to minimize token usage.
- * Returns only the active phase, trace, and the last 5 decisions/tasks.
- */
-export function handleGetMemoryInsights(projectRoot, _args) {
-    try {
-        const frameworkDir = resolveFrameworkDir(projectRoot);
-        const memoryPath = path.join(projectRoot, frameworkDir, "memory/PROJECT_MEMORY.md");
-        if (!fs.existsSync(memoryPath)) {
-            return { content: [{ type: "text", text: "New project: No history available." }] };
-        }
-        const content = fs.readFileSync(memoryPath, "utf8");
-        const lines = content.split("\n");
-        const activePhase = lines.find(l => l.includes("Active Phase:"))?.split(":")[1]?.trim() || "Unknown";
-        const activeTrace = lines.find(l => l.includes("Active Trace:"))?.split(":")[1]?.trim() || "None";
-        // Find the last 5 history items (heuristic)
-        const historyStartIndex = lines.findIndex(l => l.includes("## History"));
-        let recentHistory = "No history found.";
-        if (historyStartIndex !== -1) {
-            recentHistory = lines.slice(historyStartIndex + 1, historyStartIndex + 15)
-                .filter(l => l.trim().startsWith("-"))
-                .slice(-5)
-                .join("\n");
-        }
-        const insights = `🧠 **Memory Insights**\n- **Phase:** ${activePhase}\n- **Trace:** ${activeTrace}\n\n**Recent Actions:**\n${recentHistory}`;
-        return { content: [{ type: "text", text: insights }] };
-    }
-    catch (e) {
-        return { isError: true, content: [{ type: "text", text: `Failed to extract insights: ${String(e)}` }] };
-    }
-}