substrate-ai 0.4.10 → 0.5.0

package/dist/cli/index.js

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
-import { AppError, DEFAULT_CONFIG, DEFAULT_ROUTING_POLICY, DatabaseWrapper, DoltClient, DoltNotInstalled, DoltRepoMapMetaRepository, DoltSymbolRepository, ERR_REPO_MAP_STORAGE_WRITE, FileStateStore, GitClient, GrammarLoader, IngestionServer, RepoMapInjector, RepoMapModule, RepoMapQueryEngine, RepoMapStorage, SUBSTRATE_OWNED_SETTINGS_KEYS, SymbolParser, TelemetryPersistence, VALID_PHASES, buildPipelineStatusOutput, checkDoltInstalled, createConfigSystem, createContextCompiler, createDispatcher, createDoltClient, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStateStore, createStopAfterGate, findPackageRoot, formatOutput, formatPhaseCompletionSummary, formatPipelineStatusHuman, formatPipelineSummary, formatTokenTelemetry, getAllDescendantPids, getAutoHealthData, getSubstrateDefaultSettings, initializeDolt, parseDbTimestampAsUtc, registerHealthCommand, registerRunCommand, resolveBmadMethodSrcPath, resolveBmadMethodVersion, resolveMainRepoRoot, resolveStoryKeys, runAnalysisPhase, runMigrations, runPlanningPhase, runSolutioningPhase, validateStopAfterFromConflict } from "../run-BErnJT9a.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, buildPipelineStatusOutput, checkDoltInstalled, createConfigSystem, createContextCompiler, createDatabaseAdapter, createDispatcher, createDoltClient, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStateStore, createStopAfterGate, 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-GqmIa5YW.js";
 import { createLogger } from "../logger-D2fS2ccL.js";
-import { AdapterRegistry } from "../adapter-registry-Cd-7lG5v.js";
+import { AdapterRegistry } from "../adapter-registry-BkUvZSKJ.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, getTokenUsageSummary, listRequirements, updatePipelineRun } from "../decisions-Db8GTbH2.js";
-import { ESCALATION_DIAGNOSIS, EXPERIMENT_RESULT, OPERATIONAL_FINDING, STORY_METRICS, aggregateTokenUsageForRun, compareRunMetrics, getBaselineRunMetrics, getRunMetrics, getStoryMetricsForRun, incrementRunRestarts, listRunMetrics, tagRunAsBaseline } from "../operational-C0_y8DAs.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 { 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";
@@ -19,9 +19,8 @@ import yaml from "js-yaml";
 import { createRequire } from "node:module";
 import * as path$1 from "node:path";
 import { isAbsolute, join as join$1 } from "node:path";
-import Database from "better-sqlite3";
-import { access as access$1, readFile as readFile$1 } from "node:fs/promises";
 import { existsSync as existsSync$1, mkdirSync as mkdirSync$1, writeFileSync as writeFileSync$1 } from "node:fs";
+import { access as access$1, readFile as readFile$1 } from "node:fs/promises";
 import { createInterface } from "node:readline";
 import { homedir } from "os";
 import { randomUUID } from "crypto";
@@ -666,10 +665,12 @@ async function runInitAction(options) {
 			else process.stderr.write(`Error: ${errorMsg}\n`);
 			return INIT_EXIT_ERROR;
 		}
-		const dbWrapper = new DatabaseWrapper(dbPath);
-		dbWrapper.open();
-		runMigrations(dbWrapper.db);
-		dbWrapper.close();
+		const dbAdapter = createDatabaseAdapter({
+			backend: "auto",
+			basePath: projectRoot
+		});
+		await initSchema(dbAdapter);
+		await dbAdapter.close();
 		await scaffoldClaudeMd(projectRoot);
 		await scaffoldStatuslineScript(projectRoot);
 		await scaffoldClaudeSettings(projectRoot);
@@ -1017,16 +1018,19 @@ async function runResumeAction(options) {
 	const packPath = join(projectRoot, "packs", packName);
 	const dbRoot = await resolveMainRepoRoot(projectRoot);
 	const dbPath = join(dbRoot, ".substrate", "substrate.db");
-	if (!existsSync(dbPath)) {
+	const doltDir = join(dbRoot, ".substrate", "state", ".dolt");
+	if (!existsSync(dbPath) && !existsSync(doltDir)) {
 		const errorMsg = `Decision store not initialized. Run 'substrate init' first.`;
 		if (outputFormat === "json") process.stdout.write(formatOutput(null, "json", false, errorMsg) + "\n");
 		else process.stderr.write(`Error: ${errorMsg}\n`);
 		return 1;
 	}
-	const dbWrapper = new DatabaseWrapper(dbPath);
+	const adapter = createDatabaseAdapter({
+		backend: "auto",
+		basePath: dbRoot
+	});
 	try {
-		dbWrapper.open();
-		const db = dbWrapper.db;
+		await initSchema(adapter);
 		const packLoader = createPackLoader();
 		let pack;
 		try {
@@ -1039,8 +1043,10 @@ async function runResumeAction(options) {
 			return 1;
 		}
 		let run;
-		if (specifiedRunId !== void 0 && specifiedRunId !== "") run = db.prepare("SELECT * FROM pipeline_runs WHERE id = ?").get(specifiedRunId);
-		else run = getLatestRun(db);
+		if (specifiedRunId !== void 0 && specifiedRunId !== "") {
+			const rows = await adapter.query("SELECT * FROM pipeline_runs WHERE id = ?", [specifiedRunId]);
+			run = rows[0];
+		} else run = await getLatestRun(adapter);
 		if (run === void 0) {
 			const errorMsg = specifiedRunId !== void 0 ? `Pipeline run '${specifiedRunId}' not found.` : "No pipeline runs found. Run `substrate run --from analysis` first.";
 			if (outputFormat === "json") process.stdout.write(formatOutput(null, "json", false, errorMsg) + "\n");
@@ -1050,7 +1056,7 @@ async function runResumeAction(options) {
 		const runId = run.id;
 		if (outputFormat === "human") process.stdout.write(`Resuming pipeline run: ${runId}\n`);
 		const phaseOrchestrator = createPhaseOrchestrator({
-			db,
+			db: adapter,
 			pack
 		});
 		const runStatus = await phaseOrchestrator.resumeRun(runId);
@@ -1092,18 +1098,19 @@ async function runResumeAction(options) {
 		return 1;
 	} finally {
 		try {
-			dbWrapper.close();
+			await adapter.close();
 		} catch {}
 	}
 }
 async function runFullPipelineFromPhase(options) {
 	const { packName, packPath, dbDir, dbPath, startPhase, stopAfter, concept, concurrency, outputFormat, existingRunId, projectRoot, registry: injectedRegistry } = options;
 	if (!existsSync(dbDir)) mkdirSync(dbDir, { recursive: true });
-	const dbWrapper = new DatabaseWrapper(dbPath);
+	const adapter = createDatabaseAdapter({
+		backend: "auto",
+		basePath: projectRoot
+	});
 	try {
-		dbWrapper.open();
-		runMigrations(dbWrapper.db);
-		const db = dbWrapper.db;
+		await initSchema(adapter);
 		const packLoader = createPackLoader();
 		let pack;
 		try {
@@ -1116,20 +1123,20 @@ async function runFullPipelineFromPhase(options) {
 			return 1;
 		}
 		const eventBus = createEventBus();
-		const contextCompiler = createContextCompiler({ db });
+		const contextCompiler = createContextCompiler({ db: adapter });
 		if (!injectedRegistry) throw new Error("AdapterRegistry is required — must be initialized at CLI startup");
 		const dispatcher = createDispatcher({
 			eventBus,
 			adapterRegistry: injectedRegistry
 		});
 		const phaseDeps = {
-			db,
+			db: adapter,
 			pack,
 			contextCompiler,
 			dispatcher
 		};
 		const phaseOrchestrator = createPhaseOrchestrator({
-			db,
+			db: adapter,
 			pack
 		});
 		const startedAt = Date.now();
@@ -1153,7 +1160,7 @@ async function runFullPipelineFromPhase(options) {
 				});
 				if (result.tokenUsage.input > 0 || result.tokenUsage.output > 0) {
 					const costUsd = (result.tokenUsage.input * 3 + result.tokenUsage.output * 15) / 1e6;
-					addTokenUsage(db, runId, {
+					await addTokenUsage(adapter, runId, {
 						phase: "analysis",
 						agent: "claude-code",
 						input_tokens: result.tokenUsage.input,
@@ -1162,7 +1169,7 @@ async function runFullPipelineFromPhase(options) {
 					});
 				}
 				if (result.result === "failed") {
-					updatePipelineRun(db, runId, { status: "failed" });
+					await updatePipelineRun(adapter, runId, { status: "failed" });
 					const errorMsg = `Analysis phase failed: ${result.error ?? "unknown error"}`;
 					if (outputFormat === "human") process.stderr.write(`Error: ${errorMsg}\n`);
 					else process.stdout.write(formatOutput(null, "json", false, errorMsg) + "\n");
@@ -1173,7 +1180,7 @@ async function runFullPipelineFromPhase(options) {
 				const result = await runPlanningPhase(phaseDeps, { runId });
 				if (result.tokenUsage.input > 0 || result.tokenUsage.output > 0) {
 					const costUsd = (result.tokenUsage.input * 3 + result.tokenUsage.output * 15) / 1e6;
-					addTokenUsage(db, runId, {
+					await addTokenUsage(adapter, runId, {
 						phase: "planning",
 						agent: "claude-code",
 						input_tokens: result.tokenUsage.input,
@@ -1182,7 +1189,7 @@ async function runFullPipelineFromPhase(options) {
 					});
 				}
 				if (result.result === "failed") {
-					updatePipelineRun(db, runId, { status: "failed" });
+					await updatePipelineRun(adapter, runId, { status: "failed" });
 					const errorMsg = `Planning phase failed: ${result.error ?? "unknown error"}`;
 					if (outputFormat === "human") process.stderr.write(`Error: ${errorMsg}\n`);
 					else process.stdout.write(formatOutput(null, "json", false, errorMsg) + "\n");
@@ -1193,7 +1200,7 @@ async function runFullPipelineFromPhase(options) {
 				const result = await runSolutioningPhase(phaseDeps, { runId });
 				if (result.tokenUsage.input > 0 || result.tokenUsage.output > 0) {
 					const costUsd = (result.tokenUsage.input * 3 + result.tokenUsage.output * 15) / 1e6;
-					addTokenUsage(db, runId, {
+					await addTokenUsage(adapter, runId, {
 						phase: "solutioning",
 						agent: "claude-code",
 						input_tokens: result.tokenUsage.input,
@@ -1202,7 +1209,7 @@ async function runFullPipelineFromPhase(options) {
 					});
 				}
 				if (result.result === "failed") {
-					updatePipelineRun(db, runId, { status: "failed" });
+					await updatePipelineRun(adapter, runId, { status: "failed" });
 					const errorMsg = `Solutioning phase failed: ${result.error ?? "unknown error"}`;
 					if (outputFormat === "human") process.stderr.write(`Error: ${errorMsg}\n`);
 					else process.stdout.write(formatOutput(null, "json", false, errorMsg) + "\n");
@@ -1222,9 +1229,9 @@ async function runFullPipelineFromPhase(options) {
 					}
 				} catch {}
 				const ingestionServer = telemetryEnabled ? new IngestionServer({ port: telemetryPort }) : void 0;
-				const telemetryPersistence = telemetryEnabled ? new TelemetryPersistence(db) : void 0;
+				const telemetryPersistence = telemetryEnabled ? new AdapterTelemetryPersistence(adapter) : void 0;
 				const orchestrator = createImplementationOrchestrator({
-					db,
+					db: adapter,
 					pack,
 					contextCompiler,
 					dispatcher,
@@ -1244,19 +1251,21 @@ async function runFullPipelineFromPhase(options) {
 						if (result?.tokenUsage !== void 0) {
 							const { input, output } = result.tokenUsage;
 							const costUsd = (input * 3 + output * 15) / 1e6;
-							addTokenUsage(db, runId, {
+							addTokenUsage(adapter, runId, {
 								phase: payload.phase,
 								agent: "claude-code",
 								input_tokens: input,
 								output_tokens: output,
 								cost_usd: costUsd
+							}).catch((err) => {
+								logger$16.warn({ err }, "Failed to record token usage");
 							});
 						}
 					} catch (err) {
 						logger$16.warn({ err }, "Failed to record token usage");
 					}
 				});
-				const storyKeys = resolveStoryKeys(db, projectRoot, { pipelineRunId: runId });
+				const storyKeys = await resolveStoryKeys(adapter, projectRoot, { 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 (outputFormat === "human") process.stdout.write("[IMPLEMENTATION] Complete\n");
@@ -1264,8 +1273,9 @@ async function runFullPipelineFromPhase(options) {
 			if (stopAfter !== void 0 && currentPhase === stopAfter) {
 				const gate = createStopAfterGate(stopAfter);
 				if (gate.shouldHalt()) {
-					const decisionsCount$1 = db.prepare(`SELECT COUNT(*) as cnt FROM decisions WHERE pipeline_run_id = ?`).get(runId)?.cnt ?? 0;
-					updatePipelineRun(db, runId, { status: "stopped" });
+					const countRows = await adapter.query(`SELECT COUNT(*) as cnt FROM decisions WHERE pipeline_run_id = ?`, [runId]);
+					const decisionsCount$1 = countRows[0]?.cnt ?? 0;
+					await updatePipelineRun(adapter, runId, { status: "stopped" });
 					const phaseStartedAt = new Date(startedAt).toISOString();
 					const phaseCompletedAt = new Date().toISOString();
 					const summary = formatPhaseCompletionSummary({
@@ -1291,11 +1301,14 @@ async function runFullPipelineFromPhase(options) {
 				}
 			}
 		}
-		const tokenSummary = getTokenUsageSummary(db, runId);
+		const tokenSummary = await getTokenUsageSummary(adapter, runId);
 		const durationMs = Date.now() - startedAt;
-		const decisionsCount = db.prepare(`SELECT COUNT(*) as cnt FROM decisions WHERE pipeline_run_id = ?`).get(runId)?.cnt ?? 0;
-		const storiesCount = db.prepare(`SELECT COUNT(*) as cnt FROM requirements WHERE pipeline_run_id = ? AND source = 'solutioning-phase'`).get(runId)?.cnt ?? 0;
-		const finalRun = db.prepare("SELECT * FROM pipeline_runs WHERE id = ?").get(runId);
+		const decRows = await adapter.query(`SELECT COUNT(*) as cnt FROM decisions WHERE pipeline_run_id = ?`, [runId]);
+		const decisionsCount = decRows[0]?.cnt ?? 0;
+		const storyRows = await adapter.query(`SELECT COUNT(*) as cnt FROM requirements WHERE pipeline_run_id = ? AND source = 'solutioning-phase'`, [runId]);
+		const storiesCount = storyRows[0]?.cnt ?? 0;
+		const finalRunRows = await adapter.query("SELECT * FROM pipeline_runs WHERE id = ?", [runId]);
+		const finalRun = finalRunRows[0];
 		if (outputFormat === "json") {
 			const statusOutput = buildPipelineStatusOutput(finalRun ?? { id: runId }, tokenSummary, decisionsCount, storiesCount);
 			process.stdout.write(formatOutput(statusOutput, "json", true) + "\n");
@@ -1312,7 +1325,7 @@ async function runFullPipelineFromPhase(options) {
 		return 1;
 	} finally {
 		try {
-			dbWrapper.close();
+			await adapter.close();
 		} catch {}
 	}
 }
@@ -1364,28 +1377,33 @@ async function runStatusAction(options) {
 	}
 	const dbRoot = await resolveMainRepoRoot(projectRoot);
 	const dbPath = join(dbRoot, ".substrate", "substrate.db");
-	if (!existsSync(dbPath)) {
+	const doltDir = join(dbRoot, ".substrate", "state", ".dolt");
+	if (!existsSync(dbPath) && !existsSync(doltDir)) {
 		const errorMsg = `Decision store not initialized. Run 'substrate init' first.`;
 		if (outputFormat === "json") process.stdout.write(formatOutput(null, "json", false, errorMsg) + "\n");
 		else process.stderr.write(`Error: ${errorMsg}\n`);
 		return 1;
 	}
-	const dbWrapper = new DatabaseWrapper(dbPath);
+	const adapter = createDatabaseAdapter({
+		backend: "auto",
+		basePath: dbRoot
+	});
 	try {
-		dbWrapper.open();
-		const db = dbWrapper.db;
+		await initSchema(adapter);
 		let run;
-		if (runId !== void 0 && runId !== "") run = db.prepare("SELECT * FROM pipeline_runs WHERE id = ?").get(runId);
-		else run = getLatestRun(db);
+		if (runId !== void 0 && runId !== "") run = await getPipelineRunById(adapter, runId);
+		else run = await getLatestRun(adapter);
 		if (run === void 0) {
 			const errorMsg = runId !== void 0 ? `Pipeline run '${runId}' not found.` : "No pipeline runs found. Run `substrate run` first.";
 			if (outputFormat === "json") process.stdout.write(formatOutput(null, "json", false, errorMsg) + "\n");
 			else process.stderr.write(`Error: ${errorMsg}\n`);
 			return 1;
 		}
-		const tokenSummary = getTokenUsageSummary(db, run.id);
-		const decisionsCount = db.prepare(`SELECT COUNT(*) as cnt FROM decisions WHERE pipeline_run_id = ?`).get(run.id)?.cnt ?? 0;
-		const storiesCount = db.prepare(`SELECT COUNT(*) as cnt FROM requirements WHERE pipeline_run_id = ? AND source = 'solutioning-phase'`).get(run.id)?.cnt ?? 0;
+		const tokenSummary = await getTokenUsageSummary(adapter, run.id);
+		const decisionsCountRows = await adapter.query(`SELECT COUNT(*) as cnt FROM decisions WHERE pipeline_run_id = ?`, [run.id]);
+		const decisionsCount = decisionsCountRows[0]?.cnt ?? 0;
+		const storiesCountRows = await adapter.query(`SELECT COUNT(*) as cnt FROM requirements WHERE pipeline_run_id = ? AND source = 'solutioning-phase'`, [run.id]);
+		const storiesCount = storiesCountRows[0]?.cnt ?? 0;
 		let storeStories = [];
 		if (stateStore) try {
 			storeStories = await stateStore.queryStories({});
@@ -1394,7 +1412,7 @@ async function runStatusAction(options) {
 		}
 		if (outputFormat === "json") {
 			const statusOutput = buildPipelineStatusOutput(run, tokenSummary, decisionsCount, storiesCount);
-			const storyMetricsRows = getStoryMetricsForRun(db, run.id);
+			const storyMetricsRows = await getStoryMetricsForRun(adapter, run.id);
 			const storyMetricsV2 = storyMetricsRows.map((row) => {
 				const phaseBreakdown = {};
 				try {
@@ -1497,7 +1515,7 @@ async function runStatusAction(options) {
 		return 1;
 	} finally {
 		try {
-			dbWrapper.close();
+			await adapter.close();
 		} catch {}
 	}
 }
@@ -1542,14 +1560,20 @@ function registerStatusCommand(program, _version = "0.0.0", projectRoot = proces
 * Throws if the parent run is not found or not completed.
 * Returns the new run's ID on success.
 */
-function createAmendmentRun(db, input) {
-	const parentRun = db.prepare("SELECT id, status FROM pipeline_runs WHERE id = ?").get(input.parentRunId);
+async function createAmendmentRun(adapter, input) {
+	const rows = await adapter.query("SELECT id, status FROM pipeline_runs WHERE id = ?", [input.parentRunId]);
+	const parentRun = rows[0];
 	if (!parentRun) throw new Error(`Parent run not found: ${input.parentRunId}`);
 	if (parentRun.status !== "completed") throw new Error(`Parent run is not completed (status: ${parentRun.status}). Only completed runs can be amended.`);
-	db.prepare(`
-    INSERT INTO pipeline_runs (id, methodology, current_phase, status, config_json, parent_run_id, created_at, updated_at)
-    VALUES (?, ?, NULL, 'running', ?, ?, datetime('now'), datetime('now'))
-  `).run(input.id, input.methodology, input.configJson ?? null, input.parentRunId);
+	await adapter.query(`INSERT INTO pipeline_runs (id, methodology, current_phase, status, config_json, parent_run_id, created_at, updated_at)
+     VALUES (?, ?, NULL, 'running', ?, ?, ?, ?)`, [
+		input.id,
+		input.methodology,
+		input.configJson ?? null,
+		input.parentRunId,
+		new Date().toISOString(),
+		new Date().toISOString()
+	]);
 	return input.id;
 }
 /**
@@ -1558,13 +1582,10 @@ function createAmendmentRun(db, input) {
 * Returns decisions WHERE superseded_by IS NULL for the specified run,
 * ordered by created_at ASC.
 */
-function loadParentRunDecisions(db, parentRunId) {
-	const stmt = db.prepare(`
-    SELECT * FROM decisions
-    WHERE pipeline_run_id = ? AND superseded_by IS NULL
-    ORDER BY created_at ASC
-  `);
-	return stmt.all(parentRunId);
+async function loadParentRunDecisions(adapter, parentRunId) {
+	return adapter.query(`SELECT * FROM decisions
+     WHERE pipeline_run_id = ? AND superseded_by IS NULL
+     ORDER BY created_at ASC`, [parentRunId]);
 }
 /**
 * Mark a decision as superseded by another decision.
@@ -1576,15 +1597,19 @@ function loadParentRunDecisions(db, parentRunId) {
 *
 * On success, updates the original decision's superseded_by field.
 */
-function supersedeDecision(db, originalDecisionId, supersedingDecisionId) {
-	const original = db.prepare("SELECT id, superseded_by FROM decisions WHERE id = ?").get(originalDecisionId);
+async function supersedeDecision(adapter, originalDecisionId, supersedingDecisionId) {
+	const origRows = await adapter.query("SELECT id, superseded_by FROM decisions WHERE id = ?", [originalDecisionId]);
+	const original = origRows[0];
 	if (!original) throw new Error(`Decision not found: ${originalDecisionId}`);
-	const superseding = db.prepare("SELECT id FROM decisions WHERE id = ?").get(supersedingDecisionId);
+	const superRows = await adapter.query("SELECT id FROM decisions WHERE id = ?", [supersedingDecisionId]);
+	const superseding = superRows[0];
 	if (!superseding) throw new Error(`Superseding decision not found: ${supersedingDecisionId}`);
 	if (original.superseded_by !== null) throw new Error(`Decision ${originalDecisionId} is already superseded`);
-	db.prepare(`
-    UPDATE decisions SET superseded_by = ?, updated_at = datetime('now') WHERE id = ?
-  `).run(supersedingDecisionId, originalDecisionId);
+	await adapter.query("UPDATE decisions SET superseded_by = ?, updated_at = ? WHERE id = ?", [
+		supersedingDecisionId,
+		new Date().toISOString(),
+		originalDecisionId
+	]);
 }
 /**
 * Get all active (non-superseded) decisions, with optional filtering.
@@ -1593,7 +1618,7 @@ function supersedeDecision(db, originalDecisionId, supersedingDecisionId) {
 * If no filter is provided, returns all active decisions across all runs.
 * Results are ordered by created_at ASC.
 */
-function getActiveDecisions(db, filter) {
+async function getActiveDecisions(adapter, filter) {
 	const conditions = ["superseded_by IS NULL"];
 	const values = [];
 	if (filter?.pipeline_run_id !== void 0) {
@@ -1609,25 +1634,22 @@ function getActiveDecisions(db, filter) {
 		values.push(filter.category);
 	}
 	if (filter?.key !== void 0) {
-		conditions.push("key = ?");
+		conditions.push("`key` = ?");
 		values.push(filter.key);
 	}
 	const where = `WHERE ${conditions.join(" AND ")}`;
-	const stmt = db.prepare(`SELECT * FROM decisions ${where} ORDER BY created_at ASC`);
-	return stmt.all(...values);
+	return adapter.query(`SELECT * FROM decisions ${where} ORDER BY created_at ASC`, values);
 }
 /**
 * Get the most recently created pipeline run with status = 'completed'.
 * Returns undefined if no completed run exists.
 */
-function getLatestCompletedRun(db) {
-	const stmt = db.prepare(`
-    SELECT * FROM pipeline_runs
-    WHERE status = 'completed'
-    ORDER BY created_at DESC, rowid DESC
-    LIMIT 1
-  `);
-	return stmt.get();
+async function getLatestCompletedRun(adapter) {
+	const rows = await adapter.query(`SELECT * FROM pipeline_runs
+     WHERE status = 'completed'
+     ORDER BY created_at DESC, id DESC
+     LIMIT 1`);
+	return rows[0];
 }
 
 //#endregion
@@ -1676,13 +1698,13 @@ function buildContextBlock(decisions, phaseName, framingConcept) {
 *
 * Throws if parentRunId is not found (delegates to loadParentRunDecisions()).
 *
-* @param db - better-sqlite3 Database instance
+* @param db - DatabaseAdapter instance
 * @param parentRunId - ID of the completed parent pipeline run
 * @param options - Optional configuration (phaseFilter, framingConcept)
 * @returns AmendmentContextHandler instance
 */
-function createAmendmentContextHandler(db, parentRunId, options) {
-	const allDecisions = loadParentRunDecisions(db, parentRunId);
+async function createAmendmentContextHandler(db, parentRunId, options) {
+	const allDecisions = await loadParentRunDecisions(db, parentRunId);
 	const parentDecisions = options?.phaseFilter && options.phaseFilter.length > 0 ? allDecisions.filter((d) => options.phaseFilter.includes(d.phase)) : allDecisions;
 	const framingConcept = options?.framingConcept;
 	const supersessionLog = [];
@@ -1948,8 +1970,8 @@ const logger$14 = createLogger("amend-cmd");
 * Errors in individual supersession calls are logged as warnings but do not
 * fail the phase (AC7: atomic with phase completion, non-blocking on error).
 */
-function runPostPhaseSupersessionDetection(db, amendmentRunId, currentPhase, handler) {
-	const newDecisions = getActiveDecisions(db, {
+async function runPostPhaseSupersessionDetection(adapter, amendmentRunId, currentPhase, handler) {
+	const newDecisions = await getActiveDecisions(adapter, {
 		pipeline_run_id: amendmentRunId,
 		phase: currentPhase
 	});
@@ -1957,7 +1979,7 @@ function runPostPhaseSupersessionDetection(db, amendmentRunId, currentPhase, han
 	for (const newDec of newDecisions) {
 		const parentMatch = parentDecisions.find((p) => p.phase === newDec.phase && p.category === newDec.category && p.key === newDec.key);
 		if (parentMatch) try {
-			supersedeDecision(db, parentMatch.id, newDec.id);
+			await supersedeDecision(adapter, parentMatch.id, newDec.id);
 			handler.logSupersession({
 				originalDecisionId: parentMatch.id,
 				supersedingDecisionId: newDec.id,
@@ -2010,19 +2032,21 @@ async function runAmendAction(options) {
 	const dbDir = join(dbRoot, ".substrate");
 	const dbPath = join(dbDir, "substrate.db");
 	const packPath = join(projectRoot, "packs", packName);
-	if (!existsSync(dbPath)) {
+	const doltDir = join(dbRoot, ".substrate", "state", ".dolt");
+	if (!existsSync(dbPath) && !existsSync(doltDir)) {
 		process.stderr.write(`Error: Decision store not initialized. Run 'substrate init' first.\n`);
 		return 1;
 	}
-	const dbWrapper = new DatabaseWrapper(dbPath);
+	const adapter = createDatabaseAdapter({
+		backend: "auto",
+		basePath: dbRoot
+	});
 	try {
-		dbWrapper.open();
-		runMigrations(dbWrapper.db);
-		const db = dbWrapper.db;
+		await initSchema(adapter);
 		let parentRunId;
 		if (specifiedRunId !== void 0 && specifiedRunId !== "") parentRunId = specifiedRunId;
 		else {
-			const latestCompleted = getLatestCompletedRun(db);
+			const latestCompleted = await getLatestCompletedRun(adapter);
 			if (latestCompleted === void 0) {
 				process.stderr.write("No completed pipeline run found. Run 'substrate run' first.\n");
 				return 1;
@@ -2037,7 +2061,7 @@ async function runAmendAction(options) {
 			methodology = pack$1.manifest.name;
 		} catch {}
 		try {
-			createAmendmentRun(db, {
+			await createAmendmentRun(adapter, {
 				id: amendmentRunId,
 				parentRunId,
 				methodology,
@@ -2052,7 +2076,7 @@ async function runAmendAction(options) {
 			process.stderr.write(`Error: ${msg}\n`);
 			return 1;
 		}
-		const handler = createAmendmentContextHandler(db, parentRunId, { framingConcept: concept });
+		const handler = await createAmendmentContextHandler(adapter, parentRunId, { framingConcept: concept });
 		const packLoader = createPackLoader();
 		let pack;
 		try {
@@ -2063,14 +2087,14 @@ async function runAmendAction(options) {
 			return 1;
 		}
 		const eventBus = createEventBus();
-		const contextCompiler = createContextCompiler({ db });
+		const contextCompiler = createContextCompiler({ db: adapter });
 		if (!injectedRegistry) throw new Error("AdapterRegistry is required — must be initialized at CLI startup");
 		const dispatcher = createDispatcher({
 			eventBus,
 			adapterRegistry: injectedRegistry
 		});
 		const phaseDeps = {
-			db,
+			db: adapter,
 			pack,
 			contextCompiler,
 			dispatcher
@@ -2085,8 +2109,8 @@ async function runAmendAction(options) {
 		if (startIdx > 0) {
 			const phasesToCopy = phaseOrder.slice(0, startIdx);
 			for (const phase of phasesToCopy) {
-				const parentDecisions$1 = getDecisionsByPhaseForRun(db, parentRunId, phase);
-				for (const d of parentDecisions$1) createDecision(db, {
+				const parentDecisions$1 = await getDecisionsByPhaseForRun(adapter, parentRunId, phase);
+				for (const d of parentDecisions$1) await createDecision(adapter, {
 					pipeline_run_id: amendmentRunId,
 					phase: d.phase,
 					category: d.category,
@@ -2115,7 +2139,7 @@ async function runAmendAction(options) {
 				});
 				if (result.tokenUsage.input > 0 || result.tokenUsage.output > 0) {
 					const costUsd = (result.tokenUsage.input * 3 + result.tokenUsage.output * 15) / 1e6;
-					addTokenUsage(db, amendmentRunId, {
+					await addTokenUsage(adapter, amendmentRunId, {
 						phase: "analysis",
 						agent: "claude-code",
 						input_tokens: result.tokenUsage.input,
@@ -2124,11 +2148,11 @@ async function runAmendAction(options) {
 					});
 				}
 				if (result.result === "failed") {
-					updatePipelineRun(db, amendmentRunId, { status: "failed" });
+					await updatePipelineRun(adapter, amendmentRunId, { status: "failed" });
 					process.stderr.write(`Error: Analysis phase failed: ${result.error ?? "unknown error"}${result.details ? ` — ${result.details}` : ""}\n`);
 					return 1;
 				}
-				runPostPhaseSupersessionDetection(db, amendmentRunId, "analysis", handler);
+				await runPostPhaseSupersessionDetection(adapter, amendmentRunId, "analysis", handler);
 				process.stdout.write(`[AMENDMENT:ANALYSIS] Complete\n`);
 			} else if (currentPhase === "planning") {
 				const result = await runPlanningPhase(phaseDeps, {
@@ -2137,7 +2161,7 @@ async function runAmendAction(options) {
 				});
 				if (result.tokenUsage.input > 0 || result.tokenUsage.output > 0) {
 					const costUsd = (result.tokenUsage.input * 3 + result.tokenUsage.output * 15) / 1e6;
-					addTokenUsage(db, amendmentRunId, {
+					await addTokenUsage(adapter, amendmentRunId, {
 						phase: "planning",
 						agent: "claude-code",
 						input_tokens: result.tokenUsage.input,
@@ -2146,11 +2170,11 @@ async function runAmendAction(options) {
 					});
 				}
 				if (result.result === "failed") {
-					updatePipelineRun(db, amendmentRunId, { status: "failed" });
+					await updatePipelineRun(adapter, amendmentRunId, { status: "failed" });
 					process.stderr.write(`Error: Planning phase failed: ${result.error ?? "unknown error"}${result.details ? ` — ${result.details}` : ""}\n`);
 					return 1;
 				}
-				runPostPhaseSupersessionDetection(db, amendmentRunId, "planning", handler);
+				await runPostPhaseSupersessionDetection(adapter, amendmentRunId, "planning", handler);
 				process.stdout.write(`[AMENDMENT:PLANNING] Complete\n`);
 			} else if (currentPhase === "solutioning") {
 				const result = await runSolutioningPhase(phaseDeps, {
@@ -2159,7 +2183,7 @@ async function runAmendAction(options) {
 				});
 				if (result.tokenUsage.input > 0 || result.tokenUsage.output > 0) {
 					const costUsd = (result.tokenUsage.input * 3 + result.tokenUsage.output * 15) / 1e6;
-					addTokenUsage(db, amendmentRunId, {
+					await addTokenUsage(adapter, amendmentRunId, {
 						phase: "solutioning",
 						agent: "claude-code",
 						input_tokens: result.tokenUsage.input,
@@ -2168,18 +2192,19 @@ async function runAmendAction(options) {
 					});
 				}
 				if (result.result === "failed") {
-					updatePipelineRun(db, amendmentRunId, { status: "failed" });
+					await updatePipelineRun(adapter, amendmentRunId, { status: "failed" });
 					process.stderr.write(`Error: Solutioning phase failed: ${result.error ?? "unknown error"}${result.details ? ` — ${result.details}` : ""}\n`);
 					return 1;
 				}
-				runPostPhaseSupersessionDetection(db, amendmentRunId, "solutioning", handler);
+				await runPostPhaseSupersessionDetection(adapter, amendmentRunId, "solutioning", handler);
 				process.stdout.write(`[AMENDMENT:SOLUTIONING] Complete\n`);
 			} else if (currentPhase === "implementation") process.stdout.write(`[AMENDMENT:IMPLEMENTATION] Context injected (${amendmentContext.length} chars)\n`);
 			if (stopAfter !== void 0 && currentPhase === stopAfter) {
 				const gate = createStopAfterGate(stopAfter);
 				if (gate.shouldHalt()) {
-					const decisionsCount = db.prepare(`SELECT COUNT(*) as cnt FROM decisions WHERE pipeline_run_id = ?`).get(amendmentRunId)?.cnt ?? 0;
-					updatePipelineRun(db, amendmentRunId, { status: "stopped" });
+					const decisionsCountRows = await adapter.query(`SELECT COUNT(*) as cnt FROM decisions WHERE pipeline_run_id = ?`, [amendmentRunId]);
+					const decisionsCount = decisionsCountRows[0]?.cnt ?? 0;
+					await updatePipelineRun(adapter, amendmentRunId, { status: "stopped" });
 					const phaseStartedAt = new Date(startedAt).toISOString();
 					const phaseCompletedAt = new Date().toISOString();
 					const summary = formatPhaseCompletionSummary({
@@ -2196,8 +2221,8 @@ async function runAmendAction(options) {
 				}
 			}
 		}
-		if (!stopped) updatePipelineRun(db, amendmentRunId, { status: "completed" });
-		const amendmentDecisions = getActiveDecisions(db, { pipeline_run_id: amendmentRunId });
+		if (!stopped) await updatePipelineRun(adapter, amendmentRunId, { status: "completed" });
+		const amendmentDecisions = await getActiveDecisions(adapter, { pipeline_run_id: amendmentRunId });
 		const parentDecisions = handler.getParentDecisions();
 		const supersessionLog = handler.getSupersessionLog();
 		const supersededDecisionIds = new Set(supersessionLog.map((s) => s.originalDecisionId));
@@ -2226,7 +2251,7 @@ async function runAmendAction(options) {
 		return 1;
 	} finally {
 		try {
-			dbWrapper.close();
+			await adapter.close();
 		} catch {}
 	}
 }
@@ -2257,20 +2282,23 @@ function defaultSupervisorDeps() {
 		resumePipeline: runResumeAction,
 		sleep: (ms) => new Promise((resolve$2) => setTimeout(resolve$2, ms)),
 		incrementRestarts: (() => {
-			let cachedDbWrapper = null;
+			let cachedAdapter = null;
 			return async (runId, projectRoot) => {
 				try {
-					if (cachedDbWrapper === null) {
+					if (cachedAdapter === null) {
 						const dbRoot = await resolveMainRepoRoot(projectRoot);
-						const dbPath = join(dbRoot, ".substrate", "substrate.db");
-						cachedDbWrapper = new DatabaseWrapper(dbPath);
+						cachedAdapter = createDatabaseAdapter({
+							backend: "auto",
+							basePath: dbRoot
+						});
+						await initSchema(cachedAdapter);
 					}
-					incrementRunRestarts(cachedDbWrapper.db, runId);
+					await incrementRunRestarts(cachedAdapter, runId);
 				} catch {
 					try {
-						cachedDbWrapper?.close();
+						await cachedAdapter?.close();
 					} catch {}
-					cachedDbWrapper = null;
+					cachedAdapter = null;
 				}
 			};
 		})(),
@@ -2278,15 +2306,19 @@ function defaultSupervisorDeps() {
 			try {
 				const dbRoot = await resolveMainRepoRoot(projectRoot);
 				const dbPath = join(dbRoot, ".substrate", "substrate.db");
-				if (!existsSync(dbPath)) return {
+				const doltDir = join(dbRoot, ".substrate", "state", ".dolt");
+				if (!existsSync(dbPath) && !existsSync(doltDir)) return {
 					input: 0,
 					output: 0,
 					cost_usd: 0
 				};
-				const dbWrapper = new DatabaseWrapper(dbPath);
+				const tsAdapter = createDatabaseAdapter({
+					backend: "auto",
+					basePath: dbRoot
+				});
 				try {
-					dbWrapper.open();
-					const agg = aggregateTokenUsageForRun(dbWrapper.db, runId);
+					await initSchema(tsAdapter);
+					const agg = await aggregateTokenUsageForRun(tsAdapter, runId);
 					return {
 						input: agg.input,
 						output: agg.output,
@@ -2294,7 +2326,7 @@ function defaultSupervisorDeps() {
 					};
 				} finally {
 					try {
-						dbWrapper.close();
+						await tsAdapter.close();
 					} catch {}
 				}
 			} catch {
@@ -2312,7 +2344,7 @@ function defaultSupervisorDeps() {
 				if (cached === null) {
 					const { AdapterRegistry: AR } = await import(
 						/* @vite-ignore */
-						"../adapter-registry-X5X81xdJ.js"
+						"../adapter-registry-BRQXdPnB.js"
 );
 					cached = new AR();
 					await cached.discoverAndRegister();
@@ -2324,14 +2356,17 @@ function defaultSupervisorDeps() {
 			try {
 				const dbRoot = await resolveMainRepoRoot(opts.projectRoot);
 				const dbPath = join(dbRoot, ".substrate", "substrate.db");
-				if (!existsSync(dbPath)) return;
-				const dbWrapper = new DatabaseWrapper(dbPath);
+				const doltDir = join(dbRoot, ".substrate", "state", ".dolt");
+				if (!existsSync(dbPath) && !existsSync(doltDir)) return;
+				const sfAdapter = createDatabaseAdapter({
+					backend: "auto",
+					basePath: dbRoot
+				});
 				try {
-					dbWrapper.open();
-					const db = dbWrapper.db;
+					await initSchema(sfAdapter);
 					const activeStories = Object.entries(opts.storyDetails).filter(([, s]) => s.phase !== "PENDING" && s.phase !== "COMPLETE" && s.phase !== "ESCALATED");
 					const now = Date.now();
-					for (const [storyKey, storyState] of activeStories) createDecision(db, {
+					for (const [storyKey, storyState] of activeStories) await createDecision(sfAdapter, {
 						pipeline_run_id: opts.runId ?? null,
 						phase: "supervisor",
 						category: OPERATIONAL_FINDING,
@@ -2346,7 +2381,7 @@ function defaultSupervisorDeps() {
 					});
 				} finally {
 					try {
-						dbWrapper.close();
+						await sfAdapter.close();
 					} catch {}
 				}
 			} catch {}
@@ -2358,13 +2393,16 @@ function defaultSupervisorDeps() {
 			try {
 				const dbRoot = await resolveMainRepoRoot(opts.projectRoot);
 				const dbPath = join(dbRoot, ".substrate", "substrate.db");
-				if (!existsSync(dbPath)) return;
-				const dbWrapper = new DatabaseWrapper(dbPath);
+				const doltDir = join(dbRoot, ".substrate", "state", ".dolt");
+				if (!existsSync(dbPath) && !existsSync(doltDir)) return;
+				const rsAdapter = createDatabaseAdapter({
+					backend: "auto",
+					basePath: dbRoot
+				});
 				try {
-					dbWrapper.open();
-					const db = dbWrapper.db;
-					const tokenAgg = aggregateTokenUsageForRun(db, opts.runId);
-					createDecision(db, {
+					await initSchema(rsAdapter);
+					const tokenAgg = await aggregateTokenUsageForRun(rsAdapter, opts.runId);
+					await createDecision(rsAdapter, {
 						pipeline_run_id: opts.runId,
 						phase: "supervisor",
 						category: OPERATIONAL_FINDING,
@@ -2382,24 +2420,26 @@ function defaultSupervisorDeps() {
 					});
 				} finally {
 					try {
-						dbWrapper.close();
+						await rsAdapter.close();
 					} catch {}
 				}
 			} catch {}
 		},
 		runAnalysis: async (runId, projectRoot) => {
 			const dbPath = join(projectRoot, ".substrate", "substrate.db");
-			if (!existsSync(dbPath)) return;
-			const dbWrapper = new DatabaseWrapper(dbPath);
+			const doltDir = join(projectRoot, ".substrate", "state", ".dolt");
+			if (!existsSync(dbPath) && !existsSync(doltDir)) return;
+			const raAdapter = createDatabaseAdapter({
+				backend: "auto",
+				basePath: projectRoot
+			});
 			try {
-				dbWrapper.open();
-				runMigrations(dbWrapper.db);
-				const db = dbWrapper.db;
-				const run = getRunMetrics(db, runId);
+				await initSchema(raAdapter);
+				const run = await getRunMetrics(raAdapter, runId);
 				if (!run) return;
-				const stories = getStoryMetricsForRun(db, runId);
-				const baseline = getBaselineRunMetrics(db);
-				const baselineStories = baseline && baseline.run_id !== runId ? getStoryMetricsForRun(db, baseline.run_id) : [];
+				const stories = await getStoryMetricsForRun(raAdapter, runId);
+				const baseline = await getBaselineRunMetrics(raAdapter);
+				const baselineStories = baseline && baseline.run_id !== runId ? await getStoryMetricsForRun(raAdapter, baseline.run_id) : [];
 				const analysisPath = "../../modules/supervisor/analysis.js";
 				const { generateAnalysisReport, writeAnalysisReport } = await import(
 					/* @vite-ignore */
@@ -2409,7 +2449,7 @@ function defaultSupervisorDeps() {
 				writeAnalysisReport(report, projectRoot);
 			} catch {} finally {
 				try {
-					dbWrapper.close();
+					await raAdapter.close();
 				} catch {}
 			}
 		}
@@ -2695,21 +2735,21 @@ async function runSupervisorAction(options, deps = {}) {
 						try {
 							const { createExperimenter } = await import(
 								/* @vite-ignore */
-								"../experimenter-CvxtqzXz.js"
+								"../experimenter-CoR0k66d.js"
 );
 							const { getLatestRun: getLatest } = await import(
 								/* @vite-ignore */
-								"../decisions-D7Ao_KcL.js"
+								"../decisions-BxYj_a1X.js"
 );
-							const dbPath = join(projectRoot, ".substrate", "substrate.db");
-							const expDbWrapper = new DatabaseWrapper(dbPath);
+							const expAdapter = createDatabaseAdapter({
+								backend: "auto",
+								basePath: projectRoot
+							});
 							try {
-								expDbWrapper.open();
-								runMigrations(expDbWrapper.db);
-								const expDb = expDbWrapper.db;
+								await initSchema(expAdapter);
 								const { runRunAction: runPipeline } = await import(
 									/* @vite-ignore */
-									"../run-BbdWeKiB.js"
+									"../run-C-yCMYlt.js"
 );
 								const runStoryFn = async (opts) => {
 									const exitCode = await runPipeline({
@@ -2719,7 +2759,7 @@ async function runSupervisorAction(options, deps = {}) {
 										outputFormat: "json",
 										projectRoot: opts.projectRoot
 									});
-									const latestRun = getLatest(expDb);
+									const latestRun = await getLatest(expAdapter);
 									const newRunId = latestRun?.id ?? `experiment-${Date.now()}`;
 									return {
 										runId: newRunId,
@@ -2735,7 +2775,7 @@ async function runSupervisorAction(options, deps = {}) {
 									runStory: runStoryFn,
 									log: (msg) => log(msg)
 								});
-								const results = await experimenter.runExperiments(expDb, recommendations, health.run_id);
+								const results = await experimenter.runExperiments(expAdapter, recommendations, health.run_id);
 								const improved = results.filter((r) => r.verdict === "IMPROVED").length;
 								const mixed = results.filter((r) => r.verdict === "MIXED").length;
 								const regressed = results.filter((r) => r.verdict === "REGRESSED").length;
@@ -2749,7 +2789,7 @@ async function runSupervisorAction(options, deps = {}) {
 								});
 							} finally {
 								try {
-									expDbWrapper.close();
+									await expAdapter.close();
 								} catch {}
 							}
 						} catch (expErr) {
@@ -2957,11 +2997,17 @@ function registerSupervisorCommand(program, _version = "0.0.0", projectRoot = pr
 //#endregion
 //#region src/cli/commands/metrics.ts
 const logger$13 = createLogger("metrics-cmd");
-async function openTelemetryDb(dbPath) {
-	if (!existsSync(dbPath)) return null;
+async function openTelemetryAdapter(basePath) {
 	try {
-		const db = new Database(dbPath, { readonly: true });
-		return db;
+		const adapter = createDatabaseAdapter({
+			backend: "auto",
+			basePath
+		});
+		const persistence = new AdapterTelemetryPersistence(adapter);
+		return {
+			persistence,
+			close: () => adapter.close()
+		};
 	} catch {
 		return null;
 	}
@@ -3048,11 +3094,10 @@ async function runMetricsAction(options) {
 	}
 	if (hasTelemetryMode) {
 		const dbRoot$1 = await resolveMainRepoRoot(projectRoot);
-		const dbPath$1 = join(dbRoot$1, ".substrate", "substrate.db");
 		const doltStatePath = join(dbRoot$1, ".substrate", "state", ".dolt");
 		const doltExists = existsSync(doltStatePath);
-		if (!doltExists && !existsSync(dbPath$1)) {
-			const msg = "No telemetry data yet — run a pipeline with `telemetry.enabled: true`";
+		if (!doltExists) {
+			const msg = "No telemetry data yet — run a pipeline with Dolt initialized and `telemetry.enabled: true`";
 			if (turns !== void 0 || consumers !== void 0) {
 				process.stderr.write(`Error: ${msg}\n`);
 				return 1;
@@ -3061,8 +3106,8 @@ async function runMetricsAction(options) {
 			else process.stdout.write(msg + "\n");
 			return 0;
 		}
-		const sqliteDb = await openTelemetryDb(dbPath$1);
-		if (sqliteDb === null) {
+		const telemetryHandle = await openTelemetryAdapter(dbRoot$1);
+		if (telemetryHandle === null) {
 			const msg = "No telemetry data yet — run a pipeline with `telemetry.enabled: true`";
 			if (turns !== void 0 || consumers !== void 0) {
 				process.stderr.write(`Error: ${msg}\n`);
@@ -3072,8 +3117,8 @@ async function runMetricsAction(options) {
 			else process.stdout.write(msg + "\n");
 			return 0;
 		}
+		const telemetryPersistence = telemetryHandle.persistence;
 		try {
-			const telemetryPersistence = new TelemetryPersistence(sqliteDb);
 			if (efficiency === true) {
 				const scores = await telemetryPersistence.getEfficiencyScores(20);
 				if (outputFormat === "json") process.stdout.write(formatOutput({ efficiency: rowsToEfficiencyScore(scores) }, "json", true) + "\n");
@@ -3163,7 +3208,7 @@ async function runMetricsAction(options) {
 			}
 		} finally {
 			try {
-				sqliteDb.close();
+				await telemetryHandle.close();
 			} catch {}
 		}
 	}
@@ -3249,36 +3294,37 @@ async function runMetricsAction(options) {
 		}
 	}
 	const dbRoot = await resolveMainRepoRoot(projectRoot);
-	const dbPath = join(dbRoot, ".substrate", "substrate.db");
-	if (!existsSync(dbPath)) {
+	const doltStateDir = join(dbRoot, ".substrate", "state", ".dolt");
+	if (!existsSync(doltStateDir)) {
 		if (outputFormat === "json") process.stdout.write(formatOutput({
 			runs: [],
-			message: "No metrics yet — no pipeline database found."
+			message: "No metrics yet — no pipeline database found. Initialize Dolt with `substrate init`."
 		}, "json", true) + "\n");
-		else process.stdout.write("No metrics yet — no pipeline database found.\n");
+		else process.stdout.write("No metrics yet — no pipeline database found. Initialize Dolt with `substrate init`.\n");
 		return 0;
 	}
-	const dbWrapper = new DatabaseWrapper(dbPath);
+	const adapter = createDatabaseAdapter({
+		backend: "auto",
+		basePath: dbRoot
+	});
 	try {
-		dbWrapper.open();
-		runMigrations(dbWrapper.db);
-		const db = dbWrapper.db;
+		await initSchema(adapter);
 		if (tagBaseline !== void 0) {
-			const row = getRunMetrics(db, tagBaseline);
+			const row = await getRunMetrics(adapter, tagBaseline);
 			if (!row) {
 				const msg = `Run '${tagBaseline}' not found in run_metrics.`;
 				if (outputFormat === "json") process.stdout.write(formatOutput(null, "json", false, msg) + "\n");
 				else process.stderr.write(`Error: ${msg}\n`);
 				return 1;
 			}
-			tagRunAsBaseline(db, tagBaseline);
+			await tagRunAsBaseline(adapter, tagBaseline);
 			if (outputFormat === "json") process.stdout.write(formatOutput({ tagged_baseline: tagBaseline }, "json", true) + "\n");
 			else process.stdout.write(`Baseline tagged: ${tagBaseline}\n`);
 			return 0;
 		}
 		if (compare !== void 0) {
 			const [idA, idB] = compare;
-			const delta = compareRunMetrics(db, idA, idB);
+			const delta = await compareRunMetrics(adapter, idA, idB);
 			if (delta === null) {
 				const msg = `One or both run IDs not found in metrics: ${idA}, ${idB}`;
 				if (outputFormat === "json") process.stdout.write(formatOutput(null, "json", false, msg) + "\n");
@@ -3298,7 +3344,7 @@ async function runMetricsAction(options) {
 			}
 			return 0;
 		}
-		const runs = listRunMetrics(db, limit);
+		const runs = await listRunMetrics(adapter, limit);
 		let doltMetrics;
 		const doltStatePath = join(dbRoot, ".substrate", "state", ".dolt");
 		const hasDoltFilters = sprint !== void 0 || story !== void 0 || taskType !== void 0 || since !== void 0 || aggregate === true;
@@ -3319,7 +3365,7 @@ async function runMetricsAction(options) {
 		} catch (doltErr) {
 			logger$13.warn({ err: doltErr }, "StateStore query failed — falling back to SQLite metrics only");
 		}
-		const storyMetricDecisions = getDecisionsByCategory(db, STORY_METRICS);
+		const storyMetricDecisions = await getDecisionsByCategory(adapter, STORY_METRICS);
 		const storyMetrics = storyMetricDecisions.map((d) => {
 			const colonIdx = d.key.indexOf(":");
 			const storyKey = colonIdx !== -1 ? d.key.slice(0, colonIdx) : d.key;
@@ -3464,7 +3510,7 @@ async function runMetricsAction(options) {
 		return 1;
 	} finally {
 		try {
-			dbWrapper.close();
+			await adapter.close();
 		} catch {}
 	}
 }
@@ -3514,30 +3560,20 @@ function registerMetricsCommand(program, _version = "0.0.0", projectRoot = proce
 //#endregion
 //#region src/cli/commands/migrate.ts
 /**
-* Open the SQLite database at `dbPath` (read-only) and return a snapshot of
-* the story_metrics rows.  Returns an empty snapshot if the file does not
-* exist or the table is missing.
+* Reads the SQLite snapshot for migration.
+*
+* NOTE (Epic 29): SQLite support has been removed from Substrate.
+*
+* If you need to migrate historical SQLite data, downgrade to a pre-Epic-29
+* version of Substrate (v0.4.x or earlier), run `substrate migrate`, then
+* upgrade. The Dolt database will retain the migrated data across upgrades.
+*
+* This function now always returns an empty snapshot.
 */
-function readSqliteSnapshot(dbPath) {
-	let db = null;
-	try {
-		db = new Database(dbPath, { readonly: true });
-	} catch {
-		return { storyMetrics: [] };
-	}
-	try {
-		const rows = db.prepare(`SELECT story_key, result, completed_at, created_at,
-                wall_clock_seconds, input_tokens, output_tokens,
-                cost_usd, review_cycles
-         FROM story_metrics`).all();
-		return { storyMetrics: rows };
-	} catch (err) {
-		const msg = err instanceof Error ? err.message : String(err);
-		process.stderr.write(`Warning: could not read story_metrics from SQLite: ${msg}\n`);
-		return { storyMetrics: [] };
-	} finally {
-		db.close();
-	}
+async function readSqliteSnapshot(dbPath) {
+	const { existsSync: fileExists } = await import("node:fs");
+	if (fileExists(dbPath)) process.stderr.write(`Warning: Legacy SQLite database found at ${dbPath} but SQLite support has been\nremoved in Epic 29. To migrate historical data, downgrade to Substrate v0.4.x,\nrun 'substrate migrate', then upgrade back to this version.\n`);
+	return { storyMetrics: [] };
 }
 const BATCH_SIZE = 100;
 /**
@@ -3611,7 +3647,7 @@ function registerMigrateCommand(program) {
 			return;
 		}
 		const dbPath = join$1(projectRoot, ".substrate", "substrate.db");
-		const snapshot = readSqliteSnapshot(dbPath);
+		const snapshot = await readSqliteSnapshot(dbPath);
 		if (snapshot.storyMetrics.length === 0) {
 			if (options.outputFormat === "json") console.log(JSON.stringify({
 				migrated: false,
@@ -3665,25 +3701,14 @@ function registerMigrateCommand(program) {
 
 //#endregion
 //#region src/persistence/queries/cost.ts
-const stmtCache = new WeakMap();
-function getCache(db) {
-	let cache = stmtCache.get(db);
-	if (!cache) {
-		cache = {};
-		stmtCache.set(db, cache);
-	}
-	return cache;
-}
 /**
 * Return aggregated cost totals for a session (AC2).
 *
 * Returns a SessionCostSummary with subscription/API breakdown and savings.
 * Uses idx_cost_entries_session_task index.
 */
-function getSessionCostSummary(db, sessionId) {
-	const cache = getCache(db);
-	if (!cache.getSessionCostSummaryTotals) cache.getSessionCostSummaryTotals = db.prepare(`
-    SELECT
+async function getSessionCostSummary(adapter, sessionId) {
+	const totalsRows = await adapter.query(`SELECT
       COALESCE(SUM(estimated_cost), 0) AS total_cost_usd,
       COALESCE(SUM(CASE WHEN billing_mode = 'subscription' THEN COALESCE(estimated_cost, 0) ELSE 0 END), 0) AS subscription_cost_usd,
       COALESCE(SUM(CASE WHEN billing_mode = 'api' THEN COALESCE(estimated_cost, 0) ELSE 0 END), 0)          AS api_cost_usd,
@@ -3693,11 +3718,9 @@ function getSessionCostSummary(db, sessionId) {
       SUM(CASE WHEN billing_mode = 'api' THEN 1 ELSE 0 END)          AS api_task_count,
       MIN(timestamp)                   AS earliest_recorded_at
     FROM cost_entries
-    WHERE session_id = @sessionId
-  `);
-	const totalsRow = cache.getSessionCostSummaryTotals.get({ sessionId });
-	if (!cache.getSessionCostSummaryAgents) cache.getSessionCostSummaryAgents = db.prepare(`
-    SELECT
+    WHERE session_id = ?`, [sessionId]);
+	const totalsRow = totalsRows[0];
+	const agentRows = await adapter.query(`SELECT
       agent,
       COUNT(*) AS task_count,
       COALESCE(SUM(estimated_cost), 0) AS cost_usd,
@@ -3705,11 +3728,9 @@ function getSessionCostSummary(db, sessionId) {
       SUM(CASE WHEN billing_mode = 'subscription' THEN 1 ELSE 0 END) AS subscription_tasks,
       SUM(CASE WHEN billing_mode = 'api' THEN 1 ELSE 0 END)          AS api_tasks
     FROM cost_entries
-    WHERE session_id = @sessionId
+    WHERE session_id = ?
     GROUP BY agent
-    ORDER BY cost_usd DESC
-  `);
-	const agentRows = cache.getSessionCostSummaryAgents.all({ sessionId });
+    ORDER BY cost_usd DESC`, [sessionId]);
 	const perAgentBreakdown = agentRows.map((row) => ({
 		agent: row.agent,
 		task_count: row.task_count,
@@ -3746,69 +3767,31 @@ function getSessionCostSummary(db, sessionId) {
 *
 * Uses idx_cost_entries_session_task index.
 */
-function getSessionCostSummaryFiltered(db, sessionId, includePlanning) {
-	const cache = getCache(db);
-	let totalsRow;
-	let agentRows;
-	if (!includePlanning) {
-		if (!cache.getSessionCostSummaryFilteredTotals) cache.getSessionCostSummaryFilteredTotals = db.prepare(`
-        SELECT
-          COALESCE(SUM(estimated_cost), 0) AS total_cost_usd,
-          COALESCE(SUM(CASE WHEN billing_mode = 'subscription' THEN COALESCE(estimated_cost, 0) ELSE 0 END), 0) AS subscription_cost_usd,
-          COALESCE(SUM(CASE WHEN billing_mode = 'api' THEN COALESCE(estimated_cost, 0) ELSE 0 END), 0)          AS api_cost_usd,
-          COALESCE(SUM(savings_usd), 0)   AS savings_usd,
-          COUNT(*)                         AS task_count,
-          SUM(CASE WHEN billing_mode = 'subscription' THEN 1 ELSE 0 END) AS subscription_task_count,
-          SUM(CASE WHEN billing_mode = 'api' THEN 1 ELSE 0 END)          AS api_task_count,
-          MIN(timestamp)                   AS earliest_recorded_at
-        FROM cost_entries
-        WHERE session_id = @sessionId AND category != 'planning'
-      `);
-		if (!cache.getSessionCostSummaryFilteredAgents) cache.getSessionCostSummaryFilteredAgents = db.prepare(`
-        SELECT
-          agent,
-          COUNT(*) AS task_count,
-          COALESCE(SUM(estimated_cost), 0) AS cost_usd,
-          COALESCE(SUM(savings_usd), 0)    AS savings_usd,
-          SUM(CASE WHEN billing_mode = 'subscription' THEN 1 ELSE 0 END) AS subscription_tasks,
-          SUM(CASE WHEN billing_mode = 'api' THEN 1 ELSE 0 END)          AS api_tasks
-        FROM cost_entries
-        WHERE session_id = @sessionId AND category != 'planning'
-        GROUP BY agent
-        ORDER BY cost_usd DESC
-      `);
-		totalsRow = cache.getSessionCostSummaryFilteredTotals.get({ sessionId });
-		agentRows = cache.getSessionCostSummaryFilteredAgents.all({ sessionId });
-	} else {
-		if (!cache.getSessionCostSummaryUnfilteredTotals) cache.getSessionCostSummaryUnfilteredTotals = db.prepare(`
-        SELECT
-          COALESCE(SUM(estimated_cost), 0) AS total_cost_usd,
-          COALESCE(SUM(CASE WHEN billing_mode = 'subscription' THEN COALESCE(estimated_cost, 0) ELSE 0 END), 0) AS subscription_cost_usd,
-          COALESCE(SUM(CASE WHEN billing_mode = 'api' THEN COALESCE(estimated_cost, 0) ELSE 0 END), 0)          AS api_cost_usd,
-          COALESCE(SUM(savings_usd), 0)   AS savings_usd,
-          COUNT(*)                         AS task_count,
-          SUM(CASE WHEN billing_mode = 'subscription' THEN 1 ELSE 0 END) AS subscription_task_count,
-          SUM(CASE WHEN billing_mode = 'api' THEN 1 ELSE 0 END)          AS api_task_count,
-          MIN(timestamp)                   AS earliest_recorded_at
-        FROM cost_entries
-        WHERE session_id = @sessionId
-      `);
-		if (!cache.getSessionCostSummaryUnfilteredAgents) cache.getSessionCostSummaryUnfilteredAgents = db.prepare(`
-        SELECT
-          agent,
-          COUNT(*) AS task_count,
-          COALESCE(SUM(estimated_cost), 0) AS cost_usd,
-          COALESCE(SUM(savings_usd), 0)    AS savings_usd,
-          SUM(CASE WHEN billing_mode = 'subscription' THEN 1 ELSE 0 END) AS subscription_tasks,
-          SUM(CASE WHEN billing_mode = 'api' THEN 1 ELSE 0 END)          AS api_tasks
-        FROM cost_entries
-        WHERE session_id = @sessionId
-        GROUP BY agent
-        ORDER BY cost_usd DESC
-      `);
-		totalsRow = cache.getSessionCostSummaryUnfilteredTotals.get({ sessionId });
-		agentRows = cache.getSessionCostSummaryUnfilteredAgents.all({ sessionId });
-	}
+async function getSessionCostSummaryFiltered(adapter, sessionId, includePlanning) {
+	const categoryFilter = includePlanning ? "" : "AND category != 'planning'";
+	const totalsRows = await adapter.query(`SELECT
+      COALESCE(SUM(estimated_cost), 0) AS total_cost_usd,
+      COALESCE(SUM(CASE WHEN billing_mode = 'subscription' THEN COALESCE(estimated_cost, 0) ELSE 0 END), 0) AS subscription_cost_usd,
+      COALESCE(SUM(CASE WHEN billing_mode = 'api' THEN COALESCE(estimated_cost, 0) ELSE 0 END), 0)          AS api_cost_usd,
+      COALESCE(SUM(savings_usd), 0)   AS savings_usd,
+      COUNT(*)                         AS task_count,
+      SUM(CASE WHEN billing_mode = 'subscription' THEN 1 ELSE 0 END) AS subscription_task_count,
+      SUM(CASE WHEN billing_mode = 'api' THEN 1 ELSE 0 END)          AS api_task_count,
+      MIN(timestamp)                   AS earliest_recorded_at
+    FROM cost_entries
+    WHERE session_id = ? ${categoryFilter}`, [sessionId]);
+	const totalsRow = totalsRows[0];
+	const agentRows = await adapter.query(`SELECT
+      agent,
+      COUNT(*) AS task_count,
+      COALESCE(SUM(estimated_cost), 0) AS cost_usd,
+      COALESCE(SUM(savings_usd), 0)    AS savings_usd,
+      SUM(CASE WHEN billing_mode = 'subscription' THEN 1 ELSE 0 END) AS subscription_tasks,
+      SUM(CASE WHEN billing_mode = 'api' THEN 1 ELSE 0 END)          AS api_tasks
+    FROM cost_entries
+    WHERE session_id = ? ${categoryFilter}
+    GROUP BY agent
+    ORDER BY cost_usd DESC`, [sessionId]);
 	const perAgentBreakdown = agentRows.map((row) => ({
 		agent: row.agent,
 		task_count: row.task_count,
@@ -3843,13 +3826,11 @@ function getSessionCostSummaryFiltered(db, sessionId, includePlanning) {
 *
 * Uses idx_cost_entries_session_task index.
 */
-function getAllCostEntriesFiltered(db, sessionId, includePlanning) {
+async function getAllCostEntriesFiltered(adapter, sessionId, includePlanning) {
 	const categoryFilter = includePlanning ? "" : "AND category != 'planning'";
-	const rows = db.prepare(`
-    SELECT * FROM cost_entries
-    WHERE session_id = @sessionId ${categoryFilter}
-    ORDER BY timestamp DESC
-  `).all({ sessionId });
+	const rows = await adapter.query(`SELECT * FROM cost_entries
+    WHERE session_id = ? ${categoryFilter}
+    ORDER BY timestamp DESC`, [sessionId]);
 	return rows.map((row) => ({
 		id: row.id,
 		session_id: row.session_id,
@@ -3873,20 +3854,16 @@ function getAllCostEntriesFiltered(db, sessionId, includePlanning) {
 *
 * Uses idx_cost_category index.
 */
-function getPlanningCostTotal(db, sessionId) {
-	const cache = getCache(db);
-	if (!cache.getPlanningCostTotal) cache.getPlanningCostTotal = db.prepare(`
-      SELECT COALESCE(SUM(estimated_cost), 0) AS planning_cost
-      FROM cost_entries
-      WHERE session_id = @sessionId AND category = 'planning'
-    `);
-	const row = cache.getPlanningCostTotal.get({ sessionId });
-	return row.planning_cost;
+async function getPlanningCostTotal(adapter, sessionId) {
+	const rows = await adapter.query(`SELECT COALESCE(SUM(estimated_cost), 0) AS planning_cost
+    FROM cost_entries
+    WHERE session_id = ? AND category = 'planning'`, [sessionId]);
+	return rows[0]?.planning_cost ?? 0;
 }
 
 //#endregion
 //#region src/cli/commands/cost.ts
-function getLatestSessionId(_db) {
+function getLatestSessionId(_adapter) {
 	return null;
 }
 const logger$12 = createLogger("cost-cmd");
@@ -4061,7 +4038,8 @@ function formatCostCsv(summary, taskEntries) {
 async function runCostAction(options) {
 	const { sessionId: explicitSessionId, outputFormat, byTask, byAgent, byBilling, includePlanning, projectRoot, version = "0.0.0" } = options;
 	const dbPath = join(projectRoot, ".substrate", "substrate.db");
-	if (!existsSync(dbPath)) {
+	const doltDir = join(projectRoot, ".substrate", "state", ".dolt");
+	if (!existsSync(dbPath) && !existsSync(doltDir)) {
 		process.stderr.write(`Error: No Substrate database found at ${dbPath}. Run 'substrate init' first.\n`);
 		return COST_EXIT_ERROR;
 	}
@@ -4074,18 +4052,15 @@ async function runCostAction(options) {
 		process.stderr.write(`Error: Invalid output format '${outputFormat}'. Valid formats: ${validFormats.join(", ")}\n`);
 		return COST_EXIT_ERROR;
 	}
-	let wrapper = null;
+	let adapter = null;
 	try {
-		wrapper = new DatabaseWrapper(dbPath);
-		wrapper.open();
-		const db = wrapper.db;
-		if (!db) {
-			process.stderr.write("Database connection failed\n");
-			return COST_EXIT_ERROR;
-		}
-		runMigrations(db);
+		adapter = createDatabaseAdapter({
+			backend: "auto",
+			basePath: projectRoot
+		});
+		await initSchema(adapter);
 		let sessionId = explicitSessionId ?? null;
-		if (!sessionId) sessionId = getLatestSessionId(db);
+		if (!sessionId) sessionId = getLatestSessionId(adapter);
 		if (!sessionId) {
 			if (outputFormat === "json") {
 				const output = buildJsonOutput("substrate cost", {
@@ -4096,8 +4071,8 @@ async function runCostAction(options) {
 			} else process.stdout.write("No cost data found\n");
 			return COST_EXIT_SUCCESS;
 		}
-		const summary = includePlanning ? getSessionCostSummary(db, sessionId) : getSessionCostSummaryFiltered(db, sessionId, false);
-		const planningCostUsd = includePlanning ? 0 : getPlanningCostTotal(db, sessionId);
+		const summary = includePlanning ? await getSessionCostSummary(adapter, sessionId) : await getSessionCostSummaryFiltered(adapter, sessionId, false);
+		const planningCostUsd = includePlanning ? 0 : await getPlanningCostTotal(adapter, sessionId);
 		if (summary.task_count === 0) {
 			if (outputFormat === "json") {
 				const output = buildJsonOutput("substrate cost", {
@@ -4108,25 +4083,25 @@ async function runCostAction(options) {
 			} else process.stdout.write("No cost data found\n");
 			return COST_EXIT_SUCCESS;
 		}
-		const getFilteredEntries = () => getAllCostEntriesFiltered(db, sessionId, includePlanning);
+		const getFilteredEntries = () => getAllCostEntriesFiltered(adapter, sessionId, includePlanning);
 		if (outputFormat === "json") {
 			const jsonData = {
 				session_id: sessionId,
 				summary
 			};
-			if (byTask) jsonData.tasks = getFilteredEntries();
+			if (byTask) jsonData.tasks = await getFilteredEntries();
 			if (byAgent) jsonData.agents = summary.per_agent_breakdown;
 			const output = buildJsonOutput("substrate cost", jsonData, version);
 			process.stdout.write(JSON.stringify(output, null, 2) + "\n");
 			return COST_EXIT_SUCCESS;
 		}
 		if (outputFormat === "csv") {
-			const csvOutput = formatCostCsv(summary, byTask ? getFilteredEntries() : void 0);
+			const csvOutput = formatCostCsv(summary, byTask ? await getFilteredEntries() : void 0);
 			process.stdout.write(csvOutput + "\n");
 			return COST_EXIT_SUCCESS;
 		}
 		if (byTask) {
-			const entries = getFilteredEntries();
+			const entries = await getFilteredEntries();
 			process.stdout.write(formatByTaskTable(entries) + "\n");
 		} else if (byAgent) process.stdout.write(formatByAgentTable(summary.per_agent_breakdown) + "\n");
 		else if (byBilling) process.stdout.write(formatByBillingTable(summary) + "\n");
@@ -4138,8 +4113,8 @@ async function runCostAction(options) {
 		logger$12.error({ err }, "runCostAction failed");
 		return COST_EXIT_ERROR;
 	} finally {
-		if (wrapper !== null) try {
-			wrapper.close();
+		if (adapter !== null) try {
+			await adapter.close();
 		} catch {}
 	}
 }
@@ -4167,190 +4142,211 @@ function registerCostCommand(program, version = "0.0.0", projectRoot = process.c
 	});
 }
 
-//#endregion
-//#region src/persistence/migrations/001-monitor-schema.ts
-/**
-* Apply the monitor schema to the given database connection.
-* Idempotent — uses CREATE TABLE IF NOT EXISTS and CREATE INDEX IF NOT EXISTS.
-*/
-function applyMonitorSchema(db) {
-	db.exec(`
-    -- Migration versioning
-    CREATE TABLE IF NOT EXISTS _schema_version (
-      version_id  INTEGER PRIMARY KEY,
-      applied_at  TEXT NOT NULL DEFAULT (datetime('now'))
-    );
-    INSERT OR IGNORE INTO _schema_version (version_id) VALUES (1);
-
-    -- Task-level execution metrics (AC1)
-    CREATE TABLE IF NOT EXISTS task_metrics (
-      task_id        TEXT    NOT NULL,
-      agent          TEXT    NOT NULL,
-      task_type      TEXT    NOT NULL,
-      outcome        TEXT    NOT NULL CHECK(outcome IN ('success', 'failure')),
-      failure_reason TEXT,
-      input_tokens   INTEGER NOT NULL DEFAULT 0,
-      output_tokens  INTEGER NOT NULL DEFAULT 0,
-      duration_ms    INTEGER NOT NULL DEFAULT 0,
-      cost           REAL    NOT NULL DEFAULT 0.0,
-      estimated_cost REAL    NOT NULL DEFAULT 0.0,
-      billing_mode   TEXT    NOT NULL DEFAULT 'api',
-      retries        INTEGER NOT NULL DEFAULT 0,
-      recorded_at    TEXT    NOT NULL DEFAULT (datetime('now')),
-      PRIMARY KEY (task_id, recorded_at)
-    );
-    CREATE INDEX IF NOT EXISTS idx_tm_agent        ON task_metrics(agent);
-    CREATE INDEX IF NOT EXISTS idx_tm_task_type    ON task_metrics(task_type);
-    CREATE INDEX IF NOT EXISTS idx_tm_recorded_at  ON task_metrics(recorded_at);
-    CREATE INDEX IF NOT EXISTS idx_tm_agent_type   ON task_metrics(agent, task_type);
-
-    -- Aggregate performance stats per (agent, task_type) (for story 8.5)
-    CREATE TABLE IF NOT EXISTS performance_aggregates (
-      agent              TEXT    NOT NULL,
-      task_type          TEXT    NOT NULL,
-      total_tasks        INTEGER NOT NULL DEFAULT 0,
-      successful_tasks   INTEGER NOT NULL DEFAULT 0,
-      failed_tasks       INTEGER NOT NULL DEFAULT 0,
-      total_input_tokens INTEGER NOT NULL DEFAULT 0,
-      total_output_tokens INTEGER NOT NULL DEFAULT 0,
-      total_duration_ms  INTEGER NOT NULL DEFAULT 0,
-      total_cost         REAL    NOT NULL DEFAULT 0.0,
-      total_retries      INTEGER NOT NULL DEFAULT 0,
-      last_updated       TEXT    NOT NULL DEFAULT (datetime('now')),
-      PRIMARY KEY (agent, task_type)
-    );
-
-    -- Routing recommendations (for story 8.6)
-    CREATE TABLE IF NOT EXISTS routing_recommendations (
-      id                INTEGER PRIMARY KEY AUTOINCREMENT,
-      task_type         TEXT    NOT NULL,
-      current_agent     TEXT    NOT NULL,
-      recommended_agent TEXT    NOT NULL,
-      reason            TEXT,
-      confidence        REAL    NOT NULL DEFAULT 0.0,
-      supporting_data   TEXT,
-      generated_at      TEXT    NOT NULL DEFAULT (datetime('now')),
-      expires_at        TEXT
-    );
-  `);
-}
-
 //#endregion
 //#region src/persistence/monitor-database.ts
 const logger$11 = createLogger("persistence:monitor-db");
+/**
+* DatabaseAdapter-backed MonitorDatabase implementation.
+*
+* All database operations are executed synchronously by calling the adapter's
+* sync-compatible query path. The adapter is accepted via constructor injection,
+* so any SyncAdapter-compatible backend (WASM SQLite, Dolt via sync wrapper) works.
+*
+* Schema is applied on construction via _applySchema().
+*/
 var MonitorDatabaseImpl = class {
-	_db = null;
+	_adapter;
+	_syncAdapter;
 	_path;
-	_stmtInsertMetrics;
-	_stmtUpsertAggregates;
-	constructor(databasePath) {
-		this._path = databasePath;
-		this._open();
-	}
-	_open() {
-		logger$11.info({ path: this._path }, "Opening monitor database");
-		this._db = new Database(this._path);
-		const walResult = this._db.pragma("journal_mode = WAL");
-		if (walResult?.[0]?.journal_mode !== "wal") logger$11.warn({ result: walResult?.[0]?.journal_mode }, "Monitor DB: WAL pragma did not confirm wal mode");
-		this._db.pragma("synchronous = NORMAL");
-		this._db.pragma("busy_timeout = 5000");
-		this._db.pragma("foreign_keys = ON");
-		applyMonitorSchema(this._db);
-		this._stmtInsertMetrics = this._db.prepare(`
-      INSERT OR IGNORE INTO task_metrics (
-        task_id, agent, task_type, outcome, failure_reason,
-        input_tokens, output_tokens, duration_ms, cost, estimated_cost,
-        billing_mode, recorded_at
-      ) VALUES (
-        @taskId, @agent, @taskType, @outcome, @failureReason,
-        @inputTokens, @outputTokens, @durationMs, @cost, @estimatedCost,
-        @billingMode, @recordedAt
+	constructor(databasePathOrAdapter) {
+		if (typeof databasePathOrAdapter === "string") throw new Error("MonitorDatabaseImpl: string path constructor is no longer supported (Epic 29 SQLite removal). Use createWasmSqliteAdapter() and pass the adapter directly: new MonitorDatabaseImpl(await createWasmSqliteAdapter())");
+		else {
+			this._path = "<adapter>";
+			this._adapter = databasePathOrAdapter;
+		}
+		this._syncAdapter = isSyncAdapter(this._adapter) ? this._adapter : null;
+		if (this._syncAdapter === null) throw new Error("MonitorDatabaseImpl: adapter must implement SyncAdapter (querySync/execSync). Use createWasmSqliteAdapter() from src/persistence/wasm-sqlite-adapter.ts.");
+		this._applySchemaSync();
+		logger$11.info({ path: this._path }, "Monitor database ready");
+	}
+	_applySchemaSync() {
+		if (this._syncAdapter === null) return;
+		this._syncAdapter.execSync(`
+      CREATE TABLE IF NOT EXISTS _schema_version (
+        version_id  INTEGER PRIMARY KEY,
+        applied_at  DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP
       )
     `);
-		this._stmtUpsertAggregates = this._db.prepare(`
-      INSERT INTO performance_aggregates (
-        agent, task_type, total_tasks, successful_tasks, failed_tasks,
-        total_input_tokens, total_output_tokens, total_duration_ms, total_cost, total_retries, last_updated
-      ) VALUES (
-        @agent, @taskType, @totalTasks, @successfulTasks, @failedTasks,
-        @inputTokens, @outputTokens, @durationMs, @cost, @retries, @lastUpdated
+		const existing = this._syncAdapter.querySync("SELECT version_id FROM _schema_version WHERE version_id = 1");
+		if (existing.length === 0) this._syncAdapter.querySync("INSERT INTO _schema_version (version_id) VALUES (1)");
+		this._syncAdapter.execSync(`
+      CREATE TABLE IF NOT EXISTS task_metrics (
+        task_id        VARCHAR(255) NOT NULL,
+        agent          VARCHAR(128) NOT NULL,
+        task_type      VARCHAR(128) NOT NULL,
+        outcome        VARCHAR(16)  NOT NULL CHECK(outcome IN ('success', 'failure')),
+        failure_reason TEXT,
+        input_tokens   INTEGER NOT NULL DEFAULT 0,
+        output_tokens  INTEGER NOT NULL DEFAULT 0,
+        duration_ms    INTEGER NOT NULL DEFAULT 0,
+        cost           DOUBLE  NOT NULL DEFAULT 0.0,
+        estimated_cost DOUBLE  NOT NULL DEFAULT 0.0,
+        billing_mode   VARCHAR(32) NOT NULL DEFAULT 'api',
+        retries        INTEGER NOT NULL DEFAULT 0,
+        recorded_at    DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+        PRIMARY KEY (task_id, recorded_at)
+      )
+    `);
+		this._syncAdapter.execSync(`CREATE INDEX IF NOT EXISTS idx_tm_agent       ON task_metrics(agent)`);
+		this._syncAdapter.execSync(`CREATE INDEX IF NOT EXISTS idx_tm_task_type   ON task_metrics(task_type)`);
+		this._syncAdapter.execSync(`CREATE INDEX IF NOT EXISTS idx_tm_recorded_at ON task_metrics(recorded_at)`);
+		this._syncAdapter.execSync(`CREATE INDEX IF NOT EXISTS idx_tm_agent_type  ON task_metrics(agent, task_type)`);
+		this._syncAdapter.execSync(`
+      CREATE TABLE IF NOT EXISTS performance_aggregates (
+        agent              VARCHAR(255) NOT NULL,
+        task_type          VARCHAR(255) NOT NULL,
+        total_tasks        INTEGER NOT NULL DEFAULT 0,
+        successful_tasks   INTEGER NOT NULL DEFAULT 0,
+        failed_tasks       INTEGER NOT NULL DEFAULT 0,
+        total_input_tokens INTEGER NOT NULL DEFAULT 0,
+        total_output_tokens INTEGER NOT NULL DEFAULT 0,
+        total_duration_ms  INTEGER NOT NULL DEFAULT 0,
+        total_cost         DOUBLE  NOT NULL DEFAULT 0.0,
+        total_retries      INTEGER NOT NULL DEFAULT 0,
+        last_updated       DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+        PRIMARY KEY (agent, task_type)
+      )
+    `);
+		this._syncAdapter.execSync(`
+      CREATE TABLE IF NOT EXISTS routing_recommendations (
+        id                INTEGER PRIMARY KEY AUTO_INCREMENT,
+        task_type         VARCHAR(128) NOT NULL,
+        current_agent     VARCHAR(128) NOT NULL,
+        recommended_agent VARCHAR(128) NOT NULL,
+        reason            TEXT,
+        confidence        DOUBLE  NOT NULL DEFAULT 0.0,
+        supporting_data   TEXT,
+        generated_at      DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+        expires_at        TEXT
       )
-      ON CONFLICT(agent, task_type) DO UPDATE SET
-        total_tasks         = total_tasks + @totalTasks,
-        successful_tasks    = successful_tasks + @successfulTasks,
-        failed_tasks        = failed_tasks + @failedTasks,
-        total_input_tokens  = total_input_tokens + @inputTokens,
-        total_output_tokens = total_output_tokens + @outputTokens,
-        total_duration_ms   = total_duration_ms + @durationMs,
-        total_cost          = total_cost + @cost,
-        total_retries       = total_retries + @retries,
-        last_updated        = @lastUpdated
     `);
-		logger$11.info({ path: this._path }, "Monitor database ready");
 	}
 	_assertOpen() {
-		if (this._db === null) throw new Error("MonitorDatabase: connection is closed");
-		return this._db;
+		if (this._syncAdapter === null || this._adapter === null) throw new Error("MonitorDatabase: connection is closed");
+		return this._syncAdapter;
+	}
+	/**
+	* Execute a query synchronously and return results.
+	* Uses the SyncAdapter interface for guaranteed synchronous execution.
+	*/
+	_querySync(sql, params) {
+		const adapter = this._assertOpen();
+		return adapter.querySync(sql, params);
+	}
+	/**
+	* Execute a mutation (INSERT/UPDATE/DELETE) synchronously.
+	* Uses the SyncAdapter interface for guaranteed synchronous execution.
+	*/
+	_mutateSync(sql, params) {
+		const adapter = this._assertOpen();
+		adapter.querySync(sql, params);
 	}
 	insertTaskMetrics(row) {
-		this._assertOpen();
-		this._stmtInsertMetrics.run({
-			taskId: row.taskId,
-			agent: row.agent,
-			taskType: row.taskType,
-			outcome: row.outcome,
-			failureReason: row.failureReason ?? null,
-			inputTokens: row.inputTokens,
-			outputTokens: row.outputTokens,
-			durationMs: row.durationMs,
-			cost: row.cost,
-			estimatedCost: row.estimatedCost,
-			billingMode: row.billingMode,
-			recordedAt: row.recordedAt
-		});
+		const dup = this._querySync("SELECT task_id FROM task_metrics WHERE task_id = ? AND recorded_at = ?", [row.taskId, row.recordedAt]);
+		if (dup.length > 0) return;
+		this._mutateSync(`INSERT INTO task_metrics (
+        task_id, agent, task_type, outcome, failure_reason,
+        input_tokens, output_tokens, duration_ms, cost, estimated_cost,
+        billing_mode, recorded_at
+      ) VALUES (
+        ?, ?, ?, ?, ?,
+        ?, ?, ?, ?, ?,
+        ?, ?
+      )`, [
+			row.taskId,
+			row.agent,
+			row.taskType,
+			row.outcome,
+			row.failureReason ?? null,
+			row.inputTokens,
+			row.outputTokens,
+			row.durationMs,
+			row.cost,
+			row.estimatedCost,
+			row.billingMode,
+			row.recordedAt
+		]);
 	}
 	updateAggregates(agent, taskType, delta) {
-		this._assertOpen();
-		this._stmtUpsertAggregates.run({
+		const now = new Date().toISOString();
+		const successfulTasks = delta.outcome === "success" ? 1 : 0;
+		const failedTasks = delta.outcome === "failure" ? 1 : 0;
+		const retries = delta.retries ?? 0;
+		const existing = this._querySync(`SELECT agent FROM performance_aggregates WHERE agent = ? AND task_type = ?`, [agent, taskType]);
+		if (existing.length === 0) this._mutateSync(`INSERT INTO performance_aggregates (
+          agent, task_type, total_tasks, successful_tasks, failed_tasks,
+          total_input_tokens, total_output_tokens, total_duration_ms, total_cost, total_retries, last_updated
+        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
 			agent,
 			taskType,
-			totalTasks: 1,
-			successfulTasks: delta.outcome === "success" ? 1 : 0,
-			failedTasks: delta.outcome === "failure" ? 1 : 0,
-			inputTokens: delta.inputTokens,
-			outputTokens: delta.outputTokens,
-			durationMs: delta.durationMs,
-			cost: delta.cost,
-			retries: delta.retries ?? 0,
-			lastUpdated: new Date().toISOString()
-		});
+			1,
+			successfulTasks,
+			failedTasks,
+			delta.inputTokens,
+			delta.outputTokens,
+			delta.durationMs,
+			delta.cost,
+			retries,
+			now
+		]);
+		else this._mutateSync(`UPDATE performance_aggregates SET
+          total_tasks = total_tasks + 1,
+          successful_tasks = successful_tasks + ?,
+          failed_tasks = failed_tasks + ?,
+          total_input_tokens = total_input_tokens + ?,
+          total_output_tokens = total_output_tokens + ?,
+          total_duration_ms = total_duration_ms + ?,
+          total_cost = total_cost + ?,
+          total_retries = total_retries + ?,
+          last_updated = ?
+        WHERE agent = ? AND task_type = ?`, [
+			successfulTasks,
+			failedTasks,
+			delta.inputTokens,
+			delta.outputTokens,
+			delta.durationMs,
+			delta.cost,
+			retries,
+			now,
+			agent,
+			taskType
+		]);
 	}
 	updatePerformanceAggregates(agent, taskType, delta) {
 		this.updateAggregates(agent, taskType, delta);
 	}
 	getAggregates(filter) {
-		const db = this._assertOpen();
 		let sql = `
       SELECT agent, task_type, total_tasks, successful_tasks, failed_tasks,
              total_input_tokens, total_output_tokens, total_duration_ms, total_cost, last_updated
       FROM performance_aggregates
     `;
 		const conditions = [];
-		const params = {};
+		const params = [];
 		if (filter?.agent) {
-			conditions.push("agent = @agent");
-			params.agent = filter.agent;
+			conditions.push("agent = ?");
+			params.push(filter.agent);
 		}
 		if (filter?.taskType) {
-			conditions.push("task_type = @taskType");
-			params.taskType = filter.taskType;
+			conditions.push("task_type = ?");
+			params.push(filter.taskType);
 		}
 		if (filter?.sinceDate) {
-			conditions.push("last_updated >= @sinceDate");
-			params.sinceDate = filter.sinceDate;
+			conditions.push("last_updated >= ?");
+			params.push(filter.sinceDate);
 		}
 		if (conditions.length > 0) sql += " WHERE " + conditions.join(" AND ");
-		const rows = db.prepare(sql).all(params);
+		const rows = this._querySync(sql, params);
 		return rows.map((r) => ({
 			agent: r.agent,
 			taskType: r.task_type,
@@ -4365,9 +4361,7 @@ var MonitorDatabaseImpl = class {
 		}));
 	}
 	getAgentPerformance(agent) {
-		const db = this._assertOpen();
-		const row = db.prepare(`
-      SELECT
+		const rows = this._querySync(`SELECT
         SUM(total_tasks)         AS total_tasks,
         SUM(successful_tasks)    AS successful_tasks,
         SUM(failed_tasks)        AS failed_tasks,
@@ -4378,8 +4372,8 @@ var MonitorDatabaseImpl = class {
         SUM(total_retries)       AS total_retries,
         MAX(last_updated)        AS last_updated
       FROM performance_aggregates
-      WHERE agent = @agent
-    `).get({ agent });
+      WHERE agent = ?`, [agent]);
+		const row = rows[0];
 		if (row == null || row.total_tasks == null || row.total_tasks === 0) return null;
 		const totalTasks = row.total_tasks;
 		const successfulTasks = row.successful_tasks ?? 0;
@@ -4402,9 +4396,7 @@ var MonitorDatabaseImpl = class {
 		};
 	}
 	getTaskTypeBreakdown(taskType) {
-		const db = this._assertOpen();
-		const rows = db.prepare(`
-      SELECT
+		const rows = this._querySync(`SELECT
         agent,
         total_tasks,
         successful_tasks,
@@ -4415,9 +4407,8 @@ var MonitorDatabaseImpl = class {
         total_cost,
         last_updated
       FROM performance_aggregates
-      WHERE task_type = @taskType
-      ORDER BY (CAST(successful_tasks AS REAL) / NULLIF(total_tasks, 0)) DESC
-    `).all({ taskType });
+      WHERE task_type = ?
+      ORDER BY (CAST(successful_tasks AS DOUBLE) / NULLIF(total_tasks, 0)) DESC`, [taskType]);
 		if (rows.length === 0) return null;
 		return {
 			task_type: taskType,
@@ -4432,80 +4423,81 @@ var MonitorDatabaseImpl = class {
 		};
 	}
 	pruneOldData(retentionDays) {
-		const db = this._assertOpen();
 		const cutoff = new Date(Date.now() - retentionDays * 24 * 60 * 60 * 1e3).toISOString();
-		const result = db.prepare("DELETE FROM task_metrics WHERE recorded_at < @cutoff").run({ cutoff });
+		const countRows = this._querySync(`SELECT COUNT(*) AS cnt FROM task_metrics WHERE recorded_at < ?`, [cutoff]);
+		const count = countRows[0]?.cnt ?? 0;
+		this._mutateSync(`DELETE FROM task_metrics WHERE recorded_at < ?`, [cutoff]);
 		logger$11.info({
 			cutoff,
-			deleted: result.changes
+			deleted: count
 		}, "Pruned old task_metrics rows");
-		return result.changes;
+		return count;
 	}
 	rebuildAggregates() {
-		const db = this._assertOpen();
-		db.exec("BEGIN IMMEDIATE");
+		const adapter = this._assertOpen();
 		try {
-			db.exec(`
-        DELETE FROM performance_aggregates;
-
-        INSERT INTO performance_aggregates (
-          agent, task_type,
-          total_tasks, successful_tasks, failed_tasks,
-          total_input_tokens, total_output_tokens, total_duration_ms, total_cost, total_retries,
-          last_updated
-        )
-        SELECT
+			adapter.execSync(`BEGIN`);
+			this._mutateSync(`DELETE FROM performance_aggregates`);
+			const rows = this._querySync(`SELECT
           agent,
           task_type,
-          COUNT(*)                                                    AS total_tasks,
-          SUM(CASE WHEN outcome = 'success' THEN 1 ELSE 0 END)       AS successful_tasks,
-          SUM(CASE WHEN outcome = 'failure' THEN 1 ELSE 0 END)       AS failed_tasks,
-          SUM(input_tokens)                                           AS total_input_tokens,
-          SUM(output_tokens)                                          AS total_output_tokens,
-          SUM(duration_ms)                                            AS total_duration_ms,
-          SUM(cost)                                                   AS total_cost,
-          COALESCE(SUM(retries), 0)                                   AS total_retries,
-          datetime('now')                                             AS last_updated
+          COUNT(*) AS total_tasks,
+          SUM(CASE WHEN outcome = 'success' THEN 1 ELSE 0 END) AS successful_tasks,
+          SUM(CASE WHEN outcome = 'failure' THEN 1 ELSE 0 END) AS failed_tasks,
+          SUM(input_tokens) AS total_input_tokens,
+          SUM(output_tokens) AS total_output_tokens,
+          SUM(duration_ms) AS total_duration_ms,
+          SUM(cost) AS total_cost,
+          COALESCE(SUM(retries), 0) AS total_retries
         FROM task_metrics
-        GROUP BY agent, task_type;
-      `);
-			db.exec("COMMIT");
+        GROUP BY agent, task_type`);
+			const now = new Date().toISOString();
+			for (const r of rows) this._mutateSync(`INSERT INTO performance_aggregates (
+            agent, task_type,
+            total_tasks, successful_tasks, failed_tasks,
+            total_input_tokens, total_output_tokens, total_duration_ms, total_cost, total_retries,
+            last_updated
+          ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+				r.agent,
+				r.task_type,
+				r.total_tasks,
+				r.successful_tasks,
+				r.failed_tasks,
+				r.total_input_tokens,
+				r.total_output_tokens,
+				r.total_duration_ms,
+				r.total_cost,
+				r.total_retries,
+				now
+			]);
+			adapter.execSync(`COMMIT`);
+			logger$11.info("Rebuilt performance_aggregates from task_metrics");
 		} catch (err) {
-			db.exec("ROLLBACK");
+			try {
+				adapter.execSync(`ROLLBACK`);
+			} catch {}
 			throw err;
 		}
-		logger$11.info("Rebuilt performance_aggregates from task_metrics");
 	}
 	resetAllData() {
-		const db = this._assertOpen();
-		db.exec("DELETE FROM task_metrics");
-		db.exec("DELETE FROM performance_aggregates");
+		this._mutateSync(`DELETE FROM task_metrics`);
+		this._mutateSync(`DELETE FROM performance_aggregates`);
 		logger$11.info({ path: this._path }, "Monitor data reset — all rows deleted");
 	}
 	getTaskMetricsDateRange() {
-		const db = this._assertOpen();
-		const row = db.prepare(`
-      SELECT MIN(recorded_at) AS earliest, MAX(recorded_at) AS latest
-      FROM task_metrics
-    `).get();
+		const rows = this._querySync(`SELECT MIN(recorded_at) AS earliest, MAX(recorded_at) AS latest FROM task_metrics`);
 		return {
-			earliest: row?.earliest ?? null,
-			latest: row?.latest ?? null
+			earliest: rows[0]?.earliest ?? null,
+			latest: rows[0]?.latest ?? null
 		};
 	}
 	close() {
-		if (this._db === null) return;
-		this._db.close();
-		this._db = null;
+		if (this._adapter === null) return;
+		this._adapter.close();
+		this._adapter = null;
+		this._syncAdapter = null;
 		logger$11.info({ path: this._path }, "Monitor database closed");
 	}
-	/**
-	* Access the raw underlying database for testing purposes only.
-	* @internal
-	*/
-	get rawDb() {
-		return this._assertOpen();
-	}
 };
 
 //#endregion
@@ -6901,22 +6893,25 @@ const logger$4 = createLogger("export-cmd");
 */
 async function runExportAction(options) {
 	const { runId, outputDir, projectRoot, outputFormat } = options;
-	let dbWrapper;
+	let adapter;
 	try {
 		const dbRoot = await resolveMainRepoRoot(projectRoot);
 		const dbPath = join$1(dbRoot, ".substrate", "substrate.db");
-		if (!existsSync$1(dbPath)) {
+		const doltDir = join$1(dbRoot, ".substrate", "state", ".dolt");
+		if (!existsSync$1(dbPath) && !existsSync$1(doltDir)) {
 			const errorMsg = `Decision store not initialized. Run 'substrate init' first.`;
 			if (outputFormat === "json") process.stdout.write(JSON.stringify({ error: errorMsg }) + "\n");
 			else process.stderr.write(`Error: ${errorMsg}\n`);
 			return 1;
 		}
-		dbWrapper = new DatabaseWrapper(dbPath);
-		dbWrapper.open();
-		const db = dbWrapper.db;
+		adapter = createDatabaseAdapter({
+			backend: "auto",
+			basePath: dbRoot
+		});
+		await initSchema(adapter);
 		let run;
-		if (runId !== void 0 && runId !== "") run = db.prepare("SELECT * FROM pipeline_runs WHERE id = ?").get(runId);
-		else run = getLatestRun(db);
+		if (runId !== void 0 && runId !== "") run = await getPipelineRunById(adapter, runId);
+		else run = await getLatestRun(adapter);
 		if (run === void 0) {
 			const errorMsg = runId !== void 0 ? `Pipeline run '${runId}' not found.` : "No pipeline runs found. Run `substrate run` first.";
 			if (outputFormat === "json") process.stdout.write(JSON.stringify({ error: errorMsg }) + "\n");
@@ -6928,7 +6923,7 @@ async function runExportAction(options) {
 		if (!existsSync$1(resolvedOutputDir)) mkdirSync$1(resolvedOutputDir, { recursive: true });
 		const filesWritten = [];
 		const phasesExported = [];
-		const analysisDecisions = getDecisionsByPhaseForRun(db, activeRunId, "analysis");
+		const analysisDecisions = await getDecisionsByPhaseForRun(adapter, activeRunId, "analysis");
 		if (analysisDecisions.length > 0) {
 			const content = renderProductBrief(analysisDecisions);
 			if (content !== "") {
@@ -6939,9 +6934,9 @@ async function runExportAction(options) {
 				if (outputFormat === "human") process.stdout.write(`  Written: ${filePath}\n`);
 			}
 		}
-		const planningDecisions = getDecisionsByPhaseForRun(db, activeRunId, "planning");
+		const planningDecisions = await getDecisionsByPhaseForRun(adapter, activeRunId, "planning");
 		if (planningDecisions.length > 0) {
-			const requirements = listRequirements(db).filter((r) => r.pipeline_run_id === activeRunId);
+			const requirements = (await listRequirements(adapter)).filter((r) => r.pipeline_run_id === activeRunId);
 			const content = renderPrd(planningDecisions, requirements);
 			if (content !== "") {
 				const filePath = join$1(resolvedOutputDir, "prd.md");
@@ -6951,7 +6946,7 @@ async function runExportAction(options) {
 				if (outputFormat === "human") process.stdout.write(`  Written: ${filePath}\n`);
 			}
 		}
-		const solutioningDecisions = getDecisionsByPhaseForRun(db, activeRunId, "solutioning");
+		const solutioningDecisions = await getDecisionsByPhaseForRun(adapter, activeRunId, "solutioning");
 		if (solutioningDecisions.length > 0) {
 			const archContent = renderArchitecture(solutioningDecisions);
 			if (archContent !== "") {
@@ -6978,7 +6973,7 @@ async function runExportAction(options) {
 				if (outputFormat === "human") process.stdout.write(`  Written: ${filePath}\n`);
 			}
 		}
-		const operationalDecisions = getDecisionsByCategory(db, OPERATIONAL_FINDING);
+		const operationalDecisions = await getDecisionsByCategory(adapter, OPERATIONAL_FINDING);
 		if (operationalDecisions.length > 0) {
 			const operationalContent = renderOperationalFindings(operationalDecisions);
 			if (operationalContent !== "") {
@@ -6989,7 +6984,7 @@ async function runExportAction(options) {
 				if (outputFormat === "human") process.stdout.write(`  Written: ${filePath}\n`);
 			}
 		}
-		const experimentDecisions = getDecisionsByCategory(db, EXPERIMENT_RESULT);
+		const experimentDecisions = await getDecisionsByCategory(adapter, EXPERIMENT_RESULT);
 		if (experimentDecisions.length > 0) {
 			const experimentsContent = renderExperiments(experimentDecisions);
 			if (experimentsContent !== "") {
@@ -7024,8 +7019,8 @@ async function runExportAction(options) {
 		logger$4.error({ err }, "export action failed");
 		return 1;
 	} finally {
-		if (dbWrapper !== void 0) try {
-			dbWrapper.close();
+		if (adapter !== void 0) try {
+			await adapter.close();
 		} catch {}
 	}
 }
@@ -7056,11 +7051,11 @@ function registerExportCommand(program, _version = "0.0.0", projectRoot = proces
 * - When `runId` is omitted, the runId of the last (most recently created)
 *   escalation-diagnosis decision is used as the default (AC1 defaulting).
 *
-* @param db    The SQLite database connection
-* @param runId Optional run ID to scope the query
+* @param adapter  The database adapter
+* @param runId    Optional run ID to scope the query
 */
-function getRetryableEscalations(db, runId) {
-	const decisions = getDecisionsByCategory(db, ESCALATION_DIAGNOSIS);
+async function getRetryableEscalations(adapter, runId) {
+	const decisions = await getDecisionsByCategory(adapter, ESCALATION_DIAGNOSIS);
 	const result = {
 		retryable: [],
 		skipped: []
@@ -7113,18 +7108,20 @@ async function runRetryEscalatedAction(options) {
 	const { runId, dryRun, outputFormat, projectRoot, concurrency, pack: packName, registry: injectedRegistry } = options;
 	const dbRoot = await resolveMainRepoRoot(projectRoot);
 	const dbPath = join(dbRoot, ".substrate", "substrate.db");
-	if (!existsSync(dbPath)) {
+	const doltDir = join(dbRoot, ".substrate", "state", ".dolt");
+	if (!existsSync(dbPath) && !existsSync(doltDir)) {
 		const errorMsg = `Decision store not initialized. Run 'substrate init' first.`;
 		if (outputFormat === "json") process.stdout.write(formatOutput(null, "json", false, errorMsg) + "\n");
 		else process.stderr.write(`Error: ${errorMsg}\n`);
 		return 1;
 	}
-	const dbWrapper = new DatabaseWrapper(dbPath);
+	const adapter = createDatabaseAdapter({
+		backend: "auto",
+		basePath: dbRoot
+	});
 	try {
-		dbWrapper.open();
-		runMigrations(dbWrapper.db);
-		const db = dbWrapper.db;
-		const { retryable, skipped } = getRetryableEscalations(db, runId);
+		await initSchema(adapter);
+		const { retryable, skipped } = await getRetryableEscalations(adapter, runId);
 		if (retryable.length === 0) {
 			if (outputFormat === "json") process.stdout.write(formatOutput({
 				retryKeys: [],
@@ -7162,7 +7159,7 @@ async function runRetryEscalatedAction(options) {
 			process.stdout.write(`Retrying: ${count} ${count === 1 ? "story" : "stories"} — ${retryable.join(", ")}\n`);
 			for (const s of skipped) process.stdout.write(`Skipping: ${s.key} (${s.reason})\n`);
 		}
-		const pipelineRun = createPipelineRun(db, {
+		const pipelineRun = await createPipelineRun(adapter, {
 			methodology: pack.manifest.name,
 			start_phase: "implementation",
 			config_json: JSON.stringify({
@@ -7172,14 +7169,14 @@ async function runRetryEscalatedAction(options) {
 			})
 		});
 		const eventBus = createEventBus();
-		const contextCompiler = createContextCompiler({ db });
+		const contextCompiler = createContextCompiler({ db: adapter });
 		if (!injectedRegistry) throw new Error("AdapterRegistry is required — must be initialized at CLI startup");
 		const dispatcher = createDispatcher({
 			eventBus,
 			adapterRegistry: injectedRegistry
 		});
 		const orchestrator = createImplementationOrchestrator({
-			db,
+			db: adapter,
 			pack,
 			contextCompiler,
 			dispatcher,
@@ -7197,12 +7194,14 @@ async function runRetryEscalatedAction(options) {
 				if (result?.tokenUsage !== void 0) {
 					const { input, output } = result.tokenUsage;
 					const costUsd = (input * 3 + output * 15) / 1e6;
-					addTokenUsage(db, pipelineRun.id, {
+					addTokenUsage(adapter, pipelineRun.id, {
 						phase: payload.phase,
 						agent: "claude-code",
 						input_tokens: input,
 						output_tokens: output,
 						cost_usd: costUsd
+					}).catch((err) => {
+						logger$3.warn({ err }, "Failed to record token usage");
 					});
 				}
 			} catch (err) {
@@ -7232,7 +7231,7 @@ async function runRetryEscalatedAction(options) {
 		return 1;
 	} finally {
 		try {
-			dbWrapper.close();
+			await adapter.close();
 		} catch {}
 	}
 }