export interface DoctorOptions {
    /** When true, delete stale session-scoped state files instead of just
     *  reporting bloat. Triggered by `forgen doctor --prune-state`. */
    pruneState?: boolean;
    /**
     * When true, auto-fix recoverable failures (e.g. missing plugin cache /
     * stale installPath) by running `node scripts/postinstall.js` inside the
     * forgen install directory (`npm run build` 는 dist 부재 시에만 — W1-4).
     * Triggered by `forgen doctor --repair`.
     *
     * v0.4.8 (E3) — 이전엔 안내문만 출력. fail-open: repair 실패해도 doctor
     * 흐름은 정상 종료. W1-4 (ADR-010) — 실행 사실이 아니라 재검증 결과를 보고.
     */
    repair?: boolean;
    /** When true, run only essential checks (Tools + Plugins + Directories +
     *  Initialization Status) for fast onboarding verification. ~10 lines output. */
    quick?: boolean;
    /** W1-1 (ADR-010): tenetx/legacy 규칙 스프롤 스캔 (dry-run — 삭제는
     *  `forgen migrate tenetx` 가 수행). native /doctor 가 비용을 flag 하면
     *  forgen 이 provenance 로 안전하게 회수하는 보완 관계. */
    reclaim?: boolean;
    /** W2-1 (ADR-010): hook timing 표 등 상세 진단 표시. slow-hook 감지는
     *  native /doctor 영역이라 기본 출력에서 강등됨 (수집은 유지). */
    verbose?: boolean;
}
/** plugin cache 디렉토리에 버전 엔트리가 하나 이상 있는가 (check + repair 재검증 공용) */
export declare function pluginCacheOk(): boolean;
/** installed_plugins.json 의 forgen entry 가 존재하며 installPath 가 살아있는가 */
export declare function pluginRegisteredOk(): boolean;
export declare function runDoctor(opts?: DoctorOptions): Promise<void>;