@metabase/cli 0.3.1-alpha.support-worktrees.b634907 → 0.3.1-alpha.versioning.9ac5f50

package/dist/{schema-tables-CLG0mtQb.mjs → schema-tables-Bzx2ShyE.mjs}

@@ -1,7 +1,7 @@
-import { G as listEnvelopeSchema, H as profileFlag, R as connectionFlags, V as outputFlags, f as renderList, z as listFlags } from "./cli.mjs";
-import { t as defineMetabaseCommand } from "./runtime-CNAZ_FuR.mjs";
-import { t as parseId } from "./parse-id-DDCn3VXx.mjs";
-import { n as windowList } from "./window-DSb1tqSe.mjs";
+import { I as outputFlags, L as profileFlag, N as connectionFlags, P as listFlags, o as renderList, z as listEnvelopeSchema } from "./cli.mjs";
+import { t as defineMetabaseCommand } from "./runtime-BQiGgbgZ.mjs";
+import { t as parseId } from "./parse-id-DR8aUSdL.mjs";
+import { n as windowList } from "./window-BkvrP0gB.mjs";
 import { n as TableCompact } from "./table-CeeTJgQb.mjs";
 import { t as tableView } from "./table-CsIJNPFf.mjs";
 //#region src/commands/db/schema-tables.ts
@@ -11,8 +11,7 @@ var schema_tables_default = defineMetabaseCommand({
 		name: "schema-tables",
 		description: "List tables in a database schema"
 	},
-	capabilities: { minVersion: 58 },
-	worktree: "any",
+	requires: ["database.schemaTables"],
 	args: {
 		...outputFlags,
 		...listFlags,

package/dist/{schemas-Cm5NWy59.mjs → schemas-ww5mU2AS.mjs}

@@ -1,7 +1,7 @@
-import { G as listEnvelopeSchema, H as profileFlag, R as connectionFlags, V as outputFlags, f as renderList, z as listFlags } from "./cli.mjs";
-import { t as defineMetabaseCommand } from "./runtime-CNAZ_FuR.mjs";
-import { t as parseId } from "./parse-id-DDCn3VXx.mjs";
-import { n as windowList } from "./window-DSb1tqSe.mjs";
+import { I as outputFlags, L as profileFlag, N as connectionFlags, P as listFlags, o as renderList, z as listEnvelopeSchema } from "./cli.mjs";
+import { t as defineMetabaseCommand } from "./runtime-BQiGgbgZ.mjs";
+import { t as parseId } from "./parse-id-DR8aUSdL.mjs";
+import { n as windowList } from "./window-BkvrP0gB.mjs";
 import { z } from "zod";
 //#region src/commands/db/schemas.ts
 const SchemaName = z.object({ name: z.string() });
@@ -18,8 +18,7 @@ var schemas_default = defineMetabaseCommand({
 		name: "schemas",
 		description: "List schemas in a database"
 	},
-	capabilities: { minVersion: 58 },
-	worktree: "any",
+	requires: ["database.schemas"],
 	args: {
 		...outputFlags,
 		...listFlags,

package/dist/{search-CljYyf2F.mjs → search-J4RwCof-.mjs}

@@ -1,7 +1,7 @@
-import { B as listFlagsWithDefaultLimit, G as listEnvelopeSchema, H as profileFlag, R as connectionFlags, U as worktreeFlag, V as outputFlags, f as renderList } from "./cli.mjs";
-import { r as WORKTREE_SCOPE_DETAIL, s as scopeQuery, t as defineMetabaseCommand, u as parseEnumCsv } from "./runtime-CNAZ_FuR.mjs";
-import { t as parseId } from "./parse-id-DDCn3VXx.mjs";
-import { r as windowServerPage } from "./window-DSb1tqSe.mjs";
+import { F as listFlagsWithDefaultLimit, I as outputFlags, L as profileFlag, N as connectionFlags, o as renderList, z as listEnvelopeSchema } from "./cli.mjs";
+import { i as parseEnumCsv, t as defineMetabaseCommand } from "./runtime-BQiGgbgZ.mjs";
+import { t as parseId } from "./parse-id-DR8aUSdL.mjs";
+import { r as windowServerPage } from "./window-BkvrP0gB.mjs";
 import { i as SearchResultCompact, n as SearchModel, t as SEARCH_MODELS } from "./search-DFBwUc6d.mjs";
 //#region src/output/views/search.ts
 const searchResultView = {
@@ -31,19 +31,17 @@ var search_default = defineMetabaseCommand({
 		name: "search",
 		description: "Search Metabase content (cards, dashboards, collections, …)"
 	},
-	details: "Ranks content against a query string. To simply enumerate a resource, prefer its `… list` verb. " + WORKTREE_SCOPE_DETAIL,
+	details: "Ranks content against a query string. To simply enumerate a resource, prefer its `… list` verb.",
 	skills: [{
 		skill: "core",
 		purpose: "search vs. list"
 	}],
-	capabilities: { minVersion: 58 },
-	worktree: "scoped",
+	requires: ["search.query"],
 	args: {
 		...outputFlags,
 		...listFlagsWithDefaultLimit(DEFAULT_LIMIT),
 		...profileFlag,
 		...connectionFlags,
-		...worktreeFlag,
 		query: {
 			type: "positional",
 			description: "Search query string",
@@ -72,17 +70,13 @@ var search_default = defineMetabaseCommand({
 	examples: [
 		"mb search orders",
 		"mb search --models card,dashboard --limit 10 --json",
-		"mb search products --archived",
-		"mb search orders --worktree feat/transforms"
+		"mb search products --archived"
 	],
-	async run({ args, ctx, getClient, getWorktree }) {
+	async run({ args, ctx, getClient }) {
 		const tableDbIdRaw = args["db-id"];
 		const tableDbId = tableDbIdRaw ? parseId(tableDbIdRaw, "--db-id") : void 0;
 		const models = parseEnumCsv(args.models, SearchModel, "--models");
-		const client = await getClient();
-		const scope = await getWorktree();
-		const { data, total } = await client.search.query({
-			...scopeQuery(scope),
+		const { data, total } = await (await getClient()).search.query({
 			q: nonEmpty(args.query),
 			models,
 			archived: args.archived ? true : void 0,

package/dist/{segment-IRzlQggt.mjs → segment-XXTjU0eG.mjs}

@@ -1,4 +1,4 @@
-import { t as defineCommandGroup } from "./group-YN6jj2AN.mjs";
+import { t as defineCommandGroup } from "./group-CmVCLBDz.mjs";
 //#region src/commands/segment/index.ts
 var segment_default = defineCommandGroup({
 	name: "segment",
@@ -11,11 +11,11 @@ var segment_default = defineCommandGroup({
 		purpose: "define reusable segments"
 	}],
 	subCommands: {
-		list: () => import("./list-BLJkJp5a.mjs").then((mod) => mod.default),
-		get: () => import("./get-B0g6VMBC.mjs").then((mod) => mod.default),
-		create: () => import("./create-BA_tTDEk.mjs").then((mod) => mod.default),
-		update: () => import("./update-CKL2FtoX.mjs").then((mod) => mod.default),
-		archive: () => import("./archive-DFofUIEC.mjs").then((mod) => mod.default)
+		list: () => import("./list-B7tqNV8B.mjs").then((mod) => mod.default),
+		get: () => import("./get-C1ZdOvMm.mjs").then((mod) => mod.default),
+		create: () => import("./create-JOXq0ULN.mjs").then((mod) => mod.default),
+		update: () => import("./update-sYLQIUgh.mjs").then((mod) => mod.default),
+		archive: () => import("./archive-BmsZFOZY.mjs").then((mod) => mod.default)
 	}
 });
 //#endregion

package/dist/{selectors-D4iOP5uB.mjs → selectors-BAAZMi43.mjs}

@@ -1,6 +1,6 @@
-import { i as ConfigError } from "./predicates-Bkm2IoeX.mjs";
-import { c as parseCsv } from "./runtime-CNAZ_FuR.mjs";
-import { t as parseId } from "./parse-id-DDCn3VXx.mjs";
+import { K as ConfigError } from "./cli.mjs";
+import { n as parseCsv } from "./runtime-BQiGgbgZ.mjs";
+import { t as parseId } from "./parse-id-DR8aUSdL.mjs";
 //#region src/commands/library/selectors.ts
 const tableSelectorFlags = {
 	"table-ids": {

package/dist/{send-D7DBnQbu.mjs → send-BmpDlw9O.mjs}

@@ -1,6 +1,6 @@
-import { H as profileFlag, R as connectionFlags, V as outputFlags, p as renderSummary } from "./cli.mjs";
-import { t as defineMetabaseCommand } from "./runtime-CNAZ_FuR.mjs";
-import { t as parseId } from "./parse-id-DDCn3VXx.mjs";
+import { I as outputFlags, L as profileFlag, N as connectionFlags, c as renderSummary } from "./cli.mjs";
+import { t as defineMetabaseCommand } from "./runtime-BQiGgbgZ.mjs";
+import { t as parseId } from "./parse-id-DR8aUSdL.mjs";
 import { z } from "zod";
 //#region src/commands/alert/send.ts
 const AlertSendResult = z.object({
@@ -23,8 +23,7 @@ var send_default = defineMetabaseCommand({
 		description: "Send a question alert now, off-schedule"
 	},
 	details: "Delivers to every handler on the alert, ignoring its send condition and schedule. Requires the channel to be configured on the server (email needs SMTP set up).",
-	capabilities: { minVersion: 58 },
-	worktree: "main-only",
+	requires: ["notification.send"],
 	args: {
 		...outputFlags,
 		...profileFlag,

package/dist/{set-DKN8fuC6.mjs → set-DUWrSza9.mjs}

@@ -1,9 +1,9 @@
-import { H as profileFlag, R as connectionFlags, V as outputFlags, _ as formatScalar, p as renderSummary } from "./cli.mjs";
-import { t as defineMetabaseCommand } from "./runtime-CNAZ_FuR.mjs";
-import { t as readBody } from "./body-DxRSAMNC.mjs";
+import { I as outputFlags, L as profileFlag, N as connectionFlags, c as renderSummary, f as formatScalar } from "./cli.mjs";
+import { t as defineMetabaseCommand } from "./runtime-BQiGgbgZ.mjs";
+import { t as readBody } from "./body-C7m9q4cm.mjs";
 import { r as SettingValue } from "./setting-DTiLCW8g.mjs";
 import { t as settingValueView } from "./setting-CwRYgHYN.mjs";
-import { t as parseSettingKey } from "./key-BEhqIzIQ.mjs";
+import { t as parseSettingKey } from "./key-BmWundO3.mjs";
 import { z } from "zod";
 //#region src/commands/setting/set.ts
 const SettingValueInput = z.unknown().describe("Any JSON value; the setting's own type constraints are enforced server-side");
@@ -12,8 +12,7 @@ var set_default = defineMetabaseCommand({
 		name: "set",
 		description: "Set a setting value (parsed strictly as JSON)"
 	},
-	capabilities: { minVersion: 58 },
-	worktree: "main-only",
+	requires: ["setting.set"],
 	args: {
 		...outputFlags,
 		...profileFlag,

package/dist/{set-active-CkE0Eiqh.mjs → set-active-BiUlbNI5.mjs}

@@ -1,7 +1,7 @@
-import { H as profileFlag, R as connectionFlags, V as outputFlags, p as renderSummary } from "./cli.mjs";
-import { t as defineMetabaseCommand } from "./runtime-CNAZ_FuR.mjs";
-import { n as TransformJobActiveResult } from "./transform-job-DRrK28IH.mjs";
-import { t as parseEnumFlag } from "./parse-enum-D0Jfm_Bz.mjs";
+import { I as outputFlags, L as profileFlag, N as connectionFlags, c as renderSummary } from "./cli.mjs";
+import { t as defineMetabaseCommand } from "./runtime-BQiGgbgZ.mjs";
+import { n as TransformJobActiveResult } from "./transform-job-CCguL6LP.mjs";
+import { t as parseEnumFlag } from "./parse-enum-B1t8S194.mjs";
 import { z } from "zod";
 //#region src/commands/transform-job/set-active.ts
 const ActiveWord = z.enum(["true", "false"]);
@@ -21,8 +21,7 @@ var set_active_default = defineMetabaseCommand({
 		description: "Activate or deactivate every transform job"
 	},
 	details: "Flips the active flag on every transform job at once. Inactive jobs do not run on schedule; manual runs ignore the flag. Requires admin.",
-	capabilities: { minVersion: 61 },
-	worktree: "main-only",
+	requires: ["transformJob.setActive"],
 	args: {
 		...outputFlags,
 		...profileFlag,

package/dist/{setting-CN4l8N-b.mjs → setting-B1KBQN3M.mjs}

@@ -1,4 +1,4 @@
-import { t as defineCommandGroup } from "./group-YN6jj2AN.mjs";
+import { t as defineCommandGroup } from "./group-CmVCLBDz.mjs";
 //#region src/commands/setting/index.ts
 var setting_default = defineCommandGroup({
 	name: "setting",
@@ -8,9 +8,9 @@ var setting_default = defineCommandGroup({
 		purpose: "setting get/set JSON value quoting"
 	}],
 	subCommands: {
-		list: () => import("./list-WSJLnunb.mjs").then((m) => m.default),
-		get: () => import("./get-DFkbi5L3.mjs").then((m) => m.default),
-		set: () => import("./set-DKN8fuC6.mjs").then((m) => m.default)
+		list: () => import("./list-BRpPbvyS.mjs").then((m) => m.default),
+		get: () => import("./get-DgnYF7LR.mjs").then((m) => m.default),
+		set: () => import("./set-DUWrSza9.mjs").then((m) => m.default)
 	}
 });
 //#endregion

package/dist/{setup-BpTptmdO.mjs → setup-CVaNVwOd.mjs}

@@ -1,6 +1,6 @@
-import { H as profileFlag, R as connectionFlags, V as outputFlags, p as renderSummary } from "./cli.mjs";
-import { t as defineMetabaseCommand } from "./runtime-CNAZ_FuR.mjs";
-import { t as readBody } from "./body-DxRSAMNC.mjs";
+import { I as outputFlags, L as profileFlag, N as connectionFlags, c as renderSummary } from "./cli.mjs";
+import { t as defineMetabaseCommand } from "./runtime-BQiGgbgZ.mjs";
+import { t as readBody } from "./body-C7m9q4cm.mjs";
 import { t as bodyInputFlags } from "./body-flags-AqKpN01Y.mjs";
 import { n as SetupResult, r as SetupResultCompact, t as SetupInput } from "./setup-CO7QV-ao.mjs";
 //#region src/output/views/setup.ts
@@ -18,8 +18,7 @@ var setup_default = defineMetabaseCommand({
 		name: "setup",
 		description: "Complete the initial Metabase setup wizard with a default user"
 	},
-	capabilities: { minVersion: 58 },
-	worktree: "main-only",
+	requires: ["setup.create"],
 	args: {
 		...outputFlags,
 		...profileFlag,

package/dist/{signal-CMd0EFUa.mjs → signal-GhGmuHfx.mjs}

@@ -1,4 +1,4 @@
-import { f as errorMessage, n as AbortError, o as MetabaseError } from "./predicates-Bkm2IoeX.mjs";
+import { J as MetabaseError, W as AbortError, et as errorMessage } from "./cli.mjs";
 //#region ../client/src/signal.ts
 function combineAborts(...signals) {
 	return AbortSignal.any(signals.filter((signal) => signal !== void 0));
@@ -12,5 +12,14 @@ function abortReason(signal) {
 	if (reason instanceof Error || typeof reason === "string") return new AbortError(errorMessage(reason) || "aborted");
 	return new AbortError("aborted");
 }
+function untilAborted(promise, signal) {
+	if (signal === void 0) return promise;
+	throwIfAborted(signal);
+	return new Promise((resolve, reject) => {
+		const onAbort = () => reject(abortReason(signal));
+		signal.addEventListener("abort", onAbort, { once: true });
+		promise.then(resolve, reject).finally(() => signal.removeEventListener("abort", onAbort));
+	});
+}
 //#endregion
-export { throwIfAborted as n, combineAborts as t };
+export { throwIfAborted as n, untilAborted as r, combineAborts as t };

package/dist/{list-CtZAu4im.mjs → skill-list-DTnDhnL5.mjs}

@@ -1,9 +1,21 @@
-import { G as listEnvelopeSchema, T as warn, V as outputFlags, f as renderList, w as listTruncationNotice, z as listFlags } from "./cli.mjs";
-import { t as defineMetabaseCommand } from "./runtime-CNAZ_FuR.mjs";
-import { n as windowList } from "./window-DSb1tqSe.mjs";
-import { i as loadVisibleSkills } from "./skills-hVKSOCUf.mjs";
+import { b as listTruncationNotice, x as warn } from "./cli.mjs";
+import { tt as RequirementFailure } from "./runtime-BQiGgbgZ.mjs";
 import { z } from "zod";
 //#region src/output/skill-list.ts
+const UnavailableSkillJson = z.object({
+	name: z.string(),
+	failure: RequirementFailure
+});
+const UnavailableSkills = z.array(UnavailableSkillJson).nullable().describe("Skills left out because the profile's server lacks a feature they need, each with the client's account of the first one missing; `null` when nothing was filtered — `--all` was passed, or the profile has no cached server probe to filter by.");
+const unavailableSkillsFlag = { all: {
+	type: "boolean",
+	description: "Every non-hidden skill, in full, regardless of what the profile's server supports"
+} };
+function skillFilterNotices(unavailable, context) {
+	if (context.bypassed) return [];
+	if (unavailable === null) return [`Skills are unfiltered: profile "${context.profileName}" has no cached server probe (run \`mb auth login\` to record one).`];
+	return unavailable.map((skill) => `Skipped skill "${skill.name}": ${skill.failure.detail} Pass --all to print it anyway.`);
+}
 const DEFAULT_TERMINAL_WIDTH = 80;
 const MIN_WRAP_WIDTH = 24;
 const DESCRIPTION_INDENT = "  ";
@@ -54,46 +66,4 @@ function wrapWidth() {
 	return typeof columns === "number" && columns > 0 ? columns : DEFAULT_TERMINAL_WIDTH;
 }
 //#endregion
-//#region src/commands/skills/list.ts
-const SkillSummary = z.object({
-	name: z.string(),
-	description: z.string()
-});
-const SkillListEnvelope = listEnvelopeSchema(SkillSummary);
-const skillSummaryView = {
-	compactPick: SkillSummary,
-	tableColumns: [{
-		key: "name",
-		label: "Name"
-	}, {
-		key: "description",
-		label: "Description"
-	}]
-};
-var list_default = defineMetabaseCommand({
-	meta: {
-		name: "list",
-		description: "List CLI-bundled skills — always consult the matching skill before acting on a task; they are the source of truth for every workflow."
-	},
-	capabilities: null,
-	worktree: "any",
-	args: {
-		...outputFlags,
-		...listFlags
-	},
-	outputSchema: SkillListEnvelope,
-	examples: ["mb skills list", "mb skills list --json"],
-	run({ ctx }) {
-		const envelope = windowList(loadVisibleSkills().map((s) => ({
-			name: s.name,
-			description: s.description
-		})), ctx.range);
-		if (ctx.format === "json" || ctx.fields !== void 0 || ctx.full) {
-			renderList(envelope, skillSummaryView, ctx);
-			return;
-		}
-		renderSkillList(envelope.data, ctx.maxBytes);
-	}
-});
-//#endregion
-export { list_default as default };
+export { unavailableSkillsFlag as i, renderSkillList as n, skillFilterNotices as r, UnavailableSkills as t };

package/dist/{skills-BSAiLI3Z.mjs → skills-BWrAlj9l.mjs}

@@ -7,9 +7,9 @@ var skills_default = defineCommand({
 	},
 	default: "list",
 	subCommands: {
-		list: () => import("./list-CtZAu4im.mjs").then((m) => m.default),
-		get: () => import("./get-CNEQK0-9.mjs").then((m) => m.default),
-		path: () => import("./path-IYhuzjQV.mjs").then((m) => m.default)
+		list: () => import("./list-bN0RC14-.mjs").then((m) => m.default),
+		get: () => import("./get-CqQ-pf0q.mjs").then((m) => m.default),
+		path: () => import("./path-B96DI8u2.mjs").then((m) => m.default)
 	}
 });
 //#endregion

package/dist/{skills-hVKSOCUf.mjs → skills-DkDsSH5F.mjs}

@@ -1,11 +1,16 @@
-import { d as ValidationError, f as errorMessage, i as ConfigError, p as isFileNotFoundError } from "./predicates-Bkm2IoeX.mjs";
-import { P as readEnv, k as ENV_SKILLS_DIR } from "./cli.mjs";
+import { $ as ValidationError, K as ConfigError, T as ENV_SKILLS_DIR, et as errorMessage, k as readEnv, pt as isFeatureName, tt as isFileNotFoundError, ut as FEATURE_NAMES } from "./cli.mjs";
+import { Z as checkFeatures, n as parseCsv } from "./runtime-BQiGgbgZ.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";
 import { YAMLParseError, parse } from "yaml";
 //#region src/runtime/yaml.ts
+function parseYaml(input, schema, opts = {}) {
+	const result = parseYamlResult(input, schema, opts);
+	if (!result.ok) throw result.error;
+	return result.value;
+}
 function parseYamlResult(input, schema, opts = {}) {
 	const sourcePrefix = opts.source ? `${opts.source}: ` : "";
 	let raw;
@@ -39,7 +44,8 @@ function parseYamlResult(input, schema, opts = {}) {
 const Frontmatter = z.object({
 	name: z.string().min(1),
 	description: z.string().default(""),
-	hidden: z.boolean().default(false)
+	hidden: z.boolean().default(false),
+	requires: z.array(z.string()).default([])
 }).loose();
 const SkillExtraFile = z.object({
 	path: z.string(),
@@ -58,12 +64,37 @@ const SKILL_REFERENCES_DIR = "references";
 const SKILL_TEMPLATES_DIR = "templates";
 const FRONTMATTER_PREFIX_BYTES = 8192;
 const FRONTMATTER_FENCE = "---";
+const SECTION_OPEN_PREFIX = /^<!--\s*requires:\s*/;
+const MARKER_END = /\s*-->$/;
+const SECTION_OPEN = /^<!--\s*requires:.*-->$/;
+const SECTION_CLOSE = /^<!--\s*\/requires\s*-->$/;
+const SECTION_MARKER_TEXT = /<!--\s*\/?requires\b/;
 function loadAllSkills() {
 	return discoverSkills(resolveSkillDirs());
 }
 function loadVisibleSkills() {
 	return loadAllSkills().filter((s) => !s.hidden);
 }
+function selectForProfile(skills, profile) {
+	if (profile === null) return {
+		skills: [...skills],
+		unavailable: null
+	};
+	const available = [];
+	const unavailable = [];
+	for (const skill of skills) {
+		const failure = checkFeatures(skill.requires, profile);
+		if (failure === null) available.push(skill);
+		else unavailable.push({
+			name: skill.name,
+			failure
+		});
+	}
+	return {
+		skills: available,
+		unavailable
+	};
+}
 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)})`);
@@ -126,6 +157,7 @@ function discoverSkills(dirs) {
 				name: fm.name,
 				description: fm.description,
 				hidden: fm.hidden,
+				requires: parseFeatureNames(fm.requires, `skill ${fm.name}`),
 				dir: skillDir
 			});
 		}
@@ -134,9 +166,10 @@ function discoverSkills(dirs) {
 	return skills;
 }
 function readFrontmatterFromSkill(skillDir) {
-	const prefix = readFilePrefix(join(skillDir, SKILL_MD_FILENAME), FRONTMATTER_PREFIX_BYTES);
+	const skillMd = join(skillDir, SKILL_MD_FILENAME);
+	const prefix = readFilePrefix(skillMd, FRONTMATTER_PREFIX_BYTES);
 	if (prefix === null) return null;
-	return parseFrontmatter(prefix);
+	return parseFrontmatter(prefix, skillMd);
 }
 function readFilePrefix(path, maxBytes) {
 	let fd;
@@ -154,18 +187,17 @@ function readFilePrefix(path, maxBytes) {
 		closeSync(fd);
 	}
 }
-function parseFrontmatter(content) {
+function parseFrontmatter(content, source) {
 	const trimmed = content.trimStart();
-	if (!trimmed.startsWith(FRONTMATTER_FENCE)) return null;
+	if (!trimmed.startsWith(FRONTMATTER_FENCE)) throw new ConfigError(`${source}: missing frontmatter`);
 	const afterOpening = trimmed.slice(3);
 	const closingIndex = afterOpening.indexOf(`\n${FRONTMATTER_FENCE}`);
-	if (closingIndex < 0) return null;
-	const result = parseYamlResult(afterOpening.slice(0, closingIndex), Frontmatter);
-	if (!result.ok) return null;
-	return result.value;
+	if (closingIndex < 0) throw new ConfigError(`${source}: unterminated frontmatter`);
+	return parseYaml(afterOpening.slice(0, closingIndex), Frontmatter, { source });
 }
 function readSkillContent(info, opts) {
-	const body = readFileSync(join(info.dir, SKILL_MD_FILENAME), "utf8");
+	const features = opts.profile === null ? null : opts.profile.features;
+	const body = resolveSections(readFileSync(join(info.dir, SKILL_MD_FILENAME), "utf8"), features, `skill ${info.name}`);
 	if (!opts.includeExtras) return {
 		name: info.name,
 		description: info.description,
@@ -173,14 +205,70 @@ function readSkillContent(info, opts) {
 		references: [],
 		templates: []
 	};
+	const references = collectExtraFiles(info.dir, SKILL_REFERENCES_DIR).map((file) => ({
+		path: file.path,
+		content: resolveSections(file.content, features, `skill ${info.name} (${file.path})`)
+	}));
 	return {
 		name: info.name,
 		description: info.description,
 		body,
-		references: collectExtraFiles(info.dir, SKILL_REFERENCES_DIR),
+		references,
 		templates: collectExtraFiles(info.dir, SKILL_TEMPLATES_DIR)
 	};
 }
+function parseFeatureNames(names, where) {
+	const known = [];
+	const unknown = [];
+	for (const name of names) if (isFeatureName(name)) known.push(name);
+	else unknown.push(name);
+	if (unknown.length > 0) throw new ConfigError(`${where}: unknown feature in requires: ${unknown.join(", ")} (known: ${FEATURE_NAMES.join(", ")})`);
+	return known;
+}
+function resolveSections(text, features, where) {
+	const out = [];
+	let open = null;
+	let collapseBlank = false;
+	for (const [index, line] of text.split("\n").entries()) {
+		const lineNumber = index + 1;
+		const trimmed = line.trim();
+		if (SECTION_OPEN.test(trimmed)) {
+			if (open !== null) throw new ConfigError(`${where}: nested requires section at line ${lineNumber} (opened at line ${open.line})`);
+			const named = parseFeatureNames(sectionFeatureNames(trimmed), `${where} line ${lineNumber}`);
+			if (named.length === 0) throw new ConfigError(`${where}: requires section at line ${lineNumber} names no feature`);
+			open = {
+				line: lineNumber,
+				met: features === null || named.every((name) => features[name])
+			};
+			collapseBlank = dropMarker(out, line, features);
+			continue;
+		}
+		if (SECTION_CLOSE.test(trimmed)) {
+			if (open === null) throw new ConfigError(`${where}: requires section closed at line ${lineNumber} was never opened`);
+			collapseBlank = dropMarker(out, line, features);
+			open = null;
+			continue;
+		}
+		if (SECTION_MARKER_TEXT.test(line)) throw new ConfigError(`${where}: a requires marker must be on its own line (line ${lineNumber})`);
+		if (collapseBlank) {
+			collapseBlank = false;
+			if (trimmed === "") continue;
+		}
+		if (open === null || open.met) out.push(line);
+	}
+	if (open !== null) throw new ConfigError(`${where}: requires section opened at line ${open.line} is never closed`);
+	return out.join("\n");
+}
+function dropMarker(out, marker, features) {
+	if (features === null) {
+		out.push(marker);
+		return false;
+	}
+	return out.length === 0 || out[out.length - 1] === "";
+}
+function sectionFeatureNames(marker) {
+	return parseCsv(marker.replace(SECTION_OPEN_PREFIX, "").replace(MARKER_END, ""));
+}
 function collectExtraFiles(skillDir, subdirName) {
 	const subdir = join(skillDir, subdirName);
 	if (!isDirectory(subdir)) return [];
@@ -213,4 +301,4 @@ function isFile(path) {
 	}
 }
 //#endregion
-export { readSkillContent as a, loadVisibleSkills as i, findSkillByName as n, selectSkillsByNames as o, loadAllSkills as r, SkillContent as t };
+export { readSkillContent as a, loadVisibleSkills as i, findSkillByName as n, selectForProfile as o, loadAllSkills as r, selectSkillsByNames as s, SkillContent as t };

package/dist/snippet-CG75L2DS.mjs

@@ -0,0 +1,19 @@
+import { t as defineCommandGroup } from "./group-CmVCLBDz.mjs";
+//#region src/commands/snippet/index.ts
+var snippet_default = defineCommandGroup({
+	name: "snippet",
+	description: "Manage Metabase native query snippets",
+	skills: [{
+		skill: "core",
+		purpose: "native-SQL snippets and body input"
+	}],
+	subCommands: {
+		list: () => import("./list-DoTiQc3D.mjs").then((mod) => mod.default),
+		get: () => import("./get-B89DUSvw.mjs").then((mod) => mod.default),
+		create: () => import("./create-Bwg-5p08.mjs").then((mod) => mod.default),
+		update: () => import("./update-Cr5zHb0D.mjs").then((mod) => mod.default),
+		archive: () => import("./archive-Bf014rFm.mjs").then((mod) => mod.default)
+	}
+});
+//#endregion
+export { snippet_default as default };

package/dist/{snippet-BxgvQ09J.mjs → snippet-CyKAgIZl.mjs}

@@ -7,7 +7,6 @@ const Snippet = z.object({
 	content: z.string(),
 	archived: z.boolean(),
 	collection_id: z.number().int().nullable(),
-	worktree_id: z.number().int().positive().nullable().optional(),
 	creator_id: z.number().int(),
 	entity_id: z.string().nullable(),
 	template_tags: z.record(z.string(), z.unknown()).nullable(),
@@ -19,16 +18,14 @@ const SnippetCompact = Snippet.pick({
 	name: true,
 	description: true,
 	archived: true,
-	collection_id: true,
-	worktree_id: true
+	collection_id: true
 }).strip();
 const snippetName = z.string().regex(/^(?!\s)[^}]*$/, "snippet names cannot include '}' or start with spaces");
 const SnippetCreateInput = z.object({
 	name: snippetName,
 	content: z.string(),
 	description: z.string().nullable().optional(),
-	collection_id: z.number().int().positive().nullable().optional(),
-	worktree_id: z.number().int().positive().nullable().optional()
+	collection_id: z.number().int().positive().nullable().optional()
 }).loose();
 const SnippetUpdateInput = z.object({
 	name: snippetName.nullable().optional(),

package/dist/{snippet-DecHB4Dn.mjs → snippet-oJLaYW9V.mjs}

@@ -1,4 +1,4 @@
-import { n as SnippetCompact } from "./snippet-BxgvQ09J.mjs";
+import { n as SnippetCompact } from "./snippet-CyKAgIZl.mjs";
 //#region src/output/views/snippet.ts
 const snippetView = {
 	compactPick: SnippetCompact,

package/dist/{stash-DJs6A6BA.mjs → stash-DMm8YF8V.mjs}

@@ -1,10 +1,9 @@
-import { i as ConfigError } from "./predicates-Bkm2IoeX.mjs";
-import { H as profileFlag, R as connectionFlags, V as outputFlags, p as renderSummary } from "./cli.mjs";
-import { t as defineMetabaseCommand } from "./runtime-CNAZ_FuR.mjs";
-import { l as SyncStashResult } from "./git-sync-DLzJrdMi.mjs";
-import { n as parseWaitFlags, t as gitSyncWaitFlags } from "./wait-flags-DzytMEG8.mjs";
-import { c as syncStashView } from "./git-sync-LQIVMNxO.mjs";
-import { a as throwIfFailedTask, i as taskPollOptions, n as formatSyncTask } from "./sync-task-G1K47Nvn.mjs";
+import { I as outputFlags, K as ConfigError, L as profileFlag, N as connectionFlags, c as renderSummary } from "./cli.mjs";
+import { t as defineMetabaseCommand } from "./runtime-BQiGgbgZ.mjs";
+import { c as SyncStashResult } from "./git-sync-BDnxPrqU.mjs";
+import { n as parseWaitFlags, t as gitSyncWaitFlags } from "./wait-flags-DiQ_kRjZ.mjs";
+import { s as syncStashView } from "./git-sync-DxD_ng48.mjs";
+import { a as throwIfFailedTask, i as taskPollOptions, n as formatSyncTask } from "./sync-task-BACcrs0i.mjs";
 //#region src/commands/git-sync/stash.ts
 const DEFAULT_STASH_MESSAGE = "Stashed from mb CLI";
 var stash_default = defineMetabaseCommand({
@@ -12,11 +11,7 @@ var stash_default = defineMetabaseCommand({
 		name: "stash",
 		description: "Export current Metabase state to a new branch on the git remote"
 	},
-	capabilities: {
-		minVersion: 60,
-		tokenFeature: "remote_sync"
-	},
-	worktree: "main-only",
+	requires: ["gitSync.stash"],
 	args: {
 		...outputFlags,
 		...profileFlag,