atabey 0.0.16 → 0.0.18

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

@@ -0,0 +1,132 @@
+import { spawn } from "child_process";
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+import { logger } from "../../shared/logger.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 framework-mcp entry point
+    let mcpPath = path.resolve(__dirname, "../../../atabey-mcp/dist/mcp/index.js");
+    let runner = "node";
+    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: "stdio"
+        }
+    });
+    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");
+    // Generate mcp.json configuration for AI interfaces
+    const configPath = path.resolve(process.cwd(), "mcp.json");
+    const mcpConfig = {
+        mcpServers: {
+            atabey: {
+                command: "atabey",
+                args: ["mcp", "start"],
+                env: {
+                    MCP_TRANSPORT: "stdio",
+                    ATABEY_PROJECT_ROOT: process.cwd()
+                }
+            }
+        }
+    };
+    fs.writeFileSync(configPath, JSON.stringify(mcpConfig, null, 2));
+    process.stdout.write(`[OK] Created mcp.json at ${configPath}\n`);
+    process.stdout.write("[INFO] This config is used by Claude Code, Gemini CLI, and Cursor to connect to Atabey.\n");
+    process.stdout.write("[INFO] Point your AI interface's MCP config to this file.\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/atabey/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/atabey/src/cli/commands/memory.d.ts

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

package/dist/atabey/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/atabey/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/atabey/src/cli/commands/orchestrate.d.ts

@@ -0,0 +1,61 @@
+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, {
+    traceId: string;
+    status: "PENDING" | "PROCESSED" | "WAITING" | "APPROVED";
+    from: string;
+    to: string;
+    category: "DELEGATION" | "ACTION" | "SUBTASK" | "REPLY" | "ALERT";
+    timestamp: string;
+    content: string;
+    priority?: "NORMAL" | "LOW" | "HIGH" | undefined;
+    parentId?: string | undefined;
+    action?: string | undefined;
+    requiresApproval?: boolean | undefined;
+    dependencies?: string[] | undefined;
+}, {
+    traceId: string;
+    status: "PENDING" | "PROCESSED" | "WAITING" | "APPROVED";
+    from: string;
+    to: string;
+    category: "DELEGATION" | "ACTION" | "SUBTASK" | "REPLY" | "ALERT";
+    timestamp: string;
+    content: string;
+    priority?: "NORMAL" | "LOW" | "HIGH" | undefined;
+    parentId?: string | undefined;
+    action?: string | undefined;
+    requiresApproval?: boolean | undefined;
+    dependencies?: string[] | undefined;
+}>;
+export type HermesMessage = z.infer<typeof HermesMessageSchema>;
+export declare function orchestrateCommand(options?: {
+    maxIterations?: number;
+}): 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/atabey/src/cli/commands/orchestrate.js

@@ -0,0 +1,238 @@
+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) {
+        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;
+                                }
+                            }
+                        }
+                        // 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);
+                        }
+                        // If human approval is required
+                        if ((msg.category === "ACTION" || msg.category === "ALERT" || riskFlag) && (msg.requiresApproval || riskFlag) && 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}`);
+                            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;
+                            }
+                        }
+                        // 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;
+                        }
+                        // 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/atabey/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/atabey/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>;

package/dist/atabey/src/cli/commands/plan.js

@@ -0,0 +1,120 @@
+import fs from "fs";
+import path from "path";
+import { PlanningEngine } from "../../modules/engines/planning-engine.js";
+import { RoutingEngine } from "../../modules/engines/routing-engine.js";
+import { Storage } from "../../shared/storage.js";
+import { asAgentID, asTaskID, asTraceID } from "../../shared/types.js";
+import { generateULID } from "../utils/time.js";
+import { UI } from "../utils/ui.js";
+import { sendMessage } from "./orchestrate.js";
+/**
+ * Submits a structured plan (DAG) to the framework.
+ */
+export async function submitPlanCommand(tasks) {
+    const traceId = asTraceID(generateULID());
+    const plan = PlanningEngine.createPlan(tasks);
+    const validation = PlanningEngine.validatePlan(plan);
+    if (!validation.valid) {
+        UI.error("Invalid Plan Submission:");
+        validation.errors.forEach((e) => UI.error(` - ${e}`));
+        process.exit(64);
+    }
+    UI.intent("Dynamic Task Planner", `Processing plan with ${plan.tasks.length} tasks (Plan Trace: ${traceId})`);
+    // Save plan metadata to SQLite
+    Storage.setMetadata(`plan_${traceId}`, JSON.stringify(plan));
+    for (const task of plan.tasks) {
+        const taskData = {
+            id: asTaskID(task.id),
+            traceId,
+            description: task.task,
+            agent: asAgentID(task.agent),
+            priority: "NORMAL",
+            status: "PENDING",
+            dependencies: task.dependencies || []
+        };
+        Storage.saveTask(taskData);
+        // Queue as a delegated message in SQLite
+        await sendMessage({
+            from: "@manager",
+            to: task.agent,
+            category: "DELEGATION",
+            content: JSON.stringify({ task: task.task, traceId }),
+            traceId,
+            parentId: task.id,
+            priority: "NORMAL",
+            dependencies: task.dependencies || []
+        });
+    }
+    UI.success(`[OK] Dynamic plan submitted and queued: ${plan.tasks.length} tasks.`);
+}
+/**
+ * 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 async function planCommand() {
+    const projectRoot = process.cwd();
+    const docsDir = path.join(projectRoot, "docs");
+    if (!fs.existsSync(docsDir)) {
+        UI.error("Docs directory not found at docs/");
+        UI.info("TIP: Create a docs/ folder with your project requirements in .md files.");
+        return;
+    }
+    const entries = fs.readdirSync(docsDir, { withFileTypes: true });
+    const mdFiles = entries.filter(e => e.isFile() && e.name.endsWith(".md"));
+    if (mdFiles.length === 0) {
+        UI.warning("No markdown files found in docs/ directory.");
+        UI.info("TIP: Add .md files to docs/ with your project requirements.");
+        return;
+    }
+    UI.intent("Planning Engine", `Reading ${mdFiles.length} document(s) from docs/...`);
+    let totalTasks = 0;
+    for (const file of mdFiles) {
+        const filePath = path.join(docsDir, file.name);
+        const content = fs.readFileSync(filePath, "utf8");
+        const traceId = asTraceID(generateULID());
+        UI.success(`[FILE] docs/${file.name} (Trace: ${traceId})`);
+        // Extract checklist items and create sequential task chain
+        const taskRegex = /- \[ \]\s+(.+)/g;
+        let taskMatch;
+        let taskCount = 0;
+        let lastTaskId = null;
+        while ((taskMatch = taskRegex.exec(content)) !== null) {
+            const taskText = taskMatch[1].trim();
+            if (taskText.length >= 3) {
+                taskCount++;
+                totalTasks++;
+                // Smart routing via RoutingEngine
+                const routingResult = RoutingEngine.resolveWithDetails(taskText);
+                const targetAgent = routingResult.agent;
+                process.stdout.write(`     [AGENT] ${targetAgent} (confidence: ${routingResult.confidence}, score: ${routingResult.score})\n`);
+                const subTaskId = generateULID();
+                const taskData = {
+                    id: asTaskID(subTaskId),
+                    traceId,
+                    description: taskText,
+                    agent: asAgentID(targetAgent),
+                    priority: "NORMAL",
+                    status: "PENDING",
+                    dependencies: lastTaskId ? [lastTaskId] : []
+                };
+                Storage.saveTask(taskData);
+                // Queue as a delegated message
+                await sendMessage({
+                    from: "@manager",
+                    to: targetAgent,
+                    category: "DELEGATION",
+                    content: JSON.stringify({ task: taskText, traceId }),
+                    traceId,
+                    parentId: subTaskId,
+                    priority: "NORMAL",
+                    dependencies: lastTaskId ? [lastTaskId] : []
+                });
+                lastTaskId = subTaskId;
+            }
+        }
+        process.stdout.write(`   [LIST] Actionable tasks detected: ${taskCount}\n`);
+    }
+    UI.success(`\n[OK] Planning complete: ${totalTasks} tasks identified.`);
+}
+//# sourceMappingURL=plan.js.map

package/dist/atabey/src/cli/commands/plan.js.map

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

package/dist/atabey/src/cli/commands/quickstart.d.ts

@@ -0,0 +1,9 @@
+/**
+ * [START] Atabey Quickstart — creates a working example project in seconds
+ *
+ * Sets up a ready-to-use demo project for the user:
+ * - docs/ folder with example tasks
+ * - Sample task list
+ * - Ready-to-execute plan
+ */
+export declare function quickstartCommand(): Promise<void>;