atabey 0.0.23 → 0.0.25

package/dist/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/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/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>;

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

@@ -0,0 +1,60 @@
+import fs from "fs";
+import path from "path";
+import { writeTextFile } from "../../shared/fs.js";
+import { UI } from "../utils/ui.js";
+/**
+ * [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 async function quickstartCommand() {
+    const projectRoot = process.cwd();
+    const docsDir = path.join(projectRoot, "docs");
+    const exampleTaskFile = path.join(docsDir, "quickstart-tasks.md");
+    UI.intent("[Atabey Quickstart]", "Creating example project in 10 seconds...");
+    // 1. Create docs/ directory
+    if (!fs.existsSync(docsDir)) {
+        fs.mkdirSync(docsDir, { recursive: true });
+    }
+    // 2. Create example task file
+    const exampleContent = `# 🚀 Quickstart Tasks — Atabey Order
+
+This is an example task list to demonstrate how Atabey distributes and validates tasks.
+
+## [BACKEND] Backend Tasks
+
+- [ ] Create user login service with JWT authentication
+- [ ] Write Vitest unit tests for the login service
+
+## [FRONTEND] Frontend Tasks
+
+- [ ] Create responsive login page using atomic components
+- [ ] Connect login page to backend API
+
+## [MOBILE] Mobile Tasks
+
+- [ ] Create user profile page with React Native
+- [ ] Implement offline-first architecture
+
+## [QA] Quality Tasks
+
+- [ ] Audit all code for compliance and lint errors
+`;
+    writeTextFile(exampleTaskFile, exampleContent);
+    UI.success(`[OK] docs/quickstart-tasks.md created (${exampleContent.split("\n").length} lines)`);
+    // 3. Show user instructions
+    process.stdout.write("\n  [Task List]:\n");
+    process.stdout.write("  -----------------------------------------\n");
+    process.stdout.write("  1.  atabey init          -> Initialize the project\n");
+    process.stdout.write("  2.  atabey plan          -> Auto-distribute tasks\n");
+    process.stdout.write("  3.  atabey orchestrate   -> Start orchestration\n");
+    process.stdout.write("  4.  atabey dashboard     -> Open web panel\n");
+    process.stdout.write("\n  [Tip]: To call individual agents:\n");
+    process.stdout.write("     atabey @backend \"Create user login service\"\n");
+    process.stdout.write("\n");
+    UI.success("[OK] Quickstart ready! You can start immediately.");
+}
+//# sourceMappingURL=quickstart.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"quickstart.js","sourceRoot":"","sources":["../../../../src/cli/commands/quickstart.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AAEpC;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACnC,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAClC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAC/C,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,qBAAqB,CAAC,CAAC;IAElE,EAAE,CAAC,MAAM,CAAC,qBAAqB,EAAE,2CAA2C,CAAC,CAAC;IAE9E,4BAA4B;IAC5B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1B,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,8BAA8B;IAC9B,MAAM,cAAc,GAAG;;;;;;;;;;;;;;;;;;;;;;CAsB1B,CAAC;IAEE,aAAa,CAAC,eAAe,EAAE,cAAc,CAAC,CAAC;IAC/C,EAAE,CAAC,OAAO,CAAC,0CAA0C,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,SAAS,CAAC,CAAC;IAEjG,4BAA4B;IAC5B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;IAC3C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACtE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC/E,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,uDAAuD,CAAC,CAAC;IAC9E,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qDAAqD,CAAC,CAAC;IAC5E,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACvE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAChE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAC7E,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAE3B,EAAE,CAAC,OAAO,CAAC,mDAAmD,CAAC,CAAC;AACpE,CAAC"}

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

@@ -0,0 +1 @@
+export declare function runScriptCommand(script: string, projectPath: string): Promise<void>;

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

@@ -0,0 +1,28 @@
+import cp from "child_process";
+import fs from "fs";
+import path from "path";
+import { UI } from "../utils/ui.js";
+const targetDir = process.cwd();
+export async function runScriptCommand(script, projectPath) {
+    const fullPath = path.join(targetDir, projectPath);
+    if (!fs.existsSync(fullPath)) {
+        UI.error(`Project path not found: ${projectPath}`);
+        return;
+    }
+    UI.info(`Running 'npm run ${script}' in ${projectPath}...`);
+    try {
+        // shell: false prevents shell injection attacks
+        // script name is validated (no spaces, no special chars)
+        const sanitizedScript = script.replace(/[^a-zA-Z0-9_-]/g, "");
+        if (sanitizedScript !== script) {
+            UI.error(`Invalid script name: "${script}". Use only letters, numbers, hyphens, and underscores.`);
+            return;
+        }
+        cp.spawnSync("npm", ["run", sanitizedScript], { cwd: fullPath, stdio: "inherit", shell: false });
+    }
+    catch (e) {
+        const message = e instanceof Error ? e.message : "Unknown error";
+        UI.error(`Failed to run script: ${message}`);
+    }
+}
+//# sourceMappingURL=script.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"script.js","sourceRoot":"","sources":["../../../../src/cli/commands/script.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,eAAe,CAAC;AAC/B,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AAEpC,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;AAEhC,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAAc,EAAE,WAAmB;IACtE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IACnD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3B,EAAE,CAAC,KAAK,CAAC,2BAA2B,WAAW,EAAE,CAAC,CAAC;QACnD,OAAO;IACX,CAAC;IACD,EAAE,CAAC,IAAI,CAAC,oBAAoB,MAAM,QAAQ,WAAW,KAAK,CAAC,CAAC;IAC5D,IAAI,CAAC;QACD,gDAAgD;QAChD,yDAAyD;QACzD,MAAM,eAAe,GAAG,MAAM,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;QAC9D,IAAI,eAAe,KAAK,MAAM,EAAE,CAAC;YAC7B,EAAE,CAAC,KAAK,CAAC,yBAAyB,MAAM,yDAAyD,CAAC,CAAC;YACnG,OAAO;QACX,CAAC;QACD,EAAE,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,eAAe,CAAC,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IACrG,CAAC;IAAC,OAAO,CAAU,EAAE,CAAC;QAClB,MAAM,OAAO,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;QACjE,EAAE,CAAC,KAAK,CAAC,yBAAyB,OAAO,EAAE,CAAC,CAAC;IACjD,CAAC;AACL,CAAC"}

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

@@ -0,0 +1 @@
+export declare function securityAuditCommand(targetPath: string): Promise<void>;

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

@@ -0,0 +1,34 @@
+import fs from "fs";
+import path from "path";
+import { collectFiles } from "../utils/fs.js";
+import { UI } from "../utils/ui.js";
+const targetDir = process.cwd();
+export async function securityAuditCommand(targetPath) {
+    UI.info(`Running Advanced Security Audit on: ${targetPath}...`);
+    const scanRules = [
+        { pattern: /sql`/, message: "Potential Raw SQL usage detected", severity: "HIGH" },
+        { pattern: /(password|secret|api_?key)\s*[:=]\s*['"][^'"]+['"]/i, message: "Potential hardcoded secret detected", severity: "CRITICAL" },
+        { pattern: /:\s*any(?!\w)/, message: "Usage of 'any' type detected", severity: "MEDIUM" },
+        { pattern: /\.innerHTML\s*=/, message: "Unsafe innerHTML assignment detected", severity: "MEDIUM" },
+    ];
+    const issues = [];
+    const files = collectFiles(path.join(targetDir, targetPath), [".ts", ".tsx", ".js", ".jsx"]);
+    files.forEach((f) => {
+        const content = fs.readFileSync(f, "utf8");
+        const lines = content.split("\n");
+        lines.forEach((line, i) => {
+            scanRules.forEach((rule) => {
+                if (rule.pattern.test(line)) {
+                    issues.push(`[${rule.severity}] ${rule.message} in ${path.relative(targetDir, f)}:${i + 1}`);
+                }
+            });
+        });
+    });
+    if (issues.length === 0) {
+        UI.success("No security issues detected.");
+    }
+    else {
+        issues.forEach((issue) => process.stdout.write(`[WARN]  ${issue}\n`));
+    }
+}
+//# sourceMappingURL=security.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"security.js","sourceRoot":"","sources":["../../../../src/cli/commands/security.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AAEpC,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;AAEhC,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,UAAkB;IACzD,EAAE,CAAC,IAAI,CAAC,uCAAuC,UAAU,KAAK,CAAC,CAAC;IAChE,MAAM,SAAS,GAAG;QACd,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,kCAAkC,EAAE,QAAQ,EAAE,MAAM,EAAE;QAClF,EAAE,OAAO,EAAE,qDAAqD,EAAE,OAAO,EAAE,qCAAqC,EAAE,QAAQ,EAAE,UAAU,EAAE;QACxI,EAAE,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,8BAA8B,EAAE,QAAQ,EAAE,QAAQ,EAAE;QACzF,EAAE,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,sCAAsC,EAAE,QAAQ,EAAE,QAAQ,EAAE;KACtG,CAAC;IACF,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;IAC7F,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;QAChB,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QAC3C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;YACtB,SAAS,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;gBACvB,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC1B,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,OAAO,OAAO,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACjG,CAAC;YACL,CAAC,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IACH,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,EAAE,CAAC,OAAO,CAAC,8BAA8B,CAAC,CAAC;IAC/C,CAAC;SAAM,CAAC;QACJ,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,KAAK,IAAI,CAAC,CAAC,CAAC;IAC1E,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,4 @@
+/**
+ * Print the current framework status.
+ */
+export declare function statusCommand(): Promise<void>;

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

@@ -0,0 +1,122 @@
+import chalk from "chalk";
+import fs from "fs";
+import path from "path";
+import { logger } from "../../shared/logger.js";
+import { getFrameworkDir, listTasks, readState, readStatus } from "../utils/memory.js";
+import { UI } from "../utils/ui.js";
+/**
+ * Print the current framework status.
+ */
+export async function statusCommand() {
+    const state = readState();
+    const tasks = listTasks();
+    const agentStatuses = readStatus();
+    const frameworkDir = getFrameworkDir();
+    if (!state) {
+        UI.error("Memory state not found. Please run 'init' first.");
+        return;
+    }
+    UI.info("--- PROJECT STATUS ---");
+    UI.info(`Phase: ${state.phase}`);
+    UI.info(`Trace ID: ${state.traceId}`);
+    UI.info(`Manager: ${state.managerState}`);
+    // --- Health Engine Integration ---
+    try {
+        const { HealthEngine } = await import("../../modules/engines/health-engine.js");
+        const health = HealthEngine.getHealth();
+        if (health) {
+            let healthColor = chalk.green;
+            if (health.score < 50)
+                healthColor = chalk.red;
+            else if (health.score < 80)
+                healthColor = chalk.yellow;
+            UI.info(`Project Health: ${healthColor(health.score + "%")} (Quality: ${health.codeQuality} | Security: ${health.security})`);
+        }
+    }
+    catch (err) {
+        logger.debug("Health engine not initialized or compiled yet", err);
+    }
+    // Read Agent Status from Storage
+    UI.info("Atabey AL Status (Agent States & Performance):");
+    const { Storage } = await import("../../shared/storage.js");
+    for (const [agentName, info] of Object.entries(agentStatuses)) {
+        const { state, task } = info;
+        let coloredState = state;
+        if (state === "READY")
+            coloredState = chalk.green(state);
+        else if (state === "EXECUTING")
+            coloredState = chalk.yellow(state);
+        else if (state === "BLOCKED" || state === "TIMEOUT")
+            coloredState = chalk.red(state);
+        else if (state === "WAITING")
+            coloredState = chalk.cyan(state);
+        // Calculate Success Rate from SQLite logs
+        let successRateStr = "";
+        const logs = Storage.getLogs(agentName);
+        const total = logs.length;
+        if (total > 0) {
+            const successCount = logs.filter(l => l.status === "SUCCESS").length;
+            const rate = (successCount / total) * 100;
+            successRateStr = ` | Success Rate: ${rate.toFixed(1)}% (${successCount}/${total})`;
+        }
+        process.stdout.write(`  ${chalk.bold(agentName.padEnd(12))} : [${coloredState}] - ${task}${successRateStr}\n`);
+    }
+    if (tasks.length > 0) {
+        UI.info("Active Tasks:");
+        tasks.forEach((t) => {
+            const agent = t.agent.startsWith("@") ? t.agent : `@${t.agent}`;
+            process.stdout.write(`  - [${t.priority}] ${t.status}: ${t.description} (${agent})\n`);
+        });
+    }
+    const metricsPath = path.join(frameworkDir, "observability", "metrics.json");
+    if (fs.existsSync(metricsPath)) {
+        try {
+            const rawMetrics = fs.readFileSync(metricsPath, "utf8");
+            const metrics = JSON.parse(rawMetrics);
+            let totalTokens = 0;
+            const agentTokens = {};
+            const now = new Date();
+            const sevenDaysAgo = new Date(now.getTime() - 7 * 24 * 60 * 60 * 1000);
+            let weeklyTokens = 0;
+            const weeklyAgentTokens = {};
+            metrics.forEach(m => {
+                totalTokens += m.estimatedTokens;
+                const name = m.agent.startsWith("@") ? m.agent : `@${m.agent}`;
+                agentTokens[name] = (agentTokens[name] || 0) + m.estimatedTokens;
+                // Track weekly tokens if entry falls within last 7 days
+                const entryDate = m.timestamp ? new Date(m.timestamp) : now;
+                if (entryDate >= sevenDaysAgo) {
+                    weeklyTokens += m.estimatedTokens;
+                    weeklyAgentTokens[name] = (weeklyAgentTokens[name] || 0) + m.estimatedTokens;
+                }
+            });
+            // Assume $5.00 per 1M tokens average pricing
+            const estimatedCost = (totalTokens / 1_000_000) * 5.00;
+            const estimatedWeeklyCost = (weeklyTokens / 1_000_000) * 5.00;
+            UI.info("OBSERVABILITY & COST DASHBOARD");
+            UI.info(`Total Estimated Tokens: ${totalTokens.toLocaleString()}`);
+            UI.info(`Total Estimated LLM Cost: $${estimatedCost.toFixed(4)}`);
+            UI.info(`Weekly Estimated Tokens (Last 7 days): ${weeklyTokens.toLocaleString()}`);
+            UI.info(`Weekly Estimated LLM Cost (Last 7 days): $${estimatedWeeklyCost.toFixed(4)}`);
+            if (Object.keys(agentTokens).length > 0) {
+                UI.info("Cost Distribution per Agent (Total):");
+                Object.entries(agentTokens).forEach(([agent, tokens]) => {
+                    const agentCost = (tokens / 1_000_000) * 5.00;
+                    process.stdout.write(`  ${chalk.bold(agent.padEnd(12))} : ${tokens.toLocaleString()} tokens ($${agentCost.toFixed(4)})\n`);
+                });
+            }
+            if (Object.keys(weeklyAgentTokens).length > 0) {
+                UI.info("Cost Distribution per Agent (Weekly - Last 7 days):");
+                Object.entries(weeklyAgentTokens).forEach(([agent, tokens]) => {
+                    const agentCost = (tokens / 1_000_000) * 5.00;
+                    process.stdout.write(`  ${chalk.bold(agent.padEnd(12))} : ${tokens.toLocaleString()} tokens ($${agentCost.toFixed(4)})\n`);
+                });
+            }
+        }
+        catch (err) {
+            logger.debug("Failed to read metrics file", err);
+        }
+    }
+    UI.divider();
+}
+//# sourceMappingURL=status.js.map

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

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

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

@@ -0,0 +1,10 @@
+/**
+ * Generate a new Trace ID and add it to project memory.
+ * Uses ULID format: 26-char Crockford Base32 (10 chars timestamp + 16 chars random)
+ */
+export declare function traceNewCommand(description: string, agent?: string, priority?: string): Promise<string | void>;
+/**
+ * Replay the chronological message exchanges of a specific Trace ID.
+ * Reads from SQLite messages table instead of filesystem.
+ */
+export declare function traceReplayCommand(traceId: string): Promise<void>;

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

@@ -0,0 +1,108 @@
+import { logger } from "../../shared/logger.js";
+import { Storage } from "../../shared/storage.js";
+import { stripMarkdownCodeBlocks } from "../../shared/string.js";
+import { generateULID, getFrameworkDir, updateDocumentStore } from "../utils/memory.js";
+import { normalizeAgentName, normalizePriority, sanitizeInput } from "../utils/string.js";
+import { UI } from "../utils/ui.js";
+/**
+ * Generate a new Trace ID and add it to project memory.
+ * Uses ULID format: 26-char Crockford Base32 (10 chars timestamp + 16 chars random)
+ */
+export async function traceNewCommand(description, agent = "manager", priority = "P2") {
+    const traceId = generateULID();
+    const safeDescription = sanitizeInput(description);
+    const safeAgent = normalizeAgentName(agent);
+    const safePriority = normalizePriority(priority);
+    const frameworkDir = getFrameworkDir();
+    // --- Document Store Write (SQLite) ---
+    updateDocumentStore("task", {
+        traceId,
+        description: safeDescription,
+        agent: safeAgent,
+        priority: safePriority,
+        status: "IN_PROGRESS",
+        createdAt: new Date().toISOString()
+    }, traceId, frameworkDir);
+    // ----------------------------
+    // Update active trace in metadata
+    Storage.setMetadata("traceId", traceId);
+    logger.info(`New Trace ID created: ${traceId}`);
+    UI.success(`New Trace ID created: ${traceId}`);
+    UI.intent("TASK", `Added to task list: ${description}`);
+    return traceId;
+}
+/**
+ * Replay the chronological message exchanges of a specific Trace ID.
+ * Reads from SQLite messages table instead of filesystem.
+ */
+export async function traceReplayCommand(traceId) {
+    const { UI } = await import("../utils/ui.js");
+    UI.intent("Trace Replay Engine", `Searching logs for Trace ID: ${traceId}...`);
+    const events = [];
+    // Read from SQLite messages table
+    try {
+        const db = Storage.getDB();
+        const rows = db.prepare("SELECT timestamp, sender, receiver, category, content, priority FROM messages WHERE trace_id = ? ORDER BY timestamp ASC").all(traceId);
+        for (const row of rows) {
+            events.push({
+                timestamp: row.timestamp,
+                from: row.sender,
+                to: row.receiver,
+                category: row.category,
+                content: row.content,
+                priority: row.priority,
+            });
+        }
+    }
+    catch (err) {
+        logger.debug("Failed to read from SQLite messages", err);
+    }
+    // Also read from logs table for agent actions
+    try {
+        const logs = Storage.getLogs();
+        for (const log of logs) {
+            if (log.trace_id === traceId) {
+                events.push({
+                    timestamp: log.timestamp,
+                    from: log.agent,
+                    to: "@manager",
+                    category: "ACTION",
+                    content: log.summary,
+                });
+            }
+        }
+    }
+    catch (err) {
+        logger.debug("Failed to read from SQLite logs", err);
+    }
+    if (events.length === 0) {
+        UI.warning(`No message exchanges found for Trace ID: ${traceId}`);
+        return;
+    }
+    // Sort chronologically by timestamp
+    events.sort((a, b) => Date.parse(a.timestamp) - Date.parse(b.timestamp));
+    const separatorLine = "=".repeat(80);
+    process.stdout.write(`\n${separatorLine}\n`);
+    process.stdout.write(`[TRACE TIMELINE REPLAY] ID: ${traceId}\n`);
+    process.stdout.write(`${separatorLine}\n`);
+    events.forEach(evt => {
+        const timeStr = new Date(evt.timestamp).toLocaleTimeString();
+        process.stdout.write(`[${timeStr}] ${evt.from} ➔ ${evt.to} [${evt.category}]\n`);
+        try {
+            const cleanedContent = stripMarkdownCodeBlocks(evt.content);
+            const parsed = JSON.parse(cleanedContent);
+            if (parsed.task) {
+                process.stdout.write(`  💬 Task: ${parsed.task}\n`);
+            }
+            else {
+                process.stdout.write(`  💬 Content: ${evt.content.substring(0, 200)}\n`);
+            }
+        }
+        catch {
+            process.stdout.write(`  💬 Content: ${evt.content.substring(0, 200)}\n`);
+        }
+    });
+    process.stdout.write(`${separatorLine}\n`);
+    UI.success(`Trace replay completed (${events.length} events).`);
+}
+//# sourceMappingURL=trace.js.map

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

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

package/dist/src/cli/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};