substrate-ai 0.20.61 → 0.20.62

package/dist/cli/index.js

@@ -13,7 +13,7 @@ import { registerUpgradeCommand } from "../upgrade-CAqLkNUP.js";
 import { Command } from "commander";
 import { fileURLToPath } from "url";
 import { dirname, join, resolve } from "path";
-import { access, mkdir, readFile, writeFile } from "fs/promises";
+import { access, mkdir, readFile, readdir, writeFile } from "fs/promises";
 import { EventEmitter } from "node:events";
 import yaml from "js-yaml";
 import * as actualFS from "node:fs";
@@ -336,12 +336,12 @@ var GitWorktreeManagerImpl = class {
 	_onTaskReady;
 	_onTaskComplete;
 	_onTaskFailed;
-	constructor(eventBus, projectRoot, baseDirectory = DEFAULT_WORKTREE_BASE, db = null, logger$18) {
+	constructor(eventBus, projectRoot, baseDirectory = DEFAULT_WORKTREE_BASE, db = null, logger$19) {
 		this._eventBus = eventBus;
 		this._projectRoot = projectRoot;
 		this._baseDirectory = baseDirectory;
 		this._db = db;
-		this._logger = logger$18 ?? console;
+		this._logger = logger$19 ?? console;
 		this._onTaskReady = ({ taskId }) => {
 			this._handleTaskReady(taskId).catch((err) => {
 				this._logger.error({
@@ -645,14 +645,14 @@ var RecommendationEngine = class {
 	_filters;
 	_historyDays;
 	_logger;
-	constructor(monitorDb, config = {}, logger$18) {
+	constructor(monitorDb, config = {}, logger$19) {
 		this._monitorDb = monitorDb;
 		this._filters = {
 			threshold_percentage: config.recommendation_threshold_percentage ?? 5,
 			min_sample_size: config.min_sample_size ?? 10
 		};
 		this._historyDays = config.recommendation_history_days ?? 90;
-		this._logger = logger$18 ?? console;
+		this._logger = logger$19 ?? console;
 	}
 	generateRecommendations() {
 		const sinceDate = new Date(Date.now() - this._historyDays * 24 * 60 * 60 * 1e3).toISOString();
@@ -1742,7 +1742,7 @@ function buildStackAwareDevNotes(profile) {
 
 //#endregion
 //#region src/cli/commands/init.ts
-const logger$17 = createLogger("init");
+const logger$18 = createLogger("init");
 const __dirname = dirname(new URL(import.meta.url).pathname);
 const SCAFFOLD_VERSION_REGEX = /<!-- substrate:version=([\d.]+) -->/;
 /**
@@ -1783,7 +1783,7 @@ async function scaffoldBmadFramework(projectRoot, force, outputFormat) {
 	const version = resolveBmadMethodVersion();
 	if (force && bmadExists) process.stderr.write(`Warning: Replacing existing _bmad/ framework with bmad-method@${version}\n`);
 	process.stdout.write(`Scaffolding BMAD framework from bmad-method@${version}\n`);
-	logger$17.info({
+	logger$18.info({
 		version,
 		dest: bmadDest
 	}, "Scaffolding BMAD framework");
@@ -1793,7 +1793,7 @@ async function scaffoldBmadFramework(projectRoot, force, outputFormat) {
 			const destDir = join(bmadDest, dir);
 			mkdirSync$1(destDir, { recursive: true });
 			cpSync(srcDir, destDir, { recursive: true });
-			logger$17.info({
+			logger$18.info({
 				dir,
 				dest: destDir
 			}, "Scaffolded BMAD framework directory");
@@ -1812,7 +1812,7 @@ async function scaffoldBmadFramework(projectRoot, force, outputFormat) {
 			"document_output_language: English"
 		].join("\n") + "\n";
 		await writeFile(configFile, configStub, "utf8");
-		logger$17.info({ configFile }, "Generated _bmad/_config/config.yaml stub");
+		logger$18.info({ configFile }, "Generated _bmad/_config/config.yaml stub");
 	}
 }
 const CLAUDE_MD_START_MARKER = "<!-- substrate:start -->";
@@ -1827,7 +1827,7 @@ async function scaffoldClaudeMd(projectRoot, profile) {
 	try {
 		sectionContent = await readFile(templatePath, "utf8");
 	} catch {
-		logger$17.warn({ templatePath }, "CLAUDE.md substrate section template not found; skipping");
+		logger$18.warn({ templatePath }, "CLAUDE.md substrate section template not found; skipping");
 		return;
 	}
 	const substrateVersion = readSubstrateVersion(pkgRoot);
@@ -1863,7 +1863,7 @@ async function scaffoldClaudeMd(projectRoot, profile) {
 		else newContent = updatedExisting;
 	}
 	await writeFile(claudeMdPath, newContent, "utf8");
-	logger$17.info({ claudeMdPath }, "Wrote substrate section to CLAUDE.md");
+	logger$18.info({ claudeMdPath }, "Wrote substrate section to CLAUDE.md");
 }
 async function scaffoldAgentsMd(projectRoot, profile) {
 	const agentsMdPath = join(projectRoot, "AGENTS.md");
@@ -1875,7 +1875,7 @@ async function scaffoldAgentsMd(projectRoot, profile) {
 	try {
 		sectionContent = await readFile(templatePath, "utf8");
 	} catch {
-		logger$17.warn({ templatePath }, "AGENTS.md substrate section template not found; skipping");
+		logger$18.warn({ templatePath }, "AGENTS.md substrate section template not found; skipping");
 		return;
 	}
 	const substrateVersion = readSubstrateVersion(pkgRoot);
@@ -1896,7 +1896,7 @@ async function scaffoldAgentsMd(projectRoot, profile) {
 		newContent = existingContent + separator + sectionContent;
 	}
 	await writeFile(agentsMdPath, newContent, "utf8");
-	logger$17.info({ agentsMdPath }, "Wrote substrate section to AGENTS.md");
+	logger$18.info({ agentsMdPath }, "Wrote substrate section to AGENTS.md");
 }
 async function scaffoldGeminiMd(projectRoot, profile) {
 	const geminiMdPath = join(projectRoot, "GEMINI.md");
@@ -1908,7 +1908,7 @@ async function scaffoldGeminiMd(projectRoot, profile) {
 	try {
 		sectionContent = await readFile(templatePath, "utf8");
 	} catch {
-		logger$17.warn({ templatePath }, "GEMINI.md substrate section template not found; skipping");
+		logger$18.warn({ templatePath }, "GEMINI.md substrate section template not found; skipping");
 		return;
 	}
 	const substrateVersion = readSubstrateVersion(pkgRoot);
@@ -1929,7 +1929,7 @@ async function scaffoldGeminiMd(projectRoot, profile) {
 		newContent = existingContent + separator + sectionContent;
 	}
 	await writeFile(geminiMdPath, newContent, "utf8");
-	logger$17.info({ geminiMdPath }, "Wrote substrate section to GEMINI.md");
+	logger$18.info({ geminiMdPath }, "Wrote substrate section to GEMINI.md");
 }
 async function scaffoldStatuslineScript(projectRoot) {
 	const pkgRoot = findPackageRoot(__dirname);
@@ -1940,7 +1940,7 @@ async function scaffoldStatuslineScript(projectRoot) {
 	try {
 		content = await readFile(templatePath, "utf8");
 	} catch {
-		logger$17.warn({ templatePath }, "statusline.sh template not found; skipping");
+		logger$18.warn({ templatePath }, "statusline.sh template not found; skipping");
 		return;
 	}
 	const claudeDir = join(projectRoot, ".claude");
@@ -1948,7 +1948,7 @@ async function scaffoldStatuslineScript(projectRoot) {
 	mkdirSync$1(claudeDir, { recursive: true });
 	await writeFile(statuslinePath, content, "utf8");
 	chmodSync(statuslinePath, 493);
-	logger$17.info({ statuslinePath }, "Wrote .claude/statusline.sh");
+	logger$18.info({ statuslinePath }, "Wrote .claude/statusline.sh");
 }
 async function scaffoldClaudeSettings(projectRoot) {
 	const claudeDir = join(projectRoot, ".claude");
@@ -1964,7 +1964,7 @@ async function scaffoldClaudeSettings(projectRoot) {
 	if (!merged["$schema"]) merged["$schema"] = "https://json.schemastore.org/claude-code-settings.json";
 	mkdirSync$1(claudeDir, { recursive: true });
 	await writeFile(settingsPath, JSON.stringify(merged, null, 2) + "\n", "utf8");
-	logger$17.info({ settingsPath }, "Wrote substrate settings to .claude/settings.json");
+	logger$18.info({ settingsPath }, "Wrote substrate settings to .claude/settings.json");
 }
 function resolveBmadMethodInstallerLibPath(fromDir = __dirname) {
 	try {
@@ -2036,7 +2036,7 @@ async function compileBmadAgents(bmadDir) {
 				writeFileSync$1(mdPath, result.xml, "utf-8");
 				compiled++;
 			} catch (compileErr) {
-				logger$17.debug({
+				logger$18.debug({
 					err: compileErr,
 					file
 				}, "Failed to compile agent YAML");
@@ -2183,9 +2183,9 @@ async function scaffoldClaudeCommands(projectRoot, outputFormat) {
 		const _require = createRequire(join(__dirname, "synthetic.js"));
 		try {
 			const compiledCount = await compileBmadAgents(bmadDir);
-			if (compiledCount > 0) logger$17.info({ compiledCount }, "Compiled agent YAML files to MD");
+			if (compiledCount > 0) logger$18.info({ compiledCount }, "Compiled agent YAML files to MD");
 		} catch (compileErr) {
-			logger$17.warn({ err: compileErr }, "Agent compilation failed; agent commands may be incomplete");
+			logger$18.warn({ err: compileErr }, "Agent compilation failed; agent commands may be incomplete");
 		}
 		const resolveExport = (mod, name) => {
 			if (typeof mod[name] === "function") return mod[name];
@@ -2199,7 +2199,7 @@ async function scaffoldClaudeCommands(projectRoot, outputFormat) {
 		const manifestGenPath = join(installerLibPath, "core", "manifest-generator.js");
 		const pathUtilsPath = join(installerLibPath, "ide", "shared", "path-utils.js");
 		if (!existsSync$1(agentGenPath)) {
-			logger$17.info("bmad-method generators not available (requires bmad-method with agent/workflow/task-tool generators)");
+			logger$18.info("bmad-method generators not available (requires bmad-method with agent/workflow/task-tool generators)");
 			return;
 		}
 		const agentMod = _require(agentGenPath);
@@ -2209,11 +2209,11 @@ async function scaffoldClaudeCommands(projectRoot, outputFormat) {
 		if (existsSync$1(workflowGenPath)) {
 			const workflowMod = _require(workflowGenPath);
 			WorkflowCommandGenerator = resolveExport(workflowMod, "WorkflowCommandGenerator");
-		} else logger$17.info("bmad-method workflow-command-generator not available; will try skill-based installation");
+		} else logger$18.info("bmad-method workflow-command-generator not available; will try skill-based installation");
 		if (existsSync$1(taskToolGenPath)) {
 			const taskToolMod = _require(taskToolGenPath);
 			TaskToolCommandGenerator = resolveExport(taskToolMod, "TaskToolCommandGenerator");
-		} else logger$17.info("bmad-method task-tool-command-generator not available; will try skill-based installation");
+		} else logger$18.info("bmad-method task-tool-command-generator not available; will try skill-based installation");
 		let ManifestGenerator = null;
 		if (existsSync$1(manifestGenPath)) {
 			const manifestMod = _require(manifestGenPath);
@@ -2245,7 +2245,7 @@ async function scaffoldClaudeCommands(projectRoot, outputFormat) {
 			const manifestGen = new ManifestGenerator();
 			await manifestGen.generateManifests(bmadDir, allModules, [], { ides: ["claude-code"] });
 		} catch (manifestErr) {
-			logger$17.warn({ err: manifestErr }, "ManifestGenerator failed; workflow/task commands may be incomplete");
+			logger$18.warn({ err: manifestErr }, "ManifestGenerator failed; workflow/task commands may be incomplete");
 		}
 		const commandsDir = join(projectRoot, ".claude", "commands");
 		mkdirSync$1(commandsDir, { recursive: true });
@@ -2273,7 +2273,7 @@ async function scaffoldClaudeCommands(projectRoot, outputFormat) {
 		const total = agentCount + workflowCount + taskToolCount + skillCount;
 		if (outputFormat !== "json") if (skillCount > 0) process.stdout.write(`Generated ${String(total)} Claude Code commands (${String(agentCount)} agents, ${String(skillCount)} skills)\n`);
 		else process.stdout.write(`Generated ${String(total)} Claude Code commands (${String(agentCount)} agents, ${String(workflowCount)} workflows, ${String(taskToolCount)} tasks/tools)\n`);
-		logger$17.info({
+		logger$18.info({
 			agentCount,
 			workflowCount,
 			taskToolCount,
@@ -2284,7 +2284,7 @@ async function scaffoldClaudeCommands(projectRoot, outputFormat) {
 	} catch (err) {
 		const msg = err instanceof Error ? err.message : String(err);
 		if (outputFormat !== "json") process.stderr.write(`Warning: .claude/commands/ generation failed: ${msg}\n`);
-		logger$17.warn({ err }, "scaffoldClaudeCommands failed; init continues");
+		logger$18.warn({ err }, "scaffoldClaudeCommands failed; init continues");
 	}
 }
 /**
@@ -2313,7 +2313,7 @@ function syncCommandsAsPrompts(commandsDir, promptsDir, ownershipPrefixes, nameP
 			unlinkSync$1(join(promptsDir, entry.name));
 		}
 	} catch (err) {
-		logger$17.debug({
+		logger$18.debug({
 			err,
 			promptsDir
 		}, "Failed to prune stale prompts");
@@ -2355,7 +2355,7 @@ function syncSkillsToTarget(srcSkillsDir, destSkillsDir, ownershipPrefixes, name
 			});
 		}
 	} catch (err) {
-		logger$17.debug({
+		logger$18.debug({
 			err,
 			destSkillsDir
 		}, "Failed to prune stale skills");
@@ -2398,16 +2398,16 @@ function scaffoldCodexProject(projectRoot, outputFormat) {
 		const skillCount = syncSkillsToTarget(claudeSkillsDir, codexSkillsDir, PROJECT_OWNERSHIP_PREFIXES, "");
 		const total = promptCount + skillCount;
 		if (outputFormat !== "json" && total > 0) process.stdout.write(`Generated ${String(total)} Codex artifacts (${String(promptCount)} prompts, ${String(skillCount)} skills)\n`);
-		if (total > 0) logger$17.info({
+		if (total > 0) logger$18.info({
 			promptCount,
 			skillCount,
 			codexDir
 		}, "Generated .codex/");
-		else logger$17.debug({ codexDir }, "No Codex artifacts generated; source Claude content not found");
+		else logger$18.debug({ codexDir }, "No Codex artifacts generated; source Claude content not found");
 	} catch (err) {
 		const msg = err instanceof Error ? err.message : String(err);
 		if (outputFormat !== "json") process.stderr.write(`Warning: .codex/ generation failed: ${msg}\n`);
-		logger$17.warn({ err }, "scaffoldCodexProject failed; init continues");
+		logger$18.warn({ err }, "scaffoldCodexProject failed; init continues");
 	}
 }
 /**
@@ -2433,16 +2433,16 @@ function scaffoldCodexUser(projectRoot, homeDir, outputFormat) {
 		const skillCount = syncSkillsToTarget(claudeSkillsDir, userSkillsDir, ["substrate-"], "substrate-");
 		const total = promptCount + skillCount;
 		if (outputFormat !== "json" && total > 0) process.stdout.write(`Installed ${String(total)} Codex artifacts to ${userCodexDir} (${String(promptCount)} prompts, ${String(skillCount)} skills)\n`);
-		if (total > 0) logger$17.info({
+		if (total > 0) logger$18.info({
 			promptCount,
 			skillCount,
 			userCodexDir
 		}, "Installed user-scope Codex content");
-		else logger$17.debug({ userCodexDir }, "No user-scope Codex content installed; source Claude content not found");
+		else logger$18.debug({ userCodexDir }, "No user-scope Codex content installed; source Claude content not found");
 	} catch (err) {
 		const msg = err instanceof Error ? err.message : String(err);
 		if (outputFormat !== "json") process.stderr.write(`Warning: user-scope Codex install failed: ${msg}\n`);
-		logger$17.warn({ err }, "scaffoldCodexUser failed; init continues");
+		logger$18.warn({ err }, "scaffoldCodexUser failed; init continues");
 	}
 }
 const PROVIDER_DEFAULTS = DEFAULT_CONFIG.providers;
@@ -2562,7 +2562,7 @@ async function runInitAction(options) {
 			discoveryReport = await registry.discoverAndRegister();
 		} catch (err) {
 			const message = err instanceof Error ? err.message : String(err);
-			logger$17.error({ err }, "Adapter discovery failed");
+			logger$18.error({ err }, "Adapter discovery failed");
 			if (outputFormat === "json") process.stdout.write(formatOutput(null, "json", false, `Adapter discovery failed: ${message}`) + "\n");
 			else process.stderr.write(`  Error: adapter discovery failed — ${message}\n`);
 			return INIT_EXIT_ERROR;
@@ -2605,7 +2605,7 @@ async function runInitAction(options) {
 		try {
 			detectedProfile = await detectProjectProfile(dbRoot);
 		} catch (err) {
-			logger$17.warn({ err }, "Project profile detection failed; skipping");
+			logger$18.warn({ err }, "Project profile detection failed; skipping");
 		}
 		if (detectedProfile === null) {
 			if (outputFormat !== "json") process.stdout.write("  No project stack detected. Create .substrate/project-profile.yaml manually to enable polyglot support.\n");
@@ -2639,12 +2639,12 @@ async function runInitAction(options) {
 				return INIT_EXIT_ERROR;
 			}
 			if (force && existsSync$1(localManifest)) {
-				logger$17.info({ pack: packName }, "Replacing existing pack with bundled version");
+				logger$18.info({ pack: packName }, "Replacing existing pack with bundled version");
 				process.stderr.write(`Warning: Replacing existing pack '${packName}' with bundled version\n`);
 			}
 			mkdirSync$1(dirname(packPath), { recursive: true });
 			cpSync(bundledPackPath, packPath, { recursive: true });
-			logger$17.info({
+			logger$18.info({
 				pack: packName,
 				dest: packPath
 			}, "Scaffolded methodology pack");
@@ -2696,10 +2696,10 @@ async function runInitAction(options) {
 			if (missing.length > 0) {
 				const block = "\n# Substrate runtime files\n" + missing.join("\n") + "\n";
 				appendFileSync(gitignorePath, block);
-				logger$17.info({ entries: missing }, "Added substrate runtime files to .gitignore");
+				logger$18.info({ entries: missing }, "Added substrate runtime files to .gitignore");
 			}
 		} catch (err) {
-			logger$17.debug({ err }, "Could not update .gitignore (non-fatal)");
+			logger$18.debug({ err }, "Could not update .gitignore (non-fatal)");
 		}
 		const doltMode = options.doltMode ?? "auto";
 		let doltInitialized = false;
@@ -2716,7 +2716,7 @@ async function runInitAction(options) {
 					process.stderr.write(`${err.message}\n`);
 					return INIT_EXIT_ERROR;
 				}
-				logger$17.debug("Dolt not installed, skipping auto-init");
+				logger$18.debug("Dolt not installed, skipping auto-init");
 			} else {
 				const msg = err instanceof Error ? err.message : String(err);
 				if (doltMode === "force") {
@@ -2726,7 +2726,7 @@ async function runInitAction(options) {
 				process.stderr.write(`⚠  Dolt state store initialization failed: ${msg}\n   Pipeline metrics, cost tracking, and health monitoring will not persist.\n   Fix the issue and re-run: substrate init --dolt\n`);
 			}
 		}
-		else logger$17.debug("Dolt step was skipped (--no-dolt)");
+		else logger$18.debug("Dolt step was skipped (--no-dolt)");
 		const successMsg = `Pack '${packName}' and database initialized successfully at ${dbPath}`;
 		if (outputFormat === "json") process.stdout.write(formatOutput({
 			pack: packName,
@@ -2764,7 +2764,7 @@ async function runInitAction(options) {
 		const msg = err instanceof Error ? err.message : String(err);
 		if (outputFormat === "json") process.stdout.write(formatOutput(null, "json", false, msg) + "\n");
 		else process.stderr.write(`Error: ${msg}\n`);
-		logger$17.error({ err }, "init failed");
+		logger$18.error({ err }, "init failed");
 		return INIT_EXIT_ERROR;
 	}
 }
@@ -2788,7 +2788,7 @@ function registerInitCommand(program, _version, registry) {
 
 //#endregion
 //#region src/cli/commands/config.ts
-const logger$16 = createLogger("config-cmd");
+const logger$17 = createLogger("config-cmd");
 const CONFIG_EXIT_SUCCESS = 0;
 const CONFIG_EXIT_ERROR = 1;
 const CONFIG_EXIT_INVALID = 2;
@@ -2814,7 +2814,7 @@ async function runConfigShow(opts = {}) {
 			return CONFIG_EXIT_INVALID;
 		}
 		const message = err instanceof Error ? err.message : String(err);
-		logger$16.error({ err }, "Failed to load configuration");
+		logger$17.error({ err }, "Failed to load configuration");
 		process.stderr.write(`  Error loading configuration: ${message}\n`);
 		return CONFIG_EXIT_ERROR;
 	}
@@ -2888,7 +2888,7 @@ async function runConfigExport(opts = {}) {
 			return CONFIG_EXIT_INVALID;
 		}
 		const message = err instanceof Error ? err.message : String(err);
-		logger$16.error({ err }, "Failed to load configuration");
+		logger$17.error({ err }, "Failed to load configuration");
 		process.stderr.write(`Error loading configuration: ${message}\n`);
 		return CONFIG_EXIT_ERROR;
 	}
@@ -6808,7 +6808,7 @@ async function detectManifestDriftAgainstWorkingTree(manifest, projectRoot) {
 
 //#endregion
 //#region src/cli/commands/resume.ts
-const logger$15 = createLogger("resume-cmd");
+const logger$16 = createLogger("resume-cmd");
 /**
 * Format a human-readable duration from an ISO-8601 timestamp to "now".
 */
@@ -6878,7 +6878,7 @@ async function runResumeAction(options) {
 				return 1;
 			}
 		} catch (driftErr) {
-			logger$15.debug({ err: driftErr }, "manifest drift check failed — proceeding with resume");
+			logger$16.debug({ err: driftErr }, "manifest drift check failed — proceeding with resume");
 		}
 	}
 	const doltDir = join(dbRoot, ".substrate", "state", ".dolt");
@@ -6948,15 +6948,15 @@ async function runResumeAction(options) {
 				const manifestStories = manifestData.cli_flags["stories"] ?? manifestData.story_scope;
 				if (Array.isArray(manifestStories) && manifestStories.length > 0) {
 					scopedStories = manifestStories;
-					logger$15.debug({
+					logger$16.debug({
 						runId,
 						stories: scopedStories
 					}, "resume scope loaded from manifest");
 				}
 			} catch {
-				logger$15.debug({ runId }, "manifest read failed in resume — using legacy config_json scope");
+				logger$16.debug({ runId }, "manifest read failed in resume — using legacy config_json scope");
 			}
-			else logger$15.debug({ runId }, "Run manifest not found for scope preservation — using legacy config_json scope");
+			else logger$16.debug({ runId }, "Run manifest not found for scope preservation — using legacy config_json scope");
 		}
 		return runFullPipelineFromPhase({
 			packName,
@@ -6979,7 +6979,7 @@ async function runResumeAction(options) {
 		const msg = err instanceof Error ? err.message : String(err);
 		if (outputFormat === "json") process.stdout.write(formatOutput(null, "json", false, msg) + "\n");
 		else process.stderr.write(`Error: ${msg}\n`);
-		logger$15.error({ err }, "auto resume failed");
+		logger$16.error({ err }, "auto resume failed");
 		return 1;
 	} finally {
 		try {
@@ -7229,11 +7229,11 @@ async function runFullPipelineFromPhase(options) {
 								output_tokens: output,
 								cost_usd: costUsd
 							}).catch((err) => {
-								logger$15.warn({ err }, "Failed to record token usage");
+								logger$16.warn({ err }, "Failed to record token usage");
 							});
 						}
 					} catch (err) {
-						logger$15.warn({ err }, "Failed to record token usage");
+						logger$16.warn({ err }, "Failed to record token usage");
 					}
 				});
 				const storyKeys = await resolveStoryKeys(adapter, projectRoot, {
@@ -7302,7 +7302,7 @@ async function runFullPipelineFromPhase(options) {
 		const msg = err instanceof Error ? err.message : String(err);
 		if (outputFormat === "json") process.stdout.write(formatOutput(null, "json", false, msg) + "\n");
 		else process.stderr.write(`Error: ${msg}\n`);
-		logger$15.error({ err }, "pipeline from phase failed");
+		logger$16.error({ err }, "pipeline from phase failed");
 		return 1;
 	} finally {
 		try {
@@ -7332,7 +7332,7 @@ function registerResumeCommand(program, _version = "0.0.0", projectRoot = proces
 
 //#endregion
 //#region src/cli/commands/status.ts
-const logger$14 = createLogger("status-cmd");
+const logger$15 = createLogger("status-cmd");
 /**
 * Map a manifest per-story status string to the appropriate WorkGraphCounts bucket.
 * Unknown strings are treated as `inProgress` (safe default).
@@ -7444,9 +7444,9 @@ async function runStatusAction(options) {
 			const manifestData = await resolvedManifest.read();
 			manifestPerStoryState = manifestData.per_story_state;
 			workGraph = buildWorkGraphFromManifest(manifestData.per_story_state);
-			logger$14.debug({ runId: run?.id }, "status: workGraph built from manifest per_story_state");
+			logger$15.debug({ runId: run?.id }, "status: workGraph built from manifest per_story_state");
 		} catch {
-			logger$14.debug({ runId: run?.id }, "status: manifest read failed — falling back to wg_stories");
+			logger$15.debug({ runId: run?.id }, "status: manifest read failed — falling back to wg_stories");
 		}
 		if (workGraph === void 0) try {
 			const wgRepo = new WorkGraphRepository(adapter);
@@ -7483,7 +7483,7 @@ async function runStatusAction(options) {
 				};
 			}
 		} catch (err) {
-			logger$14.debug({ err }, "Work graph query failed, continuing without work graph data");
+			logger$15.debug({ err }, "Work graph query failed, continuing without work graph data");
 		}
 		if (run === void 0) {
 			const { inspectProcessTree: inspectProcessTree$1 } = await import("../health-FZVOBYND.js");
@@ -7516,7 +7516,7 @@ async function runStatusAction(options) {
 		if (stateStore) try {
 			storeStories = await stateStore.queryStories({});
 		} catch (err) {
-			logger$14.debug({ err }, "StateStore query failed, continuing without store data");
+			logger$15.debug({ err }, "StateStore query failed, continuing without store data");
 		}
 		if (outputFormat === "json") {
 			const statusOutput = buildPipelineStatusOutput(run, tokenSummary, decisionsCount, storiesCount);
@@ -7659,7 +7659,7 @@ async function runStatusAction(options) {
 		const msg = err instanceof Error ? err.message : String(err);
 		if (outputFormat === "json") process.stdout.write(formatOutput(null, "json", false, msg) + "\n");
 		else process.stderr.write(`Error: ${msg}\n`);
-		logger$14.error({ err }, "status action failed");
+		logger$15.error({ err }, "status action failed");
 		return 1;
 	} finally {
 		try {
@@ -8006,7 +8006,7 @@ Analyze thoroughly and return ONLY the JSON array with no additional text.`;
 
 //#endregion
 //#region src/cli/commands/amend.ts
-const logger$13 = createLogger("amend-cmd");
+const logger$14 = createLogger("amend-cmd");
 /**
 * Detect and apply supersessions after a phase completes in an amendment run.
 *
@@ -8037,7 +8037,7 @@ async function runPostPhaseSupersessionDetection(adapter, amendmentRunId, curren
 			});
 		} catch (err) {
 			const msg = err instanceof Error ? err.message : String(err);
-			logger$13.warn({
+			logger$14.warn({
 				err,
 				originalId: parentMatch.id,
 				supersedingId: newDec.id
@@ -8174,7 +8174,7 @@ async function runAmendAction(options) {
 		for (let i = startIdx; i < phaseOrder.length; i++) {
 			const currentPhase = phaseOrder[i];
 			const amendmentContext = handler.loadContextForPhase(currentPhase);
-			logger$13.info({
+			logger$14.info({
 				phase: currentPhase,
 				amendmentContextLen: amendmentContext.length
 			}, "Amendment context loaded for phase");
@@ -8295,7 +8295,7 @@ async function runAmendAction(options) {
 	} catch (err) {
 		const msg = err instanceof Error ? err.message : String(err);
 		process.stderr.write(`Error: ${msg}\n`);
-		logger$13.error({ err }, "amend failed");
+		logger$14.error({ err }, "amend failed");
 		return 1;
 	} finally {
 		try {
@@ -9282,7 +9282,7 @@ function registerSupervisorCommand(program, _version = "0.0.0", projectRoot = pr
 
 //#endregion
 //#region src/cli/commands/metrics.ts
-const logger$12 = createLogger("metrics-cmd");
+const logger$13 = createLogger("metrics-cmd");
 async function openTelemetryAdapter(basePath) {
 	try {
 		const adapter = createDatabaseAdapter({
@@ -9648,7 +9648,7 @@ async function runMetricsAction(options) {
 					}
 				}
 			} catch (err) {
-				logger$12.debug({ err }, "getScenarioResultsForRun failed");
+				logger$13.debug({ err }, "getScenarioResultsForRun failed");
 			}
 			if (rows.length === 0) {
 				const msg = `No factory run found with id: ${run}`;
@@ -9684,7 +9684,7 @@ async function runMetricsAction(options) {
 						}
 					}
 				} catch (err) {
-					logger$12.debug({ err }, "getTwinRunsForRun failed — twin_runs table may not exist yet");
+					logger$13.debug({ err }, "getTwinRunsForRun failed — twin_runs table may not exist yet");
 				}
 			}
 			return 0;
@@ -9694,7 +9694,7 @@ async function runMetricsAction(options) {
 			try {
 				factoryRuns$1 = await getFactoryRunSummaries(adapter, limit);
 			} catch (err) {
-				logger$12.debug({ err }, "getFactoryRunSummaries failed in factory-only mode");
+				logger$13.debug({ err }, "getFactoryRunSummaries failed in factory-only mode");
 			}
 			if (outputFormat === "json") process.stdout.write(formatOutput({ graph_runs: factoryRuns$1 }, "json", true) + "\n");
 			else if (factoryRuns$1.length === 0) process.stdout.write("No factory runs recorded yet.\n");
@@ -9755,7 +9755,7 @@ async function runMetricsAction(options) {
 			doltMetrics = await stateStore.queryMetrics(doltFilter);
 			await stateStore.close();
 		} catch (doltErr) {
-			logger$12.warn({ err: doltErr }, "StateStore query failed — falling back to SQLite metrics only");
+			logger$13.warn({ err: doltErr }, "StateStore query failed — falling back to SQLite metrics only");
 		}
 		const storyMetricDecisions = await getDecisionsByCategory(adapter, STORY_METRICS);
 		const storyMetrics = storyMetricDecisions.map((d) => {
@@ -9817,7 +9817,7 @@ async function runMetricsAction(options) {
 		try {
 			factoryRuns = await getFactoryRunSummaries(adapter, limit);
 		} catch (err) {
-			logger$12.debug({ err }, "getFactoryRunSummaries failed — table may not exist in older databases");
+			logger$13.debug({ err }, "getFactoryRunSummaries failed — table may not exist in older databases");
 		}
 		if (outputFormat === "json") {
 			const runsWithBreakdown = runs.map((run$1) => ({
@@ -9955,7 +9955,7 @@ async function runMetricsAction(options) {
 		const msg = err instanceof Error ? err.message : String(err);
 		if (outputFormat === "json") process.stdout.write(formatOutput(null, "json", false, msg) + "\n");
 		else process.stderr.write(`Error: ${msg}\n`);
-		logger$12.error({ err }, "metrics action failed");
+		logger$13.error({ err }, "metrics action failed");
 		return 1;
 	} finally {
 		try {
@@ -10157,7 +10157,7 @@ function registerMigrateCommand(program) {
 function getLatestSessionId(_adapter) {
 	return null;
 }
-const logger$11 = createLogger("cost-cmd");
+const logger$12 = createLogger("cost-cmd");
 const COST_EXIT_SUCCESS = 0;
 const COST_EXIT_ERROR = 1;
 /**
@@ -10401,7 +10401,7 @@ async function runCostAction(options) {
 	} catch (err) {
 		const message = err instanceof Error ? err.message : String(err);
 		process.stderr.write(`Error: ${message}\n`);
-		logger$11.error({ err }, "runCostAction failed");
+		logger$12.error({ err }, "runCostAction failed");
 		return COST_EXIT_ERROR;
 	} finally {
 		if (adapter !== null) try {
@@ -10435,7 +10435,7 @@ function registerCostCommand(program, version = "0.0.0", projectRoot = process.c
 
 //#endregion
 //#region src/cli/commands/monitor.ts
-const logger$10 = createLogger("monitor-cmd");
+const logger$11 = createLogger("monitor-cmd");
 const MONITOR_EXIT_SUCCESS = 0;
 const MONITOR_EXIT_ERROR = 1;
 /**
@@ -10638,7 +10638,7 @@ async function runMonitorReportAction(options) {
 	} catch (err) {
 		const message = err instanceof Error ? err.message : String(err);
 		process.stderr.write(`Error: ${message}\n`);
-		logger$10.error({ err }, "runMonitorReportAction failed");
+		logger$11.error({ err }, "runMonitorReportAction failed");
 		return MONITOR_EXIT_ERROR;
 	} finally {
 		if (monitorDb !== null) try {
@@ -10700,7 +10700,7 @@ async function runMonitorStatusAction(options) {
 	} catch (err) {
 		const message = err instanceof Error ? err.message : String(err);
 		process.stderr.write(`Error: ${message}\n`);
-		logger$10.error({ err }, "runMonitorStatusAction failed");
+		logger$11.error({ err }, "runMonitorStatusAction failed");
 		return MONITOR_EXIT_ERROR;
 	} finally {
 		if (monitorDb !== null) try {
@@ -10735,7 +10735,7 @@ async function runMonitorResetAction(options) {
 	} catch (err) {
 		const message = err instanceof Error ? err.message : String(err);
 		process.stderr.write(`Error: ${message}\n`);
-		logger$10.error({ err }, "runMonitorResetAction failed");
+		logger$11.error({ err }, "runMonitorResetAction failed");
 		return MONITOR_EXIT_ERROR;
 	} finally {
 		if (monitorDb !== null) try {
@@ -10783,7 +10783,7 @@ async function runMonitorRecommendationsAction(options) {
 	} catch (err) {
 		const message = err instanceof Error ? err.message : String(err);
 		process.stderr.write(`Error: ${message}\n`);
-		logger$10.error({ err }, "runMonitorRecommendationsAction failed");
+		logger$11.error({ err }, "runMonitorRecommendationsAction failed");
 		return MONITOR_EXIT_ERROR;
 	} finally {
 		if (monitorDb !== null) try {
@@ -10861,7 +10861,7 @@ function registerMonitorCommand(program, version = "0.0.0", projectRoot = proces
 
 //#endregion
 //#region src/cli/commands/merge.ts
-const logger$9 = createLogger("merge-cmd");
+const logger$10 = createLogger("merge-cmd");
 const MERGE_EXIT_SUCCESS = 0;
 const MERGE_EXIT_CONFLICT = 1;
 const MERGE_EXIT_ERROR = 2;
@@ -10899,7 +10899,7 @@ async function mergeTask(taskId, targetBranch, projectRoot) {
 		projectRoot
 	});
 	try {
-		logger$9.info({
+		logger$10.info({
 			taskId,
 			targetBranch
 		}, "Running conflict detection...");
@@ -10921,7 +10921,7 @@ async function mergeTask(taskId, targetBranch, projectRoot) {
 	} catch (err) {
 		const message = err instanceof Error ? err.message : String(err);
 		console.error(`Error merging task "${taskId}": ${message}`);
-		logger$9.error({
+		logger$10.error({
 			taskId,
 			err
 		}, "merge --task failed");
@@ -10975,7 +10975,7 @@ async function mergeAll(targetBranch, projectRoot, taskIds) {
 			error: message
 		});
 		console.log(`  Error for task "${taskId}": ${message}`);
-		logger$9.error({
+		logger$10.error({
 			taskId,
 			err
 		}, "merge --all: task failed");
@@ -11028,7 +11028,7 @@ function registerMergeCommand(program, projectRoot = process.cwd()) {
 
 //#endregion
 //#region src/cli/commands/worktrees.ts
-const logger$8 = createLogger("worktrees-cmd");
+const logger$9 = createLogger("worktrees-cmd");
 const WORKTREES_EXIT_SUCCESS = 0;
 const WORKTREES_EXIT_ERROR = 1;
 /** Valid task statuses for filtering */
@@ -11155,7 +11155,7 @@ async function listWorktreesAction(options) {
 		try {
 			worktreeInfos = await manager.listWorktrees();
 		} catch (err) {
-			logger$8.error({ err }, "Failed to list worktrees");
+			logger$9.error({ err }, "Failed to list worktrees");
 			const message = err instanceof Error ? err.message : String(err);
 			process.stderr.write(`Error listing worktrees: ${message}\n`);
 			return WORKTREES_EXIT_ERROR;
@@ -11182,7 +11182,7 @@ async function listWorktreesAction(options) {
 	} catch (err) {
 		const message = err instanceof Error ? err.message : String(err);
 		process.stderr.write(`Error: ${message}\n`);
-		logger$8.error({ err }, "listWorktreesAction failed");
+		logger$9.error({ err }, "listWorktreesAction failed");
 		return WORKTREES_EXIT_ERROR;
 	}
 }
@@ -11223,7 +11223,7 @@ function registerWorktreesCommand(program, version = "0.0.0", projectRoot = proc
 
 //#endregion
 //#region src/cli/commands/brainstorm.ts
-const logger$7 = createLogger("brainstorm-cmd");
+const logger$8 = createLogger("brainstorm-cmd");
 /**
 * Detect whether the project has existing planning artifacts that indicate
 * this is an amendment session (vs. a brand-new project brainstorm).
@@ -11269,13 +11269,13 @@ async function loadAmendmentContextDocuments(projectRoot) {
 	try {
 		brief = await readFile(briefPath, "utf-8");
 	} catch {
-		logger$7.warn({ briefPath }, "product-brief.md not found — continuing without brief context");
+		logger$8.warn({ briefPath }, "product-brief.md not found — continuing without brief context");
 		process.stderr.write(`Warning: product-brief.md not found at ${briefPath}\n`);
 	}
 	try {
 		prd = await readFile(prdPath, "utf-8");
 	} catch {
-		logger$7.warn({ prdPath }, "requirements.md not found — continuing without PRD context");
+		logger$8.warn({ prdPath }, "requirements.md not found — continuing without PRD context");
 		process.stderr.write(`Warning: requirements.md not found at ${prdPath}\n`);
 	}
 	return {
@@ -11484,7 +11484,7 @@ async function dispatchToPersonas(userPrompt, context, llmDispatch) {
 		}
 	];
 	const defaultDispatch = async (prompt, personaName) => {
-		logger$7.debug({
+		logger$8.debug({
 			personaName,
 			promptLength: prompt.length
 		}, "Dispatching to persona (stub mode)");
@@ -11501,7 +11501,7 @@ async function dispatchToPersonas(userPrompt, context, llmDispatch) {
 			};
 		} catch (err) {
 			const msg = err instanceof Error ? err.message : String(err);
-			logger$7.error({
+			logger$8.error({
 				err,
 				personaName: persona.name
 			}, "Persona dispatch failed");
@@ -11653,7 +11653,7 @@ async function runBrainstormSession(options, llmDispatch, rlInterface) {
 			}
 		});
 		rl.on("error", (err) => {
-			logger$7.error({ err }, "readline error");
+			logger$8.error({ err }, "readline error");
 			if (!sessionEnded) endSession(false);
 		});
 	});
@@ -11694,7 +11694,7 @@ function registerBrainstormCommand(program, _version = "0.0.0", projectRoot = pr
 
 //#endregion
 //#region src/cli/commands/retry-escalated.ts
-const logger$6 = createLogger("retry-escalated-cmd");
+const logger$7 = createLogger("retry-escalated-cmd");
 async function runRetryEscalatedAction(options) {
 	const { runId, dryRun, force, outputFormat, projectRoot, concurrency, pack: packName, registry: injectedRegistry, agent: agentId, events: eventsFlag } = options;
 	const dbRoot = await resolveMainRepoRoot(projectRoot);
@@ -11735,7 +11735,7 @@ async function runRetryEscalatedAction(options) {
 					process.stdout.write(`[INFO] ${storyKey}: Context ceiling set to ${contextCeiling} tokens due to prior context spike pattern.\n`);
 				}
 			} catch (err) {
-				logger$6.warn({
+				logger$7.warn({
 					err,
 					storyKey
 				}, "Failed to read efficiency profile — skipping gate");
@@ -11889,11 +11889,11 @@ async function runRetryEscalatedAction(options) {
 						output_tokens: output,
 						cost_usd: costUsd
 					}).catch((err) => {
-						logger$6.warn({ err }, "Failed to record token usage");
+						logger$7.warn({ err }, "Failed to record token usage");
 					});
 				}
 			} catch (err) {
-				logger$6.warn({ err }, "Failed to record token usage");
+				logger$7.warn({ err }, "Failed to record token usage");
 			}
 		});
 		if (outputFormat === "human") {
@@ -11922,7 +11922,7 @@ async function runRetryEscalatedAction(options) {
 		const msg = err instanceof Error ? err.message : String(err);
 		if (outputFormat === "json") process.stdout.write(formatOutput(null, "json", false, msg) + "\n");
 		else process.stderr.write(`Error: ${msg}\n`);
-		logger$6.error({ err }, "retry-escalated failed");
+		logger$7.error({ err }, "retry-escalated failed");
 		return 1;
 	} finally {
 		try {
@@ -11955,7 +11955,7 @@ function registerRetryEscalatedCommand(program, _version = "0.0.0", projectRoot
 
 //#endregion
 //#region src/cli/commands/cancel.ts
-const logger$5 = createLogger("cancel-cmd");
+const logger$6 = createLogger("cancel-cmd");
 async function runCancelAction(options) {
 	const { outputFormat, projectRoot, force } = options;
 	const dbRoot = await resolveMainRepoRoot(projectRoot);
@@ -11994,7 +11994,7 @@ async function runCancelAction(options) {
 		}
 	} catch (err) {
 		const msg = err instanceof Error ? err.message : String(err);
-		logger$5.warn({
+		logger$6.warn({
 			pid,
 			err: msg
 		}, "Failed to kill orchestrator");
@@ -12024,7 +12024,7 @@ async function runCancelAction(options) {
 			await adapter.close();
 		}
 	} catch (err) {
-		logger$5.warn({ err }, "Could not update pipeline run status (non-fatal)");
+		logger$6.warn({ err }, "Could not update pipeline run status (non-fatal)");
 	}
 	if (outputFormat === "json") process.stdout.write(formatOutput({
 		cancelled: true,
@@ -12108,10 +12108,10 @@ function registerContractsCommand(program) {
 				r.verificationStatus
 			]);
 			const colWidths = headers.map((h, i) => Math.max(h.length, ...rows.map((r) => (r[i] ?? "").length)));
-			const formatRow = (cells) => cells.map((c, i) => c.padEnd(colWidths[i])).join("  ");
-			console.log(formatRow(headers));
+			const formatRow$1 = (cells) => cells.map((c, i) => c.padEnd(colWidths[i])).join("  ");
+			console.log(formatRow$1(headers));
 			console.log(colWidths.map((w) => "-".repeat(w)).join("  "));
-			for (const row of rows) console.log(formatRow(row));
+			for (const row of rows) console.log(formatRow$1(row));
 		} finally {
 			await store.close();
 		}
@@ -12378,7 +12378,7 @@ function emitDiff(diff, ctx) {
 
 //#endregion
 //#region src/cli/commands/probe-author.ts
-const logger$4 = createLogger("cli:probe-author");
+const logger$5 = createLogger("cli:probe-author");
 /**
 * A minimum-viable logger that routes everything to stderr. Used by the
 * subcommand to keep stdout reserved for the JSON result payload.
@@ -12447,7 +12447,7 @@ async function runProbeAuthorDispatch(opts, projectRoot, registry) {
 		logger: stderrLogger
 	});
 	const workingDir = opts.workingDir !== void 0 ? resolve$1(opts.workingDir) : resolve$1(storyFilePath, "..");
-	logger$4.info({
+	logger$5.info({
 		storyKey: opts.storyKey,
 		storyFile: storyFilePath,
 		epicFile: epicFilePath,
@@ -12628,7 +12628,7 @@ function registerHistoryCommand(program) {
 
 //#endregion
 //#region src/cli/commands/repo-map.ts
-const logger$3 = createLogger("cli:repo-map");
+const logger$4 = createLogger("cli:repo-map");
 /** Validate that a symbol name contains only safe identifier characters. */
 function isValidSymbolName(name) {
 	return /^[a-zA-Z0-9_]+$/.test(name);
@@ -12663,15 +12663,15 @@ function registerRepoMapCommand(program) {
 			const colRows = await doltClient.query(`SHOW COLUMNS FROM repo_map_symbols LIKE 'dependencies'`);
 			if (colRows.length === 0) {
 				await doltClient.query(`ALTER TABLE repo_map_symbols ADD COLUMN dependencies JSON`);
-				logger$3.info("Applied migration: added dependencies column to repo_map_symbols");
+				logger$4.info("Applied migration: added dependencies column to repo_map_symbols");
 			}
 		} catch {
-			logger$3.debug("Skipping repo_map_symbols migration: table not yet created");
+			logger$4.debug("Skipping repo_map_symbols migration: table not yet created");
 		}
-		const symbolRepo = new DoltSymbolRepository(doltClient, logger$3);
+		const symbolRepo = new DoltSymbolRepository(doltClient, logger$4);
 		const metaRepo = new DoltRepoMapMetaRepository(doltClient);
-		const repoMapModule = new RepoMapModule(metaRepo, logger$3);
-		const queryEngine = new RepoMapQueryEngine(symbolRepo, logger$3);
+		const repoMapModule = new RepoMapModule(metaRepo, logger$4);
+		const queryEngine = new RepoMapQueryEngine(symbolRepo, logger$4);
 		if (options.show === true || !options.update && !options.query && !options.dryRun) {
 			const meta = await metaRepo.getMeta();
 			const staleResult = await repoMapModule.checkStaleness();
@@ -12697,9 +12697,9 @@ function registerRepoMapCommand(program) {
 			return;
 		}
 		if (options.update === true) {
-			logger$3.info("repo-map --update: triggering incremental update");
-			const gitClient = new GitClient(logger$3);
-			const grammarLoader = new GrammarLoader(logger$3);
+			logger$4.info("repo-map --update: triggering incremental update");
+			const gitClient = new GitClient(logger$4);
+			const grammarLoader = new GrammarLoader(logger$4);
 			if (grammarLoader.getGrammar(".ts") === null) {
 				const msg = "tree-sitter grammars not installed. Run `npm install tree-sitter tree-sitter-typescript tree-sitter-javascript tree-sitter-python` in the substrate installation directory.";
 				if (options.outputFormat === "json") console.log(JSON.stringify({
@@ -12710,15 +12710,15 @@ function registerRepoMapCommand(program) {
 				process.exitCode = 1;
 				return;
 			}
-			const parser = new SymbolParser(grammarLoader, logger$3);
-			const storage = new RepoMapStorage(symbolRepo, metaRepo, gitClient, logger$3);
+			const parser = new SymbolParser(grammarLoader, logger$4);
+			const storage = new RepoMapStorage(symbolRepo, metaRepo, gitClient, logger$4);
 			let updateWarning;
 			try {
 				await storage.incrementalUpdate(dbRoot, parser);
 			} catch (err) {
 				if (err instanceof AppError && err.code === ERR_REPO_MAP_STORAGE_WRITE) {
 					updateWarning = err.message;
-					logger$3.warn({ err }, "repo-map --update: storage write error (partial update)");
+					logger$4.warn({ err }, "repo-map --update: storage write error (partial update)");
 				} else throw err;
 			}
 			const meta = await metaRepo.getMeta();
@@ -12738,7 +12738,7 @@ function registerRepoMapCommand(program) {
 			return;
 		}
 		if (options.query !== void 0) {
-			logger$3.debug({ symbol: options.query }, "repo-map --query");
+			logger$4.debug({ symbol: options.query }, "repo-map --query");
 			const result = await queryEngine.query({
 				symbols: [options.query],
 				maxTokens: 4e3
@@ -12760,7 +12760,7 @@ function registerRepoMapCommand(program) {
 				process.exitCode = 1;
 				return;
 			}
-			const injector = new RepoMapInjector(queryEngine, logger$3);
+			const injector = new RepoMapInjector(queryEngine, logger$4);
 			const injectionResult = await injector.buildContext(storyContent, 2e3);
 			console.log(JSON.stringify({
 				text: injectionResult.text,
@@ -12774,7 +12774,7 @@ function registerRepoMapCommand(program) {
 
 //#endregion
 //#region src/cli/commands/routing.ts
-const logger$2 = createLogger("cli:routing");
+const logger$3 = createLogger("cli:routing");
 function registerRoutingCommand(program) {
 	program.command("routing").description("Show routing configuration and auto-tune history").option("--history", "Show the routing auto-tune log (model changes applied)").option("--output-format <format>", "Output format: text or json", "text").action(async (options) => {
 		const dbRoot = await resolveMainRepoRoot(process.cwd());
@@ -12791,7 +12791,7 @@ function registerRoutingCommand(program) {
 		try {
 			await store.initialize();
 			if (options.history === true) {
-				logger$2.debug("routing --history: fetching tune log");
+				logger$3.debug("routing --history: fetching tune log");
 				const raw$1 = await store.getMetric("global", "routing_tune_log");
 				let entries = [];
 				if (Array.isArray(raw$1)) entries = raw$1.sort((a, b) => b.appliedAt.localeCompare(a.appliedAt));
@@ -13128,7 +13128,7 @@ function registerFactoryCommand$1(program) {
 
 //#endregion
 //#region src/cli/commands/reconcile-from-disk.ts
-const logger$1 = createLogger("reconcile-from-disk");
+const logger$2 = createLogger("reconcile-from-disk");
 /** 64KB tail window for capturing subprocess stderr/stdout (Story 66-5 pattern). */
 const MAX_OUTPUT_BYTES = 64 * 1024;
 /**
@@ -13191,7 +13191,7 @@ async function readRunEntry(dbRoot, resolvedRunId) {
 			stories
 		};
 	} catch {
-		logger$1.debug({ runId: resolvedRunId }, "failed to read individual run manifest");
+		logger$2.debug({ runId: resolvedRunId }, "failed to read individual run manifest");
 		return null;
 	}
 }
@@ -13324,7 +13324,7 @@ async function runReconcileFromDiskAction(options) {
 			const latestRun = await getLatestRun(probeAdapter);
 			if (latestRun?.id) resolvedRunId = latestRun.id;
 		} catch {
-			logger$1.debug("Dolt fallback failed during run-id resolution");
+			logger$2.debug("Dolt fallback failed during run-id resolution");
 		} finally {
 			await probeAdapter.close().catch(() => {});
 		}
@@ -13405,7 +13405,7 @@ async function runReconcileFromDiskAction(options) {
 			stdoutTail: failedGateResult?.stdoutTail,
 			durationMs: durationMs$1
 		});
-		logger$1.info({
+		logger$2.info({
 			runId: resolvedRunId,
 			failedGate: failedGateName,
 			exitCode: failedGateResult?.exitCode
@@ -13463,7 +13463,7 @@ async function runReconcileFromDiskAction(options) {
 				resolvedRunId
 			]);
 		});
-		logger$1.info({
+		logger$2.info({
 			runId: resolvedRunId,
 			affectedStories: reconcilableRecords.map((r) => r.storyKey)
 		}, "reconcile-from-disk: Dolt update complete");
@@ -13516,6 +13516,449 @@ function registerReconcileFromDiskCommand(program, _version = "0.0.0", projectRo
 	});
 }
 
+//#endregion
+//#region src/cli/commands/report.ts
+const logger$1 = createLogger("report");
+/**
+* Determine whether verification ran for a story.
+*
+* Handles both real manifest format (checks array) and probe fixture format
+* (explicit verification_ran boolean).
+*/
+function didVerificationRun(state) {
+	const vr = state.verification_result;
+	if (!vr) return false;
+	if (typeof vr.verification_ran === "boolean") return vr.verification_ran;
+	if (Array.isArray(vr.checks)) return vr.checks.length > 0;
+	return false;
+}
+/**
+* Extract aggregated finding counts from a story's verification result.
+*
+* Handles both real manifest format (checks[].findings[]) and probe fixture
+* format (error_count / warn_count / info_count + flat findings[]).
+*/
+function extractVerificationFindings(state) {
+	const vr = state.verification_result;
+	if (!vr) return {
+		error: 0,
+		warn: 0,
+		info: 0,
+		byAuthor: {}
+	};
+	const byAuthor = {};
+	if (typeof vr.error_count === "number" || typeof vr.warn_count === "number") {
+		const error$1 = vr.error_count ?? 0;
+		const warn$1 = vr.warn_count ?? 0;
+		const info$1 = vr.info_count ?? 0;
+		const findings = vr.findings ?? [];
+		for (const f of findings) {
+			const author = f._authoredBy ?? "unknown";
+			byAuthor[author] = (byAuthor[author] ?? 0) + 1;
+		}
+		return {
+			error: error$1,
+			warn: warn$1,
+			info: info$1,
+			byAuthor
+		};
+	}
+	let error = 0;
+	let warn = 0;
+	let info = 0;
+	const allChecks = vr.checks ?? [];
+	for (const check of allChecks) for (const f of check.findings ?? []) {
+		if (f.severity === "error") error++;
+		else if (f.severity === "warn") warn++;
+		else if (f.severity === "info") info++;
+		const author = f._authoredBy ?? "unknown";
+		byAuthor[author] = (byAuthor[author] ?? 0) + 1;
+	}
+	return {
+		error,
+		warn,
+		info,
+		byAuthor
+	};
+}
+/**
+* Classify a story outcome based on its state in the manifest.
+*
+* Rules (AC3):
+* - `verified`  — status='complete' AND verification ran AND no error findings AND review_cycles=0
+* - `recovered` — status='complete' AND (verification_ran=false OR review_cycles>0)
+* - `escalated` — status='escalated'
+* - `failed`    — status='failed' (or any other non-complete, non-escalated status)
+*
+* This function is pure (no filesystem / Dolt access) and exported for unit testing.
+*/
+function classifyStoryOutcome(state, _manifest) {
+	if (state.status === "escalated") return "escalated";
+	if (state.status === "failed") return "failed";
+	if (state.status === "complete") {
+		const verificationRan = didVerificationRun(state);
+		if (!verificationRan) return "recovered";
+		const findings = extractVerificationFindings(state);
+		const hasErrors = findings.error > 0;
+		const reviewCycles = state.review_cycles ?? 0;
+		if (!hasErrors && reviewCycles === 0) return "verified";
+		return "recovered";
+	}
+	return "failed";
+}
+/**
+* Build escalation diagnostic enrichment for a story (AC4).
+*
+* Maps escalation_reason to operator-actionable suggestions.
+*/
+function enrichEscalation(storyKey, state, runId, manifest) {
+	const root_cause = state.escalation_reason ?? "unknown";
+	const recovery_attempts = state.review_cycles ?? (manifest.recovery_history ?? []).filter((e) => e.story_key === storyKey).length;
+	const blast_radius = `Story ${storyKey} in run ${runId} — ${recovery_attempts} recovery attempt(s)`;
+	let suggested_operator_action;
+	switch (root_cause) {
+		case "checkpoint-retry-timeout":
+			suggested_operator_action = `Run \`substrate reconcile-from-disk --run ${runId}\` (Epic 69) — implementation may have shipped before timeout; gates will validate.`;
+			break;
+		case "verification-fail-after-cycles":
+			suggested_operator_action = `Read findings via \`substrate metrics --run ${runId} --findings\`; consider --max-review-cycles 3 retry.`;
+			break;
+		case "dispatch:spawnsync-timeout":
+			suggested_operator_action = `Agent dispatch timed out. Check system load and retry with \`substrate run --events --stories ${storyKey}\`.`;
+			break;
+		case "cost-ceiling-exceeded":
+			suggested_operator_action = `Cost ceiling was exceeded. Raise --cost-ceiling or break the story into smaller units before retrying.`;
+			break;
+		default: suggested_operator_action = `Inspect escalation details with \`substrate metrics --run ${runId}\` and manually review the story work before retrying.`;
+	}
+	return {
+		story_key: storyKey,
+		root_cause,
+		recovery_attempts,
+		suggested_operator_action,
+		blast_radius
+	};
+}
+/** Pad a string to a fixed width, truncating with '…' if necessary. */
+function padCell(value, width) {
+	if (value.length > width) return value.slice(0, width - 1) + "…";
+	return value.padEnd(width);
+}
+/** Format a row of columns with fixed widths, separated by ' | '. */
+function formatRow(cells, widths) {
+	return cells.map((c, i) => padCell(c, widths[i] ?? c.length)).join(" | ");
+}
+function formatDurationMs(ms) {
+	if (ms < 1e3) return `${ms}ms`;
+	if (ms < 6e4) return `${(ms / 1e3).toFixed(1)}s`;
+	const mins = Math.floor(ms / 6e4);
+	const secs = Math.floor(ms % 6e4 / 1e3);
+	return `${mins}m${secs}s`;
+}
+function wallClockMs(state) {
+	if (!state.started_at || !state.completed_at) return void 0;
+	const start = new Date(state.started_at).getTime();
+	const end = new Date(state.completed_at).getTime();
+	return isNaN(start) || isNaN(end) ? void 0 : end - start;
+}
+function renderHuman(output, manifest) {
+	const lines = [];
+	const { runId, summary, stories, escalations, cost, duration } = output;
+	const durationStr = duration.wall_clock_ms != null ? formatDurationMs(duration.wall_clock_ms) : "unknown";
+	const costStr = `$${cost.spent.toFixed(4)}`;
+	const ceilingStr = cost.ceiling != null ? ` / $${cost.ceiling.toFixed(4)} ceiling (${cost.utilization ?? "?"}) ${cost.overCeiling ? "[OVER CEILING]" : ""}` : "";
+	const verdict = summary.escalated > 0 || summary.failed > 0 ? "NEEDS ATTENTION" : "ALL PASSED";
+	lines.push(`══════════════════════════════════════════════════════════`);
+	lines.push(`  Run: ${runId}`);
+	lines.push(`  Duration: ${durationStr}`);
+	lines.push(`  Cost: ${costStr}${ceilingStr}`);
+	lines.push(`  Verdict: ${verdict}`);
+	lines.push(`══════════════════════════════════════════════════════════`);
+	lines.push("");
+	lines.push(`${summary.verified} verified, ${summary.recovered} recovered, ${summary.escalated} escalated, ${summary.failed} failed of ${summary.total} total`);
+	lines.push("");
+	const COL_WIDTHS = [
+		50,
+		10,
+		10,
+		8,
+		10,
+		14,
+		10
+	];
+	const HEADERS = [
+		"story_key",
+		"outcome",
+		"wall-clock",
+		"cycles",
+		"cost",
+		"findings",
+		"verified"
+	];
+	lines.push(formatRow(HEADERS, COL_WIDTHS));
+	lines.push(COL_WIDTHS.map((w) => "-".repeat(w)).join("-+-"));
+	for (const s of stories) {
+		const wallClock = s.wall_clock_ms != null ? formatDurationMs(s.wall_clock_ms) : "-";
+		const costCell = s.cost_usd != null ? `$${s.cost_usd.toFixed(4)}` : "-";
+		const f = s.verification_findings;
+		const findingsCell = `E:${f.error} W:${f.warn} I:${f.info}`;
+		const verifiedTag = s.outcome === "verified" ? "✓" : "";
+		const key = s.story_key.length > 50 ? s.story_key.slice(0, 49) + "…" : s.story_key;
+		lines.push(formatRow([
+			key,
+			s.outcome,
+			wallClock,
+			String(s.review_cycles),
+			costCell,
+			findingsCell,
+			verifiedTag
+		], COL_WIDTHS));
+	}
+	lines.push("");
+	if (escalations.length > 0) {
+		lines.push("──── Escalation Details ────");
+		for (const esc of escalations) {
+			lines.push("");
+			lines.push(`  Story:              ${esc.story_key}`);
+			lines.push(`  Root cause:         ${esc.root_cause}`);
+			lines.push(`  Recovery attempts:  ${esc.recovery_attempts}`);
+			lines.push(`  Blast radius:       ${esc.blast_radius}`);
+			lines.push(`  Suggested action:   ${esc.suggested_operator_action}`);
+		}
+		lines.push("");
+	}
+	return lines.join("\n");
+}
+function renderJson(output) {
+	return JSON.stringify(output, null, 2);
+}
+/**
+* Build ReportOutput from a raw manifest.
+*/
+function assembleReport(runId, manifest) {
+	const perStoryState = manifest.per_story_state ?? {};
+	const storyKeys = Object.keys(perStoryState);
+	const startedAt = manifest.created_at ?? "";
+	const completedAt = manifest.updated_at;
+	let totalWallMs;
+	if (startedAt && completedAt) {
+		const s = new Date(startedAt).getTime();
+		const e = new Date(completedAt).getTime();
+		if (!isNaN(s) && !isNaN(e)) totalWallMs = e - s;
+	}
+	const duration = {
+		started_at: startedAt,
+		completed_at: completedAt,
+		wall_clock_ms: totalWallMs
+	};
+	const spent = manifest.cost_accumulation?.run_total ?? 0;
+	const ceiling = manifest.cost_accumulation != null ? manifest.cli_flags?.cost_ceiling : void 0;
+	const utilization = ceiling != null && ceiling > 0 ? `${(spent / ceiling * 100).toFixed(1)}%` : void 0;
+	const overCeiling = ceiling != null ? spent > ceiling : false;
+	const cost = {
+		spent,
+		ceiling,
+		utilization,
+		overCeiling
+	};
+	const stories = [];
+	const escalations = [];
+	const summary = {
+		verified: 0,
+		recovered: 0,
+		escalated: 0,
+		failed: 0,
+		total: 0
+	};
+	for (const key of storyKeys) {
+		const state = perStoryState[key];
+		const outcome = classifyStoryOutcome(state, manifest);
+		const findings = extractVerificationFindings(state);
+		const verificationRan = didVerificationRun(state);
+		const wc = wallClockMs(state);
+		const storySummary = {
+			story_key: key,
+			outcome,
+			wall_clock_ms: wc,
+			review_cycles: state.review_cycles ?? 0,
+			cost_usd: state.cost_usd,
+			verification_findings: findings,
+			verification_ran: verificationRan
+		};
+		stories.push(storySummary);
+		summary[outcome]++;
+		summary.total++;
+		if (outcome === "escalated") escalations.push(enrichEscalation(key, state, runId, manifest));
+	}
+	return {
+		runId,
+		summary,
+		stories,
+		escalations,
+		cost,
+		duration
+	};
+}
+/**
+* Read a single run manifest file directly (without strict Zod schema).
+* Handles both real manifests and probe fixture simplified formats.
+*/
+async function readRawManifest(runsDir, runId) {
+	const directPath = join(runsDir, `${runId}.json`);
+	try {
+		const raw = await readFile(directPath, "utf-8");
+		const parsed = JSON.parse(raw);
+		if (parsed != null && typeof parsed === "object" && !Array.isArray(parsed)) {
+			const m = parsed;
+			if (typeof m.run_id === "string" && typeof m.per_story_state === "object") return m;
+		}
+	} catch {}
+	try {
+		const entries = await readdir(runsDir);
+		for (const entry of entries) {
+			if (!entry.endsWith(".json") || entry === "manifest.json") continue;
+			const filePath = join(runsDir, entry);
+			try {
+				const raw = await readFile(filePath, "utf-8");
+				const parsed = JSON.parse(raw);
+				if (parsed != null && typeof parsed === "object" && !Array.isArray(parsed)) {
+					const m = parsed;
+					if (m.run_id === runId && typeof m.per_story_state === "object") return m;
+				}
+			} catch {}
+		}
+	} catch {}
+	return null;
+}
+/**
+* Resolve the latest run ID via canonical chain (Story 71-2 hot-fix).
+*
+* Replaces Story 71-1's invented `.substrate/runs/manifest.json` aggregate
+* format with the canonical chain used by status.ts / health.ts /
+* reconcile-from-disk:
+*   1. `.substrate/current-run-id` is consulted by resolveRunManifest at the
+*      caller's site (not here); this helper handles the post-current-run-id
+*      fallback.
+*   2. `getLatestRun(adapter)` Dolt fallback — the canonical persistence
+*      source. Opens a temporary adapter and closes it before returning.
+*
+* Returns null when neither chain link yields a run ID.
+*/
+async function resolveLatestRunId(dbRoot) {
+	const probeAdapter = createDatabaseAdapter({
+		backend: "auto",
+		basePath: dbRoot
+	});
+	try {
+		await initSchema(probeAdapter);
+		const latest = await getLatestRun(probeAdapter);
+		return latest?.id ?? null;
+	} catch {
+		logger$1.debug("Dolt fallback failed during run-id resolution");
+		return null;
+	} finally {
+		await probeAdapter.close().catch(() => {});
+	}
+}
+async function runReportAction(options) {
+	const { run: runArg, outputFormat, projectRoot, _dbRoot } = options;
+	const effectiveProjectRoot = process.env["SUBSTRATE_PROJECT_ROOT"] ?? projectRoot;
+	const dbRoot = _dbRoot ?? await resolveMainRepoRoot(effectiveProjectRoot);
+	const runsDir = join(dbRoot, ".substrate", "runs");
+	logger$1.debug({
+		runArg,
+		effectiveProjectRoot,
+		dbRoot
+	}, "report action start");
+	let resolvedRunId = null;
+	let manifest = null;
+	const isExplicitId = runArg != null && runArg !== "latest";
+	if (isExplicitId) {
+		resolvedRunId = runArg;
+		const canonical = await resolveRunManifest(dbRoot, resolvedRunId);
+		if (canonical.manifest) try {
+			const data = await canonical.manifest.read();
+			manifest = data;
+		} catch {
+			logger$1.debug({ runId: resolvedRunId }, "canonical manifest read failed — using raw shim");
+		}
+		if (!manifest) manifest = await readRawManifest(runsDir, resolvedRunId);
+	} else {
+		const canonical = await resolveRunManifest(dbRoot, void 0);
+		if (canonical.runId && canonical.manifest) {
+			resolvedRunId = canonical.runId;
+			try {
+				const data = await canonical.manifest.read();
+				manifest = data;
+			} catch {
+				logger$1.debug({ runId: canonical.runId }, "canonical manifest read failed — using raw shim");
+				manifest = null;
+			}
+		}
+		if (!resolvedRunId) {
+			resolvedRunId = await resolveLatestRunId(dbRoot);
+			if (resolvedRunId) {
+				const reread = await resolveRunManifest(dbRoot, resolvedRunId);
+				if (reread.manifest) try {
+					const data = await reread.manifest.read();
+					manifest = data;
+				} catch {
+					logger$1.debug({ runId: resolvedRunId }, "manifest read failed after Dolt resolution");
+				}
+				if (!manifest) manifest = await readRawManifest(runsDir, resolvedRunId);
+			}
+		}
+		if (!resolvedRunId) {
+			process.stderr.write("No runs found. Run `substrate run` to start a pipeline.\n");
+			return 1;
+		}
+		if (!manifest) manifest = await readRawManifest(runsDir, resolvedRunId);
+	}
+	if (!manifest) {
+		process.stderr.write(`No runs found. Run ID "${resolvedRunId}" not found in ${runsDir}.\nRun \`substrate run\` to start a pipeline.
+`);
+		return 1;
+	}
+	const statePath = join(dbRoot, ".substrate", "state");
+	if (existsSync$1(join(statePath, ".dolt"))) try {
+		const doltClient = new DoltClient({ repoPath: statePath });
+		const storyKeys = Object.keys(manifest.per_story_state);
+		if (storyKeys.length > 0) {
+			const placeholders = storyKeys.map(() => "?").join(", ");
+			const rows = await doltClient.query(`SELECT story_key, completed_at FROM wg_stories WHERE story_key IN (${placeholders})`, storyKeys);
+			for (const row of rows) {
+				const state = manifest.per_story_state[row.story_key];
+				if (state && !state.completed_at && row.completed_at) state.completed_at = row.completed_at;
+			}
+			logger$1.debug({ storyCount: rows.length }, "Dolt wg_stories enrichment applied");
+		}
+	} catch (err) {
+		logger$1.debug({ err }, "Dolt enrichment unavailable — using manifest-only data (degraded mode)");
+	}
+	const output = assembleReport(resolvedRunId, manifest);
+	if (outputFormat === "json") process.stdout.write(renderJson(output) + "\n");
+	else process.stdout.write(renderHuman(output, manifest));
+	return 0;
+}
+/**
+* Register the `substrate report` command.
+*
+* Signature mirrors `registerReconcileFromDiskCommand` (Epic 69 Story 69-1)
+* for uniform CLI registration shape. `registry` is present for signature
+* uniformity even though this command does not use it.
+*/
+function registerReportCommand(program, _version = "0.0.0", projectRoot = process.cwd(), _registry) {
+	program.command("report").description("Read run manifest and produce a structured completion report").option("--run <id|latest>", "Run ID to report on, or \"latest\" (default: current-run-id file, then Dolt getLatestRun fallback)").option("--output-format <format>", "Output format: human (default) or json", "human").action(async (opts) => {
+		const outputFormat = opts.outputFormat === "json" ? "json" : "human";
+		const exitCode = await runReportAction({
+			run: opts.run,
+			outputFormat,
+			projectRoot
+		});
+		process.exitCode = exitCode;
+	});
+}
+
 //#endregion
 //#region src/cli/index.ts
 process.setMaxListeners(20);
@@ -13585,6 +14028,7 @@ async function createProgram() {
 	registerScenariosCommand(program);
 	registerFactoryCommand$1(program);
 	registerReconcileFromDiskCommand(program, version, process.cwd(), registry);
+	registerReportCommand(program, version, process.cwd(), registry);
 	registerUpgradeCommand(program);
 	return program;
 }