agent-enderun 1.1.4 → 1.1.5

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

@@ -5,28 +5,67 @@
 export const CORE_SKILLS = {
     FILE_SYSTEM: {
         name: "File System Mastery",
-        tools: ["view_file", "list_dir", "glob"],
-        mandates: ["Enforce surgical edits only.", "No destructive deletes without backup."]
+        tools: ["read_file", "write_file"],
+        description: "Enables reading and writing files in the workspace with token efficiency.",
+        mandates: [
+            "- **Token Efficiency:** When reading large files, always specify `startLine` and `endLine` to avoid loading the entire file content into context.",
+            "- **Surgical Changes:** Avoid overwriting entire files for small updates; prefer surgical edit tools."
+        ]
     },
     EDITING: {
         name: "Surgical Code Modification",
         tools: ["replace_text", "patch_file"],
-        mandates: ["replace_text is mandatory for all source code."]
+        description: "Enables surgical, precise edits to source code files without overwriting the entire content.",
+        mandates: [
+            "- **Precise Selection:** Ensure `oldText` matches the target string exactly, including all whitespace and indentation.",
+            "- **Line-based Replacement:** Use `patch_file` for multi-line block updates, specifying exact 1-indexed start and end lines."
+        ]
     },
     ORCHESTRATION: {
-        name: "Hermes Orchestration",
-        tools: ["orchestrate_loop", "send_agent_message", "status_check"],
-        mandates: ["Maintain PROJECT_MEMORY.md at each turn."]
+        name: "Hermes Orchestration & Messaging",
+        tools: ["orchestrate_loop", "send_agent_message", "get_framework_status", "log_agent_action"],
+        description: "Governs inter-agent message passing, task delegation, and execution logs using the Hermes Message Broker.",
+        mandates: [
+            "- **Traceability:** Always include the active `traceId` in all messages and action logs.",
+            "- **Action Logs:** Log critical operations with `log_agent_action` to ensure transparency and accountability.",
+            "- **Message Loops:** Run `orchestrate_loop` to process queued messages and trigger state transitions."
+        ]
     },
-    EXECUTION: {
-        name: "Secure Shell Execution",
-        tools: ["run_shell_command"],
-        mandates: ["Avoid destructive root commands.", "Always prefer quiet/silent flags."]
+    GOVERNANCE: {
+        name: "Control Plane Governance & Locking",
+        tools: ["acquire_lock", "release_lock", "register_agent", "update_contract_hash"],
+        description: "Governs access control, resource locking, type contract validation, and agent registration.",
+        mandates: [
+            "- **Locking Protocol:** Always acquire a lock via `acquire_lock` on shared resources (like memory files) before editing, and release it immediately after writing.",
+            "- **Contract Enforcement:** Run `update_contract_hash` to re-sync backend types and check for breaking API changes."
+        ]
     },
-    DISCOVERY: {
-        name: "Codebase Discovery",
-        tools: ["grep_search", "glob", "view_file"],
-        mandates: ["Map dependencies before proposing changes."]
+    QUALITY_ASSURANCE: {
+        name: "Quality Assurance & Testing",
+        tools: ["run_shell_command", "view_file"],
+        description: "Enforces testing coverage standards, code style compliance, and runs test suites.",
+        mandates: [
+            "- **Zero-Mock Policy:** Integration tests must use real test database connections or service-compatible backends; do not rely on fake mocks.",
+            "- **Coverage Standards:** Ensure new code meets the 80% test coverage threshold before transitioning to release phases."
+        ]
+    },
+    DATABASE_MANAGEMENT: {
+        name: "Database Management & Migrations",
+        tools: ["view_file", "replace_text", "run_shell_command"],
+        description: "Handles database migrations, schema design, and query optimization.",
+        mandates: [
+            "- **No Direct DB Calls in Controllers:** Database operations must be isolated inside repository or service files; controllers must never perform raw DB calls.",
+            "- **No Raw SQL Strings:** Do not write raw SQL query strings; strictly use type-safe query builders like Kysely."
+        ]
+    },
+    DEVOPS_INFRASTRUCTURE: {
+        name: "DevOps & Infrastructure",
+        tools: ["run_shell_command", "view_file"],
+        description: "Manages CI/CD pipelines, container configurations, env files, and deployments.",
+        mandates: [
+            "- **No Hardcoded Secrets:** Never embed API keys, secrets, or passwords inside configuration files or codebases.",
+            "- **Immutable Deploys:** Ensure build steps compile production bundles successfully without configuration side-effects."
+        ]
     }
 };
 //# sourceMappingURL=definitions.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../../../src/modules/skills/definitions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG;IACvB,WAAW,EAAE;QACT,IAAI,EAAE,qBAAqB;QAC3B,KAAK,EAAE,CAAC,WAAW,EAAE,UAAU,EAAE,MAAM,CAAC;QACxC,QAAQ,EAAE,CAAC,8BAA8B,EAAE,wCAAwC,CAAC;KACvF;IACD,OAAO,EAAE;QACL,IAAI,EAAE,4BAA4B;QAClC,KAAK,EAAE,CAAC,cAAc,EAAE,YAAY,CAAC;QACrC,QAAQ,EAAE,CAAC,gDAAgD,CAAC;KAC/D;IACD,aAAa,EAAE;QACX,IAAI,EAAE,sBAAsB;QAC5B,KAAK,EAAE,CAAC,kBAAkB,EAAE,oBAAoB,EAAE,cAAc,CAAC;QACjE,QAAQ,EAAE,CAAC,0CAA0C,CAAC;KACzD;IACD,SAAS,EAAE;QACP,IAAI,EAAE,wBAAwB;QAC9B,KAAK,EAAE,CAAC,mBAAmB,CAAC;QAC5B,QAAQ,EAAE,CAAC,kCAAkC,EAAE,mCAAmC,CAAC;KACtF;IACD,SAAS,EAAE;QACP,IAAI,EAAE,oBAAoB;QAC1B,KAAK,EAAE,CAAC,aAAa,EAAE,MAAM,EAAE,WAAW,CAAC;QAC3C,QAAQ,EAAE,CAAC,4CAA4C,CAAC;KAC3D;CACJ,CAAC"}
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../../../src/modules/skills/definitions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG;IACvB,WAAW,EAAE;QACT,IAAI,EAAE,qBAAqB;QAC3B,KAAK,EAAE,CAAC,WAAW,EAAE,YAAY,CAAC;QAClC,WAAW,EAAE,2EAA2E;QACxF,QAAQ,EAAE;YACN,mJAAmJ;YACnJ,uGAAuG;SAC1G;KACJ;IACD,OAAO,EAAE;QACL,IAAI,EAAE,4BAA4B;QAClC,KAAK,EAAE,CAAC,cAAc,EAAE,YAAY,CAAC;QACrC,WAAW,EAAE,8FAA8F;QAC3G,QAAQ,EAAE;YACN,wHAAwH;YACxH,8HAA8H;SACjI;KACJ;IACD,aAAa,EAAE;QACX,IAAI,EAAE,kCAAkC;QACxC,KAAK,EAAE,CAAC,kBAAkB,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,kBAAkB,CAAC;QAC7F,WAAW,EAAE,2GAA2G;QACxH,QAAQ,EAAE;YACN,0FAA0F;YAC1F,+GAA+G;YAC/G,uGAAuG;SAC1G;KACJ;IACD,UAAU,EAAE;QACR,IAAI,EAAE,oCAAoC;QAC1C,KAAK,EAAE,CAAC,cAAc,EAAE,cAAc,EAAE,gBAAgB,EAAE,sBAAsB,CAAC;QACjF,WAAW,EAAE,6FAA6F;QAC1G,QAAQ,EAAE;YACN,oKAAoK;YACpK,qHAAqH;SACxH;KACJ;IACD,iBAAiB,EAAE;QACf,IAAI,EAAE,6BAA6B;QACnC,KAAK,EAAE,CAAC,mBAAmB,EAAE,WAAW,CAAC;QACzC,WAAW,EAAE,mFAAmF;QAChG,QAAQ,EAAE;YACN,8IAA8I;YAC9I,yHAAyH;SAC5H;KACJ;IACD,mBAAmB,EAAE;QACjB,IAAI,EAAE,kCAAkC;QACxC,KAAK,EAAE,CAAC,WAAW,EAAE,cAAc,EAAE,mBAAmB,CAAC;QACzD,WAAW,EAAE,qEAAqE;QAClF,QAAQ,EAAE;YACN,gKAAgK;YAChK,kHAAkH;SACrH;KACJ;IACD,qBAAqB,EAAE;QACnB,IAAI,EAAE,yBAAyB;QAC/B,KAAK,EAAE,CAAC,mBAAmB,EAAE,WAAW,CAAC;QACzC,WAAW,EAAE,gFAAgF;QAC7F,QAAQ,EAAE;YACN,kHAAkH;YAClH,yHAAyH;SAC5H;KACJ;CACJ,CAAC"}

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

@@ -0,0 +1,41 @@
+import { z } from "zod";
+declare const ConfigSchema: z.ZodObject<{
+    nodeEnv: z.ZodDefault<z.ZodEnum<["development", "production", "test"]>>;
+    logLevel: z.ZodDefault<z.ZodEnum<["DEBUG", "INFO", "WARN", "ERROR", "FATAL"]>>;
+    projectRoot: z.ZodDefault<z.ZodString>;
+    skipInstall: z.ZodDefault<z.ZodBoolean>;
+    mcpServerPort: z.ZodEffects<z.ZodOptional<z.ZodNumber>, number | undefined, unknown>;
+}, "strip", z.ZodTypeAny, {
+    nodeEnv: "test" | "production" | "development";
+    logLevel: "DEBUG" | "INFO" | "WARN" | "ERROR" | "FATAL";
+    projectRoot: string;
+    skipInstall: boolean;
+    mcpServerPort?: number | undefined;
+}, {
+    nodeEnv?: "test" | "production" | "development" | undefined;
+    logLevel?: "DEBUG" | "INFO" | "WARN" | "ERROR" | "FATAL" | undefined;
+    projectRoot?: string | undefined;
+    skipInstall?: boolean | undefined;
+    mcpServerPort?: unknown;
+}>;
+export type AppConfig = z.infer<typeof ConfigSchema>;
+declare class ConfigurationManager {
+    private static instance;
+    private config;
+    private constructor();
+    static getInstance(): ConfigurationManager;
+    private load;
+    /**
+     * Gets the read-only, validated system configuration object.
+     */
+    get(): AppConfig;
+}
+export declare const configManager: ConfigurationManager;
+export declare const currentConfig: {
+    nodeEnv: "test" | "production" | "development";
+    logLevel: "DEBUG" | "INFO" | "WARN" | "ERROR" | "FATAL";
+    projectRoot: string;
+    skipInstall: boolean;
+    mcpServerPort?: number | undefined;
+};
+export {};

package/dist/src/shared/config.js

@@ -0,0 +1,61 @@
+import { z } from "zod";
+import { ConfigurationError } from "./errors.js";
+// Define the schema for framework configuration
+const ConfigSchema = z.object({
+    nodeEnv: z.enum(["development", "production", "test"]).default("development"),
+    logLevel: z.enum(["DEBUG", "INFO", "WARN", "ERROR", "FATAL"]).default("INFO"),
+    projectRoot: z.string().default(process.cwd()),
+    skipInstall: z.boolean().default(false),
+    mcpServerPort: z.preprocess((val) => {
+        if (typeof val === "string") {
+            const parsed = parseInt(val, 10);
+            return isNaN(parsed) ? undefined : parsed;
+        }
+        return val;
+    }, z.number().int().min(1024).max(65535).optional()),
+});
+class ConfigurationManager {
+    static instance;
+    config;
+    constructor() {
+        this.load();
+    }
+    static getInstance() {
+        if (!ConfigurationManager.instance) {
+            ConfigurationManager.instance = new ConfigurationManager();
+        }
+        return ConfigurationManager.instance;
+    }
+    load() {
+        try {
+            const rawConfig = {
+                nodeEnv: process.env.NODE_ENV,
+                logLevel: process.env.LOG_LEVEL || (process.env.NODE_ENV === "production" ? "INFO" : "DEBUG"),
+                projectRoot: process.env.ENDERUN_PROJECT_ROOT || process.cwd(),
+                skipInstall: process.env.ENDERUN_SKIP_INSTALL === "1" || process.env.ENDERUN_SKIP_INSTALL === "true",
+                mcpServerPort: process.env.MCP_SERVER_PORT,
+            };
+            const parsed = ConfigSchema.safeParse(rawConfig);
+            if (!parsed.success) {
+                throw new ConfigurationError("Failed to validate environment configuration parameters", parsed.error.format());
+            }
+            // Freeze the configuration to prevent modifications at runtime
+            this.config = Object.freeze(parsed.data);
+        }
+        catch (err) {
+            if (err instanceof ConfigurationError) {
+                throw err;
+            }
+            throw new ConfigurationError(`Failed to load system configuration: ${err}`);
+        }
+    }
+    /**
+     * Gets the read-only, validated system configuration object.
+     */
+    get() {
+        return this.config;
+    }
+}
+export const configManager = ConfigurationManager.getInstance();
+export const currentConfig = configManager.get();
+//# sourceMappingURL=config.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/shared/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,gDAAgD;AAChD,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1B,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC;IAC7E,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IAC7E,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;IAC9C,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACvC,aAAa,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,GAAG,EAAE,EAAE;QAChC,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC1B,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YACjC,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;QAC9C,CAAC;QACD,OAAO,GAAG,CAAC;IACf,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC;CACvD,CAAC,CAAC;AAIH,MAAM,oBAAoB;IACd,MAAM,CAAC,QAAQ,CAAuB;IACtC,MAAM,CAAa;IAE3B;QACI,IAAI,CAAC,IAAI,EAAE,CAAC;IAChB,CAAC;IAEM,MAAM,CAAC,WAAW;QACrB,IAAI,CAAC,oBAAoB,CAAC,QAAQ,EAAE,CAAC;YACjC,oBAAoB,CAAC,QAAQ,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC/D,CAAC;QACD,OAAO,oBAAoB,CAAC,QAAQ,CAAC;IACzC,CAAC;IAEO,IAAI;QACR,IAAI,CAAC;YACD,MAAM,SAAS,GAAG;gBACd,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ;gBAC7B,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;gBAC7F,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,OAAO,CAAC,GAAG,EAAE;gBAC9D,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,KAAK,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,oBAAoB,KAAK,MAAM;gBACpG,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe;aAC7C,CAAC;YAEF,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;YACjD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBAClB,MAAM,IAAI,kBAAkB,CACxB,yDAAyD,EACzD,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,CACxB,CAAC;YACN,CAAC;YAED,+DAA+D;YAC/D,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC7C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,IAAI,GAAG,YAAY,kBAAkB,EAAE,CAAC;gBACpC,MAAM,GAAG,CAAC;YACd,CAAC;YACD,MAAM,IAAI,kBAAkB,CAAC,wCAAwC,GAAG,EAAE,CAAC,CAAC;QAChF,CAAC;IACL,CAAC;IAED;;OAEG;IACI,GAAG;QACN,OAAO,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;CACJ;AAED,MAAM,CAAC,MAAM,aAAa,GAAG,oBAAoB,CAAC,WAAW,EAAE,CAAC;AAChE,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAAC,GAAG,EAAE,CAAC"}

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

@@ -0,0 +1,25 @@
+export type FactoryFunction<T> = (container: ServiceContainer) => T;
+export declare class ServiceContainer {
+    private static instance;
+    private services;
+    private factories;
+    private constructor();
+    static getInstance(): ServiceContainer;
+    /**
+     * Registers a pre-instantiated singleton service.
+     */
+    register<T>(name: string, service: T): void;
+    /**
+     * Registers a factory function for lazy evaluation.
+     */
+    registerFactory<T>(name: string, factory: FactoryFunction<T>): void;
+    /**
+     * Resolves the requested service.
+     */
+    resolve<T>(name: string): T;
+    /**
+     * Resets the container. Useful for test environments.
+     */
+    reset(): void;
+}
+export declare const container: ServiceContainer;

package/dist/src/shared/container.js

@@ -0,0 +1,56 @@
+import { ValidationError } from "./errors.js";
+export class ServiceContainer {
+    static instance;
+    services = new Map();
+    factories = new Map();
+    constructor() { }
+    static getInstance() {
+        if (!ServiceContainer.instance) {
+            ServiceContainer.instance = new ServiceContainer();
+        }
+        return ServiceContainer.instance;
+    }
+    /**
+     * Registers a pre-instantiated singleton service.
+     */
+    register(name, service) {
+        if (this.services.has(name)) {
+            throw new ValidationError(`Service '${name}' is already registered.`);
+        }
+        this.services.set(name, service);
+    }
+    /**
+     * Registers a factory function for lazy evaluation.
+     */
+    registerFactory(name, factory) {
+        if (this.factories.has(name) || this.services.has(name)) {
+            throw new ValidationError(`Service or factory '${name}' is already registered.`);
+        }
+        this.factories.set(name, factory);
+    }
+    /**
+     * Resolves the requested service.
+     */
+    resolve(name) {
+        if (this.services.has(name)) {
+            return this.services.get(name);
+        }
+        if (this.factories.has(name)) {
+            const factory = this.factories.get(name);
+            const service = factory(this);
+            this.services.set(name, service); // Cache it as a singleton
+            this.factories.delete(name);
+            return service;
+        }
+        throw new ValidationError(`Dependency resolution failed: Service '${name}' not found in container.`);
+    }
+    /**
+     * Resets the container. Useful for test environments.
+     */
+    reset() {
+        this.services.clear();
+        this.factories.clear();
+    }
+}
+export const container = ServiceContainer.getInstance();
+//# sourceMappingURL=container.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"container.js","sourceRoot":"","sources":["../../../src/shared/container.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAI9C,MAAM,OAAO,gBAAgB;IACjB,MAAM,CAAC,QAAQ,CAAmB;IAClC,QAAQ,GAAyB,IAAI,GAAG,EAAE,CAAC;IAC3C,SAAS,GAA0C,IAAI,GAAG,EAAE,CAAC;IAErE,gBAAuB,CAAC;IAEjB,MAAM,CAAC,WAAW;QACrB,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,CAAC;YAC7B,gBAAgB,CAAC,QAAQ,GAAG,IAAI,gBAAgB,EAAE,CAAC;QACvD,CAAC;QACD,OAAO,gBAAgB,CAAC,QAAQ,CAAC;IACrC,CAAC;IAED;;OAEG;IACI,QAAQ,CAAI,IAAY,EAAE,OAAU;QACvC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,eAAe,CAAC,YAAY,IAAI,0BAA0B,CAAC,CAAC;QAC1E,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACrC,CAAC;IAED;;OAEG;IACI,eAAe,CAAI,IAAY,EAAE,OAA2B;QAC/D,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACtD,MAAM,IAAI,eAAe,CAAC,uBAAuB,IAAI,0BAA0B,CAAC,CAAC;QACrF,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IAED;;OAEG;IACI,OAAO,CAAI,IAAY;QAC1B,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAM,CAAC;QACxC,CAAC;QAED,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAuB,CAAC;YAC/D,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;YAC9B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,0BAA0B;YAC5D,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC5B,OAAO,OAAO,CAAC;QACnB,CAAC;QAED,MAAM,IAAI,eAAe,CAAC,0CAA0C,IAAI,2BAA2B,CAAC,CAAC;IACzG,CAAC;IAED;;OAEG;IACI,KAAK;QACR,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;CACJ;AAED,MAAM,CAAC,MAAM,SAAS,GAAG,gBAAgB,CAAC,WAAW,EAAE,CAAC"}

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

@@ -0,0 +1,44 @@
+/**
+ * Enterprise Base Error class for the Enderun Core Framework.
+ */
+export declare class EnderunBaseError extends Error {
+    readonly code: string;
+    readonly timestamp: Date;
+    readonly details?: unknown;
+    constructor(message: string, code?: string, details?: unknown);
+    /**
+     * Converts the error into a structured JSON log format.
+     */
+    toJSON(): {
+        name: string;
+        message: string;
+        code: string;
+        timestamp: string;
+        details: unknown;
+        stack: string | undefined;
+    };
+}
+/**
+ * Thrown when configuration loading or validation fails.
+ */
+export declare class ConfigurationError extends EnderunBaseError {
+    constructor(message: string, details?: unknown);
+}
+/**
+ * Thrown when data schema or payload validation fails.
+ */
+export declare class ValidationError extends EnderunBaseError {
+    constructor(message: string, details?: unknown);
+}
+/**
+ * Thrown when adapter initialization or execution fails.
+ */
+export declare class AdapterError extends EnderunBaseError {
+    constructor(message: string, adapterId: string, details?: unknown);
+}
+/**
+ * Thrown when orchestration or agent communication fails.
+ */
+export declare class OrchestrationError extends EnderunBaseError {
+    constructor(message: string, details?: unknown);
+}

package/dist/src/shared/errors.js

@@ -0,0 +1,66 @@
+/**
+ * Enterprise Base Error class for the Enderun Core Framework.
+ */
+export class EnderunBaseError extends Error {
+    code;
+    timestamp;
+    details;
+    constructor(message, code = "ENDERUN_INTERNAL_ERROR", details) {
+        super(message);
+        this.name = this.constructor.name;
+        this.code = code;
+        this.timestamp = new Date();
+        this.details = details;
+        // Ensure proper prototype chain and capture stack trace
+        Object.setPrototypeOf(this, new.target.prototype);
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+    /**
+     * Converts the error into a structured JSON log format.
+     */
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            code: this.code,
+            timestamp: this.timestamp.toISOString(),
+            details: this.details,
+            stack: this.stack,
+        };
+    }
+}
+/**
+ * Thrown when configuration loading or validation fails.
+ */
+export class ConfigurationError extends EnderunBaseError {
+    constructor(message, details) {
+        super(message, "CONFIGURATION_ERROR", details);
+    }
+}
+/**
+ * Thrown when data schema or payload validation fails.
+ */
+export class ValidationError extends EnderunBaseError {
+    constructor(message, details) {
+        super(message, "VALIDATION_ERROR", details);
+    }
+}
+/**
+ * Thrown when adapter initialization or execution fails.
+ */
+export class AdapterError extends EnderunBaseError {
+    constructor(message, adapterId, details) {
+        super(`Adapter '${adapterId}' failure: ${message}`, "ADAPTER_ERROR", details);
+    }
+}
+/**
+ * Thrown when orchestration or agent communication fails.
+ */
+export class OrchestrationError extends EnderunBaseError {
+    constructor(message, details) {
+        super(message, "ORCHESTRATION_ERROR", details);
+    }
+}
+//# sourceMappingURL=errors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/shared/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACvB,IAAI,CAAS;IACb,SAAS,CAAO;IAChB,OAAO,CAAW;IAElC,YAAY,OAAe,EAAE,IAAI,GAAG,wBAAwB,EAAE,OAAiB;QAC3E,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QAEvB,wDAAwD;QACxD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAClD,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC1B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QACpD,CAAC;IACL,CAAC;IAED;;OAEG;IACI,MAAM;QACT,OAAO;YACH,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE;YACvC,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,IAAI,CAAC,KAAK;SACpB,CAAC;IACN,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,gBAAgB;IACpD,YAAY,OAAe,EAAE,OAAiB;QAC1C,KAAK,CAAC,OAAO,EAAE,qBAAqB,EAAE,OAAO,CAAC,CAAC;IACnD,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,gBAAgB;IACjD,YAAY,OAAe,EAAE,OAAiB;QAC1C,KAAK,CAAC,OAAO,EAAE,kBAAkB,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,OAAO,YAAa,SAAQ,gBAAgB;IAC9C,YAAY,OAAe,EAAE,SAAiB,EAAE,OAAiB;QAC7D,KAAK,CAAC,YAAY,SAAS,cAAc,OAAO,EAAE,EAAE,eAAe,EAAE,OAAO,CAAC,CAAC;IAClF,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,gBAAgB;IACpD,YAAY,OAAe,EAAE,OAAiB;QAC1C,KAAK,CAAC,OAAO,EAAE,qBAAqB,EAAE,OAAO,CAAC,CAAC;IACnD,CAAC;CACJ"}

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

@@ -0,0 +1,28 @@
+export declare enum LogLevel {
+    DEBUG = 0,
+    INFO = 1,
+    WARN = 2,
+    ERROR = 3,
+    FATAL = 4
+}
+export interface LoggerConfig {
+    minLevel: LogLevel;
+    enableColors: boolean;
+    jsonFormat: boolean;
+    logFile?: string;
+}
+export declare class EnterpriseLogger {
+    private config;
+    private static instance;
+    private constructor();
+    static getInstance(): EnterpriseLogger;
+    configure(config: Partial<LoggerConfig>): void;
+    private formatMessage;
+    private log;
+    debug(message: string, meta?: unknown): void;
+    info(message: string, meta?: unknown): void;
+    warn(message: string, meta?: unknown): void;
+    error(message: string, meta?: unknown): void;
+    fatal(message: string, meta?: unknown): void;
+}
+export declare const logger: EnterpriseLogger;

package/dist/src/shared/logger.js

@@ -0,0 +1,117 @@
+import chalk from "chalk";
+import fs from "fs";
+import path from "path";
+export var LogLevel;
+(function (LogLevel) {
+    LogLevel[LogLevel["DEBUG"] = 0] = "DEBUG";
+    LogLevel[LogLevel["INFO"] = 1] = "INFO";
+    LogLevel[LogLevel["WARN"] = 2] = "WARN";
+    LogLevel[LogLevel["ERROR"] = 3] = "ERROR";
+    LogLevel[LogLevel["FATAL"] = 4] = "FATAL";
+})(LogLevel || (LogLevel = {}));
+export class EnterpriseLogger {
+    config;
+    static instance;
+    constructor() {
+        const isProd = process.env.NODE_ENV === "production";
+        this.config = {
+            minLevel: isProd ? LogLevel.INFO : LogLevel.DEBUG,
+            enableColors: !isProd,
+            jsonFormat: isProd,
+        };
+    }
+    static getInstance() {
+        if (!EnterpriseLogger.instance) {
+            EnterpriseLogger.instance = new EnterpriseLogger();
+        }
+        return EnterpriseLogger.instance;
+    }
+    configure(config) {
+        this.config = { ...this.config, ...config };
+        if (this.config.logFile) {
+            try {
+                const dir = path.dirname(this.config.logFile);
+                if (!fs.existsSync(dir)) {
+                    fs.mkdirSync(dir, { recursive: true });
+                }
+            }
+            catch (err) {
+                console.error(`[Logger] Failed to create log directory: ${err}`);
+            }
+        }
+    }
+    formatMessage(level, message, meta) {
+        const timestamp = new Date().toISOString();
+        const pid = process.pid;
+        if (this.config.jsonFormat) {
+            return JSON.stringify({
+                timestamp,
+                level: LogLevel[level],
+                pid,
+                message,
+                meta,
+            });
+        }
+        const levelName = LogLevel[level].padEnd(5);
+        let coloredLevel = levelName;
+        if (this.config.enableColors) {
+            switch (level) {
+                case LogLevel.DEBUG:
+                    coloredLevel = chalk.blue(levelName);
+                    break;
+                case LogLevel.INFO:
+                    coloredLevel = chalk.green(levelName);
+                    break;
+                case LogLevel.WARN:
+                    coloredLevel = chalk.yellow(levelName);
+                    break;
+                case LogLevel.ERROR:
+                    coloredLevel = chalk.red(levelName);
+                    break;
+                case LogLevel.FATAL:
+                    coloredLevel = chalk.bgRed.white.bold(levelName);
+                    break;
+            }
+        }
+        const metaStr = meta ? ` | Meta: ${JSON.stringify(meta)}` : "";
+        return `[${timestamp}] [PID:${pid}] [${coloredLevel}]: ${message}${metaStr}`;
+    }
+    log(level, message, meta) {
+        if (level < this.config.minLevel)
+            return;
+        const formatted = this.formatMessage(level, message, meta);
+        // Output to console
+        if (level >= LogLevel.ERROR) {
+            console.error(formatted);
+        }
+        else {
+            console.log(formatted);
+        }
+        // Output to file if configured
+        if (this.config.logFile) {
+            try {
+                fs.appendFileSync(this.config.logFile, formatted + "\n", "utf8");
+            }
+            catch (err) {
+                console.error(`[Logger] Failed to write to log file: ${err}`);
+            }
+        }
+    }
+    debug(message, meta) {
+        this.log(LogLevel.DEBUG, message, meta);
+    }
+    info(message, meta) {
+        this.log(LogLevel.INFO, message, meta);
+    }
+    warn(message, meta) {
+        this.log(LogLevel.WARN, message, meta);
+    }
+    error(message, meta) {
+        this.log(LogLevel.ERROR, message, meta);
+    }
+    fatal(message, meta) {
+        this.log(LogLevel.FATAL, message, meta);
+    }
+}
+export const logger = EnterpriseLogger.getInstance();
+//# sourceMappingURL=logger.js.map

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

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

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

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

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

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

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

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