export interface FileHotspot {
    file: string;
    commits: number;
    lines_changed: number;
    symbol_count: number;
    churn_score: number;
    hotspot_score: number;
}
export interface HotspotResult {
    hotspots: FileHotspot[];
    period: string;
    total_files: number;
    total_commits: number;
    /**
     * Diagnostic note populated only when the result is empty or degraded.
     * Audit skills should surface this in their Tool Availability Block as
     * `EMPTY-RESULT (<note>)` instead of silently treating it as "no hotspots".
     */
    note?: string;
}
/**
 * Analyze git churn hotspots: files with high change frequency × complexity.
 * Higher hotspot_score = more likely to contain bugs and need refactoring.
 */
export declare function analyzeHotspots(repo: string, options?: {
    since_days?: number | undefined;
    top_n?: number | undefined;
    file_pattern?: string | undefined;
}): Promise<HotspotResult>;
//# sourceMappingURL=hotspot-tools.d.ts.map