@metabase/cli 0.1.12 → 0.1.14

package/README.md

@@ -1,6 +1,6 @@
 # metabase-cli
 
-Command-line client for Metabase. Authenticates against an instance with an API key and stores it securely on your machine.
+Command-line client for Metabase. Logs in to an instance in your browser (OAuth, Metabase v62+) or with an API key, and stores credentials securely on your machine.
 
 ## Supported Metabase versions
 
@@ -11,7 +11,7 @@ Commands that need more than a baseline OSS server declare it — a higher minim
 - the server is older than the command's minimum version, or
 - the command needs a premium feature (e.g. `remote_sync`, `transforms`) that isn't enabled.
 
-Plain OSS commands against a v0.58+ server (the majority) carry no elevated requirement and skip the preflight entirely. When a gated command runs but the server version can't be detected (no cached probe), it proceeds with a warning rather than refusing. To bypass the check for a single run, pass `--skip-preflight`; to bypass it process-wide (e.g. in CI), set `METABASE_CLI_SKIP_PREFLIGHT=1`. Both are footguns — only for servers you know are patched.
+Plain OSS commands against a v0.58+ server (the majority) carry no elevated requirement and skip the preflight entirely. When a gated command runs but the server version can't be detected (no cached probe), it proceeds with a warning rather than refusing. To bypass the check for a single run, pass `--skip-preflight`; to bypass it process-wide (e.g. in CI), set `MB_CLI_SKIP_PREFLIGHT=1`. Both are footguns — only for servers you know are patched.
 
 ## Install
 
@@ -43,25 +43,34 @@ Credentials are stored per-profile. The default profile is named `default`. Use
 
 ### `mb auth login`
 
-Save credentials for a profile. On success the server is probed once — the rendered output shows the API-key user, role (`Admin`/`User`), and Metabase version, and the same values are cached in `<configDir>/profiles.json` so later commands skip re-probing. Failure of either the auth probe (`/api/user/current`) or the server probe (`/api/session/properties`) rejects the login; an existing profile keeps its last-known-good `apiKey`/`url`/`lastProbe` and gains a `lastFailure` entry.
+Log in to a Metabase instance and save the credential to a profile. Interactive login offers two methods:
 
-| Flag                     | Description                                                |
-| ------------------------ | ---------------------------------------------------------- |
-| `--url <url>`            | Metabase URL. Falls back to `METABASE_URL`, then prompts.  |
-| `--api-key <value>`      | API key. Visible in shell history — pipe on stdin instead. |
-| `--profile <name>`, `-p` | Profile to write to (default: `default`).                  |
-| `--skip-verify`          | Save without contacting the server (no probe, no cache).   |
+- **In your browser** (recommended; requires Metabase v62 or newer) — the CLI opens Metabase, you sign in with your password or SSO and approve the CLI, and a short-lived access token plus a rotating refresh token are stored. Tokens refresh automatically; you never paste a secret.
+- **With an API key** — paste a key from Admin settings → Authentication → API keys.
 
-Resolution order for the API key: `--api-key` → piped stdin → `METABASE_API_KEY` → interactive prompt. Stdin is auto-detected when not a TTY.
+Against a server older than v62 the CLI detects the missing OAuth support and falls back to the API key prompt automatically. Supplying an API key (flag, env, or stdin) always skips the browser flow, so CI and scripts behave exactly as before.
+
+On success the server is probed once — the rendered output shows the user, role (`Admin`/`User`), and Metabase version, and the same values are cached in `<configDir>/profiles.json` so later commands skip re-probing. Failure of either the auth probe (`/api/user/current`) or the server probe (`/api/session/properties`) rejects the login; an existing profile keeps its last-known-good credential and gains a `lastFailure` entry.
+
+| Flag                     | Description                                                                                                                                    |
+| ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------- |
+| `--url <url>`            | Metabase URL, including any subpath if the instance is hosted under one (`https://my.org.com/metabase`). Falls back to `MB_URL`, then prompts. |
+| `--api-key <value>`      | API key. Skips the browser flow. Visible in shell history — pipe on stdin instead.                                                             |
+| `--client-id <id>`       | Pre-registered OAuth client id (only needed when dynamic client registration is disabled on the server).                                       |
+| `--profile <name>`, `-p` | Profile to write to (default: `default`).                                                                                                      |
+| `--skip-verify`          | Save without contacting the server (no probe, no cache).                                                                                       |
+
+Non-interactive (non-TTY) login requires an API key; resolution order: `--api-key` → piped stdin → `MB_API_KEY` (first non-empty wins). Without one, non-interactive login fails rather than prompting.
 
 ```sh
+mb auth login                                            # interactive: browser or API key
 echo "$MB_KEY" | mb auth login --url https://m.example.com
 mb auth login --url https://m.example.com < key.txt
 ```
 
 ### `mb auth status`
 
-Show whether a profile is authenticated.
+Show whether a profile is authenticated. The output includes the auth method (`OAuth` or `API key`) alongside the cached user, role, and server version.
 
 ```sh
 mb auth status
@@ -76,9 +85,9 @@ mb auth status --profile staging
 
 ### `mb auth list`
 
-List configured authentication profiles. All profile metadata (URL, last successful probe, last failure) lives in `<configDir>/profiles.json` at mode `0600`; the API key sits in the OS keychain when available, or inline in the same file when the keychain is unavailable.
+List configured authentication profiles. All profile metadata (URL, auth method, last successful probe, last failure) lives in `<configDir>/profiles.json` at mode `0600`; the secrets (API key, or OAuth access/refresh tokens) sit in the OS keychain when available, or inline in the same file when the keychain is unavailable.
 
-`auth list` re-probes every profile in parallel — on success it refreshes `lastProbe` (Metabase version, token features, API-key user identity) and clears `lastFailure`; on failure it updates `lastFailure` and leaves the prior `lastProbe`/`url`/`apiKey` untouched. Rendered columns: `Profile | URL | Status | Role | Version | Last probed`. Failed rows append a one-line footer pointing at `mb auth login --profile <name>`.
+`auth list` re-probes every profile, one at a time — a probe can refresh and rewrite an expired OAuth token, so probes are serialized to avoid racing on the shared `profiles.json`. On success it refreshes `lastProbe` (Metabase version, token features, user identity) and clears `lastFailure`; on failure it updates `lastFailure` and leaves the prior `lastProbe`/`url`/credential untouched. Rendered columns: `Profile | URL | Auth | Status | Role | Version | Last probed`. Failed rows append a one-line footer pointing at `mb auth login --profile <name>`.
 
 ```sh
 mb auth list
@@ -91,7 +100,7 @@ mb auth list --json
 
 ### `mb auth logout`
 
-Clear stored credentials for a profile.
+Clear stored credentials for a profile. For an OAuth profile the refresh token is also revoked server-side, best-effort: local credentials are cleared first and a revocation failure only warns, so a slow or offline server never blocks the logout.
 
 ```sh
 mb auth logout --yes
@@ -120,6 +129,14 @@ mb transform list --json
 mb transform get 1 --json
 ```
 
+### `mb transform dependencies <id>`
+
+List the upstream transforms this transform depends on (the ones that must run before it). The positional id is a transform id.
+
+```sh
+mb transform dependencies 1 --json
+```
+
 ### `mb transform create`
 
 ```sh
@@ -242,6 +259,73 @@ mb transform-job delete 1 --yes
 | ------- | --------------------------------------------------------------------------------------------------------------------------------- |
 | `--yes` | Skip the interactive confirmation prompt. In non-TTY contexts the prompt is skipped automatically (kubectl/gh/docker convention). |
 
+### `mb transform-job run <id>`
+
+Trigger a job manually and return immediately. The job runs every transform carrying one of the job's tags, plus those transforms' dependencies.
+
+```sh
+mb transform-job run 1
+mb transform-job run 1 --force-refresh --json
+```
+
+| Flag              | Description                                                                                         |
+| ----------------- | --------------------------------------------------------------------------------------------------- |
+| `--force-refresh` | Re-run the whole plan, including dependency transforms that are already fresh (skipped by default). |
+
+### `mb transform-job transforms <id>`
+
+List the transforms a job would run, resolved by the job's tags. The positional id is a job id.
+
+```sh
+mb transform-job transforms 1 --json
+```
+
+### `mb transform-job set-active <true|false>`
+
+Activate or deactivate every transform job at once (admin only). Inactive jobs do not run on schedule; manual runs ignore the flag.
+
+```sh
+mb transform-job set-active false
+mb transform-job set-active true --json
+```
+
+## Transform tags
+
+CRUD on `/api/transform-tag`. Tags group transforms and jobs; reference them by id via the `tag_ids` field on a transform or job. The four built-in tags (`hourly`, `daily`, `weekly`, `monthly`) drive the built-in jobs. There is no get-by-id endpoint — use `list`.
+
+### `mb transform-tag list`
+
+```sh
+mb transform-tag list --json
+```
+
+### `mb transform-tag create`
+
+```sh
+mb transform-tag create --body '{"name":"nightly"}'
+```
+
+| Flag            | Description             |
+| --------------- | ----------------------- |
+| `--body <json>` | Inline JSON body.       |
+| `--file <path>` | Path to JSON body file. |
+
+### `mb transform-tag update <id>`
+
+```sh
+mb transform-tag update 5 --body '{"name":"renamed"}'
+```
+
+### `mb transform-tag delete <id>`
+
+```sh
+mb transform-tag delete 5 --yes
+```
+
+| Flag    | Description                                                                                                                       |
+| ------- | --------------------------------------------------------------------------------------------------------------------------------- |
+| `--yes` | Skip the interactive confirmation prompt. In non-TTY contexts the prompt is skipped automatically (kubectl/gh/docker convention). |
+
 ## Databases
 
 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.
@@ -1357,14 +1441,17 @@ Exit codes: `0` success, `2` `ConfigError` (missing name, unknown name, `MB_SKIL
 
 ## Environment variables
 
-| Variable                      | Effect                                                                                                                                                                    |
-| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `METABASE_URL`                | Default URL for `auth login` and config resolution.                                                                                                                       |
-| `METABASE_API_KEY`            | Default API key (overrides interactive prompt; not stored).                                                                                                               |
-| `METABASE_PROFILE`            | Default profile when `--profile` is omitted. Falls back to `default`.                                                                                                     |
-| `METABASE_VERBOSE`            | When set to `1`, prints structured developer-detail JSON to stderr on failure.                                                                                            |
-| `METABASE_CLI_SKIP_PREFLIGHT` | When set to `1`, bypasses the per-command server version / token-feature preflight check. Escape hatch for patched Metabase builds; can mask real compatibility problems. |
-| `MB_SKILLS_DIR`               | Override the directory `mb skills` scans (dev/test only; defaults to the CLI's bundled `skills` + `skill-data` trees).                                                    |
+| Variable                 | Effect                                                                                                                                                                    |
+| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `MB_URL`                 | Default URL for `auth login` and config resolution.                                                                                                                       |
+| `MB_API_KEY`             | Default API key (makes `auth login` non-interactive, skipping the browser flow; not stored).                                                                              |
+| `MB_PROFILE`             | Default profile when `--profile` is omitted. Falls back to `default`.                                                                                                     |
+| `MB_VERBOSE`             | When set to `1`, prints structured developer-detail JSON to stderr on failure.                                                                                            |
+| `MB_CLI_SKIP_PREFLIGHT`  | When set to `1`, bypasses the per-command server version / token-feature preflight check. Escape hatch for patched Metabase builds; can mask real compatibility problems. |
+| `MB_CLI_DISABLE_KEYRING` | When set to `1`, skips the OS keychain and stores credentials as plaintext in the profiles file.                                                                          |
+| `MB_SKILLS_DIR`          | Override the directory `mb skills` scans (dev/test only; defaults to the CLI's bundled `skills` + `skill-data` trees).                                                    |
+
+The former `METABASE_`-prefixed names (`METABASE_URL`, `METABASE_API_KEY`, `METABASE_PROFILE`, `METABASE_VERBOSE`, `METABASE_CLI_SKIP_PREFLIGHT`, `METABASE_CLI_DISABLE_KEYRING`) are deprecated but still honored; the CLI prints a one-line warning to stderr when it falls back to one. Switch to the `MB_`-prefixed names.
 
 ## Agent integration
 

package/dist/add-collection-Cdhj6DJb.mjs

@@ -0,0 +1,10 @@
+import "./command-augment-CAur0XOQ.mjs";
+import "./error-BOi_ux9O.mjs";
+import "./runtime-7JTC-usO.mjs";
+import "./capabilities-BX1rnVuH.mjs";
+import "./parse-id-DMs04KM3.mjs";
+import "./poll-13tgWrN_.mjs";
+import "./poll-task-BuAHsDEK.mjs";
+import { SyncSettingsUpdateResult, add_collection_default, setCollectionRemoteSynced, syncSettingsUpdateView } from "./add-collection-Cubho2HN.mjs";
+
+export { add_collection_default as default };

package/dist/{add-collection-DEME4IOy.mjs → add-collection-Cubho2HN.mjs}

@@ -1,8 +1,8 @@
-import { connectionFlags, outputFlags, profileFlag } from "./error-BGH4gxGN.mjs";
-import { defineMetabaseCommand } from "./runtime-DgHh4T6t.mjs";
-import { renderSummary } from "./capabilities-7L9GVMd_.mjs";
-import { parseId } from "./parse-id-sKNP6yu5.mjs";
-import { REMOTE_SYNC_PATHS } from "./poll-task-BG0oVnfZ.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-BOi_ux9O.mjs";
+import { defineMetabaseCommand } from "./runtime-7JTC-usO.mjs";
+import { renderSummary } from "./capabilities-BX1rnVuH.mjs";
+import { parseId } from "./parse-id-DMs04KM3.mjs";
+import { REMOTE_SYNC_PATHS } from "./poll-task-BuAHsDEK.mjs";
 import { z } from "zod";
 
 //#region src/commands/git-sync/add-collection.ts

package/dist/{archive-CMeTr8jv.mjs → archive-BBboJ-z3.mjs}

@@ -1,9 +1,9 @@
-import "./command-augment-BH9qgQ5u.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-BGH4gxGN.mjs";
-import { defineMetabaseCommand } from "./runtime-DgHh4T6t.mjs";
-import { renderSummary } from "./capabilities-7L9GVMd_.mjs";
-import { parseId } from "./parse-id-sKNP6yu5.mjs";
-import { Dashboard, dashboardView } from "./dashboard-FY5UzJ_Z.mjs";
+import "./command-augment-CAur0XOQ.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-BOi_ux9O.mjs";
+import { defineMetabaseCommand } from "./runtime-7JTC-usO.mjs";
+import { renderSummary } from "./capabilities-BX1rnVuH.mjs";
+import { parseId } from "./parse-id-DMs04KM3.mjs";
+import { Dashboard, dashboardView } from "./dashboard-B4bn3z6t.mjs";
 
 //#region src/commands/dashboard/archive.ts
 var archive_default = defineMetabaseCommand({

package/dist/{archive-DUlrUlok.mjs → archive-BrzOTxSA.mjs}

@@ -1,9 +1,9 @@
-import "./command-augment-BH9qgQ5u.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-BGH4gxGN.mjs";
-import { defineMetabaseCommand } from "./runtime-DgHh4T6t.mjs";
-import { renderSummary } from "./capabilities-7L9GVMd_.mjs";
-import { parseId } from "./parse-id-sKNP6yu5.mjs";
-import { Snippet, snippetView } from "./snippet-BZvo05ua.mjs";
+import "./command-augment-CAur0XOQ.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-BOi_ux9O.mjs";
+import { defineMetabaseCommand } from "./runtime-7JTC-usO.mjs";
+import { renderSummary } from "./capabilities-BX1rnVuH.mjs";
+import { parseId } from "./parse-id-DMs04KM3.mjs";
+import { Snippet, snippetView } from "./snippet-NNzqlksR.mjs";
 
 //#region src/commands/snippet/archive.ts
 var archive_default = defineMetabaseCommand({

package/dist/{archive-BNioNJtG.mjs → archive-C8G0KIPI.mjs}

@@ -1,10 +1,10 @@
-import "./command-augment-BH9qgQ5u.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-BGH4gxGN.mjs";
-import { defineMetabaseCommand } from "./runtime-DgHh4T6t.mjs";
-import { renderSummary } from "./capabilities-7L9GVMd_.mjs";
-import "./field-MGxpNQUH.mjs";
-import { Card, cardView } from "./card-DnIeMmUn.mjs";
-import { parseId } from "./parse-id-sKNP6yu5.mjs";
+import "./command-augment-CAur0XOQ.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-BOi_ux9O.mjs";
+import { defineMetabaseCommand } from "./runtime-7JTC-usO.mjs";
+import { renderSummary } from "./capabilities-BX1rnVuH.mjs";
+import "./field-E0IBy4Uw.mjs";
+import { Card, cardView } from "./card-wCPcuKSi.mjs";
+import { parseId } from "./parse-id-DMs04KM3.mjs";
 
 //#region src/commands/card/archive.ts
 var archive_default = defineMetabaseCommand({

package/dist/{archive-BtDvBsr8.mjs → archive-D6eMYNI5.mjs}

@@ -1,9 +1,9 @@
-import "./command-augment-BH9qgQ5u.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-BGH4gxGN.mjs";
-import { defineMetabaseCommand } from "./runtime-DgHh4T6t.mjs";
-import { renderSummary } from "./capabilities-7L9GVMd_.mjs";
-import { parseId } from "./parse-id-sKNP6yu5.mjs";
-import { Collection, collectionView } from "./collection-BPTlcFw5.mjs";
+import "./command-augment-CAur0XOQ.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-BOi_ux9O.mjs";
+import { defineMetabaseCommand } from "./runtime-7JTC-usO.mjs";
+import { renderSummary } from "./capabilities-BX1rnVuH.mjs";
+import { parseId } from "./parse-id-DMs04KM3.mjs";
+import { Collection, collectionView } from "./collection-Deiziuu2.mjs";
 
 //#region src/commands/collection/archive.ts
 var archive_default = defineMetabaseCommand({

package/dist/{archive-BFk-oupo.mjs → archive-DCIwtfv0.mjs}

@@ -1,9 +1,9 @@
-import "./command-augment-BH9qgQ5u.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-BGH4gxGN.mjs";
-import { defineMetabaseCommand } from "./runtime-DgHh4T6t.mjs";
-import { renderSummary } from "./capabilities-7L9GVMd_.mjs";
-import { parseId } from "./parse-id-sKNP6yu5.mjs";
-import { Document, documentView } from "./document-CcfiiV3b.mjs";
+import "./command-augment-CAur0XOQ.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-BOi_ux9O.mjs";
+import { defineMetabaseCommand } from "./runtime-7JTC-usO.mjs";
+import { renderSummary } from "./capabilities-BX1rnVuH.mjs";
+import { parseId } from "./parse-id-DMs04KM3.mjs";
+import { Document, documentView } from "./document-qfwR0r63.mjs";
 
 //#region src/commands/document/archive.ts
 var archive_default = defineMetabaseCommand({

package/dist/{archive-MTTQv3wR.mjs → archive-DTN6Anme.mjs}

@@ -1,10 +1,10 @@
-import "./command-augment-BH9qgQ5u.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-BGH4gxGN.mjs";
-import { defineMetabaseCommand } from "./runtime-DgHh4T6t.mjs";
-import { renderSummary } from "./capabilities-7L9GVMd_.mjs";
-import { parseId } from "./parse-id-sKNP6yu5.mjs";
-import { Measure, measureView } from "./measure-COGAoZpo.mjs";
-import { revisionMessageFlag } from "./revision-message-flag-Bo-Kvv6F.mjs";
+import "./command-augment-CAur0XOQ.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-BOi_ux9O.mjs";
+import { defineMetabaseCommand } from "./runtime-7JTC-usO.mjs";
+import { renderSummary } from "./capabilities-BX1rnVuH.mjs";
+import { parseId } from "./parse-id-DMs04KM3.mjs";
+import { Measure, measureView } from "./measure-JJAdFoqK.mjs";
+import { revisionMessageFlag } from "./revision-message-flag-C7zBeWEt.mjs";
 
 //#region src/commands/measure/archive.ts
 var archive_default = defineMetabaseCommand({

package/dist/{archive-Dc-FwNZm.mjs → archive-F2g-bAXf.mjs}

@@ -1,10 +1,10 @@
-import "./command-augment-BH9qgQ5u.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-BGH4gxGN.mjs";
-import { defineMetabaseCommand } from "./runtime-DgHh4T6t.mjs";
-import { renderSummary } from "./capabilities-7L9GVMd_.mjs";
-import { parseId } from "./parse-id-sKNP6yu5.mjs";
-import { revisionMessageFlag } from "./revision-message-flag-Bo-Kvv6F.mjs";
-import { Segment, segmentView } from "./segment-d-708KKO.mjs";
+import "./command-augment-CAur0XOQ.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-BOi_ux9O.mjs";
+import { defineMetabaseCommand } from "./runtime-7JTC-usO.mjs";
+import { renderSummary } from "./capabilities-BX1rnVuH.mjs";
+import { parseId } from "./parse-id-DMs04KM3.mjs";
+import { revisionMessageFlag } from "./revision-message-flag-C7zBeWEt.mjs";
+import { Segment, segmentView } from "./segment-B9SEv9V_.mjs";
 
 //#region src/commands/segment/archive.ts
 var archive_default = defineMetabaseCommand({

package/dist/auth-D4cXDeiH.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-BF6LkxPI.mjs").then((m) => m.default),
+		status: () => import("./status-BocNdqNq.mjs").then((m) => m.default),
+		list: () => import("./list-CRUjh592.mjs").then((m) => m.default),
+		logout: () => import("./logout-Cg8Z_XD_.mjs").then((m) => m.default)
+	}
+});
+
+//#endregion
+export { auth_default as default };

package/dist/{body-89w3r7In.mjs → body-CXpIB6hY.mjs}

@@ -1,6 +1,6 @@
-import { ConfigError } from "./command-augment-BH9qgQ5u.mjs";
-import { parseJson } from "./runtime-DgHh4T6t.mjs";
-import { DEFAULT_FLAG_NAME, readInput } from "./input-BZwm4yby.mjs";
+import { ConfigError } from "./command-augment-CAur0XOQ.mjs";
+import { parseJson } from "./runtime-7JTC-usO.mjs";
+import { DEFAULT_FLAG_NAME, readInput } from "./input-BXWgdKiS.mjs";
 
 //#region src/runtime/body.ts
 async function readBody(sources, schema) {

package/dist/{branches-DuVKH8Ye.mjs → branches-r9SVJIV5.mjs}

@@ -1,9 +1,9 @@
-import "./command-augment-BH9qgQ5u.mjs";
-import { connectionFlags, listEnvelopeSchema, outputFlags, profileFlag, wrapList } from "./error-BGH4gxGN.mjs";
-import { defineMetabaseCommand } from "./runtime-DgHh4T6t.mjs";
-import { renderList } from "./capabilities-7L9GVMd_.mjs";
-import "./poll-Cyw-dQi4.mjs";
-import { REMOTE_SYNC_PATHS } from "./poll-task-BG0oVnfZ.mjs";
+import "./command-augment-CAur0XOQ.mjs";
+import { connectionFlags, listEnvelopeSchema, outputFlags, profileFlag, wrapList } from "./error-BOi_ux9O.mjs";
+import { defineMetabaseCommand } from "./runtime-7JTC-usO.mjs";
+import { renderList } from "./capabilities-BX1rnVuH.mjs";
+import "./poll-13tgWrN_.mjs";
+import { REMOTE_SYNC_PATHS } from "./poll-task-BuAHsDEK.mjs";
 import { z } from "zod";
 
 //#region src/commands/git-sync/branches.ts

package/dist/{cancel-BEMQKVuR.mjs → cancel-BbLZsVYQ.mjs}

@@ -1,8 +1,8 @@
-import "./command-augment-BH9qgQ5u.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-BGH4gxGN.mjs";
-import { defineMetabaseCommand } from "./runtime-DgHh4T6t.mjs";
-import { renderSummary } from "./capabilities-7L9GVMd_.mjs";
-import { parseId } from "./parse-id-sKNP6yu5.mjs";
+import "./command-augment-CAur0XOQ.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-BOi_ux9O.mjs";
+import { defineMetabaseCommand } from "./runtime-7JTC-usO.mjs";
+import { renderSummary } from "./capabilities-BX1rnVuH.mjs";
+import { parseId } from "./parse-id-DMs04KM3.mjs";
 import { z } from "zod";
 
 //#region src/commands/transform/cancel.ts

package/dist/{cancel-task-D2mSPFXO.mjs → cancel-task-CojB-8XX.mjs}

@@ -1,9 +1,9 @@
-import "./command-augment-BH9qgQ5u.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-BGH4gxGN.mjs";
-import { defineMetabaseCommand } from "./runtime-DgHh4T6t.mjs";
-import { renderSummary } from "./capabilities-7L9GVMd_.mjs";
-import "./poll-Cyw-dQi4.mjs";
-import { REMOTE_SYNC_PATHS, SyncTask, syncTaskView } from "./poll-task-BG0oVnfZ.mjs";
+import "./command-augment-CAur0XOQ.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-BOi_ux9O.mjs";
+import { defineMetabaseCommand } from "./runtime-7JTC-usO.mjs";
+import { renderSummary } from "./capabilities-BX1rnVuH.mjs";
+import "./poll-13tgWrN_.mjs";
+import { REMOTE_SYNC_PATHS, SyncTask, syncTaskView } from "./poll-task-BuAHsDEK.mjs";
 
 //#region src/commands/git-sync/cancel-task.ts
 var cancel_task_default = defineMetabaseCommand({

package/dist/{capabilities-7L9GVMd_.mjs → capabilities-BX1rnVuH.mjs}

@@ -1,4 +1,4 @@
-import { ConfigError } from "./command-augment-BH9qgQ5u.mjs";
+import { ConfigError, itemOversizeMessage, listTruncationNotice, warn } from "./command-augment-CAur0XOQ.mjs";
 import { z } from "zod";
 import Table from "cli-table3";
 
@@ -7,18 +7,6 @@ function isPlainObject(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 
-//#endregion
-//#region src/output/notice.ts
-function warn(message) {
-	process.stderr.write(message + "\n");
-}
-function listTruncationNotice(bytes) {
-	return `… cut at ${bytes} bytes; rerun with --max-bytes 0`;
-}
-function itemOversizeMessage(bytes, maxBytes) {
-	return `output is ${bytes} bytes, over the ${maxBytes}-byte --max-bytes cap; narrow with --fields, or pass --max-bytes 0 to disable`;
-}
-
 //#endregion
 //#region src/output/cap.ts
 function capListEnvelope(envelope, maxBytes) {
@@ -248,4 +236,4 @@ const Capabilities = z.object({
 const BASELINE_CAPABILITIES = Object.freeze({ minVersion: 58 });
 
 //#endregion
-export { BASELINE_CAPABILITIES, Capabilities, formatScalar, isPlainObject, renderItem, renderList, renderRows, renderSummary, warn, writeJson, writeText };
+export { BASELINE_CAPABILITIES, Capabilities, formatScalar, isPlainObject, renderItem, renderList, renderRows, renderSummary, writeJson, writeText };

package/dist/card-BMN-mcxn.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-Cqvt6gpK.mjs").then((mod) => mod.default),
+		get: () => import("./get-Cs7a7s2Z.mjs").then((mod) => mod.default),
+		query: () => import("./query-x6g6unDt.mjs").then((mod) => mod.default),
+		create: () => import("./create-C5-JhEUc.mjs").then((mod) => mod.default),
+		update: () => import("./update-Co4WLVkK.mjs").then((mod) => mod.default),
+		archive: () => import("./archive-C8G0KIPI.mjs").then((mod) => mod.default)
+	}
+});
+
+//#endregion
+export { card_default as default };

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

@@ -1,4 +1,4 @@
-import { FieldBaseType, FieldSemanticType } from "./field-MGxpNQUH.mjs";
+import { FieldBaseType, FieldSemanticType } from "./field-E0IBy4Uw.mjs";
 import { z } from "zod";
 
 //#region src/domain/card.ts

package/dist/{cards-L9jksUMD.mjs → cards-e9Wgnbnq.mjs}

@@ -1,9 +1,9 @@
-import "./command-augment-BH9qgQ5u.mjs";
-import { connectionFlags, listEnvelopeSchema, outputFlags, profileFlag, wrapList } from "./error-BGH4gxGN.mjs";
-import { defineMetabaseCommand } from "./runtime-DgHh4T6t.mjs";
-import { renderList } from "./capabilities-7L9GVMd_.mjs";
-import { parseId } from "./parse-id-sKNP6yu5.mjs";
-import { DashboardDetail, DashcardCompact, dashcardView } from "./dashboard-FY5UzJ_Z.mjs";
+import "./command-augment-CAur0XOQ.mjs";
+import { connectionFlags, listEnvelopeSchema, outputFlags, profileFlag, wrapList } from "./error-BOi_ux9O.mjs";
+import { defineMetabaseCommand } from "./runtime-7JTC-usO.mjs";
+import { renderList } from "./capabilities-BX1rnVuH.mjs";
+import { parseId } from "./parse-id-DMs04KM3.mjs";
+import { DashboardDetail, DashcardCompact, dashcardView } from "./dashboard-B4bn3z6t.mjs";
 
 //#region src/commands/dashboard/cards.ts
 const DashcardListEnvelope = listEnvelopeSchema(DashcardCompact);

package/dist/cli.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { ConfigError, flagConsumesValue, getMetabaseAugment, normalizeFlag, resolveCitty, toAliasArray } from "./command-augment-BH9qgQ5u.mjs";
-import { connectionFlags, outputFlags, package_default, profileFlag, reportError } from "./error-BGH4gxGN.mjs";
+import { ConfigError, flagConsumesValue, getMetabaseAugment, normalizeFlag, resolveCitty, toAliasArray } from "./command-augment-CAur0XOQ.mjs";
+import { connectionFlags, outputFlags, package_default, profileFlag, reportError } from "./error-BOi_ux9O.mjs";
 import { defineCommand, renderUsage, runMain } from "citty";
 
 //#region src/commands/global-flags.ts
@@ -58,29 +58,30 @@ const main = defineCommand({
 		description: package_default.description
 	},
 	subCommands: {
-		auth: () => import("./auth-CjFnuPe9.mjs").then((mod) => mod.default),
-		db: () => import("./db-4y5Z1CQw.mjs").then((mod) => mod.default),
-		table: () => import("./table-DK1B8Hzq.mjs").then((mod) => mod.default),
-		field: () => import("./field-BwUTrelF.mjs").then((mod) => mod.default),
-		card: () => import("./card-DoDpwR4t.mjs").then((mod) => mod.default),
-		dashboard: () => import("./dashboard-C5zTX345.mjs").then((mod) => mod.default),
-		collection: () => import("./collection-CF-1RIPY.mjs").then((mod) => mod.default),
-		document: () => import("./document-97l9Non_.mjs").then((mod) => mod.default),
-		transform: () => import("./transform-Dh5746zH.mjs").then((mod) => mod.default),
-		"transform-job": () => import("./transform-job-D0nRGPYN.mjs").then((mod) => mod.default),
-		setting: () => import("./setting-Licy7ZSs.mjs").then((mod) => mod.default),
-		search: () => import("./search-D7JzmvfR.mjs").then((mod) => mod.default),
-		"git-sync": () => import("./git-sync-JIMEYW-E.mjs").then((mod) => mod.default),
-		setup: () => import("./setup-BL4fqxoU.mjs").then((mod) => mod.default),
-		snippet: () => import("./snippet-C5_4nPGj.mjs").then((mod) => mod.default),
-		segment: () => import("./segment-DrZNuxsM.mjs").then((mod) => mod.default),
-		measure: () => import("./measure-BmcmxRQ3.mjs").then((mod) => mod.default),
-		eid: () => import("./eid-C8xTmR8e.mjs").then((mod) => mod.default),
-		query: () => import("./query-Dk55Wp2p.mjs").then((mod) => mod.default),
-		uuid: () => import("./uuid-BeUz8VpP.mjs").then((mod) => mod.default),
-		upgrade: () => import("./upgrade-TdaiAYbH.mjs").then((mod) => mod.default),
-		skills: () => import("./skills-Cn8FMCxG.mjs").then((mod) => mod.default),
-		__manifest: () => import("./manifest-BPHqF5LY.mjs").then((mod) => mod.createManifestCommand(main))
+		auth: () => import("./auth-D4cXDeiH.mjs").then((mod) => mod.default),
+		db: () => import("./db-q0lYg3k8.mjs").then((mod) => mod.default),
+		table: () => import("./table-Bnj8IBKx.mjs").then((mod) => mod.default),
+		field: () => import("./field-Bi_O_Sdg.mjs").then((mod) => mod.default),
+		card: () => import("./card-BMN-mcxn.mjs").then((mod) => mod.default),
+		dashboard: () => import("./dashboard-PB_c3Irl.mjs").then((mod) => mod.default),
+		collection: () => import("./collection-DZnA3zXr.mjs").then((mod) => mod.default),
+		document: () => import("./document-4TwzGwl3.mjs").then((mod) => mod.default),
+		transform: () => import("./transform-QCDItglq.mjs").then((mod) => mod.default),
+		"transform-job": () => import("./transform-job-Dawm4Lag.mjs").then((mod) => mod.default),
+		"transform-tag": () => import("./transform-tag-CN-bTSne.mjs").then((mod) => mod.default),
+		setting: () => import("./setting-6WqN3L3F.mjs").then((mod) => mod.default),
+		search: () => import("./search-Di-SFcZm.mjs").then((mod) => mod.default),
+		"git-sync": () => import("./git-sync-BOZdFF09.mjs").then((mod) => mod.default),
+		setup: () => import("./setup-DbXhTopr.mjs").then((mod) => mod.default),
+		snippet: () => import("./snippet-B-anQo6y.mjs").then((mod) => mod.default),
+		segment: () => import("./segment-DiHHHk2a.mjs").then((mod) => mod.default),
+		measure: () => import("./measure-BRzkMY5y.mjs").then((mod) => mod.default),
+		eid: () => import("./eid-C31VGHAM.mjs").then((mod) => mod.default),
+		query: () => import("./query-DnYdI0fl.mjs").then((mod) => mod.default),
+		uuid: () => import("./uuid-BL33x41p.mjs").then((mod) => mod.default),
+		upgrade: () => import("./upgrade-CavKMkQ4.mjs").then((mod) => mod.default),
+		skills: () => import("./skills-CfWrH-1L.mjs").then((mod) => mod.default),
+		__manifest: () => import("./manifest-DYeLri80.mjs").then((mod) => mod.createManifestCommand(main))
 	}
 });
 var main_default = main;

package/dist/collection-DZnA3zXr.mjs

@@ -0,0 +1,20 @@
+import { defineCommand } from "citty";
+
+//#region src/commands/collection/index.ts
+var collection_default = defineCommand({
+	meta: {
+		name: "collection",
+		description: "Manage Metabase collections"
+	},
+	subCommands: {
+		list: () => import("./list-Cz_2UyGV.mjs").then((mod) => mod.default),
+		get: () => import("./get-LJam7ZQ-.mjs").then((mod) => mod.default),
+		items: () => import("./items-BI-O48Sc.mjs").then((mod) => mod.default),
+		tree: () => import("./tree-CGh-ZG4n.mjs").then((mod) => mod.default),
+		create: () => import("./create-DFMpgUvH.mjs").then((mod) => mod.default),
+		archive: () => import("./archive-D6eMYNI5.mjs").then((mod) => mod.default)
+	}
+});
+
+//#endregion
+export { collection_default as default };

package/dist/{collection-namespace-w26SavJH.mjs → collection-namespace-DmKMqLr0.mjs}

@@ -1,5 +1,5 @@
-import { ConfigError } from "./command-augment-BH9qgQ5u.mjs";
-import { HttpError } from "./runtime-DgHh4T6t.mjs";
+import { ConfigError } from "./command-augment-CAur0XOQ.mjs";
+import { HttpError } from "./runtime-7JTC-usO.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.";