@prisma/cli 3.0.0-alpha.0 → 3.0.0-alpha.10

package/dist/presenters/project.js

@@ -12,7 +12,7 @@ function renderProjectList(context, descriptor, result) {
 			noun: "project",
 			label: project.name,
 			id: project.id,
-			status: result.linkedProjectId === project.id ? "linked" : null
+			status: null
 		})),
 		emptyMessage: "No projects found."
 	}, context.ui);
@@ -24,61 +24,104 @@ function serializeProjectList(result) {
 			noun: "project",
 			label: project.name,
 			id: project.id,
-			status: result.linkedProjectId === project.id ? "linked" : null
+			status: null
 		}))
 	});
 }
 function renderProjectShow(context, descriptor, result) {
-	if (!result.linkedProjectId) return renderShow({
-		title: "Showing the linked project for the current repo.",
-		descriptor,
-		fields: [{
-			key: "project",
-			value: "not linked",
-			tone: "dim"
-		}]
-	}, context.ui);
-	if (!result.project || !result.workspace) return renderShow({
-		title: "Showing the linked project for the current repo.",
+	return renderShow({
+		title: "Showing the project Prisma resolves for this directory.",
 		descriptor,
-		fields: [{
-			key: "project",
-			value: "linked",
-			tone: "success"
-		}, {
-			key: "remote details",
-			value: "unavailable until you sign in",
-			tone: "dim"
-		}]
+		fields: [
+			{
+				key: "workspace",
+				value: result.workspace.name
+			},
+			{
+				key: "project",
+				value: result.project.name
+			},
+			{
+				key: "resolution",
+				value: formatProjectSource(result.resolution.projectSource)
+			}
+		]
 	}, context.ui);
-	return renderShow({
-		title: "Showing the linked project for the current repo.",
+}
+function serializeProjectShow(result) {
+	return result;
+}
+function renderGitConnect(context, descriptor, result) {
+	const connection = result.repositoryConnection;
+	return renderMutate({
+		title: "Connecting Git to the resolved project.",
 		descriptor,
-		fields: [{
-			key: "project",
-			value: result.project.name
-		}, {
-			key: "workspace",
-			value: result.workspace.name
-		}]
+		context: [
+			{
+				key: "project",
+				value: result.project.name
+			},
+			{
+				key: "workspace",
+				value: result.workspace.name
+			},
+			{
+				key: "repository",
+				value: connection.repository.fullName
+			},
+			{
+				key: "status",
+				value: connection.status
+			}
+		],
+		operationDescription: "Applying repository connection",
+		operationCount: 1,
+		details: [formatGitConnectionDetail(connection.status)]
 	}, context.ui);
 }
-function renderProjectLink(context, descriptor, result) {
-	if (!result.project || !result.workspace) throw new Error("Linked project result must be enriched for human output.");
+function renderGitDisconnect(context, descriptor, result) {
 	return renderMutate({
-		title: "Linking the current repo to an existing project.",
+		title: "Disconnecting Git from the resolved project.",
 		descriptor,
-		context: [{
-			key: "project",
-			value: result.project.name
-		}, {
-			key: "workspace",
-			value: result.workspace.name
-		}],
-		operationDescription: "Applying local project link",
+		context: [
+			{
+				key: "project",
+				value: result.project.name
+			},
+			{
+				key: "workspace",
+				value: result.workspace.name
+			},
+			{
+				key: "repository",
+				value: result.repositoryConnection.repository.fullName
+			}
+		],
+		operationDescription: "Applying repository disconnection",
 		operationCount: 1,
-		details: ["Project link written to local repo config."]
+		details: ["GitHub branch automation is no longer active for this project."]
 	}, context.ui);
 }
+function formatProjectSource(source) {
+	switch (source) {
+		case "explicit": return "explicit";
+		case "env": return "environment";
+		case "local-pin": return "local pin";
+		case "platform-mapping": return "platform mapping";
+		case "remembered-local": return "remembered local context";
+		case "package-name": return "package name";
+		case "directory-name": return "directory name";
+		case "created": return "created";
+		case "prompt": return "prompt";
+	}
+}
+function formatGitConnectionDetail(status) {
+	switch (status) {
+		case "active": return "GitHub branch automation is active for this project.";
+		case "pending": return "GitHub branch automation is pending GitHub App installation.";
+		case "archived": return "GitHub branch automation has been archived for this project.";
+		default: return "GitHub repository is connected, but branch automation is not active.";
+	}
+}
 //#endregion
-export { renderProjectLink, renderProjectList, renderProjectShow, serializeProjectList };
+export { renderGitConnect, renderGitDisconnect, renderProjectList, renderProjectShow, serializeProjectList, serializeProjectShow };

package/dist/presenters/version.js

@@ -0,0 +1,29 @@
+import { renderShow } from "../output/patterns.js";
+//#region src/presenters/version.ts
+function renderVersionSuccess(context, descriptor, result) {
+	return renderShow({
+		title: "Showing CLI build and environment.",
+		descriptor,
+		fields: [
+			{
+				key: result.cli.name,
+				value: result.cli.version
+			},
+			{
+				key: "node",
+				value: result.node.version
+			},
+			{
+				key: "os",
+				value: `${result.os.platform} ${result.os.arch}`
+			},
+			{
+				key: "invocation",
+				value: result.invocation,
+				tone: result.invocation === "unknown" ? "dim" : "default"
+			}
+		]
+	}, context.ui);
+}
+//#endregion
+export { renderVersionSuccess };

package/dist/shell/command-meta.js

@@ -4,17 +4,21 @@ const DESCRIPTORS = [
 	{
 		id: "root",
 		path: ["prisma"],
-		description: "Unified Prisma CLI.",
-		docsPath: "docs/product/command-principles.md",
-		examples: ["prisma auth login", "prisma project list"],
-		longDescription: "The Prisma CLI groups commands by developer workflow and keeps human and agent behavior aligned."
+		description: "The Prisma Developer Platform, from your terminal",
+		examples: ["prisma-cli auth login", "prisma-cli app deploy"],
+		longDescription: "Deploy your app with isolated infrastructure for every branch"
+	},
+	{
+		id: "version",
+		path: ["prisma", "version"],
+		description: "Show CLI build and environment",
+		examples: ["prisma-cli version", "prisma-cli version --json"]
 	},
 	{
 		id: "auth",
 		path: ["prisma", "auth"],
-		description: "Authentication and identity commands.",
-		docsPath: "docs/product/command-spec.md#prisma-auth-login",
-		examples: ["prisma auth login", "prisma auth whoami"]
+		description: "Manage local authentication for the CLI",
+		examples: ["prisma-cli auth login", "prisma-cli auth whoami"]
 	},
 	{
 		id: "auth.login",
@@ -23,9 +27,8 @@ const DESCRIPTORS = [
 			"auth",
 			"login"
 		],
-		description: "Start an authenticated CLI session.",
-		docsPath: "docs/product/command-spec.md#prisma-auth-login",
-		examples: ["prisma auth login"]
+		description: "Log in to your Prisma platform account",
+		examples: ["prisma-cli auth login"]
 	},
 	{
 		id: "auth.logout",
@@ -34,9 +37,8 @@ const DESCRIPTORS = [
 			"auth",
 			"logout"
 		],
-		description: "Clear the current CLI session.",
-		docsPath: "docs/product/command-spec.md#prisma-auth-logout",
-		examples: ["prisma auth logout"]
+		description: "Clear stored authentication credentials",
+		examples: ["prisma-cli auth logout"]
 	},
 	{
 		id: "auth.whoami",
@@ -45,30 +47,32 @@ const DESCRIPTORS = [
 			"auth",
 			"whoami"
 		],
-		description: "Show the current authenticated identity.",
-		docsPath: "docs/product/command-spec.md#prisma-auth-whoami",
-		examples: ["prisma auth whoami", "prisma auth whoami --json"]
+		description: "Show the authenticated user and accessible workspace",
+		examples: ["prisma-cli auth whoami", "prisma-cli auth whoami --json"]
 	},
 	{
 		id: "project",
 		path: ["prisma", "project"],
-		description: "Project discovery and repo linking commands.",
-		docsPath: "docs/product/command-spec.md#prisma-project-list",
-		examples: ["prisma project list", "prisma project show"]
+		description: "Manage and inspect your Prisma projects",
+		examples: ["prisma-cli project list", "prisma-cli project show"]
 	},
 	{
 		id: "app",
 		path: ["prisma", "app"],
-		description: "App deployment and release commands.",
-		docsPath: "docs/product/command-spec.md#prisma-app-deploy---app-name---entry-path---build-type-autobunnextjs---http-port-port---env-namevalue",
-		examples: ["prisma app build --build-type nextjs", "prisma app deploy --app hello-world --build-type nextjs --http-port 3000"]
+		description: "Manage apps and deployments for a project",
+		examples: ["prisma-cli app deploy", "prisma-cli app deploy --app my-app --framework nextjs --http-port 3000"]
 	},
 	{
 		id: "branch",
 		path: ["prisma", "branch"],
-		description: "Branch context and safety commands.",
-		docsPath: "docs/product/command-spec.md#prisma-branch-list",
-		examples: ["prisma branch list", "prisma branch use production"]
+		description: "View your active Platform branches",
+		examples: ["prisma-cli branch list", "prisma-cli branch show"]
+	},
+	{
+		id: "git",
+		path: ["prisma", "git"],
+		description: "Manage Git repository connections for a project",
+		examples: ["prisma-cli git connect", "prisma-cli git disconnect"]
 	},
 	{
 		id: "project.list",
@@ -77,9 +81,8 @@ const DESCRIPTORS = [
 			"project",
 			"list"
 		],
-		description: "List projects for the authenticated workspace.",
-		docsPath: "docs/product/command-spec.md#prisma-project-list",
-		examples: ["prisma project list", "prisma project list --json"]
+		description: "List all projects in your workspace",
+		examples: ["prisma-cli project list", "prisma-cli project list --json"]
 	},
 	{
 		id: "project.show",
@@ -88,20 +91,32 @@ const DESCRIPTORS = [
 			"project",
 			"show"
 		],
-		description: "Show the linked project for the current repo.",
-		docsPath: "docs/product/command-spec.md#prisma-project-show",
-		examples: ["prisma project show", "prisma project show --json"]
+		description: "Show which project is active for this directory",
+		examples: ["prisma-cli project show", "prisma-cli project show --project proj_123 --json"]
 	},
 	{
-		id: "project.link",
+		id: "git.connect",
 		path: [
 			"prisma",
-			"project",
-			"link"
+			"git",
+			"connect"
 		],
-		description: "Link the current repo to an existing project.",
-		docsPath: "docs/product/command-spec.md#prisma-project-link-project",
-		examples: ["prisma project link", "prisma project link proj_123"]
+		description: "Connect the resolved project to a GitHub repository",
+		examples: [
+			"prisma-cli git connect",
+			"prisma-cli git connect git@github.com:prisma/prisma-cli.git",
+			"prisma-cli git connect --project proj_123"
+		]
+	},
+	{
+		id: "git.disconnect",
+		path: [
+			"prisma",
+			"git",
+			"disconnect"
+		],
+		description: "Disconnect the GitHub repository from the resolved project",
+		examples: ["prisma-cli git disconnect", "prisma-cli git disconnect --project proj_123"]
 	},
 	{
 		id: "branch.list",
@@ -110,9 +125,8 @@ const DESCRIPTORS = [
 			"branch",
 			"list"
 		],
-		description: "List branches for the linked project.",
-		docsPath: "docs/product/command-spec.md#prisma-branch-list",
-		examples: ["prisma branch list", "prisma branch list --json"]
+		description: "List active Platform branches for the resolved project",
+		examples: ["prisma-cli branch list", "prisma-cli branch list --json"]
 	},
 	{
 		id: "branch.show",
@@ -121,9 +135,8 @@ const DESCRIPTORS = [
 			"branch",
 			"show"
 		],
-		description: "Show the current active branch context.",
-		docsPath: "docs/product/command-spec.md#prisma-branch-show",
-		examples: ["prisma branch show", "prisma branch show --json"]
+		description: "Show the Platform branch matching your current Git branch",
+		examples: ["prisma-cli branch show", "prisma-cli branch show --json"]
 	},
 	{
 		id: "branch.use",
@@ -133,8 +146,7 @@ const DESCRIPTORS = [
 			"use"
 		],
 		description: "Change the local default branch context.",
-		docsPath: "docs/product/command-spec.md#prisma-branch-use-name",
-		examples: ["prisma branch use", "prisma branch use production"]
+		examples: ["prisma-cli branch use", "prisma-cli branch use production"]
 	},
 	{
 		id: "app.build",
@@ -143,9 +155,12 @@ const DESCRIPTORS = [
 			"app",
 			"build"
 		],
-		description: "Build the local app into a deployable artifact.",
-		docsPath: "docs/product/command-spec.md#prisma-app-build---entry-path---build-type-autobunnextjs",
-		examples: ["prisma app build --build-type nextjs", "prisma app build --build-type bun --entry server.ts"]
+		description: "Build the app locally into a deployable artifact",
+		examples: [
+			"prisma-cli app build --build-type nextjs",
+			"prisma-cli app build --build-type nuxt",
+			"prisma-cli app build --build-type bun --entry server.ts"
+		]
 	},
 	{
 		id: "app.run",
@@ -154,9 +169,8 @@ const DESCRIPTORS = [
 			"app",
 			"run"
 		],
-		description: "Start a local framework dev server.",
-		docsPath: "docs/product/command-spec.md#prisma-app-run---entry-path---build-type-autobunnextjs---port-port",
-		examples: ["prisma app run --build-type nextjs", "prisma app run --build-type bun --entry server.ts --port 3000"]
+		description: "Run your app locally",
+		examples: ["prisma-cli app run --build-type nextjs", "prisma-cli app run --build-type bun --entry server.ts --port 3000"]
 	},
 	{
 		id: "app.deploy",
@@ -165,12 +179,12 @@ const DESCRIPTORS = [
 			"app",
 			"deploy"
 		],
-		description: "Build and release the selected app.",
-		docsPath: "docs/product/command-spec.md#prisma-app-deploy---app-name---entry-path---build-type-autobunnextjs---http-port-port---env-namevalue",
+		description: "Creates a new deployment for the app",
 		examples: [
-			"prisma app deploy",
-			"prisma app deploy --app hello-world --env DATABASE_URL=postgresql://example",
-			"prisma app deploy --app hello-world --build-type nextjs --http-port 3000"
+			"prisma-cli app deploy",
+			"prisma-cli app deploy --app my-app --env DATABASE_URL=postgresql://example",
+			"prisma-cli app deploy --app my-app --framework nextjs --http-port 3000",
+			"prisma-cli app deploy --branch feat-login --framework hono"
 		]
 	},
 	{
@@ -181,8 +195,7 @@ const DESCRIPTORS = [
 			"update-env"
 		],
 		description: "Create a new deployment with updated environment variables.",
-		docsPath: "docs/product/command-spec.md#prisma-app-update-env---app-name---env-namevalue",
-		examples: ["prisma app update-env --env DATABASE_URL=postgresql://example", "prisma app update-env --app hello-world --env DATABASE_URL=postgresql://another"]
+		examples: ["prisma-cli app update-env --env DATABASE_URL=postgresql://example", "prisma-cli app update-env --app hello-world --env DATABASE_URL=postgresql://another"]
 	},
 	{
 		id: "app.list-env",
@@ -192,8 +205,7 @@ const DESCRIPTORS = [
 			"list-env"
 		],
 		description: "List environment variable names for the selected app.",
-		docsPath: "docs/product/command-spec.md#prisma-app-list-env---app-name",
-		examples: ["prisma app list-env", "prisma app list-env --app hello-world"]
+		examples: ["prisma-cli app list-env", "prisma-cli app list-env --app hello-world"]
 	},
 	{
 		id: "app.show",
@@ -202,9 +214,8 @@ const DESCRIPTORS = [
 			"app",
 			"show"
 		],
-		description: "Show the current state of the selected app.",
-		docsPath: "docs/product/command-spec.md#prisma-app-show---app-name",
-		examples: ["prisma app show", "prisma app show --app hello-world"]
+		description: "Show the app and its current deployment",
+		examples: ["prisma-cli app show", "prisma-cli app show --app hello-world"]
 	},
 	{
 		id: "app.open",
@@ -213,9 +224,8 @@ const DESCRIPTORS = [
 			"app",
 			"open"
 		],
-		description: "Open the live URL for the selected app.",
-		docsPath: "docs/product/command-spec.md#prisma-app-open---app-name",
-		examples: ["prisma app open", "prisma app open --app hello-world"]
+		description: "Open the app's live URL",
+		examples: ["prisma-cli app open", "prisma-cli app open --app hello-world"]
 	},
 	{
 		id: "app.logs",
@@ -224,9 +234,8 @@ const DESCRIPTORS = [
 			"app",
 			"logs"
 		],
-		description: "Show or stream logs for a deployment.",
-		docsPath: "docs/product/command-spec.md#prisma-app-logs---app-name---deployment-id",
-		examples: ["prisma app logs", "prisma app logs --deployment dep_123"]
+		description: "Stream logs for the app's current deployment",
+		examples: ["prisma-cli app logs", "prisma-cli app logs --deployment dep_123"]
 	},
 	{
 		id: "app.list-deploys",
@@ -235,9 +244,8 @@ const DESCRIPTORS = [
 			"app",
 			"list-deploys"
 		],
-		description: "List deployments for the selected app.",
-		docsPath: "docs/product/command-spec.md#prisma-app-list-deploys---app-name",
-		examples: ["prisma app list-deploys", "prisma app list-deploys --app hello-world"]
+		description: "List deployments for the app",
+		examples: ["prisma-cli app list-deploys", "prisma-cli app list-deploys --app hello-world"]
 	},
 	{
 		id: "app.show-deploy",
@@ -246,9 +254,8 @@ const DESCRIPTORS = [
 			"app",
 			"show-deploy"
 		],
-		description: "Show one deployment in detail.",
-		docsPath: "docs/product/command-spec.md#prisma-app-show-deploy-deployment",
-		examples: ["prisma app show-deploy dep_123"]
+		description: "Show a deployment in detail",
+		examples: ["prisma-cli app show-deploy dep_123"]
 	},
 	{
 		id: "app.promote",
@@ -257,9 +264,8 @@ const DESCRIPTORS = [
 			"app",
 			"promote"
 		],
-		description: "Switch the live deployment for the selected app.",
-		docsPath: "docs/product/command-spec.md#prisma-app-promote-deployment---app-name",
-		examples: ["prisma app promote dep_123", "prisma app promote dep_123 --app hello-world"]
+		description: "Promote a deployment to production by rebuilding with production env vars",
+		examples: ["prisma-cli app promote dep_123", "prisma-cli app promote dep_123 --app hello-world"]
 	},
 	{
 		id: "app.rollback",
@@ -268,9 +274,8 @@ const DESCRIPTORS = [
 			"app",
 			"rollback"
 		],
-		description: "Restore the selected app to an earlier deployment.",
-		docsPath: "docs/product/command-spec.md#prisma-app-rollback---app-name---to-deployment",
-		examples: ["prisma app rollback", "prisma app rollback --app hello-world --to dep_123"]
+		description: "Roll back production to a previous deployment",
+		examples: ["prisma-cli app rollback", "prisma-cli app rollback --app hello-world --to dep_123"]
 	},
 	{
 		id: "app.remove",
@@ -279,9 +284,70 @@ const DESCRIPTORS = [
 			"app",
 			"remove"
 		],
-		description: "Remove the selected app from the linked project.",
-		docsPath: "docs/product/command-spec.md#prisma-app-remove---app-name--y---yes",
-		examples: ["prisma app remove --app hello-world", "prisma app remove --app hello-world --yes"]
+		description: "Remove the app from the current branch",
+		examples: ["prisma-cli app remove --app hello-world", "prisma-cli app remove --app hello-world --yes"]
+	},
+	{
+		id: "project.env",
+		path: [
+			"prisma",
+			"project",
+			"env"
+		],
+		description: "Manage environment variables for the active project",
+		examples: [
+			"prisma-cli project env list --role production",
+			"prisma-cli project env add STRIPE_KEY=sk_test_xxx --role production",
+			"prisma-cli project env rm STRIPE_KEY --role preview"
+		]
+	},
+	{
+		id: "project.env.add",
+		path: [
+			"prisma",
+			"project",
+			"env",
+			"add"
+		],
+		description: "Create a new environment variable.",
+		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",
+			"API_URL=https://api.example prisma-cli project env add API_URL --project proj_123 --role preview"
+		]
+	},
+	{
+		id: "project.env.update",
+		path: [
+			"prisma",
+			"project",
+			"env",
+			"update"
+		],
+		description: "Replace an existing environment variable's value.",
+		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"]
+	},
+	{
+		id: "project.env.list",
+		path: [
+			"prisma",
+			"project",
+			"env",
+			"list"
+		],
+		description: "List environment variable metadata for a scope (no values).",
+		examples: ["prisma-cli project env list --role production", "prisma-cli project env list --role preview"]
+	},
+	{
+		id: "project.env.rm",
+		path: [
+			"prisma",
+			"project",
+			"env",
+			"rm"
+		],
+		description: "Remove an environment variable from a scope.",
+		examples: ["prisma-cli project env rm STRIPE_KEY --role production", "prisma-cli project env rm STRIPE_KEY --role preview"]
 	}
 ];
 const DESCRIPTORS_BY_ID = new Map(DESCRIPTORS.map((descriptor) => [descriptor.id, descriptor]));

package/dist/shell/command-runner.js

@@ -1,8 +1,8 @@
 import { CliError } from "./errors.js";
+import { cliErrorToJson, writeHumanError, writeHumanLines, writeJsonError, writeJsonEvent, writeJsonSuccess } from "./output.js";
 import { getCommandDescriptor } from "./command-meta.js";
 import { resolveGlobalFlags } from "./global-flags.js";
 import { createCommandContext } from "./runtime.js";
-import { writeHumanError, writeHumanLines, writeJsonError, writeJsonSuccess } from "./output.js";
 //#region src/shell/command-runner.ts
 async function runCommand(runtime, commandName, options, handler, presenter) {
 	const flags = resolveGlobalFlags(runtime.argv, options);
@@ -29,5 +29,35 @@ async function runCommand(runtime, commandName, options, handler, presenter) {
 		throw error;
 	}
 }
+async function runStreamingCommand(runtime, commandName, options, handler) {
+	const flags = resolveGlobalFlags(runtime.argv, options);
+	const context = await createCommandContext(runtime, flags);
+	try {
+		await handler(context);
+		if (flags.json) writeJsonEvent(context.output, {
+			type: "success",
+			command: commandName,
+			timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+			result: null,
+			warnings: [],
+			nextSteps: []
+		});
+	} catch (error) {
+		if (error instanceof CliError) {
+			if (flags.json) writeJsonEvent(context.output, {
+				type: "error",
+				command: commandName,
+				timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+				error: cliErrorToJson(error),
+				warnings: [],
+				nextSteps: error.nextSteps
+			});
+			else writeHumanError(context.output, context.ui, error, { trace: flags.trace });
+			process.exitCode = error.exitCode;
+			return;
+		}
+		throw error;
+	}
+}
 //#endregion
-export { runCommand };
+export { runCommand, runStreamingCommand };