@metabase/cli 0.3.0 → 0.3.1-alpha.support-worktrees.b634907

package/skill-data/git-sync/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: git-sync
-description: Round-trip Metabase content (cards, dashboards, transforms, snippets, collections, Library-published table/field metadata) between an instance and a git remote via `mb git-sync …` — status, dirty / has-remote-changes checks, import, export (with branch guard), branches, stash, add/remove a collection from sync. Load when the user wants to "import the latest changes", "export to git", "push my changes to the repo", "open a PR with my Metabase changes", "git sync", "dirty check", "stash before pulling", "add a collection to sync", or anything `mb git-sync …`.
+description: Round-trip Metabase content (cards, dashboards, transforms, snippets, collections, Library-published table/field metadata) between an instance and a git remote via `mb git-sync …` — status, dirty / has-remote-changes checks, import, export (with branch guard), branches, stash, add/remove a collection from sync. Load when the user wants to "import the latest changes", "export to git", "push my changes to the repo", "open a PR with my Metabase changes", "git sync", "dirty check", "stash before pulling", "add a collection to sync", or anything `mb git-sync …` / `mb worktree …`. Also covers worktrees — isolated per-branch checkouts of transforms and other content — for "work on this branch in isolation", "create a worktree", "pin the profile to a worktree", "export the worktree and open a PR".
 allowed-tools: Read, Write, Edit, Bash, AskUserQuestion
 ---
 
@@ -40,6 +40,7 @@ Pulls the configured branch and applies it to the instance. Polls until the task
 | `--branch <name>` | Defaults to the `remote-sync-branch` setting; override per-call.                     |
 | `--no-wait`       | Return as soon as the task is queued; combine with `mb git-sync wait` later.         |
 | `--force`         | **Discards local Metabase-side dirty changes** (lossy). Confirm with the user first. |
+| `--merge`         | Three-way merge remote changes instead of failing on divergence. Confirm first.      |
 | `--timeout <ms>`  | Polling deadline. Default 600 000.                                                   |
 | `--interval <ms>` | Polling cadence. Default 2 000.                                                      |
 
@@ -62,6 +63,7 @@ Pushes Metabase-side changes back to the configured remote. `-m` is the commit m
 | `--branch <name>`   | Push to a specific branch instead of the configured one. |
 | `-m, --message <s>` | Commit message.                                          |
 | `--force`           | Force-push / overwrite remote. Confirm with the user.    |
+| `--merge`           | Three-way merge instead of failing on divergence.        |
 | `--no-wait`         | Don't poll.                                              |
 
 Workflow:
@@ -96,6 +98,94 @@ mb git-sync stash --profile <n>                           # export current state
 
 `stash` is the safe move when the instance has team work you don't want to lose, but you need to pivot to a different branch (`import` would discard, `export --force` would overwrite). It exports current state to a fresh branch first.
 
+## Worktrees (isolated branch checkouts)
+
+A **worktree** is a self-contained checkout of one branch's content inside the same instance. Transforms, transform tags, snippets, `transforms`-namespace collections, the Library, cards, dashboards, and documents are tagged with the worktree's id; tables and fields stay shared with the main app. It is how a chain of transforms gets built, exported, and reviewed as a PR without touching production content. Admin-only, and needs Metabase v64+ with the `remote_sync` feature.
+
+Two hard limits, up front:
+
+- **A worktree's transforms cannot be run.** `mb transform run` refuses while a worktree scope is in force, and the server rejects the run anyway. There is no workaround to find — run the transform in the main app after the branch is merged and imported, and say so rather than trying to validate the SQL by running it in the worktree.
+- **A worktree is bound to its branch for life.** No branch switching inside one; a different branch means a different worktree.
+
+### Where am I? Check before touching import/export
+
+```bash
+mb auth status --profile <n> --json | jq '.worktree'      # {id, branch} when the profile is pinned, else null
+mb git-sync status --profile <n> --json | jq '.worktree'  # the scope this command ran under
+mb worktree list --profile <n> --json                     # every worktree on the instance
+```
+
+A pinned profile pushes to the worktree's branch; an unpinned one pushes to whatever `remote-sync-branch` points at. Confusing the two is how worktree work lands on the team's tracked branch, so read the pin before the first `export`.
+
+### Preconditions before creating one
+
+1. **The user named the branch.** Create a worktree only for a branch the user asked you to work on.
+2. **A branch holds at most one worktree.** Check `mb worktree list --json` first; a duplicate fails with the server's `A worktree for branch '<b>' already exists.` — reuse it with `mb worktree pin <branch>` instead.
+3. **A pinned profile is already confined.** `mb worktree create` for any other branch is refused, because a second worktree from a pinned session would escape the pin.
+
+### The workflow
+
+```bash
+# 1. Create the worktree and pin the profile to it. Mints the branch on the remote when missing
+#    (--no-checkout, so the main app's tracked branch is untouched), then pulls the branch in.
+mb worktree create feat/order-metrics --pin --profile <n> --json
+
+# 2. Edit transforms. Scoped commands need no extra flag once the profile is pinned.
+mb transform create --file ./.scratch/transform.json --profile <n> --json
+mb transform list --profile <n> --json        # only this worktree's transforms
+mb transform update <id> --file ./.scratch/patch.json --profile <n> --json
+
+# 3. Read state before pushing — same rule as the main app.
+mb git-sync status --profile <n> --json       # branch, dirty flag, current task, all scoped
+mb git-sync dirty  --profile <n> --json       # exactly what will be committed
+
+# 4. Dry-run the push, read the answer, then push.
+mb git-sync export-preflight --profile <n> --json
+mb git-sync export -m "add order metrics transforms" --profile <n>
+
+# 5. Open the PR from the branch with plain git / gh, and let a human review and merge it.
+
+# 6. Retire the worktree once the PR is merged. This clears the pin it was holding.
+mb worktree delete feat/order-metrics --profile <n> --json
+```
+
+`export-preflight` answers `{has_changes, clean, conflicts, summary: {added, updated, removed}, force_push_casualties: {deleted, overwritten}, reason}`. Read it before every worktree export: `clean: true` with empty `conflicts` is a push that applies as-is; a non-empty `conflicts` or `force_push_casualties` is a conversation with the user, not a `--force`.
+
+The main app pulls the merged branch from a **different, unpinned** profile — `git-sync import` into the main app and `transform run` are both main-app operations and a pinned profile refuses them:
+
+```bash
+mb git-sync import --profile <main-app-profile>
+mb transform run <id> --wait --profile <main-app-profile> --json
+```
+
+### Scope precedence and what a pinned profile refuses
+
+The scope comes from `--worktree <id|branch>`, else `MB_WORKTREE`, else the profile's pin. **The pin is a lock, not a default:** while it stands, the flag and the env var may only re-state it, and naming a different worktree exits 2 with `profile "<p>" is pinned to worktree <id> (<branch>); refusing --worktree <x>`.
+
+Under a scope, a command that changes or runs main-app state refuses before any request and exits 2 — `transform run` / `cancel`, `card` / `library` writes, and the main-app git-sync verbs `stash`, `create-branch`, `add-collection`, `remove-collection`:
+
+```
+transform run is not available inside a worktree (scope: worktree 3 (feat/order-metrics) from the profile pin); it changes main-app content. Unpin the profile (`mb worktree unpin`) or drop MB_WORKTREE to run it against the main app.
+```
+
+Two more refusals belong to the scope:
+
+- Fetching a row that lives elsewhere: `transform 12 is not in worktree 3 (feat/order-metrics); refusing to touch main-app content`.
+- `--branch` on `import` / `export` / `export-preflight`: `a worktree is pinned to its branch; drop --branch`.
+
+### Confirmations these flags need
+
+- `--force` (on `import`, `export`, and `worktree delete`) and `--merge` (on `import` / `export`) are **lossy or history-rewriting** — ask the user first, with `AskUserQuestion`, naming what gets discarded. `export-preflight`'s `force_push_casualties` is the list to show them.
+- `mb worktree delete` refuses a worktree holding unpushed changes: `worktree <id> (<branch>) has unpushed changes; push them with mb git-sync export or pass --force to discard`. Export first, or ask before forcing — the content in a worktree exists nowhere else once it is gone.
+
+### Don't (worktrees)
+
+- **Don't unpin to reach the main app.** The pin is the isolation boundary a harness put there; `mb worktree unpin` to get past a refusal turns an isolated session into one that can write production content. Report the refusal and what you would need instead.
+- **Don't run a worktree's transforms**, and don't route around the refusal with `mb query`, a native card, or a second profile. Validate the query shape with `--dry-run` (see `mbql`) and run it for real in the main app after the merge.
+- **Don't create worktrees for branches you were not asked to touch.** A worktree checks a whole branch's content into the instance; an unwanted one is content to clean up, not a free experiment.
+- **Don't `git-sync export` from the main app while the work lives in a worktree.** It pushes the main app's state to the tracked branch and the worktree's edits are not in it. Check `.worktree` in `git-sync status` before exporting.
+- **Don't hand-write the branch's YAML in the repo to "help" the PR.** Worktree content round-trips through `export` exactly like main-app content — see the first entry of the general "Don't" list below.
+
 ## Polling and cancelling
 
 ```bash

package/skill-data/transform/SKILL.md

@@ -48,7 +48,7 @@ mb transform run "$TRANSFORM_ID" --wait --profile <name> --json
 - `--wait` polls until status is `succeeded` or `failed`. Without it you get only `{message: "Transform run started", run_id, final: null}` and must poll yourself — don't put bare `transform run` in a tight loop; let `--wait` do the polling.
 - `--sync` implies `--wait`, then waits until the run registers its output table (the run registers it itself — no `db sync-schema` needed), adding `target_table_id` to the envelope. Use it when you'll build MBQL on the output (see "Inspect").
 - The `--json` envelope is shape-stable: `{message, run_id, final}` (plus `target_table_id` under `--sync` — a number, or `null` if the table didn't register before the timeout). `final` is `null` when `--wait` is omitted or the run never started, otherwise a full `TransformRun` with `status` and `message`. On a failed run (`final.status` ∈ {`failed`, `timeout`, `canceled`}) the CLI exits 1 and writes a one-line `transform run <id> failed` to stderr; the failure detail lives only in `final.message` on stdout, so `jq -r '.final.message'` is where to look.
-- `transform create --json` returns the agent-facing compact projection: `{id, name, description, source_type, target: {type, database, schema, name}, target_db_id}`. Read `target.schema`/`target.name` directly off it — no follow-up `transform get`.
+- `transform create --json` returns the agent-facing compact projection: `{id, name, description, source_type, target: {type, database, schema, name}, target_db_id, worktree_id}`. Read `target.schema`/`target.name` directly off it — no follow-up `transform get`.
 - If a transform with the same `name` already has a YAML representation on disk under the configured remote-sync repo, `create` mints a `_2` suffix on the exported filename (the new transform gets a fresh `entity_id`; the prior one isn't touched). For "iterate on the same concept", prefer `transform update <id>` — see "Iterating on a failing transform".
 - **`collection_id` only accepts a collection in the `:transforms` namespace.** Transforms aren't filed next to cards and dashboards — a normal analytics collection id fails create/update with `collection_id: A Transform can only go in Collections in the :transforms namespace.` Omit `collection_id` to leave the transform uncollected (the common case), or provision one with `mb collection create --body '{"name":"…"}' --namespace transforms --json` (see `core`) and pass the returned `id`. Cards and dashboards you build **on top of** the output table go in ordinary collections — so "put the transform and its dashboard in collection X" means _X holds the dashboard + cards; the transform stays in the transforms namespace._
 
@@ -71,6 +71,14 @@ On `target_table_id: null` (still syncing when the poll timed out; exit 0) re-po
 
 Columns and types are inferred from the result set; change the SELECT shape and the next run fails on a column mismatch — drop the table first (`transform delete-table <id>`). A changed shape also needs a re-run with `--sync` before MBQL sees the new/renamed columns.
 
+## Editing transforms safely in a worktree
+
+A **worktree** is an isolated checkout of one git branch's content inside the same instance — the way to build a chain of transforms for PR review without touching production transforms or their tables. The lifecycle (create → pin → export-preflight → export → PR → delete) lives in the `git-sync` skill, section "Worktrees": **`mb skills get git-sync`**. What matters while authoring:
+
+- **`worktree_id` says where a transform lives.** `transform get` and `transform list` carry it: an integer for a worktree's transform, `null` for a main-app one. Read it before editing anything you did not create in this session — under a scope, `update` / `delete` / `delete-table` of a main-app transform is refused with `transform <id> is not in worktree <n> (<branch>); refusing to touch main-app content`.
+- **The scope is implicit once the profile is pinned.** With `--worktree <id|branch>`, `MB_WORKTREE`, or a pin in force, `transform list` shows only that worktree's transforms and `transform create` files what it creates into it. Without a scope both address the main app, whose listing excludes every worktree's rows.
+- **`transform run` is refused under a scope**, and the server rejects worktree runs anyway: `transform run is not available inside a worktree (…); it changes main-app content.` The create → run → fix loop therefore does not close inside a worktree. Validate the query with `--dry-run` (see `mbql`) before creating, iterate the body with `transform update`, and run it in the main app once the branch is merged and imported. Don't unpin, don't switch to another profile, and don't stand in a run with `mb query` — tell the user the run waits for the merge.
+
 ## Inspect runs and cancel an in-flight run
 
 ```bash

package/dist/archive-BxNPHxOY.mjs

@@ -1,32 +0,0 @@
-import { F as outputFlags, I as profileFlag, M as connectionFlags, c as renderSummary } from "./cli.mjs";
-import { t as defineMetabaseCommand } from "./runtime-DiKyBxOw.mjs";
-import { t as parseId } from "./parse-id-C_jmKFaa.mjs";
-import { r as Collection } from "./collection-CfulNRBG.mjs";
-import { n as collectionView } from "./collection-CGoVLvcD.mjs";
-//#region src/commands/collection/archive.ts
-var archive_default = defineMetabaseCommand({
-	meta: {
-		name: "archive",
-		description: "Archive (soft-delete) a collection by id"
-	},
-	capabilities: { minVersion: 58 },
-	args: {
-		...outputFlags,
-		...profileFlag,
-		...connectionFlags,
-		id: {
-			type: "positional",
-			description: "Collection id",
-			required: true
-		}
-	},
-	outputSchema: Collection,
-	examples: ["mb collection archive 4", "mb collection archive 4 --json"],
-	async run({ args, ctx, getClient }) {
-		const id = parseId(args.id);
-		const updated = await (await getClient()).collection.archive(id);
-		renderSummary(updated, collectionView, `Archived collection ${updated.id} "${updated.name}".`, ctx);
-	}
-});
-//#endregion
-export { archive_default as default };

package/dist/archive-ChORH5JH.mjs

@@ -1,32 +0,0 @@
-import { F as outputFlags, I as profileFlag, M as connectionFlags, c as renderSummary } from "./cli.mjs";
-import { t as defineMetabaseCommand } from "./runtime-DiKyBxOw.mjs";
-import { t as parseId } from "./parse-id-C_jmKFaa.mjs";
-import { t as Snippet } from "./snippet-CyKAgIZl.mjs";
-import { t as snippetView } from "./snippet-oJLaYW9V.mjs";
-//#region src/commands/snippet/archive.ts
-var archive_default = defineMetabaseCommand({
-	meta: {
-		name: "archive",
-		description: "Archive (soft-delete) a native query snippet by id"
-	},
-	capabilities: { minVersion: 58 },
-	args: {
-		...outputFlags,
-		...profileFlag,
-		...connectionFlags,
-		id: {
-			type: "positional",
-			description: "Snippet id",
-			required: true
-		}
-	},
-	outputSchema: Snippet,
-	examples: ["mb snippet archive 1", "mb snippet archive 1 --json"],
-	async run({ args, ctx, getClient }) {
-		const id = parseId(args.id);
-		const updated = await (await getClient()).snippet.archive(id);
-		renderSummary(updated, snippetView, `Archived snippet ${updated.id} "${updated.name}".`, ctx);
-	}
-});
-//#endregion
-export { archive_default as default };

package/dist/cancel-task-C5CU1pxU.mjs

@@ -1,28 +0,0 @@
-import { F as outputFlags, I as profileFlag, M as connectionFlags, c as renderSummary } from "./cli.mjs";
-import { t as defineMetabaseCommand } from "./runtime-DiKyBxOw.mjs";
-import { l as SyncTask } from "./git-sync-BDnxPrqU.mjs";
-import { c as syncTaskView } from "./git-sync-DxD_ng48.mjs";
-//#region src/commands/git-sync/cancel-task.ts
-var cancel_task_default = defineMetabaseCommand({
-	meta: {
-		name: "cancel-task",
-		description: "Cancel the running git-sync task"
-	},
-	capabilities: {
-		minVersion: 60,
-		tokenFeature: "remote_sync"
-	},
-	args: {
-		...outputFlags,
-		...profileFlag,
-		...connectionFlags
-	},
-	outputSchema: SyncTask,
-	examples: ["mb git-sync cancel-task", "mb git-sync cancel-task --json"],
-	async run({ ctx, getClient }) {
-		const task = await (await getClient()).gitSync.cancelTask();
-		renderSummary(task, syncTaskView, `Requested cancellation of ${task.sync_task_type} task #${task.id}.`, ctx);
-	}
-});
-//#endregion
-export { cancel_task_default as default };

package/dist/card-CHI2bmds.mjs

@@ -1,24 +0,0 @@
-import { t as defineCommandGroup } from "./group-DBM87IgC.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-B4hJuMhA.mjs").then((mod) => mod.default),
-		get: () => import("./get-B_xdF1kq.mjs").then((mod) => mod.default),
-		query: () => import("./query-BbqECzmF.mjs").then((mod) => mod.default),
-		alerts: () => import("./alerts-Bf2RH_p_.mjs").then((mod) => mod.default),
-		create: () => import("./create-C79vErX0.mjs").then((mod) => mod.default),
-		update: () => import("./update-CO4m4wH3.mjs").then((mod) => mod.default),
-		archive: () => import("./archive-C7w49Grr.mjs").then((mod) => mod.default)
-	}
-});
-//#endregion
-export { card_default as default };

package/dist/collection-CY0AB99E.mjs

@@ -1,20 +0,0 @@
-import { t as defineCommandGroup } from "./group-DBM87IgC.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-DMKDsBRd.mjs").then((mod) => mod.default),
-		get: () => import("./get-DkWO0EI0.mjs").then((mod) => mod.default),
-		items: () => import("./items-CQlPXBXE.mjs").then((mod) => mod.default),
-		tree: () => import("./tree-CH-f3bjP.mjs").then((mod) => mod.default),
-		create: () => import("./create-CAQV2g6V.mjs").then((mod) => mod.default),
-		archive: () => import("./archive-BxNPHxOY.mjs").then((mod) => mod.default)
-	}
-});
-//#endregion
-export { collection_default as default };

package/dist/create-branch-CYo6jZth.mjs

@@ -1,35 +0,0 @@
-import { i as ConfigError } from "./predicates-Bkm2IoeX.mjs";
-import { F as outputFlags, I as profileFlag, M as connectionFlags, c as renderSummary } from "./cli.mjs";
-import { t as defineMetabaseCommand } from "./runtime-DiKyBxOw.mjs";
-import { t as SyncBranchCreated } from "./git-sync-BDnxPrqU.mjs";
-import { t as syncBranchCreatedView } from "./git-sync-DxD_ng48.mjs";
-//#region src/commands/git-sync/create-branch.ts
-var create_branch_default = defineMetabaseCommand({
-	meta: {
-		name: "create-branch",
-		description: "Create a new branch on the git remote and switch git-sync to it"
-	},
-	capabilities: {
-		minVersion: 60,
-		tokenFeature: "remote_sync"
-	},
-	args: {
-		...outputFlags,
-		...profileFlag,
-		...connectionFlags,
-		name: {
-			type: "positional",
-			description: "Branch name",
-			required: true
-		}
-	},
-	outputSchema: SyncBranchCreated,
-	examples: ["mb git-sync create-branch feat/dashboards", "mb git-sync create-branch feat/x --json"],
-	async run({ args, ctx, getClient }) {
-		const name = args.name.trim();
-		if (name === "") throw new ConfigError("invalid name: branch name must not be blank");
-		renderSummary(await (await getClient()).gitSync.createBranch({ name }), syncBranchCreatedView, `Created branch "${name}" and switched git-sync to it.`, ctx);
-	}
-});
-//#endregion
-export { create_branch_default as default };

package/dist/dependencies-Bj3QrGIm.mjs

@@ -1,36 +0,0 @@
-import { F as outputFlags, I as profileFlag, M as connectionFlags, N as listFlags, R as listEnvelopeSchema, s as renderList } from "./cli.mjs";
-import { t as defineMetabaseCommand } from "./runtime-DiKyBxOw.mjs";
-import { t as parseId } from "./parse-id-C_jmKFaa.mjs";
-import { n as windowList } from "./window-BkvrP0gB.mjs";
-import { n as TransformCompact } from "./transform-D3QX0jxA.mjs";
-import { n as transformView } from "./transform-DoTyyXAu.mjs";
-//#region src/commands/transform/dependencies.ts
-const TransformDependenciesEnvelope = listEnvelopeSchema(TransformCompact);
-var dependencies_default = defineMetabaseCommand({
-	meta: {
-		name: "dependencies",
-		description: "List the transforms a transform depends on"
-	},
-	details: "Returns the upstream transforms in this transform's dependency graph — the ones that must run before it. The positional id is a transform id.",
-	capabilities: { minVersion: 59 },
-	args: {
-		...outputFlags,
-		...listFlags,
-		...profileFlag,
-		...connectionFlags,
-		id: {
-			type: "positional",
-			description: "Transform id",
-			required: true
-		}
-	},
-	outputSchema: TransformDependenciesEnvelope,
-	examples: ["mb transform dependencies 1", "mb transform dependencies 1 --json"],
-	async run({ args, ctx, getClient }) {
-		const id = parseId(args.id);
-		const { data } = await (await getClient()).transform.dependencies(id);
-		renderList(windowList(data, ctx.range), transformView, ctx);
-	}
-});
-//#endregion
-export { dependencies_default as default };

package/dist/dirty-DNYoM6Bp.mjs

@@ -1,31 +0,0 @@
-import { F as outputFlags, I as profileFlag, M as connectionFlags, N as listFlags, R as listEnvelopeSchema, s as renderList } from "./cli.mjs";
-import { t as defineMetabaseCommand } from "./runtime-DiKyBxOw.mjs";
-import { n as windowList } from "./window-BkvrP0gB.mjs";
-import { r as SyncDirtyItemCompact } from "./git-sync-BDnxPrqU.mjs";
-import { n as syncDirtyItemView } from "./git-sync-DxD_ng48.mjs";
-//#region src/commands/git-sync/dirty.ts
-const SyncDirtyListEnvelope = listEnvelopeSchema(SyncDirtyItemCompact);
-var dirty_default = defineMetabaseCommand({
-	meta: {
-		name: "dirty",
-		description: "List objects with unsynced local changes"
-	},
-	capabilities: {
-		minVersion: 60,
-		tokenFeature: "remote_sync"
-	},
-	args: {
-		...outputFlags,
-		...listFlags,
-		...profileFlag,
-		...connectionFlags
-	},
-	outputSchema: SyncDirtyListEnvelope,
-	examples: ["mb git-sync dirty", "mb git-sync dirty --json"],
-	async run({ ctx, getClient }) {
-		const { data } = await (await getClient()).gitSync.dirty();
-		renderList(windowList(data, ctx.range), syncDirtyItemView, ctx);
-	}
-});
-//#endregion
-export { dirty_default as default };

package/dist/document-BbskZPTT.mjs

@@ -1,19 +0,0 @@
-import { t as defineCommandGroup } from "./group-DBM87IgC.mjs";
-//#region src/commands/document/index.ts
-var document_default = defineCommandGroup({
-	name: "document",
-	description: "Manage Metabase documents",
-	skills: [{
-		skill: "document",
-		purpose: "author the ProseMirror document body"
-	}],
-	subCommands: {
-		list: () => import("./list-CNUiF8Z7.mjs").then((mod) => mod.default),
-		get: () => import("./get-D_h-G9bn.mjs").then((mod) => mod.default),
-		create: () => import("./create-tQbnuz-I.mjs").then((mod) => mod.default),
-		update: () => import("./update-D-NE60AV.mjs").then((mod) => mod.default),
-		archive: () => import("./archive-lQqs13Uz.mjs").then((mod) => mod.default)
-	}
-});
-//#endregion
-export { document_default as default };

package/dist/get-ByBOq30r.mjs

@@ -1,31 +0,0 @@
-import { F as outputFlags, I as profileFlag, M as connectionFlags, o as renderItem } from "./cli.mjs";
-import { t as defineMetabaseCommand } from "./runtime-DiKyBxOw.mjs";
-import { t as parseId } from "./parse-id-C_jmKFaa.mjs";
-import { t as Transform } from "./transform-D3QX0jxA.mjs";
-import { n as transformView } from "./transform-DoTyyXAu.mjs";
-//#region src/commands/transform/get.ts
-var get_default = defineMetabaseCommand({
-	meta: {
-		name: "get",
-		description: "Get a transform by id"
-	},
-	capabilities: { minVersion: 59 },
-	args: {
-		...outputFlags,
-		...profileFlag,
-		...connectionFlags,
-		id: {
-			type: "positional",
-			description: "Transform id",
-			required: true
-		}
-	},
-	outputSchema: Transform,
-	examples: ["mb transform get 1", "mb transform get 1 --json"],
-	async run({ args, ctx, getClient }) {
-		const id = parseId(args.id);
-		renderItem(await (await getClient()).transform.get(id), transformView, ctx);
-	}
-});
-//#endregion
-export { get_default as default };

package/dist/get-C2-Q3iQ5.mjs

@@ -1,31 +0,0 @@
-import { F as outputFlags, I as profileFlag, M as connectionFlags, o as renderItem } from "./cli.mjs";
-import { t as defineMetabaseCommand } from "./runtime-DiKyBxOw.mjs";
-import { t as parseId } from "./parse-id-C_jmKFaa.mjs";
-import { t as Snippet } from "./snippet-CyKAgIZl.mjs";
-import { t as snippetView } from "./snippet-oJLaYW9V.mjs";
-//#region src/commands/snippet/get.ts
-var get_default = defineMetabaseCommand({
-	meta: {
-		name: "get",
-		description: "Get a native query snippet by id"
-	},
-	capabilities: { minVersion: 58 },
-	args: {
-		...outputFlags,
-		...profileFlag,
-		...connectionFlags,
-		id: {
-			type: "positional",
-			description: "Snippet id",
-			required: true
-		}
-	},
-	outputSchema: Snippet,
-	examples: ["mb snippet get 1", "mb snippet get 1 --json"],
-	async run({ args, ctx, getClient }) {
-		const id = parseId(args.id);
-		renderItem(await (await getClient()).snippet.get(id), snippetView, ctx);
-	}
-});
-//#endregion
-export { get_default as default };

package/dist/get-DkWO0EI0.mjs

@@ -1,36 +0,0 @@
-import { F as outputFlags, I as profileFlag, M as connectionFlags, o as renderItem } from "./cli.mjs";
-import { t as defineMetabaseCommand } from "./runtime-DiKyBxOw.mjs";
-import { r as Collection } from "./collection-CfulNRBG.mjs";
-import { n as collectionView } from "./collection-CGoVLvcD.mjs";
-import { t as parseCollectionRef } from "./parse-ref-ibKVB0J4.mjs";
-//#region src/commands/collection/get.ts
-var get_default = defineMetabaseCommand({
-	meta: {
-		name: "get",
-		description: "Get a collection by id, 21-char entity id, or \"root\"/\"trash\""
-	},
-	capabilities: { minVersion: 58 },
-	args: {
-		...outputFlags,
-		...profileFlag,
-		...connectionFlags,
-		id: {
-			type: "positional",
-			description: "Collection id, 21-char entity id, or one of: \"root\", \"trash\"",
-			required: true
-		}
-	},
-	outputSchema: Collection,
-	examples: [
-		"mb collection get 4",
-		"mb collection get root --json",
-		"mb collection get trash --json",
-		"mb collection get voo1If9y8Sld0lXej6xl0 --json"
-	],
-	async run({ args, ctx, getClient }) {
-		const ref = parseCollectionRef(args.id);
-		renderItem(await (await getClient()).collection.get(ref), collectionView, ctx);
-	}
-});
-//#endregion
-export { get_default as default };

package/dist/git-sync-MQQYRYLg.mjs

@@ -1,28 +0,0 @@
-import { t as defineCommandGroup } from "./group-DBM87IgC.mjs";
-//#region src/commands/git-sync/index.ts
-var git_sync_default = defineCommandGroup({
-	name: "git-sync",
-	description: "Sync Metabase content with a git remote",
-	skills: [{
-		skill: "git-sync",
-		purpose: "import/export round-trip and dirty checks"
-	}],
-	subCommands: {
-		status: () => import("./status-BhswxJL1.mjs").then((mod) => mod.default),
-		"is-dirty": () => import("./is-dirty-DYeJYhBz.mjs").then((mod) => mod.default),
-		"has-remote-changes": () => import("./has-remote-changes-C684Redh.mjs").then((mod) => mod.default),
-		dirty: () => import("./dirty-DNYoM6Bp.mjs").then((mod) => mod.default),
-		"current-task": () => import("./current-task-MpBFGttd.mjs").then((mod) => mod.default),
-		"cancel-task": () => import("./cancel-task-C5CU1pxU.mjs").then((mod) => mod.default),
-		wait: () => import("./wait-DoMDH226.mjs").then((mod) => mod.default),
-		import: () => import("./import-Rmmttboo.mjs").then((mod) => mod.default),
-		export: () => import("./export-BjfoZRDJ.mjs").then((mod) => mod.default),
-		stash: () => import("./stash-D0S4JmAz.mjs").then((mod) => mod.default),
-		branches: () => import("./branches-DchlyU0i.mjs").then((mod) => mod.default),
-		"create-branch": () => import("./create-branch-CYo6jZth.mjs").then((mod) => mod.default),
-		"add-collection": () => import("./add-collection-B3Ty8SzB.mjs").then((mod) => mod.default),
-		"remove-collection": () => import("./remove-collection-BOnxYvhj.mjs").then((mod) => mod.default)
-	}
-});
-//#endregion
-export { git_sync_default as default };

package/dist/list-BOET6zhP.mjs

@@ -1,36 +0,0 @@
-import { F as outputFlags, I as profileFlag, M as connectionFlags, N as listFlags, R as listEnvelopeSchema, s as renderList } from "./cli.mjs";
-import { t as defineMetabaseCommand } from "./runtime-DiKyBxOw.mjs";
-import { n as windowList } from "./window-BkvrP0gB.mjs";
-import { n as SnippetCompact } from "./snippet-CyKAgIZl.mjs";
-import { t as snippetView } from "./snippet-oJLaYW9V.mjs";
-//#region src/commands/snippet/list.ts
-const SnippetListEnvelope = listEnvelopeSchema(SnippetCompact);
-var list_default = defineMetabaseCommand({
-	meta: {
-		name: "list",
-		description: "List native query snippets"
-	},
-	capabilities: { minVersion: 58 },
-	args: {
-		...outputFlags,
-		...listFlags,
-		...profileFlag,
-		...connectionFlags,
-		archived: {
-			type: "boolean",
-			description: "Show archived snippets instead of active ones"
-		}
-	},
-	outputSchema: SnippetListEnvelope,
-	examples: [
-		"mb snippet list",
-		"mb snippet list --json",
-		"mb snippet list --archived --json"
-	],
-	async run({ args, ctx, getClient }) {
-		const { data, total } = await (await getClient()).snippet.list({ archived: args.archived || void 0 });
-		renderList(windowList(data, ctx.range, total), snippetView, ctx);
-	}
-});
-//#endregion
-export { list_default as default };

package/dist/list-C5Zs8nrb.mjs

@@ -1,28 +0,0 @@
-import { F as outputFlags, I as profileFlag, M as connectionFlags, N as listFlags, R as listEnvelopeSchema, s as renderList } from "./cli.mjs";
-import { t as defineMetabaseCommand } from "./runtime-DiKyBxOw.mjs";
-import { n as windowList } from "./window-BkvrP0gB.mjs";
-import { n as TransformCompact } from "./transform-D3QX0jxA.mjs";
-import { n as transformView } from "./transform-DoTyyXAu.mjs";
-//#region src/commands/transform/list.ts
-const TransformListEnvelope = listEnvelopeSchema(TransformCompact);
-var list_default = defineMetabaseCommand({
-	meta: {
-		name: "list",
-		description: "List transforms"
-	},
-	capabilities: { minVersion: 59 },
-	args: {
-		...outputFlags,
-		...listFlags,
-		...profileFlag,
-		...connectionFlags
-	},
-	outputSchema: TransformListEnvelope,
-	examples: ["mb transform list", "mb transform list --json"],
-	async run({ ctx, getClient }) {
-		const { data } = await (await getClient()).transform.list();
-		renderList(windowList(data, ctx.range), transformView, ctx);
-	}
-});
-//#endregion
-export { list_default as default };

package/dist/list-CKK-s3Ty.mjs

@@ -1,28 +0,0 @@
-import { F as outputFlags, I as profileFlag, M as connectionFlags, N as listFlags, R as listEnvelopeSchema, s as renderList } from "./cli.mjs";
-import { t as defineMetabaseCommand } from "./runtime-DiKyBxOw.mjs";
-import { n as windowList } from "./window-BkvrP0gB.mjs";
-import { n as TransformTagCompact } from "./transform-tag-CcElGp3C.mjs";
-import { t as transformTagView } from "./transform-tag-Dmb4u3-Q.mjs";
-//#region src/commands/transform-tag/list.ts
-const TransformTagListEnvelope = listEnvelopeSchema(TransformTagCompact);
-var list_default = defineMetabaseCommand({
-	meta: {
-		name: "list",
-		description: "List transform tags"
-	},
-	capabilities: { minVersion: 59 },
-	args: {
-		...outputFlags,
-		...listFlags,
-		...profileFlag,
-		...connectionFlags
-	},
-	outputSchema: TransformTagListEnvelope,
-	examples: ["mb transform-tag list", "mb transform-tag list --json"],
-	async run({ ctx, getClient }) {
-		const { data } = await (await getClient()).transformTag.list();
-		renderList(windowList(data, ctx.range), transformTagView, ctx);
-	}
-});
-//#endregion
-export { list_default as default };