substrate-ai 0.20.21 → 0.20.23

package/dist/cli/index.js

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
-import { FileStateStore, RunManifest, SUBSTRATE_OWNED_SETTINGS_KEYS, SupervisorLock, VALID_PHASES, WorkGraphRepository, ZERO_FINDING_COUNTS, buildPipelineStatusOutput, createDatabaseAdapter, createStateStore, findPackageRoot, formatOutput, formatPipelineStatusHuman, formatPipelineSummary, formatTokenTelemetry, getAllDescendantPids, getAutoHealthData, getSubstrateDefaultSettings, inspectProcessTree, parseDbTimestampAsUtc, registerHealthCommand, resolveBmadMethodSrcPath, resolveBmadMethodVersion, resolveMainRepoRoot, resolveRunManifest, rollupFindingCounts } from "../health-ZGa9E0D2.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-Cq8K_jrJ.js";
 import { createLogger } from "../logger-KeHncl-f.js";
 import { createEventBus } from "../helpers-CElYrONe.js";
 import { AdapterRegistry, BudgetConfigSchema, CURRENT_CONFIG_FORMAT_VERSION, CURRENT_TASK_GRAPH_VERSION, ConfigError, CostTrackerConfigSchema, DEFAULT_CONFIG, DoltClient, DoltNotInstalled, GlobalSettingsSchema, IngestionServer, MonitorDatabaseImpl, OPERATIONAL_FINDING, PartialGlobalSettingsSchema, PartialProviderConfigSchema, ProvidersSchema, RoutingRecommender, STORY_METRICS, TelemetryConfigSchema, addTokenUsage, aggregateTokenUsageForRun, checkDoltInstalled, compareRunMetrics, createAmendmentRun, createConfigSystem, createDecision, createDoltClient, createPipelineRun, getActiveDecisions, getAllCostEntriesFiltered, getBaselineRunMetrics, getDecisionsByCategory, getDecisionsByPhaseForRun, getLatestCompletedRun, getLatestRun, getPipelineRunById, getPlanningCostTotal, getRetryableEscalations, getRunMetrics, getRunningPipelineRuns, getSessionCostSummary, getSessionCostSummaryFiltered, getStoryMetricsForRun, getTokenUsageSummary, incrementRunRestarts, initSchema, initializeDolt, listRunMetrics, loadParentRunDecisions, supersedeDecision, tagRunAsBaseline, updatePipelineRun } from "../dist-CqtWS9wF.js";
 import "../adapter-registry-DXLMTmfD.js";
-import { AdapterTelemetryPersistence, AppError, DoltRepoMapMetaRepository, DoltSymbolRepository, ERR_REPO_MAP_STORAGE_WRITE, EpicIngester, GitClient, GrammarLoader, RepoMapInjector, RepoMapModule, RepoMapQueryEngine, RepoMapStorage, SymbolParser, createContextCompiler, createDispatcher, createEventEmitter, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStopAfterGate, createTelemetryAdvisor, formatPhaseCompletionSummary, getFactoryRunSummaries, getScenarioResultsForRun, getTwinRunsForRun, listGraphRuns, registerExportCommand, registerFactoryCommand, registerRunCommand, registerScenariosCommand, resolveStoryKeys, runAnalysisPhase, runPlanningPhase, runSolutioningPhase, validateStopAfterFromConflict } from "../run-DrJWCS63.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-B3e4O0Rk.js";
 import "../errors-1uLGqnvr.js";
 import "../routing-CcBOCuC9.js";
 import "../decisions-C0pz9Clx.js";
@@ -3667,7 +3667,7 @@ async function runStatusAction(options) {
 			logger$12.debug({ err }, "Work graph query failed, continuing without work graph data");
 		}
 		if (run === void 0) {
-			const { inspectProcessTree: inspectProcessTree$1 } = await import("../health-CeVz5k99.js");
+			const { inspectProcessTree: inspectProcessTree$1 } = await import("../health-CsRLsKgu.js");
 			const substrateDirPath = join(projectRoot, ".substrate");
 			const processInfo = inspectProcessTree$1({
 				projectRoot,
@@ -5198,7 +5198,7 @@ async function runSupervisorAction(options, deps = {}) {
 								await initSchema(expAdapter);
 								const { runRunAction: runPipeline } = await import(
 									/* @vite-ignore */
-									"../run-C46Xfny6.js"
+									"../run-DEeTPCdU.js"
 );
 								const runStoryFn = async (opts) => {
 									const exitCode = await runPipeline({

package/dist/{health-ZGa9E0D2.js → health-Cq8K_jrJ.js}

@@ -3847,6 +3847,51 @@ function pathSatisfiedByCode(workingDir, pathClause) {
 	return false;
 }
 /**
+* Story 60-3 (Sprint 11B): check whether the path clause is referenced from
+* THIS story's modified files. Strata obs_2026-04-25_011 surfaced a case where
+* `pathSatisfiedByCode` returned true (path exists in repo) but the story's
+* own code did not actually use the path — the directory was created earlier
+* by a different story (1-17 in strata's case) and 1-10's `packages/memory-mcp/`
+* code never imported `packages/mesh-agent`. The fidelity check then annotated
+* the missing path as "stylistic drift — code satisfies it", obscuring real
+* under-delivery.
+*
+* This check closes that gap: when path exists in repo AND a list of
+* modified files is available, scan those modified files for an import /
+* require / use reference to the path's basename. If references exist, the
+* story's code does use the path → genuinely stylistic drift. If references
+* are absent, the story's code does not use the path → architectural
+* under-delivery (downgrade severity from warn to error).
+*
+* Conservative behavior: when modifiedFiles is empty (dev didn't report a
+* file list, or a Tier B re-verification context), preserves the existing
+* "code satisfies → warn" behavior. Only TIGHTENS when authoritative
+* file-list signal is present.
+*/
+function pathReferencedInModifiedFiles(workingDir, pathClause, modifiedFiles) {
+	if (modifiedFiles.length === 0) return true;
+	const raw = pathClause.replace(/^`/, "").replace(/`$/, "");
+	const baseWithExt = basename$1(raw);
+	const token = baseWithExt.replace(/\.[a-z]+$/i, "");
+	if (token.length < 3) return true;
+	const escapedSeparatorTolerant = token.replace(/[.*+?^${}()|[\]\\]/g, "\\$&").replace(/[-_]/g, "[-_]");
+	const importPattern = new RegExp(`^\\s*(?:import|from|require|use|mod)\\b[^\\n]*\\b${escapedSeparatorTolerant}\\b`, "mi");
+	const barePattern = new RegExp(`\\b${escapedSeparatorTolerant}\\b`, "i");
+	for (const filePath of modifiedFiles) {
+		let content;
+		try {
+			content = readFileSync(join$1(workingDir, filePath), "utf-8");
+		} catch {
+			continue;
+		}
+		if (importPattern.test(content)) return true;
+		if (filePath.endsWith("package.json") || filePath.endsWith(".yaml") || filePath.endsWith(".yml") || filePath.endsWith(".toml")) {
+			if (barePattern.test(content)) return true;
+		}
+	}
+	return false;
+}
+/**
 * Extract the story's section from the full epic content.
 *
 * Uses the same heading pattern as `isImplicitlyCovered` in the monolith:
@@ -3937,10 +3982,24 @@ var SourceAcFidelityCheck = class {
 			const truncated = clause.text.length > 120 ? clause.text.slice(0, 120) : clause.text;
 			if (clause.type === "path") {
 				const existsInCode = pathSatisfiedByCode(context.workingDir, clause.text);
+				const modifiedFiles = context.devStoryResult?.files_modified ?? [];
+				const referencedByStory = pathReferencedInModifiedFiles(context.workingDir, clause.text, modifiedFiles);
+				let severity;
+				let driftMessage;
+				if (!existsInCode) {
+					severity = "error";
+					driftMessage = `${clause.type}: "${truncated}" present in epics source but absent in story artifact AND missing from code (architectural drift)`;
+				} else if (!referencedByStory) {
+					severity = "error";
+					driftMessage = `${clause.type}: "${truncated}" present in epics source but absent in story artifact AND code path exists in repo but THIS story's modified files do not reference it (under-delivery — code path was created by a different story; this story did not wire it in)`;
+				} else {
+					severity = "warn";
+					driftMessage = `${clause.type}: "${truncated}" present in epics source but absent in story artifact (code satisfies it — stylistic drift)`;
+				}
 				findings.push({
 					category: "source-ac-drift",
-					severity: existsInCode ? "warn" : "error",
-					message: existsInCode ? `${clause.type}: "${truncated}" present in epics source but absent in story artifact (code satisfies it — stylistic drift)` : `${clause.type}: "${truncated}" present in epics source but absent in story artifact AND missing from code (architectural drift)`
+					severity,
+					message: driftMessage
 				});
 			} else findings.push({
 				category: "source-ac-drift",
@@ -5622,4 +5681,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-ZGa9E0D2.js.map
+//# sourceMappingURL=health-Cq8K_jrJ.js.map

package/dist/{health-CeVz5k99.js → health-CsRLsKgu.js}

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

package/dist/{run-DrJWCS63.js → run-B3e4O0Rk.js}

@@ -1,4 +1,4 @@
-import { BMAD_BASELINE_TOKENS_FULL, DoltMergeConflict, FileStateStore, FindingsInjector, RunManifest, STOP_AFTER_VALID_PHASES, STORY_KEY_PATTERN, VALID_PHASES, WorkGraphRepository, __commonJS, __require, __toESM, applyConfigToGraph, buildPipelineStatusOutput, createDatabaseAdapter, createDefaultVerificationPipeline, createGraphOrchestrator, createSdlcCodeReviewHandler, createSdlcCreateStoryHandler, createSdlcDevStoryHandler, createSdlcPhaseHandler, detectCycles, extractTargetFilesFromStoryContent, formatOutput, formatPipelineSummary, formatTokenTelemetry, inspectProcessTree, parseDbTimestampAsUtc, renderFindings, resolveGraphPath, resolveMainRepoRoot, validateStoryKey } from "./health-ZGa9E0D2.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-Cq8K_jrJ.js";
 import { createLogger } from "./logger-KeHncl-f.js";
 import { TypedEventBusImpl, createEventBus, createTuiApp, isTuiCapable, printNonTtyWarning, sleep } from "./helpers-CElYrONe.js";
 import { ADVISORY_NOTES, Categorizer, ConsumerAnalyzer, DEFAULT_GLOBAL_SETTINGS, DispatcherImpl, DoltClient, ESCALATION_DIAGNOSIS, EXPERIMENT_RESULT, EfficiencyScorer, IngestionServer, LogTurnAnalyzer, OPERATIONAL_FINDING, Recommender, RoutingRecommender, RoutingResolver, RoutingTelemetry, RoutingTokenAccumulator, RoutingTuner, STORY_METRICS, STORY_OUTCOME, SubstrateConfigSchema, TEST_EXPANSION_FINDING, TEST_PLAN, TelemetryNormalizer, TelemetryPipeline, TurnAnalyzer, addTokenUsage, aggregateTokenUsageForRun, aggregateTokenUsageForStory, callLLM, createConfigSystem, createDatabaseAdapter$1, createDecision, createPipelineRun, createRequirement, detectInterfaceChanges, getArtifactByTypeForRun, getArtifactsByRun, getDecisionsByCategory, getDecisionsByPhase, getDecisionsByPhaseForRun, getLatestRun, getPipelineRunById, getRunMetrics, getRunningPipelineRuns, getStoryMetricsForRun, getTokenUsageSummary, initSchema, listRequirements, loadModelRoutingConfig, registerArtifact, updatePipelineRun, updatePipelineRunConfig, upsertDecision, writeRunMetrics, writeStoryMetrics } from "./dist-CqtWS9wF.js";
@@ -6030,6 +6030,95 @@ function computeStoryFileFidelity(storyFileContent, namedPaths) {
 		drift: missing.length / namedPaths.length
 	};
 }
+const WORD_TO_NUMBER = {
+	one: 1,
+	two: 2,
+	three: 3,
+	four: 4,
+	five: 5,
+	six: 6,
+	seven: 7,
+	eight: 8,
+	nine: 9,
+	ten: 10
+};
+function extractBehavioralAssertions(content) {
+	if (content.length === 0) return {
+		whenClauseCount: 0,
+		whenOrAcCount: 0,
+		numericQuantifiers: []
+	};
+	const whenMatches = content.match(/\*\*When\*\*/gi);
+	const whenClauseCount = whenMatches?.length ?? 0;
+	const acHeadings = content.match(/^#{2,4}\s+AC\d+\b/gim);
+	const acCount = acHeadings?.length ?? 0;
+	const whenOrAcCount = Math.max(whenClauseCount, acCount);
+	const numericQuantifiers = [];
+	const seen = new Set();
+	const wordNum = "(?:one|two|three|four|five|six|seven|eight|nine|ten)";
+	const pattern = new RegExp(`\\b(exactly|all|both)\\s+(?:(${wordNum}|\\d+)\\s+)?(?:[a-z][a-z_-]*\\s+){0,2}([a-z][a-z_-]+s)\\b`, "gi");
+	let match$2;
+	while ((match$2 = pattern.exec(content)) !== null) {
+		const determiner = match$2[1]?.toLowerCase() ?? "";
+		const numStr = match$2[2]?.toLowerCase() ?? "";
+		const noun = match$2[3]?.toLowerCase() ?? "";
+		let count;
+		if (numStr === "") if (determiner === "both") count = 2;
+		else continue;
+		else if (WORD_TO_NUMBER[numStr] !== void 0) count = WORD_TO_NUMBER[numStr];
+		else {
+			const parsed = Number.parseInt(numStr, 10);
+			if (Number.isNaN(parsed)) continue;
+			count = parsed;
+		}
+		if (noun.length < 3) continue;
+		const phrase = `${determiner} ${numStr || (determiner === "both" ? "" : "")} ${noun}`.trim().replace(/\s+/g, " ");
+		const dedupKey = `${count}|${noun}`;
+		if (seen.has(dedupKey)) continue;
+		seen.add(dedupKey);
+		numericQuantifiers.push({
+			phrase,
+			count,
+			noun
+		});
+	}
+	return {
+		whenClauseCount,
+		whenOrAcCount,
+		numericQuantifiers
+	};
+}
+function computeClauseFidelity(storyFileContent, sourceContent) {
+	const sourceSignals = extractBehavioralAssertions(sourceContent);
+	const renderedSignals = extractBehavioralAssertions(storyFileContent);
+	const sourceCount = sourceSignals.whenOrAcCount;
+	const renderedCount = renderedSignals.whenOrAcCount;
+	const clauseRatio = sourceCount === 0 ? 1 : Math.min(1, renderedCount / sourceCount);
+	const sourceNounCounts = new Map();
+	for (const q of sourceSignals.numericQuantifiers) sourceNounCounts.set(q.noun, Math.max(sourceNounCounts.get(q.noun) ?? 0, q.count));
+	const renderedNounCounts = new Map();
+	for (const q of renderedSignals.numericQuantifiers) renderedNounCounts.set(q.noun, Math.max(renderedNounCounts.get(q.noun) ?? 0, q.count));
+	const numericMismatches = [];
+	for (const [noun, sourceCnt] of sourceNounCounts.entries()) {
+		const renderedCnt = renderedNounCounts.get(noun) ?? 0;
+		if (renderedCnt < sourceCnt) numericMismatches.push({
+			noun,
+			sourceCount: sourceCnt,
+			renderedCount: renderedCnt
+		});
+	}
+	const numericDriftComponent = numericMismatches.length > 0 ? 1 : 0;
+	const CLAUSE_RATIO_FLOOR = .7;
+	const clauseDriftComponent = clauseRatio >= CLAUSE_RATIO_FLOOR ? 0 : Math.min(1, (CLAUSE_RATIO_FLOOR - clauseRatio) / CLAUSE_RATIO_FLOOR);
+	const drift = Math.max(numericDriftComponent, clauseDriftComponent);
+	return {
+		clauseRatio,
+		sourceClauseCount: sourceCount,
+		renderedClauseCount: renderedCount,
+		numericMismatches,
+		drift
+	};
+}
 /**
 * Retrieve the epic shard from the pre-fetched implementation decisions.
 *
@@ -12520,78 +12609,114 @@ function createImplementationOrchestrator(deps) {
 				}
 				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,
-							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({
+					const storyContentForFidelity = await readFile$1(storyFilePath, "utf-8");
+					const pathFidelity = namedPaths.length >= MIN_NAMED_PATHS_FOR_FIDELITY_GATE ? computeStoryFileFidelity(storyContentForFidelity, namedPaths) : null;
+					const clauseFidelity = computeClauseFidelity(storyContentForFidelity, fidelitySourceContent);
+					const pathDrift = pathFidelity?.drift ?? 0;
+					const clauseDrift = clauseFidelity.drift;
+					const overallDrift = Math.max(pathDrift, clauseDrift);
+					logger$24.debug({
+						storyKey,
+						pathDrift,
+						clauseDrift,
+						overallDrift,
+						pathMissing: pathFidelity?.missing ?? [],
+						numericMismatches: clauseFidelity.numericMismatches,
+						clauseRatio: clauseFidelity.clauseRatio
+					}, "create-story output fidelity check (path + clause)");
+					if (overallDrift > 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(overallDrift * 100);
+								const pathMissing = pathFidelity?.missing ?? [];
+								const numericMismatches = clauseFidelity.numericMismatches;
+								const reasons = [];
+								if (pathMissing.length > 0) reasons.push(`${pathMissing.length} named path(s) missing`);
+								if (numericMismatches.length > 0) reasons.push(`${numericMismatches.length} numeric quantifier mismatch(es) (e.g., "${numericMismatches[0].noun}" source=${numericMismatches[0].sourceCount} rendered=${numericMismatches[0].renderedCount})`);
+								if (clauseFidelity.clauseRatio < .7) reasons.push(`clause shortfall (rendered ${clauseFidelity.renderedClauseCount}/${clauseFidelity.sourceClauseCount} = ${Math.round(clauseFidelity.clauseRatio * 100)}%)`);
+								logger$24.warn({
 									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({
+									pathDrift,
+									clauseDrift,
+									pathMissing,
+									numericMismatches,
+									clauseRatio: clauseFidelity.clauseRatio,
+									retries: fidelityRetries,
+									stalePath
+								}, `create-story output drifted from source AC (${driftPct}% drift, ${reasons.join("; ")}); renamed to ${stalePath} and retrying (${fidelityRetries}/${MAX_FIDELITY_RETRIES})`);
+								eventBus.emit("orchestrator:story-warn", {
 									storyKey,
-									lastVerdict: "create-story-source-ac-drift",
-									reviewCycles: 0,
-									issues: [errMsg]
+									msg: `create-story drift detected (${reasons.join("; ")}); retry ${fidelityRetries}/${MAX_FIDELITY_RETRIES}`
 								});
-								await persistState();
-								return;
+								const feedbackParts = [
+									`### Prior Dispatch Drift Detected (retry ${fidelityRetries}/${MAX_FIDELITY_RETRIES})`,
+									"",
+									`A previous create-story dispatch produced an artifact that drifted from the source AC. The previous artifact has been moved to \`${stalePath}\`.`,
+									"",
+									"**Specific drift findings:**",
+									""
+								];
+								if (pathMissing.length > 0) {
+									feedbackParts.push("Named paths/files from source AC that were missing in the prior dispatch:");
+									feedbackParts.push("");
+									feedbackParts.push(...pathMissing.map((p) => `- \`${p}\``));
+									feedbackParts.push("");
+								}
+								if (numericMismatches.length > 0) {
+									feedbackParts.push("Numeric quantifiers from source AC that were reduced in the prior dispatch:");
+									feedbackParts.push("");
+									feedbackParts.push(...numericMismatches.map((m) => `- source AC says "**${m.sourceCount}** ${m.noun}"; rendered artifact says "${m.renderedCount}" — restore the original count and the named items`));
+									feedbackParts.push("");
+								}
+								if (clauseFidelity.clauseRatio < .7) {
+									feedbackParts.push(`The source AC has ${clauseFidelity.sourceClauseCount} behavioral clauses (Given/When/Then triples or numbered ACs); the prior rendered artifact had only ${clauseFidelity.renderedClauseCount}. You dropped clauses without authorization. Either preserve all source clauses verbatim, OR if the scope is genuinely too large for a single story, emit \`result: failure, error: source scope exceeds single-story capacity — split upstream\` per the prompt's Scope Cap Guidance — silently reducing scope is forbidden.`);
+									feedbackParts.push("");
+								}
+								feedbackParts.push("Preserve the source AC contract verbatim: every named file/path, every numeric quantifier (`exactly N`, `all N`, `both`), and every behavioral clause. Do not substitute names from training priors. Do not silently reduce scope. If the scope cannot fit, emit `result: failure, error: source scope exceeds single-story capacity — split upstream` instead of partially rendering.");
+								priorDriftFeedback = feedbackParts.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 pathMissing = pathFidelity?.missing ?? [];
+							const numericMismatches = clauseFidelity.numericMismatches;
+							const reasons = [];
+							if (pathMissing.length > 0) reasons.push(`paths missing: ${pathMissing.join(", ")}`);
+							if (numericMismatches.length > 0) reasons.push(`numeric mismatches: ${numericMismatches.map((m) => `${m.noun} (source=${m.sourceCount}, rendered=${m.renderedCount})`).join("; ")}`);
+							if (clauseFidelity.clauseRatio < .7) reasons.push(`clause shortfall: source=${clauseFidelity.sourceClauseCount}, rendered=${clauseFidelity.renderedClauseCount}`);
+							const errMsg = `create-story output drifted from source AC after ${MAX_FIDELITY_RETRIES} retries; ` + reasons.join("; ");
+							logger$24.error({
+								storyKey,
+								pathDrift,
+								clauseDrift,
+								pathMissing,
+								numericMismatches,
+								clauseRatio: clauseFidelity.clauseRatio
+							}, 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;
 						}
 					}
 				}
@@ -44331,4 +44456,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-DrJWCS63.js.map
+//# sourceMappingURL=run-B3e4O0Rk.js.map

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

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

package/package.json

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