Redesign Space UX for guided story-first public flow

.gitattributes

@@ -36,3 +36,4 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
 dataset_bundle/evidence_audit/claim_supporting_provenance.jsonl filter=lfs diff=lfs merge=lfs -text
 dataset_bundle/evidence_audit/scored_event_provenance.jsonl filter=lfs diff=lfs merge=lfs -text
 dataset_bundle/evidence_audit/source_artifact_index.csv filter=lfs diff=lfs merge=lfs -text
+__pycache__/public_space_app.cpython-311.pyc filter=lfs diff=lfs merge=lfs -text

dataset_bundle/evidence_audit/consistency_report.json

@@ -1,5 +1,5 @@
 {
-  "generated_at": "2026-04-19T11:09:07-04:00",
+  "generated_at": "2026-04-19T09:21:59-04:00",
   "event_provenance": {
     "event_count": 3918,
     "events_with_artifacts": 3878,

dataset_bundle/network_graph/graph_config.json

@@ -20,10 +20,9 @@
   "default_filters": {
     "relationship_family": "sector",
     "review_status": "stronger",
-    "max_edges": 30,
+    "max_edges": 60,
     "hide_unresolved_only": true,
-    "overview_member_limit": 5,
-    "default_member_search": "Josh Gottheimer"
+    "overview_member_limit": 8
   },
   "example_member_searches": [
     "Josh Gottheimer",

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-19T11:10:25-04:00",
+  "release_date": "2026-04-19T09:22:53-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_copy.json

@@ -1,5 +1,5 @@
 {
-  "public_version": "congress-public-records-slice-2026-04-v1",
+  "public_version": "congress-public-records-slice-2026-04-v1-private-spacefix",
   "title": "Congress Public Records Slice",
   "subtitle": "Neutral Records explorer for a public-record slice of congressional money-and-power linkages.",
   "dataset_repo_id": "cjc0013/cmp-data",

public_space_app.py

@@ -239,6 +239,339 @@ def _fictional_example_markdown() -> str:
     )
 
 
+def _space_css() -> str:
+    return """
+    .gradio-container {
+      max-width: 1180px !important;
+      margin: 0 auto !important;
+      padding-bottom: 48px !important;
+    }
+    .hero-panel {
+      background: linear-gradient(135deg, #fff8ed 0%, #f5eee2 100%);
+      border: 1px solid #e6d8bf;
+      border-radius: 24px;
+      padding: 28px;
+      margin: 6px 0 20px 0;
+      box-shadow: 0 10px 30px rgba(62, 46, 14, 0.08);
+    }
+    .hero-eyebrow {
+      font-size: 0.82rem;
+      font-weight: 700;
+      letter-spacing: 0.08em;
+      text-transform: uppercase;
+      color: #8a6220;
+      margin-bottom: 8px;
+    }
+    .hero-title {
+      font-size: 2.2rem;
+      line-height: 1.1;
+      font-weight: 800;
+      color: #1f2b2d;
+      margin: 0 0 12px 0;
+    }
+    .hero-lede {
+      font-size: 1.05rem;
+      line-height: 1.6;
+      color: #334244;
+      margin: 0 0 10px 0;
+      max-width: 900px;
+    }
+    .hero-note {
+      font-size: 0.98rem;
+      line-height: 1.5;
+      color: #5f4e2a;
+      background: rgba(255,255,255,0.72);
+      border: 1px solid #eadcbf;
+      border-radius: 14px;
+      padding: 12px 14px;
+      margin-top: 14px;
+    }
+    .stat-grid, .story-grid {
+      display: grid;
+      grid-template-columns: repeat(auto-fit, minmax(180px, 1fr));
+      gap: 14px;
+      margin-top: 18px;
+    }
+    .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 {
+      background: #fffdf8;
+      border: 1px solid #e7dcc8;
+      border-radius: 18px;
+      padding: 16px 18px;
+      box-shadow: 0 6px 18px rgba(40, 31, 9, 0.05);
+    }
+    .stat-label {
+      font-size: 0.82rem;
+      font-weight: 700;
+      text-transform: uppercase;
+      letter-spacing: 0.06em;
+      color: #8b6b2e;
+      margin-bottom: 8px;
+    }
+    .stat-value {
+      font-size: 1.9rem;
+      font-weight: 800;
+      color: #1f2b2d;
+      line-height: 1;
+      margin-bottom: 6px;
+    }
+    .stat-help {
+      font-size: 0.92rem;
+      color: #5b5b5b;
+      line-height: 1.45;
+    }
+    .story-title, .source-title, .glossary-title {
+      font-size: 1rem;
+      font-weight: 800;
+      color: #1f2b2d;
+      margin-bottom: 6px;
+    }
+    .story-body, .source-body, .glossary-body {
+      font-size: 0.95rem;
+      line-height: 1.55;
+      color: #435153;
+    }
+    .source-table {
+      width: 100%;
+      border-collapse: collapse;
+      margin-top: 8px;
+      font-size: 0.95rem;
+    }
+    .source-table th, .source-table td {
+      border-top: 1px solid #eadfcf;
+      padding: 12px 10px;
+      text-align: left;
+      vertical-align: top;
+    }
+    .source-table th {
+      color: #7a5b20;
+      font-size: 0.82rem;
+      text-transform: uppercase;
+      letter-spacing: 0.06em;
+      width: 32%;
+    }
+    .glossary-list {
+      display: grid;
+      gap: 10px;
+      margin-top: 8px;
+    }
+    .glossary-item strong {
+      display: block;
+      color: #1f2b2d;
+      margin-bottom: 2px;
+    }
+    .section-kicker {
+      color: #8a6220;
+      font-size: 0.84rem;
+      font-weight: 700;
+      letter-spacing: 0.06em;
+      text-transform: uppercase;
+      margin-bottom: 6px;
+    }
+    .result-list {
+      display: flex;
+      flex-direction: column;
+      gap: 12px;
+      margin-top: 10px;
+    }
+    .result-head {
+      display: flex;
+      justify-content: space-between;
+      align-items: flex-start;
+      gap: 12px;
+    }
+    .result-rank {
+      font-size: 0.78rem;
+      font-weight: 700;
+      color: #8b6b2e;
+      text-transform: uppercase;
+      letter-spacing: 0.06em;
+      margin-bottom: 4px;
+    }
+    .result-title {
+      font-size: 1.12rem;
+      font-weight: 800;
+      color: #1f2b2d;
+      line-height: 1.2;
+      margin-bottom: 4px;
+    }
+    .result-subtitle {
+      color: #546365;
+      font-size: 0.93rem;
+    }
+    .metric-stack {
+      display: flex;
+      gap: 8px;
+      flex-wrap: wrap;
+      justify-content: flex-end;
+    }
+    .score-pill, .strength-pill, .chip {
+      display: inline-block;
+      border-radius: 999px;
+      padding: 5px 10px;
+      font-size: 0.82rem;
+      font-weight: 700;
+      white-space: nowrap;
+    }
+    .score-pill {
+      background: #1f5f5b;
+      color: white;
+    }
+    .strength-pill {
+      background: #f3e4b9;
+      color: #5a470d;
+    }
+    .chip-row {
+      display: flex;
+      flex-wrap: wrap;
+      gap: 8px;
+      margin: 12px 0 10px 0;
+    }
+    .chip {
+      background: #f2ede2;
+      color: #4a4a4a;
+    }
+    .meta-grid {
+      display: grid;
+      grid-template-columns: repeat(auto-fit, minmax(150px, 1fr));
+      gap: 10px;
+      margin-top: 10px;
+      font-size: 0.9rem;
+      color: #465558;
+    }
+    .meta-grid strong {
+      display: block;
+      color: #1f2b2d;
+      margin-bottom: 2px;
+      font-size: 0.82rem;
+      text-transform: uppercase;
+      letter-spacing: 0.04em;
+    }
+    .result-hint {
+      margin-top: 12px;
+      font-size: 0.88rem;
+      color: #7a5b20;
+    }
+    .panel-note {
+      background: #fffdf8;
+      border: 1px solid #e7dcc8;
+      border-radius: 18px;
+      padding: 14px 16px;
+      color: #4b4b4b;
+      margin-bottom: 12px;
+    }
+    """
+
+
+def _hero_html(manifest: Dict[str, Any]) -> str:
+    counts = manifest.get("counts") or {}
+    cards = [
+        ("House members", int(counts.get("members", 0) or 0), "Members included in this released slice."),
+        ("Scored events", int(counts.get("scored_events", 0) or 0), "Row-level public-record overlaps that survived into the release."),
+        ("Relationship rows", int(counts.get("graph_links", 0) or 0), "Member-to-sector or member-to-recipient links in the public package."),
+        ("Source records", int(counts.get("source_artifacts", 0) or 0), "Published source artifacts in the verification layer."),
+    ]
+    card_html = "".join(
+        f"""
+        <div class="stat-card">
+          <div class="stat-label">{html.escape(label)}</div>
+          <div class="stat-value">{value:,}</div>
+          <div class="stat-help">{html.escape(help_text)}</div>
+        </div>
+        """
+        for label, value, help_text in cards
+    )
+    return f"""
+    <section class="hero-panel">
+      <div class="hero-eyebrow">Public-record overlap explorer</div>
+      <div class="hero-title">{html.escape(str(manifest.get("title") or "Congress Public Records Slice"))}</div>
+      <div class="hero-lede">Quickly check whether a House member's disclosed financial or funding relationships line up with public legislative activity in the same area.</div>
+      <div class="hero-lede">Built for journalists, researchers, and curious citizens who want a faster path from a vague hunch to inspectable public records.</div>
+      <div class="hero-note"><strong>What this does not claim:</strong> this tool does not prove corruption, illegality, intent, or causality. It shows public-record overlap and evidence strength so people can inspect the records themselves.</div>
+      <div class="stat-grid">{card_html}</div>
+    </section>
+    """
+
+
+def _start_here_cards_html() -> str:
+    cards = [
+        (
+            "What this helps answer",
+            "Do a member's disclosed financial or funding relationships line up with public legislative activity in the same area?"
+        ),
+        (
+            "Why someone might care",
+            "It helps move from a vague suspicion to a concrete set of records worth checking, without pulling multiple public sources by hand."
+        ),
+        (
+            "What it does not mean",
+            "A visible relationship here is not a verdict. It is a signal that enough public records line up to justify closer reporting or review."
+        ),
+    ]
+    return "<div class=\"story-grid\">" + "".join(
+        f"""
+        <div class="story-card">
+          <div class="story-title">{html.escape(title)}</div>
+          <div class="story-body">{html.escape(body)}</div>
+        </div>
+        """
+        for title, body in cards
+    ) + "</div>"
+
+
+def _source_table_html(manifest: Dict[str, Any]) -> str:
+    summary = manifest.get("methodology_summary") or {}
+    present_sources = set(_split_source_group_lines(summary.get("source_groups")))
+    source_pairs = [
+        ("House Clerk financial disclosures and PTRs", "Show trades or financial holdings disclosed by House members."),
+        ("House Clerk member directory and committee list", "Identify members and show committee context."),
+        ("GovInfo BILLSTATUS bulk data", "Show bill activity tied to the same policy area."),
+        ("House Clerk roll-call vote XML", "Show vote activity tied to the same policy area."),
+        ("FEC public bulk downloads", "Add campaign-finance context where it is used in this release."),
+        ("LDA public search pages", "Add lobbying visibility around the same issue areas."),
+        ("House member community project funding disclosure pages", "Show member-published funding-request disclosures."),
+        ("USAspending award pages used for some recipient matching", "Show public award records used to support some funding-recipient links."),
+    ]
+    rows = "".join(
+        f"<tr><th>{html.escape(source)}</th><td>{html.escape(purpose)}</td></tr>"
+        for source, purpose in source_pairs
+        if source in present_sources
+    )
+    return f"""
+    <div class="source-card">
+      <div class="section-kicker">What data is in here</div>
+      <div class="source-title">Public source families used in this release</div>
+      <table class="source-table">
+        <thead><tr><th>Source</th><th>What it adds</th></tr></thead>
+        <tbody>{rows}</tbody>
+      </table>
+    </div>
+    """
+
+
+def _glossary_html() -> str:
+    items = [
+        ("Stronger support", "The released slice has clearer public support for this relationship."),
+        ("Needs review", "There is some support, but it should still be read with caution."),
+        ("Integrity-checked record", "The release includes a cryptographic fingerprint to help show the published record has not been altered."),
+        ("Evidence window", "A coarse view of when the published records line up; it is not exact chronology."),
+    ]
+    rows = "".join(
+        f"<div class=\"glossary-item\"><strong>{html.escape(term)}</strong><div>{html.escape(body)}</div></div>"
+        for term, body in items
+    )
+    return f"""
+    <div class="glossary-card">
+      <div class="section-kicker">Sticky terms</div>
+      <div class="glossary-title">Plain-English glossary</div>
+      <div class="glossary-list">{rows}</div>
+    </div>
+    """
+
+
 def _plain_status_label(value: str) -> str:
     normalized = str(value or "").strip()
     mapping = {
@@ -552,12 +885,82 @@ def _overview_summary_markdown(
     return "\n".join(lines)
 
 
+def _overview_cards_html(
+    ranked: pd.DataFrame,
+    *,
+    member_query: str,
+    family: str,
+    only_strong_links: bool,
+    top_n: int,
+) -> str:
+    if ranked.empty:
+        return (
+            "<div class=\"panel-note\">"
+            "<strong>No relationships match the current filters.</strong><br>"
+            "Try a different House member, switch from sectors to funding recipients, or turn off the stronger-links-only filter."
+            "</div>"
+        )
+    focus_names = [str(value) for value in ranked["member"].dropna().unique().tolist() if str(value).strip()]
+    focus_label = ", ".join(focus_names[:3]) or "this view"
+    intro = (
+        "<div class=\"panel-note\">"
+        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."
+        "</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])
+        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)
+        cards.append(
+            f"""
+            <div class="result-card">
+              <div class="result-head">
+                <div>
+                  <div class="result-rank">Rank #{int(row.get("rank", 0) or 0)}</div>
+                  <div class="result-title">{html.escape(str(row.get("counterparty / sector", "") or ""))}</div>
+                  <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>
+                </div>
+              </div>
+              <div class="chip-row">{chip_html or '<span class="chip">published source support</span>'}</div>
+              <div class="meta-grid">
+                <div><strong>Evidence window</strong>{html.escape(str(row.get("time-window overlap", "") or ""))}</div>
+                <div><strong>Supporting rows</strong>{supporting_rows}</div>
+                <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>
+              <div class="result-hint">Use “Explain this link” below to open the detailed breakdown for this relationship.</div>
+            </div>
+            """
+        )
+    if not str(member_query or "").strip():
+        cards.insert(
+            0,
+            "<div class=\"panel-note\"><strong>Tip:</strong> Type one House member name above for the clearest first read.</div>",
+        )
+    return intro + "<div class=\"result-list\">" + "".join(cards) + "</div>"
+
+
 def _relationship_options(ranked: pd.DataFrame) -> list[tuple[str, str]]:
     if ranked.empty:
         return []
     options: list[tuple[str, str]] = []
     for row in ranked.to_dict("records"):
-        label = f"{row['member']} -> {row['counterparty / sector']} (score {row['overall score']})"
+        label = (
+            f"#{int(row['rank'])} {row['counterparty / sector']} "
+            f"— {row['strength']} (score {row['overall score']})"
+        )
         options.append((label, str(row["relationship_id"])))
     return options
 
@@ -588,6 +991,7 @@ def _relationship_detail_markdown(edges: pd.DataFrame, relationship_id: str) ->
         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)}`",
+        f"- Integrity-checked source records attached: `{int(row.get('sha_backed_source_artifact_count', 0) or 0)}`",
         f"- Unresolved source refs still counted: `{int(row.get('unresolved_source_ref_count', 0) or 0)}`",
         f"- Evidence signals: `{', '.join(chips) if chips else 'published source support'}`",
         f"- Time-window overlap: `{_window_overlap_text(row)}`",
@@ -598,6 +1002,14 @@ def _relationship_detail_markdown(edges: pd.DataFrame, relationship_id: str) ->
     if urls:
         lines.extend(["", "#### Example published source URLs", ""])
         lines.extend(f"- {item}" for item in urls)
+    lines.extend(
+        [
+            "",
+            "#### Integrity note",
+            "",
+            "- `Integrity-checked` means the release includes a cryptographic fingerprint to help show a published record has not been altered.",
+        ]
+    )
     return "\n".join(lines)
 
 
@@ -742,12 +1154,12 @@ def _consistency_summary_markdown(consistency: Dict[str, Any]) -> str:
             "### Audit Summary",
             "",
             f"- Event rows in the audit index: `{int(event_payload.get('event_count', 0) or 0)}`",
-            f"- Event rows with attached artifacts: `{int(event_payload.get('events_with_artifacts', 0) or 0)}`",
+            f"- Event rows with integrity-checked source records: `{int(event_payload.get('events_with_artifacts', 0) or 0)}`",
             f"- Stored-versus-lookup provenance mismatches: `{int(event_payload.get('stored_lookup_mismatch_count', 0) or 0)}`",
             f"- Claim-supporting rows in the audit index: `{int(claim_payload.get('row_count', 0) or 0)}`",
-            f"- Claim-supporting rows with attached artifacts: `{int(claim_payload.get('rows_with_artifacts', 0) or 0)}`",
+            f"- Claim-supporting rows with integrity-checked source records: `{int(claim_payload.get('rows_with_artifacts', 0) or 0)}`",
             "",
-            "Use the tables below to inspect the public source URLs and SHA-backed artifacts that support the released rows.",
+            "Use the tables below to inspect the public source URLs and integrity-checked source records that support the released rows.",
         ]
     )
 
@@ -877,7 +1289,7 @@ def _render_graph(nodes: pd.DataFrame, edges: pd.DataFrame) -> str:
 
 def _event_detail(events: pd.DataFrame, provenance: pd.DataFrame, event_id: str) -> Tuple[str, pd.DataFrame]:
     if not event_id or event_id not in set(events["event_id"]):
-        return "Select an event id to inspect source URLs and SHA-backed artifacts.", pd.DataFrame()
+        return "Select an event id to inspect source URLs and integrity-checked source records.", pd.DataFrame()
     event_row = events[events["event_id"] == event_id].head(1).to_dict("records")[0]
     prov_rows = provenance[provenance["row_key"] == event_id]
     member_name = str(event_row.get("member_name") or event_row.get("member_slug") or "Unknown member")
@@ -895,7 +1307,7 @@ def _event_detail(events: pd.DataFrame, provenance: pd.DataFrame, event_id: str)
         "This panel summarizes one released event row from the public slice.",
         "",
         f"- Event id: `{event_id}`",
-        f"- Event type: `{event_type}`",
+            f"- Event type: `{event_type}`",
     ]
     if score_label:
         lines.append(f"- Score label: `{score_label}`")
@@ -909,7 +1321,7 @@ def _event_detail(events: pd.DataFrame, provenance: pd.DataFrame, event_id: str)
     lines.extend(
         [
             f"- Attached source URLs in this row: `{int(event_row.get('source_ref_count', 0) or 0)}`",
-            f"- SHA-backed artifacts attached: `{int(event_row.get('sha_backed_source_artifact_count', 0) or 0)}`",
+            f"- Integrity-checked source records attached: `{int(event_row.get('sha_backed_source_artifact_count', 0) or 0)}`",
             f"- Unresolved source references still counted: `{int(event_row.get('unresolved_source_ref_count', 0) or 0)}`",
             f"- Matching provenance rows shown below: `{len(prov_rows)}`",
         ]
@@ -962,140 +1374,259 @@ def build_app(copy_path: str | Path):
     overview_member_limit = int(graph_defaults.get("overview_member_limit", 8))
     default_member_search = str(graph_defaults.get("default_member_search", "") or "")
 
-    with gr.Blocks(title=copy_payload.get("title", "Congress Public Records Slice")) as app:
-        gr.Markdown(copy_payload.get("welcome_markdown", copy_payload.get("landing_markdown", "")))
-        with gr.Tab("Start Here"):
-            gr.Markdown(_about_release_markdown(manifest, data["recipient_link_quality"], data["source_quality"]))
-            gr.Markdown(_fictional_example_markdown())
-            gr.Markdown(_data_used_markdown(manifest))
-            gr.Markdown(_how_to_use_markdown())
-        with gr.Tab("Overview"):
+    def _overview_edges(member_query: str, family: str, only_strong: bool, top_n: int) -> pd.DataFrame:
+        return _filter_graph(
+            edges,
+            family,
+            member_query,
+            "",
+            "all",
+            "stronger" if only_strong else "all",
+            True,
+            int(top_n),
+            overview_member_limit,
+        )
+
+    def _update_overview(member_query: str, family: str, only_strong: bool, top_n: int, relationship_id: str | None = None):
+        filtered_edges = _overview_edges(member_query, family, only_strong, int(top_n))
+        ranked = _rank_relationships(filtered_edges)
+        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)
+        return (
+            _overview_summary_markdown(
+                ranked,
+                member_query=member_query,
+                family=family,
+                only_strong_links=only_strong,
+                top_n=int(top_n),
+            ),
+            _overview_cards_html(
+                ranked,
+                member_query=member_query,
+                family=family,
+                only_strong_links=only_strong,
+                top_n=int(top_n),
+            ),
+            gr.update(choices=options, value=selected),
+            _relationship_detail_markdown(filtered_edges, selected or ""),
+            _relationship_timeline_html(filtered_edges, selected or ""),
+        )
+
+    def _update_overview_detail(member_query: str, family: str, only_strong: bool, top_n: int, 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)
+
+    def _update_graph(member_query: str, family: str, only_strong: bool, top_n: int):
+        review_status = "stronger" if only_strong else "all"
+        filtered_edges = _filter_graph(
+            edges,
+            family,
+            member_query,
+            "",
+            "all",
+            review_status,
+            True,
+            int(top_n),
+            overview_member_limit,
+        )
+        filtered_nodes = nodes[
+            nodes["node_id"].isin(set(filtered_edges["source_node_id"]).union(set(filtered_edges["target_node_id"])))
+        ]
+        summary = _graph_view_summary_markdown(
+            filtered_edges,
+            family=family,
+            member_query=member_query,
+            target_query="",
+            review_status=review_status,
+            max_edges=int(top_n),
+        )
+        return summary, _render_graph(filtered_nodes, filtered_edges), _graph_table(filtered_edges)
+
+    def _reset_graph(member_query: str):
+        default_family = str(graph_defaults.get("relationship_family", "sector"))
+        default_top_n = min(max(int(graph_defaults.get("max_edges", 20) or 20), 10), 30)
+        filtered_edges = _filter_graph(
+            edges,
+            default_family,
+            member_query,
+            "",
+            "all",
+            "stronger",
+            True,
+            int(default_top_n),
+            overview_member_limit,
+        )
+        filtered_nodes = nodes[
+            nodes["node_id"].isin(set(filtered_edges["source_node_id"]).union(set(filtered_edges["target_node_id"])))
+        ]
+        summary = _graph_view_summary_markdown(
+            filtered_edges,
+            family=default_family,
+            member_query=member_query,
+            target_query="",
+            review_status="stronger",
+            max_edges=int(default_top_n),
+        )
+        return (
+            gr.update(value=default_family),
+            gr.update(value=True),
+            gr.update(value=int(default_top_n)),
+            summary,
+            _render_graph(filtered_nodes, filtered_edges),
+            _graph_table(filtered_edges),
+        )
+
+    def _update_events(member_query: str, event_type: str, score_label: str, text_query: str):
+        return _filter_events(events, member_query, event_type, score_label, text_query)
+
+    with gr.Blocks(title=copy_payload.get("title", "Congress Public Records Slice"), css=_space_css()) as app:
+        gr.HTML(_hero_html(manifest))
+        gr.HTML(_start_here_cards_html())
+
+        with gr.Accordion("Start here: what this is and how to use it", open=True):
             gr.Markdown(
-                "### Start here\n\n"
-                "Pick one House member, choose whether you want sectors or funding recipients, and read the ranked list first."
+                "### What you can do in 30 seconds\n\n"
+                "1. Search one House member.\n"
+                "2. Read the ranked sectors or funding recipients.\n"
+                "3. Pick one relationship in **Explain this link**.\n"
+                "4. Open the example source URLs if you want to verify it yourself.\n\n"
+                "Treat this as a lead generator for public-record review, not a conclusion machine."
             )
+            gr.Markdown(_fictional_example_markdown())
             with gr.Row():
-                overview_member = gr.Textbox(label="House member", value=default_member_search)
-                overview_family = gr.Dropdown(label="Show", choices=[("Sectors", "sector"), ("Funding recipients", "recipient")], value="sector")
-                overview_only_strong = gr.Checkbox(label="Only strong links", value=True)
-                overview_top_n = gr.Slider(label="Show top relationships", minimum=5, maximum=40, step=5, value=10)
-            if example_member_choices:
-                gr.Examples(examples=example_member_choices, inputs=[overview_member], label="Try one of these example members")
-            overview_summary_md = gr.Markdown()
-            overview_df = gr.Dataframe(interactive=False)
-            relationship_choice = gr.Dropdown(label="Relationship to explain", choices=[], value=None)
+                gr.HTML(_source_table_html(manifest))
+                gr.HTML(_glossary_html())
+
+        gr.Markdown("## Overview")
+        gr.Markdown(
+            "Search one House member, choose sectors or funding recipients, and start with the ranked list. "
+            "This is the main reading path."
+        )
+        with gr.Row():
+            overview_member = gr.Textbox(label="House member", value=default_member_search, scale=3)
+            search_button = gr.Button("Search a House member", variant="primary", scale=1)
+        with gr.Row():
+            overview_family = gr.Radio(
+                label="Show",
+                choices=[("Sectors", "sector"), ("Funding recipients", "recipient")],
+                value="sector",
+            )
+            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:
+            gr.Examples(examples=example_member_choices, inputs=[overview_member], label="Try one of these example members")
+        overview_summary_md = gr.Markdown()
+        overview_cards = gr.HTML()
+
+        gr.Markdown("## Explain Link")
+        relationship_choice = gr.Dropdown(label="Explain this link", choices=[], value=None)
+        with gr.Row():
             overview_detail_md = gr.Markdown()
             overview_timeline_html = gr.HTML()
 
-            def _overview_edges(member_query: str, family: str, only_strong: bool, top_n: int) -> pd.DataFrame:
-                return _filter_graph(
-                    edges,
-                    family,
-                    member_query,
-                    "",
-                    "all",
-                    "stronger" if only_strong else "all",
-                    True,
-                    top_n,
-                    overview_member_limit,
-                )
-
-            def _update_overview(member_query: str, family: str, only_strong: bool, top_n: int):
-                filtered_edges = _overview_edges(member_query, family, only_strong, top_n)
-                ranked = _rank_relationships(filtered_edges)
-                options = _relationship_options(ranked)
-                selected = options[0][1] if options else None
-                display = ranked.drop(columns=["relationship_id", "source_examples"], errors="ignore")
-                return (
-                    _overview_summary_markdown(
-                        ranked,
-                        member_query=member_query,
-                        family=family,
-                        only_strong_links=only_strong,
-                        top_n=top_n,
-                    ),
-                    display,
-                    gr.update(choices=options, value=selected),
-                    _relationship_detail_markdown(filtered_edges, selected or ""),
-                    _relationship_timeline_html(filtered_edges, selected or ""),
-                )
-
-            def _update_overview_detail(member_query: str, family: str, only_strong: bool, top_n: int, relationship_id: str):
-                filtered_edges = _overview_edges(member_query, family, only_strong, top_n)
-                return _relationship_detail_markdown(filtered_edges, relationship_id), _relationship_timeline_html(filtered_edges, relationship_id)
-
-            for control in (overview_member, overview_family, overview_only_strong, overview_top_n):
-                control.change(
-                    _update_overview,
-                    [overview_member, overview_family, overview_only_strong, overview_top_n],
-                    [overview_summary_md, overview_df, relationship_choice, overview_detail_md, overview_timeline_html],
-                )
-            relationship_choice.change(
-                _update_overview_detail,
+        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.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],
+        )
+        for control in (overview_family, overview_only_strong, overview_top_n):
+            control.change(
+                _update_overview,
                 [overview_member, overview_family, overview_only_strong, overview_top_n, relationship_choice],
-                [overview_detail_md, overview_timeline_html],
+                [overview_summary_md, overview_cards, relationship_choice, overview_detail_md, overview_timeline_html],
             )
-            app.load(
-                _update_overview,
-                [overview_member, overview_family, overview_only_strong, overview_top_n],
-                [overview_summary_md, overview_df, relationship_choice, overview_detail_md, overview_timeline_html],
+        relationship_choice.change(
+            _update_overview_detail,
+            [overview_member, overview_family, overview_only_strong, overview_top_n, relationship_choice],
+            [overview_detail_md, overview_timeline_html],
+        )
+
+        with gr.Accordion("Explore the network map (optional)", open=False):
+            gr.Markdown(
+                "The ranked list above is the clearest way to read this release. "
+                "Use the map below only if you want a visual view of the same relationships."
             )
-        with gr.Tab("Explore Graph (optional)"):
             gr.Markdown(_graph_intro_markdown(data["graph_config"]))
             with gr.Row():
-                family = gr.Dropdown(label="Show", choices=graph_family_choices, value=str(graph_defaults.get("relationship_family", "sector")))
-                member_graph_query = gr.Textbox(label="House member to focus", value=default_member_search)
-                target_query = gr.Textbox(label="Recipient or sector search")
-                graph_score = gr.Dropdown(label="Score label", choices=graph_score_choices, value="all")
-                review_status = gr.Dropdown(label="Which links to show", choices=graph_status_choices, value=str(graph_defaults.get("review_status", "stronger")))
-            if example_member_choices:
-                gr.Examples(examples=example_member_choices, inputs=[member_graph_query], label="Try one of these example members")
-            with gr.Row():
-                hide_unresolved_only = gr.Checkbox(label="Hide unresolved links", value=bool(graph_defaults.get("hide_unresolved_only", True)))
-                max_edges = gr.Slider(label="Show top relationships", minimum=25, maximum=300, step=25, value=int(graph_defaults.get("max_edges", 60)))
+                graph_family = gr.Radio(
+                    label="Show",
+                    choices=graph_family_choices,
+                    value=str(graph_defaults.get("relationship_family", "sector")),
+                )
+                graph_only_strong = gr.Checkbox(label="Only stronger links", value=True)
+                graph_top_n = gr.Dropdown(label="Show top", choices=[10, 20, 30], value=min(max(int(graph_defaults.get("max_edges", 20) or 20), 10), 30))
+                graph_reset = gr.Button("Reset view")
             graph_summary_md = gr.Markdown()
             graph_html = gr.HTML()
-            gr.Markdown("#### Relationship list for this graph view")
-            graph_df = gr.Dataframe(interactive=False)
-            def _update_graph(family: str, member_graph_query: str, target_query: str, graph_score: str, review_status: str, hide_unresolved_only: bool, max_edges: int):
-                filtered_edges = _filter_graph(edges, family, member_graph_query, target_query, graph_score, review_status, hide_unresolved_only, max_edges, overview_member_limit)
-                filtered_nodes = nodes[nodes["node_id"].isin(set(filtered_edges["source_node_id"]).union(set(filtered_edges["target_node_id"])))]
-                summary = _graph_view_summary_markdown(
-                    filtered_edges,
-                    family=family,
-                    member_query=member_graph_query,
-                    target_query=target_query,
-                    review_status=review_status,
-                    max_edges=max_edges,
+            with gr.Accordion("Current relationships in this map", open=False):
+                graph_df = gr.Dataframe(interactive=False)
+
+            for control in (graph_family, graph_only_strong, graph_top_n):
+                control.change(
+                    _update_graph,
+                    [overview_member, graph_family, graph_only_strong, graph_top_n],
+                    [graph_summary_md, graph_html, graph_df],
                 )
-                return summary, _render_graph(filtered_nodes, filtered_edges), _graph_table(filtered_edges)
-            for control in (family, member_graph_query, target_query, graph_score, review_status, hide_unresolved_only, max_edges):
-                control.change(_update_graph, [family, member_graph_query, target_query, graph_score, review_status, hide_unresolved_only, max_edges], [graph_summary_md, graph_html, graph_df])
-            app.load(_update_graph, [family, member_graph_query, target_query, graph_score, review_status, hide_unresolved_only, max_edges], [graph_summary_md, graph_html, graph_df])
-        with gr.Tab("Search Events"):
-            with gr.Row():
-                member_query = gr.Textbox(label="Member name or slug")
-                event_type = gr.Dropdown(label="Event type", choices=event_type_choices, value="all")
-                score_label = gr.Dropdown(label="Score label", choices=score_label_choices, value="all")
-                text_query = gr.Textbox(label="Issuer or sector search")
-            explore_df = gr.Dataframe(value=events.head(100), interactive=False)
-            def _update_events(member_query: str, event_type: str, score_label: str, text_query: str):
-                return _filter_events(events, member_query, event_type, score_label, text_query)
-            for control in (member_query, event_type, score_label, text_query):
-                control.change(_update_events, [member_query, event_type, score_label, text_query], explore_df)
-        with gr.Tab("Event Detail"):
-            event_id = gr.Dropdown(label="Event id", choices=event_id_choices, value=event_id_choices[0] if event_id_choices else None)
-            event_detail_md = gr.Markdown()
-            event_detail_df = gr.Dataframe(interactive=False)
-            event_id.change(_event_detail, [gr.State(events), gr.State(provenance), event_id], [event_detail_md, event_detail_df])
-            app.load(_event_detail, [gr.State(events), gr.State(provenance), event_id], [event_detail_md, event_detail_df])
-        with gr.Tab("Audit"):
-            gr.Markdown(_consistency_summary_markdown(data["consistency"]))
-            gr.Dataframe(value=data["artifact_index"].head(200), interactive=False)
-        with gr.Tab("Methodology & Limits"):
-            gr.Markdown(copy_payload.get("landing_markdown", ""))
-            gr.Markdown(_data_used_markdown(manifest))
-            gr.Markdown(copy_payload.get("downloads_markdown", ""))
-        with gr.Tab("Downloads"):
-            gr.Markdown(copy_payload.get("downloads_markdown", ""))
+            graph_reset.click(
+                _reset_graph,
+                [overview_member],
+                [graph_family, graph_only_strong, graph_top_n, graph_summary_md, graph_html, graph_df],
+            )
+            search_button.click(
+                _update_graph,
+                [overview_member, graph_family, graph_only_strong, graph_top_n],
+                [graph_summary_md, graph_html, graph_df],
+            )
+            overview_member.submit(
+                _update_graph,
+                [overview_member, graph_family, graph_only_strong, graph_top_n],
+                [graph_summary_md, graph_html, graph_df],
+            )
+
+        with gr.Accordion("Audit & downloads", open=False):
+            gr.Markdown(
+                "Use these lower sections if you want the raw released event rows, the verification layer, or the download notes. "
+                "Most people can start and stop with the overview above."
+            )
+            with gr.Accordion("Search released event rows", open=False):
+                with gr.Row():
+                    member_query = gr.Textbox(label="Member name or slug")
+                    event_type = gr.Dropdown(label="Event type", choices=event_type_choices, value="all")
+                    score_label = gr.Dropdown(label="Score label", choices=score_label_choices, value="all")
+                    text_query = gr.Textbox(label="Issuer or sector search")
+                explore_df = gr.Dataframe(value=events.head(100), interactive=False)
+                for control in (member_query, event_type, score_label, text_query):
+                    control.change(_update_events, [member_query, event_type, score_label, text_query], explore_df)
+
+            with gr.Accordion("Inspect one released event row", open=False):
+                event_id = gr.Dropdown(label="Event id", choices=event_id_choices, value=event_id_choices[0] if event_id_choices else None)
+                event_detail_md = gr.Markdown()
+                event_detail_df = gr.Dataframe(interactive=False)
+                event_id.change(_event_detail, [gr.State(events), gr.State(provenance), event_id], [event_detail_md, event_detail_df])
+                app.load(_event_detail, [gr.State(events), gr.State(provenance), event_id], [event_detail_md, event_detail_df])
+
+            with gr.Accordion("Integrity-checked source records and audit summary", open=False):
+                gr.Markdown(_consistency_summary_markdown(data["consistency"]))
+                gr.Dataframe(value=data["artifact_index"].head(200), interactive=False)
+
+            with gr.Accordion("Methodology, limits, and downloads", open=False):
+                gr.Markdown(copy_payload.get("landing_markdown", ""))
+                gr.Markdown(copy_payload.get("downloads_markdown", ""))
+
+        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],
+        )
+        app.load(
+            _update_graph,
+            [overview_member, graph_family, graph_only_strong, graph_top_n],
+            [graph_summary_md, graph_html, graph_df],
+        )
     return app