substrate-ai 0.2.15 → 0.2.17

package/dist/{run-CoP8UQU3.js → run-CLpXJNQ8.js}

@@ -1,12 +1,13 @@
-import { createLogger } from "./logger-C6n1g8uP.js";
-import { AdapterRegistry, createEventBus, createTuiApp, isTuiCapable, printNonTtyWarning } from "./event-bus-J-bw-pkp.js";
-import { addTokenUsage, createDecision, createPipelineRun, createRequirement, getArtifactByTypeForRun, getArtifactsByRun, getDecisionsByPhase, getDecisionsByPhaseForRun, getPipelineRunById, getTokenUsageSummary, registerArtifact, updatePipelineRun, updatePipelineRunConfig, upsertDecision } from "./decisions-DNYByk0U.js";
-import { aggregateTokenUsageForRun, aggregateTokenUsageForStory, getStoryMetricsForRun, writeRunMetrics, writeStoryMetrics } from "./metrics-BSg8VIHd.js";
+import { createLogger } from "./logger-D2fS2ccL.js";
+import { AdapterRegistry, createEventBus, createTuiApp, isTuiCapable, printNonTtyWarning } from "./event-bus-BMxhfxfT.js";
+import { addTokenUsage, createDecision, createPipelineRun, createRequirement, getArtifactByTypeForRun, getArtifactsByRun, getDecisionsByPhase, getDecisionsByPhaseForRun, getLatestRun, getPipelineRunById, getRunningPipelineRuns, getTokenUsageSummary, registerArtifact, updatePipelineRun, updatePipelineRunConfig, upsertDecision } from "./decisions-Dq4cAA2L.js";
+import { STORY_METRICS, aggregateTokenUsageForRun, aggregateTokenUsageForStory, getStoryMetricsForRun, writeRunMetrics, writeStoryMetrics } from "./operational-CobuCGbM.js";
+import { createRequire } from "module";
 import { dirname, join } from "path";
 import { access, readFile, readdir, stat } from "fs/promises";
 import { existsSync, mkdirSync, readFileSync } from "fs";
 import yaml from "js-yaml";
-import { createRequire } from "node:module";
+import { createRequire as createRequire$1 } from "node:module";
 import { z } from "zod";
 import { execSync, spawn } from "node:child_process";
 import { dirname as dirname$1, join as join$1, resolve as resolve$1 } from "node:path";
@@ -17,6 +18,10 @@ import { freemem, platform } from "node:os";
 import { randomUUID } from "node:crypto";
 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/utils/git-root.ts
 /**
 * Resolve the main git repository root, even from a linked worktree.
@@ -534,7 +539,7 @@ const migration010RunMetrics = {
 
 //#endregion
 //#region src/persistence/migrations/index.ts
-const logger$15 = createLogger("persistence:migrations");
+const logger$16 = createLogger("persistence:migrations");
 const MIGRATIONS = [
 	initialSchemaMigration,
 	costTrackerSchemaMigration,
@@ -552,7 +557,7 @@ const MIGRATIONS = [
 * Safe to call multiple times — already-applied migrations are skipped.
 */
 function runMigrations(db) {
-	logger$15.info("Starting migration runner");
+	logger$16.info("Starting migration runner");
 	db.exec(`
     CREATE TABLE IF NOT EXISTS schema_migrations (
       version   INTEGER PRIMARY KEY,
@@ -563,12 +568,12 @@ function runMigrations(db) {
 	const appliedVersions = new Set(db.prepare("SELECT version FROM schema_migrations").all().map((row) => row.version));
 	const pending = MIGRATIONS.filter((m) => !appliedVersions.has(m.version)).sort((a, b) => a.version - b.version);
 	if (pending.length === 0) {
-		logger$15.info("No pending migrations");
+		logger$16.info("No pending migrations");
 		return;
 	}
 	const insertMigration = db.prepare("INSERT INTO schema_migrations (version, name) VALUES (?, ?)");
 	for (const migration of pending) {
-		logger$15.info({
+		logger$16.info({
 			version: migration.version,
 			name: migration.name
 		}, "Applying migration");
@@ -582,14 +587,14 @@ function runMigrations(db) {
 			});
 			applyMigration();
 		}
-		logger$15.info({ version: migration.version }, "Migration applied successfully");
+		logger$16.info({ version: migration.version }, "Migration applied successfully");
 	}
-	logger$15.info({ count: pending.length }, "All pending migrations applied");
+	logger$16.info({ count: pending.length }, "All pending migrations applied");
 }
 
 //#endregion
 //#region src/persistence/database.ts
-const logger$14 = createLogger("persistence:database");
+const logger$15 = createLogger("persistence:database");
 /**
 * Thin wrapper that opens a SQLite database, applies required PRAGMAs,
 * and exposes the raw BetterSqlite3 instance.
@@ -606,14 +611,14 @@ var DatabaseWrapper = class {
 	*/
 	open() {
 		if (this._db !== null) return;
-		logger$14.info({ path: this._path }, "Opening SQLite database");
+		logger$15.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$14.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$15.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$14.info({ path: this._path }, "SQLite database opened with WAL mode");
+		logger$15.info({ path: this._path }, "SQLite database opened with WAL mode");
 	}
 	/**
 	* Close the database. Idempotent — calling close() when already closed is a no-op.
@@ -622,7 +627,7 @@ var DatabaseWrapper = class {
 		if (this._db === null) return;
 		this._db.close();
 		this._db = null;
-		logger$14.info({ path: this._path }, "SQLite database closed");
+		logger$15.info({ path: this._path }, "SQLite database closed");
 	}
 	/**
 	* Return the raw BetterSqlite3 instance.
@@ -1064,8 +1069,8 @@ const PACKAGE_ROOT = join(__dirname, "..", "..", "..");
 */
 function resolveBmadMethodSrcPath(fromDir = __dirname) {
 	try {
-		const require = createRequire(join(fromDir, "synthetic.js"));
-		const pkgJsonPath = require.resolve("bmad-method/package.json");
+		const require$1 = createRequire$1(join(fromDir, "synthetic.js"));
+		const pkgJsonPath = require$1.resolve("bmad-method/package.json");
 		return join(dirname(pkgJsonPath), "src");
 	} catch {
 		return null;
@@ -1077,9 +1082,9 @@ function resolveBmadMethodSrcPath(fromDir = __dirname) {
 */
 function resolveBmadMethodVersion(fromDir = __dirname) {
 	try {
-		const require = createRequire(join(fromDir, "synthetic.js"));
-		const pkgJsonPath = require.resolve("bmad-method/package.json");
-		const pkg = require(pkgJsonPath);
+		const require$1 = createRequire$1(join(fromDir, "synthetic.js"));
+		const pkgJsonPath = require$1.resolve("bmad-method/package.json");
+		const pkg = require$1(pkgJsonPath);
 		return pkg.version ?? "unknown";
 	} catch {
 		return "unknown";
@@ -2491,7 +2496,7 @@ function truncateToTokens(text, maxTokens) {
 
 //#endregion
 //#region src/modules/context-compiler/context-compiler-impl.ts
-const logger$13 = createLogger("context-compiler");
+const logger$14 = createLogger("context-compiler");
 /**
 * Fraction of the original token budget that must remain (after required +
 * important sections) before an optional section is included.
@@ -2583,7 +2588,7 @@ var ContextCompilerImpl = class {
 				includedParts.push(truncated);
 				remainingBudget -= truncatedTokens;
 				anyTruncated = true;
-				logger$13.warn({
+				logger$14.warn({
 					section: section.name,
 					originalTokens: tokens,
 					budgetTokens: truncatedTokens
@@ -2597,7 +2602,7 @@ var ContextCompilerImpl = class {
 				});
 			} else {
 				anyTruncated = true;
-				logger$13.warn({
+				logger$14.warn({
 					section: section.name,
 					tokens
 				}, "Context compiler: omitted \"important\" section — no budget remaining");
@@ -2624,7 +2629,7 @@ var ContextCompilerImpl = class {
 				} else {
 					if (tokens > 0) {
 						anyTruncated = true;
-						logger$13.warn({
+						logger$14.warn({
 							section: section.name,
 							tokens,
 							budgetFractionRemaining: budgetFractionRemaining.toFixed(2)
@@ -2892,7 +2897,7 @@ function parseYamlResult(yamlText, schema) {
 
 //#endregion
 //#region src/modules/agent-dispatch/dispatcher-impl.ts
-const logger$12 = createLogger("agent-dispatch");
+const logger$13 = createLogger("agent-dispatch");
 const SHUTDOWN_GRACE_MS = 1e4;
 const SHUTDOWN_MAX_WAIT_MS = 3e4;
 const CHARS_PER_TOKEN = 4;
@@ -2929,7 +2934,7 @@ function getAvailableMemory() {
 				encoding: "utf-8"
 			}).trim(), 10);
 			if (pressureLevel >= 2) {
-				logger$12.warn({ pressureLevel }, "macOS kernel reports memory pressure");
+				logger$13.warn({ pressureLevel }, "macOS kernel reports memory pressure");
 				return 0;
 			}
 		} catch {}
@@ -3015,7 +3020,7 @@ var DispatcherImpl = class {
 					resolve: typedResolve,
 					reject
 				});
-				logger$12.debug({
+				logger$13.debug({
 					id,
 					queueLength: this._queue.length
 				}, "Dispatch queued");
@@ -3046,7 +3051,7 @@ var DispatcherImpl = class {
 	async shutdown() {
 		this._shuttingDown = true;
 		this._stopMemoryPressureTimer();
-		logger$12.info({
+		logger$13.info({
 			running: this._running.size,
 			queued: this._queue.length
 		}, "Dispatcher shutting down");
@@ -3079,13 +3084,13 @@ var DispatcherImpl = class {
 				}
 			}, 50);
 		});
-		logger$12.info("Dispatcher shutdown complete");
+		logger$13.info("Dispatcher shutdown complete");
 	}
 	async _startDispatch(id, request, resolve$2) {
 		const { prompt, agent, taskType, timeout, outputSchema, workingDirectory, model, maxTurns } = request;
 		const adapter = this._adapterRegistry.get(agent);
 		if (adapter === void 0) {
-			logger$12.warn({
+			logger$13.warn({
 				id,
 				agent
 			}, "No adapter found for agent");
@@ -3131,7 +3136,7 @@ var DispatcherImpl = class {
 		});
 		const startedAt = Date.now();
 		proc.on("error", (err) => {
-			logger$12.error({
+			logger$13.error({
 				id,
 				binary: cmd.binary,
 				error: err.message
@@ -3139,7 +3144,7 @@ var DispatcherImpl = class {
 		});
 		if (proc.stdin !== null) {
 			proc.stdin.on("error", (err) => {
-				if (err.code !== "EPIPE") logger$12.warn({
+				if (err.code !== "EPIPE") logger$13.warn({
 					id,
 					error: err.message
 				}, "stdin write error");
@@ -3181,7 +3186,7 @@ var DispatcherImpl = class {
 			agent,
 			taskType
 		});
-		logger$12.debug({
+		logger$13.debug({
 			id,
 			agent,
 			taskType,
@@ -3198,7 +3203,7 @@ var DispatcherImpl = class {
 				dispatchId: id,
 				timeoutMs
 			});
-			logger$12.warn({
+			logger$13.warn({
 				id,
 				agent,
 				taskType,
@@ -3252,7 +3257,7 @@ var DispatcherImpl = class {
 					exitCode: code,
 					output: stdout
 				});
-				logger$12.debug({
+				logger$13.debug({
 					id,
 					agent,
 					taskType,
@@ -3278,7 +3283,7 @@ var DispatcherImpl = class {
 					error: stderr || `Process exited with code ${String(code)}`,
 					exitCode: code
 				});
-				logger$12.debug({
+				logger$13.debug({
 					id,
 					agent,
 					taskType,
@@ -3337,7 +3342,7 @@ var DispatcherImpl = class {
 		const next = this._queue.shift();
 		if (next === void 0) return;
 		next.handle.status = "running";
-		logger$12.debug({
+		logger$13.debug({
 			id: next.id,
 			queueLength: this._queue.length
 		}, "Dequeued dispatch");
@@ -3350,7 +3355,7 @@ var DispatcherImpl = class {
 	_isMemoryPressured() {
 		const free = getAvailableMemory();
 		if (free < MIN_FREE_MEMORY_BYTES) {
-			logger$12.warn({
+			logger$13.warn({
 				freeMB: Math.round(free / 1024 / 1024),
 				thresholdMB: Math.round(MIN_FREE_MEMORY_BYTES / 1024 / 1024)
 			}, "Memory pressure detected — holding dispatch queue");
@@ -3390,7 +3395,7 @@ function createDispatcher(options) {
 
 //#endregion
 //#region src/modules/compiled-workflows/prompt-assembler.ts
-const logger$11 = createLogger("compiled-workflows:prompt-assembler");
+const logger$12 = createLogger("compiled-workflows:prompt-assembler");
 /**
 * Assemble a final prompt from a template and sections map.
 *
@@ -3415,7 +3420,7 @@ function assemblePrompt(template, sections, tokenCeiling = 2200) {
 		tokenCount,
 		truncated: false
 	};
-	logger$11.warn({
+	logger$12.warn({
 		tokenCount,
 		ceiling: tokenCeiling
 	}, "Prompt exceeds token ceiling — truncating optional sections");
@@ -3431,10 +3436,10 @@ function assemblePrompt(template, sections, tokenCeiling = 2200) {
 			const targetSectionTokens = Math.max(0, currentSectionTokens - overBy);
 			if (targetSectionTokens === 0) {
 				contentMap[section.name] = "";
-				logger$11.warn({ sectionName: section.name }, "Section eliminated to fit token budget");
+				logger$12.warn({ sectionName: section.name }, "Section eliminated to fit token budget");
 			} else {
 				contentMap[section.name] = truncateToTokens(section.content, targetSectionTokens);
-				logger$11.warn({
+				logger$12.warn({
 					sectionName: section.name,
 					targetSectionTokens
 				}, "Section truncated to fit token budget");
@@ -3445,7 +3450,7 @@ function assemblePrompt(template, sections, tokenCeiling = 2200) {
 		}
 		if (tokenCount <= tokenCeiling) break;
 	}
-	if (tokenCount > tokenCeiling) logger$11.warn({
+	if (tokenCount > tokenCeiling) logger$12.warn({
 		tokenCount,
 		ceiling: tokenCeiling
 	}, "Required sections alone exceed token ceiling — returning over-budget prompt");
@@ -3586,7 +3591,7 @@ const CodeReviewResultSchema = z.object({
 
 //#endregion
 //#region src/modules/compiled-workflows/create-story.ts
-const logger$10 = createLogger("compiled-workflows:create-story");
+const logger$11 = createLogger("compiled-workflows:create-story");
 /**
 * Hard ceiling for the assembled create-story prompt.
 */
@@ -3610,7 +3615,7 @@ const TOKEN_CEILING$2 = 3e3;
 */
 async function runCreateStory(deps, params) {
 	const { epicId, storyKey, pipelineRunId } = params;
-	logger$10.debug({
+	logger$11.debug({
 		epicId,
 		storyKey,
 		pipelineRunId
@@ -3620,7 +3625,7 @@ async function runCreateStory(deps, params) {
 		template = await deps.pack.getPrompt("create-story");
 	} catch (err) {
 		const error = err instanceof Error ? err.message : String(err);
-		logger$10.error({ error }, "Failed to retrieve create-story prompt template");
+		logger$11.error({ error }, "Failed to retrieve create-story prompt template");
 		return {
 			result: "failed",
 			error: `Failed to retrieve prompt template: ${error}`,
@@ -3662,7 +3667,7 @@ async function runCreateStory(deps, params) {
 			priority: "important"
 		}
 	], TOKEN_CEILING$2);
-	logger$10.debug({
+	logger$11.debug({
 		tokenCount,
 		truncated,
 		tokenCeiling: TOKEN_CEILING$2
@@ -3679,7 +3684,7 @@ async function runCreateStory(deps, params) {
 		dispatchResult = await handle.result;
 	} catch (err) {
 		const error = err instanceof Error ? err.message : String(err);
-		logger$10.error({
+		logger$11.error({
 			epicId,
 			storyKey,
 			error
@@ -3700,7 +3705,7 @@ async function runCreateStory(deps, params) {
 	if (dispatchResult.status === "failed") {
 		const errorMsg = dispatchResult.parseError ?? `Dispatch failed with exit code ${dispatchResult.exitCode}`;
 		const stderrDetail = dispatchResult.output ? ` Output: ${dispatchResult.output}` : "";
-		logger$10.warn({
+		logger$11.warn({
 			epicId,
 			storyKey,
 			exitCode: dispatchResult.exitCode
@@ -3712,7 +3717,7 @@ async function runCreateStory(deps, params) {
 		};
 	}
 	if (dispatchResult.status === "timeout") {
-		logger$10.warn({
+		logger$11.warn({
 			epicId,
 			storyKey
 		}, "Create-story dispatch timed out");
@@ -3725,7 +3730,7 @@ async function runCreateStory(deps, params) {
 	if (dispatchResult.parsed === null) {
 		const details = dispatchResult.parseError ?? "No YAML block found in output";
 		const rawSnippet = dispatchResult.output ? dispatchResult.output.slice(0, 1e3) : "(empty)";
-		logger$10.warn({
+		logger$11.warn({
 			epicId,
 			storyKey,
 			details,
@@ -3741,7 +3746,7 @@ async function runCreateStory(deps, params) {
 	const parseResult = CreateStoryResultSchema.safeParse(dispatchResult.parsed);
 	if (!parseResult.success) {
 		const details = parseResult.error.message;
-		logger$10.warn({
+		logger$11.warn({
 			epicId,
 			storyKey,
 			details
@@ -3754,7 +3759,7 @@ async function runCreateStory(deps, params) {
 		};
 	}
 	const parsed = parseResult.data;
-	logger$10.info({
+	logger$11.info({
 		epicId,
 		storyKey,
 		storyFile: parsed.story_file,
@@ -3776,7 +3781,7 @@ function getImplementationDecisions(deps) {
 	try {
 		return getDecisionsByPhase(deps.db, "implementation");
 	} catch (err) {
-		logger$10.warn({ error: err instanceof Error ? err.message : String(err) }, "Failed to retrieve implementation decisions");
+		logger$11.warn({ error: err instanceof Error ? err.message : String(err) }, "Failed to retrieve implementation decisions");
 		return [];
 	}
 }
@@ -3792,13 +3797,13 @@ function getEpicShard(decisions, epicId, projectRoot) {
 		if (projectRoot) {
 			const fallback = readEpicShardFromFile(projectRoot, epicId);
 			if (fallback) {
-				logger$10.info({ epicId }, "Using file-based fallback for epic shard (decisions table empty)");
+				logger$11.info({ epicId }, "Using file-based fallback for epic shard (decisions table empty)");
 				return fallback;
 			}
 		}
 		return "";
 	} catch (err) {
-		logger$10.warn({
+		logger$11.warn({
 			epicId,
 			error: err instanceof Error ? err.message : String(err)
 		}, "Failed to retrieve epic shard");
@@ -3815,7 +3820,7 @@ function getPrevDevNotes(decisions, epicId) {
 		if (devNotes.length === 0) return "";
 		return devNotes[devNotes.length - 1].value;
 	} catch (err) {
-		logger$10.warn({
+		logger$11.warn({
 			epicId,
 			error: err instanceof Error ? err.message : String(err)
 		}, "Failed to retrieve prev dev notes");
@@ -3835,13 +3840,13 @@ function getArchConstraints$1(deps) {
 		if (deps.projectRoot) {
 			const fallback = readArchConstraintsFromFile(deps.projectRoot);
 			if (fallback) {
-				logger$10.info("Using file-based fallback for architecture constraints (decisions table empty)");
+				logger$11.info("Using file-based fallback for architecture constraints (decisions table empty)");
 				return fallback;
 			}
 		}
 		return "";
 	} catch (err) {
-		logger$10.warn({ error: err instanceof Error ? err.message : String(err) }, "Failed to retrieve architecture constraints");
+		logger$11.warn({ error: err instanceof Error ? err.message : String(err) }, "Failed to retrieve architecture constraints");
 		return "";
 	}
 }
@@ -3861,7 +3866,7 @@ function readEpicShardFromFile(projectRoot, epicId) {
 		const match = pattern.exec(content);
 		return match ? match[0].trim() : "";
 	} catch (err) {
-		logger$10.warn({
+		logger$11.warn({
 			epicId,
 			error: err instanceof Error ? err.message : String(err)
 		}, "File-based epic shard fallback failed");
@@ -3884,7 +3889,7 @@ function readArchConstraintsFromFile(projectRoot) {
 		const content = readFileSync$1(archPath, "utf-8");
 		return content.slice(0, 1500);
 	} catch (err) {
-		logger$10.warn({ error: err instanceof Error ? err.message : String(err) }, "File-based architecture fallback failed");
+		logger$11.warn({ error: err instanceof Error ? err.message : String(err) }, "File-based architecture fallback failed");
 		return "";
 	}
 }
@@ -3897,14 +3902,14 @@ async function getStoryTemplate(deps) {
 	try {
 		return await deps.pack.getTemplate("story");
 	} catch (err) {
-		logger$10.warn({ error: err instanceof Error ? err.message : String(err) }, "Failed to retrieve story template from pack");
+		logger$11.warn({ error: err instanceof Error ? err.message : String(err) }, "Failed to retrieve story template from pack");
 		return "";
 	}
 }
 
 //#endregion
 //#region src/modules/compiled-workflows/git-helpers.ts
-const logger$9 = createLogger("compiled-workflows:git-helpers");
+const logger$10 = createLogger("compiled-workflows:git-helpers");
 /**
 * Capture the full git diff for HEAD (working tree vs current commit).
 *
@@ -4028,7 +4033,7 @@ async function runGitCommand(args, cwd, logLabel) {
 			stderr += chunk.toString("utf-8");
 		});
 		proc.on("error", (err) => {
-			logger$9.warn({
+			logger$10.warn({
 				label: logLabel,
 				cwd,
 				error: err.message
@@ -4037,7 +4042,7 @@ async function runGitCommand(args, cwd, logLabel) {
 		});
 		proc.on("close", (code) => {
 			if (code !== 0) {
-				logger$9.warn({
+				logger$10.warn({
 					label: logLabel,
 					cwd,
 					code,
@@ -4053,7 +4058,7 @@ async function runGitCommand(args, cwd, logLabel) {
 
 //#endregion
 //#region src/modules/compiled-workflows/dev-story.ts
-const logger$8 = createLogger("compiled-workflows:dev-story");
+const logger$9 = createLogger("compiled-workflows:dev-story");
 /** Hard token ceiling for the assembled dev-story prompt */
 const TOKEN_CEILING$1 = 24e3;
 /** Default timeout for dev-story dispatches in milliseconds (30 min) */
@@ -4078,7 +4083,7 @@ const DEFAULT_VITEST_PATTERNS = `## Test Patterns (defaults)
 */
 async function runDevStory(deps, params) {
 	const { storyKey, storyFilePath, taskScope, priorFiles } = params;
-	logger$8.info({
+	logger$9.info({
 		storyKey,
 		storyFilePath
 	}, "Starting compiled dev-story workflow");
@@ -4120,10 +4125,10 @@ async function runDevStory(deps, params) {
 	let template;
 	try {
 		template = await deps.pack.getPrompt("dev-story");
-		logger$8.debug({ storyKey }, "Retrieved dev-story prompt template from pack");
+		logger$9.debug({ storyKey }, "Retrieved dev-story prompt template from pack");
 	} catch (err) {
 		const error = err instanceof Error ? err.message : String(err);
-		logger$8.error({
+		logger$9.error({
 			storyKey,
 			error
 		}, "Failed to retrieve dev-story prompt template");
@@ -4134,14 +4139,14 @@ async function runDevStory(deps, params) {
 		storyContent = await readFile$1(storyFilePath, "utf-8");
 	} catch (err) {
 		if (err.code === "ENOENT") {
-			logger$8.error({
+			logger$9.error({
 				storyKey,
 				storyFilePath
 			}, "Story file not found");
 			return makeFailureResult("story_file_not_found");
 		}
 		const error = err instanceof Error ? err.message : String(err);
-		logger$8.error({
+		logger$9.error({
 			storyKey,
 			storyFilePath,
 			error
@@ -4149,7 +4154,7 @@ async function runDevStory(deps, params) {
 		return makeFailureResult(`story_file_read_error: ${error}`);
 	}
 	if (storyContent.trim().length === 0) {
-		logger$8.error({
+		logger$9.error({
 			storyKey,
 			storyFilePath
 		}, "Story file is empty");
@@ -4161,17 +4166,17 @@ async function runDevStory(deps, params) {
 		const testPatternDecisions = solutioningDecisions.filter((d) => d.category === "test-patterns");
 		if (testPatternDecisions.length > 0) {
 			testPatternsContent = "## Test Patterns\n" + testPatternDecisions.map((d) => `- ${d.key}: ${d.value}`).join("\n");
-			logger$8.debug({
+			logger$9.debug({
 				storyKey,
 				count: testPatternDecisions.length
 			}, "Loaded test patterns from decision store");
 		} else {
 			testPatternsContent = DEFAULT_VITEST_PATTERNS;
-			logger$8.debug({ storyKey }, "No test-pattern decisions found — using default Vitest patterns");
+			logger$9.debug({ storyKey }, "No test-pattern decisions found — using default Vitest patterns");
 		}
 	} catch (err) {
 		const error = err instanceof Error ? err.message : String(err);
-		logger$8.warn({
+		logger$9.warn({
 			storyKey,
 			error
 		}, "Failed to load test patterns — using defaults");
@@ -4214,7 +4219,7 @@ async function runDevStory(deps, params) {
 		}
 	];
 	const { prompt, tokenCount, truncated } = assemblePrompt(template, sections, TOKEN_CEILING$1);
-	logger$8.info({
+	logger$9.info({
 		storyKey,
 		tokenCount,
 		ceiling: TOKEN_CEILING$1,
@@ -4233,7 +4238,7 @@ async function runDevStory(deps, params) {
 		dispatchResult = await handle.result;
 	} catch (err) {
 		const error = err instanceof Error ? err.message : String(err);
-		logger$8.error({
+		logger$9.error({
 			storyKey,
 			error
 		}, "Dispatch threw an unexpected error");
@@ -4244,11 +4249,11 @@ async function runDevStory(deps, params) {
 		output: dispatchResult.tokenEstimate.output
 	};
 	if (dispatchResult.status === "timeout") {
-		logger$8.error({
+		logger$9.error({
 			storyKey,
 			durationMs: dispatchResult.durationMs
 		}, "Dev-story dispatch timed out");
-		if (dispatchResult.output.length > 0) logger$8.info({
+		if (dispatchResult.output.length > 0) logger$9.info({
 			storyKey,
 			partialOutput: dispatchResult.output.slice(0, 500)
 		}, "Partial output before timeout");
@@ -4258,12 +4263,12 @@ async function runDevStory(deps, params) {
 		};
 	}
 	if (dispatchResult.status === "failed" || dispatchResult.exitCode !== 0) {
-		logger$8.error({
+		logger$9.error({
 			storyKey,
 			exitCode: dispatchResult.exitCode,
 			status: dispatchResult.status
 		}, "Dev-story dispatch failed");
-		if (dispatchResult.output.length > 0) logger$8.info({
+		if (dispatchResult.output.length > 0) logger$9.info({
 			storyKey,
 			partialOutput: dispatchResult.output.slice(0, 500)
 		}, "Partial output from failed dispatch");
@@ -4275,7 +4280,7 @@ async function runDevStory(deps, params) {
 	if (dispatchResult.parseError !== null || dispatchResult.parsed === null) {
 		const details = dispatchResult.parseError ?? "parsed result was null";
 		const rawSnippet = dispatchResult.output ? dispatchResult.output.slice(0, 1e3) : "(empty)";
-		logger$8.error({
+		logger$9.error({
 			storyKey,
 			parseError: details,
 			rawOutputSnippet: rawSnippet
@@ -4283,12 +4288,12 @@ async function runDevStory(deps, params) {
 		let filesModified = [];
 		try {
 			filesModified = await getGitChangedFiles(deps.projectRoot ?? process.cwd());
-			if (filesModified.length > 0) logger$8.info({
+			if (filesModified.length > 0) logger$9.info({
 				storyKey,
 				fileCount: filesModified.length
 			}, "Recovered files_modified from git status (YAML fallback)");
 		} catch (err) {
-			logger$8.warn({
+			logger$9.warn({
 				storyKey,
 				error: err instanceof Error ? err.message : String(err)
 			}, "Failed to recover files_modified from git");
@@ -4305,7 +4310,7 @@ async function runDevStory(deps, params) {
 		};
 	}
 	const parsed = dispatchResult.parsed;
-	logger$8.info({
+	logger$9.info({
 		storyKey,
 		result: parsed.result,
 		acMet: parsed.ac_met.length
@@ -4444,7 +4449,7 @@ function extractFilesInScope(storyContent) {
 
 //#endregion
 //#region src/modules/compiled-workflows/code-review.ts
-const logger$7 = createLogger("compiled-workflows:code-review");
+const logger$8 = createLogger("compiled-workflows:code-review");
 /**
 * Hard token ceiling for the assembled code-review prompt (50,000 tokens).
 * Quality reviews require seeing actual code diffs, not just file names.
@@ -4484,7 +4489,7 @@ function defaultFailResult(error, tokenUsage) {
 async function runCodeReview(deps, params) {
 	const { storyKey, storyFilePath, workingDirectory, pipelineRunId, filesModified, previousIssues } = params;
 	const cwd = workingDirectory ?? process.cwd();
-	logger$7.debug({
+	logger$8.debug({
 		storyKey,
 		storyFilePath,
 		cwd,
@@ -4495,7 +4500,7 @@ async function runCodeReview(deps, params) {
 		template = await deps.pack.getPrompt("code-review");
 	} catch (err) {
 		const error = err instanceof Error ? err.message : String(err);
-		logger$7.error({ error }, "Failed to retrieve code-review prompt template");
+		logger$8.error({ error }, "Failed to retrieve code-review prompt template");
 		return defaultFailResult(`Failed to retrieve prompt template: ${error}`, {
 			input: 0,
 			output: 0
@@ -4506,7 +4511,7 @@ async function runCodeReview(deps, params) {
 		storyContent = await readFile$1(storyFilePath, "utf-8");
 	} catch (err) {
 		const error = err instanceof Error ? err.message : String(err);
-		logger$7.error({
+		logger$8.error({
 			storyFilePath,
 			error
 		}, "Failed to read story file");
@@ -4526,12 +4531,12 @@ async function runCodeReview(deps, params) {
 		const scopedTotal = nonDiffTokens + countTokens(scopedDiff);
 		if (scopedTotal <= TOKEN_CEILING) {
 			gitDiffContent = scopedDiff;
-			logger$7.debug({
+			logger$8.debug({
 				fileCount: filesModified.length,
 				tokenCount: scopedTotal
 			}, "Using scoped file diff");
 		} else {
-			logger$7.warn({
+			logger$8.warn({
 				estimatedTotal: scopedTotal,
 				ceiling: TOKEN_CEILING,
 				fileCount: filesModified.length
@@ -4545,7 +4550,7 @@ async function runCodeReview(deps, params) {
 		const fullTotal = nonDiffTokens + countTokens(fullDiff);
 		if (fullTotal <= TOKEN_CEILING) gitDiffContent = fullDiff;
 		else {
-			logger$7.warn({
+			logger$8.warn({
 				estimatedTotal: fullTotal,
 				ceiling: TOKEN_CEILING
 			}, "Full git diff would exceed token ceiling — using stat-only summary");
@@ -4583,11 +4588,11 @@ async function runCodeReview(deps, params) {
 		}
 	];
 	const assembleResult = assemblePrompt(template, sections, TOKEN_CEILING);
-	if (assembleResult.truncated) logger$7.warn({
+	if (assembleResult.truncated) logger$8.warn({
 		storyKey,
 		tokenCount: assembleResult.tokenCount
 	}, "Code-review prompt truncated to fit token ceiling");
-	logger$7.debug({
+	logger$8.debug({
 		storyKey,
 		tokenCount: assembleResult.tokenCount,
 		truncated: assembleResult.truncated
@@ -4605,7 +4610,7 @@ async function runCodeReview(deps, params) {
 		dispatchResult = await handle.result;
 	} catch (err) {
 		const error = err instanceof Error ? err.message : String(err);
-		logger$7.error({
+		logger$8.error({
 			storyKey,
 			error
 		}, "Code-review dispatch threw unexpected error");
@@ -4621,7 +4626,7 @@ async function runCodeReview(deps, params) {
 	const rawOutput = dispatchResult.output ?? void 0;
 	if (dispatchResult.status === "failed") {
 		const errorMsg = `Dispatch status: failed. Exit code: ${dispatchResult.exitCode}. ${dispatchResult.parseError ?? ""} ${dispatchResult.output ? `Stderr: ${dispatchResult.output}` : ""}`.trim();
-		logger$7.warn({
+		logger$8.warn({
 			storyKey,
 			exitCode: dispatchResult.exitCode
 		}, "Code-review dispatch failed");
@@ -4631,7 +4636,7 @@ async function runCodeReview(deps, params) {
 		};
 	}
 	if (dispatchResult.status === "timeout") {
-		logger$7.warn({ storyKey }, "Code-review dispatch timed out");
+		logger$8.warn({ storyKey }, "Code-review dispatch timed out");
 		return {
 			...defaultFailResult("Dispatch status: timeout. The agent did not complete within the allowed time.", tokenUsage),
 			rawOutput
@@ -4639,7 +4644,7 @@ async function runCodeReview(deps, params) {
 	}
 	if (dispatchResult.parsed === null) {
 		const details = dispatchResult.parseError ?? "No YAML block found in output";
-		logger$7.warn({
+		logger$8.warn({
 			storyKey,
 			details
 		}, "Code-review output schema validation failed");
@@ -4656,7 +4661,7 @@ async function runCodeReview(deps, params) {
 	const parseResult = CodeReviewResultSchema.safeParse(dispatchResult.parsed);
 	if (!parseResult.success) {
 		const details = parseResult.error.message;
-		logger$7.warn({
+		logger$8.warn({
 			storyKey,
 			details
 		}, "Code-review output failed schema validation");
@@ -4671,13 +4676,13 @@ async function runCodeReview(deps, params) {
 		};
 	}
 	const parsed = parseResult.data;
-	if (parsed.agentVerdict !== parsed.verdict) logger$7.info({
+	if (parsed.agentVerdict !== parsed.verdict) logger$8.info({
 		storyKey,
 		agentVerdict: parsed.agentVerdict,
 		pipelineVerdict: parsed.verdict,
 		issues: parsed.issues
 	}, "Pipeline overrode agent verdict based on issue severities");
-	logger$7.info({
+	logger$8.info({
 		storyKey,
 		verdict: parsed.verdict,
 		issues: parsed.issues
@@ -4702,7 +4707,7 @@ function getArchConstraints(deps) {
 		if (constraints.length === 0) return "";
 		return constraints.map((d) => `${d.key}: ${d.value}`).join("\n");
 	} catch (err) {
-		logger$7.warn({ error: err instanceof Error ? err.message : String(err) }, "Failed to retrieve architecture constraints");
+		logger$8.warn({ error: err instanceof Error ? err.message : String(err) }, "Failed to retrieve architecture constraints");
 		return "";
 	}
 }
@@ -5034,7 +5039,7 @@ function detectConflictGroups(storyKeys, config) {
 
 //#endregion
 //#region src/modules/implementation-orchestrator/seed-methodology-context.ts
-const logger$6 = createLogger("implementation-orchestrator:seed");
+const logger$7 = createLogger("implementation-orchestrator:seed");
 /** Max chars for the architecture summary seeded into decisions */
 const MAX_ARCH_CHARS = 6e3;
 /** Max chars per epic shard */
@@ -5068,12 +5073,12 @@ function seedMethodologyContext(db, projectRoot) {
 		const testCount = seedTestPatterns(db, projectRoot);
 		if (testCount === -1) result.skippedCategories.push("test-patterns");
 		else result.decisionsCreated += testCount;
-		logger$6.info({
+		logger$7.info({
 			decisionsCreated: result.decisionsCreated,
 			skippedCategories: result.skippedCategories
 		}, "Methodology context seeding complete");
 	} catch (err) {
-		logger$6.warn({ error: err instanceof Error ? err.message : String(err) }, "Methodology context seeding failed (non-fatal)");
+		logger$7.warn({ error: err instanceof Error ? err.message : String(err) }, "Methodology context seeding failed (non-fatal)");
 	}
 	return result;
 }
@@ -5117,7 +5122,7 @@ function seedArchitecture(db, projectRoot) {
 		});
 		count = 1;
 	}
-	logger$6.debug({ count }, "Seeded architecture decisions");
+	logger$7.debug({ count }, "Seeded architecture decisions");
 	return count;
 }
 /**
@@ -5145,7 +5150,7 @@ function seedEpicShards(db, projectRoot) {
 		});
 		count++;
 	}
-	logger$6.debug({ count }, "Seeded epic shard decisions");
+	logger$7.debug({ count }, "Seeded epic shard decisions");
 	return count;
 }
 /**
@@ -5166,7 +5171,7 @@ function seedTestPatterns(db, projectRoot) {
 		value: patterns.slice(0, MAX_TEST_PATTERNS_CHARS),
 		rationale: "Detected from project configuration at orchestrator startup"
 	});
-	logger$6.debug("Seeded test patterns decision");
+	logger$7.debug("Seeded test patterns decision");
 	return 1;
 }
 /**
@@ -5358,7 +5363,7 @@ function createPauseGate() {
 */
 function createImplementationOrchestrator(deps) {
 	const { db, pack, contextCompiler, dispatcher, eventBus, config, projectRoot } = deps;
-	const logger$16 = createLogger("implementation-orchestrator");
+	const logger$17 = createLogger("implementation-orchestrator");
 	let _state = "IDLE";
 	let _startedAt;
 	let _completedAt;
@@ -5371,6 +5376,7 @@ function createImplementationOrchestrator(deps) {
 	const HEARTBEAT_INTERVAL_MS = 3e4;
 	const WATCHDOG_TIMEOUT_MS = 6e5;
 	const _stalledStories = new Set();
+	const _storiesWithStall = new Set();
 	const _phaseStartMs = new Map();
 	const _phaseEndMs = new Map();
 	const _storyDispatches = new Map();
@@ -5394,7 +5400,7 @@ function createImplementationOrchestrator(deps) {
 		const nowMs = Date.now();
 		for (const [phase, startMs] of starts) {
 			const endMs = ends?.get(phase);
-			if (endMs === void 0) logger$16.warn({
+			if (endMs === void 0) logger$17.warn({
 				storyKey,
 				phase
 			}, "Phase has no end time — story may have errored mid-phase. Duration capped to now() and may be inflated.");
@@ -5424,8 +5430,30 @@ function createImplementationOrchestrator(deps) {
 				review_cycles: reviewCycles,
 				dispatches: _storyDispatches.get(storyKey) ?? 0
 			});
+			try {
+				const runId = config.pipelineRunId ?? "unknown";
+				createDecision(db, {
+					pipeline_run_id: config.pipelineRunId,
+					phase: "implementation",
+					category: STORY_METRICS,
+					key: `${storyKey}:${runId}`,
+					value: JSON.stringify({
+						wall_clock_seconds: wallClockSeconds,
+						input_tokens: tokenAgg.input,
+						output_tokens: tokenAgg.output,
+						review_cycles: reviewCycles,
+						stalled: _storiesWithStall.has(storyKey)
+					}),
+					rationale: `Story ${storyKey} completed with result=${result} in ${wallClockSeconds}s. Tokens: ${tokenAgg.input}+${tokenAgg.output}. Review cycles: ${reviewCycles}.`
+				});
+			} catch (decisionErr) {
+				logger$17.warn({
+					err: decisionErr,
+					storyKey
+				}, "Failed to write story-metrics decision (best-effort)");
+			}
 		} catch (err) {
-			logger$16.warn({
+			logger$17.warn({
 				err,
 				storyKey
 			}, "Failed to write story metrics (best-effort)");
@@ -5461,7 +5489,7 @@ function createImplementationOrchestrator(deps) {
 				token_usage_json: serialized
 			});
 		} catch (err) {
-			logger$16.warn("Failed to persist orchestrator state", { err });
+			logger$17.warn("Failed to persist orchestrator state", { err });
 		}
 	}
 	function recordProgress() {
@@ -5490,7 +5518,8 @@ function createImplementationOrchestrator(deps) {
 				for (const [key, s] of _stories) if (s.phase !== "PENDING" && s.phase !== "COMPLETE" && s.phase !== "ESCALATED") {
 					if (_stalledStories.has(key)) continue;
 					_stalledStories.add(key);
-					logger$16.warn({
+					_storiesWithStall.add(key);
+					logger$17.warn({
 						storyKey: key,
 						phase: s.phase,
 						elapsedMs: elapsed
@@ -5527,7 +5556,7 @@ function createImplementationOrchestrator(deps) {
 	* exhausted retries the story is ESCALATED.
 	*/
 	async function processStory(storyKey) {
-		logger$16.info("Processing story", { storyKey });
+		logger$17.info("Processing story", { storyKey });
 		await waitIfPaused();
 		if (_state !== "RUNNING") return;
 		startPhase(storyKey, "create-story");
@@ -5542,7 +5571,7 @@ function createImplementationOrchestrator(deps) {
 			const match = files.find((f) => f.startsWith(`${storyKey}-`) && f.endsWith(".md"));
 			if (match) {
 				storyFilePath = join$1(artifactsDir, match);
-				logger$16.info({
+				logger$17.info({
 					storyKey,
 					storyFilePath
 				}, "Found existing story file — skipping create-story");
@@ -5643,7 +5672,7 @@ function createImplementationOrchestrator(deps) {
 			try {
 				storyContentForAnalysis = await readFile$1(storyFilePath ?? "", "utf-8");
 			} catch (err) {
-				logger$16.error({
+				logger$17.error({
 					storyKey,
 					storyFilePath,
 					error: err instanceof Error ? err.message : String(err)
@@ -5651,7 +5680,7 @@ function createImplementationOrchestrator(deps) {
 			}
 			const analysis = analyzeStoryComplexity(storyContentForAnalysis);
 			const batches = planTaskBatches(analysis);
-			logger$16.info({
+			logger$17.info({
 				storyKey,
 				estimatedScope: analysis.estimatedScope,
 				batchCount: batches.length,
@@ -5669,7 +5698,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$16.info({
+					logger$17.info({
 						storyKey,
 						batchIndex: batch.batchIndex,
 						taskCount: batch.taskIds.length
@@ -5693,7 +5722,7 @@ function createImplementationOrchestrator(deps) {
 						});
 					} catch (batchErr) {
 						const errMsg = batchErr instanceof Error ? batchErr.message : String(batchErr);
-						logger$16.warn({
+						logger$17.warn({
 							storyKey,
 							batchIndex: batch.batchIndex,
 							error: errMsg
@@ -5713,7 +5742,7 @@ function createImplementationOrchestrator(deps) {
 						filesModified: batchFilesModified,
 						result: batchResult.result === "success" ? "success" : "failed"
 					};
-					logger$16.info(batchMetrics, "Batch dev-story metrics");
+					logger$17.info(batchMetrics, "Batch dev-story metrics");
 					for (const f of batchFilesModified) allFilesModified.add(f);
 					if (batchFilesModified.length > 0) batchFileGroups.push({
 						batchIndex: batch.batchIndex,
@@ -5735,13 +5764,13 @@ function createImplementationOrchestrator(deps) {
 							})
 						});
 					} catch (tokenErr) {
-						logger$16.warn({
+						logger$17.warn({
 							storyKey,
 							batchIndex: batch.batchIndex,
 							err: tokenErr
 						}, "Failed to record batch token usage");
 					}
-					if (batchResult.result === "failed") logger$16.warn({
+					if (batchResult.result === "failed") logger$17.warn({
 						storyKey,
 						batchIndex: batch.batchIndex,
 						error: batchResult.error
@@ -5774,7 +5803,7 @@ function createImplementationOrchestrator(deps) {
 					result: devResult
 				});
 				persistState();
-				if (devResult.result === "failed") logger$16.warn("Dev-story reported failure, proceeding to code review", {
+				if (devResult.result === "failed") logger$17.warn("Dev-story reported failure, proceeding to code review", {
 					storyKey,
 					error: devResult.error,
 					filesModified: devFilesModified.length
@@ -5831,7 +5860,7 @@ function createImplementationOrchestrator(deps) {
 						"NEEDS_MAJOR_REWORK": 2
 					};
 					for (const group of batchFileGroups) {
-						logger$16.info({
+						logger$17.info({
 							storyKey,
 							batchIndex: group.batchIndex,
 							fileCount: group.files.length
@@ -5868,7 +5897,7 @@ function createImplementationOrchestrator(deps) {
 						rawOutput: lastRawOutput,
 						tokenUsage: aggregateTokens
 					};
-					logger$16.info({
+					logger$17.info({
 						storyKey,
 						batchCount: batchFileGroups.length,
 						verdict: worstVerdict,
@@ -5894,7 +5923,7 @@ function createImplementationOrchestrator(deps) {
 				const isPhantomReview = reviewResult.verdict !== "SHIP_IT" && (reviewResult.issue_list === void 0 || reviewResult.issue_list.length === 0) && reviewResult.error !== void 0;
 				if (isPhantomReview && !timeoutRetried) {
 					timeoutRetried = true;
-					logger$16.warn({
+					logger$17.warn({
 						storyKey,
 						reviewCycles,
 						error: reviewResult.error
@@ -5904,7 +5933,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$16.info({
+					logger$17.info({
 						storyKey,
 						originalVerdict: verdict,
 						issuesBefore: previousIssueList.length,
@@ -5940,7 +5969,7 @@ function createImplementationOrchestrator(deps) {
 					if (_decomposition !== void 0) parts.push(`decomposed: ${_decomposition.batchCount} batches`);
 					parts.push(`${fileCount} files`);
 					parts.push(`${totalTokensK} tokens`);
-					logger$16.info({
+					logger$17.info({
 						storyKey,
 						verdict,
 						agentVerdict: reviewResult.agentVerdict
@@ -5998,7 +6027,7 @@ function createImplementationOrchestrator(deps) {
 					persistState();
 					return;
 				}
-				logger$16.info({
+				logger$17.info({
 					storyKey,
 					reviewCycles: finalReviewCycles,
 					issueCount: issueList.length
@@ -6048,7 +6077,7 @@ function createImplementationOrchestrator(deps) {
 						fixPrompt = assembled.prompt;
 					} catch {
 						fixPrompt = `Fix story ${storyKey}: verdict=${verdict}, minor fixes needed`;
-						logger$16.warn("Failed to assemble auto-approve fix prompt, using fallback", { storyKey });
+						logger$17.warn("Failed to assemble auto-approve fix prompt, using fallback", { storyKey });
 					}
 					const handle = dispatcher.dispatch({
 						prompt: fixPrompt,
@@ -6065,9 +6094,9 @@ function createImplementationOrchestrator(deps) {
 							output: fixResult.tokenEstimate.output
 						} : void 0 }
 					});
-					if (fixResult.status === "timeout") logger$16.warn("Auto-approve fix timed out — approving anyway (issues were minor)", { storyKey });
+					if (fixResult.status === "timeout") logger$17.warn("Auto-approve fix timed out — approving anyway (issues were minor)", { storyKey });
 				} catch (err) {
-					logger$16.warn("Auto-approve fix dispatch failed — approving anyway (issues were minor)", {
+					logger$17.warn("Auto-approve fix dispatch failed — approving anyway (issues were minor)", {
 						storyKey,
 						err
 					});
@@ -6139,7 +6168,7 @@ function createImplementationOrchestrator(deps) {
 					fixPrompt = assembled.prompt;
 				} catch {
 					fixPrompt = `Fix story ${storyKey}: verdict=${verdict}, taskType=${taskType}`;
-					logger$16.warn("Failed to assemble fix prompt, using fallback", {
+					logger$17.warn("Failed to assemble fix prompt, using fallback", {
 						storyKey,
 						taskType
 					});
@@ -6162,7 +6191,7 @@ function createImplementationOrchestrator(deps) {
 					} : void 0 }
 				});
 				if (fixResult.status === "timeout") {
-					logger$16.warn("Fix dispatch timed out — escalating story", {
+					logger$17.warn("Fix dispatch timed out — escalating story", {
 						storyKey,
 						taskType
 					});
@@ -6182,13 +6211,13 @@ function createImplementationOrchestrator(deps) {
 					persistState();
 					return;
 				}
-				if (fixResult.status === "failed") logger$16.warn("Fix dispatch failed", {
+				if (fixResult.status === "failed") logger$17.warn("Fix dispatch failed", {
 					storyKey,
 					taskType,
 					exitCode: fixResult.exitCode
 				});
 			} catch (err) {
-				logger$16.warn("Fix dispatch failed, continuing to next review", {
+				logger$17.warn("Fix dispatch failed, continuing to next review", {
 					storyKey,
 					taskType,
 					err
@@ -6242,11 +6271,11 @@ function createImplementationOrchestrator(deps) {
 	}
 	async function run(storyKeys) {
 		if (_state === "RUNNING" || _state === "PAUSED") {
-			logger$16.warn("run() called while orchestrator is already running or paused — ignoring", { state: _state });
+			logger$17.warn("run() called while orchestrator is already running or paused — ignoring", { state: _state });
 			return getStatus();
 		}
 		if (_state === "COMPLETE") {
-			logger$16.warn("run() called on a COMPLETE orchestrator — ignoring", { state: _state });
+			logger$17.warn("run() called on a COMPLETE orchestrator — ignoring", { state: _state });
 			return getStatus();
 		}
 		_state = "RUNNING";
@@ -6264,13 +6293,13 @@ function createImplementationOrchestrator(deps) {
 		if (config.enableHeartbeat) startHeartbeat();
 		if (projectRoot !== void 0) {
 			const seedResult = seedMethodologyContext(db, projectRoot);
-			if (seedResult.decisionsCreated > 0) logger$16.info({
+			if (seedResult.decisionsCreated > 0) logger$17.info({
 				decisionsCreated: seedResult.decisionsCreated,
 				skippedCategories: seedResult.skippedCategories
 			}, "Methodology context seeded from planning artifacts");
 		}
 		const groups = detectConflictGroups(storyKeys);
-		logger$16.info("Orchestrator starting", {
+		logger$17.info("Orchestrator starting", {
 			storyCount: storyKeys.length,
 			groupCount: groups.length,
 			maxConcurrency: config.maxConcurrency
@@ -6282,7 +6311,7 @@ function createImplementationOrchestrator(deps) {
 			_state = "FAILED";
 			_completedAt = new Date().toISOString();
 			persistState();
-			logger$16.error("Orchestrator failed with unhandled error", { err });
+			logger$17.error("Orchestrator failed with unhandled error", { err });
 			return getStatus();
 		}
 		stopHeartbeat();
@@ -6309,7 +6338,7 @@ function createImplementationOrchestrator(deps) {
 		_pauseGate = createPauseGate();
 		_state = "PAUSED";
 		eventBus.emit("orchestrator:paused", {});
-		logger$16.info("Orchestrator paused");
+		logger$17.info("Orchestrator paused");
 	}
 	function resume() {
 		if (_state !== "PAUSED") return;
@@ -6320,7 +6349,7 @@ function createImplementationOrchestrator(deps) {
 		}
 		_state = "RUNNING";
 		eventBus.emit("orchestrator:resumed", {});
-		logger$16.info("Orchestrator resumed");
+		logger$17.info("Orchestrator resumed");
 	}
 	return {
 		run,
@@ -6995,7 +7024,7 @@ const CritiqueOutputSchema = z.object({
 
 //#endregion
 //#region src/modules/phase-orchestrator/critique-loop.ts
-const logger$5 = createLogger("critique-loop");
+const logger$6 = createLogger("critique-loop");
 /**
 * Maps a phase name to the critique prompt template name.
 * Falls back to `critique-${phase}` for unknown phases.
@@ -7049,7 +7078,7 @@ async function runCritiqueLoop(artifact, phaseId, runId, phase, deps, options =
 			critiquePrompt = critiqueTemplate.replace("{{artifact_content}}", currentArtifact).replace("{{project_context}}", projectContext);
 		} catch (err) {
 			const message = err instanceof Error ? err.message : String(err);
-			logger$5.warn({
+			logger$6.warn({
 				phaseId,
 				promptName: critiquePromptName,
 				err: message
@@ -7077,7 +7106,7 @@ async function runCritiqueLoop(artifact, phaseId, runId, phase, deps, options =
 			critiqueTokens.output += result.tokenEstimate.output;
 			if (result.status !== "completed" || result.parsed === null) {
 				const errMsg = result.parseError ?? `Critique dispatch ended with status '${result.status}'`;
-				logger$5.warn({
+				logger$6.warn({
 					phaseId,
 					iteration: i + 1,
 					err: errMsg
@@ -7096,7 +7125,7 @@ async function runCritiqueLoop(artifact, phaseId, runId, phase, deps, options =
 			lastCritiqueOutput = critiqueOutput;
 		} catch (err) {
 			const message = err instanceof Error ? err.message : String(err);
-			logger$5.warn({
+			logger$6.warn({
 				phaseId,
 				iteration: i + 1,
 				err: message
@@ -7136,14 +7165,14 @@ async function runCritiqueLoop(artifact, phaseId, runId, phase, deps, options =
 			});
 		} catch (err) {
 			const message = err instanceof Error ? err.message : String(err);
-			logger$5.warn({
+			logger$6.warn({
 				phaseId,
 				iteration: i + 1,
 				err: message
 			}, "Critique loop: failed to store critique decision — continuing");
 		}
 		if (critiqueOutput.verdict === "pass") {
-			logger$5.info({
+			logger$6.info({
 				phaseId,
 				iteration: i + 1
 			}, "Critique loop: artifact passed critique — loop complete");
@@ -7156,7 +7185,7 @@ async function runCritiqueLoop(artifact, phaseId, runId, phase, deps, options =
 				totalMs: Date.now() - startMs
 			};
 		}
-		logger$5.info({
+		logger$6.info({
 			phaseId,
 			iteration: i + 1,
 			issueCount: critiqueOutput.issue_count
@@ -7169,7 +7198,7 @@ async function runCritiqueLoop(artifact, phaseId, runId, phase, deps, options =
 				refinePrompt = refineTemplate.replace("{{original_artifact}}", currentArtifact).replace("{{critique_issues}}", issuesText).replace("{{phase_context}}", phaseContext);
 			} catch (err) {
 				const message = err instanceof Error ? err.message : String(err);
-				logger$5.warn({
+				logger$6.warn({
 					phaseId,
 					iteration: i + 1,
 					err: message
@@ -7190,7 +7219,7 @@ async function runCritiqueLoop(artifact, phaseId, runId, phase, deps, options =
 					const originalLength = currentArtifact.length;
 					const refinedLength = refineResult.output.length;
 					const delta = refinedLength - originalLength;
-					logger$5.info({
+					logger$6.info({
 						phaseId,
 						iteration: i + 1,
 						originalLength,
@@ -7199,7 +7228,7 @@ async function runCritiqueLoop(artifact, phaseId, runId, phase, deps, options =
 					}, "Critique loop: refinement complete");
 					currentArtifact = refineResult.output;
 				} else {
-					logger$5.warn({
+					logger$6.warn({
 						phaseId,
 						iteration: i + 1,
 						status: refineResult.status
@@ -7208,7 +7237,7 @@ async function runCritiqueLoop(artifact, phaseId, runId, phase, deps, options =
 				}
 			} catch (err) {
 				const message = err instanceof Error ? err.message : String(err);
-				logger$5.warn({
+				logger$6.warn({
 					phaseId,
 					iteration: i + 1,
 					err: message
@@ -7219,12 +7248,12 @@ async function runCritiqueLoop(artifact, phaseId, runId, phase, deps, options =
 	}
 	const remainingIssues = lastCritiqueOutput?.issues ?? [];
 	if (remainingIssues.length > 0) {
-		logger$5.warn({
+		logger$6.warn({
 			phaseId,
 			maxIterations,
 			issueCount: remainingIssues.length
 		}, "Critique loop: max iterations reached with unresolved issues");
-		for (const issue of remainingIssues) logger$5.warn({
+		for (const issue of remainingIssues) logger$6.warn({
 			phaseId,
 			severity: issue.severity,
 			category: issue.category,
@@ -7243,7 +7272,7 @@ async function runCritiqueLoop(artifact, phaseId, runId, phase, deps, options =
 
 //#endregion
 //#region src/modules/phase-orchestrator/elicitation-selector.ts
-const logger$4 = createLogger("elicitation-selector");
+const logger$5 = createLogger("elicitation-selector");
 /**
 * Affinity scores (0.0–1.0) for each category per content type.
 *
@@ -7365,10 +7394,10 @@ function loadElicitationMethods() {
 	try {
 		const content = readFileSync(csvPath, "utf-8");
 		const methods = parseMethodsCsv(content);
-		logger$4.debug({ count: methods.length }, "Loaded elicitation methods");
+		logger$5.debug({ count: methods.length }, "Loaded elicitation methods");
 		return methods;
 	} catch (err) {
-		logger$4.warn({
+		logger$5.warn({
 			csvPath,
 			err
 		}, "Failed to load elicitation methods CSV");
@@ -7688,7 +7717,7 @@ const ElicitationOutputSchema = z.object({
 
 //#endregion
 //#region src/modules/phase-orchestrator/step-runner.ts
-const logger$3 = createLogger("step-runner");
+const logger$4 = createLogger("step-runner");
 /**
 * Format an array of decision records into a markdown section for injection.
 *
@@ -7795,7 +7824,7 @@ async function runSteps(steps, deps, runId, phase, params) {
 		if (estimatedTokens > budgetTokens) {
 			const decisionRefs = step.context.filter((ref) => ref.source.startsWith("decision:"));
 			if (decisionRefs.length > 0) {
-				logger$3.warn({
+				logger$4.warn({
 					step: step.name,
 					estimatedTokens,
 					budgetTokens
@@ -7822,7 +7851,7 @@ async function runSteps(steps, deps, runId, phase, params) {
 				}
 				prompt = summarizedPrompt;
 				estimatedTokens = Math.ceil(prompt.length / 4);
-				if (estimatedTokens <= budgetTokens) logger$3.info({
+				if (estimatedTokens <= budgetTokens) logger$4.info({
 					step: step.name,
 					estimatedTokens,
 					budgetTokens
@@ -8003,7 +8032,7 @@ async function runSteps(steps, deps, runId, phase, params) {
 			const critiqueResult = await runCritiqueLoop(artifactContent, phase, runId, phase, deps);
 			totalInput += critiqueResult.critiqueTokens.input + critiqueResult.refinementTokens.input;
 			totalOutput += critiqueResult.critiqueTokens.output + critiqueResult.refinementTokens.output;
-			logger$3.info({
+			logger$4.info({
 				step: step.name,
 				verdict: critiqueResult.verdict,
 				iterations: critiqueResult.iterations,
@@ -8011,7 +8040,7 @@ async function runSteps(steps, deps, runId, phase, params) {
 			}, "Step critique loop complete");
 		} catch (critiqueErr) {
 			const critiqueMsg = critiqueErr instanceof Error ? critiqueErr.message : String(critiqueErr);
-			logger$3.warn({
+			logger$4.warn({
 				step: step.name,
 				err: critiqueMsg
 			}, "Step critique loop threw an error — continuing without critique");
@@ -8021,7 +8050,7 @@ async function runSteps(steps, deps, runId, phase, params) {
 			const contentType = deriveContentType(phase, step.name);
 			const selectedMethods = selectMethods({ content_type: contentType }, usedElicitationMethods);
 			if (selectedMethods.length > 0) {
-				logger$3.info({
+				logger$4.info({
 					step: step.name,
 					methods: selectedMethods.map((m) => m.name),
 					contentType
@@ -8060,13 +8089,13 @@ async function runSteps(steps, deps, runId, phase, params) {
 								key: `${phase}-round-${roundIndex}-insights`,
 								value: elicitParsed.insights
 							});
-							logger$3.info({
+							logger$4.info({
 								step: step.name,
 								method: method.name,
 								roundIndex
 							}, "Elicitation insights stored in decision store");
 						}
-					} else logger$3.warn({
+					} else logger$4.warn({
 						step: step.name,
 						method: method.name,
 						status: elicitResult.status
@@ -8082,7 +8111,7 @@ async function runSteps(steps, deps, runId, phase, params) {
 			}
 		} catch (elicitErr) {
 			const elicitMsg = elicitErr instanceof Error ? elicitErr.message : String(elicitErr);
-			logger$3.warn({
+			logger$4.warn({
 				step: step.name,
 				err: elicitMsg
 			}, "Step elicitation threw an error — continuing without elicitation");
@@ -8424,7 +8453,7 @@ async function runAnalysisPhase(deps, params) {
 
 //#endregion
 //#region src/modules/phase-orchestrator/phases/planning.ts
-const logger$2 = createLogger("planning-phase");
+const logger$3 = createLogger("planning-phase");
 /** Maximum total prompt length in tokens (3,500 tokens × 4 chars/token = 14,000 chars) */
 const MAX_PROMPT_TOKENS = 3500;
 const MAX_PROMPT_CHARS = MAX_PROMPT_TOKENS * 4;
@@ -8651,7 +8680,7 @@ async function runPlanningMultiStep(deps, params) {
 			const techConstraintDecisions = allAnalysisDecisions.filter((d) => d.category === "technology-constraints");
 			const violation = detectTechStackViolation(techStack, techConstraintDecisions);
 			if (violation) {
-				logger$2.warn({ violation }, "Tech stack constraint violation detected — retrying step 3 with correction");
+				logger$3.warn({ violation }, "Tech stack constraint violation detected — retrying step 3 with correction");
 				const correctionPrefix = `CRITICAL CORRECTION: Your previous output was rejected because it violates the stated technology constraints.\n\nViolation: ${violation}\n\nYou MUST NOT use TypeScript, JavaScript, or Node.js for ANY backend service. Choose from Go, Kotlin/JVM, or Rust as stated in the technology constraints.\n\nRe-generate your output with a compliant tech stack. Everything else (NFRs, domain model, out-of-scope) can remain the same.\n\n---\n\n`;
 				const step3Template = await deps.pack.getPrompt("planning-step-3-nfrs");
 				const stepOutputs = new Map();
@@ -8678,10 +8707,10 @@ async function runPlanningMultiStep(deps, params) {
 					const retryTechStack = retryParsed.tech_stack;
 					const retryViolation = retryTechStack ? detectTechStackViolation(retryTechStack, techConstraintDecisions) : null;
 					if (!retryViolation) {
-						logger$2.info("Retry produced compliant tech stack — using corrected output");
+						logger$3.info("Retry produced compliant tech stack — using corrected output");
 						nfrsOutput = retryParsed;
-					} else logger$2.warn({ retryViolation }, "Retry still violates constraints — using original output");
-				} else logger$2.warn("Retry dispatch failed — using original output");
+					} else logger$3.warn({ retryViolation }, "Retry still violates constraints — using original output");
+				} else logger$3.warn("Retry dispatch failed — using original output");
 			}
 		}
 		const frs = frsOutput.functional_requirements;
@@ -8968,7 +8997,7 @@ const ReadinessOutputSchema = z.object({
 
 //#endregion
 //#region src/modules/phase-orchestrator/phases/solutioning.ts
-const logger$1 = createLogger("solutioning");
+const logger$2 = createLogger("solutioning");
 /** Base token budget for architecture generation (covers template + requirements) */
 const BASE_ARCH_PROMPT_TOKENS = 3e3;
 /** Base token budget for story generation (covers template + requirements + architecture) */
@@ -9377,7 +9406,7 @@ async function runReadinessCheck(deps, runId) {
 		input: tokenEstimate.input,
 		output: tokenEstimate.output
 	};
-	logger$1.info({
+	logger$2.info({
 		runId,
 		durationMs: dispatchResult.durationMs,
 		tokens: tokenEstimate
@@ -9638,7 +9667,7 @@ async function runSolutioningPhase(deps, params) {
 		let archResult;
 		if (existingArchArtifact) {
 			const existingDecisions = getDecisionsByPhaseForRun(deps.db, params.runId, "solutioning").filter((d) => d.category === "architecture");
-			logger$1.info({
+			logger$2.info({
 				runId: params.runId,
 				artifactId: existingArchArtifact.id,
 				decisionCount: existingDecisions.length
@@ -9669,7 +9698,7 @@ async function runSolutioningPhase(deps, params) {
 				output: totalOutput
 			}
 		};
-		logger$1.info({
+		logger$2.info({
 			runId: params.runId,
 			decisionCount: archResult.decisions.length,
 			mode: hasSteps ? "multi-step" : "single-dispatch"
@@ -9691,7 +9720,7 @@ async function runSolutioningPhase(deps, params) {
 		totalInput += readinessResult.tokenUsage.input;
 		totalOutput += readinessResult.tokenUsage.output;
 		if (readinessResult.verdict === "error") {
-			logger$1.error({
+			logger$2.error({
 				runId: params.runId,
 				error: readinessResult.error
 			}, "Readiness check agent failed");
@@ -9707,7 +9736,7 @@ async function runSolutioningPhase(deps, params) {
 				}
 			};
 		}
-		logger$1.info({
+		logger$2.info({
 			runId: params.runId,
 			verdict: readinessResult.verdict,
 			coverageScore: readinessResult.coverageScore,
@@ -9723,7 +9752,7 @@ async function runSolutioningPhase(deps, params) {
 				key: `finding-${i + 1}`,
 				value: JSON.stringify(finding)
 			});
-			logger$1.error({
+			logger$2.error({
 				runId: params.runId,
 				verdict: "NOT_READY",
 				coverageScore: readinessResult.coverageScore,
@@ -9789,7 +9818,7 @@ async function runSolutioningPhase(deps, params) {
 					"",
 					"Please generate additional or revised stories to specifically address each blocker above."
 				].join("\n");
-				logger$1.info({
+				logger$2.info({
 					runId: params.runId,
 					blockerCount: blockers.length
 				}, "Readiness NEEDS_WORK with blockers — retrying story generation with gap analysis");
@@ -9828,7 +9857,7 @@ async function runSolutioningPhase(deps, params) {
 				};
 				if (retryReadiness.verdict === "NOT_READY" || retryReadiness.verdict === "NEEDS_WORK") {
 					const retryBlockers = retryReadiness.findings.filter((f) => f.severity === "blocker");
-					logger$1.error({
+					logger$2.error({
 						runId: params.runId,
 						verdict: retryReadiness.verdict,
 						retryBlockers: retryBlockers.length
@@ -9852,7 +9881,7 @@ async function runSolutioningPhase(deps, params) {
 				}
 				const retryStories = retryResult.epics.reduce((sum, epic) => sum + epic.stories.length, 0);
 				const minorFindings$1 = retryReadiness.findings.filter((f) => f.severity === "minor");
-				if (minorFindings$1.length > 0) logger$1.warn({
+				if (minorFindings$1.length > 0) logger$2.warn({
 					runId: params.runId,
 					minorFindings: minorFindings$1
 				}, "Readiness READY with minor findings after retry");
@@ -9881,7 +9910,7 @@ async function runSolutioningPhase(deps, params) {
 				};
 			}
 			const majorFindings = readinessResult.findings.filter((f) => f.severity === "major");
-			logger$1.warn({
+			logger$2.warn({
 				runId: params.runId,
 				majorCount: majorFindings.length,
 				findings: readinessResult.findings
@@ -9897,7 +9926,7 @@ async function runSolutioningPhase(deps, params) {
 		const minorFindings = readinessResult.findings.filter((f) => f.severity === "minor");
 		if (minorFindings.length > 0) {
 			const verdictLabel = readinessResult.verdict === "READY" ? "READY" : "NEEDS_WORK (no blockers)";
-			logger$1.warn({
+			logger$2.warn({
 				runId: params.runId,
 				verdict: readinessResult.verdict,
 				minorFindings
@@ -10308,6 +10337,268 @@ async function runResearchPhase(deps, params) {
 	}
 }
 
+//#endregion
+//#region src/cli/commands/health.ts
+const logger$1 = createLogger("health-cmd");
+/** Default stall threshold in seconds — also used by supervisor default */
+const DEFAULT_STALL_THRESHOLD_SECONDS = 600;
+/**
+* Determine whether a ps output line represents the substrate pipeline orchestrator.
+* Handles invocation via:
+*   - `substrate run` (globally installed)
+*   - `substrate-ai run`
+*   - `node dist/cli/index.js run` (npm run substrate:dev)
+*   - `npx substrate run`
+*   - any node process whose command contains `run` with `--events` or `--stories`
+*
+* When `projectRoot` is provided, additionally checks that the command line
+* contains that path (via `--project-root` flag or as part of the binary/CWD path).
+* This ensures multi-project environments match the correct orchestrator.
+*/
+function isOrchestratorProcessLine(line, projectRoot) {
+	if (line.includes("grep")) return false;
+	let isOrchestrator = false;
+	if (line.includes("substrate run")) isOrchestrator = true;
+	else if (line.includes("substrate-ai run")) isOrchestrator = true;
+	else if (line.includes("index.js run")) isOrchestrator = true;
+	else if (line.includes("node") && /\srun(\s|$)/.test(line) && (line.includes("--events") || line.includes("--stories"))) isOrchestrator = true;
+	if (!isOrchestrator) return false;
+	if (projectRoot !== void 0) return line.includes(projectRoot);
+	return true;
+}
+function inspectProcessTree(opts) {
+	const { projectRoot, execFileSync: execFileSyncOverride } = opts ?? {};
+	const result = {
+		orchestrator_pid: null,
+		child_pids: [],
+		zombies: []
+	};
+	try {
+		let psOutput;
+		if (execFileSyncOverride !== void 0) psOutput = execFileSyncOverride("ps", ["-eo", "pid,ppid,stat,command"], {
+			encoding: "utf-8",
+			timeout: 5e3
+		});
+		else {
+			const { execFileSync } = __require("node:child_process");
+			psOutput = execFileSync("ps", ["-eo", "pid,ppid,stat,command"], {
+				encoding: "utf-8",
+				timeout: 5e3
+			});
+		}
+		const lines = psOutput.split("\n");
+		for (const line of lines) if (isOrchestratorProcessLine(line, projectRoot)) {
+			const match = line.trim().match(/^(\d+)/);
+			if (match) {
+				result.orchestrator_pid = parseInt(match[1], 10);
+				break;
+			}
+		}
+		if (result.orchestrator_pid !== null) for (const line of lines) {
+			const parts = line.trim().split(/\s+/);
+			if (parts.length >= 3) {
+				const pid = parseInt(parts[0], 10);
+				const ppid = parseInt(parts[1], 10);
+				const stat$2 = parts[2];
+				if (ppid === result.orchestrator_pid && pid !== result.orchestrator_pid) {
+					result.child_pids.push(pid);
+					if (stat$2.includes("Z")) result.zombies.push(pid);
+				}
+			}
+		}
+	} catch {}
+	return result;
+}
+/**
+* Collect all descendant PIDs of the given root PIDs by walking the process
+* tree recursively. This ensures that grandchildren of the orchestrator
+* (e.g. node subprocesses spawned by `claude -p`) are also killed during
+* stall recovery, leaving no orphan processes.
+*
+* Returns only the descendants — the root PIDs themselves are NOT included.
+*/
+function getAllDescendantPids(rootPids, execFileSyncOverride) {
+	if (rootPids.length === 0) return [];
+	try {
+		let psOutput;
+		if (execFileSyncOverride !== void 0) psOutput = execFileSyncOverride("ps", ["-eo", "pid,ppid"], {
+			encoding: "utf-8",
+			timeout: 5e3
+		});
+		else {
+			const { execFileSync } = __require("node:child_process");
+			psOutput = execFileSync("ps", ["-eo", "pid,ppid"], {
+				encoding: "utf-8",
+				timeout: 5e3
+			});
+		}
+		const childrenOf = new Map();
+		for (const line of psOutput.split("\n")) {
+			const parts = line.trim().split(/\s+/);
+			if (parts.length >= 2) {
+				const pid = parseInt(parts[0], 10);
+				const ppid = parseInt(parts[1], 10);
+				if (!isNaN(pid) && !isNaN(ppid) && pid > 0) {
+					if (!childrenOf.has(ppid)) childrenOf.set(ppid, []);
+					childrenOf.get(ppid).push(pid);
+				}
+			}
+		}
+		const descendants = [];
+		const seen = new Set(rootPids);
+		const queue = [...rootPids];
+		while (queue.length > 0) {
+			const current = queue.shift();
+			const children = childrenOf.get(current) ?? [];
+			for (const child of children) if (!seen.has(child)) {
+				seen.add(child);
+				descendants.push(child);
+				queue.push(child);
+			}
+		}
+		return descendants;
+	} catch {
+		return [];
+	}
+}
+/**
+* Fetch pipeline health data as a structured object without any stdout side-effects.
+* Used by runSupervisorAction to poll health without formatting overhead.
+*
+* Returns a NO_PIPELINE_RUNNING health object for all graceful "no data" cases
+* (missing DB, missing run, terminal run status). Throws only on unexpected errors.
+*/
+async function getAutoHealthData(options) {
+	const { runId, projectRoot } = options;
+	const dbRoot = await resolveMainRepoRoot(projectRoot);
+	const dbPath = join(dbRoot, ".substrate", "substrate.db");
+	const NO_PIPELINE = {
+		verdict: "NO_PIPELINE_RUNNING",
+		run_id: null,
+		status: null,
+		current_phase: null,
+		staleness_seconds: 0,
+		last_activity: "",
+		process: {
+			orchestrator_pid: null,
+			child_pids: [],
+			zombies: []
+		},
+		stories: {
+			active: 0,
+			completed: 0,
+			escalated: 0,
+			details: {}
+		}
+	};
+	if (!existsSync(dbPath)) return NO_PIPELINE;
+	const dbWrapper = new DatabaseWrapper(dbPath);
+	try {
+		dbWrapper.open();
+		const db = dbWrapper.db;
+		let run;
+		if (runId !== void 0) run = getPipelineRunById(db, runId);
+		else run = getLatestRun(db);
+		if (run === void 0) return NO_PIPELINE;
+		const updatedAt = parseDbTimestampAsUtc(run.updated_at);
+		const stalenessSeconds = Math.round((Date.now() - updatedAt.getTime()) / 1e3);
+		let storyDetails = {};
+		let active = 0;
+		let completed = 0;
+		let escalated = 0;
+		try {
+			if (run.token_usage_json) {
+				const state = JSON.parse(run.token_usage_json);
+				if (state.stories) for (const [key, s] of Object.entries(state.stories)) {
+					storyDetails[key] = {
+						phase: s.phase,
+						review_cycles: s.reviewCycles
+					};
+					if (s.phase === "COMPLETE") completed++;
+					else if (s.phase === "ESCALATED") escalated++;
+					else if (s.phase !== "PENDING") active++;
+				}
+			}
+		} catch {}
+		const processInfo = inspectProcessTree({ projectRoot });
+		let verdict = "NO_PIPELINE_RUNNING";
+		if (run.status === "running") if (processInfo.orchestrator_pid === null && active === 0 && completed > 0) verdict = "NO_PIPELINE_RUNNING";
+		else if (processInfo.zombies.length > 0) verdict = "STALLED";
+		else if (processInfo.orchestrator_pid !== null && processInfo.child_pids.length > 0 && stalenessSeconds > DEFAULT_STALL_THRESHOLD_SECONDS) verdict = "HEALTHY";
+		else if (stalenessSeconds > DEFAULT_STALL_THRESHOLD_SECONDS) verdict = "STALLED";
+		else if (processInfo.orchestrator_pid !== null && processInfo.child_pids.length === 0 && active > 0) verdict = "STALLED";
+		else verdict = "HEALTHY";
+		else if (run.status === "completed" || run.status === "failed" || run.status === "stopped") verdict = "NO_PIPELINE_RUNNING";
+		return {
+			verdict,
+			run_id: run.id,
+			status: run.status,
+			current_phase: run.current_phase,
+			staleness_seconds: stalenessSeconds,
+			last_activity: run.updated_at,
+			process: processInfo,
+			stories: {
+				active,
+				completed,
+				escalated,
+				details: storyDetails
+			}
+		};
+	} finally {
+		try {
+			dbWrapper.close();
+		} catch {}
+	}
+}
+async function runHealthAction(options) {
+	const { outputFormat } = options;
+	try {
+		const health = await getAutoHealthData(options);
+		if (outputFormat === "json") process.stdout.write(formatOutput(health, "json", true) + "\n");
+		else {
+			const verdictLabel = health.verdict === "HEALTHY" ? "HEALTHY" : health.verdict === "STALLED" ? "STALLED" : "NO PIPELINE RUNNING";
+			process.stdout.write(`\nPipeline Health: ${verdictLabel}\n`);
+			if (health.run_id !== null) {
+				process.stdout.write(`  Run:          ${health.run_id}\n`);
+				process.stdout.write(`  Status:       ${health.status}\n`);
+				process.stdout.write(`  Phase:        ${health.current_phase ?? "N/A"}\n`);
+				process.stdout.write(`  Last Active:  ${health.last_activity} (${health.staleness_seconds}s ago)\n`);
+				const processInfo = health.process;
+				if (processInfo.orchestrator_pid !== null) {
+					process.stdout.write(`  Orchestrator: PID ${processInfo.orchestrator_pid}\n`);
+					process.stdout.write(`  Children:     ${processInfo.child_pids.length} active`);
+					if (processInfo.zombies.length > 0) process.stdout.write(` (${processInfo.zombies.length} ZOMBIE)`);
+					process.stdout.write("\n");
+				} else process.stdout.write("  Orchestrator: not running\n");
+				const storyDetails = health.stories.details;
+				if (Object.keys(storyDetails).length > 0) {
+					process.stdout.write("\n  Stories:\n");
+					for (const [key, s] of Object.entries(storyDetails)) process.stdout.write(`    ${key}: ${s.phase} (${s.review_cycles} review cycles)\n`);
+					process.stdout.write(`\n  Summary: ${health.stories.active} active, ${health.stories.completed} completed, ${health.stories.escalated} escalated\n`);
+				}
+			}
+		}
+		return 0;
+	} catch (err) {
+		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$1.error({ err }, "health action failed");
+		return 1;
+	}
+}
+function registerHealthCommand(program, _version = "0.0.0", projectRoot = process.cwd()) {
+	program.command("health").description("Check pipeline health: process status, stall detection, and verdict").option("--run-id <id>", "Pipeline run ID to query (defaults to latest)").option("--project-root <path>", "Project root directory", projectRoot).option("--output-format <format>", "Output format: human (default) or json", "human").action(async (opts) => {
+		const outputFormat = opts.outputFormat === "json" ? "json" : "human";
+		const exitCode = await runHealthAction({
+			outputFormat,
+			runId: opts.runId,
+			projectRoot: opts.projectRoot
+		});
+		process.exitCode = exitCode;
+	});
+}
+
 //#endregion
 //#region src/cli/commands/run.ts
 const logger = createLogger("run-cmd");
@@ -10454,6 +10745,16 @@ async function runRunAction(options) {
 				return 0;
 			}
 		}
+		const staleRuns = getRunningPipelineRuns(db) ?? [];
+		if (staleRuns.length > 0) {
+			const processInfo = inspectProcessTree({ projectRoot });
+			let swept = 0;
+			for (const stale of staleRuns) if (processInfo.orchestrator_pid === null) {
+				updatePipelineRun(db, stale.id, { status: "failed" });
+				swept++;
+			}
+			if (swept > 0) process.stderr.write(`Swept ${swept} stale pipeline run(s) (dead orchestrator)\n`);
+		}
 		const pipelineRun = createPipelineRun(db, {
 			methodology: pack.manifest.name,
 			start_phase: "implementation",
@@ -11171,5 +11472,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, getSubstrateDefaultSettings, parseDbTimestampAsUtc, registerRunCommand, resolveBmadMethodSrcPath, resolveBmadMethodVersion, resolveMainRepoRoot, runAnalysisPhase, runMigrations, runPlanningPhase, runRunAction, runSolutioningPhase, validateStopAfterFromConflict };
-//# sourceMappingURL=run-CoP8UQU3.js.map
+export { DatabaseWrapper, SUBSTRATE_OWNED_SETTINGS_KEYS, VALID_PHASES, buildPipelineStatusOutput, createContextCompiler, createDispatcher, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStopAfterGate, findPackageRoot, formatOutput, formatPhaseCompletionSummary, formatPipelineStatusHuman, formatPipelineSummary, formatTokenTelemetry, getAllDescendantPids, getAutoHealthData, getSubstrateDefaultSettings, registerHealthCommand, registerRunCommand, resolveBmadMethodSrcPath, resolveBmadMethodVersion, resolveMainRepoRoot, runAnalysisPhase, runMigrations, runPlanningPhase, runRunAction, runSolutioningPhase, validateStopAfterFromConflict };
+//# sourceMappingURL=run-CLpXJNQ8.js.map