@metabase/cli 0.1.8 → 0.1.9

package/dist/run-JXRivkfH.mjs

@@ -0,0 +1,136 @@
+import { TimeoutError } from "./command-augment-BH9qgQ5u.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-BndUmcwS.mjs";
+import { defineMetabaseCommand } from "./runtime-Ck8KKQe-.mjs";
+import { renderSummary } from "./capabilities-7L9GVMd_.mjs";
+import { parseId } from "./parse-id-Boqc4wn4.mjs";
+import { pollUntil } from "./poll-BMjCkDaj.mjs";
+import { parseWaitFlags, waitFlags } from "./wait-flags-DyFfZeav.mjs";
+import { Transform, TransformRun } from "./transform-DyWCoiO-.mjs";
+import { z } from "zod";
+
+//#region src/commands/transform/run.ts
+const RUN_TERMINAL_STATUSES = new Set([
+	"succeeded",
+	"failed",
+	"timeout",
+	"canceled"
+]);
+const RUN_FAILURE_STATUSES = new Set([
+	"failed",
+	"timeout",
+	"canceled"
+]);
+const TransformRunKickoff = z.object({
+	message: z.string(),
+	run_id: z.number().int().positive().nullable()
+});
+const TransformRunResult = z.object({
+	message: z.string(),
+	run_id: z.number().int().positive().nullable(),
+	final: TransformRun.nullable(),
+	target_table_id: z.number().int().nullable().optional()
+});
+const transformRunResultView = {
+	compactPick: TransformRunResult,
+	tableColumns: [
+		{
+			key: "run_id",
+			label: "Run ID"
+		},
+		{
+			key: "message",
+			label: "Message"
+		},
+		{
+			key: "target_table_id",
+			label: "Target table"
+		}
+	]
+};
+var run_default = defineMetabaseCommand({
+	meta: {
+		name: "run",
+		description: "Trigger a transform run by id"
+	},
+	details: "Starts a run and returns immediately. --wait polls the run to a terminal status. --sync additionally waits until the run's output table is registered and returns its `target_table_id`, so you can build MBQL cards against it — the run registers the table itself, so no separate `db sync-schema` is needed; --sync implies waiting for the run.",
+	capabilities: { minVersion: 59 },
+	args: {
+		...outputFlags,
+		...profileFlag,
+		...connectionFlags,
+		...waitFlags,
+		sync: {
+			type: "boolean",
+			description: "After a successful run, wait until the output table is registered and return its id (implies --wait)",
+			default: false
+		},
+		id: {
+			type: "positional",
+			description: "Transform id",
+			required: true
+		}
+	},
+	outputSchema: TransformRunResult,
+	examples: [
+		"mb transform run 1",
+		"mb transform run 1 --wait --json",
+		"mb transform run 1 --sync --json"
+	],
+	async run({ args, ctx, getClient }) {
+		const id = parseId(args.id);
+		const syncTarget = args.sync === true;
+		const wait = parseWaitFlags(args);
+		const waitForRun = wait.enabled || syncTarget;
+		const client = await getClient();
+		const kickoff = await client.requestParsed(TransformRunKickoff, `/api/transform/${id}/run`, { method: "POST" });
+		if (!waitForRun) {
+			const started = kickoff.run_id === null ? kickoff.message : `Started run ${kickoff.run_id} for transform ${id}.`;
+			renderSummary({
+				message: kickoff.message,
+				run_id: kickoff.run_id,
+				final: null
+			}, transformRunResultView, started, ctx);
+			return;
+		}
+		if (kickoff.run_id === null) {
+			renderSummary({
+				message: kickoff.message,
+				run_id: null,
+				final: null
+			}, transformRunResultView, kickoff.message, ctx);
+			throw new Error(`transform run did not start: ${kickoff.message}`);
+		}
+		const runId = kickoff.run_id;
+		const final = await pollUntil(async () => client.requestParsed(TransformRun, `/api/transform/run/${runId}`), (run) => RUN_TERMINAL_STATUSES.has(run.status), wait.schedule);
+		const failed = RUN_FAILURE_STATUSES.has(final.status);
+		const targetTableId = syncTarget && !failed ? await awaitTargetTableId(client, id, wait.schedule) : void 0;
+		const result = {
+			message: kickoff.message,
+			run_id: runId,
+			final
+		};
+		if (syncTarget) result.target_table_id = targetTableId ?? null;
+		renderSummary(result, transformRunResultView, summaryLine(id, runId, final.status, syncTarget, targetTableId), ctx);
+		if (failed) throw new Error(`transform run ${runId} ${final.status}`);
+	}
+});
+async function awaitTargetTableId(client, transformId, schedule) {
+	try {
+		const linked = await pollUntil(async () => client.requestParsed(Transform, `/api/transform/${transformId}`), (transform) => linkedTableId(transform) !== null, schedule);
+		return linkedTableId(linked);
+	} catch (error) {
+		if (error instanceof TimeoutError) return null;
+		throw error;
+	}
+}
+function linkedTableId(transform) {
+	return transform.target_table_id ?? transform.table?.id ?? null;
+}
+function summaryLine(transformId, runId, status, syncTarget, targetTableId) {
+	const base = `Run ${runId} of transform ${transformId} ${status}.`;
+	if (!syncTarget) return base;
+	return targetTableId === null || targetTableId === void 0 ? `${base} Output table not registered before the wait timeout (it may still be syncing).` : `${base} Output table ${targetTableId} registered.`;
+}
+
+//#endregion
+export { run_default as default };

package/dist/{runs-CqfJIuh_.mjs → runs-FxgbXvax.mjs}

@@ -1,11 +1,10 @@
 import "./command-augment-BH9qgQ5u.mjs";
-import { connectionFlags, listEnvelopeSchema, outputFlags, profileFlag } from "./error-CTVL5CdB.mjs";
-import { defineMetabaseCommand } from "./runtime-B40L_bj8.mjs";
-import "./capabilities-7e9MgquN.mjs";
-import { renderList } from "./render-0_GsapXa.mjs";
-import { parseId } from "./parse-id-D1LTTt9L.mjs";
-import { collectPaginated } from "./paginate-BexjkjbY.mjs";
-import { TransformRun, TransformRunCompact, transformRunView } from "./transform-BKahefz_.mjs";
+import { connectionFlags, listEnvelopeSchema, outputFlags, profileFlag } from "./error-BndUmcwS.mjs";
+import { defineMetabaseCommand } from "./runtime-Ck8KKQe-.mjs";
+import { renderList } from "./capabilities-7L9GVMd_.mjs";
+import { parseId } from "./parse-id-Boqc4wn4.mjs";
+import { collectPaginated } from "./paginate-Dfm9eO9A.mjs";
+import { TransformRun, TransformRunCompact, transformRunView } from "./transform-DyWCoiO-.mjs";
 
 //#region src/commands/transform/runs.ts
 const TransformRunListEnvelope = listEnvelopeSchema(TransformRunCompact);

package/dist/{runtime-B40L_bj8.mjs → runtime-Ck8KKQe-.mjs}

@@ -1,6 +1,6 @@
 import { AbortError, ConfigError, MetabaseError, NetworkError, ResponseShapeError, TimeoutError, ValidationError, errorMessage, flagConsumesValue, isNotFoundError, normalizeFlag, setMetabaseAugment, toAliasArray } from "./command-augment-BH9qgQ5u.mjs";
-import { DEFAULT_MAX_BYTES, package_default, reportError } from "./error-CTVL5CdB.mjs";
-import { BASELINE_CAPABILITIES, isPlainObject, warn } from "./capabilities-7e9MgquN.mjs";
+import { DEFAULT_MAX_BYTES, package_default, reportError } from "./error-BndUmcwS.mjs";
+import { BASELINE_CAPABILITIES, isPlainObject, warn } from "./capabilities-7L9GVMd_.mjs";
 import { defineCommand } from "citty";
 import { z } from "zod";
 import { promises } from "node:fs";
@@ -124,10 +124,7 @@ const ProfileRecord = z.object({
 	lastProbe: ProfileLastProbe.nullable(),
 	lastFailure: ProfileLastFailure.nullable()
 });
-const ProfilesFile = z.object({
-	profiles: z.array(ProfileRecord),
-	license: z.string().nullable()
-});
+const ProfilesFile = z.object({ profiles: z.array(ProfileRecord) });
 
 //#endregion
 //#region src/core/auth/storage.ts
@@ -139,10 +136,7 @@ const PROFILES_FILE_MODE = 384;
 const PROFILES_DIR_MODE = 448;
 const DEFAULT_PROFILE = "default";
 const LEGACY_STORAGE_NOTICE = "Old profile storage detected and ignored; re-run `mb auth login` for each profile.";
-const account = {
-	profileApiKey: (profile) => `profile:${profile}:apiKey`,
-	license: "license"
-};
+const account = { profileApiKey: (profile) => `profile:${profile}:apiKey` };
 let legacyWarningPending = false;
 function profilesFilePath() {
 	return join(configDir(), PROFILES_FILE);
@@ -188,10 +182,7 @@ async function readProfilesFile() {
 	} catch (error) {
 		if (isNotFoundError(error)) {
 			await detectLegacyArtifacts();
-			return {
-				profiles: [],
-				license: null
-			};
+			return { profiles: [] };
 		}
 		throw error;
 	}
@@ -199,10 +190,7 @@ async function readProfilesFile() {
 	if (parsed.ok) return parsed.value;
 	if (parsed.error instanceof ValidationError) {
 		legacyWarningPending = true;
-		return {
-			profiles: [],
-			license: null
-		};
+		return { profiles: [] };
 	}
 	throw parsed.error;
 }
@@ -222,7 +210,7 @@ async function fileExists(path) {
 }
 async function writeProfilesFile(file) {
 	const path = profilesFilePath();
-	if (file.profiles.length === 0 && file.license === null) {
+	if (file.profiles.length === 0) {
 		await promises.unlink(path).catch(() => void 0);
 		await cleanupLegacyFiles();
 		return;
@@ -249,9 +237,9 @@ function fileLocation(key) {
 		reason: keyringEnabled() ? "unavailable" : "disabled"
 	};
 }
-function keyringFallbackWarning(location, subject) {
+function keyringFallbackWarning(location) {
 	const cause = location.reason === "disabled" ? "OS keychain disabled via METABASE_CLI_DISABLE_KEYRING" : "OS keychain unavailable";
-	return `warning: ${cause}; ${subject} stored as plaintext at ${location.path}`;
+	return `warning: ${cause}; credentials stored as plaintext at ${location.path}`;
 }
 async function persistApiKey(name, apiKey) {
 	const key = account.profileApiKey(name);
@@ -360,42 +348,6 @@ async function clearProfile(name = DEFAULT_PROFILE) {
 	});
 	return true;
 }
-async function readLicense() {
-	const fromKeyring = tryReadKeyring(account.license);
-	if (typeof fromKeyring === "string") return fromKeyring;
-	const file = await readProfilesFile();
-	return file.license;
-}
-async function writeLicense(token) {
-	const key = account.license;
-	const file = await readProfilesFile();
-	if (trySetKeyring(key, token)) {
-		if (file.license !== null) await writeProfilesFile({
-			...file,
-			license: null
-		});
-		return {
-			backend: "keyring",
-			service: KEYRING_SERVICE,
-			account: key
-		};
-	}
-	await writeProfilesFile({
-		...file,
-		license: token
-	});
-	return fileLocation(key);
-}
-async function clearLicense() {
-	const removedFromKeyring = tryRemoveKeyring(account.license);
-	const file = await readProfilesFile();
-	const hadInline = file.license !== null;
-	if (hadInline) await writeProfilesFile({
-		...file,
-		license: null
-	});
-	return removedFromKeyring === true || hadInline;
-}
 
 //#endregion
 //#region src/runtime/signal.ts
@@ -556,7 +508,7 @@ function buildUserMessage(kind, input, sanitizedBody) {
 function buildRouteMissingMessage(input) {
 	const path = pathFromUrl(input.url);
 	if (!input.serverTag) return `This endpoint is not available on the connected Metabase: ${input.method} ${path}.`;
-	return `This endpoint is not available on Metabase ${input.serverTag}: ${input.method} ${path}. The command may require a newer Metabase major version. Run 'mb auth list' to see this server's version, or 'mb __manifest' for per-command requirements.`;
+	return `This endpoint is not available on Metabase ${input.serverTag}: ${input.method} ${path}. The command may require a newer Metabase major version. Run 'mb auth list' to see this server's version.`;
 }
 function pathFromUrl(url) {
 	const parsed = new URL(url);
@@ -910,16 +862,12 @@ function originOnly(input) {
 	parsed.password = "";
 	return parsed.origin;
 }
-function localUrl(port) {
-	return `http://localhost:${port}`;
-}
 
 //#endregion
 //#region src/core/config.ts
 const ENV_URL = "METABASE_URL";
 const ENV_API_KEY = "METABASE_API_KEY";
 const ENV_PROFILE = "METABASE_PROFILE";
-const ENV_LICENSE_TOKEN = "METABASE_LICENSE_TOKEN";
 const ENV_SKIP_PREFLIGHT = "METABASE_CLI_SKIP_PREFLIGHT";
 function isPreflightSkipped() {
 	return process.env[ENV_SKIP_PREFLIGHT] === "1";
@@ -936,9 +884,6 @@ function readEnvCredentials() {
 		apiKey: process.env[ENV_API_KEY] ?? null
 	};
 }
-function readEnvLicenseToken() {
-	return process.env[ENV_LICENSE_TOKEN] ?? null;
-}
 async function resolveConfig(flags) {
 	const profile = resolveProfileName(flags.profile);
 	const env = readEnvCredentials();
@@ -959,14 +904,6 @@ async function resolveConfig(flags) {
 		source: urlField.source === keyField.source ? urlField.source : "mixed"
 	};
 }
-async function resolveLicenseToken(flags) {
-	const flag = flags.token;
-	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 \`mb workspace license set\`.`);
-	return value;
-}
 async function failureHintForProfile(profile) {
 	const record = await readProfileRecord(profile);
 	if (record === null || record.lastFailure === null) return "";
@@ -1084,10 +1021,6 @@ function parseInteger(value, options) {
 	if (parsed < options.min) throw new ConfigError(`invalid ${options.name}: ${parsed} (must be ≥ ${options.min})`);
 	return parsed;
 }
-function parseOptionalInteger(value, options) {
-	if (value === void 0 || value === "") return null;
-	return parseInteger(value, options);
-}
 
 //#endregion
 //#region src/commands/context.ts
@@ -1290,4 +1223,4 @@ function buildConfigFlags(ctx) {
 }
 
 //#endregion
-export { DEFAULT_PROFILE, HttpError, ParsedVersionSchema, ProbedUser, ProfileLastFailure, TokenFeatures, USER_AGENT, clearLicense, clearProfile, combineAborts, createClient, defineMetabaseCommand, explicitProfileName, keyringFallbackWarning, listProfileRecords, localUrl, normalizeUrl, originOnly, parseCsv, parseEnum, parseEnumCsv, parseInteger, parseJson, parseJsonOrPlain, parseOptionalInteger, probeServer, readEnvCredentials, readEnvLicenseToken, readLicense, readProfile, readProfileRecord, resolveLicenseToken, resolveProfileName, throwIfAborted, writeLicense, writeProbeFailure, writeProbeResult, writeProfile };
+export { DEFAULT_PROFILE, HttpError, ParsedVersionSchema, ProbedUser, ProfileLastFailure, TokenFeatures, USER_AGENT, clearProfile, combineAborts, createClient, defineMetabaseCommand, explicitProfileName, keyringFallbackWarning, listProfileRecords, normalizeUrl, originOnly, parseCsv, parseEnum, parseEnumCsv, parseInteger, parseJson, parseJsonOrPlain, probeServer, readEnvCredentials, readProfile, readProfileRecord, resolveProfileName, throwIfAborted, writeProbeFailure, writeProbeResult, writeProfile };

package/dist/{schema-tables-CjBRF0_0.mjs → schema-tables-izDPI4f5.mjs}

@@ -1,11 +1,10 @@
 import "./command-augment-BH9qgQ5u.mjs";
-import { connectionFlags, listEnvelopeSchema, outputFlags, profileFlag, wrapList } from "./error-CTVL5CdB.mjs";
-import { defineMetabaseCommand } from "./runtime-B40L_bj8.mjs";
-import "./capabilities-7e9MgquN.mjs";
-import { renderList } from "./render-0_GsapXa.mjs";
-import "./field-E0IBy4Uw.mjs";
-import { parseId } from "./parse-id-D1LTTt9L.mjs";
-import { Table, TableCompact, tableView } from "./table-qDD2kApF.mjs";
+import { connectionFlags, listEnvelopeSchema, outputFlags, profileFlag, wrapList } from "./error-BndUmcwS.mjs";
+import { defineMetabaseCommand } from "./runtime-Ck8KKQe-.mjs";
+import { renderList } from "./capabilities-7L9GVMd_.mjs";
+import "./field-MGxpNQUH.mjs";
+import { parseId } from "./parse-id-Boqc4wn4.mjs";
+import { Table, TableCompact, tableView } from "./table-CkWja2UH.mjs";
 import { z } from "zod";
 
 //#region src/commands/db/schema-tables.ts

package/dist/{schemas-GIIbek2O.mjs → schemas-CyzplnXl.mjs}

@@ -1,9 +1,8 @@
 import "./command-augment-BH9qgQ5u.mjs";
-import { connectionFlags, listEnvelopeSchema, outputFlags, profileFlag, wrapList } from "./error-CTVL5CdB.mjs";
-import { defineMetabaseCommand } from "./runtime-B40L_bj8.mjs";
-import "./capabilities-7e9MgquN.mjs";
-import { renderList } from "./render-0_GsapXa.mjs";
-import { parseId } from "./parse-id-D1LTTt9L.mjs";
+import { connectionFlags, listEnvelopeSchema, outputFlags, profileFlag, wrapList } from "./error-BndUmcwS.mjs";
+import { defineMetabaseCommand } from "./runtime-Ck8KKQe-.mjs";
+import { renderList } from "./capabilities-7L9GVMd_.mjs";
+import { parseId } from "./parse-id-Boqc4wn4.mjs";
 import { z } from "zod";
 
 //#region src/commands/db/schemas.ts

package/dist/{search-h78uOYec.mjs → search-BeuoOEQV.mjs}

@@ -1,9 +1,8 @@
 import "./command-augment-BH9qgQ5u.mjs";
-import { connectionFlags, listEnvelopeSchema, outputFlags, profileFlag } from "./error-CTVL5CdB.mjs";
-import { defineMetabaseCommand, parseEnumCsv } from "./runtime-B40L_bj8.mjs";
-import "./capabilities-7e9MgquN.mjs";
-import { renderList } from "./render-0_GsapXa.mjs";
-import { parseId } from "./parse-id-D1LTTt9L.mjs";
+import { connectionFlags, listEnvelopeSchema, outputFlags, profileFlag } from "./error-BndUmcwS.mjs";
+import { defineMetabaseCommand, parseEnumCsv } from "./runtime-Ck8KKQe-.mjs";
+import { renderList } from "./capabilities-7L9GVMd_.mjs";
+import { parseId } from "./parse-id-Boqc4wn4.mjs";
 import { z } from "zod";
 
 //#region src/domain/search.ts

package/dist/segment-ChYmSM0p.mjs

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

package/dist/{set-BRDxcLcQ.mjs → set-ClzB_5Jk.mjs}

@@ -1,12 +1,11 @@
 import "./command-augment-BH9qgQ5u.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-CTVL5CdB.mjs";
-import { defineMetabaseCommand } from "./runtime-B40L_bj8.mjs";
-import "./capabilities-7e9MgquN.mjs";
-import { formatScalar, renderSummary } from "./render-0_GsapXa.mjs";
-import "./input-cMSEqISy.mjs";
-import { readBody } from "./body-DDYKoyMt.mjs";
-import { SettingValue, settingValueView } from "./setting-BzCng1Ub.mjs";
-import { parseSettingKey, rethrowSettingError } from "./key-vkNkH82H.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-BndUmcwS.mjs";
+import { defineMetabaseCommand } from "./runtime-Ck8KKQe-.mjs";
+import { formatScalar, renderSummary } from "./capabilities-7L9GVMd_.mjs";
+import "./input-xewHccej.mjs";
+import { readBody } from "./body-2jl-YSxT.mjs";
+import { SettingValue, settingValueView } from "./setting-oL97SNeO.mjs";
+import { parseSettingKey, rethrowSettingError } from "./key-C2XG394c.mjs";
 import { z } from "zod";
 
 //#region src/commands/setting/set.ts

package/dist/{setting-mKzZJpQY.mjs → setting-CBJVEx7_.mjs}

@@ -7,9 +7,9 @@ var setting_default = defineCommand({
 		description: "Inspect and update Metabase settings"
 	},
 	subCommands: {
-		list: () => import("./list-V5IuMr_5.mjs").then((m) => m.default),
-		get: () => import("./get-DyArILlF.mjs").then((m) => m.default),
-		set: () => import("./set-BRDxcLcQ.mjs").then((m) => m.default)
+		list: () => import("./list-CCtYVgPN.mjs").then((m) => m.default),
+		get: () => import("./get-BYSj7tMP.mjs").then((m) => m.default),
+		set: () => import("./set-ClzB_5Jk.mjs").then((m) => m.default)
 	}
 });
 

package/dist/{setup-WTIT2WbM.mjs → setup-vKXEUMM7.mjs}

@@ -1,11 +1,10 @@
 import "./command-augment-BH9qgQ5u.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-CTVL5CdB.mjs";
-import { defineMetabaseCommand } from "./runtime-B40L_bj8.mjs";
-import "./capabilities-7e9MgquN.mjs";
-import { renderSummary } from "./render-0_GsapXa.mjs";
-import "./input-cMSEqISy.mjs";
-import { readBody } from "./body-DDYKoyMt.mjs";
-import { bodyInputFlags } from "./body-flags-D7q87Btw.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-BndUmcwS.mjs";
+import { defineMetabaseCommand } from "./runtime-Ck8KKQe-.mjs";
+import { renderSummary } from "./capabilities-7L9GVMd_.mjs";
+import "./input-xewHccej.mjs";
+import { readBody } from "./body-2jl-YSxT.mjs";
+import { bodyInputFlags } from "./body-flags-D78h_-Ua.mjs";
 import { z } from "zod";
 
 //#region src/domain/setup.ts

package/dist/skills-1Z5Wj7Kp.mjs

@@ -0,0 +1,18 @@
+import { defineCommand } from "citty";
+
+//#region src/commands/skills/index.ts
+var skills_default = defineCommand({
+	meta: {
+		name: "skills",
+		description: "Read CLI-bundled skills — always consult the matching skill before acting on a task; they are the source of truth for every workflow."
+	},
+	default: "list",
+	subCommands: {
+		list: () => import("./list-DzKKdfCI.mjs").then((m) => m.default),
+		get: () => import("./get-BpWjLkKT.mjs").then((m) => m.default),
+		path: () => import("./path-ur3NsMFr.mjs").then((m) => m.default)
+	}
+});
+
+//#endregion
+export { skills_default as default };

package/dist/{skills-BkregMyb.mjs → skills-BDPVoBWU.mjs}

@@ -1,10 +1,41 @@
-import { ConfigError, isNotFoundError } from "./command-augment-BH9qgQ5u.mjs";
-import { parseYamlResult } from "./yaml-Gv6wRFMF.mjs";
+import { ConfigError, ValidationError, errorMessage, isNotFoundError } from "./command-augment-BH9qgQ5u.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 parseYamlResult(input, schema, opts = {}) {
+	const sourcePrefix = opts.source ? `${opts.source}: ` : "";
+	let raw;
+	try {
+		raw = parse(input);
+	} catch (error) {
+		if (error instanceof YAMLParseError) return {
+			ok: false,
+			error: new ConfigError(`${sourcePrefix}invalid YAML: ${error.message}`)
+		};
+		return {
+			ok: false,
+			error: new ConfigError(`${sourcePrefix}invalid YAML: ${errorMessage(error)}`)
+		};
+	}
+	const parsed = schema.safeParse(raw);
+	if (!parsed.success) return {
+		ok: false,
+		error: new ValidationError(`${sourcePrefix}value did not match expected schema`, {
+			source: opts.source ?? "<input>",
+			zodIssues: parsed.error.issues
+		})
+	};
+	return {
+		ok: true,
+		value: parsed.data
+	};
+}
+
+//#endregion
 //#region src/core/skills.ts
 const Frontmatter = z.object({
 	name: z.string().min(1),

package/dist/snippet-De70ayL1.mjs

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

package/dist/{stash-DxoAJzcK.mjs → stash-DLtVf4_D.mjs}

@@ -1,12 +1,11 @@
 import { ConfigError } from "./command-augment-BH9qgQ5u.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-CTVL5CdB.mjs";
-import { defineMetabaseCommand } from "./runtime-B40L_bj8.mjs";
-import "./capabilities-7e9MgquN.mjs";
-import { renderSummary } from "./render-0_GsapXa.mjs";
-import "./parse-id-D1LTTt9L.mjs";
-import { REMOTE_SYNC_PATHS, SyncTask, formatSyncTask, pollSyncTask, throwIfFailedTask } from "./poll-task-D8mG49IN.mjs";
-import "./poll-DxpnK1wW.mjs";
-import { gitSyncWaitFlags, parseWaitFlags } from "./wait-flags-CNIeSq0_.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-BndUmcwS.mjs";
+import { defineMetabaseCommand } from "./runtime-Ck8KKQe-.mjs";
+import { renderSummary } from "./capabilities-7L9GVMd_.mjs";
+import "./parse-id-Boqc4wn4.mjs";
+import "./poll-BMjCkDaj.mjs";
+import { gitSyncWaitFlags, parseWaitFlags } from "./wait-flags-DyFfZeav.mjs";
+import { REMOTE_SYNC_PATHS, SyncTask, formatSyncTask, pollSyncTask, throwIfFailedTask } from "./poll-task-CiRA0ER9.mjs";
 import { z } from "zod";
 
 //#region src/commands/git-sync/stash.ts

package/dist/{status-B1dc3bbQ.mjs → status-AnPzI1f7.mjs}

@@ -1,9 +1,8 @@
 import "./command-augment-BH9qgQ5u.mjs";
-import { outputFlags, profileFlag } from "./error-CTVL5CdB.mjs";
-import { ParsedVersionSchema, ProbedUser, ProfileLastFailure, TokenFeatures, defineMetabaseCommand, originOnly, readProfileRecord, resolveProfileName } from "./runtime-B40L_bj8.mjs";
-import "./capabilities-7e9MgquN.mjs";
-import { renderItem } from "./render-0_GsapXa.mjs";
-import { renderTimestamp, renderUserName, renderUserRole, renderVersionTag } from "./render-khznBlla.mjs";
+import { outputFlags, profileFlag } from "./error-BndUmcwS.mjs";
+import { ParsedVersionSchema, ProbedUser, ProfileLastFailure, TokenFeatures, defineMetabaseCommand, originOnly, readProfileRecord, resolveProfileName } from "./runtime-Ck8KKQe-.mjs";
+import { renderItem } from "./capabilities-7L9GVMd_.mjs";
+import { renderTimestamp, renderUserName, renderUserRole, renderVersionTag } from "./render-BQHJhSP1.mjs";
 import { z } from "zod";
 
 //#region src/commands/auth/status.ts

package/dist/{status-D0Ukfodl.mjs → status-DHFYn9kO.mjs}

@@ -1,11 +1,10 @@
 import "./command-augment-BH9qgQ5u.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-CTVL5CdB.mjs";
-import { defineMetabaseCommand } from "./runtime-B40L_bj8.mjs";
-import "./capabilities-7e9MgquN.mjs";
-import { renderSummary } from "./render-0_GsapXa.mjs";
-import { REMOTE_SYNC_PATHS, SyncTask, fetchCurrentTask, fetchOptionalParsed, formatSyncTask } from "./poll-task-D8mG49IN.mjs";
-import "./poll-DxpnK1wW.mjs";
-import { IsDirtyResult } from "./is-dirty-Cke0a1ie.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-BndUmcwS.mjs";
+import { defineMetabaseCommand } from "./runtime-Ck8KKQe-.mjs";
+import { renderSummary } from "./capabilities-7L9GVMd_.mjs";
+import "./poll-BMjCkDaj.mjs";
+import { REMOTE_SYNC_PATHS, SyncTask, fetchCurrentTask, fetchOptionalParsed, formatSyncTask } from "./poll-task-CiRA0ER9.mjs";
+import { IsDirtyResult } from "./is-dirty-DGrmt1ss.mjs";
 import { z } from "zod";
 
 //#region src/commands/git-sync/status.ts

package/dist/{summary-3qOMUcEX.mjs → summary-DDed1LOz.mjs}

@@ -1,10 +1,9 @@
 import "./command-augment-BH9qgQ5u.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-CTVL5CdB.mjs";
-import { defineMetabaseCommand } from "./runtime-B40L_bj8.mjs";
-import "./capabilities-7e9MgquN.mjs";
-import { renderItem } from "./render-0_GsapXa.mjs";
-import { FieldSummary, FieldSummaryRaw, fieldSummaryView } from "./field-E0IBy4Uw.mjs";
-import { parseId } from "./parse-id-D1LTTt9L.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-BndUmcwS.mjs";
+import { defineMetabaseCommand } from "./runtime-Ck8KKQe-.mjs";
+import { renderItem } from "./capabilities-7L9GVMd_.mjs";
+import { FieldSummary, FieldSummaryRaw, fieldSummaryView } from "./field-MGxpNQUH.mjs";
+import { parseId } from "./parse-id-Boqc4wn4.mjs";
 
 //#region src/commands/field/summary.ts
 var summary_default = defineMetabaseCommand({