@voltro/cli 0.54.0 → 0.55.0

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

@@ -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-CG_Vx4lc.js → codegenCommand-3TDJezom.js}

@@ -1,6 +1,6 @@
-import { Dn as e, En as t, V as n, l as r, u as i } from "./dev-CmuvUKRq.js";
-import { n as a } from "./frameworkTableAssembly-D7LJuALW.js";
-import { i as o, r as s } from "./codegen-DSLM8Su9.js";
+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
@@ -10,23 +10,24 @@ var p = async (t) => {
 		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 } = await n(c, i?.name ?? u(t), t), p = await s({
+	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 (!p) return { kind: "nothing-to-write" };
-	let h = await m(t, i), g = await e(p, h);
+	if (!h) return { kind: "nothing-to-write" };
+	let g = await m(t, i), _ = await e(h, g);
 	return {
 		kind: "wrote",
-		file: p,
+		file: h,
 		plugins: c.length,
 		errorSchemas: d.length,
 		routes: f.length,
-		tables: h.size,
-		dts: g
+		tables: g.size,
+		dts: _
 	};
 }, m = async (e, n) => {
 	let r = await o(e), { tables: s } = await i(r), c = await a({ root: e });

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

@@ -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",

package/dist/{commands-6Kzi92Np.js → commands-BBYJ7Q3B.js}

@@ -91,7 +91,7 @@ var u = () => {
 		name: "dev",
 		summary: "Start the local development server (auto-discovers routes / mutations).",
 		status: "wired",
-		run: (e) => import("./dev-cKUiZZsB.js").then((t) => t.runDev(e)),
+		run: (e) => import("./dev-DfVZaoys.js").then((t) => t.runDev(e)),
 		help: {
 			usage: "[app]",
 			examples: [["voltro dev", "boot the app in the current directory"], ["voltro dev apps/acme/api", "boot a specific app"]],
@@ -109,7 +109,7 @@ var u = () => {
 		name: "dashboard",
 		summary: "Serve the DevTools dashboard standalone (from @voltro/dashboard). Targets via VOLTRO_DASHBOARD_APPS; --port to override.",
 		status: "wired",
-		run: (e) => import("./dashboardCommand-Cq1PWvI1.js").then((t) => t.runDashboardCommand(e)),
+		run: (e) => import("./dashboardCommand-D2kmyCLL.js").then((t) => t.runDashboardCommand(e)),
 		help: {
 			usage: "[--port <n>]",
 			flags: [["--port <n>", "port to serve the dashboard on"]],
@@ -121,7 +121,7 @@ var u = () => {
 		name: "check",
 		summary: "Verify the app graph (blast-radius checks) against a running api; LLM-shaped --json diagnostics. Flags: --json, --process <p>, --diff removeTable:<name>.",
 		status: "wired",
-		run: (e) => import("./checkCommand-L7DTlpIF.js").then((t) => t.runCheckCommand(e)),
+		run: (e) => import("./checkCommand-DNkY5kwF.js").then((t) => t.runCheckCommand(e)),
 		help: {
 			usage: "[--json] [--offline] [--process <name>] [--diff removeTable:<name>]",
 			flags: [
@@ -155,7 +155,7 @@ var u = () => {
 		name: "webhooks",
 		summary: "Outbound-webhook artefacts. `consumer` generates the ZERO-DEPENDENCY Standard-Webhooks verification package a subscriber installs, from this app's own declared events; `events` lists the events a subscriber can register for. Usage: voltro webhooks <consumer|events> [path] [--out <dir>] [--name <pkg>] [--json].",
 		status: "wired",
-		run: (e) => import("./webhooksCommand-BvzXNHji.js").then((t) => t.runWebhooksCommand(e)),
+		run: (e) => import("./webhooksCommand-B1LVcyO3.js").then((t) => t.runWebhooksCommand(e)),
 		help: {
 			usage: "<consumer|events> [path] [--out <dir>] [--name <pkg>] [--json]",
 			flags: [
@@ -171,7 +171,7 @@ var u = () => {
 		name: "evolve",
 		summary: "Schema-evolution copilot: propose an observed-graph-driven codemod + a branch-verified backfill for a schema change (rename/retype/split/drop a column, rename a table). Dry-run by default; --write applies. Usage: voltro evolve rename-column <table>.<col> --to <newName> [--write] [--json].",
 		status: "wired",
-		run: (e) => import("./evolveCommand-BwvQ8dVH.js").then((t) => t.runEvolveCommand(e)),
+		run: (e) => import("./evolveCommand-BsbZ-XDg.js").then((t) => t.runEvolveCommand(e)),
 		help: {
 			usage: "<rename-column|rename-table|retype-column|split-column|drop-column> <target> [--to <new>] [--write]",
 			flags: [
@@ -188,7 +188,7 @@ var u = () => {
 		name: "codegen",
 		summary: "Emit rpcGroup.generated.ts from discovered route / mutation descriptors.",
 		status: "wired",
-		run: (e) => import("./codegenCommand-CG_Vx4lc.js").then((t) => t.runCodegenCommand(e)),
+		run: (e) => import("./codegenCommand-3TDJezom.js").then((t) => t.runCodegenCommand(e)),
 		help: {
 			usage: "[app]",
 			examples: [["voltro codegen", "regenerate rpcGroup.generated.ts for the app in the cwd"]],
@@ -221,7 +221,7 @@ var u = () => {
 		name: "migrate",
 		summary: "Apply the declared schema to the database (alias of `db apply` — diffs declared vs live and emits the ALTERs). `--create-only` for the bootstrap-only CREATE TABLE IF NOT EXISTS path.",
 		status: "wired",
-		run: (e) => import("./migrate-BK_Bbx-_.js").then((t) => t.runMigrateCommand(e)),
+		run: (e) => import("./migrate-CGFZS-1a.js").then((t) => t.runMigrateCommand(e)),
 		help: {
 			usage: "[app] [--create-only]",
 			flags: [["--create-only", "only CREATE TABLE IF NOT EXISTS — never ALTER (bootstrap)"]],
@@ -233,7 +233,7 @@ var u = () => {
 		name: "test",
 		summary: "Run vitest against the app at the cwd (auto-discovers *.test.ts/tsx).",
 		status: "wired",
-		run: (e) => import("./test-D_kW4KMj.js").then((t) => t.runTestCommand(e)),
+		run: (e) => import("./test-DO27-x2P.js").then((t) => t.runTestCommand(e)),
 		help: {
 			usage: "[dir] [filter…] [--watch] [-t <pattern>]",
 			flags: [
@@ -281,7 +281,7 @@ var u = () => {
 		name: "info",
 		summary: "Report versions (CLI, node, every installed @voltro/* — flags lockstep skew), package manager, and dialect. --json for CI. Exits 1 on version skew.",
 		status: "wired",
-		run: (e) => import("./infoCommand-DlYlUPqs.js").then((t) => t.runInfoCommand(e)),
+		run: (e) => import("./infoCommand-EmM3jPKD.js").then((t) => t.runInfoCommand(e)),
 		help: {
 			usage: "[--json]",
 			flags: [["--json", "machine-readable report"]],
@@ -302,7 +302,7 @@ var u = () => {
 		name: "env",
 		summary: "Inspect/sync the typed-env manifest. Subcommands: check (default), sync (.env.example), types (env.generated.d.ts for CI tsc), turbo.",
 		status: "wired",
-		run: (e) => import("./envCommand-Cyynmcfa.js").then((t) => t.runEnvCommand(e)),
+		run: (e) => import("./envCommand-Bxy2fOjc.js").then((t) => t.runEnvCommand(e)),
 		help: {
 			usage: "[check|sync|types|turbo] [--force]",
 			flags: [["--force", "overwrite the generated file instead of refusing on a conflict"]],
@@ -331,12 +331,12 @@ var u = () => {
 		run: async (e) => {
 			let t = e.find((e) => !e.startsWith("-")) ?? process.cwd();
 			if (e.includes("--preflight")) {
-				let { runServePreflight: e } = await import("./doctorCommand-J3qu4E0Y.js");
+				let { runServePreflight: e } = await import("./doctorCommand-djmqEcDC.js");
 				return e(s(t), !0);
 			}
-			let { tryRunWebServe: n } = await import("./webDev-DlvZO30c.js"), r = await n(s(t));
+			let { tryRunWebServe: n } = await import("./webDev-1XpVnYkW.js"), r = await n(s(t));
 			if (!r.ran) {
-				let { runServeDispatch: t } = await import("./serveCommand-BiPe8BJm.js");
+				let { runServeDispatch: t } = await import("./serveCommand-Cjt5S9hD.js");
 				return t(e);
 			}
 			return r.exitCode;
@@ -364,13 +364,13 @@ var u = () => {
 		handlesHelp: !0,
 		summary: "Preflight an app for production: the precompiled serve bundle, hand-rolled primitives (naming the shipped one), @voltro/* version skew, executors with no access check, `.serverOnly()` leaks, and junction-FK gaps.",
 		status: "wired",
-		run: (e) => import("./doctorCommand-J3qu4E0Y.js").then((t) => t.runDoctorCommand(e))
+		run: (e) => import("./doctorCommand-djmqEcDC.js").then((t) => t.runDoctorCommand(e))
 	},
 	{
 		name: "build",
 		summary: "Production build for a web app (vite build + per-page SSG pre-render).",
 		status: "wired",
-		run: (e) => import("./build-D4ygSbnV.js").then((t) => t.runBuildCommand(e)),
+		run: (e) => import("./build-S0QOzqPT.js").then((t) => t.runBuildCommand(e)),
 		help: {
 			usage: "[app] [--target <t>]",
 			flags: [["--target <t>", "build target"]],
@@ -386,7 +386,7 @@ var u = () => {
 		name: "prune-runtime",
 		summary: "Trim a deployed web tree’s node_modules to the reachable runtime set (standalone image slimming).",
 		status: "wired",
-		run: (e) => import("./runtimeTrace-CGWx1Q6l.js").then((t) => t.runPruneRuntimeCommand(e)),
+		run: (e) => import("./runtimeTrace-C1BTpHGQ.js").then((t) => t.runPruneRuntimeCommand(e)),
 		hidden: !0
 	},
 	{
@@ -404,7 +404,7 @@ var u = () => {
 		name: "dormancy",
 		summary: "Single-node scale-to-zero: front the API with a wake-orchestrator that stops the app when idle and brings it back on a request or a due wakeup (cron/workflow). Needs a SQL store. Flags: --port, --app-port, --idle-grace-ms, --tick-ms.",
 		status: "wired",
-		run: (e) => import("./dormancyCommand-w1TrmgYP.js").then((t) => t.runDormancyCommand(e)),
+		run: (e) => import("./dormancyCommand-DY2rYpTa.js").then((t) => t.runDormancyCommand(e)),
 		help: {
 			usage: "[app] [--port <n>] [--app-port <n>] [--idle-grace-ms <n>] [--tick-ms <n>]",
 			flags: [
@@ -421,7 +421,7 @@ var u = () => {
 		name: "start",
 		summary: "Production runtime: serves dist + SSR-on-demand for ssr/isr pages.",
 		status: "wired",
-		run: (e) => import("./start-B0bnJgxI.js").then((t) => t.runStartCommand(e)),
+		run: (e) => import("./start-DH7cat4-.js").then((t) => t.runStartCommand(e)),
 		help: {
 			usage: "[app]",
 			examples: [["voltro start", "serve a built web app (dist + SSR-on-demand)"]],
@@ -475,7 +475,7 @@ var u = () => {
 		name: "db",
 		summary: "Database subcommands. Declarative flow: plan, apply, branch, plans, drift [--accept], squash, restore-snapshot. File migrations: generate [name], migrate, rollback, status, files, rollback-file. Data + housekeeping: seed, gc-snapshots, adopt. Credentials at rest: scan-credentials (find plaintext), encrypt-column (migrate a populated column onto .encrypted()).",
 		status: "wired",
-		run: (e) => import("./dbCommand-CSFWs9ev.js").then((t) => t.runDbCommand(e)),
+		run: (e) => import("./dbCommand-BTyBGhIA.js").then((t) => t.runDbCommand(e)),
 		help: {
 			usage: e(n),
 			examples: [
@@ -491,7 +491,7 @@ var u = () => {
 		name: "data",
 		summary: "Export/import + backup/restore of app data. Logical (rows + optional assets): export <dir> [--tenant <id>|--tables a,b|--exclude a,b] [--assets] [--compression zstd|gzip|none] [--consistency live|snapshot]; import <dir> [--assets] [--no-verify]; transfers — the history in all four directions, including a run in flight; inspect <file|dir>; unpack <file> <dir>. Native (vendor dump, no resume): backup <dir> [--assets] / restore <dir> [--assets] (pg_dump/mariadb-dump/…) — a restore marks the database in-progress until it finishes. Recovery: clear-replace-marker, clear-staging. Resumable + typed-NDJSON on the logical path; content-addressed assets on both.",
 		status: "wired",
-		run: (e) => import("./dataCommand-DYzW8vkv.js").then((t) => t.runDataCommand(e)),
+		run: (e) => import("./dataCommand-BEPPQiTl.js").then((t) => t.runDataCommand(e)),
 		help: {
 			usage: e(i),
 			flags: [
@@ -555,20 +555,20 @@ var u = () => {
 		handlesHelp: !0,
 		summary: "Upgrade the app to the latest framework: bump every @voltro/* dependency (across ALL workspace members, install once at the workspace root), then run the codemods shipped with the target version. Flags: --to <version>, --from <version>, --codemods-only, --dry-run, --force, --exact, --help. After: run `voltro db apply`.",
 		status: "wired",
-		run: (e) => import("./updateCommand-CIoVDKnj.js").then((t) => t.runUpdateCommand(e))
+		run: (e) => import("./updateCommand-nnFjDbl4.js").then((t) => t.runUpdateCommand(e))
 	},
 	{
 		name: "_apply-codemods",
 		summary: "Internal: apply shipped codemods for a framework version jump (re-exec target of `voltro update`).",
 		status: "wired",
 		hidden: !0,
-		run: (e) => import("./updateCommand-CIoVDKnj.js").then((t) => t.runApplyCodemods(e))
+		run: (e) => import("./updateCommand-nnFjDbl4.js").then((t) => t.runApplyCodemods(e))
 	},
 	{
 		name: "embeddings",
 		summary: "Embeddings tooling. Subcommand: backfill <table> --text <field> --vector <field> [--model <m>] [--model-field <f>] [--batch <n>] [--dry-run] — (re)embed rows the vectorEmbedding() mixin missed.",
 		status: "wired",
-		run: (e) => import("./embeddingsCommand-CMgPyRTr.js").then((t) => t.runEmbeddingsCommand(e)),
+		run: (e) => import("./embeddingsCommand-BoCqZsgp.js").then((t) => t.runEmbeddingsCommand(e)),
 		help: {
 			usage: "backfill <table> --text <field> --vector <field> [--model <m>] [--batch <n>] [--dry-run]",
 			flags: [
@@ -614,7 +614,7 @@ var u = () => {
 		summary: "Ask a RUNNING app whether its declared access is enforced. `access` calls every guarded procedure with NO credentials and reports any that answer (--process, --url, --strict, --format).",
 		status: "wired",
 		handlesHelp: !0,
-		run: (e) => import("./probeCommand-_C0YU207.js").then((t) => t.runProbeCommand(e))
+		run: (e) => import("./probeCommand-Bs3iVBSL.js").then((t) => t.runProbeCommand(e))
 	},
 	{
 		name: "schedule",

package/dist/{dashboardCommand-Cq1PWvI1.js → dashboardCommand-D2kmyCLL.js}

@@ -1,6 +1,6 @@
-import { f as e } from "./dev-CmuvUKRq.js";
-import { Z as t, et as n } from "./webDev-DSI9SOhs.js";
-import { t as r } from "./start-Clz-1BHB.js";
+import { f as e } from "./dev-Ca_A_S9v.js";
+import { Z as t, et as n } from "./webDev-B7vNj4Bq.js";
+import { t as r } from "./start-EOV7s1NZ.js";
 import { join as i } from "node:path";
 import { existsSync as a } from "node:fs";
 import { createLogger as o } from "@voltro/logger";