feat(backend): V281.0 - Vision-First OCR, Visuals robustness (Pow fix), and Rigid Graph Identification

orchestrator.py

@@ -768,13 +768,19 @@ ctx.finish("$$ 4 $$", "מעולה! הגענו לתוצאה.")
         print(f"📸 🏆 [BIT-LOG] OCR Winner: score={winner[1]} (of {len(valid)} candidates)")
         return winner[0]
 
-    async def _extract_key_data(self, problem_text: str) -> dict:
-        """V231.12: Phase 1 - Extract specific values with validation and retry."""
+    async def _extract_key_data(self, problem_text: str, image_data: bytes = None) -> dict:
+        """V231.14: Phase 1 - Extract specific values with validation and image support."""
         for attempt in range(1, 3):  # 2 attempts
             try:
                 prompt = prompts.get_data_extraction_prompt(problem_text)
+                
+                # Build multimodal request if image is available
+                content = [prompt]
+                if image_data:
+                    content.append({"mime_type": "image/png", "data": image_data})
+                
                 res = await asyncio.wait_for(
-                    self.model.generate_content_async(prompt),
+                    self.model.generate_content_async(content),
                     timeout=15.0  # 15s timeout per attempt
                 )
                 cost_tracker.log_api_usage(res.usage_metadata, "DATA_ANCHOR")
@@ -1182,7 +1188,7 @@ ctx.finish("$$ 4 $$", "מעולה! הגענו לתוצאה.")
             # First, transcribe and extract the "Absolute Truth" of the problem
             print("📝 [CHECK-ME] Step 1.5: Extracting Problem Data (Data Slicing)...")
             problem_text = await self.transcribe_image(image_data)
-            data_anchor = await self._extract_key_data(problem_text)
+            data_anchor = await self._extract_key_data(problem_text, image_data=image_data)
 
             # Step 2: Build check-me prompt and send to Vision LLM
             check_prompt = prompts.get_check_me_prompt(
@@ -2136,7 +2142,7 @@ ctx.finish("$$ 4 $$", "מעולה! הגענו לתוצאה.")
         # ===================== FULL STREAMING PIPELINE =====================
         print(f"🎯 [BIT-LOG] Using Streaming Pipeline Strategy: {strategy.value}")
 
-        data_anchor = await self._extract_key_data(problem_text) or {}
+        data_anchor = await self._extract_key_data(problem_text, image_data=image_data) or {}
         
         # Iterate through the streaming smart_solve
         # V5.10.2: Remove keys already passed explicitly to avoid TypeError collision

prompts.py

@@ -230,11 +230,15 @@ def _detect_relevant_rules(text: str, category: str = "") -> list:
     return rules
 
 def get_data_extraction_prompt(problem_text: str) -> str:
-    """V231.13: Extract ALL equations, not just functions."""
+    """V231.14: Extract strictly from IMAGE. OCR is a secondary reference."""
     return fr"""
-EXTRACT key mathematical data from this problem. Return ONLY valid JSON.
+### [DATA ANCHOR SUPREMACY]
+You are provided with an IMAGE and its rough OCR transcription.
+The OCR text is highly unreliable and may contain critical errors in mathematical symbols.
+YOUR TASK: Extract the mathematical "Absolute Truth" strictly by visually inspecting the IMAGE.
+Use the OCR text only as a secondary reference for context.
 
-Problem:
+Problem Text (OCR):
 {problem_text}
 
 Extract:
@@ -384,6 +388,28 @@ def get_specialist_prompt(category, problem_text, solver_hint, grade, student_na
     }
     """
 
+    # V281.0: Graph Identification Rigid JSON Rule
+    graph_identification_block = ""
+    if category == "GRAPH_IDENTIFICATION" or "גרף" in problem_text and "איזה" in problem_text:
+        graph_identification_block = """
+    ═══════════════════════════════════════════════════
+    📊 חוק התאמת גרפים (GRAPH MATCHING PROTOCOL - V281.0):
+    ═══════════════════════════════════════════════════
+    
+    בשאלה זו עליך להתאים בין פונקציה לגרף. כדי למנוע הזיות (hallucinations), חובה לעבוד בפורמט ניתוח קשיח.
+    חובה להוסיף בשורש ה-JSON את השדה "graph_analysis" המילוני:
+    "graph_analysis": {
+      "function_analysis": "תיאור מתמטי מפורט של הפונקציה (נקודות חיתוך עם הצירים, נקודות קיצון, אסימפטוטות, תחומי חיוביות ושליליות)",
+      "graph_options": [
+        {"id": "I", "description": "תיאור ויזואלי של גרף I מהתמונה - איפה הוא עובר, האם הוא עולה/יורד, נקודות חיתוך בולטות"},
+        {"id": "II", "description": "תיאור ויזואלי של גרף II מהתמונה..."},
+        {"id": "III", "description": "תיאור ויזואלי של גרף III... (אם קיים)"}
+      ],
+      "matching_logic": "הסבר לוגי-מתמטי המקשר בין תכונות הפונקציה לבין המאפיינים הויזואליים של הגרף שנבחר, והסבר למה הגרפים האחרים נפסלו",
+      "final_match": "התשובה הסופית (למשל: גרף II)"
+    }
+    """
+
     return f"""
     🎓 תפקיד: אתה "המורה למתמטיקה" — מורה פרטית חמה ומעודדת בגישת 'הנסיך והנסיכה'.
     🌟 הנחיה עליונה: הפוך את הלמידה לחוויה מעצימה, אישית ונעימה עבור {student_name}.
@@ -421,6 +447,7 @@ def get_specialist_prompt(category, problem_text, solver_hint, grade, student_na
     
     {proof_block}
     {investigation_block}
+    {graph_identification_block}
     """
 
 

topic_taxonomy.py

@@ -502,6 +502,13 @@ TOPIC_TAXONOMY = {
         "category": "ALGEBRA",
         "complexity": "medium"
     },
+    
+    "GRAPH_IDENTIFICATION": {
+        "keywords": ["איזה מהגרפים", "מתאים לפונקציה", "התאם בין", "מתאמת לגרף"],
+        "grade_range": (9, 12),
+        "category": "GRAPH_IDENTIFICATION",
+        "complexity": "high"
+    },
 }
 
 # ==================== DETECTION FUNCTIONS ====================

visuals.py

@@ -38,10 +38,12 @@ def sanitize_math_for_sympy(expr_str: str) -> str:
     text = text.replace(r'\ln', 'ln').replace(r'\log', 'log').replace(r'\exp', 'exp')
     text = text.replace(r'\sqrt', 'sqrt').replace(r'\pi', 'pi').replace(r'\theta', 'theta')
     
-    # Implicit function arguments: sin x -> sin(x)
-    text = re.sub(r'(sin|cos|tan|ln|log|exp|sqrt)\s*([a-zA-Z0-9]+)', r'\1(\2)', text)
+    # V281.0: CRITICAL FIX - Implicit multiplication before parentheses and functions
+    # 1. Add parentheses to functions missing them: ln x -> ln(x), ln Abs(x) -> ln(Abs(x))
+    # Match function + (identifier or Abs(...) or nested function)
+    text = re.sub(r'(sin|cos|tan|ln|log|exp|sqrt)\s*([a-zA-Z\d]+(?:\([^)]*\))?)', r'\1(\2)', text)
     
-    # V276.0 CRITICAL FIX: \cdot → * (BEFORE ^ conversion!)
+    # 2. V276.0 CRITICAL FIX: \cdot → * (BEFORE ^ conversion!)
     text = text.replace(r'\cdot', '*').replace('cdot', '*')
     
     # 5. ABSOLUTE VALUE FIX (V309.5: Clean Paired Pipes |x| -> Abs(x))
@@ -69,9 +71,12 @@ def sanitize_math_for_sympy(expr_str: str) -> str:
     blocklist = ["calculate", "find", "solve", "graph", ":"]
     for w in blocklist: text = re.sub(rf'\b{w}\b', '', text, flags=re.IGNORECASE)
 
-    # Implicit multiplication
-    text = re.sub(r'(\d)([a-zA-Z\(])', r'\1*\2', text)
-    text = re.sub(r'(\))(\()', r'\1*\2', text)
+    # V281.0: REFINED IMPLICIT MULTIPLICATION (Fixes "Pow object is not callable")
+    # x(x+1) -> x*(x+1), 2(x) -> 2*(x), (x)(y) -> (x)*(y)
+    text = re.sub(r'(\d|[a-zA-Z]|\))(\()', r'\1*\2', text)
+    # 2x -> 2*x, )x -> )*x
+    text = re.sub(r'(\d|\))([a-zA-Z\(])', r'\1*\2', text)
+    # (x)y -> (x)*y
     text = re.sub(r'(\))([a-zA-Z])', r'\1*\2', text) 
 
     # Whitelist → replaced with targeted blocklist to protect all math-relevant chars