@vue-skuilder/db 0.1.31-b → 0.1.31

package/dist/{contentSource-ygoFw9oV.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
      */
@@ -908,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",
@@ -1038,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;
@@ -1096,6 +1107,11 @@ 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>;
 

package/dist/{contentSource-B7nXusjk.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
      */
@@ -908,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",
@@ -1038,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;
@@ -1096,6 +1107,11 @@ 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>;
 

package/dist/core/index.d.cts

@@ -1,6 +1,6 @@
-import { a2 as LearnableWeight, L as UserOutcomeRecord, a3 as OrchestrationContext, W as WeightedCard, U as UserDBInterface, C as CourseDBInterface, X as StrategyContribution } from '../contentSource-B7nXusjk.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-B7nXusjk.cjs';
-export { D as DataLayerProvider } from '../dataLayerProvider-BW7HvkMt.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;
     }>;
 }
@@ -477,6 +499,15 @@ declare const pipelineDebugAPI: {
      * 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 { a2 as LearnableWeight, L as UserOutcomeRecord, a3 as OrchestrationContext, W as WeightedCard, U as UserDBInterface, C as CourseDBInterface, X as StrategyContribution } from '../contentSource-ygoFw9oV.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-ygoFw9oV.js';
-export { D as DataLayerProvider } from '../dataLayerProvider-BfXUVDuG.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;
     }>;
 }
@@ -477,6 +499,15 @@ declare const pipelineDebugAPI: {
      * 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.
      */