agent-enderun 1.1.5 → 1.1.7

package/dist/tests/skills-definitions.test.js

@@ -0,0 +1,34 @@
+import { describe, it, expect } from "vitest";
+import { CORE_SKILLS } from "../src/modules/skills/definitions.js";
+describe("Skills Definitions", () => {
+    it("should define all core skills with proper keys", () => {
+        const keys = Object.keys(CORE_SKILLS);
+        expect(keys).toContain("FILE_SYSTEM");
+        expect(keys).toContain("EDITING");
+        expect(keys).toContain("ORCHESTRATION");
+        expect(keys).toContain("GOVERNANCE");
+        expect(keys).toContain("QUALITY_ASSURANCE");
+        expect(keys).toContain("DATABASE_MANAGEMENT");
+        expect(keys).toContain("DEVOPS_INFRASTRUCTURE");
+    });
+    it("should ensure all skills have valid properties, mandates and tools", () => {
+        for (const [key, skill] of Object.entries(CORE_SKILLS)) {
+            expect(skill.name).toBeTypeOf("string");
+            expect(skill.name.length).toBeGreaterThan(0);
+            expect(skill.description).toBeTypeOf("string");
+            expect(skill.description.length).toBeGreaterThan(0);
+            expect(Array.isArray(skill.tools)).toBe(true);
+            expect(skill.tools.length).toBeGreaterThan(0);
+            for (const tool of skill.tools) {
+                expect(tool).toBeTypeOf("string");
+            }
+            expect(Array.isArray(skill.mandates)).toBe(true);
+            expect(skill.mandates.length).toBeGreaterThan(0);
+            for (const mandate of skill.mandates) {
+                expect(mandate).toBeTypeOf("string");
+                expect(mandate.length).toBeGreaterThan(0);
+            }
+        }
+    });
+});
+//# sourceMappingURL=skills-definitions.test.js.map

package/dist/tests/skills-definitions.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills-definitions.test.js","sourceRoot":"","sources":["../../tests/skills-definitions.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AAEnE,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACtD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACtC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;QACtC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QAClC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;QACxC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QACrC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC;QAC5C,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,qBAAqB,CAAC,CAAC;QAC9C,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,uBAAuB,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oEAAoE,EAAE,GAAG,EAAE;QAC1E,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;YACrD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;YACxC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;YAE7C,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;YAC/C,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;YAEpD,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC9C,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;YAC9C,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;gBAC7B,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;YACtC,CAAC;YAED,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjD,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;YACjD,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;gBACnC,MAAM,CAAC,OAAO,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;gBACrC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;YAC9C,CAAC;QACL,CAAC;IACL,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

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

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

package/dist/tests/status.test.js

@@ -0,0 +1,105 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import fs from "fs";
+import path from "path";
+import { statusCommand } from "../src/cli/commands/status.js";
+describe("Status Command", () => {
+    const tempDir = path.join(process.cwd(), "tests", "temp-status-test");
+    let cwdSpy;
+    beforeEach(() => {
+        vi.resetModules();
+        if (!fs.existsSync(tempDir)) {
+            fs.mkdirSync(tempDir, { recursive: true });
+        }
+        cwdSpy = vi.spyOn(process, "cwd").mockReturnValue(tempDir);
+    });
+    afterEach(() => {
+        cwdSpy.mockRestore();
+        if (fs.existsSync(tempDir)) {
+            fs.rmSync(tempDir, { recursive: true, force: true });
+        }
+    });
+    it("should print error if PROJECT_MEMORY.md is missing", async () => {
+        const consoleErrorSpy = vi.spyOn(console, "error").mockImplementation(() => { });
+        statusCommand();
+        expect(consoleErrorSpy).toHaveBeenCalledWith(expect.stringContaining("PROJECT_MEMORY.md not found"));
+        consoleErrorSpy.mockRestore();
+    });
+    it("should parse Table Style status correctly", async () => {
+        const frameworkDir = path.join(tempDir, ".gemini");
+        fs.mkdirSync(frameworkDir, { recursive: true });
+        const memoryPath = path.join(frameworkDir, "PROJECT_MEMORY.md");
+        const tableMemory = `## STATUS
+| Active Phase | Profile | Last Update | Active Trace ID | Blockers |
+| :----------- | :------ | :---------- | :-------------- | :------- |
+| Phase 1 | Dev | 2024-06-07 | 01HY7Y2A00ABC | None |
+
+## ACTIVE TASKS
+| Task 1 |
+`;
+        fs.writeFileSync(memoryPath, tableMemory);
+        const consoleWarnSpy = vi.spyOn(console, "warn").mockImplementation(() => { });
+        statusCommand();
+        expect(consoleWarnSpy).toHaveBeenCalledWith(expect.stringContaining("Phase: Phase 1"));
+        expect(consoleWarnSpy).toHaveBeenCalledWith(expect.stringContaining("Profile: Dev"));
+        expect(consoleWarnSpy).toHaveBeenCalledWith(expect.stringContaining("Trace ID: 01HY7Y2A00ABC"));
+        expect(consoleWarnSpy).toHaveBeenCalledWith(expect.stringContaining("Blockers: None"));
+        expect(consoleWarnSpy).toHaveBeenCalledWith(expect.stringContaining("Active Tasks:"));
+        consoleWarnSpy.mockRestore();
+    });
+    it("should parse List Style status and render manager state correctly", async () => {
+        const frameworkDir = path.join(tempDir, ".gemini");
+        fs.mkdirSync(frameworkDir, { recursive: true });
+        const memoryPath = path.join(frameworkDir, "PROJECT_MEMORY.md");
+        const listMemory = `## STATUS
+- Phase: Phase 2
+- Profile: Prod
+- Last Update: 2024-06-08
+- Trace ID: 01HY7Y2A00XYZ
+- Blockers: High CPU
+- @manager state: EXECUTING
+`;
+        fs.writeFileSync(memoryPath, listMemory);
+        const consoleWarnSpy = vi.spyOn(console, "warn").mockImplementation(() => { });
+        statusCommand();
+        expect(consoleWarnSpy).toHaveBeenCalledWith(expect.stringContaining("Phase: Phase 2"));
+        expect(consoleWarnSpy).toHaveBeenCalledWith(expect.stringContaining("Profile: Prod"));
+        expect(consoleWarnSpy).toHaveBeenCalledWith(expect.stringContaining("Trace ID: 01HY7Y2A00XYZ"));
+        expect(consoleWarnSpy).toHaveBeenCalledWith(expect.stringContaining("Blockers: High CPU"));
+        expect(consoleWarnSpy).toHaveBeenCalledWith(expect.stringContaining("Manager: EXECUTING"));
+        consoleWarnSpy.mockRestore();
+    });
+    it("should print warning when format is unrecognized", async () => {
+        const frameworkDir = path.join(tempDir, ".gemini");
+        fs.mkdirSync(frameworkDir, { recursive: true });
+        const memoryPath = path.join(frameworkDir, "PROJECT_MEMORY.md");
+        fs.writeFileSync(memoryPath, "## STATUS\nRandom text that matches no format.\n");
+        const consoleWarnSpy = vi.spyOn(console, "warn").mockImplementation(() => { });
+        statusCommand();
+        expect(consoleWarnSpy).toHaveBeenCalledWith(expect.stringContaining("Status data could not be parsed"));
+        consoleWarnSpy.mockRestore();
+    });
+    it("should display Enderun Army Status if STATUS.md exists", async () => {
+        const frameworkDir = path.join(tempDir, ".gemini");
+        fs.mkdirSync(frameworkDir, { recursive: true });
+        const memoryPath = path.join(frameworkDir, "PROJECT_MEMORY.md");
+        fs.writeFileSync(memoryPath, "## STATUS\n- Phase: Phase 1\n");
+        const statusPath = path.join(frameworkDir, "STATUS.md");
+        const statusContent = `
+# Status Log
+| Agent | State | Active Task |
+|---|---|---|
+| @manager | READY | Idle |
+| @coder | EXECUTING | Writing Tests |
+| @tester | BLOCKED | Sandbox issue |
+`;
+        fs.writeFileSync(statusPath, statusContent);
+        const consoleWarnSpy = vi.spyOn(console, "warn").mockImplementation(() => { });
+        statusCommand();
+        expect(consoleWarnSpy).toHaveBeenCalledWith(expect.stringContaining("Enderun Army Status"));
+        expect(consoleWarnSpy).toHaveBeenCalledWith(expect.stringContaining("@manager"));
+        expect(consoleWarnSpy).toHaveBeenCalledWith(expect.stringContaining("@coder"));
+        expect(consoleWarnSpy).toHaveBeenCalledWith(expect.stringContaining("@tester"));
+        consoleWarnSpy.mockRestore();
+    });
+});
+//# sourceMappingURL=status.test.js.map

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

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

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

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

package/dist/tests/string.test.js

@@ -0,0 +1,89 @@
+import { describe, it, expect } from "vitest";
+import { insertTaskRow, sanitizeTableCell, normalizeAgentName, normalizePriority, slugifyName, titleCase } from "../src/cli/utils/string.js";
+describe("String Utilities", () => {
+    describe("insertTaskRow", () => {
+        it("should insert a row directly under the active tasks table divider", () => {
+            const memoryContent = "## ACTIVE TASKS\n| Task | Status |\n| :--- | :--- | :--- | :--- | :--- |\n| Existing Task | Done |\n";
+            const row = "| New Task | Pending |";
+            const result = insertTaskRow(memoryContent, row);
+            expect(result).toBe("## ACTIVE TASKS\n| Task | Status |\n| :--- | :--- | :--- | :--- | :--- |\n| New Task | Pending |\n| Existing Task | Done |\n");
+        });
+        it("should return null if ## ACTIVE TASKS section is missing", () => {
+            const memoryContent = "## TASKS\n| :--- | :--- | :--- | :--- | :--- |\n";
+            const result = insertTaskRow(memoryContent, "| Row |");
+            expect(result).toBeNull();
+        });
+        it("should return null if table divider is missing", () => {
+            const memoryContent = "## ACTIVE TASKS\n| Task | Status |\n";
+            const result = insertTaskRow(memoryContent, "| Row |");
+            expect(result).toBeNull();
+        });
+    });
+    describe("sanitizeTableCell", () => {
+        it("should escape vertical pipes", () => {
+            expect(sanitizeTableCell("Value | with | pipes")).toBe("Value \\| with \\| pipes");
+        });
+        it("should replace newlines with spaces", () => {
+            expect(sanitizeTableCell("Line 1\nLine 2\r\nLine 3")).toBe("Line 1 Line 2 Line 3");
+        });
+        it("should trim surrounding whitespace", () => {
+            expect(sanitizeTableCell("   some value   ")).toBe("some value");
+        });
+        it("should handle non-string inputs", () => {
+            expect(sanitizeTableCell(12345)).toBe("12345");
+            expect(sanitizeTableCell(true)).toBe("true");
+        });
+    });
+    describe("normalizeAgentName", () => {
+        it("should remove leading @ symbols", () => {
+            expect(normalizeAgentName("@manager")).toBe("manager");
+            expect(normalizeAgentName("@@@coder")).toBe("coder");
+        });
+        it("should fallback to manager if name is empty, null or undefined", () => {
+            expect(normalizeAgentName(undefined)).toBe("manager");
+            expect(normalizeAgentName(null)).toBe("manager");
+            expect(normalizeAgentName("")).toBe("manager");
+            expect(normalizeAgentName("   ")).toBe("manager");
+        });
+        it("should trim whitespace", () => {
+            expect(normalizeAgentName("  coder  ")).toBe("coder");
+        });
+    });
+    describe("normalizePriority", () => {
+        it("should accept valid priorities P0, P1, P2, P3", () => {
+            expect(normalizePriority("P0")).toBe("P0");
+            expect(normalizePriority("p1")).toBe("P1");
+            expect(normalizePriority("  P3  ")).toBe("P3");
+        });
+        it("should fallback to P2 for invalid priorities", () => {
+            expect(normalizePriority("P4")).toBe("P2");
+            expect(normalizePriority("invalid")).toBe("P2");
+            expect(normalizePriority(null)).toBe("P2");
+            expect(normalizePriority(undefined)).toBe("P2");
+        });
+    });
+    describe("slugifyName", () => {
+        it("should convert to lowercase, replace special chars with hyphens and trim hyphens", () => {
+            expect(slugifyName("Enderun App Core")).toBe("enderun-app-core");
+            expect(slugifyName("Agent-Manager_123!")).toBe("agent-manager-123");
+            expect(slugifyName("---Leading-Trailing---")).toBe("leading-trailing");
+        });
+        it("should fallback to enderun-app for empty or invalid slugs", () => {
+            expect(slugifyName("")).toBe("enderun-app");
+            expect(slugifyName("!!!")).toBe("enderun-app");
+            expect(slugifyName(null)).toBe("enderun-app");
+        });
+    });
+    describe("titleCase", () => {
+        it("should format string to Title Case and handle delimiters", () => {
+            expect(titleCase("enderun-app-core")).toBe("Enderun App Core");
+            expect(titleCase("agent_manager_test")).toBe("Agent Manager Test");
+            expect(titleCase("  multiple   spaces  ")).toBe("Multiple Spaces");
+        });
+        it("should fallback to Enderun App for empty input", () => {
+            expect(titleCase("")).toBe("Enderun App");
+            expect(titleCase(null)).toBe("Enderun App");
+        });
+    });
+});
+//# sourceMappingURL=string.test.js.map

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

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

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

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

package/dist/tests/time.test.js

@@ -0,0 +1,48 @@
+import { describe, it, expect } from "vitest";
+import { generateULID, sleep } from "../src/cli/utils/time.js";
+describe("Time Utilities", () => {
+    describe("generateULID", () => {
+        const CROCKFORD_BASE32 = "0123456789ABCDEFGHJKMNPQRSTVWXYZ";
+        it("should generate a 26 character string", () => {
+            const ulid = generateULID();
+            expect(ulid).toHaveLength(26);
+        });
+        it("should only contain valid Crockford's base32 characters (excluding I, L, O, U)", () => {
+            const ulid = generateULID();
+            for (const char of ulid) {
+                expect(CROCKFORD_BASE32).toContain(char);
+                expect("ILOU").not.toContain(char);
+            }
+        });
+        it("should be deterministic when given a seed time and seed number", () => {
+            const seedTime = 1717718400000; // 2024-06-07T00:00:00.000Z
+            const seed = 42;
+            const ulid1 = generateULID(seedTime, seed);
+            const ulid2 = generateULID(seedTime, seed);
+            expect(ulid1).toBe(ulid2);
+            expect(ulid1).toHaveLength(26);
+            // Ensure first 10 chars encode seedTime correctly in base32
+            expect(ulid1.substring(0, 10)).toBe("01HY7Y2A00");
+        });
+        it("should generate different random parts without a seed even at the same seedTime", () => {
+            const seedTime = Date.now();
+            const ulid1 = generateULID(seedTime);
+            const ulid2 = generateULID(seedTime);
+            expect(ulid1).not.toBe(ulid2);
+            expect(ulid1.substring(0, 10)).toBe(ulid2.substring(0, 10)); // Time part must be equal
+            expect(ulid1.substring(10)).not.toBe(ulid2.substring(10)); // Random part must differ
+        });
+    });
+    describe("sleep", () => {
+        it("should delay execution by approximately the specified time", () => {
+            const start = Date.now();
+            const delay = 50; // 50ms
+            sleep(delay);
+            const duration = Date.now() - start;
+            // Atomics.wait is quite precise, but let's give a generous buffer for CI
+            expect(duration).toBeGreaterThanOrEqual(delay - 5);
+            expect(duration).toBeLessThanOrEqual(delay + 50);
+        });
+    });
+});
+//# sourceMappingURL=time.test.js.map

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

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

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

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

package/dist/tests/trace.test.js

@@ -0,0 +1,61 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import fs from "fs";
+import path from "path";
+import { traceNewCommand } from "../src/cli/commands/trace.js";
+describe("Trace Command", () => {
+    const tempDir = path.join(process.cwd(), "tests", "temp-trace-test");
+    let cwdSpy;
+    beforeEach(() => {
+        vi.resetModules();
+        if (!fs.existsSync(tempDir)) {
+            fs.mkdirSync(tempDir, { recursive: true });
+        }
+        cwdSpy = vi.spyOn(process, "cwd").mockReturnValue(tempDir);
+    });
+    afterEach(() => {
+        cwdSpy.mockRestore();
+        if (fs.existsSync(tempDir)) {
+            fs.rmSync(tempDir, { recursive: true, force: true });
+        }
+    });
+    it("should print error if PROJECT_MEMORY.md is missing", async () => {
+        const consoleErrorSpy = vi.spyOn(console, "error").mockImplementation(() => { });
+        const result = traceNewCommand("Test description");
+        expect(result).toBeUndefined();
+        expect(consoleErrorSpy).toHaveBeenCalledWith(expect.stringContaining("PROJECT_MEMORY.md not found"));
+        consoleErrorSpy.mockRestore();
+    });
+    it("should print error if ACTIVE TASKS table is missing in PROJECT_MEMORY.md", async () => {
+        // Setup mock environment structure
+        const frameworkDir = path.join(tempDir, ".gemini");
+        fs.mkdirSync(frameworkDir, { recursive: true });
+        const memoryPath = path.join(frameworkDir, "PROJECT_MEMORY.md");
+        fs.writeFileSync(memoryPath, "# PROJECT MEMORY\nNo tasks table here.\n");
+        const consoleErrorSpy = vi.spyOn(console, "error").mockImplementation(() => { });
+        const result = traceNewCommand("Test description");
+        expect(result).toBeUndefined();
+        expect(consoleErrorSpy).toHaveBeenCalledWith(expect.stringContaining("ACTIVE TASKS table not found"));
+        consoleErrorSpy.mockRestore();
+    });
+    it("should successfully generate Trace ID and add task to table", async () => {
+        const frameworkDir = path.join(tempDir, ".gemini");
+        fs.mkdirSync(frameworkDir, { recursive: true });
+        const memoryPath = path.join(frameworkDir, "PROJECT_MEMORY.md");
+        // Setup proper template with ACTIVE TASKS table
+        const template = "## CURRENT STATUS\n\n## ACTIVE TASKS\n| Trace ID | Description | Agent | Priority | Status |\n| :--- | :--- | :--- | :--- | :--- |\n";
+        fs.writeFileSync(memoryPath, template);
+        const consoleWarnSpy = vi.spyOn(console, "warn").mockImplementation(() => { });
+        const traceId = traceNewCommand("Implement tests", "coder", "P1");
+        expect(traceId).toBeDefined();
+        expect(typeof traceId).toBe("string");
+        expect(traceId).toHaveLength(26);
+        const updatedContent = fs.readFileSync(memoryPath, "utf8");
+        expect(updatedContent).toContain(traceId);
+        expect(updatedContent).toContain("Implement tests");
+        expect(updatedContent).toContain("@coder");
+        expect(updatedContent).toContain("P1");
+        expect(updatedContent).toContain("IN_PROGRESS");
+        consoleWarnSpy.mockRestore();
+    });
+});
+//# sourceMappingURL=trace.test.js.map

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

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

package/dist/vitest.config.js

@@ -4,6 +4,7 @@ export default defineConfig({
         globals: true,
         environment: "node",
         include: ["tests/**/*.test.ts", "framework-mcp/tests/**/*.test.ts"],
+        cache: false,
         coverage: {
             provider: "v8",
             reporter: ["text", "json", "html"],

package/dist/vitest.config.js.map

@@ -1 +1 @@
-{"version":3,"file":"vitest.config.js","sourceRoot":"","sources":["../vitest.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,eAAe,YAAY,CAAC;IACxB,IAAI,EAAE;QACF,OAAO,EAAE,IAAI;QACb,WAAW,EAAE,MAAM;QACnB,OAAO,EAAE,CAAC,oBAAoB,EAAE,kCAAkC,CAAC;QACnE,QAAQ,EAAE;YACN,QAAQ,EAAE,IAAI;YACd,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;YAClC,UAAU,EAAE;gBACR,KAAK,EAAE,EAAE;gBACT,SAAS,EAAE,EAAE;gBACb,QAAQ,EAAE,EAAE;gBACZ,UAAU,EAAE,EAAE;aACjB;SACJ;KACJ;CACJ,CAAC,CAAC"}
+{"version":3,"file":"vitest.config.js","sourceRoot":"","sources":["../vitest.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,eAAe,YAAY,CAAC;IACxB,IAAI,EAAE;QACF,OAAO,EAAE,IAAI;QACb,WAAW,EAAE,MAAM;QACnB,OAAO,EAAE,CAAC,oBAAoB,EAAE,kCAAkC,CAAC;QACnE,KAAK,EAAE,KAAK;QACZ,QAAQ,EAAE;YACN,QAAQ,EAAE,IAAI;YACd,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;YAClC,UAAU,EAAE;gBACR,KAAK,EAAE,EAAE;gBACT,SAAS,EAAE,EAAE;gBACb,QAAQ,EAAE,EAAE;gBACZ,UAAU,EAAE,EAAE;aACjB;SACJ;KACJ;CACJ,CAAC,CAAC"}

package/docs/getting-started.md

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

package/docs/user/corporate-governance.md

@@ -0,0 +1,25 @@
+# 🏛️ 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/framework-mcp/dist/tools/dashboard/start_dashboard.js

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

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

@@ -12,6 +12,29 @@ export const TOOLS = [
             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.",
@@ -33,10 +56,34 @@ export const TOOLS = [
                 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.",
@@ -51,11 +98,82 @@ export const TOOLS = [
             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.",