@voltro/cli 0.48.0 → 0.49.0

package/dist/{commands-CAxFLqG4.js → commands-a5PxCaIg.js}

@@ -1,16 +1,16 @@
-import { n as e, r as t, t as n } from "./subcommandNames-CKG5Dz3a.js";
-import { dirname as r, join as i, resolve as a } from "node:path";
-import { readFileSync as o } from "node:fs";
-import { fileURLToPath as s } from "node:url";
+import { i as e, n as t, r as n, t as r } from "./subcommandNames-DpYs3DXr.js";
+import { dirname as i, join as a, resolve as o } from "node:path";
+import { readFileSync as s } from "node:fs";
+import { fileURLToPath as c } from "node:url";
 //#region src/commands.ts
-var c = () => {
+var l = () => {
 	try {
-		let e = i(r(s(import.meta.url)), "..", "package.json");
-		return JSON.parse(o(e, "utf8")).version ?? "0.0.0";
+		let e = a(i(c(import.meta.url)), "..", "package.json");
+		return JSON.parse(s(e, "utf8")).version ?? "0.0.0";
 	} catch {
 		return "0.0.0";
 	}
-}, l = [
+}, u = [
 	{
 		name: "list-templates",
 		summary: "List available app templates (kind, summary, tags).",
@@ -91,7 +91,7 @@ var c = () => {
 		name: "dev",
 		summary: "Start the local development server (auto-discovers routes / mutations).",
 		status: "wired",
-		run: (e) => import("./dev-cGGsLNn6.js").then((t) => t.runDev(e)),
+		run: (e) => import("./dev-DFVuzOj7.js").then((t) => t.runDev(e)),
 		help: {
 			usage: "[app]",
 			examples: [["voltro dev", "boot the app in the current directory"], ["voltro dev apps/acme/api", "boot a specific app"]],
@@ -109,7 +109,7 @@ var c = () => {
 		name: "dashboard",
 		summary: "Serve the DevTools dashboard standalone (from @voltro/dashboard). Targets via VOLTRO_DASHBOARD_APPS; --port to override.",
 		status: "wired",
-		run: (e) => import("./dashboardCommand-CJC8Kg-s.js").then((t) => t.runDashboardCommand(e)),
+		run: (e) => import("./dashboardCommand-DaoUUqJS.js").then((t) => t.runDashboardCommand(e)),
 		help: {
 			usage: "[--port <n>]",
 			flags: [["--port <n>", "port to serve the dashboard on"]],
@@ -121,7 +121,7 @@ var c = () => {
 		name: "check",
 		summary: "Verify the app graph (blast-radius checks) against a running api; LLM-shaped --json diagnostics. Flags: --json, --process <p>, --diff removeTable:<name>.",
 		status: "wired",
-		run: (e) => import("./checkCommand-BUBqPBlI.js").then((t) => t.runCheckCommand(e)),
+		run: (e) => import("./checkCommand-udbQpphy.js").then((t) => t.runCheckCommand(e)),
 		help: {
 			usage: "[--json] [--offline] [--process <name>] [--diff removeTable:<name>]",
 			flags: [
@@ -155,7 +155,7 @@ var c = () => {
 		name: "webhooks",
 		summary: "Outbound-webhook artefacts. `consumer` generates the ZERO-DEPENDENCY Standard-Webhooks verification package a subscriber installs, from this app's own declared events; `events` lists the events a subscriber can register for. Usage: voltro webhooks <consumer|events> [path] [--out <dir>] [--name <pkg>] [--json].",
 		status: "wired",
-		run: (e) => import("./webhooksCommand-QlAk_tED.js").then((t) => t.runWebhooksCommand(e)),
+		run: (e) => import("./webhooksCommand-CwX9IzvJ.js").then((t) => t.runWebhooksCommand(e)),
 		help: {
 			usage: "<consumer|events> [path] [--out <dir>] [--name <pkg>] [--json]",
 			flags: [
@@ -171,7 +171,7 @@ var c = () => {
 		name: "evolve",
 		summary: "Schema-evolution copilot: propose an observed-graph-driven codemod + a branch-verified backfill for a schema change (rename/retype/split/drop a column, rename a table). Dry-run by default; --write applies. Usage: voltro evolve rename-column <table>.<col> --to <newName> [--write] [--json].",
 		status: "wired",
-		run: (e) => import("./evolveCommand-CQh6dw21.js").then((t) => t.runEvolveCommand(e)),
+		run: (e) => import("./evolveCommand-JDD3hE1i.js").then((t) => t.runEvolveCommand(e)),
 		help: {
 			usage: "<rename-column|rename-table|retype-column|split-column|drop-column> <target> [--to <new>] [--write]",
 			flags: [
@@ -188,7 +188,7 @@ var c = () => {
 		name: "codegen",
 		summary: "Emit rpcGroup.generated.ts from discovered route / mutation descriptors.",
 		status: "wired",
-		run: (e) => import("./codegenCommand-L6vacVRW.js").then((t) => t.runCodegenCommand(e)),
+		run: (e) => import("./codegenCommand-DApSH7hK.js").then((t) => t.runCodegenCommand(e)),
 		help: {
 			usage: "[app]",
 			examples: [["voltro codegen", "regenerate rpcGroup.generated.ts for the app in the cwd"]],
@@ -199,7 +199,7 @@ var c = () => {
 		name: "migrate",
 		summary: "Apply the declared schema to the database (alias of `db apply` — diffs declared vs live and emits the ALTERs). `--create-only` for the bootstrap-only CREATE TABLE IF NOT EXISTS path.",
 		status: "wired",
-		run: (e) => import("./migrate-CL5Ed01M.js").then((t) => t.runMigrateCommand(e)),
+		run: (e) => import("./migrate-D3MK9BpK.js").then((t) => t.runMigrateCommand(e)),
 		help: {
 			usage: "[app] [--create-only]",
 			flags: [["--create-only", "only CREATE TABLE IF NOT EXISTS — never ALTER (bootstrap)"]],
@@ -259,7 +259,7 @@ var c = () => {
 		name: "info",
 		summary: "Report versions (CLI, node, every installed @voltro/* — flags lockstep skew), package manager, and dialect. --json for CI. Exits 1 on version skew.",
 		status: "wired",
-		run: (e) => import("./infoCommand-CuNl9cbh.js").then((t) => t.runInfoCommand(e)),
+		run: (e) => import("./infoCommand-COsUC1DB.js").then((t) => t.runInfoCommand(e)),
 		help: {
 			usage: "[--json]",
 			flags: [["--json", "machine-readable report"]],
@@ -280,7 +280,7 @@ var c = () => {
 		name: "env",
 		summary: "Inspect/sync the typed-env manifest. Subcommands: check (default), sync (.env.example), types (env.generated.d.ts for CI tsc), turbo.",
 		status: "wired",
-		run: (e) => import("./envCommand-BHxKkGXq.js").then((t) => t.runEnvCommand(e)),
+		run: (e) => import("./envCommand-DtaJ4xEf.js").then((t) => t.runEnvCommand(e)),
 		help: {
 			usage: "[check|sync|types|turbo] [--force]",
 			flags: [["--force", "overwrite the generated file instead of refusing on a conflict"]],
@@ -309,12 +309,12 @@ var c = () => {
 		run: async (e) => {
 			let t = e.find((e) => !e.startsWith("-")) ?? process.cwd();
 			if (e.includes("--preflight")) {
-				let { runServePreflight: e } = await import("./doctorCommand-CWgUPye-.js");
-				return e(a(t), !0);
+				let { runServePreflight: e } = await import("./doctorCommand-CPL6EhrW.js");
+				return e(o(t), !0);
 			}
-			let { tryRunWebServe: n } = await import("./webDev-B79ji8M5.js"), r = await n(a(t));
+			let { tryRunWebServe: n } = await import("./webDev-B79ji8M5.js"), r = await n(o(t));
 			if (!r.ran) {
-				let { runServeDispatch: t } = await import("./serveCommand-ZP_Cb-yz.js");
+				let { runServeDispatch: t } = await import("./serveCommand-CzSDngKm.js");
 				return t(e);
 			}
 			return r.exitCode;
@@ -342,13 +342,13 @@ var c = () => {
 		handlesHelp: !0,
 		summary: "Preflight an app for production: the precompiled serve bundle, hand-rolled primitives (naming the shipped one), @voltro/* version skew, executors with no access check, `.serverOnly()` leaks, and junction-FK gaps.",
 		status: "wired",
-		run: (e) => import("./doctorCommand-CWgUPye-.js").then((t) => t.runDoctorCommand(e))
+		run: (e) => import("./doctorCommand-CPL6EhrW.js").then((t) => t.runDoctorCommand(e))
 	},
 	{
 		name: "build",
 		summary: "Production build for a web app (vite build + per-page SSG pre-render).",
 		status: "wired",
-		run: (e) => import("./build-DLme2ppa.js").then((t) => t.runBuildCommand(e)),
+		run: (e) => import("./build-Bi4O_g7T.js").then((t) => t.runBuildCommand(e)),
 		help: {
 			usage: "[app] [--target <t>]",
 			flags: [["--target <t>", "build target"]],
@@ -364,7 +364,7 @@ var c = () => {
 		name: "prune-runtime",
 		summary: "Trim a deployed web tree’s node_modules to the reachable runtime set (standalone image slimming).",
 		status: "wired",
-		run: (e) => import("./runtimeTrace-C0SlIoQY.js").then((t) => t.runPruneRuntimeCommand(e)),
+		run: (e) => import("./runtimeTrace-Di6fcndp.js").then((t) => t.runPruneRuntimeCommand(e)),
 		hidden: !0
 	},
 	{
@@ -382,7 +382,7 @@ var c = () => {
 		name: "dormancy",
 		summary: "Single-node scale-to-zero: front the API with a wake-orchestrator that stops the app when idle and brings it back on a request or a due wakeup (cron/workflow). Needs a SQL store. Flags: --port, --app-port, --idle-grace-ms, --tick-ms.",
 		status: "wired",
-		run: (e) => import("./dormancyCommand-CyIk-zq4.js").then((t) => t.runDormancyCommand(e)),
+		run: (e) => import("./dormancyCommand-QUXQ9yoz.js").then((t) => t.runDormancyCommand(e)),
 		help: {
 			usage: "[app] [--port <n>] [--app-port <n>] [--idle-grace-ms <n>] [--tick-ms <n>]",
 			flags: [
@@ -436,7 +436,7 @@ var c = () => {
 		status: "wired",
 		run: (e) => import("./privacyCommand-XejDMvmu.js").then((t) => t.runPrivacyCommand(e)),
 		help: {
-			usage: t(e),
+			usage: e(n),
 			examples: [
 				["voltro privacy scope --subject-table users", "every table a DSAR reaches, and every table it does not"],
 				["voltro privacy export usr_123 --url https://api.example.com", "the subject's portable bundle"],
@@ -453,9 +453,9 @@ var c = () => {
 		name: "db",
 		summary: "Database subcommands. Declarative flow: plan, apply, branch, plans, drift [--accept], squash, restore-snapshot. File migrations: generate [name], migrate, rollback, status, files, rollback-file. Data + housekeeping: seed, gc-snapshots, adopt. Credentials at rest: scan-credentials (find plaintext), encrypt-column (migrate a populated column onto .encrypted()).",
 		status: "wired",
-		run: (e) => import("./dbCommand-D1Q33ktl.js").then((t) => t.runDbCommand(e)),
+		run: (e) => import("./dbCommand-Bnl7MSGC.js").then((t) => t.runDbCommand(e)),
 		help: {
-			usage: t(n),
+			usage: e(t),
 			examples: [
 				["voltro db plan", "the diff between the declared schema and the live database"],
 				["voltro db apply", "apply that diff"],
@@ -467,22 +467,30 @@ var c = () => {
 	},
 	{
 		name: "data",
-		summary: "Export/import + backup/restore of app data. Logical (rows + optional assets): export <dir> [--tenant <id>|--tables a,b] [--assets] [--compression zstd|gzip|none] [--consistency live|snapshot]; import <dir> [--assets] [--no-verify]. Native (rows ONLY — no blobs): backup <dir> / restore <dir> (pg_dump/mariadb-dump/…). Resumable; typed-NDJSON; content-addressed assets on the logical path.",
+		summary: "Export/import + backup/restore of app data. Logical (rows + optional assets): export <dir> [--tenant <id>|--tables a,b|--exclude a,b] [--assets] [--compression zstd|gzip|none] [--consistency live|snapshot]; import <dir> [--assets] [--no-verify]; transfers — the history in both directions, including a run in flight; inspect <file|dir>; unpack <file> <dir>. Native (rows ONLY — no blobs): backup <dir> / restore <dir> (pg_dump/mariadb-dump/…). Recovery: clear-replace-marker, clear-staging. Resumable; typed-NDJSON; content-addressed assets on the logical path.",
 		status: "wired",
-		run: (e) => import("./dataCommand-hIaq2iKY.js").then((t) => t.runDataCommand(e)),
+		run: (e) => import("./dataCommand-CJv_OMoS.js").then((t) => t.runDataCommand(e)),
 		help: {
-			usage: "<export|import|backup|restore> <dir> [options]",
+			usage: e(r),
 			flags: [
 				["--tenant <id>", "export one tenant's rows"],
 				["--tables <a,b>", "restrict to these tables"],
 				["--assets", "include blobs (logical path only)"],
 				["--compression <zstd|gzip|none>", "archive compression"],
 				["--consistency <live|snapshot>", "read live, or from a consistent snapshot"],
+				["--mode <upsert|append|replace>", "what an import does to what is there — `replace` EMPTIES the target first"],
+				["--on-conflict <skip|fail>", "a row that collides with an existing one"],
 				["--no-verify", "skip checksum verification on import"],
 				["--dry-run", "report what would move, write nothing"],
+				["--max-request-seconds <n>", "cap EVERY request (--target api); the transfer still takes as long as it takes"],
+				["--detach", "start it and return — exit 0 means STARTED, not finished (--target api)"],
 				["--json", "machine-readable progress + result"]
 			],
-			examples: [["voltro data export ./dump --assets", "rows + blobs, resumable, typed NDJSON"], ["voltro data backup ./dump", "native dump (rows ONLY — no blobs)"]]
+			examples: [
+				["voltro data export ./dump --assets", "rows + blobs, resumable, typed NDJSON"],
+				["voltro data transfers", "what has moved through here, and what is moving right now"],
+				["voltro data backup ./dump", "native dump (rows ONLY — no blobs)"]
+			]
 		}
 	},
 	{
@@ -524,20 +532,20 @@ var c = () => {
 		handlesHelp: !0,
 		summary: "Upgrade the app to the latest framework: bump every @voltro/* dependency (across ALL workspace members, install once at the workspace root), then run the codemods shipped with the target version. Flags: --to <version>, --from <version>, --codemods-only, --dry-run, --force, --exact, --help. After: run `voltro db apply`.",
 		status: "wired",
-		run: (e) => import("./updateCommand-CT5AvVg7.js").then((t) => t.runUpdateCommand(e))
+		run: (e) => import("./updateCommand-CtYm7aKH.js").then((t) => t.runUpdateCommand(e))
 	},
 	{
 		name: "_apply-codemods",
 		summary: "Internal: apply shipped codemods for a framework version jump (re-exec target of `voltro update`).",
 		status: "wired",
 		hidden: !0,
-		run: (e) => import("./updateCommand-CT5AvVg7.js").then((t) => t.runApplyCodemods(e))
+		run: (e) => import("./updateCommand-CtYm7aKH.js").then((t) => t.runApplyCodemods(e))
 	},
 	{
 		name: "embeddings",
 		summary: "Embeddings tooling. Subcommand: backfill <table> --text <field> --vector <field> [--model <m>] [--model-field <f>] [--batch <n>] [--dry-run] — (re)embed rows the vectorEmbedding() mixin missed.",
 		status: "wired",
-		run: (e) => import("./embeddingsCommand-D7TLklps.js").then((t) => t.runEmbeddingsCommand(e)),
+		run: (e) => import("./embeddingsCommand-Zw1-rYSF.js").then((t) => t.runEmbeddingsCommand(e)),
 		help: {
 			usage: "backfill <table> --text <field> --vector <field> [--model <m>] [--batch <n>] [--dry-run]",
 			flags: [
@@ -664,15 +672,15 @@ var c = () => {
 		name: "help",
 		summary: "Print this help.",
 		status: "wired",
-		run: async (e) => (f(), 0)
+		run: async (e) => (p(), 0)
 	},
 	{
 		name: "version",
 		summary: "Print the voltro version.",
 		status: "wired",
-		run: async () => (console.log(c()), 0)
+		run: async () => (console.log(l()), 0)
 	}
-], u = [
+], d = [
 	["Start a project", [
 		"init",
 		"create-project",
@@ -740,32 +748,32 @@ var c = () => {
 		"info"
 	]],
 	["Meta", ["help", "version"]]
-], d = (e, t = 68) => {
+], f = (e, t = 68) => {
 	let n = e.search(/\.(\s|$)/), r = n > 0 ? e.slice(0, n) : e;
 	return r.length <= t ? r : `${r.slice(0, t - 1).trimEnd()}…`;
-}, f = () => {
-	let e = l.filter((e) => !e.hidden), t = new Map(e.map((e) => [e.name, e])), n = e.reduce((e, t) => Math.max(e, t.name.length), 0);
-	console.log(`voltro v${c()}`), console.log("voltro <command> [args]");
-	for (let [e, r] of u) {
+}, p = () => {
+	let e = u.filter((e) => !e.hidden), t = new Map(e.map((e) => [e.name, e])), n = e.reduce((e, t) => Math.max(e, t.name.length), 0);
+	console.log(`voltro v${l()}`), console.log("voltro <command> [args]");
+	for (let [e, r] of d) {
 		let i = r.map((e) => t.get(e)).filter((e) => e !== void 0);
 		if (i.length !== 0) {
 			console.log(`\n${e}`);
 			for (let e of i) {
 				let t = " ".repeat(n - e.name.length + 2);
-				console.log(`  ${e.name}${t}${d(e.summary)}`);
+				console.log(`  ${e.name}${t}${f(e.summary)}`);
 			}
 		}
 	}
-	let r = new Set(u.flatMap(([, e]) => e)), i = e.filter((e) => !r.has(e.name));
+	let r = new Set(d.flatMap(([, e]) => e)), i = e.filter((e) => !r.has(e.name));
 	if (i.length > 0) {
 		console.log("\nOther");
 		for (let e of i) {
 			let t = " ".repeat(n - e.name.length + 2);
-			console.log(`  ${e.name}${t}${d(e.summary)}`);
+			console.log(`  ${e.name}${t}${f(e.summary)}`);
 		}
 	}
 	console.log("\nRun 'voltro <command> --help' for the full description, or see https://voltro.dev/docs/cli.");
-}, p = (e, t) => {
+}, m = (e, t) => {
 	let n = Array.from({ length: t.length + 1 }, (e, t) => t), r = Array(t.length + 1).fill(0);
 	for (let i = 1; i <= e.length; i++) {
 		r[0] = i;
@@ -776,13 +784,13 @@ var c = () => {
 		for (let e = 0; e <= t.length; e++) n[e] = r[e];
 	}
 	return n[t.length];
-}, m = (e, t = 3) => {
-	let n = l.filter((e) => !e.hidden).map((e) => e.name), r = e.length <= 4 ? 1 : e.length <= 8 ? 2 : 3;
+}, h = (e, t = 3) => {
+	let n = u.filter((e) => !e.hidden).map((e) => e.name), r = e.length <= 4 ? 1 : e.length <= 8 ? 2 : 3;
 	return n.map((t) => ({
 		name: t,
-		score: t.startsWith(e) || e.startsWith(t) ? -2 : t.includes(e) ? -1 : p(e, t)
+		score: t.startsWith(e) || e.startsWith(t) ? -2 : t.includes(e) ? -1 : m(e, t)
 	})).filter((e) => e.score <= r).sort((e, t) => e.score - t.score || e.name.localeCompare(t.name)).slice(0, t).map((e) => e.name);
-}, h = (e) => {
+}, g = (e) => {
 	let t = [`voltro ${e.name} — ${e.summary}`], n = e.help, r = (e) => {
 		let t = e.reduce((e, [t]) => Math.max(e, t.length), 0);
 		return e.map(([e, n]) => `  ${e}${" ".repeat(t - e.length + 2)}${n}`);
@@ -792,26 +800,26 @@ var c = () => {
 		for (let [e, r] of n.examples) t.push(`  ${e}`, `      ${r}`);
 	}
 	return n?.notes !== void 0 && n.notes.length > 0 && t.push("", ...n.notes), t.push("", `Docs: https://voltro.dev/docs/cli/${e.name}`), t;
-}, g = /* @__PURE__ */ new Set(["--help", "-h"]), _ = async (e) => {
+}, _ = /* @__PURE__ */ new Set(["--help", "-h"]), v = async (e) => {
 	let [t, ...n] = e;
-	if (!t || g.has(t)) return f(), 0;
-	if (t === "--version" || t === "-v") return console.log(c()), 0;
-	if (t === "help" && n.length > 0 && !n[0].startsWith("-")) return _([n[0], "--help"]);
-	let r = l.find((e) => e.name === t);
+	if (!t || _.has(t)) return p(), 0;
+	if (t === "--version" || t === "-v") return console.log(l()), 0;
+	if (t === "help" && n.length > 0 && !n[0].startsWith("-")) return v([n[0], "--help"]);
+	let r = u.find((e) => e.name === t);
 	if (!r) {
 		console.error(`voltro: unknown command '${t}'`);
-		let e = m(t);
+		let e = h(t);
 		if (e.length > 0) {
 			console.error(`\nDid you mean${e.length > 1 ? " one of" : ""}?`);
 			for (let t of e) console.error(`    voltro ${t}`);
 		}
 		return console.error("\nrun 'voltro help' for available commands"), 2;
 	}
-	if (!r.handlesHelp && n.some((e) => g.has(e))) {
-		for (let e of h(r)) console.log(e);
+	if (!r.handlesHelp && n.some((e) => _.has(e))) {
+		for (let e of g(r)) console.log(e);
 		return 0;
 	}
 	return r.run(n);
 };
 //#endregion
-export { h as a, f as i, u as n, m as o, _ as r, l as t };
+export { g as a, p as i, d as n, h as o, v as r, u as t };

package/dist/{dashboardCommand-CJC8Kg-s.js → dashboardCommand-DaoUUqJS.js}

@@ -1,4 +1,4 @@
-import { d as e } from "./dev-lvnVq5RD.js";
+import { d as e } from "./dev-C31Nvlbv.js";
 import { H as t, z as n } from "./webDev-B4IEMB0n.js";
 import { t as r } from "./start-7HcSIKEp.js";
 import { join as i } from "node:path";