create-better-fullstack 2.1.5 → 2.1.6

package/dist/index.mjs

@@ -1,11 +1,14 @@
 #!/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 "./bts-config-BceXPcpI.mjs";
+import { a as createBtsCli, c as history, d as telemetry, f as update, 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-D80ZtSO8.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";
+import "./errors-ns_o2OKg.mjs";
+import "./addons-setup-C_lxdJqU.mjs";
+import "./file-formatter-XU6ti05V.mjs";
+import "./install-dependencies-DHoYa3P-.mjs";
+import "./generated-checks-Dt4Xqp1x.mjs";
+import { t as applyEffectBackendDefaults } from "./config-processing-B_1wTe3g.mjs";
+import "./scaffold-manifest-GV1fbhpD.mjs";
 import { EMBEDDED_TEMPLATES, TEMPLATE_COUNT, VirtualFileSystem, generateVirtualProject } from "@better-fullstack/template-generator";
 
 //#region src/index.ts
@@ -36,6 +39,7 @@ async function createVirtual(options) {
 		const ecosystem = options.ecosystem || "typescript";
 		const isReactNative = ecosystem === "react-native";
 		const frontend = options.frontend || (isReactNative ? ["native-bare"] : ["tanstack-router"]);
+		const backend = options.backend || (isReactNative ? "none" : "hono");
 		const hasNativeFrontend = frontend.some((item) => item === "native-bare" || item === "native-uniwind" || item === "native-unistyles");
 		const config = {
 			ecosystem,
@@ -44,7 +48,7 @@ async function createVirtual(options) {
 			relativePath: "./virtual",
 			database: options.database || "none",
 			orm: options.orm || "none",
-			backend: options.backend || (isReactNative ? "none" : "hono"),
+			backend,
 			runtime: options.runtime || (isReactNative ? "none" : "bun"),
 			frontend,
 			addons: options.addons || [],
@@ -56,6 +60,7 @@ async function createVirtual(options) {
 			effect: options.effect || "none",
 			git: options.git ?? false,
 			packageManager: options.packageManager || "bun",
+			workspaceShape: options.workspaceShape || "monorepo",
 			versionChannel: options.versionChannel || "stable",
 			install: false,
 			dbSetup: options.dbSetup || "none",
@@ -139,6 +144,7 @@ async function createVirtual(options) {
 			goConfig: options.goConfig || "none",
 			goObservability: options.goObservability || "none",
 			javaWebFramework: options.javaWebFramework || (options.ecosystem === "java" ? "spring-boot" : "none"),
+			javaLanguage: options.javaLanguage || "java",
 			javaBuildTool: options.javaBuildTool || (options.ecosystem === "java" ? "maven" : "none"),
 			javaOrm: options.javaOrm || "none",
 			javaAuth: options.javaAuth || "none",
@@ -176,6 +182,7 @@ async function createVirtual(options) {
 			aiDocs: options.aiDocs || ["claude-md", "agents-md"]
 		};
 		if (options.stackParts) config.stackParts = options.stackParts;
+		applyEffectBackendDefaults(config, new Set(Object.keys(options)));
 		const { generateVirtualProject: generate, EMBEDDED_TEMPLATES: EMBEDDED_TEMPLATES$2 } = await import("@better-fullstack/template-generator");
 		const result = await generate({
 			config,
@@ -198,4 +205,4 @@ async function createVirtual(options) {
 }
 
 //#endregion
-export { EMBEDDED_TEMPLATES, TEMPLATE_COUNT, VirtualFileSystem, add, builder, check, create, createBtsCli, createVirtual, docs, doctor, generateVirtualProject, history, router, sponsors, telemetry };
+export { EMBEDDED_TEMPLATES, TEMPLATE_COUNT, VirtualFileSystem, add, builder, check, create, createBtsCli, createVirtual, docs, doctor, generateVirtualProject, history, router, sponsors, telemetry, update };

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

@@ -1,6 +1,7 @@
 #!/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-Cyol8zbN.mjs";
-import { g as validateAddonCompatibility, o as getCompatibleAddons } from "./file-formatter-B3dsev2l.mjs";
+import { c as DEFAULT_CONFIG, y as types_exports } from "./bts-config-BceXPcpI.mjs";
+import { d as setLastPromptShownUI, r as exitCancelled, s as isFirstPrompt, u as setIsFirstPrompt$1 } from "./errors-ns_o2OKg.mjs";
+import { g as validateAddonCompatibility, o as getCompatibleAddons } from "./file-formatter-XU6ti05V.mjs";
 import { log, spinner } from "@clack/prompts";
 import pc from "picocolors";
 import fs from "fs-extra";
@@ -496,6 +497,16 @@ const PRERELEASE_TAG_PRIORITY = [
 ];
 const REGISTRY_FETCH_TIMEOUT_MS = 1e4;
 const REGISTRY_CONCURRENCY = 10;
+const SYNCHRONIZED_VERSION_FAMILIES = [{
+	name: "oRPC",
+	packages: [
+		"@orpc/server",
+		"@orpc/client",
+		"@orpc/openapi",
+		"@orpc/zod",
+		"@orpc/tanstack-query"
+	]
+}];
 function mapWithConcurrency(items, fn, concurrency) {
 	const results = Array.from({ length: items.length });
 	let index = 0;
@@ -507,6 +518,19 @@ function mapWithConcurrency(items, fn, concurrency) {
 	}
 	return Promise.all(Array.from({ length: Math.min(concurrency, items.length) }, () => worker())).then(() => results);
 }
+function getVersionSections(packageJson) {
+	const sections = [];
+	for (const sectionName of ["dependencies", "devDependencies"]) {
+		const section = packageJson[sectionName];
+		if (section && typeof section === "object" && !Array.isArray(section)) sections.push(section);
+	}
+	const workspaces = packageJson.workspaces;
+	if (workspaces && typeof workspaces === "object" && !Array.isArray(workspaces)) {
+		const catalog = workspaces.catalog;
+		if (catalog && typeof catalog === "object" && !Array.isArray(catalog)) sections.push(catalog);
+	}
+	return sections;
+}
 function parseVersion(value) {
 	const normalized = value.replace(/^[^\d]*/, "");
 	const dashIdx = normalized.indexOf("-");
@@ -580,10 +604,40 @@ function selectRegistryVersionForChannel(packageInfo, channel) {
 	if (prereleases.length > 0) return prereleases.sort((left, right) => compareVersions(right, left))[0] ?? null;
 	return tags.latest ?? null;
 }
-async function resolveRegistryVersion(packageName, channel) {
-	const version = selectRegistryVersionForChannel(await fetchPackageInfo(packageName), channel);
-	if (!version) throw new Error(`No ${channel} version available for ${packageName}`);
-	return version;
+function getVersionsForChannel(packageInfo, channel) {
+	const versions = Object.keys(packageInfo.versions ?? {});
+	if (channel === "latest") return versions.filter((version) => !isPrerelease(version));
+	const prereleases = versions.filter(isPrerelease);
+	return prereleases.length > 0 ? prereleases : versions.filter((version) => !isPrerelease(version));
+}
+function resolveSharedFamilyVersion(packageInfos, channel) {
+	if (packageInfos.length === 0) return null;
+	const firstInfo = packageInfos[0];
+	if (!firstInfo) return null;
+	let commonVersions = new Set(getVersionsForChannel(firstInfo, channel));
+	const remainingInfos = packageInfos.slice(1);
+	for (const packageInfo of remainingInfos) {
+		const availableVersions = new Set(getVersionsForChannel(packageInfo, channel));
+		commonVersions = new Set([...commonVersions].filter((version) => availableVersions.has(version)));
+	}
+	return [...commonVersions].sort((left, right) => compareVersions(right, left))[0] ?? null;
+}
+function applySynchronizedFamilyVersions(resolvedVersions, packageInfos, channel) {
+	for (const family of SYNCHRONIZED_VERSION_FAMILIES) {
+		const selectedPackages = family.packages.filter((packageName) => resolvedVersions.has(packageName));
+		if (selectedPackages.length < 2) continue;
+		const selectedPackageInfos = selectedPackages.flatMap((packageName) => {
+			const packageInfo = packageInfos.get(packageName);
+			return packageInfo ? [packageInfo] : [];
+		});
+		if (selectedPackageInfos.length !== selectedPackages.length) continue;
+		const sharedVersion = resolveSharedFamilyVersion(selectedPackageInfos, channel);
+		if (!sharedVersion) {
+			log.warn(`Failed to resolve shared ${channel} version for ${family.name} packages`);
+			continue;
+		}
+		for (const packageName of selectedPackages) resolvedVersions.set(packageName, sharedVersion);
+	}
 }
 async function collectPackageJsonPaths(projectDir) {
 	const results = [];
@@ -609,35 +663,35 @@ async function applyDependencyVersionChannel(projectDir, channel) {
 	const packageNames = /* @__PURE__ */ new Set();
 	for (const packageJsonPath of packageJsonPaths) {
 		const packageJson = await fs.readJson(packageJsonPath);
-		for (const [depName, depVersion] of Object.entries(packageJson.dependencies ?? {})) if (typeof depVersion === "string" && isRegistrySemverSpec(depVersion)) packageNames.add(depName);
-		for (const [depName, depVersion] of Object.entries(packageJson.devDependencies ?? {})) if (typeof depVersion === "string" && isRegistrySemverSpec(depVersion)) packageNames.add(depName);
+		for (const section of getVersionSections(packageJson)) for (const [depName, depVersion] of Object.entries(section)) if (typeof depVersion === "string" && isRegistrySemverSpec(depVersion)) packageNames.add(depName);
 	}
 	if (packageNames.size === 0) return;
 	const resolvedVersions = /* @__PURE__ */ new Map();
+	const packageInfos = /* @__PURE__ */ new Map();
 	await mapWithConcurrency([...packageNames], async (packageName) => {
 		try {
-			const resolvedVersion = await resolveRegistryVersion(packageName, channel);
+			const packageInfo = await fetchPackageInfo(packageName);
+			const resolvedVersion = selectRegistryVersionForChannel(packageInfo, channel);
+			if (!resolvedVersion) throw new Error(`No ${channel} version available for ${packageName}`);
+			packageInfos.set(packageName, packageInfo);
 			resolvedVersions.set(packageName, resolvedVersion);
 		} catch (error) {
 			log.warn(`Failed to resolve ${channel} version for ${packageName}: ${error instanceof Error ? error.message : String(error)}`);
 		}
 	}, REGISTRY_CONCURRENCY);
 	if (resolvedVersions.size === 0) return;
+	applySynchronizedFamilyVersions(resolvedVersions, packageInfos, channel);
 	for (const packageJsonPath of packageJsonPaths) {
 		const packageJson = await fs.readJson(packageJsonPath);
 		let changed = false;
-		for (const sectionName of ["dependencies", "devDependencies"]) {
-			const section = packageJson[sectionName];
-			if (!section) continue;
-			for (const [packageName, currentVersion] of Object.entries(section)) {
-				if (!isRegistrySemverSpec(currentVersion)) continue;
-				const resolvedVersion = resolvedVersions.get(packageName);
-				if (!resolvedVersion) continue;
-				const nextVersion = applyVersionPrefix(currentVersion, resolvedVersion);
-				if (nextVersion !== currentVersion) {
-					section[packageName] = nextVersion;
-					changed = true;
-				}
+		for (const section of getVersionSections(packageJson)) for (const [packageName, currentVersion] of Object.entries(section)) {
+			if (!isRegistrySemverSpec(currentVersion)) continue;
+			const resolvedVersion = resolvedVersions.get(packageName);
+			if (!resolvedVersion) continue;
+			const nextVersion = applyVersionPrefix(currentVersion, resolvedVersion);
+			if (nextVersion !== currentVersion) {
+				section[packageName] = nextVersion;
+				changed = true;
 			}
 		}
 		if (changed) await fs.writeJson(packageJsonPath, packageJson, { spaces: 2 });

package/dist/mcp-D9O5zgAA.mjs

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+import "./bts-config-BceXPcpI.mjs";
+import "./errors-ns_o2OKg.mjs";
+import "./file-formatter-XU6ti05V.mjs";
+import "./config-processing-B_1wTe3g.mjs";
+import { a as startMcpServer, i as recommendStackFromBrief, n as MCP_STACK_UPDATE_SCHEMA, r as getMcpGraphPreview, t as MCP_PLAN_CREATE_SCHEMA } from "./mcp-entry.mjs";
+
+export { recommendStackFromBrief, startMcpServer };

package/dist/mcp-entry.mjs

@@ -1,11 +1,12 @@
 #!/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-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 { f as getEffectiveStack, g as getGraphSummary, n as previewBtsConfigUpdate, o as writeBtsConfig, r as readBtsConfig, s as getLatestCLIVersion, t as buildBtsConfigForPersistence, u as getDefaultConfig, y as types_exports } from "./bts-config-BceXPcpI.mjs";
+import "./errors-ns_o2OKg.mjs";
+import { r as validateConfigForProgrammaticUse, t as formatCode, v as CreateCommandOptionsSchema } from "./file-formatter-XU6ti05V.mjs";
+import { a as getTemplateConfig, o as getTemplateDescription, s as generateReproducibleCommand, t as applyEffectBackendDefaults } from "./config-processing-B_1wTe3g.mjs";
 import z from "zod";
 import fs from "fs-extra";
 import path from "node:path";
-import { AISchema, APISchema, AddonsSchema, AiDocsSchema, AnalyticsSchema, AnimationSchema, AstroIntegrationSchema, AuthSchema, BackendSchema, CATEGORY_ORDER, CMSSchema, CSSFrameworkSchema, CachingSchema, DatabaseSchema, DatabaseSetupSchema, DotnetApiSchema, DotnetAuthSchema, DotnetCachingSchema, DotnetDeploySchema, DotnetJobQueueSchema, DotnetObservabilitySchema, DotnetOrmSchema, DotnetRealtimeSchema, DotnetTestingSchema, DotnetValidationSchema, DotnetWebFrameworkSchema, EcosystemSchema, EffectSchema, ElixirApiSchema, ElixirAuthSchema, ElixirCachingSchema, ElixirDeploySchema, ElixirEmailSchema, ElixirHttpSchema, ElixirJobsSchema, ElixirJsonSchema, ElixirLibrariesSchema, ElixirObservabilitySchema, ElixirOrmSchema, ElixirQualitySchema, ElixirRealtimeSchema, ElixirTestingSchema, ElixirValidationSchema, ElixirWebFrameworkSchema, EmailSchema, ExamplesSchema, FeatureFlagsSchema, FileStorageSchema, FileUploadSchema, FormsSchema, FrontendSchema, GoApiSchema, GoAuthSchema, GoCachingSchema, GoCliSchema, GoConfigSchema, GoLoggingSchema, GoMessageQueueSchema, GoObservabilitySchema, GoOrmSchema, GoRealtimeSchema, GoTestingSchema, GoWebFrameworkSchema, I18nSchema, JavaApiSchema, JavaAuthSchema, JavaBuildToolSchema, JavaLibrariesSchema, JavaLoggingSchema, JavaOrmSchema, JavaTestingLibrariesSchema, JavaWebFrameworkSchema, JobQueueSchema, LoggingSchema, MobileDeepLinkingSchema, MobileNavigationSchema, MobileOTASchema, MobilePushSchema, MobileStorageSchema, MobileTestingSchema, MobileUISchema, OPTION_CATEGORY_METADATA, ORMSchema, ObservabilitySchema, PackageManagerSchema, PaymentsSchema, PythonAiSchema, PythonApiSchema, PythonAuthSchema, PythonCachingSchema, PythonCliSchema, PythonGraphqlSchema, PythonObservabilitySchema, PythonOrmSchema, PythonQualitySchema, PythonRealtimeSchema, PythonTaskQueueSchema, PythonTestingSchema, PythonValidationSchema, PythonWebFrameworkSchema, RateLimitSchema, RealtimeSchema, RuntimeSchema, RustApiSchema, RustAuthSchema, RustCachingSchema, RustCliSchema, RustErrorHandlingSchema, RustFrontendSchema, RustLibrariesSchema, RustLoggingSchema, RustMessageQueueSchema, RustObservabilitySchema, RustOrmSchema, RustRealtimeSchema, RustTemplatingSchema, RustWebFrameworkSchema, SearchSchema, ServerDeploySchema, ShadcnBaseColorSchema, ShadcnBaseSchema, ShadcnColorThemeSchema, ShadcnFontSchema, ShadcnIconLibrarySchema, ShadcnRadiusSchema, ShadcnStyleSchema, StateManagementSchema, TEMPLATE_VALUES, TestingSchema, UILibrarySchema, ValidationSchema, VectorDbSchema, VersionChannelSchema, WebDeploySchema, analyzeStackCompatibility, evaluateCompatibility, formatStackPartSpec, getCategoryOrderForEcosystem, legacyProjectConfigToStackParts, parseStackPartSpecs, stackPartsToLegacyProjectConfigPartial } from "@better-fullstack/types";
+import { AISchema, APISchema, AddonsSchema, AiDocsSchema, AnalyticsSchema, AnimationSchema, AstroIntegrationSchema, AuthSchema, BackendSchema, CATEGORY_ORDER, CMSSchema, CSSFrameworkSchema, CachingSchema, DatabaseSchema, DatabaseSetupSchema, DotnetApiSchema, DotnetAuthSchema, DotnetCachingSchema, DotnetDeploySchema, DotnetJobQueueSchema, DotnetObservabilitySchema, DotnetOrmSchema, DotnetRealtimeSchema, DotnetTestingSchema, DotnetValidationSchema, DotnetWebFrameworkSchema, EcosystemSchema, EffectSchema, ElixirApiSchema, ElixirAuthSchema, ElixirCachingSchema, ElixirDeploySchema, ElixirEmailSchema, ElixirHttpSchema, ElixirJobsSchema, ElixirJsonSchema, ElixirLibrariesSchema, ElixirObservabilitySchema, ElixirOrmSchema, ElixirQualitySchema, ElixirRealtimeSchema, ElixirTestingSchema, ElixirValidationSchema, ElixirWebFrameworkSchema, EmailSchema, ExamplesSchema, FeatureFlagsSchema, FileStorageSchema, FileUploadSchema, FormsSchema, FrontendSchema, GoApiSchema, GoAuthSchema, GoCachingSchema, GoCliSchema, GoConfigSchema, GoLoggingSchema, GoMessageQueueSchema, GoObservabilitySchema, GoOrmSchema, GoRealtimeSchema, GoTestingSchema, GoWebFrameworkSchema, I18nSchema, JavaApiSchema, JavaAuthSchema, JavaBuildToolSchema, JavaLanguageSchema, JavaLibrariesSchema, JavaLoggingSchema, JavaOrmSchema, JavaTestingLibrariesSchema, JavaWebFrameworkSchema, JobQueueSchema, LoggingSchema, MobileDeepLinkingSchema, MobileNavigationSchema, MobileOTASchema, MobilePushSchema, MobileStorageSchema, MobileTestingSchema, MobileUISchema, OPTION_CATEGORY_METADATA, ORMSchema, ObservabilitySchema, PackageManagerSchema, PaymentsSchema, PythonAiSchema, PythonApiSchema, PythonAuthSchema, PythonCachingSchema, PythonCliSchema, PythonGraphqlSchema, PythonObservabilitySchema, PythonOrmSchema, PythonQualitySchema, PythonRealtimeSchema, PythonTaskQueueSchema, PythonTestingSchema, PythonValidationSchema, PythonWebFrameworkSchema, RateLimitSchema, RealtimeSchema, RuntimeSchema, RustApiSchema, RustAuthSchema, RustCachingSchema, RustCliSchema, RustErrorHandlingSchema, RustFrontendSchema, RustLibrariesSchema, RustLoggingSchema, RustMessageQueueSchema, RustObservabilitySchema, RustOrmSchema, RustRealtimeSchema, RustTemplatingSchema, RustWebFrameworkSchema, SearchSchema, ServerDeploySchema, ShadcnBaseColorSchema, ShadcnBaseSchema, ShadcnColorThemeSchema, ShadcnFontSchema, ShadcnIconLibrarySchema, ShadcnRadiusSchema, ShadcnStyleSchema, StateManagementSchema, TEMPLATE_VALUES, TestingSchema, UILibrarySchema, ValidationSchema, VectorDbSchema, VersionChannelSchema, WebDeploySchema, analyzeStackCompatibility, evaluateCompatibility, formatStackPartSpec, getCategoryOrderForEcosystem, legacyProjectConfigToStackParts, parseStackPartSpecs, stackPartsToLegacyProjectConfigPartial } from "@better-fullstack/types";
 import { tmpdir } from "node:os";
 import { EMBEDDED_TEMPLATES, generateVirtualProject } from "@better-fullstack/template-generator";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -43,7 +44,8 @@ const NON_STACK_UPDATE_CREATE_KEYS = new Set([
 	"directoryConflict",
 	"renderTitle",
 	"disableAnalytics",
-	"manualDb"
+	"manualDb",
+	"workspaceShape"
 ]);
 const SUPPORTED_STACK_UPDATE_KEYS = Object.keys(CreateCommandOptionsSchema.shape).filter((key) => !NON_STACK_UPDATE_CREATE_KEYS.has(key)).sort();
 const SUPPORTED_STACK_UPDATE_KEY_SET = new Set(SUPPORTED_STACK_UPDATE_KEYS);
@@ -51,8 +53,17 @@ const IGNORED_REQUEST_KEYS = new Set([
 	"projectDir",
 	"projectName",
 	"install",
-	"git"
+	"git",
+	"acknowledgeArchitectureChange"
 ]);
+const RISKY_ARCHITECTURE_KEYS = [
+	"database",
+	"orm",
+	"auth",
+	"api",
+	"backend",
+	"runtime"
+];
 const PACKAGE_JSON_SECTIONS = [
 	"dependencies",
 	"devDependencies",
@@ -193,6 +204,18 @@ function getUpdatedSpecForChangedPart(part, parts, proposedConfig, changedKeys)
 		}, parts);
 	}
 }
+function pruneScopedSpecsWithoutOwners(specs) {
+	const primaryRoles = /* @__PURE__ */ new Set();
+	for (const spec of specs) {
+		const rolePath = spec.split(":")[0];
+		if (rolePath && !rolePath.includes(".")) primaryRoles.add(rolePath);
+	}
+	return specs.filter((spec) => {
+		const rolePath = spec.split(":")[0];
+		const ownerRole = rolePath?.split(".")[0];
+		return !rolePath?.includes(".") || ownerRole !== void 0 && primaryRoles.has(ownerRole);
+	});
+}
 function mergeDerivedStackPartsWithExistingGraph(currentConfig, proposedConfig) {
 	const currentStackParts = currentConfig.stackParts?.length ? currentConfig.stackParts : (0, types_exports.legacyProjectConfigToStackParts)(currentConfig);
 	const derivedStackParts = (0, types_exports.legacyProjectConfigToStackParts)(proposedConfig);
@@ -210,21 +233,82 @@ function mergeDerivedStackPartsWithExistingGraph(currentConfig, proposedConfig)
 		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 coveredSpecs = pruneScopedSpecsWithoutOwners([...new Set([...preservedSpecs, ...updatedSpecs])]);
+	const coveredParts = (0, types_exports.parseStackPartSpecs)(coveredSpecs, "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])];
+	const nextSpecs = [...coveredSpecs];
 	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");
+	return (0, types_exports.parseStackPartSpecs)(pruneScopedSpecsWithoutOwners([...new Set(nextSpecs)]), "selected");
 }
 function asString(value, fallback = "none") {
 	return typeof value === "string" ? value : fallback;
 }
+function computeArchitectureChanges(currentConfig, proposedConfig) {
+	const changes = [];
+	for (const key of RISKY_ARCHITECTURE_KEYS) {
+		const from = asString(currentConfig[key]);
+		const to = asString(proposedConfig[key]);
+		if (from !== "none" && from !== to) changes.push({
+			key,
+			from,
+			to
+		});
+	}
+	return changes;
+}
+function buildMigrationSteps(changes) {
+	const steps = [];
+	for (const { key, from, to } of changes) {
+		const label = `${key} (${from} -> ${to})`;
+		switch (key) {
+			case "database":
+				steps.push(`${label}: Back up all existing data from the ${from} database before making changes.`, `${label}: Provision a ${to} database and update DATABASE_URL in .env and .env.example.`, `${label}: Regenerate the schema for ${to} and create + run an initial migration.`, `${label}: Export rows from ${from} and import them into ${to} (data is NOT migrated automatically).`);
+				break;
+			case "orm":
+				steps.push(`${label}: Re-author the database schema/models using ${to} conventions.`, `${label}: Regenerate the ${to} client and create an initial ${to} migration.`, `${label}: Port existing ${from} queries and migration history to ${to}, then remove ${from} artifacts.`);
+				break;
+			case "auth":
+				steps.push(`${label}: Migrate existing user/account records into the ${to} schema.`, `${label}: Invalidate current sessions and update auth secrets/env vars for ${to}.`, `${label}: Update sign-in/sign-up flows and protected routes to use ${to}.`);
+				break;
+			case "api":
+				steps.push(`${label}: Port server routers/handlers from ${from} to ${to}.`, `${label}: Update client call sites and generated types to the ${to} client.`);
+				break;
+			case "backend":
+				steps.push(`${label}: Port the server entrypoint, routes, and middleware from ${from} to ${to}.`, `${label}: Reconcile runtime and deploy configuration for the ${to} server.`);
+				break;
+			case "runtime":
+				steps.push(`${label}: Update the runtime toolchain, scripts, and deploy target for ${to}.`, `${label}: Verify runtime-specific APIs and environment bindings behave correctly on ${to}.`);
+				break;
+			default: steps.push(`${label}: Review and migrate affected code manually.`);
+		}
+	}
+	return steps;
+}
+async function writeMigrationChecklist(projectDir, plan) {
+	if (plan.architectureChanges.length === 0 || plan.migrationSteps.length === 0) return;
+	const migrationPath = path.join(projectDir, "MIGRATION.md");
+	const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+	const swaps = plan.architectureChanges.map((change) => `\`${change.key}\`: \`${change.from}\` -> \`${change.to}\``).join(", ");
+	const section = [
+		`## Architecture change - ${timestamp}`,
+		"",
+		`Swapped: ${swaps}`,
+		"",
+		"Data and schema are NOT migrated automatically. Complete these steps manually:",
+		"",
+		...plan.migrationSteps.map((step) => `- [ ] ${step}`)
+	].join("\n");
+	if (await fs.pathExists(migrationPath)) {
+		const existing = (await fs.readFile(migrationPath, "utf-8")).trimEnd();
+		await fs.writeFile(migrationPath, `${existing}\n\n${section}\n`, "utf-8");
+	} else await fs.writeFile(migrationPath, `# Migration checklist\n\n${section}\n`, "utf-8");
+}
 function asStringArray(value) {
 	return Array.isArray(value) ? value.filter((item) => typeof item === "string") : [];
 }
@@ -304,6 +388,13 @@ function getDefaultNativeFrontendForRequestedUpdate(requestedChanges) {
 	if (requestedChanges.mobileUI === "uniwind" || requestedChanges.mobileUI === "unistyles") return;
 	return hasRequestedNonNoneValue(requestedChanges, "mobileNavigation") || hasRequestedNonNoneValue(requestedChanges, "mobileUI") || hasRequestedNonNoneValue(requestedChanges, "mobileStorage") || hasRequestedNonNoneValue(requestedChanges, "mobileTesting") || hasRequestedNonNoneValue(requestedChanges, "mobilePush") || hasRequestedNonNoneValue(requestedChanges, "mobileOTA") || hasRequestedNonNoneValue(requestedChanges, "mobileDeepLinking") ? "native-bare" : void 0;
 }
+function hasSelectedTypeScriptBackendPart(config) {
+	return config.stackParts?.some((part) => part.source !== "provided" && !part.ownerPartId && part.role === "backend" && part.ecosystem === "typescript" && part.toolId !== "none") ?? false;
+}
+function getCompatibilityEcosystem(config) {
+	if (config.ecosystem === "react-native" && hasSelectedTypeScriptBackendPart(config)) return "typescript";
+	return config.ecosystem;
+}
 function buildCompatibilityInputFromConfig(config) {
 	const frontend = asStringArray(config.frontend);
 	const addons = asStringArray(config.addons);
@@ -319,7 +410,7 @@ function buildCompatibilityInputFromConfig(config) {
 		else if (addon !== "none") appPlatforms.push(addon);
 	}
 	return {
-		ecosystem: config.ecosystem,
+		ecosystem: getCompatibilityEcosystem(config),
 		projectName: config.projectName ?? null,
 		webFrontend,
 		nativeFrontend,
@@ -372,6 +463,7 @@ function buildCompatibilityInputFromConfig(config) {
 		documentation,
 		appPlatforms,
 		packageManager: asString(config.packageManager, "bun"),
+		workspaceShape: asString(config.workspaceShape, "monorepo"),
 		versionChannel: asString(config.versionChannel, "stable"),
 		examples: asStringArray(config.examples),
 		aiSdk: asString(config.ai),
@@ -422,6 +514,7 @@ function buildCompatibilityInputFromConfig(config) {
 		goCaching: asString(config.goCaching),
 		goConfig: asString(config.goConfig),
 		goObservability: asString(config.goObservability),
+		javaLanguage: asString(config.javaLanguage, "java"),
 		javaWebFramework: asString(config.javaWebFramework),
 		javaBuildTool: asString(config.javaBuildTool),
 		javaOrm: asString(config.javaOrm),
@@ -599,6 +692,16 @@ function applyKnownDependencyExpansions(config, requestedChanges) {
 			adjustments.push("examples: AI SDK set to 'vercel-ai' (Chat SDK profile requires Vercel AI)");
 		}
 	}
+	if (next.backend === "effect") {
+		if (next.effect !== "effect-full" && !requestedKeys.has("effect")) {
+			next.effect = "effect-full";
+			adjustments.push("effect: Effect services set to 'effect-full' (Effect backend requires Effect Platform + SQL)");
+		}
+		if (next.validation !== "effect-schema" && !requestedKeys.has("validation")) {
+			next.validation = "effect-schema";
+			adjustments.push("validation: Validation set to 'effect-schema' (Effect backend requires Effect Schema)");
+		}
+	}
 	return {
 		config: next,
 		adjustments
@@ -1037,6 +1140,8 @@ async function planStackUpdate(projectDirInput, input) {
 		proposedConfig: normalizedProposedConfig
 	});
 	const graphPreview = getGraphPreview(persistedProposedConfig);
+	const architectureChanges = computeArchitectureChanges(currentConfig, proposedConfig);
+	const migrationSteps = buildMigrationSteps(architectureChanges);
 	return {
 		success: true,
 		projectDir,
@@ -1049,6 +1154,9 @@ async function planStackUpdate(projectDirInput, input) {
 		scriptChanges,
 		envChanges,
 		manualReviewBlockers,
+		architectureChanges,
+		migrationSteps,
+		requiresArchitectureAck: architectureChanges.length > 0,
 		operations,
 		installCommand: getInstallCommand$1(normalizedProposedConfig),
 		compatibilityAdjustments,
@@ -1063,6 +1171,16 @@ async function applyStackUpdate(projectDirInput, input) {
 		projectDir: plan.projectDir,
 		error: `Manual review required before applying stack update: ${plan.manualReviewBlockers.join("; ")}`
 	};
+	const acknowledgeArchitectureChange = input.acknowledgeArchitectureChange === true;
+	if (plan.requiresArchitectureAck && !acknowledgeArchitectureChange) {
+		const swaps = plan.architectureChanges.map((change) => `${change.key}: ${change.from} -> ${change.to}`).join("; ");
+		const checklist = plan.migrationSteps.map((step) => `  - ${step}`).join("\n");
+		return {
+			success: false,
+			projectDir: plan.projectDir,
+			error: `This architecture change requires acknowledgment before it can be applied. It replaces existing architecture-defining choices (${swaps}); data and schema are NOT migrated automatically. Re-run with acknowledgeArchitectureChange: true (MCP) or --acknowledge-architecture-change (CLI) after reviewing the migration checklist:\n${checklist}`
+		};
+	}
 	const projectName = await inferProjectName(plan.projectDir);
 	const proposedConfig = configFromBtsConfig(plan.proposedConfig, plan.projectDir, projectName);
 	const proposedTree = await generateTree(proposedConfig);
@@ -1078,6 +1196,7 @@ async function applyStackUpdate(projectDirInput, input) {
 		version: plan.proposedConfig.version,
 		createdAt: plan.proposedConfig.createdAt
 	});
+	await writeMigrationChecklist(plan.projectDir, plan);
 	return plan;
 }
 
@@ -1326,6 +1445,7 @@ const MCP_COMPATIBILITY_DEFAULTS = {
 	mobilePush: "none",
 	mobileOTA: "none",
 	packageManager: "bun",
+	workspaceShape: "monorepo",
 	versionChannel: "stable",
 	examples: [],
 	aiSdk: "none",
@@ -1376,6 +1496,7 @@ const MCP_COMPATIBILITY_DEFAULTS = {
 	goCaching: "none",
 	goConfig: "none",
 	goObservability: "none",
+	javaLanguage: "java",
 	javaWebFramework: "spring-boot",
 	javaBuildTool: "maven",
 	javaOrm: "none",
@@ -1465,6 +1586,7 @@ function buildProjectConfig(input, overrides) {
 		const stackParts = parseStackPartSpecs(input.part.filter((part) => typeof part === "string"), "selected");
 		Object.assign(config, stackPartsToLegacyProjectConfigPartial(stackParts), { stackParts });
 	}
+	applyEffectBackendDefaults(config, new Set(Object.keys(input)));
 	return config;
 }
 function sanitizePath(input) {
@@ -1487,7 +1609,7 @@ function buildCompatibilityInput(input) {
 		...documentation,
 		"none"
 	].includes(a));
-	return {
+	const result = {
 		ecosystem,
 		projectName: input.projectName ?? null,
 		webFrontend,
@@ -1500,6 +1622,11 @@ function buildCompatibilityInput(input) {
 		appPlatforms,
 		aiSdk: input.ai ?? defaults.aiSdk
 	};
+	if (result.backend === "effect") {
+		if (input.effect === void 0) result.backendLibraries = "effect-full";
+		if (input.validation === void 0) result.validation = "effect-schema";
+	}
+	return result;
 }
 function summarizeTree(tree) {
 	const paths = [];
@@ -1534,6 +1661,7 @@ const COMPATIBILITY_RULES_MD = `# Better-Fullstack Compatibility Rules
 
 ## Backend Constraints
 - **Convex**: Forces runtime=none, database=none, orm=none, api=none, dbSetup=none, serverDeploy=none. Removes incompatible frontends (Solid, SolidStart, Astro).
+- **Effect backend**: Requires effect=effect-full and validation=effect-schema. Other compatible frontend/backend-adjacent tools can still be selected.
 - **No backend (none)**: Clears auth, payments, database, orm, api, serverDeploy, search, fileStorage.
 - **Fullstack (backend='self')**: Sets runtime=none, serverDeploy=none. Only works with: next, vinext, tanstack-start, astro, nuxt, svelte, solid-start.
 
@@ -1734,6 +1862,13 @@ const stackUpdateOutputSchema = {
 	scriptChanges: z.record(z.string(), z.array(z.string())).optional(),
 	envChanges: z.record(z.string(), z.array(z.string())).optional(),
 	manualReviewBlockers: z.array(z.string()).optional(),
+	architectureChanges: z.array(z.object({
+		key: z.string(),
+		from: z.string(),
+		to: z.string()
+	})).optional(),
+	migrationSteps: z.array(z.string()).optional(),
+	requiresArchitectureAck: z.boolean().optional(),
 	compatibilityAdjustments: z.array(z.string()).optional(),
 	compatibilityWarnings: z.array(z.string()).optional(),
 	installCommand: z.string().optional(),
@@ -1989,6 +2124,7 @@ const crossEcosystemInputSchema = {
 	goCaching: GoCachingSchema.optional().describe("Go caching library"),
 	goConfig: GoConfigSchema.optional().describe("Go config management"),
 	goObservability: GoObservabilitySchema.optional().describe("Go observability"),
+	javaLanguage: JavaLanguageSchema.optional().describe("JVM language (java, kotlin)"),
 	javaWebFramework: JavaWebFrameworkSchema.optional().describe("Java web framework"),
 	javaBuildTool: JavaBuildToolSchema.optional().describe("Java build tool"),
 	javaOrm: JavaOrmSchema.optional().describe("Java ORM"),
@@ -2071,7 +2207,7 @@ const MCP_PLAN_CREATE_SCHEMA = {
 	...mobileInputSchema,
 	fileUpload: FileUploadSchema.optional().describe("File upload"),
 	...deploymentInputSchema,
-	effect: EffectSchema.optional().describe("Effect ecosystem (effect, effect-full)"),
+	effect: EffectSchema.optional().describe("Effect services (effect, effect-full)"),
 	analytics: AnalyticsSchema.optional().describe("Privacy-focused analytics provider"),
 	astroIntegration: AstroIntegrationSchema.optional().describe("Astro UI framework integration (react, vue, svelte, solid)"),
 	aiDocs: z.array(AiDocsSchema).optional().describe("AI documentation files (claude-md, agents-md, cursorrules)"),
@@ -2080,7 +2216,8 @@ const MCP_PLAN_CREATE_SCHEMA = {
 };
 const MCP_STACK_UPDATE_SCHEMA = {
 	...MCP_PLAN_CREATE_SCHEMA,
-	projectDir: z.string().describe("Absolute path to the existing Better-Fullstack project")
+	projectDir: z.string().describe("Absolute path to the existing Better-Fullstack project"),
+	acknowledgeArchitectureChange: z.boolean().optional().describe("Acknowledge that this update replaces an existing database/orm/auth/api/backend/runtime choice. Required to apply architecture-changing updates; data and schema are NOT migrated automatically.")
 };
 async function startMcpServer() {
 	const server = new McpServer({
@@ -2393,7 +2530,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-DyMm42a5.mjs");
+				const { setupAddons } = await import("./addons-setup-DEPfsn6z.mjs");
 				addonWarnings = await setupAddons(config);
 			}
 			const installCmd = getInstallCommand(input.ecosystem ?? "typescript", projectName, input.packageManager, input.javaBuildTool, input.javaWebFramework);
@@ -2455,7 +2592,7 @@ async function startMcpServer() {
 				...safePlan,
 				...plan.compatibilityAdjustments.length > 0 ? { compatibilityAdjustments: plan.compatibilityAdjustments } : {},
 				...compatibilityWarnings ? { compatibilityWarnings } : {},
-				message: plan.manualReviewBlockers.length > 0 ? "Plan created, but manual review is required before applying." : `Plan created. If approved, call bfs_apply_stack_update, then run: ${plan.installCommand}`
+				message: plan.manualReviewBlockers.length > 0 ? "Plan created, but manual review is required before applying." : plan.requiresArchitectureAck ? `Plan created. This is an architecture change (${plan.architectureChanges.map((change) => `${change.key}: ${change.from} -> ${change.to}`).join("; ")}); data and schema are NOT migrated automatically. Review migrationSteps, then call bfs_apply_stack_update with acknowledgeArchitectureChange: true, then run: ${plan.installCommand}` : `Plan created. If approved, call bfs_apply_stack_update, then run: ${plan.installCommand}`
 			};
 			return {
 				content: [{
@@ -2718,4 +2855,4 @@ async function startMcpServer() {
 startMcpServer();
 
 //#endregion
-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 };
+export { startMcpServer as a, formatGeneratedTree as c, treeToFileMap as d, recommendStackFromBrief as i, generateTree as l, MCP_STACK_UPDATE_SCHEMA as n, applyStackUpdate as o, getMcpGraphPreview as r, configFromBtsConfig as s, MCP_PLAN_CREATE_SCHEMA as t, planStackUpdate as u };