#!/usr/bin/env python3 """Render a triage result (JSON the agent produced) to a CLI table + HTML report. The agent does the thinking: it reads the bug, classifies severity, traces the root cause, and recommends tests, following SKILL.md and references/severity-rubric.md. It writes that decision to triage.json. This script only presents it: a summary table in the terminal and a self-contained HTML report to attach to the ticket. Usage: python render.py triage.json # CLI table python render.py triage.json --html triage.html # + HTML report triage.json may be one object or a list of them (batch triage). Stdlib only. """ import argparse, json, sys, html, datetime SEV = { # code -> (label, css class, cli colour) "P0": ("Blocker", "p0", "\033[41m\033[97m"), "P1": ("Critical", "p1", "\033[31m"), "P2": ("Major", "p2", "\033[33m"), "P3": ("Minor", "p3", "\033[36m"), "P4": ("Trivial", "p4", "\033[32m"), } LAYERS = ["UI", "API", "Service", "DB", "Infra", "Third-party"] def load(path): data = json.load(open(path)) return data if isinstance(data, list) else [data] def sev_code(t): return (t.get("triage", {}).get("severity") or "P3").upper().split()[0] # ---------- cli ---------- def cli(bugs, color=True): C = {"b": "\033[1m", "d": "\033[2m", "x": "\033[0m"} if not color: C = {k: "" for k in C} for k in SEV: SEV[k] = (SEV[k][0], SEV[k][1], "") rows = sorted(bugs, key=lambda t: sev_code(t)) idw = min(max([len(b.get("bug", {}).get("id", "")) for b in rows] + [6]), 12) titw = 34 out = ["", f"{C['b']}Bug Triage{C['x']} {C['d']}{len(rows)} bug(s) - {datetime.date.today()}{C['x']}"] hdr = f"{'BUG':<{idw}} {'TITLE':<{titw}} {'SEV':<4} {'CATEGORY':<12} {'LAYER':<11} {'PRIORITY':<12} DUP" out += ["-" * len(hdr), f"{C['b']}{hdr}{C['x']}", "-" * len(hdr)] for t in rows: code = sev_code(t) label, _, col = SEV.get(code, SEV["P3"]) bug = t.get("bug", {}) tri = t.get("triage", {}) rc = t.get("root_cause", {}) dup = t.get("duplicates") or [] title = (bug.get("title", "") or "")[:titw] dupmark = f"{len(dup)}" if dup else "-" out.append( f"{bug.get('id',''):<{idw}} {title:<{titw}} " f"{col}{code:<4}{C['x']} {(tri.get('category','') or '')[:12]:<12} " f"{(rc.get('layer','') or '-')[:11]:<11} {(tri.get('sprint_priority','') or '')[:12]:<12} {dupmark}") out.append("-" * len(hdr)) # legend + counts counts = {} for t in rows: counts[sev_code(t)] = counts.get(sev_code(t), 0) + 1 summary = " ".join(f"{SEV[k][2]}{k}{C['x']} {counts[k]}" for k in ("P0", "P1", "P2", "P3", "P4") if k in counts) out.append(f"{C['b']}Summary:{C['x']} {summary}") out.append(f"{C['d']}severity is advisory + justified - never inflated - dev/lead confirm{C['x']}") out.append("") return "\n".join(out) # ---------- html ---------- def li(items): return "".join(f"
  • {html.escape(str(i))}
    • " for i in (items or [])) def card(t): e = lambda s: html.escape(str(s or ""), quote=True) bug = t.get("bug", {}) tri = t.get("triage", {}) rc = t.get("root_cause", {}) ts = t.get("tests", {}) dup = t.get("duplicates") or [] code = sev_code(t) label, cls, _ = SEV.get(code, SEV["P3"]) conf = tri.get("confidence", "") confbadge = f'{e(conf)} confidence' if conf else "" layer_dots = "".join( f'{l}' for l in LAYERS) dup_html = "" if dup: rows = "".join( f'{e(d.get("id",""))}{e(d.get("why",""))}' f'{e(d.get("similarity",""))}' for d in dup) dup_html = f'''

    Possible duplicates ({len(dup)})

    {rows}
    TicketWhy it may be the sameMatch

    Confirm before closing anything as duplicate. This is a lead, not a verdict.

    ''' return f'''
    {code} {e(label)} {confbadge}
    {e(bug.get("id",""))}

    {e(bug.get("title",""))}

    Category: {e(tri.get("category",""))} Component: {e(tri.get("component",""))} Priority: {e(tri.get("sprint_priority",""))} {f'Reporter: {e(bug.get("reporter",""))}' if bug.get("reporter") else ""}

    1. Triage

    Severity {code} ({e(label)}). {e(tri.get("severity_reason",""))}

    Business impact. {e(tri.get("business_impact",""))}

    2. Root cause

    {layer_dots}

    Likely cause. {e(rc.get("likely_cause",""))}

    {f'

    Related components. {e(", ".join(rc.get("related_components",[])))}

    ' if rc.get("related_components") else ""} {f'

    Investigate.

      {li(rc.get("investigation"))}
    ' if rc.get("investigation") else ""} {f'

    Check first: {e(", ".join(rc.get("check_first",[])))}

    ' if rc.get("check_first") else ""}

    3. Test strategy

    {f'

    Verification. {e(ts.get("verification",""))}

    ' if ts.get("verification") else ""} {f'

    Regression.

    ' if ts.get("regression") else ""} {f'

    Edge cases.

    ' if ts.get("edge_cases") else ""} {f'

    Automation. {e(ts.get("automation",""))}

    ' if ts.get("automation") else ""}
    {dup_html}
    ''' def report(bugs): ts = datetime.datetime.now().strftime("%Y-%m-%d %H:%M") counts = {} for t in bugs: counts[sev_code(t)] = counts.get(sev_code(t), 0) + 1 tiles = "".join( f'
    {k} {SEV[k][0]}
    {counts.get(k,0)}
    ' for k in ("P0", "P1", "P2", "P3", "P4")) cards = "\n".join(card(t) for t in sorted(bugs, key=sev_code)) return f''' Bug Triage Report

    Bug Triage Report

    {len(bugs)} bug(s) - generated {ts} - severity is advisory and justified, a human confirms before assignment
    {tiles}
    {cards}
    ''' def main(): ap = argparse.ArgumentParser(description="Render agent triage JSON to CLI + HTML.") ap.add_argument("input", help="triage.json (object or list)") ap.add_argument("--html", metavar="FILE") ap.add_argument("--no-color", action="store_true") a = ap.parse_args() bugs = load(a.input) print(cli(bugs, color=not a.no_color and sys.stdout.isatty())) if a.html: open(a.html, "w").write(report(bugs)) print(f"HTML report: {a.html}") if __name__ == "__main__": main()