@prisma/cli 3.0.0-beta.3 → 3.0.0-beta.30

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,99 @@ const DESCRIPTORS = [
 		description: "Show CLI build and environment",
 		examples: ["prisma-cli version", "prisma-cli version --json"]
 	},
+	{
+		id: "feedback",
+		path: ["prisma", "feedback"],
+		description: "Send feedback to the Prisma CLI team",
+		longDescription: "Anonymous unless --email is passed. Every submission includes the CLI version, node version, and OS platform/arch, and nothing else.",
+		examples: ["prisma-cli feedback \"the deploy flow is great\"", "prisma-cli feedback \"please add X\" --email you@example.com"]
+	},
+	{
+		id: "init",
+		path: ["prisma", "init"],
+		description: "Write a committed compute config for this app",
+		examples: (runtime) => agentCommandExamples(runtime, [
+			["init"],
+			[
+				"init",
+				"--framework",
+				"hono",
+				"--entry",
+				"src/index.ts"
+			],
+			[
+				"init",
+				"--format",
+				"json"
+			],
+			["init", "--no-link"]
+		])
+	},
+	{
+		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"],
@@ -50,6 +149,58 @@ const DESCRIPTORS = [
 		description: "Show the authenticated user and accessible workspace",
 		examples: ["prisma-cli auth whoami", "prisma-cli auth whoami --json"]
 	},
+	{
+		id: "auth.workspace",
+		path: [
+			"prisma",
+			"auth",
+			"workspace"
+		],
+		description: "Manage local authenticated workspaces",
+		examples: [
+			"prisma-cli auth workspace list",
+			"prisma-cli auth workspace use",
+			"prisma-cli auth workspace use wksp_123",
+			"prisma-cli auth workspace logout wksp_123"
+		]
+	},
+	{
+		id: "auth.workspace.list",
+		path: [
+			"prisma",
+			"auth",
+			"workspace",
+			"list"
+		],
+		description: "List locally authenticated workspaces",
+		examples: ["prisma-cli auth workspace list", "prisma-cli auth workspace list --json"]
+	},
+	{
+		id: "auth.workspace.use",
+		path: [
+			"prisma",
+			"auth",
+			"workspace",
+			"use"
+		],
+		description: "Switch the local CLI workspace",
+		examples: [
+			"prisma-cli auth workspace use",
+			"prisma-cli auth workspace use wksp_123",
+			"prisma-cli auth workspace use \"Acme Inc\""
+		]
+	},
+	{
+		id: "auth.workspace.logout",
+		path: [
+			"prisma",
+			"auth",
+			"workspace",
+			"logout"
+		],
+		description: "Remove one local OAuth workspace session",
+		examples: ["prisma-cli auth workspace logout wksp_123", "prisma-cli auth workspace logout \"Acme Inc\""]
+	},
 	{
 		id: "project",
 		path: ["prisma", "project"],
@@ -69,8 +220,133 @@ const DESCRIPTORS = [
 	{
 		id: "branch",
 		path: ["prisma", "branch"],
-		description: "View your active Platform branches",
-		examples: ["prisma-cli branch list", "prisma-cli branch show"]
+		description: "View your Platform branches",
+		examples: ["prisma-cli branch list"]
+	},
+	{
+		id: "build",
+		path: ["prisma", "build"],
+		description: "Inspect builds",
+		examples: ["prisma-cli build logs <build_id>"]
+	},
+	{
+		id: "build.logs",
+		path: [
+			"prisma",
+			"build",
+			"logs"
+		],
+		description: "Stream the logs for a build",
+		examples: ["prisma-cli build logs <build_id>", "prisma-cli build logs <build_id> --follow"]
+	},
+	{
+		id: "database",
+		path: ["prisma", "database"],
+		description: "Manage Prisma Postgres databases for a project",
+		examples: [
+			"prisma-cli database list",
+			"prisma-cli database create my-db",
+			"prisma-cli database connection create db_123"
+		]
+	},
+	{
+		id: "bucket",
+		path: ["prisma", "bucket"],
+		description: "Manage object-store buckets for a project",
+		examples: [
+			"prisma-cli bucket list",
+			"prisma-cli bucket create",
+			"prisma-cli bucket key create bkt_123"
+		]
+	},
+	{
+		id: "bucket.list",
+		path: [
+			"prisma",
+			"bucket",
+			"list"
+		],
+		description: "List object-store buckets for the resolved project",
+		examples: [
+			"prisma-cli bucket list",
+			"prisma-cli bucket list --branch preview",
+			"prisma-cli bucket list --json"
+		]
+	},
+	{
+		id: "bucket.create",
+		path: [
+			"prisma",
+			"bucket",
+			"create"
+		],
+		description: "Create an object-store bucket",
+		examples: [
+			"prisma-cli bucket create",
+			"prisma-cli bucket create --name my-store",
+			"prisma-cli bucket create --branch preview --json"
+		]
+	},
+	{
+		id: "bucket.delete",
+		path: [
+			"prisma",
+			"bucket",
+			"delete"
+		],
+		description: "Delete a bucket and all its access keys",
+		examples: ["prisma-cli bucket delete bkt_123"]
+	},
+	{
+		id: "bucket.key",
+		path: [
+			"prisma",
+			"bucket",
+			"key"
+		],
+		description: "Manage access keys for an object-store bucket",
+		examples: [
+			"prisma-cli bucket key list bkt_123",
+			"prisma-cli bucket key create bkt_123",
+			"prisma-cli bucket key delete bkt_123 bkey_456"
+		]
+	},
+	{
+		id: "bucket.key.list",
+		path: [
+			"prisma",
+			"bucket",
+			"key",
+			"list"
+		],
+		description: "List access keys for a bucket",
+		examples: ["prisma-cli bucket key list bkt_123", "prisma-cli bucket key list bkt_123 --json"]
+	},
+	{
+		id: "bucket.key.create",
+		path: [
+			"prisma",
+			"bucket",
+			"key",
+			"create"
+		],
+		description: "Create a bucket access key and print its one-time credentials",
+		examples: [
+			"prisma-cli bucket key create bkt_123",
+			"prisma-cli bucket key create bkt_123 --role read",
+			"prisma-cli bucket key create bkt_123 --name ci-key --role read_write"
+		]
+	},
+	{
+		id: "bucket.key.delete",
+		path: [
+			"prisma",
+			"bucket",
+			"key",
+			"delete"
+		],
+		description: "Revoke and delete a bucket access key",
+		examples: ["prisma-cli bucket key delete bkt_123 bkey_456"]
 	},
 	{
 		id: "git",
@@ -122,6 +398,36 @@ const DESCRIPTORS = [
 			"prisma-cli project link \"Acme Dashboard\" --json"
 		]
 	},
+	{
+		id: "project.rename",
+		path: [
+			"prisma",
+			"project",
+			"rename"
+		],
+		description: "Rename the resolved Project",
+		examples: ["prisma-cli project rename \"Acme Dashboard v2\"", "prisma-cli project rename billing-api --project proj_123"]
+	},
+	{
+		id: "project.remove",
+		path: [
+			"prisma",
+			"project",
+			"remove"
+		],
+		description: "Remove a Project permanently after exact id confirmation",
+		examples: ["prisma-cli project remove proj_123 --confirm proj_123"]
+	},
+	{
+		id: "project.transfer",
+		path: [
+			"prisma",
+			"project",
+			"transfer"
+		],
+		description: "Transfer a Project to another workspace after exact id confirmation",
+		examples: ["prisma-cli project transfer proj_123 --to-workspace \"Prisma Labs\" --confirm proj_123", "prisma-cli project transfer proj_123 --recipient-token <token> --confirm proj_123"]
+	},
 	{
 		id: "git.connect",
 		path: [
@@ -153,28 +459,151 @@ const DESCRIPTORS = [
 			"branch",
 			"list"
 		],
-		description: "List active Platform branches for the resolved project",
+		description: "List Platform branches for the resolved project",
 		examples: ["prisma-cli branch list", "prisma-cli branch list --json"]
 	},
 	{
-		id: "branch.show",
+		id: "database.list",
 		path: [
 			"prisma",
-			"branch",
+			"database",
+			"list"
+		],
+		description: "List Prisma Postgres databases for the resolved project",
+		examples: [
+			"prisma-cli database list",
+			"prisma-cli database list --branch feature/foo",
+			"prisma-cli database list --json"
+		]
+	},
+	{
+		id: "database.show",
+		path: [
+			"prisma",
+			"database",
 			"show"
 		],
-		description: "Show the Platform branch matching your current Git branch",
-		examples: ["prisma-cli branch show", "prisma-cli branch show --json"]
+		description: "Show database metadata without secret values",
+		examples: ["prisma-cli database show db_123", "prisma-cli database show acme-preview --branch preview --json"]
 	},
 	{
-		id: "branch.use",
+		id: "database.create",
 		path: [
 			"prisma",
-			"branch",
-			"use"
+			"database",
+			"create"
 		],
-		description: "Change the local default branch context.",
-		examples: ["prisma-cli branch use", "prisma-cli branch use production"]
+		description: "Create a Prisma Postgres database and print its one-time connection URL",
+		examples: ["prisma-cli database create my-db", "prisma-cli database create my-db --branch feature/foo --region eu-central-1"]
+	},
+	{
+		id: "database.usage",
+		path: [
+			"prisma",
+			"database",
+			"usage"
+		],
+		description: "Show usage metrics for a database",
+		examples: ["prisma-cli database usage db_123", "prisma-cli database usage acme-production --from 2026-06-01 --to 2026-06-30"]
+	},
+	{
+		id: "database.restore",
+		path: [
+			"prisma",
+			"database",
+			"restore"
+		],
+		description: "Restore a database from a backup after exact id confirmation",
+		examples: ["prisma-cli database restore db_123 --backup bkp_456 --confirm db_123"]
+	},
+	{
+		id: "database.remove",
+		path: [
+			"prisma",
+			"database",
+			"remove"
+		],
+		description: "Remove a database after exact id confirmation",
+		examples: ["prisma-cli database remove db_123 --confirm db_123"]
+	},
+	{
+		id: "database.backup",
+		path: [
+			"prisma",
+			"database",
+			"backup"
+		],
+		description: "Inspect platform-created database backups",
+		examples: ["prisma-cli database backup list db_123"]
+	},
+	{
+		id: "database.backup.list",
+		path: [
+			"prisma",
+			"database",
+			"backup",
+			"list"
+		],
+		description: "List backups for a database",
+		examples: ["prisma-cli database backup list db_123", "prisma-cli database backup list acme-production --limit 50"]
+	},
+	{
+		id: "database.connection",
+		path: [
+			"prisma",
+			"database",
+			"connection"
+		],
+		description: "Manage one-time-view database connection strings",
+		examples: [
+			"prisma-cli database connection list db_123",
+			"prisma-cli database connection create db_123",
+			"prisma-cli database connection remove conn_123 --confirm conn_123"
+		]
+	},
+	{
+		id: "database.connection.list",
+		path: [
+			"prisma",
+			"database",
+			"connection",
+			"list"
+		],
+		description: "List database connection metadata without secret values",
+		examples: ["prisma-cli database connection list db_123", "prisma-cli database connection list acme-preview --branch preview --json"]
+	},
+	{
+		id: "database.connection.create",
+		path: [
+			"prisma",
+			"database",
+			"connection",
+			"create"
+		],
+		description: "Create a database connection and print its one-time connection URL",
+		examples: ["prisma-cli database connection create db_123", "prisma-cli database connection create db_123 --name readonly"]
+	},
+	{
+		id: "database.connection.rotate",
+		path: [
+			"prisma",
+			"database",
+			"connection",
+			"rotate"
+		],
+		description: "Rotate connection credentials and print the new one-time connection URL",
+		examples: ["prisma-cli database connection rotate conn_123 --confirm conn_123"]
+	},
+	{
+		id: "database.connection.remove",
+		path: [
+			"prisma",
+			"database",
+			"connection",
+			"remove"
+		],
+		description: "Remove a database connection after exact id confirmation",
+		examples: ["prisma-cli database connection remove conn_123 --confirm conn_123"]
 	},
 	{
 		id: "app.build",
@@ -208,15 +637,18 @@ const DESCRIPTORS = [
 			"deploy"
 		],
 		description: "Creates a new deployment for the app",
-		longDescription: "Agent skills for guided Next.js deploys are available from the Prisma CLI skill cluster.",
 		examples: [
 			"prisma-cli app deploy",
 			"prisma-cli app deploy --project proj_123",
 			"prisma-cli app deploy --create-project my-app --yes",
 			"prisma-cli app deploy --app my-app --env DATABASE_URL=postgresql://example",
+			"prisma-cli app deploy --env .env",
+			"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",
-			"pnpm dlx skills@latest add prisma/prisma-cli/skills#cli-v<cli-version> --all",
+			"prisma-cli app deploy --prod --yes",
 			"prisma-cli app deploy --framework bun --entry src/server.ts"
 		]
 	},
@@ -366,8 +798,12 @@ const DESCRIPTORS = [
 			"app",
 			"remove"
 		],
-		description: "Remove the app from the current branch",
-		examples: ["prisma-cli app remove --app hello-world", "prisma-cli app remove --app hello-world --yes"]
+		description: "Remove the app from the resolved branch",
+		examples: [
+			"prisma-cli app remove --app hello-world",
+			"prisma-cli app remove --app hello-world --yes",
+			"prisma-cli app remove --app hello-world --branch feature/foo --yes"
+		]
 	},
 	{
 		id: "project.env",
@@ -378,8 +814,9 @@ const DESCRIPTORS = [
 		],
 		description: "Manage environment variables for the active project",
 		examples: [
-			"prisma-cli project env list --role production",
+			"prisma-cli project env list",
 			"prisma-cli project env add STRIPE_KEY=sk_test_xxx --role production",
+			"prisma-cli project env add --file .env --role preview",
 			"prisma-cli project env add DATABASE_URL=postgresql://branch --branch feature/foo",
 			"prisma-cli project env remove STRIPE_KEY --role preview"
 		]
@@ -396,7 +833,9 @@ const DESCRIPTORS = [
 		examples: [
 			"prisma-cli project env add STRIPE_KEY=sk_test_xxx --role production",
 			"prisma-cli project env add STRIPE_KEY=sk_test_xxx --role preview",
+			"prisma-cli project env add --file .env --role preview",
 			"prisma-cli project env add DATABASE_URL=postgresql://branch --branch feature/foo",
+			"prisma-cli project env add --file .env.local --branch feature/foo",
 			"API_URL=https://api.example prisma-cli project env add API_URL --project proj_123 --role preview"
 		]
 	},
@@ -412,6 +851,7 @@ const DESCRIPTORS = [
 		examples: [
 			"prisma-cli project env update STRIPE_KEY=sk_new_xxx --role production",
 			"prisma-cli project env update STRIPE_KEY=sk_new_xxx --role preview",
+			"prisma-cli project env update --file .env --role production",
 			"prisma-cli project env update DATABASE_URL=postgresql://branch --branch feature/foo"
 		]
 	},
@@ -425,6 +865,7 @@ const DESCRIPTORS = [
 		],
 		description: "List environment variable metadata for a scope (no values).",
 		examples: [
+			"prisma-cli project env list",
 			"prisma-cli project env list --role production",
 			"prisma-cli project env list --role preview",
 			"prisma-cli project env list --branch feature/foo"

package/dist/shell/command-runner.js

@@ -1,14 +1,18 @@
-import { CliError, authRequiredError, commandCanceledError } from "./errors.js";
-import { cliErrorToJson, writeHumanError, writeHumanLines, writeJsonError, writeJsonEvent, writeJsonSuccess } from "./output.js";
+import { CliError, authConfigInvalidError, authRequiredError, commandCanceledError } from "./errors.js";
 import { getCommandDescriptor } from "./command-meta.js";
+import { renderSummaryLine } from "./ui.js";
 import { resolveGlobalFlags } from "./global-flags.js";
 import { createCommandContext } from "./runtime.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) {
 	if (isCancellationError(error) || runtime.signal.aborted) return commandCanceledError();
 	if (error instanceof CliError) return error;
 	if (error instanceof AuthError) return authRequiredError(["prisma-cli auth login"], { debug: error.message });
+	if (error instanceof Error && error.message.startsWith("PRISMA_SERVICE_TOKEN is set but empty")) return authConfigInvalidError(error.message);
 	return null;
 }
 function isCancellationError(error) {
@@ -16,37 +20,73 @@ function isCancellationError(error) {
 	return error.name === "AbortError" || error.name === "CancelledError";
 }
 async function runCommand(runtime, commandName, options, handler, presenter) {
-	const flags = resolveGlobalFlags(runtime.argv, options);
-	const context = await createCommandContext(runtime, flags);
+	const context = await createCommandContext(runtime, resolveGlobalFlags(runtime.argv, options));
 	const descriptor = getCommandDescriptor(commandName);
+	const startedAt = Date.now();
 	try {
-		const success = await handler(context);
-		if (flags.json) {
-			writeJsonSuccess(context.output, {
-				...success,
-				result: presenter.renderJson ? presenter.renderJson(success.result) : success.result
-			});
-			return;
-		}
-		if (flags.quiet) return;
-		writeHumanLines(context.output, presenter.renderHuman(context, descriptor, success.result));
+		await writeCommandSuccess(context, descriptor, await handler(context), presenter, Date.now() - startedAt);
 	} catch (error) {
 		const cliError = toCliError(error, runtime);
 		if (cliError) {
-			if (flags.json) writeJsonError(context.output, commandName, cliError);
-			else writeHumanError(context.output, context.ui, cliError, { trace: flags.trace });
+			writeCommandError(context, commandName, cliError);
 			process.exitCode = cliError.exitCode;
 			return;
 		}
 		throw error;
 	}
 }
-async function runStreamingCommand(runtime, commandName, options, handler) {
+async function writeCommandSuccess(context, descriptor, success, presenter, durationMs) {
+	if (context.flags.json) {
+		writeJsonSuccess(context.output, {
+			...success,
+			result: presenter.renderJson ? presenter.renderJson(success.result) : success.result
+		});
+		return;
+	}
+	const stdout = presenter.renderStdout?.(context, descriptor, success.result) ?? [];
+	if (context.flags.quiet) {
+		writeStdoutLines(context, stdout);
+		return;
+	}
+	const rendered = presenter.renderHuman(context, descriptor, success.result);
+	const warningLines = success.warnings.map((warning) => renderSummaryLine(context.ui, "warning", warning));
+	const diagnostics = await renderBestEffortCommandDiagnostics(context, {
+		enabled: context.flags.verbose && rendered.length > 0,
+		durationMs
+	});
+	const humanLines = [
+		...rendered,
+		...warningLines,
+		...diagnostics
+	];
+	if (stdout.length > 0 && humanLines.length > 0) humanLines.push("");
+	writeHumanLines(context.output, humanLines);
+	writeStdoutLines(context, stdout);
+}
+function writeCommandError(context, commandName, cliError) {
+	if (context.flags.json) {
+		writeJsonError(context.output, commandName, cliError);
+		return;
+	}
+	writeHumanError(context.output, context.ui, cliError, { trace: context.flags.trace });
+}
+function writeStdoutLines(context, lines) {
+	if (lines.length > 0) context.output.stdout.write(`${lines.join("\n")}\n`);
+}
+async function renderBestEffortCommandDiagnostics(context, options) {
+	if (!options.enabled) return [];
+	try {
+		return renderCommandDiagnostics(context, await collectCommandDiagnostics(context, { durationMs: options.durationMs }));
+	} catch {
+		return [];
+	}
+}
+async function runStreamingCommand(runtime, commandName, options, handler, streamOptions) {
 	const flags = resolveGlobalFlags(runtime.argv, options);
 	const context = await createCommandContext(runtime, flags);
 	try {
 		await handler(context);
-		if (flags.json) writeJsonEvent(context.output, {
+		if (flags.json && (streamOptions?.emitJsonSuccessEvent ?? true)) writeJsonEvent(context.output, {
 			type: "success",
 			command: commandName,
 			timestamp: (/* @__PURE__ */ new Date()).toISOString(),