Rename explainers/ExplainerResult to explainers/ExplainerResult.py

explainers/ExplainerResult

@@ -1,21 +0,0 @@
-# models.py
-
-from dataclasses import dataclass
-from typing import List, Optional
-
-@dataclass
-class ExplainerResult:
-    understood: bool
-    topic: Optional[str]
-
-    asks_for: Optional[str]              # what is the target
-    givens: List[str]                   # extracted facts
-    constraints: List[str]              # conditions / limits
-
-    relationships: List[str]            # how things connect (key insight)
-    needed_concepts: List[str]          # what math idea is required
-
-    trap_notes: List[str]               # common mistakes
-    strategy_hint: Optional[str]        # how you'd approach (no solving)
-
-    plain_english: Optional[str]        # simplified restatement

explainers/ExplainerResult.py

@@ -0,0 +1,32 @@
+# explainer_types.py
+from dataclasses import dataclass, field
+from typing import List, Optional, Dict, Any
+
+
+@dataclass
+class ExplainerScaffold:
+    concept: Optional[str] = None
+    ask: Optional[str] = None
+    givens: List[str] = field(default_factory=list)
+    target: Optional[str] = None
+
+    setup_actions: List[str] = field(default_factory=list)
+    intermediate_steps: List[str] = field(default_factory=list)
+    first_move: Optional[str] = None
+    next_hint: Optional[str] = None
+
+    common_traps: List[str] = field(default_factory=list)
+    variables_to_define: List[str] = field(default_factory=list)
+    equations_to_form: List[str] = field(default_factory=list)
+
+    answer_hidden: bool = True
+
+
+@dataclass
+class ExplainerResult:
+    understood: bool = False
+    topic: Optional[str] = None
+    summary: Optional[str] = None
+    teaching_points: List[str] = field(default_factory=list)
+    scaffold: ExplainerScaffold = field(default_factory=ExplainerScaffold)
+    meta: Dict[str, Any] = field(default_factory=dict)