substrate-ai 0.20.137 → 0.20.139

package/dist/adapter-registry-CXIG-OQI.js

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

package/dist/cli/index.js

@@ -1,20 +1,20 @@
 #!/usr/bin/env node
-import { FileKvStore, SUBSTRATE_OWNED_SETTINGS_KEYS, VALID_PHASES, buildPipelineStatusOutput, createDatabaseAdapter, createDoltOperatorReader, findPackageRoot, formatOutput, formatPipelineStatusHuman, formatPipelineSummary, formatTokenTelemetry, getAllDescendantPids, getAutoHealthData, getSubstrateDefaultSettings, inspectProcessTree, parseDbTimestampAsUtc, registerHealthCommand, resolveBmadMethodSrcPath, resolveBmadMethodVersion } from "../health-BqCpWu2_.js";
+import { FileKvStore, SUBSTRATE_OWNED_SETTINGS_KEYS, VALID_PHASES, buildPipelineStatusOutput, createDatabaseAdapter, createDoltOperatorReader, findPackageRoot, formatOutput, formatPipelineStatusHuman, formatPipelineSummary, formatTokenTelemetry, getAllDescendantPids, getAutoHealthData, getSubstrateDefaultSettings, inspectProcessTree, parseDbTimestampAsUtc, registerHealthCommand, resolveBmadMethodSrcPath, resolveBmadMethodVersion } from "../health-BXVyiLiL.js";
 import { createLogger } from "../logger-KeHncl-f.js";
 import { createEventBus } from "../helpers-CElYrONe.js";
-import { AdapterRegistry, BudgetConfigSchema, CURRENT_CONFIG_FORMAT_VERSION, CURRENT_TASK_GRAPH_VERSION, ConfigError, CostTrackerConfigSchema, DEFAULT_CONFIG, DoltClient, DoltNotInstalled, GlobalSettingsSchema, InMemoryDatabaseAdapter, IngestionServer, MonitorDatabaseImpl, OPERATIONAL_FINDING, PartialGlobalSettingsSchema, PartialProviderConfigSchema, ProvidersSchema, RoutingRecommender, STORY_METRICS, TelemetryConfigSchema, addTokenUsage, aggregateTokenUsageForRun, checkDoltInstalled, compareRunMetrics, createAmendmentRun, createConfigSystem, createDecision, createPipelineRun, createStderrLogger, getActiveDecisions, getAllCostEntriesFiltered, getBaselineRunMetrics, getDecisionsByCategory, getDecisionsByPhaseForRun, getLatestCompletedRun, getLatestRun, getPipelineRunById, getPlanningCostTotal, getRetryableEscalations, getRunMetrics, getRunningPipelineRuns, getSessionCostSummary, getSessionCostSummaryFiltered, getStoryMetricsForRun, getTokenUsageSummary, incrementRunRestarts, initSchema, initWorkGraphSchema, initializeDolt, listRunMetrics, loadParentRunDecisions, supersedeDecision, swallowDebug, tagRunAsBaseline, updatePipelineRun } from "../dist-BOooz8sb.js";
-import { AdapterTelemetryPersistence, AppError, DoltRepoMapMetaRepository, DoltSymbolRepository, ERR_REPO_MAP_STORAGE_WRITE, EpicIngester, GLOBSTAR, GitClient, GrammarLoader, Minimatch, Minipass, RepoMapInjector, RepoMapModule, RepoMapQueryEngine, RepoMapStorage, SymbolParser, createContextCompiler, createDispatcher, createEventEmitter, createGitWorktreeManager, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStopAfterGate, createTelemetryAdvisor, escape, formatPhaseCompletionSummary, getFactoryRunSummaries, getScenarioResultsForRun, getTwinRunsForRun, listGraphRuns, registerExportCommand, registerFactoryCommand, registerRunCommand, registerScenariosCommand, resolveStoryKeys, runAnalysisPhase, runPlanningPhase, runProbeAuthor, runSolutioningPhase, unescape, validateStopAfterFromConflict } from "../run-Bb39uB9y.js";
+import { AdapterRegistry, BudgetConfigSchema, CURRENT_CONFIG_FORMAT_VERSION, CURRENT_TASK_GRAPH_VERSION, ConfigError, CostTrackerConfigSchema, DEFAULT_CONFIG, DoltClient, DoltNotInstalled, GlobalSettingsSchema, InMemoryDatabaseAdapter, IngestionServer, MonitorDatabaseImpl, OPERATIONAL_FINDING, PartialGlobalSettingsSchema, PartialProviderConfigSchema, ProvidersSchema, RoutingRecommender, STORY_METRICS, TelemetryConfigSchema, addTokenUsage, aggregateTokenUsageForRun, checkDoltInstalled, compareRunMetrics, createAmendmentRun, createConfigSystem, createDecision, createPipelineRun, createStderrLogger, getActiveDecisions, getAllCostEntriesFiltered, getBaselineRunMetrics, getDecisionsByCategory, getDecisionsByPhaseForRun, getLatestCompletedRun, getLatestRun, getPipelineRunById, getPlanningCostTotal, getRetryableEscalations, getRunMetrics, getRunningPipelineRuns, getSessionCostSummary, getSessionCostSummaryFiltered, getStoryMetricsForRun, getTokenUsageSummary, incrementRunRestarts, initSchema, initWorkGraphSchema, initializeDolt, listRunMetrics, loadParentRunDecisions, supersedeDecision, swallowDebug, tagRunAsBaseline, updatePipelineRun } from "../dist-BWCudDcl.js";
+import { AdapterTelemetryPersistence, AppError, DoltRepoMapMetaRepository, DoltSymbolRepository, ERR_REPO_MAP_STORAGE_WRITE, EpicIngester, GLOBSTAR, GitClient, GrammarLoader, Minimatch, Minipass, RepoMapInjector, RepoMapModule, RepoMapQueryEngine, RepoMapStorage, SymbolParser, createContextCompiler, createDispatcher, createEventEmitter, createGitWorktreeManager, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStopAfterGate, createTelemetryAdvisor, escape, formatPhaseCompletionSummary, getFactoryRunSummaries, getScenarioResultsForRun, getTwinRunsForRun, listGraphRuns, registerExportCommand, registerFactoryCommand, registerRunCommand, registerScenariosCommand, resolveStoryKeys, runAnalysisPhase, runPlanningPhase, runProbeAuthor, runSolutioningPhase, unescape, validateStopAfterFromConflict } from "../run-eaZG_3rN.js";
 import "../adapter-registry-DIcrxjH8.js";
-import { RunManifest, SupervisorLock, ZERO_FINDINGS_BY_AUTHOR, ZERO_FINDING_COUNTS, ZERO_PROBE_AUTHOR_METRICS, aggregateProbeAuthorMetrics, parseRuntimeProbes, readCurrentRunId, resolveMainRepoRoot, resolveRunManifest, rollupFindingCounts, rollupFindingsByAuthor, rollupProbeAuthorByClass, rollupProbeAuthorMetrics, runAcTraceabilityCheck } from "../manifest-read-B0XYbIpU.js";
-import "../errors-iQa5SrYw.js";
+import { RunManifest, SupervisorLock, ZERO_FINDINGS_BY_AUTHOR, ZERO_FINDING_COUNTS, ZERO_PROBE_AUTHOR_METRICS, aggregateProbeAuthorMetrics, parseRuntimeProbes, readCurrentRunId, resolveMainRepoRoot, resolveRunManifest, rollupFindingCounts, rollupFindingsByAuthor, rollupProbeAuthorByClass, rollupProbeAuthorMetrics, runAcTraceabilityCheck } from "../manifest-read-IvpNQ6Yy.js";
+import "../errors-rZ-lz8U0.js";
 import "../routing-DFxoKHDt.js";
 import { WorkGraphRepository } from "../work-graph-repository-DZyJv5pV.js";
 import "../decisions-CzSIEeGP.js";
 import "../decision-router-DblHY8se.js";
-import "../interactive-prompt-Czlubg4J.js";
+import "../interactive-prompt-BypNgFHL.js";
 import "../recovery-engine-BKGBeBnW.js";
 import "../version-manager-impl-qFBiO4Eh.js";
-import { registerUpgradeCommand } from "../upgrade-BwitoFQT.js";
+import { registerUpgradeCommand } from "../upgrade-3NTcs1t7.js";
 import { Command } from "commander";
 import { fileURLToPath } from "url";
 import { dirname, join, resolve } from "path";
@@ -406,7 +406,8 @@ function healthResultToJson(adapterId, displayName, healthResult) {
 		cliPath: healthResult.cliPath ?? null,
 		detectedBillingModes: healthResult.detectedBillingModes ?? [],
 		supportsHeadless: healthResult.supportsHeadless,
-		error: healthResult.error ?? null
+		error: healthResult.error ?? null,
+		compatibilityWarning: healthResult.compatibilityWarning ?? null
 	};
 }
 
@@ -462,6 +463,18 @@ function registerAdaptersCommand(program, version, registry) {
 		if (opts.verbose) for (const result of report.results) {
 			const health = result.healthResult;
 			if (!health.healthy && health.error) process.stdout.write(`\n[${result.adapterId}] Error: ${health.error}\n`);
+			if (health.compatibilityWarning !== void 0) process.stdout.write(`\n[${result.adapterId}] Compatibility: ${health.compatibilityWarning}\n`);
+		}
+		else {
+			const drifted = report.results.filter((r) => r.healthResult.compatibilityWarning !== void 0);
+			if (drifted.length > 0) {
+				process.stdout.write("\nCLI version notes (run with --verbose for full text):\n");
+				for (const result of drifted) {
+					const w = result.healthResult.compatibilityWarning;
+					const oneLine = w.length > 120 ? w.slice(0, 117) + "..." : w;
+					process.stdout.write(`  ${result.adapterId}: ${oneLine}\n`);
+				}
+			}
 		}
 		process.exit(EXIT_CODE_SUCCESS);
 	});
@@ -7023,7 +7036,7 @@ async function runStatusAction(options) {
 			logger$15.debug({ err }, "Work graph query failed, continuing without work graph data");
 		}
 		if (run === void 0) {
-			const { inspectProcessTree: inspectProcessTree$1 } = await import("../health-xmLvQgb4.js");
+			const { inspectProcessTree: inspectProcessTree$1 } = await import("../health-D27XuFLF.js");
 			const substrateDirPath = join(projectRoot, ".substrate");
 			const processInfo = inspectProcessTree$1({
 				projectRoot,
@@ -7971,7 +7984,7 @@ function defaultSupervisorDeps() {
 				if (cached === null) {
 					const { AdapterRegistry: AR } = await import(
 						/* @vite-ignore */
-						"../adapter-registry-DxomlVMx.js"
+						"../adapter-registry-CXIG-OQI.js"
 );
 					cached = new AR();
 					await cached.discoverAndRegister();
@@ -8538,11 +8551,11 @@ async function runSupervisorAction(options, deps = {}) {
 						try {
 							const { createExperimenter } = await import(
 								/* @vite-ignore */
-								"../experimenter-B7NPkaQ8.js"
+								"../experimenter-Dn0gGOYl.js"
 );
 							const { getLatestRun: getLatest } = await import(
 								/* @vite-ignore */
-								"../decisions-DVuBgwlc.js"
+								"../decisions-EQtHqewP.js"
 );
 							const expAdapter = createDatabaseAdapter({
 								backend: "auto",
@@ -8552,7 +8565,7 @@ async function runSupervisorAction(options, deps = {}) {
 								await initSchema(expAdapter);
 								const { runRunAction: runPipeline } = await import(
 									/* @vite-ignore */
-									"../run-DBifBbYW.js"
+									"../run-Cp19x4Xv.js"
 );
 								const runStoryFn = async (opts) => {
 									const exitCode = await runPipeline({
@@ -9077,7 +9090,7 @@ async function runMetricsAction(options) {
 			const routingConfigPath = join(dbDir, "routing.yml");
 			let routingConfig = null;
 			if (existsSync$1(routingConfigPath)) try {
-				const { loadModelRoutingConfig } = await import("../routing-DkRxOHcc.js");
+				const { loadModelRoutingConfig } = await import("../routing-C0f2cYja.js");
 				routingConfig = loadModelRoutingConfig(routingConfigPath);
 			} catch {}
 			if (routingConfig === null) routingConfig = {
@@ -12363,22 +12376,24 @@ async function readRunEntry(dbRoot, resolvedRunId) {
 * bash-session-drift footgun documented in obs_025.
 */
 function detectAutoCommit(storyKey, startedAt, projectRoot) {
-	const grepPattern = `feat(story-${storyKey})`;
-	const result = spawnSync("git", [
-		"log",
-		"--oneline",
-		`--since=${startedAt}`,
-		`--grep=${grepPattern}`
-	], {
-		cwd: projectRoot,
-		encoding: "utf-8",
-		timeout: 1e4
-	});
-	if (result.status !== 0 || !result.stdout?.trim()) return void 0;
-	const lines = result.stdout.trim().split("\n").filter(Boolean);
-	for (const line of lines) {
-		const sha = line.split(" ")[0];
-		if (sha) return sha;
+	for (const prefix of ["feat", "wip"]) {
+		const grepPattern = `${prefix}(story-${storyKey})`;
+		const result = spawnSync("git", [
+			"log",
+			"--oneline",
+			`--since=${startedAt}`,
+			`--grep=${grepPattern}`
+		], {
+			cwd: projectRoot,
+			encoding: "utf-8",
+			timeout: 1e4
+		});
+		if (result.status !== 0 || !result.stdout?.trim()) continue;
+		const lines = result.stdout.trim().split("\n").filter(Boolean);
+		for (const line of lines) {
+			const sha = line.split(" ")[0];
+			if (sha) return sha;
+		}
 	}
 	return void 0;
 }
@@ -13387,8 +13402,8 @@ async function createProgram() {
 /** Fire-and-forget startup version check (story 8.3, AC3/AC5) */
 function checkForUpdatesInBackground(currentVersion) {
 	if (process.env.SUBSTRATE_NO_UPDATE_CHECK === "1") return;
-	import("../upgrade-GFHZ2nsS.js").then(async () => {
-		const { createVersionManager } = await import("../version-manager-impl-CPbTqr0B.js");
+	import("../upgrade-DHHSy4fQ.js").then(async () => {
+		const { createVersionManager } = await import("../version-manager-impl-CfzcfFwo.js");
 		const vm = createVersionManager();
 		const result = await vm.checkForUpdates();
 		if (result.updateAvailable) {

package/dist/{decisions-DVuBgwlc.js → decisions-EQtHqewP.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-BOooz8sb.js";
+import { addTokenUsage, createDecision, createPipelineRun, createRequirement, getArtifactByTypeForRun, getArtifactsByRun, getDecisionsByCategory, getDecisionsByPhase, getDecisionsByPhaseForRun, getLatestRun, getPipelineRunById, getRunningPipelineRuns, getTokenUsageSummary, listRequirements, registerArtifact, updateDecision, updatePipelineRun, updatePipelineRunConfig, upsertDecision } from "./dist-BWCudDcl.js";
 import "./decisions-CzSIEeGP.js";
 
 export { getLatestRun };

package/dist/{dist-BOooz8sb.js → dist-BWCudDcl.js}

@@ -14,11 +14,12 @@ import { homedir } from "os";
 import { createServer } from "node:http";
 import { createGunzip, createInflate } from "node:zlib";
 import { promisify } from "node:util";
-import { createRequire } from "node:module";
-import { fileURLToPath } from "node:url";
 import * as semver$2 from "semver";
 import * as semver$1 from "semver";
 import * as semver from "semver";
+import { coerce, compare, valid } from "semver";
+import { createRequire } from "node:module";
+import { fileURLToPath } from "node:url";
 import https from "node:https";
 
 //#region packages/core/dist/dispatch/types.js
@@ -1413,7 +1414,10 @@ var DispatcherImpl = class {
 			this._running.delete(id);
 			this._drainQueue();
 			if (code === 0) {
-				const normalizeResult = this._normalizer.normalize(stdout, agent);
+				const streamOutput = adapter.parseStreamOutput?.(stdout);
+				const effectiveStdout = streamOutput?.extractedText ?? stdout;
+				const totalTurns = streamOutput?.totalTurns;
+				const normalizeResult = this._normalizer.normalize(effectiveStdout, agent);
 				let parsed = null;
 				let parseError = null;
 				if (normalizeResult instanceof AdapterFormatError) {
@@ -1422,13 +1426,13 @@ var DispatcherImpl = class {
 						normalizeResult.tried_strategies.join(","),
 						normalizeResult.raw_output_snippet
 					].join(" | ");
-					const quality$1 = estimateOutputQuality(stdout);
+					const quality$1 = estimateOutputQuality(effectiveStdout);
 					this._eventBus.emit("agent:completed", {
 						dispatchId: id,
 						exitCode: code,
-						output: stdout,
+						output: effectiveStdout,
 						inputTokens,
-						outputTokens: Math.ceil(stdout.length / CHARS_PER_TOKEN$3),
+						outputTokens: Math.ceil(effectiveStdout.length / CHARS_PER_TOKEN$3),
 						qualityScore: quality$1.qualityScore,
 						agent,
 						...effectiveModel !== void 0 && { model: effectiveModel }
@@ -1444,7 +1448,7 @@ var DispatcherImpl = class {
 						id,
 						status: "completed",
 						exitCode: code,
-						output: stdout,
+						output: effectiveStdout,
 						parsed: null,
 						parseError: errMsg,
 						adapterError: true,
@@ -1453,16 +1457,17 @@ var DispatcherImpl = class {
 						durationMs,
 						tokenEstimate: {
 							input: inputTokens,
-							output: Math.ceil(stdout.length / CHARS_PER_TOKEN$3)
+							output: Math.ceil(effectiveStdout.length / CHARS_PER_TOKEN$3)
 						},
-						...finalModel !== void 0 ? { model: finalModel } : {}
+						...finalModel !== void 0 ? { model: finalModel } : {},
+						...totalTurns !== void 0 ? { totalTurns } : {}
 					});
 					return;
 				}
 				const parseResult = parseYamlResult(normalizeResult.yaml, outputSchema);
 				parsed = parseResult.parsed;
 				parseError = parseResult.error;
-				const quality = estimateOutputQuality(stdout);
+				const quality = estimateOutputQuality(effectiveStdout);
 				if (quality.hedgingCount > 0 || quality.qualityScore < 40) this._logger.warn({
 					id,
 					agent,
@@ -1473,9 +1478,9 @@ var DispatcherImpl = class {
 				this._eventBus.emit("agent:completed", {
 					dispatchId: id,
 					exitCode: code,
-					output: stdout,
+					output: effectiveStdout,
 					inputTokens,
-					outputTokens: Math.ceil(stdout.length / CHARS_PER_TOKEN$3),
+					outputTokens: Math.ceil(effectiveStdout.length / CHARS_PER_TOKEN$3),
 					qualityScore: quality.qualityScore,
 					agent,
 					...effectiveModel !== void 0 && { model: effectiveModel }
@@ -1491,15 +1496,16 @@ var DispatcherImpl = class {
 					id,
 					status: "completed",
 					exitCode: code,
-					output: stdout,
+					output: effectiveStdout,
 					parsed,
 					parseError,
 					durationMs,
 					tokenEstimate: {
 						input: inputTokens,
-						output: Math.ceil(stdout.length / CHARS_PER_TOKEN$3)
+						output: Math.ceil(effectiveStdout.length / CHARS_PER_TOKEN$3)
 					},
-					...finalModel !== void 0 ? { model: finalModel } : {}
+					...finalModel !== void 0 ? { model: finalModel } : {},
+					...totalTurns !== void 0 ? { totalTurns } : {}
 				});
 			} else {
 				const stderr = Buffer.concat(stderrChunks).toString("utf-8");
@@ -9414,6 +9420,43 @@ var Recommender = class Recommender {
 	}
 };
 
+//#endregion
+//#region packages/core/dist/adapters/version-compat.js
+function normalize(version) {
+	return valid(version) ?? valid(coerce(version) ?? "") ?? null;
+}
+/**
+* Compare a live CLI binary's reported version against the tested range. Pure.
+*
+* Three outcomes:
+*   - actual within range  → `{ compatible: true }`
+*   - actual outside range → `{ compatible: false, warning }` with a message
+*     naming the adapter + drift + suggested operator action
+*   - actual unparseable   → `{ compatible: false, warning }` flagging that
+*     the version couldn't be compared (degrade gracefully; never throw)
+*/
+function checkAdapterVersionCompat(adapterName, actualVersion, tested) {
+	const actual = normalize(actualVersion);
+	const min = normalize(tested.min);
+	const max = normalize(tested.max);
+	if (actual === null || min === null || max === null) return {
+		compatible: false,
+		warning: `${adapterName}: CLI version '${actualVersion}' could not be parsed for comparison against substrate's tested range (${tested.min}–${tested.max}). Flag behavior may differ; report any dispatch failures.`
+	};
+	if (compare(actual, min) < 0) return {
+		compatible: false,
+		warning: `${adapterName}: CLI version ${actualVersion} is below substrate's tested range (${tested.min}–${tested.max}). Older flag forms may be required; consider upgrading the CLI to a version within range, or upgrading substrate.` + (tested.note !== void 0 ? ` Range note: ${tested.note}` : "")
+	};
+	if (compare(actual, max) > 0) return {
+		compatible: false,
+		warning: `${adapterName}: CLI version ${actualVersion} is newer than substrate's tested range (${tested.min}–${tested.max}). Flag behavior may have changed since substrate was tested; consider upgrading substrate or reporting any dispatch failures.` + (tested.note !== void 0 ? ` Range note: ${tested.note}` : "")
+	};
+	return tested.note !== void 0 ? {
+		compatible: true,
+		warning: `${adapterName}: ${tested.note}`
+	} : { compatible: true };
+}
+
 //#endregion
 //#region packages/core/dist/adapters/claude-adapter.js
 const execAsync$2 = promisify(exec);
@@ -9440,10 +9483,26 @@ function stripCodeFences$2(raw) {
 * Health check: runs `claude --version` to verify install.
 * Billing detection: detects subscription vs API via version output or env.
 */
-var ClaudeCodeAdapter = class {
+var ClaudeCodeAdapter = class ClaudeCodeAdapter {
 	id = "claude-code";
 	displayName = "Claude Code";
 	adapterVersion = "1.0.0";
+	/**
+	* Claude Code CLI version range substrate's `buildCommand` has been
+	* empirically verified against (as of substrate v0.20.138 on 2026-05-31).
+	* `healthCheck` compares the live `claude --version` against this range
+	* and surfaces a warning when the operator's CLI is outside it.
+	*
+	* The `note` flags `--max-turns`: the flag is silently accepted by clap
+	* but not honored — substrate's `options.maxTurns` has no effect on
+	* Claude Code 2.x dispatches. Bumping the upper bound requires re-running
+	* the empirical audit (see `feedback_cli_adapter_empirical_version_match`).
+	*/
+	static TESTED_CLI_VERSION_RANGE = {
+		min: "2.1.152",
+		max: "2.1.168",
+		note: "Claude Code 2.x silently accepts but does not honor `--max-turns`; substrate no longer passes that flag. `-p --output-format stream-json` REQUIRES `--verbose` (hard error otherwise) — empirically verified against 2.1.168 (2026-06-07): with --verbose, NDJSON events emitted and `num_turns` present on the terminal result event."
+	};
 	_logger;
 	constructor(logger) {
 		this._logger = logger ?? createStderrLogger("claude-adapter");
@@ -9462,12 +9521,14 @@ var ClaudeCodeAdapter = class {
 				const whichResult = await execAsync$2("which claude", { timeout: 5e3 });
 				cliPath = whichResult.stdout.trim();
 			} catch {}
+			const compat = checkAdapterVersionCompat("claude-code", output, ClaudeCodeAdapter.TESTED_CLI_VERSION_RANGE);
 			return {
 				healthy: true,
 				version: output,
 				...cliPath !== void 0 ? { cliPath } : {},
 				detectedBillingModes,
-				supportsHeadless: true
+				supportsHeadless: true,
+				...compat.warning !== void 0 ? { compatibilityWarning: compat.warning } : {}
 			};
 		} catch (err) {
 			const message = err instanceof Error ? err.message : String(err);
@@ -9491,7 +9552,7 @@ var ClaudeCodeAdapter = class {
 			model,
 			"--dangerously-skip-permissions"
 		];
-		if (options.maxTurns !== void 0) args.push("--max-turns", String(options.maxTurns));
+		args.push("--output-format", "stream-json", "--verbose");
 		if (options.additionalFlags && options.additionalFlags.length > 0) args.push(...options.additionalFlags);
 		const systemPromptParts = [BASE_SYSTEM_PROMPT];
 		if (options.optimizationDirectives) systemPromptParts.push(`\n\n## Optimization Directives\n${options.optimizationDirectives}`);
@@ -9535,6 +9596,51 @@ var ClaudeCodeAdapter = class {
 		};
 	}
 	/**
+	* Pre-process `--output-format stream-json` stdout before YAML extraction (Story 81-9).
+	*
+	* Claude Code CLI with `--output-format stream-json` emits NDJSON events to stdout.
+	* This method parses that stream to extract:
+	*   1. `extractedText` — the full agent response from the terminal result event's
+	*      `result` field. Identical to raw text output; passed to AdapterOutputNormalizer.
+	*   2. `totalTurns` — agentic turn count from `num_turns` in the result event.
+	*      This is the ONLY synchronous, reliable turn-count source available at
+	*      DispatchResult resolution time.
+	*
+	* Graceful fallbacks:
+	*   - If the stream cannot be parsed as NDJSON, returns `{ extractedText: stdout }`.
+	*   - If the result event is missing, returns `{ extractedText: stdout }`.
+	*   - If `num_turns` is absent from the event, returns without `totalTurns` (AC2:
+	*     "when the count is genuinely unavailable, leave the field absent, never fabricate").
+	*
+	* @param stdout Raw subprocess stdout (NDJSON event stream from Claude Code CLI)
+	* @returns `{ extractedText, totalTurns? }` — text for YAML extraction and optional turn count
+	*/
+	parseStreamOutput(stdout) {
+		try {
+			const lines = stdout.split("\n");
+			for (const line of lines) {
+				const trimmed = line.trim();
+				if (trimmed === "") continue;
+				let event;
+				try {
+					event = JSON.parse(trimmed);
+				} catch {
+					continue;
+				}
+				if (event !== null && typeof event === "object" && event["type"] === "result") {
+					const resultEvent = event;
+					const extractedText = typeof resultEvent.result === "string" && resultEvent.result.length > 0 ? resultEvent.result : stdout;
+					const totalTurns = typeof resultEvent.num_turns === "number" && resultEvent.num_turns >= 0 ? resultEvent.num_turns : void 0;
+					return totalTurns !== void 0 ? {
+						extractedText,
+						totalTurns
+					} : { extractedText };
+				}
+			}
+		} catch {}
+		return { extractedText: stdout };
+	}
+	/**
 	* Build spawn command for plan generation.
 	*/
 	buildPlanningCommand(request, options) {
@@ -9744,10 +9850,30 @@ function detectCodexSandboxBlock(output) {
 * Codex CLI uses stdin for the prompt and outputs JSON when --json flag is used.
 * Codex supports subscription billing (via `codex login`) and API key billing.
 */
-var CodexCLIAdapter = class {
+var CodexCLIAdapter = class CodexCLIAdapter {
 	id = "codex";
 	displayName = "Codex CLI";
 	adapterVersion = "1.0.0";
+	/**
+	* Codex CLI version range substrate's `buildCommand` has been empirically
+	* verified against (as of substrate v0.20.138 on 2026-05-31). The range
+	* is narrow because the v0.20.131→137 arc taught us how much can drift
+	* between minor versions — `--full-auto` changed meaning between 0.111.0
+	* and 0.128.0 (deprecated, semantics shifted) and almost certainly will
+	* drift again.
+	*
+	* The `note` flags the structural truth: `codex exec` hardcodes
+	* `approval_policy=Never` and ignores `-c approval_policy=...` overrides
+	* (codex-rs/exec/src/lib.rs:407). On enterprise managed configs that
+	* disallow `Never`, dispatch will fail at the apply_patch layer regardless
+	* of substrate's flag — see CODEX_SANDBOX_BLOCK_HINT and the policy ask
+	* document in `docs/2026-05-29-codex-managed-config-policy-ask.md`.
+	*/
+	static TESTED_CLI_VERSION_RANGE = {
+		min: "0.135.0",
+		max: "0.135.0",
+		note: "`codex exec` hardcodes approval_policy=Never (cannot be overridden); on enterprise managed configs disallowing Never, dispatch fails at apply_patch."
+	};
 	_logger;
 	constructor(logger) {
 		this._logger = logger ?? createStderrLogger("codex-adapter");
@@ -9764,12 +9890,14 @@ var CodexCLIAdapter = class {
 				const whichResult = await execAsync$1("which codex", { timeout: 5e3 });
 				cliPath = whichResult.stdout.trim();
 			} catch {}
+			const compat = checkAdapterVersionCompat("codex", output, CodexCLIAdapter.TESTED_CLI_VERSION_RANGE);
 			return {
 				healthy: true,
 				version: output,
 				...cliPath !== void 0 ? { cliPath } : {},
 				detectedBillingModes: CODEX_BILLING_MODES,
-				supportsHeadless: true
+				supportsHeadless: true,
+				...compat.warning !== void 0 ? { compatibilityWarning: compat.warning } : {}
 			};
 		} catch (err) {
 			const message = err instanceof Error ? err.message : String(err);
@@ -10005,10 +10133,22 @@ function stripCodeFences(raw) {
 * Gemini CLI follows similar patterns to Claude Code: prompt via `-p` flag,
 * JSON output via `--output-format json`, and model via `--model`.
 */
-var GeminiCLIAdapter = class {
+var GeminiCLIAdapter = class GeminiCLIAdapter {
 	id = "gemini";
 	displayName = "Gemini CLI";
 	adapterVersion = "1.0.0";
+	/**
+	* Gemini CLI version range substrate's `buildCommand` has been empirically
+	* verified against (as of substrate v0.20.138 on 2026-05-31). Empirical
+	* audit confirmed `-p`, `-m/--model`, `-o/--output-format` (with choices
+	* `text|json|stream-json`) and the planning command's positional-prompt form
+	* all parse cleanly on both 0.33.0 and 0.44.1 — same flag layer across a
+	* meaningful version span.
+	*/
+	static TESTED_CLI_VERSION_RANGE = {
+		min: "0.33.0",
+		max: "0.44.1"
+	};
 	_logger;
 	constructor(logger) {
 		this._logger = logger ?? createStderrLogger("gemini-adapter");
@@ -10027,12 +10167,14 @@ var GeminiCLIAdapter = class {
 				const whichResult = await execAsync("which gemini", { timeout: 5e3 });
 				cliPath = whichResult.stdout.trim();
 			} catch {}
+			const compat = checkAdapterVersionCompat("gemini", output, GeminiCLIAdapter.TESTED_CLI_VERSION_RANGE);
 			return {
 				healthy: true,
 				version: output,
 				...cliPath !== void 0 ? { cliPath } : {},
 				detectedBillingModes,
-				supportsHeadless: true
+				supportsHeadless: true,
+				...compat.warning !== void 0 ? { compatibilityWarning: compat.warning } : {}
 			};
 		} catch (err) {
 			const message = err instanceof Error ? err.message : String(err);
@@ -11342,4 +11484,4 @@ async function callLLM(params) {
 
 //#endregion
 export { ADVISORY_NOTES, AdapterRegistry, AdtError, BudgetConfigSchema, CODEX_SANDBOX_BLOCK_HINT, CURRENT_CONFIG_FORMAT_VERSION, CURRENT_TASK_GRAPH_VERSION, Categorizer, ClaudeCodeAdapter, CodexCLIAdapter, ConfigError, ConfigIncompatibleFormatError, ConsumerAnalyzer, CostTrackerConfigSchema, DEFAULT_CONFIG, DEFAULT_GLOBAL_SETTINGS, DispatcherImpl, DoltClient, DoltNotInstalled, DoltQueryError, ESCALATION_DIAGNOSIS, EXPERIMENT_RESULT, EfficiencyScorer, GeminiCLIAdapter, GlobalSettingsSchema, InMemoryDatabaseAdapter, IngestionServer, LEARNING_FINDING, LogTurnAnalyzer, ModelRoutingConfigSchema, MonitorDatabaseImpl, OPERATIONAL_FINDING, PartialGlobalSettingsSchema, PartialProviderConfigSchema, ProviderPolicySchema, ProvidersSchema, Recommender, RoutingConfigError, RoutingRecommender, RoutingResolver, RoutingTelemetry, RoutingTokenAccumulator, RoutingTuner, STORY_METRICS, STORY_OUTCOME, SubstrateConfigSchema, TASK_TYPE_PHASE_MAP, TEST_EXPANSION_FINDING, TEST_PLAN, TelemetryConfigSchema, TelemetryNormalizer, TelemetryPipeline, TurnAnalyzer, VersionManagerImpl, addTokenUsage, aggregateTokenUsageForRun, aggregateTokenUsageForStory, buildAuditLogEntry, buildBranchName, buildModificationDirective, buildPRBody, buildWorktreePath, callLLM, checkDoltInstalled, classifyVersionGap, compareRunMetrics, createAmendmentRun, createConfigSystem, createDatabaseAdapter as createDatabaseAdapter$1, createDecision, createExperimenter, createPipelineRun, createRequirement, createStderrLogger, createVersionManager, detectCodexSandboxBlock, detectInterfaceChanges, determineVerdict, getActiveDecisions, getAllCostEntriesFiltered, getArtifactByTypeForRun, getArtifactsByRun, getBaselineRunMetrics, getDecisionsByCategory, getDecisionsByPhase, getDecisionsByPhaseForRun, getLatestCompletedRun, getLatestRun, getModelTier, getPipelineRunById, getPlanningCostTotal, getRetryableEscalations, getRunMetrics, getRunningPipelineRuns, getSessionCostSummary, getSessionCostSummaryFiltered, getStoryMetricsForRun, getTokenUsageSummary, incrementRunRestarts, initSchema, initWorkGraphSchema, initializeDolt, listRequirements, listRunMetrics, loadModelRoutingConfig, loadParentRunDecisions, registerArtifact, resolvePromptFile, supersedeDecision, swallowDebug, tagRunAsBaseline, updateDecision, updatePipelineRun, updatePipelineRunConfig, upsertDecision, writeRunMetrics, writeStoryMetrics };
-//# sourceMappingURL=dist-BOooz8sb.js.map
+//# sourceMappingURL=dist-BWCudDcl.js.map

package/dist/{errors-iQa5SrYw.js → errors-rZ-lz8U0.js}

@@ -1,4 +1,4 @@
-import { AdtError } from "./dist-BOooz8sb.js";
+import { AdtError } from "./dist-BWCudDcl.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-iQa5SrYw.js.map
+//# sourceMappingURL=errors-rZ-lz8U0.js.map

package/dist/{experimenter-B7NPkaQ8.js → experimenter-Dn0gGOYl.js}

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

package/dist/{health-BqCpWu2_.js → health-BXVyiLiL.js}

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

package/dist/{health-xmLvQgb4.js → health-D27XuFLF.js}

@@ -1,7 +1,7 @@
-import { DEFAULT_STALL_THRESHOLD_SECONDS, getAllDescendantPids, getAutoHealthData, inspectProcessTree, isOrchestratorProcessLine, registerHealthCommand, runHealthAction } from "./health-BqCpWu2_.js";
+import { DEFAULT_STALL_THRESHOLD_SECONDS, getAllDescendantPids, getAutoHealthData, inspectProcessTree, isOrchestratorProcessLine, registerHealthCommand, runHealthAction } from "./health-BXVyiLiL.js";
 import "./logger-KeHncl-f.js";
-import "./dist-BOooz8sb.js";
-import "./manifest-read-B0XYbIpU.js";
+import "./dist-BWCudDcl.js";
+import "./manifest-read-IvpNQ6Yy.js";
 import "./work-graph-repository-DZyJv5pV.js";
 import "./decisions-CzSIEeGP.js";