Reproducible Beffroi diagnostics and reporting workspace, pinning the collector, report archive and renderer into one workflow.
Go to file
Dandaedre 8c7ae54cac
chore: use diagnostics bulk entrypoint
2026-09-16 03:16:52 +02:00
diagnostics@59691960ae chore: use diagnostics bulk entrypoint 2026-09-16 03:16:52 +02:00
docs ci: build and publish encrypted report archives 2026-09-16 01:55:34 +02:00
reporter@23e456e826 chore: align component test entrypoints 2026-09-16 02:55:59 +02:00
reports@d0e9c137f8 chore: follow renamed diagnostics repository 2026-09-16 03:05:58 +02:00
scripts chore: use diagnostics bulk entrypoint 2026-09-16 03:16:52 +02:00
.gitignore chore: keep legacy reporter as local reference 2026-09-16 02:34:38 +02:00
.gitmodules chore: follow renamed diagnostics repository 2026-09-16 03:05:58 +02:00
Jenkinsfile ci: publish archives to work reports directory 2026-09-16 02:20:30 +02:00
LICENSE.md New licences 2026-09-15 15:05:13 +02:00
README.md ci: publish archives to work reports directory 2026-09-16 02:20:30 +02:00
beffroi.sh chore: follow reportist root entrypoint 2026-09-16 02:13:39 +02:00
bootstrap.sh ci: build and publish encrypted report archives 2026-09-16 01:55:34 +02:00

README.md

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.