@prisma/cli 3.0.0-alpha.0 → 3.0.0-alpha.2

package/dist/controllers/app.js

@@ -6,7 +6,7 @@ import { requireComputeAuth } from "../lib/auth/guard.js";
 import { parseEnvAssignments } from "../lib/app/env-vars.js";
 import { DEFAULT_LOCAL_DEV_PORT, resolveLocalBuildType, runLocalApp } from "../lib/app/local-dev.js";
 import { projectNotFoundError } from "../use-cases/project.js";
-import { executePreviewBuild } from "../lib/app/preview-build.js";
+import { PREVIEW_BUILD_TYPES, RESOLVED_PREVIEW_BUILD_TYPES, executePreviewBuild } from "../lib/app/preview-build.js";
 import { PREVIEW_DEFAULT_REGION, createPreviewDeployInteraction } from "../lib/app/preview-interaction.js";
 import { createPreviewDeployProgress, createPreviewPromoteProgress, createPreviewUpdateEnvProgress } from "../lib/app/preview-progress.js";
 import { createPreviewAppProvider } from "../lib/app/preview-provider.js";
@@ -20,12 +20,11 @@ function isRealMode(context) {
 async function runAppBuild(context, entrypoint, requestedBuildType) {
 	const buildType = normalizeBuildType(requestedBuildType);
 	assertSupportedEntrypoint(buildType, entrypoint, "build");
-	const resolvedBuildType = await requireLocalBuildType(context, buildType, "build");
 	try {
 		const { artifact, buildType: actualBuildType } = await executePreviewBuild({
 			appPath: context.runtime.cwd,
 			entrypoint,
-			buildType: resolvedBuildType
+			buildType
 		});
 		return {
 			command: "app.build",
@@ -35,14 +34,15 @@ async function runAppBuild(context, entrypoint, requestedBuildType) {
 				buildType: actualBuildType
 			},
 			warnings: [],
-			nextSteps: ["prisma app deploy"]
+			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");
 		throw buildFailedError("Local app build failed", error);
 	}
 }
 async function runAppRun(context, entrypoint, requestedBuildType, requestedPort) {
-	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 app run"], "app");
+	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);
@@ -95,7 +95,7 @@ async function runAppDeploy(context, appName, options) {
 		interaction: selectedApp.useInteractiveSelection ? createPreviewDeployInteraction(context) : void 0,
 		progress: createPreviewDeployProgress(context.output.stderr, !context.flags.json && !context.flags.quiet)
 	}).catch((error) => {
-		throw deployFailedError("App deploy failed", error, ["prisma app list-deploys"]);
+		throw deployFailedError("App deploy failed", error, ["prisma-cli app list-deploys"]);
 	});
 	await context.stateStore.setSelectedApp(projectId, {
 		id: deployResult.app.id,
@@ -113,7 +113,7 @@ async function runAppDeploy(context, appName, options) {
 			deployment: deployResult.deployment
 		},
 		warnings: [],
-		nextSteps: ["prisma app list-deploys", `prisma app show-deploy ${deployResult.deployment.id}`]
+		nextSteps: ["prisma-cli app list-deploys", `prisma-cli app show-deploy ${deployResult.deployment.id}`]
 	};
 }
 async function runAppUpdateEnv(context, appName, envAssignments) {
@@ -127,7 +127,7 @@ async function runAppUpdateEnv(context, appName, envAssignments) {
 	const selectedApp = await resolveExistingAppSelection(context, projectId, await listApps(context, provider, projectId), appName);
 	if (!selectedApp) throw noDeploymentsError("No deployments available to update environment variables", "The linked project does not have any deployed app yet.");
 	const deploymentsResult = await provider.listDeployments(selectedApp.id).catch((error) => {
-		throw deployFailedError("Failed to inspect app deployments", error, ["prisma app list-deploys"]);
+		throw deployFailedError("Failed to inspect app deployments", error, ["prisma-cli app list-deploys"]);
 	});
 	if (deploymentsResult.deployments.length === 0) throw noDeploymentsError("No deployments available to update environment variables", `The selected app "${deploymentsResult.app.name}" does not have any deployments yet.`);
 	const updateResult = await provider.updateAppEnv({
@@ -136,7 +136,7 @@ async function runAppUpdateEnv(context, appName, envAssignments) {
 		progress: createPreviewUpdateEnvProgress(context.output.stderr, !context.flags.json && !context.flags.quiet),
 		promoteProgress: createPreviewPromoteProgress(context.output.stderr, !context.flags.json && !context.flags.quiet)
 	}).catch((error) => {
-		throw deployFailedError("Failed to update app environment variables", error, ["prisma app list-env"]);
+		throw deployFailedError("Failed to update app environment variables", error, ["prisma-cli app list-env"]);
 	});
 	await context.stateStore.setSelectedApp(projectId, {
 		id: updateResult.app.id,
@@ -155,7 +155,7 @@ async function runAppUpdateEnv(context, appName, envAssignments) {
 			variables: updateResult.variables
 		},
 		warnings: [],
-		nextSteps: ["prisma app list-env", `prisma app show-deploy ${updateResult.deployment.id}`]
+		nextSteps: ["prisma-cli app list-env", `prisma-cli app show-deploy ${updateResult.deployment.id}`]
 	};
 }
 async function runAppListEnv(context, appName) {
@@ -172,10 +172,10 @@ async function runAppListEnv(context, appName) {
 			variables: []
 		},
 		warnings: [],
-		nextSteps: ["prisma app deploy"]
+		nextSteps: ["prisma-cli app deploy"]
 	};
 	const deploymentsResult = await provider.listDeployments(selectedApp.id).catch((error) => {
-		throw deployFailedError("Failed to inspect app deployments", error, ["prisma app list-deploys"]);
+		throw deployFailedError("Failed to inspect app deployments", error, ["prisma-cli app list-deploys"]);
 	});
 	const knownLiveDeploymentId = await context.stateStore.readKnownLiveDeployment(projectId, deploymentsResult.app.id);
 	const missingKnownLiveDeploymentId = knownLiveDeploymentId && !deploymentsResult.deployments.some((candidate) => candidate.id === knownLiveDeploymentId) ? knownLiveDeploymentId : null;
@@ -191,7 +191,7 @@ async function runAppListEnv(context, appName) {
 			appId: deploymentsResult.app.id,
 			deploymentId: missingKnownLiveDeploymentId
 		}).catch((error) => {
-			throw deployFailedError("Failed to inspect app environment variables", error, ["prisma app list-deploys"]);
+			throw deployFailedError("Failed to inspect app environment variables", error, ["prisma-cli app list-deploys"]);
 		});
 		return {
 			command: "app.list-env",
@@ -205,7 +205,7 @@ async function runAppListEnv(context, appName) {
 				variables: envResult.variables
 			},
 			warnings: [],
-			nextSteps: [`prisma app show-deploy ${envResult.deployment.id}`]
+			nextSteps: [`prisma-cli app show-deploy ${envResult.deployment.id}`]
 		};
 	}
 	if (!deployment) return {
@@ -220,13 +220,13 @@ async function runAppListEnv(context, appName) {
 			variables: []
 		},
 		warnings: [],
-		nextSteps: ["prisma app deploy"]
+		nextSteps: ["prisma-cli app deploy"]
 	};
 	const envResult = await provider.listAppEnvNames({
 		appId: deploymentsResult.app.id,
 		deploymentId: deployment.id
 	}).catch((error) => {
-		throw deployFailedError("Failed to inspect app environment variables", error, ["prisma app list-deploys"]);
+		throw deployFailedError("Failed to inspect app environment variables", error, ["prisma-cli app list-deploys"]);
 	});
 	return {
 		command: "app.list-env",
@@ -243,7 +243,7 @@ async function runAppListEnv(context, appName) {
 			variables: envResult.variables
 		},
 		warnings: [],
-		nextSteps: deployment.id ? [`prisma app show-deploy ${deployment.id}`] : ["prisma app deploy"]
+		nextSteps: deployment.id ? [`prisma-cli app show-deploy ${deployment.id}`] : ["prisma-cli app deploy"]
 	};
 }
 async function runAppListDeploys(context, appName) {
@@ -259,10 +259,10 @@ async function runAppListDeploys(context, appName) {
 			deployments: []
 		},
 		warnings: [],
-		nextSteps: ["prisma app deploy"]
+		nextSteps: ["prisma-cli app deploy"]
 	};
 	const deploymentsResult = await provider.listDeployments(selectedApp.id).catch((error) => {
-		throw deployFailedError("Failed to list app deployments", error, ["prisma app deploy"]);
+		throw deployFailedError("Failed to list app deployments", error, ["prisma-cli app deploy"]);
 	});
 	const currentLiveDeploymentId = await resolveCurrentLiveDeploymentId(context, projectId, deploymentsResult.app, deploymentsResult.deployments);
 	const deployments = applyLiveDeploymentHint(deploymentsResult.deployments, currentLiveDeploymentId).slice().sort((left, right) => right.createdAt.localeCompare(left.createdAt) || right.id.localeCompare(left.id));
@@ -281,7 +281,7 @@ async function runAppListDeploys(context, appName) {
 			deployments
 		},
 		warnings: [],
-		nextSteps: deployments.length > 0 ? [`prisma app show-deploy ${deployments[0]?.id}`] : ["prisma app deploy"]
+		nextSteps: deployments.length > 0 ? [`prisma-cli app show-deploy ${deployments[0]?.id}`] : ["prisma-cli app deploy"]
 	};
 }
 async function runAppShow(context, appName) {
@@ -299,10 +299,10 @@ async function runAppShow(context, appName) {
 			recentDeployments: []
 		},
 		warnings: [],
-		nextSteps: ["prisma app deploy"]
+		nextSteps: ["prisma-cli app deploy"]
 	};
 	const deploymentsResult = await provider.listDeployments(selectedApp.id).catch((error) => {
-		throw deployFailedError("Failed to inspect app", error, ["prisma app list-deploys"]);
+		throw deployFailedError("Failed to inspect app", error, ["prisma-cli app list-deploys"]);
 	});
 	const currentLiveDeploymentId = await resolveCurrentLiveDeploymentId(context, projectId, deploymentsResult.app, deploymentsResult.deployments);
 	const deployments = applyLiveDeploymentHint(deploymentsResult.deployments, currentLiveDeploymentId).slice().sort((left, right) => right.createdAt.localeCompare(left.createdAt) || right.id.localeCompare(left.id));
@@ -330,16 +330,16 @@ async function runAppShow(context, appName) {
 async function runAppShowDeploy(context, deploymentId) {
 	ensurePreviewAppMode(context);
 	const deployment = await (await requirePreviewAppProvider(context)).showDeployment(deploymentId).catch((error) => {
-		throw deployFailedError("Failed to show deployment", error, ["prisma app list-deploys"]);
+		throw deployFailedError("Failed to show deployment", error, ["prisma-cli app list-deploys"]);
 	});
 	if (!deployment) throw new CliError({
 		code: "DEPLOYMENT_NOT_FOUND",
 		domain: "app",
 		summary: `Deployment "${deploymentId}" not found`,
 		why: "The requested deployment does not exist or is no longer available.",
-		fix: "Run prisma app list-deploys to choose an available deployment id.",
+		fix: "Run prisma-cli app list-deploys to choose an available deployment id.",
 		exitCode: 1,
-		nextSteps: ["prisma app list-deploys"]
+		nextSteps: ["prisma-cli app list-deploys"]
 	});
 	const linkedProjectId = deployment?.app ? await readLinkedProjectId(context.runtime.cwd) : null;
 	const knownLiveDeploymentId = deployment?.app && linkedProjectId ? await context.stateStore.readKnownLiveDeployment(linkedProjectId, deployment.app.id) : null;
@@ -367,7 +367,7 @@ async function runAppOpen(context, appName) {
 	const selectedApp = await resolveExistingAppSelection(context, projectId, await listApps(context, provider, projectId), appName);
 	if (!selectedApp) throw noDeploymentsError("No deployments available to open", "The linked project does not have any deployed app yet.");
 	const deploymentsResult = await provider.listDeployments(selectedApp.id).catch((error) => {
-		throw deployFailedError("Failed to resolve app URL", error, ["prisma app show"]);
+		throw deployFailedError("Failed to resolve app URL", error, ["prisma-cli app show"]);
 	});
 	const currentLiveDeploymentId = await resolveCurrentLiveDeploymentId(context, projectId, deploymentsResult.app, deploymentsResult.deployments);
 	const deployments = applyLiveDeploymentHint(deploymentsResult.deployments, currentLiveDeploymentId).slice().sort((left, right) => right.createdAt.localeCompare(left.createdAt) || right.id.localeCompare(left.id));
@@ -377,7 +377,7 @@ async function runAppOpen(context, appName) {
 		name: deploymentsResult.app.name
 	});
 	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 app show to inspect the current deployment state and try again after the app reports a live URL.", ["prisma app show"], "app");
+	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);
 	return {
@@ -392,7 +392,7 @@ async function runAppOpen(context, appName) {
 			opened: shouldOpen
 		},
 		warnings: [],
-		nextSteps: ["prisma app show", `prisma app show-deploy ${liveDeployment.id}`]
+		nextSteps: ["prisma-cli app show", `prisma-cli app show-deploy ${liveDeployment.id}`]
 	};
 }
 async function runAppLogs(context, _appName, _deploymentId) {
@@ -405,7 +405,7 @@ async function runAppPromote(context, deploymentId, appName) {
 	const provider = await requirePreviewAppProvider(context);
 	const selectedApp = await requireReleaseAppSelection(context, projectId, await listApps(context, provider, projectId), appName, "promote");
 	const deploymentsResult = await provider.listDeployments(selectedApp.id).catch((error) => {
-		throw deployFailedError("Failed to list app deployments", error, ["prisma app list-deploys"]);
+		throw deployFailedError("Failed to list app deployments", error, ["prisma-cli app list-deploys"]);
 	});
 	const currentLiveDeploymentId = await resolveCurrentLiveDeploymentId(context, projectId, deploymentsResult.app, deploymentsResult.deployments);
 	const targetDeployment = requireDeploymentForApp(deploymentsResult.deployments, deploymentId, selectedApp.name);
@@ -419,7 +419,7 @@ async function runAppPromote(context, deploymentId, appName) {
 		deploymentId: targetDeployment.id,
 		progress: createPreviewPromoteProgress(context.output.stderr, !context.flags.json && !context.flags.quiet)
 	}).catch((error) => {
-		throw deployFailedError("Failed to promote deployment", error, ["prisma app list-deploys"]);
+		throw deployFailedError("Failed to promote deployment", error, ["prisma-cli app list-deploys"]);
 	});
 	await context.stateStore.setKnownLiveDeployment(projectId, deploymentsResult.app.id, targetDeployment.id);
 	return {
@@ -437,7 +437,7 @@ async function runAppPromote(context, deploymentId, appName) {
 			}
 		},
 		warnings: targetAlreadyLive ? ["The selected deployment is already live for this app."] : [],
-		nextSteps: ["prisma app list-deploys", `prisma app show-deploy ${targetDeployment.id}`]
+		nextSteps: ["prisma-cli app list-deploys", `prisma-cli app show-deploy ${targetDeployment.id}`]
 	};
 }
 async function runAppRollback(context, appName, deploymentId) {
@@ -446,7 +446,7 @@ async function runAppRollback(context, appName, deploymentId) {
 	const provider = await requirePreviewAppProvider(context);
 	const selectedApp = await requireReleaseAppSelection(context, projectId, await listApps(context, provider, projectId), appName, "rollback");
 	const deploymentsResult = await provider.listDeployments(selectedApp.id).catch((error) => {
-		throw deployFailedError("Failed to list app deployments", error, ["prisma app list-deploys"]);
+		throw deployFailedError("Failed to list app deployments", error, ["prisma-cli app list-deploys"]);
 	});
 	const currentLiveDeploymentId = await resolveCurrentLiveDeploymentId(context, projectId, deploymentsResult.app, deploymentsResult.deployments);
 	const currentLiveDeployment = currentLiveDeploymentId ? deploymentsResult.deployments.find((deployment) => deployment.id === currentLiveDeploymentId) ?? null : null;
@@ -461,7 +461,7 @@ async function runAppRollback(context, appName, deploymentId) {
 		deploymentId: targetDeployment.id,
 		progress: createPreviewPromoteProgress(context.output.stderr, !context.flags.json && !context.flags.quiet)
 	}).catch((error) => {
-		throw deployFailedError("Failed to roll back deployment", error, ["prisma app list-deploys"]);
+		throw deployFailedError("Failed to roll back deployment", error, ["prisma-cli app list-deploys"]);
 	});
 	await context.stateStore.setKnownLiveDeployment(projectId, deploymentsResult.app.id, targetDeployment.id);
 	return {
@@ -480,7 +480,7 @@ async function runAppRollback(context, appName, deploymentId) {
 			previousLiveDeploymentId: currentLiveDeployment?.id ?? null
 		},
 		warnings: targetAlreadyLive ? ["The selected deployment is already live for this app."] : [],
-		nextSteps: ["prisma app list-deploys", `prisma app show-deploy ${targetDeployment.id}`]
+		nextSteps: ["prisma-cli app list-deploys", `prisma-cli app show-deploy ${targetDeployment.id}`]
 	};
 }
 async function runAppRemove(context, appName) {
@@ -490,7 +490,7 @@ async function runAppRemove(context, appName) {
 	const selectedApp = await requireReleaseAppSelection(context, projectId, await listApps(context, provider, projectId), appName, "remove");
 	await confirmAppRemoval(context, selectedApp);
 	const removedApp = await provider.removeApp(selectedApp.id).catch((error) => {
-		throw removeFailedError("Failed to remove app", error, ["prisma app show", "prisma app list-deploys"]);
+		throw removeFailedError("Failed to remove app", error, ["prisma-cli app show", "prisma-cli app list-deploys"]);
 	});
 	const warnings = await cleanupRemovedAppState(context, projectId, removedApp.id);
 	return {
@@ -504,7 +504,7 @@ async function runAppRemove(context, appName) {
 			removed: true
 		},
 		warnings,
-		nextSteps: ["prisma app deploy", "prisma app list-deploys"]
+		nextSteps: ["prisma-cli app deploy", "prisma-cli app list-deploys"]
 	};
 }
 async function resolveDeploySelection(context, projectId, apps, explicitAppName) {
@@ -527,25 +527,25 @@ async function resolveDeploySelection(context, projectId, apps, explicitAppName)
 			appId: matched.id,
 			useInteractiveSelection: false
 		};
-		if (!canPrompt(context)) throw usageError("Saved app selection is no longer available", "The locally selected app could not be found in the linked project.", "Pass --app <name>, or rerun prisma app deploy in a TTY to choose or create an app again.", ["prisma app deploy"], "app");
+		if (!canPrompt(context)) throw usageError("Saved app selection is no longer available", "The locally selected app could not be found in the linked project.", "Pass --app <name>, or rerun prisma-cli app deploy in a TTY to choose or create an app again.", ["prisma-cli app deploy"], "app");
 	}
-	if (!canPrompt(context)) throw usageError("App deploy requires an app selection in non-interactive mode", "This command cannot choose or create an app in the current mode.", "Pass --app <name>, or rerun prisma app deploy in a TTY to choose or create an app.", ["prisma app deploy --app hello-world"], "app");
+	if (!canPrompt(context)) throw usageError("App deploy requires an app selection in non-interactive mode", "This command cannot choose or create an app in the current mode.", "Pass --app <name>, or rerun prisma-cli app deploy in a TTY to choose or create an app.", ["prisma-cli app deploy --app hello-world"], "app");
 	return { useInteractiveSelection: true };
 }
 async function resolveExistingAppSelection(context, projectId, apps, explicitAppName) {
 	if (explicitAppName) {
 		const matched = findAppByName(apps, explicitAppName);
-		if (!matched) throw usageError("Selected app does not exist in the linked project", `The app "${explicitAppName}" could not be found in linked project "${projectId}".`, "Pass the name of an existing app, or rerun prisma app list-deploys in a TTY to choose one.", ["prisma app list-deploys"], "app");
+		if (!matched) throw usageError("Selected app does not exist in the linked project", `The app "${explicitAppName}" could not be found in linked project "${projectId}".`, "Pass the name of an existing app, or rerun prisma-cli app list-deploys in a TTY to choose one.", ["prisma-cli app list-deploys"], "app");
 		return matched;
 	}
 	const savedSelection = await context.stateStore.readSelectedApp(projectId);
 	if (savedSelection) {
 		const matched = apps.find((app) => app.id === savedSelection.id) ?? findAppByName(apps, savedSelection.name);
 		if (matched) return matched;
-		if (!canPrompt(context)) throw usageError("Saved app selection is no longer available", "The locally selected app could not be found in the linked project.", "Pass --app <name>, or rerun prisma app list-deploys in a TTY to choose an available app.", ["prisma app list-deploys"], "app");
+		if (!canPrompt(context)) throw usageError("Saved app selection is no longer available", "The locally selected app could not be found in the linked project.", "Pass --app <name>, or rerun prisma-cli app list-deploys in a TTY to choose an available app.", ["prisma-cli app list-deploys"], "app");
 	}
 	if (apps.length === 0) return null;
-	if (!canPrompt(context)) throw usageError("App selection required in non-interactive mode", "This command cannot choose an app in the current mode.", "Pass --app <name>, or rerun prisma app list-deploys in a TTY to choose an app.", ["prisma app list-deploys"], "app");
+	if (!canPrompt(context)) throw usageError("App selection required in non-interactive mode", "This command cannot choose an app in the current mode.", "Pass --app <name>, or rerun prisma-cli app list-deploys in a TTY to choose an app.", ["prisma-cli app list-deploys"], "app");
 	const selectedId = await createSelectPromptPort(context).select({
 		message: "Select an app",
 		choices: sortApps(apps).map((app) => ({
@@ -558,7 +558,7 @@ async function resolveExistingAppSelection(context, projectId, apps, explicitApp
 async function requireReleaseAppSelection(context, projectId, apps, explicitAppName, commandName) {
 	const selectedApp = await resolveExistingAppSelection(context, projectId, apps, explicitAppName);
 	if (selectedApp) return selectedApp;
-	throw usageError(`App ${commandName} requires an existing app`, "The linked project does not have an app that can be selected for this command.", `Deploy an app first, or rerun prisma app ${commandName} with --app <name> after an app exists.`, ["prisma app deploy", "prisma app list-deploys"], "app");
+	throw usageError(`App ${commandName} requires an existing app`, "The linked project does not have an app that can be selected for this command.", `Deploy an app first, or rerun prisma-cli app ${commandName} with --app <name> after an app exists.`, ["prisma-cli app deploy", "prisma-cli app list-deploys"], "app");
 }
 async function confirmAppRemoval(context, app) {
 	if (context.flags.yes) return;
@@ -567,9 +567,9 @@ async function confirmAppRemoval(context, app) {
 		domain: "app",
 		summary: "App remove requires confirmation in the current mode",
 		why: "This command is destructive and cannot prompt for confirmation in the current mode.",
-		fix: `Pass --yes to confirm removal of "${app.name}", or rerun prisma app remove in an interactive TTY.`,
+		fix: `Pass --yes to confirm removal of "${app.name}", or rerun prisma-cli app remove in an interactive TTY.`,
 		exitCode: 1,
-		nextSteps: [`prisma app remove --app ${app.name} --yes`]
+		nextSteps: [`prisma-cli app remove --app ${app.name} --yes`]
 	});
 	await textPrompt({
 		input: context.runtime.stdin,
@@ -601,9 +601,9 @@ function requireDeploymentForApp(deployments, deploymentId, appName) {
 		domain: "app",
 		summary: `Deployment "${deploymentId}" not found for app "${appName}"`,
 		why: "The requested deployment does not belong to the resolved app or is no longer available.",
-		fix: "Run prisma app list-deploys to choose an available deployment id for this app.",
+		fix: "Run prisma-cli app list-deploys to choose an available deployment id for this app.",
 		exitCode: 1,
-		nextSteps: ["prisma app list-deploys"]
+		nextSteps: ["prisma-cli app list-deploys"]
 	});
 }
 async function resolveCurrentLiveDeploymentId(context, projectId, app, deployments) {
@@ -616,10 +616,10 @@ async function resolveCurrentLiveDeploymentId(context, projectId, app, deploymen
 }
 function buildAppShowNextSteps(liveUrl, liveDeployment, deployments) {
 	const nextSteps = [];
-	if (liveUrl) nextSteps.push("prisma app open");
-	if (liveDeployment) nextSteps.push(`prisma app show-deploy ${liveDeployment.id}`);
-	else if (deployments[0]) nextSteps.push(`prisma app show-deploy ${deployments[0].id}`);
-	else nextSteps.push("prisma app deploy");
+	if (liveUrl) nextSteps.push("prisma-cli app open");
+	if (liveDeployment) nextSteps.push(`prisma-cli app show-deploy ${liveDeployment.id}`);
+	else if (deployments[0]) nextSteps.push(`prisma-cli app show-deploy ${deployments[0].id}`);
+	else nextSteps.push("prisma-cli app deploy");
 	return nextSteps;
 }
 function applyLiveDeploymentHint(deployments, currentLiveDeploymentId) {
@@ -640,24 +640,24 @@ function resolveRollbackTarget(deployments, currentLiveDeploymentId) {
 		domain: "app",
 		summary: "No previous deployment available for rollback",
 		why: "The selected app does not have an earlier deployment to switch back to.",
-		fix: "Deploy a second version first, or rerun prisma app rollback --to <deployment-id> for a specific earlier deployment.",
+		fix: "Deploy a second version first, or rerun prisma-cli app rollback --to <deployment-id> for a specific earlier deployment.",
 		exitCode: 1,
-		nextSteps: ["prisma app deploy", "prisma app list-deploys"]
+		nextSteps: ["prisma-cli app deploy", "prisma-cli app list-deploys"]
 	});
 }
 async function listApps(context, provider, projectId) {
 	return provider.listApps(projectId).then(sortApps).catch((error) => {
-		if (isMissingProjectError(error)) throw projectNotFoundError(`The linked project "${projectId}" does not exist in the authenticated workspace or is no longer accessible.`, "Run prisma project show to inspect the current link, then relink the repo or rerun prisma app deploy to bootstrap a new project.", [
-			"prisma project show",
-			"prisma project link",
-			"prisma app deploy"
+		if (isMissingProjectError(error)) throw projectNotFoundError(`The linked project "${projectId}" does not exist in the authenticated workspace or is no longer accessible.`, "Run prisma-cli project show to inspect the current link, then relink the repo or rerun prisma-cli app deploy to bootstrap a new project.", [
+			"prisma-cli project show",
+			"prisma-cli project link",
+			"prisma-cli app deploy"
 		]);
-		throw deployFailedError("Failed to list apps", error, ["prisma project show"]);
+		throw deployFailedError("Failed to list apps", error, ["prisma-cli project show"]);
 	});
 }
 async function requirePreviewAppProvider(context) {
 	const client = await requireComputeAuth(context.runtime.env);
-	if (!client) throw authRequiredError(["prisma auth login"]);
+	if (!client) throw authRequiredError(["prisma-cli auth login"]);
 	return createPreviewAppProvider(client);
 }
 async function requireLinkedProjectId(context) {
@@ -667,9 +667,9 @@ async function requireLinkedProjectId(context) {
 		domain: "project",
 		summary: "Project link required",
 		why: "This command needs a linked project for the current repo.",
-		fix: "Run prisma project link before deploying or inspecting app deployments.",
+		fix: "Run prisma-cli project link before deploying or inspecting app deployments.",
 		exitCode: 1,
-		nextSteps: ["prisma project link"]
+		nextSteps: ["prisma-cli project link"]
 	});
 	return projectId;
 }
@@ -679,13 +679,13 @@ async function resolveProjectIdForDeploy(context, provider) {
 	await assertProjectLinkWritableForDeploy(context);
 	const projectName = path.basename(context.runtime.cwd);
 	const project = await provider.createProject({ name: projectName }).catch((error) => {
-		throw deployFailedError("Failed to create project for first deploy", error, ["prisma app deploy"]);
+		throw deployFailedError("Failed to create project for first deploy", error, ["prisma-cli app deploy"]);
 	});
 	try {
 		await writeLinkedProjectId(context.runtime.cwd, project.id);
 	} catch (error) {
 		const cause = error instanceof Error ? error.message : String(error);
-		throw deployFailedError("Failed to link created project", `Project "${project.name}" (${project.id}) was created remotely but could not be linked locally: ${cause}`, ["prisma project show", "prisma app deploy"]);
+		throw deployFailedError("Failed to link created project", `Project "${project.name}" (${project.id}) was created remotely but could not be linked locally: ${cause}`, ["prisma-cli project show", "prisma-cli app deploy"]);
 	}
 	return project.id;
 }
@@ -693,41 +693,49 @@ async function assertProjectLinkWritableForDeploy(context) {
 	try {
 		await assertLinkedProjectIdWritable(context.runtime.cwd);
 	} catch (error) {
-		if (error instanceof UnsafeConfigWriteError) throw usageError("Project bootstrap requires a writable Prisma config", error.message, "Update prisma.config.ts to use a recognizable project field, or remove it and rerun prisma app deploy.", ["prisma app deploy --app hello-world"], "app");
+		if (error instanceof UnsafeConfigWriteError) throw usageError("Project bootstrap requires a writable Prisma config", error.message, "Update prisma.config.ts to use a recognizable project field, or remove it and rerun prisma-cli app deploy.", ["prisma-cli app deploy --app hello-world"], "app");
 		throw error;
 	}
 }
 function normalizeBuildType(requestedBuildType) {
 	if (!requestedBuildType) return "auto";
-	if (requestedBuildType === "auto" || requestedBuildType === "bun" || requestedBuildType === "nextjs") return requestedBuildType;
-	throw usageError(`Unsupported build type "${requestedBuildType}"`, "Only auto, bun, and nextjs are supported in the current preview.", "Pass --build-type auto, --build-type bun, or --build-type nextjs.", ["prisma app build --build-type nextjs", "prisma app build --build-type bun --entry server.ts"], "app");
+	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");
+}
+function isPreviewBuildType(value) {
+	return PREVIEW_BUILD_TYPES.includes(value);
+}
+function getBuildTypeExamples(commandName) {
+	return RESOLVED_PREVIEW_BUILD_TYPES.map((buildType) => {
+		return `prisma-cli app ${commandName} --build-type ${buildType}${buildType === "bun" ? " --entry server.ts" : ""}`;
+	});
 }
 function assertSupportedEntrypoint(buildType, entrypoint, commandName) {
-	if (buildType === "nextjs" && entrypoint) throw usageError(`App ${commandName} does not accept --entry with --build-type nextjs`, "Next.js apps do not use an entrypoint flag in the current preview.", `Remove --entry, or rerun prisma app ${commandName} with --build-type bun when you want to target a Bun entrypoint directly.`, [`prisma app ${commandName} --build-type nextjs`, `prisma app ${commandName} --build-type bun --entry server.ts`], "app");
+	if (buildType !== "auto" && buildType !== "bun" && entrypoint) 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 auto-detects 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 app ${commandName} --build-type nextjs`, `prisma app ${commandName} --build-type bun --entry server.ts`], "app");
+	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");
 }
 function parseLocalPort(requestedPort) {
 	if (!requestedPort) return DEFAULT_LOCAL_DEV_PORT;
 	const port = Number.parseInt(requestedPort, 10);
-	if (!Number.isInteger(port) || port <= 0 || port > 65535) throw usageError(`Invalid port "${requestedPort}"`, "Port must be an integer between 1 and 65535.", "Pass --port <number> with a valid local port value.", ["prisma app run --port 3000"], "app");
+	if (!Number.isInteger(port) || port <= 0 || port > 65535) throw usageError(`Invalid port "${requestedPort}"`, "Port must be an integer between 1 and 65535.", "Pass --port <number> with a valid local port value.", ["prisma-cli app run --port 3000"], "app");
 	return port;
 }
 function parseDeployPortMapping(requestedPort) {
 	if (!requestedPort) return;
 	const port = Number.parseInt(requestedPort, 10);
-	if (!Number.isInteger(port) || port <= 0 || port > 65535) throw usageError(`Invalid HTTP port "${requestedPort}"`, "HTTP port must be an integer between 1 and 65535.", "Pass --http-port <number> with a valid port value.", ["prisma app deploy --http-port 3000"], "app");
+	if (!Number.isInteger(port) || port <= 0 || port > 65535) throw usageError(`Invalid HTTP port "${requestedPort}"`, "HTTP port must be an integer between 1 and 65535.", "Pass --http-port <number> with a valid port value.", ["prisma-cli app deploy --http-port 3000"], "app");
 	return { http: port };
 }
 function ensurePreviewAppMode(context) {
 	if (isRealMode(context)) return;
-	throw featureUnavailableError("App commands are not available in fixture mode", "Preview app commands require live app deployment integration.", "Rerun without fixture mode enabled to use preview app deployment workflows.", ["prisma auth login", "prisma project link"], "app");
+	throw featureUnavailableError("App commands are not available in fixture mode", "Preview app commands require live app deployment integration.", "Rerun without fixture mode enabled to use preview app deployment workflows.", ["prisma-cli auth login", "prisma-cli project link"], "app");
 }
 function blockedPreviewAppCommandError(summary, why) {
-	return featureUnavailableError(summary, why, "Use prisma app show, prisma app open, prisma app deploy, or prisma app list-deploys in the current preview.", ["prisma app show", "prisma app list-deploys"], "app");
+	return featureUnavailableError(summary, why, "Use prisma-cli app show, prisma-cli app open, prisma-cli app deploy, or prisma-cli app list-deploys in the current preview.", ["prisma-cli app show", "prisma-cli app list-deploys"], "app");
 }
 function deployFailedError(summary, error, nextSteps) {
 	return new CliError({
@@ -747,9 +755,9 @@ function noDeploymentsError(summary, why) {
 		domain: "app",
 		summary,
 		why,
-		fix: "Run prisma app deploy first, or use prisma app show to inspect the current app state.",
+		fix: "Run prisma-cli app deploy first, or use prisma-cli app show to inspect the current app state.",
 		exitCode: 1,
-		nextSteps: ["prisma app deploy", "prisma app show"]
+		nextSteps: ["prisma-cli app deploy", "prisma-cli app show"]
 	});
 }
 function buildFailedError(summary, error) {
@@ -758,10 +766,10 @@ function buildFailedError(summary, error) {
 		domain: "app",
 		summary,
 		why: error instanceof Error ? error.message : String(error),
-		fix: "Inspect the framework output, fix the build issue, and rerun prisma app build.",
+		fix: "Inspect the framework output, fix the build issue, and rerun prisma-cli app build.",
 		debug: formatDebugDetails(error),
 		exitCode: 1,
-		nextSteps: ["prisma app build", "prisma app deploy"]
+		nextSteps: ["prisma-cli app build", "prisma-cli app deploy"]
 	});
 }
 function runFailedError(summary, error, exitCode = 1) {
@@ -770,14 +778,27 @@ function runFailedError(summary, error, exitCode = 1) {
 		domain: "app",
 		summary,
 		why: error instanceof Error ? error.message : String(error),
-		fix: "Inspect the framework output above, fix the issue, and rerun prisma app run.",
+		fix: "Inspect the framework output above, fix the issue, and rerun prisma-cli app run.",
 		exitCode,
-		nextSteps: ["prisma app run"]
+		nextSteps: ["prisma-cli app run"]
 	});
 }
 function formatFrameworkName(framework) {
 	return framework === "nextjs" ? "Next.js" : "Bun";
 }
+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";
+	}
+}
 function removeFailedError(summary, error, nextSteps) {
 	return new CliError({
 		code: "REMOVE_FAILED",

package/dist/controllers/auth.js

@@ -14,7 +14,7 @@ async function runAuthLogin(context, options) {
 		await performLogin(context.runtime.env);
 		result = await readAuthState(context.runtime.env);
 	} else result = await loginWithSelectionFlow(context, createAuthUseCases(createCliUseCaseGateways(context)), options);
-	return createAuthSuccess("auth.login", result, ["prisma auth whoami", "prisma project list"]);
+	return createAuthSuccess("auth.login", result, ["prisma-cli auth whoami", "prisma-cli project list"]);
 }
 async function runAuthLogout(context) {
 	let result;
@@ -22,13 +22,13 @@ async function runAuthLogout(context) {
 		await performLogout(context.runtime.env);
 		result = await readAuthState(context.runtime.env);
 	} else result = await createAuthUseCases(createCliUseCaseGateways(context)).logout();
-	return createAuthSuccess("auth.logout", result, ["prisma auth login"]);
+	return createAuthSuccess("auth.logout", result, ["prisma-cli auth login"]);
 }
 async function runAuthWhoAmI(context) {
 	let result;
 	if (isRealMode(context)) result = await readAuthState(context.runtime.env);
 	else result = await createAuthUseCases(createCliUseCaseGateways(context)).whoami();
-	return createAuthSuccess("auth.whoami", result, result.authenticated ? [] : ["prisma auth login"]);
+	return createAuthSuccess("auth.whoami", result, result.authenticated ? [] : ["prisma-cli auth login"]);
 }
 async function requireAuthenticatedAuthState(context) {
 	if (isRealMode(context)) {
@@ -59,7 +59,7 @@ async function resolveLoginSelection(useCases, prompt, options) {
 	};
 }
 async function selectProvider(useCases, prompt) {
-	if (!prompt) throw nonInteractiveLoginError("Re-run prisma auth login in a TTY, or provide --provider and --user, and --workspace when required.");
+	if (!prompt) throw nonInteractiveLoginError("Re-run prisma-cli auth login in a TTY, or provide --provider and --user, and --workspace when required.");
 	const providers = await useCases.listProviders();
 	return prompt.select({
 		message: "Select a provider",
@@ -71,7 +71,7 @@ async function selectProvider(useCases, prompt) {
 }
 async function selectUser(useCases, prompt, provider) {
 	const users = await useCases.listUsersForProvider(provider);
-	if (!prompt) throw nonInteractiveLoginError("Re-run prisma auth login in a TTY, or provide --provider and --user, and --workspace when required.");
+	if (!prompt) throw nonInteractiveLoginError("Re-run prisma-cli auth login in a TTY, or provide --provider and --user, and --workspace when required.");
 	return prompt.select({
 		message: "Select a user",
 		choices: users.map((user) => ({
@@ -83,7 +83,7 @@ async function selectUser(useCases, prompt, provider) {
 async function selectWorkspace(useCases, prompt, userId) {
 	const workspaces = await useCases.listWorkspacesForUser(userId);
 	if (workspaces.length === 1) return workspaces[0];
-	if (!prompt) throw usageError("Login requires explicit selectors in non-interactive mode", "The selected mock user belongs to more than one workspace and the shell cannot prompt in the current mode.", "Re-run prisma auth login in a TTY, or provide --workspace.", ["prisma auth login"], "auth");
+	if (!prompt) throw usageError("Login requires explicit selectors in non-interactive mode", "The selected mock user belongs to more than one workspace and the shell cannot prompt in the current mode.", "Re-run prisma-cli auth login in a TTY, or provide --workspace.", ["prisma-cli auth login"], "auth");
 	return prompt.select({
 		message: "Select a workspace",
 		choices: workspaces.map((workspace) => ({
@@ -93,7 +93,7 @@ async function selectWorkspace(useCases, prompt, userId) {
 	});
 }
 function nonInteractiveLoginError(fix) {
-	return usageError("Login requires explicit selectors in non-interactive mode", "The fixture mode cannot prompt in the current mode.", fix, ["prisma auth login"], "auth");
+	return usageError("Login requires explicit selectors in non-interactive mode", "The fixture mode cannot prompt in the current mode.", fix, ["prisma-cli auth login"], "auth");
 }
 function createAuthSuccess(command, result, nextSteps) {
 	return {