Prevent workbook fallback from populating TOTEM scores

app.py

@@ -2925,7 +2925,13 @@ def clear_codex_form() -> tuple[None, str, str, str, str, str, str]:
 
 # ── WORKBOOK FUNCTIONS ────────────────────────────────────────────────────────
 
-def _build_dashboard_state_from_workbook(path: Path, status: str, notice: str = "") -> dict:
+def _build_dashboard_state_from_workbook(
+    path: Path,
+    status: str,
+    notice: str = "",
+    *,
+    include_scorecard: bool = False,
+) -> dict:
     """
     UI-layer adapter (Stage 8). Reads workbook analytics and maps into dashboard_state.
     Does NOT change any extractor/scoring logic — reads only.
@@ -2938,7 +2944,7 @@ def _build_dashboard_state_from_workbook(path: Path, status: str, notice: str =
     state["dashboard_message"] = notice or ""
     state["last_analysis_at"] = datetime.datetime.now().isoformat(timespec="seconds") if status == "complete" else None
 
-    if path.exists():
+    if path.exists() and include_scorecard:
         try:
             log_df = score_log(path)
             if log_df is not None and not log_df.empty:
@@ -3016,7 +3022,7 @@ def _build_dashboard_state_from_workbook(path: Path, status: str, notice: str =
 def load_workbook(uploaded_file=None, notice: str = ""):
     path = _validate_workbook_path(_clean_path(uploaded_file))
     log_df = score_log(path)
-    state = _build_dashboard_state_from_workbook(path, "complete", notice)
+    state = _build_dashboard_state_from_workbook(path, "ready", notice or "Workbook loaded. Upload a manuscript and run TOTEM Analysis.")
     return str(path), render_dashboard(state), log_df, _score_summary(log_df)
 
 
@@ -3049,14 +3055,18 @@ def set_active_workbook(uploaded_file):
 def load_local_path(path_text: str):
     path = _validate_workbook_path(Path(path_text or "").expanduser())
     log_df = score_log(path)
-    state = _build_dashboard_state_from_workbook(path, "complete", "Local workbook loaded.")
+    state = _build_dashboard_state_from_workbook(path, "ready", "Local workbook loaded. Upload a manuscript and run TOTEM Analysis.")
     return str(path), render_dashboard(state), log_df, _score_summary(log_df)
 
 
 def run_analysis(active_path: str):
     path = _validate_workbook_path(Path(active_path) if active_path else _preferred_workbook_path())
     log_df = score_log(path)
-    state = _build_dashboard_state_from_workbook(path, "complete", "TOTEM analysis refreshed.")
+    state = _build_dashboard_state_from_workbook(
+        path,
+        "ready",
+        "Workbook is ready. Upload a manuscript and click Run TOTEM Analysis to score.",
+    )
     return render_dashboard(state), log_df, _score_summary(log_df)
 
 
@@ -3224,7 +3234,11 @@ def run_totem_analysis_from_context(active_path: str, manuscript_context_json: s
 def recalc_log(log_df, active_path: str):
     path = _validate_workbook_path(Path(active_path) if active_path else _preferred_workbook_path())
     recalculated = recalculate_log(log_df, path)
-    state = _build_dashboard_state_from_workbook(path, "complete", "Gates recalculated.")
+    state = _build_dashboard_state_from_workbook(
+        path,
+        "ready",
+        "Gates recalculated in private controls. Run manuscript analysis to update dashboard metrics.",
+    )
     return render_dashboard(state), recalculated, _score_summary(recalculated)
 
 

src/totem_bridge.py

@@ -144,6 +144,8 @@ def run_totem_skill(
     skill_text, skill_path = load_totem_skill()
 
     if _env_truthy("TOTEM_FAKE_API"):
+        if os.getenv("SPACE_ID") and not _env_truthy("TOTEM_ALLOW_FAKE_API_IN_SPACE"):
+            raise BridgeError("TOTEM_FAKE_API is disabled on Hugging Face Spaces.")
         raw_payload = _fake_dashboard_payload(manuscript)
         validated = validate_dashboard_payload(raw_payload)
         return validated, {