substrate-ai 0.2.28 → 0.2.30

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

@@ -1,10 +1,11 @@
-import { createLogger } from "./logger-D2fS2ccL.js";
-import { createEventBus, createTuiApp, isTuiCapable, printNonTtyWarning, sleep } from "./helpers-DljGJnFF.js";
+import { createLogger, deepMask } from "./logger-D2fS2ccL.js";
+import { CURRENT_CONFIG_FORMAT_VERSION, PartialSubstrateConfigSchema, SUPPORTED_CONFIG_FORMAT_VERSIONS, SubstrateConfigSchema, defaultConfigMigrator } from "./config-migrator-DSi8KhQC.js";
+import { ConfigError, ConfigIncompatibleFormatError, createEventBus, createTuiApp, isTuiCapable, printNonTtyWarning, sleep } from "./helpers-RL22dYtn.js";
 import { addTokenUsage, createDecision, createPipelineRun, createRequirement, getArtifactByTypeForRun, getArtifactsByRun, getDecisionsByCategory, getDecisionsByPhase, getDecisionsByPhaseForRun, getLatestRun, getPipelineRunById, getRunningPipelineRuns, getTokenUsageSummary, registerArtifact, updatePipelineRun, updatePipelineRunConfig, upsertDecision } from "./decisions-Dq4cAA2L.js";
 import { ESCALATION_DIAGNOSIS, OPERATIONAL_FINDING, STORY_METRICS, STORY_OUTCOME, TEST_EXPANSION_FINDING, TEST_PLAN, aggregateTokenUsageForRun, aggregateTokenUsageForStory, getStoryMetricsForRun, writeRunMetrics, writeStoryMetrics } from "./operational-CnMlvWqc.js";
 import { createRequire } from "module";
-import { dirname, join } from "path";
-import { access, readFile, readdir, stat } from "fs/promises";
+import { dirname, join, resolve } from "path";
+import { access, mkdir, readFile, readdir, stat, writeFile } from "fs/promises";
 import { existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync } from "fs";
 import yaml from "js-yaml";
 import { createRequire as createRequire$1 } from "node:module";
@@ -14,6 +15,7 @@ import { dirname as dirname$1, join as join$1, resolve as resolve$1 } from "node
 import BetterSqlite3 from "better-sqlite3";
 import { fileURLToPath } from "node:url";
 import { existsSync as existsSync$1, readFileSync as readFileSync$1, readdirSync as readdirSync$1 } from "node:fs";
+import { homedir } from "os";
 import { freemem, platform } from "node:os";
 import { createHash, randomUUID } from "node:crypto";
 import { readFile as readFile$1, stat as stat$1 } from "node:fs/promises";
@@ -21,6 +23,70 @@ import { readFile as readFile$1, stat as stat$1 } from "node:fs/promises";
 //#region rolldown:runtime
 var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
+//#endregion
+//#region src/modules/config/defaults.ts
+const DEFAULT_CLAUDE_PROVIDER = {
+	enabled: false,
+	subscription_routing: "auto",
+	max_concurrent: 2,
+	rate_limit: {
+		tokens: 22e4,
+		window_seconds: 18e3
+	},
+	api_key_env: "ANTHROPIC_API_KEY",
+	api_billing: false
+};
+const DEFAULT_CODEX_PROVIDER = {
+	enabled: false,
+	subscription_routing: "api",
+	max_concurrent: 2,
+	api_key_env: "OPENAI_API_KEY",
+	api_billing: true
+};
+const DEFAULT_GEMINI_PROVIDER = {
+	enabled: false,
+	subscription_routing: "api",
+	max_concurrent: 2,
+	api_key_env: "GOOGLE_API_KEY",
+	api_billing: true
+};
+const DEFAULT_GLOBAL_SETTINGS = {
+	log_level: "info",
+	max_concurrent_tasks: 4,
+	budget_cap_tokens: 0,
+	budget_cap_usd: 0
+};
+const DEFAULT_ROUTING_POLICY = {
+	default_provider: "claude",
+	rules: [
+		{
+			task_type: "planning",
+			preferred_provider: "claude",
+			fallback_providers: ["gemini", "codex"]
+		},
+		{
+			task_type: "coding",
+			preferred_provider: "claude",
+			fallback_providers: ["codex", "gemini"]
+		},
+		{
+			task_type: "review",
+			preferred_provider: "claude",
+			fallback_providers: ["gemini"]
+		}
+	]
+};
+const DEFAULT_CONFIG = {
+	config_format_version: "1",
+	task_graph_version: "1",
+	global: DEFAULT_GLOBAL_SETTINGS,
+	providers: {
+		claude: DEFAULT_CLAUDE_PROVIDER,
+		codex: DEFAULT_CODEX_PROVIDER,
+		gemini: DEFAULT_GEMINI_PROVIDER
+	}
+};
+
 //#endregion
 //#region src/utils/git-root.ts
 /**
@@ -539,7 +605,7 @@ const migration010RunMetrics = {
 
 //#endregion
 //#region src/persistence/migrations/index.ts
-const logger$21 = createLogger("persistence:migrations");
+const logger$22 = createLogger("persistence:migrations");
 const MIGRATIONS = [
 	initialSchemaMigration,
 	costTrackerSchemaMigration,
@@ -557,7 +623,7 @@ const MIGRATIONS = [
 * Safe to call multiple times — already-applied migrations are skipped.
 */
 function runMigrations(db) {
-	logger$21.info("Starting migration runner");
+	logger$22.info("Starting migration runner");
 	db.exec(`
     CREATE TABLE IF NOT EXISTS schema_migrations (
       version   INTEGER PRIMARY KEY,
@@ -568,12 +634,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$21.info("No pending migrations");
+		logger$22.info("No pending migrations");
 		return;
 	}
 	const insertMigration = db.prepare("INSERT INTO schema_migrations (version, name) VALUES (?, ?)");
 	for (const migration of pending) {
-		logger$21.info({
+		logger$22.info({
 			version: migration.version,
 			name: migration.name
 		}, "Applying migration");
@@ -587,14 +653,14 @@ function runMigrations(db) {
 			});
 			applyMigration();
 		}
-		logger$21.info({ version: migration.version }, "Migration applied successfully");
+		logger$22.info({ version: migration.version }, "Migration applied successfully");
 	}
-	logger$21.info({ count: pending.length }, "All pending migrations applied");
+	logger$22.info({ count: pending.length }, "All pending migrations applied");
 }
 
 //#endregion
 //#region src/persistence/database.ts
-const logger$20 = createLogger("persistence:database");
+const logger$21 = createLogger("persistence:database");
 /**
 * Thin wrapper that opens a SQLite database, applies required PRAGMAs,
 * and exposes the raw BetterSqlite3 instance.
@@ -611,14 +677,14 @@ var DatabaseWrapper = class {
 	*/
 	open() {
 		if (this._db !== null) return;
-		logger$20.info({ path: this._path }, "Opening SQLite database");
+		logger$21.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$20.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$21.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$20.info({ path: this._path }, "SQLite database opened with WAL mode");
+		logger$21.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 +693,7 @@ var DatabaseWrapper = class {
 		if (this._db === null) return;
 		this._db.close();
 		this._db = null;
-		logger$20.info({ path: this._path }, "SQLite database closed");
+		logger$21.info({ path: this._path }, "SQLite database closed");
 	}
 	/**
 	* Return the raw BetterSqlite3 instance.
@@ -1361,6 +1427,246 @@ function formatPipelineSummary(run, tokenSummary, decisionsCount, storiesCount,
 	return lines.join("\n");
 }
 
+//#endregion
+//#region src/modules/config/version-utils.ts
+/**
+* Check whether a version string is in a list of supported versions.
+*
+* @param version - Version string to check
+* @param supported - List of supported version strings
+* @returns true if version is in the supported list
+*/
+function isVersionSupported(version, supported) {
+	return supported.includes(version);
+}
+/**
+* Format the standard "unsupported version" error message.
+*
+* @param formatType - 'config' or 'task_graph'
+* @param version - The unsupported version string found
+* @param supported - List of supported version strings
+* @returns Formatted error message string
+*/
+function formatUnsupportedVersionError(formatType, version, supported) {
+	if (formatType === "config") return `Configuration format version "${version}" is not supported. This toolkit supports: ${supported.join(", ")}. Please upgrade the toolkit: npm install -g substrate@latest`;
+	return `Task graph format version "${version}" is not supported. This toolkit supports: ${supported.join(", ")}. Please upgrade the toolkit: npm install -g substrate@latest`;
+}
+
+//#endregion
+//#region src/modules/config/config-system-impl.ts
+const logger$20 = createLogger("config");
+function deepMerge(base, override) {
+	const result = { ...base };
+	for (const [key, val] of Object.entries(override)) if (val !== null && val !== void 0 && typeof val === "object" && !Array.isArray(val) && typeof result[key] === "object" && result[key] !== null && !Array.isArray(result[key])) result[key] = deepMerge(result[key], val);
+	else if (val !== void 0) result[key] = val;
+	return result;
+}
+/**
+* Map of ADT_ environment variable names to config paths.
+* Only overrides scalar values; does not support nested structures via env.
+*/
+const ENV_VAR_MAP = {
+	ADT_LOG_LEVEL: "global.log_level",
+	ADT_MAX_CONCURRENT_TASKS: "global.max_concurrent_tasks",
+	ADT_BUDGET_CAP_TOKENS: "global.budget_cap_tokens",
+	ADT_BUDGET_CAP_USD: "global.budget_cap_usd",
+	ADT_WORKSPACE_DIR: "global.workspace_dir",
+	ADT_CLAUDE_ENABLED: "providers.claude.enabled",
+	ADT_CODEX_ENABLED: "providers.codex.enabled",
+	ADT_GEMINI_ENABLED: "providers.gemini.enabled"
+};
+/**
+* Read relevant environment variables and return a partial config overlay.
+*/
+function readEnvOverrides() {
+	const overrides = {};
+	for (const [envKey, configPath] of Object.entries(ENV_VAR_MAP)) {
+		const rawValue = process.env[envKey];
+		if (rawValue === void 0) continue;
+		const parts = configPath.split(".");
+		let cursor = overrides;
+		for (let i = 0; i < parts.length - 1; i++) {
+			const part = parts[i] ?? "";
+			if (cursor[part] === void 0) cursor[part] = {};
+			cursor = cursor[part];
+		}
+		const lastKey = parts[parts.length - 1] ?? "";
+		if (rawValue === "true") cursor[lastKey] = true;
+		else if (rawValue === "false") cursor[lastKey] = false;
+		else if (/^\d+$/.test(rawValue)) cursor[lastKey] = parseInt(rawValue, 10);
+		else if (/^\d*\.\d+$/.test(rawValue)) cursor[lastKey] = parseFloat(rawValue);
+		else cursor[lastKey] = rawValue;
+	}
+	const parsed = PartialSubstrateConfigSchema.safeParse(overrides);
+	if (!parsed.success) {
+		logger$20.warn({ errors: parsed.error.issues }, "Invalid environment variable overrides ignored");
+		return {};
+	}
+	return parsed.data;
+}
+/**
+* Get a value from a nested object using dot-notation key.
+*/
+function getByPath(obj, path$1) {
+	const parts = path$1.split(".");
+	let cursor = obj;
+	for (const part of parts) {
+		if (cursor === null || cursor === void 0 || typeof cursor !== "object") return void 0;
+		cursor = cursor[part];
+	}
+	return cursor;
+}
+/**
+* Return a deep clone of `obj` with `path` set to `value`.
+* Creates intermediate objects as needed.
+*/
+function setByPath(obj, path$1, value) {
+	const parts = path$1.split(".");
+	const result = { ...obj };
+	let cursor = result;
+	for (let i = 0; i < parts.length - 1; i++) {
+		const part = parts[i] ?? "";
+		const existing = cursor[part];
+		if (existing === null || existing === void 0 || typeof existing !== "object") cursor[part] = {};
+		else cursor[part] = { ...existing };
+		cursor = cursor[part];
+	}
+	const lastKey = parts[parts.length - 1] ?? "";
+	cursor[lastKey] = value;
+	return result;
+}
+var ConfigSystemImpl = class {
+	_config = null;
+	_projectConfigDir;
+	_globalConfigDir;
+	_cliOverrides;
+	constructor(options = {}) {
+		this._projectConfigDir = options.projectConfigDir ? resolve(options.projectConfigDir) : resolve(process.cwd(), ".substrate");
+		this._globalConfigDir = options.globalConfigDir ? resolve(options.globalConfigDir) : resolve(homedir(), ".substrate");
+		this._cliOverrides = options.cliOverrides ?? {};
+	}
+	get isLoaded() {
+		return this._config !== null;
+	}
+	async load() {
+		let merged = structuredClone(DEFAULT_CONFIG);
+		const globalConfig = await this._loadYamlFile(join(this._globalConfigDir, "config.yaml"));
+		if (globalConfig !== null) merged = deepMerge(merged, globalConfig);
+		const projectConfig = await this._loadYamlFile(join(this._projectConfigDir, "config.yaml"));
+		if (projectConfig !== null) merged = deepMerge(merged, projectConfig);
+		const envOverrides = readEnvOverrides();
+		if (Object.keys(envOverrides).length > 0) merged = deepMerge(merged, envOverrides);
+		if (Object.keys(this._cliOverrides).length > 0) merged = deepMerge(merged, this._cliOverrides);
+		const result = SubstrateConfigSchema.safeParse(merged);
+		if (!result.success) {
+			const issues = result.error.issues.map((issue) => `  • ${issue.path.join(".")}: ${issue.message}`).join("\n");
+			throw new ConfigError(`Configuration validation failed:\n${issues}`, { issues: result.error.issues });
+		}
+		this._config = result.data;
+		logger$20.debug("Configuration loaded successfully");
+	}
+	getConfig() {
+		if (this._config === null) throw new ConfigError("Configuration has not been loaded. Call load() before getConfig().", {});
+		return this._config;
+	}
+	get(key) {
+		const config = this.getConfig();
+		return getByPath(config, key);
+	}
+	async set(key, value) {
+		const current = this.getConfig();
+		const existing = getByPath(current, key);
+		if (existing === void 0) throw new ConfigError(`Unknown config key: ${key}`, { key });
+		if (typeof existing === "object" && existing !== null) throw new ConfigError(`Cannot set object key "${key}" — use a more specific dot-notation path`, { key });
+		let projectConfigRaw = {};
+		const projectConfigPath = join(this._projectConfigDir, "config.yaml");
+		const existingYaml = await this._loadYamlFile(projectConfigPath);
+		if (existingYaml !== null) projectConfigRaw = existingYaml;
+		const updated = setByPath(projectConfigRaw, key, value);
+		const partial = PartialSubstrateConfigSchema.safeParse(updated);
+		if (!partial.success) {
+			const issues = partial.error.issues.map((i) => `  • ${i.path.join(".")}: ${i.message}`).join("\n");
+			throw new ConfigError(`Invalid value for "${key}":\n${issues}`, {
+				key,
+				value,
+				issues: partial.error.issues
+			});
+		}
+		await mkdir(this._projectConfigDir, { recursive: true });
+		const yamlStr = yaml.dump(updated);
+		await writeFile(projectConfigPath, yamlStr, "utf-8");
+		await this.load();
+	}
+	getMasked() {
+		const config = this.getConfig();
+		return deepMask(config);
+	}
+	getConfigFormatVersion() {
+		return CURRENT_CONFIG_FORMAT_VERSION;
+	}
+	isCompatible(version) {
+		return SUPPORTED_CONFIG_FORMAT_VERSIONS.includes(version);
+	}
+	async _fileExists(filePath) {
+		try {
+			await access(filePath);
+			return true;
+		} catch {
+			return false;
+		}
+	}
+	async _loadYamlFile(filePath) {
+		if (!await this._fileExists(filePath)) return null;
+		try {
+			const raw = await readFile(filePath, "utf-8");
+			let parsed = yaml.load(raw);
+			if (parsed !== null && typeof parsed === "object" && !Array.isArray(parsed)) {
+				const rawObj = parsed;
+				const version = rawObj["config_format_version"];
+				if (version !== void 0 && typeof version === "string" && !isVersionSupported(version, SUPPORTED_CONFIG_FORMAT_VERSIONS)) if (defaultConfigMigrator.canMigrate(version, CURRENT_CONFIG_FORMAT_VERSION)) {
+					const migrationOutput = defaultConfigMigrator.migrate(rawObj, version, CURRENT_CONFIG_FORMAT_VERSION, filePath);
+					if (migrationOutput.result.success) {
+						logger$20.info({
+							from: version,
+							to: CURRENT_CONFIG_FORMAT_VERSION,
+							backup: migrationOutput.result.backupPath
+						}, "Config auto-migrated successfully");
+						parsed = migrationOutput.config;
+					} else throw new ConfigIncompatibleFormatError(`Config migration failed: ${migrationOutput.result.manualStepsRequired.join("; ")}`, {
+						filePath,
+						version
+					});
+				} else throw new ConfigIncompatibleFormatError(formatUnsupportedVersionError("config", version, SUPPORTED_CONFIG_FORMAT_VERSIONS), { filePath });
+			}
+			const result = PartialSubstrateConfigSchema.safeParse(parsed);
+			if (!result.success) {
+				const issues = result.error.issues.map((i) => `  • ${i.path.join(".")}: ${i.message}`).join("\n");
+				throw new ConfigError(`Invalid config file at ${filePath}:\n${issues}`, {
+					filePath,
+					issues: result.error.issues
+				});
+			}
+			return result.data;
+		} catch (err) {
+			if (err instanceof ConfigError) throw err;
+			if (err instanceof ConfigIncompatibleFormatError) throw err;
+			const message = err instanceof Error ? err.message : String(err);
+			throw new ConfigError(`Failed to read config file at ${filePath}: ${message}`, { filePath });
+		}
+	}
+};
+/**
+* Create a new ConfigSystem instance.
+*
+* @example
+* const config = createConfigSystem()
+* await config.load()
+* const cfg = config.getConfig()
+*/
+function createConfigSystem(options = {}) {
+	return new ConfigSystemImpl(options);
+}
+
 //#endregion
 //#region src/modules/implementation-orchestrator/event-emitter.ts
 /**
@@ -7123,6 +7429,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,
@@ -7131,7 +7458,7 @@ function createPauseGate() {
 */
 function createImplementationOrchestrator(deps) {
 	const { db, pack, contextCompiler, dispatcher, eventBus, config, projectRoot, tokenCeilings } = deps;
-	const logger$22 = createLogger("implementation-orchestrator");
+	const logger$23 = createLogger("implementation-orchestrator");
 	let _state = "IDLE";
 	let _startedAt;
 	let _completedAt;
@@ -7174,7 +7501,7 @@ function createImplementationOrchestrator(deps) {
 		const nowMs = Date.now();
 		for (const [phase, startMs] of starts) {
 			const endMs = ends?.get(phase);
-			if (endMs === void 0) logger$22.warn({
+			if (endMs === void 0) logger$23.warn({
 				storyKey,
 				phase
 			}, "Phase has no end time — story may have errored mid-phase. Duration capped to now() and may be inflated.");
@@ -7223,7 +7550,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$22.warn({
+				logger$23.warn({
 					err: decisionErr,
 					storyKey
 				}, "Failed to write story-metrics decision (best-effort)");
@@ -7251,13 +7578,13 @@ function createImplementationOrchestrator(deps) {
 					dispatches: _storyDispatches.get(storyKey) ?? 0
 				});
 			} catch (emitErr) {
-				logger$22.warn({
+				logger$23.warn({
 					err: emitErr,
 					storyKey
 				}, "Failed to emit story:metrics event (best-effort)");
 			}
 		} catch (err) {
-			logger$22.warn({
+			logger$23.warn({
 				err,
 				storyKey
 			}, "Failed to write story metrics (best-effort)");
@@ -7286,7 +7613,7 @@ function createImplementationOrchestrator(deps) {
 				rationale: `Story ${storyKey} ${outcome} after ${reviewCycles} review cycle(s).`
 			});
 		} catch (err) {
-			logger$22.warn({
+			logger$23.warn({
 				err,
 				storyKey
 			}, "Failed to write story-outcome decision (best-effort)");
@@ -7312,7 +7639,7 @@ function createImplementationOrchestrator(deps) {
 				rationale: `Escalation diagnosis for ${payload.storyKey}: ${diagnosis.recommendedAction} — ${diagnosis.rationale}`
 			});
 		} catch (err) {
-			logger$22.warn({
+			logger$23.warn({
 				err,
 				storyKey: payload.storyKey
 			}, "Failed to persist escalation diagnosis (best-effort)");
@@ -7362,7 +7689,7 @@ function createImplementationOrchestrator(deps) {
 				token_usage_json: serialized
 			});
 		} catch (err) {
-			logger$22.warn("Failed to persist orchestrator state", { err });
+			logger$23.warn("Failed to persist orchestrator state", { err });
 		}
 	}
 	function recordProgress() {
@@ -7409,7 +7736,7 @@ function createImplementationOrchestrator(deps) {
 				}
 				if (childActive) {
 					_lastProgressTs = Date.now();
-					logger$22.debug({
+					logger$23.debug({
 						storyKey: key,
 						phase: s.phase,
 						childPids
@@ -7418,7 +7745,7 @@ function createImplementationOrchestrator(deps) {
 				}
 				_stalledStories.add(key);
 				_storiesWithStall.add(key);
-				logger$22.warn({
+				logger$23.warn({
 					storyKey: key,
 					phase: s.phase,
 					elapsedMs: elapsed,
@@ -7463,7 +7790,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$22.warn({
+			logger$23.warn({
 				storyKey,
 				freeMB: memState.freeMB,
 				thresholdMB: memState.thresholdMB,
@@ -7483,11 +7810,11 @@ function createImplementationOrchestrator(deps) {
 	* exhausted retries the story is ESCALATED.
 	*/
 	async function processStory(storyKey) {
-		logger$22.info("Processing story", { storyKey });
+		logger$23.info("Processing story", { storyKey });
 		{
 			const memoryOk = await checkMemoryPressure(storyKey);
 			if (!memoryOk) {
-				logger$22.warn({ storyKey }, "Memory pressure exhausted — escalating story without dispatch");
+				logger$23.warn({ storyKey }, "Memory pressure exhausted — escalating story without dispatch");
 				_stories.set(storyKey, {
 					phase: "ESCALATED",
 					reviewCycles: 0,
@@ -7521,14 +7848,14 @@ function createImplementationOrchestrator(deps) {
 			if (match) {
 				const candidatePath = join$1(artifactsDir, match);
 				const validation = await isValidStoryFile(candidatePath);
-				if (!validation.valid) logger$22.warn({
+				if (!validation.valid) logger$23.warn({
 					storyKey,
 					storyFilePath: candidatePath,
 					reason: validation.reason
 				}, `Existing story file for ${storyKey} is invalid (${validation.reason}) — re-creating`);
 				else {
 					storyFilePath = candidatePath;
-					logger$22.info({
+					logger$23.info({
 						storyKey,
 						storyFilePath
 					}, "Found existing story file — skipping create-story");
@@ -7640,10 +7967,10 @@ function createImplementationOrchestrator(deps) {
 				pipelineRunId: config.pipelineRunId
 			});
 			testPlanPhaseResult = testPlanResult.result;
-			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");
+			if (testPlanResult.result === "success") logger$23.info({ storyKey }, "Test plan generated successfully");
+			else logger$23.warn({ storyKey }, "Test planning returned failed result — proceeding to dev-story without test plan");
 		} catch (err) {
-			logger$22.warn({
+			logger$23.warn({
 				storyKey,
 				err
 			}, "Test planning failed — proceeding to dev-story without test plan");
@@ -7667,7 +7994,7 @@ function createImplementationOrchestrator(deps) {
 			try {
 				storyContentForAnalysis = await readFile$1(storyFilePath ?? "", "utf-8");
 			} catch (err) {
-				logger$22.error({
+				logger$23.error({
 					storyKey,
 					storyFilePath,
 					error: err instanceof Error ? err.message : String(err)
@@ -7675,7 +8002,7 @@ function createImplementationOrchestrator(deps) {
 			}
 			const analysis = analyzeStoryComplexity(storyContentForAnalysis);
 			const batches = planTaskBatches(analysis);
-			logger$22.info({
+			logger$23.info({
 				storyKey,
 				estimatedScope: analysis.estimatedScope,
 				batchCount: batches.length,
@@ -7693,7 +8020,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$22.info({
+					logger$23.info({
 						storyKey,
 						batchIndex: batch.batchIndex,
 						taskCount: batch.taskIds.length
@@ -7718,7 +8045,7 @@ function createImplementationOrchestrator(deps) {
 						});
 					} catch (batchErr) {
 						const errMsg = batchErr instanceof Error ? batchErr.message : String(batchErr);
-						logger$22.warn({
+						logger$23.warn({
 							storyKey,
 							batchIndex: batch.batchIndex,
 							error: errMsg
@@ -7738,7 +8065,7 @@ function createImplementationOrchestrator(deps) {
 						filesModified: batchFilesModified,
 						result: batchResult.result === "success" ? "success" : "failed"
 					};
-					logger$22.info(batchMetrics, "Batch dev-story metrics");
+					logger$23.info(batchMetrics, "Batch dev-story metrics");
 					for (const f of batchFilesModified) allFilesModified.add(f);
 					if (batchFilesModified.length > 0) batchFileGroups.push({
 						batchIndex: batch.batchIndex,
@@ -7760,13 +8087,13 @@ function createImplementationOrchestrator(deps) {
 							})
 						});
 					} catch (tokenErr) {
-						logger$22.warn({
+						logger$23.warn({
 							storyKey,
 							batchIndex: batch.batchIndex,
 							err: tokenErr
 						}, "Failed to record batch token usage");
 					}
-					if (batchResult.result === "failed") logger$22.warn({
+					if (batchResult.result === "failed") logger$23.warn({
 						storyKey,
 						batchIndex: batch.batchIndex,
 						error: batchResult.error
@@ -7802,7 +8129,7 @@ function createImplementationOrchestrator(deps) {
 				});
 				persistState();
 				if (devResult.result === "success") devStoryWasSuccess = true;
-				else logger$22.warn("Dev-story reported failure, proceeding to code review", {
+				else logger$23.warn("Dev-story reported failure, proceeding to code review", {
 					storyKey,
 					error: devResult.error,
 					filesModified: devFilesModified.length
@@ -7830,7 +8157,7 @@ function createImplementationOrchestrator(deps) {
 		if (devStoryWasSuccess) {
 			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");
+				logger$23.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"
@@ -7861,7 +8188,7 @@ function createImplementationOrchestrator(deps) {
 			});
 			if (buildVerifyResult.status === "passed") {
 				eventBus.emit("story:build-verification-passed", { storyKey });
-				logger$22.info({ storyKey }, "Build verification passed");
+				logger$23.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";
@@ -7870,7 +8197,7 @@ function createImplementationOrchestrator(deps) {
 					exitCode: buildVerifyResult.exitCode ?? 1,
 					output: truncatedOutput
 				});
-				logger$22.warn({
+				logger$23.warn({
 					storyKey,
 					reason,
 					exitCode: buildVerifyResult.exitCode
@@ -7900,7 +8227,7 @@ function createImplementationOrchestrator(deps) {
 					storyKey
 				});
 				if (icResult.potentiallyAffectedTests.length > 0) {
-					logger$22.warn({
+					logger$23.warn({
 						storyKey,
 						modifiedInterfaces: icResult.modifiedInterfaces,
 						potentiallyAffectedTests: icResult.potentiallyAffectedTests
@@ -7945,7 +8272,7 @@ function createImplementationOrchestrator(deps) {
 						"NEEDS_MAJOR_REWORK": 2
 					};
 					for (const group of batchFileGroups) {
-						logger$22.info({
+						logger$23.info({
 							storyKey,
 							batchIndex: group.batchIndex,
 							fileCount: group.files.length
@@ -7983,7 +8310,7 @@ function createImplementationOrchestrator(deps) {
 						rawOutput: lastRawOutput,
 						tokenUsage: aggregateTokens
 					};
-					logger$22.info({
+					logger$23.info({
 						storyKey,
 						batchCount: batchFileGroups.length,
 						verdict: worstVerdict,
@@ -8010,7 +8337,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$22.warn({
+					logger$23.warn({
 						storyKey,
 						reviewCycles,
 						error: reviewResult.error
@@ -8020,7 +8347,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$22.info({
+					logger$23.info({
 						storyKey,
 						originalVerdict: verdict,
 						issuesBefore: previousIssueList.length,
@@ -8056,7 +8383,7 @@ function createImplementationOrchestrator(deps) {
 					if (_decomposition !== void 0) parts.push(`decomposed: ${_decomposition.batchCount} batches`);
 					parts.push(`${fileCount} files`);
 					parts.push(`${totalTokensK} tokens`);
-					logger$22.info({
+					logger$23.info({
 						storyKey,
 						verdict,
 						agentVerdict: reviewResult.agentVerdict
@@ -8108,7 +8435,7 @@ function createImplementationOrchestrator(deps) {
 						filesModified: devFilesModified,
 						workingDirectory: projectRoot
 					});
-					logger$22.debug({
+					logger$23.debug({
 						storyKey,
 						expansion_priority: expansionResult.expansion_priority,
 						coverage_gaps: expansionResult.coverage_gaps.length
@@ -8121,7 +8448,7 @@ function createImplementationOrchestrator(deps) {
 						value: JSON.stringify(expansionResult)
 					});
 				} catch (expansionErr) {
-					logger$22.warn({
+					logger$23.warn({
 						storyKey,
 						error: expansionErr instanceof Error ? expansionErr.message : String(expansionErr)
 					}, "Test expansion failed — story verdict unchanged");
@@ -8148,7 +8475,7 @@ function createImplementationOrchestrator(deps) {
 					persistState();
 					return;
 				}
-				logger$22.info({
+				logger$23.info({
 					storyKey,
 					reviewCycles: finalReviewCycles,
 					issueCount: issueList.length
@@ -8158,9 +8485,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 = [
@@ -8177,6 +8508,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",
@@ -8192,19 +8524,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$22.warn("Failed to assemble auto-approve fix prompt, using fallback", { storyKey });
+						logger$23.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", {
@@ -8215,9 +8553,9 @@ function createImplementationOrchestrator(deps) {
 							output: fixResult.tokenEstimate.output
 						} : void 0 }
 					});
-					if (fixResult.status === "timeout") logger$22.warn("Auto-approve fix timed out — approving anyway (issues were minor)", { storyKey });
+					if (fixResult.status === "timeout") logger$23.warn("Auto-approve fix timed out — approving anyway (issues were minor)", { storyKey });
 				} catch (err) {
-					logger$22.warn("Auto-approve fix dispatch failed — approving anyway (issues were minor)", {
+					logger$23.warn("Auto-approve fix dispatch failed — approving anyway (issues were minor)", {
 						storyKey,
 						err
 					});
@@ -8251,7 +8589,7 @@ function createImplementationOrchestrator(deps) {
 				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);
@@ -8305,28 +8643,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$22.warn("Failed to assemble fix prompt, using fallback", {
+					logger$23.warn("Failed to assemble fix prompt, using fallback", {
 						storyKey,
 						taskType
 					});
@@ -8345,6 +8691,7 @@ function createImplementationOrchestrator(deps) {
 					agent: "claude-code",
 					taskType,
 					...fixModel !== void 0 ? { model: fixModel } : {},
+					...fixMaxTurns !== void 0 ? { maxTurns: fixMaxTurns } : {},
 					...projectRoot !== void 0 ? { workingDirectory: projectRoot } : {}
 				});
 				const fixResult = await handle.result;
@@ -8357,7 +8704,7 @@ function createImplementationOrchestrator(deps) {
 					} : void 0 }
 				});
 				if (fixResult.status === "timeout") {
-					logger$22.warn("Fix dispatch timed out — escalating story", {
+					logger$23.warn("Fix dispatch timed out — escalating story", {
 						storyKey,
 						taskType
 					});
@@ -8379,7 +8726,7 @@ function createImplementationOrchestrator(deps) {
 				}
 				if (fixResult.status === "failed") {
 					if (isMajorRework) {
-						logger$22.warn("Major rework dispatch failed — escalating story", {
+						logger$23.warn("Major rework dispatch failed — escalating story", {
 							storyKey,
 							exitCode: fixResult.exitCode
 						});
@@ -8399,14 +8746,14 @@ function createImplementationOrchestrator(deps) {
 						persistState();
 						return;
 					}
-					logger$22.warn("Fix dispatch failed", {
+					logger$23.warn("Fix dispatch failed", {
 						storyKey,
 						taskType,
 						exitCode: fixResult.exitCode
 					});
 				}
 			} catch (err) {
-				logger$22.warn("Fix dispatch failed, continuing to next review", {
+				logger$23.warn("Fix dispatch failed, continuing to next review", {
 					storyKey,
 					taskType,
 					err
@@ -8469,11 +8816,11 @@ function createImplementationOrchestrator(deps) {
 	}
 	async function run(storyKeys) {
 		if (_state === "RUNNING" || _state === "PAUSED") {
-			logger$22.warn("run() called while orchestrator is already running or paused — ignoring", { state: _state });
+			logger$23.warn("run() called while orchestrator is already running or paused — ignoring", { state: _state });
 			return getStatus();
 		}
 		if (_state === "COMPLETE") {
-			logger$22.warn("run() called on a COMPLETE orchestrator — ignoring", { state: _state });
+			logger$23.warn("run() called on a COMPLETE orchestrator — ignoring", { state: _state });
 			return getStatus();
 		}
 		_state = "RUNNING";
@@ -8491,13 +8838,13 @@ function createImplementationOrchestrator(deps) {
 		if (config.enableHeartbeat) startHeartbeat();
 		if (projectRoot !== void 0) {
 			const seedResult = seedMethodologyContext(db, projectRoot);
-			if (seedResult.decisionsCreated > 0) logger$22.info({
+			if (seedResult.decisionsCreated > 0) logger$23.info({
 				decisionsCreated: seedResult.decisionsCreated,
 				skippedCategories: seedResult.skippedCategories
 			}, "Methodology context seeded from planning artifacts");
 		}
 		const groups = detectConflictGroups(storyKeys, { moduleMap: pack.manifest.conflictGroups });
-		logger$22.info("Orchestrator starting", {
+		logger$23.info("Orchestrator starting", {
 			storyCount: storyKeys.length,
 			groupCount: groups.length,
 			maxConcurrency: config.maxConcurrency
@@ -8509,7 +8856,7 @@ function createImplementationOrchestrator(deps) {
 			_state = "FAILED";
 			_completedAt = new Date().toISOString();
 			persistState();
-			logger$22.error("Orchestrator failed with unhandled error", { err });
+			logger$23.error("Orchestrator failed with unhandled error", { err });
 			return getStatus();
 		}
 		stopHeartbeat();
@@ -8536,7 +8883,7 @@ function createImplementationOrchestrator(deps) {
 		_pauseGate = createPauseGate();
 		_state = "PAUSED";
 		eventBus.emit("orchestrator:paused", {});
-		logger$22.info("Orchestrator paused");
+		logger$23.info("Orchestrator paused");
 	}
 	function resume() {
 		if (_state !== "PAUSED") return;
@@ -8547,7 +8894,7 @@ function createImplementationOrchestrator(deps) {
 		}
 		_state = "RUNNING";
 		eventBus.emit("orchestrator:resumed", {});
-		logger$22.info("Orchestrator resumed");
+		logger$23.info("Orchestrator resumed");
 	}
 	return {
 		run,
@@ -12643,6 +12990,14 @@ async function runRunAction(options) {
 			process.exit(130);
 		});
 	} catch {}
+	let tokenCeilings;
+	try {
+		const configSystem = createConfigSystem({ projectConfigDir: dbDir });
+		await configSystem.load();
+		tokenCeilings = configSystem.getConfig().token_ceilings;
+	} catch {
+		logger.debug("Config loading skipped — using default token ceilings");
+	}
 	if (startPhase !== void 0) return runFullPipeline({
 		packName,
 		packPath,
@@ -12654,6 +13009,7 @@ async function runRunAction(options) {
 		concurrency,
 		outputFormat,
 		projectRoot,
+		tokenCeilings,
 		...eventsFlag === true ? { events: true } : {},
 		...skipUx === true ? { skipUx: true } : {},
 		...researchFlag === true ? { research: true } : {},
@@ -13060,7 +13416,8 @@ async function runRunAction(options) {
 				pipelineRunId: pipelineRun.id,
 				enableHeartbeat: eventsFlag === true
 			},
-			projectRoot
+			projectRoot,
+			tokenCeilings
 		});
 		if (outputFormat === "human" && progressRenderer === void 0 && ndjsonEmitter === void 0) {
 			process.stdout.write(`Starting pipeline: ${storyKeys.length} story/stories, concurrency=${concurrency}\n`);
@@ -13156,7 +13513,7 @@ async function runRunAction(options) {
 	}
 }
 async function runFullPipeline(options) {
-	const { packName, packPath, dbDir, dbPath, startPhase, stopAfter, concept, concurrency, outputFormat, projectRoot, events: eventsFlag, skipUx, research: researchFlag, skipResearch: skipResearchFlag, registry: injectedRegistry } = options;
+	const { packName, packPath, dbDir, dbPath, startPhase, stopAfter, concept, concurrency, outputFormat, projectRoot, events: eventsFlag, skipUx, research: researchFlag, skipResearch: skipResearchFlag, registry: injectedRegistry, tokenCeilings } = options;
 	if (!existsSync(dbDir)) mkdirSync(dbDir, { recursive: true });
 	const dbWrapper = new DatabaseWrapper(dbPath);
 	try {
@@ -13363,7 +13720,8 @@ async function runFullPipeline(options) {
 						maxReviewCycles: 2,
 						pipelineRunId: runId
 					},
-					projectRoot
+					projectRoot,
+					tokenCeilings
 				});
 				eventBus.on("orchestrator:story-phase-complete", (payload) => {
 					try {
@@ -13500,5 +13858,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, parseDbTimestampAsUtc, registerHealthCommand, registerRunCommand, resolveBmadMethodSrcPath, resolveBmadMethodVersion, resolveMainRepoRoot, runAnalysisPhase, runMigrations, runPlanningPhase, runRunAction, runSolutioningPhase, validateStopAfterFromConflict };
-//# sourceMappingURL=run-BCyrbL3w.js.map
+export { DEFAULT_CONFIG, DEFAULT_ROUTING_POLICY, DatabaseWrapper, SUBSTRATE_OWNED_SETTINGS_KEYS, VALID_PHASES, buildPipelineStatusOutput, createConfigSystem, 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-Ajt187oE.js.map