substrate-ai 0.21.1 → 0.21.3

package/dist/{run-JrEnvaB0.js → run-ZxFHQyE_.js}

@@ -1,11 +1,11 @@
-import { BMAD_BASELINE_TOKENS_FULL, FileKvStore, STOP_AFTER_VALID_PHASES, STORY_KEY_PATTERN, VALID_PHASES, __commonJS, __require, __toESM, buildPipelineStatusOutput, createDatabaseAdapter, formatOutput, formatPipelineSummary, formatTokenTelemetry, inspectProcessTree, parseDbTimestampAsUtc, validateStoryKey } from "./health-Cfkv6XoQ.js";
+import { BMAD_BASELINE_TOKENS_FULL, FileKvStore, STOP_AFTER_VALID_PHASES, STORY_KEY_PATTERN, VALID_PHASES, __commonJS, __require, __toESM, buildPipelineStatusOutput, createDatabaseAdapter, formatOutput, formatPipelineSummary, formatTokenTelemetry, inspectProcessTree, parseDbTimestampAsUtc, validateStoryKey } from "./health-Dnzblihr.js";
 import { createLogger } from "./logger-KeHncl-f.js";
 import { TypedEventBusImpl, createEventBus, createTuiApp, isTuiCapable, printNonTtyWarning, sleep } from "./helpers-CElYrONe.js";
-import { ADVISORY_NOTES, BRANCH_PREFIX, CLAUDE_AUTH_FAILURE_HINT, CODEX_SANDBOX_BLOCK_HINT, 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, classifyVersionGap, createConfigSystem, createDatabaseAdapter$1, createDecision, createGitWorktreeManager, createPipelineRun, createRequirement, detectClaudeAuthFailure, detectCodexSandboxBlock, detectInterfaceChanges, getArtifactByTypeForRun, getArtifactsByRun, getDecisionsByCategory, getDecisionsByPhase, getDecisionsByPhaseForRun, getLatestRun, getPipelineRunById, getRunMetrics, getRunningPipelineRuns, getStoryMetricsForRun, getTokenUsageSummary, initSchema, listRequirements, loadModelRoutingConfig, registerArtifact, swallowDebug, updatePipelineRun, updatePipelineRunConfig, upsertDecision, writeRunMetrics, writeStoryMetrics } from "./dist-BkhYgJWo.js";
-import { FindingsInjector, RunManifest, RuntimeProbeListSchema, applyConfigToGraph, createDefaultVerificationPipeline, createGraphOrchestrator, createSdlcCodeReviewHandler, createSdlcCreateStoryHandler, createSdlcDevStoryHandler, createSdlcPhaseHandler, detectsEventDrivenAC, detectsStateIntegratingAC, extractTargetFilesFromStoryContent, parseRuntimeProbes, renderFindings, resolveGraphPath, resolveMainRepoRoot, runAcTraceabilityCheck, runStaleVerificationRecovery } from "./manifest-read-BhNRIiqm.js";
+import { ADVISORY_NOTES, BRANCH_PREFIX, CLAUDE_AUTH_FAILURE_HINT, CODEX_SANDBOX_BLOCK_HINT, 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, classifyVersionGap, createConfigSystem, createDatabaseAdapter$1, createDecision, createGitWorktreeManager, createPipelineRun, createRequirement, detectClaudeAuthFailure, detectCodexSandboxBlock, detectInterfaceChanges, getArtifactByTypeForRun, getArtifactsByRun, getDecisionsByCategory, getDecisionsByPhase, getDecisionsByPhaseForRun, getLatestRun, getPipelineRunById, getRunMetrics, getRunningPipelineRuns, getStoryMetricsForRun, getTokenUsageSummary, initSchema, listRequirements, loadModelRoutingConfig, registerArtifact, swallowDebug, updatePipelineRun, updatePipelineRunConfig, upsertDecision, writeRunMetrics, writeStoryMetrics } from "./dist-CpnLJuVw.js";
+import { FindingsInjector, JOURNEY_DEFERRALS_PATH, RunManifest, RuntimeProbeListSchema, applyConfigToGraph, computeJourneyCoverage, createDefaultVerificationPipeline, createGraphOrchestrator, createSdlcCodeReviewHandler, createSdlcCreateStoryHandler, createSdlcDevStoryHandler, createSdlcPhaseHandler, detectsEventDrivenAC, detectsStateIntegratingAC, extractTargetFilesFromStoryContent, loadJourneyDeferralsFromTrustedTree, loadJourneyRegistryFromTrustedTree, parseRuntimeProbes, parseStoryFrontmatter, renderFindings, resolveGraphPath, resolveMainRepoRoot, runAcTraceabilityCheck, runStaleVerificationRecovery, summarizeCoverage } from "./manifest-read-B3gE46DX.js";
 import { WorkGraphRepository, detectCycles } from "./work-graph-repository-DZyJv5pV.js";
 import { deriveExitCode, routeDecision } from "./decision-router-BAPpON_C.js";
-import { runInteractivePrompt } from "./interactive-prompt-BBfPSxyJ.js";
+import { runInteractivePrompt } from "./interactive-prompt-BM5RaXYG.js";
 import { runRecoveryEngine } from "./recovery-engine-BKGBeBnW.js";
 import { basename, dirname, extname, join } from "path";
 import { access, readFile, readdir, stat } from "fs/promises";
@@ -933,6 +933,38 @@ const PIPELINE_EVENT_METADATA = [
 			}
 		]
 	},
+	{
+		type: "acceptance:coverage",
+		description: "Journey coverage audit result (acceptance gate, A0.3). Every registered journey in scope lands in exactly one state: walked-pass, walked-fail, deferred, unclaimed (NO story claims it — the never-wired-journey class), or unwalked (claimed but never walked). Advisory mode warns; blocking mode escalates the last story of the epic.",
+		when: "At each epic close and once at run end (scope: \"final\").",
+		fields: [
+			{
+				name: "ts",
+				type: "string",
+				description: "Timestamp."
+			},
+			{
+				name: "scope",
+				type: "string",
+				description: "Audited boundary: epic-<n> or final."
+			},
+			{
+				name: "mode",
+				type: "advisory|blocking",
+				description: "Audit posture (acceptance.mode config)."
+			},
+			{
+				name: "entries",
+				type: "array",
+				description: "Per-journey {journeyId, criticality, state, ownerStories}."
+			},
+			{
+				name: "summary",
+				type: "object",
+				description: "State counts across entries."
+			}
+		]
+	},
 	{
 		type: "story:escalation",
 		description: "Story escalated — either max review cycles exceeded or a precondition for SHIP_IT was not met.",
@@ -951,7 +983,7 @@ const PIPELINE_EVENT_METADATA = [
 			{
 				name: "reason",
 				type: "string",
-				description: "Escalation reason. Common values: review-cycles-exhausted (default review-loop max hit); create-story-no-file (create-story phase did not write a story artifact); dev-story-no-commit (substrate auto-commit found no committable changes — agent produced nothing or all changes were outside the worktree); dev-story-commit-failed (substrate auto-commit failed — typically a pre-commit hook rejected the commit; stderr captured in issues); merge-to-main-error (unexpected error in the merge-to-main phase); merge-conflict-detected (story branch could not be merged due to conflicts); parent-tree-dirtied-by-run (uncommitted parent changes intersect the story diff — merge refused, H3.3); ff-only-merge-not-possible (base moved and merge_strategy is ff-only — set finalization.merge_strategy: three-way or integrate manually, H3.3); epic-gate-failed (finalization.epic_gate_command exited non-zero before the last story of an epic integrated, H3.4); story-file-missing (story artifact gone from working tree AND branch HEAD — check wip/feat commits on the story branch, H5.5). v0.20.87+."
+				description: "Escalation reason. Common values: review-cycles-exhausted (default review-loop max hit); create-story-no-file (create-story phase did not write a story artifact); dev-story-no-commit (substrate auto-commit found no committable changes — agent produced nothing or all changes were outside the worktree); dev-story-commit-failed (substrate auto-commit failed — typically a pre-commit hook rejected the commit; stderr captured in issues); merge-to-main-error (unexpected error in the merge-to-main phase); merge-conflict-detected (story branch could not be merged due to conflicts); parent-tree-dirtied-by-run (uncommitted parent changes intersect the story diff — merge refused, H3.3); ff-only-merge-not-possible (base moved and merge_strategy is ff-only — set finalization.merge_strategy: three-way or integrate manually, H3.3); epic-gate-failed (finalization.epic_gate_command exited non-zero before the last story of an epic integrated, H3.4); story-file-missing (story artifact gone from working tree AND branch HEAD — check wip/feat commits on the story branch, H5.5); undisclosed-files-in-merge (a committed implementation file was never in the dev agent's files_modified, so no review cycle inspected it — inspect the branch, then re-dispatch with accurate files_modified or merge manually, H7); journey-unclaimed (acceptance.mode: blocking — a registered journey has NO story claiming it at epic close; wire it or defer via `substrate acceptance defer`, A0.3); journey-unwalked (acceptance.mode: blocking — a claimed journey was never walked by the acceptance gate at epic close, A0.3). v0.20.87+."
 			},
 			{
 				name: "cycles",
@@ -6138,6 +6170,21 @@ async function runCreateStory(deps, params) {
 	} catch {}
 	const archConstraintsContent = await getArchConstraints$3(deps);
 	const storyTemplateContent = await getStoryTemplate(deps);
+	const trustedRoot = deps.parentProjectRoot ?? deps.projectRoot;
+	let journeyRegistry;
+	if (trustedRoot !== void 0) {
+		const registryLoad = await loadJourneyRegistryFromTrustedTree(trustedRoot);
+		if (registryLoad.status === "ok" && registryLoad.registry.journeys.length > 0) journeyRegistry = registryLoad.registry;
+		else if (registryLoad.status === "invalid") logger$21.warn({
+			storyKey,
+			issues: registryLoad.issues
+		}, "A0.2: journey registry present but invalid — stories will be untagged (registry validity is escalated at epic close)");
+		else if (registryLoad.status === "error") logger$21.warn({
+			storyKey,
+			error: registryLoad.message
+		}, "A0.2: journey registry read failed — stories will be untagged");
+	}
+	const journeyRegistryContent = journeyRegistry !== void 0 ? journeyRegistry.journeys.map((j$1) => `- ${j$1.id} [${j$1.criticality}]: ${j$1.title}`).join("\n") : "";
 	const { prompt, tokenCount, truncated } = assemblePrompt(template, [
 		{
 			name: "story_key",
@@ -6182,6 +6229,15 @@ async function runCreateStory(deps, params) {
 			name: "prior_drift_feedback",
 			content: "",
 			priority: "optional"
+		}],
+		...journeyRegistryContent.length > 0 ? [{
+			name: "journey_registry",
+			content: journeyRegistryContent,
+			priority: "required"
+		}] : [{
+			name: "journey_registry",
+			content: "",
+			priority: "optional"
 		}]
 	], TOKEN_CEILING);
 	logger$21.debug({
@@ -6295,6 +6351,42 @@ async function runCreateStory(deps, params) {
 		};
 	}
 	const parsed = parseResult.data;
+	let validatedJourneys;
+	if (journeyRegistry !== void 0 && parsed.story_file !== void 0) {
+		let artifactContent;
+		try {
+			artifactContent = await readFile$1(parsed.story_file, "utf-8");
+		} catch {
+			artifactContent = void 0;
+		}
+		if (artifactContent !== void 0) {
+			const taggedJourneys = parseStoryFrontmatter(artifactContent).journeys;
+			const knownIds = new Set(journeyRegistry.journeys.map((j$1) => j$1.id));
+			const unknown = taggedJourneys.filter((id) => !knownIds.has(id));
+			if (unknown.length > 0) {
+				const details = `story artifact declares unknown journey id(s): ${unknown.join(", ")} — registry v${String(journeyRegistry.version)} defines: ${[...knownIds].join(", ")}`;
+				logger$21.warn({
+					epicId,
+					storyKey,
+					unknown
+				}, "A0.2: journey tag validation failed");
+				return {
+					result: "failed",
+					error: "schema_validation_failed",
+					details,
+					tokenUsage
+				};
+			}
+			if (taggedJourneys.length > 0) {
+				logger$21.info({
+					epicId,
+					storyKey,
+					journeys: taggedJourneys
+				}, "A0.2: story tagged with journeys");
+				validatedJourneys = taggedJourneys;
+			}
+		}
+	}
 	logger$21.info({
 		epicId,
 		storyKey,
@@ -6307,6 +6399,7 @@ async function runCreateStory(deps, params) {
 		story_key: parsed.story_key,
 		story_title: parsed.story_title,
 		tokenUsage,
+		...validatedJourneys !== void 0 ? { journeys: validatedJourneys } : {},
 		...dispatchResult.model !== void 0 ? { model: dispatchResult.model } : {}
 	};
 }
@@ -13859,6 +13952,40 @@ function createImplementationOrchestrator(deps) {
 		_lastProgressTs = Date.now();
 		_stalledStories.clear();
 	}
+	async function auditJourneyCoverage(scope, opts) {
+		const mode = config.acceptanceMode ?? "advisory";
+		if (mode === "off" || projectRoot === void 0) return void 0;
+		const registryLoad = await loadJourneyRegistryFromTrustedTree(projectRoot);
+		if (registryLoad.status === "absent") return void 0;
+		if (registryLoad.status !== "ok") {
+			logger$27.warn({ detail: registryLoad.status === "invalid" ? registryLoad.issues : registryLoad.message }, "A0.3: journey registry unreadable/invalid — coverage audit skipped (loud escalation for this is A1 acceptance-unrunnable scope)");
+			return void 0;
+		}
+		const deferralsLoad = await loadJourneyDeferralsFromTrustedTree(projectRoot);
+		if (deferralsLoad.status !== "ok") logger$27.warn({ detail: deferralsLoad.status === "invalid" ? deferralsLoad.issues : deferralsLoad.message }, `A0.3: ${JOURNEY_DEFERRALS_PATH} unreadable/invalid — treating as no deferrals`);
+		const deferredJourneyIds = deferralsLoad.status === "ok" ? deferralsLoad.deferrals.map((d) => d.journey) : [];
+		const claims = [];
+		for (const [key, st] of _stories.entries()) for (const journeyId of st.journeys ?? []) claims.push({
+			journeyId,
+			storyKey: key
+		});
+		const entries = computeJourneyCoverage({
+			registry: registryLoad.registry,
+			claims,
+			verdicts: [],
+			deferredJourneyIds,
+			scope
+		});
+		const scopeLabel = "final" in scope ? "final" : `epic-${String(scope.epic)}`;
+		eventBus.emit("orchestrator:acceptance-coverage", {
+			scope: scopeLabel,
+			mode,
+			entries,
+			summary: summarizeCoverage(entries)
+		});
+		if (opts?.persist === true && runManifest !== null) await runManifest.update({ journeys: entries }).catch((err) => logger$27.warn({ err }, "A0.3: manifest journeys ledger write failed — pipeline continues"));
+		return entries;
+	}
 	function getStallThresholdMs(phase) {
 		return phase === "IN_DEV" ? DEV_STORY_STALL_THRESHOLD_MS : DEFAULT_STALL_THRESHOLD_MS;
 	}
@@ -14085,6 +14212,11 @@ function createImplementationOrchestrator(deps) {
 							storyKey,
 							storyFilePath
 						}, "Found existing story file — skipping create-story");
+						try {
+							const reusedContent = await readFile$1(candidatePath, "utf-8");
+							const reusedJourneys = parseStoryFrontmatter(reusedContent).journeys;
+							if (reusedJourneys.length > 0) updateStory(storyKey, { journeys: reusedJourneys });
+						} catch {}
 						endPhase(storyKey, "create-story");
 						eventBus.emit("orchestrator:story-phase-complete", {
 							storyKey,
@@ -14379,6 +14511,13 @@ function createImplementationOrchestrator(deps) {
 					}
 				}
 				storyFilePath = createResult.story_file;
+				if (createResult.journeys !== void 0 && createResult.journeys.length > 0) {
+					updateStory(storyKey, { journeys: createResult.journeys });
+					if (runManifest !== null) runManifest.patchStoryState(storyKey, { journeys: createResult.journeys }).catch((err) => logger$27.warn({
+						err,
+						storyKey
+					}, "A0.3: patchStoryState(journeys) failed — pipeline continues"));
+				}
 				_capturedStoryTitle = sanitizeStoryTitle(createResult.story_title);
 				if (createResult.story_title) try {
 					const epicId = storyKey.split("-")[0] ?? storyKey;
@@ -16231,6 +16370,53 @@ function createImplementationOrchestrator(deps) {
 					}
 				}
 				const finalizationMode = config.finalizationMode ?? "merge";
+				{
+					const acceptanceModeCfg = config.acceptanceMode ?? "advisory";
+					if (acceptanceModeCfg !== "off") {
+						const epicOfA = (key) => key.includes("-") ? key.slice(0, key.lastIndexOf("-")) : key;
+						const epicIdA = epicOfA(storyKey);
+						const TERMINAL_A = ["COMPLETE", "ESCALATED"];
+						const isLastOfEpicA = [..._stories.entries()].filter(([key]) => key !== storyKey && epicOfA(key) === epicIdA).every(([, st]) => TERMINAL_A.includes(st.phase));
+						const epicNum = Number(epicIdA);
+						if (isLastOfEpicA && Number.isInteger(epicNum)) {
+							const entries = await auditJourneyCoverage({ epic: epicNum });
+							const violations = (entries ?? []).filter((e) => e.state === "unclaimed" || e.state === "unwalked");
+							if (violations.length > 0) {
+								const issueLines = violations.map((v) => `journey ${v.journeyId} [${v.criticality}] "${v.title}" is ${v.state}` + (v.ownerStories.length > 0 ? ` (claimed by ${v.ownerStories.join(", ")} but never walked)` : " — NO story claims it"));
+								if (acceptanceModeCfg === "blocking") {
+									const verdict = violations.some((v) => v.state === "unclaimed") ? "journey-unclaimed" : "journey-unwalked";
+									logger$27.error({
+										storyKey,
+										epicId: epicIdA,
+										journeys: violations.map((v) => v.journeyId)
+									}, "A0.3: journey coverage violation at epic close — blocking finalization; branch preserved");
+									updateStory(storyKey, {
+										phase: "ESCALATED",
+										error: verdict,
+										completedAt: new Date().toISOString()
+									});
+									await emitEscalation({
+										storyKey,
+										lastVerdict: verdict,
+										reviewCycles: completedReviewCycles,
+										issues: [
+											`epic ${epicIdA} closes with ${String(violations.length)} journey coverage violation(s) — the never-wired-journey class:`,
+											...issueLines,
+											"Wire the journey in a story tagged with its id, or defer it explicitly: `substrate acceptance defer <id> --reason \"<why>\"` (commit the deferral file)."
+										]
+									});
+									await persistState();
+									return "terminal";
+								}
+								logger$27.warn({
+									storyKey,
+									epicId: epicIdA,
+									violations: issueLines
+								}, "A0.3 (advisory): journey coverage violations at epic close — not blocking (acceptance.mode: advisory)");
+							}
+						}
+					}
+				}
 				const epicGateCommand = config.epicGateCommand;
 				if (epicGateCommand !== void 0 && epicGateCommand.trim() !== "" && finalizationMode !== "branch") {
 					const epicOf = (key) => key.includes("-") ? key.slice(0, key.lastIndexOf("-")) : key;
@@ -18008,6 +18194,11 @@ function createImplementationOrchestrator(deps) {
 			} catch (err) {
 				logger$27.debug({ err }, "Profile staleness check failed (best-effort)");
 			}
+			try {
+				await auditJourneyCoverage({ final: true }, { persist: true });
+			} catch (err) {
+				logger$27.warn({ err }, "A0.3: run-end coverage sweep failed (best-effort)");
+			}
 			let completed = 0;
 			let escalated = 0;
 			let failed = 0;
@@ -46243,6 +46434,21 @@ function wireNdjsonEmitter(eventBus, ndjsonEmitter) {
 			...payload.prUrl !== void 0 ? { pr_url: payload.prUrl } : {}
 		});
 	});
+	eventBus.on("orchestrator:acceptance-coverage", (payload) => {
+		ndjsonEmitter.emit({
+			type: "acceptance:coverage",
+			ts: new Date().toISOString(),
+			scope: payload.scope,
+			mode: payload.mode,
+			entries: payload.entries.map((e) => ({
+				journeyId: e.journeyId,
+				criticality: e.criticality,
+				state: e.state,
+				ownerStories: e.ownerStories
+			})),
+			summary: payload.summary
+		});
+	});
 	eventBus.on("orchestrator:story-escalated", (payload) => {
 		const rawIssues = Array.isArray(payload.issues) ? payload.issues : [];
 		const issues = rawIssues.map((issue) => {
@@ -46575,6 +46781,7 @@ async function runRunAction(options) {
 	let configFinalizationMode;
 	let configMergeStrategy;
 	let configEpicGateCommand;
+	let configAcceptanceMode;
 	let configPermissionProfile;
 	let configWorktreeCopyFiles;
 	try {
@@ -46605,6 +46812,7 @@ async function runRunAction(options) {
 		if (cfg.finalization?.mode !== void 0) configFinalizationMode = cfg.finalization.mode;
 		if (cfg.finalization?.merge_strategy !== void 0) configMergeStrategy = cfg.finalization.merge_strategy;
 		if (cfg.finalization?.epic_gate_command !== void 0) configEpicGateCommand = cfg.finalization.epic_gate_command;
+		if (cfg.acceptance?.mode !== void 0) configAcceptanceMode = cfg.acceptance.mode;
 		if (cfg.dispatch?.permission_profile !== void 0) configPermissionProfile = cfg.dispatch.permission_profile;
 		if (Array.isArray(cfg.worktree?.copy_files) && cfg.worktree.copy_files.length > 0) {
 			configWorktreeCopyFiles = [...cfg.worktree.copy_files];
@@ -46708,6 +46916,7 @@ async function runRunAction(options) {
 		...finalization !== void 0 ? { finalizationMode: finalization } : configFinalizationMode !== void 0 ? { finalizationMode: configFinalizationMode } : {},
 		...configMergeStrategy !== void 0 ? { mergeStrategy: configMergeStrategy } : {},
 		...configEpicGateCommand !== void 0 ? { epicGateCommand: configEpicGateCommand } : {},
+		...configAcceptanceMode !== void 0 ? { acceptanceMode: configAcceptanceMode } : {},
 		...configPermissionProfile !== void 0 ? { permissionProfile: configPermissionProfile } : {},
 		...configWorktreeCopyFiles !== void 0 ? { worktreeCopyFiles: configWorktreeCopyFiles } : {}
 	});
@@ -47276,6 +47485,7 @@ async function runRunAction(options) {
 					...finalization !== void 0 ? { finalizationMode: finalization } : configFinalizationMode !== void 0 ? { finalizationMode: configFinalizationMode } : {},
 					...configMergeStrategy !== void 0 ? { mergeStrategy: configMergeStrategy } : {},
 					...configEpicGateCommand !== void 0 ? { epicGateCommand: configEpicGateCommand } : {},
+					...configAcceptanceMode !== void 0 ? { acceptanceMode: configAcceptanceMode } : {},
 					...configWorktreeCopyFiles !== void 0 ? { worktreeCopyFiles: configWorktreeCopyFiles } : {}
 				},
 				projectRoot,
@@ -47499,7 +47709,7 @@ async function runRunAction(options) {
 	}
 }
 async function runFullPipeline(options) {
-	const { packName, packPath, dbDir, dbPath, startPhase, stopAfter, concept, concurrency, outputFormat, projectRoot, events: eventsFlag, skipUx, research: researchFlag, skipResearch: skipResearchFlag, skipPreflight, skipVerification, maxReviewCycles = 2, retryBudget, registry: injectedRegistry, tokenCeilings, stories: explicitStories, telemetryEnabled: fullTelemetryEnabled, telemetryPort: fullTelemetryPort, agentId, meshUrl: fpMeshUrl, meshProjectId: fpMeshProjectId, engineType: fpEngineType, probeAuthor, probeAuthorStateIntegrating: fpProbeAuthorStateIntegrating, noWorktree, worktreeCopyFiles: fpWorktreeCopyFiles, finalizationMode: fpFinalizationMode, mergeStrategy: fpMergeStrategy, epicGateCommand: fpEpicGateCommand, permissionProfile: fpPermissionProfile } = options;
+	const { packName, packPath, dbDir, dbPath, startPhase, stopAfter, concept, concurrency, outputFormat, projectRoot, events: eventsFlag, skipUx, research: researchFlag, skipResearch: skipResearchFlag, skipPreflight, skipVerification, maxReviewCycles = 2, retryBudget, registry: injectedRegistry, tokenCeilings, stories: explicitStories, telemetryEnabled: fullTelemetryEnabled, telemetryPort: fullTelemetryPort, agentId, meshUrl: fpMeshUrl, meshProjectId: fpMeshProjectId, engineType: fpEngineType, probeAuthor, probeAuthorStateIntegrating: fpProbeAuthorStateIntegrating, noWorktree, worktreeCopyFiles: fpWorktreeCopyFiles, finalizationMode: fpFinalizationMode, mergeStrategy: fpMergeStrategy, epicGateCommand: fpEpicGateCommand, acceptanceMode: fpAcceptanceMode, permissionProfile: fpPermissionProfile } = options;
 	if (!existsSync$1(dbDir)) mkdirSync$1(dbDir, { recursive: true });
 	let doltServerFull = null;
 	try {
@@ -47815,6 +48025,7 @@ async function runFullPipeline(options) {
 						...fpFinalizationMode !== void 0 ? { finalizationMode: fpFinalizationMode } : {},
 						...fpMergeStrategy !== void 0 ? { mergeStrategy: fpMergeStrategy } : {},
 						...fpEpicGateCommand !== void 0 ? { epicGateCommand: fpEpicGateCommand } : {},
+						...fpAcceptanceMode !== void 0 ? { acceptanceMode: fpAcceptanceMode } : {},
 						...fpWorktreeCopyFiles !== void 0 ? { worktreeCopyFiles: fpWorktreeCopyFiles } : {}
 					},
 					projectRoot,
@@ -47985,7 +48196,7 @@ async function runFullPipeline(options) {
 */
 async function emitPreDispatchVersionAdvisory(currentVersion) {
 	if (process.env["SUBSTRATE_NO_UPDATE_CHECK"] === "1") return;
-	const { createVersionManager } = await import("./version-manager-impl-BVcsgUtN.js");
+	const { createVersionManager } = await import("./version-manager-impl-DeEPhQlA.js");
 	const vm = createVersionManager();
 	const result = await vm.checkForUpdates(true);
 	const gap = classifyVersionGap(currentVersion, result.latestVersion);
@@ -48092,4 +48303,4 @@ function registerRunCommand(program, version = "0.0.0", projectRoot = process.cw
 
 //#endregion
 export { AdapterTelemetryPersistence, AppError, DoltRepoMapMetaRepository, DoltSymbolRepository, ERR_REPO_MAP_STORAGE_WRITE, EpicIngester, GLOBSTAR$1 as GLOBSTAR, GitClient, GrammarLoader, Minimatch$1 as Minimatch, Minipass, RepoMapInjector, RepoMapModule, RepoMapQueryEngine, RepoMapStorage, SymbolParser, createContextCompiler, createDispatcher, createEventEmitter, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStopAfterGate, createTelemetryAdvisor, escape$1 as escape, formatPhaseCompletionSummary, getFactoryRunSummaries, getScenarioResultsForRun, getTwinRunsForRun, listGraphRuns, normalizeGraphSummaryToStatus, registerExportCommand, registerFactoryCommand, registerRunCommand, registerScenariosCommand, resolveMaxReviewCycles, resolveProbeAuthorStateIntegrating, resolveStoryKeys, runAnalysisPhase, runPlanningPhase, runProbeAuthor, runRunAction, runSolutioningPhase, unescape$1 as unescape, validateStopAfterFromConflict, wireNdjsonEmitter };
-//# sourceMappingURL=run-JrEnvaB0.js.map
+//# sourceMappingURL=run-ZxFHQyE_.js.map

package/dist/src/modules/recovery-engine/index.d.ts

@@ -1,4 +1,4 @@
-import { CoreEvents, DatabaseAdapter, TypedEventBus } from "../../../index-CnV5PcSR.js";
+import { CoreEvents, DatabaseAdapter, TypedEventBus } from "../../../index-C31XtSMn.js";
 import { z } from "zod";
 
 //#region packages/sdlc/dist/verification/findings.d.ts
@@ -582,6 +582,7 @@ declare const PerStoryStateSchema: z.ZodObject<{
   escalation_detail: z.ZodOptional<z.ZodString>;
   commit_sha: z.ZodOptional<z.ZodString>;
   baseline_sha: z.ZodOptional<z.ZodString>;
+  journeys: z.ZodOptional<z.ZodArray<z.ZodString>>;
   checkpoint_sha: z.ZodOptional<z.ZodString>;
   finalization: z.ZodOptional<z.ZodObject<{
     mode: z.ZodUnion<readonly [z.ZodLiteral<"merge">, z.ZodLiteral<"branch">, z.ZodLiteral<"pr">]>;
@@ -717,6 +718,19 @@ interface RunManifestData {
    * Optional for backward-compatibility with pre-75-2 manifests.
    */
   orchestrator_start_branch?: string;
+  /**
+   * A0.3 (acceptance-gate): journey coverage ledger from the most recent
+   * audit (epic-close or run-end). Absent on registry-less projects and
+   * pre-A0.3 manifests.
+   */
+  journeys?: {
+    journeyId: string;
+    title: string;
+    criticality: 'critical' | 'standard';
+    epic?: number;
+    state: 'walked-pass' | 'walked-fail' | 'deferred' | 'unclaimed' | 'unwalked';
+    ownerStories: string[];
+  }[];
   /**
    * Human-readable reason the run was stopped (e.g. 'killed_by_user').
    * Set by the SIGTERM/SIGINT handler (Story 58-7). Absent on pre-58-7 manifests.
@@ -751,8 +765,8 @@ declare const CliFlagsSchema: z.ZodObject<{
   stories: z.ZodOptional<z.ZodArray<z.ZodString>>;
   halt_on: z.ZodOptional<z.ZodEnum<{
     none: "none";
-    all: "all";
     critical: "critical";
+    all: "all";
   }>>;
   cost_ceiling: z.ZodOptional<z.ZodNumber>;
   agent: z.ZodOptional<z.ZodString>;

package/dist/{upgrade-S1oUMH5P.js → upgrade-BUSzXgnd.js}

@@ -1,4 +1,4 @@
-import { createVersionManager } from "./dist-BkhYgJWo.js";
+import { createVersionManager } from "./dist-CpnLJuVw.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-S1oUMH5P.js.map
+//# sourceMappingURL=upgrade-BUSzXgnd.js.map

package/dist/{upgrade-BOWLlLbD.js → upgrade-M0UkDCeg.js}

@@ -1,5 +1,5 @@
-import "./dist-BkhYgJWo.js";
+import "./dist-CpnLJuVw.js";
 import "./version-manager-impl-qFBiO4Eh.js";
-import { isGlobalInstall, registerUpgradeCommand, runUpgradeCommand } from "./upgrade-S1oUMH5P.js";
+import { isGlobalInstall, registerUpgradeCommand, runUpgradeCommand } from "./upgrade-BUSzXgnd.js";
 
 export { isGlobalInstall, registerUpgradeCommand, runUpgradeCommand };

package/dist/{version-manager-impl-BVcsgUtN.js → version-manager-impl-DeEPhQlA.js}

@@ -1,4 +1,4 @@
-import { VersionManagerImpl, createVersionManager } from "./dist-BkhYgJWo.js";
+import { VersionManagerImpl, createVersionManager } from "./dist-CpnLJuVw.js";
 import "./version-manager-impl-qFBiO4Eh.js";
 
 export { createVersionManager };

package/package.json

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

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

@@ -191,6 +191,28 @@ Suggested values (use as many as apply):
 
 **Omit the field (or leave it empty) only for purely-algorithmic modules** where you also omit `## Runtime Probes` — parse/format/sort/score/calculate transforms, type-only refactors, documentation edits, build-config changes, and unit-test-only stories.
 
+### Journey tags (acceptance gate)
+
+This project's journey registry (empty when the project has none):
+
+{{journey_registry}}
+
+If the registry above is non-empty, decide which journeys this story's acceptance criteria deliver or materially advance, and declare them in the SAME YAML frontmatter block at the top of the story file:
+
+```text
+---
+external_state_dependencies:
+  - subprocess
+journeys:
+  - UJ-2
+---
+```
+
+Rules:
+- Use ONLY journey ids that appear in the registry above — an unknown id fails the story artifact's schema validation.
+- Tag a journey when the story wires, extends, or completes any part of that journey's user-facing path — not merely because it touches nearby code.
+- If no registered journey applies (or the registry above is empty), OMIT the `journeys:` field entirely. Untagged stories are legal; unclaimed journeys are audited separately at epic close.
+
 ### Probe YAML shape
 
 Declare probes as a YAML list inside a single fenced `yaml` block directly under the `## Runtime Probes` heading. Each entry has this shape:

package/dist/adapter-registry-CZn__637.js

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