The Logger (lib/logger.ts) is a production-grade async logging system that intercepts all console output and writes it to persistent daily log files on disk.
The installPolyfill() method replaces console.log, console.warn, and console.error with interceptors that both call the original console method and queue the log entry for disk persistence:
Logger.installPolyfill(); // Called once in _layout.tsx before providers mount
Every log entry includes automatic caller detection by parsing the JavaScript call stack. The logger extracts the source file and line number (e.g., sync-engine:128) from the Error stack trace.
One log file per day. No auto-rotation cap — files grow until explicitly cleared via Logger.clear() or Logger.clearAll(). Daily files stay small enough (~1-5MB) to avoid OOM during the read-and-append pattern.
Log entries are queued in memory and flushed to disk in batches by a background worker. If a disk write is in progress, new entries accumulate in the queue until the current write completes. This prevents blocking the UI thread.
