substrate-ai 0.3.3 → 0.3.6

package/dist/{run-DI9s014E.js → run-DzzmgEOd.js}

@@ -1,8 +1,8 @@
 import { createLogger, deepMask } from "./logger-D2fS2ccL.js";
-import { CURRENT_CONFIG_FORMAT_VERSION, PartialSubstrateConfigSchema, SUPPORTED_CONFIG_FORMAT_VERSIONS, SubstrateConfigSchema, defaultConfigMigrator } from "./config-migrator-CQmBdKeG.js";
-import { ConfigError, ConfigIncompatibleFormatError, createEventBus, createTuiApp, isTuiCapable, printNonTtyWarning, sleep } from "./helpers-RL22dYtn.js";
-import { addTokenUsage, createDecision, createPipelineRun, createRequirement, getArtifactByTypeForRun, getArtifactsByRun, getDecisionsByCategory, getDecisionsByPhase, getDecisionsByPhaseForRun, getLatestRun, getPipelineRunById, getRunningPipelineRuns, getTokenUsageSummary, registerArtifact, updatePipelineRun, updatePipelineRunConfig, upsertDecision } from "./decisions-Dq4cAA2L.js";
-import { ADVISORY_NOTES, ESCALATION_DIAGNOSIS, OPERATIONAL_FINDING, STORY_METRICS, STORY_OUTCOME, TEST_EXPANSION_FINDING, TEST_PLAN, aggregateTokenUsageForRun, aggregateTokenUsageForStory, getStoryMetricsForRun, writeRunMetrics, writeStoryMetrics } from "./operational-Bovj4fS-.js";
+import { CURRENT_CONFIG_FORMAT_VERSION, PartialSubstrateConfigSchema, SUPPORTED_CONFIG_FORMAT_VERSIONS, SubstrateConfigSchema, defaultConfigMigrator } from "./config-migrator-DtZW1maj.js";
+import { ConfigError, ConfigIncompatibleFormatError, createEventBus, createTuiApp, isTuiCapable, printNonTtyWarning, sleep } from "./helpers-BihqWgVe.js";
+import { addTokenUsage, createDecision, createPipelineRun, createRequirement, getArtifactByTypeForRun, getArtifactsByRun, getDecisionsByCategory, getDecisionsByPhase, getDecisionsByPhaseForRun, getLatestRun, getPipelineRunById, getRunningPipelineRuns, getTokenUsageSummary, registerArtifact, updatePipelineRun, updatePipelineRunConfig, upsertDecision } from "./decisions-CdpiJIm5.js";
+import { ADVISORY_NOTES, ESCALATION_DIAGNOSIS, OPERATIONAL_FINDING, STORY_METRICS, STORY_OUTCOME, TEST_EXPANSION_FINDING, TEST_PLAN, aggregateTokenUsageForRun, aggregateTokenUsageForStory, getStoryMetricsForRun, writeRunMetrics, writeStoryMetrics } from "./operational-DisxqtjC.js";
 import { createRequire } from "module";
 import { dirname, join, resolve } from "path";
 import { access, mkdir, readFile, readdir, stat, writeFile } from "fs/promises";
@@ -17,6 +17,7 @@ import { access as access$1, mkdir as mkdir$1, readFile as readFile$1, stat as s
 import { fileURLToPath } from "node:url";
 import { existsSync as existsSync$1, readFileSync as readFileSync$1, readdirSync as readdirSync$1 } from "node:fs";
 import { homedir } from "os";
+import { EventEmitter } from "node:events";
 import { freemem, platform } from "node:os";
 import { createHash, randomUUID } from "node:crypto";
 import { createServer } from "node:http";
@@ -604,9 +605,110 @@ const migration010RunMetrics = {
 	}
 };
 
+//#endregion
+//#region src/persistence/migrations/011-telemetry-schema.ts
+const migration011TelemetrySchema = {
+	version: 11,
+	name: "telemetry-schema",
+	up(db) {
+		db.exec(`
+      CREATE TABLE IF NOT EXISTS turn_analysis (
+        story_key         VARCHAR(64)    NOT NULL,
+        span_id           VARCHAR(128)   NOT NULL,
+        turn_number       INTEGER        NOT NULL,
+        name              VARCHAR(255)   NOT NULL DEFAULT '',
+        timestamp         BIGINT         NOT NULL DEFAULT 0,
+        source            VARCHAR(32)    NOT NULL DEFAULT '',
+        model             VARCHAR(64),
+        input_tokens      INTEGER        NOT NULL DEFAULT 0,
+        output_tokens     INTEGER        NOT NULL DEFAULT 0,
+        cache_read_tokens INTEGER        NOT NULL DEFAULT 0,
+        fresh_tokens      INTEGER        NOT NULL DEFAULT 0,
+        cache_hit_rate    DOUBLE         NOT NULL DEFAULT 0,
+        cost_usd          DOUBLE         NOT NULL DEFAULT 0,
+        duration_ms       INTEGER        NOT NULL DEFAULT 0,
+        context_size      INTEGER        NOT NULL DEFAULT 0,
+        context_delta     INTEGER        NOT NULL DEFAULT 0,
+        tool_name         VARCHAR(128),
+        is_context_spike  BOOLEAN        NOT NULL DEFAULT 0,
+        child_spans_json  TEXT           NOT NULL DEFAULT '[]',
+        PRIMARY KEY (story_key, span_id)
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_turn_analysis_story
+        ON turn_analysis (story_key, turn_number);
+
+      CREATE TABLE IF NOT EXISTS efficiency_scores (
+        story_key                     VARCHAR(64)  NOT NULL,
+        timestamp                     BIGINT       NOT NULL,
+        composite_score               INTEGER      NOT NULL DEFAULT 0,
+        cache_hit_sub_score           DOUBLE       NOT NULL DEFAULT 0,
+        io_ratio_sub_score            DOUBLE       NOT NULL DEFAULT 0,
+        context_management_sub_score  DOUBLE       NOT NULL DEFAULT 0,
+        avg_cache_hit_rate            DOUBLE       NOT NULL DEFAULT 0,
+        avg_io_ratio                  DOUBLE       NOT NULL DEFAULT 0,
+        context_spike_count           INTEGER      NOT NULL DEFAULT 0,
+        total_turns                   INTEGER      NOT NULL DEFAULT 0,
+        per_model_json                TEXT         NOT NULL DEFAULT '[]',
+        per_source_json               TEXT         NOT NULL DEFAULT '[]',
+        PRIMARY KEY (story_key, timestamp)
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_efficiency_story
+        ON efficiency_scores (story_key, timestamp DESC);
+
+      CREATE TABLE IF NOT EXISTS recommendations (
+        id                       VARCHAR(16)   NOT NULL,
+        story_key                VARCHAR(64)   NOT NULL,
+        sprint_id                VARCHAR(64),
+        rule_id                  VARCHAR(64)   NOT NULL,
+        severity                 VARCHAR(16)   NOT NULL,
+        title                    TEXT          NOT NULL,
+        description              TEXT          NOT NULL,
+        potential_savings_tokens INTEGER,
+        potential_savings_usd    DOUBLE,
+        action_target            TEXT,
+        generated_at             VARCHAR(32)   NOT NULL,
+        PRIMARY KEY (id)
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_recommendations_story
+        ON recommendations (story_key, severity);
+
+      CREATE TABLE IF NOT EXISTS category_stats (
+        story_key            VARCHAR(100)   NOT NULL,
+        category             VARCHAR(30)    NOT NULL,
+        total_tokens         BIGINT         NOT NULL DEFAULT 0,
+        percentage           DECIMAL(6,3)   NOT NULL DEFAULT 0,
+        event_count          INTEGER        NOT NULL DEFAULT 0,
+        avg_tokens_per_event DECIMAL(12,2)  NOT NULL DEFAULT 0,
+        trend                VARCHAR(10)    NOT NULL DEFAULT 'stable',
+        PRIMARY KEY (story_key, category)
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_category_stats_story
+        ON category_stats (story_key, total_tokens);
+
+      CREATE TABLE IF NOT EXISTS consumer_stats (
+        story_key            VARCHAR(100)   NOT NULL,
+        consumer_key         VARCHAR(300)   NOT NULL,
+        category             VARCHAR(30)    NOT NULL,
+        total_tokens         BIGINT         NOT NULL DEFAULT 0,
+        percentage           DECIMAL(6,3)   NOT NULL DEFAULT 0,
+        event_count          INTEGER        NOT NULL DEFAULT 0,
+        top_invocations_json TEXT,
+        PRIMARY KEY (story_key, consumer_key)
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_consumer_stats_story
+        ON consumer_stats (story_key, total_tokens);
+    `);
+	}
+};
+
 //#endregion
 //#region src/persistence/migrations/index.ts
-const logger$25 = createLogger("persistence:migrations");
+const logger$26 = createLogger("persistence:migrations");
 const MIGRATIONS = [
 	initialSchemaMigration,
 	costTrackerSchemaMigration,
@@ -617,14 +719,15 @@ const MIGRATIONS = [
 	migration007DecisionStore,
 	migration008AmendmentSchema,
 	migration009TokenUsageMetadata,
-	migration010RunMetrics
+	migration010RunMetrics,
+	migration011TelemetrySchema
 ];
 /**
 * Ensure `schema_migrations` table exists and run any pending migrations.
 * Safe to call multiple times — already-applied migrations are skipped.
 */
 function runMigrations(db) {
-	logger$25.info("Starting migration runner");
+	logger$26.info("Starting migration runner");
 	db.exec(`
     CREATE TABLE IF NOT EXISTS schema_migrations (
       version   INTEGER PRIMARY KEY,
@@ -635,12 +738,12 @@ function runMigrations(db) {
 	const appliedVersions = new Set(db.prepare("SELECT version FROM schema_migrations").all().map((row) => row.version));
 	const pending = MIGRATIONS.filter((m) => !appliedVersions.has(m.version)).sort((a, b) => a.version - b.version);
 	if (pending.length === 0) {
-		logger$25.info("No pending migrations");
+		logger$26.info("No pending migrations");
 		return;
 	}
 	const insertMigration = db.prepare("INSERT INTO schema_migrations (version, name) VALUES (?, ?)");
 	for (const migration of pending) {
-		logger$25.info({
+		logger$26.info({
 			version: migration.version,
 			name: migration.name
 		}, "Applying migration");
@@ -654,14 +757,14 @@ function runMigrations(db) {
 			});
 			applyMigration();
 		}
-		logger$25.info({ version: migration.version }, "Migration applied successfully");
+		logger$26.info({ version: migration.version }, "Migration applied successfully");
 	}
-	logger$25.info({ count: pending.length }, "All pending migrations applied");
+	logger$26.info({ count: pending.length }, "All pending migrations applied");
 }
 
 //#endregion
 //#region src/persistence/database.ts
-const logger$24 = createLogger("persistence:database");
+const logger$25 = createLogger("persistence:database");
 /**
 * Thin wrapper that opens a SQLite database, applies required PRAGMAs,
 * and exposes the raw BetterSqlite3 instance.
@@ -678,14 +781,14 @@ var DatabaseWrapper = class {
 	*/
 	open() {
 		if (this._db !== null) return;
-		logger$24.info({ path: this._path }, "Opening SQLite database");
+		logger$25.info({ path: this._path }, "Opening SQLite database");
 		this._db = new Database(this._path);
 		const walResult = this._db.pragma("journal_mode = WAL");
-		if (walResult?.[0]?.journal_mode !== "wal") logger$24.warn({ result: walResult?.[0]?.journal_mode }, "WAL pragma did not return expected \"wal\" — journal_mode may be \"memory\" or unsupported");
+		if (walResult?.[0]?.journal_mode !== "wal") logger$25.warn({ result: walResult?.[0]?.journal_mode }, "WAL pragma did not return expected \"wal\" — journal_mode may be \"memory\" or unsupported");
 		this._db.pragma("busy_timeout = 5000");
 		this._db.pragma("synchronous = NORMAL");
 		this._db.pragma("foreign_keys = ON");
-		logger$24.info({ path: this._path }, "SQLite database opened with WAL mode");
+		logger$25.info({ path: this._path }, "SQLite database opened with WAL mode");
 	}
 	/**
 	* Close the database. Idempotent — calling close() when already closed is a no-op.
@@ -694,7 +797,7 @@ var DatabaseWrapper = class {
 		if (this._db === null) return;
 		this._db.close();
 		this._db = null;
-		logger$24.info({ path: this._path }, "SQLite database closed");
+		logger$25.info({ path: this._path }, "SQLite database closed");
 	}
 	/**
 	* Return the raw BetterSqlite3 instance.
@@ -1611,7 +1714,7 @@ function formatUnsupportedVersionError(formatType, version, supported) {
 
 //#endregion
 //#region src/modules/config/config-system-impl.ts
-const logger$23 = createLogger("config");
+const logger$24 = createLogger("config");
 function deepMerge(base, override) {
 	const result = { ...base };
 	for (const [key, val] of Object.entries(override)) if (val !== null && val !== void 0 && typeof val === "object" && !Array.isArray(val) && typeof result[key] === "object" && result[key] !== null && !Array.isArray(result[key])) result[key] = deepMerge(result[key], val);
@@ -1656,7 +1759,7 @@ function readEnvOverrides() {
 	}
 	const parsed = PartialSubstrateConfigSchema.safeParse(overrides);
 	if (!parsed.success) {
-		logger$23.warn({ errors: parsed.error.issues }, "Invalid environment variable overrides ignored");
+		logger$24.warn({ errors: parsed.error.issues }, "Invalid environment variable overrides ignored");
 		return {};
 	}
 	return parsed.data;
@@ -1720,7 +1823,7 @@ var ConfigSystemImpl = class {
 			throw new ConfigError(`Configuration validation failed:\n${issues}`, { issues: result.error.issues });
 		}
 		this._config = result.data;
-		logger$23.debug("Configuration loaded successfully");
+		logger$24.debug("Configuration loaded successfully");
 	}
 	getConfig() {
 		if (this._config === null) throw new ConfigError("Configuration has not been loaded. Call load() before getConfig().", {});
@@ -1783,7 +1886,7 @@ var ConfigSystemImpl = class {
 				if (version !== void 0 && typeof version === "string" && !isVersionSupported(version, SUPPORTED_CONFIG_FORMAT_VERSIONS)) if (defaultConfigMigrator.canMigrate(version, CURRENT_CONFIG_FORMAT_VERSION)) {
 					const migrationOutput = defaultConfigMigrator.migrate(rawObj, version, CURRENT_CONFIG_FORMAT_VERSION, filePath);
 					if (migrationOutput.result.success) {
-						logger$23.info({
+						logger$24.info({
 							from: version,
 							to: CURRENT_CONFIG_FORMAT_VERSION,
 							backup: migrationOutput.result.backupPath
@@ -2863,6 +2966,38 @@ const PIPELINE_EVENT_METADATA = [
 				description: "Mismatch details (missing file, type error)."
 			}
 		]
+	},
+	{
+		type: "pipeline:contract-verification-summary",
+		description: "Contract verification summary. Consolidates pass/fail into a single event.",
+		when: "After all stories complete, before pipeline:complete. Emitted once per verification pass.",
+		fields: [
+			{
+				name: "ts",
+				type: "string",
+				description: "Timestamp."
+			},
+			{
+				name: "verified",
+				type: "number",
+				description: "Declarations verified (current sprint)."
+			},
+			{
+				name: "stalePruned",
+				type: "number",
+				description: "Stale declarations pruned (previous epics)."
+			},
+			{
+				name: "mismatches",
+				type: "number",
+				description: "Real mismatches found."
+			},
+			{
+				name: "verdict",
+				type: "pass|fail",
+				description: "Overall verification result."
+			}
+		]
 	}
 ];
 /**
@@ -3192,7 +3327,7 @@ function truncateToTokens(text, maxTokens) {
 
 //#endregion
 //#region src/modules/context-compiler/context-compiler-impl.ts
-const logger$22 = createLogger("context-compiler");
+const logger$23 = createLogger("context-compiler");
 /**
 * Fraction of the original token budget that must remain (after required +
 * important sections) before an optional section is included.
@@ -3284,7 +3419,7 @@ var ContextCompilerImpl = class {
 				includedParts.push(truncated);
 				remainingBudget -= truncatedTokens;
 				anyTruncated = true;
-				logger$22.warn({
+				logger$23.warn({
 					section: section.name,
 					originalTokens: tokens,
 					budgetTokens: truncatedTokens
@@ -3298,7 +3433,7 @@ var ContextCompilerImpl = class {
 				});
 			} else {
 				anyTruncated = true;
-				logger$22.warn({
+				logger$23.warn({
 					section: section.name,
 					tokens
 				}, "Context compiler: omitted \"important\" section — no budget remaining");
@@ -3325,7 +3460,7 @@ var ContextCompilerImpl = class {
 				} else {
 					if (tokens > 0) {
 						anyTruncated = true;
-						logger$22.warn({
+						logger$23.warn({
 							section: section.name,
 							tokens,
 							budgetFractionRemaining: budgetFractionRemaining.toFixed(2)
@@ -3610,7 +3745,7 @@ function parseYamlResult(yamlText, schema) {
 
 //#endregion
 //#region src/modules/agent-dispatch/dispatcher-impl.ts
-const logger$21 = createLogger("agent-dispatch");
+const logger$22 = createLogger("agent-dispatch");
 const SHUTDOWN_GRACE_MS = 1e4;
 const SHUTDOWN_MAX_WAIT_MS = 3e4;
 const CHARS_PER_TOKEN = 4;
@@ -3655,7 +3790,7 @@ function getAvailableMemory() {
 			}).trim(), 10);
 			_lastKnownPressureLevel = pressureLevel;
 			if (pressureLevel >= 4) {
-				logger$21.warn({ pressureLevel }, "macOS kernel reports critical memory pressure");
+				logger$22.warn({ pressureLevel }, "macOS kernel reports critical memory pressure");
 				return 0;
 			}
 		} catch {}
@@ -3670,7 +3805,7 @@ function getAvailableMemory() {
 			const speculative = parseInt(vmstat.match(/Pages speculative:\s+(\d+)/)?.[1] ?? "0", 10);
 			const available = (free + purgeable + speculative) * pageSize;
 			if (pressureLevel >= 2) {
-				logger$21.warn({
+				logger$22.warn({
 					pressureLevel,
 					availableBeforeDiscount: available
 				}, "macOS kernel reports memory pressure — discounting estimate");
@@ -3750,7 +3885,7 @@ var DispatcherImpl = class {
 					resolve: typedResolve,
 					reject
 				});
-				logger$21.debug({
+				logger$22.debug({
 					id,
 					queueLength: this._queue.length
 				}, "Dispatch queued");
@@ -3781,7 +3916,7 @@ var DispatcherImpl = class {
 	async shutdown() {
 		this._shuttingDown = true;
 		this._stopMemoryPressureTimer();
-		logger$21.info({
+		logger$22.info({
 			running: this._running.size,
 			queued: this._queue.length
 		}, "Dispatcher shutting down");
@@ -3814,13 +3949,13 @@ var DispatcherImpl = class {
 				}
 			}, 50);
 		});
-		logger$21.info("Dispatcher shutdown complete");
+		logger$22.info("Dispatcher shutdown complete");
 	}
 	async _startDispatch(id, request, resolve$2) {
-		const { prompt, agent, taskType, timeout, outputSchema, workingDirectory, model, maxTurns, otlpEndpoint } = request;
+		const { prompt, agent, taskType, timeout, outputSchema, workingDirectory, model, maxTurns, otlpEndpoint, storyKey } = request;
 		const adapter = this._adapterRegistry.get(agent);
 		if (adapter === void 0) {
-			logger$21.warn({
+			logger$22.warn({
 				id,
 				agent
 			}, "No adapter found for agent");
@@ -3848,7 +3983,8 @@ var DispatcherImpl = class {
 			billingMode: "subscription",
 			...model !== void 0 ? { model } : {},
 			...resolvedMaxTurns !== void 0 ? { maxTurns: resolvedMaxTurns } : {},
-			...otlpEndpoint !== void 0 ? { otlpEndpoint } : {}
+			...otlpEndpoint !== void 0 ? { otlpEndpoint } : {},
+			...storyKey !== void 0 ? { storyKey } : {}
 		});
 		const timeoutMs = timeout ?? this._config.defaultTimeouts[taskType] ?? DEFAULT_TIMEOUTS[taskType] ?? 3e5;
 		const env = { ...process.env };
@@ -3867,7 +4003,7 @@ var DispatcherImpl = class {
 		});
 		const startedAt = Date.now();
 		proc.on("error", (err) => {
-			logger$21.error({
+			logger$22.error({
 				id,
 				binary: cmd.binary,
 				error: err.message
@@ -3875,7 +4011,7 @@ var DispatcherImpl = class {
 		});
 		if (proc.stdin !== null) {
 			proc.stdin.on("error", (err) => {
-				if (err.code !== "EPIPE") logger$21.warn({
+				if (err.code !== "EPIPE") logger$22.warn({
 					id,
 					error: err.message
 				}, "stdin write error");
@@ -3917,7 +4053,7 @@ var DispatcherImpl = class {
 			agent,
 			taskType
 		});
-		logger$21.debug({
+		logger$22.debug({
 			id,
 			agent,
 			taskType,
@@ -3934,7 +4070,7 @@ var DispatcherImpl = class {
 				dispatchId: id,
 				timeoutMs
 			});
-			logger$21.warn({
+			logger$22.warn({
 				id,
 				agent,
 				taskType,
@@ -3988,7 +4124,7 @@ var DispatcherImpl = class {
 					exitCode: code,
 					output: stdout
 				});
-				logger$21.debug({
+				logger$22.debug({
 					id,
 					agent,
 					taskType,
@@ -4014,7 +4150,7 @@ var DispatcherImpl = class {
 					error: stderr || `Process exited with code ${String(code)}`,
 					exitCode: code
 				});
-				logger$21.debug({
+				logger$22.debug({
 					id,
 					agent,
 					taskType,
@@ -4073,7 +4209,7 @@ var DispatcherImpl = class {
 		const next = this._queue.shift();
 		if (next === void 0) return;
 		next.handle.status = "running";
-		logger$21.debug({
+		logger$22.debug({
 			id: next.id,
 			queueLength: this._queue.length
 		}, "Dequeued dispatch");
@@ -4086,7 +4222,7 @@ var DispatcherImpl = class {
 	_isMemoryPressured() {
 		const free = getAvailableMemory();
 		if (free < MIN_FREE_MEMORY_BYTES) {
-			logger$21.warn({
+			logger$22.warn({
 				freeMB: Math.round(free / 1024 / 1024),
 				thresholdMB: Math.round(MIN_FREE_MEMORY_BYTES / 1024 / 1024),
 				pressureLevel: _lastKnownPressureLevel
@@ -4202,7 +4338,7 @@ function runBuildVerification(options) {
 	let cmd;
 	if (verifyCommand === void 0) {
 		const detection = detectPackageManager(projectRoot);
-		logger$21.info({
+		logger$22.info({
 			packageManager: detection.packageManager,
 			lockfile: detection.lockfile,
 			resolvedCommand: detection.command
@@ -4401,7 +4537,7 @@ function pickRecommendation(distribution, profile, totalIssues, reviewCycles, la
 
 //#endregion
 //#region src/modules/compiled-workflows/prompt-assembler.ts
-const logger$20 = createLogger("compiled-workflows:prompt-assembler");
+const logger$21 = createLogger("compiled-workflows:prompt-assembler");
 /**
 * Assemble a final prompt from a template and sections map.
 *
@@ -4426,7 +4562,7 @@ function assemblePrompt(template, sections, tokenCeiling = 2200) {
 		tokenCount,
 		truncated: false
 	};
-	logger$20.warn({
+	logger$21.warn({
 		tokenCount,
 		ceiling: tokenCeiling
 	}, "Prompt exceeds token ceiling — truncating optional sections");
@@ -4442,10 +4578,10 @@ function assemblePrompt(template, sections, tokenCeiling = 2200) {
 			const targetSectionTokens = Math.max(0, currentSectionTokens - overBy);
 			if (targetSectionTokens === 0) {
 				contentMap[section.name] = "";
-				logger$20.warn({ sectionName: section.name }, "Section eliminated to fit token budget");
+				logger$21.warn({ sectionName: section.name }, "Section eliminated to fit token budget");
 			} else {
 				contentMap[section.name] = truncateToTokens(section.content, targetSectionTokens);
-				logger$20.warn({
+				logger$21.warn({
 					sectionName: section.name,
 					targetSectionTokens
 				}, "Section truncated to fit token budget");
@@ -4456,7 +4592,7 @@ function assemblePrompt(template, sections, tokenCeiling = 2200) {
 		}
 		if (tokenCount <= tokenCeiling) break;
 	}
-	if (tokenCount > tokenCeiling) logger$20.warn({
+	if (tokenCount > tokenCeiling) logger$21.warn({
 		tokenCount,
 		ceiling: tokenCeiling
 	}, "Required sections alone exceed token ceiling — returning over-budget prompt");
@@ -4754,7 +4890,7 @@ function getTokenCeiling(workflowType, tokenCeilings) {
 
 //#endregion
 //#region src/modules/compiled-workflows/create-story.ts
-const logger$19 = createLogger("compiled-workflows:create-story");
+const logger$20 = createLogger("compiled-workflows:create-story");
 /**
 * Execute the compiled create-story workflow.
 *
@@ -4774,13 +4910,13 @@ const logger$19 = createLogger("compiled-workflows:create-story");
 */
 async function runCreateStory(deps, params) {
 	const { epicId, storyKey, pipelineRunId } = params;
-	logger$19.debug({
+	logger$20.debug({
 		epicId,
 		storyKey,
 		pipelineRunId
 	}, "Starting create-story workflow");
 	const { ceiling: TOKEN_CEILING, source: tokenCeilingSource } = getTokenCeiling("create-story", deps.tokenCeilings);
-	logger$19.info({
+	logger$20.info({
 		workflow: "create-story",
 		ceiling: TOKEN_CEILING,
 		source: tokenCeilingSource
@@ -4790,7 +4926,7 @@ async function runCreateStory(deps, params) {
 		template = await deps.pack.getPrompt("create-story");
 	} catch (err) {
 		const error = err instanceof Error ? err.message : String(err);
-		logger$19.error({ error }, "Failed to retrieve create-story prompt template");
+		logger$20.error({ error }, "Failed to retrieve create-story prompt template");
 		return {
 			result: "failed",
 			error: `Failed to retrieve prompt template: ${error}`,
@@ -4832,7 +4968,7 @@ async function runCreateStory(deps, params) {
 			priority: "important"
 		}
 	], TOKEN_CEILING);
-	logger$19.debug({
+	logger$20.debug({
 		tokenCount,
 		truncated,
 		tokenCeiling: TOKEN_CEILING
@@ -4843,14 +4979,15 @@ async function runCreateStory(deps, params) {
 		taskType: "create-story",
 		outputSchema: CreateStoryResultSchema,
 		...deps.projectRoot !== void 0 ? { workingDirectory: deps.projectRoot } : {},
-		...deps.otlpEndpoint !== void 0 ? { otlpEndpoint: deps.otlpEndpoint } : {}
+		...deps.otlpEndpoint !== void 0 ? { otlpEndpoint: deps.otlpEndpoint } : {},
+		storyKey
 	});
 	let dispatchResult;
 	try {
 		dispatchResult = await handle.result;
 	} catch (err) {
 		const error = err instanceof Error ? err.message : String(err);
-		logger$19.error({
+		logger$20.error({
 			epicId,
 			storyKey,
 			error
@@ -4871,7 +5008,7 @@ async function runCreateStory(deps, params) {
 	if (dispatchResult.status === "failed") {
 		const errorMsg = dispatchResult.parseError ?? `Dispatch failed with exit code ${dispatchResult.exitCode}`;
 		const stderrDetail = dispatchResult.output ? ` Output: ${dispatchResult.output}` : "";
-		logger$19.warn({
+		logger$20.warn({
 			epicId,
 			storyKey,
 			exitCode: dispatchResult.exitCode
@@ -4883,7 +5020,7 @@ async function runCreateStory(deps, params) {
 		};
 	}
 	if (dispatchResult.status === "timeout") {
-		logger$19.warn({
+		logger$20.warn({
 			epicId,
 			storyKey
 		}, "Create-story dispatch timed out");
@@ -4896,7 +5033,7 @@ async function runCreateStory(deps, params) {
 	if (dispatchResult.parsed === null) {
 		const details = dispatchResult.parseError ?? "No YAML block found in output";
 		const rawSnippet = dispatchResult.output ? dispatchResult.output.slice(0, 1e3) : "(empty)";
-		logger$19.warn({
+		logger$20.warn({
 			epicId,
 			storyKey,
 			details,
@@ -4912,7 +5049,7 @@ async function runCreateStory(deps, params) {
 	const parseResult = CreateStoryResultSchema.safeParse(dispatchResult.parsed);
 	if (!parseResult.success) {
 		const details = parseResult.error.message;
-		logger$19.warn({
+		logger$20.warn({
 			epicId,
 			storyKey,
 			details
@@ -4925,7 +5062,7 @@ async function runCreateStory(deps, params) {
 		};
 	}
 	const parsed = parseResult.data;
-	logger$19.info({
+	logger$20.info({
 		epicId,
 		storyKey,
 		storyFile: parsed.story_file,
@@ -4947,7 +5084,7 @@ function getImplementationDecisions(deps) {
 	try {
 		return getDecisionsByPhase(deps.db, "implementation");
 	} catch (err) {
-		logger$19.warn({ error: err instanceof Error ? err.message : String(err) }, "Failed to retrieve implementation decisions");
+		logger$20.warn({ error: err instanceof Error ? err.message : String(err) }, "Failed to retrieve implementation decisions");
 		return [];
 	}
 }
@@ -4990,13 +5127,13 @@ function getEpicShard(decisions, epicId, projectRoot, storyKey) {
 			if (storyKey) {
 				const storySection = extractStorySection(shardContent, storyKey);
 				if (storySection) {
-					logger$19.debug({
+					logger$20.debug({
 						epicId,
 						storyKey
 					}, "Extracted per-story section from epic shard");
 					return storySection;
 				}
-				logger$19.debug({
+				logger$20.debug({
 					epicId,
 					storyKey
 				}, "No matching story section found — using full epic shard");
@@ -5006,11 +5143,11 @@ function getEpicShard(decisions, epicId, projectRoot, storyKey) {
 		if (projectRoot) {
 			const fallback = readEpicShardFromFile(projectRoot, epicId);
 			if (fallback) {
-				logger$19.info({ epicId }, "Using file-based fallback for epic shard (decisions table empty)");
+				logger$20.info({ epicId }, "Using file-based fallback for epic shard (decisions table empty)");
 				if (storyKey) {
 					const storySection = extractStorySection(fallback, storyKey);
 					if (storySection) {
-						logger$19.debug({
+						logger$20.debug({
 							epicId,
 							storyKey
 						}, "Extracted per-story section from file-based epic shard");
@@ -5022,7 +5159,7 @@ function getEpicShard(decisions, epicId, projectRoot, storyKey) {
 		}
 		return "";
 	} catch (err) {
-		logger$19.warn({
+		logger$20.warn({
 			epicId,
 			error: err instanceof Error ? err.message : String(err)
 		}, "Failed to retrieve epic shard");
@@ -5039,7 +5176,7 @@ function getPrevDevNotes(decisions, epicId) {
 		if (devNotes.length === 0) return "";
 		return devNotes[devNotes.length - 1].value;
 	} catch (err) {
-		logger$19.warn({
+		logger$20.warn({
 			epicId,
 			error: err instanceof Error ? err.message : String(err)
 		}, "Failed to retrieve prev dev notes");
@@ -5059,13 +5196,13 @@ function getArchConstraints$3(deps) {
 		if (deps.projectRoot) {
 			const fallback = readArchConstraintsFromFile(deps.projectRoot);
 			if (fallback) {
-				logger$19.info("Using file-based fallback for architecture constraints (decisions table empty)");
+				logger$20.info("Using file-based fallback for architecture constraints (decisions table empty)");
 				return fallback;
 			}
 		}
 		return "";
 	} catch (err) {
-		logger$19.warn({ error: err instanceof Error ? err.message : String(err) }, "Failed to retrieve architecture constraints");
+		logger$20.warn({ error: err instanceof Error ? err.message : String(err) }, "Failed to retrieve architecture constraints");
 		return "";
 	}
 }
@@ -5085,7 +5222,7 @@ function readEpicShardFromFile(projectRoot, epicId) {
 		const match = pattern.exec(content);
 		return match ? match[0].trim() : "";
 	} catch (err) {
-		logger$19.warn({
+		logger$20.warn({
 			epicId,
 			error: err instanceof Error ? err.message : String(err)
 		}, "File-based epic shard fallback failed");
@@ -5108,7 +5245,7 @@ function readArchConstraintsFromFile(projectRoot) {
 		const content = readFileSync$1(archPath, "utf-8");
 		return content.slice(0, 1500);
 	} catch (err) {
-		logger$19.warn({ error: err instanceof Error ? err.message : String(err) }, "File-based architecture fallback failed");
+		logger$20.warn({ error: err instanceof Error ? err.message : String(err) }, "File-based architecture fallback failed");
 		return "";
 	}
 }
@@ -5121,7 +5258,7 @@ async function getStoryTemplate(deps) {
 	try {
 		return await deps.pack.getTemplate("story");
 	} catch (err) {
-		logger$19.warn({ error: err instanceof Error ? err.message : String(err) }, "Failed to retrieve story template from pack");
+		logger$20.warn({ error: err instanceof Error ? err.message : String(err) }, "Failed to retrieve story template from pack");
 		return "";
 	}
 }
@@ -5158,7 +5295,7 @@ async function isValidStoryFile(filePath) {
 
 //#endregion
 //#region src/modules/compiled-workflows/git-helpers.ts
-const logger$18 = createLogger("compiled-workflows:git-helpers");
+const logger$19 = createLogger("compiled-workflows:git-helpers");
 /**
 * Capture the full git diff for HEAD (working tree vs current commit).
 *
@@ -5254,7 +5391,7 @@ async function stageIntentToAdd(files, workingDirectory) {
 	if (files.length === 0) return;
 	const existing = files.filter((f) => {
 		const exists = existsSync$1(f);
-		if (!exists) logger$18.debug({ file: f }, "Skipping nonexistent file in stageIntentToAdd");
+		if (!exists) logger$19.debug({ file: f }, "Skipping nonexistent file in stageIntentToAdd");
 		return exists;
 	});
 	if (existing.length === 0) return;
@@ -5288,7 +5425,7 @@ async function runGitCommand(args, cwd, logLabel) {
 			stderr += chunk.toString("utf-8");
 		});
 		proc.on("error", (err) => {
-			logger$18.warn({
+			logger$19.warn({
 				label: logLabel,
 				cwd,
 				error: err.message
@@ -5297,7 +5434,7 @@ async function runGitCommand(args, cwd, logLabel) {
 		});
 		proc.on("close", (code) => {
 			if (code !== 0) {
-				logger$18.warn({
+				logger$19.warn({
 					label: logLabel,
 					cwd,
 					code,
@@ -5313,7 +5450,7 @@ async function runGitCommand(args, cwd, logLabel) {
 
 //#endregion
 //#region src/modules/implementation-orchestrator/project-findings.ts
-const logger$17 = createLogger("project-findings");
+const logger$18 = createLogger("project-findings");
 /** Maximum character length for the findings summary */
 const MAX_CHARS = 2e3;
 /**
@@ -5379,7 +5516,7 @@ function getProjectFindings(db) {
 		if (summary.length > MAX_CHARS) summary = summary.slice(0, MAX_CHARS - 3) + "...";
 		return summary;
 	} catch (err) {
-		logger$17.warn({ err }, "Failed to query project findings (graceful fallback)");
+		logger$18.warn({ err }, "Failed to query project findings (graceful fallback)");
 		return "";
 	}
 }
@@ -5402,7 +5539,7 @@ function extractRecurringPatterns(outcomes) {
 
 //#endregion
 //#region src/modules/compiled-workflows/story-complexity.ts
-const logger$16 = createLogger("compiled-workflows:story-complexity");
+const logger$17 = createLogger("compiled-workflows:story-complexity");
 /**
 * Compute a complexity score from story markdown content.
 *
@@ -5454,7 +5591,7 @@ function resolveFixStoryMaxTurns(complexityScore) {
 * @param resolvedMaxTurns - Turn limit resolved for this dispatch
 */
 function logComplexityResult(storyKey, complexity, resolvedMaxTurns) {
-	logger$16.info({
+	logger$17.info({
 		storyKey,
 		taskCount: complexity.taskCount,
 		subtaskCount: complexity.subtaskCount,
@@ -5512,7 +5649,7 @@ function countFilesInLayout(content) {
 
 //#endregion
 //#region src/modules/compiled-workflows/dev-story.ts
-const logger$15 = createLogger("compiled-workflows:dev-story");
+const logger$16 = createLogger("compiled-workflows:dev-story");
 /** Default timeout for dev-story dispatches in milliseconds (30 min) */
 const DEFAULT_TIMEOUT_MS$1 = 18e5;
 /** Default Vitest test patterns injected when no test-pattern decisions exist */
@@ -5535,12 +5672,12 @@ const DEFAULT_VITEST_PATTERNS = `## Test Patterns (defaults)
 */
 async function runDevStory(deps, params) {
 	const { storyKey, storyFilePath, taskScope, priorFiles } = params;
-	logger$15.info({
+	logger$16.info({
 		storyKey,
 		storyFilePath
 	}, "Starting compiled dev-story workflow");
 	const { ceiling: TOKEN_CEILING, source: tokenCeilingSource } = getTokenCeiling("dev-story", deps.tokenCeilings);
-	logger$15.info({
+	logger$16.info({
 		workflow: "dev-story",
 		ceiling: TOKEN_CEILING,
 		source: tokenCeilingSource
@@ -5583,10 +5720,10 @@ async function runDevStory(deps, params) {
 	let template;
 	try {
 		template = await deps.pack.getPrompt("dev-story");
-		logger$15.debug({ storyKey }, "Retrieved dev-story prompt template from pack");
+		logger$16.debug({ storyKey }, "Retrieved dev-story prompt template from pack");
 	} catch (err) {
 		const error = err instanceof Error ? err.message : String(err);
-		logger$15.error({
+		logger$16.error({
 			storyKey,
 			error
 		}, "Failed to retrieve dev-story prompt template");
@@ -5597,14 +5734,14 @@ async function runDevStory(deps, params) {
 		storyContent = await readFile$1(storyFilePath, "utf-8");
 	} catch (err) {
 		if (err.code === "ENOENT") {
-			logger$15.error({
+			logger$16.error({
 				storyKey,
 				storyFilePath
 			}, "Story file not found");
 			return makeFailureResult("story_file_not_found");
 		}
 		const error = err instanceof Error ? err.message : String(err);
-		logger$15.error({
+		logger$16.error({
 			storyKey,
 			storyFilePath,
 			error
@@ -5612,7 +5749,7 @@ async function runDevStory(deps, params) {
 		return makeFailureResult(`story_file_read_error: ${error}`);
 	}
 	if (storyContent.trim().length === 0) {
-		logger$15.error({
+		logger$16.error({
 			storyKey,
 			storyFilePath
 		}, "Story file is empty");
@@ -5627,17 +5764,17 @@ async function runDevStory(deps, params) {
 		const testPatternDecisions = solutioningDecisions.filter((d) => d.category === "test-patterns");
 		if (testPatternDecisions.length > 0) {
 			testPatternsContent = "## Test Patterns\n" + testPatternDecisions.map((d) => `- ${d.key}: ${d.value}`).join("\n");
-			logger$15.debug({
+			logger$16.debug({
 				storyKey,
 				count: testPatternDecisions.length
 			}, "Loaded test patterns from decision store");
 		} else {
 			testPatternsContent = DEFAULT_VITEST_PATTERNS;
-			logger$15.debug({ storyKey }, "No test-pattern decisions found — using default Vitest patterns");
+			logger$16.debug({ storyKey }, "No test-pattern decisions found — using default Vitest patterns");
 		}
 	} catch (err) {
 		const error = err instanceof Error ? err.message : String(err);
-		logger$15.warn({
+		logger$16.warn({
 			storyKey,
 			error
 		}, "Failed to load test patterns — using defaults");
@@ -5652,7 +5789,7 @@ async function runDevStory(deps, params) {
 		const findings = getProjectFindings(deps.db);
 		if (findings.length > 0) {
 			priorFindingsContent = "Previous pipeline runs encountered these issues — avoid repeating them:\n\n" + findings;
-			logger$15.debug({
+			logger$16.debug({
 				storyKey,
 				findingsLen: findings.length
 			}, "Injecting prior findings into dev-story prompt");
@@ -5672,7 +5809,7 @@ async function runDevStory(deps, params) {
 			if (plan.test_categories && plan.test_categories.length > 0) parts.push(`\n### Categories: ${plan.test_categories.join(", ")}`);
 			if (plan.coverage_notes) parts.push(`\n### Coverage Notes\n${plan.coverage_notes}`);
 			testPlanContent = parts.join("\n");
-			logger$15.debug({ storyKey }, "Injecting test plan into dev-story prompt");
+			logger$16.debug({ storyKey }, "Injecting test plan into dev-story prompt");
 		}
 	} catch {}
 	const sections = [
@@ -5718,7 +5855,7 @@ async function runDevStory(deps, params) {
 		}
 	];
 	const { prompt, tokenCount, truncated } = assemblePrompt(template, sections, TOKEN_CEILING);
-	logger$15.info({
+	logger$16.info({
 		storyKey,
 		tokenCount,
 		ceiling: TOKEN_CEILING,
@@ -5734,12 +5871,13 @@ async function runDevStory(deps, params) {
 			outputSchema: DevStoryResultSchema,
 			maxTurns: resolvedMaxTurns,
 			...deps.projectRoot !== void 0 ? { workingDirectory: deps.projectRoot } : {},
-			...deps.otlpEndpoint !== void 0 ? { otlpEndpoint: deps.otlpEndpoint } : {}
+			...deps.otlpEndpoint !== void 0 ? { otlpEndpoint: deps.otlpEndpoint } : {},
+			storyKey
 		});
 		dispatchResult = await handle.result;
 	} catch (err) {
 		const error = err instanceof Error ? err.message : String(err);
-		logger$15.error({
+		logger$16.error({
 			storyKey,
 			error
 		}, "Dispatch threw an unexpected error");
@@ -5750,11 +5888,11 @@ async function runDevStory(deps, params) {
 		output: dispatchResult.tokenEstimate.output
 	};
 	if (dispatchResult.status === "timeout") {
-		logger$15.error({
+		logger$16.error({
 			storyKey,
 			durationMs: dispatchResult.durationMs
 		}, "Dev-story dispatch timed out");
-		if (dispatchResult.output.length > 0) logger$15.info({
+		if (dispatchResult.output.length > 0) logger$16.info({
 			storyKey,
 			partialOutput: dispatchResult.output.slice(0, 500)
 		}, "Partial output before timeout");
@@ -5764,12 +5902,12 @@ async function runDevStory(deps, params) {
 		};
 	}
 	if (dispatchResult.status === "failed" || dispatchResult.exitCode !== 0) {
-		logger$15.error({
+		logger$16.error({
 			storyKey,
 			exitCode: dispatchResult.exitCode,
 			status: dispatchResult.status
 		}, "Dev-story dispatch failed");
-		if (dispatchResult.output.length > 0) logger$15.info({
+		if (dispatchResult.output.length > 0) logger$16.info({
 			storyKey,
 			partialOutput: dispatchResult.output.slice(0, 500)
 		}, "Partial output from failed dispatch");
@@ -5781,7 +5919,7 @@ async function runDevStory(deps, params) {
 	if (dispatchResult.parseError !== null || dispatchResult.parsed === null) {
 		const details = dispatchResult.parseError ?? "parsed result was null";
 		const rawSnippet = dispatchResult.output ? dispatchResult.output.slice(0, 1e3) : "(empty)";
-		logger$15.error({
+		logger$16.error({
 			storyKey,
 			parseError: details,
 			rawOutputSnippet: rawSnippet
@@ -5789,12 +5927,12 @@ async function runDevStory(deps, params) {
 		let filesModified = [];
 		try {
 			filesModified = await getGitChangedFiles(deps.projectRoot ?? process.cwd());
-			if (filesModified.length > 0) logger$15.info({
+			if (filesModified.length > 0) logger$16.info({
 				storyKey,
 				fileCount: filesModified.length
 			}, "Recovered files_modified from git status (YAML fallback)");
 		} catch (err) {
-			logger$15.warn({
+			logger$16.warn({
 				storyKey,
 				error: err instanceof Error ? err.message : String(err)
 			}, "Failed to recover files_modified from git");
@@ -5811,7 +5949,7 @@ async function runDevStory(deps, params) {
 		};
 	}
 	const parsed = dispatchResult.parsed;
-	logger$15.info({
+	logger$16.info({
 		storyKey,
 		result: parsed.result,
 		acMet: parsed.ac_met.length
@@ -5950,7 +6088,7 @@ function extractFilesInScope(storyContent) {
 
 //#endregion
 //#region src/modules/compiled-workflows/code-review.ts
-const logger$14 = createLogger("compiled-workflows:code-review");
+const logger$15 = createLogger("compiled-workflows:code-review");
 /**
 * Default fallback result when dispatch fails or times out.
 * Uses NEEDS_MINOR_FIXES (not NEEDS_MAJOR_REWORK) so a parse/schema failure
@@ -5988,14 +6126,14 @@ function defaultFailResult(error, tokenUsage) {
 async function runCodeReview(deps, params) {
 	const { storyKey, storyFilePath, workingDirectory, pipelineRunId, filesModified, previousIssues } = params;
 	const cwd = workingDirectory ?? process.cwd();
-	logger$14.debug({
+	logger$15.debug({
 		storyKey,
 		storyFilePath,
 		cwd,
 		pipelineRunId
 	}, "Starting code-review workflow");
 	const { ceiling: TOKEN_CEILING, source: tokenCeilingSource } = getTokenCeiling("code-review", deps.tokenCeilings);
-	logger$14.info({
+	logger$15.info({
 		workflow: "code-review",
 		ceiling: TOKEN_CEILING,
 		source: tokenCeilingSource
@@ -6005,7 +6143,7 @@ async function runCodeReview(deps, params) {
 		template = await deps.pack.getPrompt("code-review");
 	} catch (err) {
 		const error = err instanceof Error ? err.message : String(err);
-		logger$14.error({ error }, "Failed to retrieve code-review prompt template");
+		logger$15.error({ error }, "Failed to retrieve code-review prompt template");
 		return defaultFailResult(`Failed to retrieve prompt template: ${error}`, {
 			input: 0,
 			output: 0
@@ -6016,7 +6154,7 @@ async function runCodeReview(deps, params) {
 		storyContent = await readFile$1(storyFilePath, "utf-8");
 	} catch (err) {
 		const error = err instanceof Error ? err.message : String(err);
-		logger$14.error({
+		logger$15.error({
 			storyFilePath,
 			error
 		}, "Failed to read story file");
@@ -6036,12 +6174,12 @@ async function runCodeReview(deps, params) {
 		const scopedTotal = nonDiffTokens + countTokens(scopedDiff);
 		if (scopedTotal <= TOKEN_CEILING) {
 			gitDiffContent = scopedDiff;
-			logger$14.debug({
+			logger$15.debug({
 				fileCount: filesModified.length,
 				tokenCount: scopedTotal
 			}, "Using scoped file diff");
 		} else {
-			logger$14.warn({
+			logger$15.warn({
 				estimatedTotal: scopedTotal,
 				ceiling: TOKEN_CEILING,
 				fileCount: filesModified.length
@@ -6055,7 +6193,7 @@ async function runCodeReview(deps, params) {
 		const fullTotal = nonDiffTokens + countTokens(fullDiff);
 		if (fullTotal <= TOKEN_CEILING) gitDiffContent = fullDiff;
 		else {
-			logger$14.warn({
+			logger$15.warn({
 				estimatedTotal: fullTotal,
 				ceiling: TOKEN_CEILING
 			}, "Full git diff would exceed token ceiling — using stat-only summary");
@@ -6063,7 +6201,7 @@ async function runCodeReview(deps, params) {
 		}
 	}
 	if (gitDiffContent.trim().length === 0) {
-		logger$14.info({ storyKey }, "Empty git diff — skipping review with SHIP_IT");
+		logger$15.info({ storyKey }, "Empty git diff — skipping review with SHIP_IT");
 		return {
 			verdict: "SHIP_IT",
 			issues: 0,
@@ -6088,7 +6226,7 @@ async function runCodeReview(deps, params) {
 		const findings = getProjectFindings(deps.db);
 		if (findings.length > 0) {
 			priorFindingsContent = "Previous reviews found these recurring patterns — pay special attention:\n\n" + findings;
-			logger$14.debug({
+			logger$15.debug({
 				storyKey,
 				findingsLen: findings.length
 			}, "Injecting prior findings into code-review prompt");
@@ -6122,11 +6260,11 @@ async function runCodeReview(deps, params) {
 		}
 	];
 	const assembleResult = assemblePrompt(template, sections, TOKEN_CEILING);
-	if (assembleResult.truncated) logger$14.warn({
+	if (assembleResult.truncated) logger$15.warn({
 		storyKey,
 		tokenCount: assembleResult.tokenCount
 	}, "Code-review prompt truncated to fit token ceiling");
-	logger$14.debug({
+	logger$15.debug({
 		storyKey,
 		tokenCount: assembleResult.tokenCount,
 		truncated: assembleResult.truncated
@@ -6138,14 +6276,15 @@ async function runCodeReview(deps, params) {
 		taskType: "code-review",
 		outputSchema: CodeReviewResultSchema,
 		workingDirectory: deps.projectRoot,
-		...deps.otlpEndpoint !== void 0 ? { otlpEndpoint: deps.otlpEndpoint } : {}
+		...deps.otlpEndpoint !== void 0 ? { otlpEndpoint: deps.otlpEndpoint } : {},
+		storyKey
 	});
 	let dispatchResult;
 	try {
 		dispatchResult = await handle.result;
 	} catch (err) {
 		const error = err instanceof Error ? err.message : String(err);
-		logger$14.error({
+		logger$15.error({
 			storyKey,
 			error
 		}, "Code-review dispatch threw unexpected error");
@@ -6161,7 +6300,7 @@ async function runCodeReview(deps, params) {
 	const rawOutput = dispatchResult.output ?? void 0;
 	if (dispatchResult.status === "failed") {
 		const errorMsg = `Dispatch status: failed. Exit code: ${dispatchResult.exitCode}. ${dispatchResult.parseError ?? ""} ${dispatchResult.output ? `Stderr: ${dispatchResult.output}` : ""}`.trim();
-		logger$14.warn({
+		logger$15.warn({
 			storyKey,
 			exitCode: dispatchResult.exitCode
 		}, "Code-review dispatch failed");
@@ -6171,7 +6310,7 @@ async function runCodeReview(deps, params) {
 		};
 	}
 	if (dispatchResult.status === "timeout") {
-		logger$14.warn({ storyKey }, "Code-review dispatch timed out");
+		logger$15.warn({ storyKey }, "Code-review dispatch timed out");
 		return {
 			...defaultFailResult("Dispatch status: timeout. The agent did not complete within the allowed time.", tokenUsage),
 			rawOutput
@@ -6179,7 +6318,7 @@ async function runCodeReview(deps, params) {
 	}
 	if (dispatchResult.parsed === null) {
 		const details = dispatchResult.parseError ?? "No YAML block found in output";
-		logger$14.warn({
+		logger$15.warn({
 			storyKey,
 			details
 		}, "Code-review output schema validation failed");
@@ -6196,7 +6335,7 @@ async function runCodeReview(deps, params) {
 	const parseResult = CodeReviewResultSchema.safeParse(dispatchResult.parsed);
 	if (!parseResult.success) {
 		const details = parseResult.error.message;
-		logger$14.warn({
+		logger$15.warn({
 			storyKey,
 			details
 		}, "Code-review output failed schema validation");
@@ -6211,13 +6350,13 @@ async function runCodeReview(deps, params) {
 		};
 	}
 	const parsed = parseResult.data;
-	if (parsed.agentVerdict !== parsed.verdict) logger$14.info({
+	if (parsed.agentVerdict !== parsed.verdict) logger$15.info({
 		storyKey,
 		agentVerdict: parsed.agentVerdict,
 		pipelineVerdict: parsed.verdict,
 		issues: parsed.issues
 	}, "Pipeline overrode agent verdict based on issue severities");
-	logger$14.info({
+	logger$15.info({
 		storyKey,
 		verdict: parsed.verdict,
 		issues: parsed.issues
@@ -6242,14 +6381,14 @@ function getArchConstraints$2(deps) {
 		if (constraints.length === 0) return "";
 		return constraints.map((d) => `${d.key}: ${d.value}`).join("\n");
 	} catch (err) {
-		logger$14.warn({ error: err instanceof Error ? err.message : String(err) }, "Failed to retrieve architecture constraints");
+		logger$15.warn({ error: err instanceof Error ? err.message : String(err) }, "Failed to retrieve architecture constraints");
 		return "";
 	}
 }
 
 //#endregion
 //#region src/modules/compiled-workflows/test-plan.ts
-const logger$13 = createLogger("compiled-workflows:test-plan");
+const logger$14 = createLogger("compiled-workflows:test-plan");
 /** Default timeout for test-plan dispatches in milliseconds (5 min — lightweight call) */
 const DEFAULT_TIMEOUT_MS = 3e5;
 /**
@@ -6261,12 +6400,12 @@ const DEFAULT_TIMEOUT_MS = 3e5;
 */
 async function runTestPlan(deps, params) {
 	const { storyKey, storyFilePath, pipelineRunId } = params;
-	logger$13.info({
+	logger$14.info({
 		storyKey,
 		storyFilePath
 	}, "Starting compiled test-plan workflow");
 	const { ceiling: TOKEN_CEILING, source: tokenCeilingSource } = getTokenCeiling("test-plan", deps.tokenCeilings);
-	logger$13.info({
+	logger$14.info({
 		workflow: "test-plan",
 		ceiling: TOKEN_CEILING,
 		source: tokenCeilingSource
@@ -6274,10 +6413,10 @@ async function runTestPlan(deps, params) {
 	let template;
 	try {
 		template = await deps.pack.getPrompt("test-plan");
-		logger$13.debug({ storyKey }, "Retrieved test-plan prompt template from pack");
+		logger$14.debug({ storyKey }, "Retrieved test-plan prompt template from pack");
 	} catch (err) {
 		const error = err instanceof Error ? err.message : String(err);
-		logger$13.warn({
+		logger$14.warn({
 			storyKey,
 			error
 		}, "Failed to retrieve test-plan prompt template");
@@ -6288,14 +6427,14 @@ async function runTestPlan(deps, params) {
 		storyContent = await readFile$1(storyFilePath, "utf-8");
 	} catch (err) {
 		if (err.code === "ENOENT") {
-			logger$13.warn({
+			logger$14.warn({
 				storyKey,
 				storyFilePath
 			}, "Story file not found for test planning");
 			return makeTestPlanFailureResult("story_file_not_found");
 		}
 		const error = err instanceof Error ? err.message : String(err);
-		logger$13.warn({
+		logger$14.warn({
 			storyKey,
 			storyFilePath,
 			error
@@ -6312,7 +6451,7 @@ async function runTestPlan(deps, params) {
 		content: archConstraintsContent,
 		priority: "optional"
 	}], TOKEN_CEILING);
-	logger$13.info({
+	logger$14.info({
 		storyKey,
 		tokenCount,
 		ceiling: TOKEN_CEILING,
@@ -6327,12 +6466,13 @@ async function runTestPlan(deps, params) {
 			timeout: DEFAULT_TIMEOUT_MS,
 			outputSchema: TestPlanResultSchema,
 			...deps.projectRoot !== void 0 ? { workingDirectory: deps.projectRoot } : {},
-			...deps.otlpEndpoint !== void 0 ? { otlpEndpoint: deps.otlpEndpoint } : {}
+			...deps.otlpEndpoint !== void 0 ? { otlpEndpoint: deps.otlpEndpoint } : {},
+			storyKey
 		});
 		dispatchResult = await handle.result;
 	} catch (err) {
 		const error = err instanceof Error ? err.message : String(err);
-		logger$13.warn({
+		logger$14.warn({
 			storyKey,
 			error
 		}, "Test-plan dispatch threw an unexpected error");
@@ -6343,7 +6483,7 @@ async function runTestPlan(deps, params) {
 		output: dispatchResult.tokenEstimate.output
 	};
 	if (dispatchResult.status === "timeout") {
-		logger$13.warn({
+		logger$14.warn({
 			storyKey,
 			durationMs: dispatchResult.durationMs
 		}, "Test-plan dispatch timed out");
@@ -6353,7 +6493,7 @@ async function runTestPlan(deps, params) {
 		};
 	}
 	if (dispatchResult.status === "failed" || dispatchResult.exitCode !== 0) {
-		logger$13.warn({
+		logger$14.warn({
 			storyKey,
 			exitCode: dispatchResult.exitCode,
 			status: dispatchResult.status
@@ -6365,7 +6505,7 @@ async function runTestPlan(deps, params) {
 	}
 	if (dispatchResult.parseError !== null || dispatchResult.parsed === null) {
 		const details = dispatchResult.parseError ?? "parsed result was null";
-		logger$13.warn({
+		logger$14.warn({
 			storyKey,
 			parseError: details
 		}, "Test-plan YAML schema validation failed");
@@ -6388,19 +6528,19 @@ async function runTestPlan(deps, params) {
 			}),
 			rationale: `Test plan for ${storyKey}: ${parsed.test_files.length} test files, categories: ${parsed.test_categories.join(", ")}`
 		});
-		logger$13.info({
+		logger$14.info({
 			storyKey,
 			fileCount: parsed.test_files.length,
 			categories: parsed.test_categories
 		}, "Test plan stored in decision store");
 	} catch (err) {
 		const error = err instanceof Error ? err.message : String(err);
-		logger$13.warn({
+		logger$14.warn({
 			storyKey,
 			error
 		}, "Failed to store test plan in decision store — proceeding anyway");
 	}
-	logger$13.info({
+	logger$14.info({
 		storyKey,
 		result: parsed.result
 	}, "Test-plan workflow completed");
@@ -6440,14 +6580,14 @@ function getArchConstraints$1(deps) {
 		if (constraints.length === 0) return "";
 		return constraints.map((d) => `${d.key}: ${d.value}`).join("\n");
 	} catch (err) {
-		logger$13.warn({ error: err instanceof Error ? err.message : String(err) }, "Failed to retrieve architecture constraints for test-plan — proceeding without them");
+		logger$14.warn({ error: err instanceof Error ? err.message : String(err) }, "Failed to retrieve architecture constraints for test-plan — proceeding without them");
 		return "";
 	}
 }
 
 //#endregion
 //#region src/modules/compiled-workflows/test-expansion.ts
-const logger$12 = createLogger("compiled-workflows:test-expansion");
+const logger$13 = createLogger("compiled-workflows:test-expansion");
 function defaultFallbackResult(error, tokenUsage) {
 	return {
 		expansion_priority: "low",
@@ -6477,14 +6617,14 @@ function defaultFallbackResult(error, tokenUsage) {
 async function runTestExpansion(deps, params) {
 	const { storyKey, storyFilePath, pipelineRunId, filesModified, workingDirectory } = params;
 	const cwd = workingDirectory ?? process.cwd();
-	logger$12.debug({
+	logger$13.debug({
 		storyKey,
 		storyFilePath,
 		cwd,
 		pipelineRunId
 	}, "Starting test-expansion workflow");
 	const { ceiling: TOKEN_CEILING, source: tokenCeilingSource } = getTokenCeiling("test-expansion", deps.tokenCeilings);
-	logger$12.info({
+	logger$13.info({
 		workflow: "test-expansion",
 		ceiling: TOKEN_CEILING,
 		source: tokenCeilingSource
@@ -6494,7 +6634,7 @@ async function runTestExpansion(deps, params) {
 		template = await deps.pack.getPrompt("test-expansion");
 	} catch (err) {
 		const error = err instanceof Error ? err.message : String(err);
-		logger$12.warn({ error }, "Failed to retrieve test-expansion prompt template");
+		logger$13.warn({ error }, "Failed to retrieve test-expansion prompt template");
 		return defaultFallbackResult(`Failed to retrieve prompt template: ${error}`, {
 			input: 0,
 			output: 0
@@ -6505,7 +6645,7 @@ async function runTestExpansion(deps, params) {
 		storyContent = await readFile$1(storyFilePath, "utf-8");
 	} catch (err) {
 		const error = err instanceof Error ? err.message : String(err);
-		logger$12.warn({
+		logger$13.warn({
 			storyFilePath,
 			error
 		}, "Failed to read story file");
@@ -6525,12 +6665,12 @@ async function runTestExpansion(deps, params) {
 		const scopedTotal = nonDiffTokens + countTokens(scopedDiff);
 		if (scopedTotal <= TOKEN_CEILING) {
 			gitDiffContent = scopedDiff;
-			logger$12.debug({
+			logger$13.debug({
 				fileCount: filesModified.length,
 				tokenCount: scopedTotal
 			}, "Using scoped file diff");
 		} else {
-			logger$12.warn({
+			logger$13.warn({
 				estimatedTotal: scopedTotal,
 				ceiling: TOKEN_CEILING,
 				fileCount: filesModified.length
@@ -6538,7 +6678,7 @@ async function runTestExpansion(deps, params) {
 			gitDiffContent = await getGitDiffStatSummary(cwd);
 		}
 	} catch (err) {
-		logger$12.warn({ error: err instanceof Error ? err.message : String(err) }, "Failed to get git diff — proceeding with empty diff");
+		logger$13.warn({ error: err instanceof Error ? err.message : String(err) }, "Failed to get git diff — proceeding with empty diff");
 	}
 	const sections = [
 		{
@@ -6558,11 +6698,11 @@ async function runTestExpansion(deps, params) {
 		}
 	];
 	const assembleResult = assemblePrompt(template, sections, TOKEN_CEILING);
-	if (assembleResult.truncated) logger$12.warn({
+	if (assembleResult.truncated) logger$13.warn({
 		storyKey,
 		tokenCount: assembleResult.tokenCount
 	}, "Test-expansion prompt truncated to fit token ceiling");
-	logger$12.debug({
+	logger$13.debug({
 		storyKey,
 		tokenCount: assembleResult.tokenCount,
 		truncated: assembleResult.truncated
@@ -6574,14 +6714,15 @@ async function runTestExpansion(deps, params) {
 		taskType: "test-expansion",
 		outputSchema: TestExpansionResultSchema,
 		workingDirectory: deps.projectRoot,
-		...deps.otlpEndpoint !== void 0 ? { otlpEndpoint: deps.otlpEndpoint } : {}
+		...deps.otlpEndpoint !== void 0 ? { otlpEndpoint: deps.otlpEndpoint } : {},
+		storyKey
 	});
 	let dispatchResult;
 	try {
 		dispatchResult = await handle.result;
 	} catch (err) {
 		const error = err instanceof Error ? err.message : String(err);
-		logger$12.warn({
+		logger$13.warn({
 			storyKey,
 			error
 		}, "Test-expansion dispatch threw unexpected error");
@@ -6596,19 +6737,19 @@ async function runTestExpansion(deps, params) {
 	};
 	if (dispatchResult.status === "failed") {
 		const errorMsg = `Dispatch status: failed. Exit code: ${dispatchResult.exitCode}. ${dispatchResult.parseError ?? ""}`.trim();
-		logger$12.warn({
+		logger$13.warn({
 			storyKey,
 			exitCode: dispatchResult.exitCode
 		}, "Test-expansion dispatch failed");
 		return defaultFallbackResult(errorMsg, tokenUsage);
 	}
 	if (dispatchResult.status === "timeout") {
-		logger$12.warn({ storyKey }, "Test-expansion dispatch timed out");
+		logger$13.warn({ storyKey }, "Test-expansion dispatch timed out");
 		return defaultFallbackResult("Dispatch status: timeout. The agent did not complete within the allowed time.", tokenUsage);
 	}
 	if (dispatchResult.parsed === null) {
 		const details = dispatchResult.parseError ?? "No YAML block found in output";
-		logger$12.warn({
+		logger$13.warn({
 			storyKey,
 			details
 		}, "Test-expansion output has no parseable YAML");
@@ -6617,14 +6758,14 @@ async function runTestExpansion(deps, params) {
 	const parseResult = TestExpansionResultSchema.safeParse(dispatchResult.parsed);
 	if (!parseResult.success) {
 		const details = parseResult.error.message;
-		logger$12.warn({
+		logger$13.warn({
 			storyKey,
 			details
 		}, "Test-expansion output failed schema validation");
 		return defaultFallbackResult(`schema_validation_failed: ${details}`, tokenUsage);
 	}
 	const parsed = parseResult.data;
-	logger$12.info({
+	logger$13.info({
 		storyKey,
 		expansion_priority: parsed.expansion_priority,
 		coverage_gaps: parsed.coverage_gaps.length,
@@ -6649,7 +6790,7 @@ function getArchConstraints(deps) {
 		if (constraints.length === 0) return "";
 		return constraints.map((d) => `${d.key}: ${d.value}`).join("\n");
 	} catch (err) {
-		logger$12.warn({ error: err instanceof Error ? err.message : String(err) }, "Failed to retrieve architecture constraints");
+		logger$13.warn({ error: err instanceof Error ? err.message : String(err) }, "Failed to retrieve architecture constraints");
 		return "";
 	}
 }
@@ -7937,7 +8078,7 @@ function createDoltClient(options) {
 
 //#endregion
 //#region src/modules/state/index.ts
-const logger$11 = createLogger("state:factory");
+const logger$12 = createLogger("state:factory");
 /**
 * Synchronously check whether Dolt is available and a Dolt repo exists at the
 * canonical state path under `basePath`.
@@ -7984,14 +8125,14 @@ function createStateStore(config = {}) {
 		const repoPath = config.basePath ?? process.cwd();
 		const detection = detectDoltAvailableSync(repoPath);
 		if (detection.available) {
-			logger$11.debug(`Dolt detected, using DoltStateStore (state path: ${join$1(repoPath, ".substrate", "state")})`);
+			logger$12.debug(`Dolt detected, using DoltStateStore (state path: ${join$1(repoPath, ".substrate", "state")})`);
 			const client = new DoltClient({ repoPath });
 			return new DoltStateStore({
 				repoPath,
 				client
 			});
 		} else {
-			logger$11.debug(`Dolt not found, using FileStateStore (reason: ${detection.reason})`);
+			logger$12.debug(`Dolt not found, using FileStateStore (reason: ${detection.reason})`);
 			return new FileStateStore({ basePath: config.basePath });
 		}
 	}
@@ -8000,7 +8141,7 @@ function createStateStore(config = {}) {
 
 //#endregion
 //#region src/cli/commands/health.ts
-const logger$10 = createLogger("health-cmd");
+const logger$11 = createLogger("health-cmd");
 /** Default stall threshold in seconds — also used by supervisor default */
 const DEFAULT_STALL_THRESHOLD_SECONDS = 600;
 /**
@@ -8255,6 +8396,7 @@ async function getAutoHealthData(options) {
 		else if (processInfo.orchestrator_pid !== null && processInfo.child_pids.length > 0 && stalenessSeconds > DEFAULT_STALL_THRESHOLD_SECONDS) verdict = "HEALTHY";
 		else if (stalenessSeconds > DEFAULT_STALL_THRESHOLD_SECONDS) verdict = "STALLED";
 		else if (processInfo.orchestrator_pid !== null && processInfo.child_pids.length === 0 && active > 0) verdict = "STALLED";
+		else if (processInfo.orchestrator_pid === null && active > 0) verdict = "STALLED";
 		else verdict = "HEALTHY";
 		else if (run.status === "completed" || run.status === "failed" || run.status === "stopped") verdict = "NO_PIPELINE_RUNNING";
 		const healthOutput = {
@@ -8321,7 +8463,7 @@ async function runHealthAction(options) {
 		const msg = err instanceof Error ? err.message : String(err);
 		if (outputFormat === "json") process.stdout.write(formatOutput(null, "json", false, msg) + "\n");
 		else process.stderr.write(`Error: ${msg}\n`);
-		logger$10.error({ err }, "health action failed");
+		logger$11.error({ err }, "health action failed");
 		return 1;
 	}
 }
@@ -8368,7 +8510,7 @@ function registerHealthCommand(program, _version = "0.0.0", projectRoot = proces
 
 //#endregion
 //#region src/modules/implementation-orchestrator/seed-methodology-context.ts
-const logger$9 = createLogger("implementation-orchestrator:seed");
+const logger$10 = createLogger("implementation-orchestrator:seed");
 /** Max chars for the architecture summary seeded into decisions */
 const MAX_ARCH_CHARS = 6e3;
 /** Max chars per epic shard (fallback when per-story extraction returns null) */
@@ -8402,12 +8544,12 @@ function seedMethodologyContext(db, projectRoot) {
 		const testCount = seedTestPatterns(db, projectRoot);
 		if (testCount === -1) result.skippedCategories.push("test-patterns");
 		else result.decisionsCreated += testCount;
-		logger$9.info({
+		logger$10.info({
 			decisionsCreated: result.decisionsCreated,
 			skippedCategories: result.skippedCategories
 		}, "Methodology context seeding complete");
 	} catch (err) {
-		logger$9.warn({ error: err instanceof Error ? err.message : String(err) }, "Methodology context seeding failed (non-fatal)");
+		logger$10.warn({ error: err instanceof Error ? err.message : String(err) }, "Methodology context seeding failed (non-fatal)");
 	}
 	return result;
 }
@@ -8451,7 +8593,7 @@ function seedArchitecture(db, projectRoot) {
 		});
 		count = 1;
 	}
-	logger$9.debug({ count }, "Seeded architecture decisions");
+	logger$10.debug({ count }, "Seeded architecture decisions");
 	return count;
 }
 /**
@@ -8475,11 +8617,11 @@ function seedEpicShards(db, projectRoot) {
 	const storedHashDecision = implementationDecisions.find((d) => d.category === "epic-shard-hash" && d.key === "epics-file");
 	const storedHash = storedHashDecision?.value;
 	if (storedHash === currentHash) {
-		logger$9.debug({ hash: currentHash }, "Epic shards up-to-date (hash unchanged) — skipping re-seed");
+		logger$10.debug({ hash: currentHash }, "Epic shards up-to-date (hash unchanged) — skipping re-seed");
 		return -1;
 	}
 	if (implementationDecisions.some((d) => d.category === "epic-shard")) {
-		logger$9.debug({
+		logger$10.debug({
 			storedHash,
 			currentHash
 		}, "Epics file changed — deleting stale epic-shard decisions");
@@ -8507,7 +8649,7 @@ function seedEpicShards(db, projectRoot) {
 		value: currentHash,
 		rationale: "SHA-256 hash of epics file content for change detection"
 	});
-	logger$9.debug({
+	logger$10.debug({
 		count,
 		hash: currentHash
 	}, "Seeded epic shard decisions");
@@ -8531,7 +8673,7 @@ function seedTestPatterns(db, projectRoot) {
 		value: patterns.slice(0, MAX_TEST_PATTERNS_CHARS),
 		rationale: "Detected from project configuration at orchestrator startup"
 	});
-	logger$9.debug("Seeded test patterns decision");
+	logger$10.debug("Seeded test patterns decision");
 	return 1;
 }
 /**
@@ -8704,7 +8846,7 @@ function findArtifact(projectRoot, candidates) {
 
 //#endregion
 //#region src/modules/agent-dispatch/interface-change-detector.ts
-const logger$8 = createLogger("interface-change-detector");
+const logger$9 = createLogger("interface-change-detector");
 /**
 * Extract exported interface and type names from TypeScript source content.
 *
@@ -8751,7 +8893,7 @@ function detectInterfaceChanges(options) {
 				for (const name of names) allNames.add(name);
 				sourceDirs.push(dirname$1(relPath));
 			} catch {
-				logger$8.debug({
+				logger$9.debug({
 					absPath,
 					storyKey
 				}, "Could not read modified file for interface extraction");
@@ -8792,7 +8934,7 @@ function detectInterfaceChanges(options) {
 			potentiallyAffectedTests: Array.from(affectedTests)
 		};
 	} catch (err) {
-		logger$8.warn({
+		logger$9.warn({
 			err,
 			storyKey: options.storyKey
 		}, "Interface change detection failed — skipping");
@@ -9083,7 +9225,7 @@ const RecommendationSchema = z.object({
 
 //#endregion
 //#region src/modules/telemetry/persistence.ts
-const logger$7 = createLogger("telemetry:persistence");
+const logger$8 = createLogger("telemetry:persistence");
 /**
 * Concrete SQLite-backed telemetry persistence.
 *
@@ -9317,7 +9459,7 @@ var TelemetryPersistence = class {
 			for (const turn of rows) this._insertTurnAnalysis.run(storyKey, turn.spanId, turn.turnNumber, turn.name, turn.timestamp, turn.source, turn.model ?? null, turn.inputTokens, turn.outputTokens, turn.cacheReadTokens, turn.freshTokens, turn.cacheHitRate, turn.costUsd, turn.durationMs, turn.contextSize, turn.contextDelta, turn.toolName ?? null, turn.isContextSpike ? 1 : 0, JSON.stringify(turn.childSpans));
 		});
 		insertAll(turns);
-		logger$7.debug({
+		logger$8.debug({
 			storyKey,
 			count: turns.length
 		}, "Stored turn analysis");
@@ -9351,7 +9493,7 @@ var TelemetryPersistence = class {
 	}
 	async storeEfficiencyScore(score) {
 		this._insertEfficiencyScore.run(score.storyKey, score.timestamp, score.compositeScore, score.cacheHitSubScore, score.ioRatioSubScore, score.contextManagementSubScore, score.avgCacheHitRate, score.avgIoRatio, score.contextSpikeCount, score.totalTurns, JSON.stringify(score.perModelBreakdown), JSON.stringify(score.perSourceBreakdown));
-		logger$7.debug({
+		logger$8.debug({
 			storyKey: score.storyKey,
 			compositeScore: score.compositeScore
 		}, "Stored efficiency score");
@@ -9410,7 +9552,7 @@ var TelemetryPersistence = class {
 			for (const rec of rows) this._insertRecommendation.run(rec.id, rec.storyKey, rec.sprintId ?? null, rec.ruleId, rec.severity, rec.title, rec.description, rec.potentialSavingsTokens ?? null, rec.potentialSavingsUsd ?? null, rec.actionTarget ?? null, rec.generatedAt);
 		});
 		insertAll(recs);
-		logger$7.debug({
+		logger$8.debug({
 			storyKey,
 			count: recs.length
 		}, "Saved recommendations");
@@ -9474,7 +9616,7 @@ var TelemetryPersistence = class {
 			for (const stat$2 of rows) this._insertCategoryStats.run(storyKey, stat$2.category, stat$2.totalTokens, stat$2.percentage, stat$2.eventCount, stat$2.avgTokensPerEvent, stat$2.trend);
 		});
 		insertAll(stats);
-		logger$7.debug({
+		logger$8.debug({
 			storyKey,
 			count: stats.length
 		}, "Stored category stats");
@@ -9510,7 +9652,7 @@ var TelemetryPersistence = class {
 			for (const consumer of rows) this._insertConsumerStats.run(storyKey, consumer.consumerKey, consumer.category, consumer.totalTokens, consumer.percentage, consumer.eventCount, JSON.stringify(consumer.topInvocations));
 		});
 		insertAll(consumers);
-		logger$7.debug({
+		logger$8.debug({
 			storyKey,
 			count: consumers.length
 		}, "Stored consumer stats");
@@ -9566,9 +9708,120 @@ var AppError = class extends Error {
 	}
 };
 
+//#endregion
+//#region src/modules/telemetry/batch-buffer.ts
+var BatchBuffer = class extends EventEmitter {
+	_items = [];
+	_timer = null;
+	_batchSize;
+	_flushIntervalMs;
+	constructor(options = {}) {
+		super();
+		this._batchSize = options.batchSize ?? 100;
+		this._flushIntervalMs = options.flushIntervalMs ?? 5e3;
+	}
+	/**
+	* Add an item to the buffer.
+	* Triggers a flush immediately when the buffer reaches `batchSize`.
+	*/
+	push(item) {
+		this._items.push(item);
+		if (this._items.length >= this._batchSize) this._flush();
+	}
+	/**
+	* Start the interval timer that flushes items on a schedule.
+	* Safe to call multiple times — subsequent calls are ignored.
+	*/
+	start() {
+		if (this._timer !== null) return;
+		this._timer = setInterval(() => this._flush(), this._flushIntervalMs);
+		if (typeof this._timer.unref === "function") this._timer.unref();
+	}
+	/**
+	* Stop the interval timer and flush any remaining items.
+	* Safe to call multiple times — subsequent calls are ignored.
+	*/
+	stop() {
+		if (this._timer !== null) {
+			clearInterval(this._timer);
+			this._timer = null;
+		}
+		this._flush();
+	}
+	_flush() {
+		if (this._items.length === 0) return;
+		const items = this._items.splice(0);
+		this.emit("flush", items);
+	}
+};
+
+//#endregion
+//#region src/modules/telemetry/source-detector.ts
+const SOURCE_DETECTION_TABLE = [
+	{
+		pattern: /claude[\s-]?code/i,
+		source: "claude-code"
+	},
+	{
+		pattern: /claude/i,
+		source: "claude-code"
+	},
+	{
+		pattern: /codex/i,
+		source: "codex"
+	},
+	{
+		pattern: /openai/i,
+		source: "codex"
+	},
+	{
+		pattern: /ollama|llama|local/i,
+		source: "local-llm"
+	}
+];
+/**
+* Extract string values for service.name and telemetry.sdk.name from
+* raw OTLP resource attributes, supporting both resourceSpans and resourceLogs.
+*/
+function extractAttributes(body) {
+	if (!body || typeof body !== "object") return [];
+	const values = [];
+	const keysOfInterest = ["service.name", "telemetry.sdk.name"];
+	const extractFromResources = (resources) => {
+		if (!Array.isArray(resources)) return;
+		for (const entry of resources) {
+			if (!entry?.resource?.attributes) continue;
+			for (const attr of entry.resource.attributes) {
+				if (!attr?.key || !keysOfInterest.includes(attr.key)) continue;
+				const v = attr.value;
+				if (!v) continue;
+				const str = v.stringValue ?? (v.intValue !== void 0 ? String(v.intValue) : void 0) ?? (v.doubleValue !== void 0 ? String(v.doubleValue) : void 0);
+				if (str !== void 0) values.push(str);
+			}
+		}
+	};
+	const payload = body;
+	extractFromResources(payload.resourceSpans);
+	extractFromResources(payload.resourceLogs);
+	return values;
+}
+/**
+* Detect the OTLP source from a raw payload.
+*
+* Inspects `service.name` and `telemetry.sdk.name` from resource attributes
+* in both `resourceSpans` and `resourceLogs` envelope formats.
+*
+* Returns 'unknown' when no match is found or input is malformed.
+*/
+function detectSource(body) {
+	const values = extractAttributes(body);
+	for (const value of values) for (const { pattern, source } of SOURCE_DETECTION_TABLE) if (pattern.test(value)) return source;
+	return "unknown";
+}
+
 //#endregion
 //#region src/modules/telemetry/ingestion-server.ts
-const logger$6 = createLogger("telemetry:ingestion-server");
+const logger$7 = createLogger("telemetry:ingestion-server");
 /**
 * Error thrown by IngestionServer for server lifecycle violations.
 * Extends AppError to align with the project-standard error-handling pattern
@@ -9588,8 +9841,41 @@ var TelemetryError = class extends AppError {
 var IngestionServer = class {
 	_server = null;
 	_port;
+	_batchSize;
+	_flushIntervalMs;
+	_buffer;
+	_pendingBatches = new Set();
 	constructor(options = {}) {
 		this._port = options.port ?? 4318;
+		this._batchSize = options.batchSize ?? 100;
+		this._flushIntervalMs = options.flushIntervalMs ?? 5e3;
+		if (options.pipeline !== void 0) this._initPipeline(options.pipeline);
+	}
+	/**
+	* Wire a TelemetryPipeline before the server is started.
+	* Must be called before start() — has no effect if called after start().
+	*/
+	setPipeline(pipeline) {
+		if (this._server !== null) {
+			logger$7.warn("IngestionServer.setPipeline() called after start() — ignoring");
+			return;
+		}
+		this._initPipeline(pipeline);
+	}
+	_initPipeline(pipeline) {
+		this._buffer = new BatchBuffer({
+			batchSize: this._batchSize,
+			flushIntervalMs: this._flushIntervalMs
+		});
+		this._buffer.on("flush", (items) => {
+			const pending = pipeline.processBatch(items).catch((err) => {
+				logger$7.warn({ err }, "TelemetryPipeline.processBatch failed (batch flush)");
+			});
+			this._pendingBatches.add(pending);
+			pending.then(() => {
+				this._pendingBatches.delete(pending);
+			});
+		});
 	}
 	/**
 	* Start the HTTP ingestion server.
@@ -9597,36 +9883,40 @@ var IngestionServer = class {
 	*/
 	async start() {
 		if (this._server !== null) {
-			logger$6.warn("IngestionServer.start() called while already started — ignoring");
+			logger$7.warn("IngestionServer.start() called while already started — ignoring");
 			return;
 		}
 		return new Promise((resolve$2, reject) => {
 			const server = createServer(this._handleRequest.bind(this));
 			server.on("error", (err) => {
-				logger$6.error({ err }, "IngestionServer failed to start");
+				logger$7.error({ err }, "IngestionServer failed to start");
 				reject(err);
 			});
 			server.listen(this._port, "127.0.0.1", () => {
 				this._server = server;
 				const addr = server.address();
-				logger$6.info({ port: addr.port }, "IngestionServer listening");
+				logger$7.info({ port: addr.port }, "IngestionServer listening");
+				this._buffer?.start();
 				resolve$2();
 			});
 		});
 	}
 	/**
 	* Stop the HTTP ingestion server.
+	* Drains the batch buffer before closing the HTTP server.
 	* Resolves when the server has closed all connections.
 	*/
 	async stop() {
 		const server = this._server;
 		if (server === null) return;
 		this._server = null;
+		this._buffer?.stop();
+		if (this._pendingBatches.size > 0) await Promise.all([...this._pendingBatches]);
 		return new Promise((resolve$2, reject) => {
 			server.close((err) => {
 				if (err !== void 0 && err !== null) reject(err);
 				else {
-					logger$6.info("IngestionServer stopped");
+					logger$7.info("IngestionServer stopped");
 					resolve$2();
 				}
 			});
@@ -9649,22 +9939,42 @@ var IngestionServer = class {
 			OTEL_EXPORTER_OTLP_ENDPOINT: endpoint
 		};
 	}
-	_handleRequest(_req, res) {
+	_handleRequest(req, res) {
+		if (req.url === "/health" && req.method === "GET") {
+			res.writeHead(200, { "Content-Type": "application/json" });
+			res.end(JSON.stringify({ status: "ok" }));
+			return;
+		}
 		const chunks = [];
-		_req.on("data", (chunk) => {
+		req.on("data", (chunk) => {
 			chunks.push(chunk);
 		});
-		_req.on("end", () => {
-			const body = Buffer.concat(chunks).toString("utf-8");
-			logger$6.trace({
-				url: _req.url,
-				bodyLength: body.length
+		req.on("end", () => {
+			const bodyStr = Buffer.concat(chunks).toString("utf-8");
+			logger$7.trace({
+				url: req.url,
+				bodyLength: bodyStr.length
 			}, "OTLP payload received");
+			if (this._buffer !== void 0) try {
+				const body = JSON.parse(bodyStr);
+				const source = detectSource(body);
+				const payload = {
+					body,
+					source,
+					receivedAt: Date.now()
+				};
+				this._buffer.push(payload);
+			} catch (err) {
+				logger$7.warn({
+					err,
+					url: req.url
+				}, "Failed to parse OTLP payload JSON — discarding");
+			}
 			res.writeHead(200, { "Content-Type": "application/json" });
 			res.end("{}");
 		});
-		_req.on("error", (err) => {
-			logger$6.warn({ err }, "Error reading OTLP request body");
+		req.on("error", (err) => {
+			logger$7.warn({ err }, "Error reading OTLP request body");
 			res.writeHead(400);
 			res.end("Bad Request");
 		});
@@ -9675,8 +9985,8 @@ var IngestionServer = class {
 //#region src/modules/telemetry/efficiency-scorer.ts
 var EfficiencyScorer = class {
 	_logger;
-	constructor(logger$26) {
-		this._logger = logger$26;
+	constructor(logger$27) {
+		this._logger = logger$27;
 	}
 	/**
 	* Compute an efficiency score for a story given its turn analyses.
@@ -9911,8 +10221,8 @@ const ALL_CATEGORIES = [
 ];
 var Categorizer = class {
 	_logger;
-	constructor(logger$26) {
-		this._logger = logger$26;
+	constructor(logger$27) {
+		this._logger = logger$27;
 	}
 	/**
 	* Classify an operation into a SemanticCategory using three-tier logic.
@@ -10038,9 +10348,9 @@ function extractToolNameFromSpan(span) {
 var ConsumerAnalyzer = class {
 	_categorizer;
 	_logger;
-	constructor(categorizer, logger$26) {
+	constructor(categorizer, logger$27) {
 		this._categorizer = categorizer;
-		this._logger = logger$26;
+		this._logger = logger$27;
 	}
 	/**
 	* Group spans by consumer key, rank by totalTokens descending, and return
@@ -10114,8 +10424,1076 @@ var ConsumerAnalyzer = class {
 };
 
 //#endregion
-//#region src/modules/implementation-orchestrator/orchestrator-impl.ts
-function createPauseGate() {
+//#region src/modules/telemetry/recommender.ts
+var Recommender = class {
+	_logger;
+	constructor(logger$27) {
+		this._logger = logger$27;
+	}
+	/**
+	* Run all 8 rules against the given context and return sorted recommendations.
+	* Output is sorted: critical → warning → info, then by potentialSavingsTokens descending.
+	* No Date.now() or Math.random() is called — generatedAt comes from context.
+	*/
+	analyze(context) {
+		const allRecs = [
+			...this._runBiggestConsumers(context),
+			...this._runExpensiveBash(context),
+			...this._runLargeFileReads(context),
+			...this._runRepeatedToolCalls(context),
+			...this._runContextGrowthSpikes(context),
+			...this._runGrowingCategories(context),
+			...this._runCacheEfficiency(context),
+			...this._runModelComparison(context)
+		];
+		const severityOrder = {
+			critical: 0,
+			warning: 1,
+			info: 2
+		};
+		return allRecs.sort((a, b) => {
+			const sA = severityOrder[a.severity];
+			const sB = severityOrder[b.severity];
+			if (sA !== sB) return sA - sB;
+			const savA = a.potentialSavingsTokens ?? 0;
+			const savB = b.potentialSavingsTokens ?? 0;
+			return savB - savA;
+		});
+	}
+	/**
+	* Generate a 16-char hex ID from the sha256 of `ruleId:storyKey:actionTarget:index`.
+	*/
+	_makeId(ruleId, storyKey, actionTarget, index) {
+		return createHash("sha256").update(`${ruleId}:${storyKey}:${actionTarget}:${index}`).digest("hex").slice(0, 16);
+	}
+	/**
+	* Map a token percentage to a severity level.
+	* >25% → critical, >10% → warning, ≤10% → info.
+	*/
+	_assignSeverity(tokenPercent) {
+		if (tokenPercent > 25) return "critical";
+		if (tokenPercent > 10) return "warning";
+		return "info";
+	}
+	/**
+	* Compute total tokens across all spans. Guards against empty arrays.
+	*/
+	_totalSpanTokens(spans) {
+		return spans.reduce((sum, s) => sum + s.inputTokens + s.outputTokens, 0);
+	}
+	/**
+	* Identify top 3 token consumers (by inputTokens + outputTokens) where pct >5%.
+	* Severity based on the consumer's percentage of total tokens.
+	*/
+	_runBiggestConsumers(ctx) {
+		const { consumers, storyKey, sprintId, generatedAt } = ctx;
+		if (consumers.length === 0) return [];
+		const grandTotal = consumers.reduce((sum, c) => sum + c.totalTokens, 0);
+		if (grandTotal === 0) return [];
+		const sorted = [...consumers].sort((a, b) => b.totalTokens - a.totalTokens);
+		const top3 = sorted.slice(0, 3).filter((c) => {
+			return c.percentage > 5;
+		});
+		return top3.map((consumer, index) => {
+			const pct = consumer.percentage;
+			const severity = this._assignSeverity(pct);
+			const actionTarget = consumer.consumerKey;
+			const id = this._makeId("biggest_consumers", storyKey, actionTarget, index);
+			return {
+				id,
+				storyKey,
+				sprintId,
+				ruleId: "biggest_consumers",
+				severity,
+				title: `High token consumer: ${consumer.consumerKey}`,
+				description: `"${consumer.consumerKey}" consumed ${consumer.totalTokens.toLocaleString()} tokens (${pct.toFixed(1)}% of total). Consider reducing the frequency or size of this operation.`,
+				potentialSavingsTokens: Math.round(consumer.totalTokens * .3),
+				actionTarget,
+				generatedAt
+			};
+		});
+	}
+	/**
+	* Flag file-read spans with inputTokens > 3000.
+	* Suggest using line ranges to reduce token count.
+	*/
+	_runLargeFileReads(ctx) {
+		const { allSpans, storyKey, sprintId, generatedAt } = ctx;
+		if (allSpans.length === 0) return [];
+		const grandTotal = this._totalSpanTokens(allSpans);
+		const largReads = allSpans.filter((s) => s.operationName === "file_read" && s.inputTokens > 3e3);
+		return largReads.map((span, index) => {
+			const pct = grandTotal > 0 ? (span.inputTokens + span.outputTokens) / grandTotal * 100 : 0;
+			const severity = this._assignSeverity(pct);
+			const actionTarget = span.attributes?.["file.path"] ?? span.name;
+			const id = this._makeId("large_file_reads", storyKey, actionTarget, index);
+			return {
+				id,
+				storyKey,
+				sprintId,
+				ruleId: "large_file_reads",
+				severity,
+				title: `Large file read: ${actionTarget}`,
+				description: `File read of "${actionTarget}" consumed ${span.inputTokens.toLocaleString()} input tokens. Consider specifying line ranges (e.g., offset/limit) to reduce context size.`,
+				potentialSavingsTokens: Math.round(span.inputTokens * .5),
+				actionTarget,
+				generatedAt
+			};
+		});
+	}
+	/**
+	* Flag bash/execute_command spans with outputTokens > 3000.
+	* Suggest filtering or truncating command output.
+	*/
+	_runExpensiveBash(ctx) {
+		const { allSpans, storyKey, sprintId, generatedAt } = ctx;
+		if (allSpans.length === 0) return [];
+		const grandTotal = this._totalSpanTokens(allSpans);
+		const expensiveBash = allSpans.filter((s) => (s.attributes?.["tool.name"] === "bash" || s.attributes?.["tool.name"] === "execute_command" || s.name === "bash" || s.name === "execute_command" || s.operationName !== void 0 && (s.operationName === "bash" || s.operationName === "execute_command")) && s.outputTokens > 3e3);
+		return expensiveBash.map((span, index) => {
+			const pct = grandTotal > 0 ? (span.inputTokens + span.outputTokens) / grandTotal * 100 : 0;
+			const severity = this._assignSeverity(pct);
+			const actionTarget = span.attributes?.["bash.command"] ?? span.name ?? "bash";
+			const id = this._makeId("expensive_bash", storyKey, actionTarget, index);
+			return {
+				id,
+				storyKey,
+				sprintId,
+				ruleId: "expensive_bash",
+				severity,
+				title: `Expensive bash output: ${actionTarget}`,
+				description: `Bash command "${actionTarget}" produced ${span.outputTokens.toLocaleString()} output tokens. Consider filtering output (e.g., piping to head/grep) to reduce token consumption.`,
+				potentialSavingsTokens: Math.round(span.outputTokens * .5),
+				actionTarget,
+				generatedAt
+			};
+		});
+	}
+	/**
+	* Detect tool calls with the same actionTarget appearing more than once.
+	* Suggests caching the result to avoid redundant token consumption.
+	*/
+	_runRepeatedToolCalls(ctx) {
+		const { turns, storyKey, sprintId, generatedAt, allSpans } = ctx;
+		const allChildSpans = [];
+		for (const turn of turns) for (const child of turn.childSpans) allChildSpans.push({
+			toolName: child.toolName,
+			name: child.name
+		});
+		if (allChildSpans.length === 0 && allSpans.length > 0) for (const span of allSpans) allChildSpans.push({
+			toolName: span.attributes?.["tool.name"],
+			name: span.name,
+			actionTarget: span.attributes?.["file.path"]
+		});
+		const groups = new Map();
+		for (const span of allChildSpans) {
+			const key = `${span.toolName ?? ""}:${span.actionTarget ?? span.name}`;
+			groups.set(key, (groups.get(key) ?? 0) + 1);
+		}
+		const recommendations = [];
+		let index = 0;
+		for (const [key, count] of groups) if (count > 1) {
+			const id = this._makeId("repeated_tool_calls", storyKey, key, index);
+			recommendations.push({
+				id,
+				storyKey,
+				sprintId,
+				ruleId: "repeated_tool_calls",
+				severity: "warning",
+				title: `Repeated tool call: ${key}`,
+				description: `"${key}" was invoked ${count} times. Consider caching the result after the first call to avoid redundant token consumption.`,
+				actionTarget: key,
+				generatedAt
+			});
+			index++;
+		}
+		return recommendations;
+	}
+	/**
+	* Flag turns where isContextSpike is true.
+	* Severity is always at least 'warning'.
+	*/
+	_runContextGrowthSpikes(ctx) {
+		const { turns, storyKey, sprintId, generatedAt, allSpans } = ctx;
+		if (turns.length === 0) return [];
+		const grandTotal = this._totalSpanTokens(allSpans);
+		const spiketurns = turns.filter((t) => t.isContextSpike);
+		return spiketurns.map((turn, index) => {
+			const pct = grandTotal > 0 ? (turn.inputTokens + turn.outputTokens) / grandTotal * 100 : 0;
+			const baseSeverity = this._assignSeverity(pct);
+			const severity = baseSeverity === "info" ? "warning" : baseSeverity;
+			const topContributors = [...turn.childSpans].sort((a, b) => b.inputTokens + b.outputTokens - (a.inputTokens + a.outputTokens)).slice(0, 3).map((c) => c.name);
+			const actionTarget = `turn:${turn.turnNumber}`;
+			const id = this._makeId("context_growth_spike", storyKey, actionTarget, index);
+			return {
+				id,
+				storyKey,
+				sprintId,
+				ruleId: "context_growth_spike",
+				severity,
+				title: `Context spike at turn ${turn.turnNumber}`,
+				description: `Turn ${turn.turnNumber} had a context spike with ${turn.inputTokens.toLocaleString()} input tokens. Top contributors: ${topContributors.length > 0 ? topContributors.join(", ") : "none identified"}. Consider compressing or evicting context before this turn.`,
+				potentialSavingsTokens: Math.round(turn.contextDelta * .3),
+				actionTarget,
+				generatedAt
+			};
+		});
+	}
+	/**
+	* Flag semantic categories with trend === 'growing'.
+	* Severity is 'info' by default; 'warning' if percentage > 25%.
+	*/
+	_runGrowingCategories(ctx) {
+		const { categories, storyKey, sprintId, generatedAt } = ctx;
+		if (categories.length === 0) return [];
+		const growing = categories.filter((c) => c.trend === "growing");
+		return growing.map((cat, index) => {
+			const severity = cat.percentage > 25 ? "warning" : "info";
+			const actionTarget = cat.category;
+			const id = this._makeId("growing_categories", storyKey, actionTarget, index);
+			return {
+				id,
+				storyKey,
+				sprintId,
+				ruleId: "growing_categories",
+				severity,
+				title: `Growing category: ${cat.category}`,
+				description: `The "${cat.category}" category is growing across turns, currently at ${cat.percentage.toFixed(1)}% of total tokens (${cat.totalTokens.toLocaleString()} tokens). This trend suggests increasing context pressure from this source.`,
+				potentialSavingsTokens: Math.round(cat.totalTokens * .2),
+				actionTarget,
+				generatedAt
+			};
+		});
+	}
+	/**
+	* If cache hit rate < 30%, flag the worst-performing operations and compute
+	* potential savings as totalCacheMissTokens * 0.5.
+	*/
+	_runCacheEfficiency(ctx) {
+		const { efficiencyScore, allSpans, storyKey, sprintId, generatedAt } = ctx;
+		const cacheHitRate = isNaN(efficiencyScore.avgCacheHitRate) ? 0 : efficiencyScore.avgCacheHitRate;
+		if (cacheHitRate >= .3) return [];
+		if (allSpans.length === 0) return [];
+		const totalCacheMissTokens = allSpans.reduce((sum, s) => {
+			const missTokens = s.inputTokens - s.cacheReadTokens;
+			return sum + Math.max(0, missTokens);
+		}, 0);
+		if (totalCacheMissTokens === 0) return [];
+		const potentialSavingsTokens = Math.round(totalCacheMissTokens * .5);
+		const spansWithRate = allSpans.filter((s) => s.inputTokens > 0).map((s) => ({
+			span: s,
+			hitRate: s.cacheReadTokens / s.inputTokens
+		})).sort((a, b) => a.hitRate - b.hitRate).slice(0, 3);
+		const worstOps = spansWithRate.map((e) => e.span.name).join(", ");
+		const actionTarget = worstOps || "unknown";
+		const id = this._makeId("cache_efficiency", storyKey, actionTarget, 0);
+		this._logger.debug({
+			storyKey,
+			cacheHitRate,
+			potentialSavingsTokens
+		}, "cache_efficiency recommendation generated");
+		return [{
+			id,
+			storyKey,
+			sprintId,
+			ruleId: "cache_efficiency",
+			severity: "warning",
+			title: "Low cache hit rate",
+			description: `Overall cache hit rate is ${(cacheHitRate * 100).toFixed(1)}% (below 30% threshold). Worst performing operations: ${worstOps || "none identified"}. Potential savings if hit rate reached 50%: ${potentialSavingsTokens.toLocaleString()} tokens.`,
+			potentialSavingsTokens,
+			actionTarget,
+			generatedAt
+		}];
+	}
+	/**
+	* If more than one model is present, flag the underperforming model.
+	* Severity is 'info' by default; 'warning' if cache efficiency gap > 20pp.
+	*/
+	_runModelComparison(ctx) {
+		const { efficiencyScore, storyKey, sprintId, generatedAt } = ctx;
+		const models = efficiencyScore.perModelBreakdown;
+		if (models.length <= 1) return [];
+		const sorted = [...models].sort((a, b) => b.cacheHitRate - a.cacheHitRate);
+		const best = sorted[0];
+		const worst = sorted[sorted.length - 1];
+		if (best.model === worst.model) return [];
+		const gapPP = (best.cacheHitRate - worst.cacheHitRate) * 100;
+		const severity = gapPP > 20 ? "warning" : "info";
+		const actionTarget = worst.model;
+		const id = this._makeId("per_model_comparison", storyKey, actionTarget, 0);
+		return [{
+			id,
+			storyKey,
+			sprintId,
+			ruleId: "per_model_comparison",
+			severity,
+			title: `Underperforming model: ${worst.model}`,
+			description: `Model "${worst.model}" has a cache hit rate of ${(worst.cacheHitRate * 100).toFixed(1)}% vs. "${best.model}" at ${(best.cacheHitRate * 100).toFixed(1)}% (gap: ${gapPP.toFixed(1)} percentage points). Consider routing tasks to the higher-performing model.`,
+			actionTarget,
+			generatedAt
+		}];
+	}
+	_isToolNameMatch(span) {
+		const toolName = span.attributes?.["tool.name"];
+		return toolName === "bash" || toolName === "execute_command" || span.name === "bash" || span.name === "execute_command" || span.operationName === "bash" || span.operationName === "execute_command";
+	}
+};
+
+//#endregion
+//#region src/modules/telemetry/turn-analyzer.ts
+var TurnAnalyzer = class {
+	_logger;
+	constructor(logger$27) {
+		this._logger = logger$27;
+	}
+	/**
+	* Analyze a list of NormalizedSpan records and produce TurnAnalysis[].
+	*
+	* Returns an empty array immediately when spans is empty.
+	*
+	* @param spans - All spans for a story (root and child spans mixed)
+	*/
+	analyze(spans) {
+		if (spans.length === 0) return [];
+		const allSpanIds = new Set(spans.map((s) => s.spanId));
+		const rootSpans = spans.filter((s) => !s.parentSpanId || !allSpanIds.has(s.parentSpanId));
+		const ordered = [...rootSpans].sort((a, b) => a.startTime - b.startTime);
+		const childIndex = new Map();
+		for (const span of spans) if (span.parentSpanId && allSpanIds.has(span.parentSpanId)) {
+			const children = childIndex.get(span.parentSpanId) ?? [];
+			children.push(span);
+			childIndex.set(span.parentSpanId, children);
+		}
+		let runningContext = 0;
+		const turns = ordered.map((span, idx) => {
+			const prevContext = runningContext;
+			runningContext += span.inputTokens;
+			const freshTokens = span.inputTokens - span.cacheReadTokens;
+			const cacheHitRate = span.inputTokens > 0 ? span.cacheReadTokens / span.inputTokens : 0;
+			const childSpanSummaries = (childIndex.get(span.spanId) ?? []).map((child) => ({
+				spanId: child.spanId,
+				name: child.name,
+				toolName: child.attributes?.["tool.name"],
+				inputTokens: child.inputTokens,
+				outputTokens: child.outputTokens,
+				durationMs: child.durationMs
+			}));
+			return {
+				spanId: span.spanId,
+				turnNumber: idx + 1,
+				name: span.name,
+				timestamp: span.startTime,
+				source: span.source,
+				model: span.model,
+				inputTokens: span.inputTokens,
+				outputTokens: span.outputTokens,
+				cacheReadTokens: span.cacheReadTokens,
+				freshTokens,
+				cacheHitRate,
+				costUsd: span.costUsd,
+				durationMs: span.durationMs,
+				contextSize: runningContext,
+				contextDelta: runningContext - prevContext,
+				toolName: span.attributes?.["tool.name"],
+				isContextSpike: false,
+				childSpans: childSpanSummaries
+			};
+		});
+		const avg = turns.reduce((sum, t) => sum + t.inputTokens, 0) / turns.length;
+		for (const turn of turns) turn.isContextSpike = avg > 0 && turn.inputTokens > 2 * avg;
+		this._logger.debug({
+			turnCount: turns.length,
+			avg
+		}, "TurnAnalyzer.analyze complete");
+		return turns;
+	}
+};
+
+//#endregion
+//#region src/modules/telemetry/cost-table.ts
+/**
+* Per-million-token pricing for known LLM models.
+* All prices are in USD.
+*/
+const COST_TABLE = {
+	"claude-3-opus-20240229": {
+		inputPerMToken: 15,
+		outputPerMToken: 75,
+		cacheReadPerMToken: 1.5,
+		cacheCreationPerMToken: 18.75
+	},
+	"claude-3-5-sonnet-20241022": {
+		inputPerMToken: 3,
+		outputPerMToken: 15,
+		cacheReadPerMToken: .3,
+		cacheCreationPerMToken: 3.75
+	},
+	"claude-3-5-haiku-20241022": {
+		inputPerMToken: .8,
+		outputPerMToken: 4,
+		cacheReadPerMToken: .08,
+		cacheCreationPerMToken: 1
+	},
+	"claude-3-haiku-20240307": {
+		inputPerMToken: .25,
+		outputPerMToken: 1.25,
+		cacheReadPerMToken: .03,
+		cacheCreationPerMToken: .3
+	},
+	"claude-3-sonnet-20240229": {
+		inputPerMToken: 3,
+		outputPerMToken: 15,
+		cacheReadPerMToken: .3,
+		cacheCreationPerMToken: 3.75
+	},
+	"gpt-4": {
+		inputPerMToken: 30,
+		outputPerMToken: 60,
+		cacheReadPerMToken: 3,
+		cacheCreationPerMToken: 30
+	},
+	"gpt-4-turbo": {
+		inputPerMToken: 10,
+		outputPerMToken: 30,
+		cacheReadPerMToken: 1,
+		cacheCreationPerMToken: 10
+	},
+	"gpt-3.5-turbo": {
+		inputPerMToken: .5,
+		outputPerMToken: 1.5,
+		cacheReadPerMToken: .05,
+		cacheCreationPerMToken: .5
+	}
+};
+/**
+* Resolve a model string to a key in COST_TABLE.
+* Returns the matched key, or undefined if not found.
+*
+* Performs exact match first, then case-insensitive substring match.
+*/
+function resolveModel$1(model) {
+	if (model in COST_TABLE) return model;
+	const lower = model.toLowerCase();
+	for (const key of Object.keys(COST_TABLE)) if (key.toLowerCase() === lower) return key;
+	for (const key of Object.keys(COST_TABLE)) if (lower.includes(key.toLowerCase()) || key.toLowerCase().includes(lower)) return key;
+	return void 0;
+}
+/**
+* Estimate the cost in USD for a set of token counts and a model identifier.
+*
+* - Uses `cacheReadPerMToken` from the table directly (already discounted).
+* - Returns 0 for unknown models without throwing.
+*
+* @param model - Model identifier string (exact or fuzzy match against COST_TABLE)
+* @param tokens - Token counts object
+* @returns Estimated cost in USD
+*/
+function estimateCost(model, tokens) {
+	const resolvedKey = resolveModel$1(model);
+	if (resolvedKey === void 0) return 0;
+	const pricing = COST_TABLE[resolvedKey];
+	const perM = 1e6;
+	const inputCost = tokens.input / perM * pricing.inputPerMToken;
+	const outputCost = tokens.output / perM * pricing.outputPerMToken;
+	const cacheReadCost = tokens.cacheRead / perM * pricing.cacheReadPerMToken;
+	const cacheCreationCost = tokens.cacheCreation / perM * pricing.cacheCreationPerMToken;
+	return inputCost + outputCost + cacheReadCost + cacheCreationCost;
+}
+
+//#endregion
+//#region src/modules/telemetry/timestamp-normalizer.ts
+/**
+* Timestamp normalization for OTLP telemetry payloads.
+*
+* OTLP payloads use nanosecond integers for timestamps (e.g. `startTimeUnixNano`).
+* Claude Code and other providers may emit timestamps in various formats.
+*
+* `normalizeTimestamp()` accepts any unknown value and returns a Unix millisecond
+* number. Null/undefined/unparseable inputs fall back to `Date.now()`.
+*
+* Detection order (after ISO string check):
+*   1. Nanoseconds  (>= 1e18)
+*   2. Microseconds (>= 1e15)
+*   3. Milliseconds (>= 1e12)
+*   4. Seconds      (< 1e12)
+*/
+/**
+* Normalize any timestamp value to Unix milliseconds.
+*
+* Handles:
+*   - ISO 8601 strings (e.g. "2024-03-08T12:00:00Z")
+*   - Nanosecond integers or numeric strings (>= 1e18)
+*   - Microsecond integers or numeric strings (>= 1e15)
+*   - Millisecond integers or numeric strings (>= 1e12)
+*   - Second integers or numeric strings (< 1e12)
+*   - BigInt string values from OTLP `startTimeUnixNano` (e.g. "1709900000000000000")
+*   - null / undefined / unparseable → falls back to Date.now()
+*
+* @param value - Raw timestamp value of unknown type
+* @returns Unix millisecond timestamp
+*/
+function normalizeTimestamp(value) {
+	if (value === null || value === void 0) return Date.now();
+	if (typeof value === "string") {
+		if (isIsoDateString(value)) {
+			const parsed = Date.parse(value);
+			if (!isNaN(parsed)) return parsed;
+		}
+		const trimmed = value.trim();
+		if (/^\d+$/.test(trimmed)) try {
+			const big = BigInt(trimmed);
+			return bigIntToMillis(big);
+		} catch {}
+		return Date.now();
+	}
+	if (typeof value === "bigint") return bigIntToMillis(value);
+	if (typeof value === "number") {
+		if (!isFinite(value) || isNaN(value)) return Date.now();
+		return numericToMillis(value);
+	}
+	return Date.now();
+}
+/**
+* Returns true if the string looks like an ISO 8601 date string
+* (contains letters or dashes/colons in date-like positions).
+*/
+function isIsoDateString(value) {
+	return /^\d{4}-\d{2}-\d{2}/.test(value) || /Z$/.test(value) || /[+-]\d{2}:\d{2}$/.test(value) || value.includes("T");
+}
+/**
+* Convert a BigInt nanosecond/microsecond/millisecond/second value to milliseconds.
+*/
+function bigIntToMillis(value) {
+	const NS_THRESHOLD = BigInt("1000000000000000000");
+	const US_THRESHOLD = BigInt("1000000000000000");
+	const MS_THRESHOLD = BigInt("1000000000000");
+	if (value >= NS_THRESHOLD) return Number(value / BigInt(1e6));
+	else if (value >= US_THRESHOLD) return Number(value / BigInt(1e3));
+	else if (value >= MS_THRESHOLD) return Number(value);
+	else return Number(value) * 1e3;
+}
+/**
+* Convert a numeric value to milliseconds based on magnitude.
+*/
+function numericToMillis(value) {
+	if (value >= 1e18) return Math.floor(value / 1e6);
+	else if (value >= 1e15) return Math.floor(value / 1e3);
+	else if (value >= 1e12) return Math.floor(value);
+	else return Math.floor(value * 1e3);
+}
+
+//#endregion
+//#region src/modules/telemetry/token-extractor.ts
+/**
+* Patterns for matching attribute keys to token fields.
+* Each pattern is checked case-insensitively via substring match.
+*
+* IMPORTANT: more-specific patterns (cacheRead, cacheCreation) MUST come first
+* so that keys like `cache_read_input_tokens` match `cache_read` before `input_token`.
+*/
+const TOKEN_PATTERNS = {
+	cacheRead: ["cache_read"],
+	cacheCreation: ["cache_creation", "cache_write"],
+	input: ["input_token", "prompt_token"],
+	output: ["output_token", "completion_token"]
+};
+/**
+* Extract token counts from an OTLP attributes array.
+*
+* Matches attribute keys case-insensitively against known patterns.
+* The first matching value for each field wins.
+*
+* @param attributes - Array of OTLP attribute entries
+* @returns Partial token counts (only fields found in attributes)
+*/
+function extractTokensFromAttributes(attributes) {
+	if (!Array.isArray(attributes) || attributes.length === 0) return {};
+	const result = {};
+	for (const attr of attributes) {
+		if (!attr?.key || !attr?.value) continue;
+		const keyLower = attr.key.toLowerCase();
+		const numValue = resolveAttrValue(attr.value);
+		if (numValue === void 0) continue;
+		let matched = false;
+		for (const [field, patterns] of Object.entries(TOKEN_PATTERNS)) {
+			if (matched) break;
+			if (result[field] !== void 0) continue;
+			for (const pattern of patterns) if (keyLower.includes(pattern)) {
+				result[field] = numValue;
+				matched = true;
+				break;
+			}
+		}
+	}
+	return result;
+}
+/**
+* Extract token counts from a JSON body string via recursive search.
+*
+* Parses the body as JSON and recursively walks the object tree up to
+* depth 4, looking for keys matching token patterns.
+*
+* @param body - Raw body string (may be JSON)
+* @returns Partial token counts found in body
+*/
+function extractTokensFromBody(body) {
+	if (!body || typeof body !== "string") return {};
+	let parsed;
+	try {
+		parsed = JSON.parse(body);
+	} catch {
+		return {};
+	}
+	return searchObjectForTokens(parsed, 0);
+}
+/**
+* Merge attribute-derived and body-derived token counts.
+*
+* Attributes take priority over body for each field.
+* Missing fields default to 0.
+*
+* @param fromAttributes - Token counts from attributes (higher priority)
+* @param fromBody - Token counts from body JSON (lower priority)
+* @returns Complete TokenCounts with all fields
+*/
+function mergeTokenCounts(fromAttributes, fromBody) {
+	return {
+		input: fromAttributes.input ?? fromBody.input ?? 0,
+		output: fromAttributes.output ?? fromBody.output ?? 0,
+		cacheRead: fromAttributes.cacheRead ?? fromBody.cacheRead ?? 0,
+		cacheCreation: fromAttributes.cacheCreation ?? fromBody.cacheCreation ?? 0
+	};
+}
+/**
+* Resolve an OTLP attribute value to a number.
+* OTLP integer values arrive as strings (e.g. `"intValue": "2048"`).
+*/
+function resolveAttrValue(value) {
+	if (value.intValue !== void 0) {
+		const n = Number(value.intValue);
+		return isFinite(n) ? n : void 0;
+	}
+	if (value.doubleValue !== void 0) {
+		const n = Number(value.doubleValue);
+		return isFinite(n) ? n : void 0;
+	}
+	if (value.stringValue !== void 0) {
+		const n = Number(value.stringValue);
+		if (!isNaN(n) && isFinite(n)) return n;
+	}
+	return void 0;
+}
+/**
+* Recursively search an object for token count fields up to maxDepth.
+*/
+function searchObjectForTokens(obj, depth) {
+	if (depth >= 4 || obj === null || typeof obj !== "object") return {};
+	const result = {};
+	if (Array.isArray(obj)) {
+		for (const item of obj) {
+			const found = searchObjectForTokens(item, depth + 1);
+			mergePartialInto(result, found);
+		}
+		return result;
+	}
+	const record = obj;
+	for (const [key, val] of Object.entries(record)) {
+		const keyLower = key.toLowerCase();
+		let keyMatched = false;
+		for (const [field, patterns] of Object.entries(TOKEN_PATTERNS)) {
+			if (keyMatched) break;
+			if (result[field] !== void 0) continue;
+			for (const pattern of patterns) if (keyLower.includes(pattern)) {
+				const num = typeof val === "number" ? val : typeof val === "string" ? Number(val) : NaN;
+				if (!isNaN(num) && isFinite(num)) result[field] = num;
+				keyMatched = true;
+				break;
+			}
+		}
+		if (val !== null && typeof val === "object") {
+			const nested = searchObjectForTokens(val, depth + 1);
+			mergePartialInto(result, nested);
+		}
+	}
+	return result;
+}
+/**
+* Merge source into target, only filling missing fields.
+*/
+function mergePartialInto(target, source) {
+	if (target.input === void 0 && source.input !== void 0) target.input = source.input;
+	if (target.output === void 0 && source.output !== void 0) target.output = source.output;
+	if (target.cacheRead === void 0 && source.cacheRead !== void 0) target.cacheRead = source.cacheRead;
+	if (target.cacheCreation === void 0 && source.cacheCreation !== void 0) target.cacheCreation = source.cacheCreation;
+}
+
+//#endregion
+//#region src/modules/telemetry/normalizer.ts
+/**
+* Extract a string value from an OTLP attribute array by key.
+*/
+function getAttrString(attrs, key) {
+	if (!Array.isArray(attrs)) return void 0;
+	const entry = attrs.find((a) => a?.key === key);
+	if (!entry?.value) return void 0;
+	return entry.value.stringValue ?? (entry.value.intValue !== void 0 ? String(entry.value.intValue) : void 0) ?? (entry.value.doubleValue !== void 0 ? String(entry.value.doubleValue) : void 0);
+}
+/**
+* Determine source from resource attributes service.name.
+*/
+function resolveSource(resourceAttrs) {
+	const serviceName = getAttrString(resourceAttrs, "service.name");
+	if (!serviceName) return "unknown";
+	const lower = serviceName.toLowerCase();
+	if (lower.includes("claude")) return "claude-code";
+	if (lower.includes("codex") || lower.includes("openai")) return "codex";
+	if (lower.includes("local")) return "local-llm";
+	return serviceName;
+}
+/**
+* Resolve model from span attributes (tries multiple known keys).
+*/
+function resolveModel(attrs) {
+	const modelKeys = [
+		"gen_ai.request.model",
+		"gen_ai.response.model",
+		"llm.request.model",
+		"anthropic.model",
+		"openai.model",
+		"model"
+	];
+	for (const key of modelKeys) {
+		const val = getAttrString(attrs, key);
+		if (val) return val;
+	}
+	return void 0;
+}
+/**
+* Resolve provider from span attributes.
+*/
+function resolveProvider(attrs, source) {
+	const providerVal = getAttrString(attrs, "gen_ai.system");
+	if (providerVal) return providerVal;
+	if (source === "claude-code") return "anthropic";
+	if (source === "codex") return "openai";
+	return void 0;
+}
+/**
+* Extract the body string from a log record body field.
+*/
+function extractBodyString(body) {
+	if (!body) return void 0;
+	if (typeof body === "string") return body;
+	if (typeof body === "object" && body.stringValue) return body.stringValue;
+	return void 0;
+}
+/**
+* Generate a unique log record ID.
+*/
+let _logIdCounter = 0;
+function generateLogId() {
+	return `log-${Date.now()}-${++_logIdCounter}`;
+}
+/**
+* Transforms raw OTLP payloads into normalized telemetry models.
+*
+* Inject an `ILogger` (pino-compatible) for structured logging.
+* All public methods return empty arrays on any error — never throw.
+*/
+var TelemetryNormalizer = class {
+	_logger;
+	constructor(logger$27) {
+		this._logger = logger$27;
+	}
+	/**
+	* Normalize a raw OTLP trace payload into an array of `NormalizedSpan`.
+	*
+	* @param raw - Raw OTLP trace payload (resourceSpans structure)
+	* @returns Array of normalized spans; empty on error or empty input
+	*/
+	normalizeSpan(raw) {
+		try {
+			return this._normalizeSpanInternal(raw);
+		} catch (err) {
+			this._logger.warn({ err }, "TelemetryNormalizer.normalizeSpan: unexpected error");
+			return [];
+		}
+	}
+	_normalizeSpanInternal(raw) {
+		if (!raw || typeof raw !== "object") return [];
+		const payload = raw;
+		if (!Array.isArray(payload.resourceSpans)) return [];
+		const results = [];
+		for (const resourceSpan of payload.resourceSpans) {
+			if (!resourceSpan) continue;
+			const resourceAttrs = resourceSpan.resource?.attributes;
+			const source = resolveSource(resourceAttrs);
+			if (!Array.isArray(resourceSpan.scopeSpans)) continue;
+			for (const scopeSpan of resourceSpan.scopeSpans) {
+				if (!Array.isArray(scopeSpan?.spans)) continue;
+				for (const span of scopeSpan.spans) {
+					if (!span) continue;
+					try {
+						const normalized = this._normalizeOneSpan(span, resourceAttrs, source);
+						results.push(normalized);
+					} catch (err) {
+						this._logger.warn({
+							err,
+							spanId: span.spanId
+						}, "Failed to normalize span — skipping");
+					}
+				}
+			}
+		}
+		return results;
+	}
+	_normalizeOneSpan(span, resourceAttrs, source) {
+		const spanId = span.spanId ?? "";
+		const traceId = span.traceId ?? "";
+		const name = span.name ?? "";
+		const model = resolveModel(span.attributes) ?? resolveModel(resourceAttrs);
+		const provider = resolveProvider(span.attributes, source);
+		const operationName = getAttrString(span.attributes, "gen_ai.operation.name") ?? name;
+		const startTime = normalizeTimestamp(span.startTimeUnixNano);
+		const endTime = span.endTimeUnixNano ? normalizeTimestamp(span.endTimeUnixNano) : void 0;
+		const durationMs = endTime !== void 0 ? endTime - startTime : 0;
+		const fromAttrs = extractTokensFromAttributes(span.attributes);
+		const bodyStr = getAttrString(span.attributes, "llm.response.body") ?? getAttrString(span.attributes, "gen_ai.response.body");
+		const fromBody = extractTokensFromBody(bodyStr);
+		const tokens = mergeTokenCounts(fromAttrs, fromBody);
+		const storyKey = getAttrString(span.attributes, "substrate.story_key") ?? getAttrString(resourceAttrs, "substrate.story_key");
+		const costUsd = model ? estimateCost(model, tokens) : 0;
+		const attributesRecord = {};
+		if (Array.isArray(span.attributes)) {
+			for (const attr of span.attributes) if (attr?.key) attributesRecord[attr.key] = attr.value?.stringValue ?? attr.value?.intValue ?? attr.value?.doubleValue ?? attr.value?.boolValue;
+		}
+		return {
+			spanId,
+			traceId,
+			parentSpanId: span.parentSpanId,
+			name,
+			source,
+			model,
+			provider,
+			operationName,
+			storyKey,
+			inputTokens: tokens.input,
+			outputTokens: tokens.output,
+			cacheReadTokens: tokens.cacheRead,
+			cacheCreationTokens: tokens.cacheCreation,
+			costUsd,
+			durationMs,
+			startTime,
+			endTime,
+			attributes: attributesRecord,
+			events: span.events
+		};
+	}
+	/**
+	* Normalize a raw OTLP log payload into an array of `NormalizedLog`.
+	*
+	* @param raw - Raw OTLP log payload (resourceLogs structure)
+	* @returns Array of normalized logs; empty on error or empty input
+	*/
+	normalizeLog(raw) {
+		try {
+			return this._normalizeLogInternal(raw);
+		} catch (err) {
+			this._logger.warn({ err }, "TelemetryNormalizer.normalizeLog: unexpected error");
+			return [];
+		}
+	}
+	_normalizeLogInternal(raw) {
+		if (!raw || typeof raw !== "object") return [];
+		const payload = raw;
+		if (!Array.isArray(payload.resourceLogs)) return [];
+		const results = [];
+		for (const resourceLog of payload.resourceLogs) {
+			if (!resourceLog) continue;
+			const resourceAttrs = resourceLog.resource?.attributes;
+			if (!Array.isArray(resourceLog.scopeLogs)) continue;
+			for (const scopeLog of resourceLog.scopeLogs) {
+				if (!Array.isArray(scopeLog?.logRecords)) continue;
+				for (const record of scopeLog.logRecords) {
+					if (!record) continue;
+					try {
+						const normalized = this._normalizeOneLog(record, resourceAttrs);
+						results.push(normalized);
+					} catch (err) {
+						this._logger.warn({ err }, "Failed to normalize log record — skipping");
+					}
+				}
+			}
+		}
+		return results;
+	}
+	_normalizeOneLog(record, resourceAttrs) {
+		const logId = record.logRecordId ?? generateLogId();
+		const timestamp = normalizeTimestamp(record.timeUnixNano);
+		const bodyStr = extractBodyString(record.body);
+		const fromAttrs = extractTokensFromAttributes(record.attributes);
+		const fromBody = extractTokensFromBody(bodyStr);
+		const tokens = mergeTokenCounts(fromAttrs, fromBody);
+		const eventName = getAttrString(record.attributes, "event.name") ?? getAttrString(record.attributes, "gen_ai.event.name") ?? getAttrString(record.attributes, "event_name");
+		const sessionId = getAttrString(record.attributes, "session.id") ?? getAttrString(record.attributes, "gen_ai.session.id") ?? getAttrString(resourceAttrs, "session.id");
+		const toolName = getAttrString(record.attributes, "tool.name") ?? getAttrString(record.attributes, "gen_ai.tool.name") ?? getAttrString(record.attributes, "tool_name");
+		const model = resolveModel(record.attributes) ?? resolveModel(resourceAttrs);
+		const storyKey = getAttrString(record.attributes, "substrate.story_key") ?? getAttrString(resourceAttrs, "substrate.story_key");
+		const costUsd = model ? estimateCost(model, tokens) : 0;
+		return {
+			logId,
+			traceId: record.traceId,
+			spanId: record.spanId,
+			timestamp,
+			severity: record.severityText,
+			body: bodyStr,
+			eventName,
+			sessionId,
+			toolName,
+			inputTokens: tokens.input,
+			outputTokens: tokens.output,
+			cacheReadTokens: tokens.cacheRead,
+			costUsd,
+			model,
+			storyKey
+		};
+	}
+};
+
+//#endregion
+//#region src/modules/telemetry/telemetry-pipeline.ts
+const logger$6 = createLogger("telemetry:pipeline");
+/**
+* Wires together the full OTLP analysis and persistence pipeline.
+*
+* Usage:
+*   const pipeline = new TelemetryPipeline(deps)
+*   await pipeline.processBatch(items)
+*/
+var TelemetryPipeline = class {
+	_normalizer;
+	_turnAnalyzer;
+	_categorizer;
+	_consumerAnalyzer;
+	_efficiencyScorer;
+	_recommender;
+	_persistence;
+	constructor(deps) {
+		this._normalizer = deps.normalizer;
+		this._turnAnalyzer = deps.turnAnalyzer;
+		this._categorizer = deps.categorizer;
+		this._consumerAnalyzer = deps.consumerAnalyzer;
+		this._efficiencyScorer = deps.efficiencyScorer;
+		this._recommender = deps.recommender;
+		this._persistence = deps.persistence;
+	}
+	/**
+	* Process a batch of raw OTLP payloads through the full analysis pipeline.
+	*
+	* Each payload is normalized independently. Spans are then grouped by storyKey
+	* for per-story analysis. Items that fail normalization are skipped with a warning.
+	*/
+	async processBatch(items) {
+		if (items.length === 0) return;
+		logger$6.debug({ count: items.length }, "TelemetryPipeline.processBatch start");
+		const allSpans = [];
+		const allLogs = [];
+		for (const item of items) {
+			try {
+				const spans = this._normalizer.normalizeSpan(item.body);
+				allSpans.push(...spans);
+			} catch (err) {
+				logger$6.warn({ err }, "TelemetryPipeline: normalizeSpan failed — skipping payload");
+			}
+			try {
+				const logs = this._normalizer.normalizeLog(item.body);
+				allLogs.push(...logs);
+			} catch (err) {
+				logger$6.warn({ err }, "TelemetryPipeline: normalizeLog failed — skipping payload");
+			}
+		}
+		logger$6.debug({
+			spans: allSpans.length,
+			logs: allLogs.length
+		}, "TelemetryPipeline: normalized batch");
+		if (allSpans.length === 0) {
+			logger$6.debug("TelemetryPipeline: no spans normalized from batch");
+			return;
+		}
+		const spansByStory = new Map();
+		const unknownStoryKey = "__unknown__";
+		for (const span of allSpans) {
+			const key = span.storyKey ?? unknownStoryKey;
+			const existing = spansByStory.get(key);
+			if (existing !== void 0) existing.push(span);
+			else spansByStory.set(key, [span]);
+		}
+		for (const [storyKey, spans] of spansByStory) {
+			if (storyKey === unknownStoryKey) {
+				logger$6.debug({ spanCount: spans.length }, "TelemetryPipeline: spans without storyKey — skipping analysis");
+				continue;
+			}
+			try {
+				await this._processStory(storyKey, spans);
+			} catch (err) {
+				logger$6.warn({
+					err,
+					storyKey
+				}, "TelemetryPipeline: story processing failed — skipping");
+			}
+		}
+		logger$6.debug({ storyCount: spansByStory.size }, "TelemetryPipeline.processBatch complete");
+	}
+	async _processStory(storyKey, spans) {
+		const turns = this._turnAnalyzer.analyze(spans);
+		const categories = this._categorizer.computeCategoryStats(spans, turns);
+		const consumers = this._consumerAnalyzer.analyze(spans);
+		const efficiencyScore = this._efficiencyScorer.score(storyKey, turns);
+		const generatedAt = new Date().toISOString();
+		const context = {
+			storyKey,
+			generatedAt,
+			turns,
+			categories,
+			consumers,
+			efficiencyScore,
+			allSpans: spans
+		};
+		const recommendations = this._recommender.analyze(context);
+		await Promise.all([
+			turns.length > 0 ? this._persistence.storeTurnAnalysis(storyKey, turns).catch((err) => logger$6.warn({
+				err,
+				storyKey
+			}, "Failed to store turn analysis")) : Promise.resolve(),
+			categories.length > 0 ? this._persistence.storeCategoryStats(storyKey, categories).catch((err) => logger$6.warn({
+				err,
+				storyKey
+			}, "Failed to store category stats")) : Promise.resolve(),
+			consumers.length > 0 ? this._persistence.storeConsumerStats(storyKey, consumers).catch((err) => logger$6.warn({
+				err,
+				storyKey
+			}, "Failed to store consumer stats")) : Promise.resolve(),
+			this._persistence.storeEfficiencyScore(efficiencyScore).catch((err) => logger$6.warn({
+				err,
+				storyKey
+			}, "Failed to store efficiency score")),
+			recommendations.length > 0 ? this._persistence.saveRecommendations(storyKey, recommendations).catch((err) => logger$6.warn({
+				err,
+				storyKey
+			}, "Failed to save recommendations")) : Promise.resolve()
+		]);
+		logger$6.info({
+			storyKey,
+			turns: turns.length,
+			compositeScore: efficiencyScore.compositeScore,
+			recommendations: recommendations.length
+		}, "TelemetryPipeline: story analysis complete");
+	}
+};
+
+//#endregion
+//#region src/modules/implementation-orchestrator/orchestrator-impl.ts
+function createPauseGate() {
 	let resolve$2;
 	const promise = new Promise((res) => {
 		resolve$2 = res;
@@ -10155,7 +11533,7 @@ function buildTargetedFilesContent(issueList) {
 */
 function createImplementationOrchestrator(deps) {
 	const { db, pack, contextCompiler, dispatcher, eventBus, config, projectRoot, tokenCeilings, stateStore, telemetryPersistence, ingestionServer } = deps;
-	const logger$26 = createLogger("implementation-orchestrator");
+	const logger$27 = createLogger("implementation-orchestrator");
 	let _state = "IDLE";
 	let _startedAt;
 	let _completedAt;
@@ -10201,7 +11579,7 @@ function createImplementationOrchestrator(deps) {
 		const nowMs = Date.now();
 		for (const [phase, startMs] of starts) {
 			const endMs = ends?.get(phase);
-			if (endMs === void 0) logger$26.warn({
+			if (endMs === void 0) logger$27.warn({
 				storyKey,
 				phase
 			}, "Phase has no end time — story may have errored mid-phase. Duration capped to now() and may be inflated.");
@@ -10248,7 +11626,7 @@ function createImplementationOrchestrator(deps) {
 				recordedAt: completedAt,
 				timestamp: completedAt
 			}).catch((storeErr) => {
-				logger$26.warn({
+				logger$27.warn({
 					err: storeErr,
 					storyKey
 				}, "Failed to record metric to StateStore (best-effort)");
@@ -10270,7 +11648,7 @@ function createImplementationOrchestrator(deps) {
 					rationale: `Story ${storyKey} completed with result=${result} in ${wallClockSeconds}s. Tokens: ${tokenAgg.input}+${tokenAgg.output}. Review cycles: ${reviewCycles}.`
 				});
 			} catch (decisionErr) {
-				logger$26.warn({
+				logger$27.warn({
 					err: decisionErr,
 					storyKey
 				}, "Failed to write story-metrics decision (best-effort)");
@@ -10298,13 +11676,13 @@ function createImplementationOrchestrator(deps) {
 					dispatches: _storyDispatches.get(storyKey) ?? 0
 				});
 			} catch (emitErr) {
-				logger$26.warn({
+				logger$27.warn({
 					err: emitErr,
 					storyKey
 				}, "Failed to emit story:metrics event (best-effort)");
 			}
 		} catch (err) {
-			logger$26.warn({
+			logger$27.warn({
 				err,
 				storyKey
 			}, "Failed to write story metrics (best-effort)");
@@ -10333,7 +11711,7 @@ function createImplementationOrchestrator(deps) {
 				rationale: `Story ${storyKey} ${outcome} after ${reviewCycles} review cycle(s).`
 			});
 		} catch (err) {
-			logger$26.warn({
+			logger$27.warn({
 				err,
 				storyKey
 			}, "Failed to write story-outcome decision (best-effort)");
@@ -10359,7 +11737,7 @@ function createImplementationOrchestrator(deps) {
 				rationale: `Escalation diagnosis for ${payload.storyKey}: ${diagnosis.recommendedAction} — ${diagnosis.rationale}`
 			});
 		} catch (err) {
-			logger$26.warn({
+			logger$27.warn({
 				err,
 				storyKey: payload.storyKey
 			}, "Failed to persist escalation diagnosis (best-effort)");
@@ -10408,7 +11786,7 @@ function createImplementationOrchestrator(deps) {
 		const existing = _stories.get(storyKey);
 		if (existing !== void 0) {
 			Object.assign(existing, updates);
-			persistStoryState(storyKey, existing).catch((err) => logger$26.warn({
+			persistStoryState(storyKey, existing).catch((err) => logger$27.warn({
 				err,
 				storyKey
 			}, "StateStore write failed after updateStory"));
@@ -10417,12 +11795,12 @@ function createImplementationOrchestrator(deps) {
 					storyKey,
 					conflict: err
 				});
-				else logger$26.warn({
+				else logger$27.warn({
 					err,
 					storyKey
 				}, "mergeStory failed");
 			});
-			else if (updates.phase === "ESCALATED") stateStore?.rollbackStory(storyKey).catch((err) => logger$26.warn({
+			else if (updates.phase === "ESCALATED") stateStore?.rollbackStory(storyKey).catch((err) => logger$27.warn({
 				err,
 				storyKey
 			}, "rollbackStory failed — branch may persist"));
@@ -10449,7 +11827,7 @@ function createImplementationOrchestrator(deps) {
 			};
 			await stateStore.setStoryState(storyKey, record);
 		} catch (err) {
-			logger$26.warn({
+			logger$27.warn({
 				err,
 				storyKey
 			}, "StateStore.setStoryState failed (best-effort)");
@@ -10465,7 +11843,7 @@ function createImplementationOrchestrator(deps) {
 				token_usage_json: serialized
 			});
 		} catch (err) {
-			logger$26.warn({ err }, "Failed to persist orchestrator state");
+			logger$27.warn({ err }, "Failed to persist orchestrator state");
 		}
 	}
 	function recordProgress() {
@@ -10512,7 +11890,7 @@ function createImplementationOrchestrator(deps) {
 				}
 				if (childActive) {
 					_lastProgressTs = Date.now();
-					logger$26.debug({
+					logger$27.debug({
 						storyKey: key,
 						phase: s.phase,
 						childPids
@@ -10521,7 +11899,7 @@ function createImplementationOrchestrator(deps) {
 				}
 				_stalledStories.add(key);
 				_storiesWithStall.add(key);
-				logger$26.warn({
+				logger$27.warn({
 					storyKey: key,
 					phase: s.phase,
 					elapsedMs: elapsed,
@@ -10566,7 +11944,7 @@ function createImplementationOrchestrator(deps) {
 		for (let attempt = 0; attempt < MEMORY_PRESSURE_BACKOFF_MS.length; attempt++) {
 			const memState = dispatcher.getMemoryState();
 			if (!memState.isPressured) return true;
-			logger$26.warn({
+			logger$27.warn({
 				storyKey,
 				freeMB: memState.freeMB,
 				thresholdMB: memState.thresholdMB,
@@ -10586,11 +11964,11 @@ function createImplementationOrchestrator(deps) {
 	* exhausted retries the story is ESCALATED.
 	*/
 	async function processStory(storyKey) {
-		logger$26.info({ storyKey }, "Processing story");
+		logger$27.info({ storyKey }, "Processing story");
 		{
 			const memoryOk = await checkMemoryPressure(storyKey);
 			if (!memoryOk) {
-				logger$26.warn({ storyKey }, "Memory pressure exhausted — escalating story without dispatch");
+				logger$27.warn({ storyKey }, "Memory pressure exhausted — escalating story without dispatch");
 				const memPressureState = {
 					phase: "ESCALATED",
 					reviewCycles: 0,
@@ -10599,7 +11977,7 @@ function createImplementationOrchestrator(deps) {
 					completedAt: new Date().toISOString()
 				};
 				_stories.set(storyKey, memPressureState);
-				persistStoryState(storyKey, memPressureState).catch((err) => logger$26.warn({
+				persistStoryState(storyKey, memPressureState).catch((err) => logger$27.warn({
 					err,
 					storyKey
 				}, "StateStore write failed after memory-pressure escalation"));
@@ -10616,7 +11994,7 @@ function createImplementationOrchestrator(deps) {
 		}
 		await waitIfPaused();
 		if (_state !== "RUNNING") return;
-		stateStore?.branchForStory(storyKey).catch((err) => logger$26.warn({
+		stateStore?.branchForStory(storyKey).catch((err) => logger$27.warn({
 			err,
 			storyKey
 		}, "branchForStory failed — continuing without branch isolation"));
@@ -10633,14 +12011,14 @@ function createImplementationOrchestrator(deps) {
 			if (match) {
 				const candidatePath = join$1(artifactsDir, match);
 				const validation = await isValidStoryFile(candidatePath);
-				if (!validation.valid) logger$26.warn({
+				if (!validation.valid) logger$27.warn({
 					storyKey,
 					storyFilePath: candidatePath,
 					reason: validation.reason
 				}, `Existing story file for ${storyKey} is invalid (${validation.reason}) — re-creating`);
 				else {
 					storyFilePath = candidatePath;
-					logger$26.info({
+					logger$27.info({
 						storyKey,
 						storyFilePath
 					}, "Found existing story file — skipping create-story");
@@ -10689,7 +12067,7 @@ function createImplementationOrchestrator(deps) {
 					metadata: JSON.stringify({ storyKey })
 				});
 			} catch (tokenErr) {
-				logger$26.warn({
+				logger$27.warn({
 					storyKey,
 					err: tokenErr
 				}, "Failed to record create-story token usage");
@@ -10773,14 +12151,14 @@ function createImplementationOrchestrator(deps) {
 						...contract.transport !== void 0 ? { transport: contract.transport } : {}
 					})
 				});
-				logger$26.info({
+				logger$27.info({
 					storyKey,
 					contractCount: contracts.length,
 					contracts
 				}, "Stored interface contract declarations");
 			}
 		} catch (err) {
-			logger$26.warn({
+			logger$27.warn({
 				storyKey,
 				error: err instanceof Error ? err.message : String(err)
 			}, "Failed to parse interface contracts — continuing without contract declarations");
@@ -10808,10 +12186,10 @@ function createImplementationOrchestrator(deps) {
 			});
 			testPlanPhaseResult = testPlanResult.result;
 			testPlanTokenUsage = testPlanResult.tokenUsage;
-			if (testPlanResult.result === "success") logger$26.info({ storyKey }, "Test plan generated successfully");
-			else logger$26.warn({ storyKey }, "Test planning returned failed result — proceeding to dev-story without test plan");
+			if (testPlanResult.result === "success") logger$27.info({ storyKey }, "Test plan generated successfully");
+			else logger$27.warn({ storyKey }, "Test planning returned failed result — proceeding to dev-story without test plan");
 		} catch (err) {
-			logger$26.warn({
+			logger$27.warn({
 				storyKey,
 				err
 			}, "Test planning failed — proceeding to dev-story without test plan");
@@ -10827,7 +12205,7 @@ function createImplementationOrchestrator(deps) {
 				metadata: JSON.stringify({ storyKey })
 			});
 		} catch (tokenErr) {
-			logger$26.warn({
+			logger$27.warn({
 				storyKey,
 				err: tokenErr
 			}, "Failed to record test-plan token usage");
@@ -10850,7 +12228,7 @@ function createImplementationOrchestrator(deps) {
 			try {
 				storyContentForAnalysis = await readFile$1(storyFilePath ?? "", "utf-8");
 			} catch (err) {
-				logger$26.error({
+				logger$27.error({
 					storyKey,
 					storyFilePath,
 					error: err instanceof Error ? err.message : String(err)
@@ -10858,7 +12236,7 @@ function createImplementationOrchestrator(deps) {
 			}
 			const analysis = analyzeStoryComplexity(storyContentForAnalysis);
 			const batches = planTaskBatches(analysis);
-			logger$26.info({
+			logger$27.info({
 				storyKey,
 				estimatedScope: analysis.estimatedScope,
 				batchCount: batches.length,
@@ -10876,7 +12254,7 @@ function createImplementationOrchestrator(deps) {
 					if (_state !== "RUNNING") break;
 					const taskScope = batch.taskIds.map((id, i) => `T${id}: ${batch.taskTitles[i] ?? ""}`).join("\n");
 					const priorFiles = allFilesModified.size > 0 ? Array.from(allFilesModified) : void 0;
-					logger$26.info({
+					logger$27.info({
 						storyKey,
 						batchIndex: batch.batchIndex,
 						taskCount: batch.taskIds.length
@@ -10902,7 +12280,7 @@ function createImplementationOrchestrator(deps) {
 						});
 					} catch (batchErr) {
 						const errMsg = batchErr instanceof Error ? batchErr.message : String(batchErr);
-						logger$26.warn({
+						logger$27.warn({
 							storyKey,
 							batchIndex: batch.batchIndex,
 							error: errMsg
@@ -10922,7 +12300,7 @@ function createImplementationOrchestrator(deps) {
 						filesModified: batchFilesModified,
 						result: batchResult.result === "success" ? "success" : "failed"
 					};
-					logger$26.info(batchMetrics, "Batch dev-story metrics");
+					logger$27.info(batchMetrics, "Batch dev-story metrics");
 					for (const f of batchFilesModified) allFilesModified.add(f);
 					if (batchFilesModified.length > 0) batchFileGroups.push({
 						batchIndex: batch.batchIndex,
@@ -10944,13 +12322,13 @@ function createImplementationOrchestrator(deps) {
 							})
 						});
 					} catch (tokenErr) {
-						logger$26.warn({
+						logger$27.warn({
 							storyKey,
 							batchIndex: batch.batchIndex,
 							err: tokenErr
 						}, "Failed to record batch token usage");
 					}
-					if (batchResult.result === "failed") logger$26.warn({
+					if (batchResult.result === "failed") logger$27.warn({
 						storyKey,
 						batchIndex: batch.batchIndex,
 						error: batchResult.error
@@ -10990,7 +12368,7 @@ function createImplementationOrchestrator(deps) {
 						metadata: JSON.stringify({ storyKey })
 					});
 				} catch (tokenErr) {
-					logger$26.warn({
+					logger$27.warn({
 						storyKey,
 						err: tokenErr
 					}, "Failed to record dev-story token usage");
@@ -11002,7 +12380,7 @@ function createImplementationOrchestrator(deps) {
 				});
 				persistState();
 				if (devResult.result === "success") devStoryWasSuccess = true;
-				else logger$26.warn({
+				else logger$27.warn({
 					storyKey,
 					error: devResult.error,
 					filesModified: devFilesModified.length
@@ -11030,7 +12408,7 @@ function createImplementationOrchestrator(deps) {
 		if (devStoryWasSuccess) {
 			gitDiffFiles = checkGitDiffFiles(projectRoot ?? process.cwd());
 			if (gitDiffFiles.length === 0) {
-				logger$26.warn({ storyKey }, "Zero-diff detected after COMPLETE dev-story — no file changes in git working tree");
+				logger$27.warn({ storyKey }, "Zero-diff detected after COMPLETE dev-story — no file changes in git working tree");
 				eventBus.emit("orchestrator:zero-diff-escalation", {
 					storyKey,
 					reason: "zero-diff-on-complete"
@@ -11061,7 +12439,7 @@ function createImplementationOrchestrator(deps) {
 			});
 			if (buildVerifyResult.status === "passed") {
 				eventBus.emit("story:build-verification-passed", { storyKey });
-				logger$26.info({ storyKey }, "Build verification passed");
+				logger$27.info({ storyKey }, "Build verification passed");
 			} else if (buildVerifyResult.status === "failed" || buildVerifyResult.status === "timeout") {
 				const truncatedOutput = (buildVerifyResult.output ?? "").slice(0, 2e3);
 				const reason = buildVerifyResult.reason ?? "build-verification-failed";
@@ -11070,7 +12448,7 @@ function createImplementationOrchestrator(deps) {
 					exitCode: buildVerifyResult.exitCode ?? 1,
 					output: truncatedOutput
 				});
-				logger$26.warn({
+				logger$27.warn({
 					storyKey,
 					reason,
 					exitCode: buildVerifyResult.exitCode
@@ -11100,7 +12478,7 @@ function createImplementationOrchestrator(deps) {
 					storyKey
 				});
 				if (icResult.potentiallyAffectedTests.length > 0) {
-					logger$26.warn({
+					logger$27.warn({
 						storyKey,
 						modifiedInterfaces: icResult.modifiedInterfaces,
 						potentiallyAffectedTests: icResult.potentiallyAffectedTests
@@ -11146,7 +12524,7 @@ function createImplementationOrchestrator(deps) {
 						"NEEDS_MAJOR_REWORK": 2
 					};
 					for (const group of batchFileGroups) {
-						logger$26.info({
+						logger$27.info({
 							storyKey,
 							batchIndex: group.batchIndex,
 							fileCount: group.files.length
@@ -11185,7 +12563,7 @@ function createImplementationOrchestrator(deps) {
 						rawOutput: lastRawOutput,
 						tokenUsage: aggregateTokens
 					};
-					logger$26.info({
+					logger$27.info({
 						storyKey,
 						batchCount: batchFileGroups.length,
 						verdict: worstVerdict,
@@ -11223,7 +12601,7 @@ function createImplementationOrchestrator(deps) {
 						})
 					});
 				} catch (tokenErr) {
-					logger$26.warn({
+					logger$27.warn({
 						storyKey,
 						err: tokenErr
 					}, "Failed to record code-review token usage");
@@ -11231,7 +12609,7 @@ function createImplementationOrchestrator(deps) {
 				const isPhantomReview = reviewResult.dispatchFailed === true || reviewResult.verdict !== "SHIP_IT" && reviewResult.verdict !== "LGTM_WITH_NOTES" && (reviewResult.issue_list === void 0 || reviewResult.issue_list.length === 0) && reviewResult.error !== void 0;
 				if (isPhantomReview && !timeoutRetried) {
 					timeoutRetried = true;
-					logger$26.warn({
+					logger$27.warn({
 						storyKey,
 						reviewCycles,
 						error: reviewResult.error
@@ -11241,7 +12619,7 @@ function createImplementationOrchestrator(deps) {
 				verdict = reviewResult.verdict;
 				issueList = reviewResult.issue_list ?? [];
 				if (verdict === "NEEDS_MAJOR_REWORK" && reviewCycles > 0 && previousIssueList.length > 0 && issueList.length < previousIssueList.length) {
-					logger$26.info({
+					logger$27.info({
 						storyKey,
 						originalVerdict: verdict,
 						issuesBefore: previousIssueList.length,
@@ -11277,7 +12655,7 @@ function createImplementationOrchestrator(deps) {
 					if (_decomposition !== void 0) parts.push(`decomposed: ${_decomposition.batchCount} batches`);
 					parts.push(`${fileCount} files`);
 					parts.push(`${totalTokensK} tokens`);
-					logger$26.info({
+					logger$27.info({
 						storyKey,
 						verdict,
 						agentVerdict: reviewResult.agentVerdict
@@ -11326,9 +12704,9 @@ function createImplementationOrchestrator(deps) {
 						}),
 						rationale: `Advisory notes from LGTM_WITH_NOTES review of ${storyKey}`
 					});
-					logger$26.info({ storyKey }, "Advisory notes persisted to decision store");
+					logger$27.info({ storyKey }, "Advisory notes persisted to decision store");
 				} catch (advisoryErr) {
-					logger$26.warn({
+					logger$27.warn({
 						storyKey,
 						error: advisoryErr instanceof Error ? advisoryErr.message : String(advisoryErr)
 					}, "Failed to persist advisory notes (best-effort)");
@@ -11336,17 +12714,17 @@ function createImplementationOrchestrator(deps) {
 				if (telemetryPersistence !== void 0) try {
 					const turns = await telemetryPersistence.getTurnAnalysis(storyKey);
 					if (turns.length > 0) {
-						const scorer = new EfficiencyScorer(logger$26);
+						const scorer = new EfficiencyScorer(logger$27);
 						const effScore = scorer.score(storyKey, turns);
 						await telemetryPersistence.storeEfficiencyScore(effScore);
-						logger$26.info({
+						logger$27.info({
 							storyKey,
 							compositeScore: effScore.compositeScore,
 							modelCount: effScore.perModelBreakdown.length
 						}, "Efficiency score computed and persisted");
-					} else logger$26.debug({ storyKey }, "No turn analysis data available — skipping efficiency scoring");
+					} else logger$27.debug({ storyKey }, "No turn analysis data available — skipping efficiency scoring");
 				} catch (effErr) {
-					logger$26.warn({
+					logger$27.warn({
 						storyKey,
 						error: effErr instanceof Error ? effErr.message : String(effErr)
 					}, "Efficiency scoring failed — story verdict unchanged");
@@ -11354,10 +12732,10 @@ function createImplementationOrchestrator(deps) {
 				if (telemetryPersistence !== void 0) try {
 					const turns = await telemetryPersistence.getTurnAnalysis(storyKey);
 					const spans = [];
-					if (spans.length === 0) logger$26.debug({ storyKey }, "No spans for telemetry categorization — skipping");
+					if (spans.length === 0) logger$27.debug({ storyKey }, "No spans for telemetry categorization — skipping");
 					else {
-						const categorizer = new Categorizer(logger$26);
-						const consumerAnalyzer = new ConsumerAnalyzer(categorizer, logger$26);
+						const categorizer = new Categorizer(logger$27);
+						const consumerAnalyzer = new ConsumerAnalyzer(categorizer, logger$27);
 						const categoryStats = categorizer.computeCategoryStats(spans, turns);
 						const consumerStats = consumerAnalyzer.analyze(spans);
 						await telemetryPersistence.storeCategoryStats(storyKey, categoryStats);
@@ -11365,7 +12743,7 @@ function createImplementationOrchestrator(deps) {
 						const growingCount = categoryStats.filter((c) => c.trend === "growing").length;
 						const topCategory = categoryStats[0]?.category ?? "none";
 						const topConsumer = consumerStats[0]?.consumerKey ?? "none";
-						logger$26.info({
+						logger$27.info({
 							storyKey,
 							topCategory,
 							topConsumer,
@@ -11373,7 +12751,7 @@ function createImplementationOrchestrator(deps) {
 						}, "Semantic categorization and consumer analysis complete");
 					}
 				} catch (catErr) {
-					logger$26.warn({
+					logger$27.warn({
 						storyKey,
 						error: catErr instanceof Error ? catErr.message : String(catErr)
 					}, "Semantic categorization failed — story verdict unchanged");
@@ -11394,7 +12772,7 @@ function createImplementationOrchestrator(deps) {
 						filesModified: devFilesModified,
 						workingDirectory: projectRoot
 					});
-					logger$26.debug({
+					logger$27.debug({
 						storyKey,
 						expansion_priority: expansionResult.expansion_priority,
 						coverage_gaps: expansionResult.coverage_gaps.length
@@ -11407,7 +12785,7 @@ function createImplementationOrchestrator(deps) {
 						value: JSON.stringify(expansionResult)
 					});
 				} catch (expansionErr) {
-					logger$26.warn({
+					logger$27.warn({
 						storyKey,
 						error: expansionErr instanceof Error ? expansionErr.message : String(expansionErr)
 					}, "Test expansion failed — story verdict unchanged");
@@ -11434,7 +12812,7 @@ function createImplementationOrchestrator(deps) {
 					persistState();
 					return;
 				}
-				logger$26.info({
+				logger$27.info({
 					storyKey,
 					reviewCycles: finalReviewCycles,
 					issueCount: issueList.length
@@ -11494,7 +12872,7 @@ function createImplementationOrchestrator(deps) {
 						fixPrompt = assembled.prompt;
 					} catch {
 						fixPrompt = `Fix story ${storyKey}: verdict=${verdict}, minor fixes needed`;
-						logger$26.warn({ storyKey }, "Failed to assemble auto-approve fix prompt, using fallback");
+						logger$27.warn({ storyKey }, "Failed to assemble auto-approve fix prompt, using fallback");
 					}
 					const handle = dispatcher.dispatch({
 						prompt: fixPrompt,
@@ -11502,7 +12880,8 @@ function createImplementationOrchestrator(deps) {
 						taskType: "minor-fixes",
 						workingDirectory: projectRoot,
 						...autoApproveMaxTurns !== void 0 ? { maxTurns: autoApproveMaxTurns } : {},
-						..._otlpEndpoint !== void 0 ? { otlpEndpoint: _otlpEndpoint } : {}
+						..._otlpEndpoint !== void 0 ? { otlpEndpoint: _otlpEndpoint } : {},
+						storyKey
 					});
 					const fixResult = await handle.result;
 					eventBus.emit("orchestrator:story-phase-complete", {
@@ -11513,9 +12892,9 @@ function createImplementationOrchestrator(deps) {
 							output: fixResult.tokenEstimate.output
 						} : void 0 }
 					});
-					if (fixResult.status === "timeout") logger$26.warn({ storyKey }, "Auto-approve fix timed out — approving anyway (issues were minor)");
+					if (fixResult.status === "timeout") logger$27.warn({ storyKey }, "Auto-approve fix timed out — approving anyway (issues were minor)");
 				} catch (err) {
-					logger$26.warn({
+					logger$27.warn({
 						storyKey,
 						err
 					}, "Auto-approve fix dispatch failed — approving anyway (issues were minor)");
@@ -11632,7 +13011,7 @@ function createImplementationOrchestrator(deps) {
 					fixPrompt = assembled.prompt;
 				} catch {
 					fixPrompt = `Fix story ${storyKey}: verdict=${verdict}, taskType=${taskType}`;
-					logger$26.warn({
+					logger$27.warn({
 						storyKey,
 						taskType
 					}, "Failed to assemble fix prompt, using fallback");
@@ -11666,7 +13045,7 @@ function createImplementationOrchestrator(deps) {
 					} : void 0 }
 				});
 				if (fixResult.status === "timeout") {
-					logger$26.warn({
+					logger$27.warn({
 						storyKey,
 						taskType
 					}, "Fix dispatch timed out — escalating story");
@@ -11688,7 +13067,7 @@ function createImplementationOrchestrator(deps) {
 				}
 				if (fixResult.status === "failed") {
 					if (isMajorRework) {
-						logger$26.warn({
+						logger$27.warn({
 							storyKey,
 							exitCode: fixResult.exitCode
 						}, "Major rework dispatch failed — escalating story");
@@ -11708,14 +13087,14 @@ function createImplementationOrchestrator(deps) {
 						persistState();
 						return;
 					}
-					logger$26.warn({
+					logger$27.warn({
 						storyKey,
 						taskType,
 						exitCode: fixResult.exitCode
 					}, "Fix dispatch failed");
 				}
 			} catch (err) {
-				logger$26.warn({
+				logger$27.warn({
 					storyKey,
 					taskType,
 					err
@@ -11778,11 +13157,11 @@ function createImplementationOrchestrator(deps) {
 	}
 	async function run(storyKeys) {
 		if (_state === "RUNNING" || _state === "PAUSED") {
-			logger$26.warn({ state: _state }, "run() called while orchestrator is already running or paused — ignoring");
+			logger$27.warn({ state: _state }, "run() called while orchestrator is already running or paused — ignoring");
 			return getStatus();
 		}
 		if (_state === "COMPLETE") {
-			logger$26.warn({ state: _state }, "run() called on a COMPLETE orchestrator — ignoring");
+			logger$27.warn({ state: _state }, "run() called on a COMPLETE orchestrator — ignoring");
 			return getStatus();
 		}
 		_state = "RUNNING";
@@ -11806,7 +13185,7 @@ function createImplementationOrchestrator(deps) {
 			const seedStart = Date.now();
 			const seedResult = seedMethodologyContext(db, projectRoot);
 			_startupTimings.seedMethodologyMs = Date.now() - seedStart;
-			if (seedResult.decisionsCreated > 0) logger$26.info({
+			if (seedResult.decisionsCreated > 0) logger$27.info({
 				decisionsCreated: seedResult.decisionsCreated,
 				skippedCategories: seedResult.skippedCategories,
 				durationMs: _startupTimings.seedMethodologyMs
@@ -11819,7 +13198,7 @@ function createImplementationOrchestrator(deps) {
 				_startupTimings.stateStoreInitMs = Date.now() - stateStoreInitStart;
 				for (const key of storyKeys) {
 					const pendingState = _stories.get(key);
-					if (pendingState !== void 0) persistStoryState(key, pendingState).catch((err) => logger$26.warn({
+					if (pendingState !== void 0) persistStoryState(key, pendingState).catch((err) => logger$27.warn({
 						err,
 						storyKey: key
 					}, "StateStore write failed during PENDING init"));
@@ -11830,14 +13209,30 @@ function createImplementationOrchestrator(deps) {
 					_startupTimings.queryStoriesMs = Date.now() - queryStoriesStart;
 					for (const record of existingRecords) _stateStoreCache.set(record.storyKey, record);
 				} catch (err) {
-					logger$26.warn({ err }, "StateStore.queryStories() failed during init — status merge will be empty (best-effort)");
+					logger$27.warn({ err }, "StateStore.queryStories() failed during init — status merge will be empty (best-effort)");
 				}
 			}
 			if (ingestionServer !== void 0) {
-				await ingestionServer.start().catch((err) => logger$26.warn({ err }, "IngestionServer.start() failed — continuing without telemetry (best-effort)"));
+				if (telemetryPersistence !== void 0) try {
+					const pipelineLogger = logger$27;
+					const telemetryPipeline = new TelemetryPipeline({
+						normalizer: new TelemetryNormalizer(pipelineLogger),
+						turnAnalyzer: new TurnAnalyzer(pipelineLogger),
+						categorizer: new Categorizer(pipelineLogger),
+						consumerAnalyzer: new ConsumerAnalyzer(new Categorizer(pipelineLogger), pipelineLogger),
+						efficiencyScorer: new EfficiencyScorer(pipelineLogger),
+						recommender: new Recommender(pipelineLogger),
+						persistence: telemetryPersistence
+					});
+					ingestionServer.setPipeline(telemetryPipeline);
+					logger$27.info("TelemetryPipeline wired to IngestionServer");
+				} catch (pipelineErr) {
+					logger$27.warn({ err: pipelineErr }, "Failed to create TelemetryPipeline — continuing without analysis pipeline");
+				}
+				await ingestionServer.start().catch((err) => logger$27.warn({ err }, "IngestionServer.start() failed — continuing without telemetry (best-effort)"));
 				try {
 					_otlpEndpoint = ingestionServer.getOtlpEnvVars().OTEL_EXPORTER_OTLP_ENDPOINT;
-					logger$26.info({ otlpEndpoint: _otlpEndpoint }, "OTLP telemetry ingestion active");
+					logger$27.info({ otlpEndpoint: _otlpEndpoint }, "OTLP telemetry ingestion active");
 				} catch {}
 			}
 			let contractDeclarations = [];
@@ -11877,11 +13272,11 @@ function createImplementationOrchestrator(deps) {
 			const conflictDetectStart = Date.now();
 			const { batches, edges: contractEdges } = detectConflictGroupsWithContracts(storyKeys, { moduleMap: pack.manifest.conflictGroups }, contractDeclarations);
 			_startupTimings.conflictDetectMs = Date.now() - conflictDetectStart;
-			if (contractEdges.length > 0) logger$26.info({
+			if (contractEdges.length > 0) logger$27.info({
 				contractEdges,
 				edgeCount: contractEdges.length
 			}, "Contract dependency edges detected — applying contract-aware dispatch ordering");
-			logger$26.info({
+			logger$27.info({
 				storyCount: storyKeys.length,
 				groupCount: batches.reduce((sum, b) => sum + b.length, 0),
 				batchCount: batches.length,
@@ -11903,7 +13298,7 @@ function createImplementationOrchestrator(deps) {
 						exitCode,
 						output: truncatedOutput
 					});
-					logger$26.error({
+					logger$27.error({
 						exitCode,
 						reason: preFlightResult.reason
 					}, "Pre-flight build check failed — aborting pipeline before any story dispatch");
@@ -11912,9 +13307,9 @@ function createImplementationOrchestrator(deps) {
 					persistState();
 					return getStatus();
 				}
-				if (preFlightResult.status !== "skipped") logger$26.info("Pre-flight build check passed");
+				if (preFlightResult.status !== "skipped") logger$27.info("Pre-flight build check passed");
 			}
-			logger$26.info(_startupTimings, "Orchestrator startup timings (ms)");
+			logger$27.info(_startupTimings, "Orchestrator startup timings (ms)");
 			try {
 				for (const batchGroups of batches) await runWithConcurrency(batchGroups, config.maxConcurrency);
 			} catch (err) {
@@ -11922,14 +13317,22 @@ function createImplementationOrchestrator(deps) {
 				_state = "FAILED";
 				_completedAt = new Date().toISOString();
 				persistState();
-				logger$26.error({ err }, "Orchestrator failed with unhandled error");
+				logger$27.error({ err }, "Orchestrator failed with unhandled error");
 				return getStatus();
 			}
 			stopHeartbeat();
 			_state = "COMPLETE";
 			_completedAt = new Date().toISOString();
 			if (projectRoot !== void 0 && contractDeclarations.length > 0) try {
-				const mismatches = verifyContracts(contractDeclarations, projectRoot);
+				const totalDeclarations = contractDeclarations.length;
+				const currentSprintDeclarations = contractDeclarations.filter((d) => storyKeys.includes(d.storyKey));
+				const stalePruned = totalDeclarations - currentSprintDeclarations.length;
+				if (stalePruned > 0) logger$27.info({
+					stalePruned,
+					remaining: currentSprintDeclarations.length
+				}, "Pruned stale contract declarations from previous epics");
+				let mismatches = [];
+				if (currentSprintDeclarations.length > 0) mismatches = verifyContracts(currentSprintDeclarations, projectRoot);
 				if (mismatches.length > 0) {
 					_contractMismatches = mismatches;
 					for (const mismatch of mismatches) eventBus.emit("pipeline:contract-mismatch", {
@@ -11938,16 +13341,22 @@ function createImplementationOrchestrator(deps) {
 						contractName: mismatch.contractName,
 						mismatchDescription: mismatch.mismatchDescription
 					});
-					logger$26.warn({
+					logger$27.warn({
 						mismatchCount: mismatches.length,
 						mismatches
 					}, "Post-sprint contract verification found mismatches — manual review required");
-				} else logger$26.info("Post-sprint contract verification passed — all declared contracts satisfied");
+				} else if (currentSprintDeclarations.length > 0) logger$27.info("Post-sprint contract verification passed — all declared contracts satisfied");
+				eventBus.emit("pipeline:contract-verification-summary", {
+					verified: currentSprintDeclarations.length,
+					stalePruned,
+					mismatches: mismatches.length,
+					verdict: mismatches.length === 0 ? "pass" : "fail"
+				});
 				if (stateStore !== void 0) try {
-					const allContractsForVerification = await stateStore.queryContracts();
+					const currentSprintContracts = (await stateStore.queryContracts()).filter((cr) => storyKeys.includes(cr.storyKey));
 					const verifiedAt = new Date().toISOString();
 					const contractsByStory = new Map();
-					for (const cr of allContractsForVerification) {
+					for (const cr of currentSprintContracts) {
 						const existing = contractsByStory.get(cr.storyKey) ?? [];
 						existing.push(cr);
 						contractsByStory.set(cr.storyKey, existing);
@@ -11971,12 +13380,12 @@ function createImplementationOrchestrator(deps) {
 						});
 						await stateStore.setContractVerification(sk, records);
 					}
-					logger$26.info({ storyCount: contractsByStory.size }, "Contract verification results persisted to StateStore");
+					logger$27.info({ storyCount: contractsByStory.size }, "Contract verification results persisted to StateStore");
 				} catch (persistErr) {
-					logger$26.warn({ err: persistErr }, "Failed to persist contract verification results to StateStore");
+					logger$27.warn({ err: persistErr }, "Failed to persist contract verification results to StateStore");
 				}
 			} catch (err) {
-				logger$26.error({ err }, "Post-sprint contract verification threw an error — skipping");
+				logger$27.error({ err }, "Post-sprint contract verification threw an error — skipping");
 			}
 			let completed = 0;
 			let escalated = 0;
@@ -11993,8 +13402,8 @@ function createImplementationOrchestrator(deps) {
 			persistState();
 			return getStatus();
 		} finally {
-			if (stateStore !== void 0) await stateStore.close().catch((err) => logger$26.warn({ err }, "StateStore.close() failed (best-effort)"));
-			if (ingestionServer !== void 0) await ingestionServer.stop().catch((err) => logger$26.warn({ err }, "IngestionServer.stop() failed (best-effort)"));
+			if (stateStore !== void 0) await stateStore.close().catch((err) => logger$27.warn({ err }, "StateStore.close() failed (best-effort)"));
+			if (ingestionServer !== void 0) await ingestionServer.stop().catch((err) => logger$27.warn({ err }, "IngestionServer.stop() failed (best-effort)"));
 		}
 	}
 	function pause() {
@@ -12003,7 +13412,7 @@ function createImplementationOrchestrator(deps) {
 		_pauseGate = createPauseGate();
 		_state = "PAUSED";
 		eventBus.emit("orchestrator:paused", {});
-		logger$26.info("Orchestrator paused");
+		logger$27.info("Orchestrator paused");
 	}
 	function resume() {
 		if (_state !== "PAUSED") return;
@@ -12014,7 +13423,7 @@ function createImplementationOrchestrator(deps) {
 		}
 		_state = "RUNNING";
 		eventBus.emit("orchestrator:resumed", {});
-		logger$26.info("Orchestrator resumed");
+		logger$27.info("Orchestrator resumed");
 	}
 	return {
 		run,
@@ -16359,7 +17768,11 @@ async function runRunAction(options) {
 		...skipResearchFlag === true ? { skipResearch: true } : {},
 		...skipPreflight === true ? { skipPreflight: true } : {},
 		...epicNumber !== void 0 ? { epic: epicNumber } : {},
-		...injectedRegistry !== void 0 ? { registry: injectedRegistry } : {}
+		...injectedRegistry !== void 0 ? { registry: injectedRegistry } : {},
+		...telemetryEnabled ? {
+			telemetryEnabled: true,
+			telemetryPort
+		} : {}
 	});
 	let storyKeys = [...parsedStoryKeys];
 	if (!existsSync(dbDir)) mkdirSync(dbDir, { recursive: true });
@@ -16760,8 +18173,19 @@ async function runRunAction(options) {
 					mismatchDescription: payload.mismatchDescription
 				});
 			});
+			eventBus.on("pipeline:contract-verification-summary", (payload) => {
+				ndjsonEmitter.emit({
+					type: "pipeline:contract-verification-summary",
+					ts: new Date().toISOString(),
+					verified: payload.verified,
+					stalePruned: payload.stalePruned,
+					mismatches: payload.mismatches,
+					verdict: payload.verdict
+				});
+			});
 		}
 		const ingestionServer = telemetryEnabled ? new IngestionServer({ port: telemetryPort }) : void 0;
+		const telemetryPersistence = telemetryEnabled ? new TelemetryPersistence(db) : void 0;
 		const orchestrator = createImplementationOrchestrator({
 			db,
 			pack,
@@ -16777,7 +18201,8 @@ async function runRunAction(options) {
 			},
 			projectRoot,
 			tokenCeilings,
-			...ingestionServer !== void 0 ? { ingestionServer } : {}
+			...ingestionServer !== void 0 ? { ingestionServer } : {},
+			...telemetryPersistence !== void 0 ? { telemetryPersistence } : {}
 		});
 		if (outputFormat === "human" && progressRenderer === void 0 && ndjsonEmitter === void 0) {
 			process.stdout.write(`Starting pipeline: ${storyKeys.length} story/stories, concurrency=${concurrency}\n`);
@@ -16873,7 +18298,7 @@ async function runRunAction(options) {
 	}
 }
 async function runFullPipeline(options) {
-	const { packName, packPath, dbDir, dbPath, startPhase, stopAfter, concept, concurrency, outputFormat, projectRoot, events: eventsFlag, skipUx, research: researchFlag, skipResearch: skipResearchFlag, skipPreflight, registry: injectedRegistry, tokenCeilings, stories: explicitStories } = options;
+	const { packName, packPath, dbDir, dbPath, startPhase, stopAfter, concept, concurrency, outputFormat, projectRoot, events: eventsFlag, skipUx, research: researchFlag, skipResearch: skipResearchFlag, skipPreflight, registry: injectedRegistry, tokenCeilings, stories: explicitStories, telemetryEnabled: fullTelemetryEnabled, telemetryPort: fullTelemetryPort } = options;
 	if (!existsSync(dbDir)) mkdirSync(dbDir, { recursive: true });
 	const dbWrapper = new DatabaseWrapper(dbPath);
 	try {
@@ -17069,6 +18494,8 @@ async function runFullPipeline(options) {
 					process.stdout.write(`  Tokens: ${result.tokenUsage.input.toLocaleString()} input / ${result.tokenUsage.output.toLocaleString()} output\n`);
 				}
 			} else if (currentPhase === "implementation") {
+				const fpIngestionServer = fullTelemetryEnabled ? new IngestionServer({ port: fullTelemetryPort ?? 4318 }) : void 0;
+				const fpTelemetryPersistence = fullTelemetryEnabled ? new TelemetryPersistence(db) : void 0;
 				const orchestrator = createImplementationOrchestrator({
 					db,
 					pack,
@@ -17082,7 +18509,9 @@ async function runFullPipeline(options) {
 						skipPreflight: skipPreflight === true
 					},
 					projectRoot,
-					tokenCeilings
+					tokenCeilings,
+					...fpIngestionServer !== void 0 ? { ingestionServer: fpIngestionServer } : {},
+					...fpTelemetryPersistence !== void 0 ? { telemetryPersistence: fpTelemetryPersistence } : {}
 				});
 				eventBus.on("orchestrator:story-phase-complete", (payload) => {
 					try {
@@ -17221,4 +18650,4 @@ function registerRunCommand(program, _version = "0.0.0", projectRoot = process.c
 
 //#endregion
 export { 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, runRunAction, runSolutioningPhase, validateStopAfterFromConflict };
-//# sourceMappingURL=run-DI9s014E.js.map
+//# sourceMappingURL=run-DzzmgEOd.js.map