@vue-skuilder/db 0.1.32-c → 0.1.32-e

package/dist/core/index.d.cts

@@ -1,10 +1,17 @@
-import { a6 as LearnableWeight, N as UserOutcomeRecord, a7 as OrchestrationContext, W as WeightedCard, U as UserDBInterface, C as CourseDBInterface, $ as StrategyContribution } from '../dataLayerProvider-BJqBlMIl.cjs';
-export { K as ActivityRecord, A as AdminDBInterface, w as AssignedCard, h as AssignedContent, v as AssignedCourse, u as AssignedTag, b as ClassroomDBInterface, G as ClassroomRegistration, F as ClassroomRegistrationDesignation, H as ClassroomRegistrationDoc, f as ContentNavigationStrategyData, g as ContentNavigator, r as ContentSourceID, d as CourseInfo, L as CourseRegistration, M as CourseRegistrationDoc, a as CoursesDBInterface, D as DataLayerProvider, O as Loggable, P as NavigatorConstructor, a2 as NavigatorRole, a3 as NavigatorRoles, a1 as Navigators, k as ScheduledCard, I as SessionTrackingData, j as StudentClassroomDBInterface, i as StudyContentSource, l as StudySessionFailedItem, m as StudySessionFailedNewItem, n as StudySessionFailedReviewItem, S as StudySessionItem, o as StudySessionNewItem, p as StudySessionReviewItem, T as TeacherClassroomDBInterface, J as UserConfig, B as UserCourseSetting, z as UserCourseSettings, y as UserDBAuthenticator, c as UserDBReader, x as UserDBWriter, E as UsrCrsDataInterface, a8 as computeDeviation, aa as computeEffectiveWeight, a9 as computeSpread, ab as createOrchestrationContext, a0 as getCardOrigin, V as getRegisteredNavigator, Z as getRegisteredNavigatorNames, Y as getRegisteredNavigatorRole, s as getStudySource, X as hasRegisteredNavigator, _ as initializeNavigatorRegistry, a5 as isFilter, a4 as isGenerator, q as isReview, Q as registerNavigator } from '../dataLayerProvider-BJqBlMIl.cjs';
-import { D as DocType, i as QuestionRecord, f as DocTypePrefixes, g as CardHistory, h as CardRecord } from '../types-legacy-C7r0T4OV.cjs';
-export { C as CardData, b as CourseListData, d as DataShapeData, c as DisplayableData, F as Field, G as GuestUsername, Q as QualifiedCardID, e as QuestionData, S as SkuilderCourseData, a as Tag, T as TagStub, l as log } from '../types-legacy-C7r0T4OV.cjs';
+import { a7 as LearnableWeight, M as UserOutcomeRecord, a8 as OrchestrationContext, W as WeightedCard, U as UserDBInterface, C as CourseDBInterface, Z as StrategyContribution } from '../contentSource-BMlMwSiG.cjs';
+export { K as ActivityRecord, A as AdminDBInterface, v as AssignedCard, g as AssignedContent, u as AssignedCourse, t as AssignedTag, a4 as CardGenerator, a6 as CardGeneratorFactory, c as ClassroomDBInterface, F as ClassroomRegistration, E as ClassroomRegistrationDesignation, H as ClassroomRegistrationDoc, e as ContentNavigationStrategyData, f as ContentNavigator, q as ContentSourceID, d as CourseInfo, L as CourseRegistration, s as CourseRegistrationDoc, b as CoursesDBInterface, a5 as GeneratorContext, G as GeneratorResult, N as NavigatorConstructor, a0 as NavigatorRole, a1 as NavigatorRoles, $ as Navigators, R as ReplanHints, j as ScheduledCard, I 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, J as UserConfig, z as UserCourseSetting, y as UserCourseSettings, x as UserDBAuthenticator, a as UserDBReader, w as UserDBWriter, B as UsrCrsDataInterface, a9 as computeDeviation, ab as computeEffectiveWeight, aa as computeSpread, ac as createOrchestrationContext, _ as getCardOrigin, P as getRegisteredNavigator, X as getRegisteredNavigatorNames, V as getRegisteredNavigatorRole, r as getStudySource, Q as hasRegisteredNavigator, Y as initializeNavigatorRegistry, a3 as isFilter, a2 as isGenerator, p as isReview, O as registerNavigator } from '../contentSource-BMlMwSiG.cjs';
+export { D as DataLayerProvider } from '../dataLayerProvider-BEqB8VBR.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';
 import 'moment';
 
+declare abstract class Loggable {
+    protected abstract readonly _className: string;
+    protected log(...args: unknown[]): void;
+    protected error(...args: unknown[]): void;
+}
+
 /**
  * Snapshot of the learning state for a strategy.
  *
@@ -297,85 +304,6 @@ interface CardFilter {
  */
 type CardFilterFactory<TConfig = unknown> = (config: TConfig) => CardFilter;
 
-/**
- * Context available to generators when producing candidates.
- *
- * Built once per getWeightedCards() call by the Pipeline.
- */
-interface GeneratorContext {
-    /** User database interface */
-    user: UserDBInterface;
-    /** Course database interface */
-    course: CourseDBInterface;
-    /** User's global ELO score for this course */
-    userElo: number;
-    /** Orchestration context for evolutionary weighting */
-    orchestration?: OrchestrationContext;
-}
-/**
- * A generator that produces candidate cards with initial scores.
- *
- * Generators are the "source" stage of a navigation pipeline.
- * They query the database for eligible cards and assign initial
- * suitability scores based on their strategy (ELO proximity,
- * review urgency, fixed order, etc.).
- *
- * ## Implementation Guidelines
- *
- * 1. **Create provenance**: Each card should have a provenance entry
- *    with action='generated' documenting why it was selected.
- *
- * 2. **Score semantics**: Higher scores = more suitable for presentation.
- *    Scores should be in [0, 1] range for composability.
- *
- * 3. **Limit handling**: Respect the limit parameter, but may over-fetch
- *    internally if needed for scoring accuracy.
- *
- * 4. **Sort before returning**: Return cards sorted by score descending.
- *
- * ## Example Implementation
- *
- * ```typescript
- * const myGenerator: CardGenerator = {
- *   name: 'My Generator',
- *   async getWeightedCards(limit, context) {
- *     const candidates = await fetchCandidates(context.course, limit);
- *     return candidates.map(c => ({
- *       cardId: c.id,
- *       courseId: context.course.getCourseID(),
- *       score: computeScore(c, context),
- *       provenance: [{
- *         strategy: 'myGenerator',
- *         strategyName: 'My Generator',
- *         strategyId: 'MY_GENERATOR',
- *         action: 'generated',
- *         score: computeScore(c, context),
- *         reason: 'Explanation of selection'
- *       }]
- *     }));
- *   }
- * };
- * ```
- */
-interface CardGenerator {
-    /** Human-readable name for this generator */
-    name: string;
-    /**
-     * Produce candidate cards with initial scores.
-     *
-     * @param limit - Maximum number of cards to return
-     * @param context - Shared context (user, course, userElo, etc.)
-     * @returns Cards sorted by score descending, with provenance
-     */
-    getWeightedCards(limit: number, context: GeneratorContext): Promise<WeightedCard[]>;
-}
-/**
- * Factory function type for creating generators from configuration.
- *
- * Used by PipelineAssembler to instantiate generators from strategy documents.
- */
-type CardGeneratorFactory<TConfig = unknown> = (config: TConfig) => CardGenerator;
-
 /**
  * Diagnosis of the full card space for the current user.
  */
@@ -470,6 +398,17 @@ declare const pipelineDebugAPI: {
      * Explain why reviews may or may not have been selected.
      */
     explainReviews(): void;
+    /**
+     * Show prescribed-related cards from the most recent run.
+     *
+     * Highlights:
+     * - cards directly generated by the prescribed strategy
+     * - blocked prescribed targets mentioned in provenance
+     * - support tags resolved for blocked targets
+     *
+     * @param groupId - Optional prescribed group ID filter (e.g. 'intro-core')
+     */
+    showPrescribed(groupId?: string): void;
     /**
      * Show all runs in compact format.
      */
@@ -704,4 +643,4 @@ declare const userDBDebugAPI: {
  */
 declare function mountUserDBDebugger(): void;
 
-export { type BulkCardProcessorConfig, type CardFilter, type CardFilterFactory, type CardGenerator, type CardGeneratorFactory, CardHistory, CardRecord, CourseDBInterface, DocType, DocTypePrefixes, type FilterContext, type FilterImpact, type GeneratorContext, type GeneratorSummary, type GradientObservation, type GradientResult, type ImportResult, LearnableWeight, OrchestrationContext, type PeriodUpdateInput, type PeriodUpdateResult, type PipelineRunReport, QuestionRecord, type SignalConfig, StrategyContribution, type StrategyLearningState, type StrategyStateDoc, type StrategyStateId, UserDBInterface, UserOutcomeRecord, WeightedCard, aggregateOutcomesForGradient, areQuestionRecords, buildStrategyStateId, computeOutcomeSignal, computeStrategyGradient, docIsDeleted, getCardHistoryID, getDefaultLearnableWeight, importParsedCards, isQuestionRecord, mountPipelineDebugger, mountUserDBDebugger, parseCardHistoryID, pipelineDebugAPI, recordUserOutcome, runPeriodUpdate, scoreAccuracyInZone, updateLearningState, updateStrategyWeight, userDBDebugAPI, validateProcessorConfig };
+export { type BulkCardProcessorConfig, type CardFilter, type CardFilterFactory, CardHistory, CardRecord, CourseDBInterface, DocType, DocTypePrefixes, type FilterContext, type FilterImpact, type GeneratorSummary, type GradientObservation, type GradientResult, type ImportResult, LearnableWeight, Loggable, OrchestrationContext, type PeriodUpdateInput, type PeriodUpdateResult, type PipelineRunReport, QuestionRecord, type SignalConfig, StrategyContribution, type StrategyLearningState, type StrategyStateDoc, type StrategyStateId, UserDBInterface, UserOutcomeRecord, WeightedCard, aggregateOutcomesForGradient, areQuestionRecords, buildStrategyStateId, computeOutcomeSignal, computeStrategyGradient, docIsDeleted, getCardHistoryID, getDefaultLearnableWeight, importParsedCards, isQuestionRecord, mountPipelineDebugger, mountUserDBDebugger, parseCardHistoryID, pipelineDebugAPI, recordUserOutcome, runPeriodUpdate, scoreAccuracyInZone, updateLearningState, updateStrategyWeight, userDBDebugAPI, validateProcessorConfig };

package/dist/core/index.d.ts

@@ -1,10 +1,17 @@
-import { a6 as LearnableWeight, N as UserOutcomeRecord, a7 as OrchestrationContext, W as WeightedCard, U as UserDBInterface, C as CourseDBInterface, $ as StrategyContribution } from '../dataLayerProvider-BAn-LRh5.js';
-export { K as ActivityRecord, A as AdminDBInterface, w as AssignedCard, h as AssignedContent, v as AssignedCourse, u as AssignedTag, b as ClassroomDBInterface, G as ClassroomRegistration, F as ClassroomRegistrationDesignation, H as ClassroomRegistrationDoc, f as ContentNavigationStrategyData, g as ContentNavigator, r as ContentSourceID, d as CourseInfo, L as CourseRegistration, M as CourseRegistrationDoc, a as CoursesDBInterface, D as DataLayerProvider, O as Loggable, P as NavigatorConstructor, a2 as NavigatorRole, a3 as NavigatorRoles, a1 as Navigators, k as ScheduledCard, I as SessionTrackingData, j as StudentClassroomDBInterface, i as StudyContentSource, l as StudySessionFailedItem, m as StudySessionFailedNewItem, n as StudySessionFailedReviewItem, S as StudySessionItem, o as StudySessionNewItem, p as StudySessionReviewItem, T as TeacherClassroomDBInterface, J as UserConfig, B as UserCourseSetting, z as UserCourseSettings, y as UserDBAuthenticator, c as UserDBReader, x as UserDBWriter, E as UsrCrsDataInterface, a8 as computeDeviation, aa as computeEffectiveWeight, a9 as computeSpread, ab as createOrchestrationContext, a0 as getCardOrigin, V as getRegisteredNavigator, Z as getRegisteredNavigatorNames, Y as getRegisteredNavigatorRole, s as getStudySource, X as hasRegisteredNavigator, _ as initializeNavigatorRegistry, a5 as isFilter, a4 as isGenerator, q as isReview, Q as registerNavigator } from '../dataLayerProvider-BAn-LRh5.js';
-import { D as DocType, i as QuestionRecord, f as DocTypePrefixes, g as CardHistory, h as CardRecord } from '../types-legacy-C7r0T4OV.js';
-export { C as CardData, b as CourseListData, d as DataShapeData, c as DisplayableData, F as Field, G as GuestUsername, Q as QualifiedCardID, e as QuestionData, S as SkuilderCourseData, a as Tag, T as TagStub, l as log } from '../types-legacy-C7r0T4OV.js';
+import { a7 as LearnableWeight, M as UserOutcomeRecord, a8 as OrchestrationContext, W as WeightedCard, U as UserDBInterface, C as CourseDBInterface, Z as StrategyContribution } from '../contentSource-Ht3N2f-y.js';
+export { K as ActivityRecord, A as AdminDBInterface, v as AssignedCard, g as AssignedContent, u as AssignedCourse, t as AssignedTag, a4 as CardGenerator, a6 as CardGeneratorFactory, c as ClassroomDBInterface, F as ClassroomRegistration, E as ClassroomRegistrationDesignation, H as ClassroomRegistrationDoc, e as ContentNavigationStrategyData, f as ContentNavigator, q as ContentSourceID, d as CourseInfo, L as CourseRegistration, s as CourseRegistrationDoc, b as CoursesDBInterface, a5 as GeneratorContext, G as GeneratorResult, N as NavigatorConstructor, a0 as NavigatorRole, a1 as NavigatorRoles, $ as Navigators, R as ReplanHints, j as ScheduledCard, I 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, J as UserConfig, z as UserCourseSetting, y as UserCourseSettings, x as UserDBAuthenticator, a as UserDBReader, w as UserDBWriter, B as UsrCrsDataInterface, a9 as computeDeviation, ab as computeEffectiveWeight, aa as computeSpread, ac as createOrchestrationContext, _ as getCardOrigin, P as getRegisteredNavigator, X as getRegisteredNavigatorNames, V as getRegisteredNavigatorRole, r as getStudySource, Q as hasRegisteredNavigator, Y as initializeNavigatorRegistry, a3 as isFilter, a2 as isGenerator, p as isReview, O as registerNavigator } from '../contentSource-Ht3N2f-y.js';
+export { D as DataLayerProvider } from '../dataLayerProvider-DObSXjnf.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';
 import 'moment';
 
+declare abstract class Loggable {
+    protected abstract readonly _className: string;
+    protected log(...args: unknown[]): void;
+    protected error(...args: unknown[]): void;
+}
+
 /**
  * Snapshot of the learning state for a strategy.
  *
@@ -297,85 +304,6 @@ interface CardFilter {
  */
 type CardFilterFactory<TConfig = unknown> = (config: TConfig) => CardFilter;
 
-/**
- * Context available to generators when producing candidates.
- *
- * Built once per getWeightedCards() call by the Pipeline.
- */
-interface GeneratorContext {
-    /** User database interface */
-    user: UserDBInterface;
-    /** Course database interface */
-    course: CourseDBInterface;
-    /** User's global ELO score for this course */
-    userElo: number;
-    /** Orchestration context for evolutionary weighting */
-    orchestration?: OrchestrationContext;
-}
-/**
- * A generator that produces candidate cards with initial scores.
- *
- * Generators are the "source" stage of a navigation pipeline.
- * They query the database for eligible cards and assign initial
- * suitability scores based on their strategy (ELO proximity,
- * review urgency, fixed order, etc.).
- *
- * ## Implementation Guidelines
- *
- * 1. **Create provenance**: Each card should have a provenance entry
- *    with action='generated' documenting why it was selected.
- *
- * 2. **Score semantics**: Higher scores = more suitable for presentation.
- *    Scores should be in [0, 1] range for composability.
- *
- * 3. **Limit handling**: Respect the limit parameter, but may over-fetch
- *    internally if needed for scoring accuracy.
- *
- * 4. **Sort before returning**: Return cards sorted by score descending.
- *
- * ## Example Implementation
- *
- * ```typescript
- * const myGenerator: CardGenerator = {
- *   name: 'My Generator',
- *   async getWeightedCards(limit, context) {
- *     const candidates = await fetchCandidates(context.course, limit);
- *     return candidates.map(c => ({
- *       cardId: c.id,
- *       courseId: context.course.getCourseID(),
- *       score: computeScore(c, context),
- *       provenance: [{
- *         strategy: 'myGenerator',
- *         strategyName: 'My Generator',
- *         strategyId: 'MY_GENERATOR',
- *         action: 'generated',
- *         score: computeScore(c, context),
- *         reason: 'Explanation of selection'
- *       }]
- *     }));
- *   }
- * };
- * ```
- */
-interface CardGenerator {
-    /** Human-readable name for this generator */
-    name: string;
-    /**
-     * Produce candidate cards with initial scores.
-     *
-     * @param limit - Maximum number of cards to return
-     * @param context - Shared context (user, course, userElo, etc.)
-     * @returns Cards sorted by score descending, with provenance
-     */
-    getWeightedCards(limit: number, context: GeneratorContext): Promise<WeightedCard[]>;
-}
-/**
- * Factory function type for creating generators from configuration.
- *
- * Used by PipelineAssembler to instantiate generators from strategy documents.
- */
-type CardGeneratorFactory<TConfig = unknown> = (config: TConfig) => CardGenerator;
-
 /**
  * Diagnosis of the full card space for the current user.
  */
@@ -470,6 +398,17 @@ declare const pipelineDebugAPI: {
      * Explain why reviews may or may not have been selected.
      */
     explainReviews(): void;
+    /**
+     * Show prescribed-related cards from the most recent run.
+     *
+     * Highlights:
+     * - cards directly generated by the prescribed strategy
+     * - blocked prescribed targets mentioned in provenance
+     * - support tags resolved for blocked targets
+     *
+     * @param groupId - Optional prescribed group ID filter (e.g. 'intro-core')
+     */
+    showPrescribed(groupId?: string): void;
     /**
      * Show all runs in compact format.
      */
@@ -704,4 +643,4 @@ declare const userDBDebugAPI: {
  */
 declare function mountUserDBDebugger(): void;
 
-export { type BulkCardProcessorConfig, type CardFilter, type CardFilterFactory, type CardGenerator, type CardGeneratorFactory, CardHistory, CardRecord, CourseDBInterface, DocType, DocTypePrefixes, type FilterContext, type FilterImpact, type GeneratorContext, type GeneratorSummary, type GradientObservation, type GradientResult, type ImportResult, LearnableWeight, OrchestrationContext, type PeriodUpdateInput, type PeriodUpdateResult, type PipelineRunReport, QuestionRecord, type SignalConfig, StrategyContribution, type StrategyLearningState, type StrategyStateDoc, type StrategyStateId, UserDBInterface, UserOutcomeRecord, WeightedCard, aggregateOutcomesForGradient, areQuestionRecords, buildStrategyStateId, computeOutcomeSignal, computeStrategyGradient, docIsDeleted, getCardHistoryID, getDefaultLearnableWeight, importParsedCards, isQuestionRecord, mountPipelineDebugger, mountUserDBDebugger, parseCardHistoryID, pipelineDebugAPI, recordUserOutcome, runPeriodUpdate, scoreAccuracyInZone, updateLearningState, updateStrategyWeight, userDBDebugAPI, validateProcessorConfig };
+export { type BulkCardProcessorConfig, type CardFilter, type CardFilterFactory, CardHistory, CardRecord, CourseDBInterface, DocType, DocTypePrefixes, type FilterContext, type FilterImpact, type GeneratorSummary, type GradientObservation, type GradientResult, type ImportResult, LearnableWeight, Loggable, OrchestrationContext, type PeriodUpdateInput, type PeriodUpdateResult, type PipelineRunReport, QuestionRecord, type SignalConfig, StrategyContribution, type StrategyLearningState, type StrategyStateDoc, type StrategyStateId, UserDBInterface, UserOutcomeRecord, WeightedCard, aggregateOutcomesForGradient, areQuestionRecords, buildStrategyStateId, computeOutcomeSignal, computeStrategyGradient, docIsDeleted, getCardHistoryID, getDefaultLearnableWeight, importParsedCards, isQuestionRecord, mountPipelineDebugger, mountUserDBDebugger, parseCardHistoryID, pipelineDebugAPI, recordUserOutcome, runPeriodUpdate, scoreAccuracyInZone, updateLearningState, updateStrategyWeight, userDBDebugAPI, validateProcessorConfig };