agentic-forge 0.0.0 → 0.7.0

package/dist/steps/base.js

@@ -0,0 +1,23 @@
+/** Base class and types for step executors. */
+export function buildTemplateContext(context) {
+    return {
+        variables: context.variables,
+        outputs: context.outputs,
+        workflow_id: context.workflowId,
+        ...context.variables,
+    };
+}
+export function resolveModel(context, stepModel) {
+    if (stepModel) {
+        return stepModel;
+    }
+    if (context.workflowSettings?.model) {
+        return context.workflowSettings.model;
+    }
+    const defaults = context.config.defaults;
+    return defaults?.model ?? "sonnet";
+}
+// --- Abstract base ---
+export class StepExecutor {
+}
+//# sourceMappingURL=base.js.map

package/dist/steps/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/steps/base.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAoB/C,MAAM,UAAU,oBAAoB,CAAC,OAAoB;IACxD,OAAO;QACN,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,WAAW,EAAE,OAAO,CAAC,UAAU;QAC/B,GAAI,OAAO,CAAC,SAAqC;KACjD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAoB,EAAE,SAAyB;IAC3E,IAAI,SAAS,EAAE,CAAC;QACf,OAAO,SAAS,CAAC;IAClB,CAAC;IACD,IAAI,OAAO,CAAC,gBAAgB,EAAE,KAAK,EAAE,CAAC;QACrC,OAAO,OAAO,CAAC,gBAAgB,CAAC,KAAK,CAAC;IACvC,CAAC;IACD,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,QAA+C,CAAC;IAChF,OAAQ,QAAQ,EAAE,KAAgB,IAAI,QAAQ,CAAC;AAChD,CAAC;AAWD,wBAAwB;AAExB,MAAM,OAAgB,YAAY;CAQjC"}

package/dist/steps/conditional-step.d.ts

@@ -0,0 +1,12 @@
+/** Conditional step executor. */
+import type { ConsoleOutput } from "../console.js";
+import type { WorkflowLogger } from "../logging/logger.js";
+import type { StepDefinition, WorkflowProgress } from "../types.js";
+import { type BranchStepExecutor, type StepContext, StepExecutor, type StepResult } from "./base.js";
+export declare class ConditionalStepExecutor extends StepExecutor {
+    private branchExecutor;
+    constructor(branchExecutor: BranchStepExecutor);
+    execute(step: StepDefinition, progress: WorkflowProgress, context: StepContext, logger: WorkflowLogger, console: ConsoleOutput): Promise<StepResult>;
+    evaluateCondition(condition: string, context: Record<string, unknown>): boolean;
+    resolveValue(expr: string, context: Record<string, unknown>): unknown;
+}

package/dist/steps/conditional-step.js

@@ -0,0 +1,106 @@
+/** Conditional step executor. */
+import { WORKFLOW_STATUS, updateStepCompleted, updateStepFailed } from "../progress.js";
+import { StepExecutor, buildTemplateContext, } from "./base.js";
+export class ConditionalStepExecutor extends StepExecutor {
+    branchExecutor;
+    constructor(branchExecutor) {
+        super();
+        this.branchExecutor = branchExecutor;
+    }
+    async execute(step, progress, context, logger, console) {
+        let condition = step.condition ?? "false";
+        logger.info(step.name, `Evaluating condition: ${condition}`);
+        const templateContext = buildTemplateContext(context);
+        if (context.renderer.hasVariables(condition)) {
+            condition = context.renderer.renderString(condition, templateContext);
+        }
+        const conditionResult = this.evaluateCondition(condition, templateContext);
+        logger.info(step.name, `Condition evaluated to: ${conditionResult}`);
+        console.info(`Conditional '${step.name}': ${condition} = ${conditionResult}`);
+        const stepsToRun = conditionResult ? step.thenSteps : step.elseSteps;
+        const branchName = conditionResult ? "then" : "else";
+        if (!stepsToRun || stepsToRun.length === 0) {
+            const outputSummary = `Condition ${conditionResult}, no '${branchName}' branch to execute`;
+            updateStepCompleted(progress, step.name, outputSummary);
+            console.stepComplete(step.name, outputSummary);
+            return { success: true, outputSummary };
+        }
+        logger.info(step.name, `Executing '${branchName}' branch with ${stepsToRun.length} steps`);
+        for (const subStep of stepsToRun) {
+            try {
+                const result = await this.branchExecutor(subStep, progress, context, logger, console);
+                if (!result.success) {
+                    logger.warning(step.name, `Conditional '${branchName}' branch stopped due to failure`);
+                    const errorMsg = `Step '${subStep.name}' failed: ${result.error}`;
+                    updateStepFailed(progress, step.name, errorMsg);
+                    console.stepFailed(step.name, `Step '${subStep.name}' failed`);
+                    progress.status = WORKFLOW_STATUS.FAILED;
+                    return { success: false, error: errorMsg };
+                }
+                if (progress.status === WORKFLOW_STATUS.FAILED) {
+                    logger.warning(step.name, `Conditional '${branchName}' branch stopped due to failure`);
+                    break;
+                }
+            }
+            catch (e) {
+                const errStr = e instanceof Error ? e.message : String(e);
+                logger.error(subStep.name, `Step failed in conditional branch: ${errStr}`);
+                const errorMsg = `Step '${subStep.name}' failed: ${errStr}`;
+                updateStepFailed(progress, step.name, errorMsg);
+                console.stepFailed(step.name, `Step '${subStep.name}' failed`);
+                progress.status = WORKFLOW_STATUS.FAILED;
+                return { success: false, error: errorMsg };
+            }
+        }
+        if (progress.status !== WORKFLOW_STATUS.FAILED) {
+            const outputSummary = `Executed '${branchName}' branch (${stepsToRun.length} steps)`;
+            updateStepCompleted(progress, step.name, outputSummary);
+            console.stepComplete(step.name, outputSummary);
+            logger.info(step.name, outputSummary);
+            return { success: true, outputSummary };
+        }
+        return { success: false, error: "Conditional execution failed" };
+    }
+    evaluateCondition(condition, context) {
+        const trimmed = condition.trim();
+        if (["true", "1", "yes"].includes(trimmed.toLowerCase())) {
+            return true;
+        }
+        if (["false", "0", "no", "none", ""].includes(trimmed.toLowerCase())) {
+            return false;
+        }
+        if (trimmed.includes("!=")) {
+            const [left, right] = trimmed.split("!=", 2);
+            const leftVal = this.resolveValue(left.trim(), context);
+            const rightVal = this.resolveValue(right.trim(), context);
+            return leftVal !== rightVal;
+        }
+        if (trimmed.includes("==")) {
+            const [left, right] = trimmed.split("==", 2);
+            const leftVal = this.resolveValue(left.trim(), context);
+            const rightVal = this.resolveValue(right.trim(), context);
+            return leftVal === rightVal;
+        }
+        const value = this.resolveValue(trimmed, context);
+        return (Boolean(value) && value !== "none" && value !== "None" && value !== "null" && value !== "");
+    }
+    resolveValue(expr, context) {
+        const trimmed = expr.trim();
+        if ((trimmed.startsWith("'") && trimmed.endsWith("'")) ||
+            (trimmed.startsWith('"') && trimmed.endsWith('"'))) {
+            return trimmed.slice(1, -1);
+        }
+        if (trimmed.startsWith("variables.")) {
+            const varName = trimmed.slice(10);
+            const vars = context.variables;
+            return vars?.[varName];
+        }
+        if (trimmed.startsWith("outputs.")) {
+            const outputName = trimmed.slice(8);
+            const outputs = context.outputs;
+            return outputs?.[outputName];
+        }
+        return context[trimmed] ?? trimmed;
+    }
+}
+//# sourceMappingURL=conditional-step.js.map

package/dist/steps/conditional-step.js.map

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

package/{src/steps/index.ts → dist/steps/index.d.ts}

@@ -1,13 +1,5 @@
 /** Step executors for workflow execution. */
-
-export {
-	StepContext,
-	StepResult,
-	StepExecutor,
-	BranchStepExecutor,
-	buildTemplateContext,
-	resolveModel,
-} from "./base.js";
+export { StepContext, StepResult, StepExecutor, BranchStepExecutor, buildTemplateContext, resolveModel, } from "./base.js";
 export { PromptStepExecutor } from "./prompt-step.js";
 export { SerialStepExecutor } from "./serial-step.js";
 export { ConditionalStepExecutor } from "./conditional-step.js";

package/dist/steps/index.js

@@ -0,0 +1,8 @@
+/** Step executors for workflow execution. */
+export { StepExecutor, buildTemplateContext, resolveModel, } from "./base.js";
+export { PromptStepExecutor } from "./prompt-step.js";
+export { SerialStepExecutor } from "./serial-step.js";
+export { ConditionalStepExecutor } from "./conditional-step.js";
+export { RalphLoopStepExecutor } from "./ralph-loop-step.js";
+export { ParallelStepExecutor } from "./parallel-step.js";
+//# sourceMappingURL=index.js.map

package/dist/steps/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/steps/index.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAE7C,OAAO,EAGN,YAAY,EAEZ,oBAAoB,EACpB,YAAY,GACZ,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/steps/parallel-step.d.ts

@@ -0,0 +1,11 @@
+/** Parallel step executor. */
+import type { ConsoleOutput } from "../console.js";
+import type { WorkflowLogger } from "../logging/logger.js";
+import type { StepDefinition, WorkflowProgress } from "../types.js";
+import { type BranchStepExecutor, type StepContext, StepExecutor, type StepResult } from "./base.js";
+export declare class ParallelStepExecutor extends StepExecutor {
+    private branchExecutor;
+    constructor(branchExecutor: BranchStepExecutor);
+    execute(step: StepDefinition, progress: WorkflowProgress, context: StepContext, logger: WorkflowLogger, console: ConsoleOutput): Promise<StepResult>;
+    private mergeWorktreeBranches;
+}

package/dist/steps/parallel-step.js

@@ -0,0 +1,166 @@
+/** Parallel step executor. */
+import { createWorktree, removeWorktree, runGit } from "../git/worktree.js";
+import { WORKFLOW_STATUS, updateStepCompleted, updateStepFailed } from "../progress.js";
+import { StepExecutor, } from "./base.js";
+export class ParallelStepExecutor extends StepExecutor {
+    branchExecutor;
+    constructor(branchExecutor) {
+        super();
+        this.branchExecutor = branchExecutor;
+    }
+    async execute(step, progress, context, logger, console) {
+        if (!step.steps || step.steps.length === 0) {
+            logger.warning(step.name, "Parallel step has no sub-steps");
+            updateStepCompleted(progress, step.name, "No sub-steps to execute");
+            console.stepComplete(step.name, "No sub-steps to execute");
+            return { success: true, outputSummary: "No sub-steps to execute" };
+        }
+        const useWorktree = step.git?.worktree ?? false;
+        logger.info(step.name, `Starting parallel execution of ${step.steps.length} branches`);
+        if (useWorktree) {
+            console.info(`Parallel: starting ${step.steps.length} branches (worktree isolation)`);
+        }
+        else {
+            console.info(`Parallel: starting ${step.steps.length} branches`);
+        }
+        // Register branches for parallel display
+        const branchNames = step.steps.map((s) => s.name);
+        console.registerParallelBranches(branchNames);
+        console.enterParallelMode();
+        const branchResults = {};
+        const failedBranches = [];
+        const worktrees = {};
+        const executeBranch = async (branchStep) => {
+            const branchContext = {
+                ...context,
+                variables: { ...context.variables },
+            };
+            let worktree = null;
+            try {
+                console.setParallelBranch(branchStep.name);
+                if (useWorktree) {
+                    worktree = createWorktree(progress.workflowName, branchStep.name, undefined, context.repoRoot);
+                    logger.info(branchStep.name, `Created worktree: ${worktree.path}`);
+                    console.info(`  Branch '${branchStep.name}' worktree: ${worktree.branch}`);
+                    branchContext.cwdOverride = worktree.path;
+                }
+                const result = await this.branchExecutor(branchStep, progress, branchContext, logger, console);
+                return [branchStep.name, result.success, result.outputSummary ?? "", worktree];
+            }
+            catch (e) {
+                const errStr = e instanceof Error ? (e.stack ?? e.message) : String(e);
+                logger.error(branchStep.name, `Branch failed with exception: ${errStr}`);
+                return [branchStep.name, false, String(e), worktree];
+            }
+        };
+        // Execute branches with concurrency cap from config
+        const execution = context.config?.execution;
+        const maxWorkers = execution?.maxWorkers ?? 4;
+        const settled = [];
+        const queue = [...step.steps];
+        const runNext = async () => {
+            while (queue.length > 0) {
+                const branchStep = queue.shift();
+                if (!branchStep)
+                    break;
+                try {
+                    const value = await executeBranch(branchStep);
+                    settled.push({ status: "fulfilled", value });
+                }
+                catch (reason) {
+                    settled.push({ status: "rejected", reason });
+                }
+            }
+        };
+        const workers = Array.from({ length: Math.min(maxWorkers, queue.length) }, () => runNext());
+        await Promise.all(workers);
+        const results = settled;
+        for (const result of results) {
+            if (result.status === "fulfilled") {
+                const [name, success, output, worktree] = result.value;
+                branchResults[name] = { success, output };
+                if (worktree) {
+                    worktrees[name] = worktree;
+                }
+                if (success) {
+                    console.info(`  Branch '${name}' completed`);
+                }
+                else {
+                    console.error(`  Branch '${name}' failed: ${output}`);
+                    failedBranches.push(name);
+                }
+            }
+            else {
+                // Promise rejected — should be rare since executeBranch catches errors
+                const reason = String(result.reason);
+                // We can't easily get the branch name from a rejected promise
+                // but this case is already handled by the try/catch inside executeBranch
+                logger.error(step.name, `Branch promise rejected: ${reason}`);
+            }
+        }
+        // Exit parallel mode
+        console.exitParallelMode();
+        // Handle merge modes
+        if (step.mergeMode === "merge" && Object.keys(worktrees).length > 0) {
+            const mergeFailures = this.mergeWorktreeBranches(step, worktrees, failedBranches, context, logger, console);
+            failedBranches.push(...mergeFailures);
+        }
+        if (step.mergeMode === "independent" && Object.keys(worktrees).length > 0) {
+            for (const [name, worktree] of Object.entries(worktrees)) {
+                removeWorktree(worktree, context.repoRoot, false);
+                logger.info(name, `Worktree removed, branch preserved: ${worktree.branch}`);
+            }
+        }
+        // Handle completion based on merge strategy
+        if (step.mergeStrategy === "wait-all") {
+            if (failedBranches.length > 0 && step.mergeMode !== "independent") {
+                const errorMsg = `Parallel branches failed: ${failedBranches.join(", ")}`;
+                updateStepFailed(progress, step.name, errorMsg);
+                console.stepFailed(step.name, errorMsg);
+                progress.status = WORKFLOW_STATUS.FAILED;
+                return { success: false, error: errorMsg };
+            }
+            const completed = step.steps.length - failedBranches.length;
+            let outputSummary = `Completed ${completed}/${step.steps.length} branches`;
+            if (failedBranches.length > 0) {
+                outputSummary += ` (failed: ${failedBranches.join(", ")})`;
+            }
+            updateStepCompleted(progress, step.name, outputSummary);
+            console.stepComplete(step.name, outputSummary);
+            logger.info(step.name, outputSummary);
+            return { success: true, outputSummary };
+        }
+        const outputSummary = "Parallel execution completed";
+        updateStepCompleted(progress, step.name, outputSummary);
+        console.stepComplete(step.name, outputSummary);
+        logger.info(step.name, outputSummary);
+        return { success: true, outputSummary };
+    }
+    mergeWorktreeBranches(step, worktrees, failedBranches, context, logger, console) {
+        console.info("Merging parallel branches...");
+        const mergeFailures = [];
+        for (const [name, worktree] of Object.entries(worktrees)) {
+            if (failedBranches.includes(name)) {
+                removeWorktree(worktree, context.repoRoot, true);
+                logger.info(name, "Failed branch worktree removed");
+                continue;
+            }
+            try {
+                runGit(["checkout", worktree.baseBranch], context.repoRoot);
+                runGit(["merge", "--no-ff", "-m", `Merge parallel branch: ${name}`, worktree.branch], context.repoRoot);
+                logger.info(name, `Merged branch ${worktree.branch} into ${worktree.baseBranch}`);
+                console.info(`  Merged '${name}'`);
+            }
+            catch (e) {
+                const errStr = e instanceof Error ? e.message : String(e);
+                logger.error(name, `Merge failed: ${errStr}`);
+                console.error(`  Merge failed for '${name}': ${errStr}`);
+                mergeFailures.push(name);
+            }
+            removeWorktree(worktree, context.repoRoot, true);
+            logger.info(name, "Worktree and branch cleaned up");
+        }
+        return mergeFailures;
+    }
+}
+//# sourceMappingURL=parallel-step.js.map

package/dist/steps/parallel-step.js.map

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

package/dist/steps/prompt-step.d.ts

@@ -0,0 +1,8 @@
+/** Prompt step executor. */
+import type { ConsoleOutput } from "../console.js";
+import type { WorkflowLogger } from "../logging/logger.js";
+import type { StepDefinition, WorkflowProgress } from "../types.js";
+import { type StepContext, StepExecutor, type StepResult } from "./base.js";
+export declare class PromptStepExecutor extends StepExecutor {
+    execute(step: StepDefinition, progress: WorkflowProgress, context: StepContext, logger: WorkflowLogger, console: ConsoleOutput): Promise<StepResult>;
+}

package/dist/steps/prompt-step.js

@@ -0,0 +1,94 @@
+/** Prompt step executor. */
+import { existsSync, readFileSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { extractJson, extractSummary } from "../console.js";
+import { WORKFLOW_STATUS, updateStepCompleted, updateStepFailed } from "../progress.js";
+import { runClaude } from "../runner.js";
+import { StepExecutor, buildTemplateContext, resolveModel, } from "./base.js";
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+export class PromptStepExecutor extends StepExecutor {
+    async execute(step, progress, context, logger, console) {
+        let prompt = step.prompt ?? "";
+        const templateContext = buildTemplateContext(context);
+        if (context.renderer.hasVariables(prompt)) {
+            prompt = context.renderer.renderString(prompt, templateContext);
+        }
+        const cwd = context.cwdOverride ?? context.repoRoot;
+        // Load agent file if specified (fallback to bundled agents)
+        if (step.agent) {
+            let agentPath = path.join(context.repoRoot, step.agent);
+            if (!existsSync(agentPath)) {
+                agentPath = path.join(__dirname, "..", "agents", path.basename(step.agent));
+            }
+            if (existsSync(agentPath)) {
+                const agentContent = readFileSync(agentPath, "utf-8");
+                prompt = `${agentContent}\n\n${prompt}`;
+            }
+        }
+        const timeout = (step.stepTimeoutMinutes ?? 60) * 60;
+        const defaults = context.config.defaults;
+        const maxRetry = step.stepMaxRetry ?? defaults?.maxRetry ?? 3;
+        const bypassPermissions = context.workflowSettings?.bypassPermissions ?? false;
+        const allowedTools = context.workflowSettings?.requiredTools?.length
+            ? context.workflowSettings.requiredTools
+            : null;
+        // Always enable streaming when console is provided
+        const printOutput = true;
+        for (let attempt = 0; attempt <= maxRetry; attempt++) {
+            const result = await runClaude({
+                prompt,
+                cwd,
+                model: resolveModel(context, step.model),
+                timeout,
+                printOutput,
+                skipPermissions: bypassPermissions,
+                allowedTools,
+                console,
+                workflowId: context.workflowId,
+            });
+            if (result.success) {
+                // Use session output context if available, fall back to extracted summary
+                const sessionOut = result.sessionOutput;
+                let outputSummary;
+                if (sessionOut.isSuccess && sessionOut.context) {
+                    outputSummary = sessionOut.context;
+                    if (sessionOut.sessionId) {
+                        logger.info(step.name, `Session ID: ${sessionOut.sessionId}`);
+                    }
+                }
+                else {
+                    outputSummary = result.stdout ? extractSummary(result.stdout) : "";
+                }
+                // Try to extract structured JSON from skill output
+                const stepOutput = result.stdout ? extractJson(result.stdout) : null;
+                const outputValue = stepOutput ?? result.stdout;
+                updateStepCompleted(progress, step.name, outputSummary, outputValue);
+                console.stepComplete(step.name, outputSummary);
+                logger.info(step.name, "Step completed successfully");
+                return { success: true, outputSummary, fullOutput: result.stdout };
+            }
+            if (attempt < maxRetry) {
+                const errorSummary = result.stderr ? extractSummary(result.stderr) : "Unknown error";
+                console.stepRetry(step.name, attempt + 1, maxRetry + 1, errorSummary);
+                logger.warning(step.name, `Attempt ${attempt + 1} failed, retrying...`, {
+                    error: result.stderr,
+                });
+                if (progress.currentStep) {
+                    progress.currentStep.retryCount = attempt + 1;
+                }
+            }
+            else {
+                const errorMsg = result.stderr || "Step failed";
+                const errorSummary = errorMsg ? extractSummary(errorMsg) : "Unknown error";
+                console.stepFailed(step.name, errorSummary);
+                updateStepFailed(progress, step.name, errorMsg);
+                progress.status = WORKFLOW_STATUS.FAILED;
+                logger.error(step.name, `Step failed after ${maxRetry + 1} attempts`);
+                return { success: false, error: errorMsg };
+            }
+        }
+        return { success: false, error: "Unexpected exit from retry loop" };
+    }
+}
+//# sourceMappingURL=prompt-step.js.map

package/dist/steps/prompt-step.js.map

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

package/dist/steps/ralph-loop-step.d.ts

@@ -0,0 +1,8 @@
+/** Ralph loop step executor. */
+import type { ConsoleOutput } from "../console.js";
+import type { WorkflowLogger } from "../logging/logger.js";
+import type { StepDefinition, WorkflowProgress } from "../types.js";
+import { type StepContext, StepExecutor, type StepResult } from "./base.js";
+export declare class RalphLoopStepExecutor extends StepExecutor {
+    execute(step: StepDefinition, progress: WorkflowProgress, context: StepContext, logger: WorkflowLogger, console: ConsoleOutput): Promise<StepResult>;
+}

package/dist/steps/ralph-loop-step.js

@@ -0,0 +1,132 @@
+/** Ralph loop step executor. */
+import { extractSummary } from "../console.js";
+import { WORKFLOW_STATUS, updateStepCompleted, updateStepFailed } from "../progress.js";
+import { buildRalphSystemMessage, createRalphState, deactivateRalphState, detectCompletionPromise, loadRalphState, updateRalphIteration, } from "../ralph-loop.js";
+import { runClaude } from "../runner.js";
+import { StepExecutor, buildTemplateContext, resolveModel, } from "./base.js";
+export class RalphLoopStepExecutor extends StepExecutor {
+    async execute(step, progress, context, logger, console) {
+        const promptTemplate = step.prompt ?? "";
+        const templateContext = buildTemplateContext(context);
+        let completionPromise = step.completionPromise ?? "COMPLETE";
+        if (context.renderer.hasVariables(completionPromise)) {
+            completionPromise = context.renderer.renderString(completionPromise, templateContext);
+        }
+        // Handle max_iterations which may be a template string or integer
+        const maxIterationsRaw = step.maxIterations;
+        let maxIterations;
+        if (typeof maxIterationsRaw === "string" && context.renderer.hasVariables(maxIterationsRaw)) {
+            maxIterations = Number.parseInt(context.renderer.renderString(maxIterationsRaw, templateContext), 10);
+        }
+        else {
+            maxIterations = maxIterationsRaw ? Number.parseInt(String(maxIterationsRaw), 10) : 5;
+        }
+        const timeout = (step.stepTimeoutMinutes ?? 30) * 60;
+        const bypassPermissions = context.workflowSettings?.bypassPermissions ?? false;
+        const allowedTools = context.workflowSettings?.requiredTools?.length
+            ? context.workflowSettings.requiredTools
+            : null;
+        // Always enable streaming when console is provided
+        const printOutput = true;
+        logger.info(step.name, `Starting Ralph loop (max ${maxIterations} iterations)`);
+        console.info(`Ralph loop starting (max ${maxIterations} iterations)`);
+        const allOutputs = [];
+        // Check for existing ralph state to resume from
+        const existingState = loadRalphState(progress.workflowId, step.name, context.repoRoot);
+        let startIteration;
+        if (existingState?.active) {
+            startIteration = existingState.iteration;
+            logger.info(step.name, `Resuming Ralph loop from iteration ${startIteration}`);
+            console.info(`Resuming Ralph loop from iteration ${startIteration}`);
+        }
+        else {
+            startIteration = 1;
+        }
+        for (let iteration = startIteration; iteration <= maxIterations; iteration++) {
+            logger.info(step.name, `Ralph loop iteration ${iteration}/${maxIterations}`);
+            // Render prompt with iteration context
+            const iterationContext = {
+                ...templateContext,
+                iteration,
+                max_iterations: maxIterations,
+            };
+            let prompt;
+            if (context.renderer.hasVariables(promptTemplate)) {
+                prompt = context.renderer.renderString(promptTemplate, iterationContext);
+            }
+            else {
+                prompt = promptTemplate;
+            }
+            // Create ralph state on first iteration
+            if (iteration === startIteration && !existingState?.active) {
+                createRalphState(progress.workflowId, step.name, prompt, maxIterations, completionPromise, context.repoRoot);
+            }
+            const systemMessage = buildRalphSystemMessage(iteration, maxIterations, completionPromise);
+            const fullPrompt = `${systemMessage}${prompt}`;
+            // Display iteration header BEFORE running Claude
+            console.ralphIterationStart(step.name, iteration, maxIterations);
+            const result = await runClaude({
+                prompt: fullPrompt,
+                cwd: context.repoRoot,
+                model: resolveModel(context, step.model),
+                timeout,
+                printOutput,
+                skipPermissions: bypassPermissions,
+                allowedTools,
+                console,
+                workflowId: context.workflowId,
+            });
+            if (!result.success) {
+                const errorSummary = result.stderr ? extractSummary(result.stderr) : "Unknown error";
+                logger.warning(step.name, `Iteration ${iteration} failed: ${result.stderr}`);
+                console.ralphIteration(step.name, iteration, maxIterations, `Failed: ${errorSummary}`);
+                if (iteration < maxIterations) {
+                    updateRalphIteration(progress.workflowId, step.name, context.repoRoot);
+                    continue;
+                }
+                deactivateRalphState(progress.workflowId, step.name, context.repoRoot);
+                const errorMsg = `Ralph loop failed after ${maxIterations} iterations`;
+                console.stepFailed(step.name, errorMsg);
+                updateStepFailed(progress, step.name, errorMsg);
+                progress.status = WORKFLOW_STATUS.FAILED;
+                return { success: false, error: errorMsg };
+            }
+            allOutputs.push(result.stdout);
+            // Print iteration summary
+            const iterationSummary = extractSummary(result.stdout);
+            console.ralphIteration(step.name, iteration, maxIterations, iterationSummary);
+            const completionResult = detectCompletionPromise(result.stdout, completionPromise);
+            // Check for failure signal first
+            if (completionResult.isFailed) {
+                const errorMsg = `Ralph loop failed: ${completionResult.failureReason}`;
+                logger.error(step.name, errorMsg);
+                deactivateRalphState(progress.workflowId, step.name, context.repoRoot);
+                const combinedOutput = allOutputs.join("\n\n---\n\n");
+                console.stepFailed(step.name, errorMsg);
+                updateStepFailed(progress, step.name, errorMsg);
+                progress.status = WORKFLOW_STATUS.FAILED;
+                return { success: false, error: errorMsg, fullOutput: combinedOutput };
+            }
+            if (completionResult.isComplete && completionResult.promiseMatched) {
+                logger.info(step.name, `Ralph loop completed at iteration ${iteration}`);
+                deactivateRalphState(progress.workflowId, step.name, context.repoRoot);
+                const combinedOutput = allOutputs.join("\n\n---\n\n");
+                const outputSummary = `Completed in ${iteration} iterations`;
+                updateStepCompleted(progress, step.name, outputSummary, combinedOutput);
+                console.ralphComplete(step.name, iteration, maxIterations);
+                return { success: true, outputSummary, fullOutput: combinedOutput };
+            }
+            if (iteration < maxIterations) {
+                updateRalphIteration(progress.workflowId, step.name, context.repoRoot);
+            }
+        }
+        logger.warning(step.name, `Ralph loop reached max iterations (${maxIterations}) without completion`);
+        deactivateRalphState(progress.workflowId, step.name, context.repoRoot);
+        const combinedOutput = allOutputs.join("\n\n---\n\n");
+        const outputSummary = `Max iterations (${maxIterations}) reached without completion promise`;
+        updateStepCompleted(progress, step.name, outputSummary, combinedOutput);
+        console.ralphMaxIterations(step.name, maxIterations);
+        return { success: true, outputSummary, fullOutput: combinedOutput };
+    }
+}
+//# sourceMappingURL=ralph-loop-step.js.map