| import json |
| from typing import Any, Dict, List, Optional |
|
|
|
|
| def _short(x: Any, n: int = 160) -> str: |
| try: |
| s = json.dumps(x, ensure_ascii=False) |
| except Exception: |
| s = str(x) |
| if len(s) > n: |
| return s[:n] + "…" |
| return s |
|
|
|
|
| def _fmt_reward(x: Optional[float]) -> str: |
| if x is None: |
| return "n/a" |
| |
| return f"{x:.6g}" |
|
|
|
|
| def render_report_markdown(diff: Dict[str, Any]) -> str: |
| s = diff.get("summary", {}) |
| counts = diff.get("class_counts", {}) |
| first = s.get("first_divergence_index") |
|
|
| |
| line_bits: List[str] = [] |
| if first is None: |
| line_bits.append("Timelines identical") |
| else: |
| line_bits.append(f"Identical until index {first}") |
| line_bits.append(f"{s.get('diff_event_count', 0)} events differ") |
| if s.get("missing_event_count", 0): |
| line_bits.append(f"{s.get('missing_event_count')} missing") |
| if s.get("final_reward_delta") is not None: |
| line_bits.append(f"Final reward delta: {s.get('final_reward_delta'):.6g}") |
| one_liner = " · ".join(line_bits) |
|
|
| lines: List[str] = [] |
| lines.append("# DRP Differential Report") |
| lines.append("") |
| lines.append(f"**{one_liner}**") |
| lines.append("") |
| lines.append("## Run identity") |
| 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("") |
|
|
| if s.get("run_link_a") or s.get("run_link_b"): |
| lines.append("## Viewer links (if provided)") |
| if s.get("run_link_a"): |
| lines.append(f"- Run A viewer: {s.get('run_link_a')}") |
| if s.get("run_link_b"): |
| lines.append(f"- Run B viewer: {s.get('run_link_b')}") |
| lines.append("") |
|
|
| lines.append("## Summary stats") |
| lines.append(f"- First divergence index: `{s.get('first_divergence_index')}`") |
| lines.append(f"- Diff events: `{s.get('diff_event_count')}`") |
| lines.append(f"- Missing events: `{s.get('missing_event_count')}`") |
| lines.append(f"- Final reward A/B/Δ: `{_fmt_reward(s.get('final_reward_a'))}` / `{_fmt_reward(s.get('final_reward_b'))}` / `{_fmt_reward(s.get('final_reward_delta'))}`") |
| 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 first is None: |
| lines.append("- No divergence found.") |
| return "\n".join(lines) |
|
|
| first_item = None |
| for item in diff.get("differences", []): |
| if item.get("i") == first: |
| first_item = item |
| break |
|
|
| if not first_item: |
| |
| lines.append("- Divergence is a length mismatch or occurs where one side is missing.") |
| 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')}`") |
| if first_item.get("link_a") or first_item.get("link_b"): |
| lines.append("") |
| lines.append("### Jump to replay (if provided)") |
| if first_item.get("link_a"): |
| lines.append(f"- Open A @ i={first}: {first_item.get('link_a')}") |
| if first_item.get("link_b"): |
| lines.append(f"- Open B @ i={first}: {first_item.get('link_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) |
