pactkit-report

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.