import type { DoctorOptions, DoctorReport, SkillsRefreshResult } from './types.js';
/**
 * Skills `--fix` is allowed to refresh. Hardcoded — NOT derived from
 * discoverSkills — so future bundled skills require an explicit opt-in here
 * before doctor will write to their target directory. This is the contract's
 * promise that `--fix` only ever touches `workos/` and `workos-widgets/`.
 */
export declare const FIXABLE_SKILLS: readonly ["workos", "workos-widgets"];
/**
 * Refresh stale WorkOS skills if `--fix` is set and at least one agent is
 * stale or has no marker. Always re-reads `checkSkills()` after a successful
 * refresh so detectIssues sees the post-refresh state and we don't ship a
 * doctor report that simultaneously claims "fixed" and "still stale".
 *
 * Extracted from runDoctor for unit testability — runDoctor itself depends on
 * eight upstream checks that are expensive to mock.
 */
export declare function maybeRefreshSkills(options: Pick<DoctorOptions, 'fix'>, skills: DoctorReport['skills']): Promise<{
    skillsRefresh?: SkillsRefreshResult;
    skills: DoctorReport['skills'];
}>;
export declare function runDoctor(options: DoctorOptions): Promise<DoctorReport>;
export declare function outputReport(report: DoctorReport, options: DoctorOptions): Promise<void>;
export { formatReport } from './output.js';
export { formatReportAsJson } from './json-output.js';
export type { DoctorReport, DoctorOptions } from './types.js';