substrate-ai 0.20.19 → 0.20.21

package/dist/cli/index.js

@@ -4,7 +4,7 @@ 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-2nI3qh0-.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-DrJWCS63.js";
 import "../errors-1uLGqnvr.js";
 import "../routing-CcBOCuC9.js";
 import "../decisions-C0pz9Clx.js";
@@ -5198,7 +5198,7 @@ async function runSupervisorAction(options, deps = {}) {
 								await initSchema(expAdapter);
 								const { runRunAction: runPipeline } = await import(
 									/* @vite-ignore */
-									"../run-BNCfGm5V.js"
+									"../run-C46Xfny6.js"
 );
 								const runStoryFn = async (opts) => {
 									const exitCode = await runPipeline({

package/dist/{run-BNCfGm5V.js → run-C46Xfny6.js}

@@ -2,7 +2,7 @@ import "./health-ZGa9E0D2.js";
 import "./logger-KeHncl-f.js";
 import "./helpers-CElYrONe.js";
 import "./dist-CqtWS9wF.js";
-import { normalizeGraphSummaryToStatus, registerRunCommand, resolveMaxReviewCycles, runRunAction, wireNdjsonEmitter } from "./run-2nI3qh0-.js";
+import { normalizeGraphSummaryToStatus, registerRunCommand, resolveMaxReviewCycles, runRunAction, wireNdjsonEmitter } from "./run-DrJWCS63.js";
 import "./routing-CcBOCuC9.js";
 import "./decisions-C0pz9Clx.js";
 

package/dist/{run-2nI3qh0-.js → run-DrJWCS63.js}

@@ -5708,7 +5708,7 @@ function hashSourceAcSection(section) {
 * @returns Promise resolving to CreateStoryResult
 */
 async function runCreateStory(deps, params) {
-	const { epicId, storyKey, pipelineRunId, source_ac_hash } = params;
+	const { epicId, storyKey, pipelineRunId, source_ac_hash, priorDriftFeedback } = params;
 	logger$18.debug({
 		epicId,
 		storyKey,
@@ -5797,7 +5797,16 @@ async function runCreateStory(deps, params) {
 			name: "source_ac_hash",
 			content: effectiveSourceAcHash,
 			priority: "required"
-		}] : []
+		}] : [],
+		...priorDriftFeedback !== void 0 && priorDriftFeedback.length > 0 ? [{
+			name: "prior_drift_feedback",
+			content: priorDriftFeedback,
+			priority: "required"
+		}] : [{
+			name: "prior_drift_feedback",
+			content: "",
+			priority: "optional"
+		}]
 	], TOKEN_CEILING);
 	logger$18.debug({
 		tokenCount,
@@ -5958,6 +5967,70 @@ function extractStorySection(shardContent, storyKey) {
 	return section.length > 0 ? section : null;
 }
 /**
+* Story 59-3: extract the list of named filesystem paths and filenames from
+* source AC text. Looks for backtick-wrapped strings that contain a path
+* separator OR end with a recognized source-file extension. The result is
+* a deduped list of names the source AC declares as part of the story's
+* artifact contract.
+*
+* Used by the orchestrator's pre-dev fidelity gate to detect create-story
+* output drift: if the agent produced a story file that doesn't reference
+* the source AC's named files (`adjacency-store.ts`, `wikilink-parser.ts`,
+* etc.) the gate fires and the orchestrator renames-to-stale + retries.
+*
+* Heuristic chosen over LLM-based fidelity check because deterministic,
+* fast, and the LLM-based source-ac-fidelity check still runs at
+* verification phase as a backstop for nuanced drift this gate can't see.
+*/
+function extractNamedPathsFromSource(shardContent) {
+	const paths = new Set();
+	const backtickPattern = /`([^`\n]+)`/g;
+	const extensionPattern = /\.(ts|tsx|js|jsx|mjs|cjs|py|go|rs|md|json|sql|sh|toml|yaml|yml|html|css|scss|svelte)$/i;
+	let match$2;
+	while ((match$2 = backtickPattern.exec(shardContent)) !== null) {
+		const candidate = match$2[1]?.trim();
+		if (candidate === void 0 || candidate.length === 0) continue;
+		if (candidate.includes(" ")) continue;
+		if (!candidate.includes("/") && !extensionPattern.test(candidate)) continue;
+		paths.add(candidate);
+	}
+	return Array.from(paths);
+}
+/**
+* Story 59-3: compute fidelity between a generated story file and the
+* named paths in the source AC. Drift is the fraction of source-AC paths
+* that do NOT appear anywhere in the story file content.
+*
+* Substring-match (not exact) — a source AC path
+* `packages/memory/src/graph/adjacency-store.ts` matches a story-file
+* mention of just the basename `adjacency-store.ts`. This is intentional:
+* stories sometimes shorten paths in prose while still preserving the
+* named file. Full-path or basename — both count as present. The drift
+* case we're catching (Run 9's WikilinkResolver substituting for
+* adjacency-store) has neither full nor basename present.
+*
+* Empty namedPaths list returns drift=0 (cannot drift from nothing).
+*/
+function computeStoryFileFidelity(storyFileContent, namedPaths) {
+	if (namedPaths.length === 0) return {
+		missing: [],
+		present: [],
+		drift: 0
+	};
+	const missing = [];
+	const present = [];
+	for (const path$3 of namedPaths) {
+		const basename$2 = path$3.includes("/") ? path$3.slice(path$3.lastIndexOf("/") + 1) : path$3;
+		if (storyFileContent.includes(path$3) || storyFileContent.includes(basename$2)) present.push(path$3);
+		else missing.push(path$3);
+	}
+	return {
+		missing,
+		present,
+		drift: missing.length / namedPaths.length
+	};
+}
+/**
 * Retrieve the epic shard from the pre-fetched implementation decisions.
 *
 * Lookup order (post-37-0 schema):
@@ -8784,6 +8857,7 @@ async function seedEpicShards(db, projectRoot) {
 	}
 	const shards = parseEpicShards(content);
 	let count = 0;
+	const seenKeys = new Set();
 	for (const shard of shards) {
 		const subsections = parseStorySubsections(shard.epicId, shard.content);
 		for (const subsection of subsections) {
@@ -8794,6 +8868,15 @@ async function seedEpicShards(db, projectRoot) {
 				truncatedLength: MAX_EPIC_SHARD_CHARS,
 				droppedChars: subsection.content.length - MAX_EPIC_SHARD_CHARS
 			}, `Epic shard for ${subsection.key} exceeded ${MAX_EPIC_SHARD_CHARS}-char cap and was truncated; tail content lost from decisions store. Consider splitting the story or raising MAX_EPIC_SHARD_CHARS.`);
+			if (seenKeys.has(subsection.key)) {
+				logger$11.warn({
+					epicId: shard.epicId,
+					storyKey: subsection.key,
+					droppedContentLength: subsection.content.length
+				}, `Epic shard parser produced duplicate key '${subsection.key}' (parser regression?); skipping additional insert. First entry retained.`);
+				continue;
+			}
+			seenKeys.add(subsection.key);
 			await createDecision(db, {
 				pipeline_run_id: null,
 				phase: "implementation",
@@ -8915,9 +8998,9 @@ function parseEpicShards(content) {
 * Parse an epic section's content into per-story subsections.
 *
 * Matches story headings using three patterns:
-*   - Markdown headings: #{2,6} Story \d+[-._ ]\d+  (e.g., ### Story 37-1: Title or ### Story 1.1)
-*   - Bold:              **Story \d+[-._ ]\d+**     (e.g., **Story 37-1**)
-*   - Bare key:          \d+[-._ ]\d+:\s            (e.g., 37-1: Title — must start at line start)
+*   - Markdown headings: #{2,6} Story \d+[-._ ]\d+[a-z]*  (e.g., ### Story 37-1, ### Story 1.1, ### Story 1.11a)
+*   - Bold:              **Story \d+[-._ ]\d+[a-z]***     (e.g., **Story 37-1**)
+*   - Bare key:          \d+[-._ ]\d+[a-z]*:\s            (e.g., 37-1a: Title)
 *
 * Each subsection spans from its heading to the next matching heading or EOF.
 *
@@ -8934,16 +9017,28 @@ function parseEpicShards(content) {
 * Epic 58-5 already made `extractStorySection` separator-agnostic for the
 * same reason; this matches that precedent at the seed-time parser.
 *
-* Captured storyKey is normalized to canonical dash-form (`1.1` → `1-1`) so
-* decision keys are consistent regardless of the source heading style — a
-* `--stories 1-9` CLI invocation finds the shard whether the epic used dot,
-* dash, underscore, or space separators.
+* Story 59-2: alpha-suffix capture. BMAD-template projects subdivide stories
+* with letter suffixes (`### Story 1.11a`, `### Story 1.11b`, …) when an
+* original 1.11 ships broken and gets split for clarity. Strata's epics.md
+* uses this convention with 5 substories (1.11, 1.11a-d). 58-17's regex
+* `\d+[-._ ]\d+` truncated capture at the digit boundary, normalizing all
+* 5 to canonical key `1-11` and inserting 5 duplicate-key rows in the
+* decisions store (no UNIQUE constraint enforces uniqueness — strata
+* obs_2026-04-25_010). Trailing `[a-z]*` captures alpha suffixes of any
+* length; the `i` flag on the storyPattern (needed for `Story` heading
+* case variation) means uppercase is also accepted, so a stray `1.11A`
+* heading captures cleanly to key `1-11A` rather than truncating.
+*
+* Captured storyKey is normalized to canonical dash-form (`1.1` → `1-1`,
+* `1.11a` → `1-11a`) so decision keys are consistent regardless of the
+* source heading style. The separator-replace `[._ ] → -` does not touch
+* `[a-z]`, so trailing alpha is preserved through normalization.
 *
 * AC3: If no story headings are found, returns a single per-epic fallback entry
 * keyed by epicId — preserving backward-compatible behaviour for unstructured epics.
 */
 function parseStorySubsections(epicId, epicContent) {
-	const storyPattern = /(?:^#{2,6}\s+Story\s+(\d+[-._ ]\d+)|^\*\*Story\s+(\d+[-._ ]\d+)\*\*|^(\d+[-._ ]\d+):\s)/gim;
+	const storyPattern = /(?:^#{2,6}\s+Story\s+(\d+[-._ ]\d+[a-z]*)|^\*\*Story\s+(\d+[-._ ]\d+[a-z]*)\*\*|^(\d+[-._ ]\d+[a-z]*):\s)/gim;
 	const matches = [];
 	let match$2;
 	while ((match$2 = storyPattern.exec(epicContent)) !== null) {
@@ -11307,6 +11402,9 @@ async function autoIngestEpicsDependencies(db, projectRoot) {
 	};
 }
 const TITLE_OVERLAP_WARNING_THRESHOLD = .3;
+const FIDELITY_DRIFT_THRESHOLD = .5;
+const MIN_NAMED_PATHS_FOR_FIDELITY_GATE = 3;
+const MAX_FIDELITY_RETRIES = 2;
 /**
 * Map a terminal StoryPhase to the corresponding PerStoryStatus for run-manifest writes.
 * Returns 'dispatched' for in-progress phases (used as a safe default).
@@ -12166,66 +12264,235 @@ function createImplementationOrchestrator(deps) {
 			await persistState();
 			return;
 		}
-		if (storyFilePath === void 0) try {
-			incrementDispatches(storyKey);
-			const dispatchStartMs = Date.now();
-			const createResult = await runCreateStory({
-				db,
-				pack,
-				contextCompiler,
-				dispatcher,
-				projectRoot,
-				tokenCeilings,
-				otlpEndpoint: _otlpEndpoint,
-				agentId
-			}, {
-				epicId: storyKey.split("-")[0] ?? storyKey,
-				storyKey,
-				pipelineRunId: config.pipelineRunId,
-				source_ac_hash: sourceAcHash
-			});
-			endPhase(storyKey, "create-story");
-			eventBus.emit("orchestrator:story-phase-complete", {
-				storyKey,
-				phase: "IN_STORY_CREATION",
-				result: createResult
-			});
-			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";
-				const stderrSnippet = errMsg.includes("--- stderr ---") ? errMsg.slice(errMsg.indexOf("--- stderr ---") + 15, errMsg.indexOf("--- stderr ---") + 515) : errMsg.slice(0, 500);
-				logger$24.error({
+		let fidelityRetries = 0;
+		let priorDriftFeedback;
+		while (storyFilePath === void 0) {
+			try {
+				incrementDispatches(storyKey);
+				const dispatchStartMs = Date.now();
+				const createResult = await runCreateStory({
+					db,
+					pack,
+					contextCompiler,
+					dispatcher,
+					projectRoot,
+					tokenCeilings,
+					otlpEndpoint: _otlpEndpoint,
+					agentId
+				}, {
+					epicId: storyKey.split("-")[0] ?? storyKey,
 					storyKey,
-					stderrSnippet
-				}, `Create-story failed: ${stderrSnippet.split("\n")[0]}`);
-				updateStory(storyKey, {
-					phase: "ESCALATED",
-					error: errMsg,
-					completedAt: new Date().toISOString()
+					pipelineRunId: config.pipelineRunId,
+					source_ac_hash: sourceAcHash,
+					...priorDriftFeedback !== void 0 ? { priorDriftFeedback } : {}
 				});
-				await writeStoryMetricsBestEffort(storyKey, "failed", 0);
-				await emitEscalation({
+				endPhase(storyKey, "create-story");
+				eventBus.emit("orchestrator:story-phase-complete", {
 					storyKey,
-					lastVerdict: "create-story-failed",
-					reviewCycles: 0,
-					issues: [errMsg]
+					phase: "IN_STORY_CREATION",
+					result: createResult
 				});
+				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();
-				return;
-			}
-			if (createResult.story_file === void 0 || createResult.story_file === "") {
-				const errMsg = "create-story succeeded but returned no story_file path";
+				if (createResult.result === "failed") {
+					const errMsg = createResult.error ?? "create-story failed";
+					const stderrSnippet = errMsg.includes("--- stderr ---") ? errMsg.slice(errMsg.indexOf("--- stderr ---") + 15, errMsg.indexOf("--- stderr ---") + 515) : errMsg.slice(0, 500);
+					logger$24.error({
+						storyKey,
+						stderrSnippet
+					}, `Create-story failed: ${stderrSnippet.split("\n")[0]}`);
+					updateStory(storyKey, {
+						phase: "ESCALATED",
+						error: errMsg,
+						completedAt: new Date().toISOString()
+					});
+					await writeStoryMetricsBestEffort(storyKey, "failed", 0);
+					await emitEscalation({
+						storyKey,
+						lastVerdict: "create-story-failed",
+						reviewCycles: 0,
+						issues: [errMsg]
+					});
+					await persistState();
+					return;
+				}
+				if (createResult.story_file === void 0 || createResult.story_file === "") {
+					const errMsg = "create-story succeeded but returned no story_file path";
+					updateStory(storyKey, {
+						phase: "ESCALATED",
+						error: errMsg,
+						completedAt: new Date().toISOString()
+					});
+					await writeStoryMetricsBestEffort(storyKey, "failed", 0);
+					await emitEscalation({
+						storyKey,
+						lastVerdict: "create-story-no-file",
+						reviewCycles: 0,
+						issues: [errMsg]
+					});
+					await persistState();
+					return;
+				}
+				if (projectRoot !== void 0) {
+					const expectedArtifactsDir = join$1(projectRoot, "_bmad-output", "implementation-artifacts");
+					const escapedExpectedDir = expectedArtifactsDir.replace("/_bmad-output/", "/\\_bmad-output/");
+					let claimedPath = createResult.story_file;
+					if (claimedPath.startsWith(escapedExpectedDir)) {
+						claimedPath = claimedPath.replace("/\\_bmad-output/", "/_bmad-output/");
+						logger$24.warn({
+							storyKey,
+							originalClaim: createResult.story_file,
+							normalizedClaim: claimedPath
+						}, "create-story claimed path contains backslash-escaped underscore; normalizing");
+						eventBus.emit("orchestrator:story-warn", {
+							storyKey,
+							msg: `create-story claim path was backslash-escaped; normalized to ${claimedPath}`
+						});
+					}
+					if (claimedPath.startsWith(expectedArtifactsDir)) try {
+						let actualPath = null;
+						if (existsSync(claimedPath)) actualPath = claimedPath;
+						else {
+							const escapedVariant = claimedPath.replace("/_bmad-output/", "/\\_bmad-output/");
+							if (escapedVariant !== claimedPath && existsSync(escapedVariant)) try {
+								renameSync(escapedVariant, claimedPath);
+								actualPath = claimedPath;
+								logger$24.warn({
+									storyKey,
+									escapedVariant,
+									canonicalPath: claimedPath
+								}, "create-story wrote artifact to backslash-escaped path; moved to canonical location");
+								eventBus.emit("orchestrator:story-warn", {
+									storyKey,
+									msg: `create-story wrote to backslash-escaped path ${escapedVariant}; corrected to ${claimedPath}`
+								});
+							} catch (renameErr) {
+								actualPath = escapedVariant;
+								logger$24.warn({
+									storyKey,
+									escapedVariant,
+									canonicalPath: claimedPath,
+									err: renameErr
+								}, "create-story wrote to backslash-escaped path; rename to canonical failed; treating as success at escaped location");
+								eventBus.emit("orchestrator:story-warn", {
+									storyKey,
+									msg: `create-story wrote to backslash-escaped path ${escapedVariant}; rename to canonical failed`
+								});
+							}
+						}
+						if (actualPath === null) {
+							const outputTokens = createResult.tokenUsage?.output ?? 0;
+							const errMsg = `create-story claimed success (story_file: ${createResult.story_file}) but the file does not exist on disk (output tokens: ${outputTokens})`;
+							logger$24.error({
+								storyKey,
+								claimedPath: createResult.story_file,
+								outputTokens
+							}, errMsg);
+							updateStory(storyKey, {
+								phase: "ESCALATED",
+								error: errMsg,
+								completedAt: new Date().toISOString()
+							});
+							await writeStoryMetricsBestEffort(storyKey, "failed", 0);
+							await emitEscalation({
+								storyKey,
+								lastVerdict: "create-story-fraud-success",
+								reviewCycles: 0,
+								issues: [errMsg]
+							});
+							await persistState();
+							return;
+						}
+						if (actualPath !== createResult.story_file) createResult.story_file = actualPath;
+						const claimedStat = statSync(actualPath);
+						if (claimedStat.mtimeMs < dispatchStartMs) {
+							const outputTokens = createResult.tokenUsage?.output ?? 0;
+							const mtimeISO = new Date(claimedStat.mtimeMs).toISOString();
+							const dispatchStartISO = new Date(dispatchStartMs).toISOString();
+							const errMsg = `create-story claimed success but did not rewrite ${actualPath} during this dispatch (file mtime ${mtimeISO} predates dispatch start ${dispatchStartISO}; output tokens: ${outputTokens})`;
+							logger$24.error({
+								storyKey,
+								claimedPath: actualPath,
+								mtimeISO,
+								dispatchStartISO,
+								outputTokens
+							}, errMsg);
+							updateStory(storyKey, {
+								phase: "ESCALATED",
+								error: errMsg,
+								completedAt: new Date().toISOString()
+							});
+							await writeStoryMetricsBestEffort(storyKey, "failed", 0);
+							await emitEscalation({
+								storyKey,
+								lastVerdict: "create-story-fraud-success",
+								reviewCycles: 0,
+								issues: [errMsg]
+							});
+							await persistState();
+							return;
+						}
+					} catch (verifyErr) {
+						logger$24.warn({
+							storyKey,
+							err: verifyErr
+						}, "create-story post-dispatch file verification threw; proceeding with claimed path");
+					}
+				}
+				storyFilePath = createResult.story_file;
+				if (createResult.story_title) try {
+					const epicId = storyKey.split("-")[0] ?? storyKey;
+					const implDecisions = await getDecisionsByPhase(db, "implementation");
+					let shardContent;
+					const perStoryShard = implDecisions.find((d) => d.category === "epic-shard" && d.key === storyKey);
+					if (perStoryShard?.value) shardContent = perStoryShard.value;
+					else {
+						const epicShard = implDecisions.find((d) => d.category === "epic-shard" && d.key === epicId);
+						if (epicShard?.value) shardContent = extractStorySection(epicShard.value, storyKey) ?? epicShard.value;
+					}
+					if (shardContent) {
+						const expectedTitle = extractExpectedStoryTitle(shardContent, storyKey);
+						if (expectedTitle) {
+							const overlap = computeTitleOverlap(expectedTitle, createResult.story_title);
+							if (overlap < TITLE_OVERLAP_WARNING_THRESHOLD) {
+								const msg = `Story title mismatch: expected "${expectedTitle}" but got "${createResult.story_title}" (word overlap: ${Math.round(overlap * 100)}%). This may indicate the create-story agent received truncated context.`;
+								logger$24.warn({
+									storyKey,
+									expectedTitle,
+									generatedTitle: createResult.story_title,
+									overlap
+								}, msg);
+								eventBus.emit("orchestrator:story-warn", {
+									storyKey,
+									msg
+								});
+							} else logger$24.debug({
+								storyKey,
+								expectedTitle,
+								generatedTitle: createResult.story_title,
+								overlap
+							}, "Story title validation passed");
+						}
+					}
+				} catch (titleValidationErr) {
+					logger$24.debug({
+						storyKey,
+						err: titleValidationErr
+					}, "Story title validation skipped due to error");
+				}
+			} catch (err) {
+				const errMsg = err instanceof Error ? err.message : String(err);
+				endPhase(storyKey, "create-story");
 				updateStory(storyKey, {
 					phase: "ESCALATED",
 					error: errMsg,
@@ -12234,133 +12501,106 @@ function createImplementationOrchestrator(deps) {
 				await writeStoryMetricsBestEffort(storyKey, "failed", 0);
 				await emitEscalation({
 					storyKey,
-					lastVerdict: "create-story-no-file",
+					lastVerdict: "create-story-exception",
 					reviewCycles: 0,
 					issues: [errMsg]
 				});
 				await persistState();
 				return;
 			}
-			if (projectRoot !== void 0) {
-				const expectedArtifactsDir = join$1(projectRoot, "_bmad-output", "implementation-artifacts");
-				const claimedPath = createResult.story_file;
-				if (claimedPath.startsWith(expectedArtifactsDir)) try {
-					if (!existsSync(claimedPath)) {
-						const outputTokens = createResult.tokenUsage?.output ?? 0;
-						const errMsg = `create-story claimed success (story_file: ${claimedPath}) but the file does not exist on disk (output tokens: ${outputTokens})`;
-						logger$24.error({
-							storyKey,
-							claimedPath,
-							outputTokens
-						}, errMsg);
-						updateStory(storyKey, {
-							phase: "ESCALATED",
-							error: errMsg,
-							completedAt: new Date().toISOString()
-						});
-						await writeStoryMetricsBestEffort(storyKey, "failed", 0);
-						await emitEscalation({
-							storyKey,
-							lastVerdict: "create-story-fraud-success",
-							reviewCycles: 0,
-							issues: [errMsg]
-						});
-						await persistState();
-						return;
-					}
-					const claimedStat = statSync(claimedPath);
-					if (claimedStat.mtimeMs < dispatchStartMs) {
-						const outputTokens = createResult.tokenUsage?.output ?? 0;
-						const mtimeISO = new Date(claimedStat.mtimeMs).toISOString();
-						const dispatchStartISO = new Date(dispatchStartMs).toISOString();
-						const errMsg = `create-story claimed success but did not rewrite ${claimedPath} during this dispatch (file mtime ${mtimeISO} predates dispatch start ${dispatchStartISO}; output tokens: ${outputTokens})`;
-						logger$24.error({
-							storyKey,
-							claimedPath,
-							mtimeISO,
-							dispatchStartISO,
-							outputTokens
-						}, errMsg);
-						updateStory(storyKey, {
-							phase: "ESCALATED",
-							error: errMsg,
-							completedAt: new Date().toISOString()
-						});
-						await writeStoryMetricsBestEffort(storyKey, "failed", 0);
-						await emitEscalation({
-							storyKey,
-							lastVerdict: "create-story-fraud-success",
-							reviewCycles: 0,
-							issues: [errMsg]
-						});
-						await persistState();
-						return;
-					}
-				} catch (verifyErr) {
-					logger$24.warn({
-						storyKey,
-						err: verifyErr
-					}, "create-story post-dispatch file verification threw; proceeding with claimed path");
-				}
-			}
-			storyFilePath = createResult.story_file;
-			if (createResult.story_title) try {
+			if (storyFilePath !== void 0 && projectRoot !== void 0) try {
 				const epicId = storyKey.split("-")[0] ?? storyKey;
-				const implDecisions = await getDecisionsByPhase(db, "implementation");
-				let shardContent;
-				const perStoryShard = implDecisions.find((d) => d.category === "epic-shard" && d.key === storyKey);
-				if (perStoryShard?.value) shardContent = perStoryShard.value;
+				const fidelityImplDecisions = await getDecisionsByPhase(db, "implementation");
+				let fidelitySourceContent;
+				const fidelityPerStoryShard = fidelityImplDecisions.find((d) => d.category === "epic-shard" && d.key === storyKey);
+				if (fidelityPerStoryShard?.value) fidelitySourceContent = fidelityPerStoryShard.value;
 				else {
-					const epicShard = implDecisions.find((d) => d.category === "epic-shard" && d.key === epicId);
-					if (epicShard?.value) shardContent = extractStorySection(epicShard.value, storyKey) ?? epicShard.value;
-				}
-				if (shardContent) {
-					const expectedTitle = extractExpectedStoryTitle(shardContent, storyKey);
-					if (expectedTitle) {
-						const overlap = computeTitleOverlap(expectedTitle, createResult.story_title);
-						if (overlap < TITLE_OVERLAP_WARNING_THRESHOLD) {
-							const msg = `Story title mismatch: expected "${expectedTitle}" but got "${createResult.story_title}" (word overlap: ${Math.round(overlap * 100)}%). This may indicate the create-story agent received truncated context.`;
-							logger$24.warn({
-								storyKey,
-								expectedTitle,
-								generatedTitle: createResult.story_title,
-								overlap
-							}, msg);
-							eventBus.emit("orchestrator:story-warn", {
-								storyKey,
-								msg
-							});
-						} else logger$24.debug({
+					const epicShardForFidelity = fidelityImplDecisions.find((d) => d.category === "epic-shard" && d.key === epicId);
+					if (epicShardForFidelity?.value) fidelitySourceContent = extractStorySection(epicShardForFidelity.value, storyKey) ?? void 0;
+				}
+				if (fidelitySourceContent !== void 0) {
+					const namedPaths = extractNamedPathsFromSource(fidelitySourceContent);
+					if (namedPaths.length >= MIN_NAMED_PATHS_FOR_FIDELITY_GATE) {
+						const storyContentForFidelity = await readFile$1(storyFilePath, "utf-8");
+						const fidelity = computeStoryFileFidelity(storyContentForFidelity, namedPaths);
+						logger$24.debug({
 							storyKey,
-							expectedTitle,
-							generatedTitle: createResult.story_title,
-							overlap
-						}, "Story title validation passed");
+							drift: fidelity.drift,
+							missing: fidelity.missing,
+							presentCount: fidelity.present.length,
+							namedPathsCount: namedPaths.length
+						}, "create-story output fidelity check");
+						if (fidelity.drift > FIDELITY_DRIFT_THRESHOLD) {
+							fidelityRetries++;
+							if (fidelityRetries <= MAX_FIDELITY_RETRIES) {
+								const stalePath = storyFilePath.replace(/\.md$/, `.stale-${Date.now()}.md`);
+								try {
+									renameSync(storyFilePath, stalePath);
+									const driftPct = Math.round(fidelity.drift * 100);
+									logger$24.warn({
+										storyKey,
+										drift: fidelity.drift,
+										missing: fidelity.missing,
+										retries: fidelityRetries,
+										stalePath
+									}, `create-story output drifted from source AC (${driftPct}% of ${namedPaths.length} named paths missing); renamed to ${stalePath} and retrying (${fidelityRetries}/${MAX_FIDELITY_RETRIES})`);
+									eventBus.emit("orchestrator:story-warn", {
+										storyKey,
+										msg: `create-story drift detected (${fidelity.missing.length}/${namedPaths.length} named paths missing); retry ${fidelityRetries}/${MAX_FIDELITY_RETRIES}`
+									});
+									priorDriftFeedback = [
+										`### Prior Dispatch Drift Detected (retry ${fidelityRetries}/${MAX_FIDELITY_RETRIES})`,
+										"",
+										`A previous create-story dispatch for this story produced an artifact that omitted ${fidelity.missing.length} of ${namedPaths.length} named files/paths from the source AC. The previous artifact has been moved to \`${stalePath}\` and you are being re-dispatched to produce a corrected artifact.`,
+										"",
+										"**Named paths from the source AC that were missing in the prior dispatch:**",
+										"",
+										...fidelity.missing.map((p) => `- \`${p}\``),
+										"",
+										"These names appear in the Epic Scope above and are part of the source AC contract. Preserve them verbatim in your rendered artifact (file lists, paths, named identifiers in Tasks/Subtasks). Do not substitute alternative names from training priors. If the source AC says `adjacency-store.ts`, the rendered story file says `adjacency-store.ts` — not `LinkStore`, `AdjacencyManager`, or any other re-conceptualization."
+									].join("\n");
+									storyFilePath = void 0;
+									continue;
+								} catch (renameErr) {
+									logger$24.warn({
+										storyKey,
+										err: renameErr,
+										stalePath
+									}, "failed to rename drifting artifact for retry; proceeding with current artifact");
+								}
+							} else {
+								const errMsg = `create-story output drifted from source AC after ${MAX_FIDELITY_RETRIES} retries; ${fidelity.missing.length} of ${namedPaths.length} named paths missing: ` + fidelity.missing.join(", ");
+								logger$24.error({
+									storyKey,
+									drift: fidelity.drift,
+									missing: fidelity.missing,
+									namedPaths
+								}, errMsg);
+								endPhase(storyKey, "create-story");
+								updateStory(storyKey, {
+									phase: "ESCALATED",
+									error: errMsg,
+									completedAt: new Date().toISOString()
+								});
+								await writeStoryMetricsBestEffort(storyKey, "failed", 0);
+								await emitEscalation({
+									storyKey,
+									lastVerdict: "create-story-source-ac-drift",
+									reviewCycles: 0,
+									issues: [errMsg]
+								});
+								await persistState();
+								return;
+							}
+						}
 					}
 				}
-			} catch (titleValidationErr) {
-				logger$24.debug({
+			} catch (fidelityErr) {
+				logger$24.warn({
 					storyKey,
-					err: titleValidationErr
-				}, "Story title validation skipped due to error");
+					err: fidelityErr
+				}, "fidelity gate threw; proceeding without retry");
 			}
-		} catch (err) {
-			const errMsg = err instanceof Error ? err.message : String(err);
-			endPhase(storyKey, "create-story");
-			updateStory(storyKey, {
-				phase: "ESCALATED",
-				error: errMsg,
-				completedAt: new Date().toISOString()
-			});
-			await writeStoryMetricsBestEffort(storyKey, "failed", 0);
-			await emitEscalation({
-				storyKey,
-				lastVerdict: "create-story-exception",
-				reviewCycles: 0,
-				issues: [errMsg]
-			});
-			await persistState();
-			return;
 		}
 		if (storyFilePath) try {
 			const storyContent = await readFile$1(storyFilePath, "utf-8");
@@ -44091,4 +44331,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-2nI3qh0-.js.map
+//# sourceMappingURL=run-DrJWCS63.js.map

package/package.json

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

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

@@ -19,6 +19,8 @@
 ### Story Definition (from Solutioning Phase)
 {{story_definition}}
 
+{{prior_drift_feedback}}
+
 ---
 
 ## Mission
@@ -72,6 +74,7 @@ Do NOT write a partial story file. Do NOT paraphrase surrounding context. Do NOT
    - Dev Notes with file paths, import patterns, testing requirements
 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`
+   - Pass this path to your file-writing tool **literally as written** — do NOT markdown-escape the underscore as `\_bmad-output`. The leading underscore is part of the directory name, not a markdown italic delimiter.
    - 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)