takt 0.35.4 → 0.37.0

package/dist/core/{piece → workflow}/engine/ParallelRunner.js

@@ -1,14 +1,14 @@
 /**
- * Executes parallel piece movements concurrently and aggregates results.
+ * Executes parallel workflow steps concurrently and aggregates results.
  *
  * When onStream is provided, uses ParallelLogger to prefix each
- * sub-movement's output with `[name]` for readable interleaved display.
+ * sub-step output with `[name]` for readable interleaved display.
  */
 import { executeAgent } from '../../../agents/agent-usecases.js';
 import { ParallelLogger } from './parallel-logger.js';
 import { needsStatusJudgmentPhase, runReportPhase, runStatusJudgmentPhase } from '../phase-runner.js';
 import { detectMatchedRule } from '../evaluation/index.js';
-import { incrementMovementIteration } from './state-manager.js';
+import { incrementStepIteration } from './state-manager.js';
 import { createLogger, getErrorMessage } from '../../../shared/utils/index.js';
 import { buildSessionKey } from '../session-key.js';
 const log = createLogger('parallel-runner');
@@ -49,23 +49,23 @@ export class ParallelRunner {
         this.deps = deps;
     }
     /**
-     * Run a parallel movement: execute all sub-movements concurrently, then aggregate results.
-     * The aggregated output becomes the parent movement's response for rules evaluation.
+     * Run a parallel step: execute all sub-steps concurrently, then aggregate results.
+     * The aggregated output becomes the parent step response for rules evaluation.
      */
-    async runParallelMovement(step, state, task, maxMovements, updatePersonaSession) {
+    async runParallelStep(step, state, task, maxSteps, updatePersonaSession) {
         if (!step.parallel) {
-            throw new Error(`Movement "${step.name}" has no parallel sub-movements`);
+            throw new Error(`Step "${step.name}" has no parallel sub-steps`);
         }
-        const subMovements = step.parallel;
-        const movementIteration = incrementMovementIteration(state, step.name);
-        log.debug('Running parallel movement', {
-            movement: step.name,
-            subMovements: subMovements.map(s => s.name),
-            movementIteration,
+        const subSteps = step.parallel;
+        const stepIteration = incrementStepIteration(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.deps.engineOptions.onStream
-            ? new ParallelLogger(this.buildParallelLoggerOptions(step.name, movementIteration, subMovements.map((s) => s.name), state.iteration, maxMovements))
+            ? new ParallelLogger(this.buildParallelLoggerOptions(step.name, stepIteration, subSteps.map((s) => s.name), state.iteration, maxSteps))
             : undefined;
         const parentPm = this.deps.optionsBuilder.resolveStepProviderModel(step);
         const parentRuleCtx = {
@@ -83,62 +83,62 @@ export class ParallelRunner {
             ? new Semaphore(step.concurrency)
             : undefined;
         if (semaphore) {
-            log.debug('Concurrency limit enabled', { movement: step.name, concurrency: step.concurrency });
+            log.debug('Concurrency limit enabled', { step: step.name, concurrency: step.concurrency });
         }
-        // Run all sub-movements concurrently (failures are captured, not thrown)
-        // When semaphore is set, at most `concurrency` sub-movements execute simultaneously.
-        const settled = await Promise.allSettled(subMovements.map(async (subMovement, index) => {
+        // Run all sub-steps concurrently (failures are captured, not thrown)
+        // When semaphore is set, at most `concurrency` sub-steps execute simultaneously.
+        const settled = await Promise.allSettled(subSteps.map(async (subStep, index) => {
             if (semaphore) {
                 await semaphore.acquire();
             }
             try {
-                const subIteration = incrementMovementIteration(state, subMovement.name);
-                const subInstruction = this.deps.movementExecutor.buildInstruction(subMovement, subIteration, state, task, maxMovements);
+                const subIteration = incrementStepIteration(state, subStep.name);
+                const subInstruction = this.deps.stepExecutor.buildInstruction(subStep, subIteration, state, task, maxSteps);
                 const parentIteration = state.iteration;
-                const subPm = this.deps.optionsBuilder.resolveStepProviderModel(subMovement);
+                const subPm = this.deps.optionsBuilder.resolveStepProviderModel(subStep);
                 const subRuleCtx = {
                     ...parentRuleCtx,
                     provider: subPm.provider,
                     resolvedProvider: subPm.provider,
                     resolvedModel: subPm.model,
                 };
-                // Session key uses buildSessionKey (persona:provider) — same as normal movements.
-                // This ensures sessions are shared across movements with the same persona+provider,
+                // Session key uses buildSessionKey (persona:provider) — same as normal steps.
+                // This ensures sessions are shared across steps with the same persona+provider,
                 // while different providers (e.g., claude-eye vs codex-eye) get separate sessions.
-                const subSessionKey = buildSessionKey(subMovement);
-                // Phase 1: main execution (Write excluded if sub-movement has report)
-                const baseOptions = this.deps.optionsBuilder.buildAgentOptions(subMovement);
+                const subSessionKey = buildSessionKey(subStep);
+                // Phase 1: main execution (Write excluded if sub-step has report)
+                const baseOptions = this.deps.optionsBuilder.buildAgentOptions(subStep);
                 let didEmitPhaseStart = false;
                 // Override onStream with parallel logger's prefixed handler (immutable)
                 const agentOptions = parallelLogger
-                    ? { ...baseOptions, onStream: parallelLogger.createStreamHandler(subMovement.name, index) }
+                    ? { ...baseOptions, onStream: parallelLogger.createStreamHandler(subStep.name, index) }
                     : { ...baseOptions };
                 agentOptions.onPromptResolved = (promptParts) => {
-                    this.deps.onPhaseStart?.(subMovement, 1, 'execute', subInstruction, promptParts, undefined, parentIteration);
+                    this.deps.onPhaseStart?.(subStep, 1, 'execute', subInstruction, promptParts, undefined, parentIteration);
                     didEmitPhaseStart = true;
                 };
-                const subResponse = await executeAgent(subMovement.persona, subInstruction, agentOptions);
+                const subResponse = await executeAgent(subStep.persona, subInstruction, agentOptions);
                 if (!didEmitPhaseStart) {
-                    throw new Error(`Missing prompt parts for phase start: ${subMovement.name}:1`);
+                    throw new Error(`Missing prompt parts for phase start: ${subStep.name}:1`);
                 }
                 updatePersonaSession(subSessionKey, subResponse.sessionId);
-                this.deps.onPhaseComplete?.(subMovement, 1, 'execute', subResponse.content, subResponse.status, subResponse.error, undefined, parentIteration);
+                this.deps.onPhaseComplete?.(subStep, 1, 'execute', subResponse.content, subResponse.status, subResponse.error, undefined, parentIteration);
                 // Phase 2/3 context — no overrides needed, phase-runner uses buildSessionKey internally
                 const phaseCtx = this.deps.optionsBuilder.buildPhaseRunnerContext(state, subResponse.content, updatePersonaSession, this.deps.onPhaseStart, this.deps.onPhaseComplete, this.deps.onJudgeStage, parentIteration);
-                // Phase 2: report output for sub-movement
-                if (subMovement.outputContracts && subMovement.outputContracts.length > 0) {
-                    await runReportPhase(subMovement, subIteration, phaseCtx);
+                // Phase 2: report output for sub-step
+                if (subStep.outputContracts && subStep.outputContracts.length > 0) {
+                    await runReportPhase(subStep, subIteration, phaseCtx);
                 }
-                // Phase 3: status judgment for sub-movement
+                // Phase 3: status judgment for sub-step
                 let subPhase3;
                 try {
-                    subPhase3 = needsStatusJudgmentPhase(subMovement)
-                        ? await runStatusJudgmentPhase(subMovement, phaseCtx)
+                    subPhase3 = needsStatusJudgmentPhase(subStep)
+                        ? await runStatusJudgmentPhase(subStep, phaseCtx)
                         : undefined;
                 }
                 catch (error) {
-                    log.info('Phase 3 status judgment failed for sub-movement, falling back to phase1 rule evaluation', {
-                        movement: subMovement.name,
+                    log.info('Phase 3 status judgment failed for sub-step, falling back to phase1 rule evaluation', {
+                        step: subStep.name,
                         error: getErrorMessage(error),
                     });
                 }
@@ -147,14 +147,14 @@ export class ParallelRunner {
                     finalResponse = { ...subResponse, matchedRuleIndex: subPhase3.ruleIndex, matchedRuleMethod: subPhase3.method };
                 }
                 else {
-                    const match = await detectMatchedRule(subMovement, subResponse.content, '', subRuleCtx);
+                    const match = await detectMatchedRule(subStep, subResponse.content, '', subRuleCtx);
                     finalResponse = match
                         ? { ...subResponse, matchedRuleIndex: match.index, matchedRuleMethod: match.method }
                         : subResponse;
                 }
-                state.movementOutputs.set(subMovement.name, finalResponse);
-                this.deps.movementExecutor.emitMovementReports(subMovement);
-                return { subMovement, response: finalResponse, instruction: subInstruction };
+                state.stepOutputs.set(subStep.name, finalResponse);
+                this.deps.stepExecutor.emitStepReports(subStep);
+                return { subStep, response: finalResponse, instruction: subInstruction };
             }
             finally {
                 if (semaphore) {
@@ -167,42 +167,42 @@ export class ParallelRunner {
             if (result.status === 'fulfilled') {
                 return result.value;
             }
-            const failedMovement = subMovements[index];
+            const failedStep = subSteps[index];
             const errorMsg = getErrorMessage(result.reason);
-            log.error('Sub-movement failed', { movement: failedMovement.name, error: errorMsg });
+            log.error('Sub-step failed', { step: failedStep.name, error: errorMsg });
             const errorResponse = {
-                persona: failedMovement.name,
+                persona: failedStep.name,
                 status: 'error',
                 content: '',
                 timestamp: new Date(),
                 error: errorMsg,
             };
-            state.movementOutputs.set(failedMovement.name, errorResponse);
-            return { subMovement: failedMovement, response: errorResponse, instruction: '' };
+            state.stepOutputs.set(failedStep.name, errorResponse);
+            return { subStep: failedStep, response: errorResponse, instruction: '' };
         });
-        // If all sub-movements failed (error-originated), throw
+        // If all sub-steps failed (error-originated), throw
         const allFailed = subResults.every(r => r.response.error != null);
         if (allFailed) {
-            const errors = subResults.map(r => `${r.subMovement.name}: ${r.response.error}`).join('; ');
-            throw new Error(`All parallel sub-movements failed: ${errors}`);
+            const errors = subResults.map(r => `${r.subStep.name}: ${r.response.error}`).join('; ');
+            throw new Error(`All parallel sub-steps failed: ${errors}`);
         }
         // Print completion summary
         if (parallelLogger) {
             parallelLogger.printSummary(step.name, subResults.map((r) => ({
-                name: r.subMovement.name,
-                condition: r.response.matchedRuleIndex != null && r.subMovement.rules
-                    ? r.subMovement.rules[r.response.matchedRuleIndex]?.condition
+                name: r.subStep.name,
+                condition: r.response.matchedRuleIndex != null && r.subStep.rules
+                    ? r.subStep.rules[r.response.matchedRuleIndex]?.condition
                     : undefined,
             })));
         }
-        // Aggregate sub-movement outputs into parent movement's response
+        // Aggregate sub-step outputs into the parent step response
         const aggregatedContent = subResults
-            .map((r) => `## ${r.subMovement.name}\n${r.response.content}`)
+            .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 movement uses aggregate conditions, so tagContent is empty
+        // Parent step uses aggregate conditions, so tagContent is empty
         const match = await detectMatchedRule(step, aggregatedContent, '', parentRuleCtx);
         const aggregatedResponse = {
             persona: step.name,
@@ -211,19 +211,19 @@ export class ParallelRunner {
             timestamp: new Date(),
             ...(match && { matchedRuleIndex: match.index, matchedRuleMethod: match.method }),
         };
-        state.movementOutputs.set(step.name, aggregatedResponse);
+        state.stepOutputs.set(step.name, aggregatedResponse);
         state.lastOutput = aggregatedResponse;
-        this.deps.movementExecutor.persistPreviousResponseSnapshot(state, step.name, movementIteration, aggregatedResponse.content);
-        this.deps.movementExecutor.emitMovementReports(step);
+        this.deps.stepExecutor.persistPreviousResponseSnapshot(state, step.name, stepIteration, aggregatedResponse.content);
+        this.deps.stepExecutor.emitStepReports(step);
         return { response: aggregatedResponse, instruction: aggregatedInstruction };
     }
-    buildParallelLoggerOptions(movementName, movementIteration, subMovementNames, iteration, maxMovements) {
+    buildParallelLoggerOptions(stepName, stepIteration, subStepNames, iteration, maxSteps) {
         const options = {
-            subMovementNames,
+            subStepNames,
             parentOnStream: this.deps.engineOptions.onStream,
             progressInfo: {
                 iteration,
-                maxMovements,
+                maxSteps,
             },
         };
         if (this.deps.engineOptions.taskPrefix != null && this.deps.engineOptions.taskColorIndex != null) {
@@ -231,8 +231,8 @@ export class ParallelRunner {
                 ...options,
                 taskLabel: this.deps.engineOptions.taskPrefix,
                 taskColorIndex: this.deps.engineOptions.taskColorIndex,
-                parentMovementName: movementName,
-                movementIteration,
+                parentStepName: stepName,
+                stepIteration,
             };
         }
         return options;

package/dist/core/workflow/engine/ParallelRunner.js.map

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

package/dist/core/workflow/engine/StepExecutor.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Executes a single workflow step through the 3-phase model.
+ *
+ * Phase 1: Main agent execution (with tools)
+ * Phase 2: Report output (Write-only, optional)
+ * Phase 3: Status judgment (no tools, optional)
+ */
+import type { WorkflowStep, WorkflowState, AgentResponse, Language } from '../../models/types.js';
+import type { PhaseName, PhasePromptParts, JudgeStageEntry, RuntimeStepResolution } from '../types.js';
+import type { OptionsBuilder } from './OptionsBuilder.js';
+import type { RunPaths } from '../run/run-paths.js';
+import type { StructuredCaller } from '../../../agents/structured-caller.js';
+export interface StepExecutorDeps {
+    readonly optionsBuilder: OptionsBuilder;
+    readonly getCwd: () => string;
+    readonly getProjectCwd: () => string;
+    readonly getReportDir: () => string;
+    readonly getRunPaths: () => RunPaths;
+    readonly getLanguage: () => Language | undefined;
+    readonly getInteractive: () => boolean;
+    readonly getWorkflowSteps: () => ReadonlyArray<{
+        name: string;
+        description?: string;
+    }>;
+    readonly getWorkflowName: () => string;
+    readonly getWorkflowDescription: () => string | undefined;
+    readonly getRetryNote: () => string | undefined;
+    readonly detectRuleIndex: (content: string, stepName: string) => number;
+    readonly structuredCaller: StructuredCaller;
+    readonly onPhaseStart?: (step: WorkflowStep, phase: 1 | 2 | 3, phaseName: PhaseName, instruction: string, promptParts: PhasePromptParts, phaseExecutionId?: string, iteration?: number) => void;
+    readonly onPhaseComplete?: (step: WorkflowStep, phase: 1 | 2 | 3, phaseName: PhaseName, content: string, status: string, error?: string, phaseExecutionId?: string, iteration?: number) => void;
+    readonly onJudgeStage?: (step: WorkflowStep, phase: 3, phaseName: 'judge', entry: JudgeStageEntry, phaseExecutionId?: string, iteration?: number) => void;
+}
+export declare class StepExecutor {
+    private readonly deps;
+    constructor(deps: StepExecutorDeps);
+    private static buildTimestamp;
+    private static buildSnapshotFileName;
+    private writeSnapshot;
+    private writeFacetSnapshot;
+    private ensurePreviousResponseSnapshot;
+    persistPreviousResponseSnapshot(state: WorkflowState, stepName: string, stepIteration: number, content: string): void;
+    buildPhase1Instruction(instruction: string, step: WorkflowStep, runtime?: RuntimeStepResolution): string;
+    private normalizeStructuredOutput;
+    /** Build Phase 1 instruction from template */
+    buildInstruction(step: WorkflowStep, stepIteration: number, state: WorkflowState, task: string, maxSteps: number): string;
+    /**
+     * Apply shared post-execution phases (Phase 2/3 + fallback rule evaluation).
+     *
+     * This method is intentionally reusable by non-normal step runners
+     * (e.g., team_leader) so rule/report behavior stays consistent.
+     */
+    applyPostExecutionPhases(step: WorkflowStep, state: WorkflowState, stepIteration: number, response: AgentResponse, updatePersonaSession: (persona: string, sessionId: string | undefined) => void, runtime?: RuntimeStepResolution): Promise<AgentResponse>;
+    /**
+     * Execute a normal (non-parallel) step through all 3 phases.
+     *
+     * Returns the final response (with matchedRuleIndex if a rule matched)
+     * and the instruction used for Phase 1.
+     */
+    runNormalStep(step: WorkflowStep, state: WorkflowState, task: string, maxSteps: number, updatePersonaSession: (persona: string, sessionId: string | undefined) => void, prebuiltInstruction?: string, runtime?: RuntimeStepResolution): Promise<{
+        response: AgentResponse;
+        instruction: string;
+    }>;
+    /** Collect step:report events for each report file that exists */
+    emitStepReports(step: WorkflowStep): void;
+    private reportFiles;
+    /** Check if report file exists and collect for emission */
+    private checkReportFile;
+    /** Drain collected report files (called by engine after step execution) */
+    drainReportFiles(): Array<{
+        step: WorkflowStep;
+        filePath: string;
+        fileName: string;
+    }>;
+}
+//# sourceMappingURL=StepExecutor.d.ts.map

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

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