substrate-ai 0.7.0 → 0.8.0

package/dist/{run-CfF0-tVP.js → run-ohzPz3r1.js}

@@ -1,4 +1,4 @@
-import { BMAD_BASELINE_TOKENS_FULL, DoltClient, DoltMergeConflict, FileStateStore, STOP_AFTER_VALID_PHASES, STORY_KEY_PATTERN, VALID_PHASES, WorkGraphRepository, __commonJS, __require, __toESM, buildPipelineStatusOutput, createDatabaseAdapter, formatOutput, formatPipelineSummary, formatTokenTelemetry, initSchema, inspectProcessTree, parseDbTimestampAsUtc, resolveMainRepoRoot, validateStoryKey } from "./health-Dnx-FGva.js";
+import { BMAD_BASELINE_TOKENS_FULL, DoltClient, DoltMergeConflict, FileStateStore, STOP_AFTER_VALID_PHASES, STORY_KEY_PATTERN, VALID_PHASES, WorkGraphRepository, __commonJS, __require, __toESM, buildPipelineStatusOutput, createDatabaseAdapter, formatOutput, formatPipelineSummary, formatTokenTelemetry, initSchema, inspectProcessTree, parseDbTimestampAsUtc, resolveMainRepoRoot, validateStoryKey } from "./health-C-VRJruD.js";
 import { createLogger, deepMask } from "./logger-D2fS2ccL.js";
 import { CURRENT_CONFIG_FORMAT_VERSION, PartialSubstrateConfigSchema, SUPPORTED_CONFIG_FORMAT_VERSIONS, SubstrateConfigSchema, defaultConfigMigrator } from "./config-migrator-CtGelIsG.js";
 import { ConfigError, ConfigIncompatibleFormatError, createEventBus, createTuiApp, isTuiCapable, printNonTtyWarning, sleep } from "./helpers-CpMs8VZX.js";
@@ -7,7 +7,7 @@ import { addTokenUsage, createDecision, createPipelineRun, createRequirement, ge
 import { ADVISORY_NOTES, ESCALATION_DIAGNOSIS, OPERATIONAL_FINDING, STORY_METRICS, STORY_OUTCOME, TEST_EXPANSION_FINDING, TEST_PLAN, aggregateTokenUsageForRun, aggregateTokenUsageForStory, getStoryMetricsForRun, writeRunMetrics, writeStoryMetrics } from "./operational-BdcdmDqS.js";
 import { dirname, join, resolve } from "path";
 import { access, mkdir, readFile, readdir, stat, writeFile } from "fs/promises";
-import { existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync } from "fs";
+import { existsSync, mkdirSync, readFileSync, readdirSync, unlinkSync, writeFileSync } from "fs";
 import yaml from "js-yaml";
 import { z } from "zod";
 import { execFile, execSync, spawn } from "node:child_process";
@@ -4665,7 +4665,7 @@ const DEFAULT_TIMEOUTS = {
 	"create-story": 6e5,
 	"dev-story": 18e5,
 	"code-review": 9e5,
-	"minor-fixes": 6e5,
+	"minor-fixes": 12e5,
 	"major-rework": 9e5,
 	"readiness-check": 6e5,
 	"elicitation": 9e5,
@@ -5669,7 +5669,22 @@ function runBuildVerification(options) {
 */
 function checkGitDiffFiles(workingDir = process.cwd()) {
 	const results = new Set();
+	let repoHasCommits = true;
 	try {
+		execSync("git rev-parse --verify HEAD", {
+			cwd: workingDir,
+			stdio: [
+				"ignore",
+				"pipe",
+				"pipe"
+			],
+			timeout: 3e3
+		});
+	} catch {
+		repoHasCommits = false;
+	}
+	try {
+		if (!repoHasCommits) throw new Error("no commits — skip HEAD diff");
 		const unstaged = execSync("git diff --name-only HEAD", {
 			cwd: workingDir,
 			encoding: "utf-8",
@@ -6600,6 +6615,27 @@ async function isValidStoryFile(filePath) {
 //#region src/modules/compiled-workflows/git-helpers.ts
 const logger$19 = createLogger("compiled-workflows:git-helpers");
 /**
+* Check whether the repo at `cwd` has at least one commit (HEAD resolves).
+* Returns false for fresh repos with no commits, avoiding `fatal: bad revision 'HEAD'`.
+* Synchronous (execSync) to keep it simple — this is a fast local check.
+*/
+function hasCommits(cwd) {
+	try {
+		execSync("git rev-parse --verify HEAD", {
+			cwd,
+			stdio: [
+				"ignore",
+				"pipe",
+				"pipe"
+			],
+			timeout: 3e3
+		});
+		return true;
+	} catch {
+		return false;
+	}
+}
+/**
 * Capture the full git diff for HEAD (working tree vs current commit).
 *
 * Runs `git diff HEAD` in the specified working directory and returns
@@ -6613,6 +6649,10 @@ const logger$19 = createLogger("compiled-workflows:git-helpers");
 * @returns The diff output string, or '' on error
 */
 async function getGitDiffSummary(workingDirectory = process.cwd()) {
+	if (!hasCommits(workingDirectory)) {
+		logger$19.debug({ cwd: workingDirectory }, "No commits in repo — returning empty diff");
+		return "";
+	}
 	return runGitCommand(["diff", "HEAD"], workingDirectory, "git-diff-summary");
 }
 /**
@@ -6626,6 +6666,10 @@ async function getGitDiffSummary(workingDirectory = process.cwd()) {
 * @returns The stat summary string, or '' on error
 */
 async function getGitDiffStatSummary(workingDirectory = process.cwd()) {
+	if (!hasCommits(workingDirectory)) {
+		logger$19.debug({ cwd: workingDirectory }, "No commits in repo — returning empty stat");
+		return "";
+	}
 	return runGitCommand([
 		"diff",
 		"--stat",
@@ -6648,6 +6692,10 @@ async function getGitDiffStatSummary(workingDirectory = process.cwd()) {
 */
 async function getGitDiffForFiles(files, workingDirectory = process.cwd()) {
 	if (files.length === 0) return "";
+	if (!hasCommits(workingDirectory)) {
+		logger$19.debug({ cwd: workingDirectory }, "No commits in repo — returning empty diff for files");
+		return "";
+	}
 	await stageIntentToAdd(files, workingDirectory);
 	return runGitCommand([
 		"diff",
@@ -6671,6 +6719,10 @@ async function getGitDiffForFiles(files, workingDirectory = process.cwd()) {
 */
 async function getGitDiffStatForFiles(files, workingDirectory = process.cwd()) {
 	if (files.length === 0) return "";
+	if (!hasCommits(workingDirectory)) {
+		logger$19.debug({ cwd: workingDirectory }, "No commits in repo — returning empty stat for files");
+		return "";
+	}
 	return runGitCommand([
 		"diff",
 		"--stat",
@@ -10706,22 +10758,49 @@ var IngestionServer = class {
 	/**
 	* Start the HTTP ingestion server.
 	* Resolves when the server is listening and ready to accept connections.
+	* On EADDRINUSE, retries up to 10 consecutive ports before failing.
 	*/
 	async start() {
 		if (this._server !== null) {
 			logger$8.warn("IngestionServer.start() called while already started — ignoring");
 			return;
 		}
+		const maxRetries = 10;
+		let lastErr;
+		for (let attempt = 0; attempt <= maxRetries; attempt++) {
+			const port = this._port + attempt;
+			try {
+				await this._tryListen(port);
+				return;
+			} catch (err) {
+				const nodeErr = err;
+				if (nodeErr.code === "EADDRINUSE" && attempt < maxRetries) {
+					logger$8.warn({
+						port,
+						attempt: attempt + 1
+					}, `Port ${port} in use — trying ${port + 1}`);
+					lastErr = nodeErr;
+					continue;
+				}
+				throw err;
+			}
+		}
+		throw lastErr ?? new Error("IngestionServer: exhausted port retry attempts");
+	}
+	_tryListen(port) {
 		return new Promise((resolve$2, reject) => {
 			const server = createServer(this._handleRequest.bind(this));
 			server.on("error", (err) => {
-				logger$8.error({ err }, "IngestionServer failed to start");
+				server.close();
 				reject(err);
 			});
-			server.listen(this._port, "127.0.0.1", () => {
+			server.listen(port, "127.0.0.1", () => {
 				this._server = server;
 				const addr = server.address();
-				logger$8.info({ port: addr.port }, "IngestionServer listening");
+				logger$8.info({
+					port: addr.port,
+					requestedPort: this._port
+				}, "IngestionServer listening");
 				this._buffer?.start();
 				resolve$2();
 			});
@@ -13190,7 +13269,8 @@ function wgStatusForPhase(phase) {
 		case "IN_TEST_PLANNING":
 		case "IN_DEV":
 		case "IN_REVIEW":
-		case "NEEDS_FIXES": return "in_progress";
+		case "NEEDS_FIXES":
+		case "CHECKPOINT": return "in_progress";
 		case "COMPLETE": return "complete";
 		case "ESCALATED": return "escalated";
 	}
@@ -13279,6 +13359,7 @@ function createImplementationOrchestrator(deps) {
 	let _contractMismatches;
 	let _otlpEndpoint;
 	const _stateStoreCache = new Map();
+	const _checkpoints = new Map();
 	const MEMORY_PRESSURE_BACKOFF_MS = [
 		3e4,
 		6e4,
@@ -13489,7 +13570,8 @@ function createImplementationOrchestrator(deps) {
 			lastVerdict: record.lastVerdict,
 			error: record.error,
 			startedAt: record.startedAt,
-			completedAt: record.completedAt
+			completedAt: record.completedAt,
+			checkpointFilesCount: record.checkpointFilesCount
 		};
 		for (const [key, s] of _stories) stories[key] = { ...s };
 		const status = {
@@ -13562,7 +13644,8 @@ function createImplementationOrchestrator(deps) {
 				error: state.error,
 				startedAt: state.startedAt,
 				completedAt: state.completedAt,
-				sprint: config.sprint
+				sprint: config.sprint,
+				checkpointFilesCount: state.checkpointFilesCount
 			};
 			await stateStore.setStoryState(storyKey, record);
 		} catch (err) {
@@ -14165,7 +14248,187 @@ function createImplementationOrchestrator(deps) {
 					result: devResult
 				});
 				await persistState();
-				if (devResult.result === "success") devStoryWasSuccess = true;
+				let checkpointHandled = false;
+				if (devResult.result === "failed" && devResult.error?.startsWith("dispatch_timeout")) {
+					endPhase(storyKey, "dev-story");
+					const timeoutFiles = checkGitDiffFiles(projectRoot ?? process.cwd());
+					if (timeoutFiles.length === 0) {
+						logger$25.warn({ storyKey }, "Dev-story timeout with zero modified files — escalating immediately (no checkpoint)");
+						updateStory(storyKey, {
+							phase: "ESCALATED",
+							error: "timeout-no-files",
+							completedAt: new Date().toISOString()
+						});
+						await writeStoryMetricsBestEffort(storyKey, "escalated", 0);
+						await emitEscalation({
+							storyKey,
+							lastVerdict: "timeout-no-files",
+							reviewCycles: 0,
+							issues: ["dev-story timed out with no partial files — nothing to checkpoint"]
+						});
+						await persistState();
+						return;
+					}
+					logger$25.info({
+						storyKey,
+						filesCount: timeoutFiles.length
+					}, "Dev-story timeout with partial files — capturing checkpoint");
+					let gitDiff = "";
+					try {
+						gitDiff = execSync(`git diff HEAD -- ${timeoutFiles.map((f) => `"${f}"`).join(" ")}`, {
+							cwd: projectRoot ?? process.cwd(),
+							encoding: "utf-8",
+							timeout: 1e4,
+							stdio: [
+								"ignore",
+								"pipe",
+								"pipe"
+							]
+						}).trim();
+					} catch (diffErr) {
+						logger$25.warn({
+							storyKey,
+							error: diffErr instanceof Error ? diffErr.message : String(diffErr)
+						}, "Failed to capture git diff for checkpoint — proceeding with empty diff");
+					}
+					_checkpoints.set(storyKey, {
+						filesModified: timeoutFiles,
+						gitDiff,
+						partialOutput: devResult.error ?? ""
+					});
+					updateStory(storyKey, {
+						phase: "CHECKPOINT",
+						checkpointFilesCount: timeoutFiles.length
+					});
+					const diffSizeBytes = Buffer.byteLength(gitDiff, "utf-8");
+					eventBus.emit("story:checkpoint-saved", {
+						storyKey,
+						filesCount: timeoutFiles.length,
+						diffSizeBytes
+					});
+					if (stateStore !== void 0) stateStore.recordMetric({
+						storyKey,
+						taskType: "dev-story",
+						result: "timeout",
+						recordedAt: new Date().toISOString(),
+						sprint: config.sprint
+					}).catch((storeErr) => {
+						logger$25.warn({
+							err: storeErr,
+							storyKey
+						}, "Failed to record timeout metric to StateStore (best-effort)");
+					});
+					await persistState();
+					eventBus.emit("story:checkpoint-retry", {
+						storyKey,
+						filesCount: timeoutFiles.length,
+						attempt: 2
+					});
+					const checkpointData = _checkpoints.get(storyKey);
+					let checkpointRetryPrompt;
+					let checkpointRetryMaxTurns;
+					try {
+						const devStoryTemplate = await pack.getPrompt("dev-story");
+						const storyContent = await readFile$1(storyFilePath ?? "", "utf-8");
+						const complexity = computeStoryComplexity(storyContent);
+						checkpointRetryMaxTurns = resolveDevStoryMaxTurns(complexity.complexityScore);
+						logComplexityResult(storyKey, complexity, checkpointRetryMaxTurns);
+						let archConstraints = "";
+						try {
+							const decisions = await getDecisionsByPhase(db, "solutioning");
+							const constraints = decisions.filter((d) => d.category === "architecture");
+							archConstraints = constraints.map((d) => `${d.key}: ${d.value}`).join("\n");
+						} catch {}
+						const checkpointContext = [
+							"Your prior attempt timed out. Here is the work you completed:",
+							"",
+							`Files modified (${checkpointData.filesModified.length}):`,
+							...checkpointData.filesModified.map((f) => `- ${f}`),
+							"",
+							"```diff",
+							checkpointData.gitDiff || "(no diff available)",
+							"```",
+							"",
+							"Continue from where you left off. Do not redo completed work."
+						].join("\n");
+						const sections = [
+							{
+								name: "story_content",
+								content: storyContent,
+								priority: "required"
+							},
+							{
+								name: "checkpoint_context",
+								content: checkpointContext,
+								priority: "required"
+							},
+							{
+								name: "arch_constraints",
+								content: archConstraints,
+								priority: "optional"
+							}
+						];
+						const assembled = assemblePrompt(devStoryTemplate, sections, 24e3);
+						checkpointRetryPrompt = assembled.prompt;
+					} catch {
+						checkpointRetryPrompt = `Continue story ${storyKey} from checkpoint. Your prior attempt timed out. Do not redo completed work.`;
+						logger$25.warn({ storyKey }, "Failed to assemble checkpoint retry prompt — using fallback");
+					}
+					logger$25.info({
+						storyKey,
+						filesCount: checkpointData.filesModified.length
+					}, "Dispatching checkpoint retry for timed-out story");
+					incrementDispatches(storyKey);
+					updateStory(storyKey, { phase: "IN_DEV" });
+					startPhase(storyKey, "dev-story-retry");
+					const checkpointRetryHandle = dispatcher.dispatch({
+						prompt: checkpointRetryPrompt,
+						agent: "claude-code",
+						taskType: "dev-story",
+						outputSchema: DevStoryResultSchema,
+						...checkpointRetryMaxTurns !== void 0 ? { maxTurns: checkpointRetryMaxTurns } : {},
+						...projectRoot !== void 0 ? { workingDirectory: projectRoot } : {},
+						..._otlpEndpoint !== void 0 ? { otlpEndpoint: _otlpEndpoint } : {},
+						...config.perStoryContextCeilings?.[storyKey] !== void 0 ? { maxContextTokens: config.perStoryContextCeilings[storyKey] } : {},
+						storyKey
+					});
+					const checkpointRetryResult = await checkpointRetryHandle.result;
+					endPhase(storyKey, "dev-story-retry");
+					eventBus.emit("orchestrator:story-phase-complete", {
+						storyKey,
+						phase: "IN_DEV",
+						result: { tokenUsage: checkpointRetryResult.tokenEstimate ? {
+							input: checkpointRetryResult.tokenEstimate.input,
+							output: checkpointRetryResult.tokenEstimate.output
+						} : void 0 }
+					});
+					if (checkpointRetryResult.status === "timeout") {
+						logger$25.warn({ storyKey }, "Checkpoint retry dispatch timed out — escalating story");
+						updateStory(storyKey, {
+							phase: "ESCALATED",
+							error: "checkpoint-retry-timeout",
+							completedAt: new Date().toISOString()
+						});
+						await writeStoryMetricsBestEffort(storyKey, "escalated", 0);
+						await emitEscalation({
+							storyKey,
+							lastVerdict: "checkpoint-retry-timeout",
+							reviewCycles: 0,
+							issues: ["checkpoint retry timed out — no infinite retry loop"]
+						});
+						await persistState();
+						return;
+					}
+					const retryParsed = checkpointRetryResult.parsed;
+					devFilesModified = retryParsed?.files_modified ?? checkGitDiffFiles(projectRoot ?? process.cwd());
+					if (checkpointRetryResult.status === "completed" && retryParsed?.result === "success") devStoryWasSuccess = true;
+					else logger$25.warn({
+						storyKey,
+						status: checkpointRetryResult.status
+					}, "Checkpoint retry completed with failure — proceeding to code review");
+					checkpointHandled = true;
+				}
+				if (!checkpointHandled) if (devResult.result === "success") devStoryWasSuccess = true;
 				else logger$25.warn({
 					storyKey,
 					error: devResult.error,
@@ -19715,6 +19978,189 @@ function mapInternalPhaseToEventPhase(internalPhase) {
 		default: return null;
 	}
 }
+/**
+* Wire all NDJSON event subscriptions from the event bus to the emitter.
+* Shared helper called from both the implementation-only path and the full
+* pipeline path (AC2: shared event subscription logic).
+*/
+function wireNdjsonEmitter(eventBus, ndjsonEmitter) {
+	eventBus.on("orchestrator:story-phase-start", (payload) => {
+		const phase = mapInternalPhaseToEventPhase(payload.phase);
+		if (phase !== null) ndjsonEmitter.emit({
+			type: "story:phase",
+			ts: new Date().toISOString(),
+			key: payload.storyKey,
+			phase,
+			status: "in_progress"
+		});
+	});
+	eventBus.on("orchestrator:story-phase-complete", (payload) => {
+		const phase = mapInternalPhaseToEventPhase(payload.phase);
+		if (phase !== null) {
+			const result = payload.result;
+			ndjsonEmitter.emit({
+				type: "story:phase",
+				ts: new Date().toISOString(),
+				key: payload.storyKey,
+				phase,
+				status: "complete",
+				...phase === "code-review" && result?.verdict !== void 0 ? { verdict: result.verdict } : {},
+				...phase === "create-story" && result?.story_file !== void 0 ? { file: result.story_file } : {}
+			});
+		}
+	});
+	eventBus.on("routing:model-selected", (payload) => {
+		ndjsonEmitter.emit({
+			type: "routing:model-selected",
+			ts: new Date().toISOString(),
+			dispatch_id: payload.dispatchId,
+			task_type: payload.taskType,
+			phase: payload.phase,
+			model: payload.model,
+			source: payload.source
+		});
+	});
+	eventBus.on("orchestrator:story-complete", (payload) => {
+		ndjsonEmitter.emit({
+			type: "story:done",
+			ts: new Date().toISOString(),
+			key: payload.storyKey,
+			result: "success",
+			review_cycles: payload.reviewCycles
+		});
+	});
+	eventBus.on("orchestrator:story-escalated", (payload) => {
+		const rawIssues = Array.isArray(payload.issues) ? payload.issues : [];
+		const issues = rawIssues.map((issue) => {
+			const iss = issue;
+			return {
+				severity: iss.severity ?? "unknown",
+				file: iss.file ?? "",
+				desc: iss.desc ?? iss.description ?? ""
+			};
+		});
+		ndjsonEmitter.emit({
+			type: "story:escalation",
+			ts: new Date().toISOString(),
+			key: payload.storyKey,
+			reason: payload.lastVerdict ?? "escalated",
+			cycles: payload.reviewCycles ?? 0,
+			issues,
+			...payload.diagnosis !== void 0 ? { diagnosis: payload.diagnosis } : {}
+		});
+	});
+	eventBus.on("orchestrator:story-warn", (payload) => {
+		ndjsonEmitter.emit({
+			type: "story:warn",
+			ts: new Date().toISOString(),
+			key: payload.storyKey,
+			msg: payload.msg
+		});
+	});
+	eventBus.on("orchestrator:heartbeat", (payload) => {
+		ndjsonEmitter.emit({
+			type: "pipeline:heartbeat",
+			ts: new Date().toISOString(),
+			run_id: payload.runId,
+			active_dispatches: payload.activeDispatches,
+			completed_dispatches: payload.completedDispatches,
+			queued_dispatches: payload.queuedDispatches
+		});
+	});
+	eventBus.on("orchestrator:stall", (payload) => {
+		ndjsonEmitter.emit({
+			type: "story:stall",
+			ts: new Date().toISOString(),
+			run_id: payload.runId,
+			story_key: payload.storyKey,
+			phase: payload.phase,
+			elapsed_ms: payload.elapsedMs,
+			child_pids: payload.childPids,
+			child_active: payload.childActive
+		});
+	});
+	eventBus.on("orchestrator:zero-diff-escalation", (payload) => {
+		ndjsonEmitter.emit({
+			type: "story:zero-diff-escalation",
+			ts: new Date().toISOString(),
+			storyKey: payload.storyKey,
+			reason: payload.reason
+		});
+	});
+	eventBus.on("story:build-verification-passed", (payload) => {
+		ndjsonEmitter.emit({
+			type: "story:build-verification-passed",
+			ts: new Date().toISOString(),
+			storyKey: payload.storyKey
+		});
+	});
+	eventBus.on("story:build-verification-failed", (payload) => {
+		ndjsonEmitter.emit({
+			type: "story:build-verification-failed",
+			ts: new Date().toISOString(),
+			storyKey: payload.storyKey,
+			exitCode: payload.exitCode,
+			output: payload.output
+		});
+	});
+	eventBus.on("story:interface-change-warning", (payload) => {
+		ndjsonEmitter.emit({
+			type: "story:interface-change-warning",
+			ts: new Date().toISOString(),
+			storyKey: payload.storyKey,
+			modifiedInterfaces: payload.modifiedInterfaces,
+			potentiallyAffectedTests: payload.potentiallyAffectedTests
+		});
+	});
+	eventBus.on("story:metrics", (payload) => {
+		ndjsonEmitter.emit({
+			type: "story:metrics",
+			ts: new Date().toISOString(),
+			storyKey: payload.storyKey,
+			wallClockMs: payload.wallClockMs,
+			phaseBreakdown: payload.phaseBreakdown,
+			tokens: payload.tokens,
+			reviewCycles: payload.reviewCycles,
+			dispatches: payload.dispatches
+		});
+	});
+	eventBus.on("pipeline:pre-flight-failure", (payload) => {
+		ndjsonEmitter.emit({
+			type: "pipeline:pre-flight-failure",
+			ts: new Date().toISOString(),
+			exitCode: payload.exitCode,
+			output: payload.output + "\nTip: Use --skip-preflight to bypass, or check your build command in .substrate/project-profile.yaml"
+		});
+	});
+	eventBus.on("pipeline:contract-mismatch", (payload) => {
+		ndjsonEmitter.emit({
+			type: "pipeline:contract-mismatch",
+			ts: new Date().toISOString(),
+			exporter: payload.exporter,
+			importer: payload.importer,
+			contractName: payload.contractName,
+			mismatchDescription: payload.mismatchDescription
+		});
+	});
+	eventBus.on("pipeline:contract-verification-summary", (payload) => {
+		ndjsonEmitter.emit({
+			type: "pipeline:contract-verification-summary",
+			ts: new Date().toISOString(),
+			verified: payload.verified,
+			stalePruned: payload.stalePruned,
+			mismatches: payload.mismatches,
+			verdict: payload.verdict
+		});
+	});
+	eventBus.on("pipeline:profile-stale", (payload) => {
+		ndjsonEmitter.emit({
+			type: "pipeline:profile-stale",
+			ts: new Date().toISOString(),
+			message: payload.message,
+			indicators: payload.indicators
+		});
+	});
+}
 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, epic: epicNumber, dryRun, maxReviewCycles = 2, registry: injectedRegistry } = options;
 	if (startPhase !== void 0 && !VALID_PHASES.includes(startPhase)) {
@@ -19805,7 +20251,25 @@ async function runRunAction(options) {
 		}
 	}
 	let effectiveStartPhase = startPhase;
-	if (effectiveStartPhase === void 0) {
+	if (effectiveStartPhase === void 0) if (parsedStoryKeys.length > 0) {
+		const artifactsDir = join(projectRoot, "_bmad-output", "implementation-artifacts");
+		if (existsSync(artifactsDir)) {
+			let files;
+			try {
+				const result = readdirSync(artifactsDir, { encoding: "utf-8" });
+				if (Array.isArray(result)) files = result;
+			} catch {}
+			if (files !== void 0) for (const key of parsedStoryKeys) {
+				const found = files.some((f) => f.startsWith(`${key}-`) && f.endsWith(".md"));
+				if (!found) {
+					const errorMsg = `Story file not found for key: ${key}`;
+					if (outputFormat === "json") process.stdout.write(formatOutput(null, "json", false, errorMsg) + "\n");
+					else process.stderr.write(`Error: ${errorMsg}\n`);
+					return 1;
+				}
+			}
+		}
+	} else {
 		mkdirSync(dbDir, { recursive: true });
 		try {
 			const detectAdapter = createDatabaseAdapter({
@@ -19940,6 +20404,24 @@ async function runRunAction(options) {
 				...parsedStoryKeys.length > 0 ? { explicitStories: parsedStoryKeys } : {}
 			})
 		});
+		const runIdFilePath = join(dbDir, "current-run-id");
+		try {
+			writeFileSync(runIdFilePath, pipelineRun.id, "utf-8");
+			const cleanupRunIdFile = () => {
+				try {
+					unlinkSync(runIdFilePath);
+				} catch {}
+			};
+			process.on("exit", cleanupRunIdFile);
+			process.once("SIGTERM", () => {
+				cleanupRunIdFile();
+				process.exit(0);
+			});
+			process.once("SIGINT", () => {
+				cleanupRunIdFile();
+				process.exit(130);
+			});
+		} catch {}
 		const eventBus = createEventBus();
 		const contextCompiler = createContextCompiler({ db: adapter });
 		if (!injectedRegistry) throw new Error("AdapterRegistry is required — must be initialized at CLI startup");
@@ -20213,182 +20695,7 @@ async function runRunAction(options) {
 				stories: storyKeys,
 				concurrency
 			});
-			eventBus.on("orchestrator:story-phase-start", (payload) => {
-				const phase = mapInternalPhaseToEventPhase(payload.phase);
-				if (phase !== null) ndjsonEmitter.emit({
-					type: "story:phase",
-					ts: new Date().toISOString(),
-					key: payload.storyKey,
-					phase,
-					status: "in_progress"
-				});
-			});
-			eventBus.on("orchestrator:story-phase-complete", (payload) => {
-				const phase = mapInternalPhaseToEventPhase(payload.phase);
-				if (phase !== null) {
-					const result = payload.result;
-					ndjsonEmitter.emit({
-						type: "story:phase",
-						ts: new Date().toISOString(),
-						key: payload.storyKey,
-						phase,
-						status: "complete",
-						...phase === "code-review" && result?.verdict !== void 0 ? { verdict: result.verdict } : {},
-						...phase === "create-story" && result?.story_file !== void 0 ? { file: result.story_file } : {}
-					});
-				}
-			});
-			eventBus.on("routing:model-selected", (payload) => {
-				ndjsonEmitter.emit({
-					type: "routing:model-selected",
-					ts: new Date().toISOString(),
-					dispatch_id: payload.dispatchId,
-					task_type: payload.taskType,
-					phase: payload.phase,
-					model: payload.model,
-					source: payload.source
-				});
-			});
-			eventBus.on("orchestrator:story-complete", (payload) => {
-				ndjsonEmitter.emit({
-					type: "story:done",
-					ts: new Date().toISOString(),
-					key: payload.storyKey,
-					result: "success",
-					review_cycles: payload.reviewCycles
-				});
-			});
-			eventBus.on("orchestrator:story-escalated", (payload) => {
-				const rawIssues = Array.isArray(payload.issues) ? payload.issues : [];
-				const issues = rawIssues.map((issue) => {
-					const iss = issue;
-					return {
-						severity: iss.severity ?? "unknown",
-						file: iss.file ?? "",
-						desc: iss.desc ?? iss.description ?? ""
-					};
-				});
-				ndjsonEmitter.emit({
-					type: "story:escalation",
-					ts: new Date().toISOString(),
-					key: payload.storyKey,
-					reason: payload.lastVerdict ?? "escalated",
-					cycles: payload.reviewCycles ?? 0,
-					issues,
-					...payload.diagnosis !== void 0 ? { diagnosis: payload.diagnosis } : {}
-				});
-			});
-			eventBus.on("orchestrator:story-warn", (payload) => {
-				ndjsonEmitter.emit({
-					type: "story:warn",
-					ts: new Date().toISOString(),
-					key: payload.storyKey,
-					msg: payload.msg
-				});
-			});
-			eventBus.on("orchestrator:heartbeat", (payload) => {
-				ndjsonEmitter.emit({
-					type: "pipeline:heartbeat",
-					ts: new Date().toISOString(),
-					run_id: payload.runId,
-					active_dispatches: payload.activeDispatches,
-					completed_dispatches: payload.completedDispatches,
-					queued_dispatches: payload.queuedDispatches
-				});
-			});
-			eventBus.on("orchestrator:stall", (payload) => {
-				ndjsonEmitter.emit({
-					type: "story:stall",
-					ts: new Date().toISOString(),
-					run_id: payload.runId,
-					story_key: payload.storyKey,
-					phase: payload.phase,
-					elapsed_ms: payload.elapsedMs,
-					child_pids: payload.childPids,
-					child_active: payload.childActive
-				});
-			});
-			eventBus.on("orchestrator:zero-diff-escalation", (payload) => {
-				ndjsonEmitter.emit({
-					type: "story:zero-diff-escalation",
-					ts: new Date().toISOString(),
-					storyKey: payload.storyKey,
-					reason: payload.reason
-				});
-			});
-			eventBus.on("story:build-verification-passed", (payload) => {
-				ndjsonEmitter.emit({
-					type: "story:build-verification-passed",
-					ts: new Date().toISOString(),
-					storyKey: payload.storyKey
-				});
-			});
-			eventBus.on("story:build-verification-failed", (payload) => {
-				ndjsonEmitter.emit({
-					type: "story:build-verification-failed",
-					ts: new Date().toISOString(),
-					storyKey: payload.storyKey,
-					exitCode: payload.exitCode,
-					output: payload.output
-				});
-			});
-			eventBus.on("story:interface-change-warning", (payload) => {
-				ndjsonEmitter.emit({
-					type: "story:interface-change-warning",
-					ts: new Date().toISOString(),
-					storyKey: payload.storyKey,
-					modifiedInterfaces: payload.modifiedInterfaces,
-					potentiallyAffectedTests: payload.potentiallyAffectedTests
-				});
-			});
-			eventBus.on("story:metrics", (payload) => {
-				ndjsonEmitter.emit({
-					type: "story:metrics",
-					ts: new Date().toISOString(),
-					storyKey: payload.storyKey,
-					wallClockMs: payload.wallClockMs,
-					phaseBreakdown: payload.phaseBreakdown,
-					tokens: payload.tokens,
-					reviewCycles: payload.reviewCycles,
-					dispatches: payload.dispatches
-				});
-			});
-			eventBus.on("pipeline:pre-flight-failure", (payload) => {
-				ndjsonEmitter.emit({
-					type: "pipeline:pre-flight-failure",
-					ts: new Date().toISOString(),
-					exitCode: payload.exitCode,
-					output: payload.output + "\nTip: Use --skip-preflight to bypass, or check your build command in .substrate/project-profile.yaml"
-				});
-			});
-			eventBus.on("pipeline:contract-mismatch", (payload) => {
-				ndjsonEmitter.emit({
-					type: "pipeline:contract-mismatch",
-					ts: new Date().toISOString(),
-					exporter: payload.exporter,
-					importer: payload.importer,
-					contractName: payload.contractName,
-					mismatchDescription: payload.mismatchDescription
-				});
-			});
-			eventBus.on("pipeline:contract-verification-summary", (payload) => {
-				ndjsonEmitter.emit({
-					type: "pipeline:contract-verification-summary",
-					ts: new Date().toISOString(),
-					verified: payload.verified,
-					stalePruned: payload.stalePruned,
-					mismatches: payload.mismatches,
-					verdict: payload.verdict
-				});
-			});
-			eventBus.on("pipeline:profile-stale", (payload) => {
-				ndjsonEmitter.emit({
-					type: "pipeline:profile-stale",
-					ts: new Date().toISOString(),
-					message: payload.message,
-					indicators: payload.indicators
-				});
-			});
+			wireNdjsonEmitter(eventBus, ndjsonEmitter);
 		}
 		const ingestionServer = telemetryEnabled ? new IngestionServer({ port: telemetryPort }) : void 0;
 		if (ingestionServer !== void 0) {
@@ -20609,6 +20916,24 @@ async function runFullPipeline(options) {
 		});
 		const startedAt = Date.now();
 		const runId = await phaseOrchestrator.startRun(concept ?? "", startPhase);
+		const runIdFilePath = join(dbDir, "current-run-id");
+		try {
+			writeFileSync(runIdFilePath, runId, "utf-8");
+			const cleanupRunIdFile = () => {
+				try {
+					unlinkSync(runIdFilePath);
+				} catch {}
+			};
+			process.on("exit", cleanupRunIdFile);
+			process.once("SIGTERM", () => {
+				cleanupRunIdFile();
+				process.exit(0);
+			});
+			process.once("SIGINT", () => {
+				cleanupRunIdFile();
+				process.exit(130);
+			});
+		} catch {}
 		if (explicitStories !== void 0 && explicitStories.length > 0 || options.epic !== void 0) {
 			const existingRun = (await adapter.query("SELECT config_json FROM pipeline_runs WHERE id = ?", [runId]))[0];
 			const existing = JSON.parse(existingRun?.config_json ?? "{}");
@@ -20623,14 +20948,34 @@ async function runFullPipeline(options) {
 			process.stdout.write(`Starting full pipeline from phase: ${startPhase}\n`);
 			process.stdout.write(`Pipeline run ID: ${runId}\n`);
 		}
+		let fullPipelineNdjsonEmitter;
+		if (eventsFlag === true) {
+			fullPipelineNdjsonEmitter = createEventEmitter(process.stdout);
+			fullPipelineNdjsonEmitter.emit({
+				type: "pipeline:start",
+				ts: new Date().toISOString(),
+				run_id: runId,
+				stories: explicitStories ?? [],
+				concurrency
+			});
+			wireNdjsonEmitter(eventBus, fullPipelineNdjsonEmitter);
+		}
 		const phaseOrder = [];
 		if (effectiveResearch) phaseOrder.push("research");
 		phaseOrder.push("analysis", "planning");
 		if (effectiveUxDesign) phaseOrder.push("ux-design");
 		phaseOrder.push("solutioning", "implementation");
 		const startIdx = phaseOrder.indexOf(startPhase);
+		const fpSucceededKeys = [];
+		const fpFailedKeys = [];
+		const fpEscalatedKeys = [];
 		for (let i = startIdx; i < phaseOrder.length; i++) {
 			const currentPhase = phaseOrder[i];
+			if (fullPipelineNdjsonEmitter !== void 0) fullPipelineNdjsonEmitter.emit({
+				type: "pipeline:phase-start",
+				ts: new Date().toISOString(),
+				phase: currentPhase
+			});
 			if (outputFormat === "human") process.stdout.write(`\n[${currentPhase.toUpperCase()}] Starting...\n`);
 			if (currentPhase === "analysis") {
 				const result = await runAnalysisPhase(phaseDeps, {
@@ -20831,9 +21176,18 @@ async function runFullPipeline(options) {
 				});
 				if (storyKeys.length === 0 && outputFormat === "human") process.stdout.write("[IMPLEMENTATION] No stories found. Run solutioning first or pass --stories.\n");
 				if (outputFormat === "human") process.stdout.write(`[IMPLEMENTATION] Starting ${storyKeys.length} stories with concurrency=${concurrency}\n`);
-				await orchestrator.run(storyKeys);
+				const implStatus = await orchestrator.run(storyKeys);
 				if (outputFormat === "human") process.stdout.write("[IMPLEMENTATION] Complete\n");
+				for (const [key, s] of Object.entries(implStatus.stories)) if (s.phase === "COMPLETE") fpSucceededKeys.push(key);
+				else if (s.phase === "ESCALATED") if (s.error !== void 0) fpFailedKeys.push(key);
+				else fpEscalatedKeys.push(key);
+				else fpFailedKeys.push(key);
 			}
+			if (fullPipelineNdjsonEmitter !== void 0) fullPipelineNdjsonEmitter.emit({
+				type: "pipeline:phase-complete",
+				ts: new Date().toISOString(),
+				phase: currentPhase
+			});
 			if (stopAfter !== void 0 && currentPhase === stopAfter) {
 				const gate = createStopAfterGate(stopAfter);
 				if (gate.shouldHalt()) {
@@ -20882,6 +21236,13 @@ async function runFullPipeline(options) {
 			process.stdout.write("\n");
 			process.stdout.write(formatTokenTelemetry(tokenSummary, BMAD_BASELINE_TOKENS_FULL) + "\n");
 		}
+		if (fullPipelineNdjsonEmitter !== void 0) fullPipelineNdjsonEmitter.emit({
+			type: "pipeline:complete",
+			ts: new Date().toISOString(),
+			succeeded: fpSucceededKeys,
+			failed: fpFailedKeys,
+			escalated: fpEscalatedKeys
+		});
 		return 0;
 	} catch (err) {
 		const msg = err instanceof Error ? err.message : String(err);
@@ -20941,4 +21302,4 @@ function registerRunCommand(program, _version = "0.0.0", projectRoot = process.c
 
 //#endregion
 export { AdapterTelemetryPersistence, AppError, DEFAULT_CONFIG, DEFAULT_ROUTING_POLICY, DoltRepoMapMetaRepository, DoltSymbolRepository, ERR_REPO_MAP_STORAGE_WRITE, GitClient, GrammarLoader, IngestionServer, RepoMapInjector, RepoMapModule, RepoMapQueryEngine, RepoMapStorage, SymbolParser, createConfigSystem, createContextCompiler, createDispatcher, createEventEmitter, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStopAfterGate, createTelemetryAdvisor, formatPhaseCompletionSummary, registerRunCommand, resolveStoryKeys, runAnalysisPhase, runPlanningPhase, runRunAction, runSolutioningPhase, validateStopAfterFromConflict };
-//# sourceMappingURL=run-CfF0-tVP.js.map
+//# sourceMappingURL=run-ohzPz3r1.js.map