substrate-ai 0.20.8 → 0.20.12

package/dist/cli/index.js

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
-import { FileStateStore, RunManifest, SUBSTRATE_OWNED_SETTINGS_KEYS, SupervisorLock, VALID_PHASES, WorkGraphRepository, ZERO_FINDING_COUNTS, buildPipelineStatusOutput, createDatabaseAdapter, createStateStore, findPackageRoot, formatOutput, formatPipelineStatusHuman, formatPipelineSummary, formatTokenTelemetry, getAllDescendantPids, getAutoHealthData, getSubstrateDefaultSettings, inspectProcessTree, parseDbTimestampAsUtc, registerHealthCommand, resolveBmadMethodSrcPath, resolveBmadMethodVersion, resolveMainRepoRoot, resolveRunManifest, rollupFindingCounts } from "../health-DXW-E2vb.js";
+import { FileStateStore, RunManifest, SUBSTRATE_OWNED_SETTINGS_KEYS, SupervisorLock, VALID_PHASES, WorkGraphRepository, ZERO_FINDING_COUNTS, buildPipelineStatusOutput, createDatabaseAdapter, createStateStore, findPackageRoot, formatOutput, formatPipelineStatusHuman, formatPipelineSummary, formatTokenTelemetry, getAllDescendantPids, getAutoHealthData, getSubstrateDefaultSettings, inspectProcessTree, parseDbTimestampAsUtc, registerHealthCommand, resolveBmadMethodSrcPath, resolveBmadMethodVersion, resolveMainRepoRoot, resolveRunManifest, rollupFindingCounts } from "../health-0jqPFBEL.js";
 import { createLogger } from "../logger-KeHncl-f.js";
 import { createEventBus } from "../helpers-CElYrONe.js";
 import { AdapterRegistry, BudgetConfigSchema, CURRENT_CONFIG_FORMAT_VERSION, CURRENT_TASK_GRAPH_VERSION, ConfigError, CostTrackerConfigSchema, DEFAULT_CONFIG, DoltClient, DoltNotInstalled, GlobalSettingsSchema, IngestionServer, MonitorDatabaseImpl, OPERATIONAL_FINDING, PartialGlobalSettingsSchema, PartialProviderConfigSchema, ProvidersSchema, RoutingRecommender, STORY_METRICS, TelemetryConfigSchema, addTokenUsage, aggregateTokenUsageForRun, checkDoltInstalled, compareRunMetrics, createAmendmentRun, createConfigSystem, createDecision, createDoltClient, createPipelineRun, getActiveDecisions, getAllCostEntriesFiltered, getBaselineRunMetrics, getDecisionsByCategory, getDecisionsByPhaseForRun, getLatestCompletedRun, getLatestRun, getPipelineRunById, getPlanningCostTotal, getRetryableEscalations, getRunMetrics, getRunningPipelineRuns, getSessionCostSummary, getSessionCostSummaryFiltered, getStoryMetricsForRun, getTokenUsageSummary, incrementRunRestarts, initSchema, initializeDolt, listRunMetrics, loadParentRunDecisions, supersedeDecision, tagRunAsBaseline, updatePipelineRun } from "../dist-CqtWS9wF.js";
 import "../adapter-registry-DXLMTmfD.js";
-import { AdapterTelemetryPersistence, AppError, DoltRepoMapMetaRepository, DoltSymbolRepository, ERR_REPO_MAP_STORAGE_WRITE, EpicIngester, GitClient, GrammarLoader, RepoMapInjector, RepoMapModule, RepoMapQueryEngine, RepoMapStorage, SymbolParser, createContextCompiler, createDispatcher, createEventEmitter, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStopAfterGate, createTelemetryAdvisor, formatPhaseCompletionSummary, getFactoryRunSummaries, getScenarioResultsForRun, getTwinRunsForRun, listGraphRuns, registerExportCommand, registerFactoryCommand, registerRunCommand, registerScenariosCommand, resolveStoryKeys, runAnalysisPhase, runPlanningPhase, runSolutioningPhase, validateStopAfterFromConflict } from "../run-Bz3dW9Wn.js";
+import { AdapterTelemetryPersistence, AppError, DoltRepoMapMetaRepository, DoltSymbolRepository, ERR_REPO_MAP_STORAGE_WRITE, EpicIngester, GitClient, GrammarLoader, RepoMapInjector, RepoMapModule, RepoMapQueryEngine, RepoMapStorage, SymbolParser, createContextCompiler, createDispatcher, createEventEmitter, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStopAfterGate, createTelemetryAdvisor, formatPhaseCompletionSummary, getFactoryRunSummaries, getScenarioResultsForRun, getTwinRunsForRun, listGraphRuns, registerExportCommand, registerFactoryCommand, registerRunCommand, registerScenariosCommand, resolveStoryKeys, runAnalysisPhase, runPlanningPhase, runSolutioningPhase, validateStopAfterFromConflict } from "../run-B6qbsy-F.js";
 import "../errors-1uLGqnvr.js";
 import "../routing-CcBOCuC9.js";
 import "../decisions-C0pz9Clx.js";
@@ -3667,7 +3667,7 @@ async function runStatusAction(options) {
 			logger$12.debug({ err }, "Work graph query failed, continuing without work graph data");
 		}
 		if (run === void 0) {
-			const { inspectProcessTree: inspectProcessTree$1 } = await import("../health-Q8-69N9P.js");
+			const { inspectProcessTree: inspectProcessTree$1 } = await import("../health-C401hYzi.js");
 			const substrateDirPath = join(projectRoot, ".substrate");
 			const processInfo = inspectProcessTree$1({
 				projectRoot,
@@ -3712,6 +3712,7 @@ async function runStatusAction(options) {
 				} catch {}
 				const verificationResult = manifestPerStoryState?.[row.story_key]?.verification_result;
 				const verificationFindings = rollupFindingCounts(verificationResult);
+				const verificationRan = verificationResult !== void 0 && verificationResult !== null;
 				return {
 					story_key: row.story_key,
 					result: row.result,
@@ -3723,7 +3724,8 @@ async function runStatusAction(options) {
 					},
 					review_cycles: row.review_cycles ?? 0,
 					dispatches: row.dispatches ?? 0,
-					verification_findings: verificationFindings
+					verification_findings: verificationFindings,
+					verification_ran: verificationRan
 				};
 			});
 			let pipelineWallClockMs = 0;
@@ -5196,7 +5198,7 @@ async function runSupervisorAction(options, deps = {}) {
 								await initSchema(expAdapter);
 								const { runRunAction: runPipeline } = await import(
 									/* @vite-ignore */
-									"../run-C3kaptjF.js"
+									"../run-DEyd1p7U.js"
 );
 								const runStoryFn = async (opts) => {
 									const exitCode = await runPipeline({
@@ -5959,12 +5961,17 @@ async function runMetricsAction(options) {
 			}
 		} catch {}
 		const findingCountsByStoryRun = new Map();
+		const verificationRanByStoryRun = new Map();
 		const uniqueRunIds = Array.from(new Set(storyMetrics.map((sm) => sm.run_id).filter((id) => id !== "")));
 		for (const uniqueRunId of uniqueRunIds) try {
 			const { manifest } = await resolveRunManifest(dbRoot, uniqueRunId);
 			if (manifest === null) continue;
 			const data = await manifest.read();
-			for (const [storyKey, entry] of Object.entries(data.per_story_state)) findingCountsByStoryRun.set(`${storyKey}:${uniqueRunId}`, rollupFindingCounts(entry.verification_result));
+			for (const [storyKey, entry] of Object.entries(data.per_story_state)) {
+				const key = `${storyKey}:${uniqueRunId}`;
+				findingCountsByStoryRun.set(key, rollupFindingCounts(entry.verification_result));
+				verificationRanByStoryRun.set(key, entry.verification_result !== void 0 && entry.verification_result !== null);
+			}
 		} catch {}
 		let factoryRuns = [];
 		try {
@@ -5980,7 +5987,8 @@ async function runMetricsAction(options) {
 			}));
 			const storyMetricsWithFindings = storyMetrics.map((sm) => ({
 				...sm,
-				verification_findings: findingCountsByStoryRun.get(`${sm.story_key}:${sm.run_id}`) ?? { ...ZERO_FINDING_COUNTS }
+				verification_findings: findingCountsByStoryRun.get(`${sm.story_key}:${sm.run_id}`) ?? { ...ZERO_FINDING_COUNTS },
+				verification_ran: verificationRanByStoryRun.get(`${sm.story_key}:${sm.run_id}`) ?? false
 			}));
 			const jsonPayload = {
 				runs: runsWithBreakdown,

package/dist/{health-DXW-E2vb.js → health-0jqPFBEL.js}

@@ -3442,21 +3442,52 @@ const RuntimeProbeListSchema = z.array(RuntimeProbeSchema);
 //#endregion
 //#region packages/sdlc/dist/verification/probes/parser.js
 const SECTION_HEADING = /^##\s+Runtime\s+Probes\s*$/i;
+const FENCE_DELIMITER = /^\s*```/;
 /**
 * Return the raw text of the story's `## Runtime Probes` section (excluding
 * the heading line itself), or `undefined` if the section is not present.
 *
 * The section ends at the next `##` heading or end-of-file. Sub-headings
 * (`###`, `####`) remain part of the section body.
+*
+* Story 58-4: the scan tracks code-fence depth so a `## Runtime Probes`
+* heading that appears *inside* an outer ``` block is ignored. Stories that
+* DOCUMENT probes in prose — regression fixtures, how-to-author docs, the
+* Epic 58 e2e test spec — contain illustrative `## Runtime Probes` examples
+* inside outer fences. Without fence-awareness the parser matches those
+* illustrations as the story's own section, fails to find a terminated
+* yaml block (the inner fences are typically escaped), and emits a spurious
+* `runtime-probe-parse-error`. Hit live during the Epic 58 substrate
+* dispatch on 58-3's artifact.
 */
 function extractRuntimeProbesSection(storyContent) {
 	const lines = storyContent.split(/\r?\n/);
-	const start = lines.findIndex((line) => SECTION_HEADING.test(line.trim()));
+	let inCodeFence = false;
+	let start = -1;
+	for (let i = 0; i < lines.length; i += 1) {
+		const line = lines[i] ?? "";
+		if (FENCE_DELIMITER.test(line)) {
+			inCodeFence = !inCodeFence;
+			continue;
+		}
+		if (!inCodeFence && SECTION_HEADING.test(line.trim())) {
+			start = i;
+			break;
+		}
+	}
 	if (start === -1) return void 0;
 	let end = lines.length;
-	for (let i = start + 1; i < lines.length; i += 1) if (/^##\s+\S/.test(lines[i] ?? "")) {
-		end = i;
-		break;
+	inCodeFence = false;
+	for (let i = start + 1; i < lines.length; i += 1) {
+		const line = lines[i] ?? "";
+		if (FENCE_DELIMITER.test(line)) {
+			inCodeFence = !inCodeFence;
+			continue;
+		}
+		if (!inCodeFence && /^##\s+\S/.test(line)) {
+			end = i;
+			break;
+		}
 	}
 	return lines.slice(start + 1, end).join("\n");
 }
@@ -3732,6 +3763,113 @@ var RuntimeProbeCheck = class {
 	}
 };
 
+//#endregion
+//#region packages/sdlc/dist/verification/source-ac-fidelity-check.js
+/**
+* Extract the story's section from the full epic content.
+*
+* Uses the same heading pattern as `isImplicitlyCovered` in the monolith:
+*   `### Story <storyKey>:` or `### Story <storyKey> ` or `### Story <storyKey>\n`
+*
+* Returns the extracted section text (from the heading match through to the
+* next `### Story` heading or end of file), or the full content if no
+* matching heading is found.
+*/
+function extractStorySection(epicContent, storyKey) {
+	const escapedKey = storyKey.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+	const headingPattern = new RegExp(`^###\\s+Story\\s+${escapedKey}[:\\s]`, "m");
+	const match = headingPattern.exec(epicContent);
+	if (!match) return epicContent;
+	const start = match.index;
+	const nextHeading = /\n### Story /m.exec(epicContent.slice(start + 1));
+	if (nextHeading) return epicContent.slice(start, start + 1 + nextHeading.index);
+	return epicContent.slice(start);
+}
+/**
+* Extract hard clauses from a story section of an epic file.
+*
+* Hard clauses:
+*   1. Lines containing MUST NOT / MUST / SHALL NOT / SHALL as standalone keywords (case-sensitive)
+*   2. Backtick-wrapped paths with at least one `/` (excludes bare filenames)
+*   3. The presence of `## Runtime Probes` heading followed by a fenced yaml block
+*      (represented as a single "runtime-probes-section" clause)
+*/
+function extractHardClauses(sectionContent) {
+	const clauses = [];
+	const mustPattern = /\b(MUST NOT|MUST|SHALL NOT|SHALL)\b/;
+	const lines = sectionContent.split("\n");
+	for (const line of lines) {
+		const match = mustPattern.exec(line);
+		if (match) {
+			const keyword = match[1];
+			clauses.push({
+				type: keyword,
+				text: line.trim()
+			});
+		}
+	}
+	const pathPattern = /`([a-zA-Z0-9_./-]+\/[a-zA-Z0-9_./-]+)`/g;
+	let pathMatch;
+	while ((pathMatch = pathPattern.exec(sectionContent)) !== null) clauses.push({
+		type: "path",
+		text: `\`${pathMatch[1]}\``
+	});
+	const probesPattern = /^##\s+Runtime Probes[\s\S]*?```yaml/m;
+	if (probesPattern.test(sectionContent)) clauses.push({
+		type: "runtime-probes-section",
+		text: "## Runtime Probes"
+	});
+	return clauses;
+}
+var SourceAcFidelityCheck = class {
+	name = "source-ac-fidelity";
+	tier = "A";
+	async run(context) {
+		const start = Date.now();
+		if (!context.sourceEpicContent) {
+			const findings$1 = [{
+				category: "source-ac-source-unavailable",
+				severity: "warn",
+				message: "source epic content unavailable — skipping fidelity check"
+			}];
+			return {
+				status: "pass",
+				details: renderFindings(findings$1),
+				duration_ms: Date.now() - start,
+				findings: findings$1
+			};
+		}
+		const storySection = extractStorySection(context.sourceEpicContent, context.storyKey);
+		const hardClauses = extractHardClauses(storySection);
+		const findings = [];
+		const storyContent = context.storyContent ?? "";
+		for (const clause of hardClauses) if (clause.type === "runtime-probes-section") {
+			if (!storyContent.includes("## Runtime Probes")) {
+				const truncated = clause.text.length > 120 ? clause.text.slice(0, 120) : clause.text;
+				findings.push({
+					category: "source-ac-drift",
+					severity: "error",
+					message: `runtime-probes-section: "${truncated}" present in epics source but absent in story artifact`
+				});
+			}
+		} else if (!storyContent.includes(clause.text)) {
+			const truncated = clause.text.length > 120 ? clause.text.slice(0, 120) : clause.text;
+			findings.push({
+				category: "source-ac-drift",
+				severity: "error",
+				message: `${clause.type}: "${truncated}" present in epics source but absent in story artifact`
+			});
+		}
+		const status = findings.some((f) => f.severity === "error") ? "fail" : "pass";
+		return {
+			status,
+			details: findings.length > 0 ? renderFindings(findings) : `source-ac-fidelity: ${hardClauses.length} hard clause(s) verified — all present`,
+			duration_ms: Date.now() - start,
+			findings
+		};
+	}
+};
+
 //#endregion
 //#region packages/sdlc/dist/verification/verification-pipeline.js
 /**
@@ -3839,12 +3977,14 @@ var VerificationPipeline = class {
 * Create a VerificationPipeline pre-loaded with the canonical check set.
 *
 * Canonical Tier A check order:
-*   1. PhantomReviewCheck — story 51-2  (runs first: unreviewed stories skipped)
-*   2. TrivialOutputCheck — story 51-3
+*   1. PhantomReviewCheck      — story 51-2  (runs first: unreviewed stories skipped)
+*   2. TrivialOutputCheck      — story 51-3
 *   3. AcceptanceCriteriaEvidenceCheck
-*   4. BuildCheck         — story 51-4
-*   5. RuntimeProbeCheck  — Epic 55 Phase 2: runtime behavior gate; runs last
-*                           in Tier A because probes may depend on built artifacts
+*   4. BuildCheck              — story 51-4
+*   5. RuntimeProbeCheck       — Epic 55 Phase 2: runtime behavior gate; runs last
+*                                in Tier A because probes may depend on built artifacts
+*   6. SourceAcFidelityCheck   — Story 58-2: cross-references rendered story artifact
+*                                against the source epic's hard clauses (MUST/SHALL/paths)
 *
 * @param bus    Typed event bus for verification events.
 * @param config Optional config (used to forward threshold to TrivialOutputCheck).
@@ -3855,7 +3995,8 @@ function createDefaultVerificationPipeline(bus, config) {
 		new TrivialOutputCheck(config),
 		new AcceptanceCriteriaEvidenceCheck(),
 		new BuildCheck(),
-		new RuntimeProbeCheck()
+		new RuntimeProbeCheck(),
+		new SourceAcFidelityCheck()
 	];
 	return new VerificationPipeline(bus, checks);
 }
@@ -4185,6 +4326,11 @@ var RunManifest = class RunManifest {
 	baseDir;
 	/** Optional Dolt adapter for degraded-mode fallback on read. */
 	doltAdapter;
+	/**
+	* Serializes all write operations on this instance to prevent lost-update races.
+	* Initialized to a resolved promise; each enqueued operation chains off the tail.
+	*/
+	_writeChain = Promise.resolve();
 	constructor(runId, baseDir = defaultBaseDir(), doltAdapter = null) {
 		this.runId = runId;
 		this.baseDir = baseDir;
@@ -4231,7 +4377,22 @@ var RunManifest = class RunManifest {
 		await this.write(merged);
 	}
 	/**
-	* Atomically write the manifest to disk.
+	* Append `fn` to the per-instance write chain so all write operations execute
+	* strictly sequentially, preventing lost-update races on concurrent callers.
+	*
+	* The chain itself never rejects (errors are swallowed on the chain side);
+	* the returned promise resolves or rejects exactly when `fn` settles, so
+	* fire-and-forget `.catch()` callers still receive failure signals.
+	*/
+	_enqueue(fn) {
+		const next = this._writeChain.then(() => fn());
+		this._writeChain = next.then(() => void 0, () => void 0);
+		return next;
+	}
+	/**
+	* Raw implementation of the atomic manifest write.
+	* Must only be called from within an `_enqueue`-d function to maintain
+	* the serialization invariant.
 	*
 	* Sequence:
 	*   1. Auto-increment `generation`, set `updated_at`
@@ -4241,7 +4402,7 @@ var RunManifest = class RunManifest {
 	*   5. If primary exists, copy to `.bak`
 	*   6. Rename `.tmp` → primary path
 	*/
-	async write(data) {
+	async _writeImpl(data) {
 		let currentGeneration = 0;
 		const existing = await tryReadFile(this.primaryPath);
 		if (existing !== null) currentGeneration = existing.generation;
@@ -4267,6 +4428,15 @@ var RunManifest = class RunManifest {
 		await promises.rename(tmp, this.primaryPath);
 	}
 	/**
+	* Atomically write the manifest to disk.
+	*
+	* Enqueues the write via `_enqueue` so concurrent calls are serialized.
+	* The returned promise resolves when this call's write completes.
+	*/
+	async write(data) {
+		return this._enqueue(() => this._writeImpl(data));
+	}
+	/**
 	* Return a bound `RunManifest` instance without performing any file I/O.
 	*
 	* Use `open()` when you want to call instance methods (`read()`, `patchCLIFlags()`)
@@ -4280,13 +4450,9 @@ var RunManifest = class RunManifest {
 		return new RunManifest(runId, baseDir, doltAdapter);
 	}
 	/**
-	* Read the current manifest (or create a minimal default), merge the provided
-	* CLI flags into `cli_flags`, and write the result atomically.
-	*
-	* Non-fatal: callers should wrap in try/catch and log a warning on failure.
-	* The pipeline must not abort if manifest write fails.
+	* Raw implementation — must only be called from within `_enqueue`.
 	*/
-	async patchCLIFlags(flags) {
+	async _patchCLIFlagsImpl(flags) {
 		let existingData;
 		try {
 			const read = await RunManifest.read(this.runId, this.baseDir, this.doltAdapter);
@@ -4310,7 +4476,7 @@ var RunManifest = class RunManifest {
 				created_at: now
 			};
 		}
-		await this.write({
+		await this._writeImpl({
 			...existingData,
 			cli_flags: {
 				...existingData.cli_flags,
@@ -4319,21 +4485,20 @@ var RunManifest = class RunManifest {
 		});
 	}
 	/**
-	* Atomically upsert the per-story lifecycle state for a single story key.
-	*
-	* Reads the current manifest (or creates a minimal default if absent),
-	* shallowly merges `updates` into `per_story_state[storyKey]`, and writes
-	* the result atomically via a single `write()` call.
-	*
-	* Fields not included in `updates` on an existing entry are preserved unchanged.
-	*
-	* Non-fatal: callers MUST wrap in `.catch((err) => logger.warn(...))`.
-	* The pipeline must never abort due to a manifest write failure.
+	* Read the current manifest (or create a minimal default), merge the provided
+	* CLI flags into `cli_flags`, and write the result atomically.
 	*
-	* @param storyKey - Story key (e.g. '52-4')
-	* @param updates  - Partial PerStoryState fields to merge
+	* Enqueues the operation via `_enqueue` so concurrent calls are serialized.
+	* Non-fatal: callers should wrap in try/catch and log a warning on failure.
+	* The pipeline must not abort if manifest write fails.
 	*/
-	async patchStoryState(storyKey, updates) {
+	async patchCLIFlags(flags) {
+		return this._enqueue(() => this._patchCLIFlagsImpl(flags));
+	}
+	/**
+	* Raw implementation — must only be called from within `_enqueue`.
+	*/
+	async _patchStoryStateImpl(storyKey, updates) {
 		let existingData;
 		try {
 			const read = await RunManifest.read(this.runId, this.baseDir, this.doltAdapter);
@@ -4365,7 +4530,7 @@ var RunManifest = class RunManifest {
 			...existing,
 			...updates
 		};
-		await this.write({
+		await this._writeImpl({
 			...existingData,
 			per_story_state: {
 				...existingData.per_story_state,
@@ -4374,22 +4539,28 @@ var RunManifest = class RunManifest {
 		});
 	}
 	/**
-	* Atomically append a recovery entry and update cost accumulation.
+	* Atomically upsert the per-story lifecycle state for a single story key.
 	*
-	* Reads the current manifest, appends `entry` to `recovery_history[]`,
-	* increments `cost_accumulation.per_story[entry.story_key]` by `entry.cost_usd`,
-	* increments `cost_accumulation.run_total` by `entry.cost_usd`, then writes
-	* atomically via a single `write()` call.
+	* Reads the current manifest (or creates a minimal default if absent),
+	* shallowly merges `updates` into `per_story_state[storyKey]`, and writes
+	* the result atomically via a single `write()` call.
+	*
+	* Fields not included in `updates` on an existing entry are preserved unchanged.
 	*
+	* Enqueues the operation via `_enqueue` so concurrent calls are serialized.
 	* Non-fatal: callers MUST wrap in `.catch((err) => logger.warn(...))`.
 	* The pipeline must never abort due to a manifest write failure.
 	*
-	* `entry.cost_usd` is the cost of this single retry attempt only (NOT cumulative).
-	* Cumulative per-story retry cost is tracked in `cost_accumulation.per_story`.
-	*
-	* @param entry - Recovery entry to append (attempt_number is 1-indexed)
+	* @param storyKey - Story key (e.g. '52-4')
+	* @param updates  - Partial PerStoryState fields to merge
 	*/
-	async appendRecoveryEntry(entry) {
+	async patchStoryState(storyKey, updates) {
+		return this._enqueue(() => this._patchStoryStateImpl(storyKey, updates));
+	}
+	/**
+	* Raw implementation — must only be called from within `_enqueue`.
+	*/
+	async _appendRecoveryEntryImpl(entry) {
 		let existingData;
 		try {
 			const read = await RunManifest.read(this.runId, this.baseDir, this.doltAdapter);
@@ -4425,7 +4596,27 @@ var RunManifest = class RunManifest {
 				run_total: existingData.cost_accumulation.run_total + entry.cost_usd
 			}
 		};
-		await this.write(updated);
+		await this._writeImpl(updated);
+	}
+	/**
+	* Atomically append a recovery entry and update cost accumulation.
+	*
+	* Reads the current manifest, appends `entry` to `recovery_history[]`,
+	* increments `cost_accumulation.per_story[entry.story_key]` by `entry.cost_usd`,
+	* increments `cost_accumulation.run_total` by `entry.cost_usd`, then writes
+	* atomically via a single `write()` call.
+	*
+	* Enqueues the operation via `_enqueue` so concurrent calls are serialized.
+	* Non-fatal: callers MUST wrap in `.catch((err) => logger.warn(...))`.
+	* The pipeline must never abort due to a manifest write failure.
+	*
+	* `entry.cost_usd` is the cost of this single retry attempt only (NOT cumulative).
+	* Cumulative per-story retry cost is tracked in `cost_accumulation.per_story`.
+	*
+	* @param entry - Recovery entry to append (attempt_number is 1-indexed)
+	*/
+	async appendRecoveryEntry(entry) {
+		return this._enqueue(() => this._appendRecoveryEntryImpl(entry));
 	}
 	/**
 	* Create a new manifest with `generation: 0` and write it.
@@ -5286,4 +5477,4 @@ function registerHealthCommand(program, _version = "0.0.0", projectRoot = proces
 
 //#endregion
 export { BMAD_BASELINE_TOKENS_FULL, DEFAULT_STALL_THRESHOLD_SECONDS, DoltMergeConflict, FileStateStore, FindingsInjector, RunManifest, STOP_AFTER_VALID_PHASES, STORY_KEY_PATTERN$1 as STORY_KEY_PATTERN, SUBSTRATE_OWNED_SETTINGS_KEYS, SupervisorLock, VALID_PHASES, WorkGraphRepository, ZERO_FINDING_COUNTS, __commonJS, __require, __toESM, applyConfigToGraph, buildPipelineStatusOutput, createDatabaseAdapter$1 as createDatabaseAdapter, createDefaultVerificationPipeline, createGraphOrchestrator, createSdlcCodeReviewHandler, createSdlcCreateStoryHandler, createSdlcDevStoryHandler, createSdlcPhaseHandler, createStateStore, detectCycles, extractTargetFilesFromStoryContent, findPackageRoot, formatOutput, formatPipelineStatusHuman, formatPipelineSummary, formatTokenTelemetry, getAllDescendantPids, getAutoHealthData, getSubstrateDefaultSettings, inspectProcessTree, isOrchestratorProcessLine, parseDbTimestampAsUtc, registerHealthCommand, renderFindings, resolveBmadMethodSrcPath, resolveBmadMethodVersion, resolveGraphPath, resolveMainRepoRoot, resolveRunManifest, rollupFindingCounts, runHealthAction, validateStoryKey };
-//# sourceMappingURL=health-DXW-E2vb.js.map
+//# sourceMappingURL=health-0jqPFBEL.js.map

package/dist/{health-Q8-69N9P.js → health-C401hYzi.js}

@@ -1,4 +1,4 @@
-import { DEFAULT_STALL_THRESHOLD_SECONDS, getAllDescendantPids, getAutoHealthData, inspectProcessTree, isOrchestratorProcessLine, registerHealthCommand, runHealthAction } from "./health-DXW-E2vb.js";
+import { DEFAULT_STALL_THRESHOLD_SECONDS, getAllDescendantPids, getAutoHealthData, inspectProcessTree, isOrchestratorProcessLine, registerHealthCommand, runHealthAction } from "./health-0jqPFBEL.js";
 import "./logger-KeHncl-f.js";
 import "./dist-CqtWS9wF.js";
 import "./decisions-C0pz9Clx.js";

package/dist/{run-Bz3dW9Wn.js → run-B6qbsy-F.js}

@@ -1,4 +1,4 @@
-import { BMAD_BASELINE_TOKENS_FULL, DoltMergeConflict, FileStateStore, FindingsInjector, RunManifest, STOP_AFTER_VALID_PHASES, STORY_KEY_PATTERN, VALID_PHASES, WorkGraphRepository, __commonJS, __require, __toESM, applyConfigToGraph, buildPipelineStatusOutput, createDatabaseAdapter, createDefaultVerificationPipeline, createGraphOrchestrator, createSdlcCodeReviewHandler, createSdlcCreateStoryHandler, createSdlcDevStoryHandler, createSdlcPhaseHandler, detectCycles, extractTargetFilesFromStoryContent, formatOutput, formatPipelineSummary, formatTokenTelemetry, inspectProcessTree, parseDbTimestampAsUtc, renderFindings, resolveGraphPath, resolveMainRepoRoot, validateStoryKey } from "./health-DXW-E2vb.js";
+import { BMAD_BASELINE_TOKENS_FULL, DoltMergeConflict, FileStateStore, FindingsInjector, RunManifest, STOP_AFTER_VALID_PHASES, STORY_KEY_PATTERN, VALID_PHASES, WorkGraphRepository, __commonJS, __require, __toESM, applyConfigToGraph, buildPipelineStatusOutput, createDatabaseAdapter, createDefaultVerificationPipeline, createGraphOrchestrator, createSdlcCodeReviewHandler, createSdlcCreateStoryHandler, createSdlcDevStoryHandler, createSdlcPhaseHandler, detectCycles, extractTargetFilesFromStoryContent, formatOutput, formatPipelineSummary, formatTokenTelemetry, inspectProcessTree, parseDbTimestampAsUtc, renderFindings, resolveGraphPath, resolveMainRepoRoot, validateStoryKey } from "./health-0jqPFBEL.js";
 import { createLogger } from "./logger-KeHncl-f.js";
 import { TypedEventBusImpl, createEventBus, createTuiApp, isTuiCapable, printNonTtyWarning, sleep } from "./helpers-CElYrONe.js";
 import { ADVISORY_NOTES, Categorizer, ConsumerAnalyzer, DEFAULT_GLOBAL_SETTINGS, DispatcherImpl, DoltClient, ESCALATION_DIAGNOSIS, EXPERIMENT_RESULT, EfficiencyScorer, IngestionServer, LogTurnAnalyzer, OPERATIONAL_FINDING, Recommender, RoutingRecommender, RoutingResolver, RoutingTelemetry, RoutingTokenAccumulator, RoutingTuner, STORY_METRICS, STORY_OUTCOME, SubstrateConfigSchema, TEST_EXPANSION_FINDING, TEST_PLAN, TelemetryNormalizer, TelemetryPipeline, TurnAnalyzer, addTokenUsage, aggregateTokenUsageForRun, aggregateTokenUsageForStory, callLLM, createConfigSystem, createDatabaseAdapter$1, createDecision, createPipelineRun, createRequirement, detectInterfaceChanges, getArtifactByTypeForRun, getArtifactsByRun, getDecisionsByCategory, getDecisionsByPhase, getDecisionsByPhaseForRun, getLatestRun, getPipelineRunById, getRunMetrics, getRunningPipelineRuns, getStoryMetricsForRun, getTokenUsageSummary, initSchema, listRequirements, loadModelRoutingConfig, registerArtifact, updatePipelineRun, updatePipelineRunConfig, upsertDecision, writeRunMetrics, writeStoryMetrics } from "./dist-CqtWS9wF.js";
@@ -5911,13 +5911,14 @@ async function getImplementationDecisions(deps, pipelineRunId) {
 */
 function extractStorySection(shardContent, storyKey) {
 	if (!shardContent || !storyKey) return null;
-	const escaped = storyKey.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-	const headingPattern = new RegExp(`(?:^#{2,4}\\s+Story\\s+${escaped}\\b|^Story\\s+${escaped}:|^\\*\\*${escaped}\\*\\*|^${escaped}:)`, "mi");
+	const parts = storyKey.split(/[-._ ]/);
+	const normalized = parts.map((p) => p.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")).join("[-._ ]");
+	const headingPattern = new RegExp(`(?:^#{2,4}\\s+Story\\s+${normalized}\\b|^Story\\s+${normalized}:|^\\*\\*${normalized}\\*\\*|^${normalized}:)`, "mi");
 	const match$2 = headingPattern.exec(shardContent);
 	if (!match$2) return null;
 	const startIdx = match$2.index;
 	const rest = shardContent.slice(startIdx + match$2[0].length);
-	const nextStoryPattern = new RegExp(`(?:^#{2,4}\\s+Story\\s+[\\d]|^Story\\s+[\\d][\\d-]*:|^\\*\\*[\\d][\\d-]*\\*\\*|^[\\d][\\d-]*:)`, "mi");
+	const nextStoryPattern = new RegExp(`(?:^#{2,4}\\s+Story\\s+[\\d]|^Story\\s+[\\d][\\d.\\-_a-z]*:|^\\*\\*[\\d][\\d.\\-_a-z]*\\*\\*|^[\\d][\\d.\\-_a-z]*:)`, "mi");
 	const nextMatch = nextStoryPattern.exec(rest);
 	const endIdx = nextMatch !== null ? startIdx + match$2[0].length + nextMatch.index : shardContent.length;
 	const section = shardContent.slice(startIdx, endIdx).trim();
@@ -10429,7 +10430,8 @@ function assembleVerificationContext(opts) {
 		reviewResult: opts.reviewResult,
 		storyContent: opts.storyContent,
 		devStoryResult: opts.devStoryResult,
-		outputTokenCount: opts.outputTokenCount
+		outputTokenCount: opts.outputTokenCount,
+		sourceEpicContent: opts.sourceEpicContent
 	};
 }
 /**
@@ -10462,20 +10464,23 @@ var VerificationStore = class {
 * verification results survive process crashes.
 *
 * Design notes:
-* - Non-fatal: the returned promise is wrapped in `.catch()` at the call site
-*   so a manifest write failure never aborts the pipeline.
+* - Non-fatal: the `.catch()` handler swallows any rejection and logs at warn.
+* - Returns a `Promise<void>` so callers can optionally `await` it to ensure
+*   ordering (Story 57-2). Fire-and-forget callers that discard the return
+*   value continue to compile and work correctly.
 * - Reuses the single RunManifest instance injected by the orchestrator to
 *   avoid concurrent-write conflicts with the atomic-write lock.
 * - `runManifest` is optional (`undefined | null`) — callers from contexts
-*   where no manifest is configured pass `null` and this function is a no-op.
+*   where no manifest is configured pass `null` and this function returns a
+*   resolved promise (no-op).
 *
 * @param storyKey    - Story key being verified (e.g. '52-7')
 * @param summary     - VerificationSummary returned by VerificationPipeline.run()
 * @param runManifest - RunManifest instance to write to, or null/undefined to skip
 */
 function persistVerificationResult(storyKey, summary, runManifest) {
-	if (runManifest == null) return;
-	runManifest.patchStoryState(storyKey, { verification_result: summary }).catch((err) => _logger.warn({
+	if (runManifest == null) return Promise.resolve();
+	return runManifest.patchStoryState(storyKey, { verification_result: summary }).catch((err) => _logger.warn({
 		err,
 		storyKey
 	}, "manifest verification_result write failed — pipeline continues"));
@@ -12072,21 +12077,17 @@ function createImplementationOrchestrator(deps) {
 				phase: "IN_STORY_CREATION",
 				result: createResult
 			});
-			if (config.pipelineRunId !== void 0 && createResult.tokenUsage !== void 0) try {
-				addTokenUsage(db, config.pipelineRunId, {
-					phase: "create-story",
-					agent: "create-story",
-					input_tokens: createResult.tokenUsage.input,
-					output_tokens: createResult.tokenUsage.output,
-					cost_usd: estimateDispatchCost(createResult.tokenUsage.input, createResult.tokenUsage.output),
-					metadata: JSON.stringify({ storyKey })
-				});
-			} catch (tokenErr) {
-				logger$24.warn({
-					storyKey,
-					err: tokenErr
-				}, "Failed to record create-story token usage");
-			}
+			if (config.pipelineRunId !== void 0 && createResult.tokenUsage !== void 0) Promise.resolve().then(() => addTokenUsage(db, config.pipelineRunId, {
+				phase: "create-story",
+				agent: "create-story",
+				input_tokens: createResult.tokenUsage.input,
+				output_tokens: createResult.tokenUsage.output,
+				cost_usd: estimateDispatchCost(createResult.tokenUsage.input, createResult.tokenUsage.output),
+				metadata: JSON.stringify({ storyKey })
+			})).catch((tokenErr) => logger$24.warn({
+				storyKey,
+				err: tokenErr
+			}, "Failed to record create-story token usage"));
 			await persistState();
 			if (createResult.result === "failed") {
 				const errMsg = createResult.error ?? "create-story failed";
@@ -12256,21 +12257,17 @@ function createImplementationOrchestrator(deps) {
 			}, "Test planning failed — proceeding to dev-story without test plan");
 		}
 		endPhase(storyKey, "test-plan");
-		if (config.pipelineRunId !== void 0 && testPlanTokenUsage !== void 0) try {
-			addTokenUsage(db, config.pipelineRunId, {
-				phase: "test-plan",
-				agent: "test-plan",
-				input_tokens: testPlanTokenUsage.input,
-				output_tokens: testPlanTokenUsage.output,
-				cost_usd: estimateDispatchCost(testPlanTokenUsage.input, testPlanTokenUsage.output),
-				metadata: JSON.stringify({ storyKey })
-			});
-		} catch (tokenErr) {
-			logger$24.warn({
-				storyKey,
-				err: tokenErr
-			}, "Failed to record test-plan token usage");
-		}
+		if (config.pipelineRunId !== void 0 && testPlanTokenUsage !== void 0) Promise.resolve().then(() => addTokenUsage(db, config.pipelineRunId, {
+			phase: "test-plan",
+			agent: "test-plan",
+			input_tokens: testPlanTokenUsage.input,
+			output_tokens: testPlanTokenUsage.output,
+			cost_usd: estimateDispatchCost(testPlanTokenUsage.input, testPlanTokenUsage.output),
+			metadata: JSON.stringify({ storyKey })
+		})).catch((tokenErr) => logger$24.warn({
+			storyKey,
+			err: tokenErr
+		}, "Failed to record test-plan token usage"));
 		eventBus.emit("orchestrator:story-phase-complete", {
 			storyKey,
 			phase: "IN_TEST_PLANNING",
@@ -12419,28 +12416,24 @@ function createImplementationOrchestrator(deps) {
 						batchIndex: batch.batchIndex,
 						files: batchFilesModified
 					});
-					if (config.pipelineRunId !== void 0 && batchResult.tokenUsage !== void 0) try {
-						addTokenUsage(db, config.pipelineRunId, {
-							phase: "dev-story",
-							agent: `batch-${batch.batchIndex}`,
-							input_tokens: batchResult.tokenUsage.input,
-							output_tokens: batchResult.tokenUsage.output,
-							cost_usd: estimateDispatchCost(batchResult.tokenUsage.input, batchResult.tokenUsage.output),
-							metadata: JSON.stringify({
-								storyKey,
-								batchIndex: batch.batchIndex,
-								taskIds: batch.taskIds,
-								durationMs: batchDurationMs,
-								result: batchMetrics.result
-							})
-						});
-					} catch (tokenErr) {
-						logger$24.warn({
+					if (config.pipelineRunId !== void 0 && batchResult.tokenUsage !== void 0) Promise.resolve().then(() => addTokenUsage(db, config.pipelineRunId, {
+						phase: "dev-story",
+						agent: `batch-${batch.batchIndex}`,
+						input_tokens: batchResult.tokenUsage.input,
+						output_tokens: batchResult.tokenUsage.output,
+						cost_usd: estimateDispatchCost(batchResult.tokenUsage.input, batchResult.tokenUsage.output),
+						metadata: JSON.stringify({
 							storyKey,
 							batchIndex: batch.batchIndex,
-							err: tokenErr
-						}, "Failed to record batch token usage");
-					}
+							taskIds: batch.taskIds,
+							durationMs: batchDurationMs,
+							result: batchMetrics.result
+						})
+					})).catch((tokenErr) => logger$24.warn({
+						storyKey,
+						batchIndex: batch.batchIndex,
+						err: tokenErr
+					}, "Failed to record batch token usage"));
 					if (batchResult.tokenUsage?.output !== void 0) devOutputTokenCount = (devOutputTokenCount ?? 0) + batchResult.tokenUsage.output;
 					if (batchResult.result === "failed") logger$24.warn({
 						storyKey,
@@ -12478,21 +12471,17 @@ function createImplementationOrchestrator(deps) {
 				});
 				devFilesModified = devResult.files_modified ?? [];
 				devOutputTokenCount = devResult.tokenUsage?.output ?? void 0;
-				if (config.pipelineRunId !== void 0 && devResult.tokenUsage !== void 0) try {
-					addTokenUsage(db, config.pipelineRunId, {
-						phase: "dev-story",
-						agent: "dev-story",
-						input_tokens: devResult.tokenUsage.input,
-						output_tokens: devResult.tokenUsage.output,
-						cost_usd: estimateDispatchCost(devResult.tokenUsage.input, devResult.tokenUsage.output),
-						metadata: JSON.stringify({ storyKey })
-					});
-				} catch (tokenErr) {
-					logger$24.warn({
-						storyKey,
-						err: tokenErr
-					}, "Failed to record dev-story token usage");
-				}
+				if (config.pipelineRunId !== void 0 && devResult.tokenUsage !== void 0) Promise.resolve().then(() => addTokenUsage(db, config.pipelineRunId, {
+					phase: "dev-story",
+					agent: "dev-story",
+					input_tokens: devResult.tokenUsage.input,
+					output_tokens: devResult.tokenUsage.output,
+					cost_usd: estimateDispatchCost(devResult.tokenUsage.input, devResult.tokenUsage.output),
+					metadata: JSON.stringify({ storyKey })
+				})).catch((tokenErr) => logger$24.warn({
+					storyKey,
+					err: tokenErr
+				}, "Failed to record dev-story token usage"));
 				eventBus.emit("orchestrator:story-phase-complete", {
 					storyKey,
 					phase: "IN_DEV",
@@ -13151,23 +13140,22 @@ function createImplementationOrchestrator(deps) {
 						...baselineHeadSha ? { baselineCommit: baselineHeadSha } : {}
 					});
 				}
-				if (config.pipelineRunId !== void 0 && reviewResult.tokenUsage !== void 0) try {
-					addTokenUsage(db, config.pipelineRunId, {
+				if (config.pipelineRunId !== void 0 && reviewResult?.tokenUsage !== void 0) {
+					const reviewTokens = reviewResult.tokenUsage;
+					Promise.resolve().then(() => addTokenUsage(db, config.pipelineRunId, {
 						phase: "code-review",
 						agent: useBatchedReview ? "code-review-batched" : "code-review",
-						input_tokens: reviewResult.tokenUsage.input,
-						output_tokens: reviewResult.tokenUsage.output,
-						cost_usd: estimateDispatchCost(reviewResult.tokenUsage.input, reviewResult.tokenUsage.output),
+						input_tokens: reviewTokens.input,
+						output_tokens: reviewTokens.output,
+						cost_usd: estimateDispatchCost(reviewTokens.input, reviewTokens.output),
 						metadata: JSON.stringify({
 							storyKey,
 							reviewCycle: reviewCycles
 						})
-					});
-				} catch (tokenErr) {
-					logger$24.warn({
+					})).catch((tokenErr) => logger$24.warn({
 						storyKey,
 						err: tokenErr
-					}, "Failed to record code-review token usage");
+					}, "Failed to record code-review token usage"));
 				}
 				const isPhantomReview = reviewResult.dispatchFailed === true || reviewResult.verdict !== "SHIP_IT" && reviewResult.verdict !== "LGTM_WITH_NOTES" && (reviewResult.issue_list === void 0 || reviewResult.issue_list.length === 0) && reviewResult.error !== void 0;
 				if (isPhantomReview && !timeoutRetried) {
@@ -13272,17 +13260,25 @@ function createImplementationOrchestrator(deps) {
 						error: reviewResult.error,
 						rawOutput: reviewResult.rawOutput
 					} : void 0;
+					let sourceEpicContent;
+					const epicsPath1 = findEpicsFile(projectRoot ?? process.cwd());
+					if (epicsPath1) try {
+						const epicFull = readFileSync(epicsPath1, "utf-8");
+						const section = extractStorySection(epicFull, storyKey);
+						if (section) sourceEpicContent = section;
+					} catch {}
 					const verifContext = assembleVerificationContext({
 						storyKey,
 						workingDir: projectRoot ?? process.cwd(),
 						reviewResult: latestReviewSignals,
 						storyContent: storyContentForVerification,
 						devStoryResult: devStorySignals,
-						outputTokenCount: devOutputTokenCount
+						outputTokenCount: devOutputTokenCount,
+						sourceEpicContent
 					});
 					const verifSummary = await verificationPipeline.run(verifContext, "A");
 					verificationStore.set(storyKey, verifSummary);
-					persistVerificationResult(storyKey, verifSummary, runManifest);
+					await persistVerificationResult(storyKey, verifSummary, runManifest);
 					if (verifSummary.status === "fail") {
 						updateStory(storyKey, {
 							phase: "VERIFICATION_FAILED",
@@ -13301,6 +13297,12 @@ function createImplementationOrchestrator(deps) {
 					phase: "COMPLETE",
 					completedAt: new Date().toISOString()
 				});
+				if (config.skipVerification !== true && runManifest != null) Promise.resolve().then(() => runManifest.read()).then((manifest) => {
+					if (manifest?.per_story_state?.[storyKey]?.verification_result == null) logger$24.warn({
+						storyKey,
+						category: "verification-result-missing"
+					}, "post-COMPLETE invariant: verification_result absent in manifest");
+				}).catch(() => {});
 				const completedReviewCycles = reviewCycles + 1;
 				await writeStoryMetricsBestEffort(storyKey, verdict, completedReviewCycles);
 				await writeStoryOutcomeBestEffort(storyKey, "complete", completedReviewCycles);
@@ -13530,17 +13532,25 @@ function createImplementationOrchestrator(deps) {
 						error: reviewResult.error,
 						rawOutput: reviewResult.rawOutput
 					} : void 0;
+					let sourceEpicContent2;
+					const epicsPath2 = findEpicsFile(projectRoot ?? process.cwd());
+					if (epicsPath2) try {
+						const epicFull2 = readFileSync(epicsPath2, "utf-8");
+						const section2 = extractStorySection(epicFull2, storyKey);
+						if (section2) sourceEpicContent2 = section2;
+					} catch {}
 					const verifContext = assembleVerificationContext({
 						storyKey,
 						workingDir: projectRoot ?? process.cwd(),
 						reviewResult: latestReviewSignals,
 						storyContent: storyContentForVerification,
 						devStoryResult: devStorySignals,
-						outputTokenCount: devOutputTokenCount
+						outputTokenCount: devOutputTokenCount,
+						sourceEpicContent: sourceEpicContent2
 					});
 					const verifSummary = await verificationPipeline.run(verifContext, "A");
 					verificationStore.set(storyKey, verifSummary);
-					persistVerificationResult(storyKey, verifSummary, runManifest);
+					await persistVerificationResult(storyKey, verifSummary, runManifest);
 					if (verifSummary.status === "fail") {
 						updateStory(storyKey, {
 							phase: "VERIFICATION_FAILED",
@@ -13568,6 +13578,12 @@ function createImplementationOrchestrator(deps) {
 					reviewCycles: finalReviewCycles,
 					completedAt: new Date().toISOString()
 				});
+				if (config.skipVerification !== true && runManifest != null) Promise.resolve().then(() => runManifest.read()).then((manifest) => {
+					if (manifest?.per_story_state?.[storyKey]?.verification_result == null) logger$24.warn({
+						storyKey,
+						category: "verification-result-missing"
+					}, "post-COMPLETE invariant: verification_result absent in manifest");
+				}).catch(() => {});
 				await writeStoryMetricsBestEffort(storyKey, verdict, finalReviewCycles);
 				await writeStoryOutcomeBestEffort(storyKey, "complete", finalReviewCycles);
 				eventBus.emit("orchestrator:story-complete", {
@@ -18477,7 +18493,8 @@ async function buildRunReportFromManifest(runId, runsDir, adapter, opts) {
 				...vr !== void 0 && {
 					verificationStatus: vr.status,
 					verificationChecks: vr.checks
-				}
+				},
+				verification_ran: state.verification_result !== void 0 && state.verification_result !== null
 			});
 		}
 		const escalationFindings = Object.values(escalationDiagnoses).map((d) => d.finding);
@@ -18608,6 +18625,7 @@ async function buildRunReport(adapter, runId, opts) {
 				verificationStatus: vr.status,
 				verificationChecks: vr.checks
 			},
+			verification_ran: vr !== void 0,
 			...qualityScore !== void 0 && { qualityScore },
 			...s$1.primary_agent_id && { agentId: s$1.primary_agent_id },
 			...s$1.primary_model && { model: s$1.primary_model },
@@ -43840,4 +43858,4 @@ function registerRunCommand(program, _version = "0.0.0", projectRoot = process.c
 
 //#endregion
 export { AdapterTelemetryPersistence, AppError, DoltRepoMapMetaRepository, DoltSymbolRepository, ERR_REPO_MAP_STORAGE_WRITE, EpicIngester, GitClient, GrammarLoader, RepoMapInjector, RepoMapModule, RepoMapQueryEngine, RepoMapStorage, SymbolParser, createContextCompiler, createDispatcher, createEventEmitter, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStopAfterGate, createTelemetryAdvisor, formatPhaseCompletionSummary, getFactoryRunSummaries, getScenarioResultsForRun, getTwinRunsForRun, listGraphRuns, normalizeGraphSummaryToStatus, registerExportCommand, registerFactoryCommand, registerRunCommand, registerScenariosCommand, resolveMaxReviewCycles, resolveStoryKeys, runAnalysisPhase, runPlanningPhase, runRunAction, runSolutioningPhase, validateStopAfterFromConflict, wireNdjsonEmitter };
-//# sourceMappingURL=run-Bz3dW9Wn.js.map
+//# sourceMappingURL=run-B6qbsy-F.js.map

package/dist/{run-C3kaptjF.js → run-DEyd1p7U.js}

@@ -1,8 +1,8 @@
-import "./health-DXW-E2vb.js";
+import "./health-0jqPFBEL.js";
 import "./logger-KeHncl-f.js";
 import "./helpers-CElYrONe.js";
 import "./dist-CqtWS9wF.js";
-import { normalizeGraphSummaryToStatus, registerRunCommand, resolveMaxReviewCycles, runRunAction, wireNdjsonEmitter } from "./run-Bz3dW9Wn.js";
+import { normalizeGraphSummaryToStatus, registerRunCommand, resolveMaxReviewCycles, runRunAction, wireNdjsonEmitter } from "./run-B6qbsy-F.js";
 import "./routing-CcBOCuC9.js";
 import "./decisions-C0pz9Clx.js";
 

package/package.json

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

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

@@ -32,15 +32,16 @@ a different story from the epic scope. The story key, title, and core scope are
 ## Instructions
 
 1. **Use the Story Definition as your primary input** — it specifies exactly what this story builds. The epic scope provides surrounding context only.
-2. **Apply architecture constraints** — every constraint listed above is mandatory (file paths, import style, test framework, etc.)
-3. **Use previous dev notes** as guardrails — don't repeat mistakes, build on patterns that worked
-4. **Fill out the story template** with:
+2. **Acceptance-criteria text from the Story Definition is read-only input.** Any AC clause from the source that contains `MUST`, `MUST NOT`, `SHALL`, `SHALL NOT`, enumerated file or directory paths, or explicit technology / storage / data-format choices (e.g., "plain JSON file", "LanceDB table", "systemd unit") must appear in the rendered story artifact's Acceptance Criteria section **verbatim**. Never soften, abstract, or paraphrase a hard clause — reshaping "MUST remove X" into "consider deprecating X" silently strips the requirement and ships code that violates its own spec. When in doubt, copy the source clause literally and add any clarifying BDD phrasing alongside it, not in place of it.
+3. **Apply architecture constraints** — every constraint listed above is mandatory (file paths, import style, test framework, etc.)
+4. **Use previous dev notes** as guardrails — don't repeat mistakes, build on patterns that worked
+5. **Fill out the story template** with:
    - A clear user story (As a / I want / So that)
-   - Acceptance criteria in BDD Given/When/Then format (minimum 3, maximum 8)
+   - Acceptance criteria: preserve the hard-clause text from the Story Definition verbatim. BDD Given/When/Then phrasing is **optional** — permitted for behavior-oriented criteria where it adds clarity, not mandatory. Never let BDD reshape a MUST / MUST NOT / SHALL clause; copy those clauses literally and, if BDD adds clarity, append the Given/When/Then alongside the original clause rather than replacing it. Aim for the same number of ACs as the source — do not condense clauses into fewer items to hit a target count.
    - Concrete tasks broken into 2–4 hour subtasks, each tied to specific ACs
    - Dev Notes with file paths, import patterns, testing requirements
-5. **Apply the scope cap** — see Scope Cap Guidance below
-6. **Write the story file** to: `_bmad-output/implementation-artifacts/{{story_key}}-<kebab-title>.md`
+6. **Apply the scope cap** — see Scope Cap Guidance below
+7. **Write the story file** to: `_bmad-output/implementation-artifacts/{{story_key}}-<kebab-title>.md`
    - Do NOT add a `Status:` field to the story file — story status is managed exclusively by the Dolt work graph (`wg_stories` table)
    - Dev Agent Record section must be present but left blank (to be filled by dev agent)
 
@@ -66,7 +67,9 @@ Use this exact format for each item:
 
 ## Runtime Verification Guidance
 
-**Decide whether this story's artifact is runtime-dependent.** An artifact is runtime-dependent if correctness depends on execution — systemd units, container definitions (Podman Quadlet, Docker Compose), install scripts, migration runners, anything whose behavior is only observable by running it against a real host or ephemeral sandbox.
+**If the Story Definition already contains a `## Runtime Probes` section, transfer it verbatim** — including every probe entry, YAML fenced block, and surrounding prose — into the rendered story artifact. Do not independently re-evaluate whether the story is runtime-dependent; the epic author already decided when they authored probes in the source. Adding, removing, renaming, or reshaping a source-declared probe silently subverts the author's runtime contract.
+
+**If the Story Definition has no `## Runtime Probes` section, decide whether this story's artifact is runtime-dependent.** An artifact is runtime-dependent if correctness depends on execution — systemd units, container definitions (Podman Quadlet, Docker Compose), install scripts, migration runners, anything whose behavior is only observable by running it against a real host or ephemeral sandbox.
 
 If the artifact is runtime-dependent, add a `## Runtime Probes` section to the story file. Each probe is a short shell command whose exit status answers "does this artifact actually work?".
 
@@ -156,11 +159,13 @@ Treat the probes you draft as a **first pass** the human author will refine. Pro
 
 ## Scope Cap Guidance
 
-**Aim for 6-7 acceptance criteria and 7-8 tasks per story.**
+**Aim for 6-7 acceptance criteria and 7-8 tasks per story** when you are authoring ACs from scratch.
 
 Each story will be implemented by an AI agent in a single pass. Stories with more than 7 ACs tend to exceed agent capabilities and require decomposition, adding latency and complexity to the pipeline.
 
-If the scope requires more than 7 ACs, split into multiple sequential stories (e.g., `7-1a: Core Setup`, `7-1b: Advanced Features`). Splitting is preferable to cramming too much scope into a single story.
+**The scope cap does NOT license condensing source ACs.** If the Story Definition supplies more ACs than the guidance target, preserve them all verbatim — never collapse hard clauses (MUST / MUST NOT / SHALL / enumerated paths) into fewer items just to hit a count. If the source scope is too large for a single story, surface that as a failure (`result: failure`, `error: source scope exceeds single-story capacity — split upstream`) rather than silently dropping ACs.
+
+If the scope *you are authoring from scratch* requires more than 7 ACs, split into multiple sequential stories (e.g., `7-1a: Core Setup`, `7-1b: Advanced Features`). Splitting is preferable to cramming too much scope into a single story.
 
 This is guidance, not enforcement — if the scope genuinely fits in a slightly larger story, use your judgment. The goal is to avoid stories that will predictably fail during implementation.