substrate-ai 0.2.26 → 0.2.28

package/dist/{run-CEtHPG4I.js → run-BCyrbL3w.js}

@@ -539,7 +539,7 @@ const migration010RunMetrics = {
 
 //#endregion
 //#region src/persistence/migrations/index.ts
-const logger$19 = createLogger("persistence:migrations");
+const logger$21 = createLogger("persistence:migrations");
 const MIGRATIONS = [
 	initialSchemaMigration,
 	costTrackerSchemaMigration,
@@ -557,7 +557,7 @@ const MIGRATIONS = [
 * Safe to call multiple times — already-applied migrations are skipped.
 */
 function runMigrations(db) {
-	logger$19.info("Starting migration runner");
+	logger$21.info("Starting migration runner");
 	db.exec(`
     CREATE TABLE IF NOT EXISTS schema_migrations (
       version   INTEGER PRIMARY KEY,
@@ -568,12 +568,12 @@ function runMigrations(db) {
 	const appliedVersions = new Set(db.prepare("SELECT version FROM schema_migrations").all().map((row) => row.version));
 	const pending = MIGRATIONS.filter((m) => !appliedVersions.has(m.version)).sort((a, b) => a.version - b.version);
 	if (pending.length === 0) {
-		logger$19.info("No pending migrations");
+		logger$21.info("No pending migrations");
 		return;
 	}
 	const insertMigration = db.prepare("INSERT INTO schema_migrations (version, name) VALUES (?, ?)");
 	for (const migration of pending) {
-		logger$19.info({
+		logger$21.info({
 			version: migration.version,
 			name: migration.name
 		}, "Applying migration");
@@ -587,14 +587,14 @@ function runMigrations(db) {
 			});
 			applyMigration();
 		}
-		logger$19.info({ version: migration.version }, "Migration applied successfully");
+		logger$21.info({ version: migration.version }, "Migration applied successfully");
 	}
-	logger$19.info({ count: pending.length }, "All pending migrations applied");
+	logger$21.info({ count: pending.length }, "All pending migrations applied");
 }
 
 //#endregion
 //#region src/persistence/database.ts
-const logger$18 = createLogger("persistence:database");
+const logger$20 = createLogger("persistence:database");
 /**
 * Thin wrapper that opens a SQLite database, applies required PRAGMAs,
 * and exposes the raw BetterSqlite3 instance.
@@ -611,14 +611,14 @@ var DatabaseWrapper = class {
 	*/
 	open() {
 		if (this._db !== null) return;
-		logger$18.info({ path: this._path }, "Opening SQLite database");
+		logger$20.info({ path: this._path }, "Opening SQLite database");
 		this._db = new BetterSqlite3(this._path);
 		const walResult = this._db.pragma("journal_mode = WAL");
-		if (walResult?.[0]?.journal_mode !== "wal") logger$18.warn({ result: walResult?.[0]?.journal_mode }, "WAL pragma did not return expected \"wal\" — journal_mode may be \"memory\" or unsupported");
+		if (walResult?.[0]?.journal_mode !== "wal") logger$20.warn({ result: walResult?.[0]?.journal_mode }, "WAL pragma did not return expected \"wal\" — journal_mode may be \"memory\" or unsupported");
 		this._db.pragma("busy_timeout = 5000");
 		this._db.pragma("synchronous = NORMAL");
 		this._db.pragma("foreign_keys = ON");
-		logger$18.info({ path: this._path }, "SQLite database opened with WAL mode");
+		logger$20.info({ path: this._path }, "SQLite database opened with WAL mode");
 	}
 	/**
 	* Close the database. Idempotent — calling close() when already closed is a no-op.
@@ -627,7 +627,7 @@ var DatabaseWrapper = class {
 		if (this._db === null) return;
 		this._db.close();
 		this._db = null;
-		logger$18.info({ path: this._path }, "SQLite database closed");
+		logger$20.info({ path: this._path }, "SQLite database closed");
 	}
 	/**
 	* Return the raw BetterSqlite3 instance.
@@ -2277,6 +2277,75 @@ const PIPELINE_EVENT_METADATA = [
 			type: "string",
 			description: "Story key."
 		}]
+	},
+	{
+		type: "story:interface-change-warning",
+		description: "Non-blocking warning: modified files export shared TypeScript interfaces that may be referenced by test files outside the same module (potential stale mock risk). Story proceeds to code-review.",
+		when: "After build verification passes, before code-review, when exported interfaces in modified .ts files are referenced by cross-module test files.",
+		fields: [
+			{
+				name: "ts",
+				type: "string",
+				description: "Timestamp."
+			},
+			{
+				name: "storyKey",
+				type: "string",
+				description: "Story key."
+			},
+			{
+				name: "modifiedInterfaces",
+				type: "string[]",
+				description: "Exported interface/type names found in modified files."
+			},
+			{
+				name: "potentiallyAffectedTests",
+				type: "string[]",
+				description: "Test file paths (relative to project root) that reference the modified interface names."
+			}
+		]
+	},
+	{
+		type: "story:metrics",
+		description: "Per-story metrics on terminal state.",
+		when: "After terminal state (success/escalation/failure).",
+		fields: [
+			{
+				name: "ts",
+				type: "string",
+				description: "Timestamp."
+			},
+			{
+				name: "storyKey",
+				type: "string",
+				description: "Story key."
+			},
+			{
+				name: "wallClockMs",
+				type: "number",
+				description: "Wall-clock ms."
+			},
+			{
+				name: "phaseBreakdown",
+				type: "Record<string,number>",
+				description: "Phase→ms durations."
+			},
+			{
+				name: "tokens",
+				type: "{input:number;output:number}",
+				description: "Token counts."
+			},
+			{
+				name: "reviewCycles",
+				type: "number",
+				description: "Review cycle count."
+			},
+			{
+				name: "dispatches",
+				type: "number",
+				description: "Dispatch count."
+			}
+		]
 	}
 ];
 /**
@@ -2606,7 +2675,7 @@ function truncateToTokens(text, maxTokens) {
 
 //#endregion
 //#region src/modules/context-compiler/context-compiler-impl.ts
-const logger$17 = createLogger("context-compiler");
+const logger$19 = createLogger("context-compiler");
 /**
 * Fraction of the original token budget that must remain (after required +
 * important sections) before an optional section is included.
@@ -2698,7 +2767,7 @@ var ContextCompilerImpl = class {
 				includedParts.push(truncated);
 				remainingBudget -= truncatedTokens;
 				anyTruncated = true;
-				logger$17.warn({
+				logger$19.warn({
 					section: section.name,
 					originalTokens: tokens,
 					budgetTokens: truncatedTokens
@@ -2712,7 +2781,7 @@ var ContextCompilerImpl = class {
 				});
 			} else {
 				anyTruncated = true;
-				logger$17.warn({
+				logger$19.warn({
 					section: section.name,
 					tokens
 				}, "Context compiler: omitted \"important\" section — no budget remaining");
@@ -2739,7 +2808,7 @@ var ContextCompilerImpl = class {
 				} else {
 					if (tokens > 0) {
 						anyTruncated = true;
-						logger$17.warn({
+						logger$19.warn({
 							section: section.name,
 							tokens,
 							budgetFractionRemaining: budgetFractionRemaining.toFixed(2)
@@ -3024,7 +3093,7 @@ function parseYamlResult(yamlText, schema) {
 
 //#endregion
 //#region src/modules/agent-dispatch/dispatcher-impl.ts
-const logger$16 = createLogger("agent-dispatch");
+const logger$18 = createLogger("agent-dispatch");
 const SHUTDOWN_GRACE_MS = 1e4;
 const SHUTDOWN_MAX_WAIT_MS = 3e4;
 const CHARS_PER_TOKEN = 4;
@@ -3069,7 +3138,7 @@ function getAvailableMemory() {
 			}).trim(), 10);
 			_lastKnownPressureLevel = pressureLevel;
 			if (pressureLevel >= 4) {
-				logger$16.warn({ pressureLevel }, "macOS kernel reports critical memory pressure");
+				logger$18.warn({ pressureLevel }, "macOS kernel reports critical memory pressure");
 				return 0;
 			}
 		} catch {}
@@ -3084,7 +3153,7 @@ function getAvailableMemory() {
 			const speculative = parseInt(vmstat.match(/Pages speculative:\s+(\d+)/)?.[1] ?? "0", 10);
 			const available = (free + purgeable + speculative) * pageSize;
 			if (pressureLevel >= 2) {
-				logger$16.warn({
+				logger$18.warn({
 					pressureLevel,
 					availableBeforeDiscount: available
 				}, "macOS kernel reports memory pressure — discounting estimate");
@@ -3164,7 +3233,7 @@ var DispatcherImpl = class {
 					resolve: typedResolve,
 					reject
 				});
-				logger$16.debug({
+				logger$18.debug({
 					id,
 					queueLength: this._queue.length
 				}, "Dispatch queued");
@@ -3195,7 +3264,7 @@ var DispatcherImpl = class {
 	async shutdown() {
 		this._shuttingDown = true;
 		this._stopMemoryPressureTimer();
-		logger$16.info({
+		logger$18.info({
 			running: this._running.size,
 			queued: this._queue.length
 		}, "Dispatcher shutting down");
@@ -3228,13 +3297,13 @@ var DispatcherImpl = class {
 				}
 			}, 50);
 		});
-		logger$16.info("Dispatcher shutdown complete");
+		logger$18.info("Dispatcher shutdown complete");
 	}
 	async _startDispatch(id, request, resolve$2) {
 		const { prompt, agent, taskType, timeout, outputSchema, workingDirectory, model, maxTurns } = request;
 		const adapter = this._adapterRegistry.get(agent);
 		if (adapter === void 0) {
-			logger$16.warn({
+			logger$18.warn({
 				id,
 				agent
 			}, "No adapter found for agent");
@@ -3280,7 +3349,7 @@ var DispatcherImpl = class {
 		});
 		const startedAt = Date.now();
 		proc.on("error", (err) => {
-			logger$16.error({
+			logger$18.error({
 				id,
 				binary: cmd.binary,
 				error: err.message
@@ -3288,7 +3357,7 @@ var DispatcherImpl = class {
 		});
 		if (proc.stdin !== null) {
 			proc.stdin.on("error", (err) => {
-				if (err.code !== "EPIPE") logger$16.warn({
+				if (err.code !== "EPIPE") logger$18.warn({
 					id,
 					error: err.message
 				}, "stdin write error");
@@ -3330,7 +3399,7 @@ var DispatcherImpl = class {
 			agent,
 			taskType
 		});
-		logger$16.debug({
+		logger$18.debug({
 			id,
 			agent,
 			taskType,
@@ -3347,7 +3416,7 @@ var DispatcherImpl = class {
 				dispatchId: id,
 				timeoutMs
 			});
-			logger$16.warn({
+			logger$18.warn({
 				id,
 				agent,
 				taskType,
@@ -3401,7 +3470,7 @@ var DispatcherImpl = class {
 					exitCode: code,
 					output: stdout
 				});
-				logger$16.debug({
+				logger$18.debug({
 					id,
 					agent,
 					taskType,
@@ -3427,7 +3496,7 @@ var DispatcherImpl = class {
 					error: stderr || `Process exited with code ${String(code)}`,
 					exitCode: code
 				});
-				logger$16.debug({
+				logger$18.debug({
 					id,
 					agent,
 					taskType,
@@ -3486,7 +3555,7 @@ var DispatcherImpl = class {
 		const next = this._queue.shift();
 		if (next === void 0) return;
 		next.handle.status = "running";
-		logger$16.debug({
+		logger$18.debug({
 			id: next.id,
 			queueLength: this._queue.length
 		}, "Dequeued dispatch");
@@ -3499,7 +3568,7 @@ var DispatcherImpl = class {
 	_isMemoryPressured() {
 		const free = getAvailableMemory();
 		if (free < MIN_FREE_MEMORY_BYTES) {
-			logger$16.warn({
+			logger$18.warn({
 				freeMB: Math.round(free / 1024 / 1024),
 				thresholdMB: Math.round(MIN_FREE_MEMORY_BYTES / 1024 / 1024),
 				pressureLevel: _lastKnownPressureLevel
@@ -3539,6 +3608,54 @@ var DispatcherImpl = class {
 };
 /** Default command for the build verification gate */
 const DEFAULT_VERIFY_COMMAND = "npm run build";
+/**
+* Detect the package manager used in a project by checking for lockfiles.
+*
+* Priority order (checked in sequence):
+*   pnpm-lock.yaml → pnpm run build
+*   yarn.lock      → yarn run build
+*   bun.lockb      → bun run build
+*   package-lock.json → npm run build
+*   (none found)   → npm run build  (fallback, matches DEFAULT_VERIFY_COMMAND)
+*
+* Lockfile presence is used rather than the `packageManager` field in
+* package.json because lockfiles are more reliable and always present in
+* real projects.
+*/
+function detectPackageManager(projectRoot) {
+	const candidates = [
+		{
+			file: "pnpm-lock.yaml",
+			packageManager: "pnpm",
+			command: "pnpm run build"
+		},
+		{
+			file: "yarn.lock",
+			packageManager: "yarn",
+			command: "yarn run build"
+		},
+		{
+			file: "bun.lockb",
+			packageManager: "bun",
+			command: "bun run build"
+		},
+		{
+			file: "package-lock.json",
+			packageManager: "npm",
+			command: "npm run build"
+		}
+	];
+	for (const candidate of candidates) if (existsSync$1(join$1(projectRoot, candidate.file))) return {
+		packageManager: candidate.packageManager,
+		lockfile: candidate.file,
+		command: candidate.command
+	};
+	return {
+		packageManager: "npm",
+		lockfile: null,
+		command: DEFAULT_VERIFY_COMMAND
+	};
+}
 /** Default timeout in milliseconds for the build verification gate */
 const DEFAULT_VERIFY_TIMEOUT_MS = 6e4;
 /**
@@ -3555,7 +3672,16 @@ const DEFAULT_VERIFY_TIMEOUT_MS = 6e4;
 */
 function runBuildVerification(options) {
 	const { verifyCommand, verifyTimeoutMs, projectRoot } = options;
-	const cmd = verifyCommand === void 0 ? DEFAULT_VERIFY_COMMAND : verifyCommand;
+	let cmd;
+	if (verifyCommand === void 0) {
+		const detection = detectPackageManager(projectRoot);
+		logger$18.info({
+			packageManager: detection.packageManager,
+			lockfile: detection.lockfile,
+			resolvedCommand: detection.command
+		}, "Build verification: resolved command via package manager detection");
+		cmd = detection.command;
+	} else cmd = verifyCommand;
 	if (!cmd) return { status: "skipped" };
 	const timeoutMs = verifyTimeoutMs ?? DEFAULT_VERIFY_TIMEOUT_MS;
 	try {
@@ -3748,7 +3874,7 @@ function pickRecommendation(distribution, profile, totalIssues, reviewCycles, la
 
 //#endregion
 //#region src/modules/compiled-workflows/prompt-assembler.ts
-const logger$15 = createLogger("compiled-workflows:prompt-assembler");
+const logger$17 = createLogger("compiled-workflows:prompt-assembler");
 /**
 * Assemble a final prompt from a template and sections map.
 *
@@ -3773,7 +3899,7 @@ function assemblePrompt(template, sections, tokenCeiling = 2200) {
 		tokenCount,
 		truncated: false
 	};
-	logger$15.warn({
+	logger$17.warn({
 		tokenCount,
 		ceiling: tokenCeiling
 	}, "Prompt exceeds token ceiling — truncating optional sections");
@@ -3789,10 +3915,10 @@ function assemblePrompt(template, sections, tokenCeiling = 2200) {
 			const targetSectionTokens = Math.max(0, currentSectionTokens - overBy);
 			if (targetSectionTokens === 0) {
 				contentMap[section.name] = "";
-				logger$15.warn({ sectionName: section.name }, "Section eliminated to fit token budget");
+				logger$17.warn({ sectionName: section.name }, "Section eliminated to fit token budget");
 			} else {
 				contentMap[section.name] = truncateToTokens(section.content, targetSectionTokens);
-				logger$15.warn({
+				logger$17.warn({
 					sectionName: section.name,
 					targetSectionTokens
 				}, "Section truncated to fit token budget");
@@ -3803,7 +3929,7 @@ function assemblePrompt(template, sections, tokenCeiling = 2200) {
 		}
 		if (tokenCount <= tokenCeiling) break;
 	}
-	if (tokenCount > tokenCeiling) logger$15.warn({
+	if (tokenCount > tokenCeiling) logger$17.warn({
 		tokenCount,
 		ceiling: tokenCeiling
 	}, "Required sections alone exceed token ceiling — returning over-budget prompt");
@@ -3890,6 +4016,20 @@ const CodeReviewIssueSchema = z.object({
 	line: coerceOptionalNumber
 });
 /**
+* Schema for a single entry in the AC verification checklist emitted by
+* the code-review sub-agent. Each entry maps an acceptance criterion to a
+* status determination backed by concrete evidence from the diff.
+*/
+const AcChecklistEntrySchema = z.object({
+	ac_id: z.string(),
+	status: z.enum([
+		"met",
+		"not_met",
+		"partial"
+	]),
+	evidence: z.string()
+});
+/**
 * Compute the verdict from the issue list using deterministic rules.
 *
 * The agent reports issues with severities; the pipeline computes the
@@ -3911,7 +4051,8 @@ function computeVerdict(issueList) {
 /**
 * Schema for the YAML output contract of the code-review sub-agent.
 *
-* The agent must emit YAML with verdict, issues count, and issue_list.
+* The agent must emit YAML with verdict, issues count, issue_list, and
+* optionally an ac_checklist mapping each AC to its implementation status.
 * Example:
 *   verdict: NEEDS_MINOR_FIXES
 *   issues: 3
@@ -3920,11 +4061,20 @@ function computeVerdict(issueList) {
 *       description: "Missing error handling in createFoo()"
 *       file: "src/modules/foo/foo.ts"
 *       line: 42
+*   ac_checklist:
+*     - ac_id: AC1
+*       status: met
+*       evidence: "Implemented in src/modules/foo/foo.ts:createFoo()"
+*     - ac_id: AC2
+*       status: not_met
+*       evidence: "No implementation found for getConstraints()"
 *   notes: "Generally clean implementation."
 *
-* The transform auto-corrects the issues count and recomputes the verdict
-* from the issue list. The agent's original verdict is preserved as
-* `agentVerdict` for logging and debugging.
+* The transform:
+* 1. Auto-corrects the issues count from issue_list length.
+* 2. Auto-injects a major issue for each not_met AC not already flagged.
+* 3. Recomputes the verdict from the (possibly augmented) issue list.
+* The agent's original verdict is preserved as `agentVerdict` for logging.
 */
 const CodeReviewResultSchema = z.object({
 	verdict: z.enum([
@@ -3934,13 +4084,27 @@ const CodeReviewResultSchema = z.object({
 	]),
 	issues: coerceNumber,
 	issue_list: z.array(CodeReviewIssueSchema),
+	ac_checklist: z.array(AcChecklistEntrySchema).default([]),
 	notes: z.string().optional()
-}).transform((data) => ({
-	...data,
-	issues: data.issue_list.length,
-	agentVerdict: data.verdict,
-	verdict: computeVerdict(data.issue_list)
-}));
+}).transform((data) => {
+	const augmentedIssueList = [...data.issue_list];
+	for (const entry of data.ac_checklist) if (entry.status === "not_met") {
+		const acIdPattern = new RegExp(`\\b${entry.ac_id}\\b`);
+		const alreadyFlagged = augmentedIssueList.some((issue) => (issue.severity === "major" || issue.severity === "blocker") && acIdPattern.test(issue.description));
+		if (!alreadyFlagged) augmentedIssueList.push({
+			severity: "major",
+			description: `${entry.ac_id} not implemented: ${entry.evidence}`,
+			file: ""
+		});
+	}
+	return {
+		...data,
+		issue_list: augmentedIssueList,
+		issues: augmentedIssueList.length,
+		agentVerdict: data.verdict,
+		verdict: computeVerdict(augmentedIssueList)
+	};
+});
 /**
 * Schema for the YAML output contract of the test-plan sub-agent.
 *
@@ -4018,12 +4182,46 @@ const TestExpansionResultSchema = z.object({
 });
 
 //#endregion
-//#region src/modules/compiled-workflows/create-story.ts
-const logger$14 = createLogger("compiled-workflows:create-story");
+//#region src/modules/compiled-workflows/token-ceiling.ts
+/**
+* Default token ceilings for each compiled workflow.
+* These match the hardcoded constants previously defined inline in each workflow.
+*/
+const TOKEN_CEILING_DEFAULTS = {
+	"create-story": 3e3,
+	"dev-story": 24e3,
+	"code-review": 1e5,
+	"test-plan": 8e3,
+	"test-expansion": 2e4
+};
 /**
-* Hard ceiling for the assembled create-story prompt.
+* Resolve the effective token ceiling for a workflow type.
+*
+* Returns the ceiling from `tokenCeilings` config if present and valid,
+* otherwise falls back to the hardcoded default.
+*
+* @param workflowType - One of: 'create-story', 'dev-story', 'code-review', 'test-plan', 'test-expansion'
+* @param tokenCeilings - Optional per-workflow overrides from parsed config
+* @returns `{ ceiling: number, source: 'config' | 'default' }`
 */
-const TOKEN_CEILING$4 = 3e3;
+function getTokenCeiling(workflowType, tokenCeilings) {
+	if (tokenCeilings !== void 0) {
+		const configured = tokenCeilings[workflowType];
+		if (configured !== void 0) return {
+			ceiling: configured,
+			source: "config"
+		};
+	}
+	const defaultValue = TOKEN_CEILING_DEFAULTS[workflowType] ?? 0;
+	return {
+		ceiling: defaultValue,
+		source: "default"
+	};
+}
+
+//#endregion
+//#region src/modules/compiled-workflows/create-story.ts
+const logger$16 = createLogger("compiled-workflows:create-story");
 /**
 * Execute the compiled create-story workflow.
 *
@@ -4043,17 +4241,23 @@ const TOKEN_CEILING$4 = 3e3;
 */
 async function runCreateStory(deps, params) {
 	const { epicId, storyKey, pipelineRunId } = params;
-	logger$14.debug({
+	logger$16.debug({
 		epicId,
 		storyKey,
 		pipelineRunId
 	}, "Starting create-story workflow");
+	const { ceiling: TOKEN_CEILING, source: tokenCeilingSource } = getTokenCeiling("create-story", deps.tokenCeilings);
+	logger$16.info({
+		workflow: "create-story",
+		ceiling: TOKEN_CEILING,
+		source: tokenCeilingSource
+	}, "Token ceiling resolved");
 	let template;
 	try {
 		template = await deps.pack.getPrompt("create-story");
 	} catch (err) {
 		const error = err instanceof Error ? err.message : String(err);
-		logger$14.error({ error }, "Failed to retrieve create-story prompt template");
+		logger$16.error({ error }, "Failed to retrieve create-story prompt template");
 		return {
 			result: "failed",
 			error: `Failed to retrieve prompt template: ${error}`,
@@ -4094,11 +4298,11 @@ async function runCreateStory(deps, params) {
 			content: storyTemplateContent,
 			priority: "important"
 		}
-	], TOKEN_CEILING$4);
-	logger$14.debug({
+	], TOKEN_CEILING);
+	logger$16.debug({
 		tokenCount,
 		truncated,
-		tokenCeiling: TOKEN_CEILING$4
+		tokenCeiling: TOKEN_CEILING
 	}, "Prompt assembled for create-story");
 	const handle = deps.dispatcher.dispatch({
 		prompt,
@@ -4112,7 +4316,7 @@ async function runCreateStory(deps, params) {
 		dispatchResult = await handle.result;
 	} catch (err) {
 		const error = err instanceof Error ? err.message : String(err);
-		logger$14.error({
+		logger$16.error({
 			epicId,
 			storyKey,
 			error
@@ -4133,7 +4337,7 @@ async function runCreateStory(deps, params) {
 	if (dispatchResult.status === "failed") {
 		const errorMsg = dispatchResult.parseError ?? `Dispatch failed with exit code ${dispatchResult.exitCode}`;
 		const stderrDetail = dispatchResult.output ? ` Output: ${dispatchResult.output}` : "";
-		logger$14.warn({
+		logger$16.warn({
 			epicId,
 			storyKey,
 			exitCode: dispatchResult.exitCode
@@ -4145,7 +4349,7 @@ async function runCreateStory(deps, params) {
 		};
 	}
 	if (dispatchResult.status === "timeout") {
-		logger$14.warn({
+		logger$16.warn({
 			epicId,
 			storyKey
 		}, "Create-story dispatch timed out");
@@ -4158,7 +4362,7 @@ async function runCreateStory(deps, params) {
 	if (dispatchResult.parsed === null) {
 		const details = dispatchResult.parseError ?? "No YAML block found in output";
 		const rawSnippet = dispatchResult.output ? dispatchResult.output.slice(0, 1e3) : "(empty)";
-		logger$14.warn({
+		logger$16.warn({
 			epicId,
 			storyKey,
 			details,
@@ -4174,7 +4378,7 @@ async function runCreateStory(deps, params) {
 	const parseResult = CreateStoryResultSchema.safeParse(dispatchResult.parsed);
 	if (!parseResult.success) {
 		const details = parseResult.error.message;
-		logger$14.warn({
+		logger$16.warn({
 			epicId,
 			storyKey,
 			details
@@ -4187,7 +4391,7 @@ async function runCreateStory(deps, params) {
 		};
 	}
 	const parsed = parseResult.data;
-	logger$14.info({
+	logger$16.info({
 		epicId,
 		storyKey,
 		storyFile: parsed.story_file,
@@ -4209,7 +4413,7 @@ function getImplementationDecisions(deps) {
 	try {
 		return getDecisionsByPhase(deps.db, "implementation");
 	} catch (err) {
-		logger$14.warn({ error: err instanceof Error ? err.message : String(err) }, "Failed to retrieve implementation decisions");
+		logger$16.warn({ error: err instanceof Error ? err.message : String(err) }, "Failed to retrieve implementation decisions");
 		return [];
 	}
 }
@@ -4252,13 +4456,13 @@ function getEpicShard(decisions, epicId, projectRoot, storyKey) {
 			if (storyKey) {
 				const storySection = extractStorySection(shardContent, storyKey);
 				if (storySection) {
-					logger$14.debug({
+					logger$16.debug({
 						epicId,
 						storyKey
 					}, "Extracted per-story section from epic shard");
 					return storySection;
 				}
-				logger$14.debug({
+				logger$16.debug({
 					epicId,
 					storyKey
 				}, "No matching story section found — using full epic shard");
@@ -4268,11 +4472,11 @@ function getEpicShard(decisions, epicId, projectRoot, storyKey) {
 		if (projectRoot) {
 			const fallback = readEpicShardFromFile(projectRoot, epicId);
 			if (fallback) {
-				logger$14.info({ epicId }, "Using file-based fallback for epic shard (decisions table empty)");
+				logger$16.info({ epicId }, "Using file-based fallback for epic shard (decisions table empty)");
 				if (storyKey) {
 					const storySection = extractStorySection(fallback, storyKey);
 					if (storySection) {
-						logger$14.debug({
+						logger$16.debug({
 							epicId,
 							storyKey
 						}, "Extracted per-story section from file-based epic shard");
@@ -4284,7 +4488,7 @@ function getEpicShard(decisions, epicId, projectRoot, storyKey) {
 		}
 		return "";
 	} catch (err) {
-		logger$14.warn({
+		logger$16.warn({
 			epicId,
 			error: err instanceof Error ? err.message : String(err)
 		}, "Failed to retrieve epic shard");
@@ -4301,7 +4505,7 @@ function getPrevDevNotes(decisions, epicId) {
 		if (devNotes.length === 0) return "";
 		return devNotes[devNotes.length - 1].value;
 	} catch (err) {
-		logger$14.warn({
+		logger$16.warn({
 			epicId,
 			error: err instanceof Error ? err.message : String(err)
 		}, "Failed to retrieve prev dev notes");
@@ -4321,13 +4525,13 @@ function getArchConstraints$2(deps) {
 		if (deps.projectRoot) {
 			const fallback = readArchConstraintsFromFile(deps.projectRoot);
 			if (fallback) {
-				logger$14.info("Using file-based fallback for architecture constraints (decisions table empty)");
+				logger$16.info("Using file-based fallback for architecture constraints (decisions table empty)");
 				return fallback;
 			}
 		}
 		return "";
 	} catch (err) {
-		logger$14.warn({ error: err instanceof Error ? err.message : String(err) }, "Failed to retrieve architecture constraints");
+		logger$16.warn({ error: err instanceof Error ? err.message : String(err) }, "Failed to retrieve architecture constraints");
 		return "";
 	}
 }
@@ -4347,7 +4551,7 @@ function readEpicShardFromFile(projectRoot, epicId) {
 		const match = pattern.exec(content);
 		return match ? match[0].trim() : "";
 	} catch (err) {
-		logger$14.warn({
+		logger$16.warn({
 			epicId,
 			error: err instanceof Error ? err.message : String(err)
 		}, "File-based epic shard fallback failed");
@@ -4370,7 +4574,7 @@ function readArchConstraintsFromFile(projectRoot) {
 		const content = readFileSync$1(archPath, "utf-8");
 		return content.slice(0, 1500);
 	} catch (err) {
-		logger$14.warn({ error: err instanceof Error ? err.message : String(err) }, "File-based architecture fallback failed");
+		logger$16.warn({ error: err instanceof Error ? err.message : String(err) }, "File-based architecture fallback failed");
 		return "";
 	}
 }
@@ -4383,7 +4587,7 @@ async function getStoryTemplate(deps) {
 	try {
 		return await deps.pack.getTemplate("story");
 	} catch (err) {
-		logger$14.warn({ error: err instanceof Error ? err.message : String(err) }, "Failed to retrieve story template from pack");
+		logger$16.warn({ error: err instanceof Error ? err.message : String(err) }, "Failed to retrieve story template from pack");
 		return "";
 	}
 }
@@ -4420,7 +4624,7 @@ async function isValidStoryFile(filePath) {
 
 //#endregion
 //#region src/modules/compiled-workflows/git-helpers.ts
-const logger$13 = createLogger("compiled-workflows:git-helpers");
+const logger$15 = createLogger("compiled-workflows:git-helpers");
 /**
 * Capture the full git diff for HEAD (working tree vs current commit).
 *
@@ -4516,7 +4720,7 @@ async function stageIntentToAdd(files, workingDirectory) {
 	if (files.length === 0) return;
 	const existing = files.filter((f) => {
 		const exists = existsSync$1(f);
-		if (!exists) logger$13.debug({ file: f }, "Skipping nonexistent file in stageIntentToAdd");
+		if (!exists) logger$15.debug({ file: f }, "Skipping nonexistent file in stageIntentToAdd");
 		return exists;
 	});
 	if (existing.length === 0) return;
@@ -4550,7 +4754,7 @@ async function runGitCommand(args, cwd, logLabel) {
 			stderr += chunk.toString("utf-8");
 		});
 		proc.on("error", (err) => {
-			logger$13.warn({
+			logger$15.warn({
 				label: logLabel,
 				cwd,
 				error: err.message
@@ -4559,7 +4763,7 @@ async function runGitCommand(args, cwd, logLabel) {
 		});
 		proc.on("close", (code) => {
 			if (code !== 0) {
-				logger$13.warn({
+				logger$15.warn({
 					label: logLabel,
 					cwd,
 					code,
@@ -4575,7 +4779,7 @@ async function runGitCommand(args, cwd, logLabel) {
 
 //#endregion
 //#region src/modules/implementation-orchestrator/project-findings.ts
-const logger$12 = createLogger("project-findings");
+const logger$14 = createLogger("project-findings");
 /** Maximum character length for the findings summary */
 const MAX_CHARS = 2e3;
 /**
@@ -4630,7 +4834,7 @@ function getProjectFindings(db) {
 		if (summary.length > MAX_CHARS) summary = summary.slice(0, MAX_CHARS - 3) + "...";
 		return summary;
 	} catch (err) {
-		logger$12.warn({ err }, "Failed to query project findings (graceful fallback)");
+		logger$14.warn({ err }, "Failed to query project findings (graceful fallback)");
 		return "";
 	}
 }
@@ -4651,11 +4855,119 @@ function extractRecurringPatterns(outcomes) {
 	return [...patternCounts.entries()].filter(([, count]) => count >= 2).sort((a, b) => b[1] - a[1]).slice(0, 5).map(([pattern, count]) => `${pattern} (${count} occurrences)`);
 }
 
+//#endregion
+//#region src/modules/compiled-workflows/story-complexity.ts
+const logger$13 = createLogger("compiled-workflows:story-complexity");
+/**
+* Compute a complexity score from story markdown content.
+*
+* Returns { taskCount, subtaskCount, fileCount, complexityScore }.
+* All counts default to 0 when the corresponding sections are absent.
+*
+* @param storyContent - Raw markdown content of the story file
+*/
+function computeStoryComplexity(storyContent) {
+	const taskCount = countTopLevelTasks(storyContent);
+	const subtaskCount = countSubtasks(storyContent);
+	const fileCount = countFilesInLayout(storyContent);
+	const complexityScore = Math.round(taskCount + subtaskCount * .5 + fileCount * .5);
+	return {
+		taskCount,
+		subtaskCount,
+		fileCount,
+		complexityScore
+	};
+}
+/**
+* Compute the resolved maxTurns for a dev-story dispatch.
+*
+* base 75 turns for score <= 10, +10 turns per additional complexity point, capped at 200.
+*
+* @param complexityScore - Score returned by computeStoryComplexity
+*/
+function resolveDevStoryMaxTurns(complexityScore) {
+	return Math.min(200, 75 + Math.max(0, complexityScore - 10) * 10);
+}
+/**
+* Compute the resolved maxTurns for a fix-story (major-rework) dispatch.
+*
+* base 50 turns for score <= 10, +10 turns per additional complexity point, capped at 150.
+*
+* @param complexityScore - Score returned by computeStoryComplexity
+*/
+function resolveFixStoryMaxTurns(complexityScore) {
+	return Math.min(150, 50 + Math.max(0, complexityScore - 10) * 10);
+}
+/**
+* Log the complexity result at info level.
+*
+* Emits a structured log with storyKey, taskCount, subtaskCount, fileCount,
+* complexityScore, and resolvedMaxTurns so operators can observe turn-limit scaling.
+*
+* @param storyKey - Story identifier (e.g. "24-6")
+* @param complexity - Result from computeStoryComplexity
+* @param resolvedMaxTurns - Turn limit resolved for this dispatch
+*/
+function logComplexityResult(storyKey, complexity, resolvedMaxTurns) {
+	logger$13.info({
+		storyKey,
+		taskCount: complexity.taskCount,
+		subtaskCount: complexity.subtaskCount,
+		fileCount: complexity.fileCount,
+		complexityScore: complexity.complexityScore,
+		resolvedMaxTurns
+	}, "Story complexity computed");
+}
+/**
+* Count top-level task lines matching `- [ ] Task N:` (with literal "Task" keyword).
+*/
+function countTopLevelTasks(content) {
+	const taskPattern = /^- \[ \] Task \d+:/gm;
+	return (content.match(taskPattern) ?? []).length;
+}
+/**
+* Count nested subtask lines — `- [ ]` lines that begin with one or more spaces or tabs.
+*
+* IMPORTANT: Use `[ \t]+` (space/tab only), NOT `\s+`, because `\s` includes `\n`.
+* With multiline `/gm`, using `\s+` causes false matches when an empty line (`\n`)
+* precedes a top-level `- [ ]` line — the `\n` gets consumed as "whitespace".
+*/
+function countSubtasks(content) {
+	const subtaskPattern = /^[ \t]+- \[ \]/gm;
+	return (content.match(subtaskPattern) ?? []).length;
+}
+/**
+* Count file entries inside a "File Layout" fenced code block.
+*
+* Uses a split-based section extraction to avoid regex lazy-matching pitfalls.
+* Finds a heading containing "File Layout", extracts section content up to the
+* next heading (or end of string), then finds fenced code blocks within it.
+*
+* Returns 0 when no File Layout section or fenced code block is found.
+*/
+function countFilesInLayout(content) {
+	const headingMatch = content.match(/^#{2,4}\s+File\s+Layout\s*$/im);
+	if (!headingMatch || headingMatch.index === void 0) return 0;
+	const afterHeading = content.slice(headingMatch.index + headingMatch[0].length);
+	const nextHeadingMatch = afterHeading.match(/^#{2,4}\s+/m);
+	const sectionContent = nextHeadingMatch?.index !== void 0 ? afterHeading.slice(0, nextHeadingMatch.index) : afterHeading;
+	const codeBlocks = sectionContent.match(/```[\s\S]*?```/g);
+	if (!codeBlocks) return 0;
+	const fileExtPattern = /\.(ts|js|json|sql|yaml|yml|md)\b/;
+	let count = 0;
+	for (const block of codeBlocks) {
+		const lines = block.split("\n");
+		for (const line of lines) {
+			if (line.trimStart().startsWith("```")) continue;
+			if (fileExtPattern.test(line)) count++;
+		}
+	}
+	return count;
+}
+
 //#endregion
 //#region src/modules/compiled-workflows/dev-story.ts
-const logger$11 = createLogger("compiled-workflows:dev-story");
-/** Hard token ceiling for the assembled dev-story prompt */
-const TOKEN_CEILING$3 = 24e3;
+const logger$12 = createLogger("compiled-workflows:dev-story");
 /** Default timeout for dev-story dispatches in milliseconds (30 min) */
 const DEFAULT_TIMEOUT_MS$1 = 18e5;
 /** Default Vitest test patterns injected when no test-pattern decisions exist */
@@ -4678,10 +4990,16 @@ const DEFAULT_VITEST_PATTERNS = `## Test Patterns (defaults)
 */
 async function runDevStory(deps, params) {
 	const { storyKey, storyFilePath, taskScope, priorFiles } = params;
-	logger$11.info({
+	logger$12.info({
 		storyKey,
 		storyFilePath
 	}, "Starting compiled dev-story workflow");
+	const { ceiling: TOKEN_CEILING, source: tokenCeilingSource } = getTokenCeiling("dev-story", deps.tokenCeilings);
+	logger$12.info({
+		workflow: "dev-story",
+		ceiling: TOKEN_CEILING,
+		source: tokenCeilingSource
+	}, "Token ceiling resolved");
 	const devStoryContextTemplate = {
 		taskType: "dev-story",
 		sections: [{
@@ -4720,10 +5038,10 @@ async function runDevStory(deps, params) {
 	let template;
 	try {
 		template = await deps.pack.getPrompt("dev-story");
-		logger$11.debug({ storyKey }, "Retrieved dev-story prompt template from pack");
+		logger$12.debug({ storyKey }, "Retrieved dev-story prompt template from pack");
 	} catch (err) {
 		const error = err instanceof Error ? err.message : String(err);
-		logger$11.error({
+		logger$12.error({
 			storyKey,
 			error
 		}, "Failed to retrieve dev-story prompt template");
@@ -4734,14 +5052,14 @@ async function runDevStory(deps, params) {
 		storyContent = await readFile$1(storyFilePath, "utf-8");
 	} catch (err) {
 		if (err.code === "ENOENT") {
-			logger$11.error({
+			logger$12.error({
 				storyKey,
 				storyFilePath
 			}, "Story file not found");
 			return makeFailureResult("story_file_not_found");
 		}
 		const error = err instanceof Error ? err.message : String(err);
-		logger$11.error({
+		logger$12.error({
 			storyKey,
 			storyFilePath,
 			error
@@ -4749,29 +5067,32 @@ async function runDevStory(deps, params) {
 		return makeFailureResult(`story_file_read_error: ${error}`);
 	}
 	if (storyContent.trim().length === 0) {
-		logger$11.error({
+		logger$12.error({
 			storyKey,
 			storyFilePath
 		}, "Story file is empty");
 		return makeFailureResult("story_file_empty");
 	}
+	const complexity = computeStoryComplexity(storyContent);
+	const resolvedMaxTurns = resolveDevStoryMaxTurns(complexity.complexityScore);
+	logComplexityResult(storyKey, complexity, resolvedMaxTurns);
 	let testPatternsContent = "";
 	try {
 		const solutioningDecisions = getDecisionsByPhase(deps.db, "solutioning");
 		const testPatternDecisions = solutioningDecisions.filter((d) => d.category === "test-patterns");
 		if (testPatternDecisions.length > 0) {
 			testPatternsContent = "## Test Patterns\n" + testPatternDecisions.map((d) => `- ${d.key}: ${d.value}`).join("\n");
-			logger$11.debug({
+			logger$12.debug({
 				storyKey,
 				count: testPatternDecisions.length
 			}, "Loaded test patterns from decision store");
 		} else {
 			testPatternsContent = DEFAULT_VITEST_PATTERNS;
-			logger$11.debug({ storyKey }, "No test-pattern decisions found — using default Vitest patterns");
+			logger$12.debug({ storyKey }, "No test-pattern decisions found — using default Vitest patterns");
 		}
 	} catch (err) {
 		const error = err instanceof Error ? err.message : String(err);
-		logger$11.warn({
+		logger$12.warn({
 			storyKey,
 			error
 		}, "Failed to load test patterns — using defaults");
@@ -4786,7 +5107,7 @@ async function runDevStory(deps, params) {
 		const findings = getProjectFindings(deps.db);
 		if (findings.length > 0) {
 			priorFindingsContent = "Previous pipeline runs encountered these issues — avoid repeating them:\n\n" + findings;
-			logger$11.debug({
+			logger$12.debug({
 				storyKey,
 				findingsLen: findings.length
 			}, "Injecting prior findings into dev-story prompt");
@@ -4806,7 +5127,7 @@ async function runDevStory(deps, params) {
 			if (plan.test_categories && plan.test_categories.length > 0) parts.push(`\n### Categories: ${plan.test_categories.join(", ")}`);
 			if (plan.coverage_notes) parts.push(`\n### Coverage Notes\n${plan.coverage_notes}`);
 			testPlanContent = parts.join("\n");
-			logger$11.debug({ storyKey }, "Injecting test plan into dev-story prompt");
+			logger$12.debug({ storyKey }, "Injecting test plan into dev-story prompt");
 		}
 	} catch {}
 	const sections = [
@@ -4851,11 +5172,11 @@ async function runDevStory(deps, params) {
 			priority: "optional"
 		}
 	];
-	const { prompt, tokenCount, truncated } = assemblePrompt(template, sections, TOKEN_CEILING$3);
-	logger$11.info({
+	const { prompt, tokenCount, truncated } = assemblePrompt(template, sections, TOKEN_CEILING);
+	logger$12.info({
 		storyKey,
 		tokenCount,
-		ceiling: TOKEN_CEILING$3,
+		ceiling: TOKEN_CEILING,
 		truncated
 	}, "Assembled dev-story prompt");
 	let dispatchResult;
@@ -4866,12 +5187,13 @@ async function runDevStory(deps, params) {
 			taskType: "dev-story",
 			timeout: DEFAULT_TIMEOUT_MS$1,
 			outputSchema: DevStoryResultSchema,
+			maxTurns: resolvedMaxTurns,
 			...deps.projectRoot !== void 0 ? { workingDirectory: deps.projectRoot } : {}
 		});
 		dispatchResult = await handle.result;
 	} catch (err) {
 		const error = err instanceof Error ? err.message : String(err);
-		logger$11.error({
+		logger$12.error({
 			storyKey,
 			error
 		}, "Dispatch threw an unexpected error");
@@ -4882,11 +5204,11 @@ async function runDevStory(deps, params) {
 		output: dispatchResult.tokenEstimate.output
 	};
 	if (dispatchResult.status === "timeout") {
-		logger$11.error({
+		logger$12.error({
 			storyKey,
 			durationMs: dispatchResult.durationMs
 		}, "Dev-story dispatch timed out");
-		if (dispatchResult.output.length > 0) logger$11.info({
+		if (dispatchResult.output.length > 0) logger$12.info({
 			storyKey,
 			partialOutput: dispatchResult.output.slice(0, 500)
 		}, "Partial output before timeout");
@@ -4896,12 +5218,12 @@ async function runDevStory(deps, params) {
 		};
 	}
 	if (dispatchResult.status === "failed" || dispatchResult.exitCode !== 0) {
-		logger$11.error({
+		logger$12.error({
 			storyKey,
 			exitCode: dispatchResult.exitCode,
 			status: dispatchResult.status
 		}, "Dev-story dispatch failed");
-		if (dispatchResult.output.length > 0) logger$11.info({
+		if (dispatchResult.output.length > 0) logger$12.info({
 			storyKey,
 			partialOutput: dispatchResult.output.slice(0, 500)
 		}, "Partial output from failed dispatch");
@@ -4913,7 +5235,7 @@ async function runDevStory(deps, params) {
 	if (dispatchResult.parseError !== null || dispatchResult.parsed === null) {
 		const details = dispatchResult.parseError ?? "parsed result was null";
 		const rawSnippet = dispatchResult.output ? dispatchResult.output.slice(0, 1e3) : "(empty)";
-		logger$11.error({
+		logger$12.error({
 			storyKey,
 			parseError: details,
 			rawOutputSnippet: rawSnippet
@@ -4921,12 +5243,12 @@ async function runDevStory(deps, params) {
 		let filesModified = [];
 		try {
 			filesModified = await getGitChangedFiles(deps.projectRoot ?? process.cwd());
-			if (filesModified.length > 0) logger$11.info({
+			if (filesModified.length > 0) logger$12.info({
 				storyKey,
 				fileCount: filesModified.length
 			}, "Recovered files_modified from git status (YAML fallback)");
 		} catch (err) {
-			logger$11.warn({
+			logger$12.warn({
 				storyKey,
 				error: err instanceof Error ? err.message : String(err)
 			}, "Failed to recover files_modified from git");
@@ -4943,7 +5265,7 @@ async function runDevStory(deps, params) {
 		};
 	}
 	const parsed = dispatchResult.parsed;
-	logger$11.info({
+	logger$12.info({
 		storyKey,
 		result: parsed.result,
 		acMet: parsed.ac_met.length
@@ -5082,13 +5404,7 @@ function extractFilesInScope(storyContent) {
 
 //#endregion
 //#region src/modules/compiled-workflows/code-review.ts
-const logger$10 = createLogger("compiled-workflows:code-review");
-/**
-* Hard token ceiling for the assembled code-review prompt (50,000 tokens).
-* Quality reviews require seeing actual code diffs, not just file names.
-* // TODO: consider externalizing to pack config when multiple packs exist
-*/
-const TOKEN_CEILING$2 = 1e5;
+const logger$11 = createLogger("compiled-workflows:code-review");
 /**
 * Default fallback result when dispatch fails or times out.
 * Uses NEEDS_MINOR_FIXES (not NEEDS_MAJOR_REWORK) so a parse/schema failure
@@ -5126,18 +5442,24 @@ function defaultFailResult(error, tokenUsage) {
 async function runCodeReview(deps, params) {
 	const { storyKey, storyFilePath, workingDirectory, pipelineRunId, filesModified, previousIssues } = params;
 	const cwd = workingDirectory ?? process.cwd();
-	logger$10.debug({
+	logger$11.debug({
 		storyKey,
 		storyFilePath,
 		cwd,
 		pipelineRunId
 	}, "Starting code-review workflow");
+	const { ceiling: TOKEN_CEILING, source: tokenCeilingSource } = getTokenCeiling("code-review", deps.tokenCeilings);
+	logger$11.info({
+		workflow: "code-review",
+		ceiling: TOKEN_CEILING,
+		source: tokenCeilingSource
+	}, "Token ceiling resolved");
 	let template;
 	try {
 		template = await deps.pack.getPrompt("code-review");
 	} catch (err) {
 		const error = err instanceof Error ? err.message : String(err);
-		logger$10.error({ error }, "Failed to retrieve code-review prompt template");
+		logger$11.error({ error }, "Failed to retrieve code-review prompt template");
 		return defaultFailResult(`Failed to retrieve prompt template: ${error}`, {
 			input: 0,
 			output: 0
@@ -5148,7 +5470,7 @@ async function runCodeReview(deps, params) {
 		storyContent = await readFile$1(storyFilePath, "utf-8");
 	} catch (err) {
 		const error = err instanceof Error ? err.message : String(err);
-		logger$10.error({
+		logger$11.error({
 			storyFilePath,
 			error
 		}, "Failed to read story file");
@@ -5166,16 +5488,16 @@ async function runCodeReview(deps, params) {
 	if (filesModified && filesModified.length > 0) {
 		const scopedDiff = await getGitDiffForFiles(filesModified, cwd);
 		const scopedTotal = nonDiffTokens + countTokens(scopedDiff);
-		if (scopedTotal <= TOKEN_CEILING$2) {
+		if (scopedTotal <= TOKEN_CEILING) {
 			gitDiffContent = scopedDiff;
-			logger$10.debug({
+			logger$11.debug({
 				fileCount: filesModified.length,
 				tokenCount: scopedTotal
 			}, "Using scoped file diff");
 		} else {
-			logger$10.warn({
+			logger$11.warn({
 				estimatedTotal: scopedTotal,
-				ceiling: TOKEN_CEILING$2,
+				ceiling: TOKEN_CEILING,
 				fileCount: filesModified.length
 			}, "Scoped diff exceeds token ceiling — falling back to stat-only summary");
 			gitDiffContent = await getGitDiffStatSummary(cwd);
@@ -5185,17 +5507,17 @@ async function runCodeReview(deps, params) {
 		await stageIntentToAdd(changedFiles, cwd);
 		const fullDiff = await getGitDiffSummary(cwd);
 		const fullTotal = nonDiffTokens + countTokens(fullDiff);
-		if (fullTotal <= TOKEN_CEILING$2) gitDiffContent = fullDiff;
+		if (fullTotal <= TOKEN_CEILING) gitDiffContent = fullDiff;
 		else {
-			logger$10.warn({
+			logger$11.warn({
 				estimatedTotal: fullTotal,
-				ceiling: TOKEN_CEILING$2
+				ceiling: TOKEN_CEILING
 			}, "Full git diff would exceed token ceiling — using stat-only summary");
 			gitDiffContent = await getGitDiffStatSummary(cwd);
 		}
 	}
 	if (gitDiffContent.trim().length === 0) {
-		logger$10.info({ storyKey }, "Empty git diff — skipping review with SHIP_IT");
+		logger$11.info({ storyKey }, "Empty git diff — skipping review with SHIP_IT");
 		return {
 			verdict: "SHIP_IT",
 			issues: 0,
@@ -5220,7 +5542,7 @@ async function runCodeReview(deps, params) {
 		const findings = getProjectFindings(deps.db);
 		if (findings.length > 0) {
 			priorFindingsContent = "Previous reviews found these recurring patterns — pay special attention:\n\n" + findings;
-			logger$10.debug({
+			logger$11.debug({
 				storyKey,
 				findingsLen: findings.length
 			}, "Injecting prior findings into code-review prompt");
@@ -5253,12 +5575,12 @@ async function runCodeReview(deps, params) {
 			priority: "optional"
 		}
 	];
-	const assembleResult = assemblePrompt(template, sections, TOKEN_CEILING$2);
-	if (assembleResult.truncated) logger$10.warn({
+	const assembleResult = assemblePrompt(template, sections, TOKEN_CEILING);
+	if (assembleResult.truncated) logger$11.warn({
 		storyKey,
 		tokenCount: assembleResult.tokenCount
 	}, "Code-review prompt truncated to fit token ceiling");
-	logger$10.debug({
+	logger$11.debug({
 		storyKey,
 		tokenCount: assembleResult.tokenCount,
 		truncated: assembleResult.truncated
@@ -5276,7 +5598,7 @@ async function runCodeReview(deps, params) {
 		dispatchResult = await handle.result;
 	} catch (err) {
 		const error = err instanceof Error ? err.message : String(err);
-		logger$10.error({
+		logger$11.error({
 			storyKey,
 			error
 		}, "Code-review dispatch threw unexpected error");
@@ -5292,7 +5614,7 @@ async function runCodeReview(deps, params) {
 	const rawOutput = dispatchResult.output ?? void 0;
 	if (dispatchResult.status === "failed") {
 		const errorMsg = `Dispatch status: failed. Exit code: ${dispatchResult.exitCode}. ${dispatchResult.parseError ?? ""} ${dispatchResult.output ? `Stderr: ${dispatchResult.output}` : ""}`.trim();
-		logger$10.warn({
+		logger$11.warn({
 			storyKey,
 			exitCode: dispatchResult.exitCode
 		}, "Code-review dispatch failed");
@@ -5302,7 +5624,7 @@ async function runCodeReview(deps, params) {
 		};
 	}
 	if (dispatchResult.status === "timeout") {
-		logger$10.warn({ storyKey }, "Code-review dispatch timed out");
+		logger$11.warn({ storyKey }, "Code-review dispatch timed out");
 		return {
 			...defaultFailResult("Dispatch status: timeout. The agent did not complete within the allowed time.", tokenUsage),
 			rawOutput
@@ -5310,7 +5632,7 @@ async function runCodeReview(deps, params) {
 	}
 	if (dispatchResult.parsed === null) {
 		const details = dispatchResult.parseError ?? "No YAML block found in output";
-		logger$10.warn({
+		logger$11.warn({
 			storyKey,
 			details
 		}, "Code-review output schema validation failed");
@@ -5327,7 +5649,7 @@ async function runCodeReview(deps, params) {
 	const parseResult = CodeReviewResultSchema.safeParse(dispatchResult.parsed);
 	if (!parseResult.success) {
 		const details = parseResult.error.message;
-		logger$10.warn({
+		logger$11.warn({
 			storyKey,
 			details
 		}, "Code-review output failed schema validation");
@@ -5342,13 +5664,13 @@ async function runCodeReview(deps, params) {
 		};
 	}
 	const parsed = parseResult.data;
-	if (parsed.agentVerdict !== parsed.verdict) logger$10.info({
+	if (parsed.agentVerdict !== parsed.verdict) logger$11.info({
 		storyKey,
 		agentVerdict: parsed.agentVerdict,
 		pipelineVerdict: parsed.verdict,
 		issues: parsed.issues
 	}, "Pipeline overrode agent verdict based on issue severities");
-	logger$10.info({
+	logger$11.info({
 		storyKey,
 		verdict: parsed.verdict,
 		issues: parsed.issues
@@ -5373,16 +5695,14 @@ function getArchConstraints$1(deps) {
 		if (constraints.length === 0) return "";
 		return constraints.map((d) => `${d.key}: ${d.value}`).join("\n");
 	} catch (err) {
-		logger$10.warn({ error: err instanceof Error ? err.message : String(err) }, "Failed to retrieve architecture constraints");
+		logger$11.warn({ error: err instanceof Error ? err.message : String(err) }, "Failed to retrieve architecture constraints");
 		return "";
 	}
 }
 
 //#endregion
 //#region src/modules/compiled-workflows/test-plan.ts
-const logger$9 = createLogger("compiled-workflows:test-plan");
-/** Hard token ceiling for the assembled test-plan prompt */
-const TOKEN_CEILING$1 = 8e3;
+const logger$10 = createLogger("compiled-workflows:test-plan");
 /** Default timeout for test-plan dispatches in milliseconds (5 min — lightweight call) */
 const DEFAULT_TIMEOUT_MS = 3e5;
 /**
@@ -5394,17 +5714,23 @@ const DEFAULT_TIMEOUT_MS = 3e5;
 */
 async function runTestPlan(deps, params) {
 	const { storyKey, storyFilePath, pipelineRunId } = params;
-	logger$9.info({
+	logger$10.info({
 		storyKey,
 		storyFilePath
 	}, "Starting compiled test-plan workflow");
+	const { ceiling: TOKEN_CEILING, source: tokenCeilingSource } = getTokenCeiling("test-plan", deps.tokenCeilings);
+	logger$10.info({
+		workflow: "test-plan",
+		ceiling: TOKEN_CEILING,
+		source: tokenCeilingSource
+	}, "Token ceiling resolved");
 	let template;
 	try {
 		template = await deps.pack.getPrompt("test-plan");
-		logger$9.debug({ storyKey }, "Retrieved test-plan prompt template from pack");
+		logger$10.debug({ storyKey }, "Retrieved test-plan prompt template from pack");
 	} catch (err) {
 		const error = err instanceof Error ? err.message : String(err);
-		logger$9.warn({
+		logger$10.warn({
 			storyKey,
 			error
 		}, "Failed to retrieve test-plan prompt template");
@@ -5415,14 +5741,14 @@ async function runTestPlan(deps, params) {
 		storyContent = await readFile$1(storyFilePath, "utf-8");
 	} catch (err) {
 		if (err.code === "ENOENT") {
-			logger$9.warn({
+			logger$10.warn({
 				storyKey,
 				storyFilePath
 			}, "Story file not found for test planning");
 			return makeTestPlanFailureResult("story_file_not_found");
 		}
 		const error = err instanceof Error ? err.message : String(err);
-		logger$9.warn({
+		logger$10.warn({
 			storyKey,
 			storyFilePath,
 			error
@@ -5433,11 +5759,11 @@ async function runTestPlan(deps, params) {
 		name: "story_content",
 		content: storyContent,
 		priority: "required"
-	}], TOKEN_CEILING$1);
-	logger$9.info({
+	}], TOKEN_CEILING);
+	logger$10.info({
 		storyKey,
 		tokenCount,
-		ceiling: TOKEN_CEILING$1,
+		ceiling: TOKEN_CEILING,
 		truncated
 	}, "Assembled test-plan prompt");
 	let dispatchResult;
@@ -5453,7 +5779,7 @@ async function runTestPlan(deps, params) {
 		dispatchResult = await handle.result;
 	} catch (err) {
 		const error = err instanceof Error ? err.message : String(err);
-		logger$9.warn({
+		logger$10.warn({
 			storyKey,
 			error
 		}, "Test-plan dispatch threw an unexpected error");
@@ -5464,7 +5790,7 @@ async function runTestPlan(deps, params) {
 		output: dispatchResult.tokenEstimate.output
 	};
 	if (dispatchResult.status === "timeout") {
-		logger$9.warn({
+		logger$10.warn({
 			storyKey,
 			durationMs: dispatchResult.durationMs
 		}, "Test-plan dispatch timed out");
@@ -5474,7 +5800,7 @@ async function runTestPlan(deps, params) {
 		};
 	}
 	if (dispatchResult.status === "failed" || dispatchResult.exitCode !== 0) {
-		logger$9.warn({
+		logger$10.warn({
 			storyKey,
 			exitCode: dispatchResult.exitCode,
 			status: dispatchResult.status
@@ -5486,7 +5812,7 @@ async function runTestPlan(deps, params) {
 	}
 	if (dispatchResult.parseError !== null || dispatchResult.parsed === null) {
 		const details = dispatchResult.parseError ?? "parsed result was null";
-		logger$9.warn({
+		logger$10.warn({
 			storyKey,
 			parseError: details
 		}, "Test-plan YAML schema validation failed");
@@ -5509,19 +5835,19 @@ async function runTestPlan(deps, params) {
 			}),
 			rationale: `Test plan for ${storyKey}: ${parsed.test_files.length} test files, categories: ${parsed.test_categories.join(", ")}`
 		});
-		logger$9.info({
+		logger$10.info({
 			storyKey,
 			fileCount: parsed.test_files.length,
 			categories: parsed.test_categories
 		}, "Test plan stored in decision store");
 	} catch (err) {
 		const error = err instanceof Error ? err.message : String(err);
-		logger$9.warn({
+		logger$10.warn({
 			storyKey,
 			error
 		}, "Failed to store test plan in decision store — proceeding anyway");
 	}
-	logger$9.info({
+	logger$10.info({
 		storyKey,
 		result: parsed.result
 	}, "Test-plan workflow completed");
@@ -5552,11 +5878,7 @@ function makeTestPlanFailureResult(error) {
 
 //#endregion
 //#region src/modules/compiled-workflows/test-expansion.ts
-const logger$8 = createLogger("compiled-workflows:test-expansion");
-/**
-* Hard token ceiling for the assembled test-expansion prompt (20,000 tokens).
-*/
-const TOKEN_CEILING = 2e4;
+const logger$9 = createLogger("compiled-workflows:test-expansion");
 function defaultFallbackResult(error, tokenUsage) {
 	return {
 		expansion_priority: "low",
@@ -5586,18 +5908,24 @@ function defaultFallbackResult(error, tokenUsage) {
 async function runTestExpansion(deps, params) {
 	const { storyKey, storyFilePath, pipelineRunId, filesModified, workingDirectory } = params;
 	const cwd = workingDirectory ?? process.cwd();
-	logger$8.debug({
+	logger$9.debug({
 		storyKey,
 		storyFilePath,
 		cwd,
 		pipelineRunId
 	}, "Starting test-expansion workflow");
+	const { ceiling: TOKEN_CEILING, source: tokenCeilingSource } = getTokenCeiling("test-expansion", deps.tokenCeilings);
+	logger$9.info({
+		workflow: "test-expansion",
+		ceiling: TOKEN_CEILING,
+		source: tokenCeilingSource
+	}, "Token ceiling resolved");
 	let template;
 	try {
 		template = await deps.pack.getPrompt("test-expansion");
 	} catch (err) {
 		const error = err instanceof Error ? err.message : String(err);
-		logger$8.warn({ error }, "Failed to retrieve test-expansion prompt template");
+		logger$9.warn({ error }, "Failed to retrieve test-expansion prompt template");
 		return defaultFallbackResult(`Failed to retrieve prompt template: ${error}`, {
 			input: 0,
 			output: 0
@@ -5608,7 +5936,7 @@ async function runTestExpansion(deps, params) {
 		storyContent = await readFile$1(storyFilePath, "utf-8");
 	} catch (err) {
 		const error = err instanceof Error ? err.message : String(err);
-		logger$8.warn({
+		logger$9.warn({
 			storyFilePath,
 			error
 		}, "Failed to read story file");
@@ -5628,12 +5956,12 @@ async function runTestExpansion(deps, params) {
 		const scopedTotal = nonDiffTokens + countTokens(scopedDiff);
 		if (scopedTotal <= TOKEN_CEILING) {
 			gitDiffContent = scopedDiff;
-			logger$8.debug({
+			logger$9.debug({
 				fileCount: filesModified.length,
 				tokenCount: scopedTotal
 			}, "Using scoped file diff");
 		} else {
-			logger$8.warn({
+			logger$9.warn({
 				estimatedTotal: scopedTotal,
 				ceiling: TOKEN_CEILING,
 				fileCount: filesModified.length
@@ -5641,7 +5969,7 @@ async function runTestExpansion(deps, params) {
 			gitDiffContent = await getGitDiffStatSummary(cwd);
 		}
 	} catch (err) {
-		logger$8.warn({ error: err instanceof Error ? err.message : String(err) }, "Failed to get git diff — proceeding with empty diff");
+		logger$9.warn({ error: err instanceof Error ? err.message : String(err) }, "Failed to get git diff — proceeding with empty diff");
 	}
 	const sections = [
 		{
@@ -5661,11 +5989,11 @@ async function runTestExpansion(deps, params) {
 		}
 	];
 	const assembleResult = assemblePrompt(template, sections, TOKEN_CEILING);
-	if (assembleResult.truncated) logger$8.warn({
+	if (assembleResult.truncated) logger$9.warn({
 		storyKey,
 		tokenCount: assembleResult.tokenCount
 	}, "Test-expansion prompt truncated to fit token ceiling");
-	logger$8.debug({
+	logger$9.debug({
 		storyKey,
 		tokenCount: assembleResult.tokenCount,
 		truncated: assembleResult.truncated
@@ -5683,7 +6011,7 @@ async function runTestExpansion(deps, params) {
 		dispatchResult = await handle.result;
 	} catch (err) {
 		const error = err instanceof Error ? err.message : String(err);
-		logger$8.warn({
+		logger$9.warn({
 			storyKey,
 			error
 		}, "Test-expansion dispatch threw unexpected error");
@@ -5698,19 +6026,19 @@ async function runTestExpansion(deps, params) {
 	};
 	if (dispatchResult.status === "failed") {
 		const errorMsg = `Dispatch status: failed. Exit code: ${dispatchResult.exitCode}. ${dispatchResult.parseError ?? ""}`.trim();
-		logger$8.warn({
+		logger$9.warn({
 			storyKey,
 			exitCode: dispatchResult.exitCode
 		}, "Test-expansion dispatch failed");
 		return defaultFallbackResult(errorMsg, tokenUsage);
 	}
 	if (dispatchResult.status === "timeout") {
-		logger$8.warn({ storyKey }, "Test-expansion dispatch timed out");
+		logger$9.warn({ storyKey }, "Test-expansion dispatch timed out");
 		return defaultFallbackResult("Dispatch status: timeout. The agent did not complete within the allowed time.", tokenUsage);
 	}
 	if (dispatchResult.parsed === null) {
 		const details = dispatchResult.parseError ?? "No YAML block found in output";
-		logger$8.warn({
+		logger$9.warn({
 			storyKey,
 			details
 		}, "Test-expansion output has no parseable YAML");
@@ -5719,14 +6047,14 @@ async function runTestExpansion(deps, params) {
 	const parseResult = TestExpansionResultSchema.safeParse(dispatchResult.parsed);
 	if (!parseResult.success) {
 		const details = parseResult.error.message;
-		logger$8.warn({
+		logger$9.warn({
 			storyKey,
 			details
 		}, "Test-expansion output failed schema validation");
 		return defaultFallbackResult(`schema_validation_failed: ${details}`, tokenUsage);
 	}
 	const parsed = parseResult.data;
-	logger$8.info({
+	logger$9.info({
 		storyKey,
 		expansion_priority: parsed.expansion_priority,
 		coverage_gaps: parsed.coverage_gaps.length,
@@ -5751,7 +6079,7 @@ function getArchConstraints(deps) {
 		if (constraints.length === 0) return "";
 		return constraints.map((d) => `${d.key}: ${d.value}`).join("\n");
 	} catch (err) {
-		logger$8.warn({ error: err instanceof Error ? err.message : String(err) }, "Failed to retrieve architecture constraints");
+		logger$9.warn({ error: err instanceof Error ? err.message : String(err) }, "Failed to retrieve architecture constraints");
 		return "";
 	}
 }
@@ -6064,7 +6392,7 @@ function detectConflictGroups(storyKeys, config) {
 
 //#endregion
 //#region src/cli/commands/health.ts
-const logger$7 = createLogger("health-cmd");
+const logger$8 = createLogger("health-cmd");
 /** Default stall threshold in seconds — also used by supervisor default */
 const DEFAULT_STALL_THRESHOLD_SECONDS = 600;
 /**
@@ -6329,7 +6657,7 @@ async function runHealthAction(options) {
 		const msg = err instanceof Error ? err.message : String(err);
 		if (outputFormat === "json") process.stdout.write(formatOutput(null, "json", false, msg) + "\n");
 		else process.stderr.write(`Error: ${msg}\n`);
-		logger$7.error({ err }, "health action failed");
+		logger$8.error({ err }, "health action failed");
 		return 1;
 	}
 }
@@ -6347,7 +6675,7 @@ function registerHealthCommand(program, _version = "0.0.0", projectRoot = proces
 
 //#endregion
 //#region src/modules/implementation-orchestrator/seed-methodology-context.ts
-const logger$6 = createLogger("implementation-orchestrator:seed");
+const logger$7 = createLogger("implementation-orchestrator:seed");
 /** Max chars for the architecture summary seeded into decisions */
 const MAX_ARCH_CHARS = 6e3;
 /** Max chars per epic shard (fallback when per-story extraction returns null) */
@@ -6381,12 +6709,12 @@ function seedMethodologyContext(db, projectRoot) {
 		const testCount = seedTestPatterns(db, projectRoot);
 		if (testCount === -1) result.skippedCategories.push("test-patterns");
 		else result.decisionsCreated += testCount;
-		logger$6.info({
+		logger$7.info({
 			decisionsCreated: result.decisionsCreated,
 			skippedCategories: result.skippedCategories
 		}, "Methodology context seeding complete");
 	} catch (err) {
-		logger$6.warn({ error: err instanceof Error ? err.message : String(err) }, "Methodology context seeding failed (non-fatal)");
+		logger$7.warn({ error: err instanceof Error ? err.message : String(err) }, "Methodology context seeding failed (non-fatal)");
 	}
 	return result;
 }
@@ -6430,7 +6758,7 @@ function seedArchitecture(db, projectRoot) {
 		});
 		count = 1;
 	}
-	logger$6.debug({ count }, "Seeded architecture decisions");
+	logger$7.debug({ count }, "Seeded architecture decisions");
 	return count;
 }
 /**
@@ -6454,11 +6782,11 @@ function seedEpicShards(db, projectRoot) {
 	const storedHashDecision = implementationDecisions.find((d) => d.category === "epic-shard-hash" && d.key === "epics-file");
 	const storedHash = storedHashDecision?.value;
 	if (storedHash === currentHash) {
-		logger$6.debug({ hash: currentHash }, "Epic shards up-to-date (hash unchanged) — skipping re-seed");
+		logger$7.debug({ hash: currentHash }, "Epic shards up-to-date (hash unchanged) — skipping re-seed");
 		return -1;
 	}
 	if (implementationDecisions.some((d) => d.category === "epic-shard")) {
-		logger$6.debug({
+		logger$7.debug({
 			storedHash,
 			currentHash
 		}, "Epics file changed — deleting stale epic-shard decisions");
@@ -6486,7 +6814,7 @@ function seedEpicShards(db, projectRoot) {
 		value: currentHash,
 		rationale: "SHA-256 hash of epics file content for change detection"
 	});
-	logger$6.debug({
+	logger$7.debug({
 		count,
 		hash: currentHash
 	}, "Seeded epic shard decisions");
@@ -6510,7 +6838,7 @@ function seedTestPatterns(db, projectRoot) {
 		value: patterns.slice(0, MAX_TEST_PATTERNS_CHARS),
 		rationale: "Detected from project configuration at orchestrator startup"
 	});
-	logger$6.debug("Seeded test patterns decision");
+	logger$7.debug("Seeded test patterns decision");
 	return 1;
 }
 /**
@@ -6681,6 +7009,107 @@ function findArtifact(projectRoot, candidates) {
 	return void 0;
 }
 
+//#endregion
+//#region src/modules/agent-dispatch/interface-change-detector.ts
+const logger$6 = createLogger("interface-change-detector");
+/**
+* Extract exported interface and type names from TypeScript source content.
+*
+* Matches:
+*   export interface Foo { ... }  → 'Foo'
+*   export type Bar = ...         → 'Bar'
+*
+* Uses simple regex (not AST) for performance (<500ms target).
+* Does NOT match: re-exports (`export { Foo }`), default exports, internal declarations.
+*/
+function extractExportedNames(content) {
+	const names = [];
+	const pattern = /^export\s+(?:interface|type)\s+(\w+)/gm;
+	let match;
+	while ((match = pattern.exec(content)) !== null) if (match[1] !== void 0) names.push(match[1]);
+	return names;
+}
+/**
+* Detect whether modified .ts files export interfaces/types that are
+* referenced by test files outside the same module.
+*
+* Non-blocking: any errors during detection are caught, logged, and an empty
+* result is returned rather than throwing. Detection failure never blocks pipeline.
+*
+* @param options.filesModified - List of file paths modified by the dev-story (relative to projectRoot)
+* @param options.projectRoot   - Absolute path to the project root
+* @param options.storyKey      - Story key for logging context
+*/
+function detectInterfaceChanges(options) {
+	try {
+		const { filesModified, projectRoot, storyKey } = options;
+		const tsSourceFiles = filesModified.filter((f) => f.endsWith(".ts") && !f.endsWith(".test.ts") && !f.endsWith(".spec.ts"));
+		if (tsSourceFiles.length === 0) return {
+			modifiedInterfaces: [],
+			potentiallyAffectedTests: []
+		};
+		const allNames = new Set();
+		const sourceDirs = [];
+		for (const relPath of tsSourceFiles) {
+			const absPath = join$1(projectRoot, relPath);
+			try {
+				const content = readFileSync$1(absPath, "utf-8");
+				const names = extractExportedNames(content);
+				for (const name of names) allNames.add(name);
+				sourceDirs.push(dirname$1(relPath));
+			} catch {
+				logger$6.debug({
+					absPath,
+					storyKey
+				}, "Could not read modified file for interface extraction");
+			}
+		}
+		if (allNames.size === 0) return {
+			modifiedInterfaces: [],
+			potentiallyAffectedTests: []
+		};
+		const affectedTests = new Set();
+		for (const name of allNames) {
+			let grepOutput = "";
+			try {
+				grepOutput = execSync(`grep -r --include="*.test.ts" --include="*.spec.ts" -l "${name}" .`, {
+					cwd: projectRoot,
+					encoding: "utf-8",
+					timeout: 1e4,
+					stdio: [
+						"ignore",
+						"pipe",
+						"pipe"
+					]
+				});
+			} catch (grepErr) {
+				const e = grepErr;
+				if (typeof e.stdout === "string" && e.stdout.trim().length > 0) grepOutput = e.stdout;
+				else continue;
+			}
+			const testFiles = grepOutput.split("\n").map((l) => l.trim().replace(/^\.\//, "")).filter((l) => l.length > 0);
+			for (const tf of testFiles) {
+				const tfDir = dirname$1(tf);
+				const isSameModule = sourceDirs.some((srcDir) => tfDir === srcDir || tfDir.startsWith(srcDir + "/"));
+				if (!isSameModule) affectedTests.add(tf);
+			}
+		}
+		return {
+			modifiedInterfaces: Array.from(allNames),
+			potentiallyAffectedTests: Array.from(affectedTests)
+		};
+	} catch (err) {
+		logger$6.warn({
+			err,
+			storyKey: options.storyKey
+		}, "Interface change detection failed — skipping");
+		return {
+			modifiedInterfaces: [],
+			potentiallyAffectedTests: []
+		};
+	}
+}
+
 //#endregion
 //#region src/modules/implementation-orchestrator/orchestrator-impl.ts
 function createPauseGate() {
@@ -6701,8 +7130,8 @@ function createPauseGate() {
 * @returns A fully-configured ImplementationOrchestrator ready to call run()
 */
 function createImplementationOrchestrator(deps) {
-	const { db, pack, contextCompiler, dispatcher, eventBus, config, projectRoot } = deps;
-	const logger$20 = createLogger("implementation-orchestrator");
+	const { db, pack, contextCompiler, dispatcher, eventBus, config, projectRoot, tokenCeilings } = deps;
+	const logger$22 = createLogger("implementation-orchestrator");
 	let _state = "IDLE";
 	let _startedAt;
 	let _completedAt;
@@ -6745,7 +7174,7 @@ function createImplementationOrchestrator(deps) {
 		const nowMs = Date.now();
 		for (const [phase, startMs] of starts) {
 			const endMs = ends?.get(phase);
-			if (endMs === void 0) logger$20.warn({
+			if (endMs === void 0) logger$22.warn({
 				storyKey,
 				phase
 			}, "Phase has no end time — story may have errored mid-phase. Duration capped to now() and may be inflated.");
@@ -6760,12 +7189,14 @@ function createImplementationOrchestrator(deps) {
 			const startedAt = storyState?.startedAt;
 			const completedAt = storyState?.completedAt ?? new Date().toISOString();
 			const wallClockSeconds = startedAt ? Math.round((new Date(completedAt).getTime() - new Date(startedAt).getTime()) / 1e3) : 0;
+			const wallClockMs = startedAt ? new Date(completedAt).getTime() - new Date(startedAt).getTime() : 0;
 			const tokenAgg = aggregateTokenUsageForStory(db, config.pipelineRunId, storyKey);
+			const phaseDurationsJson = buildPhaseDurationsJson(storyKey);
 			writeStoryMetrics(db, {
 				run_id: config.pipelineRunId,
 				story_key: storyKey,
 				result,
-				phase_durations_json: buildPhaseDurationsJson(storyKey),
+				phase_durations_json: phaseDurationsJson,
 				started_at: startedAt,
 				completed_at: completedAt,
 				wall_clock_seconds: wallClockSeconds,
@@ -6792,13 +7223,41 @@ function createImplementationOrchestrator(deps) {
 					rationale: `Story ${storyKey} completed with result=${result} in ${wallClockSeconds}s. Tokens: ${tokenAgg.input}+${tokenAgg.output}. Review cycles: ${reviewCycles}.`
 				});
 			} catch (decisionErr) {
-				logger$20.warn({
+				logger$22.warn({
 					err: decisionErr,
 					storyKey
 				}, "Failed to write story-metrics decision (best-effort)");
 			}
+			try {
+				const phaseBreakdown = {};
+				const starts = _phaseStartMs.get(storyKey);
+				const ends = _phaseEndMs.get(storyKey);
+				if (starts) {
+					const nowMs = Date.now();
+					for (const [phase, startMs] of starts) {
+						const endMs = ends?.get(phase);
+						phaseBreakdown[phase] = endMs !== void 0 ? endMs - startMs : nowMs - startMs;
+					}
+				}
+				eventBus.emit("story:metrics", {
+					storyKey,
+					wallClockMs,
+					phaseBreakdown,
+					tokens: {
+						input: tokenAgg.input,
+						output: tokenAgg.output
+					},
+					reviewCycles,
+					dispatches: _storyDispatches.get(storyKey) ?? 0
+				});
+			} catch (emitErr) {
+				logger$22.warn({
+					err: emitErr,
+					storyKey
+				}, "Failed to emit story:metrics event (best-effort)");
+			}
 		} catch (err) {
-			logger$20.warn({
+			logger$22.warn({
 				err,
 				storyKey
 			}, "Failed to write story metrics (best-effort)");
@@ -6827,7 +7286,7 @@ function createImplementationOrchestrator(deps) {
 				rationale: `Story ${storyKey} ${outcome} after ${reviewCycles} review cycle(s).`
 			});
 		} catch (err) {
-			logger$20.warn({
+			logger$22.warn({
 				err,
 				storyKey
 			}, "Failed to write story-outcome decision (best-effort)");
@@ -6853,7 +7312,7 @@ function createImplementationOrchestrator(deps) {
 				rationale: `Escalation diagnosis for ${payload.storyKey}: ${diagnosis.recommendedAction} — ${diagnosis.rationale}`
 			});
 		} catch (err) {
-			logger$20.warn({
+			logger$22.warn({
 				err,
 				storyKey: payload.storyKey
 			}, "Failed to persist escalation diagnosis (best-effort)");
@@ -6903,7 +7362,7 @@ function createImplementationOrchestrator(deps) {
 				token_usage_json: serialized
 			});
 		} catch (err) {
-			logger$20.warn("Failed to persist orchestrator state", { err });
+			logger$22.warn("Failed to persist orchestrator state", { err });
 		}
 	}
 	function recordProgress() {
@@ -6950,7 +7409,7 @@ function createImplementationOrchestrator(deps) {
 				}
 				if (childActive) {
 					_lastProgressTs = Date.now();
-					logger$20.debug({
+					logger$22.debug({
 						storyKey: key,
 						phase: s.phase,
 						childPids
@@ -6959,7 +7418,7 @@ function createImplementationOrchestrator(deps) {
 				}
 				_stalledStories.add(key);
 				_storiesWithStall.add(key);
-				logger$20.warn({
+				logger$22.warn({
 					storyKey: key,
 					phase: s.phase,
 					elapsedMs: elapsed,
@@ -7004,7 +7463,7 @@ function createImplementationOrchestrator(deps) {
 		for (let attempt = 0; attempt < MEMORY_PRESSURE_BACKOFF_MS.length; attempt++) {
 			const memState = dispatcher.getMemoryState();
 			if (!memState.isPressured) return true;
-			logger$20.warn({
+			logger$22.warn({
 				storyKey,
 				freeMB: memState.freeMB,
 				thresholdMB: memState.thresholdMB,
@@ -7024,11 +7483,11 @@ function createImplementationOrchestrator(deps) {
 	* exhausted retries the story is ESCALATED.
 	*/
 	async function processStory(storyKey) {
-		logger$20.info("Processing story", { storyKey });
+		logger$22.info("Processing story", { storyKey });
 		{
 			const memoryOk = await checkMemoryPressure(storyKey);
 			if (!memoryOk) {
-				logger$20.warn({ storyKey }, "Memory pressure exhausted — escalating story without dispatch");
+				logger$22.warn({ storyKey }, "Memory pressure exhausted — escalating story without dispatch");
 				_stories.set(storyKey, {
 					phase: "ESCALATED",
 					reviewCycles: 0,
@@ -7062,14 +7521,14 @@ function createImplementationOrchestrator(deps) {
 			if (match) {
 				const candidatePath = join$1(artifactsDir, match);
 				const validation = await isValidStoryFile(candidatePath);
-				if (!validation.valid) logger$20.warn({
+				if (!validation.valid) logger$22.warn({
 					storyKey,
 					storyFilePath: candidatePath,
 					reason: validation.reason
 				}, `Existing story file for ${storyKey} is invalid (${validation.reason}) — re-creating`);
 				else {
 					storyFilePath = candidatePath;
-					logger$20.info({
+					logger$22.info({
 						storyKey,
 						storyFilePath
 					}, "Found existing story file — skipping create-story");
@@ -7094,7 +7553,8 @@ function createImplementationOrchestrator(deps) {
 				pack,
 				contextCompiler,
 				dispatcher,
-				projectRoot
+				projectRoot,
+				tokenCeilings
 			}, {
 				epicId: storyKey.split("-")[0] ?? storyKey,
 				storyKey,
@@ -7172,17 +7632,18 @@ function createImplementationOrchestrator(deps) {
 				pack,
 				contextCompiler,
 				dispatcher,
-				projectRoot
+				projectRoot,
+				tokenCeilings
 			}, {
 				storyKey,
 				storyFilePath: storyFilePath ?? "",
 				pipelineRunId: config.pipelineRunId
 			});
 			testPlanPhaseResult = testPlanResult.result;
-			if (testPlanResult.result === "success") logger$20.info({ storyKey }, "Test plan generated successfully");
-			else logger$20.warn({ storyKey }, "Test planning returned failed result — proceeding to dev-story without test plan");
+			if (testPlanResult.result === "success") logger$22.info({ storyKey }, "Test plan generated successfully");
+			else logger$22.warn({ storyKey }, "Test planning returned failed result — proceeding to dev-story without test plan");
 		} catch (err) {
-			logger$20.warn({
+			logger$22.warn({
 				storyKey,
 				err
 			}, "Test planning failed — proceeding to dev-story without test plan");
@@ -7206,7 +7667,7 @@ function createImplementationOrchestrator(deps) {
 			try {
 				storyContentForAnalysis = await readFile$1(storyFilePath ?? "", "utf-8");
 			} catch (err) {
-				logger$20.error({
+				logger$22.error({
 					storyKey,
 					storyFilePath,
 					error: err instanceof Error ? err.message : String(err)
@@ -7214,7 +7675,7 @@ function createImplementationOrchestrator(deps) {
 			}
 			const analysis = analyzeStoryComplexity(storyContentForAnalysis);
 			const batches = planTaskBatches(analysis);
-			logger$20.info({
+			logger$22.info({
 				storyKey,
 				estimatedScope: analysis.estimatedScope,
 				batchCount: batches.length,
@@ -7232,7 +7693,7 @@ function createImplementationOrchestrator(deps) {
 					if (_state !== "RUNNING") break;
 					const taskScope = batch.taskIds.map((id, i) => `T${id}: ${batch.taskTitles[i] ?? ""}`).join("\n");
 					const priorFiles = allFilesModified.size > 0 ? Array.from(allFilesModified) : void 0;
-					logger$20.info({
+					logger$22.info({
 						storyKey,
 						batchIndex: batch.batchIndex,
 						taskCount: batch.taskIds.length
@@ -7246,7 +7707,8 @@ function createImplementationOrchestrator(deps) {
 							pack,
 							contextCompiler,
 							dispatcher,
-							projectRoot
+							projectRoot,
+							tokenCeilings
 						}, {
 							storyKey,
 							storyFilePath: storyFilePath ?? "",
@@ -7256,7 +7718,7 @@ function createImplementationOrchestrator(deps) {
 						});
 					} catch (batchErr) {
 						const errMsg = batchErr instanceof Error ? batchErr.message : String(batchErr);
-						logger$20.warn({
+						logger$22.warn({
 							storyKey,
 							batchIndex: batch.batchIndex,
 							error: errMsg
@@ -7276,7 +7738,7 @@ function createImplementationOrchestrator(deps) {
 						filesModified: batchFilesModified,
 						result: batchResult.result === "success" ? "success" : "failed"
 					};
-					logger$20.info(batchMetrics, "Batch dev-story metrics");
+					logger$22.info(batchMetrics, "Batch dev-story metrics");
 					for (const f of batchFilesModified) allFilesModified.add(f);
 					if (batchFilesModified.length > 0) batchFileGroups.push({
 						batchIndex: batch.batchIndex,
@@ -7298,13 +7760,13 @@ function createImplementationOrchestrator(deps) {
 							})
 						});
 					} catch (tokenErr) {
-						logger$20.warn({
+						logger$22.warn({
 							storyKey,
 							batchIndex: batch.batchIndex,
 							err: tokenErr
 						}, "Failed to record batch token usage");
 					}
-					if (batchResult.result === "failed") logger$20.warn({
+					if (batchResult.result === "failed") logger$22.warn({
 						storyKey,
 						batchIndex: batch.batchIndex,
 						error: batchResult.error
@@ -7325,7 +7787,8 @@ function createImplementationOrchestrator(deps) {
 					pack,
 					contextCompiler,
 					dispatcher,
-					projectRoot
+					projectRoot,
+					tokenCeilings
 				}, {
 					storyKey,
 					storyFilePath: storyFilePath ?? "",
@@ -7339,7 +7802,7 @@ function createImplementationOrchestrator(deps) {
 				});
 				persistState();
 				if (devResult.result === "success") devStoryWasSuccess = true;
-				else logger$20.warn("Dev-story reported failure, proceeding to code review", {
+				else logger$22.warn("Dev-story reported failure, proceeding to code review", {
 					storyKey,
 					error: devResult.error,
 					filesModified: devFilesModified.length
@@ -7363,10 +7826,11 @@ function createImplementationOrchestrator(deps) {
 			persistState();
 			return;
 		}
+		let gitDiffFiles;
 		if (devStoryWasSuccess) {
-			const changedFiles = checkGitDiffFiles(projectRoot ?? process.cwd());
-			if (changedFiles.length === 0) {
-				logger$20.warn({ storyKey }, "Zero-diff detected after COMPLETE dev-story — no file changes in git working tree");
+			gitDiffFiles = checkGitDiffFiles(projectRoot ?? process.cwd());
+			if (gitDiffFiles.length === 0) {
+				logger$22.warn({ storyKey }, "Zero-diff detected after COMPLETE dev-story — no file changes in git working tree");
 				eventBus.emit("orchestrator:zero-diff-escalation", {
 					storyKey,
 					reason: "zero-diff-on-complete"
@@ -7397,7 +7861,7 @@ function createImplementationOrchestrator(deps) {
 			});
 			if (buildVerifyResult.status === "passed") {
 				eventBus.emit("story:build-verification-passed", { storyKey });
-				logger$20.info({ storyKey }, "Build verification passed");
+				logger$22.info({ storyKey }, "Build verification passed");
 			} else if (buildVerifyResult.status === "failed" || buildVerifyResult.status === "timeout") {
 				const truncatedOutput = (buildVerifyResult.output ?? "").slice(0, 2e3);
 				const reason = buildVerifyResult.reason ?? "build-verification-failed";
@@ -7406,7 +7870,7 @@ function createImplementationOrchestrator(deps) {
 					exitCode: buildVerifyResult.exitCode ?? 1,
 					output: truncatedOutput
 				});
-				logger$20.warn({
+				logger$22.warn({
 					storyKey,
 					reason,
 					exitCode: buildVerifyResult.exitCode
@@ -7427,6 +7891,28 @@ function createImplementationOrchestrator(deps) {
 				return;
 			}
 		}
+		try {
+			const filesModified = gitDiffFiles ?? devFilesModified;
+			if (filesModified.length > 0) {
+				const icResult = detectInterfaceChanges({
+					filesModified,
+					projectRoot: projectRoot ?? process.cwd(),
+					storyKey
+				});
+				if (icResult.potentiallyAffectedTests.length > 0) {
+					logger$22.warn({
+						storyKey,
+						modifiedInterfaces: icResult.modifiedInterfaces,
+						potentiallyAffectedTests: icResult.potentiallyAffectedTests
+					}, "Interface change warning: modified exports may affect cross-module test mocks");
+					eventBus.emit("story:interface-change-warning", {
+						storyKey,
+						modifiedInterfaces: icResult.modifiedInterfaces,
+						potentiallyAffectedTests: icResult.potentiallyAffectedTests
+					});
+				}
+			}
+		} catch {}
 		let reviewCycles = 0;
 		let keepReviewing = true;
 		let timeoutRetried = false;
@@ -7459,7 +7945,7 @@ function createImplementationOrchestrator(deps) {
 						"NEEDS_MAJOR_REWORK": 2
 					};
 					for (const group of batchFileGroups) {
-						logger$20.info({
+						logger$22.info({
 							storyKey,
 							batchIndex: group.batchIndex,
 							fileCount: group.files.length
@@ -7470,7 +7956,8 @@ function createImplementationOrchestrator(deps) {
 							pack,
 							contextCompiler,
 							dispatcher,
-							projectRoot
+							projectRoot,
+							tokenCeilings
 						}, {
 							storyKey,
 							storyFilePath: storyFilePath ?? "",
@@ -7496,7 +7983,7 @@ function createImplementationOrchestrator(deps) {
 						rawOutput: lastRawOutput,
 						tokenUsage: aggregateTokens
 					};
-					logger$20.info({
+					logger$22.info({
 						storyKey,
 						batchCount: batchFileGroups.length,
 						verdict: worstVerdict,
@@ -7509,7 +7996,8 @@ function createImplementationOrchestrator(deps) {
 						pack,
 						contextCompiler,
 						dispatcher,
-						projectRoot
+						projectRoot,
+						tokenCeilings
 					}, {
 						storyKey,
 						storyFilePath: storyFilePath ?? "",
@@ -7522,7 +8010,7 @@ function createImplementationOrchestrator(deps) {
 				const isPhantomReview = reviewResult.dispatchFailed === true || reviewResult.verdict !== "SHIP_IT" && (reviewResult.issue_list === void 0 || reviewResult.issue_list.length === 0) && reviewResult.error !== void 0;
 				if (isPhantomReview && !timeoutRetried) {
 					timeoutRetried = true;
-					logger$20.warn({
+					logger$22.warn({
 						storyKey,
 						reviewCycles,
 						error: reviewResult.error
@@ -7532,7 +8020,7 @@ function createImplementationOrchestrator(deps) {
 				verdict = reviewResult.verdict;
 				issueList = reviewResult.issue_list ?? [];
 				if (verdict === "NEEDS_MAJOR_REWORK" && reviewCycles > 0 && previousIssueList.length > 0 && issueList.length < previousIssueList.length) {
-					logger$20.info({
+					logger$22.info({
 						storyKey,
 						originalVerdict: verdict,
 						issuesBefore: previousIssueList.length,
@@ -7568,7 +8056,7 @@ function createImplementationOrchestrator(deps) {
 					if (_decomposition !== void 0) parts.push(`decomposed: ${_decomposition.batchCount} batches`);
 					parts.push(`${fileCount} files`);
 					parts.push(`${totalTokensK} tokens`);
-					logger$20.info({
+					logger$22.info({
 						storyKey,
 						verdict,
 						agentVerdict: reviewResult.agentVerdict
@@ -7611,7 +8099,8 @@ function createImplementationOrchestrator(deps) {
 						pack,
 						contextCompiler,
 						dispatcher,
-						projectRoot
+						projectRoot,
+						tokenCeilings
 					}, {
 						storyKey,
 						storyFilePath: storyFilePath ?? "",
@@ -7619,7 +8108,7 @@ function createImplementationOrchestrator(deps) {
 						filesModified: devFilesModified,
 						workingDirectory: projectRoot
 					});
-					logger$20.debug({
+					logger$22.debug({
 						storyKey,
 						expansion_priority: expansionResult.expansion_priority,
 						coverage_gaps: expansionResult.coverage_gaps.length
@@ -7632,7 +8121,7 @@ function createImplementationOrchestrator(deps) {
 						value: JSON.stringify(expansionResult)
 					});
 				} catch (expansionErr) {
-					logger$20.warn({
+					logger$22.warn({
 						storyKey,
 						error: expansionErr instanceof Error ? expansionErr.message : String(expansionErr)
 					}, "Test expansion failed — story verdict unchanged");
@@ -7659,7 +8148,7 @@ function createImplementationOrchestrator(deps) {
 					persistState();
 					return;
 				}
-				logger$20.info({
+				logger$22.info({
 					storyKey,
 					reviewCycles: finalReviewCycles,
 					issueCount: issueList.length
@@ -7709,7 +8198,7 @@ function createImplementationOrchestrator(deps) {
 						fixPrompt = assembled.prompt;
 					} catch {
 						fixPrompt = `Fix story ${storyKey}: verdict=${verdict}, minor fixes needed`;
-						logger$20.warn("Failed to assemble auto-approve fix prompt, using fallback", { storyKey });
+						logger$22.warn("Failed to assemble auto-approve fix prompt, using fallback", { storyKey });
 					}
 					const handle = dispatcher.dispatch({
 						prompt: fixPrompt,
@@ -7726,9 +8215,9 @@ function createImplementationOrchestrator(deps) {
 							output: fixResult.tokenEstimate.output
 						} : void 0 }
 					});
-					if (fixResult.status === "timeout") logger$20.warn("Auto-approve fix timed out — approving anyway (issues were minor)", { storyKey });
+					if (fixResult.status === "timeout") logger$22.warn("Auto-approve fix timed out — approving anyway (issues were minor)", { storyKey });
 				} catch (err) {
-					logger$20.warn("Auto-approve fix dispatch failed — approving anyway (issues were minor)", {
+					logger$22.warn("Auto-approve fix dispatch failed — approving anyway (issues were minor)", {
 						storyKey,
 						err
 					});
@@ -7758,9 +8247,15 @@ function createImplementationOrchestrator(deps) {
 				let fixPrompt;
 				const isMajorRework = taskType === "major-rework";
 				const templateName = isMajorRework ? "rework-story" : "fix-story";
+				let fixMaxTurns;
 				try {
 					const fixTemplate = await pack.getPrompt(templateName);
 					const storyContent = await readFile$1(storyFilePath ?? "", "utf-8");
+					if (isMajorRework) {
+						const complexity = computeStoryComplexity(storyContent);
+						fixMaxTurns = resolveFixStoryMaxTurns(complexity.complexityScore);
+						logComplexityResult(storyKey, complexity, fixMaxTurns);
+					}
 					let reviewFeedback;
 					if (issueList.length === 0) reviewFeedback = isMajorRework ? [
 						`Verdict: ${verdict}`,
@@ -7831,7 +8326,7 @@ function createImplementationOrchestrator(deps) {
 					fixPrompt = assembled.prompt;
 				} catch {
 					fixPrompt = `Fix story ${storyKey}: verdict=${verdict}, taskType=${taskType}`;
-					logger$20.warn("Failed to assemble fix prompt, using fallback", {
+					logger$22.warn("Failed to assemble fix prompt, using fallback", {
 						storyKey,
 						taskType
 					});
@@ -7843,6 +8338,7 @@ function createImplementationOrchestrator(deps) {
 					taskType,
 					...fixModel !== void 0 ? { model: fixModel } : {},
 					outputSchema: DevStoryResultSchema,
+					...fixMaxTurns !== void 0 ? { maxTurns: fixMaxTurns } : {},
 					...projectRoot !== void 0 ? { workingDirectory: projectRoot } : {}
 				}) : dispatcher.dispatch({
 					prompt: fixPrompt,
@@ -7861,7 +8357,7 @@ function createImplementationOrchestrator(deps) {
 					} : void 0 }
 				});
 				if (fixResult.status === "timeout") {
-					logger$20.warn("Fix dispatch timed out — escalating story", {
+					logger$22.warn("Fix dispatch timed out — escalating story", {
 						storyKey,
 						taskType
 					});
@@ -7883,7 +8379,7 @@ function createImplementationOrchestrator(deps) {
 				}
 				if (fixResult.status === "failed") {
 					if (isMajorRework) {
-						logger$20.warn("Major rework dispatch failed — escalating story", {
+						logger$22.warn("Major rework dispatch failed — escalating story", {
 							storyKey,
 							exitCode: fixResult.exitCode
 						});
@@ -7903,14 +8399,14 @@ function createImplementationOrchestrator(deps) {
 						persistState();
 						return;
 					}
-					logger$20.warn("Fix dispatch failed", {
+					logger$22.warn("Fix dispatch failed", {
 						storyKey,
 						taskType,
 						exitCode: fixResult.exitCode
 					});
 				}
 			} catch (err) {
-				logger$20.warn("Fix dispatch failed, continuing to next review", {
+				logger$22.warn("Fix dispatch failed, continuing to next review", {
 					storyKey,
 					taskType,
 					err
@@ -7973,11 +8469,11 @@ function createImplementationOrchestrator(deps) {
 	}
 	async function run(storyKeys) {
 		if (_state === "RUNNING" || _state === "PAUSED") {
-			logger$20.warn("run() called while orchestrator is already running or paused — ignoring", { state: _state });
+			logger$22.warn("run() called while orchestrator is already running or paused — ignoring", { state: _state });
 			return getStatus();
 		}
 		if (_state === "COMPLETE") {
-			logger$20.warn("run() called on a COMPLETE orchestrator — ignoring", { state: _state });
+			logger$22.warn("run() called on a COMPLETE orchestrator — ignoring", { state: _state });
 			return getStatus();
 		}
 		_state = "RUNNING";
@@ -7995,13 +8491,13 @@ function createImplementationOrchestrator(deps) {
 		if (config.enableHeartbeat) startHeartbeat();
 		if (projectRoot !== void 0) {
 			const seedResult = seedMethodologyContext(db, projectRoot);
-			if (seedResult.decisionsCreated > 0) logger$20.info({
+			if (seedResult.decisionsCreated > 0) logger$22.info({
 				decisionsCreated: seedResult.decisionsCreated,
 				skippedCategories: seedResult.skippedCategories
 			}, "Methodology context seeded from planning artifacts");
 		}
 		const groups = detectConflictGroups(storyKeys, { moduleMap: pack.manifest.conflictGroups });
-		logger$20.info("Orchestrator starting", {
+		logger$22.info("Orchestrator starting", {
 			storyCount: storyKeys.length,
 			groupCount: groups.length,
 			maxConcurrency: config.maxConcurrency
@@ -8013,7 +8509,7 @@ function createImplementationOrchestrator(deps) {
 			_state = "FAILED";
 			_completedAt = new Date().toISOString();
 			persistState();
-			logger$20.error("Orchestrator failed with unhandled error", { err });
+			logger$22.error("Orchestrator failed with unhandled error", { err });
 			return getStatus();
 		}
 		stopHeartbeat();
@@ -8040,7 +8536,7 @@ function createImplementationOrchestrator(deps) {
 		_pauseGate = createPauseGate();
 		_state = "PAUSED";
 		eventBus.emit("orchestrator:paused", {});
-		logger$20.info("Orchestrator paused");
+		logger$22.info("Orchestrator paused");
 	}
 	function resume() {
 		if (_state !== "PAUSED") return;
@@ -8051,7 +8547,7 @@ function createImplementationOrchestrator(deps) {
 		}
 		_state = "RUNNING";
 		eventBus.emit("orchestrator:resumed", {});
-		logger$20.info("Orchestrator resumed");
+		logger$22.info("Orchestrator resumed");
 	}
 	return {
 		run,
@@ -12530,6 +13026,27 @@ async function runRunAction(options) {
 					output: payload.output
 				});
 			});
+			eventBus.on("story:interface-change-warning", (payload) => {
+				ndjsonEmitter.emit({
+					type: "story:interface-change-warning",
+					ts: new Date().toISOString(),
+					storyKey: payload.storyKey,
+					modifiedInterfaces: payload.modifiedInterfaces,
+					potentiallyAffectedTests: payload.potentiallyAffectedTests
+				});
+			});
+			eventBus.on("story:metrics", (payload) => {
+				ndjsonEmitter.emit({
+					type: "story:metrics",
+					ts: new Date().toISOString(),
+					storyKey: payload.storyKey,
+					wallClockMs: payload.wallClockMs,
+					phaseBreakdown: payload.phaseBreakdown,
+					tokens: payload.tokens,
+					reviewCycles: payload.reviewCycles,
+					dispatches: payload.dispatches
+				});
+			});
 		}
 		const orchestrator = createImplementationOrchestrator({
 			db,
@@ -12983,5 +13500,5 @@ function registerRunCommand(program, _version = "0.0.0", projectRoot = process.c
 }
 
 //#endregion
-export { DatabaseWrapper, SUBSTRATE_OWNED_SETTINGS_KEYS, VALID_PHASES, buildPipelineStatusOutput, createContextCompiler, createDispatcher, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStopAfterGate, findPackageRoot, formatOutput, formatPhaseCompletionSummary, formatPipelineStatusHuman, formatPipelineSummary, formatTokenTelemetry, getAllDescendantPids, getAutoHealthData, getSubstrateDefaultSettings, registerHealthCommand, registerRunCommand, resolveBmadMethodSrcPath, resolveBmadMethodVersion, resolveMainRepoRoot, runAnalysisPhase, runMigrations, runPlanningPhase, runRunAction, runSolutioningPhase, validateStopAfterFromConflict };
-//# sourceMappingURL=run-CEtHPG4I.js.map
+export { DatabaseWrapper, SUBSTRATE_OWNED_SETTINGS_KEYS, VALID_PHASES, buildPipelineStatusOutput, createContextCompiler, createDispatcher, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStopAfterGate, findPackageRoot, formatOutput, formatPhaseCompletionSummary, formatPipelineStatusHuman, formatPipelineSummary, formatTokenTelemetry, getAllDescendantPids, getAutoHealthData, getSubstrateDefaultSettings, parseDbTimestampAsUtc, registerHealthCommand, registerRunCommand, resolveBmadMethodSrcPath, resolveBmadMethodVersion, resolveMainRepoRoot, runAnalysisPhase, runMigrations, runPlanningPhase, runRunAction, runSolutioningPhase, validateStopAfterFromConflict };
+//# sourceMappingURL=run-BCyrbL3w.js.map