@prisma/cli 3.0.0-beta.1 → 3.0.0-beta.11

package/dist/controllers/app.js

@@ -1,54 +1,79 @@
 import { SERVICE_TOKEN_ENV_VAR, getApiBaseUrl } from "../lib/auth/client.js";
 import { FileTokenStorage } from "../adapters/token-storage.js";
 import { CliError, authRequiredError, featureUnavailableError, usageError, workspaceRequiredError } from "../shell/errors.js";
+import { confirmPrompt, selectPrompt, textPrompt } from "../shell/prompt.js";
 import { renderCommandHeader } from "../shell/ui.js";
-import { writeJsonEvent } from "../shell/output.js";
 import { canPrompt } from "../shell/runtime.js";
-import { confirmPrompt, selectPrompt, textPrompt } from "../shell/prompt.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 } 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 { promptForProjectSetupChoice } from "../lib/project/interactive-setup.js";
+import { formatCommandArgument } from "../shell/command-arguments.js";
+import { buildProjectSetupNextActions, inferTargetName, 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 { formatDomainFailureFix } from "../lib/app/domain-guidance.js";
+import { envVarNames, parseEnvInputs } from "../lib/app/env-vars.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";
 import { PreviewDomainApiError, createPreviewAppProvider } from "../lib/app/preview-provider.js";
-import { formatDomainFailureFix } from "../lib/app/domain-guidance.js";
+import { enforceProductionDeployGate } from "../lib/app/production-deploy-gate.js";
+import { requireComputeAuth } from "../lib/auth/guard.js";
+import { readAuthState } from "../lib/auth/auth-ops.js";
+import { readLocalGitBranch } from "../lib/git/local-branch.js";
+import { promptForProjectSetupChoice } from "../lib/project/interactive-setup.js";
+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,
-			buildType
+			appPath: appDir,
+			entrypoint: merged.entrypoint,
+			buildType,
+			buildSettings,
+			signal: context.runtime.signal
 		});
 		return {
 			command: "app.build",
@@ -65,25 +90,42 @@ 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
+			env: context.runtime.env,
+			signal: context.runtime.signal
 		});
 	} catch (error) {
 		throw runFailedError("Local app run failed", error);
 	}
-	if (runResult.signal === "SIGINT" || runResult.signal === "SIGTERM") process.exitCode = runResult.signal === "SIGINT" ? 130 : 143;
+	if (runResult.signal === "SIGINT" || runResult.signal === "SIGTERM") throw new DOMException("Command canceled", "AbortError");
 	else if (runResult.exitCode !== 0) throw runFailedError("Local app run failed", `The ${formatFrameworkName(runResult.framework)} process exited with code ${runResult.exitCode}.`, runResult.exitCode);
 	return {
 		command: "app.run",
@@ -99,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({
@@ -106,14 +248,27 @@ 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);
-	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,
+			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,
@@ -123,25 +278,32 @@ async function runAppDeploy(context, appName, options) {
 	});
 	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,
 		firstDeploy: Boolean(target.localPinAction),
-		inferName: () => inferTargetName(context.runtime.cwd)
+		inferName: () => inferTargetName(appDir, context.runtime.signal)
 	});
 	await maybeRenderDeploySetupBlock(context, {
 		includeDirectory: !target.localPinAction,
+		appDir,
 		projectName: target.project.name,
 		branchName: target.branch.name,
 		appName: selectedApp.displayName
@@ -150,20 +312,46 @@ 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 productionDeployGate = 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);
+	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,
+		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,
@@ -171,9 +359,11 @@ async function runAppDeploy(context, appName, options) {
 		region: selectedApp.region,
 		entrypoint,
 		buildType,
+		buildSettings: buildSettingsResolution.settings,
 		portMapping,
 		envVars,
 		interaction: void 0,
+		signal: context.runtime.signal,
 		progress: createPreviewDeployProgress(context.output.stderr, context.ui, !context.flags.json && !context.flags.quiet, progressState)
 	}).catch((error) => {
 		throw appDeployFailedError(error, progressState);
@@ -189,35 +379,65 @@ async function runAppDeploy(context, appName, options) {
 		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,
+			deploySettings: {
+				config: {
+					path: buildSettingsResolution.relativeConfigPath,
+					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 ?? null,
+				httpPort: runtime.port,
+				region: selectedApp.region ?? null,
+				envVars: envVarNames(envVars)
+			},
 			durationMs: deployDurationMs,
 			localPin: localPinResult
 		},
-		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: {
 			projectId,
+			verboseContext: toAppVerboseContext(target),
 			app: null,
 			deployments: []
 		},
 		warnings: [],
 		nextSteps: ["prisma-cli app deploy"]
 	};
-	const deploymentsResult = await provider.listDeployments(selectedApp.id).catch((error) => {
+	const deploymentsResult = await provider.listDeployments(selectedApp.id, { signal: context.runtime.signal }).catch((error) => {
 		throw deployFailedError("Failed to list app deployments", error, ["prisma-cli app deploy"]);
 	});
 	const currentLiveDeploymentId = await resolveCurrentLiveDeploymentId(context, projectId, deploymentsResult.app, deploymentsResult.deployments);
@@ -230,6 +450,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
@@ -240,14 +461,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,
@@ -256,7 +482,7 @@ async function runAppShow(context, appName, projectRef) {
 		warnings: [],
 		nextSteps: ["prisma-cli app deploy"]
 	};
-	const deploymentsResult = await provider.listDeployments(selectedApp.id).catch((error) => {
+	const deploymentsResult = await provider.listDeployments(selectedApp.id, { signal: context.runtime.signal }).catch((error) => {
 		throw deployFailedError("Failed to inspect app", error, ["prisma-cli app list-deploys"]);
 	});
 	const currentLiveDeploymentId = await resolveCurrentLiveDeploymentId(context, projectId, deploymentsResult.app, deploymentsResult.deployments);
@@ -270,6 +496,7 @@ async function runAppShow(context, appName, projectRef) {
 		command: "app.show",
 		result: {
 			projectId,
+			verboseContext: toAppVerboseContext(target),
 			app: {
 				id: deploymentsResult.app.id,
 				name: deploymentsResult.app.name
@@ -284,7 +511,7 @@ async function runAppShow(context, appName, projectRef) {
 }
 async function runAppShowDeploy(context, deploymentId) {
 	ensurePreviewAppMode(context);
-	const deployment = await (await requirePreviewAppProvider(context)).showDeployment(deploymentId).catch((error) => {
+	const deployment = await (await requirePreviewAppProvider(context)).showDeployment(deploymentId, { signal: context.runtime.signal }).catch((error) => {
 		throw deployFailedError("Failed to show deployment", error, ["prisma-cli app list-deploys"]);
 	});
 	if (!deployment) throw new CliError({
@@ -316,12 +543,17 @@ 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).catch((error) => {
+	const deploymentsResult = await provider.listDeployments(selectedApp.id, { signal: context.runtime.signal }).catch((error) => {
 		throw deployFailedError("Failed to resolve app URL", error, ["prisma-cli app show"]);
 	});
 	const currentLiveDeploymentId = await resolveCurrentLiveDeploymentId(context, projectId, deploymentsResult.app, deploymentsResult.deployments);
@@ -334,11 +566,16 @@ async function runAppOpen(context, appName, projectRef) {
 	if (!liveDeployment) throw noDeploymentsError("No deployments available to open", `The selected app "${deploymentsResult.app.name}" does not have any deployments yet.`);
 	if (!deploymentsResult.app.liveUrl) throw featureUnavailableError("Live URL is not available for the selected app", "Deployments exist, but the provider does not expose a stable live service URL for this app yet.", "Run prisma-cli app show to inspect the current deployment state and try again after the app reports a live URL.", ["prisma-cli app show"], "app");
 	const shouldOpen = canPrompt(context);
-	if (shouldOpen) await open(deploymentsResult.app.liveUrl);
+	if (shouldOpen) {
+		context.runtime.signal.throwIfAborted();
+		await open(deploymentsResult.app.liveUrl);
+		context.runtime.signal.throwIfAborted();
+	}
 	return {
 		command: "app.open",
 		result: {
 			projectId,
+			verboseContext: toAppVerboseContext(target),
 			app: {
 				id: deploymentsResult.app.id,
 				name: deploymentsResult.app.name
@@ -355,7 +592,8 @@ async function runAppDomainAdd(context, hostname, options) {
 	const target = await resolveAppDomainTarget(context, options, `app domain add ${normalizedHostname}`);
 	const added = await target.provider.addDomain({
 		appId: target.app.id,
-		hostname: normalizedHostname
+		hostname: normalizedHostname,
+		signal: context.runtime.signal
 	}).catch((error) => {
 		throw domainCommandError("add", error, normalizedHostname);
 	});
@@ -373,8 +611,8 @@ async function runAppDomainAdd(context, hostname, options) {
 async function runAppDomainShow(context, hostname, options) {
 	const normalizedHostname = normalizeDomainHostname(hostname);
 	const target = await resolveAppDomainTarget(context, options, `app domain show ${normalizedHostname}`);
-	const domain = await resolveDomainByHostname(target.provider, target.app.id, normalizedHostname, "show");
-	const detail = await target.provider.showDomain(domain.id).catch((error) => {
+	const domain = await resolveDomainByHostname(target.provider, target.app.id, normalizedHostname, "show", context.runtime.signal);
+	const detail = await target.provider.showDomain(domain.id, { signal: context.runtime.signal }).catch((error) => {
 		throw domainCommandError("show", error, normalizedHostname);
 	});
 	return {
@@ -390,9 +628,9 @@ async function runAppDomainShow(context, hostname, options) {
 async function runAppDomainRemove(context, hostname, options) {
 	const normalizedHostname = normalizeDomainHostname(hostname);
 	const target = await resolveAppDomainTarget(context, options, `app domain remove ${normalizedHostname}`);
-	const domain = await resolveDomainByHostname(target.provider, target.app.id, normalizedHostname, "remove");
+	const domain = await resolveDomainByHostname(target.provider, target.app.id, normalizedHostname, "remove", context.runtime.signal);
 	await confirmDomainRemoval(context, target.resultTarget, normalizedHostname);
-	await target.provider.removeDomain(domain.id).catch((error) => {
+	await target.provider.removeDomain(domain.id, { signal: context.runtime.signal }).catch((error) => {
 		throw domainCommandError("remove", error, normalizedHostname);
 	});
 	return {
@@ -409,8 +647,8 @@ async function runAppDomainRemove(context, hostname, options) {
 async function runAppDomainRetry(context, hostname, options) {
 	const normalizedHostname = normalizeDomainHostname(hostname);
 	const target = await resolveAppDomainTarget(context, options, `app domain retry ${normalizedHostname}`);
-	const domain = await resolveDomainByHostname(target.provider, target.app.id, normalizedHostname, "retry");
-	const retried = await target.provider.retryDomain(domain.id).catch((error) => {
+	const domain = await resolveDomainByHostname(target.provider, target.app.id, normalizedHostname, "retry", context.runtime.signal);
+	const retried = await target.provider.retryDomain(domain.id, { signal: context.runtime.signal }).catch((error) => {
 		throw domainCommandError("retry", error, normalizedHostname);
 	});
 	return {
@@ -427,7 +665,7 @@ async function runAppDomainWait(context, hostname, options) {
 	const normalizedHostname = normalizeDomainHostname(hostname);
 	const timeoutMs = parseDomainWaitTimeout(options?.timeout);
 	const target = await resolveAppDomainTarget(context, options, `app domain wait ${normalizedHostname}`);
-	const domain = await resolveDomainByHostname(target.provider, target.app.id, normalizedHostname, "wait");
+	const domain = await resolveDomainByHostname(target.provider, target.app.id, normalizedHostname, "wait", context.runtime.signal);
 	if (!context.flags.json && !context.flags.quiet) context.output.stderr.write([
 		`app domain wait -> Waiting for ${normalizedHostname} to become active.`,
 		"",
@@ -470,21 +708,25 @@ async function runAppDomainWait(context, hostname, options) {
 			exitCode: 1,
 			nextSteps: [`prisma-cli app domain show ${normalizedHostname}`]
 		});
-		await sleep(Math.min(pollIntervalMs, Math.max(deadline - Date.now(), 0)));
-		current = await target.provider.showDomain(current.id).catch((error) => {
+		await sleep(Math.min(pollIntervalMs, Math.max(deadline - Date.now(), 0)), context.runtime.signal);
+		current = await target.provider.showDomain(current.id, { signal: context.runtime.signal }).catch((error) => {
 			throw domainCommandError("wait", error, normalizedHostname);
 		});
 	}
 }
-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",
@@ -504,6 +746,7 @@ async function runAppLogs(context, appName, deploymentId, projectRef) {
 	}
 	await provider.streamDeploymentLogs({
 		deploymentId: target.deployment.id,
+		signal: context.runtime.signal,
 		onRecord: (record) => writeLogRecord(context, record)
 	}).catch((error) => {
 		throw deployFailedError("Failed to stream app logs", error, [`prisma-cli app show-deploy ${target.deployment.id}`, "prisma-cli app list-deploys"]);
@@ -513,7 +756,7 @@ async function resolveExplicitLogDeployment(context, provider, projectId, branch
 	if (appName) {
 		const selectedApp = await resolveExistingAppSelection(context, projectId, await listApps(context, provider, projectId, branchName), appName);
 		if (!selectedApp) throw noDeploymentsError("No deployments available to stream logs", "The resolved project does not have any deployed app yet.");
-		const deploymentsResult = await provider.listDeployments(selectedApp.id).catch((error) => {
+		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"]);
 		});
 		const deployment = requireDeploymentForApp(deploymentsResult.deployments, deploymentId, selectedApp.name);
@@ -526,7 +769,7 @@ async function resolveExplicitLogDeployment(context, provider, projectId, branch
 			deployment
 		};
 	}
-	const shown = await provider.showDeployment(deploymentId).catch((error) => {
+	const shown = await provider.showDeployment(deploymentId, { signal: context.runtime.signal }).catch((error) => {
 		throw deployFailedError("Failed to show deployment", error, ["prisma-cli app list-deploys"]);
 	});
 	if (!shown) throw new CliError({
@@ -569,7 +812,7 @@ async function resolveExplicitLogDeployment(context, provider, projectId, branch
 async function resolveLiveLogDeployment(context, provider, projectId, branchName, appName) {
 	const selectedApp = await resolveExistingAppSelection(context, projectId, await listApps(context, provider, projectId, branchName), appName);
 	if (!selectedApp) throw noDeploymentsError("No deployments available to stream logs", "The resolved project does not have any deployed app yet.");
-	const deploymentsResult = await provider.listDeployments(selectedApp.id).catch((error) => {
+	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"]);
 	});
 	const currentLiveDeploymentId = await resolveCurrentLiveDeploymentId(context, projectId, deploymentsResult.app, deploymentsResult.deployments);
@@ -600,11 +843,16 @@ 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).catch((error) => {
+	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"]);
 	});
 	const currentLiveDeploymentId = await resolveCurrentLiveDeploymentId(context, projectId, deploymentsResult.app, deploymentsResult.deployments);
@@ -617,6 +865,7 @@ async function runAppPromote(context, deploymentId, appName, projectRef) {
 	if (!targetAlreadyLive) await provider.promoteDeployment({
 		appId: selectedApp.id,
 		deploymentId: targetDeployment.id,
+		signal: context.runtime.signal,
 		progress: createPreviewPromoteProgress(context.output.stderr, !context.flags.json && !context.flags.quiet)
 	}).catch((error) => {
 		throw deployFailedError("Failed to promote deployment", error, ["prisma-cli app list-deploys"]);
@@ -626,6 +875,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
@@ -640,11 +890,16 @@ 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).catch((error) => {
+	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"]);
 	});
 	const currentLiveDeploymentId = await resolveCurrentLiveDeploymentId(context, projectId, deploymentsResult.app, deploymentsResult.deployments);
@@ -658,6 +913,7 @@ async function runAppRollback(context, appName, deploymentId, projectRef) {
 	if (!targetAlreadyLive) await provider.promoteDeployment({
 		appId: selectedApp.id,
 		deploymentId: targetDeployment.id,
+		signal: context.runtime.signal,
 		progress: createPreviewPromoteProgress(context.output.stderr, !context.flags.json && !context.flags.quiet)
 	}).catch((error) => {
 		throw deployFailedError("Failed to roll back deployment", error, ["prisma-cli app list-deploys"]);
@@ -667,6 +923,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
@@ -682,12 +939,17 @@ 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).catch((error) => {
+	const removedApp = await provider.removeApp(selectedApp.id, { signal: context.runtime.signal }).catch((error) => {
 		throw removeFailedError("Failed to remove app", error, ["prisma-cli app show", "prisma-cli app list-deploys"]);
 	});
 	const warnings = await cleanupRemovedAppState(context, projectId, removedApp.id);
@@ -695,6 +957,7 @@ async function runAppRemove(context, appName, projectRef) {
 		command: "app.remove",
 		result: {
 			projectId,
+			verboseContext: toAppVerboseContext(target),
 			app: {
 				id: removedApp.id,
 				name: removedApp.name
@@ -707,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",
@@ -722,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, {
@@ -738,7 +1003,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
@@ -762,8 +1027,8 @@ async function resolveDomainAppSelection(context, projectId, apps, options) {
 	if (selectedApp) return selectedApp;
 	throw usageError("Custom domain requires an existing app on the production branch", "The resolved production branch does not have an app that can receive a custom domain.", "Deploy or promote an app to production first, then rerun the domain command.", ["prisma-cli app deploy --branch production", "prisma-cli app show"], "app");
 }
-async function resolveDomainByHostname(provider, appId, hostname, command) {
-	const matched = (await provider.listDomains(appId).catch((error) => {
+async function resolveDomainByHostname(provider, appId, hostname, command, signal) {
+	const matched = (await provider.listDomains(appId, { signal }).catch((error) => {
 		throw domainCommandError(command, error, hostname);
 	})).find((domain) => sameDomainHostname(domain.hostname, hostname));
 	if (matched) return matched;
@@ -994,9 +1259,20 @@ function formatElapsed(milliseconds) {
 	const remainingSeconds = seconds % 60;
 	return `${minutes}:${String(remainingSeconds).padStart(2, "0")}`;
 }
-async function sleep(milliseconds) {
+async function sleep(milliseconds, signal) {
 	if (milliseconds <= 0) return;
-	await new Promise((resolve) => setTimeout(resolve, milliseconds));
+	signal.throwIfAborted();
+	await new Promise((resolve, reject) => {
+		const onAbort = () => {
+			clearTimeout(timeout);
+			reject(signal.reason);
+		};
+		const timeout = setTimeout(() => {
+			signal.removeEventListener("abort", onAbort);
+			resolve();
+		}, milliseconds);
+		signal.addEventListener("abort", onAbort, { once: true });
+	});
 }
 async function resolveDeployAppSelection(context, projectId, apps, options) {
 	if (options.explicitAppName) {
@@ -1027,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);
@@ -1211,7 +1506,10 @@ function resolveRollbackTarget(deployments, currentLiveDeploymentId) {
 	});
 }
 async function listApps(context, provider, projectId, branchName) {
-	return provider.listApps(projectId, { branchName }).then(sortApps).catch((error) => {
+	return provider.listApps(projectId, {
+		branchName,
+		signal: context.runtime.signal
+	}).then(sortApps).catch((error) => {
 		if (isMissingProjectError(error)) throw new CliError({
 			code: "PROJECT_NOT_FOUND",
 			domain: "project",
@@ -1229,20 +1527,20 @@ async function requirePreviewAppProvider(context) {
 	return provider;
 }
 async function requirePreviewAppProviderWithClient(context) {
-	const client = await requireComputeAuth(context.runtime.env);
+	const client = await requireComputeAuth(context.runtime.env, context.runtime.signal);
 	if (!client) throw authRequiredError(["prisma-cli auth login"]);
 	return {
 		client,
-		provider: createPreviewAppProvider(client, createPreviewLogAuthOptions(context.runtime.env))
+		provider: createPreviewAppProvider(client, createPreviewLogAuthOptions(context.runtime.env, context.runtime.signal))
 	};
 }
-function createPreviewLogAuthOptions(env) {
+function createPreviewLogAuthOptions(env, signal) {
 	const rawToken = env[SERVICE_TOKEN_ENV_VAR]?.trim();
 	if (rawToken) return {
 		baseUrl: getApiBaseUrl(env),
 		getToken: async () => rawToken
 	};
-	const tokenStorage = new FileTokenStorage(env);
+	const tokenStorage = new FileTokenStorage(env, signal);
 	return {
 		baseUrl: getApiBaseUrl(env),
 		getToken: async () => {
@@ -1275,18 +1573,22 @@ 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,
-		listProjects: () => listRealWorkspaceProjects(client, authState.workspace),
+		projectDir: options?.projectDir,
+		listProjects: () => listRealWorkspaceProjects(client, authState.workspace, context.runtime.signal),
 		commandName: options?.commandName
 	});
+	if (resolvedResult.isErr()) throw projectResolutionErrorToCliError(resolvedResult.error);
+	const resolved = resolvedResult.value;
 	const branch = options?.branch ?? await resolveDeployBranch(context, void 0);
 	return {
 		...resolved,
 		branch: {
+			id: null,
 			name: branch.name,
 			kind: toBranchKind(branch.name)
 		}
@@ -1296,8 +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);
-	const projects = await listRealWorkspaceProjects(client, workspace);
-	if (explicitProject) return withDeployBranch({
+	const projects = await listRealWorkspaceProjects(client, workspace, context.runtime.signal);
+	if (explicitProject) return withRemoteDeployBranch(provider, {
 		workspace,
 		project: toProjectSummary(resolveProjectForSetup(explicitProject, projects, workspace)),
 		resolution: {
@@ -1306,25 +1608,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)),
+			project: toProjectSummary(await createProjectForDeploySetup(provider, projectName, workspace, context.runtime.signal)),
 			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: {
@@ -1332,14 +1634,14 @@ 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();
 		const project = projects.find((candidate) => candidate.id === localPin.pin.projectId);
 		if (!project) throw localResolutionPinStaleError();
-		return withDeployBranch({
+		return withRemoteDeployBranch(provider, {
 			workspace,
 			project: toProjectSummary(project),
 			resolution: {
@@ -1347,10 +1649,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: {
@@ -1358,15 +1660,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);
-	throw projectSetupRequiredError(projects, await inferTargetName(context.runtime.cwd));
+	}, 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({
 		context,
 		projects,
-		createProject: (projectName) => createProjectForDeploySetup(provider, projectName, workspace),
+		createProject: (projectName) => createProjectForDeploySetup(provider, projectName, workspace, context.runtime.signal),
 		cancel: {
 			why: "Deploy needs a Project before it can continue.",
 			fix: "Choose an existing Project or create a new one, then rerun deploy.",
@@ -1384,8 +1686,11 @@ async function resolveInteractiveDeployProjectSetup(context, provider, workspace
 		localPinAction: setup.action
 	};
 }
-async function createProjectForDeploySetup(provider, projectName, workspace) {
-	const created = await provider.createProject({ name: projectName }).catch((error) => {
+async function createProjectForDeploySetup(provider, projectName, workspace, signal) {
+	const created = await provider.createProject({
+		name: projectName,
+		signal
+	}).catch((error) => {
 		throw projectCreateFailedError(error, projectName, workspace, {
 			nextSteps: [
 				"prisma-cli project list",
@@ -1402,18 +1707,46 @@ async function createProjectForDeploySetup(provider, projectName, workspace) {
 		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,
@@ -1432,7 +1765,7 @@ async function resolveDeployBranch(context, explicitBranchName) {
 		name: explicitBranchName,
 		annotation: "set by --branch"
 	};
-	const gitBranch = await readLocalGitBranch(context.runtime.cwd);
+	const gitBranch = await readLocalGitBranch(context.runtime.cwd, context.runtime.signal);
 	if (gitBranch) return {
 		name: gitBranch,
 		annotation: "from local Git branch"
@@ -1442,45 +1775,130 @@ async function resolveDeployBranch(context, explicitBranchName) {
 		annotation: "default"
 	};
 }
-async function readLocalGitBranch(cwd) {
-	const headPath = await resolveGitHeadPath(path.join(cwd, ".git"));
-	if (!headPath) return null;
-	try {
-		const head = (await readFile(headPath, "utf8")).trim();
-		if (head.startsWith("ref: refs/heads/")) return head.slice(16);
-	} catch {
-		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) {
-	try {
-		const raw = await readFile(gitPath, "utf8");
-		if (raw.startsWith("gitdir:")) return path.join(path.resolve(path.dirname(gitPath), raw.slice(7).trim()), "HEAD");
-	} catch {}
+/**
+* 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(path.join(gitPath, "HEAD"));
-		return path.join(gitPath, "HEAD");
-	} catch {
-		return null;
+		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);
+	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,
@@ -1491,65 +1909,62 @@ function assertSupportedEntrypointForRequestedDeployShape(options) {
 	if (!options.requestedFramework) return;
 	assertSupportedEntrypoint(frameworkFromUserFacingValue(options.requestedFramework, "set by --framework").buildType, options.entrypoint, "deploy");
 }
-async function resolveDeployEntrypoint(cwd, framework, explicitEntrypoint) {
+async function resolveDeployEntrypoint(cwd, framework, explicitEntrypoint, signal) {
 	if (explicitEntrypoint || framework.buildType !== "bun") return explicitEntrypoint;
-	const packageEntrypoint = readBunPackageEntrypoint(await readBunPackageJson(cwd));
+	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));
+		signal.throwIfAborted();
 		return defaultEntrypoint;
 	} catch (error) {
+		if (signal.aborted) throw error;
 		if (error.code !== "ENOENT") throw error;
 		return;
 	}
 }
-async function detectDeployFramework(cwd) {
-	const packageJson = await readBunPackageJson(cwd);
-	const nextConfig = await detectNextConfig(cwd);
-	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"
-	};
+async function detectDeployFramework(cwd, signal) {
+	const packageJson = await readBunPackageJson(cwd, signal);
+	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) {
-	for (const candidate of [
-		"next.config.js",
-		"next.config.mjs",
-		"next.config.cjs",
-		"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 {
-			const content = await readFile(filePath, "utf8");
+			const content = await readFile(filePath, {
+				encoding: "utf8",
+				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;
 			if (error.code !== "ENOENT") throw error;
 		}
 	}
 	return {
 		exists: false,
-		standalone: false
+		standalone: false,
+		path: null
 	};
 }
 function hasPackageDependency(packageJson, dependencyName) {
@@ -1562,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",
@@ -1616,10 +2024,24 @@ 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
+	}]).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`);
@@ -1629,10 +2051,14 @@ async function maybeCustomizeDeploySettings(context, options) {
 		framework: options.framework,
 		runtime: options.runtime
 	};
+	maybeRenderDeploySettingsPreview(context, {
+		framework: options.framework,
+		runtime: options.runtime
+	});
 	if (!await confirmPrompt({
 		input: context.runtime.stdin,
 		output: context.runtime.stderr,
-		message: "Customize settings?",
+		message: "Customize build settings?",
 		initialValue: false
 	})) return {
 		framework: options.framework,
@@ -1642,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({
@@ -1677,13 +2103,15 @@ async function maybeCustomizeDeploySettings(context, options) {
 		runtime
 	};
 }
-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 maybeRenderDeploySettingsPreview(context, options) {
+	if (context.flags.quiet || context.flags.json) return;
+	context.output.stderr.write(`Detected ${options.framework.displayName}\n${renderDeploySettingsPreview(context.ui, [{
+		key: "framework",
+		value: options.framework.displayName
+	}, {
+		key: "runtime",
+		value: `HTTP ${options.runtime.port}`
+	}]).join("\n")}\n\n`);
 }
 function validateDeployHttpPortText(value) {
 	if (!value?.trim()) return;
@@ -1698,10 +2126,15 @@ 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;
-	return (await readAuthState(context.runtime.env)).workspace?.id ?? null;
+	return (await readAuthState(context.runtime.env, context.runtime.signal)).workspace?.id ?? null;
 }
 function normalizeBuildType(requestedBuildType) {
 	if (!requestedBuildType) return "auto";
@@ -1717,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);
-	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;
@@ -1852,6 +2295,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;