create-better-fullstack 2.0.2 → 2.1.0

package/dist/{run-DQlymC4z.mjs → run-Cqy-n1iT.mjs}

@@ -1,7 +1,11 @@
 #!/usr/bin/env node
-import { _ as getUserPkgManager, c as getGraphPart, d as hasGraphPart, f as types_exports, g as getDefaultConfig, h as DEFAULT_UI_LIBRARY_BY_FRONTEND, i as writeBtsConfig, l as getGraphSummary, m as DEFAULT_CONFIG, o as getGraphBackendDeployInstructions, p as getLatestCLIVersion, s as getGraphBackendUrl, u as getPrimaryGraphPart } from "./bts-config-Bg1Qea9Y.mjs";
-import { A as validateAddonsAgainstFrontends, B as validateWorkersCompatibility, C as isExampleAIAllowed$1, D as requiresChatSdkVercelAI, E as isWebFrontend$1, F as validateServerDeployRequiresBackend, H as incompatibilityError, I as validateUILibraryCSSFrameworkCompatibility, L as validateUILibraryFrontendCompatibility, M as validateExamplesCompatibility, N as validatePaymentsCompatibility, O as splitFrontends$1, P as validateSelfBackendCompatibility, R as validateWebDeployFrontendTemplates, S as hasWebStyling$1, T as isFrontendAllowedWithBackend$1, U as missingRequirementError, V as constraintError, W as renderTitle, _ as isGoBack, a as runMavenTests, b as getCompatibleCSSFrameworks$1, c as applyDependencyVersionChannel, d as isCancel$1, f as navigableConfirm, g as GO_BACK_SYMBOL, h as setIsFirstPrompt, i as runGradleTests, j as validateApiFrontendCompatibility, k as validateAIFrontendCompatibility, l as getAddonsChoice, m as navigableSelect, n as runCargoBuild, o as runMixCompile, p as navigableMultiselect, r as runGoModTidy, s as runUvSync, t as installDependencies, v as allowedApisForFrontends$1, w as isExampleChatSdkAllowed$1, x as getCompatibleUILibraries$1, y as ensureSingleWebAndNative, z as validateWebDeployRequiresWebFrontend } from "./install-dependencies-D6-GO3BZ.mjs";
-import { a as CLIError, c as exitWithError, d as isFirstPrompt, f as isSilent, h as setLastPromptShownUI, i as canPromptInteractively, l as handleError, m as setIsFirstPrompt$1, n as getPackageExecutionArgs, o as UserCancelledError, p as runWithContextAsync, r as addPackageDependency, s as exitCancelled, t as setupAddons, u as didLastPromptShowUI } from "./addons-setup-HSghQS7c.mjs";
+import { c as DEFAULT_CONFIG, d as getUserPkgManager, g as getGraphSummary, h as getGraphPart, i as readBtsConfigFromFile, l as DEFAULT_UI_LIBRARY_BY_FRONTEND, m as getGraphBackendUrl, o as writeBtsConfig, p as getGraphBackendDeployInstructions, s as getLatestCLIVersion, t as buildBtsConfigForPersistence, u as getDefaultConfig, v as hasGraphPart, y as types_exports } from "./bts-config-InNcw1aJ.mjs";
+import { t as renderTitle } from "./render-title-zvyKC1ej.mjs";
+import { a as handleError, c as isSilent, d as setLastPromptShownUI, i as exitWithError, l as runWithContextAsync, n as UserCancelledError, o as didLastPromptShowUI, r as exitCancelled, s as isFirstPrompt, t as CLIError, u as setIsFirstPrompt } from "./errors-ns_o2OKg.mjs";
+import { i as canPromptInteractively, n as getPackageExecutionArgs, r as addPackageDependency, t as setupAddons } from "./addons-setup-uSvqHagW.mjs";
+import { A as validateAddonsAgainstFrontends, B as validateWorkersCompatibility, C as isExampleAIAllowed$1, D as requiresChatSdkVercelAI, E as isWebFrontend$1, F as validateServerDeployRequiresBackend, H as incompatibilityError, I as validateUILibraryCSSFrameworkCompatibility, L as validateUILibraryFrontendCompatibility, M as validateExamplesCompatibility, N as validatePaymentsCompatibility, O as splitFrontends$1, P as validateSelfBackendCompatibility, R as validateWebDeployFrontendTemplates, S as hasWebStyling$1, T as isFrontendAllowedWithBackend$1, U as missingRequirementError, V as constraintError, _ as isGoBack, a as runMavenTests, b as getCompatibleCSSFrameworks$1, c as applyDependencyVersionChannel, d as isCancel$1, f as navigableConfirm, g as GO_BACK_SYMBOL, h as setIsFirstPrompt$1, i as runGradleTests, j as validateApiFrontendCompatibility, k as validateAIFrontendCompatibility, l as getAddonsChoice, m as navigableSelect, n as runCargoBuild, o as runMixCompile, p as navigableMultiselect, r as runGoModTidy, s as runUvSync, t as installDependencies, v as allowedApisForFrontends$1, w as isExampleChatSdkAllowed$1, x as getCompatibleUILibraries$1, y as ensureSingleWebAndNative, z as validateWebDeployRequiresWebFrontend } from "./install-dependencies-CDjTNvIV.mjs";
+import { n as commandExists, t as runGeneratedChecks } from "./generated-checks-CUhFFfVo.mjs";
+import { n as getTemplateDescription, r as generateReproducibleCommand, t as getTemplateConfig } from "./templates-B351F1yX.mjs";
 import { cancel, confirm, intro, isCancel, log, outro, select, spinner, text } from "@clack/prompts";
 import { createRouterClient, os } from "@orpc/server";
 import pc from "picocolors";
@@ -18,10 +22,10 @@ import os$1 from "node:os";
 import { format } from "oxfmt";
 
 //#region src/utils/project-history.ts
-const paths = envPaths("better-fullstack", { suffix: "" });
+const paths$1 = envPaths("better-fullstack", { suffix: "" });
 const HISTORY_FILE = "history.json";
 function getHistoryPath() {
-	return path.join(paths.data, HISTORY_FILE);
+	return path.join(paths$1.data, HISTORY_FILE);
 }
 function generateId() {
 	return `${Date.now()}-${Math.random().toString(36).slice(2, 9)}`;
@@ -44,11 +48,17 @@ async function readHistory() {
 	}
 }
 async function writeHistory(history$1) {
-	await fs.ensureDir(paths.data);
+	await fs.ensureDir(paths$1.data);
 	await fs.writeJson(getHistoryPath(), history$1, { spaces: 2 });
 }
 async function addToHistory(config, reproducibleCommand) {
 	const history$1 = await readHistory();
+	let configSnapshot;
+	try {
+		configSnapshot = buildBtsConfigForPersistence(config);
+	} catch {
+		configSnapshot = void 0;
+	}
 	const entry = {
 		id: generateId(),
 		projectName: config.projectName,
@@ -69,7 +79,8 @@ async function addToHistory(config, reproducibleCommand) {
 			packageManager: config.packageManager
 		},
 		cliVersion: getLatestCLIVersion(),
-		reproducibleCommand
+		reproducibleCommand,
+		...configSnapshot ? { config: configSnapshot } : {}
 	};
 	history$1.entries.unshift(entry);
 	if (history$1.entries.length > 100) history$1.entries = history$1.entries.slice(0, 100);
@@ -78,6 +89,17 @@ async function addToHistory(config, reproducibleCommand) {
 async function getHistory(limit = 10) {
 	return (await readHistory()).entries.slice(0, limit);
 }
+/**
+* Returns the entry at a 1-based position (1 = most recent), or null when the
+* position is out of range.
+*/
+async function getHistoryEntry(position) {
+	if (!Number.isInteger(position) || position < 1) return null;
+	return (await readHistory()).entries[position - 1] ?? null;
+}
+async function getHistoryCount() {
+	return (await readHistory()).entries.length;
+}
 async function clearHistory() {
 	const historyPath = getHistoryPath();
 	if (await fs.pathExists(historyPath)) await fs.remove(historyPath);
@@ -133,10 +155,195 @@ async function historyHandler(input) {
 	}
 }
 
+//#endregion
+//#region src/utils/telemetry-settings.ts
+const paths = envPaths("better-fullstack", { suffix: "" });
+const SETTINGS_FILE = "telemetry.json";
+function getSettingsPath() {
+	return path.join(paths.data, SETTINGS_FILE);
+}
+function emptySettings() {
+	return {
+		version: 1,
+		noticeShown: false
+	};
+}
+async function readTelemetrySettings() {
+	const settingsPath = getSettingsPath();
+	if (!await fs.pathExists(settingsPath)) return emptySettings();
+	try {
+		const data = await fs.readJson(settingsPath);
+		if (!data || typeof data !== "object") return emptySettings();
+		return {
+			version: typeof data.version === "number" ? data.version : 1,
+			enabled: typeof data.enabled === "boolean" ? data.enabled : void 0,
+			noticeShown: data.noticeShown === true
+		};
+	} catch {
+		return emptySettings();
+	}
+}
+async function writeTelemetrySettings(settings) {
+	await fs.ensureDir(paths.data);
+	await fs.writeJson(getSettingsPath(), settings, { spaces: 2 });
+}
+/**
+* The user's explicit persisted preference, or `undefined` when they never chose.
+*/
+async function getPersistedTelemetryPreference() {
+	return (await readTelemetrySettings()).enabled;
+}
+/**
+* Persist an explicit opt-in/opt-out. Choosing a preference also marks the
+* first-run notice as shown so it never appears afterwards.
+*/
+async function setTelemetryPreference(enabled) {
+	const settings = await readTelemetrySettings();
+	settings.enabled = enabled;
+	settings.noticeShown = true;
+	await writeTelemetrySettings(settings);
+}
+async function hasTelemetryNoticeBeenShown() {
+	return (await readTelemetrySettings()).noticeShown;
+}
+async function markTelemetryNoticeShown() {
+	const settings = await readTelemetrySettings();
+	settings.noticeShown = true;
+	await writeTelemetrySettings(settings);
+}
+
+//#endregion
+//#region src/utils/analytics.ts
+const CONVEX_INGEST_URL = "https://curious-elephant-653.convex.site/api/analytics/ingest";
+/**
+* Whether telemetry is explicitly overridden at runtime.
+*
+* Only `BTS_TELEMETRY_DISABLED` is a runtime override: `BTS_TELEMETRY` is inlined
+* by the bundler at build time (see tsdown.config.ts) and therefore acts as a
+* build-time default, not a runtime switch.
+*/
+function hasTelemetryEnvOverride() {
+	return process.env.BTS_TELEMETRY_DISABLED !== void 0;
+}
+/**
+* Resolve whether telemetry is enabled.
+*
+* Precedence: runtime env override (`BTS_TELEMETRY_DISABLED`) > persisted
+* preference > default. The default honors the build-time `BTS_TELEMETRY` flag
+* (inlined by the bundler, "0" by default) and falls back to enabled when the
+* flag is unset (e.g. running from source).
+*
+* `BTS_TELEMETRY` is intentionally evaluated last: the bundler replaces it with
+* a literal, so an early `!== undefined` check would always short-circuit and
+* make the persisted preference unreachable in the shipped CLI.
+*/
+async function isTelemetryEnabled() {
+	const disabled = process.env.BTS_TELEMETRY_DISABLED;
+	if (disabled !== void 0) return disabled !== "1";
+	const persisted = await getPersistedTelemetryPreference();
+	if (persisted !== void 0) return persisted;
+	const buildDefault = "1";
+	return buildDefault === void 0 ? true : buildDefault === "1";
+}
+/**
+* Print a one-time notice describing the anonymous telemetry the CLI collects
+* and how to opt out, then remember that it was shown so it never repeats.
+*
+* No-ops when telemetry is explicitly configured via env var, when a persisted
+* preference already exists, when the notice was already shown, when telemetry
+* is disabled by the build default, or when the CLI is not running interactively
+* (CI / silent / non-TTY).
+*/
+async function maybeShowTelemetryNotice() {
+	if (hasTelemetryEnvOverride()) return;
+	if (!canPromptInteractively()) return;
+	if (await getPersistedTelemetryPreference() !== void 0) return;
+	if (await hasTelemetryNoticeBeenShown()) return;
+	if (!await isTelemetryEnabled()) return;
+	log.info(`${pc.bold("Anonymous usage telemetry is enabled.")}\n${pc.dim("We collect your selected stack options (e.g. frontend, backend, database),")}\n${pc.dim("plus CLI version, Node.js version, and OS platform — never project names,")}\n${pc.dim("file paths, or any personal data.")}\nOpt out anytime with ${pc.cyan("create-better-fullstack telemetry disable")} or ${pc.cyan("BTS_TELEMETRY_DISABLED=1")}.`);
+	try {
+		await markTelemetryNoticeShown();
+	} catch {}
+}
+async function sendConvexEvent(payload) {
+	try {
+		await fetch(CONVEX_INGEST_URL, {
+			method: "POST",
+			headers: { "Content-Type": "application/json" },
+			body: JSON.stringify(payload)
+		});
+	} catch {}
+}
+async function trackProjectCreation(config, disableAnalytics = false) {
+	if (disableAnalytics || !await isTelemetryEnabled()) return;
+	const { projectName: _projectName, projectDir: _projectDir, relativePath: _relativePath, ...safeConfig } = config;
+	try {
+		await sendConvexEvent({
+			...safeConfig,
+			cli_version: getLatestCLIVersion(),
+			node_version: typeof process !== "undefined" ? process.version : "",
+			platform: typeof process !== "undefined" ? process.platform : ""
+		});
+	} catch {}
+}
+
+//#endregion
+//#region src/commands/telemetry.ts
+const COLLECTED = ["Selected stack options (frontend, backend, database, ORM, auth, API, etc.)", "CLI version, Node.js version, and OS platform"];
+const NOT_COLLECTED = ["Project names, directory paths, or file contents", "Personal or otherwise identifying information"];
+function resolveSource(persisted) {
+	if (hasTelemetryEnvOverride()) return "env";
+	if (persisted !== void 0) return "preference";
+	return "default";
+}
+function describeSource(source) {
+	switch (source) {
+		case "env": return "environment variable (BTS_TELEMETRY_DISABLED)";
+		case "preference": return "saved preference (create-better-fullstack telemetry enable/disable)";
+		default: return "default";
+	}
+}
+async function telemetryHandler(input) {
+	if (input.action === "enable") {
+		await setTelemetryPreference(true);
+		log.success(pc.green("Telemetry enabled. Thanks for helping improve Better Fullstack."));
+		return;
+	}
+	if (input.action === "disable") {
+		await setTelemetryPreference(false);
+		log.success(pc.green("Telemetry disabled. No anonymous usage data will be sent."));
+		return;
+	}
+	const enabled = await isTelemetryEnabled();
+	const persisted = await getPersistedTelemetryPreference();
+	const source = resolveSource(persisted);
+	if (input.json) {
+		console.log(JSON.stringify({
+			enabled,
+			source,
+			persisted: persisted ?? null,
+			envOverride: hasTelemetryEnvOverride()
+		}, null, 2));
+		return;
+	}
+	renderTitle();
+	intro(pc.magenta("Telemetry"));
+	log.message(`${pc.bold("Status:")} ${enabled ? pc.green("enabled") : pc.yellow("disabled")} ${pc.dim(`(${describeSource(source)})`)}`);
+	log.message("");
+	log.message(pc.bold("What is sent when enabled:"));
+	for (const item of COLLECTED) log.message(`  ${pc.green("+")} ${item}`);
+	log.message(pc.bold("What is never sent:"));
+	for (const item of NOT_COLLECTED) log.message(`  ${pc.red("-")} ${item}`);
+	log.message("");
+	log.message(pc.dim(`Change anytime: ${pc.cyan("create-better-fullstack telemetry enable")} / ${pc.cyan("create-better-fullstack telemetry disable")} (or set ${pc.cyan("BTS_TELEMETRY_DISABLED=1")}).`));
+}
+
 //#endregion
 //#region src/create-command-input.ts
 const CreateCommandOptionsSchema = z.object({
 	template: types_exports.TemplateSchema.optional().describe("Use a predefined template"),
+	fromHistory: z.number().optional().describe("Replay the stack of the Nth most-recent project from history (1 = most recent)"),
+	config: z.string().optional().describe("Path to a bts.jsonc/JSON config file to use as the base stack"),
 	yes: z.boolean().optional().default(false).describe("Use default configuration"),
 	yolo: z.boolean().optional().default(false).describe("(WARNING - NOT RECOMMENDED) Bypass validations and compatibility checks"),
 	part: z.array(z.string()).optional().describe("Stack graph part binding, e.g. frontend:typescript:next or backend.orm:go:gorm"),
@@ -168,6 +375,7 @@ const CreateCommandOptionsSchema = z.object({
 	rateLimit: types_exports.RateLimitSchema.optional().describe("Rate limiting solution"),
 	i18n: types_exports.I18nSchema.optional().describe("Internationalization (i18n) library"),
 	search: types_exports.SearchSchema.optional().describe("Search engine solution"),
+	vectorDb: types_exports.VectorDbSchema.optional().describe("Vector database for AI embeddings (pgvector, qdrant, chroma, pinecone)"),
 	fileStorage: types_exports.FileStorageSchema.optional().describe("File storage solution (S3, R2)"),
 	mobileNavigation: types_exports.MobileNavigationSchema.optional().describe("Mobile navigation (expo-router, react-navigation)"),
 	mobileUI: types_exports.MobileUISchema.optional().describe("Mobile UI (tamagui, gluestack-ui, uniwind, unistyles)"),
@@ -400,7 +608,7 @@ const AI_DOCS_OPTIONS = [
 	},
 	{
 		value: "agents-md",
-		label: "Agents.md",
+		label: "AGENTS.md",
 		hint: "Generic AI assistant documentation"
 	},
 	{
@@ -531,6 +739,16 @@ const API_PROMPT_OPTION_MAP = {
 		label: "GraphQL Yoga",
 		hint: "Batteries-included GraphQL server with Pothos schema builder"
 	},
+	"apollo-server": {
+		value: "apollo-server",
+		label: "Apollo Server",
+		hint: "Spec-compliant GraphQL server with a schema-first starter"
+	},
+	openapi: {
+		value: "openapi",
+		label: "OpenAPI",
+		hint: "REST scaffolding with an OpenAPI 3.1 spec and Scalar docs"
+	},
 	none: {
 		value: "none",
 		label: "None",
@@ -894,6 +1112,11 @@ const CMS_PROMPT_OPTIONS = [
 		label: "Directus",
 		hint: "Open data platform and headless CMS for SQL databases"
 	},
+	{
+		value: "keystatic",
+		label: "Keystatic",
+		hint: "Git-backed CMS for Markdown, JSON, and YAML content"
+	},
 	{
 		value: "none",
 		label: "None",
@@ -2356,7 +2579,7 @@ async function getFrontendChoice(frontendOptions, backend, auth) {
 		});
 		if (isGoBack(frontendTypes)) return GO_BACK_SYMBOL;
 		if (isCancel$1(frontendTypes)) return exitCancelled("Operation cancelled");
-		setIsFirstPrompt(false);
+		setIsFirstPrompt$1(false);
 		const result = [];
 		let shouldRestart = false;
 		if (frontendTypes.includes("web")) {
@@ -2372,7 +2595,7 @@ async function getFrontendChoice(frontendOptions, backend, auth) {
 			else result.push(webFramework);
 		}
 		if (shouldRestart) {
-			setIsFirstPrompt(wasFirstPrompt);
+			setIsFirstPrompt$1(wasFirstPrompt);
 			continue;
 		}
 		if (frontendTypes.includes("native")) {
@@ -2385,14 +2608,14 @@ async function getFrontendChoice(frontendOptions, backend, auth) {
 			});
 			if (isGoBack(nativeFramework)) if (frontendTypes.includes("web")) shouldRestart = true;
 			else {
-				setIsFirstPrompt(wasFirstPrompt);
+				setIsFirstPrompt$1(wasFirstPrompt);
 				continue;
 			}
 			else if (isCancel$1(nativeFramework)) return exitCancelled("Operation cancelled");
 			else result.push(nativeFramework);
 		}
 		if (shouldRestart) {
-			setIsFirstPrompt(wasFirstPrompt);
+			setIsFirstPrompt$1(wasFirstPrompt);
 			continue;
 		}
 		return result;
@@ -2827,17 +3050,36 @@ async function getGoObservabilityChoice(goObservability) {
 
 //#endregion
 //#region src/prompts/i18n.ts
+const PARAGLIDE_FRONTENDS = new Set([
+	"next",
+	"nuxt",
+	"vinext",
+	"tanstack-router",
+	"tanstack-start",
+	"react-router",
+	"react-vite",
+	"svelte",
+	"solid",
+	"solid-start",
+	"astro"
+]);
 async function getI18nChoice(i18n, frontend) {
 	if (i18n !== void 0) return i18n;
+	const hasNext = frontend?.includes("next") ?? false;
 	const response = await navigableSelect({
 		message: "Select internationalization (i18n) library",
 		options: [
+			...frontend?.some((f) => PARAGLIDE_FRONTENDS.has(f)) ?? false ? [{
+				value: "paraglide",
+				label: "Paraglide",
+				hint: "Type-safe, compiler-based i18n for modern web frontends"
+			}] : [],
 			{
 				value: "i18next",
 				label: "i18next",
 				hint: "Full-featured i18n framework, works with all frontends"
 			},
-			...frontend?.includes("next") ?? false ? [{
+			...hasNext ? [{
 				value: "next-intl",
 				label: "next-intl",
 				hint: "Lightweight i18n for Next.js with App Router support"
@@ -2854,17 +3096,6 @@ async function getI18nChoice(i18n, frontend) {
 	return response;
 }
 
-//#endregion
-//#region src/utils/command-exists.ts
-async function commandExists(command) {
-	try {
-		if (process.platform === "win32") return (await $({ reject: false })`where ${command}`).exitCode === 0;
-		return (await $({ reject: false })`which ${command}`).exitCode === 0;
-	} catch {
-		return false;
-	}
-}
-
 //#endregion
 //#region src/prompts/install.ts
 async function getinstallChoice(install, ecosystem, javaBuildTool) {
@@ -5613,7 +5844,7 @@ async function navigableGroup(prompts, opts) {
 	while (currentIndex < promptNames.length) {
 		const name = promptNames[currentIndex];
 		const prompt = prompts[name];
-		setIsFirstPrompt$1(currentIndex === 0);
+		setIsFirstPrompt(currentIndex === 0);
 		setLastPromptShownUI(false);
 		const result = await prompt({ results })?.catch((e) => {
 			throw e;
@@ -5634,7 +5865,7 @@ async function navigableGroup(prompts, opts) {
 				results[name] = "canceled";
 				opts.onCancel({ results });
 			}
-			setIsFirstPrompt$1(false);
+			setIsFirstPrompt(false);
 			return results;
 		}
 		if (goingBack && !didLastPromptShowUI()) {
@@ -5649,7 +5880,7 @@ async function navigableGroup(prompts, opts) {
 		results[name] = result;
 		currentIndex++;
 	}
-	setIsFirstPrompt$1(false);
+	setIsFirstPrompt(false);
 	return results;
 }
 
@@ -6090,6 +6321,11 @@ const SEARCH_PROMPT_OPTIONS = [
 		label: "Elasticsearch",
 		hint: "Distributed search and analytics engine with local and cloud deployments"
 	},
+	{
+		value: "opensearch",
+		label: "OpenSearch",
+		hint: "Open-source search and analytics suite compatible with Elasticsearch APIs"
+	},
 	{
 		value: "algolia",
 		label: "Algolia",
@@ -6144,6 +6380,77 @@ async function getSearchChoice(search, backend, ecosystem) {
 	return response;
 }
 
+//#endregion
+//#region src/prompts/vector-db.ts
+const VECTOR_DB_PROMPT_OPTIONS = [
+	{
+		value: "pgvector",
+		label: "pgvector",
+		hint: "Self-hosted Postgres + pgvector extension for embeddings"
+	},
+	{
+		value: "qdrant",
+		label: "Qdrant",
+		hint: "High-performance open-source vector database"
+	},
+	{
+		value: "chroma",
+		label: "Chroma",
+		hint: "Lightweight open-source embedding database"
+	},
+	{
+		value: "pinecone",
+		label: "Pinecone",
+		hint: "Fully managed serverless vector database"
+	},
+	{
+		value: "none",
+		label: "None",
+		hint: "Skip vector database setup"
+	}
+];
+/**
+* Vector DB is a TypeScript-ecosystem feature backed by a standalone server.
+* Every provider (including pgvector via a dedicated Postgres instance) is a
+* separate service, so there is no dependency on the primary database choice.
+*/
+function resolveVectorDbPrompt(context = {}) {
+	const skip = () => ({
+		shouldPrompt: false,
+		mode: "single",
+		options: [],
+		autoValue: "none"
+	});
+	if (context.ecosystem && context.ecosystem !== "typescript") return skip();
+	if (context.backend === "none" || context.backend === "convex") return skip();
+	return context.vectorDb !== void 0 ? {
+		shouldPrompt: false,
+		mode: "single",
+		options: VECTOR_DB_PROMPT_OPTIONS,
+		autoValue: context.vectorDb
+	} : {
+		shouldPrompt: true,
+		mode: "single",
+		options: VECTOR_DB_PROMPT_OPTIONS,
+		initialValue: "none"
+	};
+}
+async function getVectorDbChoice(vectorDb, backend, ecosystem) {
+	const resolution = resolveVectorDbPrompt({
+		vectorDb,
+		backend,
+		ecosystem
+	});
+	if (!resolution.shouldPrompt) return resolution.autoValue ?? "none";
+	const response = await navigableSelect({
+		message: "Select vector database",
+		options: resolution.options,
+		initialValue: resolution.initialValue
+	});
+	if (isCancel$1(response)) return exitCancelled("Operation cancelled");
+	return response;
+}
+
 //#endregion
 //#region src/prompts/server-deploy.ts
 async function getServerDeploymentChoice(deployment, runtime, backend, _webDeploy) {
@@ -6437,7 +6744,7 @@ async function gatherConfig(flags, projectName, projectDir, relativePath) {
 		},
 		addons: ({ results }) => {
 			if (results.ecosystem !== "typescript") {
-				const nonTypeScriptAddons = (flags.addons ?? []).filter((addon) => addon === "docker-compose");
+				const nonTypeScriptAddons = (flags.addons ?? []).filter((addon) => addon === "docker-compose" || addon === "devcontainer" || addon === "github-actions");
 				return Promise.resolve(nonTypeScriptAddons);
 			}
 			return getAddonsChoice(flags.addons, results.frontend, results.auth, results.backend, results.runtime);
@@ -6531,6 +6838,10 @@ async function gatherConfig(flags, projectName, projectDir, relativePath) {
 			if (results.ecosystem === "react-native" || results.ecosystem === "elixir") return Promise.resolve("none");
 			return getSearchChoice(flags.search, results.backend, results.ecosystem);
 		},
+		vectorDb: ({ results }) => {
+			if (results.ecosystem !== "typescript") return Promise.resolve("none");
+			return getVectorDbChoice(flags.vectorDb, results.backend, results.ecosystem);
+		},
 		fileStorage: ({ results }) => {
 			if (results.ecosystem !== "typescript") return Promise.resolve("none");
 			return getFileStorageChoice(flags.fileStorage, results.backend);
@@ -6938,6 +7249,7 @@ async function gatherConfig(flags, projectName, projectDir, relativePath) {
 		rateLimit: result.rateLimit,
 		i18n: result.i18n,
 		search: result.search,
+		vectorDb: result.vectorDb,
 		fileStorage: result.fileStorage,
 		mobileNavigation: result.mobileNavigation,
 		mobileUI: result.mobileUI,
@@ -7106,35 +7418,76 @@ async function getVersionChannelChoice(versionChannel) {
 }
 
 //#endregion
-//#region src/utils/analytics.ts
-const CONVEX_INGEST_URL = "https://curious-elephant-653.convex.site/api/analytics/ingest";
-function isTelemetryEnabled() {
-	const disabled = process.env.BTS_TELEMETRY_DISABLED;
-	if (disabled !== void 0) return disabled !== "1";
-	const enabled = "1";
-	if (enabled !== void 0) return enabled === "1";
-	return true;
+//#region src/utils/config-source.ts
+/**
+* CreateInput flag keys that can be sourced from a stored config. `projectName`
+* is excluded so a replayed config never reuses the original project name.
+*/
+const COPYABLE_CREATE_INPUT_KEYS = Object.keys(types_exports.CreateInputSchema.shape).filter((key) => key !== "projectName");
+/**
+* Projects a persisted Better-Fullstack config (bts.jsonc shape) onto the
+* subset of `create` flags it can drive. Only defined values are copied so the
+* result can be safely overlaid by explicitly-passed CLI flags.
+*/
+function betterTStackConfigToCreateInput(config) {
+	const source = config;
+	const result = {};
+	for (const key of COPYABLE_CREATE_INPUT_KEYS) {
+		const value = source[key];
+		if (value !== void 0 && value !== null) result[key] = value;
+	}
+	return result;
 }
-async function sendConvexEvent(payload) {
-	try {
-		await fetch(CONVEX_INGEST_URL, {
-			method: "POST",
-			headers: { "Content-Type": "application/json" },
-			body: JSON.stringify(payload)
-		});
-	} catch {}
+/**
+* Maps a legacy history entry (written before the full config snapshot existed)
+* onto `create` flags using the limited stack summary it stored.
+*/
+function historyStackToCreateInput(stack) {
+	return {
+		frontend: stack.frontend,
+		backend: stack.backend,
+		database: stack.database,
+		orm: stack.orm,
+		runtime: stack.runtime,
+		auth: stack.auth,
+		payments: stack.payments,
+		api: stack.api,
+		addons: stack.addons,
+		examples: stack.examples,
+		dbSetup: stack.dbSetup,
+		packageManager: stack.packageManager
+	};
 }
-async function trackProjectCreation(config, disableAnalytics = false) {
-	if (!isTelemetryEnabled() || disableAnalytics) return;
-	const { projectName: _projectName, projectDir: _projectDir, relativePath: _relativePath, ...safeConfig } = config;
-	try {
-		await sendConvexEvent({
-			...safeConfig,
-			cli_version: getLatestCLIVersion(),
-			node_version: typeof process !== "undefined" ? process.version : "",
-			platform: typeof process !== "undefined" ? process.platform : ""
-		});
-	} catch {}
+/**
+* Resolves the `--from-history` / `--config` flags into a base set of `create`
+* flags. Returns `undefined` when neither flag is used. The two flags are
+* mutually exclusive, and both are incompatible with `--yes`, `--template`, and
+* `--part` (each of those also wants to own the full stack). On any user error
+* this calls `exitWithError`, which exits the CLI (or throws a CLIError in
+* silent/programmatic mode).
+*/
+async function resolveCreateConfigBase(input) {
+	const hasHistory = input.fromHistory !== void 0;
+	const hasConfig = input.config !== void 0 && input.config !== "";
+	if (!hasHistory && !hasConfig) return;
+	if (hasHistory && hasConfig) exitWithError("Cannot combine --from-history with --config. Pass only one config source.");
+	const sourceFlag = hasHistory ? "--from-history" : "--config";
+	if (input.yes) exitWithError(`Cannot combine --yes with ${sourceFlag}: the config already provides a complete stack. Remove --yes.`);
+	if (input.template && input.template !== "none") exitWithError(`Cannot combine --template with ${sourceFlag}. Choose either a template or a saved config as the base.`);
+	if (input.part && input.part.length > 0) exitWithError(`Cannot combine --part with ${sourceFlag}. Use stack parts or a saved config as the base, not both.`);
+	if (hasConfig) {
+		const loaded = await readBtsConfigFromFile(input.config);
+		if (!loaded) exitWithError(`Could not load config file: ${input.config}. Ensure the path points to a valid bts.jsonc/JSON config.`);
+		return betterTStackConfigToCreateInput(loaded);
+	}
+	const position = input.fromHistory;
+	if (!Number.isInteger(position) || position < 1) exitWithError(`Invalid --from-history value: ${position}. Provide a positive integer (1 = most recent).`);
+	const entry = await getHistoryEntry(position);
+	if (!entry) {
+		const count = await getHistoryCount();
+		exitWithError(`No project history entry at position ${position}.${count === 0 ? " Project history is empty." : ` History has ${count} ${count === 1 ? "entry" : "entries"} (use 1-${count}).`}`);
+	}
+	return entry.config ? betterTStackConfigToCreateInput(entry.config) : historyStackToCreateInput(entry.stack);
 }
 
 //#endregion
@@ -7279,480 +7632,6 @@ function displayConfig(config) {
 	return configDisplay.join("\n");
 }
 
-//#endregion
-//#region src/utils/generate-reproducible-command.ts
-function getBaseCommand(packageManager) {
-	switch (packageManager) {
-		case "bun": return "bun create better-fullstack@latest";
-		case "pnpm": return "pnpm create better-fullstack@latest";
-		case "yarn": return "yarn create better-fullstack@latest";
-		case "npm":
-		default: return "npx create-better-fullstack@latest";
-	}
-}
-function formatArrayFlag(flag, values) {
-	const normalizedValues = values.filter((value) => value !== "none");
-	if (normalizedValues.length === 0) return `--${flag} none`;
-	return `--${flag} ${normalizedValues.join(" ")}`;
-}
-function appendCommonFlags(flags, config) {
-	if (config.aiDocs && config.aiDocs.length > 0) flags.push(formatArrayFlag("ai-docs", config.aiDocs));
-	else flags.push("--ai-docs none");
-	flags.push(config.git ? "--git" : "--no-git");
-	flags.push(`--package-manager ${config.packageManager}`);
-	if (config.versionChannel !== "stable") flags.push(`--version-channel ${config.versionChannel}`);
-	flags.push(config.install ? "--install" : "--no-install");
-}
-function hasGraphPrimaryPart(config, role, ecosystem) {
-	return config.stackParts?.some((part) => part.source !== "provided" && part.role === role && !part.ownerPartId && (!ecosystem || part.ecosystem === ecosystem));
-}
-function hasOwnedGraphPart(config, ownerRole, role, ecosystem, toolId) {
-	const owner = config.stackParts?.find((part) => part.source !== "provided" && part.role === ownerRole && !part.ownerPartId && (!ecosystem || part.ecosystem === ecosystem));
-	if (!owner) return false;
-	return Boolean(config.stackParts?.some((part) => part.source !== "provided" && part.role === role && part.ownerPartId === owner.id && (!ecosystem || part.ecosystem === ecosystem) && (!toolId || part.toolId === toolId)));
-}
-function hasGraphAddonPart(config, addon) {
-	const binding = (0, types_exports.getAddonStackPartBinding)(addon);
-	if (!binding) return false;
-	if (!binding.ownerRole) return Boolean(config.stackParts?.some((part) => part.source !== "provided" && part.role === binding.role && part.ecosystem === binding.ecosystem && part.toolId === addon && !part.ownerPartId));
-	const owner = config.stackParts?.find((part) => part.source !== "provided" && part.role === binding.ownerRole && !part.ownerPartId && part.ecosystem === binding.ecosystem);
-	if (!owner) return false;
-	return Boolean(config.stackParts?.some((part) => part.source !== "provided" && part.role === binding.role && part.ecosystem === binding.ecosystem && part.toolId === addon && part.ownerPartId === owner.id));
-}
-function hasGraphExamplePart(config, example) {
-	return Boolean(config.stackParts?.some((part) => part.source !== "provided" && part.role === "examples" && part.ecosystem === "universal" && part.toolId === example && !part.ownerPartId));
-}
-function hasGraphArrayParts(config, values, hasPart) {
-	const normalizedValues = values.filter((value) => value !== "none");
-	return normalizedValues.length > 0 && normalizedValues.every((value) => hasPart(config, value));
-}
-function appendChangedStringFlag(flags, flag, value, defaultValue) {
-	if (value !== defaultValue) flags.push(`--${flag} ${value}`);
-}
-function appendChangedGraphStringFlag(flags, config, role, ecosystem, flag, value, defaultValue) {
-	if (hasGraphPart(config, role, ecosystem)) return;
-	appendChangedStringFlag(flags, flag, value, defaultValue);
-}
-function appendChangedOwnedGraphStringFlag(flags, config, ownerRole, role, ecosystem, flag, value, defaultValue) {
-	if (hasOwnedGraphPart(config, ownerRole, role, ecosystem, value)) return;
-	appendChangedStringFlag(flags, flag, value, defaultValue);
-}
-function hasOwnedGraphArrayParts(config, ownerRole, role, ecosystem, values) {
-	const normalizedValues = values.filter((value) => value !== "none");
-	if (normalizedValues.length === 0) return false;
-	return normalizedValues.every((value) => hasOwnedGraphPart(config, ownerRole, role, ecosystem, value));
-}
-function appendChangedOwnedGraphArrayFlag(flags, config, ownerRole, role, ecosystem, flag, values, defaultValues) {
-	if (hasOwnedGraphArrayParts(config, ownerRole, role, ecosystem, values)) return;
-	appendChangedArrayFlag(flags, flag, values, defaultValues);
-}
-function appendChangedArrayFlag(flags, flag, values, defaultValues) {
-	if (values.length !== defaultValues.length || values.some((value, index) => value !== defaultValues[index])) flags.push(formatArrayFlag(flag, values));
-}
-function appendAstroIntegrationFlag(flags, config) {
-	if (config.frontend.includes("astro") && config.astroIntegration !== "none") flags.push(`--astro-integration ${config.astroIntegration}`);
-}
-function appendGraphExtraFlags(flags, config) {
-	if (!hasGraphArrayParts(config, config.addons, hasGraphAddonPart)) appendChangedArrayFlag(flags, "addons", config.addons, ["turborepo"]);
-	if (!hasGraphArrayParts(config, config.examples, hasGraphExamplePart)) appendChangedArrayFlag(flags, "examples", config.examples, []);
-	if (hasGraphPrimaryPart(config, "database")) appendChangedOwnedGraphStringFlag(flags, config, "database", "dbSetup", "universal", "db-setup", config.dbSetup, "none");
-	else appendChangedStringFlag(flags, "db-setup", config.dbSetup, "none");
-	if (hasGraphPrimaryPart(config, "frontend", "typescript")) {
-		appendAstroIntegrationFlag(flags, config);
-		appendChangedOwnedGraphStringFlag(flags, config, "frontend", "deploy", "typescript", "web-deploy", config.webDeploy, "none");
-		appendChangedGraphStringFlag(flags, config, "css", "typescript", "css-framework", config.cssFramework, "tailwind");
-		appendChangedGraphStringFlag(flags, config, "ui", "typescript", "ui-library", config.uiLibrary, "shadcn-ui");
-		if (config.uiLibrary === "shadcn-ui") {
-			appendChangedStringFlag(flags, "shadcn-base", config.shadcnBase ?? "radix", "radix");
-			appendChangedStringFlag(flags, "shadcn-style", config.shadcnStyle ?? "nova", "nova");
-			appendChangedStringFlag(flags, "shadcn-icon-library", config.shadcnIconLibrary ?? "lucide", "lucide");
-			appendChangedStringFlag(flags, "shadcn-color-theme", config.shadcnColorTheme ?? "neutral", "neutral");
-			appendChangedStringFlag(flags, "shadcn-base-color", config.shadcnBaseColor ?? "neutral", "neutral");
-			appendChangedStringFlag(flags, "shadcn-font", config.shadcnFont ?? "inter", "inter");
-			appendChangedStringFlag(flags, "shadcn-radius", config.shadcnRadius ?? "default", "default");
-		}
-		appendChangedGraphStringFlag(flags, config, "stateManagement", "typescript", "state-management", config.stateManagement, "none");
-		appendChangedGraphStringFlag(flags, config, "forms", "typescript", "forms", config.forms, "react-hook-form");
-		appendChangedStringFlag(flags, "validation", config.validation, "zod");
-		appendChangedStringFlag(flags, "testing", config.testing, "vitest");
-		appendChangedGraphStringFlag(flags, config, "animation", "typescript", "animation", config.animation, "none");
-		appendChangedGraphStringFlag(flags, config, "fileUpload", "typescript", "file-upload", config.fileUpload, "none");
-		appendChangedGraphStringFlag(flags, config, "i18n", "typescript", "i18n", config.i18n, "none");
-		appendChangedGraphStringFlag(flags, config, "analytics", "typescript", "analytics", config.analytics, "none");
-	}
-	if (hasGraphPrimaryPart(config, "frontend", "typescript") || hasGraphPrimaryPart(config, "backend", "typescript")) {
-		if (hasGraphPrimaryPart(config, "backend", "typescript")) {
-			appendChangedOwnedGraphStringFlag(flags, config, "backend", "runtime", "typescript", "runtime", config.runtime, "bun");
-			appendChangedOwnedGraphStringFlag(flags, config, "backend", "deploy", "typescript", "server-deploy", config.serverDeploy, "none");
-		} else appendChangedStringFlag(flags, "server-deploy", config.serverDeploy, "none");
-		appendChangedGraphStringFlag(flags, config, "payments", "typescript", "payments", config.payments, "none");
-		appendChangedGraphStringFlag(flags, config, "email", "typescript", "email", config.email, "none");
-		appendChangedStringFlag(flags, "effect", config.effect, "none");
-		appendChangedGraphStringFlag(flags, config, "ai", "typescript", "ai", config.ai, "none");
-		appendChangedGraphStringFlag(flags, config, "realtime", "typescript", "realtime", config.realtime, "none");
-		appendChangedGraphStringFlag(flags, config, "jobQueue", "typescript", "job-queue", config.jobQueue, "none");
-		appendChangedGraphStringFlag(flags, config, "logging", "typescript", "logging", config.logging, "none");
-		appendChangedGraphStringFlag(flags, config, "observability", "typescript", "observability", config.observability, "none");
-		appendChangedGraphStringFlag(flags, config, "featureFlags", "typescript", "feature-flags", config.featureFlags, "none");
-		appendChangedGraphStringFlag(flags, config, "caching", "typescript", "caching", config.caching, "none");
-		appendChangedGraphStringFlag(flags, config, "rateLimit", "typescript", "rate-limit", config.rateLimit, "none");
-		appendChangedGraphStringFlag(flags, config, "cms", "typescript", "cms", config.cms, "none");
-		appendChangedGraphStringFlag(flags, config, "search", "typescript", "search", config.search, "none");
-		appendChangedGraphStringFlag(flags, config, "fileStorage", "typescript", "file-storage", config.fileStorage, "none");
-	}
-	if (hasGraphPrimaryPart(config, "mobile")) {
-		appendChangedOwnedGraphStringFlag(flags, config, "mobile", "navigation", "react-native", "mobile-navigation", config.mobileNavigation, "expo-router");
-		appendChangedOwnedGraphStringFlag(flags, config, "mobile", "ui", "react-native", "mobile-ui", config.mobileUI, "none");
-		appendChangedOwnedGraphStringFlag(flags, config, "mobile", "storage", "react-native", "mobile-storage", config.mobileStorage, "none");
-		appendChangedOwnedGraphStringFlag(flags, config, "mobile", "testing", "react-native", "mobile-testing", config.mobileTesting, "none");
-		appendChangedStringFlag(flags, "mobile-push", config.mobilePush, "none");
-		appendChangedStringFlag(flags, "mobile-ota", config.mobileOTA, "none");
-		appendChangedStringFlag(flags, "mobile-deep-linking", config.mobileDeepLinking, "none");
-	}
-	if (hasGraphPrimaryPart(config, "frontend", "rust")) appendChangedStringFlag(flags, "rust-frontend", config.rustFrontend, "none");
-	if (hasGraphPrimaryPart(config, "backend", "rust")) {
-		appendChangedOwnedGraphStringFlag(flags, config, "backend", "cli", "rust", "rust-cli", config.rustCli, "none");
-		appendChangedOwnedGraphArrayFlag(flags, config, "backend", "libraries", "rust", "rust-libraries", config.rustLibraries, []);
-		appendChangedOwnedGraphStringFlag(flags, config, "backend", "logging", "rust", "rust-logging", config.rustLogging, "tracing");
-		appendChangedOwnedGraphStringFlag(flags, config, "backend", "errorHandling", "rust", "rust-error-handling", config.rustErrorHandling, "anyhow-thiserror");
-		appendChangedOwnedGraphStringFlag(flags, config, "backend", "caching", "rust", "rust-caching", config.rustCaching, "none");
-	}
-	if (hasGraphPrimaryPart(config, "backend", "python")) {
-		appendChangedOwnedGraphStringFlag(flags, config, "backend", "validation", "python", "python-validation", config.pythonValidation, "none");
-		appendChangedOwnedGraphArrayFlag(flags, config, "backend", "ai", "python", "python-ai", config.pythonAi, []);
-		appendChangedOwnedGraphStringFlag(flags, config, "backend", "jobQueue", "python", "python-task-queue", config.pythonTaskQueue, "none");
-		appendChangedOwnedGraphStringFlag(flags, config, "backend", "api", "python", "python-graphql", config.pythonGraphql, "none");
-		appendChangedOwnedGraphStringFlag(flags, config, "backend", "codeQuality", "python", "python-quality", config.pythonQuality, "none");
-	}
-	if (hasGraphPrimaryPart(config, "backend", "go")) {
-		appendChangedOwnedGraphStringFlag(flags, config, "backend", "cli", "go", "go-cli", config.goCli, "none");
-		appendChangedOwnedGraphStringFlag(flags, config, "backend", "logging", "go", "go-logging", config.goLogging, "none");
-	}
-	if (hasGraphPrimaryPart(config, "backend", "java")) {
-		appendChangedOwnedGraphStringFlag(flags, config, "backend", "buildTool", "java", "java-build-tool", config.javaBuildTool, "maven");
-		appendChangedOwnedGraphArrayFlag(flags, config, "backend", "libraries", "java", "java-libraries", config.javaLibraries, []);
-		appendChangedOwnedGraphArrayFlag(flags, config, "backend", "testing", "java", "java-testing-libraries", config.javaTestingLibraries, ["junit5"]);
-	}
-	if (hasGraphPrimaryPart(config, "backend", "elixir")) {
-		appendChangedGraphStringFlag(flags, config, "realtime", "elixir", "elixir-realtime", config.elixirRealtime, "channels");
-		appendChangedGraphStringFlag(flags, config, "jobQueue", "elixir", "elixir-jobs", config.elixirJobs, "none");
-		appendChangedGraphStringFlag(flags, config, "validation", "elixir", "elixir-validation", config.elixirValidation, "ecto-changesets");
-		appendChangedOwnedGraphStringFlag(flags, config, "backend", "httpClient", "elixir", "elixir-http", config.elixirHttp, "req");
-		appendChangedStringFlag(flags, "elixir-json", config.elixirJson, "jason");
-		appendChangedGraphStringFlag(flags, config, "email", "elixir", "elixir-email", config.elixirEmail, "none");
-		appendChangedGraphStringFlag(flags, config, "caching", "elixir", "elixir-caching", config.elixirCaching, "none");
-		appendChangedGraphStringFlag(flags, config, "observability", "elixir", "elixir-observability", config.elixirObservability, "telemetry");
-		appendChangedGraphStringFlag(flags, config, "testing", "elixir", "elixir-testing", config.elixirTesting, "ex_unit");
-		appendChangedOwnedGraphStringFlag(flags, config, "backend", "codeQuality", "elixir", "elixir-quality", config.elixirQuality, "credo");
-		appendChangedGraphStringFlag(flags, config, "deploy", "elixir", "elixir-deploy", config.elixirDeploy, "none");
-	}
-}
-function appendSharedNonTypeScriptFlags(flags, config) {
-	flags.push(`--email ${config.email}`);
-	flags.push(`--observability ${config.observability}`);
-	flags.push(`--caching ${config.caching}`);
-	flags.push(`--search ${config.search}`);
-	flags.push(formatArrayFlag("addons", config.addons));
-	flags.push(formatArrayFlag("examples", config.examples));
-	flags.push(`--db-setup ${config.dbSetup}`);
-	flags.push(`--web-deploy ${config.webDeploy}`);
-	flags.push(`--server-deploy ${config.serverDeploy}`);
-}
-function getTypeScriptFlags(config) {
-	const flags = [];
-	if (config.frontend && config.frontend.length > 0) flags.push(`--frontend ${config.frontend.join(" ")}`);
-	else flags.push("--frontend none");
-	appendAstroIntegrationFlag(flags, config);
-	flags.push(`--backend ${config.backend}`);
-	flags.push(`--runtime ${config.runtime}`);
-	flags.push(`--database ${config.database}`);
-	flags.push(`--orm ${config.orm}`);
-	flags.push(`--api ${config.api}`);
-	flags.push(`--auth ${config.auth}`);
-	flags.push(`--payments ${config.payments}`);
-	flags.push(`--email ${config.email}`);
-	flags.push(`--file-upload ${config.fileUpload}`);
-	flags.push(`--effect ${config.effect}`);
-	flags.push(`--css-framework ${config.cssFramework}`);
-	flags.push(`--ui-library ${config.uiLibrary}`);
-	if (config.uiLibrary === "shadcn-ui") {
-		flags.push(`--shadcn-base ${config.shadcnBase}`);
-		flags.push(`--shadcn-style ${config.shadcnStyle}`);
-		flags.push(`--shadcn-icon-library ${config.shadcnIconLibrary}`);
-		flags.push(`--shadcn-color-theme ${config.shadcnColorTheme}`);
-		flags.push(`--shadcn-base-color ${config.shadcnBaseColor}`);
-		flags.push(`--shadcn-font ${config.shadcnFont}`);
-		flags.push(`--shadcn-radius ${config.shadcnRadius}`);
-	}
-	flags.push(`--ai ${config.ai}`);
-	flags.push(`--state-management ${config.stateManagement}`);
-	flags.push(`--forms ${config.forms}`);
-	flags.push(`--validation ${config.validation}`);
-	flags.push(`--testing ${config.testing}`);
-	flags.push(`--animation ${config.animation}`);
-	flags.push(`--realtime ${config.realtime}`);
-	flags.push(`--job-queue ${config.jobQueue}`);
-	flags.push(`--logging ${config.logging}`);
-	flags.push(`--observability ${config.observability}`);
-	flags.push(`--feature-flags ${config.featureFlags}`);
-	flags.push(`--caching ${config.caching}`);
-	flags.push(`--rate-limit ${config.rateLimit}`);
-	flags.push(`--i18n ${config.i18n}`);
-	flags.push(`--cms ${config.cms}`);
-	flags.push(`--search ${config.search}`);
-	flags.push(`--file-storage ${config.fileStorage}`);
-	flags.push(`--mobile-navigation ${config.mobileNavigation}`);
-	flags.push(`--mobile-ui ${config.mobileUI}`);
-	flags.push(`--mobile-storage ${config.mobileStorage}`);
-	flags.push(`--mobile-testing ${config.mobileTesting}`);
-	flags.push(`--mobile-push ${config.mobilePush}`);
-	flags.push(`--mobile-ota ${config.mobileOTA}`);
-	flags.push(`--mobile-deep-linking ${config.mobileDeepLinking}`);
-	if (config.addons && config.addons.length > 0) flags.push(`--addons ${config.addons.join(" ")}`);
-	else flags.push("--addons none");
-	if (config.examples && config.examples.length > 0) flags.push(`--examples ${config.examples.join(" ")}`);
-	else flags.push("--examples none");
-	flags.push(`--db-setup ${config.dbSetup}`);
-	flags.push(`--web-deploy ${config.webDeploy}`);
-	flags.push(`--server-deploy ${config.serverDeploy}`);
-	appendCommonFlags(flags, config);
-	return flags;
-}
-function getReactNativeFlags(config) {
-	const flags = ["--ecosystem react-native"];
-	if (config.frontend && config.frontend.length > 0) flags.push(`--frontend ${config.frontend.join(" ")}`);
-	else flags.push("--frontend native-bare");
-	flags.push(`--auth ${config.auth}`);
-	flags.push(`--mobile-navigation ${config.mobileNavigation}`);
-	flags.push(`--mobile-ui ${config.mobileUI}`);
-	flags.push(`--mobile-storage ${config.mobileStorage}`);
-	flags.push(`--mobile-testing ${config.mobileTesting}`);
-	flags.push(`--mobile-push ${config.mobilePush}`);
-	flags.push(`--mobile-ota ${config.mobileOTA}`);
-	flags.push(`--mobile-deep-linking ${config.mobileDeepLinking}`);
-	appendCommonFlags(flags, config);
-	return flags;
-}
-function getRustFlags(config) {
-	const flags = ["--ecosystem rust"];
-	flags.push(`--rust-web-framework ${config.rustWebFramework}`);
-	flags.push(`--rust-frontend ${config.rustFrontend}`);
-	flags.push(`--rust-orm ${config.rustOrm}`);
-	flags.push(`--rust-api ${config.rustApi}`);
-	flags.push(`--rust-cli ${config.rustCli}`);
-	flags.push(formatArrayFlag("rust-libraries", config.rustLibraries));
-	flags.push(`--rust-logging ${config.rustLogging}`);
-	flags.push(`--rust-error-handling ${config.rustErrorHandling}`);
-	flags.push(`--rust-caching ${config.rustCaching}`);
-	flags.push(`--rust-auth ${config.rustAuth}`);
-	flags.push(`--rust-realtime ${config.rustRealtime}`);
-	flags.push(`--rust-message-queue ${config.rustMessageQueue}`);
-	flags.push(`--rust-observability ${config.rustObservability}`);
-	flags.push(`--rust-templating ${config.rustTemplating}`);
-	appendSharedNonTypeScriptFlags(flags, config);
-	appendCommonFlags(flags, config);
-	return flags;
-}
-function getPythonFlags(config) {
-	const flags = ["--ecosystem python"];
-	flags.push(`--python-web-framework ${config.pythonWebFramework}`);
-	flags.push(`--python-orm ${config.pythonOrm}`);
-	flags.push(`--python-validation ${config.pythonValidation}`);
-	flags.push(formatArrayFlag("python-ai", config.pythonAi));
-	flags.push(`--python-auth ${config.pythonAuth}`);
-	flags.push(`--python-api ${config.pythonApi}`);
-	flags.push(`--python-task-queue ${config.pythonTaskQueue}`);
-	flags.push(`--python-graphql ${config.pythonGraphql}`);
-	flags.push(`--python-quality ${config.pythonQuality}`);
-	flags.push(formatArrayFlag("python-testing", config.pythonTesting));
-	flags.push(`--python-caching ${config.pythonCaching}`);
-	flags.push(`--python-realtime ${config.pythonRealtime}`);
-	flags.push(`--python-observability ${config.pythonObservability}`);
-	flags.push(formatArrayFlag("python-cli", config.pythonCli));
-	appendSharedNonTypeScriptFlags(flags, config);
-	appendCommonFlags(flags, config);
-	return flags;
-}
-function getGoFlags(config) {
-	const flags = ["--ecosystem go"];
-	flags.push(`--go-web-framework ${config.goWebFramework}`);
-	flags.push(`--go-orm ${config.goOrm}`);
-	flags.push(`--go-api ${config.goApi}`);
-	flags.push(`--go-cli ${config.goCli}`);
-	flags.push(`--go-logging ${config.goLogging}`);
-	flags.push(`--go-auth ${config.goAuth}`);
-	flags.push(formatArrayFlag("go-testing", config.goTesting));
-	flags.push(`--go-realtime ${config.goRealtime}`);
-	flags.push(`--go-message-queue ${config.goMessageQueue}`);
-	flags.push(`--go-caching ${config.goCaching}`);
-	flags.push(`--go-config ${config.goConfig}`);
-	flags.push(`--go-observability ${config.goObservability}`);
-	flags.push(`--auth ${config.auth}`);
-	appendSharedNonTypeScriptFlags(flags, config);
-	appendCommonFlags(flags, config);
-	return flags;
-}
-function getJavaFlags(config) {
-	const flags = ["--ecosystem java"];
-	flags.push(`--java-web-framework ${config.javaWebFramework}`);
-	flags.push(`--java-build-tool ${config.javaBuildTool}`);
-	flags.push(`--java-orm ${config.javaOrm}`);
-	flags.push(`--java-auth ${config.javaAuth}`);
-	flags.push(`--java-api ${config.javaApi}`);
-	flags.push(`--java-logging ${config.javaLogging}`);
-	flags.push(formatArrayFlag("java-libraries", config.javaLibraries));
-	flags.push(formatArrayFlag("java-testing-libraries", config.javaTestingLibraries));
-	appendSharedNonTypeScriptFlags(flags, config);
-	appendCommonFlags(flags, config);
-	return flags;
-}
-function getDotnetFlags(config) {
-	const flags = ["--ecosystem dotnet"];
-	flags.push(`--dotnet-web-framework ${config.dotnetWebFramework}`);
-	flags.push(`--dotnet-orm ${config.dotnetOrm}`);
-	flags.push(`--dotnet-auth ${config.dotnetAuth}`);
-	flags.push(`--dotnet-api ${config.dotnetApi}`);
-	flags.push(formatArrayFlag("dotnet-testing", config.dotnetTesting));
-	flags.push(`--dotnet-job-queue ${config.dotnetJobQueue}`);
-	flags.push(`--dotnet-realtime ${config.dotnetRealtime}`);
-	flags.push(formatArrayFlag("dotnet-observability", config.dotnetObservability));
-	flags.push(`--dotnet-validation ${config.dotnetValidation}`);
-	flags.push(`--dotnet-caching ${config.dotnetCaching}`);
-	flags.push(`--dotnet-deploy ${config.dotnetDeploy}`);
-	appendCommonFlags(flags, config);
-	return flags;
-}
-function getElixirFlags(config) {
-	const flags = ["--ecosystem elixir"];
-	flags.push(`--elixir-web-framework ${config.elixirWebFramework}`);
-	flags.push(`--elixir-orm ${config.elixirOrm}`);
-	flags.push(`--elixir-auth ${config.elixirAuth}`);
-	flags.push(`--elixir-api ${config.elixirApi}`);
-	flags.push(`--elixir-realtime ${config.elixirRealtime}`);
-	flags.push(`--elixir-jobs ${config.elixirJobs}`);
-	flags.push(`--elixir-validation ${config.elixirValidation}`);
-	flags.push(`--elixir-http ${config.elixirHttp}`);
-	flags.push(`--elixir-json ${config.elixirJson}`);
-	flags.push(`--elixir-email ${config.elixirEmail}`);
-	flags.push(`--elixir-caching ${config.elixirCaching}`);
-	flags.push(`--elixir-observability ${config.elixirObservability}`);
-	flags.push(`--elixir-testing ${config.elixirTesting}`);
-	flags.push(`--elixir-quality ${config.elixirQuality}`);
-	flags.push(`--elixir-deploy ${config.elixirDeploy}`);
-	flags.push(formatArrayFlag("elixir-libraries", config.elixirLibraries));
-	appendCommonFlags(flags, config);
-	return flags;
-}
-function generateReproducibleCommand(config) {
-	let flags;
-	if (config.stackParts && config.stackParts.length > 0) {
-		flags = config.stackParts.filter((part) => part.source !== "provided").map((part) => `--part ${(0, types_exports.formatStackPartSpec)(part, config.stackParts ?? [])}`);
-		appendGraphExtraFlags(flags, config);
-		appendCommonFlags(flags, config);
-		return `${getBaseCommand(config.packageManager)}${config.relativePath ? ` ${config.relativePath}` : ""} ${flags.join(" ")}`;
-	}
-	switch (config.ecosystem) {
-		case "react-native":
-			flags = getReactNativeFlags(config);
-			break;
-		case "rust":
-			flags = getRustFlags(config);
-			break;
-		case "python":
-			flags = getPythonFlags(config);
-			break;
-		case "go":
-			flags = getGoFlags(config);
-			break;
-		case "java":
-			flags = getJavaFlags(config);
-			break;
-		case "dotnet":
-			flags = getDotnetFlags(config);
-			break;
-		case "elixir":
-			flags = getElixirFlags(config);
-			break;
-		case "typescript":
-		default:
-			flags = getTypeScriptFlags(config);
-			break;
-	}
-	return `${getBaseCommand(config.packageManager)}${config.relativePath ? ` ${config.relativePath}` : ""} ${flags.join(" ")}`;
-}
-
-//#endregion
-//#region src/utils/generated-checks.ts
-function getGraphTarget(config) {
-	const backend = getPrimaryGraphPart(config, "backend");
-	if (!backend || backend.ecosystem === "typescript" || backend.ecosystem === "react-native" || backend.ecosystem === "universal") return null;
-	return {
-		ecosystem: backend.ecosystem,
-		projectDir: path.join(config.projectDir, backend.targetPath ?? "apps/server")
-	};
-}
-function getSingleEcosystemTarget(config) {
-	if (config.ecosystem === "typescript" || config.ecosystem === "react-native" || config.ecosystem === "java") return null;
-	return {
-		ecosystem: config.ecosystem,
-		projectDir: config.projectDir
-	};
-}
-async function runCommand(cwd, command, args) {
-	await $({
-		cwd,
-		stdout: "inherit",
-		stderr: "inherit"
-	})`${command} ${args}`;
-}
-async function verifyTarget(target) {
-	const s = spinner();
-	const cwd = target.projectDir;
-	switch (target.ecosystem) {
-		case "go":
-			s.start("Verifying generated Go server...");
-			await runCommand(cwd, "go", ["mod", "tidy"]);
-			await runCommand(cwd, "go", ["test", "./..."]);
-			s.stop("Generated Go server checks passed");
-			return;
-		case "rust":
-			s.start("Verifying generated Rust server...");
-			await runCommand(cwd, "cargo", ["check"]);
-			s.stop("Generated Rust server checks passed");
-			return;
-		case "python":
-			s.start("Verifying generated Python server...");
-			await runCommand(cwd, "uv", ["sync"]);
-			await runCommand(cwd, "uv", [
-				"run",
-				"ruff",
-				"check",
-				"."
-			]);
-			s.stop("Generated Python server checks passed");
-			return;
-		case "elixir":
-			if (!await commandExists("mix")) {
-				log.warn(pc.yellow("Skipping Elixir verification because mix is not on PATH"));
-				return;
-			}
-			s.start("Verifying generated Elixir server...");
-			await runCommand(cwd, "mix", ["deps.get"]);
-			await runCommand(cwd, "mix", ["compile"]);
-			s.stop("Generated Elixir server checks passed");
-			return;
-		default: log.warn(pc.yellow(`No generated checks are configured for ${target.ecosystem}`));
-	}
-}
-async function runGeneratedChecks(config) {
-	const target = getGraphTarget(config) ?? getSingleEcosystemTarget(config);
-	if (!target) {
-		log.warn(pc.yellow("No generated checks are configured for this stack"));
-		return;
-	}
-	await verifyTarget(target);
-}
-
 //#endregion
 //#region src/utils/preflight-display.ts
 function displayPreflightWarnings({ warnings }) {
@@ -7856,87 +7735,6 @@ async function setupProjectDirectory(finalPathInput, shouldClearDirectory) {
 	};
 }
 
-//#endregion
-//#region src/utils/templates.ts
-const TEMPLATE_PRESETS = {
-	mern: {
-		database: "mongodb",
-		orm: "mongoose",
-		backend: "express",
-		runtime: "node",
-		frontend: ["react-router"],
-		api: "orpc",
-		auth: "better-auth",
-		payments: "none",
-		addons: ["turborepo"],
-		examples: ["none"],
-		dbSetup: "mongodb-atlas",
-		webDeploy: "none",
-		serverDeploy: "none"
-	},
-	pern: {
-		database: "postgres",
-		orm: "drizzle",
-		backend: "express",
-		runtime: "node",
-		frontend: ["tanstack-router"],
-		api: "trpc",
-		auth: "better-auth",
-		payments: "none",
-		addons: ["turborepo"],
-		examples: ["none"],
-		dbSetup: "none",
-		webDeploy: "none",
-		serverDeploy: "none"
-	},
-	t3: {
-		database: "postgres",
-		orm: "prisma",
-		backend: "self",
-		runtime: "none",
-		frontend: ["next"],
-		api: "trpc",
-		auth: "better-auth",
-		payments: "none",
-		addons: ["biome", "turborepo"],
-		examples: ["none"],
-		dbSetup: "none",
-		webDeploy: "none",
-		serverDeploy: "none"
-	},
-	uniwind: {
-		database: "none",
-		orm: "none",
-		backend: "none",
-		runtime: "none",
-		frontend: ["native-uniwind"],
-		api: "none",
-		auth: "none",
-		payments: "none",
-		addons: ["none"],
-		examples: ["none"],
-		dbSetup: "none",
-		webDeploy: "none",
-		serverDeploy: "none"
-	},
-	none: null
-};
-function getTemplateConfig(template) {
-	if (template === "none" || !template) return null;
-	const config = TEMPLATE_PRESETS[template];
-	if (!config) throw new Error(`Unknown template: ${template}`);
-	return config;
-}
-function getTemplateDescription(template) {
-	return {
-		mern: "MongoDB + Express + React + Node.js - Classic MERN stack",
-		pern: "PostgreSQL + Express + React + Node.js - Popular PERN stack",
-		t3: "T3 Stack - Next.js + tRPC + Prisma + PostgreSQL + Better Auth",
-		uniwind: "Expo + Uniwind native app with no backend services",
-		none: "No template - Full customization"
-	}[template] || "";
-}
-
 //#endregion
 //#region src/utils/config-processing.ts
 function deriveProjectName(projectName, projectDirectory) {
@@ -8439,7 +8237,45 @@ function validateFrontendConstraints(config, providedFlags) {
 	validateWebDeployRequiresWebFrontend(config.webDeploy, hasWebFrontendFlag);
 	validateWebDeployFrontendTemplates(config.webDeploy, frontend);
 }
-function validateApiConstraints(_config, _options) {}
+function validateApiConstraints(config, _options) {
+	if (config.api !== "openapi" && config.api !== "apollo-server") return;
+	const apiDisplayName = config.api === "apollo-server" ? "Apollo Server" : "OpenAPI";
+	const frontend = config.frontend ?? [];
+	if (frontend.some((item) => [
+		"native-bare",
+		"native-uniwind",
+		"native-unistyles"
+	].includes(item))) incompatibilityError({
+		message: `${apiDisplayName} is currently available for web frontends, not React Native.`,
+		provided: {
+			api: config.api,
+			frontend
+		},
+		suggestions: [
+			"Use --api trpc",
+			"Use --api orpc",
+			"Use a web frontend"
+		]
+	});
+	if (!config.backend || ![
+		"hono",
+		"express",
+		"fastify",
+		"elysia"
+	].includes(config.backend)) incompatibilityError({
+		message: `${apiDisplayName} currently supports Hono, Express, Fastify, and Elysia backends.`,
+		provided: {
+			api: config.api,
+			backend: config.backend ?? "none"
+		},
+		suggestions: [
+			"Use --backend hono",
+			"Use --backend express",
+			"Use --backend fastify",
+			"Use --backend elysia"
+		]
+	});
+}
 function validateJavaConstraints(config, providedFlags = /* @__PURE__ */ new Set()) {
 	if (config.ecosystem !== "java") return;
 	const hasSpringBoot = config.javaWebFramework === "spring-boot";
@@ -8698,10 +8534,11 @@ function validateRateLimitConstraints(config) {
 }
 function validateSearchConstraints(config) {
 	if (!config.search || config.search === "none") return;
-	if (config.ecosystem !== "typescript" && config.search !== "meilisearch") incompatibilityError({
+	const ecosystem = config.ecosystem ?? "typescript";
+	if (ecosystem !== "typescript" && config.search !== "meilisearch") incompatibilityError({
 		message: "Only Meilisearch search is available for non-TypeScript ecosystems.",
 		provided: {
-			ecosystem: config.ecosystem ?? "typescript",
+			ecosystem,
 			search: config.search
 		},
 		suggestions: ["Use --search meilisearch", "Use --search none"]
@@ -10042,10 +9879,10 @@ async function setupDatabase(config, cliInput) {
 			const serverDbDir = path.join(projectDir, "apps/server/src/db");
 			if (await fs.pathExists(serverDbDir)) await fs.remove(serverDbDir);
 		}
-		return;
+		return null;
 	}
 	const dbPackageDir = path.join(projectDir, "packages/db");
-	if (!await fs.pathExists(dbPackageDir)) return;
+	if (!await fs.pathExists(dbPackageDir)) return null;
 	try {
 		if (dbSetup === "docker") await setupDockerCompose(config);
 		else if (database === "sqlite" && dbSetup === "turso") await setupTurso(config, cliInput);
@@ -10058,8 +9895,18 @@ async function setupDatabase(config, cliInput) {
 		} else if (database === "mysql" && dbSetup === "planetscale") await setupPlanetScale(config);
 		else if (database === "mongodb" && dbSetup === "mongodb-atlas") await setupMongoDBAtlas(config, cliInput);
 		else if (database === "redis" && dbSetup === "upstash") await setupUpstash(config, cliInput);
+		return {
+			step: "Database setup",
+			success: true
+		};
 	} catch (error) {
-		if (error instanceof Error) consola.error(pc.red(error.message));
+		const errorMessage = error instanceof Error ? error.message : String(error);
+		consola.error(pc.red(errorMessage));
+		return {
+			step: "Database setup",
+			success: false,
+			errorMessage
+		};
 	}
 }
 
@@ -10659,14 +10506,14 @@ function displayJavaInstructions(config) {
 	}
 	const effectiveJavaTestingLibraries = javaBuildTool === "none" ? [] : javaTestingLibraries.filter((library) => library !== "none");
 	const buildToolCommand = javaBuildTool === "none" ? null : javaBuildTool === "gradle" ? process.platform === "win32" ? "gradlew.bat" : "./gradlew" : process.platform === "win32" ? "mvnw.cmd" : "./mvnw";
-	const runCommand$1 = buildToolCommand ? isSpringBoot ? javaBuildTool === "gradle" ? `${buildToolCommand} bootRun` : `${buildToolCommand} spring-boot:run` : isQuarkus ? javaBuildTool === "gradle" ? `${buildToolCommand} quarkusDev` : `${buildToolCommand} quarkus:dev` : javaBuildTool === "gradle" ? `${buildToolCommand} run` : `${buildToolCommand} exec:java` : null;
+	const runCommand = buildToolCommand ? isSpringBoot ? javaBuildTool === "gradle" ? `${buildToolCommand} bootRun` : `${buildToolCommand} spring-boot:run` : isQuarkus ? javaBuildTool === "gradle" ? `${buildToolCommand} quarkusDev` : `${buildToolCommand} quarkus:dev` : javaBuildTool === "gradle" ? `${buildToolCommand} run` : `${buildToolCommand} exec:java` : null;
 	const packageCommand = buildToolCommand ? javaBuildTool === "gradle" ? `${buildToolCommand} build` : `${buildToolCommand} package` : null;
 	const sourceCompileCommand = buildToolCommand ? null : `javac -d out ${getJavaMainSourcePath(projectName)}`;
 	const sourceRunCommand = buildToolCommand ? null : `java -cp out ${getJavaMainClass(projectName)}`;
 	let output = `${pc.bold("Next steps")}\n${pc.cyan("1.")} ${cdCmd}\n`;
 	let stepCounter = 2;
 	if (!depsInstalled && buildToolCommand && effectiveJavaTestingLibraries.length > 0) output += `${pc.cyan(`${stepCounter++}.`)} ${buildToolCommand} test\n`;
-	if (runCommand$1) output += `${pc.cyan(`${stepCounter++}.`)} ${runCommand$1}\n`;
+	if (runCommand) output += `${pc.cyan(`${stepCounter++}.`)} ${runCommand}\n`;
 	else if (sourceCompileCommand && sourceRunCommand) {
 		output += `${pc.cyan(`${stepCounter++}.`)} ${sourceCompileCommand}\n`;
 		output += `${pc.cyan(`${stepCounter++}.`)} ${sourceRunCommand}\n`;
@@ -10714,9 +10561,9 @@ function displayJavaInstructions(config) {
 		output += `${pc.cyan("•")} Testing: ${testingList}\n`;
 	}
 	output += `\n${pc.bold("Common Java commands:")}\n`;
-	if (buildToolCommand && runCommand$1 && packageCommand) {
+	if (buildToolCommand && runCommand && packageCommand) {
 		if (effectiveJavaTestingLibraries.length > 0) output += `${pc.cyan("•")} Test: ${buildToolCommand} test\n`;
-		output += `${pc.cyan("•")} Run: ${runCommand$1}\n`;
+		output += `${pc.cyan("•")} Run: ${runCommand}\n`;
 		output += `${pc.cyan("•")} Package: ${packageCommand}\n`;
 	} else if (sourceCompileCommand && sourceRunCommand) {
 		output += `${pc.cyan("•")} Compile: ${sourceCompileCommand}\n`;
@@ -10734,14 +10581,14 @@ function displayJavaInstructions(config) {
 function displayPythonInstructions(config) {
 	const { relativePath, depsInstalled, pythonWebFramework, pythonOrm, pythonValidation, pythonAi, pythonApi, pythonTaskQueue, pythonQuality } = config;
 	const cdCmd = `cd ${relativePath}`;
-	let runCommand$1 = "uv run uvicorn app.main:app --reload";
-	if (pythonWebFramework === "django") runCommand$1 = "uv run python manage.py runserver";
-	else if (pythonWebFramework === "flask") runCommand$1 = "uv run flask --app app.main run --reload";
-	else if (pythonWebFramework === "litestar") runCommand$1 = "litestar --app src.app.main:app run --reload --port 3001";
+	let runCommand = "uv run uvicorn app.main:app --reload";
+	if (pythonWebFramework === "django") runCommand = "uv run python manage.py runserver";
+	else if (pythonWebFramework === "flask") runCommand = "uv run flask --app app.main run --reload";
+	else if (pythonWebFramework === "litestar") runCommand = "litestar --app src.app.main:app run --reload --port 3001";
 	let output = `${pc.bold("Next steps")}\n${pc.cyan("1.")} ${cdCmd}\n`;
 	let stepCounter = 2;
 	if (!depsInstalled) output += `${pc.cyan(`${stepCounter++}.`)} uv sync\n`;
-	output += `${pc.cyan(`${stepCounter++}.`)} ${runCommand$1}\n`;
+	output += `${pc.cyan(`${stepCounter++}.`)} ${runCommand}\n`;
 	output += `\n${pc.bold("Your Python project includes:")}\n`;
 	if (pythonWebFramework && pythonWebFramework !== "none") output += `${pc.cyan("•")} Web Framework: ${{
 		fastapi: "FastAPI",
@@ -10779,7 +10626,7 @@ function displayPythonInstructions(config) {
 	}[pythonQuality] || pythonQuality}\n`;
 	output += `\n${pc.bold("Common Python commands:")}\n`;
 	output += `${pc.cyan("•")} Install: uv sync\n`;
-	output += `${pc.cyan("•")} Run: ${runCommand$1}\n`;
+	output += `${pc.cyan("•")} Run: ${runCommand}\n`;
 	output += `${pc.cyan("•")} Test: uv run pytest\n`;
 	if (pythonQuality === "ruff") {
 		output += `${pc.cyan("•")} Format: uv run ruff format .\n`;
@@ -10829,6 +10676,8 @@ function displayElixirInstructions(config) {
 async function createProject(options, cliInput = {}) {
 	const projectDir = options.projectDir;
 	const isConvex = options.backend === "convex";
+	const setupFailures = [];
+	const dirHadContentBefore = await fs.pathExists(projectDir) && (await fs.readdir(projectDir)).length > 0;
 	try {
 		await fs.ensureDir(projectDir);
 		const [{ generateVirtualProject, EMBEDDED_TEMPLATES }, { writeTreeToFilesystem }] = await Promise.all([import("@better-fullstack/template-generator"), import("@better-fullstack/template-generator/fs-writer")]);
@@ -10840,29 +10689,53 @@ async function createProject(options, cliInput = {}) {
 		await writeTreeToFilesystem(result.tree, projectDir);
 		await setPackageManagerVersion(projectDir, options.packageManager);
 		await ensurePackageManagerProjectFiles(projectDir, options.packageManager);
-		if (!isConvex && options.database !== "none") await setupDatabase(options, cliInput);
+		if (!isConvex && options.database !== "none") {
+			const dbResult = await setupDatabase(options, cliInput);
+			if (dbResult && !dbResult.success) setupFailures.push(dbResult);
+		}
 		if (options.addons.length > 0 && options.addons[0] !== "none") await setupAddons(options);
 		await applyDependencyVersionChannel(projectDir, options.versionChannel);
 		await writeBtsConfig(options);
 		await formatProject(projectDir);
 		if (!isSilent()) log.success("Project template successfully scaffolded!");
-		if (options.install && (options.ecosystem === "typescript" || options.ecosystem === "react-native")) await installDependencies({
-			projectDir,
-			packageManager: options.packageManager
-		});
-		if (options.install && options.ecosystem === "rust") await runCargoBuild({ projectDir });
-		if (options.install && options.ecosystem === "python") await runUvSync({ projectDir });
-		if (options.install && options.ecosystem === "go") await runGoModTidy({ projectDir });
-		if (options.install && options.ecosystem === "java" && options.javaBuildTool !== "none") if (options.javaBuildTool === "gradle") await runGradleTests({ projectDir });
-		else await runMavenTests({ projectDir });
-		if (options.install && options.ecosystem === "elixir") await runMixCompile({ projectDir });
+		if (options.install && (options.ecosystem === "typescript" || options.ecosystem === "react-native")) {
+			const result$1 = await installDependencies({
+				projectDir,
+				packageManager: options.packageManager
+			});
+			if (!result$1.success) setupFailures.push(result$1);
+		}
+		if (options.install && options.ecosystem === "rust") {
+			const result$1 = await runCargoBuild({ projectDir });
+			if (!result$1.success) setupFailures.push(result$1);
+		}
+		if (options.install && options.ecosystem === "python") {
+			const result$1 = await runUvSync({ projectDir });
+			if (!result$1.success) setupFailures.push(result$1);
+		}
+		if (options.install && options.ecosystem === "go") {
+			const result$1 = await runGoModTidy({ projectDir });
+			if (!result$1.success) setupFailures.push(result$1);
+		}
+		if (options.install && options.ecosystem === "java" && options.javaBuildTool !== "none") {
+			const result$1 = options.javaBuildTool === "gradle" ? await runGradleTests({ projectDir }) : await runMavenTests({ projectDir });
+			if (!result$1.success) setupFailures.push(result$1);
+		}
+		if (options.install && options.ecosystem === "elixir") {
+			const result$1 = await runMixCompile({ projectDir });
+			if (!result$1.success) setupFailures.push(result$1);
+		}
 		await initializeGit(projectDir, options.git);
 		if (!isSilent()) await displayPostInstallInstructions({
 			...options,
 			depsInstalled: options.install
 		});
-		return projectDir;
+		return {
+			projectDir,
+			setupFailures
+		};
 	} catch (error) {
+		await rollbackPartialProject(projectDir, dirHadContentBefore);
 		if (error instanceof Error) {
 			if (!isSilent()) console.error(error.stack);
 			exitWithError(`Error during project creation: ${error.message}`);
@@ -10872,6 +10745,23 @@ async function createProject(options, cliInput = {}) {
 		}
 	}
 }
+/**
+* Remove a half-written project directory after a fatal scaffolding error so the
+* user is not left with a broken, partially generated project. Only removes
+* directories we created ourselves (empty/new before scaffolding) — never one
+* that already had user content (merge mode). Set BTS_KEEP_FAILED_OUTPUT=1 to
+* keep the partial output for debugging template failures.
+*/
+async function rollbackPartialProject(projectDir, dirHadContentBefore) {
+	if (dirHadContentBefore || process.env.BTS_KEEP_FAILED_OUTPUT) {
+		if (!isSilent() && dirHadContentBefore) log.warn(`Left partially created files in ${projectDir} (directory already existed). Review and clean up manually.`);
+		return;
+	}
+	try {
+		await fs.remove(projectDir);
+		if (!isSilent()) log.warn(`Cleaned up partially created project at ${projectDir}. Set BTS_KEEP_FAILED_OUTPUT=1 to keep it for debugging.`);
+	} catch {}
+}
 async function setPackageManagerVersion(projectDir, packageManager) {
 	const pkgJsonPath = path.join(projectDir, "package.json");
 	if (!await fs.pathExists(pkgJsonPath)) return;
@@ -10932,6 +10822,7 @@ function getYesBaseConfig(flagConfig) {
 		rateLimit: "none",
 		i18n: "none",
 		search: "none",
+		vectorDb: "none",
 		fileStorage: "none",
 		mobileNavigation: "expo-router",
 		mobileUI: "none",
@@ -10942,8 +10833,8 @@ function getYesBaseConfig(flagConfig) {
 		mobileDeepLinking: "none"
 	};
 }
-function shouldPromptForVersionChannel(input) {
-	if (input.yes || input.part?.length || input.versionChannel !== void 0 || isSilent()) return false;
+function shouldPromptForVersionChannel(input, hasConfigBase) {
+	if (input.yes || input.part?.length || hasConfigBase || input.versionChannel !== void 0 || isSilent()) return false;
 	return canPromptInteractively();
 }
 async function createProjectHandler(input, options = {}) {
@@ -10954,10 +10845,15 @@ async function createProjectHandler(input, options = {}) {
 		try {
 			if (!isSilent() && input.renderTitle !== false) renderTitle();
 			if (!isSilent()) intro(pc.magenta("Creating a new Better Fullstack project"));
+			await maybeShowTelemetryNotice();
 			if (!isSilent() && input.yolo) consola.fatal("YOLO mode enabled - skipping checks. Things may break!");
+			const configBase = await resolveCreateConfigBase(input);
+			const hasConfigBase = configBase !== void 0;
+			if (hasConfigBase && !isSilent()) log.info(pc.cyan(input.config ? `Using stack from config file: ${input.config}` : `Using stack from history entry #${input.fromHistory}`));
+			const useDefaultsForName = Boolean(input.yes) || hasConfigBase;
 			let currentPathInput;
-			if (input.yes && input.projectName) currentPathInput = input.projectName;
-			else if (input.yes) {
+			if (useDefaultsForName && input.projectName) currentPathInput = input.projectName;
+			else if (useDefaultsForName) {
 				const defaultConfig = getDefaultConfig();
 				let defaultName = defaultConfig.relativePath;
 				let counter = 1;
@@ -10967,7 +10863,7 @@ async function createProjectHandler(input, options = {}) {
 				}
 				currentPathInput = defaultName;
 			} else currentPathInput = await getProjectName(input.projectName);
-			const versionChannel = shouldPromptForVersionChannel(input) ? await getVersionChannelChoice() : input.versionChannel ?? "stable";
+			const versionChannel = shouldPromptForVersionChannel(input, hasConfigBase) ? await getVersionChannelChoice() : input.versionChannel ?? configBase?.versionChannel ?? "stable";
 			let finalResolvedPath;
 			let finalBaseName;
 			if (input.dryRun) {
@@ -11046,6 +10942,7 @@ async function createProjectHandler(input, options = {}) {
 							rateLimit: "none",
 							i18n: "none",
 							search: "none",
+							vectorDb: "none",
 							featureFlags: "none",
 							analytics: "none",
 							fileStorage: "none",
@@ -11132,11 +11029,15 @@ async function createProjectHandler(input, options = {}) {
 				finalBaseName = setupResult.finalBaseName;
 				currentPathInput = finalPathInput;
 			}
-			const originalInput = {
-				...input,
+			const explicitInput = {
+				...Object.fromEntries(Object.entries(input).filter(([, value]) => value !== void 0)),
 				projectDirectory: input.projectName
 			};
-			const providedFlags = getProvidedFlags(originalInput);
+			const originalInput = {
+				...configBase,
+				...explicitInput
+			};
+			const providedFlags = getProvidedFlags(explicitInput);
 			let cliInput = originalInput;
 			if (input.template && input.template !== "none") {
 				const templateConfig = getTemplateConfig(input.template);
@@ -11159,7 +11060,7 @@ async function createProjectHandler(input, options = {}) {
 			}
 			const { validatePreflightConfig } = await import("@better-fullstack/template-generator");
 			let config;
-			if (cliInput.yes || cliInput.part?.length) {
+			if (cliInput.yes || cliInput.part?.length || hasConfigBase) {
 				const flagConfig = processProvidedFlagsWithoutValidation(cliInput, finalBaseName);
 				config = {
 					...getYesBaseConfig(flagConfig),
@@ -11235,7 +11136,7 @@ async function createProjectHandler(input, options = {}) {
 					files
 				};
 			}
-			await createProject(config, { manualDb: cliInput.manualDb ?? input.manualDb });
+			const setupFailures = (await createProject(config, { manualDb: cliInput.manualDb ?? input.manualDb }))?.setupFailures ?? [];
 			if (cliInput.verify ?? input.verify) await runGeneratedChecks(config);
 			const reproducibleCommand = generateReproducibleCommand(config);
 			if (!isSilent()) log.success(pc.blue(`You can reproduce this setup with the following command:\n${reproducibleCommand}`));
@@ -11248,7 +11149,12 @@ async function createProjectHandler(input, options = {}) {
 			const elapsedTimeMs = Date.now() - startTime;
 			if (!isSilent()) {
 				const elapsedTimeInSeconds = (elapsedTimeMs / 1e3).toFixed(2);
-				outro(pc.magenta(`Project created successfully in ${pc.bold(elapsedTimeInSeconds)} seconds!`));
+				if (setupFailures.length > 0) {
+					const stepList = setupFailures.map((f) => f.step).join(", ");
+					const installCmd = config.packageManager === "npm" ? "npm install" : `${config.packageManager} install`;
+					log.warn(pc.yellow(`Project files were scaffolded in ${config.relativePath}, but ${setupFailures.length} setup step(s) did not complete: ${stepList}.\nReview the errors above, then finish setup manually (for example, run '${installCmd}' inside the project).`));
+					outro(pc.yellow(`Project created with ${setupFailures.length} unfinished setup step(s) in ${pc.bold(elapsedTimeInSeconds)}s.`));
+				} else outro(pc.magenta(`Project created successfully in ${pc.bold(elapsedTimeInSeconds)} seconds!`));
 			}
 			return {
 				success: true,
@@ -11257,7 +11163,8 @@ async function createProjectHandler(input, options = {}) {
 				timeScaffolded,
 				elapsedTimeMs,
 				projectDirectory: config.projectDir,
-				relativePath: config.relativePath
+				relativePath: config.relativePath,
+				setupFailures
 			};
 		} catch (error) {
 			if (error instanceof UserCancelledError) {
@@ -11434,7 +11341,7 @@ const router = os.router({
 		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-BPAZM8Zo.mjs");
+		const { addHandler } = await import("./add-handler-BjTmOwEN.mjs");
 		await addHandler(input);
 	}),
 	history: os.meta({ description: "Show history of scaffolded projects with reproducible commands" }).input(z.object({
@@ -11444,6 +11351,17 @@ const router = os.router({
 	})).handler(async ({ input }) => {
 		await historyHandler(input);
 	}),
+	telemetry: os.meta({ description: "View or change anonymous usage telemetry collection (status | enable | disable)" }).input(z.tuple([z.enum([
+		"status",
+		"enable",
+		"disable"
+	]).optional().default("status").describe("Action to perform: status (default), enable, or disable"), z.object({ json: z.boolean().optional().default(false).describe("Output status as JSON") })])).handler(async ({ input }) => {
+		const [action, options] = input;
+		await telemetryHandler({
+			action,
+			json: options.json
+		});
+	}),
 	"update-deps": os.meta({ description: "Check and update dependency versions in add-deps.ts" }).input(z.object({
 		check: z.boolean().default(false).describe("Report only, no changes"),
 		patch: z.boolean().default(false).describe("Apply patch/minor updates only"),
@@ -11451,7 +11369,7 @@ const router = os.router({
 		ecosystem: z.string().optional().describe("Filter by ecosystem (effect, tanstack, prisma, etc.)"),
 		"list-ecosystems": z.boolean().default(false).describe("List available ecosystems")
 	})).handler(async ({ input }) => {
-		const { updateDepsHandler, showEcosystems } = await import("./update-deps-CLebIM70.mjs");
+		const { updateDepsHandler, showEcosystems } = await import("./update-deps-D5OG0KmJ.mjs");
 		if (input["list-ecosystems"]) {
 			showEcosystems();
 			return;
@@ -11466,6 +11384,17 @@ const router = os.router({
 	mcp: os.meta({ description: "Start the Better Fullstack MCP server so AI agents can inspect the schema, plan stacks, and scaffold projects over stdio" }).handler(async () => {
 		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 }) => {
+		const [projectDir, options] = input;
+		const { doctorCommand } = await import("./doctor-Bm9qvkya.mjs");
+		await doctorCommand({
+			projectDir,
+			...options
+		});
 	})
 });
 const caller = createRouterClient(router, { context: {} });
@@ -11531,7 +11460,7 @@ async function builder() {
 	return caller.builder();
 }
 async function add(input) {
-	const { addHandler } = await import("./add-handler-BPAZM8Zo.mjs");
+	const { addHandler } = await import("./add-handler-BjTmOwEN.mjs");
 	return addHandler(input, { silent: true });
 }
 async function history(options) {
@@ -11541,6 +11470,9 @@ async function history(options) {
 		json: options?.json ?? false
 	});
 }
+async function telemetry(action = "status", options) {
+	return caller.telemetry([action, { json: options?.json ?? false }]);
+}
 
 //#endregion
-export { docs as a, sponsors as c, createBtsCli as i, builder as n, history as o, create as r, router as s, add as t };
+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 };