Update app.py

app.py

@@ -1,7 +1,7 @@
 """
 app.py — Topic Modelling Agentic AI | Gradio UI
 ═══════════════════════════════════════════════════
-Version:  3.0.0 | April 2026
+Version:  3.1.0 | April 2026
 Stack:    Gradio 5.x + LangGraph + Mistral + BERTopic
 Deploy:   HuggingFace Spaces (sdk: gradio)
 Rules:    Zero gr.HTML(). All UI via native Gradio components.
@@ -39,23 +39,6 @@ from agent import SYSTEM_PROMPT, get_local_tools
 print(">>> app.py: imports complete")
 
 
-# ╔═══════════════════════════════════════════════════════════════╗
-# ║  SECTION 1 — SETUP                                          ║
-# ║  One-time initialization: agent creation and visual theme.   ║
-# ║  Nothing here renders UI — it prepares the backend brain     ║
-# ║  and the visual identity for the entire application.         ║
-# ╚═══════════════════════════════════════════════════════════════╝
-
-
-# ── B2: Agent setup ─────────────────────────────────────────────
-# PURPOSE:  Create the LangGraph ReAct agent that powers all chat.
-#           Connects Mistral LLM to BERTopic tools with memory so
-#           the agent remembers context across conversation turns.
-# PRODUCES: `agent` — used by B6 (respond) and B10 (_submit_review)
-# IMPORTS:  SYSTEM_PROMPT, get_local_tools from agent.py
-# NOTE:     MemorySaver keeps conversation in RAM (resets on restart).
-#           For persistent memory, swap to SQLite checkpointer.
-# ────────────────────────────────────────────────────────────────
 llm = ChatMistralAI(model="mistral-small-latest", temperature=0, timeout=300)
 tools = get_local_tools()
 agent = create_react_agent(
@@ -70,43 +53,28 @@ _uploaded = {"path": ""}          # Last uploaded CSV path (shared session)
 
 # ── B3: Theme ───────────────────────────────────────────────────
 # PURPOSE:  Define the visual identity of the entire application.
-#           Replaces ALL custom CSS that was previously in HEADER_HTML:
-#           - DM Sans font (was @import url in <style> block)
-#           - Slate color palette (was hardcoded hex in inline styles)
-#           - Soft rounded corners and spacing
-# USED BY:  B20 (demo.launch) — Gradio 6 moved theme from gr.Blocks
-#           to launch(). The theme object is created here but applied
-#           in B20 via demo.launch(theme=theme).
-# REPLACES: Old HEADER_HTML lines 33-38 (<style> block with CSS)
+#           Uses teal/indigo on zinc — purposeful scientific feel.
+#           Plus Jakarta Sans: geometric-humanist, modern but not generic.
+#           Fira Code for monospace elements (phase progress, etc).
+# USED BY:  B20 (demo.launch) — theme applied at launch time.
 # ────────────────────────────────────────────────────────────────
-theme = gr.themes.Soft(
-    primary_hue="slate",
-    font=gr.themes.GoogleFont("DM Sans"),
-    font_mono=gr.themes.GoogleFont("JetBrains Mono"),
+theme = gr.themes.Default(
+    primary_hue="teal",
+    secondary_hue="indigo",
+    neutral_hue="zinc",
+    font=gr.themes.GoogleFont("Plus Jakarta Sans"),
+    font_mono=gr.themes.GoogleFont("Fira Code"),
+    radius_size="sm",
+    spacing_size="md",
+).set(
+    button_primary_background_fill="*primary_600",
+    button_primary_background_fill_hover="*primary_500",
+    button_primary_text_color="white",
+    block_label_text_size="sm",
+    block_title_text_weight="600",
 )
 # ── end B3: Theme ──────────────────────────────────────────────
 
-
-# ╔═══════════════════════════════════════════════════════════════╗
-# ║  SECTION 2 — HELPER FUNCTIONS                               ║
-# ║  Pure Python functions that process data and return clean    ║
-# ║  values (strings, lists, figures). NONE of these functions   ║
-# ║  return HTML strings. They feed data to UI components in     ║
-# ║  Section 3 via event handlers in Section 4.                  ║
-# ╚═══════════════════════════════════════════════════════════════╝
-
-
-# ── B4: _latest_output() ───────────────────────────────────────
-# PURPOSE:  Scan /tmp for all rq4_* output files generated by the
-#           BERTopic agent pipeline (CSVs, JSONs, chart files).
-#           Sorts them by pipeline phase order so the download
-#           component shows files in logical sequence.
-# RETURNS:  List[str] of filepaths sorted by phase, or None
-# USED BY:  B6 (respond) — attaches to download component after
-#             each agent response
-#           B10 (_submit_review) — refreshes downloads after review
-#           B19 (_auto_load_csv) — refreshes after initial upload
-# ────────────────────────────────────────────────────────────────
 def _latest_output():
     """Scan /tmp for ALL rq4_* files, sorted by phase order.
     Returns list of filepaths for gr.File download component."""
@@ -128,20 +96,6 @@ def _latest_output():
     return list(map(lambda x: x[1], scored)) or None
 # ── end B4: _latest_output ─────────────────────────────────────
 
-
-# ── B5: _build_progress() ──────────────────────────────────────
-# PURPOSE:  Check which Braun & Clarke phases are complete by
-#           scanning for checkpoint files on disk. Returns a
-#           human-readable emoji string showing pipeline status.
-# RETURNS:  str like "✅ Load → ✅ Codes → ⏳ Themes → ⬜ Report"
-# USED BY:  B14 (phase_progress initial value)
-#           B18 (respond_with_viz) — refreshes after each agent turn
-#           B10 (_submit_review) — refreshes after review submission
-#           B19 (_auto_load_csv) — refreshes after CSV upload
-# REPLACES: Old _build_progress() which returned 24 lines of HTML
-#           with inline-styled <span> elements and color codes.
-#           Now returns pure text with emoji — gr.Markdown renders it.
-# ────────────────────────────────────────────────────────────────
 def _build_progress():
     """Return emoji progress pipeline. NO HTML — just text + emoji.
     Displayed in gr.Markdown component (B14)."""
@@ -160,27 +114,6 @@ def _build_progress():
 # ── end B5: _build_progress ────────────────────────────────────
 
 
-# ── B6: respond() ──────────────────────────────────────────────
-# PURPOSE:  Core chat handler. This is the brain of the app.
-#           1. Stores uploaded CSV file path (if new upload)
-#           2. Appends file location + phase context to user message
-#              so the agent knows what data is available
-#           3. Yields a "thinking..." bubble immediately (user sees
-#              instant feedback while agent processes)
-#           4. Invokes the LangGraph agent (Mistral decides which
-#              BERTopic tools to call)
-#           5. Replaces thinking bubble with actual agent response
-#           6. Attaches latest output files to download component
-# INPUTS:   message (str), chat_history (list[dict]), uploaded_file (str|None)
-# YIELDS:   Tuple of (chat_history, empty_string, download_files)
-#           — yields TWICE: first with progress bubble, then with final response
-# TALKS TO: B2 (agent.invoke) — sends message, gets response
-#           B4 (_latest_output) — gets download file list
-# USED BY:  B18 (respond_with_viz wraps this)
-#           B19 (_auto_load_csv wraps this)
-# NOTE:     Uses single thread_id="session" so agent remembers
-#           previous turns (loaded CSV path, current phase, etc.)
-# ────────────────────────────────────────────────────────────────
 def respond(message, chat_history, uploaded_file):
     """Handle one chat turn with the LangGraph agent.
     Yields twice: progress bubble → final response."""
@@ -229,20 +162,6 @@ def respond(message, chat_history, uploaded_file):
 # ── end B6: respond ────────────────────────────────────────────
 
 
-# ── B7: _load_chart() ──────────────────────────────────────────
-# PURPOSE:  Load a BERTopic visualization chart from a saved Plotly
-#           JSON file on disk and return the figure object.
-#           The gr.Plot component in B17a renders this directly —
-#           no iframe, no HTML escaping, no srcdoc hack.
-# INPUT:    chart_name (str) — filename like "rq4_intertopic.json"
-# RETURNS:  plotly.graph_objects.Figure or None
-# USED BY:  B17a (chart_selector.change event)
-#           B18 (respond_with_viz) — auto-shows latest chart
-# REPLACES: Old _load_chart() which used html.escape() + iframe
-#           srcdoc to embed HTML files. That was 8 lines of hack.
-# REQUIRES: BERTopic tools in tools.py must save charts as Plotly
-#           JSON via pio.to_json(fig) instead of fig.write_html().
-# ────────────────────────────────────────────────────────────────
 def _load_chart(chart_name):
     """Load Plotly chart from JSON file. Returns figure for gr.Plot.
     No HTML, no iframe — just a native Plotly figure object."""
@@ -257,22 +176,6 @@ def _get_chart_choices():
 # ── end B7: _load_chart ───────────────────────────────────────
 
 
-# ── B8: _load_review_table() ───────────────────────────────────
-# PURPOSE:  Load the latest BERTopic phase data (taxonomy, themes,
-#           labels, or summaries — whichever is most recent) and
-#           build a review table for the researcher to approve,
-#           rename, or annotate topics.
-# RETURNS:  List[List] with 8 columns matching the Dataframe schema:
-#           [#, Label, Evidence, Sentences, Papers, Approve, Rename, Reasoning]
-#           - Column 5 (Approve) is bool (True/False) → renders as checkbox
-#           - Columns 0-4 are read-only (enforced by static_columns in B16)
-#           - Columns 5-7 are editable by the researcher
-# USED BY:  B16 (initial table value)
-#           B10 (_submit_review) — reloads after agent processes review
-#           B18 (respond_with_viz) — refreshes after each agent turn
-# REPLACES: Old version which returned "yes"/"no" strings for Approve.
-#           Now returns True/False so gr.Dataframe renders checkboxes.
-# ────────────────────────────────────────────────────────────────
 def _load_review_table():
     """Build review table from latest checkpoint JSON.
     Approve column is bool (renders as checkbox in gr.Dataframe).
@@ -326,19 +229,6 @@ def _load_review_table():
 # ── end B8: _load_review_table ─────────────────────────────────
 
 
-# ── B9: _show_papers_by_select() ───────────────────────────────
-# PURPOSE:  When the researcher clicks any row in the review table,
-#           this function fires and shows the papers belonging to
-#           that topic. Eliminates the old workflow of typing a
-#           Topic # into a separate input and clicking "Show Papers".
-# INPUT:    gr.SelectData event — contains .index (row, col) and .value
-# RETURNS:  str — formatted paper list for gr.Textbox (paper_list)
-# TRIGGERED BY: review_table.select() event in B16
-# REPLACES: Old _show_papers(topic_id) + topic_num (gr.Number) +
-#           view_papers_btn (gr.Button) — all three components removed.
-# NOTE:     Uses column 0 value (the # column) as topic_id, NOT the
-#           row index, because filtering/sorting may reorder rows.
-# ────────────────────────────────────────────────────────────────
 def _show_papers_by_select(table_data, evt: gr.SelectData):
     """Show papers for clicked row. Uses column 0 as topic_id.
     Triggered by review_table.select() — no separate Topic # input needed."""
@@ -378,22 +268,6 @@ def _show_papers_by_select(table_data, evt: gr.SelectData):
 # ── end B9: _show_papers_by_select ─────────────────────────────
 
 
-# ── B10: _submit_review() ──────────────────────────────────────
-# PURPOSE:  When the researcher finishes editing the review table
-#           (checking Approve boxes, typing Rename values, adding
-#           Reasoning notes) and clicks "Submit Review", this
-#           function converts those edits into a natural language
-#           message and sends it to the agent for processing.
-# INPUTS:   table_data (DataFrame from gr.Dataframe), chat_history (list)
-# YIELDS:   Tuple of (chat, download, chart_choices, chart_fig,
-#           review_rows, progress_str) — yields twice (progress → final)
-# TALKS TO: B2 (agent.invoke) — sends review decisions
-#           B4 (_latest_output) — refreshes downloads
-#           B5 (_build_progress) — refreshes pipeline status
-#           B7 (_get_chart_choices) — refreshes chart dropdown
-#           B8 (_load_review_table) — reloads table with updated data
-# NOTE:     Column 5 (Approve) is now bool. True = approve, False = reject.
-# ────────────────────────────────────────────────────────────────
 def _submit_review(table_data, chat_history):
     """Convert review table edits into agent message.
     Approve column is bool (checkbox), not string."""
@@ -438,43 +312,64 @@ def _submit_review(table_data, chat_history):
         gr.update(value=_load_review_table()),
         _build_progress(),
     )
-# ── end B10: _submit_review ────────────────────────────────────
-
 
-# ╔═══════════════════════════════════════════════════════════════╗
-# ║  SECTION 3 — UI LAYOUT                                      ║
-# ║  All visual components defined here using ONLY native Gradio ║
-# ║  widgets. Zero gr.HTML() calls. Theming via B3.              ║
-# ║  Layout: Header → Upload → Progress → Chat → Results tabs   ║
-# ╚═══════════════════════════════════════════════════════════════╝
 
 print(">>> Building UI...")
 
 
-# ── B11: gr.Blocks container ───────────────────────────────────
-# PURPOSE:  Root container for the entire application UI.
-#           Enables full browser width via fill_width.
-# CONTAINS: All UI blocks B12 through B17b
-# CONFIG:   title — browser tab title (stays on Blocks in Gradio 6)
-#           fill_width — removes side padding, uses full browser width
-# NOTE:     In Gradio 6.0, theme/css/footer_links moved from
-#           gr.Blocks() to demo.launch(). See B20 for those params.
-# ────────────────────────────────────────────────────────────────
 with gr.Blocks(
     title="Topic Modelling — Agentic AI",
     fill_width=True,
+    css="""
+        /* Accent bar at very top of page */
+        .gradio-container::before {
+            content: "";
+            display: block;
+            height: 3px;
+            background: linear-gradient(90deg, #0d9488, #6366f1);
+            margin-bottom: 4px;
+        }
+        /* Tabs: tighter padding, bolder active state */
+        .tab-nav button {
+            font-size: 13px !important;
+            font-weight: 500 !important;
+            letter-spacing: 0.01em;
+            padding: 6px 16px !important;
+        }
+        .tab-nav button.selected {
+            font-weight: 700 !important;
+            border-bottom: 2px solid #0d9488 !important;
+        }
+        /* Dataframe: subtle zebra rows */
+        .table-wrap tr:nth-child(even) td {
+            background-color: rgba(13, 148, 136, 0.04);
+        }
+        /* Chat: teal left-border on assistant bubbles */
+        .message.bot {
+            border-left: 3px solid #0d9488 !important;
+        }
+        /* Phase progress: monospace, slightly muted */
+        .phase-bar p {
+            font-family: "Fira Code", monospace;
+            font-size: 12px;
+            letter-spacing: 0.03em;
+            opacity: 0.80;
+        }
+        /* Upload area: cleaner dashed border */
+        .upload-container {
+            border-style: dashed !important;
+            border-width: 1px !important;
+        }
+    """,
 ) as demo:
 
 
     # ── B12: Header ────────────────────────────────────────────
-    # PURPOSE:  Application title and subtitle. Single gr.Markdown
-    #           call replaces 15 lines of HEADER_HTML that included
-    #           a gradient background div, font imports, and inline CSS.
-    # REPLACES: Old HEADER_HTML constant (lines 32-47 of old app.py)
+    # PURPOSE:  Application title and subtitle.
     # ───────────────────────────────────────────────────────────
     gr.Markdown(
-        "# 🔬 Topic Modelling — Agentic AI\n"
-        "*Mistral · Cosine Clustering · 384d · B&C Thematic Analysis*"
+        "# 🔬 Topic Modelling · Agentic AI\n"
+        "<sub>Mistral · Cosine Clustering · 384d Embeddings · Braun & Clarke Thematic Analysis</sub>"
     )
     # ── end B12: Header ────────────────────────────────────────
 
@@ -486,49 +381,53 @@ with gr.Blocks(
     # COMPONENTS: gr.File (upload) + gr.Markdown (instructions)
     # EVENTS:  upload.change → B19 (_auto_load_csv)
     # ────────────────────���──────────────────────────────────────
-    gr.Markdown("**① Data input**")
+    gr.Markdown("**① Upload**")
     with gr.Row():
-        upload = gr.File(label="📂 Upload Scopus CSV", file_types=[".csv"])
-        gr.Markdown("**Upload your CSV** then type `run abstract only` in chat below")
+        upload = gr.File(label="📂 Scopus CSV", file_types=[".csv"])
+        gr.Markdown(
+            "Upload your Scopus CSV export, then type `run abstract only` in the chat below "
+            "to begin the analysis pipeline."
+        )
     # ── end B13: Data input ────────────────────────────────────
 
 
     # ── B14: Progress pipeline ─────────────────────────────────
     # PURPOSE:  Visual indicator of which Braun & Clarke analysis
     #           phases are complete. Updated after every agent action.
-    #           Now uses gr.Markdown with emoji text (was gr.HTML
-    #           with inline-styled colored <span> elements).
+    #           elem_classes="phase-bar" targets the monospace CSS rule in B11.
     # COMPONENT: gr.Markdown — displays emoji string from B5
     # UPDATED BY: B18 (after chat), B10 (after review), B19 (after upload)
-    # REPLACES: Old gr.HTML(value=_build_progress()) with 24 lines of HTML
     # ───────────────────────────────────────────────────────────
-    phase_progress = gr.Markdown(value=_build_progress())
+    phase_progress = gr.Markdown(value=_build_progress(), elem_classes=["phase-bar"])
     # ── end B14: Progress pipeline ─────────────────────────────
 
 
     # ── B15: Chatbot + input ───────────────────────────────────
     # PURPOSE:  Main conversation interface between researcher and
-    #           the LangGraph agent. The chatbot displays message
-    #           history with markdown rendering. The textbox + button
-    #           below it capture user input.
+    #           the LangGraph agent.
     # COMPONENTS: gr.Chatbot (display), gr.Textbox (input), gr.Button (send)
     # EVENTS:  msg.submit → B18, send.click → B18
-    # NOTE:    placeholder text guides the researcher on available commands.
-    #          height=300 keeps chat visible while showing results below.
     # ───────────────────────────────────────────────────────────
-    gr.Markdown("**② Agent conversation** — follow the prompts below")
+    gr.Markdown("**② Conversation** — follow the guided workflow")
     with gr.Group():
         chatbot = gr.Chatbot(
-            height=300,
+            height=320,
             show_label=False,
-            placeholder="Upload your Scopus CSV above, then type: run abstract only",
+            avatar_images=(
+                None,
+                "https://api.dicebear.com/7.x/bottts-neutral/svg?seed=bertopic",
+            ),
+            placeholder=(
+                "**Ready.** Upload a Scopus CSV above, then type:\n\n"
+                "`run abstract only` · `approve all` · `show topic 4 papers` · `done`"
+            ),
         )
         with gr.Row():
             msg = gr.Textbox(
                 placeholder="run · approve · show topic 4 papers · group 0 1 5 · done",
                 show_label=False, scale=9, lines=1, max_lines=1, container=False,
             )
-            send = gr.Button("Send", variant="primary", scale=1, min_width=70)
+            send = gr.Button("⏎ Send", variant="primary", scale=1, min_width=80)
     # ── end B15: Chatbot + input ───────────────────────────────
 
 
@@ -538,32 +437,21 @@ with gr.Blocks(
     #           topics. This is the core human-in-the-loop interface.
     #
     # KEY FEATURES (all native Gradio, no HTML):
-    #   - static_columns=[0,1,2,3,4] — first 5 columns (#, Label,
-    #     Evidence, Sentences, Papers) are READ-ONLY. Prevents
-    #     accidental edits to agent-generated data.
-    #   - datatype "bool" on column 5 — Approve renders as a native
-    #     CHECKBOX. Researcher clicks to toggle, no typing needed.
-    #   - pinned_columns=2 — # and Label columns stay visible when
-    #     scrolling horizontally through wider columns.
-    #   - show_search="filter" — built-in column filtering. Researcher
-    #     can filter by paper count, sentence count, etc.
-    #   - .select() event — clicking any row auto-loads that topic's
-    #     papers in the textbox below. REPLACES the old workflow of
-    #     Topic # input + Show Papers button (both removed).
+    #   - static_columns=[0,1,2,3,4] — first 5 columns read-only
+    #   - datatype "bool" on column 5 — Approve renders as checkbox
+    #   - pinned_columns=2 — # and Label stay visible when scrolling
+    #   - show_search="filter" — built-in column filtering
+    #   - .select() event — clicking any row auto-loads that topic's papers
     #
     # COMPONENTS: gr.Dataframe, gr.Button (submit), gr.Textbox (papers)
-    # EVENTS:  review_table.select → B9 (_show_papers_by_select)
-    #          submit_review.click → B10 (_submit_review)
-    # DATA:    Loaded by B8 (_load_review_table)
-    # REPLACES: Old gr.Dataframe (no static_columns, string Approve,
-    #           no search) + topic_num + view_papers_btn
+    # EVENTS:  review_table.select → B9, submit_review.click → B10
     # ───────────────────────────────────────────────────────────
-    gr.Markdown("**③ Results** — review table, charts, downloads")
+    gr.Markdown("**③ Review & Export**")
     with gr.Tabs():
-        with gr.Tab("📋 Review Table"):
+        with gr.Tab("📋 Topics"):
             gr.Markdown(
-                "*Edit Approve / Rename To / Reasoning → click Submit. "
-                "Click any row to see its papers below.*"
+                "*Toggle **Approve**, fill in **Rename To** or **Reasoning**, "
+                "then click Submit. Click any row to inspect its source papers below.*"
             )
             review_table = gr.Dataframe(
                 headers=[
@@ -587,7 +475,6 @@ with gr.Blocks(
             )
             submit_review = gr.Button("✅ Submit Review to Agent", variant="primary")
 
-            # Paper viewer — triggered by clicking any row (replaces Topic # + button)
             gr.Markdown("---")
             gr.Markdown("**📄 Papers in selected topic** *(click any row above)*")
             paper_list = gr.Textbox(
@@ -598,18 +485,14 @@ with gr.Blocks(
 
 
         # ── B17a: Charts tab ───────────────────────────────────
-        # PURPOSE:  Display BERTopic visualization charts (intertopic
-        #           distance map, bar chart, hierarchy, heatmap).
-        #           Charts are loaded as Plotly figure objects from
-        #           JSON files and rendered natively in gr.Plot.
+        # PURPOSE:  Display BERTopic visualization charts rendered
+        #           natively in gr.Plot from Plotly JSON files.
         # COMPONENTS: gr.Dropdown (selector), gr.Plot (display)
         # EVENTS:  chart_selector.change → B7 (_load_chart)
-        # REPLACES: Old iframe + srcdoc hack that used html.escape()
-        #           to embed HTML files. Now uses gr.Plot directly.
         # ───────────────────────────────────────────────────────
-        with gr.Tab("📊 Charts"):
+        with gr.Tab("📊 Visualise"):
             chart_selector = gr.Dropdown(
-                choices=[], label="Select Chart", interactive=True,
+                choices=[], label="Select chart", interactive=True,
             )
             chart_display = gr.Plot(label="BERTopic Visualization")
         # ── end B17a: Charts tab ───────────────────────────────
@@ -617,12 +500,10 @@ with gr.Blocks(
 
         # ── B17b: Download tab ─────────────────────────────────
         # PURPOSE:  Multi-file download for all pipeline outputs.
-        #           Shows file descriptions by phase and a gr.File
-        #           component with all generated files.
         # COMPONENTS: gr.Markdown (descriptions), gr.File (download)
         # UPDATED BY: B18, B10, B19 — refreshed after each action
         # ───────────────────────────────────────────────────────
-        with gr.Tab("📥 Download"):
+        with gr.Tab("⬇ Export"):
             gr.Markdown(
                 "**Files by Phase (per run: abstract / title):**\n\n"
                 "**Phase 2 — Discovery:** `summaries.json` · `emb.npy`\n\n"
@@ -637,28 +518,6 @@ with gr.Blocks(
         # ── end B17b: Download tab ─────────────────────────────
 
 
-    # ╔═══════════════════════════════════════════════════════════╗
-    # ║  SECTION 4 — EVENT WIRING                                ║
-    # ║  Connect UI components to helper functions. This is       ║
-    # ║  where data flows are defined: which function runs when   ║
-    # ║  a button is clicked, a file is uploaded, or a row is     ║
-    # ║  selected. No HTML, no CSS — just Python event binding.   ║
-    # ╚═══════════════════════════════════════════════════════════╝
-
-
-    # ── B18: respond_with_viz() + event bindings ───────────────
-    # PURPOSE:  Wrapper around B6 (respond) that also refreshes
-    #           the chart dropdown, chart display, review table,
-    #           and progress pipeline after each agent response.
-    #           This is the main "after every chat turn, update
-    #           everything" orchestrator.
-    # CALLS:   B6 (respond), B5 (_build_progress), B7 (_load_chart,
-    #          _get_chart_choices), B8 (_load_review_table)
-    # BINDINGS: msg.submit → this function
-    #           send.click → this function
-    # OUTPUTS:  chatbot, msg, download, chart_selector, chart_display,
-    #           review_table, phase_progress (7 components updated)
-    # ───────────────────────────────────────────────────────────
     chart_selector.change(_load_chart, [chart_selector], [chart_display])
 
     review_table.select(
@@ -708,9 +567,8 @@ with gr.Blocks(
 
     # ── B19: _auto_load_csv() ──────────────────────────────────
     # PURPOSE:  Automatically triggers analysis when a CSV file is
-    #           uploaded. The researcher doesn't need to type anything —
-    #           just uploading the file starts the pipeline.
-    #           Sends "Analyze my Scopus CSV" as the initial message.
+    #           uploaded. Sends "Analyze my Scopus CSV" as the
+    #           initial message so no manual typing is needed.
     # TRIGGERED BY: upload.change event
     # CALLS:   B6 (respond) with auto-message
     # OUTPUTS:  chatbot, download, chart_selector, chart_display,
@@ -746,23 +604,7 @@ with gr.Blocks(
     # ── end B19: _auto_load_csv ────────────────────────────────
 
 
-# ╔═══════════════════════════════════════════════════════════════╗
-# ║  SECTION 5 — LAUNCH                                         ║
-# ║  Start the Gradio server. On HuggingFace Spaces this runs   ║
-# ║  automatically. Locally, access at http://localhost:7860     ║
-# ╚═══════════════════════════════════════════════════════════════╝
 
-
-# ── B20: Launch ────────────────────────────────────────────────
-# PURPOSE:  Start the web server. In Gradio 6.0, theme/css/footer
-#           params moved here from gr.Blocks().
-# CONFIG:   theme — from B3 (Soft + DM Sans + slate)
-#           footer_links=[] — hides footer natively (no CSS hack)
-#           ssr_mode=False — for HuggingFace Spaces free tier compat
-#           server_name="0.0.0.0" — accessible on network
-# NOTE:     On Spaces, port 7860 is auto-exposed to the internet.
-#           Locally, open http://localhost:7860 in your browser.
-# ────────────────────────────────────────────────────────────────
 print(">>> Launching...")
 demo.launch(
     server_name="0.0.0.0",
@@ -771,4 +613,4 @@ demo.launch(
     theme=theme,                    # Gradio 6: moved from gr.Blocks()
     footer_links=[],                # Gradio 6: hides footer, replaces show_api
 )
-# ── end B20: Launch ────────────────────────────────────────────
+# ── end B20: Launch ────────────────────────────────────────────