@prisma/cli 3.0.0-beta.8 → 3.0.0-dev.101.1

package/dist/controllers/app.js

@@ -1,58 +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 { 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 { DEFAULT_REGION } from "../lib/app/app-interaction.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 { 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 { DomainApiError, createAppProvider } from "../lib/app/app-provider.js";
+import { renderCommandHeader } from "../shell/ui.js";
+import { canPrompt } from "../shell/runtime.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 { readLocalGitBranch } from "../lib/git/local-branch.js";
-import { resolveOrCreatePreviewBuildSettings } 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 { formatCommandArgument } from "../shell/command-arguments.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 { createPreviewDeployProgress, createPreviewDeployProgressState, createPreviewPromoteProgress } from "../lib/app/preview-progress.js";
-import { PreviewDomainApiError, createPreviewAppProvider } from "../lib/app/preview-provider.js";
-import { enforceProductionDeployGate } from "../lib/app/production-deploy-gate.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 { 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 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 {
@@ -66,21 +87,37 @@ 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
+	});
+	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,
@@ -105,6 +142,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({
@@ -112,14 +249,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, 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,
+			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,
@@ -129,25 +279,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(await parseEnvInputs(context.runtime.cwd, options?.envAssignments, { commandName: "deploy" }));
+		requestedFramework: merged.framework?.value,
+		requestedFrameworkAnnotation: merged.framework?.annotation,
+		entrypoint: merged.entrypoint?.value,
+		entrypointAnnotation: merged.entrypoint?.annotation,
+		appDir
+	});
+	let runtime = resolveDeployRuntime(merged.httpPort?.value, merged.httpPort?.annotation, framework);
+	assertSupportedEntrypoint(framework.buildType, merged.entrypoint?.value, "deploy");
+	const envVars = toOptionalEnvVars(await parseEnvInputs(merged.envInputsFromConfig ? projectDir : context.runtime.cwd, merged.envInputs, { commandName: "deploy" }));
 	const selectedApp = await resolveDeployAppSelection(context, projectId, await listApps(context, provider, projectId, target.branch.name), {
 		explicitAppName: appName,
 		explicitAppId: envAppId,
+		configAppName: merged.configAppName,
 		firstDeploy: Boolean(target.localPinAction),
-		inferName: () => inferTargetName(context.runtime.cwd, context.runtime.signal)
+		inferName: () => inferTargetName(appDir, context.runtime.signal)
 	});
 	await maybeRenderDeploySetupBlock(context, {
 		includeDirectory: !target.localPinAction,
+		appDir,
 		projectName: target.project.name,
 		branchName: target.branch.name,
 		appName: selectedApp.displayName
@@ -156,9 +313,9 @@ async function runAppDeploy(context, appName, options) {
 		framework,
 		runtime,
 		firstDeploy: selectedApp.firstDeploy,
-		explicitFramework: Boolean(options?.framework),
-		explicitEntrypoint: Boolean(options?.entrypoint),
-		explicitHttpPort: Boolean(options?.httpPort)
+		explicitFramework: Boolean(merged.framework),
+		explicitEntrypoint: Boolean(merged.entrypoint),
+		explicitHttpPort: Boolean(merged.httpPort)
 	});
 	framework = customized.framework;
 	runtime = customized.runtime;
@@ -169,24 +326,33 @@ async function runAppDeploy(context, appName, options) {
 		prod: options?.prod === true
 	});
 	const buildType = framework.buildType;
-	assertSupportedEntrypoint(buildType, options?.entrypoint, "deploy");
-	const entrypoint = await resolveDeployEntrypoint(context.runtime.cwd, framework, options?.entrypoint, context.runtime.signal);
-	const buildSettingsResolution = await resolveOrCreatePreviewBuildSettings({
-		appPath: context.runtime.cwd,
+	assertSupportedEntrypoint(buildType, merged.entrypoint?.value, "deploy");
+	const entrypoint = await resolveDeployEntrypoint(appDir, framework, merged.entrypoint?.value, context.runtime.signal);
+	if (computeConfig.target?.build) assertConfigBackedBuildSettings(buildType);
+	const buildSettingsResolution = computeConfig.config && computeConfig.target?.build && isConfigBackedBuildType(buildType) ? await resolveConfiguredAppBuildSettings({
+		appPath: appDir,
+		buildType,
+		configured: computeConfig.target.build,
+		configPath: computeConfig.config.configPath,
+		signal: context.runtime.signal
+	}) : await resolveInferredAppBuildSettings({
+		appPath: appDir,
 		buildType,
 		signal: context.runtime.signal
 	});
+	const legacyWarnings = await handleLegacyBuildSettings(context, appDir, buildSettingsResolution.settings);
 	maybeRenderDeployBuildSettings(context, buildSettingsResolution);
 	const portMapping = parseDeployPortMapping(String(runtime.port));
 	const branchDatabaseSetup = await maybeSetupBranchDatabase(context, provider, projectId, toBranchDatabaseDeployBranch(target.branch), {
 		db: options?.db,
 		providedEnvVars: envVars,
-		firstProductionDeploy: productionDeployGate.firstProductionDeploy
+		firstProductionDeploy: productionDeployGate.firstProductionDeploy,
+		projectDir
 	});
-	const progressState = createPreviewDeployProgressState();
+	const 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,
@@ -199,7 +365,7 @@ async function runAppDeploy(context, appName, options) {
 		envVars,
 		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);
 	});
@@ -241,7 +407,7 @@ async function runAppDeploy(context, appName, options) {
 					name: framework.displayName,
 					source: framework.annotation
 				},
-				entrypoint: entrypoint ?? null,
+				entrypoint: entrypoint ?? buildSettingsResolution.settings.entrypoint ?? null,
 				httpPort: runtime.port,
 				region: selectedApp.region ?? null,
 				envVars: envVarNames(envVars)
@@ -249,14 +415,18 @@ async function runAppDeploy(context, appName, options) {
 			durationMs: deployDurationMs,
 			localPin: localPinResult
 		},
-		warnings: branchDatabaseSetup.warnings,
+		warnings: [...legacyWarnings, ...branchDatabaseSetup.warnings],
 		nextSteps: ["prisma-cli app list-deploys", `prisma-cli app show-deploy ${deployResult.deployment.id}`]
 	};
 }
-async function runAppListDeploys(context, appName, projectRef) {
+async function runAppListDeploys(context, appName, projectRef, configTarget) {
 	ensurePreviewAppMode(context);
-	const { provider, target, projectId } = await requireProviderAndProjectContext(context, projectRef, { commandName: "app list-deploys" });
-	const selectedApp = await resolveExistingAppSelection(context, projectId, await listApps(context, provider, projectId, target.branch.name), appName);
+	const compute = await resolveComputeManagementContext(context, configTarget, "list-deploys");
+	const { provider, target, projectId } = await requireProviderAndProjectContext(context, projectRef, {
+		commandName: "app list-deploys",
+		projectDir: compute.projectDir
+	});
+	const selectedApp = await resolveExistingAppSelection(context, projectId, await listApps(context, provider, projectId, target.branch.name), appName ?? compute.configAppName);
 	if (!selectedApp) return {
 		command: "app.list-deploys",
 		result: {
@@ -292,10 +462,14 @@ async function runAppListDeploys(context, appName, projectRef) {
 		nextSteps: deployments.length > 0 ? [`prisma-cli app show-deploy ${deployments[0]?.id}`] : ["prisma-cli app deploy"]
 	};
 }
-async function runAppShow(context, appName, projectRef) {
+async function runAppShow(context, appName, projectRef, configTarget) {
 	ensurePreviewAppMode(context);
-	const { provider, target, projectId } = await requireProviderAndProjectContext(context, projectRef, { commandName: "app show" });
-	const selectedApp = await resolveExistingAppSelection(context, projectId, await listApps(context, provider, projectId, target.branch.name), appName);
+	const compute = await resolveComputeManagementContext(context, configTarget, "show");
+	const { provider, target, projectId } = await requireProviderAndProjectContext(context, projectRef, {
+		commandName: "app show",
+		projectDir: compute.projectDir
+	});
+	const selectedApp = await resolveExistingAppSelection(context, projectId, await listApps(context, provider, projectId, target.branch.name), appName ?? compute.configAppName);
 	if (!selectedApp) return {
 		command: "app.show",
 		result: {
@@ -370,9 +544,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) => {
@@ -536,15 +715,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",
@@ -661,9 +844,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"]);
@@ -679,7 +867,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"]);
 	});
@@ -703,9 +891,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"]);
@@ -722,7 +915,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"]);
 	});
@@ -747,9 +940,14 @@ async function runAppRollback(context, appName, deploymentId, projectRef) {
 		nextSteps: ["prisma-cli app list-deploys", `prisma-cli app show-deploy ${targetDeployment.id}`]
 	};
 }
-async function runAppRemove(context, appName, projectRef) {
+async function runAppRemove(context, appName, projectRef, configTarget) {
 	ensurePreviewAppMode(context);
-	const { provider, target, projectId } = await requireProviderAndProjectContext(context, projectRef, { commandName: "app remove" });
+	const compute = await resolveComputeManagementContext(context, configTarget, "remove");
+	appName = appName ?? compute.configAppName;
+	const { provider, target, projectId } = await requireProviderAndProjectContext(context, projectRef, {
+		commandName: "app remove",
+		projectDir: compute.projectDir
+	});
 	const selectedApp = await requireReleaseAppSelection(context, projectId, await listApps(context, provider, projectId, target.branch.name), appName, "remove");
 	await confirmAppRemoval(context, selectedApp);
 	const removedApp = await provider.removeApp(selectedApp.id, { signal: context.runtime.signal }).catch((error) => {
@@ -773,6 +971,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",
@@ -788,10 +987,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, {
@@ -907,7 +1107,7 @@ async function confirmDomainRemoval(context, target, hostname) {
 	})) throw usageError("Custom domain removal canceled", "The command was canceled before the domain was detached.", "Rerun the command and confirm removal, or pass --yes.", [`prisma-cli app domain remove ${hostname} --app ${target.app.name} --yes`], "app");
 }
 function domainCommandError(command, error, hostname) {
-	if (error instanceof PreviewDomainApiError) {
+	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",
@@ -1088,7 +1288,7 @@ async function resolveDeployAppSelection(context, projectId, apps, options) {
 		};
 		return {
 			appName: options.explicitAppName,
-			region: PREVIEW_DEFAULT_REGION,
+			region: DEFAULT_REGION,
 			displayName: options.explicitAppName,
 			annotation: "set by --app",
 			firstDeploy: options.firstDeploy
@@ -1104,6 +1304,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: 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);
@@ -1116,7 +1335,7 @@ async function resolveDeployAppSelection(context, projectId, apps, options) {
 	};
 	return {
 		appName: inferredName.name,
-		region: PREVIEW_DEFAULT_REGION,
+		region: DEFAULT_REGION,
 		displayName: inferredName.name,
 		annotation: inferredName.source === "package-name" ? "created from package.json" : "created from directory name",
 		firstDeploy: options.firstDeploy
@@ -1148,7 +1367,7 @@ 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: DEFAULT_REGION,
 			displayName: targetName,
 			annotation: "created from package.json",
 			firstDeploy
@@ -1313,7 +1532,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) {
@@ -1355,21 +1574,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: {
+		branch: remoteBranch ?? {
 			id: null,
-			name: branch.name,
-			kind: toBranchKind(branch.name)
+			name: requested.name,
+			kind: toBranchKind(requested.name)
 		}
 	};
 }
@@ -1417,7 +1644,11 @@ async function resolveDeployProjectContext(context, client, provider, explicitPr
 	}
 	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 withRemoteDeployBranch(provider, {
@@ -1554,22 +1785,130 @@ async function resolveDeployBranch(context, explicitBranchName) {
 		annotation: "default"
 	};
 }
+async function resolveComputeTargetOrThrow(context, configTarget, commandName, options) {
+	let config;
+	if (options?.preloaded !== void 0) config = options.preloaded;
+	else {
+		const loaded = await loadComputeConfig$1(context.runtime.cwd, context.runtime.signal);
+		if (loaded.isErr()) throw computeConfigErrorToCliError(loaded.error, commandName);
+		config = loaded.value;
+	}
+	if (!config) {
+		if (configTarget) throw usageError(`App target "${configTarget}" requires a compute config file`, `No ${COMPUTE_CONFIG_FILENAME$1} exists in the current directory, so there are no named app targets.`, `Create ${COMPUTE_CONFIG_FILENAME$1} with an apps entry named "${configTarget}", or rerun without the target argument.`, [`prisma-cli app ${commandName}`], "app");
+		return {
+			config: null,
+			target: null
+		};
+	}
+	const requestedTarget = configTarget ?? inferComputeTargetFromCwd(config, context.runtime.cwd);
+	const selected = selectComputeDeployTarget(config, requestedTarget);
+	if (selected.isErr()) {
+		if (options?.targetOptional && selected.error instanceof ComputeConfigTargetRequiredError) return {
+			config,
+			target: null
+		};
+		throw computeConfigErrorToCliError(selected.error, commandName);
+	}
+	return {
+		config,
+		target: selected.value
+	};
+}
+/**
+* Compute-config context for app management commands: the project directory
+* (where `.prisma/local.json` lives) and the config-selected app name, which
+* ranks below `--app` but above the remembered app selection.
+*/
+async function resolveComputeManagementContext(context, configTarget, commandName) {
+	const compute = await resolveComputeTargetOrThrow(context, configTarget, commandName, { targetOptional: true });
+	return {
+		projectDir: compute.config?.configDir ?? context.runtime.cwd,
+		configAppName: compute.target?.name ?? compute.target?.key ?? void 0
+	};
+}
+async function resolveComputeAppDir(context, compute) {
+	if (!compute.config || !compute.target) return context.runtime.cwd;
+	const appDir = computeTargetAppDir(compute.config, compute.target);
+	if (!compute.target.root) return appDir;
+	context.runtime.signal.throwIfAborted();
+	try {
+		await access(appDir);
+		context.runtime.signal.throwIfAborted();
+	} catch (error) {
+		if (context.runtime.signal.aborted) throw error;
+		throw new CliError({
+			code: "COMPUTE_CONFIG_INVALID",
+			domain: "app",
+			summary: `App root "${compute.target.root}" does not exist`,
+			why: `${compute.config.relativeConfigPath} points the selected app at "${compute.target.root}", but that directory does not exist.`,
+			fix: `Fix the root path in ${compute.config.relativeConfigPath} or create the directory.`,
+			where: appDir,
+			meta: {
+				appRoot: compute.target.root,
+				appDir
+			},
+			exitCode: 2,
+			nextSteps: ["prisma-cli app deploy"]
+		});
+	}
+	return appDir;
+}
+/**
+* `prisma.app.json` is no longer read or written. A leftover file that
+* matches the effective settings only warns; one with custom values fails
+* with migration guidance so builds never silently change.
+*/
+async function handleLegacyBuildSettings(context, appDir, effective) {
+	const legacy = await detectLegacyBuildSettings({
+		appPath: appDir,
+		effective,
+		signal: context.runtime.signal
+	});
+	switch (legacy.kind) {
+		case "absent": return [];
+		case "matching": return [`${PRISMA_APP_CONFIG_FILENAME} is no longer used and matches the resolved build settings. Delete it.`];
+		case "invalid": return [`${PRISMA_APP_CONFIG_FILENAME} is no longer used and could not be parsed. Delete it.`];
+		case "custom": {
+			const buildBlock = [
+				"build: {",
+				`  command: ${legacy.buildCommand === null ? "null" : JSON.stringify(legacy.buildCommand)},`,
+				`  outputDirectory: ${JSON.stringify(legacy.outputDirectory)},`,
+				"}"
+			].join(" ");
+			throw new CliError({
+				code: "BUILD_SETTINGS_MIGRATION_REQUIRED",
+				domain: "app",
+				summary: `${PRISMA_APP_CONFIG_FILENAME} is no longer supported`,
+				why: `${PRISMA_APP_CONFIG_FILENAME} contains custom build settings that differ from the resolved defaults, and the file is no longer read.`,
+				fix: `Move the settings into prisma.compute.ts as \`${buildBlock}\` on this app, then delete ${PRISMA_APP_CONFIG_FILENAME}.`,
+				where: legacy.configPath,
+				meta: {
+					configPath: legacy.configPath,
+					buildCommand: legacy.buildCommand,
+					outputDirectory: legacy.outputDirectory
+				},
+				exitCode: 2,
+				nextSteps: ["prisma-cli app deploy"]
+			});
+		}
+	}
+}
 async function resolveDeployFramework(context, options) {
-	if (options.requestedFramework) return frameworkFromUserFacingValue(options.requestedFramework, "set by --framework");
+	if (options.requestedFramework) return frameworkFromUserFacingValue(options.requestedFramework, options.requestedFrameworkAnnotation ?? "set by --framework");
 	if (options.entrypoint) return {
 		key: "bun",
 		buildType: "bun",
 		displayName: "Bun",
-		annotation: "set by --entry"
+		annotation: options.entrypointAnnotation ?? "set by --entry"
 	};
-	const detected = await detectDeployFramework(context.runtime.cwd, context.runtime.signal);
+	const detected = await detectDeployFramework(options.appDir, context.runtime.signal);
 	if (detected) return detected;
-	throw frameworkNotDetectedError(context.runtime.cwd);
+	throw frameworkNotDetectedError(options.appDir);
 }
-function resolveDeployRuntime(requestedHttpPort, framework) {
+function resolveDeployRuntime(requestedHttpPort, requestedHttpPortAnnotation, framework) {
 	if (requestedHttpPort) return {
 		port: parseDeployHttpPort(requestedHttpPort),
-		annotation: "set by --http-port"
+		annotation: requestedHttpPortAnnotation ?? "set by --http-port"
 	};
 	return {
 		port: FRAMEWORK_DEFAULT_HTTP_PORT,
@@ -1584,8 +1923,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));
@@ -1599,34 +1938,22 @@ async function resolveDeployEntrypoint(cwd, framework, explicitEntrypoint, signa
 }
 async function detectDeployFramework(cwd, signal) {
 	const packageJson = await readBunPackageJson(cwd, signal);
-	const nextConfig = await detectNextConfig(cwd, signal);
-	if (nextConfig.exists || hasPackageDependency(packageJson, "next")) return {
-		key: "nextjs",
-		buildType: "nextjs",
-		displayName: "Next.js",
-		annotation: nextConfig.standalone ? "standalone output detected" : nextConfig.exists ? "detected from next.config" : "detected from package.json"
-	};
-	if (hasPackageDependency(packageJson, "hono")) return {
-		key: "hono",
-		buildType: "bun",
-		displayName: "Hono",
-		annotation: "detected from package.json"
-	};
-	if (hasAnyPackageDependency(packageJson, TANSTACK_START_PACKAGES)) return {
-		key: "tanstack-start",
-		buildType: "tanstack-start",
-		displayName: "TanStack Start",
-		annotation: "detected from package.json"
-	};
+	for (const framework of FRAMEWORKS) {
+		if (framework.detectConfigFiles.length === 0 && framework.detectPackages.length === 0) continue;
+		const configFile = await detectFrameworkConfigFile(cwd, framework, signal);
+		if (!configFile.exists && !hasAnyPackageDependency(packageJson, framework.detectPackages)) continue;
+		const annotation = framework.key === "nextjs" && configFile.standalone ? "standalone output detected" : configFile.exists ? `detected from ${path.basename(configFile.path)}` : "detected from package.json";
+		return {
+			key: framework.key,
+			buildType: framework.buildType,
+			displayName: framework.displayName,
+			annotation
+		};
+	}
 	return null;
 }
-async function detectNextConfig(cwd, signal) {
-	for (const candidate of [
-		"next.config.js",
-		"next.config.mjs",
-		"next.config.ts",
-		"next.config.mts"
-	]) {
+async function detectFrameworkConfigFile(cwd, framework, signal) {
+	for (const candidate of framework.detectConfigFiles) {
 		const filePath = path.join(cwd, candidate);
 		signal.throwIfAborted();
 		try {
@@ -1636,7 +1963,8 @@ async function detectNextConfig(cwd, signal) {
 			});
 			return {
 				exists: true,
-				standalone: /\boutput\s*:\s*["'`]standalone["'`]/.test(content)
+				standalone: /\boutput\s*:\s*["'`]standalone["'`]/.test(content),
+				path: filePath
 			};
 		} catch (error) {
 			if (signal.aborted) throw error;
@@ -1645,7 +1973,8 @@ async function detectNextConfig(cwd, signal) {
 	}
 	return {
 		exists: false,
-		standalone: false
+		standalone: false,
+		path: null
 	};
 }
 function hasPackageDependency(packageJson, dependencyName) {
@@ -1658,48 +1987,36 @@ 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
+	};
+}
+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",
@@ -1712,23 +2029,31 @@ function frameworkNotDetectedError(cwd, requestedFramework) {
 }
 async function maybeRenderDeploySetupBlock(context, details) {
 	if (context.flags.json || context.flags.quiet) return;
-	const directory = formatDeployDirectory(context.runtime.cwd);
+	const directory = formatAppDirectoryLabel(context.runtime.cwd, details.appDir);
 	const prefix = details.includeDirectory ? `Deploying ${directory} to` : "Deploying to";
 	context.output.stderr.write(`${prefix} ${details.projectName} / ${details.branchName} / ${details.appName}\n\n`);
 }
 function maybeRenderDeployBuildSettings(context, resolution) {
 	if (context.flags.json || context.flags.quiet) return;
 	const settings = resolution.settings;
-	const title = resolution.status === "created" ? `Created ${resolution.relativeConfigPath}` : `Using ${resolution.relativeConfigPath}`;
-	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`);
+	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;
@@ -1756,9 +2081,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({
@@ -1801,14 +2126,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 {
@@ -1822,6 +2139,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;
@@ -1830,26 +2152,36 @@ 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 (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;
@@ -1976,6 +2308,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;
@@ -2054,14 +2398,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({