/**
 * Initializes the file logger. Creates the log file if it does not exist. Must be called after the data directory is ensured to exist.
 * @param logPath - Absolute path to the log file, resolved by the caller via getLogFilePath().
 * @param maxSize - Maximum log file size in bytes from CONFIG.logging.maxSize.
 */
export declare function initializeFileLogger(logPath: string, maxSize: number): Promise<void>;
/**
 * Writes a log entry to the buffer. Entries are flushed to disk periodically.
 * @param level - Log level ("info", "warn", "error", "debug").
 * @param message - The formatted log message.
 * @param color - Optional ANSI color code to apply to the level prefix and message.
 * @param categoryTag - Optional debug category tag (e.g., "recovery:tab"). Appended to the level prefix as [DEBUG:category].
 */
export declare function writeLogEntry(level: string, message: string, color?: string, categoryTag?: string): void;
/**
 * Flushes the write buffer to disk asynchronously. Called periodically by the flush timer.
 */
export declare function flushLogBuffer(): Promise<void>;
/**
 * Flushes the write buffer to disk synchronously. Used during shutdown to ensure final logs are written.
 */
export declare function flushLogBufferSync(): void;
/**
 * Shuts down the file logger, flushing any remaining buffer synchronously.
 */
export declare function shutdownFileLogger(): void;