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

package/dist/{update-CHNSUHK4.mjs → update-Cr5zHb0D.mjs}

@@ -1,7 +1,7 @@
-import { F as outputFlags, I as profileFlag, M as connectionFlags, c as renderSummary } from "./cli.mjs";
-import { t as defineMetabaseCommand } from "./runtime-DiKyBxOw.mjs";
-import { t as parseId } from "./parse-id-C_jmKFaa.mjs";
-import { t as readBody } from "./body-Cur4NJt9.mjs";
+import { I as outputFlags, L as profileFlag, N as connectionFlags, c as renderSummary } from "./cli.mjs";
+import { t as defineMetabaseCommand } from "./runtime-BQiGgbgZ.mjs";
+import { t as parseId } from "./parse-id-DR8aUSdL.mjs";
+import { t as readBody } from "./body-C7m9q4cm.mjs";
 import { t as bodyInputFlags } from "./body-flags-AqKpN01Y.mjs";
 import { i as SnippetUpdateInput, t as Snippet } from "./snippet-CyKAgIZl.mjs";
 import { t as snippetView } from "./snippet-oJLaYW9V.mjs";
@@ -11,7 +11,7 @@ var update_default = defineMetabaseCommand({
 		name: "update",
 		description: "Update a native query snippet by id"
 	},
-	capabilities: { minVersion: 58 },
+	requires: ["snippet.update"],
 	args: {
 		...outputFlags,
 		...profileFlag,

package/dist/{update-Nfi44RrE.mjs → update-CtDHMxW8.mjs}

@@ -1,10 +1,10 @@
-import { F as outputFlags, I as profileFlag, M as connectionFlags, c as renderSummary } from "./cli.mjs";
-import { t as defineMetabaseCommand } from "./runtime-DiKyBxOw.mjs";
-import { t as parseId } from "./parse-id-C_jmKFaa.mjs";
-import { t as readBody } from "./body-Cur4NJt9.mjs";
+import { I as outputFlags, L as profileFlag, N as connectionFlags, c as renderSummary } from "./cli.mjs";
+import { t as defineMetabaseCommand } from "./runtime-BQiGgbgZ.mjs";
+import { t as parseId } from "./parse-id-DR8aUSdL.mjs";
+import { t as readBody } from "./body-C7m9q4cm.mjs";
 import { t as bodyInputFlags } from "./body-flags-AqKpN01Y.mjs";
 import { i as MeasureUpdateInput, t as Measure } from "./measure-CtfjqJFP.mjs";
-import { a as preflightMbql5Query, n as MEASURE_DEFINITION_LABELS, o as skipValidateFlag } from "./validate-query-DaGYSmpQ.mjs";
+import { a as preflightMbql5Query, n as MEASURE_DEFINITION_LABELS, o as skipValidateFlag } from "./validate-query-Boi8-cAP.mjs";
 import { t as measureView } from "./measure-4P0bOlZ3.mjs";
 //#region src/commands/measure/update.ts
 var update_default = defineMetabaseCommand({
@@ -17,7 +17,7 @@ var update_default = defineMetabaseCommand({
 		skill: "mbql",
 		purpose: "the definition aggregation"
 	}],
-	capabilities: { minVersion: 59 },
+	requires: ["measure.update"],
 	args: {
 		...outputFlags,
 		...profileFlag,

package/dist/{update-bD_Jh5-s.mjs → update-D1QdfpKR.mjs}

@@ -1,10 +1,10 @@
-import { F as outputFlags, I as profileFlag, M as connectionFlags, c as renderSummary } from "./cli.mjs";
+import { I as outputFlags, L as profileFlag, N as connectionFlags, c as renderSummary } from "./cli.mjs";
 import { c as NotificationUpdateInput, n as Notification } from "./notification-DaA4bBHW.mjs";
 import { t as notificationView } from "./notification-Fcq1fIPw.mjs";
-import { t as defineMetabaseCommand } from "./runtime-DiKyBxOw.mjs";
-import { t as parseId } from "./parse-id-C_jmKFaa.mjs";
+import { t as defineMetabaseCommand } from "./runtime-BQiGgbgZ.mjs";
+import { t as parseId } from "./parse-id-DR8aUSdL.mjs";
 import { t as describeAlert } from "./summary-BytbDz6e.mjs";
-import { t as readBody } from "./body-Cur4NJt9.mjs";
+import { t as readBody } from "./body-C7m9q4cm.mjs";
 import { t as bodyInputFlags } from "./body-flags-AqKpN01Y.mjs";
 //#region src/commands/alert/update.ts
 var update_default = defineMetabaseCommand({
@@ -18,7 +18,7 @@ var update_default = defineMetabaseCommand({
 		"`subscriptions` and `handlers` replace the whole list, so send every schedule and recipient you want to keep —",
 		"`mb alert get <id>` prints the current ones. An alert's card cannot be moved to a different card."
 	].join(" "),
-	capabilities: { minVersion: 58 },
+	requires: ["notification.update"],
 	args: {
 		...outputFlags,
 		...profileFlag,

package/dist/{update-BZPllQoR.mjs → update-D4qdTlLF.mjs}

@@ -1,7 +1,7 @@
-import { F as outputFlags, I as profileFlag, M as connectionFlags, c as renderSummary } from "./cli.mjs";
-import { t as defineMetabaseCommand } from "./runtime-DiKyBxOw.mjs";
-import { t as parseId } from "./parse-id-C_jmKFaa.mjs";
-import { t as readBody } from "./body-Cur4NJt9.mjs";
+import { I as outputFlags, L as profileFlag, N as connectionFlags, c as renderSummary } from "./cli.mjs";
+import { t as defineMetabaseCommand } from "./runtime-BQiGgbgZ.mjs";
+import { t as parseId } from "./parse-id-DR8aUSdL.mjs";
+import { t as readBody } from "./body-C7m9q4cm.mjs";
 import { t as bodyInputFlags } from "./body-flags-AqKpN01Y.mjs";
 import { i as TimelineEvent, s as TimelineEventUpdateInput } from "./timeline-CCSU2qOS.mjs";
 import { t as timelineEventView } from "./timeline-uDCmwGFT.mjs";
@@ -12,7 +12,7 @@ var update_default = defineMetabaseCommand({
 		description: "Update a timeline event by id"
 	},
 	details: "Patches only the fields you send: `name`, `description`, `timestamp`, `timezone`, `time_matters`, `icon`, `timeline_id` (moves the event to another timeline), `archived`.",
-	capabilities: { minVersion: 58 },
+	requires: ["timelineEvent.update"],
 	args: {
 		...outputFlags,
 		...profileFlag,

package/dist/{update-C4YJQFDS.mjs → update-DBGaJDsj.mjs}

@@ -1,7 +1,7 @@
-import { F as outputFlags, I as profileFlag, M as connectionFlags, c as renderSummary } from "./cli.mjs";
-import { t as defineMetabaseCommand } from "./runtime-DiKyBxOw.mjs";
-import { t as parseId } from "./parse-id-C_jmKFaa.mjs";
-import { t as readBody } from "./body-Cur4NJt9.mjs";
+import { I as outputFlags, L as profileFlag, N as connectionFlags, c as renderSummary } from "./cli.mjs";
+import { t as defineMetabaseCommand } from "./runtime-BQiGgbgZ.mjs";
+import { t as parseId } from "./parse-id-DR8aUSdL.mjs";
+import { t as readBody } from "./body-C7m9q4cm.mjs";
 import { t as bodyInputFlags } from "./body-flags-AqKpN01Y.mjs";
 import { o as FieldUpdateInput, t as Field } from "./field-Cr2DPUG9.mjs";
 import { r as fieldView } from "./field-BPsNa-TO.mjs";
@@ -11,7 +11,7 @@ var update_default = defineMetabaseCommand({
 		name: "update",
 		description: "Update a field (description, semantic_type, FK target, visibility, etc.)"
 	},
-	capabilities: { minVersion: 58 },
+	requires: ["field.update"],
 	args: {
 		...outputFlags,
 		...profileFlag,

package/dist/{update-tX9mKBN_.mjs → update-Izqip6jY.mjs}

@@ -1,18 +1,18 @@
-import { F as outputFlags, I as profileFlag, M as connectionFlags, c as renderSummary } from "./cli.mjs";
-import { t as defineMetabaseCommand } from "./runtime-DiKyBxOw.mjs";
-import { t as parseId } from "./parse-id-C_jmKFaa.mjs";
-import { t as readBody } from "./body-Cur4NJt9.mjs";
+import { I as outputFlags, L as profileFlag, N as connectionFlags, c as renderSummary } from "./cli.mjs";
+import { t as defineMetabaseCommand } from "./runtime-BQiGgbgZ.mjs";
+import { t as parseId } from "./parse-id-DR8aUSdL.mjs";
+import { t as readBody } from "./body-C7m9q4cm.mjs";
 import { t as bodyInputFlags } from "./body-flags-AqKpN01Y.mjs";
-import { i as DashboardDetail, o as DashboardUpdateInput } from "./dashboard-BCpSq_G-.mjs";
-import { t as dashboardView } from "./dashboard-CsIFFpzK.mjs";
-import { t as preflightDashcardCardReferences } from "./preflight-YpPQo-sa.mjs";
+import { i as DashboardDetail, o as DashboardUpdateInput } from "./dashboard-CKUR8ZpQ.mjs";
+import { t as dashboardView } from "./dashboard-BlbNszi8.mjs";
+import { t as preflightDashcardCardReferences } from "./preflight-Bl1oitm8.mjs";
 //#region src/commands/dashboard/update.ts
 var update_default = defineMetabaseCommand({
 	meta: {
 		name: "update",
 		description: "Update a dashboard (and optionally its dashcards/tabs) by id"
 	},
-	details: "Any positive card_id referenced from dashcards is pre-flight-validated (exists and readable, not archived) before the PUT.",
+	details: "Every dashcard must include card_id (a card id, or null for a virtual card). Any positive card_id is pre-flight-validated (exists and readable, not archived) before the PUT.",
 	skills: [{
 		skill: "dashboard",
 		purpose: "wiring filters, cross-filtering, click behavior, tabs"
@@ -20,7 +20,7 @@ var update_default = defineMetabaseCommand({
 		skill: "visualization",
 		purpose: "dashcard visualization_settings and the 24-column grid"
 	}],
-	capabilities: { minVersion: 58 },
+	requires: ["dashboard.update", "dashboard.checkCardReferences"],
 	args: {
 		...outputFlags,
 		...profileFlag,

package/dist/{update-cYkvbqK8.mjs → update-NZhIjTCf.mjs}

@@ -1,7 +1,7 @@
-import { F as outputFlags, I as profileFlag, M as connectionFlags, c as renderSummary } from "./cli.mjs";
-import { t as defineMetabaseCommand } from "./runtime-DiKyBxOw.mjs";
-import { t as parseId } from "./parse-id-C_jmKFaa.mjs";
-import { t as readBody } from "./body-Cur4NJt9.mjs";
+import { I as outputFlags, L as profileFlag, N as connectionFlags, c as renderSummary } from "./cli.mjs";
+import { t as defineMetabaseCommand } from "./runtime-BQiGgbgZ.mjs";
+import { t as parseId } from "./parse-id-DR8aUSdL.mjs";
+import { t as readBody } from "./body-C7m9q4cm.mjs";
 import { t as bodyInputFlags } from "./body-flags-AqKpN01Y.mjs";
 import { c as TimelineUpdateInput, t as Timeline } from "./timeline-CCSU2qOS.mjs";
 import { n as timelineView } from "./timeline-uDCmwGFT.mjs";
@@ -12,7 +12,7 @@ var update_default = defineMetabaseCommand({
 		description: "Update a timeline by id"
 	},
 	details: "Patches only the fields you send: `name`, `description`, `icon`, `collection_id`, `default`, `archived`. Changing `archived` cascades to every event on the timeline.",
-	capabilities: { minVersion: 58 },
+	requires: ["timeline.update"],
 	args: {
 		...outputFlags,
 		...profileFlag,

package/dist/{update-dashcard-C3TuYO_k.mjs → update-dashcard-D5b971AO.mjs}

@@ -1,17 +1,17 @@
-import { F as outputFlags, I as profileFlag, M as connectionFlags, c as renderSummary } from "./cli.mjs";
-import { t as defineMetabaseCommand } from "./runtime-DiKyBxOw.mjs";
-import { t as parseId } from "./parse-id-C_jmKFaa.mjs";
-import { t as readBody } from "./body-Cur4NJt9.mjs";
+import { I as outputFlags, L as profileFlag, N as connectionFlags, c as renderSummary } from "./cli.mjs";
+import { t as defineMetabaseCommand } from "./runtime-BQiGgbgZ.mjs";
+import { t as parseId } from "./parse-id-DR8aUSdL.mjs";
+import { t as readBody } from "./body-C7m9q4cm.mjs";
 import { t as bodyInputFlags } from "./body-flags-AqKpN01Y.mjs";
-import { l as DashcardPatchInput, s as Dashcard } from "./dashboard-BCpSq_G-.mjs";
-import { n as dashcardView } from "./dashboard-CsIFFpzK.mjs";
+import { l as DashcardPatchInput, s as Dashcard } from "./dashboard-CKUR8ZpQ.mjs";
+import { n as dashcardView } from "./dashboard-BlbNszi8.mjs";
 //#region src/commands/dashboard/update-dashcard.ts
 var update_dashcard_default = defineMetabaseCommand({
 	meta: {
 		name: "update-dashcard",
 		description: "Patch a single dashcard's layout or settings on a dashboard"
 	},
-	capabilities: { minVersion: 58 },
+	requires: ["dashboard.updateDashcard"],
 	args: {
 		...outputFlags,
 		...profileFlag,

package/dist/{update-CVPAwJaH.mjs → update-sYLQIUgh.mjs}

@@ -1,10 +1,10 @@
-import { F as outputFlags, I as profileFlag, M as connectionFlags, c as renderSummary } from "./cli.mjs";
-import { t as defineMetabaseCommand } from "./runtime-DiKyBxOw.mjs";
-import { t as parseId } from "./parse-id-C_jmKFaa.mjs";
-import { t as readBody } from "./body-Cur4NJt9.mjs";
+import { I as outputFlags, L as profileFlag, N as connectionFlags, c as renderSummary } from "./cli.mjs";
+import { t as defineMetabaseCommand } from "./runtime-BQiGgbgZ.mjs";
+import { t as parseId } from "./parse-id-DR8aUSdL.mjs";
+import { t as readBody } from "./body-C7m9q4cm.mjs";
 import { t as bodyInputFlags } from "./body-flags-AqKpN01Y.mjs";
 import { i as SegmentUpdateInput, t as Segment } from "./segment-OsrbUDzw.mjs";
-import { a as preflightMbql5Query, o as skipValidateFlag, r as SEGMENT_DEFINITION_LABELS } from "./validate-query-DaGYSmpQ.mjs";
+import { a as preflightMbql5Query, o as skipValidateFlag, r as SEGMENT_DEFINITION_LABELS } from "./validate-query-Boi8-cAP.mjs";
 import { t as segmentView } from "./segment-C_gl5ag6.mjs";
 //#region src/commands/segment/update.ts
 var update_default = defineMetabaseCommand({
@@ -17,7 +17,7 @@ var update_default = defineMetabaseCommand({
 		skill: "mbql",
 		purpose: "the definition filter clause"
 	}],
-	capabilities: { minVersion: 58 },
+	requires: ["segment.update"],
 	args: {
 		...outputFlags,
 		...profileFlag,

package/dist/{upgrade-DXMV4AyP.mjs → upgrade-CD1xtsIv.mjs}

@@ -1,12 +1,10 @@
-import { f as errorMessage, l as TimeoutError, n as AbortError, s as NetworkError, u as UnknownError } from "./predicates-Bkm2IoeX.mjs";
-import { A as name, F as outputFlags, h as promptConfirm, j as version, o as renderItem, t as interruptSignal, u as writeText } from "./cli.mjs";
-import { t as defineMetabaseCommand, u as USER_AGENT } from "./runtime-DiKyBxOw.mjs";
-import { h as parseJson, r as HttpError } from "./network-error-CEb9ymDW.mjs";
-import { n as throwIfAborted, t as combineAborts } from "./signal-CMd0EFUa.mjs";
-import { n as streamProcess } from "./process-DBOOrmET.mjs";
+import { I as outputFlags, M as version, Q as UnknownError, W as AbortError, Y as NetworkError, Z as TimeoutError, a as renderItem, et as errorMessage, g as promptConfirm, j as name, t as interruptSignal, u as writeText } from "./cli.mjs";
+import { L as HttpError, O as USER_AGENT, V as parseJson, t as defineMetabaseCommand } from "./runtime-BQiGgbgZ.mjs";
+import { n as throwIfAborted, t as combineAborts } from "./signal-GhGmuHfx.mjs";
+import { n as streamProcess } from "./process-CcQM4qPv.mjs";
 import { z } from "zod";
-import { compare, valid } from "semver";
 import { realpathSync } from "node:fs";
+import { compare, valid } from "semver";
 //#region src/core/npm-registry.ts
 const DEFAULT_REGISTRY = "https://registry.npmjs.org";
 const DEFAULT_TIMEOUT_MS = 15e3;
@@ -291,7 +289,7 @@ var upgrade_default = defineMetabaseCommand({
 		name: "upgrade",
 		description: "Upgrade the Metabase CLI itself to the latest published release"
 	},
-	capabilities: null,
+	requires: null,
 	args: {
 		...outputFlags,
 		check: {

package/dist/upload-BUd3MG90.mjs

@@ -0,0 +1,23 @@
+import { K as ConfigError, tt as isFileNotFoundError } from "./cli.mjs";
+import { n as fileNotFoundError } from "./input-DFZ_qGW_.mjs";
+import { basename } from "node:path";
+import { readFile } from "node:fs/promises";
+//#region src/runtime/upload.ts
+function requireUploadFilePath(file) {
+	if (typeof file !== "string" || file.trim() === "") throw new ConfigError("provide the CSV file to upload with --file <path>");
+	return file;
+}
+async function readCsvFile(path) {
+	try {
+		const bytes = await readFile(path);
+		return {
+			filename: basename(path),
+			bytes
+		};
+	} catch (error) {
+		if (isFileNotFoundError(error)) throw fileNotFoundError(path);
+		throw error;
+	}
+}
+//#endregion
+export { requireUploadFilePath as n, readCsvFile as t };

package/dist/upload-C3z5ZaXA.mjs

@@ -0,0 +1,24 @@
+import { n as UploadUpdateResult, t as UploadResult } from "./upload-DAtxBBms.mjs";
+//#region src/output/views/upload.ts
+const uploadResultView = {
+	compactPick: UploadResult,
+	tableColumns: [{
+		key: "model_id",
+		label: "Model ID"
+	}, {
+		key: "table_id",
+		label: "Table ID"
+	}]
+};
+const uploadUpdateResultView = {
+	compactPick: UploadUpdateResult,
+	tableColumns: [{
+		key: "table_id",
+		label: "Table ID"
+	}, {
+		key: "action",
+		label: "Action"
+	}]
+};
+//#endregion
+export { uploadUpdateResultView as n, uploadResultView as t };

package/dist/upload-DzGTlldn.mjs

@@ -0,0 +1,13 @@
+import { t as defineCommandGroup } from "./group-CmVCLBDz.mjs";
+//#region src/commands/upload/index.ts
+var upload_default = defineCommandGroup({
+	name: "upload",
+	description: "Upload CSV files into Metabase",
+	subCommands: {
+		csv: () => import("./csv-CUQvcCEk.mjs").then((m) => m.default),
+		append: () => import("./append-B9Htvmab.mjs").then((m) => m.default),
+		replace: () => import("./replace-BmAqD3zY.mjs").then((m) => m.default)
+	}
+});
+//#endregion
+export { upload_default as default };

package/dist/upload-akKFxpVA.mjs

@@ -0,0 +1,39 @@
+import { I as outputFlags, L as profileFlag, N as connectionFlags, c as renderSummary } from "./cli.mjs";
+import { t as defineMetabaseCommand } from "./runtime-BQiGgbgZ.mjs";
+import { t as ContentTranslationUploadResult } from "./content-translation-BrHOrmj9.mjs";
+import { n as requireUploadFilePath, t as readCsvFile } from "./upload-BUd3MG90.mjs";
+//#region src/output/views/content-translation.ts
+const contentTranslationUploadView = {
+	compactPick: ContentTranslationUploadResult,
+	tableColumns: [{
+		key: "success",
+		label: "Success"
+	}]
+};
+//#endregion
+//#region src/commands/content-translation/upload.ts
+var upload_default = defineMetabaseCommand({
+	meta: {
+		name: "upload",
+		description: "Replace the complete content translation dictionary from CSV"
+	},
+	details: "Uploads one complete dictionary and replaces every active content translation on the server. Keep the canonical full CSV in version control and download the current dictionary before replacing it. Metabase accepts dictionaries up to 1.5 MiB.",
+	requires: ["contentTranslation.upload"],
+	args: {
+		...outputFlags,
+		...profileFlag,
+		...connectionFlags,
+		file: {
+			type: "string",
+			description: "Path to the complete translation dictionary CSV"
+		}
+	},
+	outputSchema: ContentTranslationUploadResult,
+	examples: ["mb content-translation upload --file translations.csv", "mb content-translation upload --file translations.csv --profile prod --json"],
+	async run({ args, ctx, getClient }) {
+		const file = await readCsvFile(requireUploadFilePath(args.file));
+		renderSummary(await (await getClient()).contentTranslation.upload(file), contentTranslationUploadView, `Replaced the content translation dictionary with "${file.filename}".`, ctx);
+	}
+});
+//#endregion
+export { upload_default as default };

package/dist/{uuid-BJkDWj9p.mjs → uuid-oVdJ62eA.mjs}

@@ -1,6 +1,5 @@
-import { i as ConfigError } from "./predicates-Bkm2IoeX.mjs";
-import { F as outputFlags, l as writeJson, u as writeText } from "./cli.mjs";
-import { R as parseInteger, t as defineMetabaseCommand } from "./runtime-DiKyBxOw.mjs";
+import { I as outputFlags, K as ConfigError, l as writeJson, u as writeText } from "./cli.mjs";
+import { nt as parseInteger, t as defineMetabaseCommand } from "./runtime-BQiGgbgZ.mjs";
 import { z } from "zod";
 import { randomUUID } from "node:crypto";
 //#region src/commands/uuid.ts
@@ -16,7 +15,7 @@ var uuid_default = defineMetabaseCommand({
 		skill: "mbql",
 		purpose: "where lib/uuid values are used"
 	}],
-	capabilities: null,
+	requires: null,
 	args: {
 		...outputFlags,
 		count: {

package/dist/{validate-BWchyW0V.mjs → validate-CWd6l6KZ.mjs}

@@ -1,4 +1,4 @@
-import { h as escapeJsonPointerSegment, i as ConfigError, t as isPlainObject } from "./predicates-Bkm2IoeX.mjs";
+import { K as ConfigError, gt as escapeJsonPointerSegment, h as isPlainObject } from "./cli.mjs";
 import { z } from "zod";
 import Ajv2020 from "ajv/dist/2020.js";
 import addFormats from "ajv-formats";

package/dist/{validate-query-DaGYSmpQ.mjs → validate-query-Boi8-cAP.mjs}

@@ -1,6 +1,5 @@
-import { i as ConfigError } from "./predicates-Bkm2IoeX.mjs";
-import { l as writeJson } from "./cli.mjs";
-import { i as validateQuery, r as isMbql5Query, t as assertNotLegacyEnvelopeWrappingMbql5 } from "./validate-BWchyW0V.mjs";
+import { K as ConfigError, l as writeJson } from "./cli.mjs";
+import { i as validateQuery, r as isMbql5Query, t as assertNotLegacyEnvelopeWrappingMbql5 } from "./validate-CWd6l6KZ.mjs";
 //#region src/commands/validate-query.ts
 const skipValidateFlag = { "skip-validate": {
 	type: "boolean",

package/dist/{values-Dxf1JEoA.mjs → values-DLwZl-P8.mjs}

@@ -1,6 +1,6 @@
-import { F as outputFlags, I as profileFlag, M as connectionFlags, c as renderSummary, f as formatScalar } from "./cli.mjs";
-import { t as defineMetabaseCommand } from "./runtime-DiKyBxOw.mjs";
-import { t as parseId } from "./parse-id-C_jmKFaa.mjs";
+import { I as outputFlags, L as profileFlag, N as connectionFlags, c as renderSummary, f as formatScalar } from "./cli.mjs";
+import { t as defineMetabaseCommand } from "./runtime-BQiGgbgZ.mjs";
+import { t as parseId } from "./parse-id-DR8aUSdL.mjs";
 import { s as FieldValues } from "./field-Cr2DPUG9.mjs";
 import { n as fieldValuesView } from "./field-BPsNa-TO.mjs";
 //#region src/commands/field/values.ts
@@ -9,7 +9,7 @@ var values_default = defineMetabaseCommand({
 		name: "values",
 		description: "Fetch the cached distinct values for a field (FieldValues list)"
 	},
-	capabilities: { minVersion: 58 },
+	requires: ["field.values"],
 	args: {
 		...outputFlags,
 		...profileFlag,

package/dist/{verify-K96rItG5.mjs → verify-CH9Tw8yv.mjs}

@@ -1,21 +1,6 @@
-import { n as createClient } from "./client-BqhzKdLM.mjs";
-import { f as errorMessage, l as TimeoutError, o as MetabaseError, s as NetworkError } from "./predicates-Bkm2IoeX.mjs";
-import { F as tryParseTag, I as SessionProperties, u as USER_AGENT } from "./runtime-DiKyBxOw.mjs";
-import { r as HttpError } from "./network-error-CEb9ymDW.mjs";
-//#region ../client/src/version/probe.ts
-const PROBE_PATH = "/api/session/properties";
-const PROBE_TIMEOUT_MS = 1e4;
-async function probeServer(client, opts = {}) {
-	const properties = await client.requestParsed(SessionProperties, PROBE_PATH, {
-		timeoutMs: PROBE_TIMEOUT_MS,
-		retries: opts.retries ?? 0
-	});
-	return {
-		version: tryParseTag(properties.version.tag),
-		tokenFeatures: properties["token-features"] ?? null
-	};
-}
-//#endregion
+import { n as createClient } from "./client-Bv7Iwdvh.mjs";
+import { J as MetabaseError, Y as NetworkError, Z as TimeoutError, et as errorMessage } from "./cli.mjs";
+import { $ as probeServer, L as HttpError, O as USER_AGENT } from "./runtime-BQiGgbgZ.mjs";
 //#region src/core/auth/verify.ts
 const VERIFY_TIMEOUT_MS = 15e3;
 async function verifyAndProbe(url, credential, options = {}) {

package/dist/{wait-flags-DWEF9tX4.mjs → wait-flags-DiQ_kRjZ.mjs}

@@ -1,6 +1,6 @@
 import { t as interruptSignal } from "./cli.mjs";
-import { t as parseId } from "./parse-id-C_jmKFaa.mjs";
-import { n as DEFAULT_TIMEOUT_MS, t as DEFAULT_INTERVAL_MS } from "./poll-75SvT7Zv.mjs";
+import { t as parseId } from "./parse-id-DR8aUSdL.mjs";
+import { n as DEFAULT_TIMEOUT_MS, t as DEFAULT_INTERVAL_MS } from "./poll-By46YQ5J.mjs";
 //#region src/commands/wait-flags.ts
 const waitScheduleFlags = {
 	timeout: {

package/dist/{wait-DoMDH226.mjs → wait-rfTdQWdi.mjs}

@@ -1,7 +1,7 @@
-import { F as outputFlags, I as profileFlag, M as connectionFlags, c as renderSummary } from "./cli.mjs";
-import { t as defineMetabaseCommand } from "./runtime-DiKyBxOw.mjs";
-import { n as DEFAULT_TIMEOUT_MS, t as DEFAULT_INTERVAL_MS } from "./poll-75SvT7Zv.mjs";
-import { r as parseWaitSchedule } from "./wait-flags-DWEF9tX4.mjs";
+import { I as outputFlags, L as profileFlag, N as connectionFlags, c as renderSummary } from "./cli.mjs";
+import { t as defineMetabaseCommand } from "./runtime-BQiGgbgZ.mjs";
+import { n as DEFAULT_TIMEOUT_MS, t as DEFAULT_INTERVAL_MS } from "./poll-By46YQ5J.mjs";
+import { r as parseWaitSchedule } from "./wait-flags-DiQ_kRjZ.mjs";
 import { c as syncTaskView } from "./git-sync-DxD_ng48.mjs";
 import { a as throwIfFailedTask, i as taskPollOptions, n as formatSyncTask, r as syncTaskIdleView, t as SyncTaskOrIdle } from "./sync-task-BACcrs0i.mjs";
 //#region src/commands/git-sync/wait.ts
@@ -11,10 +11,7 @@ var wait_default = defineMetabaseCommand({
 		name: "wait",
 		description: "Poll the current git-sync task until it reaches a terminal status"
 	},
-	capabilities: {
-		minVersion: 60,
-		tokenFeature: "remote_sync"
-	},
+	requires: ["gitSync.waitForTask"],
 	args: {
 		...outputFlags,
 		...profileFlag,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metabase/cli",
-  "version": "0.3.0",
+  "version": "0.3.1-alpha.versioning.9ac5f50",
   "description": "Metabase CLI",
   "license": "AGPL-3.0",
   "repository": {

package/skill-data/core/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: core
-description: Foundations for driving Metabase from the terminal with the `mb` CLI — authentication and named profiles, the flag/output/`--json` conventions every command shares, JSON body input, command discovery via `--help` (add `--json` for machine-readable schemas), and the per-resource footguns (db, table, field, upload, card, dashboard, collection, segment, measure, timeline, alert, subscription, library, setting, search, eid). Load first for any `mb` task; it routes to the specialized skills for deeper work.
+description: Foundations for driving Metabase from the terminal with the `mb` CLI — authentication and named profiles, the flag/output/`--json` conventions every command shares, JSON body input, command discovery via `--help` (add `--json` for machine-readable schemas), and the per-resource footguns (db, table, field, upload, content translation, card, dashboard, collection, segment, measure, timeline, alert, subscription, library, setting, search, eid). Load first for any `mb` task; it routes to the specialized skills for deeper work.
 allowed-tools: Read, Write, Edit, Bash, AskUserQuestion
 ---
 
@@ -11,7 +11,7 @@ The official Metabase CLI (`mb`) drives a Metabase instance over its REST API: a
 Top-level command groups (run `mb <group> --help` to discover verbs):
 
 ```
-auth | db | table | field | upload | query | card | dashboard | snippet | segment | measure | collection | library
+auth | db | table | field | upload | content-translation | query | card | dashboard | snippet | segment | measure | collection | library
 document | timeline | timeline-event | transform | transform-job | transform-tag | alert | subscription | setting
 search | git-sync | setup | eid | uuid | upgrade | skills
 ```
@@ -129,8 +129,11 @@ Routine verb shapes (list / get / create / update), every flag, and output schem
 - **table fields.** `table get` never returns fields on its own — pass `--include fields` (compact; the underlying query_metadata response also carries FK targets and dimensions, visible under `--full`) or use `table fields <id>` (list envelope). `table update` patches table-level metadata only; physical columns aren't editable.
 - **field has no `list`.** Fields are per-table — get them via `table get <id> --include fields`. Never enumerate fields across a whole db (context blow-up). `field summary` is live cardinality `{field_id, count, distincts}`; `field values` is the cached distinct set (`has_more_values: true` ⇒ truncated cache). `field update` patches metadata only (`base_type` isn't editable) — this is where you set a column's `semantic_type` or foreign-key target.
 - **upload (CSV → tables).** `upload csv --file <path>` creates a new table + model (prints `{model_id, table_id}`); `upload append <table-id>` / `upload replace <table-id> --file <path>` add to / overwrite a table **previously created by upload** (columns must match). The destination db+schema is admin-configured, not per-call — check with `mb setting get uploads-settings --json` (`db_id: null` ⇒ uploads off/unconfigured; needs admin to read). `--collection <id|root>` only sets the model's collection. Max 50 MB. Errors: **"The uploads database is not configured."** = no db has uploads enabled; **"Uploads are not enabled."** = the append/replace target isn't an uploaded table.
+<!-- requires: contentTranslation -->
+- **content-translation.** Admin-only, and separate from Remote Sync. `content-translation download > translations.csv` streams the complete active dictionary; `content-translation upload --file translations.csv` replaces every active translation with the file's contents. Always upload the canonical complete CSV, never a partial patch. An empty dictionary downloads as Metabase's four-row sample dictionary — don't re-upload it as real translations. Metabase limits dictionaries to 1.5 MiB.
+<!-- /requires -->
 - **card.** `dataset_query` is the **flat** `mbql/query` value, not a legacy `{type:"query",query:…}` envelope (→ `mbql`). `--export-format csv|xlsx` streams the raw export (pipe to a file), bypassing the JSON envelope. `archive` is the only delete; unarchive with `update --body '{"archived":false}'`. `visualization_settings` keys are scoped by `display` and aren't pre-flighted — see `visualization`.
-- **dashboard.** Dashcards round-trip through `PUT /api/dashboard/:id` (no per-dashcard endpoint): `update-dashcard <dash-id> <dashcard-id>` patches one safely; `update --body '{"dashcards":[…]}'` replaces the whole set (omitted ids are deleted server-side; negative ids for new cards). `create` accepts the **same** `dashcards` array in its initial body — lay out the whole dashboard in one call: negative ids for new cards, and `card_id:null` plus a `visualization_settings.virtual_card` block (`{display:"text"|"heading"|"link"|…}`) for non-question cards. `create`/`update` pre-flight every positive `card_id` and exit **2** with `{ok:false,errors:[…]}` on a bad ref (non-bypassable). `dashboard get <id>` (or `--full`) hydrates dashcards/tabs; `list` omits them. **The grid is 24 columns wide:** each dashcard's `{col, row, size_x, size_y}` is in grid units — **full-width is `size_x: 24`** (`size_x: 12` is half a row, the usual cause of a card filling only half the width). Keep `col + size_x ≤ 24`, start a full-width stack's `col` at 0, and don't overlap (the server stores collisions as sent — no auto-fix). Layout patterns and per-chart default sizes → the `dashboard` skill; load it before composing any `dashcards` array.
+- **dashboard.** Dashcards round-trip through `PUT /api/dashboard/:id` (no per-dashcard endpoint): `update-dashcard <dash-id> <dashcard-id>` patches one safely; `update --body '{"dashcards":[…]}'` replaces the whole set (omitted ids are deleted server-side; negative ids for new cards). Every dashcard must include `card_id`, including existing rows; use `card_id:null` plus a `visualization_settings.virtual_card` block (`{display:"text"|"heading"|"link"|…}`) for non-question cards. `create` accepts the **same** `dashcards` array in its initial body, so lay out the whole dashboard in one call. `create`/`update` pre-flight every positive `card_id` and exit **2** with `{ok:false,errors:[…]}` on a bad ref (non-bypassable). `dashboard get <id>` (or `--full`) hydrates dashcards/tabs; `list` omits them. **The grid is 24 columns wide:** each dashcard's `{col, row, size_x, size_y}` is in grid units — **full-width is `size_x: 24`** (`size_x: 12` is half a row, the usual cause of a card filling only half the width). Keep `col + size_x ≤ 24`, start a full-width stack's `col` at 0, and don't overlap (the server stores collisions as sent — no auto-fix). Layout patterns and per-chart default sizes → the `dashboard` skill; load it before composing any `dashcards` array.
 - **dashboard parameters (filters).** A dashboard's `parameters` array holds its filter widgets; they're part of the dashboard record, so read them with `dashboard get <id> --fields parameters --json` (no separate verb). **Editing replaces the _whole_ array** (like dashcards), so it's a read-modify-write loop and omitting a parameter deletes it. A parameter only filters a card once it is **mapped** onto that dashcard's `parameter_mappings` — an unmapped parameter is an inert widget. `type` is a **closed enum**; an unlisted value is a hard parse error that echoes the full allowed set back to you. `dashboard parameter-values <id> <parameter-id> [--query <substr>]` fetches a widget's selectable values (`{values, has_more_values}`; `--query` is a case-insensitive substring search). Parameter types, ids, mapping targets, and value sources → the `dashboard` skill; load it before authoring a `parameters` array.
 - **alert / subscription are two unrelated systems.** `alert` watches one **card** and fires on a send condition (`/api/notification`: a cron string, `channel/email`-prefixed handlers, typed recipients); `subscription` delivers one **dashboard** on a schedule (`/api/pulse`: structured `schedule_type` + hour/day/frame, bare `email` channels, `{id}|{email}` recipients). The bodies are not interchangeable. Both silently deliver nowhere if the server has no SMTP / Slack app — check `mb setting get 'email-configured?'` (quote it; the `?` is a shell glob) before creating either. Their list-valued fields (`handlers`/`subscriptions`, `channels`/`cards`) **replace wholesale** on update, so adding one recipient is a read-modify-write. `mb card alerts <id>` and `mb dashboard subscriptions <id>` list what's already attached to a card/dashboard; `archive` deactivates rather than deletes. Load the `notification` skill before authoring either body.
 - **snippet `--archived` is a swap, not a union** — list returns _either_ active _or_ archived rows, never both. (Same for `--filter archived` on dashboard/collection.)
@@ -139,10 +142,14 @@ Routine verb shapes (list / get / create / update), every flag, and output schem
 - **collection `<ref>`** accepts four forms only — positive int, `root`, `trash`, or a 21-char entity_id; anything else is a client-side `ConfigError`. `collection items` pages the server endpoint, pulling only as far as the output cap can show — read `has_more`/`next_offset` to continue. `collection tree` is **JSON-only** (`--format text` is rejected). A transform collection needs `collection create --namespace transforms`.
 - **setting set** parses the value as **strict JSON**: a string is `'"value"'` (inner quotes), booleans `true`/`false`, numbers bare. Wrong quoting silently errors — confirm with `setting get <key>` after. `setting get --json` works on every value type (wrapping bare-text responses into `{key, value}`).
 - **search vs. list.** For plain enumeration of cards/dashboards/collections use the dedicated `… list` verbs; reach for `search --models <kind>` only for ranking against a query string or a cross-resource lookup.
+<!-- requires: transforms -->
 - **transform.** Iterate with `transform update <id>`, never `delete` + `create` (keeps the row, `entity_id`, materialized table, and YAML filename — avoids `_2` suffixes and noisy git history). `transform run` needs `--wait` (or `--sync`, which also waits for the output table to register and returns `target_table_id`) or you get only `{run_id, final:null}`. (→ `transform`.)
+<!-- /requires -->
 - **setup is one-shot.** `mb setup` walks `/api/setup` for a **fresh** instance only — errors against an already-configured one. Mostly for bootstrapping local / e2e instances.
 - **eid** translates a string entity id → numeric id: `mb eid --model <model> <eid1,eid2> --json`. Entity ids are NanoIDs that can start with `-`, which the positional form misreads as a flag (shell quotes don't help) — for those, use `--body '{"entity_ids":{"card":["-…"]}}'` (the id is a JSON string value, immune to flag parsing).
-- **library.** EE-only (`library` premium feature, v59+). The Library is a curated subtree (`library-data` "Data" + `library-metrics` "Metrics" under a `library` root): tables published to **Data** appear first in data pickers and rank up in search; metrics saved to **Metrics** are prioritized in nav, search, and the query builder — it's how you tell people (and agents) "start from these, they're trusted." `library get` shows the Library and its Data/Metrics collection ids; `library create` provisions it (idempotent). `library publish --table-ids/--db-ids/--schemas` publishes tables into Data — it **resolves the Data collection itself and creates the Library if absent** (no collection id to find); each `--schemas` entry is `<db-id>:<schema>` (e.g. `1:public`), not a bare name. `publish` cascades to upstream FK dependencies, `unpublish` to downstream dependents; both need **admin or data-analyst** (Curate alone won't publish) and exit **403** without write **and** query permission on every affected table. Publish status shows on the table: `table get`/`table list` carry `is_published` (`collection_id` under `--full`). Good candidates are finished, analysis-ready tables — clean/combine via transforms first, then publish the polished result. Publishing does not put the Data collection in the git-sync scope: on a remote-sync instance, `mb git-sync add-collection <data-collection-id>` is what makes exports carry the published tables' metadata (see the `git-sync` skill).
+<!-- requires: library -->
+- **library.** The Library is a curated subtree (`library-data` "Data" + `library-metrics` "Metrics" under a `library` root): tables published to **Data** appear first in data pickers and rank up in search; metrics saved to **Metrics** are prioritized in nav, search, and the query builder — it's how you tell people (and agents) "start from these, they're trusted." `library get` shows the Library and its Data/Metrics collection ids; `library create` provisions it (idempotent). `library publish --table-ids/--db-ids/--schemas` publishes tables into Data — it **resolves the Data collection itself and creates the Library if absent** (no collection id to find); each `--schemas` entry is `<db-id>:<schema>` (e.g. `1:public`), not a bare name. `publish` cascades to upstream FK dependencies, `unpublish` to downstream dependents; both need **admin or data-analyst** (Curate alone won't publish) and exit **403** without write **and** query permission on every affected table. Publish status shows on the table: `table get`/`table list` carry `is_published` (`collection_id` under `--full`). Good candidates are finished, analysis-ready tables — clean/combine via transforms first, then publish the polished result. Publishing does not put the Data collection in the git-sync scope: on a remote-sync instance, `mb git-sync add-collection <data-collection-id>` is what makes exports carry the published tables' metadata (see the `git-sync` skill).
+<!-- /requires -->
 - **query / uuid.** `mb query` is the ad-hoc MBQL surface (`--print-schema` → `--dry-run` → run); `mb uuid --count <n>` mints the `lib/uuid` values MBQL clauses need. Both live in `mbql`.
 
 ## Specialized skills (load on demand)
@@ -155,12 +162,16 @@ This file is enough for any single-command task. For anything deeper, load the r
 - **`dashboard`** — building interactive dashboards: wiring filters (parameters + mappings), linked/cascading filters, cross-filtering, click behavior, series, and tabs. Load beyond a plain card-layout task.
 - **`metadata`** — setting field/table metadata: semantic types, foreign-key targets, dropdown/scan behavior, and column visibility, and the downstream features each unlocks. Load when editing what a column _means_, not its data.
 - **`notification`** — scheduled delivery: question alerts (`mb alert`) and dashboard subscriptions (`mb subscription`). Choosing between them, the two schedule/recipient contracts, channel prerequisites, testing a send.
+<!-- requires: transforms -->
 - **`transform`** — transform body JSON, create + run-with-wait, run inspection, tags, jobs.
+<!-- /requires -->
 - **`document`** — Metabase documents (TipTap body, embedding cards).
+<!-- requires: remoteSync -->
 - **`git-sync`** — round-tripping content to/from a git remote.
+<!-- /requires -->
 - **`data-workflow`** — the guided, end-to-end data workflow: investigate raw data, build clean analysis-ready tables, define reusable segments/measures/metrics, answer questions, build dashboards. **Start here when the user states a goal rather than a single verb** — "make sense of my data", "build a data model", "go from raw data to a dashboard", "be my data analyst", "set up analytics for X". It detects where the data is and routes to the right stage.
 
-If a task spans more than one, load each. `mb skills list` enumerates everything on the installed version.
+If a task spans more than one, load each. `mb skills list` enumerates the skills the profile's server can use, and `mb skills get` prints a skill with the sections that server cannot use left out; `--all` shows everything.
 
 ## Don't
 

package/skill-data/dashboard/SKILL.md

@@ -8,7 +8,7 @@ allowed-tools: Read, Write, Edit, Bash, AskUserQuestion
 
 A dashboard starts as cards on a grid; it becomes an **app** when filters drive the cards, charts cross-filter each other, and clicks navigate. This skill owns both: the grid layout and the interactive layer.
 
-**`core` owns the transport mechanics** — the whole-array replace semantics (editing `dashcards` or `parameters` replaces the entire set; omitted entries are deleted; new cards use negative ids), `update-dashcard` for a single safe patch vs. `update --body` for a full replace, and the `parameter-values` verb. Read it first (`mb skills get core`). **`visualization`** owns each card's chart and the full `click_behavior` key catalog.
+**`core` owns the transport mechanics** — the whole-array replace semantics (editing `dashcards` or `parameters` replaces the entire set; omitted entries are deleted; every dashcard carries `card_id`, with `null` for virtual cards; new cards use negative ids), `update-dashcard` for a single safe patch vs. `update --body` for a full replace, and the `parameter-values` verb. Read it first (`mb skills get core`). **`visualization`** owns each card's chart and the full `click_behavior` key catalog.
 
 Inspect before you wire: `mb dashboard get <id> --json` hydrates `parameters`, `dashcards`, and `tabs`; `mb dashboard cards <id>` lists just the dashcards.
 
@@ -123,7 +123,7 @@ Set the **driver** chart's whole-card click behavior to `crossfilter`, mapping t
 - **Auto-connect / the missing map:** a filter that "does nothing" or "won't show" is almost always unmapped, or mapped only to cards on another tab.
 - **Time-grouping parameters** (`temporal-unit`) bind only to a datetime column in the query's **last** stage — add one after a time-bucketed summary and it can't attach.
 - **Required + default:** a `required: true` parameter with no `default` blocks its cards until a value is chosen; give it a `default` for expensive queries you don't want running unfiltered.
-- **Whole-array replace:** never send a partial `parameters`/`dashcards` array to `update` — you'll delete what you omit. Use `update-dashcard` for a single-card change.
+- **Whole-array replace:** never send a partial `parameters`/`dashcards` array to `update` — you'll delete what you omit. Include `card_id` on every dashcard (`null` for virtual cards). Use `update-dashcard` for a single-card change.
 
 ## Don't