@voltro/cli 0.51.0 → 0.53.0

package/dist/{doctorCommand-nKmeW78u.js → doctorCommand-etMkflRc.js}

@@ -1,11 +1,11 @@
-import { Ht as e, Ut as t, Vt as n } from "./dev-kdAg9Q7l.js";
-import { at as r, ct as i, ot as a, s as o, st as s, t as c, w as l, y as u } from "./webDev-B-ubQEMX.js";
-import { x as d } from "./frameworkTableAssembly-BwJVEKLr.js";
-import { n as f } from "./pageConvention-cEiRxdab.js";
-import { r as p, u as m } from "./apiBuild-CPDHXF72.js";
+import { Ht as e, Ut as t, Wt as n } from "./dev-C6LGF4iY.js";
+import { Ft as r, It as i, Nt as a, P as o, Pt as s, l as c, t as l, x as u } from "./webDev-oczpugbx.js";
+import { x as d } from "./frameworkTableAssembly-DKx3ba3S.js";
+import { n as f } from "./pageConvention-C938S8oC.js";
+import { r as p, u as m } from "./apiBuild-CaPfoWku.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-CJfgOllU.js";
+import { n as ne, r as re } from "./fileTaxonomy-B7uxipWS.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";
@@ -367,14 +367,84 @@ var le = /* @__PURE__ */ new Set([
 	"   reaches your deploy target is not knowable from here — a secret manager",
 	"   or a CI variable is not a file. Naming it nowhere is conclusive; naming",
 	"   it somewhere is not a guarantee."
-].join("\n"), Pe = (e) => {
+].join("\n"), j = {
+	"@voltro/cli": "provides the `voltro` binary; consumed by scripts, never imported",
+	"@voltro/devtools": "mounted by `voltro dev` itself",
+	"@voltro/sql-postgres": "dialect driver, loaded by the framework from config",
+	"@voltro/sql-mysql": "dialect driver, loaded by the framework from config",
+	"@voltro/sql-sqlite": "dialect driver, loaded by the framework from config",
+	"@voltro/sql-mssql": "dialect driver, loaded by the framework from config"
+}, M = /* @__PURE__ */ new Set(["@voltro/client", "@voltro/web"]), Pe = /(^|\/)(node_modules|dist|build|\.framework|\.next|\.turbo|\.git|coverage|\.publish)(\/|$)/, Fe = /\.([cm]?[jt]sx?)$/, Ie = /\.generated\.[cm]?[jt]sx?$/, Le = (e, t = [], n = 0) => {
+	if (n > 12 || Pe.test(e)) return t;
+	let r;
+	try {
+		r = w(e);
+	} catch {
+		return t;
+	}
+	for (let i of r) {
+		let r = v(e, i), a;
+		try {
+			a = T(r);
+		} catch {
+			continue;
+		}
+		a.isDirectory() ? Le(r, t, n + 1) : Fe.test(i) && t.push(r);
+	}
+	return t;
+}, Re = /(?:\bfrom\s*|\bimport\s+|\bimport\s*\(\s*|\brequire\s*\(\s*)['"](@voltro\/[a-z0-9-]+)(?:\/[^'"]*)?['"]/g, ze = (e) => e.split("\n").filter((e) => !/^\s*(\/\/|\*|\/\*)/.test(e)).join("\n"), Be = (e) => {
+	let t;
+	try {
+		t = JSON.parse(C(v(e, "package.json"), "utf8"));
+	} catch {
+		return null;
+	}
+	let n = (e) => Object.keys(t[e] ?? {}).filter((e) => e.startsWith("@voltro/")).map((t) => ({
+		pkg: t,
+		declaredIn: e
+	})), r = /* @__PURE__ */ new Set(), i = [...n("dependencies"), ...n("devDependencies")].filter((e) => !r.has(e.pkg) && (r.add(e.pkg), !0)), a = Le(e), o = a.some((e) => Ie.test(e)), s = /* @__PURE__ */ new Set();
+	for (let e of a) {
+		let t;
+		try {
+			t = C(e, "utf8");
+		} catch {
+			continue;
+		}
+		for (let e of ze(t).matchAll(Re)) s.add(e[1]);
+	}
+	let c = i.filter((e) => !(e.pkg in j) && !s.has(e.pkg));
+	return {
+		declared: i.map((e) => e.pkg).sort(),
+		unimported: c.filter((e) => o || !M.has(e.pkg)).sort((e, t) => e.pkg.localeCompare(t.pkg)),
+		pendingCodegen: o ? [] : c.map((e) => e.pkg).filter((e) => M.has(e)).sort(),
+		exempt: i.map((e) => e.pkg).filter((e) => e in j).sort(),
+		scannedFiles: a.length
+	};
+}, Ve = (e) => {
+	if (e === null) return ["unimported deps · no package.json here — could not check"];
+	let t = `unimported deps · ${e.declared.length} @voltro/* package(s) declared, ${e.scannedFiles} file(s) scanned`;
+	if (e.declared.length === 0) return [t, "  no @voltro/* dependencies declared — nothing to check"];
+	let n = e.exempt.length > 0 ? ` (${e.exempt.length} loaded by the framework itself: ${e.exempt.join(", ")})` : "", r = e.pendingCodegen.length > 0 ? [
+		`  · ${e.pendingCodegen.length} not measurable yet (${e.pendingCodegen.join(", ")}) — their import`,
+		"    site lives in generated code, and codegen has not run here. Run `voltro dev`",
+		"    once, then re-check."
+	] : [];
+	if (e.unimported.length === 0) return [
+		t,
+		`  ✓ all ${e.declared.length - e.exempt.length - e.pendingCodegen.length} measurable package(s) have an import site${n}`,
+		...r
+	];
+	let i = [t];
+	for (let t of e.unimported) i.push(`  ⚠ ${t.pkg} — declared in ${t.declaredIn}, imported nowhere`);
+	return i.push("      a dependency nobody imports still gets installed, updated, and read as"), i.push("      evidence the package is in use — its breaking-change notes included."), i.push("      Remove it, or if it IS imported through an assembled specifier the scan"), i.push("      cannot see, keep it and ignore this line — the rule is advisory."), i.push(...r), n !== "" && i.push(`  ·${n.slice(1)}`), i;
+}, He = (e) => {
 	if (e.catalogCodes.length === 0) return;
 	let t = new Set(e.declaredLocales), n = e.catalogCodes.filter((e) => !t.has(e)).sort();
 	if (n.length !== 0) return {
 		orphaned: n,
 		noneDeclared: t.size === 0
 	};
-}, Fe = (e, t) => {
+}, Ue = (e, t) => {
 	let n = e.orphaned.join(", ");
 	return e.noneDeclared ? [
 		`⚠  ${t} has ${e.orphaned.length} catalog(s) — ${n} — and the app declares no \`locales:\`.`,
@@ -386,7 +456,7 @@ var le = /* @__PURE__ */ new Set([
 		"   …or delete the files. A catalog that is never loaded looks from the inside",
 		"   exactly like one that works, which is why this is worth a line."
 	] : [`⚠  ${t} has catalog(s) not in \`locales:\` — ${n} — so they are never imported.`, "   Add the code(s) to `locales:` in your app config, or delete the file(s)."];
-}, Ie = (e) => {
+}, We = (e) => {
 	let t = e.getProperty("match");
 	if (t === void 0) return null;
 	let n = (t.asKind(O.PropertyAssignment)?.getInitializer())?.asKind(O.ObjectLiteralExpression);
@@ -423,7 +493,7 @@ var le = /* @__PURE__ */ new Set([
 		else return;
 	}
 	return r;
-}, Le = (e, t) => {
+}, Ge = (e, t) => {
 	let n = ["middleware.ts", "middleware.tsx"].find((t) => S(v(e, t)));
 	if (n === void 0) return;
 	let r = new D({
@@ -440,19 +510,19 @@ var le = /* @__PURE__ */ new Set([
 			file: n
 		};
 	}
-	let a = [], o = [], s = 0;
+	let a = [], s = [], c = 0;
 	for (let e of i.getVariableDeclarations()) {
 		let t = e.getInitializerIfKind(O.CallExpression);
 		if (t?.getExpression().getText() !== "defineMiddleware") continue;
-		s += 1;
+		c += 1;
 		let n = e.getName(), r = t.getArguments()[0]?.asKind(O.ObjectLiteralExpression);
 		if (r === void 0) {
-			o.push(n);
+			s.push(n);
 			continue;
 		}
-		let i = Ie(r);
+		let i = We(r);
 		if (i === void 0) {
-			o.push(n);
+			s.push(n);
 			continue;
 		}
 		a.push({
@@ -465,45 +535,45 @@ var le = /* @__PURE__ */ new Set([
 		});
 	}
 	return {
-		problems: l(a, t).map((e) => e.message),
-		unreadable: o,
-		seen: s,
+		problems: o(a, t).map((e) => e.message),
+		unreadable: s,
+		seen: c,
 		file: n
 	};
-}, Re = (e) => {
+}, Ke = (e) => {
 	let t = [];
 	if (e.problems.length > 0) {
 		t.push(`✗ ${e.file}: ${e.problems.length} matcher problem(s) — this REFUSES the boot`);
 		for (let n of e.problems) t.push(`    • ${n}`);
 	}
 	return e.unreadable.length > 0 && t.push(`… ${e.file}: ${e.unreadable.length} matcher(s) not statically readable (${e.unreadable.join(", ")}) — doctor did NOT check them. The boot still does.`), e.seen === 0 && t.push(`… ${e.file}: no \`defineMiddleware(...)\` found — doctor checked nothing here. A middleware assigned through a variable or re-exported from another module is invisible to this rule.`), t.length === 0 && e.seen > 0 && t.push(`✓ ${e.file}: ${e.seen} middleware(s), matchers resolve and do not overlap`), t;
-}, ze = (e) => e.replace(/\/\*[\s\S]*?\*\//g, "").replace(/(^|[^:])\/\/[^\n]*/g, "$1"), Be = /* @__PURE__ */ new Set([
+}, qe = (e) => e.replace(/\/\*[\s\S]*?\*\//g, "").replace(/(^|[^:])\/\/[^\n]*/g, "$1"), Je = /* @__PURE__ */ new Set([
 	"requireScope",
 	"requireAnyScope",
 	"requireAuth",
 	"assertScope",
 	"assertCan",
 	"can"
-]), Ve = (e) => {
+]), Ye = (e) => {
 	let t = /* @__PURE__ */ new Set();
-	for (let n of e) for (let e of ze(n).matchAll(/\bexport\s+(?:const|function|async\s+function)\s+((?:require|assert)[A-Z]\w*)/g)) t.add(e[1]);
+	for (let n of e) for (let e of qe(n).matchAll(/\bexport\s+(?:const|function|async\s+function)\s+((?:require|assert)[A-Z]\w*)/g)) t.add(e[1]);
 	return t;
-}, He = (e, t) => {
+}, Xe = (e, t) => {
 	for (let n of t) if (RegExp(`\\b${n}\\s*\\(`).test(e)) return n;
-}, Ue = (e) => {
+}, Ze = (e) => {
 	let t = /\bsubject\s*\.\s*id\b[^\n]*?(?:!==|===|!=|==)|(?:!==|===|!=|==)[^\n]*?\bsubject\s*\.\s*id\b/.test(e), n = /(?:Error|Denied|Forbidden|Unauthorized)\b|\b(?:fail|die|throw)\b/.test(e);
 	return t && n;
-}, We = (e, t, n) => {
+}, Qe = (e, t, n) => {
 	if (e.hasDeclaredGuards) return { kind: "declared-guard" };
-	let r = ze(e.src), i = He(r, t);
-	return i === void 0 ? Ue(r) ? { kind: "inline-ownership" } : n.has(e.tag) ? { kind: "allowlisted" } : { kind: "unchecked" } : {
+	let r = qe(e.src), i = Xe(r, t);
+	return i === void 0 ? Ze(r) ? { kind: "inline-ownership" } : n.has(e.tag) ? { kind: "allowlisted" } : { kind: "unchecked" } : {
 		kind: "vocabulary-guard",
 		name: i
 	};
-}, Ge = (e, t, n) => {
+}, $e = (e, t, n) => {
 	let r = e.op === "delete" ? 3 : e.op === "update" ? 2 : 1;
 	return e.table !== void 0 && (t.has(e.table) && (r += 2), n.has(e.table) && e.op === "delete" && (r += 2)), r;
-}, Ke = (e, t, n) => {
+}, et = (e, t, n) => {
 	switch (t.kind) {
 		case "declared-guard": return "guards: on the descriptor";
 		case "vocabulary-guard": return `calls ${t.name}()`;
@@ -511,15 +581,15 @@ var le = /* @__PURE__ */ new Set([
 		case "allowlisted": return "accepted by a previous run";
 		case "unchecked": return n ? e.op === "read" ? "no check in this file — this app registers a row filter; VERIFY it covers this table, then record it as reviewed= rather than debt" : `${e.op}s${e.table ? ` ${e.table}` : ""} with no check in this file — this app registers a row filter; VERIFY it covers this table, then record it as reviewed= rather than debt` : e.op === "read" ? "returns a row the client selected, with nothing compared to the caller" : `${e.op}s${e.table ? ` ${e.table}` : ""} with nothing constraining WHICH row`;
 	}
-}, qe = (e) => {
+}, tt = (e) => {
 	let t = e.executors.map((t) => {
-		let n = We(t, e.guardVocabulary, e.allowlist);
+		let n = Qe(t, e.guardVocabulary, e.allowlist);
 		return {
 			tag: t.tag,
 			path: t.path,
 			verdict: n,
-			severity: Ge(t, e.tenantScopedTables, e.referencedTables),
-			why: Ke(t, n, e.rowFilterRegistered === !0)
+			severity: $e(t, e.tenantScopedTables, e.referencedTables),
+			why: et(t, n, e.rowFilterRegistered === !0)
 		};
 	}), n = (e) => t.filter((t) => t.verdict.kind === e).length;
 	return {
@@ -533,7 +603,7 @@ var le = /* @__PURE__ */ new Set([
 		},
 		unchecked: t.filter((e) => e.verdict.kind === "unchecked").sort((e, t) => t.severity - e.severity || e.tag.localeCompare(t.tag))
 	};
-}, Je = [
+}, nt = [
 	"# voltro doctor — authz allowlist",
 	"#",
 	"# Two KINDS of line, and the difference is the point:",
@@ -558,19 +628,19 @@ var le = /* @__PURE__ */ new Set([
 	"# `--write-authz-allowlist` PRESERVES reviewed= lines. It only ever adds debt",
 	"# lines for executors that are newly unchecked.",
 	""
-], Ye = (e) => {
+], rt = (e) => {
 	let t = [...e].map((e) => typeof e == "string" ? { tag: e } : e), n = t.filter((e) => e.reviewed === void 0).map((e) => e.tag).sort(), r = t.filter((e) => e.reviewed !== void 0).sort((e, t) => e.tag.localeCompare(t.tag));
 	return [
-		...Je,
+		...nt,
 		...n,
 		...r.length > 0 ? ["", "# reviewed — read by a human, open on purpose"] : [],
 		...r.map((e) => `${e.tag}  reviewed=${e.reviewed}`),
 		""
 	].join("\n");
-}, Xe = (e, t) => {
+}, it = (e, t) => {
 	let n = [...new Set(t)].sort();
-	if (e === void 0) return Ye(n.map((e) => ({ tag: e })));
-	let r = j(e).tags, i = n.filter((e) => !r.has(e));
+	if (e === void 0) return rt(n.map((e) => ({ tag: e })));
+	let r = N(e).tags, i = n.filter((e) => !r.has(e));
 	return i.length === 0 ? e : [
 		e.replace(/\n+$/, ""),
 		"",
@@ -579,25 +649,25 @@ var le = /* @__PURE__ */ new Set([
 		...i,
 		""
 	].join("\n");
-}, Ze = (e, t) => {
+}, at = (e, t) => {
 	let n = [...new Set(t)];
 	if (e === void 0) return {
 		added: n.length,
 		kept: 0,
 		removed: 0
 	};
-	let r = j(e).tags;
+	let r = N(e).tags;
 	return {
 		added: n.filter((e) => !r.has(e)).length,
 		kept: r.size,
 		removed: 0
 	};
-}, Qe = class extends Error {
+}, ot = class extends Error {
 	tag;
 	constructor(e) {
 		super(`authz allowlist: '${e}' is marked reviewed with no reason. Write \`${e}  reviewed=<why it is genuinely open>\`. A bare tag is the other, honest option — it records the executor as DEBT, which is what an unexplained exemption is.`), this.tag = e, this.name = "AllowlistReasonMissingError";
 	}
-}, j = (e) => {
+}, N = (e) => {
 	let t = [];
 	for (let n of e.split("\n")) {
 		let e = n.trim();
@@ -610,7 +680,7 @@ var le = /* @__PURE__ */ new Set([
 			continue;
 		}
 		let a = r[2].trim();
-		if (a.length === 0) throw new Qe(i);
+		if (a.length === 0) throw new ot(i);
 		t.push({
 			tag: i,
 			reviewed: a
@@ -620,13 +690,13 @@ var le = /* @__PURE__ */ new Set([
 		tags: new Set(t.map((e) => e.tag)),
 		entries: t
 	};
-}, $e = (e) => {
+}, st = (e) => {
 	let t = e.indexOf(".");
 	return t <= 0 ? void 0 : e.slice(0, t);
-}, et = (e, t) => {
+}, ct = (e, t) => {
 	let n = new Set(t.tables), r = new Set(t.rpcTags), i = /* @__PURE__ */ new Map();
 	for (let e of t.rpcTags) {
-		let t = $e(e);
+		let t = st(e);
 		if (t === void 0) continue;
 		let n = i.get(t);
 		n ? n.push(e) : i.set(t, [e]);
@@ -655,7 +725,7 @@ var le = /* @__PURE__ */ new Set([
 			});
 			continue;
 		}
-		let s = new Set(o.rpcTags.map($e).filter((e) => e !== void 0));
+		let s = new Set(o.rpcTags.map(st).filter((e) => e !== void 0));
 		for (let e of s) {
 			let t = i.get(e);
 			t !== void 0 && a.push({
@@ -668,12 +738,12 @@ var le = /* @__PURE__ */ new Set([
 		}
 	}
 	return a;
-}, tt = (e, t) => {
+}, lt = (e, t) => {
 	let n = e.reduce((e, t) => e + t.tables.length, 0), r = [`plugin surface · ${e.length} plugin(s) contribute ${n} table(s)`];
 	if (t.length === 0) return r.push("  ✓ no overlap with your own tables or rpc namespaces"), r;
 	for (let e of t) r.push(`  ${e.fatal ? "✗" : "⚠"} ${e.plugin} — ${e.detail}`), r.push(`      ${e.fix}`);
 	return r;
-}, nt = async (e) => {
+}, ut = async (e) => {
 	if (!await e.hasWorkflows().catch(() => !1)) return { kind: "not-applicable" };
 	let t;
 	try {
@@ -697,12 +767,12 @@ var le = /* @__PURE__ */ new Set([
 	} finally {
 		await t.close().catch(() => {});
 	}
-}, rt = (e) => {
+}, dt = (e) => {
 	let t = Math.round(e / 6e4);
 	if (t < 90) return `${t}m`;
 	let n = Math.round(t / 60);
 	return n < 48 ? `${n}h` : `${Math.round(n / 24)}d`;
-}, it = (e) => {
+}, ft = (e) => {
 	if (e.kind === "not-applicable") return null;
 	if (e.kind === "skipped") return `•  stuck runs: NOT CHECKED — ${e.reason}\n   This is the one doctor rule that reads the database rather than your source.
    Run it where the app's DB env vars are set, or ignore this line locally.`;
@@ -710,13 +780,13 @@ var le = /* @__PURE__ */ new Set([
 	if (t.stalled.length === 0) n.push(`✓  stuck runs: none (${t.examined} live run(s) old enough to examine${t.waitingOnTimer > 0 ? `, ${t.waitingOnTimer} waiting on a durable timer` : ""}${t.alreadyReported > 0 ? `, ${t.alreadyReported} already reported` : ""})`);
 	else {
 		n.push(`✗  stuck runs: ${t.stalled.length} run(s) have made no progress`);
-		for (let e of t.stalled.slice(0, 20)) n.push(`   ${e.tag}  ${e.runId}  idle ${rt(e.idleMs)}  ${e.reason}`);
+		for (let e of t.stalled.slice(0, 20)) n.push(`   ${e.tag}  ${e.runId}  idle ${dt(e.idleMs)}  ${e.reason}`);
 		t.stalled.length > 20 && n.push(`   … and ${t.stalled.length - 20} more`), n.push("   Nothing was changed — this is a SUSPICION, not a verdict. `awaiting-signal` usually means the sender never came.");
 	}
 	t.sawFullRunPage && n.push("   (the examined page filled up — more old runs exist than were read this pass)");
 	for (let e of t.failures) n.push(`   ! could not examine ${e.subject}: ${e.detail}`);
 	return n.join("\n");
-}, at = (e) => S(b(e, "app.config.ts")) || S(b(e, "app.config.js")), ot = (e) => {
+}, pt = (e) => S(b(e, "app.config.ts")) || S(b(e, "app.config.js")), mt = (e) => {
 	let t = m(e), n = p(e);
 	return {
 		root: e,
@@ -725,22 +795,22 @@ var le = /* @__PURE__ */ new Set([
 		apiBundle: n,
 		apiBundlePresent: S(n)
 	};
-}, st = [
+}, ht = [
 	"Production `voltro serve` requires a precompiled serve bundle and never transpiles on demand.",
 	"Add a `voltro build .` step BEFORE `voltro serve .` in your Dockerfile / start script.",
 	"(Generated Dockerfiles from `voltro create-project` already do this.)"
-].join("\n  "), ct = (e, t = !1) => {
-	let n = ot(e);
-	if (console.log(`voltro doctor — serve preflight for ${n.root}`), !at(e)) return console.log("•  no app.config found here — nothing to check (run against an app root)."), 0;
+].join("\n  "), gt = (e, t = !1) => {
+	let n = mt(e);
+	if (console.log(`voltro doctor — serve preflight for ${n.root}`), !pt(e)) return console.log("•  no app.config found here — nothing to check (run against an app root)."), 0;
 	console.log(`${n.serveBundlePresent ? "✓" : "✗"}  serve bundle: ${n.serveBundlePresent ? "present" : "MISSING"} (${n.serveBundle})`), console.log(`${n.apiBundlePresent ? "✓" : "•"}  api bundle:   ${n.apiBundlePresent ? "present" : "absent"} (${n.apiBundle})`);
 	let r = process.env.NODE_ENV === "production";
 	if (n.serveBundlePresent) return console.log("✓  serve preflight: ready for `voltro serve`."), 0;
 	let i = t || r;
-	return console.error(`${i ? "✗" : "•"}  serve bundle missing — ${i ? "production `voltro serve` will FAIL." : "a non-production `voltro serve` still runs via tsx."}`), console.error(`  ${st}`), +!!i;
-}, lt = (e) => {
+	return console.error(`${i ? "✗" : "•"}  serve bundle missing — ${i ? "production `voltro serve` will FAIL." : "a non-production `voltro serve` still runs via tsx."}`), console.error(`  ${ht}`), +!!i;
+}, _t = (e) => {
 	let t = e.absPath.replace(/\.server\.(tsx?)$/, ".$1");
 	if (t !== e.absPath) return e.sources.get(t) ?? e.sources.get(t.replace(/\.ts$/, ".tsx"));
-}, ut = (e, t, n) => {
+}, vt = (e, t, n) => {
 	let r = new Set(e), i = _(n), a = (e) => (/\.(tsx?|jsx?)$/.test(e) ? [e] : [
 		`${e}.ts`,
 		`${e}.tsx`,
@@ -766,7 +836,7 @@ var le = /* @__PURE__ */ new Set([
 			r !== void 0 && o.push(r);
 		}
 		return o;
-	}, s = /* @__PURE__ */ new Set(), c = e.filter((e) => ht.test(y(n, e))), l = new Set(c);
+	}, s = /* @__PURE__ */ new Set(), c = e.filter((e) => St.test(y(n, e))), l = new Set(c);
 	for (; c.length > 0;) {
 		let e = c.shift();
 		if (!s.has(e)) {
@@ -779,11 +849,11 @@ var le = /* @__PURE__ */ new Set([
 	let d = /* @__PURE__ */ new Set();
 	for (let e of s) l.has(e) || u.has(e) || d.add(e);
 	return d;
-}, M = (e) => e.replace(/\/\*[\s\S]*?\*\//g, " ").replace(/(^|[^:])\/\/[^\n]*/g, "$1").replace(/'(?:[^'\\\n]|\\.)*'/g, "''").replace(/"(?:[^"\\\n]|\\.)*"/g, "\"\""), dt = (e, t) => (e.match(t) ?? []).length, N = (e, t) => e.getDescendantsOfKind(O.CallExpression).filter((e) => t.test(e.getExpression().getText())).length, ft = (e, t) => {
+}, P = (e) => e.replace(/\/\*[\s\S]*?\*\//g, " ").replace(/(^|[^:])\/\/[^\n]*/g, "$1").replace(/'(?:[^'\\\n]|\\.)*'/g, "''").replace(/"(?:[^"\\\n]|\\.)*"/g, "\"\""), F = (e, t) => (e.match(t) ?? []).length, I = (e, t) => e.getDescendantsOfKind(O.CallExpression).filter((e) => t.test(e.getExpression().getText())).length, yt = (e, t) => {
 	if (e.src.includes(t)) return !0;
 	let n = t.replace(/^@voltro\/plugin-/, "");
-	return n !== t && N(e.file, RegExp(`^${n}Plugin$`)) > 0;
-}, pt = (e, t) => {
+	return n !== t && I(e.file, RegExp(`^${n}Plugin$`)) > 0;
+}, bt = (e, t) => {
 	let n = [], r = RegExp(`\\b${t}\\s*(?:<[^()]*>)?\\s*\\(`, "g"), i;
 	for (; (i = r.exec(e)) !== null;) {
 		let t = i.index + i[0].length, r = 1, a = t;
@@ -791,10 +861,10 @@ var le = /* @__PURE__ */ new Set([
 		n.push(e.slice(t, a - 1));
 	}
 	return n;
-}, mt = (e, t) => {
+}, xt = (e, t) => {
 	let n = t.getSymbol()?.getDeclarations()?.[0];
 	return n === void 0 ? [] : e.getDescendantsOfKind(O.Identifier).filter((e) => e.getSymbol()?.getDeclarations()?.[0] === n);
-}, ht = /\.(server|cron|workflow\.server|subscribe|reaction|outbox|startup|trigger|webhook|migration|seed)\.tsx?$/, gt = /\.(query|mutation|action|stream)\.server\.tsx?$/, _t = [
+}, St = /\.(server|cron|workflow\.server|subscribe|reaction|outbox|startup|trigger|webhook|migration|seed)\.tsx?$/, Ct = /\.(query|mutation|action|stream)\.server\.tsx?$/, wt = [
 	"Id",
 	"ID",
 	"Hash",
@@ -820,7 +890,7 @@ var le = /* @__PURE__ */ new Set([
 	"Comment",
 	"Provider",
 	"Format"
-], vt = RegExp(`(?:${_t.join("|")})$|_(?:${_t.map((e) => e.toLowerCase()).join("|")})$`), yt = [
+], Tt = RegExp(`(?:${wt.join("|")})$|_(?:${wt.map((e) => e.toLowerCase()).join("|")})$`), Et = [
 	{
 		id: "hardcoded-framework-cookie",
 		scope: "client",
@@ -833,7 +903,7 @@ var le = /* @__PURE__ */ new Set([
 		scope: "server",
 		smell: "an executor that never names its own descriptor — its input type is hand-written, so it can drift from the contract it implements",
 		use: "import the descriptor and type the input as `ExecutorInput<typeof descriptor>`, so the wire contract and the handler cannot disagree",
-		match: ({ src: e, path: t }) => gt.test(t) && !/\bimport\s[^;]*\bfrom\s*['"][^'"]*['"]/.test((e.match(/^\s*import\s[^;]*from\s*['"]\.[^'"]*['"]/gm) ?? []).join("\n"))
+		match: ({ src: e, path: t }) => Ct.test(t) && !/\bimport\s[^;]*\bfrom\s*['"][^'"]*['"]/.test((e.match(/^\s*import\s[^;]*from\s*['"]\.[^'"]*['"]/gm) ?? []).join("\n"))
 	},
 	{
 		id: "subject-write-no-guard",
@@ -842,12 +912,12 @@ var le = /* @__PURE__ */ new Set([
 		use: "declare `guards:` on the descriptor, or — if the procedure really is open — compare the loaded row's owner against `ctx.request.subject.id` and fail with a typed error",
 		match: (e) => {
 			let { src: t, path: n } = e;
-			if (!gt.test(n)) return !1;
-			let r = M(t);
+			if (!Ct.test(n)) return !1;
+			let r = P(t);
 			if (!(/\bsubject\s*\.\s*id\b/.test(r) && /\b(?:insert|update|upsert|insertMany|updateMany|insertRow|upsertRow|updateManyRow)\s*\(/.test(r)) || /\b(?:guard|guards|requireScope|requireAnyScope|assertCan|assertScope|requireAuth|Unauthenticated)\b/.test(r) || /[=!]==?\s*[^;\n]*\bsubject\s*\.\s*id\b|\bsubject\s*\.\s*id\b\s*[=!]==/.test(r)) return !1;
-			let i = lt(e);
+			let i = _t(e);
 			if (i === void 0) return !1;
-			let a = M(i);
+			let a = P(i);
 			return /\binternal\s*:\s*true\b/.test(a) || /\bguards\s*:\s*\[/.test(a) || /\.guard\s*\(/.test(a) ? !1 : /\bopenAccess\s*:/.test(a);
 		}
 	},
@@ -856,14 +926,14 @@ var le = /* @__PURE__ */ new Set([
 		scope: "server",
 		smell: "raw fetch() for outbound HTTP on the server (no traceparent, no retry, and no SSRF guard where the URL is not a constant)",
 		use: "yield* HttpClient — the framework client. It injects traceparent, retries, and honours `http.allowHosts`. Where the URL is built from anything a caller supplied it ALSO blocks loopback / RFC-1918 / link-local targets (incl. 169.254.169.254) on the initial request AND every redirect hop — for a hard-coded host that half is redundant, and the first three are still the reason to switch",
-		match: ({ file: e, path: t, serverOnly: n }) => (ht.test(t) || n) && N(e, /^(?:globalThis\.|window\.|self\.)?fetch$/) > 0
+		match: ({ file: e, path: t, serverOnly: n }) => (St.test(t) || n) && I(e, /^(?:globalThis\.|window\.|self\.)?fetch$/) > 0
 	},
 	{
 		id: "form",
 		scope: "client",
 		smell: "per-field useState + a submit flag (hand-rolled form)",
 		use: "useFormBinding — fields + validation from the mutation input Schema; server ValidationError({ field }) routes to the field",
-		match: ({ src: e, file: t }) => N(t, /^useState$/) >= 4 && /onSubmit|handleSubmit|isSubmitting/.test(e)
+		match: ({ src: e, file: t }) => I(t, /^useState$/) >= 4 && /onSubmit|handleSubmit|isSubmitting/.test(e)
 	},
 	{
 		id: "table",
@@ -891,7 +961,7 @@ var le = /* @__PURE__ */ new Set([
 		scope: "client",
 		smell: "useMemo fanning in multiple subscriptions (hand-maintained dep array)",
 		use: "useDerived — dependency-tracked, referentially stable",
-		match: ({ src: e }) => dt(e, /\buseSubscription\s*[(<]/g) >= 3 && dt(e, /\buseMemo\s*\(/g) >= 3
+		match: ({ src: e }) => F(e, /\buseSubscription\s*[(<]/g) >= 3 && F(e, /\buseMemo\s*\(/g) >= 3
 	},
 	{
 		id: "next-shim",
@@ -900,6 +970,13 @@ var le = /* @__PURE__ */ new Set([
 		use: "the native @voltro/web exports (useSearchParams, redirect, notFound, useServerRequest, …)",
 		match: ({ src: e }) => /from\s+['"][^'"]*next-(compat|shims)/.test(e)
 	},
+	{
+		id: "untyped-search-params",
+		scope: "client",
+		smell: "a page exporting a `searchParams` schema but reading the query untyped (zero-arg useSearchParams)",
+		use: "useSearchParams(searchParams) — the schema this page already declares, decoded with defaults applied",
+		match: (e) => /^export const searchParams\b/m.test(e.src) && e.file.getDescendantsOfKind(O.CallExpression).some((e) => e.getExpression().getText() === "useSearchParams" && e.getArguments().length === 0)
+	},
 	{
 		id: "presence",
 		scope: "client",
@@ -916,7 +993,7 @@ var le = /* @__PURE__ */ new Set([
 		match: ({ file: e }) => e.getDescendantsOfKind(O.CallExpression).filter((e) => /(^|\.)useSubscription$/.test(e.getExpression().getText())).flatMap((e) => {
 			let t = e.getFirstAncestorByKind(O.VariableDeclaration)?.getNameNode();
 			return t === void 0 ? [] : E.isObjectBindingPattern(t) ? t.getElements().filter((e) => (e.getPropertyNameNode() ?? e.getNameNode()).getText() === "data").map((e) => e.getNameNode()) : [];
-		}).some((t) => mt(e, t).some((e) => {
+		}).some((t) => xt(e, t).some((e) => {
 			let t = e.getParent();
 			if (E.isBinaryExpression(t)) {
 				let n = t.getOperatorToken().getText(), r = t.getLeft() === e ? t.getRight() : t.getLeft();
@@ -944,7 +1021,7 @@ var le = /* @__PURE__ */ new Set([
 		scope: "server",
 		smell: "several sequential store reads assembling related data (an N+1 you are writing by hand)",
 		use: "reads are a parent→child walk on ONE key → relations() in a *.relations.ts + .with({ … }) (ONE JSON-aggregate query, every dialect); reads collect ids from SEVERAL sources → keep the assembly and run the independent leading reads under Effect.all (same queries, same results, only concurrent — zero parity risk)",
-		match: (e) => N(e.file, /\bstore\.query$/) >= 3 || N(e.file, /\bstore\.query$/) >= 2 && /\bnew Map\s*\(/.test(e.src)
+		match: (e) => I(e.file, /\bstore\.query$/) >= 3 || I(e.file, /\bstore\.query$/) >= 2 && /\bnew Map\s*\(/.test(e.src)
 	},
 	{
 		id: "store-effect-lift",
@@ -967,7 +1044,7 @@ var le = /* @__PURE__ */ new Set([
 		use: ".encrypted() on the column — boot fails loudly if no cipher is configured, so it can never silently persist plaintext (a *Hash column and a vault* handle are NOT plaintext secrets: the hash IS the protection — often a unique lookup key — and the handle only names a secret held elsewhere, so both are skipped)",
 		match: ({ src: e }) => e.split("\n").some((e) => [...e.matchAll(/\b([A-Za-z_$][\w$]*)\s*:\s*(?:text|varchar|string|longtext)\s*\(/g)].some((t) => {
 			let n = t[1];
-			return !/token|secret|credential|password|apikey|accesskey/i.test(n) || vt.test(n) || /^vault/i.test(n) || /\.unique\s*\(/.test(e) ? !1 : !/\.encrypted\s*\(/.test(e);
+			return !/token|secret|credential|password|apikey|accesskey/i.test(n) || Tt.test(n) || /^vault/i.test(n) || /\.unique\s*\(/.test(e) ? !1 : !/\.encrypted\s*\(/.test(e);
 		}))
 	},
 	{
@@ -977,7 +1054,7 @@ var le = /* @__PURE__ */ new Set([
 		use: "you cannot look a value up by equality AND encrypt it non-deterministically — `.encrypted()` would make this column unfindable. Store the HASH as the unique lookup key and keep the secret itself either `.encrypted()` in a second column or nowhere (the framework's own `_voltro_api_keys.hashedKey` is the shape: the presented value is hashed and compared, never read back). A deterministic cipher is the other option and buys equality lookup at the cost of leaking which rows share a value",
 		match: ({ src: e }) => e.split("\n").some((e) => [...e.matchAll(/\b([A-Za-z_$][\w$]*)\s*:\s*(?:text|varchar|string|longtext)\s*\(/g)].some((t) => {
 			let n = t[1];
-			return !/token|secret|credential|password|apikey|accesskey/i.test(n) || vt.test(n) || /^vault/i.test(n) ? !1 : /\.unique\s*\(/.test(e) && !/\.encrypted\s*\(/.test(e);
+			return !/token|secret|credential|password|apikey|accesskey/i.test(n) || Tt.test(n) || /^vault/i.test(n) ? !1 : /\.unique\s*\(/.test(e) && !/\.encrypted\s*\(/.test(e);
 		}))
 	},
 	{
@@ -1041,9 +1118,9 @@ var le = /* @__PURE__ */ new Set([
 		scope: "server",
 		smell: "setRowFilter is registered, but no test passes `rowFilter:` to makeTestContext",
 		use: "wire the filter into at least one test (`makeTestContext({ subject, store, rowFilter })`) and sabotage the predicate once to watch it go red — an untested row filter is a visibility rule nothing verifies",
-		match: ({ file: e, testSources: t }) => N(e, /^setRowFilter$/) > 0 && ![...t.values()].some((e) => {
-			let t = M(e);
-			return pt(t, "makeTestContext").length > 0 && /\browFilter\b/.test(t);
+		match: ({ file: e, testSources: t }) => I(e, /^setRowFilter$/) > 0 && ![...t.values()].some((e) => {
+			let t = P(e);
+			return bt(t, "makeTestContext").length > 0 && /\browFilter\b/.test(t);
 		})
 	},
 	{
@@ -1053,15 +1130,15 @@ var le = /* @__PURE__ */ new Set([
 		use: "timestampMs / timestampMsOrNull from @voltro/database/wire in the descriptor's output struct — `output` IS the serializer (it is the rpc success schema), so a Date field declared as timestampMs crosses as epoch ms on its own; declaring Schema.Number describes the WIRE type and leaves nothing to convert",
 		match: ({ src: e }) => /\.(getTime|toISOString)\s*\(\s*\)/.test(e) && /\.map\s*\(|=>\s*\(\{/.test(e) && /\bexport\s+default\b/.test(e)
 	}
-], bt = (e) => F(e), xt = (e, t) => {
+], Dt = (e) => R(e), Ot = (e, t) => {
 	let n = /* @__PURE__ */ new Set();
 	for (let r of t) {
 		let t = y(e, r), i = t.split(/[\\/]/)[0];
 		n.add(i !== void 0 && i !== t ? i : ".");
 	}
 	return [...n].sort();
-}, St = /\.(tsx?|jsx?)$/, P = /(^|\/)(node_modules|dist|build|\.framework|\.next|coverage)(\/|$)/, Ct = /(^|[\\/])[^\\/]*\.generated\.[cm]?[jt]sx?$|\.d\.[cm]?ts$/, wt = (e, t = [], n = 0) => {
-	if (n > 12 || P.test(e)) return t;
+}, kt = /\.(tsx?|jsx?)$/, L = /(^|\/)(node_modules|dist|build|\.framework|\.next|coverage)(\/|$)/, At = /(^|[\\/])[^\\/]*\.generated\.[cm]?[jt]sx?$|\.d\.[cm]?ts$/, jt = (e, t = [], n = 0) => {
+	if (n > 12 || L.test(e)) return t;
 	let r;
 	try {
 		r = w(e, { withFileTypes: !0 });
@@ -1072,12 +1149,12 @@ var le = /* @__PURE__ */ new Set([
 		let r = v(e, i.name);
 		if (i.isDirectory()) {
 			if (i.name.startsWith(".")) continue;
-			wt(r, t, n + 1);
+			jt(r, t, n + 1);
 		} else je.test(i.name) && t.push(r);
 	}
 	return t;
-}, F = (e, t = [], n = 0) => {
-	if (n > 12 || P.test(e)) return t;
+}, R = (e, t = [], n = 0) => {
+	if (n > 12 || L.test(e)) return t;
 	let r;
 	try {
 		r = w(e);
@@ -1091,11 +1168,11 @@ var le = /* @__PURE__ */ new Set([
 		} catch {
 			continue;
 		}
-		a.isDirectory() ? F(r, t, n + 1) : St.test(i) && !/\.(test|spec)\./.test(i) && !Ct.test(i) && t.push(r);
+		a.isDirectory() ? R(r, t, n + 1) : kt.test(i) && !/\.(test|spec)\./.test(i) && !At.test(i) && t.push(r);
 	}
 	return t;
-}, I = (e, t = [], n = 0) => {
-	if (n > 12 || P.test(e)) return t;
+}, Mt = (e, t = [], n = 0) => {
+	if (n > 12 || L.test(e)) return t;
 	let r;
 	try {
 		r = w(e);
@@ -1109,17 +1186,17 @@ var le = /* @__PURE__ */ new Set([
 		} catch {
 			continue;
 		}
-		a.isDirectory() ? I(r, t, n + 1) : St.test(i) && /\.(test|spec)\./.test(i) && t.push(r);
+		a.isDirectory() ? Mt(r, t, n + 1) : kt.test(i) && /\.(test|spec)\./.test(i) && t.push(r);
 	}
 	return t;
-}, L = (e) => {
-	let t = bt(e);
+}, Nt = (e) => {
+	let t = Dt(e);
 	return {
-		dirs: xt(e, t),
+		dirs: Ot(e, t),
 		fileCount: t.length
 	};
-}, Tt = (e) => {
-	let t = bt(e);
+}, Pt = (e) => {
+	let t = Dt(e);
 	if (t.length === 0) return [];
 	let n = new D({
 		useInMemoryFileSystem: !0,
@@ -1128,8 +1205,8 @@ var le = /* @__PURE__ */ new Set([
 	for (let e of t) try {
 		i.set(e, C(e, "utf8"));
 	} catch {}
-	let a = ut([...i.keys()], i, e), o = /* @__PURE__ */ new Map();
-	for (let t of I(e)) try {
+	let a = vt([...i.keys()], i, e), o = /* @__PURE__ */ new Map();
+	for (let t of Mt(e)) try {
 		o.set(t, C(t, "utf8"));
 	} catch {}
 	for (let s of t) {
@@ -1149,23 +1226,23 @@ var le = /* @__PURE__ */ new Set([
 		} catch {
 			continue;
 		}
-		for (let t of yt) {
-			if (t.plugin !== void 0 && ft(c, t.plugin) || !t.match(c)) continue;
+		for (let t of Et) {
+			if (t.plugin !== void 0 && yt(c, t.plugin) || !t.match(c)) continue;
 			let n = r.get(t.id) ?? [];
 			n.push(y(e, s)), r.set(t.id, n);
 		}
 	}
-	return yt.filter((e) => r.has(e.id)).map((e) => ({
+	return Et.filter((e) => r.has(e.id)).map((e) => ({
 		rule: e,
 		files: r.get(e.id)
 	})).sort((e, t) => t.files.length - e.files.length || e.rule.id.localeCompare(t.rule.id));
-}, R = (e) => {
-	let t = L(e);
+}, z = (e) => {
+	let t = Nt(e);
 	return {
 		root: e,
 		scannedFiles: t.fileCount,
 		scannedDirs: t.dirs,
-		findings: Tt(e).map(({ rule: e, files: t }) => ({
+		findings: Pt(e).map(({ rule: e, files: t }) => ({
 			id: e.id,
 			scope: e.scope,
 			smell: e.smell,
@@ -1173,13 +1250,13 @@ var le = /* @__PURE__ */ new Set([
 			files: t
 		}))
 	};
-}, Et = 3, Dt = .2, Ot = 50, kt = (e, t) => e >= Ot && t > 0 && e / t >= Dt, At = (e) => {
+}, Ft = 3, It = .2, Lt = 50, Rt = (e, t) => e >= Lt && t > 0 && e / t >= It, zt = (e) => {
 	let t = /* @__PURE__ */ new Map();
-	for (let n of F(e)) try {
+	for (let n of R(e)) try {
 		t.set(y(e, n), C(n, "utf8"));
 	} catch {}
 	let n = /* @__PURE__ */ new Map();
-	for (let t of wt(e)) try {
+	for (let t of jt(e)) try {
 		n.set(y(e, t), C(t, "utf8"));
 	} catch {}
 	let r = Me({
@@ -1187,8 +1264,8 @@ var le = /* @__PURE__ */ new Set([
 		envFiles: n
 	});
 	r !== void 0 && (console.log(""), console.log(Ne(r)));
-}, z = (e) => {
-	let t = R(e);
+}, Bt = (e) => {
+	let t = z(e);
 	if (console.log(""), t.scannedFiles === 0) return console.log(`\u2022  hand-roll scan: no source directories found under ${e}.`), console.log("   Walked the app root recursively (node_modules / dist / .framework pruned). Run `voltro doctor <app>` against an app root."), 0;
 	if (t.findings.length === 0) return console.log(`\u2713  hand-roll scan: ${t.scannedFiles} file${t.scannedFiles === 1 ? "" : "s"} across ${t.scannedDirs.join(", ")} \u2014 no hand-rolled primitives found.`), 0;
 	console.log(`\u2022  Shipped primitives you may be hand-rolling (scanned ${t.scannedFiles} files across ${t.scannedDirs.join(", ")}):`);
@@ -1199,58 +1276,58 @@ var le = /* @__PURE__ */ new Set([
 		console.log(`   [${e}]`);
 		let i = [...r].sort((e, t) => e.files.length - t.files.length);
 		for (let e of i) {
-			if (kt(e.files.length, t.scannedFiles)) {
+			if (Rt(e.files.length, t.scannedFiles)) {
 				let n = Math.round(e.files.length / t.scannedFiles * 100);
 				console.log(`   ${e.smell} \u2014 ${e.files.length} file(s), ${n}% of those scanned: a codebase-wide pattern rather than a work list`), console.log(`     \u2192 ${e.use}`), console.log("     (paths omitted on purpose at this scale — `voltro doctor --json` has every one.)");
 				continue;
 			}
-			let r = e.files.slice(0, Et).join(", "), i = e.files.length - Et;
+			let r = e.files.slice(0, Ft).join(", "), i = e.files.length - Ft;
 			i > 0 && (n += i);
 			let a = i > 0 ? `, +${i} more` : "";
 			console.log(`   ${e.smell} \u2014 ${e.files.length} file(s): ${r}${a}`), console.log(`     \u2192 ${e.use}`);
 		}
 	}
 	return n > 0 && console.log(`   (${n} more file path${n === 1 ? "" : "s"} not shown \u2014 \`voltro doctor --json\` prints every one.)`), console.log("   (See the \"Pick the SERVER primitive\" / \"Pick the CLIENT primitive\" rubrics in AGENTS.md / CLAUDE.md.)"), t.findings.length;
-}, jt = "renderMode:'spa' skips this page's SSR compile while its layout shell still renders server-side — adopt it if the page BODY does not need SSR (internal/authenticated pages); keep 'ssr' if the page content needs SEO or server first-paint.", Mt = /export\s+const\s+renderMode\s*(?::[^=]+)?=\s*['"]([^'"]*)['"]/, Nt = /export\s+const\s+dynamic\s*=\s*['"]force-(dynamic|static)['"]/, Pt = (e) => {
-	let t = Mt.exec(e)?.[1];
+}, Vt = "renderMode:'spa' skips this page's SSR compile while its layout shell still renders server-side — adopt it if the page BODY does not need SSR (internal/authenticated pages); keep 'ssr' if the page content needs SEO or server first-paint.", Ht = /export\s+const\s+renderMode\s*(?::[^=]+)?=\s*['"]([^'"]*)['"]/, Ut = /export\s+const\s+dynamic\s*=\s*['"]force-(dynamic|static)['"]/, Wt = (e) => {
+	let t = Ht.exec(e)?.[1];
 	if (t !== void 0) return t === "ssr" ? "ssr" : null;
-	let n = Nt.exec(e)?.[1];
+	let n = Ut.exec(e)?.[1];
 	return n === "dynamic" ? "ssr" : n === "static" ? null : "default";
 }, B = async (e) => {
 	let t = v(e, "src", "pages");
 	if (!S(t)) return [];
 	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 = Pt(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;
-}, Ft = 10, It = async (e) => {
+}, Gt = 10, Kt = async (e) => {
 	console.log("");
 	let t = v(e, "src", "pages");
 	if (!S(t)) return console.log("•  spa-candidate scan: no src/pages here — nothing to check (web apps only)."), 0;
 	let n = await B(e);
 	if (n.length === 0) return console.log("✓  spa-candidate scan: no loader-free, layout-backed pages to flag."), 0;
 	console.log(`•  renderMode:'spa' candidates (${n.length} page${n.length === 1 ? "" : "s"} — loader-free, under a layout, currently ssr/default):`);
-	for (let e of n.slice(0, Ft)) {
+	for (let e of n.slice(0, Gt)) {
 		let t = e.currentMode === "ssr" ? "renderMode:'ssr'" : "default renderMode";
 		console.log(`   ${e.file}  (${e.pattern}) — ${t}`);
 	}
-	let r = n.length - Ft;
-	return r > 0 && console.log(`   (+${r} more page${r === 1 ? "" : "s"} not shown — \`voltro doctor --json\` prints every one.)`), console.log(`     → ${jt}`), n.length;
-}, Lt = /* @__PURE__ */ new Set([
+	let r = n.length - Gt;
+	return r > 0 && console.log(`   (+${r} more page${r === 1 ? "" : "s"} not shown — \`voltro doctor --json\` prints every one.)`), console.log(`     → ${Vt}`), n.length;
+}, qt = /* @__PURE__ */ new Set([
 	"node_modules",
 	"dist",
 	"build",
@@ -1258,7 +1335,7 @@ var le = /* @__PURE__ */ new Set([
 	".vite",
 	".framework",
 	".git"
-]), Rt = (e, t, n) => {
+]), Jt = (e, t, n) => {
 	let r;
 	try {
 		r = w(e, { withFileTypes: !0 });
@@ -1266,11 +1343,11 @@ var le = /* @__PURE__ */ new Set([
 		return;
 	}
 	for (let i of r) {
-		if (Lt.has(i.name)) continue;
+		if (qt.has(i.name)) continue;
 		let r = v(e, i.name);
-		i.isDirectory() ? Rt(r, t, n) : i.isFile() && i.name.endsWith(".tsx") && n.push(y(t, r));
+		i.isDirectory() ? Jt(r, t, n) : i.isFile() && i.name.endsWith(".tsx") && n.push(y(t, r));
 	}
-}, zt = (e, t) => {
+}, Yt = (e, t) => {
 	let n = /* @__PURE__ */ new Set(), r = /(?:from|import)\s*\(?\s*['"](\.[^'"]*)['"]/g;
 	for (let i of t) {
 		let t;
@@ -1295,16 +1372,16 @@ var le = /* @__PURE__ */ new Set([
 		}
 	}
 	return n;
-}, Bt = (e, t) => {
+}, Xt = (e, t) => {
 	let n = e.slice(t.length).split(x).slice(0, -1)[0];
 	return n !== void 0 && n.startsWith("[");
 }, V = (e) => {
 	let t = [], n = v(e, "src", "pages"), r = v(e, "src");
 	if (!S(r)) return t;
 	let i = [];
-	Rt(r, e, i), i.sort();
+	Jt(r, e, i), i.sort();
 	let a = `${y(e, n)}${x}`;
-	zt(e, i);
+	Yt(e, i);
 	for (let n of i) {
 		let r = n.slice(n.lastIndexOf(x) + 1);
 		if (n.startsWith(a)) {
@@ -1320,7 +1397,7 @@ var le = /* @__PURE__ */ new Set([
 					file: n
 				});
 			} catch {}
-			Bt(n, a) && t.push({
+			Xt(n, a) && t.push({
 				kind: "top-level-dynamic-route",
 				file: n
 			});
@@ -1332,13 +1409,13 @@ var le = /* @__PURE__ */ new Set([
 		});
 	}
 	return t;
-}, Vt = 10, H = (e, t, n) => {
+}, Zt = 10, H = (e, t, n) => {
 	if (t.length === 0) return;
 	console.log(`•  ${e} (${t.length}):`);
-	for (let e of t.slice(0, Vt)) console.log(`   ${e}`);
-	let r = t.length - Vt;
+	for (let e of t.slice(0, Zt)) console.log(`   ${e}`);
+	let r = t.length - Zt;
 	r > 0 && console.log(`   (+${r} more not shown — \`voltro doctor --json\` prints every one.)`), console.log(`     → ${n}`);
-}, Ht = (e) => {
+}, Qt = (e) => {
 	console.log("");
 	let t = v(e, "src", "pages");
 	if (!S(t)) return console.log("•  page-convention scan: no src/pages here — nothing to check (web apps only)."), 0;
@@ -1346,18 +1423,18 @@ var le = /* @__PURE__ */ new Set([
 	if (n.length === 0) return console.log("✓  page-convention scan: every route is a page.tsx in its own directory, with a test beside it."), 0;
 	let r = (e) => n.filter((t) => t.kind === e).map((e) => e.file);
 	return H("will NEVER route — page.tsx outside src/pages/", r("suffixed-outside-pages"), "the name says \"route\", the location says otherwise, and the location wins: the URL comes from the directory chain under src/pages/. Move it into the directory whose route it serves, or rename it."), H("pages with no test beside them", r("page-without-test"), "a page and its test belong together — `users/[id].page.tsx` → `users/[id].page.test.tsx`. Advisory only; a missing test is a gap, not a defect."), H("routes whose FIRST segment is dynamic — they claim every URL of that depth", r("top-level-dynamic-route"), "a route like `[id]/[code]` answers `/api/health`, `/internal/readiness` and anything else with that many segments on this origin. That is what the pattern means, so it is not a bug — but it is invisible until something requests such a URL, and then the page renders, its loader runs, and the failure reads as an application error rather than as a route claiming a path nobody meant it to. Give the route a literal first segment (`scan/[id]/[code]`) if you did not intend to own the whole origin at that depth. Advisory."), H("pages with no `meta` export — they serve the APP name as their title", r("page-without-meta"), "a page with no `meta` sets no title, so the response carries `<title>{your app.config name}</title>` — the same string on every such page, to every reader that does not run JavaScript: link previews, crawlers, a bookmark taken before hydration, a screen reader announcing the document. The client router fixes the tab after hydration, which is exactly why this is easy to miss. Add `export const meta = { title: \"…\" }` (or a function of params/loaderData). If such a page also has no real body — it redirects from an effect, say — the missing title is the symptom rather than the bug: on an `ssr` route the server answers 200 with an empty document and the redirect happens only once JavaScript runs. Move it into the loader (`redirect(...)`, a real 303). Advisory."), n.length;
-}, Ut = "voltro doctor [app] [flags]\n\nPreflight an app root: verify it can boot under production `voltro serve`,\nreport shipped primitives the source looks to be hand-rolling, and flag pages\nthat are safe `renderMode:'spa'` candidates.\n\nArguments:\n  [app]        App directory to check (default: the current directory).\n\nFlags:\n  --strict     Treat a missing serve bundle as blocking regardless of NODE_ENV\n               (the `voltro serve --preflight` behavior). Without it, a missing\n               bundle only fails when NODE_ENV=production.\n  --json       Print the complete scan as JSON — hand-roll findings AND spa\n               candidates, every file path, nothing elided. Skips the preflight output.\n  --write-authz-allowlist\n               Record today's executors that reference NO access check into\n               voltro-authz-allowlist.txt, so every later run fails only on\n               ADDITIONS. The list is DEBT, not approval — an entry stops\n               mattering as soon as its executor gains a guard.\n  -h, --help   Print this help.", Wt = /* @__PURE__ */ new Map(), U = (e) => {
-	let t = Wt.get(e);
+}, $t = "voltro doctor [app] [flags]\n\nPreflight an app root: verify it can boot under production `voltro serve`,\nreport shipped primitives the source looks to be hand-rolling, and flag pages\nthat are safe `renderMode:'spa'` candidates.\n\nArguments:\n  [app]        App directory to check (default: the current directory).\n\nFlags:\n  --strict     Treat a missing serve bundle as blocking regardless of NODE_ENV\n               (the `voltro serve --preflight` behavior). Without it, a missing\n               bundle only fails when NODE_ENV=production.\n  --json       Print the complete scan as JSON — hand-roll findings AND spa\n               candidates, every file path, nothing elided. Skips the preflight output.\n  --write-authz-allowlist\n               Record today's executors that reference NO access check into\n               voltro-authz-allowlist.txt, so every later run fails only on\n               ADDITIONS. The list is DEBT, not approval — an entry stops\n               mattering as soon as its executor gains a guard.\n  -h, --help   Print this help.", en = /* @__PURE__ */ new Map(), U = (e) => {
+	let t = en.get(e);
 	if (t !== void 0) return t;
 	let n = (async () => {
-		let { walk: t, loadDiscovered: n } = await import("./dev-CK522MV5.js"), r = await t(e);
+		let { walk: t, loadDiscovered: n } = await import("./dev-GjJWAYo2.js"), r = await t(e);
 		return {
 			files: r,
 			discovered: await n(r)
 		};
 	})();
-	return Wt.set(e, n), n;
-}, Gt = async (e) => {
+	return en.set(e, n), n;
+}, tn = async (e) => {
 	let t;
 	try {
 		let { files: n, discovered: r } = await U(e), i = r.tables.map((e) => {
@@ -1373,7 +1450,7 @@ var le = /* @__PURE__ */ new Set([
 		return;
 	}
 	t !== null && (console.log(""), console.log(`${t.includes("does not exist") ? "✗" : "✓"}  ${t}`));
-}, Kt = (e) => e.map((e) => {
+}, nn = (e) => e.map((e) => {
 	let t = e, n = Object.entries(t.fields ?? {}).map(([e, t]) => ({
 		name: e,
 		type: typeof t?.type == "string" ? t.type : ""
@@ -1383,13 +1460,13 @@ var le = /* @__PURE__ */ new Set([
 		columns: n,
 		primaryKey: t.appliedPrimaryKey ?? []
 	};
-}), qt = async (e) => {
+}), rn = async (e) => {
 	try {
 		let { missingRelationSources: t } = await import("./doctorSourceRelations-c5mlN5HI.js"), { sourceKeys: n } = await import("@voltro/protocol"), { readFile: r } = await import("node:fs/promises"), { discovered: i } = await U(e), a = [], o = [];
 		for (let e of i.queries) {
 			let i = n(e.descriptor.source);
 			if (i.length === 0) continue;
-			let s = Jt(e.file);
+			let s = an(e.file);
 			if (s === void 0) continue;
 			let c = await r(s, "utf8").catch(() => null);
 			if (c === null) continue;
@@ -1406,8 +1483,8 @@ var le = /* @__PURE__ */ new Set([
 	} catch {
 		return null;
 	}
-}, Jt = (e) => e.endsWith(".ts") && !e.endsWith(".server.ts") ? `${e.slice(0, -3)}.server.ts` : void 0, Yt = async (e) => {
-	let t = await qt(e);
+}, an = (e) => e.endsWith(".ts") && !e.endsWith(".server.ts") ? `${e.slice(0, -3)}.server.ts` : void 0, on = async (e) => {
+	let t = await rn(e);
 	if (t === null) return;
 	let n = t.findings;
 	if (n.length > 0) {
@@ -1423,11 +1500,11 @@ var le = /* @__PURE__ */ new Set([
 }, W = async (e) => {
 	try {
 		let { discovered: t } = await U(e);
-		return ve(Kt(t.tables));
+		return ve(nn(t.tables));
 	} catch {
 		return null;
 	}
-}, Xt = async (e) => {
+}, sn = async (e) => {
 	let t = await W(e);
 	if (t === null || t.tablesChecked === 0) return;
 	let n = be(t);
@@ -1447,7 +1524,7 @@ var le = /* @__PURE__ */ new Set([
 	} catch {
 		return null;
 	}
-}, Zt = async (e) => {
+}, cn = async (e) => {
 	let t = await G(e);
 	if (t === null || t.eventsChecked === 0) return;
 	let n = Te(t);
@@ -1475,7 +1552,7 @@ var le = /* @__PURE__ */ new Set([
 	}
 }, J = async (r) => {
 	try {
-		let { loadApiConfig: i } = await import("./dev-CK522MV5.js"), { discovered: a } = await U(r), o = e(await i(r)), s = {
+		let { loadApiConfig: i } = await import("./dev-GjJWAYo2.js"), { discovered: a } = await U(r), o = t(await i(r)), s = {
 			queries: a.queries,
 			mutations: a.mutations,
 			actions: a.actions,
@@ -1485,8 +1562,8 @@ var le = /* @__PURE__ */ new Set([
 		return {
 			checked: !0,
 			defaultDeny: o,
-			undecided: t(s),
-			openAccess: n(s)
+			undecided: n(s),
+			openAccess: e(s)
 		};
 	} catch (e) {
 		return {
@@ -1497,7 +1574,7 @@ var le = /* @__PURE__ */ new Set([
 			openAccess: []
 		};
 	}
-}, Qt = async (e) => {
+}, ln = async (e) => {
 	let t = await J(e);
 	if (!t.checked) return console.log(""), console.log("•  access decisions: NOT CHECKED — the app's descriptors could not be loaded (not a pass)"), console.log(`   reason: ${t.reason ?? "unknown"}`), !1;
 	console.log(""), console.log(`access decisions · security.defaultDeny ${t.defaultDeny ? "ON" : "OFF"}`), console.log(`  ✗ no access decision                    ${String(t.undecided.length).padStart(4)}`), console.log(`  ✓ openAccess, declared on purpose       ${String(t.openAccess.length).padStart(4)}`);
@@ -1505,8 +1582,8 @@ var le = /* @__PURE__ */ new Set([
 	if (t.undecided.length === 0) return !1;
 	console.log("");
 	for (let e of t.undecided) console.log(`  ✗ ${e.tag}  (${e.kind})${e.file === void 0 ? "" : `\n      ${e.file}`}`);
-	return console.log(""), t.defaultDeny ? (console.log("  `voltro dev` and `voltro serve` REFUSE to boot on these. Give each a decision:"), $t(), !0) : (console.log("  This app sets `security: { defaultDeny: false }`, so these BOOT — and each one is"), console.log("  callable by any authenticated session. Advisory here for that reason only."), $t(), !1);
-}, $t = () => {
+	return console.log(""), t.defaultDeny ? (console.log("  `voltro dev` and `voltro serve` REFUSE to boot on these. Give each a decision:"), un(), !0) : (console.log("  This app sets `security: { defaultDeny: false }`, so these BOOT — and each one is"), console.log("  callable by any authenticated session. Advisory here for that reason only."), un(), !1);
+}, un = () => {
 	console.log("    `guards: [{ scope: '…' }]`                       authority the SUBJECT holds globally"), console.log("    `guards: [{ action, resourceType, resource }]`   authority per ROW / per resource"), console.log("        — backed by `defineResourcePolicy` + a tuple source you register. If your"), console.log("          relationships already live in your own tables (a `teamMembers` row), register"), console.log("          a tuple source over them; nothing is copied. Fail-closed without a resolver."), console.log("          Docs: Authentication → Authorization."), console.log("    `openAccess: '<why anyone may call it>'`         deliberately unauthenticated");
 }, Y = async (e) => {
 	try {
@@ -1543,7 +1620,7 @@ var le = /* @__PURE__ */ new Set([
 			verified: 0
 		};
 	}
-}, en = async (e) => {
+}, dn = async (e) => {
 	let t = await Y(e);
 	if (!t.checked) return console.log(""), console.log("•  webhook verification: NOT CHECKED — the app's webhooks could not be loaded (not a pass)"), console.log(`   reason: ${t.reason ?? "unknown"}`), !1;
 	if (t.verified + t.open.length + t.unverified.length === 0) return !1;
@@ -1553,13 +1630,13 @@ var le = /* @__PURE__ */ new Set([
 	console.log("");
 	for (let e of t.unverified) console.log(`  ✗ ${e.id}\n      ${e.file}`);
 	return console.log(""), console.log("  These are public POSTs that run your application code, and `voltro dev` /"), console.log("  `voltro serve` REFUSE to mount them. Declare one of: `provider:` (a preset),"), console.log("  `signature:` (your own HMAC scheme), `verification: 'provider'` (your handler"), console.log("  verifies), or `verification: 'none'` (deliberately public)."), !0;
-}, tn = async (e) => {
+}, fn = async (e) => {
 	let { status: t, message: n } = await q(e);
 	return t.checked ? n !== void 0 && (console.log(""), console.log(`✗  [serverOnly] ${n}`), !0) : (console.log(""), console.log("•  serverOnly: NOT CHECKED — the app's descriptors could not be loaded (not a pass)"), console.log(`   reason: ${t.reason ?? "unknown"}`), console.log("   This audit is the automated check that a hash or a token cannot reach the wire, so"), console.log("   an app that leans on `.serverOnly()` should treat a persistent skip as a failure."), console.log("   `voltro doctor --json` reports it as `serverOnly.checked: false` for a CI gate."), !1);
-}, nn = async (e) => nt({
+}, pn = async (e) => ut({
 	hasWorkflows: async () => (await U(e)).discovered.workflows.length > 0,
 	openStore: async () => {
-		let { loadApiConfig: t, buildStore: n } = await import("./dev-CK522MV5.js"), r = await t(e);
+		let { loadApiConfig: t, buildStore: n } = await import("./dev-GjJWAYo2.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 {
@@ -1573,10 +1650,10 @@ var le = /* @__PURE__ */ new Set([
 		let { sweepStalledRuns: t } = await import("@voltro/workflow");
 		return t({ store: e });
 	}
-}), rn = async (e) => {
-	let t = it(await nn(e));
+}), mn = async (e) => {
+	let t = ft(await pn(e));
 	t !== null && (console.log(""), console.log(t));
-}, an = async (e) => {
+}, hn = async (e) => {
 	let t;
 	try {
 		let { payloadPropertyNames: n } = await import("@voltro/runtime"), { files: r, discovered: i } = await U(e);
@@ -1599,13 +1676,13 @@ var le = /* @__PURE__ */ new Set([
 	console.log("");
 	let r = t.issues.length > 0 ? "✗" : t.unchecked.length > 0 ? "•" : "✓";
 	console.log(`${r}  ${n}`);
-}, X = "voltro-authz-allowlist.txt", on = (e, t = (e) => {
+}, X = "voltro-authz-allowlist.txt", gn = (e, t = (e) => {
 	try {
 		return C(e, "utf8");
 	} catch {
 		return "";
 	}
-}) => /* @__PURE__ */ new Set([...Be, ...Ve(F(e).map(t))]), sn = (e, t) => {
+}) => /* @__PURE__ */ new Set([...Je, ...Ye(R(e).map(t))]), _n = (e, t) => {
 	let n = t.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 	return new RegExp(String.raw`(?:export\s+)?const\s+([A-Za-z_$][\w$]*)\s*=\s*define[A-Za-z]*Event\s*\(\s*\{[^}]*?name\s*:\s*['"\`]${n}['"\`]`, "s").exec(e)?.[1];
 }, Z = async (e) => {
@@ -1621,25 +1698,25 @@ var le = /* @__PURE__ */ new Set([
 			} catch {
 				return "";
 			}
-		}, a = F(e).filter((e) => !r.has(e)).map(i).join("\n");
+		}, a = R(e).filter((e) => !r.has(e)).map(i).join("\n");
 		return n.filter(({ name: e, file: t }) => {
 			if (a.includes(e)) return !1;
-			let n = sn(i(t), e);
+			let n = _n(i(t), e);
 			return n === void 0 || !new RegExp(String.raw`\b${n}\b`).test(a);
 		}).map((e) => e.name).sort();
 	} catch {
 		return [];
 	}
-}, cn = async (e) => {
+}, vn = async (e) => {
 	let t = await Z(e);
 	if (t.length !== 0) {
 		console.log(""), console.log(`•  ${t.length} declared event(s) with no emit call site found:`);
 		for (let e of t) console.log(`     ${e}`);
 		console.log(""), console.log("   An event you declare is an event partners can subscribe to. One that"), console.log("   never fires is indistinguishable, from their side, from a broken"), console.log("   endpoint of their own — so they debug your contract instead of"), console.log("   reading it."), console.log("   ADVISORY: this looks for the event name AND the identifier its"), console.log("   declaration binds it to, so `emit(ctx, apiKeyCreated, …)` counts. An"), console.log("   emit through an ASSEMBLED name still reads as missing here.");
 	}
-}, ln = async (e) => {
+}, yn = async (e) => {
 	try {
-		let { loadApiConfig: t } = await import("./dev-CK522MV5.js"), n = (await t(e))?.doctor?.scopeVocabulary;
+		let { loadApiConfig: t } = await import("./dev-GjJWAYo2.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 [];
@@ -1656,10 +1733,10 @@ var le = /* @__PURE__ */ new Set([
 		findings: []
 	});
 	try {
-		let { offlineManifest: n, toInput: r } = await import("./checkCommand-CWcnDArJ.js"), { buildAppGraph: i, checkAppGraph: a } = await import("./appGraph-CFmFKHb2.js"), o = await n(e), s = r(o.manifest, o.tables), c = await ln(e), l = [.../* @__PURE__ */ new Set([...s.scopes ?? [], ...c])];
+		let { offlineManifest: n, toInput: r } = await import("./checkCommand-D2ZduVlh.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-CVDB2hCq.js");
+				let { loadAppSchemaInputs: t } = await import("./frameworkTableAssembly-C_7Z-rMs.js");
 				await t(e);
 			} catch {
 				return t("app-not-importable");
@@ -1683,7 +1760,7 @@ var le = /* @__PURE__ */ new Set([
 	} catch {
 		return t("app-not-importable");
 	}
-}, un = async (e) => {
+}, bn = async (e) => {
 	let { findings: t, evaluated: n, notEvaluated: r } = await Q(e);
 	if (!n) {
 		if (console.log(""), r === "app-not-importable") {
@@ -1698,7 +1775,7 @@ var le = /* @__PURE__ */ new Set([
 		for (let e of t) console.log(`     ${e.node}${e.file === void 0 ? "" : `  ${e.file}`}`), console.log(`       ${e.detail}`);
 		console.log(""), console.log("   Each of these is uncallable by every user in every role — not"), console.log("   misconfigured, DEAD — and nothing fails at boot to say so. The"), console.log("   usual cause is a typo or a rename that moved one side only."), console.log(`   ${t[0].fix}`);
 	}
-}, dn = async (e) => {
+}, xn = async (e) => {
 	let t = ["src/locales", "locales"], n, r = [];
 	for (let i of t) {
 		let t = v(e, i);
@@ -1710,38 +1787,69 @@ var le = /* @__PURE__ */ new Set([
 	if (n === void 0 || r.length === 0) return;
 	let i = [];
 	try {
-		let { loadApiConfig: t } = await import("./dev-CK522MV5.js");
+		let { loadApiConfig: t } = await import("./dev-GjJWAYo2.js");
 		i = (await t(e))?.locales ?? [];
 	} catch {
 		return;
 	}
-	let a = Pe({
+	let a = He({
 		catalogCodes: r,
 		declaredLocales: i
 	});
 	if (a !== void 0) {
 		console.log("");
-		for (let e of Fe(a, n)) console.log(e);
+		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;
 	}
-}, fn = async (e) => {
+	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-C7jWJ5dX.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-DposiF3j.js");
+		let { walkPagesTree: e } = await import("./webDev-C7jWJ5dX.js");
 		n = (await e(t)).pages.map((e) => e.pattern);
 	} catch {
 		return !1;
 	}
-	let r = Le(e, n);
+	let r = Ge(e, n);
 	if (r === void 0) return !1;
 	console.log("");
-	for (let e of Re(r)) console.log(e);
+	for (let e of Ke(r)) console.log(e);
 	return r.problems.length > 0;
-}, pn = async (e) => {
+}, Tn = async (e) => {
 	let { discovered: t } = await U(e), n = [];
 	try {
-		let { loadApiConfig: t } = await import("./dev-CK522MV5.js");
+		let { loadApiConfig: t } = await import("./dev-GjJWAYo2.js");
 		n = ((await t(e))?.plugins ?? []).map((e) => {
 			let t = (e.extendSchema?.tables ?? []).map((e) => {
 				let t = e;
@@ -1754,8 +1862,8 @@ var le = /* @__PURE__ */ new Set([
 				plugin: e.name,
 				tables: t,
 				rpcTags: n,
-				canDisableTables: mn.has(r),
-				canAlias: hn.has(r)
+				canDisableTables: En.has(r),
+				canAlias: Dn.has(r)
 			};
 		});
 	} catch {
@@ -1767,22 +1875,23 @@ var le = /* @__PURE__ */ new Set([
 		...t.mutations,
 		...t.actions,
 		...t.streams ?? []
-	].map((e) => String(e.descriptor.name)), i = et(n, {
+	].map((e) => String(e.descriptor.name)), i = ct(n, {
 		tables: t.tables.map((e) => e.tableName),
 		rpcTags: r
 	});
 	console.log();
-	for (let e of tt(n, i)) console.log(e);
-}, mn = /* @__PURE__ */ new Set([
+	for (let e of lt(n, i)) console.log(e);
+}, En = /* @__PURE__ */ new Set([
 	"@voltro/plugin-rbac",
 	"@voltro/plugin-audit",
 	"@voltro/plugin-notifications",
 	"aiFlows"
-]), hn = /* @__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",
@@ -1794,9 +1903,9 @@ var le = /* @__PURE__ */ new Set([
 	"@voltro/plugin-search",
 	"@voltro/plugin-sso-saml",
 	"@voltro/plugin-storage",
-	"@voltro/plugin-versioning"
-]), $ = 20, gn = async (e) => {
-	let t = await _n(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;
+	"@voltro/plugin-row-history"
+]), $ = 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(),
@@ -1808,7 +1917,7 @@ var le = /* @__PURE__ */ new Set([
 		},
 		unchecked: t.result.unchecked
 	};
-}, _n = 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"));
@@ -1816,7 +1925,7 @@ var le = /* @__PURE__ */ new Set([
 			n.set(e, "");
 		}
 		return n.get(e);
-	}, i = on(e, r), a = /* @__PURE__ */ new Set();
+	}, i = gn(e, r), a = /* @__PURE__ */ new Set();
 	for (let e of t.tables) for (let t of Object.values(e.fields ?? {})) try {
 		let e = t.references?.();
 		e && a.add(e.tableName);
@@ -1848,12 +1957,12 @@ var le = /* @__PURE__ */ new Set([
 			op: a?.op === "delete" || a?.op === "insert" ? a.op : t,
 			...a?.table === void 0 ? {} : { table: a.table }
 		};
-	})), s = v(e, X), c = S(s) ? j(C(s, "utf8")) : void 0, l = !1;
-	for (let t of F(e)) if (/\bsetRowFilter\s*[<(]/.test(r(t))) {
+	})), s = v(e, X), c = S(s) ? N(C(s, "utf8")) : void 0, l = !1;
+	for (let t of R(e)) if (/\bsetRowFilter\s*[<(]/.test(r(t))) {
 		l = !0;
 		break;
 	}
-	let u = qe({
+	let u = tt({
 		executors: o,
 		guardVocabulary: i,
 		tenantScopedTables: t.tenantScopedTables,
@@ -1870,23 +1979,23 @@ var le = /* @__PURE__ */ new Set([
 		executorCount: o.length,
 		allowPath: s
 	};
-}, vn = async (e, t) => {
-	let { result: n, vocabulary: r, existing: i, reviewed: a, executorCount: o, allowPath: s, rowFilterRegistered: c } = await _n(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) => !Be.has(e)).sort();
+	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)}`);
 	let d = new Set(a.map((e) => e.tag)), f = n.findings.filter((e) => e.verdict.kind === "allowlisted" && !d.has(e.tag)).length, p = l.allowlisted - f;
 	if (console.log(`  – accepted as recorded debt             ${String(f).padStart(4)}   (${X})`), console.log(`  ✓ reviewed, open on purpose             ${String(p).padStart(4)}   (\`reviewed=<why>\` in that file)`), c && console.log("  ⓘ this app registers setRowFilter — the scan CANNOT see through it. A finding below may\n    already be constrained; verify the filter covers that table and record it as `reviewed=`."), t) {
-		let e = S(s) ? C(s, "utf8") : void 0, t = n.unchecked.map((e) => e.tag), r = Ze(e, t);
-		return oe(s, Xe(e, t), "utf8"), console.log(`\n${X}: +${r.added} new, ${r.kept} kept, ${r.removed} removed. Doctor now fails on ADDITIONS only.`), r.added === 0 && console.log("  (nothing new was unchecked — the file is unchanged.)"), !1;
+		let e = S(s) ? C(s, "utf8") : void 0, t = n.unchecked.map((e) => e.tag), r = at(e, t);
+		return oe(s, it(e, t), "utf8"), console.log(`\n${X}: +${r.added} new, ${r.kept} kept, ${r.removed} removed. Doctor now fails on ADDITIONS only.`), r.added === 0 && console.log("  (nothing new was unchecked — the file is unchanged.)"), !1;
 	}
 	if (n.unchecked.length === 0) return !1;
 	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);
-}, yn = async (e) => {
+}, jn = async (e) => {
 	try {
-		let { loadApiConfig: t } = await import("./dev-CK522MV5.js"), { decidedSchemaReport: n } = await import("./doctorDecidedSchema-BlbWgCD_.js"), r = await t(e);
+		let { loadApiConfig: t } = await import("./dev-GjJWAYo2.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 },
@@ -1895,39 +2004,42 @@ var le = /* @__PURE__ */ new Set([
 	} catch {
 		return null;
 	}
-}, bn = async (e) => {
-	let t = await yn(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}`);
 	}
-}, xn = async (e) => {
-	if (e.includes("--help") || e.includes("-h")) return console.log(Ut), 0;
+}, 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("-")), o = b(n ?? process.cwd());
 	if (g(e)) return ee(), h({
-		...R(o),
+		...z(o),
 		spaCandidates: await B(o),
 		pageConvention: V(o),
 		fileTaxonomy: re(o).findings,
 		junctionFks: (await W(o))?.issues ?? [],
 		eventDelivery: await G(o),
-		duplicateInstances: r(o),
-		versionSkew: a(o) ?? null,
+		duplicateInstances: a(o),
+		versionSkew: s(o) ?? null,
 		serverOnly: (await q(o)).status,
 		accessDecisions: await J(o),
 		webhookVerification: await Y(o),
-		authz: await gn(o),
+		authz: await On(o),
 		ungrantedScopes: await Q(o),
 		neverEmittedEvents: await Z(o),
-		stalledRuns: await nn(o),
-		decidedSchema: await yn(o)
+		unimportedDeps: Be(o),
+		stalledRuns: await pn(o),
+		decidedSchema: await jn(o)
 	}), 0;
-	let c = ct(o, t);
-	z(o), At(o), Ht(o), ne(o), await It(o), await an(o), await rn(o), await Gt(o), await Xt(o), await Yt(o), await bn(o), await Zt(o), await pn(o), await un(o), await cn(o), await dn(o);
-	let l = await tn(o), u = await vn(o, e.includes("--write-authz-allowlist")), d = await Qt(o), f = await en(o), p = await fn(o), m = i(a(o));
+	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 = i(s(o));
 	m !== void 0 && (console.log(""), console.log(m));
-	let _ = s(r(o));
+	let _ = r(a(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, Ht as _, gn as a, ct as b, G as c, L as d, ot as f, z as g, At as h, J as i, on as l, qt as m, st as n, Z as o, W as p, jt as r, sn as s, Ut as t, R as u, It as v, q as w, Tt as x, xn 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 };