Sync from GitHub via hub-sync

learning_engine.py

@@ -62,7 +62,8 @@ def grade_answer(card: Card, user_answer: str) -> GradeResult:
     if not (user_answer or "").strip():
         return new_grade(
             0,
-            f"No answer given. The reference answer is: {card['answer']}",
+            f"You didn't answer this one — no worries, take a look at the "
+            f"reference answer and give it another go: {card['answer']}",
             card["topic"],
         )
 
@@ -83,12 +84,18 @@ def grade_answer(card: Card, user_answer: str) -> GradeResult:
          "2 = partially relevant but misses the key idea; 3 = mostly correct with "
          "a minor gap; 4-5 = correct and complete. If the answer is factually "
          "wrong, score 0-2 (NOT 3). "
+         "Score strictly, but write the feedback warmly. Speak DIRECTLY to the "
+         "student in the second person ('you', 'your answer') with an "
+         "encouraging coaching tone — acknowledge what they got right before what "
+         "they missed. NEVER write in the third person or refer to them as 'the "
+         "student' / 'the student's response'. "
          "Return ONLY a JSON object with keys: "
-         "score (integer 0-5), explanation (string for the student), "
+         "score (integer 0-5), explanation (string spoken to the student), "
          "missed_concept (short string naming what they got wrong, or \"\"). "
          "Example (return ONE object exactly like this, no other text):\n"
-         '{"score": 1, "explanation": "Not quite — you named the wrong location.", '
-         '"missed_concept": "the specific location"}'},
+         '{"score": 1, "explanation": "Good instinct, but that\'s the wrong '
+         'location — the Calvin cycle actually runs in the stroma. Try linking '
+         'it to where the enzymes sit.", "missed_concept": "the specific location"}'},
         {"role": "user", "content":
          f"Question: {card['question']}\nReference answer: {card['answer']}\n"
          f"Student answer: {user_answer}\nGrade it."},