Function canAccessCommandCandidate

packages/cli-exec/src/lookup.ts:287–312

* PATH probing treats absent candidates as normal. Permission failures are only * useful when they explain why a local project bin was rejected.

(
  candidate: string,
  localBinSearch: LocalBinSearch,
  diagnostics: ResolutionDiagnostics
)

 * useful when they explain why a local project bin was rejected.
 */
async function canAccessCommandCandidate(
  candidate: string,
  localBinSearch: LocalBinSearch,
  diagnostics: ResolutionDiagnostics
): Promise<boolean> {
  try {
    await access(
      candidate,
      process.platform === 'win32'
        ? constants.F_OK
        : constants.F_OK | constants.X_OK
    );
    return true;
  } catch (error) {
    if (!isMissingPathError(error)) {
      await recordInaccessibleLocalBinCandidate(
        candidate,
        error,
        localBinSearch,
        diagnostics
      );
    }

    return false;
  }
}

/**
 * Preserve local-bin access failures as diagnostics. Global PATH entries keep