@metabase/cli 0.3.0 → 0.3.1-alpha.versioning.9ac5f50

package/dist/cli.mjs

@@ -1,10 +1,338 @@
 #!/usr/bin/env node
-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 { ZodError, core, z } from "zod";
 import tls from "node:tls";
 import { confirm, isCancel, password, select, text } from "@clack/prompts";
 import Table from "cli-table3";
+//#region ../client/src/json-pointer.ts
+function escapeJsonPointerSegment(key) {
+	if (typeof key === "number") return String(key);
+	return (typeof key === "symbol" ? key.toString() : key).replaceAll("~", "~0").replaceAll("/", "~1");
+}
+//#endregion
+//#region ../client/src/domain/session-properties.ts
+const ServerVersion = z.object({
+	tag: z.string(),
+	date: z.string().optional(),
+	hash: z.string().optional()
+}).loose();
+const TokenFeatures = z.record(z.string(), z.boolean());
+const SessionProperties = z.object({
+	version: ServerVersion,
+	"token-features": TokenFeatures.optional()
+}).loose();
+//#endregion
+//#region ../client/src/version/features.ts
+const FEATURE_RULES = {
+	transforms: { since: 59 },
+	transformJobActivation: { since: 61 },
+	measures: { since: 59 },
+	library: {
+		since: 59,
+		tokenFeature: "library"
+	},
+	remoteSync: {
+		since: 60,
+		tokenFeature: "remote_sync"
+	},
+	contentTranslation: {
+		since: 58,
+		tokenFeature: "content_translation"
+	},
+	transformTargetTableId: { since: 61 },
+	transformTargetTableLinkedOnCreate: {
+		since: 61,
+		until: 61
+	},
+	transformJobRunIdIsNumeric: { since: 64 },
+	libraryChildrenCarryType: { since: 62 },
+	collectionItemsTotalOnEmptyPage: { since: 64 },
+	invalidMbqlIsBadRequest: { since: 59 },
+	boxplotDisplay: { since: 59 },
+	nativeTableTemplateTag: { since: 59 },
+	smartLinkMeasureModel: { since: 60 },
+	dashboardSubscriptionFilters: {
+		since: 58,
+		tokenFeature: "dashboard_subscription_filters"
+	}
+};
+function isFeatureName(name) {
+	return Object.hasOwn(FEATURE_RULES, name);
+}
+const FEATURE_NAMES = Object.keys(FEATURE_RULES).filter(isFeatureName);
+const Features = z.record(z.enum(FEATURE_NAMES), z.boolean());
+function evaluateFeatures(effectiveMajor, tokenFeatures) {
+	const entries = FEATURE_NAMES.map((name) => [name, ruleHolds(FEATURE_RULES[name], effectiveMajor, tokenFeatures)]);
+	return Features.parse(Object.fromEntries(entries));
+}
+function ruleHolds(rule, effectiveMajor, tokenFeatures) {
+	return ruleGap(rule, effectiveMajor, tokenFeatures) === null;
+}
+function ruleGap(rule, effectiveMajor, tokenFeatures) {
+	if (effectiveMajor < rule.since) return { kind: "version" };
+	if (rule.until !== void 0 && effectiveMajor > rule.until) return { kind: "version" };
+	if (rule.tokenFeature === void 0) return null;
+	return tokenFeatures !== null && tokenFeatures[rule.tokenFeature] === true ? null : {
+		kind: "token",
+		tokenFeature: rule.tokenFeature
+	};
+}
+//#endregion
+//#region ../client/src/version/tag.ts
+const ParsedVersion = z.object({
+	tag: z.string(),
+	major: z.number().int().nonnegative(),
+	patch: z.number().int().nonnegative()
+});
+const Edition = z.enum(["oss", "ee"]);
+const TAG = /^v?([01])\.(\d+)\.(\d+)(?:\.\d+)?(?:-([0-9A-Za-z.-]+))?$/;
+const OSS_EDITION_NUMBER = "0";
+const DEV_BUILD_SUFFIX = "SNAPSHOT";
+function tagParts(tag) {
+	const match = TAG.exec(tag);
+	if (match === null) return null;
+	const [, editionNumber, major, patch, prerelease] = match;
+	if (editionNumber === void 0 || major === void 0 || patch === void 0) return null;
+	return {
+		edition: editionNumber === OSS_EDITION_NUMBER ? "oss" : "ee",
+		major: Number(major),
+		patch: Number(patch),
+		prerelease: prerelease ?? null
+	};
+}
+function tryParseTag(tag) {
+	const parts = tagParts(tag);
+	if (parts === null || parts.prerelease === DEV_BUILD_SUFFIX) return null;
+	return {
+		tag,
+		major: parts.major,
+		patch: parts.patch
+	};
+}
+function editionFromTag(tag) {
+	const parts = tagParts(tag);
+	return parts === null ? null : parts.edition;
+}
+//#endregion
+//#region ../client/src/version/profile.ts
+const KNOWN_RANGE = {
+	min: 58,
+	max: 63
+};
+const Skew = z.enum([
+	"supported",
+	"newer-than-known",
+	"unknown"
+]);
+z.object({
+	version: ParsedVersion.nullable(),
+	buildDate: z.string().nullable(),
+	hash: z.string().nullable(),
+	edition: Edition,
+	tokenFeatures: TokenFeatures.nullable(),
+	features: Features,
+	skew: Skew
+});
+function createServerProfile(info) {
+	const placement = place(info.version);
+	return {
+		version: info.version,
+		buildDate: info.date,
+		hash: info.hash,
+		edition: detectEdition(info),
+		tokenFeatures: info.tokenFeatures,
+		features: evaluateFeatures(placement.effectiveMajor, info.tokenFeatures),
+		skew: placement.skew
+	};
+}
+function featureGap(profile, feature) {
+	const placement = place(profile.version);
+	return ruleGap(FEATURE_RULES[feature], placement.effectiveMajor, profile.tokenFeatures);
+}
+function place(version) {
+	if (version === null) return {
+		effectiveMajor: KNOWN_RANGE.max + 1,
+		skew: "unknown"
+	};
+	if (version.major > KNOWN_RANGE.max) return {
+		effectiveMajor: KNOWN_RANGE.max + 1,
+		skew: "newer-than-known"
+	};
+	return {
+		effectiveMajor: version.major,
+		skew: "supported"
+	};
+}
+function detectEdition(info) {
+	if (info.edition !== null) return info.edition;
+	return grantsAnyFeature(info.tokenFeatures) ? "ee" : "oss";
+}
+function grantsAnyFeature(tokenFeatures) {
+	return tokenFeatures !== null && Object.values(tokenFeatures).some((enabled) => enabled);
+}
+//#endregion
+//#region ../client/src/errors.ts
+var MetabaseError = class extends Error {
+	get userMessage() {
+		return this.message;
+	}
+};
+var NetworkError = class extends MetabaseError {
+	category = "network";
+	isRetryable = true;
+	developerDetail;
+	constructor(message, developerDetail) {
+		super(message);
+		this.name = "NetworkError";
+		this.developerDetail = developerDetail;
+	}
+};
+var TimeoutError = class extends MetabaseError {
+	category = "timeout";
+	isRetryable = true;
+	developerDetail;
+	constructor(message, developerDetail) {
+		super(message);
+		this.name = "TimeoutError";
+		this.developerDetail = developerDetail;
+	}
+};
+var ValidationError = class extends MetabaseError {
+	category = "validation";
+	isRetryable = false;
+	developerDetail;
+	constructor(message, developerDetail) {
+		super(message);
+		this.name = "ValidationError";
+		this.developerDetail = developerDetail;
+	}
+	get userMessage() {
+		const issues = this.developerDetail.zodIssues;
+		if (issues.length === 0) return this.message;
+		return `${this.message}\n${formatIssueLines(issues, VALIDATION_ISSUE_FORMAT)}`;
+	}
+};
+const VALIDATION_MAX_ISSUES = 10;
+const RESPONSE_SHAPE_MAX_ISSUES = 5;
+const VALIDATION_ISSUE_FORMAT = {
+	max: VALIDATION_MAX_ISSUES,
+	formatIssue: (issue) => `${formatZodIssuePointer(issue.path)}: ${issue.message}`
+};
+const RESPONSE_SHAPE_ISSUE_FORMAT = {
+	max: RESPONSE_SHAPE_MAX_ISSUES,
+	formatIssue: formatZodIssue
+};
+function formatIssueLines(issues, format) {
+	const head = issues.slice(0, format.max).map(format.formatIssue);
+	const overflow = issues.length - format.max;
+	if (overflow > 0) head.push(`... and ${overflow} more`);
+	return head.map((line) => `  ${line}`).join("\n");
+}
+function formatZodIssuePointer(path) {
+	if (path.length === 0) return "/";
+	return path.map((key) => `/${escapeJsonPointerSegment(key)}`).join("");
+}
+const RESPONSE_SHAPE_LEAD_UNKNOWN_VERSION = "Metabase returned unexpected response shape";
+var ResponseShapeError = class ResponseShapeError extends MetabaseError {
+	category = "response-shape";
+	isRetryable = false;
+	developerDetail;
+	constructor(message, developerDetail) {
+		super(message);
+		this.name = "ResponseShapeError";
+		this.developerDetail = developerDetail;
+	}
+	static fromZodIssues(developerDetail) {
+		return new ResponseShapeError(formatResponseShapeMessage(developerDetail), developerDetail);
+	}
+};
+function formatResponseShapeMessage(detail) {
+	const { zodIssues: issues, serverTag, serverSkew } = detail;
+	const lead = serverTag === null ? RESPONSE_SHAPE_LEAD_UNKNOWN_VERSION : `On Metabase ${describeServer(serverTag, serverSkew)} the response shape was unexpected`;
+	if (issues.length === 0) return lead;
+	return `${lead}:\n${formatIssueLines(issues, RESPONSE_SHAPE_ISSUE_FORMAT)}`;
+}
+function describeServer(tag, skew) {
+	if (skew === "newer-than-known") return `${tag} (newer than this client supports, up to v${KNOWN_RANGE.max})`;
+	return tag;
+}
+var ConfigError = class extends MetabaseError {
+	category = "config";
+	isRetryable = false;
+	developerDetail = null;
+	constructor(message) {
+		super(message);
+		this.name = "ConfigError";
+	}
+};
+var InternalError = class extends MetabaseError {
+	category = "internal";
+	isRetryable = false;
+	developerDetail = null;
+	constructor(message) {
+		super(message);
+		this.name = "InternalError";
+	}
+};
+var AbortError = class extends MetabaseError {
+	category = "abort";
+	isRetryable = false;
+	developerDetail = null;
+	constructor(message = "aborted") {
+		super(message);
+		this.name = "AbortError";
+	}
+};
+var ChainedRequestError = class extends MetabaseError {
+	cause;
+	constructor(message, cause) {
+		super(message);
+		this.name = "ChainedRequestError";
+		this.cause = cause;
+	}
+	get category() {
+		return this.cause.category;
+	}
+	get isRetryable() {
+		return this.cause.isRetryable;
+	}
+	get developerDetail() {
+		return this.cause.developerDetail;
+	}
+};
+var UnknownError = class extends MetabaseError {
+	category = "unknown";
+	isRetryable = false;
+	developerDetail;
+	constructor(input) {
+		super(input.originalMessage);
+		this.name = "UnknownError";
+		this.developerDetail = input;
+	}
+};
+function toMetabaseError(error) {
+	if (error instanceof MetabaseError) return error;
+	if (error instanceof ZodError) return new ConfigError(error.issues.map(formatZodIssue).join("; "));
+	if (error instanceof Error) return new UnknownError({
+		originalMessage: error.message,
+		stack: error.stack ?? null
+	});
+	return new UnknownError({
+		originalMessage: String(error),
+		stack: null
+	});
+}
+function formatZodIssue(issue) {
+	const path = core.toDotPath(issue.path);
+	return path === "" ? issue.message : `${path}: ${issue.message}`;
+}
+function isFileNotFoundError(value) {
+	return value instanceof Error && "code" in value && value.code === "ENOENT";
+}
+function errorMessage(value) {
+	return value instanceof Error ? value.message : String(value);
+}
+//#endregion
 //#region src/runtime/citty.ts
 async function resolveCitty(value) {
 	if (value === void 0) return;
@@ -32,7 +360,16 @@ function flagConsumesValue(token, argsDef) {
 //#region src/output/types.ts
 const DEFAULT_MAX_BYTES = 24576;
 function listEnvelopeSchema(item) {
+	return z.object(listEnvelopeShape(item));
+}
+function listEnvelopeSchemaWithExtras(item, extras) {
 	return z.object({
+		...listEnvelopeShape(item),
+		...extras
+	});
+}
+function listEnvelopeShape(item) {
+	return {
 		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."),
@@ -44,7 +381,7 @@ function listEnvelopeSchema(item) {
 			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
@@ -175,7 +512,7 @@ function trustSystemCa() {
 //#endregion
 //#region package.json
 var name = "@metabase/cli";
-var version = "0.3.0";
+var version = "0.3.1-alpha.versioning.9ac5f50";
 var description = "Metabase CLI";
 //#endregion
 //#region src/runtime/command-augment.ts
@@ -195,35 +532,36 @@ const main = defineCommand({
 		description
 	},
 	subCommands: {
-		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)
+		auth: () => import("./auth-CefYEPP5.mjs").then((mod) => mod.default),
+		db: () => import("./db-C7UTd-6P.mjs").then((mod) => mod.default),
+		table: () => import("./table-D4Alrrwh.mjs").then((mod) => mod.default),
+		field: () => import("./field-CzHBOPER.mjs").then((mod) => mod.default),
+		upload: () => import("./upload-DzGTlldn.mjs").then((mod) => mod.default),
+		"content-translation": () => import("./content-translation-D7POzJJ6.mjs").then((mod) => mod.default),
+		card: () => import("./card-BRarvKYX.mjs").then((mod) => mod.default),
+		dashboard: () => import("./dashboard-BudI952R.mjs").then((mod) => mod.default),
+		subscription: () => import("./subscription-CdFn2hre.mjs").then((mod) => mod.default),
+		alert: () => import("./alert-D1u2MVZj.mjs").then((mod) => mod.default),
+		collection: () => import("./collection-CKeO8X7U.mjs").then((mod) => mod.default),
+		library: () => import("./library-uzyHWBap.mjs").then((mod) => mod.default),
+		document: () => import("./document-BoILnE_1.mjs").then((mod) => mod.default),
+		transform: () => import("./transform-BcV_XlSX.mjs").then((mod) => mod.default),
+		"transform-job": () => import("./transform-job-CjtwBGoM.mjs").then((mod) => mod.default),
+		"transform-tag": () => import("./transform-tag-DJ3_bksm.mjs").then((mod) => mod.default),
+		setting: () => import("./setting-B1KBQN3M.mjs").then((mod) => mod.default),
+		search: () => import("./search-J4RwCof-.mjs").then((mod) => mod.default),
+		"git-sync": () => import("./git-sync-CdN0Maun.mjs").then((mod) => mod.default),
+		setup: () => import("./setup-CVaNVwOd.mjs").then((mod) => mod.default),
+		snippet: () => import("./snippet-CG75L2DS.mjs").then((mod) => mod.default),
+		segment: () => import("./segment-XXTjU0eG.mjs").then((mod) => mod.default),
+		measure: () => import("./measure-CdA8Nl3Z.mjs").then((mod) => mod.default),
+		timeline: () => import("./timeline-DmM0BuX8.mjs").then((mod) => mod.default),
+		"timeline-event": () => import("./timeline-event-DWIh3Tdt.mjs").then((mod) => mod.default),
+		eid: () => import("./eid-D-BbtWjt.mjs").then((mod) => mod.default),
+		query: () => import("./query-BKSM-pbi.mjs").then((mod) => mod.default),
+		uuid: () => import("./uuid-oVdJ62eA.mjs").then((mod) => mod.default),
+		upgrade: () => import("./upgrade-CD1xtsIv.mjs").then((mod) => mod.default),
+		skills: () => import("./skills-BWrAlj9l.mjs").then((mod) => mod.default)
 	}
 });
 setMetabaseAugment(main, {
@@ -238,6 +576,7 @@ setMetabaseAugment(main, {
 	}],
 	inputSchema: null,
 	outputSchema: null,
+	requires: null,
 	capabilities: null
 });
 //#endregion
@@ -379,6 +718,11 @@ function jsonByteLength(value) {
 	return Buffer.byteLength(JSON.stringify(value), "utf8");
 }
 //#endregion
+//#region ../client/src/predicates.ts
+function isPlainObject(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//#endregion
 //#region src/output/projection.ts
 function projectForList(item, view, opts) {
 	const full = opts.format === "text" && opts.fields === void 0 ? false : opts.full;
@@ -512,8 +856,11 @@ function renderSummary(item, view, summaryText, opts) {
 	process.stdout.write(body);
 }
 function renderList(envelope, view, opts) {
+	renderListWithExtras(envelope, {}, view, opts);
+}
+function renderListWithExtras(envelope, extras, view, opts) {
 	if (opts.format === "json") {
-		renderJsonEnvelope(envelope, view, opts);
+		renderJsonEnvelope(envelope, extras, view, opts);
 		return;
 	}
 	if (envelope.data.length === 0) {
@@ -546,8 +893,11 @@ function projectedEnvelope(envelope, view, opts) {
 		data: envelope.data.map((item) => projectForList(item, view, opts))
 	};
 }
-function renderJsonEnvelope(envelope, view, opts) {
-	const capped = capListEnvelope(projectedEnvelope(envelope, view, opts), opts.maxBytes);
+function renderJsonEnvelope(envelope, extras, view, opts) {
+	const capped = capListEnvelope({
+		...projectedEnvelope(envelope, view, opts),
+		...extras
+	}, opts.maxBytes);
 	const ordered = {
 		returned: capped.returned,
 		offset: capped.offset,
@@ -556,6 +906,7 @@ function renderJsonEnvelope(envelope, view, opts) {
 		has_more: capped.has_more,
 		next_offset: capped.next_offset,
 		truncated: capped.truncated,
+		...extras,
 		data: capped.data
 	};
 	process.stdout.write(serializeJson(ordered, stdoutPretty()) + "\n");
@@ -653,35 +1004,169 @@ function writeJsonError(handled, exitCode, verbose) {
 	process.stderr.write(serializeJson(envelope, stderrPretty()) + "\n");
 }
 //#endregion
-//#region ../client/src/version/capabilities.ts
-const Capabilities = z.object({
+//#region ../client/src/version/capability-summary.ts
+const CapabilitySummary = 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 summarizeCapabilities(features) {
+	const rules = features.map((feature) => FEATURE_RULES[feature]);
+	const minVersion = Math.max(KNOWN_RANGE.min, ...rules.map((rule) => rule.since));
+	const tokenFeatures = [...new Set(rules.flatMap((rule) => rule.tokenFeature === void 0 ? [] : [rule.tokenFeature]))];
+	if (tokenFeatures.length > 1) throw new Error(`a capability summary names one premium feature, got ${tokenFeatures.length}: ${tokenFeatures.join(", ")}`);
+	const [tokenFeature] = tokenFeatures;
+	return tokenFeature === void 0 ? { minVersion } : {
+		minVersion,
+		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 ../client/src/version/requirements.ts
+const METHOD_REQUIREMENTS = {
+	"card.list": [],
+	"card.get": [],
+	"card.create": [],
+	"card.update": [],
+	"card.archive": [],
+	"card.query": [],
+	"card.exportQuery": [],
+	"collection.list": [],
+	"collection.listWithLibrary": [],
+	"collection.get": [],
+	"collection.create": [],
+	"collection.update": [],
+	"collection.archive": [],
+	"collection.itemPages": [],
+	"collection.tree": [],
+	"contentTranslation.download": ["contentTranslation"],
+	"contentTranslation.upload": ["contentTranslation"],
+	"dashboard.list": [],
+	"dashboard.get": [],
+	"dashboard.create": [],
+	"dashboard.update": [],
+	"dashboard.archive": [],
+	"dashboard.updateDashcard": [],
+	"dashboard.checkCardReferences": [],
+	"dashboard.parameterValues": [],
+	"dashboard.searchParameterValues": [],
+	"database.list": [],
+	"database.get": [],
+	"database.schemas": [],
+	"database.schemaTables": [],
+	"database.syncSchema": [],
+	"database.rescanValues": [],
+	"dataset.query": [],
+	"document.list": [],
+	"document.get": [],
+	"document.create": [],
+	"document.update": [],
+	"document.archive": [],
+	"eidTranslation.translate": [],
+	"field.get": [],
+	"field.update": [],
+	"field.summary": [],
+	"field.values": [],
+	"gitSync.currentTask": ["remoteSync"],
+	"gitSync.cancelTask": ["remoteSync"],
+	"gitSync.isDirty": ["remoteSync"],
+	"gitSync.dirty": ["remoteSync"],
+	"gitSync.hasRemoteChanges": ["remoteSync"],
+	"gitSync.import": ["remoteSync"],
+	"gitSync.export": ["remoteSync"],
+	"gitSync.stash": ["remoteSync"],
+	"gitSync.branches": ["remoteSync"],
+	"gitSync.createBranch": ["remoteSync"],
+	"gitSync.setCollectionSynced": ["remoteSync"],
+	"gitSync.syncedCollections": ["remoteSync"],
+	"gitSync.remoteUrl": [],
+	"gitSync.branch": [],
+	"gitSync.waitForTask": ["remoteSync"],
+	"library.get": ["library"],
+	"library.create": ["library"],
+	"library.ensureDataCollectionId": ["library"],
+	"library.publishTables": ["library"],
+	"library.unpublishTables": ["library"],
+	"measure.list": ["measures"],
+	"measure.get": ["measures"],
+	"measure.create": ["measures"],
+	"measure.update": ["measures"],
+	"measure.archive": ["measures"],
+	"notification.list": [],
+	"notification.get": [],
+	"notification.create": [],
+	"notification.update": [],
+	"notification.archive": [],
+	"notification.send": [],
+	"pulse.list": [],
+	"pulse.get": [],
+	"pulse.create": [],
+	"pulse.update": [],
+	"pulse.archive": [],
+	"search.query": [],
+	"segment.list": [],
+	"segment.get": [],
+	"segment.create": [],
+	"segment.update": [],
+	"segment.archive": [],
+	"setting.list": [],
+	"setting.get": [],
+	"setting.set": [],
+	"setup.create": [],
+	"snippet.list": [],
+	"snippet.get": [],
+	"snippet.create": [],
+	"snippet.update": [],
+	"snippet.archive": [],
+	"table.list": [],
+	"table.get": [],
+	"table.update": [],
+	"table.queryMetadata": [],
+	"table.appendCsv": [],
+	"table.replaceCsv": [],
+	"timeline.list": [],
+	"timeline.get": [],
+	"timeline.events": [],
+	"timeline.create": [],
+	"timeline.update": [],
+	"timeline.archive": [],
+	"timeline.delete": [],
+	"timelineEvent.get": [],
+	"timelineEvent.create": [],
+	"timelineEvent.update": [],
+	"timelineEvent.archive": [],
+	"timelineEvent.delete": [],
+	"transform.list": ["transforms"],
+	"transform.get": ["transforms"],
+	"transform.create": ["transforms"],
+	"transform.update": ["transforms"],
+	"transform.delete": ["transforms"],
+	"transform.deleteTable": ["transforms"],
+	"transform.dependencies": ["transforms"],
+	"transform.cancel": ["transforms"],
+	"transform.getRun": ["transforms"],
+	"transform.runPages": ["transforms"],
+	"transform.run": ["transforms"],
+	"transformJob.list": ["transforms"],
+	"transformJob.get": ["transforms"],
+	"transformJob.create": ["transforms"],
+	"transformJob.update": ["transforms"],
+	"transformJob.delete": ["transforms"],
+	"transformJob.run": ["transforms"],
+	"transformJob.transforms": ["transforms"],
+	"transformJob.setActive": ["transformJobActivation", "transforms"],
+	"transformTag.list": ["transforms"],
+	"transformTag.create": ["transforms"],
+	"transformTag.update": ["transforms"],
+	"transformTag.delete": ["transforms"],
+	"upload.createFromCsv": [],
+	"user.current": []
+};
+function isMethodKey(key) {
+	return Object.hasOwn(METHOD_REQUIREMENTS, key);
+}
+const METHOD_KEYS = Object.keys(METHOD_REQUIREMENTS).filter(isMethodKey);
+function methodRequirements(key) {
+	return METHOD_REQUIREMENTS[key];
 }
 //#endregion
 //#region src/runtime/command-help.ts
@@ -707,6 +1192,10 @@ const CommandHelpSkill = z.object({
 	skill: z.string(),
 	purpose: z.string()
 });
+const CommandHelpRequires = z.object({
+	methods: z.array(z.enum(METHOD_KEYS)),
+	features: z.array(z.enum(FEATURE_NAMES))
+});
 z.object({
 	command: z.string(),
 	description: z.string().nullable(),
@@ -716,7 +1205,8 @@ z.object({
 	args: z.array(CommandHelpArg),
 	inputSchema: z.unknown().nullable(),
 	outputSchema: z.unknown().nullable(),
-	capabilities: Capabilities.nullable()
+	requires: CommandHelpRequires.nullable(),
+	capabilities: CapabilitySummary.nullable()
 });
 const CommandIndexEntry = z.object({
 	command: z.string(),
@@ -733,6 +1223,7 @@ const EMPTY_AUGMENT = {
 	skills: [],
 	inputSchema: null,
 	outputSchema: null,
+	requires: null,
 	capabilities: null
 };
 async function buildHelpEntry(cmd, path) {
@@ -747,6 +1238,7 @@ async function buildHelpEntry(cmd, path) {
 		args: convertArgs(args),
 		inputSchema: augment.inputSchema ? z.toJSONSchema(augment.inputSchema) : null,
 		outputSchema: augment.outputSchema ? z.toJSONSchema(augment.outputSchema) : null,
+		requires: augment.requires,
 		capabilities: augment.capabilities
 	};
 	if (augment.details !== null) entry.details = augment.details;
@@ -1058,4 +1550,4 @@ run().catch((error) => {
 	reportError(error);
 });
 //#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 };
+export { ValidationError as $, setMetabaseAugment as A, listEnvelopeSchemaWithExtras as B, ENV_DISABLE_KEYRING as C, ENV_URL as D, ENV_SKIP_PREFLIGHT as E, listFlagsWithDefaultLimit as F, ChainedRequestError as G, normalizeFlag as H, outputFlags as I, MetabaseError as J, ConfigError as K, profileFlag as L, version as M, connectionFlags as N, consumeLegacyEnvWarnings as O, listFlags as P, UnknownError as Q, DEFAULT_MAX_BYTES as R, ENV_API_KEY as S, ENV_SKILLS_DIR as T, toAliasArray as U, flagConsumesValue as V, AbortError as W, ResponseShapeError as X, NetworkError as Y, TimeoutError as Z, promptPassword as _, renderItem as a, featureGap as at, listTruncationNotice as b, renderSummary as c, editionFromTag as ct, MALFORMED_CELL as d, FEATURE_RULES as dt, errorMessage as et, formatScalar as f, Features as ft, promptConfirm as g, escapeJsonPointerSegment as gt, isPlainObject as h, TokenFeatures as ht, reportError as i, createServerProfile as it, name as j, readEnv as k, writeJson as l, tryParseTag as lt, projectForList as m, SessionProperties as mt, methodRequirements as n, KNOWN_RANGE as nt, renderList as o, Edition as ot, renderRows as p, isFeatureName as pt, InternalError as q, summarizeCapabilities as r, Skew as rt, renderListWithExtras as s, ParsedVersion as st, interruptSignal as t, isFileNotFoundError as tt, writeText as u, FEATURE_NAMES as ut, promptSelect as v, ENV_PROFILE as w, warn as x, promptText as y, listEnvelopeSchema as z };