export type RetiredLesson = {
    heading: string;
    reason: string;
    retiredAt: string;
};
export type RetiredLessonsFile = RetiredLesson[];
export declare const RETIRED_LESSONS_FILE = "retired-lessons.json";
/**
 * Read the retirement ledger from `.totem/retired-lessons.json`.
 * Returns an empty array when the file is missing or contains malformed JSON.
 */
export declare function readRetiredLessons(totemDir: string): RetiredLesson[];
/**
 * Write the retirement ledger to `.totem/retired-lessons.json`.
 */
export declare function writeRetiredLessons(totemDir: string, entries: RetiredLesson[]): void;
/**
 * Append a retirement entry, deduplicating by heading (case-insensitive exact match).
 * If the heading already exists the entry is not duplicated.
 */
export declare function retireLesson(totemDir: string, heading: string, reason: string): void;
/**
 * Check whether a heading matches any retired entry.
 *
 * Uses exact case-insensitive matching (trimmed). Consistent with
 * retireLesson's dedup behavior. Semantic dedup handles rewording.
 */
export declare function isRetiredHeading(heading: string, retired: RetiredLesson[]): boolean;
//# sourceMappingURL=retired-lessons.d.ts.map