compile-pdf 0.5.0

CompilePDF — the only writer in the Print With Synergy stack. Rewrite, marks, impose, and trap producers built on top of codex-pdf.

compile-pdf

CompilePDF — the only writer in the Print With Synergy stack.

Four producers under one Python package, four FastAPI services in one Railway project, one Redis-backed Celery broker, one S3-compatible object bucket.

Producer	Purpose
compile_pdf.rewrite	OCG flips, metadata patches, color-space swaps, hygiene strips, page lifecycle ops on a single PDF
compile_pdf.marks	Register / crop / color-bar / fold marks; 1-up proofing slugs; external mark template ingestion
compile_pdf.impose	Sheet-level step-and-repeat layout; work-and-turn / tumble; bleed handling
compile_pdf.trap	Ink-pair spread / choke trap with three engine slots (pure_python / ghostscript / external)

Architectural invariants (mechanically enforced by scripts/consume_surface_audit.py):

• CompilePDF is the only writer in the stack.
• codex-pdf stays read-only — its produce_surface_audit.py enforces.
• Every producer consumes Codex primitives through published surfaces; re-implementation is forbidden.
• Every producer emits deterministic bytes; same input + same plan + same engine fingerprint → same SHA-256 output.

Status

Pre-release scaffolding. See COMPILE-IMPL-PLAN.md for the phased roadmap and docs/ for operator + integrator documentation.

Install

pip install compile-pdf

For producers that need geometry primitives (marks, impose, trap):

pip install 'compile-pdf[geom]'

For the trap producer with Ghostscript engine fallback:

pip install 'compile-pdf[geom,trap-gs]'

CLI

compile-pdf rewrite  --plan plan.json     input.pdf output.pdf
compile-pdf marks    --template tmpl.json input.pdf output.pdf
compile-pdf impose   --layout layout.json input.pdf output.pdf
compile-pdf trap     --policy policy.json input.pdf output.pdf

compile-pdf version
compile-pdf contract
compile-pdf health
compile-pdf cjd apply <job.json|job.xml>
compile-pdf lineage <id> [--chain]

CLI defaults to local-mode (in-process) when COMPILE_API_BASE is unset; otherwise POSTs to the configured central or sidecar URL.

Docs

• Design spec: COMPILE-DESIGN-SPEC.md
• Implementation plan: COMPILE-IMPL-PLAN.md
• Operator + integrator docs: docs/

License

AGPL-3.0-or-later. See LICENSE.