import type { ParsedLesson } from './drift-detector.js';
/**
 * Generate a deterministic, idempotent filename for a lesson entry.
 * Format: `lesson-<sha256(content).substring(0,8)>.md`
 */
export declare function lessonFileName(content: string): string;
/**
 * Write a formatted lesson entry to a discrete file in the lessons directory.
 * Creates the directory if missing. Returns the full path of the written file.
 */
export declare function writeLessonFile(lessonsDir: string, entry: string): string;
/**
 * Async version of writeLessonFile for the MCP server.
 */
export declare function writeLessonFileAsync(lessonsDir: string, entry: string): Promise<string>;
/**
 * Dual-read: aggregate lessons from both the legacy `.totem/lessons.md` file
 * and the new `.totem/lessons/*.md` directory. Each lesson gets a `sourcePath`
 * set to its origin file for prune operations.
 */
export declare function readAllLessons(totemDir: string, onWarn?: (msg: string) => void): ParsedLesson[];
//# sourceMappingURL=lesson-io.d.ts.map