Redesign public disclosure explorer landing page

README.md

@@ -1,5 +1,5 @@
 ---
-title: Senator Wealth And Trading Dataset
+title: Senator Financial Disclosure Explorer
 emoji: 📊
 colorFrom: green
 colorTo: yellow
@@ -10,8 +10,8 @@ pinned: false
 license: cc-by-4.0
 ---
 
-# Senator Wealth And Trading Dataset
+# Senator Financial Disclosure Explorer
 
-Public-interest explorer for official Senate disclosure-derived wealth intervals, disclosed trades, filing behavior, and no-cost exploratory return-test summaries.
+Public-interest explorer for official Senate financial disclosures: reported wealth ranges, disclosed transactions, filing delays, and cautious market-context checks.
 
 This Space does not claim intent, illegality, causality, insider trading, realized private returns, or release-grade above-market alpha.

app.py

@@ -61,11 +61,41 @@ def pct(value) -> float | None:
         return None
 
 
+def fmt_int(value) -> str:
+    try:
+        return f"{int(value):,}"
+    except (TypeError, ValueError):
+        return str(value or "")
+
+
+def basis_label(value: str) -> str:
+    labels = {
+        "filing_date": "after public filing date",
+        "transaction_date": "after reported transaction date",
+    }
+    return labels.get(str(value), str(value).replace("_", " "))
+
+
+def window_label(value: str) -> str:
+    return str(value).replace("_trading_days", " trading days").replace("_", " ")
+
+
+def claim_label(value: str) -> str:
+    labels = {
+        "blocked_market_data_policy": "Not a public alpha claim: stronger market data required",
+        "blocked": "Not a public alpha claim",
+    }
+    return labels.get(str(value), str(value).replace("_", " "))
+
+
 RETURN_TESTS = pd.read_csv(DATASET / "return_tests.csv")
 RETURN_TESTS["equal_weight_alpha_pct"] = RETURN_TESTS["alpha_equal_weight"].map(pct)
 RETURN_TESTS["midpoint_weight_alpha_pct"] = RETURN_TESTS["alpha_midpoint"].map(pct)
 RETURN_TESTS["ci_low_pct"] = RETURN_TESTS["bootstrap_ci_low"].map(pct)
 RETURN_TESTS["ci_high_pct"] = RETURN_TESTS["bootstrap_ci_high"].map(pct)
+RETURN_TESTS["date_basis_label"] = RETURN_TESTS["event_date_source"].map(basis_label)
+RETURN_TESTS["window_label"] = RETURN_TESTS["window"].map(window_label)
+RETURN_TESTS["claim_status_label"] = RETURN_TESTS["claim_status"].map(claim_label)
 
 RETURN_HANDOFF = pd.read_csv(DATA / "reporter_handoff" / "return_test_summary_handoff.csv")
 TRADES = read_jsonl_gz("trades.jsonl.gz")
@@ -81,53 +111,148 @@ for col in ["net_worth_min", "net_worth_midpoint", "net_worth_max", "uncertainty
     WEALTH[col] = pd.to_numeric(WEALTH.get(col), errors="coerce")
 
 
+def hero_html() -> str:
+    return """
+    <section class="hero-panel" style="background:#ffffff;border:1px solid #cbd5e1;border-radius:12px;padding:22px 24px;margin:12px 0 16px;box-shadow:0 16px 40px rgba(15,23,42,.08);">
+      <div style="display:flex;gap:22px;align-items:flex-start;justify-content:space-between;flex-wrap:wrap;">
+        <div style="min-width:280px;flex:1 1 620px;">
+          <div style="color:#0f766e;font-size:.88rem;font-weight:800;letter-spacing:.04em;text-transform:uppercase;margin-bottom:8px;">Official Senate financial disclosure data</div>
+          <h1 style="color:#0f172a;font-size:2.35rem;line-height:1.08;font-weight:850;margin:0 0 10px;">Senator Financial Disclosure Explorer</h1>
+          <p style="color:#334155;font-size:1.08rem;line-height:1.6;max-width:850px;margin:0;">
+            This turns public Senate disclosure forms into searchable visuals: reported wealth ranges, disclosed transactions,
+            filing delays, and cautious market-context checks. It is built to show what the records say, where the uncertainty is,
+            and what cannot be concluded from the disclosures alone.
+          </p>
+        </div>
+        <div style="background:#f8fafc;border:1px solid #d7dee8;border-radius:10px;padding:14px 16px;min-width:250px;flex:0 1 310px;">
+          <div style="color:#64748b;font-size:.84rem;font-weight:800;text-transform:uppercase;letter-spacing:.04em;">Current evidence status</div>
+          <div style="color:#0f172a;font-size:1.35rem;font-weight:850;line-height:1.2;margin-top:5px;">Disclosure explorer: ready</div>
+          <div style="color:#8a4b00;font-size:1rem;font-weight:800;margin-top:10px;">Market-beating proof: not established</div>
+          <p style="color:#475569;font-size:.95rem;line-height:1.45;margin:8px 0 0;">The market checks are exploratory because the public bundle does not use a licensed total-return source with delisting handling.</p>
+        </div>
+      </div>
+    </section>
+    """
+
+
+def plain_english_cards_html() -> str:
+    cards = [
+        (
+            "What this is",
+            "A public-records browser for Senate financial disclosures: filings, reported asset ranges, liabilities, income rows, and disclosed transactions.",
+            "#e8f7f3",
+            "#0f766e",
+        ),
+        (
+            "Why wealth is shown as ranges",
+            "Disclosures use broad dollar brackets. The app shows low, midpoint, and high estimates so the uncertainty stays visible.",
+            "#eef4ff",
+            "#3155b7",
+        ),
+        (
+            "What the market charts mean",
+            "They compare disclosed timing to simple benchmarks under stated assumptions. They do not prove motive, private profit, illegality, or insider trading.",
+            "#fff7e8",
+            "#8a4b00",
+        ),
+    ]
+    cells = "".join(
+        f"""
+        <div style="background:{bg};border:1px solid rgba(15,23,42,.12);border-radius:10px;padding:15px 16px;min-height:142px;">
+          <div style="color:{accent};font-size:1.02rem;font-weight:850;margin-bottom:8px;">{title}</div>
+          <div style="color:#243447;font-size:1rem;line-height:1.5;">{body}</div>
+        </div>
+        """
+        for title, body, bg, accent in cards
+    )
+    return f"<div class='plain-cards' style='display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:12px;margin:14px 0 18px;'>{cells}</div>"
+
+
 def metric_html() -> str:
     counts = MANIFEST.get("counts", {})
     dataset = counts.get("dataset", {})
     returns = counts.get("return_tests", {})
     items = [
-        ("Trades", dataset.get("trades", "")),
-        ("Filings", dataset.get("filings", "")),
-        ("Asset rows", dataset.get("annual_assets", "")),
-        ("Wealth intervals", dataset.get("net_worth_intervals", "")),
-        ("Return events", returns.get("return_test_events", "")),
-        ("Alpha claim", "Blocked"),
+        ("Disclosed transaction rows", fmt_int(dataset.get("trades", "")), "transactions listed in Senate reports"),
+        ("Financial disclosure filings", fmt_int(dataset.get("filings", "")), "annual reports, PTRs, and amendments"),
+        ("Reported asset rows", fmt_int(dataset.get("annual_assets", "")), "asset bracket rows parsed from filings"),
+        ("Wealth range estimates", fmt_int(dataset.get("net_worth_intervals", "")), "low/mid/high disclosure estimates"),
+        ("Market-context event rows", fmt_int(returns.get("return_test_events", "")), "exploratory benchmark comparisons"),
+        ("Public alpha claim", "Not established", "blocked by market-data standard"),
     ]
     cells = "".join(
-        f"<div class='metric'><div class='metric-value'>{value}</div><div class='metric-label'>{label}</div></div>"
-        for label, value in items
+        f"""
+        <div class='metric' style='border:1px solid #cbd5e1;border-radius:10px;padding:13px 14px;background:#ffffff;box-shadow:0 6px 18px rgba(15,23,42,.05);'>
+          <div class='metric-value' style='font-size:1.38rem;font-weight:850;color:#0f766e;line-height:1.15;overflow-wrap:anywhere;'>{value}</div>
+          <div class='metric-label' style='font-size:.92rem;color:#0f172a;font-weight:800;margin-top:5px;line-height:1.25;'>{label}</div>
+          <div style='font-size:.82rem;color:#475569;font-weight:600;margin-top:4px;line-height:1.25;'>{note}</div>
+        </div>
+        """
+        for label, value, note in items
     )
-    return f"<div class='metrics'>{cells}</div>"
+    return f"<div class='metrics' style='display:grid;grid-template-columns:repeat(6,minmax(0,1fr));gap:12px;margin:14px 0 18px;'>{cells}</div>"
 
 
 def boundary_html() -> str:
-    return f"""
-    <div class='boundary'>
-      <strong>Claim boundary:</strong> {MANIFEST.get('claim_boundary', '')}
+    return """
+    <div class='boundary' style='border-left:5px solid #8a4b00;background:#fff7e8;color:#3f2a00;padding:14px 16px;border-radius:8px;margin:12px 0 20px;font-size:1rem;line-height:1.55;'>
+      <strong style='color:#2f1d00;font-weight:850;'>Important boundary:</strong>
+      This is a public disclosure explorer, not an accusation tool. It does not claim intent, illegality, causality,
+      insider trading, realized private returns, or proven above-market performance.
+    </div>
+    """
+
+
+def overview_intro_html() -> str:
+    return """
+    <div class="section-intro" style="background:#ffffff;border:1px solid #cbd5e1;border-radius:10px;padding:16px 18px;margin:8px 0 14px;">
+      <div style="color:#0f172a;font-size:1.18rem;font-weight:850;margin-bottom:6px;">Start with the records, then the timing</div>
+      <div style="color:#334155;font-size:1rem;line-height:1.55;">
+        The first charts show filing behavior and what assets appear most often in disclosed transactions.
+        The return chart is deliberately lower on the page because it is context, not a verdict.
+      </div>
+    </div>
+    """
+
+
+def market_note_html() -> str:
+    return """
+    <div class="section-intro" style="background:#f8fafc;border:1px solid #cbd5e1;border-radius:10px;padding:15px 16px;margin:12px 0;">
+      <div style="color:#0f172a;font-size:1.08rem;font-weight:850;margin-bottom:5px;">How to read the market-context chart</div>
+      <div style="color:#334155;font-size:1rem;line-height:1.55;">
+        Bars above zero mean the disclosed transaction set moved more than a simple benchmark in that window under one assumption.
+        Bars below zero mean it moved less. Because this public bundle uses no-cost adjusted-close data, every row remains exploratory.
+      </div>
     </div>
     """
 
 
 def return_chart():
     fig = go.Figure()
-    for date_basis, frame in RETURN_TESTS.groupby("event_date_source"):
+    for date_basis, frame in RETURN_TESTS.groupby("date_basis_label"):
         fig.add_trace(
             go.Bar(
-                name=date_basis.replace("_", " ").title(),
-                x=frame["window"],
+                name=str(date_basis).capitalize(),
+                x=frame["window_label"],
                 y=frame["equal_weight_alpha_pct"],
-                text=frame["claim_status"],
-                hovertemplate="%{x}<br>Equal-weight alpha: %{y:.3f}%<br>%{text}<extra></extra>",
+                customdata=frame[["claim_status_label", "n_events", "q_value"]],
+                hovertemplate=(
+                    "%{x}<br>"
+                    "Benchmark difference: %{y:.3f}%<br>"
+                    "Rows: %{customdata[1]}<br>"
+                    "%{customdata[0]}<br>"
+                    "q-value: %{customdata[2]}<extra></extra>"
+                ),
             )
         )
     fig.add_hline(y=0, line_width=1, line_color="#555")
     fig.update_layout(
-        title="Exploratory abnormal return summaries",
-        yaxis_title="Equal-weight signed abnormal return (%)",
-        xaxis_title="Window",
+        title="Exploratory market check: disclosed transactions vs benchmark",
+        yaxis_title="Benchmark difference (%)",
+        xaxis_title="Market window after date",
         barmode="group",
-        margin=dict(l=40, r=20, t=60, b=50),
-        legend_title_text="Date basis",
+        margin=dict(l=64, r=20, t=70, b=62),
+        legend_title_text="Measured from",
     )
     return style_figure(fig)
 
@@ -136,13 +261,13 @@ def filing_delay_chart():
     frame = TRADES.dropna(subset=["filing_lag_days_num"]).copy()
     frame = frame[(frame["filing_lag_days_num"] >= 0) & (frame["filing_lag_days_num"] <= 800)]
     bins = [-1, 30, 45, 90, 180, 365, 800]
-    labels = ["0-30", "31-45", "46-90", "91-180", "181-365", "366+"]
+    labels = ["0-30 days", "31-45 days", "46-90 days", "91-180 days", "181-365 days", "366+ days"]
     frame["lag_bucket"] = pd.cut(frame["filing_lag_days_num"], bins=bins, labels=labels)
     counts = frame["lag_bucket"].value_counts().reindex(labels).reset_index()
     counts.columns = ["lag_bucket", "rows"]
     fig = px.bar(counts, x="lag_bucket", y="rows", color="lag_bucket", color_discrete_sequence=px.colors.qualitative.Safe)
     fig.update_layout(
-        title="Disclosure filing lag buckets",
+        title="How long after a transaction was it filed?",
         xaxis_title="Days between transaction and filing",
         yaxis_title="Disclosed trade rows",
         showlegend=False,
@@ -158,7 +283,7 @@ def trade_type_chart():
     yearly = yearly[(yearly["transaction_year"] >= 2012) & (yearly["transaction_year"] <= 2026)]
     fig = px.area(yearly, x="transaction_year", y="rows", color="kind", color_discrete_sequence=px.colors.qualitative.Safe)
     fig.update_layout(
-        title="Disclosed trades by year and type",
+        title="Disclosed transaction rows by year and type",
         xaxis_title="Transaction year",
         yaxis_title="Rows",
         margin=dict(l=40, r=20, t=60, b=50),
@@ -172,7 +297,7 @@ def top_ticker_chart():
     counts.columns = ["ticker", "rows"]
     fig = px.bar(counts, x="rows", y="ticker", orientation="h", color="rows", color_continuous_scale="Viridis")
     fig.update_layout(
-        title="Most common ticker candidates in disclosures",
+        title="Ticker candidates that appear most often",
         xaxis_title="Rows",
         yaxis_title="Ticker candidate",
         margin=dict(l=80, r=20, t=60, b=50),
@@ -224,9 +349,9 @@ def wealth_chart(senator_id: str):
         )
     )
     fig.update_layout(
-        title=f"Wealth interval timeline: {senator_id}",
+        title=f"Reported wealth range over time: {senator_id}",
         xaxis_title="Report year",
-        yaxis_title="Net-worth interval dollars",
+        yaxis_title="Estimated range from disclosure brackets ($)",
         margin=dict(l=70, r=20, t=60, b=50),
     )
     return style_figure(fig)
@@ -243,7 +368,17 @@ def wealth_table(senator_id: str) -> pd.DataFrame:
         "calculation_note",
     ]
     frame = WEALTH[WEALTH["senator_id"] == senator_id][cols].sort_values("report_year")
-    return frame
+    return frame.rename(
+        columns={
+            "report_year": "Report year",
+            "net_worth_min": "Low estimate",
+            "net_worth_midpoint": "Midpoint estimate",
+            "net_worth_max": "High estimate",
+            "uncertainty_width": "Range width",
+            "top_coded": "Open-ended top bracket",
+            "calculation_note": "How to read it",
+        }
+    )
 
 
 def trade_search(query: str, min_lag: int, max_rows: int) -> pd.DataFrame:
@@ -269,7 +404,62 @@ def trade_search(query: str, min_lag: int, max_rows: int) -> pd.DataFrame:
         "amount_max",
         "what_this_does_not_prove",
     ]
-    return frame[cols].head(int(max_rows))
+    return frame[cols].head(int(max_rows)).rename(
+        columns={
+            "senator_id": "Senator/Filer ID",
+            "transaction_date": "Reported transaction date",
+            "filing_date": "Public filing date",
+            "filing_lag_days": "Filing lag days",
+            "transaction_type": "Disclosure transaction type",
+            "owner": "Reported owner",
+            "asset_name": "Asset name from filing",
+            "ticker_candidate": "Ticker candidate",
+            "amount_min": "Amount low",
+            "amount_max": "Amount high",
+            "what_this_does_not_prove": "What this row does not prove",
+        }
+    )
+
+
+def return_handoff_display() -> pd.DataFrame:
+    frame = RETURN_HANDOFF.copy()
+    if "date_basis" in frame:
+        frame["date_basis"] = frame["date_basis"].map(basis_label)
+    if "window" in frame:
+        frame["window"] = frame["window"].map(window_label)
+    if "claim_status" in frame:
+        frame["claim_status"] = frame["claim_status"].map(claim_label)
+    cols = [
+        "date_basis",
+        "window",
+        "events",
+        "senators",
+        "tickers",
+        "equal_weight_alpha_pct",
+        "midpoint_weight_alpha_pct",
+        "bootstrap_ci_low_pct",
+        "bootstrap_ci_high_pct",
+        "q_value",
+        "claim_status",
+        "plain_english_status",
+    ]
+    frame = frame[[col for col in cols if col in frame.columns]]
+    return frame.rename(
+        columns={
+            "date_basis": "Measured from",
+            "window": "Window",
+            "events": "Transaction-event rows",
+            "senators": "Senators/filer IDs",
+            "tickers": "Ticker candidates",
+            "equal_weight_alpha_pct": "Equal-weight benchmark difference (%)",
+            "midpoint_weight_alpha_pct": "Midpoint-weight benchmark difference (%)",
+            "bootstrap_ci_low_pct": "Bootstrap low (%)",
+            "bootstrap_ci_high_pct": "Bootstrap high (%)",
+            "q_value": "FDR-adjusted q-value",
+            "claim_status": "Claim status",
+            "plain_english_status": "Plain English status",
+        }
+    )
 
 
 def source_gap_table() -> pd.DataFrame:
@@ -300,6 +490,23 @@ CSS = """
   --soft: #f8fafc;
   --font: Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
 }
+html,
+body,
+#root,
+.gradio-container,
+.gradio-container .main,
+.gradio-container .wrap,
+.gradio-container .contain {
+  background: #f6f8fb !important;
+  color: var(--ink) !important;
+}
+.dark .gradio-container,
+.dark .gradio-container .main,
+.dark .gradio-container .wrap,
+.dark .gradio-container .contain {
+  background: #f6f8fb !important;
+  color: var(--ink) !important;
+}
 .gradio-container,
 .gradio-container * {
   font-family: var(--font) !important;
@@ -314,6 +521,7 @@ CSS = """
   color: var(--ink);
   font-size: 16px;
   line-height: 1.48;
+  padding: 0 18px 28px;
 }
 .gradio-container h1,
 .gradio-container .prose h1,
@@ -343,11 +551,24 @@ CSS = """
   color: var(--accent) !important;
   font-weight: 800 !important;
 }
+.gradio-container button[role="tab"] {
+  min-height: 42px !important;
+}
 .gradio-container input,
 .gradio-container textarea,
 .gradio-container select {
   color: #111827 !important;
   font-size: 1rem !important;
+  background: #ffffff !important;
+}
+.gradio-container .block,
+.gradio-container .form,
+.gradio-container .panel,
+.gradio-container .plot-container,
+.gradio-container .table-wrap,
+.gradio-container .dataframe {
+  background: #ffffff !important;
+  color: #111827 !important;
 }
 .metrics { display: grid; grid-template-columns: repeat(6, minmax(0, 1fr)); gap: 12px; margin: 14px 0 18px; }
 .metric { border: 1px solid var(--line); border-radius: 8px; padding: 13px 14px; background: #ffffff; }
@@ -384,53 +605,64 @@ CSS = """
 .gradio-container .table-wrap {
   border-color: var(--line) !important;
 }
-@media (max-width: 900px) { .metrics { grid-template-columns: repeat(2, minmax(0, 1fr)); } }
+@media (max-width: 900px) {
+  .metrics, .plain-cards { grid-template-columns: repeat(2, minmax(0, 1fr)) !important; }
+  .hero-panel h1 { font-size: 1.8rem !important; }
+}
+@media (max-width: 620px) {
+  .metrics, .plain-cards { grid-template-columns: 1fr !important; }
+}
 """
 
 
-with gr.Blocks(title="Senator Wealth And Trading Dataset") as demo:
-    gr.Markdown("# Senator Wealth And Trading Dataset")
+with gr.Blocks(title="Senator Financial Disclosure Explorer") as demo:
+    gr.HTML(hero_html())
+    gr.HTML(plain_english_cards_html())
     gr.HTML(metric_html())
     gr.HTML(boundary_html())
 
     with gr.Tabs():
-        with gr.Tab("Overview"):
+        with gr.Tab("Start Here"):
+            gr.HTML(overview_intro_html())
             with gr.Row():
-                gr.Plot(value=return_chart(), label="Exploratory returns")
-            with gr.Row():
-                gr.Plot(value=filing_delay_chart(), label="Filing delay")
-                gr.Plot(value=top_ticker_chart(), label="Ticker candidates")
-            gr.Markdown(
-                "The data is useful as public disclosure evidence and exploratory market context. The public alpha claim is blocked because this no-pay bundle does not use a licensed security-level total-return feed with delisting handling."
+                gr.Plot(value=filing_delay_chart(), label="Filing delay: how late were public reports?")
+                gr.Plot(value=top_ticker_chart(), label="Ticker candidates: what appears in filings?")
+            gr.HTML(
+                "<div class='section-intro' style='background:#ffffff;border:1px solid #cbd5e1;border-radius:10px;padding:15px 16px;margin:12px 0;color:#334155;font-size:1rem;line-height:1.55;'>"
+                "<strong style='color:#0f172a;'>Where to go next:</strong> use <strong>Wealth Ranges</strong> to inspect bracket-based wealth estimates, "
+                "<strong>Disclosed Transactions</strong> to search filings, <strong>Market Checks</strong> for cautious benchmark context, and <strong>Receipts</strong> for the audit trail."
+                "</div>"
             )
 
-        with gr.Tab("Wealth Intervals"):
+        with gr.Tab("Wealth Ranges"):
             choices = wealth_senators()
-            selector = gr.Dropdown(choices=choices, value=choices[0] if choices else None, label="Senator/filer id")
-            wealth_plot = gr.Plot(value=wealth_chart(choices[0]) if choices else go.Figure(), label="Wealth interval")
-            wealth_rows = gr.Dataframe(value=wealth_table(choices[0]) if choices else pd.DataFrame(), label="Interval rows", interactive=False, wrap=True)
+            gr.HTML("<div class='section-intro' style='background:#ffffff;border:1px solid #cbd5e1;border-radius:10px;padding:15px 16px;margin:8px 0 14px;color:#334155;font-size:1rem;line-height:1.55;'><strong style='color:#0f172a;'>Read this as a range, not a precise fortune.</strong> Senate forms use value brackets, so the ribbon shows low-to-high estimates from reported assets and liabilities.</div>")
+            selector = gr.Dropdown(choices=choices, value=choices[0] if choices else None, label="Choose a senator/filer ID")
+            wealth_plot = gr.Plot(value=wealth_chart(choices[0]) if choices else style_figure(go.Figure()), label="Reported wealth range")
+            wealth_rows = gr.Dataframe(value=wealth_table(choices[0]) if choices else pd.DataFrame(), label="Range rows from disclosure brackets", interactive=False, wrap=True)
             selector.change(wealth_chart, inputs=selector, outputs=wealth_plot)
             selector.change(wealth_table, inputs=selector, outputs=wealth_rows)
 
-        with gr.Tab("Disclosed Trades"):
+        with gr.Tab("Disclosed Transactions"):
+            gr.HTML("<div class='section-intro' style='background:#ffffff;border:1px solid #cbd5e1;border-radius:10px;padding:15px 16px;margin:8px 0 14px;color:#334155;font-size:1rem;line-height:1.55;'><strong style='color:#0f172a;'>These are disclosed transaction rows.</strong> A row can be a purchase, sale, exchange, or another reported transaction type. The table does not know execution price, exact trade size, or private realized return.</div>")
             with gr.Row():
-                search_box = gr.Textbox(label="Search asset, ticker, or filer id", value="")
+                search_box = gr.Textbox(label="Search asset, ticker, or filer ID", value="")
                 min_lag = gr.Slider(0, 400, value=0, step=5, label="Minimum filing lag days")
                 max_rows = gr.Slider(10, 250, value=50, step=10, label="Rows")
-            trade_rows = gr.Dataframe(value=trade_search("", 0, 50), label="Trade rows", interactive=False, wrap=True)
+            trade_rows = gr.Dataframe(value=trade_search("", 0, 50), label="Disclosed transaction rows", interactive=False, wrap=True)
             search_box.change(trade_search, inputs=[search_box, min_lag, max_rows], outputs=trade_rows)
             min_lag.change(trade_search, inputs=[search_box, min_lag, max_rows], outputs=trade_rows)
             max_rows.change(trade_search, inputs=[search_box, min_lag, max_rows], outputs=trade_rows)
-            gr.Plot(value=trade_type_chart(), label="Trade type by year")
+            gr.Plot(value=trade_type_chart(), label="Transaction type by year")
 
-        with gr.Tab("Return Tests"):
-            gr.Plot(value=return_chart(), label="Exploratory return-test chart")
-            gr.Dataframe(value=RETURN_HANDOFF, label="Plain-language return-test summaries", interactive=False, wrap=True)
-            gr.Markdown(
-                "Rows are blocked from public alpha claims. A positive cell is not proof of intent, illegality, causality, or realized private return."
-            )
+        with gr.Tab("Market Checks"):
+            gr.HTML(market_note_html())
+            gr.Plot(value=return_chart(), label="Exploratory market-context chart")
+            gr.Dataframe(value=return_handoff_display(), label="Plain-English market-check rows", interactive=False, wrap=True)
+            gr.HTML("<div class='boundary' style='border-left:5px solid #8a4b00;background:#fff7e8;color:#3f2a00;padding:14px 16px;border-radius:8px;margin:12px 0 20px;font-size:1rem;line-height:1.55;'><strong style='color:#2f1d00;'>Bottom line:</strong> these rows are blocked from public alpha claims. A positive cell is not proof of intent, illegality, causality, insider trading, or realized private return.</div>")
 
-        with gr.Tab("Receipts And Downloads"):
+        with gr.Tab("Receipts"):
+            gr.HTML("<div class='section-intro' style='background:#ffffff;border:1px solid #cbd5e1;border-radius:10px;padding:15px 16px;margin:8px 0 14px;color:#334155;font-size:1rem;line-height:1.55;'><strong style='color:#0f172a;'>Receipts are the audit trail.</strong> The files below show what was included, what was intentionally omitted, and where source or market-data gaps remain.</div>")
             gr.Dataframe(value=source_gap_table(), label="Source-gap report", interactive=False, wrap=True)
             gr.Dataframe(value=file_inventory(), label="Bundle inventory", interactive=False, wrap=True)
             gr.File(

space_bundle_manifest.json

@@ -8,8 +8,8 @@
   "files": [
     {
       "path": "app.py",
-      "sha256": "95b3e4f476a8708cbf5892ab0b788b176224373631492978b9bf9f72a5adac20",
-      "byte_count": 17143
+      "sha256": "8c303e8e6ee0e11d29512e99f663d5454048db85bbe7a016182df47db4756f24",
+      "byte_count": 30041
     },
     {
       "path": "data/audit/claim_boundary.json",
@@ -98,8 +98,8 @@
     },
     {
       "path": "README.md",
-      "sha256": "9fb415862b6c5f0372606d363866e329b4b69aa5f7a4632e4a05461417be0e10",
-      "byte_count": 535
+      "sha256": "e52e46bb2b6cc3dd1c334a0ce3465e5aa0d8c97329a4e0107afccad082f32156",
+      "byte_count": 544
     },
     {
       "path": "requirements.txt",
@@ -107,5 +107,5 @@
       "byte_count": 47
     }
   ],
-  "manifest_hash": "0b3c002cb32fe8dfd5f891d084ad18701d28ebb250e71b4f5606f85ce2172660"
+  "manifest_hash": "a0663b17e37274c65850f2c9e89b588acb6dac6dc3d88e7f74c2407c4408893c"
 }