@vue-skuilder/db 0.1.32-c → 0.1.33-vite8-4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (57) hide show
  1. package/dist/{dataLayerProvider-BAn-LRh5.d.ts → contentSource-BMlMwSiG.d.cts} +202 -626
  2. package/dist/{dataLayerProvider-BJqBlMIl.d.cts → contentSource-Ht3N2f-y.d.ts} +202 -626
  3. package/dist/core/index.d.cts +40 -84
  4. package/dist/core/index.d.ts +40 -84
  5. package/dist/core/index.js +907 -1821
  6. package/dist/core/index.js.map +1 -1
  7. package/dist/core/index.mjs +886 -1804
  8. package/dist/core/index.mjs.map +1 -1
  9. package/dist/dataLayerProvider-BEqB8VBR.d.cts +67 -0
  10. package/dist/dataLayerProvider-DObSXjnf.d.ts +67 -0
  11. package/dist/impl/couch/index.d.cts +5 -5
  12. package/dist/impl/couch/index.d.ts +5 -5
  13. package/dist/impl/couch/index.js +913 -1827
  14. package/dist/impl/couch/index.js.map +1 -1
  15. package/dist/impl/couch/index.mjs +892 -1810
  16. package/dist/impl/couch/index.mjs.map +1 -1
  17. package/dist/impl/static/index.d.cts +5 -4
  18. package/dist/impl/static/index.d.ts +5 -4
  19. package/dist/impl/static/index.js +892 -1806
  20. package/dist/impl/static/index.js.map +1 -1
  21. package/dist/impl/static/index.mjs +888 -1806
  22. package/dist/impl/static/index.mjs.map +1 -1
  23. package/dist/{index-X6wHrURm.d.ts → index-BWvO-_rJ.d.ts} +1 -1
  24. package/dist/{index-m8MMGxxR.d.cts → index-Ba7hYbHj.d.cts} +1 -1
  25. package/dist/index.d.cts +461 -11
  26. package/dist/index.d.ts +461 -11
  27. package/dist/index.js +9651 -9142
  28. package/dist/index.js.map +1 -1
  29. package/dist/index.mjs +9619 -9110
  30. package/dist/index.mjs.map +1 -1
  31. package/dist/{types-DZ5dUqbL.d.ts → types-CJrLM1Ew.d.ts} +1 -1
  32. package/dist/{types-ZL8tOPQZ.d.cts → types-W8n-B6HG.d.cts} +1 -1
  33. package/dist/{types-legacy-C7r0T4OV.d.cts → types-legacy-JXDxinpU.d.cts} +1 -1
  34. package/dist/{types-legacy-C7r0T4OV.d.ts → types-legacy-JXDxinpU.d.ts} +1 -1
  35. package/dist/util/packer/index.d.cts +3 -3
  36. package/dist/util/packer/index.d.ts +3 -3
  37. package/package.json +4 -4
  38. package/src/core/interfaces/contentSource.ts +2 -3
  39. package/src/core/navigators/Pipeline.ts +164 -19
  40. package/src/core/navigators/PipelineDebugger.ts +399 -3
  41. package/src/core/navigators/filters/hierarchyDefinition.ts +2 -1
  42. package/src/core/navigators/filters/interferenceMitigator.ts +2 -1
  43. package/src/core/navigators/filters/relativePriority.ts +2 -1
  44. package/src/core/navigators/filters/userTagPreference.ts +2 -1
  45. package/src/core/navigators/generators/CompositeGenerator.ts +62 -6
  46. package/src/core/navigators/generators/elo.ts +7 -7
  47. package/src/core/navigators/generators/prescribed.ts +367 -54
  48. package/src/core/navigators/generators/srs.ts +3 -4
  49. package/src/core/navigators/generators/types.ts +48 -2
  50. package/src/core/navigators/index.ts +3 -3
  51. package/src/impl/couch/classroomDB.ts +4 -3
  52. package/src/impl/couch/courseDB.ts +3 -3
  53. package/src/impl/static/courseDB.ts +3 -3
  54. package/src/study/SessionController.ts +5 -27
  55. package/src/study/TagFilteredContentSource.ts +4 -3
  56. package/tests/core/navigators/CompositeGenerator.test.ts +14 -50
  57. package/tests/core/navigators/Pipeline.test.ts +13 -12
@@ -1,10 +1,17 @@
1
- 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';
2
- 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';
3
- import { D as DocType, i as QuestionRecord, f as DocTypePrefixes, g as CardHistory, h as CardRecord } from '../types-legacy-C7r0T4OV.cjs';
4
- 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';
1
+ import { a7 as LearnableWeight, M as UserOutcomeRecord, a8 as OrchestrationContext, W as WeightedCard, U as UserDBInterface, C as CourseDBInterface, R as ReplanHints, Z as StrategyContribution } from '../contentSource-BMlMwSiG.cjs';
2
+ 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, 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';
3
+ export { D as DataLayerProvider } from '../dataLayerProvider-BEqB8VBR.cjs';
4
+ import { D as DocType, i as QuestionRecord, b as DocTypePrefixes, C as CardHistory, c as CardRecord } from '../types-legacy-JXDxinpU.cjs';
5
+ 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';
5
6
  import { DataShape, ParsedCard } from '@vue-skuilder/common';
6
7
  import 'moment';
7
8
 
9
+ declare abstract class Loggable {
10
+ protected abstract readonly _className: string;
11
+ protected log(...args: unknown[]): void;
12
+ protected error(...args: unknown[]): void;
13
+ }
14
+
8
15
  /**
9
16
  * Snapshot of the learning state for a strategy.
10
17
  *
@@ -297,85 +304,6 @@ interface CardFilter {
297
304
  */
298
305
  type CardFilterFactory<TConfig = unknown> = (config: TConfig) => CardFilter;
299
306
 
300
- /**
301
- * Context available to generators when producing candidates.
302
- *
303
- * Built once per getWeightedCards() call by the Pipeline.
304
- */
305
- interface GeneratorContext {
306
- /** User database interface */
307
- user: UserDBInterface;
308
- /** Course database interface */
309
- course: CourseDBInterface;
310
- /** User's global ELO score for this course */
311
- userElo: number;
312
- /** Orchestration context for evolutionary weighting */
313
- orchestration?: OrchestrationContext;
314
- }
315
- /**
316
- * A generator that produces candidate cards with initial scores.
317
- *
318
- * Generators are the "source" stage of a navigation pipeline.
319
- * They query the database for eligible cards and assign initial
320
- * suitability scores based on their strategy (ELO proximity,
321
- * review urgency, fixed order, etc.).
322
- *
323
- * ## Implementation Guidelines
324
- *
325
- * 1. **Create provenance**: Each card should have a provenance entry
326
- * with action='generated' documenting why it was selected.
327
- *
328
- * 2. **Score semantics**: Higher scores = more suitable for presentation.
329
- * Scores should be in [0, 1] range for composability.
330
- *
331
- * 3. **Limit handling**: Respect the limit parameter, but may over-fetch
332
- * internally if needed for scoring accuracy.
333
- *
334
- * 4. **Sort before returning**: Return cards sorted by score descending.
335
- *
336
- * ## Example Implementation
337
- *
338
- * ```typescript
339
- * const myGenerator: CardGenerator = {
340
- * name: 'My Generator',
341
- * async getWeightedCards(limit, context) {
342
- * const candidates = await fetchCandidates(context.course, limit);
343
- * return candidates.map(c => ({
344
- * cardId: c.id,
345
- * courseId: context.course.getCourseID(),
346
- * score: computeScore(c, context),
347
- * provenance: [{
348
- * strategy: 'myGenerator',
349
- * strategyName: 'My Generator',
350
- * strategyId: 'MY_GENERATOR',
351
- * action: 'generated',
352
- * score: computeScore(c, context),
353
- * reason: 'Explanation of selection'
354
- * }]
355
- * }));
356
- * }
357
- * };
358
- * ```
359
- */
360
- interface CardGenerator {
361
- /** Human-readable name for this generator */
362
- name: string;
363
- /**
364
- * Produce candidate cards with initial scores.
365
- *
366
- * @param limit - Maximum number of cards to return
367
- * @param context - Shared context (user, course, userElo, etc.)
368
- * @returns Cards sorted by score descending, with provenance
369
- */
370
- getWeightedCards(limit: number, context: GeneratorContext): Promise<WeightedCard[]>;
371
- }
372
- /**
373
- * Factory function type for creating generators from configuration.
374
- *
375
- * Used by PipelineAssembler to instantiate generators from strategy documents.
376
- */
377
- type CardGeneratorFactory<TConfig = unknown> = (config: TConfig) => CardGenerator;
378
-
379
307
  /**
380
308
  * Diagnosis of the full card space for the current user.
381
309
  */
@@ -431,6 +359,8 @@ interface PipelineRunReport {
431
359
  generators?: GeneratorSummary[];
432
360
  generatedCount: number;
433
361
  filters: FilterImpact[];
362
+ /** Ephemeral hints applied during this run */
363
+ hints?: ReplanHints;
434
364
  finalCount: number;
435
365
  reviewsSelected: number;
436
366
  newSelected: number;
@@ -438,6 +368,7 @@ interface PipelineRunReport {
438
368
  cardId: string;
439
369
  courseId: string;
440
370
  origin: 'new' | 'review' | 'unknown';
371
+ generator?: string;
441
372
  finalScore: number;
442
373
  /** Card's ELO (parsed from ELO generator provenance, if available) */
443
374
  cardElo?: number;
@@ -470,6 +401,17 @@ declare const pipelineDebugAPI: {
470
401
  * Explain why reviews may or may not have been selected.
471
402
  */
472
403
  explainReviews(): void;
404
+ /**
405
+ * Show prescribed-related cards from the most recent run.
406
+ *
407
+ * Highlights:
408
+ * - cards directly generated by the prescribed strategy
409
+ * - blocked prescribed targets mentioned in provenance
410
+ * - support tags resolved for blocked targets
411
+ *
412
+ * @param groupId - Optional prescribed group ID filter (e.g. 'intro-core')
413
+ */
414
+ showPrescribed(groupId?: string): void;
473
415
  /**
474
416
  * Show all runs in compact format.
475
417
  */
@@ -512,6 +454,20 @@ declare const pipelineDebugAPI: {
512
454
  * Examples: 'gpc:expose:*', 'gpc:intro:t-T', ['gpc:expose:t-*', 'gpc:intro:t-*']
513
455
  */
514
456
  showTagElo(tagFilter?: string | string[]): Promise<void>;
457
+ /**
458
+ * Toggle the full-screen UI debugger.
459
+ */
460
+ ui(): void;
461
+ /**
462
+ * Internal UI helpers
463
+ * @internal
464
+ */
465
+ _selectRun(index: number): void;
466
+ /**
467
+ * Internal UI helpers
468
+ * @internal
469
+ */
470
+ _setSearch(query: string): void;
515
471
  /**
516
472
  * Show help.
517
473
  */
@@ -704,4 +660,4 @@ declare const userDBDebugAPI: {
704
660
  */
705
661
  declare function mountUserDBDebugger(): void;
706
662
 
707
- 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 };
663
+ 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, ReplanHints, 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 };
@@ -1,10 +1,17 @@
1
- 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';
2
- 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';
3
- import { D as DocType, i as QuestionRecord, f as DocTypePrefixes, g as CardHistory, h as CardRecord } from '../types-legacy-C7r0T4OV.js';
4
- 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';
1
+ import { a7 as LearnableWeight, M as UserOutcomeRecord, a8 as OrchestrationContext, W as WeightedCard, U as UserDBInterface, C as CourseDBInterface, R as ReplanHints, Z as StrategyContribution } from '../contentSource-Ht3N2f-y.js';
2
+ 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, 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';
3
+ export { D as DataLayerProvider } from '../dataLayerProvider-DObSXjnf.js';
4
+ import { D as DocType, i as QuestionRecord, b as DocTypePrefixes, C as CardHistory, c as CardRecord } from '../types-legacy-JXDxinpU.js';
5
+ 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';
5
6
  import { DataShape, ParsedCard } from '@vue-skuilder/common';
6
7
  import 'moment';
7
8
 
9
+ declare abstract class Loggable {
10
+ protected abstract readonly _className: string;
11
+ protected log(...args: unknown[]): void;
12
+ protected error(...args: unknown[]): void;
13
+ }
14
+
8
15
  /**
9
16
  * Snapshot of the learning state for a strategy.
10
17
  *
@@ -297,85 +304,6 @@ interface CardFilter {
297
304
  */
298
305
  type CardFilterFactory<TConfig = unknown> = (config: TConfig) => CardFilter;
299
306
 
300
- /**
301
- * Context available to generators when producing candidates.
302
- *
303
- * Built once per getWeightedCards() call by the Pipeline.
304
- */
305
- interface GeneratorContext {
306
- /** User database interface */
307
- user: UserDBInterface;
308
- /** Course database interface */
309
- course: CourseDBInterface;
310
- /** User's global ELO score for this course */
311
- userElo: number;
312
- /** Orchestration context for evolutionary weighting */
313
- orchestration?: OrchestrationContext;
314
- }
315
- /**
316
- * A generator that produces candidate cards with initial scores.
317
- *
318
- * Generators are the "source" stage of a navigation pipeline.
319
- * They query the database for eligible cards and assign initial
320
- * suitability scores based on their strategy (ELO proximity,
321
- * review urgency, fixed order, etc.).
322
- *
323
- * ## Implementation Guidelines
324
- *
325
- * 1. **Create provenance**: Each card should have a provenance entry
326
- * with action='generated' documenting why it was selected.
327
- *
328
- * 2. **Score semantics**: Higher scores = more suitable for presentation.
329
- * Scores should be in [0, 1] range for composability.
330
- *
331
- * 3. **Limit handling**: Respect the limit parameter, but may over-fetch
332
- * internally if needed for scoring accuracy.
333
- *
334
- * 4. **Sort before returning**: Return cards sorted by score descending.
335
- *
336
- * ## Example Implementation
337
- *
338
- * ```typescript
339
- * const myGenerator: CardGenerator = {
340
- * name: 'My Generator',
341
- * async getWeightedCards(limit, context) {
342
- * const candidates = await fetchCandidates(context.course, limit);
343
- * return candidates.map(c => ({
344
- * cardId: c.id,
345
- * courseId: context.course.getCourseID(),
346
- * score: computeScore(c, context),
347
- * provenance: [{
348
- * strategy: 'myGenerator',
349
- * strategyName: 'My Generator',
350
- * strategyId: 'MY_GENERATOR',
351
- * action: 'generated',
352
- * score: computeScore(c, context),
353
- * reason: 'Explanation of selection'
354
- * }]
355
- * }));
356
- * }
357
- * };
358
- * ```
359
- */
360
- interface CardGenerator {
361
- /** Human-readable name for this generator */
362
- name: string;
363
- /**
364
- * Produce candidate cards with initial scores.
365
- *
366
- * @param limit - Maximum number of cards to return
367
- * @param context - Shared context (user, course, userElo, etc.)
368
- * @returns Cards sorted by score descending, with provenance
369
- */
370
- getWeightedCards(limit: number, context: GeneratorContext): Promise<WeightedCard[]>;
371
- }
372
- /**
373
- * Factory function type for creating generators from configuration.
374
- *
375
- * Used by PipelineAssembler to instantiate generators from strategy documents.
376
- */
377
- type CardGeneratorFactory<TConfig = unknown> = (config: TConfig) => CardGenerator;
378
-
379
307
  /**
380
308
  * Diagnosis of the full card space for the current user.
381
309
  */
@@ -431,6 +359,8 @@ interface PipelineRunReport {
431
359
  generators?: GeneratorSummary[];
432
360
  generatedCount: number;
433
361
  filters: FilterImpact[];
362
+ /** Ephemeral hints applied during this run */
363
+ hints?: ReplanHints;
434
364
  finalCount: number;
435
365
  reviewsSelected: number;
436
366
  newSelected: number;
@@ -438,6 +368,7 @@ interface PipelineRunReport {
438
368
  cardId: string;
439
369
  courseId: string;
440
370
  origin: 'new' | 'review' | 'unknown';
371
+ generator?: string;
441
372
  finalScore: number;
442
373
  /** Card's ELO (parsed from ELO generator provenance, if available) */
443
374
  cardElo?: number;
@@ -470,6 +401,17 @@ declare const pipelineDebugAPI: {
470
401
  * Explain why reviews may or may not have been selected.
471
402
  */
472
403
  explainReviews(): void;
404
+ /**
405
+ * Show prescribed-related cards from the most recent run.
406
+ *
407
+ * Highlights:
408
+ * - cards directly generated by the prescribed strategy
409
+ * - blocked prescribed targets mentioned in provenance
410
+ * - support tags resolved for blocked targets
411
+ *
412
+ * @param groupId - Optional prescribed group ID filter (e.g. 'intro-core')
413
+ */
414
+ showPrescribed(groupId?: string): void;
473
415
  /**
474
416
  * Show all runs in compact format.
475
417
  */
@@ -512,6 +454,20 @@ declare const pipelineDebugAPI: {
512
454
  * Examples: 'gpc:expose:*', 'gpc:intro:t-T', ['gpc:expose:t-*', 'gpc:intro:t-*']
513
455
  */
514
456
  showTagElo(tagFilter?: string | string[]): Promise<void>;
457
+ /**
458
+ * Toggle the full-screen UI debugger.
459
+ */
460
+ ui(): void;
461
+ /**
462
+ * Internal UI helpers
463
+ * @internal
464
+ */
465
+ _selectRun(index: number): void;
466
+ /**
467
+ * Internal UI helpers
468
+ * @internal
469
+ */
470
+ _setSearch(query: string): void;
515
471
  /**
516
472
  * Show help.
517
473
  */
@@ -704,4 +660,4 @@ declare const userDBDebugAPI: {
704
660
  */
705
661
  declare function mountUserDBDebugger(): void;
706
662
 
707
- 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 };
663
+ 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, ReplanHints, 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 };