@metabase/cli 0.1.13 → 0.1.14

package/skill-data/core/SKILL.md

@@ -12,7 +12,7 @@ Top-level command groups (run `mb <group> --help` to discover verbs):
 
 ```
 auth | db | table | field | query | card | dashboard | snippet | segment | measure | collection
-document | transform | transform-job | setting | search | git-sync | setup | eid | uuid | upgrade | skills
+document | transform | transform-job | transform-tag | setting | search | git-sync | setup | eid | uuid | upgrade | skills
 ```
 
 The patterns below — auth, flag conventions, output flags, body input — apply across **every** group. Per-command flags, examples, and output schemas live in `mb __manifest` (see below). A few flows have their own specialized skills (see "Specialized skills"). When a card needs a query, prefer MBQL over native SQL (portable, pre-flight-validated) — load `mbql`; fall back to native SQL when MBQL can't express it.

package/skill-data/transform/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: transform
-description: Author and run Metabase transforms via `mb` — body shape (native SQL + MBQL 5), create + run-with-wait, run inspection, cancel, the `update`-vs-recreate iteration rule, and the writable-keys-only PATCH contract. Load when the user touches transforms — "create a transform", "run a transform", "fix a failing transform", "list transform runs", "cancel a running transform", or anything `mb transform …`.
+description: Author and run Metabase transforms via `mb` — body shape (native SQL + MBQL 5), create + run-with-wait, run inspection, dependencies, cancel, the `update`-vs-recreate iteration rule, the writable-keys-only PATCH contract, plus transform tags and tag-driven transform-job schedules. Load when the user touches transforms — "create a transform", "run a transform", "fix a failing transform", "list transform runs", "cancel a running transform", "manage transform tags", "run a transform job", or anything `mb transform …` / `mb transform-job …` / `mb transform-tag …`.
 allowed-tools: Read, Write, Edit, Bash, AskUserQuestion
 ---
 
@@ -62,7 +62,8 @@ Notes:
 
 ```bash
 mb transform list --profile <name> --json
-mb transform get <id> --profile <name> --full --json     # full transform incl. last run summary
+mb transform get <id> --profile <name> --full --json          # full transform incl. last run summary
+mb transform dependencies <id> --profile <name> --json        # upstream transforms this one must run after
 ```
 
 After a run the table physically exists in the warehouse, but Metabase addresses tables/columns by numeric id, so **MBQL and the UI can't reference a brand-new table until the instance syncs** (native SQL — a native `card` or `mb query` against `<schema>.<name>` — reads it immediately). Run and register in one step with `--sync`.
@@ -139,6 +140,8 @@ mb transform update <id> --file ./.scratch/patch.json --profile <name> --json
 mb transform update <id> --body '{"tag_ids":[1,3]}' --profile <name> --json
 ```
 
+`tag_ids` are the integer ids of **transform tags** — discover and manage them with the `transform-tag` group: `mb transform-tag list --json` (find ids; the four built-ins `hourly`/`daily`/`weekly`/`monthly` are seeded), `mb transform-tag create --body '{"name":"nightly"}' --json`, `mb transform-tag update <id>`, `mb transform-tag delete <id>`. Tags are also how a `transform-job` selects what to run — a job executes every transform carrying one of the job's tags (see "Transform jobs" below).
+
 If you really must round-trip, project to the writable subset:
 
 ```bash
@@ -197,7 +200,18 @@ Removes the definition. Whether the materialized table is dropped depends on the
 
 ## Transform jobs (schedules)
 
-A schedule lives in a separate resource (`transform-job`) and references one or more transform ids. Create with the same body-input pattern (`--file body.json`); see `mb transform-job --help` for the verb list. Most ad-hoc agent work is one-off `transform run`, not job authoring.
+A schedule lives in a separate resource (`transform-job`). A job carries **tags** (`tag_ids`), not transform ids: each run executes every transform carrying one of the job's tags. You add a transform to a job by tagging the transform (`transform update <id> --body '{"tag_ids":[…]}'`), not by listing it on the job. Create/update with the same body-input pattern (`--file body.json`).
+
+Key verbs (`mb transform-job --help` for the full list):
+
+```bash
+mb transform-job transforms <id> --profile <name> --json   # preview which transforms this job resolves to (by tag)
+mb transform-job run <id> --profile <name> --json          # trigger a job now; runs all its tagged transforms
+mb transform-job run <id> --force-refresh --profile <name> --json   # also re-run dependencies that are already fresh
+mb transform-job set-active false --profile <name> --json  # disable every job at once (true re-enables); admin only
+```
+
+`transform-job run` is fire-and-forget — the server returns `{message, job_run_id}` immediately, with no per-job-run polling (no `--wait`). Most ad-hoc agent work is one-off `transform run`, not job authoring.
 
 ## Don't (transform-specific)
 

package/dist/add-collection-BiBKEHwz.mjs

@@ -1,10 +0,0 @@
-import "./command-augment-CAur0XOQ.mjs";
-import "./error-DR_i1hxJ.mjs";
-import "./runtime-DJTGfiKO.mjs";
-import "./capabilities-BX1rnVuH.mjs";
-import "./parse-id-B1BlAunl.mjs";
-import "./poll-Dl5Zv4Ed.mjs";
-import "./poll-task-BoRK94WQ.mjs";
-import { SyncSettingsUpdateResult, add_collection_default, setCollectionRemoteSynced, syncSettingsUpdateView } from "./add-collection-BQsx2Q-S.mjs";
-
-export { add_collection_default as default };

package/dist/auth-DWA7DSo9.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-BHDdLJzw.mjs").then((m) => m.default),
-		status: () => import("./status-3-Tl07gu.mjs").then((m) => m.default),
-		list: () => import("./list-F0BQNbaZ.mjs").then((m) => m.default),
-		logout: () => import("./logout-ClizU0OL.mjs").then((m) => m.default)
-	}
-});
-
-//#endregion
-export { auth_default as default };

package/dist/card-DQV8WOIa.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-CI1WQ8U3.mjs").then((mod) => mod.default),
-		get: () => import("./get-3zFOkcl_.mjs").then((mod) => mod.default),
-		query: () => import("./query-CSvpJssD.mjs").then((mod) => mod.default),
-		create: () => import("./create-DHUhRzcV.mjs").then((mod) => mod.default),
-		update: () => import("./update-DdqzxPIr.mjs").then((mod) => mod.default),
-		archive: () => import("./archive-FLrOqODN.mjs").then((mod) => mod.default)
-	}
-});
-
-//#endregion
-export { card_default as default };

package/dist/collection-DIUWkVFY.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-DBjOFesD.mjs").then((mod) => mod.default),
-		get: () => import("./get-BlNLGR-F.mjs").then((mod) => mod.default),
-		items: () => import("./items-D4pSBGxR.mjs").then((mod) => mod.default),
-		tree: () => import("./tree-CLUxXw-Z.mjs").then((mod) => mod.default),
-		create: () => import("./create-BpAak62U.mjs").then((mod) => mod.default),
-		archive: () => import("./archive-BP53zrzs.mjs").then((mod) => mod.default)
-	}
-});
-
-//#endregion
-export { collection_default as default };

package/dist/dashboard-CohHWhkV.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-XgdM17ix.mjs").then((mod) => mod.default),
-		get: () => import("./get-CvLECgtm.mjs").then((mod) => mod.default),
-		cards: () => import("./cards-D-AkjCxr.mjs").then((mod) => mod.default),
-		create: () => import("./create-DUdkitlQ.mjs").then((mod) => mod.default),
-		update: () => import("./update-BfNmqvuN.mjs").then((mod) => mod.default),
-		"update-dashcard": () => import("./update-dashcard-Bl3wbB8-.mjs").then((mod) => mod.default),
-		archive: () => import("./archive-D7qtYihp.mjs").then((mod) => mod.default)
-	}
-});
-
-//#endregion
-export { dashboard_default as default };

package/dist/db-BD8JZUDw.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-D-Ms9fhd.mjs").then((m) => m.default),
-		get: () => import("./get-9MCrsgTf.mjs").then((m) => m.default),
-		metadata: () => import("./metadata-D23RdbEZ.mjs").then((m) => m.default),
-		schemas: () => import("./schemas-BzxVz71I.mjs").then((m) => m.default),
-		"schema-tables": () => import("./schema-tables-BII9pHR8.mjs").then((m) => m.default),
-		"sync-schema": () => import("./sync-schema-BTF7O3FM.mjs").then((m) => m.default),
-		"rescan-values": () => import("./rescan-values-CMeOv6yx.mjs").then((m) => m.default)
-	}
-});
-
-//#endregion
-export { db_default as default };

package/dist/document-CRuag6F5.mjs

@@ -1,19 +0,0 @@
-import { defineCommand } from "citty";
-
-//#region src/commands/document/index.ts
-var document_default = defineCommand({
-	meta: {
-		name: "document",
-		description: "Manage Metabase documents"
-	},
-	subCommands: {
-		list: () => import("./list-ET066OdN.mjs").then((mod) => mod.default),
-		get: () => import("./get-xVPjvf7O.mjs").then((mod) => mod.default),
-		create: () => import("./create-CcZEV9xx.mjs").then((mod) => mod.default),
-		update: () => import("./update-BeH_S7h9.mjs").then((mod) => mod.default),
-		archive: () => import("./archive-Dt5zuiwu.mjs").then((mod) => mod.default)
-	}
-});
-
-//#endregion
-export { document_default as default };

package/dist/field-CuabjsR7.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-BjCQctuS.mjs").then((m) => m.default),
-		values: () => import("./values-DuNE6Jxc.mjs").then((m) => m.default),
-		summary: () => import("./summary-CT-xFvnX.mjs").then((m) => m.default),
-		update: () => import("./update-DpCv5Mdo.mjs").then((m) => m.default)
-	}
-});
-
-//#endregion
-export { field_default as default };

package/dist/git-sync-CKsGGVOm.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-Cx0TIn1I.mjs").then((mod) => mod.default),
-		"is-dirty": () => import("./is-dirty-Mkgi21bq.mjs").then((mod) => mod.default),
-		"has-remote-changes": () => import("./has-remote-changes-DYo4PQfC.mjs").then((mod) => mod.default),
-		dirty: () => import("./dirty-CKcGYIpv.mjs").then((mod) => mod.default),
-		"current-task": () => import("./current-task-DaWn0DYt.mjs").then((mod) => mod.default),
-		"cancel-task": () => import("./cancel-task-BXgeq3MH.mjs").then((mod) => mod.default),
-		wait: () => import("./wait-CoDzO37B.mjs").then((mod) => mod.default),
-		import: () => import("./import-Cwd-_wYv.mjs").then((mod) => mod.default),
-		export: () => import("./export-8C4F9pYn.mjs").then((mod) => mod.default),
-		stash: () => import("./stash-DGujowmx.mjs").then((mod) => mod.default),
-		branches: () => import("./branches-Lr1cCUdg.mjs").then((mod) => mod.default),
-		"create-branch": () => import("./create-branch-BvZKizC4.mjs").then((mod) => mod.default),
-		"add-collection": () => import("./add-collection-BiBKEHwz.mjs").then((mod) => mod.default),
-		"remove-collection": () => import("./remove-collection-CV7ssevw.mjs").then((mod) => mod.default)
-	}
-});
-
-//#endregion
-export { git_sync_default as default };

package/dist/is-dirty-Mkgi21bq.mjs

@@ -1,9 +0,0 @@
-import "./command-augment-CAur0XOQ.mjs";
-import "./error-DR_i1hxJ.mjs";
-import "./runtime-DJTGfiKO.mjs";
-import "./capabilities-BX1rnVuH.mjs";
-import "./poll-Dl5Zv4Ed.mjs";
-import "./poll-task-BoRK94WQ.mjs";
-import { IsDirtyResult, is_dirty_default } from "./is-dirty-HynZex-f.mjs";
-
-export { is_dirty_default as default };

package/dist/measure-SmyQt9Lg.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-Bqy3rN6k.mjs").then((mod) => mod.default),
-		get: () => import("./get-D7WUNQYY.mjs").then((mod) => mod.default),
-		create: () => import("./create-CDL9WHiR.mjs").then((mod) => mod.default),
-		update: () => import("./update-Z_LMzsiz.mjs").then((mod) => mod.default),
-		archive: () => import("./archive-H8wBIt8q.mjs").then((mod) => mod.default)
-	}
-});
-
-//#endregion
-export { measure_default as default };

package/dist/segment-dkO4Ualw.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-D7o0DOZe.mjs").then((mod) => mod.default),
-		get: () => import("./get-BxgSKzca.mjs").then((mod) => mod.default),
-		create: () => import("./create-ux0yPpq1.mjs").then((mod) => mod.default),
-		update: () => import("./update-6IuvkFCk.mjs").then((mod) => mod.default),
-		archive: () => import("./archive-BS4U2_gi.mjs").then((mod) => mod.default)
-	}
-});
-
-//#endregion
-export { segment_default as default };

package/dist/snippet-DqTiC73e.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-B2QX8BZ3.mjs").then((mod) => mod.default),
-		get: () => import("./get-8r-_QuSr.mjs").then((mod) => mod.default),
-		create: () => import("./create-Dx1SDXyQ.mjs").then((mod) => mod.default),
-		update: () => import("./update-I0t_6Mni.mjs").then((mod) => mod.default),
-		archive: () => import("./archive-BrYMa87Z.mjs").then((mod) => mod.default)
-	}
-});
-
-//#endregion
-export { snippet_default as default };

package/dist/table-DNGPtV4P.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-De2qX1w8.mjs").then((m) => m.default),
-		get: () => import("./get-Cit5liJv.mjs").then((m) => m.default),
-		metadata: () => import("./metadata-a_N6Sx30.mjs").then((m) => m.default),
-		fields: () => import("./fields-hXrRjf7e.mjs").then((m) => m.default),
-		update: () => import("./update-tQvEYuzD.mjs").then((m) => m.default)
-	}
-});
-
-//#endregion
-export { table_default as default };

package/dist/transform-DEbvouxo.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-_xdr1WKh.mjs").then((mod) => mod.default),
-		get: () => import("./get-cjqlMKF5.mjs").then((mod) => mod.default),
-		create: () => import("./create-y4j2I1aH.mjs").then((mod) => mod.default),
-		update: () => import("./update-C_Ui5qPU.mjs").then((mod) => mod.default),
-		delete: () => import("./delete-CW3cEHlr.mjs").then((mod) => mod.default),
-		"delete-table": () => import("./delete-table-Wa0yRsnM.mjs").then((mod) => mod.default),
-		run: () => import("./run-CIJOYXor.mjs").then((mod) => mod.default),
-		cancel: () => import("./cancel-Br3FHyDR.mjs").then((mod) => mod.default),
-		"get-run": () => import("./get-run-CTDPEDcU.mjs").then((mod) => mod.default),
-		runs: () => import("./runs--CzbmfPg.mjs").then((mod) => mod.default)
-	}
-});
-
-//#endregion
-export { transform_default as default };

package/dist/transform-job-Du8npb7F.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-Ctze3nfU.mjs").then((mod) => mod.default),
-		get: () => import("./get-C7EKJGTP.mjs").then((mod) => mod.default),
-		create: () => import("./create-C1xYECl-.mjs").then((mod) => mod.default),
-		update: () => import("./update-DD5Q37bz.mjs").then((mod) => mod.default),
-		delete: () => import("./delete-DFWjBpzl.mjs").then((mod) => mod.default)
-	}
-});
-
-//#endregion
-export { transform_job_default as default };