export interface DoctorOptions {
    projectRoot: string;
    fix: boolean;
    fixDryRun?: boolean;
}
/**
 * Run diagnostics for a project and optionally preview or apply automatic fixes.
 *
 * Performs filesystem and configuration checks, collects errors and warnings, validates generated
 * and managed configs, inspects MCP state and integrations, and reports issues/actions. When
 * requested, it will preview proposed fixes or apply them (untracking git paths, setting Codex
 * trust, and running `agents sync`).
 *
 * @param options - Doctor command options (must include `projectRoot`; may include `fix` and `fixDryRun` to control applying or previewing fixes)
 * @throws Error - If both `options.fix` and `options.fixDryRun` are enabled simultaneously
 */
export declare function runDoctor(options: DoctorOptions): Promise<void>;