# KNELPDF

Fleet document-generation image: **pandoc + texlive (xetex/luatex) + DejaVu
and Noto fonts**, built for the TSYS Group agent fleet. Runs markdown → PDF
with full unicode support (box-drawing org charts, tables, code blocks).

## Status

- Built locally as `knelpdf:v1` on the COO workstation (2026-09-07).
- **Remote not yet created** — Gitea pushes are blocked by the
  2026-09-07 box incident (gitea receive-pack 500s, see Redmine #937).
  When infra recovers: create repo `KNEL/KNELPDF` on
  git.knownelement.com, push, and cross-link the Redmine ticket +
  Discourse doc here (links land at birth per house rules).

## Usage

```sh
# markdown -> PDF (xelatex engine, landscape, DejaVu mono keeps box-drawing)
docker run --rm -v "$PWD:/data" knelpdf:v1 \
  pandoc /data/input.md -o /data/output.pdf \
  --pdf-engine=xelatex \
  -V geometry:landscape -V geometry:margin=2cm \
  -V mainfont="DejaVu Sans" -V monofont="DejaVu Sans Mono"
```

The image has NO entrypoint (fleet rule) — invoke tools directly:
`pandoc`, `xelatex`, `lualatex`.

## Version policy (bump on rebuild, never float)

| Component | Pinned at |
|---|---|
| Base | `debian:bookworm-slim@sha256:88200866…` (digest in Dockerfile) |
| pandoc | 3.11 (`pandoc-3.11-1-amd64.deb` from GitHub releases) |
| texlive | Debian bookworm archive (pulled at build time, pinned by base digest) |
| Image tag | `knelpdf:vN` — `:latest` is forbidden by house rules |

## Contents

- texlive-latex-base / recommended / extra
- texlive-xetex, texlive-luatex, texlive-fonts-recommended, lmodern
- fonts-dejavu (mono has box-drawing glyphs), fonts-noto-core
- curl + ca-certificates