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

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) {

package/dist/shell/update-check.js

@@ -1,9 +1,9 @@
 import { getCliName, getCliVersion } from "../lib/version.js";
-import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
 import path from "node:path";
+import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
+import { spawn } from "node:child_process";
 import { randomUUID } from "node:crypto";
 import os from "node:os";
-import { spawn } from "node:child_process";
 //#region src/shell/update-check.ts
 const UPDATE_CHECK_FILE_NAME = "update-check.json";
 const FALLBACK_INSTALL_DOCS_URL = "https://www.prisma.io/docs/orm/tools/prisma-cli";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prisma/cli",
-  "version": "3.0.0-beta.16",
+  "version": "3.0.0-beta.18",
   "description": "Command-line interface for the Prisma Developer Platform.",
   "type": "module",
   "bin": {
@@ -44,13 +44,14 @@
   },
   "dependencies": {
     "@clack/prompts": "^1.5.0",
-    "@prisma/compute-sdk": "^0.28.0",
+    "@prisma/compute-sdk": "0.31.0",
     "@prisma/credentials-store": "^7.8.0",
-    "@prisma/management-api-sdk": "^1.37.0",
+    "@prisma/management-api-sdk": "^1.44.0",
     "better-result": "^2.9.2",
     "colorette": "^2.0.20",
     "commander": "^14.0.3",
     "dotenv": "^17.4.2",
+    "execa": "^9.6.1",
     "magicast": "^0.5.3",
     "open": "^11.0.0",
     "string-width": "^8.2.1",