@voltro/cli 0.55.0 → 0.57.0

package/dist/{commands-BBYJ7Q3B.js → commands-CRbxgxv0.js}

@@ -91,7 +91,7 @@ var u = () => {
 		name: "dev",
 		summary: "Start the local development server (auto-discovers routes / mutations).",
 		status: "wired",
-		run: (e) => import("./dev-DfVZaoys.js").then((t) => t.runDev(e)),
+		run: (e) => import("./dev-Bl9HqtV7.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 u = () => {
 		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-D2kmyCLL.js").then((t) => t.runDashboardCommand(e)),
+		run: (e) => import("./dashboardCommand-Bf_-Ne3P.js").then((t) => t.runDashboardCommand(e)),
 		help: {
 			usage: "[--port <n>]",
 			flags: [["--port <n>", "port to serve the dashboard on"]],
@@ -121,7 +121,7 @@ var u = () => {
 		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-DNkY5kwF.js").then((t) => t.runCheckCommand(e)),
+		run: (e) => import("./checkCommand-BISqx1OJ.js").then((t) => t.runCheckCommand(e)),
 		help: {
 			usage: "[--json] [--offline] [--process <name>] [--diff removeTable:<name>]",
 			flags: [
@@ -155,7 +155,7 @@ var u = () => {
 		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-B1LVcyO3.js").then((t) => t.runWebhooksCommand(e)),
+		run: (e) => import("./webhooksCommand-CYXTNvXq.js").then((t) => t.runWebhooksCommand(e)),
 		help: {
 			usage: "<consumer|events> [path] [--out <dir>] [--name <pkg>] [--json]",
 			flags: [
@@ -171,7 +171,7 @@ var u = () => {
 		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-BsbZ-XDg.js").then((t) => t.runEvolveCommand(e)),
+		run: (e) => import("./evolveCommand-Db30twUy.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 u = () => {
 		name: "codegen",
 		summary: "Emit rpcGroup.generated.ts from discovered route / mutation descriptors.",
 		status: "wired",
-		run: (e) => import("./codegenCommand-3TDJezom.js").then((t) => t.runCodegenCommand(e)),
+		run: (e) => import("./codegenCommand-DnVuDxwT.js").then((t) => t.runCodegenCommand(e)),
 		help: {
 			usage: "[app]",
 			examples: [["voltro codegen", "regenerate rpcGroup.generated.ts for the app in the cwd"]],
@@ -221,7 +221,7 @@ var u = () => {
 		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-CGFZS-1a.js").then((t) => t.runMigrateCommand(e)),
+		run: (e) => import("./migrate-DtC3lu7H.js").then((t) => t.runMigrateCommand(e)),
 		help: {
 			usage: "[app] [--create-only]",
 			flags: [["--create-only", "only CREATE TABLE IF NOT EXISTS — never ALTER (bootstrap)"]],
@@ -233,7 +233,7 @@ var u = () => {
 		name: "test",
 		summary: "Run vitest against the app at the cwd (auto-discovers *.test.ts/tsx).",
 		status: "wired",
-		run: (e) => import("./test-DO27-x2P.js").then((t) => t.runTestCommand(e)),
+		run: (e) => import("./test-jipIQ5Mx.js").then((t) => t.runTestCommand(e)),
 		help: {
 			usage: "[dir] [filter…] [--watch] [-t <pattern>]",
 			flags: [
@@ -281,7 +281,7 @@ var u = () => {
 		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-EmM3jPKD.js").then((t) => t.runInfoCommand(e)),
+		run: (e) => import("./infoCommand-BjVXpMlP.js").then((t) => t.runInfoCommand(e)),
 		help: {
 			usage: "[--json]",
 			flags: [["--json", "machine-readable report"]],
@@ -302,7 +302,7 @@ var u = () => {
 		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-Bxy2fOjc.js").then((t) => t.runEnvCommand(e)),
+		run: (e) => import("./envCommand-UJmJIbs9.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"]],
@@ -326,17 +326,17 @@ var u = () => {
 	},
 	{
 		name: "serve",
-		summary: "Production server: web app (vite preview) OR API (rpc + tenant scope + audit atomicity), auto-detected.",
+		summary: "Production server for an API app (rpc + tenant scope + audit atomicity). A WEB app is served by `voltro start`.",
 		status: "wired",
 		run: async (e) => {
 			let t = e.find((e) => !e.startsWith("-")) ?? process.cwd();
 			if (e.includes("--preflight")) {
-				let { runServePreflight: e } = await import("./doctorCommand-djmqEcDC.js");
+				let { runServePreflight: e } = await import("./doctorCommand-DrQv9SL3.js");
 				return e(s(t), !0);
 			}
-			let { tryRunWebServe: n } = await import("./webDev-1XpVnYkW.js"), r = await n(s(t));
+			let { tryRunWebServe: n } = await import("./webDev-B6ZMX42w.js"), r = await n(s(t));
 			if (!r.ran) {
-				let { runServeDispatch: t } = await import("./serveCommand-Cjt5S9hD.js");
+				let { runServeDispatch: t } = await import("./serveCommand-Dtb48ffg.js");
 				return t(e);
 			}
 			return r.exitCode;
@@ -344,8 +344,8 @@ var u = () => {
 		help: {
 			usage: "[app] [--preflight]",
 			flags: [["--preflight", "check serve-bundle readiness and exit 1 if it is missing — never boots"]],
-			examples: [["voltro serve", "production server for the app in the cwd (api or web, auto-detected)"], ["voltro serve . --preflight", "a Dockerfile/CI gate that catches \"prod serve, no build\""]],
-			notes: ["In production a precompiled bundle is MANDATORY — run `voltro build` first."]
+			examples: [["voltro serve", "production API server for the app in the cwd"], ["voltro serve . --preflight", "a Dockerfile/CI gate that catches \"prod serve, no build\""]],
+			notes: ["In production a precompiled bundle is MANDATORY — run `voltro build` first.", "A WEB app is refused here and pointed at `voltro start` (production) / `voltro dev`."]
 		}
 	},
 	{
@@ -364,17 +364,17 @@ var u = () => {
 		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-djmqEcDC.js").then((t) => t.runDoctorCommand(e))
+		run: (e) => import("./doctorCommand-DrQv9SL3.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-S0QOzqPT.js").then((t) => t.runBuildCommand(e)),
+		run: (e) => import("./build-QKP6Bm0J.js").then((t) => t.runBuildCommand(e)),
 		help: {
 			usage: "[app] [--target <t>]",
-			flags: [["--target <t>", "build target"]],
-			examples: [["voltro build", "production build for the app in the cwd"]],
+			flags: [["--target <t>", "build target"], ["--report", "print what a visitor downloads: first load, chunks, server artefacts"]],
+			examples: [["voltro build", "production build for the app in the cwd"], ["voltro build --report", "the same build, then its first-load size in bytes"]],
 			notes: [
 				"A web app gets the vite build + per-page SSG prerender + the start bundle; an api gets",
 				"the precompiled serve bundle. Both regenerate their generated files first, so a clean",
@@ -386,7 +386,7 @@ var u = () => {
 		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-C1BTpHGQ.js").then((t) => t.runPruneRuntimeCommand(e)),
+		run: (e) => import("./runtimeTrace-BQL_lfz6.js").then((t) => t.runPruneRuntimeCommand(e)),
 		hidden: !0
 	},
 	{
@@ -404,7 +404,7 @@ var u = () => {
 		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-DY2rYpTa.js").then((t) => t.runDormancyCommand(e)),
+		run: (e) => import("./dormancyCommand-xn2y-pJm.js").then((t) => t.runDormancyCommand(e)),
 		help: {
 			usage: "[app] [--port <n>] [--app-port <n>] [--idle-grace-ms <n>] [--tick-ms <n>]",
 			flags: [
@@ -421,7 +421,7 @@ var u = () => {
 		name: "start",
 		summary: "Production runtime: serves dist + SSR-on-demand for ssr/isr pages.",
 		status: "wired",
-		run: (e) => import("./start-DH7cat4-.js").then((t) => t.runStartCommand(e)),
+		run: (e) => import("./start-s25GAIgn.js").then((t) => t.runStartCommand(e)),
 		help: {
 			usage: "[app]",
 			examples: [["voltro start", "serve a built web app (dist + SSR-on-demand)"]],
@@ -475,7 +475,7 @@ var u = () => {
 		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-BTyBGhIA.js").then((t) => t.runDbCommand(e)),
+		run: (e) => import("./dbCommand-DHi_RuDl.js").then((t) => t.runDbCommand(e)),
 		help: {
 			usage: e(n),
 			examples: [
@@ -491,7 +491,7 @@ var u = () => {
 		name: "data",
 		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 all four directions, including a run in flight; inspect <file|dir>; unpack <file> <dir>. Native (vendor dump, no resume): backup <dir> [--assets] / restore <dir> [--assets] (pg_dump/mariadb-dump/…) — a restore marks the database in-progress until it finishes. Recovery: clear-replace-marker, clear-staging. Resumable + typed-NDJSON on the logical path; content-addressed assets on both.",
 		status: "wired",
-		run: (e) => import("./dataCommand-BEPPQiTl.js").then((t) => t.runDataCommand(e)),
+		run: (e) => import("./dataCommand-BoBJJ-Gb.js").then((t) => t.runDataCommand(e)),
 		help: {
 			usage: e(i),
 			flags: [
@@ -555,20 +555,20 @@ var u = () => {
 		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-nnFjDbl4.js").then((t) => t.runUpdateCommand(e))
+		run: (e) => import("./updateCommand-DsXEAHbd.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-nnFjDbl4.js").then((t) => t.runApplyCodemods(e))
+		run: (e) => import("./updateCommand-DsXEAHbd.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-BoCqZsgp.js").then((t) => t.runEmbeddingsCommand(e)),
+		run: (e) => import("./embeddingsCommand-Cn5MbRDM.js").then((t) => t.runEmbeddingsCommand(e)),
 		help: {
 			usage: "backfill <table> --text <field> --vector <field> [--model <m>] [--batch <n>] [--dry-run]",
 			flags: [
@@ -614,14 +614,14 @@ var u = () => {
 		summary: "Ask a RUNNING app whether its declared access is enforced. `access` calls every guarded procedure with NO credentials and reports any that answer (--process, --url, --strict, --format).",
 		status: "wired",
 		handlesHelp: !0,
-		run: (e) => import("./probeCommand-Bs3iVBSL.js").then((t) => t.runProbeCommand(e))
+		run: (e) => import("./probeCommand-C5fuN6Z2.js").then((t) => t.runProbeCommand(e))
 	},
 	{
 		name: "schedule",
 		summary: "Operate on registered schedules. `run <name>` fires one on demand (--process, --trigger manual|external, --url).",
 		status: "wired",
 		handlesHelp: !0,
-		run: (e) => import("./scheduleCmd-DQRu6BZC.js").then((t) => t.runScheduleCommand(e))
+		run: (e) => import("./scheduleCmd-DYBUfo_T.js").then((t) => t.runScheduleCommand(e))
 	},
 	{
 		name: "schedule-manifest",
@@ -643,35 +643,35 @@ var u = () => {
 		handlesHelp: !0,
 		summary: "Tail recent log records from every running voltro process. --tail N --since 30s --level error --filter PAT --format json|pretty|text.",
 		status: "wired",
-		run: (e) => import("./logsCmd-B6oNsfaZ.js").then((t) => t.runLogsCommand(e))
+		run: (e) => import("./logsCmd-C5y9HyrG.js").then((t) => t.runLogsCommand(e))
 	},
 	{
 		name: "traces",
 		handlesHelp: !0,
 		summary: "Distributed traces from every running api. --tail N --errors --since 30s --process NAME --format json|pretty. Use --id <traceId> for the waterfall of one trace.",
 		status: "wired",
-		run: (e) => import("./tracesCmd-DgtgOUdi.js").then((t) => t.runTracesCommand(e))
+		run: (e) => import("./tracesCmd-C1qKa94g.js").then((t) => t.runTracesCommand(e))
 	},
 	{
 		name: "inspect",
 		handlesHelp: !0,
 		summary: "Query the live /_voltro/inspect/* surface. Subcommands: app, routes, rpc, metrics, cache, schedules, aggregates, invoke. --process NAME --format json|pretty. `schedules --failing` reports only broken crons and exits 1 if any (usable as a post-deploy gate).",
 		status: "wired",
-		run: (e) => import("./inspectCmd-niF97fAq.js").then((t) => t.runInspectCommand(e))
+		run: (e) => import("./inspectCmd-CP-G0sVK.js").then((t) => t.runInspectCommand(e))
 	},
 	{
 		name: "workflows",
 		handlesHelp: !0,
 		summary: "Inspect + operate workflow runs. Subcommands: list, show <runId>, start <name>, retry|cancel|suspend|resume <runId>, signal|update <runId> --name, children <parentExecutionId>, flow (declarative flow-control queue + ledger), pause|unpause <workflowName>.",
 		status: "wired",
-		run: (e) => import("./workflowsCmd-BGF-mRZ5.js").then((t) => t.runWorkflowsCommand(e))
+		run: (e) => import("./workflowsCmd-g-DNpaUc.js").then((t) => t.runWorkflowsCommand(e))
 	},
 	{
 		name: "cluster",
 		handlesHelp: !0,
 		summary: "Clustering snapshot of every running api. Subcommand: status — per-instance replicaId, runner address, dialect, CDC flavor, coordination, server_id, + a flag for SQL runners stuck on localhost. --process NAME --format json|pretty.",
 		status: "wired",
-		run: (e) => import("./clusterCmd-DrVFCzSj.js").then((t) => t.runClusterCommand(e))
+		run: (e) => import("./clusterCmd-CdLB1GkT.js").then((t) => t.runClusterCommand(e))
 	},
 	{
 		name: "login",

package/dist/{dashboardCommand-D2kmyCLL.js → dashboardCommand-Bf_-Ne3P.js}

@@ -1,6 +1,6 @@
-import { f as e } from "./dev-Ca_A_S9v.js";
-import { Z as t, et as n } from "./webDev-B7vNj4Bq.js";
-import { t as r } from "./start-EOV7s1NZ.js";
+import { f as e } from "./dev-DOEJXicj.js";
+import { it as t, tt as n } from "./webDev-BgdkyjP6.js";
+import { t as r } from "./start-YaUehtDV.js";
 import { join as i } from "node:path";
 import { existsSync as a } from "node:fs";
 import { createLogger as o } from "@voltro/logger";
@@ -9,10 +9,10 @@ var s = o({ scope: "voltro:dashboard" }), c = (e, t) => {
 	let n = e.indexOf(t);
 	return n >= 0 ? e[n + 1] : void 0;
 }, l = async (o) => {
-	process.env[t] = "1";
+	process.env[n] = "1";
 	let l = c(o, "--port") ?? process.env.VOLTRO_DASHBOARD_PORT ?? "5179";
 	process.env.VOLTRO_DASHBOARD_PORT = l;
-	let u = n(process.cwd());
+	let u = t(process.cwd());
 	if (!u) return s.error("dashboard app not found. Install it with `pnpm add @voltro/dashboard`, or set VOLTRO_DASHBOARD_PATH to a dashboard app directory."), 1;
 	let d = a(i(u, ".framework", "dist", "index.html"));
 	return s.info(`serving the Voltro dashboard on :${l}`, {

package/dist/{dataCommand-BEPPQiTl.js → dataCommand-BoBJJ-Gb.js}

@@ -1,11 +1,11 @@
 import { a as e, t } from "./subcommandNames-CDzfEtKV.js";
 import { t as n } from "./cliError-BmdYnghb.js";
-import { B as r, c as i, i as a, o } from "./dev-Ca_A_S9v.js";
+import { K as r, c as i, i as a, o } from "./dev-DOEJXicj.js";
 import { n as s, t as c } from "./cliArgs-D4p8n7EE.js";
 import { r as l } from "./dialectDriver-czCHYpeH.js";
 import { i as u, n as d, r as f, t as p } from "./dataProfile-Du3ztYxv.js";
-import { o as m, t as h } from "./inspectFetch-EMuhTG_9.js";
-import { r as g } from "./dbCommand-DZTmOFT4.js";
+import { o as m, t as h } from "./inspectFetch-BU1NyzxV.js";
+import { r as g } from "./dbCommand-CMAIz-Bf.js";
 import { resolve as _ } from "node:path";
 import { createLogger as v } from "@voltro/logger";
 import { DATA_TRANSFERS_TABLE as y, REPLACE_IN_PROGRESS_TABLE as b, _voltroDataTransfersTable as x, _voltroReplaceInProgressTable as S, connectionIdentity as C, derivedRowId as w, ensureTableRegistered as T, normaliseTarget as ee, sameDatabase as te, streamTable as ne } from "@voltro/database";