night-orch 0.1.0

package/dist/loop/diff-guard.d.ts

@@ -0,0 +1,21 @@
+export interface DiffStats {
+    changedFiles: number;
+    insertions: number;
+    deletions: number;
+    totalChangedLines: number;
+}
+/**
+ * Check diff size against configured limits.
+ * Runs `git diff --stat` in the worktree.
+ */
+export declare function checkDiffSize(worktreePath: string, limits: {
+    maxChangedFiles: number;
+    maxChangedLines: number;
+}, opts?: {
+    staged?: boolean;
+}): Promise<{
+    ok: boolean;
+    stats: DiffStats;
+    reason: string | null;
+}>;
+//# sourceMappingURL=diff-guard.d.ts.map

package/dist/loop/diff-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff-guard.d.ts","sourceRoot":"","sources":["../../src/loop/diff-guard.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,SAAS;IACxB,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,iBAAiB,EAAE,MAAM,CAAA;CAC1B;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE;IAAE,eAAe,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,EAC5D,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GAC9B,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CA8BnE"}

package/dist/loop/diff-guard.js

@@ -0,0 +1,52 @@
+import { runGit } from '../git/process.js';
+/**
+ * Check diff size against configured limits.
+ * Runs `git diff --stat` in the worktree.
+ */
+export async function checkDiffSize(worktreePath, limits, opts = {}) {
+    const args = opts.staged
+        ? ['diff', '--cached', '--stat', '--stat-width=300']
+        : ['diff', '--stat', '--stat-width=300', 'HEAD'];
+    const { stdout } = await runGit(args, {
+        cwd: worktreePath,
+        env: { LC_ALL: 'C' },
+        reject: false,
+    });
+    const stats = parseDiffStat(stdout);
+    if (stats.changedFiles > limits.maxChangedFiles) {
+        return {
+            ok: false,
+            stats,
+            reason: `Too many changed files: ${stats.changedFiles} > ${limits.maxChangedFiles}`,
+        };
+    }
+    if (stats.totalChangedLines > limits.maxChangedLines) {
+        return {
+            ok: false,
+            stats,
+            reason: `Too many changed lines: ${stats.totalChangedLines} > ${limits.maxChangedLines}`,
+        };
+    }
+    return { ok: true, stats, reason: null };
+}
+function parseDiffStat(output) {
+    const lines = output.trim().split('\n');
+    if (lines.length === 0 || output.trim() === '') {
+        return { changedFiles: 0, insertions: 0, deletions: 0, totalChangedLines: 0 };
+    }
+    // Last line is the summary: "3 files changed, 10 insertions(+), 2 deletions(-)"
+    const summary = lines[lines.length - 1] ?? '';
+    const filesMatch = summary.match(/(\d+)\s+files?\s+changed/);
+    const insertMatch = summary.match(/(\d+)\s+insertions?\(\+\)/);
+    const deleteMatch = summary.match(/(\d+)\s+deletions?\(-\)/);
+    const changedFiles = filesMatch ? parseInt(filesMatch[1], 10) : 0;
+    const insertions = insertMatch ? parseInt(insertMatch[1], 10) : 0;
+    const deletions = deleteMatch ? parseInt(deleteMatch[1], 10) : 0;
+    return {
+        changedFiles,
+        insertions,
+        deletions,
+        totalChangedLines: insertions + deletions,
+    };
+}
+//# sourceMappingURL=diff-guard.js.map

package/dist/loop/diff-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff-guard.js","sourceRoot":"","sources":["../../src/loop/diff-guard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAS1C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,YAAoB,EACpB,MAA4D,EAC5D,OAA6B,EAAE;IAE/B,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM;QACtB,CAAC,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,kBAAkB,CAAC;QACpD,CAAC,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,CAAC,CAAA;IAElD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE;QACpC,GAAG,EAAE,YAAY;QACjB,GAAG,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE;QACpB,MAAM,EAAE,KAAK;KACd,CAAC,CAAA;IAEF,MAAM,KAAK,GAAG,aAAa,CAAC,MAAM,CAAC,CAAA;IAEnC,IAAI,KAAK,CAAC,YAAY,GAAG,MAAM,CAAC,eAAe,EAAE,CAAC;QAChD,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK;YACL,MAAM,EAAE,2BAA2B,KAAK,CAAC,YAAY,MAAM,MAAM,CAAC,eAAe,EAAE;SACpF,CAAA;IACH,CAAC;IAED,IAAI,KAAK,CAAC,iBAAiB,GAAG,MAAM,CAAC,eAAe,EAAE,CAAC;QACrD,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK;YACL,MAAM,EAAE,2BAA2B,KAAK,CAAC,iBAAiB,MAAM,MAAM,CAAC,eAAe,EAAE;SACzF,CAAA;IACH,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAA;AAC1C,CAAC;AAED,SAAS,aAAa,CAAC,MAAc;IACnC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IACvC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC/C,OAAO,EAAE,YAAY,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,iBAAiB,EAAE,CAAC,EAAE,CAAA;IAC/E,CAAC;IAED,gFAAgF;IAChF,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,CAAA;IAC7C,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAA;IAC5D,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAA;IAC9D,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAA;IAE5D,MAAM,YAAY,GAAG,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAClE,MAAM,UAAU,GAAG,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAClE,MAAM,SAAS,GAAG,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAEjE,OAAO;QACL,YAAY;QACZ,UAAU;QACV,SAAS;QACT,iBAAiB,EAAE,UAAU,GAAG,SAAS;KAC1C,CAAA;AACH,CAAC"}

package/dist/loop/engine.d.ts

@@ -0,0 +1,32 @@
+import type { RunContext } from './types.js';
+import type { Config } from '../config/schema.js';
+import type { WorkerAdapter } from '../workers/types.js';
+import type { MetricsService } from '../metrics/service.js';
+import type { ResolvedWorkflow } from './workflow.js';
+import type Database from 'better-sqlite3';
+import type { AgentEvent } from '../events/types.js';
+export interface LoopDependencies {
+    db: Database.Database;
+    config: Config;
+    adapters: Record<string, WorkerAdapter>;
+    workflow: ResolvedWorkflow;
+    envOverrides?: Record<string, string>;
+    metrics?: MetricsService;
+    onAgentEvent?: (event: AgentEvent) => void;
+    onPlanReady?: (ctx: RunContext) => Promise<void>;
+    /**
+     * Called on every phase checkpoint to extend the lease on the issue this
+     * run is processing. Optional — tests and sub-loops pass no lease
+     * manager. Returning false signals the lease has expired and a concurrent
+     * engine may have picked the issue up; the engine logs a warning but
+     * does not abort (bailing mid-run has its own race risks).
+     */
+    leaseHeartbeat?: () => boolean;
+}
+/**
+ * Execute the configurable workflow loop.
+ * Walks through workflow steps in order, delegating execution to the step executor.
+ * Returns the final RunContext with terminal state.
+ */
+export declare function executeLoop(initialCtx: RunContext, deps: LoopDependencies): Promise<RunContext>;
+//# sourceMappingURL=engine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/loop/engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAC5C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAUrD,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAA;AAE1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAEpD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAA;IACrB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;IACvC,QAAQ,EAAE,gBAAgB,CAAA;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACrC,OAAO,CAAC,EAAE,cAAc,CAAA;IACxB,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAA;IAC1C,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAChD;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,MAAM,OAAO,CAAA;CAC/B;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,UAAU,EAAE,UAAU,EACtB,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,UAAU,CAAC,CA8QrB"}

package/dist/loop/engine.js

@@ -0,0 +1,376 @@
+import { updateContext, recordPhase } from './context.js';
+import { commitChanges } from './commit.js';
+import { executeStep } from './step-executor.js';
+import { Checkpoint } from './checkpoint.js';
+import { CostTracker, describeBudgetBlock, costLimitRecoveryHint } from './cost.js';
+import { estimateWorkerCostUsd } from './pricing.js';
+import { logger } from '../utils/logger.js';
+import { utcIsoFromMs } from '../utils/time.js';
+import { buildPlanningPrdPath, isPlanningIssue } from '../planning/mode.js';
+/**
+ * Execute the configurable workflow loop.
+ * Walks through workflow steps in order, delegating execution to the step executor.
+ * Returns the final RunContext with terminal state.
+ */
+export async function executeLoop(initialCtx, deps) {
+    const { db, config, metrics } = deps;
+    const checkpoint = new Checkpoint(db);
+    const costTracker = new CostTracker(db);
+    const resumedCtx = checkpoint.resumeFromCheckpoint(initialCtx.runId, initialCtx);
+    let ctx = resumedCtx ?? initialCtx;
+    const stepDeps = {
+        adapters: deps.adapters,
+        config: deps.config,
+        envOverrides: deps.envOverrides,
+        metrics: deps.metrics,
+        onAgentEvent: deps.onAgentEvent,
+    };
+    const steps = deps.workflow.steps;
+    const checkpointPhaseData = getCheckpointPhaseData(db, initialCtx.runId);
+    const persistedDecisions = checkpoint.getDecisionOutcomes(initialCtx.runId);
+    // If a decide step terminated the previous attempt mid-action, replay
+    // that terminal outcome instead of re-entering the loop. Without this,
+    // a crash between decide-checkpoint and action would silently re-route
+    // to iterate and discard the intended terminal state.
+    const terminalOutcome = findTerminalDecisionOutcome(persistedDecisions);
+    if (terminalOutcome) {
+        logger.info({ runId: ctx.runId, phase: terminalOutcome.phase, action: terminalOutcome.outcome.action }, 'Resume: replaying persisted terminal decision outcome');
+        return applyPersistedDecisionOutcome(ctx, terminalOutcome);
+    }
+    let stepIndex = resolveStartingStepIndex(steps, resumedCtx, checkpointPhaseData, checkpoint.getCompletedPhases(initialCtx.runId));
+    while (stepIndex < steps.length) {
+        const step = steps[stepIndex];
+        // Skip step if skipWhen matches triage level. Emit paired
+        // phase_started/phase_completed events so the event stream stays
+        // well-formed and observability consumers see the skip.
+        if ('skipWhen' in step && step.skipWhen === ctx.triageResult.level) {
+            checkpoint.phaseSkipped(ctx.runId, step.id, ctx.iteration);
+            ctx = recordPhase(ctx, step.id, 'skipped');
+            stepIndex++;
+            continue;
+        }
+        // Cost check before worker steps
+        if (step.type === 'worker') {
+            const budget = costTracker.checkBudget(ctx.runId, config.security, config.cost?.model ?? 'pay-per-use');
+            if (budget.overBudget) {
+                const blockMessage = `${describeBudgetBlock(budget)}. ${costLimitRecoveryHint(budget.limit)}`;
+                logger.warn({
+                    runId: ctx.runId,
+                    limit: budget.limit,
+                    actualUsd: budget.actualUsd,
+                    limitUsd: budget.limitUsd,
+                }, 'Cost limit exceeded');
+                // Emit paired phase_started/phase_completed with a blocked payload
+                // so the event stream remains consistent across block early-returns.
+                checkpoint.phaseBlocked(ctx.runId, step.id, blockMessage, ctx.iteration);
+                return recordPhase(updateContext(ctx, {
+                    currentPhase: 'blocked',
+                    terminalStatus: 'blocked',
+                    blockReason: 'cost_limit',
+                    stepOutputs: {
+                        ...ctx.stepOutputs,
+                        blockMessage,
+                    },
+                }), step.id, 'failure');
+            }
+        }
+        // Execute step
+        const stepStart = Date.now();
+        const stepStartedAt = utcIsoFromMs(stepStart);
+        ctx = updateContext(ctx, { currentPhase: step.id });
+        checkpoint.phaseStarted(ctx.runId, step.id, ctx.iteration);
+        const result = await executeStep(ctx, step, stepDeps);
+        ctx = result.ctx;
+        const stepDurationMs = Date.now() - stepStart;
+        // Cost tracking for worker steps
+        if (step.type === 'worker') {
+            ctx = applyEstimatedWorkerCost(ctx, costTracker, config.cost, step.role, result.pricingIdentity, stepDurationMs, result.tokenUsage);
+            try {
+                metrics?.observePhaseDuration(step.id, stepDurationMs / 1000);
+            }
+            catch { /* best-effort */ }
+        }
+        if (step.type === 'verify') {
+            try {
+                metrics?.observePhaseDuration('verify', stepDurationMs / 1000);
+                metrics?.observeVerifyDuration(stepDurationMs / 1000);
+                const allPassed = ctx.verifyResults.length > 0 && ctx.verifyResults.every(r => r.passed);
+                metrics?.incVerifyRuns(allPassed ? 'pass' : 'fail');
+            }
+            catch { /* best-effort */ }
+        }
+        // Determine step success
+        const stepSuccess = determineStepSuccess(step, ctx);
+        // stopOnPlannerFailure check
+        if (step.type === 'worker' && step.role === 'planner' && !stepSuccess && config.loop.stopOnPlannerFailure) {
+            logger.error({ runId: ctx.runId }, 'Planner failed and stopOnPlannerFailure is true');
+            const artifacts = buildStepArtifacts(step, ctx);
+            checkpoint.phaseCompleted(ctx.runId, step.id, artifacts, ctx.iteration);
+            return recordPhase(updateContext(ctx, { currentPhase: 'error', terminalStatus: 'error' }), step.id, 'failure', {}, stepStartedAt);
+        }
+        // Checkpoint and record
+        const artifacts = buildStepArtifacts(step, ctx);
+        checkpoint.phaseCompleted(ctx.runId, step.id, artifacts, ctx.iteration);
+        // Persist sessionIds + stepOutputs so crash recovery can rehydrate
+        // multi-step workflow continuity (worker --continue chains and custom
+        // step outputs not captured by the builtin artifact map).
+        checkpoint.persistRunState(ctx.runId, ctx.sessionIds, ctx.stepOutputs);
+        // Extend the lease — a long workflow may run longer than the lease
+        // duration and would otherwise fall to cleanExpired mid-run.
+        if (deps.leaseHeartbeat) {
+            const held = deps.leaseHeartbeat();
+            if (!held) {
+                logger.warn({ runId: ctx.runId, phase: step.id }, 'Lease heartbeat failed — lease was released or taken over. Continuing cautiously.');
+            }
+        }
+        ctx = recordPhase(ctx, step.id, stepSuccess ? 'success' : 'failure', {}, stepStartedAt);
+        // Fire onPlanReady after plan step completes with a plan
+        if (step.type === 'worker' && step.role === 'planner' && ctx.plan && deps.onPlanReady) {
+            try {
+                await deps.onPlanReady(ctx);
+            }
+            catch (err) {
+                logger.warn({ runId: ctx.runId, repo: ctx.repo, issueNumber: ctx.issueNumber, err }, 'Failed to post plan summary');
+            }
+        }
+        // Handle decide step routing
+        if (step.type === 'decide' && result.decision) {
+            const decision = result.decision;
+            logger.info({ runId: ctx.runId, decision: decision.action, reason: decision.reason }, 'Loop decision');
+            // Persist decision outcome BEFORE taking action. If a crash happens
+            // between the decision and the terminal state write, resume will
+            // replay the outcome rather than re-routing to iterate.
+            checkpoint.recordDecisionOutcome(ctx.runId, step.id, {
+                action: decision.action,
+                reason: decision.reason,
+                blockReason: decision.action === 'block' ? decision.blockReason : null,
+            });
+            switch (decision.action) {
+                case 'publish': {
+                    const planningOnly = isPlanningIssue(ctx.issue.labels, ctx.repoConfig);
+                    const planningOnlyPrdPath = planningOnly
+                        ? buildPlanningPrdPath(ctx.issueNumber, ctx.issue.title, ctx.repoConfig)
+                        : undefined;
+                    const commitResult = await commitChanges(ctx.worktreePath, ctx.issueNumber, ctx.issue.title, config.security, {
+                        planningOnlyPrdPath,
+                        issueLabels: ctx.issue.labels,
+                    });
+                    if (!commitResult.committed) {
+                        logger.warn({ reason: commitResult.reason }, 'Commit skipped');
+                        if (commitResult.blockRun) {
+                            const blockMessage = commitResult.reason ?? 'Commit blocked by repository policy';
+                            return recordPhase(updateContext(ctx, {
+                                currentPhase: 'blocked',
+                                terminalStatus: 'blocked',
+                                stepOutputs: {
+                                    ...ctx.stepOutputs,
+                                    blockMessage,
+                                },
+                            }), 'publish', 'failure');
+                        }
+                    }
+                    return recordPhase(updateContext(ctx, { currentPhase: 'completed', terminalStatus: 'publish' }), 'publish', 'success');
+                }
+                case 'iterate': {
+                    ctx = updateContext(ctx, {
+                        iteration: ctx.iteration + 1,
+                        reviewFindings: [...ctx.reviewFindings, ...decision.findings],
+                        reviewResult: null,
+                        verifyResults: [],
+                    });
+                    try {
+                        metrics?.incLoopIterations(ctx.repo);
+                    }
+                    catch { /* best-effort */ }
+                    logger.info({ runId: ctx.runId, iteration: ctx.iteration }, 'Iterating loop');
+                    const jumpTarget = step.onIterate;
+                    const jumpIndex = steps.findIndex(s => s.id === jumpTarget);
+                    if (jumpIndex === -1) {
+                        logger.error({ runId: ctx.runId, jumpTarget }, 'Iterate target step not found');
+                        return recordPhase(updateContext(ctx, { currentPhase: 'error', terminalStatus: 'error' }), 'decision', 'failure');
+                    }
+                    stepIndex = jumpIndex;
+                    continue;
+                }
+                case 'block':
+                    return recordPhase(updateContext(ctx, {
+                        currentPhase: 'blocked',
+                        terminalStatus: 'blocked',
+                        blockReason: decision.blockReason,
+                        stepOutputs: {
+                            ...ctx.stepOutputs,
+                            blockMessage: decision.reason,
+                        },
+                    }), 'decision', 'failure');
+                case 'error':
+                    return recordPhase(updateContext(ctx, { currentPhase: 'error', terminalStatus: 'error' }), 'decision', 'failure');
+            }
+        }
+        stepIndex++;
+    }
+    // Should not reach here — the decide step should have routed to a terminal state
+    return recordPhase(updateContext(ctx, { currentPhase: 'error', terminalStatus: 'error' }), 'error', 'failure');
+}
+function resolveStartingStepIndex(steps, resumedCtx, checkpointPhaseData, completedPhases) {
+    if (!resumedCtx)
+        return 0;
+    const resumedPhaseIndex = steps.findIndex((step) => step.id === resumedCtx.currentPhase);
+    if (resumedPhaseIndex === -1)
+        return 0;
+    const resumedStep = steps[resumedPhaseIndex];
+    // Completed-phases sentinel is authoritative when present. Pre-migration
+    // data (no sentinel) falls back to the artifact-shape check.
+    const hasCompletedSentinel = completedPhases.length > 0;
+    const artifactComplete = isStepCheckpointComplete(resumedStep, checkpointPhaseData[resumedStep.id]);
+    const isCompletedCheckpoint = hasCompletedSentinel
+        ? completedPhases.includes(resumedStep.id) && artifactComplete
+        : artifactComplete;
+    if (!isCompletedCheckpoint) {
+        return resumedPhaseIndex;
+    }
+    if (resumedStep.type === 'decide') {
+        // Decide steps without a persisted terminal outcome (checked earlier)
+        // fall through to the iterate target on resume — the crashed attempt
+        // chose iterate.
+        const iterateTargetIndex = steps.findIndex((step) => step.id === resumedStep.onIterate);
+        return iterateTargetIndex >= 0 ? iterateTargetIndex : 0;
+    }
+    const nextStepIndex = resumedPhaseIndex + 1;
+    return nextStepIndex < steps.length ? nextStepIndex : resumedPhaseIndex;
+}
+/**
+ * If a persisted decision outcome is terminal (publish/block/error),
+ * return it so the engine can replay the outcome on resume. iterate is
+ * not terminal — the crashed attempt went on to re-run earlier steps.
+ */
+function findTerminalDecisionOutcome(outcomes) {
+    for (const [phase, outcome] of Object.entries(outcomes)) {
+        if (outcome.action === 'publish' || outcome.action === 'block' || outcome.action === 'error') {
+            return { phase, outcome };
+        }
+    }
+    return null;
+}
+function applyPersistedDecisionOutcome(ctx, terminal) {
+    const { phase, outcome } = terminal;
+    switch (outcome.action) {
+        case 'publish':
+            return recordPhase(updateContext(ctx, { currentPhase: 'completed', terminalStatus: 'publish' }), phase, 'success');
+        case 'block':
+            return recordPhase(updateContext(ctx, {
+                currentPhase: 'blocked',
+                terminalStatus: 'blocked',
+                blockReason: (outcome.blockReason ?? null),
+                stepOutputs: {
+                    ...ctx.stepOutputs,
+                    blockMessage: outcome.reason ?? 'Blocked by prior decide outcome',
+                },
+            }), phase, 'failure');
+        case 'error':
+            return recordPhase(updateContext(ctx, { currentPhase: 'error', terminalStatus: 'error' }), phase, 'failure');
+        default:
+            return ctx;
+    }
+}
+function getCheckpointPhaseData(db, runId) {
+    const row = db
+        .prepare('SELECT phase_data FROM runs WHERE id = ?')
+        .get(runId);
+    if (!row?.phase_data)
+        return {};
+    try {
+        const parsed = JSON.parse(row.phase_data);
+        if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+            return {};
+        }
+        return parsed;
+    }
+    catch {
+        return {};
+    }
+}
+function isStepCheckpointComplete(step, rawArtifacts) {
+    if (typeof rawArtifacts !== 'object' || rawArtifacts === null || Array.isArray(rawArtifacts)) {
+        return false;
+    }
+    const artifacts = rawArtifacts;
+    switch (step.type) {
+        case 'worker':
+            if (step.role === 'planner')
+                return artifacts['plan'] !== null && artifacts['plan'] !== undefined;
+            if (step.role === 'coder')
+                return artifacts['codeResult'] !== null && artifacts['codeResult'] !== undefined;
+            if (step.role === 'reviewer')
+                return artifacts['reviewResult'] !== null && artifacts['reviewResult'] !== undefined;
+            // Custom-role workers: checkpoint is complete only if stepOutput was
+            // persisted (meaning the step ran to completion and its output was
+            // written back). Without this the resume path could skip a crashed
+            // custom step thinking it was done.
+            return 'stepOutput' in artifacts;
+        case 'verify':
+            return Array.isArray(artifacts['verifyResults']);
+        case 'decide':
+            return true;
+    }
+}
+function determineStepSuccess(step, ctx) {
+    switch (step.type) {
+        case 'worker':
+            if (step.role === 'planner')
+                return ctx.plan !== null;
+            if (step.role === 'coder')
+                return ctx.codeResult !== null;
+            if (step.role === 'reviewer')
+                return ctx.reviewResult !== null;
+            return true;
+        case 'verify':
+            return ctx.verifyResults.length > 0 && ctx.verifyResults.every(r => r.passed);
+        case 'decide':
+            return true;
+    }
+}
+function buildStepArtifacts(step, ctx) {
+    switch (step.type) {
+        case 'worker':
+            if (step.role === 'planner')
+                return { plan: ctx.plan };
+            if (step.role === 'coder')
+                return { codeResult: ctx.codeResult };
+            if (step.role === 'reviewer')
+                return { reviewResult: ctx.reviewResult };
+            // Custom-role workers: persist the step's own output so resume can
+            // tell that work was completed. Without this, isStepCheckpointComplete
+            // fell through to `return true` for custom roles but phase_data
+            // recorded `{}`, so on resume the step was skipped AND its output
+            // was lost.
+            return { stepOutput: ctx.stepOutputs[step.id] ?? null };
+        case 'verify':
+            return { verifyResults: ctx.verifyResults };
+        case 'decide':
+            return {};
+    }
+}
+// ---------------------------------------------------------------------------
+// Cost estimation
+// ---------------------------------------------------------------------------
+function applyEstimatedWorkerCost(ctx, costTracker, costConfig, role, pricingIdentity, durationMs, tokenUsage) {
+    const estimatedCost = estimateWorkerCostUsd({
+        cost: costConfig,
+        identity: {
+            role,
+            workerType: pricingIdentity?.workerType,
+            pricingModel: pricingIdentity?.pricingModel,
+        },
+        durationMs,
+        tokenUsage,
+    });
+    if (estimatedCost <= 0 && !tokenUsage)
+        return ctx;
+    costTracker.recordCost(ctx.runId, estimatedCost, tokenUsage);
+    if (estimatedCost <= 0)
+        return ctx;
+    return updateContext(ctx, {
+        estimatedCostUsd: Number((ctx.estimatedCostUsd + estimatedCost).toFixed(6)),
+    });
+}
+//# sourceMappingURL=engine.js.map

package/dist/loop/engine.js.map

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

package/dist/loop/parallel.d.ts

@@ -0,0 +1,20 @@
+import type { SubTask } from '../workers/parsers/decomposer.js';
+import type { RunContext } from './types.js';
+import type { LoopDependencies } from './engine.js';
+export interface SubTaskResult {
+    index: number;
+    subtask: SubTask;
+    ctx: RunContext | null;
+    success: boolean;
+    error?: string;
+}
+/**
+ * Topological sort into waves: tasks in the same wave have no
+ * inter-dependencies and can run concurrently.
+ */
+export declare function topologicalWaves(subtasks: SubTask[]): number[][];
+/**
+ * Execute subtasks in parallel waves, each in its own worktree.
+ */
+export declare function executeParallelSubtasks(parentCtx: RunContext, subtasks: SubTask[], deps: LoopDependencies, maxConcurrent: number): Promise<SubTaskResult[]>;
+//# sourceMappingURL=parallel.d.ts.map

package/dist/loop/parallel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parallel.d.ts","sourceRoot":"","sources":["../../src/loop/parallel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kCAAkC,CAAA;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAC5C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAQnD,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,OAAO,CAAA;IAChB,GAAG,EAAE,UAAU,GAAG,IAAI,CAAA;IACtB,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,EAAE,EAAE,CA0ChE;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,SAAS,EAAE,UAAU,EACrB,QAAQ,EAAE,OAAO,EAAE,EACnB,IAAI,EAAE,gBAAgB,EACtB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,aAAa,EAAE,CAAC,CA+F1B"}