Fix Smoke Signal OCR runtime compatibility and restore dashboard sidebar shell

README.md

@@ -5,7 +5,7 @@ colorFrom: indigo
 colorTo: pink
 sdk: gradio
 sdk_version: 6.14.0
-python_version: '3.13'
+python_version: '3.12'
 app_file: app.py
 pinned: false
 ---

app.py

@@ -1174,6 +1174,25 @@ def single_score(active_path, sequence, stanza_id, draft_pass, clarity, rhythm,
     return df, _score_summary(df)
 
 
+def initial_dashboard_html() -> str:
+    """
+    Render dashboard shell at startup so sidebar/nav are visible immediately.
+    Falls back gracefully if workbook read fails.
+    """
+    try:
+        return dashboard_html(DEFAULT_WORKBOOK, "Dashboard ready. Click Run TOTEM Analysis to refresh metrics.")
+    except Exception as exc:
+        return (
+            "<div style='padding:24px;font-family:system-ui,sans-serif'>"
+            "<h3 style='margin:0 0 8px'>TOTEM Dashboard</h3>"
+            "<p style='margin:0 0 12px;color:#666'>"
+            "Dashboard shell is ready. Click <b>Run TOTEM Analysis</b> to load workbook data."
+            "</p>"
+            f"<p style='margin:0;color:#888;font-size:12px'>Startup note: {escape(str(exc))}</p>"
+            "</div>"
+        )
+
+
 # ── GRADIO INTERFACE ──────────────────────────────────────────────────────────
 
 with gr.Blocks(title="TOTEM Studio") as demo:
@@ -1184,7 +1203,7 @@ with gr.Blocks(title="TOTEM Studio") as demo:
 
         # ── TAB 1: DASHBOARD ─────────────────────────────────────────────────
         with gr.TabItem("Dashboard"):
-            dashboard = gr.HTML()
+            dashboard = gr.HTML(value=initial_dashboard_html())
 
             with gr.Row(elem_id="studio-actions"):
                 with gr.Column(elem_classes=["wrap"]):

smoke_signal_tab.py

@@ -750,8 +750,8 @@ def run_ocr() -> tuple:
             "rec_model": load_rec(), "rec_proc": load_rec_proc(),
         }
         log.append(log_line("✓ Surya models loaded"))
-    except ImportError:
-        log.append(log_line("⚠ Surya not installed — falling back to text extraction only"))
+    except ImportError as e:
+        log.append(log_line(f"⚠ Surya unavailable ({e}) — falling back to text extraction only"))
 
     queue_rows = []