@voltro/cli 0.55.0 → 0.57.0

package/dist/buildReport-52gHKgfO.js

@@ -0,0 +1,64 @@
+import { join as e } from "node:path";
+import { existsSync as t, readFileSync as n, readdirSync as r, statSync as i } from "node:fs";
+import { gzipSync as a } from "node:zlib";
+//#region src/buildReport.ts
+var o = 9, s = (e) => a(e, { level: o }).length, c = (n) => {
+	let a = 0, o = 0, s = (t) => {
+		for (let n of r(t, { withFileTypes: !0 })) {
+			let r = e(t, n.name);
+			n.isDirectory() ? s(r) : (a += i(r).size, o += 1);
+		}
+	};
+	return t(n) && s(n), {
+		bytes: a,
+		files: o
+	};
+}, l = (a) => {
+	let o = e(a, ".framework", "dist"), l = e(o, "index.html");
+	if (!t(l)) return null;
+	let u = n(l, "utf8"), d = (r) => {
+		let i = e(o, r.replace(/^\//, ""));
+		if (!t(i)) return null;
+		let a = n(i);
+		return {
+			file: r,
+			gzip: s(a),
+			raw: a.length
+		};
+	}, f = [...u.matchAll(/(?:src|href)="(\/assets\/[^"]+\.js)"/g)].map((e) => e[1]), p = [...u.matchAll(/href="(\/assets\/[^"]+\.css)"/g)].map((e) => e[1]), m = f.map(d).filter((e) => e !== null), h = p.map(d).filter((e) => e !== null), g = e(o, "assets"), _ = 0, v = 0;
+	if (t(g)) for (let t of r(g)) t.endsWith(".js") && (_ += s(n(e(g, t))), v += 1);
+	let y = e(o, "server", "ssrEntry.js"), b = c(e(a, ".framework", "dist-web", "startBundle")), x = c(e(a, ".framework", "dist-api", "serveBundle"));
+	return {
+		firstLoad: m,
+		firstLoadGzip: m.reduce((e, t) => e + t.gzip, 0),
+		css: h,
+		cssGzip: h.reduce((e, t) => e + t.gzip, 0),
+		totalGzip: _,
+		chunkCount: v,
+		ssrEntryBytes: t(y) ? i(y).size : 0,
+		startBundleBytes: b.bytes,
+		startBundleFiles: b.files,
+		serveBundleBytes: x.bytes,
+		serveBundleFiles: x.files
+	};
+}, u = (e) => `${(e / 1024).toFixed(1)} KB`, d = (e) => `${(e / 1e6).toFixed(2)} MB`, f = (e) => {
+	if (e === null) return [];
+	let t = [
+		"",
+		"build report — what a visitor downloads",
+		""
+	];
+	t.push(`  first load   ${u(e.firstLoadGzip).padStart(10)} gz   ${e.firstLoad.length} file(s), entry + modulepreload`), e.css.length > 0 && t.push(`  css          ${u(e.cssGzip).padStart(10)} gz   ${e.css.length} stylesheet(s)`), t.push(`  all chunks   ${u(e.totalGzip).padStart(10)} gz   ${e.chunkCount} chunk(s), eager + lazy`);
+	let n = [...e.firstLoad].sort((e, t) => t.gzip - e.gzip).slice(0, 5);
+	if (n.length > 0) {
+		t.push("");
+		for (let r of n) {
+			let n = e.firstLoadGzip === 0 ? 0 : Math.round(r.gzip / e.firstLoadGzip * 100);
+			t.push(`    ${u(r.gzip).padStart(10)} gz  ${String(n).padStart(3)}%  ${r.file}`);
+		}
+	}
+	let r = n[0];
+	return r !== void 0 && e.firstLoadGzip > 0 && r.gzip > e.firstLoadGzip / 2 && (t.push(""), t.push(`  ⚠ one chunk is ${Math.round(r.gzip / e.firstLoadGzip * 100)}% of the first load: ${r.file}`), t.push("    Every visitor downloads it before the page is interactive. If that is"), t.push("    data rather than code (a content glob, a locale catalog, a dataset),"), t.push("    it usually belongs behind a dynamic import or a build-time index.")), (e.ssrEntryBytes > 0 || e.startBundleFiles > 0 || e.serveBundleFiles > 0) && (t.push(""), t.push("  server artefacts (what the image ships and a cold boot loads)"), e.ssrEntryBytes > 0 && t.push(`    ssr bundle       ${d(e.ssrEntryBytes).padStart(10)}`), e.startBundleFiles > 0 && t.push(`    start bundle     ${d(e.startBundleBytes).padStart(10)}   ${e.startBundleFiles} file(s)`), e.serveBundleFiles > 0 && t.push(`    serve bundle     ${d(e.serveBundleBytes).padStart(10)}   ${e.serveBundleFiles} file(s)`)), t.push(""), t;
+};
+//#endregion
+export { l as collectBuildReport, f as formatBuildReport };

package/dist/{checkCommand-DNkY5kwF.js → checkCommand-BISqx1OJ.js}

@@ -1,2 +1,2 @@
-import { a as e, i as t, o as n } from "./checkCommand-fbj9GDjN.js";
+import { a as e, i as t, o as n } from "./checkCommand-DUtMWjcR.js";
 export { t as offlineManifest, e as runCheckCommand, n as toInput };

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

@@ -1,10 +1,10 @@
 import { t as e } from "./cliArgs-D4p8n7EE.js";
-import { a as t, l as n } from "./codegen-SIepQtUl.js";
+import { a as t, l as n } from "./codegen-Bth5lUTU.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 { n as a, o, r as s, t as c } from "./inspectFetch-BU1NyzxV.js";
 import { r as l } from "./fileTaxonomy-CbyMQYx_.js";
-import { S as u } from "./doctorCommand-CGZJK_4o.js";
+import { S as u } from "./doctorCommand-BrWu67JZ.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-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(() => []);
+	let { walk: t, loadDiscovered: n, loadApiConfig: r } = await import("./dev-Bl9HqtV7.js"), { buildRpcEntry: i } = await import("./manifestBuild-UXrnUcXP.js"), { buildCapabilityManifest: a } = await import("./inspect-B0hL41s0.js"), { relative: o } = await import("node:path"), s = await n(await t(e), { root: e }), c = await r(e).then((e) => e?.plugins ?? []).catch(() => []);
 	try {
-		let { mergePluginRoutesInto: e } = await import("./dev-DfVZaoys.js");
+		let { mergePluginRoutesInto: e } = await import("./dev-Bl9HqtV7.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-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) => ({
+	], { assembleFrameworkTables: d } = await import("./frameworkTableAssembly-B96WCNJA.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/{clusterCmd-DrVFCzSj.js → clusterCmd-CdLB1GkT.js}

@@ -1,5 +1,5 @@
 import { n as e } from "./cliOutput-D1tSBoRM.js";
-import { n as t, o as n, r, t as i } from "./inspectFetch-EMuhTG_9.js";
+import { n as t, o as n, r, t as i } from "./inspectFetch-BU1NyzxV.js";
 import { ansi as a } from "@voltro/logger";
 //#region src/clusterCmd.ts
 var o = () => {

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

@@ -10,7 +10,8 @@ import { isAgentDescriptor as m } from "@voltro/ai/agent";
 var h = /* @__PURE__ */ new Set(/* @__PURE__ */ "crypto.fs.path.os.net.http.https.http2.tls.dns.dgram.stream.zlib.child_process.worker_threads.cluster.readline.vm.module.perf_hooks.async_hooks.inspector.v8.process.tty.repl.constants.sys.string_decoder".split(".")), g = (e) => e.startsWith("node:") || h.has(e) || e === "@voltro/workflow" ? !0 : e === "@voltro/database/wire" ? !1 : e === "@voltro/database" || e.startsWith("@voltro/database/") || e === "@voltro/runtime" || e.startsWith("@voltro/runtime/") ? !0 : e === "@voltro/ai/agent" || e === "@voltro/ai/events" ? !1 : !!(e === "@voltro/ai" || e.startsWith("@voltro/ai/") || [
 	"@voltro/protocol/session",
 	"@voltro/protocol/jwt",
-	"@voltro/protocol/apikey"
+	"@voltro/protocol/apikey",
+	"@voltro/protocol/identity"
 ].includes(e) || e === "@voltro/env/server" || e.startsWith("@effect/cluster") || e.startsWith("@effect/sql") || e === "@effect/platform-node" || [
 	"pg",
 	"postgres",

package/dist/codegen-DbH7NbCR.js

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

package/dist/{codegenCommand-3TDJezom.js → codegenCommand-DnVuDxwT.js}

@@ -1,17 +1,17 @@
-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 { Fn as e, In as t, l as n, q as r, u as i } from "./dev-DOEJXicj.js";
+import { n as a } from "./frameworkTableAssembly-vfkzuzEo.js";
+import { i as o, r as s } from "./codegen-Bth5lUTU.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);
+var p = async (e) => {
+	let { config: i, present: a, error: o } = await n(e);
 	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,
+	let c = i?.plugins ?? [], { pluginContributions: l, pluginErrorImports: d, pluginRpcImports: f, pluginAliases: p } = await r(c, i?.name ?? u(e), e), h = await s({
+		root: e,
 		...l.length > 0 ? { pluginContributions: l } : {},
 		...d.length > 0 ? { pluginErrorImports: d } : {},
 		...f.length > 0 ? { pluginRpcImports: f } : {},
@@ -19,7 +19,7 @@ var p = async (t) => {
 		...i?.name === void 0 ? {} : { apiName: i.name }
 	});
 	if (!h) return { kind: "nothing-to-write" };
-	let g = await m(t, i), _ = await e(h, g);
+	let g = await m(e, i), _ = await t(h, g);
 	return {
 		kind: "wrote",
 		file: h,
@@ -29,9 +29,9 @@ var p = async (t) => {
 		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 ?? []);
+}, m = async (t, n) => {
+	let r = await o(t), { tables: s } = await i(r, { root: t }), c = await a({ root: t });
+	return e(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);

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

@@ -6185,6 +6185,228 @@ var S = (e, t, n) => {
 			"Partial registries (`Partial<Record<WidgetKind, …>>` or per-kind lookups)",
 			"need nothing."
 		].join("\n")
+	}),
+	w({
+		version: "0.56.0",
+		id: "0.56.0/01_inspect_answers_are_observations",
+		title: "inspect answers are `Observation`s — the payload is `.data`",
+		kind: "manual",
+		reach: "beyond-source",
+		appliesTo: ({ text: e }) => e.find("/_voltro/inspect").length > 0,
+		note: [
+			"Every 2xx `/_voltro/inspect/*` response is now an envelope:",
+			"",
+			"    { data, scope, origin, completeness, capturedAt }",
+			"",
+			"What you read before is `.data`. So:",
+			"",
+			"    curl …/_voltro/inspect/subscriptions | jq .resume",
+			"    curl …/_voltro/inspect/subscriptions | jq .data.resume     # now",
+			"",
+			"The other four fields are the point of the change, not decoration:",
+			"",
+			"  • `scope.kind` — `process` (this replica only), `shared-store` (every",
+			"    replica would answer the same), `fleet` (assembled), `declaration`",
+			"    (from the source tree). A `process` answer on a multi-replica",
+			"    deployment is a SAMPLE, and it used to look identical to a fleet-wide",
+			"    one.",
+			"  • `origin.replicaId` / `origin.instanceId` — which process answered, and",
+			"    which generation of it. Query twice and you can now tell whether you",
+			"    reached the same one.",
+			"  • `completeness.fleetSize` — how many replicas exist. ABSENT when it",
+			"    could not be determined; never `1` as a guess.",
+			"  • `capturedAt` — the ORIGIN’s clock. Do not compare it with another",
+			"    replica’s.",
+			"",
+			"Check anything that reads these endpoints outside your TypeScript sources:",
+			"dashboards, `jq` filters in alerts, runbook commands, CI health checks,",
+			"scrape configs. A reader that pulls a field straight off the top level now",
+			"reads `undefined` — which in a health check is the failure mode worth",
+			"looking for first, because `undefined` and \"zero\" render the same in most",
+			"alerting rules."
+		].join("\n")
+	}),
+	w({
+		version: "0.56.0",
+		id: "0.56.0/02_broadcast_gap_is_one_object",
+		title: "attachBroadcastBus's onGap now receives a single BroadcastGap object",
+		kind: "manual",
+		appliesTo: ({ project: e }) => e.getSourceFiles().some((e) => e.getFullText().includes("attachBroadcastBus")),
+		note: [
+			"`attachBroadcastBus({ onGap })` now receives ONE argument — a `BroadcastGap`",
+			"— instead of `(origin, missed)`.",
+			"",
+			"  before:  onGap: (origin, missed) => refreshAll(`missed ${missed} from ${origin}`)",
+			"  after:   onGap: (gap) => refreshAll(gap.reason)",
+			"",
+			"`gap.reason` is a ready-made sentence for your log line. `gap.origin` and",
+			"`gap.missed` are still there and still EXACT — but they are optional now,",
+			"because the bus reports two kinds of hole and only one of them has a peer",
+			"to blame:",
+			"",
+			"  • a peer's serial jumped → `{ reason, origin, missed }`",
+			"  • this replica was not subscribed for a while, or the transport re-dialled",
+			"    → `{ reason }` alone",
+			"",
+			"The recovery is the same for both: re-run every live query. If your handler",
+			"reads `origin`/`missed`, guard them — a hole with no peer is now reachable.",
+			"",
+			"Related, and needing no change from you: `attachBroadcastBus` no longer",
+			"rejects when the broker is unreachable at attach time. It warns, keeps the",
+			"local path working, retries in the background, and reports the time it spent",
+			"unsubscribed as a gap. If you wrapped the call in a try/catch to survive a",
+			"restarting broker, that catch is now dead code."
+		].join("\n")
+	}),
+	w({
+		version: "0.56.0",
+		id: "0.56.0/03_outbox_drain_needs_an_identity",
+		title: "drainOutbox now requires claimedBy — the fleet-wide exactly-once gate",
+		kind: "manual",
+		appliesTo: ({ project: e }) => e.getSourceFiles().some((e) => e.getFullText().includes("drainOutbox")),
+		note: [
+			"`drainOutbox({ … })` now requires a `claimedBy: string`.",
+			"",
+			"Why: the drain used to read every `pending` row and run its handler. Every",
+			"replica runs the drain, so every effect was dispatched once PER REPLICA — on",
+			"the happy path, every time. Rows are now claimed atomically",
+			"(`pending → delivering`) and a racing replica loses the row instead of",
+			"duplicating the side effect.",
+			"",
+			"What to pass: an id for this PROCESS, not for the replica. A replica name",
+			"survives a restart (`POD_NAME` on a StatefulSet, `VOLTRO_REPLICA_ID` by",
+			"definition) while the work does not, so a pod that died mid-delivery would",
+			"look like it still held its own claim:",
+			"",
+			"    import { instanceId } from '@voltro/protocol/identity'",
+			"    await drainOutbox({ store, handlers, claimedBy: instanceId() })",
+			"",
+			"Also new and optional: `claimLeaseMs` (default 5 minutes) — how long a claim",
+			"stands before another replica may take the row. Set it ABOVE your slowest",
+			"handler. A lease shorter than a real delivery hands the same row to a second",
+			"replica while the first is still working, which is the duplicate this",
+			"mechanism removes, reintroduced by a number.",
+			"",
+			"If you do NOT call `drainOutbox` yourself, there is nothing to do: `voltro",
+			"dev` and `voltro serve` pass the identity for you."
+		].join("\n")
+	}),
+	w({
+		version: "0.56.0",
+		id: "0.56.0/04_reaction_dedupe_is_one_claim",
+		title: "runReaction's dedupe is a single atomic claim",
+		kind: "manual",
+		appliesTo: ({ project: e }) => e.getSourceFiles().some((e) => {
+			let t = e.getFullText();
+			return t.includes("runReaction") || t.includes("ReactionRunDeps");
+		}),
+		note: [
+			"`ReactionRunDeps.dedupe` changed from `{ has, add }` to `{ claim }`:",
+			"",
+			"    // before",
+			"    dedupe: { has: (k) => seen.has(k), add: (k) => { seen.add(k) } }",
+			"    // after",
+			"    dedupe: { claim: (k) => (seen.has(k) ? false : (seen.add(k), true)) }",
+			"",
+			"Why it is not a rename. `has` then `add` is a read followed by a write, and",
+			"two callers both read \"not seen\" before either writes — so `dedupeKey`, the",
+			"field `defineReaction` refuses to boot without, let the same change act once",
+			"per replica. Every single-instance run confirmed it worked, which is why it",
+			"survived: the gate was real in exactly the configuration that cannot observe",
+			"it.",
+			"",
+			"The claim is also taken BEFORE the act now, not after. That is what makes it",
+			"a gate rather than a report, and it has a cost worth knowing: an act that",
+			"THROWS has already consumed its key and is not re-run by a later duplicate.",
+			"Durability belongs to the workflow the act starts, not to the trigger.",
+			"",
+			"If you do NOT call `runReaction` yourself, there is nothing to do. `voltro",
+			"dev` and `voltro serve` now pass a durable, fleet-wide claimer",
+			"(`_voltro_change_claims`), so a reaction acts once across the whole fleet",
+			"instead of once per replica — no code change on your side."
+		].join("\n")
+	}),
+	w({
+		version: "0.56.0",
+		id: "0.56.0/05_plugin_bind_context_claims_a_change",
+		title: "PluginBindContext requires claimChange; change identity moved to @voltro/database",
+		kind: "manual",
+		appliesTo: ({ project: e }) => e.getSourceFiles().some((e) => {
+			let t = e.getFullText();
+			return t.includes("PluginBindContext") || t.includes("changeDigest") || t.includes("OccurrenceCounter") || t.includes("composeChangeKey") || t.includes("parseChangeKey");
+		}),
+		note: [
+			"Two changes, both narrow.",
+			"",
+			"1. `PluginBindContext` now has a REQUIRED `claimChange(scope, key) =>",
+			"   Promise<boolean>`. The framework supplies it on both boot paths, so a",
+			"   plugin only READS it — nothing to do unless you construct a",
+			"   `PluginBindContext` yourself, which in practice means a unit-test",
+			"   harness:",
+			"",
+			"       const ctx: PluginBindContext = {",
+			"         scheduleCoordinated: …,",
+			"         claimChange: () => Promise.resolve(true),   // add this",
+			"       }",
+			"",
+			"   In a real harness, decide what the case is testing before reaching for",
+			"   `true`: a stub that always claims asserts the SINGLE-replica behaviour.",
+			"   To exercise a fleet, share one claim ledger across the stubs — a `Set`",
+			"   of `${scope}/${key}` is enough.",
+			"",
+			"   Why it is required rather than optional: an absent gate reads exactly",
+			"   like a gate that passed, and every consumer of this field is counting or",
+			"   sending something. `plugin-billing` accrued a usage unit per metered row",
+			"   change on EVERY replica, so a tenant on two pods was invoiced twice.",
+			"",
+			"2. The change-identity helpers moved from `@voltro/plugin-cdc-out` to",
+			"   `@voltro/database`, beside `ChangeEvent` itself:",
+			"",
+			"       -import { changeDigest, composeChangeKey, OccurrenceCounter } from '@voltro/plugin-cdc-out'",
+			"       +import { changeDigest, composeChangeKey, OccurrenceCounter } from '@voltro/database'",
+			"",
+			"   `parseChangeKey` moved with them. `canonicalJson` did NOT become public:",
+			"   it is internal to the digest, and `@voltro/runtime` already exports a",
+			"   different function of that name."
+		].join("\n")
+	}),
+	w({
+		version: "0.56.0",
+		id: "0.56.0/06_serve_is_api_only",
+		title: "`voltro serve` on a WEB app now refuses — use `voltro start`",
+		kind: "manual",
+		reach: "beyond-source",
+		appliesTo: (e) => e.text.scanned === 0 || e.text.find("voltro serve").length > 0,
+		note: [
+			"`voltro serve` is the production server for an API app. On a WEB app it now",
+			"refuses with a one-line message instead of what it used to do.",
+			"",
+			"       web app, production      voltro start .      (unchanged)",
+			"       web app, development     voltro dev .        (unchanged)",
+			"       api app                  voltro serve .      (unchanged)",
+			"",
+			"Nothing changes for an api. For a web app the old behaviour was not a working",
+			"alternative that is being taken away:",
+			"",
+			"  • In production it already failed — the serve fast path requires an api",
+			"    serve bundle, which a web build never produces, so it exited 1 pointing",
+			"    at an artefact that cannot exist.",
+			"  • Below production it ran a SECOND vite build without Tailwind, without the",
+			"    image pipeline and without the islands entries, then served it through",
+			"    `vite preview`. With Tailwind that build aborts. Without it, it succeeds",
+			"    and DELETES `dist/server`, the island shells and every pre-rendered page —",
+			"    after which `voltro start` cannot boot at all.",
+			"",
+			"Search your Dockerfiles, compose files, CI jobs, Procfiles and runbooks:",
+			"",
+			"       grep -rn \"voltro serve\" .",
+			"",
+			"and change the ones that point at a WEB app to `voltro start`. An api entry",
+			"stays as it is. (The shipped Dockerfiles already run the precompiled bundle",
+			"directly — `node .framework/dist-web/startBundle/startEntry.js` for web,",
+			"`node .framework/dist-api/serveBundle/serveEntry.js` for an api — which is",
+			"faster still and needs no CLI in the runtime image.)"
+		].join("\n")
 	})
 ], J = /* @__PURE__ */ new Set([
 	"node_modules",