substrate-ai 0.20.92 → 0.20.94

package/dist/adapter-registry-Bvox1eRm.js

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

package/dist/cli/index.js

@@ -1,20 +1,20 @@
 #!/usr/bin/env node
-import { FileStateStore, SUBSTRATE_OWNED_SETTINGS_KEYS, VALID_PHASES, buildPipelineStatusOutput, createDatabaseAdapter, createDoltOperatorReader, createStateStore, findPackageRoot, formatOutput, formatPipelineStatusHuman, formatPipelineSummary, formatTokenTelemetry, getAllDescendantPids, getAutoHealthData, getSubstrateDefaultSettings, inspectProcessTree, parseDbTimestampAsUtc, registerHealthCommand, resolveBmadMethodSrcPath, resolveBmadMethodVersion } from "../health-dWYa13k4.js";
+import { FileStateStore, SUBSTRATE_OWNED_SETTINGS_KEYS, VALID_PHASES, buildPipelineStatusOutput, createDatabaseAdapter, createDoltOperatorReader, createStateStore, findPackageRoot, formatOutput, formatPipelineStatusHuman, formatPipelineSummary, formatTokenTelemetry, getAllDescendantPids, getAutoHealthData, getSubstrateDefaultSettings, inspectProcessTree, parseDbTimestampAsUtc, registerHealthCommand, resolveBmadMethodSrcPath, resolveBmadMethodVersion } from "../health-CzZ2Ki-b.js";
 import { createLogger } from "../logger-KeHncl-f.js";
 import { createEventBus } from "../helpers-CElYrONe.js";
-import { AdapterRegistry, BudgetConfigSchema, CURRENT_CONFIG_FORMAT_VERSION, CURRENT_TASK_GRAPH_VERSION, ConfigError, CostTrackerConfigSchema, DEFAULT_CONFIG, DoltClient, DoltNotInstalled, GlobalSettingsSchema, InMemoryDatabaseAdapter, IngestionServer, MonitorDatabaseImpl, OPERATIONAL_FINDING, PartialGlobalSettingsSchema, PartialProviderConfigSchema, ProvidersSchema, RoutingRecommender, STORY_METRICS, TelemetryConfigSchema, addTokenUsage, aggregateTokenUsageForRun, checkDoltInstalled, compareRunMetrics, createAmendmentRun, createConfigSystem, createDecision, createDoltClient, createPipelineRun, getActiveDecisions, getAllCostEntriesFiltered, getBaselineRunMetrics, getDecisionsByCategory, getDecisionsByPhaseForRun, getLatestCompletedRun, getLatestRun, getPipelineRunById, getPlanningCostTotal, getRetryableEscalations, getRunMetrics, getRunningPipelineRuns, getSessionCostSummary, getSessionCostSummaryFiltered, getStoryMetricsForRun, getTokenUsageSummary, incrementRunRestarts, initSchema, initializeDolt, listRunMetrics, loadParentRunDecisions, supersedeDecision, swallowDebug, tagRunAsBaseline, updatePipelineRun } from "../dist-l0pA6zZF.js";
-import { AdapterTelemetryPersistence, AppError, DoltRepoMapMetaRepository, DoltSymbolRepository, ERR_REPO_MAP_STORAGE_WRITE, EpicIngester, GLOBSTAR, GitClient, GrammarLoader, Minimatch, Minipass, RepoMapInjector, RepoMapModule, RepoMapQueryEngine, RepoMapStorage, SymbolParser, createContextCompiler, createDispatcher, createEventEmitter, createGitWorktreeManager, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStopAfterGate, createTelemetryAdvisor, escape, formatPhaseCompletionSummary, getFactoryRunSummaries, getScenarioResultsForRun, getTwinRunsForRun, listGraphRuns, registerExportCommand, registerFactoryCommand, registerRunCommand, registerScenariosCommand, resolveStoryKeys, runAnalysisPhase, runPlanningPhase, runProbeAuthor, runSolutioningPhase, unescape, validateStopAfterFromConflict } from "../run-BXRwQRst.js";
+import { AdapterRegistry, BudgetConfigSchema, CURRENT_CONFIG_FORMAT_VERSION, CURRENT_TASK_GRAPH_VERSION, ConfigError, CostTrackerConfigSchema, DEFAULT_CONFIG, DoltClient, DoltNotInstalled, GlobalSettingsSchema, InMemoryDatabaseAdapter, IngestionServer, MonitorDatabaseImpl, OPERATIONAL_FINDING, PartialGlobalSettingsSchema, PartialProviderConfigSchema, ProvidersSchema, RoutingRecommender, STORY_METRICS, TelemetryConfigSchema, addTokenUsage, aggregateTokenUsageForRun, checkDoltInstalled, compareRunMetrics, createAmendmentRun, createConfigSystem, createDecision, createDoltClient, createPipelineRun, getActiveDecisions, getAllCostEntriesFiltered, getBaselineRunMetrics, getDecisionsByCategory, getDecisionsByPhaseForRun, getLatestCompletedRun, getLatestRun, getPipelineRunById, getPlanningCostTotal, getRetryableEscalations, getRunMetrics, getRunningPipelineRuns, getSessionCostSummary, getSessionCostSummaryFiltered, getStoryMetricsForRun, getTokenUsageSummary, incrementRunRestarts, initSchema, initializeDolt, listRunMetrics, loadParentRunDecisions, supersedeDecision, swallowDebug, tagRunAsBaseline, updatePipelineRun } from "../dist-C_NE40jY.js";
+import { AdapterTelemetryPersistence, AppError, DoltRepoMapMetaRepository, DoltSymbolRepository, ERR_REPO_MAP_STORAGE_WRITE, EpicIngester, GLOBSTAR, GitClient, GrammarLoader, Minimatch, Minipass, RepoMapInjector, RepoMapModule, RepoMapQueryEngine, RepoMapStorage, SymbolParser, createContextCompiler, createDispatcher, createEventEmitter, createGitWorktreeManager, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStopAfterGate, createTelemetryAdvisor, escape, formatPhaseCompletionSummary, getFactoryRunSummaries, getScenarioResultsForRun, getTwinRunsForRun, listGraphRuns, registerExportCommand, registerFactoryCommand, registerRunCommand, registerScenariosCommand, resolveStoryKeys, runAnalysisPhase, runPlanningPhase, runProbeAuthor, runSolutioningPhase, unescape, validateStopAfterFromConflict } from "../run-BclTZX96.js";
 import "../adapter-registry-DIcrxjH8.js";
-import { RunManifest, SupervisorLock, ZERO_FINDINGS_BY_AUTHOR, ZERO_FINDING_COUNTS, ZERO_PROBE_AUTHOR_METRICS, aggregateProbeAuthorMetrics, parseRuntimeProbes, readCurrentRunId, resolveMainRepoRoot, resolveRunManifest, rollupFindingCounts, rollupFindingsByAuthor, rollupProbeAuthorByClass, rollupProbeAuthorMetrics, runAcTraceabilityCheck } from "../manifest-read-CSmDEOWH.js";
-import "../errors-DZuD2tVU.js";
+import { RunManifest, SupervisorLock, ZERO_FINDINGS_BY_AUTHOR, ZERO_FINDING_COUNTS, ZERO_PROBE_AUTHOR_METRICS, aggregateProbeAuthorMetrics, parseRuntimeProbes, readCurrentRunId, resolveMainRepoRoot, resolveRunManifest, rollupFindingCounts, rollupFindingsByAuthor, rollupProbeAuthorByClass, rollupProbeAuthorMetrics, runAcTraceabilityCheck } from "../manifest-read-BSsjVG96.js";
+import "../errors-D531Z8FW.js";
 import "../routing-DFxoKHDt.js";
 import { WorkGraphRepository } from "../work-graph-repository-DZyJv5pV.js";
 import "../decisions-CzSIEeGP.js";
 import "../decision-router-DblHY8se.js";
-import "../interactive-prompt-DY-PFko-.js";
+import "../interactive-prompt-DF-PL5ia.js";
 import "../recovery-engine-BKGBeBnW.js";
 import "../version-manager-impl-qFBiO4Eh.js";
-import { registerUpgradeCommand } from "../upgrade-BP0P3qr9.js";
+import { registerUpgradeCommand } from "../upgrade-C1KzAZQE.js";
 import { Command } from "commander";
 import { fileURLToPath } from "url";
 import { dirname, join, resolve } from "path";
@@ -2109,10 +2109,7 @@ async function runInitAction(options) {
 		let doltInitialized = false;
 		if (doltMode !== "skip") try {
 			if (doltMode === "auto") await checkDoltInstalled();
-			await initializeDolt({
-				projectRoot,
-				schemaPath: fileURLToPath$1(new URL("../schema.sql", import.meta.url))
-			});
+			await initializeDolt({ projectRoot });
 			doltInitialized = true;
 		} catch (err) {
 			if (err instanceof DoltNotInstalled) {
@@ -6890,7 +6887,7 @@ async function runStatusAction(options) {
 			logger$15.debug({ err }, "Work graph query failed, continuing without work graph data");
 		}
 		if (run === void 0) {
-			const { inspectProcessTree: inspectProcessTree$1 } = await import("../health-CgY9akax.js");
+			const { inspectProcessTree: inspectProcessTree$1 } = await import("../health-C0bSSccV.js");
 			const substrateDirPath = join(projectRoot, ".substrate");
 			const processInfo = inspectProcessTree$1({
 				projectRoot,
@@ -7838,7 +7835,7 @@ function defaultSupervisorDeps() {
 				if (cached === null) {
 					const { AdapterRegistry: AR } = await import(
 						/* @vite-ignore */
-						"../adapter-registry-BZ0cVi8C.js"
+						"../adapter-registry-Bvox1eRm.js"
 );
 					cached = new AR();
 					await cached.discoverAndRegister();
@@ -8405,11 +8402,11 @@ async function runSupervisorAction(options, deps = {}) {
 						try {
 							const { createExperimenter } = await import(
 								/* @vite-ignore */
-								"../experimenter-GfhQpMis.js"
+								"../experimenter-Cg2fBeVq.js"
 );
 							const { getLatestRun: getLatest } = await import(
 								/* @vite-ignore */
-								"../decisions-CsNAM-T-.js"
+								"../decisions-CNe9RlcE.js"
 );
 							const expAdapter = createDatabaseAdapter({
 								backend: "auto",
@@ -8419,7 +8416,7 @@ async function runSupervisorAction(options, deps = {}) {
 								await initSchema(expAdapter);
 								const { runRunAction: runPipeline } = await import(
 									/* @vite-ignore */
-									"../run-DPQ4DT5Q.js"
+									"../run-BG0IDIES.js"
 );
 								const runStoryFn = async (opts) => {
 									const exitCode = await runPipeline({
@@ -8947,7 +8944,7 @@ async function runMetricsAction(options) {
 			const routingConfigPath = join(dbDir, "routing.yml");
 			let routingConfig = null;
 			if (existsSync$1(routingConfigPath)) try {
-				const { loadModelRoutingConfig } = await import("../routing-CD5PGDLe.js");
+				const { loadModelRoutingConfig } = await import("../routing-Cptl6Ali.js");
 				routingConfig = loadModelRoutingConfig(routingConfigPath);
 			} catch {}
 			if (routingConfig === null) routingConfig = {
@@ -13321,8 +13318,8 @@ async function createProgram() {
 /** Fire-and-forget startup version check (story 8.3, AC3/AC5) */
 function checkForUpdatesInBackground(currentVersion) {
 	if (process.env.SUBSTRATE_NO_UPDATE_CHECK === "1") return;
-	import("../upgrade-DCDe5u0P.js").then(async () => {
-		const { createVersionManager } = await import("../version-manager-impl-B8MpvZQz.js");
+	import("../upgrade--vRnNB3V.js").then(async () => {
+		const { createVersionManager } = await import("../version-manager-impl-9J_JCJPu.js");
 		const vm = createVersionManager();
 		const result = await vm.checkForUpdates();
 		if (result.updateAvailable) {

package/dist/{decisions-CsNAM-T-.js → decisions-CNe9RlcE.js}

@@ -1,4 +1,4 @@
-import { addTokenUsage, createDecision, createPipelineRun, createRequirement, getArtifactByTypeForRun, getArtifactsByRun, getDecisionsByCategory, getDecisionsByPhase, getDecisionsByPhaseForRun, getLatestRun, getPipelineRunById, getRunningPipelineRuns, getTokenUsageSummary, listRequirements, registerArtifact, updateDecision, updatePipelineRun, updatePipelineRunConfig, upsertDecision } from "./dist-l0pA6zZF.js";
+import { addTokenUsage, createDecision, createPipelineRun, createRequirement, getArtifactByTypeForRun, getArtifactsByRun, getDecisionsByCategory, getDecisionsByPhase, getDecisionsByPhaseForRun, getLatestRun, getPipelineRunById, getRunningPipelineRuns, getTokenUsageSummary, listRequirements, registerArtifact, updateDecision, updatePipelineRun, updatePipelineRunConfig, upsertDecision } from "./dist-C_NE40jY.js";
 import "./decisions-CzSIEeGP.js";
 
 export { getLatestRun };

package/dist/{dist-l0pA6zZF.js → dist-C_NE40jY.js}

@@ -3103,6 +3103,142 @@ async function initSchema(adapter) {
       applied_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP
     )
   `);
+	await adapter.exec(`
+    CREATE TABLE IF NOT EXISTS stories (
+      story_key       VARCHAR(100)   NOT NULL,
+      sprint          VARCHAR(50),
+      status          VARCHAR(30)    NOT NULL DEFAULT 'PENDING',
+      phase           VARCHAR(30)    NOT NULL DEFAULT 'PENDING',
+      ac_results      JSON,
+      error_message   TEXT,
+      created_at      DATETIME,
+      updated_at      DATETIME,
+      completed_at    DATETIME,
+      PRIMARY KEY (story_key)
+    )
+  `);
+	await adapter.exec(`
+    CREATE TABLE IF NOT EXISTS contracts (
+      story_key    VARCHAR(100)   NOT NULL,
+      name         VARCHAR(200)   NOT NULL,
+      direction    VARCHAR(20)    NOT NULL,
+      schema_path  VARCHAR(500),
+      transport    VARCHAR(200),
+      recorded_at  DATETIME,
+      PRIMARY KEY (story_key, name, direction)
+    )
+  `);
+	await adapter.exec(`
+    CREATE TABLE IF NOT EXISTS metrics (
+      story_key          VARCHAR(100)   NOT NULL,
+      task_type          VARCHAR(100)   NOT NULL,
+      recorded_at        DATETIME       NOT NULL,
+      model              VARCHAR(100),
+      tokens_in          BIGINT         NOT NULL DEFAULT 0,
+      tokens_out         BIGINT         NOT NULL DEFAULT 0,
+      cache_read_tokens  BIGINT         NOT NULL DEFAULT 0,
+      cost_usd           DECIMAL(10,6)  NOT NULL DEFAULT 0,
+      wall_clock_ms      BIGINT         NOT NULL DEFAULT 0,
+      review_cycles      INT            NOT NULL DEFAULT 0,
+      stall_count        INT            NOT NULL DEFAULT 0,
+      result             VARCHAR(30),
+      PRIMARY KEY (story_key, task_type, recorded_at)
+    )
+  `);
+	await adapter.exec(`
+    CREATE TABLE IF NOT EXISTS dispatch_log (
+      story_key      VARCHAR(100)   NOT NULL,
+      dispatched_at  DATETIME       NOT NULL,
+      branch         VARCHAR(200),
+      worker_id      VARCHAR(100),
+      result         VARCHAR(30),
+      PRIMARY KEY (story_key, dispatched_at)
+    )
+  `);
+	await adapter.exec(`
+    CREATE TABLE IF NOT EXISTS build_results (
+      story_key    VARCHAR(100)   NOT NULL,
+      timestamp    DATETIME       NOT NULL,
+      command      VARCHAR(500),
+      exit_code    INT,
+      stdout_hash  VARCHAR(64),
+      PRIMARY KEY (story_key, timestamp)
+    )
+  `);
+	await adapter.exec(`
+    CREATE TABLE IF NOT EXISTS review_verdicts (
+      story_key     VARCHAR(100)   NOT NULL,
+      timestamp     DATETIME       NOT NULL,
+      verdict       VARCHAR(30),
+      issues_count  INT            NOT NULL DEFAULT 0,
+      notes         TEXT,
+      PRIMARY KEY (story_key, timestamp)
+    )
+  `);
+	await adapter.exec(`
+    CREATE TABLE IF NOT EXISTS _schema_version (
+      version      INT            NOT NULL,
+      applied_at   DATETIME       NOT NULL DEFAULT CURRENT_TIMESTAMP,
+      description  VARCHAR(500),
+      PRIMARY KEY (version)
+    )
+  `);
+	try {
+		await adapter.exec(`INSERT IGNORE INTO _schema_version (version, description) VALUES (1, 'Initial substrate state schema')`);
+	} catch {}
+	try {
+		await adapter.exec(`INSERT IGNORE INTO _schema_version (version, description) VALUES (2, 'Add turn_analysis table (Epic 27-4)')`);
+	} catch {}
+	try {
+		await adapter.exec(`INSERT IGNORE INTO _schema_version (version, description) VALUES (3, 'Add category_stats and consumer_stats tables (Epic 27-5)')`);
+	} catch {}
+	try {
+		await adapter.exec(`INSERT IGNORE INTO _schema_version (version, description) VALUES (4, 'Add recommendations table (Epic 27-7)')`);
+	} catch {}
+	try {
+		await adapter.exec(`INSERT IGNORE INTO _schema_version (version, description) VALUES (5, 'Add repo_map_symbols and repo_map_meta tables (Epic 28-2)')`);
+	} catch {}
+	try {
+		await adapter.exec(`INSERT IGNORE INTO _schema_version (version, description) VALUES (6, 'Add dependencies JSON column to repo_map_symbols (Epic 28-3)')`);
+	} catch {}
+	try {
+		await adapter.exec(`INSERT IGNORE INTO _schema_version (version, description) VALUES (7, 'Add wg_stories, story_dependencies tables and ready_stories view (Epic 31-1)')`);
+	} catch {}
+	try {
+		await adapter.exec(`INSERT IGNORE INTO _schema_version (version, description) VALUES (8, 'Add task_type, phase, dispatch_id columns to turn_analysis (Story 30-1)')`);
+	} catch {}
+	try {
+		await adapter.exec(`INSERT IGNORE INTO _schema_version (version, description) VALUES (9, 'Add dispatch_id, task_type, phase columns to efficiency_scores (Story 30-3)')`);
+	} catch {}
+	await adapter.exec(`
+    CREATE TABLE IF NOT EXISTS repo_map_symbols (
+      id          BIGINT AUTO_INCREMENT NOT NULL,
+      file_path   VARCHAR(1000)         NOT NULL,
+      symbol_name VARCHAR(500)          NOT NULL,
+      symbol_kind VARCHAR(20)           NOT NULL,
+      signature   TEXT,
+      line_number INT                   NOT NULL DEFAULT 0,
+      exported    TINYINT(1)            NOT NULL DEFAULT 0,
+      file_hash   VARCHAR(64)           NOT NULL,
+      dependencies JSON,
+      PRIMARY KEY (id)
+    )
+  `);
+	await adapter.exec("CREATE INDEX IF NOT EXISTS idx_repo_map_symbols_file ON repo_map_symbols (file_path)");
+	await adapter.exec("CREATE INDEX IF NOT EXISTS idx_repo_map_symbols_kind ON repo_map_symbols (symbol_kind)");
+	await adapter.exec(`
+    CREATE TABLE IF NOT EXISTS repo_map_meta (
+      id          INT      NOT NULL DEFAULT 1,
+      commit_sha  VARCHAR(64),
+      updated_at  DATETIME,
+      file_count  INT      NOT NULL DEFAULT 0,
+      PRIMARY KEY (id)
+    )
+  `);
+	await adapter.exec("CREATE INDEX IF NOT EXISTS idx_efficiency_story ON efficiency_scores (story_key, timestamp DESC)");
+	await adapter.exec("CREATE INDEX IF NOT EXISTS idx_recommendations_story ON recommendations (story_key, severity)");
+	await adapter.exec("CREATE INDEX IF NOT EXISTS idx_category_stats_story ON category_stats (story_key, total_tokens)");
+	await adapter.exec("CREATE INDEX IF NOT EXISTS idx_consumer_stats_story ON consumer_stats (story_key, total_tokens)");
 }
 
 //#endregion
@@ -5032,17 +5168,21 @@ async function runDoltConfigSet(key, value) {
 * Initialize a Dolt repository for Substrate state storage.
 *
 * This function is idempotent: running it a second time on an already-
-* initialized repository is safe — `dolt init` is skipped, existing tables
-* are not re-created (IF NOT EXISTS guards), and the schema version row is
-* not duplicated (INSERT IGNORE).
+* initialized repository is safe — `dolt init` is skipped, and the initial
+* empty-repo commit is not re-created.
+*
+* Post-Ship-3 (2026-05): no DDL is applied here. The runtime `initSchema()`
+* call on first `substrate run` creates all tables idempotently via
+* `CREATE TABLE IF NOT EXISTS` + try/catch `ALTER ADD COLUMN`. Existing
+* repos auto-migrate transparently; fresh repos pay one extra `substrate run`
+* invocation before tables exist.
 *
-* @param config - Initialization configuration. `schemaPath` is required.
+* @param config - Initialization configuration.
 * @throws {DoltNotInstalled} If the `dolt` binary is not in PATH.
 * @throws {DoltInitError} If any Dolt CLI command fails.
 */
 async function initializeDolt(config) {
 	const statePath = config.statePath ?? join$1(config.projectRoot, ".substrate", "state");
-	const schemaPath = config.schemaPath;
 	await checkDoltInstalled();
 	await mkdir$1(statePath, { recursive: true });
 	await ensureDoltIdentity();
@@ -5055,11 +5195,6 @@ async function initializeDolt(config) {
 		doltDirExists = false;
 	}
 	if (!doltDirExists) await runDoltCommand(["init"], statePath);
-	await runDoltCommand([
-		"sql",
-		"-f",
-		schemaPath
-	], statePath);
 	let hasCommits = false;
 	try {
 		await runDoltCommand(["log", "--oneline"], statePath);
@@ -5071,8 +5206,9 @@ async function initializeDolt(config) {
 		await runDoltCommand(["add", "-A"], statePath);
 		await runDoltCommand([
 			"commit",
+			"--allow-empty",
 			"-m",
-			"Initialize substrate state schema v1"
+			"Initialize substrate state repo"
 		], statePath);
 	}
 }
@@ -11155,4 +11291,4 @@ async function callLLM(params) {
 
 //#endregion
 export { ADVISORY_NOTES, AdapterRegistry, AdtError, BudgetConfigSchema, CURRENT_CONFIG_FORMAT_VERSION, CURRENT_TASK_GRAPH_VERSION, Categorizer, ClaudeCodeAdapter, CodexCLIAdapter, ConfigError, ConfigIncompatibleFormatError, ConsumerAnalyzer, CostTrackerConfigSchema, DEFAULT_CONFIG, DEFAULT_GLOBAL_SETTINGS, DispatcherImpl, DoltClient, DoltNotInstalled, DoltQueryError, ESCALATION_DIAGNOSIS, EXPERIMENT_RESULT, EfficiencyScorer, GeminiCLIAdapter, GlobalSettingsSchema, InMemoryDatabaseAdapter, IngestionServer, LEARNING_FINDING, LogTurnAnalyzer, ModelRoutingConfigSchema, MonitorDatabaseImpl, OPERATIONAL_FINDING, PartialGlobalSettingsSchema, PartialProviderConfigSchema, ProviderPolicySchema, ProvidersSchema, Recommender, RoutingConfigError, RoutingRecommender, RoutingResolver, RoutingTelemetry, RoutingTokenAccumulator, RoutingTuner, STORY_METRICS, STORY_OUTCOME, SubstrateConfigSchema, TASK_TYPE_PHASE_MAP, TEST_EXPANSION_FINDING, TEST_PLAN, TelemetryConfigSchema, TelemetryNormalizer, TelemetryPipeline, TurnAnalyzer, VersionManagerImpl, addTokenUsage, aggregateTokenUsageForRun, aggregateTokenUsageForStory, buildAuditLogEntry, buildBranchName, buildModificationDirective, buildPRBody, buildWorktreePath, callLLM, checkDoltInstalled, classifyVersionGap, compareRunMetrics, createAmendmentRun, createConfigSystem, createDatabaseAdapter as createDatabaseAdapter$1, createDecision, createDoltClient, createExperimenter, createPipelineRun, createRequirement, createVersionManager, detectInterfaceChanges, determineVerdict, getActiveDecisions, getAllCostEntriesFiltered, getArtifactByTypeForRun, getArtifactsByRun, getBaselineRunMetrics, getDecisionsByCategory, getDecisionsByPhase, getDecisionsByPhaseForRun, getLatestCompletedRun, getLatestRun, getModelTier, getPipelineRunById, getPlanningCostTotal, getRetryableEscalations, getRunMetrics, getRunningPipelineRuns, getSessionCostSummary, getSessionCostSummaryFiltered, getStoryMetricsForRun, getTokenUsageSummary, incrementRunRestarts, initSchema, initializeDolt, listRequirements, listRunMetrics, loadModelRoutingConfig, loadParentRunDecisions, registerArtifact, resolvePromptFile, supersedeDecision, swallowDebug, tagRunAsBaseline, updateDecision, updatePipelineRun, updatePipelineRunConfig, upsertDecision, writeRunMetrics, writeStoryMetrics };
-//# sourceMappingURL=dist-l0pA6zZF.js.map
+//# sourceMappingURL=dist-C_NE40jY.js.map

package/dist/{errors-DZuD2tVU.js → errors-D531Z8FW.js}

@@ -1,4 +1,4 @@
-import { AdtError } from "./dist-l0pA6zZF.js";
+import { AdtError } from "./dist-C_NE40jY.js";
 
 //#region src/core/errors.ts
 /** Error thrown when task configuration is invalid */
@@ -71,4 +71,4 @@ var TaskGraphIncompatibleFormatError = class extends AdtError {
 
 //#endregion
 export { BudgetExceededError, GitError, RecoveryError, TaskConfigError, TaskGraphCycleError, TaskGraphError, TaskGraphIncompatibleFormatError, WorkerError, WorkerNotFoundError };
-//# sourceMappingURL=errors-DZuD2tVU.js.map
+//# sourceMappingURL=errors-D531Z8FW.js.map

package/dist/{experimenter-GfhQpMis.js → experimenter-Cg2fBeVq.js}

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

package/dist/{health-CgY9akax.js → health-C0bSSccV.js}

@@ -1,7 +1,7 @@
-import { DEFAULT_STALL_THRESHOLD_SECONDS, getAllDescendantPids, getAutoHealthData, inspectProcessTree, isOrchestratorProcessLine, registerHealthCommand, runHealthAction } from "./health-dWYa13k4.js";
+import { DEFAULT_STALL_THRESHOLD_SECONDS, getAllDescendantPids, getAutoHealthData, inspectProcessTree, isOrchestratorProcessLine, registerHealthCommand, runHealthAction } from "./health-CzZ2Ki-b.js";
 import "./logger-KeHncl-f.js";
-import "./dist-l0pA6zZF.js";
-import "./manifest-read-CSmDEOWH.js";
+import "./dist-C_NE40jY.js";
+import "./manifest-read-BSsjVG96.js";
 import "./work-graph-repository-DZyJv5pV.js";
 import "./decisions-CzSIEeGP.js";
 

package/dist/{health-dWYa13k4.js → health-CzZ2Ki-b.js}

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

package/dist/index.js

@@ -1,8 +1,8 @@
 import { childLogger, createLogger, logger } from "./logger-KeHncl-f.js";
 import { assertDefined, createEventBus, createTuiApp, deepClone, formatDuration, generateId, isPlainObject, isTuiCapable, printNonTtyWarning, sleep, withRetry } from "./helpers-CElYrONe.js";
-import { AdapterRegistry, AdtError, ClaudeCodeAdapter, CodexCLIAdapter, ConfigError, ConfigIncompatibleFormatError, GeminiCLIAdapter } from "./dist-l0pA6zZF.js";
+import { AdapterRegistry, AdtError, ClaudeCodeAdapter, CodexCLIAdapter, ConfigError, ConfigIncompatibleFormatError, GeminiCLIAdapter } from "./dist-C_NE40jY.js";
 import "./adapter-registry-DIcrxjH8.js";
-import { BudgetExceededError, GitError, RecoveryError, TaskConfigError, TaskGraphCycleError, TaskGraphError, TaskGraphIncompatibleFormatError, WorkerError, WorkerNotFoundError } from "./errors-DZuD2tVU.js";
+import { BudgetExceededError, GitError, RecoveryError, TaskConfigError, TaskGraphCycleError, TaskGraphError, TaskGraphIncompatibleFormatError, WorkerError, WorkerNotFoundError } from "./errors-D531Z8FW.js";
 
 //#region src/core/di.ts
 /**

package/dist/{interactive-prompt-DY-PFko-.js → interactive-prompt-DF-PL5ia.js}

@@ -1,5 +1,5 @@
 import { createLogger } from "./logger-KeHncl-f.js";
-import { readCurrentRunId, resolveMainRepoRoot } from "./manifest-read-CSmDEOWH.js";
+import { readCurrentRunId, resolveMainRepoRoot } from "./manifest-read-BSsjVG96.js";
 import { join } from "node:path";
 import { mkdir, readFile, writeFile } from "node:fs/promises";
 import * as readline from "node:readline";
@@ -180,4 +180,4 @@ async function runInteractivePrompt(decisionContext) {
 
 //#endregion
 export { runInteractivePrompt };
-//# sourceMappingURL=interactive-prompt-DY-PFko-.js.map
+//# sourceMappingURL=interactive-prompt-DF-PL5ia.js.map

package/dist/{manifest-read-CSmDEOWH.js → manifest-read-BSsjVG96.js}

@@ -1,5 +1,5 @@
 import { createLogger } from "./logger-KeHncl-f.js";
-import { LEARNING_FINDING, createDecision, getDecisionsByCategory } from "./dist-l0pA6zZF.js";
+import { LEARNING_FINDING, createDecision, getDecisionsByCategory } from "./dist-C_NE40jY.js";
 import * as path$1 from "path";
 import { join } from "path";
 import { readFile } from "fs/promises";
@@ -5845,4 +5845,4 @@ async function resolveRunManifest(dbRoot, runId) {
 
 //#endregion
 export { FindingsInjector, RunManifest, RuntimeProbeListSchema, SupervisorLock, ZERO_FINDINGS_BY_AUTHOR, ZERO_FINDING_COUNTS, ZERO_PROBE_AUTHOR_METRICS, aggregateProbeAuthorMetrics, applyConfigToGraph, createDefaultVerificationPipeline, createGraphOrchestrator, createSdlcCodeReviewHandler, createSdlcCreateStoryHandler, createSdlcDevStoryHandler, createSdlcPhaseHandler, detectsEventDrivenAC, detectsStateIntegratingAC, extractTargetFilesFromStoryContent, parseRuntimeProbes, readCurrentRunId, renderFindings, resolveGraphPath, resolveMainRepoRoot, resolveRunManifest, rollupFindingCounts, rollupFindingsByAuthor, rollupProbeAuthorByClass, rollupProbeAuthorMetrics, runAcTraceabilityCheck, runStaleVerificationRecovery };
-//# sourceMappingURL=manifest-read-CSmDEOWH.js.map
+//# sourceMappingURL=manifest-read-BSsjVG96.js.map

package/dist/modules/interactive-prompt/index.js

@@ -1,6 +1,6 @@
 import "../../logger-KeHncl-f.js";
-import "../../dist-l0pA6zZF.js";
-import "../../manifest-read-CSmDEOWH.js";
-import { runInteractivePrompt } from "../../interactive-prompt-DY-PFko-.js";
+import "../../dist-C_NE40jY.js";
+import "../../manifest-read-BSsjVG96.js";
+import { runInteractivePrompt } from "../../interactive-prompt-DF-PL5ia.js";
 
 export { runInteractivePrompt };

package/dist/{routing-CD5PGDLe.js → routing-Cptl6Ali.js}

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

package/dist/{run-DPQ4DT5Q.js → run-BG0IDIES.js}

@@ -1,14 +1,14 @@
-import "./health-dWYa13k4.js";
+import "./health-CzZ2Ki-b.js";
 import "./logger-KeHncl-f.js";
 import "./helpers-CElYrONe.js";
-import "./dist-l0pA6zZF.js";
-import { normalizeGraphSummaryToStatus, registerRunCommand, resolveMaxReviewCycles, resolveProbeAuthorStateIntegrating, runRunAction, wireNdjsonEmitter } from "./run-BXRwQRst.js";
-import "./manifest-read-CSmDEOWH.js";
+import "./dist-C_NE40jY.js";
+import { normalizeGraphSummaryToStatus, registerRunCommand, resolveMaxReviewCycles, resolveProbeAuthorStateIntegrating, runRunAction, wireNdjsonEmitter } from "./run-BclTZX96.js";
+import "./manifest-read-BSsjVG96.js";
 import "./routing-DFxoKHDt.js";
 import "./work-graph-repository-DZyJv5pV.js";
 import "./decisions-CzSIEeGP.js";
 import "./decision-router-DblHY8se.js";
-import "./interactive-prompt-DY-PFko-.js";
+import "./interactive-prompt-DF-PL5ia.js";
 import "./recovery-engine-BKGBeBnW.js";
 
 export { runRunAction };

package/dist/{run-BXRwQRst.js → run-BclTZX96.js}

@@ -1,11 +1,11 @@
-import { BMAD_BASELINE_TOKENS_FULL, DoltMergeConflict, FileStateStore, STOP_AFTER_VALID_PHASES, STORY_KEY_PATTERN, VALID_PHASES, __commonJS, __require, __toESM, buildPipelineStatusOutput, createDatabaseAdapter, formatOutput, formatPipelineSummary, formatTokenTelemetry, inspectProcessTree, parseDbTimestampAsUtc, validateStoryKey } from "./health-dWYa13k4.js";
+import { BMAD_BASELINE_TOKENS_FULL, DoltMergeConflict, FileStateStore, STOP_AFTER_VALID_PHASES, STORY_KEY_PATTERN, VALID_PHASES, __commonJS, __require, __toESM, buildPipelineStatusOutput, createDatabaseAdapter, formatOutput, formatPipelineSummary, formatTokenTelemetry, inspectProcessTree, parseDbTimestampAsUtc, validateStoryKey } from "./health-CzZ2Ki-b.js";
 import { createLogger } from "./logger-KeHncl-f.js";
 import { TypedEventBusImpl, createEventBus, createTuiApp, isTuiCapable, printNonTtyWarning, sleep } from "./helpers-CElYrONe.js";
-import { ADVISORY_NOTES, Categorizer, ConsumerAnalyzer, DEFAULT_GLOBAL_SETTINGS, DispatcherImpl, DoltClient, ESCALATION_DIAGNOSIS, EXPERIMENT_RESULT, EfficiencyScorer, IngestionServer, LogTurnAnalyzer, OPERATIONAL_FINDING, Recommender, RoutingRecommender, RoutingResolver, RoutingTelemetry, RoutingTokenAccumulator, RoutingTuner, STORY_METRICS, STORY_OUTCOME, SubstrateConfigSchema, TEST_EXPANSION_FINDING, TEST_PLAN, TelemetryNormalizer, TelemetryPipeline, TurnAnalyzer, addTokenUsage, aggregateTokenUsageForRun, aggregateTokenUsageForStory, callLLM, classifyVersionGap, createConfigSystem, createDatabaseAdapter$1, createDecision, createPipelineRun, createRequirement, detectInterfaceChanges, getArtifactByTypeForRun, getArtifactsByRun, getDecisionsByCategory, getDecisionsByPhase, getDecisionsByPhaseForRun, getLatestRun, getPipelineRunById, getRunMetrics, getRunningPipelineRuns, getStoryMetricsForRun, getTokenUsageSummary, initSchema, listRequirements, loadModelRoutingConfig, registerArtifact, swallowDebug, updatePipelineRun, updatePipelineRunConfig, upsertDecision, writeRunMetrics, writeStoryMetrics } from "./dist-l0pA6zZF.js";
-import { FindingsInjector, RunManifest, RuntimeProbeListSchema, applyConfigToGraph, createDefaultVerificationPipeline, createGraphOrchestrator, createSdlcCodeReviewHandler, createSdlcCreateStoryHandler, createSdlcDevStoryHandler, createSdlcPhaseHandler, detectsEventDrivenAC, detectsStateIntegratingAC, extractTargetFilesFromStoryContent, renderFindings, resolveGraphPath, resolveMainRepoRoot, runAcTraceabilityCheck, runStaleVerificationRecovery } from "./manifest-read-CSmDEOWH.js";
+import { ADVISORY_NOTES, Categorizer, ConsumerAnalyzer, DEFAULT_GLOBAL_SETTINGS, DispatcherImpl, DoltClient, ESCALATION_DIAGNOSIS, EXPERIMENT_RESULT, EfficiencyScorer, IngestionServer, LogTurnAnalyzer, OPERATIONAL_FINDING, Recommender, RoutingRecommender, RoutingResolver, RoutingTelemetry, RoutingTokenAccumulator, RoutingTuner, STORY_METRICS, STORY_OUTCOME, SubstrateConfigSchema, TEST_EXPANSION_FINDING, TEST_PLAN, TelemetryNormalizer, TelemetryPipeline, TurnAnalyzer, addTokenUsage, aggregateTokenUsageForRun, aggregateTokenUsageForStory, callLLM, classifyVersionGap, createConfigSystem, createDatabaseAdapter$1, createDecision, createPipelineRun, createRequirement, detectInterfaceChanges, getArtifactByTypeForRun, getArtifactsByRun, getDecisionsByCategory, getDecisionsByPhase, getDecisionsByPhaseForRun, getLatestRun, getPipelineRunById, getRunMetrics, getRunningPipelineRuns, getStoryMetricsForRun, getTokenUsageSummary, initSchema, listRequirements, loadModelRoutingConfig, registerArtifact, swallowDebug, updatePipelineRun, updatePipelineRunConfig, upsertDecision, writeRunMetrics, writeStoryMetrics } from "./dist-C_NE40jY.js";
+import { FindingsInjector, RunManifest, RuntimeProbeListSchema, applyConfigToGraph, createDefaultVerificationPipeline, createGraphOrchestrator, createSdlcCodeReviewHandler, createSdlcCreateStoryHandler, createSdlcDevStoryHandler, createSdlcPhaseHandler, detectsEventDrivenAC, detectsStateIntegratingAC, extractTargetFilesFromStoryContent, renderFindings, resolveGraphPath, resolveMainRepoRoot, runAcTraceabilityCheck, runStaleVerificationRecovery } from "./manifest-read-BSsjVG96.js";
 import { WorkGraphRepository, detectCycles } from "./work-graph-repository-DZyJv5pV.js";
 import { deriveExitCode, routeDecision } from "./decision-router-DblHY8se.js";
-import { runInteractivePrompt } from "./interactive-prompt-DY-PFko-.js";
+import { runInteractivePrompt } from "./interactive-prompt-DF-PL5ia.js";
 import { runRecoveryEngine } from "./recovery-engine-BKGBeBnW.js";
 import { basename, dirname, extname, join } from "path";
 import { access, readFile, readdir, stat } from "fs/promises";
@@ -47264,7 +47264,7 @@ async function runFullPipeline(options) {
 */
 async function emitPreDispatchVersionAdvisory(currentVersion) {
 	if (process.env["SUBSTRATE_NO_UPDATE_CHECK"] === "1") return;
-	const { createVersionManager } = await import("./version-manager-impl-B8MpvZQz.js");
+	const { createVersionManager } = await import("./version-manager-impl-9J_JCJPu.js");
 	const vm = createVersionManager();
 	const result = await vm.checkForUpdates(true);
 	const gap = classifyVersionGap(currentVersion, result.latestVersion);
@@ -47361,4 +47361,4 @@ function registerRunCommand(program, version = "0.0.0", projectRoot = process.cw
 
 //#endregion
 export { AdapterTelemetryPersistence, AppError, DoltRepoMapMetaRepository, DoltSymbolRepository, ERR_REPO_MAP_STORAGE_WRITE, EpicIngester, GLOBSTAR$1 as GLOBSTAR, GitClient, GrammarLoader, Minimatch$1 as Minimatch, Minipass, RepoMapInjector, RepoMapModule, RepoMapQueryEngine, RepoMapStorage, SymbolParser, createContextCompiler, createDispatcher, createEventEmitter, createGitWorktreeManager, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStopAfterGate, createTelemetryAdvisor, escape$1 as escape, formatPhaseCompletionSummary, getFactoryRunSummaries, getScenarioResultsForRun, getTwinRunsForRun, listGraphRuns, normalizeGraphSummaryToStatus, registerExportCommand, registerFactoryCommand, registerRunCommand, registerScenariosCommand, resolveMaxReviewCycles, resolveProbeAuthorStateIntegrating, resolveStoryKeys, runAnalysisPhase, runPlanningPhase, runProbeAuthor, runRunAction, runSolutioningPhase, unescape$1 as unescape, validateStopAfterFromConflict, wireNdjsonEmitter };
-//# sourceMappingURL=run-BXRwQRst.js.map
+//# sourceMappingURL=run-BclTZX96.js.map

package/dist/{upgrade-DCDe5u0P.js → upgrade--vRnNB3V.js}

@@ -1,5 +1,5 @@
-import "./dist-l0pA6zZF.js";
+import "./dist-C_NE40jY.js";
 import "./version-manager-impl-qFBiO4Eh.js";
-import { isGlobalInstall, registerUpgradeCommand, runUpgradeCommand } from "./upgrade-BP0P3qr9.js";
+import { isGlobalInstall, registerUpgradeCommand, runUpgradeCommand } from "./upgrade-C1KzAZQE.js";
 
 export { isGlobalInstall, registerUpgradeCommand, runUpgradeCommand };

package/dist/{upgrade-BP0P3qr9.js → upgrade-C1KzAZQE.js}

@@ -1,4 +1,4 @@
-import { createVersionManager } from "./dist-l0pA6zZF.js";
+import { createVersionManager } from "./dist-C_NE40jY.js";
 import { execSync, spawn } from "child_process";
 import * as readline from "readline";
 
@@ -123,4 +123,4 @@ function registerUpgradeCommand(program) {
 
 //#endregion
 export { isGlobalInstall, registerUpgradeCommand, runUpgradeCommand };
-//# sourceMappingURL=upgrade-BP0P3qr9.js.map
+//# sourceMappingURL=upgrade-C1KzAZQE.js.map

package/dist/{version-manager-impl-B8MpvZQz.js → version-manager-impl-9J_JCJPu.js}

@@ -1,4 +1,4 @@
-import { VersionManagerImpl, createVersionManager } from "./dist-l0pA6zZF.js";
+import { VersionManagerImpl, createVersionManager } from "./dist-C_NE40jY.js";
 import "./version-manager-impl-qFBiO4Eh.js";
 
 export { createVersionManager };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "substrate-ai",
-  "version": "0.20.92",
+  "version": "0.20.94",
   "description": "Substrate — multi-agent orchestration daemon for AI coding agents",
   "type": "module",
   "license": "MIT",
@@ -41,7 +41,6 @@
     "dist/**/*.js",
     "dist/**/*.d.ts",
     "dist/**/*.json",
-    "dist/**/*.sql",
     "dist/**/*.dot",
     "dist/cli/templates",
     "packs",
@@ -50,7 +49,7 @@
   "scripts": {
     "agent-memory:bootstrap": "node scripts/bootstrap-agent-memory.mjs",
     "build": "tsc --build packages/core packages/sdlc packages/factory && tsdown",
-    "postbuild": "cp -r src/cli/templates dist/cli/templates && cp src/modules/state/schema.sql dist/schema.sql && mkdir -p dist/graphs && cp packages/sdlc/graphs/sdlc-pipeline.dot dist/graphs/ && printf '#!/usr/bin/env node\\n// Wrapper so probes can invoke as dist/cli.mjs (Story 71-1).\\n// Redirect argv[1] so isMainModule detection in cli/index.js fires correctly.\\nprocess.argv[1] = new URL(\"./cli/index.js\", import.meta.url).pathname;\\nawait import(\"./cli/index.js\");\\n' > dist/cli.mjs",
+    "postbuild": "cp -r src/cli/templates dist/cli/templates && mkdir -p dist/graphs && cp packages/sdlc/graphs/sdlc-pipeline.dot dist/graphs/ && printf '#!/usr/bin/env node\\n// Wrapper so probes can invoke as dist/cli.mjs (Story 71-1).\\n// Redirect argv[1] so isMainModule detection in cli/index.js fires correctly.\\nprocess.argv[1] = new URL(\"./cli/index.js\", import.meta.url).pathname;\\nawait import(\"./cli/index.js\");\\n' > dist/cli.mjs",
     "check:circular": "dpdm --no-warning --exit-code circular:1 packages/core/src/index.ts packages/sdlc/src/index.ts packages/factory/src/index.ts",
     "dev": "tsx watch src/cli/index.ts",
     "test": "vitest run --coverage",

package/dist/adapter-registry-BZ0cVi8C.js

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

package/dist/schema.sql

@@ -1,328 +0,0 @@
--- Substrate State Schema v1
--- Dolt-compatible DDL: composite natural business-key primary keys,
--- DATETIME columns to avoid timezone-dependent merge conflicts.
-
--- ---------------------------------------------------------------------------
--- stories
--- ---------------------------------------------------------------------------
-CREATE TABLE IF NOT EXISTS stories (
-  story_key       VARCHAR(100)   NOT NULL,
-  sprint          VARCHAR(50),
-  status          VARCHAR(30)    NOT NULL DEFAULT 'PENDING',
-  phase           VARCHAR(30)    NOT NULL DEFAULT 'PENDING',
-  ac_results      JSON,
-  error_message   TEXT,
-  created_at      DATETIME,
-  updated_at      DATETIME,
-  completed_at    DATETIME,
-  PRIMARY KEY (story_key)
-);
-
--- ---------------------------------------------------------------------------
--- contracts
--- ---------------------------------------------------------------------------
-CREATE TABLE IF NOT EXISTS contracts (
-  story_key    VARCHAR(100)   NOT NULL,
-  name         VARCHAR(200)   NOT NULL,
-  direction    VARCHAR(20)    NOT NULL,
-  schema_path  VARCHAR(500),
-  transport    VARCHAR(200),
-  recorded_at  DATETIME,
-  PRIMARY KEY (story_key, name, direction)
-);
-
--- ---------------------------------------------------------------------------
--- metrics
--- ---------------------------------------------------------------------------
-CREATE TABLE IF NOT EXISTS metrics (
-  story_key          VARCHAR(100)   NOT NULL,
-  task_type          VARCHAR(100)   NOT NULL,
-  recorded_at        DATETIME       NOT NULL,
-  model              VARCHAR(100),
-  tokens_in          BIGINT         NOT NULL DEFAULT 0,
-  tokens_out         BIGINT         NOT NULL DEFAULT 0,
-  cache_read_tokens  BIGINT         NOT NULL DEFAULT 0,
-  cost_usd           DECIMAL(10,6)  NOT NULL DEFAULT 0,
-  wall_clock_ms      BIGINT         NOT NULL DEFAULT 0,
-  review_cycles      INT            NOT NULL DEFAULT 0,
-  stall_count        INT            NOT NULL DEFAULT 0,
-  result             VARCHAR(30),
-  PRIMARY KEY (story_key, task_type, recorded_at)
-);
-
--- ---------------------------------------------------------------------------
--- dispatch_log
--- ---------------------------------------------------------------------------
-CREATE TABLE IF NOT EXISTS dispatch_log (
-  story_key      VARCHAR(100)   NOT NULL,
-  dispatched_at  DATETIME       NOT NULL,
-  branch         VARCHAR(200),
-  worker_id      VARCHAR(100),
-  result         VARCHAR(30),
-  PRIMARY KEY (story_key, dispatched_at)
-);
-
--- ---------------------------------------------------------------------------
--- build_results
--- ---------------------------------------------------------------------------
-CREATE TABLE IF NOT EXISTS build_results (
-  story_key    VARCHAR(100)   NOT NULL,
-  timestamp    DATETIME       NOT NULL,
-  command      VARCHAR(500),
-  exit_code    INT,
-  stdout_hash  VARCHAR(64),
-  PRIMARY KEY (story_key, timestamp)
-);
-
--- ---------------------------------------------------------------------------
--- review_verdicts
--- ---------------------------------------------------------------------------
-CREATE TABLE IF NOT EXISTS review_verdicts (
-  story_key     VARCHAR(100)   NOT NULL,
-  timestamp     DATETIME       NOT NULL,
-  verdict       VARCHAR(30),
-  issues_count  INT            NOT NULL DEFAULT 0,
-  notes         TEXT,
-  PRIMARY KEY (story_key, timestamp)
-);
-
--- ---------------------------------------------------------------------------
--- _schema_version
--- ---------------------------------------------------------------------------
-CREATE TABLE IF NOT EXISTS _schema_version (
-  version      INT            NOT NULL,
-  applied_at   DATETIME       NOT NULL DEFAULT CURRENT_TIMESTAMP,
-  description  VARCHAR(500),
-  PRIMARY KEY (version)
-);
-
--- Seed schema version (idempotent via INSERT IGNORE)
-INSERT IGNORE INTO _schema_version (version, description) VALUES (1, 'Initial substrate state schema');
-
--- ---------------------------------------------------------------------------
--- turn_analysis (story 27-4)
--- ---------------------------------------------------------------------------
-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 '[]',
-  task_type         VARCHAR(64),
-  phase             VARCHAR(64),
-  dispatch_id       VARCHAR(64),
-  PRIMARY KEY (story_key, span_id)
-);
-
-CREATE INDEX IF NOT EXISTS idx_turn_analysis_story ON turn_analysis (story_key, turn_number);
-
-INSERT IGNORE INTO _schema_version (version, description) VALUES (2, 'Add turn_analysis table (Epic 27-4)');
-
--- ---------------------------------------------------------------------------
--- efficiency_scores
--- ---------------------------------------------------------------------------
-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,
-  token_density_sub_score       DOUBLE       NOT NULL DEFAULT 0,
-  cold_start_turns_excluded     INTEGER      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 '[]',
-  dispatch_id                   TEXT,
-  task_type                     TEXT,
-  phase                         TEXT,
-  PRIMARY KEY (story_key, timestamp)
-);
-
-CREATE INDEX IF NOT EXISTS idx_efficiency_story ON efficiency_scores (story_key, timestamp DESC);
-
--- ---------------------------------------------------------------------------
--- recommendations (story 27-7)
--- ---------------------------------------------------------------------------
-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);
-
--- ---------------------------------------------------------------------------
--- category_stats (story 27-5)
--- ---------------------------------------------------------------------------
-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);
-
--- ---------------------------------------------------------------------------
--- consumer_stats (story 27-5)
--- ---------------------------------------------------------------------------
-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);
-
-INSERT IGNORE INTO _schema_version (version, description) VALUES (3, 'Add category_stats and consumer_stats tables (Epic 27-5)');
-INSERT IGNORE INTO _schema_version (version, description) VALUES (4, 'Add recommendations table (Epic 27-7)');
-
--- ---------------------------------------------------------------------------
--- repo_map_symbols (story 28-2 / Epic 28)
--- ---------------------------------------------------------------------------
-CREATE TABLE IF NOT EXISTS repo_map_symbols (
-  id          BIGINT AUTO_INCREMENT NOT NULL,
-  file_path   VARCHAR(1000)         NOT NULL,
-  symbol_name VARCHAR(500)          NOT NULL,
-  symbol_kind VARCHAR(20)           NOT NULL,
-  signature   TEXT,
-  line_number INT                   NOT NULL DEFAULT 0,
-  exported    TINYINT(1)            NOT NULL DEFAULT 0,
-  file_hash     VARCHAR(64)           NOT NULL,
-  dependencies  JSON,
-  PRIMARY KEY (id)
-);
-
-CREATE INDEX IF NOT EXISTS idx_repo_map_symbols_file ON repo_map_symbols (file_path);
-CREATE INDEX IF NOT EXISTS idx_repo_map_symbols_kind ON repo_map_symbols (symbol_kind);
-
--- ---------------------------------------------------------------------------
--- repo_map_meta (story 28-2 / Epic 28)
--- ---------------------------------------------------------------------------
-CREATE TABLE IF NOT EXISTS repo_map_meta (
-  id          INT      NOT NULL DEFAULT 1,
-  commit_sha  VARCHAR(64),
-  updated_at  DATETIME,
-  file_count  INT      NOT NULL DEFAULT 0,
-  PRIMARY KEY (id)
-);
-
-INSERT IGNORE INTO _schema_version (version, description) VALUES (5, 'Add repo_map_symbols and repo_map_meta tables (Epic 28-2)');
-INSERT IGNORE INTO _schema_version (version, description) VALUES (6, 'Add dependencies JSON column to repo_map_symbols (Epic 28-3)');
-
--- ---------------------------------------------------------------------------
--- wg_stories (Epic 31-1) — planning-level work graph story nodes
--- ---------------------------------------------------------------------------
-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)
-);
-
-CREATE INDEX IF NOT EXISTS idx_wg_stories_epic ON wg_stories (epic);
-
--- ---------------------------------------------------------------------------
--- story_dependencies (Epic 31-1) — directed dependency edges
--- ---------------------------------------------------------------------------
-CREATE TABLE IF NOT EXISTS story_dependencies (
-  story_key       VARCHAR(50)   NOT NULL,
-  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)
-);
-
--- Migration: add created_at to story_dependencies (added in v0.12.0)
-SET @_sd_created_at_exists = (SELECT COUNT(*) FROM INFORMATION_SCHEMA.COLUMNS WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = 'story_dependencies' AND COLUMN_NAME = 'created_at');
-SET @_sql = IF(@_sd_created_at_exists = 0, 'ALTER TABLE story_dependencies ADD COLUMN created_at DATETIME DEFAULT NULL', 'SELECT 1');
-PREPARE _add_col FROM @_sql; EXECUTE _add_col; DEALLOCATE PREPARE _add_col;
-
--- ---------------------------------------------------------------------------
--- ready_stories view (Epic 31-1)
--- ---------------------------------------------------------------------------
-CREATE OR REPLACE VIEW ready_stories AS
-  SELECT s.* FROM wg_stories s
-  WHERE s.status IN ('planned', 'ready')
-    AND NOT EXISTS (
-      SELECT 1 FROM story_dependencies d
-      JOIN wg_stories dep ON dep.story_key = d.depends_on
-      WHERE d.story_key = s.story_key
-        AND d.dependency_type = 'blocks'
-        AND dep.status <> 'complete'
-    );
-
-INSERT IGNORE INTO _schema_version (version, description) VALUES (7, 'Add wg_stories, story_dependencies tables and ready_stories view (Epic 31-1)');
-INSERT IGNORE INTO _schema_version (version, description) VALUES (8, 'Add task_type, phase, dispatch_id columns to turn_analysis (Story 30-1)');
-
--- Migration: add dispatch context columns to turn_analysis for existing repos (Story 30-1)
--- Uses INFORMATION_SCHEMA guard for Dolt/MySQL compatibility (ADD COLUMN IF NOT EXISTS not standard MySQL)
--- For fresh repos the columns are already declared in CREATE TABLE IF NOT EXISTS above, so these
--- INFORMATION_SCHEMA checks will find count > 0 and emit 'SELECT 1' (no-op).
-SET @_task_type_exists = (SELECT COUNT(*) FROM INFORMATION_SCHEMA.COLUMNS WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = 'turn_analysis' AND COLUMN_NAME = 'task_type');
-SET @_sql = IF(@_task_type_exists = 0, 'ALTER TABLE turn_analysis ADD COLUMN task_type VARCHAR(64)', 'SELECT 1');
-PREPARE _add_col FROM @_sql; EXECUTE _add_col; DEALLOCATE PREPARE _add_col;
-
-SET @_phase_exists = (SELECT COUNT(*) FROM INFORMATION_SCHEMA.COLUMNS WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = 'turn_analysis' AND COLUMN_NAME = 'phase');
-SET @_sql = IF(@_phase_exists = 0, 'ALTER TABLE turn_analysis ADD COLUMN phase VARCHAR(64)', 'SELECT 1');
-PREPARE _add_col FROM @_sql; EXECUTE _add_col; DEALLOCATE PREPARE _add_col;
-
-SET @_dispatch_id_exists = (SELECT COUNT(*) FROM INFORMATION_SCHEMA.COLUMNS WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = 'turn_analysis' AND COLUMN_NAME = 'dispatch_id');
-SET @_sql = IF(@_dispatch_id_exists = 0, 'ALTER TABLE turn_analysis ADD COLUMN dispatch_id VARCHAR(64)', 'SELECT 1');
-PREPARE _add_col FROM @_sql; EXECUTE _add_col; DEALLOCATE PREPARE _add_col;
-
-INSERT IGNORE INTO _schema_version (version, description) VALUES (9, 'Add dispatch_id, task_type, phase columns to efficiency_scores (Story 30-3)');
-
--- Migration: add dispatch context columns to efficiency_scores for existing repos (Story 30-3)
-SET @_eff_dispatch_id_exists = (SELECT COUNT(*) FROM INFORMATION_SCHEMA.COLUMNS WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = 'efficiency_scores' AND COLUMN_NAME = 'dispatch_id');
-SET @_sql = IF(@_eff_dispatch_id_exists = 0, 'ALTER TABLE efficiency_scores ADD COLUMN dispatch_id TEXT', 'SELECT 1');
-PREPARE _add_col FROM @_sql; EXECUTE _add_col; DEALLOCATE PREPARE _add_col;
-
-SET @_eff_task_type_exists = (SELECT COUNT(*) FROM INFORMATION_SCHEMA.COLUMNS WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = 'efficiency_scores' AND COLUMN_NAME = 'task_type');
-SET @_sql = IF(@_eff_task_type_exists = 0, 'ALTER TABLE efficiency_scores ADD COLUMN task_type TEXT', 'SELECT 1');
-PREPARE _add_col FROM @_sql; EXECUTE _add_col; DEALLOCATE PREPARE _add_col;
-
-SET @_eff_phase_exists = (SELECT COUNT(*) FROM INFORMATION_SCHEMA.COLUMNS WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = 'efficiency_scores' AND COLUMN_NAME = 'phase');
-SET @_sql = IF(@_eff_phase_exists = 0, 'ALTER TABLE efficiency_scores ADD COLUMN phase TEXT', 'SELECT 1');
-PREPARE _add_col FROM @_sql; EXECUTE _add_col; DEALLOCATE PREPARE _add_col;