atabey 0.0.23 → 0.0.26

package/dist/src/cli/commands/knowledge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge.js","sourceRoot":"","sources":["../../../../src/cli/commands/knowledge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AAEpC,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,KAAa,EAAE,OAAe;IAC3E,IAAI,CAAC,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;QACrB,EAAE,CAAC,KAAK,CAAC,kDAAkD,CAAC,CAAC;QAC7D,OAAO;IACX,CAAC;IACD,EAAE,CAAC,OAAO,CAAC,2BAA2B,KAAK,EAAE,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,KAAa;IAC1D,IAAI,CAAC,KAAK,EAAE,CAAC;QACT,EAAE,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;QACnD,OAAO;IACX,CAAC;IACD,EAAE,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;AACxC,CAAC"}

package/dist/src/cli/commands/lint.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Run ESLint for the project (same as npm run lint).
+ */
+export declare function lintCommand(): Promise<void>;

package/dist/src/cli/commands/lint.js

@@ -0,0 +1,24 @@
+import { execSync } from "child_process";
+import { getPackageVersion } from "../utils/pkg.js";
+import { UI } from "../utils/ui.js";
+/**
+ * Run ESLint for the project (same as npm run lint).
+ */
+export async function lintCommand() {
+    UI.info(`Running ESLint (v${getPackageVersion()})...`);
+    const projectRoot = process.cwd();
+    try {
+        execSync("npm run lint", {
+            cwd: projectRoot,
+            stdio: "inherit",
+            env: process.env,
+        });
+        UI.success("ESLint passed with no errors.");
+    }
+    catch {
+        UI.error("ESLint reported errors. Fix violations before committing.");
+        UI.info("Tip: npm run lint -- --fix");
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=lint.js.map

package/dist/src/cli/commands/lint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint.js","sourceRoot":"","sources":["../../../../src/cli/commands/lint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AAEpC;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW;IAC7B,EAAE,CAAC,IAAI,CAAC,oBAAoB,iBAAiB,EAAE,MAAM,CAAC,CAAC;IACvD,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAClC,IAAI,CAAC;QACD,QAAQ,CAAC,cAAc,EAAE;YACrB,GAAG,EAAE,WAAW;YAChB,KAAK,EAAE,SAAS;YAChB,GAAG,EAAE,OAAO,CAAC,GAAG;SACnB,CAAC,CAAC;QACH,EAAE,CAAC,OAAO,CAAC,+BAA+B,CAAC,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACL,EAAE,CAAC,KAAK,CAAC,2DAA2D,CAAC,CAAC;QACtE,EAAE,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;QACtC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;AACL,CAAC"}

package/dist/src/cli/commands/log.d.ts

@@ -0,0 +1,10 @@
+export declare function logAgentActionCommand(data: {
+    agent?: unknown;
+    action?: string;
+    requestId?: string;
+    traceId?: string;
+    status?: string;
+    summary?: string;
+    files?: string[];
+    details?: Record<string, unknown>;
+}): Promise<void>;

package/dist/src/cli/commands/log.js

@@ -0,0 +1,14 @@
+import { normalizeAgentName } from "../utils/string.js";
+import { Storage } from "../../shared/storage.js";
+export async function logAgentActionCommand(data) {
+    const agent = normalizeAgentName(data.agent);
+    Storage.saveLog({
+        agent,
+        action: data.action || "ACTION",
+        trace_id: data.traceId || undefined,
+        status: data.status || "SUCCESS",
+        summary: data.summary || "",
+        findings: data.details ? JSON.stringify(data.details) : undefined
+    });
+}
+//# sourceMappingURL=log.js.map

package/dist/src/cli/commands/log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.js","sourceRoot":"","sources":["../../../../src/cli/commands/log.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAElD,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,IAAwK;IAChN,MAAM,KAAK,GAAG,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAE7C,OAAO,CAAC,OAAO,CAAC;QACZ,KAAK;QACL,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,QAAQ;QAC/B,QAAQ,EAAE,IAAI,CAAC,OAAO,IAAI,SAAS;QACnC,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,SAAS;QAChC,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,EAAE;QAC3B,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS;KACpE,CAAC,CAAC;AACP,CAAC"}

package/dist/src/cli/commands/mcp.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Command to manage the MCP server.
+ *
+ * Atabey connects to AI interfaces (Claude Code, Gemini CLI, Cursor, Codex)
+ * via the MCP (Model Context Protocol) standard.
+ *
+ * The MCP server runs as a stdio transport:
+ * - stdin/stdout: JSON-RPC protocol messages (reserved for MCP)
+ * - stderr: Server logs and diagnostics
+ */
+export declare function mcpCommand(args: string[]): Promise<void>;

package/dist/src/cli/commands/mcp.js

@@ -0,0 +1,128 @@
+import { spawn } from "child_process";
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+import { MCP } from "../../shared/constants.js";
+import { logger } from "../../shared/logger.js";
+import { buildMcpServerEntry, writeRootMcpConfig } from "../platforms/core.js";
+import { UI } from "../utils/ui.js";
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+/**
+ * Command to manage the MCP server.
+ *
+ * Atabey connects to AI interfaces (Claude Code, Gemini CLI, Cursor, Codex)
+ * via the MCP (Model Context Protocol) standard.
+ *
+ * The MCP server runs as a stdio transport:
+ * - stdin/stdout: JSON-RPC protocol messages (reserved for MCP)
+ * - stderr: Server logs and diagnostics
+ */
+export async function mcpCommand(args) {
+    const subcommand = args[0] || "help";
+    switch (subcommand) {
+        case "start":
+            await startMcpServer();
+            break;
+        case "install":
+            await installMcpConfig();
+            break;
+        case "status":
+            await checkMcpStatus();
+            break;
+        case "help":
+        default:
+            showMcpHelp();
+            break;
+    }
+}
+async function startMcpServer() {
+    UI.intent("[MCP]", "Starting Agent Atabey MCP Server...");
+    // Find the atabey-mcp entry point (legacy "framework-mcp" paths kept for compatibility in tests)
+    let mcpPath = path.resolve(__dirname, "../../../atabey-mcp/dist/atabey-mcp/src/mcp/index.js");
+    let runner = "node";
+    if (!fs.existsSync(mcpPath)) {
+        mcpPath = path.join(process.cwd(), "node_modules/atabey-mcp/dist/atabey-mcp/src/mcp/index.js");
+        if (!fs.existsSync(mcpPath)) {
+            mcpPath = path.resolve(__dirname, "../../../atabey-mcp/src/mcp/index.ts");
+            runner = "npx";
+            if (!fs.existsSync(mcpPath)) {
+                UI.error(`MCP Server entry point not found at ${mcpPath}`);
+                UI.info("Try running 'npm run build' first.");
+                process.exit(70);
+            }
+        }
+    }
+    const args = runner === "npx" ? ["tsx", mcpPath] : [mcpPath];
+    UI.success("MCP Server starting via " + runner + "...");
+    logger.info("[MCP] Starting MCP server", { runner, path: mcpPath });
+    // MCP uses stdio transport:
+    // - stdin/stdout: JSON-RPC protocol (clean pipe to AI interface)
+    // - stderr: server diagnostics and logs
+    const child = spawn(runner, args, {
+        stdio: ["inherit", "inherit", "inherit"],
+        env: {
+            ...process.env,
+            ATABEY_PROJECT_ROOT: process.cwd(),
+            [MCP.TRANSPORT_ENV]: MCP.TRANSPORT_STDIO,
+            ATABEY_AUTO_START_ORCHESTRATOR: "true",
+        }
+    });
+    child.on("error", (err) => {
+        UI.error(`Failed to start MCP Server: ${err.message}`);
+        logger.error("[MCP] Failed to start server", err);
+        process.exit(70);
+    });
+    child.on("exit", (code) => {
+        if (code !== 0) {
+            UI.error(`MCP Server exited with code ${code}`);
+            process.exit(code || 70);
+        }
+    });
+}
+async function installMcpConfig() {
+    process.stdout.write("[MCP] Installing Agent Atabey MCP configuration...\n");
+    const projectRoot = process.cwd();
+    writeRootMcpConfig(projectRoot);
+    const configPath = path.resolve(projectRoot, MCP.ROOT_CONFIG_FILE);
+    const entry = buildMcpServerEntry(projectRoot);
+    process.stdout.write(`[OK] Created ${MCP.ROOT_CONFIG_FILE} at ${configPath}\n`);
+    process.stdout.write(`[INFO] Transport: ${entry.env[MCP.TRANSPORT_ENV]} (IDE-compatible stdio)\n`);
+    process.stdout.write("[INFO] Used by Claude Code, Gemini CLI, Cursor, Codex, and Grok.\n");
+    process.stdout.write("[INFO] For HTTP/SSE unified mode: MCP_TRANSPORT=unified MCP_PORT=5858\n");
+}
+async function checkMcpStatus() {
+    process.stdout.write("[MCP] Checking MCP Server Status...\n");
+    const distPath = path.resolve(__dirname, "../../../atabey-mcp/dist/mcp/index.js");
+    if (fs.existsSync(distPath)) {
+        process.stdout.write("[OK] MCP Server is built and ready to start.\n");
+    }
+    else {
+        process.stdout.write("[WARN] MCP Server is NOT built. Run 'npm run build' to prepare it.\n");
+    }
+}
+function showMcpHelp() {
+    process.stdout.write(`
+Usage: atabey mcp <subcommand>
+
+Subcommands:
+  start     Start the MCP server (Stdio transport) — connects to Claude/Gemini/Cursor
+  install   Generate a local mcp.json configuration for AI interfaces
+  status    Check the health and build status of the MCP server
+  help      Show this help message
+
+About MCP Integration:
+  Atabey connects to AI interfaces via the Model Context Protocol (MCP).
+  Supported platforms:
+    - Claude Code    (reads mcp.json)
+    - Gemini CLI     (reads mcp.json)
+    - Cursor         (reads .cursor/mcp.json)
+    - Codex CLI      (reads mcp.json)
+    - Antigravity CLI
+
+  Once connected, you can use @agent syntax in your AI chat:
+    @backend Create a user login service
+    @security Audit the auth module
+    @quality Run compliance check
+\n`);
+}
+//# sourceMappingURL=mcp.js.map

package/dist/src/cli/commands/mcp.js.map

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

package/dist/src/cli/commands/memory.d.ts

@@ -0,0 +1 @@
+export declare function updateProjectMemoryCommand(section: string, content: string): Promise<void>;

package/dist/src/cli/commands/memory.js

@@ -0,0 +1,5 @@
+import { updateProjectMemory } from "../utils/memory.js";
+export async function updateProjectMemoryCommand(section, content) {
+    updateProjectMemory(section, content);
+}
+//# sourceMappingURL=memory.js.map

package/dist/src/cli/commands/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../../../src/cli/commands/memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,OAAe,EAAE,OAAe;IAC7E,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AAC1C,CAAC"}

package/dist/src/cli/commands/orchestrate.d.ts

@@ -0,0 +1,62 @@
+import { z } from "zod";
+import { MessageRow } from "../../shared/storage.js";
+export declare const HermesMessageSchema: z.ZodObject<{
+    timestamp: z.ZodString;
+    from: z.ZodString;
+    to: z.ZodString;
+    category: z.ZodEnum<["ACTION", "DELEGATION", "SUBTASK", "REPLY", "ALERT"]>;
+    content: z.ZodString;
+    traceId: z.ZodString;
+    parentId: z.ZodOptional<z.ZodString>;
+    status: z.ZodEnum<["PENDING", "PROCESSED", "WAITING", "APPROVED"]>;
+    priority: z.ZodOptional<z.ZodEnum<["HIGH", "NORMAL", "LOW"]>>;
+    action: z.ZodOptional<z.ZodString>;
+    requiresApproval: z.ZodOptional<z.ZodBoolean>;
+    dependencies: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    timestamp: string;
+    status: "APPROVED" | "PENDING" | "PROCESSED" | "WAITING";
+    traceId: string;
+    from: string;
+    to: string;
+    category: "DELEGATION" | "ALERT" | "ACTION" | "SUBTASK" | "REPLY";
+    content: string;
+    action?: string | undefined;
+    priority?: "NORMAL" | "LOW" | "HIGH" | undefined;
+    requiresApproval?: boolean | undefined;
+    parentId?: string | undefined;
+    dependencies?: string[] | undefined;
+}, {
+    timestamp: string;
+    status: "APPROVED" | "PENDING" | "PROCESSED" | "WAITING";
+    traceId: string;
+    from: string;
+    to: string;
+    category: "DELEGATION" | "ALERT" | "ACTION" | "SUBTASK" | "REPLY";
+    content: string;
+    action?: string | undefined;
+    priority?: "NORMAL" | "LOW" | "HIGH" | undefined;
+    requiresApproval?: boolean | undefined;
+    parentId?: string | undefined;
+    dependencies?: string[] | undefined;
+}>;
+export type HermesMessage = z.infer<typeof HermesMessageSchema>;
+export declare function orchestrateCommand(options?: {
+    maxIterations?: number;
+    signal?: AbortSignal;
+}): Promise<void>;
+/**
+ * Standard for sending messages between agents.
+ * Agents use this function to communicate via Hermes message queue.
+ */
+export declare function sendMessage(args: {
+    from: string;
+    to: string;
+    category: "ACTION" | "DELEGATION" | "SUBTASK" | "REPLY" | "ALERT";
+    content: string;
+    traceId: string;
+    parentId?: string;
+    priority?: "HIGH" | "NORMAL" | "LOW";
+    requiresApproval?: boolean;
+    dependencies?: string[];
+}): Promise<MessageRow | undefined>;

package/dist/src/cli/commands/orchestrate.js

@@ -0,0 +1,263 @@
+import path from "path";
+import { z } from "zod";
+import { AgentExecutor } from "../../modules/engines/agent-executor.js";
+import { RoutingEngine } from "../../modules/engines/routing-engine.js";
+import { logger } from "../../shared/logger.js";
+import { Storage } from "../../shared/storage.js";
+import { stripMarkdownCodeBlocks } from "../../shared/string.js";
+import { asAgentID, asTaskID, asTraceID } from "../../shared/types.js";
+import { acquireMemoryLock, getFrameworkDir, releaseMemoryLock } from "../utils/memory.js";
+import { sleep } from "../utils/time.js";
+import { UI } from "../utils/ui.js";
+export const HermesMessageSchema = z.object({
+    timestamp: z.string(),
+    from: z.string(),
+    to: z.string(),
+    category: z.enum(["ACTION", "DELEGATION", "SUBTASK", "REPLY", "ALERT"]),
+    content: z.string(),
+    traceId: z.string(),
+    parentId: z.string().optional(),
+    status: z.enum(["PENDING", "PROCESSED", "WAITING", "APPROVED"]),
+    priority: z.enum(["HIGH", "NORMAL", "LOW"]).optional(),
+    action: z.string().optional(),
+    requiresApproval: z.boolean().optional(),
+    dependencies: z.array(z.string()).optional(),
+});
+let isLooping = false;
+export async function orchestrateCommand(options) {
+    const readline = await import("readline");
+    readline.cursorTo(process.stdout, 0, 0);
+    readline.clearScreenDown(process.stdout);
+    const maxIterations = options?.maxIterations;
+    let iterationCount = 0;
+    isLooping = true;
+    while (isLooping) {
+        if (options?.signal?.aborted) {
+            isLooping = false;
+            break;
+        }
+        try {
+            // 1. Agent timeout check (30 min)
+            const agents = Storage.getAllAgents();
+            for (const agent of agents) {
+                if (agent.state === "EXECUTING" && agent.last_updated) {
+                    const lastUpdatedTime = Date.parse(agent.last_updated);
+                    if (!isNaN(lastUpdatedTime) && Date.now() - lastUpdatedTime > 30 * 60 * 1000) {
+                        Storage.updateAgentStatus(agent.name, "READY", "Idle (Recovered from Timeout)");
+                    }
+                }
+            }
+            // 2. Get pending messages
+            const pendingMessages = Storage.getPendingMessages() || [];
+            // 3. Dashboard render
+            const traceId = Storage.getMetadata("traceId") || "N/A";
+            const phase = Storage.getMetadata("phase") || "N/A";
+            const logs = Storage.getLogs();
+            UI.renderDashboard({
+                traceId,
+                phase,
+                agents: Storage.getAllAgents().map(a => ({ name: a.name, state: a.state, task: a.task })),
+                pendingCount: pendingMessages.length,
+                logs: logs.map(l => ({ timestamp: l.timestamp, agent: l.agent, action: l.action, summary: l.summary }))
+            });
+            if (pendingMessages.length > 0) {
+                // Acquire memory lock before processing messages
+                const lockPath = path.join(getFrameworkDir(), "messages", ".lock");
+                let lockAcquired = false;
+                for (let lockAttempt = 0; lockAttempt < 3; lockAttempt++) {
+                    if (acquireMemoryLock(lockPath)) {
+                        lockAcquired = true;
+                        break;
+                    }
+                    await sleep(500);
+                }
+                if (!lockAcquired) {
+                    UI.warning("Could not acquire memory lock, assuming stale lock and proceeding...");
+                    releaseMemoryLock(lockPath);
+                }
+                try {
+                    for (const msg of pendingMessages) {
+                        // Dependency Check
+                        if (msg.parentId) {
+                            const tasks = Storage.getTasks(asTraceID(msg.traceId));
+                            const task = tasks.find(t => t.id === msg.parentId);
+                            if (task && task.dependencies.length > 0) {
+                                const incompleteDeps = tasks.filter(t => task.dependencies.includes(t.id) && t.status !== "COMPLETED");
+                                if (incompleteDeps.length > 0) {
+                                    continue;
+                                }
+                            }
+                        }
+                        // Target agent: skip RoutingEngine if @manager explicitly specified
+                        const agentName = (msg.category === "DELEGATION" || msg.category === "SUBTASK") && String(msg.to) === "@manager"
+                            ? (() => {
+                                try {
+                                    const r = RoutingEngine.resolveWithDetails(msg.content);
+                                    logger.debug(`RoutingEngine: ${msg.content} → ${r.agent} (score: ${r.score})`);
+                                    return r.agent;
+                                }
+                                catch {
+                                    return String(msg.to);
+                                }
+                            })()
+                            : String(msg.to);
+                        // Extract task description
+                        let taskDescription = msg.content;
+                        try {
+                            const cleanedContent = stripMarkdownCodeBlocks(msg.content);
+                            const payload = JSON.parse(cleanedContent);
+                            taskDescription = payload.task || msg.content;
+                        }
+                        catch {
+                            taskDescription = msg.content;
+                        }
+                        // Risk Engine check
+                        let riskFlag = false;
+                        try {
+                            const { RiskEngine } = await import("../../modules/engines/risk-engine.js");
+                            const assessment = RiskEngine.assessTaskRisk(msg.content);
+                            if (assessment.requiresApproval) {
+                                riskFlag = true;
+                            }
+                        }
+                        catch (err) {
+                            logger.debug("Risk engine not available, continuing without risk assessment", err);
+                        }
+                        // CRUD Governance Engine check
+                        let governanceFlag = false;
+                        let governanceReason = "";
+                        try {
+                            const { GovernanceEngine } = await import("../../modules/engines/crud-governance.js");
+                            const operation = GovernanceEngine.classifyTask(taskDescription);
+                            if (operation) {
+                                const decision = await GovernanceEngine.evaluate(agentName, operation, taskDescription, msg.traceId);
+                                if (decision.requiresApproval) {
+                                    governanceFlag = true;
+                                    governanceReason = decision.reason;
+                                }
+                            }
+                        }
+                        catch (err) {
+                            logger.debug("Governance engine not available, continuing without governance check", err);
+                        }
+                        // If human approval is required
+                        const needsApproval = msg.category === "ACTION" || msg.category === "ALERT" || riskFlag || governanceFlag;
+                        if (needsApproval && (msg.requiresApproval || riskFlag || governanceFlag) && msg.status !== "APPROVED") {
+                            readline.cursorTo(process.stdout, 0, process.stdout.rows ? process.stdout.rows - 2 : 20);
+                            readline.clearScreenDown(process.stdout);
+                            UI.warning(`\n[WARN]  [APPROVAL REQUEST] Trace ${msg.traceId} requires approval:`);
+                            UI.warning(`   Description: ${msg.content}`);
+                            if (governanceReason) {
+                                UI.warning(`   Reason: ${governanceReason}`);
+                            }
+                            const approved = await askUserApproval(msg.traceId, msg.content);
+                            if (approved && msg.id !== undefined) {
+                                Storage.updateMessageStatus(msg.id, "APPROVED");
+                                Storage.saveLog({
+                                    agent: "@human",
+                                    action: "APPROVED",
+                                    trace_id: msg.traceId,
+                                    status: "SUCCESS",
+                                    summary: `Trace ${msg.traceId} approved`,
+                                });
+                            }
+                            else if (msg.id !== undefined) {
+                                Storage.updateMessageStatus(msg.id, "PROCESSED");
+                                Storage.saveLog({
+                                    agent: "@human",
+                                    action: "REJECTED",
+                                    trace_id: msg.traceId,
+                                    status: "FAILED",
+                                    summary: `Trace ${msg.traceId} rejected`,
+                                });
+                                continue;
+                            }
+                        }
+                        // Execute the task via AgentExecutor
+                        UI.agentBox(agentName, `Executing: ${taskDescription.substring(0, 60)}...`);
+                        const result = await AgentExecutor.execute(taskDescription, msg.traceId);
+                        if (result.success) {
+                            UI.success(`${agentName} completed task successfully (${result.attempts} attempt(s))`);
+                            logger.info(`[ORCHESTRATE] ${agentName} completed: ${taskDescription.substring(0, 80)}`, {
+                                agent: agentName,
+                                traceId: msg.traceId,
+                                attempts: result.attempts,
+                            });
+                        }
+                        else {
+                            UI.error(`${agentName} FAILED after ${result.attempts} attempts`);
+                            logger.error(`[ORCHESTRATE] ${agentName} failed: ${taskDescription.substring(0, 80)}`, {
+                                agent: agentName,
+                                traceId: msg.traceId,
+                                output: result.output,
+                            });
+                        }
+                        if (msg.id !== undefined) {
+                            Storage.updateMessageStatus(msg.id, "PROCESSED");
+                        }
+                    }
+                    // Markdown sync
+                    const { syncMarkdownMemory } = await import("../utils/memory.js");
+                    syncMarkdownMemory();
+                }
+                finally {
+                    // Always release the lock after processing
+                    releaseMemoryLock(lockPath);
+                }
+            }
+        }
+        catch (globalLoopErr) {
+            UI.error(`[WARN]  Critical error in Hermes orchestration loop: ${globalLoopErr.message}`);
+        }
+        iterationCount++;
+        if (maxIterations !== undefined && iterationCount >= maxIterations) {
+            isLooping = false;
+            break;
+        }
+        await sleep(2000);
+    }
+}
+/**
+ * Standard for sending messages between agents.
+ * Agents use this function to communicate via Hermes message queue.
+ */
+export async function sendMessage(args) {
+    try {
+        const message = {
+            timestamp: new Date().toISOString(),
+            from: asAgentID(args.from),
+            to: asAgentID(args.to),
+            category: args.category,
+            content: args.content,
+            traceId: asTraceID(args.traceId),
+            parentId: args.parentId ? asTaskID(args.parentId) : undefined,
+            status: "PENDING",
+            priority: args.priority || "NORMAL",
+            requiresApproval: args.requiresApproval || false
+        };
+        Storage.saveMessage(message);
+        return message;
+    }
+    catch (err) {
+        UI.error(`Message could not be delivered: ${args.from} -> ${args.to}`);
+        logger.debug("Hermes sendMessage failed", err);
+    }
+}
+async function askUserApproval(_traceId, _content) {
+    if (process.env.ATABEY_TEST_DIR || !process.stdin.isTTY) {
+        return false;
+    }
+    const readline = await import("readline");
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout
+    });
+    return new Promise((resolve) => {
+        rl.question("[INFO] Approve this operation? (y/N): ", (answer) => {
+            rl.close();
+            const cleanAnswer = answer.trim().toLowerCase();
+            resolve(cleanAnswer === "y" || cleanAnswer === "yes");
+        });
+    });
+}
+//# sourceMappingURL=orchestrate.js.map

package/dist/src/cli/commands/orchestrate.js.map

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

package/dist/src/cli/commands/plan.d.ts

@@ -0,0 +1,11 @@
+import { PlanTask } from "../../modules/engines/types.js";
+/**
+ * Submits a structured plan (DAG) to the framework.
+ */
+export declare function submitPlanCommand(tasks: PlanTask[]): Promise<void>;
+/**
+ * Reads ALL markdown files from the docs/ directory and creates
+ * planning tasks from them. Agents will use this to understand
+ * project requirements and generate code accordingly.
+ */
+export declare function planCommand(): Promise<void>;