agent-enderun 0.8.8 → 0.9.1

package/framework-mcp/src/tools/framework.ts

@@ -1,223 +0,0 @@
-import fs from "fs";
-import path from "path";
-import { 
-    getFrameworkDir, 
-    collectMarkdownArtifacts, 
-    FRAMEWORK_VERSION 
-} from "../utils.js";
-
-
-export const frameworkTools = [
-    {
-        name: "get_framework_status",
-        description: "Get the current status of the AI Agent Framework, including active phase and agent states.",
-        inputSchema: { type: "object", properties: {} },
-    },
-    {
-        name: "get_project_gaps",
-        description: "Scans the project structure against the defined standards in ENDERUN.md and identifies missing files, folders, or documentation.",
-        inputSchema: { type: "object", properties: {} },
-    },
-    {
-        name: "get_memory_insights",
-        description: "Analyze PROJECT_MEMORY.md and BRAIN_DASHBOARD.md to provide insights on what was done, what is being done, and the history.",
-        inputSchema: { type: "object", properties: {} },
-    },
-    {
-        name: "codebase_context",
-        description: "Compatibility helper for non-code context discovery. Lists known markdown artifacts under docs/ and memory files.",
-        inputSchema: { type: "object", properties: {} },
-    },
-    {
-        name: "get_system_time",
-        description: "Get the current system time in ISO-8601 format (UTC). Use this instead of Shell 'date' commands.",
-        inputSchema: { type: "object", properties: {} },
-    },
-    {
-        name: "bootstrap_legacy_memory",
-        description: "Analyzes a pre-existing codebase to automatically generate the initial project memory, learning its tech stack and architecture.",
-        inputSchema: { type: "object", properties: {} },
-    },
-    {
-        name: "verify_framework_health",
-        description: "Runs the framework's internal 'check' command and reports system health status via MCP.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                detailed: { type: "boolean", default: false, description: "Include detailed issues if any." },
-            },
-        },
-    },
-];
-
-export const frameworkHandlers = {
-    bootstrap_legacy_memory: async (args: unknown, projectRoot: string) => {
-        try {
-            const frameworkDir = getFrameworkDir(projectRoot);
-            const memoryPath = path.join(projectRoot, frameworkDir, "PROJECT_MEMORY.md");
-            const pkgPath = path.join(projectRoot, "package.json");
-            let techStack = "Unknown";
-            if (fs.existsSync(pkgPath)) {
-                const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
-                const allDeps = Object.keys(pkg.dependencies || {}).concat(Object.keys(pkg.devDependencies || {}));
-                const detected = [];
-                if (allDeps.includes("react")) detected.push("React");
-                if (allDeps.includes("next")) detected.push("Next.js");
-                if (allDeps.includes("typescript")) detected.push("TypeScript");
-                if (detected.length > 0) techStack = detected.join(", ");
-            }
-            const date = new Date().toISOString().split("T")[0];
-            const bootstrapContent = `# PROJECT MEMORY — Legacy Onboarding\n\n## CURRENT STATUS\n\n| Active Phase | Profile | Last Update | Active Trace ID | Blockers |\n| PHASE_1 | Full | ${date} | — | Legacy Onboarding |`;
-            if (fs.existsSync(memoryPath)) fs.copyFileSync(memoryPath, memoryPath + ".bak");
-            fs.writeFileSync(memoryPath, bootstrapContent);
-            return { content: [{ type: "text", text: `Legacy Codebase Bootstrap complete. Detected Stack: ${techStack}.` }] };
-        } catch {
-            return { content: [{ type: "text", text: "Failed to bootstrap legacy memory." }] };
-        }
-    },
-    get_framework_status: async (args: unknown, projectRoot: string) => {
-        try {
-            const frameworkDir = getFrameworkDir(projectRoot);
-            const memoryPath = path.join(projectRoot, frameworkDir, "PROJECT_MEMORY.md");
-            const memoryContent = fs.readFileSync(memoryPath, "utf-8");
-            const statusRowMatch = memoryContent.match(/\| Active Phase \| Profile \| Last Update \| Active Trace ID \| Blockers \|\n\| :----------- \| :------ \| :---------- \| :-------------- \| :------- \|\n\| ([^|]+) \| ([^|]+) \| ([^|]+) \| ([^|]+) \| ([^|]+) \|/);
-            const phase = statusRowMatch?.[1]?.trim() ?? "UNKNOWN";
-            const profile = statusRowMatch?.[2]?.trim() ?? "UNKNOWN";
-            return {
-                content: [{ type: "text", text: `Framework active (v${FRAMEWORK_VERSION}). Phase: ${phase}. Profile: ${profile}.` }],
-            };
-        } catch {
-            return { content: [{ type: "text", text: "Failed to get framework status." }] };
-        }
-    },
-    get_project_gaps: async (args: unknown, projectRoot: string) => {
-        const missing: string[] = [];
-        const frameworkDir = getFrameworkDir(projectRoot);
-        const checkPaths = [
-            { path: "apps/backend/src/types", type: "folder", optional: true },
-            { path: "apps/web/src/types", type: "folder", optional: true },
-            { path: "framework-mcp/src", type: "folder" },
-            { path: ".env", type: "file", optional: true },
-            { path: ".env.example", type: "file" },
-            { path: path.join(frameworkDir, "PROJECT_MEMORY.md"), type: "file" },
-            { path: path.join(frameworkDir, "BRAIN_DASHBOARD.md"), type: "file" },
-            { path: "docs/README.md", type: "file" },
-            { path: "docs/getting-started.md", type: "file" },
-            { path: "docs/architecture/approval-flows.md", type: "file", optional: true },
-            { path: "docs/backend/error-handling.md", type: "file", optional: true },
-            { path: "docs/frontend/component-patterns.md", type: "file", optional: true },
-        ];
-        for (const item of checkPaths) {
-            const fullPath = path.join(projectRoot, item.path);
-            if (!fs.existsSync(fullPath) && !item.optional) {
-                missing.push(`[MISSING ${item.type.toUpperCase()}] ${item.path}`);
-            }
-        }
-        const agentsDir = path.join(projectRoot, frameworkDir, "agents");
-        if (!fs.existsSync(agentsDir)) {
-            missing.push(`[MISSING FOLDER] ${frameworkDir}/agents`);
-        } else {
-            const agents = fs.readdirSync(agentsDir)
-                .filter((f) => f.endsWith(".md") && f !== "README.md")
-                .map((f) => f.replace(".md", ""));
-            const logsDir = path.join(projectRoot, frameworkDir, "logs");
-            for (const agentName of agents) {
-                const logFile = path.join(logsDir, `${agentName}.json`);
-                if (!fs.existsSync(logFile)) {
-                    missing.push(`[MISSING LOG FILE] ${frameworkDir}/logs/${agentName}.json (Expected for agent ${agentName})`);
-                }
-            }
-
-            // v1.0 Army infrastructure checks
-            const v1Dirs = [
-                path.join(projectRoot, frameworkDir, "memory-graph"),
-                path.join(projectRoot, frameworkDir, "memory-graph", "agent-contexts"),
-                path.join(projectRoot, frameworkDir, "queue"),
-                path.join(projectRoot, frameworkDir, "agents", "schema"),
-            ];
-            for (const d of v1Dirs) {
-                if (!fs.existsSync(d)) {
-                    missing.push(`[MISSING v1.0 DIR] ${path.relative(projectRoot, d)}`);
-                }
-            }
-        }
-        return { content: [{ type: "text", text: missing.length > 0 ? `Detected Gaps:\n${missing.join("\n")}` : "No structural gaps detected based on core standards." }] };
-    },
-    get_memory_insights: async (args: unknown, projectRoot: string) => {
-        try {
-            const frameworkDir = getFrameworkDir(projectRoot);
-            const memoryPath = path.join(projectRoot, frameworkDir, "PROJECT_MEMORY.md");
-            const dashboardPath = path.join(projectRoot, frameworkDir, "BRAIN_DASHBOARD.md");
-            const memory = fs.existsSync(memoryPath) ? fs.readFileSync(memoryPath, "utf-8") : "Memory file missing.";
-            const dashboard = fs.existsSync(dashboardPath) ? fs.readFileSync(dashboardPath, "utf-8") : "Dashboard file missing.";
-            const history = memory.split("## HISTORY")[1] || "No history found.";
-            const activeTasks = memory.split("## ACTIVE TASKS")[1]?.split("##")[0] || "No active tasks.";
-            const dashboardAgents = dashboard.split("## 📈 Visualizations")[0] || dashboard;
-            return {
-                content: [{ type: "text", text: `### LIVE MEMORY INSIGHTS\n\n**Active Tasks:**\n${activeTasks.trim()}\n\n**Recent History:**\n${history.trim().substring(0, 1000)}...\n\n**Brain Snapshot:**\n${dashboardAgents.trim().substring(0, 500)}...` }],
-            };
-        } catch {
-            return { content: [{ type: "text", text: "Failed to get memory insights." }] };
-        }
-    },
-    codebase_context: async (args: unknown, projectRoot: string) => {
-        try {
-            const artifacts = collectMarkdownArtifacts(projectRoot);
-            const frameworkDir = getFrameworkDir(projectRoot);
-            const memoryPath = path.join(projectRoot, frameworkDir, "PROJECT_MEMORY.md");
-            const dashboardPath = path.join(projectRoot, frameworkDir, "BRAIN_DASHBOARD.md");
-            return {
-                content: [{ type: "text", text: "### CONTEXT ARTIFACTS\n\n" + `PROJECT_MEMORY: ${fs.existsSync(memoryPath) ? "present" : "missing"}\n` + `BRAIN_DASHBOARD: ${fs.existsSync(dashboardPath) ? "present" : "missing"}\n` + `Docs:\n${artifacts.length > 0 ? artifacts.join("\n") : "No markdown artifacts found."}` }],
-            };
-        } catch {
-            return { content: [{ type: "text", text: "Failed to gather codebase context." }] };
-        }
-    },
-    get_system_time: async () => {
-        return { content: [{ type: "text", text: new Date().toISOString() }] };
-    },
-    verify_framework_health: async (args: unknown, projectRoot: string) => {
-        try {
-            const frameworkDir = getFrameworkDir(projectRoot);
-            const requiredFiles = [
-                ["Constitution", fs.existsSync(path.join(projectRoot, "ENDERUN.md")) ? "ENDERUN.md" : path.join(frameworkDir, "ENDERUN.md")],
-                ["Memory", path.join(frameworkDir, "PROJECT_MEMORY.md")],
-                ["Command Map", path.join(frameworkDir, "cli-commands.json")],
-                ["Framework Config", path.join(frameworkDir, "config.json")],
-                ["Agent Status", path.join(frameworkDir, "STATUS.md")],
-                ["MCP Config", "mcp.json"],
-                ["Backend Contract", "apps/backend/contract.version.json"],
-                ["MCP Server", "framework-mcp/package.json"],
-                ["Panda CSS Config", "panda.config.ts"],
-                ["Brain Dashboard", path.join(frameworkDir, "BRAIN_DASHBOARD.md")],
-                ["Docs Portal", "docs/README.md"],
-                ["Getting Started", "docs/getting-started.md"],
-            ] as const;
-
-            const lines: string[] = [];
-            let issues = 0;
-            for (const [name, relativePath] of requiredFiles) {
-                if (fs.existsSync(path.join(projectRoot, relativePath))) {
-                    lines.push(`OK ${name}: ${relativePath}`);
-                } else {
-                    issues += 1;
-                    lines.push(`MISSING ${name}: ${relativePath}`);
-                }
-            }
-
-            const buildPath = path.join(projectRoot, "framework-mcp/dist/index.js");
-            if (fs.existsSync(buildPath)) {
-                lines.push("OK MCP Build: framework-mcp/dist/index.js");
-            } else {
-                issues += 1;
-                lines.push("MISSING MCP Build: framework-mcp/dist/index.js");
-            }
-
-            const status = issues === 0 ? "PASSED" : "FAILED";
-            return { content: [{ type: "text", text: `### FRAMEWORK HEALTH CHECK (${status})\n\n${lines.join("\n")}` }] };
-        } catch (error: unknown) {
-            const err = error as { message?: string };
-            return { content: [{ type: "text", text: `### FRAMEWORK HEALTH CHECK (FAILED)\n\n${err.message ?? "Unknown error"}` }] };
-        }
-    }
-};

package/framework-mcp/src/tools/git.ts

@@ -1,42 +0,0 @@
-import path from "path";
-import { execSync } from "child_process";
-import { GENERATE_SEMANTIC_COMMIT_MESSAGE_ARGS_SCHEMA } from "../schemas.js";
-
-export const gitTools = [
-    {
-        name: "generate_semantic_commit_message",
-        description: "Analyzes staged git changes and generates a structured semantic commit message based on project standards.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                traceId: { type: "string", description: "The active Trace ID (ULID)" },
-            },
-            required: ["traceId"],
-        },
-    },
-];
-
-export const gitHandlers = {
-    generate_semantic_commit_message: async (args: unknown, projectRoot: string) => {
-        const parsed = GENERATE_SEMANTIC_COMMIT_MESSAGE_ARGS_SCHEMA.safeParse(args ?? {});
-        if (!parsed.success) return { content: [{ type: "text", text: "Invalid traceId argument." }] };
-        try {
-            const diff = execSync("git diff --staged", { encoding: "utf-8", cwd: projectRoot });
-            if (!diff) return { content: [{ type: "text", text: "No staged changes found." }] };
-            const files = execSync("git diff --staged --name-only", { encoding: "utf-8", cwd: projectRoot }).split("\n").filter(Boolean);
-            let type = "feat", scope = "code";
-            if (files.some(f => f.includes(".md"))) type = "docs";
-            else if (files.some(f => f.includes("apps/backend/src/types"))) type = "arch";
-            else if (files.some(f => f.includes("framework-mcp"))) type = "chore";
-            else if (files.some(f => f.includes("bin/cli.js"))) type = "fix";
-            else if (files.some(f => f.includes("test"))) type = "test";
-            if (files.some(f => f.includes("apps/web"))) scope = "web";
-            else if (files.some(f => f.includes("apps/backend"))) scope = "backend";
-            else if (files.some(f => f.includes("framework-mcp"))) scope = "mcp";
-            const summary = files.length === 1 ? `update ${path.basename(files[0])}` : `update ${files.length} files`;
-            return { content: [{ type: "text", text: `### SUGGESTED SEMANTIC COMMIT MESSAGE\n\n\`[${parsed.data.traceId}] ${type}(${scope}): ${summary}\`\n\n**Files Analyzed:**\n${files.map(f => `- ${f}`).join("\n")}` }] };
-        } catch {
-            return { content: [{ type: "text", text: "Failed to generate semantic commit message." }] };
-        }
-    },
-};