Function runDoctor

packages/cli/src/commands/doctor.ts:33–68

(options: RunDoctorOptions)

}

export async function runDoctor(options: RunDoctorOptions): Promise<number> {
    if (options.clear) return runClear();

    const argv = options.argv ?? [];
    const adapters = await resolveAdaptersForCommand(argv, {
        allowMulti: true,
        verb: "diagnose",
    });

    if (adapters.length === 0) {
        log.warn("No harness selected.");
        return 0;
    }

    // The v22 backfill commands operate on the SHARED cortexkit DB (harness-
    // agnostic — there is no per-harness shard for backfill state). Run them
    // exactly ONCE here, not once per adapter: dispatching to both an OpenCode
    // and a Pi adapter would run the same rekey/retry/check against the same
    // physical DB twice, producing confusing doubled output (e.g. the second
    // pass reports "Re-keyed 0 row(s)" because the first already moved them).
    if (hasV22Command(options)) {
        const result = await runV22BackfillCommands(
            { name: "Magic Context", openDatabase, closeDatabase, log },
            options,
        );
        if (result.handled) return result.exitCode;
    }

    let anyFailure = false;
    for (const adapter of adapters) {
        log.step(`Running doctor for ${adapter.displayName}…`);
        const code = await dispatchDoctor(adapter, options);
        if (code !== 0) anyFailure = true;
    }
    return anyFailure ? 1 : 0;
}

async function dispatchDoctor(adapter: HarnessAdapter, options: RunDoctorOptions): Promise<number> {
    switch (adapter.kind) {