substrate-ai 0.20.56 → 0.20.57

package/dist/{decisions-8q99K5w4.js → decisions-4F91LrVD.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-ARkfvp4m.js";
+import { addTokenUsage, createDecision, createPipelineRun, createRequirement, getArtifactByTypeForRun, getArtifactsByRun, getDecisionsByCategory, getDecisionsByPhase, getDecisionsByPhaseForRun, getLatestRun, getPipelineRunById, getRunningPipelineRuns, getTokenUsageSummary, listRequirements, registerArtifact, updateDecision, updatePipelineRun, updatePipelineRunConfig, upsertDecision } from "./dist-W2emvN3F.js";
 import "./decisions-C0pz9Clx.js";
 
 export { getLatestRun };

package/dist/{dist-ARkfvp4m.js → dist-W2emvN3F.js}

@@ -861,6 +861,7 @@ function extractJsonAsYaml(text) {
 const SHUTDOWN_GRACE_MS = 1e4;
 const SHUTDOWN_MAX_WAIT_MS = 3e4;
 const CHARS_PER_TOKEN$3 = 4;
+const MAX_TAIL_BUFFER = 64 * 1024;
 /**
 * Extract top-level field names from a Zod schema for prompt injection.
 * Returns field names with type hints (e.g., "result: <string>", "files_modified: <list>").
@@ -1132,7 +1133,7 @@ var DispatcherImpl = class {
 		this._logger.info("Dispatcher shutdown complete");
 	}
 	async _startDispatch(id, request, resolve$2) {
-		const { prompt, agent, taskType, timeout, outputSchema, workingDirectory, model, maxTurns, maxContextTokens, otlpEndpoint, storyKey, optimizationDirectives } = request;
+		const { prompt, agent, taskType, timeout, outputSchema, workingDirectory, model, maxTurns, maxContextTokens, otlpEndpoint, storyKey, optimizationDirectives, attemptNumber } = request;
 		let effectiveModel = model;
 		if (effectiveModel === void 0 && this._config.routingResolver !== void 0) {
 			const resolution = this._config.routingResolver.resolveModel(taskType);
@@ -1235,8 +1236,15 @@ var DispatcherImpl = class {
 		}
 		const stdoutChunks = [];
 		const stderrChunks = [];
+		let stdoutSize = 0;
+		let stderrSize = 0;
 		if (proc.stdout !== null) proc.stdout.on("data", (chunk) => {
 			stdoutChunks.push(chunk);
+			stdoutSize += chunk.length;
+			while (stdoutSize > MAX_TAIL_BUFFER && stdoutChunks.length > 1) {
+				const dropped = stdoutChunks.shift();
+				stdoutSize -= dropped.length;
+			}
 			const dataStr = chunk.toString("utf-8");
 			this._eventBus.emit("agent:output", {
 				dispatchId: id,
@@ -1245,6 +1253,11 @@ var DispatcherImpl = class {
 		});
 		if (proc.stderr !== null) proc.stderr.on("data", (chunk) => {
 			stderrChunks.push(chunk);
+			stderrSize += chunk.length;
+			while (stderrSize > MAX_TAIL_BUFFER && stderrChunks.length > 1) {
+				const dropped = stderrChunks.shift();
+				stderrSize -= dropped.length;
+			}
 		});
 		const activeDispatch = {
 			id,
@@ -1273,8 +1286,9 @@ var DispatcherImpl = class {
 		}, "Agent dispatched");
 		activeDispatch.timeoutHandle = setTimeout(() => {
 			activeDispatch.timedOut = true;
+			const elapsedAtKill = Date.now() - startedAt;
 			proc.kill("SIGTERM");
-			const durationMs = Date.now() - startedAt;
+			const durationMs = elapsedAtKill;
 			const output = Buffer.concat(stdoutChunks).toString("utf-8");
 			const inputTokens = Math.ceil(prompt.length / CHARS_PER_TOKEN$3);
 			const outputTokens = Math.ceil(output.length / CHARS_PER_TOKEN$3);
@@ -1282,6 +1296,20 @@ var DispatcherImpl = class {
 				dispatchId: id,
 				timeoutMs
 			});
+			const stderrTail = Buffer.concat(stderrChunks).toString("utf8");
+			const stdoutTail = Buffer.concat(stdoutChunks).toString("utf8");
+			this._eventBus.emit("dispatch:spawnsync-timeout", {
+				type: "dispatch:spawnsync-timeout",
+				storyKey: storyKey ?? "unknown",
+				taskType,
+				attemptNumber: attemptNumber ?? 1,
+				timeoutMs,
+				elapsedAtKill,
+				...proc.pid != null && proc.pid > 0 ? { pid: proc.pid } : {},
+				occurredAt: new Date().toISOString(),
+				stderrTail,
+				stdoutTail
+			});
 			this._logger.warn({
 				id,
 				agent,
@@ -11014,4 +11042,4 @@ async function callLLM(params) {
 
 //#endregion
 export { ADVISORY_NOTES, AdapterRegistry, AdtError, BudgetConfigSchema, 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, compareRunMetrics, createAmendmentRun, createConfigSystem, createDatabaseAdapter as createDatabaseAdapter$1, createDecision, createDoltClient, createExperimenter, createPipelineRun, createRequirement, createVersionManager, detectInterfaceChanges, determineVerdict, getActiveDecisions, getAllCostEntriesFiltered, getArtifactByTypeForRun, getArtifactsByRun, getBaselineRunMetrics, getDecisionsByCategory, getDecisionsByPhase, getDecisionsByPhaseForRun, getLatestCompletedRun, getLatestRun, getModelTier, getPipelineRunById, getPlanningCostTotal, getRetryableEscalations, getRunMetrics, getRunningPipelineRuns, getSessionCostSummary, getSessionCostSummaryFiltered, getStoryMetricsForRun, getTokenUsageSummary, incrementRunRestarts, initSchema, initializeDolt, listRequirements, listRunMetrics, loadModelRoutingConfig, loadParentRunDecisions, registerArtifact, resolvePromptFile, supersedeDecision, tagRunAsBaseline, updateDecision, updatePipelineRun, updatePipelineRunConfig, upsertDecision, writeRunMetrics, writeStoryMetrics };
-//# sourceMappingURL=dist-ARkfvp4m.js.map
+//# sourceMappingURL=dist-W2emvN3F.js.map

package/dist/{errors-DJdIXYoN.js → errors-CKFu8YI9.js}

@@ -1,4 +1,4 @@
-import { AdtError } from "./dist-ARkfvp4m.js";
+import { AdtError } from "./dist-W2emvN3F.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-DJdIXYoN.js.map
+//# sourceMappingURL=errors-CKFu8YI9.js.map

package/dist/{experimenter-BxPyegZX.js → experimenter-DxxwicpK.js}

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

package/dist/{health-BdLCJORK.js → health-HmyFdWEf.js}

@@ -1,6 +1,6 @@
-import { DEFAULT_STALL_THRESHOLD_SECONDS, getAllDescendantPids, getAutoHealthData, inspectProcessTree, isOrchestratorProcessLine, registerHealthCommand, runHealthAction } from "./health-CTXosAp0.js";
+import { DEFAULT_STALL_THRESHOLD_SECONDS, getAllDescendantPids, getAutoHealthData, inspectProcessTree, isOrchestratorProcessLine, registerHealthCommand, runHealthAction } from "./health-PdI4-96I.js";
 import "./logger-KeHncl-f.js";
-import "./dist-ARkfvp4m.js";
+import "./dist-W2emvN3F.js";
 import "./decisions-C0pz9Clx.js";
 
 export { inspectProcessTree };

package/dist/{health-CTXosAp0.js → health-PdI4-96I.js}

@@ -1,5 +1,5 @@
 import { createLogger } from "./logger-KeHncl-f.js";
-import { DoltClient, DoltQueryError, LEARNING_FINDING, createDatabaseAdapter$1 as createDatabaseAdapter, createDecision, getDecisionsByCategory, getLatestRun, getPipelineRunById, initSchema } from "./dist-ARkfvp4m.js";
+import { DoltClient, DoltQueryError, LEARNING_FINDING, createDatabaseAdapter$1 as createDatabaseAdapter, createDecision, getDecisionsByCategory, getLatestRun, getPipelineRunById, initSchema } from "./dist-W2emvN3F.js";
 import { createRequire } from "module";
 import { dirname, join } from "path";
 import { readFile } from "fs/promises";
@@ -3819,6 +3819,30 @@ function tail(text, bytes = PROBE_TAIL_BYTES) {
 	return text.length <= bytes ? text : text.slice(text.length - bytes);
 }
 /**
+* Story 66-6 / obs_2026-05-04_024 fix #1:
+* Substitute `<REPO_ROOT>` and `$REPO_ROOT` placeholder tokens in a probe
+* command string with the actual project root path before shell invocation.
+*
+* Rules:
+*   - Every literal `<REPO_ROOT>` substring is replaced with `projectRoot`.
+*   - Every `$REPO_ROOT` token that is NOT immediately followed by an
+*     alphanumeric character or underscore is replaced with `projectRoot`
+*     (so `$REPO_ROOT_EXTRA` is left untouched).
+*   - All other `<...>` placeholders (e.g. `<UNKNOWN_PLACEHOLDER>`) are
+*     passed through unchanged — Story 66-7 handles the unknown-placeholder
+*     finding category separately.
+*   - Probes without any placeholder are returned byte-for-byte identical.
+*
+* Backward-compat note: any existing probe command that contained the
+* literal text `<REPO_ROOT>` (none expected in practice) will now have that
+* text replaced with the project root path. This is the intended behavior.
+*/
+function substituteRuntimePlaceholders(command, projectRoot) {
+	let result = command.replaceAll("<REPO_ROOT>", projectRoot);
+	result = result.replace(/\$REPO_ROOT(?=[^A-Za-z0-9_]|$)/g, projectRoot);
+	return result;
+}
+/**
 * Story 60-4: evaluate `expect_stdout_no_regex` and `expect_stdout_regex`
 * patterns against the captured stdout. Runs against the full (un-tailed)
 * stdout so authors can match payload shape even when the response is
@@ -3913,11 +3937,12 @@ function executeProbeOnHost(probe, options = {}) {
 	const cwd = options.cwd ?? process.cwd();
 	const env = options.env ?? process.env;
 	const start = Date.now();
+	const resolvedCommand = substituteRuntimePlaceholders(probe.command, cwd);
 	return new Promise((resolve$2) => {
 		let stdout = "";
 		let stderr = "";
 		let settled = false;
-		const child = spawn(probe.command, [], {
+		const child = spawn(resolvedCommand, [], {
 			cwd,
 			env,
 			detached: true,
@@ -4090,6 +4115,16 @@ const CATEGORY_MISSING_TRIGGER = "runtime-probe-missing-production-trigger";
 */
 const CATEGORY_MISSING_PROBES_DECLARED = "runtime-probe-missing-declared-probes";
 /**
+* Story 66-7: probe exited non-zero AND stderr/stdout contained a placeholder
+* token that was never substituted before execution (e.g. `<REPO_ROOT>`,
+* `<CONFIG_DIR>`, `<UNKNOWN_VAR>`). Distinct from `runtime-probe-fail`
+* (genuine runtime failure) so operators and probe-author quality dashboards
+* can carve placeholder substitution failures out for cleaner triage and
+* metrics. Severity: `error` (matches `runtime-probe-fail` baseline).
+* Closes obs_2026-05-04_024 fix #3.
+*/
+const CATEGORY_PLACEHOLDER_NOT_SUBSTITUTED = "runtime-probe-placeholder-not-substituted";
+/**
 * Source-AC keywords that signal an event-driven implementation. Word-boundary
 * matched, case-insensitive. When any of these appears in source AC text AND
 * no probe's command invokes a known production trigger, the check emits a
@@ -4230,6 +4265,37 @@ function detectsStateIntegratingAC(sourceContent) {
 	return false;
 }
 /**
+* Detects whether a probe's combined output (stderr + stdout) contains an
+* unrecognized placeholder token that was not substituted before execution.
+*
+* Two shapes are handled:
+*
+* Shape 1 — command-line tool "no such file" with placeholder argument:
+*   `grep: <REPO_ROOT>: No such file or directory`
+*   `bash: <CONFIG_DIR>: command not found`
+*   Regex (multiline): `/^[\w]*:\s*(<[A-Z_]+>):?/m`
+*
+* Shape 2 — shell syntax error adjacent to a placeholder token:
+*   Combined output contains `Syntax error: "&&" unexpected` AND a `<TOKEN>`.
+*
+* Returns the captured `<TOKEN>` string if the placeholder leakage pattern
+* fires, or `null` if no placeholder is detected (allowing the existing
+* `CATEGORY_FAIL` path to proceed unmodified).
+*
+* Exported (mirrors the export pattern of `detectNegationContextLines`,
+* `detectDependencyContextLines`, `detectsEventDrivenAC`) so tests and
+* downstream consumers can call it directly.
+*/
+function detectPlaceholderLeakage(output) {
+	const shape1Match = /^[\w]*:\s*(<[A-Z_]+>):?/m.exec(output);
+	if (shape1Match !== null) return shape1Match[1] ?? null;
+	if (output.includes("Syntax error: \"&&\" unexpected")) {
+		const tokenMatch = /(<[A-Z_]+>)/.exec(output);
+		if (tokenMatch !== null) return tokenMatch[1] ?? null;
+	}
+	return null;
+}
+/**
 * Returns true if any probe's command line invokes a known production trigger.
 */
 function probesInvokeProductionTrigger(probes) {
@@ -4323,17 +4389,69 @@ var RuntimeProbeCheck = class {
 			}
 			const result = await this._executors.host(probe);
 			if (result.outcome === "pass") continue;
-			const category = result.outcome === "timeout" ? CATEGORY_TIMEOUT : result.assertionFailures !== void 0 ? CATEGORY_ASSERTION_FAIL : result.errorShapeIndicators !== void 0 ? CATEGORY_ERROR_RESPONSE : CATEGORY_FAIL;
 			const descriptor = probe.description ? ` (${probe.description})` : "";
-			let message;
-			if (result.outcome === "timeout") message = `probe "${probe.name}"${descriptor} timed out after ${result.durationMs}ms`;
-			else if (result.assertionFailures !== void 0) message = `probe "${probe.name}"${descriptor} exit 0 but stdout assertion failed: ` + result.assertionFailures.join("; ");
-			else if (result.errorShapeIndicators !== void 0) message = `probe "${probe.name}"${descriptor} exit 0 but response contained error envelope: ` + result.errorShapeIndicators.join("; ") + " — the tool returned an error-shaped JSON response despite a clean exit code. This is structural evidence the implementation didn't actually work; add an explicit `expect_stdout_no_regex` assertion to make the failure surface earlier in author-controlled form.";
-			else message = `probe "${probe.name}"${descriptor} failed with exit ${result.exitCode ?? "unknown"}`;
+			if (result.outcome === "timeout") {
+				findings.push({
+					category: CATEGORY_TIMEOUT,
+					severity: "error",
+					message: `probe "${probe.name}"${descriptor} timed out after ${result.durationMs}ms`,
+					command: result.command,
+					stdoutTail: result.stdoutTail,
+					stderrTail: result.stderrTail,
+					durationMs: result.durationMs,
+					_authoredBy: probe._authoredBy ?? "create-story-ac-transfer"
+				});
+				continue;
+			}
+			if (result.assertionFailures !== void 0) {
+				findings.push({
+					category: CATEGORY_ASSERTION_FAIL,
+					severity: "error",
+					message: `probe "${probe.name}"${descriptor} exit 0 but stdout assertion failed: ` + result.assertionFailures.join("; "),
+					command: result.command,
+					...result.exitCode !== void 0 ? { exitCode: result.exitCode } : {},
+					stdoutTail: result.stdoutTail,
+					stderrTail: result.stderrTail,
+					durationMs: result.durationMs,
+					_authoredBy: probe._authoredBy ?? "create-story-ac-transfer"
+				});
+				continue;
+			}
+			if (result.errorShapeIndicators !== void 0) {
+				findings.push({
+					category: CATEGORY_ERROR_RESPONSE,
+					severity: "error",
+					message: `probe "${probe.name}"${descriptor} exit 0 but response contained error envelope: ` + result.errorShapeIndicators.join("; ") + " — the tool returned an error-shaped JSON response despite a clean exit code. This is structural evidence the implementation didn't actually work; add an explicit `expect_stdout_no_regex` assertion to make the failure surface earlier in author-controlled form.",
+					command: result.command,
+					...result.exitCode !== void 0 ? { exitCode: result.exitCode } : {},
+					stdoutTail: result.stdoutTail,
+					stderrTail: result.stderrTail,
+					durationMs: result.durationMs,
+					_authoredBy: probe._authoredBy ?? "create-story-ac-transfer"
+				});
+				continue;
+			}
+			const outputForDetection = `${result.stderrTail ?? ""}\n${result.stdoutTail ?? ""}`;
+			const placeholderToken = detectPlaceholderLeakage(outputForDetection);
+			if (placeholderToken !== null) {
+				findings.push({
+					category: CATEGORY_PLACEHOLDER_NOT_SUBSTITUTED,
+					severity: "error",
+					message: `Probe failed: unrecognized placeholder token "${placeholderToken}" was not substituted before execution`,
+					command: result.command,
+					...result.exitCode !== void 0 ? { exitCode: result.exitCode } : {},
+					stdoutTail: result.stdoutTail,
+					stderrTail: result.stderrTail,
+					durationMs: result.durationMs,
+					unrecognizedPlaceholder: placeholderToken,
+					_authoredBy: probe._authoredBy ?? "create-story-ac-transfer"
+				});
+				continue;
+			}
 			findings.push({
-				category,
+				category: CATEGORY_FAIL,
 				severity: "error",
-				message,
+				message: `probe "${probe.name}"${descriptor} failed with exit ${result.exitCode ?? "unknown"}`,
 				command: result.command,
 				...result.exitCode !== void 0 ? { exitCode: result.exitCode } : {},
 				stdoutTail: result.stdoutTail,
@@ -6912,4 +7030,4 @@ function registerHealthCommand(program, _version = "0.0.0", projectRoot = proces
 
 //#endregion
 export { BMAD_BASELINE_TOKENS_FULL, DEFAULT_STALL_THRESHOLD_SECONDS, DoltMergeConflict, FileStateStore, FindingsInjector, RunManifest, RuntimeProbeListSchema, STOP_AFTER_VALID_PHASES, STORY_KEY_PATTERN$1 as STORY_KEY_PATTERN, SUBSTRATE_OWNED_SETTINGS_KEYS, SupervisorLock, VALID_PHASES, WorkGraphRepository, ZERO_FINDINGS_BY_AUTHOR, ZERO_FINDING_COUNTS, ZERO_PROBE_AUTHOR_METRICS, __commonJS, __require, __toESM, aggregateProbeAuthorMetrics, applyConfigToGraph, buildPipelineStatusOutput, createDatabaseAdapter$1 as createDatabaseAdapter, createDefaultVerificationPipeline, createGraphOrchestrator, createSdlcCodeReviewHandler, createSdlcCreateStoryHandler, createSdlcDevStoryHandler, createSdlcPhaseHandler, createStateStore, detectCycles, detectsEventDrivenAC, detectsStateIntegratingAC, extractTargetFilesFromStoryContent, findPackageRoot, formatOutput, formatPipelineStatusHuman, formatPipelineSummary, formatTokenTelemetry, getAllDescendantPids, getAutoHealthData, getSubstrateDefaultSettings, inspectProcessTree, isOrchestratorProcessLine, parseDbTimestampAsUtc, parseRuntimeProbes, registerHealthCommand, renderFindings, resolveBmadMethodSrcPath, resolveBmadMethodVersion, resolveGraphPath, resolveMainRepoRoot, resolveRunManifest, rollupFindingCounts, rollupFindingsByAuthor, rollupProbeAuthorByClass, rollupProbeAuthorMetrics, runHealthAction, validateStoryKey };
-//# sourceMappingURL=health-CTXosAp0.js.map
+//# sourceMappingURL=health-PdI4-96I.js.map

package/dist/index.d.ts

@@ -317,9 +317,25 @@ interface StoryLogEvent {
   /** Log message */
   msg: string;
 }
+/**
+ * Snapshot entry for a single story within a heartbeat event.
+ * Both fields are strings so the event schema stays language-agnostic.
+ *
+ * - `phase`  — raw orchestrator StoryPhase value (e.g. 'IN_DEV', 'COMPLETE').
+ * - `status` — consumer-facing status derived from phase (e.g. 'dispatched', 'complete').
+ *
+ * Story 66-2: obs_2026-05-03_022 fix #2.
+ */
+type HeartbeatStorySnapshot = {
+  phase: string;
+  status: string;
+};
 /**
  * Emitted periodically (every 30s) when no other progress events have fired.
  * Allows parent agents to distinguish "working silently" from "stuck".
+ *
+ * Story 66-2: gains optional `per_story_state` field for real-time drift detection
+ * between in-memory orchestrator state and the persisted manifest (obs_2026-05-03_022 fix #2).
  */
 interface PipelineHeartbeatEvent {
   type: 'pipeline:heartbeat';
@@ -333,6 +349,13 @@ interface PipelineHeartbeatEvent {
   completed_dispatches: number;
   /** Number of dispatches waiting to start */
   queued_dispatches: number;
+  /**
+   * Snapshot of in-memory phase and derived status for each story.
+   * Omitted (or empty object) when no stories are dispatched.
+   * Additive and optional — existing heartbeat consumers require no changes.
+   * Story 66-2: obs_2026-05-03_022 fix #2.
+   */
+  per_story_state?: Record<string, HeartbeatStorySnapshot>;
 }
 /**
  * Emitted when the watchdog timer detects no progress for an extended period.
@@ -2211,6 +2234,34 @@ interface OrchestratorEvents {
     activeDispatches: number;
     completedDispatches: number;
     queuedDispatches: number;
+    /**
+     * Per-story phase and derived status snapshot from in-memory orchestrator state.
+     * Omitted when no stories are dispatched. Story 66-2: obs_2026-05-03_022 fix #2.
+     */
+    perStoryState?: Record<string, {
+      phase: string;
+      status: string;
+    }>;
+  };
+  /**
+   * Story 66-4 / obs_2026-05-04_023 fix #3: dispatcher subprocess hit ETIMEDOUT.
+   * Emitted for both the initial attempt (attemptNumber: 1) and retry (attemptNumber: 2).
+   * Story 66-5 adds optional stderrTail/stdoutTail forensic capture.
+   * Mirror of CoreEvents['dispatch:spawnsync-timeout']; both must stay in sync.
+   */
+  'dispatch:spawnsync-timeout': {
+    type: 'dispatch:spawnsync-timeout';
+    storyKey: string;
+    taskType: string;
+    attemptNumber: 1 | 2;
+    timeoutMs: number;
+    elapsedAtKill: number;
+    pid?: number;
+    occurredAt: string;
+    /** Tail of subprocess stderr captured at kill time (~64KB max, UTF-8) */
+    stderrTail?: string;
+    /** Tail of subprocess stdout captured at kill time (~64KB max, UTF-8) */
+    stdoutTail?: string;
   };
   /** Watchdog detected no progress for an extended period */
   'orchestrator:stall': {

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-ARkfvp4m.js";
+import { AdapterRegistry, AdtError, ClaudeCodeAdapter, CodexCLIAdapter, ConfigError, ConfigIncompatibleFormatError, GeminiCLIAdapter } from "./dist-W2emvN3F.js";
 import "./adapter-registry-DXLMTmfD.js";
-import { BudgetExceededError, GitError, RecoveryError, TaskConfigError, TaskGraphCycleError, TaskGraphError, TaskGraphIncompatibleFormatError, WorkerError, WorkerNotFoundError } from "./errors-DJdIXYoN.js";
+import { BudgetExceededError, GitError, RecoveryError, TaskConfigError, TaskGraphCycleError, TaskGraphError, TaskGraphIncompatibleFormatError, WorkerError, WorkerNotFoundError } from "./errors-CKFu8YI9.js";
 
 //#region src/core/di.ts
 /**

package/dist/{routing-BUTffPcL.js → routing-0ykvBl_4.js}

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

package/dist/{run-BnD0zCgV.js → run-BF8oeJhG.js}

@@ -1,8 +1,8 @@
-import "./health-CTXosAp0.js";
+import "./health-PdI4-96I.js";
 import "./logger-KeHncl-f.js";
 import "./helpers-CElYrONe.js";
-import "./dist-ARkfvp4m.js";
-import { normalizeGraphSummaryToStatus, registerRunCommand, resolveMaxReviewCycles, resolveProbeAuthorStateIntegrating, runRunAction, wireNdjsonEmitter } from "./run-XCd2tF_T.js";
+import "./dist-W2emvN3F.js";
+import { normalizeGraphSummaryToStatus, registerRunCommand, resolveMaxReviewCycles, resolveProbeAuthorStateIntegrating, runRunAction, wireNdjsonEmitter } from "./run-DcDoaG12.js";
 import "./routing-CcBOCuC9.js";
 import "./decisions-C0pz9Clx.js";
 

package/dist/{run-XCd2tF_T.js → run-DcDoaG12.js}

@@ -1,7 +1,7 @@
-import { BMAD_BASELINE_TOKENS_FULL, DoltMergeConflict, FileStateStore, FindingsInjector, RunManifest, RuntimeProbeListSchema, STOP_AFTER_VALID_PHASES, STORY_KEY_PATTERN, VALID_PHASES, WorkGraphRepository, __commonJS, __require, __toESM, applyConfigToGraph, buildPipelineStatusOutput, createDatabaseAdapter, createDefaultVerificationPipeline, createGraphOrchestrator, createSdlcCodeReviewHandler, createSdlcCreateStoryHandler, createSdlcDevStoryHandler, createSdlcPhaseHandler, detectCycles, detectsEventDrivenAC, detectsStateIntegratingAC, extractTargetFilesFromStoryContent, formatOutput, formatPipelineSummary, formatTokenTelemetry, inspectProcessTree, parseDbTimestampAsUtc, renderFindings, resolveGraphPath, resolveMainRepoRoot, validateStoryKey } from "./health-CTXosAp0.js";
+import { BMAD_BASELINE_TOKENS_FULL, DoltMergeConflict, FileStateStore, FindingsInjector, RunManifest, RuntimeProbeListSchema, STOP_AFTER_VALID_PHASES, STORY_KEY_PATTERN, VALID_PHASES, WorkGraphRepository, __commonJS, __require, __toESM, applyConfigToGraph, buildPipelineStatusOutput, createDatabaseAdapter, createDefaultVerificationPipeline, createGraphOrchestrator, createSdlcCodeReviewHandler, createSdlcCreateStoryHandler, createSdlcDevStoryHandler, createSdlcPhaseHandler, detectCycles, detectsEventDrivenAC, detectsStateIntegratingAC, extractTargetFilesFromStoryContent, formatOutput, formatPipelineSummary, formatTokenTelemetry, inspectProcessTree, parseDbTimestampAsUtc, renderFindings, resolveGraphPath, resolveMainRepoRoot, validateStoryKey } from "./health-PdI4-96I.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-ARkfvp4m.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-W2emvN3F.js";
 import { basename, dirname, extname, join } from "path";
 import { access, readFile, readdir, stat } from "fs/promises";
 import { EventEmitter } from "node:events";
@@ -12749,6 +12749,13 @@ function createImplementationOrchestrator(deps) {
 						err,
 						storyKey
 					}, `patchStoryState(${manifestStatus}) failed — pipeline continues`));
+				} else {
+					const intermediatePhase = updates.phase;
+					runManifest.patchStoryState(storyKey, { phase: String(intermediatePhase) }).catch((err) => logger$26.warn({
+						err,
+						storyKey,
+						phase: intermediatePhase
+					}, "phase-persistence-write-failed — pipeline continues"));
 				}
 			}
 		}
@@ -12801,6 +12808,22 @@ function createImplementationOrchestrator(deps) {
 	function getStallThresholdMs(phase) {
 		return phase === "IN_DEV" ? DEV_STORY_STALL_THRESHOLD_MS : DEFAULT_STALL_THRESHOLD_MS;
 	}
+	/**
+	* Map an internal StoryPhase to a consumer-facing manifest-compatible status string.
+	* Mirrors the PerStoryStatus values in per-story-state.ts.
+	* Story 66-2: obs_2026-05-03_022 fix #2.
+	*/
+	function storyPhaseToStatus(phase) {
+		switch (phase) {
+			case "COMPLETE": return "complete";
+			case "ESCALATED": return "escalated";
+			case "VERIFICATION_FAILED": return "verification-failed";
+			case "IN_REVIEW":
+			case "NEEDS_FIXES": return "in-review";
+			case "PENDING": return "pending";
+			default: return "dispatched";
+		}
+	}
 	function startHeartbeat() {
 		if (_heartbeatTimer !== null) return;
 		_heartbeatTimer = setInterval(() => {
@@ -12810,11 +12833,17 @@ function createImplementationOrchestrator(deps) {
 			for (const s$1 of _stories.values()) if (s$1.phase === "PENDING") queued++;
 			else if (s$1.phase !== "COMPLETE" && s$1.phase !== "ESCALATED" && s$1.phase !== "VERIFICATION_FAILED") active++;
 			const completed = _completedDispatches;
+			const perStoryState = {};
+			for (const [key, s$1] of _stories) perStoryState[key] = {
+				phase: s$1.phase,
+				status: storyPhaseToStatus(s$1.phase)
+			};
 			eventBus.emit("orchestrator:heartbeat", {
 				runId: config.pipelineRunId ?? "",
 				activeDispatches: active,
 				completedDispatches: completed,
-				queuedDispatches: queued
+				queuedDispatches: queued,
+				...Object.keys(perStoryState).length > 0 ? { perStoryState } : {}
 			});
 			if (config.pipelineRunId !== void 0) updatePipelineRun(db, config.pipelineRunId, { current_phase: "implementation" }).catch((err) => {
 				logger$26.debug({ err }, "Heartbeat: failed to touch updated_at (non-fatal)");
@@ -28141,43 +28170,43 @@ var require_uri_all = __commonJS({ "node_modules/uri-js/dist/es5/uri.all.js"(exp
 			}
 			return uriTokens.join("");
 		}
-		function resolveComponents(base$1, relative) {
+		function resolveComponents(base$1, relative$1) {
 			var options = arguments.length > 2 && arguments[2] !== void 0 ? arguments[2] : {};
 			var skipNormalization = arguments[3];
 			var target = {};
 			if (!skipNormalization) {
 				base$1 = parse$1(serialize(base$1, options), options);
-				relative = parse$1(serialize(relative, options), options);
+				relative$1 = parse$1(serialize(relative$1, options), options);
 			}
 			options = options || {};
-			if (!options.tolerant && relative.scheme) {
-				target.scheme = relative.scheme;
-				target.userinfo = relative.userinfo;
-				target.host = relative.host;
-				target.port = relative.port;
-				target.path = removeDotSegments(relative.path || "");
-				target.query = relative.query;
+			if (!options.tolerant && relative$1.scheme) {
+				target.scheme = relative$1.scheme;
+				target.userinfo = relative$1.userinfo;
+				target.host = relative$1.host;
+				target.port = relative$1.port;
+				target.path = removeDotSegments(relative$1.path || "");
+				target.query = relative$1.query;
 			} else {
-				if (relative.userinfo !== void 0 || relative.host !== void 0 || relative.port !== void 0) {
-					target.userinfo = relative.userinfo;
-					target.host = relative.host;
-					target.port = relative.port;
-					target.path = removeDotSegments(relative.path || "");
-					target.query = relative.query;
+				if (relative$1.userinfo !== void 0 || relative$1.host !== void 0 || relative$1.port !== void 0) {
+					target.userinfo = relative$1.userinfo;
+					target.host = relative$1.host;
+					target.port = relative$1.port;
+					target.path = removeDotSegments(relative$1.path || "");
+					target.query = relative$1.query;
 				} else {
-					if (!relative.path) {
+					if (!relative$1.path) {
 						target.path = base$1.path;
-						if (relative.query !== void 0) target.query = relative.query;
+						if (relative$1.query !== void 0) target.query = relative$1.query;
 						else target.query = base$1.query;
 					} else {
-						if (relative.path.charAt(0) === "/") target.path = removeDotSegments(relative.path);
+						if (relative$1.path.charAt(0) === "/") target.path = removeDotSegments(relative$1.path);
 						else {
-							if ((base$1.userinfo !== void 0 || base$1.host !== void 0 || base$1.port !== void 0) && !base$1.path) target.path = "/" + relative.path;
-							else if (!base$1.path) target.path = relative.path;
-							else target.path = base$1.path.slice(0, base$1.path.lastIndexOf("/") + 1) + relative.path;
+							if ((base$1.userinfo !== void 0 || base$1.host !== void 0 || base$1.port !== void 0) && !base$1.path) target.path = "/" + relative$1.path;
+							else if (!base$1.path) target.path = relative$1.path;
+							else target.path = base$1.path.slice(0, base$1.path.lastIndexOf("/") + 1) + relative$1.path;
 							target.path = removeDotSegments(target.path);
 						}
-						target.query = relative.query;
+						target.query = relative$1.query;
 					}
 					target.userinfo = base$1.userinfo;
 					target.host = base$1.host;
@@ -28185,7 +28214,7 @@ var require_uri_all = __commonJS({ "node_modules/uri-js/dist/es5/uri.all.js"(exp
 				}
 				target.scheme = base$1.scheme;
 			}
-			target.fragment = relative.fragment;
+			target.fragment = relative$1.fragment;
 			return target;
 		}
 		function resolve$6(baseURI, relativeURI, options) {
@@ -41030,16 +41059,16 @@ var Ignore = class {
 	ignored(p) {
 		const fullpath = p.fullpath();
 		const fullpaths = `${fullpath}/`;
-		const relative = p.relative() || ".";
-		const relatives = `${relative}/`;
-		for (const m of this.relative) if (m.match(relative) || m.match(relatives)) return true;
+		const relative$1 = p.relative() || ".";
+		const relatives = `${relative$1}/`;
+		for (const m of this.relative) if (m.match(relative$1) || m.match(relatives)) return true;
 		for (const m of this.absolute) if (m.match(fullpath) || m.match(fullpaths)) return true;
 		return false;
 	}
 	childrenIgnored(p) {
 		const fullpath = p.fullpath() + "/";
-		const relative = (p.relative() || ".") + "/";
-		for (const m of this.relativeChildren) if (m.match(relative)) return true;
+		const relative$1 = (p.relative() || ".") + "/";
+		for (const m of this.relativeChildren) if (m.match(relative$1)) return true;
 		for (const m of this.absoluteChildren) if (m.match(fullpath)) return true;
 		return false;
 	}
@@ -43878,7 +43907,8 @@ function wireNdjsonEmitter(eventBus, ndjsonEmitter) {
 			run_id: payload.runId,
 			active_dispatches: payload.activeDispatches,
 			completed_dispatches: payload.completedDispatches,
-			queued_dispatches: payload.queuedDispatches
+			queued_dispatches: payload.queuedDispatches,
+			...payload.perStoryState !== void 0 ? { per_story_state: payload.perStoryState } : {}
 		});
 	});
 	eventBus.on("orchestrator:stall", (payload) => {
@@ -44655,6 +44685,12 @@ async function runRunAction(options) {
 				adapter_backend: adapter.backendType
 			});
 			wireNdjsonEmitter(eventBus, ndjsonEmitter);
+			const heartbeatSnapshotPath = join(dbDir, "latest-heartbeat-per-story-state.json");
+			eventBus.on("orchestrator:heartbeat", (payload) => {
+				if (payload.perStoryState !== void 0 && Object.keys(payload.perStoryState).length > 0) try {
+					writeFileSync$1(heartbeatSnapshotPath, JSON.stringify(payload.perStoryState), "utf-8");
+				} catch {}
+			});
 		}
 		const ingestionServer = telemetryEnabled ? new IngestionServer({ port: telemetryPort }) : void 0;
 		if (ingestionServer !== void 0) {
@@ -45033,6 +45069,12 @@ async function runFullPipeline(options) {
 				adapter_backend: adapter.backendType
 			});
 			wireNdjsonEmitter(eventBus, fullPipelineNdjsonEmitter);
+			const heartbeatSnapshotPathFp = join(dbDir, "latest-heartbeat-per-story-state.json");
+			eventBus.on("orchestrator:heartbeat", (payload) => {
+				if (payload.perStoryState !== void 0 && Object.keys(payload.perStoryState).length > 0) try {
+					writeFileSync$1(heartbeatSnapshotPathFp, JSON.stringify(payload.perStoryState), "utf-8");
+				} catch {}
+			});
 		}
 		const phaseOrder = [];
 		if (effectiveResearch) phaseOrder.push("research");
@@ -45429,5 +45471,5 @@ 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, resolveProbeAuthorStateIntegrating, resolveStoryKeys, runAnalysisPhase, runPlanningPhase, runProbeAuthor, runRunAction, runSolutioningPhase, validateStopAfterFromConflict, wireNdjsonEmitter };
-//# sourceMappingURL=run-XCd2tF_T.js.map
+export { AdapterTelemetryPersistence, AppError, DoltRepoMapMetaRepository, DoltSymbolRepository, ERR_REPO_MAP_STORAGE_WRITE, EpicIngester, GLOBSTAR$1 as GLOBSTAR, GitClient, GrammarLoader, Minimatch$1 as Minimatch, Minipass, RepoMapInjector, RepoMapModule, RepoMapQueryEngine, RepoMapStorage, SymbolParser, createContextCompiler, createDispatcher, createEventEmitter, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStopAfterGate, createTelemetryAdvisor, escape$1 as escape, formatPhaseCompletionSummary, getFactoryRunSummaries, getScenarioResultsForRun, getTwinRunsForRun, listGraphRuns, normalizeGraphSummaryToStatus, registerExportCommand, registerFactoryCommand, registerRunCommand, registerScenariosCommand, resolveMaxReviewCycles, resolveProbeAuthorStateIntegrating, resolveStoryKeys, runAnalysisPhase, runPlanningPhase, runProbeAuthor, runRunAction, runSolutioningPhase, unescape$1 as unescape, validateStopAfterFromConflict, wireNdjsonEmitter };
+//# sourceMappingURL=run-DcDoaG12.js.map

package/dist/{upgrade-CAc1itQK.js → upgrade-C8LAnB6W.js}

@@ -1,5 +1,5 @@
-import "./dist-ARkfvp4m.js";
+import "./dist-W2emvN3F.js";
 import "./version-manager-impl-BmOWu8ml.js";
-import { isGlobalInstall, registerUpgradeCommand, runUpgradeCommand } from "./upgrade-CqKuWLIO.js";
+import { isGlobalInstall, registerUpgradeCommand, runUpgradeCommand } from "./upgrade-CAqLkNUP.js";
 
 export { isGlobalInstall, registerUpgradeCommand, runUpgradeCommand };