@vue-skuilder/db 0.1.31-a → 0.1.31

package/dist/{contentSource-BmnmvH8C.d.ts → contentSource-Bdwkvqa8.d.ts}

@@ -240,6 +240,11 @@ interface CourseDBInterface extends NavigationStrategyManager, StudyContentSourc
      * @returns Map from cardId to array of tag names
      */
     getAppliedTagsBatch(cardIds: string[]): Promise<Map<string, string[]>>;
+    /**
+     * Get all card IDs in the course.
+     * Used by diagnostics to scan the full card space.
+     */
+    getAllCardIds(): Promise<string[]>;
     /**
      * Add a tag to a card
      */
@@ -742,10 +747,15 @@ type NavigatorConstructor = new (user: UserDBInterface, course: CourseDBInterfac
  * Call this to make a navigator available for instantiation by
  * ContentNavigator.create() without relying on dynamic imports.
  *
- * @param implementingClass - The class name (e.g., 'elo', 'hierarchyDefinition')
+ * Passing a `role` is optional for built-in navigators (whose roles are in
+ * the hardcoded `NavigatorRoles` record), but **required** for consumer-
+ * defined navigators that need to participate in pipeline assembly.
+ *
+ * @param implementingClass - The class name (e.g., 'elo', 'letterGatingFilter')
  * @param constructor - The navigator class constructor
+ * @param role - Optional pipeline role (GENERATOR or FILTER)
  */
-declare function registerNavigator(implementingClass: string, constructor: NavigatorConstructor): void;
+declare function registerNavigator(implementingClass: string, constructor: NavigatorConstructor, role?: NavigatorRole): void;
 /**
  * Get a navigator constructor from the registry.
  *
@@ -760,6 +770,13 @@ declare function getRegisteredNavigator(implementingClass: string): NavigatorCon
  * @returns true if registered, false otherwise
  */
 declare function hasRegisteredNavigator(implementingClass: string): boolean;
+/**
+ * Get the registered role for a navigator, if one was provided at registration.
+ *
+ * @param implementingClass - The class name to look up
+ * @returns The role, or undefined if not registered or no role was specified
+ */
+declare function getRegisteredNavigatorRole(implementingClass: string): NavigatorRole | undefined;
 /**
  * Get all registered navigator names.
  * Useful for debugging and testing.
@@ -896,6 +913,7 @@ declare function getCardOrigin(card: WeightedCard): 'new' | 'review' | 'failed';
 declare enum Navigators {
     ELO = "elo",
     SRS = "srs",
+    PRESCRIBED = "prescribed",
     HIERARCHY = "hierarchyDefinition",
     INTERFERENCE = "interferenceMitigator",
     RELATIVE_PRIORITY = "relativePriority",
@@ -925,7 +943,10 @@ declare function isGenerator(impl: string): boolean;
 /**
  * Check if a navigator implementation is a filter.
  *
- * @param impl - Navigator implementation name (e.g., 'elo', 'hierarchyDefinition')
+ * Checks the built-in NavigatorRoles enum first, then falls back to the
+ * navigator registry for consumer-registered navigators.
+ *
+ * @param impl - Navigator implementation name (e.g., 'elo', 'letterGatingFilter')
  * @returns true if the navigator is a filter, false otherwise
  */
 declare function isFilter(impl: string): boolean;
@@ -1023,6 +1044,11 @@ declare abstract class ContentNavigator implements StudyContentSource {
      * @returns Cards sorted by score descending, with provenance trails
      */
     getWeightedCards(_limit: number): Promise<WeightedCard[]>;
+    /**
+     * Set ephemeral hints for the next pipeline run.
+     * No-op for non-Pipeline navigators. Pipeline overrides this.
+     */
+    setEphemeralHints(_hints: Record<string, unknown>): void;
 }
 
 type StudySessionFailedItem = StudySessionFailedNewItem | StudySessionFailedReviewItem;
@@ -1081,7 +1107,12 @@ interface StudyContentSource {
      * Used for recording learning outcomes.
      */
     getOrchestrationContext?(): Promise<OrchestrationContext>;
+    /**
+     * Set ephemeral hints for the next pipeline run.
+     * No-op for sources that don't support hints.
+     */
+    setEphemeralHints?(hints: Record<string, unknown>): void;
 }
 declare function getStudySource(source: ContentSourceID, user: UserDBInterface): Promise<StudyContentSource>;
 
-export { isGenerator as $, type AdminDBInterface as A, type UsrCrsDataInterface as B, type CourseDBInterface as C, type DataLayerResult as D, type ClassroomRegistrationDesignation as E, type ClassroomRegistration as F, type ClassroomRegistrationDoc as G, type SessionTrackingData as H, type UserConfig as I, type ActivityRecord as J, type CourseRegistration as K, type UserOutcomeRecord as L, registerNavigator as M, type NavigatorConstructor as N, getRegisteredNavigator as O, hasRegisteredNavigator as P, getRegisteredNavigatorNames as Q, initializeNavigatorRegistry as R, type StudySessionItem as S, type TeacherClassroomDBInterface as T, type UserDBInterface as U, type StrategyContribution as V, type WeightedCard as W, getCardOrigin as X, Navigators as Y, NavigatorRole as Z, NavigatorRoles as _, type UserDBReader as a, isFilter as a0, type LearnableWeight as a1, type OrchestrationContext as a2, computeDeviation as a3, computeSpread as a4, computeEffectiveWeight as a5, createOrchestrationContext as a6, type DocumentUpdater as a7, newInterval as a8, type CoursesDBInterface as b, type ClassroomDBInterface as c, type CourseInfo as d, type ContentNavigationStrategyData as e, ContentNavigator as f, type AssignedContent as g, type StudyContentSource as h, type StudentClassroomDBInterface as i, type ScheduledCard as j, type StudySessionFailedItem as k, type StudySessionFailedNewItem as l, type StudySessionFailedReviewItem as m, type StudySessionNewItem as n, type StudySessionReviewItem as o, isReview as p, type ContentSourceID as q, getStudySource as r, type CourseRegistrationDoc as s, type AssignedTag as t, type AssignedCourse as u, type AssignedCard as v, type UserDBWriter as w, type UserDBAuthenticator as x, type UserCourseSettings as y, type UserCourseSetting as z };
+export { NavigatorRoles as $, type AdminDBInterface as A, type UsrCrsDataInterface as B, type CourseDBInterface as C, type DataLayerResult as D, type ClassroomRegistrationDesignation as E, type ClassroomRegistration as F, type ClassroomRegistrationDoc as G, type SessionTrackingData as H, type UserConfig as I, type ActivityRecord as J, type CourseRegistration as K, type UserOutcomeRecord as L, registerNavigator as M, type NavigatorConstructor as N, getRegisteredNavigator as O, hasRegisteredNavigator as P, getRegisteredNavigatorRole as Q, getRegisteredNavigatorNames as R, type StudySessionItem as S, type TeacherClassroomDBInterface as T, type UserDBInterface as U, initializeNavigatorRegistry as V, type WeightedCard as W, type StrategyContribution as X, getCardOrigin as Y, Navigators as Z, NavigatorRole as _, type UserDBReader as a, isGenerator as a0, isFilter as a1, type LearnableWeight as a2, type OrchestrationContext as a3, computeDeviation as a4, computeSpread as a5, computeEffectiveWeight as a6, createOrchestrationContext as a7, type DocumentUpdater as a8, newInterval as a9, type CoursesDBInterface as b, type ClassroomDBInterface as c, type CourseInfo as d, type ContentNavigationStrategyData as e, ContentNavigator as f, type AssignedContent as g, type StudyContentSource as h, type StudentClassroomDBInterface as i, type ScheduledCard as j, type StudySessionFailedItem as k, type StudySessionFailedNewItem as l, type StudySessionFailedReviewItem as m, type StudySessionNewItem as n, type StudySessionReviewItem as o, isReview as p, type ContentSourceID as q, getStudySource as r, type CourseRegistrationDoc as s, type AssignedTag as t, type AssignedCourse as u, type AssignedCard as v, type UserDBWriter as w, type UserDBAuthenticator as x, type UserCourseSettings as y, type UserCourseSetting as z };

package/dist/{contentSource-DfBbaLA-.d.cts → contentSource-DF1nUbPQ.d.cts}

@@ -240,6 +240,11 @@ interface CourseDBInterface extends NavigationStrategyManager, StudyContentSourc
      * @returns Map from cardId to array of tag names
      */
     getAppliedTagsBatch(cardIds: string[]): Promise<Map<string, string[]>>;
+    /**
+     * Get all card IDs in the course.
+     * Used by diagnostics to scan the full card space.
+     */
+    getAllCardIds(): Promise<string[]>;
     /**
      * Add a tag to a card
      */
@@ -742,10 +747,15 @@ type NavigatorConstructor = new (user: UserDBInterface, course: CourseDBInterfac
  * Call this to make a navigator available for instantiation by
  * ContentNavigator.create() without relying on dynamic imports.
  *
- * @param implementingClass - The class name (e.g., 'elo', 'hierarchyDefinition')
+ * Passing a `role` is optional for built-in navigators (whose roles are in
+ * the hardcoded `NavigatorRoles` record), but **required** for consumer-
+ * defined navigators that need to participate in pipeline assembly.
+ *
+ * @param implementingClass - The class name (e.g., 'elo', 'letterGatingFilter')
  * @param constructor - The navigator class constructor
+ * @param role - Optional pipeline role (GENERATOR or FILTER)
  */
-declare function registerNavigator(implementingClass: string, constructor: NavigatorConstructor): void;
+declare function registerNavigator(implementingClass: string, constructor: NavigatorConstructor, role?: NavigatorRole): void;
 /**
  * Get a navigator constructor from the registry.
  *
@@ -760,6 +770,13 @@ declare function getRegisteredNavigator(implementingClass: string): NavigatorCon
  * @returns true if registered, false otherwise
  */
 declare function hasRegisteredNavigator(implementingClass: string): boolean;
+/**
+ * Get the registered role for a navigator, if one was provided at registration.
+ *
+ * @param implementingClass - The class name to look up
+ * @returns The role, or undefined if not registered or no role was specified
+ */
+declare function getRegisteredNavigatorRole(implementingClass: string): NavigatorRole | undefined;
 /**
  * Get all registered navigator names.
  * Useful for debugging and testing.
@@ -896,6 +913,7 @@ declare function getCardOrigin(card: WeightedCard): 'new' | 'review' | 'failed';
 declare enum Navigators {
     ELO = "elo",
     SRS = "srs",
+    PRESCRIBED = "prescribed",
     HIERARCHY = "hierarchyDefinition",
     INTERFERENCE = "interferenceMitigator",
     RELATIVE_PRIORITY = "relativePriority",
@@ -925,7 +943,10 @@ declare function isGenerator(impl: string): boolean;
 /**
  * Check if a navigator implementation is a filter.
  *
- * @param impl - Navigator implementation name (e.g., 'elo', 'hierarchyDefinition')
+ * Checks the built-in NavigatorRoles enum first, then falls back to the
+ * navigator registry for consumer-registered navigators.
+ *
+ * @param impl - Navigator implementation name (e.g., 'elo', 'letterGatingFilter')
  * @returns true if the navigator is a filter, false otherwise
  */
 declare function isFilter(impl: string): boolean;
@@ -1023,6 +1044,11 @@ declare abstract class ContentNavigator implements StudyContentSource {
      * @returns Cards sorted by score descending, with provenance trails
      */
     getWeightedCards(_limit: number): Promise<WeightedCard[]>;
+    /**
+     * Set ephemeral hints for the next pipeline run.
+     * No-op for non-Pipeline navigators. Pipeline overrides this.
+     */
+    setEphemeralHints(_hints: Record<string, unknown>): void;
 }
 
 type StudySessionFailedItem = StudySessionFailedNewItem | StudySessionFailedReviewItem;
@@ -1081,7 +1107,12 @@ interface StudyContentSource {
      * Used for recording learning outcomes.
      */
     getOrchestrationContext?(): Promise<OrchestrationContext>;
+    /**
+     * Set ephemeral hints for the next pipeline run.
+     * No-op for sources that don't support hints.
+     */
+    setEphemeralHints?(hints: Record<string, unknown>): void;
 }
 declare function getStudySource(source: ContentSourceID, user: UserDBInterface): Promise<StudyContentSource>;
 
-export { isGenerator as $, type AdminDBInterface as A, type UsrCrsDataInterface as B, type CourseDBInterface as C, type DataLayerResult as D, type ClassroomRegistrationDesignation as E, type ClassroomRegistration as F, type ClassroomRegistrationDoc as G, type SessionTrackingData as H, type UserConfig as I, type ActivityRecord as J, type CourseRegistration as K, type UserOutcomeRecord as L, registerNavigator as M, type NavigatorConstructor as N, getRegisteredNavigator as O, hasRegisteredNavigator as P, getRegisteredNavigatorNames as Q, initializeNavigatorRegistry as R, type StudySessionItem as S, type TeacherClassroomDBInterface as T, type UserDBInterface as U, type StrategyContribution as V, type WeightedCard as W, getCardOrigin as X, Navigators as Y, NavigatorRole as Z, NavigatorRoles as _, type UserDBReader as a, isFilter as a0, type LearnableWeight as a1, type OrchestrationContext as a2, computeDeviation as a3, computeSpread as a4, computeEffectiveWeight as a5, createOrchestrationContext as a6, type DocumentUpdater as a7, newInterval as a8, type CoursesDBInterface as b, type ClassroomDBInterface as c, type CourseInfo as d, type ContentNavigationStrategyData as e, ContentNavigator as f, type AssignedContent as g, type StudyContentSource as h, type StudentClassroomDBInterface as i, type ScheduledCard as j, type StudySessionFailedItem as k, type StudySessionFailedNewItem as l, type StudySessionFailedReviewItem as m, type StudySessionNewItem as n, type StudySessionReviewItem as o, isReview as p, type ContentSourceID as q, getStudySource as r, type CourseRegistrationDoc as s, type AssignedTag as t, type AssignedCourse as u, type AssignedCard as v, type UserDBWriter as w, type UserDBAuthenticator as x, type UserCourseSettings as y, type UserCourseSetting as z };
+export { NavigatorRoles as $, type AdminDBInterface as A, type UsrCrsDataInterface as B, type CourseDBInterface as C, type DataLayerResult as D, type ClassroomRegistrationDesignation as E, type ClassroomRegistration as F, type ClassroomRegistrationDoc as G, type SessionTrackingData as H, type UserConfig as I, type ActivityRecord as J, type CourseRegistration as K, type UserOutcomeRecord as L, registerNavigator as M, type NavigatorConstructor as N, getRegisteredNavigator as O, hasRegisteredNavigator as P, getRegisteredNavigatorRole as Q, getRegisteredNavigatorNames as R, type StudySessionItem as S, type TeacherClassroomDBInterface as T, type UserDBInterface as U, initializeNavigatorRegistry as V, type WeightedCard as W, type StrategyContribution as X, getCardOrigin as Y, Navigators as Z, NavigatorRole as _, type UserDBReader as a, isGenerator as a0, isFilter as a1, type LearnableWeight as a2, type OrchestrationContext as a3, computeDeviation as a4, computeSpread as a5, computeEffectiveWeight as a6, createOrchestrationContext as a7, type DocumentUpdater as a8, newInterval as a9, type CoursesDBInterface as b, type ClassroomDBInterface as c, type CourseInfo as d, type ContentNavigationStrategyData as e, ContentNavigator as f, type AssignedContent as g, type StudyContentSource as h, type StudentClassroomDBInterface as i, type ScheduledCard as j, type StudySessionFailedItem as k, type StudySessionFailedNewItem as l, type StudySessionFailedReviewItem as m, type StudySessionNewItem as n, type StudySessionReviewItem as o, isReview as p, type ContentSourceID as q, getStudySource as r, type CourseRegistrationDoc as s, type AssignedTag as t, type AssignedCourse as u, type AssignedCard as v, type UserDBWriter as w, type UserDBAuthenticator as x, type UserCourseSettings as y, type UserCourseSetting as z };

package/dist/core/index.d.cts

@@ -1,6 +1,6 @@
-import { a1 as LearnableWeight, L as UserOutcomeRecord, a2 as OrchestrationContext, W as WeightedCard, U as UserDBInterface, C as CourseDBInterface, V as StrategyContribution } from '../contentSource-DfBbaLA-.cjs';
-export { J as ActivityRecord, A as AdminDBInterface, v as AssignedCard, g as AssignedContent, u as AssignedCourse, t as AssignedTag, c as ClassroomDBInterface, F as ClassroomRegistration, E as ClassroomRegistrationDesignation, G as ClassroomRegistrationDoc, e as ContentNavigationStrategyData, f as ContentNavigator, q as ContentSourceID, d as CourseInfo, K as CourseRegistration, s as CourseRegistrationDoc, b as CoursesDBInterface, N as NavigatorConstructor, Z as NavigatorRole, _ as NavigatorRoles, Y as Navigators, j as ScheduledCard, H as SessionTrackingData, i as StudentClassroomDBInterface, h as StudyContentSource, k as StudySessionFailedItem, l as StudySessionFailedNewItem, m as StudySessionFailedReviewItem, S as StudySessionItem, n as StudySessionNewItem, o as StudySessionReviewItem, T as TeacherClassroomDBInterface, I as UserConfig, z as UserCourseSetting, y as UserCourseSettings, x as UserDBAuthenticator, a as UserDBReader, w as UserDBWriter, B as UsrCrsDataInterface, a3 as computeDeviation, a5 as computeEffectiveWeight, a4 as computeSpread, a6 as createOrchestrationContext, X as getCardOrigin, O as getRegisteredNavigator, Q as getRegisteredNavigatorNames, r as getStudySource, P as hasRegisteredNavigator, R as initializeNavigatorRegistry, a0 as isFilter, $ as isGenerator, p as isReview, M as registerNavigator } from '../contentSource-DfBbaLA-.cjs';
-export { D as DataLayerProvider } from '../dataLayerProvider-BeRXVMs5.cjs';
+import { a2 as LearnableWeight, L as UserOutcomeRecord, a3 as OrchestrationContext, W as WeightedCard, U as UserDBInterface, C as CourseDBInterface, X as StrategyContribution } from '../contentSource-DF1nUbPQ.cjs';
+export { J as ActivityRecord, A as AdminDBInterface, v as AssignedCard, g as AssignedContent, u as AssignedCourse, t as AssignedTag, c as ClassroomDBInterface, F as ClassroomRegistration, E as ClassroomRegistrationDesignation, G as ClassroomRegistrationDoc, e as ContentNavigationStrategyData, f as ContentNavigator, q as ContentSourceID, d as CourseInfo, K as CourseRegistration, s as CourseRegistrationDoc, b as CoursesDBInterface, N as NavigatorConstructor, _ as NavigatorRole, $ as NavigatorRoles, Z as Navigators, j as ScheduledCard, H as SessionTrackingData, i as StudentClassroomDBInterface, h as StudyContentSource, k as StudySessionFailedItem, l as StudySessionFailedNewItem, m as StudySessionFailedReviewItem, S as StudySessionItem, n as StudySessionNewItem, o as StudySessionReviewItem, T as TeacherClassroomDBInterface, I as UserConfig, z as UserCourseSetting, y as UserCourseSettings, x as UserDBAuthenticator, a as UserDBReader, w as UserDBWriter, B as UsrCrsDataInterface, a4 as computeDeviation, a6 as computeEffectiveWeight, a5 as computeSpread, a7 as createOrchestrationContext, Y as getCardOrigin, O as getRegisteredNavigator, R as getRegisteredNavigatorNames, Q as getRegisteredNavigatorRole, r as getStudySource, P as hasRegisteredNavigator, V as initializeNavigatorRegistry, a1 as isFilter, a0 as isGenerator, p as isReview, M as registerNavigator } from '../contentSource-DF1nUbPQ.cjs';
+export { D as DataLayerProvider } from '../dataLayerProvider-BQdfJuBN.cjs';
 import { D as DocType, i as QuestionRecord, b as DocTypePrefixes, C as CardHistory, c as CardRecord } from '../types-legacy-JXDxinpU.cjs';
 export { d as CardData, e as CourseListData, g as DataShapeData, f as DisplayableData, F as Field, G as GuestUsername, Q as QualifiedCardID, h as QuestionData, S as SkuilderCourseData, a as Tag, T as TagStub, l as log } from '../types-legacy-JXDxinpU.cjs';
 import { DataShape, ParsedCard } from '@vue-skuilder/common';
@@ -383,6 +383,27 @@ interface CardGenerator {
  */
 type CardGeneratorFactory<TConfig = unknown> = (config: TConfig) => CardGenerator;
 
+/**
+ * Diagnosis of the full card space for the current user.
+ */
+interface CardSpaceDiagnosis {
+    totalCards: number;
+    threshold: number;
+    wellIndicated: number;
+    encountered: number;
+    wellIndicatedNew: number;
+    byType: Record<string, {
+        total: number;
+        wellIndicated: number;
+        new: number;
+    }>;
+    filterBreakdown: Array<{
+        name: string;
+        wellIndicated: number;
+    }>;
+    elapsedMs: number;
+}
+
 /**
  * Summary of a single generator's contribution.
  */
@@ -424,6 +445,7 @@ interface PipelineRunReport {
         origin: 'new' | 'review' | 'unknown';
         finalScore: number;
         provenance: StrategyContribution[];
+        tags?: string[];
         selected: boolean;
     }>;
 }
@@ -463,6 +485,29 @@ declare const pipelineDebugAPI: {
      * Clear run history.
      */
     clear(): void;
+    /**
+     * Show the navigator registry: all registered classes and their roles.
+     *
+     * Useful for verifying that consumer-defined navigators were registered
+     * before pipeline assembly.
+     */
+    showRegistry(): void;
+    /**
+     * Show strategy documents from the last pipeline run and how they mapped
+     * to the registry.
+     *
+     * If no runs are captured yet, falls back to showing just the registry.
+     */
+    showStrategies(): void;
+    /**
+     * Scan the full card space through the filter chain for the current user.
+     *
+     * Reports how many cards are well-indicated and how many are new.
+     * Use this to understand how the search space grows during onboarding.
+     *
+     * @param threshold - Score threshold for "well indicated" (default 0.10)
+     */
+    diagnoseCardSpace(threshold?: number): Promise<CardSpaceDiagnosis | null>;
     /**
      * Show help.
      */

package/dist/core/index.d.ts

@@ -1,6 +1,6 @@
-import { a1 as LearnableWeight, L as UserOutcomeRecord, a2 as OrchestrationContext, W as WeightedCard, U as UserDBInterface, C as CourseDBInterface, V as StrategyContribution } from '../contentSource-BmnmvH8C.js';
-export { J as ActivityRecord, A as AdminDBInterface, v as AssignedCard, g as AssignedContent, u as AssignedCourse, t as AssignedTag, c as ClassroomDBInterface, F as ClassroomRegistration, E as ClassroomRegistrationDesignation, G as ClassroomRegistrationDoc, e as ContentNavigationStrategyData, f as ContentNavigator, q as ContentSourceID, d as CourseInfo, K as CourseRegistration, s as CourseRegistrationDoc, b as CoursesDBInterface, N as NavigatorConstructor, Z as NavigatorRole, _ as NavigatorRoles, Y as Navigators, j as ScheduledCard, H as SessionTrackingData, i as StudentClassroomDBInterface, h as StudyContentSource, k as StudySessionFailedItem, l as StudySessionFailedNewItem, m as StudySessionFailedReviewItem, S as StudySessionItem, n as StudySessionNewItem, o as StudySessionReviewItem, T as TeacherClassroomDBInterface, I as UserConfig, z as UserCourseSetting, y as UserCourseSettings, x as UserDBAuthenticator, a as UserDBReader, w as UserDBWriter, B as UsrCrsDataInterface, a3 as computeDeviation, a5 as computeEffectiveWeight, a4 as computeSpread, a6 as createOrchestrationContext, X as getCardOrigin, O as getRegisteredNavigator, Q as getRegisteredNavigatorNames, r as getStudySource, P as hasRegisteredNavigator, R as initializeNavigatorRegistry, a0 as isFilter, $ as isGenerator, p as isReview, M as registerNavigator } from '../contentSource-BmnmvH8C.js';
-export { D as DataLayerProvider } from '../dataLayerProvider-CG9GfaAY.js';
+import { a2 as LearnableWeight, L as UserOutcomeRecord, a3 as OrchestrationContext, W as WeightedCard, U as UserDBInterface, C as CourseDBInterface, X as StrategyContribution } from '../contentSource-Bdwkvqa8.js';
+export { J as ActivityRecord, A as AdminDBInterface, v as AssignedCard, g as AssignedContent, u as AssignedCourse, t as AssignedTag, c as ClassroomDBInterface, F as ClassroomRegistration, E as ClassroomRegistrationDesignation, G as ClassroomRegistrationDoc, e as ContentNavigationStrategyData, f as ContentNavigator, q as ContentSourceID, d as CourseInfo, K as CourseRegistration, s as CourseRegistrationDoc, b as CoursesDBInterface, N as NavigatorConstructor, _ as NavigatorRole, $ as NavigatorRoles, Z as Navigators, j as ScheduledCard, H as SessionTrackingData, i as StudentClassroomDBInterface, h as StudyContentSource, k as StudySessionFailedItem, l as StudySessionFailedNewItem, m as StudySessionFailedReviewItem, S as StudySessionItem, n as StudySessionNewItem, o as StudySessionReviewItem, T as TeacherClassroomDBInterface, I as UserConfig, z as UserCourseSetting, y as UserCourseSettings, x as UserDBAuthenticator, a as UserDBReader, w as UserDBWriter, B as UsrCrsDataInterface, a4 as computeDeviation, a6 as computeEffectiveWeight, a5 as computeSpread, a7 as createOrchestrationContext, Y as getCardOrigin, O as getRegisteredNavigator, R as getRegisteredNavigatorNames, Q as getRegisteredNavigatorRole, r as getStudySource, P as hasRegisteredNavigator, V as initializeNavigatorRegistry, a1 as isFilter, a0 as isGenerator, p as isReview, M as registerNavigator } from '../contentSource-Bdwkvqa8.js';
+export { D as DataLayerProvider } from '../dataLayerProvider-BKmVoyJR.js';
 import { D as DocType, i as QuestionRecord, b as DocTypePrefixes, C as CardHistory, c as CardRecord } from '../types-legacy-JXDxinpU.js';
 export { d as CardData, e as CourseListData, g as DataShapeData, f as DisplayableData, F as Field, G as GuestUsername, Q as QualifiedCardID, h as QuestionData, S as SkuilderCourseData, a as Tag, T as TagStub, l as log } from '../types-legacy-JXDxinpU.js';
 import { DataShape, ParsedCard } from '@vue-skuilder/common';
@@ -383,6 +383,27 @@ interface CardGenerator {
  */
 type CardGeneratorFactory<TConfig = unknown> = (config: TConfig) => CardGenerator;
 
+/**
+ * Diagnosis of the full card space for the current user.
+ */
+interface CardSpaceDiagnosis {
+    totalCards: number;
+    threshold: number;
+    wellIndicated: number;
+    encountered: number;
+    wellIndicatedNew: number;
+    byType: Record<string, {
+        total: number;
+        wellIndicated: number;
+        new: number;
+    }>;
+    filterBreakdown: Array<{
+        name: string;
+        wellIndicated: number;
+    }>;
+    elapsedMs: number;
+}
+
 /**
  * Summary of a single generator's contribution.
  */
@@ -424,6 +445,7 @@ interface PipelineRunReport {
         origin: 'new' | 'review' | 'unknown';
         finalScore: number;
         provenance: StrategyContribution[];
+        tags?: string[];
         selected: boolean;
     }>;
 }
@@ -463,6 +485,29 @@ declare const pipelineDebugAPI: {
      * Clear run history.
      */
     clear(): void;
+    /**
+     * Show the navigator registry: all registered classes and their roles.
+     *
+     * Useful for verifying that consumer-defined navigators were registered
+     * before pipeline assembly.
+     */
+    showRegistry(): void;
+    /**
+     * Show strategy documents from the last pipeline run and how they mapped
+     * to the registry.
+     *
+     * If no runs are captured yet, falls back to showing just the registry.
+     */
+    showStrategies(): void;
+    /**
+     * Scan the full card space through the filter chain for the current user.
+     *
+     * Reports how many cards are well-indicated and how many are new.
+     * Use this to understand how the search space grows during onboarding.
+     *
+     * @param threshold - Score threshold for "well indicated" (default 0.10)
+     */
+    diagnoseCardSpace(threshold?: number): Promise<CardSpaceDiagnosis | null>;
     /**
      * Show help.
      */