Create drp/report.py

drp/report.py

@@ -0,0 +1,69 @@
+import json
+from typing import Any, Dict, List
+
+
+def render_report_markdown(diff: Dict[str, Any]) -> str:
+    s = diff["summary"]
+    counts = diff.get("class_counts", {})
+
+    lines: List[str] = []
+    lines.append("# DRP Differential Report")
+    lines.append("")
+    lines.append("## Summary")
+    lines.append(f"- Run A: `{s.get('run_a')}`")
+    lines.append(f"- Run B: `{s.get('run_b')}`")
+    lines.append(f"- Framework A/B: `{s.get('framework_a')}` / `{s.get('framework_b')}`")
+    lines.append(f"- Model A/B: `{s.get('model_a')}` / `{s.get('model_b')}`")
+    lines.append(f"- Events A/B: `{s.get('events_a')}` / `{s.get('events_b')}`")
+    lines.append(f"- First divergence index: `{s.get('first_divergence_index')}`")
+    lines.append("")
+
+    lines.append("## Divergence classes")
+    if counts:
+        for k in sorted(counts.keys()):
+            lines.append(f"- **{k}**: {counts[k]}")
+    else:
+        lines.append("- (no diffs)")
+    lines.append("")
+
+    lines.append("## First divergence detail (if any)")
+    first = s.get("first_divergence_index")
+    diffs = diff.get("differences", [])
+    first_item = None
+    if first is not None:
+        for item in diffs:
+            if item.get("i") == first:
+                first_item = item
+                break
+
+    if not first_item:
+        lines.append("- No divergence found (or divergence is only length mismatch).")
+        return "\n".join(lines)
+
+    lines.append(f"- Index: `{first_item.get('i')}`")
+    lines.append(f"- Class: `{first_item.get('class')}`")
+    lines.append(f"- Kind A/B: `{first_item.get('kind_a')}` / `{first_item.get('kind_b')}`")
+    lines.append(f"- Step A/B: `{first_item.get('step_a')}` / `{first_item.get('step_b')}`")
+    lines.append("")
+    lines.append("### Key diffs (first 25)")
+    for d in (first_item.get("diffs") or [])[:25]:
+        lines.append(f"- `{d.get('path')}` ({d.get('kind')}): A={_short(d.get('a'))} | B={_short(d.get('b'))}")
+
+    if "text_unified_diff" in first_item:
+        lines.append("")
+        lines.append("### Text unified diff (truncated)")
+        lines.append("```diff")
+        lines.append(first_item["text_unified_diff"][:8000])
+        lines.append("```")
+
+    return "\n".join(lines)
+
+
+def _short(x: Any, n: int = 180) -> str:
+    try:
+        s = json.dumps(x, ensure_ascii=False)
+    except Exception:
+        s = str(x)
+    if len(s) > n:
+        return s[:n] + "…"
+    return s