@voltro/cli 0.33.0 → 0.35.0

package/dist/agentsMd-mhQMF1bx.js

@@ -0,0 +1,254 @@
+import { t as e } from "./cliRuntime-Dh7UDinH.js";
+import { dirname as t, join as n, resolve as r } from "node:path";
+import { fileURLToPath as i, pathToFileURL as a } from "node:url";
+import { Effect as o } from "effect";
+import { FileSystem as s } from "@effect/platform";
+import { NodeContext as c } from "@effect/platform-node";
+//#region src/agentsMd.ts
+var l = t(i(import.meta.url)), u = [r(l, "..", "templates"), r(l, "..", "..", "templates")], d = (e) => ({
+	_tag: "TemplateNotFoundError",
+	searched: e
+}), f = ["AGENTS.md", "CLAUDE.md"], p = "voltro:agents-md:keep", m = 2048, h = "<!-- VOLTRO:INDEX -->", g = (e) => /^#\s*What's new in\s+(\d+\.\d+\.\d+[^\s]*)\s*$/m.exec(e)?.[1] ?? null, _ = (e) => e.templatesVersion !== null && e.installedVersion !== null && e.templatesVersion !== e.installedVersion, v = (e, t) => e.exists(t).pipe(o.orElseSucceed(() => !1)), y = (e, t) => e.readFileString(t).pipe(o.orElseSucceed(() => "")), b = (e, t) => e.readFileString(t).pipe(o.map((e) => {
+	try {
+		return JSON.parse(e).workspaces !== void 0;
+	} catch {
+		return !1;
+	}
+}), o.orElseSucceed(() => !1)), x = (e) => o.gen(function* () {
+	let i = yield* s.FileSystem, a = r(e);
+	for (;;) {
+		if ((yield* v(i, n(a, ".git"))) || (yield* v(i, n(a, "pnpm-workspace.yaml"))) || (yield* b(i, n(a, "package.json")))) return a;
+		let o = t(a);
+		if (o === a) return r(e);
+		a = o;
+	}
+}), S = (e, t, r) => o.gen(function* () {
+	yield* e.makeDirectory(r, { recursive: !0 }).pipe(o.orElseSucceed(() => void 0));
+	let i = yield* e.readDirectory(t).pipe(o.orElseSucceed(() => []));
+	for (let a of i) {
+		let i = n(t, a), s = n(r, a);
+		(yield* e.stat(i).pipe(o.orElseSucceed(() => null)))?.type === "Directory" ? yield* S(e, i, s) : yield* e.copyFile(i, s).pipe(o.orElseSucceed(() => void 0));
+	}
+}), C = (e) => typeof e?.name == "string" && e.name.length > 0 ? e.name.split("#")[0] : null, w = (e, t) => o.gen(function* () {
+	let r = n(t, "app.config.ts");
+	if (!(yield* v(e, r))) return null;
+	let i = (yield* o.tryPromise(() => import(a(r).href)).pipe(o.orElseSucceed(() => null)))?.default;
+	return !i || i.type && i.type !== "api" ? i?.type === "web" ? [] : null : (i.plugins ?? []).map(C).filter((e) => e !== null);
+}), T = (e, t) => o.gen(function* () {
+	let r = [], i = [], a = n(t, "apps");
+	if (!(yield* v(e, a))) return {
+		apis: r,
+		webs: i
+	};
+	for (let t of yield* e.readDirectory(a).pipe(o.orElseSucceed(() => []))) {
+		let s = n(a, t);
+		if ((yield* e.stat(s).pipe(o.orElseSucceed(() => null)))?.type === "Directory") for (let t of yield* e.readDirectory(s).pipe(o.orElseSucceed(() => []))) {
+			let a = n(s, t), o = n(a, "app.config.ts");
+			if (!(yield* v(e, o))) continue;
+			let c = yield* y(e, o);
+			/type:\s*['"]web['"]/.test(c) ? i.push(a) : r.push(a);
+		}
+	}
+	return {
+		apis: r,
+		webs: i
+	};
+}), E = (e) => e.replace(/\|/g, "\\|").replace(/\n/g, " ").trim(), D = (e, t, n) => {
+	let r = [
+		"<!-- voltro agent-docs index — regenerated at seed time -->",
+		"## Deep reference (read on demand)",
+		"",
+		"Each row is a file to OPEN when you work on that topic — not loaded into",
+		"context by default. Paths are from the repo root.",
+		"",
+		"### Topics",
+		"",
+		"| Topic | Open | Summary |",
+		"|---|---|---|",
+		...e.modules.map((e) => `| ${e.title} | \`${n}${e.path}\` | ${E(e.description)} |`),
+		""
+	], i = new Map(e.plugins.map((e) => [e.pkg, e])), a = (e, t) => e.module === void 0 ? `\`node_modules/${t}/README.md\`` : `\`${n}${e.module}\` (or \`node_modules/${t}/README.md\`)`, o = t === null ? e.plugins.map((e) => `| ${e.slug} | ${a(e, e.pkg)} | ${E(e.description)} |`) : t.map((e) => {
+		let t = i.get(e);
+		return t ? `| ${t.slug} | ${a(t, e)} | ${E(t.description)} |` : `| ${e.replace(/^@[^/]+\//, "")} | \`node_modules/${e}/README.md\` | (see plugin README) |`;
+	});
+	return r.push(`### Plugins${t === null ? "" : " (installed)"}`, "", "| Plugin | Open | Summary |", "|---|---|---|"), r.push(o.length ? o.join("\n") : "| _(none installed)_ | | |", ""), r.join("\n");
+}, O = (e, t, n) => {
+	let r = t.templates?.[e] ?? t.templates?.[e.replace(/^frontend-/, "")];
+	return `\nScaffolded from the \`${e}\` template — see \`${r ? `${n}${r}` : `${n}agent-docs/templates/overview.md`}\`.\n`;
+}, k = {
+	api: (e, t, n = "") => `# api — agent notes
+
+You are in a Voltro **api** app. Server primitives live here: \`queries/\`,
+\`mutations/\`, \`actions/\`, \`workflows/\`, \`database/\`, \`schedules/\`.
+
+- Every RPC primitive is a descriptor + \`*.server.ts\` executor pair. Descriptors
+  are **browser-loaded** — keep them free of \`node:*\` / \`@voltro/database\` /
+  server-only imports (transitively too).
+- Pick the primitive with the rubric in the repo-root \`AGENTS.md\`.
+
+Deep reference (paths from the repo root):
+- Data primitives → \`${e}agent-docs/data.md\`
+- Schema / queries → \`${e}agent-docs/database/schema.md\`, \`${e}agent-docs/database/querying.md\`
+- Workflows → \`${e}agent-docs/workflows.md\`
+${t && t.length ? `\nThis api's plugins: ${t.join(", ")} (API in each \`node_modules/<pkg>/README.md\`).` : ""}
+${n}`,
+	database: (e) => `# database — agent notes
+
+Schema lives here: one table per \`*.entity.ts\`; \`index.ts\` builds the handle.
+
+- Mixins compose via \`.with(...)\` and auto-stamp columns; declare \`.index([...])\`
+  AFTER \`.with(...)\`. Indexes are table-level (no column-level \`.index()\`).
+- Don't add tenant filters on \`tenant()\` tables — the runtime does it.
+
+Deep reference (paths from the repo root): \`${e}agent-docs/database/schema.md\`,
+\`${e}agent-docs/database/columntypes.md\`, \`${e}agent-docs/database/querying.md\`,
+\`${e}agent-docs/database/migrations.md\`.
+`,
+	web: (e, t = "") => `# web — agent notes
+
+You are in a Voltro **web** app. File-based routing under \`src/pages/**\`.
+
+- Use \`useSubscription\` / \`useMutation\` / \`useAction\` from \`@voltro/client\`.
+- Never read \`window.location\` (use \`useLocation()\`); never toggle \`dark\` from
+  \`useEffect\` (set \`theme\` in \`app.config.ts\`).
+
+Deep reference (paths from the repo root): \`${e}agent-docs/routing.md\`,
+\`${e}agent-docs/schema-driven-ui.md\`, \`${e}agent-docs/internationalization.md\`.
+${t}`
+}, A = [
+	{
+		name: "voltro-schema",
+		description: "Define or change a Voltro database table/schema (columns, mixins, indexes, relations).",
+		module: "database/schema.md"
+	},
+	{
+		name: "voltro-data",
+		description: "Write a Voltro query, mutation, action, or stream (the descriptor + server executor pair).",
+		module: "data.md"
+	},
+	{
+		name: "voltro-workflows",
+		description: "Write or debug a durable Voltro workflow (steps, signals, retries).",
+		module: "workflows.md"
+	},
+	{
+		name: "voltro-routing",
+		description: "Add or change a Voltro web page, layout, loader, or render mode.",
+		module: "routing.md"
+	},
+	{
+		name: "voltro-plugins",
+		description: "Wire a Voltro plugin (storage, mail, billing, auth, rbac, …) into an app.",
+		module: "plugins.md"
+	},
+	{
+		name: "voltro-data-transfer",
+		description: "Export/import + backup/restore Voltro data & assets, and copy prod→dev/stage SAFELY with fail-closed masking/anonymization (.sensitive()/.safe()) + referential subsetting. Use for data takeout, seeding lower envs, backups, or cross-dialect moves.",
+		module: "cli.md"
+	}
+], j = (e, t) => `---
+name: ${e.name}
+description: ${e.description}
+---
+
+Open the full reference and follow the patterns there:
+
+\`${t}agent-docs/${e.module}\`
+
+Also read the repo-root \`AGENTS.md\` for the always-true rules (browser/server
+boundary, naming, anti-patterns) before editing.
+`, M = (e, n, r, i) => o.gen(function* () {
+	let a = yield* v(e, n);
+	if (a) {
+		if ((yield* y(e, n)).slice(0, m).includes("voltro:agents-md:keep")) return {
+			path: n,
+			action: "protected"
+		};
+		if (!i) return {
+			path: n,
+			action: "present"
+		};
+	}
+	return yield* e.makeDirectory(t(n), { recursive: !0 }).pipe(o.orElseSucceed(() => void 0)), yield* e.writeFileString(n, r).pipe(o.orDie), {
+		path: n,
+		action: a ? "overwritten" : "created"
+	};
+}), N = (e, t = {}) => o.gen(function* () {
+	let i = yield* s.FileSystem, a = yield* x(e), c = null;
+	for (let e of u) if (yield* v(i, n(e, "AGENTS.core.md"))) {
+		c = e;
+		break;
+	}
+	if (c === null) {
+		for (let e of u) if (yield* v(i, n(e, "AGENTS.md"))) {
+			let r = yield* y(i, n(e, "AGENTS.md")), o = [];
+			for (let e of f) o.push(yield* M(i, n(a, e), r, t.force ?? !1));
+			return { files: o };
+		}
+		return yield* o.fail(d(u.map((e) => n(e, "AGENTS.core.md"))));
+	}
+	let l = yield* y(i, n(c, "AGENTS.core.md")), p = yield* y(i, n(c, "agent-docs", "_manifest.json")), _ = p ? JSON.parse(p) : {
+		modules: [],
+		plugins: []
+	}, b = (t.preferPointer ?? !1) || (yield* v(i, n(a, "node_modules/@voltro/cli/templates/agent-docs", "_manifest.json"))), E = b ? "node_modules/@voltro/cli/templates/" : "", N = t.force ?? !1, P = (e) => y(i, e).pipe(o.map((e) => {
+		if (!e) return null;
+		try {
+			return JSON.parse(e).version ?? null;
+		} catch {
+			return null;
+		}
+	})), F = {
+		templatesVersion: yield* P(n(c, "..", "package.json")),
+		installedVersion: yield* P(n(a, "node_modules", "@voltro", "cli", "package.json")),
+		whatsNewVersion: g(yield* y(i, n(c, "agent-docs", "whats-new.md"))),
+		copiedIn: !b
+	}, I = f.map((e) => n(a, e));
+	if ((yield* o.forEach(I, (e) => y(i, e).pipe(o.map((e) => e.slice(0, m))))).every((e) => e.includes("voltro:agents-md:keep"))) return {
+		files: I.map((e) => ({
+			path: e,
+			action: "protected"
+		})),
+		provenance: F
+	};
+	let { apis: L, webs: R } = yield* T(i, a), z = /* @__PURE__ */ new Map(), B = /* @__PURE__ */ new Set(), V = !1;
+	for (let e of L) {
+		let t = yield* w(i, e);
+		if (z.set(e, t), t !== null) {
+			V = !0;
+			for (let e of t) B.add(e);
+		}
+	}
+	let H = t.plugins ? t.plugins.map(C).filter((e) => e !== null) : V ? [...B] : null, U = l.includes(h) ? l.replace(h, D(_, H, E)) : l, W = [];
+	for (let e of I) W.push(yield* M(i, e, U, N));
+	b || (yield* S(i, n(c, "agent-docs"), n(a, "agent-docs")));
+	let G = new Map((t.appTemplates ?? []).map((e) => [r(e.dir), e.template])), K = (e) => {
+		let t = G.get(r(e));
+		return t ? O(t, _, E) : "";
+	}, q = (e, t) => o.forEach(f, (r) => M(i, n(e, r), t, N));
+	for (let e of L) W.push(...yield* q(e, k.api(E, z.get(e) ?? null, K(e)))), (yield* v(i, n(e, "database"))) && W.push(...yield* q(n(e, "database"), k.database(E)));
+	for (let e of R) W.push(...yield* q(e, k.web(E, K(e))));
+	for (let e of A) W.push(yield* M(i, n(a, ".claude", "skills", e.name, "SKILL.md"), j(e, E), N));
+	return {
+		files: W,
+		provenance: F
+	};
+}), P = (e, t = {}) => o.runPromise(N(e, t).pipe(o.provide(c.layer))), F = async (t) => {
+	let n = t.includes("--force"), r = t.find((e) => !e.startsWith("-")) ?? process.cwd();
+	return e(o.gen(function* () {
+		let e = yield* N(r, { force: n });
+		for (let t of e.files) {
+			let e = t.action === "created" ? "wrote" : t.action === "overwritten" ? "overwrote" : t.action === "protected" ? `protected (hand-maintained — has "${p}")` : "present (use --force to overwrite)";
+			yield* o.logInfo(`${t.path.split("/").slice(-2).join("/")} ${e}`, { action: t.action });
+		}
+		let t = e.provenance;
+		return t !== void 0 && (yield* o.logInfo(`seeded from @voltro/cli ${t.templatesVersion ?? "unknown"} (project has ${t.installedVersion ?? "no resolvable @voltro/cli"}; whats-new describes ${t.whatsNewVersion ?? "unknown"}; modules ${t.copiedIn ? "COPIED into ./agent-docs" : "pointed at node_modules"})`, {
+			templates: t.templatesVersion,
+			installed: t.installedVersion,
+			whatsNew: t.whatsNewVersion
+		}), _(t) && (yield* o.logWarning(`the \`voltro\` binary that ran is ${t.templatesVersion}, but this project installs ${t.installedVersion} — everything just written describes the OLDER version. Run it through the project's own cli (\`pnpm exec voltro agents-md --force\`) so the guide matches what the app boots.`))), 0;
+	}).pipe(o.catchTag("TemplateNotFoundError", (e) => o.gen(function* () {
+		return yield* o.logError("AGENTS.md template not found", { searched: e.searched }), 1;
+	}))), { scope: "voltro:agents-md" });
+};
+//#endregion
+export { F as a, x as i, P as n, _ as o, N as r, g as s, p as t };

package/dist/apiBuild-B8aoJvuw.js

@@ -0,0 +1,2 @@
+import { c as e, l as t } from "./apiBuild-DYD_ONLD.js";
+export { e as runApiBuild, t as runServeBundleBuild };

package/dist/{apiBuild-h9VHtnlw.js → apiBuild-DYD_ONLD.js}

@@ -1,29 +1,29 @@
-import { bt as e } from "./inspectMetrics-1xzTKAFx.js";
-import { a as t } from "./seedRunner-Bqxgp7HZ.js";
-import { h as n } from "./dev-C_P8FLSx.js";
+import { f as e } from "./dev-C7sFZq3m.js";
+import { ut as t } from "./webDev-Dybxew86.js";
+import { t as n } from "./dialectDriver-CgXnDfec.js";
 import { dirname as r, isAbsolute as i, join as a, relative as o, resolve as s } from "node:path";
-import { fileURLToPath as c } from "node:url";
-import { createLogger as l } from "@voltro/logger";
-import { existsSync as u, promises as d } from "node:fs";
+import { existsSync as c, promises as l } from "node:fs";
+import { fileURLToPath as u } from "node:url";
+import { createLogger as d } from "@voltro/logger";
 import { createRequire as f } from "node:module";
 //#region src/apiBuild.ts
-var p = l({ scope: "voltro:build" }), m = (e) => {
-	let t = r(c(import.meta.url));
+var p = d({ scope: "voltro:build" }), m = (e) => {
+	let t = r(u(import.meta.url));
 	for (let n of [
 		".js",
 		".ts",
 		".mjs"
 	]) {
 		let r = a(t, `${e}${n}`);
-		if (u(r)) return { [`@voltro/cli/${e}`]: r };
+		if (c(r)) return { [`@voltro/cli/${e}`]: r };
 	}
 	return {};
 }, h = async (e) => {
-	let n = a(e, "package.json");
-	if (!u(n)) return [];
+	let t = a(e, "package.json");
+	if (!c(t)) return [];
 	let r = {};
 	try {
-		let e = JSON.parse(await d.readFile(n, "utf8"));
+		let e = JSON.parse(await l.readFile(t, "utf8"));
 		r = {
 			...e.dependencies,
 			...e.devDependencies,
@@ -32,8 +32,8 @@ var p = l({ scope: "voltro:build" }), m = (e) => {
 	} catch {
 		return [];
 	}
-	let i = f(n);
-	return t.filter((e) => {
+	let i = f(t);
+	return n.filter((e) => {
 		if (r[e] === void 0) return !1;
 		try {
 			return i.resolve(e), !0;
@@ -41,7 +41,7 @@ var p = l({ scope: "voltro:build" }), m = (e) => {
 			return !1;
 		}
 	});
-}, g = /(?:\.(?:query|mutation|action|stream)(?:\.server)?\.ts|\.workflow(?:\.server)?\.tsx|\.(?:subscribe|reaction|aggregate|agent|tool|webhook|cron|trigger|outbox|connection|email)(?:\.server)?\.tsx?|\.(?:startup|seed)\.tsx?|\.(?:entity|schema|relations|migration|event|expectation|budget|experiment)\.ts|(?:^|\/)schema\.ts)$/, _ = (e) => /\.(ts|tsx)$/.test(e) && !/\.(test|spec)\.[tj]sx?$/.test(e), v = async (e) => (await n(e)).filter((t) => g.test(t) && _(t) && !t.includes(`${e}/.framework/`)), y = {
+}, g = /(?:\.(?:query|mutation|action|stream)(?:\.server)?\.ts|\.workflow(?:\.server)?\.tsx|\.(?:subscribe|reaction|aggregate|agent|tool|webhook|cron|trigger|outbox|connection|email)(?:\.server)?\.tsx?|\.(?:startup|seed)\.tsx?|\.(?:entity|schema|relations|migration|event|expectation|budget|experiment)\.ts|(?:^|\/)schema\.ts)$/, _ = (e) => /\.(ts|tsx)$/.test(e) && !/\.(test|spec)\.[tj]sx?$/.test(e), v = async (t) => (await e(t)).filter((e) => g.test(e) && _(e) && !e.includes(`${t}/.framework/`)), y = {
 	name: "externalize-bare",
 	setup(e) {
 		e.onResolve({ filter: /.*/ }, (e) => {
@@ -52,12 +52,12 @@ var p = l({ scope: "voltro:build" }), m = (e) => {
 			};
 		});
 	}
-}, b = async (t) => {
-	let n = await e("esbuild", () => import("esbuild")), r = a(t, ".framework"), i = a(r, "dist-api");
-	await d.mkdir(r, { recursive: !0 });
-	let c = [...await v(t)], l = a(t, "app.config.ts");
-	if (u(l) && c.push(l), c.length === 0) return p.warn("api build: no handlers or app.config found — nothing to precompile", { root: t }), null;
-	let f = a(t, "tsconfig.json"), m = {
+}, b = async (e) => {
+	let n = await t("esbuild", () => import("esbuild")), r = a(e, ".framework"), i = a(r, "dist-api");
+	await l.mkdir(r, { recursive: !0 });
+	let u = [...await v(e)], d = a(e, "app.config.ts");
+	if (c(d) && u.push(d), u.length === 0) return p.warn("api build: no handlers or app.config found — nothing to precompile", { root: e }), null;
+	let f = a(e, "tsconfig.json"), m = {
 		bundle: !0,
 		format: "esm",
 		platform: "node",
@@ -65,27 +65,27 @@ var p = l({ scope: "voltro:build" }), m = (e) => {
 		logLevel: "silent",
 		jsx: "automatic",
 		jsxImportSource: "react",
-		absWorkingDir: t,
-		...u(f) ? { tsconfig: f } : {},
+		absWorkingDir: e,
+		...c(f) ? { tsconfig: f } : {},
 		plugins: [y]
 	}, h = await n.build({
 		...m,
-		entryPoints: c,
+		entryPoints: u,
 		write: !1,
 		metafile: !0,
 		outdir: i
-	}), g = Object.keys(h.metafile.inputs).map((e) => s(t, e)).filter((e) => e.startsWith(`${t}/`) && !e.includes("/node_modules/") && !e.includes("/.framework/") && _(e)), b = [
+	}), g = Object.keys(h.metafile.inputs).map((t) => s(e, t)).filter((t) => t.startsWith(`${e}/`) && !t.includes("/node_modules/") && !t.includes("/.framework/") && _(t)), b = [
 		"// GENERATED BY `voltro build` — do not edit; overwritten on next build.",
 		"// Precompiled api entry: the single bundle the serve runtime loads instead",
 		"// of importing every handler/schema source at boot. See apiBuild.ts /",
 		"// appModuleLoader.ts.",
 		""
 	], x = [];
-	g.forEach((e, n) => {
-		b.push(`import * as m${n} from ${JSON.stringify(e)}`), x.push(`  ${JSON.stringify(o(t, e))}: m${n},`);
+	g.forEach((t, n) => {
+		b.push(`import * as m${n} from ${JSON.stringify(t)}`), x.push(`  ${JSON.stringify(o(e, t))}: m${n},`);
 	}), b.push("", "export const modules: Record<string, unknown> = {", ...x, "}", "");
 	let S = a(r, "apiEntry.ts");
-	return await d.writeFile(S, b.join("\n"), "utf8"), await n.build({
+	return await l.writeFile(S, b.join("\n"), "utf8"), await n.build({
 		...m,
 		entryPoints: [S],
 		outfile: a(i, "apiEntry.js"),
@@ -148,7 +148,7 @@ const drivers = ${JSON.stringify(t)}\nlet mod\nfor (const d of drivers) {\n  try
 	let n = t - O, r = 0, i = async (e) => {
 		let t;
 		try {
-			t = await d.readdir(e, { withFileTypes: !0 });
+			t = await l.readdir(e, { withFileTypes: !0 });
 		} catch {
 			return;
 		}
@@ -159,31 +159,31 @@ const drivers = ${JSON.stringify(t)}\nlet mod\nfor (const d of drivers) {\n  try
 				continue;
 			}
 			try {
-				(await d.stat(t)).mtimeMs < n && (await d.rm(t, { force: !0 }), r += 1);
+				(await l.stat(t)).mtimeMs < n && (await l.rm(t, { force: !0 }), r += 1);
 			} catch {}
 		}
 	};
 	return await i(e), r;
-}, A = async (t) => {
-	let n = await e("esbuild", () => import("esbuild")), r = a(t, ".framework"), i = a(r, "dist-api", "serveBundle");
-	await d.mkdir(r, { recursive: !0 });
-	let c = Date.now(), l = [...await v(t)], f = a(t, "app.config.ts");
-	if (u(f) && l.push(f), l.length === 0) return null;
-	let g = a(t, "tsconfig.json"), b = await n.build({
-		entryPoints: l,
+}, A = async (e) => {
+	let n = await t("esbuild", () => import("esbuild")), r = a(e, ".framework"), i = a(r, "dist-api", "serveBundle");
+	await l.mkdir(r, { recursive: !0 });
+	let u = Date.now(), d = [...await v(e)], f = a(e, "app.config.ts");
+	if (c(f) && d.push(f), d.length === 0) return null;
+	let g = a(e, "tsconfig.json"), b = await n.build({
+		entryPoints: d,
 		bundle: !0,
 		write: !1,
 		metafile: !0,
 		format: "esm",
 		platform: "node",
-		absWorkingDir: t,
+		absWorkingDir: e,
 		jsx: "automatic",
 		jsxImportSource: "react",
 		logLevel: "silent",
 		plugins: [y],
 		outdir: a(i, ".probe"),
-		...u(g) ? { tsconfig: g } : {}
-	}), x = Object.keys(b.metafile.inputs).map((e) => s(t, e)).filter((e) => e.startsWith(`${t}/`) && !e.includes("/node_modules/") && !e.includes("/.framework/") && _(e)), S = await h(t), C = /* @__PURE__ */ new Set(), w = [
+		...c(g) ? { tsconfig: g } : {}
+	}), x = Object.keys(b.metafile.inputs).map((t) => s(e, t)).filter((t) => t.startsWith(`${e}/`) && !t.includes("/node_modules/") && !t.includes("/.framework/") && _(t)), S = await h(e), C = /* @__PURE__ */ new Set(), w = [
 		"// GENERATED BY `voltro build` — do not edit; overwritten on next build.",
 		"import { join as __join, dirname as __dirname, resolve as __resolve } from 'node:path'",
 		"import { pathToFileURL as __pathToFileURL, fileURLToPath as __fileURLToPath } from 'node:url'",
@@ -193,14 +193,14 @@ const drivers = ${JSON.stringify(t)}\nlet mod\nfor (const d of drivers) {\n  try
 		"if (__isMain) process.chdir(__resolve(__dirname(__fileURLToPath(import.meta.url)), '..', '..', '..'))",
 		"const __root = process.cwd()",
 		"registerAppModules({",
-		...x.map((e) => `  [__join(__root, ${JSON.stringify(o(t, e))})]: () => import(${JSON.stringify(e)}),`),
+		...x.map((t) => `  [__join(__root, ${JSON.stringify(o(e, t))})]: () => import(${JSON.stringify(t)}),`),
 		"})",
 		...S.map((e, t) => `registerDriver(${JSON.stringify(e)}, __drv${t})`),
 		"export const runServe = (args = []) => { loadDotEnv([]); return __runServe(args) }",
 		"if (__isMain) runServe(process.argv.slice(2)).then((c) => process.exit(typeof c === 'number' ? c : 0))",
 		""
 	], T = a(r, "serveEntry.ts");
-	await d.writeFile(T, w.join("\n"), "utf8"), await n.build({
+	await l.writeFile(T, w.join("\n"), "utf8"), await n.build({
 		entryPoints: [T],
 		bundle: !0,
 		format: "esm",
@@ -209,16 +209,16 @@ const drivers = ${JSON.stringify(t)}\nlet mod\nfor (const d of drivers) {\n  try
 		outdir: i,
 		splitting: !0,
 		write: !0,
-		plugins: [E(S, t, C)],
+		plugins: [E(S, e, C)],
 		banner: { js: "import { createRequire as __voltroRequire } from 'node:module'; const require = __voltroRequire(import.meta.url);" },
 		jsx: "automatic",
 		jsxImportSource: "react",
 		logLevel: "silent",
-		absWorkingDir: t,
+		absWorkingDir: e,
 		alias: m("serveEntry"),
-		...u(g) ? { tsconfig: g } : {}
+		...c(g) ? { tsconfig: g } : {}
 	});
-	let D = await k(i, c);
+	let D = await k(i, u);
 	return p.info("api build: serve bundle written", {
 		appModules: x.length,
 		drivers: S.length > 0 ? S.join(", ") : "none (memory)",

package/dist/{appGraph-gQ_6GkQQ.js → appGraph-KGDPTuTy.js}

@@ -31,7 +31,7 @@ var e = (e) => e.source === void 0 ? [] : typeof e.source == "string" ? [e.sourc
 			fix: `declare the scope '${e}' or fix the requireScope(...) call`,
 			severity: "error"
 		});
-		i.kind === "mutation" && i.hasGuards === !1 && n.push({
+		i.kind === "mutation" && i.hasGuards === !1 && i.openAccess === void 0 && n.push({
 			rule: "rbac/unguarded-mutation",
 			node: `${i.kind}(${i.tag})`,
 			...i.file === void 0 ? {} : { file: i.file },

package/dist/appGraph-zuMGKVYX.js

@@ -0,0 +1,2 @@
+import { n as e, t } from "./appGraph-KGDPTuTy.js";
+export { t as buildAppGraph, e as checkAppGraph };

package/dist/appPort-B_HpJ_ck.js

@@ -0,0 +1,48 @@
+//#region src/appPort.ts
+var e = 4e3, t = 5173, n = (e) => {
+	if (e === void 0 || e === "") return;
+	let t = typeof e == "number" ? e : Number(e);
+	if (!(!Number.isInteger(t) || t < 1 || t > 65535)) return t;
+}, r = (r) => {
+	let i = r.env ?? {}, a = [], o = (e, t) => {
+		if (e === void 0 || e === "") return;
+		let r = n(e);
+		if (r === void 0) {
+			a.push(`${t}=${JSON.stringify(String(e))} is not a port (1-65535) — ignored`);
+			return;
+		}
+		return r;
+	};
+	if (r.dashboardPin === !0) {
+		let e = o(i.VOLTRO_DASHBOARD_PORT, "VOLTRO_DASHBOARD_PORT");
+		if (e !== void 0) return {
+			port: e,
+			source: "dashboard-pin",
+			warnings: a
+		};
+	}
+	let s = o(i.PORT, "PORT");
+	if (s !== void 0) return {
+		port: s,
+		source: "env",
+		warnings: a
+	};
+	let c = o(r.flagPort, "--port");
+	if (c !== void 0) return {
+		port: c,
+		source: "flag",
+		warnings: a
+	};
+	let l = o(r.configPort, "app.config.ts port");
+	return l === void 0 ? {
+		port: r.kind === "api" ? e : t,
+		source: "default",
+		warnings: a
+	} : {
+		port: l,
+		source: "config",
+		warnings: a
+	};
+};
+//#endregion
+export { t as n, r, e as t };

package/dist/baselineCommand-C2ClWZN3.js

@@ -0,0 +1,2 @@
+import { o as e } from "./baselineCommand-DIttzO8A.js";
+export { e as runBaselineCommand };