substrate-ai 0.5.2 → 0.5.4

package/dist/adapter-registry-B0XmM7pb.js

@@ -0,0 +1,4 @@
+import "./logger-D2fS2ccL.js";
+import { AdapterRegistry } from "./adapter-registry-CDNPbixE.js";
+
+export { AdapterRegistry };

package/dist/{adapter-registry-BkUvZSKJ.js → adapter-registry-CDNPbixE.js}

@@ -1,8 +1,10 @@
+import { createLogger } from "./logger-D2fS2ccL.js";
 import { exec } from "child_process";
 import { promisify } from "util";
 
 //#region src/adapters/claude-adapter.ts
 const execAsync$2 = promisify(exec);
+const logger = createLogger("claude-adapter");
 /** Default model used when none is specified */
 const DEFAULT_MODEL$1 = "claude-sonnet-4-6";
 /** Approximate characters per token for estimation */
@@ -62,15 +64,21 @@ var ClaudeCodeAdapter = class {
 	buildCommand(prompt, options) {
 		const model = options.model ?? DEFAULT_MODEL$1;
 		const systemPrompt = "You are an autonomous coding agent executing a single pipeline task. Ignore all session startup context, memory notes, and \"Next Up\" indicators. Follow the instructions in the user message exactly. Emit ONLY the YAML output specified in the Output Contract — no other text.";
+		const effectiveSystemPrompt = options.optimizationDirectives !== void 0 && options.optimizationDirectives.length > 0 ? `${systemPrompt}\n\n## Optimization Directives\n${options.optimizationDirectives}` : systemPrompt;
+		if (options.optimizationDirectives !== void 0 && options.optimizationDirectives.length > 0) logger.debug({
+			storyKey: options.storyKey,
+			directiveChars: options.optimizationDirectives.length
+		}, "Injecting optimization directives into system prompt");
 		const args = [
 			"-p",
 			"--model",
 			model,
 			"--dangerously-skip-permissions",
 			"--system-prompt",
-			systemPrompt
+			effectiveSystemPrompt
 		];
 		if (options.maxTurns !== void 0) args.push("--max-turns", String(options.maxTurns));
+		if (options.maxContextTokens !== void 0) args.push("--max-context-tokens", String(options.maxContextTokens));
 		if (options.additionalFlags && options.additionalFlags.length > 0) args.push(...options.additionalFlags);
 		const envEntries = {};
 		const unsetKeys = ["CLAUDECODE", "CLAUDE_CODE_ENTRYPOINT"];
@@ -825,4 +833,4 @@ var AdapterRegistry = class {
 
 //#endregion
 export { AdapterRegistry, ClaudeCodeAdapter, CodexCLIAdapter, GeminiCLIAdapter };
-//# sourceMappingURL=adapter-registry-BkUvZSKJ.js.map
+//# sourceMappingURL=adapter-registry-CDNPbixE.js.map

package/dist/cli/index.js

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
-import { AdapterTelemetryPersistence, AppError, DEFAULT_CONFIG, DEFAULT_ROUTING_POLICY, DoltClient, DoltNotInstalled, DoltRepoMapMetaRepository, DoltSymbolRepository, ERR_REPO_MAP_STORAGE_WRITE, FileStateStore, GitClient, GrammarLoader, IngestionServer, RepoMapInjector, RepoMapModule, RepoMapQueryEngine, RepoMapStorage, SUBSTRATE_OWNED_SETTINGS_KEYS, SymbolParser, VALID_PHASES, WorkGraphRepository, buildPipelineStatusOutput, checkDoltInstalled, createConfigSystem, createContextCompiler, createDatabaseAdapter, createDispatcher, createDoltClient, createEventEmitter, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStateStore, createStopAfterGate, detectCycles, findPackageRoot, formatOutput, formatPhaseCompletionSummary, formatPipelineStatusHuman, formatPipelineSummary, formatTokenTelemetry, getAllDescendantPids, getAutoHealthData, getSubstrateDefaultSettings, initSchema, initializeDolt, isSyncAdapter, parseDbTimestampAsUtc, registerHealthCommand, registerRunCommand, resolveBmadMethodSrcPath, resolveBmadMethodVersion, resolveMainRepoRoot, resolveStoryKeys, runAnalysisPhase, runPlanningPhase, runSolutioningPhase, validateStopAfterFromConflict } from "../run-CxoTrYdA.js";
+import { AdapterTelemetryPersistence, AppError, DEFAULT_CONFIG, DEFAULT_ROUTING_POLICY, DoltClient, DoltNotInstalled, DoltRepoMapMetaRepository, DoltSymbolRepository, ERR_REPO_MAP_STORAGE_WRITE, FileStateStore, GitClient, GrammarLoader, IngestionServer, RepoMapInjector, RepoMapModule, RepoMapQueryEngine, RepoMapStorage, SUBSTRATE_OWNED_SETTINGS_KEYS, SymbolParser, VALID_PHASES, WorkGraphRepository, buildPipelineStatusOutput, checkDoltInstalled, createConfigSystem, createContextCompiler, createDatabaseAdapter, createDispatcher, createDoltClient, createEventEmitter, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStateStore, createStopAfterGate, createTelemetryAdvisor, detectCycles, findPackageRoot, formatOutput, formatPhaseCompletionSummary, formatPipelineStatusHuman, formatPipelineSummary, formatTokenTelemetry, getAllDescendantPids, getAutoHealthData, getSubstrateDefaultSettings, initSchema, initializeDolt, isSyncAdapter, parseDbTimestampAsUtc, registerHealthCommand, registerRunCommand, resolveBmadMethodSrcPath, resolveBmadMethodVersion, resolveMainRepoRoot, resolveStoryKeys, runAnalysisPhase, runPlanningPhase, runSolutioningPhase, validateStopAfterFromConflict } from "../run-BVqGAkUO.js";
 import { createLogger } from "../logger-D2fS2ccL.js";
-import { AdapterRegistry } from "../adapter-registry-BkUvZSKJ.js";
+import { AdapterRegistry } from "../adapter-registry-CDNPbixE.js";
 import { CURRENT_CONFIG_FORMAT_VERSION, CURRENT_TASK_GRAPH_VERSION, PartialSubstrateConfigSchema } from "../config-migrator-DtZW1maj.js";
 import { ConfigError, createEventBus } from "../helpers-BihqWgVe.js";
 import { RoutingRecommender } from "../routing-BUE9pIxW.js";
 import { addTokenUsage, createDecision, createPipelineRun, getDecisionsByCategory, getDecisionsByPhaseForRun, getLatestRun, getPipelineRunById, getTokenUsageSummary, listRequirements, updatePipelineRun } from "../decisions-C6MF2Cax.js";
-import { ESCALATION_DIAGNOSIS, EXPERIMENT_RESULT, OPERATIONAL_FINDING, STORY_METRICS, aggregateTokenUsageForRun, compareRunMetrics, getBaselineRunMetrics, getRunMetrics, getStoryMetricsForRun, incrementRunRestarts, listRunMetrics, tagRunAsBaseline } from "../operational-CidppHy-.js";
+import { ESCALATION_DIAGNOSIS, EXPERIMENT_RESULT, OPERATIONAL_FINDING, STORY_METRICS, aggregateTokenUsageForRun, compareRunMetrics, getBaselineRunMetrics, getRunMetrics, getStoryMetricsForRun, incrementRunRestarts, listRunMetrics, tagRunAsBaseline } from "../operational-BRpT8MYF.js";
 import { abortMerge, createWorktree, getConflictingFiles, getMergedFiles, getOrphanedWorktrees, performMerge, removeBranch, removeWorktree, simulateMerge, verifyGitVersion } from "../git-utils-C-fdrHF_.js";
 import "../version-manager-impl-DTlmGvHb.js";
 import { registerUpgradeCommand } from "../upgrade-C8_VcI8B.js";
@@ -1122,7 +1122,8 @@ async function runResumeAction(options) {
 			events: eventsFlag,
 			existingRunId: runId,
 			projectRoot,
-			registry
+			registry,
+			stories: options.stories
 		});
 	} catch (err) {
 		const msg = err instanceof Error ? err.message : String(err);
@@ -1137,7 +1138,7 @@ async function runResumeAction(options) {
 	}
 }
 async function runFullPipelineFromPhase(options) {
-	const { packName, packPath, dbDir, dbPath, startPhase, stopAfter, concept, concurrency, outputFormat, events: eventsFlag, existingRunId, projectRoot, registry: injectedRegistry } = options;
+	const { packName, packPath, dbDir, dbPath, startPhase, stopAfter, concept, concurrency, outputFormat, events: eventsFlag, existingRunId, projectRoot, registry: injectedRegistry, stories: explicitStories } = options;
 	if (!existsSync(dbDir)) mkdirSync(dbDir, { recursive: true });
 	const adapter = createDatabaseAdapter({
 		backend: "auto",
@@ -1283,7 +1284,10 @@ async function runFullPipelineFromPhase(options) {
 					...telemetryPersistence !== void 0 ? { telemetryPersistence } : {}
 				});
 				if (ndjsonEmitter !== void 0) {
-					const resolvedKeys = await resolveStoryKeys(adapter, projectRoot, { pipelineRunId: runId });
+					const resolvedKeys = await resolveStoryKeys(adapter, projectRoot, {
+						explicit: explicitStories,
+						pipelineRunId: runId
+					});
 					ndjsonEmitter.emit({
 						type: "pipeline:start",
 						ts: new Date().toISOString(),
@@ -1376,7 +1380,10 @@ async function runFullPipelineFromPhase(options) {
 						logger$16.warn({ err }, "Failed to record token usage");
 					}
 				});
-				const storyKeys = await resolveStoryKeys(adapter, projectRoot, { pipelineRunId: runId });
+				const storyKeys = await resolveStoryKeys(adapter, projectRoot, {
+					explicit: explicitStories,
+					pipelineRunId: runId
+				});
 				if (storyKeys.length === 0 && outputFormat === "human") process.stdout.write("[IMPLEMENTATION] No stories found for this run. Check solutioning phase output.\n");
 				await orchestrator.run(storyKeys);
 				if (ndjsonEmitter !== void 0) ndjsonEmitter.emit({
@@ -2518,7 +2525,7 @@ function defaultSupervisorDeps() {
 				if (cached === null) {
 					const { AdapterRegistry: AR } = await import(
 						/* @vite-ignore */
-						"../adapter-registry-BRQXdPnB.js"
+						"../adapter-registry-B0XmM7pb.js"
 );
 					cached = new AR();
 					await cached.discoverAndRegister();
@@ -2626,6 +2633,31 @@ function defaultSupervisorDeps() {
 					await raAdapter.close();
 				} catch {}
 			}
+		},
+		getRunConfig: async (runId, projectRoot) => {
+			try {
+				const dbRoot = await resolveMainRepoRoot(projectRoot);
+				const rcAdapter = createDatabaseAdapter({
+					backend: "auto",
+					basePath: dbRoot
+				});
+				try {
+					await initSchema(rcAdapter);
+					const rows = await rcAdapter.query("SELECT config_json FROM pipeline_runs WHERE id = ?", [runId]);
+					if (rows.length === 0 || rows[0].config_json === null) return null;
+					const config = JSON.parse(rows[0].config_json);
+					return {
+						explicitStories: config.explicitStories,
+						epic: config.epic
+					};
+				} finally {
+					try {
+						await rcAdapter.close();
+					} catch {}
+				}
+			} catch {
+				return null;
+			}
 		}
 	};
 }
@@ -2681,7 +2713,11 @@ async function handleStallRecovery(health, state, config, deps, io) {
 	const { killPid, resumePipeline, sleep, incrementRestarts, getAllDescendants, writeStallFindings, getRegistry } = deps;
 	const { emitEvent, log } = io;
 	const { projectRoot } = state;
-	if (health.staleness_seconds < stallThreshold) return null;
+	const REVIEW_PHASES = new Set(["IN_REVIEW", "code-review"]);
+	const activePhases = Object.values(health.stories.details ?? {}).map((s) => s.phase);
+	const inReviewPhase = activePhases.some((p) => REVIEW_PHASES.has(p));
+	const effectiveThreshold = inReviewPhase ? stallThreshold * 2 : stallThreshold;
+	if (health.staleness_seconds < effectiveThreshold) return null;
 	const directPids = [...health.process.orchestrator_pid !== null ? [health.process.orchestrator_pid] : [], ...health.process.child_pids];
 	const descendantPids = getAllDescendants(directPids);
 	const directPidSet = new Set(directPids);
@@ -2747,6 +2783,15 @@ async function handleStallRecovery(health, state, config, deps, io) {
 	});
 	log(`Supervisor: Restarting pipeline (attempt ${newRestartCount}/${maxRestarts})`);
 	try {
+		let scopedStories;
+		if (deps.getRunConfig !== void 0 && health.run_id !== null) try {
+			const runConfig = await deps.getRunConfig(health.run_id, projectRoot);
+			if (runConfig?.explicitStories !== void 0 && runConfig.explicitStories.length > 0) scopedStories = runConfig.explicitStories;
+		} catch {}
+		if (scopedStories === void 0) {
+			const healthKeys = Object.keys(health.stories.details ?? {});
+			if (healthKeys.length > 0) scopedStories = healthKeys;
+		}
 		const registry = await getRegistry();
 		await resumePipeline({
 			runId: health.run_id ?? void 0,
@@ -2754,7 +2799,8 @@ async function handleStallRecovery(health, state, config, deps, io) {
 			projectRoot,
 			concurrency: 3,
 			pack,
-			registry
+			registry,
+			...scopedStories !== void 0 ? { stories: scopedStories } : {}
 		});
 		if (writeStallFindings) await writeStallFindings({
 			runId: health.run_id,
@@ -2909,7 +2955,7 @@ async function runSupervisorAction(options, deps = {}) {
 						try {
 							const { createExperimenter } = await import(
 								/* @vite-ignore */
-								"../experimenter-CoR0k66d.js"
+								"../experimenter-CjfzjmwY.js"
 );
 							const { getLatestRun: getLatest } = await import(
 								/* @vite-ignore */
@@ -2923,7 +2969,7 @@ async function runSupervisorAction(options, deps = {}) {
 								await initSchema(expAdapter);
 								const { runRunAction: runPipeline } = await import(
 									/* @vite-ignore */
-									"../run-BSs4Dn0j.js"
+									"../run-WMR5BAhL.js"
 );
 								const runStoryFn = async (opts) => {
 									const exitCode = await runPipeline({
@@ -3001,7 +3047,8 @@ async function runSupervisorAction(options, deps = {}) {
 			incrementRestarts: resolvedDeps.incrementRestarts,
 			getAllDescendants: resolvedDeps.getAllDescendants,
 			writeStallFindings: resolvedDeps.writeStallFindings,
-			getRegistry: resolvedDeps.getRegistry
+			getRegistry: resolvedDeps.getRegistry,
+			getRunConfig: resolvedDeps.getRunConfig
 		}, {
 			emitEvent,
 			log
@@ -3189,7 +3236,7 @@ async function openTelemetryAdapter(basePath) {
 function rowsToEfficiencyScore(rows) {
 	return rows;
 }
-function printEfficiencyTable(scores) {
+function printEfficiencyTable(scores, dispatchScoresByStory = new Map()) {
 	process.stdout.write(`\nEfficiency Scores (${scores.length} records)\n`);
 	process.stdout.write("─".repeat(80) + "\n");
 	process.stdout.write(`  ${"Story Key".padEnd(14)} ${"Score".padStart(6)} ${"Cache Hit%".padStart(11)} ${"I/O Ratio".padStart(10)} ${"Ctx Mgmt".padStart(9)} Model\n`);
@@ -3200,6 +3247,16 @@ function printEfficiencyTable(scores) {
 		const ctxMgmt = String(Math.round(s.contextManagementSubScore));
 		const model = s.perModelBreakdown.length > 0 ? s.perModelBreakdown[0]?.model ?? "unknown" : "unknown";
 		process.stdout.write(`  ${s.storyKey.padEnd(14)} ${String(s.compositeScore).padStart(6)} ${cacheHitPct.padStart(11)} ${ioRatio.padStart(10)} ${ctxMgmt.padStart(9)} ${model}\n`);
+		const dispatchScores = dispatchScoresByStory.get(s.storyKey);
+		if (dispatchScores !== void 0 && dispatchScores.length > 0) {
+			const rows = dispatchScores.slice(0, 5);
+			for (const ds of rows) {
+				const taskType = ds.taskType ?? "unknown";
+				const phase = ds.phase ?? "unknown";
+				const dsCacheHitPct = ds.totalTurns > 0 ? `${(ds.avgCacheHitRate * 100).toFixed(1)}%` : "0.0%";
+				process.stdout.write(`    ↳ ${taskType}/${phase} score=${ds.compositeScore} cache=${dsCacheHitPct} turns=${ds.totalTurns}\n`);
+			}
+		}
 	}
 }
 function printRecommendationTable(recs) {
@@ -3215,13 +3272,15 @@ function printRecommendationTable(recs) {
 }
 function printTurnTable(turns, storyKey) {
 	process.stdout.write(`\nTurn Analysis: ${storyKey} (${turns.length} turns)\n`);
-	process.stdout.write("─".repeat(80) + "\n");
-	process.stdout.write(`  ${"#".padStart(4)} ${"Tokens In".padStart(10)} ${"Tok Out".padStart(8)} ${"Cache Hit%".padStart(11)} ${"Ctx Size".padStart(9)} Spike\n`);
-	process.stdout.write("  " + "─".repeat(60) + "\n");
+	process.stdout.write("─".repeat(100) + "\n");
+	process.stdout.write(`  ${"#".padStart(4)} ${"Tokens In".padStart(10)} ${"Tok Out".padStart(8)} ${"Cache Hit%".padStart(11)} ${"Ctx Size".padStart(9)} ${"Task Type".padEnd(16)} ${"Phase".padEnd(16)} Spike\n`);
+	process.stdout.write("  " + "─".repeat(86) + "\n");
 	for (const t of turns) {
 		const cacheHitPct = t.inputTokens > 0 ? `${(t.cacheHitRate * 100).toFixed(1)}%` : "0.0%";
 		const spike = t.isContextSpike ? " ⚠" : "";
-		process.stdout.write(`  ${String(t.turnNumber).padStart(4)} ${t.inputTokens.toLocaleString().padStart(10)} ${t.outputTokens.toLocaleString().padStart(8)} ${cacheHitPct.padStart(11)} ${t.contextSize.toLocaleString().padStart(9)}${spike}\n`);
+		const taskType = (t.taskType ?? "-").padEnd(16);
+		const phase = (t.phase ?? "-").padEnd(16);
+		process.stdout.write(`  ${String(t.turnNumber).padStart(4)} ${t.inputTokens.toLocaleString().padStart(10)} ${t.outputTokens.toLocaleString().padStart(8)} ${cacheHitPct.padStart(11)} ${t.contextSize.toLocaleString().padStart(9)} ${taskType} ${phase}${spike}\n`);
 	}
 }
 function printConsumerTable(consumers, storyKey) {
@@ -3295,8 +3354,19 @@ async function runMetricsAction(options) {
 		try {
 			if (efficiency === true) {
 				const scores = await telemetryPersistence.getEfficiencyScores(20);
-				if (outputFormat === "json") process.stdout.write(formatOutput({ efficiency: rowsToEfficiencyScore(scores) }, "json", true) + "\n");
-				else printEfficiencyTable(scores);
+				const storyKeys = [...new Set(scores.map((s) => s.storyKey))];
+				const dispatchScoresByStory = new Map();
+				await Promise.all(storyKeys.map(async (sk) => {
+					const ds = await telemetryPersistence.getDispatchEfficiencyScores(sk);
+					if (ds.length > 0) dispatchScoresByStory.set(sk, ds);
+				}));
+				if (outputFormat === "json") {
+					const efficiencyWithDispatch = scores.map((s) => ({
+						...rowsToEfficiencyScore([s])[0],
+						dispatchScores: dispatchScoresByStory.get(s.storyKey) ?? []
+					}));
+					process.stdout.write(formatOutput({ efficiency: efficiencyWithDispatch }, "json", true) + "\n");
+				} else printEfficiencyTable(scores, dispatchScoresByStory);
 				return 0;
 			}
 			if (recommendations === true) {
@@ -7279,7 +7349,7 @@ async function getRetryableEscalations(adapter, runId) {
 //#region src/cli/commands/retry-escalated.ts
 const logger$3 = createLogger("retry-escalated-cmd");
 async function runRetryEscalatedAction(options) {
-	const { runId, dryRun, outputFormat, projectRoot, concurrency, pack: packName, registry: injectedRegistry } = options;
+	const { runId, dryRun, force, outputFormat, projectRoot, concurrency, pack: packName, registry: injectedRegistry } = options;
 	const dbRoot = await resolveMainRepoRoot(projectRoot);
 	const dbPath = join(dbRoot, ".substrate", "substrate.db");
 	const doltDir = join(dbRoot, ".substrate", "state", ".dolt");
@@ -7304,6 +7374,26 @@ async function runRetryEscalatedAction(options) {
 			else process.stdout.write("No retry-targeted escalations found.\n");
 			return 0;
 		}
+		const perStoryContextCeilings = {};
+		if (!dryRun && !force) {
+			const advisor = createTelemetryAdvisor({ db: adapter });
+			const CONTEXT_SPIKE_THRESHOLD = 1e5;
+			const contextCeiling = Math.round(CONTEXT_SPIKE_THRESHOLD * .8);
+			for (const storyKey of retryable) try {
+				const profile = await advisor.getEfficiencyProfile(storyKey);
+				if (profile === null) continue;
+				if (profile.compositeScore < 50) process.stdout.write(`[WARN] ${storyKey}: Previous run had low efficiency (score: ${profile.compositeScore}). Retry may encounter the same issues.\n`);
+				if (profile.contextManagementSubScore < 50) {
+					perStoryContextCeilings[storyKey] = contextCeiling;
+					process.stdout.write(`[INFO] ${storyKey}: Context ceiling set to ${contextCeiling} tokens due to prior context spike pattern.\n`);
+				}
+			} catch (err) {
+				logger$3.warn({
+					err,
+					storyKey
+				}, "Failed to read efficiency profile — skipping gate");
+			}
+		}
 		if (dryRun) {
 			if (outputFormat === "json") process.stdout.write(formatOutput({
 				retryKeys: retryable,
@@ -7339,7 +7429,8 @@ async function runRetryEscalatedAction(options) {
 			config_json: JSON.stringify({
 				storyKeys: retryable,
 				concurrency,
-				retryRun: true
+				retryRun: true,
+				explicitStories: retryable
 			})
 		});
 		const eventBus = createEventBus();
@@ -7358,7 +7449,8 @@ async function runRetryEscalatedAction(options) {
 			config: {
 				maxConcurrency: concurrency,
 				maxReviewCycles: 2,
-				pipelineRunId: pipelineRun.id
+				pipelineRunId: pipelineRun.id,
+				...Object.keys(perStoryContextCeilings).length > 0 ? { perStoryContextCeilings } : {}
 			},
 			projectRoot
 		});
@@ -7410,7 +7502,7 @@ async function runRetryEscalatedAction(options) {
 	}
 }
 function registerRetryEscalatedCommand(program, _version = "0.0.0", projectRoot = process.cwd(), registry) {
-	program.command("retry-escalated").description("Retry escalated stories flagged as retry-targeted by escalation diagnosis").option("--run-id <id>", "Scope to a specific pipeline run ID (defaults to latest run with escalations)").option("--dry-run", "Print retryable and skipped stories without invoking the orchestrator").option("--concurrency <n>", "Maximum parallel story executions", (v) => {
+	program.command("retry-escalated").description("Retry escalated stories flagged as retry-targeted by escalation diagnosis").option("--run-id <id>", "Scope to a specific pipeline run ID (defaults to latest run with escalations)").option("--dry-run", "Print retryable and skipped stories without invoking the orchestrator").option("--force", "Bypass efficiency-gate checks (warning and context ceiling)", false).option("--concurrency <n>", "Maximum parallel story executions", (v) => {
 		const n = parseInt(v, 10);
 		if (isNaN(n) || n < 1) throw new Error(`--concurrency must be a positive integer, got: ${v}`);
 		return n;
@@ -7419,6 +7511,7 @@ function registerRetryEscalatedCommand(program, _version = "0.0.0", projectRoot
 		const exitCode = await runRetryEscalatedAction({
 			runId: opts.runId,
 			dryRun: opts.dryRun === true,
+			force: opts.force === true,
 			outputFormat,
 			projectRoot: opts.projectRoot,
 			concurrency: opts.concurrency,
@@ -7880,23 +7973,19 @@ function registerRoutingCommand(program) {
 /**
 * Work-graph schema DDL constants.
 *
-* Story 31-1 placeholder — defines the `stories`, `story_dependencies`, and
-* `ready_stories` DDL used by the EpicIngester and downstream consumers.
-*
-* NOTE: This file is a minimal placeholder created by story 31-2 because story
-* 31-1 (schema creation) had not yet run.  If story 31-1 produces a richer
-* schema, merge carefully and remove this note.
+* Aligned with the authoritative schema in src/modules/state/schema.sql.
+* Table names use `wg_stories` and `story_dependencies`.
 */
 const CREATE_STORIES_TABLE = `
-CREATE TABLE IF NOT EXISTS stories (
-  story_key VARCHAR(50) NOT NULL,
-  epic_num INT NOT NULL,
-  story_num INT NOT NULL,
-  title VARCHAR(500) NOT NULL,
-  priority VARCHAR(10) NOT NULL,
-  size VARCHAR(50) NOT NULL,
-  sprint INT NOT NULL,
-  status VARCHAR(50) NOT NULL DEFAULT 'planned',
+CREATE TABLE IF NOT EXISTS wg_stories (
+  story_key VARCHAR(20) NOT NULL,
+  epic VARCHAR(20) NOT NULL,
+  title VARCHAR(255),
+  status VARCHAR(30) NOT NULL DEFAULT 'planned',
+  spec_path VARCHAR(500),
+  created_at DATETIME,
+  updated_at DATETIME,
+  completed_at DATETIME,
   PRIMARY KEY (story_key)
 )
 `.trim();
@@ -7906,31 +7995,33 @@ CREATE TABLE IF NOT EXISTS story_dependencies (
   depends_on VARCHAR(50) NOT NULL,
   dependency_type VARCHAR(50) NOT NULL DEFAULT 'blocks',
   source VARCHAR(50) NOT NULL DEFAULT 'explicit',
+  created_at DATETIME,
   PRIMARY KEY (story_key, depends_on)
 )
 `.trim();
 const CREATE_READY_STORIES_VIEW = `
 CREATE VIEW IF NOT EXISTS ready_stories AS
 SELECT s.*
-FROM stories s
-WHERE s.status = 'planned'
+FROM wg_stories s
+WHERE s.status IN ('planned', 'ready')
   AND NOT EXISTS (
     SELECT 1 FROM story_dependencies sd
-    JOIN stories blocking ON sd.depends_on = blocking.story_key
+    JOIN wg_stories blocking ON sd.depends_on = blocking.story_key
     WHERE sd.story_key = s.story_key
-      AND blocking.status != 'done'
+      AND sd.dependency_type = 'blocks'
+      AND blocking.status <> 'complete'
   )
 `.trim();
 
 //#endregion
 //#region src/modules/work-graph/epic-parser.ts
-/** Regex for sprint header lines: `**Sprint 1 —` (em dash or hyphen) */
-const SPRINT_HEADER_RE = /^\*\*Sprint\s+(\d+)\s*[—–-]/i;
+/** Regex for sprint header lines: `**Sprint 1 —` or `Sprint 1 —` (with or without bold markers) */
+const SPRINT_HEADER_RE = /^(?:\*\*)?Sprint\s+(\d+)\s*[—–-]/i;
 /**
 * Regex for story lines: `- 31-2: Epic doc ingestion (P0, Medium)`
 * Captures: epicNum, storyNum, title, priority, size
 */
-const STORY_LINE_RE = /^-\s+(\d+)-(\d+):\s+(.+?)\s+\((P\d+),\s+([\w-]+)\)\s*$/;
+const STORY_LINE_RE = /^(?:-\s+)?(?:Story\s+)?(\d+)-(\d+):\s+(.+?)\s+\((P\d+),\s+([\w-]+)\)\s*$/;
 /** Regex to find the story map section heading */
 const STORY_MAP_HEADING_RE = /^#{1,6}\s+.*Story\s+Map/im;
 /** Regex to find the dependency chain line */
@@ -7953,6 +8044,7 @@ var EpicParser = class {
 		let currentSprint = 0;
 		for (const rawLine of afterHeading.split("\n")) {
 			const line = rawLine.trim();
+			if (line.startsWith("```")) continue;
 			const sprintMatch = SPRINT_HEADER_RE.exec(line);
 			if (sprintMatch) {
 				currentSprint = parseInt(sprintMatch[1], 10);
@@ -8043,24 +8135,21 @@ var EpicIngester = class {
 		return this.adapter.transaction(async (tx) => {
 			let storiesUpserted = 0;
 			for (const story of stories) {
-				const existing = await tx.query("SELECT status FROM stories WHERE story_key = ?", [story.story_key]);
-				if (existing.length > 0) await tx.query("UPDATE stories SET title = ?, priority = ?, size = ?, sprint = ? WHERE story_key = ?", [
+				const existing = await tx.query("SELECT status FROM wg_stories WHERE story_key = ?", [story.story_key]);
+				if (existing.length > 0) await tx.query("UPDATE wg_stories SET title = ?, updated_at = ? WHERE story_key = ?", [
 					story.title,
-					story.priority,
-					story.size,
-					story.sprint,
+					new Date().toISOString(),
 					story.story_key
 				]);
 				else {
-					await tx.query("INSERT INTO stories (story_key, epic_num, story_num, title, priority, size, sprint, status) VALUES (?, ?, ?, ?, ?, ?, ?, ?)", [
+					const now = new Date().toISOString();
+					await tx.query("INSERT INTO wg_stories (story_key, epic, title, status, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?)", [
 						story.story_key,
-						story.epic_num,
-						story.story_num,
+						String(story.epic_num),
 						story.title,
-						story.priority,
-						story.size,
-						story.sprint,
-						"planned"
+						"planned",
+						now,
+						now
 					]);
 					storiesUpserted++;
 				}

package/dist/{experimenter-CoR0k66d.js → experimenter-CjfzjmwY.js}

@@ -1,6 +1,6 @@
 import "./logger-D2fS2ccL.js";
 import { createDecision } from "./decisions-C6MF2Cax.js";
-import { EXPERIMENT_RESULT, getRunMetrics, getStoryMetricsForRun } from "./operational-CidppHy-.js";
+import { EXPERIMENT_RESULT, getRunMetrics, getStoryMetricsForRun } from "./operational-BRpT8MYF.js";
 import { spawnGit } from "./git-utils-C-fdrHF_.js";
 import { spawn } from "node:child_process";
 import { join } from "node:path";
@@ -500,4 +500,4 @@ function createExperimenter(config, deps) {
 
 //#endregion
 export { createExperimenter };
-//# sourceMappingURL=experimenter-CoR0k66d.js.map
+//# sourceMappingURL=experimenter-CjfzjmwY.js.map

package/dist/index.d.ts

@@ -1514,6 +1514,19 @@ interface AdapterOptions {
    * so the telemetry pipeline can group spans/events per story.
    */
   storyKey?: string;
+  /**
+   * Optional maximum context tokens (passed as --max-context-tokens to Claude CLI).
+   * When set, constrains the context window to prevent runaway token usage.
+   * Used by efficiency-gated retry logic (Story 30-8) to cap context for stories
+   * that previously exhibited context spike patterns.
+   */
+  maxContextTokens?: number;
+  /**
+   * Optional optimization directives derived from prior stories' telemetry (Story 30-6).
+   * When set, appended to the system prompt to guide the sub-agent toward efficient patterns.
+   * Generated by TelemetryAdvisor.formatOptimizationDirectives().
+   */
+  optimizationDirectives?: string;
 }
 /**
  * Capabilities reported by an adapter for this CLI agent.

package/dist/index.js

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

package/dist/{operational-CidppHy-.js → operational-BRpT8MYF.js}

@@ -186,7 +186,7 @@ async function aggregateTokenUsageForStory(adapter, runId, storyKey) {
     FROM token_usage
     WHERE pipeline_run_id = ?
       AND metadata IS NOT NULL
-      AND json_extract(metadata, '$.storyKey') = ?`, [runId, storyKey]);
+      AND metadata LIKE ?`, [runId, `%"storyKey":"${storyKey}"%`]);
 	return rows[0] ?? {
 		input: 0,
 		output: 0,
@@ -371,4 +371,4 @@ const ADVISORY_NOTES = "advisory-notes";
 
 //#endregion
 export { ADVISORY_NOTES, ESCALATION_DIAGNOSIS, EXPERIMENT_RESULT, OPERATIONAL_FINDING, STORY_METRICS, STORY_OUTCOME, TEST_EXPANSION_FINDING, TEST_PLAN, aggregateTokenUsageForRun, aggregateTokenUsageForStory, compareRunMetrics, getBaselineRunMetrics, getRunMetrics, getStoryMetricsForRun, incrementRunRestarts, listRunMetrics, tagRunAsBaseline, writeRunMetrics, writeStoryMetrics };
-//# sourceMappingURL=operational-CidppHy-.js.map
+//# sourceMappingURL=operational-BRpT8MYF.js.map