Generic Typst-based report renderer. Turns structured YAML/JSON reports into sober, reproducible PDF documents.
Go to file
Dandaedre da2882b4f8
Render generic finding confidence and resolution guidance
2026-09-16 18:05:30 +02:00
docs Render generic finding confidence and resolution guidance 2026-09-16 18:05:30 +02:00
examples feat: define generic report v1 contract and YAML JSON validator 2026-09-15 16:32:36 +02:00
schema Render generic finding confidence and resolution guidance 2026-09-16 18:05:30 +02:00
templates Render generic finding confidence and resolution guidance 2026-09-16 18:05:30 +02:00
tests Render plugins through common report engine 2026-09-16 18:02:03 +02:00
tools Render generic finding confidence and resolution guidance 2026-09-16 18:05:30 +02:00
.gitignore feat: define generic report v1 contract and YAML JSON validator 2026-09-15 16:32:36 +02:00
Jenkinsfile refactor: expose renderer at repository root 2026-09-16 02:13:26 +02:00
LICENSE Initial commit 2026-09-15 14:49:58 +02:00
README.md Render plugins through common report engine 2026-09-16 18:02:03 +02:00
render-plugin.sh Render plugins through common report engine 2026-09-16 18:02:03 +02:00
render.sh refactor: expose renderer at repository root 2026-09-16 02:13:26 +02:00

README.md

Reportist

Reportist validates and renders structured YAML or JSON reports with Typst. It has no dependency on the Beffroi integration repository or any specific plugin.

Render a report

./render.sh examples/example-report.yaml --output report.pdf

Render through a plugin

./render-plugin.sh /path/to/plugin /path/to/input output.pdf [plugin options]

A plugin directory contains plugin.json (name, version, input, output) and an executable prepare.sh. Reportist invokes prepare.sh INPUT STAGE REPORTIST_ROOT [plugin options]. The plugin writes a validated Reportist v1 report.json and any relative assets into STAGE. Reportist then uses its normal renderer and schema validation. Plugins own domain interpretation; Reportist owns document presentation. Plugins can be kept in any repository.

Batch and validation

bash tools/render-all.sh /path/to/reports --output-dir /path/to/pdfs
bash tools/validate.sh examples/example-report.yaml
bash tools/validate-all.sh /path/to/reports

See docs/report-contract.md and docs/development.md.