@prisma/cli 3.0.0-dev.41.1 → 3.0.0-dev.43.1

package/dist/commands/project/index.js

@@ -31,10 +31,10 @@ function createProjectCreateCommand(runtime) {
 }
 function createProjectLinkCommand(runtime) {
 	const command = attachCommandDescriptor(configureRuntimeCommand(new Command("link"), runtime), "project.link");
-	command.argument("<id-or-name>", "Project id or name");
+	command.argument("[id-or-name]", "Project id or name");
 	addGlobalFlags(command);
 	command.action(async (projectRef, options) => {
-		await runCommand(runtime, "project.link", options, (context) => runProjectLink(context, String(projectRef)), {
+		await runCommand(runtime, "project.link", options, (context) => runProjectLink(context, typeof projectRef === "string" ? projectRef : void 0), {
 			renderHuman: (context, descriptor, result) => renderProjectSetup(context, descriptor, result),
 			renderJson: (result) => serializeProjectSetup(result)
 		});

package/dist/controllers/app.js

@@ -11,9 +11,11 @@ import { parseEnvAssignments } from "../lib/app/env-vars.js";
 import { renderDeployOutputRows } from "../lib/app/deploy-output.js";
 import { readBunPackageEntrypoint, readBunPackageJson } from "../lib/app/bun-project.js";
 import { DEFAULT_LOCAL_DEV_PORT, resolveLocalBuildType, runLocalApp } from "../lib/app/local-dev.js";
+import { formatCommandArgument } from "../shell/command-arguments.js";
 import { LOCAL_RESOLUTION_PIN_RELATIVE_PATH, readLocalResolutionPin } from "../lib/project/local-pin.js";
-import { inferTargetName, projectNotFoundError, resolveDurablePlatformMapping, resolveProjectTarget, sortProjects } from "../lib/project/resolution.js";
-import { bindProjectToDirectory, formatCommandArgument, projectCreateFailedError, projectSetupNameRequiredError, resolveProjectForSetup, toProjectSummary } from "../lib/project/setup.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 { PREVIEW_BUILD_TYPES, RESOLVED_PREVIEW_BUILD_TYPES, executePreviewBuild } from "../lib/app/preview-build.js";
 import { PREVIEW_DEFAULT_REGION } from "../lib/app/preview-interaction.js";
 import { createPreviewDeployProgress, createPreviewDeployProgressState, createPreviewPromoteProgress } from "../lib/app/preview-progress.js";
@@ -1361,58 +1363,25 @@ async function resolveDeployProjectContext(context, client, provider, explicitPr
 	throw projectSetupRequiredError(projects, await inferTargetName(context.runtime.cwd));
 }
 async function resolveInteractiveDeployProjectSetup(context, provider, workspace, projects) {
-	const sortedProjects = sortProjects(projects);
-	const choice = await selectPrompt({
-		input: context.runtime.stdin,
-		output: context.runtime.stderr,
-		message: "Which Project should this directory use?",
-		choices: [
-			...sortedProjects.map((project) => ({
-				label: project.name,
-				value: {
-					kind: "project",
-					project
-				}
-			})),
-			{
-				label: "Create a new Project",
-				value: { kind: "create" }
-			},
-			{
-				label: "Cancel",
-				value: { kind: "cancel" }
-			}
-		]
-	});
-	if (choice.kind === "cancel") throw usageError("Project setup canceled", "Deploy needs a Project before it can continue.", "Choose an existing Project or create a new one, then rerun deploy.", ["prisma-cli app deploy --project <id-or-name>", "prisma-cli app deploy --create-project <name>"], "project");
-	if (choice.kind === "project") return {
-		workspace,
-		project: toProjectSummary(choice.project),
-		resolution: {
-			projectSource: "prompt",
-			targetName: choice.project.name,
-			targetNameSource: "prompt"
-		},
-		localPinAction: "linked"
-	};
-	const suggestedName = await inferTargetName(context.runtime.cwd);
-	const rawName = await textPrompt({
-		input: context.runtime.stdin,
-		output: context.runtime.stderr,
-		message: "Project name",
-		placeholder: suggestedName.name,
-		validate: (value) => validateProjectSetupNameText(value, suggestedName.name)
+	const setup = await promptForProjectSetupChoice({
+		context,
+		projects,
+		createProject: (projectName) => createProjectForDeploySetup(provider, projectName, workspace),
+		cancel: {
+			why: "Deploy needs a Project before it can continue.",
+			fix: "Choose an existing Project or create a new one, then rerun deploy.",
+			nextSteps: ["prisma-cli app deploy --project <id-or-name>", "prisma-cli app deploy --create-project <name>"]
+		}
 	});
-	const projectName = rawName.trim() || suggestedName.name;
 	return {
 		workspace,
-		project: toProjectSummary(await createProjectForDeploySetup(provider, projectName, workspace)),
+		project: setup.project,
 		resolution: {
-			projectSource: "created",
-			targetName: projectName,
-			targetNameSource: rawName.trim() ? "prompt" : suggestedName.source
+			projectSource: setup.action === "created" ? "created" : "prompt",
+			targetName: setup.targetName,
+			targetNameSource: setup.targetNameSource
 		},
-		localPinAction: "created"
+		localPinAction: setup.action
 	};
 }
 async function createProjectForDeploySetup(provider, projectName, workspace) {
@@ -1458,10 +1427,6 @@ function assertExclusiveDeployProjectInputs(options) {
 		`unset ${PRISMA_PROJECT_ID_ENV_VAR}`
 	], "project");
 }
-function validateProjectSetupNameText(value, fallback) {
-	if ((value?.trim() || fallback).trim().length > 0) return;
-	return "Enter a Project name.";
-}
 async function resolveDeployBranch(context, explicitBranchName) {
 	if (explicitBranchName) return {
 		name: explicitBranchName,
@@ -1796,24 +1761,41 @@ function deployFailedError(summary, error, nextSteps) {
 function appDeployFailedError(error, progress) {
 	const why = error instanceof Error ? error.message : String(error);
 	const debug = formatDebugDetails(error);
-	if (progress.buildStarted && !progress.buildCompleted) return new CliError({
-		code: "BUILD_FAILED",
-		domain: "app",
-		summary: "Build failed locally.",
-		why,
-		fix: "Inspect the build output above, fix the error, and redeploy.",
-		debug,
-		meta: { phase: "build" },
-		humanLines: [
-			"Build failed locally.",
-			"",
-			`✗ Built       ${why}`,
-			"",
-			"Fix: Inspect the build output above, fix the error, and redeploy."
-		],
-		exitCode: 1,
-		nextSteps: []
-	});
+	if (progress.buildStarted && !progress.buildCompleted) {
+		const standaloneOutputFailure = isNextStandaloneOutputFailure(why);
+		const fix = standaloneOutputFailure ? "Add output: \"standalone\" to next.config.*, then rerun deploy." : "Inspect the build output above, fix the error, and redeploy.";
+		const nextSteps = standaloneOutputFailure ? ["Add output: \"standalone\" to next.config.*, then rerun prisma-cli app deploy"] : [];
+		const nextActions = standaloneOutputFailure ? [{
+			kind: "edit-file",
+			journey: "deploy-app",
+			label: "Add Next.js standalone output",
+			reason: "Prisma Compute needs Next.js standalone output to build a deployable server artifact."
+		}, {
+			kind: "run-command",
+			journey: "deploy-app",
+			label: "Rerun deploy",
+			command: "prisma-cli app deploy"
+		}] : [];
+		return new CliError({
+			code: "BUILD_FAILED",
+			domain: "app",
+			summary: "Build failed locally.",
+			why,
+			fix,
+			debug,
+			meta: { phase: "build" },
+			humanLines: [
+				"Build failed locally.",
+				"",
+				`✗ Built       ${why}`,
+				"",
+				`Fix: ${fix}`
+			],
+			exitCode: 1,
+			nextSteps,
+			nextActions
+		});
+	}
 	if (!progress.buildStarted) return deployFailedError("App deploy failed", error, ["prisma-cli app deploy"]);
 	const phaseHeadline = progress.containerLive ? "The deployment started, but the app is not ready yet." : "Deploy failed after the build completed.";
 	const recoveryLines = progress.versionId ? ["See what happened", `prisma-cli app logs --deployment ${progress.versionId}`] : ["Fix", "Retry the command, or rerun with --trace for more detailed diagnostics."];
@@ -1896,9 +1878,17 @@ function projectSetupRequiredError(projects, suggestedName) {
 			"prisma-cli project list",
 			"prisma-cli app deploy --project <id-or-name>",
 			createCommand
-		]
+		],
+		nextActions: buildProjectSetupNextActions({
+			commandName: "app deploy",
+			createCommand,
+			reason: "This directory is not linked to a Prisma Project. Ask the user which Project to use before deploying; package and directory names are setup suggestions only."
+		})
 	});
 }
+function isNextStandaloneOutputFailure(message) {
+	return /next\.?js/i.test(message) && /standalone output/i.test(message);
+}
 function noDeploymentsError(summary, why) {
 	return new CliError({
 		code: "NO_DEPLOYMENTS",

package/dist/controllers/project.js

@@ -2,8 +2,11 @@ import { CliError, authRequiredError, featureUnavailableError, usageError, works
 import { renderSummaryLine } from "../shell/ui.js";
 import { canPrompt } from "../shell/runtime.js";
 import { requireComputeAuth } from "../lib/auth/guard.js";
-import { inspectProjectBinding, resolveProjectTarget, sortProjects } from "../lib/project/resolution.js";
+import { formatCommandArgument } from "../shell/command-arguments.js";
+import { readLocalResolutionPin } from "../lib/project/local-pin.js";
+import { buildProjectSetupNextActions, inferTargetName, inspectProjectBinding, resolveProjectTarget, sortProjects } from "../lib/project/resolution.js";
 import { bindProjectToDirectory, isValidProjectSetupName, projectCreateFailedError, projectSetupNameRequiredError, resolveProjectForSetup, toProjectSummary } from "../lib/project/setup.js";
+import { promptForProjectSetupChoice } from "../lib/project/interactive-setup.js";
 import { createPreviewAppProvider } from "../lib/app/preview-provider.js";
 import { createCliUseCaseGateways } from "../use-cases/create-cli-gateways.js";
 import { requireAuthenticatedAuthState } from "./auth.js";
@@ -16,6 +19,12 @@ const GITHUB_INSTALL_POLL_TIMEOUT_MS = 12e4;
 function isRealMode(context) {
 	return !context.runtime.fixturePath && !context.runtime.env.PRISMA_CLI_MOCK_FIXTURE_PATH;
 }
+async function readProjectListLocalBinding(cwd, workspace, projects) {
+	const pin = await readLocalResolutionPin(cwd);
+	if (pin.kind === "present") return pin.pin.workspaceId === workspace.id && projects.some((project) => project.id === pin.pin.projectId) ? { status: "linked" } : { status: "invalid" };
+	if (pin.kind === "invalid") return { status: "invalid" };
+	return { status: "not-linked" };
+}
 async function runProjectList(context) {
 	const authState = await requireAuthenticatedAuthState(context);
 	const workspace = authState.workspace;
@@ -23,31 +32,55 @@ async function runProjectList(context) {
 	if (isRealMode(context)) {
 		const client = await requireComputeAuth(context.runtime.env);
 		if (!client) throw authRequiredError();
+		const projects = sortProjects(await listRealWorkspaceProjects(client, workspace));
+		const localBinding = await readProjectListLocalBinding(context.runtime.cwd, workspace, projects);
+		const nextActions = buildProjectListNextActions(localBinding);
 		return {
 			command: "project.list",
 			result: {
 				workspace,
-				projects: sortProjects(await listRealWorkspaceProjects(client, workspace)).map(toProjectSummary)
+				projects: projects.map(toProjectSummary),
+				localBinding
 			},
 			warnings: [],
-			nextSteps: []
+			nextSteps: [],
+			nextActions
 		};
 	}
+	const result = await createProjectUseCases(createCliUseCaseGateways(context)).list(authState);
+	const localBinding = await readProjectListLocalBinding(context.runtime.cwd, workspace, result.projects);
+	const nextActions = buildProjectListNextActions(localBinding);
 	return {
 		command: "project.list",
-		result: await createProjectUseCases(createCliUseCaseGateways(context)).list(authState),
+		result: {
+			...result,
+			localBinding
+		},
 		warnings: [],
-		nextSteps: []
+		nextSteps: [],
+		nextActions
 	};
 }
+function buildProjectListNextActions(localBinding) {
+	return localBinding?.status === "linked" ? [] : buildProjectSetupNextActions({
+		createCommand: "prisma-cli project create <name>",
+		reason: localBinding?.status === "invalid" ? "This directory has an invalid local Project binding. Ask the user which Prisma Project to link before running Project-scoped commands." : "This directory is not linked to a Prisma Project. Project list shows available Projects, but none is selected for this directory."
+	});
+}
 async function runProjectShow(context, explicitProject) {
 	const workspace = (await requireAuthenticatedAuthState(context)).workspace;
 	if (!workspace) throw workspaceRequiredError();
+	const result = isRealMode(context) ? await resolveProjectShowInRealMode(context, workspace, explicitProject) : await resolveProjectShowInFixtureMode(context, workspace, explicitProject);
 	return {
 		command: "project.show",
-		result: isRealMode(context) ? await resolveProjectShowInRealMode(context, workspace, explicitProject) : await resolveProjectShowInFixtureMode(context, workspace, explicitProject),
+		result,
 		warnings: [],
-		nextSteps: []
+		nextSteps: [],
+		nextActions: result.project === null ? buildProjectSetupNextActions({
+			commandName: "project show",
+			suggestedProjectName: result.suggestedProjectName,
+			reason: "This directory is not linked to a Prisma Project. Package and directory names can suggest setup defaults, but they do not select a Project."
+		}) : []
 	};
 }
 async function runProjectCreate(context, projectName) {
@@ -79,15 +112,84 @@ async function runProjectCreate(context, projectName) {
 async function runProjectLink(context, projectRef) {
 	const workspace = (await requireAuthenticatedAuthState(context)).workspace;
 	if (!workspace) throw workspaceRequiredError();
-	if (!projectRef || !projectRef.trim()) throw usageError("Project link requires a Project id or name", "The command cannot choose a Project without an explicit id or name.", "Pass the Project id or name as the first argument.", ["prisma-cli project link proj_123"], "project");
-	const projects = isRealMode(context) ? await listRealProjectsForLink(context, workspace) : listFixtureWorkspaceProjects(context, workspace);
+	let provider = null;
+	let projects;
+	if (isRealMode(context)) {
+		const client = await requireComputeAuth(context.runtime.env);
+		if (!client) throw authRequiredError();
+		provider = createPreviewAppProvider(client);
+		projects = await listRealWorkspaceProjects(client, workspace);
+	} else projects = listFixtureWorkspaceProjects(context, workspace);
+	let result;
+	if (projectRef?.trim()) result = await bindProjectToDirectory(context, workspace, toProjectSummary(resolveProjectForSetup(projectRef.trim(), projects, workspace)), "linked");
+	else if (canPrompt(context) && !context.flags.yes) result = await resolveInteractiveProjectLinkSetup(context, workspace, projects, provider);
+	else throw await projectLinkTargetRequiredError(context, projects);
 	return {
 		command: "project.link",
-		result: await bindProjectToDirectory(context, workspace, toProjectSummary(resolveProjectForSetup(projectRef.trim(), projects, workspace)), "linked"),
+		result,
 		warnings: [],
 		nextSteps: ["prisma-cli app deploy"]
 	};
 }
+async function resolveInteractiveProjectLinkSetup(context, workspace, projects, provider) {
+	const setup = await promptForProjectSetupChoice({
+		context,
+		projects,
+		createProject: (projectName) => {
+			if (!provider) throw featureUnavailableError("Project create is not available in fixture mode", "Creating Projects requires live platform integration.", "Rerun without fixture mode enabled to create a Project.", ["prisma-cli auth login"], "project");
+			return createProjectForLinkSetup(provider, projectName, workspace);
+		},
+		cancel: {
+			why: "Project link needs a Project before it can continue.",
+			fix: "Choose an existing Project or create a new one, then rerun project link.",
+			nextSteps: ["prisma-cli project link <id-or-name>", "prisma-cli project create <name>"]
+		}
+	});
+	return bindProjectToDirectory(context, workspace, setup.project, setup.action);
+}
+async function createProjectForLinkSetup(provider, projectName, workspace) {
+	const created = await provider.createProject({ name: projectName }).catch((error) => {
+		throw projectCreateFailedError(error, projectName, workspace, {
+			nextSteps: [
+				"prisma-cli project list",
+				"prisma-cli project link <id-or-name>",
+				`prisma-cli project create ${formatCommandArgument(projectName)}`
+			],
+			permissionFix: "Grant the token permission to create Projects in this workspace, or link an existing Project.",
+			fallbackFix: "Retry the command, or choose an existing Project with prisma-cli project link <id-or-name>."
+		});
+	});
+	return {
+		id: created.id,
+		name: created.name,
+		workspace
+	};
+}
+async function projectLinkTargetRequiredError(context, projects) {
+	const suggestedName = await inferTargetName(context.runtime.cwd);
+	const createCommand = `prisma-cli project create ${formatCommandArgument(suggestedName.name)}`;
+	const recoveryCommands = ["prisma-cli project link <id-or-name>", createCommand];
+	return new CliError({
+		code: "PROJECT_LINK_TARGET_REQUIRED",
+		domain: "project",
+		summary: "Choose a Project to link this directory",
+		why: "This directory is not linked to a Prisma Project. Existing Projects are candidates until the user chooses one, and package or directory names are suggestions only.",
+		fix: "Run prisma-cli project link in a TTY to choose from the setup list, pass a Project id or name, or create a new Project.",
+		meta: {
+			suggestedProjectName: suggestedName.name,
+			suggestedProjectNameSource: suggestedName.source,
+			candidates: sortProjects(projects).map(toProjectSummary),
+			recoveryCommands
+		},
+		exitCode: 2,
+		nextSteps: ["prisma-cli project list", ...recoveryCommands],
+		nextActions: buildProjectSetupNextActions({
+			suggestedProjectName: suggestedName.name,
+			createCommand,
+			reason: "Project link needs the user to choose an existing Project or create a new one. Existing Projects, package names, and directory names are candidates only, not selections."
+		})
+	});
+}
 async function runGitConnect(context, gitUrl, options = {}) {
 	const workspace = (await requireAuthenticatedAuthState(context)).workspace;
 	if (!workspace) throw workspaceRequiredError();
@@ -214,11 +316,6 @@ async function resolveRequiredProjectInRealMode(context, workspace, explicitProj
 		commandName
 	});
 }
-async function listRealProjectsForLink(context, workspace) {
-	const client = await requireComputeAuth(context.runtime.env);
-	if (!client) throw authRequiredError();
-	return listRealWorkspaceProjects(client, workspace);
-}
 async function resolveProjectShowInFixtureMode(context, workspace, explicitProject) {
 	return inspectProjectBinding({
 		context,

package/dist/lib/project/interactive-setup.js

@@ -0,0 +1,56 @@
+import { usageError } from "../../shell/errors.js";
+import { selectPrompt, textPrompt } from "../../shell/prompt.js";
+import { inferTargetName, sortProjects } from "./resolution.js";
+import { toProjectSummary, validateProjectSetupNameText } from "./setup.js";
+//#region src/lib/project/interactive-setup.ts
+async function promptForProjectSetupChoice(options) {
+	const sortedProjects = sortProjects(options.projects);
+	const projectNames = sortedProjects.map((project) => project.name);
+	const duplicateNames = new Set(projectNames.filter((name, index) => projectNames.indexOf(name) !== index));
+	const choice = await selectPrompt({
+		input: options.context.runtime.stdin,
+		output: options.context.runtime.stderr,
+		message: "Which Project should this directory use?",
+		choices: [
+			...sortedProjects.map((project) => ({
+				label: duplicateNames.has(project.name) ? `${project.name} (${project.id})` : project.name,
+				value: {
+					kind: "project",
+					project
+				}
+			})),
+			{
+				label: "Create a new Project",
+				value: { kind: "create" }
+			},
+			{
+				label: "Cancel",
+				value: { kind: "cancel" }
+			}
+		]
+	});
+	if (choice.kind === "cancel") throw usageError("Project setup canceled", options.cancel.why, options.cancel.fix, options.cancel.nextSteps, "project");
+	if (choice.kind === "project") return {
+		project: toProjectSummary(choice.project),
+		action: "linked",
+		targetName: choice.project.name,
+		targetNameSource: "prompt"
+	};
+	const suggestedName = await inferTargetName(options.context.runtime.cwd);
+	const rawName = await textPrompt({
+		input: options.context.runtime.stdin,
+		output: options.context.runtime.stderr,
+		message: "Project name",
+		placeholder: suggestedName.name,
+		validate: (value) => validateProjectSetupNameText(value, suggestedName.name)
+	});
+	const projectName = rawName.trim() || suggestedName.name;
+	return {
+		project: toProjectSummary(await options.createProject(projectName)),
+		action: "created",
+		targetName: projectName,
+		targetNameSource: rawName.trim() ? "prompt" : suggestedName.source
+	};
+}
+//#endregion
+export { promptForProjectSetupChoice };

package/dist/lib/project/resolution.js

@@ -1,4 +1,5 @@
 import { CliError } from "../../shell/errors.js";
+import { formatCommandArgument } from "../../shell/command-arguments.js";
 import { LOCAL_RESOLUTION_PIN_RELATIVE_PATH, readLocalResolutionPin } from "./local-pin.js";
 import { readFile } from "node:fs/promises";
 import path from "node:path";
@@ -20,6 +21,7 @@ async function inspectProjectBinding(options) {
 	return {
 		workspace: options.workspace,
 		project: null,
+		localBinding: { status: "not-linked" },
 		resolution: { projectSource: "unbound" },
 		...await buildProjectSetupSuggestion({
 			cwd: options.context.runtime.cwd,
@@ -89,8 +91,45 @@ async function projectSetupRequiredError(options) {
 		fix: "Link the directory to an existing Project, or pass --project <id-or-name> for this command.",
 		meta: { ...suggestion },
 		exitCode: 1,
-		nextSteps: ["prisma-cli project list", ...suggestion.recoveryCommands]
+		nextSteps: ["prisma-cli project list", ...suggestion.recoveryCommands],
+		nextActions: buildProjectSetupNextActions({
+			commandName: options.commandName,
+			suggestedProjectName: suggestion.suggestedProjectName
+		})
+	});
+}
+function buildProjectSetupNextActions(options = {}) {
+	const recoveryCommands = buildProjectRecoveryCommands(options.commandName);
+	const linkCommand = recoveryCommands[0] ?? "prisma-cli project link <id-or-name>";
+	const retryCommand = recoveryCommands[1];
+	const actions = [{
+		kind: "user-choice",
+		journey: "project-setup",
+		label: "Ask the user whether to link an existing Project or create a new one",
+		commands: ["prisma-cli project list", ...recoveryCommands],
+		reason: options.reason ?? "This directory is not linked to a Prisma Project. Package and directory names are suggestions only, not a safe Project selection."
+	}, {
+		kind: "run-command",
+		journey: "project-setup",
+		label: "Link the chosen Project",
+		command: linkCommand,
+		reason: "Linking writes the durable local Project binding for this directory."
+	}];
+	const createCommand = options.createCommand ?? (options.suggestedProjectName ? `prisma-cli project create ${formatCommandArgument(options.suggestedProjectName)}` : void 0);
+	if (createCommand) actions.push({
+		kind: "run-command",
+		journey: "project-setup",
+		label: "Create and link a new Project",
+		command: createCommand,
+		reason: "Use this when the user wants a new Prisma Project instead of an existing one."
+	});
+	if (options.commandName) actions.push({
+		kind: "run-command",
+		journey: "recover",
+		label: "Retry with an explicit Project",
+		command: retryCommand ?? `prisma-cli ${options.commandName} --project <id-or-name>`
 	});
+	return actions;
 }
 async function readPackageName(cwd) {
 	try {
@@ -187,4 +226,4 @@ function toProjectSummary(project) {
 	};
 }
 //#endregion
-export { inferTargetName, inspectProjectBinding, projectAmbiguousError, projectNotFoundError, resolveDurablePlatformMapping, resolveProjectTarget, sortProjects };
+export { buildProjectSetupNextActions, inferTargetName, inspectProjectBinding, projectAmbiguousError, projectNotFoundError, resolveDurablePlatformMapping, resolveProjectTarget, sortProjects };

package/dist/lib/project/setup.js

@@ -1,10 +1,15 @@
 import { CliError, usageError } from "../../shell/errors.js";
+import "../../shell/command-arguments.js";
 import { LOCAL_RESOLUTION_PIN_RELATIVE_PATH, ensureLocalResolutionPinGitignore, writeLocalResolutionPin } from "./local-pin.js";
 import { projectAmbiguousError, projectNotFoundError } from "./resolution.js";
 //#region src/lib/project/setup.ts
 function isValidProjectSetupName(projectName) {
 	return projectName.trim().length > 0;
 }
+function validateProjectSetupNameText(value, fallback) {
+	if ((value?.trim() || fallback).trim().length > 0) return;
+	return "Enter a Project name.";
+}
 function resolveProjectForSetup(projectRef, projects, workspace) {
 	const matches = projects.filter((project) => project.id === projectRef || project.name === projectRef);
 	if (matches.length === 1) return matches[0];
@@ -60,9 +65,6 @@ function projectCreateFailedError(error, projectName, workspace, options) {
 		nextSteps: options.nextSteps
 	});
 }
-function formatCommandArgument(value) {
-	return /^[A-Za-z0-9._/-]+$/.test(value) ? value : JSON.stringify(value);
-}
 function formatSetupDirectory(cwd) {
 	const basename = cwd.split(/[\\/]/).filter(Boolean).pop();
 	return basename ? `./${basename}` : ".";
@@ -83,4 +85,4 @@ function formatDebugDetails(error) {
 	return typeof error === "string" ? error : null;
 }
 //#endregion
-export { bindProjectToDirectory, formatCommandArgument, isValidProjectSetupName, projectCreateFailedError, projectSetupNameRequiredError, resolveProjectForSetup, toProjectSummary };
+export { bindProjectToDirectory, isValidProjectSetupName, projectCreateFailedError, projectSetupNameRequiredError, resolveProjectForSetup, toProjectSummary, validateProjectSetupNameText };

package/dist/presenters/project.js

@@ -1,8 +1,9 @@
-import { renderSummaryLine } from "../shell/ui.js";
+import { renderNextSteps, renderSummaryLine } from "../shell/ui.js";
+import { formatCommandArgument } from "../shell/command-arguments.js";
 import { renderList, renderMutate, renderShow, serializeList } from "../output/patterns.js";
 //#region src/presenters/project.ts
 function renderProjectList(context, descriptor, result) {
-	return renderList({
+	const lines = renderList({
 		title: "Listing projects for the authenticated workspace.",
 		descriptor,
 		parentContext: {
@@ -17,46 +18,40 @@ function renderProjectList(context, descriptor, result) {
 		})),
 		emptyMessage: "No projects found."
 	}, context.ui);
+	if (result.localBinding?.status === "not-linked" || result.localBinding?.status === "invalid") lines.push(...renderNextSteps(["Link an existing Project you choose: prisma-cli project link <id-or-name>", "Create a new Project: prisma-cli project create <name>"]));
+	return lines;
 }
 function serializeProjectList(result) {
-	return serializeList({
-		context: { workspace: result.workspace.name },
-		items: result.projects.map((project) => ({
-			noun: "project",
-			label: project.name,
-			id: project.id,
-			status: null
-		}))
-	});
+	return {
+		...serializeList({
+			context: { workspace: result.workspace.name },
+			items: result.projects.map((project) => ({
+				noun: "project",
+				label: project.name,
+				id: project.id,
+				status: null
+			}))
+		}),
+		localBinding: result.localBinding ?? null
+	};
 }
 function renderProjectShow(context, descriptor, result) {
-	if (result.project === null) return renderShow({
-		title: "No Project linked to this directory.",
-		descriptor,
-		fields: [
-			{
+	if (result.project === null) {
+		const lines = renderShow({
+			title: "This directory is not linked to a Prisma Project.",
+			descriptor,
+			fields: [{
 				key: "workspace",
 				value: result.workspace.name
-			},
-			{
+			}, {
 				key: "project",
-				value: "unbound",
+				value: "Not linked",
 				tone: "warning"
-			},
-			{
-				key: "suggested",
-				value: `${result.suggestedProjectName} (${formatSuggestionSource(result.suggestedProjectNameSource)})`
-			},
-			{
-				key: "match",
-				value: formatCandidateList(result.candidates)
-			},
-			{
-				key: "next",
-				value: result.recoveryCommands[0] ?? "prisma-cli project link <id-or-name>"
-			}
-		]
-	}, context.ui);
+			}]
+		}, context.ui);
+		lines.push(...renderNextSteps(["Link an existing Project you choose: prisma-cli project link <id-or-name>", `Create a new Project: prisma-cli project create ${formatCommandArgument(result.suggestedProjectName)}`]));
+		return lines;
+	}
 	return renderShow({
 		title: "Showing this directory's Project binding.",
 		descriptor,
@@ -149,16 +144,6 @@ function formatProjectSource(source) {
 		case "unbound": return "unbound";
 	}
 }
-function formatSuggestionSource(source) {
-	switch (source) {
-		case "package-name": return "package name";
-		case "directory-name": return "directory name";
-	}
-}
-function formatCandidateList(candidates) {
-	if (candidates.length === 0) return "none";
-	return candidates.map((project) => project.name).join(", ");
-}
 function formatGitConnectionDetail(status) {
 	switch (status) {
 		case "active": return "GitHub branch automation is active for this project.";

package/dist/shell/command-arguments.js

@@ -0,0 +1,6 @@
+//#region src/shell/command-arguments.ts
+function formatCommandArgument(value) {
+	return /^[A-Za-z0-9._/-]+$/.test(value) && !value.startsWith("-") ? value : `'${value.replace(/'/g, "'\\''")}'`;
+}
+//#endregion
+export { formatCommandArgument };

package/dist/shell/command-meta.js

@@ -115,8 +115,12 @@ const DESCRIPTORS = [
 			"project",
 			"link"
 		],
-		description: "Link this directory to an existing Project",
-		examples: ["prisma-cli project link proj_123", "prisma-cli project link \"Acme Dashboard\" --json"]
+		description: "Link this directory to a Project",
+		examples: [
+			"prisma-cli project link",
+			"prisma-cli project link proj_123",
+			"prisma-cli project link \"Acme Dashboard\" --json"
+		]
 	},
 	{
 		id: "git.connect",

package/dist/shell/command-runner.js

@@ -47,7 +47,8 @@ async function runStreamingCommand(runtime, commandName, options, handler) {
 			timestamp: (/* @__PURE__ */ new Date()).toISOString(),
 			result: null,
 			warnings: [],
-			nextSteps: []
+			nextSteps: [],
+			nextActions: []
 		});
 	} catch (error) {
 		const cliError = toCliError(error);
@@ -58,7 +59,8 @@ async function runStreamingCommand(runtime, commandName, options, handler) {
 				timestamp: (/* @__PURE__ */ new Date()).toISOString(),
 				error: cliErrorToJson(cliError),
 				warnings: [],
-				nextSteps: cliError.nextSteps
+				nextSteps: cliError.nextSteps,
+				nextActions: cliError.nextActions
 			});
 			else writeHumanError(context.output, context.ui, cliError, { trace: flags.trace });
 			process.exitCode = cliError.exitCode;

package/dist/shell/errors.js

@@ -12,6 +12,7 @@ var CliError = class extends Error {
 	docsUrl;
 	exitCode;
 	nextSteps;
+	nextActions;
 	humanLines;
 	constructor(options) {
 		super(options.summary);
@@ -28,6 +29,7 @@ var CliError = class extends Error {
 		this.docsUrl = options.docsUrl ?? null;
 		this.exitCode = options.exitCode ?? 1;
 		this.nextSteps = options.nextSteps ?? [];
+		this.nextActions = options.nextActions ?? [];
 		this.humanLines = options.humanLines && options.humanLines.length > 0 ? [...options.humanLines] : null;
 	}
 };

package/dist/shell/output.js

@@ -3,6 +3,7 @@ import { renderNextSteps, renderSummaryLine } from "./ui.js";
 function writeJsonSuccess(output, success) {
 	output.stdout.write(`${JSON.stringify({
 		ok: true,
+		nextActions: [],
 		...success
 	}, null, 2)}\n`);
 }
@@ -28,7 +29,8 @@ function writeJsonError(output, command, error) {
 		command,
 		error: cliErrorToJson(error),
 		warnings: [],
-		nextSteps: error.nextSteps
+		nextSteps: error.nextSteps,
+		nextActions: error.nextActions
 	}, null, 2)}\n`);
 }
 function writeHumanLines(output, lines) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prisma/cli",
-  "version": "3.0.0-dev.41.1",
+  "version": "3.0.0-dev.43.1",
   "description": "Command-line interface for the Prisma Developer Platform.",
   "type": "module",
   "bin": {