@prisma/cli 3.0.0-beta.17 → 3.0.0-beta.18

package/dist/lib/agent/setup-status.js

@@ -0,0 +1,83 @@
+import { PRISMA_SKILLS_LOCK_FILENAME } from "./constants.js";
+import path from "node:path";
+import { readFile, stat } from "node:fs/promises";
+import { findComputeConfigDir } from "@prisma/compute-sdk/config";
+//#region src/lib/agent/setup-status.ts
+async function readPrismaAgentSetupStatus(options) {
+	const setupCwd = await resolvePrismaAgentSetupCwd(options);
+	const skillsLockPath = path.join(setupCwd, PRISMA_SKILLS_LOCK_FILENAME);
+	const [skillsInstalled, promptDismissedAt] = await Promise.all([hasPrismaSkillsLock(skillsLockPath, options.signal, options.requiredSkill), options.stateStore?.readAgentSetupPromptDismissedAt() ?? null]);
+	return {
+		skillsLockPath: path.basename(skillsLockPath),
+		skillsInstalled,
+		promptDismissedAt
+	};
+}
+async function resolvePrismaAgentSetupCwd(options) {
+	options.signal.throwIfAborted();
+	const configDir = await findComputeConfigDir(options.cwd, options.signal);
+	options.signal.throwIfAborted();
+	return configDir ?? options.cwd;
+}
+function isPrismaAgentSetupComplete(status) {
+	return status.skillsInstalled;
+}
+function shouldOfferPrismaAgentSetup(status) {
+	return !isPrismaAgentSetupComplete(status) && !status.promptDismissedAt;
+}
+async function isLikelyProjectDirectory(options) {
+	return (await Promise.all([
+		"package.json",
+		"prisma.compute.ts",
+		"prisma.config.ts",
+		".git"
+	].map((fileName) => pathExists(path.join(options.cwd, fileName), options.signal)))).some(Boolean);
+}
+async function hasPrismaSkillsLock(filePath, signal, requiredSkill) {
+	try {
+		const raw = await readFile(filePath, {
+			encoding: "utf8",
+			signal
+		});
+		return hasPrismaSkillsLockEntry(JSON.parse(raw), requiredSkill);
+	} catch (error) {
+		if (isNotFoundError(error) || error instanceof SyntaxError) return false;
+		throw error;
+	}
+}
+function hasPrismaSkillsLockEntry(value, requiredSkill) {
+	if (!isRecord(value)) return false;
+	if (requiredSkill) return skillLockEntryUsesPrismaSource(readSkillLockEntries(value)[requiredSkill]);
+	if (readLegacySources(value).includes("prisma/skills")) return true;
+	return Object.values(readSkillLockEntries(value)).some(skillLockEntryUsesPrismaSource);
+}
+function readLegacySources(value) {
+	return Array.isArray(value.sources) ? value.sources.filter((source) => typeof source === "string") : [];
+}
+function readSkillLockEntries(value) {
+	return isRecord(value.skills) ? value.skills : {};
+}
+function skillLockEntryUsesPrismaSource(value) {
+	return isRecord(value) && value.source === "prisma/skills";
+}
+function isRecord(value) {
+	return typeof value === "object" && value !== null;
+}
+async function pathExists(filePath, signal) {
+	signal.throwIfAborted();
+	try {
+		await stat(filePath);
+		signal.throwIfAborted();
+		return true;
+	} catch (error) {
+		if (signal.aborted) throw error;
+		if (isNotFoundError(error)) return false;
+		throw error;
+	}
+}
+function isNotFoundError(error) {
+	const code = error.code;
+	return code === "ENOENT" || code === "ENOTDIR";
+}
+//#endregion
+export { isLikelyProjectDirectory, readPrismaAgentSetupStatus, resolvePrismaAgentSetupCwd, shouldOfferPrismaAgentSetup };

package/dist/lib/app/branch-database-deploy.js

@@ -1,8 +1,8 @@
+import { formatCommandArgument } from "../../shell/command-arguments.js";
 import { CliError, usageError } from "../../shell/errors.js";
-import { confirmPrompt } from "../../shell/prompt.js";
 import { renderSummaryLine } from "../../shell/ui.js";
 import { canPrompt } from "../../shell/runtime.js";
-import { formatCommandArgument } from "../../shell/command-arguments.js";
+import { confirmPrompt } from "../../shell/prompt.js";
 import "../project/setup.js";
 import { hasBranchDatabaseSignal, inspectBranchDatabaseSignal } from "./branch-database.js";
 import path from "node:path";
@@ -51,6 +51,7 @@ async function maybeSetupBranchDatabase(context, provider, projectId, branch, op
 		if (!await confirmPrompt({
 			input: context.runtime.stdin,
 			output: context.output.stderr,
+			signal: context.runtime.signal,
 			message: databasePromptMessage(branch),
 			initialValue: false
 		})) return emptyBranchDatabaseSetupOutcome();

package/dist/lib/app/branch-database.js

@@ -1,8 +1,9 @@
-import { access, readFile, readdir, stat } from "node:fs/promises";
 import path from "node:path";
+import { access, readFile, readdir, stat } from "node:fs/promises";
 //#region src/lib/app/branch-database.ts
 const SKIPPED_DIRECTORIES = new Set([
 	".git",
+	".agents",
 	".next",
 	".nuxt",
 	".output",

package/dist/lib/app/build-settings.js

@@ -1,5 +1,5 @@
-import { readFile } from "node:fs/promises";
 import path from "node:path";
+import { readFile } from "node:fs/promises";
 import { resolveBuildSettings, resolveConfiguredBuildSettings } from "@prisma/compute-sdk";
 //#region src/lib/app/build-settings.ts
 /** Legacy build-settings file: no longer read or written, only detected for migration. */

package/dist/lib/app/build.js

@@ -1,7 +1,7 @@
 import "./build-settings.js";
-import { FRAMEWORKS } from "@prisma/compute-sdk/config";
-import "node:fs/promises";
 import "node:path";
+import "node:fs/promises";
+import { FRAMEWORKS } from "@prisma/compute-sdk/config";
 import { normalizeArtifactSymlinks, resolveBuildStrategy } from "@prisma/compute-sdk";
 //#region src/lib/app/build.ts
 const RESOLVED_APP_BUILD_TYPES = [...frameworkBuildTypesByLastOccurrence()];

package/dist/lib/app/bun-project.js

@@ -1,5 +1,5 @@
-import { access, readFile } from "node:fs/promises";
 import path from "node:path";
+import { access, readFile } from "node:fs/promises";
 //#region src/lib/app/bun-project.ts
 async function readBunPackageJson(appPath, signal) {
 	const packageJsonPath = path.join(appPath, "package.json");

package/dist/lib/app/compute-config.js

@@ -1,6 +1,6 @@
 import { CliError } from "../../shell/errors.js";
-import { COMPUTE_CONFIG_FILENAME, COMPUTE_CONFIG_FILENAME as COMPUTE_CONFIG_FILENAME$1, ComputeConfigTargetRequiredError, computeTargetAppDir, frameworkByKey, inferComputeTargetFromCwd, loadComputeConfig, selectComputeDeployTarget } from "@prisma/compute-sdk/config";
 import path from "node:path";
+import { COMPUTE_CONFIG_FILENAME, COMPUTE_CONFIG_FILENAME as COMPUTE_CONFIG_FILENAME$1, ComputeConfigTargetRequiredError, computeTargetAppDir, frameworkByKey, inferComputeTargetFromCwd, loadComputeConfig, selectComputeDeployTarget } from "@prisma/compute-sdk/config";
 import { matchError } from "better-result";
 //#region src/lib/app/compute-config.ts
 /**
@@ -18,47 +18,45 @@ function computeFrameworkToBuildType(framework) {
 function mergeComputeDeployInputs(options) {
 	const { cli, target, configFilename } = options;
 	const configAnnotation = `set by ${configFilename}`;
-	const framework = cli.framework ? {
-		value: cli.framework,
-		annotation: "set by --framework"
-	} : target?.framework ? {
-		value: target.framework,
-		annotation: configAnnotation
-	} : void 0;
-	const entrypoint = cli.entrypoint ? {
-		value: cli.entrypoint,
-		annotation: "set by --entry"
-	} : target?.entry ? {
-		value: target.entry,
-		annotation: configAnnotation
-	} : void 0;
-	const httpPort = cli.httpPort ? {
-		value: cli.httpPort,
-		annotation: "set by --http-port"
-	} : target?.httpPort ? {
-		value: String(target.httpPort),
-		annotation: configAnnotation
-	} : void 0;
+	const framework = mergeStringInput(cli.framework, "set by --framework", target?.framework ?? void 0, configAnnotation);
+	const entrypoint = mergeStringInput(cli.entrypoint, "set by --entry", target?.entry ?? void 0, configAnnotation);
+	const httpPort = mergeStringInput(cli.httpPort, "set by --http-port", target?.httpPort ? String(target.httpPort) : void 0, configAnnotation);
+	const region = mergeStringInput(cli.region, "set by --region", target?.region ?? void 0, configAnnotation);
 	const cliEnvInputs = cli.envInputs && cli.envInputs.length > 0 ? cli.envInputs : void 0;
 	const configEnvInputs = target && target.envInputs.length > 0 ? target.envInputs : void 0;
 	const envInputs = cliEnvInputs ?? configEnvInputs;
-	const configAppName = target?.name ? {
-		value: target.name,
-		annotation: configAnnotation
-	} : target?.key ? {
-		value: target.key,
-		annotation: configAnnotation
-	} : void 0;
+	const configAppName = readConfigAppName(target, configAnnotation);
 	return {
 		framework,
 		entrypoint,
 		httpPort,
+		region,
 		envInputs,
 		envInputsFromConfig: !cliEnvInputs && configEnvInputs !== void 0,
 		configAppName,
 		appRoot: target?.root ?? void 0
 	};
 }
+function mergeStringInput(cliValue, cliAnnotation, configValue, configAnnotation) {
+	if (cliValue !== void 0) return {
+		value: cliValue,
+		annotation: cliAnnotation
+	};
+	if (configValue) return {
+		value: configValue,
+		annotation: configAnnotation
+	};
+}
+function readConfigAppName(target, configAnnotation) {
+	if (target?.name) return {
+		value: target.name,
+		annotation: configAnnotation
+	};
+	if (target?.key) return {
+		value: target.key,
+		annotation: configAnnotation
+	};
+}
 /**
 * Merges CLI inputs for the local `app build` and `app run` commands with a
 * selected config target. Explicit flags win; `--build-type auto` is the

package/dist/lib/app/deploy-plan.js

@@ -30,6 +30,7 @@ function perAppInputsForDeployAll(inputs) {
 		["--framework", inputs.framework],
 		["--entry", inputs.entrypoint],
 		["--http-port", inputs.httpPort],
+		["--region", inputs.region],
 		["--env", inputs.envAssignments?.length ? inputs.envAssignments : void 0],
 		[inputs.appIdEnvVar.name, inputs.appIdEnvVar.value]
 	].filter(([, value]) => value !== void 0).map(([flag]) => flag);

package/dist/lib/app/env-file.js

@@ -1,7 +1,7 @@
 import { usageError } from "../../shell/errors.js";
 import { validateKey } from "./env-config.js";
-import { readFile } from "node:fs/promises";
 import path from "node:path";
+import { readFile } from "node:fs/promises";
 import { parse } from "dotenv";
 //#region src/lib/app/env-file.ts
 const ASSIGNMENT_KEY_PATTERN = /^\s*(?:export\s+)?([^#=\s]+)\s*=/;

package/dist/lib/app/local-dev.js

@@ -1,6 +1,6 @@
 import { resolveBunEntrypoint } from "./bun-project.js";
-import "node:fs/promises";
 import path from "node:path";
+import "node:fs/promises";
 import { spawn } from "node:child_process";
 //#region src/lib/app/local-dev.ts
 const DEFAULT_LOCAL_DEV_PORT = 3e3;

package/dist/lib/app/production-deploy-gate.js

@@ -1,6 +1,6 @@
 import { CliError } from "../../shell/errors.js";
-import { confirmPrompt } from "../../shell/prompt.js";
 import { canPrompt } from "../../shell/runtime.js";
+import { confirmPrompt } from "../../shell/prompt.js";
 //#region src/lib/app/production-deploy-gate.ts
 async function enforceProductionDeployGate(context, provider, options) {
 	if (options.branchKind !== "production") return { firstProductionDeploy: false };
@@ -25,6 +25,7 @@ async function enforceProductionDeployGate(context, provider, options) {
 	if (!await confirmPrompt({
 		input: context.runtime.stdin,
 		output: context.output.stderr,
+		signal: context.runtime.signal,
 		message: "Deploy to production?",
 		initialValue: false
 	})) throw productionDeployCancelledError();

package/dist/lib/auth/login.js

@@ -1,7 +1,7 @@
 import { getApiBaseUrl } from "./client.js";
 import { FileTokenStorage } from "../../adapters/token-storage.js";
-import open from "open";
 import { AuthError, createManagementApiSdk } from "@prisma/management-api-sdk";
+import open from "open";
 import events from "node:events";
 import http from "node:http";
 import readline from "node:readline/promises";

package/dist/lib/git/local-branch.js

@@ -1,5 +1,5 @@
-import { access, readFile } from "node:fs/promises";
 import path from "node:path";
+import { access, readFile } from "node:fs/promises";
 //#region src/lib/git/local-branch.ts
 /**
 * Resolves the checked-out branch the way git does: the nearest `.git`

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

@@ -40,6 +40,7 @@ async function promptForProjectSetupChoice(options) {
 	const rawName = await textPrompt({
 		input: options.context.runtime.stdin,
 		output: options.context.runtime.stderr,
+		signal: options.context.runtime.signal,
 		message: "Project name",
 		placeholder: suggestedName.name,
 		validate: (value) => validateProjectSetupNameText(value, suggestedName.name)

package/dist/lib/project/local-pin.js

@@ -1,5 +1,5 @@
-import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
 import path from "node:path";
+import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
 import { Result, TaggedError, UnhandledException } from "better-result";
 //#region src/lib/project/local-pin.ts
 const LOCAL_RESOLUTION_PIN_RELATIVE_PATH = ".prisma/local.json";

package/dist/lib/project/resolution.js

@@ -1,8 +1,8 @@
+import { formatCommandArgument } from "../../shell/command-arguments.js";
 import { CliError } from "../../shell/errors.js";
 import { LOCAL_RESOLUTION_PIN_RELATIVE_PATH, readLocalResolutionPin } from "./local-pin.js";
-import { formatCommandArgument } from "../../shell/command-arguments.js";
-import { readFile } from "node:fs/promises";
 import path from "node:path";
+import { readFile } from "node:fs/promises";
 import { Result, TaggedError, matchError } from "better-result";
 //#region src/lib/project/resolution.ts
 var ProjectNotFoundError = class extends TaggedError("ProjectNotFoundError")() {

package/dist/lib/project/setup.js

@@ -1,7 +1,7 @@
+import "../../shell/command-arguments.js";
 import { CliError, usageError } from "../../shell/errors.js";
 import { shortenHomePath } from "../fs/home-path.js";
 import { LOCAL_RESOLUTION_PIN_RELATIVE_PATH, ensureLocalResolutionPinGitignore, writeLocalResolutionPin } from "./local-pin.js";
-import "../../shell/command-arguments.js";
 import { projectAmbiguousError, projectNotFoundError } from "./resolution.js";
 import path from "node:path";
 import { Result, matchError } from "better-result";

package/dist/presenters/agent.js

@@ -0,0 +1,74 @@
+import { formatShellCommand } from "../shell/command-arguments.js";
+import { formatDescriptorLabel } from "../shell/command-meta.js";
+import { renderSummaryLine } from "../shell/ui.js";
+//#region src/presenters/agent.ts
+function renderAgentInstall(context, descriptor, result) {
+	const ui = context.ui;
+	const rail = ui.dim("│");
+	return [
+		renderSummaryLine(ui, "success", `${formatDescriptorLabel(descriptor)} → ${operationSummary(result)} Prisma skills.`),
+		"",
+		`${rail}  ${ui.accent("skills:")}  ${result.skills.status.replace("-", " ")}`,
+		`${rail}  ${ui.dim(formatShellCommand(result.skills.command))}`
+	];
+}
+function renderAgentStatus(context, descriptor, result) {
+	const ui = context.ui;
+	const rail = ui.dim("│");
+	return [
+		`${ui.strong(formatDescriptorLabel(descriptor))} ${ui.dim("→")} ${ui.dim(`Checking ${result.statusScope} Prisma skills.`)}`,
+		"",
+		`${rail}  ${ui.accent("skills:")}  ${result.skillsInstalled ? "installed" : "not found"}`,
+		...renderInstalledSkills(context, result.skills),
+		`${rail}`,
+		`${rail}  ${ui.accent("source:")}  ${formatStatusSource(result)}`,
+		`${rail}  ${ui.dim(formatShellCommand(result.skillsListCommand))}`,
+		...renderProjectStatusDetails(context, result)
+	];
+}
+function serializeAgentInstall(result) {
+	return result;
+}
+function serializeAgentStatus(result) {
+	return result;
+}
+function formatSetupPromptStatus(result) {
+	if (result.skillsInstalled) return "not needed";
+	if (result.promptDismissedAt) return `dismissed ${result.promptDismissedAt}`;
+	return "active";
+}
+function formatStatusSource(result) {
+	if (result.statusSource === "skills-cli") return result.statusScope === "global" ? "skills list -g --json" : "skills list --json";
+	if (result.statusSource === "skills-lock") return result.skillsLockPath;
+	return "unavailable";
+}
+function renderProjectStatusDetails(context, result) {
+	if (result.statusScope !== "project") return [];
+	const ui = context.ui;
+	const rail = ui.dim("│");
+	return [
+		`${rail}`,
+		`${rail}  ${ui.accent("skills lock:")}  ${result.skillsLockInstalled ? "installed" : "not found"}`,
+		`${rail}  ${ui.dim(result.skillsLockPath)}`,
+		`${rail}`,
+		`${rail}  ${ui.accent("setup prompt:")}  ${formatSetupPromptStatus(result)}`
+	];
+}
+function renderInstalledSkills(context, skills) {
+	const ui = context.ui;
+	const rail = ui.dim("│");
+	if (skills.length === 0) return [`${rail}    ${ui.dim("No Prisma skills reported.")}`];
+	return skills.map((skill) => {
+		const agents = skill.agents.length > 0 ? skill.agents.join(", ") : "no agents reported";
+		return `${rail}    ${skill.name}  ${ui.dim(`${skill.scope}; ${agents}`)}`;
+	});
+}
+function operationSummary(result) {
+	if (result.skills.status === "would-install") return "Would install";
+	return operationLabel(result.operation);
+}
+function operationLabel(operation) {
+	return operation === "update" ? "Updated" : "Installed";
+}
+//#endregion
+export { renderAgentInstall, renderAgentStatus, serializeAgentInstall, serializeAgentStatus };

package/dist/presenters/auth.js

@@ -25,7 +25,7 @@ function renderAuthSuccess(context, descriptor, command, result) {
 			context: rows,
 			operationDescription: "Applying authentication session changes",
 			operationCount: 1,
-			details: ["Session stored in local CLI state."]
+			details: ["Session stored in local CLI state.", ...result.agentSetupTip ? [`Install Prisma skills for this project with ${result.agentSetupTip.command}.`] : []]
 		}, context.ui);
 	}
 	if (command === "auth.logout") return renderMutate({

package/dist/presenters/project.js

@@ -1,7 +1,7 @@
+import { formatCommandArgument } from "../shell/command-arguments.js";
 import { formatDescriptorLabel } from "../shell/command-meta.js";
 import { padDisplay, renderNextSteps, renderSummaryLine, renderVerboseBlock } from "../shell/ui.js";
 import { shortenHomePath } from "../lib/fs/home-path.js";
-import { formatCommandArgument } from "../shell/command-arguments.js";
 import { renderMutate, renderShow, serializeList } from "../output/patterns.js";
 import { renderResolvedProjectContextBlock } from "./verbose-context.js";
 import stringWidth from "string-width";

package/dist/shell/cli-command.js

@@ -0,0 +1,12 @@
+const PRISMA_CLI_PACKAGE_SPEC = `@prisma/cli@latest`;
+const DEFAULT_PRISMA_CLI_PACKAGE_RUNNER = ["npx", "-y"];
+const PRISMA_CLI_BINARY = "prisma-cli";
+function formatPrismaCliCommand(args, options = {}) {
+	return [...getPrismaCliCommandPrefix(options), ...args].join(" ");
+}
+function getPrismaCliCommandPrefix({ invocation = "package", packageRunner = DEFAULT_PRISMA_CLI_PACKAGE_RUNNER }) {
+	if (invocation === "binary") return [PRISMA_CLI_BINARY];
+	return [...packageRunner, PRISMA_CLI_PACKAGE_SPEC];
+}
+//#endregion
+export { formatPrismaCliCommand };

package/dist/shell/command-arguments.js

@@ -2,5 +2,11 @@
 function formatCommandArgument(value) {
 	return /^[A-Za-z0-9._/-]+$/.test(value) && !value.startsWith("-") ? value : `'${value.replace(/'/g, "'\\''")}'`;
 }
+function formatShellCommand(command) {
+	return command.map(formatShellCommandWord).join(" ");
+}
+function formatShellCommandWord(value) {
+	return /^[A-Za-z0-9_./:@=-]+$/.test(value) ? value : `'${value.replace(/'/g, "'\\''")}'`;
+}
 //#endregion
-export { formatCommandArgument };
+export { formatCommandArgument, formatShellCommand };

package/dist/shell/command-meta.js

@@ -1,5 +1,11 @@
+import { resolvePrismaCliPackageCommandFormatterSync } from "../lib/agent/cli-command.js";
+import { PRISMA_AGENT_INSTALL_ARGS, PRISMA_AGENT_STATUS_ARGS, PRISMA_AGENT_UPDATE_ARGS, PRISMA_COMPUTE_AGENT_SKILL } from "../lib/agent/constants.js";
 //#region src/shell/command-meta.ts
 const COMMAND_DESCRIPTOR_ID = Symbol("prisma.commandDescriptorId");
+function agentCommandExamples(runtime, commands) {
+	const formatCommand = resolvePrismaCliPackageCommandFormatterSync(runtime.cwd);
+	return commands.map((command) => formatCommand(command));
+}
 const DESCRIPTORS = [
 	{
 		id: "root",
@@ -14,6 +20,71 @@ const DESCRIPTORS = [
 		description: "Show CLI build and environment",
 		examples: ["prisma-cli version", "prisma-cli version --json"]
 	},
+	{
+		id: "agent",
+		path: ["prisma", "agent"],
+		description: "Install Prisma context for AI coding agents",
+		examples: (runtime) => agentCommandExamples(runtime, [
+			PRISMA_AGENT_INSTALL_ARGS,
+			PRISMA_AGENT_UPDATE_ARGS,
+			PRISMA_AGENT_STATUS_ARGS
+		])
+	},
+	{
+		id: "agent.install",
+		path: [
+			"prisma",
+			"agent",
+			"install"
+		],
+		description: "Install Prisma skills for AI coding agents",
+		examples: (runtime) => agentCommandExamples(runtime, [
+			PRISMA_AGENT_INSTALL_ARGS,
+			[
+				...PRISMA_AGENT_INSTALL_ARGS,
+				"--agent",
+				"codex"
+			],
+			[...PRISMA_AGENT_INSTALL_ARGS, "--all-agents"],
+			[
+				...PRISMA_AGENT_INSTALL_ARGS,
+				"--skill",
+				PRISMA_COMPUTE_AGENT_SKILL
+			]
+		])
+	},
+	{
+		id: "agent.update",
+		path: [
+			"prisma",
+			"agent",
+			"update"
+		],
+		description: "Refresh Prisma skills for AI coding agents",
+		examples: (runtime) => agentCommandExamples(runtime, [
+			PRISMA_AGENT_UPDATE_ARGS,
+			[
+				...PRISMA_AGENT_UPDATE_ARGS,
+				"--agent",
+				"codex"
+			],
+			[...PRISMA_AGENT_UPDATE_ARGS, "--all-agents"]
+		])
+	},
+	{
+		id: "agent.status",
+		path: [
+			"prisma",
+			"agent",
+			"status"
+		],
+		description: "Show installed Prisma skills",
+		examples: (runtime) => agentCommandExamples(runtime, [
+			PRISMA_AGENT_STATUS_ARGS,
+			[...PRISMA_AGENT_STATUS_ARGS, "--json"],
+			[...PRISMA_AGENT_STATUS_ARGS, "--global"]
+		])
+	},
 	{
 		id: "auth",
 		path: ["prisma", "auth"],
@@ -350,6 +421,7 @@ const DESCRIPTORS = [
 			"prisma-cli app deploy --db",
 			"prisma-cli app deploy --db --yes",
 			"prisma-cli app deploy --app my-app --framework nextjs --http-port 3000",
+			"prisma-cli app deploy --app my-app --region us-west-1",
 			"prisma-cli app deploy --branch feat-login --framework hono",
 			"prisma-cli app deploy --prod --yes",
 			"prisma-cli app deploy --framework bun --entry src/server.ts"

package/dist/shell/command-runner.js

@@ -2,9 +2,9 @@ import { CliError, authConfigInvalidError, authRequiredError, commandCanceledErr
 import { getCommandDescriptor } from "./command-meta.js";
 import { resolveGlobalFlags } from "./global-flags.js";
 import { createCommandContext } from "./runtime.js";
-import { cliErrorToJson, writeHumanError, writeHumanLines, writeJsonError, writeJsonEvent, writeJsonSuccess } from "./output.js";
 import { collectCommandDiagnostics } from "../lib/diagnostics.js";
 import { renderCommandDiagnostics } from "./diagnostics-output.js";
+import { cliErrorToJson, writeHumanError, writeHumanLines, writeJsonError, writeJsonEvent, writeJsonSuccess } from "./output.js";
 import { AuthError } from "@prisma/management-api-sdk";
 //#region src/shell/command-runner.ts
 function toCliError(error, runtime) {

package/dist/shell/help.js

@@ -1,6 +1,6 @@
 import { formatDescriptorLabel, getDescriptorForCommand } from "./command-meta.js";
-import { COMPACT_GLOBAL_OPTION_FLAGS, resolveGlobalFlags } from "./global-flags.js";
 import { createShellUi, padDisplay, wrapText } from "./ui.js";
+import { COMPACT_GLOBAL_OPTION_FLAGS, resolveGlobalFlags } from "./global-flags.js";
 //#region src/shell/help.ts
 function renderHelp(command, runtime) {
 	const descriptor = getDescriptorForCommand(command);
@@ -12,7 +12,7 @@ function renderHelp(command, runtime) {
 	if (visibleCommands.length > 0) lines.push(...renderCommandRows(rail, ui, visibleCommands));
 	lines.push(...renderLongDescription(rail, ui, descriptor.longDescription));
 	lines.push(...renderVisibleOptions(rail, ui, visibleCommands, visibleOptions));
-	lines.push(...renderExamples(rail, descriptor.examples));
+	lines.push(...renderExamples(rail, runtime, descriptor.examples));
 	lines.push(...renderDocsPath(rail, ui, descriptor.docsPath));
 	lines.push("");
 	return `${lines.join("\n")}`;
@@ -30,12 +30,13 @@ function renderVisibleOptions(rail, ui, visibleCommands, visibleOptions) {
 function shouldLabelGlobalOptions(visibleCommands, visibleOptions) {
 	return visibleCommands.length > 0 && visibleOptions.every((option) => COMPACT_GLOBAL_OPTION_FLAGS.includes(option.flags));
 }
-function renderExamples(rail, examples) {
-	if (!examples || examples.length === 0) return [];
+function renderExamples(rail, runtime, examples) {
+	const resolvedExamples = typeof examples === "function" ? examples(runtime) : examples;
+	if (!resolvedExamples || resolvedExamples.length === 0) return [];
 	return [
 		`${rail}`,
 		`${rail}  Examples:`,
-		...examples.map((example) => `${rail}    $ ${example}`)
+		...resolvedExamples.map((example) => `${rail}    $ ${example}`)
 	];
 }
 function renderDocsPath(rail, ui, docsPath) {

package/dist/shell/prompt.js

@@ -1,6 +1,7 @@
 import { usageError } from "./errors.js";
 import { confirm, isCancel, select, text } from "@clack/prompts";
 //#region src/shell/prompt.ts
+const PROMPT_CANCELED_SUMMARY = "Interactive prompt canceled";
 async function selectPrompt(options) {
 	const promptOptions = options.choices.map((choice) => ({
 		label: choice.label,
@@ -9,31 +10,34 @@ async function selectPrompt(options) {
 	const response = await select({
 		input: options.input,
 		output: options.output,
+		signal: options.signal,
 		message: options.message,
 		options: promptOptions
 	});
-	if (isCancel(response)) throw usageError("Interactive prompt canceled", "The command was canceled before a selection was made.", "Re-run the command and choose an option to continue.");
+	if (isCancel(response)) throw usageError(PROMPT_CANCELED_SUMMARY, "The command was canceled before a selection was made.", "Re-run the command and choose an option to continue.");
 	return response;
 }
 async function textPrompt(options) {
 	const response = await text({
 		input: options.input,
 		output: options.output,
+		signal: options.signal,
 		message: options.message,
 		placeholder: options.placeholder,
 		validate: options.validate
 	});
-	if (isCancel(response)) throw usageError("Interactive prompt canceled", "The command was canceled before a value was entered.", "Re-run the command and provide a value to continue.");
+	if (isCancel(response)) throw usageError(PROMPT_CANCELED_SUMMARY, "The command was canceled before a value was entered.", "Re-run the command and provide a value to continue.");
 	return response;
 }
 async function confirmPrompt(options) {
 	const response = await confirm({
 		input: options.input,
 		output: options.output,
+		signal: options.signal,
 		message: options.message,
 		initialValue: options.initialValue ?? false
 	});
-	if (isCancel(response)) throw usageError("Interactive prompt canceled", "The command was canceled before a confirmation was made.", "Re-run the command and choose an option to continue.");
+	if (isCancel(response)) throw usageError(PROMPT_CANCELED_SUMMARY, "The command was canceled before a confirmation was made.", "Re-run the command and choose an option to continue.");
 	return response;
 }
 function disposePromptState(_input) {}

package/dist/shell/runtime.js

@@ -1,9 +1,9 @@
+import { createShellUi } from "./ui.js";
 import { LocalStateStore } from "../adapters/local-state.js";
 import { MockApi } from "../adapters/mock-api.js";
-import { createShellUi } from "./ui.js";
 import { renderHelp } from "./help.js";
-import { findComputeConfigDir } from "@prisma/compute-sdk/config";
 import path from "node:path";
+import { findComputeConfigDir } from "@prisma/compute-sdk/config";
 //#region src/shell/runtime.ts
 const DEFAULT_STATE_DIR_NAME = path.join(".prisma", "cli");
 function configureRuntimeCommand(command, runtime) {