substrate-ai 0.20.10 → 0.20.13

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

@@ -3442,21 +3442,52 @@ const RuntimeProbeListSchema = z.array(RuntimeProbeSchema);
 //#endregion
 //#region packages/sdlc/dist/verification/probes/parser.js
 const SECTION_HEADING = /^##\s+Runtime\s+Probes\s*$/i;
+const FENCE_DELIMITER = /^\s*```/;
 /**
 * Return the raw text of the story's `## Runtime Probes` section (excluding
 * the heading line itself), or `undefined` if the section is not present.
 *
 * The section ends at the next `##` heading or end-of-file. Sub-headings
 * (`###`, `####`) remain part of the section body.
+*
+* Story 58-4: the scan tracks code-fence depth so a `## Runtime Probes`
+* heading that appears *inside* an outer ``` block is ignored. Stories that
+* DOCUMENT probes in prose — regression fixtures, how-to-author docs, the
+* Epic 58 e2e test spec — contain illustrative `## Runtime Probes` examples
+* inside outer fences. Without fence-awareness the parser matches those
+* illustrations as the story's own section, fails to find a terminated
+* yaml block (the inner fences are typically escaped), and emits a spurious
+* `runtime-probe-parse-error`. Hit live during the Epic 58 substrate
+* dispatch on 58-3's artifact.
 */
 function extractRuntimeProbesSection(storyContent) {
 	const lines = storyContent.split(/\r?\n/);
-	const start = lines.findIndex((line) => SECTION_HEADING.test(line.trim()));
+	let inCodeFence = false;
+	let start = -1;
+	for (let i = 0; i < lines.length; i += 1) {
+		const line = lines[i] ?? "";
+		if (FENCE_DELIMITER.test(line)) {
+			inCodeFence = !inCodeFence;
+			continue;
+		}
+		if (!inCodeFence && SECTION_HEADING.test(line.trim())) {
+			start = i;
+			break;
+		}
+	}
 	if (start === -1) return void 0;
 	let end = lines.length;
-	for (let i = start + 1; i < lines.length; i += 1) if (/^##\s+\S/.test(lines[i] ?? "")) {
-		end = i;
-		break;
+	inCodeFence = false;
+	for (let i = start + 1; i < lines.length; i += 1) {
+		const line = lines[i] ?? "";
+		if (FENCE_DELIMITER.test(line)) {
+			inCodeFence = !inCodeFence;
+			continue;
+		}
+		if (!inCodeFence && /^##\s+\S/.test(line)) {
+			end = i;
+			break;
+		}
 	}
 	return lines.slice(start + 1, end).join("\n");
 }
@@ -3732,6 +3763,113 @@ var RuntimeProbeCheck = class {
 	}
 };
 
+//#endregion
+//#region packages/sdlc/dist/verification/source-ac-fidelity-check.js
+/**
+* Extract the story's section from the full epic content.
+*
+* Uses the same heading pattern as `isImplicitlyCovered` in the monolith:
+*   `### Story <storyKey>:` or `### Story <storyKey> ` or `### Story <storyKey>\n`
+*
+* Returns the extracted section text (from the heading match through to the
+* next `### Story` heading or end of file), or the full content if no
+* matching heading is found.
+*/
+function extractStorySection(epicContent, storyKey) {
+	const escapedKey = storyKey.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+	const headingPattern = new RegExp(`^###\\s+Story\\s+${escapedKey}[:\\s]`, "m");
+	const match = headingPattern.exec(epicContent);
+	if (!match) return epicContent;
+	const start = match.index;
+	const nextHeading = /\n### Story /m.exec(epicContent.slice(start + 1));
+	if (nextHeading) return epicContent.slice(start, start + 1 + nextHeading.index);
+	return epicContent.slice(start);
+}
+/**
+* Extract hard clauses from a story section of an epic file.
+*
+* Hard clauses:
+*   1. Lines containing MUST NOT / MUST / SHALL NOT / SHALL as standalone keywords (case-sensitive)
+*   2. Backtick-wrapped paths with at least one `/` (excludes bare filenames)
+*   3. The presence of `## Runtime Probes` heading followed by a fenced yaml block
+*      (represented as a single "runtime-probes-section" clause)
+*/
+function extractHardClauses(sectionContent) {
+	const clauses = [];
+	const mustPattern = /\b(MUST NOT|MUST|SHALL NOT|SHALL)\b/;
+	const lines = sectionContent.split("\n");
+	for (const line of lines) {
+		const match = mustPattern.exec(line);
+		if (match) {
+			const keyword = match[1];
+			clauses.push({
+				type: keyword,
+				text: line.trim()
+			});
+		}
+	}
+	const pathPattern = /`([a-zA-Z0-9_./-]+\/[a-zA-Z0-9_./-]+)`/g;
+	let pathMatch;
+	while ((pathMatch = pathPattern.exec(sectionContent)) !== null) clauses.push({
+		type: "path",
+		text: `\`${pathMatch[1]}\``
+	});
+	const probesPattern = /^##\s+Runtime Probes[\s\S]*?```yaml/m;
+	if (probesPattern.test(sectionContent)) clauses.push({
+		type: "runtime-probes-section",
+		text: "## Runtime Probes"
+	});
+	return clauses;
+}
+var SourceAcFidelityCheck = class {
+	name = "source-ac-fidelity";
+	tier = "A";
+	async run(context) {
+		const start = Date.now();
+		if (!context.sourceEpicContent) {
+			const findings$1 = [{
+				category: "source-ac-source-unavailable",
+				severity: "warn",
+				message: "source epic content unavailable — skipping fidelity check"
+			}];
+			return {
+				status: "pass",
+				details: renderFindings(findings$1),
+				duration_ms: Date.now() - start,
+				findings: findings$1
+			};
+		}
+		const storySection = extractStorySection(context.sourceEpicContent, context.storyKey);
+		const hardClauses = extractHardClauses(storySection);
+		const findings = [];
+		const storyContent = context.storyContent ?? "";
+		for (const clause of hardClauses) if (clause.type === "runtime-probes-section") {
+			if (!storyContent.includes("## Runtime Probes")) {
+				const truncated = clause.text.length > 120 ? clause.text.slice(0, 120) : clause.text;
+				findings.push({
+					category: "source-ac-drift",
+					severity: "error",
+					message: `runtime-probes-section: "${truncated}" present in epics source but absent in story artifact`
+				});
+			}
+		} else if (!storyContent.includes(clause.text)) {
+			const truncated = clause.text.length > 120 ? clause.text.slice(0, 120) : clause.text;
+			findings.push({
+				category: "source-ac-drift",
+				severity: "error",
+				message: `${clause.type}: "${truncated}" present in epics source but absent in story artifact`
+			});
+		}
+		const status = findings.some((f) => f.severity === "error") ? "fail" : "pass";
+		return {
+			status,
+			details: findings.length > 0 ? renderFindings(findings) : `source-ac-fidelity: ${hardClauses.length} hard clause(s) verified — all present`,
+			duration_ms: Date.now() - start,
+			findings
+		};
+	}
+};
+
 //#endregion
 //#region packages/sdlc/dist/verification/verification-pipeline.js
 /**
@@ -3839,12 +3977,14 @@ var VerificationPipeline = class {
 * Create a VerificationPipeline pre-loaded with the canonical check set.
 *
 * Canonical Tier A check order:
-*   1. PhantomReviewCheck — story 51-2  (runs first: unreviewed stories skipped)
-*   2. TrivialOutputCheck — story 51-3
+*   1. PhantomReviewCheck      — story 51-2  (runs first: unreviewed stories skipped)
+*   2. TrivialOutputCheck      — story 51-3
 *   3. AcceptanceCriteriaEvidenceCheck
-*   4. BuildCheck         — story 51-4
-*   5. RuntimeProbeCheck  — Epic 55 Phase 2: runtime behavior gate; runs last
-*                           in Tier A because probes may depend on built artifacts
+*   4. BuildCheck              — story 51-4
+*   5. RuntimeProbeCheck       — Epic 55 Phase 2: runtime behavior gate; runs last
+*                                in Tier A because probes may depend on built artifacts
+*   6. SourceAcFidelityCheck   — Story 58-2: cross-references rendered story artifact
+*                                against the source epic's hard clauses (MUST/SHALL/paths)
 *
 * @param bus    Typed event bus for verification events.
 * @param config Optional config (used to forward threshold to TrivialOutputCheck).
@@ -3855,7 +3995,8 @@ function createDefaultVerificationPipeline(bus, config) {
 		new TrivialOutputCheck(config),
 		new AcceptanceCriteriaEvidenceCheck(),
 		new BuildCheck(),
-		new RuntimeProbeCheck()
+		new RuntimeProbeCheck(),
+		new SourceAcFidelityCheck()
 	];
 	return new VerificationPipeline(bus, checks);
 }
@@ -4069,6 +4210,12 @@ const RunManifestSchema = z.object({
 	run_id: z.string(),
 	cli_flags: CliFlagsSchema.transform((v) => v),
 	story_scope: z.array(z.string()),
+	run_status: z.enum([
+		"running",
+		"completed",
+		"failed",
+		"stopped"
+	]).optional(),
 	supervisor_pid: z.number().nullable(),
 	supervisor_session_id: z.string().nullable(),
 	per_story_state: z.record(z.string(), PerStoryStateSchema),
@@ -4078,6 +4225,8 @@ const RunManifestSchema = z.object({
 		run_total: 0
 	}),
 	pending_proposals: z.array(ProposalSchema),
+	stopped_reason: z.string().optional(),
+	stopped_at: z.string().optional(),
 	generation: z.number().int().nonnegative(),
 	created_at: z.string(),
 	updated_at: z.string()
@@ -4419,6 +4568,55 @@ var RunManifest = class RunManifest {
 	/**
 	* Raw implementation — must only be called from within `_enqueue`.
 	*/
+	async _patchRunStatusImpl(updates) {
+		let existingData;
+		try {
+			const read = await RunManifest.read(this.runId, this.baseDir, this.doltAdapter);
+			const { generation: _gen, updated_at: _ts,...rest } = read;
+			existingData = rest;
+		} catch {
+			const now = new Date().toISOString();
+			existingData = {
+				run_id: this.runId,
+				cli_flags: {},
+				story_scope: [],
+				supervisor_pid: null,
+				supervisor_session_id: null,
+				per_story_state: {},
+				recovery_history: [],
+				cost_accumulation: {
+					per_story: {},
+					run_total: 0
+				},
+				pending_proposals: [],
+				created_at: now
+			};
+		}
+		const merged = { ...existingData };
+		if (updates.run_status !== void 0) merged.run_status = updates.run_status;
+		if (updates.stopped_reason !== void 0) merged.stopped_reason = updates.stopped_reason;
+		if (updates.stopped_at !== void 0) merged.stopped_at = updates.stopped_at;
+		await this._writeImpl(merged);
+	}
+	/**
+	* Atomically update the run-level status fields in the manifest.
+	*
+	* Reads the current manifest (or creates a minimal default if absent),
+	* merges the provided status updates at the top level, and writes the
+	* result atomically via a single `write()` call.
+	*
+	* Enqueues the operation via `_enqueue` so concurrent calls are serialized
+	* (preserves the single-writer guarantee from Epic 57-1).
+	* Non-fatal: callers MUST wrap in `.catch((err) => logger.warn(...))`.
+	*
+	* @param updates - Top-level status fields to merge (run_status, stopped_reason, stopped_at)
+	*/
+	async patchRunStatus(updates) {
+		return this._enqueue(() => this._patchRunStatusImpl(updates));
+	}
+	/**
+	* Raw implementation — must only be called from within `_enqueue`.
+	*/
 	async _appendRecoveryEntryImpl(entry) {
 		let existingData;
 		try {
@@ -5336,4 +5534,4 @@ function registerHealthCommand(program, _version = "0.0.0", projectRoot = proces
 
 //#endregion
 export { BMAD_BASELINE_TOKENS_FULL, DEFAULT_STALL_THRESHOLD_SECONDS, DoltMergeConflict, FileStateStore, FindingsInjector, RunManifest, STOP_AFTER_VALID_PHASES, STORY_KEY_PATTERN$1 as STORY_KEY_PATTERN, SUBSTRATE_OWNED_SETTINGS_KEYS, SupervisorLock, VALID_PHASES, WorkGraphRepository, ZERO_FINDING_COUNTS, __commonJS, __require, __toESM, applyConfigToGraph, buildPipelineStatusOutput, createDatabaseAdapter$1 as createDatabaseAdapter, createDefaultVerificationPipeline, createGraphOrchestrator, createSdlcCodeReviewHandler, createSdlcCreateStoryHandler, createSdlcDevStoryHandler, createSdlcPhaseHandler, createStateStore, detectCycles, extractTargetFilesFromStoryContent, findPackageRoot, formatOutput, formatPipelineStatusHuman, formatPipelineSummary, formatTokenTelemetry, getAllDescendantPids, getAutoHealthData, getSubstrateDefaultSettings, inspectProcessTree, isOrchestratorProcessLine, parseDbTimestampAsUtc, registerHealthCommand, renderFindings, resolveBmadMethodSrcPath, resolveBmadMethodVersion, resolveGraphPath, resolveMainRepoRoot, resolveRunManifest, rollupFindingCounts, runHealthAction, validateStoryKey };
-//# sourceMappingURL=health-C6Up5GCr.js.map
+//# sourceMappingURL=health-CxBbduMn.js.map

package/dist/{health-C73H5CUZ.js → health-RIYFKE9U.js}

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

package/dist/index.d.ts

@@ -2286,6 +2286,20 @@ interface OrchestratorEvents {
     /** Retry attempt number (always 2 — first retry after initial timeout) */
     attempt: number;
   };
+  /**
+   * Emitted when an existing story artifact's stored source-AC hash differs
+   * from the current source epic's AC hash, or when the artifact carries no
+   * hash at all (legacy artifact). Causes the orchestrator to re-run
+   * create-story instead of reusing the stale artifact.
+   */
+  'story:ac-source-drift': {
+    /** Story key whose artifact is stale */
+    storyKey: string;
+    /** Hash stored in the artifact's HTML comment (null if absent — legacy artifact) */
+    storedHash: string | null;
+    /** Hash computed from the current source epic's AC section */
+    currentHash: string;
+  };
 }
 
 //#endregion

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

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

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

@@ -1,4 +1,4 @@
-import { BMAD_BASELINE_TOKENS_FULL, DoltMergeConflict, FileStateStore, FindingsInjector, RunManifest, STOP_AFTER_VALID_PHASES, STORY_KEY_PATTERN, VALID_PHASES, WorkGraphRepository, __commonJS, __require, __toESM, applyConfigToGraph, buildPipelineStatusOutput, createDatabaseAdapter, createDefaultVerificationPipeline, createGraphOrchestrator, createSdlcCodeReviewHandler, createSdlcCreateStoryHandler, createSdlcDevStoryHandler, createSdlcPhaseHandler, detectCycles, extractTargetFilesFromStoryContent, formatOutput, formatPipelineSummary, formatTokenTelemetry, inspectProcessTree, parseDbTimestampAsUtc, renderFindings, resolveGraphPath, resolveMainRepoRoot, validateStoryKey } from "./health-C6Up5GCr.js";
+import { BMAD_BASELINE_TOKENS_FULL, DoltMergeConflict, FileStateStore, FindingsInjector, RunManifest, STOP_AFTER_VALID_PHASES, STORY_KEY_PATTERN, VALID_PHASES, WorkGraphRepository, __commonJS, __require, __toESM, applyConfigToGraph, buildPipelineStatusOutput, createDatabaseAdapter, createDefaultVerificationPipeline, createGraphOrchestrator, createSdlcCodeReviewHandler, createSdlcCreateStoryHandler, createSdlcDevStoryHandler, createSdlcPhaseHandler, detectCycles, extractTargetFilesFromStoryContent, formatOutput, formatPipelineSummary, formatTokenTelemetry, inspectProcessTree, parseDbTimestampAsUtc, renderFindings, resolveGraphPath, resolveMainRepoRoot, validateStoryKey } from "./health-CxBbduMn.js";
 import { createLogger } from "./logger-KeHncl-f.js";
 import { TypedEventBusImpl, createEventBus, createTuiApp, isTuiCapable, printNonTtyWarning, sleep } from "./helpers-CElYrONe.js";
 import { ADVISORY_NOTES, Categorizer, ConsumerAnalyzer, DEFAULT_GLOBAL_SETTINGS, DispatcherImpl, DoltClient, ESCALATION_DIAGNOSIS, EXPERIMENT_RESULT, EfficiencyScorer, IngestionServer, LogTurnAnalyzer, OPERATIONAL_FINDING, Recommender, RoutingRecommender, RoutingResolver, RoutingTelemetry, RoutingTokenAccumulator, RoutingTuner, STORY_METRICS, STORY_OUTCOME, SubstrateConfigSchema, TEST_EXPANSION_FINDING, TEST_PLAN, TelemetryNormalizer, TelemetryPipeline, TurnAnalyzer, addTokenUsage, aggregateTokenUsageForRun, aggregateTokenUsageForStory, callLLM, createConfigSystem, createDatabaseAdapter$1, createDecision, createPipelineRun, createRequirement, detectInterfaceChanges, getArtifactByTypeForRun, getArtifactsByRun, getDecisionsByCategory, getDecisionsByPhase, getDecisionsByPhaseForRun, getLatestRun, getPipelineRunById, getRunMetrics, getRunningPipelineRuns, getStoryMetricsForRun, getTokenUsageSummary, initSchema, listRequirements, loadModelRoutingConfig, registerArtifact, updatePipelineRun, updatePipelineRunConfig, upsertDecision, writeRunMetrics, writeStoryMetrics } from "./dist-CqtWS9wF.js";
@@ -5676,6 +5676,21 @@ function getTokenCeiling(workflowType, tokenCeilings) {
 //#region src/modules/compiled-workflows/create-story.ts
 const logger$18 = createLogger("compiled-workflows:create-story");
 /**
+* Compute a hex SHA-256 of the normalized source AC section text.
+*
+* Normalization (minimal — avoids spurious regen from editor whitespace noise):
+*   1. Split on `\n`
+*   2. Strip trailing whitespace from each line (`.trimEnd()`)
+*   3. Rejoin with `\n`
+*   4. Trim the whole result (`.trim()`)
+*
+* Pure function: no I/O, no side effects. Safe to call from tests with zero setup.
+*/
+function hashSourceAcSection(section) {
+	const normalized = section.split("\n").map((line) => line.trimEnd()).join("\n").trim();
+	return createHash("sha256").update(normalized, "utf8").digest("hex");
+}
+/**
 * Execute the compiled create-story workflow.
 *
 * Steps:
@@ -5693,7 +5708,7 @@ const logger$18 = createLogger("compiled-workflows:create-story");
 * @returns Promise resolving to CreateStoryResult
 */
 async function runCreateStory(deps, params) {
-	const { epicId, storyKey, pipelineRunId } = params;
+	const { epicId, storyKey, pipelineRunId, source_ac_hash } = params;
 	logger$18.debug({
 		epicId,
 		storyKey,
@@ -5764,7 +5779,12 @@ async function runCreateStory(deps, params) {
 			name: "story_template",
 			content: storyTemplateContent,
 			priority: "important"
-		}
+		},
+		...source_ac_hash !== void 0 ? [{
+			name: "source_ac_hash",
+			content: source_ac_hash,
+			priority: "required"
+		}] : []
 	], TOKEN_CEILING);
 	logger$18.debug({
 		tokenCount,
@@ -5911,13 +5931,14 @@ async function getImplementationDecisions(deps, pipelineRunId) {
 */
 function extractStorySection(shardContent, storyKey) {
 	if (!shardContent || !storyKey) return null;
-	const escaped = storyKey.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-	const headingPattern = new RegExp(`(?:^#{2,4}\\s+Story\\s+${escaped}\\b|^Story\\s+${escaped}:|^\\*\\*${escaped}\\*\\*|^${escaped}:)`, "mi");
+	const parts = storyKey.split(/[-._ ]/);
+	const normalized = parts.map((p) => p.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")).join("[-._ ]");
+	const headingPattern = new RegExp(`(?:^#{2,4}\\s+Story\\s+${normalized}\\b|^Story\\s+${normalized}:|^\\*\\*${normalized}\\*\\*|^${normalized}:)`, "mi");
 	const match$2 = headingPattern.exec(shardContent);
 	if (!match$2) return null;
 	const startIdx = match$2.index;
 	const rest = shardContent.slice(startIdx + match$2[0].length);
-	const nextStoryPattern = new RegExp(`(?:^#{2,4}\\s+Story\\s+[\\d]|^Story\\s+[\\d][\\d-]*:|^\\*\\*[\\d][\\d-]*\\*\\*|^[\\d][\\d-]*:)`, "mi");
+	const nextStoryPattern = new RegExp(`(?:^#{2,4}\\s+Story\\s+[\\d]|^Story\\s+[\\d][\\d.\\-_a-z]*:|^\\*\\*[\\d][\\d.\\-_a-z]*\\*\\*|^[\\d][\\d.\\-_a-z]*:)`, "mi");
 	const nextMatch = nextStoryPattern.exec(rest);
 	const endIdx = nextMatch !== null ? startIdx + match$2[0].length + nextMatch.index : shardContent.length;
 	const section = shardContent.slice(startIdx, endIdx).trim();
@@ -10429,7 +10450,8 @@ function assembleVerificationContext(opts) {
 		reviewResult: opts.reviewResult,
 		storyContent: opts.storyContent,
 		devStoryResult: opts.devStoryResult,
-		outputTokenCount: opts.outputTokenCount
+		outputTokenCount: opts.outputTokenCount,
+		sourceEpicContent: opts.sourceEpicContent
 	};
 }
 /**
@@ -11365,6 +11387,10 @@ function createImplementationOrchestrator(deps) {
 	let _costWarningEmitted = false;
 	let _budgetExhausted = false;
 	let _otlpEndpoint;
+	let _shutdownRequested = false;
+	let _inFlightCount = 0;
+	let _drainResolve = null;
+	let _drainPromise = Promise.resolve();
 	const verificationStore = new VerificationStore();
 	const verificationPipeline = createDefaultVerificationPipeline(toSdlcEventBus(eventBus));
 	const _stateStoreCache = new Map();
@@ -12002,6 +12028,7 @@ function createImplementationOrchestrator(deps) {
 			startedAt: new Date().toISOString()
 		});
 		let storyFilePath;
+		let sourceAcHash;
 		const artifactsDir = projectRoot ? join$1(projectRoot, "_bmad-output", "implementation-artifacts") : void 0;
 		if (artifactsDir && existsSync(artifactsDir)) try {
 			const files = readdirSync(artifactsDir);
@@ -12015,22 +12042,52 @@ function createImplementationOrchestrator(deps) {
 					reason: validation.reason
 				}, `Existing story file for ${storyKey} is invalid (${validation.reason}) — re-creating`);
 				else {
-					storyFilePath = candidatePath;
-					logger$24.info({
-						storyKey,
-						storyFilePath
-					}, "Found existing story file — skipping create-story");
-					endPhase(storyKey, "create-story");
-					eventBus.emit("orchestrator:story-phase-complete", {
-						storyKey,
-						phase: "IN_STORY_CREATION",
-						result: {
-							result: "success",
-							story_file: storyFilePath,
-							story_key: storyKey
+					let isDrift = false;
+					try {
+						const epicsPath = projectRoot ? findEpicsFile(projectRoot) : void 0;
+						if (epicsPath !== void 0) {
+							const epicContent = readFileSync(epicsPath, "utf-8");
+							const sourceSection = extractStorySection(epicContent, storyKey);
+							if (sourceSection != null) {
+								const currentHash = hashSourceAcSection(sourceSection);
+								sourceAcHash = currentHash;
+								const artifactContent = await readFile$1(candidatePath, "utf-8");
+								const hashMatch = /<!--\s*source-ac-hash:\s*([0-9a-f]{64})\s*-->/.exec(artifactContent);
+								const storedHash = hashMatch?.[1] ?? null;
+								if (storedHash !== currentHash) {
+									isDrift = true;
+									eventBus.emit("story:ac-source-drift", {
+										storyKey,
+										storedHash,
+										currentHash
+									});
+									logger$24.info({
+										storyKey,
+										storedHash,
+										currentHash
+									}, `[orchestrator] story ${storyKey}: source AC hash mismatch, regenerating story artifact`);
+								}
+							}
 						}
-					});
-					await persistState();
+					} catch {}
+					if (!isDrift) {
+						storyFilePath = candidatePath;
+						logger$24.info({
+							storyKey,
+							storyFilePath
+						}, "Found existing story file — skipping create-story");
+						endPhase(storyKey, "create-story");
+						eventBus.emit("orchestrator:story-phase-complete", {
+							storyKey,
+							phase: "IN_STORY_CREATION",
+							result: {
+								result: "success",
+								story_file: storyFilePath,
+								story_key: storyKey
+							}
+						});
+						await persistState();
+					}
 				}
 			}
 		} catch {}
@@ -12067,7 +12124,8 @@ function createImplementationOrchestrator(deps) {
 			}, {
 				epicId: storyKey.split("-")[0] ?? storyKey,
 				storyKey,
-				pipelineRunId: config.pipelineRunId
+				pipelineRunId: config.pipelineRunId,
+				source_ac_hash: sourceAcHash
 			});
 			endPhase(storyKey, "create-story");
 			eventBus.emit("orchestrator:story-phase-complete", {
@@ -13258,13 +13316,21 @@ function createImplementationOrchestrator(deps) {
 						error: reviewResult.error,
 						rawOutput: reviewResult.rawOutput
 					} : void 0;
+					let sourceEpicContent;
+					const epicsPath1 = findEpicsFile(projectRoot ?? process.cwd());
+					if (epicsPath1) try {
+						const epicFull = readFileSync(epicsPath1, "utf-8");
+						const section = extractStorySection(epicFull, storyKey);
+						if (section) sourceEpicContent = section;
+					} catch {}
 					const verifContext = assembleVerificationContext({
 						storyKey,
 						workingDir: projectRoot ?? process.cwd(),
 						reviewResult: latestReviewSignals,
 						storyContent: storyContentForVerification,
 						devStoryResult: devStorySignals,
-						outputTokenCount: devOutputTokenCount
+						outputTokenCount: devOutputTokenCount,
+						sourceEpicContent
 					});
 					const verifSummary = await verificationPipeline.run(verifContext, "A");
 					verificationStore.set(storyKey, verifSummary);
@@ -13522,13 +13588,21 @@ function createImplementationOrchestrator(deps) {
 						error: reviewResult.error,
 						rawOutput: reviewResult.rawOutput
 					} : void 0;
+					let sourceEpicContent2;
+					const epicsPath2 = findEpicsFile(projectRoot ?? process.cwd());
+					if (epicsPath2) try {
+						const epicFull2 = readFileSync(epicsPath2, "utf-8");
+						const section2 = extractStorySection(epicFull2, storyKey);
+						if (section2) sourceEpicContent2 = section2;
+					} catch {}
 					const verifContext = assembleVerificationContext({
 						storyKey,
 						workingDir: projectRoot ?? process.cwd(),
 						reviewResult: latestReviewSignals,
 						storyContent: storyContentForVerification,
 						devStoryResult: devStorySignals,
-						outputTokenCount: devOutputTokenCount
+						outputTokenCount: devOutputTokenCount,
+						sourceEpicContent: sourceEpicContent2
 					});
 					const verifSummary = await verificationPipeline.run(verifContext, "A");
 					verificationStore.set(storyKey, verifSummary);
@@ -13880,6 +13954,10 @@ function createImplementationOrchestrator(deps) {
 	async function processConflictGroup(group) {
 		const completedStoryKeys = [];
 		for (const storyKey of group) {
+			if (_shutdownRequested) {
+				logger$24.info({ storyKey }, "shutdown requested — skipping dispatch");
+				return;
+			}
 			if (runManifest !== null && runManifest !== void 0) try {
 				const manifestData = await runManifest.read();
 				const ceiling = manifestData.cli_flags.cost_ceiling;
@@ -13938,11 +14016,15 @@ function createImplementationOrchestrator(deps) {
 		const running = new Set();
 		function enqueue() {
 			if (_budgetExhausted) return;
+			if (_shutdownRequested) return;
 			const group = queue.shift();
 			if (group === void 0) return;
+			_inFlightCount++;
 			const p = processConflictGroup(group).finally(() => {
 				running.delete(p);
-				while (running.size < maxConcurrency && queue.length > 0) enqueue();
+				_inFlightCount--;
+				if (_inFlightCount === 0 && _shutdownRequested) _drainResolve?.();
+				while (running.size < maxConcurrency && queue.length > 0 && !_shutdownRequested && !_budgetExhausted) enqueue();
 			});
 			running.add(p);
 			if (running.size > _maxConcurrentActual) _maxConcurrentActual = running.size;
@@ -13951,6 +14033,47 @@ function createImplementationOrchestrator(deps) {
 		for (let i = 0; i < initial; i++) enqueue();
 		while (running.size > 0) await Promise.race(running);
 	}
+	/**
+	* Gracefully shut down the pipeline in response to a POSIX signal.
+	*
+	* 1. Sets the in-memory `_shutdownRequested` flag so the dispatch loop stops
+	*    scheduling new stories.
+	* 2. Awaits any in-flight dispatches for up to `config.shutdownGracePeriodMs` ms
+	*    (default 5000).
+	* 3. Writes `run_status: 'stopped'` and `stopped_reason` to the run manifest.
+	* 4. Best-effort: updates `pipeline_runs.status = 'stopped'` in Dolt and
+	*    transitions active wg_stories to 'cancelled'.
+	* 5. Calls `process.exit(130)` for SIGINT or `process.exit(143)` for SIGTERM.
+	*/
+	async function shutdownGracefully(reason, signal) {
+		if (_shutdownRequested) return;
+		_shutdownRequested = true;
+		logger$24.info({
+			reason,
+			signal
+		}, "Graceful shutdown initiated");
+		const gracePeriod = config.shutdownGracePeriodMs ?? 5e3;
+		if (_inFlightCount === 0) _drainResolve?.();
+		await Promise.race([_drainPromise, new Promise((resolve$6) => setTimeout(resolve$6, gracePeriod))]);
+		if (runManifest !== null && runManifest !== void 0) await runManifest.patchRunStatus({
+			run_status: "stopped",
+			stopped_reason: reason,
+			stopped_at: new Date().toISOString()
+		}).catch((err) => logger$24.warn({ err }, "patchRunStatus failed during shutdown (best-effort)"));
+		if (config.pipelineRunId !== void 0) try {
+			await updatePipelineRun(db, config.pipelineRunId, { status: "stopped" });
+		} catch (err) {
+			logger$24.warn({ err }, "updatePipelineRun(stopped) failed during shutdown (best-effort)");
+		}
+		for (const [storyKey, storyState] of _stories) {
+			const isActive = storyState.phase === "PENDING" || storyState.phase === "IN_STORY_CREATION" || storyState.phase === "IN_TEST_PLANNING" || storyState.phase === "IN_DEV" || storyState.phase === "IN_REVIEW" || storyState.phase === "NEEDS_FIXES" || storyState.phase === "CHECKPOINT";
+			if (isActive) wgRepo.updateStoryStatus(storyKey, "cancelled").catch((err) => logger$24.warn({
+				err,
+				storyKey
+			}, "updateStoryStatus(cancelled) failed during shutdown (best-effort)"));
+		}
+		process.exit(signal === "SIGINT" ? 130 : 143);
+	}
 	async function run(storyKeys) {
 		if (_state === "RUNNING" || _state === "PAUSED") {
 			logger$24.warn({ state: _state }, "run() called while orchestrator is already running or paused — ignoring");
@@ -13962,6 +14085,20 @@ function createImplementationOrchestrator(deps) {
 		}
 		_state = "RUNNING";
 		_startedAt = new Date().toISOString();
+		_shutdownRequested = false;
+		_inFlightCount = 0;
+		_drainResolve = null;
+		_drainPromise = new Promise((resolve$6) => {
+			_drainResolve = resolve$6;
+		});
+		const sigtermHandler = () => {
+			shutdownGracefully("killed_by_user", "SIGTERM");
+		};
+		const sigintHandler = () => {
+			shutdownGracefully("killed_by_user", "SIGINT");
+		};
+		process.on("SIGTERM", sigtermHandler);
+		process.on("SIGINT", sigintHandler);
 		for (const key of storyKeys) {
 			const pendingState = {
 				phase: "PENDING",
@@ -14246,6 +14383,8 @@ function createImplementationOrchestrator(deps) {
 			await persistState();
 			return getStatus();
 		} finally {
+			process.off("SIGTERM", sigtermHandler);
+			process.off("SIGINT", sigintHandler);
 			if (stateStore !== void 0) await stateStore.close().catch((err) => logger$24.warn({ err }, "StateStore.close() failed (best-effort)"));
 			if (ingestionServer !== void 0) await ingestionServer.stop().catch((err) => logger$24.warn({ err }, "IngestionServer.stop() failed (best-effort)"));
 		}
@@ -43840,4 +43979,4 @@ function registerRunCommand(program, _version = "0.0.0", projectRoot = process.c
 
 //#endregion
 export { AdapterTelemetryPersistence, AppError, DoltRepoMapMetaRepository, DoltSymbolRepository, ERR_REPO_MAP_STORAGE_WRITE, EpicIngester, GitClient, GrammarLoader, RepoMapInjector, RepoMapModule, RepoMapQueryEngine, RepoMapStorage, SymbolParser, createContextCompiler, createDispatcher, createEventEmitter, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStopAfterGate, createTelemetryAdvisor, formatPhaseCompletionSummary, getFactoryRunSummaries, getScenarioResultsForRun, getTwinRunsForRun, listGraphRuns, normalizeGraphSummaryToStatus, registerExportCommand, registerFactoryCommand, registerRunCommand, registerScenariosCommand, resolveMaxReviewCycles, resolveStoryKeys, runAnalysisPhase, runPlanningPhase, runRunAction, runSolutioningPhase, validateStopAfterFromConflict, wireNdjsonEmitter };
-//# sourceMappingURL=run-BcwaSYTg.js.map
+//# sourceMappingURL=run-D5VAkItq.js.map

package/package.json

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