@metabase/cli 0.1.17 → 0.2.0

package/dist/{query-CQ3xXa9P.mjs → query-DTASj9Zu.mjs}

@@ -1,13 +1,12 @@
-import { ConfigError } from "./notice-DyVl5aYB.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-5H_tcfL8.mjs";
-import "./command-augment-DdZIfx1V.mjs";
-import { defineMetabaseCommand, parseJson } from "./runtime-BJtuxWM8.mjs";
-import { renderSummary } from "./capabilities-N0jo5U7S.mjs";
-import "./field-CMY_LWUe.mjs";
-import "./parameter-CiJ4CwWE.mjs";
-import { CardQueryResult, cardQueryView } from "./card-DEmcRlNO.mjs";
-import { parseId } from "./parse-id-D4LeTUsP.mjs";
-import { formatQueryResult } from "./query-result-D6mfoVfQ.mjs";
+import { ConfigError, connectionFlags, outputFlags, profileFlag, renderSummary } from "./capabilities-DrDJo_ng.mjs";
+import "./command-augment-D9pI9Vbh.mjs";
+import { defineMetabaseCommand, parseJson } from "./runtime-B-c-Fc2i.mjs";
+import "./embedding-CKdw8q7p.mjs";
+import "./field-DsXTeqBy.mjs";
+import "./parameter-BZ6y-Gfs.mjs";
+import { CardQueryResult, cardQueryView } from "./card-B8G5jQQT.mjs";
+import { parseId } from "./parse-id-DfY0Lugw.mjs";
+import { formatQueryResult } from "./query-result-CbTFdlSf.mjs";
 import { z } from "zod";
 import { Writable } from "node:stream";
 

package/dist/{query-BWJ5h1g3.mjs → query-DkZViD_3.mjs}

@@ -1,21 +1,20 @@
-import { ConfigError } from "./notice-DyVl5aYB.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-5H_tcfL8.mjs";
-import "./command-augment-DdZIfx1V.mjs";
-import { defineMetabaseCommand } from "./runtime-BJtuxWM8.mjs";
-import { renderSummary, writeJson } from "./capabilities-N0jo5U7S.mjs";
-import "./input-7Sj85_K7.mjs";
-import "./field-CMY_LWUe.mjs";
-import "./parameter-CiJ4CwWE.mjs";
-import { CardQueryResult, cardQueryView } from "./card-DEmcRlNO.mjs";
-import { readBody } from "./body-IcJ5kFtk.mjs";
-import { bodyInputFlags } from "./body-flags-DWTTxJpP.mjs";
-import { assertNotLegacyEnvelopeWrappingMbql5, getQuerySchemaBundle, isMbql5Query, validateQuery } from "./validate-BqNW4Sk1.mjs";
-import { skipValidateFlag } from "./validate-query-CcZVKYPV.mjs";
-import { formatQueryResult } from "./query-result-D6mfoVfQ.mjs";
+import { ConfigError, connectionFlags, outputFlags, profileFlag, renderSummary, writeJson } from "./capabilities-DrDJo_ng.mjs";
+import "./command-augment-D9pI9Vbh.mjs";
+import { defineMetabaseCommand } from "./runtime-B-c-Fc2i.mjs";
+import "./input-m9ctfLxZ.mjs";
+import "./embedding-CKdw8q7p.mjs";
+import "./field-DsXTeqBy.mjs";
+import "./parameter-BZ6y-Gfs.mjs";
+import { CardQueryResult, cardQueryView } from "./card-B8G5jQQT.mjs";
+import { readBody } from "./body-C1_AaTS4.mjs";
+import { bodyInputFlags } from "./body-flags-CgHgJBRC.mjs";
+import { assertNotLegacyEnvelopeWrappingMbql5, getQuerySchemaBundle, isMbql5Query, validateQuery } from "./validate-clAWO3X-.mjs";
+import { skipValidateFlag } from "./validate-query-CsK2_2_u.mjs";
+import { formatQueryResult } from "./query-result-CbTFdlSf.mjs";
 import { z } from "zod";
 
 //#region src/commands/query.ts
-const QueryBody = z.unknown();
+const QueryBody = z.unknown().describe("MBQL 5, legacy MBQL, or native query body — full MBQL 5 schema: mb query --print-schema");
 const QUERY_ENDPOINT = "/api/dataset";
 var query_default = defineMetabaseCommand({
 	meta: {
@@ -43,6 +42,7 @@ var query_default = defineMetabaseCommand({
 		},
 		...skipValidateFlag
 	},
+	inputSchema: QueryBody,
 	outputSchema: CardQueryResult,
 	examples: [
 		"mb query --print-schema",

package/dist/{query-result-D6mfoVfQ.mjs → query-result-CbTFdlSf.mjs}

@@ -1,4 +1,4 @@
-import { formatScalar, renderRows } from "./capabilities-N0jo5U7S.mjs";
+import { formatScalar, renderRows } from "./capabilities-DrDJo_ng.mjs";
 
 //#region src/output/query-result.ts
 function formatQueryResult(result) {

package/dist/{remove-collection-CO-aMzTO.mjs → remove-collection-D3wH9H6R.mjs}

@@ -1,12 +1,10 @@
-import "./notice-DyVl5aYB.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-5H_tcfL8.mjs";
-import "./command-augment-DdZIfx1V.mjs";
-import { defineMetabaseCommand } from "./runtime-BJtuxWM8.mjs";
-import { renderSummary } from "./capabilities-N0jo5U7S.mjs";
-import { parseId } from "./parse-id-D4LeTUsP.mjs";
-import "./poll-BpAJpvb-.mjs";
-import "./poll-task-TilgciQn.mjs";
-import { SyncSettingsUpdateResult, setCollectionRemoteSynced, syncSettingsUpdateView } from "./add-collection-C-t9SQBk.mjs";
+import { connectionFlags, outputFlags, profileFlag, renderSummary } from "./capabilities-DrDJo_ng.mjs";
+import "./command-augment-D9pI9Vbh.mjs";
+import { defineMetabaseCommand } from "./runtime-B-c-Fc2i.mjs";
+import { parseId } from "./parse-id-DfY0Lugw.mjs";
+import "./poll-D1Yg78c3.mjs";
+import "./poll-task-DLUZaglY.mjs";
+import { SyncSettingsUpdateResult, setCollectionRemoteSynced, syncSettingsUpdateView } from "./add-collection-BTSGp4f9.mjs";
 
 //#region src/commands/git-sync/remove-collection.ts
 var remove_collection_default = defineMetabaseCommand({

package/dist/replace-CFzqkZXs.mjs

@@ -0,0 +1,42 @@
+import { connectionFlags, outputFlags, profileFlag, renderSummary } from "./capabilities-DrDJo_ng.mjs";
+import "./command-augment-D9pI9Vbh.mjs";
+import { defineMetabaseCommand } from "./runtime-B-c-Fc2i.mjs";
+import "./input-m9ctfLxZ.mjs";
+import { parseId } from "./parse-id-DfY0Lugw.mjs";
+import { UploadUpdateResult, readCsvFile, requireUploadFilePath, updateTableFromCsv, uploadUpdateResultView } from "./requests-KBiY9UYy.mjs";
+
+//#region src/commands/upload/replace.ts
+var replace_default = defineMetabaseCommand({
+	meta: {
+		name: "replace",
+		description: "Replace an existing uploaded table's rows with a CSV file"
+	},
+	details: "Replaces the contents of the table with the given id with the rows of the CSV. The table must have been created by a CSV upload and the CSV columns must match.",
+	capabilities: { minVersion: 58 },
+	args: {
+		...outputFlags,
+		...profileFlag,
+		...connectionFlags,
+		file: {
+			type: "string",
+			description: "Path to the CSV/TSV file to upload"
+		},
+		id: {
+			type: "positional",
+			description: "Target table id",
+			required: true
+		}
+	},
+	outputSchema: UploadUpdateResult,
+	examples: ["mb upload replace 42 --file rows.csv", "mb upload replace 42 --file rows.csv --json"],
+	async run({ args, ctx, getClient }) {
+		const id = parseId(args.id);
+		const file = await readCsvFile(requireUploadFilePath(args.file));
+		const client = await getClient();
+		const result = await updateTableFromCsv(client, id, "replace", file);
+		renderSummary(result, uploadUpdateResultView, `Replaced table ${id} with "${file.filename}".`, ctx);
+	}
+});
+
+//#endregion
+export { replace_default as default };

package/dist/requests-KBiY9UYy.mjs

@@ -0,0 +1,96 @@
+import { ConfigError, isNotFoundError } from "./capabilities-DrDJo_ng.mjs";
+import { fileNotFoundError } from "./input-m9ctfLxZ.mjs";
+import { z } from "zod";
+import { basename } from "node:path";
+import { readFile } from "node:fs/promises";
+
+//#region src/runtime/upload.ts
+const CSV_CONTENT_TYPE = "text/csv";
+function requireUploadFilePath(file) {
+	if (typeof file !== "string" || file.trim() === "") throw new ConfigError("provide the CSV file to upload with --file <path>");
+	return file;
+}
+async function readCsvFile(path) {
+	try {
+		const bytes = await readFile(path);
+		return {
+			filename: basename(path),
+			bytes
+		};
+	} catch (error) {
+		if (isNotFoundError(error)) throw fileNotFoundError(path);
+		throw error;
+	}
+}
+function buildCsvFormData(file) {
+	const form = new FormData();
+	form.append("file", new Blob([file.bytes], { type: CSV_CONTENT_TYPE }), file.filename);
+	return form;
+}
+
+//#endregion
+//#region src/commands/upload/results.ts
+const UploadResult = z.object({
+	model_id: z.number().int(),
+	table_id: z.number().int()
+});
+const uploadResultView = {
+	compactPick: UploadResult,
+	tableColumns: [{
+		key: "model_id",
+		label: "Model ID"
+	}, {
+		key: "table_id",
+		label: "Table ID"
+	}]
+};
+const UploadUpdateAction = z.enum(["append", "replace"]);
+const UploadUpdateResult = z.object({
+	table_id: z.number().int(),
+	action: UploadUpdateAction
+});
+const uploadUpdateResultView = {
+	compactPick: UploadUpdateResult,
+	tableColumns: [{
+		key: "table_id",
+		label: "Table ID"
+	}, {
+		key: "action",
+		label: "Action"
+	}]
+};
+
+//#endregion
+//#region src/commands/upload/requests.ts
+const UPLOAD_TABLE_ID_HEADER = "metabase-table-id";
+const UPLOAD_UPDATE_PATHS = {
+	append: "append-csv",
+	replace: "replace-csv"
+};
+async function updateTableFromCsv(client, tableId, action, file) {
+	await client.requestRaw(`/api/table/${tableId}/${UPLOAD_UPDATE_PATHS[action]}`, {
+		method: "POST",
+		body: buildCsvFormData(file),
+		expectContentType: "binary"
+	});
+	return {
+		table_id: tableId,
+		action
+	};
+}
+function parseCreateUploadResult(bodyText, headers) {
+	return UploadResult.parse({
+		model_id: parseResponseInteger(bodyText, "response body"),
+		table_id: parseResponseInteger(headers.get(UPLOAD_TABLE_ID_HEADER), `${UPLOAD_TABLE_ID_HEADER} header`)
+	});
+}
+function parseResponseInteger(value, source) {
+	const trimmed = value?.trim() ?? "";
+	if (trimmed === "") throw new Error(`upload succeeded but the ${source} was empty`);
+	const parsed = Number(trimmed);
+	if (!Number.isInteger(parsed)) throw new Error(`upload succeeded but the ${source} was not an integer: ${JSON.stringify(trimmed)}`);
+	return parsed;
+}
+
+//#endregion
+export { UploadResult, UploadUpdateResult, buildCsvFormData, parseCreateUploadResult, readCsvFile, requireUploadFilePath, updateTableFromCsv, uploadResultView, uploadUpdateResultView };

package/dist/{rescan-values-DpL6LGAK.mjs → rescan-values-B1WycObS.mjs}

@@ -1,12 +1,10 @@
-import "./notice-DyVl5aYB.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-5H_tcfL8.mjs";
-import "./command-augment-DdZIfx1V.mjs";
-import { defineMetabaseCommand } from "./runtime-BJtuxWM8.mjs";
-import { renderSummary } from "./capabilities-N0jo5U7S.mjs";
-import "./field-CMY_LWUe.mjs";
-import { parseId } from "./parse-id-D4LeTUsP.mjs";
-import "./table-DE3i82T_.mjs";
-import { DatabaseSyncResult, DatabaseTaskAck, databaseSyncResultView } from "./database-D9fftP-i.mjs";
+import { connectionFlags, outputFlags, profileFlag, renderSummary } from "./capabilities-DrDJo_ng.mjs";
+import "./command-augment-D9pI9Vbh.mjs";
+import { defineMetabaseCommand } from "./runtime-B-c-Fc2i.mjs";
+import "./field-DsXTeqBy.mjs";
+import { parseId } from "./parse-id-DfY0Lugw.mjs";
+import "./table-C3RIKiYM.mjs";
+import { DatabaseSyncResult, DatabaseTaskAck, databaseSyncResultView } from "./database-CIbVSfua.mjs";
 
 //#region src/commands/db/rescan-values.ts
 var rescan_values_default = defineMetabaseCommand({

package/dist/{resolve-Dj2MTBkn.mjs → resolve-Ct084wx3.mjs}

@@ -1,4 +1,4 @@
-import { Collection } from "./collection-DrLpA1SO.mjs";
+import { Collection } from "./collection-CFoLPrY5.mjs";
 import { z } from "zod";
 
 //#region src/domain/library.ts

package/dist/{run-DUcdaZs3.mjs → run-B8qEEdC8.mjs}

@@ -1,9 +1,7 @@
-import "./notice-DyVl5aYB.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-5H_tcfL8.mjs";
-import "./command-augment-DdZIfx1V.mjs";
-import { defineMetabaseCommand } from "./runtime-BJtuxWM8.mjs";
-import { renderSummary } from "./capabilities-N0jo5U7S.mjs";
-import { parseId } from "./parse-id-D4LeTUsP.mjs";
+import { connectionFlags, outputFlags, profileFlag, renderSummary } from "./capabilities-DrDJo_ng.mjs";
+import "./command-augment-D9pI9Vbh.mjs";
+import { defineMetabaseCommand } from "./runtime-B-c-Fc2i.mjs";
+import { parseId } from "./parse-id-DfY0Lugw.mjs";
 import { z } from "zod";
 
 //#region src/commands/transform-job/run.ts

package/dist/{run-QYJ-mAaG.mjs → run-cw0qTEQ7.mjs}

@@ -1,12 +1,10 @@
-import { TimeoutError } from "./notice-DyVl5aYB.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-5H_tcfL8.mjs";
-import "./command-augment-DdZIfx1V.mjs";
-import { defineMetabaseCommand } from "./runtime-BJtuxWM8.mjs";
-import { renderSummary } from "./capabilities-N0jo5U7S.mjs";
-import { parseId } from "./parse-id-D4LeTUsP.mjs";
-import { pollUntil } from "./poll-BpAJpvb-.mjs";
-import { parseWaitFlags, waitFlags } from "./wait-flags-Ybpt98PK.mjs";
-import { Transform, TransformRun } from "./transform-DEF38FWe.mjs";
+import { TimeoutError, connectionFlags, outputFlags, profileFlag, renderSummary } from "./capabilities-DrDJo_ng.mjs";
+import "./command-augment-D9pI9Vbh.mjs";
+import { defineMetabaseCommand } from "./runtime-B-c-Fc2i.mjs";
+import { parseId } from "./parse-id-DfY0Lugw.mjs";
+import { pollUntil } from "./poll-D1Yg78c3.mjs";
+import { parseWaitFlags, waitFlags } from "./wait-flags-dXGThljd.mjs";
+import { Transform, TransformRun } from "./transform-JQel7e5H.mjs";
 import { z } from "zod";
 
 //#region src/commands/transform/run.ts

package/dist/{runs-DgasTnGd.mjs → runs-BOA4kK_X.mjs}

@@ -1,11 +1,9 @@
-import "./notice-DyVl5aYB.mjs";
-import { connectionFlags, listEnvelopeSchema, outputFlags, profileFlag } from "./error-5H_tcfL8.mjs";
-import "./command-augment-DdZIfx1V.mjs";
-import { defineMetabaseCommand } from "./runtime-BJtuxWM8.mjs";
-import { renderList } from "./capabilities-N0jo5U7S.mjs";
-import { parseId } from "./parse-id-D4LeTUsP.mjs";
-import { collectPaginated } from "./paginate-FVZUxL4J.mjs";
-import { TransformRun, TransformRunCompact, transformRunView } from "./transform-DEF38FWe.mjs";
+import { connectionFlags, listEnvelopeSchema, outputFlags, profileFlag, renderList } from "./capabilities-DrDJo_ng.mjs";
+import "./command-augment-D9pI9Vbh.mjs";
+import { defineMetabaseCommand } from "./runtime-B-c-Fc2i.mjs";
+import { parseId } from "./parse-id-DfY0Lugw.mjs";
+import { collectPaginated } from "./paginate-CMqbqhMC.mjs";
+import { TransformRun, TransformRunCompact, transformRunView } from "./transform-JQel7e5H.mjs";
 
 //#region src/commands/transform/runs.ts
 const TransformRunListEnvelope = listEnvelopeSchema(TransformRunCompact);

package/dist/{runtime-BJtuxWM8.mjs → runtime-B-c-Fc2i.mjs}

@@ -1,7 +1,5 @@
-import { AbortError, ConfigError, MetabaseError, NetworkError, ResponseShapeError, TimeoutError, ValidationError, errorMessage, flagConsumesValue, isNotFoundError, normalizeFlag, toAliasArray, warn } from "./notice-DyVl5aYB.mjs";
-import { DEFAULT_MAX_BYTES, ENV_API_KEY, ENV_DISABLE_KEYRING, ENV_PROFILE, ENV_SKIP_PREFLIGHT, ENV_URL, consumeLegacyEnvWarnings, package_default, readEnv, reportError } from "./error-5H_tcfL8.mjs";
-import { setMetabaseAugment } from "./command-augment-DdZIfx1V.mjs";
-import { BASELINE_CAPABILITIES, isPlainObject } from "./capabilities-N0jo5U7S.mjs";
+import { AbortError, BASELINE_CAPABILITIES, ConfigError, DEFAULT_MAX_BYTES, ENV_API_KEY, ENV_DISABLE_KEYRING, ENV_PROFILE, ENV_SKIP_PREFLIGHT, ENV_URL, MetabaseError, NetworkError, ResponseShapeError, TimeoutError, ValidationError, consumeLegacyEnvWarnings, errorMessage, flagConsumesValue, isNotFoundError, isPlainObject, normalizeFlag, package_default, readEnv, reportError, toAliasArray, warn } from "./capabilities-DrDJo_ng.mjs";
+import { setMetabaseAugment } from "./command-augment-D9pI9Vbh.mjs";
 import { defineCommand } from "citty";
 import { z } from "zod";
 import { promises } from "node:fs";
@@ -1629,6 +1627,7 @@ function defineMetabaseCommand(def) {
 		examples: def.examples ?? [],
 		details: def.details ? def.details : null,
 		skills: def.skills ?? [],
+		inputSchema: def.inputSchema ?? null,
 		outputSchema: def.outputSchema ?? null,
 		capabilities: required
 	});

package/dist/{schema-tables-ooYjimrV.mjs → schema-tables-DRYzSVcW.mjs}

@@ -1,11 +1,9 @@
-import "./notice-DyVl5aYB.mjs";
-import { connectionFlags, listEnvelopeSchema, outputFlags, profileFlag, wrapList } from "./error-5H_tcfL8.mjs";
-import "./command-augment-DdZIfx1V.mjs";
-import { defineMetabaseCommand } from "./runtime-BJtuxWM8.mjs";
-import { renderList } from "./capabilities-N0jo5U7S.mjs";
-import "./field-CMY_LWUe.mjs";
-import { parseId } from "./parse-id-D4LeTUsP.mjs";
-import { Table, TableCompact, tableView } from "./table-DE3i82T_.mjs";
+import { connectionFlags, listEnvelopeSchema, outputFlags, profileFlag, renderList, wrapList } from "./capabilities-DrDJo_ng.mjs";
+import "./command-augment-D9pI9Vbh.mjs";
+import { defineMetabaseCommand } from "./runtime-B-c-Fc2i.mjs";
+import "./field-DsXTeqBy.mjs";
+import { parseId } from "./parse-id-DfY0Lugw.mjs";
+import { Table, TableCompact, tableView } from "./table-C3RIKiYM.mjs";
 import { z } from "zod";
 
 //#region src/commands/db/schema-tables.ts

package/dist/{schemas-HjFPzsd-.mjs → schemas-BiMjD25L.mjs}

@@ -1,9 +1,7 @@
-import "./notice-DyVl5aYB.mjs";
-import { connectionFlags, listEnvelopeSchema, outputFlags, profileFlag, wrapList } from "./error-5H_tcfL8.mjs";
-import "./command-augment-DdZIfx1V.mjs";
-import { defineMetabaseCommand } from "./runtime-BJtuxWM8.mjs";
-import { renderList } from "./capabilities-N0jo5U7S.mjs";
-import { parseId } from "./parse-id-D4LeTUsP.mjs";
+import { connectionFlags, listEnvelopeSchema, outputFlags, profileFlag, renderList, wrapList } from "./capabilities-DrDJo_ng.mjs";
+import "./command-augment-D9pI9Vbh.mjs";
+import { defineMetabaseCommand } from "./runtime-B-c-Fc2i.mjs";
+import { parseId } from "./parse-id-DfY0Lugw.mjs";
 import { z } from "zod";
 
 //#region src/commands/db/schemas.ts

package/dist/{search-vaT5EwhG.mjs → search-DjKxRXO5.mjs}

@@ -1,9 +1,7 @@
-import "./notice-DyVl5aYB.mjs";
-import { connectionFlags, listEnvelopeSchema, outputFlags, profileFlag } from "./error-5H_tcfL8.mjs";
-import "./command-augment-DdZIfx1V.mjs";
-import { defineMetabaseCommand, parseEnumCsv } from "./runtime-BJtuxWM8.mjs";
-import { renderList } from "./capabilities-N0jo5U7S.mjs";
-import { parseId } from "./parse-id-D4LeTUsP.mjs";
+import { connectionFlags, listEnvelopeSchema, outputFlags, profileFlag, renderList } from "./capabilities-DrDJo_ng.mjs";
+import "./command-augment-D9pI9Vbh.mjs";
+import { defineMetabaseCommand, parseEnumCsv } from "./runtime-B-c-Fc2i.mjs";
+import { parseId } from "./parse-id-DfY0Lugw.mjs";
 import { z } from "zod";
 
 //#region src/domain/search.ts

package/dist/{segment-TXktTCfU.mjs → segment-BPb1H6DW.mjs}

@@ -49,21 +49,22 @@ const segmentView = {
 		}
 	]
 };
+const SegmentDefinition = z.record(z.string(), z.unknown()).describe("MBQL query holding the filter — full MBQL 5 schema: mb query --print-schema");
 const SegmentCreateInput = z.object({
 	name: z.string().min(1),
 	table_id: z.number().int().positive(),
-	definition: z.record(z.string(), z.unknown()),
+	definition: SegmentDefinition,
 	description: z.string().nullable().optional()
 }).loose();
 const SegmentUpdateInput = z.object({
-	name: z.string().min(1).optional(),
-	definition: z.record(z.string(), z.unknown()).optional(),
+	name: z.string().min(1).nullable().optional(),
+	definition: SegmentDefinition.nullable().optional(),
 	revision_message: z.string().min(1),
-	archived: z.boolean().optional(),
+	archived: z.boolean().nullable().optional(),
 	description: z.string().nullable().optional(),
 	caveats: z.string().nullable().optional(),
 	points_of_interest: z.string().nullable().optional(),
-	show_in_getting_started: z.boolean().optional()
+	show_in_getting_started: z.boolean().nullable().optional()
 }).loose();
 
 //#endregion

package/dist/segment-CZkk0g79.mjs

@@ -0,0 +1,25 @@
+import "./command-augment-D9pI9Vbh.mjs";
+import { defineCommandGroup } from "./group-CILtQqCL.mjs";
+
+//#region src/commands/segment/index.ts
+var segment_default = defineCommandGroup({
+	name: "segment",
+	description: "Manage Metabase segments",
+	skills: [{
+		skill: "mbql",
+		purpose: "the definition filter clause"
+	}, {
+		skill: "data-workflow",
+		purpose: "define reusable segments"
+	}],
+	subCommands: {
+		list: () => import("./list-BliCJAjt.mjs").then((mod) => mod.default),
+		get: () => import("./get-DRZENkCj.mjs").then((mod) => mod.default),
+		create: () => import("./create-05rX4oL-.mjs").then((mod) => mod.default),
+		update: () => import("./update-BCbv880u.mjs").then((mod) => mod.default),
+		archive: () => import("./archive-CJ9rElKn.mjs").then((mod) => mod.default)
+	}
+});
+
+//#endregion
+export { segment_default as default };

package/dist/{selectors-DlmZpo2L.mjs → selectors-B7MJUn3I.mjs}

@@ -1,6 +1,6 @@
-import { ConfigError } from "./notice-DyVl5aYB.mjs";
-import { parseCsv } from "./runtime-BJtuxWM8.mjs";
-import { parseId } from "./parse-id-D4LeTUsP.mjs";
+import { ConfigError } from "./capabilities-DrDJo_ng.mjs";
+import { parseCsv } from "./runtime-B-c-Fc2i.mjs";
+import { parseId } from "./parse-id-DfY0Lugw.mjs";
 
 //#region src/commands/library/selectors.ts
 const tableSelectorFlags = {

package/dist/{set-active-oZOUe9V7.mjs → set-active-CF868qdW.mjs}

@@ -1,9 +1,7 @@
-import "./notice-DyVl5aYB.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-5H_tcfL8.mjs";
-import "./command-augment-DdZIfx1V.mjs";
-import { defineMetabaseCommand } from "./runtime-BJtuxWM8.mjs";
-import { renderSummary } from "./capabilities-N0jo5U7S.mjs";
-import { parseEnumFlag } from "./parse-enum-BL9i_brN.mjs";
+import { connectionFlags, outputFlags, profileFlag, renderSummary } from "./capabilities-DrDJo_ng.mjs";
+import "./command-augment-D9pI9Vbh.mjs";
+import { defineMetabaseCommand } from "./runtime-B-c-Fc2i.mjs";
+import { parseEnumFlag } from "./parse-enum-Cfne2suT.mjs";
 import { z } from "zod";
 
 //#region src/commands/transform-job/set-active.ts

package/dist/{set-CLHJauzG.mjs → set-kyoORFG3.mjs}

@@ -1,15 +1,14 @@
-import "./notice-DyVl5aYB.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-5H_tcfL8.mjs";
-import "./command-augment-DdZIfx1V.mjs";
-import { defineMetabaseCommand } from "./runtime-BJtuxWM8.mjs";
-import { formatScalar, renderSummary } from "./capabilities-N0jo5U7S.mjs";
-import "./input-7Sj85_K7.mjs";
-import { readBody } from "./body-IcJ5kFtk.mjs";
-import { SettingValue, settingValueView } from "./setting-m46MUtW5.mjs";
-import { parseSettingKey, rethrowSettingError } from "./key-bltP32Pm.mjs";
+import { connectionFlags, formatScalar, outputFlags, profileFlag, renderSummary } from "./capabilities-DrDJo_ng.mjs";
+import "./command-augment-D9pI9Vbh.mjs";
+import { defineMetabaseCommand } from "./runtime-B-c-Fc2i.mjs";
+import "./input-m9ctfLxZ.mjs";
+import { readBody } from "./body-C1_AaTS4.mjs";
+import { SettingValue, settingValueView } from "./setting-Cko6bE_w.mjs";
+import { parseSettingKey, rethrowSettingError } from "./key-Ge4VwWvS.mjs";
 import { z } from "zod";
 
 //#region src/commands/setting/set.ts
+const SettingValueInput = z.unknown().describe("Any JSON value; the setting's own type constraints are enforced server-side");
 var set_default = defineMetabaseCommand({
 	meta: {
 		name: "set",
@@ -35,6 +34,7 @@ var set_default = defineMetabaseCommand({
 			required: false
 		}
 	},
+	inputSchema: SettingValueInput,
 	outputSchema: SettingValue,
 	examples: [
 		`mb setting set remote-sync-branch '"main"'`,
@@ -49,7 +49,7 @@ var set_default = defineMetabaseCommand({
 			file: args.file,
 			positional: args.value,
 			source: `setting ${key} value`
-		}, z.unknown());
+		}, SettingValueInput);
 		const client = await getClient();
 		await client.requestRaw(`/api/setting/${encodeURIComponent(key)}`, {
 			method: "PUT",

package/dist/setting-BZgjURQ_.mjs

@@ -0,0 +1,20 @@
+import "./command-augment-D9pI9Vbh.mjs";
+import { defineCommandGroup } from "./group-CILtQqCL.mjs";
+
+//#region src/commands/setting/index.ts
+var setting_default = defineCommandGroup({
+	name: "setting",
+	description: "Inspect and update Metabase settings",
+	skills: [{
+		skill: "core",
+		purpose: "setting get/set JSON value quoting"
+	}],
+	subCommands: {
+		list: () => import("./list-O2w5xd1q.mjs").then((m) => m.default),
+		get: () => import("./get-Dg1J0wxb.mjs").then((m) => m.default),
+		set: () => import("./set-kyoORFG3.mjs").then((m) => m.default)
+	}
+});
+
+//#endregion
+export { setting_default as default };

package/dist/{setup-D1de5Sbc.mjs → setup-D9joJYPb.mjs}

@@ -1,19 +1,17 @@
-import "./notice-DyVl5aYB.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-5H_tcfL8.mjs";
-import "./command-augment-DdZIfx1V.mjs";
-import { defineMetabaseCommand } from "./runtime-BJtuxWM8.mjs";
-import { renderSummary } from "./capabilities-N0jo5U7S.mjs";
-import "./input-7Sj85_K7.mjs";
-import { readBody } from "./body-IcJ5kFtk.mjs";
-import { bodyInputFlags } from "./body-flags-DWTTxJpP.mjs";
+import { connectionFlags, outputFlags, profileFlag, renderSummary } from "./capabilities-DrDJo_ng.mjs";
+import "./command-augment-D9pI9Vbh.mjs";
+import { defineMetabaseCommand } from "./runtime-B-c-Fc2i.mjs";
+import "./input-m9ctfLxZ.mjs";
+import { readBody } from "./body-C1_AaTS4.mjs";
+import { bodyInputFlags } from "./body-flags-CgHgJBRC.mjs";
 import { z } from "zod";
 
 //#region src/domain/setup.ts
 const SetupUserInput = z.object({
-	first_name: z.string().nullable().optional(),
-	last_name: z.string().nullable().optional(),
-	email: z.string().min(1),
-	password: z.string().min(1)
+	first_name: z.string().min(1).nullable().optional(),
+	last_name: z.string().min(1).nullable().optional(),
+	email: z.email(),
+	password: z.string().min(1).describe("must satisfy the server's password complexity requirements")
 }).loose();
 const SetupPrefsInput = z.object({
 	site_name: z.string().min(1),
@@ -48,6 +46,7 @@ var setup_default = defineMetabaseCommand({
 		...connectionFlags,
 		...bodyInputFlags
 	},
+	inputSchema: SetupInput,
 	outputSchema: SetupResult,
 	examples: [
 		"cat setup.json | mb setup",

package/dist/{skills-B6gfH0iR.mjs → skills-BqI05u72.mjs}

@@ -1,4 +1,4 @@
-import { ConfigError, ValidationError, errorMessage, isNotFoundError } from "./notice-DyVl5aYB.mjs";
+import { ConfigError, ValidationError, errorMessage, isNotFoundError } from "./capabilities-DrDJo_ng.mjs";
 import { z } from "zod";
 import { closeSync, openSync, readFileSync, readSync, readdirSync, statSync } from "node:fs";
 import { dirname, join, resolve } from "node:path";

package/dist/{skills-NhgVypJ7.mjs → skills-D8NrJxjp.mjs}

@@ -8,9 +8,9 @@ var skills_default = defineCommand({
 	},
 	default: "list",
 	subCommands: {
-		list: () => import("./list-D5Gdz8hi.mjs").then((m) => m.default),
-		get: () => import("./get-DTqBuIf3.mjs").then((m) => m.default),
-		path: () => import("./path-5nQgdvrs.mjs").then((m) => m.default)
+		list: () => import("./list-DEkPxVZu.mjs").then((m) => m.default),
+		get: () => import("./get-KVN9ANVh.mjs").then((m) => m.default),
+		path: () => import("./path-DzhQVCH8.mjs").then((m) => m.default)
 	}
 });
 

package/dist/{snippet-CtA2Pkoa.mjs → snippet-DWiXNy4T.mjs}

@@ -46,17 +46,20 @@ const snippetView = {
 		}
 	]
 };
+const SNIPPET_NAME_PATTERN = /^(?!\s)[^}]*$/;
+const SNIPPET_NAME_MESSAGE = "snippet names cannot include '}' or start with spaces";
+const snippetName = z.string().regex(SNIPPET_NAME_PATTERN, SNIPPET_NAME_MESSAGE);
 const SnippetCreateInput = z.object({
-	name: z.string().min(1),
+	name: snippetName,
 	content: z.string(),
 	description: z.string().nullable().optional(),
 	collection_id: z.number().int().positive().nullable().optional()
 }).loose();
 const SnippetUpdateInput = z.object({
-	name: z.string().min(1).optional(),
-	content: z.string().optional(),
+	name: snippetName.nullable().optional(),
+	content: z.string().nullable().optional(),
 	description: z.string().nullable().optional(),
-	archived: z.boolean().optional(),
+	archived: z.boolean().nullable().optional(),
 	collection_id: z.number().int().positive().nullable().optional()
 }).loose();