Function probeOne

extensions/java-modernization-studio/doctor.mjs:193–213

(def, exec)

/** Probe a single tool. Returns { key, found, version }. */
export async function probeOne(def, exec) {
    const run = exec || defaultExec;
    let r;
    try {
        r = await run(def.cmd, def.args);
    } catch (e) {
        r = { error: e, stdout: "", stderr: "" };
    }
    const text = ((r.stdout || "") + "\n" + (r.stderr || "")).trim();
    // ENOENT means the binary isn't on PATH at all.
    if (r.error && r.error.code === "ENOENT") return { key: def.key, found: false, version: null };
    if (r.error && !text) return { key: def.key, found: false, version: null };
    const version = parseToolVersion(def.key, text);
    if (r.error) {
        // Non-zero exit. Genuine `--version` calls exit 0, so only trust this if a
        // real version number came back. This rejects the macOS `java` stub, which
        // exits 1 with "Unable to locate a Java Runtime" when no JDK is installed.
        if (!(version && /\d/.test(version))) return { key: def.key, found: false, version: null };
    }
    return { key: def.key, found: true, version };
}

/** Probe every tool and build the readiness report. Impure (spawns processes). */
export async function runDoctor(scan, opts = {}) {