substrate-ai 0.13.1 → 0.14.0

package/dist/cli/index.js

@@ -4,7 +4,7 @@ import { createLogger } from "../logger-KeHncl-f.js";
 import { createEventBus } from "../helpers-CElYrONe.js";
 import { AdapterRegistry, BudgetConfigSchema, CURRENT_CONFIG_FORMAT_VERSION, CURRENT_TASK_GRAPH_VERSION, ConfigError, CostTrackerConfigSchema, DEFAULT_CONFIG, DoltClient, DoltNotInstalled, EXPERIMENT_RESULT, GlobalSettingsSchema, IngestionServer, MonitorDatabaseImpl, OPERATIONAL_FINDING, PartialGlobalSettingsSchema, PartialProviderConfigSchema, ProvidersSchema, RoutingRecommender, STORY_METRICS, TelemetryConfigSchema, addTokenUsage, aggregateTokenUsageForRun, checkDoltInstalled, compareRunMetrics, createAmendmentRun, createConfigSystem, createDecision, createDoltClient, createPipelineRun, getActiveDecisions, getAllCostEntriesFiltered, getBaselineRunMetrics, getDecisionsByCategory, getDecisionsByPhaseForRun, getLatestCompletedRun, getLatestRun, getPipelineRunById, getPlanningCostTotal, getRetryableEscalations, getRunMetrics, getSessionCostSummary, getSessionCostSummaryFiltered, getStoryMetricsForRun, getTokenUsageSummary, incrementRunRestarts, initSchema, initializeDolt, listRequirements, listRunMetrics, loadParentRunDecisions, supersedeDecision, tagRunAsBaseline, updatePipelineRun } from "../dist-CLvAwmT7.js";
 import "../adapter-registry-DXLMTmfD.js";
-import { AdapterTelemetryPersistence, AppError, DoltRepoMapMetaRepository, DoltSymbolRepository, ERR_REPO_MAP_STORAGE_WRITE, GitClient, GrammarLoader, RepoMapInjector, RepoMapModule, RepoMapQueryEngine, RepoMapStorage, SymbolParser, createContextCompiler, createDispatcher, createEventEmitter, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStopAfterGate, createTelemetryAdvisor, formatPhaseCompletionSummary, registerFactoryCommand, registerRunCommand, registerScenariosCommand, resolveStoryKeys, runAnalysisPhase, runPlanningPhase, runSolutioningPhase, validateStopAfterFromConflict } from "../run-DDUeFC-I.js";
+import { AdapterTelemetryPersistence, AppError, DoltRepoMapMetaRepository, DoltSymbolRepository, ERR_REPO_MAP_STORAGE_WRITE, GitClient, GrammarLoader, RepoMapInjector, RepoMapModule, RepoMapQueryEngine, RepoMapStorage, SymbolParser, createContextCompiler, createDispatcher, createEventEmitter, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStopAfterGate, createTelemetryAdvisor, formatPhaseCompletionSummary, registerFactoryCommand, registerRunCommand, registerScenariosCommand, resolveStoryKeys, runAnalysisPhase, runPlanningPhase, runSolutioningPhase, validateStopAfterFromConflict } from "../run-CUMPhuVq.js";
 import "../errors-D1LU8CZ9.js";
 import "../routing-CcBOCuC9.js";
 import "../decisions-C0pz9Clx.js";
@@ -4359,7 +4359,7 @@ async function runSupervisorAction(options, deps = {}) {
 								await initSchema(expAdapter);
 								const { runRunAction: runPipeline } = await import(
 									/* @vite-ignore */
-									"../run-BV2zNwIC.js"
+									"../run-CZo7hpsh.js"
 );
 								const runStoryFn = async (opts) => {
 									const exitCode = await runPipeline({

package/dist/{run-DDUeFC-I.js → run-CUMPhuVq.js}

@@ -22162,6 +22162,10 @@ var RunStateManager = class {
 */
 function createConvergenceController() {
 	const outcomes = new Map();
+	/** Returns true only when id is non-empty AND exists in graph.nodes. */
+	function isValidTarget(id, graph) {
+		return id !== "" && graph.nodes.has(id);
+	}
 	return {
 		recordOutcome(nodeId, status) {
 			outcomes.set(nodeId, status);
@@ -22177,10 +22181,387 @@ function createConvergenceController() {
 				satisfied: failingNodes.length === 0,
 				failingNodes
 			};
+		},
+		checkGoalGates(graph, runId, eventBus) {
+			const failedGates = [];
+			for (const [id, node] of graph.nodes) {
+				if (!node.goalGate) continue;
+				const status = outcomes.get(id);
+				const satisfied = status === "SUCCESS" || status === "PARTIAL_SUCCESS";
+				eventBus?.emit("graph:goal-gate-checked", {
+					runId,
+					nodeId: id,
+					satisfied
+				});
+				if (!satisfied) failedGates.push(id);
+			}
+			return {
+				satisfied: failedGates.length === 0,
+				failedGates
+			};
+		},
+		resolveRetryTarget(failedNode, graph) {
+			const candidates = [
+				failedNode.retryTarget,
+				failedNode.fallbackRetryTarget,
+				graph.retryTarget,
+				graph.fallbackRetryTarget
+			];
+			for (const candidate of candidates) if (isValidTarget(candidate, graph)) return candidate;
+			return null;
 		}
 	};
 }
 
+//#endregion
+//#region packages/factory/dist/convergence/budget.js
+const DEFAULT_BACKOFF = {
+	initialDelay: 200,
+	factor: 2,
+	maxDelay: 6e4,
+	jitterFactor: .5
+};
+/**
+* Compute the delay (in milliseconds) before the next retry attempt.
+*
+* Formula (before jitter):
+*   `baseDelay = initialDelay * factor^attemptIndex`
+*   `cappedDelay = Math.min(baseDelay, maxDelay)`
+*
+* Jitter:
+*   `jitter = (Math.random() * 2 - 1) * jitterFactor * cappedDelay`
+*   `delay = Math.max(0, Math.round(cappedDelay + jitter))`
+*
+* Passing `{ jitterFactor: 0 }` disables jitter for deterministic tests.
+*
+* @param attemptIndex - Zero-based index of the current attempt (0 = first retry).
+* @param options      - Optional overrides for the backoff parameters.
+*/
+function computeBackoffDelay(attemptIndex, options) {
+	const { initialDelay, factor, maxDelay, jitterFactor } = {
+		...DEFAULT_BACKOFF,
+		...options
+	};
+	const baseDelay = initialDelay * Math.pow(factor, attemptIndex);
+	const cappedDelay = Math.min(baseDelay, maxDelay);
+	const jitter = (Math.random() * 2 - 1) * jitterFactor * cappedDelay;
+	return Math.max(0, Math.round(cappedDelay + jitter));
+}
+/**
+* Determine whether a pipeline is permitted to dispatch the next node.
+*
+* **Unlimited mode:** When `cap === 0` the function returns `{ allowed: true }`
+* immediately, regardless of `accumulatedCost`. This matches the
+* `FactoryConfigSchema` default of `budget_cap_usd: 0` which means "no limit".
+*
+* **Strict greater-than boundary:** Enforcement triggers only when
+* `accumulatedCost > cap`. A cost that exactly equals the cap is still allowed,
+* consistent with the PRD wording "halts *before* dispatching further nodes
+* when accumulated cost **exceeds** the cap."
+*
+* @param accumulatedCost - Total cost (USD) spent so far during this pipeline run.
+* @param cap             - Maximum allowed cost (USD). `0` disables enforcement.
+* @returns `{ allowed: true }` when the pipeline may continue, or
+*          `{ allowed: false, reason: '...' }` when the budget is exhausted.
+*/
+function checkPipelineBudget(accumulatedCost, cap) {
+	if (cap === 0) return { allowed: true };
+	if (accumulatedCost > cap) return {
+		allowed: false,
+		reason: `pipeline budget exhausted: $${accumulatedCost.toFixed(2)} > $${cap.toFixed(2)}`
+	};
+	return { allowed: true };
+}
+/**
+* Tracks accumulated cost for a single pipeline run and enforces a configurable
+* spending cap via `checkPipelineBudget`.
+*
+* **Lifecycle:** Create one instance per pipeline run. Story 45-8 will call
+* `addCost()` after each node dispatch completes and `checkBudget()` before
+* the next dispatch. Call `reset()` between pipeline runs or in tests to clear
+* accumulated state.
+*/
+var PipelineBudgetManager = class {
+	totalCost = 0;
+	/**
+	* Add `amount` USD to the running total for this pipeline run.
+	*
+	* @param amount - Cost (USD) for the just-completed node dispatch.
+	*/
+	addCost(amount) {
+		this.totalCost += amount;
+	}
+	/**
+	* Return the total cost (USD) accumulated so far during this pipeline run.
+	*/
+	getTotalCost() {
+		return this.totalCost;
+	}
+	/**
+	* Reset the accumulated cost to zero.
+	* Useful for test isolation and future pipeline reuse scenarios.
+	*/
+	reset() {
+		this.totalCost = 0;
+	}
+	/**
+	* Determine whether the pipeline may dispatch the next node, delegating to
+	* `checkPipelineBudget` with the current accumulated cost.
+	*
+	* @param cap - Maximum allowed cost (USD). `0` disables enforcement.
+	*/
+	checkBudget(cap) {
+		return checkPipelineBudget(this.totalCost, cap);
+	}
+};
+/**
+* Determine whether a pipeline session is permitted to dispatch the next node
+* based on wall-clock elapsed time.
+*
+* **Unlimited mode:** When `capMs === 0` the function returns `{ allowed: true }`
+* immediately, regardless of `elapsedMs`. This matches the `FactoryConfigSchema`
+* default of `wall_clock_cap_seconds: 0` which means "no limit".
+*
+* **Strict greater-than boundary:** Enforcement triggers only when
+* `elapsedMs > capMs`. An elapsed time that exactly equals the cap is still
+* allowed, consistent with the PRD wording "halts *before* dispatching further
+* nodes when elapsed time **exceeds** the cap."
+*
+* @param elapsedMs - Milliseconds elapsed since the pipeline session started.
+* @param capMs     - Maximum allowed elapsed time in milliseconds. `0` disables
+*                    enforcement (unlimited mode).
+* @returns `{ allowed: true }` when the session may continue, or
+*          `{ allowed: false, reason: 'wall clock budget exhausted' }` when the
+*          cap has been exceeded.
+*/
+function checkSessionBudget(elapsedMs, capMs) {
+	if (capMs === 0) return { allowed: true };
+	if (elapsedMs > capMs) return {
+		allowed: false,
+		reason: "wall clock budget exhausted"
+	};
+	return { allowed: true };
+}
+/**
+* Tracks wall-clock elapsed time for a single pipeline session and enforces a
+* configurable time cap via `checkSessionBudget`.
+*
+* **Lifecycle:** Create one instance per pipeline run, constructed at pipeline
+* launch. Story 45-8 will call `checkBudget()` before each node dispatch as
+* the highest-priority budget check (before `PipelineBudgetManager`).
+* Call `reset()` between pipeline runs or in tests for
+* isolation.
+*
+* **Cap 0 means unlimited:** A `capSeconds` value of `0` passed to `checkBudget`
+* disables all wall-clock enforcement and always returns `{ allowed: true }`.
+*/
+var SessionBudgetManager = class {
+	startTime;
+	constructor() {
+		this.startTime = Date.now();
+	}
+	/**
+	* Return the number of milliseconds elapsed since this manager was constructed
+	* (or since the last `reset()` call). Always returns a non-negative number.
+	*/
+	getElapsedMs() {
+		return Date.now() - this.startTime;
+	}
+	/**
+	* Reset the session start timestamp to the current time. Subsequent calls to
+	* `getElapsedMs()` will measure from this new baseline. Useful for test
+	* isolation and future pipeline reuse scenarios.
+	*/
+	reset() {
+		this.startTime = Date.now();
+	}
+	/**
+	* Determine whether the pipeline session may dispatch the next node, delegating
+	* to `checkSessionBudget` with the current elapsed time converted from seconds
+	* to milliseconds.
+	*
+	* @param capSeconds - Maximum allowed elapsed time in **seconds** (as stored in
+	*                     `FactoryConfig.wall_clock_cap_seconds`). A value of `0`
+	*                     disables enforcement.
+	*/
+	checkBudget(capSeconds) {
+		return checkSessionBudget(this.getElapsedMs(), capSeconds * 1e3);
+	}
+};
+
+//#endregion
+//#region packages/factory/dist/convergence/plateau.js
+/**
+* Plateau detection for the convergence loop.
+* Story 45-6: provides pure plateau detection primitives — no I/O, no side effects.
+*
+* Algorithm: Track the last N satisfaction scores (N = `window`, default 3).
+* If max−min of the window falls strictly below threshold, declare plateau.
+*
+* Consumed by:
+*   - Story 45-8 (convergence controller integration)
+*/
+const DEFAULT_WINDOW = 3;
+const DEFAULT_THRESHOLD = .05;
+/**
+* Create a new PlateauDetector with the given options.
+*
+* **Defaults:** `window=3`, `threshold=0.05` — matching `FactoryConfigSchema.plateau_window`
+* and `FactoryConfigSchema.plateau_threshold`. Story 45-8 will read these values from
+* `FactoryConfig` and pass them in.
+*
+* **Insufficient-data guard:** `isPlateaued()` always returns `false` when fewer than
+* `window` scores have been recorded. A plateau can only be declared once the window is full.
+*
+* @param options - Optional configuration for window size and threshold.
+*/
+function createPlateauDetector(options) {
+	const window = options?.window ?? DEFAULT_WINDOW;
+	const threshold = options?.threshold ?? DEFAULT_THRESHOLD;
+	let scores = [];
+	return {
+		recordScore(_iteration, score) {
+			scores.push(score);
+			scores = scores.slice(-window);
+		},
+		isPlateaued() {
+			if (scores.length < window) return false;
+			const delta = Math.max(...scores) - Math.min(...scores);
+			return delta < threshold;
+		},
+		getWindow() {
+			return window;
+		},
+		getScores() {
+			return [...scores];
+		}
+	};
+}
+/**
+* Check whether the detector has reached a plateau and, if so, emit the
+* `convergence:plateau-detected` event on the provided event bus.
+*
+* This mirrors the `checkGoalGates()` pattern:
+* - Pure detection is isolated in `PlateauDetector` (no side effects).
+* - Event emission is isolated here in this wrapper.
+* - Callers may omit `eventBus` for pure check behavior (no event is emitted).
+*
+* @param detector - A `PlateauDetector` instance.
+* @param context  - Run/node identifiers and an optional event bus.
+* @returns `{ plateaued: true, scores }` with event emitted when plateaued;
+*          `{ plateaued: false, scores }` with no event emitted otherwise.
+*/
+function checkPlateauAndEmit(detector, context) {
+	const { runId, nodeId, eventBus } = context;
+	const scores = detector.getScores();
+	if (detector.isPlateaued()) {
+		eventBus?.emit("convergence:plateau-detected", {
+			runId,
+			nodeId,
+			scores,
+			window: detector.getWindow()
+		});
+		return {
+			plateaued: true,
+			scores
+		};
+	}
+	return {
+		plateaued: false,
+		scores
+	};
+}
+
+//#endregion
+//#region packages/factory/dist/convergence/remediation.js
+/**
+* Remediation context injection for the convergence loop.
+* Story 45-7: builds structured remediation context from failure data and
+* injects it into a retried node's IGraphContext.
+*
+* Architecture reference: Section 6.5 — Remediation Context fields
+*
+* Pure functions (`formatScenarioDiff`, `deriveFixScope`, `buildRemediationContext`)
+* have no I/O and no side effects.
+* Only `injectRemediationContext` mutates state (the IGraphContext).
+*
+* Consumed by:
+*   - Story 45-8 (convergence controller integration with executor)
+*   - CodergenBackend handlers (via `getRemediationContext`)
+*/
+/**
+* The agreed key under which remediation context is stored in `IGraphContext`.
+* Namespaced under `convergence.` to avoid collision with user-defined context keys.
+* Story 45-8 writes this key; CodergenBackend handlers read it via `getRemediationContext()`.
+*/
+const REMEDIATION_CONTEXT_KEY = "convergence.remediation";
+/**
+* Formats a human-readable diff of failed scenarios from a ScenarioRunResult.
+*
+* This is a pure formatting function with no side effects. For each failed
+* scenario it produces a line `"- {name}: {stderr || stdout || '(no output)'}"`,
+* preferring stderr (most useful for debugging), falling back to stdout
+* (some tools write errors to stdout), then to the literal `'(no output)'`.
+*
+* Returns `"All scenarios passed"` when there are no failures.
+*/
+function formatScenarioDiff(results) {
+	const failed = results.scenarios.filter((s$1) => s$1.status === "fail");
+	if (failed.length === 0) return "All scenarios passed";
+	const lines = failed.map((s$1) => {
+		const output = s$1.stderr || s$1.stdout || "(no output)";
+		return `- ${s$1.name}: ${output}`;
+	});
+	return lines.join("\n");
+}
+/**
+* Derives a focused fix instruction string from failed scenarios.
+*
+* This function produces human-readable fix instructions for the retried agent.
+* Returns `"Fix {n} failing scenario{s}: {name1}, {name2}, ..."` when there are
+* failures, or `""` when all scenarios pass.
+*
+* Pluralization: singular "scenario" when n === 1, plural "scenarios" otherwise.
+*/
+function deriveFixScope(results) {
+	const failed = results.scenarios.filter((s$1) => s$1.status === "fail");
+	if (failed.length === 0) return "";
+	const n$1 = failed.length;
+	const plural = n$1 === 1 ? "scenario" : "scenarios";
+	const names = failed.map((s$1) => s$1.name).join(", ");
+	return `Fix ${n$1} failing ${plural}: ${names}`;
+}
+/**
+* Builds a complete `RemediationContext` from the provided parameters.
+*
+* `scenarioResults` is optional — first-iteration retries may not have scenario
+* data yet. When omitted, `scenarioDiff` defaults to
+* `"No scenario results available"` and `fixScope` defaults to `""`.
+*
+* Stores `satisfactionScoreHistory` as a defensive copy (`[...params.satisfactionScoreHistory]`)
+* so external mutation of the caller's array does not corrupt the stored history.
+*/
+function buildRemediationContext(params) {
+	const scenarioDiff = params.scenarioResults ? formatScenarioDiff(params.scenarioResults) : "No scenario results available";
+	const fixScope = params.scenarioResults ? deriveFixScope(params.scenarioResults) : "";
+	return {
+		previousFailureReason: params.previousFailureReason,
+		scenarioDiff,
+		iterationCount: params.iterationCount,
+		satisfactionScoreHistory: [...params.satisfactionScoreHistory],
+		fixScope
+	};
+}
+/**
+* Injects a `RemediationContext` into an `IGraphContext` under `REMEDIATION_CONTEXT_KEY`.
+*
+* Called by the executor's retry loop before dispatching to the retried node —
+* story 45-8 wires this call into the graph executor.
+*/
+function injectRemediationContext(context, remediation) {
+	context.set(REMEDIATION_CONTEXT_KEY, remediation);
+}
+
 //#endregion
 //#region packages/factory/dist/graph/executor.js
 /**
@@ -22220,17 +22601,6 @@ function normalizeOutcomeStatus(raw) {
 	};
 }
 /**
-* Compute exponential backoff delay with ±50% jitter.
-*
-* @param attempt - Zero-indexed attempt number (0 = first retry, 1 = second, etc.)
-* @returns Delay in milliseconds, floored at 0 and capped at 60,000ms
-*/
-function computeBackoffDelay(attempt) {
-	const rawDelay = Math.min(200 * Math.pow(2, attempt), 6e4);
-	const jitter = rawDelay * .5 * (2 * Math.random() - 1);
-	return Math.max(0, rawDelay + jitter);
-}
-/**
 * Dispatch a node handler with exponential backoff retry on FAIL outcomes.
 *
 * Emits `graph:node-retried` before each retry attempt.
@@ -22289,6 +22659,13 @@ function createGraphExecutor() {
 		const checkpointManager = new CheckpointManager();
 		const checkpointFilePath = path.join(config.logsRoot, "checkpoint.json");
 		const controller = createConvergenceController();
+		const sessionManager = new SessionBudgetManager();
+		const pipelineManager = new PipelineBudgetManager();
+		const plateauDetector = createPlateauDetector({
+			...config.plateauWindow !== void 0 ? { window: config.plateauWindow } : {},
+			...config.plateauThreshold !== void 0 ? { threshold: config.plateauThreshold } : {}
+		});
+		let convergenceIteration = 0;
 		let completedNodes = [];
 		let nodeRetries = {};
 		let context = new GraphContext();
@@ -22328,23 +22705,64 @@ function createGraphExecutor() {
 			}
 		} else currentNode = graph.startNode();
 		while (true) {
+			const sessionResult = sessionManager.checkBudget((config.wallClockCapMs ?? 0) / 1e3);
+			if (!sessionResult.allowed) {
+				config.eventBus?.emit("convergence:budget-exhausted", {
+					runId: config.runId,
+					level: "session",
+					reason: sessionResult.reason
+				});
+				return {
+					status: "FAIL",
+					failureReason: `Session budget exceeded: ${sessionResult.reason}`
+				};
+			}
+			const pipelineResult = pipelineManager.checkBudget(config.pipelineBudgetCapUsd ?? 0);
+			if (!pipelineResult.allowed) {
+				config.eventBus?.emit("convergence:budget-exhausted", {
+					runId: config.runId,
+					level: "pipeline",
+					reason: pipelineResult.reason
+				});
+				return {
+					status: "FAIL",
+					failureReason: `Pipeline budget exceeded: ${pipelineResult.reason}`
+				};
+			}
 			const exitNode = graph.exitNode();
 			if (currentNode.id === exitNode.id) {
-				const gateResult = controller.evaluateGates(graph);
+				const gateResult = controller.checkGoalGates(graph, config.runId, config.eventBus);
 				if (!gateResult.satisfied) {
-					const failingNodeId = gateResult.failingNodes[0];
+					const failingNodeId = gateResult.failedGates[0];
 					const failingGateNode = graph.nodes.get(failingNodeId);
-					const retryTarget = failingGateNode?.retryTarget || failingGateNode?.fallbackRetryTarget || graph.retryTarget || graph.fallbackRetryTarget;
-					if (retryTarget) {
-						const retryNode = graph.nodes.get(retryTarget);
-						if (!retryNode) throw new Error(`Retry target node "${retryTarget}" not found in graph`);
-						currentNode = retryNode;
-						continue;
-					}
-					return {
+					const retryTargetId = failingGateNode ? controller.resolveRetryTarget(failingGateNode, graph) : null;
+					if (!retryTargetId) return {
 						status: "FAIL",
 						failureReason: "Goal gate failed: no retry target"
 					};
+					const retryNode = graph.nodes.get(retryTargetId);
+					if (!retryNode) throw new Error(`Retry target node "${retryTargetId}" not found in graph`);
+					convergenceIteration++;
+					const satisfactionScore = context.getNumber("satisfaction_score", 0);
+					plateauDetector.recordScore(convergenceIteration, satisfactionScore);
+					const plateauResult = checkPlateauAndEmit(plateauDetector, {
+						runId: config.runId,
+						nodeId: retryTargetId,
+						...config.eventBus ? { eventBus: config.eventBus } : {}
+					});
+					if (plateauResult.plateaued) return {
+						status: "FAIL",
+						failureReason: `Convergence plateau detected after ${convergenceIteration} iteration(s): scores plateaued at [${plateauResult.scores.join(", ")}]`
+					};
+					const remediation = buildRemediationContext({
+						previousFailureReason: `Goal gate unsatisfied: ${gateResult.failedGates.join(", ")}`,
+						iterationCount: convergenceIteration,
+						satisfactionScoreHistory: plateauResult.scores
+					});
+					injectRemediationContext(context, remediation);
+					skipCycleCheck = true;
+					currentNode = retryNode;
+					continue;
 				}
 				return { status: "SUCCESS" };
 			}
@@ -22441,6 +22859,8 @@ function createGraphExecutor() {
 				controller.recordOutcome(nodeToDispatch.id, controllerStatus);
 			}
 			if (outcome.contextUpdates) for (const [key, value] of Object.entries(outcome.contextUpdates)) context.set(key, value);
+			const nodeCost = context.getNumber("factory.lastNodeCostUsd", 0);
+			if (nodeCost > 0) pipelineManager.addCost(nodeCost);
 			if (!skipCompletedPush) completedNodes.push(currentNode.id);
 			skipCompletedPush = false;
 			await checkpointManager.save(config.logsRoot, {
@@ -22455,7 +22875,7 @@ function createGraphExecutor() {
 				checkpointPath: checkpointFilePath
 			});
 			if (outcome.status === "FAIL") {
-				const retryTarget = currentNode.retryTarget || currentNode.fallbackRetryTarget || graph.retryTarget || graph.fallbackRetryTarget;
+				const retryTarget = controller.resolveRetryTarget(currentNode, graph);
 				if (retryTarget) {
 					const retryNode = graph.nodes.get(retryTarget);
 					if (!retryNode) throw new Error(`Retry target node "${retryTarget}" not found in graph`);
@@ -27851,13 +28271,19 @@ function registerFactoryCommand(program) {
 			const logsRoot = path.join(projectDir, ".substrate", "runs", runId);
 			const stateManager = new RunStateManager({ runDir: logsRoot });
 			await stateManager.initRun(dotSource);
+			/** wallClockCapMs: FactoryConfig.wall_clock_cap_seconds × 1000 (story 45-10) */
+			const factoryConfig = await loadFactoryConfig(projectDir, opts.config);
 			const executor = createGraphExecutor();
 			await executor.run(graph, {
 				runId,
 				logsRoot,
 				handlerRegistry: createDefaultRegistry(),
 				eventBus,
-				dotSource
+				dotSource,
+				wallClockCapMs: (factoryConfig.factory?.wall_clock_cap_seconds ?? 0) * 1e3,
+				pipelineBudgetCapUsd: factoryConfig.factory?.budget_cap_usd ?? 0,
+				plateauWindow: factoryConfig.factory?.plateau_window ?? 3,
+				plateauThreshold: factoryConfig.factory?.plateau_threshold ?? .05
 			});
 		} catch (err) {
 			const msg = err instanceof Error ? err.message : String(err);
@@ -29340,4 +29766,4 @@ function registerRunCommand(program, _version = "0.0.0", projectRoot = process.c
 
 //#endregion
 export { AdapterTelemetryPersistence, AppError, DoltRepoMapMetaRepository, DoltSymbolRepository, ERR_REPO_MAP_STORAGE_WRITE, GitClient, GrammarLoader, RepoMapInjector, RepoMapModule, RepoMapQueryEngine, RepoMapStorage, SymbolParser, createContextCompiler, createDispatcher, createEventEmitter, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStopAfterGate, createTelemetryAdvisor, formatPhaseCompletionSummary, normalizeGraphSummaryToStatus, registerFactoryCommand, registerRunCommand, registerScenariosCommand, resolveStoryKeys, runAnalysisPhase, runPlanningPhase, runRunAction, runSolutioningPhase, validateStopAfterFromConflict };
-//# sourceMappingURL=run-DDUeFC-I.js.map
+//# sourceMappingURL=run-CUMPhuVq.js.map

package/dist/{run-BV2zNwIC.js → run-CZo7hpsh.js}

@@ -2,7 +2,7 @@ import "./health-DswaC1q5.js";
 import "./logger-KeHncl-f.js";
 import "./helpers-CElYrONe.js";
 import "./dist-CLvAwmT7.js";
-import { normalizeGraphSummaryToStatus, registerRunCommand, runRunAction } from "./run-DDUeFC-I.js";
+import { normalizeGraphSummaryToStatus, registerRunCommand, runRunAction } from "./run-CUMPhuVq.js";
 import "./routing-CcBOCuC9.js";
 import "./decisions-C0pz9Clx.js";
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "substrate-ai",
-  "version": "0.13.1",
+  "version": "0.14.0",
   "description": "Substrate — multi-agent orchestration daemon for AI coding agents",
   "type": "module",
   "license": "MIT",