@voltro/cli 0.11.4 → 0.13.0

package/dist/dev-xdijqojc.js

@@ -0,0 +1,3 @@
+import "./seedRunner-D6eu-u5U.js";
+import { c as e, f as t, s as n } from "./dev-Fb9BmavX.js";
+export { n as loadApiConfig, e as loadDiscovered, t as walk };

package/dist/frameworkTableAssembly-CYlrafoK.js

@@ -0,0 +1,600 @@
+import { n as e } from "./appModuleLoader-C9r9mxZt.js";
+import { basename as t, join as n } from "node:path";
+import { pathToFileURL as r } from "node:url";
+import { Effect as i } from "effect";
+import { promises as a } from "node:fs";
+import { _voltroConnectionGrantsTable as o, _voltroConnectionsTable as s, _voltroScheduleClaimsTable as c, _voltroScheduleRunsTable as l, _voltroTracesTable as u, _voltroUndoLogTable as d, _voltroWakeupsTable as ee, _voltroWorkflowEventDeliveriesTable as f, _voltroWorkflowEventsTable as te, outboxAttemptsTable as ne, outboxTable as re, undoCaptureEnabled as ie } from "@voltro/runtime";
+import { SqlClient as p } from "@effect/sql";
+import { _voltroWorkflowRunEventsTable as ae, _voltroWorkflowRunStepsTable as oe, _voltroWorkflowRunsTable as se, _voltroWorkflowStartContextsTable as m } from "@voltro/workflow";
+import { agentMessagesTable as ce, agentThreadsTable as le, aiBudgetTable as ue, aiUsageTable as de, isAgentDescriptor as fe, isAgentExecutor as pe, resolveToolModuleHandlers as me } from "@voltro/ai";
+import { _voltroApiKeysTable as he, _voltroCdcOffsetsTable as ge, _voltroIdempotencyTable as _e, _voltroKvTable as ve, _voltroMigrationPlansTable as ye, _voltroMigrationsTable as be, _voltroMssqlCdcOffsetsTable as h, _voltroSeedsTable as g, lt as _ } from "@voltro/database";
+import { _voltroWebhookDeliveriesTable as v, _voltroWebhookTargetsTable as y } from "@voltro/plugin-webhooks/mixin";
+import { _voltroStorageBlobsTable as b, _voltroStorageGrantsTable as x, _voltroStorageRefsTable as S, _voltroStorageUsageTable as C } from "@voltro/plugin-storage";
+import { defineAction as w, defineMutation as T, defineQuery as E } from "@voltro/protocol";
+//#region src/frameworkTables.ts
+var D = [
+	{
+		table: be,
+		when: "always"
+	},
+	{
+		table: g,
+		when: "always"
+	},
+	{
+		table: ye,
+		when: "always"
+	},
+	{
+		table: se,
+		when: "workflows"
+	},
+	{
+		table: oe,
+		when: "workflows"
+	},
+	{
+		table: ae,
+		when: "workflows"
+	},
+	{
+		table: m,
+		when: "workflows"
+	},
+	{
+		table: te,
+		when: "workflows"
+	},
+	{
+		table: f,
+		when: "workflows"
+	},
+	{
+		table: l,
+		when: "schedules"
+	},
+	{
+		table: c,
+		when: "schedules"
+	},
+	{
+		table: y,
+		when: "webhooks"
+	},
+	{
+		table: v,
+		when: "webhooks"
+	},
+	{
+		table: u,
+		when: "traces"
+	},
+	{
+		table: d,
+		when: "undo"
+	},
+	{
+		table: re,
+		when: "outbox"
+	},
+	{
+		table: ne,
+		when: "outbox"
+	},
+	{
+		table: s,
+		when: "connections"
+	},
+	{
+		table: o,
+		when: "connections"
+	},
+	{
+		table: ee,
+		when: "always"
+	},
+	{
+		table: S,
+		when: "always"
+	},
+	{
+		table: x,
+		when: "always"
+	},
+	{
+		table: b,
+		when: "always"
+	},
+	{
+		table: C,
+		when: "always"
+	},
+	{
+		table: _e,
+		when: "always"
+	},
+	{
+		table: he,
+		when: "always"
+	},
+	{
+		table: ve,
+		when: "always"
+	}
+], O = (e) => {
+	let t = D.filter((t) => t.when === "always" || t.when === "workflows" && e.workflows || t.when === "schedules" && e.schedules || t.when === "webhooks" && e.webhooks || t.when === "traces" && e.traces || t.when === "undo" && e.undo === !0 || t.when === "outbox" && e.outbox === !0 || t.when === "connections" && e.connections === !0).map((e) => e.table);
+	return e.cdc === !0 && t.push(e.cdcDialect === "mssql" ? h : ge), t;
+}, k = (e) => {
+	let t = e.startsWith("@") ? e.replace(/^@[^/]+\//, "") : e;
+	return (t.startsWith("plugin-") ? t.slice(7) : t).replace(/-([a-zA-Z0-9])/g, (e, t) => t.toUpperCase());
+}, A = (e) => {
+	let t = e.startsWith("@") ? e.replace(/^@[^/]+\//, "") : e;
+	return (t.startsWith("plugin-") ? t.slice(7) : t).replace(/#/g, "--").replace(/([a-z0-9])([A-Z])/g, "$1-$2").toLowerCase();
+}, j = (e, t) => t.name.includes(".") ? t.name : `${k(e.name)}.${t.name}`, M = (e, t, n) => {
+	switch (e) {
+		case "query": return E({
+			name: t,
+			input: n.input,
+			output: n.output,
+			...n.error === void 0 ? {} : { error: n.error },
+			...n.source === void 0 ? {} : { source: n.source }
+		});
+		case "mutation": return T({
+			name: t,
+			input: n.input,
+			output: n.output,
+			...n.error === void 0 ? {} : { error: n.error }
+		});
+		case "action": return w({
+			name: t,
+			input: n.input,
+			output: n.output,
+			...n.error === void 0 ? {} : { error: n.error }
+		});
+	}
+}, N = (e) => (t, n) => i.suspend(() => {
+	let r = { request: {
+		subject: n.request.subject,
+		traceId: n.request.traceId
+	} };
+	return e.execute(t, r);
+}), xe = (e) => {
+	let t = [];
+	for (let n of e) {
+		let e = n.routes ?? [];
+		for (let r of e) {
+			let e = j(n, r), i = M(r.kind, e, r);
+			t.push({
+				kind: r.kind,
+				file: `plugin:${n.name}`,
+				descriptor: i,
+				executor: N(r),
+				plugin: {
+					name: n.name,
+					version: n.version
+				}
+			});
+		}
+	}
+	return t;
+}, Se = (e, t) => {
+	let n = /* @__PURE__ */ new Map();
+	for (let e of t) n.set(e, "user-route");
+	for (let t of e) {
+		let e = t.descriptor.name, r = n.get(e);
+		if (r !== void 0) throw Error(`plugin route tag collision: "${e}" declared by plugin "${t.plugin.name}" but already claimed by ${r === "user-route" ? "a user-authored route" : `plugin "${r}"`}`);
+		n.set(e, t.plugin.name);
+	}
+}, P = "_voltro_plugin_migrations", Ce = () => i.gen(function* () {
+	yield* (yield* p.SqlClient).unsafe(`
+      CREATE TABLE IF NOT EXISTS ${P} (
+        id          TEXT PRIMARY KEY,
+        plugin_name TEXT NOT NULL,
+        migration_id TEXT NOT NULL,
+        description TEXT,
+        applied_at  TEXT NOT NULL
+      );
+    `).pipe(i.orDie);
+}), we = (e, t) => `${k(e)}__${t}`, Te = () => i.gen(function* () {
+	let e = yield* p.SqlClient, t = yield* e`SELECT id FROM ${e(P)}`.pipe(i.orDie);
+	return new Set(t.map((e) => e.id));
+}), Ee = (e) => i.gen(function* () {
+	let t = yield* p.SqlClient, n = (/* @__PURE__ */ new Date()).toISOString();
+	yield* t`
+        INSERT INTO ${t(P)} (id, plugin_name, migration_id, description, applied_at)
+        VALUES (${e.key}, ${e.pluginName}, ${e.migration.id}, ${e.migration.description ?? null}, ${n})
+      `.pipe(i.orDie);
+}), De = (e) => i.gen(function* () {
+	let t = e.flatMap((e) => (e.extendSchema?.migrations ?? []).map((t) => ({
+		plugin: e,
+		migration: t
+	})));
+	if (t.length === 0) return [];
+	yield* Ce();
+	let n = yield* Te(), r = [];
+	for (let { plugin: e, migration: a } of t) {
+		let t = we(e.name, a.id), o = Date.now();
+		if (n.has(t)) {
+			r.push({
+				pluginName: e.name,
+				migrationId: a.id,
+				status: "skipped",
+				durationMs: 0
+			});
+			continue;
+		}
+		let s = yield* p.SqlClient;
+		try {
+			yield* a.up(s).pipe(i.mapError((e) => e)), yield* Ee({
+				key: t,
+				pluginName: e.name,
+				migration: a
+			}), r.push({
+				pluginName: e.name,
+				migrationId: a.id,
+				status: "applied",
+				durationMs: Date.now() - o
+			});
+		} catch (t) {
+			return r.push({
+				pluginName: e.name,
+				migrationId: a.id,
+				status: "failed",
+				durationMs: Date.now() - o,
+				error: t
+			}), yield* i.fail(/* @__PURE__ */ Error(`Plugin migration failed: ${e.name} ${a.id} — ${t instanceof Error ? t.message : String(t)}`));
+		}
+	}
+	return r;
+}), Oe = (e) => e.filter((e) => e.extendSchema && (e.extendSchema.tables?.length ?? 0) + (e.extendSchema.migrations?.length ?? 0) > 0).map((e) => ({
+	pluginName: e.name,
+	pluginAlias: k(e.name),
+	tables: e.extendSchema.tables?.length ?? 0,
+	migrations: e.extendSchema.migrations?.length ?? 0
+})), ke = (e) => e.flatMap((e) => e.extendSchema?.tables ?? []), F = /(?<!\.server)\.agent\.tsx?$/, Ae = /\.agent\.server\.tsx?$/, I = /\.tool\.tsx?$/, L = async (t, n) => {
+	let r = 0;
+	for (let i of t) if (I.test(i)) try {
+		let t = await e(i);
+		r += me(t);
+	} catch (e) {
+		n.warn("tool: failed to import — handler not wired", { file: i }, e);
+	}
+	return r;
+}, je = (e) => e.replace(/\.agent\.(tsx?)$/, ".agent.server.$1"), Me = async (t, n) => {
+	let r = [], i = /* @__PURE__ */ new Set();
+	for (let a of t) {
+		if (!F.test(a)) continue;
+		let t;
+		try {
+			t = await e(a);
+		} catch (e) {
+			n.warn("agent: failed to import descriptor", { file: a }, e);
+			continue;
+		}
+		let o = Object.values(t).find(fe);
+		if (o === void 0) {
+			n.warn("agent: no defineAgent() descriptor export found", { file: a });
+			continue;
+		}
+		if (i.has(o.name)) {
+			n.warn("agent: duplicate name — skipping", {
+				file: a,
+				name: o.name
+			});
+			continue;
+		}
+		let s = je(a), c;
+		try {
+			c = await e(s);
+		} catch (e) {
+			n.warn("agent: no executor — expected a `*.agent.server.tsx` default-exporting defineAgentExecutor()", {
+				descriptor: a,
+				expected: s,
+				name: o.name
+			}, e);
+			continue;
+		}
+		let l = c.default;
+		if (!pe(l)) {
+			n.warn("agent: executor file must default-export defineAgentExecutor(descriptor, {...})", {
+				file: s,
+				name: o.name
+			});
+			continue;
+		}
+		i.add(o.name), r.push({
+			file: a,
+			serverFile: s,
+			descriptor: o,
+			executor: l
+		});
+	}
+	return { agents: r };
+}, R = /\.connection\.tsx?$/, Ne = (e) => e.replace(R, ""), Pe = async (n, r) => {
+	let i = [], a = /* @__PURE__ */ new Map();
+	for (let t of n) {
+		let n;
+		try {
+			n = await e(t);
+		} catch (e) {
+			r.warn("connections: failed to import", { file: t }, e);
+			continue;
+		}
+		let o = n.default;
+		if (o === void 0 || typeof o != "object" || !o) {
+			r.warn("connections: missing or non-object default export — expected `defineConnection({...})`", { file: t });
+			continue;
+		}
+		let s = o;
+		if (typeof s.id != "string" || s.id.length === 0) {
+			r.warn("connections: invalid `id` field", { file: t });
+			continue;
+		}
+		if (s.kind !== "oauth2" && s.kind !== "pat") {
+			r.warn("connections: `kind` must be \"oauth2\" or \"pat\"", {
+				file: t,
+				kind: String(s.kind)
+			});
+			continue;
+		}
+		let c = a.get(s.id);
+		if (c !== void 0) {
+			r.error("connections: DUPLICATE id — only the first is registered", {
+				id: s.id,
+				registered: c,
+				ignored: t
+			});
+			continue;
+		}
+		a.set(s.id, t), i.push({
+			file: t,
+			definition: s
+		});
+	}
+	return i.length > 0 && r.info("discovered connections", {
+		connections: i.map((e) => `${e.definition.id} (${e.definition.kind})`),
+		files: i.map((e) => Ne(t(e.file)))
+	}), i;
+}, z = (e) => typeof e.attributes["framework.kind"] == "string" && e.attributes["framework.kind"].startsWith("subscription."), B = (e) => {
+	if (e.name.includes("_voltro_traces")) return !0;
+	for (let t in e.attributes) {
+		let n = e.attributes[t];
+		if (typeof n == "string" && n.includes("_voltro_traces")) return !0;
+	}
+	return !1;
+}, Fe = (e) => typeof e.attributes["framework.kind"] == "string" && e.attributes["framework.kind"].startsWith("subscription"), Ie = 1e3, Le = 500, Re = 50, V = class {
+	capacity;
+	buffer = [];
+	constructor(e = Ie) {
+		this.capacity = e;
+	}
+	append(e) {
+		this.buffer.push(e), this.buffer.length > this.capacity && this.buffer.shift();
+	}
+	query(e = {}) {
+		let t = e.since ?? 0, n = e.until ?? Date.now(), r = Math.min(e.max ?? Le, this.capacity), i = e.traceId, a = e.minDurationMs, o = e.status, s = e.name?.toLowerCase(), c = [];
+		for (let e = this.buffer.length - 1; e >= 0 && c.length < r; e--) {
+			let r = this.buffer[e];
+			r.startMs < t || r.startMs > n || i !== void 0 && r.traceId !== i || a !== void 0 && r.durationMs < a || o !== void 0 && r.status !== o || s !== void 0 && !r.name.toLowerCase().includes(s) || c.push(r);
+		}
+		return c.reverse();
+	}
+	queryGrouped(e = {}) {
+		let t = e.since ?? 0, n = e.maxTraces ?? Re, r = e.onlyErrors ?? !1, i = /* @__PURE__ */ new Map();
+		for (let e of this.buffer) {
+			if (e.startMs < t) continue;
+			let n = i.get(e.traceId);
+			n ? n.push(e) : i.set(e.traceId, [e]);
+		}
+		let a = [];
+		for (let [e, t] of i) {
+			t.sort((e, t) => e.startMs - t.startMs);
+			let n = t.some((e) => e.status === "error");
+			if (r && !n) continue;
+			let i = t[0].startMs, o = t.reduce((e, t) => t.endMs > e ? t.endMs : e, i), s = t.filter(z), c = s.length > 0 || t.some(Fe), l = s.reduce((e, t) => e === void 0 || t.startMs > e.startMs ? t : e, void 0);
+			a.push({
+				traceId: e,
+				rootName: t[0].name,
+				startMs: i,
+				durationMs: o - i,
+				spanCount: t.length,
+				hasError: n,
+				kind: c ? "subscription" : "request",
+				...l === void 0 ? {} : { lastDeliveryMs: l.durationMs },
+				...s.length > 0 ? { deliveryCount: s.length } : {},
+				spans: t
+			});
+		}
+		return a.sort((e, t) => t.startMs - e.startMs), a.slice(0, n);
+	}
+	size() {
+		return this.buffer.length;
+	}
+	capacityHint() {
+		return this.capacity;
+	}
+	clear() {
+		this.buffer = [];
+	}
+}, H = null, ze = () => (H === null && (H = new V()), H), Be = /* @__PURE__ */ new Set([
+	"off",
+	"errors",
+	"interesting",
+	"all"
+]), U = (e, t, n, r) => {
+	let i = Number(e);
+	return Number.isFinite(i) ? Math.min(r, Math.max(n, i)) : t;
+}, Ve = (e) => e !== void 0 && [
+	"1",
+	"true",
+	"yes",
+	"on"
+].includes(e.toLowerCase()), He = (e) => {
+	let t = Number(e);
+	return Number.isFinite(t) && t > 0 ? t : 24;
+}, W = (e = process.env) => {
+	let t = (e.VOLTRO_TRACING_BUFFER ?? "").toLowerCase() === "off", n = U(e.VOLTRO_TRACING_SAMPLE, 1, 0, 1), r = (e.VOLTRO_TRACING_PERSIST ?? "").toLowerCase(), i = e.NODE_ENV === "production" ? "off" : "interesting";
+	return {
+		mode: Be.has(r) ? r : n <= 0 ? "off" : i,
+		sampleRate: n,
+		slowMs: U(e.VOLTRO_TRACING_SLOW_MS, 500, 0, 2 ** 53 - 1),
+		ttlHours: He(e.VOLTRO_TRACING_TTL_HOURS),
+		persistDelivery: Ve(e.VOLTRO_TRACING_PERSIST_DELIVERY),
+		bufferDisabled: t
+	};
+}, G = (e = process.env) => {
+	let t = W(e);
+	return !t.bufferDisabled && t.mode !== "off";
+}, Ue = (e, t) => {
+	if (t >= 1) return !0;
+	if (t <= 0) return !1;
+	let n = 2166136261;
+	for (let t = 0; t < e.length; t++) n ^= e.charCodeAt(t), n = Math.imul(n, 16777619);
+	return (n >>> 0) % 1e3 < t * 1e3;
+}, We = (e, t) => {
+	if (t.mode === "off" || B(e) || z(e) && !t.persistDelivery) return !1;
+	let n = e.status === "error";
+	if (t.mode === "errors") return n;
+	if (n) return !0;
+	if (!Ue(e.traceId, t.sampleRate)) return !1;
+	if (t.mode === "all") return !0;
+	let r = e.parentSpanId === null || e.parentSpanId === void 0 || e.parentSpanId === "", i = typeof e.durationMs == "number" && e.durationMs >= t.slowMs;
+	return r || i;
+}, Ge = (e) => {
+	if (e.bufferDisabled) return "durable traces: OFF (VOLTRO_TRACING_BUFFER=off)";
+	if (e.mode === "off") return "durable traces: OFF — _voltro_traces not created (prod default; set VOLTRO_TRACING_PERSIST=interesting to enable, or use OTLP)";
+	let t = e.mode === "interesting" ? ` (errors + slow≥${e.slowMs}ms + roots)` : e.mode === "errors" ? " (errors only)" : "";
+	return `durable traces: mode=${e.mode}${t}` + (e.sampleRate < 1 ? ` · sample=${e.sampleRate}` : "") + (e.persistDelivery ? " · +delivery" : "") + ` · ttl=${e.ttlHours}h`;
+}, Ke = (e = 30 * 6e4) => {
+	let t = /* @__PURE__ */ new Map();
+	return (n, r) => {
+		let i = t.get(n);
+		return i !== void 0 && r - i < e ? !1 : (t.set(n, r), !0);
+	};
+}, qe = (e) => {
+	let { store: t, log: n } = e, r = e.policy ?? W();
+	n.info(Ge(r));
+	let i = Ke(), a = [], o = () => {};
+	if (r.mode !== "off") {
+		let e = [], s = 0;
+		o = (t) => {
+			We(t, r) && (e.length >= 5e3 && (e.shift(), s += 1, i("flush-drop", Date.now()) && (n.warn(`trace flush queue saturated — dropping durable spans (${s}+ since last warning). Durable inflow exceeds write throughput; reduce it with VOLTRO_TRACING_PERSIST=errors|interesting or VOLTRO_TRACING_SAMPLE<1.`), s = 0)), e.push(t));
+		};
+		let c = async () => {
+			if (e.length === 0) return;
+			let n = e.splice(0, 200);
+			for (let e of n) try {
+				await t.insert("_voltro_traces", {
+					id: `${e.traceId}:${e.spanId}`,
+					traceId: e.traceId,
+					spanId: e.spanId,
+					parentSpanId: e.parentSpanId,
+					name: e.name,
+					kind: e.kind,
+					status: e.status,
+					statusMessage: e.statusMessage ?? null,
+					startedAt: new Date(e.startMs),
+					endedAt: new Date(e.endMs),
+					durationMs: Math.round(e.durationMs),
+					attributes: e.attributes,
+					events: e.events ?? null
+				});
+			} catch {}
+		}, l = setInterval(() => {
+			c();
+		}, 1e3);
+		l.unref?.(), a.push(l);
+	}
+	let s = r.ttlHours, c = 2e4, l = t.raw?.bind(t), u = async () => {
+		try {
+			let e = /* @__PURE__ */ new Date(Date.now() - s * 36e5), r = 0;
+			if (l) for (;;) {
+				let t = await l({
+					_tag: "RawSqlFragment",
+					strings: ["DELETE FROM \"_voltro_traces\" WHERE \"id\" IN (SELECT \"id\" FROM \"_voltro_traces\" WHERE \"startedAt\" < ", ` LIMIT ${c}) RETURNING "id"`],
+					values: [e]
+				});
+				if (r += t.length, t.length < c) break;
+			}
+			else for (;;) {
+				let n = await t.query({
+					table: "_voltro_traces",
+					order: [],
+					predicate: _("startedAt", e),
+					projection: ["id"],
+					skip: void 0,
+					take: c
+				});
+				if (n.length === 0) break;
+				for (let e of n) try {
+					await t.delete("_voltro_traces", e.id);
+				} catch {}
+				if (r += n.length, n.length < c) break;
+			}
+			r >= c && i("gc-volume", Date.now()) && n.warn(`trace GC pruned ${r} spans past the ${s}h TTL in one pass — high durable-trace volume. If _voltro_traces stays large, cut the inflow (VOLTRO_TRACING_PERSIST=errors|interesting, VOLTRO_TRACING_SAMPLE<1) or shorten VOLTRO_TRACING_TTL_HOURS.`);
+		} catch (e) {
+			i("gc-error", Date.now()) && n.warn(`trace GC pass failed — _voltro_traces may grow until this clears: ${e instanceof Error ? e.message : String(e)}`);
+		}
+	}, d = setInterval(() => {
+		u();
+	}, 5 * 6e4);
+	return d.unref?.(), a.push(d), {
+		persistTraceSpan: (e) => o(e),
+		stop: () => {
+			for (let e of a) clearInterval(e);
+		}
+	};
+}, Je = /\.(query|mutation|action|stream)\.ts$/, Ye = /\.(query|mutation|action|stream)\.server\.ts$/, K = /\.workflow\.tsx$/, q = /\.workflow\.server\.tsx$/, J = /\.workflow\.tsx?$/, Y = /\.trigger\.tsx?$/, X = /\.cron\.tsx?$/, Z = /\.webhook\.tsx?$/, Q = /\.outbox\.tsx?$/, Xe = /\.subscribe\.tsx?$/, Ze = /\.reaction\.tsx?$/, Qe = /\.aggregate\.tsx?$/, $e = /\.startup\.tsx?$/, et = /\.seed\.ts$/, tt = /\.relations\.ts$/, nt = /\.entity\.ts$|\.schema\.ts$|^schema\.ts$/, rt = (e) => J.test(e) && !K.test(e) && !q.test(e), it = async (e) => {
+	let t = !1, r = !1, i = !1, o = !1, s = !1, c = !1, l = async (e) => {
+		let u = await a.readdir(e, { withFileTypes: !0 }).catch(() => []);
+		for (let a of u) if (a.isDirectory()) {
+			if (a.name === "node_modules" || a.name === "dist" || a.name === ".framework" || a.name.startsWith(".")) continue;
+			await l(n(e, a.name));
+		} else {
+			let e = a.name;
+			(J.test(e) || Y.test(e)) && (t = !0), X.test(e) && (r = !0), Z.test(e) && (i = !0), F.test(e) && (o = !0), Q.test(e) && (s = !0), R.test(e) && (c = !0);
+		}
+	};
+	return await l(e), {
+		workflows: t,
+		schedules: r,
+		webhooks: i,
+		agents: o,
+		outbox: s,
+		connections: c
+	};
+}, at = async (e) => {
+	try {
+		return (await import(r(n(e, "app.config.ts")).href)).default?.plugins ?? [];
+	} catch {
+		return [];
+	}
+}, $ = (e) => {
+	let t = /* @__PURE__ */ new Map(), n = (e) => {
+		e?.tableName && !t.has(e.tableName) && t.set(e.tableName, e);
+	};
+	for (let t of O({
+		workflows: e.mix.workflows,
+		schedules: e.mix.schedules,
+		webhooks: e.mix.webhooks,
+		traces: G(),
+		cdc: e.cdc,
+		...e.cdcDialect ? { cdcDialect: e.cdcDialect } : {},
+		undo: ie(),
+		outbox: e.mix.outbox,
+		connections: e.mix.connections
+	})) n(t);
+	e.mix.agents && (n(le), n(ce), n(de), n(ue));
+	for (let t of ke(e.plugins)) n(t);
+	return [...t.values()];
+}, ot = async (e) => {
+	let t = await it(e.root), n = await at(e.root), r = (process.env.DB_DIALECT ?? "postgres").toLowerCase(), i = r === "mariadb" ? "mariadb" : r === "mssql" ? "mssql" : void 0;
+	return $({
+		mix: t,
+		plugins: n,
+		cdc: e.cdc ?? (i !== void 0 && (process.env.CDC ?? "1") !== "0"),
+		...i ? { cdcDialect: i } : {}
+	});
+};
+//#endregion
+export { Me as A, ze as C, F as D, Pe as E, xe as F, k as I, A as L, De as M, Oe as N, Ae as O, Se as P, O as R, V as S, R as T, J as _, Q as a, qe as b, Ze as c, et as d, $e as f, K as g, Z as h, X as i, L as j, I as k, tt as l, Y as m, $ as n, Je as o, Xe as p, Qe as r, Ye as s, ot as t, nt as u, q as v, B as w, G as x, rt as y };

package/dist/frameworkTableAssembly-XvKO7wQt.js

@@ -0,0 +1,2 @@
+import { t as e } from "./frameworkTableAssembly-CYlrafoK.js";
+export { e as assembleFrameworkTables };

package/dist/index.d.ts

@@ -1,5 +1,20 @@
 export declare const CLI_NAME: "framework";
 
+/**
+ * `voltro help` grouped by the job each command does, in the order a user meets
+ * them (scaffold → develop → data → build/run → deploy → observe → maintain).
+ *
+ * A FLAT list of 45 commands in registry order is unusable: most summaries run
+ * past 100 chars, so every line wraps and the whole thing reads as a paragraph
+ * wall. Here each line is one short lead sentence; the full summary is a
+ * `voltro <command> --help` away.
+ *
+ * Kept as one table rather than a `group` field on all 45 specs so the ordering
+ * is readable in one place. `commands.test.ts` asserts every visible command
+ * appears in exactly one group, so this can't drift when a command is added.
+ */
+export declare const COMMAND_GROUPS: ReadonlyArray<readonly [string, ReadonlyArray<string>]>;
+
 export declare const COMMANDS: ReadonlyArray<CommandSpec>;
 
 export declare type CommandSpec = {
@@ -24,6 +39,10 @@ export declare const listTemplates: () => Promise<ReadonlyArray<TemplateInfo>>;
 
 export declare const printUsage: () => void;
 
+/** Command names close enough to a typo to suggest. Also matches on prefix /
+ *  substring, so `voltro work` suggests `workflows`. Exported for the test. */
+export declare const suggestCommands: (input: string, limit?: number) => ReadonlyArray<string>;
+
 export declare interface TemplateInfo extends TemplateManifest {
     /** Absolute path to the template source directory. */
     readonly path: string;

package/dist/index.js

@@ -1,5 +1,5 @@
-import { a as e, n as t, r as n, t as r } from "./commands-BwbMqR-1.js";
+import { a as e, i as t, n, o as r, r as i, t as a } from "./commands-DYOuGlEC.js";
 //#region src/index.ts
-var i = "framework";
+var o = "framework";
 //#endregion
-export { i as CLI_NAME, r as COMMANDS, t as dispatch, e as listTemplates, n as printUsage };
+export { o as CLI_NAME, a as COMMANDS, n as COMMAND_GROUPS, i as dispatch, r as listTemplates, t as printUsage, e as suggestCommands };

package/dist/inspect-DcZ04OME.js

@@ -0,0 +1,2 @@
+import { r as e } from "./inspect-Dwx0_tUj.js";
+export { e as buildCapabilityManifest };