substrate-ai 0.2.20 → 0.2.21

package/dist/{run-CcWb6Kb-.js → run-BLIgARum.js}

@@ -1,7 +1,7 @@
 import { createLogger } from "./logger-D2fS2ccL.js";
 import { AdapterRegistry, createEventBus, createTuiApp, isTuiCapable, printNonTtyWarning } from "./event-bus-BMxhfxfT.js";
 import { addTokenUsage, createDecision, createPipelineRun, createRequirement, getArtifactByTypeForRun, getArtifactsByRun, getDecisionsByCategory, getDecisionsByPhase, getDecisionsByPhaseForRun, getLatestRun, getPipelineRunById, getRunningPipelineRuns, getTokenUsageSummary, registerArtifact, updatePipelineRun, updatePipelineRunConfig, upsertDecision } from "./decisions-Dq4cAA2L.js";
-import { ESCALATION_DIAGNOSIS, OPERATIONAL_FINDING, STORY_METRICS, STORY_OUTCOME, aggregateTokenUsageForRun, aggregateTokenUsageForStory, getStoryMetricsForRun, writeRunMetrics, writeStoryMetrics } from "./operational-Dq4IfJzE.js";
+import { ESCALATION_DIAGNOSIS, OPERATIONAL_FINDING, STORY_METRICS, STORY_OUTCOME, TEST_EXPANSION_FINDING, TEST_PLAN, aggregateTokenUsageForRun, aggregateTokenUsageForStory, getStoryMetricsForRun, writeRunMetrics, writeStoryMetrics } from "./operational-CnMlvWqc.js";
 import { createRequire } from "module";
 import { dirname, join } from "path";
 import { access, readFile, readdir, stat } from "fs/promises";
@@ -539,7 +539,7 @@ const migration010RunMetrics = {
 
 //#endregion
 //#region src/persistence/migrations/index.ts
-const logger$17 = createLogger("persistence:migrations");
+const logger$19 = createLogger("persistence:migrations");
 const MIGRATIONS = [
 	initialSchemaMigration,
 	costTrackerSchemaMigration,
@@ -557,7 +557,7 @@ const MIGRATIONS = [
 * Safe to call multiple times — already-applied migrations are skipped.
 */
 function runMigrations(db) {
-	logger$17.info("Starting migration runner");
+	logger$19.info("Starting migration runner");
 	db.exec(`
     CREATE TABLE IF NOT EXISTS schema_migrations (
       version   INTEGER PRIMARY KEY,
@@ -568,12 +568,12 @@ function runMigrations(db) {
 	const appliedVersions = new Set(db.prepare("SELECT version FROM schema_migrations").all().map((row) => row.version));
 	const pending = MIGRATIONS.filter((m) => !appliedVersions.has(m.version)).sort((a, b) => a.version - b.version);
 	if (pending.length === 0) {
-		logger$17.info("No pending migrations");
+		logger$19.info("No pending migrations");
 		return;
 	}
 	const insertMigration = db.prepare("INSERT INTO schema_migrations (version, name) VALUES (?, ?)");
 	for (const migration of pending) {
-		logger$17.info({
+		logger$19.info({
 			version: migration.version,
 			name: migration.name
 		}, "Applying migration");
@@ -587,14 +587,14 @@ function runMigrations(db) {
 			});
 			applyMigration();
 		}
-		logger$17.info({ version: migration.version }, "Migration applied successfully");
+		logger$19.info({ version: migration.version }, "Migration applied successfully");
 	}
-	logger$17.info({ count: pending.length }, "All pending migrations applied");
+	logger$19.info({ count: pending.length }, "All pending migrations applied");
 }
 
 //#endregion
 //#region src/persistence/database.ts
-const logger$16 = createLogger("persistence:database");
+const logger$18 = createLogger("persistence:database");
 /**
 * Thin wrapper that opens a SQLite database, applies required PRAGMAs,
 * and exposes the raw BetterSqlite3 instance.
@@ -611,14 +611,14 @@ var DatabaseWrapper = class {
 	*/
 	open() {
 		if (this._db !== null) return;
-		logger$16.info({ path: this._path }, "Opening SQLite database");
+		logger$18.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$16.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$18.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$16.info({ path: this._path }, "SQLite database opened with WAL mode");
+		logger$18.info({ path: this._path }, "SQLite database opened with WAL mode");
 	}
 	/**
 	* Close the database. Idempotent — calling close() when already closed is a no-op.
@@ -627,7 +627,7 @@ var DatabaseWrapper = class {
 		if (this._db === null) return;
 		this._db.close();
 		this._db = null;
-		logger$16.info({ path: this._path }, "SQLite database closed");
+		logger$18.info({ path: this._path }, "SQLite database closed");
 	}
 	/**
 	* Return the raw BetterSqlite3 instance.
@@ -1208,11 +1208,38 @@ function buildPipelineStatusOutput(run, tokenSummary, decisionsCount, storiesCou
 		totalCost += row.total_cost_usd;
 	}
 	let activeDispatches = 0;
+	let storiesSummary;
 	try {
 		if (run.token_usage_json) {
 			const state = JSON.parse(run.token_usage_json);
-			if (state.stories) {
-				for (const s of Object.values(state.stories)) if (s.phase !== "PENDING" && s.phase !== "COMPLETE" && s.phase !== "ESCALATED") activeDispatches++;
+			if (state.stories && Object.keys(state.stories).length > 0) {
+				const now = Date.now();
+				let completed = 0;
+				let inProgress = 0;
+				let escalated = 0;
+				let pending = 0;
+				const details = {};
+				for (const [key, s] of Object.entries(state.stories)) {
+					const phase = s.phase ?? "PENDING";
+					if (phase !== "PENDING" && phase !== "COMPLETE" && phase !== "ESCALATED") activeDispatches++;
+					if (phase === "COMPLETE") completed++;
+					else if (phase === "ESCALATED") escalated++;
+					else if (phase === "PENDING") pending++;
+					else inProgress++;
+					const elapsed = s.startedAt != null ? Math.max(0, Math.round((now - new Date(s.startedAt).getTime()) / 1e3)) : 0;
+					details[key] = {
+						phase,
+						review_cycles: s.reviewCycles ?? 0,
+						elapsed_seconds: elapsed
+					};
+				}
+				storiesSummary = {
+					completed,
+					in_progress: inProgress,
+					escalated,
+					pending,
+					details
+				};
 			}
 		}
 	} catch {}
@@ -1230,7 +1257,8 @@ function buildPipelineStatusOutput(run, tokenSummary, decisionsCount, storiesCou
 		last_activity: run.updated_at,
 		staleness_seconds: Math.round((Date.now() - parseDbTimestampAsUtc(run.updated_at).getTime()) / 1e3),
 		last_event_ts: run.updated_at,
-		active_dispatches: activeDispatches
+		active_dispatches: activeDispatches,
+		...storiesSummary !== void 0 ? { stories: storiesSummary } : {}
 	};
 }
 /**
@@ -1259,6 +1287,19 @@ function formatPipelineStatusHuman(status) {
 	lines.push(`  Total Cost: $${status.total_tokens.cost_usd.toFixed(4)}`);
 	lines.push(`  Decisions: ${status.decisions_count}`);
 	lines.push(`  Stories: ${status.stories_count}`);
+	if (status.stories !== void 0 && Object.keys(status.stories.details).length > 0) {
+		lines.push("");
+		lines.push("  Sprint Progress:");
+		lines.push("  " + "─".repeat(68));
+		lines.push(`  ${"STORY".padEnd(10)} ${"PHASE".padEnd(24)} ${"CYCLES".padEnd(8)} ELAPSED`);
+		lines.push("  " + "─".repeat(68));
+		for (const [key, detail] of Object.entries(status.stories.details)) {
+			const elapsed = detail.elapsed_seconds > 0 ? `${detail.elapsed_seconds}s` : "-";
+			lines.push(`  ${key.padEnd(10)} ${detail.phase.padEnd(24)} ${String(detail.review_cycles).padEnd(8)} ${elapsed}`);
+		}
+		lines.push("  " + "─".repeat(68));
+		lines.push(`  Completed: ${status.stories.completed}  In Progress: ${status.stories.in_progress}  Escalated: ${status.stories.escalated}  Pending: ${status.stories.pending}`);
+	}
 	return lines.join("\n");
 }
 /**
@@ -2496,7 +2537,7 @@ function truncateToTokens(text, maxTokens) {
 
 //#endregion
 //#region src/modules/context-compiler/context-compiler-impl.ts
-const logger$15 = createLogger("context-compiler");
+const logger$17 = createLogger("context-compiler");
 /**
 * Fraction of the original token budget that must remain (after required +
 * important sections) before an optional section is included.
@@ -2588,7 +2629,7 @@ var ContextCompilerImpl = class {
 				includedParts.push(truncated);
 				remainingBudget -= truncatedTokens;
 				anyTruncated = true;
-				logger$15.warn({
+				logger$17.warn({
 					section: section.name,
 					originalTokens: tokens,
 					budgetTokens: truncatedTokens
@@ -2602,7 +2643,7 @@ var ContextCompilerImpl = class {
 				});
 			} else {
 				anyTruncated = true;
-				logger$15.warn({
+				logger$17.warn({
 					section: section.name,
 					tokens
 				}, "Context compiler: omitted \"important\" section — no budget remaining");
@@ -2629,7 +2670,7 @@ var ContextCompilerImpl = class {
 				} else {
 					if (tokens > 0) {
 						anyTruncated = true;
-						logger$15.warn({
+						logger$17.warn({
 							section: section.name,
 							tokens,
 							budgetFractionRemaining: budgetFractionRemaining.toFixed(2)
@@ -2914,7 +2955,7 @@ function parseYamlResult(yamlText, schema) {
 
 //#endregion
 //#region src/modules/agent-dispatch/dispatcher-impl.ts
-const logger$14 = createLogger("agent-dispatch");
+const logger$16 = createLogger("agent-dispatch");
 const SHUTDOWN_GRACE_MS = 1e4;
 const SHUTDOWN_MAX_WAIT_MS = 3e4;
 const CHARS_PER_TOKEN = 4;
@@ -2957,7 +2998,7 @@ function getAvailableMemory() {
 				encoding: "utf-8"
 			}).trim(), 10);
 			if (pressureLevel >= 4) {
-				logger$14.warn({ pressureLevel }, "macOS kernel reports critical memory pressure");
+				logger$16.warn({ pressureLevel }, "macOS kernel reports critical memory pressure");
 				return 0;
 			}
 		} catch {}
@@ -2972,7 +3013,7 @@ function getAvailableMemory() {
 			const speculative = parseInt(vmstat.match(/Pages speculative:\s+(\d+)/)?.[1] ?? "0", 10);
 			const available = (free + purgeable + speculative) * pageSize;
 			if (pressureLevel >= 2) {
-				logger$14.warn({
+				logger$16.warn({
 					pressureLevel,
 					availableBeforeDiscount: available
 				}, "macOS kernel reports memory pressure — discounting estimate");
@@ -3051,7 +3092,7 @@ var DispatcherImpl = class {
 					resolve: typedResolve,
 					reject
 				});
-				logger$14.debug({
+				logger$16.debug({
 					id,
 					queueLength: this._queue.length
 				}, "Dispatch queued");
@@ -3082,7 +3123,7 @@ var DispatcherImpl = class {
 	async shutdown() {
 		this._shuttingDown = true;
 		this._stopMemoryPressureTimer();
-		logger$14.info({
+		logger$16.info({
 			running: this._running.size,
 			queued: this._queue.length
 		}, "Dispatcher shutting down");
@@ -3115,13 +3156,13 @@ var DispatcherImpl = class {
 				}
 			}, 50);
 		});
-		logger$14.info("Dispatcher shutdown complete");
+		logger$16.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$14.warn({
+			logger$16.warn({
 				id,
 				agent
 			}, "No adapter found for agent");
@@ -3167,7 +3208,7 @@ var DispatcherImpl = class {
 		});
 		const startedAt = Date.now();
 		proc.on("error", (err) => {
-			logger$14.error({
+			logger$16.error({
 				id,
 				binary: cmd.binary,
 				error: err.message
@@ -3175,7 +3216,7 @@ var DispatcherImpl = class {
 		});
 		if (proc.stdin !== null) {
 			proc.stdin.on("error", (err) => {
-				if (err.code !== "EPIPE") logger$14.warn({
+				if (err.code !== "EPIPE") logger$16.warn({
 					id,
 					error: err.message
 				}, "stdin write error");
@@ -3217,7 +3258,7 @@ var DispatcherImpl = class {
 			agent,
 			taskType
 		});
-		logger$14.debug({
+		logger$16.debug({
 			id,
 			agent,
 			taskType,
@@ -3234,7 +3275,7 @@ var DispatcherImpl = class {
 				dispatchId: id,
 				timeoutMs
 			});
-			logger$14.warn({
+			logger$16.warn({
 				id,
 				agent,
 				taskType,
@@ -3288,7 +3329,7 @@ var DispatcherImpl = class {
 					exitCode: code,
 					output: stdout
 				});
-				logger$14.debug({
+				logger$16.debug({
 					id,
 					agent,
 					taskType,
@@ -3314,7 +3355,7 @@ var DispatcherImpl = class {
 					error: stderr || `Process exited with code ${String(code)}`,
 					exitCode: code
 				});
-				logger$14.debug({
+				logger$16.debug({
 					id,
 					agent,
 					taskType,
@@ -3373,7 +3414,7 @@ var DispatcherImpl = class {
 		const next = this._queue.shift();
 		if (next === void 0) return;
 		next.handle.status = "running";
-		logger$14.debug({
+		logger$16.debug({
 			id: next.id,
 			queueLength: this._queue.length
 		}, "Dequeued dispatch");
@@ -3386,7 +3427,7 @@ var DispatcherImpl = class {
 	_isMemoryPressured() {
 		const free = getAvailableMemory();
 		if (free < MIN_FREE_MEMORY_BYTES) {
-			logger$14.warn({
+			logger$16.warn({
 				freeMB: Math.round(free / 1024 / 1024),
 				thresholdMB: Math.round(MIN_FREE_MEMORY_BYTES / 1024 / 1024)
 			}, "Memory pressure detected — holding dispatch queue");
@@ -3511,7 +3552,7 @@ function pickRecommendation(distribution, profile, totalIssues, reviewCycles, la
 
 //#endregion
 //#region src/modules/compiled-workflows/prompt-assembler.ts
-const logger$13 = createLogger("compiled-workflows:prompt-assembler");
+const logger$15 = createLogger("compiled-workflows:prompt-assembler");
 /**
 * Assemble a final prompt from a template and sections map.
 *
@@ -3536,7 +3577,7 @@ function assemblePrompt(template, sections, tokenCeiling = 2200) {
 		tokenCount,
 		truncated: false
 	};
-	logger$13.warn({
+	logger$15.warn({
 		tokenCount,
 		ceiling: tokenCeiling
 	}, "Prompt exceeds token ceiling — truncating optional sections");
@@ -3552,10 +3593,10 @@ function assemblePrompt(template, sections, tokenCeiling = 2200) {
 			const targetSectionTokens = Math.max(0, currentSectionTokens - overBy);
 			if (targetSectionTokens === 0) {
 				contentMap[section.name] = "";
-				logger$13.warn({ sectionName: section.name }, "Section eliminated to fit token budget");
+				logger$15.warn({ sectionName: section.name }, "Section eliminated to fit token budget");
 			} else {
 				contentMap[section.name] = truncateToTokens(section.content, targetSectionTokens);
-				logger$13.warn({
+				logger$15.warn({
 					sectionName: section.name,
 					targetSectionTokens
 				}, "Section truncated to fit token budget");
@@ -3566,7 +3607,7 @@ function assemblePrompt(template, sections, tokenCeiling = 2200) {
 		}
 		if (tokenCount <= tokenCeiling) break;
 	}
-	if (tokenCount > tokenCeiling) logger$13.warn({
+	if (tokenCount > tokenCeiling) logger$15.warn({
 		tokenCount,
 		ceiling: tokenCeiling
 	}, "Required sections alone exceed token ceiling — returning over-budget prompt");
@@ -3704,14 +3745,89 @@ const CodeReviewResultSchema = z.object({
 	agentVerdict: data.verdict,
 	verdict: computeVerdict(data.issue_list)
 }));
+/**
+* Schema for the YAML output contract of the test-plan sub-agent.
+*
+* The agent must emit YAML with result, test_files, test_categories, and coverage_notes.
+* Example:
+*   result: success
+*   test_files:
+*     - src/modules/foo/__tests__/foo.test.ts
+*   test_categories:
+*     - unit
+*     - integration
+*   coverage_notes: "AC1 covered by foo.test.ts"
+*/
+const TestPlanResultSchema = z.object({
+	result: z.preprocess((val) => val === "failure" ? "failed" : val, z.enum(["success", "failed"])),
+	test_files: z.array(z.string()).default([]),
+	test_categories: z.array(z.string()).default([]),
+	coverage_notes: z.string().default("")
+});
+/**
+* Schema for a single coverage gap identified during test expansion analysis.
+*/
+const CoverageGapSchema = z.object({
+	ac_ref: z.string(),
+	description: z.string(),
+	gap_type: z.enum([
+		"missing-e2e",
+		"missing-integration",
+		"unit-only"
+	])
+});
+/**
+* Schema for a single suggested test generated during test expansion analysis.
+*/
+const SuggestedTestSchema = z.object({
+	test_name: z.string(),
+	test_type: z.enum([
+		"e2e",
+		"integration",
+		"unit"
+	]),
+	description: z.string(),
+	target_ac: z.string().optional()
+});
+/**
+* Schema for the YAML output contract of the test-expansion sub-agent.
+*
+* The agent must emit YAML with expansion_priority, coverage_gaps, and suggested_tests.
+* Example:
+*   expansion_priority: medium
+*   coverage_gaps:
+*     - ac_ref: AC1
+*       description: "Happy path not exercised at module boundary"
+*       gap_type: missing-integration
+*   suggested_tests:
+*     - test_name: "runFoo integration happy path"
+*       test_type: integration
+*       description: "Test runFoo with real DB to verify AC1 end-to-end"
+*       target_ac: AC1
+*   notes: "Unit coverage is solid but integration layer is untested."
+*/
+const TestExpansionResultSchema = z.object({
+	expansion_priority: z.preprocess((val) => [
+		"low",
+		"medium",
+		"high"
+	].includes(val) ? val : "low", z.enum([
+		"low",
+		"medium",
+		"high"
+	])),
+	coverage_gaps: z.array(CoverageGapSchema).default([]),
+	suggested_tests: z.array(SuggestedTestSchema).default([]),
+	notes: z.string().optional()
+});
 
 //#endregion
 //#region src/modules/compiled-workflows/create-story.ts
-const logger$12 = createLogger("compiled-workflows:create-story");
+const logger$14 = createLogger("compiled-workflows:create-story");
 /**
 * Hard ceiling for the assembled create-story prompt.
 */
-const TOKEN_CEILING$2 = 3e3;
+const TOKEN_CEILING$4 = 3e3;
 /**
 * Execute the compiled create-story workflow.
 *
@@ -3731,7 +3847,7 @@ const TOKEN_CEILING$2 = 3e3;
 */
 async function runCreateStory(deps, params) {
 	const { epicId, storyKey, pipelineRunId } = params;
-	logger$12.debug({
+	logger$14.debug({
 		epicId,
 		storyKey,
 		pipelineRunId
@@ -3741,7 +3857,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$12.error({ error }, "Failed to retrieve create-story prompt template");
+		logger$14.error({ error }, "Failed to retrieve create-story prompt template");
 		return {
 			result: "failed",
 			error: `Failed to retrieve prompt template: ${error}`,
@@ -3754,7 +3870,7 @@ async function runCreateStory(deps, params) {
 	const implementationDecisions = getImplementationDecisions(deps);
 	const epicShardContent = getEpicShard(implementationDecisions, epicId, deps.projectRoot);
 	const prevDevNotesContent = getPrevDevNotes(implementationDecisions, epicId);
-	const archConstraintsContent = getArchConstraints$1(deps);
+	const archConstraintsContent = getArchConstraints$2(deps);
 	const storyTemplateContent = await getStoryTemplate(deps);
 	const { prompt, tokenCount, truncated } = assemblePrompt(template, [
 		{
@@ -3782,11 +3898,11 @@ async function runCreateStory(deps, params) {
 			content: storyTemplateContent,
 			priority: "important"
 		}
-	], TOKEN_CEILING$2);
-	logger$12.debug({
+	], TOKEN_CEILING$4);
+	logger$14.debug({
 		tokenCount,
 		truncated,
-		tokenCeiling: TOKEN_CEILING$2
+		tokenCeiling: TOKEN_CEILING$4
 	}, "Prompt assembled for create-story");
 	const handle = deps.dispatcher.dispatch({
 		prompt,
@@ -3800,7 +3916,7 @@ async function runCreateStory(deps, params) {
 		dispatchResult = await handle.result;
 	} catch (err) {
 		const error = err instanceof Error ? err.message : String(err);
-		logger$12.error({
+		logger$14.error({
 			epicId,
 			storyKey,
 			error
@@ -3821,7 +3937,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$12.warn({
+		logger$14.warn({
 			epicId,
 			storyKey,
 			exitCode: dispatchResult.exitCode
@@ -3833,7 +3949,7 @@ async function runCreateStory(deps, params) {
 		};
 	}
 	if (dispatchResult.status === "timeout") {
-		logger$12.warn({
+		logger$14.warn({
 			epicId,
 			storyKey
 		}, "Create-story dispatch timed out");
@@ -3846,7 +3962,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$12.warn({
+		logger$14.warn({
 			epicId,
 			storyKey,
 			details,
@@ -3862,7 +3978,7 @@ async function runCreateStory(deps, params) {
 	const parseResult = CreateStoryResultSchema.safeParse(dispatchResult.parsed);
 	if (!parseResult.success) {
 		const details = parseResult.error.message;
-		logger$12.warn({
+		logger$14.warn({
 			epicId,
 			storyKey,
 			details
@@ -3875,7 +3991,7 @@ async function runCreateStory(deps, params) {
 		};
 	}
 	const parsed = parseResult.data;
-	logger$12.info({
+	logger$14.info({
 		epicId,
 		storyKey,
 		storyFile: parsed.story_file,
@@ -3897,7 +4013,7 @@ function getImplementationDecisions(deps) {
 	try {
 		return getDecisionsByPhase(deps.db, "implementation");
 	} catch (err) {
-		logger$12.warn({ error: err instanceof Error ? err.message : String(err) }, "Failed to retrieve implementation decisions");
+		logger$14.warn({ error: err instanceof Error ? err.message : String(err) }, "Failed to retrieve implementation decisions");
 		return [];
 	}
 }
@@ -3913,13 +4029,13 @@ function getEpicShard(decisions, epicId, projectRoot) {
 		if (projectRoot) {
 			const fallback = readEpicShardFromFile(projectRoot, epicId);
 			if (fallback) {
-				logger$12.info({ epicId }, "Using file-based fallback for epic shard (decisions table empty)");
+				logger$14.info({ epicId }, "Using file-based fallback for epic shard (decisions table empty)");
 				return fallback;
 			}
 		}
 		return "";
 	} catch (err) {
-		logger$12.warn({
+		logger$14.warn({
 			epicId,
 			error: err instanceof Error ? err.message : String(err)
 		}, "Failed to retrieve epic shard");
@@ -3936,7 +4052,7 @@ function getPrevDevNotes(decisions, epicId) {
 		if (devNotes.length === 0) return "";
 		return devNotes[devNotes.length - 1].value;
 	} catch (err) {
-		logger$12.warn({
+		logger$14.warn({
 			epicId,
 			error: err instanceof Error ? err.message : String(err)
 		}, "Failed to retrieve prev dev notes");
@@ -3948,7 +4064,7 @@ function getPrevDevNotes(decisions, epicId) {
 * Looks for decisions with phase='solutioning', category='architecture'.
 * Falls back to reading _bmad-output/architecture/architecture.md on disk if decisions are empty.
 */
-function getArchConstraints$1(deps) {
+function getArchConstraints$2(deps) {
 	try {
 		const decisions = getDecisionsByPhase(deps.db, "solutioning");
 		const constraints = decisions.filter((d) => d.category === "architecture");
@@ -3956,13 +4072,13 @@ function getArchConstraints$1(deps) {
 		if (deps.projectRoot) {
 			const fallback = readArchConstraintsFromFile(deps.projectRoot);
 			if (fallback) {
-				logger$12.info("Using file-based fallback for architecture constraints (decisions table empty)");
+				logger$14.info("Using file-based fallback for architecture constraints (decisions table empty)");
 				return fallback;
 			}
 		}
 		return "";
 	} catch (err) {
-		logger$12.warn({ error: err instanceof Error ? err.message : String(err) }, "Failed to retrieve architecture constraints");
+		logger$14.warn({ error: err instanceof Error ? err.message : String(err) }, "Failed to retrieve architecture constraints");
 		return "";
 	}
 }
@@ -3982,7 +4098,7 @@ function readEpicShardFromFile(projectRoot, epicId) {
 		const match = pattern.exec(content);
 		return match ? match[0].trim() : "";
 	} catch (err) {
-		logger$12.warn({
+		logger$14.warn({
 			epicId,
 			error: err instanceof Error ? err.message : String(err)
 		}, "File-based epic shard fallback failed");
@@ -4005,7 +4121,7 @@ function readArchConstraintsFromFile(projectRoot) {
 		const content = readFileSync$1(archPath, "utf-8");
 		return content.slice(0, 1500);
 	} catch (err) {
-		logger$12.warn({ error: err instanceof Error ? err.message : String(err) }, "File-based architecture fallback failed");
+		logger$14.warn({ error: err instanceof Error ? err.message : String(err) }, "File-based architecture fallback failed");
 		return "";
 	}
 }
@@ -4018,14 +4134,14 @@ async function getStoryTemplate(deps) {
 	try {
 		return await deps.pack.getTemplate("story");
 	} catch (err) {
-		logger$12.warn({ error: err instanceof Error ? err.message : String(err) }, "Failed to retrieve story template from pack");
+		logger$14.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$11 = createLogger("compiled-workflows:git-helpers");
+const logger$13 = createLogger("compiled-workflows:git-helpers");
 /**
 * Capture the full git diff for HEAD (working tree vs current commit).
 *
@@ -4149,7 +4265,7 @@ async function runGitCommand(args, cwd, logLabel) {
 			stderr += chunk.toString("utf-8");
 		});
 		proc.on("error", (err) => {
-			logger$11.warn({
+			logger$13.warn({
 				label: logLabel,
 				cwd,
 				error: err.message
@@ -4158,7 +4274,7 @@ async function runGitCommand(args, cwd, logLabel) {
 		});
 		proc.on("close", (code) => {
 			if (code !== 0) {
-				logger$11.warn({
+				logger$13.warn({
 					label: logLabel,
 					cwd,
 					code,
@@ -4174,7 +4290,7 @@ async function runGitCommand(args, cwd, logLabel) {
 
 //#endregion
 //#region src/modules/implementation-orchestrator/project-findings.ts
-const logger$10 = createLogger("project-findings");
+const logger$12 = createLogger("project-findings");
 /** Maximum character length for the findings summary */
 const MAX_CHARS = 2e3;
 /**
@@ -4229,7 +4345,7 @@ function getProjectFindings(db) {
 		if (summary.length > MAX_CHARS) summary = summary.slice(0, MAX_CHARS - 3) + "...";
 		return summary;
 	} catch (err) {
-		logger$10.warn({ err }, "Failed to query project findings (graceful fallback)");
+		logger$12.warn({ err }, "Failed to query project findings (graceful fallback)");
 		return "";
 	}
 }
@@ -4252,11 +4368,11 @@ function extractRecurringPatterns(outcomes) {
 
 //#endregion
 //#region src/modules/compiled-workflows/dev-story.ts
-const logger$9 = createLogger("compiled-workflows:dev-story");
+const logger$11 = createLogger("compiled-workflows:dev-story");
 /** Hard token ceiling for the assembled dev-story prompt */
-const TOKEN_CEILING$1 = 24e3;
+const TOKEN_CEILING$3 = 24e3;
 /** Default timeout for dev-story dispatches in milliseconds (30 min) */
-const DEFAULT_TIMEOUT_MS = 18e5;
+const DEFAULT_TIMEOUT_MS$1 = 18e5;
 /** Default Vitest test patterns injected when no test-pattern decisions exist */
 const DEFAULT_VITEST_PATTERNS = `## Test Patterns (defaults)
 - Framework: Vitest (NOT jest — --testPathPattern flag does not work, use -- "pattern")
@@ -4277,7 +4393,7 @@ const DEFAULT_VITEST_PATTERNS = `## Test Patterns (defaults)
 */
 async function runDevStory(deps, params) {
 	const { storyKey, storyFilePath, taskScope, priorFiles } = params;
-	logger$9.info({
+	logger$11.info({
 		storyKey,
 		storyFilePath
 	}, "Starting compiled dev-story workflow");
@@ -4319,10 +4435,10 @@ async function runDevStory(deps, params) {
 	let template;
 	try {
 		template = await deps.pack.getPrompt("dev-story");
-		logger$9.debug({ storyKey }, "Retrieved dev-story prompt template from pack");
+		logger$11.debug({ storyKey }, "Retrieved dev-story prompt template from pack");
 	} catch (err) {
 		const error = err instanceof Error ? err.message : String(err);
-		logger$9.error({
+		logger$11.error({
 			storyKey,
 			error
 		}, "Failed to retrieve dev-story prompt template");
@@ -4333,14 +4449,14 @@ async function runDevStory(deps, params) {
 		storyContent = await readFile$1(storyFilePath, "utf-8");
 	} catch (err) {
 		if (err.code === "ENOENT") {
-			logger$9.error({
+			logger$11.error({
 				storyKey,
 				storyFilePath
 			}, "Story file not found");
 			return makeFailureResult("story_file_not_found");
 		}
 		const error = err instanceof Error ? err.message : String(err);
-		logger$9.error({
+		logger$11.error({
 			storyKey,
 			storyFilePath,
 			error
@@ -4348,7 +4464,7 @@ async function runDevStory(deps, params) {
 		return makeFailureResult(`story_file_read_error: ${error}`);
 	}
 	if (storyContent.trim().length === 0) {
-		logger$9.error({
+		logger$11.error({
 			storyKey,
 			storyFilePath
 		}, "Story file is empty");
@@ -4360,17 +4476,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$9.debug({
+			logger$11.debug({
 				storyKey,
 				count: testPatternDecisions.length
 			}, "Loaded test patterns from decision store");
 		} else {
 			testPatternsContent = DEFAULT_VITEST_PATTERNS;
-			logger$9.debug({ storyKey }, "No test-pattern decisions found — using default Vitest patterns");
+			logger$11.debug({ storyKey }, "No test-pattern decisions found — using default Vitest patterns");
 		}
 	} catch (err) {
 		const error = err instanceof Error ? err.message : String(err);
-		logger$9.warn({
+		logger$11.warn({
 			storyKey,
 			error
 		}, "Failed to load test patterns — using defaults");
@@ -4385,12 +4501,29 @@ async function runDevStory(deps, params) {
 		const findings = getProjectFindings(deps.db);
 		if (findings.length > 0) {
 			priorFindingsContent = "Previous pipeline runs encountered these issues — avoid repeating them:\n\n" + findings;
-			logger$9.debug({
+			logger$11.debug({
 				storyKey,
 				findingsLen: findings.length
 			}, "Injecting prior findings into dev-story prompt");
 		}
 	} catch {}
+	let testPlanContent = "";
+	try {
+		const testPlanDecisions = getDecisionsByCategory(deps.db, "test-plan");
+		const matchingPlan = testPlanDecisions.find((d) => d.key === storyKey);
+		if (matchingPlan) {
+			const plan = JSON.parse(matchingPlan.value);
+			const parts = ["## Test Plan"];
+			if (plan.test_files && plan.test_files.length > 0) {
+				parts.push("\n### Test Files");
+				for (const f of plan.test_files) parts.push(`- ${f}`);
+			}
+			if (plan.test_categories && plan.test_categories.length > 0) parts.push(`\n### Categories: ${plan.test_categories.join(", ")}`);
+			if (plan.coverage_notes) parts.push(`\n### Coverage Notes\n${plan.coverage_notes}`);
+			testPlanContent = parts.join("\n");
+			logger$11.debug({ storyKey }, "Injecting test plan into dev-story prompt");
+		}
+	} catch {}
 	const sections = [
 		{
 			name: "story_content",
@@ -4422,17 +4555,22 @@ async function runDevStory(deps, params) {
 			content: testPatternsContent,
 			priority: "optional"
 		},
+		{
+			name: "test_plan",
+			content: testPlanContent,
+			priority: "optional"
+		},
 		{
 			name: "prior_findings",
 			content: priorFindingsContent,
 			priority: "optional"
 		}
 	];
-	const { prompt, tokenCount, truncated } = assemblePrompt(template, sections, TOKEN_CEILING$1);
-	logger$9.info({
+	const { prompt, tokenCount, truncated } = assemblePrompt(template, sections, TOKEN_CEILING$3);
+	logger$11.info({
 		storyKey,
 		tokenCount,
-		ceiling: TOKEN_CEILING$1,
+		ceiling: TOKEN_CEILING$3,
 		truncated
 	}, "Assembled dev-story prompt");
 	let dispatchResult;
@@ -4441,14 +4579,14 @@ async function runDevStory(deps, params) {
 			prompt,
 			agent: "claude-code",
 			taskType: "dev-story",
-			timeout: DEFAULT_TIMEOUT_MS,
+			timeout: DEFAULT_TIMEOUT_MS$1,
 			outputSchema: DevStoryResultSchema,
 			...deps.projectRoot !== void 0 ? { workingDirectory: deps.projectRoot } : {}
 		});
 		dispatchResult = await handle.result;
 	} catch (err) {
 		const error = err instanceof Error ? err.message : String(err);
-		logger$9.error({
+		logger$11.error({
 			storyKey,
 			error
 		}, "Dispatch threw an unexpected error");
@@ -4459,11 +4597,11 @@ async function runDevStory(deps, params) {
 		output: dispatchResult.tokenEstimate.output
 	};
 	if (dispatchResult.status === "timeout") {
-		logger$9.error({
+		logger$11.error({
 			storyKey,
 			durationMs: dispatchResult.durationMs
 		}, "Dev-story dispatch timed out");
-		if (dispatchResult.output.length > 0) logger$9.info({
+		if (dispatchResult.output.length > 0) logger$11.info({
 			storyKey,
 			partialOutput: dispatchResult.output.slice(0, 500)
 		}, "Partial output before timeout");
@@ -4473,12 +4611,12 @@ async function runDevStory(deps, params) {
 		};
 	}
 	if (dispatchResult.status === "failed" || dispatchResult.exitCode !== 0) {
-		logger$9.error({
+		logger$11.error({
 			storyKey,
 			exitCode: dispatchResult.exitCode,
 			status: dispatchResult.status
 		}, "Dev-story dispatch failed");
-		if (dispatchResult.output.length > 0) logger$9.info({
+		if (dispatchResult.output.length > 0) logger$11.info({
 			storyKey,
 			partialOutput: dispatchResult.output.slice(0, 500)
 		}, "Partial output from failed dispatch");
@@ -4490,7 +4628,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$9.error({
+		logger$11.error({
 			storyKey,
 			parseError: details,
 			rawOutputSnippet: rawSnippet
@@ -4498,12 +4636,12 @@ async function runDevStory(deps, params) {
 		let filesModified = [];
 		try {
 			filesModified = await getGitChangedFiles(deps.projectRoot ?? process.cwd());
-			if (filesModified.length > 0) logger$9.info({
+			if (filesModified.length > 0) logger$11.info({
 				storyKey,
 				fileCount: filesModified.length
 			}, "Recovered files_modified from git status (YAML fallback)");
 		} catch (err) {
-			logger$9.warn({
+			logger$11.warn({
 				storyKey,
 				error: err instanceof Error ? err.message : String(err)
 			}, "Failed to recover files_modified from git");
@@ -4520,7 +4658,7 @@ async function runDevStory(deps, params) {
 		};
 	}
 	const parsed = dispatchResult.parsed;
-	logger$9.info({
+	logger$11.info({
 		storyKey,
 		result: parsed.result,
 		acMet: parsed.ac_met.length
@@ -4659,13 +4797,13 @@ function extractFilesInScope(storyContent) {
 
 //#endregion
 //#region src/modules/compiled-workflows/code-review.ts
-const logger$8 = createLogger("compiled-workflows:code-review");
+const logger$10 = createLogger("compiled-workflows:code-review");
 /**
 * Hard token ceiling for the assembled code-review prompt (50,000 tokens).
 * Quality reviews require seeing actual code diffs, not just file names.
 * // TODO: consider externalizing to pack config when multiple packs exist
 */
-const TOKEN_CEILING = 1e5;
+const TOKEN_CEILING$2 = 1e5;
 /**
 * Default fallback result when dispatch fails or times out.
 * Uses NEEDS_MINOR_FIXES (not NEEDS_MAJOR_REWORK) so a parse/schema failure
@@ -4702,7 +4840,7 @@ function defaultFailResult(error, tokenUsage) {
 async function runCodeReview(deps, params) {
 	const { storyKey, storyFilePath, workingDirectory, pipelineRunId, filesModified, previousIssues } = params;
 	const cwd = workingDirectory ?? process.cwd();
-	logger$8.debug({
+	logger$10.debug({
 		storyKey,
 		storyFilePath,
 		cwd,
@@ -4713,7 +4851,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$8.error({ error }, "Failed to retrieve code-review prompt template");
+		logger$10.error({ error }, "Failed to retrieve code-review prompt template");
 		return defaultFailResult(`Failed to retrieve prompt template: ${error}`, {
 			input: 0,
 			output: 0
@@ -4724,7 +4862,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$8.error({
+		logger$10.error({
 			storyFilePath,
 			error
 		}, "Failed to read story file");
@@ -4733,7 +4871,7 @@ async function runCodeReview(deps, params) {
 			output: 0
 		});
 	}
-	const archConstraintsContent = getArchConstraints(deps);
+	const archConstraintsContent = getArchConstraints$1(deps);
 	const templateTokens = countTokens(template);
 	const storyTokens = countTokens(storyContent);
 	const constraintTokens = countTokens(archConstraintsContent);
@@ -4742,16 +4880,16 @@ async function runCodeReview(deps, params) {
 	if (filesModified && filesModified.length > 0) {
 		const scopedDiff = await getGitDiffForFiles(filesModified, cwd);
 		const scopedTotal = nonDiffTokens + countTokens(scopedDiff);
-		if (scopedTotal <= TOKEN_CEILING) {
+		if (scopedTotal <= TOKEN_CEILING$2) {
 			gitDiffContent = scopedDiff;
-			logger$8.debug({
+			logger$10.debug({
 				fileCount: filesModified.length,
 				tokenCount: scopedTotal
 			}, "Using scoped file diff");
 		} else {
-			logger$8.warn({
+			logger$10.warn({
 				estimatedTotal: scopedTotal,
-				ceiling: TOKEN_CEILING,
+				ceiling: TOKEN_CEILING$2,
 				fileCount: filesModified.length
 			}, "Scoped diff exceeds token ceiling — falling back to stat-only summary");
 			gitDiffContent = await getGitDiffStatSummary(cwd);
@@ -4761,11 +4899,11 @@ async function runCodeReview(deps, params) {
 		await stageIntentToAdd(changedFiles, cwd);
 		const fullDiff = await getGitDiffSummary(cwd);
 		const fullTotal = nonDiffTokens + countTokens(fullDiff);
-		if (fullTotal <= TOKEN_CEILING) gitDiffContent = fullDiff;
+		if (fullTotal <= TOKEN_CEILING$2) gitDiffContent = fullDiff;
 		else {
-			logger$8.warn({
+			logger$10.warn({
 				estimatedTotal: fullTotal,
-				ceiling: TOKEN_CEILING
+				ceiling: TOKEN_CEILING$2
 			}, "Full git diff would exceed token ceiling — using stat-only summary");
 			gitDiffContent = await getGitDiffStatSummary(cwd);
 		}
@@ -4783,7 +4921,7 @@ async function runCodeReview(deps, params) {
 		const findings = getProjectFindings(deps.db);
 		if (findings.length > 0) {
 			priorFindingsContent = "Previous reviews found these recurring patterns — pay special attention:\n\n" + findings;
-			logger$8.debug({
+			logger$10.debug({
 				storyKey,
 				findingsLen: findings.length
 			}, "Injecting prior findings into code-review prompt");
@@ -4816,12 +4954,12 @@ async function runCodeReview(deps, params) {
 			priority: "optional"
 		}
 	];
-	const assembleResult = assemblePrompt(template, sections, TOKEN_CEILING);
-	if (assembleResult.truncated) logger$8.warn({
+	const assembleResult = assemblePrompt(template, sections, TOKEN_CEILING$2);
+	if (assembleResult.truncated) logger$10.warn({
 		storyKey,
 		tokenCount: assembleResult.tokenCount
 	}, "Code-review prompt truncated to fit token ceiling");
-	logger$8.debug({
+	logger$10.debug({
 		storyKey,
 		tokenCount: assembleResult.tokenCount,
 		truncated: assembleResult.truncated
@@ -4839,7 +4977,7 @@ async function runCodeReview(deps, params) {
 		dispatchResult = await handle.result;
 	} catch (err) {
 		const error = err instanceof Error ? err.message : String(err);
-		logger$8.error({
+		logger$10.error({
 			storyKey,
 			error
 		}, "Code-review dispatch threw unexpected error");
@@ -4855,7 +4993,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$8.warn({
+		logger$10.warn({
 			storyKey,
 			exitCode: dispatchResult.exitCode
 		}, "Code-review dispatch failed");
@@ -4865,7 +5003,7 @@ async function runCodeReview(deps, params) {
 		};
 	}
 	if (dispatchResult.status === "timeout") {
-		logger$8.warn({ storyKey }, "Code-review dispatch timed out");
+		logger$10.warn({ storyKey }, "Code-review dispatch timed out");
 		return {
 			...defaultFailResult("Dispatch status: timeout. The agent did not complete within the allowed time.", tokenUsage),
 			rawOutput
@@ -4873,7 +5011,7 @@ async function runCodeReview(deps, params) {
 	}
 	if (dispatchResult.parsed === null) {
 		const details = dispatchResult.parseError ?? "No YAML block found in output";
-		logger$8.warn({
+		logger$10.warn({
 			storyKey,
 			details
 		}, "Code-review output schema validation failed");
@@ -4890,7 +5028,7 @@ async function runCodeReview(deps, params) {
 	const parseResult = CodeReviewResultSchema.safeParse(dispatchResult.parsed);
 	if (!parseResult.success) {
 		const details = parseResult.error.message;
-		logger$8.warn({
+		logger$10.warn({
 			storyKey,
 			details
 		}, "Code-review output failed schema validation");
@@ -4905,13 +5043,13 @@ async function runCodeReview(deps, params) {
 		};
 	}
 	const parsed = parseResult.data;
-	if (parsed.agentVerdict !== parsed.verdict) logger$8.info({
+	if (parsed.agentVerdict !== parsed.verdict) logger$10.info({
 		storyKey,
 		agentVerdict: parsed.agentVerdict,
 		pipelineVerdict: parsed.verdict,
 		issues: parsed.issues
 	}, "Pipeline overrode agent verdict based on issue severities");
-	logger$8.info({
+	logger$10.info({
 		storyKey,
 		verdict: parsed.verdict,
 		issues: parsed.issues
@@ -4929,6 +5067,384 @@ async function runCodeReview(deps, params) {
 * Retrieve architecture constraints from the decision store.
 * Looks for decisions with phase='solutioning', category='architecture'.
 */
+function getArchConstraints$1(deps) {
+	try {
+		const decisions = getDecisionsByPhase(deps.db, "solutioning");
+		const constraints = decisions.filter((d) => d.category === "architecture");
+		if (constraints.length === 0) return "";
+		return constraints.map((d) => `${d.key}: ${d.value}`).join("\n");
+	} catch (err) {
+		logger$10.warn({ error: err instanceof Error ? err.message : String(err) }, "Failed to retrieve architecture constraints");
+		return "";
+	}
+}
+
+//#endregion
+//#region src/modules/compiled-workflows/test-plan.ts
+const logger$9 = createLogger("compiled-workflows:test-plan");
+/** Hard token ceiling for the assembled test-plan prompt */
+const TOKEN_CEILING$1 = 8e3;
+/** Default timeout for test-plan dispatches in milliseconds (5 min — lightweight call) */
+const DEFAULT_TIMEOUT_MS = 3e5;
+/**
+* Execute the compiled test-plan workflow.
+*
+* @param deps - Injected dependencies (db, pack, contextCompiler, dispatcher)
+* @param params - Parameters (storyKey, storyFilePath, pipelineRunId)
+* @returns TestPlanResult with result, test_files, test_categories, coverage_notes, tokenUsage
+*/
+async function runTestPlan(deps, params) {
+	const { storyKey, storyFilePath, pipelineRunId } = params;
+	logger$9.info({
+		storyKey,
+		storyFilePath
+	}, "Starting compiled test-plan workflow");
+	let template;
+	try {
+		template = await deps.pack.getPrompt("test-plan");
+		logger$9.debug({ storyKey }, "Retrieved test-plan prompt template from pack");
+	} catch (err) {
+		const error = err instanceof Error ? err.message : String(err);
+		logger$9.warn({
+			storyKey,
+			error
+		}, "Failed to retrieve test-plan prompt template");
+		return makeTestPlanFailureResult(`template_load_failed: ${error}`);
+	}
+	let storyContent;
+	try {
+		storyContent = await readFile$1(storyFilePath, "utf-8");
+	} catch (err) {
+		if (err.code === "ENOENT") {
+			logger$9.warn({
+				storyKey,
+				storyFilePath
+			}, "Story file not found for test planning");
+			return makeTestPlanFailureResult("story_file_not_found");
+		}
+		const error = err instanceof Error ? err.message : String(err);
+		logger$9.warn({
+			storyKey,
+			storyFilePath,
+			error
+		}, "Failed to read story file for test planning");
+		return makeTestPlanFailureResult(`story_file_read_error: ${error}`);
+	}
+	const { prompt, tokenCount, truncated } = assemblePrompt(template, [{
+		name: "story_content",
+		content: storyContent,
+		priority: "required"
+	}], TOKEN_CEILING$1);
+	logger$9.info({
+		storyKey,
+		tokenCount,
+		ceiling: TOKEN_CEILING$1,
+		truncated
+	}, "Assembled test-plan prompt");
+	let dispatchResult;
+	try {
+		const handle = deps.dispatcher.dispatch({
+			prompt,
+			agent: "claude-code",
+			taskType: "test-plan",
+			timeout: DEFAULT_TIMEOUT_MS,
+			outputSchema: TestPlanResultSchema,
+			...deps.projectRoot !== void 0 ? { workingDirectory: deps.projectRoot } : {}
+		});
+		dispatchResult = await handle.result;
+	} catch (err) {
+		const error = err instanceof Error ? err.message : String(err);
+		logger$9.warn({
+			storyKey,
+			error
+		}, "Test-plan dispatch threw an unexpected error");
+		return makeTestPlanFailureResult(`dispatch_error: ${error}`);
+	}
+	const tokenUsage = {
+		input: dispatchResult.tokenEstimate.input,
+		output: dispatchResult.tokenEstimate.output
+	};
+	if (dispatchResult.status === "timeout") {
+		logger$9.warn({
+			storyKey,
+			durationMs: dispatchResult.durationMs
+		}, "Test-plan dispatch timed out");
+		return {
+			...makeTestPlanFailureResult(`dispatch_timeout after ${dispatchResult.durationMs}ms`),
+			tokenUsage
+		};
+	}
+	if (dispatchResult.status === "failed" || dispatchResult.exitCode !== 0) {
+		logger$9.warn({
+			storyKey,
+			exitCode: dispatchResult.exitCode,
+			status: dispatchResult.status
+		}, "Test-plan dispatch failed");
+		return {
+			...makeTestPlanFailureResult(`dispatch_failed with exit_code=${dispatchResult.exitCode}`),
+			tokenUsage
+		};
+	}
+	if (dispatchResult.parseError !== null || dispatchResult.parsed === null) {
+		const details = dispatchResult.parseError ?? "parsed result was null";
+		logger$9.warn({
+			storyKey,
+			parseError: details
+		}, "Test-plan YAML schema validation failed");
+		return {
+			...makeTestPlanFailureResult(`schema_validation_failed: ${details}`),
+			tokenUsage
+		};
+	}
+	const parsed = dispatchResult.parsed;
+	try {
+		createDecision(deps.db, {
+			pipeline_run_id: pipelineRunId,
+			phase: "implementation",
+			category: TEST_PLAN,
+			key: storyKey,
+			value: JSON.stringify({
+				test_files: parsed.test_files,
+				test_categories: parsed.test_categories,
+				coverage_notes: parsed.coverage_notes
+			}),
+			rationale: `Test plan for ${storyKey}: ${parsed.test_files.length} test files, categories: ${parsed.test_categories.join(", ")}`
+		});
+		logger$9.info({
+			storyKey,
+			fileCount: parsed.test_files.length,
+			categories: parsed.test_categories
+		}, "Test plan stored in decision store");
+	} catch (err) {
+		const error = err instanceof Error ? err.message : String(err);
+		logger$9.warn({
+			storyKey,
+			error
+		}, "Failed to store test plan in decision store — proceeding anyway");
+	}
+	logger$9.info({
+		storyKey,
+		result: parsed.result
+	}, "Test-plan workflow completed");
+	return {
+		result: parsed.result,
+		test_files: parsed.test_files,
+		test_categories: parsed.test_categories,
+		coverage_notes: parsed.coverage_notes,
+		tokenUsage
+	};
+}
+/**
+* Build a failure result with sensible defaults.
+*/
+function makeTestPlanFailureResult(error) {
+	return {
+		result: "failed",
+		test_files: [],
+		test_categories: [],
+		coverage_notes: "",
+		error,
+		tokenUsage: {
+			input: 0,
+			output: 0
+		}
+	};
+}
+
+//#endregion
+//#region src/modules/compiled-workflows/test-expansion.ts
+const logger$8 = createLogger("compiled-workflows:test-expansion");
+/**
+* Hard token ceiling for the assembled test-expansion prompt (20,000 tokens).
+*/
+const TOKEN_CEILING = 2e4;
+function defaultFallbackResult(error, tokenUsage) {
+	return {
+		expansion_priority: "low",
+		coverage_gaps: [],
+		suggested_tests: [],
+		error,
+		tokenUsage
+	};
+}
+/**
+* Execute the compiled test-expansion workflow.
+*
+* Steps:
+* 1. Retrieve compiled prompt template via pack.getPrompt('test-expansion')
+* 2. Read story file contents from storyFilePath
+* 3. Query decision store for architecture constraints (solutioning, architecture)
+* 4. Capture scoped git diff for filesModified, with stat-only fallback if oversized
+* 5. Assemble prompt with 20,000-token ceiling
+* 6. Dispatch via dispatcher with taskType='test-expansion'
+* 7. Validate YAML output against TestExpansionResultSchema
+* 8. Return typed TestExpansionResult (never throws — all errors return graceful fallback)
+*
+* @param deps - Injected dependencies (db, pack, contextCompiler, dispatcher)
+* @param params - Story key, story file path, files modified, working directory, pipeline run ID
+* @returns Promise resolving to TestExpansionResult (never rejects)
+*/
+async function runTestExpansion(deps, params) {
+	const { storyKey, storyFilePath, pipelineRunId, filesModified, workingDirectory } = params;
+	const cwd = workingDirectory ?? process.cwd();
+	logger$8.debug({
+		storyKey,
+		storyFilePath,
+		cwd,
+		pipelineRunId
+	}, "Starting test-expansion workflow");
+	let template;
+	try {
+		template = await deps.pack.getPrompt("test-expansion");
+	} catch (err) {
+		const error = err instanceof Error ? err.message : String(err);
+		logger$8.warn({ error }, "Failed to retrieve test-expansion prompt template");
+		return defaultFallbackResult(`Failed to retrieve prompt template: ${error}`, {
+			input: 0,
+			output: 0
+		});
+	}
+	let storyContent;
+	try {
+		storyContent = await readFile$1(storyFilePath, "utf-8");
+	} catch (err) {
+		const error = err instanceof Error ? err.message : String(err);
+		logger$8.warn({
+			storyFilePath,
+			error
+		}, "Failed to read story file");
+		return defaultFallbackResult(`Failed to read story file: ${error}`, {
+			input: 0,
+			output: 0
+		});
+	}
+	const archConstraintsContent = getArchConstraints(deps);
+	let gitDiffContent = "";
+	if (filesModified && filesModified.length > 0) try {
+		const templateTokens = countTokens(template);
+		const storyTokens = countTokens(storyContent);
+		const constraintTokens = countTokens(archConstraintsContent);
+		const nonDiffTokens = templateTokens + storyTokens + constraintTokens;
+		const scopedDiff = await getGitDiffForFiles(filesModified, cwd);
+		const scopedTotal = nonDiffTokens + countTokens(scopedDiff);
+		if (scopedTotal <= TOKEN_CEILING) {
+			gitDiffContent = scopedDiff;
+			logger$8.debug({
+				fileCount: filesModified.length,
+				tokenCount: scopedTotal
+			}, "Using scoped file diff");
+		} else {
+			logger$8.warn({
+				estimatedTotal: scopedTotal,
+				ceiling: TOKEN_CEILING,
+				fileCount: filesModified.length
+			}, "Scoped diff exceeds token ceiling — falling back to stat-only summary");
+			gitDiffContent = await getGitDiffStatSummary(cwd);
+		}
+	} catch (err) {
+		logger$8.warn({ error: err instanceof Error ? err.message : String(err) }, "Failed to get git diff — proceeding with empty diff");
+	}
+	const sections = [
+		{
+			name: "story_content",
+			content: storyContent,
+			priority: "required"
+		},
+		{
+			name: "git_diff",
+			content: gitDiffContent,
+			priority: "important"
+		},
+		{
+			name: "arch_constraints",
+			content: archConstraintsContent,
+			priority: "optional"
+		}
+	];
+	const assembleResult = assemblePrompt(template, sections, TOKEN_CEILING);
+	if (assembleResult.truncated) logger$8.warn({
+		storyKey,
+		tokenCount: assembleResult.tokenCount
+	}, "Test-expansion prompt truncated to fit token ceiling");
+	logger$8.debug({
+		storyKey,
+		tokenCount: assembleResult.tokenCount,
+		truncated: assembleResult.truncated
+	}, "Prompt assembled for test-expansion");
+	const { prompt } = assembleResult;
+	const handle = deps.dispatcher.dispatch({
+		prompt,
+		agent: "claude-code",
+		taskType: "test-expansion",
+		outputSchema: TestExpansionResultSchema,
+		workingDirectory: deps.projectRoot
+	});
+	let dispatchResult;
+	try {
+		dispatchResult = await handle.result;
+	} catch (err) {
+		const error = err instanceof Error ? err.message : String(err);
+		logger$8.warn({
+			storyKey,
+			error
+		}, "Test-expansion dispatch threw unexpected error");
+		return defaultFallbackResult(`Dispatch error: ${error}`, {
+			input: Math.ceil(prompt.length / 4),
+			output: 0
+		});
+	}
+	const tokenUsage = {
+		input: dispatchResult.tokenEstimate.input,
+		output: dispatchResult.tokenEstimate.output
+	};
+	if (dispatchResult.status === "failed") {
+		const errorMsg = `Dispatch status: failed. Exit code: ${dispatchResult.exitCode}. ${dispatchResult.parseError ?? ""}`.trim();
+		logger$8.warn({
+			storyKey,
+			exitCode: dispatchResult.exitCode
+		}, "Test-expansion dispatch failed");
+		return defaultFallbackResult(errorMsg, tokenUsage);
+	}
+	if (dispatchResult.status === "timeout") {
+		logger$8.warn({ storyKey }, "Test-expansion dispatch timed out");
+		return defaultFallbackResult("Dispatch status: timeout. The agent did not complete within the allowed time.", tokenUsage);
+	}
+	if (dispatchResult.parsed === null) {
+		const details = dispatchResult.parseError ?? "No YAML block found in output";
+		logger$8.warn({
+			storyKey,
+			details
+		}, "Test-expansion output has no parseable YAML");
+		return defaultFallbackResult(`schema_validation_failed: ${details}`, tokenUsage);
+	}
+	const parseResult = TestExpansionResultSchema.safeParse(dispatchResult.parsed);
+	if (!parseResult.success) {
+		const details = parseResult.error.message;
+		logger$8.warn({
+			storyKey,
+			details
+		}, "Test-expansion output failed schema validation");
+		return defaultFallbackResult(`schema_validation_failed: ${details}`, tokenUsage);
+	}
+	const parsed = parseResult.data;
+	logger$8.info({
+		storyKey,
+		expansion_priority: parsed.expansion_priority,
+		coverage_gaps: parsed.coverage_gaps.length,
+		suggested_tests: parsed.suggested_tests.length
+	}, "Test-expansion workflow completed successfully");
+	return {
+		expansion_priority: parsed.expansion_priority,
+		coverage_gaps: parsed.coverage_gaps,
+		suggested_tests: parsed.suggested_tests,
+		notes: parsed.notes,
+		tokenUsage
+	};
+}
+/**
+* Retrieve architecture constraints from the decision store.
+* Looks for decisions with phase='solutioning', category='architecture'.
+*/
 function getArchConstraints(deps) {
 	try {
 		const decisions = getDecisionsByPhase(deps.db, "solutioning");
@@ -5592,7 +6108,7 @@ function createPauseGate() {
 */
 function createImplementationOrchestrator(deps) {
 	const { db, pack, contextCompiler, dispatcher, eventBus, config, projectRoot } = deps;
-	const logger$18 = createLogger("implementation-orchestrator");
+	const logger$20 = createLogger("implementation-orchestrator");
 	let _state = "IDLE";
 	let _startedAt;
 	let _completedAt;
@@ -5629,7 +6145,7 @@ function createImplementationOrchestrator(deps) {
 		const nowMs = Date.now();
 		for (const [phase, startMs] of starts) {
 			const endMs = ends?.get(phase);
-			if (endMs === void 0) logger$18.warn({
+			if (endMs === void 0) logger$20.warn({
 				storyKey,
 				phase
 			}, "Phase has no end time — story may have errored mid-phase. Duration capped to now() and may be inflated.");
@@ -5676,13 +6192,13 @@ function createImplementationOrchestrator(deps) {
 					rationale: `Story ${storyKey} completed with result=${result} in ${wallClockSeconds}s. Tokens: ${tokenAgg.input}+${tokenAgg.output}. Review cycles: ${reviewCycles}.`
 				});
 			} catch (decisionErr) {
-				logger$18.warn({
+				logger$20.warn({
 					err: decisionErr,
 					storyKey
 				}, "Failed to write story-metrics decision (best-effort)");
 			}
 		} catch (err) {
-			logger$18.warn({
+			logger$20.warn({
 				err,
 				storyKey
 			}, "Failed to write story metrics (best-effort)");
@@ -5711,7 +6227,7 @@ function createImplementationOrchestrator(deps) {
 				rationale: `Story ${storyKey} ${outcome} after ${reviewCycles} review cycle(s).`
 			});
 		} catch (err) {
-			logger$18.warn({
+			logger$20.warn({
 				err,
 				storyKey
 			}, "Failed to write story-outcome decision (best-effort)");
@@ -5737,7 +6253,7 @@ function createImplementationOrchestrator(deps) {
 				rationale: `Escalation diagnosis for ${payload.storyKey}: ${diagnosis.recommendedAction} — ${diagnosis.rationale}`
 			});
 		} catch (err) {
-			logger$18.warn({
+			logger$20.warn({
 				err,
 				storyKey: payload.storyKey
 			}, "Failed to persist escalation diagnosis (best-effort)");
@@ -5787,7 +6303,7 @@ function createImplementationOrchestrator(deps) {
 				token_usage_json: serialized
 			});
 		} catch (err) {
-			logger$18.warn("Failed to persist orchestrator state", { err });
+			logger$20.warn("Failed to persist orchestrator state", { err });
 		}
 	}
 	function recordProgress() {
@@ -5817,7 +6333,7 @@ function createImplementationOrchestrator(deps) {
 					if (_stalledStories.has(key)) continue;
 					_stalledStories.add(key);
 					_storiesWithStall.add(key);
-					logger$18.warn({
+					logger$20.warn({
 						storyKey: key,
 						phase: s.phase,
 						elapsedMs: elapsed
@@ -5854,7 +6370,7 @@ function createImplementationOrchestrator(deps) {
 	* exhausted retries the story is ESCALATED.
 	*/
 	async function processStory(storyKey) {
-		logger$18.info("Processing story", { storyKey });
+		logger$20.info("Processing story", { storyKey });
 		await waitIfPaused();
 		if (_state !== "RUNNING") return;
 		startPhase(storyKey, "create-story");
@@ -5869,7 +6385,7 @@ function createImplementationOrchestrator(deps) {
 			const match = files.find((f) => f.startsWith(`${storyKey}-`) && f.endsWith(".md"));
 			if (match) {
 				storyFilePath = join$1(artifactsDir, match);
-				logger$18.info({
+				logger$20.info({
 					storyKey,
 					storyFilePath
 				}, "Found existing story file — skipping create-story");
@@ -5961,6 +6477,39 @@ function createImplementationOrchestrator(deps) {
 		}
 		await waitIfPaused();
 		if (_state !== "RUNNING") return;
+		startPhase(storyKey, "test-plan");
+		updateStory(storyKey, { phase: "IN_TEST_PLANNING" });
+		persistState();
+		let testPlanPhaseResult = "failed";
+		try {
+			const testPlanResult = await runTestPlan({
+				db,
+				pack,
+				contextCompiler,
+				dispatcher,
+				projectRoot
+			}, {
+				storyKey,
+				storyFilePath: storyFilePath ?? "",
+				pipelineRunId: config.pipelineRunId
+			});
+			testPlanPhaseResult = testPlanResult.result;
+			if (testPlanResult.result === "success") logger$20.info({ storyKey }, "Test plan generated successfully");
+			else logger$20.warn({ storyKey }, "Test planning returned failed result — proceeding to dev-story without test plan");
+		} catch (err) {
+			logger$20.warn({
+				storyKey,
+				err
+			}, "Test planning failed — proceeding to dev-story without test plan");
+		}
+		endPhase(storyKey, "test-plan");
+		eventBus.emit("orchestrator:story-phase-complete", {
+			storyKey,
+			phase: "IN_TEST_PLANNING",
+			result: { result: testPlanPhaseResult }
+		});
+		await waitIfPaused();
+		if (_state !== "RUNNING") return;
 		startPhase(storyKey, "dev-story");
 		updateStory(storyKey, { phase: "IN_DEV" });
 		persistState();
@@ -5971,7 +6520,7 @@ function createImplementationOrchestrator(deps) {
 			try {
 				storyContentForAnalysis = await readFile$1(storyFilePath ?? "", "utf-8");
 			} catch (err) {
-				logger$18.error({
+				logger$20.error({
 					storyKey,
 					storyFilePath,
 					error: err instanceof Error ? err.message : String(err)
@@ -5979,7 +6528,7 @@ function createImplementationOrchestrator(deps) {
 			}
 			const analysis = analyzeStoryComplexity(storyContentForAnalysis);
 			const batches = planTaskBatches(analysis);
-			logger$18.info({
+			logger$20.info({
 				storyKey,
 				estimatedScope: analysis.estimatedScope,
 				batchCount: batches.length,
@@ -5997,7 +6546,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$18.info({
+					logger$20.info({
 						storyKey,
 						batchIndex: batch.batchIndex,
 						taskCount: batch.taskIds.length
@@ -6021,7 +6570,7 @@ function createImplementationOrchestrator(deps) {
 						});
 					} catch (batchErr) {
 						const errMsg = batchErr instanceof Error ? batchErr.message : String(batchErr);
-						logger$18.warn({
+						logger$20.warn({
 							storyKey,
 							batchIndex: batch.batchIndex,
 							error: errMsg
@@ -6041,7 +6590,7 @@ function createImplementationOrchestrator(deps) {
 						filesModified: batchFilesModified,
 						result: batchResult.result === "success" ? "success" : "failed"
 					};
-					logger$18.info(batchMetrics, "Batch dev-story metrics");
+					logger$20.info(batchMetrics, "Batch dev-story metrics");
 					for (const f of batchFilesModified) allFilesModified.add(f);
 					if (batchFilesModified.length > 0) batchFileGroups.push({
 						batchIndex: batch.batchIndex,
@@ -6063,13 +6612,13 @@ function createImplementationOrchestrator(deps) {
 							})
 						});
 					} catch (tokenErr) {
-						logger$18.warn({
+						logger$20.warn({
 							storyKey,
 							batchIndex: batch.batchIndex,
 							err: tokenErr
 						}, "Failed to record batch token usage");
 					}
-					if (batchResult.result === "failed") logger$18.warn({
+					if (batchResult.result === "failed") logger$20.warn({
 						storyKey,
 						batchIndex: batch.batchIndex,
 						error: batchResult.error
@@ -6102,7 +6651,7 @@ function createImplementationOrchestrator(deps) {
 					result: devResult
 				});
 				persistState();
-				if (devResult.result === "failed") logger$18.warn("Dev-story reported failure, proceeding to code review", {
+				if (devResult.result === "failed") logger$20.warn("Dev-story reported failure, proceeding to code review", {
 					storyKey,
 					error: devResult.error,
 					filesModified: devFilesModified.length
@@ -6159,7 +6708,7 @@ function createImplementationOrchestrator(deps) {
 						"NEEDS_MAJOR_REWORK": 2
 					};
 					for (const group of batchFileGroups) {
-						logger$18.info({
+						logger$20.info({
 							storyKey,
 							batchIndex: group.batchIndex,
 							fileCount: group.files.length
@@ -6196,7 +6745,7 @@ function createImplementationOrchestrator(deps) {
 						rawOutput: lastRawOutput,
 						tokenUsage: aggregateTokens
 					};
-					logger$18.info({
+					logger$20.info({
 						storyKey,
 						batchCount: batchFileGroups.length,
 						verdict: worstVerdict,
@@ -6222,7 +6771,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$18.warn({
+					logger$20.warn({
 						storyKey,
 						reviewCycles,
 						error: reviewResult.error
@@ -6232,7 +6781,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$18.info({
+					logger$20.info({
 						storyKey,
 						originalVerdict: verdict,
 						issuesBefore: previousIssueList.length,
@@ -6268,7 +6817,7 @@ function createImplementationOrchestrator(deps) {
 					if (_decomposition !== void 0) parts.push(`decomposed: ${_decomposition.batchCount} batches`);
 					parts.push(`${fileCount} files`);
 					parts.push(`${totalTokensK} tokens`);
-					logger$18.info({
+					logger$20.info({
 						storyKey,
 						verdict,
 						agentVerdict: reviewResult.agentVerdict
@@ -6305,6 +6854,38 @@ function createImplementationOrchestrator(deps) {
 					reviewCycles
 				});
 				persistState();
+				try {
+					const expansionResult = await runTestExpansion({
+						db,
+						pack,
+						contextCompiler,
+						dispatcher,
+						projectRoot
+					}, {
+						storyKey,
+						storyFilePath: storyFilePath ?? "",
+						pipelineRunId: config.pipelineRunId,
+						filesModified: devFilesModified,
+						workingDirectory: projectRoot
+					});
+					logger$20.debug({
+						storyKey,
+						expansion_priority: expansionResult.expansion_priority,
+						coverage_gaps: expansionResult.coverage_gaps.length
+					}, "Test expansion analysis complete");
+					createDecision(db, {
+						pipeline_run_id: config.pipelineRunId ?? "unknown",
+						phase: "implementation",
+						category: TEST_EXPANSION_FINDING,
+						key: `${storyKey}:${config.pipelineRunId ?? "unknown"}`,
+						value: JSON.stringify(expansionResult)
+					});
+				} catch (expansionErr) {
+					logger$20.warn({
+						storyKey,
+						error: expansionErr instanceof Error ? expansionErr.message : String(expansionErr)
+					}, "Test expansion failed — story verdict unchanged");
+				}
 				keepReviewing = false;
 				return;
 			}
@@ -6327,7 +6908,7 @@ function createImplementationOrchestrator(deps) {
 					persistState();
 					return;
 				}
-				logger$18.info({
+				logger$20.info({
 					storyKey,
 					reviewCycles: finalReviewCycles,
 					issueCount: issueList.length
@@ -6377,7 +6958,7 @@ function createImplementationOrchestrator(deps) {
 						fixPrompt = assembled.prompt;
 					} catch {
 						fixPrompt = `Fix story ${storyKey}: verdict=${verdict}, minor fixes needed`;
-						logger$18.warn("Failed to assemble auto-approve fix prompt, using fallback", { storyKey });
+						logger$20.warn("Failed to assemble auto-approve fix prompt, using fallback", { storyKey });
 					}
 					const handle = dispatcher.dispatch({
 						prompt: fixPrompt,
@@ -6394,9 +6975,9 @@ function createImplementationOrchestrator(deps) {
 							output: fixResult.tokenEstimate.output
 						} : void 0 }
 					});
-					if (fixResult.status === "timeout") logger$18.warn("Auto-approve fix timed out — approving anyway (issues were minor)", { storyKey });
+					if (fixResult.status === "timeout") logger$20.warn("Auto-approve fix timed out — approving anyway (issues were minor)", { storyKey });
 				} catch (err) {
-					logger$18.warn("Auto-approve fix dispatch failed — approving anyway (issues were minor)", {
+					logger$20.warn("Auto-approve fix dispatch failed — approving anyway (issues were minor)", {
 						storyKey,
 						err
 					});
@@ -6469,7 +7050,7 @@ function createImplementationOrchestrator(deps) {
 					fixPrompt = assembled.prompt;
 				} catch {
 					fixPrompt = `Fix story ${storyKey}: verdict=${verdict}, taskType=${taskType}`;
-					logger$18.warn("Failed to assemble fix prompt, using fallback", {
+					logger$20.warn("Failed to assemble fix prompt, using fallback", {
 						storyKey,
 						taskType
 					});
@@ -6492,7 +7073,7 @@ function createImplementationOrchestrator(deps) {
 					} : void 0 }
 				});
 				if (fixResult.status === "timeout") {
-					logger$18.warn("Fix dispatch timed out — escalating story", {
+					logger$20.warn("Fix dispatch timed out — escalating story", {
 						storyKey,
 						taskType
 					});
@@ -6512,13 +7093,13 @@ function createImplementationOrchestrator(deps) {
 					persistState();
 					return;
 				}
-				if (fixResult.status === "failed") logger$18.warn("Fix dispatch failed", {
+				if (fixResult.status === "failed") logger$20.warn("Fix dispatch failed", {
 					storyKey,
 					taskType,
 					exitCode: fixResult.exitCode
 				});
 			} catch (err) {
-				logger$18.warn("Fix dispatch failed, continuing to next review", {
+				logger$20.warn("Fix dispatch failed, continuing to next review", {
 					storyKey,
 					taskType,
 					err
@@ -6572,11 +7153,11 @@ function createImplementationOrchestrator(deps) {
 	}
 	async function run(storyKeys) {
 		if (_state === "RUNNING" || _state === "PAUSED") {
-			logger$18.warn("run() called while orchestrator is already running or paused — ignoring", { state: _state });
+			logger$20.warn("run() called while orchestrator is already running or paused — ignoring", { state: _state });
 			return getStatus();
 		}
 		if (_state === "COMPLETE") {
-			logger$18.warn("run() called on a COMPLETE orchestrator — ignoring", { state: _state });
+			logger$20.warn("run() called on a COMPLETE orchestrator — ignoring", { state: _state });
 			return getStatus();
 		}
 		_state = "RUNNING";
@@ -6594,13 +7175,13 @@ function createImplementationOrchestrator(deps) {
 		if (config.enableHeartbeat) startHeartbeat();
 		if (projectRoot !== void 0) {
 			const seedResult = seedMethodologyContext(db, projectRoot);
-			if (seedResult.decisionsCreated > 0) logger$18.info({
+			if (seedResult.decisionsCreated > 0) logger$20.info({
 				decisionsCreated: seedResult.decisionsCreated,
 				skippedCategories: seedResult.skippedCategories
 			}, "Methodology context seeded from planning artifacts");
 		}
 		const groups = detectConflictGroups(storyKeys);
-		logger$18.info("Orchestrator starting", {
+		logger$20.info("Orchestrator starting", {
 			storyCount: storyKeys.length,
 			groupCount: groups.length,
 			maxConcurrency: config.maxConcurrency
@@ -6612,7 +7193,7 @@ function createImplementationOrchestrator(deps) {
 			_state = "FAILED";
 			_completedAt = new Date().toISOString();
 			persistState();
-			logger$18.error("Orchestrator failed with unhandled error", { err });
+			logger$20.error("Orchestrator failed with unhandled error", { err });
 			return getStatus();
 		}
 		stopHeartbeat();
@@ -6639,7 +7220,7 @@ function createImplementationOrchestrator(deps) {
 		_pauseGate = createPauseGate();
 		_state = "PAUSED";
 		eventBus.emit("orchestrator:paused", {});
-		logger$18.info("Orchestrator paused");
+		logger$20.info("Orchestrator paused");
 	}
 	function resume() {
 		if (_state !== "PAUSED") return;
@@ -6650,7 +7231,7 @@ function createImplementationOrchestrator(deps) {
 		}
 		_state = "RUNNING";
 		eventBus.emit("orchestrator:resumed", {});
-		logger$18.info("Orchestrator resumed");
+		logger$20.info("Orchestrator resumed");
 	}
 	return {
 		run,
@@ -8481,6 +9062,10 @@ const AMENDMENT_CONTEXT_HEADER$2 = "\n\n--- AMENDMENT CONTEXT (Parent Run Decisi
 const AMENDMENT_CONTEXT_FOOTER$2 = "\n--- END AMENDMENT CONTEXT ---\n";
 /** Marker appended when amendment context is truncated to fit token budget */
 const TRUNCATED_MARKER$2 = "\n[TRUNCATED]";
+/** Prior run findings framing block prefix */
+const PRIOR_FINDINGS_HEADER = "\n\n--- PRIOR RUN FINDINGS ---\n";
+/** Prior run findings framing block suffix */
+const PRIOR_FINDINGS_FOOTER = "\n--- END PRIOR RUN FINDINGS ---\n";
 /** Concept placeholder in the prompt template */
 const CONCEPT_PLACEHOLDER = "{{concept}}";
 /** Product brief fields to persist as decisions */
@@ -8521,6 +9106,9 @@ function buildAnalysisSteps() {
 		context: [{
 			placeholder: "concept",
 			source: "param:concept"
+		}, {
+			placeholder: "prior_findings",
+			source: "param:prior_findings"
 		}],
 		persist: [{
 			field: "problem_statement",
@@ -8584,7 +9172,14 @@ async function runAnalysisMultiStep(deps, params) {
 	};
 	try {
 		const steps = buildAnalysisSteps();
-		const result = await runSteps(steps, deps, params.runId, "analysis", { concept: params.concept });
+		let priorFindings = "";
+		try {
+			priorFindings = getProjectFindings(deps.db);
+		} catch {}
+		const result = await runSteps(steps, deps, params.runId, "analysis", {
+			concept: params.concept,
+			prior_findings: priorFindings
+		});
 		if (!result.success) return {
 			result: "failed",
 			error: result.error ?? "multi_step_failed",
@@ -8665,6 +9260,18 @@ async function runAnalysisPhase(deps, params) {
 		let effectiveConcept = concept;
 		if (concept.length > MAX_CONCEPT_CHARS) effectiveConcept = concept.slice(0, MAX_CONCEPT_CHARS) + "...";
 		let prompt = template.replace(CONCEPT_PLACEHOLDER, effectiveConcept);
+		try {
+			const priorFindings = getProjectFindings(db);
+			if (priorFindings !== "") {
+				const maxPromptChars = MAX_PROMPT_TOKENS$1 * 4;
+				const framingLen = PRIOR_FINDINGS_HEADER.length + PRIOR_FINDINGS_FOOTER.length;
+				const availableForFindings = maxPromptChars - prompt.length - framingLen - TRUNCATED_MARKER$2.length;
+				if (availableForFindings > 0) {
+					const findingsToInject = priorFindings.length > availableForFindings ? priorFindings.slice(0, availableForFindings) + TRUNCATED_MARKER$2 : priorFindings;
+					prompt += PRIOR_FINDINGS_HEADER + findingsToInject + PRIOR_FINDINGS_FOOTER;
+				}
+			}
+		} catch {}
 		if (amendmentContext !== void 0 && amendmentContext !== "") {
 			const maxPromptChars = MAX_PROMPT_TOKENS$1 * 4;
 			const basePromptLen = prompt.length;
@@ -10919,7 +11526,7 @@ function mapInternalPhaseToEventPhase(internalPhase) {
 	}
 }
 async function runRunAction(options) {
-	const { pack: packName, from: startPhase, stopAfter, concept: conceptArg, conceptFile, stories: storiesArg, concurrency, outputFormat, projectRoot, events: eventsFlag, verbose: verboseFlag, tui: tuiFlag, skipUx, research: researchFlag, skipResearch: skipResearchFlag } = options;
+	const { pack: packName, from: startPhase, stopAfter, concept: conceptArg, conceptFile, stories: storiesArg, concurrency, outputFormat, projectRoot, events: eventsFlag, verbose: verboseFlag, tui: tuiFlag, skipUx, research: researchFlag, skipResearch: skipResearchFlag, registry: injectedRegistry } = options;
 	if (startPhase !== void 0 && !VALID_PHASES.includes(startPhase)) {
 		const errorMsg = `Invalid phase '${startPhase}'. Valid phases: ${VALID_PHASES.join(", ")}`;
 		if (outputFormat === "json") process.stdout.write(formatOutput(null, "json", false, errorMsg) + "\n");
@@ -10977,7 +11584,8 @@ async function runRunAction(options) {
 		...eventsFlag === true ? { events: true } : {},
 		...skipUx === true ? { skipUx: true } : {},
 		...researchFlag === true ? { research: true } : {},
-		...skipResearchFlag === true ? { skipResearch: true } : {}
+		...skipResearchFlag === true ? { skipResearch: true } : {},
+		...injectedRegistry !== void 0 ? { registry: injectedRegistry } : {}
 	});
 	let storyKeys = [];
 	if (storiesArg !== void 0 && storiesArg !== "") {
@@ -11066,8 +11674,8 @@ async function runRunAction(options) {
 		});
 		const eventBus = createEventBus();
 		const contextCompiler = createContextCompiler({ db });
-		const adapterRegistry = new AdapterRegistry();
-		await adapterRegistry.discoverAndRegister();
+		const adapterRegistry = injectedRegistry ?? new AdapterRegistry();
+		if (injectedRegistry === void 0) await adapterRegistry.discoverAndRegister();
 		const dispatcher = createDispatcher({
 			eventBus,
 			adapterRegistry
@@ -11430,7 +12038,7 @@ async function runRunAction(options) {
 	}
 }
 async function runFullPipeline(options) {
-	const { packName, packPath, dbDir, dbPath, startPhase, stopAfter, concept, concurrency, outputFormat, projectRoot, events: eventsFlag, skipUx, research: researchFlag, skipResearch: skipResearchFlag } = options;
+	const { packName, packPath, dbDir, dbPath, startPhase, stopAfter, concept, concurrency, outputFormat, projectRoot, events: eventsFlag, skipUx, research: researchFlag, skipResearch: skipResearchFlag, registry: injectedRegistry } = options;
 	if (!existsSync(dbDir)) mkdirSync(dbDir, { recursive: true });
 	const dbWrapper = new DatabaseWrapper(dbPath);
 	try {
@@ -11458,8 +12066,8 @@ async function runFullPipeline(options) {
 		}
 		const eventBus = createEventBus();
 		const contextCompiler = createContextCompiler({ db });
-		const adapterRegistry = new AdapterRegistry();
-		await adapterRegistry.discoverAndRegister();
+		const adapterRegistry = injectedRegistry ?? new AdapterRegistry();
+		if (injectedRegistry === void 0) await adapterRegistry.discoverAndRegister();
 		const dispatcher = createDispatcher({
 			eventBus,
 			adapterRegistry
@@ -11734,7 +12342,7 @@ async function runFullPipeline(options) {
 		} catch {}
 	}
 }
-function registerRunCommand(program, _version = "0.0.0", projectRoot = process.cwd()) {
+function registerRunCommand(program, _version = "0.0.0", projectRoot = process.cwd(), registry) {
 	program.command("run").description("Run the autonomous pipeline (use --from to start from a specific phase)").option("--pack <name>", "Methodology pack name", "bmad").option("--from <phase>", "Start from this phase: analysis, planning, solutioning, implementation").option("--stop-after <phase>", "Stop pipeline after this phase completes").option("--concept <text>", "Inline concept text (required when --from analysis)").option("--concept-file <path>", "Path to a file containing the concept text").option("--stories <keys>", "Comma-separated story keys (e.g., 10-1,10-2)").option("--concurrency <n>", "Maximum parallel conflict groups", (v) => parseInt(v, 10), 3).option("--project-root <path>", "Project root directory", projectRoot).option("--output-format <format>", "Output format: human (default) or json", "human").option("--events", "Emit structured NDJSON events on stdout for programmatic consumption").option("--verbose", "Show detailed pino log output").option("--help-agent", "Print a machine-optimized prompt fragment for AI agents and exit").option("--tui", "Show TUI dashboard").option("--skip-ux", "Skip the UX design phase even if enabled in the pack manifest").option("--research", "Enable the research phase even if not set in the pack manifest").option("--skip-research", "Skip the research phase even if enabled in the pack manifest").action(async (opts) => {
 		if (opts.helpAgent) {
 			process.exitCode = await runHelpAgent();
@@ -11767,7 +12375,8 @@ function registerRunCommand(program, _version = "0.0.0", projectRoot = process.c
 			tui: opts.tui,
 			skipUx: opts.skipUx,
 			research: opts.research,
-			skipResearch: opts.skipResearch
+			skipResearch: opts.skipResearch,
+			registry
 		});
 		process.exitCode = exitCode;
 	});
@@ -11775,4 +12384,4 @@ function registerRunCommand(program, _version = "0.0.0", projectRoot = process.c
 
 //#endregion
 export { DatabaseWrapper, SUBSTRATE_OWNED_SETTINGS_KEYS, VALID_PHASES, buildPipelineStatusOutput, createContextCompiler, createDispatcher, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStopAfterGate, findPackageRoot, formatOutput, formatPhaseCompletionSummary, formatPipelineStatusHuman, formatPipelineSummary, formatTokenTelemetry, getAllDescendantPids, getAutoHealthData, getSubstrateDefaultSettings, registerHealthCommand, registerRunCommand, resolveBmadMethodSrcPath, resolveBmadMethodVersion, resolveMainRepoRoot, runAnalysisPhase, runMigrations, runPlanningPhase, runRunAction, runSolutioningPhase, validateStopAfterFromConflict };
-//# sourceMappingURL=run-CcWb6Kb-.js.map
+//# sourceMappingURL=run-BLIgARum.js.map