@metabase/cli 0.1.18 → 0.2.1

package/dist/{card-DEmcRlNO.mjs → card-B8G5jQQT.mjs}

@@ -1,5 +1,6 @@
-import { FieldBaseType, FieldSemanticType } from "./field-CMY_LWUe.mjs";
-import { Parameter, ParameterMapping } from "./parameter-CiJ4CwWE.mjs";
+import { EmbeddingParams } from "./embedding-CKdw8q7p.mjs";
+import { FieldBaseType, FieldSemanticType } from "./field-DsXTeqBy.mjs";
+import { Parameter, ParameterMapping } from "./parameter-BZ6y-Gfs.mjs";
 import { z } from "zod";
 
 //#region src/domain/card.ts
@@ -9,7 +10,7 @@ const CardType = z.enum([
 	"metric"
 ]);
 const CardQueryType = z.enum(["native", "query"]);
-const CardDatasetQuery = z.object({}).loose().refine((value) => "lib/type" in value || "type" in value, { message: "dataset_query must include \"lib/type\" (MBQL 5) or \"type\" (legacy MBQL/native); empty `{}` is rejected" });
+const CardDatasetQuery = z.object({}).loose().refine((value) => "lib/type" in value || "type" in value, { message: "dataset_query must include \"lib/type\" (MBQL 5) or \"type\" (legacy MBQL/native); empty `{}` is rejected" }).describe("MBQL 5, legacy MBQL, or native query — full MBQL 5 schema: mb query --print-schema");
 const Card = z.object({
 	id: z.number().int(),
 	name: z.string(),
@@ -70,38 +71,43 @@ const cardView = {
 		}
 	]
 };
+const CollectionIdOrEntityId = z.union([z.number().int().positive(), z.string().length(21).describe("collection entity_id (21-char NanoID)")]);
 const CardCreateInput = z.object({
 	name: z.string().min(1),
-	type: CardType.optional(),
+	type: CardType.nullable().optional(),
 	dataset_query: CardDatasetQuery,
 	display: z.string().min(1),
 	visualization_settings: z.record(z.string(), z.unknown()),
 	description: z.string().min(1).nullable().optional(),
-	collection_id: z.number().int().positive().nullable().optional(),
+	entity_id: z.string().min(1).nullable().optional(),
+	collection_id: CollectionIdOrEntityId.nullable().optional(),
 	collection_position: z.number().int().positive().nullable().optional(),
+	cache_ttl: z.number().int().positive().nullable().optional(),
 	dashboard_id: z.number().int().positive().nullable().optional(),
-	parameters: z.array(Parameter).optional(),
-	parameter_mappings: z.array(ParameterMapping).optional()
+	dashboard_tab_id: z.number().int().positive().nullable().optional(),
+	parameters: z.array(Parameter).nullable().optional(),
+	parameter_mappings: z.array(ParameterMapping).nullable().optional(),
+	result_metadata: z.array(z.unknown()).nullable().optional()
 }).loose();
 const CardUpdateInput = z.object({
-	name: z.string().min(1).optional(),
-	type: CardType.optional(),
+	name: z.string().min(1).nullable().optional(),
+	type: CardType.nullable().optional(),
 	dataset_query: CardDatasetQuery.optional(),
-	display: z.string().min(1).optional(),
-	visualization_settings: z.record(z.string(), z.unknown()).optional(),
+	display: z.string().min(1).nullable().optional(),
+	visualization_settings: z.record(z.string(), z.unknown()).nullable().optional(),
 	description: z.string().nullable().optional(),
-	archived: z.boolean().optional(),
-	enable_embedding: z.boolean().optional(),
-	embedding_type: z.string().optional(),
-	embedding_params: z.unknown().optional(),
+	archived: z.boolean().nullable().optional(),
+	enable_embedding: z.boolean().nullable().optional(),
+	embedding_type: z.string().nullable().optional(),
+	embedding_params: EmbeddingParams.nullable().optional(),
 	collection_id: z.number().int().positive().nullable().optional(),
 	collection_position: z.number().int().positive().nullable().optional(),
-	collection_preview: z.boolean().optional(),
+	collection_preview: z.boolean().nullable().optional(),
 	cache_ttl: z.number().int().positive().nullable().optional(),
 	dashboard_id: z.number().int().positive().nullable().optional(),
 	dashboard_tab_id: z.number().int().positive().nullable().optional(),
-	parameters: z.array(Parameter).optional(),
-	parameter_mappings: z.array(ParameterMapping).optional(),
+	parameters: z.array(Parameter).nullable().optional(),
+	parameter_mappings: z.array(ParameterMapping).nullable().optional(),
 	result_metadata: z.array(z.unknown()).nullable().optional()
 }).loose();
 const QueryColumn = z.object({

package/dist/card-Ct-q_C4S.mjs

@@ -0,0 +1,26 @@
+import "./command-augment-D9pI9Vbh.mjs";
+import { defineCommandGroup } from "./group-CILtQqCL.mjs";
+
+//#region src/commands/card/index.ts
+var card_default = defineCommandGroup({
+	name: "card",
+	description: "Manage Metabase cards (questions, models, metrics)",
+	skills: [{
+		skill: "mbql",
+		purpose: "author the dataset_query"
+	}, {
+		skill: "visualization",
+		purpose: "choose display and visualization_settings"
+	}],
+	subCommands: {
+		list: () => import("./list-n2PY3OIx.mjs").then((mod) => mod.default),
+		get: () => import("./get-DZatHVdn.mjs").then((mod) => mod.default),
+		query: () => import("./query-Cxh9hmrP.mjs").then((mod) => mod.default),
+		create: () => import("./create-C3DThF9E.mjs").then((mod) => mod.default),
+		update: () => import("./update-D7Ia9Qrt.mjs").then((mod) => mod.default),
+		archive: () => import("./archive-Oh1iZu2y.mjs").then((mod) => mod.default)
+	}
+});
+
+//#endregion
+export { card_default as default };

package/dist/{cards-BGkz5BeZ.mjs → cards-CYSyvN7Z.mjs}

@@ -1,11 +1,10 @@
-import "./notice-DyVl5aYB.mjs";
-import { connectionFlags, listEnvelopeSchema, outputFlags, profileFlag, wrapList } from "./error-BaBm-UrT.mjs";
-import "./command-augment-DdZIfx1V.mjs";
-import { defineMetabaseCommand } from "./runtime-oxjmrYoP.mjs";
-import { renderList } from "./capabilities-N0jo5U7S.mjs";
-import "./parameter-CiJ4CwWE.mjs";
-import { parseId } from "./parse-id-DlXnOcmP.mjs";
-import { DashboardDetail, DashcardCompact, dashcardView } from "./dashboard-DOplbKyQ.mjs";
+import { connectionFlags, listEnvelopeSchema, outputFlags, profileFlag, renderList, wrapList } from "./capabilities-DOTcPraV.mjs";
+import "./command-augment-D9pI9Vbh.mjs";
+import { defineMetabaseCommand } from "./runtime-Ab96yYlM.mjs";
+import "./embedding-CKdw8q7p.mjs";
+import "./parameter-BZ6y-Gfs.mjs";
+import { parseId } from "./parse-id-CD54Chc5.mjs";
+import { DashboardDetail, DashcardCompact, dashcardView } from "./dashboard-B-MTpfeS.mjs";
 
 //#region src/commands/dashboard/cards.ts
 const DashcardListEnvelope = listEnvelopeSchema(DashcardCompact);

package/dist/cli.mjs

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
-import { ConfigError, flagConsumesValue, normalizeFlag, resolveCitty, toAliasArray } from "./notice-DyVl5aYB.mjs";
-import { connectionFlags, outputFlags, package_default, profileFlag, reportError } from "./error-BaBm-UrT.mjs";
-import { getMetabaseAugment, setMetabaseAugment } from "./command-augment-DdZIfx1V.mjs";
+import { Capabilities, ConfigError, connectionFlags, flagConsumesValue, jsonLine, normalizeFlag, outputFlags, package_default, profileFlag, reportError, resolveCitty, toAliasArray } from "./capabilities-DOTcPraV.mjs";
+import { getMetabaseAugment, setMetabaseAugment } from "./command-augment-D9pI9Vbh.mjs";
 import { defineCommand, renderUsage, runMain } from "citty";
+import { z } from "zod";
 
 //#region src/commands/global-flags.ts
 const ARGUMENT_SEPARATOR = "--";
@@ -59,31 +59,33 @@ const main = defineCommand({
 		description: package_default.description
 	},
 	subCommands: {
-		auth: () => import("./auth--PWX0oj5.mjs").then((mod) => mod.default),
-		db: () => import("./db-BCAURQei.mjs").then((mod) => mod.default),
-		table: () => import("./table-BwGOz97O.mjs").then((mod) => mod.default),
-		field: () => import("./field-CloFa1oe.mjs").then((mod) => mod.default),
-		card: () => import("./card-D07WYCQY.mjs").then((mod) => mod.default),
-		dashboard: () => import("./dashboard-Crh4v6Fq.mjs").then((mod) => mod.default),
-		collection: () => import("./collection-Dss2qSEF.mjs").then((mod) => mod.default),
-		library: () => import("./library-1AAVbk-K.mjs").then((mod) => mod.default),
-		document: () => import("./document-upxL2nKH.mjs").then((mod) => mod.default),
-		transform: () => import("./transform-B65ZD9-e.mjs").then((mod) => mod.default),
-		"transform-job": () => import("./transform-job-BWVKXSV6.mjs").then((mod) => mod.default),
-		"transform-tag": () => import("./transform-tag-C4qvmicL.mjs").then((mod) => mod.default),
-		setting: () => import("./setting-BbdKR-lO.mjs").then((mod) => mod.default),
-		search: () => import("./search-Vo-BqliA.mjs").then((mod) => mod.default),
-		"git-sync": () => import("./git-sync-C9m-OHac.mjs").then((mod) => mod.default),
-		setup: () => import("./setup-CzYFvFK5.mjs").then((mod) => mod.default),
-		snippet: () => import("./snippet-Bzo2U9Fv.mjs").then((mod) => mod.default),
-		segment: () => import("./segment-BuN_IoM8.mjs").then((mod) => mod.default),
-		measure: () => import("./measure-Cbly1r0E.mjs").then((mod) => mod.default),
-		eid: () => import("./eid-BCuJRv7a.mjs").then((mod) => mod.default),
-		query: () => import("./query-DSKQZu91.mjs").then((mod) => mod.default),
-		uuid: () => import("./uuid-ByJmWV7b.mjs").then((mod) => mod.default),
-		upgrade: () => import("./upgrade-DsXlfPef.mjs").then((mod) => mod.default),
-		skills: () => import("./skills-CR2xyV33.mjs").then((mod) => mod.default),
-		__manifest: () => import("./manifest-BVf8P4bl.mjs").then((mod) => mod.createManifestCommand(main))
+		auth: () => import("./auth-hgAnMUfi.mjs").then((mod) => mod.default),
+		db: () => import("./db-eWy7A-H3.mjs").then((mod) => mod.default),
+		table: () => import("./table-DHmaW3Ec.mjs").then((mod) => mod.default),
+		field: () => import("./field-BTCw6voJ.mjs").then((mod) => mod.default),
+		upload: () => import("./upload-D3eiApa0.mjs").then((mod) => mod.default),
+		card: () => import("./card-Ct-q_C4S.mjs").then((mod) => mod.default),
+		dashboard: () => import("./dashboard-B1iRSUBI.mjs").then((mod) => mod.default),
+		collection: () => import("./collection-K82kJWdj.mjs").then((mod) => mod.default),
+		library: () => import("./library-DF2qx50w.mjs").then((mod) => mod.default),
+		document: () => import("./document-CVxhTnUD.mjs").then((mod) => mod.default),
+		transform: () => import("./transform-Cq2_muWO.mjs").then((mod) => mod.default),
+		"transform-job": () => import("./transform-job-BpebgMnq.mjs").then((mod) => mod.default),
+		"transform-tag": () => import("./transform-tag-B1xnFa9w.mjs").then((mod) => mod.default),
+		setting: () => import("./setting-B9xSyMf6.mjs").then((mod) => mod.default),
+		search: () => import("./search-DnGEh6sZ.mjs").then((mod) => mod.default),
+		"git-sync": () => import("./git-sync-Cjrx2meo.mjs").then((mod) => mod.default),
+		setup: () => import("./setup-CXGcyTuv.mjs").then((mod) => mod.default),
+		snippet: () => import("./snippet-C4h-GMUf.mjs").then((mod) => mod.default),
+		segment: () => import("./segment-DyVTZSIM.mjs").then((mod) => mod.default),
+		measure: () => import("./measure-CPqisgyf.mjs").then((mod) => mod.default),
+		timeline: () => import("./timeline-B0R6-dm8.mjs").then((mod) => mod.default),
+		"timeline-event": () => import("./timeline-event-BVDTt-pM.mjs").then((mod) => mod.default),
+		eid: () => import("./eid-DSOk7Khb.mjs").then((mod) => mod.default),
+		query: () => import("./query-B3HDIsJ-.mjs").then((mod) => mod.default),
+		uuid: () => import("./uuid-D6dao_q4.mjs").then((mod) => mod.default),
+		upgrade: () => import("./upgrade-CXoNQ4FH.mjs").then((mod) => mod.default),
+		skills: () => import("./skills-rnvVgau4.mjs").then((mod) => mod.default)
 	}
 });
 setMetabaseAugment(main, {
@@ -96,11 +98,128 @@ setMetabaseAugment(main, {
 		skill: "data-workflow",
 		purpose: "guided end-to-end: raw data → clean tables → metrics → answers → dashboards"
 	}],
+	inputSchema: null,
 	outputSchema: null,
 	capabilities: null
 });
 var main_default = main;
 
+//#endregion
+//#region src/runtime/command-help.ts
+const CommandHelpArg = z.object({
+	name: z.string(),
+	type: z.enum([
+		"string",
+		"boolean",
+		"positional",
+		"enum"
+	]),
+	required: z.boolean(),
+	description: z.string().optional(),
+	default: z.union([
+		z.string(),
+		z.boolean(),
+		z.number()
+	]).optional(),
+	alias: z.array(z.string()).optional(),
+	options: z.array(z.string()).optional()
+});
+const CommandHelpSkill = z.object({
+	skill: z.string(),
+	purpose: z.string()
+});
+const CommandHelpEntry = z.object({
+	command: z.string(),
+	description: z.string(),
+	details: z.string().optional(),
+	skills: z.array(CommandHelpSkill),
+	examples: z.array(z.string()),
+	args: z.array(CommandHelpArg),
+	inputSchema: z.unknown().nullable(),
+	outputSchema: z.unknown().nullable(),
+	capabilities: Capabilities.nullable()
+});
+const CommandIndexEntry = z.object({
+	command: z.string(),
+	description: z.string()
+});
+const CommandHelpIndex = z.object({ commands: z.array(CommandIndexEntry) });
+const EMPTY_AUGMENT = {
+	examples: [],
+	details: null,
+	skills: [],
+	inputSchema: null,
+	outputSchema: null,
+	capabilities: null
+};
+async function buildHelpEntry(cmd, path) {
+	const meta = await resolveCitty(cmd.meta);
+	const args = await resolveCitty(cmd.args) ?? {};
+	const augment = getMetabaseAugment(cmd) ?? EMPTY_AUGMENT;
+	const entry = {
+		command: path.join(" "),
+		description: readDescription(meta),
+		skills: Array.from(augment.skills),
+		examples: Array.from(augment.examples),
+		args: convertArgs(args),
+		inputSchema: augment.inputSchema ? z.toJSONSchema(augment.inputSchema) : null,
+		outputSchema: augment.outputSchema ? z.toJSONSchema(augment.outputSchema) : null,
+		capabilities: augment.capabilities
+	};
+	if (augment.details !== null) entry.details = augment.details;
+	return entry;
+}
+async function buildHelpIndex(cmd, path) {
+	return { commands: await walk(cmd, path) };
+}
+async function walk(cmd, path) {
+	const meta = await resolveCitty(cmd.meta);
+	if (meta?.hidden === true) return [];
+	const subCommands = await resolveCitty(cmd.subCommands);
+	if (subCommands && Object.keys(subCommands).length > 0) {
+		const groups = await Promise.all(Object.entries(subCommands).map(async ([name, lazy]) => {
+			const sub = await resolveCitty(lazy);
+			return sub ? walk(sub, [...path, name]) : [];
+		}));
+		return groups.flat();
+	}
+	return [{
+		command: path.join(" "),
+		description: readDescription(meta)
+	}];
+}
+function readDescription(meta) {
+	if (meta === void 0) return "";
+	return typeof meta.description === "string" ? meta.description : "";
+}
+function convertArgs(args) {
+	return Object.entries(args).map(([name, def]) => convertArg(name, def));
+}
+function convertArg(name, def) {
+	const arg = {
+		name,
+		type: def.type ?? "string",
+		required: def.required === true && def.default === void 0
+	};
+	if (def.description) arg.description = def.description;
+	if (isPrimitiveDefault(def.default)) arg.default = def.default;
+	const alias = readAlias(def);
+	if (alias.length > 0) arg.alias = alias;
+	const options = readOptions(def);
+	if (options.length > 0) arg.options = options;
+	return arg;
+}
+function readOptions(def) {
+	if (!("options" in def) || !Array.isArray(def.options)) return [];
+	return [...def.options];
+}
+function readAlias(def) {
+	return "alias" in def ? toAliasArray(def.alias) : [];
+}
+function isPrimitiveDefault(value) {
+	return typeof value === "string" || typeof value === "boolean" || typeof value === "number";
+}
+
 //#endregion
 //#region src/output/help.ts
 const ANSI_ESC = String.fromCharCode(27);
@@ -142,7 +261,30 @@ async function showUsage(cmd, parent, breadcrumb) {
 	if (examples.length > 0) sections.push(renderExamples(examples));
 	if (skills.length > 0) sections.push(renderSkillsSection(skills, isRoot));
 	if (isRoot) sections.push(GETTING_STARTED_HINT);
-	process.stdout.write(sections.join("\n\n") + "\n");
+	sections.push(machineHelpHint(breadcrumb ?? cittyName, hasSubCommands));
+	await writeUsage(sections.join("\n\n") + "\n");
+}
+async function showUsageJson(cmd, breadcrumb) {
+	const path = breadcrumbPath(breadcrumb);
+	const subCommands = await resolveCitty(cmd.subCommands);
+	const hasSubCommands = subCommands !== void 0 && Object.keys(subCommands).length > 0;
+	const payload = hasSubCommands ? await buildHelpIndex(cmd, path) : await buildHelpEntry(cmd, path);
+	await writeUsage(jsonLine(payload));
+}
+function writeUsage(text) {
+	return new Promise((resolve, reject) => {
+		process.stdout.write(text, (error) => error ? reject(error) : resolve());
+	});
+}
+function breadcrumbPath(breadcrumb) {
+	const segments = breadcrumb.split(" ").filter((segment) => segment.length > 0);
+	return segments[0] === CLI_NAME ? segments.slice(1) : segments;
+}
+const MACHINE_HELP_LEAF_LABEL = "Machine-readable help (flags, output schema):";
+const MACHINE_HELP_INDEX_LABEL = "Machine-readable command index:";
+function machineHelpHint(breadcrumb, hasSubCommands) {
+	const label = hasSubCommands ? MACHINE_HELP_INDEX_LABEL : MACHINE_HELP_LEAF_LABEL;
+	return `${label} ${breadcrumb} --help --json`;
 }
 function transformBody(lines, rewrite) {
 	const mapped = lines.map((line, index) => {
@@ -290,10 +432,16 @@ async function findSubCommand(subCommands, token) {
 //#endregion
 //#region src/cli.ts
 const HELP_FLAGS = new Set(["--help", "-h"]);
+const JSON_HELP_FLAG = "--json";
 async function run() {
 	const rawArgs = hoistGlobalFlags(process.argv.slice(2));
+	const wantsJsonHelp = rawArgs.includes(JSON_HELP_FLAG);
 	const showUsageWithBreadcrumb = async (cmd, parent) => {
 		const breadcrumb = await resolveBreadcrumb(main_default, rawArgs);
+		if (wantsJsonHelp) {
+			await showUsageJson(cmd, breadcrumb);
+			return;
+		}
 		await showUsage(cmd, parent, breadcrumb);
 	};
 	if (rawArgs.length === 0) {

package/dist/{collection-DrLpA1SO.mjs → collection-CFoLPrY5.mjs}

@@ -159,7 +159,7 @@ const CollectionTreeNodeBase = z.object({
 const CollectionTreeNode = CollectionTreeNodeBase.extend({ children: z.lazy(() => z.array(CollectionTreeNode)) });
 const CollectionCreateInput = z.object({
 	name: z.string().min(1),
-	description: z.string().nullable().optional(),
+	description: z.string().min(1).nullable().optional(),
 	parent_id: z.number().int().positive().nullable().optional(),
 	namespace: CollectionNamespace.nullable().optional(),
 	authority_level: CollectionAuthorityLevel.nullable().optional()

package/dist/collection-K82kJWdj.mjs

@@ -0,0 +1,23 @@
+import "./command-augment-D9pI9Vbh.mjs";
+import { defineCommandGroup } from "./group-CILtQqCL.mjs";
+
+//#region src/commands/collection/index.ts
+var collection_default = defineCommandGroup({
+	name: "collection",
+	description: "Manage Metabase collections",
+	skills: [{
+		skill: "core",
+		purpose: "collection ref forms and the transforms namespace"
+	}],
+	subCommands: {
+		list: () => import("./list-C0344yqi.mjs").then((mod) => mod.default),
+		get: () => import("./get-DRK5-UdU.mjs").then((mod) => mod.default),
+		items: () => import("./items-DN63mjpF.mjs").then((mod) => mod.default),
+		tree: () => import("./tree-CB2IURsX.mjs").then((mod) => mod.default),
+		create: () => import("./create-nXlnVzXl.mjs").then((mod) => mod.default),
+		archive: () => import("./archive-BM9HjJHQ.mjs").then((mod) => mod.default)
+	}
+});
+
+//#endregion
+export { collection_default as default };

package/dist/{collection-namespace-BP_LJrAD.mjs → collection-namespace-C7mr_a8H.mjs}

@@ -1,5 +1,5 @@
-import { ConfigError } from "./notice-DyVl5aYB.mjs";
-import { HttpError } from "./runtime-oxjmrYoP.mjs";
+import { ConfigError } from "./capabilities-DOTcPraV.mjs";
+import { HttpError } from "./runtime-Ab96yYlM.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.";

package/dist/{create-CD9Rp8qs.mjs → create-7pbf5Wu0.mjs}

@@ -1,17 +1,16 @@
-import "./notice-DyVl5aYB.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-BaBm-UrT.mjs";
-import "./command-augment-DdZIfx1V.mjs";
-import { defineMetabaseCommand } from "./runtime-oxjmrYoP.mjs";
-import { renderSummary } from "./capabilities-N0jo5U7S.mjs";
-import "./input-7Sj85_K7.mjs";
-import "./field-CMY_LWUe.mjs";
-import "./parameter-CiJ4CwWE.mjs";
-import "./card-DEmcRlNO.mjs";
-import { readBody } from "./body-BS2s2zDl.mjs";
-import { bodyInputFlags } from "./body-flags-DWTTxJpP.mjs";
-import "./validate-BqNW4Sk1.mjs";
-import { Dashboard, DashboardCreateInput, DashboardDetail, dashboardView } from "./dashboard-DOplbKyQ.mjs";
-import { preflightDashcardCardReferences, wrapChainedDashboardWriteError } from "./preflight-DvaPQHHf.mjs";
+import { connectionFlags, outputFlags, profileFlag, renderSummary } from "./capabilities-DOTcPraV.mjs";
+import "./command-augment-D9pI9Vbh.mjs";
+import { defineMetabaseCommand } from "./runtime-Ab96yYlM.mjs";
+import "./input-DzbvxKYU.mjs";
+import "./embedding-CKdw8q7p.mjs";
+import "./field-DsXTeqBy.mjs";
+import "./parameter-BZ6y-Gfs.mjs";
+import "./card-B8G5jQQT.mjs";
+import { readBody } from "./body-DKcQw7G5.mjs";
+import { bodyInputFlags } from "./body-flags-CgHgJBRC.mjs";
+import "./validate-Cqa14t7o.mjs";
+import { Dashboard, DashboardCreateInput, DashboardDetail, dashboardView } from "./dashboard-B-MTpfeS.mjs";
+import { preflightDashcardCardReferences, wrapChainedDashboardWriteError } from "./preflight-xhwEOHAt.mjs";
 
 //#region src/commands/dashboard/create.ts
 var create_default = defineMetabaseCommand({
@@ -34,6 +33,7 @@ var create_default = defineMetabaseCommand({
 		...connectionFlags,
 		...bodyInputFlags
 	},
+	inputSchema: DashboardCreateInput,
 	outputSchema: Dashboard,
 	examples: [
 		"cat dashboard.json | mb dashboard create",

package/dist/{create-DzyMvAVy.mjs → create-BDY38_Kr.mjs}

@@ -1,12 +1,10 @@
-import "./notice-DyVl5aYB.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-BaBm-UrT.mjs";
-import "./command-augment-DdZIfx1V.mjs";
-import { defineMetabaseCommand } from "./runtime-oxjmrYoP.mjs";
-import { renderSummary } from "./capabilities-N0jo5U7S.mjs";
-import "./input-7Sj85_K7.mjs";
-import { readBody } from "./body-BS2s2zDl.mjs";
-import { bodyInputFlags } from "./body-flags-DWTTxJpP.mjs";
-import { Document, DocumentCreateInput, documentView } from "./document-1W7NRaO_.mjs";
+import { connectionFlags, outputFlags, profileFlag, renderSummary } from "./capabilities-DOTcPraV.mjs";
+import "./command-augment-D9pI9Vbh.mjs";
+import { defineMetabaseCommand } from "./runtime-Ab96yYlM.mjs";
+import "./input-DzbvxKYU.mjs";
+import { readBody } from "./body-DKcQw7G5.mjs";
+import { bodyInputFlags } from "./body-flags-CgHgJBRC.mjs";
+import { Document, DocumentCreateInput, documentView } from "./document-CL4ML5FN.mjs";
 
 //#region src/commands/document/create.ts
 var create_default = defineMetabaseCommand({
@@ -21,6 +19,7 @@ var create_default = defineMetabaseCommand({
 		...connectionFlags,
 		...bodyInputFlags
 	},
+	inputSchema: DocumentCreateInput,
 	outputSchema: Document,
 	examples: [
 		"cat doc.json | mb document create",

package/dist/create-Brh8WCa3.mjs

@@ -0,0 +1,45 @@
+import { connectionFlags, outputFlags, profileFlag, renderSummary } from "./capabilities-DOTcPraV.mjs";
+import "./command-augment-D9pI9Vbh.mjs";
+import { defineMetabaseCommand } from "./runtime-Ab96yYlM.mjs";
+import "./input-DzbvxKYU.mjs";
+import { readBody } from "./body-DKcQw7G5.mjs";
+import { bodyInputFlags } from "./body-flags-CgHgJBRC.mjs";
+import { Timeline, TimelineCreateInput, timelineView } from "./timeline-BCTRThc-.mjs";
+
+//#region src/commands/timeline/create.ts
+var create_default = defineMetabaseCommand({
+	meta: {
+		name: "create",
+		description: "Create a timeline from JSON"
+	},
+	details: "The JSON body needs `name`; optional fields: `description`, `icon` (star|cake|mail|warning|bell|cloud, default star), `collection_id` (null = root collection), `default`.",
+	capabilities: { minVersion: 58 },
+	args: {
+		...outputFlags,
+		...profileFlag,
+		...connectionFlags,
+		...bodyInputFlags
+	},
+	inputSchema: TimelineCreateInput,
+	outputSchema: Timeline,
+	examples: [
+		"mb timeline create --body '{\"name\":\"Releases\"}'",
+		"cat timeline.json | mb timeline create",
+		"mb timeline create --file timeline.json"
+	],
+	async run({ args, ctx, getClient }) {
+		const body = await readBody({
+			flag: args.body,
+			file: args.file
+		}, TimelineCreateInput);
+		const client = await getClient();
+		const created = await client.requestParsed(Timeline, "/api/timeline", {
+			method: "POST",
+			body
+		});
+		renderSummary(created, timelineView, `Created timeline ${created.id} "${created.name}".`, ctx);
+	}
+});
+
+//#endregion
+export { create_default as default };

package/dist/{create-DhrftYre.mjs → create-C3DThF9E.mjs}

@@ -1,16 +1,15 @@
-import "./notice-DyVl5aYB.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-BaBm-UrT.mjs";
-import "./command-augment-DdZIfx1V.mjs";
-import { defineMetabaseCommand } from "./runtime-oxjmrYoP.mjs";
-import { renderSummary } from "./capabilities-N0jo5U7S.mjs";
-import "./input-7Sj85_K7.mjs";
-import "./field-CMY_LWUe.mjs";
-import "./parameter-CiJ4CwWE.mjs";
-import { Card, CardCreateInput, cardView } from "./card-DEmcRlNO.mjs";
-import { readBody } from "./body-BS2s2zDl.mjs";
-import { bodyInputFlags } from "./body-flags-DWTTxJpP.mjs";
-import "./validate-BqNW4Sk1.mjs";
-import { CARD_DATASET_QUERY_LABELS, preflightMbql5Query, skipValidateFlag } from "./validate-query-CcZVKYPV.mjs";
+import { connectionFlags, outputFlags, profileFlag, renderSummary } from "./capabilities-DOTcPraV.mjs";
+import "./command-augment-D9pI9Vbh.mjs";
+import { defineMetabaseCommand } from "./runtime-Ab96yYlM.mjs";
+import "./input-DzbvxKYU.mjs";
+import "./embedding-CKdw8q7p.mjs";
+import "./field-DsXTeqBy.mjs";
+import "./parameter-BZ6y-Gfs.mjs";
+import { Card, CardCreateInput, cardView } from "./card-B8G5jQQT.mjs";
+import { readBody } from "./body-DKcQw7G5.mjs";
+import { bodyInputFlags } from "./body-flags-CgHgJBRC.mjs";
+import "./validate-Cqa14t7o.mjs";
+import { CARD_DATASET_QUERY_LABELS, preflightMbql5Query, skipValidateFlag } from "./validate-query-D1N30wJ7.mjs";
 
 //#region src/commands/card/create.ts
 var create_default = defineMetabaseCommand({
@@ -18,7 +17,7 @@ var create_default = defineMetabaseCommand({
 		name: "create",
 		description: "Create a card (question, model, or metric) from JSON"
 	},
-	details: "The JSON body needs `name`, `display` (the visualization — e.g. table, bar, scalar), `dataset_query` (the query powering the card), and `visualization_settings` (`{}` is fine). When `dataset_query` is an MBQL 5 query it is checked against a bundled JSON Schema before sending — fix the reported errors, or pass --skip-validate to send anyway. Native-SQL and legacy queries are sent unchecked.",
+	details: "The JSON body needs `name`, `display` (the visualization — e.g. table, bar, scalar), `dataset_query` (the query powering the card), and `visualization_settings` (`{}` is fine). When `dataset_query` is an MBQL 5 query it is checked against a bundled JSON Schema (print it with `mb query --print-schema`) before sending — fix the reported errors, or pass --skip-validate to send anyway. Native-SQL and legacy queries are sent unchecked.",
 	skills: [
 		{
 			skill: "mbql",
@@ -41,6 +40,7 @@ var create_default = defineMetabaseCommand({
 		...bodyInputFlags,
 		...skipValidateFlag
 	},
+	inputSchema: CardCreateInput,
 	outputSchema: Card,
 	examples: [
 		"cat card.json | mb card create",

package/dist/{create-B4HAEEE0.mjs → create-CPEOSxIH.mjs}

@@ -1,12 +1,10 @@
-import "./notice-DyVl5aYB.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-BaBm-UrT.mjs";
-import "./command-augment-DdZIfx1V.mjs";
-import { defineMetabaseCommand } from "./runtime-oxjmrYoP.mjs";
-import { renderSummary } from "./capabilities-N0jo5U7S.mjs";
-import "./input-7Sj85_K7.mjs";
-import { readBody } from "./body-BS2s2zDl.mjs";
-import { bodyInputFlags } from "./body-flags-DWTTxJpP.mjs";
-import { TransformTag, TransformTagCreateInput, transformTagView } from "./transform-tag-rsIrckCM.mjs";
+import { connectionFlags, outputFlags, profileFlag, renderSummary } from "./capabilities-DOTcPraV.mjs";
+import "./command-augment-D9pI9Vbh.mjs";
+import { defineMetabaseCommand } from "./runtime-Ab96yYlM.mjs";
+import "./input-DzbvxKYU.mjs";
+import { readBody } from "./body-DKcQw7G5.mjs";
+import { bodyInputFlags } from "./body-flags-CgHgJBRC.mjs";
+import { TransformTag, TransformTagCreateInput, transformTagView } from "./transform-tag--IBQ-8Ij.mjs";
 
 //#region src/commands/transform-tag/create.ts
 var create_default = defineMetabaseCommand({
@@ -21,6 +19,7 @@ var create_default = defineMetabaseCommand({
 		...connectionFlags,
 		...bodyInputFlags
 	},
+	inputSchema: TransformTagCreateInput,
 	outputSchema: TransformTag,
 	examples: [
 		"mb transform-tag create --body '{\"name\":\"nightly\"}'",

package/dist/{create-YfGzANNB.mjs → create-C_WqoOf5.mjs}

@@ -1,12 +1,10 @@
-import "./notice-DyVl5aYB.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-BaBm-UrT.mjs";
-import "./command-augment-DdZIfx1V.mjs";
-import { defineMetabaseCommand } from "./runtime-oxjmrYoP.mjs";
-import { renderSummary } from "./capabilities-N0jo5U7S.mjs";
-import "./input-7Sj85_K7.mjs";
-import { readBody } from "./body-BS2s2zDl.mjs";
-import { bodyInputFlags } from "./body-flags-DWTTxJpP.mjs";
-import { TransformJob, TransformJobCreateInput, transformJobView } from "./transform-job-CtixL4An.mjs";
+import { connectionFlags, outputFlags, profileFlag, renderSummary } from "./capabilities-DOTcPraV.mjs";
+import "./command-augment-D9pI9Vbh.mjs";
+import { defineMetabaseCommand } from "./runtime-Ab96yYlM.mjs";
+import "./input-DzbvxKYU.mjs";
+import { readBody } from "./body-DKcQw7G5.mjs";
+import { bodyInputFlags } from "./body-flags-CgHgJBRC.mjs";
+import { TransformJob, TransformJobCreateInput, transformJobView } from "./transform-job-CjsAXMej.mjs";
 
 //#region src/commands/transform-job/create.ts
 var create_default = defineMetabaseCommand({
@@ -21,6 +19,7 @@ var create_default = defineMetabaseCommand({
 		...connectionFlags,
 		...bodyInputFlags
 	},
+	inputSchema: TransformJobCreateInput,
 	outputSchema: TransformJob,
 	examples: [
 		"cat job.json | mb transform-job create",