@voltro/cli 0.52.0 → 0.53.0

package/dist/{dbCommand-sHedr-NJ.js → dbCommand-06O2finM.js}

@@ -6,21 +6,21 @@ import { a, i as o, n as s, t as c } from "./cliArgs-D4p8n7EE.js";
 import { r as l } from "./dialectDriver-czCHYpeH.js";
 import { a as u } from "./connectionConfig-Bk9IC7D0.js";
 import { i as d, n as f, r as p, s as m, t as h } from "./seedRunner-Dgsiwk_e.js";
-import { g, n as _, s as v } from "./frameworkTableAssembly-w-XnLa3q.js";
-import { b as y, x as b } from "./fileConventions-DOqD3lPS.js";
-import { r as x, t as S } from "./inspectGateHint-BjnFubmH.js";
+import { g, n as _, s as v } from "./frameworkTableAssembly-DKx3ba3S.js";
+import { S as y, x as b } from "./fileConventions-DASGEmj-.js";
+import { r as x, t as S } from "./inspectGateHint-4LxkNtrz.js";
 import { basename as ee, join as C, relative as w, resolve as T } from "node:path";
 import { promises as E, writeSync as te } from "node:fs";
 import { pathToFileURL as D } from "node:url";
-import { createLogger as O } from "@voltro/logger";
-import { actorsTable as k, branchNamespaceName as ne, decodeFieldValue as re, encodeFieldValue as ie, frameworkTables as ae, isEncrypted as A, isMigrationDefinition as oe, isRawEncoding as se, makeNamespaceBranchExecutor as ce, provisionBranch as le, quoteIdent as ue, registerCoreTables as de, resolveBranchMechanism as fe, teardownBranch as pe } from "@voltro/database";
+import { createLogger as O, logFormat as k } from "@voltro/logger";
+import { actorsTable as ne, branchNamespaceName as re, decodeFieldValue as ie, encodeFieldValue as ae, frameworkTables as oe, isEncrypted as A, isMigrationDefinition as se, isRawEncoding as ce, makeNamespaceBranchExecutor as le, provisionBranch as ue, quoteIdent as de, registerCoreTables as fe, resolveBranchMechanism as pe, teardownBranch as me } from "@voltro/database";
 import { Effect as j } from "effect";
 import { SqlClient as M } from "@effect/sql";
-import { DEFAULT_CDC_CHANNEL as me, applyPlan as he, applySchema as ge, assessRollingDeployGate as _e, branchRehearsalExitCode as ve, declaredSnapshot as ye, destructiveScope as be, fingerprintSchema as xe, formatBranchRehearsal as Se, ignoreTablesFromEnv as N, introspectSchema as P, pendingFileMigrationIds as Ce, planMigrations as F, recordUpToDate as we, rehearseMigrationOnBranch as Te, rollbackFileBasedMigration as Ee, rollingDeployUnsafeOps as De, runFileBasedMigrations as Oe, shortFingerprint as I, squashMigrationPlans as ke, unblockLossy as Ae } from "@voltro/database/sql";
-import { InMemoryDataStore as je, makeFieldCipher as Me } from "@voltro/runtime";
-import { createHash as Ne } from "node:crypto";
+import { DEFAULT_CDC_CHANNEL as he, applyPlan as ge, applySchema as _e, assessRollingDeployGate as ve, branchRehearsalExitCode as ye, declaredSnapshot as be, destructiveScope as xe, fingerprintSchema as Se, formatBranchRehearsal as Ce, ignoreTablesFromEnv as N, introspectSchema as P, pendingFileMigrationIds as we, planMigrations as F, recordUpToDate as Te, rehearseMigrationOnBranch as Ee, rollbackFileBasedMigration as De, rollingDeployUnsafeOps as Oe, runFileBasedMigrations as ke, shortFingerprint as I, squashMigrationPlans as Ae, unblockLossy as je } from "@voltro/database/sql";
+import { InMemoryDataStore as Me, makeFieldCipher as Ne } from "@voltro/runtime";
+import { createHash as Pe } from "node:crypto";
 //#region src/adoptPlan.ts
-var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
+var Fe = (e) => typeof e != "string", Ie = (e, t, n, r) => {
 	let i = [], a = new Map(t.map((e) => [e.name, e])), o = new Map(n.map((e) => [e.name, e])), s = new Set(e.leaveUnset ?? []);
 	r > 0 && i.push({
 		kind: "target-not-empty",
@@ -37,7 +37,7 @@ var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
 			});
 			continue;
 		}
-		if (Pe(n)) {
+		if (Fe(n)) {
 			c.push({
 				target: t,
 				source: n.expr,
@@ -80,23 +80,23 @@ var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
 		remintIds: f,
 		fatal: i.some((e) => e.fatal)
 	};
-}, Ie = (e, t) => [
+}, Le = (e, t) => [
 	`back up '${e.from}' to a restorable dump`,
 	`copy rows: INSERT INTO ${e.into} (${t.assignments.map((e) => e.target).join(", ")}) SELECT … FROM ${e.from}`,
 	...t.remintIds ? ["record old id → new id in a translation table", `rewrite every reference to '${e.from}', JSON columns included`] : [],
 	"verify: row counts match and a sample round-trips",
 	`drop '${e.from}' — LAST, and only after the verify`
-], Le = (e, t, n) => {
+], Re = (e, t, n) => {
 	let r = [`adopt · ${e.from} (${n} row(s)) → ${e.into}`, ""];
 	for (let e of t.assignments) r.push(`  ${e.target.padEnd(24)} ← ${e.raw ? `${e.source}   (raw)` : e.source}`);
 	t.problems.length > 0 && r.push("");
 	for (let e of t.problems) r.push(`  ${e.fatal ? "✗" : "⚠"} ${e.detail}`);
 	if (r.push(""), t.fatal) return r.push("  REFUSED — fix the problems above. Nothing was written."), r;
 	r.push("  would run, in this order:");
-	for (let [n, i] of Ie(e, t).entries()) r.push(`    ${n + 1}. ${i}`);
+	for (let [n, i] of Le(e, t).entries()) r.push(`    ${n + 1}. ${i}`);
 	return r;
-}, Re = (e) => e === "mysql" || e === "mariadb" ? (e) => `\`${e}\`` : e === "mssql" ? (e) => `[${e}]` : (e) => `"${e}"`, ze = (e) => `${e}__adopt_snapshot`, Be = (e, t, n, r, i) => {
-	let a = Re(n), o = ze(e.from), s = t.assignments.map((e) => e.target), c = t.assignments.map((e) => e.raw ? e.source : a(e.source));
+}, ze = (e) => e === "mysql" || e === "mariadb" ? (e) => `\`${e}\`` : e === "mssql" ? (e) => `[${e}]` : (e) => `"${e}"`, Be = (e) => `${e}__adopt_snapshot`, Ve = (e, t, n, r, i) => {
+	let a = ze(n), o = Be(e.from), s = t.assignments.map((e) => e.target), c = t.assignments.map((e) => e.raw ? e.source : a(e.source));
 	return i !== void 0 && (s.unshift(r), c.unshift(i)), {
 		snapshot: n === "mssql" ? `SELECT * INTO ${a(o)} FROM ${a(e.from)}` : `CREATE TABLE ${a(o)} AS SELECT * FROM ${a(e.from)}`,
 		copy: `INSERT INTO ${a(e.into)} (${s.map(a).join(", ")}) SELECT ${c.join(", ")} FROM ${a(e.from)}`,
@@ -106,18 +106,18 @@ var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
 		drop: `DROP TABLE ${a(e.from)}`,
 		dropSnapshot: `DROP TABLE ${a(o)}`
 	};
-}, Ve = (e) => {
+}, He = (e) => {
 	let t = e[0];
 	if (t === void 0) return 0;
 	let n = t.n ?? t.N ?? Object.values(t)[0];
 	return Number(n ?? 0);
-}, He = async (e, t, n, r, i, a, o = {}) => {
+}, Ue = async (e, t, n, r, i, a, o = {}) => {
 	if (t.fatal) throw Error("adopt: the plan was refused — nothing was run");
-	let s = Be(e, t, n, r, i), c = ze(e.from), l = Ve(await a(s.verifySource));
+	let s = Ve(e, t, n, r, i), c = Be(e.from), l = He(await a(s.verifySource));
 	await a(s.snapshot);
 	for (let e of s.translations) await a(e);
 	await a(s.copy);
-	let u = Ve(await a(s.verifyTarget));
+	let u = He(await a(s.verifyTarget));
 	return u === l ? o.keepSource === !0 ? {
 		copied: u,
 		sourceRows: l,
@@ -146,7 +146,7 @@ var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
 	"credential",
 	"privatekey",
 	"private_key"
-], Ue = [
+], We = [
 	{
 		table: "_voltro_audit_log",
 		column: "subject"
@@ -191,7 +191,7 @@ var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
 		table: "_voltro_row_history",
 		column: "subjectId"
 	}
-], We = (e, t) => {
+], Ge = (e, t) => {
 	switch (t) {
 		case "postgres": return `LOWER(CAST(${e} AS text))`;
 		case "mysql":
@@ -200,17 +200,17 @@ var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
 		case "sqlite":
 		case "turso": return `LOWER(CAST(${e} AS TEXT))`;
 	}
-}, Ge = (e, t, n = L) => n.map((n) => `${We(e, t)} LIKE '%${n}%'`).join("\n     OR "), Ke = ["_omitted", "__redacted"], qe = (e, t) => {
+}, Ke = (e, t, n = L) => n.map((n) => `${Ge(e, t)} LIKE '%${n}%'`).join("\n     OR "), qe = ["_omitted", "__redacted"], Je = (e, t) => {
 	let n = e.toLowerCase();
 	return t.some((e) => n.includes(e));
-}, Je = (e, t = []) => {
+}, Ye = (e, t = []) => {
 	if (Array.isArray(e)) {
-		for (let n of e) Je(n, t);
+		for (let n of e) Ye(n, t);
 		return t;
 	}
-	if (typeof e == "object" && e) for (let [n, r] of Object.entries(e)) t.push(n), Je(r, t);
+	if (typeof e == "object" && e) for (let [n, r] of Object.entries(e)) t.push(n), Ye(r, t);
 	return t;
-}, Ye = (e) => Array.isArray(e) ? e.map(Ye) : typeof e == "object" && e ? Object.fromEntries(Object.entries(e).map(([e, t]) => [e, Ke.includes(e) ? null : Ye(t)])) : e, Xe = (e, t = L) => {
+}, Xe = (e) => Array.isArray(e) ? e.map(Xe) : typeof e == "object" && e ? Object.fromEntries(Object.entries(e).map(([e, t]) => [e, qe.includes(e) ? null : Xe(t)])) : e, Ze = (e, t = L) => {
 	let n;
 	try {
 		n = JSON.parse(e);
@@ -222,11 +222,11 @@ var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
 		};
 	}
 	return {
-		asKey: Je(n).some((e) => qe(e, t)),
-		redactionMarkerOnly: !qe(JSON.stringify(Ye(n)) ?? "", t),
+		asKey: Ye(n).some((e) => Je(e, t)),
+		redactionMarkerOnly: !Je(JSON.stringify(Xe(n)) ?? "", t),
 		undecidable: !1
 	};
-}, Ze = (e) => ({
+}, Qe = (e) => ({
 	examined: e.length,
 	asKey: e.filter((e) => e.asKey).length,
 	redactionMarkerOnly: e.filter((e) => e.redactionMarkerOnly && !e.asKey).length,
@@ -234,21 +234,21 @@ var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
 }), R = (e) => {
 	let t = e.classification;
 	return t === void 0 || e.hits === void 0 || e.hits === 0 ? !1 : t.examined === e.hits && t.undecidable === 0 && t.asKey === 0 && t.redactionMarkerOnly === e.hits;
-}, Qe = (e, t, n, r) => {
-	let i = `WHERE ${Ge(t, n)}`, a = We(t, n).replace(/^LOWER\((.*)\)$/s, "$1");
+}, $e = (e, t, n, r) => {
+	let i = `WHERE ${Ke(t, n)}`, a = Ge(t, n).replace(/^LOWER\((.*)\)$/s, "$1");
 	return n === "mssql" ? `SELECT TOP (${r}) ${a} AS v FROM ${e}\n   ${i}` : `SELECT ${a} AS v FROM ${e}\n   ${i}\n   LIMIT ${r}`;
-}, $e = async (e, t, n, r, i) => (await j.runPromise(e.unsafe(Qe(t, n, r, i)))).map((e) => {
+}, et = async (e, t, n, r, i) => (await j.runPromise(e.unsafe($e(t, n, r, i)))).map((e) => {
 	let t = Object.values(e)[0];
 	return typeof t == "string" ? t : JSON.stringify(t ?? null);
-}), et = async (e, t) => {
+}), tt = async (e, t) => {
 	let n = await j.runPromise(e.unsafe(t));
 	return Number(Object.values(n[0] ?? { n: 0 })[0] ?? 0);
-}, tt = async (e, t, n, r) => {
+}, nt = async (e, t, n, r) => {
 	let i = [];
 	for (let a of n) {
 		let n = r(a.table), o;
 		try {
-			o = await et(e, `SELECT COUNT(*) AS n FROM ${n}`);
+			o = await tt(e, `SELECT COUNT(*) AS n FROM ${n}`);
 		} catch {
 			i.push({
 				table: a.table,
@@ -260,9 +260,9 @@ var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
 			continue;
 		}
 		try {
-			let s = await et(e, `SELECT COUNT(*) AS n FROM ${n}\n   WHERE ${Ge(r(a.column), t)}`), c = [];
+			let s = await tt(e, `SELECT COUNT(*) AS n FROM ${n}\n   WHERE ${Ke(r(a.column), t)}`), c = [];
 			if (s > 0) for (let i of L) try {
-				let o = await et(e, `SELECT COUNT(*) AS n FROM ${n}\n   WHERE ${Ge(r(a.column), t, [i])}`);
+				let o = await tt(e, `SELECT COUNT(*) AS n FROM ${n}\n   WHERE ${Ke(r(a.column), t, [i])}`);
 				o > 0 && c.push({
 					needle: i,
 					rows: o
@@ -270,7 +270,7 @@ var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
 			} catch {}
 			let l;
 			if (s > 0) try {
-				l = Ze((await $e(e, n, r(a.column), t, 500)).map((e) => Xe(e)));
+				l = Qe((await et(e, n, r(a.column), t, 500)).map((e) => Ze(e)));
 			} catch {}
 			i.push({
 				table: a.table,
@@ -291,7 +291,7 @@ var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
 		}
 	}
 	return i;
-}, nt = (e, t) => {
+}, rt = (e, t) => {
 	let n = L.length, r = [`credential scan · dialect ${t}`, ""], i = /* @__PURE__ */ new Set();
 	for (let t of e) {
 		if (t.unavailable === "column") {
@@ -309,11 +309,11 @@ var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
 		let e = R(t), n = (t.hits ?? 0) === 0 ? "✓" : e ? "~" : "✗";
 		r.push(`  ${n}  ${t.table}.${t.column} — ${t.hits} of ${t.scanned} row(s) contain a credential-shaped NAME (anywhere in the value)`), (t.matchedNeedles?.length ?? 0) > 0 && r.push(`         matched (rows per needle, may overlap): ${t.matchedNeedles.map((e) => `${e.needle} (${e.rows})`).join(", ")}`);
 		let a = t.classification;
-		a !== void 0 && (r.push(`         examined ${a.examined} of ${t.hits} matched row(s)${a.examined < (t.hits ?? 0) ? " (capped at 500)" : ""}: ${a.asKey} as a JSON KEY, ${a.redactionMarkerOnly} only inside a redaction marker${a.undecidable > 0 ? `, ${a.undecidable} not parseable as JSON` : ""}`), e && r.push(`         EXPLAINED — every match is \`${Ke.join("` / `")}\`, the framework's own`, "         record that a `.sensitive()` column was left OUT. Nothing to purge, nothing to rotate."));
+		a !== void 0 && (r.push(`         examined ${a.examined} of ${t.hits} matched row(s)${a.examined < (t.hits ?? 0) ? " (capped at 500)" : ""}: ${a.asKey} as a JSON KEY, ${a.redactionMarkerOnly} only inside a redaction marker${a.undecidable > 0 ? `, ${a.undecidable} not parseable as JSON` : ""}`), e && r.push(`         EXPLAINED — every match is \`${qe.join("` / `")}\`, the framework's own`, "         record that a `.sensitive()` column was left OUT. Nothing to purge, nothing to rotate."));
 	}
 	let a = e.reduce((e, t) => e + (R(t) ? 0 : t.hits ?? 0), 0), o = e.reduce((e, t) => e + (R(t) ? t.hits ?? 0 : 0), 0);
 	return r.push(""), o > 0 && r.push(`  ${o} row(s) matched only the framework's own redaction markers and are NOT findings.`), a > 0 ? r.push(`  ${a} row(s) carry something credential-shaped.`, "  Purge them AND rotate the credentials — assume anything written to a log", "  table has been read. Then stop putting the credential on the Subject:", "  `connectionCredentials(...)` keeps it in the framework vault.") : e.every((e) => e.scanned === void 0 || e.scanned === 0 || e.unavailable !== void 0) ? r.push("  NOTHING WAS SCANNED. This run proves nothing about your data.") : r.push("  No credential-shaped keys found in the rows that exist."), r.push("", `  These are NAME heuristics (${n} of them), not proof. A credential in a`, "  column whose key is not credential-shaped — `keyValue`, `pat`, `authz` —", "  is invisible here. A clean run means \"no credential-shaped NAME found\",", "  which is not the same as \"no credential\".", "", "  Run this on EVERY environment. A dev database is not a sample of production."), r.join("\n");
-}, rt = (e) => e.some((e) => (e.hits ?? 0) > 0 && !R(e)) ? 1 : e.every((e) => e.unavailable !== void 0 || e.scanned === void 0 || e.scanned === 0) ? 2 : 0, it = /\.migration\.ts$/, at = async (e, t) => {
+}, it = (e) => e.some((e) => (e.hits ?? 0) > 0 && !R(e)) ? 1 : e.every((e) => e.unavailable !== void 0 || e.scanned === void 0 || e.scanned === 0) ? 2 : 0, at = /\.migration\.ts$/, ot = async (e, t) => {
 	let n = [];
 	for (let r of e) {
 		let e;
@@ -323,7 +323,7 @@ var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
 			t.warn("migration: failed to import", { file: r }, e);
 			continue;
 		}
-		let i = (e.default && oe(e.default) ? e.default : void 0) ?? Object.values(e).find(oe);
+		let i = (e.default && se(e.default) ? e.default : void 0) ?? Object.values(e).find(se);
 		if (!i) {
 			t.warn("migration: no defineMigration export", { file: r });
 			continue;
@@ -333,7 +333,7 @@ var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
 			idInFile: i.id,
 			idFromFile: ee(r).replace(/\.migration\.ts$/, "")
 		});
-		let a = await E.readFile(r, "utf8").catch(() => ""), o = Ne("sha256").update(a).digest("hex").slice(0, 16);
+		let a = await E.readFile(r, "utf8").catch(() => ""), o = Pe("sha256").update(a).digest("hex").slice(0, 16);
 		n.push({
 			file: r,
 			definition: i,
@@ -341,10 +341,10 @@ var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
 		});
 	}
 	return [...n].sort((e, t) => e.definition.id < t.definition.id ? -1 : 1);
-}, ot = async (e) => {
+}, st = async (e) => {
 	let t = (process.env.DB_DIALECT ?? "postgres").toLowerCase(), n = t === "memory" ? "postgres" : t, r = n, i = t === "memory" ? void 0 : await l(n).then((e) => e.retryFilter, () => void 0);
-	return j.runPromise(ge(ae, r, void 0, i === void 0 ? {} : { retryFilter: i }).pipe(j.provide(e)));
-}, st = (e) => j.runPromise(j.gen(function* () {
+	return j.runPromise(_e(oe, r, void 0, i === void 0 ? {} : { retryFilter: i }).pipe(j.provide(e)));
+}, ct = (e) => j.runPromise(j.gen(function* () {
 	let e = yield* (yield* M.SqlClient)`SELECT id, status, hash, "appliedAt" FROM "_voltro_migrations"`.pipe(j.orElseSucceed(() => []));
 	return new Map(e.map((e) => [e.id, e]));
 }).pipe(j.provide(e))), z = (e, t) => j.runPromise(j.gen(function* () {
@@ -363,14 +363,14 @@ var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
           "errorStack"  = EXCLUDED."errorStack",
           "updatedAt"   = now()
       `;
-}).pipe(j.provide(e))), ct = async (e, t, n) => {
+}).pipe(j.provide(e))), lt = async (e, t, n) => {
 	if (e.length === 0) return {
 		applied: [],
 		failed: null,
 		skipped: []
 	};
-	await ot(t);
-	let r = await st(t), i = [], a = [], o = null;
+	await st(t);
+	let r = await ct(t), i = [], a = [], o = null;
 	for (let s of e) {
 		let e = r.get(s.definition.id);
 		if (e && e.status === "applied") {
@@ -471,9 +471,9 @@ var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
 		failed: o,
 		skipped: a
 	};
-}, lt = async (e, t, n, r = {}) => {
-	await ot(t);
-	let i = await st(t), a = e.filter((e) => i.get(e.definition.id)?.status === "applied");
+}, ut = async (e, t, n, r = {}) => {
+	await st(t);
+	let i = await ct(t), a = e.filter((e) => i.get(e.definition.id)?.status === "applied");
 	if (a.length === 0) return n.info("migration: nothing to roll back"), {
 		applied: [],
 		failed: null,
@@ -542,9 +542,9 @@ var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
 		failed: c,
 		skipped: []
 	};
-}, ut = async (e, t) => {
-	await ot(t);
-	let n = await st(t);
+}, dt = async (e, t) => {
+	await st(t);
+	let n = await ct(t);
 	return e.map((e) => {
 		let t = n.get(e.definition.id);
 		return t ? {
@@ -561,7 +561,7 @@ var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
 			hashMatches: !0
 		};
 	});
-}, dt = (e) => {
+}, ft = (e) => {
 	if (!e.failed) return "";
 	let t = e.failed, n = [
 		`✗ Migration failed: ${t.migrationId} / step '${t.error?.stepName ?? "?"}'`,
@@ -574,22 +574,22 @@ var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
 		""
 	];
 	return e.applied.length > 0 && n.unshift("", `(${e.applied.length} migration(s) applied successfully before the failure.)`), n.join("\n");
-}, ft = (e) => {
+}, pt = (e) => {
 	let t = e.split(".");
 	if (t.length !== 2 || !t[0] || !t[1]) throw Error(`voltro db encrypt-column: expected <table>.<column>, got "${e}"`);
 	return {
 		table: t[0],
 		column: t[1]
 	};
-}, pt = (e) => 49 + 4 * Math.ceil(e / 3), mt = (e, t) => {
-	let n = pt(e);
+}, mt = (e) => 49 + 4 * Math.ceil(e / 3), ht = (e, t) => {
+	let n = mt(e);
 	return {
 		longestPlaintextBytes: e,
 		longestCiphertext: n,
 		declaredMaxLength: t,
 		fits: t === void 0 || n <= t
 	};
-}, ht = (e, t) => `${e.table}.${e.column} is too narrow: its longest value encodes to ${t.longestPlaintextBytes} byte(s), which encrypts to ${t.longestCiphertext} characters, and the column is declared as ${t.declaredMaxLength}. Widen it first (\`.maxLength(${t.longestCiphertext})\` or more, then \`voltro db apply\`) and run this again. Nothing was written.`, gt = (e, t) => {
+}, gt = (e, t) => `${e.table}.${e.column} is too narrow: its longest value encodes to ${t.longestPlaintextBytes} byte(s), which encrypts to ${t.longestCiphertext} characters, and the column is declared as ${t.declaredMaxLength}. Widen it first (\`.maxLength(${t.longestCiphertext})\` or more, then \`voltro db apply\`) and run this again. Nothing was written.`, _t = (e, t) => {
 	let n = t ? "would encrypt" : "encrypted";
 	return [
 		`  ${e.table}.${e.column}`,
@@ -599,25 +599,25 @@ var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
 		`    null / empty       ${e.empty}`,
 		`    ${n.padEnd(18)} ${e.encrypted}`
 	].join("\n");
-}, _t = (e, t, n) => {
+}, vt = (e, t, n) => {
 	if (e == null) return;
 	let r = typeof e == "string" ? e : String(e);
 	if (r === "" || A(r)) return;
-	let i = ie(t, r), a;
+	let i = ae(t, r), a;
 	try {
-		a = re(t, i);
+		a = ie(t, i);
 	} catch (e) {
 		throw Error(`${n.table}.${n.column}: the value could not be read back the way the app reads it (${e.message ?? String(e)}). Nothing was written.`);
 	}
 	if (a !== r) throw Error(`${n.table}.${n.column}: round-trip mismatch — reading the encrypted value back did not return what it was given. Nothing was written.`);
 	return i;
-}, vt = (e) => Buffer.byteLength(e, "utf8"), yt = (e) => vt(JSON.stringify(typeof e == "string" ? e : String(e))), bt = (e, t) => {
+}, yt = (e) => Buffer.byteLength(e, "utf8"), bt = (e) => yt(JSON.stringify(typeof e == "string" ? e : String(e))), xt = (e, t) => {
 	if (e !== void 0) try {
 		return t.decrypt(e), !0;
 	} catch {
 		return !1;
 	}
-}, xt = (e, t) => `${e.table}.${e.column} already holds values encrypted with a DIFFERENT key than ${t} — the active key cannot decrypt them. Continuing would encrypt the remaining rows under a second key, and the column would then be readable with neither key alone. Nothing was written. Point ${t} at the key the existing rows were written with.`, St = (e) => [
+}, St = (e, t) => `${e.table}.${e.column} already holds values encrypted with a DIFFERENT key than ${t} — the active key cannot decrypt them. Continuing would encrypt the remaining rows under a second key, and the column would then be readable with neither key alone. Nothing was written. Point ${t} at the key the existing rows were written with.`, Ct = (e) => [
 	"",
 	"  NEXT — this converted the rows that exist. New writes are still plaintext",
 	"  until the column carries the modifier:",
@@ -627,25 +627,25 @@ var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
 	"  Order does not matter: a read returns a non-ciphertext value unchanged, so",
 	"  the column may hold a mix while you deploy. Run this again afterwards to",
 	"  catch anything written in between — it skips what is already encrypted."
-].join("\n"), Ct = (e, t, n) => {
+].join("\n"), wt = (e, t, n) => {
 	if (typeof e != "string" || !A(e)) return;
 	let r;
 	try {
-		r = se(t, e);
+		r = ce(t, e);
 	} catch {
 		return;
 	}
 	if (r !== !0) return;
-	let i = re(t, e);
+	let i = ie(t, e);
 	if (typeof i != "string") return;
-	let a = ie(t, i);
-	if (re(t, a) !== i) throw Error(`${n.table}.${n.column}: re-encoding did not round-trip. Nothing was written.`);
+	let a = ae(t, i);
+	if (ie(t, a) !== i) throw Error(`${n.table}.${n.column}: re-encoding did not round-trip. Nothing was written.`);
 	return a;
-}, wt = (e, t, n) => e === "sqlite" ? `SELECT NULL AS n FROM pragma_table_info('${t.table}') WHERE name = '${t.column}'` : `SELECT character_maximum_length AS n FROM information_schema.columns\n   WHERE ${n} AND table_name = '${t.table}' AND column_name = '${t.column}'`, Tt = (e) => {
+}, Tt = (e, t, n) => e === "sqlite" ? `SELECT NULL AS n FROM pragma_table_info('${t.table}') WHERE name = '${t.column}'` : `SELECT character_maximum_length AS n FROM information_schema.columns\n   WHERE ${n} AND table_name = '${t.table}' AND column_name = '${t.column}'`, Et = (e) => {
 	if (e == null) return;
 	let t = Number(e);
 	return Number.isFinite(t) && t >= 0 ? t : void 0;
-}, B = O({ scope: "voltro:db" }), Et = /* @__PURE__ */ new Set([
+}, B = O({ scope: "voltro:db" }), Dt = /* @__PURE__ */ new Set([
 	"node_modules",
 	"dist",
 	"build",
@@ -657,13 +657,13 @@ var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
 	let n = [], r = async (e) => {
 		let i = await E.readdir(e, { withFileTypes: !0 }).catch(() => []);
 		for (let a of i) {
-			if (Et.has(a.name)) continue;
+			if (Dt.has(a.name)) continue;
 			let i = C(e, a.name);
 			a.isDirectory() ? await r(i) : a.isFile() && t.test(a.name) && n.push(i);
 		}
 	};
 	return await r(e), n;
-}, Dt = [
+}, Ot = [
 	"--against",
 	"--batch",
 	"--before",
@@ -682,23 +682,23 @@ var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
 	"--store",
 	"--to",
 	"--token"
-], H = (e) => T(c(e, Dt) ?? process.cwd()), U = () => u("migration"), Ot = (e) => {
+], H = (e) => T(c(e, Ot) ?? process.cwd()), U = () => u("migration"), kt = (e) => {
 	let t = e;
 	if (typeof t != "object" || !t) return !1;
 	if (t.code === "ERR_OUT_OF_RANGE" || t.cause?.code === "ERR_OUT_OF_RANGE") return !0;
 	let n = `${t.message ?? ""} ${t.cause?.message ?? ""} ${t.stack ?? ""}`;
 	return /ERR_OUT_OF_RANGE|out of range/i.test(n) && /pg-protocol|parseDataRow|buffer-reader|BufferReader/i.test(n);
-}, kt = "Live-DB introspection got a corrupt / misaligned response from the database. This happens when `voltro db plan` / `apply` / `drift` / `migrate` runs through a connection POOLER (Supabase Supavisor / PgBouncer) on a LARGE schema — the pooler mis-frames a big catalog response. The introspection already batches by table to keep responses small; if a batch still trips it:\n  1. Lower the batch: set `VOLTRO_INTROSPECT_BATCH` to a smaller number of tables (default 20 — try 5 or 1). This keeps `db plan` on the normal pooler, no direct connection needed.\n  2. Or use a DIRECT (non-pooler) connection: set `DB_DIRECT_URL` (or `DB_MIGRATE_URL`) to the direct database URL — the runtime keeps `DB_URL`, so only the migration path is affected. (Supabase: direct = `db.<project-ref>.supabase.co` [IPv6-only on newer projects]; pooler = `aws-0-<region>.pooler.supabase.com`.)", W = () => {
+}, At = "Live-DB introspection got a corrupt / misaligned response from the database. This happens when `voltro db plan` / `apply` / `drift` / `migrate` runs through a connection POOLER (Supabase Supavisor / PgBouncer) on a LARGE schema — the pooler mis-frames a big catalog response. The introspection already batches by table to keep responses small; if a batch still trips it:\n  1. Lower the batch: set `VOLTRO_INTROSPECT_BATCH` to a smaller number of tables (default 20 — try 5 or 1). This keeps `db plan` on the normal pooler, no direct connection needed.\n  2. Or use a DIRECT (non-pooler) connection: set `DB_DIRECT_URL` (or `DB_MIGRATE_URL`) to the direct database URL — the runtime keeps `DB_URL`, so only the migration path is affected. (Supabase: direct = `db.<project-ref>.supabase.co` [IPv6-only on newer projects]; pooler = `aws-0-<region>.pooler.supabase.com`.)", W = () => {
 	let e = (process.env.DB_DIALECT ?? "postgres").toLowerCase();
 	if (e === "memory") throw new r("voltro db: subcommands require a real dialect, not DB_DIALECT=memory.");
 	return e;
-}, G = (e) => ue(e, W()), K = (e) => e === "mysql" || e === "mariadb" ? "table_schema = DATABASE()" : e === "mssql" ? "table_schema = SCHEMA_NAME()" : "table_schema = 'public'", q = async () => (await l(W())).makeSqlLayer(U()), At = async (e) => {
-	let t = H(e), n = e.includes("--dry-run"), r = await at(await V(t, it), B);
+}, G = (e) => de(e, W()), K = (e) => e === "mysql" || e === "mariadb" ? "table_schema = DATABASE()" : e === "mssql" ? "table_schema = SCHEMA_NAME()" : "table_schema = 'public'", q = async () => (await l(W())).makeSqlLayer(U()), jt = async (e) => {
+	let t = H(e), n = e.includes("--dry-run"), r = await ot(await V(t, at), B);
 	if (r.length === 0) return B.info("no migrations found", { root: t }), 0;
 	if (n) {
 		let e = /* @__PURE__ */ new Set();
 		try {
-			let t = await ut(r, await q());
+			let t = await dt(r, await q());
 			e = new Set(t.filter((e) => e.status === "applied").map((e) => e.id));
 		} catch {
 			B.warn("migrate --dry-run: could not read the migration ledger — showing ALL as pending");
@@ -709,29 +709,29 @@ var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
 		for (let e of t) console.log(`  pending  ${e.definition.id}`);
 		return 0;
 	}
-	let i = await ct(r, await q(), B);
-	return i.failed ? (process.stderr.write(dt(i) + "\n"), 1) : (B.info("migrate complete", {
+	let i = await lt(r, await q(), B);
+	return i.failed ? (process.stderr.write(ft(i) + "\n"), 1) : (B.info("migrate complete", {
 		applied: i.applied.length,
 		skipped: i.skipped.length
 	}), 0);
-}, jt = async (e) => {
-	let t = H(e), n = s(e, "--to"), r = await at(await V(t, it), B);
-	if (r.length === 0) return B.info("no migrations found", { root: t }), 0;
-	let i = await lt(r, await q(), B, n ? { to: n } : {});
-	return i.failed ? (process.stderr.write(dt(i) + "\n"), 1) : (B.info("rollback complete", { reverted: i.applied.length }), 0);
 }, Mt = async (e) => {
-	let t = await at(await V(H(e), it), B);
+	let t = H(e), n = s(e, "--to"), r = await ot(await V(t, at), B);
+	if (r.length === 0) return B.info("no migrations found", { root: t }), 0;
+	let i = await ut(r, await q(), B, n ? { to: n } : {});
+	return i.failed ? (process.stderr.write(ft(i) + "\n"), 1) : (B.info("rollback complete", { reverted: i.applied.length }), 0);
+}, Nt = async (e) => {
+	let t = await ot(await V(H(e), at), B);
 	if (t.length === 0) return console.log("no migrations found"), 0;
-	let n = await ut(t, await q());
+	let n = await dt(t, await q());
 	for (let e of n) {
 		let t = e.status === "applied" ? "✓" : e.status === "failed" ? "✗" : e.status === "reverted" ? "↩" : "·", n = e.hashMatches ? "" : " (hash drift!)", r = e.appliedAt ? ` @ ${e.appliedAt.toISOString()}` : "";
 		console.log(`  ${t} ${e.id}  [${e.status}]  ${e.name}${r}${n}`);
 	}
 	return 0;
-}, Nt = async (e) => {
+}, Pt = async (e) => {
 	let t = (s(e, "--store") ?? process.env.DB_DIALECT ?? "postgres").toLowerCase();
 	if (t === "memory") return B.warn("voltro db seed: using in-memory store (explicit opt-in via --store memory / DB_DIALECT=memory)"), B.warn("  rows written by this run will NOT persist beyond the process. set DB_DIALECT=postgres or unset to seed the real DB."), {
-		store: new je(),
+		store: new Me(),
 		dispose: async () => {},
 		dialectId: "memory"
 	};
@@ -748,10 +748,10 @@ var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
 		},
 		dialectId: n.id
 	};
-}, Pt = async (e) => {
-	let t = H(e), n = s(e, "--id"), r = s(e, "--lifecycle"), i = await V(t, b), a = await f(i, B);
+}, Ft = async (e) => {
+	let t = H(e), n = s(e, "--id"), r = s(e, "--lifecycle"), i = await V(t, y), a = await f(i, B);
 	if (a.length === 0) return B.info("no seeds found", { root: t }), 0;
-	let { store: o, dispose: c, dialectId: l } = await Nt(e);
+	let { store: o, dispose: c, dialectId: l } = await Pt(e);
 	try {
 		if (n) return +((await d(a, n, o, B)).status === "failed");
 		let e = r ? a.filter((e) => e.definition.lifecycle === r) : a.filter((e) => e.definition.lifecycle === "boot");
@@ -767,8 +767,8 @@ var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
 			B.warn("voltro db seed: store dispose failed", { error: String(e) });
 		});
 	}
-}, Ft = (e) => typeof e == "object" && !!e && "tableName" in e && "fields" in e && typeof e.tableName == "string", It = async (e) => {
-	let t = await V(e, y), n = [];
+}, It = (e) => typeof e == "object" && !!e && "tableName" in e && "fields" in e && typeof e.tableName == "string", Lt = async (e) => {
+	let t = await V(e, b), n = [];
 	for (let r of t) {
 		let t;
 		try {
@@ -780,31 +780,31 @@ var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
 			});
 			continue;
 		}
-		for (let e of Object.values(t)) Ft(e) && n.push(e);
+		for (let e of Object.values(t)) It(e) && n.push(e);
 	}
 	return n;
-}, Lt = (e) => {
+}, Rt = (e) => {
 	let t = new Map(e.map((e) => [e.tableName, e]));
-	t.has("actors") || t.set("actors", k);
+	t.has("actors") || t.set("actors", ne);
 	let n = t.get("actors"), r = t.get("tenants");
-	return de({
+	return fe({
 		actors: () => n,
 		...r === void 0 ? {} : { tenants: () => r }
 	}), [...t.values()];
-}, Rt = (e) => {
+}, zt = (e) => {
 	let t = /* @__PURE__ */ new Map();
 	for (let n of e) {
 		let e = n.tableName;
 		e !== void 0 && !t.has(e) && t.set(e, n);
 	}
 	return [...t.values()];
-}, zt = (e) => {
-	let t = be(process.env.VOLTRO_DESTRUCTIVE_OK);
+}, Bt = (e) => {
+	let t = xe(process.env.VOLTRO_DESTRUCTIVE_OK);
 	if (t === void 0 || !e.operations.filter((e) => e.blocked).every((e) => e.classification === "lossy")) return {
 		plan: e,
 		acknowledged: !1
 	};
-	let n = Ae(e, t);
+	let n = je(e, t);
 	return {
 		plan: n,
 		acknowledged: !n.operations.some((e) => e.blocked)
@@ -814,13 +814,13 @@ var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
 		return await J(e, M.SqlClient.pipe(j.flatMap(P)));
 	} catch (e) {
 		let t = String(e?.message ?? e);
-		if (Ot(e) || /connection error/i.test(t)) {
-			let n = /* @__PURE__ */ Error(`${kt}\n\nOriginal error: ${t}`);
+		if (kt(e) || /connection error/i.test(t)) {
+			let n = /* @__PURE__ */ Error(`${At}\n\nOriginal error: ${t}`);
 			throw n.cause = e, n;
 		}
 		throw e;
 	}
-}, Bt = {
+}, Vt = {
 	safe: "\x1B[32m✓\x1B[0m",
 	"needs-default": "\x1B[32m⊕\x1B[0m",
 	"needs-backfill": "\x1B[33m⊕\x1B[0m",
@@ -828,7 +828,7 @@ var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
 	lossy: "\x1B[31m✗\x1B[0m",
 	"online-required": "\x1B[36m◷\x1B[0m",
 	"multi-step": "\x1B[35m⇉\x1B[0m"
-}, Vt = (e) => {
+}, Ht = (e) => {
 	let t = e.op, n;
 	switch (t.kind) {
 		case "create-table":
@@ -890,9 +890,9 @@ var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
 			break;
 		case "drop-check": n = `ALTER TABLE ${t.table} DROP CHECK ${t.column}`;
 	}
-	let r = Bt[e.classification], i = e.reason ? `  # ${e.reason}` : "", a = e.blocked ? `\n    ! ${e.blocked.fix}` : "";
+	let r = Vt[e.classification], i = e.reason ? `  # ${e.reason}` : "", a = e.blocked ? `\n    ! ${e.blocked.fix}` : "";
 	return `  ${r} ${n}${i}${a}`;
-}, Ht = async (e, t) => {
+}, Ut = async (e, t) => {
 	let n = e.operations.filter((e) => e.classification === "needs-default" && e.op.kind === "add-column");
 	if (n.length === 0) return;
 	let r = [];
@@ -901,7 +901,7 @@ var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
 		if (i === void 0 || a === void 0) continue;
 		let o = 0;
 		try {
-			let e = await J(t, M.SqlClient.pipe(j.flatMap((e) => e.unsafe(`SELECT COUNT(*) AS n FROM ${ue(i, W())}`))));
+			let e = await J(t, M.SqlClient.pipe(j.flatMap((e) => e.unsafe(`SELECT COUNT(*) AS n FROM ${de(i, W())}`))));
 			o = Number(Object.values(e[0] ?? { n: 0 })[0] ?? 0);
 		} catch {
 			continue;
@@ -913,9 +913,9 @@ var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
 		for (let e of r) console.log(e);
 		console.log("  (the shape is correct either way — this is the VALUE a state diff cannot know)");
 	}
-}, Ut = async (e, t) => {
+}, Wt = async (e, t) => {
 	if (W() !== "postgres") return;
-	let n = me, r;
+	let n = he, r;
 	try {
 		r = await J(t, M.SqlClient.pipe(j.flatMap((t) => m(t, e, n))));
 	} catch {
@@ -933,39 +933,65 @@ var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
 	});
 }, X = (e) => {
 	let t = e.summary, n = e.operations.length;
+	if (k() === "json") {
+		B.info(`schema diff: ${n} operation${n === 1 ? "" : "s"}, ${t.blocked} blocked${n === 0 ? " — schema is up to date" : ""}`, {
+			operations: n,
+			blocked: t.blocked,
+			safe: t.safe,
+			needsDefault: t.needsDefault,
+			needsBackfill: t.needsBackfill,
+			rename: t.needsRenameAnnotation,
+			lossy: t.lossy,
+			ops: e.operations.map((e) => Ht(e).trim()),
+			fingerprintLive: e.fromFingerprint.slice(0, 16),
+			fingerprintDeclared: e.toFingerprint.slice(0, 16)
+		}), Gt(e);
+		return;
+	}
 	if (console.log(`\nschema diff: ${n} operation${n === 1 ? "" : "s"}, ${t.blocked} blocked\n`), n === 0) {
 		console.log("  (schema is up to date)\n");
 		return;
 	}
-	for (let t of e.operations) console.log(Vt(t));
-	console.log(), console.log(`  safe: ${t.safe}   needs-default: ${t.needsDefault}   needs-backfill: ${t.needsBackfill}`), console.log(`  rename: ${t.needsRenameAnnotation}   lossy: ${t.lossy}   blocked: ${t.blocked}`), console.log(`  fingerprint: live ${e.fromFingerprint.slice(0, 16)} · declared ${e.toFingerprint.slice(0, 16)}`), console.log("  (measured differently — a live hash never equals a declared one. The plan above is"), console.log("   what says whether they agree; these two are not meant to match.)\n"), Wt(e);
-}, Wt = (e) => {
-	let t = De(e.operations);
+	for (let t of e.operations) console.log(Ht(t));
+	console.log(), console.log(`  safe: ${t.safe}   needs-default: ${t.needsDefault}   needs-backfill: ${t.needsBackfill}`), console.log(`  rename: ${t.needsRenameAnnotation}   lossy: ${t.lossy}   blocked: ${t.blocked}`), console.log(`  fingerprint: live ${e.fromFingerprint.slice(0, 16)} · declared ${e.toFingerprint.slice(0, 16)}`), console.log("  (measured differently — a live hash never equals a declared one. The plan above is"), console.log("   what says whether they agree; these two are not meant to match.)\n"), Gt(e);
+}, Gt = (e) => {
+	let t = Oe(e.operations);
 	if (t.length !== 0) {
+		if (k() === "json") {
+			B.warn(`${t.length} operation(s) UNSAFE under a rolling deploy — old code breaks against the new schema`, {
+				unsafe: t.map((e) => ({
+					kind: e.op.op.kind,
+					reason: e.reason,
+					remedy: e.remedy
+				})),
+				hint: "deploy with a maintenance window / scale-to-zero, or split expand → deploy → contract (docs: deployment/production-hardening)"
+			});
+			return;
+		}
 		console.log(`  ⚠ ${t.length} operation(s) UNSAFE under a rolling deploy`), console.log("    (old + new instances overlap → old code breaks against the new schema):");
 		for (let e of t) console.log(`      • ${e.op.op.kind}: ${e.reason}`), console.log(`        → ${e.remedy}`);
 		console.log("    Deploy with a maintenance window / scale-to-zero, or split into"), console.log("    expand → deploy → contract. See docs: deployment/production-hardening.\n");
 	}
-}, Gt = (e, t) => {
-	let n = _e({
+}, Kt = (e, t) => {
+	let n = ve({
 		enabled: process.env.VOLTRO_ROLLING_DEPLOY === "1",
 		forced: t.includes("--force"),
-		unsafeCount: De(e.operations).length
+		unsafeCount: Oe(e.operations).length
 	});
 	return n.refuse ? (B.error(`db apply: ${n.message}`), !0) : (n.warnForced && B.warn(`db apply: ${n.message}`), !1);
-}, Kt = (e) => {
+}, qt = (e) => {
 	let t = s(e, "--online-after") ?? process.env.VOLTRO_ONLINE_THRESHOLD;
 	if (t === void 0) return;
 	let n = Number(t);
 	if (!Number.isInteger(n) || n < 0) throw Error(`--online-after / VOLTRO_ONLINE_THRESHOLD must be a non-negative integer, got "${t}"`);
 	return n;
 }, Z = async (e) => {
-	let t = await It(e);
+	let t = await Lt(e);
 	if (t.length === 0) return;
 	let n = await _({ root: e });
-	return Lt(Rt([
+	return Rt(zt([
 		...t,
-		...ae,
+		...oe,
 		...n
 	]));
 }, Q = async (e, t, n) => {
@@ -978,20 +1004,20 @@ var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
 	} catch (e) {
 		r = e;
 	}
-	return await Ut(t, n), r === void 0 ? 0 : (B.error("db apply: a plugin migration FAILED — the schema was applied, the plugin steps were not", { error: r instanceof Error ? r.message : String(r) }), 1);
-}, qt = async (e, t) => {
-	let n = { close: async () => {} }, r = await V(e, b);
+	return await Wt(t, n), r === void 0 ? 0 : (B.error("db apply: a plugin migration FAILED — the schema was applied, the plugin steps were not", { error: r instanceof Error ? r.message : String(r) }), 1);
+}, Jt = async (e, t) => {
+	let n = { close: async () => {} }, r = await V(e, y);
 	if (r.length === 0) return n;
 	let i = await f(r, B), a = i.filter((e) => e.definition.lifecycle === "onSchemaChange");
 	if (a.length === 0) return n;
-	let { store: o, dispose: s } = await Nt(t), c = h(i, o, B.child("seeds"));
+	let { store: o, dispose: s } = await Pt(t), c = h(i, o, B.child("seeds"));
 	return B.info(`db apply: ${a.length} onSchemaChange seed(s) armed for this apply`, { ids: a.map((e) => e.definition.id) }), { close: async () => {
 		c(), await s().catch((e) => {
 			B.warn("db apply: seed store dispose failed", { error: String(e) });
 		});
 	} };
-}, Jt = async (e) => {
-	let t = Kt(e), n = H(e), r = await Z(n);
+}, Yt = async (e) => {
+	let t = qt(e), n = H(e), r = await Z(n);
 	if (r === void 0) return B.warn("db plan: no schema files found", {
 		root: n,
 		hint: "looked for *.entity.ts / *.schema.ts / schema.ts"
@@ -1025,7 +1051,7 @@ var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
 		...t === void 0 ? {} : { onlineAfter: t }
 	});
 	return e.includes("--json") ? (te(1, `${JSON.stringify(o, null, 2)}\n`), o.summary.blocked > 0 ? 2 : 0) : (X(o), o.summary.blocked > 0 ? 2 : 0);
-}, $ = n, Yt = async (e, t, n) => {
+}, $ = n, Xt = async (e, t, n) => {
 	let r;
 	try {
 		let t = await E.readFile(T(e), "utf8");
@@ -1036,21 +1062,33 @@ var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
 	if (!Array.isArray(r?.operations) || typeof r?.fromFingerprint != "string" || typeof r?.toFingerprint != "string") return B.error(`db apply --plan: '${e}' is not a valid plan file (expected the output of \`voltro db plan --json\`).`), 1;
 	let i = await Z(n);
 	if (i === void 0) return B.warn("db apply --plan: no schema files found", { root: n }), 1;
-	let a = await q(), o = await J(a, M.SqlClient.pipe(j.flatMap((e) => Ce(e, n)))).catch(() => []);
-	if (o.length > 0) return B.error(`db apply --plan: refusing — ${o.length} pending file-based migration(s).`), console.error(`  ${o.join("\n  ")}`), console.error(""), console.error("  These perform the changes a state diff cannot infer, so they change the shape"), console.error("  this plan was computed against. Apply them and regenerate the plan:"), console.error(""), console.error("    voltro db files ."), console.error("    voltro db plan --json > plan.json"), console.error("    voltro db apply --plan plan.json"), 1;
+	let a = await q(), o = await J(a, M.SqlClient.pipe(j.flatMap((e) => we(e, n)))).catch(() => []);
+	if (o.length > 0) return B.error(`db apply --plan: refusing — ${o.length} pending file-based migration(s).`, {
+		pending: o,
+		why: "file migrations perform changes a state diff cannot infer, so they change the shape this plan was computed against",
+		fix: "voltro db files . && voltro db plan --json > plan.json && voltro db apply --plan plan.json"
+	}), 1;
 	let c = await Y(a), l = F({
 		declared: i,
 		live: c,
 		dialect: W(),
 		...N()
 	});
-	if (l.fromFingerprint !== r.fromFingerprint) return B.error("db apply --plan: refusing — the live schema has drifted since this plan was generated."), console.error(`  plan.from=${r.fromFingerprint.slice(0, 16)}  live=${l.fromFingerprint.slice(0, 16)}`), console.error("  Regenerate against the current live schema: `voltro db plan --json > plan.json`"), 2;
-	if (l.toFingerprint !== r.toFingerprint) return B.error("db apply --plan: refusing — the declared schema differs from what this plan targets."), console.error(`  plan.to=${r.toFingerprint.slice(0, 16)}  declared=${l.toFingerprint.slice(0, 16)}`), console.error("  The schema files changed since the plan was generated. Regenerate the plan."), 2;
-	let u = zt(l), d = u.plan;
+	if (l.fromFingerprint !== r.fromFingerprint) return B.error("db apply --plan: refusing — the live schema has drifted since this plan was generated.", {
+		planFrom: r.fromFingerprint.slice(0, 16),
+		live: l.fromFingerprint.slice(0, 16),
+		fix: "regenerate against the current live schema: voltro db plan --json > plan.json"
+	}), 2;
+	if (l.toFingerprint !== r.toFingerprint) return B.error("db apply --plan: refusing — the declared schema differs from what this plan targets.", {
+		planTo: r.toFingerprint.slice(0, 16),
+		declared: l.toFingerprint.slice(0, 16),
+		fix: "the schema files changed since the plan was generated — regenerate the plan"
+	}), 2;
+	let u = Bt(l), d = u.plan;
 	if (d.summary.blocked > 0 && !u.acknowledged) return X(d), B.error(`db apply --plan: refusing — ${l.summary.blocked} blocked operation(s). See the fix hints above.`), process.env.VOLTRO_DESTRUCTIVE_OK !== void 0 && (B.error("  VOLTRO_DESTRUCTIVE_OK is set but did not cover this plan — it only relaxes"), B.error("  `lossy` operations, and only the tables it names. Anything else stays refused.")), 2;
-	if (u.acknowledged && B.warn("db apply --plan: proceeding with acknowledged lossy operation(s) (VOLTRO_DESTRUCTIVE_OK)"), Gt(d, t)) return 2;
+	if (u.acknowledged && B.warn("db apply --plan: proceeding with acknowledged lossy operation(s) (VOLTRO_DESTRUCTIVE_OK)"), Kt(d, t)) return 2;
 	if (d.operations.length === 0) {
-		let e = await J(a, M.SqlClient.pipe(j.flatMap((e) => we(e, d, {
+		let e = await J(a, M.SqlClient.pipe(j.flatMap((e) => Te(e, d, {
 			appliedBy: process.env.USER ? `cli:${process.env.USER}` : "cli:plan",
 			environment: $(),
 			source: "file"
@@ -1058,7 +1096,7 @@ var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
 		return B.info(e === "recorded" ? `db apply --plan: schema is up to date — no DDL to apply, recorded fingerprint=${d.toFingerprint.slice(0, 16)} (change triggers are reconciled separately below)` : "db apply --plan: schema is up to date — no DDL to apply (change triggers are reconciled separately below)"), Q(n, i, a);
 	}
 	X(d);
-	let f = s(t, "--note"), p = await J(a, M.SqlClient.pipe(j.flatMap((e) => he(e, d, {
+	let f = s(t, "--note"), p = await J(a, M.SqlClient.pipe(j.flatMap((e) => ge(e, d, {
 		declared: i,
 		appliedBy: process.env.USER ? `cli:${process.env.USER}` : "cli:plan",
 		environment: $(),
@@ -1075,21 +1113,24 @@ var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
 		id: p.id,
 		fingerprint: p.fingerprint.slice(0, 16)
 	}), Q(n, i, a);
-}, Xt = async (e) => {
-	let t = H(e), n = await qt(t, e);
+}, Zt = async (e) => {
+	let t = H(e), n = await Jt(t, e);
 	try {
-		return await Zt(e, t);
+		return await Qt(e, t);
 	} finally {
 		await n.close();
 	}
-}, Zt = async (e, n) => {
-	let r = Kt(e), i = s(e, "--plan");
-	if (i) return Yt(i, e, n);
-	if ((process.env.NODE_ENV ?? "").toLowerCase() === "production") return B.error(`voltro db apply: refusing — auto-apply on prod is not allowed.${t()}`), console.error("In production, schema changes go through `voltro db plan --json > plan.json`"), console.error("then `voltro db apply --plan plan.json` as an explicit step in your deploy pipeline."), 3;
+}, Qt = async (e, n) => {
+	let r = qt(e), i = s(e, "--plan");
+	if (i) return Xt(i, e, n);
+	if ((process.env.NODE_ENV ?? "").toLowerCase() === "production") return B.error(`voltro db apply: refusing — auto-apply on prod is not allowed.${t()}`, { fix: "in production, schema changes go through `voltro db plan --json > plan.json`, then `voltro db apply --plan plan.json` as an explicit deploy step" }), 3;
 	let a = await Z(n);
 	if (a === void 0) return B.warn("db apply: no schema files found", { root: n }), 1;
-	let o = await q(), c = await mn(n, o);
-	if ("failed" in c) return B.error("db apply: a file-based migration FAILED — the schema diff was NOT run"), console.error(c.failed), console.error("Fix the migration and re-run. `voltro db files` runs them alone."), 1;
+	let o = await q(), c = await hn(n, o);
+	if ("failed" in c) return B.error("db apply: a file-based migration FAILED — the schema diff was NOT run", {
+		failed: c.failed,
+		fix: "fix the migration and re-run; `voltro db files` runs them alone"
+	}), 1;
 	let l = await Y(o), u = F({
 		declared: a,
 		live: l,
@@ -1097,20 +1138,20 @@ var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
 		...N(),
 		...r === void 0 ? {} : { onlineAfter: r }
 	});
-	X(u), await Ht(u, o);
-	let d = zt(u), f = d.plan;
+	X(u), await Ut(u, o);
+	let d = Bt(u), f = d.plan;
 	if (f.summary.blocked > 0 && !d.acknowledged) return B.error(`db apply: refusing — ${f.summary.blocked} blocked operation(s). See the fix hints above.`), process.env.VOLTRO_DESTRUCTIVE_OK !== void 0 && (B.error("  VOLTRO_DESTRUCTIVE_OK is set but did not cover this plan — it only relaxes"), B.error("  `lossy` operations, and only the tables it names. Anything else stays refused.")), 2;
-	if (d.acknowledged && B.warn(`db apply: proceeding with ${u.summary.blocked} acknowledged lossy operation(s) (VOLTRO_DESTRUCTIVE_OK)`), Gt(f, e)) return 2;
+	if (d.acknowledged && B.warn(`db apply: proceeding with ${u.summary.blocked} acknowledged lossy operation(s) (VOLTRO_DESTRUCTIVE_OK)`), Kt(f, e)) return 2;
 	if (f.operations.length === 0) {
 		B.info("db apply: schema is up to date — no DDL to apply (change triggers are reconciled separately below)");
-		let t = await J(o, M.SqlClient.pipe(j.flatMap((e) => we(e, f, {
+		let t = await J(o, M.SqlClient.pipe(j.flatMap((e) => Te(e, f, {
 			appliedBy: process.env.USER ? `cli:${process.env.USER}` : "cli:apply",
 			environment: $(),
 			source: "auto-diff"
 		}))));
-		return t === "recorded" && B.info(`db apply: recorded fingerprint=${f.toFingerprint.slice(0, 16)} (0 operations)`), await ln(o), s(e, "--note") !== void 0 && t !== "recorded" && (B.warn("db apply: --note was ignored — this schema is already the latest recorded one, so there is no new history row to attach it to."), console.error("To record that the CURRENT live schema is the accepted baseline, use `voltro db drift --accept`.")), Q(n, a, o);
+		return t === "recorded" && B.info(`db apply: recorded fingerprint=${f.toFingerprint.slice(0, 16)} (0 operations)`), await un(o), s(e, "--note") !== void 0 && t !== "recorded" && B.warn("db apply: --note was ignored — this schema is already the latest recorded one, so there is no new history row to attach it to.", { hint: "to record the CURRENT live schema as the accepted baseline, use `voltro db drift --accept`" }), Q(n, a, o);
 	}
-	let p = s(e, "--note"), m = await J(o, M.SqlClient.pipe(j.flatMap((e) => he(e, f, {
+	let p = s(e, "--note"), m = await J(o, M.SqlClient.pipe(j.flatMap((e) => ge(e, f, {
 		declared: a,
 		appliedBy: process.env.USER ? `cli:${process.env.USER}` : "cli:user",
 		environment: $(),
@@ -1128,7 +1169,7 @@ var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
 		id: m.id,
 		fingerprint: m.fingerprint.slice(0, 16)
 	}), Q(n, a, o);
-}, Qt = (e) => {
+}, $t = (e) => {
 	let t = [];
 	for (let n of e.tables) for (let e of n.columns) {
 		let r = e.references;
@@ -1141,7 +1182,7 @@ var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
 		});
 	}
 	return t;
-}, $t = (e) => {
+}, en = (e) => {
 	let t = [];
 	for (let n of e.tables) for (let e of n.indexes) e.expression !== !0 && e.name !== `${n.name}_pkey` && e.columns.length !== 0 && t.push({
 		table: n.name,
@@ -1150,7 +1191,7 @@ var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
 		name: e.name
 	});
 	return t;
-}, en = (e, t) => {
+}, tn = (e, t) => {
 	let n = (e) => JSON.stringify(e.op), r = new Set(e.operations.map(n)), i = new Set(t.operations.map(n)), a = [...t.operations.filter((e) => !r.has(n(e))), ...e.operations.filter((e) => !i.has(n(e)))];
 	return {
 		...t,
@@ -1160,24 +1201,24 @@ var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
 			blocked: 0
 		}
 	};
-}, tn = (e) => {
+}, nn = (e) => {
 	if (e === void 0) return "empty";
 	if (e === "empty" || e === "copy") return e;
 	throw e === "fresh" ? new r("voltro db branch: --seed fresh is not implemented — the branch lifecycle has no executor step that runs boot seeds, so the branch would come up EMPTY while this reported it as seeded. Use --seed copy (the parent's rows) or --seed empty (schema only).") : new r(`voltro db branch: --seed must be one of empty|copy, got "${e}"`);
-}, nn = (e) => {
+}, rn = (e) => {
 	if (e !== void 0) {
 		if (e === "namespace" || e === "neon-cow") return e;
 		throw new r(`voltro db branch: --prefer must be one of namespace|neon-cow, got "${e}"`);
 	}
-}, rn = async (e) => {
-	let t = H(e), n = tn(s(e, "--seed")), i = nn(s(e, "--prefer")), a = e.includes("--keep"), o = e.includes("--json"), c = Kt(e), u = W();
+}, an = async (e) => {
+	let t = H(e), n = nn(s(e, "--seed")), i = rn(s(e, "--prefer")), a = e.includes("--keep"), o = e.includes("--json"), c = qt(e), u = W();
 	if (u !== "postgres") return B.error(`voltro db branch: not supported on '${u}'.`), console.error("  The branch PLAN is dialect-agnostic; the shipped namespace EXECUTOR is Postgres-only"), console.error("  (CREATE SCHEMA / CREATE TABLE … LIKE … INCLUDING ALL / \"-quoted identifiers)."), console.error("  MySQL, MariaDB, SQLite and SQL Server need their own BranchExecutor — see"), console.error("  makeNamespaceBranchExecutor in @voltro/database."), 1;
 	let d = await Z(t);
 	if (d === void 0) return B.warn("db branch: no schema files found", {
 		root: t,
 		hint: "looked for *.entity.ts / *.schema.ts / schema.ts"
 	}), 1;
-	let f = U(), p = fe({
+	let f = U(), p = pe({
 		seed: n,
 		...f.url === void 0 ? {} : { dbUrl: f.url },
 		...i === void 0 ? {} : { prefer: i }
@@ -1185,7 +1226,7 @@ var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
 	if (p === "neon-cow") return B.error("voltro db branch: this connection resolves to the Neon copy-on-write mechanism, which the CLI cannot execute."), console.error("  A Neon CoW branch is a single call to Neon's branch REST API and needs a Neon API token;"), console.error("  the framework ships the PLAN, and the cloud control plane executes it."), console.error("  Re-run with `--prefer namespace` to rehearse on a schema-per-branch copy instead"), console.error(`  (portable, no vendor API — it copies ${n === "copy" ? "every row" : "the schema only"}).`), 1;
 	let m = f.schema ?? "public", h = s(e, "--name") ?? ee(t), g = s(e, "--pr"), _ = g === void 0 ? 0 : Number(g);
 	if (!Number.isInteger(_) || _ < 0) throw new r(`voltro db branch: --pr must be a non-negative integer, got "${String(g)}"`);
-	let v = ne(h, _), y = await l(u), b = y.makeSqlLayer(f), x = y.makeSqlLayer({
+	let v = re(h, _), y = await l(u), b = y.makeSqlLayer(f), x = y.makeSqlLayer({
 		...f,
 		schema: v
 	}), S = await Y(b), C = F({
@@ -1194,13 +1235,13 @@ var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
 		dialect: u,
 		...N(),
 		...c === void 0 ? {} : { onlineAfter: c }
-	}), w = S.tables.map((e) => e.name), T = Qt(S), E = $t(S), D = ce({ run: (e) => J(b, M.SqlClient.pipe(j.flatMap((t) => t.unsafe(e)), j.asVoid)) }), O = async () => F({
+	}), w = S.tables.map((e) => e.name), T = $t(S), E = en(S), D = le({ run: (e) => J(b, M.SqlClient.pipe(j.flatMap((t) => t.unsafe(e)), j.asVoid)) }), O = async () => F({
 		declared: d,
 		live: await Y(x),
 		dialect: u,
 		...N(),
 		...c === void 0 ? {} : { onlineAfter: c }
-	}), k = await Te({
+	}), k = await Ee({
 		branchId: v,
 		mechanism: p,
 		branchedTables: w.length,
@@ -1210,7 +1251,7 @@ var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
 			o || B.info(`db branch: ${e}`);
 		},
 		provision: async () => {
-			await le({
+			await ue({
 				appSlug: h,
 				prNumber: _,
 				seed: n,
@@ -1222,10 +1263,10 @@ var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
 				...f.url === void 0 ? {} : { dbUrl: f.url }
 			}, D);
 		},
-		fidelityPlan: async () => en(C, await O()),
+		fidelityPlan: async () => tn(C, await O()),
 		plan: O,
 		apply: async (e) => {
-			await J(x, M.SqlClient.pipe(j.flatMap((t) => he(t, e, {
+			await J(x, M.SqlClient.pipe(j.flatMap((t) => ge(t, e, {
 				declared: d,
 				appliedBy: "cli:db-branch",
 				environment: $(),
@@ -1236,11 +1277,11 @@ var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
 		},
 		replan: async () => await O(),
 		teardown: async () => {
-			await pe(v, "namespace", D);
+			await me(v, "namespace", D);
 		}
 	});
-	return o ? te(1, `${JSON.stringify(k, null, 2)}\n`) : console.log(`\n${Se(k)}\n`), ve(k);
-}, an = async (e) => {
+	return o ? te(1, `${JSON.stringify(k, null, 2)}\n`) : console.log(`\n${Ce(k)}\n`), ye(k);
+}, on = async (e) => {
 	let t = Math.max(1, Number(s(e, "--limit") ?? "20")), n = await J(await q(), M.SqlClient.pipe(j.flatMap((e) => e`
         SELECT ${e("id")}, ${e("fingerprint")}, ${e("operations")},
                ${e("appliedBy")}, ${e("environment")}, ${e("source")},
@@ -1254,12 +1295,12 @@ var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
 	for (let e of n) {
 		let t = 0;
 		try {
-			t = JSON.parse(un(e.operations)).length;
+			t = JSON.parse(dn(e.operations)).length;
 		} catch {}
-		console.log(`  ${e.id}  fp=${I(e.fingerprint)}  env=${e.environment}  src=${e.source}  ${t} op(s)  ${e.durationMs}ms  ${dn(e.appliedAt)}  by=${e.appliedBy}`), e.notes && console.log(`    [2mnote: ${e.notes}[0m`);
+		console.log(`  ${e.id}  fp=${I(e.fingerprint)}  env=${e.environment}  src=${e.source}  ${t} op(s)  ${e.durationMs}ms  ${fn(e.appliedAt)}  by=${e.appliedBy}`), e.notes && console.log(`    [2mnote: ${e.notes}[0m`);
 	}
 	return console.log(), 0;
-}, on = async (e) => {
+}, sn = async (e) => {
 	let t = e[0];
 	if (!t) return console.error("voltro db restore-snapshot <plan-id>"), console.error("  Renames soft-dropped columns/tables from a plan back to their original names."), console.error("  Requires the plan to have been applied with VOLTRO_SOFT_DROP=1."), 2;
 	let n = await q(), r = await J(n, M.SqlClient.pipe(j.flatMap((e) => e`SELECT ${e("id")}, ${e("operations")}
@@ -1267,7 +1308,7 @@ var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
 	if (r.length === 0) return console.error(`restore-snapshot: plan '${t}' not found`), 1;
 	let i;
 	try {
-		i = JSON.parse(un(r[0].operations));
+		i = JSON.parse(dn(r[0].operations));
 	} catch {
 		return console.error(`restore-snapshot: plan '${t}' has corrupted operations JSON`), 1;
 	}
@@ -1311,7 +1352,7 @@ var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
 		await J(n, M.SqlClient.pipe(j.flatMap((t) => t.unsafe(`ALTER TABLE ${G(r)} RENAME TO ${G(e.table)}`)))), c++, console.log(`  ↩ restored table ${e.table} (from ${r})`);
 	}
 	return console.log(`\n✓ restored ${s} column(s) + ${c} table(s) from plan '${t}'\n`), 0;
-}, sn = async (e) => {
+}, cn = async (e) => {
 	let t = s(e, "--before");
 	if (!t) return console.error("voltro db gc-snapshots --before <date> [--dry-run]"), console.error("  Permanently drops soft-dropped columns/tables (<name>__dropped_<ts>) older than <date>."), console.error("  <date> is ISO — e.g. 2026-01-01 or 2026-01-01T00:00:00Z. NOT reversible."), 2;
 	let n = t.replace(/[^0-9]/g, "");
@@ -1335,16 +1376,16 @@ var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
 		t === null || t >= r || (console.log(`  ${i ? "[dry-run] would drop table" : "dropping table"} ${e.table_name}`), i || await J(a, M.SqlClient.pipe(j.flatMap((t) => t.unsafe(`DROP TABLE ${G(e.table_name)}`)))), u++);
 	}
 	return console.log(`\n${i ? `[dry-run] ${u} snapshot(s) would be dropped` : `✓ dropped ${u} snapshot(s)`} (older than ${r}).\n`), 0;
-}, cn = async (e) => {
+}, ln = async (e) => {
 	let t = s(e, "--before");
 	if (!t) return console.error("voltro db squash --before <iso-date> [--note \"<text>\"]"), 2;
 	let n = t;
 	if (Number.isNaN(new Date(n).getTime())) return console.error(`voltro db squash: --before '${n}' is not a valid ISO date`), 2;
 	let r = s(e, "--note"), i = H(e), a = await Z(i);
 	if (a === void 0) return B.warn("db squash: no schema files found", { root: i }), 1;
-	let o = xe(ye(a)), c = await q();
+	let o = Se(be(a)), c = await q();
 	try {
-		let e = await J(c, ke({
+		let e = await J(c, Ae({
 			before: n,
 			fingerprint: o,
 			appliedBy: process.env.USER ?? "cli",
@@ -1355,9 +1396,9 @@ var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
 	} catch (e) {
 		return console.error(`squash refused: ${e.message}`), 1;
 	}
-}, ln = async (e) => {
+}, un = async (e) => {
 	try {
-		let t = await Y(e), n = xe(t);
+		let t = await Y(e), n = Se(t);
 		await J(e, M.SqlClient.pipe(j.flatMap((e) => e`
           UPDATE ${e("_voltro_migration_plans")}
           SET ${e("liveFingerprint")} = ${n}
@@ -1370,7 +1411,7 @@ var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
             AND ${e("liveFingerprint")} IS NULL
         `)));
 	} catch {}
-}, un = (e) => typeof e == "string" ? e : e == null ? "" : JSON.stringify(e), dn = (e) => e instanceof Date ? e.toISOString() : String(e ?? ""), fn = (e) => e === void 0 ? {
+}, dn = (e) => typeof e == "string" ? e : e == null ? "" : JSON.stringify(e), fn = (e) => e instanceof Date ? e.toISOString() : String(e ?? ""), pn = (e) => e === void 0 ? {
 	accept: !1,
 	reason: "no-declared-schema"
 } : e > 0 ? {
@@ -1379,15 +1420,15 @@ var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
 } : {
 	accept: !0,
 	reason: "converged"
-}, pn = async (e) => {
+}, mn = async (e) => {
 	let t = e.includes("--accept"), n = await q(), r = await J(n, M.SqlClient.pipe(j.flatMap((e) => e`
         SELECT * FROM ${e("_voltro_migration_plans")}
         ORDER BY ${e("appliedAt")} DESC
         LIMIT 1
-      `))), i = await Y(n), a = xe(i);
+      `))), i = await Y(n), a = Se(i);
 	if (r.length === 0) return B.info("db drift: no _voltro_migration_plans rows yet"), console.log(`live user-schema fingerprint: ${I(a)}`), console.log("No baseline to compare against. Run `voltro db apply` to lock in the current state."), 0;
 	let o = r[0];
-	if (o.liveFingerprint === null || o.liveFingerprint === void 0) return B.warn("db drift: no drift baseline recorded yet — cannot compare"), console.log(), console.log(`  last applied:  ${o.id}  at ${dn(o.appliedAt)}`), console.log(`  live now:      ${I(a)}`), console.log(), console.log("That row was written before the framework recorded a live-schema baseline,"), console.log("and the value it does carry is the DECLARED snapshot's hash — not comparable"), console.log("with a live one. Run `voltro db apply` once to establish the baseline (a no-op"), console.log("apply backfills it too); use `voltro db plan` meanwhile, which compares declared"), console.log("against live directly."), console.log(), console.log("Exit code 3 — NOT 0. \"Did not compare\" is not \"clean\", and a gate on the exit"), console.log("code has to be able to tell them apart."), 3;
+	if (o.liveFingerprint === null || o.liveFingerprint === void 0) return B.warn("db drift: no drift baseline recorded yet — cannot compare"), console.log(), console.log(`  last applied:  ${o.id}  at ${fn(o.appliedAt)}`), console.log(`  live now:      ${I(a)}`), console.log(), console.log("That row was written before the framework recorded a live-schema baseline,"), console.log("and the value it does carry is the DECLARED snapshot's hash — not comparable"), console.log("with a live one. Run `voltro db apply` once to establish the baseline (a no-op"), console.log("apply backfills it too); use `voltro db plan` meanwhile, which compares declared"), console.log("against live directly."), console.log(), console.log("Exit code 3 — NOT 0. \"Did not compare\" is not \"clean\", and a gate on the exit"), console.log("code has to be able to tell them apart."), 3;
 	if (o.liveFingerprint === a) return B.info(`db drift: live matches last applied (${I(a)})`), 0;
 	let s = await (async () => {
 		try {
@@ -1403,7 +1444,7 @@ var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
 		}
 	})();
 	if (t) {
-		let e = fn(s?.length);
+		let e = pn(s?.length);
 		if (e.reason === "no-declared-schema") return B.error("db drift --accept: no schema files found — cannot verify the live schema is current."), 1;
 		if (!e.accept && s !== void 0) {
 			B.error(`db drift --accept: refusing — ${s.length} operation(s) still pending against your declared schema.`), console.log();
@@ -1421,11 +1462,11 @@ var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
           )
         `))), B.info(`db drift: accepted the live schema as the baseline (${I(a)})`), console.log(), console.log("`voltro db plan` reports 0 operations against this schema, so the live state already"), console.log("matches your declaration — only the ledger did not know. It does now."), console.log(), console.log("No history entry was invented: the latest row's baseline was updated in place,"), console.log("because no migration ran."), 0;
 	}
-	return B.error("db drift: live schema DIVERGED from last applied state"), console.log(), console.log(`  baseline:      ${I(o.liveFingerprint)}  at ${dn(o.appliedAt)}  (${o.id})`), console.log(`  live now:      ${I(a)}`), console.log(), console.log("Something changed the live schema after the last apply. This command can see"), console.log("THAT it changed, not what or who — the fingerprints are hashes, not a diff."), console.log(), s === void 0 ? (console.log("No schema files found here, so the declared side could not be compared."), console.log("Run `voltro db plan` from your project root for the actual difference."), 4) : s.length === 0 ? (console.log("Your DECLARED schema is already satisfied — `voltro db plan` reports 0 operations"), console.log("against this database. So the live schema is not wrong, only unrecorded: something"), console.log("applied a change without going through the planner (a hand-run ALTER, a DBA"), console.log("window, a restored dump), or it touched a table your code does not declare."), console.log(), console.log("If that was deliberate and the schema is right, record it:"), console.log(), console.log("    voltro db drift --accept"), console.log(), console.log("It updates the latest ledger row's baseline to the live schema and invents no"), console.log("history entry. Drift then measures from here."), 4) : (console.log(`\`voltro db plan\` reports ${s.length} operation(s) still pending against your`), console.log("declared schema, so this is not merely an unrecorded change — run it for the diff,"), console.log("then `voltro db apply`, which writes a fresh baseline of its own."), 4);
-}, mn = async (e, t) => {
+	return B.error("db drift: live schema DIVERGED from last applied state"), console.log(), console.log(`  baseline:      ${I(o.liveFingerprint)}  at ${fn(o.appliedAt)}  (${o.id})`), console.log(`  live now:      ${I(a)}`), console.log(), console.log("Something changed the live schema after the last apply. This command can see"), console.log("THAT it changed, not what or who — the fingerprints are hashes, not a diff."), console.log(), s === void 0 ? (console.log("No schema files found here, so the declared side could not be compared."), console.log("Run `voltro db plan` from your project root for the actual difference."), 4) : s.length === 0 ? (console.log("Your DECLARED schema is already satisfied — `voltro db plan` reports 0 operations"), console.log("against this database. So the live schema is not wrong, only unrecorded: something"), console.log("applied a change without going through the planner (a hand-run ALTER, a DBA"), console.log("window, a restored dump), or it touched a table your code does not declare."), console.log(), console.log("If that was deliberate and the schema is right, record it:"), console.log(), console.log("    voltro db drift --accept"), console.log(), console.log("It updates the latest ledger row's baseline to the live schema and invents no"), console.log("history entry. Drift then measures from here."), 4) : (console.log(`\`voltro db plan\` reports ${s.length} operation(s) still pending against your`), console.log("declared schema, so this is not merely an unrecorded change — run it for the diff,"), console.log("then `voltro db apply`, which writes a fresh baseline of its own."), 4);
+}, hn = async (e, t) => {
 	let n = $();
 	try {
-		let r = await J(t, M.SqlClient.pipe(j.flatMap((t) => Oe(t, {
+		let r = await J(t, M.SqlClient.pipe(j.flatMap((t) => ke(t, {
 			projectRoot: e,
 			env: n,
 			appliedBy: process.env.USER ? `cli:${process.env.USER}` : "cli:user"
@@ -1434,10 +1475,10 @@ var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
 	} catch (e) {
 		return { failed: e };
 	}
-}, hn = async (e) => {
+}, gn = async (e) => {
 	let t = H(e), n = await q(), r = $();
-	await J(n, ge(ae, W(), void 0, { retryFilter: (await l(W())).retryFilter }));
-	let i = await J(n, M.SqlClient.pipe(j.flatMap((e) => Oe(e, {
+	await J(n, _e(oe, W(), void 0, { retryFilter: (await l(W())).retryFilter }));
+	let i = await J(n, M.SqlClient.pipe(j.flatMap((e) => ke(e, {
 		projectRoot: t,
 		env: r,
 		appliedBy: process.env.USER ? `cli:${process.env.USER}` : "cli:user"
@@ -1446,16 +1487,16 @@ var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
 		applied: i.applied.map((e) => `${e.id} (${e.durationMs}ms)`),
 		skipped: i.skipped.length
 	}), 0);
-}, gn = async (e) => {
-	let n = H(e), r = c(e, Dt);
+}, _n = async (e) => {
+	let n = H(e), r = c(e, Ot);
 	if (!r) return B.error("voltro db rollback-file <migration-id>"), 2;
 	if ((process.env.NODE_ENV ?? "").toLowerCase() === "production") return B.error("voltro db rollback-file: refusing on prod — schema rollback runs as an explicit deploy step." + t()), 3;
-	let i = await J(await q(), M.SqlClient.pipe(j.flatMap((e) => Ee(e, {
+	let i = await J(await q(), M.SqlClient.pipe(j.flatMap((e) => De(e, {
 		projectRoot: n,
 		id: r
 	}))));
 	return B.info(`db rollback-file: rolled back ${i.id} in ${i.durationMs}ms`), 0;
-}, _n = () => {
+}, vn = () => {
 	let e = /* @__PURE__ */ new Date();
 	return [
 		e.getUTCFullYear(),
@@ -1465,7 +1506,7 @@ var Pe = (e) => typeof e != "string", Fe = (e, t, n, r) => {
 		String(e.getUTCMinutes()).padStart(2, "0"),
 		String(e.getUTCSeconds()).padStart(2, "0")
 	].join("");
-}, vn = (e) => e.trim().toLowerCase().replace(/[^a-z0-9]+/g, "_").replace(/^_+|_+$/g, "") || "migration", yn = (e, t) => `import { defineMigration, SqlClient } from '@voltro/database'
+}, yn = (e) => e.trim().toLowerCase().replace(/[^a-z0-9]+/g, "_").replace(/^_+|_+$/g, "") || "migration", bn = (e, t) => `import { defineMigration, SqlClient } from '@voltro/database'
 import { Effect } from 'effect'
 
 // A hand-written migration. Reach for this when the DECLARATIVE differ can't
@@ -1497,25 +1538,25 @@ export default defineMigration({
     }),
   ],
 })
-`, bn = {
-	plan: Jt,
-	apply: Xt,
-	branch: rn,
-	plans: an,
-	drift: pn,
-	files: hn,
-	"rollback-file": gn,
-	migrate: At,
-	rollback: jt,
-	status: Mt,
-	seed: Pt,
+`, xn = {
+	plan: Yt,
+	apply: Zt,
+	branch: an,
+	plans: on,
+	drift: mn,
+	files: gn,
+	"rollback-file": _n,
+	migrate: jt,
+	rollback: Mt,
+	status: Nt,
+	seed: Ft,
 	generate: async (e) => {
-		let { value: t, rest: n } = a(e, "--root"), { value: r, rest: i } = a(n, "--name"), o = t ? T(t) : process.cwd(), s = vn(r ?? c(i, []) ?? "migration"), l = `${_n()}_${s}`, u = C(o, "migrations"), d = C(u, `${l}.migration.ts`);
-		return await E.mkdir(u, { recursive: !0 }), await E.writeFile(d, yn(l, s), "utf8"), B.info(`created ${w(o, d)}`), console.error("Fill in the apply/undo steps, then run `voltro db migrate` (rollback with `voltro db rollback`)."), console.error("For a plain schema shape change you may not need this — `voltro db apply` diffs declared vs live."), 0;
+		let { value: t, rest: n } = a(e, "--root"), { value: r, rest: i } = a(n, "--name"), o = t ? T(t) : process.cwd(), s = yn(r ?? c(i, []) ?? "migration"), l = `${vn()}_${s}`, u = C(o, "migrations"), d = C(u, `${l}.migration.ts`);
+		return await E.mkdir(u, { recursive: !0 }), await E.writeFile(d, bn(l, s), "utf8"), B.info(`created ${w(o, d)}`), console.error("Fill in the apply/undo steps, then run `voltro db migrate` (rollback with `voltro db rollback`)."), console.error("For a plain schema shape change you may not need this — `voltro db apply` diffs declared vs live."), 0;
 	},
-	squash: cn,
-	"restore-snapshot": on,
-	"gc-snapshots": sn,
+	squash: ln,
+	"restore-snapshot": sn,
+	"gc-snapshots": cn,
 	adopt: async (e) => {
 		let t = (t) => {
 			let n = e.indexOf(`--${t}`);
@@ -1536,11 +1577,11 @@ export default defineMigration({
 		})), f = d(n), p = d(r);
 		if (f === void 0) return console.error(`voltro db adopt: '${n}' does not exist in the database`), 1;
 		if (p === void 0) return console.error(`voltro db adopt: '${r}' does not exist in the database — boot once so the plugin's table is created`), 1;
-		let m = async (e) => await J(l, M.SqlClient.pipe(j.flatMap((t) => t.unsafe(e)))), h = async (e) => Number(Object.values((await m(`SELECT COUNT(*) AS n FROM "${e}"`))[0] ?? { n: 0 })[0] ?? 0), g = Fe(s, f, p, await h(r));
-		for (let e of Le(s, g, await h(n))) console.log(e);
+		let m = async (e) => await J(l, M.SqlClient.pipe(j.flatMap((t) => t.unsafe(e)))), h = async (e) => Number(Object.values((await m(`SELECT COUNT(*) AS n FROM "${e}"`))[0] ?? { n: 0 })[0] ?? 0), g = Ie(s, f, p, await h(r));
+		for (let e of Re(s, g, await h(n))) console.log(e);
 		if (g.fatal) return 1;
 		if (!e.includes("--apply")) return console.log(""), console.log("  (dry run — nothing written. Re-run with --apply.)"), 0;
-		let _ = await He(s, g, c, "id", void 0, m, { keepSource: e.includes("--keep-source") });
+		let _ = await Ue(s, g, c, "id", void 0, m, { keepSource: e.includes("--keep-source") });
 		return console.log(""), console.log(`  copied ${_.copied}/${_.sourceRows} row(s)`), console.log(`  snapshot: ${_.snapshotTable}  — restore from here, then drop it yourself`), _.verified ? (console.log(_.sourceDropped ? `  dropped ${n}` : `  ${n} left in place (--keep-source)`), 0) : (console.error("  ✗ counts DIFFER — the source was NOT dropped. Compare the two tables before doing anything else."), 1);
 	},
 	"scan-credentials": async (e) => {
@@ -1555,8 +1596,8 @@ export default defineMigration({
 				column: o
 			});
 		}
-		let i = [...Ue, ...n], a = await J(await q(), M.SqlClient.pipe(j.flatMap((e) => j.promise(() => tt(e, t, i, G)))));
-		return console.log(nt(a, t)), rt(a);
+		let i = [...We, ...n], a = await J(await q(), M.SqlClient.pipe(j.flatMap((e) => j.promise(() => nt(e, t, i, G)))));
+		return console.log(rt(a, t)), it(a);
 	},
 	"encrypt-column": async (e) => {
 		let t = W(), n = e.includes("--dry-run"), i = e.includes("--yes"), a = (t) => {
@@ -1564,20 +1605,20 @@ export default defineMigration({
 			return n >= 0 ? e[n + 1] : void 0;
 		}, s = Math.max(1, Number(a("--batch") ?? 500)), c = a("--key-env") ?? "FIELD_ENCRYPTION_KEY", l = process.env[c];
 		if (!l) throw new r(`voltro db encrypt-column: ${c} is not set. It must be the SAME key your app runs with (\`governancePlugin({ fieldEncryption: { key } })\`) — encrypting with a different one produces rows the app cannot read. Use --key-env to name a different variable.`);
-		let u = Me(l), d = o(e, Dt).filter((e) => e.includes(".")).map(ft);
+		let u = Ne(l), d = o(e, Ot).filter((e) => e.includes(".")).map(pt);
 		if (d.length === 0) throw new r("voltro db encrypt-column: name at least one <table>.<column>");
 		let f = await q(), p = [];
 		for (let e of d) {
 			let a = G(e.table), o = G(e.column), l = await J(f, M.SqlClient.pipe(j.flatMap((n) => j.promise(async () => {
-				let i = await j.runPromise(n.unsafe(wt(t, e, K(t))));
+				let i = await j.runPromise(n.unsafe(Tt(t, e, K(t))));
 				if (i.length === 0) throw new r(`voltro db encrypt-column: ${e.table}.${e.column} does not exist on this database`);
-				return Tt(Object.values(i[0])[0]);
+				return Et(Object.values(i[0])[0]);
 			})))), d = await J(f, M.SqlClient.pipe(j.flatMap((e) => j.promise(async () => await j.runPromise(e.unsafe(`SELECT ${G("id")} AS id, ${o} AS v FROM ${a}`)))))), m = 0;
-			for (let e of d) typeof e.v != "string" || A(e.v) || (m = Math.max(m, yt(e.v)));
-			let h = mt(m, l);
-			if (!h.fits) return console.error(`  ✗ ${ht(e, h)}`), 1;
-			if (bt(d.map((e) => e.v).find((e) => typeof e == "string" && A(e)), u) === !1) return console.error(`  ✗ ${xt(e, c)}`), 1;
-			let g = d.filter((t) => _t(t.v, u, e) !== void 0 || Ct(t.v, u, e) !== void 0).length;
+			for (let e of d) typeof e.v != "string" || A(e.v) || (m = Math.max(m, bt(e.v)));
+			let h = ht(m, l);
+			if (!h.fits) return console.error(`  ✗ ${gt(e, h)}`), 1;
+			if (xt(d.map((e) => e.v).find((e) => typeof e == "string" && A(e)), u) === !1) return console.error(`  ✗ ${St(e, c)}`), 1;
+			let g = d.filter((t) => vt(t.v, u, e) !== void 0 || wt(t.v, u, e) !== void 0).length;
 			if (!n && !i) return console.error(`  ✗ ${e.table}.${e.column}: ${g} row(s) would be rewritten in place. Re-run with --yes, or --dry-run to see the counts without writing.`), 1;
 			let _ = 0, v = 0, y = 0, b = 0, x = [];
 			for (let t of d) {
@@ -1586,7 +1627,7 @@ export default defineMigration({
 					continue;
 				}
 				if (typeof t.v == "string" && A(t.v)) {
-					let n = Ct(t.v, u, e);
+					let n = wt(t.v, u, e);
 					if (n === void 0) {
 						_ += 1;
 						continue;
@@ -1597,7 +1638,7 @@ export default defineMigration({
 					}), v += 1;
 					continue;
 				}
-				let n = _t(t.v, u, e);
+				let n = vt(t.v, u, e);
 				if (n === void 0) {
 					y += 1;
 					continue;
@@ -1624,21 +1665,21 @@ export default defineMigration({
 			});
 		}
 		console.log(`field encryption · dialect ${t}${n ? " · DRY RUN, nothing written" : ""}`), console.log("");
-		for (let e of p) console.log(gt(e, n));
-		return n || console.log(St(d)), 0;
+		for (let e of p) console.log(_t(e, n));
+		return n || console.log(Ct(d)), 0;
 	}
-}, xn = (e) => Object.prototype.hasOwnProperty.call(bn, e), Sn = async (t) => {
+}, Sn = (e) => Object.prototype.hasOwnProperty.call(xn, e), Cn = async (t) => {
 	let [n, ...r] = t;
 	if (!n) {
 		console.error("voltro db <subcommand> [args]"), console.error("subcommands:");
-		for (let e of Object.keys(bn)) console.error(`  ${e}`);
+		for (let e of Object.keys(xn)) console.error(`  ${e}`);
 		return 1;
 	}
-	if (!xn(n)) return console.error(`voltro db: unknown subcommand '${n}'`), console.error(`  known: ${e.join(", ")}`), 2;
-	let i = bn[n];
+	if (!Sn(n)) return console.error(`voltro db: unknown subcommand '${n}'`), console.error(`  known: ${e.join(", ")}`), 2;
+	let i = xn[n];
 	(process.env.DB_DIRECT_URL !== void 0 || process.env.DB_MIGRATE_URL !== void 0) && B.info("using a DIRECT (non-pooler) connection for the db-command path (DB_DIRECT_URL/DB_MIGRATE_URL set)");
 	let a = (e) => {
-		Ot(e) ? B.error(kt) : console.error(e), process.exit(1);
+		kt(e) ? B.error(At) : console.error(e), process.exit(1);
 	};
 	process.on("uncaughtException", a);
 	try {
@@ -1648,4 +1689,4 @@ export default defineMigration({
 	}
 };
 //#endregion
-export { Lt as a, fn as i, U as n, Ot as o, It as r, Sn as s, kt as t };
+export { Rt as a, Cn as c, pn as i, U as n, kt as o, Lt as r, X as s, At as t };