@voltro/cli 0.33.0 → 0.34.0

package/dist/baselineCommand-DIttzO8A.js

@@ -0,0 +1,227 @@
+import { i as e, n as t, t as n } from "./cliArgs-D4p8n7EE.js";
+import { dirname as r, join as i, relative as a, resolve as o } from "node:path";
+import { existsSync as s, mkdirSync as c, promises as l } from "node:fs";
+import { fileURLToPath as u } from "node:url";
+import { createLogger as d } from "@voltro/logger";
+//#region src/baselineCommand.ts
+var f = r(u(import.meta.url)), p = d({ scope: "voltro:baseline" }), m = (() => {
+	let e = process.env.VOLTRO_TEMPLATES_DIR;
+	if (e) {
+		let t = i(e, "baselines");
+		if (s(t)) return t;
+	}
+	let t = o(f, "..", "templates", "baselines"), n = f;
+	for (let e = 0; e < 12; e++) {
+		for (let e of ["voltro-templates", ".voltro-templates"]) {
+			let t = i(n, e, "baselines");
+			if (s(t)) return t;
+		}
+		let e = r(n);
+		if (e === n) break;
+		n = e;
+	}
+	return t;
+})(), h = async (e) => {
+	let t = i(e, "baseline.json");
+	if (!s(t)) return null;
+	try {
+		let e = await l.readFile(t, "utf8"), n = JSON.parse(e);
+		return typeof n.id != "string" || typeof n.displayName != "string" || typeof n.summary != "string" || !Array.isArray(n.files) ? null : n;
+	} catch {
+		return null;
+	}
+}, g = async () => {
+	if (!s(m)) return [];
+	let e = await l.readdir(m, { withFileTypes: !0 }), t = [];
+	for (let n of e) {
+		if (!n.isDirectory()) continue;
+		let e = i(m, n.name), r = await h(e);
+		r && r.id === n.name && t.push({
+			...r,
+			path: e
+		});
+	}
+	return t.sort((e, t) => e.id.localeCompare(t.id));
+}, _ = async (e) => {
+	if (!/^[a-z][a-z0-9-]*$/.test(e)) return null;
+	let t = i(m, e);
+	if (!s(t)) return null;
+	let n = await h(t);
+	return !n || n.id !== e ? null : {
+		...n,
+		path: t
+	};
+}, v = (e) => {
+	let t = o(e);
+	for (let e = 0; e < 12; e++) {
+		if (s(i(t, "pnpm-workspace.yaml"))) return t;
+		let e = r(t);
+		if (e === t) break;
+		t = e;
+	}
+	return null;
+}, y = (e) => i(e, ".voltro", "baseline.json"), b = async (e) => {
+	let t = y(e);
+	if (!s(t)) return null;
+	try {
+		let e = await l.readFile(t, "utf8"), n = JSON.parse(e);
+		return typeof n.id != "string" || typeof n.appliedAt != "string" || !Array.isArray(n.files) ? null : n;
+	} catch {
+		return null;
+	}
+}, x = async (e, t) => {
+	let n = y(e);
+	c(r(n), { recursive: !0 }), await l.writeFile(n, JSON.stringify(t, null, 2) + "\n", "utf8");
+}, S = /\{\{(projectName|projectNameCamel|projectNamePascal|projectNameSnake|appName|appNameCamel|appNamePascal)\}\}/g, C = (e) => e.replace(/-([a-z0-9])/g, (e, t) => t.toUpperCase()), w = (e) => {
+	let t = C(e);
+	return t.length === 0 ? t : t[0].toUpperCase() + t.slice(1);
+}, T = (e) => e.replace(/-/g, "_"), E = (e) => {
+	let t = e.split("/").filter(Boolean).pop() ?? "voltro-project";
+	return {
+		projectName: t,
+		projectNameCamel: C(t),
+		projectNamePascal: w(t),
+		projectNameSnake: T(t),
+		appName: "app",
+		appNameCamel: "app",
+		appNamePascal: "App"
+	};
+}, D = (e, t) => e.replace(S, (e, n) => t[n]), O = async (e, t, n) => {
+	c(r(t), { recursive: !0 });
+	let i = D((await l.readFile(e)).toString("utf8"), n);
+	await l.writeFile(t, i, "utf8");
+}, k = async (e, t, n) => {
+	if (!s(e)) return !1;
+	let o = i(t, a(n, e));
+	c(r(o), { recursive: !0 });
+	let u = await l.readFile(e);
+	return await l.writeFile(o, u), !0;
+}, A = async (e) => s(e) ? (await l.unlink(e), !0) : !1, j = async (e, t) => {
+	let n = e;
+	for (; n !== t && n.startsWith(t);) {
+		if (!s(n)) {
+			n = r(n);
+			continue;
+		}
+		if ((await l.readdir(n)).length > 0) return;
+		await l.rmdir(n).catch(() => {}), n = r(n);
+	}
+}, M = () => (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-"), N = async (e, t, n, r) => {
+	let a = i(e, "package.json");
+	if (!s(a)) throw Error(`no package.json at ${e} — a baseline patches the workspace root's scripts, and ${Object.keys(t).length} of them have nowhere to go. Run \`voltro init\` in the workspace root first.`);
+	let o = await l.readFile(a, "utf8"), c = JSON.parse(o), u = { ...c.scripts ?? {} };
+	for (let e of n) e in t || delete u[e];
+	for (let [e, n] of Object.entries(t)) u[e] = D(n, r);
+	c.scripts = u, await l.writeFile(a, JSON.stringify(c, null, 2) + "\n", "utf8");
+}, P = async (e) => {
+	let t = await _(e.baselineId);
+	if (!t) throw Error(`unknown baseline: ${e.baselineId} (available: ${(await g()).map((e) => e.id).join(", ")})`);
+	let n = e.root, o = e.projectName ? F(e.projectName) : E(n), l = await b(n), u = l ? await _(l.id) : null, d = new Set(l?.files ?? []);
+	for (let e of t.files) s(i(n, e)) && d.add(e);
+	let f = i(n, ".voltro-baseline-backup", M()), m = null;
+	if (d.size > 0) {
+		c(f, { recursive: !0 }), m = f;
+		for (let t of d) await k(i(n, t), f, n) && !e.quiet && p.info(`backup ${t}`, { to: a(n, f) });
+		await k(i(n, "package.json"), f, n);
+	}
+	await N(n, t.packageJsonScripts ?? {}, Object.keys(u?.packageJsonScripts ?? {}), o);
+	let h = new Set(t.files), v = [];
+	if (l) {
+		for (let t of l.files) if (!h.has(t)) {
+			let a = i(n, t);
+			await A(a) && (v.push(t), e.quiet || p.info(`removed ${t}`), await j(r(a), n));
+		}
+	}
+	let y = [];
+	for (let r of t.files) {
+		let a = i(t.path, r), c = i(n, r);
+		if (!s(a)) {
+			p.warn(`baseline file missing in source: ${r}`, { src: a });
+			continue;
+		}
+		await O(a, c, o), y.push(r), e.quiet || p.info(`wrote ${r}`);
+	}
+	return await x(n, {
+		id: t.id,
+		appliedAt: (/* @__PURE__ */ new Date()).toISOString(),
+		files: t.files
+	}), {
+		previousBaselineId: l?.id ?? null,
+		newBaselineId: t.id,
+		written: y,
+		removed: v,
+		backupDir: m
+	};
+}, F = (e) => ({
+	projectName: e,
+	projectNameCamel: C(e),
+	projectNamePascal: w(e),
+	projectNameSnake: T(e),
+	appName: "app",
+	appNameCamel: "app",
+	appNamePascal: "App"
+}), I = async () => {
+	let e = await g();
+	if (e.length === 0) return p.error("no baselines found", { hint: `expected dir: ${m}` }), 1;
+	let t = Math.max(...e.map((e) => e.id.length), 2), n = Math.max(...e.map((e) => e.displayName.length), 4);
+	console.log(`  ${"id".padEnd(t)}  ${"name".padEnd(n)}  summary`), console.log(`  ${"-".repeat(t)}  ${"-".repeat(n)}  -------`);
+	for (let r of e) console.log(`  ${r.id.padEnd(t)}  ${r.displayName.padEnd(n)}  ${r.summary}`);
+	return console.log(), console.log("Switch baseline:  voltro baseline set <id>"), 0;
+}, L = ["--at"], R = async (e) => {
+	let t = n(e, L), r = t ? o(t) : process.cwd(), a = v(r);
+	if (!a) return p.error("no pnpm-workspace.yaml found from cwd; not a Voltro project root", {
+		cwd: r,
+		hint: "cd into a project, or pass the project root: voltro baseline status <path>"
+	}), 2;
+	let c = await b(a);
+	if (!c) return console.log(`baseline: none active in ${a}`), console.log("  run `voltro baseline set <id>` to apply one"), 0;
+	let l = await _(c.id);
+	console.log(`baseline:    ${c.id}${l ? ` (${l.displayName})` : ""}`), console.log(`appliedAt:   ${c.appliedAt}`), console.log(`projectRoot: ${a}`), console.log(`files (${c.files.length}):`);
+	for (let e of c.files) {
+		let t = s(i(a, e)) ? "ok " : "gone";
+		console.log(`  ${t}  ${e}`);
+	}
+	return 0;
+}, z = async (n) => {
+	let r = e(n, L), i = r[0];
+	if (!i) return p.error("usage: voltro baseline set <id>", { available: (await g()).map((e) => e.id) }), 2;
+	let s = await _(i);
+	if (!s) return p.error(`unknown baseline: ${i}`, { available: (await g()).map((e) => e.id) }), 2;
+	let c = r[1] ?? t(n, "--at"), l = c ? o(c) : process.cwd(), u = v(l);
+	if (!u) return p.error("no pnpm-workspace.yaml found; refusing to write files outside a Voltro project root", {
+		startedFrom: l,
+		hint: "cd into the project root, or run: voltro baseline set <id> <path>"
+	}), 2;
+	let d;
+	try {
+		d = await P({
+			root: u,
+			baselineId: s.id
+		});
+	} catch (e) {
+		return p.error(`baseline set ${s.id} refused`, {
+			root: u,
+			reason: e instanceof Error ? e.message : String(e)
+		}), 1;
+	}
+	return console.log(), console.log(`Baseline switched: ${d.previousBaselineId ?? "(none)"} → ${d.newBaselineId}`), d.backupDir && console.log(`Backup: ${a(u, d.backupDir)}`), console.log(`Files written: ${d.written.length}`), d.removed.length > 0 && console.log(`Files removed: ${d.removed.length}`), console.log(), console.log("Next: review the changes, install any deps, and run"), console.log("  voltro baseline status   # to see the manifest"), 0;
+}, B = () => {
+	console.log("voltro baseline <subcommand>"), console.log(), console.log("Subcommands:"), console.log("  list           List available baselines (bare / compose / helm)."), console.log("  status         Show the currently-active baseline for this project."), console.log("  set <id>       Switch baseline (destructive, with backup)."), console.log("  help           Print this help."), console.log(), console.log("Switch semantics:"), console.log("  - Every file owned by the OLD baseline is backed up to"), console.log("    .voltro-baseline-backup/<isoTimestamp>/ before deletion."), console.log("  - Every file the NEW baseline writes that already exists is"), console.log("    backed up first."), console.log("  - package.json is patched in place (scripts only); old script"), console.log("    keys from the previous baseline are removed unless the new"), console.log("    baseline overrides them."), console.log("  - Application code under apps/ is NEVER touched.");
+}, V = async (e) => {
+	let t = e[0];
+	if (!t || t === "help" || t === "--help" || t === "-h") return B(), +!t;
+	let n = e.slice(1);
+	switch (t) {
+		case "list": return I();
+		case "status": return R(n);
+		case "set": return z(n);
+		default: return p.error(`unknown subcommand: ${t}`, { valid: [
+			"list",
+			"status",
+			"set",
+			"help"
+		] }), 2;
+	}
+};
+//#endregion
+export { g as a, v as i, P as n, V as o, _ as r, m as t };

package/dist/bin.js

@@ -1,54 +1,93 @@
 #!/usr/bin/env node
-import { ct as e } from "./inspectMetrics-1xzTKAFx.js";
-import { r as t } from "./commands-CJfepbm4.js";
-import { l as n } from "./dbCommand-DTLKAfbA.js";
-import { createLogger as r } from "@voltro/logger";
+import { r as e } from "./commands-gutsz-Ac.js";
+import { a as t } from "./nodeEnvironment-cGFAj1J8.js";
+import { t as n } from "./loadEnv-D9nEOClM.js";
+import { n as r } from "./cliError-BmdYnghb.js";
+import { createLogger as i } from "@voltro/logger";
 //#region src/sqlErrorDetail.ts
-var i = (e) => typeof e == "object" && !!e, a = (e) => {
-	if (i(e)) {
+var a = (e) => typeof e == "object" && !!e, o = (e) => {
+	if (a(e)) {
 		for (let t of Object.getOwnPropertySymbols(e)) if (String(t).includes("FiberFailure/Cause")) return e[t];
 	}
-}, o = (e, t = 0) => {
-	if (t > 8 || !i(e)) return [];
+}, s = (e, t = 0) => {
+	if (t > 8 || !a(e)) return [];
 	let n = e, r = [];
 	n.error !== void 0 && r.push(n.error), n.defect !== void 0 && r.push(n.defect);
 	for (let e of [
 		"left",
 		"right",
 		"cause"
-	]) n[e] !== void 0 && r.push(...o(n[e], t + 1));
+	]) n[e] !== void 0 && r.push(...s(n[e], t + 1));
 	return r;
-}, s = (e) => {
-	let t = [], n = /* @__PURE__ */ new Set(), r = (e, s) => {
+}, c = (e) => {
+	let t = [], n = /* @__PURE__ */ new Set(), r = (e, i) => {
 		let c = e;
-		for (let e = 0; e < 8 && i(c) && !n.has(c); e++) {
+		for (let e = 0; e < 8 && a(c) && !n.has(c); e++) {
 			n.add(c), t.push(c);
-			let e = a(c);
-			if (e !== void 0 && s < 4) for (let t of o(e)) r(t, s + 1);
+			let e = o(c);
+			if (e !== void 0 && i < 4) for (let t of s(e)) r(t, i + 1);
 			c = c.cause;
 		}
 	};
 	return r(e, 0), t;
-}, c = (e) => {
+}, l = (e) => {
 	if (e == null || e === "") return;
 	let t = String(e);
 	return t === "" ? void 0 : t;
-}, l = (e) => {
-	let t = s(e);
+}, u = /* @__PURE__ */ new Set([
+	"ECONNREFUSED",
+	"ENOTFOUND",
+	"EAI_AGAIN",
+	"ETIMEDOUT",
+	"ECONNRESET",
+	"EHOSTUNREACH",
+	"ENETUNREACH"
+]), d = /* @__PURE__ */ new Map([
+	["28P01", "the password was rejected"],
+	["28000", "the server refused this user (pg_hba / auth method)"],
+	["3D000", "that database does not exist on the server"],
+	["ER_ACCESS_DENIED_ERROR", "the password was rejected"],
+	["ER_BAD_DB_ERROR", "that database does not exist on the server"],
+	["ER_DBACCESS_DENIED_ERROR", "the user may not use that database"]
+]), f = (e) => {
+	for (let t of e) {
+		let e = t, n = l(e.address), r = l(e.port);
+		if (n !== void 0) return r === void 0 ? n : `${n}:${r}`;
+	}
+	for (let t of e) {
+		let e = /\b(\d{1,3}(?:\.\d{1,3}){3}|\[[0-9a-fA-F:]+\]|localhost):(\d{2,5})\b/.exec(l(t.message) ?? "");
+		if (e) return `${e[1]}:${e[2]}`;
+	}
+}, p = [
+	"DB_URL",
+	"DB_PRIMARY_URL",
+	"DB_DIRECT_URL",
+	"DB_MIGRATE_URL",
+	"DB_HOST",
+	"PG_HOST"
+], m = (e, t = process.env) => {
+	let n = c(e);
+	if (n.length === 0) return;
+	let r = n.map((e) => l(e.code)).filter((e) => e !== void 0), i = r.find((e) => u.has(e)), a = r.find((e) => d.has(e));
+	if (i === void 0 && a === void 0) return;
+	let o = p.filter((e) => (t[e] ?? "") !== ""), s = f(n), m = [];
+	return i === void 0 ? m.push(`the database refused the connection — ${d.get(a)} (${a}).`) : m.push(`the database is not reachable${s === void 0 ? "" : ` at ${s}`} (${i}).`), o.length === 0 ? m.push("", "  No database is configured — none of DB_URL / DB_HOST / PG_HOST is set in the", "  environment or in a loaded `.env`, so the framework used its local dev default.", "", "  Either start one:      pnpm db:up          (if your project ships a compose file)", "  or point at your own:  DB_URL=postgres://user:pass@host:5432/dbname", "                         — put it in `.env` next to app.config.ts, not just in one shell.") : m.push("", `  Configured by: ${o.join(", ")}.`, i === void 0 ? "  The server answered and rejected the credentials — check the user, password and database name in that variable." : "  The value resolves, so the address is right and nothing is answering there — check the server is running, and that a container/VPN/firewall is not in the way."), m.join("\n");
+}, h = (e) => {
+	let t = c(e);
 	if (t.length === 0) return;
 	let n = (e) => {
 		for (let n of t) {
-			let t = c(n[e]);
+			let t = l(n[e]);
 			if (t !== void 0) return t;
 		}
-	}, r = n("sql"), i = n("sqlMessage"), a = n("code"), o = n("errno"), l = n("sqlState"), u = n("detail"), d = n("hint"), f = n("position");
-	if (r === void 0 && i === void 0 && a === void 0 && o === void 0 && l === void 0 && u === void 0) return;
+	}, r = n("sql"), i = n("sqlMessage"), a = n("code"), o = n("errno"), s = n("sqlState"), u = n("detail"), d = n("hint"), f = n("position");
+	if (r === void 0 && i === void 0 && a === void 0 && o === void 0 && s === void 0 && u === void 0) return;
 	let p = [];
 	i !== void 0 && p.push(`  driver: ${i}`);
 	let m = [
 		a === void 0 ? void 0 : `code=${a}`,
 		o === void 0 ? void 0 : `errno=${o}`,
-		l === void 0 ? void 0 : `sqlState=${l}`,
+		s === void 0 ? void 0 : `sqlState=${s}`,
 		f === void 0 ? void 0 : `position=${f}`
 	].filter((e) => e !== void 0);
 	if (m.length > 0 && p.push(`  ${m.join(" ")}`), u !== void 0 && p.push(`  detail: ${u}`), d !== void 0 && p.push(`  hint: ${d}`), r !== void 0) {
@@ -56,7 +95,7 @@ var i = (e) => typeof e == "object" && !!e, a = (e) => {
 		p.push(`  statement: ${e.length > 600 ? `${e.slice(0, 600)}…` : e}`);
 	} else p.push("  statement: <not attached by the driver>");
 	return p.join("\n");
-}, u = r({ scope: "voltro:cli" }), d = (e) => {
+}, g = i({ scope: "voltro:cli" }), _ = (e) => {
 	process.exitCode = e;
 	let t = 2, n = () => {
 		--t === 0 && process.exit(e);
@@ -69,13 +108,17 @@ var i = (e) => typeof e == "object" && !!e, a = (e) => {
 		}
 		e.write("", () => n());
 	}
-}, f = process.argv.slice(2);
-e(f), t(f).then((e) => d(e)).catch((e) => {
-	if (n(e)) {
-		console.error(e.message), d(e.code);
+}, v = process.argv.slice(2);
+n(v), t(v), e(v).then((e) => _(e)).catch((e) => {
+	if (r(e)) {
+		console.error(e.message), _(e.code);
+		return;
+	}
+	let t = h(e), n = m(e), i = process.argv.includes("--debug") || process.env.VOLTRO_DEBUG === "1";
+	if (n !== void 0 && !i) {
+		console.error(`voltro: ${n}`), t !== void 0 && console.error(`\n${t}`), console.error("\n  Re-run with --debug for the full stack."), _(1);
 		return;
 	}
-	let t = l(e);
-	u.fatal("unhandled cli error", {}, e), t !== void 0 && console.error(t), d(1);
+	n !== void 0 && console.error(`voltro: ${n}\n`), g.fatal("unhandled cli error", {}, e), t !== void 0 && console.error(t), _(1);
 });
 //#endregion