@metabase/cli 0.1.8-alpha.drop-workspaces.75fe1d5 → 0.1.9

package/README.md

@@ -152,18 +152,20 @@ mb transform delete 1 --yes
 
 ### `mb transform run <id>`
 
-Trigger a manual run. Returns `{message, run_id}` and exits immediately. Pass `--wait` to poll until the run reaches a terminal status (`succeeded`, `failed`, `timeout`, `canceled`); the `final` field on the result holds the polled run state, and the command exits 1 if the final status is anything but `succeeded`.
+Trigger a manual run. Returns `{message, run_id}` and exits immediately. Pass `--wait` to poll until the run reaches a terminal status (`succeeded`, `failed`, `timeout`, `canceled`); the `final` field on the result holds the polled run state, and the command exits 1 if the final status is anything but `succeeded`. Pass `--sync` to additionally wait until the run's output table is registered and surface its `target_table_id`, so you can build MBQL cards against it — the run registers the table itself, so no separate `db sync-schema` is needed; `--sync` implies `--wait`.
 
 ```sh
 mb transform run 1
 mb transform run 1 --wait --json
+mb transform run 1 --sync --json
 ```
 
-| Flag              | Description                                                 |
-| ----------------- | ----------------------------------------------------------- |
-| `--wait`          | Poll until the run reaches a terminal status.               |
-| `--timeout <ms>`  | Polling timeout in ms (default 600000). Used with `--wait`. |
-| `--interval <ms>` | Polling interval in ms (default 2000). Used with `--wait`.  |
+| Flag              | Description                                                                                                            |
+| ----------------- | ---------------------------------------------------------------------------------------------------------------------- |
+| `--wait`          | Poll until the run reaches a terminal status.                                                                          |
+| `--sync`          | After a successful run, wait until the output table is registered and return its `target_table_id` (implies `--wait`). |
+| `--timeout <ms>`  | Polling timeout in ms (default 600000). Used with `--wait`.                                                            |
+| `--interval <ms>` | Polling interval in ms (default 2000). Used with `--wait`.                                                             |
 
 ### `mb transform cancel <id>`
 
@@ -303,13 +305,19 @@ mb db schema-tables 1 analytics --json
 
 ### `mb db sync-schema <id>`
 
-Trigger a manual schema sync (`POST /api/database/:id/sync_schema`). Returns `{ id, status: "ok" }` once the sync has been queued; the actual work happens asynchronously on the server.
+Trigger a manual schema sync (`POST /api/database/:id/sync_schema`). Returns `{ id, status: "ok" }` once the sync has been queued; the actual work happens asynchronously on the server. Pass `--wait` to poll the database until its `initial_sync_status` reports `complete` (a database that has already finished its initial sync returns at once). To wait for a specific newly-materialized transform table to register, prefer `mb transform run <id> --sync`.
 
 ```sh
 mb db sync-schema 1
-mb db sync-schema 1 --json
+mb db sync-schema 1 --wait --json
 ```
 
+| Flag              | Description                                                 |
+| ----------------- | ----------------------------------------------------------- |
+| `--wait`          | Poll until `initial_sync_status` reports `complete`.        |
+| `--timeout <ms>`  | Polling timeout in ms (default 600000). Used with `--wait`. |
+| `--interval <ms>` | Polling interval in ms (default 2000). Used with `--wait`.  |
+
 ### `mb db rescan-values <id>`
 
 Trigger a rescan of cached field values (`POST /api/database/:id/rescan_values`). Returns `{ id, status: "ok" }` once the rescan has been queued.
@@ -848,12 +856,14 @@ Create a collection from a JSON spec. The body accepts the same fields as `POST
 cat collection.json | mb collection create
 mb collection create --file collection.json
 mb collection create --body '{"name":"My Collection","parent_id":4}'
+mb collection create --body '{"name":"ETL"}' --namespace transforms
 ```
 
-| Flag            | Description                                         |
-| --------------- | --------------------------------------------------- |
-| `--body <json>` | Inline JSON body.                                   |
-| `--file <path>` | Path to JSON body file. Use `-` to read from stdin. |
+| Flag               | Description                                                                                                                                                                                                      |
+| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `--body <json>`    | Inline JSON body.                                                                                                                                                                                                |
+| `--file <path>`    | Path to JSON body file. Use `-` to read from stdin.                                                                                                                                                              |
+| `--namespace <ns>` | Collection namespace (`transforms`, `snippets`, `analytics`, `shared-tenant-collection`, `tenant-specific`). Omit for a normal collection; required for a collection a transform's `collection_id` can point at. |
 
 ### `mb collection archive <id>`
 
@@ -1122,6 +1132,8 @@ mb eid --file translate.json
 mb eid --body '{"entity_ids":{"card":["abc123XYZ"]}}'
 ```
 
+Entity ids are NanoIDs that can start with `-`, which the positional `<eids>` form misreads as a flag (shell quoting doesn't help — the leading `-` survives into argv). For an id that may start with `-`, pass it via `--body`, where the id is a JSON string value immune to flag parsing: `mb eid --body '{"entity_ids":{"card":["-abc123XYZ"]}}'`.
+
 | Arg / Flag       | Description                                                                    |
 | ---------------- | ------------------------------------------------------------------------------ |
 | `<eids>`         | Comma-separated EIDs positional. Used with `--model`.                          |

package/dist/{add-collection-CLLtJ4hp.mjs → add-collection-CoP-6FZR.mjs}

@@ -1,8 +1,8 @@
-import { connectionFlags, outputFlags, profileFlag } from "./error-BYn4eqJH.mjs";
-import { defineMetabaseCommand } from "./runtime-DHJQOqZu.mjs";
-import { renderSummary } from "./capabilities-Dj3NgPHg.mjs";
-import { parseId } from "./parse-id-sz7USsM2.mjs";
-import { REMOTE_SYNC_PATHS } from "./poll-task-DnzX7GX_.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-BndUmcwS.mjs";
+import { defineMetabaseCommand } from "./runtime-Ck8KKQe-.mjs";
+import { renderSummary } from "./capabilities-7L9GVMd_.mjs";
+import { parseId } from "./parse-id-Boqc4wn4.mjs";
+import { REMOTE_SYNC_PATHS } from "./poll-task-CiRA0ER9.mjs";
 import { z } from "zod";
 
 //#region src/commands/git-sync/add-collection.ts

package/dist/add-collection-EPp89tcs.mjs

@@ -0,0 +1,10 @@
+import "./command-augment-BH9qgQ5u.mjs";
+import "./error-BndUmcwS.mjs";
+import "./runtime-Ck8KKQe-.mjs";
+import "./capabilities-7L9GVMd_.mjs";
+import "./parse-id-Boqc4wn4.mjs";
+import "./poll-BMjCkDaj.mjs";
+import "./poll-task-CiRA0ER9.mjs";
+import { SyncSettingsUpdateResult, add_collection_default, setCollectionRemoteSynced, syncSettingsUpdateView } from "./add-collection-CoP-6FZR.mjs";
+
+export { add_collection_default as default };

package/dist/{archive-BiAxoJ1m.mjs → archive-BY8nrgnq.mjs}

@@ -1,8 +1,8 @@
 import "./command-augment-BH9qgQ5u.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-BYn4eqJH.mjs";
-import { defineMetabaseCommand } from "./runtime-DHJQOqZu.mjs";
-import { renderSummary } from "./capabilities-Dj3NgPHg.mjs";
-import { parseId } from "./parse-id-sz7USsM2.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-BndUmcwS.mjs";
+import { defineMetabaseCommand } from "./runtime-Ck8KKQe-.mjs";
+import { renderSummary } from "./capabilities-7L9GVMd_.mjs";
+import { parseId } from "./parse-id-Boqc4wn4.mjs";
 import { Dashboard, dashboardView } from "./dashboard-FY5UzJ_Z.mjs";
 
 //#region src/commands/dashboard/archive.ts

package/dist/{archive-Dzug49jS.mjs → archive-BeslLaal.mjs}

@@ -1,9 +1,9 @@
 import "./command-augment-BH9qgQ5u.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-BYn4eqJH.mjs";
-import { defineMetabaseCommand } from "./runtime-DHJQOqZu.mjs";
-import { renderSummary } from "./capabilities-Dj3NgPHg.mjs";
-import { parseId } from "./parse-id-sz7USsM2.mjs";
-import { Collection, collectionView } from "./collection-B3sPXRLs.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-BndUmcwS.mjs";
+import { defineMetabaseCommand } from "./runtime-Ck8KKQe-.mjs";
+import { renderSummary } from "./capabilities-7L9GVMd_.mjs";
+import { parseId } from "./parse-id-Boqc4wn4.mjs";
+import { Collection, collectionView } from "./collection-BPTlcFw5.mjs";
 
 //#region src/commands/collection/archive.ts
 var archive_default = defineMetabaseCommand({

package/dist/{archive-CXZ1Mg97.mjs → archive-Blt0TxxA.mjs}

@@ -1,8 +1,8 @@
 import "./command-augment-BH9qgQ5u.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-BYn4eqJH.mjs";
-import { defineMetabaseCommand } from "./runtime-DHJQOqZu.mjs";
-import { renderSummary } from "./capabilities-Dj3NgPHg.mjs";
-import { parseId } from "./parse-id-sz7USsM2.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-BndUmcwS.mjs";
+import { defineMetabaseCommand } from "./runtime-Ck8KKQe-.mjs";
+import { renderSummary } from "./capabilities-7L9GVMd_.mjs";
+import { parseId } from "./parse-id-Boqc4wn4.mjs";
 import { Measure, measureView } from "./measure-ClESGxIb.mjs";
 import { revisionMessageFlag } from "./revision-message-flag-WmsIzUOM.mjs";
 

package/dist/{archive-CcXT7XDi.mjs → archive-BxwGVDpd.mjs}

@@ -1,10 +1,10 @@
 import "./command-augment-BH9qgQ5u.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-BYn4eqJH.mjs";
-import { defineMetabaseCommand } from "./runtime-DHJQOqZu.mjs";
-import { renderSummary } from "./capabilities-Dj3NgPHg.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-BndUmcwS.mjs";
+import { defineMetabaseCommand } from "./runtime-Ck8KKQe-.mjs";
+import { renderSummary } from "./capabilities-7L9GVMd_.mjs";
 import "./field-MGxpNQUH.mjs";
-import { Card, cardView } from "./card-BtPiKjbB.mjs";
-import { parseId } from "./parse-id-sz7USsM2.mjs";
+import { Card, cardView } from "./card-DnIeMmUn.mjs";
+import { parseId } from "./parse-id-Boqc4wn4.mjs";
 
 //#region src/commands/card/archive.ts
 var archive_default = defineMetabaseCommand({

package/dist/{archive-BLySelYN.mjs → archive-C17qIvFW.mjs}

@@ -1,8 +1,8 @@
 import "./command-augment-BH9qgQ5u.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-BYn4eqJH.mjs";
-import { defineMetabaseCommand } from "./runtime-DHJQOqZu.mjs";
-import { renderSummary } from "./capabilities-Dj3NgPHg.mjs";
-import { parseId } from "./parse-id-sz7USsM2.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-BndUmcwS.mjs";
+import { defineMetabaseCommand } from "./runtime-Ck8KKQe-.mjs";
+import { renderSummary } from "./capabilities-7L9GVMd_.mjs";
+import { parseId } from "./parse-id-Boqc4wn4.mjs";
 import { revisionMessageFlag } from "./revision-message-flag-WmsIzUOM.mjs";
 import { Segment, segmentView } from "./segment-Be2v4ilr.mjs";
 

package/dist/{archive-BxvnYXN2.mjs → archive-CPLXsrzD.mjs}

@@ -1,8 +1,8 @@
 import "./command-augment-BH9qgQ5u.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-BYn4eqJH.mjs";
-import { defineMetabaseCommand } from "./runtime-DHJQOqZu.mjs";
-import { renderSummary } from "./capabilities-Dj3NgPHg.mjs";
-import { parseId } from "./parse-id-sz7USsM2.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-BndUmcwS.mjs";
+import { defineMetabaseCommand } from "./runtime-Ck8KKQe-.mjs";
+import { renderSummary } from "./capabilities-7L9GVMd_.mjs";
+import { parseId } from "./parse-id-Boqc4wn4.mjs";
 import { Snippet, snippetView } from "./snippet-xh42tYly.mjs";
 
 //#region src/commands/snippet/archive.ts

package/dist/auth-CCUDM9Sv.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-BMKBmgeQ.mjs").then((m) => m.default),
+		status: () => import("./status-AnPzI1f7.mjs").then((m) => m.default),
+		list: () => import("./list-D2D5Mw1E.mjs").then((m) => m.default),
+		logout: () => import("./logout-C5pod937.mjs").then((m) => m.default)
+	}
+});
+
+//#endregion
+export { auth_default as default };

package/dist/{body-CibAG3Gn.mjs → body-2jl-YSxT.mjs}

@@ -1,5 +1,5 @@
 import { ConfigError } from "./command-augment-BH9qgQ5u.mjs";
-import { parseJson } from "./runtime-DHJQOqZu.mjs";
+import { parseJson } from "./runtime-Ck8KKQe-.mjs";
 import { DEFAULT_FLAG_NAME, readInput } from "./input-xewHccej.mjs";
 
 //#region src/runtime/body.ts

package/dist/{branches-CqYNkMew.mjs → branches-Vlu44J51.mjs}

@@ -1,9 +1,9 @@
 import "./command-augment-BH9qgQ5u.mjs";
-import { connectionFlags, listEnvelopeSchema, outputFlags, profileFlag, wrapList } from "./error-BYn4eqJH.mjs";
-import { defineMetabaseCommand } from "./runtime-DHJQOqZu.mjs";
-import { renderList } from "./capabilities-Dj3NgPHg.mjs";
-import { REMOTE_SYNC_PATHS } from "./poll-task-DnzX7GX_.mjs";
-import "./poll-DO11tBiL.mjs";
+import { connectionFlags, listEnvelopeSchema, outputFlags, profileFlag, wrapList } from "./error-BndUmcwS.mjs";
+import { defineMetabaseCommand } from "./runtime-Ck8KKQe-.mjs";
+import { renderList } from "./capabilities-7L9GVMd_.mjs";
+import "./poll-BMjCkDaj.mjs";
+import { REMOTE_SYNC_PATHS } from "./poll-task-CiRA0ER9.mjs";
 import { z } from "zod";
 
 //#region src/commands/git-sync/branches.ts

package/dist/{cancel-PLvMQNzN.mjs → cancel-D0aBPUhs.mjs}

@@ -1,8 +1,8 @@
 import "./command-augment-BH9qgQ5u.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-BYn4eqJH.mjs";
-import { defineMetabaseCommand } from "./runtime-DHJQOqZu.mjs";
-import { renderSummary } from "./capabilities-Dj3NgPHg.mjs";
-import { parseId } from "./parse-id-sz7USsM2.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-BndUmcwS.mjs";
+import { defineMetabaseCommand } from "./runtime-Ck8KKQe-.mjs";
+import { renderSummary } from "./capabilities-7L9GVMd_.mjs";
+import { parseId } from "./parse-id-Boqc4wn4.mjs";
 import { z } from "zod";
 
 //#region src/commands/transform/cancel.ts

package/dist/{cancel-task-dnxyQrhZ.mjs → cancel-task-DoL2bqs1.mjs}

@@ -1,9 +1,9 @@
 import "./command-augment-BH9qgQ5u.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-BYn4eqJH.mjs";
-import { defineMetabaseCommand } from "./runtime-DHJQOqZu.mjs";
-import { renderSummary } from "./capabilities-Dj3NgPHg.mjs";
-import { REMOTE_SYNC_PATHS, SyncTask, syncTaskView } from "./poll-task-DnzX7GX_.mjs";
-import "./poll-DO11tBiL.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-BndUmcwS.mjs";
+import { defineMetabaseCommand } from "./runtime-Ck8KKQe-.mjs";
+import { renderSummary } from "./capabilities-7L9GVMd_.mjs";
+import "./poll-BMjCkDaj.mjs";
+import { REMOTE_SYNC_PATHS, SyncTask, syncTaskView } from "./poll-task-CiRA0ER9.mjs";
 
 //#region src/commands/git-sync/cancel-task.ts
 var cancel_task_default = defineMetabaseCommand({

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

@@ -178,7 +178,7 @@ function renderList(envelope, view, opts) {
 	if (capped.truncated !== void 0) warn(listTruncationNotice(capped.truncated.bytes));
 }
 function renderProjectedTable(envelope, view, fields, maxBytes) {
-	const projectedItems = envelope.data.map((item) => applyProjection(item, view, false, fields));
+	const projectedItems = projectListItems(envelope.data, view, false, fields);
 	const capped = capListEnvelope({
 		...envelope,
 		data: projectedItems
@@ -187,8 +187,23 @@ function renderProjectedTable(envelope, view, fields, maxBytes) {
 	process.stdout.write(renderRows(fields, rows) + "\n");
 	if (capped.truncated !== void 0) warn(listTruncationNotice(capped.truncated.bytes));
 }
+function projectListItems(items, view, full, fields) {
+	try {
+		return items.map((item) => applyProjection(item, view, full, fields));
+	} catch (error) {
+		throw enrichListFieldPathError(error, fields);
+	}
+}
+function enrichListFieldPathError(error, fields) {
+	if (fields === void 0 || !(error instanceof ConfigError) || !error.message.startsWith("unknown field path")) return error;
+	const prefix = "data.";
+	const culprit = fields.find((field) => field === "data" || field.startsWith(prefix));
+	if (culprit === void 0) return error;
+	const suggestion = culprit.startsWith(prefix) ? culprit.slice(prefix.length) : "<field>";
+	return new ConfigError(`${error.message} — on list commands --fields paths are relative to each item in \`data\`, not the envelope. Drop the \`data.\` prefix (e.g. use \`${suggestion}\` instead of \`${culprit}\`).`);
+}
 function renderJsonEnvelope(envelope, view, opts) {
-	const projectedItems = envelope.data.map((item) => applyProjection(item, view, opts.full, opts.fields));
+	const projectedItems = projectListItems(envelope.data, view, opts.full, opts.fields);
 	const projectedEnvelope = {
 		...envelope,
 		data: projectedItems

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

@@ -120,8 +120,24 @@ const CardQueryResult = z.object({
 	error: z.string().nullable().optional(),
 	error_type: z.string().nullable().optional()
 }).loose();
+const QueryColumnCompact = QueryColumn.pick({
+	name: true,
+	display_name: true,
+	base_type: true,
+	semantic_type: true
+}).strip();
+const CardQueryDataCompact = z.object({
+	rows: z.array(z.unknown()),
+	cols: z.array(QueryColumnCompact)
+}).strip();
+const CardQueryResultCompact = CardQueryResult.pick({
+	status: true,
+	row_count: true,
+	error: true,
+	error_type: true
+}).strip().extend({ data: CardQueryDataCompact.optional() });
 const cardQueryView = {
-	compactPick: CardQueryResult,
+	compactPick: CardQueryResultCompact,
 	tableColumns: [{
 		key: "status",
 		label: "Status"

package/dist/card-UwczcLjq.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-Cj3v4Lgv.mjs").then((mod) => mod.default),
+		get: () => import("./get-BIH72g0v.mjs").then((mod) => mod.default),
+		query: () => import("./query-B8JzsQ_I.mjs").then((mod) => mod.default),
+		create: () => import("./create-BsOdn1Q1.mjs").then((mod) => mod.default),
+		update: () => import("./update-DykqQLfo.mjs").then((mod) => mod.default),
+		archive: () => import("./archive-BxwGVDpd.mjs").then((mod) => mod.default)
+	}
+});
+
+//#endregion
+export { card_default as default };

package/dist/{cards-DUCwTT1X.mjs → cards-6MTreYAo.mjs}

@@ -1,8 +1,8 @@
 import "./command-augment-BH9qgQ5u.mjs";
-import { connectionFlags, listEnvelopeSchema, outputFlags, profileFlag, wrapList } from "./error-BYn4eqJH.mjs";
-import { defineMetabaseCommand } from "./runtime-DHJQOqZu.mjs";
-import { renderList } from "./capabilities-Dj3NgPHg.mjs";
-import { parseId } from "./parse-id-sz7USsM2.mjs";
+import { connectionFlags, listEnvelopeSchema, outputFlags, profileFlag, wrapList } from "./error-BndUmcwS.mjs";
+import { defineMetabaseCommand } from "./runtime-Ck8KKQe-.mjs";
+import { renderList } from "./capabilities-7L9GVMd_.mjs";
+import { parseId } from "./parse-id-Boqc4wn4.mjs";
 import { DashboardDetail, DashcardCompact, dashcardView } from "./dashboard-FY5UzJ_Z.mjs";
 
 //#region src/commands/dashboard/cards.ts

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-BYn4eqJH.mjs";
+import { connectionFlags, outputFlags, package_default, profileFlag, reportError } from "./error-BndUmcwS.mjs";
 import { defineCommand, renderUsage, runMain } from "citty";
 
 //#region src/commands/global-flags.ts
@@ -58,28 +58,28 @@ const main = defineCommand({
 		description: package_default.description
 	},
 	subCommands: {
-		auth: () => import("./auth-9zbMAJJT.mjs").then((mod) => mod.default),
-		db: () => import("./db-UVZmfVwk.mjs").then((mod) => mod.default),
-		table: () => import("./table-CTTjXzo3.mjs").then((mod) => mod.default),
-		field: () => import("./field-BYKXbj6M.mjs").then((mod) => mod.default),
-		card: () => import("./card-pT87DhqA.mjs").then((mod) => mod.default),
-		dashboard: () => import("./dashboard-D4uKuH7K.mjs").then((mod) => mod.default),
-		collection: () => import("./collection-DR2bXpGN.mjs").then((mod) => mod.default),
-		transform: () => import("./transform-CWNrL2gg.mjs").then((mod) => mod.default),
-		"transform-job": () => import("./transform-job-C--GBO9Q.mjs").then((mod) => mod.default),
-		setting: () => import("./setting-fWAwsQKm.mjs").then((mod) => mod.default),
-		search: () => import("./search-B3EvSZce.mjs").then((mod) => mod.default),
-		"git-sync": () => import("./git-sync-CbvqlHaK.mjs").then((mod) => mod.default),
-		setup: () => import("./setup-SjStGgMi.mjs").then((mod) => mod.default),
-		snippet: () => import("./snippet-DTwXkIqY.mjs").then((mod) => mod.default),
-		segment: () => import("./segment-CvxcX3iJ.mjs").then((mod) => mod.default),
-		measure: () => import("./measure-RIucuF-O.mjs").then((mod) => mod.default),
-		eid: () => import("./eid-CQO-WWqZ.mjs").then((mod) => mod.default),
-		query: () => import("./query-CsN3tsch.mjs").then((mod) => mod.default),
-		uuid: () => import("./uuid-B2xU0Ibp.mjs").then((mod) => mod.default),
-		upgrade: () => import("./upgrade-82Zo6-n6.mjs").then((mod) => mod.default),
-		skills: () => import("./skills-zSDzVgBI.mjs").then((mod) => mod.default),
-		__manifest: () => import("./manifest-B_OfG-Ss.mjs").then((mod) => mod.createManifestCommand(main))
+		auth: () => import("./auth-CCUDM9Sv.mjs").then((mod) => mod.default),
+		db: () => import("./db-DULi5MOr.mjs").then((mod) => mod.default),
+		table: () => import("./table-C_bP2ao-.mjs").then((mod) => mod.default),
+		field: () => import("./field-CfrrLetM.mjs").then((mod) => mod.default),
+		card: () => import("./card-UwczcLjq.mjs").then((mod) => mod.default),
+		dashboard: () => import("./dashboard-B_CuVbMX.mjs").then((mod) => mod.default),
+		collection: () => import("./collection-Cexywhlj.mjs").then((mod) => mod.default),
+		transform: () => import("./transform-B4RZfm6A.mjs").then((mod) => mod.default),
+		"transform-job": () => import("./transform-job-C4pZcrIF.mjs").then((mod) => mod.default),
+		setting: () => import("./setting-CBJVEx7_.mjs").then((mod) => mod.default),
+		search: () => import("./search-BeuoOEQV.mjs").then((mod) => mod.default),
+		"git-sync": () => import("./git-sync-BpRstrZo.mjs").then((mod) => mod.default),
+		setup: () => import("./setup-vKXEUMM7.mjs").then((mod) => mod.default),
+		snippet: () => import("./snippet-De70ayL1.mjs").then((mod) => mod.default),
+		segment: () => import("./segment-ChYmSM0p.mjs").then((mod) => mod.default),
+		measure: () => import("./measure-BkwFsP44.mjs").then((mod) => mod.default),
+		eid: () => import("./eid-3v5MAKNA.mjs").then((mod) => mod.default),
+		query: () => import("./query-CG0rEMS-.mjs").then((mod) => mod.default),
+		uuid: () => import("./uuid-lLVnEoBN.mjs").then((mod) => mod.default),
+		upgrade: () => import("./upgrade-B8sEEQdQ.mjs").then((mod) => mod.default),
+		skills: () => import("./skills-1Z5Wj7Kp.mjs").then((mod) => mod.default),
+		__manifest: () => import("./manifest-Cmu--CG5.mjs").then((mod) => mod.createManifestCommand(main))
 	}
 });
 var main_default = main;
@@ -96,7 +96,6 @@ const OPTIONS_HEADER = "OPTIONS";
 const LINE_PREFIX = "  ";
 const COLUMN_GAP = "  ";
 const COMMAND_PLACEHOLDER = "<command> [options]";
-const MANIFEST_COMMAND = "__manifest";
 const CLI_NAME = "mb";
 const HELP_FLAG_SPEC = "-h, --help";
 const HELP_FLAG_DESCRIPTION = "Show help for this command";
@@ -110,7 +109,6 @@ async function showUsage(cmd, parent, breadcrumb) {
 	const cittyName = parentMeta?.name ? `${parentMeta.name} ${cmdName}` : cmdName;
 	const hasSubCommands = Boolean(cmd.subCommands);
 	const isRoot = parent === void 0 && hasSubCommands;
-	const isManifest = cmdName === MANIFEST_COMMAND;
 	const augment = getMetabaseAugment(cmd);
 	const details = augment?.details ?? null;
 	const examples = augment?.examples ?? [];
@@ -123,7 +121,6 @@ async function showUsage(cmd, parent, breadcrumb) {
 	const sections = [body];
 	if (examples.length > 0) sections.push(renderExamples(examples));
 	if (isRoot) sections.push(GETTING_STARTED_HINT);
-	if (!isManifest) sections.push(renderSchemaHint());
 	process.stdout.write(sections.join("\n\n") + "\n");
 }
 function transformBody(lines, rewrite) {
@@ -192,13 +189,6 @@ function renderExamples(examples) {
 		...examples.map((example) => `${LINE_PREFIX}${example}`)
 	].join("\n");
 }
-function renderSchemaHint() {
-	return [
-		"SCHEMA",
-		"",
-		`${LINE_PREFIX}${CLI_NAME} ${MANIFEST_COMMAND}      # machine-readable command manifest (flags, output, examples)`
-	].join("\n");
-}
 async function walkCommandPath(root, rawArgs) {
 	const rootMeta = await resolveCitty(root.meta);
 	const segments = rootMeta?.name === void 0 ? [] : [rootMeta.name];

package/dist/{collection-B3sPXRLs.mjs → collection-BPTlcFw5.mjs}

@@ -11,7 +11,13 @@ const CollectionType = z.enum([
 	"library-metrics",
 	"tenant-specific-root-collection"
 ]);
-const CollectionNamespace = z.string().min(1);
+const CollectionNamespace = z.enum([
+	"transforms",
+	"snippets",
+	"analytics",
+	"shared-tenant-collection",
+	"tenant-specific"
+]);
 const COLLECTION_ITEM_FILTER_MODELS = [
 	"card",
 	"dataset",
@@ -160,4 +166,4 @@ const CollectionCreateInput = z.object({
 }).loose();
 
 //#endregion
-export { COLLECTION_ITEM_FILTER_MODELS, COLLECTION_PINNED_STATES, Collection, CollectionCompact, CollectionCreateInput, CollectionItem, CollectionItemCompact, CollectionItemFilterModel, CollectionPinnedState, CollectionTreeNode, collectionItemView, collectionView };
+export { COLLECTION_ITEM_FILTER_MODELS, COLLECTION_PINNED_STATES, Collection, CollectionCompact, CollectionCreateInput, CollectionItem, CollectionItemCompact, CollectionItemFilterModel, CollectionNamespace, CollectionPinnedState, CollectionTreeNode, collectionItemView, collectionView };

package/dist/collection-Cexywhlj.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-jcgK0thu.mjs").then((mod) => mod.default),
+		get: () => import("./get-Bk81meka.mjs").then((mod) => mod.default),
+		items: () => import("./items-Kr0oN2V7.mjs").then((mod) => mod.default),
+		tree: () => import("./tree-BlYgJOn9.mjs").then((mod) => mod.default),
+		create: () => import("./create-dVmIemXi.mjs").then((mod) => mod.default),
+		archive: () => import("./archive-BeslLaal.mjs").then((mod) => mod.default)
+	}
+});
+
+//#endregion
+export { collection_default as default };

package/dist/collection-namespace-BdqQJb7j.mjs

@@ -0,0 +1,12 @@
+import { ConfigError } from "./command-augment-BH9qgQ5u.mjs";
+import { HttpError } from "./runtime-Ck8KKQe-.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.";
+function enrichTransformCollectionError(error) {
+	if (error instanceof HttpError && error.status === 400 && /:transforms namespace/i.test(error.message)) return new ConfigError(`${error.message} — ${TRANSFORMS_NAMESPACE_HINT}`);
+	return error;
+}
+
+//#endregion
+export { enrichTransformCollectionError };

package/dist/{create-VB2v6CFw.mjs → create-BWD8H6yw.mjs}

@@ -1,13 +1,14 @@
 import "./command-augment-BH9qgQ5u.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-BYn4eqJH.mjs";
-import { defineMetabaseCommand } from "./runtime-DHJQOqZu.mjs";
-import { renderSummary } from "./capabilities-Dj3NgPHg.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-BndUmcwS.mjs";
+import { defineMetabaseCommand } from "./runtime-Ck8KKQe-.mjs";
+import { renderSummary } from "./capabilities-7L9GVMd_.mjs";
 import "./input-xewHccej.mjs";
-import { readBody } from "./body-CibAG3Gn.mjs";
+import { readBody } from "./body-2jl-YSxT.mjs";
 import { bodyInputFlags } from "./body-flags-D78h_-Ua.mjs";
-import "./validate-CqVB_3_p.mjs";
-import { TRANSFORM_SOURCE_QUERY_LABELS, preflightMbql5Query, skipValidateFlag } from "./validate-query-BUTNK00f.mjs";
-import { Transform, TransformCreateInput, transformView } from "./transform-DyJb0bV0.mjs";
+import "./validate-B62TRDGV.mjs";
+import { TRANSFORM_SOURCE_QUERY_LABELS, preflightMbql5Query, skipValidateFlag } from "./validate-query-BpiN1CFu.mjs";
+import { Transform, TransformCreateInput, transformView } from "./transform-DyWCoiO-.mjs";
+import { enrichTransformCollectionError } from "./collection-namespace-BdqQJb7j.mjs";
 
 //#region src/commands/transform/create.ts
 var create_default = defineMetabaseCommand({
@@ -40,6 +41,8 @@ var create_default = defineMetabaseCommand({
 		const created = await client.requestParsed(Transform, "/api/transform", {
 			method: "POST",
 			body
+		}).catch((error) => {
+			throw enrichTransformCollectionError(error);
 		});
 		renderSummary(created, transformView, `Created transform ${created.id} "${created.name}".`, ctx);
 	}

package/dist/{create-BGtmOc5Z.mjs → create-BZRA7nPu.mjs}

@@ -1,9 +1,9 @@
 import "./command-augment-BH9qgQ5u.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-BYn4eqJH.mjs";
-import { defineMetabaseCommand } from "./runtime-DHJQOqZu.mjs";
-import { renderSummary } from "./capabilities-Dj3NgPHg.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-BndUmcwS.mjs";
+import { defineMetabaseCommand } from "./runtime-Ck8KKQe-.mjs";
+import { renderSummary } from "./capabilities-7L9GVMd_.mjs";
 import "./input-xewHccej.mjs";
-import { readBody } from "./body-CibAG3Gn.mjs";
+import { readBody } from "./body-2jl-YSxT.mjs";
 import { bodyInputFlags } from "./body-flags-D78h_-Ua.mjs";
 import { Snippet, SnippetCreateInput, snippetView } from "./snippet-xh42tYly.mjs";
 

package/dist/{create-Btltf94v.mjs → create-BsOdn1Q1.mjs}

@@ -1,14 +1,14 @@
 import "./command-augment-BH9qgQ5u.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-BYn4eqJH.mjs";
-import { defineMetabaseCommand } from "./runtime-DHJQOqZu.mjs";
-import { renderSummary } from "./capabilities-Dj3NgPHg.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-BndUmcwS.mjs";
+import { defineMetabaseCommand } from "./runtime-Ck8KKQe-.mjs";
+import { renderSummary } from "./capabilities-7L9GVMd_.mjs";
 import "./input-xewHccej.mjs";
 import "./field-MGxpNQUH.mjs";
-import { Card, CardCreateInput, cardView } from "./card-BtPiKjbB.mjs";
-import { readBody } from "./body-CibAG3Gn.mjs";
+import { Card, CardCreateInput, cardView } from "./card-DnIeMmUn.mjs";
+import { readBody } from "./body-2jl-YSxT.mjs";
 import { bodyInputFlags } from "./body-flags-D78h_-Ua.mjs";
-import "./validate-CqVB_3_p.mjs";
-import { CARD_DATASET_QUERY_LABELS, preflightMbql5Query, skipValidateFlag } from "./validate-query-BUTNK00f.mjs";
+import "./validate-B62TRDGV.mjs";
+import { CARD_DATASET_QUERY_LABELS, preflightMbql5Query, skipValidateFlag } from "./validate-query-BpiN1CFu.mjs";
 
 //#region src/commands/card/create.ts
 var create_default = defineMetabaseCommand({

package/dist/{create-CrEv9lPi.mjs → create-C_Z3IDrW.mjs}

@@ -1,12 +1,12 @@
 import "./command-augment-BH9qgQ5u.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-BYn4eqJH.mjs";
-import { defineMetabaseCommand } from "./runtime-DHJQOqZu.mjs";
-import { renderSummary } from "./capabilities-Dj3NgPHg.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-BndUmcwS.mjs";
+import { defineMetabaseCommand } from "./runtime-Ck8KKQe-.mjs";
+import { renderSummary } from "./capabilities-7L9GVMd_.mjs";
 import "./input-xewHccej.mjs";
-import { readBody } from "./body-CibAG3Gn.mjs";
+import { readBody } from "./body-2jl-YSxT.mjs";
 import { bodyInputFlags } from "./body-flags-D78h_-Ua.mjs";
-import "./validate-CqVB_3_p.mjs";
-import { SEGMENT_DEFINITION_LABELS, preflightMbql5Query, skipValidateFlag } from "./validate-query-BUTNK00f.mjs";
+import "./validate-B62TRDGV.mjs";
+import { SEGMENT_DEFINITION_LABELS, preflightMbql5Query, skipValidateFlag } from "./validate-query-BpiN1CFu.mjs";
 import { Segment, SegmentCreateInput, segmentView } from "./segment-Be2v4ilr.mjs";
 
 //#region src/commands/segment/create.ts