gnn-report-generation

name	gnn-report-generation
description	GNN comprehensive analysis report generation. Use when creating summary reports from pipeline outputs, generating markdown or HTML reports, or producing executive summaries of model processing results.

GNN Report Generation (Step 23)

Purpose

Generates comprehensive analysis reports from all upstream pipeline outputs including parsing results, validation reports, simulation outcomes, statistical analyses, and visualizations.

Key Commands

# Generate reports
python src/23_report.py --target-dir input/gnn_files --output-dir output --verbose

# As part of pipeline
python src/main.py --only-steps 23 --verbose

API

from report import (
    process_report,
    generate_comprehensive_report,
    analyze_gnn_file,
    generate_html_report,
    generate_markdown_report,
    generate_report,
    ReportGenerator,
    ReportFormatter,
    get_module_info,
    get_supported_formats,
    validate_report,
)

# Process report step (used by pipeline)
process_report(target_dir, output_dir, verbose=True)

# Generate comprehensive report
report = generate_comprehensive_report(pipeline_results)

# Use the ReportGenerator class
gen = ReportGenerator()
report = gen.generate(results)

# Format-specific generation
generate_html_report(data, output_path)
generate_markdown_report(data, output_path)

# Validate a report
is_valid = validate_report(report_data)

# Query supported formats
formats = get_supported_formats()

Key Exports

• process_report — main pipeline processing function
• generate_comprehensive_report / generate_report — report generation
• ReportGenerator / ReportFormatter — report classes
• generate_html_report / generate_markdown_report — format-specific
• analyze_gnn_file — file-level analysis for reports
• validate_report / get_supported_formats — utilities

Output

• Reports in output/23_report_output/
• pipeline_execution_summary.json at pipeline root

MCP Tools

This module registers tools with the GNN MCP server (see mcp.py):

• generate_report
• get_report_module_info
• list_report_formats
• process_report
• read_report

References

• AGENTS.md — Module documentation
• README.md — Usage guide
• SPEC.md — Module specification

---

Documentation

• README: Module Overview
• AGENTS: Agentic Workflows
• SPEC: Architectural Specification
• SKILL: Capability API