@prisma/cli 3.0.0-dev.87.1 → 3.0.0-dev.88.1

package/dist/controllers/app.js

@@ -10,11 +10,13 @@ import { buildProjectSetupNextActions, inferTargetName, projectNotFoundError, pr
 import { bindProjectToDirectory, projectCreateFailedError, projectDirectoryBindingErrorToCliError, projectSetupNameRequiredError, resolveProjectForSetup, toProjectSummary } from "../lib/project/setup.js";
 import { maybeSetupBranchDatabase } from "../lib/app/branch-database-deploy.js";
 import { readBunPackageEntrypoint, readBunPackageJson } from "../lib/app/bun-project.js";
+import { COMPUTE_CONFIG_FILENAME as COMPUTE_CONFIG_FILENAME$1, ComputeConfigTargetRequiredError, computeConfigErrorToCliError, computeFrameworkToBuildType, computeTargetAppDir, inferComputeTargetFromCwd, loadComputeConfig as loadComputeConfig$1, mergeComputeDeployInputs, mergeComputeLocalInputs, selectComputeDeployTarget } from "../lib/app/compute-config.js";
 import { renderDeployOutputRows, renderDeploySettingsPreview } from "../lib/app/deploy-output.js";
+import { describeDeployAllFailure, perAppInputsForDeployAll, planAppDeploy } from "../lib/app/deploy-plan.js";
 import { formatDomainFailureFix } from "../lib/app/domain-guidance.js";
 import { envVarNames, parseEnvInputs } from "../lib/app/env-vars.js";
-import { DEFAULT_LOCAL_DEV_PORT, resolveLocalBuildType, runLocalApp } from "../lib/app/local-dev.js";
-import { resolveOrCreatePreviewBuildSettings } from "../lib/app/preview-build-settings.js";
+import { DEFAULT_LOCAL_DEV_PORT, runLocalApp } from "../lib/app/local-dev.js";
+import { PRISMA_APP_CONFIG_FILENAME, detectLegacyBuildSettings, resolveConfiguredPreviewBuildSettings, resolveInferredPreviewBuildSettings } from "../lib/app/preview-build-settings.js";
 import { PREVIEW_BUILD_TYPES, RESOLVED_PREVIEW_BUILD_TYPES, executePreviewBuild } from "../lib/app/preview-build.js";
 import { PREVIEW_DEFAULT_REGION } from "../lib/app/preview-interaction.js";
 import { createPreviewDeployProgress, createPreviewDeployProgressState, createPreviewPromoteProgress } from "../lib/app/preview-progress.js";
@@ -28,32 +30,49 @@ import { writeJsonEvent } from "../shell/output.js";
 import { createSelectPromptPort } from "./select-prompt-port.js";
 import { requireAuthenticatedAuthState } from "./auth.js";
 import { listRealWorkspaceProjects } from "./project.js";
+import { ENTRYPOINT_BUILD_TYPES, FRAMEWORKS, LOCAL_DEV_BUILD_TYPES, frameworkByKey, frameworkFromAlias, isConfigBackedBuildType } from "@prisma/compute-sdk/config";
 import { access, readFile } from "node:fs/promises";
 import path from "node:path";
 import { Result, matchError } from "better-result";
 import open from "open";
 //#region src/controllers/app.ts
-const DEPLOY_FRAMEWORKS = [
-	"nextjs",
-	"hono",
-	"tanstack-start",
-	"bun"
-];
-const TANSTACK_START_PACKAGES = ["@tanstack/react-start", "@tanstack/solid-start"];
 const FRAMEWORK_DEFAULT_HTTP_PORT = 3e3;
 const PRISMA_PROJECT_ID_ENV_VAR = "PRISMA_PROJECT_ID";
 const PRISMA_APP_ID_ENV_VAR = "PRISMA_APP_ID";
 function isRealMode(context) {
 	return !context.runtime.fixturePath && !context.runtime.env.PRISMA_CLI_MOCK_FIXTURE_PATH;
 }
-async function runAppBuild(context, entrypoint, requestedBuildType) {
-	const buildType = normalizeBuildType(requestedBuildType);
-	assertSupportedEntrypoint(buildType, entrypoint, "build");
+async function runAppBuild(context, options) {
+	const compute = await resolveComputeTargetOrThrow(context, options?.configTarget, "build");
+	const merged = mergeComputeLocalInputs({
+		cli: {
+			entrypoint: options?.entrypoint,
+			buildType: options?.buildType
+		},
+		target: compute.target
+	});
+	const appDir = await resolveComputeAppDir(context, compute);
+	let buildType = normalizeBuildType(merged.buildType);
+	if (compute.target?.build && buildType === "auto") {
+		const detected = await detectDeployFramework(appDir, context.runtime.signal);
+		if (!detected) throw frameworkNotDetectedError(appDir);
+		buildType = detected.buildType;
+	}
+	assertSupportedEntrypoint(buildType, merged.entrypoint, "build");
+	if (compute.target?.build && buildType !== "auto") assertConfigBackedBuildSettings(buildType);
+	const buildSettings = compute.config && compute.target?.build && isConfigBackedBuildType(buildType) ? (await resolveConfiguredPreviewBuildSettings({
+		appPath: appDir,
+		buildType,
+		configured: compute.target.build,
+		configPath: compute.config.configPath,
+		signal: context.runtime.signal
+	})).settings : void 0;
 	try {
 		const { artifact, buildType: actualBuildType } = await executePreviewBuild({
-			appPath: context.runtime.cwd,
-			entrypoint,
+			appPath: appDir,
+			entrypoint: merged.entrypoint,
 			buildType,
+			buildSettings,
 			signal: context.runtime.signal
 		});
 		return {
@@ -71,17 +90,33 @@ async function runAppBuild(context, entrypoint, requestedBuildType) {
 		throw buildFailedError("Local app build failed", error);
 	}
 }
-async function runAppRun(context, entrypoint, requestedBuildType, requestedPort) {
+async function runAppRun(context, options) {
 	if (context.flags.json) throw usageError("App run does not support --json", "This command streams the framework dev server directly and cannot return structured JSON.", "Rerun without --json to pass framework logs through directly.", ["prisma-cli app run"], "app");
-	const buildType = normalizeBuildType(requestedBuildType);
-	assertSupportedEntrypoint(buildType, entrypoint, "run");
-	const port = parseLocalPort(requestedPort);
-	const resolvedBuildType = await requireLocalBuildType(context, buildType, "run");
+	const compute = await resolveComputeTargetOrThrow(context, options?.configTarget, "run");
+	const merged = mergeComputeLocalInputs({
+		cli: {
+			entrypoint: options?.entrypoint,
+			buildType: options?.buildType,
+			port: options?.port
+		},
+		target: compute.target
+	});
+	if (merged.buildTypeFromConfig && compute.target?.framework && !frameworkByKey(compute.target.framework).hasLocalDevServer) throw usageError(`App run does not support the ${compute.target?.framework} framework yet`, `${compute.config?.relativeConfigPath ?? COMPUTE_CONFIG_FILENAME$1} sets a framework that has no local dev server in the current preview.`, "Run the framework dev server directly, or pass --build-type nextjs or --build-type bun to override.", ["prisma-cli app run --build-type nextjs", "prisma-cli app run --build-type bun --entry server.ts"], "app");
+	const appDir = await resolveComputeAppDir(context, compute);
+	const buildType = normalizeBuildType(merged.buildType);
+	assertSupportedEntrypoint(buildType, merged.entrypoint, "run");
+	const port = parseLocalPort(merged.port);
+	const framework = await resolveLocalRunFramework(context, {
+		requestedBuildType: buildType,
+		configFramework: compute.target?.framework ?? null,
+		appDir
+	});
+	const entrypoint = framework.buildType === "bun" ? await resolveDeployEntrypoint(appDir, framework, merged.entrypoint, context.runtime.signal) : merged.entrypoint;
 	let runResult;
 	try {
 		runResult = await runLocalApp({
-			appPath: context.runtime.cwd,
-			buildType: resolvedBuildType,
+			appPath: appDir,
+			buildType: framework.buildType,
 			entrypoint,
 			port,
 			env: context.runtime.env,
@@ -106,6 +141,106 @@ async function runAppRun(context, entrypoint, requestedBuildType, requestedPort)
 }
 async function runAppDeploy(context, appName, options) {
 	ensurePreviewAppMode(context);
+	const loaded = await loadComputeConfig$1(context.runtime.cwd, context.runtime.signal);
+	if (loaded.isErr()) throw computeConfigErrorToCliError(loaded.error, "deploy");
+	const config = loaded.value;
+	const plan = planAppDeploy({
+		config,
+		requestedTarget: options?.configTarget ?? (config ? inferComputeTargetFromCwd(config, context.runtime.cwd) : void 0),
+		hasCreateProject: options?.createProjectName !== void 0
+	});
+	if (plan.mode === "all") return runAppDeployAll(context, config, plan.targets, appName, options);
+	return runSingleAppDeploy(context, appName, options, config);
+}
+async function runAppDeployAll(context, config, plannedTargets, appName, options) {
+	assertNoPerAppInputsForDeployAll(context, config, appName, options);
+	const deployments = [];
+	const warnings = [];
+	for (const planned of plannedTargets) {
+		maybeRenderDeployAllTargetHeader(context, planned);
+		const targetOptions = {
+			...options,
+			configTarget: planned.targetKey,
+			createProjectName: planned.bindsCreateProject ? options?.createProjectName : void 0
+		};
+		try {
+			const single = await runSingleAppDeploy(context, void 0, targetOptions, config);
+			deployments.push({
+				target: planned.targetKey,
+				result: single.result
+			});
+			warnings.push(...single.warnings);
+		} catch (error) {
+			throw deployAllFailedError(error, config, planned.index, deployments);
+		}
+	}
+	return {
+		command: "app.deploy",
+		result: { deployments },
+		warnings,
+		nextSteps: ["prisma-cli app list-deploys <app>"]
+	};
+}
+function assertNoPerAppInputsForDeployAll(context, config, appName, options) {
+	const used = perAppInputsForDeployAll({
+		appName,
+		framework: options?.framework,
+		entrypoint: options?.entrypoint,
+		httpPort: options?.httpPort,
+		envAssignments: options?.envAssignments,
+		appIdEnvVar: {
+			name: PRISMA_APP_ID_ENV_VAR,
+			value: readDeployEnvOverride(context, PRISMA_APP_ID_ENV_VAR)
+		}
+	});
+	if (used.length === 0) return;
+	const targets = config.targets.map((target) => target.key).join(", ");
+	throw usageError(`Deploying all apps does not accept ${used.join(", ")}`, `Without a target, app deploy deploys every configured app (${targets}), so per-app inputs are ambiguous.`, "Pass the app target to apply per-app inputs to one app, or remove them to deploy all apps.", config.targets.map((target) => `prisma-cli app deploy ${target.key}`), "app");
+}
+function maybeRenderDeployAllTargetHeader(context, planned) {
+	if (context.flags.json || context.flags.quiet) return;
+	context.output.stderr.write(`${planned.index > 0 ? "\n" : ""}── ${planned.targetKey} (${planned.index + 1}/${planned.total}) ──\n\n`);
+}
+function deployAllFailedError(error, config, failedIndex, deployments) {
+	if (!(error instanceof CliError)) return error;
+	const failure = describeDeployAllFailure({
+		targetKeys: config.targets.map((target) => target.key),
+		failedIndex,
+		completed: deployments.map(({ target, result }) => ({
+			target,
+			deploymentId: result.deployment.id,
+			url: result.deployment.url
+		}))
+	});
+	const contextSentence = failure.contextLines.join(" ");
+	return new CliError({
+		code: error.code,
+		domain: error.domain,
+		summary: error.summary,
+		why: error.humanLines ? error.why : [error.why, contextSentence].filter(Boolean).join(" "),
+		fix: error.fix,
+		debug: error.debug,
+		where: error.where,
+		meta: {
+			...error.meta,
+			deployAll: {
+				failedTarget: failure.failedTarget,
+				completed: failure.completed,
+				notAttempted: failure.notAttempted
+			}
+		},
+		docsUrl: error.docsUrl,
+		exitCode: error.exitCode,
+		nextSteps: error.nextSteps,
+		nextActions: error.nextActions,
+		humanLines: error.humanLines ? [
+			...error.humanLines,
+			"",
+			...failure.contextLines
+		] : void 0
+	});
+}
+async function runSingleAppDeploy(context, appName, options, preloadedConfig) {
 	const envProjectId = readDeployEnvOverride(context, PRISMA_PROJECT_ID_ENV_VAR);
 	const envAppId = readDeployEnvOverride(context, PRISMA_APP_ID_ENV_VAR);
 	assertExclusiveDeployProjectInputs({
@@ -113,14 +248,27 @@ async function runAppDeploy(context, appName, options) {
 		createProjectName: options?.createProjectName,
 		envProjectId
 	});
-	const localPinReadResult = Boolean(envProjectId || options?.projectRef || options?.createProjectName) ? Result.ok({ kind: "missing" }) : await readLocalResolutionPin(context.runtime.cwd, context.runtime.signal);
+	const computeConfig = await resolveComputeTargetOrThrow(context, options?.configTarget, "deploy", { preloaded: preloadedConfig });
+	const merged = mergeComputeDeployInputs({
+		cli: {
+			framework: options?.framework,
+			entrypoint: options?.entrypoint,
+			httpPort: options?.httpPort,
+			envInputs: options?.envAssignments
+		},
+		target: computeConfig.target,
+		configFilename: computeConfig.config?.relativeConfigPath ?? COMPUTE_CONFIG_FILENAME$1
+	});
+	const appDir = await resolveComputeAppDir(context, computeConfig);
+	const projectDir = computeConfig.config?.configDir ?? context.runtime.cwd;
+	const localPinReadResult = Boolean(envProjectId || options?.projectRef || options?.createProjectName) ? Result.ok({ kind: "missing" }) : await readLocalResolutionPin(projectDir, context.runtime.signal);
 	if (localPinReadResult.isErr()) throw localPinReadErrorToDeployError(localPinReadResult.error);
 	const localPin = localPinReadResult.value;
 	const branch = await resolveDeployBranch(context, options?.branchName);
-	if (options?.httpPort) parseDeployHttpPort(options.httpPort);
+	if (merged.httpPort) parseDeployHttpPort(merged.httpPort.value);
 	assertSupportedEntrypointForRequestedDeployShape({
-		requestedFramework: options?.framework,
-		entrypoint: options?.entrypoint
+		requestedFramework: merged.framework?.value,
+		entrypoint: merged.entrypoint?.value
 	});
 	const { provider, target, projectId } = await requireProviderAndDeployProjectContext(context, options?.projectRef, {
 		branch,
@@ -130,27 +278,32 @@ async function runAppDeploy(context, appName, options) {
 	});
 	let localPinResult;
 	if (target.localPinAction) {
-		const setupResult = await bindProjectToDirectory(context, target.workspace, target.project, target.localPinAction);
+		const setupResult = await bindProjectToDirectory(context, target.workspace, target.project, target.localPinAction, projectDir);
 		if (setupResult.isErr()) throw projectDirectoryBindingErrorToCliError(setupResult.error);
 		const projectSetup = setupResult.value;
 		localPinResult = projectSetup.localPin;
 		maybeRenderProjectLinked(context, projectSetup.directory, projectSetup.project.name, projectSetup.localPin.path);
 	}
 	let framework = await resolveDeployFramework(context, {
-		requestedFramework: options?.framework,
-		entrypoint: options?.entrypoint
-	});
-	let runtime = resolveDeployRuntime(options?.httpPort, framework);
-	assertSupportedEntrypoint(framework.buildType, options?.entrypoint, "deploy");
-	const envVars = toOptionalEnvVars(await parseEnvInputs(context.runtime.cwd, options?.envAssignments, { commandName: "deploy" }));
+		requestedFramework: merged.framework?.value,
+		requestedFrameworkAnnotation: merged.framework?.annotation,
+		entrypoint: merged.entrypoint?.value,
+		entrypointAnnotation: merged.entrypoint?.annotation,
+		appDir
+	});
+	let runtime = resolveDeployRuntime(merged.httpPort?.value, merged.httpPort?.annotation, framework);
+	assertSupportedEntrypoint(framework.buildType, merged.entrypoint?.value, "deploy");
+	const envVars = toOptionalEnvVars(await parseEnvInputs(merged.envInputsFromConfig ? projectDir : context.runtime.cwd, merged.envInputs, { commandName: "deploy" }));
 	const selectedApp = await resolveDeployAppSelection(context, projectId, await listApps(context, provider, projectId, target.branch.name), {
 		explicitAppName: appName,
 		explicitAppId: envAppId,
+		configAppName: merged.configAppName,
 		firstDeploy: Boolean(target.localPinAction),
-		inferName: () => inferTargetName(context.runtime.cwd, context.runtime.signal)
+		inferName: () => inferTargetName(appDir, context.runtime.signal)
 	});
 	await maybeRenderDeploySetupBlock(context, {
 		includeDirectory: !target.localPinAction,
+		appDir,
 		projectName: target.project.name,
 		branchName: target.branch.name,
 		appName: selectedApp.displayName
@@ -159,9 +312,9 @@ async function runAppDeploy(context, appName, options) {
 		framework,
 		runtime,
 		firstDeploy: selectedApp.firstDeploy,
-		explicitFramework: Boolean(options?.framework),
-		explicitEntrypoint: Boolean(options?.entrypoint),
-		explicitHttpPort: Boolean(options?.httpPort)
+		explicitFramework: Boolean(merged.framework),
+		explicitEntrypoint: Boolean(merged.entrypoint),
+		explicitHttpPort: Boolean(merged.httpPort)
 	});
 	framework = customized.framework;
 	runtime = customized.runtime;
@@ -172,24 +325,33 @@ async function runAppDeploy(context, appName, options) {
 		prod: options?.prod === true
 	});
 	const buildType = framework.buildType;
-	assertSupportedEntrypoint(buildType, options?.entrypoint, "deploy");
-	const entrypoint = await resolveDeployEntrypoint(context.runtime.cwd, framework, options?.entrypoint, context.runtime.signal);
-	const buildSettingsResolution = await resolveOrCreatePreviewBuildSettings({
-		appPath: context.runtime.cwd,
+	assertSupportedEntrypoint(buildType, merged.entrypoint?.value, "deploy");
+	const entrypoint = await resolveDeployEntrypoint(appDir, framework, merged.entrypoint?.value, context.runtime.signal);
+	if (computeConfig.target?.build) assertConfigBackedBuildSettings(buildType);
+	const buildSettingsResolution = computeConfig.config && computeConfig.target?.build && isConfigBackedBuildType(buildType) ? await resolveConfiguredPreviewBuildSettings({
+		appPath: appDir,
+		buildType,
+		configured: computeConfig.target.build,
+		configPath: computeConfig.config.configPath,
+		signal: context.runtime.signal
+	}) : await resolveInferredPreviewBuildSettings({
+		appPath: appDir,
 		buildType,
 		signal: context.runtime.signal
 	});
+	const legacyWarnings = await handleLegacyBuildSettings(context, appDir, buildSettingsResolution.settings);
 	maybeRenderDeployBuildSettings(context, buildSettingsResolution);
 	const portMapping = parseDeployPortMapping(String(runtime.port));
 	const branchDatabaseSetup = await maybeSetupBranchDatabase(context, provider, projectId, toBranchDatabaseDeployBranch(target.branch), {
 		db: options?.db,
 		providedEnvVars: envVars,
-		firstProductionDeploy: productionDeployGate.firstProductionDeploy
+		firstProductionDeploy: productionDeployGate.firstProductionDeploy,
+		projectDir
 	});
 	const progressState = createPreviewDeployProgressState();
 	const deployStartedAt = Date.now();
 	const deployResult = await provider.deployApp({
-		cwd: context.runtime.cwd,
+		cwd: appDir,
 		projectId,
 		branchName: target.branch.name,
 		appId: selectedApp.appId,
@@ -252,14 +414,18 @@ async function runAppDeploy(context, appName, options) {
 			durationMs: deployDurationMs,
 			localPin: localPinResult
 		},
-		warnings: branchDatabaseSetup.warnings,
+		warnings: [...legacyWarnings, ...branchDatabaseSetup.warnings],
 		nextSteps: ["prisma-cli app list-deploys", `prisma-cli app show-deploy ${deployResult.deployment.id}`]
 	};
 }
-async function runAppListDeploys(context, appName, projectRef) {
+async function runAppListDeploys(context, appName, projectRef, configTarget) {
 	ensurePreviewAppMode(context);
-	const { provider, target, projectId } = await requireProviderAndProjectContext(context, projectRef, { commandName: "app list-deploys" });
-	const selectedApp = await resolveExistingAppSelection(context, projectId, await listApps(context, provider, projectId, target.branch.name), appName);
+	const compute = await resolveComputeManagementContext(context, configTarget, "list-deploys");
+	const { provider, target, projectId } = await requireProviderAndProjectContext(context, projectRef, {
+		commandName: "app list-deploys",
+		projectDir: compute.projectDir
+	});
+	const selectedApp = await resolveExistingAppSelection(context, projectId, await listApps(context, provider, projectId, target.branch.name), appName ?? compute.configAppName);
 	if (!selectedApp) return {
 		command: "app.list-deploys",
 		result: {
@@ -295,10 +461,14 @@ async function runAppListDeploys(context, appName, projectRef) {
 		nextSteps: deployments.length > 0 ? [`prisma-cli app show-deploy ${deployments[0]?.id}`] : ["prisma-cli app deploy"]
 	};
 }
-async function runAppShow(context, appName, projectRef) {
+async function runAppShow(context, appName, projectRef, configTarget) {
 	ensurePreviewAppMode(context);
-	const { provider, target, projectId } = await requireProviderAndProjectContext(context, projectRef, { commandName: "app show" });
-	const selectedApp = await resolveExistingAppSelection(context, projectId, await listApps(context, provider, projectId, target.branch.name), appName);
+	const compute = await resolveComputeManagementContext(context, configTarget, "show");
+	const { provider, target, projectId } = await requireProviderAndProjectContext(context, projectRef, {
+		commandName: "app show",
+		projectDir: compute.projectDir
+	});
+	const selectedApp = await resolveExistingAppSelection(context, projectId, await listApps(context, provider, projectId, target.branch.name), appName ?? compute.configAppName);
 	if (!selectedApp) return {
 		command: "app.show",
 		result: {
@@ -373,9 +543,14 @@ async function runAppShowDeploy(context, deploymentId) {
 		nextSteps: []
 	};
 }
-async function runAppOpen(context, appName, projectRef) {
+async function runAppOpen(context, appName, projectRef, configTarget) {
 	ensurePreviewAppMode(context);
-	const { provider, target, projectId } = await requireProviderAndProjectContext(context, projectRef, { commandName: "app open" });
+	const compute = await resolveComputeManagementContext(context, configTarget, "open");
+	appName = appName ?? compute.configAppName;
+	const { provider, target, projectId } = await requireProviderAndProjectContext(context, projectRef, {
+		commandName: "app open",
+		projectDir: compute.projectDir
+	});
 	const selectedApp = await resolveExistingAppSelection(context, projectId, await listApps(context, provider, projectId, target.branch.name), appName);
 	if (!selectedApp) throw noDeploymentsError("No deployments available to open", "The resolved project does not have any deployed app yet.");
 	const deploymentsResult = await provider.listDeployments(selectedApp.id, { signal: context.runtime.signal }).catch((error) => {
@@ -539,15 +714,19 @@ async function runAppDomainWait(context, hostname, options) {
 		});
 	}
 }
-async function runAppLogs(context, appName, deploymentId, projectRef) {
+async function runAppLogs(context, appName, deploymentId, projectRef, configTarget) {
 	ensurePreviewAppMode(context);
-	const { provider, target: resolvedTarget, projectId } = await requireProviderAndProjectContext(context, projectRef, { commandName: "app logs" });
+	const compute = await resolveComputeManagementContext(context, configTarget, "logs");
+	appName = appName ?? compute.configAppName;
+	const { provider, target: resolvedTarget, projectId } = await requireProviderAndProjectContext(context, projectRef, {
+		commandName: "app logs",
+		projectDir: compute.projectDir
+	});
 	const target = deploymentId ? await resolveExplicitLogDeployment(context, provider, projectId, resolvedTarget.branch.name, appName, deploymentId) : await resolveLiveLogDeployment(context, provider, projectId, resolvedTarget.branch.name, appName);
 	if (!context.flags.json && !context.flags.quiet) {
 		const lines = renderCommandHeader(context.ui, {
 			commandLabel: "app logs",
 			description: "Streaming logs for the selected deployment.",
-			docsPath: "docs/product/command-spec.md#prisma-cli-app-logs---app-name---deployment-id",
 			rows: [
 				{
 					key: "project",
@@ -664,9 +843,14 @@ function writeLogRecord(context, record) {
 		if (!record.text.endsWith("\n")) context.output.stdout.write("\n");
 	}
 }
-async function runAppPromote(context, deploymentId, appName, projectRef) {
+async function runAppPromote(context, deploymentId, appName, projectRef, configTarget) {
 	ensurePreviewAppMode(context);
-	const { provider, target, projectId } = await requireProviderAndProjectContext(context, projectRef, { commandName: "app promote" });
+	const compute = await resolveComputeManagementContext(context, configTarget, "promote");
+	appName = appName ?? compute.configAppName;
+	const { provider, target, projectId } = await requireProviderAndProjectContext(context, projectRef, {
+		commandName: "app promote",
+		projectDir: compute.projectDir
+	});
 	const selectedApp = await requireReleaseAppSelection(context, projectId, await listApps(context, provider, projectId, target.branch.name), appName, "promote");
 	const deploymentsResult = await provider.listDeployments(selectedApp.id, { signal: context.runtime.signal }).catch((error) => {
 		throw deployFailedError("Failed to list app deployments", error, ["prisma-cli app list-deploys"]);
@@ -706,9 +890,14 @@ async function runAppPromote(context, deploymentId, appName, projectRef) {
 		nextSteps: ["prisma-cli app list-deploys", `prisma-cli app show-deploy ${targetDeployment.id}`]
 	};
 }
-async function runAppRollback(context, appName, deploymentId, projectRef) {
+async function runAppRollback(context, appName, deploymentId, projectRef, configTarget) {
 	ensurePreviewAppMode(context);
-	const { provider, target, projectId } = await requireProviderAndProjectContext(context, projectRef, { commandName: "app rollback" });
+	const compute = await resolveComputeManagementContext(context, configTarget, "rollback");
+	appName = appName ?? compute.configAppName;
+	const { provider, target, projectId } = await requireProviderAndProjectContext(context, projectRef, {
+		commandName: "app rollback",
+		projectDir: compute.projectDir
+	});
 	const selectedApp = await requireReleaseAppSelection(context, projectId, await listApps(context, provider, projectId, target.branch.name), appName, "rollback");
 	const deploymentsResult = await provider.listDeployments(selectedApp.id, { signal: context.runtime.signal }).catch((error) => {
 		throw deployFailedError("Failed to list app deployments", error, ["prisma-cli app list-deploys"]);
@@ -750,9 +939,14 @@ async function runAppRollback(context, appName, deploymentId, projectRef) {
 		nextSteps: ["prisma-cli app list-deploys", `prisma-cli app show-deploy ${targetDeployment.id}`]
 	};
 }
-async function runAppRemove(context, appName, projectRef) {
+async function runAppRemove(context, appName, projectRef, configTarget) {
 	ensurePreviewAppMode(context);
-	const { provider, target, projectId } = await requireProviderAndProjectContext(context, projectRef, { commandName: "app remove" });
+	const compute = await resolveComputeManagementContext(context, configTarget, "remove");
+	appName = appName ?? compute.configAppName;
+	const { provider, target, projectId } = await requireProviderAndProjectContext(context, projectRef, {
+		commandName: "app remove",
+		projectDir: compute.projectDir
+	});
 	const selectedApp = await requireReleaseAppSelection(context, projectId, await listApps(context, provider, projectId, target.branch.name), appName, "remove");
 	await confirmAppRemoval(context, selectedApp);
 	const removedApp = await provider.removeApp(selectedApp.id, { signal: context.runtime.signal }).catch((error) => {
@@ -776,6 +970,7 @@ async function runAppRemove(context, appName, projectRef) {
 }
 async function resolveAppDomainTarget(context, options, commandName = "app domain") {
 	ensurePreviewAppMode(context);
+	const compute = await resolveComputeManagementContext(context, options?.configTarget, commandName.replace(/^app /, ""));
 	const branch = resolveDomainBranch(options?.branchName);
 	if (toBranchKind(branch.name) !== "production") throw new CliError({
 		code: "BRANCH_NOT_DEPLOYABLE",
@@ -791,10 +986,11 @@ async function resolveAppDomainTarget(context, options, commandName = "app domai
 	const { provider, target, projectId } = await requireProviderAndProjectContext(context, options?.projectRef, {
 		branch,
 		commandName,
-		envProjectId
+		envProjectId,
+		projectDir: compute.projectDir
 	});
 	const selectedApp = await resolveDomainAppSelection(context, projectId, await listApps(context, provider, projectId, target.branch.name), {
-		explicitAppName: options?.appName,
+		explicitAppName: options?.appName ?? compute.configAppName,
 		explicitAppId: envAppId
 	});
 	await context.stateStore.setSelectedApp(projectId, {
@@ -910,72 +1106,51 @@ async function confirmDomainRemoval(context, target, hostname) {
 	})) throw usageError("Custom domain removal canceled", "The command was canceled before the domain was detached.", "Rerun the command and confirm removal, or pass --yes.", [`prisma-cli app domain remove ${hostname} --app ${target.app.name} --yes`], "app");
 }
 function domainCommandError(command, error, hostname) {
-	if (error instanceof PreviewDomainApiError) return domainApiCommandError(command, error, hostname);
-	return new CliError({
-		code: "DEPLOY_FAILED",
-		domain: "app",
-		summary: `Custom domain ${command} failed`,
-		why: error instanceof Error ? error.message : String(error),
-		fix: "Retry the command, or rerun with --trace for more detailed diagnostics.",
-		debug: formatDebugDetails(error),
-		exitCode: 1,
-		nextSteps: [`prisma-cli app domain show ${hostname}`]
-	});
-}
-function domainApiCommandError(command, error, hostname) {
-	if (command === "add") return domainAddCommandError(error, hostname);
-	if (error.status === 404) return domainNotFoundError(hostname);
-	if (command === "retry" && error.status === 409) return domainRetryNotEligibleError(error, hostname);
-	return domainGenericCommandError(command, error, hostname);
-}
-function domainAddCommandError(error, hostname) {
-	if ((error.status === 400 || error.status === 422) && isDomainDnsError(error)) return domainDnsNotConfiguredError(hostname, error);
-	if (error.status === 400) return new CliError({
-		code: "DOMAIN_HOSTNAME_INVALID",
-		domain: "app",
-		summary: `Invalid custom domain "${hostname}"`,
-		why: error.message,
-		fix: "Pass a valid hostname like shop.acme.com and make sure DNS can be verified.",
-		debug: formatDebugDetails(error),
-		exitCode: 2,
-		nextSteps: ["prisma-cli app domain add shop.acme.com"]
-	});
-	if (error.status === 429 || isDomainQuotaError(error)) return new CliError({
-		code: "DOMAIN_QUOTA_EXCEEDED",
-		domain: "app",
-		summary: "Custom domain quota exceeded",
-		why: error.message,
-		fix: "Remove an existing custom domain before adding another one.",
-		debug: formatDebugDetails(error),
-		exitCode: 1,
-		nextSteps: ["prisma-cli app domain remove <hostname>"]
-	});
-	if (error.status === 409) return domainAlreadyRegisteredError(hostname, error);
-	if (error.status === 422) return new CliError({
-		code: "NO_DEPLOYMENTS",
-		domain: "app",
-		summary: "Custom domain requires a live production deployment",
-		why: "The selected production app does not have a promoted version that can receive a custom domain.",
-		fix: "Deploy the app to the production branch, then rerun the domain command.",
-		debug: formatDebugDetails(error),
-		exitCode: 1,
-		nextSteps: ["prisma-cli app deploy --branch production", `prisma-cli app domain add ${hostname}`]
-	});
-	return domainGenericCommandError("add", error, hostname);
-}
-function domainRetryNotEligibleError(error, hostname) {
-	return new CliError({
-		code: "DOMAIN_RETRY_NOT_ELIGIBLE",
-		domain: "app",
-		summary: `Custom domain "${hostname}" is not eligible for retry`,
-		why: error.message,
-		fix: "Wait for the current verification or TLS step to finish, then rerun retry if the domain fails.",
-		debug: formatDebugDetails(error),
-		exitCode: 1,
-		nextSteps: [`prisma-cli app domain show ${hostname}`]
-	});
-}
-function domainGenericCommandError(command, error, hostname) {
+	if (error instanceof PreviewDomainApiError) {
+		if (command === "add" && (error.status === 400 || error.status === 422) && isDomainDnsError(error)) return domainDnsNotConfiguredError(hostname, error);
+		if (command === "add" && error.status === 400) return new CliError({
+			code: "DOMAIN_HOSTNAME_INVALID",
+			domain: "app",
+			summary: `Invalid custom domain "${hostname}"`,
+			why: error.message,
+			fix: "Pass a valid hostname like shop.acme.com and make sure DNS can be verified.",
+			debug: formatDebugDetails(error),
+			exitCode: 2,
+			nextSteps: ["prisma-cli app domain add shop.acme.com"]
+		});
+		if (command === "add" && (error.status === 429 || isDomainQuotaError(error))) return new CliError({
+			code: "DOMAIN_QUOTA_EXCEEDED",
+			domain: "app",
+			summary: "Custom domain quota exceeded",
+			why: error.message,
+			fix: "Remove an existing custom domain before adding another one.",
+			debug: formatDebugDetails(error),
+			exitCode: 1,
+			nextSteps: ["prisma-cli app domain remove <hostname>"]
+		});
+		if (command === "add" && error.status === 409) return domainAlreadyRegisteredError(hostname, error);
+		if (command === "add" && error.status === 422) return new CliError({
+			code: "NO_DEPLOYMENTS",
+			domain: "app",
+			summary: "Custom domain requires a live production deployment",
+			why: "The selected production app does not have a promoted version that can receive a custom domain.",
+			fix: "Deploy the app to the production branch, then rerun the domain command.",
+			debug: formatDebugDetails(error),
+			exitCode: 1,
+			nextSteps: ["prisma-cli app deploy --branch production", `prisma-cli app domain add ${hostname}`]
+		});
+		if ((command === "show" || command === "remove" || command === "retry" || command === "wait") && error.status === 404) return domainNotFoundError(hostname);
+		if (command === "retry" && error.status === 409) return new CliError({
+			code: "DOMAIN_RETRY_NOT_ELIGIBLE",
+			domain: "app",
+			summary: `Custom domain "${hostname}" is not eligible for retry`,
+			why: error.message,
+			fix: "Wait for the current verification or TLS step to finish, then rerun retry if the domain fails.",
+			debug: formatDebugDetails(error),
+			exitCode: 1,
+			nextSteps: [`prisma-cli app domain show ${hostname}`]
+		});
+	}
 	return new CliError({
 		code: "DEPLOY_FAILED",
 		domain: "app",
@@ -1128,6 +1303,25 @@ async function resolveDeployAppSelection(context, projectId, apps, options) {
 			firstDeploy: options.firstDeploy
 		};
 	}
+	if (options.configAppName) {
+		const configName = options.configAppName;
+		const matches = findAppsByName(apps, configName.value);
+		if (matches.length > 1) return resolveAmbiguousDeployApp(context, matches, configName.value, options.firstDeploy);
+		const matched = matches[0];
+		if (matched) return {
+			appId: matched.id,
+			displayName: matched.name,
+			annotation: configName.annotation,
+			firstDeploy: options.firstDeploy
+		};
+		return {
+			appName: configName.value,
+			region: PREVIEW_DEFAULT_REGION,
+			displayName: configName.value,
+			annotation: configName.annotation,
+			firstDeploy: options.firstDeploy
+		};
+	}
 	const inferredName = await options.inferName();
 	const matches = findAppsByName(apps, inferredName.name);
 	if (matches.length > 1) return resolveAmbiguousDeployApp(context, matches, inferredName.name, options.firstDeploy);
@@ -1377,14 +1571,15 @@ async function requireProviderAndDeployProjectContext(context, explicitProject,
 	};
 }
 async function resolveProjectContext(context, client, explicitProject, options) {
-	const workspace = (await requireAuthenticatedAuthState(context)).workspace;
-	if (!workspace) throw workspaceRequiredError();
+	const authState = await requireAuthenticatedAuthState(context);
+	if (!authState.workspace) throw workspaceRequiredError();
 	const resolvedResult = await resolveProjectTarget({
 		context,
-		workspace,
+		workspace: authState.workspace,
 		explicitProject,
 		envProjectId: options?.envProjectId,
-		listProjects: () => listRealWorkspaceProjects(client, workspace, context.runtime.signal),
+		projectDir: options?.projectDir,
+		listProjects: () => listRealWorkspaceProjects(client, authState.workspace, context.runtime.signal),
 		commandName: options?.commandName
 	});
 	if (resolvedResult.isErr()) throw projectResolutionErrorToCliError(resolvedResult.error);
@@ -1403,16 +1598,8 @@ async function resolveDeployProjectContext(context, client, provider, explicitPr
 	const workspace = (await requireAuthenticatedAuthState(context)).workspace;
 	if (!workspace) throw workspaceRequiredError();
 	const branch = options.branch ?? await resolveDeployBranch(context, void 0);
-	return withRemoteDeployBranch(provider, await resolveDeployProjectSetup(context, provider, workspace, await listRealWorkspaceProjects(client, workspace, context.runtime.signal), explicitProject, options), branch, context.runtime.signal);
-}
-async function resolveDeployProjectSetup(context, provider, workspace, projects, explicitProject, options) {
-	const selected = await resolveNonInteractiveDeployProjectSetup(context, provider, workspace, projects, explicitProject, options);
-	if (selected) return selected;
-	if (canPrompt(context) && !context.flags.yes) return resolveInteractiveDeployProjectSetup(context, provider, workspace, projects);
-	throw projectSetupRequiredError(projects, await inferTargetName(context.runtime.cwd, context.runtime.signal));
-}
-async function resolveNonInteractiveDeployProjectSetup(context, provider, workspace, projects, explicitProject, options) {
-	if (explicitProject) return {
+	const projects = await listRealWorkspaceProjects(client, workspace, context.runtime.signal);
+	if (explicitProject) return withRemoteDeployBranch(provider, {
 		workspace,
 		project: toProjectSummary(resolveProjectForSetup(explicitProject, projects, workspace)),
 		resolution: {
@@ -1421,11 +1608,11 @@ async function resolveNonInteractiveDeployProjectSetup(context, provider, worksp
 			targetNameSource: "explicit"
 		},
 		localPinAction: "linked"
-	};
+	}, branch, context.runtime.signal);
 	if (options.createProjectName) {
 		const projectName = options.createProjectName.trim();
 		if (!projectName) throw projectSetupNameRequiredError("app deploy --create-project");
-		return {
+		return withRemoteDeployBranch(provider, {
 			workspace,
 			project: toProjectSummary(await createProjectForDeploySetup(provider, projectName, workspace, context.runtime.signal)),
 			resolution: {
@@ -1434,12 +1621,12 @@ async function resolveNonInteractiveDeployProjectSetup(context, provider, worksp
 				targetNameSource: "explicit"
 			},
 			localPinAction: "created"
-		};
+		}, branch, context.runtime.signal);
 	}
 	if (options.envProjectId) {
 		const project = projects.find((candidate) => candidate.id === options.envProjectId);
 		if (!project) throw projectNotFoundError(options.envProjectId, workspace);
-		return {
+		return withRemoteDeployBranch(provider, {
 			workspace,
 			project: toProjectSummary(project),
 			resolution: {
@@ -1447,14 +1634,14 @@ async function resolveNonInteractiveDeployProjectSetup(context, provider, worksp
 				targetName: options.envProjectId,
 				targetNameSource: "env"
 			}
-		};
+		}, branch, context.runtime.signal);
 	}
 	const localPin = options.localPin;
 	if (localPin.kind === "present") {
 		if (localPin.pin.workspaceId !== workspace.id) throw localResolutionPinStaleError();
 		const project = projects.find((candidate) => candidate.id === localPin.pin.projectId);
 		if (!project) throw localResolutionPinStaleError();
-		return {
+		return withRemoteDeployBranch(provider, {
 			workspace,
 			project: toProjectSummary(project),
 			resolution: {
@@ -1462,10 +1649,10 @@ async function resolveNonInteractiveDeployProjectSetup(context, provider, worksp
 				targetName: project.name,
 				targetNameSource: "local-pin"
 			}
-		};
+		}, branch, context.runtime.signal);
 	}
 	const platformMapping = await resolveDurablePlatformMapping();
-	if (platformMapping && platformMapping.workspace.id === workspace.id) return {
+	if (platformMapping && platformMapping.workspace.id === workspace.id) return withRemoteDeployBranch(provider, {
 		workspace,
 		project: toProjectSummary(platformMapping),
 		resolution: {
@@ -1473,8 +1660,9 @@ async function resolveNonInteractiveDeployProjectSetup(context, provider, worksp
 			targetName: platformMapping.name,
 			targetNameSource: "platform-mapping"
 		}
-	};
-	return null;
+	}, branch, context.runtime.signal);
+	if (canPrompt(context) && !context.flags.yes) return withRemoteDeployBranch(provider, await resolveInteractiveDeployProjectSetup(context, provider, workspace, projects), branch, context.runtime.signal);
+	throw projectSetupRequiredError(projects, await inferTargetName(context.runtime.cwd, context.runtime.signal));
 }
 async function resolveInteractiveDeployProjectSetup(context, provider, workspace, projects) {
 	const setup = await promptForProjectSetupChoice({
@@ -1587,22 +1775,130 @@ async function resolveDeployBranch(context, explicitBranchName) {
 		annotation: "default"
 	};
 }
+async function resolveComputeTargetOrThrow(context, configTarget, commandName, options) {
+	let config;
+	if (options?.preloaded !== void 0) config = options.preloaded;
+	else {
+		const loaded = await loadComputeConfig$1(context.runtime.cwd, context.runtime.signal);
+		if (loaded.isErr()) throw computeConfigErrorToCliError(loaded.error, commandName);
+		config = loaded.value;
+	}
+	if (!config) {
+		if (configTarget) throw usageError(`App target "${configTarget}" requires a compute config file`, `No ${COMPUTE_CONFIG_FILENAME$1} exists in the current directory, so there are no named app targets.`, `Create ${COMPUTE_CONFIG_FILENAME$1} with an apps entry named "${configTarget}", or rerun without the target argument.`, [`prisma-cli app ${commandName}`], "app");
+		return {
+			config: null,
+			target: null
+		};
+	}
+	const requestedTarget = configTarget ?? inferComputeTargetFromCwd(config, context.runtime.cwd);
+	const selected = selectComputeDeployTarget(config, requestedTarget);
+	if (selected.isErr()) {
+		if (options?.targetOptional && selected.error instanceof ComputeConfigTargetRequiredError) return {
+			config,
+			target: null
+		};
+		throw computeConfigErrorToCliError(selected.error, commandName);
+	}
+	return {
+		config,
+		target: selected.value
+	};
+}
+/**
+* Compute-config context for app management commands: the project directory
+* (where `.prisma/local.json` lives) and the config-selected app name, which
+* ranks below `--app` but above the remembered app selection.
+*/
+async function resolveComputeManagementContext(context, configTarget, commandName) {
+	const compute = await resolveComputeTargetOrThrow(context, configTarget, commandName, { targetOptional: true });
+	return {
+		projectDir: compute.config?.configDir ?? context.runtime.cwd,
+		configAppName: compute.target?.name ?? compute.target?.key ?? void 0
+	};
+}
+async function resolveComputeAppDir(context, compute) {
+	if (!compute.config || !compute.target) return context.runtime.cwd;
+	const appDir = computeTargetAppDir(compute.config, compute.target);
+	if (!compute.target.root) return appDir;
+	context.runtime.signal.throwIfAborted();
+	try {
+		await access(appDir);
+		context.runtime.signal.throwIfAborted();
+	} catch (error) {
+		if (context.runtime.signal.aborted) throw error;
+		throw new CliError({
+			code: "COMPUTE_CONFIG_INVALID",
+			domain: "app",
+			summary: `App root "${compute.target.root}" does not exist`,
+			why: `${compute.config.relativeConfigPath} points the selected app at "${compute.target.root}", but that directory does not exist.`,
+			fix: `Fix the root path in ${compute.config.relativeConfigPath} or create the directory.`,
+			where: appDir,
+			meta: {
+				appRoot: compute.target.root,
+				appDir
+			},
+			exitCode: 2,
+			nextSteps: ["prisma-cli app deploy"]
+		});
+	}
+	return appDir;
+}
+/**
+* `prisma.app.json` is no longer read or written. A leftover file that
+* matches the effective settings only warns; one with custom values fails
+* with migration guidance so builds never silently change.
+*/
+async function handleLegacyBuildSettings(context, appDir, effective) {
+	const legacy = await detectLegacyBuildSettings({
+		appPath: appDir,
+		effective,
+		signal: context.runtime.signal
+	});
+	switch (legacy.kind) {
+		case "absent": return [];
+		case "matching": return [`${PRISMA_APP_CONFIG_FILENAME} is no longer used and matches the resolved build settings. Delete it.`];
+		case "invalid": return [`${PRISMA_APP_CONFIG_FILENAME} is no longer used and could not be parsed. Delete it.`];
+		case "custom": {
+			const buildBlock = [
+				"build: {",
+				`  command: ${legacy.buildCommand === null ? "null" : JSON.stringify(legacy.buildCommand)},`,
+				`  outputDirectory: ${JSON.stringify(legacy.outputDirectory)},`,
+				"}"
+			].join(" ");
+			throw new CliError({
+				code: "BUILD_SETTINGS_MIGRATION_REQUIRED",
+				domain: "app",
+				summary: `${PRISMA_APP_CONFIG_FILENAME} is no longer supported`,
+				why: `${PRISMA_APP_CONFIG_FILENAME} contains custom build settings that differ from the resolved defaults, and the file is no longer read.`,
+				fix: `Move the settings into prisma.compute.ts as \`${buildBlock}\` on this app, then delete ${PRISMA_APP_CONFIG_FILENAME}.`,
+				where: legacy.configPath,
+				meta: {
+					configPath: legacy.configPath,
+					buildCommand: legacy.buildCommand,
+					outputDirectory: legacy.outputDirectory
+				},
+				exitCode: 2,
+				nextSteps: ["prisma-cli app deploy"]
+			});
+		}
+	}
+}
 async function resolveDeployFramework(context, options) {
-	if (options.requestedFramework) return frameworkFromUserFacingValue(options.requestedFramework, "set by --framework");
+	if (options.requestedFramework) return frameworkFromUserFacingValue(options.requestedFramework, options.requestedFrameworkAnnotation ?? "set by --framework");
 	if (options.entrypoint) return {
 		key: "bun",
 		buildType: "bun",
 		displayName: "Bun",
-		annotation: "set by --entry"
+		annotation: options.entrypointAnnotation ?? "set by --entry"
 	};
-	const detected = await detectDeployFramework(context.runtime.cwd, context.runtime.signal);
+	const detected = await detectDeployFramework(options.appDir, context.runtime.signal);
 	if (detected) return detected;
-	throw frameworkNotDetectedError(context.runtime.cwd);
+	throw frameworkNotDetectedError(options.appDir);
 }
-function resolveDeployRuntime(requestedHttpPort, framework) {
+function resolveDeployRuntime(requestedHttpPort, requestedHttpPortAnnotation, framework) {
 	if (requestedHttpPort) return {
 		port: parseDeployHttpPort(requestedHttpPort),
-		annotation: "set by --http-port"
+		annotation: requestedHttpPortAnnotation ?? "set by --http-port"
 	};
 	return {
 		port: FRAMEWORK_DEFAULT_HTTP_PORT,
@@ -1617,8 +1913,8 @@ async function resolveDeployEntrypoint(cwd, framework, explicitEntrypoint, signa
 	if (explicitEntrypoint || framework.buildType !== "bun") return explicitEntrypoint;
 	const packageEntrypoint = readBunPackageEntrypoint(await readBunPackageJson(cwd, signal));
 	if (packageEntrypoint) return packageEntrypoint;
-	if (framework.key !== "hono") return;
-	const defaultEntrypoint = "src/index.ts";
+	const defaultEntrypoint = frameworkFromAlias(framework.key)?.defaultEntrypoint;
+	if (!defaultEntrypoint) return;
 	signal.throwIfAborted();
 	try {
 		await access(path.join(cwd, defaultEntrypoint));
@@ -1632,34 +1928,22 @@ async function resolveDeployEntrypoint(cwd, framework, explicitEntrypoint, signa
 }
 async function detectDeployFramework(cwd, signal) {
 	const packageJson = await readBunPackageJson(cwd, signal);
-	const nextConfig = await detectNextConfig(cwd, signal);
-	if (nextConfig.exists || hasPackageDependency(packageJson, "next")) return {
-		key: "nextjs",
-		buildType: "nextjs",
-		displayName: "Next.js",
-		annotation: nextConfig.standalone ? "standalone output detected" : nextConfig.exists ? "detected from next.config" : "detected from package.json"
-	};
-	if (hasPackageDependency(packageJson, "hono")) return {
-		key: "hono",
-		buildType: "bun",
-		displayName: "Hono",
-		annotation: "detected from package.json"
-	};
-	if (hasAnyPackageDependency(packageJson, TANSTACK_START_PACKAGES)) return {
-		key: "tanstack-start",
-		buildType: "tanstack-start",
-		displayName: "TanStack Start",
-		annotation: "detected from package.json"
-	};
+	for (const framework of FRAMEWORKS) {
+		if (framework.detectConfigFiles.length === 0 && framework.detectPackages.length === 0) continue;
+		const configFile = await detectFrameworkConfigFile(cwd, framework, signal);
+		if (!configFile.exists && !hasAnyPackageDependency(packageJson, framework.detectPackages)) continue;
+		const annotation = framework.key === "nextjs" && configFile.standalone ? "standalone output detected" : configFile.exists ? `detected from ${path.basename(configFile.path)}` : "detected from package.json";
+		return {
+			key: framework.key,
+			buildType: framework.buildType,
+			displayName: framework.displayName,
+			annotation
+		};
+	}
 	return null;
 }
-async function detectNextConfig(cwd, signal) {
-	for (const candidate of [
-		"next.config.js",
-		"next.config.mjs",
-		"next.config.ts",
-		"next.config.mts"
-	]) {
+async function detectFrameworkConfigFile(cwd, framework, signal) {
+	for (const candidate of framework.detectConfigFiles) {
 		const filePath = path.join(cwd, candidate);
 		signal.throwIfAborted();
 		try {
@@ -1669,7 +1953,8 @@ async function detectNextConfig(cwd, signal) {
 			});
 			return {
 				exists: true,
-				standalone: /\boutput\s*:\s*["'`]standalone["'`]/.test(content)
+				standalone: /\boutput\s*:\s*["'`]standalone["'`]/.test(content),
+				path: filePath
 			};
 		} catch (error) {
 			if (signal.aborted) throw error;
@@ -1678,7 +1963,8 @@ async function detectNextConfig(cwd, signal) {
 	}
 	return {
 		exists: false,
-		standalone: false
+		standalone: false,
+		path: null
 	};
 }
 function hasPackageDependency(packageJson, dependencyName) {
@@ -1691,48 +1977,41 @@ function hasDependency(dependencies, dependencyName) {
 	return Boolean(dependencies && typeof dependencies === "object" && dependencyName in dependencies);
 }
 function frameworkFromUserFacingValue(value, annotation) {
-	switch (value.trim().toLowerCase()) {
-		case "next":
-		case "next.js":
-		case "nextjs": return {
-			key: "nextjs",
-			buildType: "nextjs",
-			displayName: "Next.js",
-			annotation
-		};
-		case "hono": return {
-			key: "hono",
-			buildType: "bun",
-			displayName: "Hono",
-			annotation
-		};
-		case "bun": return {
-			key: "bun",
-			buildType: "bun",
-			displayName: "Bun",
-			annotation
-		};
-		case "tanstack":
-		case "tanstack-start":
-		case "@tanstack/react-start":
-		case "@tanstack/solid-start": return {
-			key: "tanstack-start",
-			buildType: "tanstack-start",
-			displayName: "TanStack Start",
-			annotation
-		};
-		default: throw frameworkNotDetectedError(void 0, value);
-	}
+	const framework = frameworkFromAlias(value);
+	if (!framework) throw frameworkNotDetectedError(void 0, value);
+	return {
+		key: framework.key,
+		buildType: framework.buildType,
+		displayName: framework.displayName,
+		annotation
+	};
+}
+/**
+* The nuxt and astro strategies build with their framework CLI and stage
+* fixed output, so a compute config `build` block has nothing to apply to.
+* Erroring beats silently ignoring committed settings.
+*/
+function assertConfigBackedBuildSettings(buildType) {
+	if (isConfigBackedBuildType(buildType)) return;
+	const displayName = FRAMEWORKS.find((framework) => framework.buildType === buildType)?.displayName ?? buildType;
+	throw new CliError({
+		code: "BUILD_SETTINGS_UNSUPPORTED",
+		domain: "app",
+		summary: `build settings are not supported for ${displayName} apps`,
+		why: `${displayName} deploys run \`${buildType} build\` and package its output automatically.`,
+		fix: "Remove the `build` block from prisma.compute.ts for this app.",
+		exitCode: 2
+	});
 }
 function frameworkNotDetectedError(cwd, requestedFramework) {
-	const supported = "Next.js, Hono, TanStack Start, Bun";
+	const supported = FRAMEWORKS.map((framework) => framework.displayName).join(", ");
 	const directory = cwd ? ` in ${formatDeployDirectory(cwd)}` : "";
 	return new CliError({
 		code: "FRAMEWORK_NOT_DETECTED",
 		domain: "app",
 		summary: requestedFramework ? `Unsupported framework "${requestedFramework}"` : `Cannot detect a supported framework${directory}`,
 		why: `Supported Beta frameworks: ${supported}.`,
-		fix: "Add one of these frameworks as a dependency, pass --framework <nextjs|hono|tanstack-start|bun>, or pass --entry <path> for a Bun app.",
+		fix: `Add one of these frameworks as a dependency, pass --framework <${FRAMEWORKS.map((framework) => framework.key).join("|")}>, or pass --entry <path> for a Bun app.`,
 		exitCode: 2,
 		nextSteps: [
 			"prisma-cli app deploy --framework nextjs",
@@ -1745,14 +2024,14 @@ function frameworkNotDetectedError(cwd, requestedFramework) {
 }
 async function maybeRenderDeploySetupBlock(context, details) {
 	if (context.flags.json || context.flags.quiet) return;
-	const directory = formatDeployDirectory(context.runtime.cwd);
+	const directory = formatAppDirectoryLabel(context.runtime.cwd, details.appDir);
 	const prefix = details.includeDirectory ? `Deploying ${directory} to` : "Deploying to";
 	context.output.stderr.write(`${prefix} ${details.projectName} / ${details.branchName} / ${details.appName}\n\n`);
 }
 function maybeRenderDeployBuildSettings(context, resolution) {
 	if (context.flags.json || context.flags.quiet) return;
 	const settings = resolution.settings;
-	const title = resolution.status === "created" ? `Created ${resolution.relativeConfigPath}` : `Using ${resolution.relativeConfigPath}`;
+	const title = resolution.status === "config" ? `Using ${resolution.relativeConfigPath}` : "Build settings";
 	context.output.stderr.write(`${title}\n${renderDeployOutputRows(context.ui, [{
 		label: "Build Command",
 		value: settings.buildCommand ?? "none",
@@ -1789,9 +2068,9 @@ async function maybeCustomizeDeploySettings(context, options) {
 		input: context.runtime.stdin,
 		output: context.runtime.stderr,
 		message: `Framework (${options.framework.displayName})`,
-		choices: DEPLOY_FRAMEWORKS.map((framework) => ({
-			label: frameworkDisplayName(framework),
-			value: framework
+		choices: FRAMEWORKS.map((framework) => ({
+			label: framework.displayName,
+			value: framework.key
 		}))
 	}), "set by you");
 	const requestedPort = await textPrompt({
@@ -1834,14 +2113,6 @@ function maybeRenderDeploySettingsPreview(context, options) {
 		value: `HTTP ${options.runtime.port}`
 	}]).join("\n")}\n\n`);
 }
-function frameworkDisplayName(framework) {
-	switch (framework) {
-		case "nextjs": return "Next.js";
-		case "hono": return "Hono";
-		case "tanstack-start": return "TanStack Start";
-		case "bun": return "Bun";
-	}
-}
 function validateDeployHttpPortText(value) {
 	if (!value?.trim()) return;
 	try {
@@ -1855,6 +2126,11 @@ function formatDeployDirectory(cwd) {
 	const basename = path.basename(cwd);
 	return basename ? `./${basename}` : ".";
 }
+function formatAppDirectoryLabel(cwd, appDir) {
+	if (appDir === cwd) return formatDeployDirectory(cwd);
+	const relative = path.relative(cwd, appDir).split(path.sep).join("/");
+	return relative.startsWith("..") ? relative : `./${relative}`;
+}
 async function readCurrentWorkspaceId(context) {
 	const state = await context.stateStore.read();
 	if (state.auth?.workspaceId) return state.auth.workspaceId;
@@ -1874,15 +2150,25 @@ function getBuildTypeExamples(commandName) {
 	});
 }
 function assertSupportedEntrypoint(buildType, entrypoint, commandName) {
-	if (buildType !== "auto" && buildType !== "bun" && entrypoint) {
+	if (buildType !== "auto" && !ENTRYPOINT_BUILD_TYPES.includes(buildType) && entrypoint) {
 		if (commandName === "deploy") throw usageError(`App deploy does not accept --entry with ${formatBuildTypeName(buildType)}`, `${formatBuildTypeName(buildType)} apps derive their runtime entrypoint from build output.`, "Remove --entry, or use --framework bun when you want to target a Bun entrypoint directly.", [`prisma-cli app deploy --framework ${buildType}`, "prisma-cli app deploy --framework bun --entry server.ts"], "app");
 		throw usageError(`App ${commandName} does not accept --entry with --build-type ${buildType}`, `${formatBuildTypeName(buildType)} apps do not use an entrypoint flag in the current preview.`, `Remove --entry, or rerun prisma-cli app ${commandName} with --build-type bun when you want to target a Bun entrypoint directly.`, [`prisma-cli app ${commandName} --build-type ${buildType}`, `prisma-cli app ${commandName} --build-type bun --entry server.ts`], "app");
 	}
 }
-async function requireLocalBuildType(context, buildType, commandName) {
-	const resolvedBuildType = await resolveLocalBuildType(context.runtime.cwd, buildType, context.runtime.signal);
-	if (resolvedBuildType) return resolvedBuildType;
-	throw usageError(`App ${commandName} requires an explicit framework when detection is ambiguous`, "This preview only starts local dev servers for clear Next.js or Bun project shapes.", "Pass --build-type nextjs for a Next.js app, or pass --build-type bun with --entry <path> for a Bun app.", [`prisma-cli app ${commandName} --build-type nextjs`, `prisma-cli app ${commandName} --build-type bun --entry server.ts`], "app");
+/**
+* Resolves the framework for `app run` with the same detection as deploy, so
+* a repo that deploys without flags also runs without flags. Local dev server
+* support is intentionally narrower than deploy build support: only Next.js
+* and Bun/Hono have dev servers in the current preview.
+*/
+async function resolveLocalRunFramework(context, options) {
+	if (LOCAL_DEV_BUILD_TYPES.includes(options.requestedBuildType)) {
+		if (options.configFramework && computeFrameworkToBuildType(options.configFramework) === options.requestedBuildType) return frameworkFromUserFacingValue(options.configFramework, `set by ${COMPUTE_CONFIG_FILENAME$1}`);
+		return frameworkFromUserFacingValue(options.requestedBuildType, "set by --build-type");
+	}
+	const detected = await detectDeployFramework(options.appDir, context.runtime.signal);
+	if (detected && LOCAL_DEV_BUILD_TYPES.includes(detected.buildType)) return detected;
+	throw usageError("App run requires an explicit framework when detection is ambiguous", "This preview only starts local dev servers for clear Next.js or Bun project shapes.", "Pass --build-type nextjs for a Next.js app, or pass --build-type bun with --entry <path> for a Bun app.", ["prisma-cli app run --build-type nextjs", "prisma-cli app run --build-type bun --entry server.ts"], "app");
 }
 function parseLocalPort(requestedPort) {
 	if (!requestedPort) return DEFAULT_LOCAL_DEV_PORT;
@@ -1918,7 +2204,41 @@ function deployFailedError(summary, error, nextSteps) {
 function appDeployFailedError(error, progress) {
 	const why = error instanceof Error ? error.message : String(error);
 	const debug = formatDebugDetails(error);
-	if (progress.buildStarted && !progress.buildCompleted) return appBuildFailedError(why, debug);
+	if (progress.buildStarted && !progress.buildCompleted) {
+		const standaloneOutputFailure = isNextStandaloneOutputFailure(why);
+		const fix = standaloneOutputFailure ? "Add output: \"standalone\" to next.config.*, then rerun deploy." : "Inspect the build output above, fix the error, and redeploy.";
+		const nextSteps = standaloneOutputFailure ? ["Add output: \"standalone\" to next.config.*, then rerun prisma-cli app deploy"] : [];
+		const nextActions = standaloneOutputFailure ? [{
+			kind: "edit-file",
+			journey: "deploy-app",
+			label: "Add Next.js standalone output",
+			reason: "Prisma Compute needs Next.js standalone output to build a deployable server artifact."
+		}, {
+			kind: "run-command",
+			journey: "deploy-app",
+			label: "Rerun deploy",
+			command: "prisma-cli app deploy"
+		}] : [];
+		return new CliError({
+			code: "BUILD_FAILED",
+			domain: "app",
+			summary: "Build failed locally.",
+			why,
+			fix,
+			debug,
+			meta: { phase: "build" },
+			humanLines: [
+				"Build failed locally.",
+				"",
+				`✗ Built       ${why}`,
+				"",
+				`Fix: ${fix}`
+			],
+			exitCode: 1,
+			nextSteps,
+			nextActions
+		});
+	}
 	if (!progress.buildStarted) return deployFailedError("App deploy failed", error, ["prisma-cli app deploy"]);
 	const phaseHeadline = progress.containerLive ? "The deployment started, but the app is not ready yet." : "Deploy failed after the build completed.";
 	const recoveryLines = progress.versionId ? ["See what happened", `prisma-cli app logs --deployment ${progress.versionId}`] : ["Fix", "Retry the command, or rerun with --trace for more detailed diagnostics."];
@@ -1959,41 +2279,6 @@ function appDeployFailedError(error, progress) {
 		nextSteps: []
 	});
 }
-function appBuildFailedError(why, debug) {
-	const standaloneOutputFailure = isNextStandaloneOutputFailure(why);
-	const fix = standaloneOutputFailure ? "Add output: \"standalone\" to next.config.*, then rerun deploy." : "Inspect the build output above, fix the error, and redeploy.";
-	const nextSteps = standaloneOutputFailure ? ["Add output: \"standalone\" to next.config.*, then rerun prisma-cli app deploy"] : [];
-	const nextActions = standaloneOutputFailure ? [{
-		kind: "edit-file",
-		journey: "deploy-app",
-		label: "Add Next.js standalone output",
-		reason: "Prisma Compute needs Next.js standalone output to build a deployable server artifact."
-	}, {
-		kind: "run-command",
-		journey: "deploy-app",
-		label: "Rerun deploy",
-		command: "prisma-cli app deploy"
-	}] : [];
-	return new CliError({
-		code: "BUILD_FAILED",
-		domain: "app",
-		summary: "Build failed locally.",
-		why,
-		fix,
-		debug,
-		meta: { phase: "build" },
-		humanLines: [
-			"Build failed locally.",
-			"",
-			`✗ Built       ${why}`,
-			"",
-			`Fix: ${fix}`
-		],
-		exitCode: 1,
-		nextSteps,
-		nextActions
-	});
-}
 function localResolutionPinStaleError() {
 	return new CliError({
 		code: "LOCAL_STATE_STALE",