create-better-fullstack 2.0.3 → 2.1.1

package/dist/doctor-BFSSbS-U.mjs

@@ -0,0 +1,280 @@
+#!/usr/bin/env node
+import { a as handleError, m as readBtsConfig } from "./errors-D9yiiGVq.mjs";
+import { t as renderTitle } from "./render-title-zvyKC1ej.mjs";
+import { t as runGeneratedChecks } from "./generated-checks-DUvVXWId.mjs";
+import { intro, log, spinner } from "@clack/prompts";
+import pc from "picocolors";
+import fs from "fs-extra";
+import path from "node:path";
+import { $ } from "execa";
+
+//#region src/commands/doctor.ts
+const NON_TS_BACKEND_ECOSYSTEMS = new Set([
+	"go",
+	"rust",
+	"python",
+	"elixir",
+	"java",
+	"dotnet"
+]);
+const IGNORED_DIRECTORIES = new Set([
+	"node_modules",
+	".git",
+	"dist",
+	"build",
+	".next",
+	".expo",
+	".turbo",
+	"target",
+	".venv",
+	"deps",
+	"_build"
+]);
+const JS_LOCKFILES = [
+	"bun.lock",
+	"bun.lockb",
+	"pnpm-lock.yaml",
+	"package-lock.json",
+	"yarn.lock"
+];
+const NATIVE_LOCKFILES = {
+	rust: {
+		file: "Cargo.lock",
+		hint: "cargo build"
+	},
+	go: {
+		file: "go.sum",
+		hint: "go mod tidy"
+	},
+	python: {
+		file: "uv.lock",
+		hint: "uv sync"
+	},
+	elixir: {
+		file: "mix.lock",
+		hint: "mix deps.get"
+	}
+};
+function statusIcon(status) {
+	switch (status) {
+		case "pass": return pc.green("✓");
+		case "warn": return pc.yellow("!");
+		case "fail": return pc.red("✗");
+	}
+}
+function hasNativeChecks(config) {
+	if (NON_TS_BACKEND_ECOSYSTEMS.has(config.ecosystem)) return true;
+	return (config.stackParts ?? []).some((part) => part.source !== "provided" && part.role === "backend" && NON_TS_BACKEND_ECOSYSTEMS.has(part.ecosystem));
+}
+async function checkInstalledDependencies(projectDir, config) {
+	const checks = [];
+	if (await fs.pathExists(path.join(projectDir, "package.json"))) {
+		const lockfile = JS_LOCKFILES.find((name) => fs.existsSync(path.join(projectDir, name)));
+		checks.push(lockfile ? {
+			label: "Lockfile",
+			status: "pass",
+			detail: lockfile
+		} : {
+			label: "Lockfile",
+			status: "warn",
+			detail: "No JavaScript lockfile found at the project root"
+		});
+		const nodeModulesExists = await fs.pathExists(path.join(projectDir, "node_modules"));
+		checks.push(nodeModulesExists ? {
+			label: "node_modules",
+			status: "pass"
+		} : {
+			label: "node_modules",
+			status: "fail",
+			detail: `Dependencies are not installed. Run \`${config.packageManager ?? "npm"} install\`.`
+		});
+	}
+	const native = NATIVE_LOCKFILES[config.ecosystem];
+	if (native) {
+		const exists = await fs.pathExists(path.join(projectDir, native.file)) || await fs.pathExists(path.join(projectDir, "apps/server", native.file));
+		checks.push(exists ? {
+			label: native.file,
+			status: "pass"
+		} : {
+			label: native.file,
+			status: "warn",
+			detail: `Not found. Run \`${native.hint}\` to fetch dependencies.`
+		});
+	}
+	return checks;
+}
+async function findEnvExampleFiles(rootDir) {
+	const results = [];
+	async function walk(dir, depth) {
+		if (depth > 5) return;
+		let entries;
+		try {
+			entries = await fs.readdir(dir, { withFileTypes: true });
+		} catch {
+			return;
+		}
+		for (const entry of entries) if (entry.isDirectory()) {
+			if (IGNORED_DIRECTORIES.has(entry.name)) continue;
+			await walk(path.join(dir, entry.name), depth + 1);
+		} else if (entry.name === ".env.example") results.push(path.join(dir, entry.name));
+	}
+	await walk(rootDir, 0);
+	return results;
+}
+function parseEnvKeys(content) {
+	const map = /* @__PURE__ */ new Map();
+	for (const rawLine of content.split("\n")) {
+		const line = rawLine.trim();
+		if (!line || line.startsWith("#")) continue;
+		const eq = line.indexOf("=");
+		if (eq === -1) continue;
+		const key = line.slice(0, eq).trim();
+		if (key) map.set(key, line.slice(eq + 1).trim());
+	}
+	return map;
+}
+async function checkEnvFiles(projectDir) {
+	const checks = [];
+	const exampleFiles = await findEnvExampleFiles(projectDir);
+	for (const examplePath of exampleFiles) {
+		const envPath = examplePath.replace(/\.example$/, "");
+		const relExample = path.relative(projectDir, examplePath) || ".env.example";
+		const exampleKeys = parseEnvKeys(await fs.readFile(examplePath, "utf-8"));
+		if (exampleKeys.size === 0) continue;
+		if (!await fs.pathExists(envPath)) {
+			checks.push({
+				label: relExample,
+				status: "warn",
+				detail: `Missing ${path.relative(projectDir, envPath)} (copy from .env.example and fill in values)`
+			});
+			continue;
+		}
+		const envKeys = parseEnvKeys(await fs.readFile(envPath, "utf-8"));
+		const missing = [];
+		for (const key of exampleKeys.keys()) {
+			const value = envKeys.get(key);
+			if (value === void 0 || value === "") missing.push(key);
+		}
+		checks.push(missing.length > 0 ? {
+			label: path.relative(projectDir, envPath),
+			status: "warn",
+			detail: `Missing or empty: ${missing.join(", ")}`
+		} : {
+			label: path.relative(projectDir, envPath),
+			status: "pass"
+		});
+	}
+	return checks;
+}
+async function runBuildChecks(config, json) {
+	const checks = [];
+	const projectDir = config.projectDir;
+	const rootPackageJsonPath = path.join(projectDir, "package.json");
+	if (await fs.pathExists(rootPackageJsonPath)) {
+		if ((await fs.readJson(rootPackageJsonPath).catch(() => ({}))).scripts?.["check-types"]) {
+			const pm = config.packageManager ?? "npm";
+			const s = json ? null : spinner();
+			s?.start("Running type checks (check-types)...");
+			const result = await $({
+				cwd: projectDir,
+				reject: false,
+				stdout: json ? "ignore" : "inherit",
+				stderr: json ? "ignore" : "inherit"
+			})`${pm} run check-types`;
+			if (result.exitCode === 0) {
+				s?.stop("Type checks passed");
+				checks.push({
+					label: "check-types",
+					status: "pass"
+				});
+			} else {
+				s?.stop(pc.red("Type checks failed"));
+				checks.push({
+					label: "check-types",
+					status: "fail",
+					detail: `\`${pm} run check-types\` exited with code ${result.exitCode ?? `signal ${result.signal}`}`
+				});
+			}
+		}
+	}
+	if (hasNativeChecks(config)) if (json) checks.push({
+		label: "ecosystem build checks",
+		status: "warn",
+		detail: "Skipped in --json mode. Re-run without --json to execute native build checks."
+	});
+	else try {
+		await runGeneratedChecks(config);
+		checks.push({
+			label: "ecosystem build checks",
+			status: "pass"
+		});
+	} catch (error) {
+		checks.push({
+			label: "ecosystem build checks",
+			status: "fail",
+			detail: error instanceof Error ? error.message : String(error)
+		});
+	}
+	return checks;
+}
+async function doctorCommand(input) {
+	const projectDir = path.resolve(input.projectDir || process.cwd());
+	const json = input.json ?? false;
+	const btsConfig = await readBtsConfig(projectDir);
+	if (!btsConfig) {
+		if (json) {
+			console.log(JSON.stringify({
+				projectDir,
+				ok: false,
+				error: "No Better Fullstack project found (bts.jsonc missing or invalid)."
+			}, null, 2));
+			process.exit(1);
+		}
+		handleError(`No Better Fullstack project found in ${projectDir}. Make sure bts.jsonc exists.`);
+	}
+	const config = {
+		...btsConfig,
+		projectDir
+	};
+	if (!json) {
+		renderTitle();
+		intro(pc.magenta(`Diagnosing ${pc.cyan(path.basename(projectDir))}`));
+		log.info(pc.dim(`Path: ${projectDir}`));
+		log.info(pc.dim(`Ecosystem: ${btsConfig.ecosystem}`));
+		if (btsConfig.graphSummary) log.info(pc.dim(`Stack: ${btsConfig.graphSummary}`));
+	}
+	const checks = [{
+		label: "bts.jsonc",
+		status: "pass",
+		detail: `version ${btsConfig.version}`
+	}];
+	checks.push(...await checkInstalledDependencies(projectDir, btsConfig));
+	checks.push(...await checkEnvFiles(projectDir));
+	if (!input.skipChecks) checks.push(...await runBuildChecks(config, json));
+	const counts = {
+		pass: 0,
+		warn: 0,
+		fail: 0
+	};
+	for (const check of checks) counts[check.status] += 1;
+	if (json) console.log(JSON.stringify({
+		projectDir,
+		ecosystem: btsConfig.ecosystem,
+		ok: counts.fail === 0,
+		summary: counts,
+		checks
+	}, null, 2));
+	else {
+		log.message("");
+		for (const check of checks) log.message(`${statusIcon(check.status)} ${check.label}${check.detail ? pc.dim(` — ${check.detail}`) : ""}`);
+		log.message("");
+		const summaryLine = `${pc.green(`${counts.pass} passed`)}, ${pc.yellow(`${counts.warn} warnings`)}, ${pc.red(`${counts.fail} failed`)}`;
+		if (counts.fail > 0) log.error(`Diagnosis complete: ${summaryLine}`);
+		else if (counts.warn > 0) log.warn(`Diagnosis complete: ${summaryLine}`);
+		else log.success(`Diagnosis complete: ${summaryLine}`);
+	}
+	if (counts.fail > 0) process.exit(1);
+}
+
+//#endregion
+export { doctorCommand };

package/dist/{bts-config-Bg1Qea9Y.mjs → errors-D9yiiGVq.mjs}

@@ -1,76 +1,15 @@
 #!/usr/bin/env node
 import { t as __reExport } from "./chunk-CCII7kTE.mjs";
+import { cancel } from "@clack/prompts";
+import pc from "picocolors";
 import fs from "fs-extra";
 import path from "node:path";
-import { fileURLToPath } from "node:url";
-import { createCliDefaultProjectConfigBase } from "@better-fullstack/types";
 import * as JSONC from "jsonc-parser";
+import { createCliDefaultProjectConfigBase } from "@better-fullstack/types";
+import { fileURLToPath } from "node:url";
+import { AsyncLocalStorage } from "node:async_hooks";
+import consola from "consola";
 
-//#region src/utils/get-package-manager.ts
-const getUserPkgManager = () => {
-	const userAgent = process.env.npm_config_user_agent;
-	if (userAgent?.startsWith("pnpm")) return "pnpm";
-	if (userAgent?.startsWith("bun")) return "bun";
-	if (userAgent?.startsWith("yarn")) return "yarn";
-	return "npm";
-};
-
-//#endregion
-//#region src/constants.ts
-const __filename = fileURLToPath(import.meta.url);
-const distPath = path.dirname(__filename);
-const PKG_ROOT = path.join(distPath, "../");
-const DEFAULT_CONFIG_BASE = createCliDefaultProjectConfigBase(getUserPkgManager());
-function getDefaultConfig() {
-	return {
-		...DEFAULT_CONFIG_BASE,
-		projectDir: path.resolve(process.cwd(), DEFAULT_CONFIG_BASE.projectName),
-		packageManager: getUserPkgManager(),
-		frontend: [...DEFAULT_CONFIG_BASE.frontend],
-		addons: [...DEFAULT_CONFIG_BASE.addons],
-		examples: [...DEFAULT_CONFIG_BASE.examples],
-		rustLibraries: [...DEFAULT_CONFIG_BASE.rustLibraries],
-		pythonAi: [...DEFAULT_CONFIG_BASE.pythonAi],
-		javaLibraries: [...DEFAULT_CONFIG_BASE.javaLibraries],
-		javaTestingLibraries: [...DEFAULT_CONFIG_BASE.javaTestingLibraries],
-		aiDocs: [...DEFAULT_CONFIG_BASE.aiDocs]
-	};
-}
-const DEFAULT_CONFIG = getDefaultConfig();
-/**
-* Default UI library for each frontend framework
-* Falls back based on what's compatible
-*/
-const DEFAULT_UI_LIBRARY_BY_FRONTEND = {
-	"tanstack-router": "shadcn-ui",
-	"react-router": "shadcn-ui",
-	"react-vite": "shadcn-ui",
-	"tanstack-start": "shadcn-ui",
-	next: "shadcn-ui",
-	vinext: "shadcn-ui",
-	nuxt: "daisyui",
-	svelte: "daisyui",
-	solid: "daisyui",
-	"solid-start": "daisyui",
-	astro: "daisyui",
-	qwik: "daisyui",
-	angular: "daisyui",
-	redwood: "daisyui",
-	fresh: "daisyui",
-	"native-bare": "none",
-	"native-uniwind": "none",
-	"native-unistyles": "none",
-	none: "none"
-};
-
-//#endregion
-//#region src/utils/get-latest-cli-version.ts
-const getLatestCLIVersion = () => {
-	const packageJsonPath = path.join(PKG_ROOT, "package.json");
-	return fs.readJSONSync(packageJsonPath).version ?? "1.0.0";
-};
-
-//#endregion
 //#region src/types.ts
 var types_exports = {};
 import * as import__better_fullstack_types from "@better-fullstack/types";
@@ -228,16 +167,93 @@ function getGraphBackendDeployInstructions(config) {
 	}
 }
 
+//#endregion
+//#region src/utils/get-package-manager.ts
+const getUserPkgManager = () => {
+	const userAgent = process.env.npm_config_user_agent;
+	if (userAgent?.startsWith("pnpm")) return "pnpm";
+	if (userAgent?.startsWith("bun")) return "bun";
+	if (userAgent?.startsWith("yarn")) return "yarn";
+	return "npm";
+};
+
+//#endregion
+//#region src/constants.ts
+const __filename = fileURLToPath(import.meta.url);
+const distPath = path.dirname(__filename);
+const PKG_ROOT = path.join(distPath, "../");
+const DEFAULT_CONFIG_BASE = createCliDefaultProjectConfigBase(getUserPkgManager());
+function getDefaultConfig() {
+	return {
+		...DEFAULT_CONFIG_BASE,
+		projectDir: path.resolve(process.cwd(), DEFAULT_CONFIG_BASE.projectName),
+		packageManager: getUserPkgManager(),
+		frontend: [...DEFAULT_CONFIG_BASE.frontend],
+		addons: [...DEFAULT_CONFIG_BASE.addons],
+		examples: [...DEFAULT_CONFIG_BASE.examples],
+		rustLibraries: [...DEFAULT_CONFIG_BASE.rustLibraries],
+		pythonAi: [...DEFAULT_CONFIG_BASE.pythonAi],
+		javaLibraries: [...DEFAULT_CONFIG_BASE.javaLibraries],
+		javaTestingLibraries: [...DEFAULT_CONFIG_BASE.javaTestingLibraries],
+		aiDocs: [...DEFAULT_CONFIG_BASE.aiDocs]
+	};
+}
+const DEFAULT_CONFIG = getDefaultConfig();
+/**
+* Default UI library for each frontend framework
+* Falls back based on what's compatible
+*/
+const DEFAULT_UI_LIBRARY_BY_FRONTEND = {
+	"tanstack-router": "shadcn-ui",
+	"react-router": "shadcn-ui",
+	"react-vite": "shadcn-ui",
+	"tanstack-start": "shadcn-ui",
+	next: "shadcn-ui",
+	vinext: "shadcn-ui",
+	nuxt: "daisyui",
+	svelte: "daisyui",
+	solid: "daisyui",
+	"solid-start": "daisyui",
+	astro: "daisyui",
+	qwik: "daisyui",
+	angular: "daisyui",
+	redwood: "daisyui",
+	fresh: "daisyui",
+	"native-bare": "none",
+	"native-uniwind": "none",
+	"native-unistyles": "none",
+	none: "none"
+};
+
+//#endregion
+//#region src/utils/get-latest-cli-version.ts
+const getLatestCLIVersion = () => {
+	const packageJsonPath = path.join(PKG_ROOT, "package.json");
+	return fs.readJSONSync(packageJsonPath).version ?? "1.0.0";
+};
+
 //#endregion
 //#region src/utils/bts-config.ts
 const BTS_CONFIG_FILE = "bts.jsonc";
+const MOBILE_CONFIG_FIELDS = [
+	"mobileNavigation",
+	"mobileUI",
+	"mobileStorage",
+	"mobileTesting",
+	"mobilePush",
+	"mobileOTA",
+	"mobileDeepLinking"
+];
 function normalizeGraphConfigForPersistence(projectConfig, stackParts) {
 	if (!stackParts) return projectConfig;
 	const legacyConfig = (0, types_exports.stackPartsToLegacyProjectConfigPartial)(stackParts);
 	const selectedEcosystems = new Set(stackParts.filter((part) => part.source !== "provided").map((part) => part.ecosystem));
+	selectedEcosystems.add(projectConfig.ecosystem);
+	const hasSelectedEcosystemStackParts = stackParts.some((part) => part.source !== "provided" && part.ecosystem !== "universal");
 	const normalized = {
 		...projectConfig,
-		...legacyConfig
+		...legacyConfig,
+		ecosystem: hasSelectedEcosystemStackParts ? legacyConfig.ecosystem ?? projectConfig.ecosystem : projectConfig.ecosystem
 	};
 	if (!selectedEcosystems.has("rust")) {
 		normalized.rustWebFramework = "none";
@@ -285,6 +301,7 @@ function normalizeGraphConfigForPersistence(projectConfig, stackParts) {
 		normalized.goConfig = "none";
 		normalized.goObservability = "none";
 	}
+	if (selectedEcosystems.has("go") && projectConfig.auth === "go-better-auth" && legacyConfig.auth === "none") normalized.auth = projectConfig.auth;
 	if (!selectedEcosystems.has("java")) {
 		normalized.javaWebFramework = "none";
 		normalized.javaBuildTool = "none";
@@ -326,7 +343,15 @@ function normalizeGraphConfigForPersistence(projectConfig, stackParts) {
 		normalized.elixirDeploy = "none";
 		normalized.elixirLibraries = [];
 	}
-	if (!selectedEcosystems.has("react-native")) {
+	const projectHasNativeFrontend = projectConfig.frontend.some((frontend) => frontend.startsWith("native-"));
+	const normalizedHasNativeFrontend = normalized.frontend.some((frontend) => frontend.startsWith("native-"));
+	const hasNativeFrontend = projectHasNativeFrontend || normalizedHasNativeFrontend;
+	if (hasNativeFrontend) for (const field of MOBILE_CONFIG_FIELDS) {
+		const projectValue = projectConfig[field];
+		const legacyValue = legacyConfig[field];
+		if (projectValue !== void 0 && projectValue !== "none" && legacyValue === "none") normalized[field] = projectValue;
+	}
+	if (!selectedEcosystems.has("react-native") && !hasNativeFrontend) {
 		normalized.mobileNavigation = "none";
 		normalized.mobileUI = "none";
 		normalized.mobileStorage = "none";
@@ -425,8 +450,16 @@ function buildBtsConfigForPersistence(projectConfig, metadata = {}) {
 		api: persistedConfig.api,
 		webDeploy: persistedConfig.webDeploy,
 		serverDeploy: persistedConfig.serverDeploy,
+		astroIntegration: persistedConfig.astroIntegration,
 		cssFramework: persistedConfig.cssFramework,
 		uiLibrary: persistedConfig.uiLibrary,
+		shadcnBase: persistedConfig.shadcnBase,
+		shadcnStyle: persistedConfig.shadcnStyle,
+		shadcnIconLibrary: persistedConfig.shadcnIconLibrary,
+		shadcnColorTheme: persistedConfig.shadcnColorTheme,
+		shadcnBaseColor: persistedConfig.shadcnBaseColor,
+		shadcnFont: persistedConfig.shadcnFont,
+		shadcnRadius: persistedConfig.shadcnRadius,
 		realtime: persistedConfig.realtime,
 		jobQueue: persistedConfig.jobQueue,
 		animation: persistedConfig.animation,
@@ -446,6 +479,7 @@ function buildBtsConfigForPersistence(projectConfig, metadata = {}) {
 		rateLimit: persistedConfig.rateLimit,
 		i18n: persistedConfig.i18n,
 		search: persistedConfig.search,
+		vectorDb: persistedConfig.vectorDb,
 		fileStorage: persistedConfig.fileStorage,
 		rustWebFramework: persistedConfig.rustWebFramework,
 		rustFrontend: persistedConfig.rustFrontend,
@@ -537,8 +571,8 @@ function previewBtsConfigUpdate(currentConfig, updates) {
 		createdAt: currentConfig.createdAt
 	});
 }
-async function writeBtsConfig(projectConfig) {
-	const btsConfig = buildBtsConfigForPersistence(projectConfig);
+async function writeBtsConfig(projectConfig, metadata = {}) {
+	const btsConfig = buildBtsConfigForPersistence(projectConfig, metadata);
 	const baseContent = {
 		$schema: "https://better-fullstack-web.vercel.app/schema.json",
 		version: btsConfig.version,
@@ -571,8 +605,16 @@ async function writeBtsConfig(projectConfig) {
 		api: btsConfig.api,
 		webDeploy: btsConfig.webDeploy,
 		serverDeploy: btsConfig.serverDeploy,
+		astroIntegration: btsConfig.astroIntegration,
 		cssFramework: btsConfig.cssFramework,
 		uiLibrary: btsConfig.uiLibrary,
+		shadcnBase: btsConfig.shadcnBase,
+		shadcnStyle: btsConfig.shadcnStyle,
+		shadcnIconLibrary: btsConfig.shadcnIconLibrary,
+		shadcnColorTheme: btsConfig.shadcnColorTheme,
+		shadcnBaseColor: btsConfig.shadcnBaseColor,
+		shadcnFont: btsConfig.shadcnFont,
+		shadcnRadius: btsConfig.shadcnRadius,
 		realtime: btsConfig.realtime,
 		jobQueue: btsConfig.jobQueue,
 		animation: btsConfig.animation,
@@ -592,6 +634,7 @@ async function writeBtsConfig(projectConfig) {
 		rateLimit: btsConfig.rateLimit,
 		i18n: btsConfig.i18n,
 		search: btsConfig.search,
+		vectorDb: btsConfig.vectorDb,
 		fileStorage: btsConfig.fileStorage,
 		rustWebFramework: btsConfig.rustWebFramework,
 		rustFrontend: btsConfig.rustFrontend,
@@ -708,6 +751,27 @@ async function readBtsConfig(projectDir) {
 		return null;
 	}
 }
+async function readBtsConfigFromFile(filePath) {
+	try {
+		const resolved = path.resolve(process.cwd(), filePath);
+		if (!await fs.pathExists(resolved)) return null;
+		const configPath = (await fs.stat(resolved)).isDirectory() ? path.join(resolved, BTS_CONFIG_FILE) : resolved;
+		if (!await fs.pathExists(configPath)) return null;
+		const configContent = await fs.readFile(configPath, "utf-8");
+		const errors = [];
+		const config = JSONC.parse(configContent, errors, {
+			allowTrailingComma: true,
+			disallowComments: false
+		});
+		if (errors.length > 0 || config === void 0 || typeof config !== "object") return null;
+		return buildBtsConfigForPersistence(config, {
+			version: config.version,
+			createdAt: config.createdAt
+		});
+	} catch {
+		return null;
+	}
+}
 async function updateBtsConfig(projectDir, updates) {
 	try {
 		const configPath = path.join(projectDir, BTS_CONFIG_FILE);
@@ -734,4 +798,83 @@ async function updateBtsConfig(projectDir, updates) {
 }
 
 //#endregion
-export { getUserPkgManager as _, getEffectiveStack as a, getGraphPart as c, hasGraphPart as d, types_exports as f, getDefaultConfig as g, DEFAULT_UI_LIBRARY_BY_FRONTEND as h, writeBtsConfig as i, getGraphSummary as l, DEFAULT_CONFIG as m, readBtsConfig as n, getGraphBackendDeployInstructions as o, getLatestCLIVersion as p, updateBtsConfig as r, getGraphBackendUrl as s, previewBtsConfigUpdate as t, getPrimaryGraphPart as u };
+//#region src/utils/context.ts
+const cliStorage = new AsyncLocalStorage();
+function defaultContext() {
+	return {
+		navigation: {
+			isFirstPrompt: false,
+			lastPromptShownUI: false
+		},
+		silent: false
+	};
+}
+function getContext() {
+	const ctx = cliStorage.getStore();
+	if (!ctx) return defaultContext();
+	return ctx;
+}
+function tryGetContext() {
+	return cliStorage.getStore();
+}
+function isSilent() {
+	return getContext().silent;
+}
+function isFirstPrompt() {
+	return getContext().navigation.isFirstPrompt;
+}
+function didLastPromptShowUI() {
+	return getContext().navigation.lastPromptShownUI;
+}
+function setIsFirstPrompt(value) {
+	const ctx = tryGetContext();
+	if (ctx) ctx.navigation.isFirstPrompt = value;
+}
+function setLastPromptShownUI(value) {
+	const ctx = tryGetContext();
+	if (ctx) ctx.navigation.lastPromptShownUI = value;
+}
+async function runWithContextAsync(options, fn) {
+	const ctx = {
+		navigation: {
+			isFirstPrompt: false,
+			lastPromptShownUI: false
+		},
+		silent: options.silent ?? false
+	};
+	return cliStorage.run(ctx, fn);
+}
+
+//#endregion
+//#region src/utils/errors.ts
+var UserCancelledError = class extends Error {
+	constructor(message = "Operation cancelled") {
+		super(message);
+		this.name = "UserCancelledError";
+	}
+};
+var CLIError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "CLIError";
+	}
+};
+function exitWithError(message) {
+	if (isSilent()) throw new CLIError(message);
+	consola.error(pc.red(message));
+	process.exit(1);
+}
+function exitCancelled(message = "Operation cancelled") {
+	if (isSilent()) throw new UserCancelledError(message);
+	cancel(pc.red(message));
+	process.exit(1);
+}
+function handleError(error, fallbackMessage) {
+	const message = error instanceof Error ? error.message : fallbackMessage || String(error);
+	if (isSilent()) throw error instanceof Error ? error : new Error(message);
+	consola.error(pc.red(message));
+	process.exit(1);
+}
+
+//#endregion
+export { types_exports as A, getEffectiveStack as C, getGraphSummary as D, getGraphPart as E, getPrimaryGraphPart as O, getUserPkgManager as S, getGraphBackendUrl as T, writeBtsConfig as _, handleError as a, DEFAULT_UI_LIBRARY_BY_FRONTEND as b, isSilent as c, setLastPromptShownUI as d, buildBtsConfigForPersistence as f, updateBtsConfig as g, readBtsConfigFromFile as h, exitWithError as i, hasGraphPart as k, runWithContextAsync as l, readBtsConfig as m, UserCancelledError as n, didLastPromptShowUI as o, previewBtsConfigUpdate as p, exitCancelled as r, isFirstPrompt as s, CLIError as t, setIsFirstPrompt as u, getLatestCLIVersion as v, getGraphBackendDeployInstructions as w, getDefaultConfig as x, DEFAULT_CONFIG as y };