Polish example URLs, relative wording, and export names

dataset_bundle/evidence_audit/consistency_report.json

@@ -1,5 +1,5 @@
 {
-  "generated_at": "2026-04-19T20:18:33-04:00",
+  "generated_at": "2026-04-19T21:24:27-04:00",
   "event_provenance": {
     "event_count": 3918,
     "events_with_artifacts": 3878,

dataset_bundle/public_release_manifest.json

@@ -1,7 +1,7 @@
 {
   "public_version": "congress-public-records-slice-2026-04-v1",
   "title": "Congress Public Records Slice",
-  "release_date": "2026-04-19T20:19:47-04:00",
+  "release_date": "2026-04-19T21:25:32-04:00",
   "slice_description": "A neutral, review-oriented slice of House public-record linkages across financial disclosures, sector overlap, and community project funding recipient relationships.",
   "source_run_name": "house_all_baseline_20260418_v21_recipienthardening",
   "dataset_repo_id": "cjc0013/cmp-data",

public_space_app.py

@@ -1069,6 +1069,15 @@ def _relative_bucket(value: int) -> str:
     return "near this member's baseline"
 
 
+def _relative_view_explainer(value: int) -> str:
+    score = int(value or 0)
+    if score >= 70:
+        return "In this filtered view, this relationship looks stronger than this member's other visible links."
+    if score <= 30:
+        return "In this filtered view, this relationship looks weaker than this member's other visible links."
+    return "In this filtered view, this relationship looks similar to this member's other visible links."
+
+
 def _relationship_strengtheners(link_rows: pd.DataFrame, event_rows: pd.DataFrame) -> list[str]:
     labels = [
         _plain_strengthener(item)
@@ -1184,6 +1193,7 @@ def _select_example_urls(
     records = _relationship_source_records(link_rows, event_rows, str(row.get("target_label") or ""))
     selected: list[str] = []
     selected_set: set[str] = set()
+    normalized_target = _relationship_target_key(str(row.get("target_label") or ""))
 
     def choose_one(family_name: str) -> None:
         candidates = [
@@ -1207,10 +1217,39 @@ def _select_example_urls(
     if any(str(record.get("family") or "") == "lobbying activity" for record in records):
         choose_one("lobbying activity")
 
+    bill_like_records = [
+        record
+        for record in records
+        if str(record.get("family") or "") in {"bill record", "vote activity"} and str(record.get("url") or "") not in selected_set
+    ]
+    preferred_hints = TOPIC_AREA_PREFERRED_BILL_HINTS.get(normalized_target, ())
+    preferred_bill_like_records = [
+        record
+        for record in bill_like_records
+        if any(hint in str(record.get("url") or "").lower() for hint in preferred_hints)
+    ]
+    if preferred_bill_like_records:
+        chosen = sorted(
+            preferred_bill_like_records,
+            key=lambda item: _source_record_priority(item, str(row.get("target_label") or "")),
+        )[0]
+        url = str(chosen.get("url") or "")
+        selected.append(url)
+        selected_set.add(url)
+    elif bill_like_records:
+        chosen = sorted(
+            bill_like_records,
+            key=lambda item: _source_record_priority(item, str(row.get("target_label") or "")),
+        )[0]
+        url = str(chosen.get("url") or "")
+        selected.append(url)
+        selected_set.add(url)
+
     fallback_records = [
         record
         for record in records
         if str(record.get("url") or "") not in selected_set
+        and str(record.get("family") or "") not in {"bill record", "vote activity"}
     ]
     family_order = {
         "bill record": 0,
@@ -1501,8 +1540,8 @@ def _overview_cards_html(
         relative_view = str(row.get("relative view", "") or "")
         score_note = _score_help_text(ranking_mode)
         ranking_mode_note = (
-            f"<div class=\"result-note\"><strong>Experimental relative ordering:</strong> this relationship currently ranks "
-            f"<strong>{html.escape(relative_view)}</strong> ({relative_score}) compared with the same member's other visible links.</div>"
+            f"<div class=\"result-note\"><strong>Experimental relative ordering:</strong> "
+            f"{html.escape(_relative_view_explainer(relative_score))}</div>"
             if str(ranking_mode or "raw").strip().lower() == "relative"
             else ""
         )
@@ -1529,7 +1568,7 @@ def _overview_cards_html(
                 <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 view</strong>{html.escape(relative_view)} ({relative_score})</div>
+                <div><strong>Experimental relative note</strong>{html.escape(_relative_view_explainer(relative_score))}</div>
               </div>
               <div class="result-hint">Use Explain this link below to open the detailed breakdown and export files for this relationship.</div>
             </div>
@@ -1588,7 +1627,7 @@ def _relationship_detail_markdown(
         f"- Public score shown on the card: `{raw_score}`",
         f"- Raw score: `{raw_score}`",
         f"- Relative-to-baseline score (experimental): `{relative_score}`",
-        f"- Relative view in the current filter set: `{context['relative_bucket']}`",
+        f"- Experimental relative note: {_relative_view_explainer(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)}`",
@@ -1635,6 +1674,13 @@ def _safe_export_stem(value: str) -> str:
     return slug or "relationship-export"
 
 
+def _export_bundle_stem(relationship_id_value: str, ranking_mode: str) -> str:
+    base = _safe_export_stem(relationship_id_value)
+    if str(ranking_mode or "raw").strip().lower() == "relative":
+        return f"{base}-experimental-view"
+    return base
+
+
 def _relationship_export_rows(
     edges: pd.DataFrame,
     links: pd.DataFrame,
@@ -1832,10 +1878,10 @@ def _write_relationship_export_bundle(
     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}-raw.csv"
+    stem = _export_bundle_stem(relationship_id_value, ranking_mode)
+    csv_path = export_dir / f"{stem}-machine.csv"
     handoff_csv_path = export_dir / f"{stem}-handoff.csv"
-    pdf_path = export_dir / f"{stem}.pdf"
+    pdf_path = export_dir / f"{stem}-summary.pdf"
 
     fieldnames = [
         "relationship_id",
@@ -1900,7 +1946,7 @@ def _write_relationship_export_bundle(
     pdf.save()
     note = (
         f"Prepared deterministic export files for `{relationship_id_value}`. "
-        "Use the raw CSV for machine-style row exports, the handoff CSV for a cleaner reporter view, and the PDF for a fixed printable summary."
+        "Use the machine CSV for row-complete exports, the handoff CSV for a cleaner reporter view, and the summary PDF for a fixed printable brief."
     )
     return note, str(csv_path), str(handoff_csv_path), str(pdf_path)