@vue-skuilder/db 0.1.33 → 0.1.34

package/dist/index.d.cts

@@ -387,6 +387,15 @@ declare class SessionController<TView = unknown> extends Loggable {
      * Individual replans can override via `ReplanOptions.limit`.
      */
     private _defaultBatchLimit;
+    /**
+     * Maximum number of reviews enqueued at session start. Reviews live
+     * outside the replan flow — the queue drains via consumption and is
+     * not refilled mid-session. The session timer caps total review
+     * exposure, so overfilling here is intentional. Default is generous
+     * to accommodate Anki-style power users with hundreds of due reviews;
+     * apps targeting nimbler sessions should override via constructor.
+     */
+    private _initialReviewCap;
     private sources;
     private _sessionRecord;
     set sessionRecord(r: StudySessionRecord[]);
@@ -444,9 +453,12 @@ declare class SessionController<TView = unknown> extends Loggable {
      * @param options.defaultBatchLimit - Default pipeline batch size (default: 20).
      *   Smaller values for newer users cause more frequent replans, keeping plans
      *   aligned with rapidly-changing user state.
+     * @param options.initialReviewCap - Max reviews loaded at session start (default: 200).
+     *   Applied only on initial planning; replans do not refill the review queue.
      */
     constructor(sources: StudyContentSource[], time: number, dataLayer: DataLayerProvider, getViewComponent: (viewId: string) => TView, mixer?: SourceMixer, options?: {
         defaultBatchLimit?: number;
+        initialReviewCap?: number;
     });
     private tick;
     /**

package/dist/index.d.ts

@@ -387,6 +387,15 @@ declare class SessionController<TView = unknown> extends Loggable {
      * Individual replans can override via `ReplanOptions.limit`.
      */
     private _defaultBatchLimit;
+    /**
+     * Maximum number of reviews enqueued at session start. Reviews live
+     * outside the replan flow — the queue drains via consumption and is
+     * not refilled mid-session. The session timer caps total review
+     * exposure, so overfilling here is intentional. Default is generous
+     * to accommodate Anki-style power users with hundreds of due reviews;
+     * apps targeting nimbler sessions should override via constructor.
+     */
+    private _initialReviewCap;
     private sources;
     private _sessionRecord;
     set sessionRecord(r: StudySessionRecord[]);
@@ -444,9 +453,12 @@ declare class SessionController<TView = unknown> extends Loggable {
      * @param options.defaultBatchLimit - Default pipeline batch size (default: 20).
      *   Smaller values for newer users cause more frequent replans, keeping plans
      *   aligned with rapidly-changing user state.
+     * @param options.initialReviewCap - Max reviews loaded at session start (default: 200).
+     *   Applied only on initial planning; replans do not refill the review queue.
      */
     constructor(sources: StudyContentSource[], time: number, dataLayer: DataLayerProvider, getViewComponent: (viewId: string) => TView, mixer?: SourceMixer, options?: {
         defaultBatchLimit?: number;
+        initialReviewCap?: number;
     });
     private tick;
     /**

package/dist/index.js

@@ -2562,7 +2562,26 @@ var init_srs = __esm({
         const courseId = this.course.getCourseID();
         const reviews = await this.user.getPendingReviews(courseId);
         const now = import_moment3.default.utc();
-        const dueReviews = reviews.filter((r) => now.isAfter(import_moment3.default.utc(r.reviewTime)));
+        let dueReviews = reviews.filter((r) => now.isAfter(import_moment3.default.utc(r.reviewTime)));
+        if (dueReviews.length > 0) {
+          const dueCardIds = [...new Set(dueReviews.map((r) => r.cardId))];
+          const tagsByCard = await this.course.getAppliedTagsBatch(dueCardIds);
+          const skippedReviewIds = [];
+          dueReviews = dueReviews.filter((r) => {
+            const tags = tagsByCard.get(r.cardId) ?? [];
+            if (tags.includes("srs:skip")) {
+              skippedReviewIds.push(r._id);
+              return false;
+            }
+            return true;
+          });
+          if (skippedReviewIds.length > 0) {
+            logger.info(`[SRS] Removing ${skippedReviewIds.length} scheduled reviews for srs:skip cards`);
+            for (const id of skippedReviewIds) {
+              void this.user.removeScheduledCardReview(id);
+            }
+          }
+        }
         const backlogPressure = this.computeBacklogPressure(dueReviews.length);
         if (dueReviews.length > 0) {
           const pressureNote = backlogPressure > 0 ? ` [backlog pressure: +${backlogPressure.toFixed(2)}]` : ` [healthy backlog]`;
@@ -7783,17 +7802,18 @@ Currently logged-in as ${this._username}.`
        * @param course_id optional specification of individual course
        */
       async getSeenCards(course_id) {
-        let prefix = DocTypePrefixes["CARDRECORD" /* CARDRECORD */];
+        const basePrefix = DocTypePrefixes["CARDRECORD" /* CARDRECORD */];
+        let filterPrefix = basePrefix;
         if (course_id) {
-          prefix += course_id;
+          filterPrefix += `-${course_id}-`;
         }
-        const docs = await filterAllDocsByPrefix(this.localDB, prefix, {
+        const docs = await filterAllDocsByPrefix(this.localDB, filterPrefix, {
           include_docs: false
         });
         const ret = [];
         docs.rows.forEach((row) => {
-          if (row.id.startsWith(DocTypePrefixes["CARDRECORD" /* CARDRECORD */])) {
-            ret.push(row.id.substr(DocTypePrefixes["CARDRECORD" /* CARDRECORD */].length));
+          if (row.id.startsWith(filterPrefix)) {
+            ret.push(row.id.substr(filterPrefix.length));
           }
         });
         return ret;
@@ -10678,7 +10698,10 @@ var ResponseProcessor = class {
    */
   processCorrectResponse(cardRecord, history, studySessionItem, courseRegistrationDoc, currentCard, courseId, cardId) {
     if (cardRecord.priorAttemps === 0) {
-      void this.srsService.scheduleReview(history, studySessionItem);
+      const skipSrs = currentCard.card.tags.includes("srs:skip");
+      if (!skipSrs) {
+        void this.srsService.scheduleReview(history, studySessionItem);
+      }
       const { globalScore, taggedPerformance } = this.parsePerformance(cardRecord.performance);
       if (taggedPerformance) {
         const tagKeys = Object.keys(taggedPerformance).filter((k) => k !== "_global");
@@ -13171,6 +13194,15 @@ var SessionController = class _SessionController extends Loggable {
    * Individual replans can override via `ReplanOptions.limit`.
    */
   _defaultBatchLimit = 20;
+  /**
+   * Maximum number of reviews enqueued at session start. Reviews live
+   * outside the replan flow — the queue drains via consumption and is
+   * not refilled mid-session. The session timer caps total review
+   * exposure, so overfilling here is intentional. Default is generous
+   * to accommodate Anki-style power users with hundreds of due reviews;
+   * apps targeting nimbler sessions should override via constructor.
+   */
+  _initialReviewCap = 200;
   sources;
   // dataLayer and getViewComponent now injected into CardHydrationService
   _sessionRecord = [];
@@ -13246,6 +13278,8 @@ var SessionController = class _SessionController extends Loggable {
    * @param options.defaultBatchLimit - Default pipeline batch size (default: 20).
    *   Smaller values for newer users cause more frequent replans, keeping plans
    *   aligned with rapidly-changing user state.
+   * @param options.initialReviewCap - Max reviews loaded at session start (default: 200).
+   *   Applied only on initial planning; replans do not refill the review queue.
    */
   constructor(sources, time, dataLayer, getViewComponent, mixer, options) {
     super();
@@ -13268,10 +13302,14 @@ var SessionController = class _SessionController extends Loggable {
     if (options?.defaultBatchLimit !== void 0) {
       this._defaultBatchLimit = options.defaultBatchLimit;
     }
+    if (options?.initialReviewCap !== void 0) {
+      this._initialReviewCap = options.initialReviewCap;
+    }
     this.log(`Session constructed:
     startTime: ${this.startTime}
     endTime: ${this.endTime}
-    defaultBatchLimit: ${this._defaultBatchLimit}`);
+    defaultBatchLimit: ${this._defaultBatchLimit}
+    initialReviewCap: ${this._initialReviewCap}`);
   }
   tick() {
     this._secondsRemaining = Math.floor((this.endTime.valueOf() - Date.now()) / 1e3);
@@ -13356,16 +13394,16 @@ var SessionController = class _SessionController extends Loggable {
       this.log("Replan already in progress, awaiting existing replan");
       return this._replanPromise;
     }
+    if (!opts.hints) opts.hints = {};
+    const hints = opts.hints;
+    const excludeSet = new Set(hints.excludeCards ?? []);
     if (this._currentCard?.item.cardID) {
-      const currentId = this._currentCard.item.cardID;
-      if (!opts.hints) opts.hints = {};
-      const hints = opts.hints;
-      const excludeCards = hints.excludeCards ?? [];
-      if (!excludeCards.includes(currentId)) {
-        excludeCards.push(currentId);
-      }
-      hints.excludeCards = excludeCards;
+      excludeSet.add(this._currentCard.item.cardID);
+    }
+    for (const rec of this._sessionRecord) {
+      excludeSet.add(rec.card.card_id);
     }
+    hints.excludeCards = [...excludeSet];
     if (opts.hints) {
       const hintsWithLabel = opts.label ? { ...opts.hints, _label: opts.label } : opts.hints;
       for (const source of this.sources) {
@@ -13535,12 +13573,13 @@ var SessionController = class _SessionController extends Loggable {
   async getWeightedContent(options) {
     const replan = options?.replan ?? false;
     const additive = options?.additive ?? false;
-    const limit = options?.limit ?? this._defaultBatchLimit;
+    const newLimit = options?.limit ?? this._defaultBatchLimit;
+    const fetchLimit = replan ? newLimit : newLimit + this._initialReviewCap;
     const batches = [];
     for (let i = 0; i < this.sources.length; i++) {
       const source = this.sources[i];
       try {
-        const weighted = (await source.getWeightedCards(limit)).cards;
+        const weighted = (await source.getWeightedCards(fetchLimit)).cards;
         batches.push({
           sourceIndex: i,
           weighted
@@ -13561,7 +13600,7 @@ var SessionController = class _SessionController extends Loggable {
         `Cannot start session: failed to load content from all ${this.sources.length} source(s). Check logs for details.`
       );
     }
-    const mixedWeighted = this.mixer.mix(batches, limit * this.sources.length);
+    const mixedWeighted = this.mixer.mix(batches, fetchLimit * this.sources.length);
     const sourceIds = batches.map((b) => {
       const firstCard = b.weighted[0];
       return firstCard?.courseId || `source-${b.sourceIndex}`;
@@ -13578,18 +13617,18 @@ var SessionController = class _SessionController extends Loggable {
       })
     );
     const sourceNames = sourceIds.map((id) => this.courseNameCache.get(id));
-    const quotaPerSource = this.mixer instanceof QuotaRoundRobinMixer ? Math.ceil(limit * this.sources.length / batches.length) : void 0;
+    const quotaPerSource = this.mixer instanceof QuotaRoundRobinMixer ? Math.ceil(fetchLimit * this.sources.length / batches.length) : void 0;
     captureMixerRun(
       this.mixer.constructor.name,
       batches,
       sourceIds,
       sourceNames,
-      limit * this.sources.length,
+      fetchLimit * this.sources.length,
       quotaPerSource,
       mixedWeighted
     );
-    const reviewWeighted = mixedWeighted.filter((w) => getCardOrigin(w) === "review");
-    const newWeighted = mixedWeighted.filter((w) => getCardOrigin(w) === "new");
+    const reviewWeighted = mixedWeighted.filter((w) => getCardOrigin(w) === "review").slice(0, this._initialReviewCap);
+    const newWeighted = mixedWeighted.filter((w) => getCardOrigin(w) === "new").slice(0, newLimit);
     logger.debug(`[reviews] got ${reviewWeighted.length} reviews from mixer`);
     let report = replan ? "Replan content:\n" : "Mixed content session created with:\n";
     if (!replan) {