create-better-fullstack 2.1.3 → 2.1.5

package/dist/index.mjs

@@ -1,12 +1,11 @@
 #!/usr/bin/env node
-import "./errors-D9yiiGVq.mjs";
-import { a as docs, c as sponsors, i as createBtsCli, l as telemetry, n as builder, o as history, r as create, s as router, t as add } from "./run-DRzP53v3.mjs";
+import "./errors-Cyol8zbN.mjs";
+import { a as createBtsCli, c as history, d as telemetry, i as create, l as router, n as builder, o as docs, r as check, s as doctor, t as add, u as sponsors } from "./run-BYse4yJy.mjs";
 import "./render-title-zvyKC1ej.mjs";
-import "./addons-setup-C_xrNtkL.mjs";
-import "./config-validation-C4glouQh.mjs";
-import "./compatibility-rules-D7zYNVjC.mjs";
-import "./install-dependencies-DDGF-zDG.mjs";
-import "./generated-checks-DUvVXWId.mjs";
+import "./addons-setup-CyrP1IV-.mjs";
+import "./file-formatter-B3dsev2l.mjs";
+import "./install-dependencies-CgNh-aOy.mjs";
+import "./generated-checks-C8hn9w2i.mjs";
 import { EMBEDDED_TEMPLATES, TEMPLATE_COUNT, VirtualFileSystem, generateVirtualProject } from "@better-fullstack/template-generator";
 
 //#region src/index.ts
@@ -199,4 +198,4 @@ async function createVirtual(options) {
 }
 
 //#endregion
-export { EMBEDDED_TEMPLATES, TEMPLATE_COUNT, VirtualFileSystem, add, builder, create, createBtsCli, createVirtual, docs, generateVirtualProject, history, router, sponsors, telemetry };
+export { EMBEDDED_TEMPLATES, TEMPLATE_COUNT, VirtualFileSystem, add, builder, check, create, createBtsCli, createVirtual, docs, doctor, generateVirtualProject, history, router, sponsors, telemetry };

package/dist/{install-dependencies-DDGF-zDG.mjs → install-dependencies-CgNh-aOy.mjs}

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { A as types_exports, d as setLastPromptShownUI, r as exitCancelled, s as isFirstPrompt, u as setIsFirstPrompt$1, y as DEFAULT_CONFIG } from "./errors-D9yiiGVq.mjs";
-import { m as validateAddonCompatibility, r as getCompatibleAddons } from "./compatibility-rules-D7zYNVjC.mjs";
+import { A as types_exports, d as setLastPromptShownUI, r as exitCancelled, s as isFirstPrompt, u as setIsFirstPrompt$1, y as DEFAULT_CONFIG } from "./errors-Cyol8zbN.mjs";
+import { g as validateAddonCompatibility, o as getCompatibleAddons } from "./file-formatter-B3dsev2l.mjs";
 import { log, spinner } from "@clack/prompts";
 import pc from "picocolors";
 import fs from "fs-extra";

package/dist/{mcp-BXLhb7wW.mjs → mcp-CsW3i66c.mjs}

@@ -1,7 +1,6 @@
 #!/usr/bin/env node
-import "./errors-D9yiiGVq.mjs";
-import "./config-validation-C4glouQh.mjs";
-import "./compatibility-rules-D7zYNVjC.mjs";
+import "./errors-Cyol8zbN.mjs";
+import "./file-formatter-B3dsev2l.mjs";
 import { i as startMcpServer, n as MCP_STACK_UPDATE_SCHEMA, r as getMcpGraphPreview, t as MCP_PLAN_CREATE_SCHEMA } from "./mcp-entry.mjs";
 
 export { startMcpServer };

package/dist/mcp-entry.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
-import { A as types_exports, C as getEffectiveStack, D as getGraphSummary, _ as writeBtsConfig, f as buildBtsConfigForPersistence, m as readBtsConfig, p as previewBtsConfigUpdate, v as getLatestCLIVersion, x as getDefaultConfig } from "./errors-D9yiiGVq.mjs";
-import { a as generateReproducibleCommand, i as getTemplateDescription, r as getTemplateConfig, s as CreateCommandOptionsSchema, t as validateConfigForProgrammaticUse } from "./config-validation-C4glouQh.mjs";
-import "./compatibility-rules-D7zYNVjC.mjs";
+import { A as types_exports, C as getEffectiveStack, D as getGraphSummary, _ as writeBtsConfig, f as buildBtsConfigForPersistence, m as readBtsConfig, p as previewBtsConfigUpdate, v as getLatestCLIVersion, x as getDefaultConfig } from "./errors-Cyol8zbN.mjs";
+import { r as validateConfigForProgrammaticUse, t as formatCode, v as CreateCommandOptionsSchema } from "./file-formatter-B3dsev2l.mjs";
+import { n as getTemplateDescription, r as generateReproducibleCommand, t as getTemplateConfig } from "./templates-CnTOtKjm.mjs";
 import z from "zod";
 import fs from "fs-extra";
 import path from "node:path";
@@ -153,6 +153,75 @@ function mergeStackPartSpecs(currentConfig, specs) {
 		stackParts
 	};
 }
+const GRAPH_CACHE_CONFIG_KEYS = new Set([
+	"stackParts",
+	"graphSummary",
+	"effectiveStack"
+]);
+function stableJson(value) {
+	return JSON.stringify(value);
+}
+function getChangedConfigKeys(currentConfig, proposedConfig) {
+	const keys = new Set([...Object.keys(currentConfig), ...Object.keys(proposedConfig)]);
+	const changed = /* @__PURE__ */ new Set();
+	for (const key of keys) {
+		if (GRAPH_CACHE_CONFIG_KEYS.has(key)) continue;
+		if (stableJson(currentConfig[key]) !== stableJson(proposedConfig[key])) changed.add(key);
+	}
+	return changed;
+}
+function getProjectedConfigKeys(part, parts) {
+	const owner = part.ownerPartId ? parts.find((candidate) => candidate.id === part.ownerPartId) : void 0;
+	const partProjection = (0, types_exports.stackPartsToLegacyProjectConfigPartial)(owner ? [owner, part] : [part]);
+	const keys = /* @__PURE__ */ new Set();
+	for (const key of Object.keys(partProjection)) {
+		if (GRAPH_CACHE_CONFIG_KEYS.has(key)) continue;
+		const value = partProjection[key];
+		if (value === part.toolId || Array.isArray(value) && value.includes(part.toolId)) keys.add(key);
+	}
+	return keys;
+}
+function getUpdatedSpecForChangedPart(part, parts, proposedConfig, changedKeys) {
+	const projectedKeys = getProjectedConfigKeys(part, parts);
+	for (const key of projectedKeys) {
+		if (!changedKeys.has(key)) continue;
+		const value = proposedConfig[key];
+		if (typeof value !== "string" || value === "none") continue;
+		return (0, types_exports.formatStackPartSpec)({
+			...part,
+			toolId: value
+		}, parts);
+	}
+}
+function mergeDerivedStackPartsWithExistingGraph(currentConfig, proposedConfig) {
+	const currentStackParts = currentConfig.stackParts?.length ? currentConfig.stackParts : (0, types_exports.legacyProjectConfigToStackParts)(currentConfig);
+	const derivedStackParts = (0, types_exports.legacyProjectConfigToStackParts)(proposedConfig);
+	if (currentStackParts.length === 0) return derivedStackParts;
+	const changedKeys = getChangedConfigKeys(currentConfig, proposedConfig);
+	const preservedParts = currentStackParts.filter((part) => {
+		if (part.source === "provided") return false;
+		if (part.toolId === "none") return false;
+		const projectedKeys = getProjectedConfigKeys(part, currentStackParts);
+		if (projectedKeys.size === 0) return true;
+		return [...projectedKeys].every((key) => !changedKeys.has(key));
+	});
+	const updatedSpecs = currentStackParts.filter((part) => part.source !== "provided" && part.toolId !== "none").flatMap((part) => {
+		const spec = getUpdatedSpecForChangedPart(part, currentStackParts, proposedConfig, changedKeys);
+		return spec ? [spec] : [];
+	});
+	const preservedSpecs = new Set(preservedParts.map((part) => (0, types_exports.formatStackPartSpec)(part, currentStackParts)));
+	const coveredParts = (0, types_exports.parseStackPartSpecs)([...new Set([...preservedSpecs, ...updatedSpecs])], "selected");
+	const preservedProjectedKeys = /* @__PURE__ */ new Set();
+	for (const part of coveredParts) for (const key of getProjectedConfigKeys(part, coveredParts)) preservedProjectedKeys.add(key);
+	const nextSpecs = [...new Set([...preservedSpecs, ...updatedSpecs])];
+	for (const part of derivedStackParts) {
+		if (part.source === "provided") continue;
+		const spec = (0, types_exports.formatStackPartSpec)(part, derivedStackParts);
+		if (nextSpecs.includes(spec)) continue;
+		if (![...getProjectedConfigKeys(part, derivedStackParts)].some((key) => preservedProjectedKeys.has(key))) nextSpecs.push(spec);
+	}
+	return (0, types_exports.parseStackPartSpecs)([...new Set(nextSpecs)], "selected");
+}
 function asString(value, fallback = "none") {
 	return typeof value === "string" ? value : fallback;
 }
@@ -543,6 +612,30 @@ async function generateTree(config) {
 	if (!result.success || !result.tree) throw new Error(result.error ?? "Failed to generate virtual project");
 	return result.tree;
 }
+async function formatGeneratedTree(tree) {
+	const denoConfigDirs = /* @__PURE__ */ new Set();
+	function collectDenoConfigDirs(nodes) {
+		for (const node of nodes) if (node.type === "file") {
+			if (node.name === "deno.json") denoConfigDirs.add(path.posix.dirname(node.path));
+		} else collectDenoConfigDirs(node.children);
+	}
+	function isUnderDenoConfig(filePath) {
+		return [...denoConfigDirs].some((dir) => dir === "." || filePath === dir || filePath.startsWith(`${dir}/`));
+	}
+	async function formatNodes(nodes) {
+		await Promise.all(nodes.map(async (node) => {
+			if (node.type === "file") {
+				if (node.content === BINARY_FILE_MARKER || isUnderDenoConfig(node.path)) return;
+				const formatted = await formatCode(node.path, node.content);
+				if (formatted) node.content = formatted;
+				return;
+			}
+			await formatNodes(node.children);
+		}));
+	}
+	collectDenoConfigDirs(tree.root.children);
+	await formatNodes(tree.root.children);
+}
 function treeToFileMap(tree) {
 	const files = /* @__PURE__ */ new Map();
 	function walk(nodes) {
@@ -552,6 +645,27 @@ function treeToFileMap(tree) {
 	walk(tree.root.children);
 	return files;
 }
+function treeToFileSnapshotMap(tree) {
+	const files = /* @__PURE__ */ new Map();
+	function walk(nodes) {
+		for (const node of nodes) if (node.type === "file") files.set(node.path, {
+			content: node.content,
+			sourcePath: node.sourcePath
+		});
+		else walk(node.children);
+	}
+	walk(tree.root.children);
+	return files;
+}
+function uniqueContents(contents) {
+	return [...new Set(contents.filter((content) => content !== void 0))];
+}
+function contentMatchesAny(content, candidates) {
+	return candidates.some((candidate) => candidate === content);
+}
+function contentSetsIntersect(left, right) {
+	return left.some((candidate) => right.includes(candidate));
+}
 function parseJson(content) {
 	if (!content) return null;
 	try {
@@ -668,11 +782,61 @@ function collectEnvReferences(content) {
 	]) for (const match of content.matchAll(pattern)) if (match[1]) keys.add(match[1]);
 	return keys;
 }
+function collectImplicitEnvKeys(config) {
+	const keys = /* @__PURE__ */ new Set();
+	if (config.email === "resend") {
+		keys.add("RESEND_API_KEY");
+		keys.add("RESEND_FROM_EMAIL");
+	}
+	if (config.observability === "sentry") keys.add("SENTRY_DSN");
+	return [...keys].sort();
+}
 function recordEnvReferenceChanges(envChanges, filePath, previousContent, proposedContent) {
 	const previous = collectEnvReferences(previousContent);
 	const added = [...collectEnvReferences(proposedContent)].filter((key) => !previous.has(key)).sort();
 	if (added.length > 0) envChanges[filePath] = [...new Set([...envChanges[filePath] ?? [], ...added])].sort();
 }
+function appendMissingEnvKeys(content, keys) {
+	const existingKeys = parseEnvKeys(content);
+	const missing = keys.filter((key) => !existingKeys.has(key));
+	if (missing.length === 0) return { keys: [] };
+	return {
+		content: `${content}${content.trim().length === 0 ? "" : content.endsWith("\n") ? "\n" : "\n\n"}${missing.map((key) => `${key}=`).join("\n")}\n`,
+		keys: missing
+	};
+}
+async function addMissingEnvExampleOperation(options) {
+	const requiredKeys = [...new Set([...Object.entries(options.envChanges).filter(([filePath]) => !isEnvFilePath(filePath)).flatMap(([, keys]) => keys), ...collectImplicitEnvKeys(options.proposedConfig)])].sort();
+	if (requiredKeys.length === 0) return;
+	const candidatePaths = new Set([
+		"apps/server/.env.example",
+		".env.example",
+		...[...options.proposedGeneratedFiles.keys()].filter(isEnvFilePath)
+	]);
+	let targetPath;
+	for (const candidate of candidatePaths) if (options.proposedGeneratedFiles.has(candidate) || await fs.pathExists(path.join(options.projectDir, candidate))) {
+		targetPath = candidate;
+		break;
+	}
+	if (!targetPath) return;
+	const existingOperation = options.operations.find((operation) => operation.path === targetPath && operation.writeMode === "content");
+	const targetFilePath = path.join(options.projectDir, targetPath);
+	const merged = appendMissingEnvKeys(existingOperation?.content ?? (await fs.pathExists(targetFilePath) ? await fs.readFile(targetFilePath, "utf-8") : ""), requiredKeys);
+	if (!merged.content) return;
+	if (existingOperation) {
+		existingOperation.content = merged.content;
+		existingOperation.summary = [...existingOperation.summary, `env refs: ${merged.keys.join(", ")}`];
+	} else options.operations.push({
+		kind: "merge",
+		path: targetPath,
+		writeMode: "content",
+		content: merged.content,
+		summary: [`env refs: ${merged.keys.join(", ")}`]
+	});
+	if (await fs.pathExists(targetFilePath)) options.filesToPatch.push(targetPath);
+	else options.filesToAdd.push(targetPath);
+	options.envChanges[targetPath] = [...new Set([...options.envChanges[targetPath] ?? [], ...merged.keys])].sort();
+}
 function getInstallCommand$1(config) {
 	switch (config.ecosystem) {
 		case "rust": return "cargo build";
@@ -687,7 +851,7 @@ function getGraphPreview(config) {
 	const stackParts = config.stackParts?.length ? config.stackParts : (0, types_exports.legacyProjectConfigToStackParts)(config);
 	const graphSummary = stackParts.length > 0 ? getGraphSummary({ stackParts }) : void 0;
 	const effectiveStack = stackParts.length > 0 ? getEffectiveStack({ stackParts }) : void 0;
-	const stackPartSpecs = stackParts.filter((part) => part.source !== "provided").map((part) => (0, types_exports.formatStackPartSpec)(part, stackParts));
+	const stackPartSpecs = stackParts.filter((part) => part.source !== "provided" && part.toolId !== "none").map((part) => (0, types_exports.formatStackPartSpec)(part, stackParts));
 	return {
 		...graphSummary ? {
 			graphSummary,
@@ -721,7 +885,7 @@ async function planStackUpdate(projectDirInput, input) {
 	};
 	const compatibilityAdjustments = [...dependencyExpansion.adjustments, ...compatibilityResult.changes.map((change) => `${change.category}: ${change.message}`)];
 	if (compatibilityResult.adjustedStack) proposedConfig = mergeProjectConfig(proposedConfig, compatibilityChangesToProjectConfig(compatibilityResult.adjustedStack, proposedConfig));
-	proposedConfig.stackParts = (0, types_exports.legacyProjectConfigToStackParts)(proposedConfig);
+	proposedConfig.stackParts = mergeDerivedStackPartsWithExistingGraph(currentConfig, proposedConfig);
 	Object.assign(proposedConfig, mergeStackPartSpecs(proposedConfig, stackPartSpecs));
 	try {
 		validateConfigForProgrammaticUse(proposedConfig);
@@ -748,6 +912,9 @@ async function planStackUpdate(projectDirInput, input) {
 			error: `Failed to generate stack update plan: ${error instanceof Error ? error.message : String(error)}`
 		};
 	}
+	const currentRawGeneratedFiles = treeToFileSnapshotMap(currentTree);
+	const proposedRawGeneratedFiles = treeToFileSnapshotMap(proposedTree);
+	await Promise.all([formatGeneratedTree(currentTree), formatGeneratedTree(proposedTree)]);
 	const currentGeneratedFiles = treeToFileMap(currentTree);
 	const proposedGeneratedFiles = treeToFileMap(proposedTree);
 	const operations = [];
@@ -770,8 +937,12 @@ async function planStackUpdate(projectDirInput, input) {
 	}));
 	for (const { filePath, proposedFile, exists, existingBuffer } of proposedFileEntries) {
 		const previousFile = currentGeneratedFiles.get(filePath);
+		const previousRawFile = currentRawGeneratedFiles.get(filePath);
+		const proposedRawFile = proposedRawGeneratedFiles.get(filePath);
 		const proposedContent = proposedFile.content;
 		const previousContent = previousFile?.content;
+		const currentBaselineContents = uniqueContents([previousRawFile?.content, previousContent]);
+		const proposedBaselineContents = uniqueContents([proposedRawFile?.content, proposedContent]);
 		const isBinaryFile = isGeneratedBinaryFile(proposedFile) || isGeneratedBinaryFile(previousFile);
 		const existingContent = exists && existingBuffer && !isBinaryFile ? existingBuffer.toString("utf-8") : void 0;
 		if (!exists) {
@@ -803,7 +974,7 @@ async function planStackUpdate(projectDirInput, input) {
 			manualReviewBlockers.push(`${filePath}: existing binary file differs from the generated baseline`);
 			continue;
 		}
-		if (existingContent === void 0 || existingContent === proposedContent) {
+		if (existingContent === void 0 || contentMatchesAny(existingContent, proposedBaselineContents)) {
 			filesUnchanged.push(filePath);
 			continue;
 		}
@@ -839,7 +1010,11 @@ async function planStackUpdate(projectDirInput, input) {
 			}
 			continue;
 		}
-		if (previousContent !== void 0 && existingContent === previousContent) {
+		if (existingContent !== void 0 && contentMatchesAny(existingContent, currentBaselineContents)) {
+			if (contentSetsIntersect(currentBaselineContents, proposedBaselineContents)) {
+				filesUnchanged.push(filePath);
+				continue;
+			}
 			filesToPatch.push(filePath);
 			operations.push({
 				kind: "replace",
@@ -852,6 +1027,15 @@ async function planStackUpdate(projectDirInput, input) {
 		if (isSkippableGeneratedDoc(filePath)) continue;
 		manualReviewBlockers.push(`${filePath}: existing file differs from the generated baseline`);
 	}
+	await addMissingEnvExampleOperation({
+		projectDir,
+		proposedGeneratedFiles,
+		operations,
+		filesToAdd,
+		filesToPatch,
+		envChanges,
+		proposedConfig: normalizedProposedConfig
+	});
 	const graphPreview = getGraphPreview(persistedProposedConfig);
 	return {
 		success: true,
@@ -882,6 +1066,7 @@ async function applyStackUpdate(projectDirInput, input) {
 	const projectName = await inferProjectName(plan.projectDir);
 	const proposedConfig = configFromBtsConfig(plan.proposedConfig, plan.projectDir, projectName);
 	const proposedTree = await generateTree(proposedConfig);
+	await formatGeneratedTree(proposedTree);
 	const generatedPaths = new Set(plan.operations.filter((operation) => operation.writeMode === "generated").map((operation) => operation.path));
 	if (generatedPaths.size > 0) await writeSelectedFiles(proposedTree, plan.projectDir, (filePath) => generatedPaths.has(filePath));
 	await Promise.all(plan.operations.filter((operation) => operation.writeMode === "content").map(async (operation) => {
@@ -1336,7 +1521,7 @@ function getMcpGraphPreview(config) {
 	const stackParts = config.stackParts?.length ? config.stackParts : legacyProjectConfigToStackParts(config);
 	const graphSummary = stackParts.length > 0 ? getGraphSummary({ stackParts }) : void 0;
 	const effectiveStack = stackParts.length > 0 ? getEffectiveStack({ stackParts }) : void 0;
-	const stackPartSpecs = stackParts.filter((part) => part.source !== "provided").map((part) => formatStackPartSpec(part, stackParts));
+	const stackPartSpecs = stackParts.filter((part) => part.source !== "provided" && part.toolId !== "none").map((part) => formatStackPartSpec(part, stackParts));
 	return {
 		...graphSummary ? {
 			graphSummary,
@@ -2208,7 +2393,7 @@ async function startMcpServer() {
 			const graphPreview = getMcpGraphPreview(config);
 			let addonWarnings = [];
 			if (config.addons.length > 0 && config.addons[0] !== "none") {
-				const { setupAddons } = await import("./addons-setup-C8eaCaH5.mjs");
+				const { setupAddons } = await import("./addons-setup-DyMm42a5.mjs");
 				addonWarnings = await setupAddons(config);
 			}
 			const installCmd = getInstallCommand(input.ecosystem ?? "typescript", projectName, input.packageManager, input.javaBuildTool, input.javaWebFramework);
@@ -2533,4 +2718,4 @@ async function startMcpServer() {
 startMcpServer();
 
 //#endregion
-export { startMcpServer as i, MCP_STACK_UPDATE_SCHEMA as n, getMcpGraphPreview as r, MCP_PLAN_CREATE_SCHEMA as t };
+export { applyStackUpdate as a, startMcpServer as i, MCP_STACK_UPDATE_SCHEMA as n, planStackUpdate as o, getMcpGraphPreview as r, MCP_PLAN_CREATE_SCHEMA as t };

package/dist/{run-DRzP53v3.mjs → run-BYse4yJy.mjs}

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
-import { A as types_exports, D as getGraphSummary, E as getGraphPart, S as getUserPkgManager, T as getGraphBackendUrl, _ as writeBtsConfig, a as handleError, b as DEFAULT_UI_LIBRARY_BY_FRONTEND, c as isSilent, d as setLastPromptShownUI, f as buildBtsConfigForPersistence, h as readBtsConfigFromFile, i as exitWithError, k as hasGraphPart, l as runWithContextAsync, n as UserCancelledError, o as didLastPromptShowUI, r as exitCancelled, s as isFirstPrompt, t as CLIError, u as setIsFirstPrompt, v as getLatestCLIVersion, w as getGraphBackendDeployInstructions, x as getDefaultConfig, y as DEFAULT_CONFIG } from "./errors-D9yiiGVq.mjs";
+import { A as types_exports, D as getGraphSummary, E as getGraphPart, S as getUserPkgManager, T as getGraphBackendUrl, _ as writeBtsConfig, a as handleError, b as DEFAULT_UI_LIBRARY_BY_FRONTEND, c as isSilent, d as setLastPromptShownUI, f as buildBtsConfigForPersistence, h as readBtsConfigFromFile, i as exitWithError, k as hasGraphPart, l as runWithContextAsync, n as UserCancelledError, o as didLastPromptShowUI, r as exitCancelled, s as isFirstPrompt, t as CLIError, u as setIsFirstPrompt, v as getLatestCLIVersion, w as getGraphBackendDeployInstructions, x as getDefaultConfig, y as DEFAULT_CONFIG } from "./errors-Cyol8zbN.mjs";
 import { t as renderTitle } from "./render-title-zvyKC1ej.mjs";
-import { i as canPromptInteractively, n as getPackageExecutionArgs, r as addPackageDependency, t as setupAddons } from "./addons-setup-C_xrNtkL.mjs";
-import { a as generateReproducibleCommand, i as getTemplateDescription, n as validateFullConfig, o as CreateCommandInputSchema, r as getTemplateConfig, t as validateConfigForProgrammaticUse } from "./config-validation-C4glouQh.mjs";
-import { a as getCompatibleUILibraries$1, c as isExampleChatSdkAllowed$1, d as requiresChatSdkVercelAI, f as splitFrontends$1, i as getCompatibleCSSFrameworks$1, l as isFrontendAllowedWithBackend$1, o as hasWebStyling$1, s as isExampleAIAllowed$1, t as allowedApisForFrontends$1, u as isWebFrontend$1 } from "./compatibility-rules-D7zYNVjC.mjs";
-import { _ as isGoBack, a as runMavenTests, c as applyDependencyVersionChannel, d as isCancel$1, f as navigableConfirm, g as GO_BACK_SYMBOL, h as setIsFirstPrompt$1, i as runGradleTests, l as getAddonsChoice, m as navigableSelect, n as runCargoBuild, o as runMixCompile, p as navigableMultiselect, r as runGoModTidy, s as runUvSync, t as installDependencies } from "./install-dependencies-DDGF-zDG.mjs";
-import { n as commandExists, t as runGeneratedChecks } from "./generated-checks-DUvVXWId.mjs";
+import { i as canPromptInteractively, n as getPackageExecutionArgs, r as addPackageDependency, t as setupAddons } from "./addons-setup-CyrP1IV-.mjs";
+import { _ as CreateCommandInputSchema, a as allowedApisForFrontends$1, c as getCompatibleUILibraries$1, d as isExampleChatSdkAllowed$1, f as isFrontendAllowedWithBackend$1, h as splitFrontends$1, i as validateFullConfig, l as hasWebStyling$1, m as requiresChatSdkVercelAI, n as formatProject, p as isWebFrontend$1, r as validateConfigForProgrammaticUse, s as getCompatibleCSSFrameworks$1, u as isExampleAIAllowed$1, v as CreateCommandOptionsSchema } from "./file-formatter-B3dsev2l.mjs";
+import { _ as isGoBack, a as runMavenTests, c as applyDependencyVersionChannel, d as isCancel$1, f as navigableConfirm, g as GO_BACK_SYMBOL, h as setIsFirstPrompt$1, i as runGradleTests, l as getAddonsChoice, m as navigableSelect, n as runCargoBuild, o as runMixCompile, p as navigableMultiselect, r as runGoModTidy, s as runUvSync, t as installDependencies } from "./install-dependencies-CgNh-aOy.mjs";
+import { n as commandExists, t as runGeneratedChecks } from "./generated-checks-C8hn9w2i.mjs";
+import { n as getTemplateDescription, r as generateReproducibleCommand, t as getTemplateConfig } from "./templates-CnTOtKjm.mjs";
 import { cancel, confirm, intro, isCancel, log, outro, select, spinner, text } from "@clack/prompts";
 import { createRouterClient, os } from "@orpc/server";
 import pc from "picocolors";
@@ -19,7 +19,6 @@ import consola, { consola as consola$1 } from "consola";
 import { $, execa } from "execa";
 import { cliInputToProjectConfigPartial } from "@better-fullstack/types/stack-translation";
 import os$1 from "node:os";
-import { format } from "oxfmt";
 
 //#region src/utils/project-history.ts
 const paths$1 = envPaths("better-fullstack", { suffix: "" });
@@ -5500,7 +5499,7 @@ async function gatherMultiEcosystemConfig(flags, projectName, projectDir, relati
 		if (pythonOrm !== "none") stackPartSpecs.push(`backend.orm:python:${pythonOrm}`);
 		if (pythonAuth !== "none") stackPartSpecs.push(`backend.auth:python:${pythonAuth}`);
 		if (pythonTaskQueue !== "none") stackPartSpecs.push(`backend.jobQueue:python:${pythonTaskQueue}`);
-		if (pythonGraphql !== "none") stackPartSpecs.push(`backend.api:python:${pythonGraphql}`);
+		if (pythonGraphql !== "none") stackPartSpecs.push(`backend.graphql:python:${pythonGraphql}`);
 		for (const testing of pythonTesting) if (testing !== "none") stackPartSpecs.push(`backend.testing:python:${testing}`);
 		if (pythonCaching !== "none") stackPartSpecs.push(`backend.caching:python:${pythonCaching}`);
 		if (pythonRealtime !== "none") stackPartSpecs.push(`backend.realtime:python:${pythonRealtime}`);
@@ -7278,7 +7277,10 @@ const COPYABLE_CREATE_INPUT_KEYS = Object.keys(types_exports.CreateInputSchema.s
 * result can be safely overlaid by explicitly-passed CLI flags.
 */
 function betterTStackConfigToCreateInput(config) {
-	const source = config;
+	const source = buildBtsConfigForPersistence(config, {
+		version: config.version,
+		createdAt: config.createdAt
+	});
 	const result = {};
 	for (const key of COPYABLE_CREATE_INPUT_KEYS) {
 		const value = source[key];
@@ -7341,7 +7343,7 @@ async function resolveCreateConfigBase(input) {
 //#endregion
 //#region src/utils/display-config.ts
 function getSelectedGraphPart(config, role, ownerPartId) {
-	return config.stackParts?.find((part) => part.role === role && part.ownerPartId === ownerPartId && part.source !== "provided");
+	return config.stackParts?.find((part) => part.role === role && part.ownerPartId === ownerPartId && part.source !== "provided" && part.toolId !== "none");
 }
 function getGraphDisplayValue(config, role) {
 	const primaryBackend = getSelectedGraphPart(config, "backend");
@@ -7473,7 +7475,7 @@ function displayConfig(config) {
 	if (config.webDeploy !== void 0) configDisplay.push(`${pc.blue("Web Deployment:")} ${String(config.webDeploy)}`);
 	if (config.serverDeploy !== void 0) configDisplay.push(`${pc.blue("Server Deployment:")} ${String(config.serverDeploy)}`);
 	if (config.stackParts?.length) {
-		const stackParts = config.stackParts.filter((part) => part.source !== "provided").map((part) => formatStackPartSpec(part, config.stackParts ?? []));
+		const stackParts = config.stackParts.filter((part) => part.source !== "provided" && part.toolId !== "none").map((part) => formatStackPartSpec(part, config.stackParts ?? []));
 		if (stackParts.length > 0) configDisplay.push(`${pc.blue("Stack Parts:")} ${stackParts.join(", ")}`);
 	}
 	if (configDisplay.length === 0) return pc.yellow("No configuration selected.");
@@ -7692,39 +7694,6 @@ function validateConfigCompatibility(config, providedFlags, options) {
 	else validateConfigForProgrammaticUse(config);
 }
 
-//#endregion
-//#region src/utils/file-formatter.ts
-const formatOptions = {
-	experimentalSortPackageJson: true,
-	experimentalSortImports: { order: "asc" }
-};
-async function formatCode(filePath, content) {
-	try {
-		const result = await format(path.basename(filePath), content, formatOptions);
-		if (result.errors && result.errors.length > 0) return null;
-		return result.code;
-	} catch {
-		return null;
-	}
-}
-async function formatProject(projectDir) {
-	async function formatDirectory(dir) {
-		const denoConfigPath = path.join(dir, "deno.json");
-		if (await fs.pathExists(denoConfigPath)) return;
-		const entries = await fs.readdir(dir, { withFileTypes: true });
-		await Promise.all(entries.map(async (entry) => {
-			const fullPath = path.join(dir, entry.name);
-			if (entry.isDirectory()) await formatDirectory(fullPath);
-			else if (entry.isFile()) try {
-				const content = await fs.readFile(fullPath, "utf-8");
-				const formatted = await formatCode(fullPath, content);
-				if (formatted && formatted !== content) await fs.writeFile(fullPath, formatted, "utf-8");
-			} catch {}
-		}));
-	}
-	await formatDirectory(projectDir);
-}
-
 //#endregion
 //#region src/utils/env-utils.ts
 async function addEnvVariablesToFile(envPath, variables) {
@@ -9169,7 +9138,10 @@ function getAuthSetupInstructions(auth, backend, frontend) {
 	const envPath = backend === "self" ? "apps/web/.env" : "apps/server/.env";
 	if (auth === "nextauth") return `${pc.bold("NextAuth.js Setup:")}\n${pc.cyan("•")} Generate a secret: ${pc.white("npx auth secret")}\n${pc.cyan("•")} Set ${pc.white("AUTH_SECRET")} in ${pc.white(envPath)}\n${pc.cyan("•")} Configure your OAuth providers (e.g. ${pc.white("AUTH_GITHUB_ID")}, ${pc.white("AUTH_GITHUB_SECRET")})\n${pc.cyan("•")} Docs: ${pc.underline("https://authjs.dev/getting-started")}`;
 	if (auth === "stack-auth") return `${pc.bold("Stack Auth Setup:")}\n${pc.cyan("•")} Create a project at ${pc.underline("https://app.stack-auth.com")}\n${pc.cyan("•")} Set ${pc.white("NEXT_PUBLIC_STACK_PROJECT_ID")}, ${pc.white("NEXT_PUBLIC_STACK_PUBLISHABLE_CLIENT_KEY")},\n   and ${pc.white("STACK_SECRET_SERVER_KEY")} in ${pc.white(envPath)}`;
-	if (auth === "supabase-auth") return `${pc.bold("Supabase Auth Setup:")}\n${pc.cyan("•")} Create a project at ${pc.underline("https://supabase.com/dashboard")}\n${pc.cyan("•")} Set ${pc.white("NEXT_PUBLIC_SUPABASE_URL")}, ${pc.white("NEXT_PUBLIC_SUPABASE_ANON_KEY")},\n   and ${pc.white("SUPABASE_SERVICE_ROLE_KEY")} in ${pc.white(envPath)}`;
+	if (auth === "supabase-auth") {
+		const supabasePublicPrefix = frontend.includes("tanstack-start") ? "VITE_" : "NEXT_PUBLIC_";
+		return `${pc.bold("Supabase Auth Setup:")}\n${pc.cyan("•")} Create a project at ${pc.underline("https://supabase.com/dashboard")}\n${pc.cyan("•")} Set ${pc.white(`${supabasePublicPrefix}SUPABASE_URL`)}, ${pc.white(`${supabasePublicPrefix}SUPABASE_ANON_KEY`)},\n   and ${pc.white("SUPABASE_SERVICE_ROLE_KEY")} in ${pc.white(envPath)}`;
+	}
 	if (auth === "auth0") return `${pc.bold("Auth0 Setup:")}\n${pc.cyan("•")} Create an application at ${pc.underline("https://manage.auth0.com")}\n${pc.cyan("•")} Set ${pc.white("AUTH0_SECRET")}, ${pc.white("AUTH0_CLIENT_ID")}, ${pc.white("AUTH0_CLIENT_SECRET")},\n   and ${pc.white("AUTH0_ISSUER_BASE_URL")} in ${pc.white(envPath)}\n${pc.cyan("•")} Docs: ${pc.underline("https://auth0.com/docs/quickstart")}`;
 	return "";
 }
@@ -10220,6 +10192,24 @@ function displaySponsorsBox(sponsors$1) {
 //#endregion
 //#region src/run.ts
 const OPTION_ENTRY_COUNT = Object.values(types_exports.OPTION_CATEGORY_METADATA).reduce((sum, metadata) => sum + metadata.options.length, 0);
+const AddCommandInputSchema = CreateCommandOptionsSchema.omit({
+	template: true,
+	fromHistory: true,
+	config: true,
+	yes: true,
+	yolo: true,
+	verbose: true,
+	verify: true,
+	git: true,
+	directoryConflict: true,
+	renderTitle: true,
+	disableAnalytics: true,
+	manualDb: true
+}).extend({ projectDir: z.string().optional().describe("Project directory (defaults to current)") });
+const ProjectCheckInputSchema = z.tuple([z.string().optional().describe("Project directory to diagnose (defaults to current directory)"), z.object({
+	skipChecks: z.boolean().optional().default(false).describe("Skip the ecosystem build/type checks (config + deps + env only)"),
+	json: z.boolean().optional().default(false).describe("Output the diagnosis as JSON")
+})]);
 const router = os.router({
 	create: os.meta({
 		description: `Scaffold a new Better Fullstack project from ${OPTION_ENTRY_COUNT} compatible stack options`,
@@ -10260,15 +10250,8 @@ const router = os.router({
 			log.message(`Please visit ${BUILDER_URL}`);
 		}
 	}),
-	add: os.meta({ description: "Add addons or deployment targets to an existing Better Fullstack project using its bts.jsonc config" }).input(z.object({
-		addons: z.array(types_exports.AddonsSchema).optional().describe("Addons to add"),
-		webDeploy: types_exports.WebDeploySchema.optional().describe("Web deployment option to set"),
-		serverDeploy: types_exports.ServerDeploySchema.optional().describe("Server deployment option to set"),
-		install: z.boolean().optional().default(false).describe("Install dependencies after adding"),
-		packageManager: types_exports.PackageManagerSchema.optional().describe("Package manager to use"),
-		projectDir: z.string().optional().describe("Project directory (defaults to current)")
-	})).handler(async ({ input }) => {
-		const { addHandler } = await import("./add-handler-9F-AsGM-.mjs");
+	add: os.meta({ description: "Add addons, deploy targets, or stack capabilities to an existing Better Fullstack project using its bts.jsonc config" }).input(AddCommandInputSchema).handler(async ({ input }) => {
+		const { addHandler } = await import("./add-handler-BNSL6HdM.mjs");
 		await addHandler(input);
 	}),
 	history: os.meta({ description: "Show history of scaffolded projects with reproducible commands" }).input(z.object({
@@ -10312,12 +10295,17 @@ const router = os.router({
 		log.message("MCP server is started via the 'mcp' subcommand intercepted in cli.ts.");
 		log.message("Run: create-better-fullstack mcp");
 	}),
-	doctor: os.meta({ description: "Diagnose a scaffolded Better Fullstack project: verify its bts.jsonc, installed dependencies, required env vars, and run ecosystem build/type checks" }).input(z.tuple([z.string().optional().describe("Project directory to diagnose (defaults to current directory)"), z.object({
-		skipChecks: z.boolean().optional().default(false).describe("Skip the ecosystem build/type checks (config + deps + env only)"),
-		json: z.boolean().optional().default(false).describe("Output the diagnosis as JSON")
-	})])).handler(async ({ input }) => {
+	doctor: os.meta({ description: "Diagnose a scaffolded Better Fullstack project: verify its bts.jsonc, installed dependencies, required env vars, and run ecosystem build/type checks" }).input(ProjectCheckInputSchema).handler(async ({ input }) => {
 		const [projectDir, options] = input;
-		const { doctorCommand } = await import("./doctor-BFSSbS-U.mjs");
+		const { doctorCommand } = await import("./doctor-DBoq7bZ9.mjs");
+		await doctorCommand({
+			projectDir,
+			...options
+		});
+	}),
+	check: os.meta({ description: "Check a scaffolded Better Fullstack project for config, dependency, env, and generated build/type drift" }).input(ProjectCheckInputSchema).handler(async ({ input }) => {
+		const [projectDir, options] = input;
+		const { doctorCommand } = await import("./doctor-DBoq7bZ9.mjs");
 		await doctorCommand({
 			projectDir,
 			...options
@@ -10387,7 +10375,7 @@ async function builder() {
 	return caller.builder();
 }
 async function add(input) {
-	const { addHandler } = await import("./add-handler-9F-AsGM-.mjs");
+	const { addHandler } = await import("./add-handler-BNSL6HdM.mjs");
 	return addHandler(input, { silent: true });
 }
 async function history(options) {
@@ -10400,6 +10388,18 @@ async function history(options) {
 async function telemetry(action = "status", options) {
 	return caller.telemetry([action, { json: options?.json ?? false }]);
 }
+async function doctor(projectDir, options) {
+	return caller.doctor([projectDir, {
+		skipChecks: options?.skipChecks ?? false,
+		json: options?.json ?? false
+	}]);
+}
+async function check(projectDir, options) {
+	return caller.check([projectDir, {
+		skipChecks: options?.skipChecks ?? false,
+		json: options?.json ?? false
+	}]);
+}
 
 //#endregion
-export { docs as a, sponsors as c, createBtsCli as i, telemetry as l, builder as n, history as o, create as r, router as s, add as t };
+export { createBtsCli as a, history as c, telemetry as d, create as i, router as l, builder as n, docs as o, check as r, doctor as s, add as t, sponsors as u };

package/dist/run-_cf_sFwM.mjs

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+import "./errors-Cyol8zbN.mjs";
+import { a as createBtsCli, c as history, d as telemetry, i as create, l as router, n as builder, o as docs, r as check, s as doctor, t as add, u as sponsors } from "./run-BYse4yJy.mjs";
+import "./render-title-zvyKC1ej.mjs";
+import "./addons-setup-CyrP1IV-.mjs";
+import "./file-formatter-B3dsev2l.mjs";
+import "./install-dependencies-CgNh-aOy.mjs";
+import "./generated-checks-C8hn9w2i.mjs";
+
+export { createBtsCli };