@metabase/cli 0.3.1-alpha.support-worktrees.b634907 → 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
@@ -99,10 +436,6 @@ const profileFlag = { profile: {
 	description: "Named profile (default: 'default')",
 	alias: "p"
 } };
-const worktreeFlag = { worktree: {
-	type: "string",
-	description: "Scope to a git-sync worktree (id or branch); defaults to MB_WORKTREE or the profile's pinned worktree"
-} };
 const connectionFlags = {
 	url: {
 		type: "string",
@@ -127,8 +460,7 @@ const GLOBAL_FLAG_ARGS = {
 	...outputFlags,
 	...listFlags,
 	...profileFlag,
-	...connectionFlags,
-	...worktreeFlag
+	...connectionFlags
 };
 const GLOBAL_FLAG_NAMES = buildGlobalFlagNames();
 function buildGlobalFlagNames() {
@@ -180,7 +512,7 @@ function trustSystemCa() {
 //#endregion
 //#region package.json
 var name = "@metabase/cli";
-var version = "0.3.1-alpha.support-worktrees.b634907";
+var version = "0.3.1-alpha.versioning.9ac5f50";
 var description = "Metabase CLI";
 //#endregion
 //#region src/runtime/command-augment.ts
@@ -200,37 +532,36 @@ const main = defineCommand({
 		description
 	},
 	subCommands: {
-		auth: () => import("./auth-BEEkuu4J.mjs").then((mod) => mod.default),
-		db: () => import("./db-1tLH3nYI.mjs").then((mod) => mod.default),
-		table: () => import("./table-BQaiCSNS.mjs").then((mod) => mod.default),
-		field: () => import("./field-BKn9bt7I.mjs").then((mod) => mod.default),
-		upload: () => import("./upload-Dc3QLhZw.mjs").then((mod) => mod.default),
-		"content-translation": () => import("./content-translation-C8MlXPOF.mjs").then((mod) => mod.default),
-		card: () => import("./card-RlzLDB2z.mjs").then((mod) => mod.default),
-		dashboard: () => import("./dashboard-B1mpfCq_.mjs").then((mod) => mod.default),
-		subscription: () => import("./subscription-BnGDp1oy.mjs").then((mod) => mod.default),
-		alert: () => import("./alert-CQ7Az16h.mjs").then((mod) => mod.default),
-		collection: () => import("./collection-Bhe20ckt.mjs").then((mod) => mod.default),
-		library: () => import("./library-CRaOhJnj.mjs").then((mod) => mod.default),
-		document: () => import("./document-DOJbBWLF.mjs").then((mod) => mod.default),
-		transform: () => import("./transform-DAf0Y02t.mjs").then((mod) => mod.default),
-		"transform-job": () => import("./transform-job-ntiT5Rrh.mjs").then((mod) => mod.default),
-		"transform-tag": () => import("./transform-tag-Dip51YBa.mjs").then((mod) => mod.default),
-		setting: () => import("./setting-CN4l8N-b.mjs").then((mod) => mod.default),
-		search: () => import("./search-CljYyf2F.mjs").then((mod) => mod.default),
-		"git-sync": () => import("./git-sync-DjoaNmRM.mjs").then((mod) => mod.default),
-		worktree: () => import("./worktree-DC0kTxxQ.mjs").then((mod) => mod.default),
-		setup: () => import("./setup-BpTptmdO.mjs").then((mod) => mod.default),
-		snippet: () => import("./snippet-LlHz3FdJ.mjs").then((mod) => mod.default),
-		segment: () => import("./segment-IRzlQggt.mjs").then((mod) => mod.default),
-		measure: () => import("./measure-C5dIdFj1.mjs").then((mod) => mod.default),
-		timeline: () => import("./timeline-C2VW0Ph6.mjs").then((mod) => mod.default),
-		"timeline-event": () => import("./timeline-event-B7H1y8s8.mjs").then((mod) => mod.default),
-		eid: () => import("./eid-CP35PdEF.mjs").then((mod) => mod.default),
-		query: () => import("./query-tWQAV9pb.mjs").then((mod) => mod.default),
-		uuid: () => import("./uuid-CFN8LIkP.mjs").then((mod) => mod.default),
-		upgrade: () => import("./upgrade-CUoRHfVg.mjs").then((mod) => mod.default),
-		skills: () => import("./skills-BSAiLI3Z.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, {
@@ -245,8 +576,8 @@ setMetabaseAugment(main, {
 	}],
 	inputSchema: null,
 	outputSchema: null,
-	capabilities: null,
-	worktree: "any"
+	requires: null,
+	capabilities: null
 });
 //#endregion
 //#region src/core/env.ts
@@ -258,7 +589,6 @@ 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";
-const ENV_WORKTREE = "MB_WORKTREE";
 function legacyNameFor(canonical) {
 	return LEGACY_PREFIX + canonical.slice(3);
 }
@@ -388,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;
@@ -521,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) {
@@ -555,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,
@@ -565,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");
@@ -662,107 +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 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."
+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
 	};
-	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/core/worktree-scope.ts
-const WorktreePolicy = z.enum([
-	"scoped",
-	"any",
-	"main-only"
-]);
-const WORKTREE_FLAG = "--worktree";
-const ORIGIN_LABEL = Object.freeze({
-	flag: WORKTREE_FLAG,
-	env: ENV_WORKTREE,
-	pin: "the profile pin"
-});
-const DIGITS = /^\d+$/;
-function parseWorktreeRef(raw, label) {
-	const value = raw.trim();
-	if (value === "") throw new ConfigError(`invalid ${label}: value must not be blank`);
-	if (!DIGITS.test(value)) return {
-		kind: "branch",
-		branch: value
-	};
-	const id = Number(value);
-	if (id < 1) throw new ConfigError(`invalid ${label}: ${value} (must be ≥ 1)`);
-	return {
-		kind: "id",
-		id
-	};
-}
-function formatWorktreeRef(ref) {
-	return ref.kind === "id" ? String(ref.id) : `"${ref.branch}"`;
-}
-function resolveScopeSource(input) {
-	const stated = statedRef(input);
-	if (stated === null) return input.pin === null ? null : {
-		ref: {
-			kind: "id",
-			id: input.pin.id
-		},
-		origin: "pin",
-		scope: input.pin
-	};
-	const pin = input.pin;
-	if (pin === null) return {
-		...stated,
-		scope: null
-	};
-	if (!refMatchesScope(stated.ref, pin)) throw new ConfigError(`profile "${input.profile}" is pinned to worktree ${pin.id} (${pin.branch}); refusing ${ORIGIN_LABEL[stated.origin]} ${formatWorktreeRef(stated.ref)}`);
-	return {
-		...stated,
-		scope: pin
-	};
-}
-function describeScopeSource(source) {
-	return `${source.scope === null ? `worktree ${formatWorktreeRef(source.ref)}` : `worktree ${source.scope.id} (${source.scope.branch})`} from ${ORIGIN_LABEL[source.origin]}`;
-}
-function mainOnlyRefusal(command, source) {
-	return `${command} is not available inside a worktree (scope: ${describeScopeSource(source)}); it changes main-app content. Unpin the profile (\`mb worktree unpin\`) or drop ${ENV_WORKTREE} to run it against the main app.`;
-}
-function statedRef(input) {
-	if (input.flag !== void 0 && input.flag !== "") return {
-		ref: parseWorktreeRef(input.flag, WORKTREE_FLAG),
-		origin: "flag"
-	};
-	if (input.env !== void 0 && input.env !== "") return {
-		ref: parseWorktreeRef(input.env, ENV_WORKTREE),
-		origin: "env"
-	};
-	return null;
+//#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);
 }
-function refMatchesScope(ref, scope) {
-	return ref.kind === "id" ? ref.id === scope.id : ref.branch === scope.branch;
+const METHOD_KEYS = Object.keys(METHOD_REQUIREMENTS).filter(isMethodKey);
+function methodRequirements(key) {
+	return METHOD_REQUIREMENTS[key];
 }
 //#endregion
 //#region src/runtime/command-help.ts
@@ -788,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(),
@@ -797,8 +1205,8 @@ z.object({
 	args: z.array(CommandHelpArg),
 	inputSchema: z.unknown().nullable(),
 	outputSchema: z.unknown().nullable(),
-	capabilities: Capabilities.nullable(),
-	worktree: WorktreePolicy
+	requires: CommandHelpRequires.nullable(),
+	capabilities: CapabilitySummary.nullable()
 });
 const CommandIndexEntry = z.object({
 	command: z.string(),
@@ -815,8 +1223,8 @@ const EMPTY_AUGMENT = {
 	skills: [],
 	inputSchema: null,
 	outputSchema: null,
-	capabilities: null,
-	worktree: "any"
+	requires: null,
+	capabilities: null
 };
 async function buildHelpEntry(cmd, path) {
 	const meta = await resolveCitty(cmd.meta);
@@ -830,8 +1238,8 @@ 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,
-		worktree: augment.worktree
+		requires: augment.requires,
+		capabilities: augment.capabilities
 	};
 	if (augment.details !== null) entry.details = augment.details;
 	return entry;
@@ -1045,14 +1453,12 @@ async function walkCommandPath(root, rawArgs) {
 		unknownToken: null
 	};
 }
-async function resolveInvocation(root, rawArgs) {
-	const { segments, unknownToken } = await walkCommandPath(root, rawArgs);
-	const verbs = segments[0] === CLI_NAME ? segments.slice(1) : segments;
-	return {
-		breadcrumb: segments.length > 0 ? segments.join(" ") : CLI_NAME,
-		verbs: verbs.length > 0 ? verbs.join(" ") : null,
-		unknownToken
-	};
+async function resolveBreadcrumb(root, rawArgs) {
+	const { segments } = await walkCommandPath(root, rawArgs);
+	return segments.length > 0 ? segments.join(" ") : CLI_NAME;
+}
+async function findUnknownCommand(root, rawArgs) {
+	return (await walkCommandPath(root, rawArgs)).unknownToken;
 }
 function skipFlags(rawArgs, start, argsDef) {
 	let index = start;
@@ -1108,15 +1514,6 @@ function installInterruptHandler(exit) {
 	});
 }
 //#endregion
-//#region src/runtime/verb-chain.ts
-let verbChain = null;
-function setVerbChain(chain) {
-	verbChain = chain;
-}
-function readVerbChain() {
-	return verbChain;
-}
-//#endregion
 //#region src/cli.ts
 const HELP_FLAGS = /* @__PURE__ */ new Set(["--help", "-h"]);
 const JSON_HELP_FLAG = "--json";
@@ -1126,7 +1523,7 @@ async function run() {
 	const rawArgs = hoistGlobalFlags(process.argv.slice(2));
 	const wantsJsonHelp = rawArgs.includes(JSON_HELP_FLAG);
 	const showUsageWithBreadcrumb = async (cmd, parent) => {
-		const { breadcrumb } = await resolveInvocation(main, rawArgs);
+		const breadcrumb = await resolveBreadcrumb(main, rawArgs);
 		if (wantsJsonHelp) {
 			await showUsageJson(cmd, breadcrumb);
 			return;
@@ -1138,12 +1535,11 @@ async function run() {
 		return;
 	}
 	if (!rawArgs.some((arg) => HELP_FLAGS.has(arg))) {
-		const { unknownToken, verbs } = await resolveInvocation(main, rawArgs);
-		if (unknownToken !== null) {
-			reportError(new ConfigError(`unknown command: ${unknownToken}`));
+		const unknown = await findUnknownCommand(main, rawArgs);
+		if (unknown !== null) {
+			reportError(new ConfigError(`unknown command: ${unknown}`));
 			return;
 		}
-		setVerbChain(verbs);
 	}
 	await runMain(main, {
 		showUsage: showUsageWithBreadcrumb,
@@ -1154,4 +1550,4 @@ run().catch((error) => {
 	reportError(error);
 });
 //#endregion
-export { ENV_SKIP_PREFLIGHT as A, listFlagsWithDefaultLimit as B, promptText as C, ENV_DISABLE_KEYRING as D, ENV_API_KEY as E, setMetabaseAugment as F, listEnvelopeSchema as G, profileFlag as H, name as I, toAliasArray as J, flagConsumesValue as K, version as L, ENV_WORKTREE as M, consumeLegacyEnvWarnings as N, ENV_PROFILE as O, readEnv as P, connectionFlags as R, promptSelect as S, warn as T, worktreeFlag as U, outputFlags as V, DEFAULT_MAX_BYTES as W, formatScalar as _, parseWorktreeRef as a, promptConfirm as b, checkCapabilities as c, renderItem as d, renderList as f, MALFORMED_CELL as g, writeText as h, mainOnlyRefusal as i, ENV_URL as j, ENV_SKILLS_DIR as k, mergeCapabilities as l, writeJson as m, interruptSignal as n, resolveScopeSource as o, renderSummary as p, normalizeFlag as q, formatWorktreeRef as r, BASELINE_CAPABILITIES as s, readVerbChain as t, reportError as u, renderRows as v, listTruncationNotice as w, promptPassword as x, projectForList as y, listFlags 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 };