@vue-skuilder/db 0.2.10 → 0.2.12

package/dist/index.mjs

@@ -2896,7 +2896,7 @@ __export(srs_exports, {
   default: () => SRSNavigator
 });
 import moment3 from "moment";
-var DEFAULT_HEALTHY_BACKLOG, MAX_BACKLOG_MULTIPLIER, SRSNavigator;
+var DEFAULT_HEALTHY_BACKLOG, BACKLOG_GROWTH_RATE, SRSNavigator;
 var init_srs = __esm({
   "src/core/navigators/generators/srs.ts"() {
     "use strict";
@@ -2904,7 +2904,7 @@ var init_srs = __esm({
     init_SrsDebugger();
     init_logger();
     DEFAULT_HEALTHY_BACKLOG = 20;
-    MAX_BACKLOG_MULTIPLIER = 2;
+    BACKLOG_GROWTH_RATE = 2;
     SRSNavigator = class extends ContentNavigator {
       /** Human-readable name for CardGenerator interface */
       name;
@@ -3026,7 +3026,7 @@ var init_srs = __esm({
           dueNow: dueReviews.length,
           healthyBacklog: this.healthyBacklog,
           backlogMultiplier,
-          maxBacklogMultiplier: MAX_BACKLOG_MULTIPLIER,
+          backlogGrowthRate: BACKLOG_GROWTH_RATE,
           topReviewScore: sorted.length > 0 ? sorted[0].score : null,
           nextDueIn,
           timestamp: Date.now()
@@ -3036,25 +3036,30 @@ var init_srs = __esm({
       /**
        * Compute the multiplicative backlog pressure based on number of due reviews.
        *
-       * ×1.0 at or below the healthy threshold (no boost), increasing linearly above
-       * it and maxing out at MAX_BACKLOG_MULTIPLIER at 3× the healthy backlog.
+       * ×1.0 at or below the healthy threshold (no boost); above it, grows as
+       * BACKLOG_GROWTH_RATE raised to the excess expressed in multiples of the
+       * healthy threshold. Uncapped — self-regulating instead: reviews winning
+       * slots depletes dueCount, which drops the ratio and relaxes the multiplier
+       * next run.
        *
-       * Examples (with default healthyBacklog=20, MAX_BACKLOG_MULTIPLIER=2.0):
-       * - 10 due reviews → ×1.00 (healthy)
-       * - 20 due reviews → ×1.00 (at threshold)
-       * - 40 due reviews → ×1.50 (2x threshold)
-       * - 60 due reviews → ×2.00 (3x threshold, maxed)
+       * Examples (with default healthyBacklog=20, BACKLOG_GROWTH_RATE=1.5):
+       * - 10 due reviews → ×1.00  (healthy)
+       * - 20 due reviews → ×1.00  (at threshold, ratio 0)
+       * - 40 due reviews → ×1.50  (ratio 1, 2x threshold)
+       * - 60 due reviews → ×2.25  (ratio 2, 3x threshold — old hard cap was ×2.00 here)
+       * - 100 due reviews → ×5.06 (ratio 4, 5x threshold)
+       * - 160 due reviews → ×17.09 (ratio 7, 8x threshold)
        *
        * @param dueCount - Number of reviews currently due
-       * @returns Multiplier applied to review urgency (1.0 to MAX_BACKLOG_MULTIPLIER)
+       * @returns Multiplier applied to review urgency (>= 1.0, unbounded)
        */
       computeBacklogMultiplier(dueCount) {
         if (dueCount <= this.healthyBacklog) {
           return 1;
         }
         const excess = dueCount - this.healthyBacklog;
-        const multiplier = 1 + excess / this.healthyBacklog * ((MAX_BACKLOG_MULTIPLIER - 1) / 2);
-        return Math.min(MAX_BACKLOG_MULTIPLIER, multiplier);
+        const ratio = excess / this.healthyBacklog;
+        return Math.pow(BACKLOG_GROWTH_RATE, ratio);
       }
       /**
        * Compute urgency score for a review card.
@@ -3070,17 +3075,17 @@ var init_srs = __esm({
        *    - 180 days → ~0.30
        *
        * 3. Backlog pressure = global *multiplier* when review backlog exceeds the
-       *    healthy threshold (×1.0 healthy → up to MAX_BACKLOG_MULTIPLIER at 3×).
+       *    healthy threshold (×1.0 healthy → exponential growth, uncapped, above it).
        *
        * Combined: (base 0.5 + urgency factors * 0.45) × backlog multiplier.
        * Per-card range before pressure: ~0.57–0.95. NOT clamped to 1.0 — under a
        * heavy backlog reviews scale onto the open scale to compete with (and exceed)
-       * new cards; what keeps them from running away is the bounded multiplier, not
-       * a hard ceiling.
+       * new cards; there's no ceiling at all now, so a bad enough backlog always
+       * wins eventually — self-regulating because winning slots depletes dueCount.
        *
        * @param review - The scheduled card to score
        * @param now - Current time
-       * @param backlogMultiplier - Pre-computed backlog multiplier (1.0 to MAX_BACKLOG_MULTIPLIER)
+       * @param backlogMultiplier - Pre-computed backlog multiplier (>= 1.0, unbounded)
        */
       computeUrgencyScore(review, now, backlogMultiplier) {
         const scheduledAt = moment3.utc(review.scheduledAt);
@@ -11203,7 +11208,7 @@ var ResponseProcessor = class {
         const nullTags = tagKeys.filter((k) => taggedPerformance[k] === null);
         const scoredTags = tagKeys.filter((k) => taggedPerformance[k] !== null);
         logger.info(
-          `[ResponseProcessor] per-tag ELO update for ${cardId}: scored=[${scoredTags.join(", ")}] count-only=[${nullTags.join(", ")}]`
+          `[FirstContactElo] correct first-attempt per-tag ELO update for ${cardId} (historyLen=${history.records.length}, priorAttemps=${cardRecord.priorAttemps}): scored=[${scoredTags.join(", ")}] count-only=[${nullTags.join(", ")}]`
         );
         void this.eloService.updateUserAndCardEloPerTag(
           taggedPerformance,
@@ -11234,7 +11239,7 @@ var ResponseProcessor = class {
           );
         }
         logger.info(
-          "[ResponseProcessor] Processed correct response with SRS scheduling and ELO update"
+          `[FirstContactElo] correct first-attempt ELO update (score=${userScore.toFixed(3)}) for ${cardId} (historyLen=${history.records.length}, priorAttemps=${cardRecord.priorAttemps})`
         );
       }
       return {
@@ -11263,7 +11268,8 @@ var ResponseProcessor = class {
    */
   processIncorrectResponse(cardRecord, history, courseRegistrationDoc, currentCard, courseId, cardId, maxAttemptsPerView, maxSessionViews, sessionViews) {
     const { taggedPerformance } = this.parsePerformance(cardRecord.performance);
-    if (history.records.length !== 1 && cardRecord.priorAttemps === 0) {
+    let eloUpdated = false;
+    if (cardRecord.priorAttemps === 0) {
       if (taggedPerformance) {
         void this.eloService.updateUserAndCardEloPerTag(
           taggedPerformance,
@@ -11273,7 +11279,7 @@ var ResponseProcessor = class {
           currentCard
         );
         logger.info(
-          `[ResponseProcessor] Processed incorrect response with per-tag ELO update (${Object.keys(taggedPerformance).length - 1} tags)`
+          `[FirstContactElo] incorrect first-attempt per-tag ELO update for ${cardId} (historyLen=${history.records.length}, priorAttemps=${cardRecord.priorAttemps}, tags=${Object.keys(taggedPerformance).length - 1})`
         );
       } else {
         void this.eloService.updateUserAndCardElo(
@@ -11284,28 +11290,42 @@ var ResponseProcessor = class {
           courseRegistrationDoc,
           currentCard
         );
-        logger.info("[ResponseProcessor] Processed incorrect response with ELO update");
+        logger.info(
+          `[FirstContactElo] incorrect first-attempt ELO update (score=0) for ${cardId} (historyLen=${history.records.length}, priorAttemps=${cardRecord.priorAttemps})`
+        );
       }
+      eloUpdated = true;
     } else {
-      logger.info("[ResponseProcessor] Processed incorrect response (no ELO update needed)");
+      logger.info(
+        `[FirstContactElo] incorrect retry \u2014 no ELO update for ${cardId} (historyLen=${history.records.length}, priorAttemps=${cardRecord.priorAttemps})`
+      );
     }
     if (currentCard.records.length >= maxAttemptsPerView) {
       if (sessionViews >= maxSessionViews) {
-        if (taggedPerformance) {
-          void this.eloService.updateUserAndCardEloPerTag(
-            taggedPerformance,
-            courseId,
-            cardId,
-            courseRegistrationDoc,
-            currentCard
+        if (!eloUpdated) {
+          if (taggedPerformance) {
+            void this.eloService.updateUserAndCardEloPerTag(
+              taggedPerformance,
+              courseId,
+              cardId,
+              courseRegistrationDoc,
+              currentCard
+            );
+          } else {
+            void this.eloService.updateUserAndCardElo(
+              0,
+              courseId,
+              cardId,
+              courseRegistrationDoc,
+              currentCard
+            );
+          }
+          logger.info(
+            `[FirstContactElo] dismiss-failed final ELO penalty for ${cardId} (historyLen=${history.records.length}, sessionViews=${sessionViews})`
           );
         } else {
-          void this.eloService.updateUserAndCardElo(
-            0,
-            courseId,
-            cardId,
-            courseRegistrationDoc,
-            currentCard
+          logger.info(
+            `[FirstContactElo] dismiss-failed \u2014 ELO already updated this response, skipping double penalty for ${cardId}`
           );
         }
         return {
@@ -13614,12 +13634,12 @@ function hintsHtml(h) {
 function backlogHtml(backlog) {
   if (!backlog.length) return "";
   const rows = backlog.map((b) => {
-    const maxed = b.backlogMultiplier >= b.maxBacklogMultiplier - 1e-9;
-    const multColor = b.backlogMultiplier <= 1 ? "#86efac" : maxed ? "#fca5a5" : "#fcd34d";
-    const headroom = maxed ? "maxed \u2014 boosts decide order until they relax" : b.backlogMultiplier > 1 ? "climbing as backlog grows" : "healthy \u2014 no pressure";
+    const hot = b.backlogMultiplier >= 3;
+    const multColor = b.backlogMultiplier <= 1 ? "#86efac" : hot ? "#fca5a5" : "#fcd34d";
+    const headroom = b.backlogMultiplier > 1 ? `climbing (\xD7${b.backlogGrowthRate.toFixed(2)} per ${b.healthyBacklog}-review excess, unbounded)` : "healthy \u2014 no pressure";
     const top = b.topReviewScore !== null ? b.topReviewScore.toFixed(2) : "\u2014";
     const next = b.nextDueIn ? ` <span style="opacity:.6">\xB7 next due ${esc(b.nextDueIn)}</span>` : "";
-    return `<div style="margin-left:6px"><span style="opacity:.7">${esc(b.courseId.slice(0, 8))}</span> due ${b.dueNow}/${b.scheduledTotal} <span style="opacity:.6">(healthy ${b.healthyBacklog})</span>${next}<div style="margin-left:6px">pressure <span style="color:${multColor}">\xD7${b.backlogMultiplier.toFixed(2)}/${b.maxBacklogMultiplier.toFixed(2)}</span> <span style="opacity:.6">${headroom} \xB7 top review ${top}</span></div></div>`;
+    return `<div style="margin-left:6px"><span style="opacity:.7">${esc(b.courseId.slice(0, 8))}</span> due ${b.dueNow}/${b.scheduledTotal} <span style="opacity:.6">(healthy ${b.healthyBacklog})</span>${next}<div style="margin-left:6px">pressure <span style="color:${multColor}">\xD7${b.backlogMultiplier.toFixed(2)}</span> <span style="opacity:.6">${headroom} \xB7 top review ${top}</span></div></div>`;
   }).join("");
   return `<div style="margin-bottom:6px"><div style="color:#93c5fd">review backpressure</div>${rows}</div>`;
 }
@@ -13715,12 +13735,11 @@ function snapshotToText(s) {
     lines.push("");
     lines.push("review backpressure:");
     for (const b of s.reviewBacklog) {
-      const maxed = b.backlogMultiplier >= b.maxBacklogMultiplier - 1e-9;
-      const headroom = maxed ? "maxed (boosts decide order)" : b.backlogMultiplier > 1 ? "climbing" : "healthy";
+      const headroom = b.backlogMultiplier > 1 ? "climbing" : "healthy";
       const top = b.topReviewScore !== null ? b.topReviewScore.toFixed(2) : "\u2014";
       const next = b.nextDueIn ? `, next due ${b.nextDueIn}` : "";
       lines.push(
-        `  ${b.courseId.slice(0, 8)}: due ${b.dueNow}/${b.scheduledTotal} (healthy ${b.healthyBacklog})${next}; pressure \xD7${b.backlogMultiplier.toFixed(2)}/${b.maxBacklogMultiplier.toFixed(2)} ${headroom}; top review ${top}`
+        `  ${b.courseId.slice(0, 8)}: due ${b.dueNow}/${b.scheduledTotal} (healthy ${b.healthyBacklog})${next}; pressure \xD7${b.backlogMultiplier.toFixed(2)} ${headroom}; top review ${top}`
       );
     }
   }
@@ -13758,9 +13777,11 @@ function esc(value) {
 var activeSession = null;
 var sessionHistory = [];
 var MAX_HISTORY = 5;
-function startSessionTracking(supplyQLength, failedQLength) {
+function clearStaleSessionDebugState() {
   clearRunHistory();
   clearSrsBacklogDebug();
+}
+function startSessionTracking(supplyQLength, failedQLength) {
   const sessionId = `session-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
   activeSession = {
     sessionId,
@@ -14242,6 +14263,7 @@ var SessionController = class _SessionController extends Loggable {
         "[SessionController] All content sources must implement getWeightedCards()."
       );
     }
+    clearStaleSessionDebugState();
     const wellIndicated = await this.getWeightedContent();
     this._wellIndicatedRemaining = wellIndicated;
     if (wellIndicated >= 0 && wellIndicated < _SessionController.MIN_WELL_INDICATED) {
@@ -15145,6 +15167,7 @@ export {
   buildStrategyStateId,
   captureMixerRun,
   clearSrsBacklogDebug,
+  clearStaleSessionDebugState,
   computeDeviation,
   computeEffectiveWeight,
   computeOutcomeSignal,