substrate-ai 0.3.1 → 0.3.3

package/dist/{adapter-registry-PsWhP_1Q.js → adapter-registry-DHl0W-YB.js}

@@ -76,6 +76,13 @@ var ClaudeCodeAdapter = class {
 		const unsetKeys = ["CLAUDECODE", "CLAUDE_CODE_ENTRYPOINT"];
 		if (options.billingMode === "api" && options.apiKey) envEntries.ANTHROPIC_API_KEY = options.apiKey;
 		else unsetKeys.push("ANTHROPIC_API_KEY");
+		if (options.otlpEndpoint !== void 0) {
+			envEntries.CLAUDE_CODE_ENABLE_TELEMETRY = "1";
+			envEntries.OTEL_LOGS_EXPORTER = "otlp";
+			envEntries.OTEL_METRICS_EXPORTER = "otlp";
+			envEntries.OTEL_EXPORTER_OTLP_PROTOCOL = "http/json";
+			envEntries.OTEL_EXPORTER_OTLP_ENDPOINT = options.otlpEndpoint;
+		}
 		return {
 			binary: "claude",
 			args,
@@ -815,4 +822,4 @@ var AdapterRegistry = class {
 
 //#endregion
 export { AdapterRegistry, ClaudeCodeAdapter, CodexCLIAdapter, GeminiCLIAdapter };
-//# sourceMappingURL=adapter-registry-PsWhP_1Q.js.map
+//# sourceMappingURL=adapter-registry-DHl0W-YB.js.map

package/dist/cli/index.js

@@ -1,14 +1,14 @@
 #!/usr/bin/env node
-import { DEFAULT_CONFIG, DEFAULT_ROUTING_POLICY, DatabaseWrapper, DoltNotInstalled, FileStateStore, SUBSTRATE_OWNED_SETTINGS_KEYS, VALID_PHASES, buildPipelineStatusOutput, checkDoltInstalled, createConfigSystem, createContextCompiler, createDispatcher, createDoltClient, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStateStore, createStopAfterGate, findPackageRoot, formatOutput, formatPhaseCompletionSummary, formatPipelineStatusHuman, formatPipelineSummary, formatTokenTelemetry, getAllDescendantPids, getAutoHealthData, getSubstrateDefaultSettings, initializeDolt, parseDbTimestampAsUtc, registerHealthCommand, registerRunCommand, resolveBmadMethodSrcPath, resolveBmadMethodVersion, resolveMainRepoRoot, resolveStoryKeys, runAnalysisPhase, runMigrations, runPlanningPhase, runSolutioningPhase, validateStopAfterFromConflict } from "../run-DNURadtJ.js";
+import { DEFAULT_CONFIG, DEFAULT_ROUTING_POLICY, DatabaseWrapper, DoltNotInstalled, FileStateStore, SUBSTRATE_OWNED_SETTINGS_KEYS, TelemetryPersistence, VALID_PHASES, buildPipelineStatusOutput, checkDoltInstalled, createConfigSystem, createContextCompiler, createDispatcher, createDoltClient, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStateStore, createStopAfterGate, findPackageRoot, formatOutput, formatPhaseCompletionSummary, formatPipelineStatusHuman, formatPipelineSummary, formatTokenTelemetry, getAllDescendantPids, getAutoHealthData, getSubstrateDefaultSettings, initializeDolt, parseDbTimestampAsUtc, registerHealthCommand, registerRunCommand, resolveBmadMethodSrcPath, resolveBmadMethodVersion, resolveMainRepoRoot, resolveStoryKeys, runAnalysisPhase, runMigrations, runPlanningPhase, runSolutioningPhase, validateStopAfterFromConflict } from "../run-DI9s014E.js";
 import { createLogger } from "../logger-D2fS2ccL.js";
-import { AdapterRegistry } from "../adapter-registry-PsWhP_1Q.js";
-import { CURRENT_CONFIG_FORMAT_VERSION, CURRENT_TASK_GRAPH_VERSION, PartialSubstrateConfigSchema } from "../config-migrator-DSi8KhQC.js";
+import { AdapterRegistry } from "../adapter-registry-DHl0W-YB.js";
+import { CURRENT_CONFIG_FORMAT_VERSION, CURRENT_TASK_GRAPH_VERSION, PartialSubstrateConfigSchema } from "../config-migrator-CQmBdKeG.js";
 import { ConfigError, createEventBus } from "../helpers-RL22dYtn.js";
 import { addTokenUsage, createDecision, createPipelineRun, getDecisionsByCategory, getDecisionsByPhaseForRun, getLatestRun, getTokenUsageSummary, listRequirements, updatePipelineRun } from "../decisions-Dq4cAA2L.js";
 import { ESCALATION_DIAGNOSIS, EXPERIMENT_RESULT, OPERATIONAL_FINDING, STORY_METRICS, aggregateTokenUsageForRun, compareRunMetrics, getBaselineRunMetrics, getRunMetrics, getStoryMetricsForRun, incrementRunRestarts, listRunMetrics, tagRunAsBaseline } from "../operational-Bovj4fS-.js";
 import { abortMerge, createWorktree, getConflictingFiles, getMergedFiles, getOrphanedWorktrees, performMerge, removeBranch, removeWorktree, simulateMerge, verifyGitVersion } from "../git-utils-CtmrZrHS.js";
-import "../version-manager-impl-CizNmmLT.js";
-import { registerUpgradeCommand } from "../upgrade-Cvwtnwl4.js";
+import "../version-manager-impl-33JYXsqa.js";
+import { registerUpgradeCommand } from "../upgrade-DO307rFf.js";
 import { Command } from "commander";
 import { fileURLToPath } from "url";
 import { dirname, join, resolve } from "path";
@@ -2554,6 +2554,7 @@ async function runSupervisorAction(options, deps = {}) {
 		runId,
 		restartCount: 0
 	};
+	let maxRestartsExhausted = false;
 	const startTime = Date.now();
 	function emitEvent(event) {
 		if (outputFormat === "json") {
@@ -2664,7 +2665,7 @@ async function runSupervisorAction(options, deps = {}) {
 								const expDb = expDbWrapper.db;
 								const { runRunAction: runPipeline } = await import(
 									/* @vite-ignore */
-									"../run-D6WEx9l2.js"
+									"../run-33J0SBp1.js"
 );
 								const runStoryFn = async (opts) => {
 									const exitCode = await runPipeline({
@@ -2729,6 +2730,7 @@ async function runSupervisorAction(options, deps = {}) {
 			}
 			return summary.failed.length > 0 || summary.escalated.length > 0 ? 1 : 0;
 		}
+		if (maxRestartsExhausted) return 2;
 		const stallResult = await handleStallRecovery(health, state, {
 			stallThreshold,
 			maxRestarts,
@@ -2745,10 +2747,8 @@ async function runSupervisorAction(options, deps = {}) {
 			emitEvent,
 			log
 		});
-		if (stallResult !== null) {
-			if (stallResult.maxRestartsExceeded) return 2;
-			state = stallResult.state;
-		}
+		if (stallResult !== null) if (stallResult.maxRestartsExceeded) maxRestartsExhausted = true;
+		else state = stallResult.state;
 		await sleep(pollInterval * 1e3);
 	}
 }
@@ -2778,6 +2778,7 @@ async function runMultiProjectSupervisor(options, deps = {}) {
 	}]));
 	const doneProjects = new Set();
 	const projectExitCodes = new Map();
+	const maxRestartsExhaustedProjects = new Set();
 	const startTime = Date.now();
 	function emitEvent(event) {
 		if (outputFormat === "json") {
@@ -2834,6 +2835,11 @@ async function runMultiProjectSupervisor(options, deps = {}) {
 				projectExitCodes.set(projectRoot, summary.failed.length > 0 || summary.escalated.length > 0 ? 1 : 0);
 				continue;
 			}
+			if (maxRestartsExhaustedProjects.has(projectRoot)) {
+				doneProjects.add(projectRoot);
+				projectExitCodes.set(projectRoot, 2);
+				continue;
+			}
 			const stallResult = await handleStallRecovery(health, state, {
 				stallThreshold,
 				maxRestarts,
@@ -2846,10 +2852,8 @@ async function runMultiProjectSupervisor(options, deps = {}) {
 				}),
 				log: (msg) => log(`[${projectRoot}] ${msg}`)
 			});
-			if (stallResult !== null) if (stallResult.maxRestartsExceeded) {
-				doneProjects.add(projectRoot);
-				projectExitCodes.set(projectRoot, 2);
-			} else states.set(projectRoot, stallResult.state);
+			if (stallResult !== null) if (stallResult.maxRestartsExceeded) maxRestartsExhaustedProjects.add(projectRoot);
+			else states.set(projectRoot, stallResult.state);
 		}
 		if (doneProjects.size >= projects.length) {
 			const elapsedSeconds = Math.round((Date.now() - startTime) / 1e3);
@@ -2908,8 +2912,217 @@ function registerSupervisorCommand(program, _version = "0.0.0", projectRoot = pr
 //#endregion
 //#region src/cli/commands/metrics.ts
 const logger$11 = createLogger("metrics-cmd");
+async function openTelemetryDb(dbPath) {
+	if (!existsSync(dbPath)) return null;
+	try {
+		const db = new Database(dbPath, { readonly: true });
+		return db;
+	} catch {
+		return null;
+	}
+}
+function rowsToEfficiencyScore(rows) {
+	return rows;
+}
+function printEfficiencyTable(scores) {
+	process.stdout.write(`\nEfficiency Scores (${scores.length} records)\n`);
+	process.stdout.write("─".repeat(80) + "\n");
+	process.stdout.write(`  ${"Story Key".padEnd(14)} ${"Score".padStart(6)} ${"Cache Hit%".padStart(11)} ${"I/O Ratio".padStart(10)} ${"Ctx Mgmt".padStart(9)} Model\n`);
+	process.stdout.write("  " + "─".repeat(76) + "\n");
+	for (const s of scores) {
+		const cacheHitPct = s.totalTurns > 0 ? `${(s.avgCacheHitRate * 100).toFixed(1)}%` : "0.0%";
+		const ioRatio = s.avgIoRatio.toFixed(2);
+		const ctxMgmt = String(Math.round(s.contextManagementSubScore));
+		const model = s.perModelBreakdown.length > 0 ? s.perModelBreakdown[0]?.model ?? "unknown" : "unknown";
+		process.stdout.write(`  ${s.storyKey.padEnd(14)} ${String(s.compositeScore).padStart(6)} ${cacheHitPct.padStart(11)} ${ioRatio.padStart(10)} ${ctxMgmt.padStart(9)} ${model}\n`);
+	}
+}
+function printRecommendationTable(recs) {
+	process.stdout.write(`\nRecommendations (${recs.length} records)\n`);
+	process.stdout.write("─".repeat(80) + "\n");
+	process.stdout.write(`  ${"Story".padEnd(12)} ${"Severity".padEnd(10)} ${"Rule".padEnd(24)} ${"Savings Tokens".padStart(15)}\n`);
+	process.stdout.write("  " + "─".repeat(64) + "\n");
+	for (const r of recs) {
+		const savings = r.potentialSavingsTokens !== void 0 ? String(r.potentialSavingsTokens) : "-";
+		process.stdout.write(`  ${r.storyKey.padEnd(12)} ${r.severity.padEnd(10)} ${r.ruleId.padEnd(24)} ${savings.padStart(15)}\n`);
+		process.stdout.write(`    ${r.title}\n`);
+	}
+}
+function printTurnTable(turns, storyKey) {
+	process.stdout.write(`\nTurn Analysis: ${storyKey} (${turns.length} turns)\n`);
+	process.stdout.write("─".repeat(80) + "\n");
+	process.stdout.write(`  ${"#".padStart(4)} ${"Tokens In".padStart(10)} ${"Tok Out".padStart(8)} ${"Cache Hit%".padStart(11)} ${"Ctx Size".padStart(9)} Spike\n`);
+	process.stdout.write("  " + "─".repeat(60) + "\n");
+	for (const t of turns) {
+		const cacheHitPct = t.inputTokens > 0 ? `${(t.cacheHitRate * 100).toFixed(1)}%` : "0.0%";
+		const spike = t.isContextSpike ? " ⚠" : "";
+		process.stdout.write(`  ${String(t.turnNumber).padStart(4)} ${t.inputTokens.toLocaleString().padStart(10)} ${t.outputTokens.toLocaleString().padStart(8)} ${cacheHitPct.padStart(11)} ${t.contextSize.toLocaleString().padStart(9)}${spike}\n`);
+	}
+}
+function printConsumerTable(consumers, storyKey) {
+	process.stdout.write(`\nConsumer Stats: ${storyKey} (${consumers.length} consumers)\n`);
+	process.stdout.write("─".repeat(80) + "\n");
+	process.stdout.write(`  ${"Consumer Key".padEnd(36)} ${"Category".padEnd(20)} ${"Tokens".padStart(10)} ${"%".padStart(7)}\n`);
+	process.stdout.write("  " + "─".repeat(76) + "\n");
+	for (const c of consumers) {
+		const key = c.consumerKey.slice(0, 34);
+		const pct = `${c.percentage.toFixed(1)}%`;
+		process.stdout.write(`  ${key.padEnd(36)} ${c.category.padEnd(20)} ${c.totalTokens.toLocaleString().padStart(10)} ${pct.padStart(7)}\n`);
+	}
+}
+function printCategoryTable(stats, label) {
+	process.stdout.write(`\nCategory Stats${label} (${stats.length} categories)\n`);
+	process.stdout.write("─".repeat(80) + "\n");
+	process.stdout.write(`  ${"Category".padEnd(22)} ${"Tokens".padStart(12)} ${"%".padStart(8)} ${"Events".padStart(8)} ${"Avg/Event".padStart(10)} Trend\n`);
+	process.stdout.write("  " + "─".repeat(70) + "\n");
+	const sorted = [...stats].sort((a, b) => b.totalTokens - a.totalTokens);
+	for (const c of sorted) {
+		const pct = `${c.percentage.toFixed(1)}%`;
+		const avg = c.avgTokensPerEvent.toFixed(0);
+		process.stdout.write(`  ${c.category.padEnd(22)} ${c.totalTokens.toLocaleString().padStart(12)} ${pct.padStart(8)} ${String(c.eventCount).padStart(8)} ${avg.padStart(10)} ${c.trend}\n`);
+	}
+}
 async function runMetricsAction(options) {
-	const { outputFormat, projectRoot, limit = 10, compare, tagBaseline, analysis, sprint, story, taskType, since, aggregate } = options;
+	const { outputFormat, projectRoot, limit = 10, compare, tagBaseline, analysis, sprint, story, taskType, since, aggregate, efficiency, recommendations, turns, consumers, categories, compareStories } = options;
+	const telemetryModes = [
+		efficiency,
+		recommendations,
+		turns,
+		consumers,
+		categories,
+		compareStories
+	].filter(Boolean);
+	if (telemetryModes.length > 1) {
+		process.stderr.write("Error: --efficiency, --recommendations, --turns, --consumers, --categories, and --compare-stories are mutually exclusive\n");
+		return 1;
+	}
+	const hasTelemetryMode = telemetryModes.length > 0;
+	if (hasTelemetryMode && (compare !== void 0 || tagBaseline !== void 0 || analysis !== void 0)) {
+		process.stderr.write("Error: telemetry modes (--efficiency, --recommendations, --turns, --consumers, --categories, --compare-stories) cannot be combined with --compare, --tag-baseline, or --analysis\n");
+		return 1;
+	}
+	if (hasTelemetryMode) {
+		const dbRoot$1 = await resolveMainRepoRoot(projectRoot);
+		const dbPath$1 = join(dbRoot$1, ".substrate", "substrate.db");
+		const doltStatePath = join(dbRoot$1, ".substrate", "state", ".dolt");
+		const doltExists = existsSync(doltStatePath);
+		if (!doltExists && !existsSync(dbPath$1)) {
+			const msg = "No telemetry data yet — run a pipeline with `telemetry.enabled: true`";
+			if (turns !== void 0 || consumers !== void 0) {
+				process.stderr.write(`Error: ${msg}\n`);
+				return 1;
+			}
+			if (outputFormat === "json") process.stdout.write(formatOutput({ message: msg }, "json", true) + "\n");
+			else process.stdout.write(msg + "\n");
+			return 0;
+		}
+		const sqliteDb = await openTelemetryDb(dbPath$1);
+		if (sqliteDb === null) {
+			const msg = "No telemetry data yet — run a pipeline with `telemetry.enabled: true`";
+			if (turns !== void 0 || consumers !== void 0) {
+				process.stderr.write(`Error: ${msg}\n`);
+				return 1;
+			}
+			if (outputFormat === "json") process.stdout.write(formatOutput({ message: msg }, "json", true) + "\n");
+			else process.stdout.write(msg + "\n");
+			return 0;
+		}
+		try {
+			const telemetryPersistence = new TelemetryPersistence(sqliteDb);
+			telemetryPersistence.initSchema();
+			if (efficiency === true) {
+				const scores = await telemetryPersistence.getEfficiencyScores(20);
+				if (outputFormat === "json") process.stdout.write(formatOutput({ efficiency: rowsToEfficiencyScore(scores) }, "json", true) + "\n");
+				else printEfficiencyTable(scores);
+				return 0;
+			}
+			if (recommendations === true) {
+				const recs = story !== void 0 ? await telemetryPersistence.getRecommendations(story) : await telemetryPersistence.getAllRecommendations(50);
+				if (outputFormat === "json") process.stdout.write(formatOutput({
+					recommendations: recs,
+					...story !== void 0 && { storyKey: story }
+				}, "json", true) + "\n");
+				else if (recs.length === 0) {
+					const msg = story !== void 0 ? `No recommendations found for story '${story}'` : "No recommendations yet — run a pipeline with `telemetry.enabled: true`";
+					process.stdout.write(msg + "\n");
+				} else printRecommendationTable(recs);
+				return 0;
+			}
+			if (turns !== void 0) {
+				const turnData = await telemetryPersistence.getTurnAnalysis(turns);
+				if (turnData.length === 0) {
+					const msg = `No turn analysis data found for story '${turns}'`;
+					if (outputFormat === "json") process.stdout.write(formatOutput(null, "json", false, msg) + "\n");
+					else process.stderr.write(`Error: ${msg}\n`);
+					return 1;
+				}
+				if (outputFormat === "json") process.stdout.write(formatOutput({ turns: turnData }, "json", true) + "\n");
+				else printTurnTable(turnData, turns);
+				return 0;
+			}
+			if (consumers !== void 0) {
+				const consumerData = await telemetryPersistence.getConsumerStats(consumers);
+				if (consumerData.length === 0) {
+					const msg = `No consumer stats found for story '${consumers}'`;
+					if (outputFormat === "json") process.stdout.write(formatOutput(null, "json", false, msg) + "\n");
+					else process.stderr.write(`Error: ${msg}\n`);
+					return 1;
+				}
+				if (outputFormat === "json") process.stdout.write(formatOutput({ consumers: consumerData }, "json", true) + "\n");
+				else printConsumerTable(consumerData, consumers);
+				return 0;
+			}
+			if (categories === true) {
+				const storyKey = story;
+				const categoryData = await telemetryPersistence.getCategoryStats(storyKey ?? "");
+				const label = storyKey !== void 0 ? `: ${storyKey}` : "";
+				if (outputFormat === "json") process.stdout.write(formatOutput({
+					categories: categoryData,
+					storyKey
+				}, "json", true) + "\n");
+				else printCategoryTable(categoryData, label);
+				return 0;
+			}
+			if (compareStories !== void 0) {
+				const [keyA, keyB] = compareStories;
+				const [scoreA, scoreB] = await Promise.all([telemetryPersistence.getEfficiencyScore(keyA), telemetryPersistence.getEfficiencyScore(keyB)]);
+				if (scoreA === null || scoreB === null) {
+					const missing = [scoreA === null ? keyA : null, scoreB === null ? keyB : null].filter(Boolean).join(", ");
+					const msg = `No efficiency score found for story: ${missing}`;
+					if (outputFormat === "json") process.stdout.write(formatOutput(null, "json", false, msg) + "\n");
+					else process.stderr.write(`Error: ${msg}\n`);
+					return 1;
+				}
+				const delta = {
+					compositeScore: scoreB.compositeScore - scoreA.compositeScore,
+					cacheHitSubScore: scoreB.cacheHitSubScore - scoreA.cacheHitSubScore,
+					ioRatioSubScore: scoreB.ioRatioSubScore - scoreA.ioRatioSubScore,
+					contextManagementSubScore: scoreB.contextManagementSubScore - scoreA.contextManagementSubScore
+				};
+				if (outputFormat === "json") process.stdout.write(formatOutput({
+					storyA: scoreA,
+					storyB: scoreB,
+					delta
+				}, "json", true) + "\n");
+				else {
+					const sign = (n) => n > 0 ? "+" : "";
+					process.stdout.write(`\nEfficiency Comparison: ${keyA} vs ${keyB}\n`);
+					process.stdout.write("─".repeat(80) + "\n");
+					process.stdout.write(`  ${"Metric".padEnd(30)} ${keyA.padStart(12)} ${keyB.padStart(12)} ${"Delta".padStart(10)}\n`);
+					process.stdout.write("  " + "─".repeat(66) + "\n");
+					process.stdout.write(`  ${"Composite Score".padEnd(30)} ${String(scoreA.compositeScore).padStart(12)} ${String(scoreB.compositeScore).padStart(12)} ${`${sign(delta.compositeScore)}${delta.compositeScore}`.padStart(10)}\n`);
+					process.stdout.write(`  ${"Cache Hit Sub-Score".padEnd(30)} ${scoreA.cacheHitSubScore.toFixed(1).padStart(12)} ${scoreB.cacheHitSubScore.toFixed(1).padStart(12)} ${`${sign(delta.cacheHitSubScore)}${delta.cacheHitSubScore.toFixed(1)}`.padStart(10)}\n`);
+					process.stdout.write(`  ${"I/O Ratio Sub-Score".padEnd(30)} ${scoreA.ioRatioSubScore.toFixed(1).padStart(12)} ${scoreB.ioRatioSubScore.toFixed(1).padStart(12)} ${`${sign(delta.ioRatioSubScore)}${delta.ioRatioSubScore.toFixed(1)}`.padStart(10)}\n`);
+					process.stdout.write(`  ${"Context Mgmt Sub-Score".padEnd(30)} ${scoreA.contextManagementSubScore.toFixed(1).padStart(12)} ${scoreB.contextManagementSubScore.toFixed(1).padStart(12)} ${`${sign(delta.contextManagementSubScore)}${delta.contextManagementSubScore.toFixed(1)}`.padStart(10)}\n`);
+				}
+				return 0;
+			}
+		} finally {
+			try {
+				sqliteDb.close();
+			} catch {}
+		}
+	}
 	if (analysis !== void 0) {
 		const dbRoot$1 = await resolveMainRepoRoot(projectRoot);
 		const reportBase = join(dbRoot$1, "_bmad-output", "supervisor-reports", `${analysis}-analysis`);
@@ -3142,26 +3355,43 @@ async function runMetricsAction(options) {
 	}
 }
 function registerMetricsCommand(program, _version = "0.0.0", projectRoot = process.cwd()) {
-	program.command("metrics").description("Show historical pipeline run metrics and cross-run comparison").option("--project-root <path>", "Project root directory", projectRoot).option("--output-format <format>", "Output format: human (default) or json", "human").option("--limit <n>", "Number of runs to show (default: 10)", (v) => parseInt(v, 10), 10).option("--compare <run-id-a,run-id-b>", "Compare two runs side-by-side (comma-separated IDs, e.g. abc123,def456)").option("--tag-baseline <run-id>", "Mark a run as the performance baseline").option("--analysis <run-id>", "Read and output the analysis report for the specified run (AC5 of Story 17-3)").option("--sprint <sprint>", "Filter StateStore metrics by sprint (e.g. sprint-1)").option("--story <story-key>", "Filter StateStore metrics by story key (e.g. 26-1)").option("--task-type <type>", "Filter StateStore metrics by task type (e.g. dev-story)").option("--since <iso-date>", "Filter StateStore metrics at or after this ISO timestamp").option("--aggregate", "Aggregate StateStore metrics grouped by task_type").action(async (opts) => {
+	program.command("metrics").description("Show historical pipeline run metrics and cross-run comparison").option("--project-root <path>", "Project root directory", projectRoot).option("--output-format <format>", "Output format: human (default) or json", "human").option("--limit <n>", "Number of runs to show (default: 10)", (v) => parseInt(v, 10), 10).option("--compare <run-id-a,run-id-b>", "Compare two runs side-by-side (comma-separated IDs, e.g. abc123,def456)").option("--tag-baseline <run-id>", "Mark a run as the performance baseline").option("--analysis <run-id>", "Read and output the analysis report for the specified run (AC5 of Story 17-3)").option("--sprint <sprint>", "Filter StateStore metrics by sprint (e.g. sprint-1)").option("--story <story-key>", "Filter StateStore metrics by story key (e.g. 26-1)").option("--task-type <type>", "Filter StateStore metrics by task type (e.g. dev-story)").option("--since <iso-date>", "Filter StateStore metrics at or after this ISO timestamp").option("--aggregate", "Aggregate StateStore metrics grouped by task_type").option("--efficiency", "Show telemetry efficiency scores for recent stories").option("--recommendations", "Show all telemetry recommendations across stories").option("--turns <storyKey>", "Show per-turn analysis for a specific story").option("--consumers <storyKey>", "Show consumer stats for a specific story").option("--categories", "Show category stats (optionally scoped by --story <storyKey>)").option("--compare-stories <storyA,storyB>", "Compare efficiency scores of two stories side-by-side (comma-separated keys)").action(async (opts) => {
 		const outputFormat = opts.outputFormat === "json" ? "json" : "human";
 		let compareIds;
 		if (opts.compare !== void 0) {
 			const parts = opts.compare.split(",").map((s) => s.trim());
 			if (parts.length === 2 && parts[0] && parts[1]) compareIds = [parts[0], parts[1]];
 		}
-		const exitCode = await runMetricsAction({
+		let compareStoriesIds;
+		if (opts.compareStories !== void 0) {
+			const parts = opts.compareStories.split(",").map((s) => s.trim());
+			if (parts.length === 2 && parts[0] && parts[1]) compareStoriesIds = [parts[0], parts[1]];
+			else {
+				process.stderr.write("Error: --compare-stories requires exactly two comma-separated story keys\n");
+				process.exitCode = 1;
+				return;
+			}
+		}
+		const metricsOpts = {
 			outputFormat,
 			projectRoot: opts.projectRoot,
 			limit: opts.limit,
-			compare: compareIds,
-			tagBaseline: opts.tagBaseline,
-			analysis: opts.analysis,
-			sprint: opts.sprint,
-			story: opts.story,
-			taskType: opts.taskType,
-			since: opts.since,
-			aggregate: opts.aggregate
-		});
+			...compareIds !== void 0 && { compare: compareIds },
+			...opts.tagBaseline !== void 0 && { tagBaseline: opts.tagBaseline },
+			...opts.analysis !== void 0 && { analysis: opts.analysis },
+			...opts.sprint !== void 0 && { sprint: opts.sprint },
+			...opts.story !== void 0 && { story: opts.story },
+			...opts.taskType !== void 0 && { taskType: opts.taskType },
+			...opts.since !== void 0 && { since: opts.since },
+			...opts.aggregate !== void 0 && { aggregate: opts.aggregate },
+			...opts.efficiency !== void 0 && { efficiency: opts.efficiency },
+			...opts.recommendations !== void 0 && { recommendations: opts.recommendations },
+			...opts.turns !== void 0 && { turns: opts.turns },
+			...opts.consumers !== void 0 && { consumers: opts.consumers },
+			...opts.categories !== void 0 && { categories: opts.categories },
+			...compareStoriesIds !== void 0 && { compareStories: compareStoriesIds }
+		};
+		const exitCode = await runMetricsAction(metricsOpts);
 		process.exitCode = exitCode;
 	});
 }
@@ -7226,8 +7456,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-CImByfkk.js").then(async () => {
-		const { createVersionManager } = await import("../version-manager-impl-aL5IemIm.js");
+	import("../upgrade-Ex1ukwsm.js").then(async () => {
+		const { createVersionManager } = await import("../version-manager-impl-Dk3S31y6.js");
 		const vm = createVersionManager();
 		const result = await vm.checkForUpdates();
 		if (result.updateAvailable) {

package/dist/{config-migrator-DSi8KhQC.js → config-migrator-CQmBdKeG.js}

@@ -79,6 +79,10 @@ const TokenCeilingsSchema = z.object({
 	"test-plan": z.number().int().positive("test-plan token ceiling must be a positive integer").optional(),
 	"test-expansion": z.number().int().positive("test-expansion token ceiling must be a positive integer").optional()
 });
+const TelemetryConfigSchema = z.object({
+	enabled: z.boolean().default(false),
+	port: z.number().int().min(1).max(65535).default(4318)
+}).strict();
 /** Current supported config format version */
 const CURRENT_CONFIG_FORMAT_VERSION = "1";
 /** Current supported task graph version */
@@ -94,7 +98,8 @@ const SubstrateConfigSchema = z.object({
 	providers: ProvidersSchema,
 	cost_tracker: CostTrackerConfigSchema.optional(),
 	budget: BudgetConfigSchema.optional(),
-	token_ceilings: TokenCeilingsSchema.optional()
+	token_ceilings: TokenCeilingsSchema.optional(),
+	telemetry: TelemetryConfigSchema.optional()
 }).strict();
 const PartialProviderConfigSchema = ProviderConfigSchema.partial();
 const PartialGlobalSettingsSchema = GlobalSettingsSchema.partial();
@@ -109,7 +114,8 @@ const PartialSubstrateConfigSchema = z.object({
 	}).partial().optional(),
 	cost_tracker: CostTrackerConfigSchema.partial().optional(),
 	budget: BudgetConfigSchema.partial().optional(),
-	token_ceilings: TokenCeilingsSchema.optional()
+	token_ceilings: TokenCeilingsSchema.optional(),
+	telemetry: TelemetryConfigSchema.partial().optional()
 }).strict();
 
 //#endregion
@@ -241,4 +247,4 @@ const defaultConfigMigrator = new ConfigMigrator();
 
 //#endregion
 export { CURRENT_CONFIG_FORMAT_VERSION, CURRENT_TASK_GRAPH_VERSION, PartialSubstrateConfigSchema, SUPPORTED_CONFIG_FORMAT_VERSIONS, SUPPORTED_TASK_GRAPH_VERSIONS, SubstrateConfigSchema, defaultConfigMigrator };
-//# sourceMappingURL=config-migrator-DSi8KhQC.js.map
+//# sourceMappingURL=config-migrator-CQmBdKeG.js.map

package/dist/index.d.ts

@@ -780,6 +780,10 @@ declare const SubstrateConfigSchema: z.ZodObject<{
     'test-plan': z.ZodOptional<z.ZodNumber>;
     'test-expansion': z.ZodOptional<z.ZodNumber>;
   }, z.core.$strip>>;
+  telemetry: z.ZodOptional<z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    port: z.ZodDefault<z.ZodNumber>;
+  }, z.core.$strict>>;
 }, z.core.$strict>;
 type SubstrateConfig = z.infer<typeof SubstrateConfigSchema>;
 
@@ -1412,6 +1416,13 @@ interface AdapterOptions {
   apiKey?: string;
   /** Optional maximum agentic turns (passed as --max-turns to Claude CLI) */
   maxTurns?: number;
+  /**
+   * Optional OTLP endpoint URL for telemetry export (Story 27-9).
+   * When set, injects the 5 OTLP env vars into the spawned process so that
+   * Claude Code exports telemetry to the local IngestionServer.
+   * Example: "http://localhost:4318"
+   */
+  otlpEndpoint?: string;
 }
 /**
  * Capabilities reported by an adapter for this CLI agent.

package/dist/index.js

@@ -1,5 +1,5 @@
 import { childLogger, createLogger, logger } from "./logger-D2fS2ccL.js";
-import { AdapterRegistry, ClaudeCodeAdapter, CodexCLIAdapter, GeminiCLIAdapter } from "./adapter-registry-PsWhP_1Q.js";
+import { AdapterRegistry, ClaudeCodeAdapter, CodexCLIAdapter, GeminiCLIAdapter } from "./adapter-registry-DHl0W-YB.js";
 import { AdtError, BudgetExceededError, ConfigError, ConfigIncompatibleFormatError, GitError, RecoveryError, TaskConfigError, TaskGraphCycleError, TaskGraphError, TaskGraphIncompatibleFormatError, WorkerError, WorkerNotFoundError, assertDefined, createEventBus, createTuiApp, deepClone, formatDuration, generateId, isPlainObject, isTuiCapable, printNonTtyWarning, sleep, withRetry } from "./helpers-RL22dYtn.js";
 
 //#region src/core/di.ts

package/dist/{run-D6WEx9l2.js → run-33J0SBp1.js}

@@ -1,6 +1,6 @@
-import { registerRunCommand, runRunAction } from "./run-DNURadtJ.js";
+import { registerRunCommand, runRunAction } from "./run-DI9s014E.js";
 import "./logger-D2fS2ccL.js";
-import "./config-migrator-DSi8KhQC.js";
+import "./config-migrator-CQmBdKeG.js";
 import "./helpers-RL22dYtn.js";
 import "./decisions-Dq4cAA2L.js";
 import "./operational-Bovj4fS-.js";