git2report 0.1.0__py3-none-any.whl

git2report/report.py

@@ -0,0 +1,884 @@
+"""STEP 7: combine sentences + numbers + commit IDs into Markdown, PDF, and interactive HTML."""
+from __future__ import annotations
+
+import html
+import re
+from dataclasses import dataclass, field
+from datetime import datetime
+from pathlib import Path
+
+from jinja2 import Template
+from reportlab.lib import colors
+from reportlab.lib.pagesizes import A4
+from reportlab.lib.styles import ParagraphStyle, getSampleStyleSheet
+from reportlab.lib.units import cm
+from reportlab.platypus import Paragraph, SimpleDocTemplate, Spacer, Table, TableStyle
+
+from git2report.models import BranchInfo
+
+MARKDOWN = Template("""\
+# Weekly Progress Report
+
+**Project:** {{ d.project }} | **Period:** {{ d.start }} to {{ d.end }} | **Audience:** {{ d.audience }}
+{% if d.executive_summary %}
+> **Executive Summary (TL;DR):** {{ d.executive_summary }}
+{% endif %}
+**Commits:** {{ d.metrics.commits }} | **Lines changed:** {{ d.metrics.lines_changed }} | \
+**Most active:** {{ d.metrics.top_module }} | **Test-to-code ratio:** {{ d.metrics.test_to_code_ratio }}
+
+**At a glance:** {{ d.glance_text }}
+{% if d.metrics.tech_stack and d.metrics.tech_stack|length > 0 %}
+### 💻 Tech Stack Breakdown
+{% for item in d.metrics.tech_stack %}- **{{ item.tech }}**: {{ item.percentage }}%
+{% endfor %}{% endif %}
+{% if d.metrics.hotspots and d.metrics.hotspots|length > 0 %}
+### 🔥 Codebase Hotspots
+| File | Commits | Lines Modified |
+|:---|:---:|:---:|
+{% for h in d.metrics.hotspots %}| `{{ h.path }}` | {{ h.commits }} | {{ h.lines }} |
+{% endfor %}{% endif %}
+{% if d.metrics.contributors and d.metrics.contributors|length > 0 %}
+### 👥 Contributor Leaderboard
+| Contributor | Commits | Lines (+ / -) | Primary Focus |
+|:---|:---:|:---:|:---|
+{% for c in d.metrics.contributors %}| {{ c.name }} | {{ c.commits }} | +{{ c.added }} / -{{ c.deleted }} | {{ c.top_module }} |
+{% endfor %}{% endif %}
+{% for s in d.sections %}
+## {{ s.module }}
+{{ s.text }}
+_Evidence: {{ s.hashes | join(', ') }}_
+{% if s.note %}_Note: {{ s.note }}_
+{% endif %}{% if s.commits and s.commits|length > 0 %}
+| Type | Commit | Author | Lines |
+|:---|:---|:---|:---:|
+{% for cm in s.commits %}| `{{ cm.type | upper }}` | {% if d.remote_url %}[`{{ cm.hash }}`]({{ d.remote_url }}/commit/{{ cm.hash }}){% else %}`{{ cm.hash }}`{% endif %} {{ cm.subject }} | {{ cm.author }} | +{{ cm.added }}/-{{ cm.deleted }} |
+{% endfor %}{% endif %}{% endfor %}{% if d.in_progress %}
+## In progress (open branches)
+{% for b in d.in_progress %}- `{{ b.name }}`: {{ b.ahead }} commit(s) not merged yet, last activity {{ b.last_date }} ("{{ b.subject }}")
+{% endfor %}{% endif %}{% if d.planned %}
+## Planned goals (written by the developer)
+{% for p in d.planned %}- {{ p }}
+{% endfor %}{% endif %}
+---
+_Generated by Git2Report on {{ d.generated }}. Summaries: {{ d.mode_label }}._
+""", trim_blocks=False)
+
+
+@dataclass
+class CategorizedCommit:
+    hash: str
+    subject: str
+    author: str
+    date: str
+    type: str  # feat, fix, perf, refactor, docs, chore, etc.
+    added: int = 0
+    deleted: int = 0
+
+
+@dataclass
+class Section:
+    module: str
+    text: str
+    hashes: list[str]
+    mode: str = "offline"
+    note: str = ""
+    commits: list[CategorizedCommit] = field(default_factory=list)
+
+
+@dataclass
+class ReportData:
+    project: str
+    start: str
+    end: str
+    audience: str
+    metrics: dict
+    sections: list[Section] = field(default_factory=list)
+    mode_label: str = ""
+    glance_text: str = ""
+    in_progress: list[BranchInfo] = field(default_factory=list)
+    planned: list[str] = field(default_factory=list)
+    generated: str = field(default_factory=lambda: datetime.now().strftime("%Y-%m-%d %H:%M"))
+    remote_url: str | None = None
+    executive_summary: str = ""
+
+
+def render_markdown(data: ReportData) -> str:
+    return MARKDOWN.render(d=data).rstrip() + "\n"
+
+
+def _esc(t: str) -> str:
+    return t.replace("&", "&amp;").replace("<", "&lt;").replace(">", "&gt;")
+
+
+def render_pdf(data: ReportData, path: Path) -> None:
+    ss = getSampleStyleSheet()
+    navy = colors.HexColor("#0F172A")
+    blue = colors.HexColor("#2563EB")
+    slate = colors.HexColor("#334155")
+    gray_bg = colors.HexColor("#F8FAFC")
+    gray_border = colors.HexColor("#CBD5E1")
+
+    title = ParagraphStyle("t", parent=ss["Title"], fontName="Helvetica-Bold", fontSize=18, leading=22, textColor=navy, alignment=0, spaceAfter=4)
+    meta = ParagraphStyle("m", parent=ss["Normal"], fontSize=8.5, leading=11, textColor=colors.HexColor("#64748B"), spaceAfter=8)
+    h = ParagraphStyle("h", parent=ss["Heading2"], fontName="Helvetica-Bold", fontSize=11, leading=14, textColor=navy, spaceBefore=8, spaceAfter=3)
+    body = ParagraphStyle("b", parent=ss["Normal"], fontSize=9, leading=13, textColor=slate)
+    ev = ParagraphStyle("e", parent=ss["Normal"], fontName="Courier", fontSize=7.5, leading=10, textColor=colors.HexColor("#64748B"), spaceAfter=2)
+    note_style = ParagraphStyle("n", parent=ss["Normal"], fontSize=8, leading=11, textColor=colors.HexColor("#B45309"), spaceAfter=2)
+
+    cell = ParagraphStyle("c", parent=ss["Normal"], fontSize=8, leading=10.5, textColor=slate)
+    cell_bold = ParagraphStyle("cb", parent=cell, fontName="Helvetica-Bold", fontSize=10.5, leading=12.5, textColor=navy)
+    cellh = ParagraphStyle("ch", parent=cell, fontName="Helvetica-Bold", fontSize=8, leading=10.5, textColor=colors.white)
+
+    m = data.metrics
+    lines_add = m.get("lines_added", 0)
+    lines_del = m.get("lines_deleted", 0)
+
+    # 1. Header & Meta
+    story = [
+        Paragraph("Weekly Progress Report", title),
+        Paragraph(
+            f"Project: <b>{_esc(data.project)}</b> &nbsp;|&nbsp; Period: {data.start} to {data.end} &nbsp;|&nbsp; Audience: {data.audience.capitalize()}",
+            meta
+        ),
+    ]
+
+    # 2. Executive Summary (TL;DR)
+    if getattr(data, "executive_summary", ""):
+        exec_title = ParagraphStyle("et", parent=ss["Normal"], fontName="Helvetica-Bold", fontSize=8.5, leading=11, textColor=colors.HexColor("#1D4ED8"), spaceAfter=2)
+        exec_body = ParagraphStyle("eb", parent=ss["Normal"], fontSize=8.5, leading=12.5, textColor=colors.HexColor("#1E293B"))
+        exec_box = Table([
+            [Paragraph("EXECUTIVE SUMMARY (TL;DR)", exec_title)],
+            [Paragraph(_esc(data.executive_summary), exec_body)],
+        ], colWidths=[17.4*cm])
+        exec_box.setStyle(TableStyle([
+            ("BACKGROUND", (0, 0), (-1, -1), colors.HexColor("#F8FAFC")),
+            ("BOX", (0, 0), (-1, -1), 0.5, colors.HexColor("#E2E8F0")),
+            ("LINEBEFORE", (0, 0), (0, -1), 3.0, blue),
+            ("TOPPADDING", (0, 0), (-1, -1), 4),
+            ("BOTTOMPADDING", (0, 0), (-1, -1), 4),
+            ("LEFTPADDING", (0, 0), (-1, -1), 8),
+            ("RIGHTPADDING", (0, 0), (-1, -1), 8),
+        ]))
+        story += [exec_box, Spacer(1, 4)]
+
+    # 3. KPI Grid (4 Cards)
+    kpi_rows = [
+        [
+            Paragraph("COMMITS", cell),
+            Paragraph("NET CODE CHURN", cell),
+            Paragraph("PRIMARY IMPACT", cell),
+            Paragraph("TEST RATIO", cell),
+        ],
+        [
+            Paragraph(f"<b>{m['commits']}</b> <font size=7 color='#64748B'>(of {m['commits_seen_before_filter']})</font>", cell_bold),
+            Paragraph(f"<b>{m['lines_changed']}</b> <font size=7 color='#059669'>+{lines_add}</font> <font size=7 color='#DC2626'>-{lines_del}</font>", cell_bold),
+            Paragraph(f"<b>{_esc(str(m['top_module']))}</b>", cell_bold),
+            Paragraph(f"<b>{m['test_to_code_ratio']}</b>", cell_bold),
+        ],
+    ]
+    tbl = Table(kpi_rows, colWidths=[4.35*cm, 4.45*cm, 4.4*cm, 4.2*cm])
+    tbl.setStyle(TableStyle([
+        ("BACKGROUND", (0, 0), (-1, -1), gray_bg),
+        ("BOX", (0, 0), (-1, -1), 0.5, gray_border),
+        ("INNERGRID", (0, 0), (-1, -1), 0.5, gray_border),
+        ("TOPPADDING", (0, 0), (-1, -1), 5),
+        ("BOTTOMPADDING", (0, 0), (-1, -1), 5),
+        ("LEFTPADDING", (0, 0), (-1, -1), 7),
+        ("RIGHTPADDING", (0, 0), (-1, -1), 7),
+    ]))
+    story += [tbl, Spacer(1, 4)]
+
+    # 4. At-a-glance banner
+    glance_box = Table([[Paragraph(f"<b>At a glance:</b> {_esc(data.glance_text)}", body)]], colWidths=[17.4*cm])
+    glance_box.setStyle(TableStyle([
+        ("BACKGROUND", (0, 0), (-1, -1), colors.HexColor("#EFF6FF")),
+        ("BOX", (0, 0), (-1, -1), 0.5, colors.HexColor("#BFDBFE")),
+        ("TOPPADDING", (0, 0), (-1, -1), 4),
+        ("BOTTOMPADDING", (0, 0), (-1, -1), 4),
+        ("LEFTPADDING", (0, 0), (-1, -1), 8),
+        ("RIGHTPADDING", (0, 0), (-1, -1), 8),
+    ]))
+    story += [glance_box, Spacer(1, 4)]
+
+    # 4b. Visual Analytics Chart: Commit Type Distribution
+    commits_by_type = m.get("commits_by_type", {})
+    if commits_by_type:
+        from git2report.charts import build_type_breakdown_bar
+        type_chart = build_type_breakdown_bar(commits_by_type, width=490, height=30)
+        story += [
+            Paragraph("Commit Type Distribution", h),
+            type_chart,
+            Spacer(1, 3)
+        ]
+
+    # 4c. Visual Analytics: Module Code Churn Chart (+Lines Added / -Lines Deleted)
+    if data.sections:
+        from git2report.charts import build_module_churn_chart
+        churn_chart = build_module_churn_chart(data.sections, width=490, height=60)
+        story += [
+            Paragraph("Code Churn by Module (+Lines Added / -Lines Deleted)", h),
+            churn_chart,
+            Spacer(1, 4)
+        ]
+
+    # 5. Two-column Analytics: Tech Stack + Codebase Hotspots
+    tech_stack = m.get("tech_stack", [])
+    hotspots = m.get("hotspots", [])
+    if tech_stack or hotspots:
+        # Tech stack table
+        ts_rows = [[Paragraph("Technology", cellh), Paragraph("Share", cellh)]]
+        if isinstance(tech_stack, list):
+            for item in tech_stack[:5]:
+                t_name = item.get("tech", "Other") if isinstance(item, dict) else str(item)
+                t_pct = item.get("percentage", 0) if isinstance(item, dict) else 0
+                ts_rows.append([
+                    Paragraph(_esc(str(t_name)), cell),
+                    Paragraph(f"<b>{t_pct}%</b>", cell),
+                ])
+        elif isinstance(tech_stack, dict):
+            for tech, pct in list(tech_stack.items())[:5]:
+                ts_rows.append([
+                    Paragraph(_esc(str(tech)), cell),
+                    Paragraph(f"<b>{pct}%</b>", cell),
+                ])
+        if len(ts_rows) == 1:
+            ts_rows.append([Paragraph("Not detected", cell), Paragraph("-", cell)])
+        ts_tbl = Table(ts_rows, colWidths=[5.4*cm, 2.6*cm])
+        ts_tbl.setStyle(TableStyle([
+            ("BACKGROUND", (0, 0), (-1, 0), navy),
+            ("ROWBACKGROUNDS", (0, 1), (-1, -1), [colors.white, gray_bg]),
+            ("GRID", (0, 0), (-1, -1), 0.5, gray_border),
+            ("TOPPADDING", (0, 0), (-1, -1), 2.5),
+            ("BOTTOMPADDING", (0, 0), (-1, -1), 2.5),
+            ("LEFTPADDING", (0, 0), (-1, -1), 5),
+            ("RIGHTPADDING", (0, 0), (-1, -1), 5),
+        ]))
+
+        # Hotspots table
+        hs_rows = [[Paragraph("Active File", cellh), Paragraph("Commits", cellh), Paragraph("Lines", cellh)]]
+        if isinstance(hotspots, list):
+            for hs in hotspots[:5]:
+                if isinstance(hs, dict):
+                    fname = hs.get("path") or hs.get("file", "")
+                    n_commits = hs.get("commits", 0)
+                    n_lines = hs.get("lines", 0)
+                else:
+                    fname = str(hs)
+                    n_commits = 0
+                    n_lines = 0
+                if len(fname) > 26:
+                    fname = "..." + fname[-23:]
+                hs_rows.append([
+                    Paragraph(f"<font face='Courier' size=7>{_esc(fname)}</font>", cell),
+                    Paragraph(str(n_commits), cell),
+                    Paragraph(str(n_lines), cell),
+                ])
+        if len(hs_rows) == 1:
+            hs_rows.append([Paragraph("None", cell), Paragraph("-", cell), Paragraph("-", cell)])
+        hs_tbl = Table(hs_rows, colWidths=[5.4*cm, 1.8*cm, 1.8*cm])
+        hs_tbl.setStyle(TableStyle([
+            ("BACKGROUND", (0, 0), (-1, 0), navy),
+            ("ROWBACKGROUNDS", (0, 1), (-1, -1), [colors.white, gray_bg]),
+            ("GRID", (0, 0), (-1, -1), 0.5, gray_border),
+            ("TOPPADDING", (0, 0), (-1, -1), 2.5),
+            ("BOTTOMPADDING", (0, 0), (-1, -1), 2.5),
+            ("LEFTPADDING", (0, 0), (-1, -1), 5),
+            ("RIGHTPADDING", (0, 0), (-1, -1), 5),
+        ]))
+
+        analytics_tbl = Table([
+            [Paragraph("Tech Stack Breakdown", h), Paragraph("Codebase Hotspots", h)],
+            [ts_tbl, hs_tbl]
+        ], colWidths=[8.4*cm, 9.0*cm])
+        analytics_tbl.setStyle(TableStyle([
+            ("VALIGN", (0, 0), (-1, -1), "TOP"),
+            ("LEFTPADDING", (0, 0), (-1, -1), 0),
+            ("RIGHTPADDING", (0, 0), (-1, -1), 0),
+            ("TOPPADDING", (0, 0), (-1, -1), 1),
+            ("BOTTOMPADDING", (0, 0), (-1, -1), 2),
+        ]))
+        story += [analytics_tbl, Spacer(1, 4)]
+
+    # 6. Team Contributor Leaderboard
+    contributors = m.get("contributors", [])
+    if contributors and len(contributors) > 0:
+        c_rows = [[
+            Paragraph("Contributor", cellh),
+            Paragraph("Commits", cellh),
+            Paragraph("Lines (+ / -)", cellh),
+            Paragraph("Primary Focus", cellh),
+        ]]
+        for c_ in contributors[:6]:
+            c_rows.append([
+                Paragraph(_esc(c_["name"]), cell),
+                Paragraph(str(c_["commits"]), cell),
+                Paragraph(f"<font color='#059669'>+{c_['added']}</font> / <font color='#DC2626'>-{c_['deleted']}</font>", cell),
+                Paragraph(_esc(c_["top_module"]), cell),
+            ])
+        c_tbl = Table(c_rows, colWidths=[5.2*cm, 2.6*cm, 4.6*cm, 5.0*cm])
+        c_tbl.setStyle(TableStyle([
+            ("BACKGROUND", (0, 0), (-1, 0), navy),
+            ("ROWBACKGROUNDS", (0, 1), (-1, -1), [colors.white, gray_bg]),
+            ("GRID", (0, 0), (-1, -1), 0.5, gray_border),
+            ("TOPPADDING", (0, 0), (-1, -1), 3),
+            ("BOTTOMPADDING", (0, 0), (-1, -1), 3),
+            ("LEFTPADDING", (0, 0), (-1, -1), 6),
+            ("RIGHTPADDING", (0, 0), (-1, -1), 6),
+        ]))
+        story += [Paragraph("Team Contributors", h), c_tbl, Spacer(1, 4)]
+
+    bullet = ParagraphStyle("bl", parent=body, leftIndent=12, bulletIndent=2, fontSize=8.5, leading=12)
+
+    # 7. Module Deliverables & Categorized Badges
+    story.append(Paragraph("Module Deliverables", h))
+    for s in data.sections:
+        story.append(Paragraph(f"<b>{_esc(s.module)}</b>", h))
+        s_box = Table([[Paragraph(_esc(s.text), body)]], colWidths=[17.4*cm])
+        s_box.setStyle(TableStyle([
+            ("BACKGROUND", (0, 0), (-1, -1), gray_bg),
+            ("BOX", (0, 0), (-1, -1), 0.5, gray_border),
+            ("LINEBEFORE", (0, 0), (0, -1), 2.5, blue),
+            ("TOPPADDING", (0, 0), (-1, -1), 4),
+            ("BOTTOMPADDING", (0, 0), (-1, -1), 4),
+            ("LEFTPADDING", (0, 0), (-1, -1), 8),
+            ("RIGHTPADDING", (0, 0), (-1, -1), 8),
+        ]))
+        story.append(s_box)
+
+        # Categorized commits with distinct badge colors
+        if s.commits:
+            badge_colors = {
+                "FEAT": "#059669",
+                "FIX": "#DC2626",
+                "PERF": "#7C3AED",
+                "REFACTOR": "#D97706",
+                "DOCS": "#0284C7",
+                "STYLE": "#64748B",
+                "TEST": "#0D9488",
+                "CHORE": "#64748B",
+            }
+            commit_items = []
+            for cm_ in s.commits[:5]:
+                t_label = cm_.type.upper() if cm_.type else "OTHER"
+                b_color = badge_colors.get(t_label, "#2563EB")
+                commit_items.append(
+                    Paragraph(
+                        f"<font color='{b_color}'><b>[{t_label}]</b></font> {_esc(cm_.subject)} &nbsp;<font color='#64748B'>({_esc(cm_.author)}, +{cm_.added}/-{cm_.deleted})</font> <font face='Courier' color='#2563EB'>{cm_.hash}</font>",
+                        bullet,
+                        bulletText="\u2022"
+                    )
+                )
+            story += commit_items
+            if len(s.commits) > 5:
+                story.append(Paragraph(f"<i>... and {len(s.commits) - 5} more commits</i>", bullet))
+
+        story.append(Paragraph("Evidence: " + ", ".join(s.hashes), ev))
+        if s.note:
+            story.append(Paragraph("Note: " + _esc(s.note), note_style))
+        story.append(Spacer(1, 3))
+
+    # 8. In progress branches
+    if data.in_progress:
+        story.append(Paragraph("In progress (open branches)", h))
+        for b in data.in_progress:
+            story.append(Paragraph(f"<b>{_esc(b.name)}</b>: {b.ahead} commit(s) not merged yet, last activity {b.last_date} ({_esc(b.subject)})",
+                                   bullet, bulletText="\u2022"))
+
+    # 9. Planned goals
+    if data.planned:
+        story.append(Paragraph("Planned goals (written by the developer)", h))
+        for g_ in data.planned:
+            story.append(Paragraph(_esc(g_), bullet, bulletText="\u2022"))
+
+    story += [Spacer(1, 8), Paragraph(f"Generated by Git2Report on {data.generated}. Summaries: {_esc(data.mode_label)}.", meta)]
+
+    def header_footer(c, doc):
+        c.saveState()
+        c.setFont("Helvetica", 7.5)
+        c.setFillColor(colors.HexColor("#64748B"))
+        # Running header (pages > 1)
+        if doc.page > 1:
+            c.drawString(1.8*cm, A4[1] - 1.2*cm, f"{data.project} — Weekly Progress Report")
+            c.drawRightString(A4[0] - 1.8*cm, A4[1] - 1.2*cm, f"Generated: {data.generated}")
+            c.setStrokeColor(gray_border)
+            c.setLineWidth(0.5)
+            c.line(1.8*cm, A4[1] - 1.35*cm, A4[0] - 1.8*cm, A4[1] - 1.35*cm)
+
+        # Running footer
+        c.drawString(1.8*cm, 1.1*cm, "Git2Report | Engineering Delivery Report")
+        c.drawRightString(A4[0] - 1.8*cm, 1.1*cm, f"Page {doc.page}")
+        c.setStrokeColor(gray_border)
+        c.setLineWidth(0.5)
+        c.line(1.8*cm, 1.3*cm, A4[0] - 1.8*cm, 1.3*cm)
+        c.restoreState()
+
+    SimpleDocTemplate(
+        str(path), pagesize=A4,
+        leftMargin=1.8*cm, rightMargin=1.8*cm,
+        topMargin=1.6*cm, bottomMargin=1.6*cm,
+        title=f"{data.project} Progress Report"
+    ).build(story, onFirstPage=header_footer, onLaterPages=header_footer)
+
+
+HTML_TEMPLATE = """\
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Progress Report - {{ d.project }}</title>
+  <style>
+    :root {
+      --bg: #0f172a;
+      --card: #1e293b;
+      --card-border: #334155;
+      --text: #f8fafc;
+      --text-muted: #94a3b8;
+      --primary: #3b82f6;
+      --primary-hover: #60a5fa;
+      --accent: #8b5cf6;
+      --success: #10b981;
+      --danger: #ef4444;
+      --warning: #f59e0b;
+      --info: #06b6d4;
+      --chip-bg: rgba(255, 255, 255, 0.06);
+    }
+    .light {
+      --bg: #f8fafc;
+      --card: #ffffff;
+      --card-border: #e2e8f0;
+      --text: #0f172a;
+      --text-muted: #64748b;
+      --chip-bg: rgba(0, 0, 0, 0.04);
+    }
+    * { box-sizing: border-box; margin: 0; padding: 0; }
+    body {
+      font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
+      background-color: var(--bg);
+      color: var(--text);
+      line-height: 1.5;
+      padding: 24px 16px;
+      transition: background-color 0.2s, color 0.2s;
+    }
+    .container { max-width: 1100px; margin: 0 auto; }
+    header {
+      display: flex;
+      flex-wrap: wrap;
+      justify-content: space-between;
+      align-items: center;
+      gap: 16px;
+      padding-bottom: 24px;
+      border-bottom: 1px solid var(--card-border);
+      margin-bottom: 24px;
+    }
+    .title-group h1 { font-size: 1.85rem; font-weight: 700; display: flex; align-items: center; gap: 10px; }
+    .badge {
+      display: inline-flex;
+      align-items: center;
+      font-size: 0.75rem;
+      font-weight: 600;
+      padding: 3px 8px;
+      border-radius: 9999px;
+      text-transform: uppercase;
+      letter-spacing: 0.05em;
+    }
+    .badge-primary { background: rgba(59, 130, 246, 0.15); color: var(--primary); }
+    .badge-success { background: rgba(16, 185, 129, 0.15); color: var(--success); }
+    .badge-danger { background: rgba(239, 68, 68, 0.15); color: var(--danger); }
+    .badge-warning { background: rgba(245, 158, 11, 0.15); color: var(--warning); }
+    .badge-accent { background: rgba(139, 92, 246, 0.15); color: var(--accent); }
+    .meta-text { color: var(--text-muted); font-size: 0.9rem; margin-top: 4px; }
+    .actions { display: flex; gap: 10px; align-items: center; }
+    button, .btn {
+      background: var(--card);
+      border: 1px solid var(--card-border);
+      color: var(--text);
+      padding: 8px 14px;
+      border-radius: 8px;
+      cursor: pointer;
+      font-weight: 500;
+      font-size: 0.85rem;
+      display: inline-flex;
+      align-items: center;
+      gap: 6px;
+      text-decoration: none;
+      transition: all 0.2s;
+    }
+    button:hover, .btn:hover { border-color: var(--primary); color: var(--primary); }
+    .kpi-grid {
+      display: grid;
+      grid-template-columns: repeat(auto-fit, minmax(200px, 1fr));
+      gap: 16px;
+      margin-bottom: 24px;
+    }
+    .kpi-card {
+      background: var(--card);
+      border: 1px solid var(--card-border);
+      border-radius: 12px;
+      padding: 18px;
+      box-shadow: 0 4px 6px -1px rgba(0, 0, 0, 0.1);
+    }
+    .kpi-label { font-size: 0.8rem; font-weight: 600; color: var(--text-muted); text-transform: uppercase; }
+    .kpi-value { font-size: 1.75rem; font-weight: 700; margin: 4px 0; }
+    .kpi-sub { font-size: 0.8rem; color: var(--text-muted); }
+    .glance-banner {
+      background: linear-gradient(135deg, rgba(59, 130, 246, 0.1), rgba(139, 92, 246, 0.1));
+      border: 1px solid rgba(59, 130, 246, 0.3);
+      padding: 14px 18px;
+      border-radius: 10px;
+      margin-bottom: 24px;
+      display: flex;
+      align-items: center;
+      gap: 10px;
+      font-size: 0.95rem;
+    }
+    .progress-bar-container {
+      background: var(--card);
+      border: 1px solid var(--card-border);
+      border-radius: 12px;
+      padding: 18px;
+      margin-bottom: 24px;
+    }
+    .progress-bar {
+      display: flex;
+      height: 12px;
+      border-radius: 6px;
+      overflow: hidden;
+      margin: 12px 0 8px 0;
+      background: rgba(255, 255, 255, 0.05);
+    }
+    .progress-segment { height: 100%; transition: width 0.3s; }
+    .progress-legend { display: flex; flex-wrap: wrap; gap: 14px; font-size: 0.8rem; color: var(--text-muted); }
+    .legend-item { display: flex; align-items: center; gap: 6px; }
+    .legend-dot { width: 8px; height: 8px; border-radius: 50%; }
+
+    .leaderboard {
+      background: var(--card);
+      border: 1px solid var(--card-border);
+      border-radius: 12px;
+      padding: 18px;
+      margin-bottom: 24px;
+    }
+    table { width: 100%; border-collapse: collapse; margin-top: 12px; font-size: 0.9rem; }
+    th { text-align: left; padding: 10px 12px; border-bottom: 1px solid var(--card-border); color: var(--text-muted); font-weight: 600; font-size: 0.8rem; text-transform: uppercase; }
+    td { padding: 10px 12px; border-bottom: 1px solid var(--chip-bg); }
+    tr:last-child td { border-bottom: none; }
+
+    .module-card {
+      background: var(--card);
+      border: 1px solid var(--card-border);
+      border-radius: 12px;
+      padding: 20px;
+      margin-bottom: 20px;
+    }
+    .module-header { display: flex; justify-content: space-between; align-items: center; margin-bottom: 12px; }
+    .module-title { font-size: 1.25rem; font-weight: 600; }
+    .summary-box {
+      background: var(--chip-bg);
+      border-left: 3px solid var(--primary);
+      padding: 10px 14px;
+      border-radius: 4px;
+      font-size: 0.95rem;
+      margin-bottom: 14px;
+    }
+    .commit-table { width: 100%; }
+    .commit-table td { padding: 8px 10px; font-size: 0.85rem; }
+    .commit-hash {
+      font-family: monospace;
+      font-size: 0.8rem;
+      background: var(--chip-bg);
+      padding: 2px 6px;
+      border-radius: 4px;
+      text-decoration: none;
+      color: var(--primary);
+    }
+    .commit-hash:hover { text-decoration: underline; }
+    .filter-bar {
+      display: flex;
+      flex-wrap: wrap;
+      justify-content: space-between;
+      gap: 12px;
+      margin-bottom: 20px;
+    }
+    .search-input {
+      background: var(--card);
+      border: 1px solid var(--card-border);
+      color: var(--text);
+      padding: 8px 14px;
+      border-radius: 8px;
+      font-size: 0.85rem;
+      min-width: 250px;
+    }
+    .search-input:focus { outline: none; border-color: var(--primary); }
+    .section-title { font-size: 1.2rem; font-weight: 600; margin: 24px 0 12px 0; }
+    .tag-feat { color: #10b981; }
+    .tag-fix { color: #ef4444; }
+    .tag-perf, .tag-refactor { color: #8b5cf6; }
+    .tag-other { color: #94a3b8; }
+    footer { text-align: center; color: var(--text-muted); font-size: 0.8rem; margin-top: 40px; padding-top: 20px; border-top: 1px solid var(--card-border); }
+    @media print {
+      body { background: #fff !important; color: #000 !important; }
+      .actions, .filter-bar, button { display: none !important; }
+      .kpi-card, .module-card, .leaderboard, .progress-bar-container { border: 1px solid #ccc !important; box-shadow: none !important; }
+    }
+  </style>
+</head>
+<body>
+  <div class="container">
+    <header>
+      <div class="title-group">
+        <h1>📊 {{ d.project }} <span class="badge badge-primary">{{ d.audience }}</span></h1>
+        <div class="meta-text">
+          Period: <strong>{{ d.start }}</strong> to <strong>{{ d.end }}</strong> &bull; Generated: {{ d.generated }}
+        </div>
+      </div>
+      <div class="actions">
+        {% if d.remote_url %}
+        <a href="{{ d.remote_url }}" target="_blank" class="btn">🔗 GitHub</a>
+        {% endif %}
+        <button onclick="window.print()">🖨️ Print / PDF</button>
+        <button onclick="toggleTheme()" id="themeBtn">🌓 Theme</button>
+      </div>
+    </header>
+
+    <!-- KPI Cards -->
+    <div class="kpi-grid">
+      <div class="kpi-card">
+        <div class="kpi-label">Commits</div>
+        <div class="kpi-value">{{ d.metrics.commits }}</div>
+        <div class="kpi-sub">{{ d.metrics.commits_seen_before_filter }} in period</div>
+      </div>
+      <div class="kpi-card">
+        <div class="kpi-label">Code Churn</div>
+        <div class="kpi-value" style="color: var(--success);">+{{ d.metrics.lines_added }}</div>
+        <div class="kpi-sub" style="color: var(--danger);">-{{ d.metrics.lines_deleted }} lines ({{ d.metrics.lines_changed }} total)</div>
+      </div>
+      <div class="kpi-card">
+        <div class="kpi-label">Top Module</div>
+        <div class="kpi-value" style="font-size: 1.35rem; color: var(--primary);">{{ d.metrics.top_module }}</div>
+        <div class="kpi-sub">{{ d.metrics.modules }} active module(s)</div>
+      </div>
+      <div class="kpi-card">
+        <div class="kpi-label">Test-to-Code</div>
+        <div class="kpi-value">{{ d.metrics.test_to_code_ratio }}</div>
+        <div class="kpi-sub">Test lines ratio</div>
+      </div>
+      <div class="kpi-card">
+        <div class="kpi-label">Contributors</div>
+        <div class="kpi-value">{{ d.metrics.authors }}</div>
+        <div class="kpi-sub">Active developers</div>
+      </div>
+    </div>
+
+    <!-- At a Glance -->
+    <div class="glance-banner">
+      <span>✨ <strong>At a glance:</strong> {{ d.glance_text }}</span>
+    </div>
+
+    <!-- Module Distribution Progress Bar -->
+    {% if d.metrics.module_distribution %}
+    <div class="progress-bar-container">
+      <div style="font-size: 0.85rem; font-weight: 600; text-transform: uppercase; color: var(--text-muted);">
+        Module Work Distribution
+      </div>
+      <div class="progress-bar">
+        {% set colors_list = ['#3b82f6', '#10b981', '#8b5cf6', '#f59e0b', '#06b6d4', '#ec4899', '#64748b'] %}
+        {% for mod, pct in d.metrics.module_distribution.items() %}
+        <div class="progress-segment" style="width: {{ pct }}%; background-color: {{ colors_list[loop.index0 % 7] }};" title="{{ mod }}: {{ pct }}%"></div>
+        {% endfor %}
+      </div>
+      <div class="progress-legend">
+        {% for mod, pct in d.metrics.module_distribution.items() %}
+        <div class="legend-item">
+          <div class="legend-dot" style="background-color: {{ colors_list[loop.index0 % 7] }};"></div>
+          <span>{{ mod }} ({{ pct }}%)</span>
+        </div>
+        {% endfor %}
+      </div>
+    </div>
+    {% endif %}
+
+    <!-- Module Code Churn Visual Chart -->
+    {% if d.sections and d.sections|length > 0 %}
+    <div class="progress-bar-container">
+      <div style="font-size: 0.85rem; font-weight: 600; text-transform: uppercase; color: var(--text-muted); margin-bottom: 12px; display: flex; justify-content: space-between;">
+        <span>📊 Code Churn by Module</span>
+        <span style="font-size: 0.8rem; font-weight: normal;"><font color="var(--success)">+Lines Added</font> &bull; <font color="var(--danger)">-Lines Deleted</font></span>
+      </div>
+      <div style="display: flex; flex-direction: column; gap: 10px;">
+        {% for s in d.sections %}
+        {% set s_add = s.commits | sum(attribute='added') %}
+        {% set s_del = s.commits | sum(attribute='deleted') %}
+        <div style="display: grid; grid-template-columns: 140px 1fr 110px; align-items: center; gap: 12px; font-size: 0.85rem;">
+          <div style="font-weight: 600; overflow: hidden; text-overflow: ellipsis; white-space: nowrap;">{{ s.module }}</div>
+          <div style="display: flex; height: 10px; border-radius: 5px; overflow: hidden; background: rgba(255,255,255,0.05);">
+            {% set total_churn = s_add + s_del %}
+            {% if total_churn > 0 %}
+            <div style="width: {{ (s_add / total_churn) * 100 }}%; background: var(--success);" title="+{{ s_add }} lines added"></div>
+            <div style="width: {{ (s_del / total_churn) * 100 }}%; background: var(--danger);" title="-{{ s_del }} lines deleted"></div>
+            {% endif %}
+          </div>
+          <div style="text-align: right; font-family: monospace; font-size: 0.8rem;">
+            <span style="color: var(--success);">+{{ s_add }}</span> / <span style="color: var(--danger);">-{{ s_del }}</span>
+          </div>
+        </div>
+        {% endfor %}
+      </div>
+    </div>
+    {% endif %}
+
+    <!-- Contributor Leaderboard -->
+    {% if d.metrics.contributors and d.metrics.contributors|length > 0 %}
+    <div class="leaderboard">
+      <div style="font-size: 0.9rem; font-weight: 600; text-transform: uppercase; color: var(--text-muted);">
+        👥 Team Contributions
+      </div>
+      <table>
+        <thead>
+          <tr>
+            <th>Developer</th>
+            <th style="text-align: center;">Commits</th>
+            <th>Lines Added</th>
+            <th>Lines Deleted</th>
+            <th>Primary Module</th>
+          </tr>
+        </thead>
+        <tbody>
+          {% for c in d.metrics.contributors %}
+          <tr>
+            <td><strong>{{ c.name }}</strong></td>
+            <td style="text-align: center;"><span class="badge badge-primary">{{ c.commits }}</span></td>
+            <td style="color: var(--success);">+{{ c.added }}</td>
+            <td style="color: var(--danger);">-{{ c.deleted }}</td>
+            <td><span class="badge badge-accent">{{ c.top_module }}</span></td>
+          </tr>
+          {% endfor %}
+        </tbody>
+      </table>
+    </div>
+    {% endif %}
+
+    <!-- Filter Bar -->
+    <div class="filter-bar">
+      <div style="font-size: 1.1rem; font-weight: 600; display: flex; align-items: center; gap: 8px;">
+        📦 Module Breakdown ({{ d.sections|length }})
+      </div>
+      <input type="text" id="commitSearch" class="search-input" placeholder="🔍 Search commits, authors, hashes..." onkeyup="filterCommits()">
+    </div>
+
+    <!-- Modules List -->
+    <div id="modulesContainer">
+      {% for s in d.sections %}
+      <div class="module-card" data-module="{{ s.module|lower }}">
+        <div class="module-header">
+          <div class="module-title">{{ s.module }}</div>
+          <span class="badge badge-primary">{{ s.hashes|length }} commit(s)</span>
+        </div>
+        <div class="summary-box">
+          {{ s.text }}
+        </div>
+        {% if s.note %}
+        <div style="font-size: 0.8rem; color: var(--warning); margin-bottom: 10px;">⚠️ {{ s.note }}</div>
+        {% endif %}
+
+        {% if s.commits %}
+        <table class="commit-table">
+          <tbody>
+            {% for cm in s.commits %}
+            <tr class="commit-row" data-search="{{ cm.subject|lower }} {{ cm.author|lower }} {{ cm.hash|lower }}">
+              <td style="width: 80px;">
+                {% if cm.type == 'feat' %}<span class="badge badge-success">FEAT</span>
+                {% elif cm.type == 'fix' %}<span class="badge badge-danger">FIX</span>
+                {% elif cm.type in ['perf', 'refactor'] %}<span class="badge badge-accent">{{ cm.type|upper }}</span>
+                {% else %}<span class="badge" style="background: var(--chip-bg); color: var(--text-muted);">{{ cm.type|upper }}</span>{% endif %}
+              </td>
+              <td style="width: 90px;">
+                {% if d.remote_url %}
+                <a href="{{ d.remote_url }}/commit/{{ cm.hash }}" target="_blank" class="commit-hash">{{ cm.hash }}</a>
+                {% else %}
+                <span class="commit-hash">{{ cm.hash }}</span>
+                {% endif %}
+              </td>
+              <td>{{ cm.subject }}</td>
+              <td style="width: 140px; color: var(--text-muted); font-size: 0.8rem;">{{ cm.author }}</td>
+              <td style="width: 100px; text-align: right; font-size: 0.8rem;">
+                <span style="color: var(--success);">+{{ cm.added }}</span> / <span style="color: var(--danger);">-{{ cm.deleted }}</span>
+              </td>
+            </tr>
+            {% endfor %}
+          </tbody>
+        </table>
+        {% endif %}
+      </div>
+      {% endfor %}
+    </div>
+
+    <!-- In Progress (Open Branches) -->
+    {% if d.in_progress %}
+    <div class="module-card">
+      <div class="module-title" style="margin-bottom: 12px;">🌿 In Progress (Open Branches)</div>
+      <table>
+        <thead>
+          <tr>
+            <th>Branch</th>
+            <th>Commits Ahead</th>
+            <th>Last Updated</th>
+            <th>Latest Subject</th>
+          </tr>
+        </thead>
+        <tbody>
+          {% for b in d.in_progress %}
+          <tr>
+            <td><code>{{ b.name }}</code></td>
+            <td><span class="badge badge-warning">{{ b.ahead }}</span></td>
+            <td>{{ b.last_date }}</td>
+            <td>{{ b.subject }}</td>
+          </tr>
+          {% endfor %}
+        </tbody>
+      </table>
+    </div>
+    {% endif %}
+
+    <!-- Planned Goals -->
+    {% if d.planned %}
+    <div class="module-card">
+      <div class="module-title" style="margin-bottom: 12px;">🎯 Planned Goals for Next Period</div>
+      <ul style="padding-left: 20px; line-height: 1.8;">
+        {% for p in d.planned %}
+        <li>{{ p }}</li>
+        {% endfor %}
+      </ul>
+    </div>
+    {% endif %}
+
+    <footer>
+      Generated by <strong>Git2Report</strong> on {{ d.generated }} &bull; Mode: {{ d.mode_label }}
+    </footer>
+  </div>
+
+  <script>
+    function toggleTheme() {
+      document.body.classList.toggle('light');
+      localStorage.setItem('g2r-theme', document.body.classList.contains('light') ? 'light' : 'dark');
+    }
+    if (localStorage.getItem('g2r-theme') === 'light') {
+      document.body.classList.add('light');
+    }
+    function filterCommits() {
+      const q = document.getElementById('commitSearch').value.toLowerCase();
+      const rows = document.querySelectorAll('.commit-row');
+      rows.forEach(r => {
+        const text = r.getAttribute('data-search') || '';
+        r.style.display = text.includes(q) ? '' : 'none';
+      });
+    }
+  </script>
+</body>
+</html>
+"""
+
+
+def render_html(data: ReportData) -> str:
+    template = Template(HTML_TEMPLATE)
+    return template.render(d=data)