Function runClear

packages/cli/src/commands/doctor.ts:95–164

* Interactive cache-clear flow. Presents one combined picker showing * cleanable caches across every installed harness with their current * sizes; the user selects which to clear.

()

 * sizes; the user selects which to clear.
 */
async function runClear(): Promise<number> {
    intro("Magic Context — Clear caches");

    const installed = getInstalledAdapters();
    if (installed.length === 0) {
        log.warn("No installed harnesses detected. Nothing to clear.");
        outro("Done.");
        return 0;
    }

    const items: { adapter: HarnessAdapter; path: string; sizeBytes: number }[] = [];
    for (const adapter of installed) {
        const cache = adapter.getPluginCacheInfo();
        if (cache.path && cache.exists) {
            items.push({ adapter, path: cache.path, sizeBytes: cache.sizeBytes });
        }
    }

    if (items.length === 0) {
        log.info("No clearable plugin caches found across installed harnesses.");
        outro("Done.");
        return 0;
    }

    const picks = await selectMany(
        "Select caches to clear:",
        items.map((item, idx) => ({
            label: `${item.adapter.displayName}: ${formatSize(item.sizeBytes)} — ${item.path}`,
            value: String(idx),
        })),
    );

    if (picks.length === 0) {
        log.info("Nothing selected. Done.");
        outro("Done.");
        return 0;
    }

    const confirmed = await confirm(
        `Delete ${picks.length} cache director${picks.length === 1 ? "y" : "ies"}? This is irreversible.`,
        false,
    );
    if (!confirmed) {
        log.info("Cancelled.");
        outro("Done.");
        return 0;
    }

    let failed = 0;
    for (const idxStr of picks) {
        const idx = Number.parseInt(idxStr, 10);
        const item = items[idx];
        if (!item) continue;
        const s = spinner();
        s.start(`Clearing ${item.path}`);
        try {
            if (existsSync(item.path)) {
                rmSync(item.path, { recursive: true, force: true });