compile-latexlisted

# compile-latex Compile a `.tex`, parse the log into a ranked report with correct `file:line` attribution, and diff it against the previous build. The default is compile-and-report only; nothing in the source is edited unless `--figures` is passed. Parsing detail (package tables, log regexes, file-stack rules, box thresholds, state schema) is in [`references/log-patterns.md`](references/log-patterns.md). Read it before steps 3 through 5. Diff-vs-last-compile is adapted from `compiledeck` in [scunning1975/MixtapeTools](https://github.com/scunning1975/MixtapeTools). ## Options | Option | Default | Meaning | |---|---|---| | positional path | required | Master `.tex`. Absolute path, or a basename to resolve. | | `--engine=` | `auto` | Force `pdflatex` / `xelatex` / `lualatex`. | | `--outdir=` | `build` | Aux directory (`latexmk -outdir`). | | `--box-threshold=` | `5pt` | Overfull reporting gate. | | `--figures` | off | Opt-in: polish TikZ/pgfplots figures via `tikz-iterate`, then splice back. | | `--no-bib` | off | Skip the bib run (`-bibtex-`). | | `--force` | off | Compile even if a conflicted copy is present. | | `--clean` / `--clean-all` | off | `latexmk -c` / `-C`, then stop. | ## Resolving the file No config file. In order: use an absolute or cwd-relative path if given; otherwise `Glob` `~/Library/CloudStorage/Dropbox*/Apps/Overleaf/*/**/<name>.tex` and, if a project name was mentioned, filter to that project directory; otherwise `Glob` `*.tex` in the cwd and pick the