@voltro/cli 0.33.0 → 0.34.0

package/dist/projectScaffold-LMMtaavR.js

@@ -0,0 +1,814 @@
+import { a as e, i as t, n, r, t as i } from "./templates-De8IR5-c.js";
+import { i as a, n as o, t as s } from "./cloudClient-DWL-Hw_T.js";
+import { t as c } from "./cliRuntime-Dh7UDinH.js";
+import { n as l } from "./agentsMd-mhQMF1bx.js";
+import { n as u } from "./addCommand-BNeoeSxe.js";
+import { a as d, n as f, r as p } from "./baselineCommand-DIttzO8A.js";
+import { basename as m, dirname as h, join as g, resolve as _ } from "node:path";
+import { existsSync as v, mkdirSync as y, promises as b, writeFileSync as x } from "node:fs";
+import { createLogger as S } from "@voltro/logger";
+import { Effect as C } from "effect";
+import { execFile as w } from "node:child_process";
+import { promisify as T } from "node:util";
+import { createInterface as E } from "node:readline/promises";
+import { stdin as D, stdout as O } from "node:process";
+//#region src/cloudScan.ts
+var k = () => ({
+	queries: [],
+	mutations: [],
+	actions: [],
+	streams: [],
+	workflows: [],
+	schedules: [],
+	subscribers: [],
+	aggregates: [],
+	agents: [],
+	tools: [],
+	tables: [],
+	webhooks: [],
+	restRoutes: [],
+	plugins: [],
+	pageCount: 0
+}), A = /* @__PURE__ */ new Set([
+	"node_modules",
+	".framework",
+	".git",
+	"dist",
+	"build",
+	".next",
+	".turbo",
+	"coverage"
+]), j = (e) => {
+	if (/\.server\.(ts|tsx)$/.test(e) || /\.(test|spec)\.(ts|tsx)$/.test(e) || /\.generated\./.test(e)) return null;
+	let t = (t) => e.slice(0, -t.length);
+	return e.endsWith(".query.ts") ? {
+		key: "queries",
+		name: t(".query.ts")
+	} : e.endsWith(".mutation.ts") ? {
+		key: "mutations",
+		name: t(".mutation.ts")
+	} : e.endsWith(".action.ts") ? {
+		key: "actions",
+		name: t(".action.ts")
+	} : e.endsWith(".stream.ts") ? {
+		key: "streams",
+		name: t(".stream.ts")
+	} : e.endsWith(".workflow.tsx") ? {
+		key: "workflows",
+		name: t(".workflow.tsx")
+	} : e.endsWith(".cron.tsx") ? {
+		key: "schedules",
+		name: t(".cron.tsx")
+	} : e.endsWith(".subscribe.ts") ? {
+		key: "subscribers",
+		name: t(".subscribe.ts")
+	} : e.endsWith(".aggregate.ts") ? {
+		key: "aggregates",
+		name: t(".aggregate.ts")
+	} : e.endsWith(".agent.tsx") ? {
+		key: "agents",
+		name: t(".agent.tsx")
+	} : e.endsWith(".tool.tsx") ? {
+		key: "tools",
+		name: t(".tool.tsx")
+	} : e.endsWith(".webhook.tsx") ? {
+		key: "webhooks",
+		name: t(".webhook.tsx")
+	} : e.endsWith(".route.tsx") ? {
+		key: "restRoutes",
+		name: t(".route.tsx")
+	} : e.endsWith(".entity.ts") && !e.startsWith("_") ? {
+		key: "tables",
+		name: t(".entity.ts")
+	} : null;
+}, M = /* @__PURE__ */ new Set([
+	"layout.tsx",
+	"error.tsx",
+	"loading.tsx",
+	"not-found.tsx"
+]), N = async (e, t, n = e) => {
+	let r;
+	try {
+		r = await b.readdir(e, { withFileTypes: !0 });
+	} catch {
+		return;
+	}
+	for (let i of r) {
+		if (i.name.startsWith(".") && i.name !== "." && A.has(i.name) || A.has(i.name)) continue;
+		let r = g(e, i.name), a = r.slice(n.length + 1).split("\\").join("/");
+		i.isDirectory() ? await N(r, t, n) : i.isFile() && t(i.name, r, a);
+	}
+}, ee = async (e) => {
+	let t;
+	try {
+		t = JSON.parse(await b.readFile(g(e, "package.json"), "utf8"));
+	} catch {
+		return null;
+	}
+	let n = {
+		...t.devDependencies,
+		...t.dependencies
+	}, r = n["@voltro/runtime"] ?? n["@voltro/cli"] ?? n["@voltro/protocol"] ?? n["@voltro/web"];
+	if (r === void 0) return null;
+	let i = r.match(/^[\^~]?(\d+\.\d+\.\d+(?:-[0-9A-Za-z.]+)?)$/);
+	if (i) return i[1];
+	for (let t of [
+		"@voltro/runtime",
+		"@voltro/cli",
+		"@voltro/protocol"
+	]) try {
+		let n = JSON.parse(await b.readFile(g(e, "node_modules", t, "package.json"), "utf8"));
+		if (typeof n.version == "string") return n.version;
+	} catch {}
+	return null;
+}, te = async (e) => {
+	let t;
+	try {
+		t = await b.readFile(g(e, "app.config.ts"), "utf8");
+	} catch {
+		return null;
+	}
+	return {
+		name: t.match(/name\s*:\s*['"]([^'"]+)['"]/)?.[1] ?? m(e),
+		kind: t.match(/type\s*:\s*['"]([^'"]+)['"]/)?.[1] === "web" ? "web" : "api",
+		plugins: [...new Set([...t.matchAll(/([a-zA-Z][a-zA-Z0-9]*Plugin)\s*\(/g)].map((e) => e[1]))].sort()
+	};
+}, ne = async (e) => {
+	let t = await te(e);
+	if (t === null) return null;
+	let n = k(), r = n;
+	await N(e, (e, t, n) => {
+		if ((n.startsWith("src/pages/") || n.includes("/src/pages/")) && e.endsWith(".tsx") && !M.has(e)) {
+			r.pageCount += 1;
+			return;
+		}
+		let i = j(e);
+		i !== null && r[i.key].push(i.name);
+	});
+	for (let e of Object.keys(n)) Array.isArray(r[e]) && (r[e] = [...new Set(r[e])].sort());
+	return r.plugins = t.plugins, {
+		slug: m(e),
+		name: t.name,
+		kind: t.kind,
+		voltroVersion: await ee(e),
+		primitives: n
+	};
+}, re = async (e, t = 5) => {
+	let n = [], r = async (e, i) => {
+		let a;
+		try {
+			a = await b.readdir(e, { withFileTypes: !0 });
+		} catch {
+			return;
+		}
+		if (a.some((e) => e.isFile() && e.name === "app.config.ts")) {
+			n.push(e);
+			return;
+		}
+		if (!(i >= t)) for (let t of a) t.isDirectory() && !A.has(t.name) && await r(g(e, t.name), i + 1);
+	};
+	return await r(e, 0), n.sort();
+}, P = async (e, t) => {
+	let n = await re(e), r = [];
+	for (let e of n) {
+		let t = await ne(e);
+		t !== null && r.push(t);
+	}
+	return {
+		scannedCommit: t,
+		apps: r
+	};
+}, F = 8e3, I = "not logged in — skipped cloud registration. The Voltro Cloud ToS requires projects + apps to be registered; run `voltro cloud login`, then re-run (or `voltro cloud project create` + `voltro cloud scan`).", ie = async (e) => await a() === null ? {
+	willRegister: !1,
+	lines: [
+		"→ cloud registration: skipped — not logged in, so nothing was sent from this machine.",
+		"  Registration is how SELF-HOSTED use is counted; the Voltro Cloud Terms of Service ask",
+		"  for projects and apps to be registered once you have an account.",
+		"  Register later:   voltro cloud login   then   voltro cloud scan",
+		"  Never ask again:  scaffold with --no-register"
+	]
+} : {
+	willRegister: !0,
+	lines: [
+		`→ registering project '${e}' with ${s()} (self-hosted usage tracking, ToS-governed)`,
+		"  Sends: the project slug, and per app its name, kind, framework version and the NAMES of",
+		"         declared primitives (queries, mutations, tables, plugins, …) plus a page count.",
+		"  Never sends: source code, row data, environment values or secrets.",
+		"  Skip with --no-register."
+	]
+}, ae = (e, t) => e === 409 || /already|exist|duplicate|unique/i.test(t), oe = async (e, t) => {
+	let n = await a();
+	if (n === null) return {
+		kind: "skipped",
+		message: I
+	};
+	let r = await o("/projects", {
+		method: "POST",
+		token: n.token,
+		timeoutMs: F,
+		body: {
+			slug: e,
+			...t === void 0 ? {} : { name: t }
+		}
+	});
+	if (r.kind === "ok") {
+		let t = r.data;
+		return {
+			kind: "registered",
+			message: `project '${e}' registered (${s()})`,
+			...typeof t?.id == "string" ? { projectId: t.id } : {}
+		};
+	}
+	return ae(r.status, r.error) ? {
+		kind: "registered",
+		message: `project '${e}' already registered`
+	} : r.status === 402 ? {
+		kind: "failed",
+		message: `project quota reached — ${r.error}`
+	} : {
+		kind: "failed",
+		message: `cloud project registration failed: ${r.error}`
+	};
+}, L = async (e, t) => {
+	let n = await a();
+	if (n === null) return {
+		kind: "skipped",
+		message: I
+	};
+	let r;
+	try {
+		r = await P(e, null);
+	} catch (e) {
+		return {
+			kind: "failed",
+			message: `inventory scan failed: ${e.message}`
+		};
+	}
+	if (r.apps.length === 0) return {
+		kind: "failed",
+		message: "no apps found to register"
+	};
+	let i = await o(`/projects/${encodeURIComponent(t)}/inventory`, {
+		method: "POST",
+		token: n.token,
+		timeoutMs: F,
+		body: r
+	});
+	return i.kind === "ok" ? {
+		kind: "registered",
+		message: `${r.apps.length} app(s) registered in the cloud`
+	} : {
+		kind: "failed",
+		message: `app registration failed: ${i.error}`
+	};
+}, R = S({ scope: "voltro:scaffold" }), se = T(w), z = (e) => {
+	let t = _(e);
+	for (let e = 0; e < 12; e++) {
+		if (v(g(t, "pnpm-workspace.yaml"))) return t;
+		let e = h(t);
+		if (e === t) break;
+		t = e;
+	}
+	return null;
+}, B = {
+	dev: "pnpm -r --parallel dev",
+	build: "pnpm -r build",
+	test: "pnpm -r test",
+	typecheck: "pnpm -r typecheck"
+}, V = {
+	"@types/node": "^26.1.2",
+	typescript: "^6.0.3"
+}, ce = JSON.stringify({ compilerOptions: {
+	target: "ES2024",
+	module: "ESNext",
+	moduleResolution: "Bundler",
+	lib: [
+		"ES2024",
+		"DOM",
+		"DOM.Iterable"
+	],
+	jsx: "react-jsx",
+	strict: !0,
+	noUncheckedIndexedAccess: !0,
+	exactOptionalPropertyTypes: !0,
+	esModuleInterop: !0,
+	skipLibCheck: !0,
+	resolveJsonModule: !0,
+	isolatedModules: !0,
+	allowImportingTsExtensions: !0,
+	noEmit: !0,
+	types: ["node"]
+} }, null, 2) + "\n", H = [
+	[
+		"esbuild",
+		!0,
+		"vite's compiler — its postinstall places the platform binary; the web app does not build without it"
+	],
+	[
+		"@parcel/watcher",
+		!1,
+		"optional native file-watcher; chokidar covers the same job in pure JS"
+	],
+	[
+		"msgpackr-extract",
+		!1,
+		"optional native accelerator for @effect/rpc's msgpackr; it falls back to JS"
+	]
+], le = `# Voltro workspace.
+#   apps/<project>/<app>       — the project's apps (api, web, …)
+#   packages/<name>            — repo-wide shared libraries
+#   packages/<project>/<name>  — project-scoped libraries
+packages:
+  - 'apps/*/*'
+  - 'packages/*'
+  - 'packages/*/*'
+
+# Which dependencies may run install scripts. pnpm asks about every undecided
+# one and (since pnpm 11) FAILS the install until you answer; these three come
+# from the framework's own dependency tree, so the answers ship with the
+# scaffold. Run \`pnpm approve-builds\` to revisit, or to answer a new one.
+allowBuilds:
+${H.map(([e, t, n]) => `  ${/^[a-z][a-z0-9-]*$/.test(e) ? e : `'${e}'`}: ${t}   # ${n}`).join("\n")}
+`, U = [
+	"node_modules/",
+	"dist/",
+	"build/",
+	"coverage/",
+	"*.tsbuildinfo",
+	".DS_Store",
+	".env",
+	".env.local",
+	".env.*.local",
+	".voltro/serverless/",
+	".voltro-baseline-backup/",
+	".framework/"
+], ue = `# Voltro workspace — build output, machine-local state, and secrets.
+# .env.local holds the per-project secrets \`voltro dev\` mints; never commit it.
+${U.join("\n")}
+`, de = () => {
+	let e = process.env.npm_config_user_agent;
+	if (!e) return null;
+	let t = /(^|\s)pnpm\/(\d+\.\d+\.\d+)/.exec(e);
+	return t ? `pnpm@${t[2]}` : null;
+}, fe = (e) => {
+	let t = _(e);
+	for (let e = 0; e < 24; e++) {
+		if (v(g(t, ".git"))) return !0;
+		let e = h(t);
+		if (e === t) return !1;
+		t = e;
+	}
+	return !1;
+}, W = async (e) => {
+	let n = z(e), r = n ?? _(e), i = [];
+	n || (y(r, { recursive: !0 }), await b.writeFile(g(r, "pnpm-workspace.yaml"), le, "utf8"), i.push("pnpm-workspace.yaml"));
+	let a = g(r, "package.json");
+	if (v(a)) {
+		let e = JSON.parse(await b.readFile(a, "utf8")), t = { ...e.scripts ?? {} }, n = { ...e.devDependencies ?? {} }, r = !1;
+		for (let [e, n] of Object.entries(B)) t[e] === void 0 && (t[e] = n, r = !0);
+		for (let [t, i] of Object.entries(V)) n[t] !== void 0 || e.dependencies?.[t] !== void 0 || (n[t] = i, r = !0);
+		r && (e.scripts = t, e.devDependencies = n, await b.writeFile(a, JSON.stringify(e, null, 2) + "\n", "utf8"), i.push("package.json"));
+	} else {
+		let e = de(), n = {
+			name: t(m(r)) || "voltro-workspace",
+			version: "0.0.0",
+			private: !0,
+			type: "module",
+			engines: {
+				node: ">=24.0.0",
+				pnpm: ">=10.0.0"
+			},
+			...e ? { packageManager: e } : {},
+			scripts: { ...B },
+			devDependencies: { ...V }
+		};
+		await b.writeFile(a, JSON.stringify(n, null, 2) + "\n", "utf8"), i.push("package.json");
+	}
+	let o = g(r, "tsconfig.base.json");
+	v(o) || (await b.writeFile(o, ce, "utf8"), i.push("tsconfig.base.json"));
+	let s = g(r, ".gitignore");
+	if (!v(s)) await b.writeFile(s, ue, "utf8"), i.push(".gitignore");
+	else {
+		let e = await b.readFile(s, "utf8"), t = new Set(e.split(/\r?\n/).map((e) => e.trim())), n = U.filter((e) => !t.has(e) && !t.has(`/${e}`));
+		if (n.length > 0) {
+			let t = e === "" || e.endsWith("\n") ? "" : "\n";
+			await b.writeFile(s, `${e}${t}\n# Voltro workspace\n${n.join("\n")}\n`, "utf8"), i.push(".gitignore");
+		}
+	}
+	let c = !1;
+	if (!fe(r)) try {
+		await se("git", ["init", "--quiet"], { cwd: r }), c = !0;
+	} catch {
+		R.warn("could not run `git init` — initialise version control yourself", { root: r });
+	}
+	return {
+		root: r,
+		written: i,
+		preexisting: n !== null,
+		gitInitialised: c
+	};
+}, G = (e) => e.length < 2 || e.length > 50 ? !1 : /^[a-z][a-zA-Z0-9]*$/.test(e) || /^[a-z][a-z0-9-]*[a-z0-9]$/.test(e) ? !0 : (/^[a-z]$/.test(e), !1), K = (e) => {
+	let t = [], n = {};
+	for (let r = 0; r < e.length; r++) {
+		let i = e[r];
+		if (i.startsWith("--")) {
+			let t = i.indexOf("=");
+			t >= 0 ? n[i.slice(2, t)] = i.slice(t + 1) : r + 1 < e.length && !e[r + 1].startsWith("--") ? n[i.slice(2)] = e[++r] : n[i.slice(2)] = !0;
+		} else t.push(i);
+	}
+	return {
+		positional: t,
+		flags: n
+	};
+}, pe = async (e, n) => {
+	let r = E({
+		input: D,
+		output: O
+	});
+	try {
+		for (;;) {
+			let i = (await r.question(`${e} [${n}]: `)).trim() || n;
+			if (!G(i)) {
+				console.log("  Invalid name: lowercase letters / digits / hyphens, max 50 chars, must start with a letter.");
+				continue;
+			}
+			return t(i);
+		}
+	} finally {
+		r.close();
+	}
+}, me = async (e) => {
+	let t = await r();
+	if (t.length === 0) return R.error("no templates found", { hint: "templates ship under packages/cli/templates/apps/" }), 1;
+	let n = Math.max(...t.map((e) => e.id.length), 2), i = Math.max(...t.map((e) => e.kind.length), 4);
+	console.log(`${"id".padEnd(n)}  ${"kind".padEnd(i)}  summary`), console.log(`${"-".repeat(n)}  ${"-".repeat(i)}  ${"-".repeat(60)}`);
+	for (let e of t) console.log(`${e.id.padEnd(n)}  ${e.kind.padEnd(i)}  ${e.summary}`);
+	return 0;
+}, q = {
+	start: 5190,
+	end: 5199
+}, J = (e) => Number.isInteger(e.start) && Number.isInteger(e.end) && e.start >= 1024 && e.end <= 65535 && e.end >= e.start, Y = async (e) => {
+	let t = g(e, "project.json");
+	if (!v(t)) return null;
+	try {
+		return JSON.parse(await b.readFile(t, "utf8"));
+	} catch {
+		return null;
+	}
+}, he = async (e, t) => {
+	let n = g(e, "project.json");
+	y(h(n), { recursive: !0 }), await b.writeFile(n, JSON.stringify(t, null, 2) + "\n", "utf8");
+}, X = async (e, t, n) => {
+	let r = g(e, "project.json");
+	if (v(r)) return;
+	let i = {
+		name: t,
+		description: `Project '${t}' scaffolded by the voltro CLI.`,
+		portRange: n,
+		apps: {}
+	};
+	y(h(r), { recursive: !0 }), x(r, JSON.stringify(i, null, 2) + "\n", "utf8");
+}, Z = async (e) => {
+	let t = await Y(e);
+	if (!t) return null;
+	let n = t.portRange ?? q, r = /* @__PURE__ */ new Set();
+	for (let e of Object.values(t.apps ?? {})) typeof e.port == "number" && r.add(e.port);
+	for (let e = n.start; e <= n.end; e++) if (!r.has(e)) return e;
+	return null;
+}, ge = async (e, t, n, r) => {
+	let i = g(e, "project.json"), a = { name: "unknown" };
+	if (v(i)) try {
+		a = JSON.parse(await b.readFile(i, "utf8"));
+	} catch {}
+	let o = { ...a.apps ?? {} };
+	o[t] = r === void 0 ? {
+		kind: n,
+		path: t
+	} : {
+		kind: n,
+		path: t,
+		port: r
+	};
+	let s = {
+		...a,
+		apps: o
+	};
+	await b.writeFile(i, JSON.stringify(s, null, 2) + "\n", "utf8");
+}, _e = (e, n) => {
+	let r = typeof n == "string" ? t(n) : void 0;
+	if (e.length > 1) return {
+		ok: !1,
+		error: `this monorepo hosts ${e.length} projects (${e.join(", ")}) — a monorepo must have exactly one`,
+		hint: "consolidate into one project (a monorepo = one cloud project); apps live inside it"
+	};
+	if (e.length === 1) {
+		let t = e[0];
+		return r !== void 0 && r !== t ? {
+			ok: !1,
+			error: `this monorepo already hosts project '${t}'; a monorepo has exactly one project`,
+			hint: `omit --to — apps always go into '${t}'`
+		} : {
+			ok: !0,
+			project: t
+		};
+	}
+	return r === void 0 ? {
+		ok: !1,
+		error: "no project in this monorepo yet",
+		hint: "run `voltro create-project <name>` first (a monorepo has exactly one project)"
+	} : {
+		ok: !0,
+		project: r
+	};
+}, Q = async (e) => v(e) ? (await b.readdir(e, { withFileTypes: !0 })).filter((e) => e.isDirectory()).map((e) => e.name) : [], ve = async (e, t) => {
+	let n = await Y(e) ?? { name: t.projectSlug };
+	await he(e, {
+		...n,
+		cloud: {
+			...n.cloud,
+			...t
+		}
+	});
+}, ye = (e, t) => {
+	let n = t.kind === "registered" ? "✓" : "⚠";
+	console.log(`  ${n} ${e}: ${t.message}`);
+}, be = async (e, t) => {
+	let n = (await Y(e))?.cloud?.projectSlug ?? t;
+	console.log();
+	let r = await ie(n);
+	for (let e of r.lines) console.log(e);
+	if (!r.willRegister) return;
+	let i = await oe(n);
+	ye("project", i), i.kind === "registered" && (await ve(e, {
+		projectSlug: n,
+		deploymentMode: "self_hosted",
+		registeredAt: (/* @__PURE__ */ new Date()).toISOString(),
+		...i.projectId === void 0 ? {} : { projectId: i.projectId }
+	}), ye("apps", await L(e, n)));
+}, xe = async (e, t) => {
+	let n = z(process.cwd());
+	if (!n) return {
+		ok: !1,
+		error: "no pnpm-workspace.yaml above the current directory — run `voltro init`, then `voltro create-project <name>`"
+	};
+	let r = g(n, "apps"), i = await Q(r);
+	if (i.length === 0) return {
+		ok: !1,
+		error: "no project in this monorepo — run `voltro create-project <name>` first, then link"
+	};
+	if (i.length > 1) return {
+		ok: !1,
+		error: `this monorepo hosts ${i.length} projects (${i.join(", ")}) — a monorepo must have exactly one`
+	};
+	let a = i[0], o = g(r, a);
+	return await ve(o, {
+		projectSlug: e,
+		deploymentMode: t?.deploymentMode ?? "self_hosted",
+		registeredAt: (/* @__PURE__ */ new Date()).toISOString(),
+		...t?.orgSlug === void 0 ? {} : { orgSlug: t.orgSlug },
+		...t?.projectId === void 0 ? {} : { projectId: t.projectId }
+	}), {
+		ok: !0,
+		projectDir: o,
+		projectName: a
+	};
+}, Se = async (r) => {
+	let { positional: a, flags: o } = K(r), s = a[0];
+	if (!s) return R.error("add-app: <appName> required", { usage: "voltro add-app <appName> --template <templateId> [--to <projectName>]" }), 2;
+	if (!G(s)) return R.error("add-app: invalid appName — use camelCase or kebab-case", { appName: s }), 2;
+	let c = o.template;
+	if (typeof c != "string") return R.error("add-app: --template <id> required", { hint: "run `voltro list-templates` to see available ids" }), 2;
+	let u = await n(c);
+	if (!u) return R.error("add-app: unknown template", {
+		templateId: c,
+		hint: "run `voltro list-templates` to see available ids"
+	}), 2;
+	let d = z(process.cwd());
+	if (!d) return R.error("add-app: no pnpm-workspace.yaml above the current directory — not a Voltro workspace", {
+		cwd: process.cwd(),
+		hint: "run `voltro init` to make this directory a workspace root, then `voltro create-project <name>`"
+	}), 2;
+	let f = g(d, "apps");
+	if (!v(f)) return R.error("add-app: apps/ root not found — no project scaffolded in this workspace yet", {
+		projectsRoot: f,
+		hint: "run `voltro create-project <name>` first"
+	}), 2;
+	let p = _e(await Q(f), typeof o.to == "string" ? o.to : void 0);
+	if (!p.ok) return R.error(`add-app: ${p.error}`, p.hint === void 0 ? {} : { hint: p.hint }), 2;
+	let m = p.project, h = g(f, m);
+	v(h) || (y(h, { recursive: !0 }), await X(h, m, q));
+	let _ = t(s), b = g(h, _);
+	if (v(b)) return R.error("add-app: target directory already exists", { targetDir: b }), 1;
+	let x = null;
+	if (u.kind === "web" && (x = await Z(h), x === null)) {
+		let e = (await Y(h))?.portRange ?? q;
+		return R.error("add-app: project portRange is exhausted", {
+			project: m,
+			range: `${e.start}-${e.end}`,
+			hint: "edit apps/<project>/project.json and widen portRange, or remove unused app entries"
+		}), 1;
+	}
+	let S = i(_, m, x ?? 0);
+	console.log(`→ scaffolding ${u.id} into ${b}${x === null ? "" : ` (port ${x})`}`);
+	let { written: C } = await e({
+		template: u,
+		targetDir: b,
+		vars: S
+	});
+	for (let e of C) console.log(`  · ${e}`);
+	return await ge(h, _, u.kind, x === null ? void 0 : x), await l(d, {
+		appTemplates: [{
+			dir: b,
+			template: u.id
+		}],
+		preferPointer: !0
+	}).catch(() => void 0), console.log(), console.log(`✓ app '${_}' added to project '${m}' from template '${u.id}'.`), o["no-register"] !== !0 && await be(h, m), console.log(), console.log("Next steps:"), console.log("  pnpm install"), u.kind === "serverless" ? (console.log(`  voltro serverless list  apps/${m}/${_}      # what would deploy`), console.log(`  voltro serverless dev   apps/${m}/${_}/...  # run one locally`), console.log("  voltro serverless deploy --target node|cloudflare|scaleway")) : u.kind === "mobile" ? (console.log("  voltro dev                                  # (in another shell) run the sibling api"), console.log(`  cd apps/${m}/${_}`), console.log("  pnpm ios        # or: pnpm android / pnpm start (Expo Go)"), console.log("  # set EXPO_PUBLIC_API_URL to your api's LAN address for a device/simulator")) : console.log(`  pnpm --filter @${m}/${_} dev`), 0;
+}, Ce = (e) => {
+	if (typeof e != "string") return null;
+	let t = /^(\d+)\s*(?:-|:|\.\.)\s*(\d+)$/.exec(e.trim());
+	if (!t) return null;
+	let n = {
+		start: Number(t[1]),
+		end: Number(t[2])
+	};
+	return J(n) ? n : null;
+}, we = (e) => {
+	let t = Ce(e["port-range"]);
+	return {
+		...typeof e.api == "string" ? { api: e.api } : e.api === !0 ? { api: "api-backend" } : {},
+		...typeof e.web == "string" ? { web: e.web } : e.web === !0 ? { web: "frontend-blank" } : {},
+		...typeof e.mobile == "string" ? { mobile: e.mobile } : e.mobile === !0 ? { mobile: "mobile-app" } : {},
+		...t ? { portRange: t } : {},
+		...typeof e.baseline == "string" ? { baseline: e.baseline } : {},
+		...e.cache === "redis" ? { cache: "redis" } : {},
+		noInput: e["no-input"] === !0
+	};
+}, Te = async () => {
+	let e = await d();
+	if (e.length === 0) return null;
+	let t = E({
+		input: D,
+		output: O
+	});
+	try {
+		console.log(), console.log("Pick a deploy baseline (or press Enter to skip):");
+		for (let t of e) console.log(`  ${t.id.padEnd(10)} ${t.displayName} — ${t.summary}`);
+		for (;;) {
+			let n = (await t.question("Baseline [skip]: ")).trim().toLowerCase();
+			if (n === "" || n === "skip") return null;
+			let r = e.find((e) => e.id === n);
+			if (r) return r.id;
+			console.log(`  Unknown baseline '${n}'. Pick one of: ${e.map((e) => e.id).join(", ")}.`);
+		}
+	} finally {
+		t.close();
+	}
+}, Ee = async (e) => {
+	let t = E({
+		input: D,
+		output: O
+	});
+	try {
+		for (;;) {
+			let n = (await t.question(`Port range for this project's web apps [${e.start}-${e.end}]: `)).trim();
+			if (n === "") return e;
+			let r = Ce(n);
+			if (r) return r;
+			console.log("  Invalid range. Use e.g. 5190-5199 (start ≥ 1024, end ≤ 65535, end ≥ start).");
+		}
+	} finally {
+		t.close();
+	}
+}, De = async (r) => {
+	let { positional: a, flags: o } = K(r), s = await W(process.cwd()), c = s.root;
+	if (!s.preexisting) {
+		console.log(`→ initialising workspace root ${c}`);
+		for (let e of s.written) console.log(`  · ${e}`);
+	} else if (s.written.length > 0) {
+		console.log(`→ workspace root ${c}`);
+		for (let e of s.written) console.log(`  · updated ${e}`);
+	}
+	s.gitInitialised && console.log(`  · git init (${c} was not in a repository)`);
+	let m = g(c, "apps"), h = await Q(m);
+	if (h.length > 0) return R.error("create-project: this monorepo already hosts a project — a monorepo has exactly one", {
+		existing: h,
+		hint: "use `voltro add-app <name> --template <id>` to add apps to the existing project"
+	}), 1;
+	v(m) || y(m, { recursive: !0 });
+	let _ = we(o), b = a[0] ?? "";
+	if (b && !G(b)) return R.error("create-project: invalid name", { name: b }), 2;
+	if (!b) {
+		if (_.noInput) return R.error("create-project: name required (use positional arg or run interactively)"), 2;
+		b = await pe("Project name", "my-project");
+	}
+	b = t(b);
+	let x = g(m, b);
+	if (v(x)) return R.error("create-project: target directory already exists", { projectDir: x }), 1;
+	let S = _.api ?? null, C = _.web ?? null, w = _.mobile ?? null;
+	if (!S && !C) if (_.noInput) S = "api-backend", C = "frontend-blank";
+	else {
+		let e = E({
+			input: D,
+			output: O
+		});
+		try {
+			let t = (await e.question("Scaffold apps/api (api-backend) and apps/web (frontend-blank)? [Y/n]: ")).trim().toLowerCase();
+			(t === "" || t === "y" || t === "yes") && (S = "api-backend", C = "frontend-blank");
+		} finally {
+			e.close();
+		}
+	}
+	let T = S ? await n(S) : null, k = C ? await n(C) : null, A = w ? await n(w) : null;
+	if (S && !T) return R.error("create-project: unknown api template", { template: S }), 2;
+	if (C && !k) return R.error("create-project: unknown web template", { template: C }), 2;
+	if (w && !A) return R.error("create-project: unknown mobile template", { template: w }), 2;
+	if (T && T.kind !== "api") return R.error("create-project: template kind mismatch", {
+		id: T.id,
+		kind: T.kind,
+		expected: "api"
+	}), 2;
+	if (k && k.kind !== "web") return R.error("create-project: template kind mismatch", {
+		id: k.id,
+		kind: k.kind,
+		expected: "web"
+	}), 2;
+	if (A && A.kind !== "mobile") return R.error("create-project: template kind mismatch", {
+		id: A.id,
+		kind: A.kind,
+		expected: "mobile"
+	}), 2;
+	if (!T && !k && !A) return R.error("create-project: need at least one of --api, --web or --mobile"), 2;
+	let j = q;
+	if (_.portRange ? j = _.portRange : _.noInput || (j = await Ee(q)), !J(j)) return R.error("create-project: invalid port range", { range: `${j.start}-${j.end}` }), 2;
+	console.log(`\n→ creating ${x}`), y(x, { recursive: !0 }), await X(x, b, j);
+	let M = async (t, n) => {
+		let r = g(x, t), a = null;
+		if (n.kind === "web" && (a = await Z(x), a === null)) throw Error(`port range ${j.start}-${j.end} exhausted before app '${t}' could be allocated`);
+		let o = i(t, b, a ?? 0);
+		console.log(`→ ${n.id} → ${t}/${a === null ? "" : ` (port ${a})`}`);
+		let { written: s } = await e({
+			template: n,
+			targetDir: r,
+			vars: o
+		});
+		for (let e of s) console.log(`  · ${t}/${e}`);
+		await ge(x, t, n.kind, a === null ? void 0 : a);
+	};
+	T && await M("api", T), k && await M("web", k), A && await M("mobile", A), await l(c, {
+		appTemplates: [
+			...T ? [{
+				dir: g(x, "api"),
+				template: T.id
+			}] : [],
+			...k ? [{
+				dir: g(x, "web"),
+				template: k.id
+			}] : [],
+			...A ? [{
+				dir: g(x, "mobile"),
+				template: A.id
+			}] : []
+		],
+		preferPointer: !0
+	}).catch(() => void 0);
+	let N = null;
+	if (_.baseline) {
+		let e = await p(_.baseline);
+		e ? N = e.id : R.warn("unknown baseline — skipping baseline step", {
+			requested: _.baseline,
+			available: (await d()).map((e) => e.id)
+		});
+	} else _.noInput || (N = await Te());
+	if (N) {
+		console.log(), console.log(`→ applying baseline '${N}' at workspace root ${c}`);
+		try {
+			let e = await f({
+				root: c,
+				baselineId: N,
+				projectName: b,
+				quiet: !0
+			});
+			console.log(`  · ${e.written.length} files written, ${e.removed.length} removed`), e.backupDir && console.log(`  · backup: ${e.backupDir.replace(c + "/", "")}`), e.previousBaselineId && e.previousBaselineId !== N && console.log(`  · switched from previous baseline '${e.previousBaselineId}'`);
+		} catch (e) {
+			R.error("baseline apply failed", {
+				baselineId: N,
+				error: e instanceof Error ? e.message : String(e)
+			});
+		}
+	}
+	if (_.cache === "redis") {
+		console.log(), console.log("→ enabling Redis cache backend");
+		try {
+			let e = await u(c);
+			for (let t of e) console.log(`  ✓ ${t}`);
+		} catch (e) {
+			R.error("cache enable failed", { error: e instanceof Error ? e.message : String(e) });
+		}
+	}
+	return console.log(), console.log(`✓ project '${b}' scaffolded under apps/${b}/.`), N && console.log(`  baseline '${N}' applied at workspace root.`), o["no-register"] !== !0 && await be(x, b), console.log(), console.log("Next steps:"), console.log("  pnpm install"), console.log("  pnpm dev                    # every app in this workspace, in parallel"), T && console.log(`  # or one at a time: pnpm --filter @${b}/api dev`), k && console.log(`  #                   pnpm --filter @${b}/web dev`), A && (console.log(`  cd apps/${b}/mobile && pnpm ios   # Expo — owns its own dev loop, not \`voltro dev\``), console.log("  # point EXPO_PUBLIC_API_URL at the api's LAN address for a device/simulator")), N === "compose" ? (console.log("  pnpm db:up                  # postgres only (native dev)"), console.log("  pnpm dev:docker             # OR full-stack docker dev")) : N === "helm" && (console.log("  pnpm helm:lint              # verify the chart"), console.log("  pnpm helm:install:dev       # deploy to a dev cluster")), 0;
+}, $ = (e, t) => (n) => c(C.tryPromise({
+	try: () => e(n),
+	catch: (e) => e
+}).pipe(C.orDie), { scope: t }), Oe = $(me, "voltro:list-templates"), ke = $(Se, "voltro:add-app"), Ae = $(De, "voltro:create-project");
+//#endregion
+export { z as a, Ae as c, L as d, P as f, W as i, Oe as l, V as n, xe as o, B as r, ke as s, H as t, _e as u };