agent-enderun 1.1.5 → 1.1.7

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

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

package/dist/tests/errors.test.js

@@ -0,0 +1,64 @@
+import { describe, it, expect } from "vitest";
+import { EnderunBaseError, ConfigurationError, ValidationError, AdapterError, OrchestrationError } from "../src/shared/errors.js";
+describe("Enderun Shared Errors", () => {
+    it("should instantiate EnderunBaseError with default values", () => {
+        const error = new EnderunBaseError("Something went wrong");
+        expect(error).toBeInstanceOf(Error);
+        expect(error).toBeInstanceOf(EnderunBaseError);
+        expect(error.name).toBe("EnderunBaseError");
+        expect(error.message).toBe("Something went wrong");
+        expect(error.code).toBe("ENDERUN_INTERNAL_ERROR");
+        expect(error.timestamp).toBeInstanceOf(Date);
+        expect(error.details).toBeUndefined();
+    });
+    it("should instantiate EnderunBaseError with custom code and details", () => {
+        const details = { foo: "bar" };
+        const error = new EnderunBaseError("Custom error message", "CUSTOM_CODE", details);
+        expect(error.code).toBe("CUSTOM_CODE");
+        expect(error.details).toEqual(details);
+    });
+    it("should serialize to JSON correctly", () => {
+        const details = { code: 500 };
+        const error = new EnderunBaseError("JSON serialization test", "SERIALIZE_CODE", details);
+        const json = error.toJSON();
+        expect(json.name).toBe("EnderunBaseError");
+        expect(json.message).toBe("JSON serialization test");
+        expect(json.code).toBe("SERIALIZE_CODE");
+        expect(json.timestamp).toBe(error.timestamp.toISOString());
+        expect(json.details).toEqual(details);
+        expect(json.stack).toBe(error.stack);
+    });
+    it("should instantiate ConfigurationError correctly", () => {
+        const error = new ConfigurationError("Invalid config file", { file: "config.json" });
+        expect(error).toBeInstanceOf(EnderunBaseError);
+        expect(error).toBeInstanceOf(ConfigurationError);
+        expect(error.code).toBe("CONFIGURATION_ERROR");
+        expect(error.message).toBe("Invalid config file");
+        expect(error.details).toEqual({ file: "config.json" });
+    });
+    it("should instantiate ValidationError correctly", () => {
+        const error = new ValidationError("Invalid username", { field: "username" });
+        expect(error).toBeInstanceOf(EnderunBaseError);
+        expect(error).toBeInstanceOf(ValidationError);
+        expect(error.code).toBe("VALIDATION_ERROR");
+        expect(error.message).toBe("Invalid username");
+        expect(error.details).toEqual({ field: "username" });
+    });
+    it("should instantiate AdapterError with formatted message", () => {
+        const error = new AdapterError("Connection timeout", "github-adapter", { host: "github.com" });
+        expect(error).toBeInstanceOf(EnderunBaseError);
+        expect(error).toBeInstanceOf(AdapterError);
+        expect(error.code).toBe("ADAPTER_ERROR");
+        expect(error.message).toBe("Adapter 'github-adapter' failure: Connection timeout");
+        expect(error.details).toEqual({ host: "github.com" });
+    });
+    it("should instantiate OrchestrationError correctly", () => {
+        const error = new OrchestrationError("Agent failed to respond", { agent: "coder" });
+        expect(error).toBeInstanceOf(EnderunBaseError);
+        expect(error).toBeInstanceOf(OrchestrationError);
+        expect(error.code).toBe("ORCHESTRATION_ERROR");
+        expect(error.message).toBe("Agent failed to respond");
+        expect(error.details).toEqual({ agent: "coder" });
+    });
+});
+//# sourceMappingURL=errors.test.js.map

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

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

package/dist/tests/fs-utils.test.d.ts

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

package/dist/tests/fs-utils.test.js

@@ -0,0 +1,101 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import fs from "fs";
+import path from "path";
+import { updateGitIgnore, collectFiles, computeTypesHash, copyDir } from "../src/cli/utils/fs.js";
+describe("FileSystem Utilities", () => {
+    const tempDir = path.join(process.cwd(), "tests", "temp-fs-test");
+    beforeEach(() => {
+        if (!fs.existsSync(tempDir)) {
+            fs.mkdirSync(tempDir, { recursive: true });
+        }
+    });
+    afterEach(() => {
+        if (fs.existsSync(tempDir)) {
+            fs.rmSync(tempDir, { recursive: true, force: true });
+        }
+    });
+    describe("updateGitIgnore", () => {
+        it("should create .gitignore and append all framework rules if file does not exist", () => {
+            const gitignorePath = path.join(tempDir, ".gitignore");
+            updateGitIgnore(gitignorePath, ".gemini", false);
+            expect(fs.existsSync(gitignorePath)).toBe(true);
+            const content = fs.readFileSync(gitignorePath, "utf8");
+            expect(content).toContain("# AI-Enderun");
+            expect(content).toContain(".gemini/logs/*.json");
+            expect(content).toContain(".gemini/memory/");
+        });
+        it("should not append duplicate lines to an existing .gitignore", () => {
+            const gitignorePath = path.join(tempDir, ".gitignore");
+            fs.writeFileSync(gitignorePath, "# AI-Enderun\n.gemini/logs/*.json\n");
+            updateGitIgnore(gitignorePath, ".gemini", false);
+            const content = fs.readFileSync(gitignorePath, "utf8");
+            // Count occurrences of '# AI-Enderun'
+            const occurrences = (content.match(/# AI-Enderun/g) || []).length;
+            expect(occurrences).toBe(1);
+            expect(content).toContain(".gemini/*.lock"); // Added missing one
+        });
+        it("should respect dryRun mode", () => {
+            const gitignorePath = path.join(tempDir, ".gitignore");
+            const consoleWarnSpy = vi.spyOn(console, "warn").mockImplementation(() => { });
+            updateGitIgnore(gitignorePath, ".gemini", true);
+            expect(fs.existsSync(gitignorePath)).toBe(false);
+            expect(consoleWarnSpy).toHaveBeenCalledWith(expect.stringContaining("Would update .gitignore"));
+            consoleWarnSpy.mockRestore();
+        });
+    });
+    describe("collectFiles", () => {
+        it("should return empty list if folder does not exist", () => {
+            const files = collectFiles(path.join(tempDir, "non-existent"), [".ts"]);
+            expect(files).toEqual([]);
+        });
+        it("should collect only files with matching extensions recursively", () => {
+            const subDir = path.join(tempDir, "sub");
+            fs.mkdirSync(subDir, { recursive: true });
+            fs.writeFileSync(path.join(tempDir, "file1.ts"), "typescript");
+            fs.writeFileSync(path.join(tempDir, "file2.js"), "javascript");
+            fs.writeFileSync(path.join(subDir, "file3.ts"), "typescript in sub");
+            // Dummy folders to check exclusion
+            const nodeModules = path.join(tempDir, "node_modules");
+            fs.mkdirSync(nodeModules, { recursive: true });
+            fs.writeFileSync(path.join(nodeModules, "ignored.ts"), "typescript in node_modules");
+            const files = collectFiles(tempDir, [".ts"]);
+            expect(files).toHaveLength(2);
+            expect(files.map(f => path.basename(f))).toContain("file1.ts");
+            expect(files.map(f => path.basename(f))).toContain("file3.ts");
+        });
+    });
+    describe("computeTypesHash", () => {
+        it("should generate deterministic sha256 hash for typescript files in a directory", () => {
+            const typesDir = path.join(tempDir, "types");
+            fs.mkdirSync(typesDir, { recursive: true });
+            fs.writeFileSync(path.join(typesDir, "a.ts"), "interface A {}");
+            fs.writeFileSync(path.join(typesDir, "b.ts"), "interface B {}");
+            const hash1 = computeTypesHash(tempDir, typesDir);
+            const hash2 = computeTypesHash(tempDir, typesDir);
+            expect(hash1).toBe(hash2);
+            expect(hash1).toHaveLength(64); // SHA-256 is 64 hex characters
+            // Modify a file, hash should change
+            fs.writeFileSync(path.join(typesDir, "a.ts"), "interface A { id: number; }");
+            const hash3 = computeTypesHash(tempDir, typesDir);
+            expect(hash1).not.toBe(hash3);
+        });
+    });
+    describe("copyDir", () => {
+        it("should recursively copy directory and remap folders based on adapter", () => {
+            const src = path.join(tempDir, "src");
+            const dest = path.join(tempDir, "dest");
+            fs.mkdirSync(path.join(src, "agents"), { recursive: true });
+            fs.mkdirSync(path.join(src, "knowledge"), { recursive: true });
+            fs.writeFileSync(path.join(src, "agents", "agent-spec.json"), JSON.stringify({ name: "spec" }));
+            fs.writeFileSync(path.join(src, "knowledge", "rules.md"), "# Rules");
+            const mockSanitizeJson = (obj) => obj;
+            // Test with antigravity-cli adapter
+            // agents -> skills, knowledge -> rules
+            copyDir(src, dest, new Set(), false, ".gemini", // NOT .enderun to enable remapping
+            "", mockSanitizeJson, "antigravity-cli", false);
+            expect(fs.existsSync(path.join(dest, "skills", "agent-spec.json"))).toBe(true);
+            expect(fs.existsSync(path.join(dest, "rules", "rules.md"))).toBe(true);
+        });
+    });
+});
+//# sourceMappingURL=fs-utils.test.js.map

package/dist/tests/fs-utils.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-utils.test.js","sourceRoot":"","sources":["../../tests/fs-utils.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACzE,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EACH,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,OAAO,EACV,MAAM,wBAAwB,CAAC;AAEhC,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IAClC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC;IAElE,UAAU,CAAC,GAAG,EAAE;QACZ,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YAC1B,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/C,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACX,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACzB,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACzD,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;QAC7B,EAAE,CAAC,gFAAgF,EAAE,GAAG,EAAE;YACtF,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;YAEvD,eAAe,CAAC,aAAa,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;YAEjD,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAChD,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;YACvD,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;YAC1C,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,qBAAqB,CAAC,CAAC;YACjD,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;QACjD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;YACnE,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;YACvD,EAAE,CAAC,aAAa,CAAC,aAAa,EAAE,qCAAqC,CAAC,CAAC;YAEvE,eAAe,CAAC,aAAa,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;YAEjD,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;YACvD,sCAAsC;YACtC,MAAM,WAAW,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;YAClE,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC5B,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC,CAAC,oBAAoB;QACrE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;YAClC,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;YACvD,MAAM,cAAc,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YAE9E,eAAe,CAAC,aAAa,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;YAEhD,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACjD,MAAM,CAAC,cAAc,CAAC,CAAC,oBAAoB,CAAC,MAAM,CAAC,gBAAgB,CAAC,yBAAyB,CAAC,CAAC,CAAC;YAChG,cAAc,CAAC,WAAW,EAAE,CAAC;QACjC,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;QAC1B,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;YACzD,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;YACxE,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC9B,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;YACtE,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YACzC,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAE1C,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,EAAE,YAAY,CAAC,CAAC;YAC/D,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,EAAE,YAAY,CAAC,CAAC;YAC/D,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,mBAAmB,CAAC,CAAC;YACrE,mCAAmC;YACnC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;YACvD,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC/C,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,EAAE,4BAA4B,CAAC,CAAC;YAErF,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;YAC7C,MAAM,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YAC9B,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;YAC/D,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QACnE,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;QAC9B,EAAE,CAAC,+EAA+E,EAAE,GAAG,EAAE;YACrF,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC7C,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAE5C,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,gBAAgB,CAAC,CAAC;YAChE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,gBAAgB,CAAC,CAAC;YAEhE,MAAM,KAAK,GAAG,gBAAgB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YAClD,MAAM,KAAK,GAAG,gBAAgB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YAElD,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC1B,MAAM,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,+BAA+B;YAE/D,oCAAoC;YACpC,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,6BAA6B,CAAC,CAAC;YAC7E,MAAM,KAAK,GAAG,gBAAgB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YAClD,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClC,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE;QACrB,EAAE,CAAC,sEAAsE,EAAE,GAAG,EAAE;YAC5E,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YACtC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACxC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC5D,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAE/D,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,iBAAiB,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;YAChG,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,EAAE,UAAU,CAAC,EAAE,SAAS,CAAC,CAAC;YAErE,MAAM,gBAAgB,GAAG,CAAC,GAAQ,EAAE,EAAE,CAAC,GAAG,CAAC;YAE3C,oCAAoC;YACpC,uCAAuC;YACvC,OAAO,CACH,GAAG,EACH,IAAI,EACJ,IAAI,GAAG,EAAE,EACT,KAAK,EACL,SAAS,EAAE,mCAAmC;YAC9C,EAAE,EACF,gBAAgB,EAChB,iBAAiB,EACjB,KAAK,CACR,CAAC;YAEF,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC/E,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3E,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

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

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

package/dist/tests/logger.test.js

@@ -0,0 +1,81 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import fs from "fs";
+import path from "path";
+import { logger, LogLevel, EnterpriseLogger } from "../src/shared/logger.js";
+describe("EnterpriseLogger", () => {
+    let stdoutWriteSpy;
+    let stderrWriteSpy;
+    const tempLogFile = path.join(process.cwd(), "tests", "temp-logger-test.log");
+    beforeEach(() => {
+        stdoutWriteSpy = vi.spyOn(process.stdout, "write").mockImplementation(() => true);
+        stderrWriteSpy = vi.spyOn(process.stderr, "write").mockImplementation(() => true);
+        // Reset configure defaults
+        logger.configure({
+            minLevel: LogLevel.DEBUG,
+            enableColors: false,
+            jsonFormat: false,
+            logFile: undefined
+        });
+    });
+    afterEach(() => {
+        stdoutWriteSpy.mockRestore();
+        stderrWriteSpy.mockRestore();
+        if (fs.existsSync(tempLogFile)) {
+            fs.unlinkSync(tempLogFile);
+        }
+    });
+    it("should be a singleton instance", () => {
+        const anotherInstance = EnterpriseLogger.getInstance();
+        expect(logger).toBe(anotherInstance);
+    });
+    it("should respect minLevel configuration", () => {
+        logger.configure({ minLevel: LogLevel.WARN });
+        logger.debug("Debug message");
+        logger.info("Info message");
+        logger.warn("Warn message");
+        expect(stdoutWriteSpy).toHaveBeenCalledTimes(1);
+        expect(stdoutWriteSpy.mock.calls[0][0]).toContain("[WARN ]");
+    });
+    it("should write normal levels (DEBUG, INFO, WARN) to stdout", () => {
+        logger.debug("Debug message");
+        logger.info("Info message");
+        logger.warn("Warn message");
+        expect(stdoutWriteSpy).toHaveBeenCalledTimes(3);
+        expect(stderrWriteSpy).not.toHaveBeenCalled();
+    });
+    it("should write ERROR and FATAL levels to stderr", () => {
+        logger.error("Error message");
+        logger.fatal("Fatal message");
+        expect(stderrWriteSpy).toHaveBeenCalledTimes(2);
+        expect(stdoutWriteSpy).not.toHaveBeenCalled();
+        expect(stderrWriteSpy.mock.calls[0][0]).toContain("[ERROR]");
+        expect(stderrWriteSpy.mock.calls[1][0]).toContain("[FATAL]");
+    });
+    it("should output JSON format when configured", () => {
+        logger.configure({ jsonFormat: true });
+        logger.info("Hello JSON", { userId: 123 });
+        expect(stdoutWriteSpy).toHaveBeenCalledTimes(1);
+        const logContent = stdoutWriteSpy.mock.calls[0][0].trim();
+        const parsed = JSON.parse(logContent);
+        expect(parsed.level).toBe("INFO");
+        expect(parsed.message).toBe("Hello JSON");
+        expect(parsed.meta).toEqual({ userId: 123 });
+        expect(parsed.timestamp).toBeDefined();
+        expect(parsed.pid).toBe(process.pid);
+    });
+    it("should write to file when logFile is configured", () => {
+        logger.configure({ logFile: tempLogFile });
+        logger.info("File log message");
+        expect(fs.existsSync(tempLogFile)).toBe(true);
+        const fileContent = fs.readFileSync(tempLogFile, "utf8");
+        expect(fileContent).toContain("[INFO ]");
+        expect(fileContent).toContain("File log message");
+    });
+    it("should handle error when log directory fails to be created", () => {
+        const invalidLogPath = "/root/invalid-path/test.log";
+        logger.configure({ logFile: invalidLogPath });
+        expect(stderrWriteSpy).toHaveBeenCalled();
+        expect(stderrWriteSpy.mock.calls[0][0]).toContain("[Logger] Failed to create log directory");
+    });
+});
+//# sourceMappingURL=logger.test.js.map

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

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

package/dist/tests/memory-utils.test.d.ts

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

package/dist/tests/memory-utils.test.js

@@ -0,0 +1,173 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import fs from "fs";
+import path from "path";
+describe("Memory Utilities", () => {
+    const tempDir = path.join(process.cwd(), "tests", "temp-memory-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 });
+        }
+    });
+    describe("Framework Directories", () => {
+        it("should fallback to .gemini directory if no config is found", async () => {
+            const { getLocalFrameworkDir } = await import("../src/cli/utils/memory.js");
+            const frameworkDir = getLocalFrameworkDir();
+            expect(frameworkDir).toBe(path.join(tempDir, ".gemini"));
+        });
+        it("should read custom frameworkDir from package.json if configured", async () => {
+            // Write mock package.json
+            const pkg = {
+                enderun: {
+                    frameworkDir: ".custom-enderun"
+                }
+            };
+            fs.writeFileSync(path.join(tempDir, "package.json"), JSON.stringify(pkg));
+            // Create the custom directory
+            fs.mkdirSync(path.join(tempDir, ".custom-enderun"), { recursive: true });
+            const { getLocalFrameworkDir } = await import("../src/cli/utils/memory.js");
+            const frameworkDir = getLocalFrameworkDir();
+            expect(frameworkDir).toBe(path.join(tempDir, ".custom-enderun"));
+        });
+    });
+    describe("getConfiguredPaths", () => {
+        it("should return default paths if config.json does not exist", async () => {
+            const { getConfiguredPaths } = await import("../src/cli/utils/memory.js");
+            const paths = getConfiguredPaths();
+            expect(paths).toEqual({
+                backend: "apps/backend",
+                frontend: "apps/web",
+                docs: "docs",
+                tests: "tests"
+            });
+        });
+        it("should return paths from config.json if schema matches", async () => {
+            const frameworkDir = path.join(tempDir, ".gemini");
+            fs.mkdirSync(frameworkDir, { recursive: true });
+            const configData = {
+                version: "1.0.0",
+                paths: {
+                    backend: "src/api",
+                    frontend: "src/ui",
+                    docs: "wiki",
+                    tests: "specs"
+                }
+            };
+            fs.writeFileSync(path.join(frameworkDir, "config.json"), JSON.stringify(configData));
+            const { getConfiguredPaths } = await import("../src/cli/utils/memory.js");
+            const paths = getConfiguredPaths();
+            expect(paths).toEqual(configData.paths);
+        });
+        it("should return defaults and log error if config.json schema is invalid", async () => {
+            const frameworkDir = path.join(tempDir, ".gemini");
+            fs.mkdirSync(frameworkDir, { recursive: true });
+            const consoleErrorSpy = vi.spyOn(console, "error").mockImplementation(() => { });
+            // Missing paths
+            const configData = {
+                version: "1.0.0"
+            };
+            fs.writeFileSync(path.join(frameworkDir, "config.json"), JSON.stringify(configData));
+            const { getConfiguredPaths } = await import("../src/cli/utils/memory.js");
+            const paths = getConfiguredPaths();
+            expect(paths).toEqual({
+                backend: "apps/backend",
+                frontend: "apps/web",
+                docs: "docs",
+                tests: "tests"
+            });
+            expect(consoleErrorSpy).toHaveBeenCalled();
+            consoleErrorSpy.mockRestore();
+        });
+    });
+    describe("Memory Lock", () => {
+        it("should acquire and release lock successfully", async () => {
+            const { acquireMemoryLock, releaseMemoryLock } = await import("../src/cli/utils/memory.js");
+            const lockFile = path.join(tempDir, "memory.lock");
+            const locked = acquireMemoryLock(lockFile);
+            expect(locked).toBe(true);
+            expect(fs.existsSync(lockFile)).toBe(true);
+            releaseMemoryLock(lockFile);
+            expect(fs.existsSync(lockFile)).toBe(false);
+        });
+        it("should break stale lock if age is greater than 10 seconds", async () => {
+            const { acquireMemoryLock } = await import("../src/cli/utils/memory.js");
+            const lockFile = path.join(tempDir, "memory.lock");
+            // Manually write lock file and backdate its modified time
+            fs.writeFileSync(lockFile, "locked");
+            const pastTime = (Date.now() - 15000) / 1000; // 15 seconds ago
+            fs.utimesSync(lockFile, pastTime, pastTime);
+            const consoleWarnSpy = vi.spyOn(console, "warn").mockImplementation(() => { });
+            // Should detect stale and break lock
+            const locked = acquireMemoryLock(lockFile);
+            expect(locked).toBe(true);
+            expect(consoleWarnSpy).toHaveBeenCalledWith(expect.stringContaining("Stale memory lock detected"));
+            consoleWarnSpy.mockRestore();
+        });
+    });
+    describe("initializeMemory", () => {
+        it("should create PROJECT_MEMORY.md and DECISIONS.md with default templates", async () => {
+            const { initializeMemory } = await import("../src/cli/utils/memory.js");
+            const memoryPath = path.join(tempDir, "PROJECT_MEMORY.md");
+            const consoleWarnSpy = vi.spyOn(console, "warn").mockImplementation(() => { });
+            initializeMemory(memoryPath, tempDir, false);
+            expect(fs.existsSync(memoryPath)).toBe(true);
+            expect(fs.existsSync(path.join(tempDir, "DECISIONS.md"))).toBe(true);
+            const memoryContent = fs.readFileSync(memoryPath, "utf8");
+            expect(memoryContent).toContain("## CURRENT STATUS");
+            expect(memoryContent).toContain("## HISTORY");
+            expect(memoryContent).toContain("Initialization");
+            consoleWarnSpy.mockRestore();
+        });
+    });
+    describe("updateProjectMemory and readActiveTraceId", () => {
+        it("should parse Trace ID in various formats", async () => {
+            const { readActiveTraceId } = await import("../src/cli/utils/memory.js");
+            const format1 = "## CURRENT STATUS\n- Phase: Genesis\n- Trace ID: 01HY7Y2A00ABC\n";
+            expect(readActiveTraceId(format1)).toBe("01HY7Y2A00ABC");
+            const format2 = "| Trace ID | Priority | Status |\n|---|---|---|\n| 01HY7Y2A00XYZ | P0 | APPROVED |\n";
+            expect(readActiveTraceId(format2)).toBe("01HY7Y2A00XYZ");
+            const format3 = "Active Trace ID: 01HY7Y2A00QWE";
+            expect(readActiveTraceId(format3)).toBe("01HY7Y2A00QWE");
+        });
+        it("should append content to HISTORY section and support auto-pruning", async () => {
+            const frameworkDir = path.join(tempDir, ".gemini");
+            fs.mkdirSync(frameworkDir, { recursive: true });
+            const memoryPath = path.join(frameworkDir, "PROJECT_MEMORY.md");
+            // Set mock getMemoryPath output by setting the structure
+            const template = "## CURRENT STATUS\n- Phase: 0\n- Trace ID: 123\n\n## HISTORY\n### 2024-06-01 — Entry 1\n- First log\n";
+            fs.writeFileSync(memoryPath, template);
+            const { updateProjectMemory } = await import("../src/cli/utils/memory.js");
+            const consoleWarnSpy = vi.spyOn(console, "warn").mockImplementation(() => { });
+            updateProjectMemory("HISTORY", "### 2024-06-02 — Entry 2\n- Second log");
+            const updatedContent = fs.readFileSync(memoryPath, "utf8");
+            expect(updatedContent).toContain("Entry 2");
+            expect(updatedContent).toContain("Entry 1");
+            // Test auto-pruning by adding 11 entries
+            let pruneTemplate = "## CURRENT STATUS\n- Phase: 0\n- Trace ID: 123\n\n## HISTORY\n";
+            for (let i = 1; i <= 12; i++) {
+                pruneTemplate += `### 2024-06-01 — Entry ${i}\n- Entry ${i} detail\n`;
+            }
+            fs.writeFileSync(memoryPath, pruneTemplate);
+            updateProjectMemory("HISTORY", "### 2024-06-02 — Entry New\n- New entry detail");
+            const prunedContent = fs.readFileSync(memoryPath, "utf8");
+            // Should keep the newest entries (including the new one) and prune the oldest
+            expect(prunedContent).toContain("Entry New");
+            expect(prunedContent).toContain("Entry 1"); // First 10 items preserved
+            // Check if archive folder is created and contains the pruned history
+            const archiveDir = path.join(frameworkDir, "archive/history");
+            expect(fs.existsSync(archiveDir)).toBe(true);
+            const archiveFiles = fs.readdirSync(archiveDir);
+            expect(archiveFiles.length).toBe(1);
+            consoleWarnSpy.mockRestore();
+        });
+    });
+});
+//# sourceMappingURL=memory-utils.test.js.map

package/dist/tests/memory-utils.test.js.map

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

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

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

package/dist/tests/orchestrate.test.js

@@ -0,0 +1,131 @@
+import { describe, it, expect, beforeEach, afterEach, vi } from "vitest";
+import fs from "fs";
+import path from "path";
+import { sendMessage, HermesMessageSchema, orchestrateCommand } from "../src/cli/commands/orchestrate.js";
+// Mock the getFrameworkDir utility to return our test sandbox folder
+vi.mock("../utils/memory.js", () => {
+    return {
+        getFrameworkDir: () => path.join(process.cwd(), "tests/mock-workspace"),
+        getMemoryPath: () => path.join(process.cwd(), "tests/mock-workspace/memory.json"),
+        getConfiguredPaths: () => ({
+            backend: "backend",
+            frontend: "frontend",
+            docs: "docs"
+        })
+    };
+});
+describe("Hermes Message Protocol & Orchestration", () => {
+    const testDir = path.join(process.cwd(), "tests/mock-workspace");
+    const messagesDir = path.join(testDir, "messages");
+    const statusPath = path.join(testDir, "STATUS.md");
+    const auditPath = path.join(testDir, "observability/audit_log.md");
+    beforeEach(() => {
+        // Create test sandbox directory structure
+        fs.mkdirSync(testDir, { recursive: true });
+        fs.mkdirSync(messagesDir, { recursive: true });
+        fs.mkdirSync(path.join(testDir, "observability"), { recursive: true });
+        // Write mock STATUS.md table
+        fs.writeFileSync(statusPath, [
+            "# Agent Status Registry",
+            "",
+            "| Agent | Status | Active Task | Last Updated |",
+            "|---|---|---|---|",
+            "| @manager | IDLE | - | - |",
+            "| @backend | IDLE | - | - |",
+            "| @frontend | EXECUTING | Building dashboard | 2026-06-07T00:00:00.000Z |",
+        ].join("\n"));
+        // Write empty audit log
+        fs.writeFileSync(auditPath, "# Audit Log\n");
+    });
+    afterEach(() => {
+        // Clean up test sandbox
+        try {
+            fs.rmSync(testDir, { recursive: true, force: true });
+        }
+        catch {
+            // Ignore clean up errors
+        }
+    });
+    it("should validate valid Hermes messages", () => {
+        const validMsg = {
+            timestamp: new Date().toISOString(),
+            from: "@manager",
+            to: "@backend",
+            category: "DELEGATION",
+            content: "Please generate Fastify types.",
+            traceId: "test-trace-id",
+            status: "PENDING",
+            priority: "HIGH"
+        };
+        const result = HermesMessageSchema.safeParse(validMsg);
+        expect(result.success).toBe(true);
+    });
+    it("should fail validation on invalid Hermes messages", () => {
+        const invalidMsg = {
+            timestamp: "not-a-date",
+            from: "@manager",
+            // missing 'to' field
+            category: "INVALID_CAT", // invalid enum
+            content: "",
+            traceId: "trace"
+        };
+        const result = HermesMessageSchema.safeParse(invalidMsg);
+        expect(result.success).toBe(false);
+    });
+    it("should write messages to appropriate files and release lock", async () => {
+        const messageArgs = {
+            from: "@manager",
+            to: "@backend",
+            category: "DELEGATION",
+            content: "Create backend structures",
+            traceId: "trace-1"
+        };
+        const result = await sendMessage(messageArgs);
+        expect(result).toBeDefined();
+        expect(result?.status).toBe("PENDING");
+        // Verify file was written
+        const mailboxFile = path.join(messagesDir, "backend.json");
+        expect(fs.existsSync(mailboxFile)).toBe(true);
+        const content = fs.readFileSync(mailboxFile, "utf8");
+        const parsed = JSON.parse(content.trim());
+        expect(parsed.traceId).toBe("trace-1");
+        expect(parsed.from).toBe("@manager");
+        // Verify lock file was released/removed
+        const lockFile = path.join(messagesDir, ".lock");
+        expect(fs.existsSync(lockFile)).toBe(false);
+    });
+    it("should handle concurrency using mutex lock files", async () => {
+        const lockFile = path.join(messagesDir, ".lock");
+        fs.writeFileSync(lockFile, "Manually locked");
+        const messageArgs = {
+            from: "@manager",
+            to: "@backend",
+            category: "DELEGATION",
+            content: "Conflict test",
+            traceId: "trace-2"
+        };
+        // This should fail to acquire lock and output UI warning/error
+        const result = await sendMessage(messageArgs);
+        expect(result).toBeUndefined(); // Message could not be sent since lock was busy
+    });
+    it("should detect executing agent timeouts and transition them to BLOCKED", async () => {
+        // Overwrite status to contain a timed-out agent (last updated 1 hour ago)
+        const pastTime = new Date(Date.now() - 60 * 60 * 1000).toISOString();
+        fs.writeFileSync(statusPath, [
+            "# Agent Status Registry",
+            "",
+            "| Agent | Status | Active Task | Last Updated |",
+            "|---|---|---|---|",
+            "| @frontend | EXECUTING | Building dashboard | " + pastTime + " |",
+        ].join("\n"));
+        // Run orchestration loop
+        await orchestrateCommand();
+        // Check if agent status transitioned to BLOCKED in STATUS.md
+        const statusContent = fs.readFileSync(statusPath, "utf8");
+        expect(statusContent).toContain("| @frontend | BLOCKED | Timeout occurred |");
+        // Check if audit log recorded the timeout
+        const auditContent = fs.readFileSync(auditPath, "utf8");
+        expect(auditContent).toContain("status auto-escalated to BLOCKED");
+    });
+});
+//# sourceMappingURL=orchestrate.test.js.map

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

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

package/dist/tests/skills-definitions.test.d.ts

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