import type { ReviewFinding, DebtItem } from "../../types/index.js";
/**
 * 技术债务追踪器 — 负责债务的增删改查、统计聚合与过期清理。
 * 债务数据存储在 `{projectPath}/.soloforge/state/debt/` 目录下。
 */
export declare class DebtTracker {
    private debtDir;
    /**
     * 初始化债务追踪器。
     * @param projectPath - 项目根目录路径
     */
    constructor(projectPath: string);
    /** 确保债务存储目录存在，不存在则递归创建 */
    ensureDir(): Promise<void>;
    /**
     * 将代码审查发现记录为一条新的技术债务。
     * 使用原子写入（先写临时文件再 rename）保证数据一致性。
     * @param finding - 代码审查发现结果
     * @param taskId - 关联的任务 ID
     * @returns 新创建的债务条目 ID
     */
    recordDebt(finding: ReviewFinding, taskId: string): Promise<string>;
    /**
     * 列出所有状态为 open 的债务条目，按发现时间升序排列。
     * @returns 未解决的债务条目列表
     */
    listOpen(): Promise<DebtItem[]>;
    /** 将指定债务标记为「已确认」（acknowledged）。
     * @param debtId - 债务条目 ID
     */
    acknowledge(debtId: string): Promise<void>;
    /** 将指定债务标记为「已解决」（resolved），同时记录解决时间。
     * @param debtId - 债务条目 ID
     */
    resolve(debtId: string): Promise<void>;
    /**
     * 按债务类别统计未解决的条目数量。
     * @returns 以类别名为键、数量为值的统计对象
     */
    getStats(): Promise<Record<string, number>>;
    /**
     * 计算指定天数内债务的增减趋势。
     * @param sinceDays - 统计回溯天数
     * @returns 包含新增数（created）、已解决数（resolved）和净增量（net）的趋势数据
     */
    getTrend(sinceDays: number): Promise<{
        created: number;
        resolved: number;
        net: number;
    }>;
    /**
     * 按优先级对未解决债务排序。优先级 = 严重程度分 x 影响程度分。
     * severity: critical=4, warning=3, info=1
     * impact: high=3, medium=2, low=1
     * @returns 按优先级降序排列的债务列表（最高优先在前）
     */
    prioritize(): Promise<DebtItem[]>;
    /**
     * 清理已过期且已解决的债务条目。
     * 超过 MAX_DEBT_AGE_DAYS（30 天）的已解决条目将被删除。
     * @returns 本次清理删除的条目数量
     */
    cleanup(): Promise<number>;
    /**
     * 更新指定债务条目的状态。使用原子写入保证数据一致性。
     * @param debtId - 债务条目 ID
     * @param status - 新状态（acknowledged 或 resolved）
     * @param resolvedAt - 解决时间（仅当 status 为 resolved 时有效）
     */
    private updateStatus;
}
//# sourceMappingURL=debt_tracker.d.ts.map