latex-health-check

# LaTeX Health Check: Self-Healing Build Agent > Compile all LaTeX projects, auto-fix known errors iteratively, and verify cross-project consistency (symlinks, shared bibliographies, Overleaf separation). ## When to Use - Periodically (weekly) to catch build rot before it becomes debugging sessions - After major infrastructure changes (template updates, symlink reorganisation) - Before submission season to verify all papers compile cleanly - When the user says "check my LaTeX", "build health", "compile everything" ## Modes | Mode | Trigger | What it does | |------|---------|-------------| | **Single project** | Path argument | Compile + fix + verify one project | | **All projects** | `all` argument | Discover and compile every LaTeX project | | **Quick** | `quick` argument | Compile only, no fixes, report errors | ## Phase 1: Discover LaTeX Projects Find all directories containing a `\documentclass` in a .tex file: Search locations in this order, checking that each exists: - an explicit path argument; - the current project; - project roots declared by the current repository or client guidance; - `~/Projects/` as a portable fallback for `all` mode. For each discovered project, record: - Project name (directory name) - Main .tex file path - Whether it has a `.latexmkrc` - Whether it has an `out/` directory - Whether it's inside a `paper/` subdirectory (Overleaf-linked) ## Phase 2: Build Loop (per project) For each project: ### 2a. Pre-flight - Resolve the byte-ident...