substrate-ai 0.20.91 → 0.20.93

package/dist/{health-C91xmseT.js → health-dWYa13k4.js}

@@ -4,7 +4,6 @@ import { resolveMainRepoRoot, resolveRunManifest } from "./manifest-read-CSmDEOW
 import { createRequire } from "module";
 import { dirname, join } from "path";
 import { existsSync, readFileSync } from "node:fs";
-import { spawnSync } from "node:child_process";
 import { join as join$1 } from "node:path";
 import { readFile, writeFile } from "node:fs/promises";
 import { existsSync as existsSync$1 } from "fs";
@@ -403,13 +402,6 @@ function formatPipelineSummary(run, tokenSummary, decisionsCount, storiesCount,
 
 //#endregion
 //#region src/modules/state/file-store.ts
-/**
-* In-memory / file-backed StateStore implementation.
-*
-* Suitable for CI environments and testing where orchestrator state is
-* ephemeral. Use DoltStateStore for branch-per-story isolation and versioned
-* history in production.
-*/
 var FileStateStore = class {
 	_basePath;
 	_stories = new Map();
@@ -423,9 +415,6 @@ var FileStateStore = class {
 	}
 	async initialize() {}
 	async close() {}
-	async getStoryState(storyKey) {
-		return this._stories.get(storyKey);
-	}
 	async setStoryState(storyKey, state) {
 		this._stories.set(storyKey, {
 			...state,
@@ -451,23 +440,6 @@ var FileStateStore = class {
 		};
 		this._metrics.push(record);
 	}
-	async queryMetrics(filter) {
-		const storyKey = filter.storyKey ?? filter.story_key;
-		const taskType = filter.taskType ?? filter.task_type;
-		return this._metrics.filter((m) => {
-			if (storyKey !== void 0 && m.storyKey !== storyKey) return false;
-			if (taskType !== void 0 && m.taskType !== taskType) return false;
-			if (filter.sprint !== void 0 && m.sprint !== filter.sprint) return false;
-			if (filter.dateFrom !== void 0 && m.recordedAt !== void 0 && m.recordedAt < filter.dateFrom) return false;
-			if (filter.dateTo !== void 0 && m.recordedAt !== void 0 && m.recordedAt > filter.dateTo) return false;
-			if (filter.since !== void 0 && m.recordedAt !== void 0 && m.recordedAt < filter.since) return false;
-			return true;
-		});
-	}
-	/**
-	* Persist an arbitrary key-value metric for a run.
-	* Stored in memory AND written to `{basePath}/kv-metrics.json` when basePath is set.
-	*/
 	async setMetric(runId, key, value) {
 		let runMap = this._kvMetrics.get(runId);
 		if (runMap === void 0) {
@@ -477,10 +449,6 @@ var FileStateStore = class {
 		runMap.set(key, value);
 		if (this._basePath !== void 0) await this._flushKvMetrics();
 	}
-	/**
-	* Retrieve a previously stored key-value metric for a run.
-	* Reads from in-memory cache, falling back to the JSON file when basePath is set.
-	*/
 	async getMetric(runId, key) {
 		const inMemory = this._kvMetrics.get(runId)?.get(key);
 		if (inMemory !== void 0) return inMemory;
@@ -492,7 +460,6 @@ var FileStateStore = class {
 		} catch {}
 		return void 0;
 	}
-	/** Serialize the in-memory kv metrics map to JSON on disk. */
 	async _flushKvMetrics() {
 		if (this._basePath === void 0) return;
 		const serialized = {};
@@ -503,9 +470,6 @@ var FileStateStore = class {
 		const filePath = join$1(this._basePath, "kv-metrics.json");
 		await writeFile(filePath, JSON.stringify(serialized, null, 2), "utf-8");
 	}
-	async getContracts(storyKey) {
-		return this._contracts.get(storyKey) ?? [];
-	}
 	async setContracts(storyKey, contracts) {
 		this._contracts.set(storyKey, contracts.map((c) => ({ ...c })));
 	}
@@ -527,18 +491,9 @@ var FileStateStore = class {
 			await writeFile(filePath, JSON.stringify(serialized, null, 2), "utf-8");
 		}
 	}
-	async getContractVerification(storyKey) {
-		return this._contractVerifications.get(storyKey) ?? [];
-	}
 	async branchForStory(_storyKey) {}
 	async mergeStory(_storyKey) {}
 	async rollbackStory(_storyKey) {}
-	async diffStory(storyKey) {
-		return {
-			storyKey,
-			tables: []
-		};
-	}
 	async getHistory(_limit) {
 		return [];
 	}
@@ -589,27 +544,16 @@ const STORY_KEY_PATTERN = /^[A-Za-z0-9]+(-[A-Za-z0-9]+)?$/;
 function assertValidStoryKey(storyKey) {
 	if (!STORY_KEY_PATTERN.test(storyKey)) throw new DoltQueryError("assertValidStoryKey", `Invalid story key: '${storyKey}'. Must match pattern <key> or <epic>-<story> (e.g. "E6", "10-1", "1-1a", "NEW-26").`);
 }
-/**
-* Dolt-backed implementation of the StateStore interface.
-*
-* Constructor accepts a deps object for DI: `{ repoPath, client }`.
-* Call `initialize()` before any CRUD operations.
-*/
-var DoltStateStore = class DoltStateStore {
+var DoltStateStore = class {
 	_repoPath;
 	_client;
 	_storyBranches = new Map();
+	/** In-memory KV store for per-run arbitrary metrics. Not persisted to Dolt. */
+	_kvMetrics = new Map();
 	constructor(options) {
 		this._repoPath = options.repoPath;
 		this._client = options.client;
 	}
-	/**
-	* Return the branch name for a story if one has been created via branchForStory(),
-	* or undefined to use the default (main) branch.
-	*/
-	_branchFor(storyKey) {
-		return this._storyBranches.get(storyKey);
-	}
 	async initialize() {
 		await this._client.connect();
 		await this._runMigrations();
@@ -619,61 +563,16 @@ var DoltStateStore = class DoltStateStore {
 	async close() {
 		await this._client.close();
 	}
+	/**
+	* Idempotent runtime migration: add `repo_map_symbols.dependencies` JSON column
+	* if the table exists and the column doesn't. Skips silently when the table
+	* is absent (fresh DB or non-Dolt env).
+	*/
 	async _runMigrations() {
-		const ddl = [
-			`CREATE TABLE IF NOT EXISTS stories (
-        story_key     VARCHAR(100) NOT NULL,
-        phase         VARCHAR(30)  NOT NULL DEFAULT 'PENDING',
-        review_cycles INT          NOT NULL DEFAULT 0,
-        last_verdict  VARCHAR(64)  NULL,
-        error         TEXT         NULL,
-        started_at    VARCHAR(64)  NULL,
-        completed_at  VARCHAR(64)  NULL,
-        sprint        VARCHAR(50)  NULL,
-        PRIMARY KEY (story_key)
-      )`,
-			`CREATE TABLE IF NOT EXISTS metrics (
-        id              BIGINT       NOT NULL AUTO_INCREMENT,
-        story_key       VARCHAR(100) NOT NULL,
-        task_type       VARCHAR(100) NOT NULL,
-        model           VARCHAR(100) NULL,
-        tokens_in       BIGINT       NULL,
-        tokens_out      BIGINT       NULL,
-        cache_read_tokens BIGINT     NULL,
-        cost_usd        DOUBLE       NULL,
-        wall_clock_ms   BIGINT       NULL,
-        review_cycles   INT          NULL,
-        stall_count     INT          NULL,
-        result          VARCHAR(30)  NULL,
-        recorded_at     VARCHAR(64)  NULL,
-        sprint          VARCHAR(50)  NULL,
-        PRIMARY KEY (id)
-      )`,
-			`CREATE TABLE IF NOT EXISTS contracts (
-        story_key     VARCHAR(100) NOT NULL,
-        contract_name VARCHAR(200) NOT NULL,
-        direction     VARCHAR(20)  NOT NULL,
-        schema_path   VARCHAR(500) NULL,
-        transport     VARCHAR(200) NULL,
-        PRIMARY KEY (story_key, contract_name, direction)
-      )`,
-			`CREATE TABLE IF NOT EXISTS review_verdicts (
-        id            BIGINT       NOT NULL AUTO_INCREMENT,
-        story_key     VARCHAR(100) NOT NULL,
-        task_type     VARCHAR(100) NOT NULL,
-        verdict       VARCHAR(64)  NOT NULL,
-        issues_count  INT          NULL,
-        notes         TEXT         NULL,
-        timestamp     VARCHAR(64)  NULL,
-        PRIMARY KEY (id)
-      )`
-		];
-		for (const sql of ddl) await this._client.query(sql);
 		try {
 			const colRows = await this._client.query(`SHOW COLUMNS FROM repo_map_symbols LIKE 'dependencies'`);
 			if (colRows.length === 0) {
 				await this._client.query(`ALTER TABLE repo_map_symbols ADD COLUMN dependencies JSON`);
-				await this._client.query(`INSERT IGNORE INTO _schema_version (version, description) VALUES (6, 'Add dependencies JSON column to repo_map_symbols (Epic 28-3)')`);
 				log.info({
 					component: "dolt-state",
 					migration: "v5-to-v6",
@@ -705,233 +604,6 @@ var DoltStateStore = class DoltStateStore {
 			log.warn({ detail }, "Dolt flush failed (non-fatal)");
 		}
 	}
-	async getStoryState(storyKey) {
-		const rows = await this._client.query("SELECT * FROM stories WHERE story_key = ?", [storyKey]);
-		if (rows.length === 0) return void 0;
-		return this._rowToStory(rows[0]);
-	}
-	async setStoryState(storyKey, state) {
-		const branch = this._branchFor(storyKey);
-		const sql = `REPLACE INTO stories
-      (story_key, phase, review_cycles, last_verdict, error, started_at, completed_at, sprint)
-      VALUES (?, ?, ?, ?, ?, ?, ?, ?)`;
-		await this._client.query(sql, [
-			storyKey,
-			state.phase,
-			state.reviewCycles,
-			state.lastVerdict ?? null,
-			state.error ?? null,
-			state.startedAt ?? null,
-			state.completedAt ?? null,
-			state.sprint ?? null
-		], branch);
-	}
-	async queryStories(filter) {
-		const conditions = [];
-		const params = [];
-		if (filter.phase !== void 0) {
-			const phases = Array.isArray(filter.phase) ? filter.phase : [filter.phase];
-			const placeholders = phases.map(() => "?").join(", ");
-			conditions.push(`phase IN (${placeholders})`);
-			params.push(...phases);
-		}
-		if (filter.sprint !== void 0) {
-			conditions.push("sprint = ?");
-			params.push(filter.sprint);
-		}
-		if (filter.storyKey !== void 0) {
-			conditions.push("story_key = ?");
-			params.push(filter.storyKey);
-		}
-		const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
-		const sql = `SELECT * FROM stories ${where} ORDER BY story_key`;
-		const rows = await this._client.query(sql, params);
-		return rows.map((r) => this._rowToStory(r));
-	}
-	_rowToStory(row) {
-		return {
-			storyKey: row.story_key,
-			phase: row.phase,
-			reviewCycles: Number(row.review_cycles),
-			lastVerdict: row.last_verdict ?? void 0,
-			error: row.error ?? void 0,
-			startedAt: row.started_at ?? void 0,
-			completedAt: row.completed_at ?? void 0,
-			sprint: row.sprint ?? void 0
-		};
-	}
-	async recordMetric(metric) {
-		const branch = this._branchFor(metric.storyKey);
-		const recordedAt = metric.recordedAt ?? metric.timestamp ?? new Date().toISOString();
-		const sql = `INSERT INTO metrics
-      (story_key, task_type, model, tokens_in, tokens_out, cache_read_tokens,
-       cost_usd, wall_clock_ms, review_cycles, stall_count, result, recorded_at, sprint)
-      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`;
-		await this._client.query(sql, [
-			metric.storyKey,
-			metric.taskType,
-			metric.model ?? null,
-			metric.tokensIn ?? null,
-			metric.tokensOut ?? null,
-			metric.cacheReadTokens ?? null,
-			metric.costUsd ?? null,
-			metric.wallClockMs ?? null,
-			metric.reviewCycles ?? null,
-			metric.stallCount ?? null,
-			metric.result ?? null,
-			recordedAt,
-			metric.sprint ?? null
-		], branch);
-	}
-	async queryMetrics(filter) {
-		const conditions = [];
-		const params = [];
-		const storyKey = filter.storyKey ?? filter.story_key;
-		const taskType = filter.taskType ?? filter.task_type;
-		if (storyKey !== void 0) {
-			conditions.push("story_key = ?");
-			params.push(storyKey);
-		}
-		if (taskType !== void 0) {
-			conditions.push("task_type = ?");
-			params.push(taskType);
-		}
-		if (filter.sprint !== void 0) {
-			conditions.push("sprint = ?");
-			params.push(filter.sprint);
-		}
-		if (filter.dateFrom !== void 0) {
-			conditions.push("recorded_at >= ?");
-			params.push(filter.dateFrom);
-		}
-		if (filter.dateTo !== void 0) {
-			conditions.push("recorded_at <= ?");
-			params.push(filter.dateTo);
-		}
-		if (filter.since !== void 0) {
-			conditions.push("recorded_at >= ?");
-			params.push(filter.since);
-		}
-		const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
-		if (filter.aggregate) {
-			const sql$1 = `SELECT task_type,
-        AVG(cost_usd) AS avg_cost_usd,
-        SUM(tokens_in) AS sum_tokens_in,
-        SUM(tokens_out) AS sum_tokens_out,
-        COUNT(*) AS count
-        FROM metrics ${where} GROUP BY task_type ORDER BY task_type`;
-			const aggRows = await this._client.query(sql$1, params);
-			return aggRows.map((r) => this._aggregateRowToMetric(r));
-		}
-		const sql = `SELECT * FROM metrics ${where} ORDER BY id`;
-		const rows = await this._client.query(sql, params);
-		return rows.map((r) => this._rowToMetric(r));
-	}
-	_aggregateRowToMetric(row) {
-		return {
-			storyKey: "",
-			taskType: row.task_type,
-			costUsd: row.avg_cost_usd ?? void 0,
-			tokensIn: row.sum_tokens_in ?? void 0,
-			tokensOut: row.sum_tokens_out ?? void 0,
-			count: row.count,
-			result: "aggregate"
-		};
-	}
-	_rowToMetric(row) {
-		return {
-			storyKey: row.story_key,
-			taskType: row.task_type,
-			model: row.model ?? void 0,
-			tokensIn: row.tokens_in ?? void 0,
-			tokensOut: row.tokens_out ?? void 0,
-			cacheReadTokens: row.cache_read_tokens ?? void 0,
-			costUsd: row.cost_usd ?? void 0,
-			wallClockMs: row.wall_clock_ms ?? void 0,
-			reviewCycles: row.review_cycles ?? void 0,
-			stallCount: row.stall_count ?? void 0,
-			result: row.result ?? void 0,
-			recordedAt: row.recorded_at ?? void 0,
-			sprint: row.sprint ?? void 0,
-			timestamp: row.timestamp ?? row.recorded_at ?? void 0
-		};
-	}
-	async getContracts(storyKey) {
-		const rows = await this._client.query("SELECT * FROM contracts WHERE story_key = ? ORDER BY contract_name", [storyKey]);
-		return rows.map((r) => this._rowToContract(r));
-	}
-	async setContracts(storyKey, contracts) {
-		const branch = this._branchFor(storyKey);
-		await this._client.query("DELETE FROM contracts WHERE story_key = ?", [storyKey], branch);
-		for (const c of contracts) await this._client.query(`INSERT INTO contracts (story_key, contract_name, direction, schema_path, transport)
-         VALUES (?, ?, ?, ?, ?)`, [
-			c.storyKey,
-			c.contractName,
-			c.direction,
-			c.schemaPath,
-			c.transport ?? null
-		], branch);
-	}
-	_rowToContract(row) {
-		return {
-			storyKey: row.story_key,
-			contractName: row.contract_name,
-			direction: row.direction,
-			schemaPath: row.schema_path,
-			transport: row.transport ?? void 0
-		};
-	}
-	async queryContracts(filter) {
-		const conditions = [];
-		const params = [];
-		if (filter?.storyKey !== void 0) {
-			conditions.push("story_key = ?");
-			params.push(filter.storyKey);
-		}
-		if (filter?.direction !== void 0) {
-			conditions.push("direction = ?");
-			params.push(filter.direction);
-		}
-		const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
-		const sql = `SELECT * FROM contracts ${where} ORDER BY story_key, contract_name`;
-		const rows = await this._client.query(sql, params);
-		return rows.map((r) => this._rowToContract(r));
-	}
-	async setContractVerification(storyKey, results) {
-		const branch = this._branchFor(storyKey);
-		await this._client.query(`DELETE FROM review_verdicts WHERE story_key = ? AND task_type = 'contract-verification'`, [storyKey], branch);
-		const failCount = results.filter((r) => r.verdict === "fail").length;
-		for (const r of results) await this._client.query(`INSERT INTO review_verdicts (story_key, task_type, verdict, issues_count, notes, timestamp)
-         VALUES (?, 'contract-verification', ?, ?, ?, ?)`, [
-			storyKey,
-			r.verdict,
-			failCount,
-			JSON.stringify({
-				contractName: r.contractName,
-				mismatchDescription: r.mismatchDescription
-			}),
-			r.verifiedAt
-		], branch);
-	}
-	async getContractVerification(storyKey) {
-		const rows = await this._client.query(`SELECT * FROM review_verdicts WHERE story_key = ? AND task_type = 'contract-verification' ORDER BY timestamp DESC`, [storyKey]);
-		return rows.map((row) => {
-			let contractName = "";
-			let mismatchDescription;
-			if (row.notes !== null) try {
-				const parsed = JSON.parse(row.notes);
-				if (typeof parsed.contractName === "string") contractName = parsed.contractName;
-				if (typeof parsed.mismatchDescription === "string") mismatchDescription = parsed.mismatchDescription;
-			} catch {}
-			return {
-				storyKey: row.story_key,
-				contractName,
-				verdict: row.verdict,
-				...mismatchDescription !== void 0 ? { mismatchDescription } : {},
-				verifiedAt: row.timestamp ?? new Date().toISOString()
-			};
-		});
-	}
 	async branchForStory(storyKey) {
 		assertValidStoryKey(storyKey);
 		const branchName = `story/${storyKey}`;
@@ -963,18 +635,13 @@ var DoltStateStore = class DoltStateStore {
 			const mergeRows = await this._client.query(`CALL DOLT_MERGE('${branchName}')`, [], "main");
 			const mergeResult = mergeRows[0];
 			if (mergeResult && (mergeResult.conflicts ?? 0) > 0) {
-				let table = "stories";
+				let table = "unknown";
 				let rowKey = "unknown";
 				let ourValue;
 				let theirValue;
 				try {
-					const conflictRows = await this._client.query(`SELECT * FROM dolt_conflicts_stories LIMIT 1`, [], "main");
-					if (conflictRows.length > 0) {
-						const row = conflictRows[0];
-						rowKey = String(row["base_story_key"] ?? row["our_story_key"] ?? "unknown");
-						ourValue = JSON.stringify(row["our_status"] ?? row);
-						theirValue = JSON.stringify(row["their_status"] ?? row);
-					}
+					const conflictRows = await this._client.query(`SELECT table_name FROM dolt_conflicts LIMIT 1`, [], "main");
+					if (conflictRows.length > 0) table = String(conflictRows[0]["table_name"] ?? "unknown");
 				} catch {}
 				this._storyBranches.delete(storyKey);
 				throw new DoltMergeConflictError(table, [rowKey], {
@@ -1018,112 +685,6 @@ var DoltStateStore = class DoltStateStore {
 			this._storyBranches.delete(storyKey);
 		}
 	}
-	/**
-	* Tables queried by diffStory(). Each table is checked for row-level changes
-	* via SELECT * FROM DOLT_DIFF('main', branchName, tableName).
-	*/
-	static DIFF_TABLES = [
-		"stories",
-		"contracts",
-		"metrics",
-		"dispatch_log",
-		"build_results",
-		"review_verdicts"
-	];
-	async diffStory(storyKey) {
-		assertValidStoryKey(storyKey);
-		const branchName = this._storyBranches.get(storyKey);
-		if (branchName === void 0) return this._diffMergedStory(storyKey);
-		try {
-			await this._client.query(`CALL DOLT_ADD('-A')`, [], branchName);
-			await this._client.query(`CALL DOLT_COMMIT('-m', 'Story ${storyKey}: pre-diff snapshot', '--allow-empty')`, [], branchName);
-		} catch {}
-		return this._diffRange("main", branchName, storyKey);
-	}
-	/**
-	* Diff a merged story by finding its merge commit in the Dolt log.
-	* Queries the `dolt_log` system table for commits referencing the story,
-	* then diffs `<hash>~1` vs `<hash>` for row-level changes.
-	*/
-	async _diffMergedStory(storyKey) {
-		try {
-			const rows = await this._client.query(`SELECT commit_hash FROM dolt_log WHERE message LIKE ? LIMIT 1`, [`%${storyKey}%`]);
-			if (rows.length === 0) return {
-				storyKey,
-				tables: []
-			};
-			const hash = String(rows[0].commit_hash);
-			if (!hash) return {
-				storyKey,
-				tables: []
-			};
-			return this._diffRange(`${hash}~1`, hash, storyKey);
-		} catch {
-			return {
-				storyKey,
-				tables: []
-			};
-		}
-	}
-	/**
-	* Compute row-level diffs between two Dolt revisions (branches or commit hashes)
-	* across all tracked tables.
-	*/
-	async _diffRange(fromRef, toRef, storyKey) {
-		const tableDiffs = [];
-		for (const table of DoltStateStore.DIFF_TABLES) try {
-			const rows = await this._client.query(`SELECT * FROM DOLT_DIFF('${fromRef}', '${toRef}', '${table}')`, [], "main");
-			if (rows.length === 0) continue;
-			const added = [];
-			const modified = [];
-			const deleted = [];
-			for (const row of rows) {
-				const diffType = row["diff_type"];
-				const rowKey = this._extractRowKey(row);
-				const before = this._extractPrefixedFields(row, "before_");
-				const after = this._extractPrefixedFields(row, "after_");
-				const diffRow = {
-					rowKey,
-					...before !== void 0 && { before },
-					...after !== void 0 && { after }
-				};
-				if (diffType === "added") added.push(diffRow);
-				else if (diffType === "modified") modified.push(diffRow);
-				else if (diffType === "removed") deleted.push(diffRow);
-			}
-			if (added.length > 0 || modified.length > 0 || deleted.length > 0) tableDiffs.push({
-				table,
-				added,
-				modified,
-				deleted
-			});
-		} catch {}
-		return {
-			storyKey,
-			tables: tableDiffs
-		};
-	}
-	/**
-	* Extract a human-readable row key from a DOLT_DIFF result row.
-	* Tries after_ fields first (for added/modified rows), then before_ fields
-	* (for removed rows). Skips commit_hash pseudo-columns.
-	*/
-	_extractRowKey(row) {
-		for (const prefix of ["after_", "before_"]) for (const [key, val] of Object.entries(row)) if (key.startsWith(prefix) && !key.endsWith("_commit_hash") && val !== null && val !== void 0) return String(val);
-		return "unknown";
-	}
-	/**
-	* Extract all fields with a given prefix from a DOLT_DIFF result row,
-	* stripping the prefix from the key names. Returns undefined if no matching
-	* fields are found.
-	*/
-	_extractPrefixedFields(row, prefix) {
-		const result = {};
-		for (const [key, val] of Object.entries(row)) if (key.startsWith(prefix)) result[key.slice(prefix.length)] = val;
-		return Object.keys(result).length > 0 ? result : void 0;
-	}
-	/** In-memory KV store for per-run arbitrary metrics. Not persisted to Dolt. */
-	_kvMetrics = new Map();
 	async setMetric(runId, key, value) {
 		let runMap = this._kvMetrics.get(runId);
 		if (runMap === void 0) {
@@ -1165,65 +726,29 @@ var DoltStateStore = class DoltStateStore {
 
 //#endregion
 //#region src/modules/state/index.ts
-const logger$1 = createLogger("state:factory");
 /**
-* Synchronously check whether Dolt is available and a Dolt repo exists at the
-* canonical state path under `basePath`.
-*
-* @param basePath - Project root to check (e.g. `process.cwd()`).
-* @returns `{ available: true, reason: '...' }` when both probes pass,
-*          `{ available: false, reason: '...' }` otherwise.
+* Create a StateStore for orchestrator use. Returns a FileStateStore — the
+* Dolt backend is no longer routed through this factory (use
+* `createDoltOperatorReader` for operator-side Dolt reads).
 */
-function detectDoltAvailableSync(basePath) {
-	const result = spawnSync("dolt", ["version"], { stdio: "ignore" });
-	const binaryFound = result.error == null && result.status === 0;
-	if (!binaryFound) return {
-		available: false,
-		reason: "dolt binary not found on PATH"
-	};
-	const stateDoltDir = join$1(basePath, ".substrate", "state", ".dolt");
-	const repoExists = existsSync(stateDoltDir);
-	if (!repoExists) return {
-		available: false,
-		reason: `Dolt repo not initialised at ${stateDoltDir}`
-	};
-	return {
-		available: true,
-		reason: "dolt binary found and repo initialised"
-	};
+function createStateStore(config = {}) {
+	return new FileStateStore({ basePath: config.basePath });
 }
 /**
-* Create a StateStore backed by the specified backend.
+* Create a DoltOperatorReader for CLI operator commands (history, routing,
+* metrics, health). Constructs a DoltClient against `<basePath>/.dolt/` and
+* exposes only the read-side surface meaningful for operators.
 *
-* @param config - Optional configuration. Defaults to `{ backend: 'auto' }`.
-* @returns A StateStore instance. Call `initialize()` before use.
+* Caller is responsible for calling `initialize()` before use and `close()`
+* when done.
 */
-function createStateStore(config = {}) {
-	const backend = config.backend ?? "auto";
-	if (backend === "dolt") {
-		const repoPath = config.basePath ?? process.cwd();
-		const client = new DoltClient({ repoPath });
-		return new DoltStateStore({
-			repoPath,
-			client
-		});
-	}
-	if (backend === "auto") {
-		const repoPath = config.basePath ?? process.cwd();
-		const detection = detectDoltAvailableSync(repoPath);
-		if (detection.available) {
-			logger$1.debug(`Dolt detected, using DoltStateStore (state path: ${join$1(repoPath, ".substrate", "state")})`);
-			const client = new DoltClient({ repoPath });
-			return new DoltStateStore({
-				repoPath,
-				client
-			});
-		} else {
-			logger$1.debug(`Dolt not found, using FileStateStore (reason: ${detection.reason})`);
-			return new FileStateStore({ basePath: config.basePath });
-		}
-	}
-	return new FileStateStore({ basePath: config.basePath });
+function createDoltOperatorReader(config) {
+	const repoPath = config.basePath;
+	const client = new DoltClient({ repoPath });
+	return new DoltStateStore({
+		repoPath,
+		client
+	});
 }
 
 //#endregion
@@ -1269,8 +794,8 @@ function inspectProcessTree(opts) {
 			timeout: 5e3
 		});
 		else {
-			const { execFileSync: execFileSync$1 } = __require("node:child_process");
-			psOutput = execFileSync$1("ps", ["-eo", "pid,ppid,stat,command"], {
+			const { execFileSync } = __require("node:child_process");
+			psOutput = execFileSync("ps", ["-eo", "pid,ppid,stat,command"], {
 				encoding: "utf-8",
 				timeout: 5e3
 			});
@@ -1331,8 +856,8 @@ function getAllDescendantPids(rootPids, execFileSyncOverride) {
 			timeout: 5e3
 		});
 		else {
-			const { execFileSync: execFileSync$1 } = __require("node:child_process");
-			psOutput = execFileSync$1("ps", ["-eo", "pid,ppid"], {
+			const { execFileSync } = __require("node:child_process");
+			psOutput = execFileSync("ps", ["-eo", "pid,ppid"], {
 				encoding: "utf-8",
 				timeout: 5e3
 			});
@@ -1410,12 +935,12 @@ function buildHealthStoryCountsFromManifest(perStoryState) {
 * (missing DB, missing run, terminal run status). Throws only on unexpected errors.
 */
 async function getAutoHealthData(options) {
-	const { runId, projectRoot, stateStore, stateStoreConfig } = options;
+	const { runId, projectRoot, doltReader, doltReaderConfig } = options;
 	const dbRoot = await resolveMainRepoRoot(projectRoot);
 	const dbPath = join(dbRoot, ".substrate", "substrate.db");
 	let doltStateInfo;
-	if (stateStoreConfig?.backend === "dolt" && stateStore) {
-		const repoPath = stateStoreConfig.basePath ?? projectRoot;
+	if (doltReader && doltReaderConfig?.basePath !== void 0) {
+		const repoPath = doltReaderConfig.basePath;
 		const doltDirPath = join(repoPath, ".dolt");
 		const initialized = existsSync(doltDirPath);
 		let responsive = false;
@@ -1423,7 +948,7 @@ async function getAutoHealthData(options) {
 		let branches;
 		let currentBranch;
 		try {
-			await stateStore.getHistory(1);
+			await doltReader.getHistory(1);
 			responsive = true;
 			try {
 				const { execFile: ef } = await import("node:child_process");
@@ -1673,24 +1198,18 @@ function registerHealthCommand(program, _version = "0.0.0", projectRoot = proces
 	program.command("health").description("Check pipeline health: process status, stall detection, and verdict").option("--run-id <id>", "Pipeline run ID to query (defaults to latest)").option("--project-root <path>", "Project root directory", projectRoot).option("--output-format <format>", "Output format: human (default) or json", "human").action(async (opts) => {
 		const outputFormat = opts.outputFormat === "json" ? "json" : "human";
 		const root = opts.projectRoot;
-		let stateStore;
-		let stateStoreConfig;
+		let doltReader;
+		let doltReaderConfig;
 		const doltStatePath = join(root, ".substrate", "state", ".dolt");
 		if (existsSync(doltStatePath)) {
 			const basePath = join(root, ".substrate", "state");
-			stateStoreConfig = {
-				backend: "dolt",
-				basePath
-			};
+			doltReaderConfig = { basePath };
 			try {
-				stateStore = createStateStore({
-					backend: "dolt",
-					basePath
-				});
-				await stateStore.initialize();
+				doltReader = createDoltOperatorReader({ basePath });
+				await doltReader.initialize();
 			} catch {
-				stateStore = void 0;
-				stateStoreConfig = void 0;
+				doltReader = void 0;
+				doltReaderConfig = void 0;
 			}
 		}
 		try {
@@ -1698,18 +1217,18 @@ function registerHealthCommand(program, _version = "0.0.0", projectRoot = proces
 				outputFormat,
 				runId: opts.runId,
 				projectRoot: root,
-				stateStore,
-				stateStoreConfig
+				...doltReader !== void 0 && { doltReader },
+				...doltReaderConfig !== void 0 && { doltReaderConfig }
 			});
 			process.exitCode = exitCode;
 		} finally {
 			try {
-				await stateStore?.close();
+				await doltReader?.close();
 			} catch {}
 		}
 	});
 }
 
 //#endregion
-export { BMAD_BASELINE_TOKENS_FULL, DEFAULT_STALL_THRESHOLD_SECONDS, DoltMergeConflict, FileStateStore, STOP_AFTER_VALID_PHASES, STORY_KEY_PATTERN$1 as STORY_KEY_PATTERN, SUBSTRATE_OWNED_SETTINGS_KEYS, VALID_PHASES, __commonJS, __require, __toESM, buildPipelineStatusOutput, createDatabaseAdapter$1 as createDatabaseAdapter, createStateStore, findPackageRoot, formatOutput, formatPipelineStatusHuman, formatPipelineSummary, formatTokenTelemetry, getAllDescendantPids, getAutoHealthData, getSubstrateDefaultSettings, inspectProcessTree, isOrchestratorProcessLine, parseDbTimestampAsUtc, registerHealthCommand, resolveBmadMethodSrcPath, resolveBmadMethodVersion, runHealthAction, validateStoryKey };
-//# sourceMappingURL=health-C91xmseT.js.map
+export { BMAD_BASELINE_TOKENS_FULL, DEFAULT_STALL_THRESHOLD_SECONDS, DoltMergeConflict, FileStateStore, STOP_AFTER_VALID_PHASES, STORY_KEY_PATTERN$1 as STORY_KEY_PATTERN, SUBSTRATE_OWNED_SETTINGS_KEYS, VALID_PHASES, __commonJS, __require, __toESM, buildPipelineStatusOutput, createDatabaseAdapter$1 as createDatabaseAdapter, createDoltOperatorReader, createStateStore, findPackageRoot, formatOutput, formatPipelineStatusHuman, formatPipelineSummary, formatTokenTelemetry, getAllDescendantPids, getAutoHealthData, getSubstrateDefaultSettings, inspectProcessTree, isOrchestratorProcessLine, parseDbTimestampAsUtc, registerHealthCommand, resolveBmadMethodSrcPath, resolveBmadMethodVersion, runHealthAction, validateStoryKey };
+//# sourceMappingURL=health-dWYa13k4.js.map