/**
 * Analyze repository metrics at a specific git ref point.
 * Used by git_release_comparison to compare snapshots at two different refs.
 */
import type { FileHotspot } from "../git/types.js";
export interface RefMetrics {
    hotspotCount: number;
    totalChurn: number;
    activeContributors: number;
    avgBusFactor: number;
    topHotspots: FileHotspot[];
}
export interface RefAnalysisOptions {
    maxCommits?: number;
    pathPattern?: string;
    timeoutMs?: number;
}
/**
 * Measure repository metrics as of a specific ref (tag/branch/commit).
 *
 * Uses `--until=<ref-date>` to scope analysis to everything up to that ref's timestamp.
 */
export declare function analyzeAtRef(repoPath: string, ref: string, options?: RefAnalysisOptions): Promise<RefMetrics>;