@vue-skuilder/db 0.1.30 → 0.1.31-b

package/dist/index.js

@@ -966,6 +966,7 @@ var MAX_RUNS, runHistory, pipelineDebugAPI;
 var init_PipelineDebugger = __esm({
   "src/core/navigators/PipelineDebugger.ts"() {
     "use strict";
+    init_navigators();
     init_logger();
     MAX_RUNS = 10;
     runHistory = [];
@@ -1108,6 +1109,66 @@ var init_PipelineDebugger = __esm({
         runHistory.length = 0;
         logger.info("[Pipeline Debug] Run history cleared.");
       },
+      /**
+       * Show the navigator registry: all registered classes and their roles.
+       *
+       * Useful for verifying that consumer-defined navigators were registered
+       * before pipeline assembly.
+       */
+      showRegistry() {
+        const names = getRegisteredNavigatorNames();
+        if (names.length === 0) {
+          logger.info("[Pipeline Debug] Navigator registry is empty.");
+          return;
+        }
+        console.group("\u{1F4E6} Navigator Registry");
+        console.table(
+          names.map((name) => {
+            const registryRole = getRegisteredNavigatorRole(name);
+            const builtinRole = NavigatorRoles[name];
+            const effectiveRole = builtinRole || registryRole || "\u26A0\uFE0F NONE";
+            const source = builtinRole ? "built-in" : registryRole ? "consumer" : "unclassified";
+            return {
+              name,
+              role: effectiveRole,
+              source,
+              isGenerator: isGenerator(name),
+              isFilter: isFilter(name)
+            };
+          })
+        );
+        console.groupEnd();
+      },
+      /**
+       * Show strategy documents from the last pipeline run and how they mapped
+       * to the registry.
+       *
+       * If no runs are captured yet, falls back to showing just the registry.
+       */
+      showStrategies() {
+        this.showRegistry();
+        if (runHistory.length === 0) {
+          logger.info("[Pipeline Debug] No pipeline runs captured yet \u2014 cannot show strategy doc mapping.");
+          return;
+        }
+        const run = runHistory[0];
+        console.group("\u{1F50C} Pipeline Strategy Mapping (last run)");
+        logger.info(`Generator: ${run.generatorName}`);
+        if (run.generators && run.generators.length > 0) {
+          for (const g of run.generators) {
+            logger.info(`  \u{1F4E5} ${g.name}: ${g.cardCount} cards (${g.newCount} new, ${g.reviewCount} reviews)`);
+          }
+        }
+        if (run.filters.length > 0) {
+          logger.info("Filters:");
+          for (const f of run.filters) {
+            logger.info(`  \u{1F538} ${f.name}: \u2191${f.boosted} \u2193${f.penalized} =${f.passed} \u2715${f.removed}`);
+          }
+        } else {
+          logger.info("Filters: (none)");
+        }
+        console.groupEnd();
+      },
       /**
        * Show help.
        */
@@ -1120,6 +1181,8 @@ Commands:
   .showRun(id|index)     Show summary of a specific run (by index or ID suffix)
   .showCard(cardId)      Show provenance trail for a specific card
   .explainReviews()      Analyze why reviews were/weren't selected
+  .showRegistry()        Show navigator registry (classes + roles)
+  .showStrategies()      Show registry + strategy mapping from last run
   .listRuns()            List all captured runs in table format
   .export()              Export run history as JSON for bug reports
   .clear()               Clear run history
@@ -1382,19 +1445,20 @@ var init_elo = __esm({
         const scored = newCards.map((c, i) => {
           const cardElo = cardEloData[i]?.global?.score ?? 1e3;
           const distance = Math.abs(cardElo - userGlobalElo);
-          const score = Math.max(0, 1 - distance / 500);
+          const rawScore = Math.max(0, 1 - distance / 500);
+          const samplingKey = rawScore > 0 ? Math.random() ** (1 / rawScore) : 0;
           return {
             cardId: c.cardID,
             courseId: c.courseID,
-            score,
+            score: samplingKey,
             provenance: [
               {
                 strategy: "elo",
                 strategyName: this.strategyName || this.name,
                 strategyId: this.strategyId || "NAVIGATION_STRATEGY-ELO-default",
                 action: "generated",
-                score,
-                reason: `ELO distance ${Math.round(distance)} (card: ${Math.round(cardElo)}, user: ${Math.round(userGlobalElo)}), new card`
+                score: samplingKey,
+                reason: `ELO distance ${Math.round(distance)} (card: ${Math.round(cardElo)}, user: ${Math.round(userGlobalElo)}), raw ${rawScore.toFixed(3)}, key ${samplingKey.toFixed(3)}`
               }
             ]
           };
@@ -8367,6 +8431,7 @@ init_couch();
 // src/study/SpacedRepetition.ts
 init_util();
 var import_moment7 = __toESM(require("moment"), 1);
+var import_common22 = require("@vue-skuilder/common");
 init_logger();
 var duration = import_moment7.default.duration;
 function newInterval(user, cardHistory) {
@@ -8387,7 +8452,9 @@ function newQuestionInterval(user, cardHistory) {
     });
   }
   if (currentAttempt.isCorrect) {
-    const skill = Math.min(1, Math.max(0, currentAttempt.performance));
+    const rawPerf = currentAttempt.performance;
+    const numericPerf = (0, import_common22.isTaggedPerformance)(rawPerf) ? rawPerf._global : rawPerf;
+    const skill = Math.min(1, Math.max(0, numericPerf));
     logger.debug(`Demontrated skill: 	${skill}`);
     const interval = lastInterval * (0.75 + skill);
     cardHistory.lapses = getLapses(cardHistory.records);
@@ -8478,7 +8545,7 @@ var SrsService = class {
 };
 
 // src/study/services/EloService.ts
-var import_common22 = require("@vue-skuilder/common");
+var import_common23 = require("@vue-skuilder/common");
 init_logger();
 var EloService = class {
   dataLayer;
@@ -8501,12 +8568,12 @@ var EloService = class {
       logger.warn(`k value interpretation not currently implemented`);
     }
     const courseDB = this.dataLayer.getCourseDB(currentCard.card.course_id);
-    const userElo = (0, import_common22.toCourseElo)(
+    const userElo = (0, import_common23.toCourseElo)(
       userCourseRegDoc.courses.find((c) => c.courseID === course_id).elo
     );
     const cardElo = (await courseDB.getCardEloData([currentCard.card.card_id]))[0];
     if (cardElo && userElo) {
-      const eloUpdate = (0, import_common22.adjustCourseScores)(userElo, cardElo, userScore);
+      const eloUpdate = (0, import_common23.adjustCourseScores)(userElo, cardElo, userScore);
       userCourseRegDoc.courses.find((c) => c.courseID === course_id).elo = eloUpdate.userElo;
       const results = await Promise.allSettled([
         this.user.updateUserElo(course_id, eloUpdate.userElo),
@@ -8552,12 +8619,12 @@ var EloService = class {
    */
   async updateUserAndCardEloPerTag(taggedPerformance, course_id, card_id, userCourseRegDoc, currentCard) {
     const courseDB = this.dataLayer.getCourseDB(currentCard.card.course_id);
-    const userElo = (0, import_common22.toCourseElo)(
+    const userElo = (0, import_common23.toCourseElo)(
       userCourseRegDoc.courses.find((c) => c.courseID === course_id).elo
     );
     const cardElo = (await courseDB.getCardEloData([currentCard.card.card_id]))[0];
     if (cardElo && userElo) {
-      const eloUpdate = (0, import_common22.adjustCourseScoresPerTag)(userElo, cardElo, taggedPerformance);
+      const eloUpdate = (0, import_common23.adjustCourseScoresPerTag)(userElo, cardElo, taggedPerformance);
       userCourseRegDoc.courses.find((c) => c.courseID === course_id).elo = eloUpdate.userElo;
       const results = await Promise.allSettled([
         this.user.updateUserElo(course_id, eloUpdate.userElo),
@@ -8597,7 +8664,7 @@ var EloService = class {
 // src/study/services/ResponseProcessor.ts
 init_core();
 init_logger();
-var import_common23 = require("@vue-skuilder/common");
+var import_common24 = require("@vue-skuilder/common");
 var ResponseProcessor = class {
   srsService;
   eloService;
@@ -8618,7 +8685,7 @@ var ResponseProcessor = class {
         taggedPerformance: null
       };
     }
-    if ((0, import_common23.isTaggedPerformance)(performance2)) {
+    if ((0, import_common24.isTaggedPerformance)(performance2)) {
       return {
         globalScore: performance2._global,
         taggedPerformance: performance2
@@ -8826,7 +8893,7 @@ var ResponseProcessor = class {
 };
 
 // src/study/services/CardHydrationService.ts
-var import_common24 = require("@vue-skuilder/common");
+var import_common25 = require("@vue-skuilder/common");
 init_logger();
 function parseAudioURIs(data) {
   if (typeof data !== "string") return [];
@@ -8961,8 +9028,8 @@ var CardHydrationService = class {
     try {
       const courseDB = this.getCourseDB(item.courseID);
       const cardData = await courseDB.getCourseDoc(item.cardID);
-      if (!(0, import_common24.isCourseElo)(cardData.elo)) {
-        cardData.elo = (0, import_common24.toCourseElo)(cardData.elo);
+      if (!(0, import_common25.isCourseElo)(cardData.elo)) {
+        cardData.elo = (0, import_common25.toCourseElo)(cardData.elo);
       }
       const view = this.getViewComponent(cardData.id_view);
       const dataDocs = await Promise.all(
@@ -8986,7 +9053,7 @@ var CardHydrationService = class {
         );
         await Promise.allSettled(uniqueAudioUrls.map(prefetchAudio));
       }
-      const data = dataDocs.map(import_common24.displayableDataToViewData).reverse();
+      const data = dataDocs.map(import_common25.displayableDataToViewData).reverse();
       this.hydratedCards.set(item.cardID, {
         item,
         view,