@vue-skuilder/db 0.1.23 → 0.1.25

package/dist/index.mjs

@@ -1,5 +1,10 @@
 var __defProp = Object.defineProperty;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __glob = (map) => (path2) => {
+  var fn = map[path2];
+  if (fn) return fn();
+  throw new Error("Module not found in bundle: " + path2);
+};
 var __esm = (fn, res) => function __init() {
   return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
 };
@@ -96,6 +101,8 @@ var init_types_legacy = __esm({
       DocType3["TAG"] = "TAG";
       DocType3["NAVIGATION_STRATEGY"] = "NAVIGATION_STRATEGY";
       DocType3["STRATEGY_STATE"] = "STRATEGY_STATE";
+      DocType3["USER_OUTCOME"] = "USER_OUTCOME";
+      DocType3["STRATEGY_LEARNING_STATE"] = "STRATEGY_LEARNING_STATE";
       return DocType3;
     })(DocType || {});
     DocTypePrefixes = {
@@ -110,7 +117,9 @@ var init_types_legacy = __esm({
       ["VIEW" /* VIEW */]: "VIEW",
       ["PEDAGOGY" /* PEDAGOGY */]: "PEDAGOGY",
       ["NAVIGATION_STRATEGY" /* NAVIGATION_STRATEGY */]: "NAVIGATION_STRATEGY",
-      ["STRATEGY_STATE" /* STRATEGY_STATE */]: "STRATEGY_STATE"
+      ["STRATEGY_STATE" /* STRATEGY_STATE */]: "STRATEGY_STATE",
+      ["USER_OUTCOME" /* USER_OUTCOME */]: "USER_OUTCOME",
+      ["STRATEGY_LEARNING_STATE" /* STRATEGY_LEARNING_STATE */]: "STRATEGY_LEARNING_STATE"
     };
   }
 });
@@ -481,6 +490,15 @@ var init_user_course_relDB = __esm({
           void this.user.updateCourseSettings(this._courseId, updates);
         }
       }
+      async getStrategyState(strategyKey) {
+        return this.user.getStrategyState(this._courseId, strategyKey);
+      }
+      async putStrategyState(strategyKey, data) {
+        return this.user.putStrategyState(this._courseId, strategyKey, data);
+      }
+      async deleteStrategyState(strategyKey) {
+        return this.user.deleteStrategyState(this._courseId, strategyKey);
+      }
       async getReviewstoDate(targetDate) {
         const allReviews = await this.user.getPendingReviews(this._courseId);
         logger.debug(
@@ -831,359 +849,289 @@ var init_courseLookupDB = __esm({
   }
 });
 
-// src/core/navigators/index.ts
-function getCardOrigin(card) {
-  if (card.provenance.length === 0) {
-    throw new Error("Card has no provenance - cannot determine origin");
-  }
+// src/core/navigators/PipelineDebugger.ts
+var PipelineDebugger_exports = {};
+__export(PipelineDebugger_exports, {
+  buildRunReport: () => buildRunReport,
+  captureRun: () => captureRun,
+  mountPipelineDebugger: () => mountPipelineDebugger,
+  pipelineDebugAPI: () => pipelineDebugAPI
+});
+function getOrigin(card) {
   const firstEntry = card.provenance[0];
-  const reason = firstEntry.reason.toLowerCase();
-  if (reason.includes("failed")) {
-    return "failed";
-  }
-  if (reason.includes("review")) {
-    return "review";
+  if (!firstEntry) return "unknown";
+  const reason = firstEntry.reason?.toLowerCase() || "";
+  if (reason.includes("new card")) return "new";
+  if (reason.includes("review")) return "review";
+  return "unknown";
+}
+function captureRun(report) {
+  const fullReport = {
+    ...report,
+    runId: `run-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
+    timestamp: /* @__PURE__ */ new Date()
+  };
+  runHistory.unshift(fullReport);
+  if (runHistory.length > MAX_RUNS) {
+    runHistory.pop();
   }
-  return "new";
 }
-function isGenerator(impl) {
-  return NavigatorRoles[impl] === "generator" /* GENERATOR */;
+function buildRunReport(courseId, courseName, generatorName, generators, generatedCount, filters, allCards, selectedCards) {
+  const selectedIds = new Set(selectedCards.map((c) => c.cardId));
+  const cards = allCards.map((card) => ({
+    cardId: card.cardId,
+    courseId: card.courseId,
+    origin: getOrigin(card),
+    finalScore: card.score,
+    provenance: card.provenance,
+    selected: selectedIds.has(card.cardId)
+  }));
+  const reviewsSelected = selectedCards.filter((c) => getOrigin(c) === "review").length;
+  const newSelected = selectedCards.filter((c) => getOrigin(c) === "new").length;
+  return {
+    courseId,
+    courseName,
+    generatorName,
+    generators,
+    generatedCount,
+    filters,
+    finalCount: selectedCards.length,
+    reviewsSelected,
+    newSelected,
+    cards
+  };
 }
-function isFilter(impl) {
-  return NavigatorRoles[impl] === "filter" /* FILTER */;
+function formatProvenance(provenance) {
+  return provenance.map((p) => {
+    const actionSymbol = p.action === "generated" ? "\u{1F3B2}" : p.action === "boosted" ? "\u2B06\uFE0F" : p.action === "penalized" ? "\u2B07\uFE0F" : "\u27A1\uFE0F";
+    return `  ${actionSymbol} ${p.strategyName}: ${p.score.toFixed(3)} - ${p.reason}`;
+  }).join("\n");
 }
-var Navigators, NavigatorRole, NavigatorRoles, ContentNavigator;
-var init_navigators = __esm({
-  "src/core/navigators/index.ts"() {
+function printRunSummary(run) {
+  console.group(`\u{1F50D} Pipeline Run: ${run.courseId} (${run.courseName || "unnamed"})`);
+  logger.info(`Run ID: ${run.runId}`);
+  logger.info(`Time: ${run.timestamp.toISOString()}`);
+  logger.info(`Generator: ${run.generatorName} \u2192 ${run.generatedCount} candidates`);
+  if (run.generators && run.generators.length > 0) {
+    console.group("Generator breakdown:");
+    for (const g of run.generators) {
+      logger.info(
+        `  ${g.name}: ${g.cardCount} cards (${g.newCount} new, ${g.reviewCount} reviews, top: ${g.topScore.toFixed(2)})`
+      );
+    }
+    console.groupEnd();
+  }
+  if (run.filters.length > 0) {
+    console.group("Filter impact:");
+    for (const f of run.filters) {
+      logger.info(`  ${f.name}: \u2191${f.boosted} \u2193${f.penalized} =${f.passed} \u2715${f.removed}`);
+    }
+    console.groupEnd();
+  }
+  logger.info(
+    `Result: ${run.finalCount} cards selected (${run.newSelected} new, ${run.reviewsSelected} reviews)`
+  );
+  console.groupEnd();
+}
+function mountPipelineDebugger() {
+  if (typeof window === "undefined") return;
+  const win = window;
+  win.skuilder = win.skuilder || {};
+  win.skuilder.pipeline = pipelineDebugAPI;
+}
+var MAX_RUNS, runHistory, pipelineDebugAPI;
+var init_PipelineDebugger = __esm({
+  "src/core/navigators/PipelineDebugger.ts"() {
     "use strict";
     init_logger();
-    Navigators = /* @__PURE__ */ ((Navigators2) => {
-      Navigators2["ELO"] = "elo";
-      Navigators2["SRS"] = "srs";
-      Navigators2["HIERARCHY"] = "hierarchyDefinition";
-      Navigators2["INTERFERENCE"] = "interferenceMitigator";
-      Navigators2["RELATIVE_PRIORITY"] = "relativePriority";
-      Navigators2["USER_TAG_PREFERENCE"] = "userTagPreference";
-      return Navigators2;
-    })(Navigators || {});
-    NavigatorRole = /* @__PURE__ */ ((NavigatorRole2) => {
-      NavigatorRole2["GENERATOR"] = "generator";
-      NavigatorRole2["FILTER"] = "filter";
-      return NavigatorRole2;
-    })(NavigatorRole || {});
-    NavigatorRoles = {
-      ["elo" /* ELO */]: "generator" /* GENERATOR */,
-      ["srs" /* SRS */]: "generator" /* GENERATOR */,
-      ["hierarchyDefinition" /* HIERARCHY */]: "filter" /* FILTER */,
-      ["interferenceMitigator" /* INTERFERENCE */]: "filter" /* FILTER */,
-      ["relativePriority" /* RELATIVE_PRIORITY */]: "filter" /* FILTER */,
-      ["userTagPreference" /* USER_TAG_PREFERENCE */]: "filter" /* FILTER */
-    };
-    ContentNavigator = class {
-      /** User interface for this navigation session */
-      user;
-      /** Course interface for this navigation session */
-      course;
-      /** Human-readable name for this strategy instance (from ContentNavigationStrategyData.name) */
-      strategyName;
-      /** Unique document ID for this strategy instance (from ContentNavigationStrategyData._id) */
-      strategyId;
+    MAX_RUNS = 10;
+    runHistory = [];
+    pipelineDebugAPI = {
       /**
-       * Constructor for standard navigators.
-       * Call this from subclass constructors to initialize common fields.
-       *
-       * Note: CompositeGenerator and Pipeline call super() without args, then set
-       * user/course fields directly if needed.
+       * Get raw run history for programmatic access.
        */
-      constructor(user, course, strategyData) {
-        this.user = user;
-        this.course = course;
-        if (strategyData) {
-          this.strategyName = strategyData.name;
-          this.strategyId = strategyData._id;
-        }
-      }
-      // ============================================================================
-      // STRATEGY STATE HELPERS
-      // ============================================================================
-      //
-      // These methods allow strategies to persist their own state (user preferences,
-      // learned patterns, temporal tracking) in the user database.
-      //
-      // ============================================================================
+      get runs() {
+        return [...runHistory];
+      },
       /**
-       * Unique key identifying this strategy for state storage.
-       *
-       * Defaults to the constructor name (e.g., "UserTagPreferenceFilter").
-       * Override in subclasses if multiple instances of the same strategy type
-       * need separate state storage.
+       * Show summary of a specific pipeline run.
        */
-      get strategyKey() {
-        return this.constructor.name;
-      }
+      showRun(idOrIndex = 0) {
+        if (runHistory.length === 0) {
+          logger.info("[Pipeline Debug] No runs captured yet.");
+          return;
+        }
+        let run;
+        if (typeof idOrIndex === "number") {
+          run = runHistory[idOrIndex];
+          if (!run) {
+            logger.info(
+              `[Pipeline Debug] No run found at index ${idOrIndex}. History length: ${runHistory.length}`
+            );
+            return;
+          }
+        } else {
+          run = runHistory.find((r) => r.runId.endsWith(idOrIndex));
+          if (!run) {
+            logger.info(`[Pipeline Debug] No run found matching ID '${idOrIndex}'.`);
+            return;
+          }
+        }
+        printRunSummary(run);
+      },
       /**
-       * Get this strategy's persisted state for the current course.
-       *
-       * @returns The strategy's data payload, or null if no state exists
-       * @throws Error if user or course is not initialized
+       * Show summary of the last pipeline run.
        */
-      async getStrategyState() {
-        if (!this.user || !this.course) {
-          throw new Error(
-            `Cannot get strategy state: navigator not properly initialized. Ensure user and course are provided to constructor.`
-          );
-        }
-        return this.user.getStrategyState(this.course.getCourseID(), this.strategyKey);
-      }
+      showLastRun() {
+        this.showRun(0);
+      },
       /**
-       * Persist this strategy's state for the current course.
-       *
-       * @param data - The strategy's data payload to store
-       * @throws Error if user or course is not initialized
+       * Show detailed provenance for a specific card.
        */
-      async putStrategyState(data) {
-        if (!this.user || !this.course) {
-          throw new Error(
-            `Cannot put strategy state: navigator not properly initialized. Ensure user and course are provided to constructor.`
-          );
+      showCard(cardId) {
+        for (const run of runHistory) {
+          const card = run.cards.find((c) => c.cardId === cardId);
+          if (card) {
+            console.group(`\u{1F3B4} Card: ${cardId}`);
+            logger.info(`Course: ${card.courseId}`);
+            logger.info(`Origin: ${card.origin}`);
+            logger.info(`Final score: ${card.finalScore.toFixed(3)}`);
+            logger.info(`Selected: ${card.selected ? "Yes \u2705" : "No \u274C"}`);
+            logger.info("Provenance:");
+            logger.info(formatProvenance(card.provenance));
+            console.groupEnd();
+            return;
+          }
         }
-        return this.user.putStrategyState(this.course.getCourseID(), this.strategyKey, data);
-      }
+        logger.info(`[Pipeline Debug] Card '${cardId}' not found in recent runs.`);
+      },
       /**
-       * Factory method to create navigator instances dynamically.
-       *
-       * @param user - User interface
-       * @param course - Course interface
-       * @param strategyData - Strategy configuration document
-       * @returns the runtime object used to steer a study session.
+       * Explain why reviews may or may not have been selected.
        */
-      static async create(user, course, strategyData) {
-        const implementingClass = strategyData.implementingClass;
-        let NavigatorImpl;
-        const variations = [".ts", ".js", ""];
-        const dirs = ["filters", "generators"];
-        for (const ext of variations) {
-          for (const dir of dirs) {
-            const loadFrom = `./${dir}/${implementingClass}${ext}`;
-            try {
-              const module = await import(loadFrom);
-              NavigatorImpl = module.default;
-              break;
-            } catch (e) {
-              logger.debug(`Failed to load extension from ${loadFrom}:`, e);
+      explainReviews() {
+        if (runHistory.length === 0) {
+          logger.info("[Pipeline Debug] No runs captured yet.");
+          return;
+        }
+        console.group("\u{1F4CB} Review Selection Analysis");
+        for (const run of runHistory) {
+          console.group(`Run: ${run.courseId} @ ${run.timestamp.toLocaleTimeString()}`);
+          const allReviews = run.cards.filter((c) => c.origin === "review");
+          const selectedReviews = allReviews.filter((c) => c.selected);
+          if (allReviews.length === 0) {
+            logger.info("\u274C No reviews were generated. Check SRS logs for why.");
+          } else if (selectedReviews.length === 0) {
+            logger.info(`\u26A0\uFE0F ${allReviews.length} reviews generated but none selected.`);
+            logger.info("Possible reasons:");
+            const topNewScore = Math.max(
+              ...run.cards.filter((c) => c.origin === "new" && c.selected).map((c) => c.finalScore),
+              0
+            );
+            const topReviewScore = Math.max(...allReviews.map((c) => c.finalScore), 0);
+            if (topReviewScore < topNewScore) {
+              logger.info(
+                `  - New cards scored higher (top new: ${topNewScore.toFixed(2)}, top review: ${topReviewScore.toFixed(2)})`
+              );
+            }
+            const topReview = allReviews.sort((a, b) => b.finalScore - a.finalScore)[0];
+            if (topReview) {
+              logger.info(`  - Top review score: ${topReview.finalScore.toFixed(3)}`);
+              logger.info("  - Its provenance:");
+              logger.info(formatProvenance(topReview.provenance));
             }
+          } else {
+            logger.info(`\u2705 ${selectedReviews.length}/${allReviews.length} reviews selected.`);
+            logger.info("Top selected review:");
+            const topSelected = selectedReviews.sort((a, b) => b.finalScore - a.finalScore)[0];
+            logger.info(formatProvenance(topSelected.provenance));
           }
+          console.groupEnd();
         }
-        if (!NavigatorImpl) {
-          throw new Error(`Could not load navigator implementation for: ${implementingClass}`);
+        console.groupEnd();
+      },
+      /**
+       * Show all runs in compact format.
+       */
+      listRuns() {
+        if (runHistory.length === 0) {
+          logger.info("[Pipeline Debug] No runs captured yet.");
+          return;
         }
-        return new NavigatorImpl(user, course, strategyData);
-      }
+        console.table(
+          runHistory.map((r) => ({
+            id: r.runId.slice(-8),
+            time: r.timestamp.toLocaleTimeString(),
+            course: r.courseName || r.courseId.slice(0, 8),
+            generated: r.generatedCount,
+            selected: r.finalCount,
+            new: r.newSelected,
+            reviews: r.reviewsSelected
+          }))
+        );
+      },
       /**
-       * Get cards with suitability scores and provenance trails.
-       *
-       * **This is the PRIMARY API for navigation strategies.**
-       *
-       * Returns cards ranked by suitability score (0-1). Higher scores indicate
-       * better candidates for presentation. Each card includes a provenance trail
-       * documenting how strategies contributed to the final score.
-       *
-       * ## Implementation Required
-       * All navigation strategies MUST override this method. The base class does
-       * not provide a default implementation.
-       *
-       * ## For Generators
-       * Override this method to generate candidates and compute scores based on
-       * your strategy's logic (e.g., ELO proximity, review urgency). Create the
-       * initial provenance entry with action='generated'.
-       *
-       * ## For Filters
-       * Filters should implement the CardFilter interface instead and be composed
-       * via Pipeline. Filters do not directly implement getWeightedCards().
-       *
-       * @param limit - Maximum cards to return
-       * @returns Cards sorted by score descending, with provenance trails
+       * Export run history as JSON for bug reports.
        */
-      async getWeightedCards(_limit) {
-        throw new Error(`${this.constructor.name} must implement getWeightedCards(). `);
+      export() {
+        const json = JSON.stringify(runHistory, null, 2);
+        logger.info("[Pipeline Debug] Run history exported. Copy the returned string or use:");
+        logger.info("  copy(window.skuilder.pipeline.export())");
+        return json;
+      },
+      /**
+       * Clear run history.
+       */
+      clear() {
+        runHistory.length = 0;
+        logger.info("[Pipeline Debug] Run history cleared.");
+      },
+      /**
+       * Show help.
+       */
+      help() {
+        logger.info(`
+\u{1F527} Pipeline Debug API
+
+Commands:
+  .showLastRun()         Show summary of most recent pipeline run
+  .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
+  .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.pipeline.showLastRun()
+  window.skuilder.pipeline.showRun(1)
+  window.skuilder.pipeline.showCard('abc123')
+`);
       }
     };
+    mountPipelineDebugger();
   }
 });
 
-// src/core/navigators/Pipeline.ts
-import { toCourseElo as toCourseElo2 } from "@vue-skuilder/common";
-function logPipelineConfig(generator, filters) {
-  const filterList = filters.length > 0 ? "\n    - " + filters.map((f) => f.name).join("\n    - ") : " none";
-  logger.info(
-    `[Pipeline] Configuration:
-  Generator: ${generator.name}
-  Filters:${filterList}`
-  );
-}
-function logTagHydration(cards, tagsByCard) {
-  const totalTags = Array.from(tagsByCard.values()).reduce((sum, tags) => sum + tags.length, 0);
-  const cardsWithTags = Array.from(tagsByCard.values()).filter((tags) => tags.length > 0).length;
-  logger.debug(
-    `[Pipeline] Tag hydration: ${cards.length} cards, ${cardsWithTags} have tags (${totalTags} total tags) - single batch query`
-  );
-}
-function logExecutionSummary(generatorName, generatedCount, filterCount, finalCount, topScores) {
-  const scoreDisplay = topScores.length > 0 ? topScores.map((s) => s.toFixed(2)).join(", ") : "none";
-  logger.info(
-    `[Pipeline] Execution: ${generatorName} produced ${generatedCount} \u2192 ${filterCount} filters \u2192 ${finalCount} results (top scores: ${scoreDisplay})`
-  );
-}
-function logCardProvenance(cards, maxCards = 3) {
-  const cardsToLog = cards.slice(0, maxCards);
-  logger.debug(`[Pipeline] Provenance for top ${cardsToLog.length} cards:`);
-  for (const card of cardsToLog) {
-    logger.debug(`[Pipeline]   ${card.cardId} (final score: ${card.score.toFixed(3)}):`);
-    for (const entry of card.provenance) {
-      const scoreChange = entry.score.toFixed(3);
-      const action = entry.action.padEnd(9);
-      logger.debug(
-        `[Pipeline]     ${action} ${scoreChange} - ${entry.strategyName}: ${entry.reason}`
-      );
-    }
-  }
-}
-var Pipeline;
-var init_Pipeline = __esm({
-  "src/core/navigators/Pipeline.ts"() {
-    "use strict";
-    init_navigators();
-    init_logger();
-    Pipeline = class extends ContentNavigator {
-      generator;
-      filters;
-      /**
-       * Create a new pipeline.
-       *
-       * @param generator - The generator (or CompositeGenerator) that produces candidates
-       * @param filters - Filters to apply sequentially (order doesn't matter for multipliers)
-       * @param user - User database interface
-       * @param course - Course database interface
-       */
-      constructor(generator, filters, user, course) {
-        super();
-        this.generator = generator;
-        this.filters = filters;
-        this.user = user;
-        this.course = course;
-        course.getCourseConfig().then((cfg) => {
-          logger.debug(`[pipeline] Crated pipeline for ${cfg.name}`);
-        }).catch((e) => {
-          logger.error(`[pipeline] Failed to lookup courseCfg: ${e}`);
-        });
-        logPipelineConfig(generator, filters);
-      }
-      /**
-       * Get weighted cards by running generator and applying filters.
-       *
-       * 1. Build shared context (user ELO, etc.)
-       * 2. Get candidates from generator (passing context)
-       * 3. Batch hydrate tags for all candidates
-       * 4. Apply each filter sequentially
-       * 5. Remove zero-score cards
-       * 6. Sort by score descending
-       * 7. Return top N
-       *
-       * @param limit - Maximum number of cards to return
-       * @returns Cards sorted by score descending
-       */
-      async getWeightedCards(limit) {
-        const context = await this.buildContext();
-        const overFetchMultiplier = 2 + this.filters.length * 0.5;
-        const fetchLimit = Math.ceil(limit * overFetchMultiplier);
-        logger.debug(
-          `[Pipeline] Fetching ${fetchLimit} candidates from generator '${this.generator.name}'`
-        );
-        let cards = await this.generator.getWeightedCards(fetchLimit, context);
-        const generatedCount = cards.length;
-        logger.debug(`[Pipeline] Generator returned ${generatedCount} candidates`);
-        cards = await this.hydrateTags(cards);
-        for (const filter of this.filters) {
-          const beforeCount = cards.length;
-          cards = await filter.transform(cards, context);
-          logger.debug(`[Pipeline] Filter '${filter.name}': ${beforeCount} \u2192 ${cards.length} cards`);
-        }
-        cards = cards.filter((c) => c.score > 0);
-        cards.sort((a, b) => b.score - a.score);
-        const result = cards.slice(0, limit);
-        const topScores = result.slice(0, 3).map((c) => c.score);
-        logExecutionSummary(
-          this.generator.name,
-          generatedCount,
-          this.filters.length,
-          result.length,
-          topScores
-        );
-        logCardProvenance(result, 3);
-        return result;
-      }
-      /**
-       * Batch hydrate tags for all cards.
-       *
-       * Fetches tags for all cards in a single database query and attaches them
-       * to the WeightedCard objects. Filters can then use card.tags instead of
-       * making individual getAppliedTags() calls.
-       *
-       * @param cards - Cards to hydrate
-       * @returns Cards with tags populated
-       */
-      async hydrateTags(cards) {
-        if (cards.length === 0) {
-          return cards;
-        }
-        const cardIds = cards.map((c) => c.cardId);
-        const tagsByCard = await this.course.getAppliedTagsBatch(cardIds);
-        logTagHydration(cards, tagsByCard);
-        return cards.map((card) => ({
-          ...card,
-          tags: tagsByCard.get(card.cardId) ?? []
-        }));
-      }
-      /**
-       * Build shared context for generator and filters.
-       *
-       * Called once per getWeightedCards() invocation.
-       * Contains data that the generator and multiple filters might need.
-       *
-       * The context satisfies both GeneratorContext and FilterContext interfaces.
-       */
-      async buildContext() {
-        let userElo = 1e3;
-        try {
-          const courseReg = await this.user.getCourseRegDoc(this.course.getCourseID());
-          const courseElo = toCourseElo2(courseReg.elo);
-          userElo = courseElo.global.score;
-        } catch (e) {
-          logger.debug(`[Pipeline] Could not get user ELO, using default: ${e}`);
-        }
-        return {
-          user: this.user,
-          course: this.course,
-          userElo
-        };
-      }
-      /**
-       * Get the course ID for this pipeline.
-       */
-      getCourseID() {
-        return this.course.getCourseID();
-      }
-    };
-  }
-});
-
-// src/core/navigators/generators/CompositeGenerator.ts
-var DEFAULT_AGGREGATION_MODE, FREQUENCY_BOOST_FACTOR, CompositeGenerator;
-var init_CompositeGenerator = __esm({
-  "src/core/navigators/generators/CompositeGenerator.ts"() {
+// src/core/navigators/generators/CompositeGenerator.ts
+var CompositeGenerator_exports = {};
+__export(CompositeGenerator_exports, {
+  AggregationMode: () => AggregationMode,
+  default: () => CompositeGenerator
+});
+var AggregationMode, DEFAULT_AGGREGATION_MODE, FREQUENCY_BOOST_FACTOR, CompositeGenerator;
+var init_CompositeGenerator = __esm({
+  "src/core/navigators/generators/CompositeGenerator.ts"() {
     "use strict";
     init_navigators();
     init_logger();
+    AggregationMode = /* @__PURE__ */ ((AggregationMode2) => {
+      AggregationMode2["MAX"] = "max";
+      AggregationMode2["AVERAGE"] = "average";
+      AggregationMode2["FREQUENCY_BOOST"] = "frequencyBoost";
+      return AggregationMode2;
+    })(AggregationMode || {});
     DEFAULT_AGGREGATION_MODE = "frequencyBoost" /* FREQUENCY_BOOST */;
     FREQUENCY_BOOST_FACTOR = 0.1;
     CompositeGenerator = class _CompositeGenerator extends ContentNavigator {
@@ -1234,22 +1182,55 @@ var init_CompositeGenerator = __esm({
         const results = await Promise.all(
           this.generators.map((g) => g.getWeightedCards(limit, context))
         );
+        const generatorSummaries = [];
+        results.forEach((cards, index) => {
+          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 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`;
+            generatorSummaries.push(`${genName}: ${breakdown} (top: ${topScore})`);
+          } else {
+            generatorSummaries.push(`${genName}: 0 cards`);
+          }
+        });
+        logger.info(`[Composite] Generator breakdown: ${generatorSummaries.join(" | ")}`);
         const byCardId = /* @__PURE__ */ new Map();
-        for (const cards of results) {
+        results.forEach((cards, index) => {
+          const gen = this.generators[index];
+          let weight = gen.learnable?.weight ?? 1;
+          let deviation;
+          if (gen.learnable && !gen.staticWeight && context.orchestration) {
+            const strategyId = gen.strategyId;
+            if (strategyId) {
+              weight = context.orchestration.getEffectiveWeight(strategyId, gen.learnable);
+              deviation = context.orchestration.getDeviation(strategyId);
+            }
+          }
           for (const card of cards) {
+            if (card.provenance.length > 0) {
+              card.provenance[0].effectiveWeight = weight;
+              card.provenance[0].deviation = deviation;
+            }
             const existing = byCardId.get(card.cardId) || [];
-            existing.push(card);
+            existing.push({ card, weight });
             byCardId.set(card.cardId, existing);
           }
-        }
+        });
         const merged = [];
-        for (const [, cards] of byCardId) {
-          const aggregatedScore = this.aggregateScores(cards);
+        for (const [, items] of byCardId) {
+          const cards = 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 action = finalScore > initialScore ? "boosted" : finalScore < initialScore ? "penalized" : "passed";
-          const reason = this.buildAggregationReason(cards, finalScore);
+          const reason = this.buildAggregationReason(items, finalScore);
           merged.push({
             ...cards[0],
             score: finalScore,
@@ -1271,22 +1252,26 @@ var init_CompositeGenerator = __esm({
       /**
        * Build human-readable reason for score aggregation.
        */
-      buildAggregationReason(cards, finalScore) {
+      buildAggregationReason(items, finalScore) {
+        const cards = items.map((i) => i.card);
         const count = cards.length;
         const scores = cards.map((c) => c.score.toFixed(2)).join(", ");
         if (count === 1) {
-          return `Single generator, score ${finalScore.toFixed(2)}`;
+          const weightMsg = Math.abs(items[0].weight - 1) > 1e-3 ? ` (w=${items[0].weight.toFixed(2)})` : "";
+          return `Single generator, score ${finalScore.toFixed(2)}${weightMsg}`;
         }
         const strategies = cards.map((c) => c.provenance[0]?.strategy || "unknown").join(", ");
         switch (this.aggregationMode) {
           case "max" /* MAX */:
             return `Max of ${count} generators (${strategies}): scores [${scores}] \u2192 ${finalScore.toFixed(2)}`;
           case "average" /* AVERAGE */:
-            return `Average of ${count} generators (${strategies}): scores [${scores}] \u2192 ${finalScore.toFixed(2)}`;
+            return `Weighted Avg of ${count} generators (${strategies}): scores [${scores}] \u2192 ${finalScore.toFixed(2)}`;
           case "frequencyBoost" /* FREQUENCY_BOOST */: {
-            const avg = cards.reduce((sum, c) => sum + c.score, 0) / count;
+            const totalWeight = items.reduce((sum, i) => sum + i.weight, 0);
+            const weightedSum = items.reduce((sum, i) => sum + i.card.score * i.weight, 0);
+            const avg = totalWeight > 0 ? weightedSum / totalWeight : 0;
             const boost = 1 + FREQUENCY_BOOST_FACTOR * (count - 1);
-            return `Frequency boost from ${count} generators (${strategies}): avg ${avg.toFixed(2)} \xD7 ${boost.toFixed(2)} \u2192 ${finalScore.toFixed(2)}`;
+            return `Frequency boost from ${count} generators (${strategies}): w-avg ${avg.toFixed(2)} \xD7 ${boost.toFixed(2)} \u2192 ${finalScore.toFixed(2)}`;
           }
           default:
             return `Aggregated from ${count} generators: ${finalScore.toFixed(2)}`;
@@ -1295,16 +1280,22 @@ var init_CompositeGenerator = __esm({
       /**
        * Aggregate scores from multiple generators for the same card.
        */
-      aggregateScores(cards) {
-        const scores = cards.map((c) => c.score);
+      aggregateScores(items) {
+        const scores = items.map((i) => i.card.score);
         switch (this.aggregationMode) {
           case "max" /* MAX */:
             return Math.max(...scores);
-          case "average" /* AVERAGE */:
-            return scores.reduce((sum, s) => sum + s, 0) / scores.length;
+          case "average" /* AVERAGE */: {
+            const totalWeight = items.reduce((sum, i) => sum + i.weight, 0);
+            if (totalWeight === 0) return 0;
+            const weightedSum = items.reduce((sum, i) => sum + i.card.score * i.weight, 0);
+            return weightedSum / totalWeight;
+          }
           case "frequencyBoost" /* FREQUENCY_BOOST */: {
-            const avg = scores.reduce((sum, s) => sum + s, 0) / scores.length;
-            const frequencyBoost = 1 + FREQUENCY_BOOST_FACTOR * (cards.length - 1);
+            const totalWeight = items.reduce((sum, i) => sum + i.weight, 0);
+            const weightedSum = items.reduce((sum, i) => sum + i.card.score * i.weight, 0);
+            const avg = totalWeight > 0 ? weightedSum / totalWeight : 0;
+            const frequencyBoost = 1 + FREQUENCY_BOOST_FACTOR * (items.length - 1);
             return avg * frequencyBoost;
           }
           default:
@@ -1315,134 +1306,18 @@ var init_CompositeGenerator = __esm({
   }
 });
 
-// src/core/navigators/PipelineAssembler.ts
-var PipelineAssembler;
-var init_PipelineAssembler = __esm({
-  "src/core/navigators/PipelineAssembler.ts"() {
-    "use strict";
-    init_navigators();
-    init_Pipeline();
-    init_types_legacy();
-    init_logger();
-    init_CompositeGenerator();
-    PipelineAssembler = class {
-      /**
-       * Assembles a navigation pipeline from strategy documents.
-       *
-       * 1. Separates into generators and filters by role
-       * 2. Validates at least one generator exists (or creates default ELO)
-       * 3. Instantiates generators - wraps multiple in CompositeGenerator
-       * 4. Instantiates filters
-       * 5. Returns Pipeline(generator, filters)
-       *
-       * @param input - Strategy documents plus user/course interfaces
-       * @returns Assembled pipeline and any warnings
-       */
-      async assemble(input) {
-        const { strategies, user, course } = input;
-        const warnings = [];
-        if (strategies.length === 0) {
-          return {
-            pipeline: null,
-            generatorStrategies: [],
-            filterStrategies: [],
-            warnings
-          };
-        }
-        const generatorStrategies = [];
-        const filterStrategies = [];
-        for (const s of strategies) {
-          if (isGenerator(s.implementingClass)) {
-            generatorStrategies.push(s);
-          } else if (isFilter(s.implementingClass)) {
-            filterStrategies.push(s);
-          } else {
-            warnings.push(`Unknown strategy type '${s.implementingClass}', skipping: ${s.name}`);
-          }
-        }
-        if (generatorStrategies.length === 0) {
-          if (filterStrategies.length > 0) {
-            logger.debug(
-              "[PipelineAssembler] No generator found, using default ELO with configured filters"
-            );
-            generatorStrategies.push(this.makeDefaultEloStrategy(course.getCourseID()));
-          } else {
-            warnings.push("No generator strategy found");
-            return {
-              pipeline: null,
-              generatorStrategies: [],
-              filterStrategies: [],
-              warnings
-            };
-          }
-        }
-        let generator;
-        if (generatorStrategies.length === 1) {
-          const nav = await ContentNavigator.create(user, course, generatorStrategies[0]);
-          generator = nav;
-          logger.debug(`[PipelineAssembler] Using single generator: ${generatorStrategies[0].name}`);
-        } else {
-          logger.debug(
-            `[PipelineAssembler] Using CompositeGenerator for ${generatorStrategies.length} generators: ${generatorStrategies.map((g) => g.name).join(", ")}`
-          );
-          generator = await CompositeGenerator.fromStrategies(user, course, generatorStrategies);
-        }
-        const filters = [];
-        const sortedFilterStrategies = [...filterStrategies].sort(
-          (a, b) => a.name.localeCompare(b.name)
-        );
-        for (const filterStrategy of sortedFilterStrategies) {
-          try {
-            const nav = await ContentNavigator.create(user, course, filterStrategy);
-            if ("transform" in nav && typeof nav.transform === "function") {
-              filters.push(nav);
-              logger.debug(`[PipelineAssembler] Added filter: ${filterStrategy.name}`);
-            } else {
-              warnings.push(
-                `Filter '${filterStrategy.name}' does not implement CardFilter.transform(), skipping`
-              );
-            }
-          } catch (e) {
-            warnings.push(`Failed to instantiate filter '${filterStrategy.name}': ${e}`);
-          }
-        }
-        const pipeline = new Pipeline(generator, filters, user, course);
-        logger.debug(
-          `[PipelineAssembler] Assembled pipeline with ${generatorStrategies.length} generator(s) and ${filters.length} filter(s)`
-        );
-        return {
-          pipeline,
-          generatorStrategies,
-          filterStrategies: sortedFilterStrategies,
-          warnings
-        };
-      }
-      /**
-       * Creates a default ELO generator strategy.
-       * Used when filters are configured but no generator is specified.
-       */
-      makeDefaultEloStrategy(courseId) {
-        return {
-          _id: "NAVIGATION_STRATEGY-ELO-default",
-          course: courseId,
-          docType: "NAVIGATION_STRATEGY" /* NAVIGATION_STRATEGY */,
-          name: "ELO (default)",
-          description: "Default ELO-based generator",
-          implementingClass: "elo" /* ELO */,
-          serializedData: ""
-        };
-      }
-    };
-  }
-});
-
 // src/core/navigators/generators/elo.ts
-import { toCourseElo as toCourseElo3 } from "@vue-skuilder/common";
+var elo_exports = {};
+__export(elo_exports, {
+  default: () => ELONavigator
+});
+import { toCourseElo as toCourseElo2 } from "@vue-skuilder/common";
 var ELONavigator;
 var init_elo = __esm({
   "src/core/navigators/generators/elo.ts"() {
     "use strict";
     init_navigators();
+    init_logger();
     ELONavigator = class extends ContentNavigator {
       /** Human-readable name for CardGenerator interface */
       name;
@@ -1471,7 +1346,7 @@ var init_elo = __esm({
           userGlobalElo = context.userElo;
         } else {
           const courseReg = await this.user.getCourseRegDoc(this.course.getCourseID());
-          const userElo = toCourseElo3(courseReg.elo);
+          const userElo = toCourseElo2(courseReg.elo);
           userGlobalElo = userElo.global.score;
         }
         const activeCards = await this.user.getActiveCards();
@@ -1502,26 +1377,65 @@ var init_elo = __esm({
           };
         });
         scored.sort((a, b) => b.score - a.score);
-        return scored.slice(0, limit);
+        const result = scored.slice(0, limit);
+        if (result.length > 0) {
+          const topScores = result.slice(0, 3).map((c) => c.score.toFixed(2)).join(", ");
+          logger.info(
+            `[ELO] Course ${this.course.getCourseID()}: ${result.length} new cards (top scores: ${topScores})`
+          );
+        } else {
+          logger.info(`[ELO] Course ${this.course.getCourseID()}: No new cards available`);
+        }
+        return result;
       }
     };
   }
 });
 
+// src/core/navigators/generators/index.ts
+var generators_exports = {};
+var init_generators = __esm({
+  "src/core/navigators/generators/index.ts"() {
+    "use strict";
+  }
+});
+
 // src/core/navigators/generators/srs.ts
+var srs_exports = {};
+__export(srs_exports, {
+  default: () => SRSNavigator
+});
 import moment3 from "moment";
-var SRSNavigator;
+var DEFAULT_HEALTHY_BACKLOG, MAX_BACKLOG_PRESSURE, SRSNavigator;
 var init_srs = __esm({
   "src/core/navigators/generators/srs.ts"() {
     "use strict";
     init_navigators();
     init_logger();
+    DEFAULT_HEALTHY_BACKLOG = 20;
+    MAX_BACKLOG_PRESSURE = 0.5;
     SRSNavigator = class extends ContentNavigator {
       /** Human-readable name for CardGenerator interface */
       name;
+      /** Healthy backlog threshold - when exceeded, backlog pressure kicks in */
+      healthyBacklog;
       constructor(user, course, strategyData) {
         super(user, course, strategyData);
         this.name = strategyData?.name || "SRS";
+        const config = this.parseConfig(strategyData?.serializedData);
+        this.healthyBacklog = config.healthyBacklog ?? DEFAULT_HEALTHY_BACKLOG;
+      }
+      /**
+       * Parse configuration from serialized JSON.
+       */
+      parseConfig(serializedData) {
+        if (!serializedData) return {};
+        try {
+          return JSON.parse(serializedData);
+        } catch {
+          logger.warn("[SRS] Failed to parse strategy config, using defaults");
+          return {};
+        }
       }
       /**
        * Get review cards scored by urgency.
@@ -1529,6 +1443,7 @@ var init_srs = __esm({
        * Score formula combines:
        * - Relative overdueness: hoursOverdue / intervalHours
        * - Interval recency: exponential decay favoring shorter intervals
+       * - Backlog pressure: boost when due reviews exceed healthy threshold
        *
        * Cards not yet due are excluded (not scored as 0).
        *
@@ -1542,11 +1457,32 @@ var init_srs = __esm({
         if (!this.user || !this.course) {
           throw new Error("SRSNavigator requires user and course to be set");
         }
-        const reviews = await this.user.getPendingReviews(this.course.getCourseID());
+        const courseId = this.course.getCourseID();
+        const reviews = await this.user.getPendingReviews(courseId);
         const now = moment3.utc();
         const dueReviews = reviews.filter((r) => now.isAfter(moment3.utc(r.reviewTime)));
+        const backlogPressure = this.computeBacklogPressure(dueReviews.length);
+        if (dueReviews.length > 0) {
+          const pressureNote = backlogPressure > 0 ? ` [backlog pressure: +${backlogPressure.toFixed(2)}]` : ` [healthy backlog]`;
+          logger.info(
+            `[SRS] Course ${courseId}: ${dueReviews.length} reviews due now (of ${reviews.length} scheduled)${pressureNote}`
+          );
+        } else if (reviews.length > 0) {
+          const sortedByDue = [...reviews].sort(
+            (a, b) => moment3.utc(a.reviewTime).diff(moment3.utc(b.reviewTime))
+          );
+          const nextDue = sortedByDue[0];
+          const nextDueTime = moment3.utc(nextDue.reviewTime);
+          const untilDue = moment3.duration(nextDueTime.diff(now));
+          const untilDueStr = untilDue.asHours() < 1 ? `${Math.round(untilDue.asMinutes())}m` : untilDue.asHours() < 24 ? `${Math.round(untilDue.asHours())}h` : `${Math.round(untilDue.asDays())}d`;
+          logger.info(
+            `[SRS] Course ${courseId}: 0 reviews due now (${reviews.length} scheduled, next in ${untilDueStr})`
+          );
+        } else {
+          logger.info(`[SRS] Course ${courseId}: No reviews scheduled`);
+        }
         const scored = dueReviews.map((review) => {
-          const { score, reason } = this.computeUrgencyScore(review, now);
+          const { score, reason } = this.computeUrgencyScore(review, now, backlogPressure);
           return {
             cardId: review.cardId,
             courseId: review.courseId,
@@ -1564,143 +1500,2084 @@ var init_srs = __esm({
             ]
           };
         });
-        logger.debug(`[srsNav] got ${scored.length} weighted cards`);
         return scored.sort((a, b) => b.score - a.score).slice(0, limit);
       }
       /**
-       * Compute urgency score for a review card.
+       * Compute backlog pressure based on number of due reviews.
+       *
+       * Backlog pressure is 0 when at or below healthy threshold,
+       * and increases linearly above it, maxing out at MAX_BACKLOG_PRESSURE.
+       *
+       * Examples (with default healthyBacklog=20):
+       * - 10 due reviews → 0.00 (healthy)
+       * - 20 due reviews → 0.00 (at threshold)
+       * - 40 due reviews → 0.25 (2x threshold)
+       * - 60 due reviews → 0.50 (3x threshold, maxed)
+       *
+       * @param dueCount - Number of reviews currently due
+       * @returns Backlog pressure score to add to urgency (0 to MAX_BACKLOG_PRESSURE)
+       */
+      computeBacklogPressure(dueCount) {
+        if (dueCount <= this.healthyBacklog) {
+          return 0;
+        }
+        const excess = dueCount - this.healthyBacklog;
+        const pressure = excess / this.healthyBacklog * (MAX_BACKLOG_PRESSURE / 2);
+        return Math.min(MAX_BACKLOG_PRESSURE, pressure);
+      }
+      /**
+       * Compute urgency score for a review card.
+       *
+       * Three factors:
+       * 1. Relative overdueness = hoursOverdue / intervalHours
+       *    - 2 days overdue on 3-day interval = 0.67 (urgent)
+       *    - 2 days overdue on 180-day interval = 0.01 (not urgent)
+       *
+       * 2. Interval recency factor = 0.3 + 0.7 * exp(-intervalHours / 720)
+       *    - 24h interval → ~1.0 (very recent learning)
+       *    - 30 days (720h) → ~0.56
+       *    - 180 days → ~0.30
+       *
+       * 3. Backlog pressure = global boost when review backlog exceeds healthy threshold
+       *    - At healthy backlog: 0
+       *    - At 2x healthy: +0.25
+       *    - At 3x+ healthy: +0.50 (max)
+       *
+       * Combined: base 0.5 + (urgency factors * 0.45) + backlog pressure
+       * Result range: 0.5 to 1.0 (uncapped to allow high-urgency reviews to compete with new cards)
+       *
+       * @param review - The scheduled card to score
+       * @param now - Current time
+       * @param backlogPressure - Pre-computed backlog pressure (0 to 0.5)
+       */
+      computeUrgencyScore(review, now, backlogPressure) {
+        const scheduledAt = moment3.utc(review.scheduledAt);
+        const due = moment3.utc(review.reviewTime);
+        const intervalHours = Math.max(1, due.diff(scheduledAt, "hours"));
+        const hoursOverdue = now.diff(due, "hours");
+        const relativeOverdue = hoursOverdue / intervalHours;
+        const recencyFactor = 0.3 + 0.7 * Math.exp(-intervalHours / 720);
+        const overdueContribution = Math.min(1, Math.max(0, relativeOverdue));
+        const urgency = overdueContribution * 0.5 + recencyFactor * 0.5;
+        const baseScore = 0.5 + urgency * 0.45;
+        const score = Math.min(1, baseScore + backlogPressure);
+        const reasonParts = [
+          `${Math.round(hoursOverdue)}h overdue`,
+          `interval: ${Math.round(intervalHours)}h`,
+          `relative: ${relativeOverdue.toFixed(2)}`,
+          `recency: ${recencyFactor.toFixed(2)}`
+        ];
+        if (backlogPressure > 0) {
+          reasonParts.push(`backlog: +${backlogPressure.toFixed(2)}`);
+        }
+        reasonParts.push("review");
+        const reason = reasonParts.join(", ");
+        return { score, reason };
+      }
+    };
+  }
+});
+
+// src/core/navigators/generators/types.ts
+var types_exports = {};
+var init_types = __esm({
+  "src/core/navigators/generators/types.ts"() {
+    "use strict";
+  }
+});
+
+// import("./generators/**/*") in src/core/navigators/index.ts
+var globImport_generators;
+var init_ = __esm({
+  'import("./generators/**/*") in src/core/navigators/index.ts'() {
+    globImport_generators = __glob({
+      "./generators/CompositeGenerator.ts": () => Promise.resolve().then(() => (init_CompositeGenerator(), CompositeGenerator_exports)),
+      "./generators/elo.ts": () => Promise.resolve().then(() => (init_elo(), elo_exports)),
+      "./generators/index.ts": () => Promise.resolve().then(() => (init_generators(), generators_exports)),
+      "./generators/srs.ts": () => Promise.resolve().then(() => (init_srs(), srs_exports)),
+      "./generators/types.ts": () => Promise.resolve().then(() => (init_types(), types_exports))
+    });
+  }
+});
+
+// src/core/types/contentNavigationStrategy.ts
+var DEFAULT_LEARNABLE_WEIGHT;
+var init_contentNavigationStrategy = __esm({
+  "src/core/types/contentNavigationStrategy.ts"() {
+    "use strict";
+    DEFAULT_LEARNABLE_WEIGHT = {
+      weight: 1,
+      confidence: 0.1,
+      // Low confidence initially = wide exploration
+      sampleSize: 0
+    };
+  }
+});
+
+// src/core/navigators/filters/WeightedFilter.ts
+var WeightedFilter_exports = {};
+__export(WeightedFilter_exports, {
+  WeightedFilter: () => WeightedFilter
+});
+var WeightedFilter;
+var init_WeightedFilter = __esm({
+  "src/core/navigators/filters/WeightedFilter.ts"() {
+    "use strict";
+    init_contentNavigationStrategy();
+    WeightedFilter = class {
+      name;
+      inner;
+      learnable;
+      staticWeight;
+      strategyId;
+      constructor(inner, learnable = DEFAULT_LEARNABLE_WEIGHT, staticWeight = false, strategyId) {
+        this.inner = inner;
+        this.name = inner.name;
+        this.learnable = learnable;
+        this.staticWeight = staticWeight;
+        this.strategyId = strategyId;
+      }
+      /**
+       * Apply the inner filter, then scale its effect by the configured weight.
+       */
+      async transform(cards, context) {
+        let effectiveWeight = this.learnable.weight;
+        let deviation;
+        if (!this.staticWeight && context.orchestration) {
+          const strategyId = this.strategyId || this.inner.strategyId || this.name;
+          effectiveWeight = context.orchestration.getEffectiveWeight(strategyId, this.learnable);
+          deviation = context.orchestration.getDeviation(strategyId);
+        }
+        if (Math.abs(effectiveWeight - 1) < 1e-3) {
+          return this.inner.transform(cards, context);
+        }
+        const originalScores = /* @__PURE__ */ new Map();
+        for (const card of cards) {
+          originalScores.set(card.cardId, card.score);
+        }
+        const transformedCards = await this.inner.transform(cards, context);
+        return transformedCards.map((card) => {
+          const originalScore = originalScores.get(card.cardId);
+          if (originalScore === void 0 || originalScore === 0 || card.score === 0) {
+            return card;
+          }
+          const rawEffect = card.score / originalScore;
+          if (Math.abs(rawEffect - 1) < 1e-4) {
+            return card;
+          }
+          const weightedEffect = Math.pow(rawEffect, effectiveWeight);
+          const newScore = originalScore * weightedEffect;
+          const lastProvIndex = card.provenance.length - 1;
+          const lastProv = card.provenance[lastProvIndex];
+          if (lastProv) {
+            const updatedProvenance = [...card.provenance];
+            updatedProvenance[lastProvIndex] = {
+              ...lastProv,
+              score: newScore,
+              effectiveWeight,
+              deviation
+              // We can optionally append to the reason, but the structured field is key
+            };
+            return {
+              ...card,
+              score: newScore,
+              provenance: updatedProvenance
+            };
+          }
+          return {
+            ...card,
+            score: newScore
+          };
+        });
+      }
+    };
+  }
+});
+
+// src/core/navigators/filters/eloDistance.ts
+var eloDistance_exports = {};
+__export(eloDistance_exports, {
+  DEFAULT_HALF_LIFE: () => DEFAULT_HALF_LIFE,
+  DEFAULT_MAX_MULTIPLIER: () => DEFAULT_MAX_MULTIPLIER,
+  DEFAULT_MIN_MULTIPLIER: () => DEFAULT_MIN_MULTIPLIER,
+  createEloDistanceFilter: () => createEloDistanceFilter
+});
+function computeMultiplier(distance, halfLife, minMultiplier, maxMultiplier) {
+  const normalizedDistance = distance / halfLife;
+  const decay = Math.exp(-(normalizedDistance * normalizedDistance));
+  return minMultiplier + (maxMultiplier - minMultiplier) * decay;
+}
+function createEloDistanceFilter(config) {
+  const halfLife = config?.halfLife ?? DEFAULT_HALF_LIFE;
+  const minMultiplier = config?.minMultiplier ?? DEFAULT_MIN_MULTIPLIER;
+  const maxMultiplier = config?.maxMultiplier ?? DEFAULT_MAX_MULTIPLIER;
+  return {
+    name: "ELO Distance Filter",
+    async transform(cards, context) {
+      const { course, userElo } = context;
+      const cardIds = cards.map((c) => c.cardId);
+      const cardElos = await course.getCardEloData(cardIds);
+      return cards.map((card, i) => {
+        const cardElo = cardElos[i]?.global?.score ?? 1e3;
+        const distance = Math.abs(cardElo - userElo);
+        const multiplier = computeMultiplier(distance, halfLife, minMultiplier, maxMultiplier);
+        const newScore = card.score * multiplier;
+        const action = multiplier < maxMultiplier - 0.01 ? "penalized" : "passed";
+        return {
+          ...card,
+          score: newScore,
+          provenance: [
+            ...card.provenance,
+            {
+              strategy: "eloDistance",
+              strategyName: "ELO Distance Filter",
+              strategyId: "ELO_DISTANCE_FILTER",
+              action,
+              score: newScore,
+              reason: `ELO distance ${Math.round(distance)} (card: ${Math.round(cardElo)}, user: ${Math.round(userElo)}) \u2192 ${multiplier.toFixed(2)}x`
+            }
+          ]
+        };
+      });
+    }
+  };
+}
+var DEFAULT_HALF_LIFE, DEFAULT_MIN_MULTIPLIER, DEFAULT_MAX_MULTIPLIER;
+var init_eloDistance = __esm({
+  "src/core/navigators/filters/eloDistance.ts"() {
+    "use strict";
+    DEFAULT_HALF_LIFE = 200;
+    DEFAULT_MIN_MULTIPLIER = 0.3;
+    DEFAULT_MAX_MULTIPLIER = 1;
+  }
+});
+
+// src/core/navigators/filters/hierarchyDefinition.ts
+var hierarchyDefinition_exports = {};
+__export(hierarchyDefinition_exports, {
+  default: () => HierarchyDefinitionNavigator
+});
+import { toCourseElo as toCourseElo3 } from "@vue-skuilder/common";
+var DEFAULT_MIN_COUNT, HierarchyDefinitionNavigator;
+var init_hierarchyDefinition = __esm({
+  "src/core/navigators/filters/hierarchyDefinition.ts"() {
+    "use strict";
+    init_navigators();
+    DEFAULT_MIN_COUNT = 3;
+    HierarchyDefinitionNavigator = class extends ContentNavigator {
+      config;
+      /** Human-readable name for CardFilter interface */
+      name;
+      constructor(user, course, strategyData) {
+        super(user, course, strategyData);
+        this.config = this.parseConfig(strategyData.serializedData);
+        this.name = strategyData.name || "Hierarchy Definition";
+      }
+      parseConfig(serializedData) {
+        try {
+          const parsed = JSON.parse(serializedData);
+          return {
+            prerequisites: parsed.prerequisites || {}
+          };
+        } catch {
+          return {
+            prerequisites: {}
+          };
+        }
+      }
+      /**
+       * Check if a specific prerequisite is satisfied
+       */
+      isPrerequisiteMet(prereq, userTagElo, userGlobalElo) {
+        if (!userTagElo) return false;
+        const minCount = prereq.masteryThreshold?.minCount ?? DEFAULT_MIN_COUNT;
+        if (userTagElo.count < minCount) return false;
+        if (prereq.masteryThreshold?.minElo !== void 0) {
+          return userTagElo.score >= prereq.masteryThreshold.minElo;
+        } else {
+          return userTagElo.score >= userGlobalElo;
+        }
+      }
+      /**
+       * Get the set of tags the user has mastered.
+       * A tag is "mastered" if it appears as a prerequisite somewhere and meets its threshold.
+       */
+      async getMasteredTags(context) {
+        const mastered = /* @__PURE__ */ new Set();
+        try {
+          const courseReg = await context.user.getCourseRegDoc(context.course.getCourseID());
+          const userElo = toCourseElo3(courseReg.elo);
+          for (const prereqs of Object.values(this.config.prerequisites)) {
+            for (const prereq of prereqs) {
+              const tagElo = userElo.tags[prereq.tag];
+              if (this.isPrerequisiteMet(prereq, tagElo, userElo.global.score)) {
+                mastered.add(prereq.tag);
+              }
+            }
+          }
+        } catch {
+        }
+        return mastered;
+      }
+      /**
+       * Get the set of tags that are unlocked (prerequisites met)
+       */
+      getUnlockedTags(masteredTags) {
+        const unlocked = /* @__PURE__ */ new Set();
+        for (const [tagId, prereqs] of Object.entries(this.config.prerequisites)) {
+          const allPrereqsMet = prereqs.every((prereq) => masteredTags.has(prereq.tag));
+          if (allPrereqsMet) {
+            unlocked.add(tagId);
+          }
+        }
+        return unlocked;
+      }
+      /**
+       * Check if a tag has prerequisites defined in config
+       */
+      hasPrerequisites(tagId) {
+        return tagId in this.config.prerequisites;
+      }
+      /**
+       * Check if a card is unlocked and generate reason.
+       */
+      async checkCardUnlock(card, _course, unlockedTags, masteredTags) {
+        try {
+          const cardTags = card.tags ?? [];
+          const lockedTags = cardTags.filter(
+            (tag) => this.hasPrerequisites(tag) && !unlockedTags.has(tag)
+          );
+          if (lockedTags.length === 0) {
+            const tagList = cardTags.length > 0 ? cardTags.join(", ") : "none";
+            return {
+              isUnlocked: true,
+              reason: `Prerequisites met, tags: ${tagList}`
+            };
+          }
+          const missingPrereqs = lockedTags.flatMap((tag) => {
+            const prereqs = this.config.prerequisites[tag] || [];
+            return prereqs.filter((p) => !masteredTags.has(p.tag)).map((p) => p.tag);
+          });
+          return {
+            isUnlocked: false,
+            reason: `Blocked: missing prerequisites ${missingPrereqs.join(", ")} for tags ${lockedTags.join(", ")}`
+          };
+        } catch {
+          return {
+            isUnlocked: true,
+            reason: "Prerequisites check skipped (tag lookup failed)"
+          };
+        }
+      }
+      /**
+       * CardFilter.transform implementation.
+       *
+       * Apply prerequisite gating to cards. Cards with locked tags receive score: 0.
+       */
+      async transform(cards, context) {
+        const masteredTags = await this.getMasteredTags(context);
+        const unlockedTags = this.getUnlockedTags(masteredTags);
+        const gated = [];
+        for (const card of cards) {
+          const { isUnlocked, reason } = await this.checkCardUnlock(
+            card,
+            context.course,
+            unlockedTags,
+            masteredTags
+          );
+          const finalScore = isUnlocked ? card.score : 0;
+          const action = isUnlocked ? "passed" : "penalized";
+          gated.push({
+            ...card,
+            score: finalScore,
+            provenance: [
+              ...card.provenance,
+              {
+                strategy: "hierarchyDefinition",
+                strategyName: this.strategyName || this.name,
+                strategyId: this.strategyId || "NAVIGATION_STRATEGY-hierarchy",
+                action,
+                score: finalScore,
+                reason
+              }
+            ]
+          });
+        }
+        return gated;
+      }
+      /**
+       * Legacy getWeightedCards - now throws as filters should not be used as generators.
+       *
+       * Use transform() via Pipeline instead.
+       */
+      async getWeightedCards(_limit) {
+        throw new Error(
+          "HierarchyDefinitionNavigator is a filter and should not be used as a generator. Use Pipeline with a generator and this filter via transform()."
+        );
+      }
+    };
+  }
+});
+
+// src/core/navigators/filters/userTagPreference.ts
+var userTagPreference_exports = {};
+__export(userTagPreference_exports, {
+  default: () => UserTagPreferenceFilter
+});
+var UserTagPreferenceFilter;
+var init_userTagPreference = __esm({
+  "src/core/navigators/filters/userTagPreference.ts"() {
+    "use strict";
+    init_navigators();
+    UserTagPreferenceFilter = class extends ContentNavigator {
+      _strategyData;
+      /** Human-readable name for CardFilter interface */
+      name;
+      constructor(user, course, strategyData) {
+        super(user, course, strategyData);
+        this._strategyData = strategyData;
+        this.name = strategyData.name || "User Tag Preferences";
+      }
+      /**
+       * Compute multiplier for a card based on its tags and user preferences.
+       * Returns the maximum multiplier among all matching tags, or 1.0 if no matches.
+       */
+      computeMultiplier(cardTags, boostMap) {
+        const multipliers = cardTags.map((tag) => boostMap[tag]).filter((val) => val !== void 0);
+        if (multipliers.length === 0) {
+          return 1;
+        }
+        return Math.max(...multipliers);
+      }
+      /**
+       * Build human-readable reason for the filter's decision.
+       */
+      buildReason(cardTags, boostMap, multiplier) {
+        const matchingTags = cardTags.filter((tag) => boostMap[tag] === multiplier);
+        if (multiplier === 0) {
+          return `Excluded by user preference: ${matchingTags.join(", ")} (${multiplier}x)`;
+        }
+        if (multiplier < 1) {
+          return `Penalized by user preference: ${matchingTags.join(", ")} (${multiplier.toFixed(2)}x)`;
+        }
+        if (multiplier > 1) {
+          return `Boosted by user preference: ${matchingTags.join(", ")} (${multiplier.toFixed(2)}x)`;
+        }
+        return "No matching user preferences";
+      }
+      /**
+       * CardFilter.transform implementation.
+       *
+       * Apply user tag preferences:
+       * 1. Read preferences from strategy state
+       * 2. If no preferences, pass through unchanged
+       * 3. For each card:
+       *    - Look up tag in boost record
+       *    - If tag found: apply multiplier (0 = exclude, 1 = neutral, >1 = boost)
+       *    - If multiple tags match: use max multiplier
+       *    - Append provenance with clear reason
+       */
+      async transform(cards, _context) {
+        const prefs = await this.getStrategyState();
+        if (!prefs || Object.keys(prefs.boost).length === 0) {
+          return cards.map((card) => ({
+            ...card,
+            provenance: [
+              ...card.provenance,
+              {
+                strategy: "userTagPreference",
+                strategyName: this.strategyName || this.name,
+                strategyId: this.strategyId || this._strategyData._id,
+                action: "passed",
+                score: card.score,
+                reason: "No user tag preferences configured"
+              }
+            ]
+          }));
+        }
+        const adjusted = await Promise.all(
+          cards.map(async (card) => {
+            const cardTags = card.tags ?? [];
+            const multiplier = this.computeMultiplier(cardTags, prefs.boost);
+            const finalScore = Math.min(1, card.score * multiplier);
+            let action;
+            if (multiplier === 0 || multiplier < 1) {
+              action = "penalized";
+            } else if (multiplier > 1) {
+              action = "boosted";
+            } else {
+              action = "passed";
+            }
+            return {
+              ...card,
+              score: finalScore,
+              provenance: [
+                ...card.provenance,
+                {
+                  strategy: "userTagPreference",
+                  strategyName: this.strategyName || this.name,
+                  strategyId: this.strategyId || this._strategyData._id,
+                  action,
+                  score: finalScore,
+                  reason: this.buildReason(cardTags, prefs.boost, multiplier)
+                }
+              ]
+            };
+          })
+        );
+        return adjusted;
+      }
+      /**
+       * Legacy getWeightedCards - throws as filters should not be used as generators.
+       */
+      async getWeightedCards(_limit) {
+        throw new Error(
+          "UserTagPreferenceFilter is a filter and should not be used as a generator. Use Pipeline with a generator and this filter via transform()."
+        );
+      }
+    };
+  }
+});
+
+// src/core/navigators/filters/index.ts
+var filters_exports = {};
+__export(filters_exports, {
+  UserTagPreferenceFilter: () => UserTagPreferenceFilter,
+  createEloDistanceFilter: () => createEloDistanceFilter
+});
+var init_filters = __esm({
+  "src/core/navigators/filters/index.ts"() {
+    "use strict";
+    init_eloDistance();
+    init_userTagPreference();
+  }
+});
+
+// src/core/navigators/filters/inferredPreferenceStub.ts
+var inferredPreferenceStub_exports = {};
+__export(inferredPreferenceStub_exports, {
+  INFERRED_PREFERENCE_NAVIGATOR_STUB: () => INFERRED_PREFERENCE_NAVIGATOR_STUB
+});
+var INFERRED_PREFERENCE_NAVIGATOR_STUB;
+var init_inferredPreferenceStub = __esm({
+  "src/core/navigators/filters/inferredPreferenceStub.ts"() {
+    "use strict";
+    INFERRED_PREFERENCE_NAVIGATOR_STUB = true;
+  }
+});
+
+// src/core/navigators/filters/interferenceMitigator.ts
+var interferenceMitigator_exports = {};
+__export(interferenceMitigator_exports, {
+  default: () => InterferenceMitigatorNavigator
+});
+import { toCourseElo as toCourseElo4 } from "@vue-skuilder/common";
+var DEFAULT_MIN_COUNT2, DEFAULT_MIN_ELAPSED_DAYS, DEFAULT_INTERFERENCE_DECAY, InterferenceMitigatorNavigator;
+var init_interferenceMitigator = __esm({
+  "src/core/navigators/filters/interferenceMitigator.ts"() {
+    "use strict";
+    init_navigators();
+    DEFAULT_MIN_COUNT2 = 10;
+    DEFAULT_MIN_ELAPSED_DAYS = 3;
+    DEFAULT_INTERFERENCE_DECAY = 0.8;
+    InterferenceMitigatorNavigator = class extends ContentNavigator {
+      config;
+      /** Human-readable name for CardFilter interface */
+      name;
+      /** Precomputed map: tag -> set of { partner, decay } it interferes with */
+      interferenceMap;
+      constructor(user, course, strategyData) {
+        super(user, course, strategyData);
+        this.config = this.parseConfig(strategyData.serializedData);
+        this.interferenceMap = this.buildInterferenceMap();
+        this.name = strategyData.name || "Interference Mitigator";
+      }
+      parseConfig(serializedData) {
+        try {
+          const parsed = JSON.parse(serializedData);
+          let sets = parsed.interferenceSets || [];
+          if (sets.length > 0 && Array.isArray(sets[0])) {
+            sets = sets.map((tags) => ({ tags }));
+          }
+          return {
+            interferenceSets: sets,
+            maturityThreshold: {
+              minCount: parsed.maturityThreshold?.minCount ?? DEFAULT_MIN_COUNT2,
+              minElo: parsed.maturityThreshold?.minElo,
+              minElapsedDays: parsed.maturityThreshold?.minElapsedDays ?? DEFAULT_MIN_ELAPSED_DAYS
+            },
+            defaultDecay: parsed.defaultDecay ?? DEFAULT_INTERFERENCE_DECAY
+          };
+        } catch {
+          return {
+            interferenceSets: [],
+            maturityThreshold: {
+              minCount: DEFAULT_MIN_COUNT2,
+              minElapsedDays: DEFAULT_MIN_ELAPSED_DAYS
+            },
+            defaultDecay: DEFAULT_INTERFERENCE_DECAY
+          };
+        }
+      }
+      /**
+       * Build a map from each tag to its interference partners with decay coefficients.
+       * If tags A, B, C are in an interference group with decay 0.8, then:
+       * - A interferes with B (decay 0.8) and C (decay 0.8)
+       * - B interferes with A (decay 0.8) and C (decay 0.8)
+       * - etc.
+       */
+      buildInterferenceMap() {
+        const map = /* @__PURE__ */ new Map();
+        for (const group of this.config.interferenceSets) {
+          const decay = group.decay ?? this.config.defaultDecay ?? DEFAULT_INTERFERENCE_DECAY;
+          for (const tag of group.tags) {
+            if (!map.has(tag)) {
+              map.set(tag, []);
+            }
+            const partners = map.get(tag);
+            for (const other of group.tags) {
+              if (other !== tag) {
+                const existing = partners.find((p) => p.partner === other);
+                if (existing) {
+                  existing.decay = Math.max(existing.decay, decay);
+                } else {
+                  partners.push({ partner: other, decay });
+                }
+              }
+            }
+          }
+        }
+        return map;
+      }
+      /**
+       * Get the set of tags that are currently immature for this user.
+       * A tag is immature if the user has interacted with it but hasn't
+       * reached the maturity threshold.
+       */
+      async getImmatureTags(context) {
+        const immature = /* @__PURE__ */ new Set();
+        try {
+          const courseReg = await context.user.getCourseRegDoc(context.course.getCourseID());
+          const userElo = toCourseElo4(courseReg.elo);
+          const minCount = this.config.maturityThreshold?.minCount ?? DEFAULT_MIN_COUNT2;
+          const minElo = this.config.maturityThreshold?.minElo;
+          const minElapsedDays = this.config.maturityThreshold?.minElapsedDays ?? DEFAULT_MIN_ELAPSED_DAYS;
+          const minCountForElapsed = minElapsedDays * 2;
+          for (const [tagId, tagElo] of Object.entries(userElo.tags)) {
+            if (tagElo.count === 0) continue;
+            const belowCount = tagElo.count < minCount;
+            const belowElo = minElo !== void 0 && tagElo.score < minElo;
+            const belowElapsed = tagElo.count < minCountForElapsed;
+            if (belowCount || belowElo || belowElapsed) {
+              immature.add(tagId);
+            }
+          }
+        } catch {
+        }
+        return immature;
+      }
+      /**
+       * Get all tags that interfere with any immature tag, along with their decay coefficients.
+       * These are the tags we want to avoid introducing.
+       */
+      getTagsToAvoid(immatureTags) {
+        const avoid = /* @__PURE__ */ new Map();
+        for (const immatureTag of immatureTags) {
+          const partners = this.interferenceMap.get(immatureTag);
+          if (partners) {
+            for (const { partner, decay } of partners) {
+              if (!immatureTags.has(partner)) {
+                const existing = avoid.get(partner) ?? 0;
+                avoid.set(partner, Math.max(existing, decay));
+              }
+            }
+          }
+        }
+        return avoid;
+      }
+      /**
+       * Compute interference score reduction for a card.
+       * Returns: { multiplier, interfering tags, reason }
+       */
+      computeInterferenceEffect(cardTags, tagsToAvoid, immatureTags) {
+        if (tagsToAvoid.size === 0) {
+          return {
+            multiplier: 1,
+            interferingTags: [],
+            reason: "No interference detected"
+          };
+        }
+        let multiplier = 1;
+        const interferingTags = [];
+        for (const tag of cardTags) {
+          const decay = tagsToAvoid.get(tag);
+          if (decay !== void 0) {
+            interferingTags.push(tag);
+            multiplier *= 1 - decay;
+          }
+        }
+        if (interferingTags.length === 0) {
+          return {
+            multiplier: 1,
+            interferingTags: [],
+            reason: "No interference detected"
+          };
+        }
+        const causingTags = /* @__PURE__ */ new Set();
+        for (const tag of interferingTags) {
+          for (const immatureTag of immatureTags) {
+            const partners = this.interferenceMap.get(immatureTag);
+            if (partners?.some((p) => p.partner === tag)) {
+              causingTags.add(immatureTag);
+            }
+          }
+        }
+        const reason = `Interferes with immature tags ${Array.from(causingTags).join(", ")} (tags: ${interferingTags.join(", ")}, multiplier: ${multiplier.toFixed(2)})`;
+        return { multiplier, interferingTags, reason };
+      }
+      /**
+       * CardFilter.transform implementation.
+       *
+       * Apply interference-aware scoring. Cards with tags that interfere with
+       * immature learnings get reduced scores.
+       */
+      async transform(cards, context) {
+        const immatureTags = await this.getImmatureTags(context);
+        const tagsToAvoid = this.getTagsToAvoid(immatureTags);
+        const adjusted = [];
+        for (const card of cards) {
+          const cardTags = card.tags ?? [];
+          const { multiplier, reason } = this.computeInterferenceEffect(
+            cardTags,
+            tagsToAvoid,
+            immatureTags
+          );
+          const finalScore = card.score * multiplier;
+          const action = multiplier < 1 ? "penalized" : multiplier > 1 ? "boosted" : "passed";
+          adjusted.push({
+            ...card,
+            score: finalScore,
+            provenance: [
+              ...card.provenance,
+              {
+                strategy: "interferenceMitigator",
+                strategyName: this.strategyName || this.name,
+                strategyId: this.strategyId || "NAVIGATION_STRATEGY-interference",
+                action,
+                score: finalScore,
+                reason
+              }
+            ]
+          });
+        }
+        return adjusted;
+      }
+      /**
+       * Legacy getWeightedCards - now throws as filters should not be used as generators.
+       *
+       * Use transform() via Pipeline instead.
+       */
+      async getWeightedCards(_limit) {
+        throw new Error(
+          "InterferenceMitigatorNavigator is a filter and should not be used as a generator. Use Pipeline with a generator and this filter via transform()."
+        );
+      }
+    };
+  }
+});
+
+// src/core/navigators/filters/relativePriority.ts
+var relativePriority_exports = {};
+__export(relativePriority_exports, {
+  default: () => RelativePriorityNavigator
+});
+var DEFAULT_PRIORITY, DEFAULT_PRIORITY_INFLUENCE, DEFAULT_COMBINE_MODE, RelativePriorityNavigator;
+var init_relativePriority = __esm({
+  "src/core/navigators/filters/relativePriority.ts"() {
+    "use strict";
+    init_navigators();
+    DEFAULT_PRIORITY = 0.5;
+    DEFAULT_PRIORITY_INFLUENCE = 0.5;
+    DEFAULT_COMBINE_MODE = "max";
+    RelativePriorityNavigator = class extends ContentNavigator {
+      config;
+      /** Human-readable name for CardFilter interface */
+      name;
+      constructor(user, course, strategyData) {
+        super(user, course, strategyData);
+        this.config = this.parseConfig(strategyData.serializedData);
+        this.name = strategyData.name || "Relative Priority";
+      }
+      parseConfig(serializedData) {
+        try {
+          const parsed = JSON.parse(serializedData);
+          return {
+            tagPriorities: parsed.tagPriorities || {},
+            defaultPriority: parsed.defaultPriority ?? DEFAULT_PRIORITY,
+            combineMode: parsed.combineMode ?? DEFAULT_COMBINE_MODE,
+            priorityInfluence: parsed.priorityInfluence ?? DEFAULT_PRIORITY_INFLUENCE
+          };
+        } catch {
+          return {
+            tagPriorities: {},
+            defaultPriority: DEFAULT_PRIORITY,
+            combineMode: DEFAULT_COMBINE_MODE,
+            priorityInfluence: DEFAULT_PRIORITY_INFLUENCE
+          };
+        }
+      }
+      /**
+       * Look up the priority for a tag.
+       */
+      getTagPriority(tagId) {
+        return this.config.tagPriorities[tagId] ?? this.config.defaultPriority ?? DEFAULT_PRIORITY;
+      }
+      /**
+       * Compute combined priority for a card based on its tags.
+       */
+      computeCardPriority(cardTags) {
+        if (cardTags.length === 0) {
+          return this.config.defaultPriority ?? DEFAULT_PRIORITY;
+        }
+        const priorities = cardTags.map((tag) => this.getTagPriority(tag));
+        switch (this.config.combineMode) {
+          case "max":
+            return Math.max(...priorities);
+          case "min":
+            return Math.min(...priorities);
+          case "average":
+            return priorities.reduce((sum, p) => sum + p, 0) / priorities.length;
+          default:
+            return Math.max(...priorities);
+        }
+      }
+      /**
+       * Compute boost factor based on priority.
+       *
+       * The formula: 1 + (priority - 0.5) * priorityInfluence
+       *
+       * This creates a multiplier centered around 1.0:
+       * - Priority 1.0 with influence 0.5 → 1.25 (25% boost)
+       * - Priority 0.5 with any influence → 1.00 (neutral)
+       * - Priority 0.0 with influence 0.5 → 0.75 (25% reduction)
+       */
+      computeBoostFactor(priority) {
+        const influence = this.config.priorityInfluence ?? DEFAULT_PRIORITY_INFLUENCE;
+        return 1 + (priority - 0.5) * influence;
+      }
+      /**
+       * Build human-readable reason for priority adjustment.
+       */
+      buildPriorityReason(cardTags, priority, boostFactor, finalScore) {
+        if (cardTags.length === 0) {
+          return `No tags, neutral priority (${priority.toFixed(2)})`;
+        }
+        const tagList = cardTags.slice(0, 3).join(", ");
+        const more = cardTags.length > 3 ? ` (+${cardTags.length - 3} more)` : "";
+        if (boostFactor === 1) {
+          return `Neutral priority (${priority.toFixed(2)}) for tags: ${tagList}${more}`;
+        } else if (boostFactor > 1) {
+          return `High-priority tags: ${tagList}${more} (priority ${priority.toFixed(2)} \u2192 boost ${boostFactor.toFixed(2)}x \u2192 ${finalScore.toFixed(2)})`;
+        } else {
+          return `Low-priority tags: ${tagList}${more} (priority ${priority.toFixed(2)} \u2192 reduce ${boostFactor.toFixed(2)}x \u2192 ${finalScore.toFixed(2)})`;
+        }
+      }
+      /**
+       * CardFilter.transform implementation.
+       *
+       * Apply priority-adjusted scoring. Cards with high-priority tags get boosted,
+       * cards with low-priority tags get reduced scores.
+       */
+      async transform(cards, _context) {
+        const adjusted = await Promise.all(
+          cards.map(async (card) => {
+            const cardTags = card.tags ?? [];
+            const priority = this.computeCardPriority(cardTags);
+            const boostFactor = this.computeBoostFactor(priority);
+            const finalScore = Math.max(0, Math.min(1, card.score * boostFactor));
+            const action = boostFactor > 1 ? "boosted" : boostFactor < 1 ? "penalized" : "passed";
+            const reason = this.buildPriorityReason(cardTags, priority, boostFactor, finalScore);
+            return {
+              ...card,
+              score: finalScore,
+              provenance: [
+                ...card.provenance,
+                {
+                  strategy: "relativePriority",
+                  strategyName: this.strategyName || this.name,
+                  strategyId: this.strategyId || "NAVIGATION_STRATEGY-priority",
+                  action,
+                  score: finalScore,
+                  reason
+                }
+              ]
+            };
+          })
+        );
+        return adjusted;
+      }
+      /**
+       * Legacy getWeightedCards - now throws as filters should not be used as generators.
+       *
+       * Use transform() via Pipeline instead.
+       */
+      async getWeightedCards(_limit) {
+        throw new Error(
+          "RelativePriorityNavigator is a filter and should not be used as a generator. Use Pipeline with a generator and this filter via transform()."
+        );
+      }
+    };
+  }
+});
+
+// src/core/navigators/filters/types.ts
+var types_exports2 = {};
+var init_types2 = __esm({
+  "src/core/navigators/filters/types.ts"() {
+    "use strict";
+  }
+});
+
+// src/core/navigators/filters/userGoalStub.ts
+var userGoalStub_exports = {};
+__export(userGoalStub_exports, {
+  USER_GOAL_NAVIGATOR_STUB: () => USER_GOAL_NAVIGATOR_STUB
+});
+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
+function aggregateOutcomesForGradient(outcomes, strategyId) {
+  const observations = [];
+  for (const outcome of outcomes) {
+    const deviation = outcome.deviations[strategyId];
+    if (deviation === void 0) {
+      continue;
+    }
+    observations.push({
+      deviation,
+      outcomeValue: outcome.outcomeValue,
+      weight: 1
+    });
+  }
+  logger.debug(
+    `[Orchestration] Aggregated ${observations.length} observations for strategy ${strategyId}`
+  );
+  return observations;
+}
+function computeStrategyGradient(observations) {
+  const n = observations.length;
+  if (n < 3) {
+    logger.debug(`[Orchestration] Insufficient observations for gradient (${n} < 3)`);
+    return null;
+  }
+  let sumX = 0;
+  let sumY = 0;
+  let sumW = 0;
+  for (const obs of observations) {
+    const w = obs.weight ?? 1;
+    sumX += obs.deviation * w;
+    sumY += obs.outcomeValue * w;
+    sumW += w;
+  }
+  const meanX = sumX / sumW;
+  const meanY = sumY / sumW;
+  let numerator = 0;
+  let denominator = 0;
+  let ssTotal = 0;
+  for (const obs of observations) {
+    const w = obs.weight ?? 1;
+    const dx = obs.deviation - meanX;
+    const dy = obs.outcomeValue - meanY;
+    numerator += w * dx * dy;
+    denominator += w * dx * dx;
+    ssTotal += w * dy * dy;
+  }
+  if (denominator < 1e-10) {
+    logger.debug(`[Orchestration] No variance in deviations, cannot compute gradient`);
+    return {
+      gradient: 0,
+      intercept: meanY,
+      rSquared: 0,
+      sampleSize: n
+    };
+  }
+  const gradient = numerator / denominator;
+  const intercept = meanY - gradient * meanX;
+  let ssResidual = 0;
+  for (const obs of observations) {
+    const w = obs.weight ?? 1;
+    const predicted = gradient * obs.deviation + intercept;
+    const residual = obs.outcomeValue - predicted;
+    ssResidual += w * residual * residual;
+  }
+  const rSquared = ssTotal > 1e-10 ? 1 - ssResidual / ssTotal : 0;
+  logger.debug(
+    `[Orchestration] Computed gradient: ${gradient.toFixed(4)}, intercept: ${intercept.toFixed(4)}, R\xB2: ${rSquared.toFixed(4)}, n=${n}`
+  );
+  return {
+    gradient,
+    intercept,
+    rSquared: Math.max(0, Math.min(1, rSquared)),
+    // Clamp to [0,1]
+    sampleSize: n
+  };
+}
+var init_gradient = __esm({
+  "src/core/orchestration/gradient.ts"() {
+    "use strict";
+    init_logger();
+  }
+});
+
+// src/core/orchestration/learning.ts
+function updateStrategyWeight(current, gradient) {
+  if (gradient.sampleSize < MIN_OBSERVATIONS_FOR_UPDATE) {
+    logger.debug(
+      `[Orchestration] Insufficient samples (${gradient.sampleSize} < ${MIN_OBSERVATIONS_FOR_UPDATE}), keeping current weight`
+    );
+    return {
+      ...current,
+      sampleSize: current.sampleSize + gradient.sampleSize
+    };
+  }
+  const isReliable = gradient.rSquared >= MIN_R_SQUARED_FOR_GRADIENT;
+  const isFlat = Math.abs(gradient.gradient) < FLAT_GRADIENT_THRESHOLD;
+  let newWeight = current.weight;
+  let newConfidence = current.confidence;
+  if (!isReliable || isFlat) {
+    const confidenceGain = 0.05 * (1 - current.confidence);
+    newConfidence = Math.min(1, current.confidence + confidenceGain);
+    logger.debug(
+      `[Orchestration] Flat/unreliable gradient (|g|=${Math.abs(gradient.gradient).toFixed(4)}, R\xB2=${gradient.rSquared.toFixed(4)}). Increasing confidence: ${current.confidence.toFixed(3)} \u2192 ${newConfidence.toFixed(3)}`
+    );
+  } else {
+    let delta = gradient.gradient * LEARNING_RATE;
+    delta = Math.max(-MAX_WEIGHT_DELTA, Math.min(MAX_WEIGHT_DELTA, delta));
+    newWeight = current.weight + delta;
+    newWeight = Math.max(0.1, Math.min(3, newWeight));
+    const confidenceGain = 0.02 * (1 - current.confidence);
+    newConfidence = Math.min(1, current.confidence + confidenceGain);
+    logger.debug(
+      `[Orchestration] Adjusting weight: ${current.weight.toFixed(3)} \u2192 ${newWeight.toFixed(3)} (gradient=${gradient.gradient.toFixed(4)}, delta=${delta.toFixed(4)})`
+    );
+  }
+  return {
+    weight: newWeight,
+    confidence: newConfidence,
+    sampleSize: current.sampleSize + gradient.sampleSize
+  };
+}
+function updateLearningState(courseId, strategyId, currentWeight, gradient, existing) {
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  const id = `STRATEGY_LEARNING_STATE::${courseId}::${strategyId}`;
+  const historyEntry = {
+    timestamp: now,
+    weight: currentWeight.weight,
+    confidence: currentWeight.confidence,
+    gradient: gradient.gradient
+  };
+  let history = existing?.history ?? [];
+  history = [...history, historyEntry];
+  if (history.length > MAX_HISTORY_LENGTH) {
+    history = history.slice(history.length - MAX_HISTORY_LENGTH);
+  }
+  const state = {
+    _id: id,
+    _rev: existing?._rev,
+    docType: "STRATEGY_LEARNING_STATE" /* STRATEGY_LEARNING_STATE */,
+    courseId,
+    strategyId,
+    currentWeight,
+    regression: {
+      gradient: gradient.gradient,
+      intercept: gradient.intercept,
+      rSquared: gradient.rSquared,
+      sampleSize: gradient.sampleSize,
+      computedAt: now
+    },
+    history,
+    updatedAt: now
+  };
+  return state;
+}
+function runPeriodUpdate(input) {
+  const { courseId, strategyId, currentWeight, gradient, existingState } = input;
+  logger.info(
+    `[Orchestration] Running period update for strategy ${strategyId} (${gradient.sampleSize} observations)`
+  );
+  const newWeight = updateStrategyWeight(currentWeight, gradient);
+  const updated = newWeight.weight !== currentWeight.weight;
+  const learningState = updateLearningState(
+    courseId,
+    strategyId,
+    newWeight,
+    gradient,
+    existingState
+  );
+  logger.info(
+    `[Orchestration] Period update complete for ${strategyId}: weight ${currentWeight.weight.toFixed(3)} \u2192 ${newWeight.weight.toFixed(3)}, confidence ${currentWeight.confidence.toFixed(3)} \u2192 ${newWeight.confidence.toFixed(3)}`
+  );
+  return {
+    strategyId,
+    previousWeight: currentWeight,
+    newWeight,
+    gradient,
+    learningState,
+    updated
+  };
+}
+function getDefaultLearnableWeight() {
+  return { ...DEFAULT_LEARNABLE_WEIGHT };
+}
+var MIN_OBSERVATIONS_FOR_UPDATE, LEARNING_RATE, MAX_WEIGHT_DELTA, MIN_R_SQUARED_FOR_GRADIENT, FLAT_GRADIENT_THRESHOLD, MAX_HISTORY_LENGTH;
+var init_learning = __esm({
+  "src/core/orchestration/learning.ts"() {
+    "use strict";
+    init_contentNavigationStrategy();
+    init_types_legacy();
+    init_logger();
+    MIN_OBSERVATIONS_FOR_UPDATE = 10;
+    LEARNING_RATE = 0.1;
+    MAX_WEIGHT_DELTA = 0.3;
+    MIN_R_SQUARED_FOR_GRADIENT = 0.05;
+    FLAT_GRADIENT_THRESHOLD = 0.02;
+    MAX_HISTORY_LENGTH = 100;
+  }
+});
+
+// src/core/orchestration/signal.ts
+function computeOutcomeSignal(records, config = {}) {
+  if (!records || records.length === 0) {
+    return null;
+  }
+  const target = config.targetAccuracy ?? 0.85;
+  const tolerance = config.tolerance ?? 0.05;
+  let correct = 0;
+  for (const r of records) {
+    if (r.isCorrect) correct++;
+  }
+  const accuracy = correct / records.length;
+  return scoreAccuracyInZone(accuracy, target, tolerance);
+}
+function scoreAccuracyInZone(accuracy, target, tolerance) {
+  const dist = Math.abs(accuracy - target);
+  if (dist <= tolerance) {
+    return 1;
+  }
+  const excess = dist - tolerance;
+  const slope = 2.5;
+  return Math.max(0, 1 - excess * slope);
+}
+var init_signal = __esm({
+  "src/core/orchestration/signal.ts"() {
+    "use strict";
+  }
+});
+
+// src/core/orchestration/recording.ts
+async function recordUserOutcome(context, periodStart, periodEnd, records, activeStrategyIds, eloStart = 0, eloEnd = 0, config) {
+  const { user, course, userId } = context;
+  const courseId = course.getCourseID();
+  const outcomeValue = computeOutcomeSignal(records, config);
+  if (outcomeValue === null) {
+    logger.debug(
+      `[Orchestration] No outcome signal computed for ${userId} (insufficient data). Skipping record.`
+    );
+    return;
+  }
+  const deviations = {};
+  for (const strategyId of activeStrategyIds) {
+    deviations[strategyId] = context.getDeviation(strategyId);
+  }
+  const id = `USER_OUTCOME::${courseId}::${userId}::${periodEnd}`;
+  const record = {
+    _id: id,
+    docType: "USER_OUTCOME" /* USER_OUTCOME */,
+    courseId,
+    userId,
+    periodStart,
+    periodEnd,
+    outcomeValue,
+    deviations,
+    metadata: {
+      sessionsCount: 1,
+      // Assumes recording is triggered per-session currently
+      cardsSeen: records.length,
+      eloStart,
+      eloEnd,
+      signalType: "accuracy_in_zone"
+    }
+  };
+  try {
+    await user.putUserOutcome(record);
+    logger.debug(
+      `[Orchestration] Recorded outcome ${outcomeValue.toFixed(3)} for ${userId} (doc: ${id})`
+    );
+  } catch (e) {
+    logger.error(`[Orchestration] Failed to record outcome: ${e}`);
+  }
+}
+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/navigators/Pipeline.ts
+var Pipeline_exports = {};
+__export(Pipeline_exports, {
+  Pipeline: () => Pipeline
+});
+import { toCourseElo as toCourseElo5 } from "@vue-skuilder/common";
+function logPipelineConfig(generator, filters) {
+  const filterList = filters.length > 0 ? "\n    - " + filters.map((f) => f.name).join("\n    - ") : " none";
+  logger.info(
+    `[Pipeline] Configuration:
+  Generator: ${generator.name}
+  Filters:${filterList}`
+  );
+}
+function logTagHydration(cards, tagsByCard) {
+  const totalTags = Array.from(tagsByCard.values()).reduce((sum, tags) => sum + tags.length, 0);
+  const cardsWithTags = Array.from(tagsByCard.values()).filter((tags) => tags.length > 0).length;
+  logger.debug(
+    `[Pipeline] Tag hydration: ${cards.length} cards, ${cardsWithTags} have tags (${totalTags} total tags) - single batch query`
+  );
+}
+function logExecutionSummary(generatorName, generatedCount, filterCount, finalCount, topScores, filterImpacts) {
+  const scoreDisplay = topScores.length > 0 ? topScores.map((s) => s.toFixed(2)).join(", ") : "none";
+  let filterSummary = "";
+  if (filterImpacts.length > 0) {
+    const impacts = filterImpacts.map((f) => {
+      const parts = [];
+      if (f.boosted > 0) parts.push(`+${f.boosted}`);
+      if (f.penalized > 0) parts.push(`-${f.penalized}`);
+      if (f.passed > 0) parts.push(`=${f.passed}`);
+      return `${f.name}: ${parts.join("/")}`;
+    });
+    filterSummary = `
+  Filter impact: ${impacts.join(", ")}`;
+  }
+  logger.info(
+    `[Pipeline] Execution: ${generatorName} produced ${generatedCount} \u2192 ${filterCount} filters \u2192 ${finalCount} results (top scores: ${scoreDisplay})` + filterSummary + `
+  \u{1F4A1} Inspect: window.skuilder.pipeline`
+  );
+}
+function logCardProvenance(cards, maxCards = 3) {
+  const cardsToLog = cards.slice(0, maxCards);
+  logger.debug(`[Pipeline] Provenance for top ${cardsToLog.length} cards:`);
+  for (const card of cardsToLog) {
+    logger.debug(`[Pipeline]   ${card.cardId} (final score: ${card.score.toFixed(3)}):`);
+    for (const entry of card.provenance) {
+      const scoreChange = entry.score.toFixed(3);
+      const action = entry.action.padEnd(9);
+      logger.debug(
+        `[Pipeline]     ${action} ${scoreChange} - ${entry.strategyName}: ${entry.reason}`
+      );
+    }
+  }
+}
+var Pipeline;
+var init_Pipeline = __esm({
+  "src/core/navigators/Pipeline.ts"() {
+    "use strict";
+    init_navigators();
+    init_logger();
+    init_orchestration();
+    init_PipelineDebugger();
+    Pipeline = class extends ContentNavigator {
+      generator;
+      filters;
+      /**
+       * Create a new pipeline.
+       *
+       * @param generator - The generator (or CompositeGenerator) that produces candidates
+       * @param filters - Filters to apply sequentially (order doesn't matter for multipliers)
+       * @param user - User database interface
+       * @param course - Course database interface
+       */
+      constructor(generator, filters, user, course) {
+        super();
+        this.generator = generator;
+        this.filters = filters;
+        this.user = user;
+        this.course = course;
+        course.getCourseConfig().then((cfg) => {
+          logger.debug(`[pipeline] Crated pipeline for ${cfg.name}`);
+        }).catch((e) => {
+          logger.error(`[pipeline] Failed to lookup courseCfg: ${e}`);
+        });
+        logPipelineConfig(generator, filters);
+      }
+      /**
+       * Get weighted cards by running generator and applying filters.
+       *
+       * 1. Build shared context (user ELO, etc.)
+       * 2. Get candidates from generator (passing context)
+       * 3. Batch hydrate tags for all candidates
+       * 4. Apply each filter sequentially
+       * 5. Remove zero-score cards
+       * 6. Sort by score descending
+       * 7. Return top N
+       *
+       * @param limit - Maximum number of cards to return
+       * @returns Cards sorted by score descending
+       */
+      async getWeightedCards(limit) {
+        const context = await this.buildContext();
+        const overFetchMultiplier = 2 + this.filters.length * 0.5;
+        const fetchLimit = Math.ceil(limit * overFetchMultiplier);
+        logger.debug(
+          `[Pipeline] Fetching ${fetchLimit} candidates from generator '${this.generator.name}'`
+        );
+        let cards = await this.generator.getWeightedCards(fetchLimit, context);
+        const generatedCount = cards.length;
+        let generatorSummaries;
+        if (this.generator.generators) {
+          const genMap = /* @__PURE__ */ new Map();
+          for (const card of cards) {
+            const firstProv = card.provenance[0];
+            if (firstProv) {
+              const genName = firstProv.strategyName;
+              if (!genMap.has(genName)) {
+                genMap.set(genName, { cards: [] });
+              }
+              genMap.get(genName).cards.push(card);
+            }
+          }
+          generatorSummaries = Array.from(genMap.entries()).map(([name, data]) => {
+            const newCards = data.cards.filter((c) => c.provenance[0]?.reason?.includes("new card"));
+            const reviewCards = data.cards.filter((c) => c.provenance[0]?.reason?.includes("review"));
+            return {
+              name,
+              cardCount: data.cards.length,
+              newCount: newCards.length,
+              reviewCount: reviewCards.length,
+              topScore: Math.max(...data.cards.map((c) => c.score), 0)
+            };
+          });
+        }
+        logger.debug(`[Pipeline] Generator returned ${generatedCount} candidates`);
+        cards = await this.hydrateTags(cards);
+        const allCardsBeforeFiltering = [...cards];
+        const filterImpacts = [];
+        for (const filter of this.filters) {
+          const beforeCount = cards.length;
+          const beforeScores = new Map(cards.map((c) => [c.cardId, c.score]));
+          cards = await filter.transform(cards, context);
+          let boosted = 0, penalized = 0, passed = 0;
+          const removed = beforeCount - cards.length;
+          for (const card of cards) {
+            const before = beforeScores.get(card.cardId) ?? 0;
+            if (card.score > before) boosted++;
+            else if (card.score < before) penalized++;
+            else passed++;
+          }
+          filterImpacts.push({ name: filter.name, boosted, penalized, passed, removed });
+          logger.debug(`[Pipeline] Filter '${filter.name}': ${beforeScores.size} \u2192 ${cards.length} cards (\u2191${boosted} \u2193${penalized} =${passed})`);
+        }
+        cards = cards.filter((c) => c.score > 0);
+        cards.sort((a, b) => b.score - a.score);
+        const result = cards.slice(0, limit);
+        const topScores = result.slice(0, 3).map((c) => c.score);
+        logExecutionSummary(
+          this.generator.name,
+          generatedCount,
+          this.filters.length,
+          result.length,
+          topScores,
+          filterImpacts
+        );
+        logCardProvenance(result, 3);
+        try {
+          const courseName = await this.course?.getCourseConfig().then((c) => c.name).catch(() => void 0);
+          const report = buildRunReport(
+            this.course?.getCourseID() || "unknown",
+            courseName,
+            this.generator.name,
+            generatorSummaries,
+            generatedCount,
+            filterImpacts,
+            allCardsBeforeFiltering,
+            result
+          );
+          captureRun(report);
+        } catch (e) {
+          logger.debug(`[Pipeline] Failed to capture debug run: ${e}`);
+        }
+        return result;
+      }
+      /**
+       * Batch hydrate tags for all cards.
+       *
+       * Fetches tags for all cards in a single database query and attaches them
+       * to the WeightedCard objects. Filters can then use card.tags instead of
+       * making individual getAppliedTags() calls.
+       *
+       * @param cards - Cards to hydrate
+       * @returns Cards with tags populated
+       */
+      async hydrateTags(cards) {
+        if (cards.length === 0) {
+          return cards;
+        }
+        const cardIds = cards.map((c) => c.cardId);
+        const tagsByCard = await this.course.getAppliedTagsBatch(cardIds);
+        logTagHydration(cards, tagsByCard);
+        return cards.map((card) => ({
+          ...card,
+          tags: tagsByCard.get(card.cardId) ?? []
+        }));
+      }
+      /**
+       * Build shared context for generator and filters.
+       *
+       * Called once per getWeightedCards() invocation.
+       * Contains data that the generator and multiple filters might need.
+       *
+       * The context satisfies both GeneratorContext and FilterContext interfaces.
+       */
+      async buildContext() {
+        let userElo = 1e3;
+        try {
+          const courseReg = await this.user.getCourseRegDoc(this.course.getCourseID());
+          const courseElo = toCourseElo5(courseReg.elo);
+          userElo = courseElo.global.score;
+        } catch (e) {
+          logger.debug(`[Pipeline] Could not get user ELO, using default: ${e}`);
+        }
+        const orchestration = await createOrchestrationContext(this.user, this.course);
+        return {
+          user: this.user,
+          course: this.course,
+          userElo,
+          orchestration
+        };
+      }
+      /**
+       * Get the course ID for this pipeline.
+       */
+      getCourseID() {
+        return this.course.getCourseID();
+      }
+      /**
+       * Get orchestration context for outcome recording.
+       */
+      async getOrchestrationContext() {
+        return createOrchestrationContext(this.user, this.course);
+      }
+      /**
+       * Get IDs of all strategies in this pipeline.
+       * Used to record which strategies contributed to an outcome.
+       */
+      getStrategyIds() {
+        const ids = [];
+        const extractId = (obj) => {
+          if (obj.strategyId) return obj.strategyId;
+          return null;
+        };
+        const genId = extractId(this.generator);
+        if (genId) ids.push(genId);
+        if (this.generator.generators && Array.isArray(this.generator.generators)) {
+          this.generator.generators.forEach((g) => {
+            const subId = extractId(g);
+            if (subId) ids.push(subId);
+          });
+        }
+        for (const filter of this.filters) {
+          const fId = extractId(filter);
+          if (fId) ids.push(fId);
+        }
+        return [...new Set(ids)];
+      }
+    };
+  }
+});
+
+// src/core/navigators/defaults.ts
+var defaults_exports = {};
+__export(defaults_exports, {
+  createDefaultEloStrategy: () => createDefaultEloStrategy,
+  createDefaultPipeline: () => createDefaultPipeline,
+  createDefaultSrsStrategy: () => createDefaultSrsStrategy
+});
+function createDefaultEloStrategy(courseId) {
+  return {
+    _id: "NAVIGATION_STRATEGY-ELO-default",
+    docType: "NAVIGATION_STRATEGY" /* NAVIGATION_STRATEGY */,
+    name: "ELO (default)",
+    description: "Default ELO-based navigation strategy for new cards",
+    implementingClass: "elo" /* ELO */,
+    course: courseId,
+    serializedData: ""
+  };
+}
+function createDefaultSrsStrategy(courseId) {
+  return {
+    _id: "NAVIGATION_STRATEGY-SRS-default",
+    docType: "NAVIGATION_STRATEGY" /* NAVIGATION_STRATEGY */,
+    name: "SRS (default)",
+    description: "Default SRS-based navigation strategy for reviews",
+    implementingClass: "srs" /* SRS */,
+    course: courseId,
+    serializedData: ""
+  };
+}
+function createDefaultPipeline(user, course) {
+  const courseId = course.getCourseID();
+  const eloNavigator = new ELONavigator(user, course, createDefaultEloStrategy(courseId));
+  const srsNavigator = new SRSNavigator(user, course, createDefaultSrsStrategy(courseId));
+  const compositeGenerator = new CompositeGenerator([eloNavigator, srsNavigator]);
+  const eloDistanceFilter = createEloDistanceFilter();
+  return new Pipeline(compositeGenerator, [eloDistanceFilter], user, course);
+}
+var init_defaults = __esm({
+  "src/core/navigators/defaults.ts"() {
+    "use strict";
+    init_navigators();
+    init_Pipeline();
+    init_CompositeGenerator();
+    init_elo();
+    init_srs();
+    init_eloDistance();
+    init_types_legacy();
+  }
+});
+
+// src/core/navigators/PipelineAssembler.ts
+var PipelineAssembler_exports = {};
+__export(PipelineAssembler_exports, {
+  PipelineAssembler: () => PipelineAssembler
+});
+var PipelineAssembler;
+var init_PipelineAssembler = __esm({
+  "src/core/navigators/PipelineAssembler.ts"() {
+    "use strict";
+    init_navigators();
+    init_WeightedFilter();
+    init_Pipeline();
+    init_logger();
+    init_CompositeGenerator();
+    init_defaults();
+    PipelineAssembler = class {
+      /**
+       * Assembles a navigation pipeline from strategy documents.
+       *
+       * 1. Separates into generators and filters by role
+       * 2. Validates at least one generator exists (or creates default ELO)
+       * 3. Instantiates generators - wraps multiple in CompositeGenerator
+       * 4. Instantiates filters
+       * 5. Returns Pipeline(generator, filters)
+       *
+       * @param input - Strategy documents plus user/course interfaces
+       * @returns Assembled pipeline and any warnings
+       */
+      async assemble(input) {
+        const { strategies, user, course } = input;
+        const warnings = [];
+        if (strategies.length === 0) {
+          return {
+            pipeline: null,
+            generatorStrategies: [],
+            filterStrategies: [],
+            warnings
+          };
+        }
+        const generatorStrategies = [];
+        const filterStrategies = [];
+        for (const s of strategies) {
+          if (isGenerator(s.implementingClass)) {
+            generatorStrategies.push(s);
+          } else if (isFilter(s.implementingClass)) {
+            filterStrategies.push(s);
+          } else {
+            warnings.push(`Unknown strategy type '${s.implementingClass}', skipping: ${s.name}`);
+          }
+        }
+        if (generatorStrategies.length === 0) {
+          if (filterStrategies.length > 0) {
+            logger.debug(
+              "[PipelineAssembler] No generator found, using default ELO and SRS with configured filters"
+            );
+            const courseId = course.getCourseID();
+            generatorStrategies.push(createDefaultEloStrategy(courseId));
+            generatorStrategies.push(createDefaultSrsStrategy(courseId));
+          } else {
+            warnings.push("No generator strategy found");
+            return {
+              pipeline: null,
+              generatorStrategies: [],
+              filterStrategies: [],
+              warnings
+            };
+          }
+        }
+        let generator;
+        if (generatorStrategies.length === 1) {
+          const nav = await ContentNavigator.create(user, course, generatorStrategies[0]);
+          generator = nav;
+          logger.debug(`[PipelineAssembler] Using single generator: ${generatorStrategies[0].name}`);
+        } else {
+          logger.debug(
+            `[PipelineAssembler] Using CompositeGenerator for ${generatorStrategies.length} generators: ${generatorStrategies.map((g) => g.name).join(", ")}`
+          );
+          generator = await CompositeGenerator.fromStrategies(user, course, generatorStrategies);
+        }
+        const filters = [];
+        const sortedFilterStrategies = [...filterStrategies].sort(
+          (a, b) => a.name.localeCompare(b.name)
+        );
+        for (const filterStrategy of sortedFilterStrategies) {
+          try {
+            const nav = await ContentNavigator.create(user, course, filterStrategy);
+            if ("transform" in nav && typeof nav.transform === "function") {
+              let filter = nav;
+              if (filterStrategy.learnable) {
+                filter = new WeightedFilter(
+                  filter,
+                  filterStrategy.learnable,
+                  filterStrategy.staticWeight,
+                  filterStrategy._id
+                );
+              }
+              filters.push(filter);
+              logger.debug(`[PipelineAssembler] Added filter: ${filterStrategy.name}`);
+            } else {
+              warnings.push(
+                `Filter '${filterStrategy.name}' does not implement CardFilter.transform(), skipping`
+              );
+            }
+          } catch (e) {
+            warnings.push(`Failed to instantiate filter '${filterStrategy.name}': ${e}`);
+          }
+        }
+        const pipeline = new Pipeline(generator, filters, user, course);
+        logger.debug(
+          `[PipelineAssembler] Assembled pipeline with ${generatorStrategies.length} generator(s) and ${filters.length} filter(s)`
+        );
+        return {
+          pipeline,
+          generatorStrategies,
+          filterStrategies: sortedFilterStrategies,
+          warnings
+        };
+      }
+    };
+  }
+});
+
+// import("./**/*") in src/core/navigators/index.ts
+var globImport;
+var init_3 = __esm({
+  'import("./**/*") in src/core/navigators/index.ts'() {
+    globImport = __glob({
+      "./Pipeline.ts": () => Promise.resolve().then(() => (init_Pipeline(), Pipeline_exports)),
+      "./PipelineAssembler.ts": () => Promise.resolve().then(() => (init_PipelineAssembler(), PipelineAssembler_exports)),
+      "./PipelineDebugger.ts": () => Promise.resolve().then(() => (init_PipelineDebugger(), PipelineDebugger_exports)),
+      "./defaults.ts": () => Promise.resolve().then(() => (init_defaults(), defaults_exports)),
+      "./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)),
+      "./generators/CompositeGenerator.ts": () => Promise.resolve().then(() => (init_CompositeGenerator(), CompositeGenerator_exports)),
+      "./generators/elo.ts": () => Promise.resolve().then(() => (init_elo(), elo_exports)),
+      "./generators/index.ts": () => Promise.resolve().then(() => (init_generators(), generators_exports)),
+      "./generators/srs.ts": () => Promise.resolve().then(() => (init_srs(), srs_exports)),
+      "./generators/types.ts": () => Promise.resolve().then(() => (init_types(), types_exports)),
+      "./index.ts": () => Promise.resolve().then(() => (init_navigators(), navigators_exports))
+    });
+  }
+});
+
+// src/core/navigators/index.ts
+var navigators_exports = {};
+__export(navigators_exports, {
+  ContentNavigator: () => ContentNavigator,
+  NavigatorRole: () => NavigatorRole,
+  NavigatorRoles: () => NavigatorRoles,
+  Navigators: () => Navigators,
+  getCardOrigin: () => getCardOrigin,
+  getRegisteredNavigator: () => getRegisteredNavigator,
+  getRegisteredNavigatorNames: () => getRegisteredNavigatorNames,
+  hasRegisteredNavigator: () => hasRegisteredNavigator,
+  initializeNavigatorRegistry: () => initializeNavigatorRegistry,
+  isFilter: () => isFilter,
+  isGenerator: () => isGenerator,
+  mountPipelineDebugger: () => mountPipelineDebugger,
+  pipelineDebugAPI: () => pipelineDebugAPI,
+  registerNavigator: () => registerNavigator
+});
+function registerNavigator(implementingClass, constructor) {
+  navigatorRegistry.set(implementingClass, constructor);
+  logger.debug(`[NavigatorRegistry] Registered: ${implementingClass}`);
+}
+function getRegisteredNavigator(implementingClass) {
+  return navigatorRegistry.get(implementingClass);
+}
+function hasRegisteredNavigator(implementingClass) {
+  return navigatorRegistry.has(implementingClass);
+}
+function getRegisteredNavigatorNames() {
+  return Array.from(navigatorRegistry.keys());
+}
+async function initializeNavigatorRegistry() {
+  logger.debug("[NavigatorRegistry] Initializing built-in navigators...");
+  const [eloModule, srsModule] = await Promise.all([
+    Promise.resolve().then(() => (init_elo(), elo_exports)),
+    Promise.resolve().then(() => (init_srs(), srs_exports))
+  ]);
+  registerNavigator("elo", eloModule.default);
+  registerNavigator("srs", srsModule.default);
+  const [
+    hierarchyModule,
+    interferenceModule,
+    relativePriorityModule,
+    userTagPreferenceModule
+  ] = await Promise.all([
+    Promise.resolve().then(() => (init_hierarchyDefinition(), hierarchyDefinition_exports)),
+    Promise.resolve().then(() => (init_interferenceMitigator(), interferenceMitigator_exports)),
+    Promise.resolve().then(() => (init_relativePriority(), relativePriority_exports)),
+    Promise.resolve().then(() => (init_userTagPreference(), userTagPreference_exports))
+  ]);
+  registerNavigator("hierarchyDefinition", hierarchyModule.default);
+  registerNavigator("interferenceMitigator", interferenceModule.default);
+  registerNavigator("relativePriority", relativePriorityModule.default);
+  registerNavigator("userTagPreference", userTagPreferenceModule.default);
+  logger.debug(
+    `[NavigatorRegistry] Initialized ${navigatorRegistry.size} navigators: ${getRegisteredNavigatorNames().join(", ")}`
+  );
+}
+function getCardOrigin(card) {
+  if (card.provenance.length === 0) {
+    throw new Error("Card has no provenance - cannot determine origin");
+  }
+  const firstEntry = card.provenance[0];
+  const reason = firstEntry.reason.toLowerCase();
+  if (reason.includes("failed")) {
+    return "failed";
+  }
+  if (reason.includes("review")) {
+    return "review";
+  }
+  return "new";
+}
+function isGenerator(impl) {
+  return NavigatorRoles[impl] === "generator" /* GENERATOR */;
+}
+function isFilter(impl) {
+  return NavigatorRoles[impl] === "filter" /* FILTER */;
+}
+var navigatorRegistry, Navigators, NavigatorRole, NavigatorRoles, ContentNavigator;
+var init_navigators = __esm({
+  "src/core/navigators/index.ts"() {
+    "use strict";
+    init_PipelineDebugger();
+    init_logger();
+    init_();
+    init_2();
+    init_3();
+    navigatorRegistry = /* @__PURE__ */ new Map();
+    Navigators = /* @__PURE__ */ ((Navigators2) => {
+      Navigators2["ELO"] = "elo";
+      Navigators2["SRS"] = "srs";
+      Navigators2["HIERARCHY"] = "hierarchyDefinition";
+      Navigators2["INTERFERENCE"] = "interferenceMitigator";
+      Navigators2["RELATIVE_PRIORITY"] = "relativePriority";
+      Navigators2["USER_TAG_PREFERENCE"] = "userTagPreference";
+      return Navigators2;
+    })(Navigators || {});
+    NavigatorRole = /* @__PURE__ */ ((NavigatorRole2) => {
+      NavigatorRole2["GENERATOR"] = "generator";
+      NavigatorRole2["FILTER"] = "filter";
+      return NavigatorRole2;
+    })(NavigatorRole || {});
+    NavigatorRoles = {
+      ["elo" /* ELO */]: "generator" /* GENERATOR */,
+      ["srs" /* SRS */]: "generator" /* GENERATOR */,
+      ["hierarchyDefinition" /* HIERARCHY */]: "filter" /* FILTER */,
+      ["interferenceMitigator" /* INTERFERENCE */]: "filter" /* FILTER */,
+      ["relativePriority" /* RELATIVE_PRIORITY */]: "filter" /* FILTER */,
+      ["userTagPreference" /* USER_TAG_PREFERENCE */]: "filter" /* FILTER */
+    };
+    ContentNavigator = class {
+      /** User interface for this navigation session */
+      user;
+      /** Course interface for this navigation session */
+      course;
+      /** Human-readable name for this strategy instance (from ContentNavigationStrategyData.name) */
+      strategyName;
+      /** Unique document ID for this strategy instance (from ContentNavigationStrategyData._id) */
+      strategyId;
+      /** Evolutionary weighting configuration */
+      learnable;
+      /** Whether to bypass deviation (manual/static weighting) */
+      staticWeight;
+      /**
+       * Constructor for standard navigators.
+       * Call this from subclass constructors to initialize common fields.
+       *
+       * Note: CompositeGenerator and Pipeline call super() without args, then set
+       * user/course fields directly if needed.
+       */
+      constructor(user, course, strategyData) {
+        this.user = user;
+        this.course = course;
+        if (strategyData) {
+          this.strategyName = strategyData.name;
+          this.strategyId = strategyData._id;
+          this.learnable = strategyData.learnable;
+          this.staticWeight = strategyData.staticWeight;
+        }
+      }
+      // ============================================================================
+      // STRATEGY STATE HELPERS
+      // ============================================================================
+      //
+      // These methods allow strategies to persist their own state (user preferences,
+      // learned patterns, temporal tracking) in the user database.
+      //
+      // ============================================================================
+      /**
+       * Unique key identifying this strategy for state storage.
+       *
+       * Defaults to the constructor name (e.g., "UserTagPreferenceFilter").
+       * Override in subclasses if multiple instances of the same strategy type
+       * need separate state storage.
+       */
+      get strategyKey() {
+        return this.constructor.name;
+      }
+      /**
+       * Get this strategy's persisted state for the current course.
+       *
+       * @returns The strategy's data payload, or null if no state exists
+       * @throws Error if user or course is not initialized
+       */
+      async getStrategyState() {
+        if (!this.user || !this.course) {
+          throw new Error(
+            `Cannot get strategy state: navigator not properly initialized. Ensure user and course are provided to constructor.`
+          );
+        }
+        return this.user.getStrategyState(this.course.getCourseID(), this.strategyKey);
+      }
+      /**
+       * Persist this strategy's state for the current course.
+       *
+       * @param data - The strategy's data payload to store
+       * @throws Error if user or course is not initialized
+       */
+      async putStrategyState(data) {
+        if (!this.user || !this.course) {
+          throw new Error(
+            `Cannot put strategy state: navigator not properly initialized. Ensure user and course are provided to constructor.`
+          );
+        }
+        return this.user.putStrategyState(this.course.getCourseID(), this.strategyKey, data);
+      }
+      /**
+       * Factory method to create navigator instances.
+       *
+       * First checks the navigator registry for a pre-registered constructor.
+       * If not found, falls back to dynamic import (for custom navigators).
+       *
+       * For reliable operation in test environments, call initializeNavigatorRegistry()
+       * before using this method.
+       *
+       * @param user - User interface
+       * @param course - Course interface
+       * @param strategyData - Strategy configuration document
+       * @returns the runtime object used to steer a study session.
+       */
+      static async create(user, course, strategyData) {
+        const implementingClass = strategyData.implementingClass;
+        const RegisteredImpl = getRegisteredNavigator(implementingClass);
+        if (RegisteredImpl) {
+          logger.debug(`[ContentNavigator.create] Using registered navigator: ${implementingClass}`);
+          return new RegisteredImpl(user, course, strategyData);
+        }
+        logger.debug(
+          `[ContentNavigator.create] Navigator not in registry, attempting dynamic import: ${implementingClass}`
+        );
+        let NavigatorImpl;
+        const variations = [".ts", ".js", ""];
+        for (const ext of variations) {
+          try {
+            const module = await globImport_generators(`./generators/${implementingClass}${ext}`);
+            NavigatorImpl = module.default;
+            if (NavigatorImpl) break;
+          } catch (e) {
+            logger.debug(`Failed to load generator ${implementingClass}${ext}:`, e);
+          }
+          try {
+            const module = await globImport_filters(`./filters/${implementingClass}${ext}`);
+            NavigatorImpl = module.default;
+            if (NavigatorImpl) break;
+          } catch (e) {
+            logger.debug(`Failed to load filter ${implementingClass}${ext}:`, e);
+          }
+          try {
+            const module = await globImport(`./${implementingClass}${ext}`);
+            NavigatorImpl = module.default;
+            if (NavigatorImpl) break;
+          } catch (e) {
+            logger.debug(`Failed to load legacy ${implementingClass}${ext}:`, e);
+          }
+          if (NavigatorImpl) break;
+        }
+        if (!NavigatorImpl) {
+          throw new Error(`Could not load navigator implementation for: ${implementingClass}`);
+        }
+        return new NavigatorImpl(user, course, strategyData);
+      }
+      /**
+       * Get cards with suitability scores and provenance trails.
        *
-       * Two factors:
-       * 1. Relative overdueness = hoursOverdue / intervalHours
-       *    - 2 days overdue on 3-day interval = 0.67 (urgent)
-       *    - 2 days overdue on 180-day interval = 0.01 (not urgent)
+       * **This is the PRIMARY API for navigation strategies.**
        *
-       * 2. Interval recency factor = 0.3 + 0.7 * exp(-intervalHours / 720)
-       *    - 24h interval → ~1.0 (very recent learning)
-       *    - 30 days (720h) → ~0.56
-       *    - 180 days → ~0.30
+       * Returns cards ranked by suitability score (0-1). Higher scores indicate
+       * better candidates for presentation. Each card includes a provenance trail
+       * documenting how strategies contributed to the final score.
+       *
+       * ## Implementation Required
+       * All navigation strategies MUST override this method. The base class does
+       * not provide a default implementation.
+       *
+       * ## For Generators
+       * Override this method to generate candidates and compute scores based on
+       * your strategy's logic (e.g., ELO proximity, review urgency). Create the
+       * initial provenance entry with action='generated'.
        *
-       * Combined: base 0.5 + weighted average of factors * 0.45
-       * Result range: approximately 0.5 to 0.95
+       * ## For Filters
+       * Filters should implement the CardFilter interface instead and be composed
+       * via Pipeline. Filters do not directly implement getWeightedCards().
+       *
+       * @param limit - Maximum cards to return
+       * @returns Cards sorted by score descending, with provenance trails
        */
-      computeUrgencyScore(review, now) {
-        const scheduledAt = moment3.utc(review.scheduledAt);
-        const due = moment3.utc(review.reviewTime);
-        const intervalHours = Math.max(1, due.diff(scheduledAt, "hours"));
-        const hoursOverdue = now.diff(due, "hours");
-        const relativeOverdue = hoursOverdue / intervalHours;
-        const recencyFactor = 0.3 + 0.7 * Math.exp(-intervalHours / 720);
-        const overdueContribution = Math.min(1, Math.max(0, relativeOverdue));
-        const urgency = overdueContribution * 0.5 + recencyFactor * 0.5;
-        const score = Math.min(0.95, 0.5 + urgency * 0.45);
-        const reason = `${Math.round(hoursOverdue)}h overdue (interval: ${Math.round(intervalHours)}h, relative: ${relativeOverdue.toFixed(2)}), recency: ${recencyFactor.toFixed(2)}, review`;
-        return { score, reason };
+      async getWeightedCards(_limit) {
+        throw new Error(`${this.constructor.name} must implement getWeightedCards(). `);
       }
     };
   }
 });
 
-// src/core/navigators/filters/eloDistance.ts
-function computeMultiplier(distance, halfLife, minMultiplier, maxMultiplier) {
-  const normalizedDistance = distance / halfLife;
-  const decay = Math.exp(-(normalizedDistance * normalizedDistance));
-  return minMultiplier + (maxMultiplier - minMultiplier) * decay;
-}
-function createEloDistanceFilter(config) {
-  const halfLife = config?.halfLife ?? DEFAULT_HALF_LIFE;
-  const minMultiplier = config?.minMultiplier ?? DEFAULT_MIN_MULTIPLIER;
-  const maxMultiplier = config?.maxMultiplier ?? DEFAULT_MAX_MULTIPLIER;
-  return {
-    name: "ELO Distance Filter",
-    async transform(cards, context) {
-      const { course, userElo } = context;
-      const cardIds = cards.map((c) => c.cardId);
-      const cardElos = await course.getCardEloData(cardIds);
-      return cards.map((card, i) => {
-        const cardElo = cardElos[i]?.global?.score ?? 1e3;
-        const distance = Math.abs(cardElo - userElo);
-        const multiplier = computeMultiplier(distance, halfLife, minMultiplier, maxMultiplier);
-        const newScore = card.score * multiplier;
-        const action = multiplier < maxMultiplier - 0.01 ? "penalized" : "passed";
-        return {
-          ...card,
-          score: newScore,
-          provenance: [
-            ...card.provenance,
-            {
-              strategy: "eloDistance",
-              strategyName: "ELO Distance Filter",
-              strategyId: "ELO_DISTANCE_FILTER",
-              action,
-              score: newScore,
-              reason: `ELO distance ${Math.round(distance)} (card: ${Math.round(cardElo)}, user: ${Math.round(userElo)}) \u2192 ${multiplier.toFixed(2)}x`
-            }
-          ]
-        };
-      });
-    }
-  };
-}
-var DEFAULT_HALF_LIFE, DEFAULT_MIN_MULTIPLIER, DEFAULT_MAX_MULTIPLIER;
-var init_eloDistance = __esm({
-  "src/core/navigators/filters/eloDistance.ts"() {
-    "use strict";
-    DEFAULT_HALF_LIFE = 200;
-    DEFAULT_MIN_MULTIPLIER = 0.3;
-    DEFAULT_MAX_MULTIPLIER = 1;
-  }
-});
-
-// src/core/navigators/defaults.ts
-function createDefaultEloStrategy(courseId) {
-  return {
-    _id: "NAVIGATION_STRATEGY-ELO-default",
-    docType: "NAVIGATION_STRATEGY" /* NAVIGATION_STRATEGY */,
-    name: "ELO (default)",
-    description: "Default ELO-based navigation strategy for new cards",
-    implementingClass: "elo" /* ELO */,
-    course: courseId,
-    serializedData: ""
-  };
-}
-function createDefaultSrsStrategy(courseId) {
-  return {
-    _id: "NAVIGATION_STRATEGY-SRS-default",
-    docType: "NAVIGATION_STRATEGY" /* NAVIGATION_STRATEGY */,
-    name: "SRS (default)",
-    description: "Default SRS-based navigation strategy for reviews",
-    implementingClass: "srs" /* SRS */,
-    course: courseId,
-    serializedData: ""
-  };
-}
-function createDefaultPipeline(user, course) {
-  const courseId = course.getCourseID();
-  const eloNavigator = new ELONavigator(user, course, createDefaultEloStrategy(courseId));
-  const srsNavigator = new SRSNavigator(user, course, createDefaultSrsStrategy(courseId));
-  const compositeGenerator = new CompositeGenerator([eloNavigator, srsNavigator]);
-  const eloDistanceFilter = createEloDistanceFilter();
-  return new Pipeline(compositeGenerator, [eloDistanceFilter], user, course);
-}
-var init_defaults = __esm({
-  "src/core/navigators/defaults.ts"() {
-    "use strict";
-    init_navigators();
-    init_Pipeline();
-    init_CompositeGenerator();
-    init_elo();
-    init_srs();
-    init_eloDistance();
-    init_types_legacy();
-  }
-});
-
 // src/impl/couch/courseDB.ts
 import {
   EloToNumber,
   Status,
   blankCourseElo as blankCourseElo2,
-  toCourseElo as toCourseElo4
+  toCourseElo as toCourseElo6
 } from "@vue-skuilder/common";
 function randIntWeightedTowardZero(n) {
   return Math.floor(Math.random() * Math.random() * Math.random() * n);
@@ -1902,7 +3779,7 @@ var init_courseDB = __esm({
         docs.rows.forEach((r) => {
           if (isSuccessRow(r)) {
             if (r.doc && r.doc.elo) {
-              ret.push(toCourseElo4(r.doc.elo));
+              ret.push(toCourseElo6(r.doc.elo));
             } else {
               logger.warn("no elo data for card: " + r.id);
               ret.push(blankCourseElo2());
@@ -4115,6 +5992,19 @@ Currently logged-in as ${this._username}.`
         };
         await this.localDB.put(doc);
       }
+      async putUserOutcome(record) {
+        try {
+          await this.localDB.put(record);
+        } catch (err) {
+          if (err.status === 409) {
+            const existing = await this.localDB.get(record._id);
+            record._rev = existing._rev;
+            await this.localDB.put(record);
+          } else {
+            throw err;
+          }
+        }
+      }
       async deleteStrategyState(courseId, strategyKey) {
         const docId = buildStrategyStateId(courseId, strategyKey);
         try {
@@ -5242,6 +7132,7 @@ async function initializeDataLayer(config) {
     logger.warn("Data layer already initialized. Returning existing instance.");
     return dataLayerInstance;
   }
+  await initializeNavigatorRegistry();
   if (config.options.localStoragePrefix) {
     ENV.LOCAL_STORAGE_PREFIX = config.options.localStoragePrefix;
   }
@@ -5296,6 +7187,7 @@ var init_factory = __esm({
     "use strict";
     init_common();
     init_logger();
+    init_navigators();
     NOT_SET = "NOT_SET";
     ENV = {
       COUCHDB_SERVER_PROTOCOL: NOT_SET,
@@ -5552,6 +7444,13 @@ var init_strategyState = __esm({
   }
 });
 
+// src/core/types/userOutcome.ts
+var init_userOutcome = __esm({
+  "src/core/types/userOutcome.ts"() {
+    "use strict";
+  }
+});
+
 // src/core/bulkImport/cardProcessor.ts
 import { Status as Status5 } from "@vue-skuilder/common";
 async function importParsedCards(parsedCards, courseDB, config) {
@@ -5673,7 +7572,7 @@ var init_cardProcessor = __esm({
 });
 
 // src/core/bulkImport/types.ts
-var init_types = __esm({
+var init_types3 = __esm({
   "src/core/bulkImport/types.ts"() {
     "use strict";
   }
@@ -5684,7 +7583,7 @@ var init_bulkImport = __esm({
   "src/core/bulkImport/index.ts"() {
     "use strict";
     init_cardProcessor();
-    init_types();
+    init_types3();
   }
 });
 
@@ -5696,10 +7595,12 @@ var init_core = __esm({
     init_types_legacy();
     init_user();
     init_strategyState();
+    init_userOutcome();
     init_Loggable();
     init_util();
     init_navigators();
     init_bulkImport();
+    init_orchestration();
   }
 });
 
@@ -5846,6 +7747,66 @@ function registerQuestionType(question, courseConfig) {
   logger.info(`Registered QuestionType: ${namespacedQuestionName}`);
   return true;
 }
+function removeDataShape(dataShapeName, courseConfig) {
+  const index = courseConfig.dataShapes.findIndex((ds) => ds.name === dataShapeName);
+  if (index === -1) {
+    logger.info(`DataShape '${dataShapeName}' not found in course config`);
+    return false;
+  }
+  courseConfig.dataShapes.splice(index, 1);
+  courseConfig.questionTypes.forEach((qt) => {
+    const dsIndex = qt.dataShapeList.indexOf(dataShapeName);
+    if (dsIndex !== -1) {
+      qt.dataShapeList.splice(dsIndex, 1);
+    }
+  });
+  logger.info(`Removed DataShape: ${dataShapeName}`);
+  return true;
+}
+function removeQuestionType(questionTypeName, courseConfig) {
+  const index = courseConfig.questionTypes.findIndex((qt) => qt.name === questionTypeName);
+  if (index === -1) {
+    logger.info(`QuestionType '${questionTypeName}' not found in course config`);
+    return false;
+  }
+  courseConfig.questionTypes.splice(index, 1);
+  courseConfig.dataShapes.forEach((ds) => {
+    const qtIndex = ds.questionTypes.indexOf(questionTypeName);
+    if (qtIndex !== -1) {
+      ds.questionTypes.splice(qtIndex, 1);
+    }
+  });
+  logger.info(`Removed QuestionType: ${questionTypeName}`);
+  return true;
+}
+async function removeCustomQuestionTypes(dataShapeNames, questionTypeNames, courseConfig, courseDB) {
+  try {
+    logger.info("Beginning custom question removal");
+    logger.info(`Removing ${dataShapeNames.length} data shapes and ${questionTypeNames.length} question types`);
+    let removedCount = 0;
+    for (const qtName of questionTypeNames) {
+      if (removeQuestionType(qtName, courseConfig)) {
+        removedCount++;
+      }
+    }
+    for (const dsName of dataShapeNames) {
+      if (removeDataShape(dsName, courseConfig)) {
+        removedCount++;
+      }
+    }
+    logger.info("Updating course configuration...");
+    const updateResult = await courseDB.updateCourseConfig(courseConfig);
+    if (!updateResult.ok) {
+      throw new Error(`Failed to update course config: ${JSON.stringify(updateResult)}`);
+    }
+    logger.info(`Custom question removal complete: ${removedCount} items removed`);
+    return { success: true, removedCount };
+  } catch (error) {
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    logger.error(`Custom question removal failed: ${errorMessage}`);
+    return { success: false, removedCount: 0, errorMessage };
+  }
+}
 async function registerSeedData(question, courseDB, username) {
   if (question.questionClass.seedData && Array.isArray(question.questionClass.seedData)) {
     logger.info(`Registering seed data for question: ${question.name}`);
@@ -6037,6 +7998,14 @@ var SrsService = class {
   constructor(user) {
     this.user = user;
   }
+  /**
+   * Remove a scheduled review from the user's database.
+   * Used to clean up orphaned reviews (e.g., card deleted from course DB).
+   */
+  removeReview(reviewID) {
+    logger.info(`[SrsService] Removing orphaned scheduled review: ${reviewID}`);
+    void this.user.removeScheduledCardReview(reviewID);
+  }
   /**
    * Calculates the next review time for a card based on its history and
    * schedules it in the user's database.
@@ -6050,45 +8019,102 @@ var SrsService = class {
       logger.info(`[SrsService] Removing previously scheduled review for: ${item.cardID}`);
       void this.user.removeScheduledCardReview(item.reviewID);
     }
-    void this.user.scheduleCardReview({
-      user: this.user.getUsername(),
-      course_id: history.courseID,
-      card_id: history.cardID,
-      time: nextReviewTime,
-      scheduledFor: item.contentSourceType,
-      schedulingAgentId: item.contentSourceID
-    });
-  }
-};
-
-// src/study/services/EloService.ts
-init_logger();
-import { adjustCourseScores, toCourseElo as toCourseElo5 } from "@vue-skuilder/common";
-var EloService = class {
-  dataLayer;
-  user;
-  constructor(dataLayer, user) {
-    this.dataLayer = dataLayer;
-    this.user = user;
+    void this.user.scheduleCardReview({
+      user: this.user.getUsername(),
+      course_id: history.courseID,
+      card_id: history.cardID,
+      time: nextReviewTime,
+      scheduledFor: item.contentSourceType,
+      schedulingAgentId: item.contentSourceID
+    });
+  }
+};
+
+// src/study/services/EloService.ts
+init_logger();
+import {
+  adjustCourseScores,
+  adjustCourseScoresPerTag,
+  toCourseElo as toCourseElo7
+} from "@vue-skuilder/common";
+var EloService = class {
+  dataLayer;
+  user;
+  constructor(dataLayer, user) {
+    this.dataLayer = dataLayer;
+    this.user = user;
+  }
+  /**
+   * Updates both user and card ELO ratings based on user performance.
+   * @param userScore Score between 0-1 representing user performance
+   * @param course_id Course identifier
+   * @param card_id Card identifier
+   * @param userCourseRegDoc User's course registration document (will be mutated)
+   * @param currentCard Current card session record
+   * @param k Optional K-factor for ELO calculation
+   */
+  async updateUserAndCardElo(userScore, course_id, card_id, userCourseRegDoc, currentCard, k) {
+    if (k) {
+      logger.warn(`k value interpretation not currently implemented`);
+    }
+    const courseDB = this.dataLayer.getCourseDB(currentCard.card.course_id);
+    const userElo = toCourseElo7(
+      userCourseRegDoc.courses.find((c) => c.courseID === course_id).elo
+    );
+    const cardElo = (await courseDB.getCardEloData([currentCard.card.card_id]))[0];
+    if (cardElo && userElo) {
+      const eloUpdate = 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),
+        courseDB.updateCardElo(card_id, eloUpdate.cardElo)
+      ]);
+      const userEloStatus = results[0].status === "fulfilled";
+      const cardEloStatus = results[1].status === "fulfilled";
+      if (userEloStatus && cardEloStatus) {
+        const user = results[0].value;
+        const card = results[1].value;
+        if (user.ok && card && card.ok) {
+          logger.info(
+            `[EloService] Updated ELOS:
+            	User: ${JSON.stringify(eloUpdate.userElo)})
+            	Card: ${JSON.stringify(eloUpdate.cardElo)})
+            `
+          );
+        }
+      } else {
+        logger.warn(
+          `[EloService] Partial ELO update:
+          	User ELO update: ${userEloStatus ? "SUCCESS" : "FAILED"}
+          	Card ELO update: ${cardEloStatus ? "SUCCESS" : "FAILED"}`
+        );
+        if (!userEloStatus && results[0].status === "rejected") {
+          logger.error("[EloService] User ELO update error:", results[0].reason);
+        }
+        if (!cardEloStatus && results[1].status === "rejected") {
+          logger.error("[EloService] Card ELO update error:", results[1].reason);
+        }
+      }
+    }
   }
   /**
-   * Updates both user and card ELO ratings based on user performance.
-   * @param userScore Score between 0-1 representing user performance
+   * Updates both user and card ELO ratings with per-tag granularity.
+   * Tags in taggedPerformance but not on card will be created dynamically.
+   *
+   * @param taggedPerformance Performance object with _global and per-tag scores
    * @param course_id Course identifier
-   * @param card_id Card identifier  
+   * @param card_id Card identifier
    * @param userCourseRegDoc User's course registration document (will be mutated)
    * @param currentCard Current card session record
-   * @param k Optional K-factor for ELO calculation
    */
-  async updateUserAndCardElo(userScore, course_id, card_id, userCourseRegDoc, currentCard, k) {
-    if (k) {
-      logger.warn(`k value interpretation not currently implemented`);
-    }
+  async updateUserAndCardEloPerTag(taggedPerformance, course_id, card_id, userCourseRegDoc, currentCard) {
     const courseDB = this.dataLayer.getCourseDB(currentCard.card.course_id);
-    const userElo = toCourseElo5(userCourseRegDoc.courses.find((c) => c.courseID === course_id).elo);
+    const userElo = toCourseElo7(
+      userCourseRegDoc.courses.find((c) => c.courseID === course_id).elo
+    );
     const cardElo = (await courseDB.getCardEloData([currentCard.card.card_id]))[0];
     if (cardElo && userElo) {
-      const eloUpdate = adjustCourseScores(userElo, cardElo, userScore);
+      const eloUpdate = 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),
@@ -6100,8 +8126,9 @@ var EloService = class {
         const user = results[0].value;
         const card = results[1].value;
         if (user.ok && card && card.ok) {
+          const tagCount = Object.keys(taggedPerformance).length - 1;
           logger.info(
-            `[EloService] Updated ELOS:
+            `[EloService] Updated ELOS (per-tag, ${tagCount} tags):
             	User: ${JSON.stringify(eloUpdate.userElo)})
             	Card: ${JSON.stringify(eloUpdate.cardElo)})
             `
@@ -6109,7 +8136,7 @@ var EloService = class {
         }
       } else {
         logger.warn(
-          `[EloService] Partial ELO update:
+          `[EloService] Partial ELO update (per-tag):
           	User ELO update: ${userEloStatus ? "SUCCESS" : "FAILED"}
           	Card ELO update: ${cardEloStatus ? "SUCCESS" : "FAILED"}`
         );
@@ -6127,6 +8154,7 @@ var EloService = class {
 // src/study/services/ResponseProcessor.ts
 init_core();
 init_logger();
+import { isTaggedPerformance } from "@vue-skuilder/common";
 var ResponseProcessor = class {
   srsService;
   eloService;
@@ -6134,6 +8162,33 @@ var ResponseProcessor = class {
     this.srsService = srsService;
     this.eloService = eloService;
   }
+  /**
+   * Parses performance data into global score and optional per-tag scores.
+   *
+   * @param performance - Numeric or structured performance from QuestionRecord
+   * @returns Parsed performance with global score and optional tag scores
+   */
+  parsePerformance(performance2) {
+    if (typeof performance2 === "number") {
+      return {
+        globalScore: performance2,
+        taggedPerformance: null
+      };
+    }
+    if (isTaggedPerformance(performance2)) {
+      return {
+        globalScore: performance2._global,
+        taggedPerformance: performance2
+      };
+    }
+    logger.warn("[ResponseProcessor] Unexpected performance structure, using neutral score", {
+      performance: performance2
+    });
+    return {
+      globalScore: 0.5,
+      taggedPerformance: null
+    };
+  }
   /**
    * Processes a user's response to a card, handling SRS scheduling and ELO updates.
    * @param cardRecord User's response record
@@ -6194,46 +8249,60 @@ var ResponseProcessor = class {
   processCorrectResponse(cardRecord, history, studySessionItem, courseRegistrationDoc, currentCard, courseId, cardId) {
     if (cardRecord.priorAttemps === 0) {
       void this.srsService.scheduleReview(history, studySessionItem);
-      if (history.records.length === 1) {
-        const userScore = 0.5 + cardRecord.performance / 2;
-        void this.eloService.updateUserAndCardElo(
-          userScore,
+      const { globalScore, taggedPerformance } = this.parsePerformance(cardRecord.performance);
+      if (taggedPerformance) {
+        void this.eloService.updateUserAndCardEloPerTag(
+          taggedPerformance,
           courseId,
           cardId,
           courseRegistrationDoc,
           currentCard
         );
+        logger.info(
+          `[ResponseProcessor] Processed correct response with per-tag ELO update (${Object.keys(taggedPerformance).length - 1} tags)`
+        );
       } else {
-        const k = Math.ceil(32 / history.records.length);
-        const userScore = 0.5 + cardRecord.performance / 2;
-        void this.eloService.updateUserAndCardElo(
-          userScore,
-          courseId,
-          cardId,
-          courseRegistrationDoc,
-          currentCard,
-          k
+        const userScore = 0.5 + globalScore / 2;
+        if (history.records.length === 1) {
+          void this.eloService.updateUserAndCardElo(
+            userScore,
+            courseId,
+            cardId,
+            courseRegistrationDoc,
+            currentCard
+          );
+        } else {
+          const k = Math.ceil(32 / history.records.length);
+          void this.eloService.updateUserAndCardElo(
+            userScore,
+            courseId,
+            cardId,
+            courseRegistrationDoc,
+            currentCard,
+            k
+          );
+        }
+        logger.info(
+          "[ResponseProcessor] Processed correct response with SRS scheduling and ELO update"
         );
       }
-      logger.info(
-        "[ResponseProcessor] Processed correct response with SRS scheduling and ELO update"
-      );
       return {
         nextCardAction: "dismiss-success",
         shouldLoadNextCard: true,
         isCorrect: true,
-        performanceScore: cardRecord.performance,
+        performanceScore: globalScore,
         shouldClearFeedbackShadow: true
       };
     } else {
       logger.info(
         "[ResponseProcessor] Processed correct response (retry attempt - no scheduling/ELO)"
       );
+      const { globalScore } = this.parsePerformance(cardRecord.performance);
       return {
         nextCardAction: "marked-failed",
         shouldLoadNextCard: true,
         isCorrect: true,
-        performanceScore: cardRecord.performance,
+        performanceScore: globalScore,
         shouldClearFeedbackShadow: true
       };
     }
@@ -6242,28 +8311,52 @@ var ResponseProcessor = class {
    * Handles processing for incorrect responses: ELO updates only.
    */
   processIncorrectResponse(cardRecord, history, courseRegistrationDoc, currentCard, courseId, cardId, maxAttemptsPerView, maxSessionViews, sessionViews) {
+    const { taggedPerformance } = this.parsePerformance(cardRecord.performance);
     if (history.records.length !== 1 && cardRecord.priorAttemps === 0) {
-      void this.eloService.updateUserAndCardElo(
-        0,
-        // Failed response = 0 score
-        courseId,
-        cardId,
-        courseRegistrationDoc,
-        currentCard
-      );
-      logger.info("[ResponseProcessor] Processed incorrect response with ELO update");
-    } else {
-      logger.info("[ResponseProcessor] Processed incorrect response (no ELO update needed)");
-    }
-    if (currentCard.records.length >= maxAttemptsPerView) {
-      if (sessionViews >= maxSessionViews) {
+      if (taggedPerformance) {
+        void this.eloService.updateUserAndCardEloPerTag(
+          taggedPerformance,
+          courseId,
+          cardId,
+          courseRegistrationDoc,
+          currentCard
+        );
+        logger.info(
+          `[ResponseProcessor] Processed incorrect response with per-tag ELO update (${Object.keys(taggedPerformance).length - 1} tags)`
+        );
+      } else {
         void this.eloService.updateUserAndCardElo(
           0,
+          // Failed response = 0 score
           courseId,
           cardId,
           courseRegistrationDoc,
           currentCard
         );
+        logger.info("[ResponseProcessor] Processed incorrect response with ELO update");
+      }
+    } else {
+      logger.info("[ResponseProcessor] Processed incorrect response (no ELO update needed)");
+    }
+    if (currentCard.records.length >= maxAttemptsPerView) {
+      if (sessionViews >= maxSessionViews) {
+        if (taggedPerformance) {
+          void this.eloService.updateUserAndCardEloPerTag(
+            taggedPerformance,
+            courseId,
+            cardId,
+            courseRegistrationDoc,
+            currentCard
+          );
+        } else {
+          void this.eloService.updateUserAndCardElo(
+            0,
+            courseId,
+            cardId,
+            courseRegistrationDoc,
+            currentCard
+          );
+        }
         return {
           nextCardAction: "dismiss-failed",
           shouldLoadNextCard: true,
@@ -6294,7 +8387,7 @@ init_logger();
 import {
   displayableDataToViewData,
   isCourseElo,
-  toCourseElo as toCourseElo6
+  toCourseElo as toCourseElo8
 } from "@vue-skuilder/common";
 function parseAudioURIs(data) {
   if (typeof data !== "string") return [];
@@ -6430,7 +8523,7 @@ var CardHydrationService = class {
       const courseDB = this.getCourseDB(item.courseID);
       const cardData = await courseDB.getCourseDoc(item.cardID);
       if (!isCourseElo(cardData.elo)) {
-        cardData.elo = toCourseElo6(cardData.elo);
+        cardData.elo = toCourseElo8(cardData.elo);
       }
       const view = this.getViewComponent(cardData.id_view);
       const dataDocs = await Promise.all(
@@ -6515,6 +8608,7 @@ var ItemQueue = class {
 
 // src/study/SessionController.ts
 init_couch();
+init_recording();
 
 // src/util/index.ts
 init_Loggable();
@@ -7948,15 +10042,644 @@ var QuotaRoundRobinMixer = class {
       return [];
     }
     const quotaPerSource = Math.ceil(limit / batches.length);
-    const mixed = [];
-    for (const batch of batches) {
-      const sortedBatch = [...batch.weighted].sort((a, b) => b.score - a.score);
-      const topFromSource = sortedBatch.slice(0, quotaPerSource);
-      mixed.push(...topFromSource);
+    const sourceStacks = batches.map((batch) => {
+      return [...batch.weighted].sort((a, b) => b.score - a.score).slice(0, quotaPerSource);
+    });
+    for (let i = sourceStacks.length - 1; i > 0; i--) {
+      const j = Math.floor(Math.random() * (i + 1));
+      [sourceStacks[i], sourceStacks[j]] = [sourceStacks[j], sourceStacks[i]];
+    }
+    const result = [];
+    let exhausted = 0;
+    const cursors = new Array(sourceStacks.length).fill(0);
+    while (result.length < limit && exhausted < sourceStacks.length) {
+      exhausted = 0;
+      for (let s = 0; s < sourceStacks.length; s++) {
+        if (result.length >= limit) break;
+        if (cursors[s] < sourceStacks[s].length) {
+          result.push(sourceStacks[s][cursors[s]]);
+          cursors[s]++;
+        } else {
+          exhausted++;
+        }
+      }
+    }
+    return result;
+  }
+};
+
+// src/study/MixerDebugger.ts
+init_logger();
+init_navigators();
+var MAX_RUNS2 = 10;
+var runHistory2 = [];
+function buildSourceSummary(batch, sourceId, sourceName) {
+  const scores = batch.weighted.map((c) => c.score);
+  const reviewCount = batch.weighted.filter((c) => getCardOrigin(c) === "review").length;
+  const newCount = batch.weighted.filter((c) => getCardOrigin(c) === "new").length;
+  return {
+    sourceIndex: batch.sourceIndex,
+    sourceId,
+    sourceName,
+    totalCards: batch.weighted.length,
+    reviewCount,
+    newCount,
+    topScore: scores.length > 0 ? Math.max(...scores) : 0,
+    bottomScore: scores.length > 0 ? Math.min(...scores) : 0,
+    scoreRange: scores.length > 0 ? [Math.min(...scores), Math.max(...scores)] : [0, 0],
+    avgScore: scores.length > 0 ? scores.reduce((a, b) => a + b, 0) / scores.length : 0
+  };
+}
+function buildSourceBreakdown(sourceId, sourceName, allCards) {
+  const sourceCards = allCards.filter((c) => c.courseId === sourceId);
+  const selectedCards = sourceCards.filter((c) => c.selected);
+  const reviewsProvided = sourceCards.filter((c) => c.origin === "review").length;
+  const newProvided = sourceCards.filter((c) => c.origin === "new").length;
+  const reviewsSelected = selectedCards.filter((c) => c.origin === "review").length;
+  const newSelected = selectedCards.filter((c) => c.origin === "new").length;
+  return {
+    sourceId,
+    sourceName,
+    reviewsProvided,
+    newProvided,
+    reviewsSelected,
+    newSelected,
+    totalSelected: selectedCards.length,
+    selectionRate: sourceCards.length > 0 ? selectedCards.length / sourceCards.length * 100 : 0
+  };
+}
+function captureMixerRun(mixerType, batches, sourceIds, sourceNames, requestedLimit, quotaPerSource, mixedResult) {
+  const sourceSummaries = batches.map(
+    (batch, idx) => buildSourceSummary(batch, sourceIds[idx] || `source-${idx}`, sourceNames[idx])
+  );
+  const selectedIds = new Set(mixedResult.map((c) => c.cardId));
+  const sourceRankings = /* @__PURE__ */ new Map();
+  batches.forEach((batch) => {
+    const sorted = [...batch.weighted].sort((a, b) => b.score - a.score);
+    const rankings = /* @__PURE__ */ new Map();
+    sorted.forEach((card, idx) => {
+      rankings.set(card.cardId, idx + 1);
+    });
+    sourceRankings.set(sourceIds[batch.sourceIndex] || `source-${batch.sourceIndex}`, rankings);
+  });
+  const mixRankings = /* @__PURE__ */ new Map();
+  mixedResult.forEach((card, idx) => {
+    mixRankings.set(card.cardId, idx + 1);
+  });
+  const allCardsMap = /* @__PURE__ */ new Map();
+  batches.forEach((batch) => {
+    batch.weighted.forEach((card) => {
+      allCardsMap.set(card.cardId, card);
+    });
+  });
+  const cards = Array.from(allCardsMap.values()).map((card) => ({
+    cardId: card.cardId,
+    courseId: card.courseId,
+    origin: getCardOrigin(card),
+    score: card.score,
+    sourceIndex: batches.findIndex((b) => b.weighted.some((c) => c.cardId === card.cardId)),
+    selected: selectedIds.has(card.cardId),
+    rankInSource: sourceRankings.get(card.courseId)?.get(card.cardId),
+    rankInMix: mixRankings.get(card.cardId)
+  }));
+  const uniqueSourceIds = Array.from(new Set(sourceIds.filter((id) => id)));
+  const sourceBreakdowns = uniqueSourceIds.map(
+    (sourceId, idx) => buildSourceBreakdown(sourceId, sourceNames[idx], cards)
+  );
+  const report = {
+    runId: `mix-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
+    timestamp: /* @__PURE__ */ new Date(),
+    mixerType,
+    requestedLimit,
+    quotaPerSource,
+    sourceSummaries,
+    cards,
+    finalCount: mixedResult.length,
+    reviewsSelected: mixedResult.filter((c) => getCardOrigin(c) === "review").length,
+    newSelected: mixedResult.filter((c) => getCardOrigin(c) === "new").length,
+    sourceBreakdowns
+  };
+  runHistory2.unshift(report);
+  if (runHistory2.length > MAX_RUNS2) {
+    runHistory2.pop();
+  }
+}
+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();
+}
+var 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()
+`);
+  }
+};
+function mountMixerDebugger() {
+  if (typeof window === "undefined") return;
+  const win = window;
+  win.skuilder = win.skuilder || {};
+  win.skuilder.mixer = mixerDebugAPI;
+}
+mountMixerDebugger();
+
+// src/study/SessionDebugger.ts
+init_logger();
+var activeSession = null;
+var sessionHistory = [];
+var MAX_HISTORY = 5;
+function startSessionTracking(reviewQLength, newQLength, failedQLength) {
+  const sessionId = `session-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+  activeSession = {
+    sessionId,
+    startTime: /* @__PURE__ */ new Date(),
+    initialQueues: {
+      timestamp: /* @__PURE__ */ new Date(),
+      reviewQLength,
+      newQLength,
+      failedQLength
+    },
+    presentations: [],
+    queueSnapshots: []
+  };
+  logger.debug(`[SessionDebugger] Started tracking session: ${sessionId}`);
+}
+function recordCardPresentation(cardId, courseId, courseName, origin, queueSource, score) {
+  if (!activeSession) {
+    logger.warn("[SessionDebugger] No active session to record presentation");
+    return;
+  }
+  activeSession.presentations.push({
+    timestamp: /* @__PURE__ */ new Date(),
+    sequenceNumber: activeSession.presentations.length + 1,
+    cardId,
+    courseId,
+    courseName,
+    origin,
+    queueSource,
+    score
+  });
+}
+function snapshotQueues(reviewQLength, newQLength, failedQLength, reviewQNext3, newQNext3) {
+  if (!activeSession) {
+    return;
+  }
+  activeSession.queueSnapshots.push({
+    timestamp: /* @__PURE__ */ new Date(),
+    reviewQLength,
+    newQLength,
+    failedQLength,
+    reviewQNext3,
+    newQNext3
+  });
+}
+function endSessionTracking() {
+  if (!activeSession) {
+    return;
+  }
+  activeSession.endTime = /* @__PURE__ */ new Date();
+  sessionHistory.unshift(activeSession);
+  if (sessionHistory.length > MAX_HISTORY) {
+    sessionHistory.pop();
+  }
+  logger.debug(`[SessionDebugger] Ended session: ${activeSession.sessionId}`);
+  activeSession = null;
+}
+function showCurrentQueue() {
+  if (!activeSession) {
+    logger.info("[Session Debug] No active session.");
+    return;
+  }
+  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(", ")}`);
+  }
+  logger.info(`New Queue: ${latest.newQLength} cards`);
+  if (latest.newQNext3 && latest.newQNext3.length > 0) {
+    logger.info(`  Next: ${latest.newQNext3.join(", ")}`);
+  }
+  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;
+  }
+  console.group(`\u{1F4DC} Session History: ${session.sessionId}`);
+  logger.info(`Started: ${session.startTime.toLocaleTimeString()}`);
+  if (session.endTime) {
+    logger.info(`Ended: ${session.endTime.toLocaleTimeString()}`);
+  }
+  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()
+      }))
+    );
+  }
+  console.groupEnd();
+}
+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;
     }
-    return mixed.sort((a, b) => b.score - a.score).slice(0, limit);
+  }
+  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();
+}
+var 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 mountSessionDebugger() {
+  if (typeof window === "undefined") return;
+  const win = window;
+  win.skuilder = win.skuilder || {};
+  win.skuilder.session = sessionDebugAPI;
+}
+mountSessionDebugger();
 
 // src/study/SessionController.ts
 init_logger();
@@ -7967,6 +10690,8 @@ var SessionController = class extends Loggable {
   eloService;
   hydrationService;
   mixer;
+  dataLayer;
+  courseNameCache = /* @__PURE__ */ new Map();
   sources;
   // dataLayer and getViewComponent now injected into CardHydrationService
   _sessionRecord = [];
@@ -7986,7 +10711,11 @@ var SessionController = class extends Loggable {
     return this._secondsRemaining;
   }
   get report() {
-    return `${this.reviewQ.dequeueCount} reviews, ${this.newQ.dequeueCount} new cards`;
+    const reviewCount = this.reviewQ.dequeueCount;
+    const newCount = this.newQ.dequeueCount;
+    const reviewWord = reviewCount === 1 ? "review" : "reviews";
+    const newCardWord = newCount === 1 ? "new card" : "new cards";
+    return `${reviewCount} ${reviewWord}, ${newCount} ${newCardWord}`;
   }
   get detailedReport() {
     return this.newQ.toString + "\n" + this.reviewQ.toString + "\n" + this.failedQ.toString;
@@ -8002,6 +10731,7 @@ var SessionController = class extends Loggable {
    */
   constructor(sources, time, dataLayer, getViewComponent, mixer) {
     super();
+    this.dataLayer = dataLayer;
     this.mixer = mixer || new QuotaRoundRobinMixer();
     this.srsService = new SrsService(dataLayer.getUserDB());
     this.eloService = new EloService(dataLayer, dataLayer.getUserDB());
@@ -8069,6 +10799,7 @@ var SessionController = class extends Loggable {
     }
     await this.getWeightedContent();
     await this.hydrationService.ensureHydratedCards();
+    startSessionTracking(this.reviewQ.length, this.newQ.length, this.failedQ.length);
     this._intervalHandle = setInterval(() => {
       this.tick();
     }, 1e3);
@@ -8164,6 +10895,30 @@ var SessionController = class extends Loggable {
       );
     }
     const mixedWeighted = this.mixer.mix(batches, limit * this.sources.length);
+    const sourceIds = batches.map((b) => {
+      const firstCard = b.weighted[0];
+      return firstCard?.courseId || `source-${b.sourceIndex}`;
+    });
+    await Promise.all(
+      sourceIds.map(async (id) => {
+        try {
+          const config = await this.dataLayer.getCoursesDB().getCourseConfig(id);
+          this.courseNameCache.set(id, config.name);
+        } catch {
+        }
+      })
+    );
+    const sourceNames = sourceIds.map((id) => this.courseNameCache.get(id));
+    const quotaPerSource = this.mixer instanceof QuotaRoundRobinMixer ? Math.ceil(limit * this.sources.length / batches.length) : void 0;
+    captureMixerRun(
+      this.mixer.constructor.name,
+      batches,
+      sourceIds,
+      sourceNames,
+      limit * this.sources.length,
+      quotaPerSource,
+      mixedWeighted
+    );
     const reviewWeighted = mixedWeighted.filter((w) => getCardOrigin(w) === "review");
     const newWeighted = mixedWeighted.filter((w) => getCardOrigin(w) === "new");
     logger.debug(`[reviews] got ${reviewWeighted.length} reviews from mixer`);
@@ -8272,21 +11027,46 @@ var SessionController = class extends Loggable {
     this.dismissCurrentCard(action);
     if (this._secondsRemaining <= 0 && this.failedQ.length === 0) {
       this._currentCard = null;
+      endSessionTracking();
       return null;
     }
-    const nextItem = this._selectNextItemToHydrate();
-    if (!nextItem) {
-      this._currentCard = null;
-      return null;
-    }
-    let card = this.hydrationService.getHydratedCard(nextItem.cardID);
-    if (!card) {
-      card = await this.hydrationService.waitForCard(nextItem.cardID);
+    const MAX_SKIP = 20;
+    for (let attempt = 0; attempt < MAX_SKIP; attempt++) {
+      const nextItem = this._selectNextItemToHydrate();
+      if (!nextItem) {
+        this._currentCard = null;
+        endSessionTracking();
+        return null;
+      }
+      let card = this.hydrationService.getHydratedCard(nextItem.cardID);
+      if (!card) {
+        card = await this.hydrationService.waitForCard(nextItem.cardID);
+      }
+      this.removeItemFromQueue(nextItem);
+      if (card) {
+        await this.hydrationService.ensureHydratedCards();
+        this._currentCard = card;
+        const origin = nextItem.status === "review" || nextItem.status === "failed-review" ? "review" : nextItem.status === "new" || nextItem.status === "failed-new" ? "new" : "failed";
+        const queueSource = nextItem.status.startsWith("failed") ? "failedQ" : nextItem.status === "review" ? "reviewQ" : "newQ";
+        recordCardPresentation(
+          nextItem.cardID,
+          nextItem.courseID,
+          this.courseNameCache.get(nextItem.courseID),
+          origin,
+          queueSource
+        );
+        snapshotQueues(this.reviewQ.length, this.newQ.length, this.failedQ.length);
+        return card;
+      }
+      this.log(`Skipping card ${nextItem.cardID}: hydration failed, trying next`);
+      if (isReview(nextItem)) {
+        this.srsService.removeReview(nextItem.reviewID);
+      }
     }
-    this.removeItemFromQueue(nextItem);
-    await this.hydrationService.ensureHydratedCards();
-    this._currentCard = card;
-    return card;
+    this.log(`Exhausted ${MAX_SKIP} skip attempts finding a hydratable card`);
+    this._currentCard = null;
+    endSessionTracking();
+    return null;
   }
   /**
    * Public API for processing user responses to cards.
@@ -8362,6 +11142,49 @@ var SessionController = class extends Loggable {
       this.failedQ.dequeue((queueItem) => queueItem.cardID);
     }
   }
+  /**
+   * End the session and record learning outcomes.
+   *
+   * This method aggregates all responses from the session and records a
+   * UserOutcomeRecord if evolutionary orchestration is enabled.
+   */
+  async endSession() {
+    if (!this._sessionRecord || this._sessionRecord.length === 0) {
+      return;
+    }
+    const questionRecords = this._sessionRecord.flatMap((r) => r.records).filter((r) => r.userAnswer !== void 0);
+    if (questionRecords.length === 0) {
+      return;
+    }
+    let orchestrationContext = null;
+    const strategies = [];
+    for (const source of this.sources) {
+      if (source.getOrchestrationContext) {
+        try {
+          orchestrationContext = await source.getOrchestrationContext();
+          if (source.getStrategyIds) {
+            strategies.push(...source.getStrategyIds());
+          }
+        } catch (e) {
+          logger.warn(`[SessionController] Failed to get orchestration context: ${e}`);
+        }
+        if (orchestrationContext) break;
+      }
+    }
+    if (!orchestrationContext) {
+      logger.debug("[SessionController] No orchestration context available, skipping outcome recording");
+      return;
+    }
+    const periodEnd = (/* @__PURE__ */ new Date()).toISOString();
+    const periodStart = new Date(this.startTime).toISOString();
+    await recordUserOutcome(
+      orchestrationContext,
+      periodStart,
+      periodEnd,
+      questionRecords,
+      strategies
+    );
+  }
 };
 
 // src/study/index.ts
@@ -8388,19 +11211,33 @@ export {
   StaticToCouchDBMigrator,
   TagFilteredContentSource,
   _resetDataLayer,
+  aggregateOutcomesForGradient,
   areQuestionRecords,
   buildStrategyStateId,
+  captureMixerRun,
+  computeDeviation,
+  computeEffectiveWeight,
+  computeOutcomeSignal,
+  computeSpread,
+  computeStrategyGradient,
+  createOrchestrationContext,
   docIsDeleted,
+  endSessionTracking,
   ensureAppDataDirectory,
   getAppDataDirectory,
   getCardHistoryID,
   getCardOrigin,
   getDataLayer,
   getDbPath,
+  getDefaultLearnableWeight,
+  getRegisteredNavigator,
+  getRegisteredNavigatorNames,
   getStudySource,
+  hasRegisteredNavigator,
   importParsedCards,
   initializeDataDirectory,
   initializeDataLayer,
+  initializeNavigatorRegistry,
   isDataShapeRegistered,
   isDataShapeSchemaAvailable,
   isFilter,
@@ -8409,14 +11246,32 @@ export {
   isQuestionTypeRegistered,
   isReview,
   log,
+  mixerDebugAPI,
+  mountMixerDebugger,
+  mountPipelineDebugger,
+  mountSessionDebugger,
   newInterval,
   parseCardHistoryID,
+  pipelineDebugAPI,
   processCustomQuestionsData,
+  recordCardPresentation,
+  recordUserOutcome,
   registerBlanksCard,
   registerCustomQuestionTypes,
   registerDataShape,
+  registerNavigator,
   registerQuestionType,
   registerSeedData,
+  removeCustomQuestionTypes,
+  removeDataShape,
+  removeQuestionType,
+  runPeriodUpdate,
+  scoreAccuracyInZone,
+  sessionDebugAPI,
+  snapshotQueues,
+  startSessionTracking,
+  updateLearningState,
+  updateStrategyWeight,
   validateMigration,
   validateProcessorConfig,
   validateStaticCourse