@metabase/cli 0.3.0-alpha.extract-api-client.e9b2dd5 → 0.3.1-alpha.support-worktrees.b634907

package/dist/cli.mjs

@@ -99,6 +99,10 @@ const profileFlag = { profile: {
 	description: "Named profile (default: 'default')",
 	alias: "p"
 } };
+const worktreeFlag = { worktree: {
+	type: "string",
+	description: "Scope to a git-sync worktree (id or branch); defaults to MB_WORKTREE or the profile's pinned worktree"
+} };
 const connectionFlags = {
 	url: {
 		type: "string",
@@ -123,7 +127,8 @@ const GLOBAL_FLAG_ARGS = {
 	...outputFlags,
 	...listFlags,
 	...profileFlag,
-	...connectionFlags
+	...connectionFlags,
+	...worktreeFlag
 };
 const GLOBAL_FLAG_NAMES = buildGlobalFlagNames();
 function buildGlobalFlagNames() {
@@ -175,7 +180,7 @@ function trustSystemCa() {
 //#endregion
 //#region package.json
 var name = "@metabase/cli";
-var version = "0.3.0-alpha.extract-api-client.e9b2dd5";
+var version = "0.3.1-alpha.support-worktrees.b634907";
 var description = "Metabase CLI";
 //#endregion
 //#region src/runtime/command-augment.ts
@@ -195,35 +200,37 @@ const main = defineCommand({
 		description
 	},
 	subCommands: {
-		auth: () => import("./auth-Dltxua89.mjs").then((mod) => mod.default),
-		db: () => import("./db-DsfojyeH.mjs").then((mod) => mod.default),
-		table: () => import("./table-DYoC1kPn.mjs").then((mod) => mod.default),
-		field: () => import("./field-Zau6Hc6X.mjs").then((mod) => mod.default),
-		upload: () => import("./upload-Dey_8rLf.mjs").then((mod) => mod.default),
-		card: () => import("./card-CHI2bmds.mjs").then((mod) => mod.default),
-		dashboard: () => import("./dashboard-BHJBoaG7.mjs").then((mod) => mod.default),
-		subscription: () => import("./subscription-_d5fB45F.mjs").then((mod) => mod.default),
-		alert: () => import("./alert-DT-ee7yf.mjs").then((mod) => mod.default),
-		collection: () => import("./collection-CY0AB99E.mjs").then((mod) => mod.default),
-		library: () => import("./library-Bsm5KsFF.mjs").then((mod) => mod.default),
-		document: () => import("./document-BbskZPTT.mjs").then((mod) => mod.default),
-		transform: () => import("./transform-Bs0EWijQ.mjs").then((mod) => mod.default),
-		"transform-job": () => import("./transform-job-BcLChRup.mjs").then((mod) => mod.default),
-		"transform-tag": () => import("./transform-tag-_tgwlsdB.mjs").then((mod) => mod.default),
-		setting: () => import("./setting-DyhaeICs.mjs").then((mod) => mod.default),
-		search: () => import("./search-DmGScXs8.mjs").then((mod) => mod.default),
-		"git-sync": () => import("./git-sync-MQQYRYLg.mjs").then((mod) => mod.default),
-		setup: () => import("./setup-BbDQN8fe.mjs").then((mod) => mod.default),
-		snippet: () => import("./snippet-DRwKb2x7.mjs").then((mod) => mod.default),
-		segment: () => import("./segment-BzUGM2Fr.mjs").then((mod) => mod.default),
-		measure: () => import("./measure-BsYv0p26.mjs").then((mod) => mod.default),
-		timeline: () => import("./timeline-xlDbEKWg.mjs").then((mod) => mod.default),
-		"timeline-event": () => import("./timeline-event-CNQdCTDg.mjs").then((mod) => mod.default),
-		eid: () => import("./eid-WTZmDdsr.mjs").then((mod) => mod.default),
-		query: () => import("./query-Dc__-KJH.mjs").then((mod) => mod.default),
-		uuid: () => import("./uuid-BJkDWj9p.mjs").then((mod) => mod.default),
-		upgrade: () => import("./upgrade-DXMV4AyP.mjs").then((mod) => mod.default),
-		skills: () => import("./skills--vK6J-e4.mjs").then((mod) => mod.default)
+		auth: () => import("./auth-BEEkuu4J.mjs").then((mod) => mod.default),
+		db: () => import("./db-1tLH3nYI.mjs").then((mod) => mod.default),
+		table: () => import("./table-BQaiCSNS.mjs").then((mod) => mod.default),
+		field: () => import("./field-BKn9bt7I.mjs").then((mod) => mod.default),
+		upload: () => import("./upload-Dc3QLhZw.mjs").then((mod) => mod.default),
+		"content-translation": () => import("./content-translation-C8MlXPOF.mjs").then((mod) => mod.default),
+		card: () => import("./card-RlzLDB2z.mjs").then((mod) => mod.default),
+		dashboard: () => import("./dashboard-B1mpfCq_.mjs").then((mod) => mod.default),
+		subscription: () => import("./subscription-BnGDp1oy.mjs").then((mod) => mod.default),
+		alert: () => import("./alert-CQ7Az16h.mjs").then((mod) => mod.default),
+		collection: () => import("./collection-Bhe20ckt.mjs").then((mod) => mod.default),
+		library: () => import("./library-CRaOhJnj.mjs").then((mod) => mod.default),
+		document: () => import("./document-DOJbBWLF.mjs").then((mod) => mod.default),
+		transform: () => import("./transform-DAf0Y02t.mjs").then((mod) => mod.default),
+		"transform-job": () => import("./transform-job-ntiT5Rrh.mjs").then((mod) => mod.default),
+		"transform-tag": () => import("./transform-tag-Dip51YBa.mjs").then((mod) => mod.default),
+		setting: () => import("./setting-CN4l8N-b.mjs").then((mod) => mod.default),
+		search: () => import("./search-CljYyf2F.mjs").then((mod) => mod.default),
+		"git-sync": () => import("./git-sync-DjoaNmRM.mjs").then((mod) => mod.default),
+		worktree: () => import("./worktree-DC0kTxxQ.mjs").then((mod) => mod.default),
+		setup: () => import("./setup-BpTptmdO.mjs").then((mod) => mod.default),
+		snippet: () => import("./snippet-LlHz3FdJ.mjs").then((mod) => mod.default),
+		segment: () => import("./segment-IRzlQggt.mjs").then((mod) => mod.default),
+		measure: () => import("./measure-C5dIdFj1.mjs").then((mod) => mod.default),
+		timeline: () => import("./timeline-C2VW0Ph6.mjs").then((mod) => mod.default),
+		"timeline-event": () => import("./timeline-event-B7H1y8s8.mjs").then((mod) => mod.default),
+		eid: () => import("./eid-CP35PdEF.mjs").then((mod) => mod.default),
+		query: () => import("./query-tWQAV9pb.mjs").then((mod) => mod.default),
+		uuid: () => import("./uuid-CFN8LIkP.mjs").then((mod) => mod.default),
+		upgrade: () => import("./upgrade-CUoRHfVg.mjs").then((mod) => mod.default),
+		skills: () => import("./skills-BSAiLI3Z.mjs").then((mod) => mod.default)
 	}
 });
 setMetabaseAugment(main, {
@@ -238,7 +245,8 @@ setMetabaseAugment(main, {
 	}],
 	inputSchema: null,
 	outputSchema: null,
-	capabilities: null
+	capabilities: null,
+	worktree: "any"
 });
 //#endregion
 //#region src/core/env.ts
@@ -250,6 +258,7 @@ const ENV_VERBOSE = "MB_VERBOSE";
 const ENV_SKIP_PREFLIGHT = "MB_CLI_SKIP_PREFLIGHT";
 const ENV_DISABLE_KEYRING = "MB_CLI_DISABLE_KEYRING";
 const ENV_SKILLS_DIR = "MB_SKILLS_DIR";
+const ENV_WORKTREE = "MB_WORKTREE";
 function legacyNameFor(canonical) {
 	return LEGACY_PREFIX + canonical.slice(3);
 }
@@ -684,6 +693,78 @@ function checkCapabilities(info, required) {
 	return null;
 }
 //#endregion
+//#region src/core/worktree-scope.ts
+const WorktreePolicy = z.enum([
+	"scoped",
+	"any",
+	"main-only"
+]);
+const WORKTREE_FLAG = "--worktree";
+const ORIGIN_LABEL = Object.freeze({
+	flag: WORKTREE_FLAG,
+	env: ENV_WORKTREE,
+	pin: "the profile pin"
+});
+const DIGITS = /^\d+$/;
+function parseWorktreeRef(raw, label) {
+	const value = raw.trim();
+	if (value === "") throw new ConfigError(`invalid ${label}: value must not be blank`);
+	if (!DIGITS.test(value)) return {
+		kind: "branch",
+		branch: value
+	};
+	const id = Number(value);
+	if (id < 1) throw new ConfigError(`invalid ${label}: ${value} (must be ≥ 1)`);
+	return {
+		kind: "id",
+		id
+	};
+}
+function formatWorktreeRef(ref) {
+	return ref.kind === "id" ? String(ref.id) : `"${ref.branch}"`;
+}
+function resolveScopeSource(input) {
+	const stated = statedRef(input);
+	if (stated === null) return input.pin === null ? null : {
+		ref: {
+			kind: "id",
+			id: input.pin.id
+		},
+		origin: "pin",
+		scope: input.pin
+	};
+	const pin = input.pin;
+	if (pin === null) return {
+		...stated,
+		scope: null
+	};
+	if (!refMatchesScope(stated.ref, pin)) throw new ConfigError(`profile "${input.profile}" is pinned to worktree ${pin.id} (${pin.branch}); refusing ${ORIGIN_LABEL[stated.origin]} ${formatWorktreeRef(stated.ref)}`);
+	return {
+		...stated,
+		scope: pin
+	};
+}
+function describeScopeSource(source) {
+	return `${source.scope === null ? `worktree ${formatWorktreeRef(source.ref)}` : `worktree ${source.scope.id} (${source.scope.branch})`} from ${ORIGIN_LABEL[source.origin]}`;
+}
+function mainOnlyRefusal(command, source) {
+	return `${command} is not available inside a worktree (scope: ${describeScopeSource(source)}); it changes main-app content. Unpin the profile (\`mb worktree unpin\`) or drop ${ENV_WORKTREE} to run it against the main app.`;
+}
+function statedRef(input) {
+	if (input.flag !== void 0 && input.flag !== "") return {
+		ref: parseWorktreeRef(input.flag, WORKTREE_FLAG),
+		origin: "flag"
+	};
+	if (input.env !== void 0 && input.env !== "") return {
+		ref: parseWorktreeRef(input.env, ENV_WORKTREE),
+		origin: "env"
+	};
+	return null;
+}
+function refMatchesScope(ref, scope) {
+	return ref.kind === "id" ? ref.id === scope.id : ref.branch === scope.branch;
+}
+//#endregion
 //#region src/runtime/command-help.ts
 const CommandHelpArg = z.object({
 	name: z.string(),
@@ -716,7 +797,8 @@ z.object({
 	args: z.array(CommandHelpArg),
 	inputSchema: z.unknown().nullable(),
 	outputSchema: z.unknown().nullable(),
-	capabilities: Capabilities.nullable()
+	capabilities: Capabilities.nullable(),
+	worktree: WorktreePolicy
 });
 const CommandIndexEntry = z.object({
 	command: z.string(),
@@ -733,7 +815,8 @@ const EMPTY_AUGMENT = {
 	skills: [],
 	inputSchema: null,
 	outputSchema: null,
-	capabilities: null
+	capabilities: null,
+	worktree: "any"
 };
 async function buildHelpEntry(cmd, path) {
 	const meta = await resolveCitty(cmd.meta);
@@ -747,7 +830,8 @@ async function buildHelpEntry(cmd, path) {
 		args: convertArgs(args),
 		inputSchema: augment.inputSchema ? z.toJSONSchema(augment.inputSchema) : null,
 		outputSchema: augment.outputSchema ? z.toJSONSchema(augment.outputSchema) : null,
-		capabilities: augment.capabilities
+		capabilities: augment.capabilities,
+		worktree: augment.worktree
 	};
 	if (augment.details !== null) entry.details = augment.details;
 	return entry;
@@ -961,12 +1045,14 @@ async function walkCommandPath(root, rawArgs) {
 		unknownToken: null
 	};
 }
-async function resolveBreadcrumb(root, rawArgs) {
-	const { segments } = await walkCommandPath(root, rawArgs);
-	return segments.length > 0 ? segments.join(" ") : CLI_NAME;
-}
-async function findUnknownCommand(root, rawArgs) {
-	return (await walkCommandPath(root, rawArgs)).unknownToken;
+async function resolveInvocation(root, rawArgs) {
+	const { segments, unknownToken } = await walkCommandPath(root, rawArgs);
+	const verbs = segments[0] === CLI_NAME ? segments.slice(1) : segments;
+	return {
+		breadcrumb: segments.length > 0 ? segments.join(" ") : CLI_NAME,
+		verbs: verbs.length > 0 ? verbs.join(" ") : null,
+		unknownToken
+	};
 }
 function skipFlags(rawArgs, start, argsDef) {
 	let index = start;
@@ -1022,6 +1108,15 @@ function installInterruptHandler(exit) {
 	});
 }
 //#endregion
+//#region src/runtime/verb-chain.ts
+let verbChain = null;
+function setVerbChain(chain) {
+	verbChain = chain;
+}
+function readVerbChain() {
+	return verbChain;
+}
+//#endregion
 //#region src/cli.ts
 const HELP_FLAGS = /* @__PURE__ */ new Set(["--help", "-h"]);
 const JSON_HELP_FLAG = "--json";
@@ -1031,7 +1126,7 @@ 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, rawArgs);
+		const { breadcrumb } = await resolveInvocation(main, rawArgs);
 		if (wantsJsonHelp) {
 			await showUsageJson(cmd, breadcrumb);
 			return;
@@ -1043,11 +1138,12 @@ async function run() {
 		return;
 	}
 	if (!rawArgs.some((arg) => HELP_FLAGS.has(arg))) {
-		const unknown = await findUnknownCommand(main, rawArgs);
-		if (unknown !== null) {
-			reportError(new ConfigError(`unknown command: ${unknown}`));
+		const { unknownToken, verbs } = await resolveInvocation(main, rawArgs);
+		if (unknownToken !== null) {
+			reportError(new ConfigError(`unknown command: ${unknownToken}`));
 			return;
 		}
+		setVerbChain(verbs);
 	}
 	await runMain(main, {
 		showUsage: showUsageWithBreadcrumb,
@@ -1058,4 +1154,4 @@ run().catch((error) => {
 	reportError(error);
 });
 //#endregion
-export { name as A, normalizeFlag as B, ENV_PROFILE as C, consumeLegacyEnvWarnings as D, ENV_URL as E, outputFlags as F, profileFlag as I, DEFAULT_MAX_BYTES as L, connectionFlags as M, listFlags as N, readEnv as O, listFlagsWithDefaultLimit as P, listEnvelopeSchema as R, ENV_DISABLE_KEYRING as S, ENV_SKIP_PREFLIGHT as T, toAliasArray as V, promptSelect as _, reportError as a, warn as b, renderSummary as c, MALFORMED_CELL as d, formatScalar as f, promptPassword as g, promptConfirm as h, mergeCapabilities as i, version as j, setMetabaseAugment as k, writeJson as l, projectForList as m, BASELINE_CAPABILITIES as n, renderItem as o, renderRows as p, checkCapabilities as r, renderList as s, interruptSignal as t, writeText as u, promptText as v, ENV_SKILLS_DIR as w, ENV_API_KEY as x, listTruncationNotice as y, flagConsumesValue as z };
+export { ENV_SKIP_PREFLIGHT as A, listFlagsWithDefaultLimit as B, promptText as C, ENV_DISABLE_KEYRING as D, ENV_API_KEY as E, setMetabaseAugment as F, listEnvelopeSchema as G, profileFlag as H, name as I, toAliasArray as J, flagConsumesValue as K, version as L, ENV_WORKTREE as M, consumeLegacyEnvWarnings as N, ENV_PROFILE as O, readEnv as P, connectionFlags as R, promptSelect as S, warn as T, worktreeFlag as U, outputFlags as V, DEFAULT_MAX_BYTES as W, formatScalar as _, parseWorktreeRef as a, promptConfirm as b, checkCapabilities as c, renderItem as d, renderList as f, MALFORMED_CELL as g, writeText as h, mainOnlyRefusal as i, ENV_URL as j, ENV_SKILLS_DIR as k, mergeCapabilities as l, writeJson as m, interruptSignal as n, resolveScopeSource as o, renderSummary as p, normalizeFlag as q, formatWorktreeRef as r, BASELINE_CAPABILITIES as s, readVerbChain as t, reportError as u, renderRows as v, listTruncationNotice as w, promptPassword as x, projectForList as y, listFlags as z };