Force-sync public_space_app.py from local private bundle

public_space_app.py

@@ -210,6 +210,35 @@ def _how_to_use_markdown() -> str:
     )
 
 
+def _fictional_example_markdown() -> str:
+    return "\n".join(
+        [
+            "## Fictional example",
+            "",
+            "Imagine a **fictional** House member named `Alex Rivera`.",
+            "",
+            "A reporter notices that Alex Rivera disclosed trades in several solar and grid-equipment companies.",
+            "The reporter wonders whether public legislative activity in the same time window also clusters around energy issues.",
+            "",
+            "This tool could help the reporter do four things quickly:",
+            "",
+            "1. Search `Alex Rivera` in **Overview** and see whether `energy` rises to the top of the ranked list.",
+            "2. Open one energy relationship in **Relationship to explain** and see the plain-English reasons it appears.",
+            "3. Check the coarse evidence window to see whether disclosure records and legislative records show up in the same published window.",
+            "4. Open the source URLs and SHA-backed artifacts to verify the underlying records directly.",
+            "",
+            "What this example would **not** mean:",
+            "",
+            "- It would not prove corruption.",
+            "- It would not prove intent.",
+            "- It would not prove causality.",
+            "- It would mean there is enough public-record overlap to justify closer reporting or investigation.",
+            "",
+            "In other words: the tool helps someone move from a vague hunch to a concrete set of records worth checking.",
+        ]
+    )
+
+
 def _plain_status_label(value: str) -> str:
     normalized = str(value or "").strip()
     mapping = {
@@ -937,6 +966,7 @@ def build_app(copy_path: str | Path):
         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"):