@prisma/cli 8.0.0-rc.15-dev.106 → 8.0.0-rc.15-dev.108

package/dist/cli.js

@@ -5339,6 +5339,13 @@ function installWaitFailedError(repository, installUrl, inspectableInstallationC
 //#endregion
 //#region src/commands/git/connect.ts
 /** The `git connect` command. */
+/** Where the deploy workflow's inputs and the minimal file are documented. */
+const WORKFLOW_DOCS_URL = "https://github.com/prisma/cloud-deploy-action#readme";
+/** The platform never builds on push; the repository's own Actions workflow
+*  does, so a connection without one deploys nothing. Console import writes
+*  the file through a setup pull request; this command does not. */
+const WORKFLOW_DETAIL = "Deploys run from the repository's GitHub Actions workflow (prisma/cloud-deploy-action), which must exist on each pushed branch; the platform does not build on push.";
+const WORKFLOW_NEXT_STEP = "If the repository has no .github/workflows/prisma-deploy.yml yet, add one running prisma/cloud-deploy-action@v1 with `id-token: write`; a push of any branch that lacks the file deploys nothing.";
 /** The legacy wait line, printed once before the poll loop. */
 const WAIT_MESSAGE = "Waiting for GitHub App installation or repository access approval...";
 /**
@@ -5375,12 +5382,21 @@ async function resolveInstalledRepository(ctx, api, workspaceId, repository) {
 	if (match === null) throw installWaitFailedError(repository, installUrl, inspectableInstallationCount);
 	return match;
 }
+/** The connect result in every mode: the connection card, plus the
+*  workflow step the platform will not do for you. */
 function connectPresentations(result) {
 	const connection = result.repositoryConnection;
 	return {
 		stdout: () => [],
 		json: () => result,
-		next: () => [],
+		next: () => [{
+			kind: "edit-file",
+			label: WORKFLOW_NEXT_STEP
+		}, {
+			kind: "open-url",
+			label: "Workflow reference (prisma/cloud-deploy-action)",
+			url: WORKFLOW_DOCS_URL
+		}],
 		human: () => [
 			{
 				kind: "summary",
@@ -5410,7 +5426,7 @@ function connectPresentations(result) {
 			},
 			{
 				kind: "list",
-				items: [formatGitConnectionDetail(connection.status)]
+				items: [formatGitConnectionDetail(connection.status), WORKFLOW_DETAIL]
 			}
 		]
 	};
@@ -5424,8 +5440,8 @@ const gitConnectCommand = defineCommand({
 		flags: { project: projectFlag$2 }
 	},
 	help: {
-		summary: "Connect a project to a GitHub repository so every push deploys",
-		description: "Turns on deploy-on-push: once connected, pushing a Git branch builds and deploys it to a matching Platform Branch, an isolated environment with its own services, databases, and buckets. If the Prisma GitHub App does not cover the repository yet, the command opens the install page and waits. Run without a URL to use this repository's origin remote.",
+		summary: "Connect a project to a GitHub repository so its deploy workflow deploys every push",
+		description: "Links the repository to the project. Once connected, the repository's prisma/cloud-deploy-action workflow authenticates each run through GitHub's OIDC token and deploys every pushed branch to a matching Platform Branch, an isolated environment with its own services, databases, and buckets. The platform does not build on push itself: a repository without the workflow must add .github/workflows/prisma-deploy.yml (importing in the Console opens a pull request that adds it). If the Prisma GitHub App does not cover the repository yet, the command opens the install page and waits. Run without a URL to use this repository's origin remote.",
 		examples: [
 			"git connect",
 			"git connect git@github.com:prisma/prisma-cli.git",
@@ -13086,7 +13102,7 @@ const cliGroups = {
 			},
 			{
 				run: "git connect",
-				brief: "Connect GitHub so every push deploys"
+				brief: "Connect GitHub; branches carrying the deploy workflow deploy on push"
 			},
 			{
 				run: "project env add KEY=value --role preview",
@@ -13144,8 +13160,8 @@ const cliGroups = {
 		description: "A Branch maps to a Git branch of the connected repository. Each is an isolated environment with its own services, databases, buckets, and environment variables: the production branch serves live traffic, every other branch is a preview."
 	},
 	git: {
-		brief: "Manage the GitHub connection that deploys on push. Connect or disconnect a repository",
-		description: "Connecting a GitHub repository turns on deploy-on-push: pushing a Git branch builds and deploys it to a matching Platform Branch. Disconnecting stops push deploys without touching anything already deployed."
+		brief: "Manage the GitHub connection behind deploy-on-push. Connect or disconnect a repository",
+		description: "Connecting a GitHub repository turns on deploy-on-push: the repository's prisma/cloud-deploy-action workflow authenticates through the connection and deploys every pushed branch to a matching Platform Branch. The platform does not build on push; the workflow does. Disconnecting stops push deploys without touching anything already deployed."
 	},
 	service: {
 		brief: "Manage deployed services. Logs, versions, promote and rollback releases, custom domains",
@@ -13326,7 +13342,7 @@ function buildCli() {
 				},
 				{
 					run: "git connect",
-					brief: "Connect GitHub so every push deploys"
+					brief: "Connect GitHub; branches carrying the deploy workflow deploy on push"
 				},
 				{
 					run: "deploy",
@@ -14536,7 +14552,13 @@ async function maybeWriteSkillsStaleNotice(runtime) {
 		if (config !== null && !config.check) return;
 		const agents = config?.agents ?? DEFAULT_AGENTS;
 		if (agents.length === 0) return;
-		const notice = renderStaleNotice(status, agentSkillDirs(agents));
+		const dirs = agentSkillDirs(agents);
+		if (isFormat(flagTokens(runtime.argv), "markdown")) {
+			const notice = renderStaleNoticeMarkdown(status, dirs);
+			if (notice !== null) runtime.stdout.write(notice);
+			return;
+		}
+		const notice = renderStaleNotice(status, dirs);
 		if (notice !== null) runtime.stderr.write(notice);
 	} catch {
 		return;
@@ -14547,11 +14569,23 @@ async function maybeWriteSkillsStaleNotice(runtime) {
 function firstOutdatedSkillIn(status, dirs) {
 	return status.skills.find((skill) => skill.targets.some((target) => dirs.includes(target.dir) && (target.state === "stale" || target.state === "absent"))) ?? null;
 }
-function renderStaleNotice(status, dirs) {
+/** The mismatch in words, without the stream's framing around it. */
+function staleNoticeSentence(status, dirs) {
 	const outdated = firstOutdatedSkillIn(status, dirs);
 	if (outdated === null) return null;
 	const synced = outdated.targets.find((target) => dirs.includes(target.dir) && target.state === "stale")?.syncedVersion;
-	return `Prisma agent skills are out of date (installed ${outdated.library} ${outdated.version}, synced ${synced ?? "none"}). Run: ${getCliName()} skills sync\n`;
+	return `Prisma agent skills are out of date (installed ${outdated.library} ${outdated.version}, synced ${synced ?? "none"})`;
+}
+function renderStaleNotice(status, dirs) {
+	const sentence = staleNoticeSentence(status, dirs);
+	return sentence === null ? null : `${sentence}. Run: ${getCliName()} skills sync\n`;
+}
+/** The same notice as a trailing section of the Markdown document, in
+*  the heading-then-bullet shape the engine renders `### Diagnostics`
+*  in. The leading blank line separates it from the command's output. */
+function renderStaleNoticeMarkdown(status, dirs) {
+	const sentence = staleNoticeSentence(status, dirs);
+	return sentence === null ? null : `\n### Notice\n${sentence}.\n- Sync agent skills: \`${getCliName()} skills sync\`\n`;
 }
 /** The shared flags that take a separate value, so the word after them
 *  is that value rather than the command being invoked. */
@@ -14586,7 +14620,10 @@ function isSuppressedByInvocation(runtime) {
 	if (group === "skills" || group === "init") return true;
 	if (argv.includes("--json") || argv.includes("--quiet") || argv.includes("-q")) return true;
 	if (argv.includes("--version")) return true;
-	return argv.some((token, index) => token === "--format=json" || token === "--format" && argv[index + 1] === "json");
+	return isFormat(argv, "json");
+}
+function isFormat(tokens, format) {
+	return tokens.some((token, index) => token === `--format=${format}` || token === "--format" && tokens[index + 1] === format);
 }
 /** The file an explicit --config names, so the check reads the same
 *  config the command did. Discovery is otherwise cwd-only. */
@@ -14819,6 +14856,7 @@ async function main(proc, buildCliForRun = buildCli) {
 		env: proc.env,
 		argv: proc.argv.slice(2),
 		cwd: proc.cwd(),
+		stdout: proc.stdout,
 		stderr: proc.stderr
 	});
 	return exitCode;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prisma/cli",
-  "version": "8.0.0-rc.15-dev.106",
+  "version": "8.0.0-rc.15-dev.108",
   "description": "Command-line interface for the Prisma Developer Platform.",
   "type": "module",
   "bin": {
@@ -41,10 +41,10 @@
   "dependencies": {
     "@manypkg/tools": "^2.1.2",
     "@prisma/cli-engine": "0.4.0",
-    "@prisma/composer-cli": "0.20.0-dev.1",
+    "@prisma/composer-cli": "0.20.0-dev.5",
     "@prisma/compute-sdk": "0.42.0",
     "@prisma/management-api-sdk": "1.69.0",
-    "@prisma/orm-toolchain": "8.0.0-rc.11-dev.3",
+    "@prisma/orm-toolchain": "8.0.0-rc.11-dev.16",
     "@vercel/detect-agent": "^1.2.3",
     "better-result": "^2.9.2",
     "cross-spawn": "^7.0.6",
@@ -53,11 +53,11 @@
     "open": "^11.0.0"
   },
   "devDependencies": {
-    "@prisma/composer": "0.20.0-dev.1",
+    "@prisma/composer": "0.20.0-dev.5",
     "@prisma/credentials-store": "^7.8.0",
-    "@repo/cli-conformance": "8.0.0-rc.15-dev.106",
-    "@repo/cli-telemetry": "8.0.0-rc.15-dev.106",
-    "@repo/tsconfig": "8.0.0-rc.15-dev.106",
+    "@repo/cli-conformance": "8.0.0-rc.15-dev.108",
+    "@repo/cli-telemetry": "8.0.0-rc.15-dev.108",
+    "@repo/tsconfig": "8.0.0-rc.15-dev.108",
     "@types/node": "^22.19.19",
     "@types/cross-spawn": "^6.0.6",
     "tsdown": "^0.21.10",