agent-enderun 1.1.9 → 1.10.0

package/dist/tests/container.test.js

@@ -1,73 +0,0 @@
-import { describe, it, expect, beforeEach } from "vitest";
-import { ServiceContainer } from "../src/shared/container.js";
-import { ValidationError } from "../src/shared/errors.js";
-describe("ServiceContainer", () => {
-    let container;
-    beforeEach(() => {
-        container = ServiceContainer.getInstance();
-        container.reset();
-    });
-    it("should return the same instance (singleton pattern)", () => {
-        const instance1 = ServiceContainer.getInstance();
-        const instance2 = ServiceContainer.getInstance();
-        expect(instance1).toBe(instance2);
-    });
-    it("should register and resolve a service", () => {
-        const myService = { api: "test" };
-        container.register("myService", myService);
-        const resolved = container.resolve("myService");
-        expect(resolved).toBe(myService);
-    });
-    it("should register and resolve a service via factory (lazy evaluation)", () => {
-        let callCount = 0;
-        const factory = () => {
-            callCount++;
-            return { db: "connected" };
-        };
-        container.registerFactory("myDb", factory);
-        // Factory should not be called immediately
-        expect(callCount).toBe(0);
-        // First resolve: factory is executed and cached
-        const firstResolve = container.resolve("myDb");
-        expect(firstResolve).toEqual({ db: "connected" });
-        expect(callCount).toBe(1);
-        // Second resolve: returned from cache, factory not called again
-        const secondResolve = container.resolve("myDb");
-        expect(secondResolve).toBe(firstResolve);
-        expect(callCount).toBe(1);
-    });
-    it("should throw ValidationError when registering a duplicate service", () => {
-        container.register("test", "first");
-        expect(() => {
-            container.register("test", "second");
-        }).toThrow(ValidationError);
-        expect(() => {
-            container.register("test", "second");
-        }).toThrow("Service 'test' is already registered.");
-    });
-    it("should throw ValidationError when registering a duplicate factory", () => {
-        container.registerFactory("test", () => "first");
-        expect(() => {
-            container.registerFactory("test", () => "second");
-        }).toThrow(ValidationError);
-        expect(() => {
-            container.registerFactory("test", () => "second");
-        }).toThrow("Service or factory 'test' is already registered.");
-    });
-    it("should throw ValidationError when resolving a non-existent service", () => {
-        expect(() => {
-            container.resolve("ghostService");
-        }).toThrow(ValidationError);
-        expect(() => {
-            container.resolve("ghostService");
-        }).toThrow("Dependency resolution failed: Service 'ghostService' not found in container.");
-    });
-    it("should reset all registered services and factories", () => {
-        container.register("val", "hello");
-        container.registerFactory("fact", () => "world");
-        container.reset();
-        expect(() => container.resolve("val")).toThrow(ValidationError);
-        expect(() => container.resolve("fact")).toThrow(ValidationError);
-    });
-});
-//# sourceMappingURL=container.test.js.map

package/dist/tests/container.test.js.map

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

package/dist/tests/mock-project/apps/web/panda.config.d.ts

@@ -1,4 +0,0 @@
-declare const _default: import("@pandacss/dev").Config & {
-    name: string;
-};
-export default _default;

package/dist/tests/mock-project/apps/web/panda.config.js

@@ -1,3 +0,0 @@
-import { defineConfig } from "@pandacss/dev";
-export default defineConfig({ theme: { extend: { tokens: { colors: { primary: { value: "#0ea5e9" } } } } } });
-//# sourceMappingURL=panda.config.js.map

package/dist/tests/mock-project/apps/web/panda.config.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"panda.config.js","sourceRoot":"","sources":["../../../../../tests/mock-project/apps/web/panda.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,eAAe,YAAY,CAAC,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC"}

package/dist/tests/shared.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/tests/shared.test.js

@@ -1,80 +0,0 @@
-import { describe, it, expect, beforeEach } from "vitest";
-import { EnderunBaseError, ConfigurationError } from "../src/shared/errors.js";
-import { configManager } from "../src/shared/config.js";
-import { container } from "../src/shared/container.js";
-import { logger, LogLevel } from "../src/shared/logger.js";
-describe("Enterprise Shared Modules", () => {
-    describe("Error Hierarchy", () => {
-        it("should correctly serialize base errors to JSON", () => {
-            const err = new EnderunBaseError("Database failed", "DB_ERROR", { query: "SELECT * FROM users" });
-            const json = err.toJSON();
-            expect(json.name).toBe("EnderunBaseError");
-            expect(json.message).toBe("Database failed");
-            expect(json.code).toBe("DB_ERROR");
-            expect(json.details).toEqual({ query: "SELECT * FROM users" });
-            expect(json.stack).toBeDefined();
-        });
-        it("should subclass ConfigurationError properly", () => {
-            const err = new ConfigurationError("Missing key");
-            expect(err.code).toBe("CONFIGURATION_ERROR");
-            expect(err.message).toBe("Missing key");
-        });
-    });
-    describe("Configuration Manager", () => {
-        it("should load configuration and default nodeEnv to development or test", () => {
-            const current = configManager.get();
-            expect(current).toBeDefined();
-            expect(current.projectRoot).toBeDefined();
-            expect(["development", "production", "test"]).toContain(current.nodeEnv);
-        });
-        it("should freeze configuration values", () => {
-            const current = configManager.get();
-            expect(Object.isFrozen(current)).toBe(true);
-        });
-    });
-    describe("Service Container (DI)", () => {
-        beforeEach(() => {
-            container.reset();
-        });
-        it("should register and resolve singleton instances", () => {
-            const mockService = { api: "https://api.enderun.org" };
-            container.register("MockService", mockService);
-            const resolved = container.resolve("MockService");
-            expect(resolved).toBe(mockService);
-            expect(resolved.api).toBe("https://api.enderun.org");
-        });
-        it("should register and lazily resolve factories", () => {
-            let callCount = 0;
-            container.registerFactory("LazyService", () => {
-                callCount++;
-                return { count: callCount };
-            });
-            expect(callCount).toBe(0);
-            const resolved = container.resolve("LazyService");
-            expect(callCount).toBe(1);
-            expect(resolved.count).toBe(1);
-            // Subsequent resolutions should return cached singleton
-            const resolved2 = container.resolve("LazyService");
-            expect(callCount).toBe(1);
-            expect(resolved2.count).toBe(1);
-        });
-        it("should throw error on duplicate registration", () => {
-            container.register("Dummy", {});
-            expect(() => container.register("Dummy", {})).toThrow();
-        });
-        it("should throw error on unresolved services", () => {
-            expect(() => container.resolve("Unknown")).toThrow();
-        });
-    });
-    describe("Enterprise Logger", () => {
-        it("should configure level filters and print without crash", () => {
-            logger.configure({ minLevel: LogLevel.DEBUG, enableColors: false });
-            // Should not crash
-            logger.debug("Debug log test");
-            logger.info("Info log test", { userId: 42 });
-            logger.warn("Warn log test");
-            logger.error("Error log test");
-        });
-    });
-});
-//# sourceMappingURL=shared.test.js.map

package/dist/tests/shared.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"shared.test.js","sourceRoot":"","sources":["../../tests/shared.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAE3D,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;IAEvC,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;QAC7B,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;YACtD,MAAM,GAAG,GAAG,IAAI,gBAAgB,CAAC,iBAAiB,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,qBAAqB,EAAE,CAAC,CAAC;YAClG,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC;YAE1B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;YAC3C,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;YAC7C,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACnC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,qBAAqB,EAAE,CAAC,CAAC;YAC/D,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;QACrC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;YACnD,MAAM,GAAG,GAAG,IAAI,kBAAkB,CAAC,aAAa,CAAC,CAAC;YAClD,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;YAC7C,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;QACnC,EAAE,CAAC,sEAAsE,EAAE,GAAG,EAAE;YAC5E,MAAM,OAAO,GAAG,aAAa,CAAC,GAAG,EAAE,CAAC;YACpC,MAAM,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;YAC9B,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,WAAW,EAAE,CAAC;YAC1C,MAAM,CAAC,CAAC,aAAa,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC7E,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;YAC1C,MAAM,OAAO,GAAG,aAAa,CAAC,GAAG,EAAE,CAAC;YACpC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;QACpC,UAAU,CAAC,GAAG,EAAE;YACZ,SAAS,CAAC,KAAK,EAAE,CAAC;QACtB,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;YACvD,MAAM,WAAW,GAAG,EAAE,GAAG,EAAE,yBAAyB,EAAE,CAAC;YACvD,SAAS,CAAC,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;YAE/C,MAAM,QAAQ,GAAG,SAAS,CAAC,OAAO,CAAqB,aAAa,CAAC,CAAC;YACtE,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACnC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;QACzD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;YACpD,IAAI,SAAS,GAAG,CAAC,CAAC;YAClB,SAAS,CAAC,eAAe,CAAC,aAAa,EAAE,GAAG,EAAE;gBAC1C,SAAS,EAAE,CAAC;gBACZ,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;YAChC,CAAC,CAAC,CAAC;YAEH,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAE1B,MAAM,QAAQ,GAAG,SAAS,CAAC,OAAO,CAAoB,aAAa,CAAC,CAAC;YACrE,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC1B,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAE/B,wDAAwD;YACxD,MAAM,SAAS,GAAG,SAAS,CAAC,OAAO,CAAoB,aAAa,CAAC,CAAC;YACtE,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC1B,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;YACpD,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YAChC,MAAM,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QAC5D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;YACjD,MAAM,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QACzD,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;QAC/B,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;YAC9D,MAAM,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,CAAC;YAEpE,mBAAmB;YACnB,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;YAC/B,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;YAC7C,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YAC7B,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/docs/README.md

@@ -1,44 +0,0 @@
-# Agent Enderun — Governance and Architecture Portal
-
-This portal is the **Central Knowledge Source** for enterprise projects developed under the Agent Enderun framework. The project's architectural decisions, standards, and governance protocols are sealed here.
-
-Unlike ordinary projects, Agent Enderun projects are built on a structure where AI agents operate autonomously but are bound by a rigid, human-authored constitution. This documentation is the **Immutable Guide** for both AI agents (Army) and human developers.
-
----
-
-### 📋 Documentation Guide
-
-#### [1. Architecture & Governance](architecture/)
-*   **[Architecture Decision Records (ADRs)](architecture/decisions/)**: Answers to "Why" and "How" questions at critical project milestones.
-*   **[Approval & High-Risk Workflows](architecture/approval-flows.md)**: Explains how tokens are generated, audited, and how high-risk actions (e.g., database deletion, privilege escalation) are sealed.
-*   **[Notification Strategy](architecture/notification-strategy.md)**: Dynamic and corporate notification patterns that do not disrupt the user experience.
-
-#### [2. Frontend Standards](frontend/)
-*   **[Component Patterns](frontend/component-patterns.md)**: Zero-UI-Library policy, guide on how all components are hand-crafted and type-safe using Panda CSS.
-*   **[Form Validations](frontend/forms.md)**: Zero-error form management systems managed with Zod and React hooks.
-*   **[Toaster Configuration](frontend/notifications.md)**: Integration of tools like Sonner with the corporate theme.
-
-#### [3. Backend Standards](backend/)
-*   **[Error Handling](backend/error-handling.md)**: Professional error management hierarchy that does not leak to the front-end and is traceable in logs.
-*   **[Audit Logging](backend/audit-logging.md)**: Contracts for how every operation is permanently processed into the database with a Trace ID.
-
-#### [4. User & Planning](user/)
-*   **[Getting Started](user/getting-started.md)**: Quick start guide for new developers.
-*   **[Action Plan 2026](user/action-plan-2026.md)**: Strategic objectives and operational focus.
-*   **[Roadmap](user/roadmap.md)**: The journey towards Singularity and beyond.
-
----
-
-## 🛰️ Phase-Based Development Life Cycle
-All projects must pass the following 5 phases sequentially and completely:
-
-1.  **PHASE_0 (Discovery):** Tech-stack (`tech-stack.md`) sealed, risk analysis performed.
-2.  **PHASE_1 (Architecture & Contract):** First, types and API contracts are written. Contracts must be approved before a single line of application code is written.
-3.  **PHASE_2 (Core Development):** Backend and Frontend are built in parallel. Branded Types usage is mandatory.
-4.  **PHASE_3 (Integration & Test):** @quality agent takes over. 80% Test Coverage threshold must be met before proceeding to the next phase.
-5.  **PHASE_4 (Optimization & Deployment):** Security scans and performance tests are completed.
-
-> **Agent Directive:** The documents under this folder define the operational boundaries of the agents. An agent cannot deviate from a rule defined here. If a rule needs to be updated, this can only be done with @manager approval and ADR registration.
-
-**Version:** v1.0.0  
-**Status:** Active Governance

package/docs/getting-started.md

@@ -1,4 +0,0 @@
-# 🚀 Getting Started
-
-## Project Requirements
-Write the core requirements and features of your application here.

package/docs/user/action-plan-2026.md

@@ -1,9 +0,0 @@
-# Action Plan 2026 - Agent Enderun (v0.6.6+)
-
-This strategic document contains the concrete weekly action plan prepared to close critical gaps identified in the v0.6.6 Gap Analysis.
-
-**Summary:**
-- Phase 1: Reference application + Corporate CRUD Governance + Hermes proof.
-- Phase 3: @frontend and @backend professionalization + quality gates.
-
-Detailed plan and technical scope are provided in this document.

package/docs/user/corporate-governance.md

@@ -1,25 +0,0 @@
-# 🏛️ Kurumsal Yönetim Asistanı Kurulum Rehberi
-
-Agent Enderun, projenize entegre edildiğinde sadece kod yazmakla kalmaz, aynı zamanda kurumsal standartlarınızı koruyan bir **Yönetim Asistanı** (AL Assistant) olarak görev yapar.
-
-## 🚀 Nasıl Çalışır?
-
-1.  **İlklendirme:** `npx agent-enderun init gemini --unified` komutunu çalıştırdığınızda, kurumsal standartlar `.gemini/knowledge/` dizinine otomatik olarak kopyalanır.
-2.  **Ajan Disiplini:** `@manager` ajanı, tüm geliştirmeleri bu standartlara göre denetler. Eğer bir uzman ajan (örn: `@backend`) kurumsal kurallara aykırı bir işlem yapmaya çalışırsa (örn: `any` tipi kullanmak veya doğrudan DB silme işlemi), `@manager` bu işlemi durdurur ve onay mekanizmasını tetikler.
-3.  **AL (Agent Lifecycle):** Projeniz Faz 0'dan Faz 4'e kadar disiplinli bir şekilde ilerler.
-
-## 🛠️ Standartları Özelleştirme
-
-Kendi kurumsal kurallarınızı eklemek için şu dosyaları düzenleyebilirsiniz:
-- `.gemini/knowledge/crud-governance.md`: Veri erişim ve güvenlik kuralları.
-- `.gemini/knowledge/architecture-standards.md`: Mimari katman ve teknoloji standartları.
-- `ENDERUN.md`: Projenin genel anayasası.
-
-## 🎖️ Denetim Komutları
-
-- `agent-enderun check`: Projenin kurumsal standartlara ve dosya yapısına uyumunu denetler.
-- `agent-enderun status`: Aktif fazı ve ajanların durumunu gösterir.
-- `agent-enderun approve [TraceID]`: `@manager` tarafından durdurulan yüksek riskli işlemler için insan onayı verir.
-
----
-*Agent Enderun ile projeleriniz kurumsal disiplin altında, otonom ve güvenli bir şekilde büyür.*

package/docs/user/getting-started.md

@@ -1,13 +0,0 @@
-# Quickstart Guide for New Agent Enderun Projects
-
-This guide is prepared for developers who want to set up Agent Enderun in a new project from scratch.
-
-> **As of v0.6.6, the primary initialization command is:** `npx agent-enderun init`
-
-### Installation Steps
-- Initialize the framework with `npx agent-enderun init`.
-- Fill in the `docs/tech-stack.md` and `docs/project-docs.md` files.
-- Create the first task with `npx agent-enderun trace:new`.
-- @manager manages the project automatically in every session.
-
-**Congratulations!** You can now start developing professional software with Agent Enderun.

package/docs/user/roadmap.md

@@ -1,13 +0,0 @@
-# Agent Enderun — Development Roadmap (v0.6.6+)
-
-**Last Updated:** May 23, 2026
-
-This document contains the development roadmap for the Agent Enderun framework post-v0.6.6.
-
-- **System Health:** 🟢 GREEN (build and test infrastructure under repair)
-- **v0.6.6 Focus:** Translating the entire framework to professional English and analyzing governance gaps honestly.
-
-## Summary
-The Agent Maturity Program is ongoing. @frontend continues to be the highest-risk agent. Live testing of the Hermes protocol and producing a reference application are the main goals for the coming period.
-
-Detailed plan and risk tracking are provided in this document.

package/eslint.config.js

@@ -1,92 +0,0 @@
-import js from "@eslint/js";
-import globals from "globals";
-import tseslint from "typescript-eslint";
-
-const styleRules = {
-    indent: ["error", 4, { SwitchCase: 1 }],
-    "linebreak-style": "off",
-    quotes: ["error", "double"],
-    semi: ["error", "always"],
-    "no-constant-condition": "warn",
-};
-
-export default tseslint.config(
-    {
-        ignores: [
-            "**/node_modules/**",
-            "**/dist/**",
-            "framework-mcp/dist/**",
-
-            ".agent/**",
-            ".gemini/**",
-            ".claude/**",
-            ".cursor/**",
-            ".enderun/**",
-            "panda.config.ts",
-            "test-installations/**",
-            "apps/**",
-        ],
-    },
-    js.configs.recommended,
-    ...tseslint.configs.recommended,
-    {
-        files: ["src/**/*.{ts,tsx}", "framework-mcp/src/**/*.{ts,tsx}"],
-        languageOptions: {
-            ecmaVersion: 2022,
-            sourceType: "module",
-            globals: {
-                ...globals.node,
-                ...globals.es2021,
-            },
-            parserOptions: {
-                project: ["./tsconfig.json", "./framework-mcp/tsconfig.json"],
-                tsconfigRootDir: import.meta.dirname,
-            },
-
-        },
-        rules: {
-            ...styleRules,
-            "no-unused-vars": "off",
-            "@typescript-eslint/no-explicit-any": "error",
-            "@typescript-eslint/explicit-module-boundary-types": "off",
-            "@typescript-eslint/no-unused-vars": ["warn", { argsIgnorePattern: "^_", caughtErrorsIgnorePattern: "^_" }],
-        },
-    },
-    {
-        files: ["tests/**/*.{ts,tsx}", "framework-mcp/tests/**/*.{ts,tsx}", "vitest.config.ts"],
-        languageOptions: {
-            ecmaVersion: 2022,
-            sourceType: "module",
-            globals: {
-                ...globals.node,
-                ...globals.es2021,
-            },
-            parserOptions: {
-                project: ["./tsconfig.json", "./framework-mcp/tsconfig.json"],
-                tsconfigRootDir: import.meta.dirname,
-            },
-        },
-        rules: {
-            ...styleRules,
-            "no-unused-vars": "off",
-            "@typescript-eslint/no-explicit-any": "off",
-            "@typescript-eslint/explicit-module-boundary-types": "off",
-            "@typescript-eslint/no-unused-vars": ["warn", { argsIgnorePattern: "^_", caughtErrorsIgnorePattern: "^_" }],
-        },
-    },
-    {
-        files: ["**/*.js"],
-        languageOptions: {
-            ecmaVersion: 2022,
-            sourceType: "module",
-            globals: {
-                ...globals.node,
-                ...globals.es2021,
-            },
-        },
-        rules: {
-            ...styleRules,
-            "no-unused-vars": ["warn", { argsIgnorePattern: "^_" }],
-        },
-    },
-);

package/framework-mcp/dist/index.js

@@ -1,76 +0,0 @@
-import fs from "fs";
-import path from "path";
-import { fileURLToPath } from "url";
-import { Server } from "@modelcontextprotocol/sdk/server/index.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
-import { TOOLS, toolHandlers } from "./tools/index.js";
-// ─── Server Setup ─────────────────────────────────────────────────
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const pkg = JSON.parse(fs.readFileSync(path.join(__dirname, "../package.json"), "utf8"));
-const serverVersion = pkg.version || "1.1.5";
-const server = new Server({
-    name: "@agent-enderun/mcp",
-    version: serverVersion,
-}, {
-    capabilities: {
-        tools: {},
-    },
-});
-server.setRequestHandler(ListToolsRequestSchema, async () => {
-    return { tools: TOOLS };
-});
-server.setRequestHandler(CallToolRequestSchema, async (request) => {
-    const typedRequest = request;
-    const { name, arguments: args } = typedRequest.params;
-    const projectRoot = process.env.ENDERUN_PROJECT_ROOT || process.cwd();
-    try {
-        const handler = toolHandlers[name];
-        if (!handler) {
-            return {
-                isError: true,
-                content: [{ type: "text", text: `Unknown tool: ${name}` }],
-            };
-        }
-        return handler(projectRoot, args || {});
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : "Unknown error occurred";
-        return {
-            isError: true,
-            content: [{ type: "text", text: message }],
-        };
-    }
-});
-// ─── Graceful Startup & Shutdown ──────────────────────────────────
-async function run() {
-    const transport = new StdioServerTransport();
-    // Prevent unhandled errors from crashing the MCP stream
-    process.on("uncaughtException", (error) => {
-        process.stderr.write(`[agent-enderun-mcp] Uncaught exception: ${error.message}
-`);
-    });
-    process.on("unhandledRejection", (reason) => {
-        const message = reason instanceof Error ? reason.message : String(reason);
-        process.stderr.write(`[agent-enderun-mcp] Unhandled rejection: ${message}
-`);
-    });
-    // Graceful shutdown on SIGINT/SIGTERM
-    const shutdown = async () => {
-        try {
-            await server.close();
-        }
-        catch {
-            // Already closed or failed — safe to ignore
-        }
-        process.exit(0);
-    };
-    process.on("SIGINT", shutdown);
-    process.on("SIGTERM", shutdown);
-    await server.connect(transport);
-}
-run().catch((error) => {
-    process.stderr.write(`[agent-enderun-mcp] Fatal startup error: ${error.message}
-`);
-    process.exit(1);
-});

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

@@ -1,64 +0,0 @@
-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

@@ -1,34 +0,0 @@
-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)}` }]
-        };
-    }
-}

package/framework-mcp/dist/tools/dashboard/start_dashboard.js

@@ -1,29 +0,0 @@
-import fs from "fs";
-import path from "path";
-import { exec } from "child_process";
-/**
- * Starts the Enderun Web Dashboard server.
- */
-export function handleStartDashboard(projectRoot, args) {
-    const port = args.port || 5858;
-    const dashboardScript = path.join(projectRoot, "bin/enderun-dashboard.js");
-    if (!fs.existsSync(dashboardScript)) {
-        throw new Error("Dashboard server script not found in bin/enderun-dashboard.js");
-    }
-    try {
-        // Start the dashboard as a background process
-        exec(`node "${dashboardScript}"`, {
-            cwd: projectRoot,
-            env: { ...process.env, PORT: String(port) }
-        });
-        return {
-            content: [{
-                    type: "text",
-                    text: `🖥️ **Enderun Web Dashboard started!**\n\nAccess it at: http://localhost:${port}\n\nThis interface will show real-time agent status, system health, and orchestration logs.`
-                }]
-        };
-    }
-    catch (e) {
-        return { isError: true, content: [{ type: "text", text: `Failed to start dashboard: ${String(e)}` }] };
-    }
-}