@metabase/cli 0.1.0-alpha.workspaces-commands.28a297a → 0.1.0-alpha.workspaces-commands.aa383a1

package/README.md

@@ -271,39 +271,42 @@ metabase transform-job delete 1 --yes
 
 ## Databases
 
-Read warehouse metadata from `/api/database`. The `db` group exposes the full database list, the per-database record, hydrated metadata (tables + fields rolled up in one response), schema and table inspection, and the two manual-sync triggers.
+Read warehouse metadata from `/api/database`. The `db` group exposes the full database list, the per-database record, schema and table inspection, the two manual-sync triggers, and (rarely useful) full-warehouse rollup endpoints.
 
 `db` is aliased to `database`.
 
+> **Agent traversal:** prefer the granular path — `db list` → `db schemas <db-id>` → `db schema-tables <db-id> <schema>` → `table get <table-id> --include fields`. On a real warehouse (dozens of schemas, hundreds of tables, dozens of fields per table) the rollup commands (`db metadata`, `db get --include tables.fields`, `db list --include tables`) return megabytes of JSON and exhaust the agent context. Reach for them only on small/dev warehouses where you know the size up front.
+
 ### `metabase db list`
 
 ```sh
 metabase db list
 metabase db list --json
-metabase db list --include tables --full --json
 metabase db list --saved --json
+metabase db list --include tables --full --json   # rollup: every db with its full table list
 ```
 
-| Flag                | Description                                                                                                   |
-| ------------------- | ------------------------------------------------------------------------------------------------------------- |
-| `--include <which>` | Hydrate related entities. Currently only `tables` is supported (each database is returned with its `tables`). |
-| `--saved`           | Include the Saved Questions virtual database in the list. The virtual db has id `-1337` and no `engine`.      |
+| Flag                | Description                                                                                                                                                                                                          |
+| ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `--include <which>` | Hydrate related entities. Currently only `tables` is supported (each database is returned with its `tables`). On real warehouses this returns hundreds of table records per db — use the granular traversal instead. |
+| `--saved`           | Include the Saved Questions virtual database in the list. The virtual db has id `-1337` and no `engine`.                                                                                                             |
 
 ### `metabase db get <id>`
 
 ```sh
 metabase db get 1
 metabase db get 1 --json
-metabase db get 1 --include tables.fields --full --json
+metabase db get 1 --include tables --full --json          # rollup: db + every table (compact)
+metabase db get 1 --include tables.fields --full --json   # rollup: db + every table + every field
 ```
 
-| Flag                | Description                                                   |
-| ------------------- | ------------------------------------------------------------- |
-| `--include <which>` | Hydrate related entities. One of `tables` or `tables.fields`. |
+| Flag                | Description                                                                                                                                                                                                                                                                       |
+| ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `--include <which>` | Hydrate related entities. One of `tables` or `tables.fields`. `tables.fields` returns every column of every table in the database in one response — only safe on small/dev warehouses. For a real warehouse use `db schemas` → `db schema-tables` → `table get --include fields`. |
 
 ### `metabase db metadata <id>`
 
-Equivalent to `GET /api/database/:id/metadata`: a single database with all its tables and fields rolled up in one response. Use this when an agent needs a one-shot warehouse introspection rather than the per-table `metabase table get --full`.
+Equivalent to `GET /api/database/:id/metadata`: a single database with all its tables and fields rolled up in one response. This is the largest read in the `db` group — on a real warehouse the response will exceed the agent context. Use only when you know the database is small (a seeded dev instance, a sample db, a freshly-bootstrapped test fixture). For agent-driven introspection on a real warehouse, walk `db schemas` → `db schema-tables` → `table get --include fields` instead.
 
 ```sh
 metabase db metadata 1 --json --full --max-bytes 0
@@ -311,7 +314,7 @@ metabase db metadata 1 --json --full --max-bytes 0
 
 ### `metabase db schemas <id>`
 
-List the schemas in a database. Schemas with no tables are excluded.
+List the schemas in a database. Schemas with no tables are excluded. Cheap and bounded — this is the right entry point for an agent walking a warehouse.
 
 ```sh
 metabase db schemas 1
@@ -320,7 +323,7 @@ metabase db schemas 1 --json
 
 ### `metabase db schema-tables <id> <schema>`
 
-List the tables in a given schema, sorted by display name.
+List the tables in one schema, sorted by display name. Returns compact projections without fields — pair with `table get --include fields` (or `table fields <id>`) per table you actually need to introspect.
 
 ```sh
 metabase db schema-tables 1 public
@@ -347,10 +350,12 @@ metabase db rescan-values 1 --json
 
 ## Tables
 
-Inspect and edit warehouse tables via `/api/table`.
+Inspect and edit warehouse tables via `/api/table`. For agent-driven field introspection, `table get --include fields` is the default — it returns the table plus its columns in a single bounded response.
 
 ### `metabase table list`
 
+Returns every table in the chosen database (or across all databases) as a flat compact list — no fields, no per-table hydration. On a real warehouse with hundreds of tables this is still bounded (kilobytes), but `db schema-tables <db-id> <schema>` is the better starting point when you know the schema.
+
 ```sh
 metabase table list
 metabase table list --db-id 1 --json
@@ -362,28 +367,33 @@ metabase table list --db-id 1 --json
 
 ### `metabase table get <id>`
 
-Returns the basic table record (no fields). Use `metabase table metadata <id>` when you want the rollup with fields/FKs/dimensions hydrated.
+Returns the basic table record (no fields). Pass `--include fields` to route through `/api/table/:id/query_metadata` so the response carries the table's columns compact-projected as `fields` — this is the default agent path for field introspection. Use `metabase table fields <id>` if you only want the fields as a list envelope, or `metabase table metadata <id>` when you also need FKs and dimensions hydrated.
 
 ```sh
 metabase table get 42
 metabase table get 42 --json
+metabase table get 42 --include fields --json
 ```
 
-### `metabase table metadata <id>`
+| Flag                | Description                                                                                         |
+| ------------------- | --------------------------------------------------------------------------------------------------- |
+| `--include <which>` | Hydrate related entities. Currently only `fields` is supported (bundles compact-projected columns). |
 
-`GET /api/table/:id/query_metadata`: the table with its fields, FKs, and dimensions hydrated. The agent-facing one-shot introspection for a single table.
+### `metabase table fields <id>`
+
+List the fields on a table (a thin projection over `query_metadata.fields`). Use this when you want just the field array without the surrounding table metadata.
 
 ```sh
-metabase table metadata 42 --json --full --max-bytes 0
+metabase table fields 42
+metabase table fields 42 --json
 ```
 
-### `metabase table fields <id>`
+### `metabase table metadata <id>`
 
-List the fields on a table (a thin projection over `query_metadata.fields`).
+`GET /api/table/:id/query_metadata`: the table with its fields, FKs, dimensions, segments, and measures all hydrated. Heavier than `table get --include fields` — reach for it only when you actually need the FK / dimension / segment / measure data.
 
 ```sh
-metabase table fields 42
-metabase table fields 42 --json
+metabase table metadata 42 --json --full --max-bytes 0
 ```
 
 ### `metabase table update <id>`
@@ -1365,6 +1375,33 @@ Agent discovery path: `metabase __manifest` lists every command's args and descr
 
 The bundled query schema is synced from a pinned `@metabase/representations` release via `bun run sync:representations`; CI guards against drift.
 
+### Card-reference pre-flight in `dashboard create` / `dashboard update`
+
+Before either command sends anything, every positive `card_id` referenced from the body's `dashcards` array is checked against `GET /api/card/:id` in parallel (de-duplicated per id). Cards that don't exist, are archived, or aren't readable fail pre-flight: the CLI writes a `{ ok: false, errors: [{ path, message }] }` envelope to stdout (one entry per offending dashcard, `path` is a JSON pointer like `/dashcards/3/card_id`) and exits **2** with `dashboard card-reference pre-flight failed: N error(s) — fix the dashcard card_id values listed above` on stderr. No dashboard is created or modified on a pre-flight miss — this is the contract that prevents orphan dashboards when a stale spec references an archived or missing card.
+
+There is no `--skip-validate` escape hatch here. The pre-flight queries live server state (no bundled schema to drift from), so the only legitimate path on a pre-flight miss is to fix the input.
+
+If the chained `PUT /api/dashboard/:id` fails _after_ the create has already inserted the row (rare with pre-flight in place, but possible on a permission / 5xx / network failure mid-flight), the user-facing error is rewritten to `dashboard <id> created but follow-up PUT /api/dashboard/<id> failed: <reason>; dashcards not applied`, so the caller knows the orphan exists. Recovery: `dashboard update <id> --body '{"dashcards":[...]}'` to retry the dashcards, or `dashboard update <id> --body '{"archived":true}'` to archive the orphan.
+
+## UUIDs
+
+### `metabase uuid`
+
+Mint UUID v4 strings (Node `crypto.randomUUID`) for MBQL clause `lib/uuid` slots, native template-tag ids, and any other Metabase-side identifier whose schema enforces RFC 4122 format. Agents must call this command to obtain UUIDs rather than authoring them by hand: the bundled MBQL 5 schema rejects placeholder strings (`a1`, `uuid-1`, etc.) at `format: "uuid"` validation.
+
+```sh
+metabase uuid                          # one UUID
+metabase uuid --count 5                # five UUIDs, one per line (text mode in a TTY, JSON when piped)
+metabase uuid --count 5 --json         # explicit JSON: ["…", "…", "…", "…", "…"]
+metabase uuid --count 5 --format text  # explicit text: one UUID per line
+```
+
+Output: text mode prints one UUID per line; JSON mode prints a `string[]`. Default behavior follows the standard `--format auto` rule — JSON when stdout is a pipe, text when it's a TTY.
+
+`--count` accepts integers `1` through `10000`; outside that range exits 2 with a `ConfigError`.
+
+Exit codes: `0` success, `2` invalid `--count`.
+
 ## Environment variables
 
 | Variable                 | Effect                                                                         |

package/dist/add-collection-Bw_KL6EH.mjs

@@ -0,0 +1,11 @@
+import "./package-BPEXn1Of.mjs";
+import "./command-augment-D9pI9Vbh.mjs";
+import "./render-D8GOkk4P.mjs";
+import "./errors-DqPLKwoK.mjs";
+import "./runtime-Dwaw7sqU.mjs";
+import "./parse-id-BqO2IY1b.mjs";
+import "./poll-task-CXSagHdO.mjs";
+import "./poll-DJWznjP9.mjs";
+import { SyncSettingsUpdateResult, add_collection_default, setCollectionRemoteSynced, syncSettingsUpdateView } from "./add-collection-Cvh_24_Q.mjs";
+
+export { add_collection_default as default };

package/dist/{add-collection-DB2C0Pdw.mjs → add-collection-Cvh_24_Q.mjs}

@@ -1,7 +1,7 @@
-import { renderItem } from "./render-BYWlZPEH.mjs";
-import { connectionFlags, defineMetabaseCommand, outputFlags, profileFlag } from "./runtime-BfWVLqFk.mjs";
-import { parseId } from "./parse-id-jvzdqaO1.mjs";
-import { REMOTE_SYNC_PATHS } from "./poll-task-DlcGug4o.mjs";
+import { renderItem } from "./render-D8GOkk4P.mjs";
+import { connectionFlags, defineMetabaseCommand, outputFlags, profileFlag } from "./runtime-Dwaw7sqU.mjs";
+import { parseId } from "./parse-id-BqO2IY1b.mjs";
+import { REMOTE_SYNC_PATHS } from "./poll-task-CXSagHdO.mjs";
 import { z } from "zod";
 
 //#region src/commands/sync/add-collection.ts

package/dist/{api-key-BqZV1nLg.mjs → api-key-d2kBtC3S.mjs}

@@ -6,7 +6,7 @@ var api_key_default = defineCommand({
 		name: "api-key",
 		description: "Manage Metabase API keys"
 	},
-	subCommands: { create: () => import("./create-D52ykhxx.mjs").then((mod) => mod.default) }
+	subCommands: { create: () => import("./create-D5GQ3L7D.mjs").then((mod) => mod.default) }
 });
 
 //#endregion

package/dist/{archive-e-4fxNMq.mjs → archive-BbY8tyIA.mjs}

@@ -1,11 +1,11 @@
-import "./package-CtkDnX1U.mjs";
+import "./package-BPEXn1Of.mjs";
 import "./command-augment-D9pI9Vbh.mjs";
-import { renderItem } from "./render-BYWlZPEH.mjs";
-import "./errors-C6w1eZ1F.mjs";
-import { connectionFlags, defineMetabaseCommand, outputFlags, profileFlag } from "./runtime-BfWVLqFk.mjs";
-import { parseId } from "./parse-id-jvzdqaO1.mjs";
-import { Measure, measureView } from "./measure-B1GKcZxO.mjs";
-import { revisionMessageFlag } from "./revision-message-flag-BJiGjb5m.mjs";
+import { renderItem } from "./render-D8GOkk4P.mjs";
+import "./errors-DqPLKwoK.mjs";
+import { connectionFlags, defineMetabaseCommand, outputFlags, profileFlag } from "./runtime-Dwaw7sqU.mjs";
+import { parseId } from "./parse-id-BqO2IY1b.mjs";
+import { Measure, measureView } from "./measure-jbc7fsCs.mjs";
+import { revisionMessageFlag } from "./revision-message-flag-D4E1lKE5.mjs";
 
 //#region src/commands/measure/archive.ts
 var archive_default = defineMetabaseCommand({

package/dist/{archive-c6NmnA8k.mjs → archive-CMEk6RsU.mjs}

@@ -1,10 +1,10 @@
-import "./package-CtkDnX1U.mjs";
+import "./package-BPEXn1Of.mjs";
 import "./command-augment-D9pI9Vbh.mjs";
-import { renderItem } from "./render-BYWlZPEH.mjs";
-import "./errors-C6w1eZ1F.mjs";
-import { connectionFlags, defineMetabaseCommand, outputFlags, profileFlag } from "./runtime-BfWVLqFk.mjs";
-import { parseId } from "./parse-id-jvzdqaO1.mjs";
-import { Snippet, snippetView } from "./snippet-DRTklDg3.mjs";
+import { renderItem } from "./render-D8GOkk4P.mjs";
+import "./errors-DqPLKwoK.mjs";
+import { connectionFlags, defineMetabaseCommand, outputFlags, profileFlag } from "./runtime-Dwaw7sqU.mjs";
+import { parseId } from "./parse-id-BqO2IY1b.mjs";
+import { Snippet, snippetView } from "./snippet-CBTV07b-.mjs";
 
 //#region src/commands/snippet/archive.ts
 var archive_default = defineMetabaseCommand({

package/dist/{archive-CuYuesnm.mjs → archive-O0WoU8LU.mjs}

@@ -1,9 +1,9 @@
-import "./package-CtkDnX1U.mjs";
+import "./package-BPEXn1Of.mjs";
 import "./command-augment-D9pI9Vbh.mjs";
-import { renderItem } from "./render-BYWlZPEH.mjs";
-import "./errors-C6w1eZ1F.mjs";
-import { connectionFlags, defineMetabaseCommand, outputFlags, profileFlag } from "./runtime-BfWVLqFk.mjs";
-import { parseId } from "./parse-id-jvzdqaO1.mjs";
+import { renderItem } from "./render-D8GOkk4P.mjs";
+import "./errors-DqPLKwoK.mjs";
+import { connectionFlags, defineMetabaseCommand, outputFlags, profileFlag } from "./runtime-Dwaw7sqU.mjs";
+import { parseId } from "./parse-id-BqO2IY1b.mjs";
 import { Card, cardView } from "./card-BOGKT258.mjs";
 
 //#region src/commands/card/archive.ts

package/dist/{archive-B1keZ1oV.mjs → archive-WgWmkexh.mjs}

@@ -1,11 +1,11 @@
-import "./package-CtkDnX1U.mjs";
+import "./package-BPEXn1Of.mjs";
 import "./command-augment-D9pI9Vbh.mjs";
-import { renderItem } from "./render-BYWlZPEH.mjs";
-import "./errors-C6w1eZ1F.mjs";
-import { connectionFlags, defineMetabaseCommand, outputFlags, profileFlag } from "./runtime-BfWVLqFk.mjs";
-import { parseId } from "./parse-id-jvzdqaO1.mjs";
-import { revisionMessageFlag } from "./revision-message-flag-BJiGjb5m.mjs";
-import { Segment, segmentView } from "./segment-CQ5w3M_W.mjs";
+import { renderItem } from "./render-D8GOkk4P.mjs";
+import "./errors-DqPLKwoK.mjs";
+import { connectionFlags, defineMetabaseCommand, outputFlags, profileFlag } from "./runtime-Dwaw7sqU.mjs";
+import { parseId } from "./parse-id-BqO2IY1b.mjs";
+import { revisionMessageFlag } from "./revision-message-flag-D4E1lKE5.mjs";
+import { Segment, segmentView } from "./segment-D0XmKSU2.mjs";
 
 //#region src/commands/segment/archive.ts
 var archive_default = defineMetabaseCommand({

package/dist/auth-DCoGwYKi.mjs

@@ -0,0 +1,19 @@
+import { defineCommand } from "citty";
+
+//#region src/commands/auth/index.ts
+var auth_default = defineCommand({
+	meta: {
+		name: "auth",
+		description: "Authenticate against a Metabase instance"
+	},
+	default: "login",
+	subCommands: {
+		login: () => import("./login-D4a3b52m.mjs").then((m) => m.default),
+		status: () => import("./status-g9cjxsHd.mjs").then((m) => m.default),
+		list: () => import("./list-BsmGs2Wf.mjs").then((m) => m.default),
+		logout: () => import("./logout-BhO5sEm8.mjs").then((m) => m.default)
+	}
+});
+
+//#endregion
+export { auth_default as default };

package/dist/{body-D_BRIb1g.mjs → body-C2lo4Axp.mjs}

@@ -1,6 +1,6 @@
-import { ConfigError } from "./errors-C6w1eZ1F.mjs";
-import { readInput } from "./input-DMcm_A5s.mjs";
-import { parseJson } from "./runtime-BfWVLqFk.mjs";
+import { ConfigError } from "./errors-DqPLKwoK.mjs";
+import { readInput } from "./input-a1VFtFBh.mjs";
+import { parseJson } from "./runtime-Dwaw7sqU.mjs";
 
 //#region src/runtime/body.ts
 async function readBody(sources, schema) {

package/dist/{branches-Dy_8vIh4.mjs → branches-ohsIXufV.mjs}

@@ -1,10 +1,10 @@
-import "./package-CtkDnX1U.mjs";
+import "./package-BPEXn1Of.mjs";
 import "./command-augment-D9pI9Vbh.mjs";
-import { renderList } from "./render-BYWlZPEH.mjs";
-import "./errors-C6w1eZ1F.mjs";
-import { connectionFlags, defineMetabaseCommand, listEnvelopeSchema, outputFlags, profileFlag, wrapList } from "./runtime-BfWVLqFk.mjs";
-import { REMOTE_SYNC_PATHS } from "./poll-task-DlcGug4o.mjs";
-import "./poll-48PVbWIx.mjs";
+import { renderList } from "./render-D8GOkk4P.mjs";
+import "./errors-DqPLKwoK.mjs";
+import { connectionFlags, defineMetabaseCommand, listEnvelopeSchema, outputFlags, profileFlag, wrapList } from "./runtime-Dwaw7sqU.mjs";
+import { REMOTE_SYNC_PATHS } from "./poll-task-CXSagHdO.mjs";
+import "./poll-DJWznjP9.mjs";
 import { z } from "zod";
 
 //#region src/commands/sync/branches.ts

package/dist/{cancel-Djld5ex0.mjs → cancel-eV9xzouo.mjs}

@@ -1,9 +1,9 @@
-import "./package-CtkDnX1U.mjs";
+import "./package-BPEXn1Of.mjs";
 import "./command-augment-D9pI9Vbh.mjs";
-import { renderItem } from "./render-BYWlZPEH.mjs";
-import "./errors-C6w1eZ1F.mjs";
-import { connectionFlags, defineMetabaseCommand, outputFlags, profileFlag } from "./runtime-BfWVLqFk.mjs";
-import { parseId } from "./parse-id-jvzdqaO1.mjs";
+import { renderItem } from "./render-D8GOkk4P.mjs";
+import "./errors-DqPLKwoK.mjs";
+import { connectionFlags, defineMetabaseCommand, outputFlags, profileFlag } from "./runtime-Dwaw7sqU.mjs";
+import { parseId } from "./parse-id-BqO2IY1b.mjs";
 import { z } from "zod";
 
 //#region src/commands/transform/cancel.ts

package/dist/{cancel-task-DX_5nq_N.mjs → cancel-task-DEI788SO.mjs}

@@ -1,10 +1,10 @@
-import "./package-CtkDnX1U.mjs";
+import "./package-BPEXn1Of.mjs";
 import "./command-augment-D9pI9Vbh.mjs";
-import { renderItem } from "./render-BYWlZPEH.mjs";
-import "./errors-C6w1eZ1F.mjs";
-import { connectionFlags, defineMetabaseCommand, outputFlags, profileFlag } from "./runtime-BfWVLqFk.mjs";
-import { REMOTE_SYNC_PATHS, SyncTask, syncTaskView } from "./poll-task-DlcGug4o.mjs";
-import "./poll-48PVbWIx.mjs";
+import { renderItem } from "./render-D8GOkk4P.mjs";
+import "./errors-DqPLKwoK.mjs";
+import { connectionFlags, defineMetabaseCommand, outputFlags, profileFlag } from "./runtime-Dwaw7sqU.mjs";
+import { REMOTE_SYNC_PATHS, SyncTask, syncTaskView } from "./poll-task-CXSagHdO.mjs";
+import "./poll-DJWznjP9.mjs";
 
 //#region src/commands/sync/cancel-task.ts
 var cancel_task_default = defineMetabaseCommand({

package/dist/card-CtK41cpb.mjs

@@ -0,0 +1,20 @@
+import { defineCommand } from "citty";
+
+//#region src/commands/card/index.ts
+var card_default = defineCommand({
+	meta: {
+		name: "card",
+		description: "Manage Metabase cards (questions, models, metrics)"
+	},
+	subCommands: {
+		list: () => import("./list-VIZSxtf3.mjs").then((mod) => mod.default),
+		get: () => import("./get-BD7Vyb-k.mjs").then((mod) => mod.default),
+		query: () => import("./query-q7b2hzrE.mjs").then((mod) => mod.default),
+		create: () => import("./create-oFRJZRJW.mjs").then((mod) => mod.default),
+		update: () => import("./update-fRqtvI5G.mjs").then((mod) => mod.default),
+		archive: () => import("./archive-O0WoU8LU.mjs").then((mod) => mod.default)
+	}
+});
+
+//#endregion
+export { card_default as default };

package/dist/{cards-Bhu7cd67.mjs → cards-B_XNja43.mjs}

@@ -1,10 +1,10 @@
-import "./package-CtkDnX1U.mjs";
+import "./package-BPEXn1Of.mjs";
 import "./command-augment-D9pI9Vbh.mjs";
-import { renderList } from "./render-BYWlZPEH.mjs";
-import "./errors-C6w1eZ1F.mjs";
-import { connectionFlags, defineMetabaseCommand, listEnvelopeSchema, outputFlags, profileFlag, wrapList } from "./runtime-BfWVLqFk.mjs";
-import { parseId } from "./parse-id-jvzdqaO1.mjs";
-import { DashboardDetail, DashcardCompact, dashcardView } from "./dashboard-CztCJxke.mjs";
+import { renderList } from "./render-D8GOkk4P.mjs";
+import "./errors-DqPLKwoK.mjs";
+import { connectionFlags, defineMetabaseCommand, listEnvelopeSchema, outputFlags, profileFlag, wrapList } from "./runtime-Dwaw7sqU.mjs";
+import { parseId } from "./parse-id-BqO2IY1b.mjs";
+import { DashboardDetail, DashcardCompact, dashcardView } from "./dashboard-DyrRSbqQ.mjs";
 
 //#region src/commands/dashboard/cards.ts
 const DashcardListEnvelope = listEnvelopeSchema(DashcardCompact);

package/dist/cli.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { package_default } from "./package-CtkDnX1U.mjs";
+import { package_default } from "./package-BPEXn1Of.mjs";
 import { getMetabaseAugment } from "./command-augment-D9pI9Vbh.mjs";
 import { defineCommand, renderUsage, runMain } from "citty";
 
@@ -11,28 +11,29 @@ const main = defineCommand({
 		description: package_default.description
 	},
 	subCommands: {
-		auth: () => import("./auth-DHOpcw11.mjs").then((mod) => mod.default),
-		license: () => import("./license-CHccrjDp.mjs").then((mod) => mod.default),
-		db: () => import("./db-CBCfAbIZ.mjs").then((mod) => mod.default),
-		table: () => import("./table-BjX5aZ_b.mjs").then((mod) => mod.default),
-		field: () => import("./field-DbuCWbv9.mjs").then((mod) => mod.default),
-		card: () => import("./card-D1JLv6cG.mjs").then((mod) => mod.default),
-		dashboard: () => import("./dashboard-BLr8iCSU.mjs").then((mod) => mod.default),
-		collection: () => import("./collection-C2C4HUz_.mjs").then((mod) => mod.default),
-		transform: () => import("./transform-hfQvOcAS.mjs").then((mod) => mod.default),
-		"transform-job": () => import("./transform-job-BtJZYt5N.mjs").then((mod) => mod.default),
-		setting: () => import("./setting-BDbBiriX.mjs").then((mod) => mod.default),
-		search: () => import("./search-BU6MBJkj.mjs").then((mod) => mod.default),
-		sync: () => import("./sync-CHqSTijq.mjs").then((mod) => mod.default),
-		workspace: () => import("./workspace-DvZtoFEM.mjs").then((mod) => mod.default),
-		setup: () => import("./setup-DfWKuwgQ.mjs").then((mod) => mod.default),
-		"api-key": () => import("./api-key-BqZV1nLg.mjs").then((mod) => mod.default),
-		snippet: () => import("./snippet-CbNr7l5W.mjs").then((mod) => mod.default),
-		segment: () => import("./segment-CYr8A0Qx.mjs").then((mod) => mod.default),
-		measure: () => import("./measure-CDMN4H2K.mjs").then((mod) => mod.default),
-		eid: () => import("./eid-AISoTK5d.mjs").then((mod) => mod.default),
-		query: () => import("./query-BoIeOotH.mjs").then((mod) => mod.default),
-		__manifest: () => import("./manifest-CdAV6-YB.mjs").then((mod) => mod.createManifestCommand(main))
+		auth: () => import("./auth-DCoGwYKi.mjs").then((mod) => mod.default),
+		license: () => import("./license-2t70RAE_.mjs").then((mod) => mod.default),
+		db: () => import("./db-2G-o2xtr.mjs").then((mod) => mod.default),
+		table: () => import("./table-CpsE5VUF.mjs").then((mod) => mod.default),
+		field: () => import("./field-CzZEYFp6.mjs").then((mod) => mod.default),
+		card: () => import("./card-CtK41cpb.mjs").then((mod) => mod.default),
+		dashboard: () => import("./dashboard-GeAXKl0W.mjs").then((mod) => mod.default),
+		collection: () => import("./collection-CWYozp35.mjs").then((mod) => mod.default),
+		transform: () => import("./transform-CUxV3WSi.mjs").then((mod) => mod.default),
+		"transform-job": () => import("./transform-job-Dry0r1Xz.mjs").then((mod) => mod.default),
+		setting: () => import("./setting-DWoyNzLC.mjs").then((mod) => mod.default),
+		search: () => import("./search-CKie8hjZ.mjs").then((mod) => mod.default),
+		sync: () => import("./sync-CcYMBXTo.mjs").then((mod) => mod.default),
+		workspace: () => import("./workspace-DAlhADfI.mjs").then((mod) => mod.default),
+		setup: () => import("./setup-Cn54kGu2.mjs").then((mod) => mod.default),
+		"api-key": () => import("./api-key-d2kBtC3S.mjs").then((mod) => mod.default),
+		snippet: () => import("./snippet-TOO4F2a8.mjs").then((mod) => mod.default),
+		segment: () => import("./segment-C66MvGDy.mjs").then((mod) => mod.default),
+		measure: () => import("./measure-Bagaha3J.mjs").then((mod) => mod.default),
+		eid: () => import("./eid-CANLCfwr.mjs").then((mod) => mod.default),
+		query: () => import("./query-DR0R8J_B.mjs").then((mod) => mod.default),
+		uuid: () => import("./uuid-D9rbiLTK.mjs").then((mod) => mod.default),
+		__manifest: () => import("./manifest-DalRNBAy.mjs").then((mod) => mod.createManifestCommand(main))
 	}
 });
 var main_default = main;

package/dist/collection-CWYozp35.mjs

@@ -0,0 +1,19 @@
+import { defineCommand } from "citty";
+
+//#region src/commands/collection/index.ts
+var collection_default = defineCommand({
+	meta: {
+		name: "collection",
+		description: "Browse Metabase collections"
+	},
+	subCommands: {
+		list: () => import("./list-ehmXcC-t.mjs").then((mod) => mod.default),
+		get: () => import("./get-Dxyz8B08.mjs").then((mod) => mod.default),
+		items: () => import("./items-ZP8yJJTA.mjs").then((mod) => mod.default),
+		tree: () => import("./tree-DZNnXYjb.mjs").then((mod) => mod.default),
+		create: () => import("./create-lYoy27zG.mjs").then((mod) => mod.default)
+	}
+});
+
+//#endregion
+export { collection_default as default };

package/dist/{collection-BsiGRKXh.mjs → collection-DFqH6N7s.mjs}

@@ -104,10 +104,10 @@ const CollectionItem = z.object({
 	model: CollectionItemModel,
 	name: z.string(),
 	description: z.string().nullable().optional(),
-	archived: z.boolean(),
+	archived: z.boolean().nullable(),
 	collection_id: CollectionId.nullable().optional(),
 	collection_position: z.number().int().nullable().optional(),
-	display: z.string().optional(),
+	display: z.string().nullable().optional(),
 	location: z.string().nullable().optional(),
 	entity_id: z.string().nullable().optional(),
 	database_id: z.number().int().nullable().optional(),

package/dist/{create-CeaThiSk.mjs → create-BL84c0N2.mjs}

@@ -1,12 +1,12 @@
-import "./package-CtkDnX1U.mjs";
+import "./package-BPEXn1Of.mjs";
 import "./command-augment-D9pI9Vbh.mjs";
-import { renderItem } from "./render-BYWlZPEH.mjs";
-import "./errors-C6w1eZ1F.mjs";
-import "./input-DMcm_A5s.mjs";
-import { connectionFlags, defineMetabaseCommand, outputFlags, profileFlag } from "./runtime-BfWVLqFk.mjs";
-import { readBody } from "./body-D_BRIb1g.mjs";
+import { renderItem } from "./render-D8GOkk4P.mjs";
+import "./errors-DqPLKwoK.mjs";
+import "./input-a1VFtFBh.mjs";
+import { connectionFlags, defineMetabaseCommand, outputFlags, profileFlag } from "./runtime-Dwaw7sqU.mjs";
+import { readBody } from "./body-C2lo4Axp.mjs";
 import { bodyInputFlags } from "./body-flags-BK7J6Daz.mjs";
-import { Workspace, WorkspaceCreateInput, workspaceView } from "./workspace-D93cDL8-.mjs";
+import { Workspace, WorkspaceCreateInput, workspaceView } from "./workspace-jfsegcq8.mjs";
 
 //#region src/commands/workspace/create.ts
 var create_default = defineMetabaseCommand({

package/dist/{create-DObs_ZQY.mjs → create-CVRcTydU.mjs}

@@ -1,12 +1,12 @@
-import "./package-CtkDnX1U.mjs";
+import "./package-BPEXn1Of.mjs";
 import "./command-augment-D9pI9Vbh.mjs";
-import { renderItem } from "./render-BYWlZPEH.mjs";
-import "./errors-C6w1eZ1F.mjs";
-import "./input-DMcm_A5s.mjs";
-import { connectionFlags, defineMetabaseCommand, outputFlags, profileFlag } from "./runtime-BfWVLqFk.mjs";
-import { readBody } from "./body-D_BRIb1g.mjs";
+import { renderItem } from "./render-D8GOkk4P.mjs";
+import "./errors-DqPLKwoK.mjs";
+import "./input-a1VFtFBh.mjs";
+import { connectionFlags, defineMetabaseCommand, outputFlags, profileFlag } from "./runtime-Dwaw7sqU.mjs";
+import { readBody } from "./body-C2lo4Axp.mjs";
 import { bodyInputFlags } from "./body-flags-BK7J6Daz.mjs";
-import { TransformJob, TransformJobCreateInput, transformJobView } from "./transform-job-DgApCViL.mjs";
+import { TransformJob, TransformJobCreateInput, transformJobView } from "./transform-job-DZ38Xc3k.mjs";
 
 //#region src/commands/transform-job/create.ts
 var create_default = defineMetabaseCommand({

package/dist/{create-D52ykhxx.mjs → create-D5GQ3L7D.mjs}

@@ -1,13 +1,13 @@
-import "./package-CtkDnX1U.mjs";
+import "./package-BPEXn1Of.mjs";
 import "./command-augment-D9pI9Vbh.mjs";
-import { renderItem } from "./render-BYWlZPEH.mjs";
-import "./errors-C6w1eZ1F.mjs";
-import "./input-DMcm_A5s.mjs";
-import { connectionFlags, defineMetabaseCommand, outputFlags, profileFlag } from "./runtime-BfWVLqFk.mjs";
-import { readBody } from "./body-D_BRIb1g.mjs";
+import { renderItem } from "./render-D8GOkk4P.mjs";
+import "./errors-DqPLKwoK.mjs";
+import "./input-a1VFtFBh.mjs";
+import { connectionFlags, defineMetabaseCommand, outputFlags, profileFlag } from "./runtime-Dwaw7sqU.mjs";
+import { readBody } from "./body-C2lo4Axp.mjs";
 import { bodyInputFlags } from "./body-flags-BK7J6Daz.mjs";
-import { requireBothOrNeither } from "./flag-pair-Dz-mbq0z.mjs";
-import { parseId } from "./parse-id-jvzdqaO1.mjs";
+import { requireBothOrNeither } from "./flag-pair-Byca1x-Q.mjs";
+import { parseId } from "./parse-id-BqO2IY1b.mjs";
 import { z } from "zod";
 
 //#region src/domain/api-key.ts

package/dist/{create-BLntykb-.mjs → create-D_WX4JYl.mjs}

@@ -1,12 +1,12 @@
-import "./package-CtkDnX1U.mjs";
+import "./package-BPEXn1Of.mjs";
 import "./command-augment-D9pI9Vbh.mjs";
-import { renderItem } from "./render-BYWlZPEH.mjs";
-import "./errors-C6w1eZ1F.mjs";
-import "./input-DMcm_A5s.mjs";
-import { connectionFlags, defineMetabaseCommand, outputFlags, profileFlag } from "./runtime-BfWVLqFk.mjs";
-import { readBody } from "./body-D_BRIb1g.mjs";
+import { renderItem } from "./render-D8GOkk4P.mjs";
+import "./errors-DqPLKwoK.mjs";
+import "./input-a1VFtFBh.mjs";
+import { connectionFlags, defineMetabaseCommand, outputFlags, profileFlag } from "./runtime-Dwaw7sqU.mjs";
+import { readBody } from "./body-C2lo4Axp.mjs";
 import { bodyInputFlags } from "./body-flags-BK7J6Daz.mjs";
-import { Measure, MeasureCreateInput, measureView } from "./measure-B1GKcZxO.mjs";
+import { Measure, MeasureCreateInput, measureView } from "./measure-jbc7fsCs.mjs";
 
 //#region src/commands/measure/create.ts
 var create_default = defineMetabaseCommand({

package/dist/{create-CXqsPb0D.mjs → create-Dh7YG1mO.mjs}

@@ -1,12 +1,12 @@
-import "./package-CtkDnX1U.mjs";
+import "./package-BPEXn1Of.mjs";
 import "./command-augment-D9pI9Vbh.mjs";
-import { renderItem } from "./render-BYWlZPEH.mjs";
-import "./errors-C6w1eZ1F.mjs";
-import "./input-DMcm_A5s.mjs";
-import { connectionFlags, defineMetabaseCommand, outputFlags, profileFlag } from "./runtime-BfWVLqFk.mjs";
-import { readBody } from "./body-D_BRIb1g.mjs";
+import { renderItem } from "./render-D8GOkk4P.mjs";
+import "./errors-DqPLKwoK.mjs";
+import "./input-a1VFtFBh.mjs";
+import { connectionFlags, defineMetabaseCommand, outputFlags, profileFlag } from "./runtime-Dwaw7sqU.mjs";
+import { readBody } from "./body-C2lo4Axp.mjs";
 import { bodyInputFlags } from "./body-flags-BK7J6Daz.mjs";
-import { Snippet, SnippetCreateInput, snippetView } from "./snippet-DRTklDg3.mjs";
+import { Snippet, SnippetCreateInput, snippetView } from "./snippet-CBTV07b-.mjs";
 
 //#region src/commands/snippet/create.ts
 var create_default = defineMetabaseCommand({