Humanize event detail explanations and make source links clickable

public_space_app.py

@@ -803,6 +803,29 @@ def _plain_reason_code(value: str) -> str:
     return mapping.get(normalized, normalized.replace("_", " ").title() or "Signal")
 
 
+def _plain_strengthener(value: str) -> str:
+    normalized = str(value or "").strip()
+    mapping = {
+        "bill_sector_mapping_weak": "Requires stronger correlation between the trade window and related bill subject matter.",
+        "donor_industry_mapping_weak": "Missing granular donor industry classification.",
+        "committee_history_missing": "Committee history is missing or incomplete for this row.",
+        "lobbying_issue_mapping_weak": "Requires clearer mapping between lobbying issue tags and the policy area in this row.",
+        "recipient_identity_ambiguous": "The recipient identity needs a cleaner match before this can be treated as a stronger link.",
+        "insufficient_official_support": "Needs more direct official-record support before this can be treated as a stronger link.",
+        "vote_history_missing": "Vote history is missing or incomplete for this row.",
+    }
+    return mapping.get(normalized, normalized.replace("_", " ").capitalize() or "Additional support is needed.")
+
+
+def _confidence_label(value: str) -> str:
+    normalized = str(value or "").strip().lower()
+    return {
+        "high": "🟢 High confidence",
+        "medium": "🟡 Medium confidence",
+        "low": "🟠 Lower confidence",
+    }.get(normalized, normalized.title() or "Confidence not labeled")
+
+
 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))
@@ -1071,7 +1094,7 @@ def _relationship_detail_markdown(edges: pd.DataFrame, relationship_id: str) ->
         lines.extend(f"- {item}" for item in reason_codes)
     if urls:
         lines.extend(["", "#### Example published source URLs", ""])
-        lines.extend(f"- {item}" for item in urls)
+        lines.extend(f"- [{item}]({item})" for item in urls)
     lines.extend(
         [
             "",
@@ -1415,7 +1438,7 @@ def _event_detail(events: pd.DataFrame, provenance: pd.DataFrame, event_id: str)
         lines.append(f"- Score label: `{score_label}`")
     confidence_bucket = str(event_row.get("confidence_bucket") or "").strip()
     if confidence_bucket:
-        lines.append(f"- Confidence bucket: `{confidence_bucket}`")
+        lines.append(f"- Confidence level: {_confidence_label(confidence_bucket)}")
     if issuer_raw:
         lines.append(f"- Issuer or subject: `{issuer_raw}`")
     if sector:
@@ -1433,10 +1456,10 @@ def _event_detail(events: pd.DataFrame, provenance: pd.DataFrame, event_id: str)
         lines.extend(f"- `{item}`" for item in reason_codes[:8])
     if missing_to_strengthen:
         lines.extend(["", "#### What would strengthen it", ""])
-        lines.extend(f"- `{item}`" for item in missing_to_strengthen[:8])
+        lines.extend(f"- {_plain_strengthener(item)}" for item in missing_to_strengthen[:8])
     if source_urls:
         lines.extend(["", "#### Example source URLs", ""])
-        lines.extend(f"- {item}" for item in source_urls)
+        lines.extend(f"- [{item}]({item})" for item in source_urls)
     if sha_values:
         lines.extend(["", "#### Example SHA-256 values", ""])
         lines.extend(f"- `{item}`" for item in sha_values)
@@ -1734,9 +1757,13 @@ def build_app(copy_path: str | Path):
                     table_html = _table_html(
                         prov_rows,
                         empty_message="No provenance rows are attached to this released event row.",
-                        note="Scroll sideways to inspect all provenance columns and URLs.",
+                        note="Technical data table. Scroll sideways to inspect all provenance columns and URLs.",
+                    )
+                    return detail_md, (
+                        '<div class="panel-note"><strong>Technical data table</strong><br>'
+                        'This section is for power users who want the raw released provenance rows behind the summary above.</div>'
+                        + table_html
                     )
-                    return detail_md, table_html
 
                 event_id.change(_event_detail_view, [gr.State(events), gr.State(provenance), event_id], [event_detail_md, event_detail_df])
                 app.load(_event_detail_view, [gr.State(events), gr.State(provenance), event_id], [event_detail_md, event_detail_df])