@metabase/cli 0.3.1-alpha.transform-tests.3fbcf8b → 0.3.1-alpha.transform-tests.d9ed765

package/dist/cli.mjs

@@ -1,10 +1,183 @@
 #!/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/version/known-range.ts
+const KNOWN_RANGE = {
+	min: 58,
+	max: 64
+};
+//#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 +205,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 +226,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 +357,7 @@ function trustSystemCa() {
 //#endregion
 //#region package.json
 var name = "@metabase/cli";
-var version = "0.3.1-alpha.transform-tests.3fbcf8b";
+var version = "0.3.1-alpha.transform-tests.d9ed765";
 var description = "Metabase CLI";
 //#endregion
 //#region src/runtime/command-augment.ts
@@ -195,37 +377,37 @@ const main = defineCommand({
 		description
 	},
 	subCommands: {
-		auth: () => import("./auth-kyPQfiND.mjs").then((mod) => mod.default),
-		db: () => import("./db-2hSYsqHk.mjs").then((mod) => mod.default),
-		table: () => import("./table-CDeO1WbH.mjs").then((mod) => mod.default),
-		field: () => import("./field-DikmNcAt.mjs").then((mod) => mod.default),
-		upload: () => import("./upload-JN6EK96c.mjs").then((mod) => mod.default),
-		"content-translation": () => import("./content-translation-CxTabpLF.mjs").then((mod) => mod.default),
-		card: () => import("./card-p2r_szeS.mjs").then((mod) => mod.default),
-		dashboard: () => import("./dashboard-ReNaou5J.mjs").then((mod) => mod.default),
-		subscription: () => import("./subscription-B1uuKxM7.mjs").then((mod) => mod.default),
-		alert: () => import("./alert-Klz8Bhst.mjs").then((mod) => mod.default),
-		collection: () => import("./collection-CAM47Der.mjs").then((mod) => mod.default),
-		library: () => import("./library-DpOtb0E0.mjs").then((mod) => mod.default),
-		document: () => import("./document-DGbDloCb.mjs").then((mod) => mod.default),
-		transform: () => import("./transform-CWIqW64R.mjs").then((mod) => mod.default),
-		"transform-job": () => import("./transform-job-DpF2MARE.mjs").then((mod) => mod.default),
-		"transform-tag": () => import("./transform-tag-Bpj8l5Ci.mjs").then((mod) => mod.default),
-		"transform-test": () => import("./transform-test-BhkpwFqD.mjs").then((mod) => mod.default),
-		setting: () => import("./setting-dkfKvCxc.mjs").then((mod) => mod.default),
-		search: () => import("./search-BKVV6YtB.mjs").then((mod) => mod.default),
-		"git-sync": () => import("./git-sync-IW4T2sKq.mjs").then((mod) => mod.default),
-		setup: () => import("./setup-TOwWatgm.mjs").then((mod) => mod.default),
-		snippet: () => import("./snippet-DMdFqvNq.mjs").then((mod) => mod.default),
-		segment: () => import("./segment-CDoZHSYX.mjs").then((mod) => mod.default),
-		measure: () => import("./measure-IPlonpqU.mjs").then((mod) => mod.default),
-		timeline: () => import("./timeline-MQFX3Fla.mjs").then((mod) => mod.default),
-		"timeline-event": () => import("./timeline-event-oGmne082.mjs").then((mod) => mod.default),
-		eid: () => import("./eid-BvY-YGpN.mjs").then((mod) => mod.default),
-		query: () => import("./query-CEdmSEq8.mjs").then((mod) => mod.default),
-		uuid: () => import("./uuid-BLBLkWAF.mjs").then((mod) => mod.default),
-		upgrade: () => import("./upgrade-DkQ1wk4z.mjs").then((mod) => mod.default),
-		skills: () => import("./skills-BcOjZldN.mjs").then((mod) => mod.default)
+		auth: () => import("./auth-DuGPC1Q0.mjs").then((mod) => mod.default),
+		db: () => import("./db-ntq1NYVT.mjs").then((mod) => mod.default),
+		table: () => import("./table-DW1dG3Rl.mjs").then((mod) => mod.default),
+		field: () => import("./field-CeP-41qf.mjs").then((mod) => mod.default),
+		upload: () => import("./upload-BsPrAjN-.mjs").then((mod) => mod.default),
+		"content-translation": () => import("./content-translation-BNYQ8fJ3.mjs").then((mod) => mod.default),
+		card: () => import("./card-DqPrL79i.mjs").then((mod) => mod.default),
+		dashboard: () => import("./dashboard-D8Yjjwfr.mjs").then((mod) => mod.default),
+		subscription: () => import("./subscription-B5Iax7Ci.mjs").then((mod) => mod.default),
+		alert: () => import("./alert-2MDhiuxT.mjs").then((mod) => mod.default),
+		collection: () => import("./collection-BsXk1V41.mjs").then((mod) => mod.default),
+		library: () => import("./library-CpDosMc5.mjs").then((mod) => mod.default),
+		document: () => import("./document-BiS-U56S.mjs").then((mod) => mod.default),
+		transform: () => import("./transform-D08iA4H_.mjs").then((mod) => mod.default),
+		"transform-job": () => import("./transform-job-Me5CeV2z.mjs").then((mod) => mod.default),
+		"transform-tag": () => import("./transform-tag-CbgjSy76.mjs").then((mod) => mod.default),
+		"transform-test": () => import("./transform-test-CwonhnyQ.mjs").then((mod) => mod.default),
+		setting: () => import("./setting-BNEblMco.mjs").then((mod) => mod.default),
+		search: () => import("./search-D6qBaNsw.mjs").then((mod) => mod.default),
+		"git-sync": () => import("./git-sync-jvNlPu2I.mjs").then((mod) => mod.default),
+		setup: () => import("./setup-DFnxwJGX.mjs").then((mod) => mod.default),
+		snippet: () => import("./snippet-vMnFtNwi.mjs").then((mod) => mod.default),
+		segment: () => import("./segment-BFJd2-ck.mjs").then((mod) => mod.default),
+		measure: () => import("./measure-DYmGuTVW.mjs").then((mod) => mod.default),
+		timeline: () => import("./timeline-C0rqHF4p.mjs").then((mod) => mod.default),
+		"timeline-event": () => import("./timeline-event-D1MUnexK.mjs").then((mod) => mod.default),
+		eid: () => import("./eid-Bn3Impnq.mjs").then((mod) => mod.default),
+		query: () => import("./query-B8MCziCM.mjs").then((mod) => mod.default),
+		uuid: () => import("./uuid-DYYGRv9y.mjs").then((mod) => mod.default),
+		upgrade: () => import("./upgrade-DgmbeOoJ.mjs").then((mod) => mod.default),
+		skills: () => import("./skills-CGYk6b2r.mjs").then((mod) => mod.default)
 	}
 });
 setMetabaseAugment(main, {
@@ -240,9 +422,22 @@ setMetabaseAugment(main, {
 	}],
 	inputSchema: null,
 	outputSchema: null,
-	capabilities: null
+	requires: null
 });
 //#endregion
+//#region src/core/profile-refreshed-error.ts
+var ProfileRefreshedError = class extends MetabaseError {
+	category;
+	isRetryable = false;
+	developerDetail;
+	constructor(cause, note) {
+		super(`${cause.userMessage}\n${note}`);
+		this.name = "ProfileRefreshedError";
+		this.category = cause.category;
+		this.developerDetail = cause.developerDetail;
+	}
+};
+//#endregion
 //#region src/core/env.ts
 const LEGACY_PREFIX = "METABASE_";
 const ENV_URL = "MB_URL";
@@ -381,6 +576,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;
@@ -514,8 +714,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) {
@@ -548,8 +751,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,
@@ -558,6 +764,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");
@@ -627,6 +834,7 @@ function isRouteMissing(handled) {
 	return "kind" in handled && handled.kind === ROUTE_MISSING_KIND;
 }
 function remediesFor(handled) {
+	if (handled instanceof ProfileRefreshedError) return [];
 	if (isVersionTooOld(handled.developerDetail)) return [DOWNGRADE_REMEDY];
 	if (isRouteMissing(handled)) return [ROUTE_MISSING_REMEDY];
 	return [];
@@ -655,35 +863,320 @@ function writeJsonError(handled, exitCode, verbose) {
 	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 }
+//#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"
+	},
+	remoteSyncExportPreflight: {
+		since: 63,
+		tokenFeature: "remote_sync"
+	},
+	contentTranslation: {
+		since: 58,
+		tokenFeature: "content_translation"
+	},
+	contentVerification: {
+		since: 58,
+		tokenFeature: "content_verification"
+	},
+	transformTargetTableId: { since: 61 },
+	transformTargetTableLinkedOnCreate: {
+		since: 61,
+		until: 61
+	},
+	transformJobRunIdIsNumeric: { since: 64 },
+	transformCheckpointReset: { since: 60 },
+	fieldDataSensitivity: { since: 64 },
+	transformDagRuns: { since: 64 },
+	unifiedTransformRuns: { since: 64 },
+	transformTests: {
+		since: 65,
+		tokenFeature: "transforms-testing"
+	},
+	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"
+	},
+	dependencyGraph: {
+		since: 58,
+		tokenFeature: "dependencies"
+	},
+	dependencyItemListings: {
+		since: 59,
+		tokenFeature: "dependencies"
+	},
+	dependencyKebabCaseFilters: { since: 60 },
+	tableListAccessFilters: { since: 59 },
+	tableListTransformTargets: { since: 60 },
+	tableUnusedFilter: {
+		since: 58,
+		tokenFeature: "dependencies"
+	},
+	tableDataLayerTiers: { since: 59 },
+	bulkTableEdit: { since: 59 },
+	erd: {
+		since: 62,
+		tokenFeature: "schema-viewer"
+	},
+	documentCopy: { since: 59 },
+	transformInspector: {
+		since: 60,
+		tokenFeature: "transforms-python"
+	},
+	pythonLibrary: {
+		since: 58,
+		tokenFeature: "transforms-python"
+	},
+	pythonTestRun: {
+		since: 60,
+		tokenFeature: "transforms-python"
+	},
+	sourceReplacement: {
+		since: 60,
+		tokenFeature: "dependencies"
+	},
+	metricDefinitionQuery: { since: 60 },
+	metricDimensionListing: { since: 64 }
+};
+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
 	};
 }
-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": [],
+	"card.queryMetadata": [],
+	"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.copy": [],
+	"dashboard.updateDashcard": [],
+	"dashboard.checkCardReferences": [],
+	"dashboard.parameterValues": [],
+	"dashboard.searchParameterValues": [],
+	"database.list": [],
+	"database.get": [],
+	"database.schemas": [],
+	"database.schemaTables": [],
+	"database.syncSchema": [],
+	"database.rescanValues": [],
+	"dataset.query": [],
+	"dataset.native": [],
+	"dataset.queryMetadata": [],
+	"dataset.exportQuery": [],
+	"dependency.breakingPages": ["dependencyItemListings"],
+	"dependency.broken": ["dependencyItemListings"],
+	"dependency.dependents": ["dependencyItemListings"],
+	"dependency.graph": ["dependencyGraph"],
+	"dependency.unreferencedPages": ["dependencyItemListings"],
+	"document.list": [],
+	"document.get": [],
+	"document.create": [],
+	"document.update": [],
+	"document.archive": [],
+	"document.copy": ["documentCopy"],
+	"eidTranslation.translate": [],
+	"erd.get": ["erd"],
+	"field.get": [],
+	"field.update": [],
+	"field.search": [],
+	"field.remapping": [],
+	"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.exportPreflight": ["remoteSyncExportPreflight"],
+	"gitSync.stash": ["remoteSync"],
+	"gitSync.branches": ["remoteSync"],
+	"gitSync.createBranch": ["remoteSync"],
+	"gitSync.setCollectionSynced": ["remoteSync"],
+	"gitSync.syncedCollections": ["remoteSync"],
+	"gitSync.remoteUrl": [],
+	"gitSync.branch": [],
+	"gitSync.waitForTask": ["remoteSync"],
+	"glossary.list": [],
+	"glossary.create": [],
+	"glossary.update": [],
+	"glossary.delete": [],
+	"library.get": ["library"],
+	"library.create": ["library"],
+	"library.ensureDataCollectionId": ["library"],
+	"library.publishTables": ["library"],
+	"library.unpublishTables": ["library"],
+	"metric.query": ["metricDefinitionQuery"],
+	"metric.breakoutValues": ["metricDefinitionQuery"],
+	"metric.dimensions": ["metricDimensionListing"],
+	"measure.list": ["measures"],
+	"measure.get": ["measures"],
+	"measure.create": ["measures"],
+	"measure.update": ["measures"],
+	"measure.archive": ["measures"],
+	"moderationReview.create": ["contentVerification"],
+	"notification.list": [],
+	"notification.get": [],
+	"notification.create": [],
+	"notification.update": [],
+	"notification.archive": [],
+	"notification.send": [],
+	"permission.graph": [],
+	"permission.databaseGraph": [],
+	"permission.groupGraph": [],
+	"pulse.list": [],
+	"pulse.get": [],
+	"pulse.create": [],
+	"pulse.update": [],
+	"pulse.archive": [],
+	"replacement.checkReplaceSource": ["sourceReplacement"],
+	"replacement.replaceSource": ["sourceReplacement"],
+	"replacement.replaceModelWithTransform": ["sourceReplacement"],
+	"replacement.listRuns": ["sourceReplacement"],
+	"replacement.getRun": ["sourceReplacement"],
+	"replacement.cancelRun": ["sourceReplacement"],
+	"revision.list": [],
+	"revision.revert": [],
+	"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.fks": [],
+	"table.syncSchema": [],
+	"table.rescanValues": [],
+	"table.bulkEdit": ["bulkTableEdit"],
+	"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.runSummaryPages": ["unifiedTransformRuns", "transforms"],
+	"transform.resetCheckpoint": ["transformCheckpointReset", "transforms"],
+	"transform.runDag": ["transformDagRuns", "transforms"],
+	"transform.dagTransforms": ["transformDagRuns", "transforms"],
+	"transform.run": ["transforms"],
+	"transformDagRun.transformRuns": ["transformDagRuns", "transforms"],
+	"transformDagRun.cancel": ["transformDagRuns", "transforms"],
+	"transformInspector.discover": ["transformInspector"],
+	"transformInspector.lens": ["transformInspector"],
+	"transformInspector.query": ["transformInspector"],
+	"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"],
+	"transformPython.getLibrary": ["pythonLibrary"],
+	"transformPython.updateLibrary": ["pythonLibrary"],
+	"transformPython.testRun": ["pythonTestRun"],
+	"transformTag.list": ["transforms"],
+	"transformTag.create": ["transforms"],
+	"transformTag.update": ["transforms"],
+	"transformTag.delete": ["transforms"],
+	"transformTest.list": ["transformTests"],
+	"transformTest.get": ["transformTests"],
+	"transformTest.create": ["transformTests"],
+	"transformTest.update": ["transformTests"],
+	"transformTest.delete": ["transformTests"],
+	"transformTest.run": ["transformTests"],
+	"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
@@ -709,6 +1202,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(),
@@ -718,7 +1215,7 @@ z.object({
 	args: z.array(CommandHelpArg),
 	inputSchema: z.unknown().nullable(),
 	outputSchema: z.unknown().nullable(),
-	capabilities: Capabilities.nullable()
+	requires: CommandHelpRequires.nullable()
 });
 const CommandIndexEntry = z.object({
 	command: z.string(),
@@ -735,7 +1232,7 @@ const EMPTY_AUGMENT = {
 	skills: [],
 	inputSchema: null,
 	outputSchema: null,
-	capabilities: null
+	requires: null
 };
 async function buildHelpEntry(cmd, path) {
 	const meta = await resolveCitty(cmd.meta);
@@ -749,7 +1246,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,
-		capabilities: augment.capabilities
+		requires: augment.requires
 	};
 	if (augment.details !== null) entry.details = augment.details;
 	return entry;
@@ -1060,4 +1557,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 { InternalError as $, ENV_SKILLS_DIR as A, listFlags as B, promptSelect as C, ENV_API_KEY as D, warn as E, ProfileRefreshedError as F, listEnvelopeSchema as G, outputFlags as H, setMetabaseAugment as I, normalizeFlag as J, listEnvelopeSchemaWithExtras as K, name as L, ENV_URL as M, consumeLegacyEnvWarnings as N, ENV_DISABLE_KEYRING as O, readEnv as P, ConfigError as Q, version as R, promptPassword as S, listTruncationNotice as T, profileFlag as U, listFlagsWithDefaultLimit as V, DEFAULT_MAX_BYTES as W, AbortError as X, toAliasArray as Y, ChainedRequestError as Z, formatScalar as _, Features as a, ValidationError as at, isPlainObject as b, ruleGap as c, KNOWN_RANGE as ct, renderList as d, MetabaseError as et, renderListWithExtras as f, MALFORMED_CELL as g, writeText as h, FEATURE_RULES as i, UnknownError as it, ENV_SKIP_PREFLIGHT as j, ENV_PROFILE as k, reportError as l, escapeJsonPointerSegment as lt, writeJson as m, methodRequirements as n, ResponseShapeError as nt, evaluateFeatures as o, errorMessage as ot, renderSummary as p, flagConsumesValue as q, FEATURE_NAMES as r, TimeoutError as rt, isFeatureName as s, isFileNotFoundError as st, interruptSignal as t, NetworkError as tt, renderItem as u, renderRows as v, promptText as w, promptConfirm as x, projectForList as y, connectionFlags as z };