@voltro/cli 0.25.0 → 0.26.0

package/dist/{commands-7EmYJ9Xg.js → commands-D-9iYF2D.js}

@@ -1,14 +1,14 @@
-import { A as e, E as t, I as n, L as r, M as i, N as a, O as o, P as s, S as c, T as l, _t as u, a as d, at as f, b as p, c as m, ct as h, d as g, f as _, ft as v, gt as y, ht as b, it as ee, j as te, k as ne, lt as re, n as ie, o as ae, ot as oe, p as se, q as ce, s as le, st as ue, u as de, ut as fe, v as pe, y as me } from "./inspectMetrics-EQwH7BI4.js";
+import { A as e, E as t, I as n, L as r, M as i, N as a, O as o, P as s, S as c, T as l, _t as u, a as d, at as f, b as p, c as m, ct as h, d as g, f as _, ft as v, gt as y, ht as b, it as ee, j as te, k as ne, lt as re, n as ie, o as ae, ot as oe, p as se, q as ce, s as le, st as ue, u as de, ut as fe, v as pe, y as me } from "./inspectMetrics-BU90mvJN.js";
 import { s as he } from "./seedRunner-D6eu-u5U.js";
 import { a as x, c as ge, i as _e, o as ve, s as ye } from "./devActivity-BhIu6ncs.js";
-import { i as be, x as xe } from "./frameworkTableAssembly-Cw5zJz6n.js";
-import { A as Se, C as Ce, E as we, O as Te, S as Ee, T as De, b as Oe, c as ke, d as Ae, f as je, i as Me, l as Ne, n as Pe, o as Fe, r as Ie, s as Le, w as Re } from "./fileConventions-3bffWssN.js";
-import { C as ze, Z as Be, at as Ve, c as He, f as Ue, i as We, it as Ge, l as Ke, nt as qe, o as Je, ot as Ye, rt as Xe, vt as Ze } from "./dev-MacSQ1Ll.js";
-import { i as Qe, n as $e, o as et, r as tt, s as nt, u as rt } from "./apiBuild-BqhCSytw.js";
-import { t as it } from "./start-C-ZWSDpg.js";
+import { C as be, Q as xe, at as Se, c as Ce, f as we, i as Te, it as Ee, l as De, o as Oe, ot as ke, rt as Ae, st as je, yt as Me } from "./dev-Dbm6SWtn.js";
+import { i as Ne, x as Pe } from "./frameworkTableAssembly-BwHU9Euq.js";
+import { A as Fe, C as Ie, E as Le, O as Re, S as ze, T as Be, b as Ve, c as He, d as Ue, f as We, i as Ge, l as Ke, n as qe, o as Je, r as Ye, s as Xe, w as Ze } from "./fileConventions-3bffWssN.js";
+import { i as Qe, n as $e, o as et, r as tt, s as nt, u as rt } from "./apiBuild-BtrTyKnF.js";
+import { t as it } from "./start-BGXIf6zT.js";
 import { a as at, i as ot, n as st, r as ct, t as lt } from "./cliArgs-qdZSElM3.js";
-import { n as ut, r as dt } from "./serveCommand-5ZFiNO1R.js";
-import { c as ft, r as pt, s as mt } from "./dbCommand-FUU12FvD.js";
+import { n as ut, r as dt } from "./serveCommand-XBXuwJty.js";
+import { c as ft, r as pt, s as mt } from "./dbCommand-uuNCrFAb.js";
 import { basename as S, dirname as C, isAbsolute as ht, join as w, relative as T, resolve as E, sep as gt } from "node:path";
 import { fileURLToPath as _t, pathToFileURL as vt } from "node:url";
 import { FileSystem as yt } from "@effect/platform";
@@ -600,7 +600,7 @@ never mint — inspect stays closed until an operator opens it.`);
 			if (hr.has(a.name)) continue;
 			let i = w(e, a.name);
 			if (a.isDirectory()) await r(i);
-			else if (a.isFile() && Ae.test(a.name)) {
+			else if (a.isFile() && Ue.test(a.name)) {
 				let e = T(t, i), r = await Wt(i, "utf8");
 				n.push({
 					file: e,
@@ -992,10 +992,10 @@ never mint — inspect stays closed until an operator opens it.`);
 }, Mr = async (e) => {
 	let t = await le(e);
 	if (!t) {
-		let { loadApiConfig: t } = await import("./dev-BvHT7WZa.js"), n = await t(e);
+		let { loadApiConfig: t } = await import("./dev-BnWq4jeA.js"), n = await t(e);
 		if (n) {
 			U.info("building api app", { app: n.name ?? "(unnamed)" });
-			let { runApiBuild: t, runServeBundleBuild: r } = await import("./apiBuild-N1R4V792.js");
+			let { runApiBuild: t, runServeBundleBuild: r } = await import("./apiBuild-DDJ0It4j.js");
 			await t(e);
 			try {
 				await r(e);
@@ -1175,7 +1175,7 @@ never mint — inspect stays closed until an operator opens it.`);
 	}).pipe(D.orDie);
 	return t.ran ? t.exitCode : (yield* D.logError("no web app found at this path", { hint: "looked for app.config.ts with `type: 'web'`" }), 1);
 }), Pr = async (e) => {
-	let t = e.find((e) => !e.startsWith("-")) ?? process.cwd(), n = await u(Nr(t), { scope: "voltro:build" }), r = Ze(t);
+	let t = e.find((e) => !e.startsWith("-")) ?? process.cwd(), n = await u(Nr(t), { scope: "voltro:build" }), r = Me(t);
 	return r.warning !== void 0 && U.warn(r.warning), n;
 }, Fr = (e) => e.source === void 0 ? [] : typeof e.source == "string" ? [e.source] : e.source, Ir = (e) => ({
 	tables: new Set(e.tables),
@@ -1421,9 +1421,9 @@ never mint — inspect stays closed until an operator opens it.`);
 		}
 	})).status === "accepted" ? 0 : 1;
 }, $r = async (e) => {
-	let t = E(e.find((e) => !e.startsWith("-")) ?? process.cwd()), { config: n, present: r, error: i } = await Ke(t);
+	let t = E(e.find((e) => !e.startsWith("-")) ?? process.cwd()), { config: n, present: r, error: i } = await De(t);
 	if (r && n === null) return console.error("voltro codegen: app.config.ts exists but could not be loaded — refusing to write."), console.error("  The generated file would omit every plugin's error union and client routes, and would typecheck, so the omission would only surface as a missing error tag at runtime."), i !== void 0 && console.error(`  cause: ${i instanceof Error ? i.message : String(i)}`), 1;
-	let a = n?.plugins ?? [], { pluginContributions: o, pluginErrorImports: s, pluginRpcImports: c } = await ze(a, n?.name ?? S(t), t), l = await qe({
+	let a = n?.plugins ?? [], { pluginContributions: o, pluginErrorImports: s, pluginRpcImports: c } = await be(a, n?.name ?? S(t), t), l = await Ae({
 		root: t,
 		...o.length > 0 ? { pluginContributions: o } : {},
 		...s.length > 0 ? { pluginErrorImports: s } : {},
@@ -1566,45 +1566,45 @@ never mint — inspect stays closed until an operator opens it.`);
 }, ci = (e, t) => t.some((t) => e === t.dir || e.startsWith(`${t.dir}${gt}`)), li = (e, t) => t.map((t) => `${T(e, t.dir) || "."}  (${t.source})`), ui = [
 	{
 		id: "component.ui",
-		re: Ie,
+		re: Ye,
 		needsTest: !0
 	},
 	{
 		id: "component",
-		re: Pe,
+		re: qe,
 		needsTest: !0
 	},
 	{
 		id: "hook",
-		re: Le,
+		re: Xe,
 		needsTest: !0
 	},
 	{
 		id: "tracking",
-		re: Ce,
+		re: Ie,
 		needsTest: !0
 	},
 	{
 		id: "store",
-		re: Oe,
+		re: Ve,
 		needsTest: !0
 	},
 	{
 		id: "internal",
-		re: ke,
+		re: He,
 		needsTest: !0
 	},
 	{
 		id: "fixture",
-		re: Fe,
+		re: Je,
 		needsTest: !1
 	},
 	{
 		id: "types",
-		re: De,
+		re: Be,
 		needsTest: !1
 	}
-], di = (e) => ui.find((t) => t.re.test(e))?.id ?? null, fi = (e) => Ee.test(e), pi = /* @__PURE__ */ new Set([
+], di = (e) => ui.find((t) => t.re.test(e))?.id ?? null, fi = (e) => ze.test(e), pi = /* @__PURE__ */ new Set([
 	"useMutation",
 	"useAction",
 	"useUpload",
@@ -1893,7 +1893,7 @@ never mint — inspect stays closed until an operator opens it.`);
 			});
 			let n = f(e), i = n.filter((e) => {
 				let t = di(e);
-				return t === "component" || t === "component.ui" || Ae.test(e) || je.has(e.slice(e.lastIndexOf(gt) + 1));
+				return t === "component" || t === "component.ui" || Ue.test(e) || We.has(e.slice(e.lastIndexOf(gt) + 1));
 			});
 			n.length === 0 ? a.push({
 				rule: "ui/orphaned",
@@ -2969,7 +2969,7 @@ never mint — inspect stays closed until an operator opens it.`);
 	let t = to.get(e);
 	if (t !== void 0) return t;
 	let n = (async () => {
-		let { walk: t, loadDiscovered: n } = await import("./dev-BvHT7WZa.js"), r = await t(e);
+		let { walk: t, loadDiscovered: n } = await import("./dev-BnWq4jeA.js"), r = await t(e);
 		return {
 			files: r,
 			discovered: await n(r)
@@ -3046,7 +3046,7 @@ never mint — inspect stays closed until an operator opens it.`);
 }) => /* @__PURE__ */ new Set([...Qi, ...$i(Ma(e).map(t))]), uo = async (e) => {
 	let { discovered: t } = await no(e), n = [];
 	try {
-		let { loadApiConfig: t } = await import("./dev-BvHT7WZa.js");
+		let { loadApiConfig: t } = await import("./dev-BnWq4jeA.js");
 		n = ((await t(e))?.plugins ?? []).map((e) => {
 			let t = (e.extendSchema?.tables ?? []).map((e) => {
 				let t = e;
@@ -3248,7 +3248,7 @@ never mint — inspect stays closed until an operator opens it.`);
 		} catch {
 			continue;
 		}
-		a.isDirectory() ? yo(r, t, n + 1) : a.isFile() && Xe.test(i) && t.push(r);
+		a.isDirectory() ? yo(r, t, n + 1) : a.isFile() && Ee.test(i) && t.push(r);
 	}
 	return t;
 }, bo = /* @__PURE__ */ new Set(["actors", "tenants"]), xo = async (e) => {
@@ -3282,12 +3282,12 @@ never mint — inspect stays closed until an operator opens it.`);
 	let t = e.severity === "error" ? "✗ error" : "⚠ warn", n = e.file ? ` (${e.file})` : "";
 	return `${t}  ${e.rule}  ${e.node}${n}\n    ${e.breaks.join("; ")}\n    fix: ${e.fix}`;
 }).join("\n"), To = async (e) => {
-	let { walk: t, loadDiscovered: n, loadApiConfig: r } = await import("./dev-BvHT7WZa.js"), { buildRpcEntry: i } = await import("./manifestBuild-BVwS1Z_6.js"), { buildCapabilityManifest: a } = await import("./inspect-C9gjHwBk.js"), { relative: o } = await import("node:path"), s = await n(await t(e)), c = (t, n, r) => i(t, n, o(e, r)), l = [
+	let { walk: t, loadDiscovered: n, loadApiConfig: r } = await import("./dev-BnWq4jeA.js"), { buildRpcEntry: i } = await import("./manifestBuild-ifczArzr.js"), { buildCapabilityManifest: a } = await import("./inspect-gt8bq-Tz.js"), { relative: o } = await import("node:path"), s = await n(await t(e)), c = (t, n, r) => i(t, n, o(e, r)), l = [
 		...s.queries.map((e) => c(e.descriptor, "query", e.file)),
 		...s.mutations.map((e) => c(e.descriptor, "mutation", e.file)),
 		...s.actions.map((e) => c(e.descriptor, "action", e.file)),
 		...s.streams.map((e) => c(e.descriptor, "stream", e.file))
-	], { assembleFrameworkTables: u } = await import("./frameworkTableAssembly-BsnCKzQ6.js"), d = await u({ root: e }).catch(() => []), f = new Set(s.tables.map((e) => e.tableName)), p = [...[...f].map((e) => ({ name: e })), ...d.map((e) => e.tableName).filter((e) => !f.has(e)).map((e) => ({
+	], { assembleFrameworkTables: u } = await import("./frameworkTableAssembly-lrjZtk0G.js"), d = await u({ root: e }).catch(() => []), f = new Set(s.tables.map((e) => e.tableName)), p = [...[...f].map((e) => ({ name: e })), ...d.map((e) => e.tableName).filter((e) => !f.has(e)).map((e) => ({
 		name: e,
 		framework: !0
 	}))], m = await r(e).then((e) => e?.plugins ?? []).catch(() => []);
@@ -3346,7 +3346,7 @@ never mint — inspect stays closed until an operator opens it.`);
 		breaks: [e.kind === "suffixed-outside-pages" ? "a page.tsx outside src/pages/ never routes" : "no test beside it"],
 		fix: e.kind === "suffixed-outside-pages" ? "move it under src/pages/ into the directory whose route it serves, or rename it — page.tsx is reserved" : "write the test with the file — the name is derivable",
 		severity: e.kind === "suffixed-outside-pages" ? "error" : "warn"
-	}))], m = (await Ge(o, yo(o))).map((e) => ({
+	}))], m = (await Se(o, yo(o))).map((e) => ({
 		rule: "client/not-browser-safe",
 		node: e.file,
 		file: e.file,
@@ -3382,7 +3382,7 @@ never mint — inspect stays closed until an operator opens it.`);
 		from: n,
 		mode: r ? "start" : "dev",
 		apps: process.env.VOLTRO_DASHBOARD_APPS ? "configured" : "none (set VOLTRO_DASHBOARD_APPS)"
-	}), r ? it([n]) : Ue([n]);
+	}), r ? it([n]) : we([n]);
 }, Ao = (e, t) => t ? "type" : e.startsWith("define") ? "primitive" : /^use[A-Z]/.test(e) ? "hook" : /^[A-Z]/.test(e) ? "component" : "value", jo = (e) => {
 	let t = /* @__PURE__ */ new Map(), n = (e, n) => {
 		(!t.has(e) || !n) && t.set(e, n);
@@ -3506,9 +3506,9 @@ never mint — inspect stays closed until an operator opens it.`);
 	let t = A({ scope: "dormancy" }), n = {
 		info: (e, n) => t.info(e, n ?? {}),
 		warn: (e, n) => t.warn(e, n ?? {})
-	}, r = E(e.find((e) => !e.startsWith("-")) ?? process.cwd()), i = await He(r), a = (process.env.DB_DIALECT ?? i?.store ?? "memory").toLowerCase();
+	}, r = E(e.find((e) => !e.startsWith("-")) ?? process.cwd()), i = await Ce(r), a = (process.env.DB_DIALECT ?? i?.store ?? "memory").toLowerCase();
 	if (a === "memory") return t.error("voltro dormancy needs a SQL store (postgres/mysql/mariadb/mssql) — the orchestrator and the app share the `_voltro_wakeups` table, which an in-process `memory` store cannot do. Set DB_DIALECT or the app.config `store` field."), 2;
-	let o = Number(process.env.PORT ?? Lo(e, "--port") ?? 4e3), s = Number(Lo(e, "--app-port") ?? o + 1), c = Number(Lo(e, "--idle-grace-ms") ?? 6e4), l = Number(Lo(e, "--tick-ms") ?? 1e3), u = await We(i, void 0), d = Et({
+	let o = Number(process.env.PORT ?? Lo(e, "--port") ?? 4e3), s = Number(Lo(e, "--app-port") ?? o + 1), c = Number(Lo(e, "--idle-grace-ms") ?? 6e4), l = Number(Lo(e, "--tick-ms") ?? 1e3), u = await Te(i, void 0), d = Et({
 		command: process.execPath,
 		args: [
 			process.argv[1],
@@ -3654,7 +3654,7 @@ never mint — inspect stays closed until an operator opens it.`);
 			]
 		});
 		c.push(i), await Bo(o, "web"), W.info(`running ${s.length} test file(s)`, { count: s.length });
-		let l = 0, u = Ve(), d = Ye(u);
+		let l = 0, u = ke(), d = je(u);
 		d !== void 0 && W.warn(d);
 		for (let e of s) {
 			let t = await new Promise((t) => {
@@ -3969,7 +3969,7 @@ never mint — inspect stays closed until an operator opens it.`);
 		await i.dispose();
 	}
 }, G = A({ scope: "voltro:env" }), ls = "# Environment for this app", us = async (e) => {
-	let t = await He(e).catch(() => null);
+	let t = await Ce(e).catch(() => null);
 	if (!t) return null;
 	let n = Vt(t.env) ? t.env : void 0, r = t.type === "api" ? t.plugins ?? [] : void 0;
 	return {
@@ -4001,7 +4001,7 @@ never mint — inspect stays closed until an operator opens it.`);
 	}
 	return await N.writeFile(i, r, "utf8"), G.info("wrote .env.example", { app: n.name }), 0;
 }, hs = async (e) => {
-	let t = await He(e).catch(() => null);
+	let t = await Ce(e).catch(() => null);
 	if (!t) return G.error("no app.config.ts found in the current directory"), 1;
 	let n = Vt(t.env) ? t.env : void 0;
 	return n ? (t.type === "web" ? (await ue(e, n), G.info("wrote src/voltro-env.d.ts (publicEnv augmentation)", { app: t.name ?? "app" })) : (await h(e, n), G.info("wrote env.generated.d.ts (serverEnv augmentation)", { app: t.name ?? "app" })), 0) : (G.warn("no `defineEnv` declared in app.config.ts — nothing to generate", { hint: "add `env: defineEnv({ ... })` to app.config.ts (see @voltro/env)" }), 0);
@@ -4117,7 +4117,7 @@ DB_DIALECT=mssql
 		let r = w(e, n);
 		(n === ".env.example" || j(r)) && await Ms(r) && t.push(`DB_DIALECT=mssql → ${n}`);
 	}
-	for (let n of await Be(e)) t.push(n);
+	for (let n of await xe(e)) t.push(n);
 	return t;
 }, Fs = async (e) => {
 	let t = await Ps(e);
@@ -4190,7 +4190,7 @@ DB_DIALECT=mssql
 }, Hs = async (e) => {
 	let t = Vs(e);
 	if ("error" in t) return console.error(t.error), 1;
-	let n = await We(await He(process.cwd()), void 0), r = {
+	let n = await Te(await Ce(process.cwd()), void 0), r = {
 		all: (e) => n.query({ table: e }).then((e) => e.map((e) => ({
 			...e,
 			id: String(e.id)
@@ -4645,9 +4645,11 @@ DB_DIALECT=mssql
 	"retry",
 	"cancel",
 	"suspend",
-	"resume"
+	"resume",
+	"discard",
+	"redrive"
 ], hc = () => {
-	console.log("voltro workflows — inspect + operate workflow runs on every running api"), console.log(""), console.log("Usage:"), console.log("  voltro workflows list [--status S] [--tag T] [--tail N] [--process NAME] [--format pretty|json]"), console.log("  voltro workflows start <workflowName> [--payload <json>] [--process NAME] [--format pretty|json]"), console.log("  voltro workflows show <runId> [--process NAME] [--format pretty|json]"), console.log("  voltro workflows retry|cancel|suspend|resume <runId> [--process NAME] [--format pretty|json]"), console.log("  voltro workflows signal <runId> --name <signalName> [--payload <json>] [--process NAME]"), console.log("  voltro workflows update <runId> --name <updateName> [--payload <json>] [--timeout-ms N] [--process NAME]"), console.log("  voltro workflows children <parentExecutionId> [--process NAME] [--format pretty|json]"), console.log(""), console.log("Examples:"), console.log("  voltro workflows list --status running --tail 50"), console.log("  voltro workflows start notes.summarise --payload '{\"noteId\":\"n_1\"}'"), console.log("  voltro workflows show wf_01H..."), console.log("  voltro workflows signal wf_01H... --name approve --payload '{\"by\":\"alice\"}'"), console.log("  voltro workflows update wf_01H... --name approve --payload '{\"decision\":true}'");
+	console.log("voltro workflows — inspect + operate workflow runs on every running api"), console.log(""), console.log("Usage:"), console.log("  voltro workflows list [--status S | --dead-letter] [--tag T] [--tail N] [--process NAME] [--format pretty|json]"), console.log("  voltro workflows start <workflowName> [--payload <json>] [--process NAME] [--format pretty|json]"), console.log("  voltro workflows show <runId> [--process NAME] [--format pretty|json]"), console.log("  voltro workflows retry|cancel|suspend|resume|discard|redrive <runId> [--process NAME] [--format pretty|json]"), console.log("  voltro workflows signal <runId> --name <signalName> [--payload <json>] [--process NAME]"), console.log("  voltro workflows update <runId> --name <updateName> [--payload <json>] [--timeout-ms N] [--process NAME]"), console.log("  voltro workflows children <parentExecutionId> [--process NAME] [--format pretty|json]"), console.log(""), console.log("Examples:"), console.log("  voltro workflows list --status running --tail 50"), console.log("  voltro workflows list --dead-letter          # failed runs not yet discarded"), console.log("  voltro workflows discard wf_01H...           # acknowledge a failed run"), console.log("  voltro workflows redrive wf_01H...           # re-drive a failed run from where it died"), console.log("  voltro workflows start notes.summarise --payload '{\"noteId\":\"n_1\"}'"), console.log("  voltro workflows show wf_01H..."), console.log("  voltro workflows signal wf_01H... --name approve --payload '{\"by\":\"alice\"}'"), console.log("  voltro workflows update wf_01H... --name approve --payload '{\"decision\":true}'");
 }, gc, _c = async (e) => {
 	let t = await sr(e, gc);
 	return t.length === 0 ? (console.error(e === void 0 ? "voltro workflows: no live api processes found (start one with `voltro dev`)" : `voltro workflows: no live api named '${e}'`), 1) : t;
@@ -4696,7 +4698,7 @@ DB_DIALECT=mssql
 	for (let e of s) e.kind === "err" && console.error(k.dim(`  # ${e.name}: ${e.error}`));
 	return 1;
 }, bc = async (e, t, n) => {
-	let r, i, a = 20;
+	let r, i, a = !1, o = 20;
 	for (let t = 0; t < e.length; t++) {
 		let n = e[t];
 		if (n === "--status") {
@@ -4707,41 +4709,45 @@ DB_DIALECT=mssql
 			i = e[++t];
 			continue;
 		}
+		if (n === "--dead-letter" || n === "--failed") {
+			a = !0;
+			continue;
+		}
 		if (n === "--tail") {
 			let n = e[++t], r = n === void 0 ? NaN : Number(n);
 			if (!Number.isFinite(r) || r <= 0) return console.error(`voltro workflows list: --tail expects a positive number, got '${n ?? ""}'`), 2;
-			a = Math.floor(r);
+			o = Math.floor(r);
 			continue;
 		}
 		return console.error(`voltro workflows list: unknown flag '${n}'`), 2;
 	}
-	let o = await _c(t);
-	if (typeof o == "number") return o;
-	let s = new URLSearchParams();
-	r !== void 0 && s.set("status", r), i !== void 0 && s.set("tag", i), s.set("limit", String(a));
-	let c = `/_voltro/inspect/workflows/runs?${s.toString()}`, l = await Promise.all(o.map((e) => H(e, c))), u = [], d = [];
-	for (let e of l) if (e.kind === "ok") {
+	let s = await _c(t);
+	if (typeof s == "number") return s;
+	let c = new URLSearchParams();
+	a ? c.set("deadLettered", "1") : r !== void 0 && c.set("status", r), i !== void 0 && c.set("tag", i), c.set("limit", String(o));
+	let l = `/_voltro/inspect/workflows/runs?${c.toString()}`, u = await Promise.all(s.map((e) => H(e, l))), d = [], f = [];
+	for (let e of u) if (e.kind === "ok") {
 		let t = e.data?.runs;
-		Array.isArray(t) && u.push(...t.map((t) => ({
+		Array.isArray(t) && d.push(...t.map((t) => ({
 			...t,
 			process: e.name
 		})));
-	} else d.push({
+	} else f.push({
 		name: e.name,
 		error: e.error
 	});
-	let f = u.slice(0, a);
-	if (n === "json") return vc(d.length > 0 ? {
-		runs: f,
-		fetchErrors: d
-	} : { runs: f }, +!!l.every((e) => e.kind === "err"));
-	for (let e of f) {
-		let t = String(e.runId ?? e.id ?? "?"), n = String(e.workflowName ?? e.workflow ?? e.tag ?? "?"), r = String(e.status ?? "?"), i = typeof e.source == "string" && e.source.length > 0 ? `  ${k.dim(String(e.source))}` : "", a = r === "failed" || r === "cancelled" ? k.red(r) : r === "completed" ? k.green(r) : r === "running" ? k.cyan(r) : r;
-		console.log(`${t.padEnd(28).slice(0, 28)}  ${a.padEnd(12)}  ${n}${i}  ${k.dim(`@${e.process}`)}`);
-	}
-	f.length === 0 && console.error("voltro workflows: no runs matched.");
-	for (let e of d) console.error(k.dim(`# fetch failed: ${e.name}: ${e.error}`));
-	return +!!l.every((e) => e.kind === "err");
+	let p = d.slice(0, o);
+	if (n === "json") return vc(f.length > 0 ? {
+		runs: p,
+		fetchErrors: f
+	} : { runs: p }, +!!u.every((e) => e.kind === "err"));
+	for (let e of p) {
+		let t = String(e.runId ?? e.id ?? "?"), n = String(e.workflowName ?? e.workflow ?? e.tag ?? "?"), r = String(e.status ?? "?"), i = typeof e.source == "string" && e.source.length > 0 ? `  ${k.dim(String(e.source))}` : "", a = r === "failed" || r === "cancelled" ? k.red(r) : r === "completed" ? k.green(r) : r === "running" ? k.cyan(r) : r, o = e.discardedAt == null ? "" : `  ${k.dim("discarded")}`;
+		console.log(`${t.padEnd(28).slice(0, 28)}  ${a.padEnd(12)}  ${n}${i}${o}  ${k.dim(`@${e.process}`)}`);
+	}
+	p.length === 0 && console.error("voltro workflows: no runs matched.");
+	for (let e of f) console.error(k.dim(`# fetch failed: ${e.name}: ${e.error}`));
+	return +!!u.every((e) => e.kind === "err");
 }, xc = async (e, t, n) => {
 	let r = await _c(t);
 	if (typeof r == "number") return r;
@@ -4889,7 +4895,13 @@ DB_DIALECT=mssql
 		process: i.name,
 		result: i.data
 	}, 0);
-	if (i !== void 0) return console.log(`${k.green("ok")}  ${e} ${t}  @${i.name}`), 0;
+	if (i !== void 0) {
+		if (e === "redrive" && i.data !== null && typeof i.data == "object") {
+			let e = i.data;
+			return e.redriven === !1 ? (console.error(`${k.yellow("skipped")}  redrive ${t}  @${i.name}  — ${e.reason ?? "not re-drivable"}`), 1) : (console.log(`${k.green("ok")}  redrive ${t}  @${i.name}  ` + k.dim(`(reset ${e.activitiesReset ?? 0} failed step(s); completed steps replay)`)), 0);
+		}
+		return console.log(`${k.green("ok")}  ${e} ${t}  @${i.name}`), 0;
+	}
 	console.error(`voltro workflows: ${e} ${t} failed on every api`);
 	for (let e of n) e.kind === "err" && console.error(k.dim(`  # ${e.name}: ${e.error}`));
 	return 1;
@@ -6237,7 +6249,7 @@ replicas = 1
 		for (let c of s) {
 			if (zu.has(c)) continue;
 			let s = w(e, c), l = yield* t.stat(s).pipe(D.orElseSucceed(() => null));
-			l && (l.type === "Directory" ? yield* o(s) : l.type === "File" && (Bu.test(c) && n.push(s), (Te.test(c) || Re.test(c)) && (r = !0), Me.test(c) && (i = !0), we.test(c) && (a = !0)));
+			l && (l.type === "Directory" ? yield* o(s) : l.type === "File" && (Bu.test(c) && n.push(s), (Re.test(c) || Ze.test(c)) && (r = !0), Ge.test(c) && (i = !0), Le.test(c) && (a = !0)));
 		}
 	});
 	return yield* o(e), {
@@ -6261,11 +6273,11 @@ replicas = 1
 		root: e
 	}), 1;
 	yield* D.logInfo(`discovered ${t.length} schema file(s)`, { files: t.map((t) => T(e, t)) });
-	let a = yield* Uu(t), o = (process.env.DB_DIALECT ?? "postgres").toLowerCase() === "mariadb" && (process.env.CDC ?? "1") !== "0", s = xe({
+	let a = yield* Uu(t), o = (process.env.DB_DIALECT ?? "postgres").toLowerCase() === "mariadb" && (process.env.CDC ?? "1") !== "0", s = Pe({
 		workflows: n,
 		schedules: r,
 		webhooks: i,
-		traces: be(),
+		traces: Ne(),
 		cdc: o,
 		undo: Ot()
 	}), c = [...a, ...s];
@@ -6303,7 +6315,7 @@ replicas = 1
 	return he(e);
 }, qu = async (e) => {
 	if (e.includes("--create-only")) return u(Wu(E(e.find((e) => !e.startsWith("-")) ?? process.cwd())), { scope: "voltro:migrate" });
-	let { runDbCommand: t } = await import("./dbCommand-CIrdFLp9.js");
+	let { runDbCommand: t } = await import("./dbCommand-DrzXimKf.js");
 	return t(["apply", ...e]);
 }, Ju = "voltro-backup-stamp.json", Yu = (e) => ({
 	stampVersion: 1,
@@ -6416,13 +6428,13 @@ replicas = 1
 }, cd = async (e, t) => {
 	let n = (await he(e)).makeSqlLayer(t);
 	return D.runPromise(Mt.SqlClient.pipe(D.flatMap(Qt), D.provide(n)));
-}, ld = (e) => cd(e, Je()), ud = () => {
-	let e = Je(), t = [];
+}, ld = (e) => cd(e, Oe()), ud = () => {
+	let e = Oe(), t = [];
 	return e.url && t.push(Qu(e.url)), (e.host || e.database) && t.push(`${(e.host ?? "localhost").toLowerCase()}:${e.port ?? "(default)"}/${e.database ?? ""}`), t;
 }, dd = async () => {
-	let e = await He(process.cwd());
+	let e = await Ce(process.cwd());
 	if (!e) throw new ft("voltro data: no app.config.ts found in the current directory.");
-	let t = await We(e, void 0), n = sd();
+	let t = await Te(e, void 0), n = sd();
 	return {
 		store: t,
 		snapshot: await ld(n),
@@ -6686,7 +6698,7 @@ replicas = 1
 		assets: d.assets.count
 	}), 0;
 }, Td = () => {
-	let e = Je();
+	let e = Oe();
 	return {
 		...e.url ? { url: e.url } : {},
 		...e.host ? { host: e.host } : {},
@@ -8759,7 +8771,7 @@ replicas = 1
 }, $p = /\.page\.tsx$/, em = (e) => {
 	let t = e.includes("\\src\\pages\\") ? "\\src\\pages\\" : "/src/pages/", n = e.indexOf(t);
 	return n === -1 ? null : e.slice(0, n);
-}, tm = (e) => e.endsWith(".tsx") && !je.has(e) && !n(e) && !/\.island\.tsx$/.test(e) && !$p.test(e), nm = Z({
+}, tm = (e) => e.endsWith(".tsx") && !We.has(e) && !n(e) && !/\.island\.tsx$/.test(e) && !$p.test(e), nm = Z({
 	version: "0.14.0",
 	id: "0.14.0/03_pages-suffix",
 	title: "Pages are declared with a .page.tsx suffix",
@@ -8809,18 +8821,18 @@ replicas = 1
 	}
 }), rm = [
 	/\.page\.tsx$/,
-	Ne,
+	Ke,
+	Ye,
+	qe,
+	Xe,
+	Be,
+	He,
+	Je,
 	Ie,
-	Pe,
-	Le,
-	De,
-	ke,
-	Fe,
-	Ce,
-	Ee
+	ze
 ], im = (e) => {
 	let t = S(e);
-	return !/\.tsx?$/.test(t) || je.has(t) || Se(t) || t === "index.ts" || t === "index.tsx" || t === "app.config.ts" ? !1 : !rm.some((e) => e.test(t));
+	return !/\.tsx?$/.test(t) || We.has(t) || Fe(t) || t === "index.ts" || t === "index.tsx" || t === "app.config.ts" ? !1 : !rm.some((e) => e.test(t));
 }, am = (e) => {
 	let t = [], n = [], r = [], i = [];
 	for (let [a, o] of e.getExportedDeclarations()) {
@@ -8950,7 +8962,7 @@ replicas = 1
 	].join("\n")
 }), um = (e) => {
 	let t = e.replace(/\.component(\.ui)?(\.tsx?)$/, "$2");
-	return t === e ? null : Se(t) ? t : null;
+	return t === e ? null : Fe(t) ? t : null;
 }, dm = (e) => {
 	for (let [, t] of e.getExportedDeclarations()) if (t[0] !== void 0) return !1;
 	return e.getExportDeclarations().length === 0 && e.getExportAssignments().length === 0;
@@ -9726,6 +9738,95 @@ replicas = 1
 				for (let e of i) t(`  ! ${e} — carried verbatim; CHECK IT: the value is now a PREFIX the framework`), t("      appends ':changes' / ':events:<name>' / ':members' / ':presence' to.");
 			}
 		}
+	}),
+	Z({
+		version: "0.26.0",
+		id: "0.26.0/01_event-webhook-retry-removed",
+		title: "`defineEvent({ webhook: { retry } })` is gone — it never did anything",
+		kind: "manual",
+		appliesTo: ({ project: e }) => e.getSourceFiles().some((e) => {
+			let t = e.getFullText();
+			return t.includes("defineEvent") && t.includes("webhook") && t.includes("retry");
+		}),
+		note: [
+			"The `retry` field on an event's `webhook` spec has been REMOVED from the type.",
+			"",
+			"It was declared, documented as \"default retry policy for new subscriptions\",",
+			"and read by nothing. Setting it produced no error, no warning and no effect —",
+			"the value was dropped where the event descriptor is projected into an outgoing",
+			"webhook descriptor, and there was a comment there explaining why. The comment",
+			"was a reasonable argument (the plugin's RetryPolicy is a richer shape than the",
+			"two numbers the protocol carried, and inventing the missing fields would put a",
+			"policy in place nobody wrote) but it did not change what a user experienced:",
+			"a typed option that silently does nothing.",
+			"",
+			"This is the third instance of that shape in this feature — `broadcast({ channel })`",
+			"and an event's `guards` were the first two — so the field is deleted rather than",
+			"explained.",
+			"",
+			"WHAT TO DO: if you set it, delete it. Nothing changes at runtime, because",
+			"nothing was reading it. To actually configure retry, set it on the SUBSCRIPTION",
+			"(the webhook target), where the full RetryPolicy shape is available and typed:",
+			"",
+			"  webhooks.subscribe({ event: \"order.paid\", url, retry: { maxAttempts: 5, ... } })",
+			"",
+			"If you were relying on the declared value to take effect, note that it never",
+			"did — your deliveries have been using the target default all along."
+		].join("\n")
+	}),
+	Z({
+		version: "0.26.0",
+		id: "0.26.0/02_step-retry-enforced",
+		title: "workflow step `retry:` is now ENFORCED (was metadata) — drop any redundant manual retry",
+		kind: "manual",
+		appliesTo: ({ project: e }) => e.getSourceFiles().some((e) => {
+			let t = e.getFullText();
+			return t.includes("retry:") ? t.includes("step(") || t.includes("stepModule.retry") || t.includes("Effect.retry") : !1;
+		}),
+		note: [
+			"The `retry:` field on a workflow `step({...})` is now ENFORCED. The framework",
+			"compiles it to an Effect `Schedule` (backoff, jitter, attempt cap, time budget,",
+			"error classification, provider `Retry-After`) and retries `execute` accordingly.",
+			"It used to be metadata only — recorded for the dashboard, applied by nothing.",
+			"",
+			"THE PART TO CHECK FIRST, even if you never wrote a manual retry: a step that",
+			"declared `retry:` and nothing else ran ONCE. It now runs up to `maxAttempts`",
+			"times. If `execute` is not idempotent — a charge, an email, an outbound POST —",
+			"that is real duplicate work that starts on this upgrade, and nothing in your",
+			"code changed to cause it. The 0.25.0 type said so plainly (\"Pure metadata —",
+			"does NOT change retry behavior on its own\"), so trusting it was correct.",
+			"",
+			"Go through every step that declares `retry:` and decide, per step:",
+			"  - side effect is idempotent (or guarded by an idempotency key) → keep the",
+			"    policy; this is the behaviour you wanted when you wrote it;",
+			"  - side effect is NOT idempotent → make it so, or set `maxAttempts: 1`, or",
+			"    narrow with `retryableErrors: [...]` so only transient failures retry.",
+			"",
+			"If you followed the old docs and wrapped a step in your OWN retry as well as",
+			"declaring `retry:`, that step now retries TWICE. Fix it — keep ONE:",
+			"",
+			"       // before (retry: was metadata; the real retry was the wrapper)",
+			"       yield* stepModule.retry(",
+			"         step({ name: 'call-provider', retry: { maxAttempts: 5 }, execute }),",
+			"         Schedule.exponential('500 millis').pipe(Schedule.recurs(4)),",
+			"       )",
+			"",
+			"       // after — the declarative policy IS the retry now",
+			"       yield* step({",
+			"         name: 'call-provider',",
+			"         retry: { maxAttempts: 5, strategy: 'exponential', baseDelay: '500 millis' },",
+			"         execute,",
+			"       })",
+			"",
+			"The declarative form is the one to keep in almost every case — it also drives the",
+			"dashboard. Keep a hand-written `stepModule.retry(…, Schedule)` ONLY when your",
+			"Schedule does something the policy can't express, and then DROP the `retry:` field",
+			"from that step so it is not applied on top.",
+			"",
+			"New conditions worth adopting while you are here: `retryableErrors: ['ProviderDown']`",
+			"(retry transient, fail permanent), `maxElapsed: '5 minutes'` (a total time budget,",
+			"not just a count), `jitter` (on by default), and `respectRetryAfter` (honor a 429)."
+		].join("\n")
 	})
 ], $m = /* @__PURE__ */ new Set([
 	"node_modules",
@@ -11459,7 +11560,7 @@ image, use \`voltro serverless serve\` from the project root.
 		name: "dev",
 		summary: "Start the local development server (auto-discovers routes / mutations).",
 		status: "wired",
-		run: Ue
+		run: we
 	},
 	{
 		name: "dashboard",

package/dist/dbCommand-DrzXimKf.js

@@ -0,0 +1,2 @@
+import { s as e } from "./dbCommand-uuNCrFAb.js";
+export { e as runDbCommand };