@vue-skuilder/db 0.1.20 → 0.1.21

package/dist/pouch/index.js

@@ -40,6 +40,9 @@ var import_pouchdb_find = __toESM(require("pouchdb-find"), 1);
 var import_pouchdb_authentication = __toESM(require("@nilock2/pouchdb-authentication"), 1);
 import_pouchdb.default.plugin(import_pouchdb_find.default);
 import_pouchdb.default.plugin(import_pouchdb_authentication.default);
+if (typeof import_pouchdb.default.debug !== "undefined") {
+  import_pouchdb.default.debug.disable();
+}
 import_pouchdb.default.defaults({
   // ajax: {
   //   timeout: 60000,

package/dist/pouch/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/pouch/index.ts","../../src/impl/couch/pouchdb-setup.ts"],"sourcesContent":["// Export configured PouchDB instance\nexport { default } from '../impl/couch/pouchdb-setup.js';","import PouchDB from 'pouchdb';\nimport PouchDBFind from 'pouchdb-find';\nimport PouchDBAuth from '@nilock2/pouchdb-authentication';\n\n// Register plugins\nPouchDB.plugin(PouchDBFind);\nPouchDB.plugin(PouchDBAuth);\n\n// Configure PouchDB globally\nPouchDB.defaults({\n  // ajax: {\n  //   timeout: 60000,\n  // },\n});\n\nexport default PouchDB;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,qBAAoB;AACpB,0BAAwB;AACxB,oCAAwB;AAGxB,eAAAA,QAAQ,OAAO,oBAAAC,OAAW;AAC1B,eAAAD,QAAQ,OAAO,8BAAAE,OAAW;AAG1B,eAAAF,QAAQ,SAAS;AAAA;AAAA;AAAA;AAIjB,CAAC;AAED,IAAO,wBAAQ,eAAAA;","names":["PouchDB","PouchDBFind","PouchDBAuth"]}
+{"version":3,"sources":["../../src/pouch/index.ts","../../src/impl/couch/pouchdb-setup.ts"],"sourcesContent":["// Export configured PouchDB instance\nexport { default } from '../impl/couch/pouchdb-setup.js';","import PouchDB from 'pouchdb';\nimport PouchDBFind from 'pouchdb-find';\nimport PouchDBAuth from '@nilock2/pouchdb-authentication';\n\n// Register plugins\nPouchDB.plugin(PouchDBFind);\nPouchDB.plugin(PouchDBAuth);\n\n// Disable PouchDB debug logging to prevent interference with CLI prompts\n// Debug logging (like DerivedLogger.emit) will still go to the TUI log file\n// if initializeTuiLogging() has been called, but won't clutter terminal output\nif (typeof PouchDB.debug !== 'undefined') {\n  PouchDB.debug.disable();\n}\n\n// Configure PouchDB globally\nPouchDB.defaults({\n  // ajax: {\n  //   timeout: 60000,\n  // },\n});\n\nexport default PouchDB;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,qBAAoB;AACpB,0BAAwB;AACxB,oCAAwB;AAGxB,eAAAA,QAAQ,OAAO,oBAAAC,OAAW;AAC1B,eAAAD,QAAQ,OAAO,8BAAAE,OAAW;AAK1B,IAAI,OAAO,eAAAF,QAAQ,UAAU,aAAa;AACxC,iBAAAA,QAAQ,MAAM,QAAQ;AACxB;AAGA,eAAAA,QAAQ,SAAS;AAAA;AAAA;AAAA;AAIjB,CAAC;AAED,IAAO,wBAAQ,eAAAA;","names":["PouchDB","PouchDBFind","PouchDBAuth"]}

package/dist/pouch/index.mjs

@@ -4,6 +4,9 @@ import PouchDBFind from "pouchdb-find";
 import PouchDBAuth from "@nilock2/pouchdb-authentication";
 PouchDB.plugin(PouchDBFind);
 PouchDB.plugin(PouchDBAuth);
+if (typeof PouchDB.debug !== "undefined") {
+  PouchDB.debug.disable();
+}
 PouchDB.defaults({
   // ajax: {
   //   timeout: 60000,

package/dist/pouch/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/impl/couch/pouchdb-setup.ts"],"sourcesContent":["import PouchDB from 'pouchdb';\nimport PouchDBFind from 'pouchdb-find';\nimport PouchDBAuth from '@nilock2/pouchdb-authentication';\n\n// Register plugins\nPouchDB.plugin(PouchDBFind);\nPouchDB.plugin(PouchDBAuth);\n\n// Configure PouchDB globally\nPouchDB.defaults({\n  // ajax: {\n  //   timeout: 60000,\n  // },\n});\n\nexport default PouchDB;\n"],"mappings":";AAAA,OAAO,aAAa;AACpB,OAAO,iBAAiB;AACxB,OAAO,iBAAiB;AAGxB,QAAQ,OAAO,WAAW;AAC1B,QAAQ,OAAO,WAAW;AAG1B,QAAQ,SAAS;AAAA;AAAA;AAAA;AAIjB,CAAC;AAED,IAAO,wBAAQ;","names":[]}
+{"version":3,"sources":["../../src/impl/couch/pouchdb-setup.ts"],"sourcesContent":["import PouchDB from 'pouchdb';\nimport PouchDBFind from 'pouchdb-find';\nimport PouchDBAuth from '@nilock2/pouchdb-authentication';\n\n// Register plugins\nPouchDB.plugin(PouchDBFind);\nPouchDB.plugin(PouchDBAuth);\n\n// Disable PouchDB debug logging to prevent interference with CLI prompts\n// Debug logging (like DerivedLogger.emit) will still go to the TUI log file\n// if initializeTuiLogging() has been called, but won't clutter terminal output\nif (typeof PouchDB.debug !== 'undefined') {\n  PouchDB.debug.disable();\n}\n\n// Configure PouchDB globally\nPouchDB.defaults({\n  // ajax: {\n  //   timeout: 60000,\n  // },\n});\n\nexport default PouchDB;\n"],"mappings":";AAAA,OAAO,aAAa;AACpB,OAAO,iBAAiB;AACxB,OAAO,iBAAiB;AAGxB,QAAQ,OAAO,WAAW;AAC1B,QAAQ,OAAO,WAAW;AAK1B,IAAI,OAAO,QAAQ,UAAU,aAAa;AACxC,UAAQ,MAAM,QAAQ;AACxB;AAGA,QAAQ,SAAS;AAAA;AAAA;AAAA;AAIjB,CAAC;AAED,IAAO,wBAAQ;","names":[]}

package/docs/navigators-architecture.md

@@ -9,7 +9,7 @@ The navigation strategy system selects and scores cards for study sessions. It u
 
 ### WeightedCard
 
-A card with a suitability score, audit trail, and pre-fetched data:
+A card with a suitability score, audit trail, and pre-fetched metadata:
 
 ```typescript
 interface WeightedCard {
@@ -210,10 +210,6 @@ class MyGenerator extends ContentNavigator implements CardGenerator {
       }]
     }));
   }
-
-  // Legacy methods - stub or implement for backward compat
-  async getNewCards() { return []; }
-  async getPendingReviews() { return []; }
 }
 ```
 
@@ -246,10 +242,8 @@ class MyFilter extends ContentNavigator implements CardFilter {
     });
   }
 
-  // Legacy methods - filters don't generate cards
+  // Legacy method - filters don't generate cards
   async getWeightedCards() { throw new Error('Use transform() via Pipeline'); }
-  async getNewCards() { return []; }
-  async getPendingReviews() { return []; }
 }
 ```
 
@@ -364,7 +358,6 @@ return { ...card, score: card.score * multiplier };
 
 ## Related Documentation
 
-- `todo-pipeline-optimization.md` — Batch tag hydration implementation (✅ completed)
 - `todo-strategy-authoring.md` — UX and DX for authoring strategies
 - `todo-evolutionary-orchestration.md` — Long-term adaptive strategy vision
 - `devlog/1004` — Implementation details for tag hydration optimization

package/package.json

@@ -4,7 +4,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.1.20",
+  "version": "0.1.21",
   "description": "Database layer for vue-skuilder",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -48,7 +48,7 @@
   },
   "dependencies": {
     "@nilock2/pouchdb-authentication": "^1.0.2",
-    "@vue-skuilder/common": "0.1.20",
+    "@vue-skuilder/common": "0.1.21",
     "cross-fetch": "^4.1.0",
     "moment": "^2.29.4",
     "pouchdb": "^9.0.0",
@@ -62,5 +62,5 @@
     "vite": "^7.0.0",
     "vitest": "^4.0.15"
   },
-  "stableVersion": "0.1.20"
+  "stableVersion": "0.1.21"
 }

package/src/core/interfaces/classroomDB.ts

@@ -1,6 +1,4 @@
 import { ClassroomConfig } from '@vue-skuilder/common';
-import { ScheduledCard } from '../types/user';
-import { StudySessionNewItem, StudySessionReviewItem } from './contentSource';
 
 /**
  * Classroom management
@@ -29,17 +27,11 @@ export interface TeacherClassroomDBInterface extends ClassroomDBInterface {
   removeContent?(content: AssignedContent): Promise<void>;
 }
 
-export interface StudentClassroomDBInterface extends ClassroomDBInterface {
-  /**
-   * For student interfaces: get pending reviews
-   */
-  getPendingReviews?(): Promise<(StudySessionReviewItem & ScheduledCard)[]>;
-
-  /**
-   * For student interfaces: get new cards
-   */
-  getNewCards?(limit?: number): Promise<StudySessionNewItem[]>;
-}
+/**
+ * Student-facing classroom interface.
+ * Content is accessed via StudyContentSource.getWeightedCards().
+ */
+export type StudentClassroomDBInterface = ClassroomDBInterface;
 
 export type AssignedContent = AssignedCourse | AssignedTag | AssignedCard;
 

package/src/core/interfaces/contentSource.ts

@@ -1,43 +1,10 @@
 import { getDataLayer } from '@db/factory';
 import { UserDBInterface } from '..';
 import { StudentClassroomDB } from '../../impl/couch/classroomDB';
-import { ScheduledCard } from '@db/core/types/user';
 import { WeightedCard } from '../navigators';
 import { TagFilter, hasActiveFilter } from '@vue-skuilder/common';
 import { TagFilteredContentSource } from '../../study/TagFilteredContentSource';
 
-// ============================================================================
-// API MIGRATION NOTICE
-// ============================================================================
-//
-// The StudyContentSource interface is being superseded by the ContentNavigator
-// class and its getWeightedCards() API. See:
-//   packages/db/src/core/navigators/ARCHITECTURE.md
-//
-// HISTORICAL CONTEXT:
-// - This interface was designed to abstract 'classrooms' and 'courses' as
-//   content sources for study sessions.
-// - getNewCards() and getPendingReviews() were artifacts of two hard-coded
-//   navigation strategies: ELO proximity (new) and SRS scheduling (reviews).
-// - The new/review split reflected implementation details, not fundamentals.
-//
-// THE PROBLEM:
-// - "What does 'get reviews' mean for an interference mitigator?" - it doesn't.
-// - SRS is just one strategy that could express review urgency as scores.
-// - Some strategies generate candidates, others filter/score them.
-//
-// THE SOLUTION:
-// - ContentNavigator.getWeightedCards() returns unified scored candidates.
-// - WeightedCard.source field distinguishes new/review/failed (metadata, not API).
-// - Strategies compose via delegate pattern (filter wraps generator).
-//
-// MIGRATION PATH:
-// 1. ContentNavigator implements StudyContentSource for backward compat
-// 2. SessionController will migrate to call getWeightedCards()
-// 3. Legacy methods will be deprecated, then removed
-//
-// ============================================================================
-
 export type StudySessionFailedItem = StudySessionFailedNewItem | StudySessionFailedReviewItem;
 
 export interface StudySessionFailedNewItem extends StudySessionItem {
@@ -89,49 +56,22 @@ export interface ContentSourceID {
 /**
  * Interface for sources that provide study content to SessionController.
  *
- * @deprecated This interface will be superseded by ContentNavigator.getWeightedCards().
- * The getNewCards/getPendingReviews split was an artifact of hard-coded ELO and SRS
- * strategies. The new API returns unified WeightedCard[] with scores.
- *
- * MIGRATION:
- * - Implement ContentNavigator instead of StudyContentSource directly
- * - Override getWeightedCards() as the primary method
- * - Legacy methods can delegate to getWeightedCards() or be left as-is
+ * Content sources return scored candidates via getWeightedCards(), which
+ * SessionController uses to populate study queues.
  *
- * See: packages/db/src/core/navigators/ARCHITECTURE.md
+ * See: packages/db/docs/navigators-architecture.md
  */
 export interface StudyContentSource {
-  /**
-   * Get cards scheduled for review based on SRS algorithm.
-   *
-   * @deprecated Will be replaced by getWeightedCards() which returns scored candidates.
-   * Review urgency will be expressed as a score rather than a separate method.
-   */
-  getPendingReviews(): Promise<(StudySessionReviewItem & ScheduledCard)[]>;
-
-  /**
-   * Get new cards for introduction, typically ordered by ELO proximity.
-   *
-   * @deprecated Will be replaced by getWeightedCards() which returns scored candidates.
-   * New card selection and scoring will be unified with review scoring.
-   *
-   * @param n - Maximum number of new cards to return
-   */
-  getNewCards(n?: number): Promise<StudySessionNewItem[]>;
-
   /**
    * Get cards with suitability scores for presentation.
    *
-   * This is the PRIMARY API for content sources going forward. Returns unified
-   * scored candidates that can be sorted and selected by SessionController.
-   *
-   * The `source` field on WeightedCard indicates origin ('new' | 'review' | 'failed')
-   * for queue routing purposes during the migration period.
+   * Returns unified scored candidates that can be sorted and selected by SessionController.
+   * The card origin ('new' | 'review' | 'failed') is determined by provenance metadata.
    *
    * @param limit - Maximum number of cards to return
    * @returns Cards sorted by score descending
    */
-  getWeightedCards?(limit: number): Promise<WeightedCard[]>;
+  getWeightedCards(limit: number): Promise<WeightedCard[]>;
 }
 // #endregion docs_StudyContentSource
 

package/src/core/interfaces/courseDB.ts

@@ -1,5 +1,5 @@
 import { CourseConfig, CourseElo, DataShape, SkuilderCourseData } from '@vue-skuilder/common';
-import { StudySessionNewItem, StudySessionItem } from './contentSource';
+import { StudyContentSource, StudySessionItem } from './contentSource';
 import { TagStub, Tag, QualifiedCardID } from '../types/types-legacy';
 import { DataLayerResult } from '../types/db';
 import { NavigationStrategyManager } from './navigationStrategyManager';
@@ -26,7 +26,7 @@ export interface CourseInfo {
   registeredUsers: number;
 }
 
-export interface CourseDBInterface extends NavigationStrategyManager {
+export interface CourseDBInterface extends NavigationStrategyManager, StudyContentSource {
   /**
    * Get course config
    */
@@ -74,11 +74,6 @@ export interface CourseDBInterface extends NavigationStrategyManager {
    */
   updateCardElo(cardId: string, elo: CourseElo): Promise<PouchDB.Core.Response>;
 
-  /**
-   * Get new cards for study
-   */
-  getNewCards(limit?: number): Promise<StudySessionNewItem[]>;
-
   /**
    * Get cards centered at a particular ELO rating
    */

package/src/core/navigators/Pipeline.ts

@@ -1,12 +1,10 @@
 import { toCourseElo } from '@vue-skuilder/common';
 import type { CourseDBInterface } from '../interfaces/courseDB';
 import type { UserDBInterface } from '../interfaces/userDB';
-import type { ScheduledCard } from '../types/user';
 import { ContentNavigator } from './index';
 import type { WeightedCard } from './index';
 import type { CardFilter, FilterContext } from './filters/types';
 import type { CardGenerator, GeneratorContext } from './generators/types';
-import type { StudySessionNewItem, StudySessionReviewItem } from '../interfaces/contentSource';
 import { logger } from '../../util/logger';
 
 // ============================================================================
@@ -22,14 +20,11 @@ import { logger } from '../../util/logger';
  * Shows generator and filter chain structure.
  */
 function logPipelineConfig(generator: CardGenerator, filters: CardFilter[]): void {
-  const filterList = filters.length > 0
-    ? '\n    - ' + filters.map(f => f.name).join('\n    - ')
-    : ' none';
+  const filterList =
+    filters.length > 0 ? '\n    - ' + filters.map((f) => f.name).join('\n    - ') : ' none';
 
   logger.info(
-    `[Pipeline] Configuration:\n` +
-    `  Generator: ${generator.name}\n` +
-    `  Filters:${filterList}`
+    `[Pipeline] Configuration:\n` + `  Generator: ${generator.name}\n` + `  Filters:${filterList}`
   );
 }
 
@@ -39,11 +34,11 @@ function logPipelineConfig(generator: CardGenerator, filters: CardFilter[]): voi
  */
 function logTagHydration(cards: WeightedCard[], tagsByCard: Map<string, string[]>): void {
   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;
+  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`
+      `${cardsWithTags} have tags (${totalTags} total tags) - single batch query`
   );
 }
 
@@ -58,13 +53,12 @@ function logExecutionSummary(
   finalCount: number,
   topScores: number[]
 ): void {
-  const scoreDisplay = topScores.length > 0
-    ? topScores.map(s => s.toFixed(2)).join(', ')
-    : 'none';
+  const scoreDisplay =
+    topScores.length > 0 ? topScores.map((s) => s.toFixed(2)).join(', ') : 'none';
 
   logger.info(
     `[Pipeline] Execution: ${generatorName} produced ${generatedCount} → ` +
-    `${filterCount} filters → ${finalCount} results (top scores: ${scoreDisplay})`
+      `${filterCount} filters → ${finalCount} results (top scores: ${scoreDisplay})`
   );
 }
 
@@ -154,6 +148,14 @@ export class Pipeline extends ContentNavigator {
     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}`);
+      });
     // Toggle pipeline configuration logging:
     logPipelineConfig(generator, filters);
   }
@@ -210,8 +212,14 @@ export class Pipeline extends ContentNavigator {
     const result = cards.slice(0, limit);
 
     // Toggle execution summary logging:
-    const topScores = result.slice(0, 3).map(c => c.score);
-    logExecutionSummary(this.generator.name, generatedCount, this.filters.length, result.length, topScores);
+    const topScores = result.slice(0, 3).map((c) => c.score);
+    logExecutionSummary(
+      this.generator.name,
+      generatedCount,
+      this.filters.length,
+      result.length,
+      topScores
+    );
 
     // Toggle provenance logging (shows scoring history for top cards):
     logCardProvenance(result, 3);
@@ -272,43 +280,6 @@ export class Pipeline extends ContentNavigator {
     };
   }
 
-  // ===========================================================================
-  // Legacy StudyContentSource methods
-  // ===========================================================================
-  //
-  // These delegate to the generator for backward compatibility.
-  // Eventually SessionController will use getWeightedCards() exclusively.
-  //
-
-  /**
-   * Get new cards via legacy API.
-   * Delegates to the generator if it supports the legacy interface.
-   */
-  async getNewCards(n?: number): Promise<StudySessionNewItem[]> {
-    // Check if generator has legacy method (ContentNavigator-based generators do)
-    if ('getNewCards' in this.generator && typeof this.generator.getNewCards === 'function') {
-      return (this.generator as ContentNavigator).getNewCards(n);
-    }
-    // Pure CardGenerator without legacy support - return empty
-    return [];
-  }
-
-  /**
-   * Get pending reviews via legacy API.
-   * Delegates to the generator if it supports the legacy interface.
-   */
-  async getPendingReviews(): Promise<(StudySessionReviewItem & ScheduledCard)[]> {
-    // Check if generator has legacy method (ContentNavigator-based generators do)
-    if (
-      'getPendingReviews' in this.generator &&
-      typeof this.generator.getPendingReviews === 'function'
-    ) {
-      return (this.generator as ContentNavigator).getPendingReviews();
-    }
-    // Pure CardGenerator without legacy support - return empty
-    return [];
-  }
-
   /**
    * Get the course ID for this pipeline.
    */

package/src/core/navigators/PipelineAssembler.ts

@@ -7,7 +7,7 @@ import { DocType } from '../types/types-legacy';
 import { logger } from '../../util/logger';
 import type { CourseDBInterface } from '../interfaces/courseDB';
 import type { UserDBInterface } from '../interfaces/userDB';
-import CompositeGenerator from './CompositeGenerator';
+import CompositeGenerator from './generators/CompositeGenerator';
 
 // ============================================================================
 // PIPELINE ASSEMBLER

package/src/core/navigators/defaults.ts

@@ -0,0 +1,84 @@
+import { Navigators } from './index';
+import { Pipeline } from './Pipeline';
+import CompositeGenerator from './generators/CompositeGenerator';
+import ELONavigator from './generators/elo';
+import SRSNavigator from './generators/srs';
+import { createEloDistanceFilter } from './filters/eloDistance';
+import type { ContentNavigationStrategyData } from '../types/contentNavigationStrategy';
+import { DocType } from '../types/types-legacy';
+import type { CourseDBInterface, UserDBInterface } from '../interfaces';
+
+/**
+ * Default navigation pipeline configuration.
+ *
+ * This module provides factory functions for creating the canonical default
+ * navigation pipeline used by both CouchDB and static course implementations.
+ */
+
+/**
+ * Create default ELO navigation strategy data.
+ * Used when no custom strategies are configured.
+ *
+ * @param courseId - The course ID to associate with this strategy
+ * @returns Strategy data for default ELO navigation
+ */
+export function createDefaultEloStrategy(courseId: string): ContentNavigationStrategyData {
+  return {
+    _id: 'NAVIGATION_STRATEGY-ELO-default',
+    docType: DocType.NAVIGATION_STRATEGY,
+    name: 'ELO (default)',
+    description: 'Default ELO-based navigation strategy for new cards',
+    implementingClass: Navigators.ELO,
+    course: courseId,
+    serializedData: '',
+  };
+}
+
+/**
+ * Create default SRS navigation strategy data.
+ * Used when no custom strategies are configured.
+ *
+ * @param courseId - The course ID to associate with this strategy
+ * @returns Strategy data for default SRS navigation
+ */
+export function createDefaultSrsStrategy(courseId: string): ContentNavigationStrategyData {
+  return {
+    _id: 'NAVIGATION_STRATEGY-SRS-default',
+    docType: DocType.NAVIGATION_STRATEGY,
+    name: 'SRS (default)',
+    description: 'Default SRS-based navigation strategy for reviews',
+    implementingClass: Navigators.SRS,
+    course: courseId,
+    serializedData: '',
+  };
+}
+
+/**
+ * Creates the default navigation pipeline for courses with no configured strategies.
+ *
+ * Default: Pipeline(Composite(ELO, SRS), [eloDistanceFilter])
+ * - ELO generator: scores new cards by skill proximity
+ * - SRS generator: scores reviews by overdueness and interval recency
+ * - ELO distance filter: penalizes cards far from user's current level
+ *
+ * This is the canonical default configuration used when:
+ * - No navigation strategy documents exist in the course
+ * - PipelineAssembler fails to build from strategy documents
+ *
+ * @param user - User database interface for accessing user state
+ * @param course - Course database interface for accessing course data
+ * @returns Configured Pipeline ready for use
+ */
+export function createDefaultPipeline(
+  user: UserDBInterface,
+  course: CourseDBInterface
+): Pipeline {
+  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);
+}

package/src/core/navigators/{hierarchyDefinition.ts → filters/hierarchyDefinition.ts}

@@ -1,11 +1,9 @@
-import type { ScheduledCard } from '../types/user';
-import type { CourseDBInterface } from '../interfaces/courseDB';
-import type { UserDBInterface } from '../interfaces/userDB';
-import { ContentNavigator } from './index';
-import type { WeightedCard } from './index';
-import type { ContentNavigationStrategyData } from '../types/contentNavigationStrategy';
-import type { StudySessionReviewItem, StudySessionNewItem } from '..';
-import type { CardFilter, FilterContext } from './filters/types';
+import type { CourseDBInterface } from '../../interfaces/courseDB';
+import type { UserDBInterface } from '../../interfaces/userDB';
+import { ContentNavigator } from '../index';
+import type { WeightedCard } from '../index';
+import type { ContentNavigationStrategyData } from '../../types/contentNavigationStrategy';
+import type { CardFilter, FilterContext } from './types';
 import { toCourseElo } from '@vue-skuilder/common';
 
 /**
@@ -53,7 +51,6 @@ const DEFAULT_MIN_COUNT = 3;
  */
 export default class HierarchyDefinitionNavigator extends ContentNavigator implements CardFilter {
   private config: HierarchyConfig;
-  private _strategyData: ContentNavigationStrategyData;
 
   /** Human-readable name for CardFilter interface */
   name: string;
@@ -61,12 +58,11 @@ export default class HierarchyDefinitionNavigator extends ContentNavigator imple
   constructor(
     user: UserDBInterface,
     course: CourseDBInterface,
-    _strategyData: ContentNavigationStrategyData
+    strategyData: ContentNavigationStrategyData
   ) {
-    super(user, course, _strategyData);
-    this._strategyData = _strategyData;
-    this.config = this.parseConfig(_strategyData.serializedData);
-    this.name = _strategyData.name || 'Hierarchy Definition';
+    super(user, course, strategyData);
+    this.config = this.parseConfig(strategyData.serializedData);
+    this.name = strategyData.name || 'Hierarchy Definition';
   }
 
   private parseConfig(serializedData: string): HierarchyConfig {
@@ -159,7 +155,7 @@ export default class HierarchyDefinitionNavigator extends ContentNavigator imple
    */
   private async checkCardUnlock(
     card: WeightedCard,
-    course: CourseDBInterface,
+    _course: CourseDBInterface,
     unlockedTags: Set<string>,
     masteredTags: Set<string>
   ): Promise<{ isUnlocked: boolean; reason: string }> {
@@ -253,14 +249,4 @@ export default class HierarchyDefinitionNavigator extends ContentNavigator imple
         'Use Pipeline with a generator and this filter via transform().'
     );
   }
-
-  // Legacy methods - stub implementations since filters don't generate cards
-
-  async getNewCards(_n?: number): Promise<StudySessionNewItem[]> {
-    return [];
-  }
-
-  async getPendingReviews(): Promise<(StudySessionReviewItem & ScheduledCard)[]> {
-    return [];
-  }
 }

package/src/core/navigators/{interferenceMitigator.ts → filters/interferenceMitigator.ts}

@@ -1,11 +1,9 @@
-import type { ScheduledCard } from '../types/user';
-import type { CourseDBInterface } from '../interfaces/courseDB';
-import type { UserDBInterface } from '../interfaces/userDB';
-import { ContentNavigator } from './index';
-import type { WeightedCard } from './index';
-import type { ContentNavigationStrategyData } from '../types/contentNavigationStrategy';
-import type { StudySessionReviewItem, StudySessionNewItem } from '..';
-import type { CardFilter, FilterContext } from './filters/types';
+import type { CourseDBInterface } from '../../interfaces/courseDB';
+import type { UserDBInterface } from '../../interfaces/userDB';
+import { ContentNavigator } from '../index';
+import type { WeightedCard } from '../index';
+import type { ContentNavigationStrategyData } from '../../types/contentNavigationStrategy';
+import type { CardFilter, FilterContext } from './types';
 import { toCourseElo } from '@vue-skuilder/common';
 
 /**
@@ -80,7 +78,6 @@ const DEFAULT_INTERFERENCE_DECAY = 0.8;
  */
 export default class InterferenceMitigatorNavigator extends ContentNavigator implements CardFilter {
   private config: InterferenceConfig;
-  private _strategyData: ContentNavigationStrategyData;
 
   /** Human-readable name for CardFilter interface */
   name: string;
@@ -91,13 +88,12 @@ export default class InterferenceMitigatorNavigator extends ContentNavigator imp
   constructor(
     user: UserDBInterface,
     course: CourseDBInterface,
-    _strategyData: ContentNavigationStrategyData
+    strategyData: ContentNavigationStrategyData
   ) {
-    super(user, course, _strategyData);
-    this._strategyData = _strategyData;
-    this.config = this.parseConfig(_strategyData.serializedData);
+    super(user, course, strategyData);
+    this.config = this.parseConfig(strategyData.serializedData);
     this.interferenceMap = this.buildInterferenceMap();
-    this.name = _strategyData.name || 'Interference Mitigator';
+    this.name = strategyData.name || 'Interference Mitigator';
   }
 
   private parseConfig(serializedData: string): InterferenceConfig {
@@ -342,14 +338,4 @@ export default class InterferenceMitigatorNavigator extends ContentNavigator imp
         'Use Pipeline with a generator and this filter via transform().'
     );
   }
-
-  // Legacy methods - stub implementations since filters don't generate cards
-
-  async getNewCards(_n?: number): Promise<StudySessionNewItem[]> {
-    return [];
-  }
-
-  async getPendingReviews(): Promise<(StudySessionReviewItem & ScheduledCard)[]> {
-    return [];
-  }
 }