substrate-ai 0.20.7 → 0.20.10

package/dist/adapter-registry-N0Klnk7Y.js

@@ -0,0 +1,4 @@
+import { AdapterRegistry } from "./dist-CqtWS9wF.js";
+import "./adapter-registry-DXLMTmfD.js";
+
+export { AdapterRegistry };

package/dist/cli/index.js

@@ -1,15 +1,15 @@
 #!/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-BIS34IYK.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-C6Up5GCr.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-srr3BfCc.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-BAc1zfMQ.js";
-import "../errors-CSTQNabo.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-BcwaSYTg.js";
+import "../errors-1uLGqnvr.js";
 import "../routing-CcBOCuC9.js";
 import "../decisions-C0pz9Clx.js";
 import "../version-manager-impl-BmOWu8ml.js";
-import { registerUpgradeCommand } from "../upgrade-iTr8nbbE.js";
+import { registerUpgradeCommand } from "../upgrade-k15NGTno.js";
 import { Command } from "commander";
 import { fileURLToPath } from "url";
 import { dirname, join, resolve } from "path";
@@ -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-3-qy8XEI.js");
+			const { inspectProcessTree: inspectProcessTree$1 } = await import("../health-C73H5CUZ.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;
@@ -4615,7 +4617,7 @@ function defaultSupervisorDeps() {
 				if (cached === null) {
 					const { AdapterRegistry: AR } = await import(
 						/* @vite-ignore */
-						"../adapter-registry-CwjKI1sO.js"
+						"../adapter-registry-N0Klnk7Y.js"
 );
 					cached = new AR();
 					await cached.discoverAndRegister();
@@ -5182,11 +5184,11 @@ async function runSupervisorAction(options, deps = {}) {
 						try {
 							const { createExperimenter } = await import(
 								/* @vite-ignore */
-								"../experimenter-DaXUHfJO.js"
+								"../experimenter-VEJHtfLh.js"
 );
 							const { getLatestRun: getLatest } = await import(
 								/* @vite-ignore */
-								"../decisions-Ca77UwMA.js"
+								"../decisions-7UJcRETq.js"
 );
 							const expAdapter = createDatabaseAdapter({
 								backend: "auto",
@@ -5196,7 +5198,7 @@ async function runSupervisorAction(options, deps = {}) {
 								await initSchema(expAdapter);
 								const { runRunAction: runPipeline } = await import(
 									/* @vite-ignore */
-									"../run-Dif8PJRd.js"
+									"../run-CvCQpsy0.js"
 );
 								const runStoryFn = async (opts) => {
 									const exitCode = await runPipeline({
@@ -5728,7 +5730,7 @@ async function runMetricsAction(options) {
 			const routingConfigPath = join(dbDir, "routing.yml");
 			let routingConfig = null;
 			if (existsSync$1(routingConfigPath)) try {
-				const { loadModelRoutingConfig } = await import("../routing-BX6ObE8S.js");
+				const { loadModelRoutingConfig } = await import("../routing-Ccpb_syA.js");
 				routingConfig = loadModelRoutingConfig(routingConfigPath);
 			} catch {}
 			if (routingConfig === null) routingConfig = {
@@ -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,
@@ -8995,8 +9003,8 @@ async function createProgram() {
 /** Fire-and-forget startup version check (story 8.3, AC3/AC5) */
 function checkForUpdatesInBackground(currentVersion) {
 	if (process.env.SUBSTRATE_NO_UPDATE_CHECK === "1") return;
-	import("../upgrade-Cm8B3cXL.js").then(async () => {
-		const { createVersionManager } = await import("../version-manager-impl-XiJHzIbR.js");
+	import("../upgrade-CVaD7iUR.js").then(async () => {
+		const { createVersionManager } = await import("../version-manager-impl-CEiZEsmi.js");
 		const vm = createVersionManager();
 		const result = await vm.checkForUpdates();
 		if (result.updateAvailable) {

package/dist/{decisions-Ca77UwMA.js → decisions-7UJcRETq.js}

@@ -1,4 +1,4 @@
-import { addTokenUsage, createDecision, createPipelineRun, createRequirement, getArtifactByTypeForRun, getArtifactsByRun, getDecisionsByCategory, getDecisionsByPhase, getDecisionsByPhaseForRun, getLatestRun, getPipelineRunById, getRunningPipelineRuns, getTokenUsageSummary, listRequirements, registerArtifact, updateDecision, updatePipelineRun, updatePipelineRunConfig, upsertDecision } from "./dist-srr3BfCc.js";
+import { addTokenUsage, createDecision, createPipelineRun, createRequirement, getArtifactByTypeForRun, getArtifactsByRun, getDecisionsByCategory, getDecisionsByPhase, getDecisionsByPhaseForRun, getLatestRun, getPipelineRunById, getRunningPipelineRuns, getTokenUsageSummary, listRequirements, registerArtifact, updateDecision, updatePipelineRun, updatePipelineRunConfig, upsertDecision } from "./dist-CqtWS9wF.js";
 import "./decisions-C0pz9Clx.js";
 
 export { getLatestRun };

package/dist/{dist-srr3BfCc.js → dist-CqtWS9wF.js}

@@ -4044,15 +4044,27 @@ async function aggregateTokenUsageForStory(adapter, runId, storyKey) {
 //#endregion
 //#region packages/core/dist/persistence/queries/retry-escalated.js
 /**
+* Pipeline-run statuses that make escalation-diagnosis decisions non-actionable.
+* Runs in these states are terminated (abandoned / stopped manually) and their
+* per-story escalations are historical noise — the work either shipped in a
+* later run or was never going to be retried in this run's lifetime.
+*/
+const TERMINAL_RUN_STATUSES = ["failed", "stopped"];
+/**
 * Query the decision store for escalation-diagnosis decisions and classify
 * each story key as retryable or skipped.
 *
 * Key format in the DB: `{storyKey}:{runId}`
 *
+* Scoping:
 * - When `runId` is provided, only decisions whose key contains that runId
-*   are considered (AC5 scoping).
-* - When `runId` is omitted, the runId of the last (most recently created)
-*   escalation-diagnosis decision is used as the default (AC1 defaulting).
+*   are considered (AC5). The caller is explicit; no status filter is applied
+*   so a user can still inspect diagnoses from a terminal run by naming it.
+* - When `runId` is omitted, the latest run whose `pipeline_runs.status` is
+*   NOT terminal (`failed` / `stopped`) is used. Terminal runs are abandoned
+*   or manually stopped — their per-story diagnoses are historical noise and
+*   would generate false-positive retry proposals for work that either
+*   shipped in a later run or will never be retried in that run's lifetime.
 *
 * @param adapter  The database adapter
 * @param runId    Optional run ID to scope the query
@@ -4083,7 +4095,13 @@ async function getRetryableEscalations(adapter, runId) {
 		});
 	}
 	if (parsed.length === 0) return result;
-	const effectiveRunId = runId ?? parsed[parsed.length - 1].decisionRunId;
+	let effectiveRunId;
+	if (runId !== void 0) effectiveRunId = runId;
+	else {
+		const candidateRunId = await pickLatestNonTerminalRunId(adapter, parsed);
+		if (candidateRunId === void 0) return result;
+		effectiveRunId = candidateRunId;
+	}
 	const lastEntryByKey = new Map();
 	for (const entry of parsed) {
 		if (entry.decisionRunId !== effectiveRunId) continue;
@@ -4103,6 +4121,34 @@ async function getRetryableEscalations(adapter, runId) {
 	}
 	return result;
 }
+/**
+* Walk the parsed decision list newest-last (as supplied), map distinct runIds
+* to their pipeline-run status, and return the runId of the newest decision
+* whose run is NOT in a terminal status.
+*
+* Returns `undefined` when every referenced run is terminal or missing —
+* signalling "nothing retryable" to the caller.
+*
+* The adapter query is a single SELECT against `pipeline_runs` restricted to
+* the distinct runIds we actually care about; keeps the cost O(unique-runs)
+* rather than O(decisions).
+*/
+async function pickLatestNonTerminalRunId(adapter, parsed) {
+	const uniqueRunIds = Array.from(new Set(parsed.map((p) => p.decisionRunId)));
+	if (uniqueRunIds.length === 0) return void 0;
+	const statusByRunId = new Map();
+	for (const id of uniqueRunIds) {
+		const rows = await adapter.query("SELECT id, status FROM pipeline_runs WHERE id = ?", [id]);
+		if (rows.length > 0 && rows[0]) statusByRunId.set(rows[0].id, rows[0].status);
+	}
+	for (let i = parsed.length - 1; i >= 0; i -= 1) {
+		const entry = parsed[i];
+		const status = statusByRunId.get(entry.decisionRunId);
+		if (status !== void 0 && TERMINAL_RUN_STATUSES.includes(status)) continue;
+		return entry.decisionRunId;
+	}
+	return void 0;
+}
 
 //#endregion
 //#region packages/core/dist/persistence/monitor-database.js
@@ -10894,4 +10940,4 @@ async function callLLM(params) {
 
 //#endregion
 export { ADVISORY_NOTES, AdapterRegistry, AdtError, BudgetConfigSchema, CURRENT_CONFIG_FORMAT_VERSION, CURRENT_TASK_GRAPH_VERSION, Categorizer, ClaudeCodeAdapter, CodexCLIAdapter, ConfigError, ConfigIncompatibleFormatError, ConsumerAnalyzer, CostTrackerConfigSchema, DEFAULT_CONFIG, DEFAULT_GLOBAL_SETTINGS, DispatcherImpl, DoltClient, DoltNotInstalled, DoltQueryError, ESCALATION_DIAGNOSIS, EXPERIMENT_RESULT, EfficiencyScorer, GeminiCLIAdapter, GlobalSettingsSchema, IngestionServer, LEARNING_FINDING, LogTurnAnalyzer, ModelRoutingConfigSchema, MonitorDatabaseImpl, OPERATIONAL_FINDING, PartialGlobalSettingsSchema, PartialProviderConfigSchema, ProviderPolicySchema, ProvidersSchema, Recommender, RoutingConfigError, RoutingRecommender, RoutingResolver, RoutingTelemetry, RoutingTokenAccumulator, RoutingTuner, STORY_METRICS, STORY_OUTCOME, SubstrateConfigSchema, TASK_TYPE_PHASE_MAP, TEST_EXPANSION_FINDING, TEST_PLAN, TelemetryConfigSchema, TelemetryNormalizer, TelemetryPipeline, TurnAnalyzer, VersionManagerImpl, addTokenUsage, aggregateTokenUsageForRun, aggregateTokenUsageForStory, buildAuditLogEntry, buildBranchName, buildModificationDirective, buildPRBody, buildWorktreePath, callLLM, checkDoltInstalled, compareRunMetrics, createAmendmentRun, createConfigSystem, createDatabaseAdapter as createDatabaseAdapter$1, createDecision, createDoltClient, createExperimenter, createPipelineRun, createRequirement, createVersionManager, detectInterfaceChanges, determineVerdict, getActiveDecisions, getAllCostEntriesFiltered, getArtifactByTypeForRun, getArtifactsByRun, getBaselineRunMetrics, getDecisionsByCategory, getDecisionsByPhase, getDecisionsByPhaseForRun, getLatestCompletedRun, getLatestRun, getModelTier, getPipelineRunById, getPlanningCostTotal, getRetryableEscalations, getRunMetrics, getRunningPipelineRuns, getSessionCostSummary, getSessionCostSummaryFiltered, getStoryMetricsForRun, getTokenUsageSummary, incrementRunRestarts, initSchema, initializeDolt, listRequirements, listRunMetrics, loadModelRoutingConfig, loadParentRunDecisions, registerArtifact, resolvePromptFile, supersedeDecision, tagRunAsBaseline, updateDecision, updatePipelineRun, updatePipelineRunConfig, upsertDecision, writeRunMetrics, writeStoryMetrics };
-//# sourceMappingURL=dist-srr3BfCc.js.map
+//# sourceMappingURL=dist-CqtWS9wF.js.map

package/dist/{errors-CSTQNabo.js → errors-1uLGqnvr.js}

@@ -1,4 +1,4 @@
-import { AdtError } from "./dist-srr3BfCc.js";
+import { AdtError } from "./dist-CqtWS9wF.js";
 
 //#region src/core/errors.ts
 /** Error thrown when task configuration is invalid */
@@ -71,4 +71,4 @@ var TaskGraphIncompatibleFormatError = class extends AdtError {
 
 //#endregion
 export { BudgetExceededError, GitError, RecoveryError, TaskConfigError, TaskGraphCycleError, TaskGraphError, TaskGraphIncompatibleFormatError, WorkerError, WorkerNotFoundError };
-//# sourceMappingURL=errors-CSTQNabo.js.map
+//# sourceMappingURL=errors-1uLGqnvr.js.map

package/dist/{experimenter-DaXUHfJO.js → experimenter-VEJHtfLh.js}

@@ -1,3 +1,3 @@
-import { buildAuditLogEntry, buildBranchName, buildModificationDirective, buildPRBody, buildWorktreePath, createExperimenter, determineVerdict, resolvePromptFile } from "./dist-srr3BfCc.js";
+import { buildAuditLogEntry, buildBranchName, buildModificationDirective, buildPRBody, buildWorktreePath, createExperimenter, determineVerdict, resolvePromptFile } from "./dist-CqtWS9wF.js";
 
 export { createExperimenter };

package/dist/{health-BIS34IYK.js → health-C6Up5GCr.js}

@@ -1,5 +1,5 @@
 import { createLogger } from "./logger-KeHncl-f.js";
-import { DoltClient, DoltQueryError, LEARNING_FINDING, createDatabaseAdapter$1 as createDatabaseAdapter, createDecision, getDecisionsByCategory, getLatestRun, getPipelineRunById, initSchema } from "./dist-srr3BfCc.js";
+import { DoltClient, DoltQueryError, LEARNING_FINDING, createDatabaseAdapter$1 as createDatabaseAdapter, createDecision, getDecisionsByCategory, getLatestRun, getPipelineRunById, initSchema } from "./dist-CqtWS9wF.js";
 import { createRequire } from "module";
 import { dirname, join } from "path";
 import { readFile } from "fs/promises";
@@ -4185,6 +4185,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 +4236,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 +4261,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 +4287,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 +4309,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 +4335,7 @@ var RunManifest = class RunManifest {
 				created_at: now
 			};
 		}
-		await this.write({
+		await this._writeImpl({
 			...existingData,
 			cli_flags: {
 				...existingData.cli_flags,
@@ -4319,21 +4344,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 +4389,7 @@ var RunManifest = class RunManifest {
 			...existing,
 			...updates
 		};
-		await this.write({
+		await this._writeImpl({
 			...existingData,
 			per_story_state: {
 				...existingData.per_story_state,
@@ -4374,22 +4398,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 +4455,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 +5336,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-BIS34IYK.js.map
+//# sourceMappingURL=health-C6Up5GCr.js.map

package/dist/{health-3-qy8XEI.js → health-C73H5CUZ.js}

@@ -1,6 +1,6 @@
-import { DEFAULT_STALL_THRESHOLD_SECONDS, getAllDescendantPids, getAutoHealthData, inspectProcessTree, isOrchestratorProcessLine, registerHealthCommand, runHealthAction } from "./health-BIS34IYK.js";
+import { DEFAULT_STALL_THRESHOLD_SECONDS, getAllDescendantPids, getAutoHealthData, inspectProcessTree, isOrchestratorProcessLine, registerHealthCommand, runHealthAction } from "./health-C6Up5GCr.js";
 import "./logger-KeHncl-f.js";
-import "./dist-srr3BfCc.js";
+import "./dist-CqtWS9wF.js";
 import "./decisions-C0pz9Clx.js";
 
 export { inspectProcessTree };

package/dist/index.js

@@ -1,8 +1,8 @@
 import { childLogger, createLogger, logger } from "./logger-KeHncl-f.js";
 import { assertDefined, createEventBus, createTuiApp, deepClone, formatDuration, generateId, isPlainObject, isTuiCapable, printNonTtyWarning, sleep, withRetry } from "./helpers-CElYrONe.js";
-import { AdapterRegistry, AdtError, ClaudeCodeAdapter, CodexCLIAdapter, ConfigError, ConfigIncompatibleFormatError, GeminiCLIAdapter } from "./dist-srr3BfCc.js";
+import { AdapterRegistry, AdtError, ClaudeCodeAdapter, CodexCLIAdapter, ConfigError, ConfigIncompatibleFormatError, GeminiCLIAdapter } from "./dist-CqtWS9wF.js";
 import "./adapter-registry-DXLMTmfD.js";
-import { BudgetExceededError, GitError, RecoveryError, TaskConfigError, TaskGraphCycleError, TaskGraphError, TaskGraphIncompatibleFormatError, WorkerError, WorkerNotFoundError } from "./errors-CSTQNabo.js";
+import { BudgetExceededError, GitError, RecoveryError, TaskConfigError, TaskGraphCycleError, TaskGraphError, TaskGraphIncompatibleFormatError, WorkerError, WorkerNotFoundError } from "./errors-1uLGqnvr.js";
 
 //#region src/core/di.ts
 /**

package/dist/{routing-BX6ObE8S.js → routing-Ccpb_syA.js}

@@ -1,4 +1,4 @@
-import { ModelRoutingConfigSchema, ProviderPolicySchema, RoutingConfigError, RoutingRecommender, RoutingResolver, RoutingTelemetry, RoutingTokenAccumulator, RoutingTuner, TASK_TYPE_PHASE_MAP, getModelTier, loadModelRoutingConfig } from "./dist-srr3BfCc.js";
+import { ModelRoutingConfigSchema, ProviderPolicySchema, RoutingConfigError, RoutingRecommender, RoutingResolver, RoutingTelemetry, RoutingTokenAccumulator, RoutingTuner, TASK_TYPE_PHASE_MAP, getModelTier, loadModelRoutingConfig } from "./dist-CqtWS9wF.js";
 import "./routing-CcBOCuC9.js";
 
 export { loadModelRoutingConfig };

package/dist/{run-BAc1zfMQ.js → run-BcwaSYTg.js}

@@ -1,7 +1,7 @@
-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-BIS34IYK.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-C6Up5GCr.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-srr3BfCc.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";
 import { basename, dirname, extname, join } from "path";
 import { access, readFile, readdir, stat } from "fs/promises";
 import { EventEmitter } from "node:events";
@@ -10462,20 +10462,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 +12075,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 +12255,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 +12414,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 +12469,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 +13138,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) {
@@ -13282,7 +13268,7 @@ function createImplementationOrchestrator(deps) {
 					});
 					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 +13287,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);
@@ -13540,7 +13532,7 @@ function createImplementationOrchestrator(deps) {
 					});
 					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 +13560,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 +18475,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 +18607,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 +43840,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-BAc1zfMQ.js.map
+//# sourceMappingURL=run-BcwaSYTg.js.map

package/dist/{run-Dif8PJRd.js → run-CvCQpsy0.js}

@@ -1,8 +1,8 @@
-import "./health-BIS34IYK.js";
+import "./health-C6Up5GCr.js";
 import "./logger-KeHncl-f.js";
 import "./helpers-CElYrONe.js";
-import "./dist-srr3BfCc.js";
-import { normalizeGraphSummaryToStatus, registerRunCommand, resolveMaxReviewCycles, runRunAction, wireNdjsonEmitter } from "./run-BAc1zfMQ.js";
+import "./dist-CqtWS9wF.js";
+import { normalizeGraphSummaryToStatus, registerRunCommand, resolveMaxReviewCycles, runRunAction, wireNdjsonEmitter } from "./run-BcwaSYTg.js";
 import "./routing-CcBOCuC9.js";
 import "./decisions-C0pz9Clx.js";
 

package/dist/{upgrade-Cm8B3cXL.js → upgrade-CVaD7iUR.js}

@@ -1,5 +1,5 @@
-import "./dist-srr3BfCc.js";
+import "./dist-CqtWS9wF.js";
 import "./version-manager-impl-BmOWu8ml.js";
-import { isGlobalInstall, registerUpgradeCommand, runUpgradeCommand } from "./upgrade-iTr8nbbE.js";
+import { isGlobalInstall, registerUpgradeCommand, runUpgradeCommand } from "./upgrade-k15NGTno.js";
 
 export { isGlobalInstall, registerUpgradeCommand, runUpgradeCommand };

package/dist/{upgrade-iTr8nbbE.js → upgrade-k15NGTno.js}

@@ -1,4 +1,4 @@
-import { createVersionManager } from "./dist-srr3BfCc.js";
+import { createVersionManager } from "./dist-CqtWS9wF.js";
 import { execSync, spawn } from "child_process";
 import * as readline from "readline";
 
@@ -123,4 +123,4 @@ function registerUpgradeCommand(program) {
 
 //#endregion
 export { isGlobalInstall, registerUpgradeCommand, runUpgradeCommand };
-//# sourceMappingURL=upgrade-iTr8nbbE.js.map
+//# sourceMappingURL=upgrade-k15NGTno.js.map

package/dist/{version-manager-impl-XiJHzIbR.js → version-manager-impl-CEiZEsmi.js}

@@ -1,4 +1,4 @@
-import { VersionManagerImpl, createVersionManager } from "./dist-srr3BfCc.js";
+import { VersionManagerImpl, createVersionManager } from "./dist-CqtWS9wF.js";
 import "./version-manager-impl-BmOWu8ml.js";
 
 export { createVersionManager };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "substrate-ai",
-  "version": "0.20.7",
+  "version": "0.20.10",
   "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.
 

package/dist/adapter-registry-CwjKI1sO.js

@@ -1,4 +0,0 @@
-import { AdapterRegistry } from "./dist-srr3BfCc.js";
-import "./adapter-registry-DXLMTmfD.js";
-
-export { AdapterRegistry };