takt 0.2.3 → 0.3.2

package/dist/utils/session.js

@@ -1,9 +1,97 @@
 /**
  * Session management utilities
  */
-import { existsSync, readFileSync, copyFileSync } from 'node:fs';
+import { existsSync, readFileSync, copyFileSync, appendFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { getProjectLogsDir, getGlobalLogsDir, ensureDir, writeFileAtomic } from '../config/paths.js';
+/**
+ * Append a single NDJSON line to a log file.
+ * Uses appendFileSync for atomic open→write→close (no file lock held).
+ */
+export function appendNdjsonLine(filepath, record) {
+    appendFileSync(filepath, JSON.stringify(record) + '\n', 'utf-8');
+}
+/**
+ * Initialize an NDJSON log file with the workflow_start record.
+ * Creates the logs directory if needed and returns the file path.
+ */
+export function initNdjsonLog(sessionId, task, workflowName, projectDir) {
+    const logsDir = projectDir
+        ? getProjectLogsDir(projectDir)
+        : getGlobalLogsDir();
+    ensureDir(logsDir);
+    const filepath = join(logsDir, `${sessionId}.jsonl`);
+    const record = {
+        type: 'workflow_start',
+        task,
+        workflowName,
+        startTime: new Date().toISOString(),
+    };
+    appendNdjsonLine(filepath, record);
+    return filepath;
+}
+/**
+ * Load an NDJSON log file and convert it to a SessionLog for backward compatibility.
+ * Parses each line as a JSON record and reconstructs the SessionLog structure.
+ */
+export function loadNdjsonLog(filepath) {
+    if (!existsSync(filepath)) {
+        return null;
+    }
+    const content = readFileSync(filepath, 'utf-8');
+    const lines = content.trim().split('\n').filter((line) => line.length > 0);
+    if (lines.length === 0)
+        return null;
+    let sessionLog = null;
+    for (const line of lines) {
+        const record = JSON.parse(line);
+        switch (record.type) {
+            case 'workflow_start':
+                sessionLog = {
+                    task: record.task,
+                    projectDir: '',
+                    workflowName: record.workflowName,
+                    iterations: 0,
+                    startTime: record.startTime,
+                    status: 'running',
+                    history: [],
+                };
+                break;
+            case 'step_complete':
+                if (sessionLog) {
+                    sessionLog.history.push({
+                        step: record.step,
+                        agent: record.agent,
+                        instruction: record.instruction,
+                        status: record.status,
+                        timestamp: record.timestamp,
+                        content: record.content,
+                        ...(record.error ? { error: record.error } : {}),
+                        ...(record.matchedRuleIndex != null ? { matchedRuleIndex: record.matchedRuleIndex } : {}),
+                        ...(record.matchedRuleMethod ? { matchedRuleMethod: record.matchedRuleMethod } : {}),
+                    });
+                    sessionLog.iterations++;
+                }
+                break;
+            case 'workflow_complete':
+                if (sessionLog) {
+                    sessionLog.status = 'completed';
+                    sessionLog.endTime = record.endTime;
+                }
+                break;
+            case 'workflow_abort':
+                if (sessionLog) {
+                    sessionLog.status = 'aborted';
+                    sessionLog.endTime = record.endTime;
+                }
+                break;
+            // stream and step_start records are not stored in SessionLog
+            default:
+                break;
+        }
+    }
+    return sessionLog;
+}
 /** Generate a session ID */
 export function generateSessionId() {
     const timestamp = Date.now().toString(36);
@@ -41,36 +129,20 @@ export function createSessionLog(task, projectDir, workflowName) {
         history: [],
     };
 }
-/** Add agent response to session log */
-export function addToSessionLog(log, stepName, response) {
-    log.history.push({
-        step: stepName,
-        agent: response.agent,
-        status: response.status,
-        timestamp: response.timestamp.toISOString(),
-        content: response.content,
-        ...(response.error ? { error: response.error } : {}),
-    });
-    log.iterations++;
-}
-/** Finalize session log */
+/** Create a finalized copy of a session log (immutable — does not modify the original) */
 export function finalizeSessionLog(log, status) {
-    log.status = status;
-    log.endTime = new Date().toISOString();
-}
-/** Save session log to file */
-export function saveSessionLog(log, sessionId, projectDir) {
-    const logsDir = projectDir
-        ? getProjectLogsDir(projectDir)
-        : getGlobalLogsDir();
-    ensureDir(logsDir);
-    const filename = `${sessionId}.json`;
-    const filepath = join(logsDir, filename);
-    writeFileAtomic(filepath, JSON.stringify(log, null, 2));
-    return filepath;
+    return {
+        ...log,
+        status,
+        endTime: new Date().toISOString(),
+    };
 }
-/** Load session log from file */
+/** Load session log from file (supports both .json and .jsonl formats) */
 export function loadSessionLog(filepath) {
+    // Try NDJSON format for .jsonl files
+    if (filepath.endsWith('.jsonl')) {
+        return loadNdjsonLog(filepath);
+    }
     if (!existsSync(filepath)) {
         return null;
     }
@@ -110,7 +182,7 @@ export function updateLatestPointer(log, sessionId, projectDir, options) {
     }
     const pointer = {
         sessionId,
-        logFile: `${sessionId}.json`,
+        logFile: `${sessionId}.jsonl`,
         task: log.task,
         workflowName: log.workflowName,
         status: log.status,
@@ -120,26 +192,4 @@ export function updateLatestPointer(log, sessionId, projectDir, options) {
     };
     writeFileAtomic(latestPath, JSON.stringify(pointer, null, 2));
 }
-/** Convert workflow state to session log */
-export function workflowStateToSessionLog(state, task, projectDir) {
-    const log = {
-        task,
-        projectDir,
-        workflowName: state.workflowName,
-        iterations: state.iteration,
-        startTime: new Date().toISOString(),
-        status: state.status === 'running' ? 'running' : state.status === 'completed' ? 'completed' : 'aborted',
-        history: [],
-    };
-    for (const [stepName, response] of state.stepOutputs) {
-        log.history.push({
-            step: stepName,
-            agent: response.agent,
-            status: response.status,
-            timestamp: response.timestamp.toISOString(),
-            content: response.content,
-        });
-    }
-    return log;
-}
 //# sourceMappingURL=session.js.map

package/dist/utils/session.js.map

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

package/dist/workflow/engine.d.ts

@@ -36,8 +36,41 @@ export declare class WorkflowEngine extends EventEmitter {
     private buildInstruction;
     /** Get step by name */
     private getStep;
-    /** Run a single step */
+    /**
+     * Emit step:report events for each report file that exists after step completion.
+     * The UI layer (workflowExecution.ts) listens and displays the content.
+     */
+    private emitStepReports;
+    /** Emit step:report if the report file exists */
+    private emitIfReportExists;
+    /** Run a single step (delegates to runParallelStep if step has parallel sub-steps) */
     private runStep;
+    /** Build common RunAgentOptions shared by all phases */
+    private buildBaseOptions;
+    /** Build RunAgentOptions from a step's configuration (Phase 1) */
+    private buildAgentOptions;
+    /**
+     * Build RunAgentOptions for session-resume phases (Phase 2, Phase 3).
+     */
+    private buildResumeOptions;
+    /** Update agent session and notify via callback if session changed */
+    private updateAgentSession;
+    /** Build phase runner context for Phase 2/3 execution */
+    private buildPhaseRunnerContext;
+    /** Run a normal (non-parallel) step */
+    private runNormalStep;
+    /**
+     * Run a parallel step: execute all sub-steps concurrently, then aggregate results.
+     * The aggregated output becomes the parent step's response for rules evaluation.
+     *
+     * When onStream is provided, uses ParallelLogger to prefix each sub-step's
+     * output with `[name]` for readable interleaved display.
+     */
+    private runParallelStep;
+    /**
+     * Determine next step for a completed step using rules-based routing.
+     */
+    private resolveNextStep;
     /** Run the workflow to completion */
     run(): Promise<WorkflowState>;
     /** Run a single iteration (for interactive mode) */

package/dist/workflow/engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/workflow/engine.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EAEb,aAAa,EACd,MAAM,oBAAoB,CAAC;AAG5B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAiBxD,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE3D,wDAAwD;AACxD,qBAAa,cAAe,SAAQ,YAAY;IAC9C,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAoC;IACpD,OAAO,CAAC,SAAS,CAAS;gBAEd,MAAM,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B;IAqBlG,yEAAyE;IACzE,OAAO,CAAC,qBAAqB;IAmB7B,2DAA2D;IAC3D,OAAO,CAAC,cAAc;IAqBtB,iCAAiC;IACjC,QAAQ,IAAI,aAAa;IAIzB,qBAAqB;IACrB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIjC,+BAA+B;IAC/B,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI/B,oCAAoC;IACpC,MAAM,IAAI,MAAM;IAIhB,sDAAsD;IACtD,aAAa,IAAI,MAAM;IAIvB,sCAAsC;IACtC,OAAO,CAAC,gBAAgB;IAexB,uBAAuB;IACvB,OAAO,CAAC,OAAO;IAQf,wBAAwB;YACV,OAAO;IA2CrB,qCAAqC;IAC/B,GAAG,IAAI,OAAO,CAAC,aAAa,CAAC;IA4FnC,oDAAoD;IAC9C,kBAAkB,IAAI,OAAO,CAAC;QAClC,QAAQ,EAAE,aAAa,CAAC;QACxB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,OAAO,CAAC;QACpB,YAAY,CAAC,EAAE,OAAO,CAAC;KACxB,CAAC;CAgCH"}
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/workflow/engine.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EAEb,aAAa,EACd,MAAM,oBAAoB,CAAC;AAG5B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAoBxD,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE3D,wDAAwD;AACxD,qBAAa,cAAe,SAAQ,YAAY;IAC9C,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAoC;IACpD,OAAO,CAAC,SAAS,CAAS;gBAEd,MAAM,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B;IAqBlG,yEAAyE;IACzE,OAAO,CAAC,qBAAqB;IAmB7B,2DAA2D;IAC3D,OAAO,CAAC,cAAc;IAuBtB,iCAAiC;IACjC,QAAQ,IAAI,aAAa;IAIzB,qBAAqB;IACrB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIjC,+BAA+B;IAC/B,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI/B,oCAAoC;IACpC,MAAM,IAAI,MAAM;IAIhB,sDAAsD;IACtD,aAAa,IAAI,MAAM;IAIvB,sCAAsC;IACtC,OAAO,CAAC,gBAAgB;IAexB,uBAAuB;IACvB,OAAO,CAAC,OAAO;IAQf;;;OAGG;IACH,OAAO,CAAC,eAAe;IAgBvB,iDAAiD;IACjD,OAAO,CAAC,kBAAkB;IAO1B,sFAAsF;YACxE,OAAO;IAOrB,wDAAwD;IACxD,OAAO,CAAC,gBAAgB;IAcxB,kEAAkE;IAClE,OAAO,CAAC,iBAAiB;IAazB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAS1B,sEAAsE;IACtE,OAAO,CAAC,kBAAkB;IAW1B,yDAAyD;IACzD,OAAO,CAAC,uBAAuB;IAW/B,uCAAuC;YACzB,aAAa;IA2C3B;;;;;;OAMG;YACW,eAAe;IAkG7B;;OAEG;IACH,OAAO,CAAC,eAAe;IAWvB,qCAAqC;IAC/B,GAAG,IAAI,OAAO,CAAC,aAAa,CAAC;IA6FnC,oDAAoD;IAC9C,kBAAkB,IAAI,OAAO,CAAC;QAClC,QAAQ,EAAE,aAAa,CAAC;QACxB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,OAAO,CAAC;QACpB,YAAY,CAAC,EAAE,OAAO,CAAC;KACxB,CAAC;CAgCH"}

package/dist/workflow/engine.js

@@ -6,10 +6,13 @@ import { mkdirSync, existsSync, symlinkSync } from 'node:fs';
 import { join } from 'node:path';
 import { runAgent } from '../agents/runner.js';
 import { COMPLETE_STEP, ABORT_STEP, ERROR_MESSAGES } from './constants.js';
-import { determineNextStep } from './transitions.js';
-import { buildInstruction as buildInstructionFromTemplate } from './instruction-builder.js';
+import { determineNextStepByRules } from './transitions.js';
+import { buildInstruction as buildInstructionFromTemplate, isReportObjectConfig } from './instruction-builder.js';
 import { LoopDetector } from './loop-detector.js';
 import { handleBlocked } from './blocked-handler.js';
+import { ParallelLogger } from './parallel-logger.js';
+import { detectMatchedRule } from './rule-evaluator.js';
+import { needsStatusJudgmentPhase, runReportPhase, runStatusJudgmentPhase } from './phase-runner.js';
 import { createInitialState, addUserInput, getPreviousOutput, incrementStepIteration, } from './state-manager.js';
 import { generateReportDir } from '../utils/session.js';
 import { createLogger } from '../utils/debug.js';
@@ -35,7 +38,7 @@ export class WorkflowEngine extends EventEmitter {
         this.options = options;
         this.language = options.language;
         this.loopDetector = new LoopDetector(config.loopDetection);
-        this.reportDir = generateReportDir(task);
+        this.reportDir = `.takt/reports/${generateReportDir(task)}`;
         this.ensureReportDirExists();
         this.validateConfig();
         this.state = createInitialState(config, options);
@@ -48,7 +51,7 @@ export class WorkflowEngine extends EventEmitter {
     }
     /** Ensure report directory exists (always in project root, not clone) */
     ensureReportDirExists() {
-        const reportDirPath = join(this.projectCwd, '.takt', 'reports', this.reportDir);
+        const reportDirPath = join(this.projectCwd, this.reportDir);
         if (!existsSync(reportDirPath)) {
             mkdirSync(reportDirPath, { recursive: true });
         }
@@ -71,9 +74,11 @@ export class WorkflowEngine extends EventEmitter {
         stepNames.add(COMPLETE_STEP);
         stepNames.add(ABORT_STEP);
         for (const step of this.config.steps) {
-            for (const transition of step.transitions) {
-                if (!stepNames.has(transition.nextStep)) {
-                    throw new Error(`Invalid transition in step "${step.name}": target step "${transition.nextStep}" does not exist`);
+            if (step.rules) {
+                for (const rule of step.rules) {
+                    if (rule.next && !stepNames.has(rule.next)) {
+                        throw new Error(`Invalid rule in step "${step.name}": target step "${rule.next}" does not exist`);
+                    }
                 }
             }
         }
@@ -121,25 +126,46 @@ export class WorkflowEngine extends EventEmitter {
         }
         return step;
     }
-    /** Run a single step */
+    /**
+     * Emit step:report events for each report file that exists after step completion.
+     * The UI layer (workflowExecution.ts) listens and displays the content.
+     */
+    emitStepReports(step) {
+        if (!step.report || !this.reportDir)
+            return;
+        const baseDir = join(this.projectCwd, this.reportDir);
+        if (typeof step.report === 'string') {
+            this.emitIfReportExists(step, baseDir, step.report);
+        }
+        else if (isReportObjectConfig(step.report)) {
+            this.emitIfReportExists(step, baseDir, step.report.name);
+        }
+        else {
+            // ReportConfig[] (array)
+            for (const rc of step.report) {
+                this.emitIfReportExists(step, baseDir, rc.path);
+            }
+        }
+    }
+    /** Emit step:report if the report file exists */
+    emitIfReportExists(step, baseDir, fileName) {
+        const filePath = join(baseDir, fileName);
+        if (existsSync(filePath)) {
+            this.emit('step:report', step, filePath, fileName);
+        }
+    }
+    /** Run a single step (delegates to runParallelStep if step has parallel sub-steps) */
     async runStep(step) {
-        // Increment step iteration counter before building instruction
-        const stepIteration = incrementStepIteration(this.state, step.name);
-        const instruction = this.buildInstruction(step, stepIteration);
-        const sessionId = this.state.agentSessions.get(step.agent);
-        log.debug('Running step', {
-            step: step.name,
-            agent: step.agent,
-            stepIteration,
-            iteration: this.state.iteration,
-            sessionId: sessionId ?? 'new',
-        });
-        const agentOptions = {
+        if (step.parallel && step.parallel.length > 0) {
+            return this.runParallelStep(step);
+        }
+        return this.runNormalStep(step);
+    }
+    /** Build common RunAgentOptions shared by all phases */
+    buildBaseOptions(step) {
+        return {
             cwd: this.cwd,
-            sessionId,
             agentPath: step.agentPath,
-            allowedTools: step.allowedTools,
-            statusRulesPrompt: step.statusRulesPrompt,
             provider: step.provider,
             model: step.model,
             permissionMode: step.permissionMode,
@@ -148,16 +174,181 @@ export class WorkflowEngine extends EventEmitter {
             onAskUserQuestion: this.options.onAskUserQuestion,
             bypassPermissions: this.options.bypassPermissions,
         };
-        const response = await runAgent(step.agent, instruction, agentOptions);
-        if (response.sessionId) {
-            const previousSessionId = this.state.agentSessions.get(step.agent);
-            this.state.agentSessions.set(step.agent, response.sessionId);
-            if (this.options.onSessionUpdate && response.sessionId !== previousSessionId) {
-                this.options.onSessionUpdate(step.agent, response.sessionId);
-            }
+    }
+    /** Build RunAgentOptions from a step's configuration (Phase 1) */
+    buildAgentOptions(step) {
+        // Phase 1: exclude Write from allowedTools when step has report config
+        const allowedTools = step.report
+            ? step.allowedTools?.filter((t) => t !== 'Write')
+            : step.allowedTools;
+        return {
+            ...this.buildBaseOptions(step),
+            sessionId: this.state.agentSessions.get(step.agent),
+            allowedTools,
+        };
+    }
+    /**
+     * Build RunAgentOptions for session-resume phases (Phase 2, Phase 3).
+     */
+    buildResumeOptions(step, sessionId, overrides) {
+        return {
+            ...this.buildBaseOptions(step),
+            sessionId,
+            allowedTools: overrides.allowedTools,
+            maxTurns: overrides.maxTurns,
+        };
+    }
+    /** Update agent session and notify via callback if session changed */
+    updateAgentSession(agent, sessionId) {
+        if (!sessionId)
+            return;
+        const previousSessionId = this.state.agentSessions.get(agent);
+        this.state.agentSessions.set(agent, sessionId);
+        if (this.options.onSessionUpdate && sessionId !== previousSessionId) {
+            this.options.onSessionUpdate(agent, sessionId);
+        }
+    }
+    /** Build phase runner context for Phase 2/3 execution */
+    buildPhaseRunnerContext() {
+        return {
+            cwd: this.cwd,
+            reportDir: this.reportDir,
+            language: this.language,
+            getSessionId: (agent) => this.state.agentSessions.get(agent),
+            buildResumeOptions: this.buildResumeOptions.bind(this),
+            updateAgentSession: this.updateAgentSession.bind(this),
+        };
+    }
+    /** Run a normal (non-parallel) step */
+    async runNormalStep(step) {
+        const stepIteration = incrementStepIteration(this.state, step.name);
+        const instruction = this.buildInstruction(step, stepIteration);
+        log.debug('Running step', {
+            step: step.name,
+            agent: step.agent,
+            stepIteration,
+            iteration: this.state.iteration,
+            sessionId: this.state.agentSessions.get(step.agent) ?? 'new',
+        });
+        // Phase 1: main execution (Write excluded if step has report)
+        const agentOptions = this.buildAgentOptions(step);
+        let response = await runAgent(step.agent, instruction, agentOptions);
+        this.updateAgentSession(step.agent, response.sessionId);
+        const phaseCtx = this.buildPhaseRunnerContext();
+        // Phase 2: report output (resume same session, Write only)
+        if (step.report) {
+            await runReportPhase(step, stepIteration, phaseCtx);
+        }
+        // Phase 3: status judgment (resume session, no tools, output status tag)
+        let tagContent = '';
+        if (needsStatusJudgmentPhase(step)) {
+            tagContent = await runStatusJudgmentPhase(step, phaseCtx);
+        }
+        const match = await detectMatchedRule(step, response.content, tagContent, {
+            state: this.state,
+            cwd: this.cwd,
+        });
+        if (match) {
+            log.debug('Rule matched', { step: step.name, ruleIndex: match.index, method: match.method });
+            response = { ...response, matchedRuleIndex: match.index, matchedRuleMethod: match.method };
         }
         this.state.stepOutputs.set(step.name, response);
-        return response;
+        this.emitStepReports(step);
+        return { response, instruction };
+    }
+    /**
+     * Run a parallel step: execute all sub-steps concurrently, then aggregate results.
+     * The aggregated output becomes the parent step's response for rules evaluation.
+     *
+     * When onStream is provided, uses ParallelLogger to prefix each sub-step's
+     * output with `[name]` for readable interleaved display.
+     */
+    async runParallelStep(step) {
+        const subSteps = step.parallel;
+        const stepIteration = incrementStepIteration(this.state, step.name);
+        log.debug('Running parallel step', {
+            step: step.name,
+            subSteps: subSteps.map(s => s.name),
+            stepIteration,
+        });
+        // Create parallel logger for prefixed output (only when streaming is enabled)
+        const parallelLogger = this.options.onStream
+            ? new ParallelLogger({
+                subStepNames: subSteps.map((s) => s.name),
+                parentOnStream: this.options.onStream,
+            })
+            : undefined;
+        const phaseCtx = this.buildPhaseRunnerContext();
+        const ruleCtx = { state: this.state, cwd: this.cwd };
+        // Run all sub-steps concurrently
+        const subResults = await Promise.all(subSteps.map(async (subStep, index) => {
+            const subIteration = incrementStepIteration(this.state, subStep.name);
+            const subInstruction = this.buildInstruction(subStep, subIteration);
+            // Phase 1: main execution (Write excluded if sub-step has report)
+            const baseOptions = this.buildAgentOptions(subStep);
+            // Override onStream with parallel logger's prefixed handler (immutable)
+            const agentOptions = parallelLogger
+                ? { ...baseOptions, onStream: parallelLogger.createStreamHandler(subStep.name, index) }
+                : baseOptions;
+            const subResponse = await runAgent(subStep.agent, subInstruction, agentOptions);
+            this.updateAgentSession(subStep.agent, subResponse.sessionId);
+            // Phase 2: report output for sub-step
+            if (subStep.report) {
+                await runReportPhase(subStep, subIteration, phaseCtx);
+            }
+            // Phase 3: status judgment for sub-step
+            let subTagContent = '';
+            if (needsStatusJudgmentPhase(subStep)) {
+                subTagContent = await runStatusJudgmentPhase(subStep, phaseCtx);
+            }
+            const match = await detectMatchedRule(subStep, subResponse.content, subTagContent, ruleCtx);
+            const finalResponse = match
+                ? { ...subResponse, matchedRuleIndex: match.index, matchedRuleMethod: match.method }
+                : subResponse;
+            this.state.stepOutputs.set(subStep.name, finalResponse);
+            this.emitStepReports(subStep);
+            return { subStep, response: finalResponse, instruction: subInstruction };
+        }));
+        // Print completion summary
+        if (parallelLogger) {
+            parallelLogger.printSummary(step.name, subResults.map((r) => ({
+                name: r.subStep.name,
+                condition: r.response.matchedRuleIndex != null && r.subStep.rules
+                    ? r.subStep.rules[r.response.matchedRuleIndex]?.condition
+                    : undefined,
+            })));
+        }
+        // Aggregate sub-step outputs into parent step's response
+        const aggregatedContent = subResults
+            .map((r) => `## ${r.subStep.name}\n${r.response.content}`)
+            .join('\n\n---\n\n');
+        const aggregatedInstruction = subResults
+            .map((r) => r.instruction)
+            .join('\n\n');
+        // Parent step uses aggregate conditions, so tagContent is empty
+        const match = await detectMatchedRule(step, aggregatedContent, '', ruleCtx);
+        const aggregatedResponse = {
+            agent: step.name,
+            status: 'done',
+            content: aggregatedContent,
+            timestamp: new Date(),
+            ...(match && { matchedRuleIndex: match.index, matchedRuleMethod: match.method }),
+        };
+        this.state.stepOutputs.set(step.name, aggregatedResponse);
+        this.emitStepReports(step);
+        return { response: aggregatedResponse, instruction: aggregatedInstruction };
+    }
+    /**
+     * Determine next step for a completed step using rules-based routing.
+     */
+    resolveNextStep(step, response) {
+        if (response.matchedRuleIndex != null && step.rules) {
+            const nextByRules = determineNextStepByRules(step, response.matchedRuleIndex);
+            if (nextByRules) {
+                return nextByRules;
+            }
+        }
+        throw new Error(`No matching rule found for step "${step.name}" (status: ${response.status})`);
     }
     /** Run the workflow to completion */
     async run() {
@@ -195,8 +386,8 @@ export class WorkflowEngine extends EventEmitter {
             this.state.iteration++;
             this.emit('step:start', step, this.state.iteration);
             try {
-                const response = await this.runStep(step);
-                this.emit('step:complete', step, response);
+                const { response, instruction } = await this.runStep(step);
+                this.emit('step:complete', step, response, instruction);
                 if (response.status === 'blocked') {
                     this.emit('step:blocked', step, response);
                     const result = await handleBlocked(step, response, this.options);
@@ -209,10 +400,11 @@ export class WorkflowEngine extends EventEmitter {
                     this.emit('workflow:abort', this.state, 'Workflow blocked and no user input provided');
                     break;
                 }
-                const nextStep = determineNextStep(step, response.status, this.config);
+                const nextStep = this.resolveNextStep(step, response);
                 log.debug('Step transition', {
                     from: step.name,
                     status: response.status,
+                    matchedRuleIndex: response.matchedRuleIndex,
                     nextStep,
                 });
                 if (nextStep === COMPLETE_STEP) {
@@ -255,8 +447,8 @@ export class WorkflowEngine extends EventEmitter {
             };
         }
         this.state.iteration++;
-        const response = await this.runStep(step);
-        const nextStep = determineNextStep(step, response.status, this.config);
+        const { response } = await this.runStep(step);
+        const nextStep = this.resolveNextStep(step, response);
         const isComplete = nextStep === COMPLETE_STEP || nextStep === ABORT_STEP;
         if (!isComplete) {
             this.state.currentStep = nextStep;