agent-enderun 1.1.2 → 1.1.4

package/dist/src/modules/adapters/cursor.js

@@ -0,0 +1,20 @@
+import path from "path";
+import { writeJsonFile } from "../../shared/fs.js";
+export const config = {
+    id: "cursor",
+    frameworkDir: ".cursor",
+    shimFile: "CURSOR.md",
+    shimTemplate: "src/cli/shims/cursor.mdc",
+    role: "implementer",
+    templateDir: ".enderun",
+    nestedDirs: ["agents", "rules", "knowledge"],
+    rulesDir: ".cursor/rules",
+    rulesExt: ".mdc"
+};
+export function postInit(projectRoot, mcpBlock) {
+    const frameworkDir = config.frameworkDir;
+    // Native Cursor project-level MCP config
+    writeJsonFile(path.join(projectRoot, frameworkDir, "mcp.json"), mcpBlock);
+    console.warn(`✅ Cursor IDE Project MCP → ${frameworkDir}/mcp.json`);
+}
+//# sourceMappingURL=cursor.js.map

package/dist/src/modules/adapters/cursor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../../../../src/modules/adapters/cursor.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,MAAM,CAAC,MAAM,MAAM,GAAkB;IACjC,EAAE,EAAE,QAAQ;IACZ,YAAY,EAAE,SAAS;IACvB,QAAQ,EAAE,WAAW;IACrB,YAAY,EAAE,0BAA0B;IACxC,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE,UAAU;IACvB,UAAU,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,WAAW,CAAC;IAC5C,QAAQ,EAAE,eAAe;IACzB,QAAQ,EAAE,MAAM;CACnB,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,WAAmB,EAAE,QAAiB;IAC3D,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;IACzC,yCAAyC;IACzC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,UAAU,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC1E,OAAO,CAAC,IAAI,CAAC,8BAA8B,YAAY,WAAW,CAAC,CAAC;AACxE,CAAC"}

package/dist/src/modules/adapters/gemini.d.ts

@@ -0,0 +1,3 @@
+import type { AdapterConfig } from "./types.js";
+export declare const config: AdapterConfig;
+export declare function postInit(projectRoot: string, mcpBlock: unknown): void;

package/dist/src/modules/adapters/gemini.js

@@ -0,0 +1,23 @@
+import path from "path";
+import { writeJsonFile } from "../../shared/fs.js";
+import { registerGlobalAntigravityPlugins } from "./shared.js";
+export const config = {
+    id: "gemini",
+    frameworkDir: ".gemini",
+    shimFile: "GEMINI.md",
+    shimTemplate: "src/cli/shims/gemini.md",
+    role: "commander",
+    templateDir: ".enderun",
+    nestedDirs: ["agents", "rules", "knowledge"],
+    rulesDir: ".gemini/rules",
+    rulesExt: ".md"
+};
+export function postInit(projectRoot, mcpBlock) {
+    const frameworkDir = config.frameworkDir;
+    // Standard project-level MCP config
+    writeJsonFile(path.join(projectRoot, frameworkDir, "mcp.json"), mcpBlock);
+    console.warn(`✅ Gemini MCP registered → ${frameworkDir}/mcp.json`);
+    // Global registration
+    registerGlobalAntigravityPlugins(mcpBlock);
+}
+//# sourceMappingURL=gemini.js.map

package/dist/src/modules/adapters/gemini.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini.js","sourceRoot":"","sources":["../../../../src/modules/adapters/gemini.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,EAAE,gCAAgC,EAAE,MAAM,aAAa,CAAC;AAE/D,MAAM,CAAC,MAAM,MAAM,GAAkB;IACjC,EAAE,EAAE,QAAQ;IACZ,YAAY,EAAE,SAAS;IACvB,QAAQ,EAAE,WAAW;IACrB,YAAY,EAAE,yBAAyB;IACvC,IAAI,EAAE,WAAW;IACjB,WAAW,EAAE,UAAU;IACvB,UAAU,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,WAAW,CAAC;IAC5C,QAAQ,EAAE,eAAe;IACzB,QAAQ,EAAE,KAAK;CAClB,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,WAAmB,EAAE,QAAiB;IAC3D,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;IACzC,oCAAoC;IACpC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,UAAU,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC1E,OAAO,CAAC,IAAI,CAAC,6BAA6B,YAAY,WAAW,CAAC,CAAC;IAEnE,sBAAsB;IACtB,gCAAgC,CAAC,QAAQ,CAAC,CAAC;AAC/C,CAAC"}

package/dist/src/modules/adapters/grok.d.ts

@@ -0,0 +1,3 @@
+import type { AdapterConfig } from "./types.js";
+export declare const config: AdapterConfig;
+export declare function postInit(projectRoot: string, mcpBlock: unknown): void;

package/dist/src/modules/adapters/grok.js

@@ -0,0 +1,18 @@
+import path from "path";
+import { writeJsonFile } from "../../shared/fs.js";
+export const config = {
+    id: "grok",
+    frameworkDir: ".grok",
+    shimFile: "GROK.md",
+    shimTemplate: "src/cli/shims/grok.md",
+    role: "researcher",
+    templateDir: ".enderun",
+    nestedDirs: ["agents", "rules", "knowledge"],
+    rulesDir: ".grok/rules",
+    rulesExt: ".md"
+};
+export function postInit(projectRoot, mcpBlock) {
+    writeJsonFile(path.join(projectRoot, config.frameworkDir, "mcp_config.json"), mcpBlock);
+    console.warn(`✅ Grok MCP → ${config.frameworkDir}/mcp_config.json`);
+}
+//# sourceMappingURL=grok.js.map

package/dist/src/modules/adapters/grok.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grok.js","sourceRoot":"","sources":["../../../../src/modules/adapters/grok.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,MAAM,CAAC,MAAM,MAAM,GAAkB;IACjC,EAAE,EAAE,MAAM;IACV,YAAY,EAAE,OAAO;IACrB,QAAQ,EAAE,SAAS;IACnB,YAAY,EAAE,uBAAuB;IACrC,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,UAAU;IACvB,UAAU,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,WAAW,CAAC;IAC5C,QAAQ,EAAE,aAAa;IACvB,QAAQ,EAAE,KAAK;CAClB,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,WAAmB,EAAE,QAAiB;IAC3D,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,YAAY,EAAE,iBAAiB,CAAC,EAAE,QAAQ,CAAC,CAAC;IACxF,OAAO,CAAC,IAAI,CAAC,gBAAgB,MAAM,CAAC,YAAY,kBAAkB,CAAC,CAAC;AACxE,CAAC"}

package/dist/src/modules/adapters/shared.d.ts

@@ -0,0 +1 @@
+export declare function registerGlobalAntigravityPlugins(mcpBlock: unknown): void;

package/dist/src/modules/adapters/shared.js

@@ -0,0 +1,79 @@
+import path from "path";
+import fs from "fs";
+import os from "os";
+import { writeJsonFile } from "../../shared/fs.js";
+import { ALL_AGENTS, buildAgentJson } from "../agents/definitions.js";
+import { CORE_SKILLS } from "../skills/definitions.js";
+export function registerGlobalAntigravityPlugins(mcpBlock) {
+    const targets = [
+        path.join(os.homedir(), ".gemini/antigravity-cli")
+    ];
+    for (const globalDir of targets) {
+        try {
+            // Write directly under directory
+            fs.mkdirSync(globalDir, { recursive: true });
+            writeJsonFile(path.join(globalDir, "mcp.json"), mcpBlock);
+            writeJsonFile(path.join(globalDir, "mcp_config.json"), mcpBlock);
+            console.warn(`✅ Antigravity MCP registered → ${globalDir}/`);
+            // Global Plugin configuration under plugins/agent-enderun/
+            const globalPluginDir = path.join(globalDir, "plugins/agent-enderun");
+            fs.mkdirSync(globalPluginDir, { recursive: true });
+            // plugin.json marker
+            writeJsonFile(path.join(globalPluginDir, "plugin.json"), {
+                name: "agent-enderun",
+                version: "1.0.0",
+                description: "Agent Enderun AI Orchestration framework"
+            });
+            // MCP Server configs inside the plugin
+            writeJsonFile(path.join(globalPluginDir, "mcp.json"), mcpBlock);
+            writeJsonFile(path.join(globalPluginDir, "mcp_config.json"), mcpBlock);
+            // Scaffold 13 agents
+            const agentsBaseDir = path.join(globalPluginDir, "agents");
+            fs.mkdirSync(agentsBaseDir, { recursive: true });
+            for (const ag of ALL_AGENTS) {
+                const agentJson = buildAgentJson(ag);
+                // 1. Nested format (agents/{agent_name}/agent.json)
+                const nestedAgentDir = path.join(agentsBaseDir, ag.name);
+                fs.mkdirSync(nestedAgentDir, { recursive: true });
+                fs.writeFileSync(path.join(nestedAgentDir, "agent.json"), agentJson);
+                // 2. Direct flat format (agents/{agent_name}.json) as subagent definition templates
+                fs.writeFileSync(path.join(agentsBaseDir, `${ag.name}.json`), agentJson);
+            }
+            // Scaffold skills
+            const skillsDir = path.join(globalPluginDir, "skills");
+            fs.mkdirSync(skillsDir, { recursive: true });
+            for (const [key, skill] of Object.entries(CORE_SKILLS)) {
+                const skillContent = `# 🛠️ Skill — ${skill.name}\n\n${skill.mandates.join("\n")}\n`;
+                fs.writeFileSync(path.join(skillsDir, `${key.toLowerCase()}.md`), skillContent);
+            }
+            // Scaffold rules (Optional custom codebase rules files)
+            const rulesDir = path.join(globalPluginDir, "rules");
+            fs.mkdirSync(rulesDir, { recursive: true });
+            for (const ag of ALL_AGENTS) {
+                const ruleContent = `# 🎖️ Agent Enderun — @${ag.name} (${ag.displayName})
+
+You are the **${ag.displayName}** of the Agent Enderun Army.
+
+## 🤖 Specialist Directive (Role: @${ag.name})
+${ag.instructions}
+
+## 🛡️ Core Mandates
+- **Surgical Precision:** Enforce replace_text / replace_file_content for all code modifications.
+- **Traceability:** Inherit and pass the active Trace ID across all delegations.
+- **Approval Signature:** High-risk actions require manager approval signature.
+`;
+                fs.writeFileSync(path.join(rulesDir, `${ag.name}.md`), ruleContent);
+            }
+            // Scaffold optional empty hooks.json
+            writeJsonFile(path.join(globalPluginDir, "hooks.json"), {
+                preTool: [],
+                postTool: []
+            });
+            console.warn(`✅ Antigravity Plugin registered → ${globalPluginDir}/`);
+        }
+        catch (e) {
+            console.warn(`⚠️ Failed to register plugin/MCP in ${globalDir}:`, e);
+        }
+    }
+}
+//# sourceMappingURL=shared.js.map

package/dist/src/modules/adapters/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../../src/modules/adapters/shared.ts"],"names":[],"mappings":"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"}

package/dist/src/modules/adapters/types.d.ts

@@ -0,0 +1,14 @@
+export declare const ADAPTER_IDS: readonly ["gemini", "claude", "grok", "cursor", "codex", "antigravity-cli"];
+export type AdapterId = (typeof ADAPTER_IDS)[number];
+export type AdapterRole = "commander" | "architect" | "researcher" | "implementer" | "general";
+export interface AdapterConfig {
+    id: AdapterId;
+    frameworkDir: string;
+    shimFile: string;
+    shimTemplate: string;
+    role: AdapterRole;
+    templateDir: ".enderun";
+    nestedDirs?: string[];
+    rulesDir?: string;
+    rulesExt?: string;
+}

package/dist/src/modules/adapters/types.js

@@ -0,0 +1,2 @@
+export const ADAPTER_IDS = ["gemini", "claude", "grok", "cursor", "codex", "antigravity-cli"];
+//# sourceMappingURL=types.js.map

package/dist/src/modules/adapters/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/modules/adapters/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,iBAAiB,CAAU,CAAC"}

package/dist/src/modules/agents/definitions.d.ts

@@ -0,0 +1,13 @@
+export interface AgentDefinition {
+    name: string;
+    displayName: string;
+    description: string;
+    role: string;
+    capability: number;
+    tags: string[];
+    stateMachine: string;
+    tools: string[];
+    instructions: string;
+}
+export declare const ALL_AGENTS: AgentDefinition[];
+export declare function buildAgentJson(ag: AgentDefinition): string;

package/dist/src/modules/agents/definitions.js

@@ -0,0 +1,169 @@
+export const ALL_AGENTS = [
+    {
+        name: "manager",
+        displayName: "Manager (Orchestrator)",
+        role: "Orchestration",
+        description: "The Supreme Manager and Strategic Orchestrator of the Enderun Army.",
+        capability: 10,
+        tags: ["core", "orchestration"],
+        stateMachine: "../schema/agent-lifecycle-schema.json",
+        tools: ["orchestrate_loop", "send_agent_message", "view_file", "list_dir", "grep_search"],
+        instructions: "You represent the Enderun Discipline (Osmanlı Nizami). Your word is the law for the specialists. Delegate tasks with precision."
+    },
+    {
+        name: "architect",
+        displayName: "Lead Architect",
+        role: "System Design",
+        description: "System Design, Contracts, and Core Architecture specialist.",
+        capability: 9,
+        tags: ["core", "design"],
+        stateMachine: "../schema/agent-lifecycle-schema.json",
+        tools: ["view_file", "write_file", "replace_text", "list_dir", "grep_search"],
+        instructions: "Design the project's foundation. Design must be flawless and adhere to the Nizam."
+    },
+    {
+        name: "backend",
+        displayName: "Backend Specialist",
+        role: "Backend Development",
+        description: "Server logic, Databases, and API implementation specialist.",
+        capability: 9,
+        tags: ["core", "logic"],
+        stateMachine: "../schema/agent-lifecycle-schema.json",
+        tools: ["view_file", "replace_text", "run_shell_command", "list_dir", "grep_search"],
+        instructions: "Focus on server logic and databases. Any deviation from the Ferman is a breach of discipline."
+    },
+    {
+        name: "frontend",
+        displayName: "Frontend Specialist",
+        role: "Frontend Development",
+        description: "UI/UX, Panda CSS, and State Management specialist.",
+        capability: 9,
+        tags: ["core", "ui"],
+        stateMachine: "../schema/agent-lifecycle-schema.json",
+        tools: ["view_file", "replace_text", "list_dir", "grep_search"],
+        instructions: "Build elegant and disciplined UIs with master craftsmanship."
+    },
+    {
+        name: "quality",
+        displayName: "Quality Specialist",
+        role: "Quality Audit",
+        description: "Audit, Testing, and Compliance specialist.",
+        capability: 9,
+        tags: ["core", "audit"],
+        stateMachine: "../schema/agent-lifecycle-schema.json",
+        tools: ["run_shell_command", "view_file", "list_dir", "grep_search"],
+        instructions: "You are the inspector of the Nizam. Ensure every unit's work is perfect."
+    },
+    {
+        name: "database",
+        displayName: "Database Specialist",
+        role: "Data Management",
+        description: "SQL Schema design and Query Optimization specialist.",
+        capability: 9,
+        tags: ["core", "data"],
+        stateMachine: "../schema/agent-lifecycle-schema.json",
+        tools: ["view_file", "replace_text", "run_shell_command", "list_dir"],
+        instructions: "Manage data as the empire's treasury. Secure and optimized."
+    },
+    {
+        name: "devops",
+        displayName: "Infrastructure Specialist",
+        role: "DevOps",
+        description: "CI/CD, Deployment, and Infrastructure specialist.",
+        capability: 9,
+        tags: ["core", "infra"],
+        stateMachine: "../schema/agent-lifecycle-schema.json",
+        tools: ["run_shell_command", "view_file", "list_dir"],
+        instructions: "Maintain reliable supply lines and systems like fortresses."
+    },
+    {
+        name: "explorer",
+        displayName: "Intel Explorer",
+        role: "Reconnaissance",
+        description: "Intelligence, Reconnaissance, and Context Discovery.",
+        capability: 8,
+        tags: ["core", "recon"],
+        stateMachine: "../schema/agent-lifecycle-schema.json",
+        tools: ["view_file", "list_dir", "grep_search", "glob"],
+        instructions: "Gather tactical intelligence and map dependencies for the Manager."
+    },
+    {
+        name: "git",
+        displayName: "Logistics Master",
+        role: "Version Control",
+        description: "Git flow, Branching, and Atomic Commit master.",
+        capability: 9,
+        tags: ["core", "logistics"],
+        stateMachine: "../schema/agent-lifecycle-schema.json",
+        tools: ["run_shell_command", "view_file", "list_dir"],
+        instructions: "Manage the scrolls of history. Every commit must be atomic and traceable."
+    },
+    {
+        name: "mobile",
+        displayName: "Mobile Specialist",
+        role: "Mobile Development",
+        description: "React Native and Expo development specialist.",
+        capability: 9,
+        tags: ["core", "mobile"],
+        stateMachine: "../schema/agent-lifecycle-schema.json",
+        tools: ["view_file", "replace_text", "list_dir", "grep_search"],
+        instructions: "Extend reach to the mobile realm with discipline."
+    },
+    {
+        name: "native",
+        displayName: "Native Division",
+        role: "Native Integration",
+        description: "Desktop apps and System-level logic specialist.",
+        capability: 9,
+        tags: ["core", "native"],
+        stateMachine: "../schema/agent-lifecycle-schema.json",
+        tools: ["view_file", "replace_text", "run_shell_command", "list_dir"],
+        instructions: "Handle deep layers of the OS with paramount security."
+    },
+    {
+        name: "security",
+        displayName: "Security Specialist",
+        role: "Security Enforcement",
+        description: "Auth, Encryption, and Safety enforcement specialist.",
+        capability: 10,
+        tags: ["core", "security"],
+        stateMachine: "../schema/agent-lifecycle-schema.json",
+        tools: ["view_file", "replace_text", "grep_search", "run_shell_command"],
+        instructions: "Guardian of the Nizam. block any action that endangers the project."
+    },
+    {
+        name: "analyst",
+        displayName: "Business Analyst",
+        role: "Strategy Analysis",
+        description: "Specs verification and Contract Audit specialist.",
+        capability: 9,
+        tags: ["core", "strategy"],
+        stateMachine: "../schema/agent-lifecycle-schema.json",
+        tools: ["view_file", "list_dir", "grep_search"],
+        instructions: "Audit of truth and contracts within the Army."
+    }
+];
+export function buildAgentJson(ag) {
+    return JSON.stringify({
+        name: ag.name,
+        displayName: ag.displayName,
+        description: ag.description,
+        role: ag.role,
+        capability: ag.capability,
+        tags: ag.tags,
+        stateMachine: ag.stateMachine,
+        hidden: false,
+        customAgentSpec: {
+            customAgent: {
+                systemPromptSections: [
+                    {
+                        title: "Instructions",
+                        content: ag.instructions
+                    }
+                ],
+                toolNames: ag.tools
+            }
+        }
+    }, null, 2);
+}
+//# sourceMappingURL=definitions.js.map

package/dist/src/modules/agents/definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../../../src/modules/agents/definitions.ts"],"names":[],"mappings":"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"}

package/dist/src/modules/skills/definitions.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Core Skill Definitions for Enderun Core.
+ * Groups tools into logical capabilities for agents.
+ */
+export declare const CORE_SKILLS: {
+    FILE_SYSTEM: {
+        name: string;
+        tools: string[];
+        mandates: string[];
+    };
+    EDITING: {
+        name: string;
+        tools: string[];
+        mandates: string[];
+    };
+    ORCHESTRATION: {
+        name: string;
+        tools: string[];
+        mandates: string[];
+    };
+    EXECUTION: {
+        name: string;
+        tools: string[];
+        mandates: string[];
+    };
+    DISCOVERY: {
+        name: string;
+        tools: string[];
+        mandates: string[];
+    };
+};

package/dist/src/modules/skills/definitions.js

@@ -0,0 +1,32 @@
+/**
+ * Core Skill Definitions for Enderun Core.
+ * Groups tools into logical capabilities for agents.
+ */
+export const CORE_SKILLS = {
+    FILE_SYSTEM: {
+        name: "File System Mastery",
+        tools: ["view_file", "list_dir", "glob"],
+        mandates: ["Enforce surgical edits only.", "No destructive deletes without backup."]
+    },
+    EDITING: {
+        name: "Surgical Code Modification",
+        tools: ["replace_text", "patch_file"],
+        mandates: ["replace_text is mandatory for all source code."]
+    },
+    ORCHESTRATION: {
+        name: "Hermes Orchestration",
+        tools: ["orchestrate_loop", "send_agent_message", "status_check"],
+        mandates: ["Maintain PROJECT_MEMORY.md at each turn."]
+    },
+    EXECUTION: {
+        name: "Secure Shell Execution",
+        tools: ["run_shell_command"],
+        mandates: ["Avoid destructive root commands.", "Always prefer quiet/silent flags."]
+    },
+    DISCOVERY: {
+        name: "Codebase Discovery",
+        tools: ["grep_search", "glob", "view_file"],
+        mandates: ["Map dependencies before proposing changes."]
+    }
+};
+//# sourceMappingURL=definitions.js.map

package/dist/src/modules/skills/definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../../../src/modules/skills/definitions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG;IACvB,WAAW,EAAE;QACT,IAAI,EAAE,qBAAqB;QAC3B,KAAK,EAAE,CAAC,WAAW,EAAE,UAAU,EAAE,MAAM,CAAC;QACxC,QAAQ,EAAE,CAAC,8BAA8B,EAAE,wCAAwC,CAAC;KACvF;IACD,OAAO,EAAE;QACL,IAAI,EAAE,4BAA4B;QAClC,KAAK,EAAE,CAAC,cAAc,EAAE,YAAY,CAAC;QACrC,QAAQ,EAAE,CAAC,gDAAgD,CAAC;KAC/D;IACD,aAAa,EAAE;QACX,IAAI,EAAE,sBAAsB;QAC5B,KAAK,EAAE,CAAC,kBAAkB,EAAE,oBAAoB,EAAE,cAAc,CAAC;QACjE,QAAQ,EAAE,CAAC,0CAA0C,CAAC;KACzD;IACD,SAAS,EAAE;QACP,IAAI,EAAE,wBAAwB;QAC9B,KAAK,EAAE,CAAC,mBAAmB,CAAC;QAC5B,QAAQ,EAAE,CAAC,kCAAkC,EAAE,mCAAmC,CAAC;KACtF;IACD,SAAS,EAAE;QACP,IAAI,EAAE,oBAAoB;QAC1B,KAAK,EAAE,CAAC,aAAa,EAAE,MAAM,EAAE,WAAW,CAAC;QAC3C,QAAQ,EAAE,CAAC,4CAA4C,CAAC;KAC3D;CACJ,CAAC"}

package/dist/src/shared/fs.d.ts

@@ -0,0 +1,3 @@
+export declare function ensureDir(dirPath: string, dryRun?: boolean): void;
+export declare function writeTextFile(filePath: string, content: string, dryRun?: boolean): void;
+export declare function writeJsonFile(filePath: string, value: unknown, dryRun?: boolean): void;

package/dist/src/shared/fs.js

@@ -0,0 +1,24 @@
+import fs from "fs";
+import path from "path";
+export function ensureDir(dirPath, dryRun = false) {
+    if (!fs.existsSync(dirPath)) {
+        if (dryRun) {
+            console.warn(`[DRY RUN] Would create directory: ${dirPath}`);
+        }
+        else {
+            fs.mkdirSync(dirPath, { recursive: true });
+        }
+    }
+}
+export function writeTextFile(filePath, content, dryRun = false) {
+    if (dryRun) {
+        console.warn(`[DRY RUN] Would write file: ${filePath}`);
+        return;
+    }
+    ensureDir(path.dirname(filePath));
+    fs.writeFileSync(filePath, content.endsWith("\n") ? content : `${content}\n`);
+}
+export function writeJsonFile(filePath, value, dryRun = false) {
+    writeTextFile(filePath, JSON.stringify(value, null, 2), dryRun);
+}
+//# sourceMappingURL=fs.js.map

package/dist/src/shared/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../../src/shared/fs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,MAAM,UAAU,SAAS,CAAC,OAAe,EAAE,MAAM,GAAG,KAAK;IACrD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1B,IAAI,MAAM,EAAE,CAAC;YACT,OAAO,CAAC,IAAI,CAAC,qCAAqC,OAAO,EAAE,CAAC,CAAC;QACjE,CAAC;aAAM,CAAC;YACJ,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/C,CAAC;IACL,CAAC;AACL,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,QAAgB,EAAE,OAAe,EAAE,MAAM,GAAG,KAAK;IAC3E,IAAI,MAAM,EAAE,CAAC;QACT,OAAO,CAAC,IAAI,CAAC,+BAA+B,QAAQ,EAAE,CAAC,CAAC;QACxD,OAAO;IACX,CAAC;IACD,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IAClC,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;AAClF,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,QAAgB,EAAE,KAAc,EAAE,MAAM,GAAG,KAAK;IAC1E,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;AACpE,CAAC"}

package/eslint.config.js

@@ -23,6 +23,7 @@ export default tseslint.config(
             ".cursor/**",
             ".enderun/**",
             "panda.config.ts",
+            "test-installations/**",
         ],
     },
     js.configs.recommended,

package/framework-mcp/dist/index.js

@@ -5,7 +5,7 @@ import { TOOLS, toolHandlers } from "./tools/index.js";
 // ─── Server Setup ─────────────────────────────────────────────────
 const server = new Server({
     name: "@agent-enderun/mcp",
-    version: "1.0.9",
+    version: "1.1.4",
 }, {
     capabilities: {
         tools: {},

package/framework-mcp/dist/tools/control_plane/locking.js

@@ -0,0 +1,64 @@
+import fs from "fs";
+import path from "path";
+import { resolveFrameworkDir } from "../../utils/security.js";
+/**
+ * Handles acquiring a stateful lock on a resource.
+ */
+export async function handleAcquireLock(projectRoot, args) {
+    const { resource, agent, ttl = 60 } = args;
+    const frameworkDir = resolveFrameworkDir(projectRoot);
+    const lockDir = path.join(projectRoot, frameworkDir, "locks");
+    const lockPath = path.join(lockDir, `${resource}.lock`);
+    try {
+        if (!fs.existsSync(lockDir))
+            fs.mkdirSync(lockDir, { recursive: true });
+        if (fs.existsSync(lockPath)) {
+            const stat = fs.statSync(lockPath);
+            const now = new Date().getTime();
+            const age = (now - stat.mtimeMs) / 1000;
+            if (age < ttl) {
+                return {
+                    isError: true,
+                    content: [{ type: "text", text: `Resource '${resource}' is currently locked by another agent.` }]
+                };
+            }
+            // Lock expired, safe to override
+            fs.unlinkSync(lockPath);
+        }
+        fs.writeFileSync(lockPath, JSON.stringify({ agent, timestamp: new Date().toISOString() }));
+        return {
+            content: [{ type: "text", text: `✅ Lock acquired for resource '${resource}' by ${agent}.` }]
+        };
+    }
+    catch (e) {
+        return {
+            isError: true,
+            content: [{ type: "text", text: `Failed to acquire lock: ${String(e)}` }]
+        };
+    }
+}
+/**
+ * Handles releasing a lock.
+ */
+export async function handleReleaseLock(projectRoot, args) {
+    const { resource, agent } = args;
+    const frameworkDir = resolveFrameworkDir(projectRoot);
+    const lockPath = path.join(projectRoot, frameworkDir, "locks", `${resource}.lock`);
+    try {
+        if (!fs.existsSync(lockPath)) {
+            return { content: [{ type: "text", text: `ℹ️ No lock found for resource '${resource}'.` }] };
+        }
+        const lockData = JSON.parse(fs.readFileSync(lockPath, "utf8"));
+        if (lockData.agent !== agent) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: `❌ Denied: You do not own the lock for '${resource}'. Owned by ${lockData.agent}.` }]
+            };
+        }
+        fs.unlinkSync(lockPath);
+        return { content: [{ type: "text", text: `✅ Lock released for resource '${resource}' by ${agent}.` }] };
+    }
+    catch (e) {
+        return { isError: true, content: [{ type: "text", text: `Failed to release lock: ${String(e)}` }] };
+    }
+}

package/framework-mcp/dist/tools/control_plane/registry.js

@@ -0,0 +1,34 @@
+import fs from "fs";
+import path from "path";
+import { resolveFrameworkDir } from "../../utils/security.js";
+/**
+ * Handles agent registration with the Control Plane.
+ * This can be used to validate permissions and active status.
+ */
+export async function handleRegisterAgent(projectRoot, args) {
+    const { agent, role, capability = 5 } = args;
+    const frameworkDir = resolveFrameworkDir(projectRoot);
+    const registryDir = path.join(projectRoot, frameworkDir, "registry");
+    const agentFile = path.join(registryDir, `${agent.replace("@", "")}_active.json`);
+    try {
+        if (!fs.existsSync(registryDir))
+            fs.mkdirSync(registryDir, { recursive: true });
+        const agentData = {
+            agent,
+            role,
+            capability,
+            last_seen: new Date().toISOString(),
+            status: "ACTIVE"
+        };
+        fs.writeFileSync(agentFile, JSON.stringify(agentData, null, 2));
+        return {
+            content: [{ type: "text", text: `🎖️ Agent ${agent} (${role}) registered successfully in the Enderun Control Plane.` }]
+        };
+    }
+    catch (e) {
+        return {
+            isError: true,
+            content: [{ type: "text", text: `Failed to register agent: ${String(e)}` }]
+        };
+    }
+}