Simplify graph UX with focused default member view

dataset_bundle/evidence_audit/consistency_report.json

@@ -1,5 +1,5 @@
 {
-  "generated_at": "2026-04-19T10:01:10-04:00",
+  "generated_at": "2026-04-19T11:09:07-04:00",
   "event_provenance": {
     "event_count": 3918,
     "events_with_artifacts": 3878,

dataset_bundle/network_graph/graph_config.json

@@ -20,9 +20,10 @@
   "default_filters": {
     "relationship_family": "sector",
     "review_status": "stronger",
-    "max_edges": 60,
+    "max_edges": 30,
     "hide_unresolved_only": true,
-    "overview_member_limit": 8
+    "overview_member_limit": 5,
+    "default_member_search": "Josh Gottheimer"
   },
   "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-19T10:02:16-04:00",
+  "release_date": "2026-04-19T08:23:16-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

@@ -153,15 +153,27 @@ def _graph_intro_markdown(config: Dict[str, Any]) -> str:
     status_counts = config.get("relationship_status_counts") or {}
     defaults = config.get("default_filters") or {}
     example_members = [str(item) for item in (config.get("example_member_searches") or []) if str(item).strip()]
+    default_member = str(defaults.get("default_member_search", "") or "").strip()
+    opening_line = (
+        f"- This graph opens focused on `{default_member}` so the first view is readable."
+        if default_member
+        else f"- This graph opens in a small `{_plain_family_label(str(defaults.get('relationship_family', 'sector'))).lower()}` overview."
+    )
+    next_step_line = (
+        "- Replace the member name above to explore someone else, or clear it to return to the small overview."
+        if default_member
+        else "- Search one House member above for the clearest view."
+    )
     return "\n".join(
         [
             "### What you are looking at",
             "",
             "- Green dots are House members, rust dots are funding recipients, and gold dots are sectors.",
             "- Thicker lines mean more supporting relationship rows in this released slice.",
-            f"- This graph opens in a simpler `{_plain_family_label(str(defaults.get('relationship_family', 'sector'))).lower()}` overview so the first screen is easier to read.",
+            opening_line,
             f"- The default status filter is `{_plain_status_label(str(defaults.get('review_status', 'stronger'))).lower()}`.",
             f"- Unresolved-only edges start hidden: `{str(bool(defaults.get('hide_unresolved_only', True))).lower()}`.",
+            next_step_line,
             *([f"- Example member searches: {', '.join(f'`{item}`' for item in example_members)}."] if example_members else []),
             f"- Current graph inventory: `{int(node_counts.get('member', 0) or 0)}` members, `{int(node_counts.get('recipient', 0) or 0)}` recipients, `{int(node_counts.get('sector', 0) or 0)}` sectors.",
             f"- Relationship counts: `{int(edge_counts.get('recipient', 0) or 0)}` recipient edges, `{int(edge_counts.get('sector', 0) or 0)}` sector edges.",
@@ -172,6 +184,84 @@ def _graph_intro_markdown(config: Dict[str, Any]) -> str:
     )
 
 
+def _graph_view_summary_markdown(
+    edges: pd.DataFrame,
+    *,
+    family: str,
+    member_query: str,
+    target_query: str,
+    review_status: str,
+    max_edges: int,
+) -> str:
+    if edges.empty:
+        return "\n".join(
+            [
+                "### Current view",
+                "",
+                "No relationships match the current filters.",
+                "",
+                "Try one House member name, switch relationship view, or clear the current filters.",
+            ]
+        )
+    member_count = int(edges["member_slug"].nunique())
+    target_count = int(edges["target_key"].nunique())
+    visible_count = int(len(edges))
+    family_label = _plain_family_label(family)
+    status_label = _plain_status_label(review_status)
+    lines = [
+        "### Current view",
+        "",
+        f"- Showing `{visible_count}` visible relationships across `{member_count}` House members and `{target_count}` targets.",
+        f"- Relationship view: `{family_label}`",
+        f"- Strength filter: `{status_label}`",
+        f"- Visible relationship cap: `{int(max_edges)}`",
+    ]
+    if member_query.strip():
+        focus_members = ", ".join(sorted({str(value) for value in edges["member_name"].fillna("").tolist() if str(value).strip()})[:4])
+        if focus_members:
+            lines.append(f"- Focused on: `{focus_members}`")
+        lines.append("- Tip: change the member name above to compare someone else, or clear it to return to the small overview.")
+    else:
+        lines.append("- This is an overview, so it only shows a small set of members. Search one member name for the clearest read.")
+    if target_query.strip():
+        lines.append(f"- Target filter: `{target_query.strip()}`")
+    return "\n".join(lines)
+
+
+def _graph_table(edges: pd.DataFrame) -> pd.DataFrame:
+    if edges.empty:
+        return pd.DataFrame(columns=["member", "target", "relationship_view", "strength", "supporting_rows"])
+    rows: list[dict[str, Any]] = []
+    for row in edges.to_dict("records"):
+        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
+        )
+        caution_support = int(
+            row.get("review_count", 0) or 0
+            if family == "recipient"
+            else row.get("weak_event_count", 0) or 0
+        )
+        source_examples = ", ".join(_split_pipe_values(row.get("source_urls", ""), limit=2))
+        rows.append(
+            {
+                "member": str(row.get("member_name") or row.get("member_slug") or ""),
+                "target": str(row.get("target_label") or ""),
+                "relationship_view": _plain_family_label(family),
+                "strength": _plain_status_label(status),
+                "supporting_rows": int(row.get("link_count", 0) or 0),
+                "stronger_support": stronger_support,
+                "caution_support": caution_support,
+                "unresolved_refs": int(row.get("unresolved_source_ref_count", 0) or 0),
+                "source_examples": source_examples,
+            }
+        )
+    return pd.DataFrame(rows)
+
+
 def _filter_events(events: pd.DataFrame, member_query: str, event_type: str, score_label: str, text_query: str) -> pd.DataFrame:
     filtered = events.copy()
     if member_query.strip():
@@ -261,11 +351,28 @@ def _render_graph(nodes: pd.DataFrame, edges: pd.DataFrame) -> str:
     if edges.empty:
         return "<div style=\"padding: 1rem; border: 1px solid #d6d0c4; background: #fffdf8; color: #3a3a3a;\">No relationships match the current filters.</div>"
     network = Network(height="720px", width="100%", bgcolor="#fbf7ee", font_color="#1f2b2d")
-    network.barnes_hut(gravity=-15000, central_gravity=0.15, spring_length=220, spring_strength=0.02)
     network.set_options("""
     var options = {
       "interaction": {"hover": true, "tooltipDelay": 120, "navigationButtons": true, "keyboard": true},
-      "physics": {"stabilization": {"enabled": true, "iterations": 250}}
+      "physics": false,
+      "layout": {
+        "hierarchical": {
+          "enabled": true,
+          "direction": "LR",
+          "sortMethod": "directed",
+          "nodeSpacing": 170,
+          "treeSpacing": 220,
+          "levelSeparation": 220
+        }
+      },
+      "edges": {
+        "smooth": {
+          "enabled": true,
+          "type": "cubicBezier",
+          "forceDirection": "horizontal",
+          "roundness": 0.35
+        }
+      }
     }
     """)
     color_map = {"member": "#1f5f5b", "recipient": "#a24e2c", "sector": "#c08d2e"}
@@ -301,6 +408,7 @@ def _render_graph(nodes: pd.DataFrame, edges: pd.DataFrame) -> str:
             title="<br>".join(title_lines),
             color=color_map.get(str(node.get("node_type", "")), "#6e6e6e"),
             shape="dot",
+            level=0 if node_type == "member" else 1,
             size=16 + min(int(node.get("connected_edge_count", 0) or 0), 20),
         )
     for row in edges.to_dict("records"):
@@ -428,6 +536,7 @@ def build_app(copy_path: str | Path):
         ("Funding recipients", "recipient"),
         ("All relationships", "all"),
     ]
+    example_member_choices = [[item] for item in data["graph_config"].get("example_member_searches") or []]
     event_id_choices = sorted(events["event_id"].dropna().unique().tolist())
     graph_defaults = data["graph_config"].get("default_filters") or {}
     overview_member_limit = int(graph_defaults.get("overview_member_limit", 8))
@@ -438,22 +547,34 @@ def build_app(copy_path: str | Path):
             gr.Markdown(_graph_intro_markdown(data["graph_config"]))
             with gr.Row():
                 family = gr.Dropdown(label="Relationship view", choices=graph_family_choices, value=str(graph_defaults.get("relationship_family", "sector")))
-                member_graph_query = gr.Textbox(label="Member name or slug")
+                member_graph_query = gr.Textbox(label="House member to focus", value=str(graph_defaults.get("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="Relationship strength", 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 relationships", value=bool(graph_defaults.get("hide_unresolved_only", True)))
                 max_edges = gr.Slider(label="Max visible relationships", minimum=25, maximum=300, step=25, value=int(graph_defaults.get("max_edges", 60)))
+            graph_summary_md = gr.Markdown()
             graph_html = gr.HTML()
+            gr.Markdown("#### Relationships in this 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"])))]
-                return _render_graph(filtered_nodes, filtered_edges), filtered_edges
+                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,
+                )
+                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_html, graph_df])
-            app.load(_update_graph, [family, member_graph_query, target_query, graph_score, review_status, hide_unresolved_only, max_edges], [graph_html, graph_df])
+                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("Explore"):
             with gr.Row():
                 member_query = gr.Textbox(label="Member name or slug")