1.6 KiB
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:
./beffroi.sh report my-report.yaml my-report.pdf
See reporter/examples for complete inputs.
Generate one diagnostic report
./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
or diagnostic JSON captures under
reports/diagnostics,
commit them with the reports submodule update, and run:
./beffroi.sh all build/publication
Jenkins runs the same build and publishes AES-encrypted Reports.zip and
Diagnostics.zip archives from main into the dedicated work_reports
destination.
Commands
./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 for repository structure, testing,
publication details, and component development.