@voltro/cli 0.52.0 → 0.54.0

package/dist/{dev--A3nsxA3.js → dev-cKUiZZsB.js}

@@ -1,3 +1,3 @@
-import { c as e, d as t, f as n, i as r, p as i, u as a } from "./dev-CRHoCEiy.js";
+import { c as e, d as t, f as n, i as r, p as i, u as a } from "./dev-CmuvUKRq.js";
 import "./dialectDriver-czCHYpeH.js";
 export { r as buildStore, e as loadApiConfig, a as loadDiscovered, t as mergePluginRoutesInto, n as runDev, i as walk };

package/dist/{doctorCommand-DtfJ3FA6.js → doctorCommand-DCiFVMtZ.js}

@@ -1,11 +1,11 @@
-import { Ht as e, Ut as t, Wt as n } from "./dev-CRHoCEiy.js";
-import { D as r, _t as i, b as a, c as o, gt as s, t as c, vt as l, yt as u } from "./webDev-BgWL9gKV.js";
-import { x as d } from "./frameworkTableAssembly-w-XnLa3q.js";
-import { n as f } from "./pageConvention-CzUiSbtU.js";
-import { r as p, u as m } from "./apiBuild-CSFI8QGq.js";
+import { Ht as e, Ut as t, Wt as n } from "./dev-CmuvUKRq.js";
+import { Ft as r, It as i, Lt as a, P as o, Pt as s, l as c, t as l, x as u } from "./webDev-DSI9SOhs.js";
+import { x as d } from "./frameworkTableAssembly-D7LJuALW.js";
+import { n as f } from "./pageConvention-CMpfDN6r.js";
+import { r as p, u as m } from "./apiBuild-DTWp0S_q.js";
 import { n as h, r as g, t as ee } from "./cliOutput-D1tSBoRM.js";
 import { n as _, t as te } from "./tsconfigPaths-BWXBWgcl.js";
-import { n as ne, r as re } from "./fileTaxonomy-DvDUV9wq.js";
+import { n as ne, r as re } from "./fileTaxonomy-CbyMQYx_.js";
 import { basename as ie, dirname as ae, join as v, relative as y, resolve as b, sep as x } from "node:path";
 import { existsSync as S, readFileSync as C, readdirSync as w, statSync as T, writeFileSync as oe } from "node:fs";
 import { pathToFileURL as se } from "node:url";
@@ -496,12 +496,12 @@ var le = /* @__PURE__ */ new Set([
 }, Ge = (e, t) => {
 	let n = ["middleware.ts", "middleware.tsx"].find((t) => S(v(e, t)));
 	if (n === void 0) return;
-	let i = new D({
+	let r = new D({
 		useInMemoryFileSystem: !0,
 		skipAddingFilesFromTsConfig: !0
-	}), a;
+	}), i;
 	try {
-		a = i.createSourceFile(n, C(v(e, n), "utf8"));
+		i = r.createSourceFile(n, C(v(e, n), "utf8"));
 	} catch {
 		return {
 			problems: [],
@@ -510,8 +510,8 @@ var le = /* @__PURE__ */ new Set([
 			file: n
 		};
 	}
-	let o = [], s = [], c = 0;
-	for (let e of a.getVariableDeclarations()) {
+	let a = [], s = [], c = 0;
+	for (let e of i.getVariableDeclarations()) {
 		let t = e.getInitializerIfKind(O.CallExpression);
 		if (t?.getExpression().getText() !== "defineMiddleware") continue;
 		c += 1;
@@ -525,7 +525,7 @@ var le = /* @__PURE__ */ new Set([
 			s.push(n);
 			continue;
 		}
-		o.push({
+		a.push({
 			exportName: n,
 			middleware: {
 				_tag: "VoltroMiddleware",
@@ -535,7 +535,7 @@ var le = /* @__PURE__ */ new Set([
 		});
 	}
 	return {
-		problems: r(o, t).map((e) => e.message),
+		problems: o(a, t).map((e) => e.message),
 		unreadable: s,
 		seen: c,
 		file: n
@@ -1296,21 +1296,21 @@ var le = /* @__PURE__ */ new Set([
 }, B = async (e) => {
 	let t = v(e, "src", "pages");
 	if (!S(t)) return [];
-	let { pages: n, dirs: r } = await a(t), i = [];
+	let { pages: n, dirs: r } = await u(t), i = [];
 	for (let a of n) {
-		if (!o(r, a.dirChain).some((e) => e.hasLayout)) continue;
+		if (!c(r, a.dirChain).some((e) => e.hasLayout)) continue;
 		let n;
 		try {
 			n = C(v(t, a.file), "utf8");
 		} catch {
 			continue;
 		}
-		if (c.test(n)) continue;
-		let s = Wt(n);
-		s !== null && i.push({
+		if (l.test(n)) continue;
+		let o = Wt(n);
+		o !== null && i.push({
 			file: y(e, v(t, a.file)),
 			pattern: a.pattern,
-			currentMode: s
+			currentMode: o
 		});
 	}
 	return i;
@@ -1427,7 +1427,7 @@ var le = /* @__PURE__ */ new Set([
 	let t = en.get(e);
 	if (t !== void 0) return t;
 	let n = (async () => {
-		let { walk: t, loadDiscovered: n } = await import("./dev--A3nsxA3.js"), r = await t(e);
+		let { walk: t, loadDiscovered: n } = await import("./dev-cKUiZZsB.js"), r = await t(e);
 		return {
 			files: r,
 			discovered: await n(r)
@@ -1552,7 +1552,7 @@ var le = /* @__PURE__ */ new Set([
 	}
 }, J = async (r) => {
 	try {
-		let { loadApiConfig: i } = await import("./dev--A3nsxA3.js"), { discovered: a } = await U(r), o = t(await i(r)), s = {
+		let { loadApiConfig: i } = await import("./dev-cKUiZZsB.js"), { discovered: a } = await U(r), o = t(await i(r)), s = {
 			queries: a.queries,
 			mutations: a.mutations,
 			actions: a.actions,
@@ -1636,7 +1636,7 @@ var le = /* @__PURE__ */ new Set([
 }, pn = async (e) => ut({
 	hasWorkflows: async () => (await U(e)).discovered.workflows.length > 0,
 	openStore: async () => {
-		let { loadApiConfig: t, buildStore: n } = await import("./dev--A3nsxA3.js"), r = await t(e);
+		let { loadApiConfig: t, buildStore: n } = await import("./dev-cKUiZZsB.js"), r = await t(e);
 		if (r === null) throw Error("no app.config.ts in this directory");
 		let i = await n(r, void 0);
 		return {
@@ -1716,7 +1716,7 @@ var le = /* @__PURE__ */ new Set([
 	}
 }, yn = async (e) => {
 	try {
-		let { loadApiConfig: t } = await import("./dev--A3nsxA3.js"), n = (await t(e))?.doctor?.scopeVocabulary;
+		let { loadApiConfig: t } = await import("./dev-cKUiZZsB.js"), n = (await t(e))?.doctor?.scopeVocabulary;
 		if (typeof n != "string") return [];
 		let [r, i] = n.split("#");
 		if (r === void 0 || i === void 0) return [];
@@ -1733,10 +1733,10 @@ var le = /* @__PURE__ */ new Set([
 		findings: []
 	});
 	try {
-		let { offlineManifest: n, toInput: r } = await import("./checkCommand-2SbqzukH.js"), { buildAppGraph: i, checkAppGraph: a } = await import("./appGraph-CFmFKHb2.js"), o = await n(e), s = r(o.manifest, o.tables), c = await yn(e), l = [.../* @__PURE__ */ new Set([...s.scopes ?? [], ...c])];
+		let { offlineManifest: n, toInput: r } = await import("./checkCommand-L7DTlpIF.js"), { buildAppGraph: i, checkAppGraph: a } = await import("./appGraph-CFmFKHb2.js"), o = await n(e), s = r(o.manifest, o.tables), c = await yn(e), l = [.../* @__PURE__ */ new Set([...s.scopes ?? [], ...c])];
 		if (l.length === 0) {
 			try {
-				let { loadAppSchemaInputs: t } = await import("./frameworkTableAssembly-C6ETawPR.js");
+				let { loadAppSchemaInputs: t } = await import("./frameworkTableAssembly-IPD1pUnZ.js");
 				await t(e);
 			} catch {
 				return t("app-not-importable");
@@ -1787,7 +1787,7 @@ var le = /* @__PURE__ */ new Set([
 	if (n === void 0 || r.length === 0) return;
 	let i = [];
 	try {
-		let { loadApiConfig: t } = await import("./dev--A3nsxA3.js");
+		let { loadApiConfig: t } = await import("./dev-cKUiZZsB.js");
 		i = (await t(e))?.locales ?? [];
 	} catch {
 		return;
@@ -1801,11 +1801,42 @@ var le = /* @__PURE__ */ new Set([
 		for (let e of Ue(a, n)) console.log(e);
 	}
 }, Sn = async (e) => {
+	let t = v(e, "src");
+	if (!S(t)) return;
+	let n = !1, r = (e) => {
+		for (let t of w(e, { withFileTypes: !0 })) {
+			if (n) return;
+			if (t.isDirectory()) t.name.startsWith(".") || r(v(e, t.name));
+			else if (/\.(tsx?|jsx?|mdx?)$/.test(t.name)) try {
+				C(v(e, t.name), "utf8").includes("?image") && (n = !0);
+			} catch {}
+		}
+	};
+	if (r(t), !n) return;
+	let { loadSharp: i, sharpUnavailableReason: a } = await import("./imagePipeline-B_GVJgm6.js"), o = await i();
+	if (console.log(""), o !== null) {
+		console.log("image pipeline: sharp is available — ?image imports get srcSet variants + blur.");
+		return;
+	}
+	a()?.reason === "binary-missing" ? (console.log("image pipeline: sharp is INSTALLED but its platform binary is missing —"), console.log("  an install that omitted optional dependencies drops the @img/* prebuilds."), console.log("  Fix: reinstall without omitting optional deps, or `pnpm add -D sharp` in this app.")) : (console.log("image pipeline: sharp is NOT installed — ?image imports serve originals (no srcSet, no blur)."), console.log("  Fix: `pnpm add -D sharp` in this app (it is an optional dependency of @voltro/cli;"), console.log("  your installer skipped optional dependencies)."));
+}, Cn = async (e) => {
+	try {
+		let { loadConfig: t } = await import("./webDev-DlvZO30c.js"), n = (await t(e, { preferSource: !0 }))?.fonts;
+		if (n === void 0 || n.length === 0) return;
+		let { loadFontkit: r, loadSubsetFont: i } = await import("./fontPipeline-LxIHa1vo.js"), a = [];
+		if (await r() === null && a.push("fontkit (size-adjust fallback metrics — the CLS guard — are skipped)"), await i() === null && a.push("subset-font (declared `subsets:` ship the full files)"), console.log(""), a.length === 0) {
+			console.log("font pipeline: fontkit + subset-font available — declared fonts get metrics + subsetting.");
+			return;
+		}
+		for (let e of a) console.log(`font pipeline: ${e}`);
+		console.log("  Fix: reinstall without omitting optional deps, or `pnpm add -D fontkit subset-font` in this app.");
+	} catch {}
+}, wn = async (e) => {
 	let t = v(e, "src", "pages");
 	if (!S(t)) return !1;
 	let n = [];
 	try {
-		let { walkPagesTree: e } = await import("./webDev-CZbTsDcH.js");
+		let { walkPagesTree: e } = await import("./webDev-DlvZO30c.js");
 		n = (await e(t)).pages.map((e) => e.pattern);
 	} catch {
 		return !1;
@@ -1815,10 +1846,10 @@ var le = /* @__PURE__ */ new Set([
 	console.log("");
 	for (let e of Ke(r)) console.log(e);
 	return r.problems.length > 0;
-}, Cn = async (e) => {
+}, Tn = async (e) => {
 	let { discovered: t } = await U(e), n = [];
 	try {
-		let { loadApiConfig: t } = await import("./dev--A3nsxA3.js");
+		let { loadApiConfig: t } = await import("./dev-cKUiZZsB.js");
 		n = ((await t(e))?.plugins ?? []).map((e) => {
 			let t = (e.extendSchema?.tables ?? []).map((e) => {
 				let t = e;
@@ -1831,8 +1862,8 @@ var le = /* @__PURE__ */ new Set([
 				plugin: e.name,
 				tables: t,
 				rpcTags: n,
-				canDisableTables: wn.has(r),
-				canAlias: Tn.has(r)
+				canDisableTables: En.has(r),
+				canAlias: Dn.has(r)
 			};
 		});
 	} catch {
@@ -1850,16 +1881,17 @@ var le = /* @__PURE__ */ new Set([
 	});
 	console.log();
 	for (let e of lt(n, i)) console.log(e);
-}, wn = /* @__PURE__ */ new Set([
+}, En = /* @__PURE__ */ new Set([
 	"@voltro/plugin-rbac",
 	"@voltro/plugin-audit",
 	"@voltro/plugin-notifications",
 	"aiFlows"
-]), Tn = /* @__PURE__ */ new Set([
+]), Dn = /* @__PURE__ */ new Set([
 	"aiFlows",
 	"@voltro/plugin-audit",
 	"@voltro/plugin-billing",
 	"@voltro/plugin-cdc-out",
+	"@voltro/plugin-comments",
 	"@voltro/plugin-flags",
 	"@voltro/plugin-governance",
 	"@voltro/plugin-mail",
@@ -1872,8 +1904,8 @@ var le = /* @__PURE__ */ new Set([
 	"@voltro/plugin-sso-saml",
 	"@voltro/plugin-storage",
 	"@voltro/plugin-row-history"
-]), $ = 20, En = async (e) => {
-	let t = await Dn(e), n = new Set(t.reviewed.map((e) => e.tag)), r = t.result.findings.filter((e) => e.verdict.kind === "allowlisted" && !n.has(e.tag)).length;
+]), $ = 20, On = async (e) => {
+	let t = await kn(e), n = new Set(t.reviewed.map((e) => e.tag)), r = t.result.findings.filter((e) => e.verdict.kind === "allowlisted" && !n.has(e.tag)).length;
 	return {
 		executors: t.executorCount,
 		guardVocabulary: [...t.vocabulary].sort(),
@@ -1885,7 +1917,7 @@ var le = /* @__PURE__ */ new Set([
 		},
 		unchecked: t.result.unchecked
 	};
-}, Dn = async (e) => {
+}, kn = async (e) => {
 	let { discovered: t } = await U(e), n = /* @__PURE__ */ new Map(), r = (e) => {
 		if (!n.has(e)) try {
 			n.set(e, C(e, "utf8"));
@@ -1947,8 +1979,8 @@ var le = /* @__PURE__ */ new Set([
 		executorCount: o.length,
 		allowPath: s
 	};
-}, On = async (e, t) => {
-	let { result: n, vocabulary: r, existing: i, reviewed: a, executorCount: o, allowPath: s, rowFilterRegistered: c } = await Dn(e), l = n.counts;
+}, An = async (e, t) => {
+	let { result: n, vocabulary: r, existing: i, reviewed: a, executorCount: o, allowPath: s, rowFilterRegistered: c } = await kn(e), l = n.counts;
 	console.log(`\nauthz scan · ${o} executor(s)`);
 	let u = [...r].filter((e) => !Je.has(e)).sort();
 	console.log(u.length === 0 ? "  guard vocabulary: framework names only — no exported require*/assert* found in this app" : `  guard vocabulary: ${u.length} from your source (${u.slice(0, 6).join(", ")}${u.length > 6 ? ", …" : ""})`), console.log(`  ✗ no access check                       ${String(l.unchecked).padStart(4)}`), console.log(`  ⚠ inline ownership check, no named guard${String(l.inlineOwnership).padStart(4)}   (informational)`), console.log(`  ✓ guards: on the descriptor             ${String(l.declaredGuard).padStart(4)}`), console.log(`  ✓ calls a guard from the vocabulary     ${String(l.vocabularyGuard).padStart(4)}`);
@@ -1961,9 +1993,9 @@ var le = /* @__PURE__ */ new Set([
 	console.log("");
 	for (let e of n.unchecked.slice(0, $)) console.log(`  ✗ ${e.tag}  — ${e.why}\n      ${e.path}`);
 	return n.unchecked.length > $ && console.log(`  … and ${n.unchecked.length - $} more — \`voltro doctor --json\` prints every one (\`authz.unchecked\`).`), i === void 0 ? (console.log(`\nNo ${X} yet, so this run is advisory. To start the ratchet:`), console.log("\n    voltro doctor --write-authz-allowlist\n"), console.log("That records today's unchecked handlers as DEBT and fails every run after on"), console.log("anything NEW. Fix a handler and its line stops mattering — the scan reports it as"), console.log("guarded whether or not the line is still there."), !1) : (console.log(`\n${n.unchecked.length} executor(s) with no access check are not in ${X}.`), console.log("Add a guard, or add the tag to that file if it is genuinely open."), console.log("\nBefore hand-rolling another check: `guards: [{ action, resourceType, resource }]`"), console.log("answers \"may this subject act on THIS row\" declaratively, and an app whose"), console.log("relationships live in its own tables registers its own tuple source rather than"), console.log("copying data into a framework table. See the authorization docs."), !0);
-}, kn = async (e) => {
+}, jn = async (e) => {
 	try {
-		let { loadApiConfig: t } = await import("./dev--A3nsxA3.js"), { decidedSchemaReport: n } = await import("./doctorDecidedSchema-BlbWgCD_.js"), r = await t(e);
+		let { loadApiConfig: t } = await import("./dev-cKUiZZsB.js"), { decidedSchemaReport: n } = await import("./doctorDecidedSchema-BlbWgCD_.js"), r = await t(e);
 		return r == null ? null : n({
 			...r.schema ? { declared: r.schema } : {},
 			...r.store === void 0 ? {} : { store: r.store },
@@ -1972,42 +2004,42 @@ var le = /* @__PURE__ */ new Set([
 	} catch {
 		return null;
 	}
-}, An = async (e) => {
-	let t = await kn(e);
+}, Mn = async (e) => {
+	let t = await jn(e);
 	if (t !== null) {
 		console.log(""), console.log("•  framework tables whose presence is DECIDED rather than implied by your source tree:");
 		for (let e of t.text.split("\n")) console.log(`   ${e}`);
 	}
-}, jn = async (e) => {
+}, Nn = async (e) => {
 	if (e.includes("--help") || e.includes("-h")) return console.log($t), 0;
-	let t = e.includes("--strict"), n = e.find((e) => !e.startsWith("-")), r = b(n ?? process.cwd());
+	let t = e.includes("--strict"), n = e.find((e) => !e.startsWith("-")), o = b(n ?? process.cwd());
 	if (g(e)) return ee(), h({
-		...z(r),
-		spaCandidates: await B(r),
-		pageConvention: V(r),
-		fileTaxonomy: re(r).findings,
-		junctionFks: (await W(r))?.issues ?? [],
-		eventDelivery: await G(r),
-		duplicateInstances: s(r),
-		versionSkew: i(r) ?? null,
-		serverOnly: (await q(r)).status,
-		accessDecisions: await J(r),
-		webhookVerification: await Y(r),
-		authz: await En(r),
-		ungrantedScopes: await Q(r),
-		neverEmittedEvents: await Z(r),
-		unimportedDeps: Be(r),
-		stalledRuns: await pn(r),
-		decidedSchema: await kn(r)
+		...z(o),
+		spaCandidates: await B(o),
+		pageConvention: V(o),
+		fileTaxonomy: re(o).findings,
+		junctionFks: (await W(o))?.issues ?? [],
+		eventDelivery: await G(o),
+		duplicateInstances: s(o),
+		versionSkew: r(o) ?? null,
+		serverOnly: (await q(o)).status,
+		accessDecisions: await J(o),
+		webhookVerification: await Y(o),
+		authz: await On(o),
+		ungrantedScopes: await Q(o),
+		neverEmittedEvents: await Z(o),
+		unimportedDeps: Be(o),
+		stalledRuns: await pn(o),
+		decidedSchema: await jn(o)
 	}), 0;
-	let a = gt(r, t);
-	Bt(r), zt(r), Qt(r), ne(r), await Kt(r), await hn(r), await mn(r), await tn(r), await sn(r), await on(r), await An(r), await cn(r), await Cn(r), await bn(r), await vn(r), console.log("");
-	for (let e of Ve(Be(r))) console.log(e);
-	await xn(r);
-	let o = await fn(r), c = await On(r, e.includes("--write-authz-allowlist")), d = await ln(r), f = await dn(r), p = await Sn(r), m = u(i(r));
+	let c = gt(o, t);
+	Bt(o), zt(o), Qt(o), ne(o), await Kt(o), await hn(o), await mn(o), await tn(o), await sn(o), await on(o), await Mn(o), await cn(o), await Tn(o), await bn(o), await vn(o), console.log("");
+	for (let e of Ve(Be(o))) console.log(e);
+	await xn(o), await Sn(o), await Cn(o);
+	let l = await fn(o), u = await An(o, e.includes("--write-authz-allowlist")), d = await ln(o), f = await dn(o), p = await wn(o), m = a(r(o));
 	m !== void 0 && (console.log(""), console.log(m));
-	let _ = l(s(r));
-	return _ !== void 0 && console.log(`\n${_}`), o || c || d || p || f ? Math.max(a, 1) : a;
+	let _ = i(s(o));
+	return _ !== void 0 && console.log(`\n${_}`), l || u || d || p || f ? Math.max(c, 1) : c;
 };
 //#endregion
-export { B as C, Y as E, V as S, Q as T, Qt as _, En as a, gt as b, G as c, Nt as d, mt as f, Bt as g, zt as h, J as i, gn as l, rn as m, ht as n, Z as o, W as p, Vt as r, _n as s, $t as t, z as u, Kt as v, q as w, Pt as x, jn as y };
+export { B as C, Y as E, V as S, Q as T, Qt as _, On as a, gt as b, G as c, Nt as d, mt as f, Bt as g, zt as h, J as i, gn as l, rn as m, ht as n, Z as o, W as p, Vt as r, _n as s, $t as t, z as u, Kt as v, q as w, Pt as x, Nn as y };

package/dist/doctorCommand-J3qu4E0Y.js

@@ -0,0 +1,2 @@
+import { b as e, y as t } from "./doctorCommand-DCiFVMtZ.js";
+export { t as runDoctorCommand, e as runServePreflight };

package/dist/{dormancyCommand-Drn7o0No.js → dormancyCommand-w1TrmgYP.js}

@@ -1,4 +1,4 @@
-import { c as e, i as t } from "./dev-CRHoCEiy.js";
+import { c as e, i as t } from "./dev-CmuvUKRq.js";
 import { n, t as r } from "./cliArgs-D4p8n7EE.js";
 import { r as i } from "./appPort-B_HpJ_ck.js";
 import { resolve as a } from "node:path";

package/dist/{embeddingsCommand-Z-jO1fWN.js → embeddingsCommand-CMgPyRTr.js}

@@ -1,4 +1,4 @@
-import { c as e, i as t } from "./dev-CRHoCEiy.js";
+import { c as e, i as t } from "./dev-CmuvUKRq.js";
 import { Effect as n } from "effect";
 import { embedMany as r } from "@voltro/ai";
 //#region src/embeddingsBackfill.ts

package/dist/{envCommand-D4gCrrTZ.js → envCommand-Cyynmcfa.js}

@@ -1,5 +1,5 @@
-import { c as e } from "./dev-CRHoCEiy.js";
-import { Et as t, Ot as n, Tt as r, kt as i } from "./webDev-BgWL9gKV.js";
+import { c as e } from "./dev-CmuvUKRq.js";
+import { Gt as t, Ht as n, Vt as r, Wt as i } from "./webDev-DSI9SOhs.js";
 import { join as a } from "node:path";
 import { promises as o } from "node:fs";
 import { createLogger as s } from "@voltro/logger";
@@ -28,20 +28,20 @@ var u = s({ scope: "voltro:env" }), d = "# Environment for this app", f = async
 		m(`${p(e.key, 32)} ${p(e.owner, 16)} ${p(e.access, 8)} ${p(e.required ? "yes" : "", 4)} ${t}`);
 	}
 	return n.summary.missingRequired > 0 ? (u.error(`${n.summary.missingRequired} required var(s) are unset`), 1) : 0;
-}, g = async (e, n) => {
+}, g = async (e, t) => {
 	let r = await f(e);
 	if (!r) return u.error("no app.config.ts found in the current directory"), 1;
-	let i = t(r.input, ["Environment for this app — generated from app.config.ts `env` + plugin declarations.", "Regenerate with `voltro env sync`. Copy to `.env` and fill in the blanks."]), s = a(e, ".env.example"), c = await o.readFile(s, "utf8").catch(() => null);
-	if (c !== null && !c.startsWith(d) && !n) {
+	let i = n(r.input, ["Environment for this app — generated from app.config.ts `env` + plugin declarations.", "Regenerate with `voltro env sync`. Copy to `.env` and fill in the blanks."]), s = a(e, ".env.example"), c = await o.readFile(s, "utf8").catch(() => null);
+	if (c !== null && !c.startsWith(d) && !t) {
 		let t = a(e, ".env.example.generated");
 		return await o.writeFile(t, i, "utf8"), u.warn(".env.example exists and is not framework-generated — wrote .env.example.generated instead", { hint: "merge it by hand, or pass --force to overwrite .env.example" }), 0;
 	}
 	return await o.writeFile(s, i, "utf8"), u.info("wrote .env.example", { app: r.name }), 0;
-}, _ = async (t) => {
-	let r = await e(t).catch(() => null);
+}, _ = async (n) => {
+	let r = await e(n).catch(() => null);
 	if (!r) return u.error("no app.config.ts found in the current directory"), 1;
 	let a = l(r.env) ? r.env : void 0;
-	return a ? (r.type === "web" ? (await n(t, a), u.info("wrote src/voltro-env.d.ts (publicEnv augmentation)", { app: r.name ?? "app" })) : (await i(t, a), u.info("wrote env.generated.d.ts (serverEnv augmentation)", { app: r.name ?? "app" })), 0) : (u.warn("no `defineEnv` declared in app.config.ts — nothing to generate", { hint: "add `env: defineEnv({ ... })` to app.config.ts (see @voltro/env)" }), 0);
+	return a ? (r.type === "web" ? (await i(n, a), u.info("wrote src/voltro-env.d.ts (publicEnv augmentation)", { app: r.name ?? "app" })) : (await t(n, a), u.info("wrote env.generated.d.ts (serverEnv augmentation)", { app: r.name ?? "app" })), 0) : (u.warn("no `defineEnv` declared in app.config.ts — nothing to generate", { hint: "add `env: defineEnv({ ... })` to app.config.ts (see @voltro/env)" }), 0);
 }, v = () => {
 	let e = c();
 	return u.info(`${e.length} framework env vars for turbo.json globalPassThroughEnv:`), m(JSON.stringify([...e].sort(), null, 2)), u.info("merge these into the workspace turbo.json `globalPassThroughEnv` array (+ your own app vars)."), 0;

package/dist/{evolveCommand-CMROeKeA.js → evolveCommand-BwvQ8dVH.js}

@@ -1,6 +1,6 @@
 import { n as e } from "./cliOutput-D1tSBoRM.js";
-import { i as t } from "./checkCommand-COmqc2cB.js";
-import { i as n, n as r } from "./codemodRunner-r7J9lIa7.js";
+import { i as t } from "./checkCommand-Dg1G7Gwd.js";
+import { i as n, n as r } from "./codemodRunner-Cd4xkC6u.js";
 import { basename as i, join as a, resolve as o } from "node:path";
 import { branchNamespaceName as s, planBranchProvision as c } from "@voltro/database";
 import { readFile as l } from "node:fs/promises";

package/dist/fileConventions-l-RIXbx8.js

@@ -0,0 +1,36 @@
+//#region src/fileConventions.ts
+var e = /\.(query|mutation|action|stream)\.ts$/, t = /\.(query|mutation|action|stream)\.server\.ts$/, n = /\.event\.ts$/, r = /\.ws\.ts$/, i = /\.workflow\.tsx$/, a = /\.workflow\.server\.tsx$/, o = /\.workflow\.tsx?$/, s = /\.trigger\.tsx?$/, c = /\.cron\.tsx?$/, l = /\.webhook\.tsx?$/, u = /\.outbox\.tsx?$/, d = /\.consumer\.tsx?$/, f = /\.subscribe\.tsx?$/, p = /\.reaction\.tsx?$/, m = /\.aggregate\.tsx?$/, h = /\.expectation\.ts$/, g = /\.budget\.ts$/, _ = /\.experiment\.ts$/, v = /\.deepLink\.ts$/, y = /\.startup\.tsx?$/, b = /\.seed\.ts$/, x = /\.relations\.ts$/, S = /\.entity\.ts$|\.schema\.ts$|^schema\.ts$/, C = (e) => o.test(e) && !i.test(e) && !a.test(e), w = /(?:^|\/)page\.tsx$/, T = /\.island\.tsx?$/, E = /\.component\.tsx$/, D = /\.component\.ui\.tsx$/, O = /\.hook\.tsx?$/, k = /\.internal\.tsx?$/, A = /\.types\.tsx?$/, j = /\.fixture\.tsx?$/, M = /\.tracking\.tsx?$/, N = /\.store\.tsx?$/, P = /\.client\.tsx?$/, F = /\.(test|spec)\.tsx?$/, I = [
+	e,
+	t,
+	o,
+	a,
+	s,
+	c,
+	l,
+	u,
+	d,
+	f,
+	p,
+	m,
+	y,
+	h,
+	g,
+	_,
+	b,
+	x,
+	S,
+	/\.route\.tsx?$/,
+	n,
+	r,
+	v,
+	N,
+	P,
+	/\.(agent|tool|email|connection|serverless|server|config|generated)\.tsx?$/
+], L = (e) => I.some((t) => t.test(e)), R = /* @__PURE__ */ new Set([
+	"layout.tsx",
+	"error.tsx",
+	"loading.tsx",
+	"not-found.tsx"
+]);
+//#endregion
+export { A, b as C, F as D, f as E, r as F, L as I, C as L, i as M, o as N, M as O, a as P, S, N as T, R as _, d as a, p as b, n as c, j as d, O as f, w as g, u as h, D as i, l as j, s as k, h as l, T as m, g as n, c as o, k as p, E as r, v as s, m as t, _ as u, e as v, y as w, x, t as y };