Function runDoctor

packages/cli/src/commands/doctor-pi.ts:977–1040

(options: RunDoctorOptions = {})

}

export async function runDoctor(options: RunDoctorOptions = {}): Promise<number> {
    const deps = depsFrom(options);
    const prompts = options.prompts ?? deps.prompts;
    const cwd = options.cwd ?? process.cwd();

    if (options.help) {
        printDoctorHelp();
        return 0;
    }

    const configMigrationWarnings = migrateConfigLocationsForCli(cwd, prompts.log);

    if (options.issue) {
        return runIssueFlow({ cwd, prompts, deps });
    }

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

    prompts.intro("Magic Context for Pi Doctor");
    const first = await runHealthChecks({
        cwd,
        prompts,
        deps,
        configMigrationWarnings,
    });
    console.log("");
    prompts.log.message(`Summary: PASS ${first.pass} / WARN ${first.warn} / FAIL ${first.fail}`);

    if (options.force) {
        const fixed = repair(first.repairPlan, prompts);
        console.log("");
        prompts.log.message(
            `Repair attempted; ${fixed} item(s) changed. Re-running health checks.`,
        );
        const second = await runHealthChecks({
            cwd,
            prompts,
            deps,
            configMigrationWarnings,
        });
        console.log("");
        prompts.log.message(
            `Summary: PASS ${second.pass} / WARN ${second.warn} / FAIL ${second.fail}`,
        );
        prompts.outro(
            second.fail > 0 ? "Doctor found failures after repair" : "Doctor repair complete",
        );