@voltro/cli 0.55.0 → 0.57.0

package/dist/{doctorCommand-CGZJK_4o.js → doctorCommand-BrWu67JZ.js}

@@ -1,8 +1,8 @@
-import { Ht as e, Ut as t, Wt as n } from "./dev-Ca_A_S9v.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-B7vNj4Bq.js";
-import { x as d } from "./frameworkTableAssembly-Do-cf6RJ.js";
-import { n as f } from "./pageConvention-CMpfDN6r.js";
-import { r as p, u as m } from "./apiBuild-CMvLJM_K.js";
+import { Jt as e, Xt as t, Yt as n } from "./dev-DOEJXicj.js";
+import { Bt as r, Lt as i, R as a, Rt as o, S as s, t as c, u as l, zt as u } from "./webDev-BgdkyjP6.js";
+import { r as d, u as f } from "./apiBuild-DDr2aNFd.js";
+import { S as p } from "./frameworkTableAssembly-vfkzuzEo.js";
+import { n as m } from "./pageConvention-CMpfDN6r.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-CbyMQYx_.js";
@@ -367,15 +367,15 @@ 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"), j = {
+].join("\n"), Pe = {
 	"@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;
+}, Fe = /* @__PURE__ */ new Set(["@voltro/client", "@voltro/web"]), Ie = /(^|\/)(node_modules|dist|build|\.framework|\.next|\.turbo|\.git|coverage|\.publish)(\/|$)/, Le = /\.([cm]?[jt]sx?)$/, Re = /\.generated\.[cm]?[jt]sx?$/, ze = (e, t = [], n = 0) => {
+	if (n > 12 || Ie.test(e)) return t;
 	let r;
 	try {
 		r = w(e);
@@ -389,10 +389,10 @@ var le = /* @__PURE__ */ new Set([
 		} catch {
 			continue;
 		}
-		a.isDirectory() ? Le(r, t, n + 1) : Fe.test(i) && t.push(r);
+		a.isDirectory() ? ze(r, t, n + 1) : Le.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) => {
+}, Be = /(?:\bfrom\s*|\bimport\s+|\bimport\s*\(\s*|\brequire\s*\(\s*)['"](@voltro\/[a-z0-9-]+)(?:\/[^'"]*)?['"]/g, Ve = (e) => e.split("\n").filter((e) => !/^\s*(\/\/|\*|\/\*)/.test(e)).join("\n"), He = (e) => {
 	let t;
 	try {
 		t = JSON.parse(C(v(e, "package.json"), "utf8"));
@@ -402,7 +402,7 @@ var le = /* @__PURE__ */ new Set([
 	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();
+	})), r = /* @__PURE__ */ new Set(), i = [...n("dependencies"), ...n("devDependencies")].filter((e) => !r.has(e.pkg) && (r.add(e.pkg), !0)), a = ze(e), o = a.some((e) => Re.test(e)), s = /* @__PURE__ */ new Set();
 	for (let e of a) {
 		let t;
 		try {
@@ -410,17 +410,17 @@ var le = /* @__PURE__ */ new Set([
 		} catch {
 			continue;
 		}
-		for (let e of ze(t).matchAll(Re)) s.add(e[1]);
+		for (let e of Ve(t).matchAll(Be)) s.add(e[1]);
 	}
-	let c = i.filter((e) => !(e.pkg in j) && !s.has(e.pkg));
+	let c = i.filter((e) => !(e.pkg in Pe) && !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(),
+		unimported: c.filter((e) => o || !Fe.has(e.pkg)).sort((e, t) => e.pkg.localeCompare(t.pkg)),
+		pendingCodegen: o ? [] : c.map((e) => e.pkg).filter((e) => Fe.has(e)).sort(),
+		exempt: i.map((e) => e.pkg).filter((e) => e in Pe).sort(),
 		scannedFiles: a.length
 	};
-}, Ve = (e) => {
+}, Ue = (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"];
@@ -437,14 +437,14 @@ var le = /* @__PURE__ */ new Set([
 	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) => {
+}, We = (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
 	};
-}, Ue = (e, t) => {
+}, Ge = (e, t) => {
 	let n = e.orphaned.join(", ");
 	return e.noneDeclared ? [
 		`⚠  ${t} has ${e.orphaned.length} catalog(s) — ${n} — and the app declares no \`locales:\`.`,
@@ -456,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)."];
-}, We = (e) => {
+}, Ke = (e) => {
 	let t = e.getProperty("match");
 	if (t === void 0) return null;
 	let n = (t.asKind(O.PropertyAssignment)?.getInitializer())?.asKind(O.ObjectLiteralExpression);
@@ -493,7 +493,7 @@ var le = /* @__PURE__ */ new Set([
 		else return;
 	}
 	return r;
-}, Ge = (e, t) => {
+}, qe = (e, t) => {
 	let n = ["middleware.ts", "middleware.tsx"].find((t) => S(v(e, t)));
 	if (n === void 0) return;
 	let r = new D({
@@ -510,7 +510,7 @@ var le = /* @__PURE__ */ new Set([
 			file: n
 		};
 	}
-	let a = [], s = [], c = 0;
+	let o = [], s = [], c = 0;
 	for (let e of i.getVariableDeclarations()) {
 		let t = e.getInitializerIfKind(O.CallExpression);
 		if (t?.getExpression().getText() !== "defineMiddleware") continue;
@@ -520,12 +520,12 @@ var le = /* @__PURE__ */ new Set([
 			s.push(n);
 			continue;
 		}
-		let i = We(r);
+		let i = Ke(r);
 		if (i === void 0) {
 			s.push(n);
 			continue;
 		}
-		a.push({
+		o.push({
 			exportName: n,
 			middleware: {
 				_tag: "VoltroMiddleware",
@@ -535,45 +535,45 @@ var le = /* @__PURE__ */ new Set([
 		});
 	}
 	return {
-		problems: o(a, t).map((e) => e.message),
+		problems: a(o, t).map((e) => e.message),
 		unreadable: s,
 		seen: c,
 		file: n
 	};
-}, Ke = (e) => {
+}, Je = (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;
-}, qe = (e) => e.replace(/\/\*[\s\S]*?\*\//g, "").replace(/(^|[^:])\/\/[^\n]*/g, "$1"), Je = /* @__PURE__ */ new Set([
+}, Ye = (e) => e.replace(/\/\*[\s\S]*?\*\//g, "").replace(/(^|[^:])\/\/[^\n]*/g, "$1"), Xe = /* @__PURE__ */ new Set([
 	"requireScope",
 	"requireAnyScope",
 	"requireAuth",
 	"assertScope",
 	"assertCan",
 	"can"
-]), Ye = (e) => {
+]), Ze = (e) => {
 	let t = /* @__PURE__ */ new Set();
-	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]);
+	for (let n of e) for (let e of Ye(n).matchAll(/\bexport\s+(?:const|function|async\s+function)\s+((?:require|assert)[A-Z]\w*)/g)) t.add(e[1]);
 	return t;
-}, Xe = (e, t) => {
+}, Qe = (e, t) => {
 	for (let n of t) if (RegExp(`\\b${n}\\s*\\(`).test(e)) return n;
-}, Ze = (e) => {
+}, $e = (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;
-}, Qe = (e, t, n) => {
+}, et = (e, t, n) => {
 	if (e.hasDeclaredGuards) return { kind: "declared-guard" };
-	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" } : {
+	let r = Ye(e.src), i = Qe(r, t);
+	return i === void 0 ? $e(r) ? { kind: "inline-ownership" } : n.has(e.tag) ? { kind: "allowlisted" } : { kind: "unchecked" } : {
 		kind: "vocabulary-guard",
 		name: i
 	};
-}, $e = (e, t, n) => {
+}, tt = (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;
-}, et = (e, t, n) => {
+}, nt = (e, t, n) => {
 	switch (t.kind) {
 		case "declared-guard": return "guards: on the descriptor";
 		case "vocabulary-guard": return `calls ${t.name}()`;
@@ -581,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`;
 	}
-}, tt = (e) => {
+}, rt = (e) => {
 	let t = e.executors.map((t) => {
-		let n = Qe(t, e.guardVocabulary, e.allowlist);
+		let n = et(t, e.guardVocabulary, e.allowlist);
 		return {
 			tag: t.tag,
 			path: t.path,
 			verdict: n,
-			severity: $e(t, e.tenantScopedTables, e.referencedTables),
-			why: et(t, n, e.rowFilterRegistered === !0)
+			severity: tt(t, e.tenantScopedTables, e.referencedTables),
+			why: nt(t, n, e.rowFilterRegistered === !0)
 		};
 	}), n = (e) => t.filter((t) => t.verdict.kind === e).length;
 	return {
@@ -603,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))
 	};
-}, nt = [
+}, it = [
 	"# voltro doctor — authz allowlist",
 	"#",
 	"# Two KINDS of line, and the difference is the point:",
@@ -628,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.",
 	""
-], rt = (e) => {
+], at = (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 [
-		...nt,
+		...it,
 		...n,
 		...r.length > 0 ? ["", "# reviewed — read by a human, open on purpose"] : [],
 		...r.map((e) => `${e.tag}  reviewed=${e.reviewed}`),
 		""
 	].join("\n");
-}, it = (e, t) => {
+}, ot = (e, t) => {
 	let n = [...new Set(t)].sort();
-	if (e === void 0) return rt(n.map((e) => ({ tag: e })));
-	let r = N(e).tags, i = n.filter((e) => !r.has(e));
+	if (e === void 0) return at(n.map((e) => ({ tag: e })));
+	let r = j(e).tags, i = n.filter((e) => !r.has(e));
 	return i.length === 0 ? e : [
 		e.replace(/\n+$/, ""),
 		"",
@@ -649,25 +649,25 @@ var le = /* @__PURE__ */ new Set([
 		...i,
 		""
 	].join("\n");
-}, at = (e, t) => {
+}, st = (e, t) => {
 	let n = [...new Set(t)];
 	if (e === void 0) return {
 		added: n.length,
 		kept: 0,
 		removed: 0
 	};
-	let r = N(e).tags;
+	let r = j(e).tags;
 	return {
 		added: n.filter((e) => !r.has(e)).length,
 		kept: r.size,
 		removed: 0
 	};
-}, ot = class extends Error {
+}, ct = 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";
 	}
-}, N = (e) => {
+}, j = (e) => {
 	let t = [];
 	for (let n of e.split("\n")) {
 		let e = n.trim();
@@ -680,7 +680,7 @@ var le = /* @__PURE__ */ new Set([
 			continue;
 		}
 		let a = r[2].trim();
-		if (a.length === 0) throw new ot(i);
+		if (a.length === 0) throw new ct(i);
 		t.push({
 			tag: i,
 			reviewed: a
@@ -690,13 +690,13 @@ var le = /* @__PURE__ */ new Set([
 		tags: new Set(t.map((e) => e.tag)),
 		entries: t
 	};
-}, st = (e) => {
+}, lt = (e) => {
 	let t = e.indexOf(".");
 	return t <= 0 ? void 0 : e.slice(0, t);
-}, ct = (e, t) => {
+}, ut = (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 = st(e);
+		let t = lt(e);
 		if (t === void 0) continue;
 		let n = i.get(t);
 		n ? n.push(e) : i.set(t, [e]);
@@ -725,7 +725,7 @@ var le = /* @__PURE__ */ new Set([
 			});
 			continue;
 		}
-		let s = new Set(o.rpcTags.map(st).filter((e) => e !== void 0));
+		let s = new Set(o.rpcTags.map(lt).filter((e) => e !== void 0));
 		for (let e of s) {
 			let t = i.get(e);
 			t !== void 0 && a.push({
@@ -738,12 +738,12 @@ var le = /* @__PURE__ */ new Set([
 		}
 	}
 	return a;
-}, lt = (e, t) => {
+}, dt = (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;
-}, ut = async (e) => {
+}, ft = async (e) => {
 	if (!await e.hasWorkflows().catch(() => !1)) return { kind: "not-applicable" };
 	let t;
 	try {
@@ -767,12 +767,12 @@ var le = /* @__PURE__ */ new Set([
 	} finally {
 		await t.close().catch(() => {});
 	}
-}, dt = (e) => {
+}, pt = (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`;
-}, ft = (e) => {
+}, mt = (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.`;
@@ -780,14 +780,41 @@ 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 ${dt(e.idleMs)}  ${e.reason}`);
+		for (let e of t.stalled.slice(0, 20)) n.push(`   ${e.tag}  ${e.runId}  idle ${pt(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");
-}, pt = (e) => S(b(e, "app.config.ts")) || S(b(e, "app.config.js")), mt = (e) => {
-	let t = m(e), n = p(e);
+}, ht = /(?:^|\n)\s*import\s+(?!type\s)[^;'"]*?from\s+['"]@voltro\/ui-shadcn(?:\/(?!tokens\.css)[^'"]+)?['"]/, gt = /@import\s+["']@voltro\/ui-shadcn\/tokens\.css["']|@import\s+["']tailwindcss["']|from\s+['"]@voltro\/ui-shadcn\/tokens\.css['"]|import\s+['"][^'"]*@voltro\/ui-shadcn\/tokens\.css['"]/, _t = (e) => {
+	let t = [], n = [];
+	for (let r of e) gt.test(r.source) ? n.push(r.path) : !r.path.endsWith(".css") && ht.test(r.source) && t.push(r.path);
+	return {
+		kitImporters: t,
+		styleEntries: n
+	};
+}, vt = (e) => e.kitImporters.length > 0 && e.styleEntries.length === 0, yt = (e) => {
+	if (!vt(e)) return [];
+	let t = e.kitImporters.slice(0, 5);
+	return [
+		`⚠ ui-shadcn: ${e.kitImporters.length} file(s) render kit components, and no CSS entry imports the kit's stylesheet.`,
+		...t.map((e) => `    ${e}`),
+		...e.kitImporters.length > t.length ? [`    … and ${e.kitImporters.length - t.length} more`] : [],
+		"",
+		"  The kit's components are Tailwind utility classes and nothing else, and",
+		"  Tailwind v4 emits a utility only when a CSS entry declares it. Without",
+		"  the stylesheet those classes name rules that do not exist — the markup",
+		"  renders as bare browser controls. Nothing else reports this: the build",
+		"  succeeds, `tsc` succeeds, and the page renders.",
+		"",
+		"  Fix — add ONE line to the CSS your root layout imports:",
+		"    @import \"@voltro/ui-shadcn/tokens.css\";",
+		"",
+		"  Or, if this app is not a kit app, import the unstyled control instead:",
+		"    import { LocaleSwitcher } from '@voltro/i18n'"
+	];
+}, bt = (e) => S(b(e, "app.config.ts")) || S(b(e, "app.config.js")), xt = (e) => {
+	let t = f(e), n = d(e);
 	return {
 		root: e,
 		serveBundle: t,
@@ -795,22 +822,22 @@ var le = /* @__PURE__ */ new Set([
 		apiBundle: n,
 		apiBundlePresent: S(n)
 	};
-}, ht = [
+}, St = [
 	"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  "), 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;
+].join("\n  "), Ct = (e, t = !1) => {
+	let n = xt(e);
+	if (console.log(`voltro doctor — serve preflight for ${n.root}`), !bt(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(`  ${ht}`), +!!i;
-}, _t = (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(`  ${St}`), +!!i;
+}, wt = (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"));
-}, vt = (e, t, n) => {
+}, Tt = (e, t, n) => {
 	let r = new Set(e), i = _(n), a = (e) => (/\.(tsx?|jsx?)$/.test(e) ? [e] : [
 		`${e}.ts`,
 		`${e}.tsx`,
@@ -836,7 +863,7 @@ var le = /* @__PURE__ */ new Set([
 			r !== void 0 && o.push(r);
 		}
 		return o;
-	}, s = /* @__PURE__ */ new Set(), c = e.filter((e) => St.test(y(n, e))), l = new Set(c);
+	}, s = /* @__PURE__ */ new Set(), c = e.filter((e) => zt.test(y(n, e))), l = new Set(c);
 	for (; c.length > 0;) {
 		let e = c.shift();
 		if (!s.has(e)) {
@@ -849,11 +876,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;
-}, 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) => {
+}, M = (e) => e.replace(/\/\*[\s\S]*?\*\//g, " ").replace(/(^|[^:])\/\/[^\n]*/g, "$1").replace(/'(?:[^'\\\n]|\\.)*'/g, "''").replace(/"(?:[^"\\\n]|\\.)*"/g, "\"\""), Et = (e, t) => (e.match(t) ?? []).length, N = (e, t) => e.getDescendantsOfKind(O.CallExpression).filter((e) => t.test(e.getExpression().getText())).length, Dt = (e, t) => {
 	if (e.src.includes(t)) return !0;
 	let n = t.replace(/^@voltro\/plugin-/, "");
-	return n !== t && I(e.file, RegExp(`^${n}Plugin$`)) > 0;
-}, bt = (e, t) => {
+	return n !== t && N(e.file, RegExp(`^${n}Plugin$`)) > 0;
+}, Ot = (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;
@@ -861,10 +888,122 @@ var le = /* @__PURE__ */ new Set([
 		n.push(e.slice(t, a - 1));
 	}
 	return n;
-}, xt = (e, t) => {
+}, kt = (e, t) => {
 	let n = t.getSymbol()?.getDeclarations()?.[0];
 	return n === void 0 ? [] : e.getDescendantsOfKind(O.Identifier).filter((e) => e.getSymbol()?.getDeclarations()?.[0] === n);
-}, St = /\.(server|cron|workflow\.server|subscribe|reaction|outbox|startup|trigger|webhook|migration|seed)\.tsx?$/, Ct = /\.(query|mutation|action|stream)\.server\.tsx?$/, wt = [
+}, At = /^(insert|insertMany|insertIgnore|update|updateMany|upsert|delete|deleteMany|hardDelete|patchJson)$/, jt = /^(notify|sendNotification|sendWebhook|dispatchWebhook|sendMail|trigger)\w*$/, Mt = (e, t) => {
+	if (!E.isObjectLiteralExpression(e)) return;
+	let n = e.getProperty("handler");
+	if (n === void 0 || !E.isPropertyAssignment(n)) return;
+	let r = n.getInitializer();
+	if (r === void 0) return;
+	if (E.isArrowFunction(r) || E.isFunctionExpression(r)) return r;
+	if (!E.isIdentifier(r)) return;
+	let i = t.getFunction(r.getText());
+	if (i !== void 0) return i;
+	let a = t.getVariableDeclaration(r.getText())?.getInitializer();
+	if (a !== void 0 && (E.isArrowFunction(a) || E.isFunctionExpression(a))) return a;
+}, Nt = (e) => {
+	let t = [jt], n = (E.isArrowFunction(e) || E.isFunctionExpression(e) || E.isFunctionDeclaration(e) ? e.getParameters() : [])[1];
+	if (n === void 0) return t;
+	let r = n.getNameNode();
+	if (E.isIdentifier(r)) return t.push(RegExp(`^${r.getText()}\\.publish$`)), t.push(RegExp(`^${r.getText()}\\.store\\.${At.source.replace(/^\^|\$$/g, "")}$`)), t;
+	if (E.isObjectBindingPattern(r)) for (let e of r.getElements()) {
+		let n = e.getPropertyNameNode()?.getText() ?? e.getName(), r = e.getName();
+		n === "publish" && t.push(RegExp(`^${r}$`)), n === "store" && t.push(RegExp(`^${r}\\.${At.source.replace(/^\^|\$$/g, "")}$`));
+	}
+	return t;
+}, Pt = (e, t, n, r = 0, i = /* @__PURE__ */ new Set()) => {
+	let a = e.getDescendantsOfKind(O.CallExpression);
+	for (let e of a) {
+		let t = e.getExpression().getText();
+		if (n.some((e) => e.test(t))) return !0;
+	}
+	if (r >= 2) return !1;
+	for (let e of a) {
+		let a = e.getExpression().getText();
+		if (!/^[A-Za-z_$][\w$]*$/.test(a) || i.has(a)) continue;
+		i.add(a);
+		let o = t.getFunction(a) ?? (() => {
+			let e = t.getVariableDeclaration(a)?.getInitializer();
+			return e !== void 0 && (E.isArrowFunction(e) || E.isFunctionExpression(e)) ? e : void 0;
+		})();
+		if (o !== void 0 && Pt(o, t, [...n, ...Nt(o)], r + 1, i)) return !0;
+	}
+	return !1;
+}, Ft = (e) => {
+	let t = /* @__PURE__ */ new Set();
+	for (let n of e.values()) {
+		if (!/\bsetRowFilter\s*[<(]/.test(n)) continue;
+		let e = /\btables\s*:\s*\[([^\]]*)\]/.exec(n);
+		if (e !== null) for (let n of e[1].matchAll(/['"`]([A-Za-z_][\w]*)['"`]/g)) t.add(n[1]);
+	}
+	return t;
+}, It = (e) => {
+	if (!/\.(query|stream|mutation|action)\.server\.tsx?$/.test(e.path)) return !1;
+	let t = Ft(e.sources);
+	return t.size === 0 || ![...e.src.matchAll(/\btable\s*:\s*['"`]([A-Za-z_][\w]*)['"`]/g)].map((e) => e[1]).some((e) => t.has(e)) ? !1 : /\b(eq|and|inSet)\s*\(/.test(e.src) || /\bwhere\s*:/.test(e.src);
+}, Lt = (e) => e.getDescendantsOfKind(O.CallExpression).filter((e) => e.getExpression().getText() === "defineSubscriber").some((t) => {
+	let n = t.getArguments()[0];
+	if (n === void 0 || !E.isObjectLiteralExpression(n) || n.getProperty("once") !== void 0) return !1;
+	let r = Mt(n, e);
+	return r !== void 0 && Pt(r, e, Nt(r));
+}), Rt = (e) => e.getDescendantsOfKind(O.CallExpression).filter((e) => e.getExpression().getText() === "defineSubscriber").filter((e) => {
+	let t = e.getArguments()[0];
+	return t !== void 0 && E.isObjectLiteralExpression(t) && t.getProperty("once") === void 0;
+}).length, zt = /\.(server|cron|workflow\.server|subscribe|reaction|outbox|startup|trigger|webhook|migration|seed)\.tsx?$/, Bt = (e, t) => {
+	let n;
+	try {
+		n = t.createSourceFile("/descriptor-scan.ts", e, { overwrite: !0 });
+	} catch {
+		return;
+	}
+	for (let e of n.getDescendantsOfKind(O.PropertyAssignment)) {
+		if (e.getName() !== "output") continue;
+		let t = e.getInitializer();
+		if (t !== void 0 && E.isCallExpression(t) && /\.Array$/.test(t.getExpression().getText()) && (t = t.getArguments()[0]), t === void 0 || !E.isCallExpression(t) || !/\.Struct$/.test(t.getExpression().getText())) return;
+		let n = t.getArguments()[0];
+		if (n === void 0 || !E.isObjectLiteralExpression(n)) return;
+		let r = [];
+		for (let e of [n, ...n.getDescendantsOfKind(O.ObjectLiteralExpression)]) for (let t of e.getProperties()) if (E.isPropertyAssignment(t) || E.isShorthandPropertyAssignment(t)) r.push(t.getName());
+		else if (E.isSpreadAssignment(t)) return;
+		return r;
+	}
+}, Vt = (e, t) => {
+	let n = [], r = (e) => {
+		e !== void 0 && (E.isObjectLiteralExpression(e) ? n.push(e) : E.isParenthesizedExpression(e) && r(e.getExpression()));
+	};
+	for (let t of e.getDescendantsOfKind(O.ReturnStatement)) r(t.getExpression());
+	for (let t of e.getDescendantsOfKind(O.ArrowFunction)) r(t.getBody());
+	let i = /* @__PURE__ */ new Set();
+	for (let e of n) {
+		let n = [];
+		for (let t of e.getProperties()) if (E.isPropertyAssignment(t) || E.isShorthandPropertyAssignment(t)) n.push(t.getName());
+		else if (E.isSpreadAssignment(t)) return;
+		if (n.some((e) => t.has(e))) for (let e of n) i.add(e);
+	}
+	return [...i];
+}, Ht = (e, t, n) => {
+	let r = RegExp(`\\btable\\(\\s*['"\`]${e.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}['"\`]`);
+	for (let [, i] of t) {
+		if (!r.test(i)) continue;
+		let t;
+		try {
+			t = n.createSourceFile("/entity-scan.ts", i, { overwrite: !0 });
+		} catch {
+			continue;
+		}
+		for (let n of t.getDescendantsOfKind(O.CallExpression)) {
+			if (n.getExpression().getText() !== "table") continue;
+			let [t, r] = n.getArguments();
+			if (t === void 0 || !E.isStringLiteral(t) || t.getLiteralValue() !== e) continue;
+			if (r === void 0 || !E.isObjectLiteralExpression(r)) return;
+			let i = /* @__PURE__ */ new Set();
+			for (let e of r.getProperties()) E.isPropertyAssignment(e) && /\.nullable\s*\(/.test(e.getText()) && i.add(e.getName());
+			return i;
+		}
+	}
+}, Ut = (e) => /\bNullOr\b|\bSchema\.Null\b|\bnullable\s*\(/.test(e), P = /\.(query|mutation|action|stream)\.server\.tsx?$/, Wt = [
 	"Id",
 	"ID",
 	"Hash",
@@ -890,7 +1029,7 @@ var le = /* @__PURE__ */ new Set([
 	"Comment",
 	"Provider",
 	"Format"
-], Tt = RegExp(`(?:${wt.join("|")})$|_(?:${wt.map((e) => e.toLowerCase()).join("|")})$`), Et = [
+], Gt = RegExp(`(?:${Wt.join("|")})$|_(?:${Wt.map((e) => e.toLowerCase()).join("|")})$`), Kt = [
 	{
 		id: "hardcoded-framework-cookie",
 		scope: "client",
@@ -903,7 +1042,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 }) => Ct.test(t) && !/\bimport\s[^;]*\bfrom\s*['"][^'"]*['"]/.test((e.match(/^\s*import\s[^;]*from\s*['"]\.[^'"]*['"]/gm) ?? []).join("\n"))
+		match: ({ src: e, path: t }) => P.test(t) && !/\bimport\s[^;]*\bfrom\s*['"][^'"]*['"]/.test((e.match(/^\s*import\s[^;]*from\s*['"]\.[^'"]*['"]/gm) ?? []).join("\n"))
 	},
 	{
 		id: "subject-write-no-guard",
@@ -912,12 +1051,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 (!Ct.test(n)) return !1;
-			let r = P(t);
+			if (!P.test(n)) return !1;
+			let r = M(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 = _t(e);
+			let i = wt(e);
 			if (i === void 0) return !1;
-			let a = P(i);
+			let a = M(i);
 			return /\binternal\s*:\s*true\b/.test(a) || /\bguards\s*:\s*\[/.test(a) || /\.guard\s*\(/.test(a) ? !1 : /\bopenAccess\s*:/.test(a);
 		}
 	},
@@ -926,14 +1065,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 }) => (St.test(t) || n) && I(e, /^(?:globalThis\.|window\.|self\.)?fetch$/) > 0
+		match: ({ file: e, path: t, serverOnly: n }) => (zt.test(t) || n) && N(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 }) => I(t, /^useState$/) >= 4 && /onSubmit|handleSubmit|isSubmitting/.test(e)
+		match: ({ src: e, file: t }) => N(t, /^useState$/) >= 4 && /onSubmit|handleSubmit|isSubmitting/.test(e)
 	},
 	{
 		id: "table",
@@ -961,7 +1100,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 }) => F(e, /\buseSubscription\s*[(<]/g) >= 3 && F(e, /\buseMemo\s*\(/g) >= 3
+		match: ({ src: e }) => Et(e, /\buseSubscription\s*[(<]/g) >= 3 && Et(e, /\buseMemo\s*\(/g) >= 3
 	},
 	{
 		id: "next-shim",
@@ -993,7 +1132,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) => xt(e, t).some((e) => {
+		}).some((t) => kt(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();
@@ -1021,7 +1160,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) => I(e.file, /\bstore\.query$/) >= 3 || I(e.file, /\bstore\.query$/) >= 2 && /\bnew Map\s*\(/.test(e.src)
+		match: (e) => N(e.file, /\bstore\.query$/) >= 3 || N(e.file, /\bstore\.query$/) >= 2 && /\bnew Map\s*\(/.test(e.src)
 	},
 	{
 		id: "store-effect-lift",
@@ -1044,7 +1183,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) || Tt.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) || Gt.test(n) || /^vault/i.test(n) || /\.unique\s*\(/.test(e) ? !1 : !/\.encrypted\s*\(/.test(e);
 		}))
 	},
 	{
@@ -1054,15 +1193,67 @@ 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) || Tt.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) || Gt.test(n) || /^vault/i.test(n) ? !1 : /\.unique\s*\(/.test(e) && !/\.encrypted\s*\(/.test(e);
 		}))
 	},
+	{
+		id: "nullable-column-a-mutation-cannot-clear",
+		scope: "server",
+		smell: "a mutation writes a NULLABLE column through an input field that does not accept `null` — the value can be set once and never cleared",
+		use: "declare the field as `Schema.optional(Schema.NullOr(...))` — a column the schema lets be empty needs a wire shape that can say so",
+		match: (e) => {
+			if (!/\.mutation\.tsx?$/.test(e.path)) return !1;
+			let t = /target\s*:\s*\{[^}]*\btable\s*:\s*['"`]([^'"`]+)['"`]/.exec(e.src)?.[1];
+			if (t === void 0) return !1;
+			let n = Ht(t, e.sources, e.file.getProject());
+			if (n === void 0 || n.size === 0) return !1;
+			for (let t of e.file.getDescendantsOfKind(O.PropertyAssignment)) {
+				if (t.getName() !== "input") continue;
+				let e = t.getInitializer();
+				if (e === void 0 || !E.isCallExpression(e) || !/\.Struct$/.test(e.getExpression().getText())) continue;
+				let r = e.getArguments()[0];
+				if (!(r === void 0 || !E.isObjectLiteralExpression(r))) {
+					for (let e of r.getProperties()) if (E.isPropertyAssignment(e) && n.has(e.getName()) && !Ut(e.getText())) return !0;
+				}
+			}
+			return !1;
+		}
+	},
+	{
+		id: "executor-builds-an-undeclared-field",
+		scope: "server",
+		smell: "an executor builds a field its descriptor's `output` does not declare (silently stripped on the way out)",
+		use: "add the field to the descriptor's `output` struct, or stop building it — `output` IS the serializer, so an undeclared key never reaches the caller",
+		match: (e) => {
+			if (!P.test(e.path)) return !1;
+			let t = wt(e);
+			if (t === void 0) return !1;
+			let n = Bt(t, e.file.getProject());
+			if (n === void 0 || n.length === 0) return !1;
+			let r = Vt(e.file, new Set(n));
+			return r === void 0 || r.length === 0 ? !1 : r.some((e) => !n.includes(e));
+		}
+	},
+	{
+		id: "subscriber-effect-without-once",
+		scope: "server",
+		smell: "a *.subscribe.ts handler that WRITES or publishes with no `once:` (it runs on every replica, so the effect repeats once per replica)",
+		use: "once: true on defineSubscriber — one INSERT-wins claim per change, fleet-wide (or `once: (event) => key` for a coarser key). A hand-rolled `insertIgnore` dedupe is this, written out.",
+		match: ({ file: e }) => Lt(e)
+	},
+	{
+		id: "row-filter-duplicated-by-hand",
+		scope: "server",
+		smell: "a handler that constrains a table your registered `setRowFilter` already constrains",
+		use: "drop the hand-written predicate — the filter covers the query, the mutation, the stream AND the subscription delivery. Keep it only if this handler must be NARROWER than the filter, and say so in a comment (two identical predicates ANDed are as tight as one, so this is maintenance, not a leak)",
+		match: (e) => It(e)
+	},
 	{
 		id: "mutation-tail-effect",
 		scope: "server",
 		smell: "a notify / webhook helper called at the tail of a mutation",
 		use: "defineSubscriber (*.subscribe.ts) or defineReaction (*.reaction.tsx) — declarative, post-commit, with the old/new diff, instead of reactivity hidden inside every executor",
-		match: ({ src: e, path: t }) => /\b(notify|sendNotification|sendWebhook|dispatchWebhook|trigger[A-Z]\w*)\s*\(/.test(e) && (/\bexport\s+default\b/.test(e) || /\.(mutation|action)\.server\.tsx?$/.test(t))
+		match: ({ src: e, path: t, file: n }) => /\b(notify|sendNotification|sendWebhook|dispatchWebhook|trigger[A-Z]\w*)\s*\(/.test(e) && (/\bexport\s+default\b/.test(e) || /\.(mutation|action)\.server\.tsx?$/.test(t)) && N(n, /^(defineSubscriber|defineReaction)$/) === 0
 	},
 	{
 		id: "hand-cursor",
@@ -1118,9 +1309,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 }) => I(e, /^setRowFilter$/) > 0 && ![...t.values()].some((e) => {
-			let t = P(e);
-			return bt(t, "makeTestContext").length > 0 && /\browFilter\b/.test(t);
+		match: ({ file: e, testSources: t }) => N(e, /^setRowFilter$/) > 0 && ![...t.values()].some((e) => {
+			let t = M(e);
+			return Ot(t, "makeTestContext").length > 0 && /\browFilter\b/.test(t);
 		})
 	},
 	{
@@ -1130,15 +1321,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)
 	}
-], Dt = (e) => R(e), Ot = (e, t) => {
+], F = (e) => L(e), qt = (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();
-}, 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;
+}, Jt = /\.(tsx?|jsx?)$/, I = /(^|\/)(node_modules|dist|build|\.framework|\.next|coverage)(\/|$)/, Yt = /(^|[\\/])[^\\/]*\.generated\.[cm]?[jt]sx?$|\.d\.[cm]?ts$/, Xt = (e, t = [], n = 0) => {
+	if (n > 12 || I.test(e)) return t;
 	let r;
 	try {
 		r = w(e, { withFileTypes: !0 });
@@ -1149,12 +1340,12 @@ var le = /* @__PURE__ */ new Set([
 		let r = v(e, i.name);
 		if (i.isDirectory()) {
 			if (i.name.startsWith(".")) continue;
-			jt(r, t, n + 1);
+			Xt(r, t, n + 1);
 		} else je.test(i.name) && t.push(r);
 	}
 	return t;
-}, R = (e, t = [], n = 0) => {
-	if (n > 12 || L.test(e)) return t;
+}, L = (e, t = [], n = 0) => {
+	if (n > 12 || I.test(e)) return t;
 	let r;
 	try {
 		r = w(e);
@@ -1168,11 +1359,11 @@ var le = /* @__PURE__ */ new Set([
 		} catch {
 			continue;
 		}
-		a.isDirectory() ? R(r, t, n + 1) : kt.test(i) && !/\.(test|spec)\./.test(i) && !At.test(i) && t.push(r);
+		a.isDirectory() ? L(r, t, n + 1) : Jt.test(i) && !/\.(test|spec)\./.test(i) && !Yt.test(i) && t.push(r);
 	}
 	return t;
-}, Mt = (e, t = [], n = 0) => {
-	if (n > 12 || L.test(e)) return t;
+}, Zt = (e, t = [], n = 0) => {
+	if (n > 12 || I.test(e)) return t;
 	let r;
 	try {
 		r = w(e);
@@ -1186,17 +1377,17 @@ var le = /* @__PURE__ */ new Set([
 		} catch {
 			continue;
 		}
-		a.isDirectory() ? Mt(r, t, n + 1) : kt.test(i) && /\.(test|spec)\./.test(i) && t.push(r);
+		a.isDirectory() ? Zt(r, t, n + 1) : Jt.test(i) && /\.(test|spec)\./.test(i) && t.push(r);
 	}
 	return t;
-}, Nt = (e) => {
-	let t = Dt(e);
+}, Qt = (e) => {
+	let t = F(e);
 	return {
-		dirs: Ot(e, t),
+		dirs: qt(e, t),
 		fileCount: t.length
 	};
-}, Pt = (e) => {
-	let t = Dt(e);
+}, $t = (e) => {
+	let t = F(e);
 	if (t.length === 0) return [];
 	let n = new D({
 		useInMemoryFileSystem: !0,
@@ -1205,8 +1396,8 @@ var le = /* @__PURE__ */ new Set([
 	for (let e of t) try {
 		i.set(e, C(e, "utf8"));
 	} catch {}
-	let a = vt([...i.keys()], i, e), o = /* @__PURE__ */ new Map();
-	for (let t of Mt(e)) try {
+	let a = Tt([...i.keys()], i, e), o = /* @__PURE__ */ new Map();
+	for (let t of Zt(e)) try {
 		o.set(t, C(t, "utf8"));
 	} catch {}
 	for (let s of t) {
@@ -1226,23 +1417,34 @@ var le = /* @__PURE__ */ new Set([
 		} catch {
 			continue;
 		}
-		for (let t of Et) {
-			if (t.plugin !== void 0 && yt(c, t.plugin) || !t.match(c)) continue;
+		for (let t of Kt) {
+			if (t.plugin !== void 0 && Dt(c, t.plugin) || !t.match(c)) continue;
 			let n = r.get(t.id) ?? [];
 			n.push(y(e, s)), r.set(t.id, n);
 		}
 	}
-	return Et.filter((e) => r.has(e.id)).map((e) => ({
+	return Kt.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));
-}, z = (e) => {
-	let t = Nt(e);
+}, en = (e) => {
+	let t = new D({
+		useInMemoryFileSystem: !0,
+		skipAddingFilesFromTsConfig: !0
+	}), n = 0;
+	for (let r of F(e)) if (/\.subscribe\.tsx?$/.test(r)) try {
+		let e = t.createSourceFile(`/count${r.endsWith("x") ? ".tsx" : ".ts"}`, C(r, "utf8"), { overwrite: !0 });
+		n += Rt(e);
+	} catch {}
+	return n;
+}, R = (e) => {
+	let t = Qt(e);
 	return {
 		root: e,
 		scannedFiles: t.fileCount,
 		scannedDirs: t.dirs,
-		findings: Pt(e).map(({ rule: e, files: t }) => ({
+		subscribersWithoutOnce: en(e),
+		findings: $t(e).map(({ rule: e, files: t }) => ({
 			id: e.id,
 			scope: e.scope,
 			smell: e.smell,
@@ -1250,13 +1452,13 @@ var le = /* @__PURE__ */ new Set([
 			files: t
 		}))
 	};
-}, Ft = 3, It = .2, Lt = 50, Rt = (e, t) => e >= Lt && t > 0 && e / t >= It, zt = (e) => {
+}, tn = 3, nn = .2, rn = 50, an = (e, t) => e >= rn && t > 0 && e / t >= nn, on = (e) => {
 	let t = /* @__PURE__ */ new Map();
-	for (let n of R(e)) try {
+	for (let n of L(e)) try {
 		t.set(y(e, n), C(n, "utf8"));
 	} catch {}
 	let n = /* @__PURE__ */ new Map();
-	for (let t of jt(e)) try {
+	for (let t of Xt(e)) try {
 		n.set(y(e, t), C(t, "utf8"));
 	} catch {}
 	let r = Me({
@@ -1264,8 +1466,8 @@ var le = /* @__PURE__ */ new Set([
 		envFiles: n
 	});
 	r !== void 0 && (console.log(""), console.log(Ne(r)));
-}, Bt = (e) => {
-	let t = z(e);
+}, sn = (e) => {
+	let t = R(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(", ")}):`);
@@ -1276,37 +1478,43 @@ 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 (Rt(e.files.length, t.scannedFiles)) {
+			if (an(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, Ft).join(", "), i = e.files.length - Ft;
+			let r = e.files.slice(0, tn).join(", "), i = e.files.length - tn;
 			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;
-}, 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];
+	n > 0 && console.log(`   (${n} more file path${n === 1 ? "" : "s"} not shown \u2014 \`voltro doctor --json\` prints every one.)`);
+	let r = t.findings.find((e) => e.id === "subscriber-effect-without-once");
+	if (t.subscribersWithoutOnce > 0) {
+		let e = r?.files.length ?? 0;
+		console.log(`   \u24d8 ${t.subscribersWithoutOnce} subscriber(s) declare no \`once:\`; an effect was found in ${e}. The rule reads each subscriber's OWN file (its handler and the functions that file declares) and does not resolve imports — a write in another module is unexamined, not absent.`);
+	}
+	return console.log("   (See the \"Pick the SERVER primitive\" / \"Pick the CLIENT primitive\" rubrics in AGENTS.md / CLAUDE.md.)"), t.findings.length;
+}, cn = "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.", ln = /export\s+const\s+renderMode\s*(?::[^=]+)?=\s*['"]([^'"]*)['"]/, un = /export\s+const\s+dynamic\s*=\s*['"]force-(dynamic|static)['"]/, dn = (e) => {
+	let t = ln.exec(e)?.[1];
 	if (t !== void 0) return t === "ssr" ? "ssr" : null;
-	let n = Ut.exec(e)?.[1];
+	let n = un.exec(e)?.[1];
 	return n === "dynamic" ? "ssr" : n === "static" ? null : "default";
-}, B = async (e) => {
+}, z = async (e) => {
 	let t = v(e, "src", "pages");
 	if (!S(t)) return [];
-	let { pages: n, dirs: r } = await u(t), i = [];
+	let { pages: n, dirs: r } = await s(t), i = [];
 	for (let a of n) {
-		if (!c(r, a.dirChain).some((e) => e.hasLayout)) continue;
+		if (!l(r, a.dirChain).some((e) => e.hasLayout)) continue;
 		let n;
 		try {
 			n = C(v(t, a.file), "utf8");
 		} catch {
 			continue;
 		}
-		if (l.test(n)) continue;
-		let o = Wt(n);
+		if (c.test(n)) continue;
+		let o = dn(n);
 		o !== null && i.push({
 			file: y(e, v(t, a.file)),
 			pattern: a.pattern,
@@ -1314,20 +1522,20 @@ var le = /* @__PURE__ */ new Set([
 		});
 	}
 	return i;
-}, Gt = 10, Kt = async (e) => {
+}, fn = 10, pn = 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);
+	let n = await z(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, Gt)) {
+	for (let e of n.slice(0, fn)) {
 		let t = e.currentMode === "ssr" ? "renderMode:'ssr'" : "default renderMode";
 		console.log(`   ${e.file}  (${e.pattern}) — ${t}`);
 	}
-	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([
+	let r = n.length - fn;
+	return r > 0 && console.log(`   (+${r} more page${r === 1 ? "" : "s"} not shown — \`voltro doctor --json\` prints every one.)`), console.log(`     → ${cn}`), n.length;
+}, mn = /* @__PURE__ */ new Set([
 	"node_modules",
 	"dist",
 	"build",
@@ -1335,7 +1543,7 @@ var le = /* @__PURE__ */ new Set([
 	".vite",
 	".framework",
 	".git"
-]), Jt = (e, t, n) => {
+]), hn = (e, t, n) => {
 	let r;
 	try {
 		r = w(e, { withFileTypes: !0 });
@@ -1343,11 +1551,11 @@ var le = /* @__PURE__ */ new Set([
 		return;
 	}
 	for (let i of r) {
-		if (qt.has(i.name)) continue;
+		if (mn.has(i.name)) continue;
 		let r = v(e, i.name);
-		i.isDirectory() ? Jt(r, t, n) : i.isFile() && i.name.endsWith(".tsx") && n.push(y(t, r));
+		i.isDirectory() ? hn(r, t, n) : i.isFile() && i.name.endsWith(".tsx") && n.push(y(t, r));
 	}
-}, Yt = (e, t) => {
+}, gn = (e, t) => {
 	let n = /* @__PURE__ */ new Set(), r = /(?:from|import)\s*\(?\s*['"](\.[^'"]*)['"]/g;
 	for (let i of t) {
 		let t;
@@ -1372,21 +1580,21 @@ var le = /* @__PURE__ */ new Set([
 		}
 	}
 	return n;
-}, Xt = (e, t) => {
+}, _n = (e, t) => {
 	let n = e.slice(t.length).split(x).slice(0, -1)[0];
 	return n !== void 0 && n.startsWith("[");
-}, V = (e) => {
+}, B = (e) => {
 	let t = [], n = v(e, "src", "pages"), r = v(e, "src");
 	if (!S(r)) return t;
 	let i = [];
-	Jt(r, e, i), i.sort();
+	hn(r, e, i), i.sort();
 	let a = `${y(e, n)}${x}`;
-	Yt(e, i);
+	gn(e, i);
 	for (let n of i) {
 		let r = n.slice(n.lastIndexOf(x) + 1);
 		if (n.startsWith(a)) {
 			if (r !== "page.tsx") continue;
-			S(v(e, f(n))) || t.push({
+			S(v(e, m(n))) || t.push({
 				kind: "page-without-test",
 				file: n
 			});
@@ -1397,7 +1605,7 @@ var le = /* @__PURE__ */ new Set([
 					file: n
 				});
 			} catch {}
-			Xt(n, a) && t.push({
+			_n(n, a) && t.push({
 				kind: "top-level-dynamic-route",
 				file: n
 			});
@@ -1409,35 +1617,35 @@ var le = /* @__PURE__ */ new Set([
 		});
 	}
 	return t;
-}, Zt = 10, H = (e, t, n) => {
+}, vn = 10, V = (e, t, n) => {
 	if (t.length === 0) return;
 	console.log(`•  ${e} (${t.length}):`);
-	for (let e of t.slice(0, Zt)) console.log(`   ${e}`);
-	let r = t.length - Zt;
+	for (let e of t.slice(0, vn)) console.log(`   ${e}`);
+	let r = t.length - vn;
 	r > 0 && console.log(`   (+${r} more not shown — \`voltro doctor --json\` prints every one.)`), console.log(`     → ${n}`);
-}, Qt = (e) => {
+}, yn = (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;
-	let n = V(e);
+	let n = B(e);
 	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;
-}, $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);
+	return V("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."), V("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."), V("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."), V("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;
+}, bn = "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.", xn = /* @__PURE__ */ new Map(), H = (e) => {
+	let t = xn.get(e);
 	if (t !== void 0) return t;
 	let n = (async () => {
-		let { walk: t, loadDiscovered: n } = await import("./dev-DfVZaoys.js"), r = await t(e);
+		let { walk: t, loadDiscovered: n } = await import("./dev-Bl9HqtV7.js"), r = await t(e);
 		return {
 			files: r,
-			discovered: await n(r)
+			discovered: await n(r, { root: e })
 		};
 	})();
-	return en.set(e, n), n;
-}, tn = async (e) => {
+	return xn.set(e, n), n;
+}, Sn = async (e) => {
 	let t;
 	try {
-		let { files: n, discovered: r } = await U(e), i = r.tables.map((e) => {
+		let { files: n, discovered: r } = await H(e), i = r.tables.map((e) => {
 			let t = e;
 			return {
 				name: t.tableName,
@@ -1450,7 +1658,7 @@ var le = /* @__PURE__ */ new Set([
 		return;
 	}
 	t !== null && (console.log(""), console.log(`${t.includes("does not exist") ? "✗" : "✓"}  ${t}`));
-}, nn = (e) => e.map((e) => {
+}, Cn = (e) => e.map((e) => {
 	let t = e, n = Object.entries(t.fields ?? {}).map(([e, t]) => ({
 		name: e,
 		type: typeof t?.type == "string" ? t.type : ""
@@ -1460,13 +1668,13 @@ var le = /* @__PURE__ */ new Set([
 		columns: n,
 		primaryKey: t.appliedPrimaryKey ?? []
 	};
-}), rn = async (e) => {
+}), wn = 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 = [];
+		let { missingRelationSources: t } = await import("./doctorSourceRelations-c5mlN5HI.js"), { sourceKeys: n } = await import("@voltro/protocol"), { readFile: r } = await import("node:fs/promises"), { discovered: i } = await H(e), a = [], o = [];
 		for (let e of i.queries) {
 			let i = n(e.descriptor.source);
 			if (i.length === 0) continue;
-			let s = an(e.file);
+			let s = Tn(e.file);
 			if (s === void 0) continue;
 			let c = await r(s, "utf8").catch(() => null);
 			if (c === null) continue;
@@ -1483,8 +1691,8 @@ var le = /* @__PURE__ */ new Set([
 	} catch {
 		return null;
 	}
-}, 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);
+}, Tn = (e) => e.endsWith(".ts") && !e.endsWith(".server.ts") ? `${e.slice(0, -3)}.server.ts` : void 0, En = async (e) => {
+	let t = await wn(e);
 	if (t === null) return;
 	let n = t.findings;
 	if (n.length > 0) {
@@ -1497,21 +1705,21 @@ var le = /* @__PURE__ */ new Set([
 		for (let e of t.unresolved) console.log(`   ${e.procedure}: ${e.relations.map((e) => `\`${e}\``).join(", ")} resolved against no table`);
 		console.log("   declare the base table in `source:` and re-run — relations under it are unchecked until then.");
 	}
-}, W = async (e) => {
+}, U = async (e) => {
 	try {
-		let { discovered: t } = await U(e);
-		return ve(nn(t.tables));
+		let { discovered: t } = await H(e);
+		return ve(Cn(t.tables));
 	} catch {
 		return null;
 	}
-}, sn = async (e) => {
-	let t = await W(e);
+}, Dn = async (e) => {
+	let t = await U(e);
 	if (t === null || t.tablesChecked === 0) return;
 	let n = be(t);
 	n !== null && (console.log(""), console.log(`${t.issues.length > 0 ? "✗" : "✓"}  ${n}`));
-}, G = async (e) => {
+}, W = async (e) => {
 	try {
-		let { payloadPropertyNames: t } = await import("@voltro/runtime"), { discovered: n } = await U(e);
+		let { payloadPropertyNames: t } = await import("@voltro/runtime"), { discovered: n } = await H(e);
 		return we(n.events.map((e) => {
 			let n = e.descriptor, r = t(n.key);
 			return {
@@ -1524,19 +1732,19 @@ var le = /* @__PURE__ */ new Set([
 	} catch {
 		return null;
 	}
-}, cn = async (e) => {
-	let t = await G(e);
+}, On = async (e) => {
+	let t = await W(e);
 	if (t === null || t.eventsChecked === 0) return;
 	let n = Te(t);
 	n !== null && (console.log(""), console.log(`•  ${n}`));
 	let r = Ee(t);
 	r !== null && (console.log(""), console.log(`⚠️  ${r}`));
-}, K = (e) => {
+}, G = (e) => {
 	let t = e, n = typeof t?.message == "string" && t.message !== "" ? t.message : String(e), r = typeof t?.code == "string" ? t.code : void 0;
 	return r === void 0 ? n : `${r}: ${n}`;
-}, q = async (e) => {
+}, K = async (e) => {
 	try {
-		let { formatServerOnlyLeaks: t } = await import("@voltro/runtime"), n = (await U(e)).discovered.serverOnlyLeaks, r = t(n);
+		let { formatServerOnlyLeaks: t } = await import("@voltro/runtime"), n = (await H(e)).discovered.serverOnlyLeaks, r = t(n);
 		return {
 			status: {
 				checked: !0,
@@ -1547,12 +1755,12 @@ var le = /* @__PURE__ */ new Set([
 	} catch (e) {
 		return { status: {
 			checked: !1,
-			reason: K(e)
+			reason: G(e)
 		} };
 	}
-}, J = async (r) => {
+}, q = async (r) => {
 	try {
-		let { loadApiConfig: i } = await import("./dev-DfVZaoys.js"), { discovered: a } = await U(r), o = t(await i(r)), s = {
+		let { loadApiConfig: i } = await import("./dev-Bl9HqtV7.js"), { discovered: a } = await H(r), o = n(await i(r)), s = {
 			queries: a.queries,
 			mutations: a.mutations,
 			actions: a.actions,
@@ -1562,32 +1770,32 @@ var le = /* @__PURE__ */ new Set([
 		return {
 			checked: !0,
 			defaultDeny: o,
-			undecided: n(s),
+			undecided: t(s),
 			openAccess: e(s)
 		};
 	} catch (e) {
 		return {
 			checked: !1,
-			reason: K(e),
+			reason: G(e),
 			defaultDeny: !0,
 			undecided: [],
 			openAccess: []
 		};
 	}
-}, ln = async (e) => {
-	let t = await J(e);
+}, kn = async (e) => {
+	let t = await q(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)}`);
 	for (let e of t.openAccess) console.log(`      ${e.tag} — ${e.openAccess ?? ""}`);
 	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:"), 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 = () => {
+	return console.log(""), t.defaultDeny ? (console.log("  `voltro dev` and `voltro serve` REFUSE to boot on these. Give each a decision:"), An(), !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."), An(), !1);
+}, An = () => {
 	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) => {
+}, J = async (e) => {
 	try {
-		let { files: t } = await U(e), { WEBHOOK_PATTERN: n, loadWebhookFiles: r } = await import("./webhookDiscovery-il9ti-HE.js"), { incomingWebhookVerification: i } = await import("@voltro/plugin-webhooks"), a = t.filter((e) => n.test(ie(e)));
+		let { files: t } = await H(e), { WEBHOOK_PATTERN: n, loadWebhookFiles: r } = await import("./webhookDiscovery-il9ti-HE.js"), { incomingWebhookVerification: i } = await import("@voltro/plugin-webhooks"), a = t.filter((e) => n.test(ie(e)));
 		if (a.length === 0) return {
 			checked: !0,
 			unverified: [],
@@ -1614,14 +1822,14 @@ var le = /* @__PURE__ */ new Set([
 	} catch (e) {
 		return {
 			checked: !1,
-			reason: K(e),
+			reason: G(e),
 			unverified: [],
 			open: [],
 			verified: 0
 		};
 	}
-}, dn = async (e) => {
-	let t = await Y(e);
+}, jn = async (e) => {
+	let t = await J(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;
 	console.log(""), console.log("incoming webhook verification"), console.log(`  ✓ signature / provider verified         ${String(t.verified).padStart(4)}`), console.log(`  ! deliberately public (none)            ${String(t.open.length).padStart(4)}`), console.log(`  ✗ nothing verifies the caller           ${String(t.unverified.length).padStart(4)}`);
@@ -1630,13 +1838,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;
-}, fn = async (e) => {
-	let { status: t, message: n } = await q(e);
+}, Mn = async (e) => {
+	let { status: t, message: n } = await K(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);
-}, pn = async (e) => ut({
-	hasWorkflows: async () => (await U(e)).discovered.workflows.length > 0,
+}, Nn = async (e) => ft({
+	hasWorkflows: async () => (await H(e)).discovered.workflows.length > 0,
 	openStore: async () => {
-		let { loadApiConfig: t, buildStore: n } = await import("./dev-DfVZaoys.js"), r = await t(e);
+		let { loadApiConfig: t, buildStore: n } = await import("./dev-Bl9HqtV7.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 {
@@ -1650,13 +1858,13 @@ var le = /* @__PURE__ */ new Set([
 		let { sweepStalledRuns: t } = await import("@voltro/workflow");
 		return t({ store: e });
 	}
-}), mn = async (e) => {
-	let t = ft(await pn(e));
+}), Pn = async (e) => {
+	let t = mt(await Nn(e));
 	t !== null && (console.log(""), console.log(t));
-}, hn = async (e) => {
+}, Fn = async (e) => {
 	let t;
 	try {
-		let { payloadPropertyNames: n } = await import("@voltro/runtime"), { files: r, discovered: i } = await U(e);
+		let { payloadPropertyNames: n } = await import("@voltro/runtime"), { files: r, discovered: i } = await H(e);
 		t = ke(r, i.workflows.map((e) => {
 			let t = e.definition, r = t.payloadSchema === void 0 ? {
 				required: [],
@@ -1676,18 +1884,18 @@ 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", gn = (e, t = (e) => {
+}, Y = "voltro-authz-allowlist.txt", In = (e, t = (e) => {
 	try {
 		return C(e, "utf8");
 	} catch {
 		return "";
 	}
-}) => /* @__PURE__ */ new Set([...Je, ...Ye(R(e).map(t))]), _n = (e, t) => {
+}) => /* @__PURE__ */ new Set([...Xe, ...Ze(L(e).map(t))]), X = (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) => {
 	try {
-		let { discovered: t } = await U(e), n = t.events.map((e) => ({
+		let { discovered: t } = await H(e), n = t.events.map((e) => ({
 			name: e.descriptor.name,
 			file: e.file
 		})).filter((e) => typeof e.name == "string");
@@ -1698,25 +1906,25 @@ var le = /* @__PURE__ */ new Set([
 			} catch {
 				return "";
 			}
-		}, a = R(e).filter((e) => !r.has(e)).map(i).join("\n");
+		}, a = L(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 = _n(i(t), e);
+			let n = X(i(t), e);
 			return n === void 0 || !new RegExp(String.raw`\b${n}\b`).test(a);
 		}).map((e) => e.name).sort();
 	} catch {
 		return [];
 	}
-}, vn = async (e) => {
+}, Ln = 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.");
 	}
-}, yn = async (e) => {
+}, Rn = async (e) => {
 	try {
-		let { loadApiConfig: t } = await import("./dev-DfVZaoys.js"), n = (await t(e))?.doctor?.scopeVocabulary;
+		let { loadApiConfig: t } = await import("./dev-Bl9HqtV7.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 +1941,10 @@ var le = /* @__PURE__ */ new Set([
 		findings: []
 	});
 	try {
-		let { offlineManifest: n, toInput: r } = await import("./checkCommand-DNkY5kwF.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-BISqx1OJ.js"), { buildAppGraph: i, checkAppGraph: a } = await import("./appGraph-CFmFKHb2.js"), o = await n(e), s = r(o.manifest, o.tables), c = await Rn(e), l = [.../* @__PURE__ */ new Set([...s.scopes ?? [], ...c])];
 		if (l.length === 0) {
 			try {
-				let { loadAppSchemaInputs: t } = await import("./frameworkTableAssembly-Df2Ymp2f.js");
+				let { loadAppSchemaInputs: t } = await import("./frameworkTableAssembly-B96WCNJA.js");
 				await t(e);
 			} catch {
 				return t("app-not-importable");
@@ -1760,7 +1968,7 @@ var le = /* @__PURE__ */ new Set([
 	} catch {
 		return t("app-not-importable");
 	}
-}, bn = async (e) => {
+}, zn = async (e) => {
 	let { findings: t, evaluated: n, notEvaluated: r } = await Q(e);
 	if (!n) {
 		if (console.log(""), r === "app-not-importable") {
@@ -1775,7 +1983,43 @@ 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}`);
 	}
-}, xn = async (e) => {
+}, Bn = (e) => {
+	let t = v(e, "src");
+	if (!S(t)) return;
+	let n = [], r = (t, i = 0) => {
+		if (i > 12 || I.test(t)) return;
+		let a;
+		try {
+			a = w(t);
+		} catch {
+			return;
+		}
+		for (let o of a) {
+			let a = v(t, o), s;
+			try {
+				s = T(a);
+			} catch {
+				continue;
+			}
+			if (s.isDirectory()) {
+				r(a, i + 1);
+				continue;
+			}
+			if (!(!/\.(tsx?|css)$/.test(o) || /\.(test|spec)\./.test(o))) try {
+				n.push({
+					path: y(e, a).split("\\").join("/"),
+					source: C(a, "utf8")
+				});
+			} catch {}
+		}
+	};
+	r(t);
+	let i = yt(_t(n));
+	if (i.length !== 0) {
+		console.log("");
+		for (let e of i) console.log(e);
+	}
+}, Vn = async (e) => {
 	let t = ["src/locales", "locales"], n, r = [];
 	for (let i of t) {
 		let t = v(e, i);
@@ -1787,20 +2031,20 @@ var le = /* @__PURE__ */ new Set([
 	if (n === void 0 || r.length === 0) return;
 	let i = [];
 	try {
-		let { loadApiConfig: t } = await import("./dev-DfVZaoys.js");
+		let { loadApiConfig: t } = await import("./dev-Bl9HqtV7.js");
 		i = (await t(e))?.locales ?? [];
 	} catch {
 		return;
 	}
-	let a = He({
+	let a = We({
 		catalogCodes: r,
 		declaredLocales: i
 	});
 	if (a !== void 0) {
 		console.log("");
-		for (let e of Ue(a, n)) console.log(e);
+		for (let e of Ge(a, n)) console.log(e);
 	}
-}, Sn = async (e) => {
+}, Hn = async (e) => {
 	let t = v(e, "src");
 	if (!S(t)) return;
 	let n = !1, r = (e) => {
@@ -1819,9 +2063,9 @@ var le = /* @__PURE__ */ new Set([
 		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) => {
+}, Un = async (e) => {
 	try {
-		let { loadConfig: t } = await import("./webDev-1XpVnYkW.js"), n = (await t(e, { preferSource: !0 }))?.fonts;
+		let { loadConfig: t } = await import("./webDev-B6ZMX42w.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) {
@@ -1831,25 +2075,25 @@ var le = /* @__PURE__ */ new Set([
 		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) => {
+}, Wn = async (e) => {
 	let t = v(e, "src", "pages");
 	if (!S(t)) return !1;
 	let n = [];
 	try {
-		let { walkPagesTree: e } = await import("./webDev-1XpVnYkW.js");
+		let { walkPagesTree: e } = await import("./webDev-B6ZMX42w.js");
 		n = (await e(t)).pages.map((e) => e.pattern);
 	} catch {
 		return !1;
 	}
-	let r = Ge(e, n);
+	let r = qe(e, n);
 	if (r === void 0) return !1;
 	console.log("");
-	for (let e of Ke(r)) console.log(e);
+	for (let e of Je(r)) console.log(e);
 	return r.problems.length > 0;
-}, Tn = async (e) => {
-	let { discovered: t } = await U(e), n = [];
+}, Gn = async (e) => {
+	let { discovered: t } = await H(e), n = [];
 	try {
-		let { loadApiConfig: t } = await import("./dev-DfVZaoys.js");
+		let { loadApiConfig: t } = await import("./dev-Bl9HqtV7.js");
 		n = ((await t(e))?.plugins ?? []).map((e) => {
 			let t = (e.extendSchema?.tables ?? []).map((e) => {
 				let t = e;
@@ -1857,13 +2101,13 @@ var le = /* @__PURE__ */ new Set([
 					tableName: typeof t.tableName == "string" ? t.tableName : "",
 					renamedFrom: typeof t.renamedFrom == "string" ? t.renamedFrom : void 0
 				};
-			}).filter((e) => e.tableName !== ""), n = (e.rpcClientDescriptors ?? []).map((t) => typeof t.tag == "string" ? d(e, t.tag) : "").filter((e) => e !== ""), r = e.baseName ?? e.name;
+			}).filter((e) => e.tableName !== ""), n = (e.rpcClientDescriptors ?? []).map((t) => typeof t.tag == "string" ? p(e, t.tag) : "").filter((e) => e !== ""), r = e.baseName ?? e.name;
 			return {
 				plugin: e.name,
 				tables: t,
 				rpcTags: n,
-				canDisableTables: En.has(r),
-				canAlias: Dn.has(r)
+				canDisableTables: Kn.has(r),
+				canAlias: qn.has(r)
 			};
 		});
 	} catch {
@@ -1875,18 +2119,18 @@ var le = /* @__PURE__ */ new Set([
 		...t.mutations,
 		...t.actions,
 		...t.streams ?? []
-	].map((e) => String(e.descriptor.name)), i = ct(n, {
+	].map((e) => String(e.descriptor.name)), i = ut(n, {
 		tables: t.tables.map((e) => e.tableName),
 		rpcTags: r
 	});
 	console.log();
-	for (let e of lt(n, i)) console.log(e);
-}, En = /* @__PURE__ */ new Set([
+	for (let e of dt(n, i)) console.log(e);
+}, Kn = /* @__PURE__ */ new Set([
 	"@voltro/plugin-rbac",
 	"@voltro/plugin-audit",
 	"@voltro/plugin-notifications",
 	"aiFlows"
-]), Dn = /* @__PURE__ */ new Set([
+]), qn = /* @__PURE__ */ new Set([
 	"aiFlows",
 	"@voltro/plugin-audit",
 	"@voltro/plugin-billing",
@@ -1904,8 +2148,8 @@ var le = /* @__PURE__ */ new Set([
 	"@voltro/plugin-sso-saml",
 	"@voltro/plugin-storage",
 	"@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;
+]), $ = 20, Jn = async (e) => {
+	let t = await Yn(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(),
@@ -1917,15 +2161,15 @@ var le = /* @__PURE__ */ new Set([
 		},
 		unchecked: t.result.unchecked
 	};
-}, kn = async (e) => {
-	let { discovered: t } = await U(e), n = /* @__PURE__ */ new Map(), r = (e) => {
+}, Yn = async (e) => {
+	let { discovered: t } = await H(e), n = /* @__PURE__ */ new Map(), r = (e) => {
 		if (!n.has(e)) try {
 			n.set(e, C(e, "utf8"));
 		} catch {
 			n.set(e, "");
 		}
 		return n.get(e);
-	}, i = gn(e, r), a = /* @__PURE__ */ new Set();
+	}, i = In(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);
@@ -1957,12 +2201,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) ? N(C(s, "utf8")) : void 0, l = !1;
-	for (let t of R(e)) if (/\bsetRowFilter\s*[<(]/.test(r(t))) {
+	})), s = v(e, Y), c = S(s) ? j(C(s, "utf8")) : void 0, l = !1;
+	for (let t of L(e)) if (/\bsetRowFilter\s*[<(]/.test(r(t))) {
 		l = !0;
 		break;
 	}
-	let u = tt({
+	let u = rt({
 		executors: o,
 		guardVocabulary: i,
 		tenantScopedTables: t.tenantScopedTables,
@@ -1979,23 +2223,23 @@ var le = /* @__PURE__ */ new Set([
 		executorCount: o.length,
 		allowPath: s
 	};
-}, 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;
+}, Xn = async (e, t) => {
+	let { result: n, vocabulary: r, existing: i, reviewed: a, executorCount: o, allowPath: s, rowFilterRegistered: c } = await Yn(e), l = n.counts;
 	console.log(`\nauthz scan · ${o} executor(s)`);
-	let u = [...r].filter((e) => !Je.has(e)).sort();
+	let u = [...r].filter((e) => !Xe.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 = 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 (console.log(`  – accepted as recorded debt             ${String(f).padStart(4)}   (${Y})`), 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 = st(e, t);
+		return oe(s, ot(e, t), "utf8"), console.log(`\n${Y}: +${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);
-}, jn = async (e) => {
+	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 ${Y} 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 ${Y}.`), 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);
+}, Zn = async (e) => {
 	try {
-		let { loadApiConfig: t } = await import("./dev-DfVZaoys.js"), { decidedSchemaReport: n } = await import("./doctorDecidedSchema-BlbWgCD_.js"), r = await t(e);
+		let { loadApiConfig: t } = await import("./dev-Bl9HqtV7.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 },
@@ -2004,42 +2248,42 @@ var le = /* @__PURE__ */ new Set([
 	} catch {
 		return null;
 	}
-}, Mn = async (e) => {
-	let t = await jn(e);
+}, Qn = async (e) => {
+	let t = await Zn(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}`);
 	}
-}, 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());
+}, $n = async (e) => {
+	if (e.includes("--help") || e.includes("-h")) return console.log(bn), 0;
+	let t = e.includes("--strict"), n = e.find((e) => !e.startsWith("-")), a = b(n ?? process.cwd());
 	if (g(e)) return ee(), h({
-		...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)
+		...R(a),
+		spaCandidates: await z(a),
+		pageConvention: B(a),
+		fileTaxonomy: re(a).findings,
+		junctionFks: (await U(a))?.issues ?? [],
+		eventDelivery: await W(a),
+		duplicateInstances: i(a),
+		versionSkew: o(a) ?? null,
+		serverOnly: (await K(a)).status,
+		accessDecisions: await q(a),
+		webhookVerification: await J(a),
+		authz: await Jn(a),
+		ungrantedScopes: await Q(a),
+		neverEmittedEvents: await Z(a),
+		unimportedDeps: He(a),
+		stalledRuns: await Nn(a),
+		decidedSchema: await Zn(a)
 	}), 0;
-	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));
+	let s = Ct(a, t);
+	sn(a), on(a), yn(a), ne(a), await pn(a), await Fn(a), await Pn(a), await Sn(a), await Dn(a), await En(a), await Qn(a), await On(a), await Gn(a), await zn(a), await Ln(a), console.log("");
+	for (let e of Ue(He(a))) console.log(e);
+	await Vn(a), Bn(a), await Hn(a), await Un(a);
+	let c = await Mn(a), l = await Xn(a, e.includes("--write-authz-allowlist")), d = await kn(a), f = await jn(a), p = await Wn(a), m = r(o(a));
 	m !== void 0 && (console.log(""), console.log(m));
-	let _ = i(s(o));
-	return _ !== void 0 && console.log(`\n${_}`), l || u || d || p || f ? Math.max(c, 1) : c;
+	let _ = u(i(a));
+	return _ !== void 0 && console.log(`\n${_}`), c || l || d || p || f ? Math.max(s, 1) : s;
 };
 //#endregion
-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 };
+export { z as C, J as D, Q as E, B as S, Rt as T, yn as _, Jn as a, Ct as b, W as c, Qt as d, xt as f, sn as g, on as h, q as i, In as l, wn as m, St as n, Z as o, U as p, cn as r, X as s, bn as t, R as u, pn as v, K as w, $t as x, $n as y };