@metabase/cli 0.5.3 → 0.5.5

package/dist/cli.mjs

@@ -1,206 +1,10 @@
 #!/usr/bin/env node
+import { a as ChainedRequestError, b as toMetabaseError, g as errorMessage, h as ValidationError, i as AbortError, l as MetabaseError, o as ConfigError, r as isPlainObject, x as KNOWN_RANGE } from "./predicates-0C0TsWcJ.mjs";
 import { defineCommand, parseArgs, renderUsage, runMain } from "citty";
-import { ZodError, core, z } from "zod";
+import { z } from "zod";
 import tls from "node:tls";
 import { confirm, isCancel, password, select, text } from "@clack/prompts";
 import Table from "cli-table3";
-//#region ../client/src/json-pointer.ts
-function escapeJsonPointerSegment(key) {
-	if (typeof key === "number") return String(key);
-	return (typeof key === "symbol" ? key.toString() : key).replaceAll("~", "~0").replaceAll("/", "~1");
-}
-//#endregion
-//#region ../client/src/version/known-range.ts
-const KNOWN_RANGE = {
-	min: 58,
-	max: 64
-};
-//#endregion
-//#region ../client/src/errors.ts
-var MetabaseError = class extends Error {
-	get userMessage() {
-		return this.message;
-	}
-};
-var NetworkError = class extends MetabaseError {
-	category = "network";
-	isRetryable = true;
-	developerDetail;
-	constructor(message, developerDetail) {
-		super(message);
-		this.name = "NetworkError";
-		this.developerDetail = developerDetail;
-	}
-};
-var TimeoutError = class extends MetabaseError {
-	category = "timeout";
-	isRetryable = true;
-	developerDetail;
-	constructor(message, developerDetail) {
-		super(message);
-		this.name = "TimeoutError";
-		this.developerDetail = developerDetail;
-	}
-};
-var ValidationError = class extends MetabaseError {
-	category = "validation";
-	isRetryable = false;
-	developerDetail;
-	constructor(message, developerDetail) {
-		super(message);
-		this.name = "ValidationError";
-		this.developerDetail = developerDetail;
-	}
-	get userMessage() {
-		const issues = this.developerDetail.zodIssues;
-		if (issues.length === 0) return this.message;
-		return `${this.message}\n${formatIssueLines(issues, VALIDATION_ISSUE_FORMAT)}`;
-	}
-};
-const VALIDATION_MAX_ISSUES = 10;
-const RESPONSE_SHAPE_MAX_ISSUES = 5;
-const VALIDATION_ISSUE_FORMAT = {
-	max: VALIDATION_MAX_ISSUES,
-	formatIssue: (issue) => `${formatZodIssuePointer(issue.path)}: ${issue.message}`
-};
-const RESPONSE_SHAPE_ISSUE_FORMAT = {
-	max: RESPONSE_SHAPE_MAX_ISSUES,
-	formatIssue: formatZodIssue
-};
-function formatIssueLines(issues, format) {
-	const head = issues.slice(0, format.max).map(format.formatIssue);
-	const overflow = issues.length - format.max;
-	if (overflow > 0) head.push(`... and ${overflow} more`);
-	return head.map((line) => `  ${line}`).join("\n");
-}
-function formatZodIssuePointer(path) {
-	if (path.length === 0) return "/";
-	return path.map((key) => `/${escapeJsonPointerSegment(key)}`).join("");
-}
-const RESPONSE_SHAPE_LEAD_UNKNOWN_VERSION = "Metabase returned unexpected response shape";
-var ResponseShapeError = class ResponseShapeError extends MetabaseError {
-	category = "response-shape";
-	isRetryable = false;
-	developerDetail;
-	constructor(message, developerDetail) {
-		super(message);
-		this.name = "ResponseShapeError";
-		this.developerDetail = developerDetail;
-	}
-	static fromZodIssues(developerDetail) {
-		return new ResponseShapeError(formatResponseShapeMessage(developerDetail), developerDetail);
-	}
-};
-function formatResponseShapeMessage(detail) {
-	const { zodIssues: issues, serverTag, serverSkew } = detail;
-	const lead = serverTag === null ? RESPONSE_SHAPE_LEAD_UNKNOWN_VERSION : `On Metabase ${describeServer(serverTag, serverSkew)} the response shape was unexpected`;
-	if (issues.length === 0) return lead;
-	return `${lead}:\n${formatIssueLines(issues, RESPONSE_SHAPE_ISSUE_FORMAT)}`;
-}
-function describeServer(tag, skew) {
-	if (skew === "newer-than-known") return `${tag} (newer than this client supports, up to v${KNOWN_RANGE.max})`;
-	if (skew === "development") return `development build ${tag} (newer than every release)`;
-	return tag;
-}
-var ConfigError = class extends MetabaseError {
-	category = "config";
-	isRetryable = false;
-	developerDetail = null;
-	constructor(message) {
-		super(message);
-		this.name = "ConfigError";
-	}
-};
-var InternalError = class extends MetabaseError {
-	category = "internal";
-	isRetryable = false;
-	developerDetail = null;
-	constructor(message) {
-		super(message);
-		this.name = "InternalError";
-	}
-};
-var FailedResultError = class extends MetabaseError {
-	category = "failed";
-	isRetryable = false;
-	developerDetail = null;
-	constructor(message) {
-		super(message);
-		this.name = "FailedResultError";
-	}
-};
-var AbortError = class extends MetabaseError {
-	category = "abort";
-	isRetryable = false;
-	developerDetail = null;
-	constructor(message = "aborted") {
-		super(message);
-		this.name = "AbortError";
-	}
-};
-function isNonInterruptFailure(error) {
-	return error instanceof MetabaseError && !(error instanceof AbortError);
-}
-var ChainedRequestError = class extends MetabaseError {
-	cause;
-	constructor(message, cause) {
-		super(message);
-		this.name = "ChainedRequestError";
-		this.cause = cause;
-	}
-	get category() {
-		return this.cause.category;
-	}
-	get isRetryable() {
-		return this.cause.isRetryable;
-	}
-	get developerDetail() {
-		return this.cause.developerDetail;
-	}
-};
-var UnknownError = class extends MetabaseError {
-	category = "unknown";
-	isRetryable = false;
-	developerDetail;
-	constructor(input) {
-		super(input.originalMessage);
-		this.name = "UnknownError";
-		this.developerDetail = input;
-	}
-};
-var PartialWriteError = class extends MetabaseError {
-	category = "partial-write";
-	isRetryable = false;
-	developerDetail;
-	constructor(message, developerDetail) {
-		super(message);
-		this.name = "PartialWriteError";
-		this.developerDetail = developerDetail;
-	}
-};
-function toMetabaseError(error) {
-	if (error instanceof MetabaseError) return error;
-	if (error instanceof ZodError) return new ConfigError(error.issues.map(formatZodIssue).join("; "));
-	if (error instanceof Error) return new UnknownError({
-		originalMessage: error.message,
-		stack: error.stack ?? null
-	});
-	return new UnknownError({
-		originalMessage: String(error),
-		stack: null
-	});
-}
-function formatZodIssue(issue) {
-	const path = core.toDotPath(issue.path);
-	return path === "" ? issue.message : `${path}: ${issue.message}`;
-}
-function isFileNotFoundError(value) {
-	return value instanceof Error && "code" in value && value.code === "ENOENT";
-}
-function errorMessage(value) {
-	return value instanceof Error ? value.message : String(value);
-}
-//#endregion
 //#region src/runtime/citty.ts
 async function resolveCitty(value) {
 	if (value === void 0) return;
@@ -664,11 +468,12 @@ const profileFlag = { profile: {
 	description: "Named profile (default: 'default')",
 	alias: "p"
 } };
+const urlFlag = { url: {
+	type: "string",
+	description: "Metabase URL"
+} };
 const connectionFlags = {
-	url: {
-		type: "string",
-		description: "Metabase URL"
-	},
+	...urlFlag,
 	apiKey: {
 		type: "string",
 		description: "API key",
@@ -722,7 +527,7 @@ function trustSystemCa() {
 //#endregion
 //#region package.json
 var name = "@metabase/cli";
-var version = "0.5.3";
+var version = "0.5.5";
 var description = "Metabase CLI";
 //#endregion
 //#region src/runtime/command-augment.ts
@@ -742,42 +547,43 @@ const main = defineCommand({
 		description
 	},
 	subCommands: {
-		auth: () => import("./auth-hgkvHPpH.mjs").then((mod) => mod.default),
-		db: () => import("./db-wsSYKqCB.mjs").then((mod) => mod.default),
-		table: () => import("./table-BPYHnzyV.mjs").then((mod) => mod.default),
-		field: () => import("./field-CQDz-6DK.mjs").then((mod) => mod.default),
-		upload: () => import("./upload-CqSGEZQW.mjs").then((mod) => mod.default),
-		"content-translation": () => import("./content-translation-B3oARbgD.mjs").then((mod) => mod.default),
-		card: () => import("./card-BWTjCE93.mjs").then((mod) => mod.default),
-		dashboard: () => import("./dashboard-BZV-0Qjp.mjs").then((mod) => mod.default),
-		subscription: () => import("./subscription-DWleULhN.mjs").then((mod) => mod.default),
-		"data-action": () => import("./data-action-B7kRpvCH.mjs").then((mod) => mod.default),
-		"data-app": () => import("./data-app-BIAvvV2P.mjs").then((mod) => mod.default),
-		"api-key": () => import("./api-key-wGtJ8kYy.mjs").then((mod) => mod.default),
-		alert: () => import("./alert-BkpPdBQ_.mjs").then((mod) => mod.default),
-		collection: () => import("./collection-9_mj8rVX.mjs").then((mod) => mod.default),
-		library: () => import("./library-C3eO2J07.mjs").then((mod) => mod.default),
-		document: () => import("./document-BeLf7NqP.mjs").then((mod) => mod.default),
-		glossary: () => import("./glossary-BVK5DaLV.mjs").then((mod) => mod.default),
-		transform: () => import("./transform-N_elgRuh.mjs").then((mod) => mod.default),
-		"transform-job": () => import("./transform-job-CTV6KRP2.mjs").then((mod) => mod.default),
-		"transform-tag": () => import("./transform-tag-BYoguZfW.mjs").then((mod) => mod.default),
-		"transform-test": () => import("./transform-test-jaBpHOM5.mjs").then((mod) => mod.default),
-		setting: () => import("./setting-Bmry-y_l.mjs").then((mod) => mod.default),
-		search: () => import("./search-Dxcejw_v.mjs").then((mod) => mod.default),
-		"git-sync": () => import("./git-sync-D_T9oNC6.mjs").then((mod) => mod.default),
-		setup: () => import("./setup-UM8N9Vh3.mjs").then((mod) => mod.default),
-		snippet: () => import("./snippet-DKARah-L.mjs").then((mod) => mod.default),
-		segment: () => import("./segment-CebcXn2E.mjs").then((mod) => mod.default),
-		measure: () => import("./measure-C31HLp1C.mjs").then((mod) => mod.default),
-		dependency: () => import("./dependency-DDRGBlFL.mjs").then((mod) => mod.default),
-		timeline: () => import("./timeline-C2m_QHxn.mjs").then((mod) => mod.default),
-		"timeline-event": () => import("./timeline-event-BF1dqSnD.mjs").then((mod) => mod.default),
-		eid: () => import("./eid-eKmbXRds.mjs").then((mod) => mod.default),
-		query: () => import("./query-DkaUzmMa.mjs").then((mod) => mod.default),
-		uuid: () => import("./uuid-8Ha-8bDX.mjs").then((mod) => mod.default),
-		upgrade: () => import("./upgrade-iETJ8fH2.mjs").then((mod) => mod.default),
-		skills: () => import("./skills-BiSfuDqA.mjs").then((mod) => mod.default)
+		auth: () => import("./auth-bVvBp9Tl.mjs").then((mod) => mod.default),
+		db: () => import("./db-CpK3QluZ.mjs").then((mod) => mod.default),
+		table: () => import("./table-nIdBLcz7.mjs").then((mod) => mod.default),
+		field: () => import("./field-AkNMIQnx.mjs").then((mod) => mod.default),
+		upload: () => import("./upload-BqJLNCb1.mjs").then((mod) => mod.default),
+		"content-translation": () => import("./content-translation-7qPz-dIU.mjs").then((mod) => mod.default),
+		card: () => import("./card-nOX_QJ9u.mjs").then((mod) => mod.default),
+		dashboard: () => import("./dashboard-DeSaOt2Z.mjs").then((mod) => mod.default),
+		subscription: () => import("./subscription-CqUIrnUJ.mjs").then((mod) => mod.default),
+		"data-action": () => import("./data-action-Dpt7pfzd.mjs").then((mod) => mod.default),
+		"data-app": () => import("./data-app--T695WPM.mjs").then((mod) => mod.default),
+		"api-key": () => import("./api-key-DJfhPe4x.mjs").then((mod) => mod.default),
+		alert: () => import("./alert-32mfYFy1.mjs").then((mod) => mod.default),
+		collection: () => import("./collection-Cs84x7WB.mjs").then((mod) => mod.default),
+		library: () => import("./library-BA1QssFE.mjs").then((mod) => mod.default),
+		document: () => import("./document-DB6YGtqX.mjs").then((mod) => mod.default),
+		glossary: () => import("./glossary-Br_mSh3i.mjs").then((mod) => mod.default),
+		transform: () => import("./transform-l1oC8oUS.mjs").then((mod) => mod.default),
+		"transform-job": () => import("./transform-job-sCgr8r-t.mjs").then((mod) => mod.default),
+		"transform-tag": () => import("./transform-tag-DZEvmwxY.mjs").then((mod) => mod.default),
+		"transform-test": () => import("./transform-test-hxkx6M8c.mjs").then((mod) => mod.default),
+		setting: () => import("./setting-BsIBFvRP.mjs").then((mod) => mod.default),
+		search: () => import("./search-BcJgmPU3.mjs").then((mod) => mod.default),
+		"git-sync": () => import("./git-sync-DaHnqpYi.mjs").then((mod) => mod.default),
+		setup: () => import("./setup-BxUd_KYl.mjs").then((mod) => mod.default),
+		snippet: () => import("./snippet-CRLI3fYI.mjs").then((mod) => mod.default),
+		segment: () => import("./segment-zy4VVraQ.mjs").then((mod) => mod.default),
+		measure: () => import("./measure-DgtOyIoD.mjs").then((mod) => mod.default),
+		dependency: () => import("./dependency-_SgcW_fL.mjs").then((mod) => mod.default),
+		timeline: () => import("./timeline-Cw581KRT.mjs").then((mod) => mod.default),
+		"timeline-event": () => import("./timeline-event-BHfAXJrB.mjs").then((mod) => mod.default),
+		eid: () => import("./eid-pO_lMTI9.mjs").then((mod) => mod.default),
+		query: () => import("./query-O1b4qIr4.mjs").then((mod) => mod.default),
+		schema: () => import("./schema-Ds_j3N1I.mjs").then((mod) => mod.default),
+		uuid: () => import("./uuid-BIDBDPLI.mjs").then((mod) => mod.default),
+		upgrade: () => import("./upgrade-D3aDQZwd.mjs").then((mod) => mod.default),
+		skills: () => import("./skills-CQRgUHI3.mjs").then((mod) => mod.default)
 	}
 });
 setMetabaseAugment(main, {
@@ -790,7 +596,7 @@ setMetabaseAugment(main, {
 		skill: "data-workflow",
 		purpose: "guided end-to-end: raw data → clean tables → metrics → answers → dashboards"
 	}],
-	inputSchema: null,
+	input: null,
 	outputSchema: null,
 	requires: null
 });
@@ -837,23 +643,6 @@ function isJsonContentType(contentType) {
 	return contentType !== null && contentType.includes("application/json");
 }
 //#endregion
-//#region ../client/src/predicates.ts
-function isPlainObject(value) {
-	return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-const JAVA_WHITESPACE = "	\n\v\f\r            \u2028\u2029 　";
-const UNICODE_ESCAPE_DIGITS = 4;
-function unicodeEscape(char) {
-	return `\\u${char.charCodeAt(0).toString(16).padStart(UNICODE_ESCAPE_DIGITS, "0")}`;
-}
-const JAVA_WHITESPACE_ESCAPED = [...JAVA_WHITESPACE].map(unicodeEscape).join("");
-/** Matches a string Metabase reads as not blank: one holding a character that is not Java whitespace. */
-const NOT_BLANK = new RegExp(`[^${JAVA_WHITESPACE_ESCAPED}]`);
-/** Whether Metabase reads `value` as blank: empty, or Java whitespace only. */
-function isBlank(value) {
-	return !NOT_BLANK.test(value);
-}
-//#endregion
 //#region ../client/src/http/sanitize.ts
 const SECRET_HEADER_NAMES = /* @__PURE__ */ new Set([
 	"authorization",
@@ -1176,11 +965,15 @@ const FEATURE_RULES = {
 	transforms: { since: 59 },
 	transformJobActivation: { since: 61 },
 	measures: { since: 59 },
+	collectionItemMeasures: { since: 61 },
+	explorations: { since: 65 },
+	tableFromDefinition: { since: 64 },
 	library: {
 		since: 59,
 		tokenFeature: "library"
 	},
 	libraryDashboards: { since: 65 },
+	tablePublishTargetCollection: { since: 62 },
 	remoteSync: {
 		since: 58,
 		tokenFeature: "remote_sync"
@@ -1208,6 +1001,7 @@ const FEATURE_RULES = {
 		tokenFeature: "content_verification"
 	},
 	transformTargetTableId: { since: 61 },
+	transformSourceTablesAsList: { since: 60 },
 	transformTargetTableLinkedOnCreate: {
 		since: 61,
 		until: 61
@@ -1248,6 +1042,7 @@ const FEATURE_RULES = {
 		tokenFeature: "dependencies"
 	},
 	measureDependencyGraph: { since: 59 },
+	actionDependencyGraph: { since: 65 },
 	tableListAccessFilters: { since: 59 },
 	tableListTransformTargets: { since: 60 },
 	tableListPublishedFilter: { since: 63 },
@@ -1273,7 +1068,7 @@ const FEATURE_RULES = {
 		tokenFeature: "transforms-python"
 	},
 	pythonTestRun: {
-		since: 60,
+		since: 58,
 		tokenFeature: "transforms-python"
 	},
 	sourceReplacement: {
@@ -1290,6 +1085,23 @@ function isFeatureName(name) {
 }
 const FEATURE_NAMES = Object.keys(FEATURE_RULES).filter(isFeatureName);
 const Features = z.record(z.enum(FEATURE_NAMES), z.boolean());
+/**
+* Which servers hold `feature`, as a reader says it: the majors its rule spans and the token
+* feature it needs, each left out where every supported server meets it.
+*/
+function featureAvailability(feature) {
+	const rule = FEATURE_RULES[feature];
+	const token = rule.tokenFeature === void 0 ? null : `token ${rule.tokenFeature}`;
+	const parts = [majorSpan(rule), token].filter((part) => part !== null);
+	if (parts.length === 0) throw new Error(`${feature} holds on every supported server, so it gates nothing`);
+	return parts.join(", ");
+}
+function majorSpan(rule) {
+	const floor = rule.since > KNOWN_RANGE.min ? `v${rule.since}` : null;
+	if (rule.until === void 0) return floor === null ? null : `${floor}+`;
+	if (floor === null) return `up to v${rule.until}`;
+	return rule.since === rule.until ? `${floor} only` : `${floor}-v${rule.until}`;
+}
 function evaluateFeatures(major, tokenFeatures) {
 	const entries = FEATURE_NAMES.map((name) => [name, ruleHolds(FEATURE_RULES[name], major, tokenFeatures)]);
 	return Features.parse(Object.fromEntries(entries));
@@ -2069,8 +1881,6 @@ z.object({
 	skills: z.array(CommandHelpSkill),
 	examples: z.array(z.string()),
 	args: z.array(CommandHelpArg),
-	inputSchema: z.unknown().nullable(),
-	outputSchema: z.unknown().nullable(),
 	requires: CommandHelpRequires.nullable()
 });
 const CommandIndexEntry = z.object({
@@ -2086,7 +1896,7 @@ const EMPTY_AUGMENT = {
 	examples: [],
 	details: null,
 	skills: [],
-	inputSchema: null,
+	input: null,
 	outputSchema: null,
 	requires: null
 };
@@ -2100,8 +1910,6 @@ async function buildHelpEntry(cmd, path) {
 		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,
 		requires: augment.requires
 	};
 	if (augment.details !== null) entry.details = augment.details;
@@ -2116,6 +1924,37 @@ async function buildHelpIndex(cmd, path) {
 		commands: await walk(cmd, path)
 	};
 }
+async function resolveCommandPath(root, segments) {
+	let current = root;
+	for (const [index, segment] of segments.entries()) {
+		const subCommands = await resolveCitty(current.subCommands);
+		const match = subCommands === void 0 ? null : await findSubCommand(subCommands, segment);
+		if (match === null) throw new ConfigError(`unknown command: ${segments.slice(0, index + 1).join(" ")}`);
+		current = match.command;
+	}
+	return current;
+}
+async function findSubCommand(subCommands, token) {
+	const direct = Object.hasOwn(subCommands, token) ? subCommands[token] : void 0;
+	if (direct !== void 0) {
+		const command = await resolveCitty(direct);
+		if (command === void 0) return null;
+		return {
+			name: (await resolveCitty(command.meta))?.name ?? token,
+			command
+		};
+	}
+	for (const [key, loader] of Object.entries(subCommands)) {
+		const command = await resolveCitty(loader);
+		if (command === void 0) continue;
+		const meta = await resolveCitty(command.meta);
+		if (toAliasArray(meta?.alias).includes(token)) return {
+			name: meta?.name ?? key,
+			command
+		};
+	}
+	return null;
+}
 async function walk(cmd, path) {
 	const meta = await resolveCitty(cmd.meta);
 	if (meta?.hidden === true) return [];
@@ -2168,12 +2007,11 @@ const OPTIONS_HEADER = "OPTIONS";
 const LINE_PREFIX = "  ";
 const COLUMN_GAP = "  ";
 const COMMAND_PLACEHOLDER = "<command> [options]";
-const CLI_NAME = "mb";
 const HELP_FLAG_SPEC = "-h, --help";
 const HELP_FLAG_DESCRIPTION = "Show help for this command";
-const GETTING_STARTED_HINT = `First time? Run \`${CLI_NAME} auth login\` to connect to a Metabase instance.`;
+const GETTING_STARTED_HINT = `First time? Run \`mb auth login\` to connect to a Metabase instance.`;
 const SKILLS_HEADER = "AGENT SKILLS";
-const SKILLS_LIST_ITEM = `${CLI_NAME} skills list — every bundled skill`;
+const SKILLS_LIST_ITEM = `mb skills list — every bundled skill`;
 async function showUsage(cmd, parent, breadcrumb) {
 	const lines = (await renderUsage(cmd, parent)).replace(ANSI_PATTERN, "").split("\n").map((line) => line.replace(TRAILING_WHITESPACE, ""));
 	const cmdMeta = await resolveCitty(cmd.meta);
@@ -2194,7 +2032,14 @@ 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);
-	sections.push(machineHelpHint(breadcrumb ?? cittyName, hasSubCommands));
+	const schemas = {
+		body: augment !== null && augment.input !== null,
+		output: augment !== null && augment.outputSchema !== null
+	};
+	sections.push(machineHelpHint(breadcrumb ?? cittyName, {
+		hasSubCommands,
+		schemas
+	}));
 	await writeUsage(sections.join("\n\n") + "\n");
 }
 async function showUsageJson(cmd, breadcrumb) {
@@ -2209,12 +2054,22 @@ function writeUsage(text) {
 }
 function breadcrumbPath(breadcrumb) {
 	const segments = breadcrumb.split(" ").filter((segment) => segment.length > 0);
-	return segments[0] === CLI_NAME ? segments.slice(1) : segments;
+	return segments[0] === "mb" ? 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) {
-	return `${hasSubCommands ? MACHINE_HELP_INDEX_LABEL : MACHINE_HELP_LEAF_LABEL} ${breadcrumb} --help --json`;
+const MACHINE_HELP_LEAF_LABEL = "Machine-readable help (flags):";
+function machineHelpHint(breadcrumb, target) {
+	if (target.hasSubCommands) return `${MACHINE_HELP_INDEX_LABEL} ${breadcrumb} --help --json`;
+	const helpLine = `${MACHINE_HELP_LEAF_LABEL} ${breadcrumb} --help --json`;
+	const schemaLine = schemaHint(breadcrumbPath(breadcrumb).join(" "), target.schemas);
+	return schemaLine === null ? helpLine : `${helpLine}\n${schemaLine}`;
+}
+function schemaHint(command, schemas) {
+	const schema = `mb schema ${command}`;
+	if (schemas.body && schemas.output) return `Body and output schemas: ${schema} [--output]`;
+	if (schemas.body) return `Body schema: ${schema}`;
+	if (schemas.output) return `Output schema: ${schema} --output`;
+	return null;
 }
 function transformBody(lines, rewrite) {
 	return injectHelpOption(lines.map((line, index) => {
@@ -2330,7 +2185,7 @@ async function resolveLeafArgv(root, rawArgs) {
 }
 async function resolveBreadcrumb(root, rawArgs) {
 	const { segments } = await walkCommandPath(root, rawArgs);
-	return segments.length > 0 ? segments.join(" ") : CLI_NAME;
+	return segments.length > 0 ? segments.join(" ") : "mb";
 }
 async function findUnknownCommand(root, rawArgs) {
 	return (await walkCommandPath(root, rawArgs)).unknownToken;
@@ -2342,27 +2197,6 @@ function skipFlags(rawArgs, start, argsDef) {
 	}
 	return rawArgs.length;
 }
-async function findSubCommand(subCommands, token) {
-	const direct = subCommands[token];
-	if (direct !== void 0) {
-		const command = await resolveCitty(direct);
-		if (command === void 0) return null;
-		return {
-			name: (await resolveCitty(command.meta))?.name ?? token,
-			command
-		};
-	}
-	for (const [key, loader] of Object.entries(subCommands)) {
-		const command = await resolveCitty(loader);
-		if (command === void 0) continue;
-		const meta = await resolveCitty(command.meta);
-		if (toAliasArray(meta?.alias).includes(token)) return {
-			name: meta?.name ?? key,
-			command
-		};
-	}
-	return null;
-}
 //#endregion
 //#region src/runtime/interrupt.ts
 const INTERRUPT_REASON = new AbortError("interrupted");
@@ -2458,4 +2292,4 @@ run().catch((error) => {
 	reportError(error);
 });
 //#endregion
-export { parseJsonResult as $, ENV_URL as A, UnknownError as At, Features as B, preflightUncheckedNotice as C, FailedResultError as Ct, ENV_PROFILE as D, PartialWriteError as Dt, ENV_DISABLE_KEYRING as E, NetworkError as Et, RequirementFailure as F, isNonInterruptFailure as Ft, chainRequestFailure as G, isFeatureName as H, missingTokenFeatureMessage as I, KNOWN_RANGE as It, isBlank as J, isRetryableStatus as K, versionTooOldMessage as L, escapeJsonPointerSegment as Lt, readEnv as M, errorMessage as Mt, ProfileRefreshedError as N, formatZodIssue as Nt, ENV_SKILLS_DIR as O, ResponseShapeError as Ot, CapabilityError as P, isFileNotFoundError as Pt, parseJsonOrPlain as Q, FEATURE_NAMES as R, preflightSkippedNotice as S, ConfigError as St, ENV_API_KEY as T, MetabaseError as Tt, ruleGap as U, evaluateFeatures as V, HttpError as W, JSON_CONTENT_TYPE as X, isPlainObject as Y, parseJson as Z, promptConfirm as _, givenFlagKeys as _t, renderItem as a, listFlag as at, promptText as b, parseEnumCsv as bt, renderSummary as c, outputFlags as ct, writeJson as d, resolveOutputFormat as dt, setMetabaseAugment as et, writeText as f, parseInteger as ft, projectForList as g, assertArgv as gt, renderRows as h, listEnvelopeSchemaWithExtras as ht, reportError as i, formatFlags as it, consumeLegacyEnvWarnings as j, ValidationError as jt, ENV_SKIP_PREFLIGHT as k, TimeoutError as kt, renderSummaryWithinMaxBytes as l, profileFlag as lt, formatScalar as m, listEnvelopeSchema as mt, isMethodKey as n, version as nt, renderList as o, listFlags as ot, MALFORMED_CELL as p, parseOptionalInteger as pt, NOT_BLANK as q, methodRequirements as r, connectionFlags as rt, renderListWithExtras as s, listFlagsWithDefaultLimit as st, interruptSignal as t, name as tt, serializeJson as u, resolveCommonFlags as ut, promptPassword as v, parseCsv as vt, warn as w, InternalError as wt, listTruncationNotice as x, AbortError as xt, promptSelect as y, parseEnum as yt, FEATURE_RULES as z };
+export { main as $, ENV_SKIP_PREFLIGHT as A, FEATURE_RULES as B, preflightSkippedNotice as C, resolveCitty as Ct, ENV_DISABLE_KEYRING as D, ENV_API_KEY as E, CapabilityError as F, ruleGap as G, evaluateFeatures as H, RequirementFailure as I, isRetryableStatus as J, HttpError as K, missingTokenFeatureMessage as L, consumeLegacyEnvWarnings as M, readEnv as N, ENV_PROFILE as O, ProfileRefreshedError as P, parseJsonResult as Q, versionTooOldMessage as R, listTruncationNotice as S, parseEnumCsv as St, warn as T, featureAvailability as U, Features as V, isFeatureName as W, parseJson as X, JSON_CONTENT_TYPE as Y, parseJsonOrPlain as Z, projectForList as _, listEnvelopeSchemaWithExtras as _t, reportError as a, formatFlags as at, promptSelect as b, parseCsv as bt, renderListWithExtras as c, listFlagsWithDefaultLimit as ct, serializeJson as d, urlFlag as dt, getMetabaseAugment as et, writeJson as f, resolveCommonFlags as ft, renderRows as g, listEnvelopeSchema as gt, formatScalar as h, parseOptionalInteger as ht, methodRequirements as i, connectionFlags as it, ENV_URL as j, ENV_SKILLS_DIR as k, renderSummary as l, outputFlags as lt, MALFORMED_CELL as m, parseInteger as mt, resolveCommandPath as n, name as nt, renderItem as o, listFlag as ot, writeText as p, resolveOutputFormat as pt, chainRequestFailure as q, isMethodKey as r, version as rt, renderList as s, listFlags as st, interruptSignal as t, setMetabaseAugment as tt, renderSummaryWithinMaxBytes as u, profileFlag as ut, promptConfirm as v, assertArgv as vt, preflightUncheckedNotice as w, promptText as x, parseEnum as xt, promptPassword as y, givenFlagKeys as yt, FEATURE_NAMES as z };