@vue-skuilder/db 0.1.40 → 0.2.1

package/dist/index.d.cts

@@ -544,6 +544,19 @@ declare class SessionController<TView = unknown> extends Loggable {
      * know or care which strategy assigned the score.
      */
     private static readonly WELL_INDICATED_SCORE;
+    /**
+     * newQ length at or below which the opportunistic depletion-prefetch
+     * fires. Sets the lead time available for the background replan to land
+     * before the user actually empties the queue and falls into the
+     * (synchronous) wedge-breaker path.
+     *
+     * Set to a small absolute value (not a fraction of batch limit) because
+     * pipeline latency is roughly fixed regardless of batch size — what
+     * matters is "how many cards of user-pace do we have left." 3 cards
+     * × ~3-5s/card = ~10-15s of lead time, comfortably exceeding typical
+     * pipeline latency.
+     */
+    private static readonly DEPLETION_PREFETCH_THRESHOLD;
     /**
      * Internal replan execution. Runs the pipeline, builds a new newQ,
      * atomically swaps it in, and triggers hydration for the new contents.

package/dist/index.d.ts

@@ -544,6 +544,19 @@ declare class SessionController<TView = unknown> extends Loggable {
      * know or care which strategy assigned the score.
      */
     private static readonly WELL_INDICATED_SCORE;
+    /**
+     * newQ length at or below which the opportunistic depletion-prefetch
+     * fires. Sets the lead time available for the background replan to land
+     * before the user actually empties the queue and falls into the
+     * (synchronous) wedge-breaker path.
+     *
+     * Set to a small absolute value (not a fraction of batch limit) because
+     * pipeline latency is roughly fixed regardless of batch size — what
+     * matters is "how many cards of user-pace do we have left." 3 cards
+     * × ~3-5s/card = ~10-15s of lead time, comfortably exceeding typical
+     * pipeline latency.
+     */
+    private static readonly DEPLETION_PREFETCH_THRESHOLD;
     /**
      * Internal replan execution. Runs the pipeline, builds a new newQ,
      * atomically swaps it in, and triggers hydration for the new contents.

package/dist/index.js

@@ -9835,9 +9835,14 @@ var init_UserDBDebugger = __esm({
        */
       async showScheduledReviews(courseId) {
         const userDB = getUserDB();
-        if (!userDB) return;
+        if (!userDB) {
+          logger.info("[UserDB Debug] Data layer not available");
+          return;
+        }
+        logger.info(`[UserDB Debug] Fetching pending reviews${courseId ? ` for course: ${courseId}` : ""}...`);
         try {
           const reviews = await userDB.getPendingReviews(courseId);
+          logger.info(`[UserDB Debug] Got ${reviews.length} reviews`);
           console.group(`\u{1F4C5} Scheduled Reviews${courseId ? ` (${courseId})` : ""}`);
           logger.info(`Total: ${reviews.length}`);
           if (reviews.length > 0) {
@@ -13696,6 +13701,19 @@ var SessionController = class _SessionController extends Loggable {
    * know or care which strategy assigned the score.
    */
   static WELL_INDICATED_SCORE = 0.1;
+  /**
+   * newQ length at or below which the opportunistic depletion-prefetch
+   * fires. Sets the lead time available for the background replan to land
+   * before the user actually empties the queue and falls into the
+   * (synchronous) wedge-breaker path.
+   *
+   * Set to a small absolute value (not a fraction of batch limit) because
+   * pipeline latency is roughly fixed regardless of batch size — what
+   * matters is "how many cards of user-pace do we have left." 3 cards
+   * × ~3-5s/card = ~10-15s of lead time, comfortably exceeding typical
+   * pipeline latency.
+   */
+  static DEPLETION_PREFETCH_THRESHOLD = 3;
   /**
    * Internal replan execution. Runs the pipeline, builds a new newQ,
    * atomically swaps it in, and triggers hydration for the new contents.
@@ -14002,7 +14020,7 @@ var SessionController = class _SessionController extends Loggable {
       this.log("nextCard: queues empty, awaiting in-flight replan before drawing");
       await this._replanPromise;
     }
-    if (this.newQ.length <= 1 && this._secondsRemaining > 0 && !this._replanPromise) {
+    if (this.newQ.length <= _SessionController.DEPLETION_PREFETCH_THRESHOLD && this._secondsRemaining > 0 && !this._replanPromise) {
       this._suppressQualityReplan = false;
       const otherContent = this.reviewQ.length + this.failedQ.length;
       this.log(