| name | pactkit-report |
| description | Interactive HTML dashboard from Mermaid .mmd architecture graphs |
| model | haiku |
PactKit Report
Generate interactive D3 force-directed HTML dashboards from Mermaid .mmd graph files.
Script location: Use the base directory from the skill invocation header to resolve script paths.
Prerequisites
- Architecture graphs must exist in
docs/architecture/graphs/*.mmd (generated by visualize)
Command Reference
generate -- Generate HTML report from .mmd
python3 ${CLAUDE_PLUGIN_ROOT}/skills/pactkit-report/scripts/report.py generate --input <file.mmd> [--output <file.html>] [--overlay <overlay.json>]
| Parameter | Description | Default |
|---|
--input | Input .mmd file path | Required (unless --all) |
--output | Output .html file path | Same name as input with .html |
--all | Convert all .mmd files in docs/architecture/graphs/ | - |
--overlay | Overlay JSON with complexity/blast_radius/layers data | - |
Supported Graph Types
| Type | Auto-detected From | Visualization |
|---|
| File dependency | code_graph.mmd | Force-directed node graph |
| Class diagram | class_graph.mmd | Inheritance hierarchy |
| Call graph | call_graph.mmd | Function call chains |
| Module graph | module_graph.mmd | Cross-module dependencies |
Output
- Single self-contained HTML file with embedded D3.js
- Interactive: zoom, pan, hover tooltips, click-to-highlight
- Overlay mode: nodes colored by complexity/blast radius
Usage Scenarios
/project-done: Generate HTML reports for architecture review.- Sprint review:
generate --all to create dashboard of entire codebase.
- CI integration: Generate reports as build artifacts.
- Frontend dashboard: Call
/pactkit-report via headless mode for on-demand visualization.
