[cli] Add v2 deployment checks handling to deploy --prod by codywong · Pull Request #15884 · vercel/vercel

codywong · 2026-04-08T21:35:54Z

Summary

Add support for Deployment Checks (deployment.checks['deployment-alias']) in vc deploy --prod
Show "Running Checks..." spinner when the deployment-alias check is pending after build completes
Detect deployment-alias check failure via polling and exit with error details
Fetch check run details from GET /v2/deployments/{id}/check-runs and display failed runs with hyperlinked names to logs endpoint (vercel source) or deployment page (external source)
Include failedCheckRuns with per-run details (id, name, source, logsUrl) in non-interactive JSON output
Existing v1 checks (checksConclusion) and aliasError handling preserved

How success/failure paths work

Success: Server sets aliasAssigned: true after checks pass → existing alias-assigned event handles it (no new code path needed)
Failure: Polling detects checks['deployment-alias'].state === 'failed' → emits checks-v2-completed event → CLI fetches check runs and prints failures

Test plan

Unit tests for v1 checks failure, v2 checks failure, v2 non-interactive JSON output, and v2 checks pending → success flow

changeset-bot · 2026-04-08T21:36:03Z

🦋 Changeset detected

Latest commit: c41ff3a

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 2 packages

Name	Type
vercel	Minor
@vercel/client	Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

codywong · 2026-04-08T21:36:09Z

[cli] Add v2 deployment checks handling to deploy --prod #15884 👈 (View in Graphite)
main

This stack of pull requests is managed by Graphite. Learn more about stacking.

github-actions · 2026-04-08T21:38:19Z

📦 CLI Tarball Ready

The Vercel CLI tarball for this PR is now available!

Quick Test

You can test this PR's CLI directly by running:

npx https://vercel-kp47vru7b.vercel.sh/tarballs/vercel.tgz --help

Use in vercel.json

To use this CLI version in your project builds, add to your vercel.json:

{
  "build": {
    "env": {
      "VERCEL_CLI_VERSION": "vercel@https://vercel-kp47vru7b.vercel.sh/tarballs/vercel.tgz"
    }
  }
}

Python Runtime Wheel

A vercel-runtime wheel was also built for this PR.
To use in your Python project builds, also set this environment variable:

VERCEL_RUNTIME_PYTHON="vercel-runtime @ https://vercel-kp47vru7b.vercel.sh/tarballs/vercel_runtime-0.13.0.dev1775691515+c41ff3a-py3-none-any.whl"

Python Workers Wheel

A vercel-workers wheel was also built for this PR.
To use in your Python project builds, also set this environment variable:

VERCEL_WORKERS_PYTHON="vercel-workers @ https://vercel-kp47vru7b.vercel.sh/tarballs/vercel_workers-0.1.0.dev1775691515+c41ff3a-py3-none-any.whl"

github-actions · 2026-04-08T21:43:17Z

🧪 Unit Test Strategy

Comparing: 02049a3 → c41ff3a (view diff)

Strategy: Affected packages only

✅ Only testing packages that have been modified or depend on modified packages.

Affected packages - 2 (5%)

@vercel/client
vercel

Unaffected packages - 38 (95%)

@vercel-internals/get-package-json
@vercel/backends
@vercel/build-utils
@vercel/cervel
@vercel/cli-auth
@vercel/config
@vercel/detect-agent
@vercel/edge
@vercel/elysia
@vercel/error-utils
@vercel/express
@vercel/fastify
@vercel/firewall
@vercel/frameworks
@vercel/fs-detectors
@vercel/functions
@vercel/gatsby-plugin-vercel-builder
@vercel/go
@vercel/h3
@vercel/hono
@vercel/hydrogen
@vercel/koa
@vercel/nestjs
@vercel/next
@vercel/node
@vercel/oidc
@vercel/oidc-aws-credentials-provider
@vercel/python
@vercel/python-analysis
@vercel/redwood
@vercel/related-projects
@vercel/remix-builder
@vercel/routing-utils
@vercel/ruby
@vercel/rust
@vercel/static-build
@vercel/static-config
examples

Results

Unit tests: Only affected packages will run unit tests
E2E tests: Running in parallel via E2E Tests workflow
Type checks: Only affected packages will run type checks

This comment is automatically generated based on the affected testing strategy

vercel · 2026-04-08T22:06:35Z

Low Risk — CLI feature addition for deployment checks handling with comprehensive unit tests.

packages/cli/src/commands/deploy/index.ts: added v2 checks failure handling and handleFailedCheckRuns function
packages/client/src/check-deployment-status.ts: added checks-v2-failed event emission when deployment-alias check fails
packages/cli/test/unit/commands/deploy/index.test.ts: added unit tests for v1/v2 checks failure scenarios

^{Assessed at c41ff3a.}

Made-with: Cursor

brookemosby

LGTM

This PR was opened by the [Changesets release](https://github.com/changesets/action) GitHub action. When you're ready to do a release, you can merge this and the packages will be published to npm automatically. If you're not ready to do a release yet, that's fine, whenever you add more changesets to main, this PR will be updated. # Releases ## vercel@50.43.0 ### Minor Changes - Add Deployment Checks support to `deploy --prod`. Shows "Running Checks..." spinner when checks are pending, detects check failures before alias promotion, and displays failed check run details with links to logs. ([#15884](#15884)) - Extend marketplace integration CLI parity: add `vercel integration installations` to list team installations (with optional `--integration` filter and JSON output), align `vercel integration update` argument parsing with other subcommands (parse only tokens after `update`, so the integration slug is the first positional), and ship related help/telemetry updates. ([#15849](#15849)) - Add `vercel project protection` actions for automation protection bypass via PATCH `/v1/projects/.../protection-bypass` (`--protection-bypass`). ([#15862](#15862)) - Add `vercel project protection` actions for customer support code visibility (`--customer-support-code-visibility`). ([#15860](#15860)) - Add `vercel project protection` actions for Git fork protection (`--git-fork-protection`). ([#15861](#15861)) - [services] migrate python workers to Queues V3 API ([#15885](#15885)) - [cli] Add `vercel flags override` subcommand to encrypt and decrypt flag override tokens for the `vercel-flag-overrides` cookie ([#15875](#15875)) ### Patch Changes - Persist CLI telemetry across invocations with bounded-time sessions, stable installation device IDs, and per-invocation identifiers. ([#15872](#15872)) - Update the `vercel metrics` CLI to use the V2 observability metrics API with `--metric`-based schema inspection and querying. ([#15876](#15876)) - Improve `vercel integration add` command to support fallback to the discover API and first-party integrations. ([#15788](#15788)) - refactor(cli): remove FF_AUTO_PROVISION_INSTALL feature flag and dead code from `integration add` ([#15871](#15871)) - Updated dependencies \[[`5e02289f927050a6c1025cc0edb7eda607fd5e73`](5e02289), [`2e15ee828f14de4a849a462429ca03feab161174`](2e15ee8), [`a31c84d1bda56a60da6d7bc6d611b0b18ba3bf57`](a31c84d)]: - @vercel/detect-agent@1.2.2 - @vercel/build-utils@13.14.1 - @vercel/backends@0.0.58 - @vercel/elysia@0.1.61 - @vercel/express@0.1.71 - @vercel/fastify@0.1.64 - @vercel/go@3.4.7 - @vercel/h3@0.1.70 - @vercel/hono@0.2.64 - @vercel/hydrogen@1.3.6 - @vercel/koa@0.1.44 - @vercel/nestjs@0.2.65 - @vercel/next@4.16.5 - @vercel/node@5.7.3 - @vercel/python@6.29.0 - @vercel/redwood@2.4.12 - @vercel/remix-builder@5.7.2 - @vercel/ruby@2.3.2 - @vercel/rust@1.1.0 - @vercel/static-build@2.9.11 ## @vercel/client@17.3.0 ### Minor Changes - Add Deployment Checks support to `deploy --prod`. Shows "Running Checks..." spinner when checks are pending, detects check failures before alias promotion, and displays failed check run details with links to logs. ([#15884](#15884)) ### Patch Changes - Updated dependencies \[[`2e15ee828f14de4a849a462429ca03feab161174`](2e15ee8), [`a31c84d1bda56a60da6d7bc6d611b0b18ba3bf57`](a31c84d)]: - @vercel/build-utils@13.14.1 ## @vercel/backends@0.0.58 ### Patch Changes - Updated dependencies \[[`2e15ee828f14de4a849a462429ca03feab161174`](2e15ee8), [`a31c84d1bda56a60da6d7bc6d611b0b18ba3bf57`](a31c84d)]: - @vercel/build-utils@13.14.1 ## @vercel/build-utils@13.14.1 ### Patch Changes - Restore `finalizeLambda()` to return `zipPath: null` for the default in-memory path, preserving the existing caller-facing result contract while keeping custom ZIP strategies supported. ([#15887](#15887)) - feat(node): filter non-entrypoint Node.js files in `/api` directory ([#15873](#15873)) ## @vercel/cervel@0.0.45 ### Patch Changes - Updated dependencies \[]: - @vercel/backends@0.0.58 ## @vercel/detect-agent@1.2.2 ### Patch Changes - Detect Cursor agent execution when `CURSOR_EXTENSION_HOST_ROLE=agent-exec` is set so tools launched from Cursor still report the `cursor-cli` agent when `CURSOR_AGENT` is not present. ([#15879](#15879)) ## @vercel/elysia@0.1.61 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.7.3 ## @vercel/express@0.1.71 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.7.3 - @vercel/cervel@0.0.45 ## @vercel/fastify@0.1.64 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.7.3 ## @vercel/fs-detectors@5.15.1 ### Patch Changes - feat(node): filter non-entrypoint Node.js files in `/api` directory ([#15873](#15873)) - Updated dependencies \[[`2e15ee828f14de4a849a462429ca03feab161174`](2e15ee8), [`a31c84d1bda56a60da6d7bc6d611b0b18ba3bf57`](a31c84d)]: - @vercel/build-utils@13.14.1 ## @vercel/gatsby-plugin-vercel-builder@2.1.11 ### Patch Changes - Updated dependencies \[[`2e15ee828f14de4a849a462429ca03feab161174`](2e15ee8), [`a31c84d1bda56a60da6d7bc6d611b0b18ba3bf57`](a31c84d)]: - @vercel/build-utils@13.14.1 ## @vercel/h3@0.1.70 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.7.3 ## @vercel/hono@0.2.64 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.7.3 ## @vercel/koa@0.1.44 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.7.3 ## @vercel/nestjs@0.2.65 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.7.3 ## @vercel/node@5.7.3 ### Patch Changes - Updated dependencies \[[`2e15ee828f14de4a849a462429ca03feab161174`](2e15ee8), [`a31c84d1bda56a60da6d7bc6d611b0b18ba3bf57`](a31c84d)]: - @vercel/build-utils@13.14.1 ## @vercel/static-build@2.9.11 ### Patch Changes - Updated dependencies \[]: - @vercel/gatsby-plugin-vercel-builder@2.1.11 ## @vercel/python-workers@0.0.14 ### Patch Changes - [services] migrate python workers to Queues V3 API ([#15885](#15885)) Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

codywong changed the title ~~Add v2 deployment checks handling to deploy --prod~~ [cli] Add v2 deployment checks handling to deploy --prod Apr 8, 2026

codywong force-pushed the add-v2-checks-deploy branch 2 times, most recently from dd858d2 to 1a13069 Compare April 8, 2026 21:37

vercel Bot deployed to Preview April 8, 2026 21:38 View deployment

codywong force-pushed the add-v2-checks-deploy branch from 1a13069 to 320a74f Compare April 8, 2026 21:39

vercel Bot deployed to Preview April 8, 2026 21:40 View deployment

codywong force-pushed the add-v2-checks-deploy branch from 320a74f to 31a36b0 Compare April 8, 2026 21:44

vercel Bot deployed to Preview April 8, 2026 21:45 View deployment

codywong force-pushed the add-v2-checks-deploy branch from 31a36b0 to 02dc581 Compare April 8, 2026 22:01

vercel Bot deployed to Preview April 8, 2026 22:02 View deployment

codywong force-pushed the add-v2-checks-deploy branch from 02dc581 to 5ee6975 Compare April 8, 2026 22:29

vercel Bot deployed to Preview April 8, 2026 22:30 View deployment

codywong force-pushed the add-v2-checks-deploy branch from 5ee6975 to 341e28d Compare April 8, 2026 22:31

codywong marked this pull request as ready for review April 8, 2026 22:32

codywong requested review from a team as code owners April 8, 2026 22:32

vercel Bot deployed to Preview April 8, 2026 22:32 View deployment

codywong requested review from jarneson and jeffsee55 April 8, 2026 22:32

codywong force-pushed the add-v2-checks-deploy branch from 341e28d to 835d857 Compare April 8, 2026 22:35

vercel Bot deployed to Preview April 8, 2026 22:36 View deployment

codywong force-pushed the add-v2-checks-deploy branch from 835d857 to 5dd2077 Compare April 8, 2026 22:39

vercel Bot deployed to Preview April 8, 2026 22:40 View deployment

codywong force-pushed the add-v2-checks-deploy branch from 5dd2077 to eb46f86 Compare April 8, 2026 22:46

codywong requested a review from brookemosby April 8, 2026 22:46

vercel Bot deployed to Preview April 8, 2026 22:47 View deployment

codywong force-pushed the add-v2-checks-deploy branch from eb46f86 to 42bc522 Compare April 8, 2026 22:47

codywong commented Apr 8, 2026

View reviewed changes

Comment thread packages/cli/src/commands/deploy/index.ts

vercel Bot deployed to Preview April 8, 2026 22:48 View deployment

vercel Bot reviewed Apr 8, 2026

View reviewed changes

Comment thread packages/cli/test/unit/commands/deploy/index.test.ts Outdated

Add v2 deployment checks handling to deploy --prod

c41ff3a

Made-with: Cursor

codywong force-pushed the add-v2-checks-deploy branch from 42bc522 to c41ff3a Compare April 8, 2026 23:38

vercel Bot deployed to Preview April 8, 2026 23:39 View deployment

codywong requested a review from ShayCichocki April 9, 2026 17:03

brookemosby approved these changes Apr 9, 2026

View reviewed changes

codywong merged commit 61c17f9 into main Apr 9, 2026
180 checks passed

codywong deleted the add-v2-checks-deploy branch April 9, 2026 21:38

vercel-cli-release-bot mentioned this pull request Apr 9, 2026

Version Packages #15880

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

[cli] Add v2 deployment checks handling to deploy --prod#15884

[cli] Add v2 deployment checks handling to deploy --prod#15884
codywong merged 1 commit into
mainfrom
add-v2-checks-deploy

codywong commented Apr 8, 2026 •

edited

Loading

Uh oh!

changeset-bot Bot commented Apr 8, 2026 •

edited

Loading

Uh oh!

codywong commented Apr 8, 2026

Uh oh!

github-actions Bot commented Apr 8, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Apr 8, 2026 •

edited

Loading

Uh oh!

vercel Bot commented Apr 8, 2026 •

edited

Loading

Uh oh!

Uh oh!

Uh oh!

brookemosby left a comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

codywong commented Apr 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

How success/failure paths work

Test plan

Uh oh!

changeset-bot Bot commented Apr 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦋 Changeset detected

Uh oh!

codywong commented Apr 8, 2026

Uh oh!

github-actions Bot commented Apr 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

📦 CLI Tarball Ready

Quick Test

Use in vercel.json

Python Runtime Wheel

Python Workers Wheel

Uh oh!

github-actions Bot commented Apr 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🧪 Unit Test Strategy

Results

Uh oh!

vercel Bot commented Apr 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

brookemosby left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

codywong commented Apr 8, 2026 •

edited

Loading

changeset-bot Bot commented Apr 8, 2026 •

edited

Loading

github-actions Bot commented Apr 8, 2026 •

edited

Loading

github-actions Bot commented Apr 8, 2026 •

edited

Loading

vercel Bot commented Apr 8, 2026 •

edited

Loading