import type { LessonRecord, LessonScope, RcaCause } from '@enterprise-skills/orchestrator';
export declare function lessonsRecordCommand(options: {
    title?: string;
    defect?: string;
    cause?: string[];
    action?: string;
    scope?: string;
    execution?: string;
    json?: boolean;
}): Promise<void>;
export declare function lessonsListCommand(options: {
    status?: string;
    scope?: string;
    json?: boolean;
}): Promise<void>;
/**
 * The read-back half of institutional learning.
 *
 * `LessonStore` recorded lessons, gated them behind an explicit approval, and
 * attributed that approval — and then nothing read them. The only consumers
 * were the four CLI verbs and four pass-throughs on `Orchestrator`;
 * `session-start` did not load them, the context gateway did not, no skill
 * referenced them. Two lessons sat approved on this machine and changed no
 * agent's behaviour, which makes the approval gate a filing decision rather
 * than a governance one.
 *
 * This is a distinct command rather than a flag on `list` because the two
 * answer different questions. `list` is for a human triaging the store, so it
 * shows every status. This is for a session deciding what it must KNOW, so it
 * shows approved lessons only — an unapproved lesson is by construction not yet
 * institutional knowledge, and loading one would make the gate meaningless.
 *
 * Bounded work reports itself, like the probe inventory: the brief states how
 * many lessons it covers, and says so when a cap truncated it or when proposed
 * lessons are waiting. A brief that silently showed half the knowledge would be
 * the same dishonesty as a partial scan that reads as a complete one.
 */
export declare const LESSON_BRIEF_DEFAULT_LIMIT = 25;
export interface LessonBrief {
    generated_at: string;
    /** Approved lessons, ordered and capped — what the session must know. */
    lessons: Array<{
        id: string;
        title: string;
        scope: LessonScope;
        root_causes: RcaCause[];
        corrective_action: string;
        approved_by?: string;
    }>;
    coverage: {
        approved_total: number;
        shown: number;
        truncated: boolean;
        /** Recorded but not yet approved — knowledge that exists and is NOT loaded. */
        proposed_pending: number;
        notes: string[];
    };
}
export declare function buildLessonBrief(records: LessonRecord[], limit?: number): LessonBrief;
export declare function lessonsBriefCommand(options: {
    limit?: string;
    json?: boolean;
    cwd?: string;
}): Promise<void>;
export declare function lessonsApproveCommand(id: string, options: {
    by?: string;
    json?: boolean;
}): Promise<void>;
export declare function lessonsRejectCommand(id: string, options: {
    by?: string;
    reason?: string;
    json?: boolean;
}): Promise<void>;
//# sourceMappingURL=lessons.d.ts.map