# Tools

## Mermaid checks (Markdown diagrams)

This repo uses Mermaid diagrams in Markdown reports.

Local lint (partial):

- `npm install`
- `npm run verify:mermaid`

Notes:
- This check validates diagram types supported by `@mermaid-js/parser` (for example: `pie`).
- Some diagram types (for example: `flowchart`) are not supported by that parser yet and will be reported as `skipped`.

Full validation (recommended):

- Use Forgejo’s built-in PDF export for the report file. If the PDF export succeeds, the diagrams compiled successfully.