@metabase/cli 0.1.16 → 0.1.18

package/README.md

@@ -629,6 +629,27 @@ mb dashboard cards 1
 mb dashboard cards 1 --json
 ```
 
+#### Dashboard parameters (filters)
+
+A dashboard's `parameters` are its filter widgets. They're typed (`Parameter` schema): an invalid `type` is rejected at the CLI boundary with a message that echoes the full allowed enum (`string/=`, `string/contains`, `number/between`, `date/range`, `category`, `id`, `temporal-unit`, …).
+
+Read them off the dashboard with `mb dashboard get <id> --fields parameters --json` (or `--full` for the whole record). There is no separate read verb — they're part of the dashboard.
+
+Editing replaces the **whole** `parameters` array, so it's a read-modify-write loop: read the current set, modify it, and send it all back via `mb dashboard create`/`mb dashboard update --body '{"parameters":[…]}'`; omitting a parameter deletes it. Each parameter's `id` is a descriptive string you choose (reuse the `slug`, e.g. `order_status`), unique within the dashboard — Metabase stores any non-blank string as-is, so there is no need to generate a random id (use `mb uuid` only if you genuinely want an opaque one). Bind a parameter to a card column through a dashcard's `parameter_mappings`, whose `parameter_id` must match a parameter `id` exactly.
+
+### `mb dashboard parameter-values <dashboard-id> <parameter-id>`
+
+Fetch the selectable values for one dashboard parameter (`{values, has_more_values}`). Values come from the parameter's static list, its source card, or — for a parameter mapped to a field — the field's live distinct values (chain-filtered).
+
+```sh
+mb dashboard parameter-values 1 order_status --json
+mb dashboard parameter-values 1 order_status --query Cam --json
+```
+
+| Flag               | Description                                                                            |
+| ------------------ | -------------------------------------------------------------------------------------- |
+| `--query <substr>` | Case-insensitive substring search (first 1000 matches) instead of the full value list. |
+
 ### `mb dashboard create`
 
 The body accepts the same dashboard-level fields as the underlying `POST /api/dashboard` (`name`, `description`, `parameters`, `cache_ttl`, `collection_id`, `collection_position`). It also accepts optional `dashcards` and `tabs`: when either is present, the CLI chains a `PUT /api/dashboard/:id` after the create and returns the updated dashboard with its dashcards/tabs applied. Use a negative `id` on a dashcard to indicate one the server should newly create.

package/dist/{add-collection-H4LcP-9B.mjs → add-collection-CRZAFCZy.mjs}

@@ -1,8 +1,8 @@
-import { connectionFlags, outputFlags, profileFlag } from "./error-CIObEXLY.mjs";
-import { defineMetabaseCommand } from "./runtime-CmAIahm5.mjs";
-import { renderSummary } from "./capabilities-BX1rnVuH.mjs";
-import { parseId } from "./parse-id-B5adfBlS.mjs";
-import { REMOTE_SYNC_PATHS } from "./poll-task-B00Qwd87.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-BaBm-UrT.mjs";
+import { defineMetabaseCommand } from "./runtime-oxjmrYoP.mjs";
+import { renderSummary } from "./capabilities-N0jo5U7S.mjs";
+import { parseId } from "./parse-id-DlXnOcmP.mjs";
+import { REMOTE_SYNC_PATHS } from "./poll-task-NQNLT_aA.mjs";
 import { z } from "zod";
 
 //#region src/commands/git-sync/add-collection.ts

package/dist/add-collection-DbalcC3_.mjs

@@ -0,0 +1,11 @@
+import "./notice-DyVl5aYB.mjs";
+import "./error-BaBm-UrT.mjs";
+import "./command-augment-DdZIfx1V.mjs";
+import "./runtime-oxjmrYoP.mjs";
+import "./capabilities-N0jo5U7S.mjs";
+import "./parse-id-DlXnOcmP.mjs";
+import "./poll-hgnrHBoh.mjs";
+import "./poll-task-NQNLT_aA.mjs";
+import { SyncSettingsUpdateResult, add_collection_default, setCollectionRemoteSynced, syncSettingsUpdateView } from "./add-collection-CRZAFCZy.mjs";
+
+export { add_collection_default as default };

package/dist/{archive-D1mfiftv.mjs → archive-3mEhK9_H.mjs}

@@ -1,10 +1,11 @@
-import "./command-augment-CAur0XOQ.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-CIObEXLY.mjs";
-import { defineMetabaseCommand } from "./runtime-CmAIahm5.mjs";
-import { renderSummary } from "./capabilities-BX1rnVuH.mjs";
-import { parseId } from "./parse-id-B5adfBlS.mjs";
-import { revisionMessageFlag } from "./revision-message-flag-CP5NFrWQ.mjs";
-import { Segment, segmentView } from "./segment-BAUuELKs.mjs";
+import "./notice-DyVl5aYB.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-BaBm-UrT.mjs";
+import "./command-augment-DdZIfx1V.mjs";
+import { defineMetabaseCommand } from "./runtime-oxjmrYoP.mjs";
+import { renderSummary } from "./capabilities-N0jo5U7S.mjs";
+import { parseId } from "./parse-id-DlXnOcmP.mjs";
+import { revisionMessageFlag } from "./revision-message-flag-CHrJgFFx.mjs";
+import { Segment, segmentView } from "./segment-TXktTCfU.mjs";
 
 //#region src/commands/segment/archive.ts
 var archive_default = defineMetabaseCommand({

package/dist/{archive-C6MDtV1F.mjs → archive-C3RWdM-2.mjs}

@@ -1,9 +1,11 @@
-import "./command-augment-CAur0XOQ.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-CIObEXLY.mjs";
-import { defineMetabaseCommand } from "./runtime-CmAIahm5.mjs";
-import { renderSummary } from "./capabilities-BX1rnVuH.mjs";
-import { parseId } from "./parse-id-B5adfBlS.mjs";
-import { Dashboard, dashboardView } from "./dashboard-B4bn3z6t.mjs";
+import "./notice-DyVl5aYB.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-BaBm-UrT.mjs";
+import "./command-augment-DdZIfx1V.mjs";
+import { defineMetabaseCommand } from "./runtime-oxjmrYoP.mjs";
+import { renderSummary } from "./capabilities-N0jo5U7S.mjs";
+import "./parameter-CiJ4CwWE.mjs";
+import { parseId } from "./parse-id-DlXnOcmP.mjs";
+import { Dashboard, dashboardView } from "./dashboard-DOplbKyQ.mjs";
 
 //#region src/commands/dashboard/archive.ts
 var archive_default = defineMetabaseCommand({

package/dist/{archive-CQQWkC5S.mjs → archive-CFHYRF65.mjs}

@@ -1,9 +1,10 @@
-import "./command-augment-CAur0XOQ.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-CIObEXLY.mjs";
-import { defineMetabaseCommand } from "./runtime-CmAIahm5.mjs";
-import { renderSummary } from "./capabilities-BX1rnVuH.mjs";
-import { parseId } from "./parse-id-B5adfBlS.mjs";
-import { Snippet, snippetView } from "./snippet-D4SyVLKB.mjs";
+import "./notice-DyVl5aYB.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-BaBm-UrT.mjs";
+import "./command-augment-DdZIfx1V.mjs";
+import { defineMetabaseCommand } from "./runtime-oxjmrYoP.mjs";
+import { renderSummary } from "./capabilities-N0jo5U7S.mjs";
+import { parseId } from "./parse-id-DlXnOcmP.mjs";
+import { Snippet, snippetView } from "./snippet-CtA2Pkoa.mjs";
 
 //#region src/commands/snippet/archive.ts
 var archive_default = defineMetabaseCommand({

package/dist/{archive-hN8PfvhX.mjs → archive-De4yVEV8.mjs}

@@ -1,9 +1,10 @@
-import "./command-augment-CAur0XOQ.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-CIObEXLY.mjs";
-import { defineMetabaseCommand } from "./runtime-CmAIahm5.mjs";
-import { renderSummary } from "./capabilities-BX1rnVuH.mjs";
-import { parseId } from "./parse-id-B5adfBlS.mjs";
-import { Collection, collectionView } from "./collection-Deiziuu2.mjs";
+import "./notice-DyVl5aYB.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-BaBm-UrT.mjs";
+import "./command-augment-DdZIfx1V.mjs";
+import { defineMetabaseCommand } from "./runtime-oxjmrYoP.mjs";
+import { renderSummary } from "./capabilities-N0jo5U7S.mjs";
+import { parseId } from "./parse-id-DlXnOcmP.mjs";
+import { Collection, collectionView } from "./collection-DrLpA1SO.mjs";
 
 //#region src/commands/collection/archive.ts
 var archive_default = defineMetabaseCommand({

package/dist/{archive-BCXoM1nX.mjs → archive-Z8ZM-ilB.mjs}

@@ -1,10 +1,12 @@
-import "./command-augment-CAur0XOQ.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-CIObEXLY.mjs";
-import { defineMetabaseCommand } from "./runtime-CmAIahm5.mjs";
-import { renderSummary } from "./capabilities-BX1rnVuH.mjs";
-import "./field-E0IBy4Uw.mjs";
-import { Card, cardView } from "./card-wCPcuKSi.mjs";
-import { parseId } from "./parse-id-B5adfBlS.mjs";
+import "./notice-DyVl5aYB.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-BaBm-UrT.mjs";
+import "./command-augment-DdZIfx1V.mjs";
+import { defineMetabaseCommand } from "./runtime-oxjmrYoP.mjs";
+import { renderSummary } from "./capabilities-N0jo5U7S.mjs";
+import "./field-CMY_LWUe.mjs";
+import "./parameter-CiJ4CwWE.mjs";
+import { Card, cardView } from "./card-DEmcRlNO.mjs";
+import { parseId } from "./parse-id-DlXnOcmP.mjs";
 
 //#region src/commands/card/archive.ts
 var archive_default = defineMetabaseCommand({

package/dist/{archive-CdUS-OG9.mjs → archive-d74nDcp4.mjs}

@@ -1,9 +1,10 @@
-import "./command-augment-CAur0XOQ.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-CIObEXLY.mjs";
-import { defineMetabaseCommand } from "./runtime-CmAIahm5.mjs";
-import { renderSummary } from "./capabilities-BX1rnVuH.mjs";
-import { parseId } from "./parse-id-B5adfBlS.mjs";
-import { Document, documentView } from "./document-qfwR0r63.mjs";
+import "./notice-DyVl5aYB.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-BaBm-UrT.mjs";
+import "./command-augment-DdZIfx1V.mjs";
+import { defineMetabaseCommand } from "./runtime-oxjmrYoP.mjs";
+import { renderSummary } from "./capabilities-N0jo5U7S.mjs";
+import { parseId } from "./parse-id-DlXnOcmP.mjs";
+import { Document, documentView } from "./document-1W7NRaO_.mjs";
 
 //#region src/commands/document/archive.ts
 var archive_default = defineMetabaseCommand({

package/dist/{archive-B3cjzOIK.mjs → archive-errg-EKw.mjs}

@@ -1,10 +1,11 @@
-import "./command-augment-CAur0XOQ.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-CIObEXLY.mjs";
-import { defineMetabaseCommand } from "./runtime-CmAIahm5.mjs";
-import { renderSummary } from "./capabilities-BX1rnVuH.mjs";
-import { parseId } from "./parse-id-B5adfBlS.mjs";
-import { Measure, measureView } from "./measure-BCv5wDDN.mjs";
-import { revisionMessageFlag } from "./revision-message-flag-CP5NFrWQ.mjs";
+import "./notice-DyVl5aYB.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-BaBm-UrT.mjs";
+import "./command-augment-DdZIfx1V.mjs";
+import { defineMetabaseCommand } from "./runtime-oxjmrYoP.mjs";
+import { renderSummary } from "./capabilities-N0jo5U7S.mjs";
+import { parseId } from "./parse-id-DlXnOcmP.mjs";
+import { Measure, measureView } from "./measure-DoJvtCaA.mjs";
+import { revisionMessageFlag } from "./revision-message-flag-CHrJgFFx.mjs";
 
 //#region src/commands/measure/archive.ts
 var archive_default = defineMetabaseCommand({

package/dist/auth--PWX0oj5.mjs

@@ -0,0 +1,22 @@
+import "./command-augment-DdZIfx1V.mjs";
+import { defineCommandGroup } from "./group-BNE_RiH5.mjs";
+
+//#region src/commands/auth/index.ts
+var auth_default = defineCommandGroup({
+	name: "auth",
+	description: "Authenticate against a Metabase instance",
+	defaultCommand: "login",
+	skills: [{
+		skill: "core",
+		purpose: "authentication and named profiles"
+	}],
+	subCommands: {
+		login: () => import("./login-C6ZAnGHz.mjs").then((m) => m.default),
+		status: () => import("./status-C_7aqTvB.mjs").then((m) => m.default),
+		list: () => import("./list-CjF12k1G.mjs").then((m) => m.default),
+		logout: () => import("./logout-CWjyY3Y8.mjs").then((m) => m.default)
+	}
+});
+
+//#endregion
+export { auth_default as default };

package/dist/{body-DB2upz6a.mjs → body-BS2s2zDl.mjs}

@@ -1,6 +1,6 @@
-import { ConfigError } from "./command-augment-CAur0XOQ.mjs";
-import { parseJson } from "./runtime-CmAIahm5.mjs";
-import { DEFAULT_FLAG_NAME, readInput } from "./input-BXWgdKiS.mjs";
+import { ConfigError } from "./notice-DyVl5aYB.mjs";
+import { parseJson } from "./runtime-oxjmrYoP.mjs";
+import { DEFAULT_FLAG_NAME, readInput } from "./input-7Sj85_K7.mjs";
 
 //#region src/runtime/body.ts
 async function readBody(sources, schema) {

package/dist/{branches-B6R60Vr1.mjs → branches-mcyT7wI-.mjs}

@@ -1,9 +1,10 @@
-import "./command-augment-CAur0XOQ.mjs";
-import { connectionFlags, listEnvelopeSchema, outputFlags, profileFlag, wrapList } from "./error-CIObEXLY.mjs";
-import { defineMetabaseCommand } from "./runtime-CmAIahm5.mjs";
-import { renderList } from "./capabilities-BX1rnVuH.mjs";
-import "./poll-AduuU55-.mjs";
-import { REMOTE_SYNC_PATHS } from "./poll-task-B00Qwd87.mjs";
+import "./notice-DyVl5aYB.mjs";
+import { connectionFlags, listEnvelopeSchema, outputFlags, profileFlag, wrapList } from "./error-BaBm-UrT.mjs";
+import "./command-augment-DdZIfx1V.mjs";
+import { defineMetabaseCommand } from "./runtime-oxjmrYoP.mjs";
+import { renderList } from "./capabilities-N0jo5U7S.mjs";
+import "./poll-hgnrHBoh.mjs";
+import { REMOTE_SYNC_PATHS } from "./poll-task-NQNLT_aA.mjs";
 import { z } from "zod";
 
 //#region src/commands/git-sync/branches.ts

package/dist/{cancel-oPsWomYc.mjs → cancel-B2l-i2NS.mjs}

@@ -1,8 +1,9 @@
-import "./command-augment-CAur0XOQ.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-CIObEXLY.mjs";
-import { defineMetabaseCommand } from "./runtime-CmAIahm5.mjs";
-import { renderSummary } from "./capabilities-BX1rnVuH.mjs";
-import { parseId } from "./parse-id-B5adfBlS.mjs";
+import "./notice-DyVl5aYB.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-BaBm-UrT.mjs";
+import "./command-augment-DdZIfx1V.mjs";
+import { defineMetabaseCommand } from "./runtime-oxjmrYoP.mjs";
+import { renderSummary } from "./capabilities-N0jo5U7S.mjs";
+import { parseId } from "./parse-id-DlXnOcmP.mjs";
 import { z } from "zod";
 
 //#region src/commands/transform/cancel.ts

package/dist/{cancel-task-CleJVDNI.mjs → cancel-task-CugcIeIi.mjs}

@@ -1,9 +1,10 @@
-import "./command-augment-CAur0XOQ.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-CIObEXLY.mjs";
-import { defineMetabaseCommand } from "./runtime-CmAIahm5.mjs";
-import { renderSummary } from "./capabilities-BX1rnVuH.mjs";
-import "./poll-AduuU55-.mjs";
-import { REMOTE_SYNC_PATHS, SyncTask, syncTaskView } from "./poll-task-B00Qwd87.mjs";
+import "./notice-DyVl5aYB.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-BaBm-UrT.mjs";
+import "./command-augment-DdZIfx1V.mjs";
+import { defineMetabaseCommand } from "./runtime-oxjmrYoP.mjs";
+import { renderSummary } from "./capabilities-N0jo5U7S.mjs";
+import "./poll-hgnrHBoh.mjs";
+import { REMOTE_SYNC_PATHS, SyncTask, syncTaskView } from "./poll-task-NQNLT_aA.mjs";
 
 //#region src/commands/git-sync/cancel-task.ts
 var cancel_task_default = defineMetabaseCommand({

package/dist/{capabilities-BX1rnVuH.mjs → capabilities-N0jo5U7S.mjs}

@@ -1,4 +1,4 @@
-import { ConfigError, itemOversizeMessage, listTruncationNotice, warn } from "./command-augment-CAur0XOQ.mjs";
+import { ConfigError, itemOversizeMessage, listTruncationNotice, warn } from "./notice-DyVl5aYB.mjs";
 import { z } from "zod";
 import Table from "cli-table3";
 

package/dist/card-D07WYCQY.mjs

@@ -0,0 +1,26 @@
+import "./command-augment-DdZIfx1V.mjs";
+import { defineCommandGroup } from "./group-BNE_RiH5.mjs";
+
+//#region src/commands/card/index.ts
+var card_default = defineCommandGroup({
+	name: "card",
+	description: "Manage Metabase cards (questions, models, metrics)",
+	skills: [{
+		skill: "mbql",
+		purpose: "author the dataset_query"
+	}, {
+		skill: "visualization",
+		purpose: "choose display and visualization_settings"
+	}],
+	subCommands: {
+		list: () => import("./list-D-rgDFa5.mjs").then((mod) => mod.default),
+		get: () => import("./get-Dz7fcqoG.mjs").then((mod) => mod.default),
+		query: () => import("./query-BQfgKV68.mjs").then((mod) => mod.default),
+		create: () => import("./create-DhrftYre.mjs").then((mod) => mod.default),
+		update: () => import("./update-CrRz47aj.mjs").then((mod) => mod.default),
+		archive: () => import("./archive-Z8ZM-ilB.mjs").then((mod) => mod.default)
+	}
+});
+
+//#endregion
+export { card_default as default };

package/dist/{card-wCPcuKSi.mjs → card-DEmcRlNO.mjs}

@@ -1,4 +1,5 @@
-import { FieldBaseType, FieldSemanticType } from "./field-E0IBy4Uw.mjs";
+import { FieldBaseType, FieldSemanticType } from "./field-CMY_LWUe.mjs";
+import { Parameter, ParameterMapping } from "./parameter-CiJ4CwWE.mjs";
 import { z } from "zod";
 
 //#region src/domain/card.ts
@@ -79,8 +80,8 @@ const CardCreateInput = z.object({
 	collection_id: z.number().int().positive().nullable().optional(),
 	collection_position: z.number().int().positive().nullable().optional(),
 	dashboard_id: z.number().int().positive().nullable().optional(),
-	parameters: z.array(z.unknown()).optional(),
-	parameter_mappings: z.array(z.unknown()).optional()
+	parameters: z.array(Parameter).optional(),
+	parameter_mappings: z.array(ParameterMapping).optional()
 }).loose();
 const CardUpdateInput = z.object({
 	name: z.string().min(1).optional(),
@@ -99,8 +100,8 @@ const CardUpdateInput = z.object({
 	cache_ttl: z.number().int().positive().nullable().optional(),
 	dashboard_id: z.number().int().positive().nullable().optional(),
 	dashboard_tab_id: z.number().int().positive().nullable().optional(),
-	parameters: z.array(z.unknown()).optional(),
-	parameter_mappings: z.array(z.unknown()).optional(),
+	parameters: z.array(Parameter).optional(),
+	parameter_mappings: z.array(ParameterMapping).optional(),
 	result_metadata: z.array(z.unknown()).nullable().optional()
 }).loose();
 const QueryColumn = z.object({

package/dist/{cards-Bw37jizL.mjs → cards-BGkz5BeZ.mjs}

@@ -1,9 +1,11 @@
-import "./command-augment-CAur0XOQ.mjs";
-import { connectionFlags, listEnvelopeSchema, outputFlags, profileFlag, wrapList } from "./error-CIObEXLY.mjs";
-import { defineMetabaseCommand } from "./runtime-CmAIahm5.mjs";
-import { renderList } from "./capabilities-BX1rnVuH.mjs";
-import { parseId } from "./parse-id-B5adfBlS.mjs";
-import { DashboardDetail, DashcardCompact, dashcardView } from "./dashboard-B4bn3z6t.mjs";
+import "./notice-DyVl5aYB.mjs";
+import { connectionFlags, listEnvelopeSchema, outputFlags, profileFlag, wrapList } from "./error-BaBm-UrT.mjs";
+import "./command-augment-DdZIfx1V.mjs";
+import { defineMetabaseCommand } from "./runtime-oxjmrYoP.mjs";
+import { renderList } from "./capabilities-N0jo5U7S.mjs";
+import "./parameter-CiJ4CwWE.mjs";
+import { parseId } from "./parse-id-DlXnOcmP.mjs";
+import { DashboardDetail, DashcardCompact, dashcardView } from "./dashboard-DOplbKyQ.mjs";
 
 //#region src/commands/dashboard/cards.ts
 const DashcardListEnvelope = listEnvelopeSchema(DashcardCompact);

package/dist/cli.mjs

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
-import { ConfigError, flagConsumesValue, getMetabaseAugment, normalizeFlag, resolveCitty, toAliasArray } from "./command-augment-CAur0XOQ.mjs";
-import { connectionFlags, outputFlags, package_default, profileFlag, reportError } from "./error-CIObEXLY.mjs";
+import { ConfigError, flagConsumesValue, normalizeFlag, resolveCitty, toAliasArray } from "./notice-DyVl5aYB.mjs";
+import { connectionFlags, outputFlags, package_default, profileFlag, reportError } from "./error-BaBm-UrT.mjs";
+import { getMetabaseAugment, setMetabaseAugment } from "./command-augment-DdZIfx1V.mjs";
 import { defineCommand, renderUsage, runMain } from "citty";
 
 //#region src/commands/global-flags.ts
@@ -58,33 +59,46 @@ const main = defineCommand({
 		description: package_default.description
 	},
 	subCommands: {
-		auth: () => import("./auth-BaCMFLTA.mjs").then((mod) => mod.default),
-		db: () => import("./db-Btfl5JMZ.mjs").then((mod) => mod.default),
-		table: () => import("./table-B35ovbcd.mjs").then((mod) => mod.default),
-		field: () => import("./field-BTbzlcyC.mjs").then((mod) => mod.default),
-		card: () => import("./card-DzH3aK0a.mjs").then((mod) => mod.default),
-		dashboard: () => import("./dashboard-OUgS1Gi-.mjs").then((mod) => mod.default),
-		collection: () => import("./collection-Wagz-ira.mjs").then((mod) => mod.default),
-		library: () => import("./library-BlbH0xyK.mjs").then((mod) => mod.default),
-		document: () => import("./document-CU28GfFw.mjs").then((mod) => mod.default),
-		transform: () => import("./transform-DF79sJ0_.mjs").then((mod) => mod.default),
-		"transform-job": () => import("./transform-job-PmA_D8gz.mjs").then((mod) => mod.default),
-		"transform-tag": () => import("./transform-tag-CE3cuO1K.mjs").then((mod) => mod.default),
-		setting: () => import("./setting-C50HEiGG.mjs").then((mod) => mod.default),
-		search: () => import("./search-C_uw_D1U.mjs").then((mod) => mod.default),
-		"git-sync": () => import("./git-sync-CBxS2urR.mjs").then((mod) => mod.default),
-		setup: () => import("./setup-CYrbNrlG.mjs").then((mod) => mod.default),
-		snippet: () => import("./snippet-BjaWAxCu.mjs").then((mod) => mod.default),
-		segment: () => import("./segment-CkZUZcWz.mjs").then((mod) => mod.default),
-		measure: () => import("./measure-BUedPu4K.mjs").then((mod) => mod.default),
-		eid: () => import("./eid-BeXI-eII.mjs").then((mod) => mod.default),
-		query: () => import("./query-Dvi-Rksy.mjs").then((mod) => mod.default),
-		uuid: () => import("./uuid---pAboNQ.mjs").then((mod) => mod.default),
-		upgrade: () => import("./upgrade-4cWfLu90.mjs").then((mod) => mod.default),
-		skills: () => import("./skills-D6xQkmhu.mjs").then((mod) => mod.default),
-		__manifest: () => import("./manifest-B2F8iL7X.mjs").then((mod) => mod.createManifestCommand(main))
+		auth: () => import("./auth--PWX0oj5.mjs").then((mod) => mod.default),
+		db: () => import("./db-BCAURQei.mjs").then((mod) => mod.default),
+		table: () => import("./table-BwGOz97O.mjs").then((mod) => mod.default),
+		field: () => import("./field-CloFa1oe.mjs").then((mod) => mod.default),
+		card: () => import("./card-D07WYCQY.mjs").then((mod) => mod.default),
+		dashboard: () => import("./dashboard-Crh4v6Fq.mjs").then((mod) => mod.default),
+		collection: () => import("./collection-Dss2qSEF.mjs").then((mod) => mod.default),
+		library: () => import("./library-1AAVbk-K.mjs").then((mod) => mod.default),
+		document: () => import("./document-upxL2nKH.mjs").then((mod) => mod.default),
+		transform: () => import("./transform-B65ZD9-e.mjs").then((mod) => mod.default),
+		"transform-job": () => import("./transform-job-BWVKXSV6.mjs").then((mod) => mod.default),
+		"transform-tag": () => import("./transform-tag-C4qvmicL.mjs").then((mod) => mod.default),
+		setting: () => import("./setting-BbdKR-lO.mjs").then((mod) => mod.default),
+		search: () => import("./search-Vo-BqliA.mjs").then((mod) => mod.default),
+		"git-sync": () => import("./git-sync-C9m-OHac.mjs").then((mod) => mod.default),
+		setup: () => import("./setup-CzYFvFK5.mjs").then((mod) => mod.default),
+		snippet: () => import("./snippet-Bzo2U9Fv.mjs").then((mod) => mod.default),
+		segment: () => import("./segment-BuN_IoM8.mjs").then((mod) => mod.default),
+		measure: () => import("./measure-Cbly1r0E.mjs").then((mod) => mod.default),
+		eid: () => import("./eid-BCuJRv7a.mjs").then((mod) => mod.default),
+		query: () => import("./query-DSKQZu91.mjs").then((mod) => mod.default),
+		uuid: () => import("./uuid-ByJmWV7b.mjs").then((mod) => mod.default),
+		upgrade: () => import("./upgrade-DsXlfPef.mjs").then((mod) => mod.default),
+		skills: () => import("./skills-CR2xyV33.mjs").then((mod) => mod.default),
+		__manifest: () => import("./manifest-BVf8P4bl.mjs").then((mod) => mod.createManifestCommand(main))
 	}
 });
+setMetabaseAugment(main, {
+	examples: [],
+	details: null,
+	skills: [{
+		skill: "core",
+		purpose: "auth, conventions, and per-resource footguns"
+	}, {
+		skill: "data-workflow",
+		purpose: "guided end-to-end: raw data → clean tables → metrics → answers → dashboards"
+	}],
+	outputSchema: null,
+	capabilities: null
+});
 var main_default = main;
 
 //#endregion
@@ -103,6 +117,8 @@ const CLI_NAME = "mb";
 const HELP_FLAG_SPEC = "-h, --help";
 const HELP_FLAG_DESCRIPTION = "Show help for this command";
 const GETTING_STARTED_HINT = `First time? Run \`${CLI_NAME} auth login\` to connect to a Metabase instance.`;
+const SKILLS_HEADER = "AGENT SKILLS";
+const SKILLS_LIST_ITEM = `${CLI_NAME} skills list — every bundled skill`;
 async function showUsage(cmd, parent, breadcrumb) {
 	const raw = (await renderUsage(cmd, parent)).replace(ANSI_PATTERN, "");
 	const lines = raw.split("\n").map((line) => line.replace(TRAILING_WHITESPACE, ""));
@@ -115,6 +131,7 @@ async function showUsage(cmd, parent, breadcrumb) {
 	const augment = getMetabaseAugment(cmd);
 	const details = augment?.details ?? null;
 	const examples = augment?.examples ?? [];
+	const skills = augment?.skills ?? [];
 	const transformed = transformBody(lines, {
 		cittyName,
 		breadcrumb: breadcrumb ?? cittyName,
@@ -123,6 +140,7 @@ async function showUsage(cmd, parent, breadcrumb) {
 	const body = withDetails(transformed, details).join("\n").trimEnd();
 	const sections = [body];
 	if (examples.length > 0) sections.push(renderExamples(examples));
+	if (skills.length > 0) sections.push(renderSkillsSection(skills, isRoot));
 	if (isRoot) sections.push(GETTING_STARTED_HINT);
 	process.stdout.write(sections.join("\n\n") + "\n");
 }
@@ -174,6 +192,15 @@ function optionLayout(row) {
 		descStart: flagEnd + gapRemainder
 	};
 }
+function renderSkillsSection(skills, includeListPointer) {
+	const items = skills.map((p) => `${LINE_PREFIX}mb skills get ${p.skill} — ${p.purpose}`);
+	if (includeListPointer) items.push(`${LINE_PREFIX}${SKILLS_LIST_ITEM}`);
+	return [
+		SKILLS_HEADER,
+		"",
+		...items
+	].join("\n");
+}
 function withDetails(lines, details) {
 	if (details === null) return lines;
 	const [first, ...rest] = lines;

package/dist/collection-Dss2qSEF.mjs

@@ -0,0 +1,23 @@
+import "./command-augment-DdZIfx1V.mjs";
+import { defineCommandGroup } from "./group-BNE_RiH5.mjs";
+
+//#region src/commands/collection/index.ts
+var collection_default = defineCommandGroup({
+	name: "collection",
+	description: "Manage Metabase collections",
+	skills: [{
+		skill: "core",
+		purpose: "collection ref forms and the transforms namespace"
+	}],
+	subCommands: {
+		list: () => import("./list-CK0p7vvK.mjs").then((mod) => mod.default),
+		get: () => import("./get-D7QMqPOK.mjs").then((mod) => mod.default),
+		items: () => import("./items-CkFEy2Du.mjs").then((mod) => mod.default),
+		tree: () => import("./tree-YvmwGql7.mjs").then((mod) => mod.default),
+		create: () => import("./create-D8KA4zJA.mjs").then((mod) => mod.default),
+		archive: () => import("./archive-De4yVEV8.mjs").then((mod) => mod.default)
+	}
+});
+
+//#endregion
+export { collection_default as default };

package/dist/{collection-namespace-CUDPh2rF.mjs → collection-namespace-BP_LJrAD.mjs}

@@ -1,5 +1,5 @@
-import { ConfigError } from "./command-augment-CAur0XOQ.mjs";
-import { HttpError } from "./runtime-CmAIahm5.mjs";
+import { ConfigError } from "./notice-DyVl5aYB.mjs";
+import { HttpError } from "./runtime-oxjmrYoP.mjs";
 
 //#region src/commands/transform/collection-namespace.ts
 const TRANSFORMS_NAMESPACE_HINT = "transforms can only be filed in a :transforms-namespace collection. Create one with `mb collection create --body '{\"name\":\"…\"}' --namespace transforms` and pass its id as collection_id, or omit collection_id to leave the transform uncollected.";

package/dist/command-augment-DdZIfx1V.mjs

@@ -0,0 +1,11 @@
+//#region src/runtime/command-augment.ts
+const augments = new WeakMap();
+function setMetabaseAugment(cmd, augment) {
+	augments.set(cmd, augment);
+}
+function getMetabaseAugment(cmd) {
+	return augments.get(cmd) ?? null;
+}
+
+//#endregion
+export { getMetabaseAugment, setMetabaseAugment };

package/dist/{create-Bj6PuaAW.mjs → create-B4HAEEE0.mjs}

@@ -1,11 +1,12 @@
-import "./command-augment-CAur0XOQ.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-CIObEXLY.mjs";
-import { defineMetabaseCommand } from "./runtime-CmAIahm5.mjs";
-import { renderSummary } from "./capabilities-BX1rnVuH.mjs";
-import "./input-BXWgdKiS.mjs";
-import { readBody } from "./body-DB2upz6a.mjs";
-import { bodyInputFlags } from "./body-flags-D7q87Btw.mjs";
-import { TransformTag, TransformTagCreateInput, transformTagView } from "./transform-tag-wFiWmiyO.mjs";
+import "./notice-DyVl5aYB.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-BaBm-UrT.mjs";
+import "./command-augment-DdZIfx1V.mjs";
+import { defineMetabaseCommand } from "./runtime-oxjmrYoP.mjs";
+import { renderSummary } from "./capabilities-N0jo5U7S.mjs";
+import "./input-7Sj85_K7.mjs";
+import { readBody } from "./body-BS2s2zDl.mjs";
+import { bodyInputFlags } from "./body-flags-DWTTxJpP.mjs";
+import { TransformTag, TransformTagCreateInput, transformTagView } from "./transform-tag-rsIrckCM.mjs";
 
 //#region src/commands/transform-tag/create.ts
 var create_default = defineMetabaseCommand({

package/dist/{create-BEkuqChu.mjs → create-BOmmMSjF.mjs}

@@ -1,13 +1,14 @@
-import "./command-augment-CAur0XOQ.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-CIObEXLY.mjs";
-import { defineMetabaseCommand } from "./runtime-CmAIahm5.mjs";
-import { renderSummary } from "./capabilities-BX1rnVuH.mjs";
-import "./input-BXWgdKiS.mjs";
-import { readBody } from "./body-DB2upz6a.mjs";
-import { bodyInputFlags } from "./body-flags-D7q87Btw.mjs";
-import "./validate-VawhJ5Sc.mjs";
-import { MEASURE_DEFINITION_LABELS, preflightMbql5Query, skipValidateFlag } from "./validate-query-CSV-TTnd.mjs";
-import { Measure, MeasureCreateInput, measureView } from "./measure-BCv5wDDN.mjs";
+import "./notice-DyVl5aYB.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-BaBm-UrT.mjs";
+import "./command-augment-DdZIfx1V.mjs";
+import { defineMetabaseCommand } from "./runtime-oxjmrYoP.mjs";
+import { renderSummary } from "./capabilities-N0jo5U7S.mjs";
+import "./input-7Sj85_K7.mjs";
+import { readBody } from "./body-BS2s2zDl.mjs";
+import { bodyInputFlags } from "./body-flags-DWTTxJpP.mjs";
+import "./validate-BqNW4Sk1.mjs";
+import { MEASURE_DEFINITION_LABELS, preflightMbql5Query, skipValidateFlag } from "./validate-query-CcZVKYPV.mjs";
+import { Measure, MeasureCreateInput, measureView } from "./measure-DoJvtCaA.mjs";
 
 //#region src/commands/measure/create.ts
 var create_default = defineMetabaseCommand({
@@ -15,7 +16,11 @@ var create_default = defineMetabaseCommand({
 		name: "create",
 		description: "Create a measure (saved aggregation) from JSON"
 	},
-	details: "A measure is a reusable, saved aggregation tied to a table. The JSON body needs `name`, `table_id`, and a `definition` (an MBQL query holding exactly one aggregation). An MBQL 5 `definition` is checked against a bundled JSON Schema before sending; pass --skip-validate to bypass. See `mb skills get mbql`.",
+	details: "A measure is a reusable, saved aggregation tied to a table. The JSON body needs `name`, `table_id`, and a `definition` (an MBQL query holding exactly one aggregation). An MBQL 5 `definition` is checked against a bundled JSON Schema before sending; pass --skip-validate to bypass.",
+	skills: [{
+		skill: "mbql",
+		purpose: "the definition aggregation"
+	}],
 	capabilities: { minVersion: 59 },
 	args: {
 		...outputFlags,