substrate-ai 0.20.146 → 0.20.148

package/dist/adapter-registry-hLwwiJGM.js

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

package/dist/cli/index.js

@@ -1,20 +1,20 @@
 #!/usr/bin/env node
-import { FileKvStore, SUBSTRATE_OWNED_SETTINGS_KEYS, VALID_PHASES, buildPipelineStatusOutput, createDatabaseAdapter, createDoltOperatorReader, findPackageRoot, formatOutput, formatPipelineStatusHuman, formatPipelineSummary, formatTokenTelemetry, getAllDescendantPids, getAutoHealthData, getSubstrateDefaultSettings, inspectProcessTree, parseDbTimestampAsUtc, registerHealthCommand, resolveBmadMethodSrcPath, resolveBmadMethodVersion } from "../health-eGHKiGlU.js";
+import { FileKvStore, SUBSTRATE_OWNED_SETTINGS_KEYS, VALID_PHASES, buildPipelineStatusOutput, createDatabaseAdapter, createDoltOperatorReader, findPackageRoot, formatOutput, formatPipelineStatusHuman, formatPipelineSummary, formatTokenTelemetry, getAllDescendantPids, getAutoHealthData, getSubstrateDefaultSettings, inspectProcessTree, parseDbTimestampAsUtc, registerHealthCommand, resolveBmadMethodSrcPath, resolveBmadMethodVersion } from "../health-Aqc5cghP.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, InMemoryDatabaseAdapter, IngestionServer, MonitorDatabaseImpl, OPERATIONAL_FINDING, PartialGlobalSettingsSchema, PartialProviderConfigSchema, ProvidersSchema, RoutingRecommender, STORY_METRICS, TelemetryConfigSchema, addTokenUsage, aggregateTokenUsageForRun, checkDoltInstalled, compareRunMetrics, createAmendmentRun, createConfigSystem, createDecision, createPipelineRun, createStderrLogger, getActiveDecisions, getAllCostEntriesFiltered, getBaselineRunMetrics, getDecisionsByCategory, getDecisionsByPhaseForRun, getLatestCompletedRun, getLatestRun, getPipelineRunById, getPlanningCostTotal, getRetryableEscalations, getRunMetrics, getRunningPipelineRuns, getSessionCostSummary, getSessionCostSummaryFiltered, getStoryMetricsForRun, getTokenUsageSummary, incrementRunRestarts, initSchema, initWorkGraphSchema, initializeDolt, listRunMetrics, loadParentRunDecisions, supersedeDecision, swallowDebug, tagRunAsBaseline, updatePipelineRun } from "../dist-D2mJXElX.js";
-import { AdapterTelemetryPersistence, AppError, DoltRepoMapMetaRepository, DoltSymbolRepository, ERR_REPO_MAP_STORAGE_WRITE, EpicIngester, GLOBSTAR, GitClient, GrammarLoader, Minimatch, Minipass, RepoMapInjector, RepoMapModule, RepoMapQueryEngine, RepoMapStorage, SymbolParser, createContextCompiler, createDispatcher, createEventEmitter, createGitWorktreeManager, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStopAfterGate, createTelemetryAdvisor, escape, formatPhaseCompletionSummary, getFactoryRunSummaries, getScenarioResultsForRun, getTwinRunsForRun, listGraphRuns, registerExportCommand, registerFactoryCommand, registerRunCommand, registerScenariosCommand, resolveStoryKeys, runAnalysisPhase, runPlanningPhase, runProbeAuthor, runSolutioningPhase, unescape, validateStopAfterFromConflict } from "../run-BhoAW6dJ.js";
+import { AdapterRegistry, BudgetConfigSchema, CURRENT_CONFIG_FORMAT_VERSION, CURRENT_TASK_GRAPH_VERSION, ConfigError, CostTrackerConfigSchema, DEFAULT_CONFIG, DoltClient, DoltNotInstalled, GlobalSettingsSchema, InMemoryDatabaseAdapter, IngestionServer, MonitorDatabaseImpl, OPERATIONAL_FINDING, PartialGlobalSettingsSchema, PartialProviderConfigSchema, ProvidersSchema, RoutingRecommender, STORY_METRICS, TelemetryConfigSchema, addTokenUsage, aggregateTokenUsageForRun, checkDoltInstalled, compareRunMetrics, createAmendmentRun, createConfigSystem, createDecision, createPipelineRun, createStderrLogger, getActiveDecisions, getAllCostEntriesFiltered, getBaselineRunMetrics, getDecisionsByCategory, getDecisionsByPhaseForRun, getLatestCompletedRun, getLatestRun, getPipelineRunById, getPlanningCostTotal, getRetryableEscalations, getRunMetrics, getRunningPipelineRuns, getSessionCostSummary, getSessionCostSummaryFiltered, getStoryMetricsForRun, getTokenUsageSummary, incrementRunRestarts, initSchema, initWorkGraphSchema, initializeDolt, listRunMetrics, loadParentRunDecisions, supersedeDecision, swallowDebug, tagRunAsBaseline, updatePipelineRun } from "../dist-CZk5SeSt.js";
+import { AdapterTelemetryPersistence, AppError, DoltRepoMapMetaRepository, DoltSymbolRepository, ERR_REPO_MAP_STORAGE_WRITE, EpicIngester, GLOBSTAR, GitClient, GrammarLoader, Minimatch, Minipass, RepoMapInjector, RepoMapModule, RepoMapQueryEngine, RepoMapStorage, SymbolParser, createContextCompiler, createDispatcher, createEventEmitter, createGitWorktreeManager, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStopAfterGate, createTelemetryAdvisor, escape, formatPhaseCompletionSummary, getFactoryRunSummaries, getScenarioResultsForRun, getTwinRunsForRun, listGraphRuns, registerExportCommand, registerFactoryCommand, registerRunCommand, registerScenariosCommand, resolveStoryKeys, runAnalysisPhase, runPlanningPhase, runProbeAuthor, runSolutioningPhase, unescape, validateStopAfterFromConflict } from "../run-B9DV9sro.js";
 import "../adapter-registry-DIcrxjH8.js";
-import { RunManifest, SupervisorLock, ZERO_FINDINGS_BY_AUTHOR, ZERO_FINDING_COUNTS, ZERO_PROBE_AUTHOR_METRICS, aggregateProbeAuthorMetrics, parseRuntimeProbes, readCurrentRunId, resolveMainRepoRoot, resolveRunManifest, rollupFindingCounts, rollupFindingsByAuthor, rollupProbeAuthorByClass, rollupProbeAuthorMetrics, runAcTraceabilityCheck } from "../manifest-read-7kyDfQAK.js";
-import "../errors-CIBnPmzQ.js";
+import { RunManifest, SupervisorLock, ZERO_FINDINGS_BY_AUTHOR, ZERO_FINDING_COUNTS, ZERO_PROBE_AUTHOR_METRICS, aggregateProbeAuthorMetrics, parseRuntimeProbes, readCurrentRunId, resolveMainRepoRoot, resolveRunManifest, rollupFindingCounts, rollupFindingsByAuthor, rollupProbeAuthorByClass, rollupProbeAuthorMetrics, runAcTraceabilityCheck } from "../manifest-read-D6NAZgt8.js";
+import "../errors-_tbIg6Cv.js";
 import "../routing-DFxoKHDt.js";
 import { WorkGraphRepository } from "../work-graph-repository-DZyJv5pV.js";
 import "../decisions-CzSIEeGP.js";
 import "../decision-router-BAPpON_C.js";
-import "../interactive-prompt-opOBwMDU.js";
+import "../interactive-prompt-BLkX0iE_.js";
 import "../recovery-engine-BKGBeBnW.js";
 import "../version-manager-impl-qFBiO4Eh.js";
-import { registerUpgradeCommand } from "../upgrade-Djo0dJak.js";
+import { registerUpgradeCommand } from "../upgrade-BEfZJU4K.js";
 import { Command } from "commander";
 import { fileURLToPath } from "url";
 import { dirname, join, resolve } from "path";
@@ -623,7 +623,16 @@ const SubstrateConfigSchema = z.object({
 	default_agent: z.string().optional(),
 	supervisor_poll_interval_seconds: z.number().int().positive().optional(),
 	retry_budget: z.number().int().positive().optional(),
-	epics_path: z.string().optional()
+	epics_path: z.string().optional(),
+	finalization: z.object({
+		mode: z.enum([
+			"merge",
+			"branch",
+			"pr"
+		]).optional(),
+		merge_strategy: z.enum(["ff-only", "three-way"]).optional(),
+		epic_gate_command: z.string().optional()
+	}).strict().optional()
 }).strict();
 const PartialSubstrateConfigSchema = z.object({
 	config_format_version: z.enum(["1"]).optional(),
@@ -642,7 +651,16 @@ const PartialSubstrateConfigSchema = z.object({
 	default_agent: z.string().optional(),
 	supervisor_poll_interval_seconds: z.number().int().positive().optional(),
 	retry_budget: z.number().int().positive().optional(),
-	epics_path: z.string().optional()
+	epics_path: z.string().optional(),
+	finalization: z.object({
+		mode: z.enum([
+			"merge",
+			"branch",
+			"pr"
+		]).optional(),
+		merge_strategy: z.enum(["ff-only", "three-way"]).optional(),
+		epic_gate_command: z.string().optional()
+	}).strict().optional()
 }).strict();
 
 //#endregion
@@ -7052,7 +7070,7 @@ async function runStatusAction(options) {
 			logger$15.debug({ err }, "Work graph query failed, continuing without work graph data");
 		}
 		if (run === void 0) {
-			const { inspectProcessTree: inspectProcessTree$1 } = await import("../health-RQmFEmIC.js");
+			const { inspectProcessTree: inspectProcessTree$1 } = await import("../health-Cm0aQCQL.js");
 			const substrateDirPath = join(projectRoot, ".substrate");
 			const processInfo = inspectProcessTree$1({
 				projectRoot,
@@ -8000,7 +8018,7 @@ function defaultSupervisorDeps() {
 				if (cached === null) {
 					const { AdapterRegistry: AR } = await import(
 						/* @vite-ignore */
-						"../adapter-registry-BPwWmPjJ.js"
+						"../adapter-registry-hLwwiJGM.js"
 );
 					cached = new AR();
 					await cached.discoverAndRegister();
@@ -8567,11 +8585,11 @@ async function runSupervisorAction(options, deps = {}) {
 						try {
 							const { createExperimenter } = await import(
 								/* @vite-ignore */
-								"../experimenter-BZ17IbjW.js"
+								"../experimenter-RnaEiLUD.js"
 );
 							const { getLatestRun: getLatest } = await import(
 								/* @vite-ignore */
-								"../decisions-D_HEApFV.js"
+								"../decisions-DSDqOEN4.js"
 );
 							const expAdapter = createDatabaseAdapter({
 								backend: "auto",
@@ -8581,7 +8599,7 @@ async function runSupervisorAction(options, deps = {}) {
 								await initSchema(expAdapter);
 								const { runRunAction: runPipeline } = await import(
 									/* @vite-ignore */
-									"../run-CJHnHg3o.js"
+									"../run-BX-__EJm.js"
 );
 								const runStoryFn = async (opts) => {
 									const exitCode = await runPipeline({
@@ -9106,7 +9124,7 @@ async function runMetricsAction(options) {
 			const routingConfigPath = join(dbDir, "routing.yml");
 			let routingConfig = null;
 			if (existsSync$1(routingConfigPath)) try {
-				const { loadModelRoutingConfig } = await import("../routing-CLVK4nBN.js");
+				const { loadModelRoutingConfig } = await import("../routing-QBUaShFv.js");
 				routingConfig = loadModelRoutingConfig(routingConfigPath);
 			} catch {}
 			if (routingConfig === null) routingConfig = {
@@ -12972,6 +12990,17 @@ function renderHuman(output, manifest) {
 		], COL_WIDTHS));
 	}
 	lines.push("");
+	const unmerged = stories.filter((s) => s.finalization !== void 0 && s.finalization.mode !== "merge");
+	if (unmerged.length > 0) {
+		lines.push("Finalization (deliverable branches — NOT merged):");
+		for (const s of unmerged) {
+			const fz = s.finalization ?? {};
+			const shaStr = fz.sha ? ` @ ${fz.sha.slice(0, 10)}` : "";
+			const prStr = fz.mode === "pr" ? fz.pr_url ? `  PR: ${fz.pr_url}` : "  PR: creation failed — degraded to branch" : "";
+			lines.push(`  ${s.story_key}: [${fz.mode ?? "?"}] ${fz.branch ?? "?"}${shaStr}${prStr}`);
+		}
+		lines.push("");
+	}
 	const lowOutputStories = stories.filter((s) => s.low_output_warning === true);
 	if (lowOutputStories.length > 0) {
 		lines.push(`⚠ ${lowOutputStories.length} story/stories produced fewer than ${LOW_OUTPUT_TOKEN_THRESHOLD} output tokens —`);
@@ -13104,7 +13133,8 @@ function assembleReport(runId, manifest, halts, storyOutputTokens) {
 			verification_findings: findings,
 			verification_ran: verificationRan,
 			...outputTokens !== void 0 ? { output_tokens: outputTokens } : {},
-			...lowOutputWarning ? { low_output_warning: true } : {}
+			...lowOutputWarning ? { low_output_warning: true } : {},
+			...state.finalization !== void 0 ? { finalization: state.finalization } : {}
 		};
 		stories.push(storySummary);
 		summary[outcome]++;
@@ -13420,8 +13450,8 @@ async function createProgram() {
 /** Fire-and-forget startup version check (story 8.3, AC3/AC5) */
 function checkForUpdatesInBackground(currentVersion) {
 	if (process.env.SUBSTRATE_NO_UPDATE_CHECK === "1") return;
-	import("../upgrade-DnB0p8b5.js").then(async () => {
-		const { createVersionManager } = await import("../version-manager-impl-CKsauG6T.js");
+	import("../upgrade-emlrK3YW.js").then(async () => {
+		const { createVersionManager } = await import("../version-manager-impl-_x1n4xZk.js");
 		const vm = createVersionManager();
 		const result = await vm.checkForUpdates();
 		if (result.updateAvailable) {

package/dist/{decisions-D_HEApFV.js → decisions-DSDqOEN4.js}

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

package/dist/{dist-D2mJXElX.js → dist-CZk5SeSt.js}

@@ -6251,7 +6251,16 @@ const SubstrateConfigSchema = z.object({
 	budget: BudgetConfigSchema.optional(),
 	telemetry: TelemetryConfigSchema.optional(),
 	worktree: WorktreeConfigSchema.optional(),
-	trivialOutputThreshold: z.number().int().nonnegative().optional()
+	trivialOutputThreshold: z.number().int().nonnegative().optional(),
+	finalization: z.object({
+		mode: z.enum([
+			"merge",
+			"branch",
+			"pr"
+		]).optional(),
+		merge_strategy: z.enum(["ff-only", "three-way"]).optional(),
+		epic_gate_command: z.string().optional()
+	}).strict().optional()
 }).passthrough();
 const PartialProviderConfigSchema = ProviderConfigSchema.partial();
 const PartialGlobalSettingsSchema = GlobalSettingsSchema.partial();
@@ -6268,7 +6277,16 @@ const PartialSubstrateConfigSchema = z.object({
 	budget: BudgetConfigSchema.partial().optional(),
 	telemetry: TelemetryConfigSchema.partial().optional(),
 	worktree: WorktreeConfigSchema.partial().optional(),
-	trivialOutputThreshold: z.number().int().nonnegative().optional()
+	trivialOutputThreshold: z.number().int().nonnegative().optional(),
+	finalization: z.object({
+		mode: z.enum([
+			"merge",
+			"branch",
+			"pr"
+		]).optional(),
+		merge_strategy: z.enum(["ff-only", "three-way"]).optional(),
+		epic_gate_command: z.string().optional()
+	}).strict().optional()
 }).passthrough();
 
 //#endregion
@@ -11636,4 +11654,4 @@ async function callLLM(params) {
 
 //#endregion
 export { ADVISORY_NOTES, AdapterRegistry, AdtError, BudgetConfigSchema, CLAUDE_AUTH_FAILURE_HINT, CODEX_SANDBOX_BLOCK_HINT, CURRENT_CONFIG_FORMAT_VERSION, CURRENT_TASK_GRAPH_VERSION, Categorizer, ClaudeCodeAdapter, CodexCLIAdapter, ConfigError, ConfigIncompatibleFormatError, ConsumerAnalyzer, CostTrackerConfigSchema, DEFAULT_CONFIG, DEFAULT_GLOBAL_SETTINGS, DispatcherImpl, DoltClient, DoltNotInstalled, DoltQueryError, ESCALATION_DIAGNOSIS, EXPERIMENT_RESULT, EfficiencyScorer, GeminiCLIAdapter, GlobalSettingsSchema, InMemoryDatabaseAdapter, IngestionServer, LEARNING_FINDING, LogTurnAnalyzer, ModelRoutingConfigSchema, MonitorDatabaseImpl, OPERATIONAL_FINDING, PartialGlobalSettingsSchema, PartialProviderConfigSchema, ProviderPolicySchema, ProvidersSchema, Recommender, RoutingConfigError, RoutingRecommender, RoutingResolver, RoutingTelemetry, RoutingTokenAccumulator, RoutingTuner, STORY_METRICS, STORY_OUTCOME, SubstrateConfigSchema, TASK_TYPE_PHASE_MAP, TEST_EXPANSION_FINDING, TEST_PLAN, TelemetryConfigSchema, TelemetryNormalizer, TelemetryPipeline, TurnAnalyzer, VersionManagerImpl, addTokenUsage, aggregateTokenUsageForRun, aggregateTokenUsageForStory, buildAuditLogEntry, buildBranchName, buildModificationDirective, buildPRBody, buildWorktreePath, callLLM, checkDoltInstalled, classifyVersionGap, compareRunMetrics, createAmendmentRun, createConfigSystem, createDatabaseAdapter as createDatabaseAdapter$1, createDecision, createExperimenter, createPipelineRun, createRequirement, createStderrLogger, createVersionManager, detectClaudeAuthFailure, detectCodexSandboxBlock, detectInterfaceChanges, determineVerdict, getActiveDecisions, getAllCostEntriesFiltered, getArtifactByTypeForRun, getArtifactsByRun, getBaselineRunMetrics, getDecisionsByCategory, getDecisionsByPhase, getDecisionsByPhaseForRun, getLatestCompletedRun, getLatestRun, getModelTier, getPipelineRunById, getPlanningCostTotal, getRetryableEscalations, getRunMetrics, getRunningPipelineRuns, getSessionCostSummary, getSessionCostSummaryFiltered, getStoryMetricsForRun, getTokenUsageSummary, incrementRunRestarts, initSchema, initWorkGraphSchema, initializeDolt, listRequirements, listRunMetrics, loadModelRoutingConfig, loadParentRunDecisions, registerArtifact, resolvePromptFile, supersedeDecision, swallowDebug, tagRunAsBaseline, updateDecision, updatePipelineRun, updatePipelineRunConfig, upsertDecision, writeRunMetrics, writeStoryMetrics };
-//# sourceMappingURL=dist-D2mJXElX.js.map
+//# sourceMappingURL=dist-CZk5SeSt.js.map

package/dist/{errors-CIBnPmzQ.js → errors-_tbIg6Cv.js}

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

package/dist/{experimenter-BZ17IbjW.js → experimenter-RnaEiLUD.js}

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

package/dist/{health-eGHKiGlU.js → health-Aqc5cghP.js}

@@ -1,6 +1,6 @@
 import { createLogger } from "./logger-KeHncl-f.js";
-import { DoltClient, DoltQueryError, createDatabaseAdapter$1 as createDatabaseAdapter, getLatestRun, getPipelineRunById, initSchema } from "./dist-D2mJXElX.js";
-import { resolveMainRepoRoot, resolveRunManifest } from "./manifest-read-7kyDfQAK.js";
+import { DoltClient, DoltQueryError, createDatabaseAdapter$1 as createDatabaseAdapter, getLatestRun, getPipelineRunById, initSchema } from "./dist-CZk5SeSt.js";
+import { resolveMainRepoRoot, resolveRunManifest } from "./manifest-read-D6NAZgt8.js";
 import { createRequire } from "module";
 import { dirname, join } from "path";
 import { existsSync, readFileSync } from "node:fs";
@@ -1000,4 +1000,4 @@ function registerHealthCommand(program, _version = "0.0.0", projectRoot = proces
 
 //#endregion
 export { BMAD_BASELINE_TOKENS_FULL, DEFAULT_STALL_THRESHOLD_SECONDS, FileKvStore, STOP_AFTER_VALID_PHASES, STORY_KEY_PATTERN, SUBSTRATE_OWNED_SETTINGS_KEYS, VALID_PHASES, __commonJS, __require, __toESM, buildPipelineStatusOutput, createDatabaseAdapter$1 as createDatabaseAdapter, createDoltOperatorReader, findPackageRoot, formatOutput, formatPipelineStatusHuman, formatPipelineSummary, formatTokenTelemetry, getAllDescendantPids, getAutoHealthData, getSubstrateDefaultSettings, inspectProcessTree, isOrchestratorProcessLine, parseDbTimestampAsUtc, registerHealthCommand, resolveBmadMethodSrcPath, resolveBmadMethodVersion, runHealthAction, validateStoryKey };
-//# sourceMappingURL=health-eGHKiGlU.js.map
+//# sourceMappingURL=health-Aqc5cghP.js.map

package/dist/{health-RQmFEmIC.js → health-Cm0aQCQL.js}

@@ -1,7 +1,7 @@
-import { DEFAULT_STALL_THRESHOLD_SECONDS, getAllDescendantPids, getAutoHealthData, inspectProcessTree, isOrchestratorProcessLine, registerHealthCommand, runHealthAction } from "./health-eGHKiGlU.js";
+import { DEFAULT_STALL_THRESHOLD_SECONDS, getAllDescendantPids, getAutoHealthData, inspectProcessTree, isOrchestratorProcessLine, registerHealthCommand, runHealthAction } from "./health-Aqc5cghP.js";
 import "./logger-KeHncl-f.js";
-import "./dist-D2mJXElX.js";
-import "./manifest-read-7kyDfQAK.js";
+import "./dist-CZk5SeSt.js";
+import "./manifest-read-D6NAZgt8.js";
 import "./work-graph-repository-DZyJv5pV.js";
 import "./decisions-CzSIEeGP.js";
 

package/dist/{index-BqVBOAO0.d.ts → index-CvNLhgKV.d.ts}

@@ -292,6 +292,18 @@ declare const SubstrateConfigSchema: z.ZodObject<{
     copy_files: z.ZodDefault<z.ZodArray<z.ZodString>>;
   }, z.core.$strict>>;
   trivialOutputThreshold: z.ZodOptional<z.ZodNumber>;
+  finalization: z.ZodOptional<z.ZodObject<{
+    mode: z.ZodOptional<z.ZodEnum<{
+      merge: "merge";
+      branch: "branch";
+      pr: "pr";
+    }>>;
+    merge_strategy: z.ZodOptional<z.ZodEnum<{
+      "ff-only": "ff-only";
+      "three-way": "three-way";
+    }>>;
+    epic_gate_command: z.ZodOptional<z.ZodString>;
+  }, z.core.$strict>>;
 }, z.core.$loose>;
 type SubstrateConfig = z.infer<typeof SubstrateConfigSchema>; //#endregion
 //#region packages/core/dist/events/core-events.d.ts
@@ -1584,4 +1596,4 @@ interface Recommendation {
 
 //#endregion
 export { AdapterDiscoveryResult, AdapterRegistry as AdapterRegistry$1, AdtError as AdtError$1, ClaudeCodeAdapter as ClaudeCodeAdapter$1, CodexCLIAdapter as CodexCLIAdapter$1, ConfigError as ConfigError$1, ConfigIncompatibleFormatError as ConfigIncompatibleFormatError$1, CoreEvents, DatabaseAdapter, DiscoveryReport, GeminiCLIAdapter as GeminiCLIAdapter$1, Recommendation, TypedEventBus };
-//# sourceMappingURL=index-BqVBOAO0.d.ts.map
+//# sourceMappingURL=index-CvNLhgKV.d.ts.map

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { AdapterDiscoveryResult, AdapterRegistry$1 as AdapterRegistry, AdtError$1 as AdtError, ClaudeCodeAdapter$1 as ClaudeCodeAdapter, CodexCLIAdapter$1 as CodexCLIAdapter, ConfigError$1 as ConfigError, ConfigIncompatibleFormatError$1 as ConfigIncompatibleFormatError, DiscoveryReport, GeminiCLIAdapter$1 as GeminiCLIAdapter, Recommendation, TypedEventBus } from "./index-BqVBOAO0.js";
+import { AdapterDiscoveryResult, AdapterRegistry$1 as AdapterRegistry, AdtError$1 as AdtError, ClaudeCodeAdapter$1 as ClaudeCodeAdapter, CodexCLIAdapter$1 as CodexCLIAdapter, ConfigError$1 as ConfigError, ConfigIncompatibleFormatError$1 as ConfigIncompatibleFormatError, DiscoveryReport, GeminiCLIAdapter$1 as GeminiCLIAdapter, Recommendation, TypedEventBus } from "./index-CvNLhgKV.js";
 import pino from "pino";
 import { z } from "zod";
 import { Readable, Writable } from "node:stream";
@@ -150,6 +150,59 @@ interface StoryDoneEvent {
   /** Number of review cycles completed */
   review_cycles: number;
 }
+/**
+ * Emitted when a story's verified work has been committed on its branch
+ * (the `feat(story-…)` auto-commit). Fires in every finalization mode,
+ * BEFORE any integration step.
+ */
+interface StoryCommittedEvent {
+  type: 'story:committed';
+  /** ISO-8601 timestamp generated at emit time */
+  ts: string;
+  /** Story key (e.g., "10-1") */
+  key: string;
+  /** Commit SHA of the deliverable commit */
+  sha: string;
+  /** Story branch the commit lives on (substrate/story-<key>) */
+  branch: string;
+}
+/**
+ * Emitted when a story branch was merged into the start branch.
+ * Only fires in `merge` finalization mode.
+ */
+interface StoryMergedEvent {
+  type: 'story:merged';
+  /** ISO-8601 timestamp generated at emit time */
+  ts: string;
+  /** Story key (e.g., "10-1") */
+  key: string;
+  /** Commit SHA of the deliverable commit that was merged */
+  sha: string;
+  /** Story branch that was merged */
+  branch: string;
+}
+/**
+ * Emitted when a story's finalization completed, in every mode. For `merge`
+ * this follows story:merged; for `branch`/`pr` the branch itself is the
+ * deliverable and nothing was self-merged. A `pr`-mode event WITHOUT
+ * `pr_url` means PR creation failed and finalization degraded to branch
+ * semantics (the branch is intact locally).
+ */
+interface StoryFinalizedEvent {
+  type: 'story:finalized';
+  /** ISO-8601 timestamp generated at emit time */
+  ts: string;
+  /** Story key (e.g., "10-1") */
+  key: string;
+  /** Finalization mode that was applied */
+  mode: 'merge' | 'branch' | 'pr';
+  /** Story branch carrying the deliverable */
+  branch: string;
+  /** Commit SHA of the deliverable commit */
+  sha: string;
+  /** PR URL (pr mode, only when gh pr create succeeded) */
+  pr_url?: string;
+}
 /**
  * Emitted when the orchestrator auto-approves a story after exhausting
  * review cycles with only minor issues remaining. Provides transparency
@@ -783,7 +836,7 @@ interface PipelineMergeConflictDetectedEvent {
  * }
  * ```
  */
-type PipelineEvent = PipelineStartEvent | PipelineCompleteEvent | PipelinePreFlightFailureEvent | PipelineProfileStaleEvent | PipelineContractMismatchEvent | PipelineContractVerificationSummaryEvent | StoryPhaseEvent | StoryDoneEvent | StoryEscalationEvent | StoryWarnEvent | StoryLogEvent | PipelineHeartbeatEvent | StoryStallEvent | StoryZeroDiffEscalationEvent | StoryBuildVerificationFailedEvent | StoryBuildVerificationPassedEvent | StoryInterfaceChangeWarningEvent | StoryMetricsEvent | SupervisorPollEvent | SupervisorKillEvent | SupervisorRestartEvent | SupervisorAbortEvent | SupervisorSummaryEvent | SupervisorAnalysisCompleteEvent | SupervisorAnalysisErrorEvent | SupervisorExperimentStartEvent | SupervisorExperimentSkipEvent | SupervisorExperimentRecommendationsEvent | SupervisorExperimentCompleteEvent | SupervisorExperimentErrorEvent | RoutingModelSelectedEvent | PipelinePhaseStartEvent | PipelinePhaseCompleteEvent | StoryAutoApprovedEvent | VerificationCheckCompleteEvent | VerificationStoryCompleteEvent | CostWarningEvent | CostCeilingReachedEvent | DecisionHaltSkippedNonInteractiveEvent | PipelineMergeConflictDetectedEvent; //#endregion
+type PipelineEvent = PipelineStartEvent | PipelineCompleteEvent | PipelinePreFlightFailureEvent | PipelineProfileStaleEvent | PipelineContractMismatchEvent | PipelineContractVerificationSummaryEvent | StoryPhaseEvent | StoryDoneEvent | StoryCommittedEvent | StoryMergedEvent | StoryFinalizedEvent | StoryEscalationEvent | StoryWarnEvent | StoryLogEvent | PipelineHeartbeatEvent | StoryStallEvent | StoryZeroDiffEscalationEvent | StoryBuildVerificationFailedEvent | StoryBuildVerificationPassedEvent | StoryInterfaceChangeWarningEvent | StoryMetricsEvent | SupervisorPollEvent | SupervisorKillEvent | SupervisorRestartEvent | SupervisorAbortEvent | SupervisorSummaryEvent | SupervisorAnalysisCompleteEvent | SupervisorAnalysisErrorEvent | SupervisorExperimentStartEvent | SupervisorExperimentSkipEvent | SupervisorExperimentRecommendationsEvent | SupervisorExperimentCompleteEvent | SupervisorExperimentErrorEvent | RoutingModelSelectedEvent | PipelinePhaseStartEvent | PipelinePhaseCompleteEvent | StoryAutoApprovedEvent | VerificationCheckCompleteEvent | VerificationStoryCompleteEvent | CostWarningEvent | CostCeilingReachedEvent | DecisionHaltSkippedNonInteractiveEvent | PipelineMergeConflictDetectedEvent; //#endregion
 //#region src/core/errors.d.ts
 
 /**
@@ -1015,6 +1068,18 @@ declare const SubstrateConfigSchema: z.ZodObject<{
   supervisor_poll_interval_seconds: z.ZodOptional<z.ZodNumber>;
   retry_budget: z.ZodOptional<z.ZodNumber>;
   epics_path: z.ZodOptional<z.ZodString>;
+  finalization: z.ZodOptional<z.ZodObject<{
+    mode: z.ZodOptional<z.ZodEnum<{
+      merge: "merge";
+      branch: "branch";
+      pr: "pr";
+    }>>;
+    merge_strategy: z.ZodOptional<z.ZodEnum<{
+      "ff-only": "ff-only";
+      "three-way": "three-way";
+    }>>;
+    epic_gate_command: z.ZodOptional<z.ZodString>;
+  }, z.core.$strict>>;
 }, z.core.$strict>;
 type SubstrateConfig = z.infer<typeof SubstrateConfigSchema>;
 
@@ -1399,6 +1464,26 @@ interface OrchestratorEvents {
     storyKey: string;
     reviewCycles: number;
   };
+  /** H3.2: substrate committed story work to its branch (deliverable feat commit) */
+  'orchestrator:story-committed': {
+    storyKey: string;
+    sha: string;
+    branch: string;
+  };
+  /** H3.2: a story branch merged into the start branch */
+  'orchestrator:story-merged': {
+    storyKey: string;
+    sha: string;
+    branch: string;
+  };
+  /** H3.2: terminal integration state for a verified story — never inferred from worktree presence again (field finding #14) */
+  'orchestrator:story-finalized': {
+    storyKey: string;
+    mode: 'merge' | 'branch' | 'pr';
+    branch: string;
+    sha: string;
+    prUrl?: string;
+  };
   /** A story has been escalated after exceeding max review cycles */
   'orchestrator:story-escalated': {
     storyKey: string;

package/dist/index.js

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

package/dist/{interactive-prompt-opOBwMDU.js → interactive-prompt-BLkX0iE_.js}

@@ -1,5 +1,5 @@
 import { createLogger } from "./logger-KeHncl-f.js";
-import { readCurrentRunId, resolveMainRepoRoot } from "./manifest-read-7kyDfQAK.js";
+import { readCurrentRunId, resolveMainRepoRoot } from "./manifest-read-D6NAZgt8.js";
 import { join } from "node:path";
 import { mkdir, readFile, writeFile } from "node:fs/promises";
 import * as readline from "node:readline";
@@ -180,4 +180,4 @@ async function runInteractivePrompt(decisionContext) {
 
 //#endregion
 export { runInteractivePrompt };
-//# sourceMappingURL=interactive-prompt-opOBwMDU.js.map
+//# sourceMappingURL=interactive-prompt-BLkX0iE_.js.map

package/dist/{manifest-read-7kyDfQAK.js → manifest-read-D6NAZgt8.js}

@@ -1,5 +1,5 @@
 import { createLogger } from "./logger-KeHncl-f.js";
-import { LEARNING_FINDING, createDecision, getDecisionsByCategory } from "./dist-D2mJXElX.js";
+import { LEARNING_FINDING, createDecision, getDecisionsByCategory } from "./dist-CZk5SeSt.js";
 import * as path$1 from "path";
 import { join } from "path";
 import { readFile } from "fs/promises";
@@ -5086,6 +5086,16 @@ const PerStoryStateSchema = z.object({
 	commit_sha: z.string().optional(),
 	baseline_sha: z.string().optional(),
 	checkpoint_sha: z.string().optional(),
+	finalization: z.object({
+		mode: z.union([
+			z.literal("merge"),
+			z.literal("branch"),
+			z.literal("pr")
+		]),
+		branch: z.string().optional(),
+		sha: z.string().optional(),
+		pr_url: z.string().optional()
+	}).optional(),
 	story_file: z.string().optional(),
 	story_file_input_path: z.string().optional(),
 	story_file_sha256: z.string().optional(),
@@ -6290,4 +6300,4 @@ async function resolveRunManifest(dbRoot, runId) {
 
 //#endregion
 export { FindingsInjector, RunManifest, RuntimeProbeListSchema, SupervisorLock, ZERO_FINDINGS_BY_AUTHOR, ZERO_FINDING_COUNTS, ZERO_PROBE_AUTHOR_METRICS, aggregateProbeAuthorMetrics, applyConfigToGraph, createDefaultVerificationPipeline, createGraphOrchestrator, createSdlcCodeReviewHandler, createSdlcCreateStoryHandler, createSdlcDevStoryHandler, createSdlcPhaseHandler, detectsEventDrivenAC, detectsStateIntegratingAC, extractTargetFilesFromStoryContent, parseRuntimeProbes, readCurrentRunId, renderFindings, resolveGraphPath, resolveMainRepoRoot, resolveRunManifest, rollupFindingCounts, rollupFindingsByAuthor, rollupProbeAuthorByClass, rollupProbeAuthorMetrics, runAcTraceabilityCheck, runStaleVerificationRecovery };
-//# sourceMappingURL=manifest-read-7kyDfQAK.js.map
+//# sourceMappingURL=manifest-read-D6NAZgt8.js.map

package/dist/modules/interactive-prompt/index.js

@@ -1,6 +1,6 @@
 import "../../logger-KeHncl-f.js";
-import "../../dist-D2mJXElX.js";
-import "../../manifest-read-7kyDfQAK.js";
-import { runInteractivePrompt } from "../../interactive-prompt-opOBwMDU.js";
+import "../../dist-CZk5SeSt.js";
+import "../../manifest-read-D6NAZgt8.js";
+import { runInteractivePrompt } from "../../interactive-prompt-BLkX0iE_.js";
 
 export { runInteractivePrompt };

package/dist/{routing-CLVK4nBN.js → routing-QBUaShFv.js}

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

package/dist/{run-BhoAW6dJ.js → run-B9DV9sro.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-eGHKiGlU.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-Aqc5cghP.js";
 import { createLogger } from "./logger-KeHncl-f.js";
 import { TypedEventBusImpl, createEventBus, createTuiApp, isTuiCapable, printNonTtyWarning, sleep } from "./helpers-CElYrONe.js";
-import { ADVISORY_NOTES, 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, createPipelineRun, createRequirement, createStderrLogger, 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-D2mJXElX.js";
-import { FindingsInjector, RunManifest, RuntimeProbeListSchema, applyConfigToGraph, createDefaultVerificationPipeline, createGraphOrchestrator, createSdlcCodeReviewHandler, createSdlcCreateStoryHandler, createSdlcDevStoryHandler, createSdlcPhaseHandler, detectsEventDrivenAC, detectsStateIntegratingAC, extractTargetFilesFromStoryContent, parseRuntimeProbes, renderFindings, resolveGraphPath, resolveMainRepoRoot, runAcTraceabilityCheck, runStaleVerificationRecovery } from "./manifest-read-7kyDfQAK.js";
+import { ADVISORY_NOTES, 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, createPipelineRun, createRequirement, createStderrLogger, 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-CZk5SeSt.js";
+import { FindingsInjector, RunManifest, RuntimeProbeListSchema, applyConfigToGraph, createDefaultVerificationPipeline, createGraphOrchestrator, createSdlcCodeReviewHandler, createSdlcCreateStoryHandler, createSdlcDevStoryHandler, createSdlcPhaseHandler, detectsEventDrivenAC, detectsStateIntegratingAC, extractTargetFilesFromStoryContent, parseRuntimeProbes, renderFindings, resolveGraphPath, resolveMainRepoRoot, runAcTraceabilityCheck, runStaleVerificationRecovery } from "./manifest-read-D6NAZgt8.js";
 import { WorkGraphRepository, detectCycles } from "./work-graph-repository-DZyJv5pV.js";
 import { deriveExitCode, routeDecision } from "./decision-router-BAPpON_C.js";
-import { runInteractivePrompt } from "./interactive-prompt-opOBwMDU.js";
+import { runInteractivePrompt } from "./interactive-prompt-BLkX0iE_.js";
 import { runRecoveryEngine } from "./recovery-engine-BKGBeBnW.js";
 import { basename, dirname, extname, join } from "path";
 import { access, readFile, readdir, stat } from "fs/promises";
@@ -590,7 +590,8 @@ var GitWorktreeManagerImpl = class {
 		}, "cleanupWorktree");
 		if (opts?.force !== true) {
 			const decision = await inspectWorktreeRemovalSafety(worktreePath, this._projectRoot, branchName);
-			if (!decision.safe) throw new Error(`refusing to clean up worktree for "${taskId}": ${decision.reasons.join("; ")}.\nInspect first (git -C ${worktreePath} status; git log ${branchName} --oneline) or re-run with --force to discard.`);
+			const blockingReasons = opts?.keepBranch === true ? decision.reasons.filter((r) => r.includes("uncommitted")) : decision.reasons;
+			if (blockingReasons.length > 0) throw new Error(`refusing to clean up worktree for "${taskId}": ${blockingReasons.join("; ")}.\nInspect first (git -C ${worktreePath} status; git log ${branchName} --oneline) or re-run with --force to discard.`);
 		}
 		let worktreeExists = false;
 		try {
@@ -611,7 +612,7 @@ var GitWorktreeManagerImpl = class {
 				err
 			}, "removeWorktree failed during cleanup");
 		}
-		try {
+		if (opts?.keepBranch !== true) try {
 			await removeBranch(branchName, this._projectRoot);
 		} catch (err) {
 			this._logger.warn({
@@ -1616,6 +1617,98 @@ const PIPELINE_EVENT_METADATA = [
 			}
 		]
 	},
+	{
+		type: "story:committed",
+		description: "Story deliverable committed on its branch (feat(story-…) auto-commit).",
+		when: "Once per story after the auto-commit, before any integration step (all finalization modes).",
+		fields: [
+			{
+				name: "ts",
+				type: "string",
+				description: "Timestamp."
+			},
+			{
+				name: "key",
+				type: "string",
+				description: "Story key."
+			},
+			{
+				name: "sha",
+				type: "string",
+				description: "Deliverable commit SHA."
+			},
+			{
+				name: "branch",
+				type: "string",
+				description: "Story branch (substrate/story-<key>)."
+			}
+		]
+	},
+	{
+		type: "story:merged",
+		description: "Story branch merged into the start branch.",
+		when: "Once per story on merge success (merge finalization mode only).",
+		fields: [
+			{
+				name: "ts",
+				type: "string",
+				description: "Timestamp."
+			},
+			{
+				name: "key",
+				type: "string",
+				description: "Story key."
+			},
+			{
+				name: "sha",
+				type: "string",
+				description: "Deliverable commit SHA that was merged."
+			},
+			{
+				name: "branch",
+				type: "string",
+				description: "Story branch that was merged."
+			}
+		]
+	},
+	{
+		type: "story:finalized",
+		description: "Story finalization completed. In branch/pr modes nothing self-merges — the branch is the deliverable. A pr-mode event without pr_url means PR creation failed and finalization degraded to branch semantics.",
+		when: "Once per story after integration (every finalization mode).",
+		fields: [
+			{
+				name: "ts",
+				type: "string",
+				description: "Timestamp."
+			},
+			{
+				name: "key",
+				type: "string",
+				description: "Story key."
+			},
+			{
+				name: "mode",
+				type: "merge|branch|pr",
+				description: "Finalization mode applied."
+			},
+			{
+				name: "branch",
+				type: "string",
+				description: "Branch carrying the deliverable."
+			},
+			{
+				name: "sha",
+				type: "string",
+				description: "Deliverable commit SHA."
+			},
+			{
+				name: "pr_url",
+				type: "string",
+				description: "PR URL (pr mode, gh success only).",
+				optional: true
+			}
+		]
+	},
 	{
 		type: "story:escalation",
 		description: "Story escalated — either max review cycles exceeded or a precondition for SHIP_IT was not met.",
@@ -9513,11 +9606,26 @@ const logger$16 = createLogger("compiled-workflows:merge-to-main");
 */
 async function runMergeToMain(params) {
 	const { storyKey, branchName, startBranch, worktreeManager, eventBus, projectRoot } = params;
+	const mergeStrategy = params.mergeStrategy ?? "ff-only";
 	logger$16.info({
 		storyKey,
 		branchName,
-		startBranch
+		startBranch,
+		mergeStrategy
 	}, "Starting merge-to-main phase");
+	const dirtiedFiles = listParentDirtyIntersection(branchName, startBranch, projectRoot);
+	if (dirtiedFiles.length > 0) {
+		logger$16.warn({
+			storyKey,
+			branchName,
+			dirtiedFiles
+		}, "parent working tree has uncommitted changes to files in the story diff — refusing to merge");
+		return {
+			success: false,
+			reason: "parent-tree-dirtied-by-run",
+			dirtiedFiles
+		};
+	}
 	const ffSuccess = tryFfMerge(branchName, projectRoot);
 	if (ffSuccess) {
 		logger$16.info({
@@ -9527,6 +9635,17 @@ async function runMergeToMain(params) {
 		await cleanupAfterSuccessfulMerge(storyKey, branchName, worktreeManager, projectRoot);
 		return { success: true };
 	}
+	if (mergeStrategy === "ff-only") {
+		logger$16.warn({
+			storyKey,
+			branchName,
+			startBranch
+		}, "fast-forward not possible (base moved since the story branched) and merge_strategy is ff-only — refusing 3-way merge. Set finalization.merge_strategy: three-way to allow it (required for concurrent multi-story runs), or integrate the branch manually.");
+		return {
+			success: false,
+			reason: "ff-only-merge-not-possible"
+		};
+	}
 	logger$16.info({
 		storyKey,
 		branchName
@@ -9558,6 +9677,47 @@ async function runMergeToMain(params) {
 	};
 }
 /**
+* H3.3 (AC1): files that are both dirty in the parent working tree and part of
+* the story branch's diff against the start branch. Best-effort: if either
+* git query fails, returns [] (the merge itself will surface genuine issues).
+*/
+function listParentDirtyIntersection(branchName, startBranch, projectRoot) {
+	try {
+		const statusOut = execFileSync("git", ["status", "--porcelain"], {
+			cwd: projectRoot,
+			encoding: "utf-8",
+			stdio: [
+				"ignore",
+				"pipe",
+				"pipe"
+			]
+		});
+		const dirty = new Set(statusOut.split("\n").filter((line) => line.trim().length > 0).map((line) => {
+			const body = line.slice(3).trim();
+			const arrow = body.indexOf(" -> ");
+			return arrow === -1 ? body : body.slice(arrow + 4);
+		}));
+		if (dirty.size === 0) return [];
+		const diffOut = execFileSync("git", [
+			"diff",
+			"--name-only",
+			`${startBranch}...${branchName}`
+		], {
+			cwd: projectRoot,
+			encoding: "utf-8",
+			stdio: [
+				"ignore",
+				"pipe",
+				"pipe"
+			]
+		});
+		return diffOut.split("\n").filter((f$1) => f$1.trim().length > 0).filter((f$1) => dirty.has(f$1));
+	} catch (err) {
+		logger$16.warn({ err }, "parent-clean precondition check failed (best-effort) — proceeding to merge");
+		return [];
+	}
+}
+/**
 * Attempt a fast-forward merge of `branchName` into the current branch.
 *
 * @param branchName  - Branch to merge
@@ -16472,6 +16632,7 @@ function createImplementationOrchestrator(deps) {
 			return "completed";
 		}
 		async function finalizeStory(completedReviewCycles) {
+			let storyDeliverableSha;
 			if (!noWorktree && _worktreeManager !== void 0 && _orchestratorStartBranch !== void 0 && projectRoot !== void 0) {
 				const branchName = `${BRANCH_PREFIX}${storyKey}`;
 				if (effectiveProjectRoot !== void 0) {
@@ -16571,6 +16732,12 @@ function createImplementationOrchestrator(deps) {
 							timeout: 5e3
 						}).trim();
 					} catch {}
+					storyDeliverableSha = finalizeCommitSha;
+					if (finalizeCommitSha) eventBus.emit("orchestrator:story-committed", {
+						storyKey,
+						sha: finalizeCommitSha,
+						branch: branchName
+					});
 					if (runManifest !== null && finalizeCommitSha) {
 						const statePatch = { commit_sha: finalizeCommitSha };
 						if (storyFilePath !== void 0) try {
@@ -16645,6 +16812,127 @@ function createImplementationOrchestrator(deps) {
 						err: gateErr instanceof Error ? gateErr.message : String(gateErr)
 					}, "merge-to-main pre-flight verification failed — proceeding with merge phase");
 				}
+				const finalizationMode = config.finalizationMode ?? "merge";
+				const epicGateCommand = config.epicGateCommand;
+				if (epicGateCommand !== void 0 && epicGateCommand.trim() !== "" && finalizationMode !== "branch") {
+					const epicOf = (key) => key.includes("-") ? key.slice(0, key.lastIndexOf("-")) : key;
+					const epicId = epicOf(storyKey);
+					const TERMINAL_PHASES = ["COMPLETE", "ESCALATED"];
+					const isLastOfEpic = [..._stories.entries()].filter(([key]) => key !== storyKey && epicOf(key) === epicId).every(([, st]) => TERMINAL_PHASES.includes(st.phase));
+					if (isLastOfEpic) {
+						logger$27.info({
+							storyKey,
+							epicId,
+							epicGateCommand
+						}, "H3.4: last story of epic — running epic gate command");
+						let gateOutput = "";
+						let gatePassed = false;
+						try {
+							gateOutput = execSync(epicGateCommand, {
+								cwd: projectRoot,
+								encoding: "utf-8",
+								stdio: [
+									"ignore",
+									"pipe",
+									"pipe"
+								],
+								timeout: 6e5,
+								maxBuffer: 10 * 1024 * 1024
+							});
+							gatePassed = true;
+						} catch (gateCmdErr) {
+							const e = gateCmdErr;
+							gateOutput = `${e.stdout ?? ""}${e.stderr ?? ""}`.trim() || (e.message ?? String(gateCmdErr));
+						}
+						if (!gatePassed) {
+							logger$27.error({
+								storyKey,
+								epicId,
+								output: gateOutput.slice(0, 500)
+							}, "H3.4: epic gate command failed — halting finalization; branch preserved");
+							updateStory(storyKey, {
+								phase: "ESCALATED",
+								error: "epic-gate-failed",
+								completedAt: new Date().toISOString()
+							});
+							await emitEscalation({
+								storyKey,
+								lastVerdict: "epic-gate-failed",
+								reviewCycles: completedReviewCycles,
+								issues: [`epic gate command failed for epic ${epicId} (last story ${storyKey}): \`${epicGateCommand}\`\noutput (truncated):\n${gateOutput.slice(0, 4e3)}`]
+							});
+							await persistState();
+							return "terminal";
+						}
+						logger$27.info({
+							storyKey,
+							epicId
+						}, "H3.4: epic gate passed");
+					}
+				}
+				if (finalizationMode === "branch" || finalizationMode === "pr") {
+					let prUrl;
+					if (finalizationMode === "pr") try {
+						execSync(`git push -u origin ${branchName}`, {
+							cwd: projectRoot,
+							stdio: [
+								"ignore",
+								"pipe",
+								"pipe"
+							],
+							timeout: 6e4
+						});
+						const shortSha = (storyDeliverableSha ?? "").slice(0, 10);
+						const ghOutput = execSync(`gh pr create --head ${branchName} --title ${JSON.stringify(`story ${storyKey}: ${_capturedStoryTitle ?? "implementation"}`)} --body ${JSON.stringify(`Substrate story ${storyKey} (commit ${shortSha}). Verified by the Tier-A pipeline; see the run manifest for the full verification record.`)}`, {
+							cwd: projectRoot,
+							encoding: "utf-8",
+							stdio: [
+								"ignore",
+								"pipe",
+								"pipe"
+							],
+							timeout: 6e4
+						}).trim();
+						prUrl = ghOutput === "" ? void 0 : ghOutput;
+					} catch (prErr) {
+						logger$27.warn({
+							storyKey,
+							branchName,
+							err: prErr instanceof Error ? prErr.message.slice(0, 300) : String(prErr)
+						}, "pr finalization: push/gh failed — degrading to branch mode (the branch is still the deliverable)");
+					}
+					try {
+						await _worktreeManager.cleanupWorktree(storyKey, { keepBranch: true });
+					} catch (cleanupErr) {
+						logger$27.warn({
+							storyKey,
+							err: cleanupErr
+						}, "worktree removal after branch/pr finalization failed (best-effort; branch intact)");
+					}
+					eventBus.emit("orchestrator:story-finalized", {
+						storyKey,
+						mode: finalizationMode,
+						branch: branchName,
+						sha: storyDeliverableSha ?? "",
+						...prUrl !== void 0 ? { prUrl } : {}
+					});
+					if (runManifest !== null) runManifest.patchStoryState(storyKey, { finalization: {
+						mode: finalizationMode,
+						branch: branchName,
+						...storyDeliverableSha ? { sha: storyDeliverableSha } : {},
+						...prUrl !== void 0 ? { pr_url: prUrl } : {}
+					} }).catch((err) => logger$27.warn({
+						err,
+						storyKey
+					}, "patchStoryState(finalization) failed — pipeline continues"));
+					logger$27.info({
+						storyKey,
+						branchName,
+						mode: finalizationMode,
+						prUrl
+					}, "story finalized without self-merge — branch is the deliverable");
+					return "finalized";
+				}
 				logger$27.info({
 					storyKey,
 					branchName,
@@ -16658,7 +16946,8 @@ function createImplementationOrchestrator(deps) {
 						startBranch: _orchestratorStartBranch,
 						worktreeManager: _worktreeManager,
 						eventBus,
-						projectRoot
+						projectRoot,
+						mergeStrategy: config.mergeStrategy ?? "ff-only"
 					});
 				} catch (mergeErr) {
 					const errMsg = mergeErr instanceof Error ? mergeErr.message : String(mergeErr);
@@ -16681,21 +16970,28 @@ function createImplementationOrchestrator(deps) {
 					return "terminal";
 				}
 				if (!mergeResult.success) {
+					const failReason = mergeResult.reason ?? "merge-conflict-detected";
+					const issues = [];
+					if (failReason === "parent-tree-dirtied-by-run") issues.push(`parent working tree has uncommitted changes to ${mergeResult.dirtiedFiles?.length ?? 0} file(s) the story also modified: ${(mergeResult.dirtiedFiles ?? []).join(", ")} — merging would entangle unreviewed parent edits with verified story content. Commit or stash the parent changes, then merge ${branchName} manually.`);
+					else if (failReason === "ff-only-merge-not-possible") issues.push(`${_orchestratorStartBranch ?? "the start branch"} moved since ${branchName} was created and merge_strategy is ff-only — substrate will not synthesize a merge commit. Set finalization.merge_strategy: three-way (required for concurrent multi-story runs) or integrate the branch manually.`);
+					else issues.push(`merge conflict in ${mergeResult.conflictingFiles?.length ?? 0} file(s): ${(mergeResult.conflictingFiles ?? []).join(", ")}`);
 					logger$27.warn({
 						storyKey,
 						branchName,
-						conflictingFiles: mergeResult.conflictingFiles
-					}, "merge-to-main conflict — escalating story with merge-conflict-detected");
+						reason: failReason,
+						conflictingFiles: mergeResult.conflictingFiles,
+						dirtiedFiles: mergeResult.dirtiedFiles
+					}, `merge-to-main failed — escalating story with ${failReason}`);
 					updateStory(storyKey, {
 						phase: "ESCALATED",
-						error: "merge-conflict-detected",
+						error: failReason,
 						completedAt: new Date().toISOString()
 					});
 					await emitEscalation({
 						storyKey,
-						lastVerdict: "merge-conflict-detected",
+						lastVerdict: failReason,
 						reviewCycles: completedReviewCycles,
-						issues: [`merge conflict in ${mergeResult.conflictingFiles?.length ?? 0} file(s): ${(mergeResult.conflictingFiles ?? []).join(", ")}`]
+						issues
 					});
 					await persistState();
 					return "terminal";
@@ -16704,6 +17000,25 @@ function createImplementationOrchestrator(deps) {
 					storyKey,
 					branchName
 				}, "merge-to-main phase completed successfully");
+				eventBus.emit("orchestrator:story-merged", {
+					storyKey,
+					sha: storyDeliverableSha ?? "",
+					branch: branchName
+				});
+				eventBus.emit("orchestrator:story-finalized", {
+					storyKey,
+					mode: "merge",
+					branch: branchName,
+					sha: storyDeliverableSha ?? ""
+				});
+				if (runManifest !== null) runManifest.patchStoryState(storyKey, { finalization: {
+					mode: "merge",
+					branch: branchName,
+					...storyDeliverableSha ? { sha: storyDeliverableSha } : {}
+				} }).catch((err) => logger$27.warn({
+					err,
+					storyKey
+				}, "patchStoryState(finalization) failed — pipeline continues"));
 			}
 			return "finalized";
 		}
@@ -17933,7 +18248,13 @@ function createImplementationOrchestrator(deps) {
 			}).trim();
 			logger$27.info({ orchestratorStartBranch: _orchestratorStartBranch }, "Captured orchestrator start branch for merge-to-main");
 		} catch (branchErr) {
-			logger$27.warn({ err: branchErr }, "Failed to capture orchestrator start branch — merge-to-main will skip worktree integration");
+			if (config.noWorktree !== true) {
+				logger$27.error({ err: branchErr }, "FATAL: failed to capture the orchestrator start branch (git rev-parse --abbrev-ref HEAD). Worktree finalization cannot work without it. Fix git in the project root or re-run with --no-worktree.");
+				_state = "FAILED";
+				_completedAt = new Date().toISOString();
+				return getStatus();
+			}
+			logger$27.warn({ err: branchErr }, "Failed to capture orchestrator start branch — merge-to-main will skip worktree integration (--no-worktree run)");
 		}
 		for (const key of storyKeys) {
 			const pendingState = {
@@ -46411,6 +46732,35 @@ function wireNdjsonEmitter(eventBus, ndjsonEmitter) {
 			review_cycles: payload.reviewCycles
 		});
 	});
+	eventBus.on("orchestrator:story-committed", (payload) => {
+		ndjsonEmitter.emit({
+			type: "story:committed",
+			ts: new Date().toISOString(),
+			key: payload.storyKey,
+			sha: payload.sha,
+			branch: payload.branch
+		});
+	});
+	eventBus.on("orchestrator:story-merged", (payload) => {
+		ndjsonEmitter.emit({
+			type: "story:merged",
+			ts: new Date().toISOString(),
+			key: payload.storyKey,
+			sha: payload.sha,
+			branch: payload.branch
+		});
+	});
+	eventBus.on("orchestrator:story-finalized", (payload) => {
+		ndjsonEmitter.emit({
+			type: "story:finalized",
+			ts: new Date().toISOString(),
+			key: payload.storyKey,
+			mode: payload.mode,
+			branch: payload.branch,
+			sha: payload.sha,
+			...payload.prUrl !== void 0 ? { pr_url: payload.prUrl } : {}
+		});
+	});
 	eventBus.on("orchestrator:story-escalated", (payload) => {
 		const rawIssues = Array.isArray(payload.issues) ? payload.issues : [];
 		const issues = rawIssues.map((issue) => {
@@ -46624,7 +46974,7 @@ function resolveProbeAuthorStateIntegrating(cliFlag) {
 *   substrate run --non-interactive --halt-on none --events --output-format json
 */
 async function runRunAction(options) {
-	const { pack: packName, from: startPhase, stopAfter, concept: conceptArg, conceptFile, stories: storiesArg, concurrency, outputFormat, projectRoot, events: eventsFlag, verbose: verboseFlag, tui: tuiFlag, skipUx, research: researchFlag, skipResearch: skipResearchFlag, skipPreflight, skipVerification, epic: epicNumber, dryRun, maxReviewCycles = 2, engine, agent: explicitAgentId, registry: injectedRegistry, haltOn: haltOnOpt, costCeiling, probeAuthor, probeAuthorStateIntegrating: probeAuthorStateIntegratingFlag, nonInteractive, verifyAc, noWorktree } = options;
+	const { pack: packName, from: startPhase, stopAfter, concept: conceptArg, conceptFile, stories: storiesArg, concurrency, outputFormat, projectRoot, events: eventsFlag, verbose: verboseFlag, tui: tuiFlag, skipUx, research: researchFlag, skipResearch: skipResearchFlag, skipPreflight, skipVerification, epic: epicNumber, dryRun, maxReviewCycles = 2, engine, agent: explicitAgentId, registry: injectedRegistry, haltOn: haltOnOpt, costCeiling, probeAuthor, probeAuthorStateIntegrating: probeAuthorStateIntegratingFlag, nonInteractive, verifyAc, noWorktree, finalization } = options;
 	const haltOn = haltOnOpt;
 	const VALID_PROBE_AUTHOR_MODES = [
 		"enabled",
@@ -46740,6 +47090,9 @@ async function runRunAction(options) {
 	let meshUrl;
 	let meshProjectId;
 	let configRetryBudget;
+	let configFinalizationMode;
+	let configMergeStrategy;
+	let configEpicGateCommand;
 	let configWorktreeCopyFiles;
 	try {
 		const configSystem = createConfigSystem({ projectConfigDir: dbDir });
@@ -46766,6 +47119,9 @@ async function runRunAction(options) {
 			meshProjectId = cfg.telemetry.projectId;
 		}
 		if (typeof cfg.retry_budget === "number") configRetryBudget = cfg.retry_budget;
+		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 (Array.isArray(cfg.worktree?.copy_files) && cfg.worktree.copy_files.length > 0) {
 			configWorktreeCopyFiles = [...cfg.worktree.copy_files];
 			logger.info({ copyFiles: configWorktreeCopyFiles }, "Loaded worktree.copy_files from config");
@@ -46865,6 +47221,9 @@ async function runRunAction(options) {
 		retryBudget: configRetryBudget ?? 2,
 		agentId,
 		...noWorktree === true ? { noWorktree: true } : {},
+		...finalization !== void 0 ? { finalizationMode: finalization } : configFinalizationMode !== void 0 ? { finalizationMode: configFinalizationMode } : {},
+		...configMergeStrategy !== void 0 ? { mergeStrategy: configMergeStrategy } : {},
+		...configEpicGateCommand !== void 0 ? { epicGateCommand: configEpicGateCommand } : {},
 		...configWorktreeCopyFiles !== void 0 ? { worktreeCopyFiles: configWorktreeCopyFiles } : {}
 	});
 	let storyKeys = [...parsedStoryKeys];
@@ -47428,6 +47787,9 @@ async function runRunAction(options) {
 					...probeAuthor !== void 0 ? { probeAuthorMode: probeAuthor } : {},
 					probeAuthorStateIntegrating: resolvedProbeAuthorStateIntegrating,
 					...noWorktree === true ? { noWorktree: true } : {},
+					...finalization !== void 0 ? { finalizationMode: finalization } : configFinalizationMode !== void 0 ? { finalizationMode: configFinalizationMode } : {},
+					...configMergeStrategy !== void 0 ? { mergeStrategy: configMergeStrategy } : {},
+					...configEpicGateCommand !== void 0 ? { epicGateCommand: configEpicGateCommand } : {},
 					...configWorktreeCopyFiles !== void 0 ? { worktreeCopyFiles: configWorktreeCopyFiles } : {}
 				},
 				projectRoot,
@@ -47651,7 +48013,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 } = 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 } = options;
 	if (!existsSync$1(dbDir)) mkdirSync$1(dbDir, { recursive: true });
 	let doltServerFull = null;
 	try {
@@ -47961,6 +48323,9 @@ async function runFullPipeline(options) {
 						...probeAuthor !== void 0 ? { probeAuthorMode: probeAuthor } : {},
 						...fpProbeAuthorStateIntegrating !== void 0 ? { probeAuthorStateIntegrating: fpProbeAuthorStateIntegrating } : {},
 						...noWorktree === true ? { noWorktree: true } : {},
+						...fpFinalizationMode !== void 0 ? { finalizationMode: fpFinalizationMode } : {},
+						...fpMergeStrategy !== void 0 ? { mergeStrategy: fpMergeStrategy } : {},
+						...fpEpicGateCommand !== void 0 ? { epicGateCommand: fpEpicGateCommand } : {},
 						...fpWorktreeCopyFiles !== void 0 ? { worktreeCopyFiles: fpWorktreeCopyFiles } : {}
 					},
 					projectRoot,
@@ -48131,7 +48496,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-CKsauG6T.js");
+	const { createVersionManager } = await import("./version-manager-impl-_x1n4xZk.js");
 	const vm = createVersionManager();
 	const result = await vm.checkForUpdates(true);
 	const gap = classifyVersionGap(currentVersion, result.latestVersion);
@@ -48171,7 +48536,7 @@ function registerRunCommand(program, version = "0.0.0", projectRoot = process.cw
 		"",
 		"--halt-on defaults to critical. Skipped halt decisions are recorded as",
 		"decision:halt-skipped-non-interactive events in --non-interactive mode."
-	].join("\n      ")).option("--verify-ac", "Run AC-to-test traceability heuristic after the pipeline completes (Story 74-1)").option("--no-worktree", "Bypass per-story git worktrees (safety valve for submodules, bare repos, or large checkouts where parallel worktrees blow disk — not the recommended path)").action(async (opts) => {
+	].join("\n      ")).option("--verify-ac", "Run AC-to-test traceability heuristic after the pipeline completes (Story 74-1)").option("--no-worktree", "Bypass per-story git worktrees (safety valve for submodules, bare repos, or large checkouts where parallel worktrees blow disk — not the recommended path)").option("--finalization <mode>", "H3.1: how verified stories integrate: 'merge' (default, local merge), 'branch' (never self-merge — the story branch is the deliverable), 'pr' (branch + push + gh pr create; degrades to branch on failure).").action(async (opts) => {
 		if (opts.helpAgent) {
 			process.exitCode = await runHelpAgent();
 			return;
@@ -48189,6 +48554,15 @@ function registerRunCommand(program, version = "0.0.0", projectRoot = process.cw
 			}
 			fromPhase = opts.from;
 		}
+		if (opts.finalization !== void 0 && ![
+			"merge",
+			"branch",
+			"pr"
+		].includes(String(opts.finalization))) {
+			process.stderr.write(`Invalid --finalization "${String(opts.finalization)}" — expected merge | branch | pr\n`);
+			process.exitCode = 2;
+			return;
+		}
 		const exitCode = await runRunAction({
 			pack: opts.pack,
 			from: fromPhase,
@@ -48219,7 +48593,8 @@ function registerRunCommand(program, version = "0.0.0", projectRoot = process.cw
 			probeAuthorStateIntegrating: opts.probeAuthorStateIntegrating,
 			nonInteractive: opts.nonInteractive,
 			verifyAc: opts.verifyAc,
-			noWorktree: opts.worktree === false || process.env["SUBSTRATE_NO_WORKTREE"] === "1"
+			noWorktree: opts.worktree === false || process.env["SUBSTRATE_NO_WORKTREE"] === "1",
+			finalization: opts.finalization
 		});
 		if (opts.nonInteractive === true) process.exit(exitCode);
 		process.exitCode = exitCode;
@@ -48228,4 +48603,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, createGitWorktreeManager, 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-BhoAW6dJ.js.map
+//# sourceMappingURL=run-B9DV9sro.js.map

package/dist/{run-CJHnHg3o.js → run-BX-__EJm.js}

@@ -1,14 +1,14 @@
-import "./health-eGHKiGlU.js";
+import "./health-Aqc5cghP.js";
 import "./logger-KeHncl-f.js";
 import "./helpers-CElYrONe.js";
-import "./dist-D2mJXElX.js";
-import { normalizeGraphSummaryToStatus, registerRunCommand, resolveMaxReviewCycles, resolveProbeAuthorStateIntegrating, runRunAction, wireNdjsonEmitter } from "./run-BhoAW6dJ.js";
-import "./manifest-read-7kyDfQAK.js";
+import "./dist-CZk5SeSt.js";
+import { normalizeGraphSummaryToStatus, registerRunCommand, resolveMaxReviewCycles, resolveProbeAuthorStateIntegrating, runRunAction, wireNdjsonEmitter } from "./run-B9DV9sro.js";
+import "./manifest-read-D6NAZgt8.js";
 import "./routing-DFxoKHDt.js";
 import "./work-graph-repository-DZyJv5pV.js";
 import "./decisions-CzSIEeGP.js";
 import "./decision-router-BAPpON_C.js";
-import "./interactive-prompt-opOBwMDU.js";
+import "./interactive-prompt-BLkX0iE_.js";
 import "./recovery-engine-BKGBeBnW.js";
 
 export { runRunAction };

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

@@ -1,4 +1,4 @@
-import { CoreEvents, DatabaseAdapter, TypedEventBus } from "../../../index-BqVBOAO0.js";
+import { CoreEvents, DatabaseAdapter, TypedEventBus } from "../../../index-CvNLhgKV.js";
 import { z } from "zod";
 
 //#region packages/sdlc/dist/verification/findings.d.ts
@@ -583,6 +583,12 @@ declare const PerStoryStateSchema: z.ZodObject<{
   commit_sha: z.ZodOptional<z.ZodString>;
   baseline_sha: z.ZodOptional<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">]>;
+    branch: z.ZodOptional<z.ZodString>;
+    sha: z.ZodOptional<z.ZodString>;
+    pr_url: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>;
   story_file: z.ZodOptional<z.ZodString>;
   story_file_input_path: z.ZodOptional<z.ZodString>;
   story_file_sha256: z.ZodOptional<z.ZodString>;

package/dist/{upgrade-Djo0dJak.js → upgrade-BEfZJU4K.js}

@@ -1,4 +1,4 @@
-import { createVersionManager } from "./dist-D2mJXElX.js";
+import { createVersionManager } from "./dist-CZk5SeSt.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-Djo0dJak.js.map
+//# sourceMappingURL=upgrade-BEfZJU4K.js.map

package/dist/{upgrade-DnB0p8b5.js → upgrade-emlrK3YW.js}

@@ -1,5 +1,5 @@
-import "./dist-D2mJXElX.js";
+import "./dist-CZk5SeSt.js";
 import "./version-manager-impl-qFBiO4Eh.js";
-import { isGlobalInstall, registerUpgradeCommand, runUpgradeCommand } from "./upgrade-Djo0dJak.js";
+import { isGlobalInstall, registerUpgradeCommand, runUpgradeCommand } from "./upgrade-BEfZJU4K.js";
 
 export { isGlobalInstall, registerUpgradeCommand, runUpgradeCommand };

package/dist/{version-manager-impl-CKsauG6T.js → version-manager-impl-_x1n4xZk.js}

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

package/package.json

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

package/dist/adapter-registry-BPwWmPjJ.js

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