@prisma/cli 3.0.0-beta.3 → 3.0.0-beta.30

package/dist/controllers/app.js

@@ -1,54 +1,81 @@
-import { SERVICE_TOKEN_ENV_VAR, getApiBaseUrl } from "../lib/auth/client.js";
-import { FileTokenStorage } from "../adapters/token-storage.js";
+import { formatCommandArgument } from "../shell/command-arguments.js";
 import { CliError, authRequiredError, featureUnavailableError, usageError, workspaceRequiredError } from "../shell/errors.js";
 import { renderCommandHeader } from "../shell/ui.js";
-import { writeJsonEvent } from "../shell/output.js";
 import { canPrompt } from "../shell/runtime.js";
+import { writeJsonEvent } from "../shell/output.js";
+import { SERVICE_TOKEN_ENV_VAR, getApiBaseUrl } from "../lib/auth/client.js";
+import { FileTokenStorage } from "../adapters/token-storage.js";
+import { PRISMA_APP_CONFIG_FILENAME, detectLegacyBuildSettings, resolveConfiguredAppBuildSettings, resolveInferredAppBuildSettings } from "../lib/app/build-settings.js";
+import { APP_BUILD_TYPES, APP_BUILD_TYPE_LABELS, RESOLVED_APP_BUILD_TYPES, executeAppBuild } from "../lib/app/build.js";
+import { envVarNames, parseEnvInputs } from "../lib/app/env-vars.js";
+import { DomainApiError, createAppProvider } from "../lib/app/app-provider.js";
 import { confirmPrompt, selectPrompt, textPrompt } from "../shell/prompt.js";
+import { LOCAL_RESOLUTION_PIN_RELATIVE_PATH, readLocalResolutionPin } from "../lib/project/local-pin.js";
+import { buildProjectSetupNextActions, inferTargetName, localProjectWorkspaceMismatchError, projectNotFoundError, projectResolutionErrorToCliError, resolveDurablePlatformMapping, resolveProjectTarget, sortProjects } from "../lib/project/resolution.js";
+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 { createDeployProgress, createDeployProgressState, createPromoteProgress } from "../lib/app/deploy-progress.js";
+import { formatDomainFailureFix } from "../lib/app/domain-guidance.js";
+import { DEFAULT_LOCAL_DEV_PORT, runLocalApp } from "../lib/app/local-dev.js";
+import { enforceProductionDeployGate } from "../lib/app/production-deploy-gate.js";
+import { resolveReadBranch } from "../lib/app/read-branch.js";
 import { requireComputeAuth } from "../lib/auth/guard.js";
 import { readAuthState } from "../lib/auth/auth-ops.js";
-import { parseEnvAssignments } from "../lib/app/env-vars.js";
-import { renderDeployOutputRows, renderDeploySettingsPreview } from "../lib/app/deploy-output.js";
-import { readBunPackageEntrypoint, readBunPackageJson } from "../lib/app/bun-project.js";
-import { DEFAULT_LOCAL_DEV_PORT, resolveLocalBuildType, runLocalApp } from "../lib/app/local-dev.js";
-import { formatCommandArgument } from "../shell/command-arguments.js";
-import { LOCAL_RESOLUTION_PIN_RELATIVE_PATH, readLocalResolutionPin } from "../lib/project/local-pin.js";
-import { buildProjectSetupNextActions, inferTargetName, projectNotFoundError, resolveDurablePlatformMapping, resolveProjectTarget, sortProjects } from "../lib/project/resolution.js";
-import { bindProjectToDirectory, projectCreateFailedError, projectSetupNameRequiredError, resolveProjectForSetup, toProjectSummary } from "../lib/project/setup.js";
+import { readLocalGitBranch } from "../lib/git/local-branch.js";
 import { promptForProjectSetupChoice } from "../lib/project/interactive-setup.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";
-import { PreviewDomainApiError, createPreviewAppProvider } from "../lib/app/preview-provider.js";
-import { formatDomainFailureFix } from "../lib/app/domain-guidance.js";
+import { maybePromptForAgentSetup } from "./agent-setup.js";
 import { createSelectPromptPort } from "./select-prompt-port.js";
 import { requireAuthenticatedAuthState } from "./auth.js";
 import { listRealWorkspaceProjects } from "./project.js";
-import { access, readFile } from "node:fs/promises";
 import path from "node:path";
+import { access } from "node:fs/promises";
+import { COMPUTE_REGIONS, ENTRYPOINT_BUILD_TYPES, FRAMEWORKS, LOCAL_DEV_BUILD_TYPES, frameworkByKey, frameworkFromAlias, isConfigBackedBuildType } from "@prisma/compute-sdk/config";
+import { detectComputeAppFromDirectory } from "@prisma/compute-sdk/config/directory";
+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";
+const COMPUTE_REGION_IDS = new Set(COMPUTE_REGIONS);
 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 resolveConfiguredAppBuildSettings({
+		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,
+		const { artifact, buildType: actualBuildType } = await executeAppBuild({
+			appPath: appDir,
+			entrypoint: merged.entrypoint,
 			buildType,
+			buildSettings,
 			signal: context.runtime.signal
 		});
 		return {
@@ -62,21 +89,38 @@ async function runAppBuild(context, entrypoint, requestedBuildType) {
 			nextSteps: ["prisma-cli app deploy"]
 		};
 	} catch (error) {
-		if (buildType === "auto" && isAutoBuildDetectionError(error)) throw usageError("App build requires an explicit framework when detection is ambiguous", `This preview auto-detects clear project shapes for ${RESOLVED_PREVIEW_BUILD_TYPES.map(formatBuildTypeName).join(", ")}.`, "Pass a supported --build-type value, or pass --entry <path> for a Bun app.", getBuildTypeExamples("build"), "app");
+		if (buildType === "auto" && isAutoBuildDetectionError(error)) throw usageError("App build requires an explicit framework when detection is ambiguous", `This preview auto-detects clear project shapes for ${RESOLVED_APP_BUILD_TYPES.map(formatBuildTypeName).join(", ")}.`, "Pass a supported --build-type value, or pass --entry <path> for a Bun app.", getBuildTypeExamples("build"), "app");
 		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,
+		entrypoint: merged.entrypoint
+	});
+	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,
@@ -101,6 +145,107 @@ 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, plannedTargets, 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, plannedTargets, planned.index, deployments);
+		}
+	}
+	return {
+		command: "app.deploy",
+		result: { deployments },
+		warnings,
+		nextSteps: ["prisma-cli app list-deploys <app>"]
+	};
+}
+function assertNoPerAppInputsForDeployAll(context, plannedTargets, appName, options) {
+	const used = perAppInputsForDeployAll({
+		appName,
+		framework: options?.framework,
+		entrypoint: options?.entrypoint,
+		httpPort: options?.httpPort,
+		region: options?.region,
+		envAssignments: options?.envAssignments,
+		appIdEnvVar: {
+			name: PRISMA_APP_ID_ENV_VAR,
+			value: readDeployEnvOverride(context, PRISMA_APP_ID_ENV_VAR)
+		}
+	});
+	if (used.length === 0) return;
+	const targetKeys = plannedTargets.map((target) => target.targetKey);
+	throw usageError(`Deploying all apps does not accept ${used.join(", ")}`, `Without a target, app deploy deploys every configured app (${targetKeys.join(", ")}), 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.", targetKeys.map((target) => `prisma-cli app deploy ${target}`), "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, plannedTargets, failedIndex, deployments) {
+	if (!(error instanceof CliError)) return error;
+	const failure = describeDeployAllFailure({
+		targetKeys: plannedTargets.map((target) => target.targetKey),
+		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({
@@ -108,42 +253,67 @@ async function runAppDeploy(context, appName, options) {
 		createProjectName: options?.createProjectName,
 		envProjectId
 	});
-	const skipLocalPin = Boolean(envProjectId || options?.projectRef || options?.createProjectName);
-	const localPin = skipLocalPin ? { kind: "missing" } : await readLocalResolutionPin(context.runtime.cwd, context.runtime.signal);
-	if (!skipLocalPin && localPin.kind === "invalid") throw localResolutionPinStaleError();
+	const computeConfig = await resolveComputeTargetOrThrow(context, options?.configTarget, "deploy", { preloaded: preloadedConfig });
+	const merged = mergeComputeDeployInputs({
+		cli: {
+			framework: options?.framework,
+			entrypoint: options?.entrypoint,
+			httpPort: options?.httpPort,
+			region: options?.region,
+			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 agentSetupWarnings = await maybePromptForAgentSetup(context, projectDir);
+	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);
+	const deployRegion = normalizeDeployRegionInput(merged.region);
 	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,
 		createProjectName: options?.createProjectName,
+		createProjectRegion: deployRegion?.value,
 		envProjectId,
 		localPin
 	});
 	let localPinResult;
 	if (target.localPinAction) {
-		const setupResult = await bindProjectToDirectory(context, target.workspace, target.project, target.localPinAction);
-		localPinResult = setupResult.localPin;
-		maybeRenderProjectLinked(context, setupResult.directory, setupResult.project.name, setupResult.localPin.path);
+		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(parseEnvAssignments(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,
+		configRegion: deployRegion,
 		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
@@ -152,20 +322,41 @@ 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;
+	const noPromote = options?.noPromote === true;
+	const productionDeployGate = noPromote ? { firstProductionDeploy: false } : await enforceProductionDeployGate(context, provider, {
+		appId: selectedApp.appId,
+		appName: selectedApp.displayName,
+		branchKind: target.branch.kind,
+		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);
+	assertSupportedEntrypoint(buildType, merged.entrypoint?.value, "deploy");
+	const entrypoint = await resolveDeployEntrypoint(appDir, framework, merged.entrypoint?.value, context.runtime.signal);
+	const buildSettingsResolution = await resolveDeployBuildSettings({
+		computeConfig,
+		appDir,
+		buildType,
+		signal: context.runtime.signal
+	});
+	const legacyWarnings = await handleLegacyBuildSettings(context, appDir, buildSettingsResolution.settings);
+	maybeRenderDeployBuildSettings(context, buildSettingsResolution);
 	const portMapping = parseDeployPortMapping(String(runtime.port));
-	const progressState = createPreviewDeployProgressState();
+	const branchDatabaseSetup = await maybeSetupBranchDatabase(context, provider, projectId, toBranchDatabaseDeployBranch(target.branch), {
+		db: options?.db,
+		providedEnvVars: envVars,
+		firstProductionDeploy: productionDeployGate.firstProductionDeploy,
+		projectDir
+	});
+	const progressState = createDeployProgressState();
 	const deployStartedAt = Date.now();
 	const deployResult = await provider.deployApp({
-		cwd: context.runtime.cwd,
+		cwd: appDir,
 		projectId,
 		branchName: target.branch.name,
 		appId: selectedApp.appId,
@@ -173,11 +364,13 @@ async function runAppDeploy(context, appName, options) {
 		region: selectedApp.region,
 		entrypoint,
 		buildType,
+		buildSettings: buildSettingsResolution.settings,
 		portMapping,
 		envVars,
+		skipPromote: noPromote,
 		interaction: void 0,
 		signal: context.runtime.signal,
-		progress: createPreviewDeployProgress(context.output.stderr, context.ui, !context.flags.json && !context.flags.quiet, progressState)
+		progress: createDeployProgress(context.output.stderr, context.ui, !context.flags.json && !context.flags.quiet, progressState)
 	}).catch((error) => {
 		throw appDeployFailedError(error, progressState);
 	});
@@ -186,34 +379,87 @@ async function runAppDeploy(context, appName, options) {
 		id: deployResult.app.id,
 		name: deployResult.app.name
 	});
-	await context.stateStore.setKnownLiveDeployment(projectId, deployResult.app.id, deployResult.deployment.id);
+	const knownLiveDeploymentId = deployResult.promoted ? deployResult.deployment.id : deployResult.app.liveDeploymentId;
+	if (knownLiveDeploymentId) await context.stateStore.setKnownLiveDeployment(projectId, deployResult.app.id, knownLiveDeploymentId);
 	return {
 		command: "app.deploy",
 		result: {
 			workspace: target.workspace,
 			project: target.project,
-			branch: target.branch,
+			branch: toResultBranch(target.branch),
 			resolution: target.resolution,
+			branchDatabase: branchDatabaseSetup.result,
 			app: {
 				id: deployResult.app.id,
 				name: deployResult.app.name
 			},
 			deployment: deployResult.deployment,
+			promoted: deployResult.promoted,
+			deploySettings: {
+				config: {
+					path: computeConfig.config?.relativeConfigPath ?? null,
+					status: buildSettingsResolution.status
+				},
+				buildCommand: {
+					value: buildSettingsResolution.settings.buildCommand,
+					source: buildSettingsResolution.settings.buildCommandSource
+				},
+				outputDirectory: {
+					value: buildSettingsResolution.settings.outputDirectory,
+					source: buildSettingsResolution.settings.outputDirectorySource
+				},
+				framework: {
+					key: framework.key,
+					buildType,
+					name: framework.displayName,
+					source: framework.annotation
+				},
+				entrypoint: entrypoint ?? buildSettingsResolution.settings.entrypoint ?? null,
+				httpPort: runtime.port,
+				region: deployResult.app.region ?? selectedApp.region ?? null,
+				regionSource: deployRegion?.annotation ?? null,
+				envVars: envVarNames(envVars)
+			},
 			durationMs: deployDurationMs,
 			localPin: localPinResult
 		},
-		warnings: [],
-		nextSteps: ["prisma-cli app list-deploys", `prisma-cli app show-deploy ${deployResult.deployment.id}`]
+		warnings: [
+			...agentSetupWarnings,
+			...legacyWarnings,
+			...branchDatabaseSetup.warnings
+		],
+		nextSteps: deployResult.promoted ? ["prisma-cli app list-deploys", `prisma-cli app show-deploy ${deployResult.deployment.id}`] : [`prisma-cli app promote ${deployResult.deployment.id}`, `prisma-cli app show-deploy ${deployResult.deployment.id}`]
 	};
 }
-async function runAppListDeploys(context, appName, projectRef) {
+async function resolveDeployBuildSettings(options) {
+	const { computeConfig, appDir, buildType, signal } = options;
+	if (computeConfig.target?.build) assertConfigBackedBuildSettings(buildType);
+	if (computeConfig.config && computeConfig.target?.build && isConfigBackedBuildType(buildType)) return resolveConfiguredAppBuildSettings({
+		appPath: appDir,
+		buildType,
+		configured: computeConfig.target.build,
+		configPath: computeConfig.config.configPath,
+		signal
+	});
+	return resolveInferredAppBuildSettings({
+		appPath: appDir,
+		buildType,
+		signal
+	});
+}
+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: {
 			projectId,
+			verboseContext: toAppVerboseContext(target),
 			app: null,
 			deployments: []
 		},
@@ -233,6 +479,7 @@ async function runAppListDeploys(context, appName, projectRef) {
 		command: "app.list-deploys",
 		result: {
 			projectId,
+			verboseContext: toAppVerboseContext(target),
 			app: {
 				id: deploymentsResult.app.id,
 				name: deploymentsResult.app.name
@@ -243,14 +490,19 @@ 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: {
 			projectId,
+			verboseContext: toAppVerboseContext(target),
 			app: null,
 			liveDeployment: null,
 			liveUrl: null,
@@ -273,6 +525,7 @@ async function runAppShow(context, appName, projectRef) {
 		command: "app.show",
 		result: {
 			projectId,
+			verboseContext: toAppVerboseContext(target),
 			app: {
 				id: deploymentsResult.app.id,
 				name: deploymentsResult.app.name
@@ -319,9 +572,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) => {
@@ -346,6 +604,7 @@ async function runAppOpen(context, appName, projectRef) {
 		command: "app.open",
 		result: {
 			projectId,
+			verboseContext: toAppVerboseContext(target),
 			app: {
 				id: deploymentsResult.app.id,
 				name: deploymentsResult.app.name
@@ -484,15 +743,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",
@@ -609,9 +872,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"]);
@@ -627,7 +895,7 @@ async function runAppPromote(context, deploymentId, appName, projectRef) {
 		appId: selectedApp.id,
 		deploymentId: targetDeployment.id,
 		signal: context.runtime.signal,
-		progress: createPreviewPromoteProgress(context.output.stderr, !context.flags.json && !context.flags.quiet)
+		progress: createPromoteProgress(context.output.stderr, !context.flags.json && !context.flags.quiet)
 	}).catch((error) => {
 		throw deployFailedError("Failed to promote deployment", error, ["prisma-cli app list-deploys"]);
 	});
@@ -636,6 +904,7 @@ async function runAppPromote(context, deploymentId, appName, projectRef) {
 		command: "app.promote",
 		result: {
 			projectId,
+			verboseContext: toAppVerboseContext(target),
 			app: {
 				id: deploymentsResult.app.id,
 				name: deploymentsResult.app.name
@@ -650,9 +919,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"]);
@@ -669,7 +943,7 @@ async function runAppRollback(context, appName, deploymentId, projectRef) {
 		appId: selectedApp.id,
 		deploymentId: targetDeployment.id,
 		signal: context.runtime.signal,
-		progress: createPreviewPromoteProgress(context.output.stderr, !context.flags.json && !context.flags.quiet)
+		progress: createPromoteProgress(context.output.stderr, !context.flags.json && !context.flags.quiet)
 	}).catch((error) => {
 		throw deployFailedError("Failed to roll back deployment", error, ["prisma-cli app list-deploys"]);
 	});
@@ -678,6 +952,7 @@ async function runAppRollback(context, appName, deploymentId, projectRef) {
 		command: "app.rollback",
 		result: {
 			projectId,
+			verboseContext: toAppVerboseContext(target),
 			app: {
 				id: deploymentsResult.app.id,
 				name: deploymentsResult.app.name
@@ -693,9 +968,22 @@ 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) {
+/**
+* Removes an app and every deployment it owns in the resolved branch.
+*
+* @param branchName Scopes the removal to this branch. When omitted the branch
+* is inferred from the local Git branch, falling back to the production branch.
+*/
+async function runAppRemove(context, appName, projectRef, configTarget, branchName) {
 	ensurePreviewAppMode(context);
-	const { provider, target, projectId } = await requireProviderAndProjectContext(context, projectRef, { commandName: "app remove" });
+	const compute = await resolveComputeManagementContext(context, configTarget, "remove");
+	appName = appName ?? compute.configAppName;
+	if (branchName !== void 0 && branchName.trim() === "") throw usageError("The --branch value cannot be empty", "app remove scopes the removal to the given branch; an empty --branch would silently fall back to the inferred (possibly production) branch.", "Pass a non-empty branch name, e.g. --branch <branch>, or omit --branch to use the inferred branch.", ["prisma-cli app remove --app <name> --branch <branch>"], "app");
+	const { provider, target, projectId } = await requireProviderAndProjectContext(context, projectRef, {
+		branch: branchName !== void 0 ? await resolveDeployBranch(context, branchName) : void 0,
+		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) => {
@@ -706,6 +994,7 @@ async function runAppRemove(context, appName, projectRef) {
 		command: "app.remove",
 		result: {
 			projectId,
+			verboseContext: toAppVerboseContext(target),
 			app: {
 				id: removedApp.id,
 				name: removedApp.name
@@ -718,6 +1007,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",
@@ -733,10 +1023,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, {
@@ -749,7 +1040,7 @@ async function resolveAppDomainTarget(context, options, commandName = "app domai
 		resultTarget: {
 			workspace: target.workspace,
 			project: target.project,
-			branch: target.branch,
+			branch: toResultBranch(target.branch),
 			app: {
 				id: selectedApp.id,
 				name: selectedApp.name
@@ -809,7 +1100,7 @@ function toAppDomainSummary(domain) {
 		type: domain.type,
 		url: domain.url,
 		hostname: domain.hostname,
-		computeServiceId: domain.computeServiceId,
+		appId: domain.appId,
 		status: domain.status,
 		foundryStatus: domain.foundryStatus,
 		failureReason: domain.failureReason,
@@ -847,12 +1138,13 @@ async function confirmDomainRemoval(context, target, hostname) {
 	if (!await confirmPrompt({
 		input: context.runtime.stdin,
 		output: context.output.stderr,
+		signal: context.runtime.signal,
 		message: `Detach ${hostname} from App "${target.app.name}"?`,
 		initialValue: false
 	})) 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) {
+	if (error instanceof DomainApiError) {
 		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",
@@ -1021,27 +1313,19 @@ async function sleep(milliseconds, signal) {
 	});
 }
 async function resolveDeployAppSelection(context, projectId, apps, options) {
-	if (options.explicitAppName) {
-		const matches = findAppsByName(apps, options.explicitAppName);
-		if (matches.length > 1) return resolveAmbiguousDeployApp(context, matches, options.explicitAppName, options.firstDeploy);
-		const matched = matches[0];
-		if (matched) return {
-			appId: matched.id,
-			displayName: matched.name,
-			annotation: "set by --app",
-			firstDeploy: options.firstDeploy
-		};
-		return {
-			appName: options.explicitAppName,
-			region: PREVIEW_DEFAULT_REGION,
-			displayName: options.explicitAppName,
-			annotation: "set by --app",
-			firstDeploy: options.firstDeploy
-		};
-	}
+	const newAppRegion = deployNewAppRegion(options.configRegion);
+	if (options.explicitAppName) return resolveDeployAppByName(context, apps, {
+		name: options.explicitAppName,
+		matchedAnnotation: "set by --app",
+		newAnnotation: "set by --app",
+		requestedRegion: options.configRegion,
+		newAppRegion,
+		firstDeploy: options.firstDeploy
+	});
 	if (options.explicitAppId) {
 		const matched = apps.find((app) => app.id === options.explicitAppId);
 		if (!matched) throw usageError("Selected app does not exist in the resolved project", `The app "${options.explicitAppId}" from ${PRISMA_APP_ID_ENV_VAR} could not be found in resolved project "${projectId}".`, `Unset ${PRISMA_APP_ID_ENV_VAR}, pass --app <name>, or choose an app from prisma-cli app list-deploys.`, ["prisma-cli app list-deploys"], "app");
+		assertDeployRegionMatchesExistingApp(matched, options.configRegion);
 		return {
 			appId: matched.id,
 			displayName: matched.name,
@@ -1049,25 +1333,54 @@ async function resolveDeployAppSelection(context, projectId, apps, options) {
 			firstDeploy: options.firstDeploy
 		};
 	}
+	if (options.configAppName) {
+		const configName = options.configAppName;
+		return resolveDeployAppByName(context, apps, {
+			name: configName.value,
+			matchedAnnotation: configName.annotation,
+			newAnnotation: configName.annotation,
+			requestedRegion: options.configRegion,
+			newAppRegion,
+			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);
-	const matched = matches[0];
-	if (matched) return {
-		appId: matched.id,
-		displayName: matched.name,
-		annotation: "existing app on this branch",
+	const newAnnotation = inferredName.source === "package-name" ? "created from package.json" : "created from directory name";
+	return resolveDeployAppByName(context, apps, {
+		name: inferredName.name,
+		matchedAnnotation: "existing app on this branch",
+		newAnnotation,
+		requestedRegion: options.configRegion,
+		newAppRegion,
 		firstDeploy: options.firstDeploy
-	};
+	});
+}
+async function resolveDeployAppByName(context, apps, options) {
+	const matches = findAppsByName(apps, options.name);
+	if (matches.length > 1) return resolveAmbiguousDeployApp(context, matches, options.name, options.requestedRegion, options.newAppRegion, options.firstDeploy);
+	const matched = matches[0];
+	if (matched) {
+		assertDeployRegionMatchesExistingApp(matched, options.requestedRegion);
+		return {
+			appId: matched.id,
+			displayName: matched.name,
+			annotation: options.matchedAnnotation,
+			firstDeploy: options.firstDeploy
+		};
+	}
 	return {
-		appName: inferredName.name,
-		region: PREVIEW_DEFAULT_REGION,
-		displayName: inferredName.name,
-		annotation: inferredName.source === "package-name" ? "created from package.json" : "created from directory name",
+		appName: options.name,
+		region: options.newAppRegion,
+		displayName: options.name,
+		annotation: options.newAnnotation,
 		firstDeploy: options.firstDeploy
 	};
 }
-async function resolveAmbiguousDeployApp(context, matches, targetName, firstDeploy) {
+function assertDeployRegionMatchesExistingApp(app, requestedRegion) {
+	if (requestedRegion?.annotation !== "set by --region" || !app.region || app.region === requestedRegion.value) return;
+	throw usageError("App already exists in another region", `The selected app "${app.name}" is in region "${app.region}", but --region requested "${requestedRegion.value}".`, "Remove --region to deploy the existing app, or pass --app <new-name> to create a new app in that region.", [`prisma-cli app deploy --app ${formatCommandArgument(app.name)}`, `prisma-cli app deploy --app <new-name> --region ${formatCommandArgument(requestedRegion.value)}`], "app");
+}
+async function resolveAmbiguousDeployApp(context, matches, targetName, requestedRegion, newAppRegion, firstDeploy) {
 	if (canPrompt(context)) {
 		const createNew = "__create_new_app__";
 		const cancel = "__cancel__";
@@ -1093,11 +1406,12 @@ async function resolveAmbiguousDeployApp(context, matches, targetName, firstDepl
 		if (selected === cancel) throw usageError("App selection canceled", "The command was canceled before an app was selected.", "Re-run the command and choose an app, or pass --app <name>.", ["prisma-cli app deploy --app <name>"], "app");
 		if (selected === createNew) return {
 			appName: targetName,
-			region: PREVIEW_DEFAULT_REGION,
+			region: newAppRegion,
 			displayName: targetName,
 			annotation: "created from package.json",
 			firstDeploy
 		};
+		assertDeployRegionMatchesExistingApp(selected, requestedRegion);
 		return {
 			appId: selected.id,
 			displayName: selected.name,
@@ -1119,6 +1433,9 @@ async function resolveAmbiguousDeployApp(context, matches, targetName, firstDepl
 		nextSteps: ["prisma-cli app deploy --app <name>"]
 	});
 }
+function deployNewAppRegion(configRegion) {
+	return configRegion?.value;
+}
 async function resolveExistingAppSelection(context, projectId, apps, explicitAppName) {
 	if (explicitAppName) {
 		const matched = findAppByName(apps, explicitAppName);
@@ -1161,6 +1478,7 @@ async function confirmAppRemoval(context, app) {
 	await textPrompt({
 		input: context.runtime.stdin,
 		output: context.output.stderr,
+		signal: context.runtime.signal,
 		message: `Type ${app.name} to confirm app removal`,
 		placeholder: app.name,
 		validate: (value) => value === app.name ? void 0 : `Type "${app.name}" to confirm removal.`
@@ -1193,13 +1511,21 @@ function requireDeploymentForApp(deployments, deploymentId, appName) {
 		nextSteps: ["prisma-cli app list-deploys"]
 	});
 }
+/**
+* Resolves the app's live deployment from the app pointer, the provider's live
+* flag, then locally cached state.
+*
+* @returns the live deployment id, or null when no authoritative signal exists.
+* Callers must treat null as "not known to be live" rather than assuming the
+* newest deployment is live.
+*/
 async function resolveCurrentLiveDeploymentId(context, projectId, app, deployments) {
 	if (app.liveDeploymentId && deployments.some((deployment) => deployment.id === app.liveDeploymentId)) return app.liveDeploymentId;
 	const providerLiveDeployment = deployments.find((deployment) => deployment.live === true);
 	if (providerLiveDeployment) return providerLiveDeployment.id;
 	const knownLiveDeploymentId = await context.stateStore.readKnownLiveDeployment(projectId, app.id);
 	if (knownLiveDeploymentId && deployments.some((deployment) => deployment.id === knownLiveDeploymentId)) return knownLiveDeploymentId;
-	return deployments[0]?.id ?? null;
+	return null;
 }
 function buildAppShowNextSteps(liveUrl, liveDeployment, deployments) {
 	const nextSteps = [];
@@ -1258,7 +1584,7 @@ async function requirePreviewAppProviderWithClient(context) {
 	if (!client) throw authRequiredError(["prisma-cli auth login"]);
 	return {
 		client,
-		provider: createPreviewAppProvider(client, createPreviewLogAuthOptions(context.runtime.env, context.runtime.signal))
+		provider: createAppProvider(client, createPreviewLogAuthOptions(context.runtime.env, context.runtime.signal))
 	};
 }
 function createPreviewLogAuthOptions(env, signal) {
@@ -1300,20 +1626,29 @@ async function requireProviderAndDeployProjectContext(context, explicitProject,
 async function resolveProjectContext(context, client, explicitProject, options) {
 	const authState = await requireAuthenticatedAuthState(context);
 	if (!authState.workspace) throw workspaceRequiredError();
-	const resolved = await resolveProjectTarget({
+	const resolvedResult = await resolveProjectTarget({
 		context,
 		workspace: authState.workspace,
 		explicitProject,
 		envProjectId: options?.envProjectId,
+		projectDir: options?.projectDir,
 		listProjects: () => listRealWorkspaceProjects(client, authState.workspace, context.runtime.signal),
 		commandName: options?.commandName
 	});
-	const branch = options?.branch ?? await resolveDeployBranch(context, void 0);
+	if (resolvedResult.isErr()) throw projectResolutionErrorToCliError(resolvedResult.error);
+	const resolved = resolvedResult.value;
+	const requested = options?.branch ?? await resolveDeployBranch(context, void 0);
+	const remoteBranch = options?.branch ? null : await resolveReadBranch(client, {
+		projectId: resolved.project.id,
+		branchName: requested.name,
+		signal: context.runtime.signal
+	});
 	return {
 		...resolved,
-		branch: {
-			name: branch.name,
-			kind: toBranchKind(branch.name)
+		branch: remoteBranch ?? {
+			id: null,
+			name: requested.name,
+			kind: toBranchKind(requested.name)
 		}
 	};
 }
@@ -1322,7 +1657,7 @@ async function resolveDeployProjectContext(context, client, provider, explicitPr
 	if (!workspace) throw workspaceRequiredError();
 	const branch = options.branch ?? await resolveDeployBranch(context, void 0);
 	const projects = await listRealWorkspaceProjects(client, workspace, context.runtime.signal);
-	if (explicitProject) return withDeployBranch({
+	if (explicitProject) return withRemoteDeployBranch(provider, {
 		workspace,
 		project: toProjectSummary(resolveProjectForSetup(explicitProject, projects, workspace)),
 		resolution: {
@@ -1331,25 +1666,25 @@ async function resolveDeployProjectContext(context, client, provider, explicitPr
 			targetNameSource: "explicit"
 		},
 		localPinAction: "linked"
-	}, branch);
+	}, branch, context.runtime.signal);
 	if (options.createProjectName) {
 		const projectName = options.createProjectName.trim();
 		if (!projectName) throw projectSetupNameRequiredError("app deploy --create-project");
-		return withDeployBranch({
+		return withRemoteDeployBranch(provider, {
 			workspace,
-			project: toProjectSummary(await createProjectForDeploySetup(provider, projectName, workspace, context.runtime.signal)),
+			project: toProjectSummary(await createProjectForDeploySetup(provider, projectName, workspace, context.runtime.signal, options.createProjectRegion)),
 			resolution: {
 				projectSource: "created",
 				targetName: projectName,
 				targetNameSource: "explicit"
 			},
 			localPinAction: "created"
-		}, branch);
+		}, branch, context.runtime.signal);
 	}
 	if (options.envProjectId) {
 		const project = projects.find((candidate) => candidate.id === options.envProjectId);
 		if (!project) throw projectNotFoundError(options.envProjectId, workspace);
-		return withDeployBranch({
+		return withRemoteDeployBranch(provider, {
 			workspace,
 			project: toProjectSummary(project),
 			resolution: {
@@ -1357,14 +1692,18 @@ async function resolveDeployProjectContext(context, client, provider, explicitPr
 				targetName: options.envProjectId,
 				targetNameSource: "env"
 			}
-		}, branch);
+		}, branch, context.runtime.signal);
 	}
 	const localPin = options.localPin;
 	if (localPin.kind === "present") {
-		if (localPin.pin.workspaceId !== workspace.id) throw localResolutionPinStaleError();
+		if (localPin.pin.workspaceId !== workspace.id) throw localProjectWorkspaceMismatchError({
+			pinnedWorkspaceId: localPin.pin.workspaceId,
+			pinnedProjectId: localPin.pin.projectId,
+			activeWorkspace: workspace
+		});
 		const project = projects.find((candidate) => candidate.id === localPin.pin.projectId);
 		if (!project) throw localResolutionPinStaleError();
-		return withDeployBranch({
+		return withRemoteDeployBranch(provider, {
 			workspace,
 			project: toProjectSummary(project),
 			resolution: {
@@ -1372,10 +1711,10 @@ async function resolveDeployProjectContext(context, client, provider, explicitPr
 				targetName: project.name,
 				targetNameSource: "local-pin"
 			}
-		}, branch);
+		}, branch, context.runtime.signal);
 	}
 	const platformMapping = await resolveDurablePlatformMapping();
-	if (platformMapping && platformMapping.workspace.id === workspace.id) return withDeployBranch({
+	if (platformMapping && platformMapping.workspace.id === workspace.id) return withRemoteDeployBranch(provider, {
 		workspace,
 		project: toProjectSummary(platformMapping),
 		resolution: {
@@ -1383,15 +1722,15 @@ async function resolveDeployProjectContext(context, client, provider, explicitPr
 			targetName: platformMapping.name,
 			targetNameSource: "platform-mapping"
 		}
-	}, branch);
-	if (canPrompt(context) && !context.flags.yes) return withDeployBranch(await resolveInteractiveDeployProjectSetup(context, provider, workspace, projects), branch);
+	}, branch, context.runtime.signal);
+	if (canPrompt(context) && !context.flags.yes) return withRemoteDeployBranch(provider, await resolveInteractiveDeployProjectSetup(context, provider, workspace, projects, options.createProjectRegion), branch, context.runtime.signal);
 	throw projectSetupRequiredError(projects, await inferTargetName(context.runtime.cwd, context.runtime.signal));
 }
-async function resolveInteractiveDeployProjectSetup(context, provider, workspace, projects) {
+async function resolveInteractiveDeployProjectSetup(context, provider, workspace, projects, createProjectRegion) {
 	const setup = await promptForProjectSetupChoice({
 		context,
 		projects,
-		createProject: (projectName) => createProjectForDeploySetup(provider, projectName, workspace, context.runtime.signal),
+		createProject: (projectName) => createProjectForDeploySetup(provider, projectName, workspace, context.runtime.signal, createProjectRegion),
 		cancel: {
 			why: "Deploy needs a Project before it can continue.",
 			fix: "Choose an existing Project or create a new one, then rerun deploy.",
@@ -1409,9 +1748,10 @@ async function resolveInteractiveDeployProjectSetup(context, provider, workspace
 		localPinAction: setup.action
 	};
 }
-async function createProjectForDeploySetup(provider, projectName, workspace, signal) {
+async function createProjectForDeploySetup(provider, projectName, workspace, signal, region) {
 	const created = await provider.createProject({
 		name: projectName,
+		region,
 		signal
 	}).catch((error) => {
 		throw projectCreateFailedError(error, projectName, workspace, {
@@ -1427,21 +1767,50 @@ async function createProjectForDeploySetup(provider, projectName, workspace, sig
 	return {
 		id: created.id,
 		name: created.name,
+		...created.defaultRegion != null ? { defaultRegion: created.defaultRegion } : {},
 		workspace
 	};
 }
-function withDeployBranch(target, branch) {
+async function withRemoteDeployBranch(provider, target, branch, signal) {
+	const remoteBranch = await provider.resolveBranch(target.project.id, {
+		branchName: branch.name,
+		signal
+	});
 	return {
 		...target,
 		branch: {
-			name: branch.name,
-			kind: toBranchKind(branch.name)
+			id: remoteBranch.id,
+			name: remoteBranch.name,
+			kind: remoteBranch.role
 		}
 	};
 }
 function toBranchKind(name) {
 	return name === "production" || name === "main" ? "production" : "preview";
 }
+function toResultBranch(branch) {
+	return {
+		id: branch.id,
+		name: branch.name,
+		kind: branch.kind
+	};
+}
+function toAppVerboseContext(target) {
+	return {
+		workspace: target.workspace,
+		project: target.project,
+		branch: target.branch,
+		resolution: target.resolution
+	};
+}
+function toBranchDatabaseDeployBranch(branch) {
+	if (!branch.id) throw new Error(`Deploy branch "${branch.name}" was not resolved remotely.`);
+	return {
+		id: branch.id,
+		name: branch.name,
+		kind: branch.kind
+	};
+}
 function assertExclusiveDeployProjectInputs(options) {
 	const provided = [
 		options.projectRef ? "--project" : null,
@@ -1470,58 +1839,130 @@ async function resolveDeployBranch(context, explicitBranchName) {
 		annotation: "default"
 	};
 }
-async function readLocalGitBranch(cwd, signal) {
-	const headPath = await resolveGitHeadPath(path.join(cwd, ".git"), signal);
-	if (!headPath) return null;
-	try {
-		const head = (await readFile(headPath, {
-			encoding: "utf8",
-			signal
-		})).trim();
-		if (head.startsWith("ref: refs/heads/")) return head.slice(16);
-	} catch (error) {
-		if (signal.aborted) throw error;
-		return null;
+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;
 	}
-	return null;
+	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
+	};
 }
-async function resolveGitHeadPath(gitPath, signal) {
-	signal.throwIfAborted();
+/**
+* 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 {
-		const raw = await readFile(gitPath, {
-			encoding: "utf8",
-			signal
-		});
-		if (raw.startsWith("gitdir:")) return path.join(path.resolve(path.dirname(gitPath), raw.slice(7).trim()), "HEAD");
+		await access(appDir);
+		context.runtime.signal.throwIfAborted();
 	} catch (error) {
-		if (signal.aborted) throw 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"]
+		});
 	}
-	signal.throwIfAborted();
-	try {
-		await access(path.join(gitPath, "HEAD"));
-		signal.throwIfAborted();
-		return path.join(gitPath, "HEAD");
-	} catch (error) {
-		if (signal.aborted) throw error;
-		return null;
+	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,
@@ -1536,8 +1977,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));
@@ -1550,109 +1991,52 @@ 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"
+	const detected = await detectComputeAppFromDirectory({
+		appPath: cwd,
+		signal
+	});
+	if (!detected) return null;
+	let annotation = "detected from package.json";
+	if (detected.configFile?.standaloneOutput) annotation = "standalone output detected";
+	else if (detected.configFile) annotation = `detected from ${path.basename(detected.configFile.path)}`;
+	return {
+		key: detected.framework,
+		buildType: detected.buildType,
+		displayName: detected.frameworkName,
+		annotation
 	};
-	return null;
 }
-async function detectNextConfig(cwd, signal) {
-	for (const candidate of [
-		"next.config.js",
-		"next.config.mjs",
-		"next.config.cjs",
-		"next.config.ts",
-		"next.config.mts"
-	]) {
-		const filePath = path.join(cwd, candidate);
-		signal.throwIfAborted();
-		try {
-			const content = await readFile(filePath, {
-				encoding: "utf8",
-				signal
-			});
-			return {
-				exists: true,
-				standalone: /\boutput\s*:\s*["'`]standalone["'`]/.test(content)
-			};
-		} catch (error) {
-			if (signal.aborted) throw error;
-			if (error.code !== "ENOENT") throw error;
-		}
-	}
+function frameworkFromUserFacingValue(value, annotation) {
+	const framework = frameworkFromAlias(value);
+	if (!framework) throw frameworkNotDetectedError(void 0, value);
 	return {
-		exists: false,
-		standalone: false
+		key: framework.key,
+		buildType: framework.buildType,
+		displayName: framework.displayName,
+		annotation
 	};
 }
-function hasPackageDependency(packageJson, dependencyName) {
-	return hasDependency(packageJson?.dependencies, dependencyName) || hasDependency(packageJson?.devDependencies, dependencyName);
-}
-function hasAnyPackageDependency(packageJson, dependencyNames) {
-	return dependencyNames.some((dependencyName) => hasPackageDependency(packageJson, dependencyName));
-}
-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);
-	}
+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",
@@ -1665,10 +2049,32 @@ 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 === "config" ? `Using ${resolution.relativeConfigPath}` : "Build settings";
+	context.output.stderr.write(`${title}\n${renderDeployOutputRows(context.ui, [
+		{
+			label: "Build Command",
+			value: settings.buildCommand ?? "none",
+			origin: settings.buildCommandSource ?? void 0
+		},
+		{
+			label: "Output Directory",
+			value: settings.outputDirectory,
+			origin: settings.outputDirectorySource ?? void 0
+		},
+		...settings.entrypoint ? [{
+			label: "Entrypoint",
+			value: settings.entrypoint,
+			origin: settings.entrypointSource ?? void 0
+		}] : []
+	]).join("\n")}\n\n`);
+}
 function maybeRenderProjectLinked(context, directory, projectName, localPinPath) {
 	if (context.flags.json || context.flags.quiet) return;
 	context.output.stderr.write(`${context.ui.success("✔")} Linked "${directory}" to Project "${projectName}"\nSaved ${localPinPath}\n\n`);
@@ -1685,6 +2091,7 @@ async function maybeCustomizeDeploySettings(context, options) {
 	if (!await confirmPrompt({
 		input: context.runtime.stdin,
 		output: context.runtime.stderr,
+		signal: context.runtime.signal,
 		message: "Customize build settings?",
 		initialValue: false
 	})) return {
@@ -1694,15 +2101,17 @@ async function maybeCustomizeDeploySettings(context, options) {
 	const framework = frameworkFromUserFacingValue(await selectPrompt({
 		input: context.runtime.stdin,
 		output: context.runtime.stderr,
+		signal: context.runtime.signal,
 		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({
 		input: context.runtime.stdin,
 		output: context.runtime.stderr,
+		signal: context.runtime.signal,
 		message: `HTTP port (${options.runtime.port})`,
 		placeholder: String(options.runtime.port),
 		validate: validateDeployHttpPortText
@@ -1740,14 +2149,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 {
@@ -1761,6 +2162,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;
@@ -1769,26 +2175,37 @@ async function readCurrentWorkspaceId(context) {
 function normalizeBuildType(requestedBuildType) {
 	if (!requestedBuildType) return "auto";
 	if (isPreviewBuildType(requestedBuildType)) return requestedBuildType;
-	throw usageError(`Unsupported build type "${requestedBuildType}"`, `Only ${PREVIEW_BUILD_TYPES.join(", ")} are supported in the current preview.`, "Pass a supported --build-type value.", getBuildTypeExamples("build"), "app");
+	throw usageError(`Unsupported build type "${requestedBuildType}"`, `Only ${APP_BUILD_TYPE_LABELS} are supported in the current preview.`, "Pass a supported --build-type value.", getBuildTypeExamples("build"), "app");
 }
 function isPreviewBuildType(value) {
-	return PREVIEW_BUILD_TYPES.includes(value);
+	return APP_BUILD_TYPES.includes(value);
 }
 function getBuildTypeExamples(commandName) {
-	return RESOLVED_PREVIEW_BUILD_TYPES.map((buildType) => {
+	return RESOLVED_APP_BUILD_TYPES.map((buildType) => {
 		return `prisma-cli app ${commandName} --build-type ${buildType}${buildType === "bun" ? " --entry server.ts" : ""}`;
 	});
 }
 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 (options.requestedBuildType === "auto" && options.entrypoint) return frameworkFromUserFacingValue("bun", "set by --entry");
+	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;
@@ -1805,6 +2222,19 @@ function parseDeployHttpPort(requestedPort) {
 	if (!Number.isInteger(port) || port <= 0 || port > 65535) throw usageError(`Invalid HTTP port "${requestedPort}"`, "HTTP port must be an integer between 1 and 65535.", "Pass --http-port <number> with a valid port value.", ["prisma-cli app deploy --http-port 3000"], "app");
 	return port;
 }
+function parseDeployRegion(requestedRegion, source) {
+	const region = requestedRegion.trim();
+	if (region.length === 0) throw usageError("Invalid app region", `The app region ${source} must be a non-empty region id.`, "Pass a Prisma Compute region id.", ["prisma-cli app deploy --region eu-central-1"], "app");
+	if (!COMPUTE_REGION_IDS.has(region)) throw usageError("Invalid app region", `The app region ${source} must be one of: ${COMPUTE_REGIONS.join(", ")}.`, "Pass a supported Prisma Compute region id.", ["prisma-cli app deploy --region eu-central-1"], "app");
+	return region;
+}
+function normalizeDeployRegionInput(region) {
+	if (!region) return;
+	return {
+		...region,
+		value: parseDeployRegion(region.value, region.annotation)
+	};
+}
 function ensurePreviewAppMode(context) {
 	if (isRealMode(context)) return;
 	throw featureUnavailableError("App commands are not available in fixture mode", "Preview app commands require live app deployment integration.", "Rerun without fixture mode enabled to use preview app deployment workflows.", ["prisma-cli auth login", "prisma-cli project show"], "app");
@@ -1861,7 +2291,7 @@ function appDeployFailedError(error, progress) {
 	}
 	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."];
+	const recoveryLines = progress.deploymentId ? ["See what happened", `prisma-cli app logs --deployment ${progress.deploymentId}`] : ["Fix", "Retry the command, or rerun with --trace for more detailed diagnostics."];
 	const urlLines = progress.deploymentUrl ? [
 		"",
 		"URL",
@@ -1887,11 +2317,11 @@ function appDeployFailedError(error, progress) {
 		domain: "app",
 		summary: phaseHeadline,
 		why,
-		fix: progress.versionId ? `Inspect logs with prisma-cli app logs --deployment ${progress.versionId}.` : "Retry the command, or rerun with --trace for more detailed diagnostics.",
+		fix: progress.deploymentId ? `Inspect logs with prisma-cli app logs --deployment ${progress.deploymentId}.` : "Retry the command, or rerun with --trace for more detailed diagnostics.",
 		debug,
 		meta: {
 			phase: progress.containerLive ? "runtime_ready" : "deploy",
-			deploymentId: progress.versionId,
+			deploymentId: progress.deploymentId,
 			deploymentUrl: progress.deploymentUrl
 		},
 		humanLines,
@@ -1915,6 +2345,18 @@ function localResolutionPinStaleError() {
 		]
 	});
 }
+function localPinReadErrorToDeployError(error) {
+	return matchError(error, {
+		LocalResolutionPinInvalidJsonError: () => localResolutionPinStaleError(),
+		LocalResolutionPinInvalidShapeError: () => localResolutionPinStaleError(),
+		LocalResolutionPinReadAbortedError: (error) => {
+			throw error;
+		},
+		UnhandledException: (error) => {
+			throw error;
+		}
+	});
+}
 function readDeployEnvOverride(context, name) {
 	const value = context.runtime.env[name]?.trim();
 	return value ? value : void 0;
@@ -1993,14 +2435,12 @@ function isAutoBuildDetectionError(error) {
 	return error instanceof Error && error.message.startsWith("Entrypoint is required.");
 }
 function formatBuildTypeName(buildType) {
-	switch (buildType) {
-		case "nextjs": return "Next.js";
-		case "nuxt": return "Nuxt";
-		case "astro": return "Astro";
-		case "tanstack-start": return "TanStack Start";
-		case "bun": return "Bun";
-		case "auto": return "Auto";
+	if (buildType === "auto") return "Auto";
+	for (let index = FRAMEWORKS.length - 1; index >= 0; index -= 1) {
+		const framework = FRAMEWORKS[index];
+		if (framework?.buildType === buildType) return framework.displayName;
 	}
+	return buildType;
 }
 function removeFailedError(summary, error, nextSteps) {
 	return new CliError({
@@ -2037,4 +2477,4 @@ function toOptionalEnvVars(envVars) {
 	return Object.keys(envVars).length > 0 ? envVars : void 0;
 }
 //#endregion
-export { runAppBuild, runAppDeploy, runAppDomainAdd, runAppDomainRemove, runAppDomainRetry, runAppDomainShow, runAppDomainWait, runAppListDeploys, runAppLogs, runAppOpen, runAppPromote, runAppRemove, runAppRollback, runAppRun, runAppShow, runAppShowDeploy };
+export { detectDeployFramework, runAppBuild, runAppDeploy, runAppDomainAdd, runAppDomainRemove, runAppDomainRetry, runAppDomainShow, runAppDomainWait, runAppListDeploys, runAppLogs, runAppOpen, runAppPromote, runAppRemove, runAppRollback, runAppRun, runAppShow, runAppShowDeploy };