@prisma/cli 3.0.0-dev.97.1 → 8.0.0-rc.1

package/dist/presenters/project.js

@@ -1,7 +1,7 @@
+import { formatCommandArgument } from "../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";
@@ -17,9 +17,13 @@ function renderProjectList(context, descriptor, result) {
 		return lines;
 	}
 	const nameWidth = Math.max(4, ...result.projects.map((project) => stringWidth(project.name)));
+	const idWidth = Math.max(2, ...result.projects.map((project) => project.id.length));
 	lines.push(rail);
-	lines.push(`${rail}  ${ui.accent(padDisplay("name", nameWidth))}  ${ui.accent("id")}`);
-	for (const project of result.projects) lines.push(`${rail}  ${padDisplay(project.name, nameWidth)}  ${project.id}`);
+	lines.push(`${rail}  ${ui.accent(padDisplay("name", nameWidth))}  ${ui.accent(padDisplay("id", idWidth))}  ${ui.accent("region")}`);
+	for (const project of result.projects) {
+		const region = project.defaultRegion ? project.defaultRegion : ui.dim("none");
+		lines.push(`${rail}  ${padDisplay(project.name, nameWidth)}  ${padDisplay(project.id, idWidth)}  ${region}`);
+	}
 	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;
 }
@@ -86,6 +90,95 @@ function renderProjectSetup(context, _descriptor, result) {
 function serializeProjectSetup(result) {
 	return result;
 }
+function renderProjectRename(context, descriptor, result) {
+	return renderMutate({
+		title: "Renaming project.",
+		descriptor,
+		context: [
+			{
+				key: "workspace",
+				value: result.workspace.name
+			},
+			{
+				key: "project",
+				value: result.previousName
+			},
+			{
+				key: "id",
+				value: result.project.id,
+				tone: "dim"
+			}
+		],
+		operationDescription: "Renaming project",
+		operationCount: 1,
+		details: [`The project is now named "${result.project.name}". Directory bindings pin the project id, so they stay valid.`]
+	}, context.ui);
+}
+function serializeProjectRename(result) {
+	return result;
+}
+function renderProjectRemove(context, descriptor, result) {
+	return renderMutate({
+		title: "Removing project.",
+		descriptor,
+		context: [
+			{
+				key: "workspace",
+				value: result.workspace.name
+			},
+			{
+				key: "project",
+				value: result.project.name
+			},
+			{
+				key: "id",
+				value: result.project.id,
+				tone: "dim"
+			}
+		],
+		operationDescription: "Removing project",
+		operationCount: 1,
+		details: ["The project, its databases, and its apps were removed.", ...result.localPin.cleared ? ["This directory's local project binding was cleared."] : []]
+	}, context.ui);
+}
+function serializeProjectRemove(result) {
+	return result;
+}
+function renderProjectTransfer(context, descriptor, result) {
+	return renderMutate({
+		title: "Transferring project.",
+		descriptor,
+		context: [
+			{
+				key: "workspace",
+				value: result.workspace.name
+			},
+			{
+				key: "project",
+				value: result.project.name
+			},
+			{
+				key: "id",
+				value: result.project.id,
+				tone: "dim"
+			},
+			{
+				key: "recipient",
+				value: result.recipient.workspaceName ?? result.recipient.workspaceId ?? "workspace of the provided recipient token"
+			}
+		],
+		operationDescription: "Transferring project",
+		operationCount: 1,
+		details: [
+			"The project now belongs to the recipient workspace; this workspace no longer has access.",
+			...result.localPin.action === "rewritten" ? ["This directory's local project binding now points at the recipient workspace."] : [],
+			...result.localPin.action === "cleared" ? ["This directory's local project binding was cleared."] : []
+		]
+	}, context.ui);
+}
+function serializeProjectTransfer(result) {
+	return result;
+}
 function renderGitConnect(context, descriptor, result) {
 	const connection = result.repositoryConnection;
 	return renderMutate({
@@ -152,6 +245,7 @@ function renderBoundProjectShow(context, descriptor, result) {
 		lines.push(rail);
 		lines.push(`${rail}  ${ui.dim("→")} ${ui.link(result.project.url)}`);
 	}
+	if (result.project.defaultRegion) lines.push(`${rail}  ${ui.accent(padDisplay("region", keyWidth))}  ${ui.dim(result.project.defaultRegion)}`);
 	lines.push(...renderResolvedProjectContextBlock(context.ui, {
 		workspace: result.workspace,
 		project: result.project,
@@ -171,4 +265,4 @@ function formatGitConnectionDetail(status) {
 	}
 }
 //#endregion
-export { renderGitConnect, renderGitDisconnect, renderProjectList, renderProjectSetup, renderProjectShow, serializeProjectList, serializeProjectSetup, serializeProjectShow };
+export { renderGitConnect, renderGitDisconnect, renderProjectList, renderProjectRemove, renderProjectRename, renderProjectSetup, renderProjectShow, renderProjectTransfer, serializeProjectList, serializeProjectRemove, serializeProjectRename, serializeProjectSetup, serializeProjectShow, serializeProjectTransfer };

package/dist/shell/cli-command.js

@@ -0,0 +1,2 @@
+import "../cli-command.js";
+export {};

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"],
@@ -124,6 +223,22 @@ const DESCRIPTORS = [
 		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"],
@@ -134,6 +249,105 @@ const DESCRIPTORS = [
 			"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",
 		path: ["prisma", "git"],
@@ -184,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: [
@@ -252,6 +496,26 @@ const DESCRIPTORS = [
 		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: [
@@ -262,6 +526,27 @@ const DESCRIPTORS = [
 		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: [
@@ -298,6 +583,17 @@ const DESCRIPTORS = [
 		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: [
@@ -341,7 +637,6 @@ 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",
@@ -351,9 +646,9 @@ 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",
-			"pnpm dlx skills@latest add prisma/prisma-cli/skills#cli-v<cli-version> --all",
 			"prisma-cli app deploy --framework bun --entry src/server.ts"
 		]
 	},
@@ -503,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",

package/dist/shell/command-runner.js

@@ -1,17 +1,19 @@
-import { CliError, authConfigInvalidError, authRequiredError, commandCanceledError } from "./errors.js";
+import { CliError, authConfigInvalidError, authRequiredError, commandCanceledError } from "../errors.js";
 import { getCommandDescriptor } from "./command-meta.js";
+import { renderSummaryLine } from "./ui.js";
+import { isEmptyServiceTokenError } from "../auth/operations.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) {
 	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);
+	if (isEmptyServiceTokenError(error)) return authConfigInvalidError(error.message);
 	return null;
 }
 function isCancellationError(error) {
@@ -48,11 +50,16 @@ async function writeCommandSuccess(context, descriptor, success, presenter, dura
 		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, ...diagnostics];
+	const humanLines = [
+		...rendered,
+		...warningLines,
+		...diagnostics
+	];
 	if (stdout.length > 0 && humanLines.length > 0) humanLines.push("");
 	writeHumanLines(context.output, humanLines);
 	writeStdoutLines(context, stdout);
@@ -75,12 +82,12 @@ async function renderBestEffortCommandDiagnostics(context, options) {
 		return [];
 	}
 }
-async function runStreamingCommand(runtime, commandName, options, handler) {
+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(),

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/output.js

@@ -1,3 +1,4 @@
+import { formatCommandArgument } from "../command-arguments.js";
 import { renderNextSteps, renderSummaryLine } from "./ui.js";
 //#region src/shell/output.ts
 function writeJsonSuccess(output, success) {
@@ -23,15 +24,76 @@ function cliErrorToJson(error) {
 		docsUrl: error.docsUrl
 	};
 }
-function formatUnexpectedError(error, trace) {
+function formatUnexpectedError(error, trace, feedbackCommand) {
+	const feedbackLine = feedbackCommand ? `Tell us what happened: ${feedbackCommand}` : null;
 	const debug = error instanceof Error ? error.stack ?? error.message : String(error);
-	if (trace) return `${debug}\n`;
+	if (trace) return [
+		debug,
+		...feedbackLine ? [feedbackLine] : [],
+		""
+	].join("\n");
 	return [
 		`Unexpected CLI error: ${error instanceof Error && error.message ? error.message : String(error)}`,
 		"More: Re-run with --trace for deeper diagnostics",
+		...feedbackLine ? [feedbackLine] : [],
 		""
 	].join("\n");
 }
+/** Command groups whose second argv token names the subcommand. */
+const COMMAND_GROUPS = new Set([
+	"agent",
+	"auth",
+	"project",
+	"git",
+	"branch",
+	"build",
+	"database",
+	"app"
+]);
+/** Best-effort `command` label for a crash that predates envelope assembly. */
+function unexpectedErrorCommandLabel(argv) {
+	const [group, action] = argv.filter((arg) => !arg.startsWith("-"));
+	if (!group) return "unknown";
+	return action && COMMAND_GROUPS.has(group) ? `${group}.${action}` : group;
+}
+/**
+* Pre-filled feedback command for a crash, so the report arrives carrying the
+* failing command and the error's first line.
+*/
+function unexpectedErrorFeedbackCommand(argv, error) {
+	return `prisma-cli feedback ${formatCommandArgument(`${unexpectedErrorCommandLabel(argv).replace(".", " ")} crashed: ${(error instanceof Error && error.message ? error.message : String(error)).split("\n")[0]}`.slice(0, 200))}`;
+}
+/**
+* A crash must not break the `--json` contract: agents still get a structured
+* envelope, with a recover action pointing at the feedback command.
+*/
+function writeJsonUnexpectedError(output, argv, error) {
+	const feedbackCommand = unexpectedErrorFeedbackCommand(argv, error);
+	output.stdout.write(`${JSON.stringify({
+		ok: false,
+		command: unexpectedErrorCommandLabel(argv),
+		error: {
+			code: "UNEXPECTED_ERROR",
+			domain: "cli",
+			severity: "error",
+			summary: "Unexpected CLI error",
+			why: error instanceof Error && error.message ? error.message : String(error),
+			fix: "Re-run with --trace for deeper diagnostics, and report the crash.",
+			where: null,
+			meta: {},
+			docsUrl: null
+		},
+		warnings: [],
+		nextSteps: [feedbackCommand],
+		nextActions: [{
+			kind: "run-command",
+			journey: "recover",
+			label: "Report this crash to the Prisma team",
+			command: feedbackCommand,
+			reason: "This looks like a CLI bug; the pre-filled report carries the failing command and error."
+		}]
+	}, null, 2)}\n`);
+}
 function writeJsonError(output, command, error) {
 	output.stdout.write(`${JSON.stringify({
 		ok: false,
@@ -79,4 +141,4 @@ function writeHumanError(output, ui, error, options) {
 	writeHumanLines(output, lines);
 }
 //#endregion
-export { cliErrorToJson, formatUnexpectedError, writeHumanError, writeHumanLines, writeJsonError, writeJsonEvent, writeJsonSuccess };
+export { cliErrorToJson, formatUnexpectedError, unexpectedErrorFeedbackCommand, writeHumanError, writeHumanLines, writeJsonError, writeJsonEvent, writeJsonSuccess, writeJsonUnexpectedError };