Function runHealthChecks

packages/cli/src/commands/doctor-pi.ts:399–808

(options: {
    cwd: string;
    prompts: PromptIO;
    deps: DoctorDeps;
    quiet?: boolean;
    configMigrationWarnings?: readonly string[];
})

}

async function runHealthChecks(options: {
    cwd: string;
    prompts: PromptIO;
    deps: DoctorDeps;
    quiet?: boolean;
    configMigrationWarnings?: readonly string[];
}): Promise<HealthReport> {
    const results: CheckResult[] = [];
    const userConfigMigrationRefused = hasUserConfigLocationMigrationRefusal(
        options.configMigrationWarnings ?? [],
    );
    const repairPlan: RepairPlan = {
        addPackageEntry: false,
        writeUserConfig: false,
        clearCachePaths: [],
    };
    const self = selfVersion();

    const pi = options.deps.detectPiBinary();
    if (!pi) {
        add(results, "fail", "Pi binary not found on PATH or at ~/.pi/bin/pi");
    } else {
        const version = options.deps.getPiVersion(pi.path);
        add(
            results,
            "pass",
            version ? `Pi ${version} detected at ${pi.path}` : `Pi detected at ${pi.path}`,
        );
        const compare = compareSemver(version, MIN_PI_VERSION);
        if (compare !== null && compare < 0) {
            add(
                results,
                "fail",
                `Pi ${version} is older than required ${MIN_PI_VERSION}. Subagents (historian/dreamer/sidekick) use the long-form \`--extension\` flag introduced in Pi 0.71.0; older versions hard-fail with "Unknown option". Run \`pi update\` (or \`npm install -g @earendil-works/pi-coding-agent@latest\`).`,
            );
        } else if (version) {
            add(results, "pass", `Pi version meets minimum ${MIN_PI_VERSION} requirement`);
        }
    }

    const latest = options.deps.getLatestNpmVersion();
    if (latest && compareSemver(self, latest) === -1) {
        add(
            results,
            "warn",
            `Magic Context for Pi CLI v${self} is older than npm latest v${latest}`,
        );
    } else if (latest) {
        add(
            results,
            "pass",
            `Magic Context for Pi CLI v${self} is current (npm latest v${latest})`,
        );
    } else {
        add(results, "info", `Magic Context for Pi CLI v${self}; npm latest check unavailable`);
    }

    const settingsPath = getPiUserExtensionsPath();