@vue-skuilder/db 0.1.38 → 0.1.39

package/dist/index.d.cts

@@ -422,13 +422,6 @@ declare class SessionController<TView = unknown> extends Loggable {
      * Cleared when the depletion-triggered replan fires (newQ exhausted).
      */
     private _suppressQualityReplan;
-    /**
-     * Guards against infinite depletion-triggered replans. Set to true
-     * when a depletion replan fires; cleared when a replan produces
-     * content (newQ.length > 0 after replan) or when an explicit
-     * (non-auto) replan is requested.
-     */
-    private _depletionReplanAttempted;
     /**
      * When > 0, the session timer cannot end the session. Decremented on
      * each nextCard() draw. Set by replans that include `minFollowUpCards`.
@@ -521,6 +514,19 @@ declare class SessionController<TView = unknown> extends Loggable {
      * newQ.peek(0) is the imminent draw we need to exclude.
      */
     private _runReplan;
+    /**
+     * Run a replan, bypassing requestReplan()'s coalesce logic.
+     *
+     * Use this when correctness depends on a *fresh* pipeline run, not on
+     * the existence of *some* in-flight replan. Specifically: the
+     * wedge-breaker path in nextCard(), where coalescing into a previous
+     * run that we now know produced insufficient content would re-create
+     * the bug we're trying to prevent.
+     *
+     * Still tracks _replanPromise like requestReplan() does so concurrent
+     * observers (auto-trigger guards in nextCard()) see consistent state.
+     */
+    private _replanUncoalesced;
     /**
      * Normalise the requestReplan argument. Accepts either a ReplanOptions
      * object (new API) or a plain Record<string, unknown> (legacy callers

package/dist/index.d.ts

@@ -422,13 +422,6 @@ declare class SessionController<TView = unknown> extends Loggable {
      * Cleared when the depletion-triggered replan fires (newQ exhausted).
      */
     private _suppressQualityReplan;
-    /**
-     * Guards against infinite depletion-triggered replans. Set to true
-     * when a depletion replan fires; cleared when a replan produces
-     * content (newQ.length > 0 after replan) or when an explicit
-     * (non-auto) replan is requested.
-     */
-    private _depletionReplanAttempted;
     /**
      * When > 0, the session timer cannot end the session. Decremented on
      * each nextCard() draw. Set by replans that include `minFollowUpCards`.
@@ -521,6 +514,19 @@ declare class SessionController<TView = unknown> extends Loggable {
      * newQ.peek(0) is the imminent draw we need to exclude.
      */
     private _runReplan;
+    /**
+     * Run a replan, bypassing requestReplan()'s coalesce logic.
+     *
+     * Use this when correctness depends on a *fresh* pipeline run, not on
+     * the existence of *some* in-flight replan. Specifically: the
+     * wedge-breaker path in nextCard(), where coalescing into a previous
+     * run that we now know produced insufficient content would re-create
+     * the bug we're trying to prevent.
+     *
+     * Still tracks _replanPromise like requestReplan() does so concurrent
+     * observers (auto-trigger guards in nextCard()) see consistent state.
+     */
+    private _replanUncoalesced;
     /**
      * Normalise the requestReplan argument. Accepts either a ReplanOptions
      * object (new API) or a plain Record<string, unknown> (legacy callers

package/dist/index.js

@@ -13387,13 +13387,6 @@ var SessionController = class _SessionController extends Loggable {
    * Cleared when the depletion-triggered replan fires (newQ exhausted).
    */
   _suppressQualityReplan = false;
-  /**
-   * Guards against infinite depletion-triggered replans. Set to true
-   * when a depletion replan fires; cleared when a replan produces
-   * content (newQ.length > 0 after replan) or when an explicit
-   * (non-auto) replan is requested.
-   */
-  _depletionReplanAttempted = false;
   /**
    * When > 0, the session timer cannot end the session. Decremented on
    * each nextCard() draw. Set by replans that include `minFollowUpCards`.
@@ -13551,9 +13544,6 @@ var SessionController = class _SessionController extends Loggable {
    */
   async requestReplan(options) {
     const opts = this.normalizeReplanOptions(options);
-    if (opts.hints || opts.label || opts.limit) {
-      this._depletionReplanAttempted = false;
-    }
     const hasIntent = this._replanHasIntent(opts);
     if (this._replanPromise) {
       if (!hasIntent) {
@@ -13632,6 +13622,25 @@ var SessionController = class _SessionController extends Loggable {
     }
     await this._executeReplan(opts);
   }
+  /**
+   * Run a replan, bypassing requestReplan()'s coalesce logic.
+   *
+   * Use this when correctness depends on a *fresh* pipeline run, not on
+   * the existence of *some* in-flight replan. Specifically: the
+   * wedge-breaker path in nextCard(), where coalescing into a previous
+   * run that we now know produced insufficient content would re-create
+   * the bug we're trying to prevent.
+   *
+   * Still tracks _replanPromise like requestReplan() does so concurrent
+   * observers (auto-trigger guards in nextCard()) see consistent state.
+   */
+  async _replanUncoalesced(opts) {
+    const run = this._runReplan(opts);
+    this._replanPromise = run.finally(() => {
+      if (this._replanPromise === run) this._replanPromise = null;
+    });
+    await run;
+  }
   /**
    * Normalise the requestReplan argument. Accepts either a ReplanOptions
    * object (new API) or a plain Record<string, unknown> (legacy callers
@@ -13685,9 +13694,6 @@ var SessionController = class _SessionController extends Loggable {
         `[Replan] Only ${wellIndicated}/${_SessionController.MIN_WELL_INDICATED} well-indicated cards after replan`
       );
     }
-    if (this.newQ.length > 0) {
-      this._depletionReplanAttempted = false;
-    }
     await this.hydrationService.ensureHydratedCards();
     const labelTag = opts.label ? ` [${opts.label}]` : "";
     this.log(`Replan complete${labelTag}: newQ now has ${this.newQ.length} cards (mode=${mode})`);
@@ -13966,21 +13972,13 @@ var SessionController = class _SessionController extends Loggable {
       this.log("nextCard: awaiting in-flight replan before drawing");
       await this._replanPromise;
     }
-    if (this.newQ.length <= 1 && this._secondsRemaining > 0 && !this._replanPromise && !this._depletionReplanAttempted) {
+    if (this.newQ.length <= 1 && this._secondsRemaining > 0 && !this._replanPromise) {
       this._suppressQualityReplan = false;
-      this._depletionReplanAttempted = true;
       const otherContent = this.reviewQ.length + this.failedQ.length;
-      if (this.newQ.length === 0 && otherContent === 0) {
-        this.log(
-          `[AutoReplan:depletion] All queues empty with ${this._secondsRemaining}s remaining. Awaiting replan.`
-        );
-        await this.requestReplan();
-      } else {
-        this.log(
-          `[AutoReplan:depletion] newQ has ${this.newQ.length} card(s) (${otherContent} in other queues) with ${this._secondsRemaining}s remaining. Triggering background replan.`
-        );
-        void this.requestReplan();
-      }
+      this.log(
+        `[AutoReplan:depletion] newQ has ${this.newQ.length} card(s) (${otherContent} in other queues) with ${this._secondsRemaining}s remaining. Triggering background replan.`
+      );
+      void this.requestReplan();
     }
     const REPLAN_BUFFER = 3;
     if (!this._suppressQualityReplan && this._wellIndicatedRemaining <= REPLAN_BUFFER && this.newQ.length > 0 && !this._replanPromise) {
@@ -13994,6 +13992,27 @@ var SessionController = class _SessionController extends Loggable {
       endSessionTracking();
       return null;
     }
+    const WEDGE_MAX_EMPTY_STREAK = 3;
+    const WEDGE_BACKOFF_MS = 250;
+    let wedgeEmptyStreak = 0;
+    while (this._secondsRemaining > 0 && this.newQ.length === 0 && this.reviewQ.length === 0 && this.failedQ.length === 0) {
+      this.log(
+        `[WedgeBreaker] All queues empty with ${this._secondsRemaining}s remaining. Running pipeline (attempt ${wedgeEmptyStreak + 1}/${WEDGE_MAX_EMPTY_STREAK}).`
+      );
+      await this._replanUncoalesced({ label: "wedge-breaker" });
+      if (this.newQ.length === 0 && this.reviewQ.length === 0 && this.failedQ.length === 0) {
+        wedgeEmptyStreak++;
+        if (wedgeEmptyStreak >= WEDGE_MAX_EMPTY_STREAK) {
+          this.log(
+            `[WedgeBreaker] Pipeline returned no content ${WEDGE_MAX_EMPTY_STREAK} consecutive times. Giving up; session will end.`
+          );
+          break;
+        }
+        await new Promise((resolve) => setTimeout(resolve, WEDGE_BACKOFF_MS));
+      } else {
+        wedgeEmptyStreak = 0;
+      }
+    }
     const MAX_SKIP = 20;
     for (let attempt = 0; attempt < MAX_SKIP; attempt++) {
       const nextItem = this._selectNextItemToHydrate();