# Beffroi Reporting Beffroi Reporting turns structured reports and Windows diagnostic captures into PDFs. The root `beffroi.sh` command is the main entry point. ## Generate one personal report Write a Reportist YAML or JSON file, then run: ```bash ./beffroi.sh report my-report.yaml my-report.pdf ``` See [`reporter/examples`](reporter/examples) for complete inputs. ## Generate one diagnostic report ```bash ./beffroi.sh diagnostic \ capture.json /path/to/evidence /path/to/new-output \ 2026-09-15T12:00:00Z 'Diagnostic review' 'Reviewer Name' 2026-09-15 ``` The output contains the normalized diagnostic, evidence-backed draft generation, and rendered PDF. ## Generate every stored PDF Add report YAML files under [`reports/reports`](reports/reports) or diagnostic JSON captures under [`reports/diagnostics`](reports/diagnostics), commit them with the reports submodule update, and run: ```bash ./beffroi.sh all build/publication ``` Jenkins runs the same build and publishes AES-encrypted `Reports.zip` and `Diagnostics.zip` archives from `main`. ## Commands ```text ./beffroi.sh report INPUT OUTPUT.pdf ./beffroi.sh diagnostic CAPTURE EVIDENCE_ROOT OUTPUT_DIR REFERENCE_TIME TITLE AUTHOR DATE ./beffroi.sh all NEW_OUTPUT_DIR ./beffroi.sh package BUILD_DIR ARTIFACT_DIR ./beffroi.sh test ./beffroi.sh bootstrap ./beffroi.sh doctor ``` The command reports missing tools for the requested operation. See [`docs/development.md`](docs/development.md) for repository structure, testing, publication details, and component development.