@metabase/cli 0.1.18 → 0.2.1-alpha.bcm-ghy-4075-spawn-default-profile.eb120d1

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-BsfdXK0O.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-Be8xMtS3.mjs").then((mod) => mod.default),
+		get: () => import("./get-DTkvGu_J.mjs").then((mod) => mod.default),
+		query: () => import("./query-Dfx69iJ4.mjs").then((mod) => mod.default),
+		create: () => import("./create-VrSowEbj.mjs").then((mod) => mod.default),
+		update: () => import("./update-C1_aIL6X.mjs").then((mod) => mod.default),
+		archive: () => import("./archive-BmhehbS0.mjs").then((mod) => mod.default)
+	}
+});
+
+//#endregion
+export { card_default as default };

package/dist/{cards-BGkz5BeZ.mjs → cards-BI7zKb9M.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-CiaAfUgX.mjs";
+import "./command-augment-D9pI9Vbh.mjs";
+import { defineMetabaseCommand } from "./runtime-C6ASrgVA.mjs";
+import "./embedding-CKdw8q7p.mjs";
+import "./parameter-BZ6y-Gfs.mjs";
+import { parseId } from "./parse-id-xS1tWJAq.mjs";
+import { DashboardDetail, DashcardCompact, dashcardView } from "./dashboard-BLihjDXg.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-CiaAfUgX.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,34 @@ 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-DzCAiArV.mjs").then((mod) => mod.default),
+		db: () => import("./db-dbnxMPSR.mjs").then((mod) => mod.default),
+		table: () => import("./table-BKehBm_E.mjs").then((mod) => mod.default),
+		field: () => import("./field-CXDndCbB.mjs").then((mod) => mod.default),
+		upload: () => import("./upload-DOMoaR9f.mjs").then((mod) => mod.default),
+		card: () => import("./card-BsfdXK0O.mjs").then((mod) => mod.default),
+		dashboard: () => import("./dashboard-ARgJfamb.mjs").then((mod) => mod.default),
+		collection: () => import("./collection-2h_by9Ue.mjs").then((mod) => mod.default),
+		library: () => import("./library-BGWDIfEM.mjs").then((mod) => mod.default),
+		document: () => import("./document-DR1FLOn9.mjs").then((mod) => mod.default),
+		transform: () => import("./transform-CrOOqKen.mjs").then((mod) => mod.default),
+		"transform-job": () => import("./transform-job-J-E0Mec7.mjs").then((mod) => mod.default),
+		"transform-tag": () => import("./transform-tag-Bkyasy_s.mjs").then((mod) => mod.default),
+		setting: () => import("./setting-zrJwy48C.mjs").then((mod) => mod.default),
+		search: () => import("./search-9GSZHgJQ.mjs").then((mod) => mod.default),
+		"git-sync": () => import("./git-sync-CmB4YBmS.mjs").then((mod) => mod.default),
+		workspace: () => import("./workspace-LFtHxcw9.mjs").then((mod) => mod.default),
+		setup: () => import("./setup-Doq8atTG.mjs").then((mod) => mod.default),
+		snippet: () => import("./snippet-ScFM8re8.mjs").then((mod) => mod.default),
+		segment: () => import("./segment-C40bORNZ.mjs").then((mod) => mod.default),
+		measure: () => import("./measure-Ka0n3426.mjs").then((mod) => mod.default),
+		timeline: () => import("./timeline-n3Nw9Egt.mjs").then((mod) => mod.default),
+		"timeline-event": () => import("./timeline-event-CLWMxvE0.mjs").then((mod) => mod.default),
+		eid: () => import("./eid-CtKGjAkz.mjs").then((mod) => mod.default),
+		query: () => import("./query-CPq-dhFV.mjs").then((mod) => mod.default),
+		uuid: () => import("./uuid-DDbLKnbe.mjs").then((mod) => mod.default),
+		upgrade: () => import("./upgrade-DkK1ZbEY.mjs").then((mod) => mod.default),
+		skills: () => import("./skills-yuzH_o8s.mjs").then((mod) => mod.default)
 	}
 });
 setMetabaseAugment(main, {
@@ -96,11 +99,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 +262,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 +433,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-2h_by9Ue.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-Ov6bYzT9.mjs").then((mod) => mod.default),
+		get: () => import("./get-BQBu2c94.mjs").then((mod) => mod.default),
+		items: () => import("./items-BZpYkImP.mjs").then((mod) => mod.default),
+		tree: () => import("./tree-JZC6vD9q.mjs").then((mod) => mod.default),
+		create: () => import("./create-CQ32FwVe.mjs").then((mod) => mod.default),
+		archive: () => import("./archive-5inmbMDL.mjs").then((mod) => mod.default)
+	}
+});
+
+//#endregion
+export { collection_default as default };

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

@@ -56,7 +56,8 @@ const Collection = z.object({
 	namespace: CollectionNamespace.nullable().optional(),
 	entity_id: z.string().nullable().optional(),
 	slug: z.string().optional(),
-	can_write: z.boolean().optional()
+	can_write: z.boolean().optional(),
+	is_remote_synced: z.boolean().nullable().optional()
 }).loose();
 const CollectionCompact = Collection.pick({
 	id: true,
@@ -67,7 +68,8 @@ const CollectionCompact = Collection.pick({
 	parent_id: true,
 	type: true,
 	authority_level: true,
-	is_personal: true
+	is_personal: true,
+	is_remote_synced: true
 }).strip();
 const collectionView = {
 	compactPick: CollectionCompact,
@@ -159,7 +161,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-namespace-BP_LJrAD.mjs → collection-namespace-uNA5WhLB.mjs}

@@ -1,5 +1,5 @@
-import { ConfigError } from "./notice-DyVl5aYB.mjs";
-import { HttpError } from "./runtime-oxjmrYoP.mjs";
+import { ConfigError } from "./capabilities-CiaAfUgX.mjs";
+import { HttpError } from "./runtime-C6ASrgVA.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-Cztp5kES.mjs → create-BLD0YniB.mjs}

@@ -1,10 +1,9 @@
-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 "./collection-DrLpA1SO.mjs";
-import { Library, createLibrary, libraryView } from "./resolve-Dj2MTBkn.mjs";
+import { connectionFlags, outputFlags, profileFlag, renderSummary } from "./capabilities-CiaAfUgX.mjs";
+import "./command-augment-D9pI9Vbh.mjs";
+import { defineMetabaseCommand } from "./runtime-C6ASrgVA.mjs";
+import "./collection-C52Ndi_O.mjs";
+import "./listing-wFZuS5li.mjs";
+import { Library, createLibrary, libraryView } from "./resolve-BTZuO3Yq.mjs";
 
 //#region src/commands/library/create.ts
 var create_default = defineMetabaseCommand({

package/dist/create-BP8EIWrP.mjs

@@ -0,0 +1,161 @@
+import { ConfigError, ENV_API_KEY, connectionFlags, errorMessage, outputFlags, profileFlag, renderSummary, warn } from "./capabilities-CiaAfUgX.mjs";
+import "./command-augment-D9pI9Vbh.mjs";
+import { WORKSPACE_MANAGER_SCOPE, clearProfile, defineMetabaseCommand, keyringFallbackWarning, listProfileRecords, normalizeUrl, readEnvCredentials, readProfileCredential, resolveRecordCredential, revokeOAuthCredential, setDefaultProfile, writeProfile } from "./runtime-C6ASrgVA.mjs";
+import { promptConfirm } from "./prompt-jQnNKtlx.mjs";
+import { parseIdCsv } from "./parse-id-xS1tWJAq.mjs";
+import { Workspace, workspaceView } from "./workspace-BgH_4xFO.mjs";
+import { workspaceProfileName } from "./profile-name-CZ1-Vtrh.mjs";
+import { z } from "zod";
+
+//#region src/core/auth/stale-credentials.ts
+function findStaleParentCredentials(records, targetUrl, currentProfile) {
+	const target = normalizeUrl(targetUrl);
+	const stale = [];
+	for (const record of records) {
+		if (record.name === currentProfile || normalizeUrl(record.url) !== target) continue;
+		const resolved = resolveRecordCredential(record);
+		if (resolved === null) continue;
+		if (resolved.credential.kind === "apiKey") stale.push({
+			profile: record.name,
+			kind: "apiKey"
+		});
+		else if (resolved.credential.scope !== WORKSPACE_MANAGER_SCOPE) stale.push({
+			profile: record.name,
+			kind: "oauth",
+			scope: resolved.credential.scope
+		});
+	}
+	return stale;
+}
+function describeStaleCredential(credential) {
+	const detail = credential.kind === "apiKey" ? "api key" : credential.scope;
+	return `${credential.profile} (${detail})`;
+}
+
+//#endregion
+//#region src/commands/workspace/credential-sweep.ts
+const keepExistingAuthFlag = { keepExistingAuth: {
+	type: "boolean",
+	description: "Proceed despite broader same-server credentials in the profile store (interactive only)",
+	alias: "keep-existing-auth",
+	default: false
+} };
+async function enforceCredentialSweep(input) {
+	const records = await listProfileRecords();
+	const stale = findStaleParentCredentials(records, input.url, input.profile);
+	if (stale.length === 0) return;
+	const listing = stale.map(describeStaleCredential).join(", ");
+	const interactive = process.stdin.isTTY === true;
+	if (input.keepExistingAuth) {
+		if (!interactive) throw new ConfigError("--keep-existing-auth requires an interactive terminal; refusing to proceed with broader credentials in a non-interactive context");
+		warn(`proceeding with broader credentials left in the profile store: ${listing}`);
+		return;
+	}
+	if (!interactive) throw new ConfigError(`refusing to ${input.action}: broader credentials for this server exist in the profile store (${listing}) — revoke them with \`mb auth logout --profile <name>\` first; a human can override with --keep-existing-auth`);
+	const ok = await promptConfirm({
+		message: `Broader credentials for this server exist (${listing}). Revoke them before continuing?`,
+		initialValue: true
+	});
+	if (!ok) throw new ConfigError(`aborted: revoke the broader credentials (${listing}) with \`mb auth logout --profile <name>\` or pass --keep-existing-auth`);
+	for (const credential of stale) await revokeStaleCredential(credential);
+}
+async function revokeStaleCredential(stale) {
+	const resolved = await readProfileCredential(stale.profile);
+	await clearProfile(stale.profile);
+	if (resolved === null || resolved.credential.kind !== "oauth") {
+		warn(`cleared profile "${stale.profile}"; its API key is still active server-side — delete it in Admin settings → Authentication → API keys`);
+		return;
+	}
+	try {
+		const revoked = await revokeOAuthCredential(resolved.url, resolved.credential);
+		if (!revoked) warn(`cleared profile "${stale.profile}", but the server advertises no revocation endpoint; its tokens remain valid until they expire`);
+	} catch (error) {
+		warn(`cleared profile "${stale.profile}", but revoking server-side failed: ${errorMessage(error)}`);
+	}
+}
+
+//#endregion
+//#region src/commands/workspace/create.ts
+const SpawnedWorkspace = Workspace.extend({
+	url: z.string().optional(),
+	api_key: z.string().optional()
+});
+var create_default = defineMetabaseCommand({
+	meta: {
+		name: "create",
+		description: "Create and provision a workspace"
+	},
+	details: "Attaches the given databases and provisions warehouse isolation (a temporary schema + user per database) before returning. Each database must be eligible for workspaces; provisioning is blocking, so the response carries the final per-database status. Before creating, the profile store is swept for broader same-server credentials (any API key, any OAuth grant wider than mb:workspace-manager): interactive runs offer to revoke them, non-interactive runs refuse — --keep-existing-auth is the human-only override. With --spawn the parent also asks its instance manager to spawn a workspace Metabase; the returned credential is saved to the ws-<id> profile (never printed) and made the default, so bare `mb` targets the new workspace.",
+	capabilities: {
+		minVersion: 62,
+		tokenFeature: "workspaces"
+	},
+	args: {
+		...outputFlags,
+		...profileFlag,
+		...connectionFlags,
+		...keepExistingAuthFlag,
+		name: {
+			type: "string",
+			description: "Workspace name",
+			required: true
+		},
+		"database-ids": {
+			type: "string",
+			description: "Database ids to attach, comma separated",
+			required: true
+		},
+		spawn: {
+			type: "boolean",
+			description: "Spawn a workspace instance and save its credential as the default profile (key is never printed)",
+			default: false
+		}
+	},
+	outputSchema: Workspace,
+	examples: [
+		"mb workspace create --name ws-reports --database-ids 1",
+		"mb workspace create --name ws-etl --database-ids 1,2 --json",
+		"mb workspace create --name transform-work --database-ids 1 --spawn"
+	],
+	async run({ args, ctx, getClient, getResolvedConfig }) {
+		const databaseIds = parseIdCsv(args["database-ids"], "database id");
+		if (args.spawn) assertNoApiKeyEnvShadow();
+		const resolved = await getResolvedConfig();
+		await enforceCredentialSweep({
+			url: resolved.url,
+			profile: resolved.profile,
+			keepExistingAuth: args.keepExistingAuth === true,
+			action: "create a workspace"
+		});
+		const client = await getClient();
+		const created = await client.requestParsed(SpawnedWorkspace, "/api/ee/workspace-manager/", {
+			method: "POST",
+			body: {
+				name: args.name,
+				database_ids: databaseIds,
+				spawn_instance: args.spawn ? true : void 0
+			}
+		});
+		if (args.spawn) await saveSpawnedCredential(created);
+		const workspace = { ...created };
+		delete workspace.api_key;
+		renderSummary(workspace, workspaceView, `Created workspace ${created.id} "${created.name}".`, ctx);
+	}
+});
+function assertNoApiKeyEnvShadow() {
+	if (readEnvCredentials().apiKey !== null) throw new ConfigError(`--spawn saves the workspace credential as the default profile, but ${ENV_API_KEY} is set and would shadow it — unset ${ENV_API_KEY} first`);
+}
+async function saveSpawnedCredential(created) {
+	if (created.url === void 0 || created.api_key === void 0) throw new Error("the server did not return a spawned instance (no url/api_key in the create response) — this Metabase may not support spawn_instance");
+	const profileName = workspaceProfileName(created.id);
+	const location = await writeProfile({
+		url: normalizeUrl(created.url),
+		apiKey: created.api_key
+	}, profileName);
+	if (location.backend === "file") warn(keyringFallbackWarning(location));
+	await setDefaultProfile(profileName);
+	warn(`saved workspace credential to profile "${profileName}" and made it the default — bare \`mb\` now targets ${created.url}`);
+}
+
+//#endregion
+export { create_default as default };

package/dist/{create-CkRFKtFG.mjs → create-BpizGzgQ.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 { Snippet, SnippetCreateInput, snippetView } from "./snippet-CtA2Pkoa.mjs";
+import { connectionFlags, outputFlags, profileFlag, renderSummary } from "./capabilities-CiaAfUgX.mjs";
+import "./command-augment-D9pI9Vbh.mjs";
+import { defineMetabaseCommand } from "./runtime-C6ASrgVA.mjs";
+import "./input-BGyHn0Kr.mjs";
+import { readBody } from "./body-5snfmiwR.mjs";
+import { bodyInputFlags } from "./body-flags-CgHgJBRC.mjs";
+import { Snippet, SnippetCreateInput, snippetView } from "./snippet-C8PVaPY9.mjs";
 
 //#region src/commands/snippet/create.ts
 var create_default = defineMetabaseCommand({
@@ -21,6 +19,7 @@ var create_default = defineMetabaseCommand({
 		...connectionFlags,
 		...bodyInputFlags
 	},
+	inputSchema: SnippetCreateInput,
 	outputSchema: Snippet,
 	examples: [
 		"cat snippet.json | mb snippet create",