substrate-ai 0.2.27 → 0.2.29

package/dist/{run-DG5j6vJI.js → run-IeDyGCak.js}

@@ -539,7 +539,7 @@ const migration010RunMetrics = {
 
 //#endregion
 //#region src/persistence/migrations/index.ts
-const logger$20 = 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$20.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$20.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$20.info({
+		logger$21.info({
 			version: migration.version,
 			name: migration.name
 		}, "Applying migration");
@@ -587,14 +587,14 @@ function runMigrations(db) {
 			});
 			applyMigration();
 		}
-		logger$20.info({ version: migration.version }, "Migration applied successfully");
+		logger$21.info({ version: migration.version }, "Migration applied successfully");
 	}
-	logger$20.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$19 = 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$19.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$19.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$19.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$19.info({ path: this._path }, "SQLite database closed");
+		logger$20.info({ path: this._path }, "SQLite database closed");
 	}
 	/**
 	* Return the raw BetterSqlite3 instance.
@@ -2675,7 +2675,7 @@ function truncateToTokens(text, maxTokens) {
 
 //#endregion
 //#region src/modules/context-compiler/context-compiler-impl.ts
-const logger$18 = 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.
@@ -2767,7 +2767,7 @@ var ContextCompilerImpl = class {
 				includedParts.push(truncated);
 				remainingBudget -= truncatedTokens;
 				anyTruncated = true;
-				logger$18.warn({
+				logger$19.warn({
 					section: section.name,
 					originalTokens: tokens,
 					budgetTokens: truncatedTokens
@@ -2781,7 +2781,7 @@ var ContextCompilerImpl = class {
 				});
 			} else {
 				anyTruncated = true;
-				logger$18.warn({
+				logger$19.warn({
 					section: section.name,
 					tokens
 				}, "Context compiler: omitted \"important\" section — no budget remaining");
@@ -2808,7 +2808,7 @@ var ContextCompilerImpl = class {
 				} else {
 					if (tokens > 0) {
 						anyTruncated = true;
-						logger$18.warn({
+						logger$19.warn({
 							section: section.name,
 							tokens,
 							budgetFractionRemaining: budgetFractionRemaining.toFixed(2)
@@ -3093,7 +3093,7 @@ function parseYamlResult(yamlText, schema) {
 
 //#endregion
 //#region src/modules/agent-dispatch/dispatcher-impl.ts
-const logger$17 = 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;
@@ -3138,7 +3138,7 @@ function getAvailableMemory() {
 			}).trim(), 10);
 			_lastKnownPressureLevel = pressureLevel;
 			if (pressureLevel >= 4) {
-				logger$17.warn({ pressureLevel }, "macOS kernel reports critical memory pressure");
+				logger$18.warn({ pressureLevel }, "macOS kernel reports critical memory pressure");
 				return 0;
 			}
 		} catch {}
@@ -3153,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$17.warn({
+				logger$18.warn({
 					pressureLevel,
 					availableBeforeDiscount: available
 				}, "macOS kernel reports memory pressure — discounting estimate");
@@ -3233,7 +3233,7 @@ var DispatcherImpl = class {
 					resolve: typedResolve,
 					reject
 				});
-				logger$17.debug({
+				logger$18.debug({
 					id,
 					queueLength: this._queue.length
 				}, "Dispatch queued");
@@ -3264,7 +3264,7 @@ var DispatcherImpl = class {
 	async shutdown() {
 		this._shuttingDown = true;
 		this._stopMemoryPressureTimer();
-		logger$17.info({
+		logger$18.info({
 			running: this._running.size,
 			queued: this._queue.length
 		}, "Dispatcher shutting down");
@@ -3297,13 +3297,13 @@ var DispatcherImpl = class {
 				}
 			}, 50);
 		});
-		logger$17.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$17.warn({
+			logger$18.warn({
 				id,
 				agent
 			}, "No adapter found for agent");
@@ -3349,7 +3349,7 @@ var DispatcherImpl = class {
 		});
 		const startedAt = Date.now();
 		proc.on("error", (err) => {
-			logger$17.error({
+			logger$18.error({
 				id,
 				binary: cmd.binary,
 				error: err.message
@@ -3357,7 +3357,7 @@ var DispatcherImpl = class {
 		});
 		if (proc.stdin !== null) {
 			proc.stdin.on("error", (err) => {
-				if (err.code !== "EPIPE") logger$17.warn({
+				if (err.code !== "EPIPE") logger$18.warn({
 					id,
 					error: err.message
 				}, "stdin write error");
@@ -3399,7 +3399,7 @@ var DispatcherImpl = class {
 			agent,
 			taskType
 		});
-		logger$17.debug({
+		logger$18.debug({
 			id,
 			agent,
 			taskType,
@@ -3416,7 +3416,7 @@ var DispatcherImpl = class {
 				dispatchId: id,
 				timeoutMs
 			});
-			logger$17.warn({
+			logger$18.warn({
 				id,
 				agent,
 				taskType,
@@ -3470,7 +3470,7 @@ var DispatcherImpl = class {
 					exitCode: code,
 					output: stdout
 				});
-				logger$17.debug({
+				logger$18.debug({
 					id,
 					agent,
 					taskType,
@@ -3496,7 +3496,7 @@ var DispatcherImpl = class {
 					error: stderr || `Process exited with code ${String(code)}`,
 					exitCode: code
 				});
-				logger$17.debug({
+				logger$18.debug({
 					id,
 					agent,
 					taskType,
@@ -3555,7 +3555,7 @@ var DispatcherImpl = class {
 		const next = this._queue.shift();
 		if (next === void 0) return;
 		next.handle.status = "running";
-		logger$17.debug({
+		logger$18.debug({
 			id: next.id,
 			queueLength: this._queue.length
 		}, "Dequeued dispatch");
@@ -3568,7 +3568,7 @@ var DispatcherImpl = class {
 	_isMemoryPressured() {
 		const free = getAvailableMemory();
 		if (free < MIN_FREE_MEMORY_BYTES) {
-			logger$17.warn({
+			logger$18.warn({
 				freeMB: Math.round(free / 1024 / 1024),
 				thresholdMB: Math.round(MIN_FREE_MEMORY_BYTES / 1024 / 1024),
 				pressureLevel: _lastKnownPressureLevel
@@ -3608,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;
 /**
@@ -3624,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 {
@@ -3817,7 +3874,7 @@ function pickRecommendation(distribution, profile, totalIssues, reviewCycles, la
 
 //#endregion
 //#region src/modules/compiled-workflows/prompt-assembler.ts
-const logger$16 = createLogger("compiled-workflows:prompt-assembler");
+const logger$17 = createLogger("compiled-workflows:prompt-assembler");
 /**
 * Assemble a final prompt from a template and sections map.
 *
@@ -3842,7 +3899,7 @@ function assemblePrompt(template, sections, tokenCeiling = 2200) {
 		tokenCount,
 		truncated: false
 	};
-	logger$16.warn({
+	logger$17.warn({
 		tokenCount,
 		ceiling: tokenCeiling
 	}, "Prompt exceeds token ceiling — truncating optional sections");
@@ -3858,10 +3915,10 @@ function assemblePrompt(template, sections, tokenCeiling = 2200) {
 			const targetSectionTokens = Math.max(0, currentSectionTokens - overBy);
 			if (targetSectionTokens === 0) {
 				contentMap[section.name] = "";
-				logger$16.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$16.warn({
+				logger$17.warn({
 					sectionName: section.name,
 					targetSectionTokens
 				}, "Section truncated to fit token budget");
@@ -3872,7 +3929,7 @@ function assemblePrompt(template, sections, tokenCeiling = 2200) {
 		}
 		if (tokenCount <= tokenCeiling) break;
 	}
-	if (tokenCount > tokenCeiling) logger$16.warn({
+	if (tokenCount > tokenCeiling) logger$17.warn({
 		tokenCount,
 		ceiling: tokenCeiling
 	}, "Required sections alone exceed token ceiling — returning over-budget prompt");
@@ -3959,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
@@ -3980,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
@@ -3989,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([
@@ -4003,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.
 *
@@ -4087,12 +4182,46 @@ const TestExpansionResultSchema = z.object({
 });
 
 //#endregion
-//#region src/modules/compiled-workflows/create-story.ts
-const logger$15 = 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.
 *
@@ -4112,17 +4241,23 @@ const TOKEN_CEILING$4 = 3e3;
 */
 async function runCreateStory(deps, params) {
 	const { epicId, storyKey, pipelineRunId } = params;
-	logger$15.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$15.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}`,
@@ -4163,11 +4298,11 @@ async function runCreateStory(deps, params) {
 			content: storyTemplateContent,
 			priority: "important"
 		}
-	], TOKEN_CEILING$4);
-	logger$15.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,
@@ -4181,7 +4316,7 @@ async function runCreateStory(deps, params) {
 		dispatchResult = await handle.result;
 	} catch (err) {
 		const error = err instanceof Error ? err.message : String(err);
-		logger$15.error({
+		logger$16.error({
 			epicId,
 			storyKey,
 			error
@@ -4202,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$15.warn({
+		logger$16.warn({
 			epicId,
 			storyKey,
 			exitCode: dispatchResult.exitCode
@@ -4214,7 +4349,7 @@ async function runCreateStory(deps, params) {
 		};
 	}
 	if (dispatchResult.status === "timeout") {
-		logger$15.warn({
+		logger$16.warn({
 			epicId,
 			storyKey
 		}, "Create-story dispatch timed out");
@@ -4227,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$15.warn({
+		logger$16.warn({
 			epicId,
 			storyKey,
 			details,
@@ -4243,7 +4378,7 @@ async function runCreateStory(deps, params) {
 	const parseResult = CreateStoryResultSchema.safeParse(dispatchResult.parsed);
 	if (!parseResult.success) {
 		const details = parseResult.error.message;
-		logger$15.warn({
+		logger$16.warn({
 			epicId,
 			storyKey,
 			details
@@ -4256,7 +4391,7 @@ async function runCreateStory(deps, params) {
 		};
 	}
 	const parsed = parseResult.data;
-	logger$15.info({
+	logger$16.info({
 		epicId,
 		storyKey,
 		storyFile: parsed.story_file,
@@ -4278,7 +4413,7 @@ function getImplementationDecisions(deps) {
 	try {
 		return getDecisionsByPhase(deps.db, "implementation");
 	} catch (err) {
-		logger$15.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 [];
 	}
 }
@@ -4321,13 +4456,13 @@ function getEpicShard(decisions, epicId, projectRoot, storyKey) {
 			if (storyKey) {
 				const storySection = extractStorySection(shardContent, storyKey);
 				if (storySection) {
-					logger$15.debug({
+					logger$16.debug({
 						epicId,
 						storyKey
 					}, "Extracted per-story section from epic shard");
 					return storySection;
 				}
-				logger$15.debug({
+				logger$16.debug({
 					epicId,
 					storyKey
 				}, "No matching story section found — using full epic shard");
@@ -4337,11 +4472,11 @@ function getEpicShard(decisions, epicId, projectRoot, storyKey) {
 		if (projectRoot) {
 			const fallback = readEpicShardFromFile(projectRoot, epicId);
 			if (fallback) {
-				logger$15.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$15.debug({
+						logger$16.debug({
 							epicId,
 							storyKey
 						}, "Extracted per-story section from file-based epic shard");
@@ -4353,7 +4488,7 @@ function getEpicShard(decisions, epicId, projectRoot, storyKey) {
 		}
 		return "";
 	} catch (err) {
-		logger$15.warn({
+		logger$16.warn({
 			epicId,
 			error: err instanceof Error ? err.message : String(err)
 		}, "Failed to retrieve epic shard");
@@ -4370,7 +4505,7 @@ function getPrevDevNotes(decisions, epicId) {
 		if (devNotes.length === 0) return "";
 		return devNotes[devNotes.length - 1].value;
 	} catch (err) {
-		logger$15.warn({
+		logger$16.warn({
 			epicId,
 			error: err instanceof Error ? err.message : String(err)
 		}, "Failed to retrieve prev dev notes");
@@ -4390,13 +4525,13 @@ function getArchConstraints$2(deps) {
 		if (deps.projectRoot) {
 			const fallback = readArchConstraintsFromFile(deps.projectRoot);
 			if (fallback) {
-				logger$15.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$15.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 "";
 	}
 }
@@ -4416,7 +4551,7 @@ function readEpicShardFromFile(projectRoot, epicId) {
 		const match = pattern.exec(content);
 		return match ? match[0].trim() : "";
 	} catch (err) {
-		logger$15.warn({
+		logger$16.warn({
 			epicId,
 			error: err instanceof Error ? err.message : String(err)
 		}, "File-based epic shard fallback failed");
@@ -4439,7 +4574,7 @@ function readArchConstraintsFromFile(projectRoot) {
 		const content = readFileSync$1(archPath, "utf-8");
 		return content.slice(0, 1500);
 	} catch (err) {
-		logger$15.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 "";
 	}
 }
@@ -4452,7 +4587,7 @@ async function getStoryTemplate(deps) {
 	try {
 		return await deps.pack.getTemplate("story");
 	} catch (err) {
-		logger$15.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 "";
 	}
 }
@@ -4489,7 +4624,7 @@ async function isValidStoryFile(filePath) {
 
 //#endregion
 //#region src/modules/compiled-workflows/git-helpers.ts
-const logger$14 = 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).
 *
@@ -4585,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$14.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;
@@ -4619,7 +4754,7 @@ async function runGitCommand(args, cwd, logLabel) {
 			stderr += chunk.toString("utf-8");
 		});
 		proc.on("error", (err) => {
-			logger$14.warn({
+			logger$15.warn({
 				label: logLabel,
 				cwd,
 				error: err.message
@@ -4628,7 +4763,7 @@ async function runGitCommand(args, cwd, logLabel) {
 		});
 		proc.on("close", (code) => {
 			if (code !== 0) {
-				logger$14.warn({
+				logger$15.warn({
 					label: logLabel,
 					cwd,
 					code,
@@ -4644,7 +4779,7 @@ async function runGitCommand(args, cwd, logLabel) {
 
 //#endregion
 //#region src/modules/implementation-orchestrator/project-findings.ts
-const logger$13 = createLogger("project-findings");
+const logger$14 = createLogger("project-findings");
 /** Maximum character length for the findings summary */
 const MAX_CHARS = 2e3;
 /**
@@ -4699,7 +4834,7 @@ function getProjectFindings(db) {
 		if (summary.length > MAX_CHARS) summary = summary.slice(0, MAX_CHARS - 3) + "...";
 		return summary;
 	} catch (err) {
-		logger$13.warn({ err }, "Failed to query project findings (graceful fallback)");
+		logger$14.warn({ err }, "Failed to query project findings (graceful fallback)");
 		return "";
 	}
 }
@@ -4720,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$12 = createLogger("compiled-workflows:dev-story");
-/** Hard token ceiling for the assembled dev-story prompt */
-const TOKEN_CEILING$3 = 24e3;
 /** 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 */
@@ -4751,6 +4994,12 @@ async function runDevStory(deps, params) {
 		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: [{
@@ -4824,6 +5073,9 @@ async function runDevStory(deps, params) {
 		}, "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");
@@ -4920,11 +5172,11 @@ async function runDevStory(deps, params) {
 			priority: "optional"
 		}
 	];
-	const { prompt, tokenCount, truncated } = assemblePrompt(template, sections, TOKEN_CEILING$3);
+	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;
@@ -4935,6 +5187,7 @@ 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;
@@ -5153,12 +5406,6 @@ function extractFilesInScope(storyContent) {
 //#region src/modules/compiled-workflows/code-review.ts
 const logger$11 = 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;
-/**
 * Default fallback result when dispatch fails or times out.
 * Uses NEEDS_MINOR_FIXES (not NEEDS_MAJOR_REWORK) so a parse/schema failure
 * doesn't trigger a full rework cycle. The orchestrator's phantom-review
@@ -5201,6 +5448,12 @@ async function runCodeReview(deps, params) {
 		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");
@@ -5235,7 +5488,7 @@ 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$11.debug({
 				fileCount: filesModified.length,
@@ -5244,7 +5497,7 @@ async function runCodeReview(deps, params) {
 		} else {
 			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);
@@ -5254,11 +5507,11 @@ 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$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);
 		}
@@ -5322,7 +5575,7 @@ async function runCodeReview(deps, params) {
 			priority: "optional"
 		}
 	];
-	const assembleResult = assemblePrompt(template, sections, TOKEN_CEILING$2);
+	const assembleResult = assemblePrompt(template, sections, TOKEN_CEILING);
 	if (assembleResult.truncated) logger$11.warn({
 		storyKey,
 		tokenCount: assembleResult.tokenCount
@@ -5450,8 +5703,6 @@ function getArchConstraints$1(deps) {
 //#endregion
 //#region src/modules/compiled-workflows/test-plan.ts
 const logger$10 = createLogger("compiled-workflows:test-plan");
-/** Hard token ceiling for the assembled test-plan prompt */
-const TOKEN_CEILING$1 = 8e3;
 /** Default timeout for test-plan dispatches in milliseconds (5 min — lightweight call) */
 const DEFAULT_TIMEOUT_MS = 3e5;
 /**
@@ -5467,6 +5718,12 @@ async function runTestPlan(deps, params) {
 		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");
@@ -5502,11 +5759,11 @@ async function runTestPlan(deps, params) {
 		name: "story_content",
 		content: storyContent,
 		priority: "required"
-	}], TOKEN_CEILING$1);
+	}], TOKEN_CEILING);
 	logger$10.info({
 		storyKey,
 		tokenCount,
-		ceiling: TOKEN_CEILING$1,
+		ceiling: TOKEN_CEILING,
 		truncated
 	}, "Assembled test-plan prompt");
 	let dispatchResult;
@@ -5622,10 +5879,6 @@ function makeTestPlanFailureResult(error) {
 //#endregion
 //#region src/modules/compiled-workflows/test-expansion.ts
 const logger$9 = createLogger("compiled-workflows:test-expansion");
-/**
-* Hard token ceiling for the assembled test-expansion prompt (20,000 tokens).
-*/
-const TOKEN_CEILING = 2e4;
 function defaultFallbackResult(error, tokenUsage) {
 	return {
 		expansion_priority: "low",
@@ -5661,6 +5914,12 @@ async function runTestExpansion(deps, params) {
 		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");
@@ -6864,6 +7123,27 @@ function createPauseGate() {
 	};
 }
 /**
+* Build the targeted_files content string from a code-review issue list.
+* Deduplicates file paths and includes line numbers where available.
+* Returns empty string when no issues have file references.
+*/
+function buildTargetedFilesContent(issueList) {
+	const seen = new Map();
+	for (const issue of issueList) {
+		const iss = issue;
+		if (!iss.file) continue;
+		if (!seen.has(iss.file)) seen.set(iss.file, new Set());
+		if (iss.line !== void 0) seen.get(iss.file).add(iss.line);
+	}
+	if (seen.size === 0) return "";
+	const lines = [];
+	for (const [file, lineNums] of seen) if (lineNums.size > 0) {
+		const sorted = [...lineNums].sort((a, b) => a - b);
+		lines.push(`- ${file} (lines: ${sorted.join(", ")})`);
+	} else lines.push(`- ${file}`);
+	return lines.join("\n");
+}
+/**
 * Factory function that creates an ImplementationOrchestrator instance.
 *
 * @param deps - Injected dependencies (db, pack, contextCompiler, dispatcher,
@@ -6871,8 +7151,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$21 = 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;
@@ -6915,7 +7195,7 @@ function createImplementationOrchestrator(deps) {
 		const nowMs = Date.now();
 		for (const [phase, startMs] of starts) {
 			const endMs = ends?.get(phase);
-			if (endMs === void 0) logger$21.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.");
@@ -6964,7 +7244,7 @@ function createImplementationOrchestrator(deps) {
 					rationale: `Story ${storyKey} completed with result=${result} in ${wallClockSeconds}s. Tokens: ${tokenAgg.input}+${tokenAgg.output}. Review cycles: ${reviewCycles}.`
 				});
 			} catch (decisionErr) {
-				logger$21.warn({
+				logger$22.warn({
 					err: decisionErr,
 					storyKey
 				}, "Failed to write story-metrics decision (best-effort)");
@@ -6992,13 +7272,13 @@ function createImplementationOrchestrator(deps) {
 					dispatches: _storyDispatches.get(storyKey) ?? 0
 				});
 			} catch (emitErr) {
-				logger$21.warn({
+				logger$22.warn({
 					err: emitErr,
 					storyKey
 				}, "Failed to emit story:metrics event (best-effort)");
 			}
 		} catch (err) {
-			logger$21.warn({
+			logger$22.warn({
 				err,
 				storyKey
 			}, "Failed to write story metrics (best-effort)");
@@ -7027,7 +7307,7 @@ function createImplementationOrchestrator(deps) {
 				rationale: `Story ${storyKey} ${outcome} after ${reviewCycles} review cycle(s).`
 			});
 		} catch (err) {
-			logger$21.warn({
+			logger$22.warn({
 				err,
 				storyKey
 			}, "Failed to write story-outcome decision (best-effort)");
@@ -7053,7 +7333,7 @@ function createImplementationOrchestrator(deps) {
 				rationale: `Escalation diagnosis for ${payload.storyKey}: ${diagnosis.recommendedAction} — ${diagnosis.rationale}`
 			});
 		} catch (err) {
-			logger$21.warn({
+			logger$22.warn({
 				err,
 				storyKey: payload.storyKey
 			}, "Failed to persist escalation diagnosis (best-effort)");
@@ -7103,7 +7383,7 @@ function createImplementationOrchestrator(deps) {
 				token_usage_json: serialized
 			});
 		} catch (err) {
-			logger$21.warn("Failed to persist orchestrator state", { err });
+			logger$22.warn("Failed to persist orchestrator state", { err });
 		}
 	}
 	function recordProgress() {
@@ -7150,7 +7430,7 @@ function createImplementationOrchestrator(deps) {
 				}
 				if (childActive) {
 					_lastProgressTs = Date.now();
-					logger$21.debug({
+					logger$22.debug({
 						storyKey: key,
 						phase: s.phase,
 						childPids
@@ -7159,7 +7439,7 @@ function createImplementationOrchestrator(deps) {
 				}
 				_stalledStories.add(key);
 				_storiesWithStall.add(key);
-				logger$21.warn({
+				logger$22.warn({
 					storyKey: key,
 					phase: s.phase,
 					elapsedMs: elapsed,
@@ -7204,7 +7484,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$21.warn({
+			logger$22.warn({
 				storyKey,
 				freeMB: memState.freeMB,
 				thresholdMB: memState.thresholdMB,
@@ -7224,11 +7504,11 @@ function createImplementationOrchestrator(deps) {
 	* exhausted retries the story is ESCALATED.
 	*/
 	async function processStory(storyKey) {
-		logger$21.info("Processing story", { storyKey });
+		logger$22.info("Processing story", { storyKey });
 		{
 			const memoryOk = await checkMemoryPressure(storyKey);
 			if (!memoryOk) {
-				logger$21.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,
@@ -7262,14 +7542,14 @@ function createImplementationOrchestrator(deps) {
 			if (match) {
 				const candidatePath = join$1(artifactsDir, match);
 				const validation = await isValidStoryFile(candidatePath);
-				if (!validation.valid) logger$21.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$21.info({
+					logger$22.info({
 						storyKey,
 						storyFilePath
 					}, "Found existing story file — skipping create-story");
@@ -7294,7 +7574,8 @@ function createImplementationOrchestrator(deps) {
 				pack,
 				contextCompiler,
 				dispatcher,
-				projectRoot
+				projectRoot,
+				tokenCeilings
 			}, {
 				epicId: storyKey.split("-")[0] ?? storyKey,
 				storyKey,
@@ -7372,17 +7653,18 @@ function createImplementationOrchestrator(deps) {
 				pack,
 				contextCompiler,
 				dispatcher,
-				projectRoot
+				projectRoot,
+				tokenCeilings
 			}, {
 				storyKey,
 				storyFilePath: storyFilePath ?? "",
 				pipelineRunId: config.pipelineRunId
 			});
 			testPlanPhaseResult = testPlanResult.result;
-			if (testPlanResult.result === "success") logger$21.info({ storyKey }, "Test plan generated successfully");
-			else logger$21.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$21.warn({
+			logger$22.warn({
 				storyKey,
 				err
 			}, "Test planning failed — proceeding to dev-story without test plan");
@@ -7406,7 +7688,7 @@ function createImplementationOrchestrator(deps) {
 			try {
 				storyContentForAnalysis = await readFile$1(storyFilePath ?? "", "utf-8");
 			} catch (err) {
-				logger$21.error({
+				logger$22.error({
 					storyKey,
 					storyFilePath,
 					error: err instanceof Error ? err.message : String(err)
@@ -7414,7 +7696,7 @@ function createImplementationOrchestrator(deps) {
 			}
 			const analysis = analyzeStoryComplexity(storyContentForAnalysis);
 			const batches = planTaskBatches(analysis);
-			logger$21.info({
+			logger$22.info({
 				storyKey,
 				estimatedScope: analysis.estimatedScope,
 				batchCount: batches.length,
@@ -7432,7 +7714,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$21.info({
+					logger$22.info({
 						storyKey,
 						batchIndex: batch.batchIndex,
 						taskCount: batch.taskIds.length
@@ -7446,7 +7728,8 @@ function createImplementationOrchestrator(deps) {
 							pack,
 							contextCompiler,
 							dispatcher,
-							projectRoot
+							projectRoot,
+							tokenCeilings
 						}, {
 							storyKey,
 							storyFilePath: storyFilePath ?? "",
@@ -7456,7 +7739,7 @@ function createImplementationOrchestrator(deps) {
 						});
 					} catch (batchErr) {
 						const errMsg = batchErr instanceof Error ? batchErr.message : String(batchErr);
-						logger$21.warn({
+						logger$22.warn({
 							storyKey,
 							batchIndex: batch.batchIndex,
 							error: errMsg
@@ -7476,7 +7759,7 @@ function createImplementationOrchestrator(deps) {
 						filesModified: batchFilesModified,
 						result: batchResult.result === "success" ? "success" : "failed"
 					};
-					logger$21.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,
@@ -7498,13 +7781,13 @@ function createImplementationOrchestrator(deps) {
 							})
 						});
 					} catch (tokenErr) {
-						logger$21.warn({
+						logger$22.warn({
 							storyKey,
 							batchIndex: batch.batchIndex,
 							err: tokenErr
 						}, "Failed to record batch token usage");
 					}
-					if (batchResult.result === "failed") logger$21.warn({
+					if (batchResult.result === "failed") logger$22.warn({
 						storyKey,
 						batchIndex: batch.batchIndex,
 						error: batchResult.error
@@ -7525,7 +7808,8 @@ function createImplementationOrchestrator(deps) {
 					pack,
 					contextCompiler,
 					dispatcher,
-					projectRoot
+					projectRoot,
+					tokenCeilings
 				}, {
 					storyKey,
 					storyFilePath: storyFilePath ?? "",
@@ -7539,7 +7823,7 @@ function createImplementationOrchestrator(deps) {
 				});
 				persistState();
 				if (devResult.result === "success") devStoryWasSuccess = true;
-				else logger$21.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
@@ -7567,7 +7851,7 @@ function createImplementationOrchestrator(deps) {
 		if (devStoryWasSuccess) {
 			gitDiffFiles = checkGitDiffFiles(projectRoot ?? process.cwd());
 			if (gitDiffFiles.length === 0) {
-				logger$21.warn({ storyKey }, "Zero-diff detected after COMPLETE dev-story — no file changes in git working tree");
+				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"
@@ -7598,7 +7882,7 @@ function createImplementationOrchestrator(deps) {
 			});
 			if (buildVerifyResult.status === "passed") {
 				eventBus.emit("story:build-verification-passed", { storyKey });
-				logger$21.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";
@@ -7607,7 +7891,7 @@ function createImplementationOrchestrator(deps) {
 					exitCode: buildVerifyResult.exitCode ?? 1,
 					output: truncatedOutput
 				});
-				logger$21.warn({
+				logger$22.warn({
 					storyKey,
 					reason,
 					exitCode: buildVerifyResult.exitCode
@@ -7637,7 +7921,7 @@ function createImplementationOrchestrator(deps) {
 					storyKey
 				});
 				if (icResult.potentiallyAffectedTests.length > 0) {
-					logger$21.warn({
+					logger$22.warn({
 						storyKey,
 						modifiedInterfaces: icResult.modifiedInterfaces,
 						potentiallyAffectedTests: icResult.potentiallyAffectedTests
@@ -7682,7 +7966,7 @@ function createImplementationOrchestrator(deps) {
 						"NEEDS_MAJOR_REWORK": 2
 					};
 					for (const group of batchFileGroups) {
-						logger$21.info({
+						logger$22.info({
 							storyKey,
 							batchIndex: group.batchIndex,
 							fileCount: group.files.length
@@ -7693,7 +7977,8 @@ function createImplementationOrchestrator(deps) {
 							pack,
 							contextCompiler,
 							dispatcher,
-							projectRoot
+							projectRoot,
+							tokenCeilings
 						}, {
 							storyKey,
 							storyFilePath: storyFilePath ?? "",
@@ -7719,7 +8004,7 @@ function createImplementationOrchestrator(deps) {
 						rawOutput: lastRawOutput,
 						tokenUsage: aggregateTokens
 					};
-					logger$21.info({
+					logger$22.info({
 						storyKey,
 						batchCount: batchFileGroups.length,
 						verdict: worstVerdict,
@@ -7732,7 +8017,8 @@ function createImplementationOrchestrator(deps) {
 						pack,
 						contextCompiler,
 						dispatcher,
-						projectRoot
+						projectRoot,
+						tokenCeilings
 					}, {
 						storyKey,
 						storyFilePath: storyFilePath ?? "",
@@ -7745,7 +8031,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$21.warn({
+					logger$22.warn({
 						storyKey,
 						reviewCycles,
 						error: reviewResult.error
@@ -7755,7 +8041,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$21.info({
+					logger$22.info({
 						storyKey,
 						originalVerdict: verdict,
 						issuesBefore: previousIssueList.length,
@@ -7791,7 +8077,7 @@ function createImplementationOrchestrator(deps) {
 					if (_decomposition !== void 0) parts.push(`decomposed: ${_decomposition.batchCount} batches`);
 					parts.push(`${fileCount} files`);
 					parts.push(`${totalTokensK} tokens`);
-					logger$21.info({
+					logger$22.info({
 						storyKey,
 						verdict,
 						agentVerdict: reviewResult.agentVerdict
@@ -7834,7 +8120,8 @@ function createImplementationOrchestrator(deps) {
 						pack,
 						contextCompiler,
 						dispatcher,
-						projectRoot
+						projectRoot,
+						tokenCeilings
 					}, {
 						storyKey,
 						storyFilePath: storyFilePath ?? "",
@@ -7842,7 +8129,7 @@ function createImplementationOrchestrator(deps) {
 						filesModified: devFilesModified,
 						workingDirectory: projectRoot
 					});
-					logger$21.debug({
+					logger$22.debug({
 						storyKey,
 						expansion_priority: expansionResult.expansion_priority,
 						coverage_gaps: expansionResult.coverage_gaps.length
@@ -7855,7 +8142,7 @@ function createImplementationOrchestrator(deps) {
 						value: JSON.stringify(expansionResult)
 					});
 				} catch (expansionErr) {
-					logger$21.warn({
+					logger$22.warn({
 						storyKey,
 						error: expansionErr instanceof Error ? expansionErr.message : String(expansionErr)
 					}, "Test expansion failed — story verdict unchanged");
@@ -7882,7 +8169,7 @@ function createImplementationOrchestrator(deps) {
 					persistState();
 					return;
 				}
-				logger$21.info({
+				logger$22.info({
 					storyKey,
 					reviewCycles: finalReviewCycles,
 					issueCount: issueList.length
@@ -7892,9 +8179,13 @@ function createImplementationOrchestrator(deps) {
 				updateStory(storyKey, { phase: "NEEDS_FIXES" });
 				try {
 					let fixPrompt;
+					let autoApproveMaxTurns;
 					try {
 						const fixTemplate = await pack.getPrompt("fix-story");
 						const storyContent = await readFile$1(storyFilePath ?? "", "utf-8");
+						const complexity = computeStoryComplexity(storyContent);
+						autoApproveMaxTurns = resolveFixStoryMaxTurns(complexity.complexityScore);
+						logComplexityResult(storyKey, complexity, autoApproveMaxTurns);
 						let reviewFeedback;
 						if (issueList.length === 0) reviewFeedback = `Verdict: ${verdict}\nIssues: Minor issues flagged but no specifics provided. Review the story ACs and fix any remaining gaps.`;
 						else reviewFeedback = [
@@ -7911,6 +8202,7 @@ function createImplementationOrchestrator(deps) {
 							const constraints = decisions.filter((d) => d.category === "architecture");
 							archConstraints = constraints.map((d) => `${d.key}: ${d.value}`).join("\n");
 						} catch {}
+						const targetedFilesContent = buildTargetedFilesContent(issueList);
 						const sections = [
 							{
 								name: "story_content",
@@ -7926,19 +8218,25 @@ function createImplementationOrchestrator(deps) {
 								name: "arch_constraints",
 								content: archConstraints,
 								priority: "optional"
-							}
+							},
+							...targetedFilesContent ? [{
+								name: "targeted_files",
+								content: targetedFilesContent,
+								priority: "important"
+							}] : []
 						];
 						const assembled = assemblePrompt(fixTemplate, sections, 24e3);
 						fixPrompt = assembled.prompt;
 					} catch {
 						fixPrompt = `Fix story ${storyKey}: verdict=${verdict}, minor fixes needed`;
-						logger$21.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,
 						agent: "claude-code",
 						taskType: "minor-fixes",
-						workingDirectory: projectRoot
+						workingDirectory: projectRoot,
+						...autoApproveMaxTurns !== void 0 ? { maxTurns: autoApproveMaxTurns } : {}
 					});
 					const fixResult = await handle.result;
 					eventBus.emit("orchestrator:story-phase-complete", {
@@ -7949,9 +8247,9 @@ function createImplementationOrchestrator(deps) {
 							output: fixResult.tokenEstimate.output
 						} : void 0 }
 					});
-					if (fixResult.status === "timeout") logger$21.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$21.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
 					});
@@ -7981,9 +8279,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");
+					{
+						const complexity = computeStoryComplexity(storyContent);
+						fixMaxTurns = resolveFixStoryMaxTurns(complexity.complexityScore);
+						logComplexityResult(storyKey, complexity, fixMaxTurns);
+					}
 					let reviewFeedback;
 					if (issueList.length === 0) reviewFeedback = isMajorRework ? [
 						`Verdict: ${verdict}`,
@@ -8033,28 +8337,36 @@ function createImplementationOrchestrator(deps) {
 							content: "",
 							priority: "optional"
 						}
-					] : [
-						{
-							name: "story_content",
-							content: storyContent,
-							priority: "required"
-						},
-						{
-							name: "review_feedback",
-							content: reviewFeedback,
-							priority: "required"
-						},
-						{
-							name: "arch_constraints",
-							content: archConstraints,
-							priority: "optional"
-						}
-					];
+					] : (() => {
+						const targetedFilesContent = buildTargetedFilesContent(issueList);
+						return [
+							{
+								name: "story_content",
+								content: storyContent,
+								priority: "required"
+							},
+							{
+								name: "review_feedback",
+								content: reviewFeedback,
+								priority: "required"
+							},
+							{
+								name: "arch_constraints",
+								content: archConstraints,
+								priority: "optional"
+							},
+							...targetedFilesContent ? [{
+								name: "targeted_files",
+								content: targetedFilesContent,
+								priority: "important"
+							}] : []
+						];
+					})();
 					const assembled = assemblePrompt(fixTemplate, sections, 24e3);
 					fixPrompt = assembled.prompt;
 				} catch {
 					fixPrompt = `Fix story ${storyKey}: verdict=${verdict}, taskType=${taskType}`;
-					logger$21.warn("Failed to assemble fix prompt, using fallback", {
+					logger$22.warn("Failed to assemble fix prompt, using fallback", {
 						storyKey,
 						taskType
 					});
@@ -8066,12 +8378,14 @@ 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,
 					agent: "claude-code",
 					taskType,
 					...fixModel !== void 0 ? { model: fixModel } : {},
+					...fixMaxTurns !== void 0 ? { maxTurns: fixMaxTurns } : {},
 					...projectRoot !== void 0 ? { workingDirectory: projectRoot } : {}
 				});
 				const fixResult = await handle.result;
@@ -8084,7 +8398,7 @@ function createImplementationOrchestrator(deps) {
 					} : void 0 }
 				});
 				if (fixResult.status === "timeout") {
-					logger$21.warn("Fix dispatch timed out — escalating story", {
+					logger$22.warn("Fix dispatch timed out — escalating story", {
 						storyKey,
 						taskType
 					});
@@ -8106,7 +8420,7 @@ function createImplementationOrchestrator(deps) {
 				}
 				if (fixResult.status === "failed") {
 					if (isMajorRework) {
-						logger$21.warn("Major rework dispatch failed — escalating story", {
+						logger$22.warn("Major rework dispatch failed — escalating story", {
 							storyKey,
 							exitCode: fixResult.exitCode
 						});
@@ -8126,14 +8440,14 @@ function createImplementationOrchestrator(deps) {
 						persistState();
 						return;
 					}
-					logger$21.warn("Fix dispatch failed", {
+					logger$22.warn("Fix dispatch failed", {
 						storyKey,
 						taskType,
 						exitCode: fixResult.exitCode
 					});
 				}
 			} catch (err) {
-				logger$21.warn("Fix dispatch failed, continuing to next review", {
+				logger$22.warn("Fix dispatch failed, continuing to next review", {
 					storyKey,
 					taskType,
 					err
@@ -8196,11 +8510,11 @@ function createImplementationOrchestrator(deps) {
 	}
 	async function run(storyKeys) {
 		if (_state === "RUNNING" || _state === "PAUSED") {
-			logger$21.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$21.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";
@@ -8218,13 +8532,13 @@ function createImplementationOrchestrator(deps) {
 		if (config.enableHeartbeat) startHeartbeat();
 		if (projectRoot !== void 0) {
 			const seedResult = seedMethodologyContext(db, projectRoot);
-			if (seedResult.decisionsCreated > 0) logger$21.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$21.info("Orchestrator starting", {
+		logger$22.info("Orchestrator starting", {
 			storyCount: storyKeys.length,
 			groupCount: groups.length,
 			maxConcurrency: config.maxConcurrency
@@ -8236,7 +8550,7 @@ function createImplementationOrchestrator(deps) {
 			_state = "FAILED";
 			_completedAt = new Date().toISOString();
 			persistState();
-			logger$21.error("Orchestrator failed with unhandled error", { err });
+			logger$22.error("Orchestrator failed with unhandled error", { err });
 			return getStatus();
 		}
 		stopHeartbeat();
@@ -8263,7 +8577,7 @@ function createImplementationOrchestrator(deps) {
 		_pauseGate = createPauseGate();
 		_state = "PAUSED";
 		eventBus.emit("orchestrator:paused", {});
-		logger$21.info("Orchestrator paused");
+		logger$22.info("Orchestrator paused");
 	}
 	function resume() {
 		if (_state !== "PAUSED") return;
@@ -8274,7 +8588,7 @@ function createImplementationOrchestrator(deps) {
 		}
 		_state = "RUNNING";
 		eventBus.emit("orchestrator:resumed", {});
-		logger$21.info("Orchestrator resumed");
+		logger$22.info("Orchestrator resumed");
 	}
 	return {
 		run,
@@ -13228,4 +13542,4 @@ 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, parseDbTimestampAsUtc, registerHealthCommand, registerRunCommand, resolveBmadMethodSrcPath, resolveBmadMethodVersion, resolveMainRepoRoot, runAnalysisPhase, runMigrations, runPlanningPhase, runRunAction, runSolutioningPhase, validateStopAfterFromConflict };
-//# sourceMappingURL=run-DG5j6vJI.js.map
+//# sourceMappingURL=run-IeDyGCak.js.map