@metabase/cli 0.4.1-alpha.fix-transform-test-ee-path.b41b46c → 0.4.1-alpha.release-65-integration-branch.5cbe297

package/skill-data/data-action/SKILL.md

@@ -0,0 +1,125 @@
+---
+name: data-action
+description: Author and run Metabase data actions with the `mb` CLI — saved, parameterized native SQL writes (INSERT, UPDATE, DELETE) filed in a collection and run with values. Covers enabling them on a database, the body, mapping template tags to parameters, running, and the lifecycle. Triggers — "add a data action", "let users update a row", "a button that inserts a record", "run a write query", "a form that saves to the database", "delete rows from Metabase".
+allowed-tools: Read, Write, Edit, Bash, AskUserQuestion
+requires: [dataActionsWithoutModel]
+---
+
+# Data actions
+
+A **data action** is one native SQL statement that writes — `INSERT`, `UPDATE` or `DELETE` — with named inputs. It lives in a collection, and dashboards, apps and `mb data-action execute` run it with values.
+
+Flag conventions and `./.scratch` are in `core`; the native query and its template tags follow `native-sql`. This skill covers what a data action adds.
+
+## Check the database first
+
+Data actions are off on every database until an admin turns on **Model actions** for it (Admin → Databases → the database). `mb` cannot change that setting.
+
+```bash
+mb db get <id> --full --json
+```
+
+- `features` must contain `"actions"` — otherwise the driver cannot run writes; pick another database.
+- `settings["database-enable-actions"]` must be `true`. If it is not, ask the user to have an admin enable it. Create and execute fail with `Actions are not enabled.` until then.
+
+## The body
+
+```json
+{
+  "name": "Set order note",
+  "type": "query",
+  "database_id": 1,
+  "collection_id": 12,
+  "dataset_query": {
+    "lib/type": "mbql/query",
+    "database": 1,
+    "stages": [
+      {
+        "lib/type": "mbql.stage/native",
+        "native": "UPDATE orders SET note = {{note}} WHERE id = {{order_id}}",
+        "template-tags": {
+          "order_id": {
+            "id": "order_id",
+            "name": "order_id",
+            "display-name": "Order ID",
+            "type": "number",
+            "required": true
+          },
+          "note": {
+            "id": "note",
+            "name": "note",
+            "display-name": "Note",
+            "type": "text",
+            "required": true
+          }
+        }
+      }
+    ]
+  },
+  "parameters": [
+    {
+      "id": "order_id",
+      "slug": "order_id",
+      "name": "Order ID",
+      "type": "number/=",
+      "target": ["variable", ["template-tag", "order_id"]],
+      "required": true
+    },
+    {
+      "id": "note",
+      "slug": "note",
+      "name": "Note",
+      "type": "string/=",
+      "target": ["variable", ["template-tag", "note"]],
+      "required": true
+    }
+  ]
+}
+```
+
+- `type` is always `"query"`. Never set `model_id` or `type: "implicit"`; `mb data-action create` refuses both.
+- `database_id` and `dataset_query.database` are the same id (`mb db list`). Omit `collection_id` for the root collection (`mb collection list`).
+- One statement, no `;`. `create` and `update` validate `dataset_query` as `native-sql` does.
+
+## Parameters: one per template tag
+
+Each `{{name}}` needs a `template-tags` entry and a `parameters` entry, all using the same name:
+
+| Tag `type` | Parameter `type` |
+| ---------- | ---------------- |
+| `number`   | `number/=`       |
+| `text`     | `string/=`       |
+| `date`     | `date/single`    |
+| `boolean`  | `boolean/=`      |
+
+- Parameter `id` and `slug` are the tag name; `target` is `["variable", ["template-tag", "<name>"]]`.
+- Use raw variables only. A field filter (`type: "dimension"`), snippet or card reference does not work in a write — write the comparison yourself (`WHERE id = {{order_id}}`).
+- Set `required: true` on every input the statement cannot run without (`WHERE` keys, `NOT NULL` columns).
+- Wrap an optional input in `[[ … ]]` with `required: false`; the clause drops out when no value is given. This makes one action do partial updates: `UPDATE orders SET updated_at = now() [[, note = {{note}}]] [[, status = {{status}}]] WHERE id = {{order_id}}`.
+
+## Run it
+
+```bash
+mb data-action execute <id> --body '{"parameters":{"order_id":1042,"note":"rush delivery"}}'
+```
+
+`parameters` is keyed by parameter `id`. The result is `{"rows-affected": <n>}`. A missing required value is refused. A run cannot be undone, so confirm with the user before running against data that matters, and test a new action on a row created for the purpose.
+
+## Lifecycle
+
+| Task                     | Command                                                                                  |
+| ------------------------ | ---------------------------------------------------------------------------------------- |
+| Find                     | `mb data-action list` (unarchived only), `mb search --models action <text>`              |
+| Inspect                  | `mb data-action get <id> --full --json`                                                  |
+| Change SQL, inputs, name | `mb data-action update <id> --file patch.json` (changed fields only)                     |
+| Move                     | `mb data-action update <id> --body '{"collection_id":<id>}'`                             |
+| Archive / restore        | `mb data-action archive <id>` / `mb data-action update <id> --body '{"archived":false}'` |
+| Delete                   | `mb data-action delete <id> --yes` (also removes the dashboard buttons that run it)      |
+
+Archiving or deleting a collection archives or deletes its data actions. Existing model-bound or implicit data actions still list, run and archive; leave them as they are.
+
+## Don't
+
+- Don't create a model for a data action.
+- Don't concatenate values into the SQL; every value goes through a template tag.
+- Don't run a data action on production data without the user's go-ahead.

package/skill-data/native-sql/SKILL.md

@@ -112,6 +112,6 @@ mb card query 12 --parameters '[{"type":"string/=","target":["dimension",["templ
 
 - Don't wrap a field filter in an operator (`WHERE col = {{ff}}`) — write it bare (`WHERE {{ff}}`).
 - Don't author the flat `{type:"native", …}` form — send the native stage above.
-- Don't use native SQL for DDL or multiple statements — the editor is read-only, single-statement; `CREATE`/`UPDATE`/`;`-chained SQL is unsupported. To materialize a table, use a `transform`.
+- Don't use native SQL for DDL or multiple statements — the editor is read-only, single-statement; `CREATE`/`UPDATE`/`;`-chained SQL is unsupported. To materialize a table, use a `transform`; to write rows (`INSERT`/`UPDATE`/`DELETE`), use a data action (`data-action`).
 - Don't expect `[[ ]]` to save you from a case/type mismatch — `WHERE plan = {{p}}` returns zero rows on a case-sensitive engine if the value's case is off; that's a value problem, not syntax.
 - Don't reach for native when a structured query fits — you lose the engine-independence and readability of an `mbql.stage/mbql` stage.

package/dist/git-sync-CO199xCu.mjs

@@ -1,29 +0,0 @@
-import { t as defineCommandGroup } from "./group-D4w87fXL.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-gTN3G-rs.mjs").then((mod) => mod.default),
-		"is-dirty": () => import("./is-dirty-DpQBXuVa.mjs").then((mod) => mod.default),
-		"has-remote-changes": () => import("./has-remote-changes-D7uABGR0.mjs").then((mod) => mod.default),
-		dirty: () => import("./dirty-Bq2cf5AG.mjs").then((mod) => mod.default),
-		"current-task": () => import("./current-task-BTnORR7t.mjs").then((mod) => mod.default),
-		"cancel-task": () => import("./cancel-task-CX_qYiJ0.mjs").then((mod) => mod.default),
-		wait: () => import("./wait-BN_MzTng.mjs").then((mod) => mod.default),
-		import: () => import("./import-CABYSyWS.mjs").then((mod) => mod.default),
-		export: () => import("./export-F-R_vF48.mjs").then((mod) => mod.default),
-		"export-preflight": () => import("./export-preflight-0BvDa8Oz.mjs").then((mod) => mod.default),
-		stash: () => import("./stash-CHeQPI8Z.mjs").then((mod) => mod.default),
-		branches: () => import("./branches-ByUeNOBP.mjs").then((mod) => mod.default),
-		"create-branch": () => import("./create-branch-Cflee_NY.mjs").then((mod) => mod.default),
-		"add-collection": () => import("./add-collection-CcjydN8e.mjs").then((mod) => mod.default),
-		"remove-collection": () => import("./remove-collection-B2CL66No.mjs").then((mod) => mod.default)
-	}
-});
-//#endregion
-export { git_sync_default as default };

package/dist/table-8c-V5afO.mjs

@@ -1,26 +0,0 @@
-import { t as defineCommandGroup } from "./group-D4w87fXL.mjs";
-//#region src/commands/table/index.ts
-var table_default = defineCommandGroup({
-	name: "table",
-	description: "Manage Metabase tables",
-	skills: [{
-		skill: "metadata",
-		purpose: "table and column metadata, semantic types, visibility"
-	}],
-	subCommands: {
-		list: () => import("./list-BygxQkq7.mjs").then((m) => m.default),
-		get: () => import("./get-YinpF0y5.mjs").then((m) => m.default),
-		fields: () => import("./fields-DOdrazv2.mjs").then((m) => m.default),
-		fks: () => import("./fks-41Ig_ZQ2.mjs").then((m) => m.default),
-		update: () => import("./update-DEnsF5zT.mjs").then((m) => m.default),
-		"sync-schema": () => import("./sync-schema-C29bGCtt.mjs").then((m) => m.default),
-		"rescan-values": () => import("./rescan-values-DUX58myu.mjs").then((m) => m.default),
-		"discard-values": () => import("./discard-values-k5-ePxWl.mjs").then((m) => m.default),
-		"bulk-edit": () => import("./bulk-edit-3EfcsqCu.mjs").then((m) => m.default),
-		"bulk-sync-schema": () => import("./bulk-sync-schema-Dwbs0TsG.mjs").then((m) => m.default),
-		"bulk-rescan-values": () => import("./bulk-rescan-values-BpwnC_WY.mjs").then((m) => m.default),
-		"bulk-discard-values": () => import("./bulk-discard-values-DY7svs0d.mjs").then((m) => m.default)
-	}
-});
-//#endregion
-export { table_default as default };

package/dist/transform-job-DALBzYVV.mjs

@@ -1,22 +0,0 @@
-import { t as defineCommandGroup } from "./group-D4w87fXL.mjs";
-//#region src/commands/transform-job/index.ts
-var transform_job_default = defineCommandGroup({
-	name: "transform-job",
-	description: "Manage Metabase transform jobs",
-	skills: [{
-		skill: "transform",
-		purpose: "tag-driven job schedules"
-	}],
-	subCommands: {
-		list: () => import("./list-Dd9o6Tut.mjs").then((mod) => mod.default),
-		get: () => import("./get-BVaN-tgY.mjs").then((mod) => mod.default),
-		create: () => import("./create-DqGen4jU.mjs").then((mod) => mod.default),
-		update: () => import("./update-CBcJTZo6.mjs").then((mod) => mod.default),
-		delete: () => import("./delete-ChmqxYa7.mjs").then((mod) => mod.default),
-		run: () => import("./run-C5wf-lug.mjs").then((mod) => mod.default),
-		transforms: () => import("./transforms-BQjwZKTN.mjs").then((mod) => mod.default),
-		"set-active": () => import("./set-active-CAt6ieXS.mjs").then((mod) => mod.default)
-	}
-});
-//#endregion
-export { transform_job_default as default };

package/dist/transform-p-6_thIh.mjs

@@ -1,28 +0,0 @@
-import { t as defineCommandGroup } from "./group-D4w87fXL.mjs";
-//#region src/commands/transform/index.ts
-var transform_default = defineCommandGroup({
-	name: "transform",
-	description: "Manage Metabase transforms",
-	skills: [{
-		skill: "transform",
-		purpose: "body shape, run-with-wait, iterate"
-	}, {
-		skill: "mbql",
-		purpose: "MBQL source.query bodies"
-	}],
-	subCommands: {
-		list: () => import("./list-DO767sO1.mjs").then((mod) => mod.default),
-		get: () => import("./get-B8hREA2A.mjs").then((mod) => mod.default),
-		dependencies: () => import("./dependencies-GvzMLOS2.mjs").then((mod) => mod.default),
-		create: () => import("./create-9sPJd45D.mjs").then((mod) => mod.default),
-		update: () => import("./update-DX1s6KnO.mjs").then((mod) => mod.default),
-		delete: () => import("./delete-Ch797MmM.mjs").then((mod) => mod.default),
-		"delete-table": () => import("./delete-table-0xxoSknN.mjs").then((mod) => mod.default),
-		run: () => import("./run-T2a4m1x9.mjs").then((mod) => mod.default),
-		cancel: () => import("./cancel-Nz4jJ-Ey.mjs").then((mod) => mod.default),
-		"get-run": () => import("./get-run-PeXiUJwf.mjs").then((mod) => mod.default),
-		runs: () => import("./runs-Datc76Wu.mjs").then((mod) => mod.default)
-	}
-});
-//#endregion
-export { transform_default as default };