create-better-fullstack 2.0.2 → 2.1.0

package/dist/{add-handler-BPAZM8Zo.mjs → add-handler-BjTmOwEN.mjs}

@@ -1,7 +1,9 @@
 #!/usr/bin/env node
-import { g as getDefaultConfig, n as readBtsConfig, r as updateBtsConfig } from "./bts-config-Bg1Qea9Y.mjs";
-import { W as renderTitle, c as applyDependencyVersionChannel, t as installDependencies, u as getAddonsToAdd } from "./install-dependencies-D6-GO3BZ.mjs";
-import { a as CLIError, f as isSilent, o as UserCancelledError, p as runWithContextAsync, t as setupAddons } from "./addons-setup-HSghQS7c.mjs";
+import { a as updateBtsConfig, r as readBtsConfig, u as getDefaultConfig } from "./bts-config-InNcw1aJ.mjs";
+import { t as renderTitle } from "./render-title-zvyKC1ej.mjs";
+import { c as isSilent, l as runWithContextAsync, n as UserCancelledError, t as CLIError } from "./errors-ns_o2OKg.mjs";
+import { t as setupAddons } from "./addons-setup-uSvqHagW.mjs";
+import { c as applyDependencyVersionChannel, t as installDependencies, u as getAddonsToAdd } from "./install-dependencies-CDjTNvIV.mjs";
 import { intro, log, outro } from "@clack/prompts";
 import pc from "picocolors";
 import fs from "fs-extra";
@@ -106,17 +108,17 @@ async function addHandlerInternal(input) {
 	if (input.webDeploy !== void 0) configUpdates.webDeploy = input.webDeploy;
 	if (input.serverDeploy !== void 0) configUpdates.serverDeploy = input.serverDeploy;
 	await updateBtsConfig(projectDir, configUpdates);
-	if (input.install) await installDependencies({
+	let addonInstallFailed = false;
+	if (input.install) addonInstallFailed = !(await installDependencies({
 		projectDir,
 		packageManager: config.packageManager
-	});
+	})).success;
 	if (!isSilent()) {
 		log.success(pc.green(`Successfully added: ${addonsToAdd.join(", ")}`));
 		for (const warning of setupWarnings) log.warn(pc.yellow(warning));
-		if (!input.install) {
-			const installCmd = config.packageManager === "npm" ? "npm install" : `${config.packageManager} install`;
-			log.info(pc.yellow(`Run '${installCmd}' to install new dependencies.`));
-		}
+		const installCmd = config.packageManager === "npm" ? "npm install" : `${config.packageManager} install`;
+		if (!input.install) log.info(pc.yellow(`Run '${installCmd}' to install new dependencies.`));
+		else if (addonInstallFailed) log.warn(pc.yellow(`Dependency installation failed. Run '${installCmd}' after resolving the error above.`));
 		outro(pc.magenta("Addons added successfully!"));
 	}
 	return {

package/dist/addons-setup-CSmj5ClW.mjs

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+import "./bts-config-InNcw1aJ.mjs";
+import "./errors-ns_o2OKg.mjs";
+import { t as setupAddons } from "./addons-setup-uSvqHagW.mjs";
+
+export { setupAddons };

package/dist/{addons-setup-HSghQS7c.mjs → addons-setup-uSvqHagW.mjs}

@@ -1,92 +1,13 @@
 #!/usr/bin/env node
-import { n as readBtsConfig } from "./bts-config-Bg1Qea9Y.mjs";
-import { autocompleteMultiselect, cancel, group, isCancel, log, multiselect, select, spinner } from "@clack/prompts";
+import { r as readBtsConfig } from "./bts-config-InNcw1aJ.mjs";
+import { c as isSilent, r as exitCancelled } from "./errors-ns_o2OKg.mjs";
+import { autocompleteMultiselect, group, isCancel, log, multiselect, select, spinner } from "@clack/prompts";
 import pc from "picocolors";
 import fs from "fs-extra";
 import path from "node:path";
 import consola from "consola";
-import { AsyncLocalStorage } from "node:async_hooks";
 import { $ } from "execa";
 
-//#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
 //#region src/utils/prompt-environment.ts
 function hasOwnProperty(value, property) {
 	return Object.prototype.hasOwnProperty.call(value, property);
@@ -1412,4 +1333,4 @@ async function setupLefthook(projectDir) {
 }
 
 //#endregion
-export { CLIError as a, exitWithError as c, isFirstPrompt as d, isSilent as f, setLastPromptShownUI as h, canPromptInteractively as i, handleError as l, setIsFirstPrompt as m, getPackageExecutionArgs as n, UserCancelledError as o, runWithContextAsync as p, addPackageDependency as r, exitCancelled as s, setupAddons as t, didLastPromptShowUI as u };
+export { canPromptInteractively as i, getPackageExecutionArgs as n, addPackageDependency as r, setupAddons as t };

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

@@ -2,75 +2,10 @@
 import { t as __reExport } from "./chunk-CCII7kTE.mjs";
 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";
 
-//#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,6 +163,71 @@ 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";
@@ -446,6 +446,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,
@@ -708,6 +709,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 +756,4 @@ 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 };
+export { getPrimaryGraphPart as _, updateBtsConfig as a, DEFAULT_CONFIG as c, getUserPkgManager as d, getEffectiveStack as f, getGraphSummary as g, getGraphPart as h, readBtsConfigFromFile as i, DEFAULT_UI_LIBRARY_BY_FRONTEND as l, getGraphBackendUrl as m, previewBtsConfigUpdate as n, writeBtsConfig as o, getGraphBackendDeployInstructions as p, readBtsConfig as r, getLatestCLIVersion as s, buildBtsConfigForPersistence as t, getDefaultConfig as u, hasGraphPart as v, types_exports as y };

package/dist/cli.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 //#region src/cli.ts
-if (process.argv[2] === "mcp" && process.argv.length === 3) import("./mcp-58r70ZcL.mjs").then((m) => m.startMcpServer());
-else import("./run-QRBymn-p.mjs").then((m) => m.createBtsCli().run());
+if (process.argv[2] === "mcp" && process.argv.length === 3) import("./mcp-BaLHDRdC.mjs").then((m) => m.startMcpServer());
+else import("./run-DYWSKowD.mjs").then((m) => m.createBtsCli().run());
 
 //#endregion
 export {  };

package/dist/doctor-Bm9qvkya.mjs

@@ -0,0 +1,281 @@
+#!/usr/bin/env node
+import { r as readBtsConfig } from "./bts-config-InNcw1aJ.mjs";
+import { t as renderTitle } from "./render-title-zvyKC1ej.mjs";
+import { a as handleError } from "./errors-ns_o2OKg.mjs";
+import { t as runGeneratedChecks } from "./generated-checks-CUhFFfVo.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 };