import type { DimensionStatus } from './types.js';
interface FileGroup {
    label: string;
    paths: string[];
    total_bytes: number;
    age_days_min: number;
}
interface CleanupHistoryEntry {
    timestamp: string;
    bytes_freed: number;
    files_moved: number;
}
declare function appendCleanupHistory(entry: CleanupHistoryEntry): Promise<void>;
/**
 * 跑一次 file 体检 — 返 DimensionStatus + 各 group 详情 + 累计 history
 */
export declare function checkDimensionFiles(): Promise<DimensionStatus & {
    groups: FileGroup[];
    cumulative_this_month: {
        bytes: number;
        files: number;
    };
}>;
/**
 * Export for cleanup execution to record history
 */
export { appendCleanupHistory };
/**
 * 一键清 — 删 group 列出的文件 (移到 ~/.skillfm/cleanup-archive/<timestamp>/ 不真删, 7 天后真清)
 * 返 删了多少 bytes + 多少 file
 */
export declare function executeFileCleanup(groups: FileGroup[]): Promise<{
    bytes_freed: number;
    files_moved: number;
}>;
//# sourceMappingURL=dimension-3-files.d.ts.map