@vue-skuilder/db 0.1.32-c → 0.1.32-e

package/dist/impl/couch/index.js

@@ -863,6 +863,81 @@ var init_PipelineDebugger = __esm({
         }
         console.groupEnd();
       },
+      /**
+       * Show prescribed-related cards from the most recent run.
+       *
+       * Highlights:
+       * - cards directly generated by the prescribed strategy
+       * - blocked prescribed targets mentioned in provenance
+       * - support tags resolved for blocked targets
+       *
+       * @param groupId - Optional prescribed group ID filter (e.g. 'intro-core')
+       */
+      showPrescribed(groupId) {
+        if (runHistory.length === 0) {
+          logger.info("[Pipeline Debug] No runs captured yet.");
+          return;
+        }
+        const run = runHistory[0];
+        const prescribedCards = run.cards.filter(
+          (c) => c.provenance.some((p) => p.strategy === "prescribed")
+        );
+        console.group(`\u{1F9ED} Prescribed Debug (${run.courseId})`);
+        if (prescribedCards.length === 0) {
+          logger.info("No prescribed-generated cards were present in the most recent run.");
+          console.groupEnd();
+          return;
+        }
+        const rows = prescribedCards.map((card) => {
+          const prescribedProv = card.provenance.find((p) => p.strategy === "prescribed");
+          const reason = prescribedProv?.reason ?? "";
+          const parsedGroup = reason.match(/group=([^;]+)/)?.[1] ?? "unknown";
+          const mode = reason.match(/mode=([^;]+)/)?.[1] ?? "unknown";
+          const blocked = reason.match(/blocked=([^;]+)/)?.[1] ?? "unknown";
+          const blockedTargets = reason.match(/blockedTargets=([^;]+)/)?.[1] ?? "none";
+          const supportTags = reason.match(/supportTags=([^;]+)/)?.[1] ?? "none";
+          const multiplier = reason.match(/multiplier=([^;]+)/)?.[1] ?? "unknown";
+          return {
+            group: parsedGroup,
+            mode,
+            cardId: card.cardId,
+            selected: card.selected ? "yes" : "no",
+            finalScore: card.finalScore.toFixed(3),
+            blocked,
+            blockedTargets,
+            supportTags,
+            multiplier
+          };
+        }).filter((row) => !groupId || row.group === groupId).sort((a, b) => Number(b.finalScore) - Number(a.finalScore));
+        if (rows.length === 0) {
+          logger.info(
+            `[Pipeline Debug] No prescribed cards matched group '${groupId}' in the most recent run.`
+          );
+          console.groupEnd();
+          return;
+        }
+        console.table(rows);
+        const selectedRows = rows.filter((r) => r.selected === "yes");
+        const blockedTargetSet = /* @__PURE__ */ new Set();
+        const supportTagSet = /* @__PURE__ */ new Set();
+        for (const row of rows) {
+          if (row.blockedTargets && row.blockedTargets !== "none") {
+            row.blockedTargets.split("|").filter(Boolean).forEach((t) => blockedTargetSet.add(t));
+          }
+          if (row.supportTags && row.supportTags !== "none") {
+            row.supportTags.split("|").filter(Boolean).forEach((t) => supportTagSet.add(t));
+          }
+        }
+        logger.info(`Prescribed cards in run: ${rows.length}`);
+        logger.info(`Selected prescribed cards: ${selectedRows.length}`);
+        logger.info(
+          `Blocked prescribed targets referenced: ${blockedTargetSet.size > 0 ? [...blockedTargetSet].join(", ") : "none"}`
+        );
+        logger.info(
+          `Resolved support tags referenced: ${supportTagSet.size > 0 ? [...supportTagSet].join(", ") : "none"}`
+        );
+        console.groupEnd();
+      },
       /**
        * Show all runs in compact format.
        */
@@ -1011,6 +1086,7 @@ Commands:
   .diagnoseCardSpace()   Scan full card space through filters (async)
   .showRegistry()        Show navigator registry (classes + roles)
   .showStrategies()      Show registry + strategy mapping from last run
+  .showPrescribed(id?)   Show prescribed-generated cards and blocked/support details from last run
   .listRuns()            List all captured runs in table format
   .export()              Export run history as JSON for bug reports
   .clear()               Clear run history
@@ -1034,6 +1110,44 @@ __export(CompositeGenerator_exports, {
   AggregationMode: () => AggregationMode,
   default: () => CompositeGenerator
 });
+function mergeHints(allHints) {
+  const defined = allHints.filter((h) => h !== void 0);
+  if (defined.length === 0) return void 0;
+  const merged = {};
+  const boostTags = {};
+  for (const hints of defined) {
+    for (const [pattern, factor] of Object.entries(hints.boostTags ?? {})) {
+      boostTags[pattern] = (boostTags[pattern] ?? 1) * factor;
+    }
+  }
+  if (Object.keys(boostTags).length > 0) {
+    merged.boostTags = boostTags;
+  }
+  const boostCards = {};
+  for (const hints of defined) {
+    for (const [pattern, factor] of Object.entries(hints.boostCards ?? {})) {
+      boostCards[pattern] = (boostCards[pattern] ?? 1) * factor;
+    }
+  }
+  if (Object.keys(boostCards).length > 0) {
+    merged.boostCards = boostCards;
+  }
+  const concatUnique = (field) => {
+    const values = defined.flatMap((h) => h[field] ?? []);
+    if (values.length > 0) {
+      merged[field] = [...new Set(values)];
+    }
+  };
+  concatUnique("requireTags");
+  concatUnique("requireCards");
+  concatUnique("excludeTags");
+  concatUnique("excludeCards");
+  const labels = defined.map((h) => h._label).filter(Boolean);
+  if (labels.length > 0) {
+    merged._label = labels.join("; ");
+  }
+  return Object.keys(merged).length > 0 ? merged : void 0;
+}
 var AggregationMode, DEFAULT_AGGREGATION_MODE, FREQUENCY_BOOST_FACTOR, CompositeGenerator;
 var init_CompositeGenerator = __esm({
   "src/core/navigators/generators/CompositeGenerator.ts"() {
@@ -1097,17 +1211,18 @@ var init_CompositeGenerator = __esm({
           this.generators.map((g) => g.getWeightedCards(limit, context))
         );
         const generatorSummaries = [];
-        results.forEach((cards, index) => {
+        results.forEach((result, index) => {
+          const cards2 = result.cards;
           const gen = this.generators[index];
           const genName = gen.name || `Generator ${index}`;
-          const newCards = cards.filter((c) => c.provenance[0]?.reason?.includes("new card"));
-          const reviewCards = cards.filter((c) => c.provenance[0]?.reason?.includes("review"));
-          if (cards.length > 0) {
-            const topScore = Math.max(...cards.map((c) => c.score)).toFixed(2);
+          const newCards = cards2.filter((c) => c.provenance[0]?.reason?.includes("new card"));
+          const reviewCards = cards2.filter((c) => c.provenance[0]?.reason?.includes("review"));
+          if (cards2.length > 0) {
+            const topScore = Math.max(...cards2.map((c) => c.score)).toFixed(2);
             const parts = [];
             if (newCards.length > 0) parts.push(`${newCards.length} new`);
             if (reviewCards.length > 0) parts.push(`${reviewCards.length} reviews`);
-            const breakdown = parts.length > 0 ? parts.join(", ") : `${cards.length} cards`;
+            const breakdown = parts.length > 0 ? parts.join(", ") : `${cards2.length} cards`;
             generatorSummaries.push(`${genName}: ${breakdown} (top: ${topScore})`);
           } else {
             generatorSummaries.push(`${genName}: 0 cards`);
@@ -1115,7 +1230,8 @@ var init_CompositeGenerator = __esm({
         });
         logger.info(`[Composite] Generator breakdown: ${generatorSummaries.join(" | ")}`);
         const byCardId = /* @__PURE__ */ new Map();
-        results.forEach((cards, index) => {
+        results.forEach((result, index) => {
+          const cards2 = result.cards;
           const gen = this.generators[index];
           let weight = gen.learnable?.weight ?? 1;
           let deviation;
@@ -1126,7 +1242,7 @@ var init_CompositeGenerator = __esm({
               deviation = context.orchestration.getDeviation(strategyId);
             }
           }
-          for (const card of cards) {
+          for (const card of cards2) {
             if (card.provenance.length > 0) {
               card.provenance[0].effectiveWeight = weight;
               card.provenance[0].deviation = deviation;
@@ -1138,15 +1254,15 @@ var init_CompositeGenerator = __esm({
         });
         const merged = [];
         for (const [, items] of byCardId) {
-          const cards = items.map((i) => i.card);
+          const cards2 = items.map((i) => i.card);
           const aggregatedScore = this.aggregateScores(items);
           const finalScore = Math.min(1, aggregatedScore);
-          const mergedProvenance = cards.flatMap((c) => c.provenance);
-          const initialScore = cards[0].score;
+          const mergedProvenance = cards2.flatMap((c) => c.provenance);
+          const initialScore = cards2[0].score;
           const action = finalScore > initialScore ? "boosted" : finalScore < initialScore ? "penalized" : "passed";
           const reason = this.buildAggregationReason(items, finalScore);
           merged.push({
-            ...cards[0],
+            ...cards2[0],
             score: finalScore,
             provenance: [
               ...mergedProvenance,
@@ -1161,7 +1277,9 @@ var init_CompositeGenerator = __esm({
             ]
           });
         }
-        return merged.sort((a, b) => b.score - a.score).slice(0, limit);
+        const cards = merged.sort((a, b) => b.score - a.score).slice(0, limit);
+        const hints = mergeHints(results.map((result) => result.hints));
+        return { cards, hints };
       }
       /**
        * Build human-readable reason for score aggregation.
@@ -1292,16 +1410,16 @@ var init_elo = __esm({
           };
         });
         scored.sort((a, b) => b.score - a.score);
-        const result = scored.slice(0, limit);
-        if (result.length > 0) {
-          const topScores = result.slice(0, 3).map((c) => c.score.toFixed(2)).join(", ");
+        const cards = scored.slice(0, limit);
+        if (cards.length > 0) {
+          const topScores = cards.slice(0, 3).map((c) => c.score.toFixed(2)).join(", ");
           logger.info(
-            `[ELO] Course ${this.course.getCourseID()}: ${result.length} new cards (top scores: ${topScores})`
+            `[ELO] Course ${this.course.getCourseID()}: ${cards.length} new cards (top scores: ${topScores})`
           );
         } else {
           logger.info(`[ELO] Course ${this.course.getCourseID()}: No new cards available`);
         }
-        return result;
+        return { cards };
       }
     };
   }
@@ -1338,7 +1456,7 @@ function matchesTagPattern(tag, pattern) {
 function pickTopByScore(cards, limit) {
   return [...cards].sort((a, b) => b.score - a.score || a.cardId.localeCompare(b.cardId)).slice(0, limit);
 }
-var DEFAULT_FRESHNESS_WINDOW, DEFAULT_MAX_DIRECT_PER_RUN, DEFAULT_MAX_SUPPORT_PER_RUN, DEFAULT_HIERARCHY_DEPTH, DEFAULT_MIN_COUNT, BASE_TARGET_SCORE, BASE_SUPPORT_SCORE, MAX_TARGET_MULTIPLIER, MAX_SUPPORT_MULTIPLIER, LOCKED_TAG_PREFIXES, LESSON_GATE_PENALTY_TAG_HINT, PrescribedCardsGenerator;
+var DEFAULT_FRESHNESS_WINDOW, DEFAULT_MAX_DIRECT_PER_RUN, DEFAULT_MAX_SUPPORT_PER_RUN, DEFAULT_HIERARCHY_DEPTH, DEFAULT_MIN_COUNT, BASE_TARGET_SCORE, BASE_SUPPORT_SCORE, MAX_TARGET_MULTIPLIER, MAX_SUPPORT_MULTIPLIER, LOCKED_TAG_PREFIXES, LESSON_GATE_PENALTY_TAG_HINT, PRESCRIBED_DEBUG_VERSION, PrescribedCardsGenerator;
 var init_prescribed = __esm({
   "src/core/navigators/generators/prescribed.ts"() {
     "use strict";
@@ -1355,6 +1473,7 @@ var init_prescribed = __esm({
     MAX_SUPPORT_MULTIPLIER = 4;
     LOCKED_TAG_PREFIXES = ["concept:"];
     LESSON_GATE_PENALTY_TAG_HINT = "concept:";
+    PRESCRIBED_DEBUG_VERSION = "testversion-prescribed-v2";
     PrescribedCardsGenerator = class extends ContentNavigator {
       name;
       config;
@@ -1371,7 +1490,7 @@ var init_prescribed = __esm({
       }
       async getWeightedCards(limit, context) {
         if (this.config.groups.length === 0 || limit <= 0) {
-          return [];
+          return { cards: [] };
         }
         const courseId = this.course.getCourseID();
         const activeCards = await this.user.getActiveCards();
@@ -1396,6 +1515,7 @@ var init_prescribed = __esm({
         };
         const emitted = [];
         const emittedIds = /* @__PURE__ */ new Set();
+        const groupRuntimes = [];
         for (const group of this.config.groups) {
           const runtime = this.buildGroupRuntimeState({
             group,
@@ -1407,6 +1527,7 @@ var init_prescribed = __esm({
             userTagElo,
             userGlobalElo
           });
+          groupRuntimes.push(runtime);
           nextState.groups[group.id] = this.buildNextGroupState(runtime, progress.groups[group.id]);
           const directCards = this.buildDirectTargetCards(
             runtime,
@@ -1420,12 +1541,17 @@ var init_prescribed = __esm({
           );
           emitted.push(...directCards, ...supportCards);
         }
+        const hintSummary = this.buildSupportHintSummary(groupRuntimes);
+        const hints = Object.keys(hintSummary.boostTags).length > 0 ? {
+          boostTags: hintSummary.boostTags,
+          _label: `prescribed-support (${hintSummary.supportTags.length} tags; blocked=${hintSummary.blockedTargetIds.length}; testversion=${PRESCRIBED_DEBUG_VERSION})`
+        } : void 0;
         if (emitted.length === 0) {
           logger.debug("[Prescribed] No prescribed targets/support emitted this run");
           await this.putStrategyState(nextState).catch((e) => {
             logger.debug(`[Prescribed] Failed to persist empty-state update: ${e}`);
           });
-          return [];
+          return hints ? { cards: [], hints } : { cards: [] };
         }
         const finalCards = pickTopByScore(emitted, limit);
         const surfacedByGroup = /* @__PURE__ */ new Map();
@@ -1456,7 +1582,27 @@ var init_prescribed = __esm({
         logger.info(
           `[Prescribed] Emitting ${finalCards.length} cards (${finalCards.filter((c) => c.provenance[0]?.reason.includes("mode=target")).length} target, ${finalCards.filter((c) => c.provenance[0]?.reason.includes("mode=support")).length} support)`
         );
-        return finalCards;
+        return hints ? { cards: finalCards, hints } : { cards: finalCards };
+      }
+      buildSupportHintSummary(groupRuntimes) {
+        const boostTags = {};
+        const blockedTargetIds = /* @__PURE__ */ new Set();
+        const supportTags = /* @__PURE__ */ new Set();
+        for (const runtime of groupRuntimes) {
+          if (runtime.blockedTargets.length === 0 || runtime.supportTags.length === 0) {
+            continue;
+          }
+          runtime.blockedTargets.forEach((cardId) => blockedTargetIds.add(cardId));
+          for (const tag of runtime.supportTags) {
+            supportTags.add(tag);
+            boostTags[tag] = (boostTags[tag] ?? 1) * runtime.supportMultiplier;
+          }
+        }
+        return {
+          boostTags,
+          blockedTargetIds: [...blockedTargetIds].sort(),
+          supportTags: [...supportTags].sort()
+        };
       }
       parseConfig(serializedData) {
         try {
@@ -1539,7 +1685,22 @@ var init_prescribed = __esm({
             group.hierarchyWalk?.enabled !== false,
             group.hierarchyWalk?.maxDepth ?? DEFAULT_HIERARCHY_DEPTH
           );
-          if (resolution.blocked) {
+          const introTags = tags.filter((tag) => tag.startsWith("gpc:intro:"));
+          const exposeTags = new Set(tags.filter((tag) => tag.startsWith("gpc:expose:")));
+          for (const introTag of introTags) {
+            const suffix = introTag.slice("gpc:intro:".length);
+            if (suffix) {
+              exposeTags.add(`gpc:expose:${suffix}`);
+            }
+          }
+          const unmetExposeTags = [...exposeTags].filter((tag) => {
+            const tagElo = userTagElo[tag];
+            return !tagElo || tagElo.count < DEFAULT_MIN_COUNT;
+          });
+          if (unmetExposeTags.length > 0) {
+            unmetExposeTags.forEach((tag) => supportTags.add(tag));
+          }
+          if (resolution.blocked || unmetExposeTags.length > 0) {
             blockedTargets.push(cardId);
             resolution.supportTags.forEach((t) => supportTags.add(t));
           } else {
@@ -1569,7 +1730,8 @@ var init_prescribed = __esm({
           supportCandidates,
           supportTags: [...supportTags],
           pressureMultiplier,
-          supportMultiplier
+          supportMultiplier,
+          debugVersion: PRESCRIBED_DEBUG_VERSION
         };
       }
       buildNextGroupState(runtime, prior) {
@@ -1577,6 +1739,7 @@ var init_prescribed = __esm({
         const surfacedThisRun = false;
         return {
           encounteredCardIds: [...runtime.encounteredTargets].sort(),
+          pendingTargetIds: [...runtime.pendingTargets].sort(),
           lastSurfacedAt: prior?.lastSurfacedAt ?? null,
           sessionsSinceSurfaced: surfacedThisRun ? 0 : carriedSessions + 1,
           lastSupportAt: prior?.lastSupportAt ?? null,
@@ -1601,7 +1764,7 @@ var init_prescribed = __esm({
                 strategyId: this.strategyId || "NAVIGATION_STRATEGY-prescribed",
                 action: "generated",
                 score: BASE_TARGET_SCORE * runtime.pressureMultiplier,
-                reason: `mode=target;group=${runtime.group.id};pending=${runtime.pendingTargets.length};surfaceable=${runtime.surfaceableTargets.length};blocked=${runtime.blockedTargets.length};multiplier=${runtime.pressureMultiplier.toFixed(2)}`
+                reason: `mode=target;group=${runtime.group.id};pending=${runtime.pendingTargets.length};surfaceable=${runtime.surfaceableTargets.length};blocked=${runtime.blockedTargets.length};blockedTargets=${runtime.blockedTargets.join("|") || "none"};supportTags=${runtime.supportTags.join("|") || "none"};multiplier=${runtime.pressureMultiplier.toFixed(2)};testversion=${runtime.debugVersion}`
               }
             ]
           });
@@ -1628,7 +1791,7 @@ var init_prescribed = __esm({
                 strategyId: this.strategyId || "NAVIGATION_STRATEGY-prescribed",
                 action: "generated",
                 score: BASE_SUPPORT_SCORE * runtime.supportMultiplier,
-                reason: `mode=support;group=${runtime.group.id};blocked=${runtime.blockedTargets.length};supportTags=${runtime.supportTags.join("|") || "none"};multiplier=${runtime.supportMultiplier.toFixed(2)}`
+                reason: `mode=support;group=${runtime.group.id};pending=${runtime.pendingTargets.length};blocked=${runtime.blockedTargets.length};blockedTargets=${runtime.blockedTargets.join("|") || "none"};supportCard=${cardId};supportTags=${runtime.supportTags.join("|") || "none"};multiplier=${runtime.supportMultiplier.toFixed(2)};testversion=${runtime.debugVersion}`
               }
             ]
           });
@@ -1658,35 +1821,43 @@ var init_prescribed = __esm({
         return [...candidates];
       }
       resolveBlockedSupportTags(targetTags, hierarchyConfigs, userTagElo, userGlobalElo, hierarchyWalkEnabled, maxDepth) {
-        if (!hierarchyWalkEnabled || targetTags.length === 0 || hierarchyConfigs.length === 0) {
-          return {
-            blocked: false,
-            supportTags: []
-          };
-        }
         const supportTags = /* @__PURE__ */ new Set();
         let blocked = false;
         for (const targetTag of targetTags) {
-          for (const hierarchy of hierarchyConfigs) {
-            const prereqs = hierarchy.prerequisites[targetTag];
-            if (!prereqs || prereqs.length === 0) continue;
-            const unmet = prereqs.filter(
-              (pr) => !this.isPrerequisiteMet(pr, userTagElo[pr.tag], userGlobalElo)
-            );
-            if (unmet.length === 0) {
-              continue;
+          const prereqSets = hierarchyConfigs.map((hierarchy) => hierarchy.prerequisites[targetTag]).filter((prereqs) => Array.isArray(prereqs) && prereqs.length > 0);
+          if (prereqSets.length === 0) {
+            continue;
+          }
+          const tagBlocked = prereqSets.some(
+            (prereqs) => prereqs.some((pr) => !this.isPrerequisiteMet(pr, userTagElo[pr.tag], userGlobalElo))
+          );
+          if (!tagBlocked) {
+            continue;
+          }
+          blocked = true;
+          if (!hierarchyWalkEnabled) {
+            for (const prereqs of prereqSets) {
+              for (const prereq of prereqs) {
+                if (!this.isPrerequisiteMet(prereq, userTagElo[prereq.tag], userGlobalElo)) {
+                  supportTags.add(prereq.tag);
+                }
+              }
             }
-            blocked = true;
-            for (const prereq of unmet) {
-              this.collectSupportTagsRecursive(
-                prereq.tag,
-                hierarchyConfigs,
-                userTagElo,
-                userGlobalElo,
-                maxDepth,
-                /* @__PURE__ */ new Set(),
-                supportTags
-              );
+            continue;
+          }
+          for (const prereqs of prereqSets) {
+            for (const prereq of prereqs) {
+              if (!this.isPrerequisiteMet(prereq, userTagElo[prereq.tag], userGlobalElo)) {
+                this.collectSupportTagsRecursive(
+                  prereq.tag,
+                  hierarchyConfigs,
+                  userTagElo,
+                  userGlobalElo,
+                  maxDepth,
+                  /* @__PURE__ */ new Set(),
+                  supportTags
+                );
+              }
             }
           }
         }
@@ -1841,7 +2012,7 @@ var init_srs = __esm({
             ]
           };
         });
-        return scored.sort((a, b) => b.score - a.score).slice(0, limit);
+        return { cards: scored.sort((a, b) => b.score - a.score).slice(0, limit) };
       }
       /**
        * Compute backlog pressure based on number of due reviews.
@@ -2894,1725 +3065,138 @@ __export(userGoalStub_exports, {
 var USER_GOAL_NAVIGATOR_STUB;
 var init_userGoalStub = __esm({
   "src/core/navigators/filters/userGoalStub.ts"() {
-    "use strict";
-    USER_GOAL_NAVIGATOR_STUB = true;
-  }
-});
-
-// import("./filters/**/*") in src/core/navigators/index.ts
-var globImport_filters;
-var init_2 = __esm({
-  'import("./filters/**/*") in src/core/navigators/index.ts'() {
-    globImport_filters = __glob({
-      "./filters/WeightedFilter.ts": () => Promise.resolve().then(() => (init_WeightedFilter(), WeightedFilter_exports)),
-      "./filters/eloDistance.ts": () => Promise.resolve().then(() => (init_eloDistance(), eloDistance_exports)),
-      "./filters/hierarchyDefinition.ts": () => Promise.resolve().then(() => (init_hierarchyDefinition(), hierarchyDefinition_exports)),
-      "./filters/index.ts": () => Promise.resolve().then(() => (init_filters(), filters_exports)),
-      "./filters/inferredPreferenceStub.ts": () => Promise.resolve().then(() => (init_inferredPreferenceStub(), inferredPreferenceStub_exports)),
-      "./filters/interferenceMitigator.ts": () => Promise.resolve().then(() => (init_interferenceMitigator(), interferenceMitigator_exports)),
-      "./filters/relativePriority.ts": () => Promise.resolve().then(() => (init_relativePriority(), relativePriority_exports)),
-      "./filters/types.ts": () => Promise.resolve().then(() => (init_types2(), types_exports2)),
-      "./filters/userGoalStub.ts": () => Promise.resolve().then(() => (init_userGoalStub(), userGoalStub_exports)),
-      "./filters/userTagPreference.ts": () => Promise.resolve().then(() => (init_userTagPreference(), userTagPreference_exports))
-    });
-  }
-});
-
-// src/core/orchestration/gradient.ts
-var init_gradient = __esm({
-  "src/core/orchestration/gradient.ts"() {
-    "use strict";
-    init_logger();
-  }
-});
-
-// src/core/orchestration/learning.ts
-var init_learning = __esm({
-  "src/core/orchestration/learning.ts"() {
-    "use strict";
-    init_contentNavigationStrategy();
-    init_types_legacy();
-    init_logger();
-  }
-});
-
-// src/core/orchestration/signal.ts
-var init_signal = __esm({
-  "src/core/orchestration/signal.ts"() {
-    "use strict";
-  }
-});
-
-// src/core/orchestration/recording.ts
-var init_recording = __esm({
-  "src/core/orchestration/recording.ts"() {
-    "use strict";
-    init_signal();
-    init_types_legacy();
-    init_logger();
-  }
-});
-
-// src/core/orchestration/index.ts
-function fnv1a(str) {
-  let hash = 2166136261;
-  for (let i = 0; i < str.length; i++) {
-    hash ^= str.charCodeAt(i);
-    hash = Math.imul(hash, 16777619);
-  }
-  return hash >>> 0;
-}
-function computeDeviation(userId, strategyId, salt) {
-  const input = `${userId}:${strategyId}:${salt}`;
-  const hash = fnv1a(input);
-  const normalized = hash / 4294967296;
-  return normalized * 2 - 1;
-}
-function computeSpread(confidence) {
-  const clampedConfidence = Math.max(0, Math.min(1, confidence));
-  return MAX_SPREAD - clampedConfidence * (MAX_SPREAD - MIN_SPREAD);
-}
-function computeEffectiveWeight(learnable, userId, strategyId, salt) {
-  const deviation = computeDeviation(userId, strategyId, salt);
-  const spread = computeSpread(learnable.confidence);
-  const adjustment = deviation * spread * learnable.weight;
-  const effective = learnable.weight + adjustment;
-  return Math.max(MIN_WEIGHT, Math.min(MAX_WEIGHT, effective));
-}
-async function createOrchestrationContext(user, course) {
-  let courseConfig;
-  try {
-    courseConfig = await course.getCourseConfig();
-  } catch (e) {
-    logger.error(`[Orchestration] Failed to load course config: ${e}`);
-    courseConfig = {
-      name: "Unknown",
-      description: "",
-      public: false,
-      deleted: false,
-      creator: "",
-      admins: [],
-      moderators: [],
-      dataShapes: [],
-      questionTypes: [],
-      orchestration: { salt: "default" }
-    };
-  }
-  const userId = user.getUsername();
-  const salt = courseConfig.orchestration?.salt || "default_salt";
-  return {
-    user,
-    course,
-    userId,
-    courseConfig,
-    getEffectiveWeight(strategyId, learnable) {
-      return computeEffectiveWeight(learnable, userId, strategyId, salt);
-    },
-    getDeviation(strategyId) {
-      return computeDeviation(userId, strategyId, salt);
-    }
-  };
-}
-var MIN_SPREAD, MAX_SPREAD, MIN_WEIGHT, MAX_WEIGHT;
-var init_orchestration = __esm({
-  "src/core/orchestration/index.ts"() {
-    "use strict";
-    init_logger();
-    init_gradient();
-    init_learning();
-    init_signal();
-    init_recording();
-    MIN_SPREAD = 0.1;
-    MAX_SPREAD = 0.5;
-    MIN_WEIGHT = 0.1;
-    MAX_WEIGHT = 3;
-  }
-});
-
-// src/core/util/index.ts
-function getCardHistoryID(courseID, cardID) {
-  return `${DocTypePrefixes["CARDRECORD" /* CARDRECORD */]}-${courseID}-${cardID}`;
-}
-var init_util = __esm({
-  "src/core/util/index.ts"() {
-    "use strict";
-    init_types_legacy();
-  }
-});
-
-// src/study/SpacedRepetition.ts
-var import_moment2, import_common8, duration;
-var init_SpacedRepetition = __esm({
-  "src/study/SpacedRepetition.ts"() {
-    "use strict";
-    init_util();
-    import_moment2 = __toESM(require("moment"), 1);
-    import_common8 = require("@vue-skuilder/common");
-    init_logger();
-    duration = import_moment2.default.duration;
-  }
-});
-
-// src/study/services/SrsService.ts
-var import_moment3;
-var init_SrsService = __esm({
-  "src/study/services/SrsService.ts"() {
-    "use strict";
-    import_moment3 = __toESM(require("moment"), 1);
-    init_couch();
-    init_SpacedRepetition();
-    init_logger();
-  }
-});
-
-// src/study/services/EloService.ts
-var import_common9;
-var init_EloService = __esm({
-  "src/study/services/EloService.ts"() {
-    "use strict";
-    import_common9 = require("@vue-skuilder/common");
-    init_logger();
-  }
-});
-
-// src/study/services/ResponseProcessor.ts
-var import_common10;
-var init_ResponseProcessor = __esm({
-  "src/study/services/ResponseProcessor.ts"() {
-    "use strict";
-    init_core();
-    init_logger();
-    import_common10 = require("@vue-skuilder/common");
-  }
-});
-
-// src/study/services/CardHydrationService.ts
-var import_common11;
-var init_CardHydrationService = __esm({
-  "src/study/services/CardHydrationService.ts"() {
-    "use strict";
-    import_common11 = require("@vue-skuilder/common");
-    init_logger();
-  }
-});
-
-// src/study/ItemQueue.ts
-var init_ItemQueue = __esm({
-  "src/study/ItemQueue.ts"() {
-    "use strict";
-  }
-});
-
-// src/util/packer/types.ts
-var init_types3 = __esm({
-  "src/util/packer/types.ts"() {
-    "use strict";
-  }
-});
-
-// src/util/packer/CouchDBToStaticPacker.ts
-var init_CouchDBToStaticPacker = __esm({
-  "src/util/packer/CouchDBToStaticPacker.ts"() {
-    "use strict";
-    init_types_legacy();
-    init_logger();
-  }
-});
-
-// src/util/packer/index.ts
-var init_packer = __esm({
-  "src/util/packer/index.ts"() {
-    "use strict";
-    init_types3();
-    init_CouchDBToStaticPacker();
-  }
-});
-
-// src/util/migrator/types.ts
-var DEFAULT_MIGRATION_OPTIONS;
-var init_types4 = __esm({
-  "src/util/migrator/types.ts"() {
-    "use strict";
-    DEFAULT_MIGRATION_OPTIONS = {
-      chunkBatchSize: 100,
-      validateRoundTrip: false,
-      cleanupOnFailure: true,
-      timeout: 3e5
-      // 5 minutes
-    };
-  }
-});
-
-// src/util/migrator/FileSystemAdapter.ts
-var FileSystemError;
-var init_FileSystemAdapter = __esm({
-  "src/util/migrator/FileSystemAdapter.ts"() {
-    "use strict";
-    FileSystemError = class extends Error {
-      constructor(message, operation, filePath, cause) {
-        super(message);
-        this.operation = operation;
-        this.filePath = filePath;
-        this.cause = cause;
-        this.name = "FileSystemError";
-      }
-    };
-  }
-});
-
-// src/util/migrator/validation.ts
-async function validateStaticCourse(staticPath, fs) {
-  const validation = {
-    valid: true,
-    manifestExists: false,
-    chunksExist: false,
-    attachmentsExist: false,
-    errors: [],
-    warnings: []
-  };
-  try {
-    if (fs) {
-      const stats = await fs.stat(staticPath);
-      if (!stats.isDirectory()) {
-        validation.errors.push(`Path is not a directory: ${staticPath}`);
-        validation.valid = false;
-        return validation;
-      }
-    } else if (!nodeFS) {
-      validation.errors.push("File system access not available - validation skipped");
-      validation.valid = false;
-      return validation;
-    } else {
-      const stats = await nodeFS.promises.stat(staticPath);
-      if (!stats.isDirectory()) {
-        validation.errors.push(`Path is not a directory: ${staticPath}`);
-        validation.valid = false;
-        return validation;
-      }
-    }
-    let manifestPath = `${staticPath}/manifest.json`;
-    try {
-      if (fs) {
-        manifestPath = fs.joinPath(staticPath, "manifest.json");
-        if (await fs.exists(manifestPath)) {
-          validation.manifestExists = true;
-          const manifestContent = await fs.readFile(manifestPath);
-          const manifest = JSON.parse(manifestContent);
-          validation.courseId = manifest.courseId;
-          validation.courseName = manifest.courseName;
-          if (!manifest.version || !manifest.courseId || !manifest.chunks || !Array.isArray(manifest.chunks)) {
-            validation.errors.push("Invalid manifest structure");
-            validation.valid = false;
-          }
-        } else {
-          validation.errors.push(`Manifest not found: ${manifestPath}`);
-          validation.valid = false;
-        }
-      } else {
-        manifestPath = `${staticPath}/manifest.json`;
-        await nodeFS.promises.access(manifestPath);
-        validation.manifestExists = true;
-        const manifestContent = await nodeFS.promises.readFile(manifestPath, "utf8");
-        const manifest = JSON.parse(manifestContent);
-        validation.courseId = manifest.courseId;
-        validation.courseName = manifest.courseName;
-        if (!manifest.version || !manifest.courseId || !manifest.chunks || !Array.isArray(manifest.chunks)) {
-          validation.errors.push("Invalid manifest structure");
-          validation.valid = false;
-        }
-      }
-    } catch (error) {
-      const errorMessage = error instanceof FileSystemError ? error.message : `Manifest not found or invalid: ${manifestPath}`;
-      validation.errors.push(errorMessage);
-      validation.valid = false;
-    }
-    let chunksPath = `${staticPath}/chunks`;
-    try {
-      if (fs) {
-        chunksPath = fs.joinPath(staticPath, "chunks");
-        if (await fs.exists(chunksPath)) {
-          const chunksStats = await fs.stat(chunksPath);
-          if (chunksStats.isDirectory()) {
-            validation.chunksExist = true;
-          } else {
-            validation.errors.push(`Chunks path is not a directory: ${chunksPath}`);
-            validation.valid = false;
-          }
-        } else {
-          validation.errors.push(`Chunks directory not found: ${chunksPath}`);
-          validation.valid = false;
-        }
-      } else {
-        chunksPath = `${staticPath}/chunks`;
-        const chunksStats = await nodeFS.promises.stat(chunksPath);
-        if (chunksStats.isDirectory()) {
-          validation.chunksExist = true;
-        } else {
-          validation.errors.push(`Chunks path is not a directory: ${chunksPath}`);
-          validation.valid = false;
-        }
-      }
-    } catch (error) {
-      const errorMessage = error instanceof FileSystemError ? error.message : `Chunks directory not found: ${chunksPath}`;
-      validation.errors.push(errorMessage);
-      validation.valid = false;
-    }
-    let attachmentsPath;
-    try {
-      if (fs) {
-        attachmentsPath = fs.joinPath(staticPath, "attachments");
-        if (await fs.exists(attachmentsPath)) {
-          const attachmentsStats = await fs.stat(attachmentsPath);
-          if (attachmentsStats.isDirectory()) {
-            validation.attachmentsExist = true;
-          }
-        } else {
-          validation.warnings.push(
-            `Attachments directory not found: ${attachmentsPath} (this is OK if course has no attachments)`
-          );
-        }
-      } else {
-        attachmentsPath = `${staticPath}/attachments`;
-        const attachmentsStats = await nodeFS.promises.stat(attachmentsPath);
-        if (attachmentsStats.isDirectory()) {
-          validation.attachmentsExist = true;
-        }
-      }
-    } catch (error) {
-      attachmentsPath = attachmentsPath || `${staticPath}/attachments`;
-      const warningMessage = error instanceof FileSystemError ? error.message : `Attachments directory not found: ${attachmentsPath} (this is OK if course has no attachments)`;
-      validation.warnings.push(warningMessage);
-    }
-  } catch (error) {
-    validation.errors.push(
-      `Failed to validate static course: ${error instanceof Error ? error.message : String(error)}`
-    );
-    validation.valid = false;
-  }
-  return validation;
-}
-async function validateMigration(targetDB, expectedCounts, manifest) {
-  const validation = {
-    valid: true,
-    documentCountMatch: false,
-    attachmentIntegrity: false,
-    viewFunctionality: false,
-    issues: []
-  };
-  try {
-    logger.info("Starting migration validation...");
-    const actualCounts = await getActualDocumentCounts(targetDB);
-    validation.documentCountMatch = compareDocumentCounts(
-      expectedCounts,
-      actualCounts,
-      validation.issues
-    );
-    await validateCourseConfig(targetDB, manifest, validation.issues);
-    validation.viewFunctionality = await validateViews(targetDB, manifest, validation.issues);
-    validation.attachmentIntegrity = await validateAttachmentIntegrity(targetDB, validation.issues);
-    validation.valid = validation.documentCountMatch && validation.viewFunctionality && validation.attachmentIntegrity;
-    logger.info(`Migration validation completed. Valid: ${validation.valid}`);
-    if (validation.issues.length > 0) {
-      logger.info(`Validation issues: ${validation.issues.length}`);
-      validation.issues.forEach((issue) => {
-        if (issue.type === "error") {
-          logger.error(`${issue.category}: ${issue.message}`);
-        } else {
-          logger.warn(`${issue.category}: ${issue.message}`);
-        }
-      });
-    }
-  } catch (error) {
-    validation.valid = false;
-    validation.issues.push({
-      type: "error",
-      category: "metadata",
-      message: `Validation failed: ${error instanceof Error ? error.message : String(error)}`
-    });
-  }
-  return validation;
-}
-async function getActualDocumentCounts(db) {
-  const counts = {};
-  try {
-    const allDocs = await db.allDocs({ include_docs: true });
-    for (const row of allDocs.rows) {
-      if (row.id.startsWith("_design/")) {
-        counts["_design"] = (counts["_design"] || 0) + 1;
-        continue;
-      }
-      const doc = row.doc;
-      if (doc && doc.docType) {
-        counts[doc.docType] = (counts[doc.docType] || 0) + 1;
-      } else {
-        counts["unknown"] = (counts["unknown"] || 0) + 1;
-      }
-    }
-  } catch (error) {
-    logger.error("Failed to get actual document counts:", error);
-  }
-  return counts;
-}
-function compareDocumentCounts(expected, actual, issues) {
-  let countsMatch = true;
-  for (const [docType, expectedCount] of Object.entries(expected)) {
-    const actualCount = actual[docType] || 0;
-    if (actualCount !== expectedCount) {
-      countsMatch = false;
-      issues.push({
-        type: "error",
-        category: "documents",
-        message: `Document count mismatch for ${docType}: expected ${expectedCount}, got ${actualCount}`
-      });
-    }
-  }
-  for (const [docType, actualCount] of Object.entries(actual)) {
-    if (!expected[docType] && docType !== "_design") {
-      issues.push({
-        type: "warning",
-        category: "documents",
-        message: `Unexpected document type found: ${docType} (${actualCount} documents)`
-      });
-    }
-  }
-  return countsMatch;
-}
-async function validateCourseConfig(db, manifest, issues) {
-  try {
-    const courseConfig = await db.get("CourseConfig");
-    if (!courseConfig) {
-      issues.push({
-        type: "error",
-        category: "course_config",
-        message: "CourseConfig document not found after migration"
-      });
-      return;
-    }
-    if (!courseConfig.courseID) {
-      issues.push({
-        type: "warning",
-        category: "course_config",
-        message: "CourseConfig document missing courseID field"
-      });
-    }
-    if (courseConfig.courseID !== manifest.courseId) {
-      issues.push({
-        type: "warning",
-        category: "course_config",
-        message: `CourseConfig courseID mismatch: expected ${manifest.courseId}, got ${courseConfig.courseID}`
-      });
-    }
-    logger.debug("CourseConfig document validation passed");
-  } catch (error) {
-    if (error.status === 404) {
-      issues.push({
-        type: "error",
-        category: "course_config",
-        message: "CourseConfig document not found in database"
-      });
-    } else {
-      issues.push({
-        type: "error",
-        category: "course_config",
-        message: `Failed to validate CourseConfig document: ${error instanceof Error ? error.message : String(error)}`
-      });
-    }
-  }
-}
-async function validateViews(db, manifest, issues) {
-  let viewsValid = true;
-  try {
-    for (const designDoc of manifest.designDocs) {
-      try {
-        const doc = await db.get(designDoc._id);
-        if (!doc) {
-          viewsValid = false;
-          issues.push({
-            type: "error",
-            category: "views",
-            message: `Design document not found: ${designDoc._id}`
-          });
-          continue;
-        }
-        for (const viewName of Object.keys(designDoc.views)) {
-          try {
-            const viewPath = `${designDoc._id}/${viewName}`;
-            await db.query(viewPath, { limit: 1 });
-          } catch (viewError) {
-            viewsValid = false;
-            issues.push({
-              type: "error",
-              category: "views",
-              message: `View not accessible: ${designDoc._id}/${viewName} - ${viewError}`
-            });
-          }
-        }
-      } catch (error) {
-        viewsValid = false;
-        issues.push({
-          type: "error",
-          category: "views",
-          message: `Failed to validate design document ${designDoc._id}: ${error}`
-        });
-      }
-    }
-  } catch (error) {
-    viewsValid = false;
-    issues.push({
-      type: "error",
-      category: "views",
-      message: `View validation failed: ${error instanceof Error ? error.message : String(error)}`
-    });
-  }
-  return viewsValid;
-}
-async function validateAttachmentIntegrity(db, issues) {
-  let attachmentsValid = true;
-  try {
-    const allDocs = await db.allDocs({
-      include_docs: true,
-      limit: 10
-      // Sample first 10 documents for performance
-    });
-    let attachmentCount = 0;
-    let validAttachments = 0;
-    for (const row of allDocs.rows) {
-      const doc = row.doc;
-      if (doc && doc._attachments) {
-        for (const [attachmentName, _attachmentMeta] of Object.entries(doc._attachments)) {
-          attachmentCount++;
-          try {
-            const attachment = await db.getAttachment(doc._id, attachmentName);
-            if (attachment) {
-              validAttachments++;
-            }
-          } catch (attachmentError) {
-            attachmentsValid = false;
-            issues.push({
-              type: "error",
-              category: "attachments",
-              message: `Attachment not accessible: ${doc._id}/${attachmentName} - ${attachmentError}`
-            });
-          }
-        }
-      }
-    }
-    if (attachmentCount === 0) {
-      issues.push({
-        type: "warning",
-        category: "attachments",
-        message: "No attachments found in sampled documents"
-      });
-    } else {
-      logger.info(`Validated ${validAttachments}/${attachmentCount} sampled attachments`);
-    }
-  } catch (error) {
-    attachmentsValid = false;
-    issues.push({
-      type: "error",
-      category: "attachments",
-      message: `Attachment validation failed: ${error instanceof Error ? error.message : String(error)}`
-    });
-  }
-  return attachmentsValid;
-}
-var nodeFS;
-var init_validation = __esm({
-  "src/util/migrator/validation.ts"() {
-    "use strict";
-    init_logger();
-    init_FileSystemAdapter();
-    nodeFS = null;
-    try {
-      if (typeof window === "undefined" && typeof process !== "undefined" && process.versions?.node) {
-        nodeFS = eval("require")("fs");
-        nodeFS.promises = nodeFS.promises || eval("require")("fs").promises;
-      }
-    } catch {
-    }
-  }
-});
-
-// src/util/migrator/StaticToCouchDBMigrator.ts
-var nodeFS2, nodePath, StaticToCouchDBMigrator;
-var init_StaticToCouchDBMigrator = __esm({
-  "src/util/migrator/StaticToCouchDBMigrator.ts"() {
-    "use strict";
-    init_logger();
-    init_types4();
-    init_validation();
-    init_FileSystemAdapter();
-    nodeFS2 = null;
-    nodePath = null;
-    try {
-      if (typeof window === "undefined" && typeof process !== "undefined" && process.versions?.node) {
-        nodeFS2 = eval("require")("fs");
-        nodePath = eval("require")("path");
-        nodeFS2.promises = nodeFS2.promises || eval("require")("fs").promises;
-      }
-    } catch {
-    }
-    StaticToCouchDBMigrator = class {
-      options;
-      progressCallback;
-      fs;
-      constructor(options = {}, fileSystemAdapter) {
-        this.options = {
-          ...DEFAULT_MIGRATION_OPTIONS,
-          ...options
-        };
-        this.fs = fileSystemAdapter;
-      }
-      /**
-       * Set a progress callback to receive updates during migration
-       */
-      setProgressCallback(callback) {
-        this.progressCallback = callback;
-      }
-      /**
-       * Migrate a static course to CouchDB
-       */
-      async migrateCourse(staticPath, targetDB) {
-        const startTime = Date.now();
-        const result = {
-          success: false,
-          documentsRestored: 0,
-          attachmentsRestored: 0,
-          designDocsRestored: 0,
-          courseConfigRestored: 0,
-          errors: [],
-          warnings: [],
-          migrationTime: 0
-        };
-        try {
-          logger.info(`Starting migration from ${staticPath} to CouchDB`);
-          this.reportProgress("manifest", 0, 1, "Validating static course...");
-          const validation = await validateStaticCourse(staticPath, this.fs);
-          if (!validation.valid) {
-            result.errors.push(...validation.errors);
-            throw new Error(`Static course validation failed: ${validation.errors.join(", ")}`);
-          }
-          result.warnings.push(...validation.warnings);
-          this.reportProgress("manifest", 1, 1, "Loading course manifest...");
-          const manifest = await this.loadManifest(staticPath);
-          logger.info(`Loaded manifest for course: ${manifest.courseId} (${manifest.courseName})`);
-          this.reportProgress(
-            "design_docs",
-            0,
-            manifest.designDocs.length,
-            "Restoring design documents..."
-          );
-          const designDocResults = await this.restoreDesignDocuments(manifest.designDocs, targetDB);
-          result.designDocsRestored = designDocResults.restored;
-          result.errors.push(...designDocResults.errors);
-          result.warnings.push(...designDocResults.warnings);
-          this.reportProgress("course_config", 0, 1, "Restoring CourseConfig document...");
-          const courseConfigResults = await this.restoreCourseConfig(manifest, targetDB);
-          result.courseConfigRestored = courseConfigResults.restored;
-          result.errors.push(...courseConfigResults.errors);
-          result.warnings.push(...courseConfigResults.warnings);
-          this.reportProgress("course_config", 1, 1, "CourseConfig document restored");
-          const expectedCounts = this.calculateExpectedCounts(manifest);
-          this.reportProgress(
-            "documents",
-            0,
-            manifest.documentCount,
-            "Aggregating documents from chunks..."
-          );
-          const documents = await this.aggregateDocuments(staticPath, manifest);
-          const filteredDocuments = documents.filter((doc) => doc._id !== "CourseConfig");
-          if (documents.length !== filteredDocuments.length) {
-            result.warnings.push(
-              `Filtered out ${documents.length - filteredDocuments.length} CourseConfig document(s) from chunks to prevent conflicts`
-            );
-          }
-          this.reportProgress(
-            "documents",
-            filteredDocuments.length,
-            manifest.documentCount,
-            "Uploading documents to CouchDB..."
-          );
-          const docResults = await this.uploadDocuments(filteredDocuments, targetDB);
-          result.documentsRestored = docResults.restored;
-          result.errors.push(...docResults.errors);
-          result.warnings.push(...docResults.warnings);
-          const docsWithAttachments = documents.filter(
-            (doc) => doc._attachments && Object.keys(doc._attachments).length > 0
-          );
-          this.reportProgress("attachments", 0, docsWithAttachments.length, "Uploading attachments...");
-          const attachmentResults = await this.uploadAttachments(
-            staticPath,
-            docsWithAttachments,
-            targetDB
-          );
-          result.attachmentsRestored = attachmentResults.restored;
-          result.errors.push(...attachmentResults.errors);
-          result.warnings.push(...attachmentResults.warnings);
-          if (this.options.validateRoundTrip) {
-            this.reportProgress("validation", 0, 1, "Validating migration...");
-            const validationResult = await validateMigration(targetDB, expectedCounts, manifest);
-            if (!validationResult.valid) {
-              result.warnings.push("Migration validation found issues");
-              validationResult.issues.forEach((issue) => {
-                if (issue.type === "error") {
-                  result.errors.push(`Validation: ${issue.message}`);
-                } else {
-                  result.warnings.push(`Validation: ${issue.message}`);
-                }
-              });
-            }
-            this.reportProgress("validation", 1, 1, "Migration validation completed");
-          }
-          result.success = result.errors.length === 0;
-          result.migrationTime = Date.now() - startTime;
-          logger.info(`Migration completed in ${result.migrationTime}ms`);
-          logger.info(`Documents restored: ${result.documentsRestored}`);
-          logger.info(`Attachments restored: ${result.attachmentsRestored}`);
-          logger.info(`Design docs restored: ${result.designDocsRestored}`);
-          logger.info(`CourseConfig restored: ${result.courseConfigRestored}`);
-          if (result.errors.length > 0) {
-            logger.error(`Migration completed with ${result.errors.length} errors`);
-          }
-          if (result.warnings.length > 0) {
-            logger.warn(`Migration completed with ${result.warnings.length} warnings`);
-          }
-        } catch (error) {
-          result.success = false;
-          result.migrationTime = Date.now() - startTime;
-          const errorMessage = error instanceof Error ? error.message : String(error);
-          result.errors.push(`Migration failed: ${errorMessage}`);
-          logger.error("Migration failed:", error);
-          if (this.options.cleanupOnFailure) {
-            try {
-              await this.cleanupFailedMigration(targetDB);
-            } catch (cleanupError) {
-              logger.error("Failed to cleanup after migration failure:", cleanupError);
-              result.warnings.push("Failed to cleanup after migration failure");
-            }
-          }
-        }
-        return result;
-      }
-      /**
-       * Load and parse the manifest file
-       */
-      async loadManifest(staticPath) {
-        try {
-          let manifestContent;
-          let manifestPath;
-          if (this.fs) {
-            manifestPath = this.fs.joinPath(staticPath, "manifest.json");
-            manifestContent = await this.fs.readFile(manifestPath);
-          } else {
-            manifestPath = nodeFS2 && nodePath ? nodePath.join(staticPath, "manifest.json") : `${staticPath}/manifest.json`;
-            if (nodeFS2 && this.isLocalPath(staticPath)) {
-              manifestContent = await nodeFS2.promises.readFile(manifestPath, "utf8");
-            } else {
-              const response = await fetch(manifestPath);
-              if (!response.ok) {
-                throw new Error(`Failed to fetch manifest: ${response.status} ${response.statusText}`);
-              }
-              manifestContent = await response.text();
-            }
-          }
-          const manifest = JSON.parse(manifestContent);
-          if (!manifest.version || !manifest.courseId || !manifest.chunks) {
-            throw new Error("Invalid manifest structure");
-          }
-          return manifest;
-        } catch (error) {
-          const errorMessage = error instanceof FileSystemError ? error.message : `Failed to load manifest: ${error instanceof Error ? error.message : String(error)}`;
-          throw new Error(errorMessage);
-        }
-      }
-      /**
-       * Restore design documents to CouchDB
-       */
-      async restoreDesignDocuments(designDocs, db) {
-        const result = { restored: 0, errors: [], warnings: [] };
-        for (let i = 0; i < designDocs.length; i++) {
-          const designDoc = designDocs[i];
-          this.reportProgress("design_docs", i, designDocs.length, `Restoring ${designDoc._id}...`);
-          try {
-            let existingDoc;
-            try {
-              existingDoc = await db.get(designDoc._id);
-            } catch {
-            }
-            const docToInsert = {
-              _id: designDoc._id,
-              views: designDoc.views
-            };
-            if (existingDoc) {
-              docToInsert._rev = existingDoc._rev;
-              logger.debug(`Updating existing design document: ${designDoc._id}`);
-            } else {
-              logger.debug(`Creating new design document: ${designDoc._id}`);
-            }
-            await db.put(docToInsert);
-            result.restored++;
-          } catch (error) {
-            const errorMessage = `Failed to restore design document ${designDoc._id}: ${error instanceof Error ? error.message : String(error)}`;
-            result.errors.push(errorMessage);
-            logger.error(errorMessage);
-          }
-        }
-        this.reportProgress(
-          "design_docs",
-          designDocs.length,
-          designDocs.length,
-          `Restored ${result.restored} design documents`
-        );
-        return result;
-      }
-      /**
-       * Aggregate documents from all chunks
-       */
-      async aggregateDocuments(staticPath, manifest) {
-        const allDocuments = [];
-        const documentMap = /* @__PURE__ */ new Map();
-        for (let i = 0; i < manifest.chunks.length; i++) {
-          const chunk = manifest.chunks[i];
-          this.reportProgress(
-            "documents",
-            allDocuments.length,
-            manifest.documentCount,
-            `Loading chunk ${chunk.id}...`
-          );
-          try {
-            const documents = await this.loadChunk(staticPath, chunk);
-            for (const doc of documents) {
-              if (!doc._id) {
-                logger.warn(`Document without _id found in chunk ${chunk.id}, skipping`);
-                continue;
-              }
-              if (documentMap.has(doc._id)) {
-                logger.warn(`Duplicate document ID found: ${doc._id}, using latest version`);
-              }
-              documentMap.set(doc._id, doc);
-            }
-          } catch (error) {
-            throw new Error(
-              `Failed to load chunk ${chunk.id}: ${error instanceof Error ? error.message : String(error)}`
-            );
-          }
-        }
-        allDocuments.push(...documentMap.values());
-        logger.info(
-          `Aggregated ${allDocuments.length} unique documents from ${manifest.chunks.length} chunks`
-        );
-        return allDocuments;
-      }
-      /**
-       * Load documents from a single chunk file
-       */
-      async loadChunk(staticPath, chunk) {
-        try {
-          let chunkContent;
-          let chunkPath;
-          if (this.fs) {
-            chunkPath = this.fs.joinPath(staticPath, chunk.path);
-            chunkContent = await this.fs.readFile(chunkPath);
-          } else {
-            chunkPath = nodeFS2 && nodePath ? nodePath.join(staticPath, chunk.path) : `${staticPath}/${chunk.path}`;
-            if (nodeFS2 && this.isLocalPath(staticPath)) {
-              chunkContent = await nodeFS2.promises.readFile(chunkPath, "utf8");
-            } else {
-              const response = await fetch(chunkPath);
-              if (!response.ok) {
-                throw new Error(`Failed to fetch chunk: ${response.status} ${response.statusText}`);
-              }
-              chunkContent = await response.text();
-            }
-          }
-          const documents = JSON.parse(chunkContent);
-          if (!Array.isArray(documents)) {
-            throw new Error("Chunk file does not contain an array of documents");
-          }
-          return documents;
-        } catch (error) {
-          const errorMessage = error instanceof FileSystemError ? error.message : `Failed to load chunk: ${error instanceof Error ? error.message : String(error)}`;
-          throw new Error(errorMessage);
-        }
-      }
-      /**
-       * Upload documents to CouchDB in batches
-       */
-      async uploadDocuments(documents, db) {
-        const result = { restored: 0, errors: [], warnings: [] };
-        const batchSize = this.options.chunkBatchSize;
-        for (let i = 0; i < documents.length; i += batchSize) {
-          const batch = documents.slice(i, i + batchSize);
-          this.reportProgress(
-            "documents",
-            i,
-            documents.length,
-            `Uploading batch ${Math.floor(i / batchSize) + 1}...`
-          );
-          try {
-            const docsToInsert = batch.map((doc) => {
-              const cleanDoc = { ...doc };
-              delete cleanDoc._rev;
-              delete cleanDoc._attachments;
-              return cleanDoc;
-            });
-            const bulkResult = await db.bulkDocs(docsToInsert);
-            for (let j = 0; j < bulkResult.length; j++) {
-              const docResult = bulkResult[j];
-              const originalDoc = batch[j];
-              if ("error" in docResult) {
-                const errorMessage = `Failed to upload document ${originalDoc._id}: ${docResult.error} - ${docResult.reason}`;
-                result.errors.push(errorMessage);
-                logger.error(errorMessage);
-              } else {
-                result.restored++;
-              }
-            }
-          } catch (error) {
-            let errorMessage;
-            if (error instanceof Error) {
-              errorMessage = `Failed to upload document batch starting at index ${i}: ${error.message}`;
-            } else if (error && typeof error === "object" && "message" in error) {
-              errorMessage = `Failed to upload document batch starting at index ${i}: ${error.message}`;
-            } else {
-              errorMessage = `Failed to upload document batch starting at index ${i}: ${JSON.stringify(error)}`;
-            }
-            result.errors.push(errorMessage);
-            logger.error(errorMessage);
-          }
-        }
-        this.reportProgress(
-          "documents",
-          documents.length,
-          documents.length,
-          `Uploaded ${result.restored} documents`
-        );
-        return result;
-      }
-      /**
-       * Upload attachments from filesystem to CouchDB
-       */
-      async uploadAttachments(staticPath, documents, db) {
-        const result = { restored: 0, errors: [], warnings: [] };
-        let processedDocs = 0;
-        for (const doc of documents) {
-          this.reportProgress(
-            "attachments",
-            processedDocs,
-            documents.length,
-            `Processing attachments for ${doc._id}...`
-          );
-          processedDocs++;
-          if (!doc._attachments) {
-            continue;
-          }
-          for (const [attachmentName, attachmentMeta] of Object.entries(doc._attachments)) {
-            try {
-              const uploadResult = await this.uploadSingleAttachment(
-                staticPath,
-                doc._id,
-                attachmentName,
-                attachmentMeta,
-                db
-              );
-              if (uploadResult.success) {
-                result.restored++;
-              } else {
-                result.errors.push(uploadResult.error || "Unknown attachment upload error");
-              }
-            } catch (error) {
-              const errorMessage = `Failed to upload attachment ${doc._id}/${attachmentName}: ${error instanceof Error ? error.message : String(error)}`;
-              result.errors.push(errorMessage);
-              logger.error(errorMessage);
-            }
-          }
-        }
-        this.reportProgress(
-          "attachments",
-          documents.length,
-          documents.length,
-          `Uploaded ${result.restored} attachments`
-        );
-        return result;
-      }
-      /**
-       * Upload a single attachment file
-       */
-      async uploadSingleAttachment(staticPath, docId, attachmentName, attachmentMeta, db) {
-        const result = {
-          success: false,
-          attachmentName,
-          docId
-        };
-        try {
-          if (!attachmentMeta.path) {
-            result.error = "Attachment metadata missing file path";
-            return result;
-          }
-          let attachmentData;
-          let attachmentPath;
-          if (this.fs) {
-            attachmentPath = this.fs.joinPath(staticPath, attachmentMeta.path);
-            attachmentData = await this.fs.readBinary(attachmentPath);
-          } else {
-            attachmentPath = nodeFS2 && nodePath ? nodePath.join(staticPath, attachmentMeta.path) : `${staticPath}/${attachmentMeta.path}`;
-            if (nodeFS2 && this.isLocalPath(staticPath)) {
-              attachmentData = await nodeFS2.promises.readFile(attachmentPath);
-            } else {
-              const response = await fetch(attachmentPath);
-              if (!response.ok) {
-                result.error = `Failed to fetch attachment: ${response.status} ${response.statusText}`;
-                return result;
-              }
-              attachmentData = await response.arrayBuffer();
-            }
-          }
-          const doc = await db.get(docId);
-          await db.putAttachment(
-            docId,
-            attachmentName,
-            doc._rev,
-            attachmentData,
-            // PouchDB accepts both ArrayBuffer and Buffer
-            attachmentMeta.content_type
-          );
-          result.success = true;
-        } catch (error) {
-          result.error = error instanceof Error ? error.message : String(error);
-        }
-        return result;
-      }
-      /**
-       * Restore CourseConfig document from manifest
-       */
-      async restoreCourseConfig(manifest, targetDB) {
-        const results = {
-          restored: 0,
-          errors: [],
-          warnings: []
-        };
-        try {
-          if (!manifest.courseConfig) {
-            results.warnings.push(
-              "No courseConfig found in manifest, skipping CourseConfig document creation"
-            );
-            return results;
-          }
-          const courseConfigDoc = {
-            _id: "CourseConfig",
-            ...manifest.courseConfig,
-            courseID: manifest.courseId
-          };
-          delete courseConfigDoc._rev;
-          await targetDB.put(courseConfigDoc);
-          results.restored = 1;
-          logger.info(`CourseConfig document created for course: ${manifest.courseId}`);
-        } catch (error) {
-          const errorMessage = error instanceof Error ? error.message : JSON.stringify(error);
-          results.errors.push(`Failed to restore CourseConfig: ${errorMessage}`);
-          logger.error("CourseConfig restoration failed:", error);
-        }
-        return results;
-      }
-      /**
-       * Calculate expected document counts from manifest
-       */
-      calculateExpectedCounts(manifest) {
-        const counts = {};
-        for (const chunk of manifest.chunks) {
-          counts[chunk.docType] = (counts[chunk.docType] || 0) + chunk.documentCount;
-        }
-        if (manifest.designDocs.length > 0) {
-          counts["_design"] = manifest.designDocs.length;
-        }
-        return counts;
-      }
-      /**
-       * Clean up database after failed migration
-       */
-      async cleanupFailedMigration(db) {
-        logger.info("Cleaning up failed migration...");
-        try {
-          const allDocs = await db.allDocs();
-          const docsToDelete = allDocs.rows.map((row) => ({
-            _id: row.id,
-            _rev: row.value.rev,
-            _deleted: true
-          }));
-          if (docsToDelete.length > 0) {
-            await db.bulkDocs(docsToDelete);
-            logger.info(`Cleaned up ${docsToDelete.length} documents from failed migration`);
-          }
-        } catch (error) {
-          logger.error("Failed to cleanup documents:", error);
-          throw error;
-        }
-      }
-      /**
-       * Report progress to callback if available
-       */
-      reportProgress(phase, current, total, message) {
-        if (this.progressCallback) {
-          this.progressCallback({
-            phase,
-            current,
-            total,
-            message
-          });
-        }
-      }
-      /**
-       * Check if a path is a local file path (vs URL)
-       */
-      isLocalPath(path2) {
-        return !path2.startsWith("http://") && !path2.startsWith("https://");
-      }
-    };
-  }
-});
-
-// src/util/migrator/index.ts
-var init_migrator = __esm({
-  "src/util/migrator/index.ts"() {
-    "use strict";
-    init_StaticToCouchDBMigrator();
-    init_validation();
-    init_FileSystemAdapter();
-  }
-});
-
-// src/util/dataDirectory.ts
-function getAppDataDirectory() {
-  if (ENV.LOCAL_STORAGE_PREFIX) {
-    return path.join(os.homedir(), `.tuilder`, ENV.LOCAL_STORAGE_PREFIX);
-  } else {
-    return path.join(os.homedir(), ".tuilder");
-  }
-}
-function getDbPath(dbName) {
-  return path.join(getAppDataDirectory(), dbName);
-}
-var path, os;
-var init_dataDirectory = __esm({
-  "src/util/dataDirectory.ts"() {
-    "use strict";
-    path = __toESM(require("path"), 1);
-    os = __toESM(require("os"), 1);
-    init_logger();
-    init_factory();
-  }
-});
-
-// src/util/index.ts
-var init_util2 = __esm({
-  "src/util/index.ts"() {
-    "use strict";
-    init_Loggable();
-    init_packer();
-    init_migrator();
-    init_dataDirectory();
-  }
-});
-
-// src/study/SourceMixer.ts
-var init_SourceMixer = __esm({
-  "src/study/SourceMixer.ts"() {
-    "use strict";
-  }
-});
-
-// src/study/MixerDebugger.ts
-function printMixerSummary(run) {
-  console.group(`\u{1F3A8} Mixer Run: ${run.mixerType}`);
-  logger.info(`Run ID: ${run.runId}`);
-  logger.info(`Time: ${run.timestamp.toISOString()}`);
-  logger.info(
-    `Config: limit=${run.requestedLimit}${run.quotaPerSource ? `, quota/source=${run.quotaPerSource}` : ""}`
-  );
-  console.group(`\u{1F4E5} Input: ${run.sourceSummaries.length} sources`);
-  for (const src of run.sourceSummaries) {
-    logger.info(
-      `  ${src.sourceName || src.sourceId}: ${src.totalCards} cards (${src.reviewCount} reviews, ${src.newCount} new)`
-    );
-    logger.info(`    Score range: [${src.scoreRange[0].toFixed(2)}, ${src.scoreRange[1].toFixed(2)}], avg: ${src.avgScore.toFixed(2)}`);
-  }
-  console.groupEnd();
-  console.group(`\u{1F4E4} Output: ${run.finalCount} cards selected (${run.reviewsSelected} reviews, ${run.newSelected} new)`);
-  for (const breakdown of run.sourceBreakdowns) {
-    const name = breakdown.sourceName || breakdown.sourceId;
-    logger.info(
-      `  ${name}: ${breakdown.totalSelected} selected (${breakdown.reviewsSelected} reviews, ${breakdown.newSelected} new) - ${breakdown.selectionRate.toFixed(1)}% selection rate`
-    );
-  }
-  console.groupEnd();
-  console.groupEnd();
-}
-function mountMixerDebugger() {
-  if (typeof window === "undefined") return;
-  const win = window;
-  win.skuilder = win.skuilder || {};
-  win.skuilder.mixer = mixerDebugAPI;
-}
-var runHistory2, mixerDebugAPI;
-var init_MixerDebugger = __esm({
-  "src/study/MixerDebugger.ts"() {
-    "use strict";
-    init_logger();
-    init_navigators();
-    runHistory2 = [];
-    mixerDebugAPI = {
-      /**
-       * Get raw run history for programmatic access.
-       */
-      get runs() {
-        return [...runHistory2];
-      },
-      /**
-       * Show summary of a specific mixer run.
-       */
-      showRun(idOrIndex = 0) {
-        if (runHistory2.length === 0) {
-          logger.info("[Mixer Debug] No runs captured yet.");
-          return;
-        }
-        let run;
-        if (typeof idOrIndex === "number") {
-          run = runHistory2[idOrIndex];
-          if (!run) {
-            logger.info(`[Mixer Debug] No run found at index ${idOrIndex}. History length: ${runHistory2.length}`);
-            return;
-          }
-        } else {
-          run = runHistory2.find((r) => r.runId.endsWith(idOrIndex));
-          if (!run) {
-            logger.info(`[Mixer Debug] No run found matching ID '${idOrIndex}'.`);
-            return;
-          }
-        }
-        printMixerSummary(run);
-      },
-      /**
-       * Show summary of the last mixer run.
-       */
-      showLastMix() {
-        this.showRun(0);
-      },
-      /**
-       * Explain source balance in the last run.
-       */
-      explainSourceBalance() {
-        if (runHistory2.length === 0) {
-          logger.info("[Mixer Debug] No runs captured yet.");
-          return;
-        }
-        const run = runHistory2[0];
-        console.group("\u2696\uFE0F Source Balance Analysis");
-        logger.info(`Mixer: ${run.mixerType}`);
-        logger.info(`Requested limit: ${run.requestedLimit}`);
-        if (run.quotaPerSource) {
-          logger.info(`Quota per source: ${run.quotaPerSource}`);
-        }
-        console.group("Input Distribution:");
-        for (const src of run.sourceSummaries) {
-          const name = src.sourceName || src.sourceId;
-          logger.info(`${name}:`);
-          logger.info(`  Provided: ${src.totalCards} cards (${src.reviewCount} reviews, ${src.newCount} new)`);
-          logger.info(`  Score range: [${src.scoreRange[0].toFixed(2)}, ${src.scoreRange[1].toFixed(2)}]`);
-        }
-        console.groupEnd();
-        console.group("Selection Results:");
-        for (const breakdown of run.sourceBreakdowns) {
-          const name = breakdown.sourceName || breakdown.sourceId;
-          logger.info(`${name}:`);
-          logger.info(
-            `  Selected: ${breakdown.totalSelected}/${breakdown.reviewsProvided + breakdown.newProvided} (${breakdown.selectionRate.toFixed(1)}%)`
-          );
-          logger.info(`  Reviews: ${breakdown.reviewsSelected}/${breakdown.reviewsProvided}`);
-          logger.info(`  New: ${breakdown.newSelected}/${breakdown.newProvided}`);
-          if (breakdown.reviewsProvided > 0 && breakdown.reviewsSelected === 0) {
-            logger.info(`  \u26A0\uFE0F Had reviews but none selected!`);
-          }
-          if (breakdown.totalSelected === 0 && breakdown.reviewsProvided + breakdown.newProvided > 0) {
-            logger.info(`  \u26A0\uFE0F Had cards but none selected!`);
-          }
-        }
-        console.groupEnd();
-        const selectionRates = run.sourceBreakdowns.map((b) => b.selectionRate);
-        const avgRate = selectionRates.reduce((a, b) => a + b, 0) / selectionRates.length;
-        const maxDeviation = Math.max(...selectionRates.map((r) => Math.abs(r - avgRate)));
-        if (maxDeviation > 20) {
-          logger.info(`
-\u26A0\uFE0F Significant imbalance detected (max deviation: ${maxDeviation.toFixed(1)}%)`);
-          logger.info("Possible causes:");
-          logger.info("  - Score range differences between sources");
-          logger.info("  - One source has much better quality cards");
-          logger.info("  - Different card availability (reviews vs new)");
-        }
-        console.groupEnd();
-      },
-      /**
-       * Compare score distributions across sources.
-       */
-      compareScores() {
-        if (runHistory2.length === 0) {
-          logger.info("[Mixer Debug] No runs captured yet.");
-          return;
-        }
-        const run = runHistory2[0];
-        console.group("\u{1F4CA} Score Distribution Comparison");
-        console.table(
-          run.sourceSummaries.map((src) => ({
-            source: src.sourceName || src.sourceId,
-            cards: src.totalCards,
-            min: src.bottomScore.toFixed(3),
-            max: src.topScore.toFixed(3),
-            avg: src.avgScore.toFixed(3),
-            range: (src.topScore - src.bottomScore).toFixed(3)
-          }))
-        );
-        const ranges = run.sourceSummaries.map((s) => s.topScore - s.bottomScore);
-        const avgScores = run.sourceSummaries.map((s) => s.avgScore);
-        const rangeDiff = Math.max(...ranges) - Math.min(...ranges);
-        const avgDiff = Math.max(...avgScores) - Math.min(...avgScores);
-        if (rangeDiff > 0.3 || avgDiff > 0.2) {
-          logger.info("\n\u26A0\uFE0F Significant score distribution differences detected");
-          logger.info(
-            "This may cause one source to dominate selection if using global sorting (not quota-based)"
-          );
-        }
-        console.groupEnd();
-      },
-      /**
-       * Show detailed information for a specific card.
-       */
-      showCard(cardId) {
-        for (const run of runHistory2) {
-          const card = run.cards.find((c) => c.cardId === cardId);
-          if (card) {
-            const source = run.sourceSummaries.find((s) => s.sourceIndex === card.sourceIndex);
-            console.group(`\u{1F3B4} Card: ${cardId}`);
-            logger.info(`Course: ${card.courseId}`);
-            logger.info(`Source: ${source?.sourceName || source?.sourceId || "unknown"}`);
-            logger.info(`Origin: ${card.origin}`);
-            logger.info(`Score: ${card.score.toFixed(3)}`);
-            if (card.rankInSource) {
-              logger.info(`Rank in source: #${card.rankInSource}`);
-            }
-            if (card.rankInMix) {
-              logger.info(`Rank in mixed results: #${card.rankInMix}`);
-            }
-            logger.info(`Selected: ${card.selected ? "Yes \u2705" : "No \u274C"}`);
-            if (!card.selected && card.rankInSource) {
-              logger.info("\nWhy not selected:");
-              if (run.quotaPerSource && card.rankInSource > run.quotaPerSource) {
-                logger.info(`  - Ranked #${card.rankInSource} in source, but quota was ${run.quotaPerSource}`);
-              }
-              logger.info("  - Check score compared to selected cards using .showRun()");
-            }
-            console.groupEnd();
-            return;
-          }
-        }
-        logger.info(`[Mixer Debug] Card '${cardId}' not found in recent runs.`);
-      },
-      /**
-       * Show all runs in compact format.
-       */
-      listRuns() {
-        if (runHistory2.length === 0) {
-          logger.info("[Mixer Debug] No runs captured yet.");
-          return;
-        }
-        console.table(
-          runHistory2.map((r) => ({
-            id: r.runId.slice(-8),
-            time: r.timestamp.toLocaleTimeString(),
-            mixer: r.mixerType,
-            sources: r.sourceSummaries.length,
-            selected: r.finalCount,
-            reviews: r.reviewsSelected,
-            new: r.newSelected
-          }))
-        );
-      },
-      /**
-       * Export run history as JSON for bug reports.
-       */
-      export() {
-        const json = JSON.stringify(runHistory2, null, 2);
-        logger.info("[Mixer Debug] Run history exported. Copy the returned string or use:");
-        logger.info("  copy(window.skuilder.mixer.export())");
-        return json;
-      },
-      /**
-       * Clear run history.
-       */
-      clear() {
-        runHistory2.length = 0;
-        logger.info("[Mixer Debug] Run history cleared.");
-      },
-      /**
-       * Show help.
-       */
-      help() {
-        logger.info(`
-\u{1F3A8} Mixer Debug API
-
-Commands:
-  .showLastMix()           Show summary of most recent mixer run
-  .showRun(id|index)       Show summary of a specific run (by index or ID suffix)
-  .explainSourceBalance()  Analyze source balance and selection patterns
-  .compareScores()         Compare score distributions across sources
-  .showCard(cardId)        Show mixer decisions for a specific card
-  .listRuns()              List all captured runs in table format
-  .export()                Export run history as JSON for bug reports
-  .clear()                 Clear run history
-  .runs                    Access raw run history array
-  .help()                  Show this help message
-
-Example:
-  window.skuilder.mixer.showLastMix()
-  window.skuilder.mixer.explainSourceBalance()
-  window.skuilder.mixer.compareScores()
-`);
-      }
-    };
-    mountMixerDebugger();
+    "use strict";
+    USER_GOAL_NAVIGATOR_STUB = true;
   }
 });
 
-// src/study/SessionDebugger.ts
-function showCurrentQueue() {
-  if (!activeSession) {
-    logger.info("[Session Debug] No active session.");
-    return;
+// import("./filters/**/*") in src/core/navigators/index.ts
+var globImport_filters;
+var init_2 = __esm({
+  'import("./filters/**/*") in src/core/navigators/index.ts'() {
+    globImport_filters = __glob({
+      "./filters/WeightedFilter.ts": () => Promise.resolve().then(() => (init_WeightedFilter(), WeightedFilter_exports)),
+      "./filters/eloDistance.ts": () => Promise.resolve().then(() => (init_eloDistance(), eloDistance_exports)),
+      "./filters/hierarchyDefinition.ts": () => Promise.resolve().then(() => (init_hierarchyDefinition(), hierarchyDefinition_exports)),
+      "./filters/index.ts": () => Promise.resolve().then(() => (init_filters(), filters_exports)),
+      "./filters/inferredPreferenceStub.ts": () => Promise.resolve().then(() => (init_inferredPreferenceStub(), inferredPreferenceStub_exports)),
+      "./filters/interferenceMitigator.ts": () => Promise.resolve().then(() => (init_interferenceMitigator(), interferenceMitigator_exports)),
+      "./filters/relativePriority.ts": () => Promise.resolve().then(() => (init_relativePriority(), relativePriority_exports)),
+      "./filters/types.ts": () => Promise.resolve().then(() => (init_types2(), types_exports2)),
+      "./filters/userGoalStub.ts": () => Promise.resolve().then(() => (init_userGoalStub(), userGoalStub_exports)),
+      "./filters/userTagPreference.ts": () => Promise.resolve().then(() => (init_userTagPreference(), userTagPreference_exports))
+    });
   }
-  const latest = activeSession.queueSnapshots[activeSession.queueSnapshots.length - 1] || activeSession.initialQueues;
-  console.group("\u{1F4CA} Current Queue State");
-  logger.info(`Review Queue: ${latest.reviewQLength} cards`);
-  if (latest.reviewQNext3 && latest.reviewQNext3.length > 0) {
-    logger.info(`  Next: ${latest.reviewQNext3.join(", ")}`);
+});
+
+// src/core/orchestration/gradient.ts
+var init_gradient = __esm({
+  "src/core/orchestration/gradient.ts"() {
+    "use strict";
+    init_logger();
   }
-  logger.info(`New Queue: ${latest.newQLength} cards`);
-  if (latest.newQNext3 && latest.newQNext3.length > 0) {
-    logger.info(`  Next: ${latest.newQNext3.join(", ")}`);
+});
+
+// src/core/orchestration/learning.ts
+var init_learning = __esm({
+  "src/core/orchestration/learning.ts"() {
+    "use strict";
+    init_contentNavigationStrategy();
+    init_types_legacy();
+    init_logger();
   }
-  logger.info(`Failed Queue: ${latest.failedQLength} cards`);
-  console.groupEnd();
-}
-function showPresentationHistory(sessionIndex = 0) {
-  const session = sessionIndex === 0 && activeSession ? activeSession : sessionHistory[sessionIndex];
-  if (!session) {
-    logger.info(`[Session Debug] No session found at index ${sessionIndex}`);
-    return;
+});
+
+// src/core/orchestration/signal.ts
+var init_signal = __esm({
+  "src/core/orchestration/signal.ts"() {
+    "use strict";
   }
-  console.group(`\u{1F4DC} Session History: ${session.sessionId}`);
-  logger.info(`Started: ${session.startTime.toLocaleTimeString()}`);
-  if (session.endTime) {
-    logger.info(`Ended: ${session.endTime.toLocaleTimeString()}`);
+});
+
+// src/core/orchestration/recording.ts
+var init_recording = __esm({
+  "src/core/orchestration/recording.ts"() {
+    "use strict";
+    init_signal();
+    init_types_legacy();
+    init_logger();
   }
-  logger.info(`Cards presented: ${session.presentations.length}`);
-  if (session.presentations.length > 0) {
-    console.table(
-      session.presentations.map((p) => ({
-        "#": p.sequenceNumber,
-        course: p.courseName || p.courseId.slice(0, 8),
-        origin: p.origin,
-        queue: p.queueSource,
-        score: p.score?.toFixed(3) || "-",
-        time: p.timestamp.toLocaleTimeString()
-      }))
-    );
+});
+
+// src/core/orchestration/index.ts
+function fnv1a(str) {
+  let hash = 2166136261;
+  for (let i = 0; i < str.length; i++) {
+    hash ^= str.charCodeAt(i);
+    hash = Math.imul(hash, 16777619);
   }
-  console.groupEnd();
+  return hash >>> 0;
 }
-function showInterleaving(sessionIndex = 0) {
-  const session = sessionIndex === 0 && activeSession ? activeSession : sessionHistory[sessionIndex];
-  if (!session) {
-    logger.info(`[Session Debug] No session found at index ${sessionIndex}`);
-    return;
-  }
-  console.group("\u{1F500} Interleaving Analysis");
-  const courseCounts = /* @__PURE__ */ new Map();
-  const courseOrigins = /* @__PURE__ */ new Map();
-  session.presentations.forEach((p) => {
-    const name = p.courseName || p.courseId;
-    courseCounts.set(name, (courseCounts.get(name) || 0) + 1);
-    if (!courseOrigins.has(name)) {
-      courseOrigins.set(name, { review: 0, new: 0, failed: 0 });
-    }
-    const origins = courseOrigins.get(name);
-    origins[p.origin]++;
-  });
-  logger.info("Course distribution:");
-  console.table(
-    Array.from(courseCounts.entries()).map(([course, count]) => {
-      const origins = courseOrigins.get(course);
-      return {
-        course,
-        total: count,
-        reviews: origins.review,
-        new: origins.new,
-        failed: origins.failed,
-        percentage: (count / session.presentations.length * 100).toFixed(1) + "%"
-      };
-    })
-  );
-  if (session.presentations.length > 0) {
-    logger.info("\nPresentation sequence (first 20):");
-    const sequence = session.presentations.slice(0, 20).map((p, idx) => `${idx + 1}. ${p.courseName || p.courseId.slice(0, 8)} (${p.origin})`).join("\n");
-    logger.info(sequence);
-  }
-  let maxCluster = 0;
-  let currentCluster = 1;
-  let currentCourse = session.presentations[0]?.courseId;
-  for (let i = 1; i < session.presentations.length; i++) {
-    if (session.presentations[i].courseId === currentCourse) {
-      currentCluster++;
-      maxCluster = Math.max(maxCluster, currentCluster);
-    } else {
-      currentCourse = session.presentations[i].courseId;
-      currentCluster = 1;
-    }
-  }
-  if (maxCluster > 3) {
-    logger.info(`
-\u26A0\uFE0F Detected clustering: max ${maxCluster} cards from same course in a row`);
-    logger.info("This suggests cards are sorted by score rather than round-robin by course.");
-  }
-  console.groupEnd();
+function computeDeviation(userId, strategyId, salt) {
+  const input = `${userId}:${strategyId}:${salt}`;
+  const hash = fnv1a(input);
+  const normalized = hash / 4294967296;
+  return normalized * 2 - 1;
 }
-function mountSessionDebugger() {
-  if (typeof window === "undefined") return;
-  const win = window;
-  win.skuilder = win.skuilder || {};
-  win.skuilder.session = sessionDebugAPI;
+function computeSpread(confidence) {
+  const clampedConfidence = Math.max(0, Math.min(1, confidence));
+  return MAX_SPREAD - clampedConfidence * (MAX_SPREAD - MIN_SPREAD);
 }
-var activeSession, sessionHistory, sessionDebugAPI;
-var init_SessionDebugger = __esm({
-  "src/study/SessionDebugger.ts"() {
-    "use strict";
-    init_logger();
-    activeSession = null;
-    sessionHistory = [];
-    sessionDebugAPI = {
-      /**
-       * Get raw session history for programmatic access.
-       */
-      get sessions() {
-        return [...sessionHistory];
-      },
-      /**
-       * Get active session if any.
-       */
-      get active() {
-        return activeSession;
-      },
-      /**
-       * Show current queue state.
-       */
-      showQueue() {
-        showCurrentQueue();
-      },
-      /**
-       * Show presentation history for current or past session.
-       */
-      showHistory(sessionIndex = 0) {
-        showPresentationHistory(sessionIndex);
-      },
-      /**
-       * Analyze course interleaving pattern.
-       */
-      showInterleaving(sessionIndex = 0) {
-        showInterleaving(sessionIndex);
-      },
-      /**
-       * List all tracked sessions.
-       */
-      listSessions() {
-        if (activeSession) {
-          logger.info(`Active session: ${activeSession.sessionId} (${activeSession.presentations.length} cards presented)`);
-        }
-        if (sessionHistory.length === 0) {
-          logger.info("[Session Debug] No completed sessions in history.");
-          return;
-        }
-        console.table(
-          sessionHistory.map((s, idx) => ({
-            index: idx,
-            id: s.sessionId.slice(-8),
-            started: s.startTime.toLocaleTimeString(),
-            ended: s.endTime?.toLocaleTimeString() || "incomplete",
-            cards: s.presentations.length
-          }))
-        );
-      },
-      /**
-       * Export session history as JSON for bug reports.
-       */
-      export() {
-        const data = {
-          active: activeSession,
-          history: sessionHistory
-        };
-        const json = JSON.stringify(data, null, 2);
-        logger.info("[Session Debug] Session data exported. Copy the returned string or use:");
-        logger.info("  copy(window.skuilder.session.export())");
-        return json;
-      },
-      /**
-       * Clear session history.
-       */
-      clear() {
-        sessionHistory.length = 0;
-        logger.info("[Session Debug] Session history cleared.");
-      },
-      /**
-       * Show help.
-       */
-      help() {
-        logger.info(`
-\u{1F3AF} Session Debug API
-
-Commands:
-  .showQueue()              Show current queue state (active session only)
-  .showHistory(index?)      Show presentation history (0=current/last, 1=previous, etc)
-  .showInterleaving(index?) Analyze course interleaving pattern
-  .listSessions()           List all tracked sessions
-  .export()                 Export session data as JSON for bug reports
-  .clear()                  Clear session history
-  .sessions                 Access raw session history array
-  .active                   Access active session (if any)
-  .help()                   Show this help message
-
-Example:
-  window.skuilder.session.showHistory()
-  window.skuilder.session.showInterleaving()
-  window.skuilder.session.showQueue()
-`);
-      }
+function computeEffectiveWeight(learnable, userId, strategyId, salt) {
+  const deviation = computeDeviation(userId, strategyId, salt);
+  const spread = computeSpread(learnable.confidence);
+  const adjustment = deviation * spread * learnable.weight;
+  const effective = learnable.weight + adjustment;
+  return Math.max(MIN_WEIGHT, Math.min(MAX_WEIGHT, effective));
+}
+async function createOrchestrationContext(user, course) {
+  let courseConfig;
+  try {
+    courseConfig = await course.getCourseConfig();
+  } catch (e) {
+    logger.error(`[Orchestration] Failed to load course config: ${e}`);
+    courseConfig = {
+      name: "Unknown",
+      description: "",
+      public: false,
+      deleted: false,
+      creator: "",
+      admins: [],
+      moderators: [],
+      dataShapes: [],
+      questionTypes: [],
+      orchestration: { salt: "default" }
     };
-    mountSessionDebugger();
   }
-});
-
-// src/study/SessionController.ts
-var init_SessionController = __esm({
-  "src/study/SessionController.ts"() {
+  const userId = user.getUsername();
+  const salt = courseConfig.orchestration?.salt || "default_salt";
+  return {
+    user,
+    course,
+    userId,
+    courseConfig,
+    getEffectiveWeight(strategyId, learnable) {
+      return computeEffectiveWeight(learnable, userId, strategyId, salt);
+    },
+    getDeviation(strategyId) {
+      return computeDeviation(userId, strategyId, salt);
+    }
+  };
+}
+var MIN_SPREAD, MAX_SPREAD, MIN_WEIGHT, MAX_WEIGHT;
+var init_orchestration = __esm({
+  "src/core/orchestration/index.ts"() {
     "use strict";
-    init_SrsService();
-    init_EloService();
-    init_ResponseProcessor();
-    init_CardHydrationService();
-    init_ItemQueue();
-    init_couch();
-    init_recording();
-    init_util2();
-    init_navigators();
-    init_SourceMixer();
-    init_MixerDebugger();
-    init_SessionDebugger();
     init_logger();
+    init_gradient();
+    init_learning();
+    init_signal();
+    init_recording();
+    MIN_SPREAD = 0.1;
+    MAX_SPREAD = 0.5;
+    MIN_WEIGHT = 0.1;
+    MAX_WEIGHT = 3;
   }
 });
 
@@ -4633,6 +3217,44 @@ function globMatch(value, pattern) {
 function cardMatchesTagPattern(card, pattern) {
   return (card.tags ?? []).some((tag) => globMatch(tag, pattern));
 }
+function mergeHints2(allHints) {
+  const defined = allHints.filter((h) => h !== null && h !== void 0);
+  if (defined.length === 0) return void 0;
+  const merged = {};
+  const boostTags = {};
+  for (const hints of defined) {
+    for (const [pattern, factor] of Object.entries(hints.boostTags ?? {})) {
+      boostTags[pattern] = (boostTags[pattern] ?? 1) * factor;
+    }
+  }
+  if (Object.keys(boostTags).length > 0) {
+    merged.boostTags = boostTags;
+  }
+  const boostCards = {};
+  for (const hints of defined) {
+    for (const [pattern, factor] of Object.entries(hints.boostCards ?? {})) {
+      boostCards[pattern] = (boostCards[pattern] ?? 1) * factor;
+    }
+  }
+  if (Object.keys(boostCards).length > 0) {
+    merged.boostCards = boostCards;
+  }
+  const concatUnique = (field) => {
+    const values = defined.flatMap((h) => h[field] ?? []);
+    if (values.length > 0) {
+      merged[field] = [...new Set(values)];
+    }
+  };
+  concatUnique("requireTags");
+  concatUnique("requireCards");
+  concatUnique("excludeTags");
+  concatUnique("excludeCards");
+  const labels = defined.map((h) => h._label).filter(Boolean);
+  if (labels.length > 0) {
+    merged._label = labels.join("; ");
+  }
+  return Object.keys(merged).length > 0 ? merged : void 0;
+}
 function logPipelineConfig(generator, filters) {
   const filterList = filters.length > 0 ? "\n    - " + filters.map((f) => f.name).join("\n    - ") : " none";
   logger.info(
@@ -4696,16 +3318,15 @@ function logCardProvenance(cards, maxCards = 3) {
     }
   }
 }
-var import_common12, VERBOSE_RESULTS, Pipeline;
+var import_common8, VERBOSE_RESULTS, Pipeline;
 var init_Pipeline = __esm({
   "src/core/navigators/Pipeline.ts"() {
     "use strict";
-    import_common12 = require("@vue-skuilder/common");
+    import_common8 = require("@vue-skuilder/common");
     init_navigators();
     init_logger();
     init_orchestration();
     init_PipelineDebugger();
-    init_SessionController();
     VERBOSE_RESULTS = true;
     Pipeline = class extends ContentNavigator {
       generator;
@@ -4785,9 +3406,12 @@ var init_Pipeline = __esm({
         logger.debug(
           `[Pipeline] Fetching ${fetchLimit} candidates from generator '${this.generator.name}'`
         );
-        let cards = await this.generator.getWeightedCards(fetchLimit, context);
+        const generatorResult = await this.generator.getWeightedCards(fetchLimit, context);
+        let cards = generatorResult.cards;
         const tGenerate = performance.now();
         const generatedCount = cards.length;
+        const mergedHints = mergeHints2([this._ephemeralHints, generatorResult.hints]);
+        this._ephemeralHints = mergedHints ?? null;
         let generatorSummaries;
         if (this.generator.generators) {
           const genMap = /* @__PURE__ */ new Map();
@@ -4873,7 +3497,7 @@ var init_Pipeline = __esm({
         } catch (e) {
           logger.debug(`[Pipeline] Failed to capture debug run: ${e}`);
         }
-        return result;
+        return { cards: result };
       }
       /**
        * Batch hydrate tags for all cards.
@@ -5028,7 +3652,7 @@ var init_Pipeline = __esm({
         let userElo = 1e3;
         try {
           const courseReg = await this.user.getCourseRegDoc(this.course.getCourseID());
-          const courseElo = (0, import_common12.toCourseElo)(courseReg.elo);
+          const courseElo = (0, import_common8.toCourseElo)(courseReg.elo);
           userElo = courseElo.global.score;
         } catch (e) {
           logger.debug(`[Pipeline] Could not get user ELO, using default: ${e}`);
@@ -5089,7 +3713,7 @@ var init_Pipeline = __esm({
        */
       async getTagEloStatus(tagFilter) {
         const courseReg = await this.user.getCourseRegDoc(this.course.getCourseID());
-        const courseElo = (0, import_common12.toCourseElo)(courseReg.elo);
+        const courseElo = (0, import_common8.toCourseElo)(courseReg.elo);
         const result = {};
         if (!tagFilter) {
           for (const [tag, data] of Object.entries(courseElo.tags)) {
@@ -5804,11 +4428,11 @@ ${JSON.stringify(config)}
 function isSuccessRow(row) {
   return "doc" in row && row.doc !== null && row.doc !== void 0;
 }
-var import_common13, CoursesDB, CourseDB;
+var import_common9, CoursesDB, CourseDB;
 var init_courseDB = __esm({
   "src/impl/couch/courseDB.ts"() {
     "use strict";
-    import_common13 = require("@vue-skuilder/common");
+    import_common9 = require("@vue-skuilder/common");
     init_couch();
     init_updateQueue();
     init_types_legacy();
@@ -5957,14 +4581,14 @@ var init_courseDB = __esm({
         docs.rows.forEach((r) => {
           if (isSuccessRow(r)) {
             if (r.doc && r.doc.elo) {
-              ret.push((0, import_common13.toCourseElo)(r.doc.elo));
+              ret.push((0, import_common9.toCourseElo)(r.doc.elo));
             } else {
               logger.warn("no elo data for card: " + r.id);
-              ret.push((0, import_common13.blankCourseElo)());
+              ret.push((0, import_common9.blankCourseElo)());
             }
           } else {
             logger.warn("no elo data for card: " + JSON.stringify(r));
-            ret.push((0, import_common13.blankCourseElo)());
+            ret.push((0, import_common9.blankCourseElo)());
           }
         });
         return ret;
@@ -6166,7 +4790,7 @@ ${above.rows.map((r) => `	${r.id}-${r.key}
       async getCourseTagStubs() {
         return getCourseTagStubs(this.id);
       }
-      async addNote(codeCourse, shape, data, author, tags, uploads, elo = (0, import_common13.blankCourseElo)()) {
+      async addNote(codeCourse, shape, data, author, tags, uploads, elo = (0, import_common9.blankCourseElo)()) {
         try {
           const resp = await addNote55(this.id, codeCourse, shape, data, author, tags, uploads, elo);
           if (resp.ok) {
@@ -6175,19 +4799,19 @@ ${above.rows.map((r) => `	${r.id}-${r.key}
                 `[courseDB.addNote] Note added but card creation failed: ${resp.cardCreationError}`
               );
               return {
-                status: import_common13.Status.error,
+                status: import_common9.Status.error,
                 message: `Note was added but no cards were created: ${resp.cardCreationError}`,
                 id: resp.id
               };
             }
             return {
-              status: import_common13.Status.ok,
+              status: import_common9.Status.ok,
               message: "",
               id: resp.id
             };
           } else {
             return {
-              status: import_common13.Status.error,
+              status: import_common9.Status.error,
               message: "Unexpected error adding note"
             };
           }
@@ -6199,7 +4823,7 @@ ${above.rows.map((r) => `	${r.id}-${r.key}
 	message: ${err.message}`
           );
           return {
-            status: import_common13.Status.error,
+            status: import_common9.Status.error,
             message: `Error adding note to course. ${e.reason || err.message}`
           };
         }
@@ -6338,7 +4962,7 @@ ${above.rows.map((r) => `	${r.id}-${r.key}
             const courseDoc = (await u.getCourseRegistrationsDoc()).courses.find((c) => {
               return c.courseID === this.id;
             });
-            targetElo = (0, import_common13.EloToNumber)(courseDoc.elo);
+            targetElo = (0, import_common9.EloToNumber)(courseDoc.elo);
           } catch {
             targetElo = 1e3;
           }
@@ -6473,13 +5097,13 @@ function getClassroomDB(classID, version) {
 async function getClassroomConfig(classID) {
   return await getClassroomDB(classID, "student").get(CLASSROOM_CONFIG);
 }
-var import_moment4, classroomLookupDBTitle, CLASSROOM_CONFIG, ClassroomDBBase, StudentClassroomDB, TeacherClassroomDB, ClassroomLookupDB;
+var import_moment2, classroomLookupDBTitle, CLASSROOM_CONFIG, ClassroomDBBase, StudentClassroomDB, TeacherClassroomDB, ClassroomLookupDB;
 var init_classroomDB2 = __esm({
   "src/impl/couch/classroomDB.ts"() {
     "use strict";
     init_factory();
     init_logger();
-    import_moment4 = __toESM(require("moment"), 1);
+    import_moment2 = __toESM(require("moment"), 1);
     init_pouchdb_setup();
     init_couch();
     init_courseDB();
@@ -6592,14 +5216,14 @@ var init_classroomDB2 = __esm({
         }
         const activeCards = await this._user.getActiveCards();
         const activeCardIds = new Set(activeCards.map((ac) => ac.cardID));
-        const now = import_moment4.default.utc();
+        const now = import_moment2.default.utc();
         const assigned = await this.getAssignedContent();
-        const due = assigned.filter((c) => now.isAfter(import_moment4.default.utc(c.activeOn, REVIEW_TIME_FORMAT)));
+        const due = assigned.filter((c) => now.isAfter(import_moment2.default.utc(c.activeOn, REVIEW_TIME_FORMAT)));
         logger.info(`[StudentClassroomDB] Due content: ${JSON.stringify(due)}`);
         for (const content of due) {
           if (content.type === "course") {
             const db = new CourseDB(content.courseID, async () => this._user);
-            const courseCards = await db.getWeightedCards(limit);
+            const { cards: courseCards } = await db.getWeightedCards(limit);
             for (const card of courseCards) {
               if (!activeCardIds.has(card.cardId)) {
                 weighted.push({
@@ -6662,7 +5286,7 @@ var init_classroomDB2 = __esm({
         logger.info(
           `[StudentClassroomDB] New cards from classroom ${this._cfg.name}: ${weighted.length} total (reviews + new)`
         );
-        return weighted.sort((a, b) => b.score - a.score).slice(0, limit);
+        return { cards: weighted.sort((a, b) => b.score - a.score).slice(0, limit) };
       }
     };
     TeacherClassroomDB = class _TeacherClassroomDB extends ClassroomDBBase {
@@ -6720,8 +5344,8 @@ var init_classroomDB2 = __esm({
             type: "tag",
             _id: id,
             assignedBy: content.assignedBy,
-            assignedOn: import_moment4.default.utc(),
-            activeOn: content.activeOn || import_moment4.default.utc()
+            assignedOn: import_moment2.default.utc(),
+            activeOn: content.activeOn || import_moment2.default.utc()
           });
         } else {
           put = await this._db.put({
@@ -6729,8 +5353,8 @@ var init_classroomDB2 = __esm({
             type: "course",
             _id: id,
             assignedBy: content.assignedBy,
-            assignedOn: import_moment4.default.utc(),
-            activeOn: content.activeOn || import_moment4.default.utc()
+            assignedOn: import_moment2.default.utc(),
+            activeOn: content.activeOn || import_moment2.default.utc()
           });
         }
         if (put.ok) {
@@ -6750,11 +5374,11 @@ var init_classroomDB2 = __esm({
 });
 
 // src/study/TagFilteredContentSource.ts
-var import_common14, TagFilteredContentSource;
+var import_common10, TagFilteredContentSource;
 var init_TagFilteredContentSource = __esm({
   "src/study/TagFilteredContentSource.ts"() {
     "use strict";
-    import_common14 = require("@vue-skuilder/common");
+    import_common10 = require("@vue-skuilder/common");
     init_courseDB();
     init_logger();
     TagFilteredContentSource = class {
@@ -6840,9 +5464,9 @@ var init_TagFilteredContentSource = __esm({
        * @returns Cards sorted by score descending (all scores = 1.0)
        */
       async getWeightedCards(limit) {
-        if (!(0, import_common14.hasActiveFilter)(this.filter)) {
+        if (!(0, import_common10.hasActiveFilter)(this.filter)) {
           logger.warn("[TagFilteredContentSource] getWeightedCards called with no active filter");
-          return [];
+          return { cards: [] };
         }
         const eligibleCardIds = await this.resolveFilteredCardIds();
         const activeCards = await this.user.getActiveCards();
@@ -6894,7 +5518,7 @@ var init_TagFilteredContentSource = __esm({
             }
           ]
         }));
-        return [...reviewWeighted, ...newCardWeighted].slice(0, limit);
+        return { cards: [...reviewWeighted, ...newCardWeighted].slice(0, limit) };
       }
       /**
        * Clears the cached resolved card IDs.
@@ -6928,19 +5552,19 @@ async function getStudySource(source, user) {
   if (source.type === "classroom") {
     return await StudentClassroomDB.factory(source.id, user);
   } else {
-    if ((0, import_common15.hasActiveFilter)(source.tagFilter)) {
+    if ((0, import_common11.hasActiveFilter)(source.tagFilter)) {
       return new TagFilteredContentSource(source.id, source.tagFilter, user);
     }
     return getDataLayer().getCourseDB(source.id);
   }
 }
-var import_common15;
+var import_common11;
 var init_contentSource = __esm({
   "src/core/interfaces/contentSource.ts"() {
     "use strict";
     init_factory();
     init_classroomDB2();
-    import_common15 = require("@vue-skuilder/common");
+    import_common11 = require("@vue-skuilder/common");
     init_TagFilteredContentSource();
   }
 });
@@ -7003,18 +5627,29 @@ var init_userOutcome = __esm({
   }
 });
 
+// src/core/util/index.ts
+function getCardHistoryID(courseID, cardID) {
+  return `${DocTypePrefixes["CARDRECORD" /* CARDRECORD */]}-${courseID}-${cardID}`;
+}
+var init_util = __esm({
+  "src/core/util/index.ts"() {
+    "use strict";
+    init_types_legacy();
+  }
+});
+
 // src/core/bulkImport/cardProcessor.ts
-var import_common16;
+var import_common12;
 var init_cardProcessor = __esm({
   "src/core/bulkImport/cardProcessor.ts"() {
     "use strict";
-    import_common16 = require("@vue-skuilder/common");
+    import_common12 = require("@vue-skuilder/common");
     init_logger();
   }
 });
 
 // src/core/bulkImport/types.ts
-var init_types5 = __esm({
+var init_types3 = __esm({
   "src/core/bulkImport/types.ts"() {
     "use strict";
   }
@@ -7025,7 +5660,29 @@ var init_bulkImport = __esm({
   "src/core/bulkImport/index.ts"() {
     "use strict";
     init_cardProcessor();
-    init_types5();
+    init_types3();
+  }
+});
+
+// src/util/dataDirectory.ts
+function getAppDataDirectory() {
+  if (ENV.LOCAL_STORAGE_PREFIX) {
+    return path.join(os.homedir(), `.tuilder`, ENV.LOCAL_STORAGE_PREFIX);
+  } else {
+    return path.join(os.homedir(), ".tuilder");
+  }
+}
+function getDbPath(dbName) {
+  return path.join(getAppDataDirectory(), dbName);
+}
+var path, os;
+var init_dataDirectory = __esm({
+  "src/util/dataDirectory.ts"() {
+    "use strict";
+    path = __toESM(require("path"), 1);
+    os = __toESM(require("os"), 1);
+    init_logger();
+    init_factory();
   }
 });
 
@@ -7057,7 +5714,7 @@ function getStartAndEndKeys2(key) {
   };
 }
 function updateGuestAccountExpirationDate(guestDB) {
-  const currentTime = import_moment5.default.utc();
+  const currentTime = import_moment3.default.utc();
   const expirationDate = currentTime.add(2, "months").toISOString();
   const expiryDocID2 = "GuestAccountExpirationDate";
   void guestDB.get(expiryDocID2).then((doc) => {
@@ -7082,7 +5739,7 @@ function getLocalUserDB(username) {
   }
 }
 function scheduleCardReviewLocal(userDB, review) {
-  const now = import_moment5.default.utc();
+  const now = import_moment3.default.utc();
   logger.info(`Scheduling for review in: ${review.time.diff(now, "h") / 24} days`);
   void userDB.put({
     _id: DocTypePrefixes["SCHEDULED_CARD" /* SCHEDULED_CARD */] + review.time.format(REVIEW_TIME_FORMAT2),
@@ -7105,11 +5762,11 @@ async function removeScheduledCardReviewLocal(userDB, reviewDocID) {
 ${JSON.stringify(err)}`);
   });
 }
-var import_moment5, REVIEW_TIME_FORMAT2, log2;
+var import_moment3, REVIEW_TIME_FORMAT2, log2;
 var init_userDBHelpers = __esm({
   "src/impl/common/userDBHelpers.ts"() {
     "use strict";
-    import_moment5 = __toESM(require("moment"), 1);
+    import_moment3 = __toESM(require("moment"), 1);
     init_core();
     init_logger();
     init_pouchdb_setup();
@@ -7469,11 +6126,11 @@ var init_core = __esm({
 });
 
 // src/impl/couch/user-course-relDB.ts
-var import_moment6, UsrCrsData;
+var import_moment4, UsrCrsData;
 var init_user_course_relDB = __esm({
   "src/impl/couch/user-course-relDB.ts"() {
     "use strict";
-    import_moment6 = __toESM(require("moment"), 1);
+    import_moment4 = __toESM(require("moment"), 1);
     init_logger();
     UsrCrsData = class {
       user;
@@ -7483,11 +6140,11 @@ var init_user_course_relDB = __esm({
         this._courseId = courseId;
       }
       async getReviewsForcast(daysCount) {
-        const time = import_moment6.default.utc().add(daysCount, "days");
+        const time = import_moment4.default.utc().add(daysCount, "days");
         return this.getReviewstoDate(time);
       }
       async getPendingReviews() {
-        const now = import_moment6.default.utc();
+        const now = import_moment4.default.utc();
         return this.getReviewstoDate(now);
       }
       async getScheduledReviewCount() {
@@ -7523,7 +6180,7 @@ var init_user_course_relDB = __esm({
           `Fetching ${this.user.getUsername()}'s scheduled reviews for course ${this._courseId}.`
         );
         return allReviews.filter((review) => {
-          const reviewTime = import_moment6.default.utc(review.reviewTime);
+          const reviewTime = import_moment4.default.utc(review.reviewTime);
           return targetDate.isAfter(reviewTime);
         });
       }
@@ -7705,14 +6362,14 @@ async function dropUserFromClassroom(user, classID) {
 async function getUserClassrooms(user) {
   return getOrCreateClassroomRegistrationsDoc(user);
 }
-var import_common17, import_moment7, log3, BaseUser, userCoursesDoc, userClassroomsDoc;
+var import_common13, import_moment5, log3, BaseUser, userCoursesDoc, userClassroomsDoc;
 var init_BaseUserDB = __esm({
   "src/impl/common/BaseUserDB.ts"() {
     "use strict";
     init_core();
     init_util();
-    import_common17 = require("@vue-skuilder/common");
-    import_moment7 = __toESM(require("moment"), 1);
+    import_common13 = require("@vue-skuilder/common");
+    import_moment5 = __toESM(require("moment"), 1);
     init_types_legacy();
     init_logger();
     init_userDBHelpers();
@@ -7761,7 +6418,7 @@ Currently logged-in as ${this._username}.`
           );
         }
         const result = await this.syncStrategy.createAccount(username, password);
-        if (result.status === import_common17.Status.ok) {
+        if (result.status === import_common13.Status.ok) {
           log3(`Account created successfully, updating username to ${username}`);
           this._username = username;
           try {
@@ -7803,7 +6460,7 @@ Currently logged-in as ${this._username}.`
       async resetUserData() {
         if (this.syncStrategy.canAuthenticate()) {
           return {
-            status: import_common17.Status.error,
+            status: import_common13.Status.error,
             error: "Reset user data is only available for local-only mode. Use logout instead for remote sync."
           };
         }
@@ -7825,11 +6482,11 @@ Currently logged-in as ${this._username}.`
             await localDB.bulkDocs(docsToDelete);
           }
           await this.init();
-          return { status: import_common17.Status.ok };
+          return { status: import_common13.Status.ok };
         } catch (error) {
           logger.error("Failed to reset user data:", error);
           return {
-            status: import_common17.Status.error,
+            status: import_common13.Status.error,
             error: error instanceof Error ? error.message : "Unknown error during reset"
           };
         }
@@ -7976,7 +6633,7 @@ Currently logged-in as ${this._username}.`
         );
         return reviews.rows.filter((r) => {
           if (r.id.startsWith(DocTypePrefixes["SCHEDULED_CARD" /* SCHEDULED_CARD */])) {
-            const date = import_moment7.default.utc(
+            const date = import_moment5.default.utc(
               r.id.substr(DocTypePrefixes["SCHEDULED_CARD" /* SCHEDULED_CARD */].length),
               REVIEW_TIME_FORMAT2
             );
@@ -7989,11 +6646,11 @@ Currently logged-in as ${this._username}.`
         }).map((r) => r.doc);
       }
       async getReviewsForcast(daysCount) {
-        const time = import_moment7.default.utc().add(daysCount, "days");
+        const time = import_moment5.default.utc().add(daysCount, "days");
         return this.getReviewstoDate(time);
       }
       async getPendingReviews(course_id) {
-        const now = import_moment7.default.utc();
+        const now = import_moment5.default.utc();
         return this.getReviewstoDate(now, course_id);
       }
       async getScheduledReviewCount(course_id) {
@@ -8280,7 +6937,7 @@ Currently logged-in as ${this._username}.`
        */
       async putCardRecord(record) {
         const cardHistoryID = getCardHistoryID(record.courseID, record.cardID);
-        record.timeStamp = import_moment7.default.utc(record.timeStamp).toString();
+        record.timeStamp = import_moment5.default.utc(record.timeStamp).toString();
         try {
           const cardHistory = await this.update(
             cardHistoryID,
@@ -8296,7 +6953,7 @@ Currently logged-in as ${this._username}.`
             const ret = {
               ...record2
             };
-            ret.timeStamp = import_moment7.default.utc(record2.timeStamp);
+            ret.timeStamp = import_moment5.default.utc(record2.timeStamp);
             return ret;
           });
           return cardHistory;
@@ -9012,14 +7669,14 @@ var init_auth = __esm({
 });
 
 // src/impl/couch/CouchDBSyncStrategy.ts
-var import_common19, log4, CouchDBSyncStrategy;
+var import_common15, log4, CouchDBSyncStrategy;
 var init_CouchDBSyncStrategy = __esm({
   "src/impl/couch/CouchDBSyncStrategy.ts"() {
     "use strict";
     init_factory();
     init_types_legacy();
     init_logger();
-    import_common19 = require("@vue-skuilder/common");
+    import_common15 = require("@vue-skuilder/common");
     init_common();
     init_pouchdb_setup();
     init_couch();
@@ -9090,32 +7747,32 @@ var init_CouchDBSyncStrategy = __esm({
                 }
               }
               return {
-                status: import_common19.Status.ok,
+                status: import_common15.Status.ok,
                 error: void 0
               };
             } else {
               return {
-                status: import_common19.Status.error,
+                status: import_common15.Status.error,
                 error: "Failed to log in after account creation"
               };
             }
           } else {
             logger.warn(`Signup not OK: ${JSON.stringify(signupRequest)}`);
             return {
-              status: import_common19.Status.error,
+              status: import_common15.Status.error,
               error: "Account creation failed"
             };
           }
         } catch (e) {
           if (e.reason === "Document update conflict.") {
             return {
-              status: import_common19.Status.error,
+              status: import_common15.Status.error,
               error: "This username is taken!"
             };
           }
           logger.error(`Error on signup: ${JSON.stringify(e)}`);
           return {
-            status: import_common19.Status.error,
+            status: import_common15.Status.error,
             error: e.message || "Unknown error during account creation"
           };
         }
@@ -9355,7 +8012,7 @@ async function usernameIsAvailable(username) {
   }
 }
 function updateGuestAccountExpirationDate2(guestDB) {
-  const currentTime = import_moment8.default.utc();
+  const currentTime = import_moment6.default.utc();
   const expirationDate = currentTime.add(2, "months").toISOString();
   void guestDB.get(expiryDocID).then((doc) => {
     return guestDB.put({
@@ -9418,7 +8075,7 @@ function getCouchUserDB(username) {
   return ret;
 }
 function scheduleCardReview(review) {
-  const now = import_moment8.default.utc();
+  const now = import_moment6.default.utc();
   logger.info(`Scheduling for review in: ${review.time.diff(now, "h") / 24} days`);
   void getCouchUserDB(review.user).put({
     _id: DocTypePrefixes["SCHEDULED_CARD" /* SCHEDULED_CARD */] + review.time.format(REVIEW_TIME_FORMAT),
@@ -9447,13 +8104,13 @@ function getStartAndEndKeys(key) {
     endkey: key + "\uFFF0"
   };
 }
-var import_cross_fetch2, import_moment8, import_process, isBrowser, expiryDocID, GUEST_LOCAL_DB, localUserDB, pouchDBincludeCredentialsConfig, REVIEW_TIME_FORMAT;
+var import_cross_fetch2, import_moment6, import_process, isBrowser, expiryDocID, GUEST_LOCAL_DB, localUserDB, pouchDBincludeCredentialsConfig, REVIEW_TIME_FORMAT;
 var init_couch = __esm({
   "src/impl/couch/index.ts"() {
     init_factory();
     init_types_legacy();
     import_cross_fetch2 = __toESM(require("cross-fetch"), 1);
-    import_moment8 = __toESM(require("moment"), 1);
+    import_moment6 = __toESM(require("moment"), 1);
     init_logger();
     init_pouchdb_setup();
     import_process = __toESM(require("process"), 1);