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: run the step-6 review loop on every TikZ/pgfplots figure, then splice back. | | `--max-iter=` | 5 | Rounds per figure in the `--figures` loop. | | `--goal=` | from caption | What a figure should communicate. Passed to the reviewer verbatim. | | `--output=` | `$RUN/final.tex` | Where an approved standalone figure lands when there is no master to splice into. | | `--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. | ## R