@prisma/cli 3.0.0-alpha.3 → 3.0.0-alpha.5

package/dist/controllers/app.js

@@ -1,21 +1,22 @@
-import { UnsafeConfigWriteError, assertLinkedProjectIdWritable, readLinkedProjectId, writeLinkedProjectId } from "../adapters/config.js";
 import { SERVICE_TOKEN_ENV_VAR, getApiBaseUrl } from "../lib/auth/client.js";
 import { FileTokenStorage } from "../adapters/token-storage.js";
-import { CliError, authRequiredError, featureUnavailableError, usageError } from "../shell/errors.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 { textPrompt } from "../shell/prompt.js";
 import { requireComputeAuth } from "../lib/auth/guard.js";
+import { readAuthState } from "../lib/auth/auth-ops.js";
 import { parseEnvAssignments } from "../lib/app/env-vars.js";
 import { DEFAULT_LOCAL_DEV_PORT, resolveLocalBuildType, runLocalApp } from "../lib/app/local-dev.js";
-import { projectNotFoundError } from "../use-cases/project.js";
+import { resolveProjectTarget } from "../lib/project/resolution.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";
 import { createSelectPromptPort } from "./select-prompt-port.js";
-import path from "node:path";
+import { requireAuthenticatedAuthState } from "./auth.js";
+import { listRealWorkspaceProjects } from "./project.js";
 import open from "open";
 //#region src/controllers/app.ts
 function isRealMode(context) {
@@ -83,8 +84,7 @@ async function runAppDeploy(context, appName, options) {
 	assertSupportedEntrypoint(buildType, options?.entrypoint, "deploy");
 	const portMapping = parseDeployPortMapping(options?.httpPort);
 	const envVars = toOptionalEnvVars(parseEnvAssignments(options?.envAssignments, { commandName: "deploy" }));
-	const provider = await requirePreviewAppProvider(context);
-	const projectId = await resolveProjectIdForDeploy(context, provider);
+	const { provider, target, projectId } = await requireProviderAndProjectContext(context, options?.projectRef, { allowCreate: true });
 	const selectedApp = await resolveDeploySelection(context, projectId, await listApps(context, provider, projectId), appName);
 	const deployResult = await provider.deployApp({
 		cwd: context.runtime.cwd,
@@ -109,7 +109,10 @@ async function runAppDeploy(context, appName, options) {
 	return {
 		command: "app.deploy",
 		result: {
-			projectId: deployResult.projectId,
+			workspace: target.workspace,
+			project: target.project,
+			branch: target.branch,
+			resolution: target.resolution,
 			app: {
 				id: deployResult.app.id,
 				name: deployResult.app.name
@@ -120,17 +123,16 @@ async function runAppDeploy(context, appName, options) {
 		nextSteps: ["prisma-cli app list-deploys", `prisma-cli app show-deploy ${deployResult.deployment.id}`]
 	};
 }
-async function runAppUpdateEnv(context, appName, envAssignments) {
+async function runAppUpdateEnv(context, appName, envAssignments, projectRef) {
 	ensurePreviewAppMode(context);
 	emitLegacyEnvDeprecationWarning(context, "app update-env", "project env add");
 	const envVars = parseEnvAssignments(envAssignments, {
 		commandName: "update-env",
 		requireAtLeastOne: true
 	});
-	const projectId = await requireLinkedProjectId(context);
-	const provider = await requirePreviewAppProvider(context);
+	const { provider, projectId } = await requireProviderAndProjectContext(context, projectRef);
 	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.");
+	if (!selectedApp) throw noDeploymentsError("No deployments available to update environment variables", "The resolved 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-cli app list-deploys"]);
 	});
@@ -163,11 +165,10 @@ async function runAppUpdateEnv(context, appName, envAssignments) {
 		nextSteps: ["prisma-cli app list-env", `prisma-cli app show-deploy ${updateResult.deployment.id}`]
 	};
 }
-async function runAppListEnv(context, appName) {
+async function runAppListEnv(context, appName, projectRef) {
 	ensurePreviewAppMode(context);
 	emitLegacyEnvDeprecationWarning(context, "app list-env", "project env list");
-	const projectId = await requireLinkedProjectId(context);
-	const provider = await requirePreviewAppProvider(context);
+	const { provider, projectId } = await requireProviderAndProjectContext(context, projectRef);
 	const selectedApp = await resolveExistingAppSelection(context, projectId, await listApps(context, provider, projectId), appName);
 	if (!selectedApp) return {
 		command: "app.list-env",
@@ -252,10 +253,9 @@ async function runAppListEnv(context, appName) {
 		nextSteps: deployment.id ? [`prisma-cli app show-deploy ${deployment.id}`] : ["prisma-cli app deploy"]
 	};
 }
-async function runAppListDeploys(context, appName) {
+async function runAppListDeploys(context, appName, projectRef) {
 	ensurePreviewAppMode(context);
-	const projectId = await requireLinkedProjectId(context);
-	const provider = await requirePreviewAppProvider(context);
+	const { provider, projectId } = await requireProviderAndProjectContext(context, projectRef);
 	const selectedApp = await resolveExistingAppSelection(context, projectId, await listApps(context, provider, projectId), appName);
 	if (!selectedApp) return {
 		command: "app.list-deploys",
@@ -290,10 +290,9 @@ async function runAppListDeploys(context, appName) {
 		nextSteps: deployments.length > 0 ? [`prisma-cli app show-deploy ${deployments[0]?.id}`] : ["prisma-cli app deploy"]
 	};
 }
-async function runAppShow(context, appName) {
+async function runAppShow(context, appName, projectRef) {
 	ensurePreviewAppMode(context);
-	const projectId = await requireLinkedProjectId(context);
-	const provider = await requirePreviewAppProvider(context);
+	const { provider, projectId } = await requireProviderAndProjectContext(context, projectRef);
 	const selectedApp = await resolveExistingAppSelection(context, projectId, await listApps(context, provider, projectId), appName);
 	if (!selectedApp) return {
 		command: "app.show",
@@ -347,8 +346,9 @@ async function runAppShowDeploy(context, deploymentId) {
 		exitCode: 1,
 		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;
+	const workspaceId = deployment?.app ? await readCurrentWorkspaceId(context) : null;
+	const rememberedProject = workspaceId ? await context.stateStore.readRememberedProject(workspaceId) : null;
+	const knownLiveDeploymentId = deployment?.app && rememberedProject ? await context.stateStore.readKnownLiveDeployment(rememberedProject.id, deployment.app.id) : null;
 	const providerLiveDeploymentId = deployment.app?.liveDeploymentId ?? null;
 	return {
 		command: "app.show-deploy",
@@ -366,12 +366,11 @@ async function runAppShowDeploy(context, deploymentId) {
 		nextSteps: []
 	};
 }
-async function runAppOpen(context, appName) {
+async function runAppOpen(context, appName, projectRef) {
 	ensurePreviewAppMode(context);
-	const projectId = await requireLinkedProjectId(context);
-	const provider = await requirePreviewAppProvider(context);
+	const { provider, projectId } = await requireProviderAndProjectContext(context, projectRef);
 	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.");
+	if (!selectedApp) throw noDeploymentsError("No deployments available to open", "The resolved project does not have any deployed app yet.");
 	const deploymentsResult = await provider.listDeployments(selectedApp.id).catch((error) => {
 		throw deployFailedError("Failed to resolve app URL", error, ["prisma-cli app show"]);
 	});
@@ -401,10 +400,9 @@ async function runAppOpen(context, appName) {
 		nextSteps: ["prisma-cli app show", `prisma-cli app show-deploy ${liveDeployment.id}`]
 	};
 }
-async function runAppLogs(context, appName, deploymentId) {
+async function runAppLogs(context, appName, deploymentId, projectRef) {
 	ensurePreviewAppMode(context);
-	const projectId = await requireLinkedProjectId(context);
-	const provider = await requirePreviewAppProvider(context);
+	const { provider, projectId } = await requireProviderAndProjectContext(context, projectRef);
 	const target = deploymentId ? await resolveExplicitLogDeployment(context, provider, projectId, appName, deploymentId) : await resolveLiveLogDeployment(context, provider, projectId, appName);
 	if (!context.flags.json && !context.flags.quiet) {
 		const lines = renderCommandHeader(context.ui, {
@@ -438,7 +436,7 @@ async function runAppLogs(context, appName, deploymentId) {
 async function resolveExplicitLogDeployment(context, provider, projectId, appName, deploymentId) {
 	if (appName) {
 		const selectedApp = await resolveExistingAppSelection(context, projectId, await listApps(context, provider, projectId), appName);
-		if (!selectedApp) throw noDeploymentsError("No deployments available to stream logs", "The linked project does not have any deployed app yet.");
+		if (!selectedApp) throw noDeploymentsError("No deployments available to stream logs", "The resolved project does not have any deployed app yet.");
 		const deploymentsResult = await provider.listDeployments(selectedApp.id).catch((error) => {
 			throw deployFailedError("Failed to list app deployments", error, ["prisma-cli app list-deploys"]);
 		});
@@ -473,28 +471,28 @@ async function resolveExplicitLogDeployment(context, provider, projectId, appNam
 		exitCode: 1,
 		nextSteps: ["prisma-cli app list-deploys"]
 	});
-	const linkedProjectApp = (await listApps(context, provider, projectId)).find((app) => app.id === shown.app?.id);
-	if (!linkedProjectApp) throw new CliError({
+	const resolvedProjectApp = (await listApps(context, provider, projectId)).find((app) => app.id === shown.app?.id);
+	if (!resolvedProjectApp) throw new CliError({
 		code: "DEPLOYMENT_NOT_FOUND",
 		domain: "app",
-		summary: `Deployment "${deploymentId}" not found in the linked project`,
-		why: "The requested deployment does not belong to an app in the linked project.",
+		summary: `Deployment "${deploymentId}" not found in the resolved project`,
+		why: "The requested deployment does not belong to an app in the resolved project.",
 		fix: "Run prisma-cli app list-deploys to choose an available deployment id for this project.",
 		exitCode: 1,
 		nextSteps: ["prisma-cli app list-deploys"]
 	});
 	await context.stateStore.setSelectedApp(projectId, {
-		id: linkedProjectApp.id,
-		name: linkedProjectApp.name
+		id: resolvedProjectApp.id,
+		name: resolvedProjectApp.name
 	});
 	return {
-		app: linkedProjectApp,
+		app: resolvedProjectApp,
 		deployment: shown.deployment
 	};
 }
 async function resolveLiveLogDeployment(context, provider, projectId, appName) {
 	const selectedApp = await resolveExistingAppSelection(context, projectId, await listApps(context, provider, projectId), appName);
-	if (!selectedApp) throw noDeploymentsError("No deployments available to stream logs", "The linked project does not have any deployed app yet.");
+	if (!selectedApp) throw noDeploymentsError("No deployments available to stream logs", "The resolved project does not have any deployed app yet.");
 	const deploymentsResult = await provider.listDeployments(selectedApp.id).catch((error) => {
 		throw deployFailedError("Failed to list app deployments", error, ["prisma-cli app list-deploys"]);
 	});
@@ -526,10 +524,9 @@ function writeLogRecord(context, record) {
 		if (!record.text.endsWith("\n")) context.output.stdout.write("\n");
 	}
 }
-async function runAppPromote(context, deploymentId, appName) {
+async function runAppPromote(context, deploymentId, appName, projectRef) {
 	ensurePreviewAppMode(context);
-	const projectId = await requireLinkedProjectId(context);
-	const provider = await requirePreviewAppProvider(context);
+	const { provider, projectId } = await requireProviderAndProjectContext(context, projectRef);
 	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-cli app list-deploys"]);
@@ -567,10 +564,9 @@ async function runAppPromote(context, deploymentId, appName) {
 		nextSteps: ["prisma-cli app list-deploys", `prisma-cli app show-deploy ${targetDeployment.id}`]
 	};
 }
-async function runAppRollback(context, appName, deploymentId) {
+async function runAppRollback(context, appName, deploymentId, projectRef) {
 	ensurePreviewAppMode(context);
-	const projectId = await requireLinkedProjectId(context);
-	const provider = await requirePreviewAppProvider(context);
+	const { provider, projectId } = await requireProviderAndProjectContext(context, projectRef);
 	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-cli app list-deploys"]);
@@ -610,10 +606,9 @@ async function runAppRollback(context, appName, deploymentId) {
 		nextSteps: ["prisma-cli app list-deploys", `prisma-cli app show-deploy ${targetDeployment.id}`]
 	};
 }
-async function runAppRemove(context, appName) {
+async function runAppRemove(context, appName, projectRef) {
 	ensurePreviewAppMode(context);
-	const projectId = await requireLinkedProjectId(context);
-	const provider = await requirePreviewAppProvider(context);
+	const { provider, projectId } = await requireProviderAndProjectContext(context, projectRef);
 	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) => {
@@ -654,7 +649,7 @@ 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-cli app deploy in a TTY to choose or create an app again.", ["prisma-cli 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 resolved 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-cli app deploy in a TTY to choose or create an app.", ["prisma-cli app deploy --app hello-world"], "app");
 	return { useInteractiveSelection: true };
@@ -662,14 +657,14 @@ async function resolveDeploySelection(context, projectId, apps, explicitAppName)
 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-cli app list-deploys in a TTY to choose one.", ["prisma-cli app list-deploys"], "app");
+		if (!matched) throw usageError("Selected app does not exist in the resolved project", `The app "${explicitAppName}" could not be found in resolved 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-cli app list-deploys in a TTY to choose an available app.", ["prisma-cli 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 resolved 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-cli app list-deploys in a TTY to choose an app.", ["prisma-cli app list-deploys"], "app");
@@ -685,7 +680,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-cli app ${commandName} with --app <name> after an app exists.`, ["prisma-cli app deploy", "prisma-cli app list-deploys"], "app");
+	throw usageError(`App ${commandName} requires an existing app`, "The resolved 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;
@@ -774,18 +769,29 @@ function resolveRollbackTarget(deployments, currentLiveDeploymentId) {
 }
 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-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"
-		]);
+		if (isMissingProjectError(error)) throw new CliError({
+			code: "PROJECT_NOT_FOUND",
+			domain: "project",
+			summary: "Project not found",
+			why: `The resolved project "${projectId}" does not exist in the authenticated workspace or is no longer accessible.`,
+			fix: "Pass --project <id-or-name>, or run prisma-cli project show to inspect resolution for this directory.",
+			exitCode: 1,
+			nextSteps: ["prisma-cli project show", "prisma-cli app deploy --project <id-or-name>"]
+		});
 		throw deployFailedError("Failed to list apps", error, ["prisma-cli project show"]);
 	});
 }
 async function requirePreviewAppProvider(context) {
+	const { provider } = await requirePreviewAppProviderWithClient(context);
+	return provider;
+}
+async function requirePreviewAppProviderWithClient(context) {
 	const client = await requireComputeAuth(context.runtime.env);
 	if (!client) throw authRequiredError(["prisma-cli auth login"]);
-	return createPreviewAppProvider(client, createPreviewLogAuthOptions(context.runtime.env));
+	return {
+		client,
+		provider: createPreviewAppProvider(client, createPreviewLogAuthOptions(context.runtime.env))
+	};
 }
 function createPreviewLogAuthOptions(env) {
 	const rawToken = env[SERVICE_TOKEN_ENV_VAR]?.trim();
@@ -803,42 +809,58 @@ function createPreviewLogAuthOptions(env) {
 		}
 	};
 }
-async function requireLinkedProjectId(context) {
-	const projectId = await readLinkedProjectId(context.runtime.cwd);
-	if (!projectId) throw new CliError({
-		code: "PROJECT_NOT_LINKED",
-		domain: "project",
-		summary: "Project link required",
-		why: "This command needs a linked project for the current repo.",
-		fix: "Run prisma-cli project link before deploying or inspecting app deployments.",
-		exitCode: 1,
-		nextSteps: ["prisma-cli project link"]
-	});
-	return projectId;
+async function requireProviderAndProjectContext(context, explicitProject, options) {
+	const { client, provider } = await requirePreviewAppProviderWithClient(context);
+	const target = await resolveProjectContext(context, client, provider, explicitProject, options);
+	return {
+		client,
+		provider,
+		target,
+		projectId: target.project.id
+	};
 }
-async function resolveProjectIdForDeploy(context, provider) {
-	const linkedProjectId = await readLinkedProjectId(context.runtime.cwd);
-	if (linkedProjectId) return linkedProjectId;
-	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-cli app deploy"]);
+async function resolveProjectContext(context, client, provider, explicitProject, options) {
+	const authState = await requireAuthenticatedAuthState(context);
+	if (!authState.workspace) throw workspaceRequiredError();
+	const resolved = await resolveProjectTarget({
+		context,
+		workspace: authState.workspace,
+		explicitProject,
+		listProjects: () => listRealWorkspaceProjects(client, authState.workspace),
+		createProject: options?.allowCreate ? async (name) => {
+			const project = await provider.createProject({ name }).catch((error) => {
+				throw createProjectOnFirstDeployError({
+					error,
+					inferredName: name,
+					workspaceName: authState.workspace.name
+				});
+			});
+			return {
+				id: project.id,
+				name: project.name,
+				workspace: authState.workspace
+			};
+		} : void 0,
+		allowCreate: options?.allowCreate,
+		prompt: createSelectPromptPort(context),
+		remember: true
 	});
-	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-cli project show", "prisma-cli app deploy"]);
-	}
-	return project.id;
+	const branchName = await context.stateStore.read().then((state) => state.branch.active);
+	return {
+		...resolved,
+		branch: {
+			name: branchName,
+			kind: toBranchKind(branchName)
+		}
+	};
 }
-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-cli app deploy.", ["prisma-cli app deploy --app hello-world"], "app");
-		throw error;
-	}
+function toBranchKind(name) {
+	return name === "production" ? "production" : "preview";
+}
+async function readCurrentWorkspaceId(context) {
+	const state = await context.stateStore.read();
+	if (state.auth?.workspaceId) return state.auth.workspaceId;
+	return (await readAuthState(context.runtime.env)).workspace?.id ?? null;
 }
 function normalizeBuildType(requestedBuildType) {
 	if (!requestedBuildType) return "auto";
@@ -875,7 +897,7 @@ function parseDeployPortMapping(requestedPort) {
 }
 function ensurePreviewAppMode(context) {
 	if (isRealMode(context)) return;
-	throw featureUnavailableError("App commands are not available in fixture mode", "Preview app commands require live app deployment integration.", "Rerun without fixture mode enabled to use preview app deployment workflows.", ["prisma-cli auth login", "prisma-cli project 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 show"], "app");
 }
 function deployFailedError(summary, error, nextSteps) {
 	return new CliError({
@@ -889,6 +911,52 @@ function deployFailedError(summary, error, nextSteps) {
 		nextSteps
 	});
 }
+/**
+* `app deploy` falls into "create a new project on first deploy" when no
+* existing project matches the package.json name (or the cwd basename as a
+* fallback). When the create call fails the user often doesn't realise the
+* CLI was attempting to create a project at all — they thought the deploy
+* would find an existing project. Surface that context, and recommend the
+* explicit `--project` flag as the unambiguous way out.
+*/
+function createProjectOnFirstDeployError(options) {
+	const { error, inferredName, workspaceName } = options;
+	const status = extractHttpStatus(error);
+	const errorMessage = error instanceof Error ? error.message : String(error);
+	const inferredContext = `No existing project matched the package.json name \`${inferredName}\`, so the CLI attempted to create one.`;
+	const nextSteps = ["prisma-cli project list", "prisma-cli app deploy --project <id-or-name>"];
+	if (status === 401 || status === 403) return new CliError({
+		code: "AUTH_FORBIDDEN",
+		domain: "auth",
+		summary: "Could not create a new project for this deploy",
+		why: `${inferredContext} The platform rejected the create (HTTP ${status}).`,
+		fix: `Pass --project <id-or-name> to deploy into an existing project, or grant the service token project-create permission on workspace \`${workspaceName}\`.`,
+		debug: formatDebugDetails(error),
+		exitCode: 1,
+		nextSteps
+	});
+	return new CliError({
+		code: "DEPLOY_FAILED",
+		domain: "app",
+		summary: "Could not create a new project for this deploy",
+		why: `${inferredContext} ${errorMessage}`.trim(),
+		fix: "Pass --project <id-or-name> to deploy into an existing project, or retry after addressing the platform error above.",
+		debug: formatDebugDetails(error),
+		exitCode: 1,
+		nextSteps
+	});
+}
+function extractHttpStatus(error) {
+	if (!error || typeof error !== "object") return null;
+	const candidate = error;
+	if (typeof candidate.statusCode === "number") return candidate.statusCode;
+	if (typeof candidate.status === "number") return candidate.status;
+	if (typeof candidate.message === "string") {
+		const match = /\(HTTP (\d{3})\)/.exec(candidate.message);
+		if (match) return Number.parseInt(match[1], 10);
+	}
+	return null;
+}
 function noDeploymentsError(summary, why) {
 	return new CliError({
 		code: "NO_DEPLOYMENTS",

package/dist/controllers/auth.js

@@ -1,9 +1,9 @@
 import { authRequiredError, usageError } from "../shell/errors.js";
 import { canPrompt } from "../shell/runtime.js";
-import { createSelectPromptPort } from "./select-prompt-port.js";
+import { performLogin, performLogout, readAuthState } from "../lib/auth/auth-ops.js";
 import { createAuthUseCases } from "../use-cases/auth.js";
 import { createCliUseCaseGateways } from "../use-cases/create-cli-gateways.js";
-import { performLogin, performLogout, readAuthState } from "../lib/auth/auth-ops.js";
+import { createSelectPromptPort } from "./select-prompt-port.js";
 //#region src/controllers/auth.ts
 function isRealMode(context) {
 	return !context.runtime.fixturePath && !context.runtime.env.PRISMA_CLI_MOCK_FIXTURE_PATH;

package/dist/controllers/branch.js

@@ -1,7 +1,7 @@
 import { featureUnavailableError, usageError } from "../shell/errors.js";
 import { canPrompt } from "../shell/runtime.js";
-import { createSelectPromptPort } from "./select-prompt-port.js";
 import { createCliUseCaseGateways } from "../use-cases/create-cli-gateways.js";
+import { createSelectPromptPort } from "./select-prompt-port.js";
 import { createBranchUseCases } from "../use-cases/branch.js";
 //#region src/controllers/branch.ts
 const PREVIEW_BRANCH_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;