About CompilePDF

CompilePDF is the only writer in the Print With Synergy stack. It is the production action half of a deliberate split: codex-pdf describes the truth of a PDF (extract, render, color authority, geometry primitives); Compile takes those facts and writes new bytes that act on them.

The split is mechanically enforced: Codex's produce_surface_audit.py fails CI on any producer-surface signal (writer imports, Pdf.save outside a single allowlisted site, banned Ghostscript devices); Compile's consume_surface_audit.py fails CI on any Codex re-implementation attempt (re-defining geometry types, copy-pasting the Pantone JSON, mimicking the spot-color resolver).

Together with lint-pdf (rules + workflow) and loupe-pdf (embeddable viewer), the stack covers the full PDF production surface under one architectural invariant: each tool does one thing well, and drift between them is impossible by audit.

License

Apache 2.0. Core engine, marketing site, all sidecars.

Where the work happens