Function runDoctor

packages/cli/src/commands/doctor-opencode.ts:486–1230

(
    options: { force?: boolean; issue?: boolean } & V22BackfillCommandArgs = {},
)

// ── Main doctor entry ───────────────────────────────────────────────

export async function runDoctor(
    options: { force?: boolean; issue?: boolean } & V22BackfillCommandArgs = {},
): Promise<number> {
    migrateConfigLocationsForCli(process.cwd(), log);

    if (options.issue) {
        return runIssueFlow();
    }

    const v22Result = await runV22BackfillCommands(
        {
            name: "OpenCode",
            openDatabase,
            closeDatabase,
            log,
        },
        options,
    );
    if (v22Result.handled) {
        return v22Result.exitCode;
    }

    intro("Magic Context Doctor");

    let issues = 0;
    let fixed = 0;
    // Aligned with Pi doctor: emit a PASS/WARN/FAIL summary at the end so
    // results are scannable.
    let passCount = 0;
    let warnCount = 0;
    let failCount = 0;
    const pass = (msg: string) => {
        log.success(msg);
        passCount++;
    };
    const warn = (msg: string) => {
        log.warn(msg);
        warnCount++;
    };
    const fail = (msg: string) => {
        log.error(msg);
        failCount++;
        issues++;
    };

    // 1. Check OpenCode is installed
    const detection = detectOpenCode();
    if (detection.kind === "none") {
        fail("OpenCode is not installed or not in PATH");
        // Help users whose binary IS on PATH but is shadowed by a wrapper
        // script or lives in a directory not searched by our detection
        // (e.g. tool-version shims that only inject PATH at shell time).
        log.info("Doctor checked ~/.opencode/bin/opencode and each entry in $PATH.");
        log.info(
            "If `which opencode` succeeds outside doctor, your wrapper or shim may not be readable by Node — please share that wrapper in the issue.",
        );
        outro("Doctor failed — install OpenCode first");
        return 1;