@vue-skuilder/db 0.1.30 → 0.1.31-b

package/dist/core/index.d.cts

@@ -463,6 +463,20 @@ declare const pipelineDebugAPI: {
      * Clear run history.
      */
     clear(): void;
+    /**
+     * Show the navigator registry: all registered classes and their roles.
+     *
+     * Useful for verifying that consumer-defined navigators were registered
+     * before pipeline assembly.
+     */
+    showRegistry(): void;
+    /**
+     * 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(): void;
     /**
      * Show help.
      */

package/dist/core/index.d.ts

@@ -463,6 +463,20 @@ declare const pipelineDebugAPI: {
      * Clear run history.
      */
     clear(): void;
+    /**
+     * Show the navigator registry: all registered classes and their roles.
+     *
+     * Useful for verifying that consumer-defined navigators were registered
+     * before pipeline assembly.
+     */
+    showRegistry(): void;
+    /**
+     * 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(): void;
     /**
      * Show help.
      */

package/dist/core/index.js

@@ -813,6 +813,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 = [];
@@ -955,6 +956,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.
        */
@@ -967,6 +1028,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
@@ -1229,19 +1292,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)}`
               }
             ]
           };