Add deterministic exports, tooltips, and experimental relative ranking

public_space_app.py

@@ -1,9 +1,13 @@
 from __future__ import annotations
 
+import csv
 import html
 import json
+import math
 import os
 import re
+import tempfile
+import textwrap
 import urllib.request
 from pathlib import Path
 from typing import Any, Dict, Tuple
@@ -21,6 +25,12 @@ try:
 except ImportError as exc:  # pragma: no cover - runtime dependency
     raise RuntimeError("pyvis is required to run this Space bundle") from exc
 
+try:
+    from reportlab.lib.pagesizes import LETTER
+    from reportlab.pdfgen import canvas
+except ImportError as exc:  # pragma: no cover - runtime dependency
+    raise RuntimeError("reportlab is required to run relationship evidence exports") from exc
+
 
 def _read_json(source: str) -> Dict[str, Any]:
     if source.startswith("http://") or source.startswith("https://"):
@@ -246,15 +256,16 @@ def _space_css() -> str:
       margin: 0 auto !important;
       padding-bottom: 48px !important;
     }
-    .hero-panel {
+    .gradio-container .hero-panel {
       background: linear-gradient(135deg, #161c24 0%, #202733 100%);
-      border: 1px solid rgba(212, 162, 74, 0.34);
+      border: 1px solid rgba(212, 162, 74, 0.34) !important;
       border-radius: 24px;
       padding: 28px;
       margin: 6px 0 20px 0;
       box-shadow: 0 14px 34px rgba(0, 0, 0, 0.34);
+      color: #ddd5c8 !important;
     }
-    .hero-eyebrow {
+    .gradio-container .hero-eyebrow {
       font-size: 0.82rem;
       font-weight: 700;
       letter-spacing: 0.08em;
@@ -262,21 +273,21 @@ def _space_css() -> str:
       color: #d4a24a;
       margin-bottom: 8px;
     }
-    .hero-title {
+    .gradio-container .hero-title {
       font-size: 2.2rem;
       line-height: 1.1;
       font-weight: 800;
       color: #fff4e1;
       margin: 0 0 12px 0;
     }
-    .hero-lede {
+    .gradio-container .hero-lede {
       font-size: 1.05rem;
       line-height: 1.6;
       color: #e2dacd;
       margin: 0 0 10px 0;
       max-width: 900px;
     }
-    .hero-note {
+    .gradio-container .hero-note {
       font-size: 0.98rem;
       line-height: 1.5;
       color: #eee4d5;
@@ -296,24 +307,29 @@ def _space_css() -> str:
       display: inline-block;
       text-shadow: none !important;
     }
-    .stat-grid, .story-grid {
+    .gradio-container .stat-grid, .gradio-container .story-grid {
       display: grid;
       grid-template-columns: repeat(auto-fit, minmax(180px, 1fr));
       gap: 14px;
       margin-top: 18px;
     }
-    .story-grid {
+    .gradio-container .story-grid {
       grid-template-columns: repeat(auto-fit, minmax(220px, 1fr));
       margin: 10px 0 22px 0;
     }
-    .stat-card, .story-card, .source-card, .glossary-card, .result-card {
+    .gradio-container .stat-card,
+    .gradio-container .story-card,
+    .gradio-container .source-card,
+    .gradio-container .glossary-card,
+    .gradio-container .result-card {
       background: #151b22;
-      border: 1px solid rgba(212, 162, 74, 0.22);
+      border: 1px solid rgba(212, 162, 74, 0.22) !important;
       border-radius: 18px;
       padding: 16px 18px;
       box-shadow: 0 8px 18px rgba(0, 0, 0, 0.22);
+      color: #ddd5c8 !important;
     }
-    .stat-label {
+    .gradio-container .stat-label {
       font-size: 0.82rem;
       font-weight: 700;
       text-transform: uppercase;
@@ -321,62 +337,64 @@ def _space_css() -> str:
       color: #d4a24a;
       margin-bottom: 8px;
     }
-    .stat-value {
+    .gradio-container .stat-value {
       font-size: 1.9rem;
       font-weight: 800;
       color: #fff4e1;
       line-height: 1;
       margin-bottom: 6px;
     }
-    .stat-help {
+    .gradio-container .stat-help {
       font-size: 0.92rem;
       color: #d8cfbf;
       line-height: 1.45;
     }
-    .story-title, .source-title, .glossary-title {
+    .gradio-container .story-title, .gradio-container .source-title, .gradio-container .glossary-title {
       font-size: 1rem;
       font-weight: 800;
       color: #fff4e1;
       margin-bottom: 6px;
     }
-    .story-body, .source-body, .glossary-body {
+    .gradio-container .story-body, .gradio-container .source-body, .gradio-container .glossary-body {
       font-size: 0.95rem;
       line-height: 1.55;
       color: #ddd5c8;
     }
-    .source-table {
+    .gradio-container .source-table {
       width: 100%;
       border-collapse: collapse;
       margin-top: 8px;
       font-size: 0.95rem;
+      background: transparent !important;
     }
-    .source-table th, .source-table td {
+    .gradio-container .source-table th, .gradio-container .source-table td {
       border-top: 1px solid rgba(212, 162, 74, 0.16);
       padding: 12px 10px;
       text-align: left;
       vertical-align: top;
+      background: transparent !important;
     }
-    .source-table th {
+    .gradio-container .source-table th {
       color: #d4a24a;
       font-size: 0.82rem;
       text-transform: uppercase;
       letter-spacing: 0.06em;
       width: 32%;
     }
-    .source-table td {
+    .gradio-container .source-table td {
       color: #ddd5c8;
     }
-    .glossary-list {
+    .gradio-container .glossary-list {
       display: grid;
       gap: 10px;
       margin-top: 8px;
     }
-    .glossary-item strong {
+    .gradio-container .glossary-item strong {
       display: block;
       color: #fff4e1;
       margin-bottom: 2px;
     }
-    .section-kicker {
+    .gradio-container .section-kicker {
       color: #d4a24a;
       font-size: 0.84rem;
       font-weight: 700;
@@ -384,19 +402,19 @@ def _space_css() -> str:
       text-transform: uppercase;
       margin-bottom: 6px;
     }
-    .result-list {
+    .gradio-container .result-list {
       display: flex;
       flex-direction: column;
       gap: 12px;
       margin-top: 10px;
     }
-    .result-head {
+    .gradio-container .result-head {
       display: flex;
       justify-content: space-between;
       align-items: flex-start;
       gap: 12px;
     }
-    .result-rank {
+    .gradio-container .result-rank {
       font-size: 0.78rem;
       font-weight: 700;
       color: #d4a24a;
@@ -404,24 +422,24 @@ def _space_css() -> str:
       letter-spacing: 0.06em;
       margin-bottom: 4px;
     }
-    .result-title {
+    .gradio-container .result-title {
       font-size: 1.12rem;
       font-weight: 800;
       color: #fff4e1;
       line-height: 1.2;
       margin-bottom: 4px;
     }
-    .result-subtitle {
+    .gradio-container .result-subtitle {
       color: #d5cbbb;
       font-size: 0.93rem;
     }
-    .metric-stack {
+    .gradio-container .metric-stack {
       display: flex;
       gap: 8px;
       flex-wrap: wrap;
       justify-content: flex-end;
     }
-    .score-pill, .strength-pill, .chip {
+    .gradio-container .score-pill, .gradio-container .strength-pill, .gradio-container .chip {
       display: inline-block;
       border-radius: 999px;
       padding: 5px 10px;
@@ -429,26 +447,26 @@ def _space_css() -> str:
       font-weight: 700;
       white-space: nowrap;
     }
-    .score-pill {
+    .gradio-container .score-pill {
       background: #1f5f5b;
-      color: white;
+      color: white !important;
     }
-    .strength-pill {
+    .gradio-container .strength-pill {
       background: rgba(212, 162, 74, 0.18);
       color: #ffd47a;
       border: 1px solid rgba(212, 162, 74, 0.32);
     }
-    .chip-row {
+    .gradio-container .chip-row {
       display: flex;
       flex-wrap: wrap;
       gap: 8px;
       margin: 12px 0 10px 0;
     }
-    .chip {
+    .gradio-container .chip {
       background: rgba(255,255,255,0.08);
       color: #ece3d5;
     }
-    .meta-grid {
+    .gradio-container .meta-grid {
       display: grid;
       grid-template-columns: repeat(auto-fit, minmax(150px, 1fr));
       gap: 10px;
@@ -456,7 +474,7 @@ def _space_css() -> str:
       font-size: 0.9rem;
       color: #d6cec2;
     }
-    .meta-grid strong {
+    .gradio-container .meta-grid strong {
       display: block;
       color: #fff4e1;
       margin-bottom: 2px;
@@ -464,19 +482,28 @@ def _space_css() -> str:
       text-transform: uppercase;
       letter-spacing: 0.04em;
     }
-    .result-hint {
+    .gradio-container .result-hint {
       margin-top: 12px;
       font-size: 0.88rem;
       color: #d4a24a;
     }
-    .panel-note {
+    .gradio-container .panel-note {
       background: #151b22;
-      border: 1px solid rgba(212, 162, 74, 0.22);
+      border: 1px solid rgba(212, 162, 74, 0.22) !important;
       border-radius: 18px;
       padding: 14px 16px;
       color: #ddd5c8;
       margin-bottom: 12px;
     }
+    .gradio-container .hero-panel *,
+    .gradio-container .stat-card *,
+    .gradio-container .story-card *,
+    .gradio-container .source-card *,
+    .gradio-container .glossary-card *,
+    .gradio-container .result-card *,
+    .gradio-container .panel-note * {
+      text-shadow: none !important;
+    }
     .gradio-container .prose,
     .gradio-container .prose p,
     .gradio-container .prose li,
@@ -831,6 +858,44 @@ def _confidence_label(value: str) -> str:
     }.get(normalized, normalized.title() or "Confidence not labeled")
 
 
+def _evidence_chip_help(label: str) -> str:
+    normalized = str(label or "").strip().lower()
+    mapping = {
+        "trade disclosure": "Public periodic transaction reports or trade disclosures support this relationship.",
+        "annual disclosure": "Annual financial disclosure records support this relationship.",
+        "bill record": "Bill-status records help show legislative activity in the same topic area.",
+        "funding award": "Published federal award records support a funding-recipient link in this slice.",
+        "committee roster": "Committee records show committee context related to the same topic area.",
+        "vote activity": "Roll-call vote records add legislative activity in the same topic window.",
+        "lobbying activity": "Lobbying filings add public activity in the same issue area.",
+        "member profile": "Member-published profile or committee context contributes to this relationship summary.",
+        "published source support": "This relationship has published source support in the released slice.",
+    }
+    return mapping.get(normalized, "This chip names one kind of public-record support attached to this relationship.")
+
+
+def _score_help_text(ranking_mode: str) -> str:
+    normalized = str(ranking_mode or "raw").strip().lower()
+    if normalized == "relative":
+        return (
+            "Experimental relative score. It compares this relationship with the same member's other visible "
+            "relationships in the current view so unusually strong links stand out against that member's baseline activity."
+        )
+    return (
+        "Raw score. It favors clearer public support, more supporting rows, more integrity-checked records, "
+        "and fewer unresolved references."
+    )
+
+
+def _stronger_support_count(row: Dict[str, Any]) -> int:
+    family = str(row.get("relationship_family", "") or "")
+    return int(
+        row.get("linked_count", 0) or 0
+        if family == "recipient"
+        else row.get("strong_event_count", 0) or 0
+    )
+
+
 def _edge_evidence_chips(row: Dict[str, Any]) -> list[str]:
     urls = _split_pipe_values(row.get("source_urls", ""), limit=12)
     reason_codes = set(_split_pipe_values(row.get("reason_codes", ""), limit=20))
@@ -871,14 +936,28 @@ def _window_overlap_text(row: Dict[str, Any]) -> str:
     return "not explicit in this row"
 
 
+def _member_activity_baselines(edges: pd.DataFrame) -> Dict[str, Dict[str, float]]:
+    if edges.empty:
+        return {}
+    baselines: Dict[str, Dict[str, float]] = {}
+    for member_slug, group in edges.groupby("member_slug", dropna=False):
+        slug = str(member_slug or "")
+        records = group.to_dict("records")
+        raw_scores = [_relationship_score(row) for row in records]
+        stronger_counts = [_stronger_support_count(row) for row in records]
+        support_counts = [int(row.get("link_count", 0) or 0) for row in records]
+        count = max(len(records), 1)
+        baselines[slug] = {
+            "mean_raw_score": float(sum(raw_scores) / count),
+            "mean_stronger_support": float(sum(stronger_counts) / count),
+            "mean_support_count": float(sum(support_counts) / count),
+        }
+    return baselines
+
+
 def _relationship_score(row: Dict[str, Any]) -> int:
     status = str(row.get("relationship_status", "") or "")
-    family = str(row.get("relationship_family", "") or "")
-    stronger_support = int(
-        row.get("linked_count", 0) or 0
-        if family == "recipient"
-        else row.get("strong_event_count", 0) or 0
-    )
+    stronger_support = _stronger_support_count(row)
     status_base = {
         "linked": 78,
         "release_ok": 74,
@@ -894,13 +973,34 @@ def _relationship_score(row: Dict[str, Any]) -> int:
     return max(0, min(100, score))
 
 
-def _rank_relationships(edges: pd.DataFrame) -> pd.DataFrame:
+def _relative_relationship_score(row: Dict[str, Any], baselines: Dict[str, Dict[str, float]]) -> int:
+    member_slug = str(row.get("member_slug") or "")
+    baseline = baselines.get(member_slug) or {}
+    raw_score = _relationship_score(row)
+    mean_raw_score = float(baseline.get("mean_raw_score", raw_score) or raw_score)
+    mean_stronger_support = float(
+        baseline.get("mean_stronger_support", _stronger_support_count(row)) or _stronger_support_count(row)
+    )
+    mean_support_count = float(
+        baseline.get("mean_support_count", int(row.get("link_count", 0) or 0)) or int(row.get("link_count", 0) or 0)
+    )
+    relative = 50.0
+    relative += (raw_score - mean_raw_score) * 1.2
+    relative += (_stronger_support_count(row) - mean_stronger_support) * 5.0
+    relative += (int(row.get("link_count", 0) or 0) - mean_support_count) * 2.0
+    relative -= min(int(row.get("unresolved_source_ref_count", 0) or 0), 10) * 1.2
+    return max(0, min(100, int(round(relative))))
+
+
+def _rank_relationships(edges: pd.DataFrame, ranking_mode: str = "raw") -> pd.DataFrame:
     columns = [
         "rank",
         "relationship_id",
         "member",
         "counterparty / sector",
         "overall score",
+        "raw score",
+        "relative score",
         "strength",
         "evidence",
         "time-window overlap",
@@ -912,26 +1012,30 @@ def _rank_relationships(edges: pd.DataFrame) -> pd.DataFrame:
     ]
     if edges.empty:
         return pd.DataFrame(columns=columns)
+    baselines = _member_activity_baselines(edges)
+    normalized_mode = str(ranking_mode or "raw").strip().lower()
     rows: list[dict[str, Any]] = []
     for row in edges.to_dict("records"):
         family = str(row.get("relationship_family", "") or "")
-        stronger_support = int(
-            row.get("linked_count", 0) or 0
-            if family == "recipient"
-            else row.get("strong_event_count", 0) or 0
-        )
+        stronger_support = _stronger_support_count(row)
         caution_support = int(
             row.get("review_count", 0) or 0
             if family == "recipient"
             else row.get("weak_event_count", 0) or 0
         )
         chips = _edge_evidence_chips(row)
+        raw_score = _relationship_score(row)
+        relative_score = _relative_relationship_score(row, baselines)
+        display_score = relative_score if normalized_mode == "relative" else raw_score
         rows.append(
             {
                 "relationship_id": str(row.get("edge_id") or ""),
                 "member": str(row.get("member_name") or row.get("member_slug") or ""),
                 "counterparty / sector": str(row.get("target_label") or ""),
-                "overall score": _relationship_score(row),
+                "overall score": display_score,
+                "raw score": raw_score,
+                "relative score": relative_score,
+                "status_code": str(row.get("relationship_status", "") or ""),
                 "strength": _plain_status_label(str(row.get("relationship_status", "") or "")),
                 "evidence": " | ".join(chips) if chips else "published source support",
                 "time-window overlap": _window_overlap_text(row),
@@ -957,6 +1061,7 @@ def _overview_summary_markdown(
     family: str,
     only_strong_links: bool,
     top_n: int,
+    ranking_mode: str,
 ) -> str:
     if ranked.empty:
         return "\n".join(
@@ -975,6 +1080,7 @@ def _overview_summary_markdown(
         "",
         f"- Showing the top `{min(int(top_n), len(ranked))}` `{_plain_family_label(family).lower()}` for `{focus_label}`.",
         f"- Filtered to stronger links only: `{str(bool(only_strong_links)).lower()}`.",
+        f"- Ranking mode: `{'experimental relative to this member baseline' if str(ranking_mode or 'raw').strip().lower() == 'relative' else 'raw score'}`.",
         f"- Highest score in this view: `{int(ranked['overall score'].max())}`.",
         "- Pick one relationship below to see the evidence breakdown and coarse evidence window.",
     ]
@@ -990,6 +1096,7 @@ def _overview_cards_html(
     family: str,
     only_strong_links: bool,
     top_n: int,
+    ranking_mode: str,
 ) -> str:
     if ranked.empty:
         return (
@@ -1005,17 +1112,24 @@ def _overview_cards_html(
         f"<strong>Showing the top {min(int(top_n), len(ranked))} {_plain_family_label(family).lower()}</strong> "
         f"for <strong>{html.escape(focus_label)}</strong>. "
         f"Filtered to stronger links only: <strong>{'yes' if bool(only_strong_links) else 'no'}</strong>. "
-        "Pick one relationship below to open the plain-English explanation and evidence window."
+        f"Ranking mode: <strong>{'experimental relative to this member baseline' if str(ranking_mode or 'raw').strip().lower() == 'relative' else 'raw score'}</strong>. "
+        "Hover over score badges and evidence chips for why they matter. Pick one relationship below to open the plain-English explanation and evidence window."
         "</div>"
     )
     cards: list[str] = []
     for row in ranked.head(int(top_n)).to_dict("records"):
         evidence_chips = [item.strip() for item in str(row.get("evidence", "") or "").split("|") if item.strip()]
-        chip_html = "".join(f"<span class=\"chip\">{html.escape(chip)}</span>" for chip in evidence_chips[:6])
+        chip_html = "".join(
+            f"<span class=\"chip\" title=\"{html.escape(_evidence_chip_help(chip))}\">{html.escape(chip)}</span>"
+            for chip in evidence_chips[:6]
+        )
         supporting_rows = int(row.get("supporting rows", 0) or 0)
         stronger_support = int(row.get("stronger support", 0) or 0)
         needs_caution = int(row.get("needs caution", 0) or 0)
         unresolved_refs = int(row.get("unresolved refs", 0) or 0)
+        raw_score = int(row.get("raw score", 0) or 0)
+        relative_score = int(row.get("relative score", 0) or 0)
+        score_note = _score_help_text(ranking_mode)
         cards.append(
             f"""
             <div class="result-card">
@@ -1026,8 +1140,8 @@ def _overview_cards_html(
                   <div class="result-subtitle">For {html.escape(str(row.get("member", "") or ""))} in the {_plain_family_label(family).lower()} view.</div>
                 </div>
                 <div class="metric-stack">
-                  <span class="score-pill">Score {int(row.get("overall score", 0) or 0)}</span>
-                  <span class="strength-pill">{html.escape(str(row.get("strength", "") or ""))}</span>
+                  <span class="score-pill" title="{html.escape(score_note)}">Score {int(row.get("overall score", 0) or 0)}</span>
+                  <span class="strength-pill" title="{html.escape(_plain_status_explainer(str(row.get('status_code', '') or '')))}">{html.escape(str(row.get("strength", "") or ""))}</span>
                 </div>
               </div>
               <div class="chip-row">{chip_html or '<span class="chip">published source support</span>'}</div>
@@ -1037,8 +1151,10 @@ def _overview_cards_html(
                 <div><strong>Stronger support</strong>{stronger_support}</div>
                 <div><strong>Needs caution</strong>{needs_caution}</div>
                 <div><strong>Unresolved refs</strong>{unresolved_refs}</div>
+                <div><strong>Raw score</strong>{raw_score}</div>
+                <div><strong>Relative score</strong>{relative_score}</div>
               </div>
-              <div class="result-hint">Use “Explain this link” below to open the detailed breakdown for this relationship.</div>
+              <div class="result-hint">Use Explain this link below to open the detailed breakdown and export files for this relationship.</div>
             </div>
             """
         )
@@ -1055,10 +1171,7 @@ def _relationship_options(ranked: pd.DataFrame) -> list[tuple[str, str]]:
         return []
     options: list[tuple[str, str]] = []
     for row in ranked.to_dict("records"):
-        label = (
-            f"#{int(row['rank'])} {row['counterparty / sector']} "
-            f"— {row['strength']} (score {row['overall score']})"
-        )
+        label = f"#{int(row['rank'])} {row['counterparty / sector']} - {row['strength']} (score {row['overall score']})"
         options.append((label, str(row["relationship_id"])))
     return options
 
@@ -1072,7 +1185,7 @@ def _select_edge_row(edges: pd.DataFrame, relationship_id: str) -> Dict[str, Any
     return matched.head(1).to_dict("records")[0]
 
 
-def _relationship_detail_markdown(edges: pd.DataFrame, relationship_id: str) -> str:
+def _relationship_detail_markdown(edges: pd.DataFrame, relationship_id: str, ranking_mode: str = "raw") -> str:
     row = _select_edge_row(edges, relationship_id)
     if not row:
         return "Select a relationship to inspect why it appears in this released slice."
@@ -1080,12 +1193,17 @@ def _relationship_detail_markdown(edges: pd.DataFrame, relationship_id: str) ->
     chips = _edge_evidence_chips(row)
     reason_codes = [_plain_reason_code(item) for item in _split_pipe_values(row.get("reason_codes", ""), limit=8)]
     urls = _split_pipe_values(row.get("source_urls", ""), limit=5)
+    raw_score = _relationship_score(row)
+    relative_score = _relative_relationship_score(row, _member_activity_baselines(edges))
+    display_score = relative_score if str(ranking_mode or "raw").strip().lower() == "relative" else raw_score
     lines = [
         f"### {row.get('member_name') or row.get('member_slug')} -> {row.get('target_label')}",
         "",
         f"- Relationship view: `{_plain_family_label(family)}`",
         f"- Strength label: `{_plain_status_label(str(row.get('relationship_status', '') or ''))}`",
-        f"- Overall score: `{_relationship_score(row)}`",
+        f"- Displayed score in this view: `{display_score}`",
+        f"- Raw score: `{raw_score}`",
+        f"- Relative-to-baseline score (experimental): `{relative_score}`",
         f"- Supporting relationship rows: `{int(row.get('link_count', 0) or 0)}`",
         f"- Stronger-support rows: `{int(row.get('linked_count', 0) or 0) if family == 'recipient' else int(row.get('strong_event_count', 0) or 0)}`",
         f"- Caution / weaker rows: `{int(row.get('review_count', 0) or 0) if family == 'recipient' else int(row.get('weak_event_count', 0) or 0)}`",
@@ -1108,9 +1226,189 @@ def _relationship_detail_markdown(edges: pd.DataFrame, relationship_id: str) ->
             "- `Integrity-checked` means the release includes a cryptographic fingerprint to help show a published record has not been altered.",
         ]
     )
+    if str(ranking_mode or "raw").strip().lower() == "relative":
+        lines.extend(
+            [
+                "",
+                "#### Ranking note",
+                "",
+                "- This view is using the experimental relative score, which compares this relationship to the same member's other visible links in the current filtered view.",
+            ]
+        )
     return "\n".join(lines)
 
 
+def _safe_export_stem(value: str) -> str:
+    slug = re.sub(r"[^a-z0-9]+", "-", str(value or "").strip().lower()).strip("-")
+    return slug or "relationship-export"
+
+
+def _relationship_export_rows(edges: pd.DataFrame, relationship_id: str, ranking_mode: str) -> list[dict[str, Any]]:
+    row = _select_edge_row(edges, relationship_id)
+    if not row:
+        return []
+    raw_score = _relationship_score(row)
+    relative_score = _relative_relationship_score(row, _member_activity_baselines(edges))
+    display_score = relative_score if str(ranking_mode or "raw").strip().lower() == "relative" else raw_score
+    reason_codes = [_plain_reason_code(item) for item in _split_pipe_values(row.get("reason_codes", ""), limit=8)]
+    urls = _split_pipe_values(row.get("source_urls", ""), limit=8)
+    export_rows: list[dict[str, Any]] = [
+        {
+            "relationship_id": str(row.get("edge_id") or ""),
+            "member_name": str(row.get("member_name") or row.get("member_slug") or ""),
+            "target_label": str(row.get("target_label") or ""),
+            "relationship_family": _plain_family_label(str(row.get("relationship_family", "") or "")),
+            "strength_label": _plain_status_label(str(row.get("relationship_status", "") or "")),
+            "ranking_mode": str(ranking_mode or "raw"),
+            "displayed_score": display_score,
+            "raw_score": raw_score,
+            "relative_score": relative_score,
+            "item_type": "summary",
+            "item_label": "relationship summary",
+            "item_detail": "Top-level relationship summary for export.",
+        }
+    ]
+    for chip in _edge_evidence_chips(row):
+        export_rows.append(
+            {
+                "relationship_id": str(row.get("edge_id") or ""),
+                "member_name": str(row.get("member_name") or row.get("member_slug") or ""),
+                "target_label": str(row.get("target_label") or ""),
+                "relationship_family": _plain_family_label(str(row.get("relationship_family", "") or "")),
+                "strength_label": _plain_status_label(str(row.get("relationship_status", "") or "")),
+                "ranking_mode": str(ranking_mode or "raw"),
+                "displayed_score": display_score,
+                "raw_score": raw_score,
+                "relative_score": relative_score,
+                "item_type": "evidence_chip",
+                "item_label": chip,
+                "item_detail": _evidence_chip_help(chip),
+            }
+        )
+    for reason in sorted(reason_codes):
+        export_rows.append(
+            {
+                "relationship_id": str(row.get("edge_id") or ""),
+                "member_name": str(row.get("member_name") or row.get("member_slug") or ""),
+                "target_label": str(row.get("target_label") or ""),
+                "relationship_family": _plain_family_label(str(row.get("relationship_family", "") or "")),
+                "strength_label": _plain_status_label(str(row.get("relationship_status", "") or "")),
+                "ranking_mode": str(ranking_mode or "raw"),
+                "displayed_score": display_score,
+                "raw_score": raw_score,
+                "relative_score": relative_score,
+                "item_type": "reason",
+                "item_label": reason,
+                "item_detail": reason,
+            }
+        )
+    for item in sorted(_plain_strengthener(value) for value in _split_pipe_values(row.get("missing_to_strengthen", ""), limit=12)):
+        export_rows.append(
+            {
+                "relationship_id": str(row.get("edge_id") or ""),
+                "member_name": str(row.get("member_name") or row.get("member_slug") or ""),
+                "target_label": str(row.get("target_label") or ""),
+                "relationship_family": _plain_family_label(str(row.get("relationship_family", "") or "")),
+                "strength_label": _plain_status_label(str(row.get("relationship_status", "") or "")),
+                "ranking_mode": str(ranking_mode or "raw"),
+                "displayed_score": display_score,
+                "raw_score": raw_score,
+                "relative_score": relative_score,
+                "item_type": "what_would_strengthen",
+                "item_label": "What would strengthen it",
+                "item_detail": item,
+            }
+        )
+    for url in sorted(urls):
+        export_rows.append(
+            {
+                "relationship_id": str(row.get("edge_id") or ""),
+                "member_name": str(row.get("member_name") or row.get("member_slug") or ""),
+                "target_label": str(row.get("target_label") or ""),
+                "relationship_family": _plain_family_label(str(row.get("relationship_family", "") or "")),
+                "strength_label": _plain_status_label(str(row.get("relationship_status", "") or "")),
+                "ranking_mode": str(ranking_mode or "raw"),
+                "displayed_score": display_score,
+                "raw_score": raw_score,
+                "relative_score": relative_score,
+                "item_type": "source_url",
+                "item_label": "Published source URL",
+                "item_detail": url,
+            }
+        )
+    return export_rows
+
+
+def _write_relationship_export_bundle(edges: pd.DataFrame, relationship_id: str, ranking_mode: str) -> tuple[str, str | None, str | None]:
+    export_rows = _relationship_export_rows(edges, relationship_id, ranking_mode)
+    if not export_rows:
+        return "Pick one relationship to generate exportable evidence files.", None, None
+    relationship_id_value = str(export_rows[0]["relationship_id"] or relationship_id)
+    export_dir = Path(tempfile.gettempdir()) / "cmp_space_exports"
+    export_dir.mkdir(parents=True, exist_ok=True)
+    stem = _safe_export_stem(f"{relationship_id_value}-{ranking_mode}")
+    csv_path = export_dir / f"{stem}.csv"
+    pdf_path = export_dir / f"{stem}.pdf"
+
+    fieldnames = [
+        "relationship_id",
+        "member_name",
+        "target_label",
+        "relationship_family",
+        "strength_label",
+        "ranking_mode",
+        "displayed_score",
+        "raw_score",
+        "relative_score",
+        "item_type",
+        "item_label",
+        "item_detail",
+    ]
+    with csv_path.open("w", encoding="utf-8", newline="") as handle:
+        writer = csv.DictWriter(handle, fieldnames=fieldnames)
+        writer.writeheader()
+        for export_row in export_rows:
+            writer.writerow({name: export_row.get(name, "") for name in fieldnames})
+
+    title = f"{export_rows[0]['member_name']} -> {export_rows[0]['target_label']}"
+    pdf = canvas.Canvas(str(pdf_path), pagesize=LETTER, invariant=1)
+    width, height = LETTER
+    left = 54
+    top = height - 54
+    pdf.setTitle("Congress public records relationship export")
+    pdf.setAuthor("Congress Public Records Slice")
+    pdf.setSubject("Deterministic relationship evidence export")
+    pdf.setFont("Helvetica-Bold", 14)
+    pdf.drawString(left, top, title[:95])
+    cursor_y = top - 24
+    pdf.setFont("Helvetica", 10)
+    wrapped_lines: list[str] = [
+        f"Strength label: {export_rows[0]['strength_label']}",
+        f"Ranking mode: {export_rows[0]['ranking_mode']}",
+        f"Displayed score: {export_rows[0]['displayed_score']}",
+        f"Raw score: {export_rows[0]['raw_score']}",
+        f"Relative score: {export_rows[0]['relative_score']}",
+        "",
+        "Export rows included below in deterministic order:",
+    ]
+    for export_row in export_rows:
+        wrapped_lines.append(f"[{export_row['item_type']}] {export_row['item_label']}: {export_row['item_detail']}")
+    for line in wrapped_lines:
+        for wrapped in textwrap.wrap(str(line), width=98) or [""]:
+            if cursor_y < 54:
+                pdf.showPage()
+                cursor_y = height - 54
+                pdf.setFont("Helvetica", 10)
+            pdf.drawString(left, cursor_y, wrapped)
+            cursor_y -= 14
+    pdf.save()
+    note = (
+        f"Prepared deterministic export files for `{relationship_id_value}`. "
+        "The CSV keeps one row per exported evidence item, and the PDF mirrors the same content in a fixed order."
+    )
+    return note, str(csv_path), str(pdf_path)
+
+
 def _timeline_window_from_url(url: str) -> tuple[int, str, str]:
     normalized = str(url or "").strip()
     if not normalized:
@@ -1517,12 +1815,20 @@ def build_app(copy_path: str | Path):
             overview_member_limit,
         )
 
-    def _update_overview(member_query: str, family: str, only_strong: bool, top_n: int, relationship_id: str | None = None):
+    def _update_overview(
+        member_query: str,
+        family: str,
+        only_strong: bool,
+        top_n: int,
+        ranking_mode: str,
+        relationship_id: str | None = None,
+    ):
         filtered_edges = _overview_edges(member_query, family, only_strong, int(top_n))
-        ranked = _rank_relationships(filtered_edges)
+        ranked = _rank_relationships(filtered_edges, ranking_mode=ranking_mode)
         options = _relationship_options(ranked)
         valid_ids = {value for _, value in options}
         selected = relationship_id if relationship_id in valid_ids else (options[0][1] if options else None)
+        export_note, export_csv, export_pdf = _write_relationship_export_bundle(filtered_edges, selected or "", ranking_mode)
         return (
             _overview_summary_markdown(
                 ranked,
@@ -1530,6 +1836,7 @@ def build_app(copy_path: str | Path):
                 family=family,
                 only_strong_links=only_strong,
                 top_n=int(top_n),
+                ranking_mode=ranking_mode,
             ),
             _overview_cards_html(
                 ranked,
@@ -1537,15 +1844,33 @@ def build_app(copy_path: str | Path):
                 family=family,
                 only_strong_links=only_strong,
                 top_n=int(top_n),
+                ranking_mode=ranking_mode,
             ),
             gr.update(choices=options, value=selected),
-            _relationship_detail_markdown(filtered_edges, selected or ""),
+            _relationship_detail_markdown(filtered_edges, selected or "", ranking_mode),
             _relationship_timeline_html(filtered_edges, selected or ""),
+            export_note,
+            export_csv,
+            export_pdf,
         )
 
-    def _update_overview_detail(member_query: str, family: str, only_strong: bool, top_n: int, relationship_id: str):
+    def _update_overview_detail(
+        member_query: str,
+        family: str,
+        only_strong: bool,
+        top_n: int,
+        ranking_mode: str,
+        relationship_id: str,
+    ):
         filtered_edges = _overview_edges(member_query, family, only_strong, int(top_n))
-        return _relationship_detail_markdown(filtered_edges, relationship_id), _relationship_timeline_html(filtered_edges, relationship_id)
+        export_note, export_csv, export_pdf = _write_relationship_export_bundle(filtered_edges, relationship_id, ranking_mode)
+        return (
+            _relationship_detail_markdown(filtered_edges, relationship_id, ranking_mode),
+            _relationship_timeline_html(filtered_edges, relationship_id),
+            export_note,
+            export_csv,
+            export_pdf,
+        )
 
     def _update_graph(member_query: str, family: str, only_strong: bool, top_n: int):
         review_status = "stronger" if only_strong else "all"
@@ -1660,6 +1985,14 @@ def build_app(copy_path: str | Path):
                 choices=[("Sectors", "sector"), ("Funding recipients", "recipient")],
                 value="sector",
             )
+            overview_ranking_mode = gr.Radio(
+                label="Rank by",
+                choices=[
+                    ("Raw score", "raw"),
+                    ("Experimental: relative to this member baseline", "relative"),
+                ],
+                value="raw",
+            )
             overview_only_strong = gr.Checkbox(label="Only stronger links", value=True)
             overview_top_n = gr.Dropdown(label="Show top results", choices=[5, 10, 15, 20], value=10)
         if example_member_choices:
@@ -1672,27 +2005,31 @@ def build_app(copy_path: str | Path):
         with gr.Row():
             overview_detail_md = gr.Markdown()
             overview_timeline_html = gr.HTML()
+        export_note_md = gr.Markdown()
+        with gr.Row():
+            export_csv_file = gr.File(label="Evidence breakdown CSV", interactive=False)
+            export_pdf_file = gr.File(label="Evidence breakdown PDF", interactive=False)
 
         search_button.click(
             _update_overview,
-            [overview_member, overview_family, overview_only_strong, overview_top_n, relationship_choice],
-            [overview_summary_md, overview_cards, relationship_choice, overview_detail_md, overview_timeline_html],
+            [overview_member, overview_family, overview_only_strong, overview_top_n, overview_ranking_mode, relationship_choice],
+            [overview_summary_md, overview_cards, relationship_choice, overview_detail_md, overview_timeline_html, export_note_md, export_csv_file, export_pdf_file],
         )
         overview_member.submit(
             _update_overview,
-            [overview_member, overview_family, overview_only_strong, overview_top_n, relationship_choice],
-            [overview_summary_md, overview_cards, relationship_choice, overview_detail_md, overview_timeline_html],
+            [overview_member, overview_family, overview_only_strong, overview_top_n, overview_ranking_mode, relationship_choice],
+            [overview_summary_md, overview_cards, relationship_choice, overview_detail_md, overview_timeline_html, export_note_md, export_csv_file, export_pdf_file],
         )
-        for control in (overview_family, overview_only_strong, overview_top_n):
+        for control in (overview_family, overview_ranking_mode, overview_only_strong, overview_top_n):
             control.change(
                 _update_overview,
-                [overview_member, overview_family, overview_only_strong, overview_top_n, relationship_choice],
-                [overview_summary_md, overview_cards, relationship_choice, overview_detail_md, overview_timeline_html],
+                [overview_member, overview_family, overview_only_strong, overview_top_n, overview_ranking_mode, relationship_choice],
+                [overview_summary_md, overview_cards, relationship_choice, overview_detail_md, overview_timeline_html, export_note_md, export_csv_file, export_pdf_file],
             )
         relationship_choice.change(
             _update_overview_detail,
-            [overview_member, overview_family, overview_only_strong, overview_top_n, relationship_choice],
-            [overview_detail_md, overview_timeline_html],
+            [overview_member, overview_family, overview_only_strong, overview_top_n, overview_ranking_mode, relationship_choice],
+            [overview_detail_md, overview_timeline_html, export_note_md, export_csv_file, export_pdf_file],
         )
 
         with gr.Accordion("Explore the network map (optional)", open=False):
@@ -1789,8 +2126,8 @@ def build_app(copy_path: str | Path):
 
         app.load(
             _update_overview,
-            [overview_member, overview_family, overview_only_strong, overview_top_n, relationship_choice],
-            [overview_summary_md, overview_cards, relationship_choice, overview_detail_md, overview_timeline_html],
+            [overview_member, overview_family, overview_only_strong, overview_top_n, overview_ranking_mode, relationship_choice],
+            [overview_summary_md, overview_cards, relationship_choice, overview_detail_md, overview_timeline_html, export_note_md, export_csv_file, export_pdf_file],
         )
         app.load(
             _update_graph,