Pactkit Report

---
name: pactkit-report
description: "Interactive HTML dashboard from Mermaid .mmd architecture graphs"
---

# 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.