@vue-skuilder/db 0.2.34 → 0.2.36

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 (262) hide show
  1. package/CLAUDE.md +15 -4
  2. package/build.entries.mjs +12 -0
  3. package/dist/_virtual/_rolldown/runtime.mjs +8 -0
  4. package/dist/{contentSource-CTQ4kWhR.d.cts → contentSource-D_E7JaxR.d.ts} +2 -2
  5. package/dist/core/UserDBDebugger.mjs +285 -0
  6. package/dist/core/UserDBDebugger.mjs.map +1 -0
  7. package/dist/core/bulkImport/cardProcessor.mjs +106 -0
  8. package/dist/core/bulkImport/cardProcessor.mjs.map +1 -0
  9. package/dist/core/{index.js → index.cjs} +6438 -7784
  10. package/dist/core/index.cjs.map +1 -0
  11. package/dist/core/index.d.ts +5 -5
  12. package/dist/core/index.mjs +20 -11368
  13. package/dist/core/interfaces/contentSource.mjs +20 -0
  14. package/dist/core/interfaces/contentSource.mjs.map +1 -0
  15. package/dist/core/navigators/Pipeline.mjs +723 -0
  16. package/dist/core/navigators/Pipeline.mjs.map +1 -0
  17. package/dist/core/navigators/PipelineAssembler.mjs +86 -0
  18. package/dist/core/navigators/PipelineAssembler.mjs.map +1 -0
  19. package/dist/core/navigators/PipelineDebugger.mjs +771 -0
  20. package/dist/core/navigators/PipelineDebugger.mjs.map +1 -0
  21. package/dist/core/navigators/SrsDebugger.mjs +34 -0
  22. package/dist/core/navigators/SrsDebugger.mjs.map +1 -0
  23. package/dist/core/navigators/StrategyPressureDebugger.mjs +19 -0
  24. package/dist/core/navigators/StrategyPressureDebugger.mjs.map +1 -0
  25. package/dist/core/navigators/defaults.mjs +96 -0
  26. package/dist/core/navigators/defaults.mjs.map +1 -0
  27. package/dist/core/navigators/diversityRerank.mjs +85 -0
  28. package/dist/core/navigators/diversityRerank.mjs.map +1 -0
  29. package/dist/core/navigators/filters/WeightedFilter.mjs +81 -0
  30. package/dist/core/navigators/filters/WeightedFilter.mjs.map +1 -0
  31. package/dist/core/navigators/filters/eloDistance.mjs +244 -0
  32. package/dist/core/navigators/filters/eloDistance.mjs.map +1 -0
  33. package/dist/core/navigators/filters/hierarchyDefinition.mjs +235 -0
  34. package/dist/core/navigators/filters/hierarchyDefinition.mjs.map +1 -0
  35. package/dist/core/navigators/filters/interferenceMitigator.mjs +201 -0
  36. package/dist/core/navigators/filters/interferenceMitigator.mjs.map +1 -0
  37. package/dist/core/navigators/filters/relativePriority.mjs +135 -0
  38. package/dist/core/navigators/filters/relativePriority.mjs.map +1 -0
  39. package/dist/core/navigators/filters/userTagPreference.mjs +101 -0
  40. package/dist/core/navigators/filters/userTagPreference.mjs.map +1 -0
  41. package/dist/core/navigators/generators/CompositeGenerator.mjs +203 -0
  42. package/dist/core/navigators/generators/CompositeGenerator.mjs.map +1 -0
  43. package/dist/core/navigators/generators/elo.mjs +77 -0
  44. package/dist/core/navigators/generators/elo.mjs.map +1 -0
  45. package/dist/core/navigators/generators/prescribed.mjs +676 -0
  46. package/dist/core/navigators/generators/prescribed.mjs.map +1 -0
  47. package/dist/core/navigators/generators/srs.mjs +158 -0
  48. package/dist/core/navigators/generators/srs.mjs.map +1 -0
  49. package/dist/core/navigators/index.mjs +345 -0
  50. package/dist/core/navigators/index.mjs.map +1 -0
  51. package/dist/core/navigators/pipelinePlan.mjs +109 -0
  52. package/dist/core/navigators/pipelinePlan.mjs.map +1 -0
  53. package/dist/core/navigators/regulators.mjs +128 -0
  54. package/dist/core/navigators/regulators.mjs.map +1 -0
  55. package/dist/core/orchestration/gradient.mjs +101 -0
  56. package/dist/core/orchestration/gradient.mjs.map +1 -0
  57. package/dist/core/orchestration/index.mjs +115 -0
  58. package/dist/core/orchestration/index.mjs.map +1 -0
  59. package/dist/core/orchestration/learning.mjs +140 -0
  60. package/dist/core/orchestration/learning.mjs.map +1 -0
  61. package/dist/core/orchestration/recording.mjs +64 -0
  62. package/dist/core/orchestration/recording.mjs.map +1 -0
  63. package/dist/core/orchestration/signal.mjs +40 -0
  64. package/dist/core/orchestration/signal.mjs.map +1 -0
  65. package/dist/core/types/contentNavigationStrategy.mjs +10 -0
  66. package/dist/core/types/contentNavigationStrategy.mjs.map +1 -0
  67. package/dist/core/types/hydration.mjs +13 -0
  68. package/dist/core/types/hydration.mjs.map +1 -0
  69. package/dist/core/types/strategyState.mjs +16 -0
  70. package/dist/core/types/strategyState.mjs.map +1 -0
  71. package/dist/core/types/studySession.mjs +14 -0
  72. package/dist/core/types/studySession.mjs.map +1 -0
  73. package/dist/core/types/types-legacy.mjs +44 -0
  74. package/dist/core/types/types-legacy.mjs.map +1 -0
  75. package/dist/core/util/index.mjs +31 -0
  76. package/dist/core/util/index.mjs.map +1 -0
  77. package/dist/core/versionStamps.mjs +46 -0
  78. package/dist/core/versionStamps.mjs.map +1 -0
  79. package/dist/courseConfigRegistration.mjs +306 -0
  80. package/dist/courseConfigRegistration.mjs.map +1 -0
  81. package/dist/{dataLayerProvider-rlLE2Mf-.d.ts → dataLayerProvider-BDshhSp_.d.ts} +1 -1
  82. package/dist/diagnostics/dataset.mjs +118 -0
  83. package/dist/diagnostics/dataset.mjs.map +1 -0
  84. package/dist/diagnostics/derive.mjs +318 -0
  85. package/dist/diagnostics/derive.mjs.map +1 -0
  86. package/dist/diagnostics/{index.js → index.cjs} +130 -1
  87. package/dist/diagnostics/index.cjs.map +1 -0
  88. package/dist/diagnostics/index.d.ts +108 -5
  89. package/dist/diagnostics/index.mjs +7 -914
  90. package/dist/diagnostics/loader.mjs +151 -0
  91. package/dist/diagnostics/loader.mjs.map +1 -0
  92. package/dist/diagnostics/pipeline.mjs +161 -0
  93. package/dist/diagnostics/pipeline.mjs.map +1 -0
  94. package/dist/diagnostics/tagElo.mjs +177 -0
  95. package/dist/diagnostics/tagElo.mjs.map +1 -0
  96. package/dist/diagnostics/text.mjs +174 -0
  97. package/dist/diagnostics/text.mjs.map +1 -0
  98. package/dist/factory.mjs +70 -0
  99. package/dist/factory.mjs.map +1 -0
  100. package/dist/impl/common/BaseUserDB.mjs +1103 -0
  101. package/dist/impl/common/BaseUserDB.mjs.map +1 -0
  102. package/dist/impl/common/userDBHelpers.mjs +49 -0
  103. package/dist/impl/common/userDBHelpers.mjs.map +1 -0
  104. package/dist/impl/common/userDBKeys.mjs +45 -0
  105. package/dist/impl/common/userDBKeys.mjs.map +1 -0
  106. package/dist/impl/couch/CouchDBSyncStrategy.mjs +272 -0
  107. package/dist/impl/couch/CouchDBSyncStrategy.mjs.map +1 -0
  108. package/dist/impl/couch/CourseSyncService.mjs +242 -0
  109. package/dist/impl/couch/CourseSyncService.mjs.map +1 -0
  110. package/dist/impl/couch/PouchDataLayerProvider.mjs +74 -0
  111. package/dist/impl/couch/PouchDataLayerProvider.mjs.map +1 -0
  112. package/dist/impl/couch/adminDB.mjs +61 -0
  113. package/dist/impl/couch/adminDB.mjs.map +1 -0
  114. package/dist/impl/couch/auth.mjs +33 -0
  115. package/dist/impl/couch/auth.mjs.map +1 -0
  116. package/dist/impl/couch/classroomDB.mjs +227 -0
  117. package/dist/impl/couch/classroomDB.mjs.map +1 -0
  118. package/dist/impl/couch/clientCache.mjs +15 -0
  119. package/dist/impl/couch/clientCache.mjs.map +1 -0
  120. package/dist/impl/couch/courseAPI.mjs +183 -0
  121. package/dist/impl/couch/courseAPI.mjs.map +1 -0
  122. package/dist/impl/couch/courseDB.mjs +729 -0
  123. package/dist/impl/couch/courseDB.mjs.map +1 -0
  124. package/dist/impl/couch/courseLookupDB.mjs +94 -0
  125. package/dist/impl/couch/courseLookupDB.mjs.map +1 -0
  126. package/dist/impl/couch/{index.js → index.cjs} +6911 -10367
  127. package/dist/impl/couch/index.cjs.map +1 -0
  128. package/dist/impl/couch/index.d.ts +12 -5
  129. package/dist/impl/couch/index.mjs +134 -12146
  130. package/dist/impl/couch/index.mjs.map +1 -1
  131. package/dist/impl/couch/pouchdb-setup.mjs +15 -0
  132. package/dist/impl/couch/pouchdb-setup.mjs.map +1 -0
  133. package/dist/impl/couch/updateQueue.mjs +101 -0
  134. package/dist/impl/couch/updateQueue.mjs.map +1 -0
  135. package/dist/impl/couch/user-course-relDB.mjs +55 -0
  136. package/dist/impl/couch/user-course-relDB.mjs.map +1 -0
  137. package/dist/impl/static/NoOpSyncStrategy.mjs +49 -0
  138. package/dist/impl/static/NoOpSyncStrategy.mjs.map +1 -0
  139. package/dist/impl/static/StaticDataLayerProvider.mjs +94 -0
  140. package/dist/impl/static/StaticDataLayerProvider.mjs.map +1 -0
  141. package/dist/impl/static/StaticDataUnpacker.mjs +311 -0
  142. package/dist/impl/static/StaticDataUnpacker.mjs.map +1 -0
  143. package/dist/impl/static/courseDB.mjs +368 -0
  144. package/dist/impl/static/courseDB.mjs.map +1 -0
  145. package/dist/impl/static/coursesDB.mjs +38 -0
  146. package/dist/impl/static/coursesDB.mjs.map +1 -0
  147. package/dist/impl/static/{index.js → index.cjs} +2461 -5992
  148. package/dist/impl/static/index.cjs.map +1 -0
  149. package/dist/impl/static/index.d.ts +4 -4
  150. package/dist/impl/static/index.mjs +6 -10741
  151. package/dist/{index-CVGehe_t.d.ts → index-BLDpFYG3.d.ts} +1 -1
  152. package/dist/{index.js → index.cjs} +14070 -14239
  153. package/dist/index.cjs.map +1 -0
  154. package/dist/index.d.ts +12 -23
  155. package/dist/index.mjs +38 -16937
  156. package/dist/pouch/{index.js → index.cjs} +5 -1
  157. package/dist/pouch/index.cjs.map +1 -0
  158. package/dist/pouch/index.mjs +2 -19
  159. package/dist/study/ItemQueue.mjs +95 -0
  160. package/dist/study/ItemQueue.mjs.map +1 -0
  161. package/dist/study/MixerDebugger.mjs +303 -0
  162. package/dist/study/MixerDebugger.mjs.map +1 -0
  163. package/dist/study/SessionController.mjs +1187 -0
  164. package/dist/study/SessionController.mjs.map +1 -0
  165. package/dist/study/SessionDebugger.mjs +271 -0
  166. package/dist/study/SessionDebugger.mjs.map +1 -0
  167. package/dist/study/SessionOverlay.mjs +407 -0
  168. package/dist/study/SessionOverlay.mjs.map +1 -0
  169. package/dist/study/SourceMixer.mjs +45 -0
  170. package/dist/study/SourceMixer.mjs.map +1 -0
  171. package/dist/study/SpacedRepetition.mjs +108 -0
  172. package/dist/study/SpacedRepetition.mjs.map +1 -0
  173. package/dist/study/TagFilteredContentSource.mjs +136 -0
  174. package/dist/study/TagFilteredContentSource.mjs.map +1 -0
  175. package/dist/study/services/CardHydrationService.mjs +172 -0
  176. package/dist/study/services/CardHydrationService.mjs.map +1 -0
  177. package/dist/study/services/EloService.mjs +217 -0
  178. package/dist/study/services/EloService.mjs.map +1 -0
  179. package/dist/study/services/ResponseProcessor.mjs +190 -0
  180. package/dist/study/services/ResponseProcessor.mjs.map +1 -0
  181. package/dist/study/services/SrsService.mjs +49 -0
  182. package/dist/study/services/SrsService.mjs.map +1 -0
  183. package/dist/study/services/tagRecent.mjs +65 -0
  184. package/dist/study/services/tagRecent.mjs.map +1 -0
  185. package/dist/{types-dXWfyz9B.d.ts → types-DChCz22D.d.ts} +1 -1
  186. package/dist/{types-legacy-BkOYOR6U.d.cts → types-legacy-fT5Y1Wuy.d.ts} +1 -1
  187. package/dist/userDBKeys-ne1g4Xuq.d.ts +16 -0
  188. package/dist/util/Loggable.mjs +14 -0
  189. package/dist/util/Loggable.mjs.map +1 -0
  190. package/dist/util/dataDirectory.mjs +47 -0
  191. package/dist/util/dataDirectory.mjs.map +1 -0
  192. package/dist/util/logger.mjs +86 -0
  193. package/dist/util/logger.mjs.map +1 -0
  194. package/dist/util/migrator/FileSystemAdapter.mjs +18 -0
  195. package/dist/util/migrator/FileSystemAdapter.mjs.map +1 -0
  196. package/dist/util/migrator/StaticToCouchDBMigrator.mjs +428 -0
  197. package/dist/util/migrator/StaticToCouchDBMigrator.mjs.map +1 -0
  198. package/dist/util/migrator/types.mjs +11 -0
  199. package/dist/util/migrator/types.mjs.map +1 -0
  200. package/dist/util/migrator/validation.mjs +334 -0
  201. package/dist/util/migrator/validation.mjs.map +1 -0
  202. package/dist/util/packer/CouchDBToStaticPacker.mjs +438 -0
  203. package/dist/util/packer/CouchDBToStaticPacker.mjs.map +1 -0
  204. package/dist/util/packer/{index.js → index.cjs} +73 -9
  205. package/dist/util/packer/index.cjs.map +1 -0
  206. package/dist/util/packer/index.d.ts +3 -3
  207. package/dist/util/packer/index.mjs +2 -537
  208. package/eslint.config.mjs +9 -1
  209. package/package.json +25 -13
  210. package/rolldown.config.mjs +44 -0
  211. package/src/core/UserDBDebugger.ts +47 -46
  212. package/src/core/navigators/Pipeline.ts +10 -10
  213. package/src/core/navigators/PipelineDebugger.ts +55 -55
  214. package/src/core/navigators/filters/eloDistance.ts +11 -1
  215. package/src/core/navigators/generators/elo.ts +5 -1
  216. package/src/core/navigators/index.ts +9 -3
  217. package/src/diagnostics/derive.ts +6 -0
  218. package/src/diagnostics/index.ts +1 -0
  219. package/src/diagnostics/tagElo.ts +257 -0
  220. package/src/factory.ts +10 -1
  221. package/src/impl/common/BaseUserDB.ts +1 -3
  222. package/src/impl/common/index.ts +2 -0
  223. package/src/impl/common/userDBHelpers.ts +4 -58
  224. package/src/impl/common/userDBKeys.ts +64 -0
  225. package/src/impl/couch/courseDB.ts +15 -3
  226. package/src/impl/couch/index.ts +2 -18
  227. package/src/impl/couch/pouchdb-setup.ts +8 -0
  228. package/src/index.ts +1 -1
  229. package/src/study/MixerDebugger.ts +46 -46
  230. package/src/study/SessionDebugger.ts +20 -20
  231. package/src/study/SessionOverlay.ts +4 -4
  232. package/src/util/logger.ts +112 -13
  233. package/tests/core/navigators/eloGenerator.test.ts +36 -0
  234. package/tsup.config.ts +24 -21
  235. package/dist/SyncStrategy-BXliog1m.d.cts +0 -116
  236. package/dist/classroomDB-DLTtLZct.d.cts +0 -86
  237. package/dist/contentSource-JmWYu8IK.d.ts +0 -2007
  238. package/dist/core/index.d.cts +0 -521
  239. package/dist/core/index.js.map +0 -1
  240. package/dist/core/index.mjs.map +0 -1
  241. package/dist/dataLayerProvider-DfI_KYAe.d.cts +0 -61
  242. package/dist/diagnostics/index.d.cts +0 -458
  243. package/dist/diagnostics/index.js.map +0 -1
  244. package/dist/diagnostics/index.mjs.map +0 -1
  245. package/dist/impl/couch/index.d.cts +0 -620
  246. package/dist/impl/couch/index.js.map +0 -1
  247. package/dist/impl/static/index.d.cts +0 -232
  248. package/dist/impl/static/index.js.map +0 -1
  249. package/dist/impl/static/index.mjs.map +0 -1
  250. package/dist/index-Ktg72jKb.d.cts +0 -137
  251. package/dist/index.d.cts +0 -1663
  252. package/dist/index.js.map +0 -1
  253. package/dist/index.mjs.map +0 -1
  254. package/dist/pouch/index.d.cts +0 -1
  255. package/dist/pouch/index.js.map +0 -1
  256. package/dist/pouch/index.mjs.map +0 -1
  257. package/dist/types-D0oQeJAi.d.cts +0 -58
  258. package/dist/types-legacy-BkOYOR6U.d.ts +0 -168
  259. package/dist/util/packer/index.d.cts +0 -5
  260. package/dist/util/packer/index.js.map +0 -1
  261. package/dist/util/packer/index.mjs.map +0 -1
  262. package/src/study/getCardDataShape.ts +0 -34
@@ -0,0 +1,723 @@
1
+ import "../../_virtual/_rolldown/runtime.mjs";
2
+ import { logger } from "../../util/logger.mjs";
3
+ import { diversityRerank } from "./diversityRerank.mjs";
4
+ import { buildRunReport, captureRun, registerPipelineForDebug } from "./PipelineDebugger.mjs";
5
+ import { noteReviewPressure } from "./SrsDebugger.mjs";
6
+ import { ContentNavigator } from "./index.mjs";
7
+ import { createOrchestrationContext } from "../orchestration/index.mjs";
8
+ import { DEFAULT_REGULATOR_CONFIG, INTAKE_CLOCK_KEY, applyReading, intakeReading, resetIntakeClock, reviewMassReading, stepIntakeClock } from "./regulators.mjs";
9
+ import { toCourseElo } from "@vue-skuilder/common";
10
+ //#region src/core/navigators/Pipeline.ts
11
+ /**
12
+ * Convert a glob pattern (with `*` wildcards) to a RegExp.
13
+ * Only `*` is supported as a wildcard (matches any characters).
14
+ */
15
+ function globToRegex(pattern) {
16
+ const withWildcards = pattern.replace(/[.+?^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*");
17
+ return new RegExp(`^${withWildcards}$`);
18
+ }
19
+ /** Test whether a string matches a glob pattern. */
20
+ function globMatch(value, pattern) {
21
+ if (!pattern.includes("*")) return value === pattern;
22
+ return globToRegex(pattern).test(value);
23
+ }
24
+ /** Test whether any of a card's tags match a glob pattern. */
25
+ function cardMatchesTagPattern(card, pattern) {
26
+ return (card.tags ?? []).some((tag) => globMatch(tag, pattern));
27
+ }
28
+ function mergeHints(allHints) {
29
+ const defined = allHints.filter((h) => h !== null && h !== void 0);
30
+ if (defined.length === 0) return void 0;
31
+ const merged = {};
32
+ const boostTags = {};
33
+ for (const hints of defined) for (const [pattern, factor] of Object.entries(hints.boostTags ?? {})) boostTags[pattern] = (boostTags[pattern] ?? 1) * factor;
34
+ if (Object.keys(boostTags).length > 0) merged.boostTags = boostTags;
35
+ const boostCards = {};
36
+ for (const hints of defined) for (const [pattern, factor] of Object.entries(hints.boostCards ?? {})) boostCards[pattern] = (boostCards[pattern] ?? 1) * factor;
37
+ if (Object.keys(boostCards).length > 0) merged.boostCards = boostCards;
38
+ const concatUnique = (field) => {
39
+ const values = defined.flatMap((h) => h[field] ?? []);
40
+ if (values.length > 0) merged[field] = [...new Set(values)];
41
+ };
42
+ concatUnique("requireTags");
43
+ concatUnique("requireCards");
44
+ concatUnique("excludeTags");
45
+ concatUnique("excludeCards");
46
+ const labels = defined.map((h) => h._label).filter(Boolean);
47
+ if (labels.length > 0) merged._label = labels.join("; ");
48
+ return Object.keys(merged).length > 0 ? merged : void 0;
49
+ }
50
+ /**
51
+ * Log pipeline configuration on construction.
52
+ * Shows generator and filter chain structure.
53
+ */
54
+ function logPipelineConfig(generator, filters) {
55
+ const filterList = filters.length > 0 ? "\n - " + filters.map((f) => f.name).join("\n - ") : " none";
56
+ logger.info(`[Pipeline] Configuration:\n Generator: ${generator.name}\n Filters:${filterList}`);
57
+ }
58
+ /**
59
+ * Log tag hydration results.
60
+ * Shows effectiveness of batch query (how many cards/tags were hydrated).
61
+ */
62
+ function logTagHydration(cards, tagsByCard) {
63
+ const totalTags = Array.from(tagsByCard.values()).reduce((sum, tags) => sum + tags.length, 0);
64
+ const cardsWithTags = Array.from(tagsByCard.values()).filter((tags) => tags.length > 0).length;
65
+ logger.debug(`[Pipeline] Tag hydration: ${cards.length} cards, ${cardsWithTags} have tags (${totalTags} total tags) - single batch query`);
66
+ }
67
+ /**
68
+ * Log pipeline execution summary.
69
+ * Shows complete flow from generator through filters to final results.
70
+ */
71
+ function logExecutionSummary(generatorName, generatedCount, filterCount, finalCount, topScores, filterImpacts) {
72
+ const scoreDisplay = topScores.length > 0 ? topScores.map((s) => s.toFixed(2)).join(", ") : "none";
73
+ let filterSummary = "";
74
+ if (filterImpacts.length > 0) filterSummary = `\n Filter impact: ${filterImpacts.map((f) => {
75
+ const parts = [];
76
+ if (f.boosted > 0) parts.push(`+${f.boosted}`);
77
+ if (f.penalized > 0) parts.push(`-${f.penalized}`);
78
+ if (f.passed > 0) parts.push(`=${f.passed}`);
79
+ return `${f.name}: ${parts.join("/")}`;
80
+ }).join(", ")}`;
81
+ logger.info(`[Pipeline] Execution: ${generatorName} produced ${generatedCount} → ${filterCount} filters → ${finalCount} results (top scores: ${scoreDisplay})` + filterSummary + `\n 💡 Inspect: window.skuilder.pipeline`);
82
+ }
83
+ function logResultCards(cards) {}
84
+ /**
85
+ * Log provenance trails for cards.
86
+ * Shows the complete scoring history for each card through the pipeline.
87
+ * Useful for debugging why cards scored the way they did.
88
+ */
89
+ function logCardProvenance(cards, maxCards = 3) {
90
+ const cardsToLog = cards.slice(0, maxCards);
91
+ logger.debug(`[Pipeline] Provenance for top ${cardsToLog.length} cards:`);
92
+ for (const card of cardsToLog) {
93
+ logger.debug(`[Pipeline] ${card.cardId} (final score: ${card.score.toFixed(3)}):`);
94
+ for (const entry of card.provenance) {
95
+ const scoreChange = entry.score.toFixed(3);
96
+ const action = entry.action.padEnd(9);
97
+ logger.debug(`[Pipeline] ${action} ${scoreChange} - ${entry.strategyName}: ${entry.reason}`);
98
+ }
99
+ }
100
+ }
101
+ var Pipeline = class extends ContentNavigator {
102
+ generator;
103
+ filters;
104
+ /**
105
+ * Cached orchestration context. Course config and salt don't change within
106
+ * a page load, so we build the orchestration context once and reuse it on
107
+ * subsequent getWeightedCards() calls (e.g. mid-session replans).
108
+ *
109
+ * This eliminates a remote getCourseConfig() round trip per pipeline run.
110
+ */
111
+ _cachedOrchestration = null;
112
+ /**
113
+ * Hash of the strategy docs this pipeline was assembled from (see
114
+ * versionStamps.ts), set by whoever builds it. Stamped on every run.
115
+ */
116
+ strategyHash;
117
+ /**
118
+ * Persistent tag cache. Maps cardId → tag names.
119
+ *
120
+ * Tags are static within a session (they're set at card generation time),
121
+ * so we cache them across pipeline runs. On replans, many of the same cards
122
+ * reappear — cache hits avoid redundant remote getAppliedTagsBatch() queries.
123
+ */
124
+ _tagCache = /* @__PURE__ */ new Map();
125
+ /**
126
+ * One-shot replan hints. Applied after the filter chain on the next
127
+ * getWeightedCards() call, then cleared.
128
+ */
129
+ _ephemeralHints = null;
130
+ /**
131
+ * The intake valve's clock (see regulators.ts), loaded from strategy state on
132
+ * first use and kept in memory. Writes are chained so a presentation and a
133
+ * run can't race each other's revision.
134
+ */
135
+ _intakeClock = null;
136
+ _intakeClockWrite = Promise.resolve();
137
+ /**
138
+ * Create a new pipeline.
139
+ *
140
+ * @param generator - The generator (or CompositeGenerator) that produces candidates
141
+ * @param filters - Filters to apply sequentially (order doesn't matter for multipliers)
142
+ * @param user - User database interface
143
+ * @param course - Course database interface
144
+ */
145
+ constructor(generator, filters, user, course) {
146
+ super();
147
+ this.generator = generator;
148
+ this.filters = filters;
149
+ this.user = user;
150
+ this.course = course;
151
+ course.getCourseConfig().then((cfg) => {
152
+ logger.debug(`[pipeline] Crated pipeline for ${cfg.name}`);
153
+ }).catch((e) => {
154
+ logger.error(`[pipeline] Failed to lookup courseCfg: ${e}`);
155
+ });
156
+ logPipelineConfig(generator, filters);
157
+ registerPipelineForDebug(this);
158
+ }
159
+ /**
160
+ * Set one-shot hints for the next pipeline run.
161
+ * Consumed after one getWeightedCards() call, then cleared.
162
+ *
163
+ * Overrides ContentNavigator.setEphemeralHints() no-op.
164
+ */
165
+ setEphemeralHints(hints) {
166
+ this._ephemeralHints = hints;
167
+ logger.info(`[Pipeline] Ephemeral hints set: ${JSON.stringify(hints)}`);
168
+ }
169
+ /**
170
+ * Get weighted cards by running generator and applying filters.
171
+ *
172
+ * 1. Build shared context (user ELO, etc.)
173
+ * 2. Get candidates from generator (passing context)
174
+ * 3. Batch hydrate tags for all candidates
175
+ * 4. Apply each filter sequentially
176
+ * 5. Remove zero-score cards
177
+ * 6. Sort by score descending
178
+ * 7. Return top N
179
+ *
180
+ * @param limit - Maximum number of cards to return
181
+ * @returns Cards sorted by score descending
182
+ */
183
+ async getWeightedCards(limit) {
184
+ const t0 = performance.now();
185
+ const context = await this.buildContext();
186
+ const tContext = performance.now();
187
+ const fetchLimit = 500;
188
+ logger.debug(`[Pipeline] Fetching ${fetchLimit} candidates from generator '${this.generator.name}'`);
189
+ const generatorResult = await this.generator.getWeightedCards(fetchLimit, context);
190
+ let cards = generatorResult.cards;
191
+ const tGenerate = performance.now();
192
+ const generatedCount = cards.length;
193
+ this._ephemeralHints = mergeHints([this._ephemeralHints, generatorResult.hints]) ?? null;
194
+ let generatorSummaries;
195
+ if (this.generator.generators) {
196
+ const genMap = /* @__PURE__ */ new Map();
197
+ for (const card of cards) {
198
+ const firstProv = card.provenance[0];
199
+ if (firstProv) {
200
+ const genName = firstProv.strategyName;
201
+ if (!genMap.has(genName)) genMap.set(genName, { cards: [] });
202
+ genMap.get(genName).cards.push(card);
203
+ }
204
+ }
205
+ generatorSummaries = Array.from(genMap.entries()).map(([name, data]) => {
206
+ const reviewCount = data.cards.filter((c) => c.reviewID).length;
207
+ return {
208
+ name,
209
+ cardCount: data.cards.length,
210
+ newCount: data.cards.length - reviewCount,
211
+ reviewCount,
212
+ topScore: Math.max(...data.cards.map((c) => c.score), 0)
213
+ };
214
+ });
215
+ }
216
+ logger.debug(`[Pipeline] Generator returned ${generatedCount} candidates`);
217
+ cards = await this.hydrateTags(cards);
218
+ const tHydrate = performance.now();
219
+ const allCardsBeforeFiltering = [...cards];
220
+ const pendingHints = this._ephemeralHints;
221
+ if (pendingHints?.requireCards?.length) {
222
+ const poolIds = new Set(allCardsBeforeFiltering.map((c) => c.cardId));
223
+ const missingIds = pendingHints.requireCards.filter((p) => !p.includes("*") && !poolIds.has(p));
224
+ if (missingIds.length > 0) {
225
+ const fetchedTags = await this.course.getAppliedTagsBatch(missingIds);
226
+ const courseId = this.course.getCourseID();
227
+ for (const cardId of missingIds) allCardsBeforeFiltering.push({
228
+ cardId,
229
+ courseId,
230
+ score: 1,
231
+ tags: fetchedTags.get(cardId) ?? [],
232
+ provenance: []
233
+ });
234
+ logger.info(`[Pipeline] Pre-fetched ${missingIds.length} required card(s) into pool: ${missingIds.join(", ")}`);
235
+ }
236
+ }
237
+ const prescribedIds = new Set(cards.filter((c) => c.provenance.some((p) => p.strategy === "prescribed")).map((c) => c.cardId));
238
+ const filterImpacts = [];
239
+ const generatedScores = new Map(cards.map((c) => [c.cardId, c.score]));
240
+ const gated = /* @__PURE__ */ new Set();
241
+ for (const filter of this.filters) {
242
+ const beforeCount = cards.length;
243
+ const beforeScores = new Map(cards.map((c) => [c.cardId, c.score]));
244
+ cards = await filter.transform(cards, context);
245
+ let boosted = 0;
246
+ let penalized = 0;
247
+ let passed = 0;
248
+ const removed = beforeCount - cards.length;
249
+ const kind = filter.kind ?? "gate";
250
+ for (const card of cards) {
251
+ const before = beforeScores.get(card.cardId) ?? 0;
252
+ if (card.score > before) boosted++;
253
+ else if (card.score < before) {
254
+ penalized++;
255
+ if (kind === "gate") gated.add(card.cardId);
256
+ } else passed++;
257
+ }
258
+ filterImpacts.push({
259
+ name: filter.name,
260
+ kind,
261
+ boosted,
262
+ penalized,
263
+ passed,
264
+ removed
265
+ });
266
+ if (prescribedIds.size > 0) {
267
+ const survivingIds = new Set(cards.map((c) => c.cardId));
268
+ const killedPrescribed = [...prescribedIds].filter((id) => !survivingIds.has(id));
269
+ const zeroedPrescribed = cards.filter((c) => prescribedIds.has(c.cardId) && c.score === 0).map((c) => c.cardId);
270
+ if (killedPrescribed.length > 0 || zeroedPrescribed.length > 0) {
271
+ logger.info(`[Pipeline] Filter '${filter.name}' impact on prescribed cards: ` + (killedPrescribed.length > 0 ? `removed=[${killedPrescribed.join(", ")}] ` : "") + (zeroedPrescribed.length > 0 ? `zeroed=[${zeroedPrescribed.join(", ")}]` : ""));
272
+ killedPrescribed.forEach((id) => prescribedIds.delete(id));
273
+ }
274
+ }
275
+ logger.debug(`[Pipeline] Filter '${filter.name}': ${beforeScores.size} → ${cards.length} cards (↑${boosted} ↓${penalized} =${passed})`);
276
+ }
277
+ const scoredCards = cards;
278
+ cards = cards.filter((c) => c.score > 0);
279
+ const regulators = await this.regulate(cards, generatedScores, gated);
280
+ const hints = this._ephemeralHints;
281
+ if (hints) {
282
+ this._ephemeralHints = null;
283
+ cards = this.applyHints(cards, hints, allCardsBeforeFiltering);
284
+ }
285
+ cards = diversityRerank(cards);
286
+ cards.sort((a, b) => b.score - a.score);
287
+ const tFilter = performance.now();
288
+ const result = cards.slice(0, limit);
289
+ logger.info(`[Pipeline:timing] total=${(tFilter - t0).toFixed(0)}ms (context=${(tContext - t0).toFixed(0)} generate=${(tGenerate - tContext).toFixed(0)} hydrate=${(tHydrate - tGenerate).toFixed(0)} filter=${(tFilter - tHydrate).toFixed(0)})`);
290
+ const topScores = result.slice(0, 3).map((c) => c.score);
291
+ logExecutionSummary(this.generator.name, generatedCount, this.filters.length, result.length, topScores, filterImpacts);
292
+ logResultCards(result);
293
+ logCardProvenance(result, 3);
294
+ try {
295
+ const courseConfig = await this.course?.getCourseConfig().catch(() => void 0);
296
+ const courseName = courseConfig?.name;
297
+ const report = buildRunReport(this.course?.getCourseID() || "unknown", courseName, this.generator.name, generatorSummaries, generatedCount, filterImpacts, cards, result, context.userElo, hints ?? void 0, scoredCards, regulators);
298
+ const versions = {
299
+ ...this.strategyHash ? { strategies: this.strategyHash } : {},
300
+ ...courseConfig?.contentVersion ? { content: courseConfig.contentVersion } : {}
301
+ };
302
+ captureRun({
303
+ ...report,
304
+ ...Object.keys(versions).length ? { versions } : {}
305
+ });
306
+ } catch (e) {
307
+ logger.debug(`[Pipeline] Failed to capture debug run: ${e}`);
308
+ }
309
+ return { cards: result };
310
+ }
311
+ /**
312
+ * Batch hydrate tags for all cards.
313
+ *
314
+ * Fetches tags for all cards in a single database query and attaches them
315
+ * to the WeightedCard objects. Filters can then use card.tags instead of
316
+ * making individual getAppliedTags() calls.
317
+ *
318
+ * Uses a persistent tag cache across pipeline runs — tags are static within
319
+ * a session, so cards seen in a prior run (e.g. before a replan) don't
320
+ * require a second DB query.
321
+ *
322
+ * @param cards - Cards to hydrate
323
+ * @returns Cards with tags populated
324
+ */
325
+ async hydrateTags(cards) {
326
+ if (cards.length === 0) return cards;
327
+ const uncachedIds = [];
328
+ for (const card of cards) if (!this._tagCache.has(card.cardId)) uncachedIds.push(card.cardId);
329
+ if (uncachedIds.length > 0) {
330
+ const freshTags = await this.course.getAppliedTagsBatch(uncachedIds);
331
+ for (const [cardId, tags] of freshTags) this._tagCache.set(cardId, tags);
332
+ }
333
+ const tagsByCard = /* @__PURE__ */ new Map();
334
+ for (const card of cards) tagsByCard.set(card.cardId, this._tagCache.get(card.cardId) ?? []);
335
+ logTagHydration(cards, tagsByCard);
336
+ return cards.map((card) => ({
337
+ ...card,
338
+ tags: this._tagCache.get(card.cardId) ?? []
339
+ }));
340
+ }
341
+ /**
342
+ * Apply one-shot replan hints to the post-filter card set.
343
+ *
344
+ * Order of operations:
345
+ * 1. Exclude (remove unwanted cards)
346
+ * 2. Boost (multiply scores)
347
+ * 3. Require (inject must-have cards from the full pre-filter pool)
348
+ *
349
+ * @param cards - Post-filter cards (score > 0)
350
+ * @param hints - The ephemeral hints to apply
351
+ * @param allCards - Full pre-filter card pool (for require injection)
352
+ */
353
+ applyHints(cards, hints, allCards) {
354
+ const beforeCount = cards.length;
355
+ if (hints.excludeCards?.length) cards = cards.filter((c) => !hints.excludeCards.some((pat) => globMatch(c.cardId, pat)));
356
+ if (hints.excludeTags?.length) cards = cards.filter((c) => !hints.excludeTags.some((pat) => cardMatchesTagPattern(c, pat)));
357
+ if (hints.boostTags) {
358
+ for (const [pattern, factor] of Object.entries(hints.boostTags)) for (const card of cards) if (cardMatchesTagPattern(card, pattern)) {
359
+ card.score *= factor;
360
+ card.provenance.push({
361
+ strategy: "ephemeralHint",
362
+ strategyId: "ephemeral-hint",
363
+ strategyName: hints._label ? `Replan Hint (${hints._label})` : "Replan Hint",
364
+ action: "boosted",
365
+ score: card.score,
366
+ reason: `boostTag ${pattern} ×${factor}`
367
+ });
368
+ }
369
+ }
370
+ if (hints.boostCards) {
371
+ for (const [pattern, factor] of Object.entries(hints.boostCards)) for (const card of cards) if (globMatch(card.cardId, pattern)) {
372
+ card.score *= factor;
373
+ card.provenance.push({
374
+ strategy: "ephemeralHint",
375
+ strategyId: "ephemeral-hint",
376
+ strategyName: hints._label ? `Replan Hint (${hints._label})` : "Replan Hint",
377
+ action: "boosted",
378
+ score: card.score,
379
+ reason: `boostCard ${pattern} ×${factor}`
380
+ });
381
+ }
382
+ }
383
+ const cardIds = new Set(cards.map((c) => c.cardId));
384
+ const cardMap = new Map(cards.map((c) => [c.cardId, c]));
385
+ const hintLabel = hints._label ? `Replan Hint (${hints._label})` : "Replan Hint";
386
+ const applyRequirement = (card, reason) => {
387
+ const mandatoryScore = Number.POSITIVE_INFINITY;
388
+ const existing = cardMap.get(card.cardId);
389
+ if (existing) {
390
+ if (existing.score < mandatoryScore) {
391
+ existing.score = mandatoryScore;
392
+ existing.provenance.push({
393
+ strategy: "ephemeralHint",
394
+ strategyId: "ephemeral-hint",
395
+ strategyName: hintLabel,
396
+ action: "boosted",
397
+ score: mandatoryScore,
398
+ reason: `${reason} (upgrade to mandatory score)`
399
+ });
400
+ }
401
+ } else {
402
+ cards.push({
403
+ ...card,
404
+ score: mandatoryScore,
405
+ provenance: [...card.provenance, {
406
+ strategy: "ephemeralHint",
407
+ strategyId: "ephemeral-hint",
408
+ strategyName: hintLabel,
409
+ action: "boosted",
410
+ score: mandatoryScore,
411
+ reason
412
+ }]
413
+ });
414
+ cardIds.add(card.cardId);
415
+ cardMap.set(card.cardId, cards[cards.length - 1]);
416
+ }
417
+ };
418
+ if (hints.requireCards?.length) for (const pattern of hints.requireCards) {
419
+ for (const cardId of cardIds) if (globMatch(cardId, pattern)) applyRequirement(cardMap.get(cardId), `requireCard ${pattern}`);
420
+ for (const card of allCards) if (globMatch(card.cardId, pattern)) applyRequirement(card, `requireCard ${pattern}`);
421
+ }
422
+ if (hints.requireTags?.length) for (const pattern of hints.requireTags) {
423
+ for (const cardId of cardIds) {
424
+ const card = cardMap.get(cardId);
425
+ if (cardMatchesTagPattern(card, pattern)) applyRequirement(card, `requireTag ${pattern}`);
426
+ }
427
+ for (const card of allCards) if (cardMatchesTagPattern(card, pattern)) applyRequirement(card, `requireTag ${pattern}`);
428
+ }
429
+ logger.info(`[Pipeline] Hints applied: ${beforeCount} → ${cards.length} cards`);
430
+ return cards;
431
+ }
432
+ /**
433
+ * The regulator stage: measure each class's pressure and scale it.
434
+ *
435
+ * - Review mass: every due review's SRS urgency times the filters' net
436
+ * effect on it.
437
+ * - Intake: servable hours since a new card was presented, applied only to
438
+ * eligible new cards (no gate penalized them). With none eligible, the
439
+ * clock freezes.
440
+ *
441
+ * Mutates `cards` in place; returns the readings for the run report.
442
+ */
443
+ async regulate(cards, generatedScores, gated) {
444
+ const config = DEFAULT_REGULATOR_CONFIG;
445
+ const reviews = cards.filter((c) => c.reviewID);
446
+ const newCards = cards.filter((c) => !c.reviewID);
447
+ const eligibleNew = newCards.filter((c) => !gated.has(c.cardId));
448
+ const mass = reviewMassReading(reviews, generatedScores, config.reviewMass);
449
+ applyReading(reviews, mass);
450
+ noteReviewPressure(this.course.getCourseID(), {
451
+ mass: mass.urgency,
452
+ healthyMass: config.reviewMass.healthyMass,
453
+ rate: config.reviewMass.rate,
454
+ multiplier: mass.multiplier
455
+ });
456
+ const now = Date.now();
457
+ const clock = await this.loadIntakeClock(now);
458
+ const stepped = stepIntakeClock(clock, now, eligibleNew.length);
459
+ if (stepped !== clock) this.saveIntakeClock(stepped);
460
+ const intake = intakeReading(stepped, now, {
461
+ eligibleNew: eligibleNew.length,
462
+ newCandidates: newCards.length
463
+ }, config.intake);
464
+ applyReading(eligibleNew, intake);
465
+ logger.info(`[Pipeline:regulators] review mass ${mass.urgency.toFixed(1)} over ${reviews.length} due → ×${mass.multiplier.toFixed(2)}; intake ${intake.urgency.toFixed(1)}h, ${eligibleNew.length}/${newCards.length} new eligible → ×${intake.multiplier.toFixed(2)}`);
466
+ return [mass, intake];
467
+ }
468
+ /**
469
+ * A card was presented. A new card's first presentation discharges the
470
+ * intake valve: its clock restarts. Called by the SessionController.
471
+ */
472
+ notePresented(card) {
473
+ if (card.status !== "new" || card.courseId !== this.course?.getCourseID()) return;
474
+ this.saveIntakeClock(resetIntakeClock(Date.now()));
475
+ }
476
+ async loadIntakeClock(nowMs) {
477
+ if (this._intakeClock) return this._intakeClock;
478
+ let stored = null;
479
+ try {
480
+ stored = await this.user.getStrategyState(this.course.getCourseID(), INTAKE_CLOCK_KEY);
481
+ } catch (e) {
482
+ logger.warn(`[Pipeline:regulators] Could not read the intake clock: ${e}`);
483
+ }
484
+ if (stored) this._intakeClock = stored;
485
+ else this.saveIntakeClock(resetIntakeClock(nowMs));
486
+ return this._intakeClock;
487
+ }
488
+ saveIntakeClock(state) {
489
+ this._intakeClock = state;
490
+ const courseId = this.course.getCourseID();
491
+ this._intakeClockWrite = this._intakeClockWrite.then(() => this.user.putStrategyState(courseId, INTAKE_CLOCK_KEY, state)).catch((e) => logger.warn(`[Pipeline:regulators] Could not save the intake clock: ${e}`));
492
+ }
493
+ /**
494
+ * Build shared context for generator and filters.
495
+ *
496
+ * Called once per getWeightedCards() invocation.
497
+ * Contains data that the generator and multiple filters might need.
498
+ *
499
+ * The context satisfies both GeneratorContext and FilterContext interfaces.
500
+ */
501
+ async buildContext() {
502
+ let userElo = 1e3;
503
+ let userCourseElo;
504
+ try {
505
+ userCourseElo = toCourseElo((await this.user.getCourseRegDoc(this.course.getCourseID())).elo);
506
+ userElo = userCourseElo.global.score;
507
+ } catch (e) {
508
+ logger.debug(`[Pipeline] Could not get user ELO, using default: ${e}`);
509
+ }
510
+ if (!this._cachedOrchestration) this._cachedOrchestration = await createOrchestrationContext(this.user, this.course);
511
+ const orchestration = this._cachedOrchestration;
512
+ return {
513
+ user: this.user,
514
+ course: this.course,
515
+ userElo,
516
+ ...userCourseElo ? { userCourseElo } : {},
517
+ orchestration
518
+ };
519
+ }
520
+ /**
521
+ * Get the course ID for this pipeline.
522
+ */
523
+ getCourseID() {
524
+ return this.course.getCourseID();
525
+ }
526
+ /**
527
+ * Get orchestration context for outcome recording.
528
+ */
529
+ async getOrchestrationContext() {
530
+ return createOrchestrationContext(this.user, this.course);
531
+ }
532
+ /**
533
+ * Get IDs of all strategies in this pipeline.
534
+ * Used to record which strategies contributed to an outcome.
535
+ */
536
+ getStrategyIds() {
537
+ const ids = [];
538
+ const extractId = (obj) => {
539
+ if (obj.strategyId) return obj.strategyId;
540
+ return null;
541
+ };
542
+ const genId = extractId(this.generator);
543
+ if (genId) ids.push(genId);
544
+ if (this.generator.generators && Array.isArray(this.generator.generators)) this.generator.generators.forEach((g) => {
545
+ const subId = extractId(g);
546
+ if (subId) ids.push(subId);
547
+ });
548
+ for (const filter of this.filters) {
549
+ const fId = extractId(filter);
550
+ if (fId) ids.push(fId);
551
+ }
552
+ return [...new Set(ids)];
553
+ }
554
+ /**
555
+ * Get the user's per-tag ELO data for specified tags (or all tags).
556
+ * Useful for diagnosing why hierarchy gates are open/closed.
557
+ */
558
+ async getTagEloStatus(tagFilter) {
559
+ const courseElo = toCourseElo((await this.user.getCourseRegDoc(this.course.getCourseID())).elo);
560
+ const result = {};
561
+ if (!tagFilter) for (const [tag, data] of Object.entries(courseElo.tags)) result[tag] = {
562
+ score: data.score,
563
+ count: data.count
564
+ };
565
+ else {
566
+ const patterns = Array.isArray(tagFilter) ? tagFilter : [tagFilter];
567
+ for (const pattern of patterns) {
568
+ const regex = globToRegex(pattern);
569
+ for (const [tag, data] of Object.entries(courseElo.tags)) if (regex.test(tag)) result[tag] = {
570
+ score: data.score,
571
+ count: data.count
572
+ };
573
+ }
574
+ }
575
+ return result;
576
+ }
577
+ /**
578
+ * Commit-free forecast: score the user's full card space through the filter
579
+ * chain and return the cards that are currently *reachable* (score >=
580
+ * threshold), optionally nudged by caller-supplied hints and/or restricted
581
+ * to cards the user hasn't seen yet.
582
+ *
583
+ * This is a GENERIC primitive — it returns scored, tag-hydrated cards and
584
+ * stops there. It has no knowledge of any particular tag convention; callers
585
+ * decide what the surviving cards mean (e.g. filter to their own "intro"
586
+ * tag family). Nothing is written and no session is started.
587
+ *
588
+ * The optional `hints` are the "out-of-band kick": they run through the same
589
+ * {@link applyHints} path a live replan uses, so the two semantics carry over —
590
+ * - `boostTags`/`boostCards` reweight *within* gating (a gated score-0 card
591
+ * stays out), and
592
+ * - `requireTags`/`requireCards` inject from the full pre-filter pool,
593
+ * *bypassing* gating (use when you want a card regardless of reachability).
594
+ * Note `unseenOnly` is applied LAST, so it can drop a `require`d card that the
595
+ * user has already seen — pass `unseenOnly: false` if that matters.
596
+ *
597
+ * Cost note: like {@link diagnoseCardSpace}, this scans every card through the
598
+ * filters, so it's heavier than a normal replan. Intended for one-shot
599
+ * out-of-band use (e.g. a session-end "what's next" snapshot), not the hot path.
600
+ *
601
+ * @param opts.hints Optional ephemeral hints to apply after the filter chain.
602
+ * @param opts.unseenOnly Only return cards the user hasn't encountered (default true).
603
+ * @param opts.threshold Min score to count as reachable (default 0.10).
604
+ * @param opts.limit Optional cap on results (already sorted desc).
605
+ */
606
+ async forecast(opts) {
607
+ const threshold = opts?.threshold ?? .1;
608
+ const unseenOnly = opts?.unseenOnly ?? true;
609
+ const courseId = this.course.getCourseID();
610
+ let cards = (await this.course.getAllCardIds()).map((cardId) => ({
611
+ cardId,
612
+ courseId,
613
+ score: 1,
614
+ provenance: []
615
+ }));
616
+ cards = await this.hydrateTags(cards);
617
+ const fullPool = cards.slice();
618
+ const context = await this.buildContext();
619
+ for (const filter of this.forecastFilters()) cards = await filter.transform(cards, context);
620
+ if (opts?.hints) cards = this.applyHints(cards, opts.hints, fullPool);
621
+ cards = cards.filter((c) => c.score >= threshold);
622
+ if (unseenOnly) {
623
+ let encountered;
624
+ try {
625
+ encountered = new Set(await this.user.getSeenCards(courseId));
626
+ } catch {
627
+ encountered = /* @__PURE__ */ new Set();
628
+ }
629
+ cards = cards.filter((c) => !encountered.has(c.cardId));
630
+ }
631
+ cards.sort((a, b) => b.score - a.score);
632
+ return opts?.limit ? cards.slice(0, opts.limit) : cards;
633
+ }
634
+ /**
635
+ * The filters a forecast or card-space scan applies. Those start every card at
636
+ * 1.0 without a generator, so they skip `liveOnly` filters (ELO distance),
637
+ * which only make sense against generator scores.
638
+ */
639
+ forecastFilters() {
640
+ return this.filters.filter((f) => !f.liveOnly);
641
+ }
642
+ /**
643
+ * Scan every card in the course through the filter chain and report
644
+ * how many are "well indicated" (score >= threshold) for the current user.
645
+ *
646
+ * Also reports how many well-indicated cards the user has NOT yet encountered.
647
+ *
648
+ * Exposed via `window.skuilder.pipeline.diagnoseCardSpace()`.
649
+ */
650
+ async diagnoseCardSpace(opts) {
651
+ const THRESHOLD = opts?.threshold ?? .1;
652
+ const t0 = performance.now();
653
+ const allCardIds = await this.course.getAllCardIds();
654
+ let cards = allCardIds.map((cardId) => ({
655
+ cardId,
656
+ courseId: this.course.getCourseID(),
657
+ score: 1,
658
+ provenance: []
659
+ }));
660
+ cards = await this.hydrateTags(cards);
661
+ const context = await this.buildContext();
662
+ const filterBreakdown = [];
663
+ for (const filter of this.forecastFilters()) {
664
+ cards = await filter.transform(cards, context);
665
+ const wi = cards.filter((c) => c.score >= THRESHOLD).length;
666
+ filterBreakdown.push({
667
+ name: filter.name,
668
+ wellIndicated: wi
669
+ });
670
+ }
671
+ const wellIndicated = cards.filter((c) => c.score >= THRESHOLD);
672
+ const wellIndicatedIds = new Set(wellIndicated.map((c) => c.cardId));
673
+ let encounteredIds;
674
+ try {
675
+ const courseId = this.course.getCourseID();
676
+ const seenCards = await this.user.getSeenCards(courseId);
677
+ encounteredIds = new Set(seenCards);
678
+ } catch {
679
+ encounteredIds = /* @__PURE__ */ new Set();
680
+ }
681
+ const wellIndicatedNew = wellIndicated.filter((c) => !encounteredIds.has(c.cardId));
682
+ const byType = /* @__PURE__ */ new Map();
683
+ for (const card of cards) {
684
+ const type = card.cardId.split("-")[1] || "unknown";
685
+ if (!byType.has(type)) byType.set(type, {
686
+ total: 0,
687
+ wellIndicated: 0,
688
+ new: 0
689
+ });
690
+ const entry = byType.get(type);
691
+ entry.total++;
692
+ if (card.score >= THRESHOLD) {
693
+ entry.wellIndicated++;
694
+ if (!encounteredIds.has(card.cardId)) entry.new++;
695
+ }
696
+ }
697
+ const elapsed = performance.now() - t0;
698
+ const result = {
699
+ totalCards: allCardIds.length,
700
+ threshold: THRESHOLD,
701
+ wellIndicated: wellIndicatedIds.size,
702
+ encountered: encounteredIds.size,
703
+ wellIndicatedNew: wellIndicatedNew.length,
704
+ byType: Object.fromEntries(byType),
705
+ filterBreakdown,
706
+ elapsedMs: Math.round(elapsed)
707
+ };
708
+ logger.print(`[Pipeline:diagnose] Card space scan (${result.elapsedMs}ms):`);
709
+ logger.print(`[Pipeline:diagnose] Total cards: ${result.totalCards}`);
710
+ logger.print(`[Pipeline:diagnose] Well-indicated (score >= ${THRESHOLD}): ${result.wellIndicated}`);
711
+ logger.print(`[Pipeline:diagnose] Encountered: ${result.encountered}`);
712
+ logger.print(`[Pipeline:diagnose] Well-indicated & new: ${result.wellIndicatedNew}`);
713
+ logger.print(`[Pipeline:diagnose] By type:`);
714
+ for (const [type, counts] of byType) logger.print(`[Pipeline:diagnose] ${type}: ${counts.wellIndicated}/${counts.total} well-indicated, ${counts.new} new`);
715
+ logger.print(`[Pipeline:diagnose] After each filter:`);
716
+ for (const fb of filterBreakdown) logger.print(`[Pipeline:diagnose] ${fb.name}: ${fb.wellIndicated} well-indicated`);
717
+ return result;
718
+ }
719
+ };
720
+ //#endregion
721
+ export { Pipeline, mergeHints };
722
+
723
+ //# sourceMappingURL=Pipeline.mjs.map