create-better-fullstack 2.1.5 → 2.1.7

package/dist/mcp-entry.mjs

@@ -1,11 +1,15 @@
 #!/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 { b as types_exports, d as getGraphSummary, m as getLatestCLIVersion, n as previewBtsConfigUpdate, o as writeBtsConfig, r as readBtsConfig, s as getEffectiveStack, t as buildBtsConfigForPersistence, v as getDefaultConfig } from "./bts-config-DQVWvPDs.mjs";
+import "./errors-ns_o2OKg.mjs";
+import "./prompt-environment-BR0Kkw2W.mjs";
+import { a as trackProjectCreation, i as trackEvent } from "./analytics-DVltG11u.mjs";
+import { r as validateConfigForProgrammaticUse, t as formatCode, v as CreateCommandOptionsSchema } from "./file-formatter-gvmrpd-g.mjs";
+import { a as getTemplateConfig, o as getTemplateDescription, s as generateReproducibleCommand, t as applyEffectBackendDefaults } from "./config-processing-D9-F2Us9.mjs";
+import { o as refreshScaffoldManifestFiles } from "./scaffold-manifest-Dyi0voqE.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 +47,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 +56,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 +207,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 +236,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 +391,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 +413,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 +466,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 +517,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 +695,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 +1143,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 +1157,9 @@ async function planStackUpdate(projectDirInput, input) {
 		scriptChanges,
 		envChanges,
 		manualReviewBlockers,
+		architectureChanges,
+		migrationSteps,
+		requiresArchitectureAck: architectureChanges.length > 0,
 		operations,
 		installCommand: getInstallCommand$1(normalizedProposedConfig),
 		compatibilityAdjustments,
@@ -1063,6 +1174,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 +1199,8 @@ async function applyStackUpdate(projectDirInput, input) {
 		version: plan.proposedConfig.version,
 		createdAt: plan.proposedConfig.createdAt
 	});
+	await refreshScaffoldManifestFiles(plan.projectDir, plan.operations.map((operation) => operation.path));
+	await writeMigrationChecklist(plan.projectDir, plan);
 	return plan;
 }
 
@@ -1326,6 +1449,7 @@ const MCP_COMPATIBILITY_DEFAULTS = {
 	mobilePush: "none",
 	mobileOTA: "none",
 	packageManager: "bun",
+	workspaceShape: "monorepo",
 	versionChannel: "stable",
 	examples: [],
 	aiSdk: "none",
@@ -1376,6 +1500,7 @@ const MCP_COMPATIBILITY_DEFAULTS = {
 	goCaching: "none",
 	goConfig: "none",
 	goObservability: "none",
+	javaLanguage: "java",
 	javaWebFramework: "spring-boot",
 	javaBuildTool: "maven",
 	javaOrm: "none",
@@ -1465,6 +1590,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 +1613,7 @@ function buildCompatibilityInput(input) {
 		...documentation,
 		"none"
 	].includes(a));
-	return {
+	const result = {
 		ecosystem,
 		projectName: input.projectName ?? null,
 		webFrontend,
@@ -1500,6 +1626,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 +1665,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 +1866,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 +2128,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 +2211,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 +2220,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({
@@ -2365,6 +2506,7 @@ async function startMcpServer() {
 			openWorldHint: false
 		}
 	}, async (input) => {
+		const startTime = Date.now();
 		try {
 			const { generateVirtualProject: generateVirtualProject$1, EMBEDDED_TEMPLATES: EMBEDDED_TEMPLATES$1 } = await import("@better-fullstack/template-generator");
 			const { writeTreeToFilesystem: writeTreeToFilesystem$1 } = await import("@better-fullstack/template-generator/fs-writer");
@@ -2378,25 +2520,41 @@ async function startMcpServer() {
 				config,
 				templates: EMBEDDED_TEMPLATES$1
 			});
-			if (!result.success || !result.tree) return {
-				content: [{
-					type: "text",
-					text: JSON.stringify({
-						success: false,
-						error: result.error ?? "Generation failed"
-					})
-				}],
-				isError: true
-			};
+			if (!result.success || !result.tree) {
+				await trackProjectCreation(config, false, {
+					source: "mcp",
+					success: false,
+					errorName: "GenerationFailed",
+					durationMs: Date.now() - startTime
+				});
+				return {
+					content: [{
+						type: "text",
+						text: JSON.stringify({
+							success: false,
+							error: result.error ?? "Generation failed"
+						})
+					}],
+					isError: true
+				};
+			}
 			await writeTreeToFilesystem$1(result.tree, projectDir);
 			await writeBtsConfig(config);
 			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-DnLjAzTw.mjs");
 				addonWarnings = await setupAddons(config);
 			}
+			const { recordScaffoldManifest } = await import("./scaffold-manifest-DGRyepdb.mjs");
+			await recordScaffoldManifest(projectDir);
 			const installCmd = getInstallCommand(input.ecosystem ?? "typescript", projectName, input.packageManager, input.javaBuildTool, input.javaWebFramework);
+			await trackProjectCreation(config, false, {
+				source: "mcp",
+				success: true,
+				fileCount: result.tree.fileCount,
+				durationMs: Date.now() - startTime
+			});
 			const payload = {
 				success: true,
 				projectDirectory: projectDir,
@@ -2413,6 +2571,12 @@ async function startMcpServer() {
 				structuredContent: payload
 			};
 		} catch (error) {
+			await trackEvent("project_created", {}, {
+				source: "mcp",
+				success: false,
+				errorName: error instanceof Error ? error.name : "UnknownError",
+				durationMs: Date.now() - startTime
+			});
 			return {
 				content: [{
 					type: "text",
@@ -2455,7 +2619,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: [{
@@ -2492,10 +2656,15 @@ async function startMcpServer() {
 			openWorldHint: false
 		}
 	}, async (input) => {
+		const startTime = Date.now();
+		const { projectDir: _projectDir, projectName: _projectName, ...requestedChanges } = input;
 		try {
-			const safePath = sanitizePath(input.projectDir);
-			const { projectDir: _projectDir, projectName: _projectName, ...requestedChanges } = input;
-			const result = await applyStackUpdate(safePath, requestedChanges);
+			const result = await applyStackUpdate(sanitizePath(input.projectDir), requestedChanges);
+			await trackEvent("stack_updated", requestedChanges, {
+				source: "mcp",
+				success: result.success,
+				durationMs: Date.now() - startTime
+			});
 			if (!result.success) return {
 				content: [{
 					type: "text",
@@ -2520,6 +2689,12 @@ async function startMcpServer() {
 				structuredContent: payload
 			};
 		} catch (error) {
+			await trackEvent("stack_updated", requestedChanges, {
+				source: "mcp",
+				success: false,
+				errorName: error instanceof Error ? error.name : "UnknownError",
+				durationMs: Date.now() - startTime
+			});
 			const payload = {
 				success: false,
 				projectDir: input.projectDir,
@@ -2648,7 +2823,7 @@ async function startMcpServer() {
 				projectDir: safePath,
 				install: false,
 				packageManager: input.packageManager
-			});
+			}, { telemetrySource: "mcp" });
 			if (result?.success) {
 				const existingConfig = await readBtsConfig(safePath);
 				const graphPreview = existingConfig ? getMcpGraphPreview(existingConfig) : void 0;
@@ -2718,4 +2893,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 };

package/dist/prompt-environment-BR0Kkw2W.mjs

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+import { c as isSilent } from "./errors-ns_o2OKg.mjs";
+
+//#region src/utils/prompt-environment.ts
+function hasOwnProperty(value, property) {
+	return Object.prototype.hasOwnProperty.call(value, property);
+}
+function resolveCiValue(environment) {
+	if (environment && hasOwnProperty(environment, "ci")) return environment.ci;
+	return process.env.CI;
+}
+function isCiEnvironment(value) {
+	if (!value) return false;
+	const normalizedValue = value.trim().toLowerCase();
+	return normalizedValue !== "" && normalizedValue !== "0" && normalizedValue !== "false";
+}
+function canPromptInteractively(environment = {}) {
+	const silent = environment.silent ?? isSilent();
+	const stdinIsTTY = environment.stdinIsTTY ?? process.stdin.isTTY === true;
+	const stdoutIsTTY = environment.stdoutIsTTY ?? process.stdout.isTTY === true;
+	const ci = resolveCiValue(environment);
+	return !silent && stdinIsTTY && stdoutIsTTY && !isCiEnvironment(ci);
+}
+
+//#endregion
+export { canPromptInteractively as t };