Sync from GitHub via hub-sync

learning_engine.py

@@ -33,6 +33,7 @@ def init_session(deck: list[Card]) -> Session:
 
 WEAK_TOPIC_THRESHOLD = 3.0   # avg grade below this = a topic the user is weak on
 WEAK_LOOKAHEAD = 4           # how far down the queue we'll reach to surface a weak card
+GRADUATE_AT_CORRECT = 2      # correct answers needed before a card leaves the queue
 
 
 def next_card(session: Session) -> Card | None:
@@ -170,7 +171,15 @@ def apply_result(session: Session, card: Card, grade: GradeResult,
         st["ease"] = min(3.0, st["ease"] + 0.1)
         st["interval"] = max(2, int(st["interval"] * st["ease"]))
         session["streak"] += 1
-        _insert_at(session, card["id"], st["interval"])  # comes back later
+        # Graduate once the card has been answered correctly GRADUATE_AT_CORRECT
+        # times — only then does it leave the queue for good. (reps counts every
+        # answer, lapses counts the misses, so reps - lapses = correct answers.)
+        # Re-enqueuing a card *every* time it was right is what made the queue
+        # never drain: the session never ended and the same cards came back with
+        # no forward progress. A still-learning card comes back later as before.
+        corrects = st["reps"] - st["lapses"]
+        if corrects < GRADUATE_AT_CORRECT:
+            _insert_at(session, card["id"], st["interval"])  # comes back later
     else:
         st["lapses"] += 1
         st["ease"] = max(1.3, st["ease"] - 0.2)

server.py

@@ -197,6 +197,11 @@ def _view(session: dict) -> dict:
     history = session["history"]
     answered = len(history)
     total = len(deck)
+    # Cards that have graduated out of the queue (mastered this session). Progress
+    # tracks this rather than `answered` so the bar climbs as cards are mastered
+    # and reaches total exactly when the queue drains — instead of pinning at
+    # total/total the moment you've seen every card once.
+    mastered = total - len(session["queue"])
 
     stats: dict[str, dict] = {}
     for h in history:
@@ -208,7 +213,7 @@ def _view(session: dict) -> dict:
     return {
         "total": total,
         "answered": answered,
-        "posDisplay": min(answered + 1, total) if total else 0,
+        "posDisplay": min(mastered + 1, total) if total else 0,
         "streak": session["streak"],
         "topicStats": stats,
         "rail": [