@voltro/cli 0.24.0 → 0.25.0

package/dist/{dbCommand-CC61CsAc.js → dbCommand-FUU12FvD.js}

@@ -1,7 +1,7 @@
 import { i as e, n as t, r as n, s as r, t as i } from "./seedRunner-D6eu-u5U.js";
 import { n as a } from "./appModuleLoader-C9r9mxZt.js";
-import { t as o } from "./frameworkTableAssembly-sg41s14F.js";
-import { g as s } from "./fileConventions-CBNPZVOV.js";
+import { t as o } from "./frameworkTableAssembly-Cw5zJz6n.js";
+import { _ as s } from "./fileConventions-3bffWssN.js";
 import { a as c, n as l, t as u } from "./cliArgs-qdZSElM3.js";
 import { basename as d, join as f, relative as p, resolve as m } from "node:path";
 import { pathToFileURL as h } from "node:url";
@@ -10,17 +10,17 @@ import { createLogger as _ } from "@voltro/logger";
 import { promises as v, writeSync as y } from "node:fs";
 import { InMemoryDataStore as ee } from "@voltro/runtime";
 import { SqlClient as b } from "@effect/sql";
-import { actorsTable as te, frameworkTables as x, isMigrationDefinition as ne, quoteIdent as re, registerCoreTables as ie } from "@voltro/database";
-import { createHash as ae } from "node:crypto";
-import { DEFAULT_CDC_CHANNEL as oe, applyPlan as se, applySchema as S, declaredSnapshot as ce, destructiveScope as le, detectReactiveTriggerDrift as ue, fingerprintSchema as C, ignoreTablesFromEnv as w, introspectSchema as T, pendingFileMigrationIds as de, planMigrations as E, reactiveTriggerRepairSql as fe, rollbackFileBasedMigration as pe, rollingDeployUnsafeOps as me, runFileBasedMigrations as he, shortFingerprint as D, squashMigrationPlans as ge, unblockLossy as _e } from "@voltro/database/sql";
+import { actorsTable as te, frameworkTables as x, isMigrationDefinition as S, quoteIdent as ne, registerCoreTables as re } from "@voltro/database";
+import { createHash as ie } from "node:crypto";
+import { DEFAULT_CDC_CHANNEL as ae, applyPlan as C, applySchema as w, assessRollingDeployGate as oe, declaredSnapshot as se, destructiveScope as ce, detectReactiveTriggerDrift as le, fingerprintSchema as T, ignoreTablesFromEnv as E, introspectSchema as D, pendingFileMigrationIds as ue, planMigrations as O, reactiveTriggerRepairSql as de, rollbackFileBasedMigration as fe, rollingDeployUnsafeOps as pe, runFileBasedMigrations as me, shortFingerprint as k, squashMigrationPlans as he, unblockLossy as ge } from "@voltro/database/sql";
 //#region src/cliError.ts
-var ve = class extends Error {
+var _e = class extends Error {
 	isCliError = !0;
 	code;
 	constructor(e, t = 1) {
 		super(e), this.name = "CliError", this.code = t;
 	}
-}, ye = (e) => typeof e == "object" && !!e && e.isCliError === !0, be = (e) => typeof e != "string", xe = (e, t, n, r) => {
+}, ve = (e) => typeof e == "object" && !!e && e.isCliError === !0, ye = (e) => typeof e != "string", be = (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 ve = class extends Error {
 			});
 			continue;
 		}
-		if (be(n)) {
+		if (ye(n)) {
 			c.push({
 				target: t,
 				source: n.expr,
@@ -80,23 +80,23 @@ var ve = class extends Error {
 		remintIds: f,
 		fatal: i.some((e) => e.fatal)
 	};
-}, Se = (e, t) => [
+}, xe = (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`
-], Ce = (e, t, n) => {
+], Se = (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 Se(e, t).entries()) r.push(`    ${n + 1}. ${i}`);
+	for (let [n, i] of xe(e, t).entries()) r.push(`    ${n + 1}. ${i}`);
 	return r;
-}, we = (e) => e === "mysql" || e === "mariadb" ? (e) => `\`${e}\`` : e === "mssql" ? (e) => `[${e}]` : (e) => `"${e}"`, O = (e) => `${e}__adopt_snapshot`, Te = (e, t, n, r, i) => {
-	let a = we(n), o = O(e.from), s = t.assignments.map((e) => e.target), c = t.assignments.map((e) => e.raw ? e.source : a(e.source));
+}, Ce = (e) => e === "mysql" || e === "mariadb" ? (e) => `\`${e}\`` : e === "mssql" ? (e) => `[${e}]` : (e) => `"${e}"`, A = (e) => `${e}__adopt_snapshot`, we = (e, t, n, r, i) => {
+	let a = Ce(n), o = A(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 ve = class extends Error {
 		drop: `DROP TABLE ${a(e.from)}`,
 		dropSnapshot: `DROP TABLE ${a(o)}`
 	};
-}, k = (e) => {
+}, j = (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);
-}, Ee = async (e, t, n, r, i, a, o = {}) => {
+}, Te = async (e, t, n, r, i, a, o = {}) => {
 	if (t.fatal) throw Error("adopt: the plan was refused — nothing was run");
-	let s = Te(e, t, n, r, i), c = O(e.from), l = k(await a(s.verifySource));
+	let s = we(e, t, n, r, i), c = A(e.from), l = j(await a(s.verifySource));
 	await a(s.snapshot);
 	for (let e of s.translations) await a(e);
 	await a(s.copy);
-	let u = k(await a(s.verifyTarget));
+	let u = j(await a(s.verifyTarget));
 	return u === l ? o.keepSource === !0 ? {
 		copied: u,
 		sourceRows: l,
@@ -137,7 +137,7 @@ var ve = class extends Error {
 		snapshotTable: c,
 		sourceDropped: !1
 	};
-}, A = /\.migration\.ts$/, j = async (e, t) => {
+}, M = /\.migration\.ts$/, N = async (e, t) => {
 	let n = [];
 	for (let r of e) {
 		let e;
@@ -147,7 +147,7 @@ var ve = class extends Error {
 			t.warn("migration: failed to import", { file: r }, e);
 			continue;
 		}
-		let i = (e.default && ne(e.default) ? e.default : void 0) ?? Object.values(e).find(ne);
+		let i = (e.default && S(e.default) ? e.default : void 0) ?? Object.values(e).find(S);
 		if (!i) {
 			t.warn("migration: no defineMigration export", { file: r });
 			continue;
@@ -157,7 +157,7 @@ var ve = class extends Error {
 			idInFile: i.id,
 			idFromFile: d(r).replace(/\.migration\.ts$/, "")
 		});
-		let a = await v.readFile(r, "utf8").catch(() => ""), o = ae("sha256").update(a).digest("hex").slice(0, 16);
+		let a = await v.readFile(r, "utf8").catch(() => ""), o = ie("sha256").update(a).digest("hex").slice(0, 16);
 		n.push({
 			file: r,
 			definition: i,
@@ -165,13 +165,13 @@ var ve = class extends Error {
 		});
 	}
 	return [...n].sort((e, t) => e.definition.id < t.definition.id ? -1 : 1);
-}, M = (e) => {
+}, P = (e) => {
 	let t = (process.env.DB_DIALECT ?? "postgres").toLowerCase(), n = t === "memory" ? "postgres" : t;
-	return g.runPromise(S(x, n).pipe(g.provide(e)));
-}, N = (e) => g.runPromise(g.gen(function* () {
+	return g.runPromise(w(x, n).pipe(g.provide(e)));
+}, F = (e) => g.runPromise(g.gen(function* () {
 	let e = yield* (yield* b.SqlClient)`SELECT id, status, hash, "appliedAt" FROM "_voltro_migrations"`.pipe(g.orElseSucceed(() => []));
 	return new Map(e.map((e) => [e.id, e]));
-}).pipe(g.provide(e))), P = (e, t) => g.runPromise(g.gen(function* () {
+}).pipe(g.provide(e))), I = (e, t) => g.runPromise(g.gen(function* () {
 	yield* (yield* b.SqlClient)`
         INSERT INTO "_voltro_migrations"
           (id, name, hash, status, "appliedAt", "durationMs", "errorMessage", "errorStack")
@@ -187,14 +187,14 @@ var ve = class extends Error {
           "errorStack"  = EXCLUDED."errorStack",
           "updatedAt"   = now()
       `;
-}).pipe(g.provide(e))), De = async (e, t, n) => {
+}).pipe(g.provide(e))), Ee = async (e, t, n) => {
 	if (e.length === 0) return {
 		applied: [],
 		failed: null,
 		skipped: []
 	};
-	await M(t);
-	let r = await N(t), i = [], a = [], o = null;
+	await P(t);
+	let r = await F(t), i = [], a = [], o = null;
 	for (let s of e) {
 		let e = r.get(s.definition.id);
 		if (e && e.status === "applied") {
@@ -215,7 +215,7 @@ var ve = class extends Error {
 			name: s.definition.name
 		});
 		let c = Date.now(), l = [];
-		await P(t, {
+		await I(t, {
 			id: s.definition.id,
 			name: s.definition.name,
 			hash: s.hash,
@@ -256,7 +256,7 @@ var ve = class extends Error {
 						...a.stack ? { stack: a.stack } : {}
 					}
 				};
-				o = f, i.push(f), await P(t, {
+				o = f, i.push(f), await I(t, {
 					id: s.definition.id,
 					name: s.definition.name,
 					hash: s.hash,
@@ -275,7 +275,7 @@ var ve = class extends Error {
 			status: "applied",
 			durationMs: Date.now() - c,
 			steps: l
-		}), await P(t, {
+		}), await I(t, {
 			id: s.definition.id,
 			name: s.definition.name,
 			hash: s.hash,
@@ -295,9 +295,9 @@ var ve = class extends Error {
 		failed: o,
 		skipped: a
 	};
-}, Oe = async (e, t, n, r = {}) => {
-	await M(t);
-	let i = await N(t), a = e.filter((e) => i.get(e.definition.id)?.status === "applied");
+}, De = async (e, t, n, r = {}) => {
+	await P(t);
+	let i = await F(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,
@@ -350,7 +350,7 @@ var ve = class extends Error {
 			status: "applied",
 			durationMs: Date.now() - r,
 			steps: i
-		}), await P(t, {
+		}), await I(t, {
 			id: e.definition.id,
 			name: e.definition.name,
 			hash: e.hash,
@@ -366,9 +366,9 @@ var ve = class extends Error {
 		failed: c,
 		skipped: []
 	};
-}, F = async (e, t) => {
-	await M(t);
-	let n = await N(t);
+}, L = async (e, t) => {
+	await P(t);
+	let n = await F(t);
 	return e.map((e) => {
 		let t = n.get(e.definition.id);
 		return t ? {
@@ -385,7 +385,7 @@ var ve = class extends Error {
 			hashMatches: !0
 		};
 	});
-}, I = (e) => {
+}, R = (e) => {
 	if (!e.failed) return "";
 	let t = e.failed, n = [
 		`✗ Migration failed: ${t.migrationId} / step '${t.error?.stepName ?? "?"}'`,
@@ -398,7 +398,7 @@ var ve = class extends Error {
 		""
 	];
 	return e.applied.length > 0 && n.unshift("", `(${e.applied.length} migration(s) applied successfully before the failure.)`), n.join("\n");
-}, L = _({ scope: "voltro:db" }), ke = /* @__PURE__ */ new Set([
+}, z = _({ scope: "voltro:db" }), Oe = /* @__PURE__ */ new Set([
 	"node_modules",
 	"dist",
 	"build",
@@ -406,17 +406,17 @@ var ve = class extends Error {
 	".vite",
 	".next",
 	".git"
-]), R = async (e, t) => {
+]), B = async (e, t) => {
 	let n = [], r = async (e) => {
 		let i = await v.readdir(e, { withFileTypes: !0 }).catch(() => []);
 		for (let a of i) {
-			if (ke.has(a.name)) continue;
+			if (Oe.has(a.name)) continue;
 			let i = f(e, a.name);
 			a.isDirectory() ? await r(i) : a.isFile() && t.test(a.name) && n.push(i);
 		}
 	};
 	return await r(e), n;
-}, z = (e) => m(e.find((e) => !e.startsWith("-")) ?? process.cwd()), B = () => {
+}, V = (e) => m(e.find((e) => !e.startsWith("-")) ?? process.cwd()), H = () => {
 	let e = process.env.DB_MAX_CONNECTIONS ?? process.env.PG_MAX_CONNECTIONS, t = e !== void 0 && e !== "" ? Number(e) : NaN, n = Number.isInteger(t) && t > 0 ? { maxConnections: t } : {}, r = process.env.DB_SCHEMA, i = r && r.length > 0 ? { schema: r } : {}, a = process.env.DB_DIRECT_URL ?? process.env.DB_MIGRATE_URL ?? process.env.DB_URL ?? process.env.DB_PRIMARY_URL;
 	return a ? {
 		url: a,
@@ -431,63 +431,63 @@ var ve = class extends Error {
 		...n,
 		...i
 	};
-}, V = (e) => {
+}, U = (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);
-}, H = "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`.)", U = () => {
+}, W = "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`.)", G = () => {
 	let e = (process.env.DB_DIALECT ?? "postgres").toLowerCase();
-	if (e === "memory") throw new ve("voltro db: subcommands require a real dialect, not DB_DIALECT=memory.");
+	if (e === "memory") throw new _e("voltro db: subcommands require a real dialect, not DB_DIALECT=memory.");
 	return e;
-}, W = async () => (await r(U())).makeSqlLayer(B()), Ae = async (e) => {
-	let t = z(e), n = e.includes("--dry-run"), r = await j(await R(t, A), L);
-	if (r.length === 0) return L.info("no migrations found", { root: t }), 0;
+}, K = async () => (await r(G())).makeSqlLayer(H()), ke = async (e) => {
+	let t = V(e), n = e.includes("--dry-run"), r = await N(await B(t, M), z);
+	if (r.length === 0) return z.info("no migrations found", { root: t }), 0;
 	if (n) {
 		let e = /* @__PURE__ */ new Set();
 		try {
-			let t = await F(r, await W());
+			let t = await L(r, await K());
 			e = new Set(t.filter((e) => e.status === "applied").map((e) => e.id));
 		} catch {
-			L.warn("migrate --dry-run: could not read the migration ledger — showing ALL as pending");
+			z.warn("migrate --dry-run: could not read the migration ledger — showing ALL as pending");
 		}
 		let t = r.filter((t) => !e.has(t.definition.id));
-		if (t.length === 0) return L.info("migrate --dry-run: nothing pending — every migration is applied"), 0;
-		L.info(`migrate --dry-run: ${t.length} pending (nothing applied)`);
+		if (t.length === 0) return z.info("migrate --dry-run: nothing pending — every migration is applied"), 0;
+		z.info(`migrate --dry-run: ${t.length} pending (nothing applied)`);
 		for (let e of t) console.log(`  pending  ${e.definition.id}`);
 		return 0;
 	}
-	let i = await De(r, await W(), L);
-	return i.failed ? (process.stderr.write(I(i) + "\n"), 1) : (L.info("migrate complete", {
+	let i = await Ee(r, await K(), z);
+	return i.failed ? (process.stderr.write(R(i) + "\n"), 1) : (z.info("migrate complete", {
 		applied: i.applied.length,
 		skipped: i.skipped.length
 	}), 0);
+}, Ae = async (e) => {
+	let t = V(e), n = l(e, "--to"), r = await N(await B(t, M), z);
+	if (r.length === 0) return z.info("no migrations found", { root: t }), 0;
+	let i = await De(r, await K(), z, n ? { to: n } : {});
+	return i.failed ? (process.stderr.write(R(i) + "\n"), 1) : (z.info("rollback complete", { reverted: i.applied.length }), 0);
 }, je = async (e) => {
-	let t = z(e), n = l(e, "--to"), r = await j(await R(t, A), L);
-	if (r.length === 0) return L.info("no migrations found", { root: t }), 0;
-	let i = await Oe(r, await W(), L, n ? { to: n } : {});
-	return i.failed ? (process.stderr.write(I(i) + "\n"), 1) : (L.info("rollback complete", { reverted: i.applied.length }), 0);
-}, Me = async (e) => {
-	let t = await j(await R(z(e), A), L);
+	let t = await N(await B(V(e), M), z);
 	if (t.length === 0) return console.log("no migrations found"), 0;
-	let n = await F(t, await W());
+	let n = await L(t, await K());
 	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;
-}, Ne = async (e) => {
+}, Me = async (e) => {
 	let t = (l(e, "--store") ?? process.env.DB_DIALECT ?? "postgres").toLowerCase();
-	if (t === "memory") return L.warn("voltro db seed: using in-memory store (explicit opt-in via --store memory / DB_DIALECT=memory)"), L.warn("  rows written by this run will NOT persist beyond the process. set DB_DIALECT=postgres or unset to seed the real DB."), {
+	if (t === "memory") return z.warn("voltro db seed: using in-memory store (explicit opt-in via --store memory / DB_DIALECT=memory)"), z.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 ee(),
 		dispose: async () => {},
 		dialectId: "memory"
 	};
 	let n = await r(t);
-	L.info(`voltro db seed: target store=${n.id} — rows will persist`);
+	z.info(`voltro db seed: target store=${n.id} — rows will persist`);
 	let i = await n.makeStore({
-		sqlLayer: n.makeSqlLayer(B()),
+		sqlLayer: n.makeSqlLayer(H()),
 		changeStrategy: "inline"
 	}), a = i;
 	return {
@@ -497,77 +497,77 @@ var ve = class extends Error {
 		},
 		dialectId: n.id
 	};
-}, Pe = async (r) => {
-	let a = z(r), o = l(r, "--id"), s = l(r, "--lifecycle"), c = await t(await R(a, i), L);
-	if (c.length === 0) return L.info("no seeds found", { root: a }), 0;
-	let { store: u, dispose: d, dialectId: f } = await Ne(r);
+}, Ne = async (r) => {
+	let a = V(r), o = l(r, "--id"), s = l(r, "--lifecycle"), c = await t(await B(a, i), z);
+	if (c.length === 0) return z.info("no seeds found", { root: a }), 0;
+	let { store: u, dispose: d, dialectId: f } = await Me(r);
 	try {
-		return o ? +((await e(c, o, u, L)).status === "failed") : +((await n((s ? c.filter((e) => e.definition.lifecycle === s) : c.filter((e) => e.definition.lifecycle === "boot")).map((e) => ({
+		return o ? +((await e(c, o, u, z)).status === "failed") : +((await n((s ? c.filter((e) => e.definition.lifecycle === s) : c.filter((e) => e.definition.lifecycle === "boot")).map((e) => ({
 			...e,
 			definition: {
 				...e.definition,
 				lifecycle: "boot"
 			}
-		})), u, L, { force: !0 })).filter((e) => e.status === "failed").length > 0);
+		})), u, z, { force: !0 })).filter((e) => e.status === "failed").length > 0);
 	} finally {
 		await d().catch((e) => {
-			L.warn("voltro db seed: store dispose failed", { error: String(e) });
+			z.warn("voltro db seed: store dispose failed", { error: String(e) });
 		});
 	}
-}, Fe = (e) => typeof e == "object" && !!e && "tableName" in e && "fields" in e && typeof e.tableName == "string", G = async (e) => {
-	let t = await R(e, s), n = [];
+}, Pe = (e) => typeof e == "object" && !!e && "tableName" in e && "fields" in e && typeof e.tableName == "string", Fe = async (e) => {
+	let t = await B(e, s), n = [];
 	for (let r of t) {
 		let t;
 		try {
 			t = await import(h(r).href);
 		} catch (t) {
-			L.warn("db: failed to import schema file", {
+			z.warn("db: failed to import schema file", {
 				file: p(e, r),
 				error: String(t)
 			});
 			continue;
 		}
-		for (let e of Object.values(t)) Fe(e) && n.push(e);
+		for (let e of Object.values(t)) Pe(e) && n.push(e);
 	}
 	return n;
-}, K = (e) => {
+}, Ie = (e) => {
 	let t = new Map(e.map((e) => [e.tableName, e]));
 	t.has("actors") || t.set("actors", te);
 	let n = t.get("actors"), r = t.get("tenants");
-	return ie({
+	return re({
 		actors: () => n,
 		...r === void 0 ? {} : { tenants: () => r }
 	}), [...t.values()];
-}, Ie = (e) => {
+}, Le = (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()];
-}, q = (e) => {
-	let t = le(process.env.VOLTRO_DESTRUCTIVE_OK);
+}, Re = (e) => {
+	let t = ce(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 = _e(e, t);
+	let n = ge(e, t);
 	return {
 		plan: n,
 		acknowledged: !n.operations.some((e) => e.blocked)
 	};
-}, J = async (e, t) => g.runPromise(t.pipe(g.provide(e))), Y = async (e) => {
+}, q = async (e, t) => g.runPromise(t.pipe(g.provide(e))), J = async (e) => {
 	try {
-		return await J(e, b.SqlClient.pipe(g.flatMap(T)));
+		return await q(e, b.SqlClient.pipe(g.flatMap(D)));
 	} catch (e) {
 		let t = String(e?.message ?? e);
-		if (V(e) || /connection error/i.test(t)) {
-			let n = /* @__PURE__ */ Error(`${H}\n\nOriginal error: ${t}`);
+		if (U(e) || /connection error/i.test(t)) {
+			let n = /* @__PURE__ */ Error(`${W}\n\nOriginal error: ${t}`);
 			throw n.cause = e, n;
 		}
 		throw e;
 	}
-}, Le = {
+}, ze = {
 	safe: "\x1B[32m✓\x1B[0m",
 	"needs-default": "\x1B[32m⊕\x1B[0m",
 	"needs-backfill": "\x1B[33m⊕\x1B[0m",
@@ -575,7 +575,7 @@ var ve = class extends Error {
 	lossy: "\x1B[31m✗\x1B[0m",
 	"online-required": "\x1B[36m◷\x1B[0m",
 	"multi-step": "\x1B[35m⇉\x1B[0m"
-}, Re = (e) => {
+}, Be = (e) => {
 	let t = e.op, n;
 	switch (t.kind) {
 		case "create-table":
@@ -639,9 +639,9 @@ var ve = class extends Error {
 			n = `ALTER TABLE ${t.table} DROP CHECK ${t.column}`;
 			break;
 	}
-	let r = Le[e.classification], i = e.reason ? `  # ${e.reason}` : "", a = e.blocked ? `\n    ! ${e.blocked.fix}` : "";
+	let r = ze[e.classification], i = e.reason ? `  # ${e.reason}` : "", a = e.blocked ? `\n    ! ${e.blocked.fix}` : "";
 	return `  ${r} ${n}${i}${a}`;
-}, ze = async (e, t) => {
+}, Ve = 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 = [];
@@ -650,7 +650,7 @@ var ve = class extends Error {
 		if (i === void 0 || a === void 0) continue;
 		let o = 0;
 		try {
-			let e = await J(t, b.SqlClient.pipe(g.flatMap((e) => e.unsafe(`SELECT COUNT(*) AS n FROM ${re(i, U())}`))));
+			let e = await q(t, b.SqlClient.pipe(g.flatMap((e) => e.unsafe(`SELECT COUNT(*) AS n FROM ${ne(i, G())}`))));
 			o = Number(Object.values(e[0] ?? { n: 0 })[0] ?? 0);
 		} catch {
 			continue;
@@ -662,15 +662,15 @@ var ve = class extends Error {
 		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)");
 	}
-}, X = async (e, t) => {
-	if (U() !== "postgres") return;
-	let n = oe, r;
+}, Y = async (e, t) => {
+	if (G() !== "postgres") return;
+	let n = ae, r;
 	try {
-		r = await J(t, b.SqlClient.pipe(g.flatMap((t) => ue(t, e, n))));
+		r = await q(t, b.SqlClient.pipe(g.flatMap((t) => le(t, e, n))));
 	} catch {
 		return;
 	}
-	let i = fe({
+	let i = de({
 		tables: e,
 		dialect: "postgres",
 		missing: r.missing,
@@ -678,46 +678,53 @@ var ve = class extends Error {
 		channel: n
 	});
 	if (i.length === 0) return;
-	L.info(`db apply: installing change triggers on ${r.missing.length} table(s)` + (r.stale.length > 0 ? `, removing ${r.stale.length} stale one(s)` : ""));
+	z.info(`db apply: installing change triggers on ${r.missing.length} table(s)` + (r.stale.length > 0 ? `, removing ${r.stale.length} stale one(s)` : ""));
 	let a = 0;
-	for (let e of i) await J(t, b.SqlClient.pipe(g.flatMap((t) => t.unsafe(e)))), a += 1;
-	L.info(`db apply: change triggers converged (${a} statement(s))`, {
+	for (let e of i) await q(t, b.SqlClient.pipe(g.flatMap((t) => t.unsafe(e)))), a += 1;
+	z.info(`db apply: change triggers converged (${a} statement(s))`, {
 		installed: r.missing.length,
 		removed: r.stale.length
 	});
-}, Z = (e) => {
+}, X = (e) => {
 	let t = e.summary, n = e.operations.length;
 	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(Re(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: ${e.fromFingerprint.slice(0, 16)} → ${e.toFingerprint.slice(0, 16)}\n`), Be(e);
-}, Be = (e) => {
-	let t = me(e.operations);
+	for (let t of e.operations) console.log(Be(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: ${e.fromFingerprint.slice(0, 16)} → ${e.toFingerprint.slice(0, 16)}\n`), He(e);
+}, He = (e) => {
+	let t = pe(e.operations);
 	if (t.length !== 0) {
 		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");
 	}
-}, Ve = (e) => {
+}, Ue = (e, t) => {
+	let n = oe({
+		enabled: process.env.VOLTRO_ROLLING_DEPLOY === "1",
+		forced: t.includes("--force"),
+		unsafeCount: pe(e.operations).length
+	});
+	return n.refuse ? (z.error(`db apply: ${n.message}`), !0) : (n.warnForced && z.warn(`db apply: ${n.message}`), !1);
+}, We = (e) => {
 	let t = l(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;
-}, Q = async (e) => {
-	let t = await G(e);
+}, Z = async (e) => {
+	let t = await Fe(e);
 	if (t.length === 0) return;
 	let n = await o({ root: e });
-	return K(Ie([
+	return Ie(Le([
 		...t,
 		...x,
 		...n
 	]));
-}, He = async (e) => {
-	let t = Ve(e), n = z(e), r = await Q(n);
-	if (r === void 0) return L.warn("db plan: no schema files found", {
+}, Ge = async (e) => {
+	let t = We(e), n = V(e), r = await Z(n);
+	if (r === void 0) return z.warn("db plan: no schema files found", {
 		root: n,
 		hint: "looked for *.entity.ts / *.schema.ts / schema.ts"
 	}), 1;
@@ -727,113 +734,115 @@ var ve = class extends Error {
 		a && (o.authorization = `Bearer ${a}`);
 		try {
 			let e = n.endsWith("/_voltro/inspect/migrations") ? n : `${n.replace(/\/+$/, "")}/_voltro/inspect/migrations`, i = await fetch(e, { headers: o });
-			if (!i.ok) return L.error(`db plan --against: remote returned ${i.status}`, { url: e }), 1;
+			if (!i.ok) return z.error(`db plan --against: remote returned ${i.status}`, { url: e }), 1;
 			let a = (await i.json()).drift?.liveSnapshot;
-			if (!a) return L.error("db plan --against: remote inspect payload missing drift.liveSnapshot", { url: e }), 1;
-			let s = E({
+			if (!a) return z.error("db plan --against: remote inspect payload missing drift.liveSnapshot", { url: e }), 1;
+			let s = O({
 				declared: r,
 				live: a,
-				dialect: U(),
-				...w(),
+				dialect: G(),
+				...E(),
 				...t === void 0 ? {} : { onlineAfter: t }
 			});
-			return console.log(`\n[--against ${e}] — diff vs remote live schema:\n`), Z(s), s.summary.blocked > 0 ? 2 : 0;
+			return console.log(`\n[--against ${e}] — diff vs remote live schema:\n`), X(s), s.summary.blocked > 0 ? 2 : 0;
 		} catch (e) {
-			return L.error(`db plan --against: ${e.message}`), 1;
+			return z.error(`db plan --against: ${e.message}`), 1;
 		}
 	}
-	let a = E({
+	let a = O({
 		declared: r,
-		live: await Y(await W()),
-		dialect: U(),
-		...w(),
+		live: await J(await K()),
+		dialect: G(),
+		...E(),
 		...t === void 0 ? {} : { onlineAfter: t }
 	});
-	return e.includes("--json") ? (y(1, `${JSON.stringify(a, null, 2)}\n`), a.summary.blocked > 0 ? 2 : 0) : (Z(a), a.summary.blocked > 0 ? 2 : 0);
-}, Ue = async (e, t, n) => {
+	return e.includes("--json") ? (y(1, `${JSON.stringify(a, null, 2)}\n`), a.summary.blocked > 0 ? 2 : 0) : (X(a), a.summary.blocked > 0 ? 2 : 0);
+}, Ke = async (e, t, n) => {
 	let r;
 	try {
 		let t = await v.readFile(m(e), "utf8");
 		r = JSON.parse(t);
 	} catch (t) {
-		return L.error(`db apply --plan: cannot read/parse plan file '${e}': ${t.message}`), 1;
+		return z.error(`db apply --plan: cannot read/parse plan file '${e}': ${t.message}`), 1;
 	}
-	if (!Array.isArray(r?.operations) || typeof r?.fromFingerprint != "string" || typeof r?.toFingerprint != "string") return L.error(`db apply --plan: '${e}' is not a valid plan file (expected the output of \`voltro db plan --json\`).`), 1;
-	let i = await Q(n);
-	if (i === void 0) return L.warn("db apply --plan: no schema files found", { root: n }), 1;
-	let a = await W();
-	await J(a, S(x, U()));
-	let o = await J(a, b.SqlClient.pipe(g.flatMap((e) => de(e, n)))).catch(() => []);
-	if (o.length > 0) return L.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 s = E({
+	if (!Array.isArray(r?.operations) || typeof r?.fromFingerprint != "string" || typeof r?.toFingerprint != "string") return z.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 z.warn("db apply --plan: no schema files found", { root: n }), 1;
+	let a = await K();
+	await q(a, w(x, G()));
+	let o = await q(a, b.SqlClient.pipe(g.flatMap((e) => ue(e, n)))).catch(() => []);
+	if (o.length > 0) return z.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 s = O({
 		declared: i,
-		live: await Y(a),
-		dialect: U(),
-		...w()
+		live: await J(a),
+		dialect: G(),
+		...E()
 	});
-	if (s.fromFingerprint !== r.fromFingerprint) return L.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=${s.fromFingerprint.slice(0, 16)}`), console.error("  Regenerate against the current live schema: `voltro db plan --json > plan.json`"), 2;
-	if (s.toFingerprint !== r.toFingerprint) return L.error("db apply --plan: refusing — the declared schema differs from what this plan targets."), console.error(`  plan.to=${r.toFingerprint.slice(0, 16)}  declared=${s.toFingerprint.slice(0, 16)}`), console.error("  The schema files changed since the plan was generated. Regenerate the plan."), 2;
-	let c = q(s), u = c.plan;
-	if (u.summary.blocked > 0 && !c.acknowledged) return Z(u), L.error(`db apply --plan: refusing — ${s.summary.blocked} blocked operation(s). See the fix hints above.`), process.env.VOLTRO_DESTRUCTIVE_OK !== void 0 && (L.error("  VOLTRO_DESTRUCTIVE_OK is set but did not cover this plan — it only relaxes"), L.error("  `lossy` operations, and only the tables it names. Anything else stays refused.")), 2;
-	if (c.acknowledged && L.warn("db apply --plan: proceeding with acknowledged lossy operation(s) (VOLTRO_DESTRUCTIVE_OK)"), u.operations.length === 0) return L.info("db apply --plan: schema is up to date — nothing to apply"), await X(i, a), 0;
-	Z(u);
-	let d = (process.env.NODE_ENV ?? "dev").toLowerCase(), f = l(t, "--note"), p = await J(a, b.SqlClient.pipe(g.flatMap((e) => se(e, u, {
+	if (s.fromFingerprint !== r.fromFingerprint) return z.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=${s.fromFingerprint.slice(0, 16)}`), console.error("  Regenerate against the current live schema: `voltro db plan --json > plan.json`"), 2;
+	if (s.toFingerprint !== r.toFingerprint) return z.error("db apply --plan: refusing — the declared schema differs from what this plan targets."), console.error(`  plan.to=${r.toFingerprint.slice(0, 16)}  declared=${s.toFingerprint.slice(0, 16)}`), console.error("  The schema files changed since the plan was generated. Regenerate the plan."), 2;
+	let c = Re(s), u = c.plan;
+	if (u.summary.blocked > 0 && !c.acknowledged) return X(u), z.error(`db apply --plan: refusing — ${s.summary.blocked} blocked operation(s). See the fix hints above.`), process.env.VOLTRO_DESTRUCTIVE_OK !== void 0 && (z.error("  VOLTRO_DESTRUCTIVE_OK is set but did not cover this plan — it only relaxes"), z.error("  `lossy` operations, and only the tables it names. Anything else stays refused.")), 2;
+	if (c.acknowledged && z.warn("db apply --plan: proceeding with acknowledged lossy operation(s) (VOLTRO_DESTRUCTIVE_OK)"), Ue(u, t)) return 2;
+	if (u.operations.length === 0) return z.info("db apply --plan: schema is up to date — nothing to apply"), await Y(i, a), 0;
+	X(u);
+	let d = (process.env.NODE_ENV ?? "dev").toLowerCase(), f = l(t, "--note"), p = await q(a, b.SqlClient.pipe(g.flatMap((e) => C(e, u, {
 		declared: i,
 		appliedBy: process.env.USER ? `cli:${process.env.USER}` : "cli:plan",
 		environment: d === "production" ? "prod" : d === "staging" ? "staging" : "dev",
 		source: "file",
 		...f ? { notes: f } : {},
-		replan: () => g.promise(() => Y(a)).pipe(g.map((e) => E({
+		replan: () => g.promise(() => J(a)).pipe(g.map((e) => O({
 			declared: i,
 			live: e,
-			dialect: U(),
-			...w()
+			dialect: G(),
+			...E()
 		})))
 	}))));
-	return L.info(`db apply --plan: applied ${p.appliedOps} op(s) in ${p.durationMs}ms`, {
+	return z.info(`db apply --plan: applied ${p.appliedOps} op(s) in ${p.durationMs}ms`, {
 		id: p.id,
 		fingerprint: p.fingerprint.slice(0, 16)
-	}), await X(i, a), 0;
-}, We = async (e) => {
-	let t = z(e), n = Ve(e), r = l(e, "--plan");
-	if (r) return Ue(r, e, t);
-	if ((process.env.NODE_ENV ?? "").toLowerCase() === "production") return L.error("voltro db apply: refusing — auto-apply on prod is not allowed."), 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;
-	let i = await Q(t);
-	if (i === void 0) return L.warn("db apply: no schema files found", { root: t }), 1;
-	let a = await W(), o = await $e(t, a);
-	if ("failed" in o) return L.error("db apply: a file-based migration FAILED — the schema diff was NOT run"), console.error(o.failed), console.error("Fix the migration and re-run. `voltro db files` runs them alone."), 1;
-	await J(a, S(x, U()));
-	let s = E({
+	}), await Y(i, a), 0;
+}, qe = async (e) => {
+	let t = V(e), n = We(e), r = l(e, "--plan");
+	if (r) return Ke(r, e, t);
+	if ((process.env.NODE_ENV ?? "").toLowerCase() === "production") return z.error("voltro db apply: refusing — auto-apply on prod is not allowed."), 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;
+	let i = await Z(t);
+	if (i === void 0) return z.warn("db apply: no schema files found", { root: t }), 1;
+	let a = await K(), o = await nt(t, a);
+	if ("failed" in o) return z.error("db apply: a file-based migration FAILED — the schema diff was NOT run"), console.error(o.failed), console.error("Fix the migration and re-run. `voltro db files` runs them alone."), 1;
+	await q(a, w(x, G()));
+	let s = O({
 		declared: i,
-		live: await Y(a),
-		dialect: U(),
-		...w(),
+		live: await J(a),
+		dialect: G(),
+		...E(),
 		...n === void 0 ? {} : { onlineAfter: n }
 	});
-	Z(s), await ze(s, a);
-	let c = q(s), u = c.plan;
-	if (u.summary.blocked > 0 && !c.acknowledged) return L.error(`db apply: refusing — ${u.summary.blocked} blocked operation(s). See the fix hints above.`), process.env.VOLTRO_DESTRUCTIVE_OK !== void 0 && (L.error("  VOLTRO_DESTRUCTIVE_OK is set but did not cover this plan — it only relaxes"), L.error("  `lossy` operations, and only the tables it names. Anything else stays refused.")), 2;
-	if (c.acknowledged && L.warn(`db apply: proceeding with ${s.summary.blocked} acknowledged lossy operation(s) (VOLTRO_DESTRUCTIVE_OK)`), u.operations.length === 0) return L.info("db apply: schema is up to date — nothing to apply"), await Ye(a), l(e, "--note") !== void 0 && (L.warn("db apply: --note was ignored — an empty plan writes no history row to attach it to."), console.error("To record that the CURRENT live schema is the accepted baseline, use `voltro db drift --accept`.")), await X(i, a), 0;
-	let d = l(e, "--note"), f = await J(a, b.SqlClient.pipe(g.flatMap((e) => se(e, u, {
+	X(s), await Ve(s, a);
+	let c = Re(s), u = c.plan;
+	if (u.summary.blocked > 0 && !c.acknowledged) return z.error(`db apply: refusing — ${u.summary.blocked} blocked operation(s). See the fix hints above.`), process.env.VOLTRO_DESTRUCTIVE_OK !== void 0 && (z.error("  VOLTRO_DESTRUCTIVE_OK is set but did not cover this plan — it only relaxes"), z.error("  `lossy` operations, and only the tables it names. Anything else stays refused.")), 2;
+	if (c.acknowledged && z.warn(`db apply: proceeding with ${s.summary.blocked} acknowledged lossy operation(s) (VOLTRO_DESTRUCTIVE_OK)`), Ue(u, e)) return 2;
+	if (u.operations.length === 0) return z.info("db apply: schema is up to date — nothing to apply"), await Qe(a), l(e, "--note") !== void 0 && (z.warn("db apply: --note was ignored — an empty plan writes no history row to attach it to."), console.error("To record that the CURRENT live schema is the accepted baseline, use `voltro db drift --accept`.")), await Y(i, a), 0;
+	let d = l(e, "--note"), f = await q(a, b.SqlClient.pipe(g.flatMap((e) => C(e, u, {
 		declared: i,
 		appliedBy: process.env.USER ? `cli:${process.env.USER}` : "cli:user",
 		environment: (process.env.NODE_ENV ?? "dev").toLowerCase() === "staging" ? "staging" : "dev",
 		source: "auto-diff",
 		...d ? { notes: d } : {},
-		replan: () => g.promise(() => Y(a)).pipe(g.map((e) => E({
+		replan: () => g.promise(() => J(a)).pipe(g.map((e) => O({
 			declared: i,
 			live: e,
-			dialect: U(),
-			...w(),
+			dialect: G(),
+			...E(),
 			...n === void 0 ? {} : { onlineAfter: n }
 		})))
 	}))));
-	return L.info(`db apply: applied ${f.appliedOps} op(s) in ${f.durationMs}ms`, {
+	return z.info(`db apply: applied ${f.appliedOps} op(s) in ${f.durationMs}ms`, {
 		id: f.id,
 		fingerprint: f.fingerprint.slice(0, 16)
-	}), await X(i, a), 0;
-}, Ge = async (e) => {
-	let t = Math.max(1, Number(l(e, "--limit") ?? "20")), n = await J(await W(), b.SqlClient.pipe(g.flatMap((e) => e`
+	}), await Y(i, a), 0;
+}, Je = async (e) => {
+	let t = Math.max(1, Number(l(e, "--limit") ?? "20")), n = await q(await K(), b.SqlClient.pipe(g.flatMap((e) => e`
         SELECT ${e("id")}, ${e("fingerprint")}, ${e("operations")},
                ${e("appliedBy")}, ${e("environment")}, ${e("source")},
                ${e("durationMs")}, ${e("notes")}, ${e("appliedAt")}
@@ -841,25 +850,25 @@ var ve = class extends Error {
         ORDER BY ${e("appliedAt")} DESC
         LIMIT ${t}
       `)));
-	if (n.length === 0) return L.info("db plans: no planner-based migrations applied yet"), console.log("Run `voltro db apply` after a schema change to start a plan history."), 0;
+	if (n.length === 0) return z.info("db plans: no planner-based migrations applied yet"), console.log("Run `voltro db apply` after a schema change to start a plan history."), 0;
 	console.log(`\n${n.length} plan${n.length === 1 ? "" : "s"} (newest first):\n`);
 	for (let e of n) {
 		let t = 0;
 		try {
-			t = JSON.parse(Xe(e.operations)).length;
+			t = JSON.parse($e(e.operations)).length;
 		} catch {}
-		console.log(`  ${e.id}  fp=${D(e.fingerprint)}  env=${e.environment}  src=${e.source}  ${t} op(s)  ${e.durationMs}ms  ${$(e.appliedAt)}  by=${e.appliedBy}`), e.notes && console.log(`    [2mnote: ${e.notes}[0m`);
+		console.log(`  ${e.id}  fp=${k(e.fingerprint)}  env=${e.environment}  src=${e.source}  ${t} op(s)  ${e.durationMs}ms  ${Q(e.appliedAt)}  by=${e.appliedBy}`), e.notes && console.log(`    [2mnote: ${e.notes}[0m`);
 	}
 	return console.log(), 0;
-}, Ke = async (e) => {
+}, Ye = 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 W(), r = await J(n, b.SqlClient.pipe(g.flatMap((e) => e`SELECT ${e("id")}, ${e("operations")}
+	let n = await K(), r = await q(n, b.SqlClient.pipe(g.flatMap((e) => e`SELECT ${e("id")}, ${e("operations")}
                    FROM ${e("_voltro_migration_plans")} WHERE ${e("id")} = ${t}`)));
 	if (r.length === 0) return console.error(`restore-snapshot: plan '${t}' not found`), 1;
 	let i;
 	try {
-		i = JSON.parse(Xe(r[0].operations));
+		i = JSON.parse($e(r[0].operations));
 	} catch {
 		return console.error(`restore-snapshot: plan '${t}' has corrupted operations JSON`), 1;
 	}
@@ -873,7 +882,7 @@ var ve = class extends Error {
 	if (a.length === 0 && o.length === 0) return console.log(`restore-snapshot: plan '${t}' has no drop-column / drop-table ops to restore`), 0;
 	let s = 0;
 	for (let e of a) {
-		let t = await J(n, b.SqlClient.pipe(g.flatMap((t) => t`
+		let t = await q(n, b.SqlClient.pipe(g.flatMap((t) => t`
           SELECT column_name FROM information_schema.columns
           WHERE table_schema = 'public'
             AND table_name   = ${e.table}
@@ -885,11 +894,11 @@ var ve = class extends Error {
 			continue;
 		}
 		let r = t[0].column_name;
-		await J(n, b.SqlClient.pipe(g.flatMap((t) => t.unsafe(`ALTER TABLE "${e.table}" RENAME COLUMN "${r}" TO "${e.column}"`)))), s++, console.log(`  ↩ restored ${e.table}.${e.column} (from ${r})`);
+		await q(n, b.SqlClient.pipe(g.flatMap((t) => t.unsafe(`ALTER TABLE "${e.table}" RENAME COLUMN "${r}" TO "${e.column}"`)))), s++, console.log(`  ↩ restored ${e.table}.${e.column} (from ${r})`);
 	}
 	let c = 0;
 	for (let e of o) {
-		let t = await J(n, b.SqlClient.pipe(g.flatMap((t) => t`
+		let t = await q(n, b.SqlClient.pipe(g.flatMap((t) => t`
           SELECT table_name FROM information_schema.tables
           WHERE table_schema = 'public'
             AND table_name LIKE ${e.table + "__dropped_%"}
@@ -900,18 +909,18 @@ var ve = class extends Error {
 			continue;
 		}
 		let r = t[0].table_name;
-		await J(n, b.SqlClient.pipe(g.flatMap((t) => t.unsafe(`ALTER TABLE "${r}" RENAME TO "${e.table}"`)))), c++, console.log(`  ↩ restored table ${e.table} (from ${r})`);
+		await q(n, b.SqlClient.pipe(g.flatMap((t) => t.unsafe(`ALTER TABLE "${r}" RENAME TO "${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;
-}, qe = async (e) => {
+}, Xe = async (e) => {
 	let t = l(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, "");
 	if (n.length < 8) return console.error(`gc-snapshots: --before must be at least a full date (YYYY-MM-DD), got "${t}"`), 2;
-	let r = (n + "00000000000000").slice(0, 14), i = e.includes("--dry-run"), a = await W(), o = await J(a, b.SqlClient.pipe(g.flatMap((e) => e`
+	let r = (n + "00000000000000").slice(0, 14), i = e.includes("--dry-run"), a = await K(), o = await q(a, b.SqlClient.pipe(g.flatMap((e) => e`
         SELECT table_name, column_name FROM information_schema.columns
         WHERE table_schema = 'public' AND column_name LIKE ${"%__dropped_%"}
-      `))), s = await J(a, b.SqlClient.pipe(g.flatMap((e) => e`
+      `))), s = await q(a, b.SqlClient.pipe(g.flatMap((e) => e`
         SELECT table_name FROM information_schema.tables
         WHERE table_schema = 'public' AND table_name LIKE ${"%__dropped_%"}
       `))), c = (e) => {
@@ -920,37 +929,37 @@ var ve = class extends Error {
 	}, u = 0;
 	for (let e of o) {
 		let t = c(e.column_name);
-		t === null || t >= r || (console.log(`  ${i ? "[dry-run] would drop column" : "dropping column"} ${e.table_name}.${e.column_name}`), i || await J(a, b.SqlClient.pipe(g.flatMap((t) => t.unsafe(`ALTER TABLE "${e.table_name}" DROP COLUMN "${e.column_name}"`)))), u++);
+		t === null || t >= r || (console.log(`  ${i ? "[dry-run] would drop column" : "dropping column"} ${e.table_name}.${e.column_name}`), i || await q(a, b.SqlClient.pipe(g.flatMap((t) => t.unsafe(`ALTER TABLE "${e.table_name}" DROP COLUMN "${e.column_name}"`)))), u++);
 	}
 	for (let e of s) {
 		let t = c(e.table_name);
-		t === null || t >= r || (console.log(`  ${i ? "[dry-run] would drop table" : "dropping table"} ${e.table_name}`), i || await J(a, b.SqlClient.pipe(g.flatMap((t) => t.unsafe(`DROP TABLE "${e.table_name}"`)))), u++);
+		t === null || t >= r || (console.log(`  ${i ? "[dry-run] would drop table" : "dropping table"} ${e.table_name}`), i || await q(a, b.SqlClient.pipe(g.flatMap((t) => t.unsafe(`DROP TABLE "${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;
-}, Je = async (e) => {
+}, Ze = async (e) => {
 	let t = l(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 = l(e, "--note"), i = z(e), a = await Q(i);
-	if (a === void 0) return L.warn("db squash: no schema files found", { root: i }), 1;
-	let o = C(ce(a)), s = await W();
+	let r = l(e, "--note"), i = V(e), a = await Z(i);
+	if (a === void 0) return z.warn("db squash: no schema files found", { root: i }), 1;
+	let o = T(se(a)), s = await K();
 	try {
-		let e = await J(s, ge({
+		let e = await q(s, he({
 			before: n,
 			fingerprint: o,
 			appliedBy: process.env.USER ?? "cli",
 			environment: process.env.NODE_ENV === "production" ? "prod" : "dev",
 			...r === void 0 ? {} : { note: r }
 		}));
-		return console.log(`\n✓ squashed ${e.squashedCount} migration plan(s)\n  snapshot id: ${e.snapshotId}\n  fingerprint: ${D(e.snapshotFingerprint)}\n`), 0;
+		return console.log(`\n✓ squashed ${e.squashedCount} migration plan(s)\n  snapshot id: ${e.snapshotId}\n  fingerprint: ${k(e.snapshotFingerprint)}\n`), 0;
 	} catch (e) {
 		return console.error(`squash refused: ${e.message}`), 1;
 	}
-}, Ye = async (e) => {
+}, Qe = async (e) => {
 	try {
-		let t = C(await Y(e));
-		await J(e, b.SqlClient.pipe(g.flatMap((e) => e`
+		let t = T(await J(e));
+		await q(e, b.SqlClient.pipe(g.flatMap((e) => e`
           UPDATE ${e("_voltro_migration_plans")}
           SET ${e("liveFingerprint")} = ${t}
           WHERE ${e("id")} = (
@@ -962,7 +971,7 @@ var ve = class extends Error {
             AND ${e("liveFingerprint")} IS NULL
         `)));
 	} catch {}
-}, Xe = (e) => typeof e == "string" ? e : e == null ? "" : JSON.stringify(e), $ = (e) => e instanceof Date ? e.toISOString() : String(e ?? ""), Ze = (e) => e === void 0 ? {
+}, $e = (e) => typeof e == "string" ? e : e == null ? "" : JSON.stringify(e), Q = (e) => e instanceof Date ? e.toISOString() : String(e ?? ""), et = (e) => e === void 0 ? {
 	accept: !1,
 	reason: "no-declared-schema"
 } : e > 0 ? {
@@ -971,38 +980,38 @@ var ve = class extends Error {
 } : {
 	accept: !0,
 	reason: "converged"
-}, Qe = async (e) => {
-	let t = e.includes("--accept"), n = await W(), r = await J(n, b.SqlClient.pipe(g.flatMap((e) => e`
+}, tt = async (e) => {
+	let t = e.includes("--accept"), n = await K(), r = await q(n, b.SqlClient.pipe(g.flatMap((e) => e`
         SELECT * FROM ${e("_voltro_migration_plans")}
         ORDER BY ${e("appliedAt")} DESC
         LIMIT 1
-      `))), i = await Y(n), a = C(i);
-	if (r.length === 0) return L.info("db drift: no _voltro_migration_plans rows yet"), console.log(`live user-schema fingerprint: ${D(a)}`), console.log("No baseline to compare against. Run `voltro db apply` to lock in the current state."), 0;
+      `))), i = await J(n), a = T(i);
+	if (r.length === 0) return z.info("db drift: no _voltro_migration_plans rows yet"), console.log(`live user-schema fingerprint: ${k(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 L.warn("db drift: no drift baseline recorded yet — cannot compare"), console.log(), console.log(`  last applied:  ${o.id}  at ${$(o.appliedAt)}`), console.log(`  live now:      ${D(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 L.info(`db drift: live matches last applied (${D(a)})`), 0;
+	if (o.liveFingerprint === null || o.liveFingerprint === void 0) return z.warn("db drift: no drift baseline recorded yet — cannot compare"), console.log(), console.log(`  last applied:  ${o.id}  at ${Q(o.appliedAt)}`), console.log(`  live now:      ${k(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 z.info(`db drift: live matches last applied (${k(a)})`), 0;
 	let s = await (async () => {
 		try {
-			let t = await Q(z(e));
-			return t === void 0 ? void 0 : E({
+			let t = await Z(V(e));
+			return t === void 0 ? void 0 : O({
 				declared: t,
 				live: i,
-				dialect: U(),
-				...w()
+				dialect: G(),
+				...E()
 			}).operations;
 		} catch {
 			return;
 		}
 	})();
 	if (t) {
-		let e = Ze(s?.length);
-		if (e.reason === "no-declared-schema") return L.error("db drift --accept: no schema files found — cannot verify the live schema is current."), 1;
+		let e = et(s?.length);
+		if (e.reason === "no-declared-schema") return z.error("db drift --accept: no schema files found — cannot verify the live schema is current."), 1;
 		if (!e.accept && s !== void 0) {
-			L.error(`db drift --accept: refusing — ${s.length} operation(s) still pending against your declared schema.`), console.log();
+			z.error(`db drift --accept: refusing — ${s.length} operation(s) still pending against your declared schema.`), console.log();
 			for (let e of s.slice(0, 10)) console.log(`  - ${e.op.kind} ${"table" in e.op ? `[${e.op.table}]` : ""}`);
 			return s.length > 10 && console.log(`  … and ${s.length - 10} more`), console.log(), console.log("`--accept` records the CURRENT live schema as the applied baseline. It is for a"), console.log("change that already landed out of band and left the schema correct — not for one"), console.log("that has not landed. Run `voltro db apply` instead; it writes a real baseline."), 4;
 		}
-		return await J(n, b.SqlClient.pipe(g.flatMap((e) => e`
+		return await q(n, b.SqlClient.pipe(g.flatMap((e) => e`
           UPDATE ${e("_voltro_migration_plans")}
           SET ${e("liveFingerprint")} = ${a}
           WHERE ${e("id")} = (
@@ -1011,43 +1020,43 @@ var ve = class extends Error {
               ORDER BY ${e("appliedAt")} DESC LIMIT 1
             ) AS ${e("newest")}
           )
-        `))), L.info(`db drift: accepted the live schema as the baseline (${D(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;
+        `))), z.info(`db drift: accepted the live schema as the baseline (${k(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 L.error("db drift: live schema DIVERGED from last applied state"), console.log(), console.log(`  baseline:      ${D(o.liveFingerprint)}  at ${$(o.appliedAt)}  (${o.id})`), console.log(`  live now:      ${D(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);
-}, $e = async (e, t) => {
+	return z.error("db drift: live schema DIVERGED from last applied state"), console.log(), console.log(`  baseline:      ${k(o.liveFingerprint)}  at ${Q(o.appliedAt)}  (${o.id})`), console.log(`  live now:      ${k(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);
+}, nt = async (e, t) => {
 	let n = (process.env.NODE_ENV ?? "").toLowerCase() === "production" ? "prod" : (process.env.NODE_ENV ?? "").toLowerCase() === "staging" ? "staging" : "dev";
 	try {
-		let r = await J(t, b.SqlClient.pipe(g.flatMap((t) => he(t, {
+		let r = await q(t, b.SqlClient.pipe(g.flatMap((t) => me(t, {
 			projectRoot: e,
 			env: n,
 			appliedBy: process.env.USER ? `cli:${process.env.USER}` : "cli:user"
 		}))));
-		return r.applied.length > 0 && L.info(`db apply: applied ${r.applied.length} pending file-based migration(s) first`, { applied: r.applied.map((e) => `${e.id} (${e.durationMs}ms)`) }), { applied: r.applied.length };
+		return r.applied.length > 0 && z.info(`db apply: applied ${r.applied.length} pending file-based migration(s) first`, { applied: r.applied.map((e) => `${e.id} (${e.durationMs}ms)`) }), { applied: r.applied.length };
 	} catch (e) {
 		return { failed: e };
 	}
-}, et = async (e) => {
-	let t = z(e), n = await W(), r = (process.env.NODE_ENV ?? "").toLowerCase() === "production" ? "prod" : (process.env.NODE_ENV ?? "").toLowerCase() === "staging" ? "staging" : "dev";
-	await J(n, S(x, U()));
-	let i = await J(n, b.SqlClient.pipe(g.flatMap((e) => he(e, {
+}, rt = async (e) => {
+	let t = V(e), n = await K(), r = (process.env.NODE_ENV ?? "").toLowerCase() === "production" ? "prod" : (process.env.NODE_ENV ?? "").toLowerCase() === "staging" ? "staging" : "dev";
+	await q(n, w(x, G()));
+	let i = await q(n, b.SqlClient.pipe(g.flatMap((e) => me(e, {
 		projectRoot: t,
 		env: r,
 		appliedBy: process.env.USER ? `cli:${process.env.USER}` : "cli:user"
 	}))));
-	return i.applied.length === 0 ? (L.info(`db files: no pending file-based migrations (${i.skipped.length} already applied)`), 0) : (L.info(`db files: applied ${i.applied.length} migration(s)`, {
+	return i.applied.length === 0 ? (z.info(`db files: no pending file-based migrations (${i.skipped.length} already applied)`), 0) : (z.info(`db files: applied ${i.applied.length} migration(s)`, {
 		applied: i.applied.map((e) => `${e.id} (${e.durationMs}ms)`),
 		skipped: i.skipped.length
 	}), 0);
-}, tt = async (e) => {
-	let t = z(e), n = e.find((e) => !e.startsWith("--"));
-	if (!n) return L.error("voltro db rollback-file <migration-id>"), 2;
-	if ((process.env.NODE_ENV ?? "").toLowerCase() === "production") return L.error("voltro db rollback-file: refusing on prod — schema rollback runs as an explicit deploy step."), 3;
-	let r = await J(await W(), b.SqlClient.pipe(g.flatMap((e) => pe(e, {
+}, it = async (e) => {
+	let t = V(e), n = e.find((e) => !e.startsWith("--"));
+	if (!n) return z.error("voltro db rollback-file <migration-id>"), 2;
+	if ((process.env.NODE_ENV ?? "").toLowerCase() === "production") return z.error("voltro db rollback-file: refusing on prod — schema rollback runs as an explicit deploy step."), 3;
+	let r = await q(await K(), b.SqlClient.pipe(g.flatMap((e) => fe(e, {
 		projectRoot: t,
 		id: n
 	}))));
-	return L.info(`db rollback-file: rolled back ${r.id} in ${r.durationMs}ms`), 0;
-}, nt = () => {
+	return z.info(`db rollback-file: rolled back ${r.id} in ${r.durationMs}ms`), 0;
+}, at = () => {
 	let e = /* @__PURE__ */ new Date();
 	return [
 		e.getUTCFullYear(),
@@ -1057,7 +1066,7 @@ var ve = class extends Error {
 		String(e.getUTCMinutes()).padStart(2, "0"),
 		String(e.getUTCSeconds()).padStart(2, "0")
 	].join("");
-}, rt = (e) => e.trim().toLowerCase().replace(/[^a-z0-9]+/g, "_").replace(/^_+|_+$/g, "") || "migration", it = (e, t) => `import { defineMigration, SqlClient } from '@voltro/database'
+}, ot = (e) => e.trim().toLowerCase().replace(/[^a-z0-9]+/g, "_").replace(/^_+|_+$/g, "") || "migration", st = (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
@@ -1089,24 +1098,24 @@ export default defineMigration({
     }),
   ],
 })
-`, at = {
-	plan: He,
-	apply: We,
-	plans: Ge,
-	drift: Qe,
-	files: et,
-	"rollback-file": tt,
-	migrate: Ae,
-	rollback: je,
-	status: Me,
-	seed: Pe,
+`, $ = {
+	plan: Ge,
+	apply: qe,
+	plans: Je,
+	drift: tt,
+	files: rt,
+	"rollback-file": it,
+	migrate: ke,
+	rollback: Ae,
+	status: je,
+	seed: Ne,
 	generate: async (e) => {
-		let { value: t, rest: n } = c(e, "--root"), { value: r, rest: i } = c(n, "--name"), a = t ? m(t) : process.cwd(), o = rt(r ?? u(i) ?? "migration"), s = `${nt()}_${o}`, l = f(a, "migrations"), d = f(l, `${s}.migration.ts`);
-		return await v.mkdir(l, { recursive: !0 }), await v.writeFile(d, it(s, o), "utf8"), L.info(`created ${p(a, 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 } = c(e, "--root"), { value: r, rest: i } = c(n, "--name"), a = t ? m(t) : process.cwd(), o = ot(r ?? u(i) ?? "migration"), s = `${at()}_${o}`, l = f(a, "migrations"), d = f(l, `${s}.migration.ts`);
+		return await v.mkdir(l, { recursive: !0 }), await v.writeFile(d, st(s, o), "utf8"), z.info(`created ${p(a, 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: Je,
-	"restore-snapshot": Ke,
-	"gc-snapshots": qe,
+	squash: Ze,
+	"restore-snapshot": Ye,
+	"gc-snapshots": Xe,
 	adopt: async (e) => {
 		let t = (t) => {
 			let n = e.indexOf(`--${t}`);
@@ -1120,32 +1129,32 @@ export default defineMigration({
 			into: r,
 			map: o.map,
 			...o.leaveUnset ? { leaveUnset: o.leaveUnset } : {}
-		}, c = U(), l = await W(), u = await J(l, b.SqlClient.pipe(g.flatMap(T))), d = (e) => u.tables.find((t) => t.name === e)?.columns.map((e) => ({
+		}, c = G(), l = await K(), u = await q(l, b.SqlClient.pipe(g.flatMap(D))), d = (e) => u.tables.find((t) => t.name === e)?.columns.map((e) => ({
 			name: e.name,
 			nullable: e.nullable,
 			hasDefault: e.defaultValue !== void 0 && e.defaultValue !== null
 		})), 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 h = async (e) => await J(l, b.SqlClient.pipe(g.flatMap((t) => t.unsafe(e)))), _ = async (e) => Number(Object.values((await h(`SELECT COUNT(*) AS n FROM "${e}"`))[0] ?? { n: 0 })[0] ?? 0), v = xe(s, f, p, await _(r));
-		for (let e of Ce(s, v, await _(n))) console.log(e);
+		let h = async (e) => await q(l, b.SqlClient.pipe(g.flatMap((t) => t.unsafe(e)))), _ = async (e) => Number(Object.values((await h(`SELECT COUNT(*) AS n FROM "${e}"`))[0] ?? { n: 0 })[0] ?? 0), v = be(s, f, p, await _(r));
+		for (let e of Se(s, v, await _(n))) console.log(e);
 		if (v.fatal) return 1;
 		if (!e.includes("--apply")) return console.log(""), console.log("  (dry run — nothing written. Re-run with --apply.)"), 0;
-		let y = await Ee(s, v, c, "id", void 0, h, { keepSource: e.includes("--keep-source") });
+		let y = await Te(s, v, c, "id", void 0, h, { keepSource: e.includes("--keep-source") });
 		return console.log(""), console.log(`  copied ${y.copied}/${y.sourceRows} row(s)`), console.log(`  snapshot: ${y.snapshotTable}  — restore from here, then drop it yourself`), y.verified ? (console.log(y.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);
 	}
-}, ot = async (e) => {
+}, ct = async (e) => {
 	let [t, ...n] = e;
 	if (!t) {
 		console.error("voltro db <subcommand> [args]"), console.error("subcommands:");
-		for (let e of Object.keys(at)) console.error(`  ${e}`);
+		for (let e of Object.keys($)) console.error(`  ${e}`);
 		return 1;
 	}
-	let r = at[t];
+	let r = $[t];
 	if (!r) return console.error(`voltro db: unknown subcommand '${t}'`), 2;
-	(process.env.DB_DIRECT_URL !== void 0 || process.env.DB_MIGRATE_URL !== void 0) && L.info("using a DIRECT (non-pooler) connection for the db-command path (DB_DIRECT_URL/DB_MIGRATE_URL set)");
+	(process.env.DB_DIRECT_URL !== void 0 || process.env.DB_MIGRATE_URL !== void 0) && z.info("using a DIRECT (non-pooler) connection for the db-command path (DB_DIRECT_URL/DB_MIGRATE_URL set)");
 	let i = (e) => {
-		V(e) ? L.error(H) : console.error(e), process.exit(1);
+		U(e) ? z.error(W) : console.error(e), process.exit(1);
 	};
 	process.on("uncaughtException", i);
 	try {
@@ -1155,4 +1164,4 @@ export default defineMigration({
 	}
 };
 //#endregion
-export { K as a, ve as c, Ze as i, ye as l, B as n, V as o, G as r, ot as s, H as t };
+export { Ie as a, _e as c, et as i, ve as l, H as n, U as o, Fe as r, ct as s, W as t };