substrate-ai 0.2.19 → 0.2.20

package/dist/cli/index.js

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
-import { 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, runSolutioningPhase, validateStopAfterFromConflict } from "../run-mFmS2pw6.js";
+import { 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, runSolutioningPhase, validateStopAfterFromConflict } from "../run-CcWb6Kb-.js";
 import { createLogger, deepMask } from "../logger-D2fS2ccL.js";
 import { AdapterRegistry, createEventBus } from "../event-bus-BMxhfxfT.js";
 import { CURRENT_CONFIG_FORMAT_VERSION, CURRENT_TASK_GRAPH_VERSION, PartialSubstrateConfigSchema, SUPPORTED_CONFIG_FORMAT_VERSIONS, SubstrateConfigSchema, defaultConfigMigrator } from "../version-manager-impl-CZ6KF1Ds.js";
 import { ConfigError, ConfigIncompatibleFormatError } from "../errors-BPqtzQ4U.js";
 import { addTokenUsage, createDecision, getDecisionsByCategory, getDecisionsByPhaseForRun, getLatestRun, getTokenUsageSummary, listRequirements, updatePipelineRun } from "../decisions-Dq4cAA2L.js";
-import { EXPERIMENT_RESULT, OPERATIONAL_FINDING, STORY_METRICS, aggregateTokenUsageForRun, compareRunMetrics, getBaselineRunMetrics, getRunMetrics, getStoryMetricsForRun, incrementRunRestarts, listRunMetrics, tagRunAsBaseline } from "../operational-CobuCGbM.js";
+import { EXPERIMENT_RESULT, OPERATIONAL_FINDING, STORY_METRICS, aggregateTokenUsageForRun, compareRunMetrics, getBaselineRunMetrics, getRunMetrics, getStoryMetricsForRun, incrementRunRestarts, listRunMetrics, tagRunAsBaseline } from "../operational-Dq4IfJzE.js";
 import { abortMerge, createWorktree, getConflictingFiles, getMergedFiles, getOrphanedWorktrees, performMerge, removeBranch, removeWorktree, simulateMerge, verifyGitVersion } from "../git-utils-CtmrZrHS.js";
 import { registerUpgradeCommand } from "../upgrade-CjjAx5kD.js";
 import { Command } from "commander";
@@ -2828,7 +2828,7 @@ async function runSupervisorAction(options, deps = {}) {
 						try {
 							const { createExperimenter } = await import(
 								/* @vite-ignore */
-								"../experimenter-CHRVkV3d.js"
+								"../experimenter-prkFLFPw.js"
 );
 							const { getLatestRun: getLatest } = await import(
 								/* @vite-ignore */
@@ -2842,7 +2842,7 @@ async function runSupervisorAction(options, deps = {}) {
 								const expDb = expDbWrapper.db;
 								const { runRunAction: runPipeline } = await import(
 									/* @vite-ignore */
-									"../run-CUGB4FQx.js"
+									"../run-C5zfaWYN.js"
 );
 								const runStoryFn = async (opts) => {
 									const exitCode = await runPipeline({

package/dist/{experimenter-CHRVkV3d.js → experimenter-prkFLFPw.js}

@@ -1,6 +1,6 @@
 import "./logger-D2fS2ccL.js";
 import { createDecision } from "./decisions-Dq4cAA2L.js";
-import { EXPERIMENT_RESULT, getRunMetrics, getStoryMetricsForRun } from "./operational-CobuCGbM.js";
+import { EXPERIMENT_RESULT, getRunMetrics, getStoryMetricsForRun } from "./operational-Dq4IfJzE.js";
 import { spawnGit } from "./git-utils-CtmrZrHS.js";
 import { spawn } from "node:child_process";
 import { join } from "node:path";
@@ -500,4 +500,4 @@ function createExperimenter(config, deps) {
 
 //#endregion
 export { createExperimenter };
-//# sourceMappingURL=experimenter-CHRVkV3d.js.map
+//# sourceMappingURL=experimenter-prkFLFPw.js.map

package/dist/index.d.ts

@@ -995,6 +995,19 @@ interface OrchestratorEvents {
     lastVerdict: string;
     reviewCycles: number;
     issues: unknown[];
+    /** Structured diagnosis with classification and recommended action (Story 22-3) */
+    diagnosis?: {
+      issueDistribution: 'concentrated' | 'widespread';
+      severityProfile: 'blocker-present' | 'major-only' | 'minor-only' | 'no-structured-issues';
+      totalIssues: number;
+      blockerCount: number;
+      majorCount: number;
+      minorCount: number;
+      affectedFiles: string[];
+      reviewCycles: number;
+      recommendedAction: 'retry-targeted' | 'split-story' | 'human-intervention';
+      rationale: string;
+    };
   };
   /** A non-fatal warning occurred during story processing */
   'orchestrator:story-warn': {

package/dist/{operational-CobuCGbM.js → operational-Dq4IfJzE.js}

@@ -255,7 +255,46 @@ const EXPERIMENT_RESULT = "experiment-result";
 * ```
 */
 const STORY_METRICS = "story-metrics";
+/**
+* Category for structured escalation diagnoses.
+*
+* Key schema: "{storyKey}:{runId}"
+*
+* Value shape:
+* ```json
+* {
+*   "issueDistribution": "concentrated",
+*   "severityProfile": "major-only",
+*   "totalIssues": 3,
+*   "blockerCount": 0,
+*   "majorCount": 3,
+*   "minorCount": 0,
+*   "affectedFiles": ["src/foo.ts"],
+*   "reviewCycles": 3,
+*   "recommendedAction": "retry-targeted",
+*   "rationale": "3 major issues concentrated in few files."
+* }
+* ```
+*/
+const ESCALATION_DIAGNOSIS = "escalation-diagnosis";
+/**
+* Category for per-story outcome findings (learning loop).
+*
+* Key schema: "{storyKey}:{runId}"
+*
+* Value shape:
+* ```json
+* {
+*   "storyKey": "22-1",
+*   "outcome": "complete",
+*   "reviewCycles": 2,
+*   "verdictHistory": ["NEEDS_MINOR_FIXES", "SHIP_IT"],
+*   "recurringPatterns": ["missing error handling"]
+* }
+* ```
+*/
+const STORY_OUTCOME = "story-outcome";
 
 //#endregion
-export { EXPERIMENT_RESULT, OPERATIONAL_FINDING, STORY_METRICS, aggregateTokenUsageForRun, aggregateTokenUsageForStory, compareRunMetrics, getBaselineRunMetrics, getRunMetrics, getStoryMetricsForRun, incrementRunRestarts, listRunMetrics, tagRunAsBaseline, writeRunMetrics, writeStoryMetrics };
-//# sourceMappingURL=operational-CobuCGbM.js.map
+export { ESCALATION_DIAGNOSIS, EXPERIMENT_RESULT, OPERATIONAL_FINDING, STORY_METRICS, STORY_OUTCOME, aggregateTokenUsageForRun, aggregateTokenUsageForStory, compareRunMetrics, getBaselineRunMetrics, getRunMetrics, getStoryMetricsForRun, incrementRunRestarts, listRunMetrics, tagRunAsBaseline, writeRunMetrics, writeStoryMetrics };
+//# sourceMappingURL=operational-Dq4IfJzE.js.map

package/dist/run-C5zfaWYN.js

@@ -0,0 +1,7 @@
+import { registerRunCommand, runRunAction } from "./run-CcWb6Kb-.js";
+import "./logger-D2fS2ccL.js";
+import "./event-bus-BMxhfxfT.js";
+import "./decisions-Dq4cAA2L.js";
+import "./operational-Dq4IfJzE.js";
+
+export { runRunAction };

package/dist/{run-mFmS2pw6.js → run-CcWb6Kb-.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, 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 { 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 { 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$16 = createLogger("persistence:migrations");
+const logger$17 = 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$16.info("Starting migration runner");
+	logger$17.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$16.info("No pending migrations");
+		logger$17.info("No pending migrations");
 		return;
 	}
 	const insertMigration = db.prepare("INSERT INTO schema_migrations (version, name) VALUES (?, ?)");
 	for (const migration of pending) {
-		logger$16.info({
+		logger$17.info({
 			version: migration.version,
 			name: migration.name
 		}, "Applying migration");
@@ -587,14 +587,14 @@ function runMigrations(db) {
 			});
 			applyMigration();
 		}
-		logger$16.info({ version: migration.version }, "Migration applied successfully");
+		logger$17.info({ version: migration.version }, "Migration applied successfully");
 	}
-	logger$16.info({ count: pending.length }, "All pending migrations applied");
+	logger$17.info({ count: pending.length }, "All pending migrations applied");
 }
 
 //#endregion
 //#region src/persistence/database.ts
-const logger$15 = createLogger("persistence:database");
+const logger$16 = 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$15.info({ path: this._path }, "Opening SQLite database");
+		logger$16.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$15.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$16.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$15.info({ path: this._path }, "SQLite database opened with WAL mode");
+		logger$16.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$15.info({ path: this._path }, "SQLite database closed");
+		logger$16.info({ path: this._path }, "SQLite database closed");
 	}
 	/**
 	* Return the raw BetterSqlite3 instance.
@@ -2496,7 +2496,7 @@ function truncateToTokens(text, maxTokens) {
 
 //#endregion
 //#region src/modules/context-compiler/context-compiler-impl.ts
-const logger$14 = createLogger("context-compiler");
+const logger$15 = createLogger("context-compiler");
 /**
 * Fraction of the original token budget that must remain (after required +
 * important sections) before an optional section is included.
@@ -2588,7 +2588,7 @@ var ContextCompilerImpl = class {
 				includedParts.push(truncated);
 				remainingBudget -= truncatedTokens;
 				anyTruncated = true;
-				logger$14.warn({
+				logger$15.warn({
 					section: section.name,
 					originalTokens: tokens,
 					budgetTokens: truncatedTokens
@@ -2602,7 +2602,7 @@ var ContextCompilerImpl = class {
 				});
 			} else {
 				anyTruncated = true;
-				logger$14.warn({
+				logger$15.warn({
 					section: section.name,
 					tokens
 				}, "Context compiler: omitted \"important\" section — no budget remaining");
@@ -2629,7 +2629,7 @@ var ContextCompilerImpl = class {
 				} else {
 					if (tokens > 0) {
 						anyTruncated = true;
-						logger$14.warn({
+						logger$15.warn({
 							section: section.name,
 							tokens,
 							budgetFractionRemaining: budgetFractionRemaining.toFixed(2)
@@ -2914,7 +2914,7 @@ function parseYamlResult(yamlText, schema) {
 
 //#endregion
 //#region src/modules/agent-dispatch/dispatcher-impl.ts
-const logger$13 = createLogger("agent-dispatch");
+const logger$14 = createLogger("agent-dispatch");
 const SHUTDOWN_GRACE_MS = 1e4;
 const SHUTDOWN_MAX_WAIT_MS = 3e4;
 const CHARS_PER_TOKEN = 4;
@@ -2957,7 +2957,7 @@ function getAvailableMemory() {
 				encoding: "utf-8"
 			}).trim(), 10);
 			if (pressureLevel >= 4) {
-				logger$13.warn({ pressureLevel }, "macOS kernel reports critical memory pressure");
+				logger$14.warn({ pressureLevel }, "macOS kernel reports critical memory pressure");
 				return 0;
 			}
 		} catch {}
@@ -2972,7 +2972,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$13.warn({
+				logger$14.warn({
 					pressureLevel,
 					availableBeforeDiscount: available
 				}, "macOS kernel reports memory pressure — discounting estimate");
@@ -3051,7 +3051,7 @@ var DispatcherImpl = class {
 					resolve: typedResolve,
 					reject
 				});
-				logger$13.debug({
+				logger$14.debug({
 					id,
 					queueLength: this._queue.length
 				}, "Dispatch queued");
@@ -3082,7 +3082,7 @@ var DispatcherImpl = class {
 	async shutdown() {
 		this._shuttingDown = true;
 		this._stopMemoryPressureTimer();
-		logger$13.info({
+		logger$14.info({
 			running: this._running.size,
 			queued: this._queue.length
 		}, "Dispatcher shutting down");
@@ -3115,13 +3115,13 @@ var DispatcherImpl = class {
 				}
 			}, 50);
 		});
-		logger$13.info("Dispatcher shutdown complete");
+		logger$14.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$13.warn({
+			logger$14.warn({
 				id,
 				agent
 			}, "No adapter found for agent");
@@ -3167,7 +3167,7 @@ var DispatcherImpl = class {
 		});
 		const startedAt = Date.now();
 		proc.on("error", (err) => {
-			logger$13.error({
+			logger$14.error({
 				id,
 				binary: cmd.binary,
 				error: err.message
@@ -3175,7 +3175,7 @@ var DispatcherImpl = class {
 		});
 		if (proc.stdin !== null) {
 			proc.stdin.on("error", (err) => {
-				if (err.code !== "EPIPE") logger$13.warn({
+				if (err.code !== "EPIPE") logger$14.warn({
 					id,
 					error: err.message
 				}, "stdin write error");
@@ -3217,7 +3217,7 @@ var DispatcherImpl = class {
 			agent,
 			taskType
 		});
-		logger$13.debug({
+		logger$14.debug({
 			id,
 			agent,
 			taskType,
@@ -3234,7 +3234,7 @@ var DispatcherImpl = class {
 				dispatchId: id,
 				timeoutMs
 			});
-			logger$13.warn({
+			logger$14.warn({
 				id,
 				agent,
 				taskType,
@@ -3288,7 +3288,7 @@ var DispatcherImpl = class {
 					exitCode: code,
 					output: stdout
 				});
-				logger$13.debug({
+				logger$14.debug({
 					id,
 					agent,
 					taskType,
@@ -3314,7 +3314,7 @@ var DispatcherImpl = class {
 					error: stderr || `Process exited with code ${String(code)}`,
 					exitCode: code
 				});
-				logger$13.debug({
+				logger$14.debug({
 					id,
 					agent,
 					taskType,
@@ -3373,7 +3373,7 @@ var DispatcherImpl = class {
 		const next = this._queue.shift();
 		if (next === void 0) return;
 		next.handle.status = "running";
-		logger$13.debug({
+		logger$14.debug({
 			id: next.id,
 			queueLength: this._queue.length
 		}, "Dequeued dispatch");
@@ -3386,7 +3386,7 @@ var DispatcherImpl = class {
 	_isMemoryPressured() {
 		const free = getAvailableMemory();
 		if (free < MIN_FREE_MEMORY_BYTES) {
-			logger$13.warn({
+			logger$14.warn({
 				freeMB: Math.round(free / 1024 / 1024),
 				thresholdMB: Math.round(MIN_FREE_MEMORY_BYTES / 1024 / 1024)
 			}, "Memory pressure detected — holding dispatch queue");
@@ -3424,9 +3424,94 @@ function createDispatcher(options) {
 	return new DispatcherImpl(options.eventBus, options.adapterRegistry, config);
 }
 
+//#endregion
+//#region src/modules/implementation-orchestrator/escalation-diagnosis.ts
+/**
+* Generate a structured diagnosis from escalation data.
+*
+* Handles both structured issue lists (from code-review) and plain string
+* arrays (from create-story/dev-story failures).
+*/
+function generateEscalationDiagnosis(issues, reviewCycles, lastVerdict) {
+	const structured = issues.map((issue) => {
+		if (typeof issue === "string") return {
+			severity: "major",
+			description: issue
+		};
+		const iss = issue;
+		return {
+			severity: iss.severity ?? "unknown",
+			description: iss.description ?? "",
+			file: iss.file,
+			line: iss.line
+		};
+	});
+	const blockerCount = structured.filter((i) => i.severity === "blocker").length;
+	const majorCount = structured.filter((i) => i.severity === "major").length;
+	const minorCount = structured.filter((i) => i.severity === "minor").length;
+	const totalIssues = structured.length;
+	const fileCounts = new Map();
+	for (const issue of structured) if (issue.file) fileCounts.set(issue.file, (fileCounts.get(issue.file) ?? 0) + 1);
+	const sortedFiles = [...fileCounts.entries()].sort((a, b) => b[1] - a[1]).map(([file]) => file);
+	const issuesWithFiles = structured.filter((i) => i.file).length;
+	let issueDistribution = "widespread";
+	if (issuesWithFiles > 0 && sortedFiles.length > 0) {
+		const topTwoCount = sortedFiles.slice(0, 2).reduce((sum, file) => sum + (fileCounts.get(file) ?? 0), 0);
+		if (topTwoCount > issuesWithFiles * .5) issueDistribution = "concentrated";
+	}
+	let severityProfile;
+	if (totalIssues === 0) severityProfile = "no-structured-issues";
+	else if (blockerCount > 0) severityProfile = "blocker-present";
+	else if (majorCount > 0) severityProfile = "major-only";
+	else severityProfile = "minor-only";
+	const { action, rationale } = pickRecommendation(issueDistribution, severityProfile, totalIssues, reviewCycles, lastVerdict);
+	return {
+		issueDistribution,
+		severityProfile,
+		totalIssues,
+		blockerCount,
+		majorCount,
+		minorCount,
+		affectedFiles: sortedFiles.slice(0, 5),
+		reviewCycles,
+		recommendedAction: action,
+		rationale
+	};
+}
+function pickRecommendation(distribution, profile, totalIssues, reviewCycles, lastVerdict) {
+	if (lastVerdict.startsWith("create-story") || lastVerdict.startsWith("dev-story")) return {
+		action: "human-intervention",
+		rationale: `Pipeline failed during ${lastVerdict.replace(/-/g, " ")} before code review. Manual investigation needed.`
+	};
+	if (lastVerdict === "fix-dispatch-timeout") return {
+		action: "retry-targeted",
+		rationale: "Fix dispatch timed out. Retry with a targeted prompt focusing on the remaining issues."
+	};
+	if (profile === "no-structured-issues") return {
+		action: "retry-targeted",
+		rationale: "Review produced no structured issues — likely a schema parse failure. Retry may resolve."
+	};
+	if (profile === "blocker-present") return {
+		action: "human-intervention",
+		rationale: `${totalIssues} issues including blockers after ${reviewCycles} review cycles. Fundamental problems remain — human review recommended.`
+	};
+	if (distribution === "concentrated" && profile === "major-only" && totalIssues <= 5) return {
+		action: "retry-targeted",
+		rationale: `${totalIssues} major issues concentrated in few files. A targeted retry prompt could resolve them.`
+	};
+	if (distribution === "widespread" && totalIssues > 3) return {
+		action: "split-story",
+		rationale: `${totalIssues} issues spread across many files after ${reviewCycles} cycles. Consider splitting into smaller stories.`
+	};
+	return {
+		action: "retry-targeted",
+		rationale: `${totalIssues} issues (${profile}) after ${reviewCycles} cycles. Retry with focused prompt.`
+	};
+}
+
 //#endregion
 //#region src/modules/compiled-workflows/prompt-assembler.ts
-const logger$12 = createLogger("compiled-workflows:prompt-assembler");
+const logger$13 = createLogger("compiled-workflows:prompt-assembler");
 /**
 * Assemble a final prompt from a template and sections map.
 *
@@ -3451,7 +3536,7 @@ function assemblePrompt(template, sections, tokenCeiling = 2200) {
 		tokenCount,
 		truncated: false
 	};
-	logger$12.warn({
+	logger$13.warn({
 		tokenCount,
 		ceiling: tokenCeiling
 	}, "Prompt exceeds token ceiling — truncating optional sections");
@@ -3467,10 +3552,10 @@ function assemblePrompt(template, sections, tokenCeiling = 2200) {
 			const targetSectionTokens = Math.max(0, currentSectionTokens - overBy);
 			if (targetSectionTokens === 0) {
 				contentMap[section.name] = "";
-				logger$12.warn({ sectionName: section.name }, "Section eliminated to fit token budget");
+				logger$13.warn({ sectionName: section.name }, "Section eliminated to fit token budget");
 			} else {
 				contentMap[section.name] = truncateToTokens(section.content, targetSectionTokens);
-				logger$12.warn({
+				logger$13.warn({
 					sectionName: section.name,
 					targetSectionTokens
 				}, "Section truncated to fit token budget");
@@ -3481,7 +3566,7 @@ function assemblePrompt(template, sections, tokenCeiling = 2200) {
 		}
 		if (tokenCount <= tokenCeiling) break;
 	}
-	if (tokenCount > tokenCeiling) logger$12.warn({
+	if (tokenCount > tokenCeiling) logger$13.warn({
 		tokenCount,
 		ceiling: tokenCeiling
 	}, "Required sections alone exceed token ceiling — returning over-budget prompt");
@@ -3622,7 +3707,7 @@ const CodeReviewResultSchema = z.object({
 
 //#endregion
 //#region src/modules/compiled-workflows/create-story.ts
-const logger$11 = createLogger("compiled-workflows:create-story");
+const logger$12 = createLogger("compiled-workflows:create-story");
 /**
 * Hard ceiling for the assembled create-story prompt.
 */
@@ -3646,7 +3731,7 @@ const TOKEN_CEILING$2 = 3e3;
 */
 async function runCreateStory(deps, params) {
 	const { epicId, storyKey, pipelineRunId } = params;
-	logger$11.debug({
+	logger$12.debug({
 		epicId,
 		storyKey,
 		pipelineRunId
@@ -3656,7 +3741,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$11.error({ error }, "Failed to retrieve create-story prompt template");
+		logger$12.error({ error }, "Failed to retrieve create-story prompt template");
 		return {
 			result: "failed",
 			error: `Failed to retrieve prompt template: ${error}`,
@@ -3698,7 +3783,7 @@ async function runCreateStory(deps, params) {
 			priority: "important"
 		}
 	], TOKEN_CEILING$2);
-	logger$11.debug({
+	logger$12.debug({
 		tokenCount,
 		truncated,
 		tokenCeiling: TOKEN_CEILING$2
@@ -3715,7 +3800,7 @@ async function runCreateStory(deps, params) {
 		dispatchResult = await handle.result;
 	} catch (err) {
 		const error = err instanceof Error ? err.message : String(err);
-		logger$11.error({
+		logger$12.error({
 			epicId,
 			storyKey,
 			error
@@ -3736,7 +3821,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$11.warn({
+		logger$12.warn({
 			epicId,
 			storyKey,
 			exitCode: dispatchResult.exitCode
@@ -3748,7 +3833,7 @@ async function runCreateStory(deps, params) {
 		};
 	}
 	if (dispatchResult.status === "timeout") {
-		logger$11.warn({
+		logger$12.warn({
 			epicId,
 			storyKey
 		}, "Create-story dispatch timed out");
@@ -3761,7 +3846,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$11.warn({
+		logger$12.warn({
 			epicId,
 			storyKey,
 			details,
@@ -3777,7 +3862,7 @@ async function runCreateStory(deps, params) {
 	const parseResult = CreateStoryResultSchema.safeParse(dispatchResult.parsed);
 	if (!parseResult.success) {
 		const details = parseResult.error.message;
-		logger$11.warn({
+		logger$12.warn({
 			epicId,
 			storyKey,
 			details
@@ -3790,7 +3875,7 @@ async function runCreateStory(deps, params) {
 		};
 	}
 	const parsed = parseResult.data;
-	logger$11.info({
+	logger$12.info({
 		epicId,
 		storyKey,
 		storyFile: parsed.story_file,
@@ -3812,7 +3897,7 @@ function getImplementationDecisions(deps) {
 	try {
 		return getDecisionsByPhase(deps.db, "implementation");
 	} catch (err) {
-		logger$11.warn({ error: err instanceof Error ? err.message : String(err) }, "Failed to retrieve implementation decisions");
+		logger$12.warn({ error: err instanceof Error ? err.message : String(err) }, "Failed to retrieve implementation decisions");
 		return [];
 	}
 }
@@ -3828,13 +3913,13 @@ function getEpicShard(decisions, epicId, projectRoot) {
 		if (projectRoot) {
 			const fallback = readEpicShardFromFile(projectRoot, epicId);
 			if (fallback) {
-				logger$11.info({ epicId }, "Using file-based fallback for epic shard (decisions table empty)");
+				logger$12.info({ epicId }, "Using file-based fallback for epic shard (decisions table empty)");
 				return fallback;
 			}
 		}
 		return "";
 	} catch (err) {
-		logger$11.warn({
+		logger$12.warn({
 			epicId,
 			error: err instanceof Error ? err.message : String(err)
 		}, "Failed to retrieve epic shard");
@@ -3851,7 +3936,7 @@ function getPrevDevNotes(decisions, epicId) {
 		if (devNotes.length === 0) return "";
 		return devNotes[devNotes.length - 1].value;
 	} catch (err) {
-		logger$11.warn({
+		logger$12.warn({
 			epicId,
 			error: err instanceof Error ? err.message : String(err)
 		}, "Failed to retrieve prev dev notes");
@@ -3871,13 +3956,13 @@ function getArchConstraints$1(deps) {
 		if (deps.projectRoot) {
 			const fallback = readArchConstraintsFromFile(deps.projectRoot);
 			if (fallback) {
-				logger$11.info("Using file-based fallback for architecture constraints (decisions table empty)");
+				logger$12.info("Using file-based fallback for architecture constraints (decisions table empty)");
 				return fallback;
 			}
 		}
 		return "";
 	} catch (err) {
-		logger$11.warn({ error: err instanceof Error ? err.message : String(err) }, "Failed to retrieve architecture constraints");
+		logger$12.warn({ error: err instanceof Error ? err.message : String(err) }, "Failed to retrieve architecture constraints");
 		return "";
 	}
 }
@@ -3897,7 +3982,7 @@ function readEpicShardFromFile(projectRoot, epicId) {
 		const match = pattern.exec(content);
 		return match ? match[0].trim() : "";
 	} catch (err) {
-		logger$11.warn({
+		logger$12.warn({
 			epicId,
 			error: err instanceof Error ? err.message : String(err)
 		}, "File-based epic shard fallback failed");
@@ -3920,7 +4005,7 @@ function readArchConstraintsFromFile(projectRoot) {
 		const content = readFileSync$1(archPath, "utf-8");
 		return content.slice(0, 1500);
 	} catch (err) {
-		logger$11.warn({ error: err instanceof Error ? err.message : String(err) }, "File-based architecture fallback failed");
+		logger$12.warn({ error: err instanceof Error ? err.message : String(err) }, "File-based architecture fallback failed");
 		return "";
 	}
 }
@@ -3933,14 +4018,14 @@ async function getStoryTemplate(deps) {
 	try {
 		return await deps.pack.getTemplate("story");
 	} catch (err) {
-		logger$11.warn({ error: err instanceof Error ? err.message : String(err) }, "Failed to retrieve story template from pack");
+		logger$12.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$10 = createLogger("compiled-workflows:git-helpers");
+const logger$11 = createLogger("compiled-workflows:git-helpers");
 /**
 * Capture the full git diff for HEAD (working tree vs current commit).
 *
@@ -4064,7 +4149,7 @@ async function runGitCommand(args, cwd, logLabel) {
 			stderr += chunk.toString("utf-8");
 		});
 		proc.on("error", (err) => {
-			logger$10.warn({
+			logger$11.warn({
 				label: logLabel,
 				cwd,
 				error: err.message
@@ -4073,7 +4158,7 @@ async function runGitCommand(args, cwd, logLabel) {
 		});
 		proc.on("close", (code) => {
 			if (code !== 0) {
-				logger$10.warn({
+				logger$11.warn({
 					label: logLabel,
 					cwd,
 					code,
@@ -4087,6 +4172,84 @@ async function runGitCommand(args, cwd, logLabel) {
 	});
 }
 
+//#endregion
+//#region src/modules/implementation-orchestrator/project-findings.ts
+const logger$10 = createLogger("project-findings");
+/** Maximum character length for the findings summary */
+const MAX_CHARS = 2e3;
+/**
+* Query the decision store for prior project findings and return a formatted
+* markdown summary suitable for prompt injection.
+*
+* Returns an empty string if no findings exist (AC5: graceful fallback).
+*/
+function getProjectFindings(db) {
+	try {
+		const outcomes = getDecisionsByCategory(db, STORY_OUTCOME);
+		const operational = getDecisionsByCategory(db, OPERATIONAL_FINDING);
+		const metrics = getDecisionsByCategory(db, STORY_METRICS);
+		const diagnoses = getDecisionsByCategory(db, ESCALATION_DIAGNOSIS);
+		if (outcomes.length === 0 && operational.length === 0 && metrics.length === 0 && diagnoses.length === 0) return "";
+		const sections = [];
+		if (outcomes.length > 0) {
+			const patterns = extractRecurringPatterns(outcomes);
+			if (patterns.length > 0) {
+				sections.push("**Recurring patterns from prior runs:**");
+				for (const p of patterns) sections.push(`- ${p}`);
+			}
+		}
+		if (diagnoses.length > 0) {
+			sections.push("**Prior escalations:**");
+			for (const d of diagnoses.slice(-3)) try {
+				const val = JSON.parse(d.value);
+				sections.push(`- ${d.key.split(":")[0]}: ${val.recommendedAction} — ${val.rationale}`);
+			} catch {
+				sections.push(`- ${d.key}: escalated`);
+			}
+		}
+		const highCycleStories = metrics.filter((m) => {
+			try {
+				const val = JSON.parse(m.value);
+				return val.review_cycles >= 2;
+			} catch {
+				return false;
+			}
+		}).slice(-5);
+		if (highCycleStories.length > 0) {
+			sections.push("**Stories with high review cycles:**");
+			for (const m of highCycleStories) try {
+				const val = JSON.parse(m.value);
+				sections.push(`- ${m.key.split(":")[0]}: ${val.review_cycles} cycles`);
+			} catch {}
+		}
+		const stalls = operational.filter((o) => o.key.startsWith("stall:"));
+		if (stalls.length > 0) sections.push(`**Prior stalls:** ${stalls.length} stall event(s) recorded`);
+		if (sections.length === 0) return "";
+		let summary = sections.join("\n");
+		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)");
+		return "";
+	}
+}
+/**
+* Extract recurring patterns from story-outcome decisions.
+*
+* Looks for patterns that appear across multiple story outcomes
+* (e.g., "missing error handling" flagged in 3/5 stories).
+*/
+function extractRecurringPatterns(outcomes) {
+	const patternCounts = new Map();
+	for (const o of outcomes) try {
+		const val = JSON.parse(o.value);
+		if (Array.isArray(val.recurringPatterns)) {
+			for (const pattern of val.recurringPatterns) if (typeof pattern === "string") patternCounts.set(pattern, (patternCounts.get(pattern) ?? 0) + 1);
+		}
+	} catch {}
+	return [...patternCounts.entries()].filter(([, count]) => count >= 2).sort((a, b) => b[1] - a[1]).slice(0, 5).map(([pattern, count]) => `${pattern} (${count} occurrences)`);
+}
+
 //#endregion
 //#region src/modules/compiled-workflows/dev-story.ts
 const logger$9 = createLogger("compiled-workflows:dev-story");
@@ -4217,6 +4380,17 @@ async function runDevStory(deps, params) {
 	const priorFilesContent = priorFiles !== void 0 && priorFiles.length > 0 ? `## Files Modified by Previous Batches\n\nThe following files were created or modified by prior batch dispatches. Review them for context before implementing:\n\n${priorFiles.map((f) => `- ${f}`).join("\n")}` : "";
 	const filesInScopeContent = extractFilesInScope(storyContent);
 	const projectContextContent = deps.projectRoot ? await buildProjectContext(storyContent, deps.projectRoot) : "";
+	let priorFindingsContent = "";
+	try {
+		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({
+				storyKey,
+				findingsLen: findings.length
+			}, "Injecting prior findings into dev-story prompt");
+		}
+	} catch {}
 	const sections = [
 		{
 			name: "story_content",
@@ -4247,6 +4421,11 @@ async function runDevStory(deps, params) {
 			name: "test_patterns",
 			content: testPatternsContent,
 			priority: "optional"
+		},
+		{
+			name: "prior_findings",
+			content: priorFindingsContent,
+			priority: "optional"
 		}
 	];
 	const { prompt, tokenCount, truncated } = assemblePrompt(template, sections, TOKEN_CEILING$1);
@@ -4599,6 +4778,17 @@ async function runCodeReview(deps, params) {
 		"",
 		...previousIssues.map((iss, i) => `  ${i + 1}. [${iss.severity ?? "unknown"}] ${iss.description ?? "no description"}${iss.file ? ` (${iss.file}${iss.line ? `:${iss.line}` : ""})` : ""}`)
 	].join("\n");
+	let priorFindingsContent = "";
+	try {
+		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({
+				storyKey,
+				findingsLen: findings.length
+			}, "Injecting prior findings into code-review prompt");
+		}
+	} catch {}
 	const sections = [
 		{
 			name: "story_content",
@@ -4619,6 +4809,11 @@ async function runCodeReview(deps, params) {
 			name: "arch_constraints",
 			content: archConstraintsContent,
 			priority: "optional"
+		},
+		{
+			name: "prior_findings",
+			content: priorFindingsContent,
+			priority: "optional"
 		}
 	];
 	const assembleResult = assemblePrompt(template, sections, TOKEN_CEILING);
@@ -5397,7 +5592,7 @@ function createPauseGate() {
 */
 function createImplementationOrchestrator(deps) {
 	const { db, pack, contextCompiler, dispatcher, eventBus, config, projectRoot } = deps;
-	const logger$17 = createLogger("implementation-orchestrator");
+	const logger$18 = createLogger("implementation-orchestrator");
 	let _state = "IDLE";
 	let _startedAt;
 	let _completedAt;
@@ -5434,7 +5629,7 @@ function createImplementationOrchestrator(deps) {
 		const nowMs = Date.now();
 		for (const [phase, startMs] of starts) {
 			const endMs = ends?.get(phase);
-			if (endMs === void 0) logger$17.warn({
+			if (endMs === void 0) logger$18.warn({
 				storyKey,
 				phase
 			}, "Phase has no end time — story may have errored mid-phase. Duration capped to now() and may be inflated.");
@@ -5481,18 +5676,87 @@ function createImplementationOrchestrator(deps) {
 					rationale: `Story ${storyKey} completed with result=${result} in ${wallClockSeconds}s. Tokens: ${tokenAgg.input}+${tokenAgg.output}. Review cycles: ${reviewCycles}.`
 				});
 			} catch (decisionErr) {
-				logger$17.warn({
+				logger$18.warn({
 					err: decisionErr,
 					storyKey
 				}, "Failed to write story-metrics decision (best-effort)");
 			}
 		} catch (err) {
-			logger$17.warn({
+			logger$18.warn({
 				err,
 				storyKey
 			}, "Failed to write story metrics (best-effort)");
 		}
 	}
+	/**
+	* Persist a story outcome finding to the decision store (Story 22-1, AC4).
+	*
+	* Records outcome, review cycles, and any recurring issue patterns for
+	* future prompt injection via the learning loop.
+	*/
+	function writeStoryOutcomeBestEffort(storyKey, outcome, reviewCycles, issuePatterns) {
+		if (config.pipelineRunId === void 0) return;
+		try {
+			createDecision(db, {
+				pipeline_run_id: config.pipelineRunId,
+				phase: "implementation",
+				category: STORY_OUTCOME,
+				key: `${storyKey}:${config.pipelineRunId}`,
+				value: JSON.stringify({
+					storyKey,
+					outcome,
+					reviewCycles,
+					recurringPatterns: issuePatterns ?? []
+				}),
+				rationale: `Story ${storyKey} ${outcome} after ${reviewCycles} review cycle(s).`
+			});
+		} catch (err) {
+			logger$18.warn({
+				err,
+				storyKey
+			}, "Failed to write story-outcome decision (best-effort)");
+		}
+	}
+	/**
+	* Emit an escalation event with structured diagnosis and persist the
+	* diagnosis to the decision store (Story 22-3).
+	*/
+	function emitEscalation(payload) {
+		const diagnosis = generateEscalationDiagnosis(payload.issues, payload.reviewCycles, payload.lastVerdict);
+		eventBus.emit("orchestrator:story-escalated", {
+			...payload,
+			diagnosis
+		});
+		if (config.pipelineRunId !== void 0) try {
+			createDecision(db, {
+				pipeline_run_id: config.pipelineRunId,
+				phase: "implementation",
+				category: ESCALATION_DIAGNOSIS,
+				key: `${payload.storyKey}:${config.pipelineRunId}`,
+				value: JSON.stringify(diagnosis),
+				rationale: `Escalation diagnosis for ${payload.storyKey}: ${diagnosis.recommendedAction} — ${diagnosis.rationale}`
+			});
+		} catch (err) {
+			logger$18.warn({
+				err,
+				storyKey: payload.storyKey
+			}, "Failed to persist escalation diagnosis (best-effort)");
+		}
+		const issuePatterns = extractIssuePatterns(payload.issues);
+		writeStoryOutcomeBestEffort(payload.storyKey, "escalated", payload.reviewCycles, issuePatterns);
+	}
+	/**
+	* Extract short pattern descriptions from an issue list for recurring pattern tracking.
+	*/
+	function extractIssuePatterns(issues) {
+		const patterns = [];
+		for (const issue of issues) if (typeof issue === "string") patterns.push(issue.slice(0, 100));
+		else {
+			const iss = issue;
+			if (iss.description && (iss.severity === "blocker" || iss.severity === "major")) patterns.push(iss.description.slice(0, 100));
+		}
+		return patterns.slice(0, 10);
+	}
 	function getStatus() {
 		const stories = {};
 		for (const [key, s] of _stories) stories[key] = { ...s };
@@ -5523,7 +5787,7 @@ function createImplementationOrchestrator(deps) {
 				token_usage_json: serialized
 			});
 		} catch (err) {
-			logger$17.warn("Failed to persist orchestrator state", { err });
+			logger$18.warn("Failed to persist orchestrator state", { err });
 		}
 	}
 	function recordProgress() {
@@ -5553,7 +5817,7 @@ function createImplementationOrchestrator(deps) {
 					if (_stalledStories.has(key)) continue;
 					_stalledStories.add(key);
 					_storiesWithStall.add(key);
-					logger$17.warn({
+					logger$18.warn({
 						storyKey: key,
 						phase: s.phase,
 						elapsedMs: elapsed
@@ -5590,7 +5854,7 @@ function createImplementationOrchestrator(deps) {
 	* exhausted retries the story is ESCALATED.
 	*/
 	async function processStory(storyKey) {
-		logger$17.info("Processing story", { storyKey });
+		logger$18.info("Processing story", { storyKey });
 		await waitIfPaused();
 		if (_state !== "RUNNING") return;
 		startPhase(storyKey, "create-story");
@@ -5605,7 +5869,7 @@ function createImplementationOrchestrator(deps) {
 			const match = files.find((f) => f.startsWith(`${storyKey}-`) && f.endsWith(".md"));
 			if (match) {
 				storyFilePath = join$1(artifactsDir, match);
-				logger$17.info({
+				logger$18.info({
 					storyKey,
 					storyFilePath
 				}, "Found existing story file — skipping create-story");
@@ -5650,7 +5914,7 @@ function createImplementationOrchestrator(deps) {
 					completedAt: new Date().toISOString()
 				});
 				writeStoryMetricsBestEffort(storyKey, "failed", 0);
-				eventBus.emit("orchestrator:story-escalated", {
+				emitEscalation({
 					storyKey,
 					lastVerdict: "create-story-failed",
 					reviewCycles: 0,
@@ -5667,7 +5931,7 @@ function createImplementationOrchestrator(deps) {
 					completedAt: new Date().toISOString()
 				});
 				writeStoryMetricsBestEffort(storyKey, "failed", 0);
-				eventBus.emit("orchestrator:story-escalated", {
+				emitEscalation({
 					storyKey,
 					lastVerdict: "create-story-no-file",
 					reviewCycles: 0,
@@ -5686,7 +5950,7 @@ function createImplementationOrchestrator(deps) {
 				completedAt: new Date().toISOString()
 			});
 			writeStoryMetricsBestEffort(storyKey, "failed", 0);
-			eventBus.emit("orchestrator:story-escalated", {
+			emitEscalation({
 				storyKey,
 				lastVerdict: "create-story-exception",
 				reviewCycles: 0,
@@ -5707,7 +5971,7 @@ function createImplementationOrchestrator(deps) {
 			try {
 				storyContentForAnalysis = await readFile$1(storyFilePath ?? "", "utf-8");
 			} catch (err) {
-				logger$17.error({
+				logger$18.error({
 					storyKey,
 					storyFilePath,
 					error: err instanceof Error ? err.message : String(err)
@@ -5715,7 +5979,7 @@ function createImplementationOrchestrator(deps) {
 			}
 			const analysis = analyzeStoryComplexity(storyContentForAnalysis);
 			const batches = planTaskBatches(analysis);
-			logger$17.info({
+			logger$18.info({
 				storyKey,
 				estimatedScope: analysis.estimatedScope,
 				batchCount: batches.length,
@@ -5733,7 +5997,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$17.info({
+					logger$18.info({
 						storyKey,
 						batchIndex: batch.batchIndex,
 						taskCount: batch.taskIds.length
@@ -5757,7 +6021,7 @@ function createImplementationOrchestrator(deps) {
 						});
 					} catch (batchErr) {
 						const errMsg = batchErr instanceof Error ? batchErr.message : String(batchErr);
-						logger$17.warn({
+						logger$18.warn({
 							storyKey,
 							batchIndex: batch.batchIndex,
 							error: errMsg
@@ -5777,7 +6041,7 @@ function createImplementationOrchestrator(deps) {
 						filesModified: batchFilesModified,
 						result: batchResult.result === "success" ? "success" : "failed"
 					};
-					logger$17.info(batchMetrics, "Batch dev-story metrics");
+					logger$18.info(batchMetrics, "Batch dev-story metrics");
 					for (const f of batchFilesModified) allFilesModified.add(f);
 					if (batchFilesModified.length > 0) batchFileGroups.push({
 						batchIndex: batch.batchIndex,
@@ -5799,13 +6063,13 @@ function createImplementationOrchestrator(deps) {
 							})
 						});
 					} catch (tokenErr) {
-						logger$17.warn({
+						logger$18.warn({
 							storyKey,
 							batchIndex: batch.batchIndex,
 							err: tokenErr
 						}, "Failed to record batch token usage");
 					}
-					if (batchResult.result === "failed") logger$17.warn({
+					if (batchResult.result === "failed") logger$18.warn({
 						storyKey,
 						batchIndex: batch.batchIndex,
 						error: batchResult.error
@@ -5838,7 +6102,7 @@ function createImplementationOrchestrator(deps) {
 					result: devResult
 				});
 				persistState();
-				if (devResult.result === "failed") logger$17.warn("Dev-story reported failure, proceeding to code review", {
+				if (devResult.result === "failed") logger$18.warn("Dev-story reported failure, proceeding to code review", {
 					storyKey,
 					error: devResult.error,
 					filesModified: devFilesModified.length
@@ -5853,7 +6117,7 @@ function createImplementationOrchestrator(deps) {
 				completedAt: new Date().toISOString()
 			});
 			writeStoryMetricsBestEffort(storyKey, "failed", 0);
-			eventBus.emit("orchestrator:story-escalated", {
+			emitEscalation({
 				storyKey,
 				lastVerdict: "dev-story-exception",
 				reviewCycles: 0,
@@ -5895,7 +6159,7 @@ function createImplementationOrchestrator(deps) {
 						"NEEDS_MAJOR_REWORK": 2
 					};
 					for (const group of batchFileGroups) {
-						logger$17.info({
+						logger$18.info({
 							storyKey,
 							batchIndex: group.batchIndex,
 							fileCount: group.files.length
@@ -5932,7 +6196,7 @@ function createImplementationOrchestrator(deps) {
 						rawOutput: lastRawOutput,
 						tokenUsage: aggregateTokens
 					};
-					logger$17.info({
+					logger$18.info({
 						storyKey,
 						batchCount: batchFileGroups.length,
 						verdict: worstVerdict,
@@ -5958,7 +6222,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$17.warn({
+					logger$18.warn({
 						storyKey,
 						reviewCycles,
 						error: reviewResult.error
@@ -5968,7 +6232,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$17.info({
+					logger$18.info({
 						storyKey,
 						originalVerdict: verdict,
 						issuesBefore: previousIssueList.length,
@@ -6004,7 +6268,7 @@ function createImplementationOrchestrator(deps) {
 					if (_decomposition !== void 0) parts.push(`decomposed: ${_decomposition.batchCount} batches`);
 					parts.push(`${fileCount} files`);
 					parts.push(`${totalTokensK} tokens`);
-					logger$17.info({
+					logger$18.info({
 						storyKey,
 						verdict,
 						agentVerdict: reviewResult.agentVerdict
@@ -6019,7 +6283,7 @@ function createImplementationOrchestrator(deps) {
 					completedAt: new Date().toISOString()
 				});
 				writeStoryMetricsBestEffort(storyKey, "failed", reviewCycles);
-				eventBus.emit("orchestrator:story-escalated", {
+				emitEscalation({
 					storyKey,
 					lastVerdict: "code-review-exception",
 					reviewCycles,
@@ -6035,6 +6299,7 @@ function createImplementationOrchestrator(deps) {
 					completedAt: new Date().toISOString()
 				});
 				writeStoryMetricsBestEffort(storyKey, "success", reviewCycles + 1);
+				writeStoryOutcomeBestEffort(storyKey, "complete", reviewCycles + 1);
 				eventBus.emit("orchestrator:story-complete", {
 					storyKey,
 					reviewCycles
@@ -6053,7 +6318,7 @@ function createImplementationOrchestrator(deps) {
 						completedAt: new Date().toISOString()
 					});
 					writeStoryMetricsBestEffort(storyKey, "escalated", finalReviewCycles);
-					eventBus.emit("orchestrator:story-escalated", {
+					emitEscalation({
 						storyKey,
 						lastVerdict: verdict,
 						reviewCycles: finalReviewCycles,
@@ -6062,7 +6327,7 @@ function createImplementationOrchestrator(deps) {
 					persistState();
 					return;
 				}
-				logger$17.info({
+				logger$18.info({
 					storyKey,
 					reviewCycles: finalReviewCycles,
 					issueCount: issueList.length
@@ -6112,7 +6377,7 @@ function createImplementationOrchestrator(deps) {
 						fixPrompt = assembled.prompt;
 					} catch {
 						fixPrompt = `Fix story ${storyKey}: verdict=${verdict}, minor fixes needed`;
-						logger$17.warn("Failed to assemble auto-approve fix prompt, using fallback", { storyKey });
+						logger$18.warn("Failed to assemble auto-approve fix prompt, using fallback", { storyKey });
 					}
 					const handle = dispatcher.dispatch({
 						prompt: fixPrompt,
@@ -6129,9 +6394,9 @@ function createImplementationOrchestrator(deps) {
 							output: fixResult.tokenEstimate.output
 						} : void 0 }
 					});
-					if (fixResult.status === "timeout") logger$17.warn("Auto-approve fix timed out — approving anyway (issues were minor)", { storyKey });
+					if (fixResult.status === "timeout") logger$18.warn("Auto-approve fix timed out — approving anyway (issues were minor)", { storyKey });
 				} catch (err) {
-					logger$17.warn("Auto-approve fix dispatch failed — approving anyway (issues were minor)", {
+					logger$18.warn("Auto-approve fix dispatch failed — approving anyway (issues were minor)", {
 						storyKey,
 						err
 					});
@@ -6143,6 +6408,7 @@ function createImplementationOrchestrator(deps) {
 					completedAt: new Date().toISOString()
 				});
 				writeStoryMetricsBestEffort(storyKey, "success", finalReviewCycles);
+				writeStoryOutcomeBestEffort(storyKey, "complete", finalReviewCycles);
 				eventBus.emit("orchestrator:story-complete", {
 					storyKey,
 					reviewCycles: finalReviewCycles
@@ -6203,7 +6469,7 @@ function createImplementationOrchestrator(deps) {
 					fixPrompt = assembled.prompt;
 				} catch {
 					fixPrompt = `Fix story ${storyKey}: verdict=${verdict}, taskType=${taskType}`;
-					logger$17.warn("Failed to assemble fix prompt, using fallback", {
+					logger$18.warn("Failed to assemble fix prompt, using fallback", {
 						storyKey,
 						taskType
 					});
@@ -6226,7 +6492,7 @@ function createImplementationOrchestrator(deps) {
 					} : void 0 }
 				});
 				if (fixResult.status === "timeout") {
-					logger$17.warn("Fix dispatch timed out — escalating story", {
+					logger$18.warn("Fix dispatch timed out — escalating story", {
 						storyKey,
 						taskType
 					});
@@ -6237,7 +6503,7 @@ function createImplementationOrchestrator(deps) {
 						completedAt: new Date().toISOString()
 					});
 					writeStoryMetricsBestEffort(storyKey, "escalated", reviewCycles + 1);
-					eventBus.emit("orchestrator:story-escalated", {
+					emitEscalation({
 						storyKey,
 						lastVerdict: verdict,
 						reviewCycles: reviewCycles + 1,
@@ -6246,13 +6512,13 @@ function createImplementationOrchestrator(deps) {
 					persistState();
 					return;
 				}
-				if (fixResult.status === "failed") logger$17.warn("Fix dispatch failed", {
+				if (fixResult.status === "failed") logger$18.warn("Fix dispatch failed", {
 					storyKey,
 					taskType,
 					exitCode: fixResult.exitCode
 				});
 			} catch (err) {
-				logger$17.warn("Fix dispatch failed, continuing to next review", {
+				logger$18.warn("Fix dispatch failed, continuing to next review", {
 					storyKey,
 					taskType,
 					err
@@ -6306,11 +6572,11 @@ function createImplementationOrchestrator(deps) {
 	}
 	async function run(storyKeys) {
 		if (_state === "RUNNING" || _state === "PAUSED") {
-			logger$17.warn("run() called while orchestrator is already running or paused — ignoring", { state: _state });
+			logger$18.warn("run() called while orchestrator is already running or paused — ignoring", { state: _state });
 			return getStatus();
 		}
 		if (_state === "COMPLETE") {
-			logger$17.warn("run() called on a COMPLETE orchestrator — ignoring", { state: _state });
+			logger$18.warn("run() called on a COMPLETE orchestrator — ignoring", { state: _state });
 			return getStatus();
 		}
 		_state = "RUNNING";
@@ -6328,13 +6594,13 @@ function createImplementationOrchestrator(deps) {
 		if (config.enableHeartbeat) startHeartbeat();
 		if (projectRoot !== void 0) {
 			const seedResult = seedMethodologyContext(db, projectRoot);
-			if (seedResult.decisionsCreated > 0) logger$17.info({
+			if (seedResult.decisionsCreated > 0) logger$18.info({
 				decisionsCreated: seedResult.decisionsCreated,
 				skippedCategories: seedResult.skippedCategories
 			}, "Methodology context seeded from planning artifacts");
 		}
 		const groups = detectConflictGroups(storyKeys);
-		logger$17.info("Orchestrator starting", {
+		logger$18.info("Orchestrator starting", {
 			storyCount: storyKeys.length,
 			groupCount: groups.length,
 			maxConcurrency: config.maxConcurrency
@@ -6346,7 +6612,7 @@ function createImplementationOrchestrator(deps) {
 			_state = "FAILED";
 			_completedAt = new Date().toISOString();
 			persistState();
-			logger$17.error("Orchestrator failed with unhandled error", { err });
+			logger$18.error("Orchestrator failed with unhandled error", { err });
 			return getStatus();
 		}
 		stopHeartbeat();
@@ -6373,7 +6639,7 @@ function createImplementationOrchestrator(deps) {
 		_pauseGate = createPauseGate();
 		_state = "PAUSED";
 		eventBus.emit("orchestrator:paused", {});
-		logger$17.info("Orchestrator paused");
+		logger$18.info("Orchestrator paused");
 	}
 	function resume() {
 		if (_state !== "PAUSED") return;
@@ -6384,7 +6650,7 @@ function createImplementationOrchestrator(deps) {
 		}
 		_state = "RUNNING";
 		eventBus.emit("orchestrator:resumed", {});
-		logger$17.info("Orchestrator resumed");
+		logger$18.info("Orchestrator resumed");
 	}
 	return {
 		run,
@@ -11022,7 +11288,8 @@ async function runRunAction(options) {
 					key: payload.storyKey,
 					reason: payload.lastVerdict ?? "escalated",
 					cycles: payload.reviewCycles ?? 0,
-					issues
+					issues,
+					...payload.diagnosis !== void 0 ? { diagnosis: payload.diagnosis } : {}
 				});
 			});
 			eventBus.on("orchestrator:story-warn", (payload) => {
@@ -11508,4 +11775,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-mFmS2pw6.js.map
+//# sourceMappingURL=run-CcWb6Kb-.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "substrate-ai",
-  "version": "0.2.19",
+  "version": "0.2.20",
   "description": "Substrate — multi-agent orchestration daemon for AI coding agents",
   "type": "module",
   "license": "MIT",

package/packs/bmad/prompts/code-review.md

@@ -14,6 +14,9 @@
 ### Architecture Constraints
 {{arch_constraints}}
 
+### Prior Run Findings
+{{prior_findings}}
+
 ---
 
 ## Mission
@@ -32,8 +35,9 @@ Adversarial code review. Find what's wrong. Validate story claims against actual
    - Whether each AC is actually implemented
    - Whether each `[x]` task is actually done
 
-3. **Execute adversarial review** across 4 dimensions:
+3. **Execute adversarial review** across 5 dimensions:
    - **AC Validation** — Is each acceptance criterion implemented?
+   - **AC-to-Test Traceability** — For each AC, identify the specific test file and test function that validates it. If an AC has no corresponding test evidence, flag it as a major issue: "AC{N} has no test evidence". A test "covers" an AC if it directly exercises the behavior described in the criterion — tangential tests do not count.
    - **Task Audit** — Tasks marked `[x]` that aren't done are BLOCKER issues
    - **Code Quality** — Security, error handling, edge cases, maintainability
    - **Test Quality** — Real assertions, not placeholders or skipped tests

package/packs/bmad/prompts/dev-story.md

@@ -16,6 +16,9 @@
 ### Test Patterns
 {{test_patterns}}
 
+### Prior Run Findings
+{{prior_findings}}
+
 ---
 
 ## Mission

package/dist/run-CUGB4FQx.js

@@ -1,7 +0,0 @@
-import { registerRunCommand, runRunAction } from "./run-mFmS2pw6.js";
-import "./logger-D2fS2ccL.js";
-import "./event-bus-BMxhfxfT.js";
-import "./decisions-Dq4cAA2L.js";
-import "./operational-CobuCGbM.js";
-
-export { runRunAction };