import type { VelocityLesson } from '../types/index.js';
export type LessonCategory = 'operational' | 'delivery' | 'estimation';
export type LessonRecord = {
    id: string;
    category: LessonCategory;
    topic: string;
    problem: string;
    cause: string;
    solution: string;
    source: {
        taskIds: string[];
        evidenceIds: string[];
        legacy?: {
            file: string;
            id: string;
        };
    };
    confidence: number;
    timestamp: string;
};
export type OperationalLesson = {
    id: string;
    operation: string;
    failedAction: string;
    errorSignature: string;
    phase: string;
    storyId: string;
    createdAt: string;
};
export type LessonHealth = {
    healthy: boolean;
    canonicalFile: string;
    sourceRecords: {
        canonical: number;
        operationalLegacy: number;
        estimationLegacy: number;
        evidence: number;
    };
    projectedRecords: number;
    duplicates: number;
    invalidRecords: number;
    migrationCandidates: number;
};
export type LessonMigrationReport = LessonHealth & {
    migrated: number;
};
export declare function canonicalLessonsPath(cwd: string): string;
export declare function addLesson(cwd: string, lesson: Omit<LessonRecord, 'id' | 'timestamp'>): LessonRecord;
export declare function addOperationalLesson(cwd: string, lesson: Omit<OperationalLesson, 'id' | 'createdAt'>): LessonRecord;
export declare function addEstimationLesson(cwd: string, lesson: VelocityLesson): LessonRecord;
export declare function listLessons(cwd: string): LessonRecord[];
export declare function searchLessons(cwd: string, keyword: string): LessonRecord[];
export declare function lessonHealth(cwd: string): LessonHealth;
export declare function migrateLegacyLessons(cwd: string): LessonMigrationReport;
export declare function relevantLessons(cwd: string, query: string, taskId?: string, limit?: number): LessonRecord[];