@voltro/cli 0.33.0 → 0.35.0

package/dist/dormancyCommand-QewYug_s.js

@@ -0,0 +1,69 @@
+import { c as e, i as t } from "./dev-C7sFZq3m.js";
+import { n, t as r } from "./cliArgs-D4p8n7EE.js";
+import { r as i } from "./appPort-B_HpJ_ck.js";
+import { resolve as a } from "node:path";
+import { createLogger as o } from "@voltro/logger";
+import { nodeProcessSupervisor as s, runSingleNodeOrchestrator as c } from "@voltro/runtime";
+//#region src/dormancyCommand.ts
+var l = [
+	"--port",
+	"--app-port",
+	"--idle-grace-ms",
+	"--tick-ms"
+], u = async (u) => {
+	let d = o({ scope: "dormancy" }), f = {
+		info: (e, t) => d.info(e, t ?? {}),
+		warn: (e, t) => d.warn(e, t ?? {})
+	}, p = a(r(u, l) ?? process.cwd()), m = await e(p), h = (process.env.DB_DIALECT ?? m?.store ?? "memory").toLowerCase();
+	if (h === "memory") return d.error("voltro dormancy needs a SQL store (postgres/mysql/mariadb/mssql) — the orchestrator and the app share the `_voltro_wakeups` table, which an in-process `memory` store cannot do. Set DB_DIALECT or the app.config `store` field."), 2;
+	let g = i({
+		kind: "api",
+		configPort: m?.port,
+		env: process.env,
+		flagPort: n(u, "--port")
+	});
+	for (let e of g.warnings) d.warn(e);
+	let _ = g.port, v = Number(n(u, "--app-port") ?? _ + 1), y = Number(n(u, "--idle-grace-ms") ?? 6e4), b = Number(n(u, "--tick-ms") ?? 1e3), x = await t(m, void 0), S = s({
+		command: process.execPath,
+		args: [
+			process.argv[1],
+			"serve",
+			p
+		],
+		env: {
+			PORT: String(v),
+			VOLTRO_DORMANCY: "sleep"
+		},
+		healthUrl: `http://127.0.0.1:${v}/`,
+		healthCheck: (e) => e.status < 500,
+		log: f
+	}), C = await c({
+		store: x,
+		supervisor: S,
+		publicPort: _,
+		targetHost: "127.0.0.1",
+		targetPort: v,
+		idleGraceMs: y,
+		tickMs: b,
+		log: f
+	});
+	return d.info("dormancy orchestrator running", {
+		public: C.port,
+		app: v,
+		dialect: h,
+		idleGraceMs: y
+	}), await new Promise((e) => {
+		let t = !1, n = (n) => {
+			t || (t = !0, d.info("dormancy: shutting down", { signal: n }), (async () => {
+				try {
+					await C.stop();
+				} finally {
+					await S.stop().catch(() => {}), e();
+				}
+			})());
+		};
+		process.once("SIGINT", () => n("SIGINT")), process.once("SIGTERM", () => n("SIGTERM"));
+	}), 0;
+};
+//#endregion
+export { u as runDormancyCommand };

package/dist/e2eCmd-BRabZww-.js

@@ -0,0 +1,147 @@
+import "./appPort-B_HpJ_ck.js";
+import { t as e } from "./cliRuntime-Dh7UDinH.js";
+import { n as t, t as n } from "./tsxLoader-EuXmSJ1K.js";
+import { dirname as r, join as i, resolve as a } from "node:path";
+import { promises as o } from "node:fs";
+import { fileURLToPath as s, pathToFileURL as c } from "node:url";
+import { createLogger as l } from "@voltro/logger";
+import { Effect as u } from "effect";
+import { spawn as d } from "node:child_process";
+import { createConnection as f } from "node:net";
+//#region src/e2eCmd.ts
+var p = l({ scope: "voltro:e2e" }), m = async (e) => {
+	try {
+		let t = (await import(c(i(e, "app.config.ts")).href)).default;
+		if (typeof t == "object" && t && t.type === "web") return t;
+	} catch {}
+	return null;
+}, h = async (e, t, n = 15e3) => {
+	let r = Date.now() + n;
+	for (; Date.now() < r;) {
+		if (await new Promise((t) => {
+			let n = f({
+				port: e,
+				host: "localhost"
+			});
+			n.on("connect", () => {
+				n.end(), t(!0);
+			}), n.on("error", () => t(!1));
+		})) return;
+		await new Promise((e) => setTimeout(e, 250));
+	}
+	throw Error(`${t} did not start listening on :${e} within ${n / 1e3}s`);
+}, g = async (e, t) => {
+	if (!t.endsWith(".ts") && !t.endsWith(".tsx")) throw Error(`voltro e2e: unsupported pattern '${t}' (must end in .ts/.tsx)`);
+	let n = t.indexOf("/");
+	if (n === -1) throw Error(`voltro e2e: pattern '${t}' must include a directory prefix`);
+	let r = t.slice(0, n), a = t.slice(n + 1), s = i(e, r), c = [], l = (e, t) => t === "*.spec.ts" || t === "*.spec.tsx" ? e.endsWith(t.slice(1)) : RegExp("^" + t.replace(/\*/g, "[^/]*") + "$").test(e), u = async (e, t) => {
+		let n = t.indexOf("/");
+		if (n === -1) {
+			let n = [];
+			try {
+				n = await o.readdir(e, { withFileTypes: !0 });
+			} catch {
+				return;
+			}
+			for (let r of n) r.isFile() && l(r.name, t) && c.push(i(e, r.name));
+			return;
+		}
+		let r = t.slice(0, n), a = t.slice(n + 1);
+		if (r === "**") {
+			await u(e, a);
+			let n = [];
+			try {
+				n = await o.readdir(e, { withFileTypes: !0 });
+			} catch {
+				return;
+			}
+			for (let r of n) r.isDirectory() && await u(i(e, r.name), t);
+			return;
+		}
+		let s = [];
+		try {
+			s = await o.readdir(e, { withFileTypes: !0 });
+		} catch {
+			return;
+		}
+		for (let t of s) t.isDirectory() && l(t.name, r) && await u(i(e, t.name), a);
+	};
+	return await u(s, a), c.sort();
+}, _ = () => a(r(s(import.meta.url)), "..", "bin", "voltro.mjs"), v = async (e) => {
+	p.info("starting e2e run", { webRoot: e });
+	let r = await m(e);
+	if (!r) return p.error("no app.config.ts (or type:'web') at this path", { webRoot: e }), 1;
+	let i = r.e2e ?? {}, o = a(e, i.apiDir ?? "../api"), s = i.pattern ?? "e2e/**/*.spec.ts", c = i.apiPort ?? 4e3, l = i.webPort ?? 5173, u = await g(e, s);
+	if (p.info(`discovered ${u.length} test file(s)`, {
+		apiDir: o,
+		pattern: s,
+		count: u.length
+	}), u.length === 0) return p.error("no test files found — exiting"), 1;
+	let f = [], v = () => {
+		for (let e of f) e.killed || e.kill("SIGTERM");
+		setTimeout(() => {
+			for (let e of f) e.killed || e.kill("SIGKILL");
+		}, 3e3).unref?.();
+	};
+	process.on("SIGINT", v), process.on("SIGTERM", v);
+	try {
+		let r = _();
+		p.info(`booting api on :${c}`, { port: c });
+		let i = d(r, ["dev", o], {
+			env: {
+				...process.env,
+				PORT: String(c),
+				DB_DIALECT: process.env.DB_DIALECT ?? "memory",
+				WATCH: "0"
+			},
+			stdio: [
+				"ignore",
+				"pipe",
+				"pipe"
+			]
+		});
+		f.push(i), await h(c, "api"), p.info(`booting web on :${l}`, { port: l });
+		let a = d(r, ["dev", e], {
+			env: {
+				...process.env,
+				PORT: String(l),
+				WATCH: "0"
+			},
+			stdio: [
+				"ignore",
+				"pipe",
+				"pipe"
+			]
+		});
+		f.push(a), await h(l, "web"), p.info(`running ${u.length} test file(s)`, { count: u.length });
+		let s = 0, m = n(), g = t(m);
+		g !== void 0 && p.warn(g);
+		for (let e of u) {
+			let t = await new Promise((t) => {
+				d(process.execPath, [...m.execArgv, e], {
+					env: {
+						...process.env,
+						WEB_URL: `http://localhost:${l}`,
+						API_URL: `http://localhost:${c}`
+					},
+					stdio: "inherit"
+				}).on("exit", (e) => t(e ?? 0));
+			});
+			t === 0 ? p.info("test passed", { file: e }) : (p.error(`test failed (exit ${t})`, {
+				file: e,
+				exitCode: t
+			}), s += 1);
+		}
+		return s > 0 ? (p.error(`${s} test file(s) failed`, {
+			failed: s,
+			total: u.length
+		}), 1) : (p.info(`all ${u.length} test file(s) passed`, { count: u.length }), 0);
+	} finally {
+		v(), await new Promise((e) => setTimeout(e, 200));
+	}
+}, y = (e) => u.tryPromise({
+	try: () => v(e),
+	catch: (e) => e
+}).pipe(u.orDie), b = async (t) => e(y(a(t.find((e) => !e.startsWith("-")) ?? process.cwd())), { scope: "voltro:e2e" });
+//#endregion
+export { b as runE2eCommand };

package/dist/embeddingsCommand-BfiLS_QI.js

@@ -0,0 +1,73 @@
+import { c as e, i as t } from "./dev-C7sFZq3m.js";
+import { Effect as n } from "effect";
+import { embedMany as r } from "@voltro/ai";
+//#region src/embeddingsBackfill.ts
+var i = (e, t) => e.filter((e) => {
+	let n = e[t.vectorField];
+	return n == null || Array.isArray(n) && n.length === 0 ? !0 : t.modelField && t.model ? String(e[t.modelField]) !== t.model : !1;
+}), a = (e, t) => {
+	let n = [];
+	for (let r = 0; r < e.length; r += t) n.push(e.slice(r, r + t));
+	return n;
+}, o = async (e, t, n) => {
+	let r = await e.all(n.table), o = i(r, {
+		vectorField: n.vectorField,
+		...n.modelField ? { modelField: n.modelField } : {},
+		...n.model ? { model: n.model } : {}
+	});
+	if (n.dryRun) return {
+		table: n.table,
+		scanned: r.length,
+		embedded: o.length,
+		dryRun: !0
+	};
+	let s = 0;
+	for (let r of a(o, n.batchSize ?? 50)) {
+		let i = await t(r.map((e) => String(e[n.textField] ?? "")));
+		for (let t = 0; t < r.length; t++) {
+			let a = { [n.vectorField]: i[t] };
+			n.modelField && n.model && (a[n.modelField] = n.model), await e.update(n.table, r[t].id, a), s++;
+		}
+	}
+	return {
+		table: n.table,
+		scanned: r.length,
+		embedded: s,
+		dryRun: !1
+	};
+}, s = (e) => {
+	let [t, n, ...r] = e;
+	if (t !== "backfill") return { error: `unknown embeddings subcommand '${t ?? ""}' (expected: backfill)` };
+	if (!n) return { error: "usage: voltro embeddings backfill <table> --text <field> --vector <field> [--model <m>] [--model-field <f>] [--batch <n>] [--dry-run]" };
+	let i = (e) => {
+		let t = r.indexOf(`--${e}`);
+		return t === -1 ? void 0 : r[t + 1];
+	}, a = i("text"), o = i("vector") ?? "embedding";
+	if (!a) return { error: "--text <field> is required (the source text column)" };
+	let s = i("model"), c = i("model-field"), l = i("batch");
+	return {
+		sub: t,
+		table: n,
+		textField: a,
+		vectorField: o,
+		...s === void 0 ? {} : { model: s },
+		...c === void 0 ? {} : { modelField: c },
+		...l === void 0 ? {} : { batchSize: Number(l) },
+		dryRun: r.includes("--dry-run")
+	};
+}, c = async (i) => {
+	let a = s(i);
+	if ("error" in a) return console.error(a.error), 1;
+	let c = await t(await e(process.cwd()), void 0), l = {
+		all: (e) => c.query({ table: e }).then((e) => e.map((e) => ({
+			...e,
+			id: String(e.id)
+		}))),
+		update: async (e, t, n) => {
+			await c.update(e, t, n);
+		}
+	}, u = (e) => n.runPromise(r(e)), { sub: d, ...f } = a, p = await o(l, u, f);
+	return console.log(`embeddings backfill — table=${p.table} scanned=${p.scanned} embedded=${p.embedded}${p.dryRun ? " (dry-run)" : ""}`), 0;
+};
+//#endregion
+export { c as runEmbeddingsCommand };

package/dist/envCommand-CCGPRQY1.js

@@ -0,0 +1,60 @@
+import { c as e } from "./dev-C7sFZq3m.js";
+import { at as t, ct as n, lt as r, ot as i } from "./webDev-Dybxew86.js";
+import { join as a } from "node:path";
+import { promises as o } from "node:fs";
+import { createLogger as s } from "@voltro/logger";
+import { frameworkEnvNames as c, isEnvContract as l } from "@voltro/env";
+//#region src/envCommand.ts
+var u = s({ scope: "voltro:env" }), d = "# Environment for this app", f = async (t) => {
+	let n = await e(t).catch(() => null);
+	if (!n) return null;
+	let r = l(n.env) ? n.env : void 0, i = n.type === "api" ? n.plugins ?? [] : void 0;
+	return {
+		name: n.name ?? "app",
+		input: {
+			contract: r,
+			...i ? { plugins: i } : {}
+		}
+	};
+}, p = (e, t) => e.length >= t ? e : e + " ".repeat(t - e.length), m = (e) => {
+	process.stdout.write(`${e}\n`);
+}, h = async (e) => {
+	let n = await f(e);
+	if (!n) return u.error("no app.config.ts found in the current directory"), 1;
+	let r = t(n.name, n.input), i = `${p("KEY", 32)} ${p("OWNER", 16)} ${p("ACCESS", 8)} ${p("REQ", 4)} SET`;
+	u.info(`env manifest — ${r.app} (${r.summary.total} vars, ${r.summary.set} set)`), m(i);
+	for (let e of r.entries) {
+		let t = e.isSet ? "✓" : e.satisfied ? "·" : "✗";
+		m(`${p(e.key, 32)} ${p(e.owner, 16)} ${p(e.access, 8)} ${p(e.required ? "yes" : "", 4)} ${t}`);
+	}
+	return r.summary.missingRequired > 0 ? (u.error(`${r.summary.missingRequired} required var(s) are unset`), 1) : 0;
+}, g = async (e, t) => {
+	let n = await f(e);
+	if (!n) return u.error("no app.config.ts found in the current directory"), 1;
+	let r = i(n.input, ["Environment for this app — generated from app.config.ts `env` + plugin declarations.", "Regenerate with `voltro env sync`. Copy to `.env` and fill in the blanks."]), s = a(e, ".env.example"), c = await o.readFile(s, "utf8").catch(() => null);
+	if (c !== null && !c.startsWith(d) && !t) {
+		let t = a(e, ".env.example.generated");
+		return await o.writeFile(t, r, "utf8"), u.warn(".env.example exists and is not framework-generated — wrote .env.example.generated instead", { hint: "merge it by hand, or pass --force to overwrite .env.example" }), 0;
+	}
+	return await o.writeFile(s, r, "utf8"), u.info("wrote .env.example", { app: n.name }), 0;
+}, _ = async (t) => {
+	let i = await e(t).catch(() => null);
+	if (!i) return u.error("no app.config.ts found in the current directory"), 1;
+	let a = l(i.env) ? i.env : void 0;
+	return a ? (i.type === "web" ? (await n(t, a), u.info("wrote src/voltro-env.d.ts (publicEnv augmentation)", { app: i.name ?? "app" })) : (await r(t, a), u.info("wrote env.generated.d.ts (serverEnv augmentation)", { app: i.name ?? "app" })), 0) : (u.warn("no `defineEnv` declared in app.config.ts — nothing to generate", { hint: "add `env: defineEnv({ ... })` to app.config.ts (see @voltro/env)" }), 0);
+}, v = () => {
+	let e = c();
+	return u.info(`${e.length} framework env vars for turbo.json globalPassThroughEnv:`), m(JSON.stringify([...e].sort(), null, 2)), u.info("merge these into the workspace turbo.json `globalPassThroughEnv` array (+ your own app vars)."), 0;
+}, y = async (e) => {
+	let t = e[0] && !e[0].startsWith("-") ? e[0] : "check", n = e.includes("--force"), r = process.cwd();
+	switch (t) {
+		case "check":
+		case "list": return h(r);
+		case "sync": return g(r, n);
+		case "types": return _(r);
+		case "turbo": return v();
+		default: return u.error(`unknown subcommand: ${t}`, { hint: "voltro env [check|sync|types|turbo]" }), 2;
+	}
+};
+//#endregion
+export { y as runEnvCommand };

package/dist/evalCommand-6RUfPen4.js

@@ -0,0 +1,118 @@
+import { n as e } from "./appModuleLoader-C9r9mxZt.js";
+import { n as t } from "./cliOutput-D1tSBoRM.js";
+import { basename as n, join as r, resolve as i } from "node:path";
+import { readdirSync as a, statSync as o } from "node:fs";
+import { Effect as s } from "effect";
+import { generateText as c, isEvalDefinition as l, llmJudge as u, runEval as d } from "@voltro/ai";
+import { branchNamespaceName as f } from "@voltro/database";
+//#region src/evalCommand.ts
+var p = /* @__PURE__ */ new Set([
+	"node_modules",
+	"dist",
+	"build",
+	".framework",
+	".turbo",
+	".git",
+	"coverage"
+]), m = /\.eval\.ts$/, h = (e, t = [], n = 0) => {
+	if (n > 12) return t;
+	let i;
+	try {
+		i = a(e);
+	} catch {
+		return t;
+	}
+	for (let a of i) {
+		if (p.has(a) || a.startsWith(".")) continue;
+		let i = r(e, a), s;
+		try {
+			s = o(i);
+		} catch {
+			continue;
+		}
+		s.isDirectory() ? h(i, t, n + 1) : s.isFile() && m.test(a) && t.push(i);
+	}
+	return t;
+}, g = async (t) => {
+	let n = t.importFile ?? (async (t) => (await e(t)).default), r = t.log ?? (() => {}), i = [], a = [];
+	for (let e of t.files) {
+		let o;
+		try {
+			o = await n(e);
+		} catch (t) {
+			r(`eval: failed to import ${e}: ${t.message}`), a.push(e);
+			continue;
+		}
+		if (!l(o)) {
+			a.push(e);
+			continue;
+		}
+		let s = await d(o, {
+			replay: t.replay,
+			...t.judge === void 0 ? {} : { judge: t.judge },
+			...t.branchId === void 0 ? {} : { branchId: t.branchId }
+		});
+		i.push(s);
+	}
+	return {
+		reports: i,
+		ok: i.length > 0 && i.every((e) => e.ok),
+		skipped: a
+	};
+}, _ = async ({ case: e }) => {
+	let t = Date.now();
+	return await s.runPromise(c({
+		prompt: e.input.prompt,
+		...e.input.system === void 0 ? {} : { system: e.input.system }
+	}).pipe(s.map((e) => ({
+		text: e.text,
+		latencyMs: Date.now() - t
+	})), s.catchAll((n) => s.succeed({
+		text: "",
+		latencyMs: Date.now() - t
+	}).pipe(s.tap(() => s.sync(() => console.error(`  replay error (${e.id}): ${n.message}`)))))));
+}, v = (e) => [`${e.ok ? "✓" : "✗"} ${e.name}: ${e.passed}/${e.cases.length} passed${e.branch ? ` (branch ${e.branch.id})` : ""}`, ...e.cases.filter((e) => !e.pass).map((e) => {
+	let t = e.assertionFailures.map((e) => `      - ${e.detail}`), n = e.judge !== void 0 && e.judge.score < .7 ? [`      - judge: ${e.judge.score.toFixed(2)} — ${e.judge.reason}`] : [];
+	return [
+		`    ✗ ${e.id}`,
+		...t,
+		...n
+	].join("\n");
+})].join("\n"), y = (e) => {
+	let t = e.indexOf("--threshold");
+	if (t === -1) return;
+	let n = Number(e[t + 1]);
+	return Number.isFinite(n) ? n : void 0;
+}, b = (e) => {
+	let t = e.indexOf("--pr");
+	if (t === -1) return 0;
+	let n = Number(e[t + 1]);
+	return Number.isInteger(n) && n >= 0 ? n : 0;
+}, x = async (e) => {
+	let r = e.includes("--json"), a = e.includes("--branch"), o = y(e);
+	if (o !== void 0 && (o < 0 || o > 1)) return console.error("voltro eval: --threshold must be within 0..1"), 1;
+	let s = i(e.find((e) => !e.startsWith("-") && Number.isNaN(Number(e))) ?? process.cwd()), c = h(s);
+	if (c.length === 0) return console.error(`voltro eval: no *.eval.ts found under ${s}`), console.error("  Author an eval with `export default defineEval({ name, cases, judge? })`."), 1;
+	let l = a ? f(n(s), b(e)) : void 0;
+	l !== void 0 && !r && console.log(`replays target data branch: ${l} (provision via voltro's BranchExecutor)`);
+	let d = await g({
+		root: s,
+		files: c,
+		replay: _,
+		judge: u,
+		...l === void 0 ? {} : { branchId: l },
+		log: (e) => console.error(e)
+	});
+	if (r) t({
+		ok: d.ok,
+		reports: d.reports,
+		skipped: d.skipped
+	});
+	else {
+		for (let e of d.reports) console.log(v(e));
+		d.reports.length === 0 && console.log("voltro eval: no runnable eval suites (files found but none exported a defineEval)"), console.log(d.ok ? "\nvoltro eval: OK" : "\nvoltro eval: FAILED (regressions above)");
+	}
+	return +!d.ok;
+};
+//#endregion
+export { x as runEvalCommand };