Update main.py

main.py

@@ -1345,6 +1345,45 @@ class IrisReportEngine:
         emit_kpi_debug(self.profile_id, "briefing_done", snapshot["meta"])
         return json_safe(snapshot)
 
+    def synthesize_fallback_response(self, briefing: dict, user_question: str) -> str:
+        """
+        LLM is narration-only. Do NOT invent or recompute numbers here.
+        Use the already-deterministic 'briefing' dict as the single source of truth.
+        Safe for PandasAI exception fallback.
+        """
+        try:
+            tz = TZ
+            prompt = (
+                "You are Iris, a concise business analyst.\n"
+                "IMPORTANT RULES:\n"
+                "• DO NOT invent numbers. ONLY use values present in the Business Data JSON.\n"
+                "• If a metric is missing, say 'N/A' or 'no data for this period'.\n"
+                "• Harare timezone is the reference for dates/times.\n"
+                "• Keep it brief: headings + bullets; no tables unless clearly helpful.\n"
+                "• If the user asked something specific (e.g., 'top 5 products'), answer directly from the JSON.\n"
+                "• Otherwise, provide a short business briefing (performance, products, timing, customers, branches).\n"
+                "• Never expose internal keys; paraphrase labels.\n"
+                f"User Question: {json.dumps(user_question)}\n\n"
+                "Business Data (authoritative; JSON):\n"
+                f"{json.dumps(json_safe(briefing), ensure_ascii=False)}\n"
+            )
+
+            resp = self.llm.invoke(prompt)
+            # ChatGoogleGenerativeAI returns an object with .content
+            text = getattr(resp, "content", None) or str(resp)
+            # Final safety scrub (remove accidental code fences / tracebacks)
+            return sanitize_answer(text)
+            
+        except Exception as e:
+            # Absolute last resort: dump a compact JSON view so the UI shows *something*
+            fallback = {
+                "note": "Narrative fallback failed; returning raw snapshot.",
+                "error": str(e)[:200],
+                "snapshot_keys": list(briefing.keys()) if isinstance(briefing, dict) else "N/A"
+            }
+            return "### Business Snapshot\n\n```\n" + json.dumps(json_safe(briefing), indent=2) + "\n```\n\n" + \
+                   "```\n" + json.dumps(fallback, indent=2) + "\n```"
+
 # ------------------------- helpers (outside class) -------------------------
 
 def rfm_to_list(df: pd.DataFrame) -> List[Dict[str, Any]]: