@vercel/cli-support 65.3.1 → 65.5.0-snapshot-13615777d933

package/dist/root-help-commands.mjs

@@ -1 +1 @@
-export const rootHelpCommands = [{"names":["deploy"],"description":"Deploy your project to Vercel","basic":true,"default":true},{"names":["activity"],"description":"List user activity events","basic":false,"default":false},{"names":["agent"],"description":"Generate an AGENTS.md file with Vercel deployment best practices","basic":false,"default":false},{"names":["agent-runs"],"description":"Inspect Agent Runs observability data","basic":false,"default":false},{"names":["ai-gateway"],"description":"Manage AI Gateway resources","basic":false,"default":false},{"names":["alerts"],"description":"List alert groups or inspect a group","basic":false,"default":false},{"names":["alias"],"description":"Interact with deployment aliases","basic":false,"default":false},{"names":["api"],"description":"Make authenticated HTTP requests to the Vercel API","basic":false,"default":false},{"names":["bisect"],"description":"Bisect the current project interactively or via an automated test script","basic":false,"default":false},{"names":["blob"],"description":"Interact with Vercel Blob","basic":false,"default":false},{"names":["budgets"],"description":"Show and manage Spend Management for on-demand charges after included credit [beta]","basic":false,"default":false},{"names":["build"],"description":"Build the project","basic":true,"default":false},{"names":["buy"],"description":"Purchase Vercel products for your team","basic":false,"default":false},{"names":["cache"],"description":"Manage cache for a Project","basic":true,"default":false},{"names":["certs"],"description":"Interact with SSL certificates","basic":false,"default":false},{"names":["changelog"],"description":"Show the latest Vercel product updates","basic":false,"default":false},{"names":["ci"],"description":"Inspect Vercel CI and rerun runs","basic":false,"default":false},{"names":["comments"],"description":"Review and act on Vercel Toolbar comments from the command line","basic":false,"default":false},{"names":["connect"],"description":"Manage connectors","basic":false,"default":false},{"names":["contract"],"description":"Show contract information for all billing periods","basic":false,"default":false},{"names":["crons"],"description":"Manage cron jobs for a project [beta]","basic":false,"default":false},{"names":["curl"],"description":"Make curl requests to Vercel deployments with automatic protection bypass","basic":false,"default":false},{"names":["daemons"],"description":"Manage daemons for a project [beta]","basic":false,"default":false},{"names":["deploy-hooks"],"description":"Manage deploy hooks for Git-triggered builds","basic":false,"default":false},{"names":["dev"],"description":"Starts the `vercel dev` server","basic":true,"default":false},{"names":["dns"],"description":"Interact with DNS entries for a project","basic":false,"default":false},{"names":["domains"],"description":"Manage domains","basic":false,"default":false},{"names":["drains"],"description":"Manage drains for logs, traces, and analytics","basic":false,"default":false},{"names":["env"],"description":"Interact with Environment Variables for a Project","basic":true,"default":false},{"names":["environments"],"description":"Manage custom environments for a Project","basic":false,"default":false},{"names":["feedback"],"description":"Send bugs, friction, and feature requests to the Vercel team","basic":false,"default":false},{"names":["firewall"],"description":"Manage your project's firewall rules, IP blocks, and system bypass configuration","basic":false,"default":false},{"names":["flags"],"description":"Manage feature flags for a Vercel project","basic":false,"default":false},{"names":["git"],"description":"Manage your Git repository connection to the current Project","basic":true,"default":false},{"names":["global-config"],"description":"Manage Global Config stores (dashboard API parity)","basic":false,"default":false},{"names":["health"],"description":"Show the current Vercel platform status and recent incidents","basic":false,"default":false},{"names":["help"],"description":"Show help for a command","basic":true,"default":false},{"names":["httpstat"],"description":"Execute httpstat with automatic deployment URL and protection bypass to visualize HTTP timing statistics","basic":false,"default":false},{"names":["init"],"description":"Initialize example Vercel Projects","basic":true,"default":false},{"names":["inspect"],"description":"Show information about a deployment","basic":true,"default":false},{"names":["install"],"description":"Install an integration from the marketplace (alias for `integration add`)","basic":true,"default":false},{"names":["integration"],"description":"Manage marketplace integrations","basic":true,"default":false},{"names":["kms"],"description":"Manage KMS issuers, signing keys, and project grants [beta]","basic":false,"default":false},{"names":["link"],"description":"Link a local directory to a Vercel project","basic":true,"default":false},{"names":["list"],"description":"List deployments","basic":true,"default":false},{"names":["login"],"description":"Sign in to your Vercel account","basic":true,"default":false},{"names":["logout"],"description":"Sign out the currently authenticated user","basic":true,"default":false},{"names":["logs"],"description":"Display logs","basic":false,"default":false},{"names":["mcp"],"description":"Set up MCP agents and configuration for Vercel integration","basic":false,"default":false},{"names":["metrics"],"description":"Query observability metrics for your Vercel project or team","basic":false,"default":false},{"names":["microfrontends"],"description":"Manage microfrontends groups that compose multiple projects into one cohesive application","basic":false,"default":false},{"names":["monitors"],"description":"Create, inspect, list, update, and delete monitors and manage their notification destinations","basic":false,"default":false},{"names":["open"],"description":"Opens the current project in the Vercel Dashboard","basic":true,"default":false},{"names":["organizations"],"description":"Manage Vercel organizations","basic":false,"default":false},{"names":["pricing"],"description":"Show Hobby, Pro, and Enterprise features from the public Vercel pricing table","basic":false,"default":false},{"names":["project"],"description":"Manage your Vercel projects","basic":false,"default":false},{"names":["promote"],"description":"Promote an existing Deployment to current","basic":true,"default":false},{"names":["pull"],"description":"Pull Environment Variables and project settings into .vercel","basic":true,"default":false},{"names":["redeploy"],"description":"Rebuild and deploy a previous deployment","basic":true,"default":false},{"names":["redirects"],"description":"Manage redirects for a project","basic":false,"default":false},{"names":["remove"],"description":"Delete deployment(s) by project name or deployment ID","basic":false,"default":false},{"names":["rollback"],"description":"Quickly revert back to a previous deployment","basic":true,"default":false},{"names":["rolling-release"],"description":"Rolling releases gradually shift traffic to a new deployment in stages, allowing you to monitor for errors before serving all traffic","basic":false,"default":false},{"names":["routes"],"description":"Manage routing rules for a project","basic":false,"default":false},{"names":["sandbox"],"description":"Interact with Vercel Sandbox","basic":false,"default":false},{"names":["schedules"],"description":"Manage schedules for the current project [beta]","basic":false,"default":false},{"names":["security"],"description":"Inspect the security posture of the current team","basic":false,"default":false},{"names":["setup"],"description":"Set up your machine for Vercel: install the Vercel plugin for Claude Code, Codex, and OpenCode and connect local coding agents to the AI Gateway","basic":false,"default":false},{"names":["signup"],"description":"Create a Vercel account and sign in","basic":true,"default":false},{"names":["skills"],"description":"Discover agent skills relevant to your project","basic":false,"default":false},{"names":["storage"],"description":"Create, connect, and manage storage resources (Blob, Global Config, Marketplace, and 1P) for your Projects","basic":false,"default":false},{"names":["switch"],"description":"Switch to a different team","basic":true,"default":false},{"names":["teams"],"description":"Manage Teams under your Vercel account","basic":false,"default":false},{"names":["telemetry"],"description":"Allows you to enable or disable telemetry collection","basic":false,"default":false},{"names":["token-pass"],"description":"Set up a coding agent with Vercel Token Pass","basic":false,"default":false},{"names":["tokens"],"description":"Manage your personal Vercel authentication tokens","basic":false,"default":false},{"names":["traces"],"description":"Fetch project traces and search spans across a Vercel team","basic":false,"default":false},{"names":["upgrade"],"description":"Upgrade the current global or native Vercel CLI installation","basic":false,"default":false},{"names":["usage"],"description":"Show billing usage and costs for the current billing cycle or a custom date range","basic":false,"default":false},{"names":["vcr"],"description":"Manage Vercel Container Registry repositories and images (see `vcr image`)","basic":false,"default":false},{"names":["version"],"description":"Manages the installed Vercel CLI version","basic":false,"default":false},{"names":["webhooks"],"description":"Manage webhooks","basic":false,"default":false},{"names":["whoami"],"description":"Shows the username of the currently logged in user","basic":false,"default":false}];
+export const rootHelpCommands = [{"names":["deploy"],"description":"Deploy your project to Vercel","group":"Deploy and Develop","default":true},{"names":["activity"],"description":"List user activity events","group":"Operations and Security","default":false},{"names":["agent"],"description":"Generate Vercel deployment guidance in AGENTS.md","group":"CLI and Integrations","default":false},{"names":["agent-runs"],"description":"Inspect Agent Runs observability data","group":"Operations and Security","default":false},{"names":["ai-gateway"],"description":"Manage AI Gateway resources","group":"Data and Compute","default":false},{"names":["alerts"],"description":"List alert groups or inspect a group","group":"Operations and Security","default":false},{"names":["alias"],"description":"Interact with deployment aliases","group":"Domains and Traffic","default":false},{"names":["api"],"description":"Make authenticated HTTP requests to the Vercel API","group":"CLI and Integrations","default":false},{"names":["bisect"],"description":"Bisect the current project interactively or via an automated test script","group":"Deploy and Develop","default":false},{"names":["blob"],"description":"Interact with Vercel Blob","group":"Data and Compute","default":false},{"names":["budgets"],"description":"Manage spending beyond included credit [beta]","group":"Account and Billing","default":false},{"names":["build"],"description":"Build the project","group":"Deploy and Develop","default":false},{"names":["buy"],"description":"Purchase Vercel products for your team","group":"Account and Billing","default":false},{"names":["cache"],"description":"Manage cache for a Project","group":"Projects and Configuration","default":false},{"names":["certs"],"description":"Interact with SSL certificates","group":"Domains and Traffic","default":false},{"names":["changelog"],"description":"Show the latest Vercel product updates","group":"CLI and Integrations","default":false},{"names":["ci"],"description":"Inspect Vercel CI and rerun runs","group":"Deploy and Develop","default":false},{"names":["comments"],"description":"Review and act on Vercel Toolbar comments from the command line","group":"Operations and Security","default":false},{"names":["connect"],"description":"Manage connectors","group":"CLI and Integrations","default":false},{"names":["contract"],"description":"Show contract information for all billing periods","group":"Account and Billing","default":false},{"names":["crons"],"description":"Manage cron jobs for a project [beta]","group":"Data and Compute","default":false},{"names":["curl"],"description":"Request deployments with protection bypass","group":"Deploy and Develop","default":false},{"names":["daemons"],"description":"Manage daemons for a project [beta]","group":"Data and Compute","default":false},{"names":["deploy-hooks"],"description":"Manage deploy hooks for Git-triggered builds","group":"Projects and Configuration","default":false},{"names":["dev"],"description":"Starts the `vercel dev` server","group":"Deploy and Develop","default":false},{"names":["dns"],"description":"Manage DNS records for your domains","group":"Domains and Traffic","default":false},{"names":["domains"],"description":"Manage domains","group":"Domains and Traffic","default":false},{"names":["drains"],"description":"Manage drains for logs, traces, analytics, and speed insights","group":"Operations and Security","default":false},{"names":["env"],"description":"Interact with Environment Variables for a Project","group":"Projects and Configuration","default":false},{"names":["environments"],"description":"Manage custom environments for a Project","group":"Projects and Configuration","default":false},{"names":["feedback"],"description":"Send bugs, friction, and feature requests to the Vercel team","group":"CLI and Integrations","default":false},{"names":["firewall"],"description":"Manage firewall rules and bypass settings","group":"Operations and Security","default":false},{"names":["flags"],"description":"Manage feature flags for a Vercel project","group":"Projects and Configuration","default":false},{"names":["git"],"description":"Manage your Git repository connection to the current Project","group":"Projects and Configuration","default":false},{"names":["global-config"],"description":"Manage Global Config stores (dashboard API parity)","group":"Data and Compute","default":false},{"names":["health"],"description":"Show the current Vercel platform status and recent incidents","group":"Operations and Security","default":false},{"names":["help"],"description":"Show help for a command","group":"CLI and Integrations","default":false},{"names":["httpstat"],"description":"Show deployment HTTP timing","group":"Deploy and Develop","default":false},{"names":["init"],"description":"Initialize example Vercel Projects","group":"Deploy and Develop","default":false},{"names":["inspect"],"description":"Show information about a deployment","group":"Deploy and Develop","default":false},{"names":["install"],"description":"Install a marketplace integration","group":"CLI and Integrations","default":false},{"names":["integration"],"description":"Manage marketplace integrations","group":"CLI and Integrations","default":false},{"names":["kms"],"description":"Manage KMS issuers, signing keys, and project grants [beta]","group":"Operations and Security","default":false},{"names":["link"],"description":"Link a local directory to a Vercel project","group":"Projects and Configuration","default":false},{"names":["list"],"description":"List deployments","group":"Deploy and Develop","default":false},{"names":["login"],"description":"Sign in to your Vercel account","group":"Account and Billing","default":false},{"names":["logout"],"description":"Sign out the currently authenticated user","group":"Account and Billing","default":false},{"names":["logs"],"description":"Display logs","group":"Operations and Security","default":false},{"names":["mcp"],"description":"Set up MCP agents for Vercel","group":"CLI and Integrations","default":false},{"names":["metrics"],"description":"Query observability metrics for your Vercel project or team","group":"Operations and Security","default":false},{"names":["microfrontends"],"description":"Manage microfrontends groups","group":"Projects and Configuration","default":false},{"names":["monitors"],"description":"Add, inspect, list, update, and remove monitors, and manage their notification destinations","group":"Operations and Security","default":false},{"names":["open"],"description":"Opens the current project in the Vercel Dashboard","group":"Projects and Configuration","default":false},{"names":["organizations"],"description":"Manage Vercel organizations","group":"Account and Billing","default":false},{"names":["pricing"],"description":"Compare public plan features","group":"Account and Billing","default":false},{"names":["project"],"description":"Manage your Vercel projects","group":"Projects and Configuration","default":false},{"names":["promote"],"description":"Promote an existing Deployment to current","group":"Deploy and Develop","default":false},{"names":["pull"],"description":"Pull Environment Variables and project settings into .vercel","group":"Projects and Configuration","default":false},{"names":["redeploy"],"description":"Rebuild and deploy a previous deployment","group":"Deploy and Develop","default":false},{"names":["redirects"],"description":"Manage redirects for a project","group":"Domains and Traffic","default":false},{"names":["remove"],"description":"Delete deployment(s) by project name or deployment ID","group":"Deploy and Develop","default":false},{"names":["rollback"],"description":"Roll back to a previous deployment","group":"Deploy and Develop","default":false},{"names":["rolling-release"],"description":"Shift deployment traffic in stages","group":"Deploy and Develop","default":false},{"names":["routes"],"description":"Manage routing rules for a project","group":"Domains and Traffic","default":false},{"names":["sandbox"],"description":"Interact with Vercel Sandbox","group":"Data and Compute","default":false},{"names":["schedules"],"description":"Manage schedules for the current project [beta]","group":"Data and Compute","default":false},{"names":["security"],"description":"Inspect the security posture of the current team","group":"Operations and Security","default":false},{"names":["setup"],"description":"Set up coding agents for Vercel","group":"CLI and Integrations","default":false},{"names":["signup"],"description":"Create a Vercel account and sign in","group":"Account and Billing","default":false},{"names":["skills"],"description":"Discover agent skills relevant to your project","group":"CLI and Integrations","default":false},{"names":["storage"],"description":"Manage project storage resources","group":"Data and Compute","default":false},{"names":["switch"],"description":"Switch to a different team","group":"Account and Billing","default":false},{"names":["teams"],"description":"Manage Teams under your Vercel account","group":"Account and Billing","default":false},{"names":["telemetry"],"description":"Allows you to enable or disable telemetry collection","group":"CLI and Integrations","default":false},{"names":["token-pass"],"description":"Set up a coding agent with Vercel Token Pass","group":"CLI and Integrations","default":false},{"names":["tokens"],"description":"Manage your personal Vercel authentication tokens","group":"Account and Billing","default":false},{"names":["traces"],"description":"Inspect project traces and search spans across a Vercel team","group":"Operations and Security","default":false},{"names":["upgrade"],"description":"Upgrade the current global or native Vercel CLI installation","group":"CLI and Integrations","default":false},{"names":["usage"],"description":"Show billing usage and costs","group":"Account and Billing","default":false},{"names":["vcr"],"description":"Manage Vercel Container Registry repositories and images (see `vcr image`)","group":"Data and Compute","default":false},{"names":["version"],"description":"Manages the installed Vercel CLI version","group":"CLI and Integrations","default":false},{"names":["webhooks"],"description":"Manage webhooks","group":"Operations and Security","default":false},{"names":["whoami"],"description":"Shows the username of the currently logged in user","group":"Account and Billing","default":false}];

package/dist/vc.js

@@ -4,23 +4,57 @@
 // https://nodejs.org/api/module.html#moduleenablecompilecachecachedir
 // enableCompileCache was added in Node.js 22.8.0, so we need to handle older versions.
 const entryAt = performance.now();
+Reflect.set(globalThis, Symbol.for('vercel.cli.entry-at'), entryAt);
+const startupTimings = process.env.VERCEL_TELEMETRY_DISABLED
+  ? undefined
+  : {
+      marks: [
+        {
+          phase: 'compile_cache',
+          timestamp: Number(process.hrtime.bigint() / BigInt(1000)),
+        },
+      ],
+    };
+Reflect.set(
+  globalThis,
+  Symbol.for('vercel.cli.startup-timings'),
+  startupTimings
+);
+function markStartup(phase) {
+  startupTimings?.marks.push({
+    phase,
+    timestamp: Number(process.hrtime.bigint() / BigInt(1000)),
+  });
+}
 try {
   const { enableCompileCache } = await import('node:module');
   if (enableCompileCache) {
     enableCompileCache();
   }
 } catch {}
+markStartup('launcher');
 
-// Spawn the installed native binary for explicit opt-ins, macOS machines, or
-// internal automatic enrollment. Explicit opt-outs always override defaults.
+// Run the one package this platform maps to: the native binary on macOS and
+// Linux x64/arm64 (downloaded once into the CLI cache when the install skipped
+// it), @vercel/cli-support everywhere else. This package's own JS CLI
+// (./index.js) is only a fallback, recorded in telemetry.
 import { spawnSync } from 'node:child_process';
-import { existsSync, statSync, writeFileSync } from 'node:fs';
-import { dirname, join, resolve } from 'node:path';
+import {
+  accessSync,
+  constants as fsConstants,
+  existsSync,
+  mkdirSync,
+  readFileSync,
+  statSync,
+  writeFileSync,
+} from 'node:fs';
+import { dirname, join, resolve, sep } from 'node:path';
 import { fileURLToPath, pathToFileURL } from 'node:url';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 
-// Keep in sync with packages/vc-native/scripts/platforms.mjs.
+// Keep in sync with packages/vc-native/scripts/platforms.mjs. Windows runs
+// only the Node CLI until its native binaries are signed.
 const NATIVE_TARGETS = [
   'darwin-arm64',
   'darwin-x64',
@@ -28,8 +62,6 @@ const NATIVE_TARGETS = [
   'linux-arm64-musl',
   'linux-x64',
   'linux-x64-musl',
-  'win32-arm64',
-  'win32-x64',
 ];
 
 // musl's `ldd` names itself. npm and pnpm skip the other libc's package via
@@ -40,103 +72,169 @@ function isMusl() {
   return `${ldd.stdout ?? ''}${ldd.stderr ?? ''}`.includes('musl');
 }
 
-function nativeTarget() {
+function platformTarget() {
   const target = `${process.platform}-${process.arch}`;
   return process.platform === 'linux' && isMusl() ? `${target}-musl` : target;
 }
 
-function resolveNative() {
-  // Already running inside the native binary — never trampoline again.
-  if (process.env.VERCEL_VC_NATIVE === '1') return null;
-  const pkgName = `@vercel/vc-native-${nativeTarget()}`;
-  const binName = process.platform === 'win32' ? 'vercel.exe' : 'vercel';
-  // Walk up from this install's own tree looking for a sibling native
-  // package. `require.resolve()` is not used because it falls back to
-  // NODE_PATH and the global folders even when `paths` is given.
+// Walk up from this install's own tree. `require.resolve()` is not used
+// because it falls back to NODE_PATH and the global folders even when `paths`
+// is given.
+function findPackage(name) {
   let dir = __dirname;
   while (true) {
-    const pkgDir = join(dir, 'node_modules', pkgName);
-    if (existsSync(join(pkgDir, 'package.json'))) {
-      const a = join(pkgDir, 'bin', binName);
-      if (existsSync(a)) return a;
-      const b = join(pkgDir, binName);
-      if (existsSync(b)) return b;
-    }
+    const pkgDir = join(dir, 'node_modules', name);
+    if (existsSync(join(pkgDir, 'package.json'))) return pkgDir;
     const parent = dirname(dir);
     if (parent === dir) return null;
     dir = parent;
   }
 }
 
-function nativeUnavailableMessage() {
-  const target = nativeTarget();
-  if (NATIVE_TARGETS.includes(target)) {
-    return (
-      `The native Vercel CLI package @vercel/vc-native-${target} is not installed. ` +
-      'Reinstall vercel without omitting optional dependencies (for example, npm i -g vercel@latest).'
-    );
+// The package this platform maps to: a native target or `cli-support`.
+function mappedTarget() {
+  const target = platformTarget();
+  return NATIVE_TARGETS.includes(target) ? target : 'cli-support';
+}
+
+function resolveTarget() {
+  const target = mappedTarget();
+  if (target === 'cli-support') {
+    const pkgDir = findPackage('@vercel/cli-support');
+    const entry = pkgDir && join(pkgDir, 'dist', 'index.js');
+    return {
+      target: 'cli-support',
+      entry: entry && existsSync(entry) && entry,
+    };
   }
-  return (
-    `Vercel CLI does not provide a native binary for ${target}. ` +
-    'Install the JavaScript CLI instead (for example, npm i -g @vercel/cli-support).'
-  );
+  const pkgDir = findPackage(`@vercel/vc-native-${target}`);
+  const bin =
+    pkgDir &&
+    [join(pkgDir, 'bin', 'vercel'), join(pkgDir, 'vercel')].find(existsSync);
+  return { target, bin };
 }
 
-// Operating systems without a native package get the same version's JS CLI
-// from @vercel/cli-support. Like resolveNative(), only search this install's
-// tree.
-function resolveCliSupport() {
-  let dir = __dirname;
-  while (true) {
-    const entry = join(
-      dir,
-      'node_modules',
-      '@vercel',
-      'cli-support',
-      'dist',
-      'index.js'
-    );
-    if (existsSync(entry)) return entry;
-    const parent = dirname(dir);
-    if (parent === dir) return null;
-    dir = parent;
+// The package this launcher belongs to: `vercel` or `@vercel/cli-support`.
+let ownPackage;
+function readOwnPackage() {
+  if (ownPackage === undefined) {
+    try {
+      ownPackage = JSON.parse(
+        readFileSync(join(__dirname, '..', 'package.json'))
+      );
+    } catch {
+      ownPackage = null;
+    }
   }
+  return ownPackage;
+}
+
+// This file also ships in @vercel/cli-support, which is its own JS CLI.
+function isCliSupport() {
+  return readOwnPackage()?.name === '@vercel/cli-support';
 }
 
-async function importJsCli() {
+// Flags that make stdout a JSON document, so stderr must stay quiet.
+function wantsJsonOutput(argv) {
+  const formatIndex = argv.indexOf('--format');
+  return (
+    argv.some(arg => arg === '--json' || arg === '--format=json') ||
+    (formatIndex !== -1 && argv[formatIndex + 1] === 'json')
+  );
+}
+
+// When the native package is missing (an install that skipped optional
+// dependencies, or one made before npm had the package), download the binary
+// for this exact version into the CLI cache, once. Each version has its own
+// directory, so a binary is written once and never replaced.
+const DOWNLOAD_RETRY_AFTER_MS = 24 * 60 * 60 * 1000;
+
+async function nativeCacheDir(target) {
+  const version = readOwnPackage()?.version;
+  if (
+    typeof version !== 'string' ||
+    !/^\d+\.\d+\.\d+(?:-[\w.-]+)?(?:\+[\w.-]+)?$/.test(version)
+  ) {
+    return null;
+  }
   try {
-    return await import('./index.js');
-  } catch (error) {
-    const cliSupport =
-      process.env.VERCEL_VC_NATIVE !== '1' &&
-      error?.code === 'ERR_MODULE_NOT_FOUND' &&
-      resolveCliSupport();
-    if (!cliSupport) throw error;
-    return import(pathToFileURL(cliSupport).href);
+    const config = await import('@vercel/cli-config/paths');
+    return {
+      version,
+      dir: join(config.getCachePath(), 'native', version, target),
+    };
+  } catch {
+    return null;
   }
 }
 
-// Read `--global-config`/`-Q` without loading the full CLI arg parser.
-function globalConfigDirFromArgv() {
-  const argv = process.argv.slice(2);
-  for (let i = 0; i < argv.length; i++) {
-    const arg = argv[i];
-    if (arg === '--global-config' || arg === '-Q') {
-      return argv[i + 1];
+async function fetchNativeBinary(target) {
+  // Only an installed package uses the download. A repository checkout
+  // (packages/cli/dist/vc.js) runs its own JS CLI, so local changes and tests
+  // never run a published binary instead.
+  if (!__dirname.split(sep).includes('node_modules')) {
+    return { reason: 'target_missing' };
+  }
+  const cache = await nativeCacheDir(target);
+  if (!cache) return { reason: 'target_missing' };
+  const bin = join(cache.dir, 'vercel');
+  if (existsSync(bin)) return { bin, source: 'cache' };
+
+  // Tests only: never reach the real registry.
+  if (process.env.__VERCEL_NATIVE_DOWNLOAD === '0') {
+    return { reason: 'target_missing' };
+  }
+  // Without a writable cache the binary has nowhere to go and a failure can't
+  // be recorded, so every run would try and warn again. Use the JS CLI quietly.
+  try {
+    mkdirSync(cache.dir, { recursive: true });
+    accessSync(cache.dir, fsConstants.W_OK);
+  } catch {
+    return { reason: 'target_missing' };
+  }
+  const failedStamp = join(cache.dir, 'download-failed');
+  try {
+    if (Date.now() - statSync(failedStamp).mtimeMs < DOWNLOAD_RETRY_AFTER_MS) {
+      return { reason: 'download_failed' };
     }
-    if (arg.startsWith('--global-config=')) {
-      return arg.slice('--global-config='.length);
+  } catch {}
+
+  const quiet = wantsJsonOutput(process.argv.slice(2));
+  try {
+    const { downloadNativeBinary } = await import('./native-download.js');
+    return {
+      bin: await downloadNativeBinary({
+        target,
+        version: cache.version,
+        directory: cache.dir,
+        log: quiet ? undefined : line => console.error(line),
+      }),
+      source: 'download',
+    };
+  } catch (error) {
+    try {
+      writeFileSync(failedStamp, '');
+    } catch {}
+    if (!quiet) {
+      const detail =
+        error?.name === 'NativeDownloadError'
+          ? error.detail
+          : 'unexpected error';
+      console.error(
+        `! Couldn't download the Vercel CLI binary (${detail}), so Node.js is running this command. The CLI tries again in 24 hours.`
+      );
     }
+    return { reason: 'download_failed' };
   }
-  return undefined;
 }
 
-// Any failure to read config counts as "not opted in".
-async function isNativeBinaryOptedIn() {
+// The native binary is the default, but this release still honors an explicit
+// opt-out: VERCEL_CLI_USE_NATIVE_BINARY, then a persisted `useNativeBinary`
+// preference. Any failure to read config counts as no preference.
+async function isNativeBinaryOptedOut() {
   const envOverride = process.env.VERCEL_CLI_USE_NATIVE_BINARY;
-  if (envOverride === '1' || envOverride === 'true') return true;
-  if (envOverride === '0' || envOverride === 'false') return false;
-
+  if (envOverride === '0' || envOverride === 'false') return true;
+  if (envOverride === '1' || envOverride === 'true') return false;
   try {
     // Zod-free subpath to avoid loading zod + schemas on this hot path.
     const config = await import('@vercel/cli-config/paths');
@@ -144,56 +242,109 @@ async function isNativeBinaryOptedIn() {
     const configDir = argDir
       ? resolve(process.cwd(), argDir)
       : config.getGlobalPathConfig();
-    const configPath = config.getConfigFilePath(configDir);
-    const preference = config.readGlobalConfigFlag(
-      configPath,
-      'useNativeBinary'
-    );
-    if (typeof preference === 'boolean') return preference;
-    // All macOS machines are opted in unless they explicitly opt out above.
-    if (process.platform === 'darwin') return true;
     return (
-      config.readGlobalConfigFlag(configPath, 'nativeBinaryAutoOptIn') === true
+      config.readGlobalConfigFlag(
+        config.getConfigFilePath(configDir),
+        'useNativeBinary'
+      ) === false
     );
   } catch {
     return false;
   }
 }
 
-// Keep the opt-out escape hatch in Node even when the native binary cannot
-// start. The full CLI parser still validates the command and its arguments.
-const disableBinary = process.argv.slice(2).includes('--disable-binary');
-const nativeBin = resolveNative();
-const bin = disableBinary ? null : nativeBin;
+// When the OS cannot start the binary at all, no command code has run, so
+// Node.js can safely run the command instead.
+const NATIVE_SPAWN_FALLBACK_CODES = ['ENOENT', 'EACCES', 'ENOEXEC'];
 
-// Internal worker arguments intentionally trampoline too. The packaged native
-// binary sets VERCEL_VC_NATIVE=1 in pkg.js and re-enters this file, where
-// resolveNative() returns null and the worker branch below handles the request.
-if (bin && (await isNativeBinaryOptedIn())) {
-  process.env.VERCEL_VC_NATIVE = '1';
-  // Do not fall through to JS on spawn/loader failures — surface them so
-  // native binary issues (e.g. glibc mismatch) are visible.
-  const r = spawnSync(bin, process.argv.slice(2), {
-    stdio: 'inherit',
-    windowsHide: true,
-    env: {
-      ...process.env,
-      // Upgrades belong to the vercel package, not its native runtime dependency.
-      // Always replace an inherited value with this launcher's own entrypoint.
-      VERCEL_CLI_PACKAGE_ENTRYPOINT: fileURLToPath(import.meta.url),
-      VERCEL_CLI_PACKAGE_EXECUTABLE: bin,
-    },
-  });
-  if (r.error) {
-    console.error(r.error.message);
-    process.exit(1);
+// Read by src/index.ts and reported in telemetry. Inside the native binary,
+// pkg.js sets it to `native` before re-entering this file with
+// VERCEL_VC_NATIVE=1.
+const LAUNCH = Symbol.for('vercel.cli.launch');
+let launch;
+let cliSupportEntry;
+if (process.env.VERCEL_VC_NATIVE === '1') {
+  if (globalThis[LAUNCH]?.runtime !== 'native') {
+    // Not the native binary: a process it spawned (a build script, a dev
+    // command) inherited VERCEL_VC_NATIVE=1 and ran this package's JS CLI.
+    launch = {
+      runtime: 'dist',
+      target: mappedTarget(),
+      reason: 'inherited_native_env',
+    };
+    globalThis[LAUNCH] = launch;
   }
-  if (r.signal) {
-    try {
-      process.kill(process.pid, r.signal);
-    } catch {}
+} else {
+  const resolved = resolveTarget();
+  let optedOut = false;
+  let missingReason = 'target_missing';
+  if (resolved.bin) {
+    optedOut = await isNativeBinaryOptedOut();
+  } else if (resolved.target !== 'cli-support' && !isCliSupport()) {
+    // Never download for an opted-out user or for @vercel/cli-support (the
+    // build container runs it on Linux).
+    optedOut = await isNativeBinaryOptedOut();
+    if (!optedOut) {
+      const fetched = await fetchNativeBinary(resolved.target);
+      resolved.bin = fetched.bin;
+      resolved.source = fetched.source;
+      missingReason = fetched.reason ?? missingReason;
+    }
   }
-  process.exit(r.status ?? 1);
+  if (optedOut) {
+    launch = { runtime: 'dist', target: resolved.target, reason: 'opt_out' };
+  } else if (resolved.bin) {
+    // Internal worker arguments intentionally trampoline too. The packaged
+    // native binary sets VERCEL_VC_NATIVE=1 in pkg.js and re-enters this file,
+    // where the worker branch below handles the request.
+    const r = spawnSync(resolved.bin, process.argv.slice(2), {
+      stdio: 'inherit',
+      windowsHide: true,
+      env: {
+        ...process.env,
+        VERCEL_VC_NATIVE: '1',
+        // Upgrades belong to the vercel package, not its native runtime
+        // dependency. Always replace an inherited value with this launcher's
+        // own entrypoint.
+        VERCEL_CLI_PACKAGE_ENTRYPOINT: fileURLToPath(import.meta.url),
+        VERCEL_CLI_PACKAGE_EXECUTABLE: resolved.bin,
+        // Reported in telemetry. pkg.js reads it and removes it, so the
+        // binary's child processes don't inherit it.
+        ...(resolved.source && {
+          __VERCEL_CLI_NATIVE_SOURCE: resolved.source,
+        }),
+      },
+    });
+    // Never fall back on an exit status: a loader failure (e.g. glibc
+    // mismatch) and a command's own failure are indistinguishable, and
+    // retrying a command in Node.js could repeat remote mutations.
+    if (!(r.error && NATIVE_SPAWN_FALLBACK_CODES.includes(r.error.code))) {
+      if (r.error) {
+        console.error(r.error.message);
+        process.exit(1);
+      }
+      if (r.signal) {
+        try {
+          process.kill(process.pid, r.signal);
+        } catch {}
+      }
+      process.exit(r.status ?? 1);
+    }
+    console.error(
+      `! The native Vercel CLI binary could not start (${r.error.code}), so Node.js is running this command.`
+    );
+    launch = { runtime: 'dist', target: resolved.target, reason: r.error.code };
+  } else if (resolved.entry || isCliSupport()) {
+    launch = { runtime: 'cli-support' };
+  } else {
+    launch = {
+      runtime: 'dist',
+      target: resolved.target,
+      reason: missingReason,
+    };
+  }
+  globalThis[LAUNCH] = launch;
+  cliSupportEntry = resolved.entry;
 }
 
 if (process.argv[2] === '--internal-build-worker') {
@@ -216,6 +367,10 @@ if (process.argv[2] === '--internal-build-worker') {
       ),
     { report }
   );
+  // A prewarmed worker idles until its request arrives; start startup
+  // telemetry from the handoff instead of process entry.
+  Reflect.set(globalThis, Symbol.for('vercel.cli.entry-at'), performance.now());
+  startupTimings?.marks.splice(0);
   globalThis[Symbol.for('vercel.cli.fatal-error-handler')] = error =>
     handoff.error(error);
 
@@ -239,28 +394,37 @@ if (process.argv[2] === '--internal-build-worker') {
   process.exit(process.exitCode ?? 0);
 }
 
-// Linux and Windows on anything but x64/arm64 have no native binary, and will
-// lose the JS CLI from `vercel` itself in a future release.
+// Read `--global-config`/`-Q` without loading the full CLI arg parser.
+function globalConfigDirFromArgv() {
+  const argv = process.argv.slice(2);
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    if (arg === '--global-config' || arg === '-Q') {
+      return argv[i + 1];
+    }
+    if (arg.startsWith('--global-config=')) {
+      return arg.slice('--global-config='.length);
+    }
+  }
+  return undefined;
+}
+
+// Linux on anything but x64/arm64 has no native binary, and will lose the JS
+// CLI from `vercel` itself in a future release.
 async function warnDeprecatedArch() {
   if (
-    !['linux', 'win32'].includes(process.platform) ||
+    process.platform !== 'linux' ||
     ['x64', 'arm64'].includes(process.arch) ||
     process.env.VERCEL_VC_NATIVE === '1'
   ) {
     return;
   }
   const argv = process.argv.slice(2);
-  const formatIndex = argv.indexOf('--format');
   if (
     argv.some(arg =>
-      [
-        '--non-interactive',
-        '--non-interactive=true',
-        '--json',
-        '--format=json',
-      ].includes(arg)
+      ['--non-interactive', '--non-interactive=true'].includes(arg)
     ) ||
-    (formatIndex !== -1 && argv[formatIndex + 1] === 'json')
+    wantsJsonOutput(argv)
   ) {
     return;
   }
@@ -278,14 +442,8 @@ async function warnDeprecatedArch() {
   } catch {}
   const target = `${process.platform}-${process.arch}`;
   console.error(
-    `! Support for ${target} will be removed from the vercel package in a future release. ` +
-      'npm i -g @vercel/cli-support will keep working.'
+    `! Support for ${target} will be removed from the vercel package in a future release.`
   );
-  if (target === 'win32-ia32') {
-    console.error(
-      '  If this is a 64-bit PC, install 64-bit Node.js and reinstall vercel instead.'
-    );
-  }
   if (stamp) {
     try {
       writeFileSync(stamp, '');
@@ -337,17 +495,25 @@ if (
   }
 }
 
+markStartup('dependencies');
 try {
-  await importJsCli();
+  await (cliSupportEntry
+    ? import(pathToFileURL(cliSupportEntry).href)
+    : import('./index.js'));
 } catch (error) {
-  // Without a native binary the JS CLI is the only option; if its
-  // dependencies are not installed either, name the missing package.
+  // The mapped package is missing and this package's own JS CLI cannot load
+  // either, so name the package to install.
   if (
-    !nativeBin &&
-    process.env.VERCEL_VC_NATIVE !== '1' &&
+    launch?.reason === 'target_missing' &&
     error?.code === 'ERR_MODULE_NOT_FOUND'
   ) {
-    console.error(`Error: ${nativeUnavailableMessage()}`);
+    const pkg =
+      launch.target === 'cli-support'
+        ? '@vercel/cli-support'
+        : `@vercel/vc-native-${launch.target}`;
+    console.error(
+      `Error: ${pkg} is not installed. Reinstall vercel without omitting optional dependencies (for example, npm i -g vercel@latest).`
+    );
     console.error(error.message);
     process.exit(1);
   }

package/dist/version.mjs

@@ -1,2 +1,2 @@
-export const version = "65.3.1";
+export const version = "65.5.0-snapshot-13615777d933";
 export const buildLabel = "";