@metabase/cli 0.1.3 → 0.1.4-alpha.skill-packaging.1c8ec40

package/dist/{remove-BJiq8Bna.mjs → remove-C08c3vne.mjs}

@@ -1,13 +1,13 @@
-import "./package-BeJ9DFrO.mjs";
+import "./package-VV3qWWIQ.mjs";
 import "./command-augment-D9pI9Vbh.mjs";
 import { renderItem } from "./render-DuoDUTVL.mjs";
 import "./predicates-CGO17Q15.mjs";
-import { defineMetabaseCommand, outputFlags } from "./runtime-CqLG3Q3o.mjs";
-import { parseId } from "./parse-id-DcoC0Z3o.mjs";
+import { defineMetabaseCommand, outputFlags } from "./runtime-DPdP0sl1.mjs";
+import { parseId } from "./parse-id-DbSjfzoU.mjs";
 import { promptConfirm } from "./prompt-DgDNy_Pc.mjs";
-import "./poll-CPn_4eae.mjs";
-import "./process-FjsqDwKo.mjs";
-import { checkDockerReady, containerNameFor, removeContainer, removeVolume, volumeNameFor } from "./docker-BYQ0FHrT.mjs";
+import "./poll-Cd8bRMmZ.mjs";
+import "./process-zJeVJZTM.mjs";
+import { checkDockerReady, containerNameFor, removeContainer, removeVolume, volumeNameFor } from "./docker-C9WQCjkt.mjs";
 import { z } from "zod";
 
 //#region src/commands/workspace/remove.ts
@@ -71,7 +71,7 @@ var remove_default = defineMetabaseCommand({
 		}
 	},
 	outputSchema: RemoveResult,
-	examples: ["metabase workspace remove 1 --yes", "metabase workspace remove 1 --keep-volume --yes"],
+	examples: ["mb workspace remove 1 --yes", "mb workspace remove 1 --keep-volume --yes"],
 	async run({ args, ctx }) {
 		const workspaceId = parseId(args.id);
 		const containerName = containerNameFor(workspaceId);

package/dist/{remove-collection-CfdSGSSW.mjs → remove-collection-cFO9M-qV.mjs}

@@ -1,12 +1,12 @@
-import "./package-BeJ9DFrO.mjs";
+import "./package-VV3qWWIQ.mjs";
 import "./command-augment-D9pI9Vbh.mjs";
 import { renderItem } from "./render-DuoDUTVL.mjs";
 import "./predicates-CGO17Q15.mjs";
-import { connectionFlags, defineMetabaseCommand, outputFlags, profileFlag } from "./runtime-CqLG3Q3o.mjs";
-import { parseId } from "./parse-id-DcoC0Z3o.mjs";
-import "./poll-task-YHJL7Q94.mjs";
-import "./poll-CPn_4eae.mjs";
-import { SyncSettingsUpdateResult, setCollectionRemoteSynced, syncSettingsUpdateView } from "./add-collection-CYzLXtm5.mjs";
+import { connectionFlags, defineMetabaseCommand, outputFlags, profileFlag } from "./runtime-DPdP0sl1.mjs";
+import { parseId } from "./parse-id-DbSjfzoU.mjs";
+import "./poll-task-BwKuhZ9P.mjs";
+import "./poll-Cd8bRMmZ.mjs";
+import { SyncSettingsUpdateResult, setCollectionRemoteSynced, syncSettingsUpdateView } from "./add-collection-CEvZTea_.mjs";
 
 //#region src/commands/git-sync/remove-collection.ts
 var remove_collection_default = defineMetabaseCommand({
@@ -25,7 +25,7 @@ var remove_collection_default = defineMetabaseCommand({
 		}
 	},
 	outputSchema: SyncSettingsUpdateResult,
-	examples: ["metabase git-sync remove-collection 12", "metabase git-sync remove-collection 12 --json --profile prod"],
+	examples: ["mb git-sync remove-collection 12", "mb git-sync remove-collection 12 --json --profile prod"],
 	async run({ args, ctx, getClient }) {
 		const collectionId = parseId(args.id, "id");
 		const client = await getClient();

package/dist/{rescan-values-DmZSi8y2.mjs → rescan-values-D1-IyyU7.mjs}

@@ -1,9 +1,9 @@
-import "./package-BeJ9DFrO.mjs";
+import "./package-VV3qWWIQ.mjs";
 import "./command-augment-D9pI9Vbh.mjs";
 import { renderItem } from "./render-DuoDUTVL.mjs";
 import "./predicates-CGO17Q15.mjs";
-import { connectionFlags, defineMetabaseCommand, outputFlags, profileFlag } from "./runtime-CqLG3Q3o.mjs";
-import { parseId } from "./parse-id-DcoC0Z3o.mjs";
+import { connectionFlags, defineMetabaseCommand, outputFlags, profileFlag } from "./runtime-DPdP0sl1.mjs";
+import { parseId } from "./parse-id-DbSjfzoU.mjs";
 import "./field-B3gvaqpK.mjs";
 import "./table-B-PYcgGb.mjs";
 import { DatabaseSyncResult, databaseSyncResultView } from "./database-vvig8k4x.mjs";
@@ -27,7 +27,7 @@ var rescan_values_default = defineMetabaseCommand({
 		}
 	},
 	outputSchema: DatabaseSyncResult,
-	examples: ["metabase db rescan-values 1", "metabase db rescan-values 1 --json"],
+	examples: ["mb db rescan-values 1", "mb db rescan-values 1 --json"],
 	async run({ args, ctx, getClient }) {
 		const id = parseId(args.id);
 		const client = await getClient();

package/dist/{revision-message-flag-CWQbKhdl.mjs → revision-message-flag-oyq2xrDU.mjs}

@@ -1,5 +1,5 @@
 //#region src/commands/revision-message-flag.ts
-const DEFAULT_ARCHIVE_REVISION_MESSAGE = "Archived via metabase CLI";
+const DEFAULT_ARCHIVE_REVISION_MESSAGE = "Archived via mb CLI";
 const revisionMessageFlag = { revisionMessage: {
 	type: "string",
 	description: "Audit-log message recorded with the change",

package/dist/{run-By3Hx4Sv.mjs → run-BCzKf_TV.mjs}

@@ -1,12 +1,12 @@
-import "./package-BeJ9DFrO.mjs";
+import "./package-VV3qWWIQ.mjs";
 import "./command-augment-D9pI9Vbh.mjs";
 import { renderItem } from "./render-DuoDUTVL.mjs";
 import "./predicates-CGO17Q15.mjs";
-import { connectionFlags, defineMetabaseCommand, outputFlags, profileFlag } from "./runtime-CqLG3Q3o.mjs";
-import { parseId } from "./parse-id-DcoC0Z3o.mjs";
-import { pollUntil } from "./poll-CPn_4eae.mjs";
-import { TransformRun } from "./transform-IEX4Mx3X.mjs";
-import { parseWaitFlags, waitFlags } from "./wait-flags-6QBmhHw9.mjs";
+import { connectionFlags, defineMetabaseCommand, outputFlags, profileFlag } from "./runtime-DPdP0sl1.mjs";
+import { parseId } from "./parse-id-DbSjfzoU.mjs";
+import { pollUntil } from "./poll-Cd8bRMmZ.mjs";
+import { TransformRun } from "./transform-DR4ejuPM.mjs";
+import { parseWaitFlags, waitFlags } from "./wait-flags-pItBfuzi.mjs";
 import { z } from "zod";
 
 //#region src/commands/transform/run.ts
@@ -57,7 +57,7 @@ var run_default = defineMetabaseCommand({
 		}
 	},
 	outputSchema: TransformRunResult,
-	examples: ["metabase transform run 1", "metabase transform run 1 --wait --json"],
+	examples: ["mb transform run 1", "mb transform run 1 --wait --json"],
 	async run({ args, ctx, getClient }) {
 		const id = parseId(args.id);
 		const wait = parseWaitFlags(args);

package/dist/{runs-OxCc7uCv.mjs → runs-pVgTv7cK.mjs}

@@ -1,11 +1,11 @@
-import "./package-BeJ9DFrO.mjs";
+import "./package-VV3qWWIQ.mjs";
 import "./command-augment-D9pI9Vbh.mjs";
 import { renderList } from "./render-DuoDUTVL.mjs";
 import "./predicates-CGO17Q15.mjs";
-import { connectionFlags, defineMetabaseCommand, listEnvelopeSchema, outputFlags, profileFlag } from "./runtime-CqLG3Q3o.mjs";
-import { parseId } from "./parse-id-DcoC0Z3o.mjs";
+import { connectionFlags, defineMetabaseCommand, listEnvelopeSchema, outputFlags, profileFlag } from "./runtime-DPdP0sl1.mjs";
+import { parseId } from "./parse-id-DbSjfzoU.mjs";
 import { collectPaginated } from "./paginate-CTSfuYiF.mjs";
-import { TransformRun, TransformRunCompact, transformRunView } from "./transform-IEX4Mx3X.mjs";
+import { TransformRun, TransformRunCompact, transformRunView } from "./transform-DR4ejuPM.mjs";
 
 //#region src/commands/transform/runs.ts
 const TransformRunListEnvelope = listEnvelopeSchema(TransformRunCompact);
@@ -29,9 +29,9 @@ var runs_default = defineMetabaseCommand({
 	},
 	outputSchema: TransformRunListEnvelope,
 	examples: [
-		"metabase transform runs",
-		"metabase transform runs --transform-id 1 --json",
-		"metabase transform runs --limit 10 --json"
+		"mb transform runs",
+		"mb transform runs --transform-id 1 --json",
+		"mb transform runs --limit 10 --json"
 	],
 	async run({ args, ctx, getClient }) {
 		const transformId = args["transform-id"] === void 0 ? void 0 : parseId(args["transform-id"], "--transform-id");

package/dist/{runtime-CqLG3Q3o.mjs → runtime-DPdP0sl1.mjs}

@@ -1,4 +1,4 @@
-import { package_default } from "./package-BeJ9DFrO.mjs";
+import { package_default } from "./package-VV3qWWIQ.mjs";
 import { setMetabaseAugment } from "./command-augment-D9pI9Vbh.mjs";
 import { AbortError, ConfigError, MetabaseError, NetworkError, TimeoutError, VERBOSE_ENV, ValidationError, errorMessage, isNotFoundError, isPlainObject, toMetabaseError } from "./predicates-CGO17Q15.mjs";
 import { defineCommand } from "citty";
@@ -468,8 +468,8 @@ async function resolveConfig(flags) {
 	const keyField = pickField(flagKey, env.apiKey, stored?.apiKey);
 	if (urlField === null || keyField === null) {
 		const rejection = await readRejection(profile);
-		if (rejection !== null) throw new ConfigError(`Last login for profile "${profile}" was rejected by ${originOnly(rejection.url)}: ${rejection.reason}. Re-run \`metabase auth login --profile ${profile}\` with valid credentials.`);
-		throw new ConfigError(`Not authenticated for profile "${profile}". Run \`metabase auth login\`, set ${ENV_URL}/${ENV_API_KEY}, or pass --url/--api-key.`);
+		if (rejection !== null) throw new ConfigError(`Last login for profile "${profile}" was rejected by ${originOnly(rejection.url)}: ${rejection.reason}. Re-run \`mb auth login --profile ${profile}\` with valid credentials.`);
+		throw new ConfigError(`Not authenticated for profile "${profile}". Run \`mb auth login\`, set ${ENV_URL}/${ENV_API_KEY}, or pass --url/--api-key.`);
 	}
 	return {
 		url: normalizeUrl(urlField.value),
@@ -483,7 +483,7 @@ async function resolveLicenseToken(flags) {
 	const env = readEnvLicenseToken();
 	const stored = !flag && !env ? await readLicense() : null;
 	const value = flag ?? env ?? stored;
-	if (!value) throw new ConfigError(`No license token. Pass --token, set ${ENV_LICENSE_TOKEN}, or store one with \`metabase license set\`.`);
+	if (!value) throw new ConfigError(`No license token. Pass --token, set ${ENV_LICENSE_TOKEN}, or store one with \`mb license set\`.`);
 	return value;
 }
 function pickField(flag, env, stored) {

package/dist/{schema-tables-gCfMALFX.mjs → schema-tables-c6K9AkS-.mjs}

@@ -1,9 +1,9 @@
-import "./package-BeJ9DFrO.mjs";
+import "./package-VV3qWWIQ.mjs";
 import "./command-augment-D9pI9Vbh.mjs";
 import { renderList } from "./render-DuoDUTVL.mjs";
 import "./predicates-CGO17Q15.mjs";
-import { connectionFlags, defineMetabaseCommand, listEnvelopeSchema, outputFlags, profileFlag, wrapList } from "./runtime-CqLG3Q3o.mjs";
-import { parseId } from "./parse-id-DcoC0Z3o.mjs";
+import { connectionFlags, defineMetabaseCommand, listEnvelopeSchema, outputFlags, profileFlag, wrapList } from "./runtime-DPdP0sl1.mjs";
+import { parseId } from "./parse-id-DbSjfzoU.mjs";
 import "./field-B3gvaqpK.mjs";
 import { Table, TableCompact, tableView } from "./table-B-PYcgGb.mjs";
 import { z } from "zod";
@@ -32,7 +32,7 @@ var schema_tables_default = defineMetabaseCommand({
 		}
 	},
 	outputSchema: DatabaseSchemaTablesEnvelope,
-	examples: ["metabase db schema-tables 1 public", "metabase db schema-tables 1 public --json"],
+	examples: ["mb db schema-tables 1 public", "mb db schema-tables 1 public --json"],
 	async run({ args, ctx, getClient }) {
 		const id = parseId(args.id);
 		const client = await getClient();

package/dist/{schemas-CelnP-JJ.mjs → schemas-s3PRMTwc.mjs}

@@ -1,9 +1,9 @@
-import "./package-BeJ9DFrO.mjs";
+import "./package-VV3qWWIQ.mjs";
 import "./command-augment-D9pI9Vbh.mjs";
 import { renderList } from "./render-DuoDUTVL.mjs";
 import "./predicates-CGO17Q15.mjs";
-import { connectionFlags, defineMetabaseCommand, listEnvelopeSchema, outputFlags, profileFlag, wrapList } from "./runtime-CqLG3Q3o.mjs";
-import { parseId } from "./parse-id-DcoC0Z3o.mjs";
+import { connectionFlags, defineMetabaseCommand, listEnvelopeSchema, outputFlags, profileFlag, wrapList } from "./runtime-DPdP0sl1.mjs";
+import { parseId } from "./parse-id-DbSjfzoU.mjs";
 import { z } from "zod";
 
 //#region src/commands/db/schemas.ts
@@ -33,7 +33,7 @@ var schemas_default = defineMetabaseCommand({
 		}
 	},
 	outputSchema: DatabaseSchemaListEnvelope,
-	examples: ["metabase db schemas 1", "metabase db schemas 1 --json"],
+	examples: ["mb db schemas 1", "mb db schemas 1 --json"],
 	async run({ args, ctx, getClient }) {
 		const id = parseId(args.id);
 		const client = await getClient();

package/dist/{search-Ccc2XHFA.mjs → search-DsF08cm9.mjs}

@@ -1,9 +1,9 @@
-import "./package-BeJ9DFrO.mjs";
+import "./package-VV3qWWIQ.mjs";
 import "./command-augment-D9pI9Vbh.mjs";
 import { renderList } from "./render-DuoDUTVL.mjs";
 import "./predicates-CGO17Q15.mjs";
-import { connectionFlags, defineMetabaseCommand, listEnvelopeSchema, outputFlags, parseEnumCsv, profileFlag } from "./runtime-CqLG3Q3o.mjs";
-import { parseId } from "./parse-id-DcoC0Z3o.mjs";
+import { connectionFlags, defineMetabaseCommand, listEnvelopeSchema, outputFlags, parseEnumCsv, profileFlag } from "./runtime-DPdP0sl1.mjs";
+import { parseId } from "./parse-id-DbSjfzoU.mjs";
 import { z } from "zod";
 
 //#region src/domain/search.ts
@@ -120,9 +120,9 @@ var search_default = defineMetabaseCommand({
 	},
 	outputSchema: SearchListEnvelope,
 	examples: [
-		"metabase search orders",
-		"metabase search --models card,dashboard --limit 10 --json",
-		"metabase search products --archived"
+		"mb search orders",
+		"mb search --models card,dashboard --limit 10 --json",
+		"mb search products --archived"
 	],
 	async run({ args, ctx, getClient }) {
 		const limit = parseId(args.limit, "--limit");

package/dist/segment-CvPF5gLG.mjs

@@ -0,0 +1,19 @@
+import { defineCommand } from "citty";
+
+//#region src/commands/segment/index.ts
+var segment_default = defineCommand({
+	meta: {
+		name: "segment",
+		description: "Inspect Metabase segments"
+	},
+	subCommands: {
+		list: () => import("./list-ByPzCM2G.mjs").then((mod) => mod.default),
+		get: () => import("./get-BAqeeIQ-.mjs").then((mod) => mod.default),
+		create: () => import("./create-hYdLOyw_.mjs").then((mod) => mod.default),
+		update: () => import("./update-CDdML0mE.mjs").then((mod) => mod.default),
+		archive: () => import("./archive-BPLLOdfL.mjs").then((mod) => mod.default)
+	}
+});
+
+//#endregion
+export { segment_default as default };

package/dist/{set-DQoW10tq.mjs → set-BNQjt8S1.mjs}

@@ -1,10 +1,10 @@
-import "./package-BeJ9DFrO.mjs";
+import "./package-VV3qWWIQ.mjs";
 import "./command-augment-D9pI9Vbh.mjs";
 import { renderItem } from "./render-DuoDUTVL.mjs";
 import "./predicates-CGO17Q15.mjs";
 import "./input-BQ-BZA8h.mjs";
-import { connectionFlags, defineMetabaseCommand, outputFlags, profileFlag } from "./runtime-CqLG3Q3o.mjs";
-import { readBody } from "./body-DyJdyUnm.mjs";
+import { connectionFlags, defineMetabaseCommand, outputFlags, profileFlag } from "./runtime-DPdP0sl1.mjs";
+import { readBody } from "./body-CVSMGqZk.mjs";
 import { SettingValue, settingValueView } from "./setting-CTaAeMci.mjs";
 import { parseSettingKey } from "./key-CCJdVWKc.mjs";
 import { z } from "zod";
@@ -36,11 +36,11 @@ var set_default = defineMetabaseCommand({
 	},
 	outputSchema: SettingValue,
 	examples: [
-		`metabase setting set remote-sync-branch '"main"'`,
-		`metabase setting set anon-tracking-enabled true`,
-		`echo '"main"' | metabase setting set remote-sync-branch`,
-		`metabase setting set remote-sync-branch --file value.json`,
-		`metabase setting set remote-sync-branch null`
+		`mb setting set remote-sync-branch '"main"'`,
+		`mb setting set anon-tracking-enabled true`,
+		`echo '"main"' | mb setting set remote-sync-branch`,
+		`mb setting set remote-sync-branch --file value.json`,
+		`mb setting set remote-sync-branch null`
 	],
 	async run({ args, ctx, getClient }) {
 		const key = parseSettingKey(args.key);

package/dist/{set-CwZkyHao.mjs → set-DlfevPxG.mjs}

@@ -1,9 +1,9 @@
-import "./package-BeJ9DFrO.mjs";
+import "./package-VV3qWWIQ.mjs";
 import "./command-augment-D9pI9Vbh.mjs";
 import { renderItem, warn } from "./render-DuoDUTVL.mjs";
 import { ConfigError } from "./predicates-CGO17Q15.mjs";
 import { readInput } from "./input-BQ-BZA8h.mjs";
-import { defineMetabaseCommand, outputFlags, readEnvLicenseToken, writeLicense } from "./runtime-CqLG3Q3o.mjs";
+import { defineMetabaseCommand, outputFlags, readEnvLicenseToken, writeLicense } from "./runtime-DPdP0sl1.mjs";
 import { promptPassword } from "./prompt-DgDNy_Pc.mjs";
 import { z } from "zod";
 
@@ -31,9 +31,9 @@ var set_default = defineMetabaseCommand({
 	},
 	outputSchema: LicenseSetResult,
 	examples: [
-		"echo $METABASE_LICENSE_TOKEN | metabase license set",
-		"metabase license set < token.txt",
-		"metabase license set $METABASE_LICENSE_TOKEN"
+		"echo $METABASE_LICENSE_TOKEN | mb license set",
+		"mb license set < token.txt",
+		"mb license set $METABASE_LICENSE_TOKEN"
 	],
 	async run({ args, ctx }) {
 		const token = await resolveToken(args.token);

package/dist/{setting-DrI9j2k_.mjs → setting-Cc5FWSNN.mjs}

@@ -8,9 +8,9 @@ var setting_default = defineCommand({
 		alias: "settings"
 	},
 	subCommands: {
-		list: () => import("./list-YwqpLfkl.mjs").then((m) => m.default),
-		get: () => import("./get-BrLtlgsJ.mjs").then((m) => m.default),
-		set: () => import("./set-DQoW10tq.mjs").then((m) => m.default)
+		list: () => import("./list-B9mEqMZ5.mjs").then((m) => m.default),
+		get: () => import("./get-Cy9YIesM.mjs").then((m) => m.default),
+		set: () => import("./set-BNQjt8S1.mjs").then((m) => m.default)
 	}
 });
 

package/dist/{setup-flXHfxYc.mjs → setup-CIsvZgEA.mjs}

@@ -1,10 +1,10 @@
-import "./package-BeJ9DFrO.mjs";
+import "./package-VV3qWWIQ.mjs";
 import "./command-augment-D9pI9Vbh.mjs";
 import { renderItem } from "./render-DuoDUTVL.mjs";
 import "./predicates-CGO17Q15.mjs";
 import "./input-BQ-BZA8h.mjs";
-import { connectionFlags, defineMetabaseCommand, outputFlags, profileFlag } from "./runtime-CqLG3Q3o.mjs";
-import { readBody } from "./body-DyJdyUnm.mjs";
+import { connectionFlags, defineMetabaseCommand, outputFlags, profileFlag } from "./runtime-DPdP0sl1.mjs";
+import { readBody } from "./body-CVSMGqZk.mjs";
 import { bodyInputFlags } from "./body-flags-BK7J6Daz.mjs";
 import { z } from "zod";
 
@@ -49,9 +49,9 @@ var setup_default = defineMetabaseCommand({
 	},
 	outputSchema: SetupResult,
 	examples: [
-		"cat setup.json | metabase setup",
-		"metabase setup --file setup.json",
-		"metabase setup --body '{\"token\":\"...\",\"user\":{\"email\":\"a@b.c\",\"password\":\"...\"}}'"
+		"cat setup.json | mb setup",
+		"mb setup --file setup.json",
+		"mb setup --body '{\"token\":\"...\",\"user\":{\"email\":\"a@b.c\",\"password\":\"...\"}}'"
 	],
 	async run({ args, ctx, getClient }) {
 		const body = await readBody({

package/dist/skills-CHU7uuDU.mjs

@@ -0,0 +1,191 @@
+import { ConfigError, isNotFoundError } from "./predicates-CGO17Q15.mjs";
+import { parseYamlResult } from "./yaml-ECiog374.mjs";
+import { z } from "zod";
+import { closeSync, openSync, readFileSync, readSync, readdirSync, statSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+//#region src/core/skills.ts
+const Frontmatter = z.object({
+	name: z.string().min(1),
+	description: z.string().default(""),
+	hidden: z.boolean().default(false)
+}).loose();
+const SkillExtraFile = z.object({
+	path: z.string(),
+	content: z.string()
+});
+const SkillContent = z.object({
+	name: z.string(),
+	description: z.string(),
+	body: z.string(),
+	references: z.array(SkillExtraFile),
+	templates: z.array(SkillExtraFile)
+});
+const SKILL_DIR_NAMES = ["skills", "skill-data"];
+const SKILL_MD_FILENAME = "SKILL.md";
+const SKILL_REFERENCES_DIR = "references";
+const SKILL_TEMPLATES_DIR = "templates";
+const SKILLS_DIR_ENV = "MB_SKILLS_DIR";
+const FRONTMATTER_PREFIX_BYTES = 8192;
+const FRONTMATTER_FENCE = "---";
+function loadAllSkills() {
+	return discoverSkills(resolveSkillDirs());
+}
+function loadVisibleSkills() {
+	return loadAllSkills().filter((s) => !s.hidden);
+}
+function findSkillByName(all, name) {
+	const hit = all.find((s) => s.name === name);
+	if (hit === void 0) throw new ConfigError(`unknown skill name: ${name} (${availableSkillNames(all)})`);
+	return hit;
+}
+function selectSkillsByNames(all, requested) {
+	if (requested.length === 0) throw new ConfigError("no skill names provided");
+	const byName = new Map(all.map((s) => [s.name, s]));
+	const missing = [];
+	const found = [];
+	for (const name of requested) {
+		const hit = byName.get(name);
+		if (hit === void 0) {
+			missing.push(name);
+			continue;
+		}
+		found.push(hit);
+	}
+	if (missing.length > 0) throw new ConfigError(`unknown skill name(s): ${missing.join(", ")} (${availableSkillNames(all)})`);
+	return found;
+}
+function availableSkillNames(all) {
+	const names = all.filter((s) => !s.hidden).map((s) => s.name);
+	return `available: ${names.length === 0 ? "none" : names.join(", ")}`;
+}
+function resolveSkillDirs() {
+	const override = process.env[SKILLS_DIR_ENV];
+	if (override !== void 0 && override !== "") {
+		if (!isDirectory(override)) throw new ConfigError(`${SKILLS_DIR_ENV} points at ${override}, which is not a directory`);
+		return [resolve(override)];
+	}
+	const root = findPackageRoot();
+	if (root === null) return [];
+	return SKILL_DIR_NAMES.map((name) => join(root, name)).filter(isDirectory);
+}
+function findPackageRoot() {
+	const here = fileURLToPath(import.meta.url);
+	let dir = dirname(here);
+	while (true) {
+		for (const name of SKILL_DIR_NAMES) if (isDirectory(join(dir, name))) return dir;
+		const parent = dirname(dir);
+		if (parent === dir) return null;
+		dir = parent;
+	}
+}
+function discoverSkills(dirs) {
+	const skills = [];
+	for (const dir of dirs) {
+		let entries;
+		try {
+			entries = readdirSync(dir);
+		} catch (error) {
+			if (isNotFoundError(error)) continue;
+			throw error;
+		}
+		for (const entryName of entries) {
+			const skillDir = join(dir, entryName);
+			const fm = readFrontmatterFromSkill(skillDir);
+			if (fm === null) continue;
+			skills.push({
+				name: fm.name,
+				description: fm.description,
+				hidden: fm.hidden,
+				dir: skillDir
+			});
+		}
+	}
+	skills.sort((a, b) => a.name.localeCompare(b.name));
+	return skills;
+}
+function readFrontmatterFromSkill(skillDir) {
+	const skillMd = join(skillDir, SKILL_MD_FILENAME);
+	const prefix = readFilePrefix(skillMd, FRONTMATTER_PREFIX_BYTES);
+	if (prefix === null) return null;
+	return parseFrontmatter(prefix);
+}
+function readFilePrefix(path, maxBytes) {
+	let fd;
+	try {
+		fd = openSync(path, "r");
+	} catch (error) {
+		if (isNotFoundError(error)) return null;
+		throw error;
+	}
+	try {
+		const buffer = Buffer.alloc(maxBytes);
+		const bytesRead = readSync(fd, buffer, 0, maxBytes, 0);
+		return buffer.toString("utf8", 0, bytesRead);
+	} finally {
+		closeSync(fd);
+	}
+}
+function parseFrontmatter(content) {
+	const trimmed = content.trimStart();
+	if (!trimmed.startsWith(FRONTMATTER_FENCE)) return null;
+	const afterOpening = trimmed.slice(FRONTMATTER_FENCE.length);
+	const closingIndex = afterOpening.indexOf(`\n${FRONTMATTER_FENCE}`);
+	if (closingIndex < 0) return null;
+	const block = afterOpening.slice(0, closingIndex);
+	const result = parseYamlResult(block, Frontmatter);
+	if (!result.ok) return null;
+	return result.value;
+}
+function readSkillContent(info, opts) {
+	const body = readFileSync(join(info.dir, SKILL_MD_FILENAME), "utf8");
+	if (!opts.includeExtras) return {
+		name: info.name,
+		description: info.description,
+		body,
+		references: [],
+		templates: []
+	};
+	return {
+		name: info.name,
+		description: info.description,
+		body,
+		references: collectExtraFiles(info.dir, SKILL_REFERENCES_DIR),
+		templates: collectExtraFiles(info.dir, SKILL_TEMPLATES_DIR)
+	};
+}
+function collectExtraFiles(skillDir, subdirName) {
+	const subdir = join(skillDir, subdirName);
+	if (!isDirectory(subdir)) return [];
+	const entries = readdirSync(subdir).toSorted();
+	const out = [];
+	for (const entry of entries) {
+		const full = join(subdir, entry);
+		if (!isFile(full)) continue;
+		out.push({
+			path: `${subdirName}/${entry}`,
+			content: readFileSync(full, "utf8")
+		});
+	}
+	return out;
+}
+function isDirectory(path) {
+	try {
+		return statSync(path).isDirectory();
+	} catch (error) {
+		if (isNotFoundError(error)) return false;
+		throw error;
+	}
+}
+function isFile(path) {
+	try {
+		return statSync(path).isFile();
+	} catch (error) {
+		if (isNotFoundError(error)) return false;
+		throw error;
+	}
+}
+
+//#endregion
+export { SkillContent, findSkillByName, loadAllSkills, loadVisibleSkills, readSkillContent, selectSkillsByNames };

package/dist/skills-Dws-azxD.mjs

@@ -0,0 +1,18 @@
+import { defineCommand } from "citty";
+
+//#region src/commands/skills/index.ts
+var skills_default = defineCommand({
+	meta: {
+		name: "skills",
+		description: "Discover and read CLI-bundled skills (SKILL.md files served from the installed version)"
+	},
+	default: "list",
+	subCommands: {
+		list: () => import("./list-DwF6on6O.mjs").then((m) => m.default),
+		get: () => import("./get-DWttywn_.mjs").then((m) => m.default),
+		path: () => import("./path-DarsuSkB.mjs").then((m) => m.default)
+	}
+});
+
+//#endregion
+export { skills_default as default };

package/dist/snippet-W-TaXdio.mjs

@@ -0,0 +1,19 @@
+import { defineCommand } from "citty";
+
+//#region src/commands/snippet/index.ts
+var snippet_default = defineCommand({
+	meta: {
+		name: "snippet",
+		description: "Inspect Metabase native query snippets"
+	},
+	subCommands: {
+		list: () => import("./list-B5E7LFDb.mjs").then((mod) => mod.default),
+		get: () => import("./get-ChEFd1sT.mjs").then((mod) => mod.default),
+		create: () => import("./create-C3TiMJhQ.mjs").then((mod) => mod.default),
+		update: () => import("./update-CGYM_wWQ.mjs").then((mod) => mod.default),
+		archive: () => import("./archive-D596Cq7R.mjs").then((mod) => mod.default)
+	}
+});
+
+//#endregion
+export { snippet_default as default };

package/dist/{start-B6jtccng.mjs → start-xREv6hev.mjs}

@@ -1,14 +1,15 @@
-import "./package-BeJ9DFrO.mjs";
+import "./package-VV3qWWIQ.mjs";
 import "./command-augment-D9pI9Vbh.mjs";
 import { renderItem, warn } from "./render-DuoDUTVL.mjs";
 import { ConfigError, errorMessage } from "./predicates-CGO17Q15.mjs";
-import { connectionFlags, createClient, defineMetabaseCommand, localUrl, outputFlags, parseInteger, parseOptionalInteger, profileFlag, resolveLicenseToken } from "./runtime-CqLG3Q3o.mjs";
-import { parseId } from "./parse-id-DcoC0Z3o.mjs";
-import { pollUntil } from "./poll-CPn_4eae.mjs";
-import { runProcess } from "./process-FjsqDwKo.mjs";
-import { Workspace } from "./workspace-C5q4nbpY.mjs";
-import { CONTAINER_REPO_DIR, checkDockerReady, containerLifecycleStatus, containerNameFor, pullImage, removeContainer, runWorkspaceContainer, scrubContainerConfig, waitForConfigConsumed } from "./docker-BYQ0FHrT.mjs";
-import { REPO_SYNC_MODES, RepoSyncMode, buildCredentialsJson, generateWorkspaceCredentials, injectCredentialsIntoConfig, injectRepoSettingsIntoConfig } from "./workspace-credentials-Cctumbru.mjs";
+import { connectionFlags, createClient, defineMetabaseCommand, localUrl, outputFlags, parseInteger, parseOptionalInteger, profileFlag, resolveLicenseToken } from "./runtime-DPdP0sl1.mjs";
+import { parseId } from "./parse-id-DbSjfzoU.mjs";
+import { pollUntil } from "./poll-Cd8bRMmZ.mjs";
+import "./yaml-ECiog374.mjs";
+import { runProcess } from "./process-zJeVJZTM.mjs";
+import { Workspace } from "./workspace-DUfqhPm5.mjs";
+import { CONTAINER_REPO_DIR, checkDockerReady, containerLifecycleStatus, containerNameFor, pullImage, removeContainer, runWorkspaceContainer, scrubContainerConfig, waitForConfigConsumed } from "./docker-C9WQCjkt.mjs";
+import { REPO_SYNC_MODES, RepoSyncMode, buildCredentialsJson, generateWorkspaceCredentials, injectCredentialsIntoConfig, injectRepoSettingsIntoConfig } from "./workspace-credentials-4lIxxz4g.mjs";
 import { z } from "zod";
 import { stat } from "node:fs/promises";
 import { resolve } from "node:path";
@@ -180,13 +181,13 @@ var start_default = defineMetabaseCommand({
 	},
 	outputSchema: StartResult,
 	examples: [
-		"metabase workspace start 1",
-		"metabase workspace start 1 --wait",
-		"metabase workspace start 1 --port 3100",
-		"metabase workspace start 1 --image metabase/metabase-dev:feature-workspaces-v2 --no-pull",
-		"metabase workspace start 1 --force",
-		"metabase workspace start 1 --repo /path/to/sync-repo --wait",
-		"metabase workspace start 1 --repo /path/to/sync-repo --repo-branch dev --repo-mode read-only"
+		"mb workspace start 1",
+		"mb workspace start 1 --wait",
+		"mb workspace start 1 --port 3100",
+		"mb workspace start 1 --image metabase/metabase-dev:feature-workspaces-v2 --no-pull",
+		"mb workspace start 1 --force",
+		"mb workspace start 1 --repo /path/to/sync-repo --wait",
+		"mb workspace start 1 --repo /path/to/sync-repo --repo-branch dev --repo-mode read-only"
 	],
 	async run({ args, ctx, getClient, getResolvedConfig }) {
 		const workspaceId = parseId(args.id);
@@ -275,7 +276,7 @@ async function ensureNoExistingContainer(workspaceId, containerName, force) {
 		await removeContainer(containerName);
 		return;
 	}
-	throw new ConfigError(`container ${containerName} is currently ${status}. Run \`metabase workspace stop ${workspaceId}\` first, or use --force to recreate it.`);
+	throw new ConfigError(`container ${containerName} is currently ${status}. Run \`mb workspace stop ${workspaceId}\` first, or use --force to recreate it.`);
 }
 async function resolveHostPort(requested) {
 	if (requested !== null) {