@voltro/cli 0.53.0 → 0.55.0

package/dist/{checkCommand-C5elt0tW.js → checkCommand-fbj9GDjN.js}

@@ -1,10 +1,10 @@
 import { t as e } from "./cliArgs-D4p8n7EE.js";
-import { a as t, l as n } from "./codegen-FEk8AZHb.js";
+import { a as t, l as n } from "./codegen-SIepQtUl.js";
 import { r } from "./appGraph-yRuKjOba.js";
 import { n as i } from "./cliOutput-D1tSBoRM.js";
 import { n as a, o, r as s, t as c } from "./inspectFetch-EMuhTG_9.js";
-import { r as l } from "./fileTaxonomy-B7uxipWS.js";
-import { S as u } from "./doctorCommand-etMkflRc.js";
+import { r as l } from "./fileTaxonomy-CbyMQYx_.js";
+import { S as u } from "./doctorCommand-CGZJK_4o.js";
 import { resolve as d } from "node:path";
 import { readdirSync as f, statSync as p } from "node:fs";
 import { isReactivityChannelKey as m } from "@voltro/protocol";
@@ -170,9 +170,9 @@ var h = (e) => (e === void 0 ? [] : typeof e == "string" ? [e] : e).filter((e) =
 	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"), O = async (e) => {
-	let { walk: t, loadDiscovered: n, loadApiConfig: r } = await import("./dev-GjJWAYo2.js"), { buildRpcEntry: i } = await import("./manifestBuild-C4-J1-m_.js"), { buildCapabilityManifest: a } = await import("./inspect-CuoDInfZ.js"), { relative: o } = await import("node:path"), s = await n(await t(e)), c = await r(e).then((e) => e?.plugins ?? []).catch(() => []);
+	let { walk: t, loadDiscovered: n, loadApiConfig: r } = await import("./dev-DfVZaoys.js"), { buildRpcEntry: i } = await import("./manifestBuild-CJ2zvPvT.js"), { buildCapabilityManifest: a } = await import("./inspect-DGJwpOAb.js"), { relative: o } = await import("node:path"), s = await n(await t(e)), c = await r(e).then((e) => e?.plugins ?? []).catch(() => []);
 	try {
-		let { mergePluginRoutesInto: e } = await import("./dev-GjJWAYo2.js");
+		let { mergePluginRoutesInto: e } = await import("./dev-DfVZaoys.js");
 		e({
 			plugins: c,
 			queries: s.queries,
@@ -189,7 +189,7 @@ var h = (e) => (e === void 0 ? [] : typeof e == "string" ? [e] : e).filter((e) =
 		...s.mutations.map((e) => l(e.descriptor, "mutation", e.file)),
 		...s.actions.map((e) => l(e.descriptor, "action", e.file)),
 		...s.streams.map((e) => l(e.descriptor, "stream", e.file))
-	], { assembleFrameworkTables: d } = await import("./frameworkTableAssembly-C_7Z-rMs.js"), f = await d({ root: e }).catch((e) => (console.warn(`\n⚠  plugin tables could not be collected — this report is INCOMPLETE.\n   ${e instanceof Error ? e.message.split("\n")[0] : String(e)}\n`), [])), p = new Set(s.tables.map((e) => e.tableName)), m = [...[...p].map((e) => ({ name: e })), ...f.map((e) => e.tableName).filter((e) => !p.has(e)).map((e) => ({
+	], { assembleFrameworkTables: d } = await import("./frameworkTableAssembly-Df2Ymp2f.js"), f = await d({ root: e }).catch((e) => (console.warn(`\n⚠  plugin tables could not be collected — this report is INCOMPLETE.\n   ${e instanceof Error ? e.message.split("\n")[0] : String(e)}\n`), [])), p = new Set(s.tables.map((e) => e.tableName)), m = [...[...p].map((e) => ({ name: e })), ...f.map((e) => e.tableName).filter((e) => !p.has(e)).map((e) => ({
 		name: e,
 		framework: !0
 	}))], h = c;

package/dist/{cloudCmd-QUXh-b5w.js → cloudCmd-DzKcSYuy.js}

@@ -1,7 +1,7 @@
 import { a as e, t } from "./cliArgs-D4p8n7EE.js";
 import { a as n, i as r, n as i, r as a, t as o } from "./cloudClient-DWL-Hw_T.js";
 import { n as s } from "./cliOutput-D1tSBoRM.js";
-import { d as c, f as l, o as u } from "./projectScaffold-B4dmTlwT.js";
+import { d as c, f as l, o as u } from "./projectScaffold-CSN0OzBV.js";
 import { basename as d, join as f, resolve as p } from "node:path";
 import { promises as m } from "node:fs";
 import { ansi as h } from "@voltro/logger";

package/dist/codegen-CN6vMM4J.js

@@ -0,0 +1,2 @@
+import { t as e } from "./codegen-SIepQtUl.js";
+export { e as checkRpcGroupFreshness };

package/dist/{codegen-FEk8AZHb.js → codegen-SIepQtUl.js}

@@ -1,4 +1,4 @@
-import { b as e, s as t, x as n } from "./fileConventions-DASGEmj-.js";
+import { S as e, c as t, x as n } from "./fileConventions-l-RIXbx8.js";
 import { dirname as r, join as i, relative as a, resolve as o } from "node:path";
 import { promises as s, readFileSync as c } from "node:fs";
 import { pathToFileURL as l } from "node:url";
@@ -162,7 +162,7 @@ var h = /* @__PURE__ */ new Set(/* @__PURE__ */ "crypto.fs.path.os.net.http.http
 				await a(o);
 				continue;
 			}
-			s.isFile() && (n.test(s.name) || e.test(s.name)) && r.push(o);
+			s.isFile() && (e.test(s.name) || n.test(s.name)) && r.push(o);
 		}
 	};
 	return await a(t), r;
@@ -304,8 +304,8 @@ ${o.join("\n\n")}\n`);
 		file: t,
 		reason: "a descriptor changed since the group was generated"
 	};
-}, Q = (e, t, n, i = [], o = [], s = !1, l = !1, u = [], d = "") => {
-	let f = o.length > 0, m = o.flatMap((e) => [{
+}, Q = (e, t, n, i = [], o = [], s = !1, l = !1, u = [], d = {}, f = "") => {
+	let m = o.length > 0, h = o.flatMap((e) => [{
 		file: e.file,
 		exportName: e.exportName,
 		rpcTag: `${e.name}.send`,
@@ -315,7 +315,7 @@ ${o.join("\n\n")}\n`);
 		exportName: e.exportName,
 		rpcTag: `${e.name}.messages`,
 		kind: "query"
-	}]), h = [...new Map(u.map((e) => [e.tag, e])).values()].sort((e, t) => e.tag < t.tag ? -1 : 1), g = h.map((e) => ({
+	}]), g = [...new Map(u.map((e) => [e.tag, e])).values()].sort((e, t) => e.tag < t.tag ? -1 : 1), _ = g.map((e) => ({
 		file: `plugin:${e.module}`,
 		exportName: e.name,
 		rpcTag: e.tag,
@@ -323,26 +323,26 @@ ${o.join("\n\n")}\n`);
 	}));
 	ee([
 		...n,
-		...m,
-		...g
+		...h,
+		..._
 	], e), q([
 		...n,
-		...m,
-		...g
+		...h,
+		..._
 	], e);
-	let _ = (e) => e.replace(/[^a-zA-Z0-9_$]/g, "_"), v = (e) => `__src_agent_${_(e.name)}`, y = (e) => `__agentRoutes_${_(e.name)}`, b = i.length > 0, x = i.map((e, t) => `import { ${e.name} as __pe${t} } from '${e.module}'`), S = b ? ", __voltroPluginErrors" : "", C = h.length > 0, w = h.map((e, t) => `import { ${e.name} as __prpc${t} } from '${e.module}'`), T = (e) => e === "query" ? "queryToRpc" : e === "mutation" ? "mutationToRpc" : "actionToRpc", E = h.map((e, t) => `export const ${G(e.tag)} = ${T(e.kind)}(__prpc${t}${S})`), D = h.map((e) => `  ${G(e.tag)},`), O = [...n].sort((e, t) => e.kind === t.kind ? e.rpcTag < t.rpcTag ? -1 : 1 : J(e.kind) - J(t.kind)), k = r(t), A = (e) => `__src_${G(e.rpcTag)}`, j = (e) => {
-		let t = `./${a(k, e.file).replace(/\\/g, "/").replace(/\.tsx?$/, "")}`;
-		return `import { ${e.exportName} as ${A(e)} } from '${t}'`;
-	}, M = (e) => {
-		let t = G(e.rpcTag), n = A(e);
-		return e.kind === "query" ? `export const ${t} = queryToRpc(${n}${S})` : e.kind === "mutation" ? `export const ${t} = mutationToRpc(${n}${S})` : e.kind === "action" ? `export const ${t} = actionToRpc(${n}${S})` : e.kind === "stream" ? `export const ${t} = streamToRpc(${n}${S})` : e.kind === "event" ? `export const ${t} = eventToRpc(${n}${S})` : [
+	let v = (e) => e.replace(/[^a-zA-Z0-9_$]/g, "_"), y = (e) => `__src_agent_${v(e.name)}`, b = (e) => `__agentRoutes_${v(e.name)}`, x = i.length > 0, S = i.map((e, t) => `import { ${e.name} as __pe${t} } from '${e.module}'`), C = x ? ", __voltroPluginErrors" : "", w = g.length > 0, T = g.map((e, t) => `import { ${e.name} as __prpc${t} } from '${e.module}'`), E = (e) => e === "query" ? "queryToRpc" : e === "mutation" ? "mutationToRpc" : "actionToRpc", D = g.map((e, t) => `export const ${G(e.tag)} = ${E(e.kind)}(withRpcTag(__prpc${t}, ${JSON.stringify(e.tag)})${C})`), O = g.map((e) => `  ${G(e.tag)},`), k = [...n].sort((e, t) => e.kind === t.kind ? e.rpcTag < t.rpcTag ? -1 : 1 : J(e.kind) - J(t.kind)), A = r(t), j = (e) => `__src_${G(e.rpcTag)}`, M = (e) => {
+		let t = `./${a(A, e.file).replace(/\\/g, "/").replace(/\.tsx?$/, "")}`;
+		return `import { ${e.exportName} as ${j(e)} } from '${t}'`;
+	}, N = (e) => {
+		let t = G(e.rpcTag), n = j(e);
+		return e.kind === "query" ? `export const ${t} = queryToRpc(${n}${C})` : e.kind === "mutation" ? `export const ${t} = mutationToRpc(${n}${C})` : e.kind === "action" ? `export const ${t} = actionToRpc(${n}${C})` : e.kind === "stream" ? `export const ${t} = streamToRpc(${n}${C})` : e.kind === "event" ? `export const ${t} = eventToRpc(${n}${C})` : [
 			`export const ${t} = Rpc.make('${e.rpcTag}', {`,
 			`  payload: strictInput(${n}.payloadSchema),`,
 			"  success: WorkflowRunHandleSchema,",
 			`  error:   ${n}.errorSchema,`,
 			"})"
 		].join("\n");
-	}, N = [...O.filter((e) => e.kind === "query" || e.kind === "mutation" || e.kind === "action" || e.kind === "stream").map((e) => `  | __AppErrorOf<typeof ${A(e)}>`), ...b ? ["  | Schema.Schema.Type<(typeof __voltroPluginErrors)[number]>"] : []], P = N.length > 0, F = O.some((e) => e.kind === "workflow"), I = F ? [
+	}, P = [...k.filter((e) => e.kind === "query" || e.kind === "mutation" || e.kind === "action" || e.kind === "stream").map((e) => `  | __AppErrorOf<typeof ${j(e)}>`), ...x ? ["  | Schema.Schema.Type<(typeof __voltroPluginErrors)[number]>"] : []], F = P.length > 0, I = k.some((e) => e.kind === "workflow"), L = I ? [
 		"__voltroWorkflowRun",
 		"__voltroWorkflowRuns",
 		"__voltroWorkflowRunSteps",
@@ -353,27 +353,29 @@ ${o.join("\n\n")}\n`);
 		"__voltroWorkflowResume",
 		"__voltroWorkflowSignal",
 		"__voltroWorkflowUpdate"
-	] : [], L = s ? [
+	] : [], R = s ? [
 		"__voltroUndoLog",
 		"__voltroUndoApply",
 		"__voltroUndoRedo"
-	] : [], R = O.some((e) => e.requiresApproval === !0), z = R ? ["__voltroApprovalsPending", "__voltroApprovalsDecide"] : [], B = l ? [
+	] : [], z = k.some((e) => e.requiresApproval === !0), B = z ? ["__voltroApprovalsPending", "__voltroApprovalsDecide"] : [], V = l ? [
 		"__voltroConnectionsList",
 		"__voltroConnectionStart",
 		"__voltroConnectionSubmitToken",
 		"__voltroConnectionDisconnect"
-	] : [], V = [
-		...O.map((e) => `  ${G(e.rpcTag)},`),
+	] : [], H = [
+		...k.map((e) => `  ${G(e.rpcTag)},`),
 		...o.flatMap((e) => [`  ${G(`${e.name}.send`)},`, `  ${G(`${e.name}.messages`)},`]),
-		...I.map((e) => `  ${e},`),
 		...L.map((e) => `  ${e},`),
-		...z.map((e) => `  ${e},`),
+		...R.map((e) => `  ${e},`),
 		...B.map((e) => `  ${e},`),
-		...D
-	].join("\n"), H = ["queryToRpc"];
-	(O.some((e) => e.kind === "mutation") || h.some((e) => e.kind === "mutation")) && H.push("mutationToRpc"), (O.some((e) => e.kind === "action") || F || f || h.some((e) => e.kind === "action")) && H.push("actionToRpc"), O.some((e) => e.kind === "stream") && H.push("streamToRpc"), O.some((e) => e.kind === "event") && H.push("eventToRpc"), F && H.push("strictInput", "WorkflowRunHandleSchema", "workflowCancelDescriptor", "workflowDomainEventsQueryDescriptor", "workflowEventDeliveriesQueryDescriptor", "workflowResumeDescriptor", "workflowRunEventsQueryDescriptor", "workflowRunQueryDescriptor", "workflowRunsQueryDescriptor", "workflowRunStepsQueryDescriptor", "workflowSignalDescriptor", "workflowUpdateDescriptor"), s && H.push("mutationToRpc", "undoLogQueryDescriptor", "undoApplyDescriptor", "undoRedoDescriptor"), R && H.push("mutationToRpc", "approvalsPendingQueryDescriptor", "approvalsDecideDescriptor"), l && H.push("mutationToRpc", "actionToRpc", "connectionsListQueryDescriptor", "connectionStartDescriptor", "connectionSubmitTokenDescriptor", "connectionDisconnectDescriptor"), (O.some((e) => e.kind === "query" || e.kind === "mutation" || e.kind === "action" || e.kind === "stream") || f || F || s || R || l || C) && H.push("normalizeDescriptor");
-	let U = [...new Set(H)].sort(), W = [...O.filter((e) => e.kind === "query" || e.kind === "mutation" || e.kind === "action" || e.kind === "stream").map((e) => [e.rpcTag, A(e)]), ...o.flatMap((e) => [[`${e.name}.send`, `${y(e)}.send`], [`${e.name}.messages`, `${y(e)}.messages`]])], K = [
-		...F ? [
+		...V.map((e) => `  ${e},`),
+		...O
+	].join("\n"), U = ["queryToRpc"];
+	w && U.push("withRpcTag");
+	let W = Object.entries(d).sort(([e], [t]) => e < t ? -1 : 1), K = W.length > 0;
+	K && U.push("registerPluginAliases"), (k.some((e) => e.kind === "mutation") || g.some((e) => e.kind === "mutation")) && U.push("mutationToRpc"), (k.some((e) => e.kind === "action") || I || m || g.some((e) => e.kind === "action")) && U.push("actionToRpc"), k.some((e) => e.kind === "stream") && U.push("streamToRpc"), k.some((e) => e.kind === "event") && U.push("eventToRpc"), I && U.push("strictInput", "WorkflowRunHandleSchema", "workflowCancelDescriptor", "workflowDomainEventsQueryDescriptor", "workflowEventDeliveriesQueryDescriptor", "workflowResumeDescriptor", "workflowRunEventsQueryDescriptor", "workflowRunQueryDescriptor", "workflowRunsQueryDescriptor", "workflowRunStepsQueryDescriptor", "workflowSignalDescriptor", "workflowUpdateDescriptor"), s && U.push("mutationToRpc", "undoLogQueryDescriptor", "undoApplyDescriptor", "undoRedoDescriptor"), z && U.push("mutationToRpc", "approvalsPendingQueryDescriptor", "approvalsDecideDescriptor"), l && U.push("mutationToRpc", "actionToRpc", "connectionsListQueryDescriptor", "connectionStartDescriptor", "connectionSubmitTokenDescriptor", "connectionDisconnectDescriptor"), (k.some((e) => e.kind === "query" || e.kind === "mutation" || e.kind === "action" || e.kind === "stream") || m || I || s || z || l || w) && U.push("normalizeDescriptor");
+	let Y = [...new Set(U)].sort(), X = [...k.filter((e) => e.kind === "query" || e.kind === "mutation" || e.kind === "action" || e.kind === "stream").map((e) => [e.rpcTag, j(e)]), ...o.flatMap((e) => [[`${e.name}.send`, `${b(e)}.send`], [`${e.name}.messages`, `${b(e)}.messages`]])], Z = [
+		...I ? [
 			["__voltro.workflow.run", "workflowRunQueryDescriptor"],
 			["__voltro.workflow.runs", "workflowRunsQueryDescriptor"],
 			["__voltro.workflow.run.steps", "workflowRunStepsQueryDescriptor"],
@@ -390,20 +392,20 @@ ${o.join("\n\n")}\n`);
 			["__voltro.undo.apply", "undoApplyDescriptor"],
 			["__voltro.undo.redo", "undoRedoDescriptor"]
 		] : [],
-		...R ? [["__voltro.approvals.pending", "approvalsPendingQueryDescriptor"], ["__voltro.approvals.decide", "approvalsDecideDescriptor"]] : [],
+		...z ? [["__voltro.approvals.pending", "approvalsPendingQueryDescriptor"], ["__voltro.approvals.decide", "approvalsDecideDescriptor"]] : [],
 		...l ? [
 			["__voltro.connections.list", "connectionsListQueryDescriptor"],
 			["__voltro.connections.start", "connectionStartDescriptor"],
 			["__voltro.connections.submitToken", "connectionSubmitTokenDescriptor"],
 			["__voltro.connections.disconnect", "connectionDisconnectDescriptor"]
 		] : [],
-		...h.map((e, t) => [e.tag, `__prpc${t}`])
-	], Y = ([e, t]) => `  ${JSON.stringify(e)}: normalizeDescriptor(${t}),`, X = ([e, t]) => `  readonly ${JSON.stringify(e)}: typeof ${t}`, Z = W.map(Y), Q = K.map(Y), $ = O.filter((e) => e.kind === "workflow").map((e) => `  ${JSON.stringify(e.rpcTag)}: { kind: 'workflow' },`), ne = O.filter((e) => e.kind === "workflow").map((e) => `  readonly ${JSON.stringify(e.rpcTag)}: { readonly kind: 'workflow' }`), re = [
-		...W.map(X),
-		...ne,
-		...K.map(X)
-	], ie = O.filter((e) => e.kind === "workflow").map((e) => {
-		let t = A(e);
+		...g.map((e, t) => [e.tag, `__prpc${t}`])
+	], Q = ([e, t]) => `  ${JSON.stringify(e)}: normalizeDescriptor(${t}),`, $ = ([e, t]) => `  readonly ${JSON.stringify(e)}: typeof ${t}`, ne = X.map(Q), re = Z.map(Q), ie = k.filter((e) => e.kind === "workflow").map((e) => `  ${JSON.stringify(e.rpcTag)}: { kind: 'workflow' },`), ae = k.filter((e) => e.kind === "workflow").map((e) => `  readonly ${JSON.stringify(e.rpcTag)}: { readonly kind: 'workflow' }`), oe = [
+		...X.map($),
+		...ae,
+		...Z.map($)
+	], se = k.filter((e) => e.kind === "workflow").map((e) => {
+		let t = j(e);
 		return [
 			`  ${JSON.stringify(e.rpcTag)}: {`,
 			"    kind: 'workflow',",
@@ -414,44 +416,53 @@ ${o.join("\n\n")}\n`);
 			`    updates: __voltroWorkflowMessages(${t}).updates,`,
 			"  },"
 		].join("\n");
-	}), ae = [...O, ...o.map((e) => ({
+	}), ce = [...k, ...o.map((e) => ({
 		rpcTag: `agent:${e.name}`,
 		file: e.file
 	}))];
 	return [
 		"// THIS FILE IS GENERATED — DO NOT EDIT BY HAND.",
 		"// Re-emitted by `voltro dev` whenever query/mutation/action/stream/workflow files change.",
-		`// descriptor-fingerprint: ${p("sha1").update(ae.map((e) => {
+		`// descriptor-fingerprint: ${p("sha1").update(ce.map((e) => {
 			let t = "";
 			try {
 				t = c(e.file, "utf8");
 			} catch {}
 			return `${e.rpcTag}\u0000${t}`;
 		}).join("
")).digest("hex").slice(0, 16)}`,
-		`${te}${d}`,
+		`${te}${f}`,
 		"// Source files:",
-		...O.map((t) => `//   - ${a(e, t.file).replace(/\\/g, "/")}`),
+		...k.map((t) => `//   - ${a(e, t.file).replace(/\\/g, "/")}`),
 		...o.map((t) => `//   - ${a(e, t.file).replace(/\\/g, "/")}  (agent)`),
 		"",
-		F ? "import { Rpc, RpcGroup } from '@effect/rpc'" : "import { RpcGroup } from '@effect/rpc'",
-		...F || P ? ["import { Schema } from 'effect'"] : [],
-		`import { ${U.join(", ")} } from '@voltro/protocol'`,
-		...f ? ["import { agentRouteDescriptors as __voltroAgentRoutes } from '@voltro/ai/agent'"] : [],
+		I ? "import { Rpc, RpcGroup } from '@effect/rpc'" : "import { RpcGroup } from '@effect/rpc'",
+		...I || F ? ["import { Schema } from 'effect'"] : [],
+		`import { ${Y.join(", ")} } from '@voltro/protocol'`,
+		...m ? ["import { agentRouteDescriptors as __voltroAgentRoutes } from '@voltro/ai/agent'"] : [],
 		"",
-		...O.map(j),
-		...o.map((e) => `import { ${e.exportName} as ${v(e)} } from './${a(k, e.file).replace(/\\/g, "/").replace(/\.tsx?$/, "")}'`),
-		...b ? ["", ...x] : [],
-		...C ? ["", ...w] : [],
+		...k.map(M),
+		...o.map((e) => `import { ${e.exportName} as ${y(e)} } from './${a(A, e.file).replace(/\\/g, "/").replace(/\.tsx?$/, "")}'`),
+		...x ? ["", ...S] : [],
+		...w ? ["", ...T] : [],
+		...K ? [
+			"",
+			"/** Which namespace each installed plugin answers to in THIS app. Read by",
+			" *  the plugins' own client hooks via `pluginTag()` so an `alias` in",
+			" *  app.config.ts moves them too, not just the server's routes. */",
+			"registerPluginAliases({",
+			...W.map(([e, t]) => `  ${JSON.stringify(e)}: ${JSON.stringify(t)},`),
+			"})"
+		] : [],
 		"",
-		...o.map((e) => `const ${y(e)} = __voltroAgentRoutes(${v(e)})`),
-		...f ? [""] : [],
-		...b ? [
+		...o.map((e) => `const ${b(e)} = __voltroAgentRoutes(${y(e)})`),
+		...m ? [""] : [],
+		...x ? [
 			"/** Cross-cutting plugin error schemas, unioned into every rpc's",
 			" *  wire error so interceptor failures decode typed on the client. */",
 			`const __voltroPluginErrors = [${i.map((e, t) => `__pe${t}`).join(", ")}] as const`,
 			""
 		] : [],
-		...F ? [
+		...I ? [
 			"const __voltroEmptyWorkflowMessages = { signals: {}, updates: {} } as const",
 			"const __voltroWorkflowMessages = <const M extends {",
 			"  readonly signals: Readonly<Record<string, Schema.Schema.Any>>",
@@ -460,7 +471,7 @@ ${o.join("\n\n")}\n`);
 			"  definition.__voltroWorkflowMessages ?? __voltroEmptyWorkflowMessages",
 			"",
 			"export const workflowDescriptors = {",
-			...ie,
+			...se,
 			"} as const",
 			"",
 			"export type WorkflowDescriptors = typeof workflowDescriptors",
@@ -479,9 +490,9 @@ ${o.join("\n\n")}\n`);
 			"} }",
 			""
 		] : [],
-		...O.map(M),
-		...o.flatMap((e) => [`export const ${G(`${e.name}.send`)} = actionToRpc(${y(e)}.send${S})`, `export const ${G(`${e.name}.messages`)} = queryToRpc(${y(e)}.messages${S})`]),
-		...F ? [
+		...k.map(N),
+		...o.flatMap((e) => [`export const ${G(`${e.name}.send`)} = actionToRpc(${b(e)}.send${C})`, `export const ${G(`${e.name}.messages`)} = queryToRpc(${b(e)}.messages${C})`]),
+		...I ? [
 			"export const __voltroWorkflowRun = queryToRpc(workflowRunQueryDescriptor)",
 			"export const __voltroWorkflowRuns = queryToRpc(workflowRunsQueryDescriptor)",
 			"export const __voltroWorkflowRunSteps = queryToRpc(workflowRunStepsQueryDescriptor)",
@@ -498,26 +509,26 @@ ${o.join("\n\n")}\n`);
 			"export const __voltroUndoApply = mutationToRpc(undoApplyDescriptor)",
 			"export const __voltroUndoRedo = mutationToRpc(undoRedoDescriptor)"
 		] : [],
-		...R ? ["export const __voltroApprovalsPending = queryToRpc(approvalsPendingQueryDescriptor)", "export const __voltroApprovalsDecide = mutationToRpc(approvalsDecideDescriptor)"] : [],
+		...z ? ["export const __voltroApprovalsPending = queryToRpc(approvalsPendingQueryDescriptor)", "export const __voltroApprovalsDecide = mutationToRpc(approvalsDecideDescriptor)"] : [],
 		...l ? [
 			"export const __voltroConnectionsList = queryToRpc(connectionsListQueryDescriptor)",
 			"export const __voltroConnectionStart = actionToRpc(connectionStartDescriptor)",
 			"export const __voltroConnectionSubmitToken = mutationToRpc(connectionSubmitTokenDescriptor)",
 			"export const __voltroConnectionDisconnect = mutationToRpc(connectionDisconnectDescriptor)"
 		] : [],
-		...E,
+		...D,
 		"",
 		"export const appGroup = RpcGroup.make(",
-		V,
+		H,
 		")",
 		"",
 		"/** Per-rpc-tag metadata for the client. Drives auto-optimistic etc.",
 		" *  Function fields (target.shape, target.identify) survive because",
 		" *  the descriptors themselves are imported by reference. */",
 		"export const appDescriptors = {",
-		...Z,
-		...$,
-		...Q,
+		...ne,
+		...ie,
+		...re,
 		"} as const",
 		"",
 		"export type AppDescriptors = typeof appDescriptors",
@@ -541,16 +552,16 @@ ${o.join("\n\n")}\n`);
 		" *  Types only — erased at build time, so importing it costs the bundle",
 		" *  nothing. */",
 		"export type AppProcedures = {",
-		...re,
+		...oe,
 		"}",
 		"",
-		...P ? [
+		...F ? [
 			"type __AppErrorOf<D> = D extends { readonly error: infer E extends Schema.Schema.Any } ? Schema.Schema.Type<E> : never",
 			"/** Union of every typed error the app's rpcs can fail with — the declared",
 			" *  `error:` schemas + cross-cutting plugin errors. Generated by reference,",
 			" *  so it can never drift out of date. (Workflows: see `WorkflowErrors`.) */",
 			"export type AppError =",
-			...N,
+			...P,
 			"/** The `_tag` literal of every AppError — the exhaustive key set for `matchError`. */",
 			"export type AppErrorTag = AppError extends { readonly _tag: infer T extends string } ? T : never",
 			"",
@@ -594,7 +605,7 @@ ${o.join("\n\n")}\n`);
 		"workflows"
 	]), p = (e) => e.slice(e.lastIndexOf("/") + 1), m = u;
 	for (; m !== t && d.has(p(m));) m = m.slice(0, m.lastIndexOf("/")) || "/";
-	let h = o(e.outputFile ?? i(m, "rpcGroup.generated.ts")), g = [...new Map((e.pluginErrorImports ?? []).map((e) => [`${e.module}#${e.name}`, e])).values()], _ = [...new Map((e.pluginRpcImports ?? []).map((e) => [e.tag, e])).values()], v = await Y(r(h)), y = Q(t, h, a, g, c, f(), l, _, v), b = [];
+	let h = o(e.outputFile ?? i(m, "rpcGroup.generated.ts")), g = [...new Map((e.pluginErrorImports ?? []).map((e) => [`${e.module}#${e.name}`, e])).values()], _ = [...new Map((e.pluginRpcImports ?? []).map((e) => [e.tag, e])).values()], v = await Y(r(h)), y = Q(t, h, a, g, c, f(), l, _, e.pluginAliases ?? {}, v), b = [];
 	for (let t of e.pluginContributions ?? []) {
 		let e = null;
 		try {

package/dist/codegenCommand-3TDJezom.js

@@ -0,0 +1,42 @@
+import { Dn as e, En as t, V as n, l as r, u as i } from "./dev-Ca_A_S9v.js";
+import { n as a } from "./frameworkTableAssembly-Do-cf6RJ.js";
+import { i as o, r as s } from "./codegen-SIepQtUl.js";
+import { n as c, r as l } from "./mobileCommand-D9O6iq3D.js";
+import { basename as u, relative as d, resolve as f } from "node:path";
+//#region src/codegenCommand.ts
+var p = async (t) => {
+	let { config: i, present: a, error: o } = await r(t);
+	if (a && i === null) return {
+		kind: "refused",
+		reason: "app.config.ts exists but could not be loaded" + (o === void 0 ? "" : ` — ${o instanceof Error ? o.message : String(o)}`)
+	};
+	let c = i?.plugins ?? [], { pluginContributions: l, pluginErrorImports: d, pluginRpcImports: f, pluginAliases: p } = await n(c, i?.name ?? u(t), t), h = await s({
+		root: t,
+		...l.length > 0 ? { pluginContributions: l } : {},
+		...d.length > 0 ? { pluginErrorImports: d } : {},
+		...f.length > 0 ? { pluginRpcImports: f } : {},
+		...Object.keys(p).length > 0 ? { pluginAliases: p } : {},
+		...i?.name === void 0 ? {} : { apiName: i.name }
+	});
+	if (!h) return { kind: "nothing-to-write" };
+	let g = await m(t, i), _ = await e(h, g);
+	return {
+		kind: "wrote",
+		file: h,
+		plugins: c.length,
+		errorSchemas: d.length,
+		routes: f.length,
+		tables: g.size,
+		dts: _
+	};
+}, m = async (e, n) => {
+	let r = await o(e), { tables: s } = await i(r), c = await a({ root: e });
+	return t(s, c, n?.analytics?.tables ?? []);
+}, h = async (e) => {
+	let t = f(e.find((e) => !e.startsWith("-")) ?? process.cwd()), n = await l(t);
+	if (n.apis.kind !== "not-a-mobile-app") return c(t, n);
+	let r = await p(t);
+	return r.kind === "refused" ? (console.error(`voltro codegen: ${r.reason} — 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."), 1) : r.kind === "nothing-to-write" ? (console.log("voltro codegen: no rpc primitives found — nothing to write."), 0) : (console.log(`voltro codegen: wrote ${d(t, r.file)} (plugins ${r.plugins}, error schemas ${r.errorSchemas}, plugin routes ${r.routes})`), console.log(r.dts.action === "removed" ? `  removed ${d(t, r.dts.path)} — no tables declared, so \`source:\` is \`string\` again` : r.dts.action === "skipped" ? "  no tables declared — `source:` stays `string`" : `  ${r.dts.action} ${d(t, r.dts.path)} (${r.tables} table name(s) typed for \`source:\`)`), r.plugins > 0 && r.errorSchemas === 0 && console.log("  note: no plugin contributed a cross-cutting error schema, so the wire error union carries only each procedure's own `error:`. Expected if none of your plugins declare `errorSchemas` — but `guards:` needs @voltro/plugin-rbac for its ScopeError to decode typed."), 0);
+};
+//#endregion
+export { p as regenerateRpcGroup, h as runCodegenCommand };

package/dist/{codemodRunner-BjtB2lq6.js → codemodRunner-C2zxZUIw.js}

@@ -1,7 +1,7 @@
-import { D as e, E as t, F as n, d as r, f as i, g as a, i as o, k as s, p as c, r as l, u } from "./fileConventions-DASGEmj-.js";
-import { t as d } from "./pageConvention-C938S8oC.js";
+import { A as e, D as t, I as n, O as r, _ as i, d as a, f as o, i as s, m as c, p as l, r as u } from "./fileConventions-l-RIXbx8.js";
+import { t as d } from "./pageConvention-CMpfDN6r.js";
 import { r as f } from "./tsconfigPaths-BWXBWgcl.js";
-import { a as p, i as m, t as h } from "./fileTaxonomy-B7uxipWS.js";
+import { a as p, i as m, t as h } from "./fileTaxonomy-CbyMQYx_.js";
 import { basename as g, dirname as _, join as v, relative as ee } from "node:path";
 import { existsSync as y, readFileSync as te, statSync as ne } from "node:fs";
 import { execFileSync as re } from "node:child_process";
@@ -1503,7 +1503,7 @@ var S = (e, t, n) => {
 }, dt = /\.page\.tsx$/, F = (e) => {
 	let t = e.includes("\\src\\pages\\") ? "\\src\\pages\\" : "/src/pages/", n = e.indexOf(t);
 	return n === -1 ? null : e.slice(0, n);
-}, ft = (e) => e.endsWith(".tsx") && !a.has(e) && !d(e) && !/\.island\.tsx$/.test(e) && !dt.test(e), pt = w({
+}, ft = (e) => e.endsWith(".tsx") && !i.has(e) && !d(e) && !/\.island\.tsx$/.test(e) && !dt.test(e), pt = w({
 	version: "0.14.0",
 	id: "0.14.0/03_pages-suffix",
 	title: "Pages are declared with a .page.tsx suffix",
@@ -1554,17 +1554,17 @@ var S = (e, t, n) => {
 }), mt = [
 	/\.page\.tsx$/,
 	c,
-	o,
-	l,
-	r,
 	s,
-	i,
 	u,
+	o,
 	e,
+	l,
+	a,
+	r,
 	t
 ], ht = (e) => {
 	let t = g(e);
-	return !/\.tsx?$/.test(t) || a.has(t) || n(t) || t === "index.ts" || t === "index.tsx" || t === "app.config.ts" ? !1 : !mt.some((e) => e.test(t));
+	return !/\.tsx?$/.test(t) || i.has(t) || n(t) || t === "index.ts" || t === "index.tsx" || t === "app.config.ts" ? !1 : !mt.some((e) => e.test(t));
 }, gt = (e) => {
 	let t = [], n = [], r = [], i = [];
 	for (let [a, o] of e.getExportedDeclarations()) {
@@ -6130,6 +6130,61 @@ var S = (e, t, n) => {
 			"Partial registries (`Partial<Record<WidgetKind, …>>` or per-kind lookups)",
 			"need nothing."
 		].join("\n")
+	}),
+	w({
+		version: "0.55.0",
+		id: "0.55.0/01_target-relations-declare-columns",
+		title: "A target's `relations:` names the junction's two columns now, not just the table",
+		kind: "manual",
+		appliesTo: ({ project: e }) => e.getSourceFiles().some((e) => {
+			let t = e.getFullText();
+			return /relations:\s*\{[^}{]*:\s*['"`]/.test(t);
+		}),
+		note: [
+			"A write target declares its many-to-many relations as objects now:",
+			"",
+			"    // before",
+			"    target: { table: 'employees', op: 'update',",
+			"      relations: { assignedStores: 'employee_assigned_stores' } }",
+			"",
+			"    // after",
+			"    target: { table: 'employees', op: 'update',",
+			"      relations: { assignedStores: {",
+			"        junction: 'employee_assigned_stores',",
+			"        anchorColumn: 'employeeId',   // the junction reference() pointing at `employees`",
+			"        targetColumn: 'storeId',      // the junction's other reference()",
+			"      } } }",
+			"",
+			"Take both column names from the junction table's own `reference()`",
+			"columns in your `db/` schema — `anchorColumn` is the one pointing at the",
+			"target's table, `targetColumn` is the other one.",
+			"",
+			"Why: the SAME declaration now drives the optimistic update in the browser,",
+			"so a multi-reference field flips as instantly as a scalar one instead of",
+			"waiting for the server delta. The browser cannot import your schema, so the",
+			"columns have to be stated. They are not taken on trust: before it writes,",
+			"the server compares them against the junction's real reference columns and",
+			"refuses — naming the correct pair — if they disagree."
+		].join("\n")
+	}),
+	w({
+		version: "0.55.0",
+		id: "0.55.0/02_widget-kind-gained-rich-text",
+		title: "WidgetKind gained 'rich-text' — total widget registries need one new entry",
+		kind: "manual",
+		appliesTo: ({ project: e }) => e.getSourceFiles().some((e) => /Record<WidgetKind/.test(e.getFullText())),
+		note: [
+			"This repository types a widget registry as `Record<WidgetKind, …>`.",
+			"`WidgetKind` gained `'rich-text'`, so the total map needs one new entry.",
+			"The framework ships a default you can point at:",
+			"",
+			"    import { RichTextWidget } from '@voltro/web'",
+			"    // …",
+			"    'rich-text': RichTextWidget,",
+			"",
+			"Partial registries (`Partial<Record<WidgetKind, …>>` or per-kind lookups)",
+			"need nothing."
+		].join("\n")
 	})
 ], J = /* @__PURE__ */ new Set([
 	"node_modules",