eduevidence 5.2.0 → 6.0.0

package/visualization/eduevidence-report/scripts/lieflat_engine.py

@@ -34,8 +34,8 @@ THEME_PALETTES = {
     "presentation": {"bg": "#140A08", "card_bg": "#1C0D0A", "text": "#FBBF24", "subtext": "#D97706", "muted": "#9A3412", "grid": "#2D120B", "border": "#4A2218", "primary": "#F59E0B", "secondary": "#F24D29", "accent": "#10B981", "ribbon": "#2A140E"},
 }
 
-STAGGER_DOT = 12   # ms per dot (token range 8–15)
-STAGGER_BAR = 100  # ms per bar (token range 80–130)
+STAGGER_DOT = 12
+STAGGER_BAR = 100
 MIN_FONT = 6.5
 
 
@@ -77,9 +77,6 @@ def _fmt(v: float, digits: int = 2) -> str:
 
 
 class Audit:
-    """Collects every displayed number as (origin, value) for the
-    lieflat_data_bound integrity gate."""
-
     def __init__(self, out: Optional[list] = None):
         self.out: list[Tuple[str, Any]] = [] if out is None else out
 
@@ -96,10 +93,6 @@ def _svg_open(p: Dict[str, str], w: int, h: int, aria: str) -> List[str]:
             f'style="background:{p["card_bg"]};">']
 
 
-# ══════════════════════════════════════════════════════════════════════════
-# meta.forest — forest plot (Hedges' g + 95% CI)
-# ══════════════════════════════════════════════════════════════════════════
-
 def render_forest_plot(bundle: dict, theme: str, meta: dict, audit: Optional[list] = None) -> str:
     p = get_theme(theme)
     A = Audit(audit)
@@ -122,7 +115,6 @@ def render_forest_plot(bundle: dict, theme: str, meta: dict, audit: Optional[lis
     out.append(f'<text x="{cx:.0f}" y="{head_y}" text-anchor="middle" font-size="10" font-weight="700" fill="{p["subtext"]}" {lf_fade(60)}>Hedges&#39; g [95% CI]</text>')
     out.append(f'<text x="{w - 24}" y="{head_y}" text-anchor="end" font-size="10" font-weight="700" fill="{p["subtext"]}" {lf_fade(90)}>Effect [95% CI]</text>')
     out.append(f'<line x1="20" y1="{head_y + 8}" x2="{w - 20}" y2="{head_y + 8}" stroke="{p["border"]}" stroke-width="1" {lf_draw(0)}/>')
-    # zero line
     out.append(f'<line x1="{cx:.1f}" y1="{head_y + 8}" x2="{cx:.1f}" y2="{h - 56}" stroke="{p["muted"]}" stroke-dasharray="3,3" stroke-width="1" {lf_fade(120)}/>')
     row_y = head_y + 26
     for i, s in enumerate(studies):
@@ -145,11 +137,11 @@ def render_forest_plot(bundle: dict, theme: str, meta: dict, audit: Optional[lis
             out.append(f'<line x1="{xl:.1f}" y1="{row_y}" x2="{xu:.1f}" y2="{row_y}" stroke="{color}" stroke-width="1.5" {lf_draw(i * STAGGER_BAR + 120)}/>')
             out.append(f'<line x1="{xl:.1f}" y1="{row_y - 4}" x2="{xl:.1f}" y2="{row_y + 4}" stroke="{color}" stroke-width="1.5" {lf_fade(i * STAGGER_BAR + 140)}/>')
             out.append(f'<line x1="{xu:.1f}" y1="{row_y - 4}" x2="{xu:.1f}" y2="{row_y + 4}" stroke="{color}" stroke-width="1.5" {lf_fade(i * STAGGER_BAR + 140)}/>')
-        out.append(f'<rect x="{x_pt - 3.5:.1f}" y="{row_y - 3.5:.1f}" width="7" height="7" fill="{color}" {lf_pop(i * STAGGER_BAR + 150)}><title>{esc(str(s["label"]))} — g = {g:+.2f}{f", N = {s["n"]:.0f}" if s.get("n") else ""}</title></rect>')
+        n_suffix = (", N = %.0f" % s["n"]) if s.get("n") else ""
+        out.append(f'<rect x="{x_pt - 3.5:.1f}" y="{row_y - 3.5:.1f}" width="7" height="7" fill="{color}" {lf_pop(i * STAGGER_BAR + 150)}><title>{esc(str(s["label"]))} — g = {g:+.2f}{n_suffix}</title></rect>')
         ci_txt = f'{g:+.2f} [{ci_l:+.2f}, {ci_u:+.2f}]' if ci_l is not None and ci_u is not None else f"{g:+.2f}"
         out.append(f'<text x="{w - 24}" y="{row_y + 4}" text-anchor="end" font-size="10" font-weight="800" fill="{color}" {lf_fade(i * STAGGER_BAR + 200)}>{ci_txt}</text>')
         row_y += 27
-    # axis
     axis_y = h - 48
     out.append(f'<line x1="{cx - 0.34 * w:.0f}" y1="{axis_y}" x2="{cx + 0.34 * w:.0f}" y2="{axis_y}" stroke="{p["text"]}" stroke-width="1" {lf_draw(200)}/>')
     for tick in (-1.0, -0.5, 0.0, 0.5, 1.0):
@@ -165,10 +157,6 @@ def render_forest_plot(bundle: dict, theme: str, meta: dict, audit: Optional[lis
     return "\n".join(out)
 
 
-# ══════════════════════════════════════════════════════════════════════════
-# evidence.ranked_effects — L2 Dot Cascade
-# ══════════════════════════════════════════════════════════════════════════
-
 def render_dot_cascade(bundle: dict, theme: str, meta: dict, audit: Optional[list] = None) -> str:
     p = get_theme(theme)
     A = Audit(audit)
@@ -204,10 +192,6 @@ def render_dot_cascade(bundle: dict, theme: str, meta: dict, audit: Optional[lis
     return "\n".join(out)
 
 
-# ══════════════════════════════════════════════════════════════════════════
-# evidence.year_x_dimension — L9 Bubble Almanac
-# ══════════════════════════════════════════════════════════════════════════
-
 def render_bubble_almanac(bundle: dict, theme: str, meta: dict, audit: Optional[list] = None) -> str:
     p = get_theme(theme)
     A = Audit(audit)
@@ -247,10 +231,6 @@ def render_bubble_almanac(bundle: dict, theme: str, meta: dict, audit: Optional[
     return "\n".join(out)
 
 
-# ══════════════════════════════════════════════════════════════════════════
-# evidence.grouped_distribution — G15 Jitter Strip
-# ══════════════════════════════════════════════════════════════════════════
-
 def render_jitter_strip(bundle: dict, theme: str, meta: dict, audit: Optional[list] = None) -> str:
     p = get_theme(theme)
     A = Audit(audit)
@@ -280,10 +260,6 @@ def render_jitter_strip(bundle: dict, theme: str, meta: dict, audit: Optional[li
     return "\n".join(out)
 
 
-# ══════════════════════════════════════════════════════════════════════════
-# evidence.multidim_top — L20 Parallel Coordinates
-# ══════════════════════════════════════════════════════════════════════════
-
 def render_parallel_coordinates(bundle: dict, theme: str, meta: dict, audit: Optional[list] = None) -> str:
     p = get_theme(theme)
     A = Audit(audit)
@@ -329,16 +305,13 @@ def render_parallel_coordinates(bundle: dict, theme: str, meta: dict, audit: Opt
         if len(d_parts) < 2:
             continue
         title = f'{esc(str(r["label"]))} — ' + ", ".join(f'{ax["key"]}={r.get(ax["key"])}' for ax in axes)
-        out.append(f'<polyline points="{" ".join(d_parts)}" fill="none" stroke="{p["primary"]}" stroke-width="1" opacity="0.45" {lf_draw(r_i * STAGGER_BAR + 120)}><title>{title}</title></polyline>')
+        points_text = " ".join(d_parts)
+        out.append(f'<polyline points="{points_text}" fill="none" stroke="{p["primary"]}" stroke-width="1" opacity="0.45" {lf_draw(r_i * STAGGER_BAR + 120)}><title>{title}</title></polyline>')
         out.append(f'<circle cx="{d_parts[0].split()[0]}" cy="{d_parts[0].split()[1]}" r="2.4" fill="{p["primary"]}" {lf_pop(r_i * STAGGER_BAR + 140)}/>')
     out.append("</svg>")
     return "\n".join(out)
 
 
-# ══════════════════════════════════════════════════════════════════════════
-# evidence.study_type_composition / wwc — L14 Hundred Field
-# ══════════════════════════════════════════════════════════════════════════
-
 def render_hundred_field(bundle: dict, theme: str, meta: dict, audit: Optional[list] = None) -> str:
     p = get_theme(theme)
     A = Audit(audit)
@@ -363,10 +336,6 @@ def render_hundred_field(bundle: dict, theme: str, meta: dict, audit: Optional[l
     return "\n".join(out)
 
 
-# ══════════════════════════════════════════════════════════════════════════
-# evidence.study_type_composition / wwc — F4 Tick Donut
-# ══════════════════════════════════════════════════════════════════════════
-
 def render_tick_donut(bundle: dict, theme: str, meta: dict, audit: Optional[list] = None) -> str:
     p = get_theme(theme)
     A = Audit(audit)
@@ -376,7 +345,6 @@ def render_tick_donut(bundle: dict, theme: str, meta: dict, audit: Optional[list
     out = _svg_open(p, w, h, meta.get("title", "tick donut"))
     cx, cy, r0, r1 = 200, 158, 88, 104
     colors = [p["primary"], p["secondary"], p["accent"], p["muted"]]
-    # largest-remainder share of 100 ticks
     ticks_per = []
     assigned = 0
     for c_i, c in enumerate(cats):
@@ -385,13 +353,13 @@ def render_tick_donut(bundle: dict, theme: str, meta: dict, audit: Optional[list
         n = int(round(share))
         ticks_per.append((c_i, n))
         assigned += n
-    while assigned > 100:  # trim the largest over-assignment
+    while assigned > 100:
         c_i, n = max(ticks_per, key=lambda t: t[1])
         ticks_per[ticks_per.index((c_i, n))] = (c_i, n - 1)
         assigned -= 1
-    while assigned < 100:  # give the remainder to the largest category
-        c_i, _ = max(ticks_per, key=lambda t: t[1])
-        ticks_per[ticks_per.index((c_i, _))] = (c_i, _ + 1)
+    while assigned < 100:
+        c_i, n = max(ticks_per, key=lambda t: t[1])
+        ticks_per[ticks_per.index((c_i, n))] = (c_i, n + 1)
         assigned += 1
     tick_i = 0
     for c_i, n in ticks_per:
@@ -408,10 +376,6 @@ def render_tick_donut(bundle: dict, theme: str, meta: dict, audit: Optional[list
     return "\n".join(out)
 
 
-# ══════════════════════════════════════════════════════════════════════════
-# outcomes.direction_counts — F5 Tick Rows
-# ══════════════════════════════════════════════════════════════════════════
-
 def _dir_colors(p: Dict[str, str]) -> Dict[str, str]:
     return {"positive": p["secondary"], "negative": p["primary"], "null": p["muted"]}
 
@@ -448,10 +412,6 @@ def render_tick_rows(bundle: dict, theme: str, meta: dict, audit: Optional[list]
     return "\n".join(out)
 
 
-# ══════════════════════════════════════════════════════════════════════════
-# outcomes.direction_counts — F1 Rung Bars
-# ══════════════════════════════════════════════════════════════════════════
-
 def render_rung_bars(bundle: dict, theme: str, meta: dict, audit: Optional[list] = None) -> str:
     p = get_theme(theme)
     A = Audit(audit)
@@ -461,8 +421,6 @@ def render_rung_bars(bundle: dict, theme: str, meta: dict, audit: Optional[list]
     colors = _dir_colors(p)
     x_start, x_end, y_base = 60, 516, 240
     bar_w = min(52, (x_end - x_start) / max(1, len(rows)) * 0.62)
-    total_max = max((r["positive"] + r["negative"] + r["null"]) for r in rows) or 1
-    rung_h = 5.5
     for r_i, r in enumerate(rows):
         cx = x_start + (r_i + 0.5) * (x_end - x_start) / len(rows)
         label = r.get("label_" + meta.get("lang", "en"), r.get("label_en", r["label"]))
@@ -474,8 +432,8 @@ def render_rung_bars(bundle: dict, theme: str, meta: dict, audit: Optional[list]
             for _ in range(count):
                 if y_base - y > 118:
                     break
-                y -= rung_h + 2.2
-                out.append(f'<rect x="{cx - bar_w / 2:.1f}" y="{y:.1f}" width="{bar_w:.1f}" height="{rung_h}" rx="2.6" fill="{colors[key]}" {lf_fade(r_i * STAGGER_BAR + shown * STAGGER_DOT + 60)}><title>{esc(str(label))} — {key} evidence</title></rect>')
+                y -= 7.7
+                out.append(f'<rect x="{cx - bar_w / 2:.1f}" y="{y:.1f}" width="{bar_w:.1f}" height="5.5" rx="2.6" fill="{colors[key]}" {lf_fade(r_i * STAGGER_BAR + shown * STAGGER_DOT + 60)}><title>{esc(str(label))} — {key} evidence</title></rect>')
                 shown += 1
             if shown < count:
                 out.append(f'<text x="{cx:.1f}" y="{y - 4:.1f}" text-anchor="middle" font-size="{MIN_FONT + 1.5}" font-weight="800" fill="{p["subtext"]}" {lf_fade(r_i * STAGGER_BAR + 500)}>+{count - shown}</text>')
@@ -486,10 +444,6 @@ def render_rung_bars(bundle: dict, theme: str, meta: dict, audit: Optional[list]
     return "\n".join(out)
 
 
-# ══════════════════════════════════════════════════════════════════════════
-# outcomes.paired_counts — F6 Paired Rungs
-# ══════════════════════════════════════════════════════════════════════════
-
 def render_paired_rungs(bundle: dict, theme: str, meta: dict, audit: Optional[list] = None) -> str:
     p = get_theme(theme)
     A = Audit(audit)
@@ -506,6 +460,7 @@ def render_paired_rungs(bundle: dict, theme: str, meta: dict, audit: Optional[li
     for r_i, r in enumerate(rows):
         cx = 60 + (r_i + 0.5) * group_w
         label = r.get("label_" + lang, r.get("label_en", r["label"]))
+        last_y = y_base
         for col, key in ((0, "positive"), (1, "negative")):
             count = int(r.get(key) or 0)
             A.log(f"rows[{r_i}].{key}", count)
@@ -514,23 +469,20 @@ def render_paired_rungs(bundle: dict, theme: str, meta: dict, audit: Optional[li
             for _ in range(count):
                 if y_base - y > 130:
                     break
-                y -= 5.5 + 2.2
+                y -= 7.7
                 x = cx - col_w - 4 + col * (col_w + 8)
                 out.append(f'<rect x="{x:.1f}" y="{y:.1f}" width="{col_w}" height="5.5" rx="2.6" fill="{colors[key]}" {lf_fade(r_i * STAGGER_BAR + shown * STAGGER_DOT + 60)}><title>{esc(str(label))} — {key}</title></rect>')
                 shown += 1
+            last_y = min(last_y, y)
             if shown < count:
                 out.append(f'<text x="{cx:.1f}" y="{y - 4:.1f}" text-anchor="middle" font-size="{MIN_FONT + 1.5}" font-weight="800" fill="{p["subtext"]}" {lf_fade(r_i * STAGGER_BAR + 500)}>+{count - shown}</text>')
         out.append(f'<text x="{cx:.1f}" y="{y_base + 16}" text-anchor="middle" font-size="{MIN_FONT + 1.5}" font-weight="600" fill="{p["subtext"]}" {lf_fade(r_i * STAGGER_BAR + 100)}>{esc(str(label)[:10])}</text>')
-        out.append(f'<text x="{cx:.1f}" y="{y - 8:.1f}" text-anchor="middle" font-size="8" font-weight="800" fill="{p["text"]}" {lf_fade(r_i * STAGGER_BAR + 520)}>{r["positive"]} / {r["negative"]}</text>')
+        out.append(f'<text x="{cx:.1f}" y="{last_y - 8:.1f}" text-anchor="middle" font-size="8" font-weight="800" fill="{p["text"]}" {lf_fade(r_i * STAGGER_BAR + 520)}>{r["positive"]} / {r["negative"]}</text>')
     out.append(f'<line x1="46" y1="{y_base}" x2="512" y2="{y_base}" stroke="{p["text"]}" stroke-width="1.2" {lf_draw(120)}/>')
     out.append("</svg>")
     return "\n".join(out)
 
 
-# ══════════════════════════════════════════════════════════════════════════
-# outcomes.bipolar_axes — L7 Brand Spectrum
-# ══════════════════════════════════════════════════════════════════════════
-
 def render_brand_spectrum(bundle: dict, theme: str, meta: dict, audit: Optional[list] = None) -> str:
     p = get_theme(theme)
     A = Audit(audit)
@@ -545,11 +497,12 @@ def render_brand_spectrum(bundle: dict, theme: str, meta: dict, audit: Optional[
     out.append(f'<text x="{x0 - 12}" y="62" text-anchor="end" font-size="9" font-weight="700" fill="{p["subtext"]}" {lf_fade(40)}>{esc(left_t)}</text>')
     out.append(f'<text x="{x1 + 12}" y="62" font-size="9" font-weight="700" fill="{p["subtext"]}" {lf_fade(80)}>{esc(right_t)}</text>')
     px = lambda t: x0 + t * (x1 - x0)
-    ribbon = [f"{px(axes[0]['position']):.1f} {y0}"]
+    ribbon = [f"{px(axes[0]['position']):.1f} {y0}"] if axes else []
     for i in range(1, len(axes)):
         ribbon.append(f"C {px(axes[i-1]['position']):.1f} {y0 + (i-1)*gap + gap/2:.1f}, {px(axes[i]['position']):.1f} {y0 + i*gap - gap/2:.1f}, {px(axes[i]['position']):.1f} {y0 + i*gap}")
-    ribbon_d = f"M {ribbon[0]} " + " ".join(ribbon[1:])
-    out.append(f'<path d="{ribbon_d}" fill="none" stroke="{p["ribbon"]}" stroke-width="26" stroke-linecap="round" stroke-linejoin="round" opacity="0.95" {lf_draw(60)}/>')
+    if ribbon:
+        ribbon_d = f"M {ribbon[0]} " + " ".join(ribbon[1:])
+        out.append(f'<path d="{ribbon_d}" fill="none" stroke="{p["ribbon"]}" stroke-width="26" stroke-linecap="round" stroke-linejoin="round" opacity="0.95" {lf_draw(60)}/>')
     for i, ax in enumerate(axes):
         y = y0 + i * gap
         pos = float(ax["position"])
@@ -573,10 +526,6 @@ def render_brand_spectrum(bundle: dict, theme: str, meta: dict, audit: Optional[
     return "\n".join(out)
 
 
-# ══════════════════════════════════════════════════════════════════════════
-# intervention.phase_weeks — L3 Barcode Lollipop
-# ══════════════════════════════════════════════════════════════════════════
-
 def render_barcode_lollipop(bundle: dict, theme: str, meta: dict, audit: Optional[list] = None) -> str:
     p = get_theme(theme)
     A = Audit(audit)
@@ -601,7 +550,7 @@ def render_barcode_lollipop(bundle: dict, theme: str, meta: dict, audit: Optiona
         out.append(f'<line x1="{x:.1f}" y1="{y_base}" x2="{x:.1f}" y2="{y:.1f}" stroke="{p["grid"]}" stroke-width="0.7" {lf_fade(60)}/>')
         is_peak = wk["week"] in peak_weeks
         out.append(f'<line x1="{x:.1f}" y1="{y:.1f}" x2="{x:.1f}" y2="{min(y_base, y + 12 + ((i * 7) % 12)):.1f}" stroke="{p["text"]}" stroke-width="{1.4 if is_peak else 0.9}" {lf_fade(min(i * STAGGER_BAR, 1200) + 80)}/>')
-        out.append(f'<circle cx="{x:.1f}" cy="{y:.1f}" r="{4.8 if is_peak else 2.5:.1f}" fill="{p["primary"] if is_peak else p["text"]}" {lf_pop(min(i * STAGGER_DOT, 700) + 160)}><title>{esc(lang == "zh" and f"第 {wk['week']} 周 — 阶段 {phase}" or f"week {wk['week']} — phase {phase}")}</title></circle>')
+        out.append(f'<circle cx="{x:.1f}" cy="{y:.1f}" r="{4.8 if is_peak else 2.5:.1f}" fill="{p["primary"] if is_peak else p["text"]}" {lf_pop(min(i * STAGGER_DOT, 700) + 160)}/>')
         if is_peak:
             pk = next((q for q in peaks if q["week"] == wk["week"]), None)
             pk_txt = (pk or {}).get("label_zh" if lang == "zh" else "label_en", "")
@@ -616,10 +565,6 @@ def render_barcode_lollipop(bundle: dict, theme: str, meta: dict, audit: Optiona
     return "\n".join(out)
 
 
-# ══════════════════════════════════════════════════════════════════════════
-# intervention.activity_weights — L1 Launch Fan
-# ══════════════════════════════════════════════════════════════════════════
-
 def render_launch_fan(bundle: dict, theme: str, meta: dict, audit: Optional[list] = None) -> str:
     p = get_theme(theme)
     A = Audit(audit)
@@ -647,10 +592,6 @@ def render_launch_fan(bundle: dict, theme: str, meta: dict, audit: Optional[list
     return "\n".join(out)
 
 
-# ══════════════════════════════════════════════════════════════════════════
-# intervention.phase_groups — L8 Dotty Matrix
-# ══════════════════════════════════════════════════════════════════════════
-
 def render_dotty_matrix(bundle: dict, theme: str, meta: dict, audit: Optional[list] = None) -> str:
     p = get_theme(theme)
     A = Audit(audit)
@@ -661,6 +602,7 @@ def render_dotty_matrix(bundle: dict, theme: str, meta: dict, audit: Optional[li
 
     def P(c, r, k):
         return 236 + (c - r) * 17, 244 + (c + r) * 8.4 - k * 52
+
     for k in range(len(layers)):
         cs = [P(-0.6, -0.6, k), P(5.6, -0.6, k), P(5.6, 5.6, k), P(-0.6, 5.6, k)]
         poly_d = "M " + " L ".join(f"{x:.1f} {y:.1f}" for x, y in cs) + " Z"
@@ -679,10 +621,6 @@ def render_dotty_matrix(bundle: dict, theme: str, meta: dict, audit: Optional[li
     return "\n".join(out)
 
 
-# ══════════════════════════════════════════════════════════════════════════
-# decision.confidence_score — F11 Tick Gauge
-# ══════════════════════════════════════════════════════════════════════════
-
 def render_tick_gauge(bundle: dict, theme: str, meta: dict, audit: Optional[list] = None) -> str:
     p = get_theme(theme)
     A = Audit(audit)
@@ -705,10 +643,6 @@ def render_tick_gauge(bundle: dict, theme: str, meta: dict, audit: Optional[list
     return "\n".join(out)
 
 
-# ══════════════════════════════════════════════════════════════════════════
-# methodology.flag_rates — L15 Ballot Tally
-# ══════════════════════════════════════════════════════════════════════════
-
 def render_ballot_tally(bundle: dict, theme: str, meta: dict, audit: Optional[list] = None) -> str:
     p = get_theme(theme)
     A = Audit(audit)
@@ -730,17 +664,14 @@ def render_ballot_tally(bundle: dict, theme: str, meta: dict, audit: Optional[li
             x = 162 + t * 11
             if x > 470:
                 break
-            out.append(f'<rect x="{x:.1f}" y="{yc - 4:.1f}" width="8" height="8" rx="2" fill="{p["primary"] if t < flagged else p["grid"]}" {lf_pop(min(r_i * STAGGER_BAR + t * STAGGER_DOT, 1400))}><title>{esc(str(label))} — verdict {t + 1}/{total}{" (flagged)" if t < flagged else ""}</title></rect>')
+            flag_suffix = " (flagged)" if t < flagged else ""
+            out.append(f'<rect x="{x:.1f}" y="{yc - 4:.1f}" width="8" height="8" rx="2" fill="{p["primary"] if t < flagged else p["grid"]}" {lf_pop(min(r_i * STAGGER_BAR + t * STAGGER_DOT, 1400))}><title>{esc(str(label))} — verdict {t + 1}/{total}{flag_suffix}</title></rect>')
         out.append(f'<text x="512" y="{yc + 3:.1f}" text-anchor="end" font-size="9" font-weight="800" fill="{p["text"]}" {lf_fade(r_i * STAGGER_BAR + 300)}>{flagged}/{total}</text>')
     out.append(f'<text x="30" y="280" font-size="7.5" font-weight="600" fill="{p["muted"]}" {lf_fade(500)}>{esc(str(bundle.get("derived", ""))[:70])}</text>')
     out.append("</svg>")
     return "\n".join(out)
 
 
-# ══════════════════════════════════════════════════════════════════════════
-# evidence.year_x_outcome_counts — L16 Matrix Heat
-# ══════════════════════════════════════════════════════════════════════════
-
 def render_matrix_heat(bundle: dict, theme: str, meta: dict, audit: Optional[list] = None) -> str:
     p = get_theme(theme)
     A = Audit(audit)
@@ -772,15 +703,10 @@ def render_matrix_heat(bundle: dict, theme: str, meta: dict, audit: Optional[lis
             else:
                 out.append(f'<rect x="{x + 2:.1f}" y="{y + 2:.1f}" width="{cell_w - 4:.1f}" height="{cell_h - 4}" rx="4" fill="{p["grid"]}" fill-opacity="0.5" {lf_fade((i + j) * STAGGER_DOT)}/>')
             out.append(f'<text x="{x + cell_w / 2:.1f}" y="{y + cell_h / 2 + 3:.1f}" text-anchor="middle" font-size="{MIN_FONT + 1.5}" font-weight="800" fill="{p["text"]}" {lf_pop(min((i + j) * STAGGER_DOT + 60, 900))}>{v}</text>')
-            out.append(f'<title>{esc(str(label))} × {esc(str(years[j]))} — {v} studies</title>')
     out.append("</svg>")
     return "\n".join(out)
 
 
-# ══════════════════════════════════════════════════════════════════════════
-# Registry + dispatcher
-# ══════════════════════════════════════════════════════════════════════════
-
 REGISTRY: Dict[str, Dict[str, Any]] = {
     "forest_plot": {"catalog_ref": "FOREST-PLOT (publication figure)", "source": "meta.forest",
                     "extractor": CD.extract_meta_forest, "renderer": render_forest_plot,
@@ -844,8 +770,6 @@ ACADEMIC_FIGURE_KEYS = ("outcome-comparison.svg", "benchmark-citation-support.sv
 
 def render_figure(fig_type: str, bundle: dict, theme: str, meta: dict,
                   audit: Optional[list] = None) -> str:
-    """Dispatch to the registered renderer. Unknown types raise ValueError —
-    the caller records the reason and never silently falls back."""
     entry = REGISTRY.get(fig_type)
     if entry is None:
         raise ValueError(f"unregistered lieflat chart type: {fig_type!r}")

package/visualization/eduevidence-report/themes/academic.css

@@ -13,7 +13,7 @@
 :root[data-theme="academic"] body { font-size:15px; line-height:1.58; }
 :root[data-theme="academic"] .report-shell { max-width:980px; padding-top:22px; }
 :root[data-theme="academic"] .report-header { border-bottom:2px solid #222; margin-bottom:34px; }
-:root[data-theme="academic"] .report-header h1 { font-size:2rem; line-height:1.18; text-align:center; }
+:root[data-theme="academic"] .report-header h1 { font-size:clamp(1.5rem,2.2vw,1.7rem); line-height:1.18; text-align:center; }
 :root[data-theme="academic"] .report-header .meta { text-align:center; }
 :root[data-theme="academic"] .report-section { background:transparent; border:0; box-shadow:none; padding:0; margin-bottom:34px; }
 :root[data-theme="academic"] .report-section>h2 { font-size:1.08rem; border-bottom:1px solid #444; border-radius:0; padding:0 0 5px; }

package/visualization/eduevidence-report/themes/claude.css

@@ -12,7 +12,7 @@
 }
 :root[data-theme="claude"] .report-shell { max-width:1240px; padding-top:34px; }
 :root[data-theme="claude"] .report-header { max-width:900px; margin:0 auto 42px; padding-bottom:22px; }
-:root[data-theme="claude"] .report-header h1 { font-size:clamp(1.9rem,4vw,3rem); line-height:1.18; font-weight:500; }
+:root[data-theme="claude"] .report-header h1 { font-size:clamp(1.55rem,2.8vw,2.25rem); line-height:1.18; font-weight:500; }
 :root[data-theme="claude"] .report-section { background:transparent; border:0; box-shadow:none; padding:0; }
 :root[data-theme="claude"] .report-section>h2 { border:0; font-size:1.4rem; padding:0; margin-bottom:7px; }
 :root[data-theme="claude"] .section-lead { background:transparent; border:0; padding:0; max-width:760px; margin-bottom:24px; }

package/visualization/eduevidence-report/themes/datalab-dark.css

@@ -22,7 +22,7 @@
   width:100%; max-width:none; margin:0 0 22px; padding:18px 20px;
   border:1px solid var(--border); border-radius:12px; background:var(--surface); box-shadow:var(--shadow);
 }
-:root[data-theme="datalab-dark"] .report-header h1 { max-width:1100px; font-size:clamp(1.55rem,2.6vw,2.15rem); line-height:1.22; }
+:root[data-theme="datalab-dark"] .report-header h1 { max-width:1100px; font-size:clamp(1.4rem,2vw,1.75rem); line-height:1.22; }
 :root[data-theme="datalab-dark"] .report-header .meta { margin:8px 0 0; font-size:.85rem; color:var(--text-muted); }
 :root[data-theme="datalab-dark"] .report-brand-row { margin-bottom:8px; }
 :root[data-theme="datalab-dark"] .report-brand { color:var(--primary); text-transform:uppercase; letter-spacing:.08em; font-size:.83rem; }
@@ -134,7 +134,7 @@
   :root[data-theme="datalab-dark"] .controls { width:calc(100% - 24px); padding:8px 10px; }
   :root[data-theme="datalab-dark"] .report-shell { padding-left:14px; padding-right:14px; }
   :root[data-theme="datalab-dark"] .report-header { padding:15px 14px; }
-  :root[data-theme="datalab-dark"] .report-header h1 { font-size:1.45rem; }
+  :root[data-theme="datalab-dark"] .report-header h1 { font-size:1.3rem; }
   :root[data-theme="datalab-dark"] .brief-block { padding:15px 14px; }
   :root[data-theme="datalab-dark"] .brief-decision { padding:0; }
   :root[data-theme="datalab-dark"] .brief-decision .brief-block-header { padding:15px 14px 0; }

package/visualization/eduevidence-report/themes/datalab.css

@@ -23,7 +23,7 @@
   width:100%; max-width:none; margin:0 0 22px; padding:18px 20px;
   border:1px solid var(--border); border-radius:12px; background:var(--surface); box-shadow:var(--shadow);
 }
-:root[data-theme="datalab"] .report-header h1 { max-width:1100px; font-size:clamp(1.55rem,2.6vw,2.15rem); line-height:1.22; }
+:root[data-theme="datalab"] .report-header h1 { max-width:1100px; font-size:clamp(1.4rem,2vw,1.75rem); line-height:1.22; }
 :root[data-theme="datalab"] .report-header .meta { margin:8px 0 0; font-size:.85rem; }
 :root[data-theme="datalab"] .report-brand-row { margin-bottom:8px; }
 :root[data-theme="datalab"] .report-brand { color:var(--primary); text-transform:uppercase; letter-spacing:.08em; font-size:.83rem; }
@@ -138,7 +138,7 @@
   :root[data-theme="datalab"] .controls { width:calc(100% - 24px); padding:8px 10px; }
   :root[data-theme="datalab"] .report-shell { padding-left:14px; padding-right:14px; }
   :root[data-theme="datalab"] .report-header { padding:15px 14px; }
-  :root[data-theme="datalab"] .report-header h1 { font-size:1.45rem; }
+  :root[data-theme="datalab"] .report-header h1 { font-size:1.3rem; }
   :root[data-theme="datalab"] .brief-block { padding:15px 14px; }
   :root[data-theme="datalab"] .brief-decision { padding:0; }
   :root[data-theme="datalab"] .brief-decision .brief-block-header { padding:15px 14px 0; }

package/visualization/eduevidence-report/themes/presentation.css

@@ -31,7 +31,7 @@
 :root[data-theme="presentation"] .report-brand-row { margin-bottom:12px; }
 :root[data-theme="presentation"] .report-brand { color:var(--primary); text-transform:uppercase; letter-spacing:.1em; font-size:.8rem; }
 :root[data-theme="presentation"] .generated-theme-chip { background:#242A33; border-color:#3C4450; color:#B8C0CB; }
-:root[data-theme="presentation"] .report-header h1 { max-width:980px; font-size:clamp(1.5rem,2.6vw,2.1rem); line-height:1.08; letter-spacing:-.022em; }
+:root[data-theme="presentation"] .report-header h1 { max-width:980px; font-size:clamp(1.35rem,2vw,1.7rem); line-height:1.08; letter-spacing:-.022em; }
 :root[data-theme="presentation"] .report-header .meta { margin:10px 0 0; color:var(--text-muted); font-size:.86rem; overflow-wrap:anywhere; }
 :root[data-theme="presentation"] .report-view-switcher { display:inline-flex; margin-top:18px; padding:4px; border:1px solid var(--border); border-radius:999px; background:#12151A; }
 :root[data-theme="presentation"] .report-view-btn { min-height:36px; border:0; background:transparent; color:#BBC2CC; padding:7px 15px; }
@@ -114,7 +114,7 @@
   :root[data-theme="presentation"] .controls { width:calc(100% - 24px); border-radius:10px; }
   :root[data-theme="presentation"] .report-shell { padding-left:14px; padding-right:14px; }
   :root[data-theme="presentation"] .report-header { padding:18px 16px; border-radius:12px; }
-  :root[data-theme="presentation"] .report-header h1 { font-size:1.25rem; }
+  :root[data-theme="presentation"] .report-header h1 { font-size:1.2rem; }
   :root[data-theme="presentation"] .brief-block { padding:18px 16px; }
   :root[data-theme="presentation"] .brief-decision { padding:0; }
   :root[data-theme="presentation"] .brief-decision .decision-hero { min-height:0; padding:24px 18px; border-radius:13px; }

package/web/README.md

@@ -0,0 +1,18 @@
+# web/ — 前端分发与兼容边界
+
+EduEvidence 当前正式控制台是 **Research Studio**。开发源与运行时分发物必须明确区分：
+
+- **唯一权威可编辑控制台源**：`studio/`（React + TypeScript + Vite）。新功能、交互、可访问性、移动端和数据契约只在这里开发。
+- **正式运行时控制台**：`web/studio/`。它是 `studio/` 的可复现构建产物，由 Python 本地服务、Skill 上架包和 GitHub Pages 直接提供；不要手工编辑其中的 bundle。
+- `web/landing.html/.css/.js`：公开介绍页，保持独立视觉叙事；它只负责介绍和进入 Research Studio，不拥有研究状态。
+- `web/index.html`、`web/js/`、`web/styles.css`：v5 时代三页控制台的**兼容层 / 历史实现**。现有兼容 API 或旧链接在确有需要时可以继续读取它们，但不得把它们当作新 UI 的开发入口，也不要向其中增加新的产品功能。
+- `web/showcase_v2/`：冻结展示页。除安全或断链修复外不再与 Research Studio 同步演进。
+
+## 约定
+
+1. 新的 Research Studio 页面、组件和交互只能进入 `studio/src/`；禁止继续扩展旧 `web/js/` 控制台。
+2. `npm run build --prefix studio` 必须可复现 `web/studio/`；CI 使用 `git diff --exit-code -- web/studio` 守护这一点。
+3. 本地正式入口是 `http://127.0.0.1:<port>/studio/`；`dashboard_server.py` 的 `/`、`/console` 也应指向同一构建。
+4. GitHub Pages 根页保留介绍页，`/studio/` 是公开只读 Research Studio；静态导出只包含仓库示例，不包含本地研究项目、运行事件或 Autoevolve 会话。
+5. 五种报告主题属于 `visualization/eduevidence-report/` 的**生成时视觉身份**，不是 Research Studio 的运行时换肤；同一研究版本的科学内容不得因主题改变。
+6. 报告本体保持 single-file / zero-CDN；营销介绍页可以使用外部字体等展示资源，但不应把它们引入研究报告的离线能力声明。

package/web/index.html

@@ -0,0 +1,53 @@
+<!doctype html>
+<html lang="zh-CN">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>EduEvidence Research Studio · Build unavailable</title>
+  <style>
+    :root { color-scheme: light dark; font-family: Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; }
+    * { box-sizing: border-box; }
+    body { margin: 0; min-height: 100vh; display: grid; place-items: center; background: #f7f6f3; color: #242321; padding: 24px; }
+    main { width: min(680px, 100%); background: #fff; border: 1px solid #dedbd5; border-radius: 18px; padding: clamp(28px, 6vw, 52px); box-shadow: 0 16px 55px rgba(42, 37, 31, .08); }
+    .eyebrow { margin: 0 0 18px; font-size: 12px; font-weight: 700; letter-spacing: .12em; text-transform: uppercase; color: #827d74; }
+    h1 { margin: 0; font-family: Georgia, "Times New Roman", serif; font-size: clamp(2rem, 7vw, 3.4rem); line-height: 1.02; font-weight: 500; letter-spacing: -.035em; }
+    p { margin: 22px 0 0; max-width: 56ch; line-height: 1.8; color: #625e57; }
+    code { font-family: ui-monospace, SFMono-Regular, Menlo, monospace; font-size: .9em; background: #f2f0ec; border-radius: 6px; padding: .15em .4em; color: #393631; }
+    .actions { display: flex; flex-wrap: wrap; gap: 10px; margin-top: 28px; }
+    a { display: inline-flex; align-items: center; min-height: 42px; padding: 0 15px; border-radius: 9px; border: 1px solid #ccc7bf; color: inherit; text-decoration: none; font-weight: 650; font-size: 14px; }
+    a.primary { background: #242321; color: #fff; border-color: #242321; }
+    small { display: block; margin-top: 30px; color: #8b867e; line-height: 1.65; }
+    @media (prefers-color-scheme: dark) {
+      body { background: #181817; color: #efede8; }
+      main { background: #211f1d; border-color: #3b3833; box-shadow: none; }
+      p, small, .eyebrow { color: #aaa49a; }
+      code { background: #302d29; color: #eeeae3; }
+      a { border-color: #504b44; }
+      a.primary { background: #efede8; color: #211f1d; border-color: #efede8; }
+    }
+  </style>
+</head>
+<body>
+  <main>
+    <p class="eyebrow">EduEvidence · Compatibility boundary</p>
+    <h1>Research Studio build unavailable.</h1>
+    <p>
+      旧版 v5 三页控制台已经退出正式产品路径。看到这个页面说明当前分发目录缺少
+      <code>web/studio/</code> 的可复现构建产物；服务不会再静默降级到旧控制台。
+    </p>
+    <p>
+      开发仓库请运行 <code>npm ci --prefix studio</code> 与
+      <code>npm run build --prefix studio</code>，然后重新启动本地 Python 服务。
+      正常入口始终是 <code>/studio/</code>。
+    </p>
+    <div class="actions">
+      <a class="primary" href="/studio/">重新检查 Research Studio</a>
+      <a href="/api/studio/catalog">检查只读数据接口</a>
+    </div>
+    <small>
+      This page is intentionally a fail-closed compatibility tombstone. It contains no research UI,
+      no legacy dashboard runtime, and no scientific fallback data.
+    </small>
+  </main>
+</body>
+</html>