@voltro/cli 0.31.0 → 0.32.0

package/dist/{dbCommand-BH8GAYuf.js → dbCommand-ifOMafuG.js}

@@ -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 S, registerCoreTables as re } from "@voltro/database";
+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 ue, pendingFileMigrationIds as de, planMigrations as D, reactiveTriggerRepairSql as fe, rollbackFileBasedMigration as pe, rollingDeployUnsafeOps as me, runFileBasedMigrations as he, shortFingerprint as O, squashMigrationPlans as ge, unblockLossy as _e } from "@voltro/database/sql";
+import { DEFAULT_CDC_CHANNEL as ae, applyPlan as oe, applySchema as C, assessRollingDeployGate as se, declaredSnapshot as ce, destructiveScope as le, detectReactiveTriggerDrift as ue, fingerprintSchema as w, ignoreTablesFromEnv as T, introspectSchema as de, pendingFileMigrationIds as fe, planMigrations as E, reactiveTriggerRepairSql as pe, rollbackFileBasedMigration as me, rollingDeployUnsafeOps as he, runFileBasedMigrations as ge, shortFingerprint as D, squashMigrationPlans as _e, unblockLossy as ve } from "@voltro/database/sql";
 //#region src/cliError.ts
-var k = class extends Error {
+var O = class extends Error {
 	isCliError = !0;
 	code;
 	constructor(e, t = 1) {
 		super(e), this.name = "CliError", this.code = t;
 	}
-}, ve = (e) => typeof e == "object" && !!e && e.isCliError === !0, ye = (e) => typeof e != "string", be = (e, t, n, r) => {
+}, ye = (e) => typeof e == "object" && !!e && e.isCliError === !0, be = (e) => typeof e != "string", xe = (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 k = class extends Error {
 			});
 			continue;
 		}
-		if (ye(n)) {
+		if (be(n)) {
 			c.push({
 				target: t,
 				source: n.expr,
@@ -80,23 +80,23 @@ var k = class extends Error {
 		remintIds: f,
 		fatal: i.some((e) => e.fatal)
 	};
-}, xe = (e, t) => [
+}, Se = (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`
-], Se = (e, t, n) => {
+], Ce = (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 xe(e, t).entries()) r.push(`    ${n + 1}. ${i}`);
+	for (let [n, i] of Se(e, t).entries()) r.push(`    ${n + 1}. ${i}`);
 	return r;
-}, Ce = (e) => e === "mysql" || e === "mariadb" ? (e) => `\`${e}\`` : e === "mssql" ? (e) => `[${e}]` : (e) => `"${e}"`, we = (e) => `${e}__adopt_snapshot`, Te = (e, t, n, r, i) => {
-	let a = Ce(n), o = we(e.from), s = t.assignments.map((e) => e.target), c = t.assignments.map((e) => e.raw ? e.source : a(e.source));
+}, we = (e) => e === "mysql" || e === "mariadb" ? (e) => `\`${e}\`` : e === "mssql" ? (e) => `[${e}]` : (e) => `"${e}"`, Te = (e) => `${e}__adopt_snapshot`, Ee = (e, t, n, r, i) => {
+	let a = we(n), o = Te(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 k = class extends Error {
 		drop: `DROP TABLE ${a(e.from)}`,
 		dropSnapshot: `DROP TABLE ${a(o)}`
 	};
-}, A = (e) => {
+}, De = (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 = {}) => {
+}, Oe = 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 = we(e.from), l = A(await a(s.verifySource));
+	let s = Ee(e, t, n, r, i), c = Te(e.from), l = De(await a(s.verifySource));
 	await a(s.snapshot);
 	for (let e of s.translations) await a(e);
 	await a(s.copy);
-	let u = A(await a(s.verifyTarget));
+	let u = De(await a(s.verifyTarget));
 	return u === l ? o.keepSource === !0 ? {
 		copied: u,
 		sourceRows: l,
@@ -137,7 +137,7 @@ var k = class extends Error {
 		snapshotTable: c,
 		sourceDropped: !1
 	};
-}, De = [
+}, k = [
 	"token",
 	"secret",
 	"password",
@@ -146,7 +146,7 @@ var k = class extends Error {
 	"credential",
 	"privatekey",
 	"private_key"
-], Oe = [
+], ke = [
 	{
 		table: "_voltro_audit_log",
 		column: "subject"
@@ -191,7 +191,7 @@ var k = class extends Error {
 		table: "_voltro_row_history",
 		column: "subjectId"
 	}
-], ke = (e, t) => {
+], Ae = (e, t) => {
 	switch (t) {
 		case "postgres": return `LOWER(CAST(${e} AS text))`;
 		case "mysql":
@@ -200,7 +200,7 @@ var k = class extends Error {
 		case "sqlite":
 		case "turso": return `LOWER(CAST(${e} AS TEXT))`;
 	}
-}, Ae = (e, t, n = De) => n.map((n) => `${ke(e, t)} LIKE '%${n}%'`).join("\n     OR "), je = async (e, t) => {
+}, je = (e, t, n = k) => n.map((n) => `${Ae(e, t)} LIKE '%${n}%'`).join("\n     OR "), A = async (e, t) => {
 	let n = await g.runPromise(e.unsafe(t));
 	return Number(Object.values(n[0] ?? { n: 0 })[0] ?? 0);
 }, Me = async (e, t, n, r) => {
@@ -208,7 +208,7 @@ var k = class extends Error {
 	for (let a of n) {
 		let n = r(a.table), o;
 		try {
-			o = await je(e, `SELECT COUNT(*) AS n FROM ${n}`);
+			o = await A(e, `SELECT COUNT(*) AS n FROM ${n}`);
 		} catch {
 			i.push({
 				table: a.table,
@@ -220,12 +220,20 @@ var k = class extends Error {
 			continue;
 		}
 		try {
-			let s = await je(e, `SELECT COUNT(*) AS n FROM ${n}\n   WHERE ${Ae(r(a.column), t)}`);
+			let s = await A(e, `SELECT COUNT(*) AS n FROM ${n}\n   WHERE ${je(r(a.column), t)}`), c = [];
+			if (s > 0) for (let i of k) try {
+				let o = await A(e, `SELECT COUNT(*) AS n FROM ${n}\n   WHERE ${je(r(a.column), t, [i])}`);
+				o > 0 && c.push({
+					needle: i,
+					rows: o
+				});
+			} catch {}
 			i.push({
 				table: a.table,
 				column: a.column,
 				scanned: o,
-				hits: s
+				hits: s,
+				matchedNeedles: c
 			});
 		} catch {
 			i.push({
@@ -239,25 +247,25 @@ var k = class extends Error {
 	}
 	return i;
 }, Ne = (e, t) => {
-	let n = [`credential scan · dialect ${t}`, ""], r = /* @__PURE__ */ new Set();
+	let n = k.length, r = [`credential scan · dialect ${t}`, ""], i = /* @__PURE__ */ new Set();
 	for (let t of e) {
 		if (t.unavailable === "column") {
-			n.push(`  ·  ${t.table}.${t.column} — column is not present on this deployment (${t.scanned} row(s) exist but this column was not scanned)`);
+			r.push(`  ·  ${t.table}.${t.column} — column is not present on this deployment (${t.scanned} row(s) exist but this column was not scanned)`);
 			continue;
 		}
 		if (t.scanned === void 0) {
-			r.has(t.table) || (r.add(t.table), n.push(`  ·  ${t.table} — table not present (nothing scanned)`));
+			i.has(t.table) || (i.add(t.table), r.push(`  ·  ${t.table} — table not present (nothing scanned)`));
 			continue;
 		}
 		if (t.scanned === 0) {
-			n.push(`  ·  ${t.table} — table is EMPTY (0 rows scanned; this is not a clean bill of health)`);
+			r.push(`  ·  ${t.table} — table is EMPTY (0 rows scanned; this is not a clean bill of health)`);
 			continue;
 		}
 		let e = (t.hits ?? 0) > 0 ? "✗" : "✓";
-		n.push(`  ${e}  ${t.table}.${t.column} — ${t.hits} of ${t.scanned} row(s) match a credential-shaped key`);
+		r.push(`  ${e}  ${t.table}.${t.column} — ${t.hits} of ${t.scanned} row(s) match a credential-shaped key`), (t.matchedNeedles?.length ?? 0) > 0 && r.push(`         matched (rows per needle, may overlap): ${t.matchedNeedles.map((e) => `${e.needle} (${e.rows})`).join(", ")}`);
 	}
-	let i = e.reduce((e, t) => e + (t.hits ?? 0), 0);
-	return n.push(""), i > 0 ? n.push(`  ${i} 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) ? n.push("  NOTHING WAS SCANNED. This run proves nothing about your data.") : n.push("  No credential-shaped keys found in the rows that exist."), n.push("", "  Run this on EVERY environment. A dev database is not a sample of production."), n.join("\n");
+	let a = e.reduce((e, t) => e + (t.hits ?? 0), 0);
+	return r.push(""), 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 key 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");
 }, Pe = (e) => e.some((e) => (e.hits ?? 0) > 0) ? 1 : e.every((e) => e.unavailable !== void 0 || e.scanned === void 0 || e.scanned === 0) ? 2 : 0, j = /\.migration\.ts$/, M = async (e, t) => {
 	let n = [];
 	for (let r of e) {
@@ -268,7 +276,7 @@ var k = 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;
@@ -288,7 +296,7 @@ var k = class extends Error {
 	return [...n].sort((e, t) => e.definition.id < t.definition.id ? -1 : 1);
 }, N = (e) => {
 	let t = (process.env.DB_DIALECT ?? "postgres").toLowerCase(), n = t === "memory" ? "postgres" : t;
-	return g.runPromise(w(x, n).pipe(g.provide(e)));
+	return g.runPromise(C(x, n).pipe(g.provide(e)));
 }, P = (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]));
@@ -560,9 +568,9 @@ var k = class extends Error {
 	return /ERR_OUT_OF_RANGE|out of range/i.test(n) && /pg-protocol|parseDataRow|buffer-reader|BufferReader/i.test(n);
 }, U = "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 k("voltro db: subcommands require a real dialect, not DB_DIALECT=memory.");
+	if (e === "memory") throw new O("voltro db: subcommands require a real dialect, not DB_DIALECT=memory.");
 	return e;
-}, G = (e) => S(e, W()), K = (e) => e === "mysql" || e === "mariadb" ? "table_schema = DATABASE()" : e === "mssql" ? "table_schema = SCHEMA_NAME()" : "table_schema = 'public'", q = async () => (await r(W())).makeSqlLayer(V()), Re = async (e) => {
+}, G = (e) => ne(e, W()), K = (e) => e === "mysql" || e === "mariadb" ? "table_schema = DATABASE()" : e === "mssql" ? "table_schema = SCHEMA_NAME()" : "table_schema = 'public'", q = async () => (await r(W())).makeSqlLayer(V()), Re = async (e) => {
 	let t = B(e), n = e.includes("--dry-run"), r = await M(await z(t, j), R);
 	if (r.length === 0) return R.info("no migrations found", { root: t }), 0;
 	if (n) {
@@ -667,19 +675,19 @@ var k = class extends Error {
 	}
 	return [...t.values()];
 }, qe = (e) => {
-	let t = ce(process.env.VOLTRO_DESTRUCTIVE_OK);
+	let t = le(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 = ve(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) => {
 	try {
-		return await J(e, b.SqlClient.pipe(g.flatMap(ue)));
+		return await J(e, b.SqlClient.pipe(g.flatMap(de)));
 	} catch (e) {
 		let t = String(e?.message ?? e);
 		if (H(e) || /connection error/i.test(t)) {
@@ -771,7 +779,7 @@ var k = 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 ${S(i, W())}`))));
+			let e = await J(t, b.SqlClient.pipe(g.flatMap((e) => e.unsafe(`SELECT COUNT(*) AS n FROM ${ne(i, W())}`))));
 			o = Number(Object.values(e[0] ?? { n: 0 })[0] ?? 0);
 		} catch {
 			continue;
@@ -787,11 +795,11 @@ var k = class extends Error {
 	if (W() !== "postgres") return;
 	let n = ae, r;
 	try {
-		r = await J(t, b.SqlClient.pipe(g.flatMap((t) => le(t, e, n))));
+		r = await J(t, b.SqlClient.pipe(g.flatMap((t) => ue(t, e, n))));
 	} catch {
 		return;
 	}
-	let i = fe({
+	let i = pe({
 		tables: e,
 		dialect: "postgres",
 		missing: r.missing,
@@ -815,17 +823,17 @@ var k = class extends Error {
 	for (let t of e.operations) console.log(Ye(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`), Ze(e);
 }, Ze = (e) => {
-	let t = me(e.operations);
+	let t = he(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");
 	}
 }, Qe = (e, t) => {
-	let n = oe({
+	let n = se({
 		enabled: process.env.VOLTRO_ROLLING_DEPLOY === "1",
 		forced: t.includes("--force"),
-		unsafeCount: me(e.operations).length
+		unsafeCount: he(e.operations).length
 	});
 	return n.refuse ? (R.error(`db apply: ${n.message}`), !0) : (n.warnForced && R.warn(`db apply: ${n.message}`), !1);
 }, $e = (e) => {
@@ -858,11 +866,11 @@ var k = class extends Error {
 			if (!i.ok) return R.error(`db plan --against: remote returned ${i.status}`, { url: e }), 1;
 			let a = (await i.json()).drift?.liveSnapshot;
 			if (!a) return R.error("db plan --against: remote inspect payload missing drift.liveSnapshot", { url: e }), 1;
-			let s = D({
+			let s = E({
 				declared: r,
 				live: a,
 				dialect: W(),
-				...E(),
+				...T(),
 				...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;
@@ -870,11 +878,11 @@ var k = class extends Error {
 			return R.error(`db plan --against: ${e.message}`), 1;
 		}
 	}
-	let a = D({
+	let a = E({
 		declared: r,
 		live: await Y(await q()),
 		dialect: W(),
-		...E(),
+		...T(),
 		...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);
@@ -890,14 +898,14 @@ var k = class extends Error {
 	let i = await Q(n);
 	if (i === void 0) return R.warn("db apply --plan: no schema files found", { root: n }), 1;
 	let a = await q();
-	await J(a, w(x, W()));
-	let o = await J(a, b.SqlClient.pipe(g.flatMap((e) => de(e, n)))).catch(() => []);
+	await J(a, C(x, W()));
+	let o = await J(a, b.SqlClient.pipe(g.flatMap((e) => fe(e, n)))).catch(() => []);
 	if (o.length > 0) return R.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 = D({
+	let s = E({
 		declared: i,
 		live: await Y(a),
 		dialect: W(),
-		...E()
+		...T()
 	});
 	if (s.fromFingerprint !== r.fromFingerprint) return R.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 R.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;
@@ -906,17 +914,17 @@ var k = class extends Error {
 	if (c.acknowledged && R.warn("db apply --plan: proceeding with acknowledged lossy operation(s) (VOLTRO_DESTRUCTIVE_OK)"), Qe(u, t)) return 2;
 	if (u.operations.length === 0) return R.info("db apply --plan: schema is up to date — no DDL to apply (change triggers are reconciled separately below)"), 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) => C(e, u, {
+	let d = (process.env.NODE_ENV ?? "dev").toLowerCase(), f = l(t, "--note"), p = await J(a, b.SqlClient.pipe(g.flatMap((e) => oe(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) => D({
+		replan: () => g.promise(() => Y(a)).pipe(g.map((e) => E({
 			declared: i,
 			live: e,
 			dialect: W(),
-			...E()
+			...T()
 		})))
 	}))));
 	return R.info(`db apply --plan: applied ${p.appliedOps} op(s) in ${p.durationMs}ms`, {
@@ -931,12 +939,12 @@ var k = class extends Error {
 	if (i === void 0) return R.warn("db apply: no schema files found", { root: t }), 1;
 	let a = await q(), o = await dt(t, a);
 	if ("failed" in o) return R.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, w(x, W()));
-	let s = D({
+	await J(a, C(x, W()));
+	let s = E({
 		declared: i,
 		live: await Y(a),
 		dialect: W(),
-		...E(),
+		...T(),
 		...n === void 0 ? {} : { onlineAfter: n }
 	});
 	Z(s), await Xe(s, a);
@@ -944,17 +952,17 @@ var k = class extends Error {
 	if (u.summary.blocked > 0 && !c.acknowledged) return R.error(`db apply: refusing — ${u.summary.blocked} blocked operation(s). See the fix hints above.`), process.env.VOLTRO_DESTRUCTIVE_OK !== void 0 && (R.error("  VOLTRO_DESTRUCTIVE_OK is set but did not cover this plan — it only relaxes"), R.error("  `lossy` operations, and only the tables it names. Anything else stays refused.")), 2;
 	if (c.acknowledged && R.warn(`db apply: proceeding with ${s.summary.blocked} acknowledged lossy operation(s) (VOLTRO_DESTRUCTIVE_OK)`), Qe(u, e)) return 2;
 	if (u.operations.length === 0) return R.info("db apply: schema is up to date — no DDL to apply (change triggers are reconciled separately below)"), await st(a), l(e, "--note") !== void 0 && (R.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) => C(e, u, {
+	let d = l(e, "--note"), f = await J(a, b.SqlClient.pipe(g.flatMap((e) => oe(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) => D({
+		replan: () => g.promise(() => Y(a)).pipe(g.map((e) => E({
 			declared: i,
 			live: e,
 			dialect: W(),
-			...E(),
+			...T(),
 			...n === void 0 ? {} : { onlineAfter: n }
 		})))
 	}))));
@@ -978,7 +986,7 @@ var k = class extends Error {
 		try {
 			t = JSON.parse(ct(e.operations)).length;
 		} catch {}
-		console.log(`  ${e.id}  fp=${O(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=${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`);
 	}
 	return console.log(), 0;
 }, it = async (e) => {
@@ -1064,22 +1072,22 @@ var k = class extends Error {
 	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 = B(e), a = await Q(i);
 	if (a === void 0) return R.warn("db squash: no schema files found", { root: i }), 1;
-	let o = T(se(a)), s = await q();
+	let o = w(ce(a)), s = await q();
 	try {
-		let e = await J(s, ge({
+		let e = await J(s, _e({
 			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: ${O(e.snapshotFingerprint)}\n`), 0;
+		return console.log(`\n✓ squashed ${e.squashedCount} migration plan(s)\n  snapshot id: ${e.snapshotId}\n  fingerprint: ${D(e.snapshotFingerprint)}\n`), 0;
 	} catch (e) {
 		return console.error(`squash refused: ${e.message}`), 1;
 	}
 }, st = async (e) => {
 	try {
-		let t = T(await Y(e));
+		let t = w(await Y(e));
 		await J(e, b.SqlClient.pipe(g.flatMap((e) => e`
           UPDATE ${e("_voltro_migration_plans")}
           SET ${e("liveFingerprint")} = ${t}
@@ -1106,19 +1114,19 @@ var k = class extends Error {
         SELECT * FROM ${e("_voltro_migration_plans")}
         ORDER BY ${e("appliedAt")} DESC
         LIMIT 1
-      `))), i = await Y(n), a = T(i);
-	if (r.length === 0) return R.info("db drift: no _voltro_migration_plans rows yet"), console.log(`live user-schema fingerprint: ${O(a)}`), console.log("No baseline to compare against. Run `voltro db apply` to lock in the current state."), 0;
+      `))), i = await Y(n), a = w(i);
+	if (r.length === 0) return R.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;
 	let o = r[0];
-	if (o.liveFingerprint === null || o.liveFingerprint === void 0) return R.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:      ${O(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 R.info(`db drift: live matches last applied (${O(a)})`), 0;
+	if (o.liveFingerprint === null || o.liveFingerprint === void 0) return R.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 R.info(`db drift: live matches last applied (${D(a)})`), 0;
 	let s = await (async () => {
 		try {
 			let t = await Q(B(e));
-			return t === void 0 ? void 0 : D({
+			return t === void 0 ? void 0 : E({
 				declared: t,
 				live: i,
 				dialect: W(),
-				...E()
+				...T()
 			}).operations;
 		} catch {
 			return;
@@ -1141,13 +1149,13 @@ var k = class extends Error {
               ORDER BY ${e("appliedAt")} DESC LIMIT 1
             ) AS ${e("newest")}
           )
-        `))), R.info(`db drift: accepted the live schema as the baseline (${O(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;
+        `))), R.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;
 	}
-	return R.error("db drift: live schema DIVERGED from last applied state"), console.log(), console.log(`  baseline:      ${O(o.liveFingerprint)}  at ${$(o.appliedAt)}  (${o.id})`), console.log(`  live now:      ${O(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);
+	return R.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);
 }, dt = 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 J(t, b.SqlClient.pipe(g.flatMap((t) => ge(t, {
 			projectRoot: e,
 			env: n,
 			appliedBy: process.env.USER ? `cli:${process.env.USER}` : "cli:user"
@@ -1158,8 +1166,8 @@ var k = class extends Error {
 	}
 }, ft = async (e) => {
 	let t = B(e), n = await q(), r = (process.env.NODE_ENV ?? "").toLowerCase() === "production" ? "prod" : (process.env.NODE_ENV ?? "").toLowerCase() === "staging" ? "staging" : "dev";
-	await J(n, w(x, W()));
-	let i = await J(n, b.SqlClient.pipe(g.flatMap((e) => he(e, {
+	await J(n, C(x, W()));
+	let i = await J(n, b.SqlClient.pipe(g.flatMap((e) => ge(e, {
 		projectRoot: t,
 		env: r,
 		appliedBy: process.env.USER ? `cli:${process.env.USER}` : "cli:user"
@@ -1172,7 +1180,7 @@ var k = class extends Error {
 	let t = B(e), n = e.find((e) => !e.startsWith("--"));
 	if (!n) return R.error("voltro db rollback-file <migration-id>"), 2;
 	if ((process.env.NODE_ENV ?? "").toLowerCase() === "production") return R.error("voltro db rollback-file: refusing on prod — schema rollback runs as an explicit deploy step."), 3;
-	let r = await J(await q(), b.SqlClient.pipe(g.flatMap((e) => pe(e, {
+	let r = await J(await q(), b.SqlClient.pipe(g.flatMap((e) => me(e, {
 		projectRoot: t,
 		id: n
 	}))));
@@ -1250,18 +1258,18 @@ export default defineMigration({
 			into: r,
 			map: o.map,
 			...o.leaveUnset ? { leaveUnset: o.leaveUnset } : {}
-		}, c = W(), l = await q(), u = await J(l, b.SqlClient.pipe(g.flatMap(ue))), d = (e) => u.tables.find((t) => t.name === e)?.columns.map((e) => ({
+		}, c = W(), l = await q(), u = await J(l, b.SqlClient.pipe(g.flatMap(de))), 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 = be(s, f, p, await _(r));
-		for (let e of Se(s, v, await _(n))) console.log(e);
+		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);
 		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 Oe(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);
 	},
 	"scan-credentials": async (e) => {
@@ -1269,14 +1277,14 @@ export default defineMigration({
 		for (let t = 0; t < e.length; t += 1) {
 			if (e[t] !== "--table") continue;
 			let r = e[t + 1];
-			if (r === void 0) throw new k("voltro db scan-credentials: --table needs a value");
+			if (r === void 0) throw new O("voltro db scan-credentials: --table needs a value");
 			let [i, a = "subject"] = r.split(":");
 			n.push({
 				table: i,
 				column: a
 			});
 		}
-		let r = [...Oe, ...n], i = await J(await q(), b.SqlClient.pipe(g.flatMap((e) => g.promise(() => Me(e, t, r, G)))));
+		let r = [...ke, ...n], i = await J(await q(), b.SqlClient.pipe(g.flatMap((e) => g.promise(() => Me(e, t, r, G)))));
 		return console.log(Ne(i, t)), Pe(i);
 	}
 }, vt = async (e) => {
@@ -1300,4 +1308,4 @@ export default defineMigration({
 	}
 };
 //#endregion
-export { Ge as a, k as c, lt as i, ve as l, V as n, H as o, We as r, vt as s, U as t };
+export { Ge as a, O as c, lt as i, ye as l, V as n, H as o, We as r, vt as s, U as t };