@vue-skuilder/db 0.1.29 → 0.1.31-a

package/package.json

@@ -4,7 +4,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.1.29",
+  "version": "0.1.31-a",
   "description": "Database layer for vue-skuilder",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -48,7 +48,7 @@
   },
   "dependencies": {
     "@nilock2/pouchdb-authentication": "^1.0.2",
-    "@vue-skuilder/common": "0.1.29",
+    "@vue-skuilder/common": "0.1.31-a",
     "cross-fetch": "^4.1.0",
     "moment": "^2.29.4",
     "pouchdb": "^9.0.0",
@@ -62,5 +62,5 @@
     "vite": "^7.0.0",
     "vitest": "^4.0.15"
   },
-  "stableVersion": "0.1.29"
+  "stableVersion": "0.1.31a"
 }

package/src/core/navigators/generators/elo.ts

@@ -88,30 +88,41 @@ export default class ELONavigator extends ContentNavigator implements CardGenera
     const cardIds = newCards.map((c) => c.cardID);
     const cardEloData = await this.course.getCardEloData(cardIds);
 
-    // Score new cards by ELO distance
+    // Score new cards by ELO distance, then apply weighted sampling without
+    // replacement using the Efraimidis-Spirakis (A-Res) algorithm:
+    //
+    //   key = U ^ (1 / rawScore)   where U ~ Uniform(0, 1)
+    //
+    // Sorting by key descending produces a weighted random sample: high-score
+    // cards are still preferred, but cards with equal scores are shuffled
+    // uniformly rather than deterministically. This prevents the same failed
+    // cards from looping back every session when many cards share similar ELO.
+    //
+    // Edge case: rawScore=0 → key=0, never selected (correct exclusion).
     const scored: WeightedCard[] = newCards.map((c, i) => {
       const cardElo = cardEloData[i]?.global?.score ?? 1000;
       const distance = Math.abs(cardElo - userGlobalElo);
-      const score = Math.max(0, 1 - distance / 500);
+      const rawScore = Math.max(0, 1 - distance / 500);
+      const samplingKey = rawScore > 0 ? Math.random() ** (1 / rawScore) : 0;
 
       return {
         cardId: c.cardID,
         courseId: c.courseID,
-        score,
+        score: samplingKey,
         provenance: [
           {
             strategy: 'elo',
             strategyName: this.strategyName || this.name,
             strategyId: this.strategyId || 'NAVIGATION_STRATEGY-ELO-default',
             action: 'generated',
-            score,
-            reason: `ELO distance ${Math.round(distance)} (card: ${Math.round(cardElo)}, user: ${Math.round(userGlobalElo)}), new card`,
+            score: samplingKey,
+            reason: `ELO distance ${Math.round(distance)} (card: ${Math.round(cardElo)}, user: ${Math.round(userGlobalElo)}), raw ${rawScore.toFixed(3)}, key ${samplingKey.toFixed(3)}`,
           },
         ],
       };
     });
 
-    // Sort by score descending
+    // Sort by sampling key descending (weighted sample without replacement)
     scored.sort((a, b) => b.score - a.score);
 
     const result = scored.slice(0, limit);