@metabase/cli 0.1.15 → 0.1.17

package/README.md

@@ -469,38 +469,7 @@ mb table update 42 --file patch.json
 echo '{"description":"Customer dimension"}' | mb table update 42
 ```
 
-### `mb table publish`
-
-Publish tables to a library collection (`POST /api/ee/data-studio/table/publish-tables`), surfacing them as trusted data sources. The selected tables and every upstream table they depend on are set to the target `library-data` collection. Select tables with `--table-ids`, whole databases with `--db-ids`, or schemas with `--schemas` — the filters are combined. Requires the `library` premium feature.
-
-```sh
-mb table publish --collection-id 12 --table-ids 1,2,3
-mb table publish --collection-id 12 --db-ids 1 --json
-mb table publish --collection-id 12 --schemas 1:public,1:analytics
-```
-
-| Flag                   | Description                                                       |
-| ---------------------- | ----------------------------------------------------------------- |
-| `--collection-id <id>` | Target library collection id (required).                          |
-| `--table-ids <ids>`    | Comma-separated table ids.                                        |
-| `--db-ids <ids>`       | Comma-separated database ids.                                     |
-| `--schemas <ids>`      | Comma-separated schema ids, each `<db-id>:<schema>` (`1:public`). |
-
-### `mb table unpublish`
-
-Unpublish tables from the library (`POST /api/ee/data-studio/table/unpublish-tables`). Clears the library collection for the selected tables and every downstream table that depends on them. Same selector flags as `publish` (minus `--collection-id`). Requires the `library` premium feature.
-
-```sh
-mb table unpublish --table-ids 1,2,3
-mb table unpublish --db-ids 1 --json
-mb table unpublish --schemas 1:public,1:analytics
-```
-
-| Flag                | Description                                                       |
-| ------------------- | ----------------------------------------------------------------- |
-| `--table-ids <ids>` | Comma-separated table ids.                                        |
-| `--db-ids <ids>`    | Comma-separated database ids.                                     |
-| `--schemas <ids>`   | Comma-separated schema ids, each `<db-id>:<schema>` (`1:public`). |
+Publish status surfaces on the table itself — `table get`/`table list` carry `is_published` (and `collection_id` under `--full`). Publishing tables to the Library is done with [`mb library publish`](#library).
 
 ## Fields
 
@@ -660,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.
@@ -991,6 +981,53 @@ mb collection archive 4
 mb collection archive 4 --json
 ```
 
+## Library
+
+Curate the Metabase **Library** — a governed subtree (`library-data` "Data" for published tables, `library-metrics` "Metrics" for official metrics, under a `library` root). Tables published to Data appear first when people pick a data source and rank up in search, steering everyone toward trusted, analysis-ready tables. Requires the `library` premium feature (Pro/Enterprise) and admin or data-analyst permission (Curate alone won't publish tables). Publish status surfaces on the table via `is_published` (`table get`/`table list`).
+
+### `mb library get`
+
+Show the Library and its Data/Metrics collection ids (`GET /api/ee/library/`). Errors if the Library hasn't been created yet.
+
+```sh
+mb library get
+mb library get --json
+```
+
+### `mb library create`
+
+Create the Library subtree (`POST /api/ee/library/`). Idempotent — returns the existing Library when it's already there.
+
+```sh
+mb library create
+mb library create --json
+```
+
+### `mb library publish`
+
+Publish tables (and their upstream dependencies) into the Library's Data collection (`POST /api/ee/data-studio/table/publish-tables`). The target Data collection is resolved automatically and the Library is created if it doesn't exist yet — there's no collection id to pass.
+
+```sh
+mb library publish --table-ids 1,2,3
+mb library publish --db-ids 1 --json
+mb library publish --schemas 1:public,1:analytics
+```
+
+| Flag                | Description                                                       |
+| ------------------- | ----------------------------------------------------------------- |
+| `--table-ids <ids>` | Comma-separated table ids.                                        |
+| `--db-ids <ids>`    | Comma-separated database ids.                                     |
+| `--schemas <ids>`   | Comma-separated schema ids, each `<db-id>:<schema>` (`1:public`). |
+
+### `mb library unpublish`
+
+Unpublish tables (and their downstream dependents) from the Library (`POST /api/ee/data-studio/table/unpublish-tables`). Same selector flags as `publish`.
+
+```sh
+mb library unpublish --table-ids 1,2,3
+mb library unpublish --db-ids 1 --json
+```
+
 ## Documents
 
 CRUD on `/api/document`. A document is a rich-text page that mixes prose with embedded saved questions (`cardEmbed`) and inline links to Metabase entities (`smartLink`). The body is a [TipTap](https://tiptap.dev/) (ProseMirror) JSON tree stored under `content_type: application/json+vnd.prose-mirror`. The agent-facing format reference lives in the bundled `document` skill (`mb skills get document`). It's a baseline OSS feature — no elevated server version or premium token required.

package/dist/{add-collection-CXhrMjXU.mjs → add-collection-C-t9SQBk.mjs}

@@ -1,8 +1,8 @@
-import { connectionFlags, outputFlags, profileFlag } from "./error-D5bZ5BUX.mjs";
-import { defineMetabaseCommand } from "./runtime-C1QgWHM7.mjs";
-import { renderSummary } from "./capabilities-BX1rnVuH.mjs";
-import { parseId } from "./parse-id-DNPeV0Iu.mjs";
-import { REMOTE_SYNC_PATHS } from "./poll-task-oXpl3wzp.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-5H_tcfL8.mjs";
+import { defineMetabaseCommand } from "./runtime-BJtuxWM8.mjs";
+import { renderSummary } from "./capabilities-N0jo5U7S.mjs";
+import { parseId } from "./parse-id-D4LeTUsP.mjs";
+import { REMOTE_SYNC_PATHS } from "./poll-task-TilgciQn.mjs";
 import { z } from "zod";
 
 //#region src/commands/git-sync/add-collection.ts

package/dist/add-collection-Dek6kiRI.mjs

@@ -0,0 +1,11 @@
+import "./notice-DyVl5aYB.mjs";
+import "./error-5H_tcfL8.mjs";
+import "./command-augment-DdZIfx1V.mjs";
+import "./runtime-BJtuxWM8.mjs";
+import "./capabilities-N0jo5U7S.mjs";
+import "./parse-id-D4LeTUsP.mjs";
+import "./poll-BpAJpvb-.mjs";
+import "./poll-task-TilgciQn.mjs";
+import { SyncSettingsUpdateResult, add_collection_default, setCollectionRemoteSynced, syncSettingsUpdateView } from "./add-collection-C-t9SQBk.mjs";
+
+export { add_collection_default as default };

package/dist/{archive-BUwiCFnd.mjs → archive-C7dnyzVY.mjs}

@@ -1,10 +1,12 @@
-import "./command-augment-CAur0XOQ.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-D5bZ5BUX.mjs";
-import { defineMetabaseCommand } from "./runtime-C1QgWHM7.mjs";
-import { renderSummary } from "./capabilities-BX1rnVuH.mjs";
-import "./field-E0IBy4Uw.mjs";
-import { Card, cardView } from "./card-wCPcuKSi.mjs";
-import { parseId } from "./parse-id-DNPeV0Iu.mjs";
+import "./notice-DyVl5aYB.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-5H_tcfL8.mjs";
+import "./command-augment-DdZIfx1V.mjs";
+import { defineMetabaseCommand } from "./runtime-BJtuxWM8.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-D4LeTUsP.mjs";
 
 //#region src/commands/card/archive.ts
 var archive_default = defineMetabaseCommand({

package/dist/{archive-Blc1dz8Z.mjs → archive-CaoUUTIb.mjs}

@@ -1,10 +1,11 @@
-import "./command-augment-CAur0XOQ.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-D5bZ5BUX.mjs";
-import { defineMetabaseCommand } from "./runtime-C1QgWHM7.mjs";
-import { renderSummary } from "./capabilities-BX1rnVuH.mjs";
-import { parseId } from "./parse-id-DNPeV0Iu.mjs";
-import { revisionMessageFlag } from "./revision-message-flag-C7zBeWEt.mjs";
-import { Segment, segmentView } from "./segment-B9SEv9V_.mjs";
+import "./notice-DyVl5aYB.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-5H_tcfL8.mjs";
+import "./command-augment-DdZIfx1V.mjs";
+import { defineMetabaseCommand } from "./runtime-BJtuxWM8.mjs";
+import { renderSummary } from "./capabilities-N0jo5U7S.mjs";
+import { parseId } from "./parse-id-D4LeTUsP.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-D-Ovk0-E.mjs → archive-D1FX-sbU.mjs}

@@ -1,9 +1,10 @@
-import "./command-augment-CAur0XOQ.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-D5bZ5BUX.mjs";
-import { defineMetabaseCommand } from "./runtime-C1QgWHM7.mjs";
-import { renderSummary } from "./capabilities-BX1rnVuH.mjs";
-import { parseId } from "./parse-id-DNPeV0Iu.mjs";
-import { Snippet, snippetView } from "./snippet-NNzqlksR.mjs";
+import "./notice-DyVl5aYB.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-5H_tcfL8.mjs";
+import "./command-augment-DdZIfx1V.mjs";
+import { defineMetabaseCommand } from "./runtime-BJtuxWM8.mjs";
+import { renderSummary } from "./capabilities-N0jo5U7S.mjs";
+import { parseId } from "./parse-id-D4LeTUsP.mjs";
+import { Snippet, snippetView } from "./snippet-CtA2Pkoa.mjs";
 
 //#region src/commands/snippet/archive.ts
 var archive_default = defineMetabaseCommand({

package/dist/{archive-CQiaCBSj.mjs → archive-DS-KEB4a.mjs}

@@ -1,9 +1,10 @@
-import "./command-augment-CAur0XOQ.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-D5bZ5BUX.mjs";
-import { defineMetabaseCommand } from "./runtime-C1QgWHM7.mjs";
-import { renderSummary } from "./capabilities-BX1rnVuH.mjs";
-import { parseId } from "./parse-id-DNPeV0Iu.mjs";
-import { Collection, collectionView } from "./collection-Deiziuu2.mjs";
+import "./notice-DyVl5aYB.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-5H_tcfL8.mjs";
+import "./command-augment-DdZIfx1V.mjs";
+import { defineMetabaseCommand } from "./runtime-BJtuxWM8.mjs";
+import { renderSummary } from "./capabilities-N0jo5U7S.mjs";
+import { parseId } from "./parse-id-D4LeTUsP.mjs";
+import { Collection, collectionView } from "./collection-DrLpA1SO.mjs";
 
 //#region src/commands/collection/archive.ts
 var archive_default = defineMetabaseCommand({

package/dist/{archive-yTvDRQUZ.mjs → archive-LG8u7ec5.mjs}

@@ -1,9 +1,10 @@
-import "./command-augment-CAur0XOQ.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-D5bZ5BUX.mjs";
-import { defineMetabaseCommand } from "./runtime-C1QgWHM7.mjs";
-import { renderSummary } from "./capabilities-BX1rnVuH.mjs";
-import { parseId } from "./parse-id-DNPeV0Iu.mjs";
-import { Document, documentView } from "./document-qfwR0r63.mjs";
+import "./notice-DyVl5aYB.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-5H_tcfL8.mjs";
+import "./command-augment-DdZIfx1V.mjs";
+import { defineMetabaseCommand } from "./runtime-BJtuxWM8.mjs";
+import { renderSummary } from "./capabilities-N0jo5U7S.mjs";
+import { parseId } from "./parse-id-D4LeTUsP.mjs";
+import { Document, documentView } from "./document-1W7NRaO_.mjs";
 
 //#region src/commands/document/archive.ts
 var archive_default = defineMetabaseCommand({

package/dist/{archive-BxGSR7El.mjs → archive-qSOcACQo.mjs}

@@ -1,9 +1,11 @@
-import "./command-augment-CAur0XOQ.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-D5bZ5BUX.mjs";
-import { defineMetabaseCommand } from "./runtime-C1QgWHM7.mjs";
-import { renderSummary } from "./capabilities-BX1rnVuH.mjs";
-import { parseId } from "./parse-id-DNPeV0Iu.mjs";
-import { Dashboard, dashboardView } from "./dashboard-B4bn3z6t.mjs";
+import "./notice-DyVl5aYB.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-5H_tcfL8.mjs";
+import "./command-augment-DdZIfx1V.mjs";
+import { defineMetabaseCommand } from "./runtime-BJtuxWM8.mjs";
+import { renderSummary } from "./capabilities-N0jo5U7S.mjs";
+import "./parameter-CiJ4CwWE.mjs";
+import { parseId } from "./parse-id-D4LeTUsP.mjs";
+import { Dashboard, dashboardView } from "./dashboard-DOplbKyQ.mjs";
 
 //#region src/commands/dashboard/archive.ts
 var archive_default = defineMetabaseCommand({

package/dist/{archive-Drt-rWvU.mjs → archive-wNXwIiF0.mjs}

@@ -1,10 +1,11 @@
-import "./command-augment-CAur0XOQ.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-D5bZ5BUX.mjs";
-import { defineMetabaseCommand } from "./runtime-C1QgWHM7.mjs";
-import { renderSummary } from "./capabilities-BX1rnVuH.mjs";
-import { parseId } from "./parse-id-DNPeV0Iu.mjs";
-import { Measure, measureView } from "./measure-JJAdFoqK.mjs";
-import { revisionMessageFlag } from "./revision-message-flag-C7zBeWEt.mjs";
+import "./notice-DyVl5aYB.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-5H_tcfL8.mjs";
+import "./command-augment-DdZIfx1V.mjs";
+import { defineMetabaseCommand } from "./runtime-BJtuxWM8.mjs";
+import { renderSummary } from "./capabilities-N0jo5U7S.mjs";
+import { parseId } from "./parse-id-D4LeTUsP.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-Kv2MRkRk.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-Bt6j6yBM.mjs").then((m) => m.default),
+		status: () => import("./status-CmRgHTrV.mjs").then((m) => m.default),
+		list: () => import("./list-CvhVYOVl.mjs").then((m) => m.default),
+		logout: () => import("./logout-ANkL02p0.mjs").then((m) => m.default)
+	}
+});
+
+//#endregion
+export { auth_default as default };

package/dist/{body-B9XTTDEu.mjs → body-IcJ5kFtk.mjs}

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

package/dist/{branches-Ct3PK5U3.mjs → branches-BlNCTmFB.mjs}

@@ -1,9 +1,10 @@
-import "./command-augment-CAur0XOQ.mjs";
-import { connectionFlags, listEnvelopeSchema, outputFlags, profileFlag, wrapList } from "./error-D5bZ5BUX.mjs";
-import { defineMetabaseCommand } from "./runtime-C1QgWHM7.mjs";
-import { renderList } from "./capabilities-BX1rnVuH.mjs";
-import "./poll-CYkX02Bm.mjs";
-import { REMOTE_SYNC_PATHS } from "./poll-task-oXpl3wzp.mjs";
+import "./notice-DyVl5aYB.mjs";
+import { connectionFlags, listEnvelopeSchema, outputFlags, profileFlag, wrapList } from "./error-5H_tcfL8.mjs";
+import "./command-augment-DdZIfx1V.mjs";
+import { defineMetabaseCommand } from "./runtime-BJtuxWM8.mjs";
+import { renderList } from "./capabilities-N0jo5U7S.mjs";
+import "./poll-BpAJpvb-.mjs";
+import { REMOTE_SYNC_PATHS } from "./poll-task-TilgciQn.mjs";
 import { z } from "zod";
 
 //#region src/commands/git-sync/branches.ts

package/dist/{cancel-tST8Bh0w.mjs → cancel-BnveTPNw.mjs}

@@ -1,8 +1,9 @@
-import "./command-augment-CAur0XOQ.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-D5bZ5BUX.mjs";
-import { defineMetabaseCommand } from "./runtime-C1QgWHM7.mjs";
-import { renderSummary } from "./capabilities-BX1rnVuH.mjs";
-import { parseId } from "./parse-id-DNPeV0Iu.mjs";
+import "./notice-DyVl5aYB.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-5H_tcfL8.mjs";
+import "./command-augment-DdZIfx1V.mjs";
+import { defineMetabaseCommand } from "./runtime-BJtuxWM8.mjs";
+import { renderSummary } from "./capabilities-N0jo5U7S.mjs";
+import { parseId } from "./parse-id-D4LeTUsP.mjs";
 import { z } from "zod";
 
 //#region src/commands/transform/cancel.ts

package/dist/{cancel-task-BHnzRQKL.mjs → cancel-task-CSVI8Zgl.mjs}

@@ -1,9 +1,10 @@
-import "./command-augment-CAur0XOQ.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-D5bZ5BUX.mjs";
-import { defineMetabaseCommand } from "./runtime-C1QgWHM7.mjs";
-import { renderSummary } from "./capabilities-BX1rnVuH.mjs";
-import "./poll-CYkX02Bm.mjs";
-import { REMOTE_SYNC_PATHS, SyncTask, syncTaskView } from "./poll-task-oXpl3wzp.mjs";
+import "./notice-DyVl5aYB.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-5H_tcfL8.mjs";
+import "./command-augment-DdZIfx1V.mjs";
+import { defineMetabaseCommand } from "./runtime-BJtuxWM8.mjs";
+import { renderSummary } from "./capabilities-N0jo5U7S.mjs";
+import "./poll-BpAJpvb-.mjs";
+import { REMOTE_SYNC_PATHS, SyncTask, syncTaskView } from "./poll-task-TilgciQn.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-Bp58WEUF.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-BF-W4jOZ.mjs").then((mod) => mod.default),
+		get: () => import("./get-Cl5Ak73C.mjs").then((mod) => mod.default),
+		query: () => import("./query-CQ3xXa9P.mjs").then((mod) => mod.default),
+		create: () => import("./create-FZOrCw5k.mjs").then((mod) => mod.default),
+		update: () => import("./update-Dxa_6H2A.mjs").then((mod) => mod.default),
+		archive: () => import("./archive-C7dnyzVY.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-BySIFsLG.mjs → cards-CMgGA8OZ.mjs}

@@ -1,9 +1,11 @@
-import "./command-augment-CAur0XOQ.mjs";
-import { connectionFlags, listEnvelopeSchema, outputFlags, profileFlag, wrapList } from "./error-D5bZ5BUX.mjs";
-import { defineMetabaseCommand } from "./runtime-C1QgWHM7.mjs";
-import { renderList } from "./capabilities-BX1rnVuH.mjs";
-import { parseId } from "./parse-id-DNPeV0Iu.mjs";
-import { DashboardDetail, DashcardCompact, dashcardView } from "./dashboard-B4bn3z6t.mjs";
+import "./notice-DyVl5aYB.mjs";
+import { connectionFlags, listEnvelopeSchema, outputFlags, profileFlag, wrapList } from "./error-5H_tcfL8.mjs";
+import "./command-augment-DdZIfx1V.mjs";
+import { defineMetabaseCommand } from "./runtime-BJtuxWM8.mjs";
+import { renderList } from "./capabilities-N0jo5U7S.mjs";
+import "./parameter-CiJ4CwWE.mjs";
+import { parseId } from "./parse-id-D4LeTUsP.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-D5bZ5BUX.mjs";
+import { ConfigError, flagConsumesValue, normalizeFlag, resolveCitty, toAliasArray } from "./notice-DyVl5aYB.mjs";
+import { connectionFlags, outputFlags, package_default, profileFlag, reportError } from "./error-5H_tcfL8.mjs";
+import { getMetabaseAugment, setMetabaseAugment } from "./command-augment-DdZIfx1V.mjs";
 import { defineCommand, renderUsage, runMain } from "citty";
 
 //#region src/commands/global-flags.ts
@@ -58,32 +59,46 @@ const main = defineCommand({
 		description: package_default.description
 	},
 	subCommands: {
-		auth: () => import("./auth-Bkue4Psy.mjs").then((mod) => mod.default),
-		db: () => import("./db-CmHHj5eI.mjs").then((mod) => mod.default),
-		table: () => import("./table-COAKXNuj.mjs").then((mod) => mod.default),
-		field: () => import("./field-B-UcqFzm.mjs").then((mod) => mod.default),
-		card: () => import("./card-faWo9ZWU.mjs").then((mod) => mod.default),
-		dashboard: () => import("./dashboard-pXAxJTTx.mjs").then((mod) => mod.default),
-		collection: () => import("./collection-DcRz7fmf.mjs").then((mod) => mod.default),
-		document: () => import("./document-DQIhL75C.mjs").then((mod) => mod.default),
-		transform: () => import("./transform-Bto4U82j.mjs").then((mod) => mod.default),
-		"transform-job": () => import("./transform-job-_fW1y2tg.mjs").then((mod) => mod.default),
-		"transform-tag": () => import("./transform-tag-C8n1oTr1.mjs").then((mod) => mod.default),
-		setting: () => import("./setting-zZjcOPyE.mjs").then((mod) => mod.default),
-		search: () => import("./search-D7Yq2MDu.mjs").then((mod) => mod.default),
-		"git-sync": () => import("./git-sync-CwOvcUI2.mjs").then((mod) => mod.default),
-		setup: () => import("./setup-C47WUieB.mjs").then((mod) => mod.default),
-		snippet: () => import("./snippet-DK0ZA8m5.mjs").then((mod) => mod.default),
-		segment: () => import("./segment-BN8sFunv.mjs").then((mod) => mod.default),
-		measure: () => import("./measure-BIAoqgcS.mjs").then((mod) => mod.default),
-		eid: () => import("./eid-1mROiwJr.mjs").then((mod) => mod.default),
-		query: () => import("./query-CxTjguwp.mjs").then((mod) => mod.default),
-		uuid: () => import("./uuid-Dpl3ALKq.mjs").then((mod) => mod.default),
-		upgrade: () => import("./upgrade-CNrkJF6s.mjs").then((mod) => mod.default),
-		skills: () => import("./skills-Po0YPVU5.mjs").then((mod) => mod.default),
-		__manifest: () => import("./manifest-DYeLri80.mjs").then((mod) => mod.createManifestCommand(main))
+		auth: () => import("./auth-Kv2MRkRk.mjs").then((mod) => mod.default),
+		db: () => import("./db-DWykmBOh.mjs").then((mod) => mod.default),
+		table: () => import("./table-B1iBqmNu.mjs").then((mod) => mod.default),
+		field: () => import("./field-CFt1-KDR.mjs").then((mod) => mod.default),
+		card: () => import("./card-Bp58WEUF.mjs").then((mod) => mod.default),
+		dashboard: () => import("./dashboard-C9pQCnX6.mjs").then((mod) => mod.default),
+		collection: () => import("./collection-D8TI20Ir.mjs").then((mod) => mod.default),
+		library: () => import("./library-B5AvpACG.mjs").then((mod) => mod.default),
+		document: () => import("./document-DNDm8_Py.mjs").then((mod) => mod.default),
+		transform: () => import("./transform-BuIooRQh.mjs").then((mod) => mod.default),
+		"transform-job": () => import("./transform-job-C3yz0krA.mjs").then((mod) => mod.default),
+		"transform-tag": () => import("./transform-tag-CJD6mJUe.mjs").then((mod) => mod.default),
+		setting: () => import("./setting-DHYO-W5g.mjs").then((mod) => mod.default),
+		search: () => import("./search-vaT5EwhG.mjs").then((mod) => mod.default),
+		"git-sync": () => import("./git-sync-ByvjqSiy.mjs").then((mod) => mod.default),
+		setup: () => import("./setup-D1de5Sbc.mjs").then((mod) => mod.default),
+		snippet: () => import("./snippet-DtLmHr2J.mjs").then((mod) => mod.default),
+		segment: () => import("./segment-BPC725mo.mjs").then((mod) => mod.default),
+		measure: () => import("./measure-CgFwtL1r.mjs").then((mod) => mod.default),
+		eid: () => import("./eid-p-zn_1RJ.mjs").then((mod) => mod.default),
+		query: () => import("./query-BWJ5h1g3.mjs").then((mod) => mod.default),
+		uuid: () => import("./uuid-D6JVJ-R1.mjs").then((mod) => mod.default),
+		upgrade: () => import("./upgrade-CBW8V9qZ.mjs").then((mod) => mod.default),
+		skills: () => import("./skills-NhgVypJ7.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
@@ -102,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, ""));
@@ -114,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,
@@ -122,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");
 }
@@ -173,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-D8TI20Ir.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-C4bALfCs.mjs").then((mod) => mod.default),
+		get: () => import("./get-4lufgahL.mjs").then((mod) => mod.default),
+		items: () => import("./items-CQtt9X4M.mjs").then((mod) => mod.default),
+		tree: () => import("./tree-D18vYSe4.mjs").then((mod) => mod.default),
+		create: () => import("./create-B79M8YpX.mjs").then((mod) => mod.default),
+		archive: () => import("./archive-DS-KEB4a.mjs").then((mod) => mod.default)
+	}
+});
+
+//#endregion
+export { collection_default as default };

package/dist/{collection-namespace-D8ohM5gD.mjs → collection-namespace-CsaxEqOb.mjs}

@@ -1,5 +1,5 @@
-import { ConfigError } from "./command-augment-CAur0XOQ.mjs";
-import { HttpError } from "./runtime-C1QgWHM7.mjs";
+import { ConfigError } from "./notice-DyVl5aYB.mjs";
+import { HttpError } from "./runtime-BJtuxWM8.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.";