@aiagentflow/cli 0.1.0

package/dist/core/workflow/runner.js

@@ -0,0 +1,273 @@
+/**
+ * Workflow runner — orchestrates agents through the workflow engine.
+ *
+ * This is the main "brain" that:
+ * 1. Creates a workflow context for a task
+ * 2. Determines which agent to run next
+ * 3. Executes agents and feeds output to the workflow engine
+ * 4. Handles transitions, loops, and terminal states
+ * 5. Tracks token usage and persists session state
+ *
+ * Dependency direction: runner.ts → engine, agents/factory, git/client, config
+ * Used by: cli/commands/run.ts
+ */
+import chalk from 'chalk';
+import ora from 'ora';
+import { createWorkflowContext, transition, isTerminal, getNextAgent, } from './engine.js';
+import { createAgent } from '../../agents/factory.js';
+import { GitClient } from '../../git/client.js';
+import { parseAndWriteFiles } from './file-parser.js';
+import { runTests } from './test-runner.js';
+import { requestApproval, needsApproval } from './approval.js';
+import { TokenTracker } from './token-tracker.js';
+import { saveSession } from './session.js';
+import { loadQAPolicy, evaluateReview, formatPolicyForAgent } from './qa-policy.js';
+import { loadConfig } from '../config/manager.js';
+import { logger } from '../../utils/logger.js';
+import { WorkflowError } from '../errors.js';
+/**
+ * Run a full workflow for a task.
+ *
+ * Orchestrates the agent pipeline: Architect → Coder → Reviewer → Tester → Fixer → Judge.
+ * Returns the final workflow context with all accumulated data.
+ */
+export async function runWorkflow(options) {
+    const { projectRoot, task, auto = false } = options;
+    const config = loadConfig(projectRoot);
+    const tokenTracker = new TokenTracker();
+    const qaPolicy = loadQAPolicy(projectRoot);
+    logger.header('AI Workflow — Running Task');
+    console.log(chalk.gray(`Task: ${task}`));
+    if (auto) {
+        console.log(chalk.yellow('⚡ Autonomous mode — no human approval required'));
+    }
+    console.log();
+    // Optional: create a Git branch for this task
+    if (config.workflow.autoCreateBranch) {
+        const git = new GitClient(projectRoot);
+        const isRepo = await git.isRepo();
+        if (isRepo) {
+            const branchName = GitClient.toBranchName(config.workflow.branchPrefix, task);
+            await git.createBranch(branchName);
+        }
+    }
+    // Create workflow context
+    let ctx = createWorkflowContext(task, config.workflow.maxIterations);
+    let sessionId;
+    let lastOutput = '';
+    try {
+        // Main workflow loop
+        while (!isTerminal(ctx)) {
+            const agentRole = getNextAgent(ctx);
+            if (!agentRole) {
+                if (ctx.state === 'qa_approved') {
+                    logger.success('Workflow complete!');
+                    break;
+                }
+                logger.warn('No agent mapped to current state — stopping.');
+                break;
+            }
+            const agent = createAgent(agentRole, config, projectRoot);
+            const agentConfig = config.agents[agentRole];
+            const spinner = ora(`Running ${agentRole} agent...`).start();
+            try {
+                const output = await agent.execute({
+                    task: ctx.task,
+                    context: buildAgentContext(ctx, qaPolicy),
+                    previousOutput: getLatestOutput(ctx),
+                });
+                spinner.succeed(`${agentRole} complete (${output.tokensUsed} tokens)`);
+                lastOutput = output.content;
+                // Track token usage
+                tokenTracker.record(agentRole, agentConfig.model, {
+                    promptTokens: 0, // TODO: Get from provider response
+                    completionTokens: output.tokensUsed,
+                    totalTokens: output.tokensUsed,
+                });
+                // Transition based on agent output
+                ctx = await applyAgentOutput(ctx, agentRole, output.content, config, projectRoot, qaPolicy);
+            }
+            catch (err) {
+                spinner.fail(`${agentRole} failed`);
+                if (err instanceof WorkflowError)
+                    throw err;
+                logger.error(err instanceof Error ? err.message : String(err));
+                ctx = transition(ctx, { type: 'ABORT', payload: { reason: String(err) } });
+            }
+            // Save session after each step (crash recovery)
+            sessionId = saveSession(projectRoot, ctx, tokenTracker.getEntries(), sessionId);
+            // Human approval gate (skipped in autonomous mode)
+            const shouldApprove = !auto && needsApproval(config.workflow.humanApproval, ctx.state);
+            if (shouldApprove && !isTerminal(ctx)) {
+                const decision = await requestApproval(ctx, agentRole, lastOutput);
+                if (decision === 'abort') {
+                    ctx = transition(ctx, { type: 'ABORT', payload: { reason: 'User aborted' } });
+                }
+                else if (decision === 'retry') {
+                    logger.info('Retrying agent...');
+                }
+            }
+        }
+    }
+    catch (err) {
+        logger.error(`Workflow failed: ${err instanceof Error ? err.message : String(err)}`);
+        if (!isTerminal(ctx)) {
+            ctx = transition(ctx, { type: 'ABORT', payload: { reason: String(err) } });
+        }
+    }
+    // Final save
+    saveSession(projectRoot, ctx, tokenTracker.getEntries(), sessionId);
+    // Print summaries
+    printWorkflowSummary(ctx);
+    tokenTracker.printSummary();
+    return ctx;
+}
+// ── Private helpers ──
+/** Build context string for the current agent based on workflow state. */
+function buildAgentContext(ctx, qaPolicy) {
+    const parts = [];
+    if (ctx.spec)
+        parts.push(`## Spec\n${ctx.spec}`);
+    if (ctx.plan)
+        parts.push(`## Plan\n${ctx.plan}`);
+    if (ctx.reviewFeedback)
+        parts.push(`## Review Feedback\n${ctx.reviewFeedback}`);
+    if (ctx.testFailures)
+        parts.push(`## Test Failures\n${ctx.testFailures}`);
+    if (ctx.generatedFiles.length > 0) {
+        parts.push(`## Modified Files\n${ctx.generatedFiles.join('\n')}`);
+    }
+    // Include QA policy for the judge agent
+    if (qaPolicy && ctx.state === 'tests_passed') {
+        parts.push(formatPolicyForAgent(qaPolicy));
+    }
+    return parts.join('\n\n');
+}
+/** Get the most recent output relevant to the next agent. */
+function getLatestOutput(ctx) {
+    if (ctx.spec && ctx.state === 'spec_created')
+        return ctx.spec;
+    if (ctx.plan && ctx.state === 'plan_approved')
+        return ctx.plan;
+    if (ctx.reviewFeedback)
+        return ctx.reviewFeedback;
+    if (ctx.testFailures)
+        return ctx.testFailures;
+    return undefined;
+}
+/**
+ * Apply an agent's output to the workflow context via state transition.
+ */
+async function applyAgentOutput(ctx, role, content, config, projectRoot, qaPolicy) {
+    switch (role) {
+        case 'architect':
+            if (ctx.state === 'idle') {
+                ctx = transition(ctx, { type: 'SPEC_READY', payload: { spec: content } });
+                ctx = transition(ctx, { type: 'PLAN_APPROVED', payload: { plan: content } });
+            }
+            return ctx;
+        case 'coder': {
+            const files = parseAndWriteFiles(projectRoot, content);
+            return transition(ctx, {
+                type: 'CODE_GENERATED',
+                payload: { files: files.length > 0 ? files : ['(no files parsed)'] },
+            });
+        }
+        case 'reviewer': {
+            const upper = content.toUpperCase();
+            const reviewApproved = upper.includes('APPROVE') &&
+                !upper.includes('REQUEST_CHANGES') &&
+                !upper.includes('REJECT');
+            // Evaluate review against QA policy (informational when reviewer approves)
+            const evaluation = evaluateReview(content, qaPolicy);
+            if (evaluation.totalIssues > 0) {
+                logger.info(`QA policy: ${evaluation.criticalCount} critical, ${evaluation.warningCount} warning(s), ${evaluation.totalIssues - evaluation.criticalCount - evaluation.warningCount} nit(s)`);
+            }
+            // Trust the reviewer's explicit verdict.
+            // QA policy only blocks when the reviewer did NOT approve.
+            const approved = reviewApproved;
+            return transition(ctx, { type: 'REVIEW_DONE', payload: { approved, feedback: content } });
+        }
+        case 'tester': {
+            const testFiles = parseAndWriteFiles(projectRoot, content);
+            ctx = transition(ctx, {
+                type: 'TESTS_WRITTEN',
+                payload: { testFiles: testFiles.length > 0 ? testFiles : ['(no test files parsed)'] },
+            });
+            // Auto-run tests and transition based on results
+            if (config.workflow.autoRunTests) {
+                const testResult = await runTests(projectRoot);
+                if (testResult.passed) {
+                    ctx = transition(ctx, { type: 'TESTS_PASSED' });
+                }
+                else {
+                    ctx = transition(ctx, { type: 'TESTS_FAILED', payload: { failures: testResult.output } });
+                }
+            }
+            else {
+                // Skip test execution — assume tests pass
+                ctx = transition(ctx, { type: 'TESTS_PASSED' });
+            }
+            return ctx;
+        }
+        case 'fixer': {
+            const fixedFiles = parseAndWriteFiles(projectRoot, content);
+            ctx = transition(ctx, {
+                type: 'FIX_APPLIED',
+                payload: { files: fixedFiles.length > 0 ? fixedFiles : ['(no files parsed)'] },
+            });
+            // Auto-transition back to code_generated for re-review
+            return transition(ctx, {
+                type: 'CODE_GENERATED',
+                payload: { files: fixedFiles.length > 0 ? fixedFiles : ['(no files parsed)'] },
+            });
+        }
+        case 'judge': {
+            const passed = content.toUpperCase().includes('PASS') &&
+                !content.toUpperCase().includes('FAIL');
+            if (passed) {
+                return transition(ctx, { type: 'QA_APPROVED' });
+            }
+            else {
+                return transition(ctx, { type: 'QA_REJECTED', payload: { reason: content } });
+            }
+        }
+        default:
+            return ctx;
+    }
+}
+/** Print a colored summary of the workflow execution. */
+function printWorkflowSummary(ctx) {
+    console.log();
+    logger.header('Workflow Summary');
+    console.log(chalk.gray(`Task: ${ctx.task}`));
+    console.log(chalk.gray(`Final state: ${ctx.state}`));
+    console.log(chalk.gray(`Iterations: ${ctx.iteration}/${ctx.maxIterations}`));
+    console.log(chalk.gray(`Steps: ${ctx.history.length}`));
+    if (ctx.generatedFiles.length > 0) {
+        console.log();
+        console.log(chalk.bold('  Files modified:'));
+        for (const file of ctx.generatedFiles) {
+            console.log(chalk.gray(`    ${file}`));
+        }
+    }
+    if (ctx.history.length > 0) {
+        console.log();
+        console.log(chalk.bold('  State transitions:'));
+        for (const step of ctx.history) {
+            const arrow = step.to === 'failed' ? chalk.red('→') : chalk.green('→');
+            console.log(chalk.gray(`    ${step.from} ${arrow} ${chalk.white(step.to)} (${step.event})`));
+        }
+    }
+    console.log();
+    if (ctx.state === 'complete' || ctx.state === 'qa_approved') {
+        logger.success('Task completed successfully!');
+    }
+    else if (ctx.state === 'failed') {
+        logger.error('Task failed.');
+    }
+    else {
+        logger.warn(`Task stopped in state: ${ctx.state}`);
+    }
+}
+//# sourceMappingURL=runner.js.map

package/dist/core/workflow/runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../../src/core/workflow/runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,EACH,qBAAqB,EACrB,UAAU,EACV,UAAU,EACV,YAAY,GAEf,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,oBAAoB,EAAiB,MAAM,gBAAgB,CAAC;AACnG,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAW7C;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAmB;IACjD,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IACpD,MAAM,MAAM,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;IACvC,MAAM,YAAY,GAAG,IAAI,YAAY,EAAE,CAAC;IACxC,MAAM,QAAQ,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;IAE3C,MAAM,CAAC,MAAM,CAAC,4BAA4B,CAAC,CAAC;IAC5C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,CAAC;IACzC,IAAI,IAAI,EAAE,CAAC;QACP,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,gDAAgD,CAAC,CAAC,CAAC;IAChF,CAAC;IACD,OAAO,CAAC,GAAG,EAAE,CAAC;IAEd,8CAA8C;IAC9C,IAAI,MAAM,CAAC,QAAQ,CAAC,gBAAgB,EAAE,CAAC;QACnC,MAAM,GAAG,GAAG,IAAI,SAAS,CAAC,WAAW,CAAC,CAAC;QACvC,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,EAAE,CAAC;QAElC,IAAI,MAAM,EAAE,CAAC;YACT,MAAM,UAAU,GAAG,SAAS,CAAC,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;YAC9E,MAAM,GAAG,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;QACvC,CAAC;IACL,CAAC;IAED,0BAA0B;IAC1B,IAAI,GAAG,GAAG,qBAAqB,CAAC,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;IACrE,IAAI,SAA6B,CAAC;IAClC,IAAI,UAAU,GAAG,EAAE,CAAC;IAEpB,IAAI,CAAC;QACD,qBAAqB;QACrB,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,SAAS,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;YAEpC,IAAI,CAAC,SAAS,EAAE,CAAC;gBACb,IAAI,GAAG,CAAC,KAAK,KAAK,aAAa,EAAE,CAAC;oBAC9B,MAAM,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;oBACrC,MAAM;gBACV,CAAC;gBACD,MAAM,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;gBAC5D,MAAM;YACV,CAAC;YAED,MAAM,KAAK,GAAG,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;YAC1D,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAC7C,MAAM,OAAO,GAAG,GAAG,CAAC,WAAW,SAAS,WAAW,CAAC,CAAC,KAAK,EAAE,CAAC;YAE7D,IAAI,CAAC;gBACD,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC;oBAC/B,IAAI,EAAE,GAAG,CAAC,IAAI;oBACd,OAAO,EAAE,iBAAiB,CAAC,GAAG,EAAE,QAAQ,CAAC;oBACzC,cAAc,EAAE,eAAe,CAAC,GAAG,CAAC;iBACvC,CAAC,CAAC;gBAEH,OAAO,CAAC,OAAO,CAAC,GAAG,SAAS,cAAc,MAAM,CAAC,UAAU,UAAU,CAAC,CAAC;gBACvE,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC;gBAE5B,oBAAoB;gBACpB,YAAY,CAAC,MAAM,CAAC,SAAS,EAAE,WAAW,CAAC,KAAK,EAAE;oBAC9C,YAAY,EAAE,CAAC,EAAE,mCAAmC;oBACpD,gBAAgB,EAAE,MAAM,CAAC,UAAU;oBACnC,WAAW,EAAE,MAAM,CAAC,UAAU;iBACjC,CAAC,CAAC;gBAEH,mCAAmC;gBACnC,GAAG,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;YAChG,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACX,OAAO,CAAC,IAAI,CAAC,GAAG,SAAS,SAAS,CAAC,CAAC;gBAEpC,IAAI,GAAG,YAAY,aAAa;oBAAE,MAAM,GAAG,CAAC;gBAC5C,MAAM,CAAC,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;gBAE/D,GAAG,GAAG,UAAU,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;YAC/E,CAAC;YAED,gDAAgD;YAChD,SAAS,GAAG,WAAW,CAAC,WAAW,EAAE,GAAG,EAAE,YAAY,CAAC,UAAU,EAAW,EAAE,SAAS,CAAC,CAAC;YAEzF,mDAAmD;YACnD,MAAM,aAAa,GAAG,CAAC,IAAI,IAAI,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;YACvF,IAAI,aAAa,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACpC,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,GAAG,EAAE,SAAU,EAAE,UAAU,CAAC,CAAC;gBAEpE,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;oBACvB,GAAG,GAAG,UAAU,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,EAAE,CAAC,CAAC;gBAClF,CAAC;qBAAM,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;oBAC9B,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;gBACrC,CAAC;YACL,CAAC;QACL,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,MAAM,CAAC,KAAK,CAAC,oBAAoB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACrF,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACnB,GAAG,GAAG,UAAU,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;QAC/E,CAAC;IACL,CAAC;IAED,aAAa;IACb,WAAW,CAAC,WAAW,EAAE,GAAG,EAAE,YAAY,CAAC,UAAU,EAAW,EAAE,SAAS,CAAC,CAAC;IAE7E,kBAAkB;IAClB,oBAAoB,CAAC,GAAG,CAAC,CAAC;IAC1B,YAAY,CAAC,YAAY,EAAE,CAAC;IAE5B,OAAO,GAAG,CAAC;AACf,CAAC;AAED,wBAAwB;AAExB,0EAA0E;AAC1E,SAAS,iBAAiB,CAAC,GAAoB,EAAE,QAAmB;IAChE,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,GAAG,CAAC,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,YAAY,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IACjD,IAAI,GAAG,CAAC,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,YAAY,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IACjD,IAAI,GAAG,CAAC,cAAc;QAAE,KAAK,CAAC,IAAI,CAAC,uBAAuB,GAAG,CAAC,cAAc,EAAE,CAAC,CAAC;IAChF,IAAI,GAAG,CAAC,YAAY;QAAE,KAAK,CAAC,IAAI,CAAC,qBAAqB,GAAG,CAAC,YAAY,EAAE,CAAC,CAAC;IAC1E,IAAI,GAAG,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,sBAAsB,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACtE,CAAC;IAED,wCAAwC;IACxC,IAAI,QAAQ,IAAI,GAAG,CAAC,KAAK,KAAK,cAAc,EAAE,CAAC;QAC3C,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC/C,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC9B,CAAC;AAED,6DAA6D;AAC7D,SAAS,eAAe,CAAC,GAAoB;IACzC,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,KAAK,KAAK,cAAc;QAAE,OAAO,GAAG,CAAC,IAAI,CAAC;IAC9D,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,KAAK,KAAK,eAAe;QAAE,OAAO,GAAG,CAAC,IAAI,CAAC;IAC/D,IAAI,GAAG,CAAC,cAAc;QAAE,OAAO,GAAG,CAAC,cAAc,CAAC;IAClD,IAAI,GAAG,CAAC,YAAY;QAAE,OAAO,GAAG,CAAC,YAAY,CAAC;IAC9C,OAAO,SAAS,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,gBAAgB,CAC3B,GAAoB,EACpB,IAAY,EACZ,OAAe,EACf,MAAiB,EACjB,WAAmB,EACnB,QAAkB;IAElB,QAAQ,IAAI,EAAE,CAAC;QACX,KAAK,WAAW;YACZ,IAAI,GAAG,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;gBACvB,GAAG,GAAG,UAAU,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;gBAC1E,GAAG,GAAG,UAAU,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;YACjF,CAAC;YACD,OAAO,GAAG,CAAC;QAEf,KAAK,OAAO,CAAC,CAAC,CAAC;YACX,MAAM,KAAK,GAAG,kBAAkB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YACvD,OAAO,UAAU,CAAC,GAAG,EAAE;gBACnB,IAAI,EAAE,gBAAgB;gBACtB,OAAO,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,EAAE;aACvE,CAAC,CAAC;QACP,CAAC;QAED,KAAK,UAAU,CAAC,CAAC,CAAC;YACd,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;YACpC,MAAM,cAAc,GAAG,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC;gBAC5C,CAAC,KAAK,CAAC,QAAQ,CAAC,iBAAiB,CAAC;gBAClC,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAE9B,2EAA2E;YAC3E,MAAM,UAAU,GAAG,cAAc,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YACrD,IAAI,UAAU,CAAC,WAAW,GAAG,CAAC,EAAE,CAAC;gBAC7B,MAAM,CAAC,IAAI,CAAC,cAAc,UAAU,CAAC,aAAa,cAAc,UAAU,CAAC,YAAY,gBAAgB,UAAU,CAAC,WAAW,GAAG,UAAU,CAAC,aAAa,GAAG,UAAU,CAAC,YAAY,SAAS,CAAC,CAAC;YACjM,CAAC;YAED,yCAAyC;YACzC,2DAA2D;YAC3D,MAAM,QAAQ,GAAG,cAAc,CAAC;YAChC,OAAO,UAAU,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;QAC9F,CAAC;QAED,KAAK,QAAQ,CAAC,CAAC,CAAC;YACZ,MAAM,SAAS,GAAG,kBAAkB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YAC3D,GAAG,GAAG,UAAU,CAAC,GAAG,EAAE;gBAClB,IAAI,EAAE,eAAe;gBACrB,OAAO,EAAE,EAAE,SAAS,EAAE,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,wBAAwB,CAAC,EAAE;aACxF,CAAC,CAAC;YAEH,iDAAiD;YACjD,IAAI,MAAM,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC;gBAC/B,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,WAAW,CAAC,CAAC;gBAC/C,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;oBACpB,GAAG,GAAG,UAAU,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC;gBACpD,CAAC;qBAAM,CAAC;oBACJ,GAAG,GAAG,UAAU,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;gBAC9F,CAAC;YACL,CAAC;iBAAM,CAAC;gBACJ,0CAA0C;gBAC1C,GAAG,GAAG,UAAU,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC;YACpD,CAAC;YAED,OAAO,GAAG,CAAC;QACf,CAAC;QAED,KAAK,OAAO,CAAC,CAAC,CAAC;YACX,MAAM,UAAU,GAAG,kBAAkB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YAC5D,GAAG,GAAG,UAAU,CAAC,GAAG,EAAE;gBAClB,IAAI,EAAE,aAAa;gBACnB,OAAO,EAAE,EAAE,KAAK,EAAE,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,EAAE;aACjF,CAAC,CAAC;YACH,uDAAuD;YACvD,OAAO,UAAU,CAAC,GAAG,EAAE;gBACnB,IAAI,EAAE,gBAAgB;gBACtB,OAAO,EAAE,EAAE,KAAK,EAAE,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,EAAE;aACjF,CAAC,CAAC;QACP,CAAC;QAED,KAAK,OAAO,CAAC,CAAC,CAAC;YACX,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC;gBACjD,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YAC5C,IAAI,MAAM,EAAE,CAAC;gBACT,OAAO,UAAU,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC;YACpD,CAAC;iBAAM,CAAC;gBACJ,OAAO,UAAU,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;YAClF,CAAC;QACL,CAAC;QAED;YACI,OAAO,GAAG,CAAC;IACnB,CAAC;AACL,CAAC;AAED,yDAAyD;AACzD,SAAS,oBAAoB,CAAC,GAAoB;IAC9C,OAAO,CAAC,GAAG,EAAE,CAAC;IACd,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC;IAClC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC7C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,gBAAgB,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACrD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,eAAe,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;IAC7E,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAExD,IAAI,GAAG,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,OAAO,CAAC,GAAG,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,CAAC;QAC7C,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,cAAc,EAAE,CAAC;YACpC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC;QAC3C,CAAC;IACL,CAAC;IAED,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC,CAAC;QAChD,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;YAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACvE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,IAAI,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QACjG,CAAC;IACL,CAAC;IAED,OAAO,CAAC,GAAG,EAAE,CAAC;IACd,IAAI,GAAG,CAAC,KAAK,KAAK,UAAU,IAAI,GAAG,CAAC,KAAK,KAAK,aAAa,EAAE,CAAC;QAC1D,MAAM,CAAC,OAAO,CAAC,8BAA8B,CAAC,CAAC;IACnD,CAAC;SAAM,IAAI,GAAG,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChC,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IACjC,CAAC;SAAM,CAAC;QACJ,MAAM,CAAC,IAAI,CAAC,0BAA0B,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;IACvD,CAAC;AACL,CAAC"}

package/dist/core/workflow/session.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Session persistence — save and resume workflow state.
+ *
+ * Saves the workflow context to `.aiagentflow/sessions/` so workflows
+ * can survive crashes, restarts, and be resumed later.
+ *
+ * Dependency direction: session.ts → utils/fs, core/errors
+ * Used by: workflow runner
+ */
+import type { WorkflowContext } from './engine.js';
+import type { TokenUsageEntry } from './token-tracker.js';
+/** Persisted session data. */
+export interface SessionData {
+    /** Unique session ID. */
+    id: string;
+    /** When the session was created. */
+    createdAt: number;
+    /** When the session was last updated. */
+    updatedAt: number;
+    /** The workflow context snapshot. */
+    context: WorkflowContext;
+    /** Token usage entries. */
+    tokenUsage: TokenUsageEntry[];
+}
+/**
+ * Save a workflow session to disk.
+ */
+export declare function saveSession(projectRoot: string, context: WorkflowContext, tokenUsage?: TokenUsageEntry[], sessionId?: string): string;
+/**
+ * Load a workflow session from disk.
+ */
+export declare function loadSession(projectRoot: string, sessionId: string): SessionData | null;
+/**
+ * List all saved sessions for a project.
+ */
+export declare function listSessions(projectRoot: string): SessionData[];
+//# sourceMappingURL=session.d.ts.map

package/dist/core/workflow/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../src/core/workflow/session.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAI1D,8BAA8B;AAC9B,MAAM,WAAW,WAAW;IACxB,yBAAyB;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,OAAO,EAAE,eAAe,CAAC;IACzB,2BAA2B;IAC3B,UAAU,EAAE,eAAe,EAAE,CAAC;CACjC;AAsBD;;GAEG;AACH,wBAAgB,WAAW,CACvB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,eAAe,EACxB,UAAU,GAAE,eAAe,EAAO,EAClC,SAAS,CAAC,EAAE,MAAM,GACnB,MAAM,CAqBR;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CActF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,EAAE,CAoB/D"}

package/dist/core/workflow/session.js

@@ -0,0 +1,93 @@
+/**
+ * Session persistence — save and resume workflow state.
+ *
+ * Saves the workflow context to `.aiagentflow/sessions/` so workflows
+ * can survive crashes, restarts, and be resumed later.
+ *
+ * Dependency direction: session.ts → utils/fs, core/errors
+ * Used by: workflow runner
+ */
+import { join } from 'node:path';
+import { existsSync, readdirSync } from 'node:fs';
+import { CONFIG_DIR_NAME } from '../config/defaults.js';
+import { ensureDir, readTextFile, writeJsonFile } from '../../utils/fs.js';
+import { logger } from '../../utils/logger.js';
+const SESSIONS_DIR = 'sessions';
+/**
+ * Get the sessions directory path.
+ */
+function getSessionsDir(projectRoot) {
+    return join(projectRoot, CONFIG_DIR_NAME, SESSIONS_DIR);
+}
+/**
+ * Generate a short session ID from the task description.
+ */
+function generateSessionId(task) {
+    const timestamp = Date.now().toString(36);
+    const slug = task
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .slice(0, 30);
+    return `${slug}-${timestamp}`;
+}
+/**
+ * Save a workflow session to disk.
+ */
+export function saveSession(projectRoot, context, tokenUsage = [], sessionId) {
+    const sessionsDir = getSessionsDir(projectRoot);
+    ensureDir(sessionsDir);
+    const id = sessionId ?? generateSessionId(context.task);
+    const sessionPath = join(sessionsDir, `${id}.json`);
+    const data = {
+        id,
+        createdAt: existsSync(sessionPath)
+            ? loadSession(projectRoot, id)?.createdAt ?? Date.now()
+            : Date.now(),
+        updatedAt: Date.now(),
+        context,
+        tokenUsage,
+    };
+    writeJsonFile(sessionPath, data);
+    logger.debug(`Session saved: ${id}`);
+    return id;
+}
+/**
+ * Load a workflow session from disk.
+ */
+export function loadSession(projectRoot, sessionId) {
+    const sessionPath = join(getSessionsDir(projectRoot), `${sessionId}.json`);
+    if (!existsSync(sessionPath)) {
+        return null;
+    }
+    try {
+        const content = readTextFile(sessionPath);
+        return JSON.parse(content);
+    }
+    catch {
+        logger.warn(`Failed to load session: ${sessionId}`);
+        return null;
+    }
+}
+/**
+ * List all saved sessions for a project.
+ */
+export function listSessions(projectRoot) {
+    const sessionsDir = getSessionsDir(projectRoot);
+    if (!existsSync(sessionsDir)) {
+        return [];
+    }
+    const files = readdirSync(sessionsDir).filter(f => f.endsWith('.json'));
+    const sessions = [];
+    for (const file of files) {
+        try {
+            const content = readTextFile(join(sessionsDir, file));
+            sessions.push(JSON.parse(content));
+        }
+        catch {
+            // Skip corrupted session files
+        }
+    }
+    return sessions.sort((a, b) => b.updatedAt - a.updatedAt);
+}
+//# sourceMappingURL=session.js.map

package/dist/core/workflow/session.js.map

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

package/dist/core/workflow/task-queue.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Task queue — manages multiple workflow tasks in sequence.
+ *
+ * Allows users to feed multiple tasks at once. The queue processes
+ * them one by one, tracking results and continuing on failure.
+ *
+ * Dependency direction: task-queue.ts → workflow/runner, core/errors, utils
+ * Used by: cli/commands/run.ts (batch mode)
+ */
+import type { WorkflowContext } from './engine.js';
+/** A task in the queue with its result. */
+export interface QueuedTask {
+    /** Task description. */
+    task: string;
+    /** Current status. */
+    status: 'pending' | 'running' | 'completed' | 'failed' | 'skipped';
+    /** Workflow context after execution. */
+    result?: WorkflowContext;
+    /** Error message if failed. */
+    error?: string;
+    /** Duration in milliseconds. */
+    duration?: number;
+}
+/** Options for running a task queue. */
+export interface QueueOptions {
+    /** Project root directory. */
+    projectRoot: string;
+    /** List of task descriptions. */
+    tasks: string[];
+    /** Skip human approval between tasks. */
+    auto?: boolean;
+    /** Stop the queue on first failure. */
+    stopOnFailure?: boolean;
+}
+/**
+ * Run multiple tasks in sequence.
+ *
+ * Returns the queue with all results after completion.
+ */
+export declare function runTaskQueue(options: QueueOptions): Promise<QueuedTask[]>;
+/**
+ * Parse a task list from a file or string.
+ * Each line is a separate task. Empty lines and comments (#) are skipped.
+ */
+export declare function parseTasks(input: string): string[];
+//# sourceMappingURL=task-queue.d.ts.map

package/dist/core/workflow/task-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-queue.d.ts","sourceRoot":"","sources":["../../../src/core/workflow/task-queue.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGnD,2CAA2C;AAC3C,MAAM,WAAW,UAAU;IACvB,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,sBAAsB;IACtB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;IACnE,wCAAwC;IACxC,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wCAAwC;AACxC,MAAM,WAAW,YAAY;IACzB,8BAA8B;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,iCAAiC;IACjC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,yCAAyC;IACzC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,uCAAuC;IACvC,aAAa,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAgE/E;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAKlD"}

package/dist/core/workflow/task-queue.js

@@ -0,0 +1,106 @@
+/**
+ * Task queue — manages multiple workflow tasks in sequence.
+ *
+ * Allows users to feed multiple tasks at once. The queue processes
+ * them one by one, tracking results and continuing on failure.
+ *
+ * Dependency direction: task-queue.ts → workflow/runner, core/errors, utils
+ * Used by: cli/commands/run.ts (batch mode)
+ */
+import chalk from 'chalk';
+import { runWorkflow } from './runner.js';
+import { logger } from '../../utils/logger.js';
+/**
+ * Run multiple tasks in sequence.
+ *
+ * Returns the queue with all results after completion.
+ */
+export async function runTaskQueue(options) {
+    const { projectRoot, tasks, auto = false, stopOnFailure = false } = options;
+    const queue = tasks.map(task => ({
+        task,
+        status: 'pending',
+    }));
+    logger.header('AI Workflow — Task Queue');
+    console.log(chalk.gray(`${queue.length} task(s) queued`));
+    if (auto)
+        console.log(chalk.yellow('⚡ Autonomous mode'));
+    console.log();
+    for (let i = 0; i < queue.length; i++) {
+        const item = queue[i];
+        console.log(chalk.bold(`\n── Task ${i + 1}/${queue.length} ──`));
+        console.log(chalk.gray(item.task));
+        console.log();
+        item.status = 'running';
+        const startTime = Date.now();
+        try {
+            const result = await runWorkflow({
+                projectRoot,
+                task: item.task,
+                auto,
+            });
+            item.result = result;
+            item.duration = Date.now() - startTime;
+            if (result.state === 'failed') {
+                item.status = 'failed';
+                item.error = 'Workflow ended in failed state';
+                if (stopOnFailure) {
+                    // Mark remaining tasks as skipped
+                    for (let j = i + 1; j < queue.length; j++) {
+                        queue[j].status = 'skipped';
+                    }
+                    break;
+                }
+            }
+            else {
+                item.status = 'completed';
+            }
+        }
+        catch (err) {
+            item.status = 'failed';
+            item.error = err instanceof Error ? err.message : String(err);
+            item.duration = Date.now() - startTime;
+            if (stopOnFailure) {
+                for (let j = i + 1; j < queue.length; j++) {
+                    queue[j].status = 'skipped';
+                }
+                break;
+            }
+        }
+    }
+    // Print queue summary
+    printQueueSummary(queue);
+    return queue;
+}
+/**
+ * Parse a task list from a file or string.
+ * Each line is a separate task. Empty lines and comments (#) are skipped.
+ */
+export function parseTasks(input) {
+    return input
+        .split('\n')
+        .map(line => line.trim())
+        .filter(line => line.length > 0 && !line.startsWith('#'));
+}
+/** Print a colored summary of the queue results. */
+function printQueueSummary(queue) {
+    console.log();
+    logger.header('Queue Summary');
+    const completed = queue.filter(t => t.status === 'completed').length;
+    const failed = queue.filter(t => t.status === 'failed').length;
+    const skipped = queue.filter(t => t.status === 'skipped').length;
+    for (const item of queue) {
+        const icon = item.status === 'completed' ? chalk.green('✔')
+            : item.status === 'failed' ? chalk.red('✘')
+                : item.status === 'skipped' ? chalk.gray('○')
+                    : chalk.yellow('…');
+        const duration = item.duration ? chalk.gray(` (${(item.duration / 1000).toFixed(1)}s)`) : '';
+        console.log(`  ${icon} ${item.task}${duration}`);
+        if (item.error) {
+            console.log(chalk.red(`    Error: ${item.error}`));
+        }
+    }
+    console.log();
+    console.log(chalk.bold(`  ${completed} completed, ${failed} failed, ${skipped} skipped`));
+}
+//# sourceMappingURL=task-queue.js.map

package/dist/core/workflow/task-queue.js.map

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

package/dist/core/workflow/test-runner.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Test runner — executes project tests and captures results.
+ *
+ * Runs the configured test command (e.g., `pnpm test`) and returns
+ * whether tests passed and the output.
+ *
+ * Dependency direction: test-runner.ts → execa, core/errors, utils
+ * Used by: workflow runner
+ */
+export interface TestResult {
+    /** Whether all tests passed. */
+    passed: boolean;
+    /** Stdout + stderr from the test command. */
+    output: string;
+    /** Exit code of the test command. */
+    exitCode: number;
+}
+/**
+ * Run the project's test suite.
+ *
+ * @param projectRoot - Root directory of the project
+ * @param testCommand - The test command to run (default: 'pnpm test')
+ */
+export declare function runTests(projectRoot: string, testCommand?: string): Promise<TestResult>;
+//# sourceMappingURL=test-runner.d.ts.map

package/dist/core/workflow/test-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-runner.d.ts","sourceRoot":"","sources":["../../../src/core/workflow/test-runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,MAAM,WAAW,UAAU;IACvB,gCAAgC;IAChC,MAAM,EAAE,OAAO,CAAC;IAChB,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAsB,QAAQ,CAC1B,WAAW,EAAE,MAAM,EACnB,WAAW,GAAE,MAAoB,GAClC,OAAO,CAAC,UAAU,CAAC,CAmCrB"}