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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metabase/cli",
-  "version": "0.1.8-alpha.drop-workspaces.a42f32e",
+  "version": "0.1.8-alpha.drop-workspaces.75fe1d5",
   "description": "Metabase CLI",
   "license": "AGPL-3.0",
   "repository": {

package/skill-data/core/SKILL.md

@@ -66,7 +66,7 @@ Every list/get verb supports the same output flags:
 
 - `--json` — emit the full JSON envelope, safe for `jq`. Default is human-readable text.
 - `--full` — include every field (compact projection is the default for list/get).
-- `--fields a,b.c.d` — project specific dot-paths. Mutually exclusive with `--full`.
+- `--fields a,b.c.d` — project specific dot-paths. Mutually exclusive with `--full`. **Paths are relative to each `data[]` item on list verbs, and to the root on single-item verbs.** So it's `--fields id,name` on `… list` / `database schema-tables` (the projection runs per row) — `data.id` and `data[].id` both fail with `unknown field path: "data.id"`. On single-object verbs the path is root-relative: `--fields id,name,display` on `card get`, and `--fields data.rows` on `mb query` (whose `data` is an object, not an array).
 - `--max-bytes <n>` — cap **list** output size (drops trailing items, sets `truncated`). Default 65 536; `0` disables. Single-item commands (`get`, `metadata`) never truncate — they emit a stderr advisory when over the cap.
 
 List envelope shape:
@@ -132,7 +132,7 @@ Routine verb shapes (list / get / create / update), every flag, and output JSON
 - **table fields.** `table get` never returns fields on its own — pass `--include fields` (compact) or use `table fields <id>` (list envelope). `table metadata <id>` adds FKs + dimensions (heavier). `table update` patches table-level metadata only; physical columns aren't editable here.
 - **field has no `list`.** Fields are per-table — get them via `table get <id> --include fields`. Never enumerate fields across a whole db (context blow-up). `field summary` is live cardinality `{field_id, count, distincts}`; `field values` is the cached distinct set (`has_more_values: true` ⇒ truncated cache). `field update` patches metadata only; `base_type` isn't editable.
 - **card.** `dataset_query` is the **flat** `mbql/query` value, not a legacy `{type:"query",query:…}` envelope (→ `mbql` skill). `--export-format csv|xlsx` streams the raw export (pipe to a file), bypassing the JSON envelope. `archive` is the only delete; unarchive with `update --body '{"archived":false}'`. `visualization_settings` keys are scoped by `display` and aren't pre-flighted — see the `viz` skill.
-- **dashboard.** Dashcards round-trip through `PUT /api/dashboard/:id` (no per-dashcard endpoint): `update-dashcard <dash-id> <dashcard-id>` patches one safely; `update --body '{"dashcards":[…]}'` replaces the whole set (omitted ids are deleted server-side; use negative ids for new cards). `create`/`update` pre-flight every positive `card_id` against live server state and exit **2** with `{ok:false,errors:[…]}` on a bad ref — non-bypassable (no `--skip-validate`). `dashboard get <id>` (or `--full`) hydrates dashcards/tabs; `list` omits them.
+- **dashboard.** Dashcards round-trip through `PUT /api/dashboard/:id` (no per-dashcard endpoint): `update-dashcard <dash-id> <dashcard-id>` patches one safely; `update --body '{"dashcards":[…]}'` replaces the whole set (omitted ids are deleted server-side; use negative ids for new cards). `create` accepts the **same** `dashcards` array in its initial body, so you can lay out the whole dashboard in one call — negative ids for new cards, and `card_id:null` plus a `visualization_settings.virtual_card` block (`{display:"text"|"heading"|"link"|…}`) for non-question cards. `create`/`update` pre-flight every positive `card_id` against live server state and exit **2** with `{ok:false,errors:[…]}` on a bad ref — non-bypassable (no `--skip-validate`). `dashboard get <id>` (or `--full`) hydrates dashcards/tabs; `list` omits them.
 - **snippet `--archived` is a swap, not a union** — list returns _either_ active _or_ archived rows, never both. (Same shape for `--filter archived` on dashboard/collection.)
 - **segment / measure** `update` and `archive` require a non-blank `revision_message` (audit-logged); the CLI does not synthesize it on `update`. `archive` defaults to `"Archived via mb CLI"` — override with `--revision-message`. `definition` is a flat MBQL clause (→ `mbql` skill): segment = a filter, measure = exactly one aggregation.
 - **collection `<ref>`** accepts four forms only — positive int, `root`, `trash`, or a 21-char entity_id — anything else is a client-side `ConfigError`. `collection items` auto-paginates (cap with `--limit`, which then omits `total`). `collection tree` is **JSON-only** — `--format text` is rejected.

package/skill-data/mbql/SKILL.md

@@ -87,6 +87,8 @@ mb query --file q.json --profile <n> --json                     # 3. validate +
 
 `path` is a JSON Pointer into the body (`/stages/0/aggregation/0`); `message` is the validator error. Exit codes: `0` valid + ran, `2` validation failed / malformed body, `1` server-side error after a valid pre-flight.
 
+A successful run emits the **full `/api/dataset` envelope** — `data.rows`, `data.cols`, plus heavy `data.results_metadata` and per-column fingerprints. For ad-hoc exploration project `--fields data.rows` (add `data.cols` if you need column names); without it even a few rows render as hundreds of lines of metadata. (`mb query` also runs a **native** body — `{database, type:"native", native:{query:"SELECT …"}}` — which skips pre-flight and is the quickest way to eyeball raw warehouse data; same `--fields data.rows` advice applies.)
+
 `--skip-validate` bypasses the pre-flight and sends as-is — use only when the bundled schema disagrees with what the server actually accepts (drift / false negative). Mutually exclusive with `--dry-run`. The same flag exists on `card create/update` and `transform create/update`.
 
 ## Where MBQL 5 is consumed

package/skill-data/transform/SKILL.md

@@ -60,6 +60,7 @@ Notes:
 - The heredoc with single-quoted `'EOF'` prevents shell from interpolating any `$vars` inside the SQL.
 - `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 the create output — no follow-up `transform get` needed to verify where the transform will write.
 - 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" workflows, prefer `transform update <id>` — see "Iterating on a failing transform" below.
+- **`collection_id` only accepts a collection in the `:transforms` namespace.** Transforms aren't filed next to cards and dashboards — passing a normal analytics collection id (the kind a dashboard lives in) 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 pass a collection created in the transforms namespace. Cards and dashboards you build **on top of** the transform's output table go in ordinary collections as usual — so "put the transform and its dashboard in collection X" generally means *X holds the dashboard + cards; the transform stays in the transforms namespace.*
 
 ## Inspect
 
@@ -68,7 +69,16 @@ mb transform list --profile <name> --json
 mb transform get <id> --profile <name> --full --json     # full transform incl. last run summary
 ```
 
-After a run, the materialized table is queryable via `mb` (`card create` against it, native query against `<schema>.<name>`, etc.). Columns and types are inferred from the result set; if you change the SELECT shape, drop the table first or the next run will fail on a column-mismatch error.
+After a run, the materialized table physically exists in the warehouse, but Metabase doesn't know about it yet. **Native SQL** (a native `card`, or `mb query` against `<schema>.<name>`) reads it immediately — native runs straight against the warehouse. **MBQL and the Metabase UI cannot reference it until the instance syncs**, because they address tables and columns by numeric id and a brand-new table has none. To build MBQL cards on a fresh output table:
+
+```bash
+mb database sync-schema <db-id> --profile <name> --json          # async — returns {status:"ok"} at once
+# poll until the new table appears (sync is not instant):
+mb database schema-tables <db-id> <schema> --profile <name> --json --fields id,name
+mb table get <table-id> --include fields --profile <name> --json  # then grab the field ids
+```
+
+Columns and types are inferred from the result set; if you change the SELECT shape, drop the table first (`transform delete-table <id>`) or the next run will fail on a column-mismatch error. A changed shape also needs a re-sync before MBQL sees the new/renamed columns.
 
 ## Inspect runs and cancel an in-flight run
 
@@ -107,10 +117,11 @@ Column "TAGS" not found; SQL statement:
 UPDATE "TRANSFORM" SET "TAGS" = (), "UPDATED_AT" = NOW() WHERE "ID" = ? [42122-214]
 ```
 
-Two specific footguns:
+Three specific footguns:
 
 - **`tags` is not a key on the REST API.** The serdes/YAML representation uses `tags`; the REST contract uses `tag_ids` (an array of integer ids). If you pulled a YAML representation and want to PUT it, translate `tags: [...]` → `tag_ids: [...]` first (or omit it entirely if you're not changing tag membership).
 - **`source_type`, `target_db_id`, `target_table_id`, `entity_id`** are derived/computed by the server. They appear in GET responses for the agent's benefit; the server doesn't accept them on update.
+- **`collection_id` must be a `:transforms`-namespace collection** — a regular card/dashboard collection id is rejected with `A Transform can only go in Collections in the :transforms namespace.` Omit it unless you have one (see the create notes above). Round-tripping the existing value is safe; setting it to an ordinary collection is what fails.
 
 Right shape — patch only what changes:
 

package/dist/add-collection-DkucDB2N.mjs

@@ -1,10 +0,0 @@
-import "./command-augment-BH9qgQ5u.mjs";
-import "./error-BLukG0Vf.mjs";
-import "./runtime-C2EDX9E7.mjs";
-import "./capabilities-Dj3NgPHg.mjs";
-import "./parse-id-BapRoz4R.mjs";
-import "./poll-task-Dalt24ov.mjs";
-import "./poll-CYFFYOiB.mjs";
-import { SyncSettingsUpdateResult, add_collection_default, setCollectionRemoteSynced, syncSettingsUpdateView } from "./add-collection-CuLyFlrE.mjs";
-
-export { add_collection_default as default };

package/dist/auth-WILFa6Xf.mjs

@@ -1,19 +0,0 @@
-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-DSS8QywX.mjs").then((m) => m.default),
-		status: () => import("./status-DoVvjifV.mjs").then((m) => m.default),
-		list: () => import("./list-CWItVq2v.mjs").then((m) => m.default),
-		logout: () => import("./logout-B6acbVng.mjs").then((m) => m.default)
-	}
-});
-
-//#endregion
-export { auth_default as default };

package/dist/card-Bd8jLmZW.mjs

@@ -1,20 +0,0 @@
-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-B3CgwSU4.mjs").then((mod) => mod.default),
-		get: () => import("./get-BVMyLnhh.mjs").then((mod) => mod.default),
-		query: () => import("./query-DRosi9Ha.mjs").then((mod) => mod.default),
-		create: () => import("./create-DRhRPfD-.mjs").then((mod) => mod.default),
-		update: () => import("./update-BHit5RyS.mjs").then((mod) => mod.default),
-		archive: () => import("./archive-DNVqPMhp.mjs").then((mod) => mod.default)
-	}
-});
-
-//#endregion
-export { card_default as default };

package/dist/collection-gz4k8jWl.mjs

@@ -1,20 +0,0 @@
-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-CkCgkJFh.mjs").then((mod) => mod.default),
-		get: () => import("./get-C5PKCCzj.mjs").then((mod) => mod.default),
-		items: () => import("./items-D6h0ejme.mjs").then((mod) => mod.default),
-		tree: () => import("./tree-CGBtDXfk.mjs").then((mod) => mod.default),
-		create: () => import("./create-BqiR1kvi.mjs").then((mod) => mod.default),
-		archive: () => import("./archive-COAWrOVp.mjs").then((mod) => mod.default)
-	}
-});
-
-//#endregion
-export { collection_default as default };

package/dist/dashboard-BL8_Ysst.mjs

@@ -1,21 +0,0 @@
-import { defineCommand } from "citty";
-
-//#region src/commands/dashboard/index.ts
-var dashboard_default = defineCommand({
-	meta: {
-		name: "dashboard",
-		description: "Manage Metabase dashboards"
-	},
-	subCommands: {
-		list: () => import("./list-r3gm10tz.mjs").then((mod) => mod.default),
-		get: () => import("./get-z9XIWbVG.mjs").then((mod) => mod.default),
-		cards: () => import("./cards-CYKPNOp3.mjs").then((mod) => mod.default),
-		create: () => import("./create-BfRIHlHk.mjs").then((mod) => mod.default),
-		update: () => import("./update-BJn9ZitD.mjs").then((mod) => mod.default),
-		"update-dashcard": () => import("./update-dashcard-C8BGZtY7.mjs").then((mod) => mod.default),
-		archive: () => import("./archive-mdSqCzVw.mjs").then((mod) => mod.default)
-	}
-});
-
-//#endregion
-export { dashboard_default as default };

package/dist/db-Bw8m4M2J.mjs

@@ -1,22 +0,0 @@
-import { defineCommand } from "citty";
-
-//#region src/commands/db/index.ts
-var db_default = defineCommand({
-	meta: {
-		name: "db",
-		description: "Inspect and sync Metabase databases",
-		alias: "database"
-	},
-	subCommands: {
-		list: () => import("./list-BJxm0-6m.mjs").then((m) => m.default),
-		get: () => import("./get-CgdzDOTX.mjs").then((m) => m.default),
-		metadata: () => import("./metadata-D_wFDaCb.mjs").then((m) => m.default),
-		schemas: () => import("./schemas-DnGJlmQl.mjs").then((m) => m.default),
-		"schema-tables": () => import("./schema-tables-CZr0QT1g.mjs").then((m) => m.default),
-		"sync-schema": () => import("./sync-schema-CvXkT9Rg.mjs").then((m) => m.default),
-		"rescan-values": () => import("./rescan-values-C3L03Crf.mjs").then((m) => m.default)
-	}
-});
-
-//#endregion
-export { db_default as default };

package/dist/field-GgVH-HUD.mjs

@@ -1,18 +0,0 @@
-import { defineCommand } from "citty";
-
-//#region src/commands/field/index.ts
-var field_default = defineCommand({
-	meta: {
-		name: "field",
-		description: "Manage Metabase fields"
-	},
-	subCommands: {
-		get: () => import("./get-BLUldOxi.mjs").then((m) => m.default),
-		values: () => import("./values-07BZxAK5.mjs").then((m) => m.default),
-		summary: () => import("./summary-BsdiF7LZ.mjs").then((m) => m.default),
-		update: () => import("./update-DqAKFmkw.mjs").then((m) => m.default)
-	}
-});
-
-//#endregion
-export { field_default as default };

package/dist/git-sync-oYYp_Z6v.mjs

@@ -1,28 +0,0 @@
-import { defineCommand } from "citty";
-
-//#region src/commands/git-sync/index.ts
-var git_sync_default = defineCommand({
-	meta: {
-		name: "git-sync",
-		description: "Sync Metabase content with a git remote"
-	},
-	subCommands: {
-		status: () => import("./status-B7H0JH52.mjs").then((mod) => mod.default),
-		"is-dirty": () => import("./is-dirty-C_RyVkc1.mjs").then((mod) => mod.default),
-		"has-remote-changes": () => import("./has-remote-changes-BNjTil7k.mjs").then((mod) => mod.default),
-		dirty: () => import("./dirty-hGWiemB-.mjs").then((mod) => mod.default),
-		"current-task": () => import("./current-task-5buIatuG.mjs").then((mod) => mod.default),
-		"cancel-task": () => import("./cancel-task-DX_OdGan.mjs").then((mod) => mod.default),
-		wait: () => import("./wait-DWyuBO_X.mjs").then((mod) => mod.default),
-		import: () => import("./import-C0iBM0UR.mjs").then((mod) => mod.default),
-		export: () => import("./export-wh9l0s7F.mjs").then((mod) => mod.default),
-		stash: () => import("./stash-B4RTStPo.mjs").then((mod) => mod.default),
-		branches: () => import("./branches-DwV1q-4h.mjs").then((mod) => mod.default),
-		"create-branch": () => import("./create-branch-2yEa7-9x.mjs").then((mod) => mod.default),
-		"add-collection": () => import("./add-collection-DkucDB2N.mjs").then((mod) => mod.default),
-		"remove-collection": () => import("./remove-collection-CLWw-48s.mjs").then((mod) => mod.default)
-	}
-});
-
-//#endregion
-export { git_sync_default as default };

package/dist/is-dirty-C_RyVkc1.mjs

@@ -1,9 +0,0 @@
-import "./command-augment-BH9qgQ5u.mjs";
-import "./error-BLukG0Vf.mjs";
-import "./runtime-C2EDX9E7.mjs";
-import "./capabilities-Dj3NgPHg.mjs";
-import "./poll-task-Dalt24ov.mjs";
-import "./poll-CYFFYOiB.mjs";
-import { IsDirtyResult, is_dirty_default } from "./is-dirty-D_e5Xoke.mjs";
-
-export { is_dirty_default as default };

package/dist/measure-DDn0jAB8.mjs

@@ -1,19 +0,0 @@
-import { defineCommand } from "citty";
-
-//#region src/commands/measure/index.ts
-var measure_default = defineCommand({
-	meta: {
-		name: "measure",
-		description: "Manage Metabase measures"
-	},
-	subCommands: {
-		list: () => import("./list-DLC82gFo.mjs").then((mod) => mod.default),
-		get: () => import("./get-C_LAPJ7J.mjs").then((mod) => mod.default),
-		create: () => import("./create-CE1WZ4du.mjs").then((mod) => mod.default),
-		update: () => import("./update-B89kI8l9.mjs").then((mod) => mod.default),
-		archive: () => import("./archive-Dt1qDaIF.mjs").then((mod) => mod.default)
-	}
-});
-
-//#endregion
-export { measure_default as default };

package/dist/segment-ydERbF0L.mjs

@@ -1,19 +0,0 @@
-import { defineCommand } from "citty";
-
-//#region src/commands/segment/index.ts
-var segment_default = defineCommand({
-	meta: {
-		name: "segment",
-		description: "Manage Metabase segments"
-	},
-	subCommands: {
-		list: () => import("./list-DcV2bfg8.mjs").then((mod) => mod.default),
-		get: () => import("./get-BhFiIyyH.mjs").then((mod) => mod.default),
-		create: () => import("./create-CQxJpVXk.mjs").then((mod) => mod.default),
-		update: () => import("./update-JpO3b8g3.mjs").then((mod) => mod.default),
-		archive: () => import("./archive-C1lk1rR7.mjs").then((mod) => mod.default)
-	}
-});
-
-//#endregion
-export { segment_default as default };

package/dist/snippet-i1Z8-yJQ.mjs

@@ -1,19 +0,0 @@
-import { defineCommand } from "citty";
-
-//#region src/commands/snippet/index.ts
-var snippet_default = defineCommand({
-	meta: {
-		name: "snippet",
-		description: "Manage Metabase native query snippets"
-	},
-	subCommands: {
-		list: () => import("./list-D0ZVA1e1.mjs").then((mod) => mod.default),
-		get: () => import("./get-DETcYP1F.mjs").then((mod) => mod.default),
-		create: () => import("./create-B4aKAWaQ.mjs").then((mod) => mod.default),
-		update: () => import("./update-C44bumhM.mjs").then((mod) => mod.default),
-		archive: () => import("./archive-C2AfP9G_.mjs").then((mod) => mod.default)
-	}
-});
-
-//#endregion
-export { snippet_default as default };

package/dist/table-DoAu2iwB.mjs

@@ -1,19 +0,0 @@
-import { defineCommand } from "citty";
-
-//#region src/commands/table/index.ts
-var table_default = defineCommand({
-	meta: {
-		name: "table",
-		description: "Manage Metabase tables"
-	},
-	subCommands: {
-		list: () => import("./list-BZkOPBmK.mjs").then((m) => m.default),
-		get: () => import("./get-Cu7Om0g2.mjs").then((m) => m.default),
-		metadata: () => import("./metadata-C-bcafH-.mjs").then((m) => m.default),
-		fields: () => import("./fields-BD52yx5k.mjs").then((m) => m.default),
-		update: () => import("./update-BA48uHRd.mjs").then((m) => m.default)
-	}
-});
-
-//#endregion
-export { table_default as default };

package/dist/transform-JzFSQdFi.mjs

@@ -1,24 +0,0 @@
-import { defineCommand } from "citty";
-
-//#region src/commands/transform/index.ts
-var transform_default = defineCommand({
-	meta: {
-		name: "transform",
-		description: "Manage Metabase transforms"
-	},
-	subCommands: {
-		list: () => import("./list-pXgd_HTy.mjs").then((mod) => mod.default),
-		get: () => import("./get-436DayeX.mjs").then((mod) => mod.default),
-		create: () => import("./create-BscN4jFB.mjs").then((mod) => mod.default),
-		update: () => import("./update-BJhk_A4R.mjs").then((mod) => mod.default),
-		delete: () => import("./delete-CF8in6gw.mjs").then((mod) => mod.default),
-		"delete-table": () => import("./delete-table-m-6cOPnX.mjs").then((mod) => mod.default),
-		run: () => import("./run-PL8TRDGx.mjs").then((mod) => mod.default),
-		cancel: () => import("./cancel-DDKstWQM.mjs").then((mod) => mod.default),
-		"get-run": () => import("./get-run-BEvwTmr7.mjs").then((mod) => mod.default),
-		runs: () => import("./runs-B86YP36a.mjs").then((mod) => mod.default)
-	}
-});
-
-//#endregion
-export { transform_default as default };

package/dist/transform-job-C8q3Fcf7.mjs

@@ -1,19 +0,0 @@
-import { defineCommand } from "citty";
-
-//#region src/commands/transform-job/index.ts
-var transform_job_default = defineCommand({
-	meta: {
-		name: "transform-job",
-		description: "Manage Metabase transform jobs"
-	},
-	subCommands: {
-		list: () => import("./list-CmVbbX3f.mjs").then((mod) => mod.default),
-		get: () => import("./get-EJOWmpkC.mjs").then((mod) => mod.default),
-		create: () => import("./create-BfseKO3F.mjs").then((mod) => mod.default),
-		update: () => import("./update-WMzbyUw2.mjs").then((mod) => mod.default),
-		delete: () => import("./delete-C3i5dE4s.mjs").then((mod) => mod.default)
-	}
-});
-
-//#endregion
-export { transform_job_default as default };