import type { FlakeHistoryReport, ProjectScanSummary, ScanHistoryEntry, ScanHistoryFile, ScanHistorySummary } from "../types/guardrail.types.js";
/** Oldest entries are dropped once the history file holds this many scans. */
export declare const MAX_HISTORY_ENTRIES = 100;
/** Read a history file. A missing file yields an empty history; a malformed one throws. */
export declare function readHistory(historyPath: string): ScanHistoryFile;
export declare function toHistoryEntry(summary: ProjectScanSummary): ScanHistoryEntry;
/**
 * Append a scan to the history file and return how it compares to the previous scan.
 * The file and its parent directories are created when missing.
 */
export declare function recordScan(historyPath: string, summary: ProjectScanSummary): ScanHistorySummary;
export interface HistoryReportOptions {
    /** Restrict the per-file series to this project-relative file path. */
    file?: string;
    /** Maximum number of most recent scans to include. */
    limit?: number;
}
/** Build a time series of project-wide scores, optionally with a per-file series. */
export declare function summarizeHistory(historyPath: string, options?: HistoryReportOptions): FlakeHistoryReport;
//# sourceMappingURL=scanHistory.d.ts.map