@metabase/cli 0.2.2 → 0.3.0

package/dist/cli.mjs

@@ -1,21 +1,133 @@
 #!/usr/bin/env node
-import { Capabilities, ConfigError, connectionFlags, flagConsumesValue, jsonLine, normalizeFlag, outputFlags, package_default, profileFlag, reportError, resolveCitty, toAliasArray } from "./capabilities-1HTHeDa4.mjs";
-import { getMetabaseAugment, setMetabaseAugment } from "./command-augment-D9pI9Vbh.mjs";
+import { i as ConfigError, m as toMetabaseError, n as AbortError, t as isPlainObject } from "./predicates-Bkm2IoeX.mjs";
 import { defineCommand, renderUsage, runMain } from "citty";
 import { z } from "zod";
 import tls from "node:tls";
-
+import { confirm, isCancel, password, select, text } from "@clack/prompts";
+import Table from "cli-table3";
+//#region src/runtime/citty.ts
+async function resolveCitty(value) {
+	if (value === void 0) return;
+	if (typeof value === "function") return value();
+	return value;
+}
+function toAliasArray(alias) {
+	if (alias === void 0) return [];
+	return Array.isArray(alias) ? alias : [alias];
+}
+function normalizeFlag(value) {
+	return value.replace(/^-+/, "").replace(/-/g, "").toLowerCase();
+}
+function flagConsumesValue(token, argsDef) {
+	if (token.includes("=")) return false;
+	const name = normalizeFlag(token);
+	for (const [key, def] of Object.entries(argsDef)) {
+		if (def.type !== "string" && def.type !== "enum") continue;
+		if (normalizeFlag(key) === name) return true;
+		if (toAliasArray(def.alias).some((alias) => normalizeFlag(alias) === name)) return true;
+	}
+	return false;
+}
+//#endregion
+//#region src/output/types.ts
+const DEFAULT_MAX_BYTES = 24576;
+function listEnvelopeSchema(item) {
+	return z.object({
+		data: z.array(item).describe("The items in this window."),
+		returned: z.number().int().nonnegative().describe("Number of items in `data`; a short window is not proof the walk is over."),
+		offset: z.number().int().nonnegative().describe("Index of the first item in `data` within the full result set."),
+		limit: z.number().int().nonnegative().optional().describe("Echoes `--limit` when you passed one, and is absent otherwise."),
+		total: z.number().int().nonnegative().nullable().optional().describe("The server's count on endpoints that report one and `null` on those that don't, so it is a display value rather than a loop bound."),
+		has_more: z.boolean().describe("True when more items exist beyond this window; this alone decides whether to keep going, never a comparison of counts. True with a `null` next_offset means the remaining items are reached by widening `--max-bytes` or narrowing the selection, not by paging."),
+		next_offset: z.number().int().nonnegative().nullable().optional().describe("Pass back as `--offset` to fetch the next window; it is past the offset you sent, and `null` when there is nowhere to resume from — either the walk is over or `--max-bytes` left no room for a single row, which `truncated` tells apart."),
+		truncated: z.object({
+			reason: z.literal("max_bytes"),
+			bytes: z.number().int().nonnegative()
+		}).optional().describe("Present when the `--max-bytes` cap cut the output, not when the data ran out; its `bytes` is what the untruncated answer would have measured, so narrow rows with `--fields` rather than raising the cap.")
+	});
+}
+//#endregion
+//#region src/commands/flags.ts
+const outputFlags = {
+	format: {
+		type: "string",
+		description: "auto | json | text",
+		default: "auto"
+	},
+	json: {
+		type: "boolean",
+		description: "Shorthand for --format json"
+	},
+	full: {
+		type: "boolean",
+		description: "Return the full object (default: compact)"
+	},
+	fields: {
+		type: "string",
+		description: "Dot-paths, comma separated (mutually exclusive with --full)"
+	},
+	maxBytes: {
+		type: "string",
+		description: "Output size cap; 0 disables",
+		default: String(DEFAULT_MAX_BYTES),
+		alias: "max-bytes"
+	}
+};
+const listFlags = {
+	limit: {
+		type: "string",
+		description: "Max items to return (default: as many as fit the output cap)"
+	},
+	offset: {
+		type: "string",
+		description: "Start at this item index; pass the previous run's next_offset to continue",
+		default: "0"
+	}
+};
+function listFlagsWithDefaultLimit(defaultLimit) {
+	return {
+		...listFlags,
+		limit: {
+			type: "string",
+			description: "Max items to return",
+			default: String(defaultLimit)
+		}
+	};
+}
+const profileFlag = { profile: {
+	type: "string",
+	description: "Named profile (default: 'default')",
+	alias: "p"
+} };
+const connectionFlags = {
+	url: {
+		type: "string",
+		description: "Metabase URL"
+	},
+	apiKey: {
+		type: "string",
+		description: "API key",
+		alias: "api-key"
+	},
+	skipPreflight: {
+		type: "boolean",
+		description: "Skip the server version capability check for this command",
+		alias: "skip-preflight"
+	}
+};
+//#endregion
 //#region src/commands/global-flags.ts
 const ARGUMENT_SEPARATOR = "--";
 const NEGATION_PREFIX = "no-";
 const GLOBAL_FLAG_ARGS = {
 	...outputFlags,
+	...listFlags,
 	...profileFlag,
 	...connectionFlags
 };
 const GLOBAL_FLAG_NAMES = buildGlobalFlagNames();
 function buildGlobalFlagNames() {
-	const names = new Set();
+	const names = /* @__PURE__ */ new Set();
 	for (const [key, def] of Object.entries(GLOBAL_FLAG_ARGS)) {
 		names.add(normalizeFlag(key));
 		if ("alias" in def) for (const alias of toAliasArray(def.alias)) names.add(normalizeFlag(alias));
@@ -28,7 +140,7 @@ function isGlobalFlag(token) {
 	const name = normalizeFlag(raw);
 	if (GLOBAL_FLAG_NAMES.has(name)) return true;
 	const bare = raw.replace(/^-+/, "");
-	if (bare.startsWith(NEGATION_PREFIX)) return GLOBAL_FLAG_NAMES.has(normalizeFlag(bare.slice(NEGATION_PREFIX.length)));
+	if (bare.startsWith(NEGATION_PREFIX)) return GLOBAL_FLAG_NAMES.has(normalizeFlag(bare.slice(3)));
 	return false;
 }
 function hoistGlobalFlags(rawArgs) {
@@ -50,9 +162,8 @@ function hoistGlobalFlags(rawArgs) {
 	if (leading.length === 0) return [...rawArgs];
 	return [...rawArgs.slice(index), ...leading];
 }
-
 //#endregion
-//#region src/core/http/system-ca.ts
+//#region src/core/system-ca.ts
 function trustSystemCa() {
 	const canReadSystemStore = typeof tls.getCACertificates === "function";
 	const canReplaceDefaults = typeof tls.setDefaultCACertificates === "function";
@@ -61,45 +172,58 @@ function trustSystemCa() {
 	if (systemCerts.length === 0) return;
 	tls.setDefaultCACertificates([...tls.getCACertificates("default"), ...systemCerts]);
 }
-
+//#endregion
+//#region package.json
+var name = "@metabase/cli";
+var version = "0.3.0";
+var description = "Metabase CLI";
+//#endregion
+//#region src/runtime/command-augment.ts
+const augments = /* @__PURE__ */ new WeakMap();
+function setMetabaseAugment(cmd, augment) {
+	augments.set(cmd, augment);
+}
+function getMetabaseAugment(cmd) {
+	return augments.get(cmd) ?? null;
+}
 //#endregion
 //#region src/main.ts
 const main = defineCommand({
 	meta: {
 		name: "mb",
-		version: package_default.version,
-		description: package_default.description
+		version,
+		description
 	},
 	subCommands: {
-		auth: () => import("./auth-B8Yb4ZaN.mjs").then((mod) => mod.default),
-		db: () => import("./db-BiLWl1J9.mjs").then((mod) => mod.default),
-		table: () => import("./table-BK56VDw8.mjs").then((mod) => mod.default),
-		field: () => import("./field-P7aJaet9.mjs").then((mod) => mod.default),
-		upload: () => import("./upload-WT6SywFa.mjs").then((mod) => mod.default),
-		card: () => import("./card-BT7ce7uO.mjs").then((mod) => mod.default),
-		dashboard: () => import("./dashboard-C__PiWrv.mjs").then((mod) => mod.default),
-		subscription: () => import("./subscription-BOOBR5Ir.mjs").then((mod) => mod.default),
-		alert: () => import("./alert-DGcECcDb.mjs").then((mod) => mod.default),
-		collection: () => import("./collection-ahFSJT-e.mjs").then((mod) => mod.default),
-		library: () => import("./library-BFZYsBcz.mjs").then((mod) => mod.default),
-		document: () => import("./document-C9ykHYOG.mjs").then((mod) => mod.default),
-		transform: () => import("./transform-ATK6rJBl.mjs").then((mod) => mod.default),
-		"transform-job": () => import("./transform-job-BezBE6Y8.mjs").then((mod) => mod.default),
-		"transform-tag": () => import("./transform-tag-GqbcG_6_.mjs").then((mod) => mod.default),
-		setting: () => import("./setting-CApPg0Xr.mjs").then((mod) => mod.default),
-		search: () => import("./search-msFNbxU6.mjs").then((mod) => mod.default),
-		"git-sync": () => import("./git-sync-BzievbUz.mjs").then((mod) => mod.default),
-		setup: () => import("./setup-CruHFQJz.mjs").then((mod) => mod.default),
-		snippet: () => import("./snippet-DdoeL-7N.mjs").then((mod) => mod.default),
-		segment: () => import("./segment-BIKVTq_n.mjs").then((mod) => mod.default),
-		measure: () => import("./measure-DNldT89z.mjs").then((mod) => mod.default),
-		timeline: () => import("./timeline-Dl5pm5tN.mjs").then((mod) => mod.default),
-		"timeline-event": () => import("./timeline-event-5JAeGVSI.mjs").then((mod) => mod.default),
-		eid: () => import("./eid-DcCAs-RP.mjs").then((mod) => mod.default),
-		query: () => import("./query-DpVWKW-y.mjs").then((mod) => mod.default),
-		uuid: () => import("./uuid-D7NcSTj8.mjs").then((mod) => mod.default),
-		upgrade: () => import("./upgrade-D0HiyTxw.mjs").then((mod) => mod.default),
-		skills: () => import("./skills-CxqkjkdQ.mjs").then((mod) => mod.default)
+		auth: () => import("./auth-Dltxua89.mjs").then((mod) => mod.default),
+		db: () => import("./db-DsfojyeH.mjs").then((mod) => mod.default),
+		table: () => import("./table-DYoC1kPn.mjs").then((mod) => mod.default),
+		field: () => import("./field-Zau6Hc6X.mjs").then((mod) => mod.default),
+		upload: () => import("./upload-Dey_8rLf.mjs").then((mod) => mod.default),
+		card: () => import("./card-CHI2bmds.mjs").then((mod) => mod.default),
+		dashboard: () => import("./dashboard-BHJBoaG7.mjs").then((mod) => mod.default),
+		subscription: () => import("./subscription-_d5fB45F.mjs").then((mod) => mod.default),
+		alert: () => import("./alert-DT-ee7yf.mjs").then((mod) => mod.default),
+		collection: () => import("./collection-CY0AB99E.mjs").then((mod) => mod.default),
+		library: () => import("./library-Bsm5KsFF.mjs").then((mod) => mod.default),
+		document: () => import("./document-BbskZPTT.mjs").then((mod) => mod.default),
+		transform: () => import("./transform-Bs0EWijQ.mjs").then((mod) => mod.default),
+		"transform-job": () => import("./transform-job-BcLChRup.mjs").then((mod) => mod.default),
+		"transform-tag": () => import("./transform-tag-_tgwlsdB.mjs").then((mod) => mod.default),
+		setting: () => import("./setting-DyhaeICs.mjs").then((mod) => mod.default),
+		search: () => import("./search-DmGScXs8.mjs").then((mod) => mod.default),
+		"git-sync": () => import("./git-sync-MQQYRYLg.mjs").then((mod) => mod.default),
+		setup: () => import("./setup-BbDQN8fe.mjs").then((mod) => mod.default),
+		snippet: () => import("./snippet-DRwKb2x7.mjs").then((mod) => mod.default),
+		segment: () => import("./segment-BzUGM2Fr.mjs").then((mod) => mod.default),
+		measure: () => import("./measure-BsYv0p26.mjs").then((mod) => mod.default),
+		timeline: () => import("./timeline-xlDbEKWg.mjs").then((mod) => mod.default),
+		"timeline-event": () => import("./timeline-event-CNQdCTDg.mjs").then((mod) => mod.default),
+		eid: () => import("./eid-WTZmDdsr.mjs").then((mod) => mod.default),
+		query: () => import("./query-Dc__-KJH.mjs").then((mod) => mod.default),
+		uuid: () => import("./uuid-BJkDWj9p.mjs").then((mod) => mod.default),
+		upgrade: () => import("./upgrade-DXMV4AyP.mjs").then((mod) => mod.default),
+		skills: () => import("./skills--vK6J-e4.mjs").then((mod) => mod.default)
 	}
 });
 setMetabaseAugment(main, {
@@ -116,8 +240,449 @@ setMetabaseAugment(main, {
 	outputSchema: null,
 	capabilities: null
 });
-var main_default = main;
-
+//#endregion
+//#region src/core/env.ts
+const LEGACY_PREFIX = "METABASE_";
+const ENV_URL = "MB_URL";
+const ENV_API_KEY = "MB_API_KEY";
+const ENV_PROFILE = "MB_PROFILE";
+const ENV_VERBOSE = "MB_VERBOSE";
+const ENV_SKIP_PREFLIGHT = "MB_CLI_SKIP_PREFLIGHT";
+const ENV_DISABLE_KEYRING = "MB_CLI_DISABLE_KEYRING";
+const ENV_SKILLS_DIR = "MB_SKILLS_DIR";
+function legacyNameFor(canonical) {
+	return LEGACY_PREFIX + canonical.slice(3);
+}
+const legacyVarsUsed = /* @__PURE__ */ new Set();
+function readEnv(canonical) {
+	const direct = process.env[canonical];
+	if (direct !== void 0) return direct;
+	const legacyValue = process.env[legacyNameFor(canonical)];
+	if (legacyValue !== void 0) {
+		legacyVarsUsed.add(canonical);
+		return legacyValue;
+	}
+}
+function consumeLegacyEnvWarnings() {
+	if (legacyVarsUsed.size === 0) return [];
+	const messages = [...legacyVarsUsed].map(legacyEnvWarning);
+	legacyVarsUsed.clear();
+	return messages;
+}
+function legacyEnvWarning(canonical) {
+	return `warning: ${legacyNameFor(canonical)} is deprecated; set ${canonical} instead`;
+}
+//#endregion
+//#region src/output/notice.ts
+function warn(message) {
+	process.stderr.write(message + "\n");
+}
+const LIST_TRUNCATION_REMEDY = "narrow the selection or raise --max-bytes";
+function listTruncationNotice(bytes, nextOffset, hint) {
+	return `… cut at ${bytes} bytes; ${typeof nextOffset === "number" ? `continue with --offset ${nextOffset}, ` : ""}${hint ?? LIST_TRUNCATION_REMEDY}`;
+}
+const ITEM_OVERSIZE_REMEDY = "narrow with --fields or raise the cap with --max-bytes <n>";
+function itemOversizeMessage(bytes, maxBytes, hint) {
+	return `output is ${bytes} bytes, over the ${maxBytes}-byte --max-bytes cap; ${hint ?? ITEM_OVERSIZE_REMEDY}`;
+}
+//#endregion
+//#region src/output/prompt.ts
+function isPromptCancel(value) {
+	return isCancel(value);
+}
+async function promptText(opts) {
+	requireTty(opts.message);
+	const value = await text({
+		message: opts.message,
+		defaultValue: "",
+		...opts.placeholder !== void 0 && { placeholder: opts.placeholder },
+		...opts.initialValue !== void 0 && { initialValue: opts.initialValue },
+		...opts.defaultValue !== void 0 && { defaultValue: opts.defaultValue },
+		...opts.validate !== void 0 && { validate: opts.validate }
+	});
+	if (isCancel(value)) throw new AbortError();
+	return value;
+}
+async function promptPassword(opts) {
+	requireTty(opts.message);
+	const value = await password({
+		message: opts.message,
+		...opts.mask !== void 0 && { mask: opts.mask },
+		...opts.validate !== void 0 && { validate: opts.validate }
+	});
+	if (isCancel(value)) throw new AbortError();
+	return value;
+}
+async function promptConfirm(opts) {
+	requireTty(opts.message);
+	const value = await confirm({
+		message: opts.message,
+		...opts.initialValue !== void 0 && { initialValue: opts.initialValue }
+	});
+	if (isCancel(value)) throw new AbortError();
+	return value;
+}
+async function promptSelect(opts) {
+	requireTty(opts.message);
+	const value = await select({
+		message: opts.message,
+		options: opts.choices,
+		...opts.initialValue !== void 0 && { initialValue: opts.initialValue }
+	});
+	if (isCancel(value)) throw new AbortError();
+	return value;
+}
+function requireTty(prompt) {
+	if (!process.stdin.isTTY) throw new ConfigError(`cannot prompt "${prompt}" — stdin is not a TTY`);
+}
+//#endregion
+//#region src/output/cap.ts
+function fitWithinCap(envelope, maxBytes) {
+	const fullBytes = jsonByteLength(envelope);
+	if (maxBytes <= 0 || fullBytes <= maxBytes) return {
+		count: envelope.data.length,
+		fullBytes,
+		cut: false
+	};
+	let lo = 0;
+	let hi = envelope.data.length;
+	while (lo < hi) {
+		const mid = Math.ceil((lo + hi) / 2);
+		if (jsonByteLength(truncate(envelope, mid, fullBytes)) <= maxBytes) lo = mid;
+		else hi = mid - 1;
+	}
+	return {
+		count: lo,
+		fullBytes,
+		cut: true
+	};
+}
+function capListEnvelope(envelope, maxBytes) {
+	const fit = fitWithinCap(envelope, maxBytes);
+	if (!fit.cut || envelope.data.length === 0) return envelope;
+	return truncate(envelope, fit.count, fit.fullBytes);
+}
+function truncate(envelope, count, originalBytes) {
+	return {
+		...envelope,
+		data: envelope.data.slice(0, count),
+		returned: count,
+		has_more: true,
+		next_offset: count === 0 ? null : envelope.offset + count,
+		truncated: {
+			reason: "max_bytes",
+			bytes: originalBytes
+		}
+	};
+}
+function jsonByteLength(value) {
+	return Buffer.byteLength(JSON.stringify(value), "utf8");
+}
+//#endregion
+//#region src/output/projection.ts
+function projectForList(item, view, opts) {
+	const full = opts.format === "text" && opts.fields === void 0 ? false : opts.full;
+	try {
+		return applyProjection(item, view, full, opts.fields);
+	} catch (error) {
+		throw enrichListFieldPathError(error, opts.fields);
+	}
+}
+function enrichListFieldPathError(error, fields) {
+	if (fields === void 0 || !(error instanceof ConfigError) || !error.message.startsWith("unknown field path")) return error;
+	const prefix = "data.";
+	const culprit = fields.find((field) => field === "data" || field.startsWith(prefix));
+	if (culprit === void 0) return error;
+	const suggestion = culprit.startsWith(prefix) ? culprit.slice(5) : "<field>";
+	return new ConfigError(`${error.message} — on list commands --fields paths are relative to each item in \`data\`, not the envelope. Drop the \`data.\` prefix (e.g. use \`${suggestion}\` instead of \`${culprit}\`).`);
+}
+function applyProjection(value, view, full, fields) {
+	if (fields !== void 0) {
+		if (fields.length === 0) throw new ConfigError("--fields requires at least one path");
+		return projectFields(value, fields);
+	}
+	if (full) return value;
+	const parsed = view.compactPick.safeParse(value);
+	if (parsed.success) return parsed.data;
+	throw new ConfigError(`compact projection failed: ${parsed.error.message}`);
+}
+function projectFields(value, fields) {
+	const out = {};
+	for (const path of fields) {
+		if (path.length === 0) throw new ConfigError(`empty field path`);
+		const parts = path.split(".");
+		if (parts.some((part) => part.length === 0)) throw new ConfigError(`invalid field path: "${path}"`);
+		setPath(out, parts, pickPath(value, parts));
+	}
+	return out;
+}
+function pickPath(value, parts) {
+	let cursor = value;
+	for (const part of parts) {
+		if (!isPlainObject(cursor) || !Object.hasOwn(cursor, part)) throw new ConfigError(`unknown field path: "${parts.join(".")}"`);
+		cursor = Reflect.get(cursor, part);
+	}
+	return cursor;
+}
+function setPath(target, parts, value) {
+	let cursor = target;
+	const lastIndex = parts.length - 1;
+	for (const [index, part] of parts.entries()) {
+		if (index === lastIndex) {
+			cursor[part] = value;
+			return;
+		}
+		const existing = cursor[part];
+		if (isPlainObject(existing)) cursor = existing;
+		else {
+			const next = {};
+			cursor[part] = next;
+			cursor = next;
+		}
+	}
+}
+//#endregion
+//#region src/output/table.ts
+const PLAIN_TABLE_STYLE = {
+	head: [],
+	border: []
+};
+function renderTable(rows, columns) {
+	const head = columns.map((column) => column.label ?? column.key);
+	const widths = columns.map((column) => column.width ?? null);
+	const table = new Table(widths.some((width) => width !== null) ? {
+		head,
+		colWidths: widths,
+		style: PLAIN_TABLE_STYLE
+	} : {
+		head,
+		style: PLAIN_TABLE_STYLE
+	});
+	for (const row of rows) table.push(columns.map((column) => formatCell(row, column)));
+	return table.toString();
+}
+function renderRows(head, rows) {
+	const table = new Table({
+		head: [...head],
+		style: PLAIN_TABLE_STYLE
+	});
+	for (const row of rows) table.push([...row]);
+	return table.toString();
+}
+function formatCell(row, column) {
+	const value = row[column.key];
+	if (column.format !== void 0) return column.format(value);
+	return formatScalar(value);
+}
+const MALFORMED_CELL = "<malformed>";
+function formatScalar(value) {
+	if (value === null || value === void 0) return "";
+	if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") return String(value);
+	return JSON.stringify(value);
+}
+//#endregion
+//#region src/output/render.ts
+function serializeJson(value, pretty) {
+	return JSON.stringify(value, null, pretty ? 2 : void 0);
+}
+function stdoutPretty() {
+	return process.stdout.isTTY === true;
+}
+function jsonLine(value) {
+	return serializeJson(value, stdoutPretty()) + "\n";
+}
+function writeJson(value) {
+	process.stdout.write(jsonLine(value));
+}
+function writeText(text) {
+	process.stdout.write(text + "\n");
+}
+function renderItem(item, view, opts) {
+	const body = renderItemBody(item, view, applyProjection(item, view, opts.full, opts.fields), opts) + "\n";
+	assertItemWithinMaxBytes(body, opts);
+	process.stdout.write(body);
+}
+function renderSummary(item, view, summaryText, opts) {
+	if (opts.format === "json" || opts.fields !== void 0 || opts.full) {
+		renderItem(item, view, opts);
+		return;
+	}
+	const body = (typeof summaryText === "function" ? summaryText() : summaryText) + "\n";
+	assertItemWithinMaxBytes(body, opts);
+	process.stdout.write(body);
+}
+function renderList(envelope, view, opts) {
+	if (opts.format === "json") {
+		renderJsonEnvelope(envelope, view, opts);
+		return;
+	}
+	if (envelope.data.length === 0) {
+		process.stdout.write("(no results)\n");
+		return;
+	}
+	if (opts.fields !== void 0) {
+		renderProjectedTable(envelope, view, opts.fields, opts);
+		return;
+	}
+	const fit = fitWithinCap(projectedEnvelope(envelope, view, opts), opts.maxBytes);
+	const kept = envelope.data.slice(0, fit.count);
+	process.stdout.write(renderTable(kept, view.tableColumns) + "\n");
+	warnIfCut(fit, envelope.offset, opts.oversizeHint);
+}
+function warnIfCut(fit, offset, hint) {
+	if (!fit.cut) return;
+	warn(listTruncationNotice(fit.fullBytes, fit.count === 0 ? null : offset + fit.count, hint));
+}
+function renderProjectedTable(envelope, view, fields, opts) {
+	const projected = projectedEnvelope(envelope, view, opts);
+	const fit = fitWithinCap(projected, opts.maxBytes);
+	const rows = projected.data.slice(0, fit.count).map((item) => fields.map((path) => formatScalar(pickPath(item, path.split(".")))));
+	process.stdout.write(renderRows(fields, rows) + "\n");
+	warnIfCut(fit, envelope.offset, opts.oversizeHint);
+}
+function projectedEnvelope(envelope, view, opts) {
+	return {
+		...envelope,
+		data: envelope.data.map((item) => projectForList(item, view, opts))
+	};
+}
+function renderJsonEnvelope(envelope, view, opts) {
+	const capped = capListEnvelope(projectedEnvelope(envelope, view, opts), opts.maxBytes);
+	const ordered = {
+		returned: capped.returned,
+		offset: capped.offset,
+		limit: capped.limit,
+		total: capped.total,
+		has_more: capped.has_more,
+		next_offset: capped.next_offset,
+		truncated: capped.truncated,
+		data: capped.data
+	};
+	process.stdout.write(serializeJson(ordered, stdoutPretty()) + "\n");
+	if (capped.truncated !== void 0) warn(listTruncationNotice(capped.truncated.bytes, capped.next_offset, opts.oversizeHint));
+}
+function renderItemBody(item, view, projected, opts) {
+	if (opts.format === "json") return serializeJson(projected, stdoutPretty());
+	if (opts.fields !== void 0 || opts.full) return renderKeyValueLines(objectPairs(projected));
+	return renderKeyValueLines(columnPairs(item, view.tableColumns));
+}
+function columnPairs(item, columns) {
+	return columns.map((column) => [column.label ?? column.key, formatCell(item, column)]);
+}
+function objectPairs(value) {
+	if (!isPlainObject(value)) {
+		const scalar = formatScalar(value);
+		return scalar === "" ? [] : [["", scalar]];
+	}
+	return Object.entries(value).map(([key, raw]) => [key, formatScalar(raw)]);
+}
+function renderKeyValueLines(pairs) {
+	if (pairs.length === 0) return "";
+	const padding = Math.max(...pairs.map(([label]) => label.length));
+	return pairs.map(([label, value]) => `${label.padEnd(padding)}  ${value}`).join("\n");
+}
+function assertItemWithinMaxBytes(body, opts) {
+	if (opts.maxBytes <= 0) return;
+	const bytes = Buffer.byteLength(body, "utf8");
+	if (bytes <= opts.maxBytes) return;
+	throw new ConfigError(itemOversizeMessage(bytes, opts.maxBytes, opts.oversizeHint));
+}
+//#endregion
+//#region src/output/error.ts
+const DOWNGRADE_REMEDY = "Or install an `@metabase/cli` release that targets this server.";
+const ROUTE_MISSING_REMEDY = "Run `mb auth list` to see this server's version.";
+const ROUTE_MISSING_KIND = "route-missing";
+const FAILURE_EXIT_CODE = 1;
+const USAGE_EXIT_CODE = 2;
+const INTERRUPTED_EXIT_CODE = 130;
+function exitCodeFor(category) {
+	switch (category) {
+		case "config":
+		case "capability": return USAGE_EXIT_CODE;
+		case "abort": return INTERRUPTED_EXIT_CODE;
+		case "network":
+		case "http":
+		case "validation":
+		case "response-shape":
+		case "timeout":
+		case "internal":
+		case "unknown": return FAILURE_EXIT_CODE;
+	}
+}
+function reportError(error, format) {
+	const handled = isPromptCancel(error) ? new AbortError() : toMetabaseError(error);
+	const verbose = readEnv(ENV_VERBOSE) === "1";
+	const exitCode = exitCodeFor(handled.category);
+	if (format === "json") writeJsonError(handled, exitCode, verbose);
+	else writeTextError(handled, verbose);
+	for (const message of consumeLegacyEnvWarnings()) warn(message);
+	process.exitCode = exitCode;
+}
+function isVersionTooOld(detail) {
+	return typeof detail === "object" && detail !== null && "reason" in detail && detail.reason === "version-too-old";
+}
+function isRouteMissing(handled) {
+	return "kind" in handled && handled.kind === ROUTE_MISSING_KIND;
+}
+function remediesFor(handled) {
+	if (isVersionTooOld(handled.developerDetail)) return [DOWNGRADE_REMEDY];
+	if (isRouteMissing(handled)) return [ROUTE_MISSING_REMEDY];
+	return [];
+}
+function writeTextError(handled, verbose) {
+	process.stderr.write(handled.userMessage + "\n");
+	for (const remedy of remediesFor(handled)) process.stderr.write(remedy + "\n");
+	if (handled.developerDetail === null) return;
+	if (verbose) process.stderr.write(serializeJson(handled.developerDetail, stderrPretty()) + "\n");
+	else process.stderr.write("(rerun with MB_VERBOSE=1 for details)\n");
+}
+function stderrPretty() {
+	return process.stderr.isTTY === true;
+}
+function writeJsonError(handled, exitCode, verbose) {
+	const payload = {
+		category: handled.category,
+		message: [handled.userMessage, ...remediesFor(handled)].join("\n"),
+		exitCode
+	};
+	if (verbose && handled.developerDetail !== null) payload.detail = handled.developerDetail;
+	const envelope = {
+		ok: false,
+		error: payload
+	};
+	process.stderr.write(serializeJson(envelope, stderrPretty()) + "\n");
+}
+//#endregion
+//#region ../client/src/version/capabilities.ts
+const Capabilities = z.object({
+	minVersion: z.number(),
+	tokenFeature: z.string().optional()
+});
+const BASELINE_CAPABILITIES = Object.freeze({ minVersion: 58 });
+function mergeCapabilities(overrides) {
+	if (overrides === void 0) return BASELINE_CAPABILITIES;
+	return {
+		minVersion: overrides.minVersion ?? BASELINE_CAPABILITIES.minVersion,
+		...overrides.tokenFeature === void 0 ? {} : { tokenFeature: overrides.tokenFeature }
+	};
+}
+function checkCapabilities(info, required) {
+	if (info.version === null) return {
+		reason: "unknown-version",
+		detail: "Could not detect Metabase server version. Proceeding without preflight check; failures may produce confusing errors."
+	};
+	if (info.version.major < required.minVersion) return {
+		reason: "version-too-old",
+		detail: `This operation requires Metabase v${required.minVersion}+ (this server is ${info.version.tag}). Upgrade Metabase to use it.`
+	};
+	if (required.tokenFeature !== void 0) {
+		if (!(info.tokenFeatures?.[required.tokenFeature] === true)) return {
+			reason: "missing-token-feature",
+			detail: `This operation requires the '${required.tokenFeature}' premium feature (not enabled on this server).`
+		};
+	}
+	return null;
+}
 //#endregion
 //#region src/runtime/command-help.ts
 const CommandHelpArg = z.object({
@@ -142,9 +707,9 @@ const CommandHelpSkill = z.object({
 	skill: z.string(),
 	purpose: z.string()
 });
-const CommandHelpEntry = z.object({
+z.object({
 	command: z.string(),
-	description: z.string(),
+	description: z.string().nullable(),
 	details: z.string().optional(),
 	skills: z.array(CommandHelpSkill),
 	examples: z.array(z.string()),
@@ -155,9 +720,13 @@ const CommandHelpEntry = z.object({
 });
 const CommandIndexEntry = z.object({
 	command: z.string(),
-	description: z.string()
+	description: z.string().nullable()
+});
+z.object({
+	description: z.string().nullable(),
+	skills: z.array(CommandHelpSkill),
+	commands: z.array(CommandIndexEntry)
 });
-const CommandHelpIndex = z.object({ commands: z.array(CommandIndexEntry) });
 const EMPTY_AUGMENT = {
 	examples: [],
 	details: null,
@@ -184,27 +753,29 @@ async function buildHelpEntry(cmd, path) {
 	return entry;
 }
 async function buildHelpIndex(cmd, path) {
-	return { commands: await walk(cmd, path) };
+	const meta = await resolveCitty(cmd.meta);
+	const augment = getMetabaseAugment(cmd) ?? EMPTY_AUGMENT;
+	return {
+		description: readDescription(meta),
+		skills: Array.from(augment.skills),
+		commands: await walk(cmd, path)
+	};
 }
 async function walk(cmd, path) {
 	const meta = await resolveCitty(cmd.meta);
 	if (meta?.hidden === true) return [];
 	const subCommands = await resolveCitty(cmd.subCommands);
-	if (subCommands && Object.keys(subCommands).length > 0) {
-		const groups = await Promise.all(Object.entries(subCommands).map(async ([name, lazy]) => {
-			const sub = await resolveCitty(lazy);
-			return sub ? walk(sub, [...path, name]) : [];
-		}));
-		return groups.flat();
-	}
+	if (subCommands && Object.keys(subCommands).length > 0) return (await Promise.all(Object.entries(subCommands).map(async ([name, lazy]) => {
+		const sub = await resolveCitty(lazy);
+		return sub ? walk(sub, [...path, name]) : [];
+	}))).flat();
 	return [{
 		command: path.join(" "),
 		description: readDescription(meta)
 	}];
 }
 function readDescription(meta) {
-	if (meta === void 0) return "";
-	return typeof meta.description === "string" ? meta.description : "";
+	return typeof meta?.description === "string" ? meta.description : null;
 }
 function convertArgs(args) {
 	return Object.entries(args).map(([name, def]) => convertArg(name, def));
@@ -233,11 +804,7 @@ function readAlias(def) {
 function isPrimitiveDefault(value) {
 	return typeof value === "string" || typeof value === "boolean" || typeof value === "number";
 }
-
-//#endregion
-//#region src/output/help.ts
-const ANSI_ESC = String.fromCharCode(27);
-const ANSI_PATTERN = new RegExp(`${ANSI_ESC}\\[[0-9;]*m`, "g");
+const ANSI_PATTERN = new RegExp(`\\[[0-9;]*m`, "g");
 const BREADCRUMB_SUFFIX = / \([^()]*\)\s*$/;
 const TRAILING_WHITESPACE = /[ \t]+$/;
 const ALIAS_PAIR = /-([a-z0-9]+(?:-[a-z0-9]+)+), --[A-Za-z0-9]+/g;
@@ -253,8 +820,7 @@ const GETTING_STARTED_HINT = `First time? Run \`${CLI_NAME} auth login\` to conn
 const SKILLS_HEADER = "AGENT SKILLS";
 const SKILLS_LIST_ITEM = `${CLI_NAME} skills list — every bundled skill`;
 async function showUsage(cmd, parent, breadcrumb) {
-	const raw = (await renderUsage(cmd, parent)).replace(ANSI_PATTERN, "");
-	const lines = raw.split("\n").map((line) => line.replace(TRAILING_WHITESPACE, ""));
+	const lines = (await renderUsage(cmd, parent)).replace(ANSI_PATTERN, "").split("\n").map((line) => line.replace(TRAILING_WHITESPACE, ""));
 	const cmdMeta = await resolveCitty(cmd.meta);
 	const parentMeta = parent === void 0 ? void 0 : await resolveCitty(parent.meta);
 	const cmdName = cmdMeta?.name ?? "";
@@ -265,13 +831,11 @@ async function showUsage(cmd, parent, breadcrumb) {
 	const details = augment?.details ?? null;
 	const examples = augment?.examples ?? [];
 	const skills = augment?.skills ?? [];
-	const transformed = transformBody(lines, {
+	const sections = [withDetails(transformBody(lines, {
 		cittyName,
 		breadcrumb: breadcrumb ?? cittyName,
 		hasSubCommands
-	});
-	const body = withDetails(transformed, details).join("\n").trimEnd();
-	const sections = [body];
+	}), details).join("\n").trimEnd()];
 	if (examples.length > 0) sections.push(renderExamples(examples));
 	if (skills.length > 0) sections.push(renderSkillsSection(skills, isRoot));
 	if (isRoot) sections.push(GETTING_STARTED_HINT);
@@ -281,9 +845,7 @@ async function showUsage(cmd, parent, breadcrumb) {
 async function showUsageJson(cmd, breadcrumb) {
 	const path = breadcrumbPath(breadcrumb);
 	const subCommands = await resolveCitty(cmd.subCommands);
-	const hasSubCommands = subCommands !== void 0 && Object.keys(subCommands).length > 0;
-	const payload = hasSubCommands ? await buildHelpIndex(cmd, path) : await buildHelpEntry(cmd, path);
-	await writeUsage(jsonLine(payload));
+	await writeUsage(jsonLine(subCommands !== void 0 && Object.keys(subCommands).length > 0 ? await buildHelpIndex(cmd, path) : await buildHelpEntry(cmd, path)));
 }
 function writeUsage(text) {
 	return new Promise((resolve, reject) => {
@@ -297,20 +859,18 @@ function breadcrumbPath(breadcrumb) {
 const MACHINE_HELP_LEAF_LABEL = "Machine-readable help (flags, output schema):";
 const MACHINE_HELP_INDEX_LABEL = "Machine-readable command index:";
 function machineHelpHint(breadcrumb, hasSubCommands) {
-	const label = hasSubCommands ? MACHINE_HELP_INDEX_LABEL : MACHINE_HELP_LEAF_LABEL;
-	return `${label} ${breadcrumb} --help --json`;
+	return `${hasSubCommands ? MACHINE_HELP_INDEX_LABEL : MACHINE_HELP_LEAF_LABEL} ${breadcrumb} --help --json`;
 }
 function transformBody(lines, rewrite) {
-	const mapped = lines.map((line, index) => {
+	return injectHelpOption(lines.map((line, index) => {
 		if (index === 0) return line.replace(BREADCRUMB_SUFFIX, "");
 		if (line.startsWith(USAGE_PREFIX)) return rewriteUsageLine(line, rewrite);
 		return fixAliasRow(line);
-	});
-	return injectHelpOption(mapped);
+	}));
 }
 function rewriteUsageLine(line, rewrite) {
 	if (rewrite.hasSubCommands) return `${USAGE_PREFIX}${rewrite.breadcrumb} ${COMMAND_PLACEHOLDER}`;
-	const content = line.slice(USAGE_PREFIX.length);
+	const content = line.slice(6);
 	if (!content.startsWith(rewrite.cittyName)) return line;
 	const rest = content.slice(rewrite.cittyName.length);
 	return `${USAGE_PREFIX}${rewrite.breadcrumb}${rest}`;
@@ -425,9 +985,8 @@ async function findSubCommand(subCommands, token) {
 	if (direct !== void 0) {
 		const command = await resolveCitty(direct);
 		if (command === void 0) return null;
-		const meta = await resolveCitty(command.meta);
 		return {
-			name: meta?.name ?? token,
+			name: (await resolveCitty(command.meta))?.name ?? token,
 			command
 		};
 	}
@@ -442,17 +1001,37 @@ async function findSubCommand(subCommands, token) {
 	}
 	return null;
 }
-
+//#endregion
+//#region src/runtime/interrupt.ts
+const INTERRUPT_REASON = new AbortError("interrupted");
+const INTERRUPT_EXIT_CODE = exitCodeFor(INTERRUPT_REASON.category);
+const controller = new AbortController();
+const interruptSignal = controller.signal;
+function abortOnInterrupt() {
+	if (!controller.signal.aborted) controller.abort(INTERRUPT_REASON);
+}
+const FORCED_EXIT_GRACE_MS = 2e3;
+function installInterruptHandler(exit) {
+	process.on("SIGINT", () => {
+		if (interruptSignal.aborted) {
+			exit(INTERRUPT_EXIT_CODE);
+			return;
+		}
+		abortOnInterrupt();
+		setTimeout(() => exit(INTERRUPT_EXIT_CODE), FORCED_EXIT_GRACE_MS).unref();
+	});
+}
 //#endregion
 //#region src/cli.ts
-const HELP_FLAGS = new Set(["--help", "-h"]);
+const HELP_FLAGS = /* @__PURE__ */ new Set(["--help", "-h"]);
 const JSON_HELP_FLAG = "--json";
 async function run() {
+	installInterruptHandler((code) => process.exit(code));
 	trustSystemCa();
 	const rawArgs = hoistGlobalFlags(process.argv.slice(2));
 	const wantsJsonHelp = rawArgs.includes(JSON_HELP_FLAG);
 	const showUsageWithBreadcrumb = async (cmd, parent) => {
-		const breadcrumb = await resolveBreadcrumb(main_default, rawArgs);
+		const breadcrumb = await resolveBreadcrumb(main, rawArgs);
 		if (wantsJsonHelp) {
 			await showUsageJson(cmd, breadcrumb);
 			return;
@@ -460,17 +1039,17 @@ async function run() {
 		await showUsage(cmd, parent, breadcrumb);
 	};
 	if (rawArgs.length === 0) {
-		await showUsageWithBreadcrumb(main_default);
+		await showUsageWithBreadcrumb(main);
 		return;
 	}
 	if (!rawArgs.some((arg) => HELP_FLAGS.has(arg))) {
-		const unknown = await findUnknownCommand(main_default, rawArgs);
+		const unknown = await findUnknownCommand(main, rawArgs);
 		if (unknown !== null) {
 			reportError(new ConfigError(`unknown command: ${unknown}`));
 			return;
 		}
 	}
-	await runMain(main_default, {
+	await runMain(main, {
 		showUsage: showUsageWithBreadcrumb,
 		rawArgs
 	});
@@ -478,5 +1057,5 @@ async function run() {
 run().catch((error) => {
 	reportError(error);
 });
-
-//#endregion
+//#endregion
+export { name as A, normalizeFlag as B, ENV_PROFILE as C, consumeLegacyEnvWarnings as D, ENV_URL as E, outputFlags as F, profileFlag as I, DEFAULT_MAX_BYTES as L, connectionFlags as M, listFlags as N, readEnv as O, listFlagsWithDefaultLimit as P, listEnvelopeSchema as R, ENV_DISABLE_KEYRING as S, ENV_SKIP_PREFLIGHT as T, toAliasArray as V, promptSelect as _, reportError as a, warn as b, renderSummary as c, MALFORMED_CELL as d, formatScalar as f, promptPassword as g, promptConfirm as h, mergeCapabilities as i, version as j, setMetabaseAugment as k, writeJson as l, projectForList as m, BASELINE_CAPABILITIES as n, renderItem as o, renderRows as p, checkCapabilities as r, renderList as s, interruptSignal as t, writeText as u, promptText as v, ENV_SKILLS_DIR as w, ENV_API_KEY as x, listTruncationNotice as y, flagConsumesValue as z };