Function findOnPath

packages/cli/src/lib/find-on-path.ts:32–53

(binary: string)

 * need version/feature info should do that separately.
 */
export function findOnPath(binary: string): string | null {
    const PATH = process.env.PATH;
    if (typeof PATH !== "string" || PATH.length === 0) return null;

    const isWindows = process.platform === "win32";
    const dirs = PATH.split(delimiter);

    // Windows: try common executable extensions per directory.
    // POSIX: just the bare name.
    const candidates = isWindows
        ? [`${binary}.exe`, `${binary}.cmd`, `${binary}.bat`, `${binary}.com`]
        : [binary];

    for (const dir of dirs) {
        if (!dir) continue; // empty PATH segments (rare but valid)
        for (const candidate of candidates) {
            const fullPath = join(dir, candidate);
            if (isExecutable(fullPath, isWindows)) return fullPath;
        }
    }
    return null;
}

function isExecutable(path: string, isWindows: boolean): boolean {
    try {