Function resolveCliInvocation

packages/cli-exec/src/lookup.ts:179–225

* Resolves the CLI invocation from local bins first, then the provided PATH.

(
  cwd: string,
  pathValue: string
)

 * Resolves the CLI invocation from local bins first, then the provided PATH.
 */
async function resolveCliInvocation(
  cwd: string,
  pathValue: string
): Promise<VercelCliResolution> {
  const localBinSearch = await getLocalBinSearch(cwd);
  const diagnostics: ResolutionDiagnostics = {
    localBinSearch: localBinSearch.diagnostics,
    skippedLocalBins: [],
  };
  const resolvedPath = prependPathEntries(
    pathValue,
    localBinSearch.directories
  );

  for (const command of getVercelCommandNames()) {
    const resolvedCommand = await findCommandInPath(
      command,
      resolvedPath,
      cwd,
      localBinSearch,
      diagnostics
    );
    if (!resolvedCommand) {
      continue;
    }

    if (isNodeScript(resolvedCommand.realPath)) {
      return {
        found: true,
        command: process.execPath,
        commandArgs: [resolvedCommand.realPath],
        source: resolvedCommand.source,
        diagnostics,
      };
    }

    return {
      found: true,
      command: resolvedCommand.realPath,
      commandArgs: [],
      source: resolvedCommand.source,
      diagnostics,
    };
  }

  return { found: false, diagnostics };
}

/**
 * Resolves the first usable command from PATH, validating local bins specially.