@voltro/cli 0.2.0 → 0.2.1

package/CHANGELOG.md

@@ -39,6 +39,14 @@ _Changes staged for the next release accumulate here (rolled up from
 
 ---
 
+## [0.2.1] — 2026-07-17
+
+### Fixed
+
+- **@voltro/cli, @voltro/database** — `voltro codegen` / `dev` / `serve` / `build` no longer crash with `Cannot find package '@voltro/sql-mysql'` on an app that doesn't declare that driver (e.g. a memory-store app, or a postgres app for the mysql/mssql drivers). The CLI's framework-table assembly statically imported the CDC-offsets table schema from `@voltro/sql-mysql` / `@voltro/sql-mssql` (`import { _voltroCdcOffsetsTable } from '@voltro/sql-mysql'`), so merely LOADING the CLI resolved those driver packages — failing whenever one wasn't installed. This surfaced only in a production install where the drivers aren't present (0.2.0's app-declared-driver change), not in the workspace where all drivers are devDependencies. The two CDC-offsets table schemas (pure schema, no driver runtime) move to `@voltro/database` — the driver-agnostic package both the CLI and the drivers already depend on; the drivers re-export them so their public API + CDC readers are unchanged. The CLI now references a SQL driver only through the runtime `importDriver()` lookup (lazy, and only for the dialect actually in use). The lazily-imported driver modules are also typed with local structural interfaces instead of `typeof import('@voltro/sql-*')`, so no driver package is referenced in a type position either.
+
+---
+
 ## [0.2.0] — 2026-07-17
 
 ### ⚠ BREAKING

package/dist/{apiBuild-CnF3GAcP.js → apiBuild-B0dd-oDo.js}

@@ -1,4 +1,4 @@
-import { d as e } from "./dev-CZ2WE3zn.js";
+import { d as e } from "./dev-BGYmeKEx.js";
 import { isAbsolute as t, join as n, relative as r, resolve as i } from "node:path";
 import { createLogger as a } from "@voltro/logger";
 import { existsSync as o, promises as s } from "node:fs";

package/dist/apiBuild-D09wjKKO.js

@@ -0,0 +1,2 @@
+import { r as e } from "./apiBuild-B0dd-oDo.js";
+export { e as runApiBuild };

package/dist/bin.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { Ot as e } from "./dev-CZ2WE3zn.js";
-import { n as t } from "./commands-5AlC8Udj.js";
+import { Ot as e } from "./dev-BGYmeKEx.js";
+import { n as t } from "./commands-BgOfGwLc.js";
 import { createLogger as n } from "@voltro/logger";
 //#region src/bin.ts
 var r = n({ scope: "voltro:cli" }), i = process.argv.slice(2);

package/dist/{commands-5AlC8Udj.js → commands-BgOfGwLc.js}

@@ -1,6 +1,6 @@
-import { $ as e, A as t, At as n, B as r, Bt as i, C as a, Ct as o, D as s, Dt as c, E as l, Et as u, F as d, Ft as f, G as p, Gt as m, H as h, Ht as g, I as _, J as v, Jt as y, K as b, Kt as x, L as S, Lt as C, M as w, Mt as ee, N as te, Nt as ne, O as re, P as ie, Pt as ae, Q as T, R as oe, Rt as se, S as ce, St as le, T as E, Tt as ue, U as de, Ut as fe, V as pe, Vt as me, W as he, Wt as ge, X as _e, Xt as ve, Y as ye, Yt as be, Z as xe, _ as Se, _t as Ce, at as we, b as Te, bt as Ee, ct as De, d as Oe, dt as D, et as ke, f as Ae, ft as je, g as Me, gt as Ne, h as Pe, ht as Fe, i as Ie, it as Le, j as Re, jt as ze, k as Be, l as Ve, lt as He, m as Ue, mt as We, n as Ge, nt as Ke, o as qe, ot as Je, p as Ye, q as Xe, qt as Ze, rt as Qe, s as $e, st as et, t as tt, tt as nt, ut as rt, v as it, vt as at, w as ot, wt as st, x as ct, xt as lt, y as ut, yt as dt, z as ft, zt as pt } from "./dev-CZ2WE3zn.js";
+import { $ as e, A as t, At as n, B as r, Bt as i, C as a, Ct as o, D as s, Dt as c, E as l, Et as u, F as d, Ft as f, G as p, Gt as m, H as h, Ht as g, I as _, J as v, Jt as y, K as b, Kt as x, L as S, Lt as C, M as w, Mt as ee, N as te, Nt as ne, O as re, P as ie, Pt as ae, Q as T, R as oe, Rt as se, S as ce, St as le, T as E, Tt as ue, U as de, Ut as fe, V as pe, Vt as me, W as he, Wt as ge, X as _e, Xt as ve, Y as ye, Yt as be, Z as xe, _ as Se, _t as Ce, at as we, b as Te, bt as Ee, ct as De, d as Oe, dt as D, et as ke, f as Ae, ft as je, g as Me, gt as Ne, h as Pe, ht as Fe, i as Ie, it as Le, j as Re, jt as ze, k as Be, l as Ve, lt as He, m as Ue, mt as We, n as Ge, nt as Ke, o as qe, ot as Je, p as Ye, q as Xe, qt as Ze, rt as Qe, s as $e, st as et, t as tt, tt as nt, ut as rt, v as it, vt as at, w as ot, wt as st, x as ct, xt as lt, y as ut, yt as dt, z as ft, zt as pt } from "./dev-BGYmeKEx.js";
 import { i as mt } from "./startupRunner-DAexyPkM.js";
-import { t as ht } from "./apiBuild-CnF3GAcP.js";
+import { t as ht } from "./apiBuild-B0dd-oDo.js";
 import { basename as gt, dirname as O, extname as _t, isAbsolute as vt, join as k, relative as A, resolve as j } from "node:path";
 import { fileURLToPath as yt, pathToFileURL as bt } from "node:url";
 import { FileSystem as xt } from "@effect/platform";
@@ -576,10 +576,10 @@ external scheduler owns the once-only guarantee.
 }, sa = async (e) => {
 	let t = await Je(e);
 	if (!t) {
-		let { loadApiConfig: t } = await import("./dev-DFhyP4GC.js"), n = await t(e);
+		let { loadApiConfig: t } = await import("./dev-DoTIxucX.js"), n = await t(e);
 		if (n) {
 			z.info("building api app", { app: n.name ?? "(unnamed)" });
-			let { runApiBuild: t } = await import("./apiBuild-CRV5VLc-.js");
+			let { runApiBuild: t } = await import("./apiBuild-D09wjKKO.js");
 			return await t(e), {
 				ran: !0,
 				exitCode: 0

package/dist/{dev-CZ2WE3zn.js → dev-BGYmeKEx.js}

@@ -25,10 +25,8 @@ import { SqlClient as R } from "@effect/sql";
 import { WorkflowEngine as Sn } from "@effect/workflow";
 import { WorkflowStepInterceptorTag as Cn, _voltroWorkflowRunEventsTable as wn, _voltroWorkflowRunStepsTable as Tn, _voltroWorkflowRunsTable as En, _voltroWorkflowStartContextsTable as Dn, closeWorkflowChildrenForParent as On, completeSuspendingSignal as kn, getWorkflowVersionMetadata as An, isWorkflowWorkerLayer as jn, makeWorkflowRunRecorder as Mn, sendWorkflowSignal as Nn, sendWorkflowUpdate as Pn, serialiseWorkflowRowForWire as Fn, wrapWorkflowExecuteWithRunRecording as In } from "@voltro/workflow";
 import { makeClusterCronLayer as Ln, parseShardLockMode as Rn, resolveRunnerIdentity as zn, resolveRunnerStorage as Bn, workflowEngineLayer as Vn } from "@voltro/workflow/cluster";
-import { _voltroApiKeysTable as Hn, _voltroIdempotencyTable as Un, _voltroKvTable as Wn, _voltroMigrationPlansTable as z, _voltroMigrationsTable as Gn, _voltroSeedsTable as Kn, actorsTable as qn, allRegisteredTables as Jn, and as Yn, auditAllTableIndexes as Xn, drainIdentifierWarnings as Zn, ensureTableRegistered as Qn, eq as B, formatIndexAuditIssue as $n, isSeedDefinition as er, isSqliteFamily as tr, lt as nr, or as rr, registerCoreTables as ir, registerDiscoveredRelations as ar, resolveTenantNamespace as or, walkLeaves as sr } from "@voltro/database";
-import { _voltroWebhookDeliveriesTable as cr, _voltroWebhookTargetsTable as lr } from "@voltro/plugin-webhooks/mixin";
-import { _voltroCdcOffsetsTable as ur } from "@voltro/sql-mysql";
-import { _voltroMssqlCdcOffsetsTable as V } from "@voltro/sql-mssql";
+import { _voltroApiKeysTable as Hn, _voltroCdcOffsetsTable as Un, _voltroIdempotencyTable as Wn, _voltroKvTable as z, _voltroMigrationPlansTable as Gn, _voltroMigrationsTable as Kn, _voltroMssqlCdcOffsetsTable as qn, _voltroSeedsTable as Jn, actorsTable as Yn, allRegisteredTables as Xn, and as Zn, auditAllTableIndexes as Qn, drainIdentifierWarnings as $n, ensureTableRegistered as er, eq as B, formatIndexAuditIssue as tr, isSeedDefinition as nr, isSqliteFamily as rr, lt as ir, or as ar, registerCoreTables as or, registerDiscoveredRelations as sr, resolveTenantNamespace as cr, walkLeaves as lr } from "@voltro/database";
+import { _voltroWebhookDeliveriesTable as ur, _voltroWebhookTargetsTable as V } from "@voltro/plugin-webhooks/mixin";
 import { _voltroStorageBlobsTable as dr, _voltroStorageGrantsTable as fr, _voltroStorageRefsTable as H, _voltroStorageUsageTable as pr } from "@voltro/plugin-storage";
 import { AuthMiddleware as mr, ConnectionInfoMiddleware as hr, Unauthenticated as gr, WorkflowRunHandleSchema as _r, actionToRpc as vr, anonymousSubject as yr, checkFrameworkCompat as br, composeAuthStrategies as xr, composeRpcInterceptors as Sr, defineAction as Cr, defineMutation as wr, defineQuery as Tr, mutationToRpc as Er, publishServerError as U, queryToRpc as Dr, streamToRpc as Or, undoApplyDescriptor as kr, undoLogQueryDescriptor as Ar, undoRedoDescriptor as jr, workflowCancelDescriptor as Mr, workflowDomainEventsQueryDescriptor as Nr, workflowEventDeliveriesQueryDescriptor as Pr, workflowResumeDescriptor as Fr, workflowRunEventsQueryDescriptor as Ir, workflowRunQueryDescriptor as Lr, workflowRunStepsQueryDescriptor as Rr, workflowRunsQueryDescriptor as zr, workflowSignalDescriptor as Br, workflowUpdateDescriptor as Vr } from "@voltro/protocol";
 import { declaredSnapshot as Hr, describeOutcome as Ur, fingerprintSchema as Wr, introspectSchema as Gr, planMigrations as Kr, runFileBasedMigrations as qr, runFrameworkBootstrap as Jr, runPlannedMigrations as Yr } from "@voltro/database/sql";
@@ -4182,15 +4180,15 @@ ${a.join("\n\n")}\n`);
 	return (await zc(t))[Rc[e]];
 }, Vc = [
 	{
-		table: Gn,
+		table: Kn,
 		when: "always"
 	},
 	{
-		table: Kn,
+		table: Jn,
 		when: "always"
 	},
 	{
-		table: z,
+		table: Gn,
 		when: "always"
 	},
 	{
@@ -4226,11 +4224,11 @@ ${a.join("\n\n")}\n`);
 		when: "schedules"
 	},
 	{
-		table: lr,
+		table: V,
 		when: "webhooks"
 	},
 	{
-		table: cr,
+		table: ur,
 		when: "webhooks"
 	},
 	{
@@ -4262,7 +4260,7 @@ ${a.join("\n\n")}\n`);
 		when: "always"
 	},
 	{
-		table: Un,
+		table: Wn,
 		when: "always"
 	},
 	{
@@ -4270,12 +4268,12 @@ ${a.join("\n\n")}\n`);
 		when: "always"
 	},
 	{
-		table: Wn,
+		table: z,
 		when: "always"
 	}
 ], Hc = (e) => {
 	let t = Vc.filter((t) => t.when === "always" || t.when === "workflows" && e.workflows || t.when === "schedules" && e.schedules || t.when === "webhooks" && e.webhooks || t.when === "traces" && e.traces || t.when === "undo" && e.undo === !0).map((e) => e.table);
-	return e.cdc === !0 && t.push(e.cdcDialect === "mssql" ? V : ur), t;
+	return e.cdc === !0 && t.push(e.cdcDialect === "mssql" ? qn : Un), t;
 }, Uc = (e) => {
 	let t = e.startsWith("@") ? e.replace(/^@[^/]+\//, "") : e;
 	return (t.startsWith("plugin-") ? t.slice(7) : t).replace(/-([a-zA-Z0-9])/g, (e, t) => t.toUpperCase());
@@ -4627,7 +4625,7 @@ ${a.join("\n\n")}\n`);
 				let n = await t.query({
 					table: "_voltro_traces",
 					order: [],
-					predicate: nr("startedAt", e),
+					predicate: ir("startedAt", e),
 					projection: ["id"],
 					skip: void 0,
 					take: c
@@ -4741,7 +4739,7 @@ ${a.join("\n\n")}\n`);
 		table: "_voltro_workflow_runs",
 		timeColumn: "completedAt",
 		ttlMs: Ot(n.VOLTRO_WORKFLOW_RUNS_TTL_HOURS, 720),
-		where: rr(B("status", "succeeded"), B("status", "failed"), B("status", "cancelled"))
+		where: ar(B("status", "succeeded"), B("status", "failed"), B("status", "cancelled"))
 	});
 	let r = e.raw?.bind(e), i = (e) => {
 		if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(e)) throw Error(`retention: unsafe identifier "${e}"`);
@@ -4756,7 +4754,7 @@ ${a.join("\n\n")}\n`);
 			};
 			return (await r(e)).length;
 		}
-		let d = nr(l, a), f = s === void 0 ? d : Yn(d, s), p = await e.query({
+		let d = ir(l, a), f = s === void 0 ? d : Zn(d, s), p = await e.query({
 			table: c,
 			order: [],
 			predicate: f,
@@ -4781,7 +4779,7 @@ ${a.join("\n\n")}\n`);
 	let { store: t, schemaRegistry: n, cache: r, kv: i, webhooksService: a, workflowsProxy: o, eventTriggers: s, namespaceIsolationOn: c, onEventEmit: l } = e, u = (e, t) => {
 		if (!c) return e;
 		if (e.withNamespace === void 0) throw Error("tenantIsolation=namespace is set but the active store has no physical-namespace support (withNamespace).");
-		return e.withNamespace(or(t.tenantId));
+		return e.withNamespace(cr(t.tenantId));
 	};
 	return (e, c = t, d, f = "app-context", p) => {
 		let m = u(c, e.subject), h = o === void 0 ? void 0 : dt(o, {
@@ -4992,7 +4990,7 @@ ${a.join("\n\n")}\n`);
 			t.warn("seed: failed to import", { file: r }, e);
 			continue;
 		}
-		let i = (e.default && er(e.default) ? e.default : void 0) ?? Object.values(e).find(er);
+		let i = (e.default && nr(e.default) ? e.default : void 0) ?? Object.values(e).find(nr);
 		if (!i) {
 			t.warn("seed: no defineSeed export", { file: r });
 			continue;
@@ -5021,7 +5019,7 @@ ${a.join("\n\n")}\n`);
 	if (i.length === 1) {
 		let e = i[0];
 		a = B(e, n[e]);
-	} else a = Yn(...i.map((e) => B(e, n[e])));
+	} else a = Zn(...i.map((e) => B(e, n[e])));
 	let o = (await e.query({
 		table: t,
 		order: [],
@@ -6590,7 +6588,7 @@ ${a.join("\n\n")}\n`);
 }, Kd = (e) => {
 	if (!e) return;
 	let t = e.workflowName ?? e.tag, n = [];
-	if (t !== void 0 && n.push(B("tag", t)), e.status !== void 0 && n.push(B("status", e.status)), n.length !== 0) return n.length === 1 ? n[0] : Yn(...n);
+	if (t !== void 0 && n.push(B("tag", t)), e.status !== void 0 && n.push(B("status", e.status)), n.length !== 0) return n.length === 1 ? n[0] : Zn(...n);
 }, qd = async (e, t) => {
 	let n = Math.max(0, t?.offset ?? 0), r = Math.max(1, Math.min(500, t?.limit ?? 50)), i = Kd(t);
 	return {
@@ -7168,11 +7166,11 @@ ${a.join("\n\n")}\n`);
 		if (Xf.test(e)) {
 			let e = await t(n);
 			for (let t of Object.values(e)) lp(t) && (m.set(t.tableName, t), fp(t) && f.add(t.tableName), mp(t) && p.add(t.tableName));
-			ar(e);
+			sr(e);
 			continue;
 		}
 		if (Zf.test(e)) {
-			ar(await t(n)) === 0 && $.warn("skipping relations file — no relations(...) export found", { file: n });
+			sr(await t(n)) === 0 && $.warn("skipping relations file — no relations(...) export found", { file: n });
 			continue;
 		}
 		if (Bf.test(e)) {
@@ -7284,9 +7282,9 @@ ${a.join("\n\n")}\n`);
 			executor: l
 		});
 	}
-	m.has("actors") || m.set("actors", qn);
+	m.has("actors") || m.set("actors", Yn);
 	let _ = m.get("actors"), v = m.get("tenants");
-	(_ !== void 0 || v !== void 0) && ir({
+	(_ !== void 0 || v !== void 0) && or({
 		..._ === void 0 ? {} : { actors: () => _ },
 		...v === void 0 ? {} : { tenants: () => v }
 	});
@@ -7376,13 +7374,13 @@ ${a.join("\n\n")}\n`);
 }, Tp = (e) => (process.env.DB_DIALECT ?? e?.store ?? "memory").toLowerCase(), Ep = async (e, t) => {
 	let n = Tp(e);
 	if (n === "memory") return $.info("sql dialect resolved: memory — in-process store, no persistence"), new ge({});
-	let i = (process.env.CDC ?? "1") !== "0", a = await Bc(n), o = a.id === "postgres" ? "LISTEN/NOTIFY" : tr(a.id) ? "in-process bus" : a.id === "mariadb" ? "binlog CDC (ROW)" : a.id === "mssql" ? "Change Tracking (polled)" : a.id === "mysql" ? "binlog CDC (ROW)" : "inline only", s = a.id === "postgres" ? "native" : a.id === "mysql" ? "INSERT/UPDATE/DELETE then SELECT (no RETURNING)" : a.id === "mariadb" ? "native (INSERT/DELETE); UPDATE then SELECT" : a.id === "mssql" ? "OUTPUT INSERTED/DELETED" : tr(a.id) ? "native" : "unknown";
+	let i = (process.env.CDC ?? "1") !== "0", a = await Bc(n), o = a.id === "postgres" ? "LISTEN/NOTIFY" : rr(a.id) ? "in-process bus" : a.id === "mariadb" ? "binlog CDC (ROW)" : a.id === "mssql" ? "Change Tracking (polled)" : a.id === "mysql" ? "binlog CDC (ROW)" : "inline only", s = a.id === "postgres" ? "native" : a.id === "mysql" ? "INSERT/UPDATE/DELETE then SELECT (no RETURNING)" : a.id === "mariadb" ? "native (INSERT/DELETE); UPDATE then SELECT" : a.id === "mssql" ? "OUTPUT INSERTED/DELETED" : rr(a.id) ? "native" : "unknown";
 	$.info(`sql dialect resolved: ${a.id} — CDC: ${i ? o : "inline emit (CDC=0)"}, RETURNING: ${s}`);
 	let c = yp(), { summary: l, fromEnv: u } = Sp(c);
 	$.info(`db connection: ${l}${u ? "" : " (DEFAULT FALLBACK — no DB_URL / PG_HOST set)"}`), u || $.warn("db connection: falling back to localhost:5432/app — no DB_URL or PG_HOST env var set.\n  If this app should run against its OWN postgres (e.g. its docker-compose), set DB_URL.\n  Copy `.env.example` to `.env` in the app dir, or set DB_URL in the shell.\n  Otherwise this app is silently using whatever DB is at localhost:5432/app — which is\n  voltro-starter's docker default + may carry foreign tables that confuse the planner.");
 	let d;
 	if (i && (a.id === "mysql" || a.id === "mariadb")) {
-		let { connectionFromConfig: e } = await zc("@voltro/sql-mysql"), t = process.env.POD_NAME ?? process.env.HOSTNAME ?? `dev-${process.pid}`, n = Jn().map((e) => e.tableName).filter((e) => !e.startsWith("_voltro_"));
+		let { connectionFromConfig: e } = await zc("@voltro/sql-mysql"), t = process.env.POD_NAME ?? process.env.HOSTNAME ?? `dev-${process.pid}`, n = Xn().map((e) => e.tableName).filter((e) => !e.startsWith("_voltro_"));
 		d = {
 			serverId: wp(t),
 			replicaId: t,
@@ -7394,7 +7392,7 @@ ${a.join("\n\n")}\n`);
 			reactiveTables: n.length
 		});
 	} else if (i && a.id === "mssql") {
-		let { connectionFromConfig: e } = await zc("@voltro/sql-mssql"), t = e(c), n = process.env.POD_NAME ?? process.env.HOSTNAME ?? `dev-${process.pid}`, r = Jn().map((e) => e.tableName).filter((e) => !e.startsWith("_voltro_"));
+		let { connectionFromConfig: e } = await zc("@voltro/sql-mssql"), t = e(c), n = process.env.POD_NAME ?? process.env.HOSTNAME ?? `dev-${process.pid}`, r = Xn().map((e) => e.tableName).filter((e) => !e.startsWith("_voltro_"));
 		d = {
 			serverId: 0,
 			replicaId: n,
@@ -7424,7 +7422,7 @@ ${a.join("\n\n")}\n`);
 		region: null,
 		localityEnabled: !1
 	}), f;
-	if (tr(a.id)) return $.warn(`read replicas: not applicable (${a.id} is single-process); ignoring DB_REPLICA_URLS`), r.recordReplication({
+	if (rr(a.id)) return $.warn(`read replicas: not applicable (${a.id} is single-process); ignoring DB_REPLICA_URLS`), r.recordReplication({
 		replicaCount: 0,
 		rywPolicy: "off",
 		rywStore: "memory",
@@ -7587,7 +7585,7 @@ ${a.join("\n\n")}\n`);
 		}
 		return t;
 	})();
-	for (let e of I) Qn(e);
+	for (let e of I) er(e);
 	let xe = Nd({
 		plugins: F?.plugins ?? [],
 		appName: F?.name ?? i(t),
@@ -7664,7 +7662,7 @@ ${a.join("\n\n")}\n`);
 		"__voltro.undo.redo"
 	] }));
 	let qe = $.child("aggregate"), Je = v.filter((e) => Yf.test(e)), Ye = Je.length > 0 ? await zu(Je, qe) : [], rt = Ye.map((e) => e.definition.name);
-	for (let e of Zn()) $.warn(`identifier length · ${e}`);
+	for (let e of $n()) $.warn(`identifier length · ${e}`);
 	let ot = F?.restRoutes ?? [], lt = v.filter((e) => qf.test(e)).length, pt = v.filter((e) => Wf.test(e)).length, ht = v.filter((e) => /\.seed\.ts$/.test(e)).length, gt = v.filter((e) => Kf.test(e)).length, _t = v.filter((e) => hd.test(e)).length;
 	$.info("app surface", {
 		queryCount: O.length,
@@ -7865,21 +7863,21 @@ ${a.join("\n\n")}\n`);
 		"mariadb",
 		"mysql",
 		"mssql"
-	].includes(z) ? "advisoryLock" : "single"), er = Jn === "cluster" && (/* @__PURE__ */ new Set([
+	].includes(z) ? "advisoryLock" : "single"), Yn = Jn === "cluster" && (/* @__PURE__ */ new Set([
 		"postgres",
 		"mysql",
 		"mariadb",
 		"mssql"
-	])).has(z), nr = er ? P.filter((e) => (e.trigger ?? qn) === "self").map((e) => Ln({
+	])).has(z), Xn = Yn ? P.filter((e) => (e.trigger ?? qn) === "self").map((e) => Ln({
 		name: e.name,
 		cron: Ie(e),
 		execute: async () => {
 			await Gn?.fireFromCluster(e.name);
 		}
-	})) : [], ir = await (async () => {
+	})) : [], nr = await (async () => {
 		if (z === "memory") return Sn.layerMemory;
-		let e = await Bc(z), t = e.makeSqlLayer(yp()), n = Bn({ sqliteFamily: tr(e.id) });
-		if ($.info(`workflow engine: cluster-${n}, dialect=${e.id}` + (n === "memory" ? " — single-process durable replay, no horizontal scaling" + (tr(e.id) ? "" : " (VOLTRO_WORKFLOW_RUNNER_STORAGE=memory: SqlRunnerStorage/cluster_runners + GET_LOCK skipped)") : "")), e.id === "mssql") {
+		let e = await Bc(z), t = e.makeSqlLayer(yp()), n = Bn({ sqliteFamily: rr(e.id) });
+		if ($.info(`workflow engine: cluster-${n}, dialect=${e.id}` + (n === "memory" ? " — single-process durable replay, no horizontal scaling" + (rr(e.id) ? "" : " (VOLTRO_WORKFLOW_RUNNER_STORAGE=memory: SqlRunnerStorage/cluster_runners + GET_LOCK skipped)") : "")), e.id === "mssql") {
 			let e = await fu(process.cwd());
 			e && $.warn(e);
 		}
@@ -7888,11 +7886,11 @@ ${a.join("\n\n")}\n`);
 			runnerStorage: n,
 			dialectId: e.id,
 			...process.env.VOLTRO_WORKFLOW_RUNNER_PORT ? { runnerListenPort: Number(process.env.VOLTRO_WORKFLOW_RUNNER_PORT) } : {},
-			...nr.length > 0 ? { extraShardingLayers: nr } : {}
+			...Xn.length > 0 ? { extraShardingLayers: Xn } : {}
 		});
 	})();
 	$.info("workflow engine selected", { engine: z === "postgres" ? "cluster-postgres" : "in-memory" });
-	let ar, or = /* @__PURE__ */ new Map(), cr = () => `wfctx_${globalThis.crypto?.randomUUID?.() ?? `${Date.now().toString(36)}${Math.random().toString(36).slice(2)}`}`, lr = async (e, t, n) => {
+	let ir, or = /* @__PURE__ */ new Map(), sr = () => `wfctx_${globalThis.crypto?.randomUUID?.() ?? `${Date.now().toString(36)}${Math.random().toString(36).slice(2)}`}`, cr = async (e, t, n) => {
 		let r = {
 			...n,
 			source: n.source ?? `workflow:${e}`
@@ -7917,7 +7915,7 @@ ${a.join("\n\n")}\n`);
 				createdAt: /* @__PURE__ */ new Date()
 			};
 			n[0] === void 0 ? await L.insert("_voltro_workflow_start_contexts", {
-				id: cr(),
+				id: sr(),
 				...i
 			}) : await L.update("_voltro_workflow_start_contexts", n[0].id, i);
 		} catch (n) {
@@ -7961,7 +7959,7 @@ ${a.join("\n\n")}\n`);
 			});
 			return;
 		}
-	}, V = M.length > 0 ? it(() => ar) : void 0, dr = $.child("webhooks"), fr = v.filter((e) => Kf.test(e)), H = fr.length > 0 ? await md(fr, dr) : {
+	}, V = M.length > 0 ? it(() => ir) : void 0, dr = $.child("webhooks"), fr = v.filter((e) => Kf.test(e)), H = fr.length > 0 ? await md(fr, dr) : {
 		outgoing: [],
 		incoming: [],
 		providers: []
@@ -8066,7 +8064,7 @@ ${a.join("\n\n")}\n`);
 	}), kr = () => {
 		let e = U.subscriptionSnapshot(), t = U.matcherStats(), n = e.map((e) => {
 			let t = [];
-			for (let n of sr(e.predicate)) n.conjunctive && t.push(n.column);
+			for (let n of lr(e.predicate)) n.conjunctive && t.push(n.column);
 			return {
 				fingerprint: e.fingerprint,
 				table: e.table,
@@ -8146,8 +8144,8 @@ ${a.join("\n\n")}\n`);
 	});
 	let _i = (e, t) => kt(e.pipe(y.provide(nt(t)), y.provide(gi), y.provide(Df))), vi = ct(I);
 	if ((process.env.VOLTRO_INDEX_AUDIT ?? "on") !== "off") {
-		let e = Xn(I), t = process.stdout.isTTY === !0 && (process.env.NO_COLOR ?? "") === "";
-		for (let n of e) $.warn("\n" + $n(n, {
+		let e = Qn(I), t = process.stdout.isTTY === !0 && (process.env.NO_COLOR ?? "") === "";
+		for (let n of e) $.warn("\n" + tr(n, {
 			color: t,
 			indent: "  "
 		}));
@@ -8167,7 +8165,7 @@ ${a.join("\n\n")}\n`);
 			kv: en
 		}, t = H.outgoing.map((e) => e.descriptor);
 		W = oi(e, async (n) => {
-			let r = ci.execute(n).pipe(y.provide(ci.toLayer(ai(e, { events: t })).pipe(S.provideMerge(ir))));
+			let r = ci.execute(n).pipe(y.provide(ci.toLayer(ai(e, { events: t })).pipe(S.provideMerge(nr))));
 			y.runPromise(r).catch((e) => {
 				dr.error("deliverWebhook workflow crashed", {
 					deliveryId: n.deliveryId,
@@ -8191,7 +8189,7 @@ ${a.join("\n\n")}\n`);
 	}), xi = async () => {
 		if (P.length === 0) return;
 		let e = process.env.HOSTNAME ?? `pid-${process.pid}`, t;
-		er ? t = Mt : Jn === "cluster" ? ($.warn("scheduling.coordination=cluster needs store=postgres — falling back to single (dev/memory)"), t = Mt) : Jn === "advisoryLock" ? z === "memory" ? ($.warn("scheduling.coordination=advisoryLock needs a SQL store (the claim-row gate) — falling back to single (memory)"), t = Mt) : t = Ze(L, e, {
+		Yn ? t = Mt : Jn === "cluster" ? ($.warn("scheduling.coordination=cluster needs store=postgres — falling back to single (dev/memory)"), t = Mt) : Jn === "advisoryLock" ? z === "memory" ? ($.warn("scheduling.coordination=advisoryLock needs a SQL store (the claim-row gate) — falling back to single (memory)"), t = Mt) : t = Ze(L, e, {
 			info: (e, t) => $.info(e, t ?? {}),
 			warn: (e, t) => $.warn(e, t ?? {})
 		}) : t = Mt;
@@ -8201,7 +8199,7 @@ ${a.join("\n\n")}\n`);
 			coordinator: t,
 			defaultTrigger: qn,
 			replicaId: e,
-			armSelf: !er,
+			armSelf: !Yn,
 			dormancy: F?.dormancy ?? "always-on",
 			dormancyTenantId: kf,
 			buildContext: ({ traceId: e, scheduleName: t }) => bi({
@@ -8220,15 +8218,15 @@ ${a.join("\n\n")}\n`);
 			...n === void 0 ? {} : { interceptFire: n }
 		}), $.info("scheduler ready", {
 			schedules: P.length,
-			coordination: er ? "cluster" : t.kind,
-			clusterCrons: nr.length
+			coordination: Yn ? "cluster" : t.kind,
+			clusterCrons: Xn.length
 		}), process.on("beforeExit", () => {
 			Gn?.shutdown();
 		});
 	}, G = {}, Si = (e, t) => Ee(De(e, ce, t.subject.tenantId), le), Ci = /* @__PURE__ */ new Set(), wi = (e) => {
 		if (e.usingIndex !== void 0 || e.predicate === void 0) return;
 		let t = /* @__PURE__ */ new Set();
-		for (let n of sr(e.predicate)) n.conjunctive && t.add(n.column);
+		for (let n of lr(e.predicate)) n.conjunctive && t.add(n.column);
 		if (t.size === 0 || vi.anyFieldIndexed(e.table, t)) return;
 		let n = `${e.table}::${[...t].sort().join(",")}`;
 		Ci.has(n) || (Ci.add(n), $.warn("non-indexed predicate — slow at scale", {
@@ -8302,7 +8300,7 @@ ${a.join("\n\n")}\n`);
 					column: "startedAt",
 					direction: "desc"
 				}],
-				predicate: rr(B("id", t), B("executionId", t)),
+				predicate: ar(B("id", t), B("executionId", t)),
 				take: 1,
 				skip: void 0,
 				projection: void 0
@@ -8318,7 +8316,7 @@ ${a.join("\n\n")}\n`);
 					column: "startedAt",
 					direction: "desc"
 				}],
-				predicate: n.length === 0 ? void 0 : n.length === 1 ? n[0] : Yn(...n),
+				predicate: n.length === 0 ? void 0 : n.length === 1 ? n[0] : Zn(...n),
 				take: r,
 				skip: void 0,
 				projection: void 0
@@ -8500,13 +8498,13 @@ ${a.join("\n\n")}\n`);
 	}, qi = [...ft(M, {
 		buildContext: Li,
 		resolveStartContext: ur
-	}, (e, t, n) => Ki(e.definition.name, e.definition, t, n)), ...ie], Ji = qi.length > 0 ? S.mergeAll(...qi) : S.empty, Yi = C.make(Ji.pipe(S.provideMerge(ir)));
+	}, (e, t, n) => Ki(e.definition.name, e.definition, t, n)), ...ie], Ji = qi.length > 0 ? S.mergeAll(...qi) : S.empty, Yi = C.make(Ji.pipe(S.provideMerge(nr)));
 	process.on("beforeExit", () => {
 		Yi.dispose();
-	}), ar = M.length > 0 ? ut({
+	}), ir = M.length > 0 ? ut({
 		workflows: M,
 		runEffect: (e) => Yi.runPromise(e),
-		rememberStartContext: lr,
+		rememberStartContext: cr,
 		signal: async (e, t, n) => {
 			let r = await Nn({
 				store: L,
@@ -8801,7 +8799,7 @@ ${a.join("\n\n")}\n`);
 			return {
 				subscriptions: e.map((e) => {
 					let t = [];
-					for (let n of sr(e.predicate)) n.conjunctive && t.push(n.column);
+					for (let n of lr(e.predicate)) n.conjunctive && t.push(n.column);
 					return {
 						fingerprint: e.fingerprint,
 						table: e.table,
@@ -9260,7 +9258,7 @@ ${a.join("\n\n")}\n`);
 					...e.description === void 0 ? {} : { description: e.description },
 					nextFiringAt: mt(e).toISOString()
 				})),
-				coordination: er ? "cluster" : Jn === "advisoryLock" && z === "postgres" ? "advisoryLock" : "single"
+				coordination: Yn ? "cluster" : Jn === "advisoryLock" && z === "postgres" ? "advisoryLock" : "single"
 			}),
 			inspectScheduleRuns: async (e) => {
 				let t = Math.max(0, e.offset ?? 0), n = Math.max(1, Math.min(500, e.limit ?? 50)), r = e.name === void 0 ? void 0 : B("name", e.name), i = await L.query({
@@ -9310,7 +9308,7 @@ ${a.join("\n\n")}\n`);
 			let e = process.env.POD_NAME ?? process.env.HOSTNAME ?? `dev-${process.pid}`, t = z, n = t === "memory", r = n ? "none" : Bn({ sqliteFamily: t === "sqlite" || t === "turso" }), i = zn({
 				runnerStorage: r === "sql" ? "sql" : "memory",
 				...process.env.VOLTRO_WORKFLOW_RUNNER_PORT ? { runnerListenPort: Number(process.env.VOLTRO_WORKFLOW_RUNNER_PORT) } : {}
-			}), a = !n && (process.env.CDC ?? "1") !== "0", o = t === "postgres" ? "LISTEN/NOTIFY" : t === "sqlite" || t === "turso" ? "in-process bus" : t === "mariadb" || t === "mysql" ? "binlog CDC (ROW)" : t === "mssql" ? "inline only" : t === "memory" ? "none (single-process)" : "inline only", s = t === "postgres" || t === "mariadb" || t === "mssql" ? "full" : t === "mysql" ? "inline-only" : t === "sqlite" || t === "turso" ? "single-process" : "none", c = er ? "cluster" : Jn === "advisoryLock" && z === "postgres" ? "advisoryLock" : "single", l = a && t === "mariadb" ? wp(e) : void 0, u = {
+			}), a = !n && (process.env.CDC ?? "1") !== "0", o = t === "postgres" ? "LISTEN/NOTIFY" : t === "sqlite" || t === "turso" ? "in-process bus" : t === "mariadb" || t === "mysql" ? "binlog CDC (ROW)" : t === "mssql" ? "inline only" : t === "memory" ? "none (single-process)" : "inline only", s = t === "postgres" || t === "mariadb" || t === "mssql" ? "full" : t === "mysql" ? "inline-only" : t === "sqlite" || t === "turso" ? "single-process" : "none", c = Yn ? "cluster" : Jn === "advisoryLock" && z === "postgres" ? "advisoryLock" : "single", l = a && t === "mariadb" ? wp(e) : void 0, u = {
 				replicaId: e,
 				dialect: t,
 				runnerHost: i.host,

package/dist/dev-DoTIxucX.js

@@ -0,0 +1,2 @@
+import { o as e } from "./dev-BGYmeKEx.js";
+export { e as loadApiConfig };

package/dist/index.js

@@ -1,4 +1,4 @@
-import { i as e, n as t, r as n, t as r } from "./commands-5AlC8Udj.js";
+import { i as e, n as t, r as n, t as r } from "./commands-BgOfGwLc.js";
 //#region src/index.ts
 var i = "framework";
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voltro/cli",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "The `voltro` CLI — dev server, codegen, migrations, project scaffolding, agent-docs seeding, and production serve.",
   "keywords": [
     "voltro",
@@ -49,22 +49,22 @@
     "@effect/workflow": "^0.18.2",
     "@tailwindcss/vite": "^4.3.2",
     "@vitejs/plugin-react": "^6.0.3",
-    "@voltro/ai": "0.2.0",
-    "@voltro/cache": "0.2.0",
-    "@voltro/data-transfer": "0.2.0",
-    "@voltro/database": "0.2.0",
-    "@voltro/env": "0.2.0",
-    "@voltro/kv": "0.2.0",
-    "@voltro/logger": "0.2.0",
-    "@voltro/plugin-auth": "0.2.0",
-    "@voltro/plugin-broadcast": "0.2.0",
-    "@voltro/plugin-mail": "0.2.0",
-    "@voltro/plugin-storage": "0.2.0",
-    "@voltro/plugin-webhooks": "0.2.0",
-    "@voltro/protocol": "0.2.0",
-    "@voltro/runtime": "0.2.0",
-    "@voltro/serverless": "0.2.0",
-    "@voltro/workflow": "0.2.0",
+    "@voltro/ai": "0.2.1",
+    "@voltro/cache": "0.2.1",
+    "@voltro/data-transfer": "0.2.1",
+    "@voltro/database": "0.2.1",
+    "@voltro/env": "0.2.1",
+    "@voltro/kv": "0.2.1",
+    "@voltro/logger": "0.2.1",
+    "@voltro/plugin-auth": "0.2.1",
+    "@voltro/plugin-broadcast": "0.2.1",
+    "@voltro/plugin-mail": "0.2.1",
+    "@voltro/plugin-storage": "0.2.1",
+    "@voltro/plugin-webhooks": "0.2.1",
+    "@voltro/protocol": "0.2.1",
+    "@voltro/runtime": "0.2.1",
+    "@voltro/serverless": "0.2.1",
+    "@voltro/workflow": "0.2.1",
     "chokidar": "^5.0.0",
     "esbuild": "^0.28.0",
     "ioredis": "^5.11.1",

package/templates/apps/api-ai/package.json

@@ -11,16 +11,16 @@
   "dependencies": {
     "@effect/platform": "^0.96.1",
     "@effect/rpc": "^0.75.1",
-    "@voltro/ai": "0.2.0",
-    "@voltro/cli": "0.2.0",
-    "@voltro/database": "0.2.0",
-    "@voltro/env": "0.2.0",
-    "@voltro/protocol": "0.2.0",
-    "@voltro/runtime": "0.2.0",
+    "@voltro/ai": "0.2.1",
+    "@voltro/cli": "0.2.1",
+    "@voltro/database": "0.2.1",
+    "@voltro/env": "0.2.1",
+    "@voltro/protocol": "0.2.1",
+    "@voltro/runtime": "0.2.1",
     "effect": "^3.21.2"
   },
   "devDependencies": {
-    "@voltro/testing": "0.2.0",
+    "@voltro/testing": "0.2.1",
     "typescript": "^5.7.0",
     "vitest": "^3.0.0"
   }

package/templates/apps/api-auth/package.json

@@ -12,17 +12,17 @@
   "dependencies": {
     "@effect/platform": "^0.96.1",
     "@effect/rpc": "^0.75.1",
-    "@voltro/cli": "0.2.0",
-    "@voltro/database": "0.2.0",
-    "@voltro/env": "0.2.0",
-    "@voltro/plugin-auth": "0.2.0",
-    "@voltro/protocol": "0.2.0",
-    "@voltro/runtime": "0.2.0",
-    "@voltro/sql-postgres": "0.2.0",
+    "@voltro/cli": "0.2.1",
+    "@voltro/database": "0.2.1",
+    "@voltro/env": "0.2.1",
+    "@voltro/plugin-auth": "0.2.1",
+    "@voltro/protocol": "0.2.1",
+    "@voltro/runtime": "0.2.1",
+    "@voltro/sql-postgres": "0.2.1",
     "effect": "^3.21.2"
   },
   "devDependencies": {
-    "@voltro/testing": "0.2.0",
+    "@voltro/testing": "0.2.1",
     "typescript": "^5.7.0",
     "vitest": "^3.0.0"
   }

package/templates/apps/api-backend/package.json

@@ -12,16 +12,16 @@
   "dependencies": {
     "@effect/platform": "^0.96.1",
     "@effect/rpc": "^0.75.1",
-    "@voltro/cli": "0.2.0",
-    "@voltro/database": "0.2.0",
-    "@voltro/env": "0.2.0",
-    "@voltro/plugin-multitenancy": "0.2.0",
-    "@voltro/protocol": "0.2.0",
-    "@voltro/runtime": "0.2.0",
+    "@voltro/cli": "0.2.1",
+    "@voltro/database": "0.2.1",
+    "@voltro/env": "0.2.1",
+    "@voltro/plugin-multitenancy": "0.2.1",
+    "@voltro/protocol": "0.2.1",
+    "@voltro/runtime": "0.2.1",
     "effect": "^3.21.2"
   },
   "devDependencies": {
-    "@voltro/testing": "0.2.0",
+    "@voltro/testing": "0.2.1",
     "typescript": "^5.7.0",
     "vitest": "^3.0.0"
   }

package/templates/apps/api-backend-deactivation/package.json

@@ -12,16 +12,16 @@
   "dependencies": {
     "@effect/platform": "^0.96.1",
     "@effect/rpc": "^0.75.1",
-    "@voltro/cli": "0.2.0",
-    "@voltro/database": "0.2.0",
-    "@voltro/env": "0.2.0",
-    "@voltro/plugin-deactivation": "0.2.0",
-    "@voltro/protocol": "0.2.0",
-    "@voltro/runtime": "0.2.0",
+    "@voltro/cli": "0.2.1",
+    "@voltro/database": "0.2.1",
+    "@voltro/env": "0.2.1",
+    "@voltro/plugin-deactivation": "0.2.1",
+    "@voltro/protocol": "0.2.1",
+    "@voltro/runtime": "0.2.1",
     "effect": "^3.21.2"
   },
   "devDependencies": {
-    "@voltro/testing": "0.2.0",
+    "@voltro/testing": "0.2.1",
     "typescript": "^5.7.0",
     "vitest": "^3.0.0"
   }