@vue-skuilder/db 0.2.35 → 0.2.37

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 (263) 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-BteiDpxH.d.ts → contentSource-D_E7JaxR.d.ts} +1 -1
  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} +6413 -7738
  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 +694 -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-C_QWzHf-.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} +1 -1
  87. package/dist/diagnostics/index.d.ts +3 -3
  88. package/dist/diagnostics/index.mjs +7 -1042
  89. package/dist/diagnostics/loader.mjs +151 -0
  90. package/dist/diagnostics/loader.mjs.map +1 -0
  91. package/dist/diagnostics/pipeline.mjs +161 -0
  92. package/dist/diagnostics/pipeline.mjs.map +1 -0
  93. package/dist/diagnostics/tagElo.mjs +177 -0
  94. package/dist/diagnostics/tagElo.mjs.map +1 -0
  95. package/dist/diagnostics/text.mjs +174 -0
  96. package/dist/diagnostics/text.mjs.map +1 -0
  97. package/dist/factory.mjs +70 -0
  98. package/dist/factory.mjs.map +1 -0
  99. package/dist/impl/common/BaseUserDB.mjs +1115 -0
  100. package/dist/impl/common/BaseUserDB.mjs.map +1 -0
  101. package/dist/impl/common/userDBHelpers.mjs +49 -0
  102. package/dist/impl/common/userDBHelpers.mjs.map +1 -0
  103. package/dist/impl/common/userDBKeys.mjs +45 -0
  104. package/dist/impl/common/userDBKeys.mjs.map +1 -0
  105. package/dist/impl/couch/CouchDBSyncStrategy.mjs +272 -0
  106. package/dist/impl/couch/CouchDBSyncStrategy.mjs.map +1 -0
  107. package/dist/impl/couch/CourseSyncService.mjs +320 -0
  108. package/dist/impl/couch/CourseSyncService.mjs.map +1 -0
  109. package/dist/impl/couch/PouchDataLayerProvider.mjs +89 -0
  110. package/dist/impl/couch/PouchDataLayerProvider.mjs.map +1 -0
  111. package/dist/impl/couch/adminDB.mjs +61 -0
  112. package/dist/impl/couch/adminDB.mjs.map +1 -0
  113. package/dist/impl/couch/auth.mjs +33 -0
  114. package/dist/impl/couch/auth.mjs.map +1 -0
  115. package/dist/impl/couch/classroomDB.mjs +227 -0
  116. package/dist/impl/couch/classroomDB.mjs.map +1 -0
  117. package/dist/impl/couch/clientCache.mjs +15 -0
  118. package/dist/impl/couch/clientCache.mjs.map +1 -0
  119. package/dist/impl/couch/courseAPI.mjs +197 -0
  120. package/dist/impl/couch/courseAPI.mjs.map +1 -0
  121. package/dist/impl/couch/courseDB.mjs +735 -0
  122. package/dist/impl/couch/courseDB.mjs.map +1 -0
  123. package/dist/impl/couch/courseLookupDB.mjs +94 -0
  124. package/dist/impl/couch/courseLookupDB.mjs.map +1 -0
  125. package/dist/impl/couch/{index.js → index.cjs} +7003 -10358
  126. package/dist/impl/couch/index.cjs.map +1 -0
  127. package/dist/impl/couch/index.d.ts +33 -5
  128. package/dist/impl/couch/index.mjs +152 -12147
  129. package/dist/impl/couch/index.mjs.map +1 -1
  130. package/dist/impl/couch/pouchdb-setup.mjs +15 -0
  131. package/dist/impl/couch/pouchdb-setup.mjs.map +1 -0
  132. package/dist/impl/couch/updateQueue.mjs +101 -0
  133. package/dist/impl/couch/updateQueue.mjs.map +1 -0
  134. package/dist/impl/couch/user-course-relDB.mjs +55 -0
  135. package/dist/impl/couch/user-course-relDB.mjs.map +1 -0
  136. package/dist/impl/static/NoOpSyncStrategy.mjs +49 -0
  137. package/dist/impl/static/NoOpSyncStrategy.mjs.map +1 -0
  138. package/dist/impl/static/StaticDataLayerProvider.mjs +94 -0
  139. package/dist/impl/static/StaticDataLayerProvider.mjs.map +1 -0
  140. package/dist/impl/static/StaticDataUnpacker.mjs +311 -0
  141. package/dist/impl/static/StaticDataUnpacker.mjs.map +1 -0
  142. package/dist/impl/static/courseDB.mjs +368 -0
  143. package/dist/impl/static/courseDB.mjs.map +1 -0
  144. package/dist/impl/static/coursesDB.mjs +38 -0
  145. package/dist/impl/static/coursesDB.mjs.map +1 -0
  146. package/dist/impl/static/{index.js → index.cjs} +2486 -5993
  147. package/dist/impl/static/index.cjs.map +1 -0
  148. package/dist/impl/static/index.d.ts +4 -4
  149. package/dist/impl/static/index.mjs +6 -10741
  150. package/dist/{index-C745YB_6.d.ts → index-BLDpFYG3.d.ts} +1 -1
  151. package/dist/{index.js → index.cjs} +14190 -14249
  152. package/dist/index.cjs.map +1 -0
  153. package/dist/index.d.ts +12 -23
  154. package/dist/index.mjs +38 -16937
  155. package/dist/pouch/{index.js → index.cjs} +5 -1
  156. package/dist/pouch/index.cjs.map +1 -0
  157. package/dist/pouch/index.mjs +2 -19
  158. package/dist/study/ItemQueue.mjs +95 -0
  159. package/dist/study/ItemQueue.mjs.map +1 -0
  160. package/dist/study/MixerDebugger.mjs +303 -0
  161. package/dist/study/MixerDebugger.mjs.map +1 -0
  162. package/dist/study/SessionController.mjs +1187 -0
  163. package/dist/study/SessionController.mjs.map +1 -0
  164. package/dist/study/SessionDebugger.mjs +271 -0
  165. package/dist/study/SessionDebugger.mjs.map +1 -0
  166. package/dist/study/SessionOverlay.mjs +407 -0
  167. package/dist/study/SessionOverlay.mjs.map +1 -0
  168. package/dist/study/SourceMixer.mjs +45 -0
  169. package/dist/study/SourceMixer.mjs.map +1 -0
  170. package/dist/study/SpacedRepetition.mjs +108 -0
  171. package/dist/study/SpacedRepetition.mjs.map +1 -0
  172. package/dist/study/TagFilteredContentSource.mjs +136 -0
  173. package/dist/study/TagFilteredContentSource.mjs.map +1 -0
  174. package/dist/study/services/CardHydrationService.mjs +172 -0
  175. package/dist/study/services/CardHydrationService.mjs.map +1 -0
  176. package/dist/study/services/EloService.mjs +217 -0
  177. package/dist/study/services/EloService.mjs.map +1 -0
  178. package/dist/study/services/ResponseProcessor.mjs +190 -0
  179. package/dist/study/services/ResponseProcessor.mjs.map +1 -0
  180. package/dist/study/services/SrsService.mjs +49 -0
  181. package/dist/study/services/SrsService.mjs.map +1 -0
  182. package/dist/study/services/tagRecent.mjs +65 -0
  183. package/dist/study/services/tagRecent.mjs.map +1 -0
  184. package/dist/{types-DF0JuPbs.d.ts → types-DChCz22D.d.ts} +1 -1
  185. package/dist/{types-legacy-DdVjg81H.d.cts → types-legacy-fT5Y1Wuy.d.ts} +1 -1
  186. package/dist/userDBKeys-ne1g4Xuq.d.ts +16 -0
  187. package/dist/util/Loggable.mjs +14 -0
  188. package/dist/util/Loggable.mjs.map +1 -0
  189. package/dist/util/dataDirectory.mjs +47 -0
  190. package/dist/util/dataDirectory.mjs.map +1 -0
  191. package/dist/util/logger.mjs +86 -0
  192. package/dist/util/logger.mjs.map +1 -0
  193. package/dist/util/migrator/FileSystemAdapter.mjs +18 -0
  194. package/dist/util/migrator/FileSystemAdapter.mjs.map +1 -0
  195. package/dist/util/migrator/StaticToCouchDBMigrator.mjs +428 -0
  196. package/dist/util/migrator/StaticToCouchDBMigrator.mjs.map +1 -0
  197. package/dist/util/migrator/types.mjs +11 -0
  198. package/dist/util/migrator/types.mjs.map +1 -0
  199. package/dist/util/migrator/validation.mjs +334 -0
  200. package/dist/util/migrator/validation.mjs.map +1 -0
  201. package/dist/util/packer/CouchDBToStaticPacker.mjs +438 -0
  202. package/dist/util/packer/CouchDBToStaticPacker.mjs.map +1 -0
  203. package/dist/util/packer/{index.js → index.cjs} +73 -9
  204. package/dist/util/packer/index.cjs.map +1 -0
  205. package/dist/util/packer/index.d.ts +3 -3
  206. package/dist/util/packer/index.mjs +2 -537
  207. package/eslint.config.mjs +9 -1
  208. package/package.json +25 -13
  209. package/rolldown.config.mjs +44 -0
  210. package/src/core/UserDBDebugger.ts +47 -46
  211. package/src/core/navigators/Pipeline.ts +10 -10
  212. package/src/core/navigators/PipelineDebugger.ts +55 -55
  213. package/src/core/navigators/filters/eloDistance.ts +1 -1
  214. package/src/core/navigators/generators/elo.ts +5 -1
  215. package/src/core/navigators/generators/prescribed.ts +42 -16
  216. package/src/core/navigators/index.ts +9 -3
  217. package/src/factory.ts +10 -1
  218. package/src/impl/common/BaseUserDB.ts +16 -5
  219. package/src/impl/common/index.ts +2 -0
  220. package/src/impl/common/userDBHelpers.ts +4 -58
  221. package/src/impl/common/userDBKeys.ts +64 -0
  222. package/src/impl/couch/CourseSyncService.ts +130 -20
  223. package/src/impl/couch/PouchDataLayerProvider.ts +14 -1
  224. package/src/impl/couch/courseAPI.ts +26 -12
  225. package/src/impl/couch/courseDB.ts +35 -15
  226. package/src/impl/couch/index.ts +18 -23
  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/tests/impl/courseSync.test.ts +139 -0
  235. package/tsup.config.ts +24 -21
  236. package/dist/SyncStrategy-BXliog1m.d.cts +0 -116
  237. package/dist/classroomDB-DLTtLZct.d.cts +0 -86
  238. package/dist/contentSource-FQZcZopC.d.cts +0 -2007
  239. package/dist/core/index.d.cts +0 -521
  240. package/dist/core/index.js.map +0 -1
  241. package/dist/core/index.mjs.map +0 -1
  242. package/dist/dataLayerProvider-3y21KtF-.d.cts +0 -61
  243. package/dist/diagnostics/index.d.cts +0 -561
  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-BIum9Ue2.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-BcWVH4ww.d.cts +0 -58
  258. package/dist/types-legacy-DdVjg81H.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
  263. /package/dist/diagnostics/{index.js.map → index.cjs.map} +0 -0
@@ -0,0 +1,407 @@
1
+ import "../_virtual/_rolldown/runtime.mjs";
2
+ import { logger } from "../util/logger.mjs";
3
+ //#region src/study/SessionOverlay.ts
4
+ let activeController = null;
5
+ /** Called by SessionController's constructor. Pass `null` to deregister. */
6
+ function registerActiveController(controller) {
7
+ activeController = controller;
8
+ }
9
+ function getActiveController() {
10
+ return activeController;
11
+ }
12
+ const OVERLAY_ID = "skuilder-session-overlay";
13
+ const POLL_MS = 300;
14
+ /**
15
+ * Cap on how many cards a queue lists by default. Queues at or below this show
16
+ * in full; larger ones show the first INLINE_THRESHOLD then a clickable
17
+ * "… +N more" affordance that expands to the full list (and back).
18
+ */
19
+ const INLINE_THRESHOLD = 5;
20
+ /** Braille spinner frames, advanced once per render tick (≈POLL_MS cadence). */
21
+ const SPINNER_FRAMES = [
22
+ "⠋",
23
+ "⠙",
24
+ "⠹",
25
+ "⠸",
26
+ "⠼",
27
+ "⠴",
28
+ "⠦",
29
+ "⠧",
30
+ "⠇",
31
+ "⠏"
32
+ ];
33
+ let spinnerFrame = 0;
34
+ let overlayEl = null;
35
+ let pollHandle = null;
36
+ /**
37
+ * Most recent snapshot rendered, retained so the click-to-copy button can
38
+ * serialise exactly what is on screen at click time (decoupled from the poll).
39
+ */
40
+ let lastSnapshot = null;
41
+ /** Epoch ms until which the copy button shows its "copied" confirmation. */
42
+ let copyFlashUntil = 0;
43
+ /**
44
+ * When minified, the overlay collapses to just its header bar (title + copy +
45
+ * restore button), suppressing all body sections. The poll keeps running so
46
+ * `lastSnapshot` — and therefore the copy button — stays current underneath.
47
+ */
48
+ let minified = false;
49
+ /** Expansion state for collapsible (large) lists, preserved across re-renders. */
50
+ const expanded = {
51
+ supplyQ: false,
52
+ failedQ: false,
53
+ drawn: false
54
+ };
55
+ /**
56
+ * Toggle the pinned overlay on/off. No-ops (with a console hint) when there is
57
+ * no DOM, so it is safe to call from any host environment.
58
+ */
59
+ function toggleSessionOverlay() {
60
+ if (typeof document === "undefined") {
61
+ logger.print("[Session Overlay] No DOM available (non-browser host); overlay unavailable.");
62
+ return;
63
+ }
64
+ if (overlayEl) {
65
+ teardown();
66
+ logger.print("[Session Overlay] Hidden.");
67
+ } else {
68
+ mount();
69
+ logger.print("[Session Overlay] Shown. Toggle off with window.skuilder.session.dbgOverlay().");
70
+ }
71
+ }
72
+ function mount() {
73
+ minified = false;
74
+ overlayEl = document.createElement("div");
75
+ overlayEl.id = OVERLAY_ID;
76
+ Object.assign(overlayEl.style, {
77
+ position: "fixed",
78
+ top: "8px",
79
+ left: "8px",
80
+ zIndex: "2147483647",
81
+ maxWidth: "320px",
82
+ maxHeight: "90vh",
83
+ overflowY: "auto",
84
+ padding: "8px 10px",
85
+ background: "rgba(17, 24, 39, 0.92)",
86
+ color: "#e5e7eb",
87
+ font: "11px/1.4 ui-monospace, SFMono-Regular, Menlo, monospace",
88
+ borderRadius: "6px",
89
+ boxShadow: "0 4px 16px rgba(0,0,0,0.4)",
90
+ pointerEvents: "auto",
91
+ userSelect: "none"
92
+ });
93
+ document.body.appendChild(overlayEl);
94
+ render();
95
+ pollHandle = setInterval(render, POLL_MS);
96
+ }
97
+ function teardown() {
98
+ if (pollHandle !== null) {
99
+ clearInterval(pollHandle);
100
+ pollHandle = null;
101
+ }
102
+ if (overlayEl?.parentNode) overlayEl.parentNode.removeChild(overlayEl);
103
+ overlayEl = null;
104
+ }
105
+ function render() {
106
+ if (!overlayEl) return;
107
+ spinnerFrame++;
108
+ const ctrl = getActiveController();
109
+ if (!ctrl) {
110
+ lastSnapshot = null;
111
+ overlayEl.innerHTML = headerHtml() + (minified ? "" : `<div style="opacity:.65">No active session.</div>`);
112
+ attachHandlers();
113
+ return;
114
+ }
115
+ const s = ctrl.getDebugSnapshot();
116
+ lastSnapshot = s;
117
+ if (minified) {
118
+ overlayEl.innerHTML = headerHtml();
119
+ attachHandlers();
120
+ return;
121
+ }
122
+ overlayEl.innerHTML = headerHtml() + replanHtml(s) + metaHtml(s) + hintsHtml(s.sessionHints) + backlogHtml(s.reviewBacklog) + strategyPressureHtml(s.strategyPressure) + queueHtml("supplyQ", "supplyQ", s.supplyQ) + queueHtml("failedQ", "failedQ", s.failedQ) + drawnHtml("drawn", s.drawnCards);
123
+ attachHandlers();
124
+ }
125
+ /** (Re-)bind click handlers after each innerHTML rewrite. */
126
+ function attachHandlers() {
127
+ if (!overlayEl) return;
128
+ overlayEl.querySelectorAll("[data-q]").forEach((el) => {
129
+ el.onclick = () => {
130
+ const key = el.dataset.q;
131
+ if (!key) return;
132
+ expanded[key] = !expanded[key];
133
+ render();
134
+ };
135
+ });
136
+ const copyBtn = overlayEl.querySelector("[data-copy]");
137
+ if (copyBtn) copyBtn.onclick = (ev) => {
138
+ ev.stopPropagation();
139
+ copySnapshot();
140
+ };
141
+ const minBtn = overlayEl.querySelector("[data-min]");
142
+ if (minBtn) minBtn.onclick = (ev) => {
143
+ ev.stopPropagation();
144
+ minified = !minified;
145
+ render();
146
+ };
147
+ }
148
+ /** Serialise the on-screen snapshot to the clipboard, with a transient flash. */
149
+ function copySnapshot() {
150
+ const text = snapshotToText(lastSnapshot);
151
+ const flash = () => {
152
+ copyFlashUntil = Date.now() + 1200;
153
+ render();
154
+ };
155
+ const clip = typeof navigator !== "undefined" ? navigator.clipboard : void 0;
156
+ if (clip?.writeText) clip.writeText(text).then(flash, (err) => {
157
+ logger.warn(`[Session Overlay] Clipboard write failed: ${String(err)}`);
158
+ });
159
+ else logger.print(`[Session Overlay] Clipboard unavailable; snapshot follows:\n${text}`);
160
+ }
161
+ function headerHtml() {
162
+ const flashing = Date.now() < copyFlashUntil;
163
+ return `<div style="font-weight:600;color:#93c5fd;margin-bottom:${minified ? 0 : 4}px">${`<span data-copy style="cursor:pointer;float:right;font-weight:400;color:${flashing ? "#86efac" : "#93c5fd"};border:1px solid currentColor;border-radius:4px;padding:0 4px;line-height:1.3">${flashing ? "✓ copied" : "⎘ copy"}</span>`}${`<span data-min title="${minified ? "Restore" : "Minify"}" style="cursor:pointer;float:right;font-weight:400;color:#93c5fd;border:1px solid currentColor;border-radius:4px;padding:0 5px;margin-right:4px;line-height:1.3">${minified ? "▢" : "—"}</span>`}⚙ SessionController</div>`;
164
+ }
165
+ function replanHtml(s) {
166
+ if (!s.replanActive) return `<div style="margin-bottom:6px;opacity:.45">○ idle</div>`;
167
+ return `<div style="margin-bottom:6px;color:#fde047">${SPINNER_FRAMES[spinnerFrame % SPINNER_FRAMES.length]} replanning <span style="opacity:.85">[${esc(s.replanLabel ?? "(auto)")}]</span></div>`;
168
+ }
169
+ function metaHtml(s) {
170
+ return `<div style="margin-bottom:6px">${[
171
+ `time ${formatTime(s.secondsRemaining)}${s.hasCardGuarantee ? ` · <span style="color:#fbbf24">guarantee ${s.minCardsGuarantee}</span>` : ""}`,
172
+ `well-indicated left: ${s.wellIndicatedRemaining}`,
173
+ `current: ${s.currentCard ? esc(s.currentCard) : "<span style=\"opacity:.6\">—</span>"}`
174
+ ].map((r) => `<div>${r}</div>`).join("")}</div>`;
175
+ }
176
+ function hintsHtml(h) {
177
+ const parts = [];
178
+ if (h) {
179
+ if (h.boostTags && Object.keys(h.boostTags).length) parts.push(`boost: ` + Object.entries(h.boostTags).map(([k, v]) => `${esc(k)}<span style="opacity:.6">×${v}</span>`).join(", "));
180
+ if (h.boostCards && Object.keys(h.boostCards).length) parts.push(`boostCards: ` + Object.entries(h.boostCards).map(([k, v]) => `${esc(k)}<span style="opacity:.6">×${v}</span>`).join(", "));
181
+ if (h.requireCards?.length) parts.push(`require: ${h.requireCards.map(esc).join(", ")}`);
182
+ if (h.requireTags?.length) parts.push(`requireTags: ${h.requireTags.map(esc).join(", ")}`);
183
+ if (h.excludeTags?.length) parts.push(`exclude: ${h.excludeTags.map(esc).join(", ")}`);
184
+ if (h.excludeCards?.length) parts.push(`excludeCards: ${h.excludeCards.map(esc).join(", ")}`);
185
+ }
186
+ return `<div style="margin-bottom:6px"><div style="color:#86efac">sessionHints</div>${parts.length ? parts.map((p) => `<div style="margin-left:6px">${p}</div>`).join("") : `<div style="margin-left:6px;opacity:.6">none</div>`}</div>`;
187
+ }
188
+ /**
189
+ * SRS backlog panel — answers "is review starvation permanent?". Backlog
190
+ * pressure is a multiplier (×1.0 healthy → exponential, uncapped) on review
191
+ * urgency; reviews are no longer clamped to 1.0, so under a heavy backlog they
192
+ * scale up to compete with (and exceed) new cards. There's no ceiling, so
193
+ * reviews always win eventually — the panel shows how far the current
194
+ * multiplier is from that crossover, not whether it's "maxed": compare
195
+ * `top review` here against the supplyQ head score to see how much further
196
+ * the backlog needs to grow (or the boosts need to relax) before reviews win
197
+ * slots.
198
+ */
199
+ function backlogHtml(backlog) {
200
+ if (!backlog.length) return "";
201
+ return `<div style="margin-bottom:6px"><div style="color:#93c5fd">review backpressure</div>${backlog.map((b) => {
202
+ const hot = b.backlogMultiplier >= 3;
203
+ const multColor = b.backlogMultiplier <= 1 ? "#86efac" : hot ? "#fca5a5" : "#fcd34d";
204
+ const headroom = b.backlogMultiplier > 1 ? `climbing (×${b.backlogGrowthRate.toFixed(2)} per ${b.healthyBacklog} of mass in excess, unbounded)` : "healthy — no pressure";
205
+ const mass = b.reviewMass !== null ? ` · mass ${b.reviewMass.toFixed(1)}` : "";
206
+ const top = b.topReviewScore !== null ? b.topReviewScore.toFixed(2) : "—";
207
+ const next = b.nextDueIn ? ` <span style="opacity:.6">· next due ${esc(b.nextDueIn)}</span>` : "";
208
+ return `<div style="margin-left:6px"><span style="opacity:.7">${esc(b.courseId.slice(0, 8))}</span> due ${b.dueNow}/${b.scheduledTotal}${mass} <span style="opacity:.6">(healthy mass ${b.healthyBacklog})</span>${next}<div style="margin-left:6px">pressure <span style="color:${multColor}">×${b.backlogMultiplier.toFixed(2)}</span> <span style="opacity:.6">${headroom} · top review ${top}</span></div></div>`;
209
+ }).join("")}</div>`;
210
+ }
211
+ /**
212
+ * Colour for a pressure multiplier. Green at ×1.0 (no pressure); when the
213
+ * gauge is capped, amber → red by fraction of headroom used; when unbounded,
214
+ * fall back to the SRS panel's absolute threshold (×3 = hot).
215
+ */
216
+ function pressureColor(multiplier, max) {
217
+ if (multiplier <= 1.001) return "#86efac";
218
+ if (max !== void 0 && max > 1) return (multiplier - 1) / (max - 1) >= .75 ? "#fca5a5" : "#fcd34d";
219
+ return multiplier >= 3 ? "#fca5a5" : "#fcd34d";
220
+ }
221
+ /** data-q keys land in HTML attributes; strip anything outside a safe set. */
222
+ function toggleKey(raw) {
223
+ return raw.replace(/[^\w:.|-]/g, "_");
224
+ }
225
+ /**
226
+ * One gauge row: `label ×2.50/8 — detail`, with an item list underneath that
227
+ * mirrors the queues' collapse behaviour (INLINE_THRESHOLD shown, "+N more"
228
+ * expands).
229
+ */
230
+ function gaugeHtml(sectionKey, g) {
231
+ const cap = g.max !== void 0 ? `<span style="opacity:.5">/${g.max}</span>` : "";
232
+ const detail = g.detail ? ` <span style="opacity:.6">${esc(g.detail)}</span>` : "";
233
+ let html = `<div style="margin-left:6px">${esc(g.label)} <span style="color:${pressureColor(g.multiplier, g.max)}">×${g.multiplier.toFixed(2)}</span>${cap}${detail}`;
234
+ const items = g.items ?? [];
235
+ if (items.length > 0) {
236
+ const key = toggleKey(`sp|${sectionKey}|${g.id}`);
237
+ const isOpen = !!expanded[key];
238
+ const shown = isOpen ? items : items.slice(0, INLINE_THRESHOLD);
239
+ html += `<div style="margin-left:6px">` + shown.map((it) => `<div style="white-space:nowrap;opacity:.75">${esc(it.label)}${it.value ? ` <span style="opacity:.6">${esc(it.value)}</span>` : ""}</div>`).join("");
240
+ if (items.length > INLINE_THRESHOLD) {
241
+ const footer = isOpen ? "▾ show less" : `… +${items.length - shown.length} more`;
242
+ html += `<div data-q="${key}" style="cursor:pointer;opacity:.6">${footer}</div>`;
243
+ }
244
+ html += `</div>`;
245
+ }
246
+ return html + `</div>`;
247
+ }
248
+ /**
249
+ * Strategy backpressure panel — the generic counterpart of the SRS panel
250
+ * above, fed by `captureStrategyPressure` pushes from navigation strategies
251
+ * (built-in prescribed, or consumer-registered). Per source: gauge rows with
252
+ * cap-aware colour, then a `top score` line that reads against the supplyQ
253
+ * head exactly like the SRS panel's `top review`.
254
+ */
255
+ function strategyPressureHtml(list) {
256
+ if (!list.length) return "";
257
+ return `<div style="margin-bottom:6px"><div style="color:#fdba74">strategy backpressure</div>${list.map((s) => {
258
+ const sectionKey = `${s.source}:${s.courseId.slice(0, 8)}`;
259
+ const top = s.topScore !== null && s.topScore !== void 0 ? s.topScore.toFixed(2) : "—";
260
+ const hints = s.hintsLabel ? `<div style="margin-left:6px;opacity:.6">hints: ${esc(s.hintsLabel)}</div>` : "";
261
+ return `<div style="margin-left:6px"><span style="opacity:.7">${esc(s.source)} · ${esc(s.courseId.slice(0, 8))}</span> <span style="opacity:.6">top score ${top}</span>` + s.gauges.map((g) => gaugeHtml(sectionKey, g)).join("") + hints + `</div>`;
262
+ }).join("")}</div>`;
263
+ }
264
+ /** Format a rank score for display: finite → 2dp, `+INF` → REQ (required). */
265
+ function fmtScore(score) {
266
+ if (score === void 0) return "";
267
+ if (!Number.isFinite(score)) return "REQ";
268
+ return score.toFixed(2);
269
+ }
270
+ /** One supply/failed queue line: `cardID [r 0.82]` with origin-coloured tag. */
271
+ function queueItemHtml(item) {
272
+ const tagColor = item.origin === "review" ? "#93c5fd" : "#fcd34d";
273
+ const score = fmtScore(item.score);
274
+ const label = `${item.origin === "review" ? "r" : "n"}${score ? " " + score : ""}`;
275
+ return `${esc(item.cardID)}<span style="color:${tagColor};opacity:.85"> [${label}]</span>`;
276
+ }
277
+ function queueHtml(key, label, q) {
278
+ const collapsible = q.length > INLINE_THRESHOLD;
279
+ const isOpen = collapsible && expanded[key];
280
+ const caret = collapsible ? expanded[key] ? "▾ " : "▸ " : "";
281
+ const drawn = q.dequeueCount ? ` <span style="opacity:.5">drawn ${q.dequeueCount}</span>` : "";
282
+ const titleStyle = collapsible ? "cursor:pointer;color:#f9a8d4" : "color:#f9a8d4";
283
+ const title = `<div${collapsible ? ` data-q="${key}"` : ""} style="${titleStyle}">${caret}${label}: ${q.length}${drawn}</div>`;
284
+ if (!q.cards.length) return title + `<div style="margin:1px 0 6px 6px;opacity:.5">empty</div>`;
285
+ const shown = isOpen ? q.cards : q.cards.slice(0, INLINE_THRESHOLD);
286
+ const hiddenCount = q.length - shown.length;
287
+ let body = `<ol style="margin:2px 0 ${collapsible ? 2 : 6}px 0;padding-left:20px">` + shown.map((c) => `<li style="white-space:nowrap">${queueItemHtml(c)}</li>`).join("") + `</ol>`;
288
+ if (collapsible) {
289
+ const footer = isOpen ? "▾ show less" : `… +${hiddenCount} more`;
290
+ body += `<div data-q="${key}" style="cursor:pointer;margin:0 0 6px 20px;opacity:.6">${footer}</div>`;
291
+ }
292
+ return title + body;
293
+ }
294
+ /** Compact, colour-coded per-card glyph: ✓ correct, ✗ wrong, · info-only. */
295
+ function outcomeGlyph(correct) {
296
+ if (correct === true) return `<span style="color:#86efac">✓</span>`;
297
+ if (correct === false) return `<span style="color:#fca5a5">✗</span>`;
298
+ return `<span style="opacity:.5">·</span>`;
299
+ }
300
+ /**
301
+ * Expandable list of every card the learner has interacted with this session.
302
+ * Mirrors `queueHtml`'s collapse behaviour but renders richer per-card detail
303
+ * (status, outcome, attempt count) since this is the audit trail, not a queue.
304
+ */
305
+ function drawnHtml(key, drawn) {
306
+ const collapsible = drawn.length > INLINE_THRESHOLD;
307
+ const isOpen = collapsible && expanded[key];
308
+ const caret = collapsible ? expanded[key] ? "▾ " : "▸ " : "";
309
+ const titleStyle = collapsible ? "cursor:pointer;color:#c4b5fd" : "color:#c4b5fd";
310
+ const title = `<div${collapsible ? ` data-q="${key}"` : ""} style="${titleStyle}">${caret}drawn: ${drawn.length}</div>`;
311
+ if (!drawn.length) return title + `<div style="margin:1px 0 6px 6px;opacity:.5">none yet</div>`;
312
+ const shown = isOpen ? drawn : drawn.slice(0, INLINE_THRESHOLD);
313
+ const hiddenCount = drawn.length - shown.length;
314
+ let body = `<ol style="margin:2px 0 ${collapsible ? 2 : 6}px 0;padding-left:20px">${shown.map((d) => {
315
+ const retries = d.attempts > 1 ? `<span style="opacity:.5"> ×${d.attempts}</span>` : "";
316
+ const time = `<span style="opacity:.45"> ${Math.round(d.timeSpentMs / 100) / 10}s</span>`;
317
+ return `<li style="white-space:nowrap">${outcomeGlyph(d.correct)} ${esc(d.cardID)}<span style="opacity:.5"> [${esc(d.status)}]</span>${retries}${time}</li>`;
318
+ }).join("")}</ol>`;
319
+ if (collapsible) {
320
+ const footer = isOpen ? "▾ show less" : `… +${hiddenCount} more`;
321
+ body += `<div data-q="${key}" style="cursor:pointer;margin:0 0 6px 20px;opacity:.6">${footer}</div>`;
322
+ }
323
+ return title + body;
324
+ }
325
+ /**
326
+ * Plain-text rendering of a snapshot for the clipboard. Mirrors the on-screen
327
+ * sections (without truncation) so a copied dump is a complete, paste-able
328
+ * picture of session state at the moment of the click.
329
+ */
330
+ function snapshotToText(s) {
331
+ if (!s) return "SessionController — no active session.";
332
+ const lines = [];
333
+ lines.push("=== SessionController ===");
334
+ lines.push(`time ${formatTime(s.secondsRemaining)}`);
335
+ if (s.hasCardGuarantee) lines.push(`guarantee: ${s.minCardsGuarantee}`);
336
+ lines.push(`well-indicated left: ${s.wellIndicatedRemaining}`);
337
+ lines.push(`current: ${s.currentCard ?? "—"}`);
338
+ lines.push(s.replanActive ? `replan: ACTIVE [${s.replanLabel ?? "(auto)"}]` : "replan: idle");
339
+ lines.push("");
340
+ lines.push("sessionHints:");
341
+ const h = s.sessionHints;
342
+ const hintParts = [];
343
+ if (h) {
344
+ if (h.boostTags && Object.keys(h.boostTags).length) hintParts.push(` boost: ${Object.entries(h.boostTags).map(([k, v]) => `${k}×${v}`).join(", ")}`);
345
+ if (h.boostCards && Object.keys(h.boostCards).length) hintParts.push(` boostCards: ${Object.entries(h.boostCards).map(([k, v]) => `${k}×${v}`).join(", ")}`);
346
+ if (h.requireCards?.length) hintParts.push(` require: ${h.requireCards.join(", ")}`);
347
+ if (h.requireTags?.length) hintParts.push(` requireTags: ${h.requireTags.join(", ")}`);
348
+ if (h.excludeTags?.length) hintParts.push(` exclude: ${h.excludeTags.join(", ")}`);
349
+ if (h.excludeCards?.length) hintParts.push(` excludeCards: ${h.excludeCards.join(", ")}`);
350
+ }
351
+ lines.push(hintParts.length ? hintParts.join("\n") : " none");
352
+ if (s.reviewBacklog.length) {
353
+ lines.push("");
354
+ lines.push("review backpressure:");
355
+ for (const b of s.reviewBacklog) {
356
+ const headroom = b.backlogMultiplier > 1 ? "climbing" : "healthy";
357
+ const top = b.topReviewScore !== null ? b.topReviewScore.toFixed(2) : "—";
358
+ const next = b.nextDueIn ? `, next due ${b.nextDueIn}` : "";
359
+ const mass = b.reviewMass !== null ? `, mass ${b.reviewMass.toFixed(1)}` : "";
360
+ lines.push(` ${b.courseId.slice(0, 8)}: due ${b.dueNow}/${b.scheduledTotal}${mass} (healthy mass ${b.healthyBacklog})${next}; pressure ×${b.backlogMultiplier.toFixed(2)} ${headroom}; top review ${top}`);
361
+ }
362
+ }
363
+ if (s.strategyPressure.length) {
364
+ lines.push("");
365
+ lines.push("strategy backpressure:");
366
+ for (const sp of s.strategyPressure) {
367
+ const top = sp.topScore !== null && sp.topScore !== void 0 ? sp.topScore.toFixed(2) : "—";
368
+ lines.push(` ${sp.source} (${sp.courseId.slice(0, 8)}): top score ${top}`);
369
+ for (const g of sp.gauges) {
370
+ const cap = g.max !== void 0 ? `/${g.max}` : "";
371
+ lines.push(` ${g.label} ×${g.multiplier.toFixed(2)}${cap}${g.detail ? ` — ${g.detail}` : ""}`);
372
+ for (const it of g.items ?? []) lines.push(` ${it.label}${it.value ? ` (${it.value})` : ""}`);
373
+ }
374
+ if (sp.hintsLabel) lines.push(` hints: ${sp.hintsLabel}`);
375
+ }
376
+ }
377
+ const queueText = (label, q) => {
378
+ lines.push("");
379
+ lines.push(`${label}: ${q.length} (drawn ${q.dequeueCount})`);
380
+ q.cards.forEach((c, i) => {
381
+ const score = fmtScore(c.score);
382
+ const tag = `${c.origin === "review" ? "r" : "n"}${score ? " " + score : ""}`;
383
+ lines.push(` ${i + 1}. ${c.cardID} [${tag}]`);
384
+ });
385
+ };
386
+ queueText("supplyQ", s.supplyQ);
387
+ queueText("failedQ", s.failedQ);
388
+ lines.push("");
389
+ lines.push(`drawn: ${s.drawnCards.length}`);
390
+ s.drawnCards.forEach((d, i) => {
391
+ const mark = d.correct === true ? "✓" : d.correct === false ? "✗" : "·";
392
+ const time = `${Math.round(d.timeSpentMs / 100) / 10}s`;
393
+ lines.push(` ${i + 1}. ${mark} ${d.cardID} [${d.status}] ×${d.attempts} ${time}`);
394
+ });
395
+ return lines.join("\n");
396
+ }
397
+ function formatTime(totalSeconds) {
398
+ const s = Math.max(0, Math.round(totalSeconds));
399
+ return `${Math.floor(s / 60)}:${(s % 60).toString().padStart(2, "0")}`;
400
+ }
401
+ function esc(value) {
402
+ return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
403
+ }
404
+ //#endregion
405
+ export { getActiveController, registerActiveController, toggleSessionOverlay };
406
+
407
+ //# sourceMappingURL=SessionOverlay.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"SessionOverlay.mjs","names":[],"sources":["../../src/study/SessionOverlay.ts"],"sourcesContent":["import { logger } from '../util/logger';\nimport type { ReplanHints } from '@db/core/navigators/generators/types';\nimport type { SrsBacklogDebug } from '@db/core/navigators/SrsDebugger';\nimport type {\n StrategyPressureDebug,\n PressureGaugeDebug,\n} from '@db/core/navigators/StrategyPressureDebugger';\n\n// ============================================================================\n// SESSION OVERLAY\n// ============================================================================\n//\n// A pinned, vanilla-DOM debug overlay for the LIVE SessionController. Unlike\n// `SessionDebugger` (a passive tracker of pushed snapshots), this reads the\n// active controller directly each tick — current queues, session hints, timer.\n//\n// Toggled via `window.skuilder.session.dbgOverlay()`.\n//\n// The `db` package is framework-agnostic, so this renders with raw DOM and\n// no-ops gracefully in non-browser hosts (e.g. the tuilder TUI). It is the\n// first DOM-rendering debug util in the package — kept self-contained here.\n//\n// ============================================================================\n\n/** A single queued item, carrying the now-load-bearing rank score + origin. */\nexport interface SessionQueueItemDebug {\n cardID: string;\n /** Item status: 'new' | 'review' | 'failed-new' | 'failed-review'. */\n status: string;\n /** Card nature, collapsed from status: 'new' | 'review'. */\n origin: 'new' | 'review';\n /** Pipeline suitability score at queue-build time; `+INF` marks a required card. */\n score?: number;\n}\n\n/** Per-queue debug view: total length, cumulative draws, and head-first items. */\nexport interface SessionQueueDebug {\n length: number;\n dequeueCount: number;\n /** Items in queue order, head (next draw) first. */\n cards: SessionQueueItemDebug[];\n}\n\n/**\n * A card the learner has interacted with this session (one entry per card in\n * the session record, regardless of which queue — if any — still holds it).\n */\nexport interface SessionDrawnCardDebug {\n cardID: string;\n /** Queue status at draw time: 'new' | 'review' | 'failed-new' | 'failed-review'. */\n status: string;\n /** Number of CardRecords logged for this card this session (≥1). */\n attempts: number;\n /** Latest record's correctness; null for non-question (info) records. */\n correct: boolean | null;\n /** Total time spent across all of this card's records, in ms. */\n timeSpentMs: number;\n}\n\n/** Live snapshot of the controller, read fresh on each overlay tick. */\nexport interface SessionDebugSnapshot {\n sessionId: string;\n secondsRemaining: number;\n hasCardGuarantee: boolean;\n minCardsGuarantee: number;\n wellIndicatedRemaining: number;\n /** cardID of the card currently in front of the learner, if any. */\n currentCard: string | null;\n /** Session-durable hints re-merged into every pipeline run this session. */\n sessionHints: ReplanHints | null;\n /** True while a replan is executing (in-flight). */\n replanActive: boolean;\n /** Reason for the in-flight replan (caller label, or '(auto)'); may be stale when idle. */\n replanLabel: string | null;\n /** The single rank-ordered supply (new + review interleaved), head first. */\n supplyQ: SessionQueueDebug;\n failedQ: SessionQueueDebug;\n /** SRS backlog state per course (drives the \"is review starvation permanent?\" read). */\n reviewBacklog: SrsBacklogDebug[];\n /** Per-strategy backpressure gauges (prescribed pressure, practice debt, ...). */\n strategyPressure: StrategyPressureDebug[];\n /** Every card the learner has interacted with this session, draw order. */\n drawnCards: SessionDrawnCardDebug[];\n}\n\n/** The narrow surface the overlay needs from a SessionController. */\nexport interface SessionDebugTarget {\n getDebugSnapshot(): SessionDebugSnapshot;\n}\n\n/**\n * The live-session surface available to out-of-tree callers through the\n * active-controller registry: the debug snapshot, plus the small set of\n * user-facing session controls a view may need without holding a ref into\n * the `<StudySession>` component's internals (e.g. wiring a timer's\n * add-time button from a composable). Keep this narrow — it is not a\n * general escape hatch to `SessionController`.\n */\nexport interface ActiveSessionHandle extends SessionDebugTarget {\n /** Extend the session clock by `seconds`. */\n addTime(seconds: number): void;\n}\n\n// ----------------------------------------------------------------------------\n// Active-controller registry\n// ----------------------------------------------------------------------------\n//\n// The controller registers itself on construction; a new session overwrites the\n// prior handle. Kept here (a leaf module) so SessionController can import the\n// registrar without pulling in the overlay's DOM code or risking an import\n// cycle with SessionDebugger.\n\nlet activeController: ActiveSessionHandle | null = null;\n\n/** Called by SessionController's constructor. Pass `null` to deregister. */\nexport function registerActiveController(controller: ActiveSessionHandle | null): void {\n activeController = controller;\n}\n\nexport function getActiveController(): ActiveSessionHandle | null {\n return activeController;\n}\n\n// ----------------------------------------------------------------------------\n// Overlay rendering (vanilla DOM)\n// ----------------------------------------------------------------------------\n\nconst OVERLAY_ID = 'skuilder-session-overlay';\nconst POLL_MS = 300;\n/**\n * Cap on how many cards a queue lists by default. Queues at or below this show\n * in full; larger ones show the first INLINE_THRESHOLD then a clickable\n * \"… +N more\" affordance that expands to the full list (and back).\n */\nconst INLINE_THRESHOLD = 5;\n\n/** Braille spinner frames, advanced once per render tick (≈POLL_MS cadence). */\nconst SPINNER_FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];\nlet spinnerFrame = 0;\n\nlet overlayEl: HTMLElement | null = null;\nlet pollHandle: ReturnType<typeof setInterval> | null = null;\n\n/**\n * Most recent snapshot rendered, retained so the click-to-copy button can\n * serialise exactly what is on screen at click time (decoupled from the poll).\n */\nlet lastSnapshot: SessionDebugSnapshot | null = null;\n\n/** Epoch ms until which the copy button shows its \"copied\" confirmation. */\nlet copyFlashUntil = 0;\n\n/**\n * When minified, the overlay collapses to just its header bar (title + copy +\n * restore button), suppressing all body sections. The poll keeps running so\n * `lastSnapshot` — and therefore the copy button — stays current underneath.\n */\nlet minified = false;\n\n/** Expansion state for collapsible (large) lists, preserved across re-renders. */\nconst expanded: Record<string, boolean> = {\n supplyQ: false,\n failedQ: false,\n drawn: false,\n};\n\n/**\n * Toggle the pinned overlay on/off. No-ops (with a console hint) when there is\n * no DOM, so it is safe to call from any host environment.\n */\nexport function toggleSessionOverlay(): void {\n if (typeof document === 'undefined') {\n logger.print('[Session Overlay] No DOM available (non-browser host); overlay unavailable.');\n return;\n }\n if (overlayEl) {\n teardown();\n logger.print('[Session Overlay] Hidden.');\n } else {\n mount();\n logger.print('[Session Overlay] Shown. Toggle off with window.skuilder.session.dbgOverlay().');\n }\n}\n\nfunction mount(): void {\n minified = false;\n overlayEl = document.createElement('div');\n overlayEl.id = OVERLAY_ID;\n Object.assign(overlayEl.style, {\n position: 'fixed',\n top: '8px',\n left: '8px',\n zIndex: '2147483647',\n maxWidth: '320px',\n maxHeight: '90vh',\n overflowY: 'auto',\n padding: '8px 10px',\n background: 'rgba(17, 24, 39, 0.92)',\n color: '#e5e7eb',\n font: '11px/1.4 ui-monospace, SFMono-Regular, Menlo, monospace',\n borderRadius: '6px',\n boxShadow: '0 4px 16px rgba(0,0,0,0.4)',\n pointerEvents: 'auto',\n userSelect: 'none',\n });\n document.body.appendChild(overlayEl);\n render();\n pollHandle = setInterval(render, POLL_MS);\n}\n\nfunction teardown(): void {\n if (pollHandle !== null) {\n clearInterval(pollHandle);\n pollHandle = null;\n }\n if (overlayEl?.parentNode) {\n overlayEl.parentNode.removeChild(overlayEl);\n }\n overlayEl = null;\n}\n\nfunction render(): void {\n if (!overlayEl) return;\n\n spinnerFrame++;\n\n const ctrl = getActiveController();\n if (!ctrl) {\n lastSnapshot = null;\n overlayEl.innerHTML =\n headerHtml() + (minified ? '' : `<div style=\"opacity:.65\">No active session.</div>`);\n attachHandlers();\n return;\n }\n\n const s = ctrl.getDebugSnapshot();\n lastSnapshot = s;\n\n if (minified) {\n overlayEl.innerHTML = headerHtml();\n attachHandlers();\n return;\n }\n\n overlayEl.innerHTML =\n headerHtml() +\n replanHtml(s) +\n metaHtml(s) +\n hintsHtml(s.sessionHints) +\n backlogHtml(s.reviewBacklog) +\n strategyPressureHtml(s.strategyPressure) +\n queueHtml('supplyQ', 'supplyQ', s.supplyQ) +\n queueHtml('failedQ', 'failedQ', s.failedQ) +\n drawnHtml('drawn', s.drawnCards);\n\n attachHandlers();\n}\n\n/** (Re-)bind click handlers after each innerHTML rewrite. */\nfunction attachHandlers(): void {\n if (!overlayEl) return;\n\n // Toggle handlers for collapsible queue / drawn-list headers and footers.\n overlayEl.querySelectorAll<HTMLElement>('[data-q]').forEach((el) => {\n el.onclick = () => {\n const key = el.dataset.q;\n if (!key) return;\n expanded[key] = !expanded[key];\n render();\n };\n });\n\n // Global click-to-copy: dump the currently-displayed snapshot as plain text.\n const copyBtn = overlayEl.querySelector<HTMLElement>('[data-copy]');\n if (copyBtn) {\n copyBtn.onclick = (ev) => {\n ev.stopPropagation();\n copySnapshot();\n };\n }\n\n // Minify / restore: collapse the overlay to its header bar and back.\n const minBtn = overlayEl.querySelector<HTMLElement>('[data-min]');\n if (minBtn) {\n minBtn.onclick = (ev) => {\n ev.stopPropagation();\n minified = !minified;\n render();\n };\n }\n}\n\n/** Serialise the on-screen snapshot to the clipboard, with a transient flash. */\nfunction copySnapshot(): void {\n const text = snapshotToText(lastSnapshot);\n const flash = () => {\n copyFlashUntil = Date.now() + 1200;\n render();\n };\n const clip = typeof navigator !== 'undefined' ? navigator.clipboard : undefined;\n if (clip?.writeText) {\n clip.writeText(text).then(flash, (err) => {\n logger.warn(`[Session Overlay] Clipboard write failed: ${String(err)}`);\n });\n } else {\n logger.print(`[Session Overlay] Clipboard unavailable; snapshot follows:\\n${text}`);\n }\n}\n\nfunction headerHtml(): string {\n const flashing = Date.now() < copyFlashUntil;\n const btnLabel = flashing ? '✓ copied' : '⎘ copy';\n const btnColor = flashing ? '#86efac' : '#93c5fd';\n const copyBtn =\n `<span data-copy style=\"cursor:pointer;float:right;font-weight:400;` +\n `color:${btnColor};border:1px solid currentColor;border-radius:4px;` +\n `padding:0 4px;line-height:1.3\">${btnLabel}</span>`;\n const minBtn =\n `<span data-min title=\"${minified ? 'Restore' : 'Minify'}\" ` +\n `style=\"cursor:pointer;float:right;font-weight:400;color:#93c5fd;` +\n `border:1px solid currentColor;border-radius:4px;padding:0 5px;` +\n `margin-right:4px;line-height:1.3\">${minified ? '▢' : '—'}</span>`;\n return (\n `<div style=\"font-weight:600;color:#93c5fd;margin-bottom:${minified ? 0 : 4}px\">` +\n `${copyBtn}${minBtn}⚙ SessionController</div>`\n );\n}\n\nfunction replanHtml(s: SessionDebugSnapshot): string {\n if (!s.replanActive) {\n return `<div style=\"margin-bottom:6px;opacity:.45\">○ idle</div>`;\n }\n const frame = SPINNER_FRAMES[spinnerFrame % SPINNER_FRAMES.length];\n const reason = esc(s.replanLabel ?? '(auto)');\n return (\n `<div style=\"margin-bottom:6px;color:#fde047\">` +\n `${frame} replanning <span style=\"opacity:.85\">[${reason}]</span></div>`\n );\n}\n\nfunction metaHtml(s: SessionDebugSnapshot): string {\n const mmss = formatTime(s.secondsRemaining);\n const guarantee = s.hasCardGuarantee\n ? ` · <span style=\"color:#fbbf24\">guarantee ${s.minCardsGuarantee}</span>`\n : '';\n const rows = [\n `time ${mmss}${guarantee}`,\n `well-indicated left: ${s.wellIndicatedRemaining}`,\n `current: ${s.currentCard ? esc(s.currentCard) : '<span style=\"opacity:.6\">—</span>'}`,\n ];\n return `<div style=\"margin-bottom:6px\">${rows.map((r) => `<div>${r}</div>`).join('')}</div>`;\n}\n\nfunction hintsHtml(h: ReplanHints | null): string {\n const parts: string[] = [];\n if (h) {\n if (h.boostTags && Object.keys(h.boostTags).length) {\n parts.push(\n `boost: ` +\n Object.entries(h.boostTags)\n .map(([k, v]) => `${esc(k)}<span style=\"opacity:.6\">×${v}</span>`)\n .join(', ')\n );\n }\n if (h.boostCards && Object.keys(h.boostCards).length) {\n parts.push(\n `boostCards: ` +\n Object.entries(h.boostCards)\n .map(([k, v]) => `${esc(k)}<span style=\"opacity:.6\">×${v}</span>`)\n .join(', ')\n );\n }\n if (h.requireCards?.length) parts.push(`require: ${h.requireCards.map(esc).join(', ')}`);\n if (h.requireTags?.length) parts.push(`requireTags: ${h.requireTags.map(esc).join(', ')}`);\n if (h.excludeTags?.length) parts.push(`exclude: ${h.excludeTags.map(esc).join(', ')}`);\n if (h.excludeCards?.length) parts.push(`excludeCards: ${h.excludeCards.map(esc).join(', ')}`);\n }\n const body = parts.length\n ? parts.map((p) => `<div style=\"margin-left:6px\">${p}</div>`).join('')\n : `<div style=\"margin-left:6px;opacity:.6\">none</div>`;\n return (\n `<div style=\"margin-bottom:6px\">` +\n `<div style=\"color:#86efac\">sessionHints</div>${body}</div>`\n );\n}\n\n/**\n * SRS backlog panel — answers \"is review starvation permanent?\". Backlog\n * pressure is a multiplier (×1.0 healthy → exponential, uncapped) on review\n * urgency; reviews are no longer clamped to 1.0, so under a heavy backlog they\n * scale up to compete with (and exceed) new cards. There's no ceiling, so\n * reviews always win eventually — the panel shows how far the current\n * multiplier is from that crossover, not whether it's \"maxed\": compare\n * `top review` here against the supplyQ head score to see how much further\n * the backlog needs to grow (or the boosts need to relax) before reviews win\n * slots.\n */\nfunction backlogHtml(backlog: SrsBacklogDebug[]): string {\n if (!backlog.length) return '';\n const rows = backlog\n .map((b) => {\n const hot = b.backlogMultiplier >= 3;\n const multColor = b.backlogMultiplier <= 1 ? '#86efac' : hot ? '#fca5a5' : '#fcd34d';\n const headroom =\n b.backlogMultiplier > 1\n ? `climbing (×${b.backlogGrowthRate.toFixed(2)} per ${b.healthyBacklog} of mass in excess, unbounded)`\n : 'healthy — no pressure';\n const mass =\n b.reviewMass !== null ? ` · mass ${b.reviewMass.toFixed(1)}` : '';\n const top = b.topReviewScore !== null ? b.topReviewScore.toFixed(2) : '—';\n const next = b.nextDueIn ? ` <span style=\"opacity:.6\">· next due ${esc(b.nextDueIn)}</span>` : '';\n return (\n `<div style=\"margin-left:6px\">` +\n `<span style=\"opacity:.7\">${esc(b.courseId.slice(0, 8))}</span> ` +\n `due ${b.dueNow}/${b.scheduledTotal}${mass} <span style=\"opacity:.6\">(healthy mass ${b.healthyBacklog})</span>${next}` +\n `<div style=\"margin-left:6px\">` +\n `pressure <span style=\"color:${multColor}\">×${b.backlogMultiplier.toFixed(2)}</span> ` +\n `<span style=\"opacity:.6\">${headroom} · top review ${top}</span></div>` +\n `</div>`\n );\n })\n .join('');\n return (\n `<div style=\"margin-bottom:6px\">` +\n `<div style=\"color:#93c5fd\">review backpressure</div>${rows}</div>`\n );\n}\n\n/**\n * Colour for a pressure multiplier. Green at ×1.0 (no pressure); when the\n * gauge is capped, amber → red by fraction of headroom used; when unbounded,\n * fall back to the SRS panel's absolute threshold (×3 = hot).\n */\nfunction pressureColor(multiplier: number, max?: number): string {\n if (multiplier <= 1.001) return '#86efac';\n if (max !== undefined && max > 1) {\n return (multiplier - 1) / (max - 1) >= 0.75 ? '#fca5a5' : '#fcd34d';\n }\n return multiplier >= 3 ? '#fca5a5' : '#fcd34d';\n}\n\n/** data-q keys land in HTML attributes; strip anything outside a safe set. */\nfunction toggleKey(raw: string): string {\n return raw.replace(/[^\\w:.|-]/g, '_');\n}\n\n/**\n * One gauge row: `label ×2.50/8 — detail`, with an item list underneath that\n * mirrors the queues' collapse behaviour (INLINE_THRESHOLD shown, \"+N more\"\n * expands).\n */\nfunction gaugeHtml(sectionKey: string, g: PressureGaugeDebug): string {\n const cap = g.max !== undefined ? `<span style=\"opacity:.5\">/${g.max}</span>` : '';\n const detail = g.detail ? ` <span style=\"opacity:.6\">${esc(g.detail)}</span>` : '';\n let html =\n `<div style=\"margin-left:6px\">${esc(g.label)} ` +\n `<span style=\"color:${pressureColor(g.multiplier, g.max)}\">×${g.multiplier.toFixed(2)}</span>` +\n `${cap}${detail}`;\n\n const items = g.items ?? [];\n if (items.length > 0) {\n const key = toggleKey(`sp|${sectionKey}|${g.id}`);\n const isOpen = !!expanded[key];\n const shown = isOpen ? items : items.slice(0, INLINE_THRESHOLD);\n html +=\n `<div style=\"margin-left:6px\">` +\n shown\n .map(\n (it) =>\n `<div style=\"white-space:nowrap;opacity:.75\">${esc(it.label)}` +\n `${it.value ? ` <span style=\"opacity:.6\">${esc(it.value)}</span>` : ''}</div>`\n )\n .join('');\n if (items.length > INLINE_THRESHOLD) {\n const footer = isOpen ? '▾ show less' : `… +${items.length - shown.length} more`;\n html += `<div data-q=\"${key}\" style=\"cursor:pointer;opacity:.6\">${footer}</div>`;\n }\n html += `</div>`;\n }\n\n return html + `</div>`;\n}\n\n/**\n * Strategy backpressure panel — the generic counterpart of the SRS panel\n * above, fed by `captureStrategyPressure` pushes from navigation strategies\n * (built-in prescribed, or consumer-registered). Per source: gauge rows with\n * cap-aware colour, then a `top score` line that reads against the supplyQ\n * head exactly like the SRS panel's `top review`.\n */\nfunction strategyPressureHtml(list: StrategyPressureDebug[]): string {\n if (!list.length) return '';\n const sections = list\n .map((s) => {\n const sectionKey = `${s.source}:${s.courseId.slice(0, 8)}`;\n const top = s.topScore !== null && s.topScore !== undefined ? s.topScore.toFixed(2) : '—';\n const hints = s.hintsLabel\n ? `<div style=\"margin-left:6px;opacity:.6\">hints: ${esc(s.hintsLabel)}</div>`\n : '';\n return (\n `<div style=\"margin-left:6px\">` +\n `<span style=\"opacity:.7\">${esc(s.source)} · ${esc(s.courseId.slice(0, 8))}</span>` +\n ` <span style=\"opacity:.6\">top score ${top}</span>` +\n s.gauges.map((g) => gaugeHtml(sectionKey, g)).join('') +\n hints +\n `</div>`\n );\n })\n .join('');\n return (\n `<div style=\"margin-bottom:6px\">` +\n `<div style=\"color:#fdba74\">strategy backpressure</div>${sections}</div>`\n );\n}\n\n/** Format a rank score for display: finite → 2dp, `+INF` → REQ (required). */\nfunction fmtScore(score?: number): string {\n if (score === undefined) return '';\n if (!Number.isFinite(score)) return 'REQ';\n return score.toFixed(2);\n}\n\n/** One supply/failed queue line: `cardID [r 0.82]` with origin-coloured tag. */\nfunction queueItemHtml(item: SessionQueueItemDebug): string {\n const tagColor = item.origin === 'review' ? '#93c5fd' : '#fcd34d';\n const score = fmtScore(item.score);\n const label = `${item.origin === 'review' ? 'r' : 'n'}${score ? ' ' + score : ''}`;\n return (\n `${esc(item.cardID)}` +\n `<span style=\"color:${tagColor};opacity:.85\"> [${label}]</span>`\n );\n}\n\nfunction queueHtml(key: string, label: string, q: SessionQueueDebug): string {\n const collapsible = q.length > INLINE_THRESHOLD;\n const isOpen = collapsible && expanded[key];\n const caret = collapsible ? (expanded[key] ? '▾ ' : '▸ ') : '';\n const drawn = q.dequeueCount ? ` <span style=\"opacity:.5\">drawn ${q.dequeueCount}</span>` : '';\n const titleStyle = collapsible ? 'cursor:pointer;color:#f9a8d4' : 'color:#f9a8d4';\n const titleAttr = collapsible ? ` data-q=\"${key}\"` : '';\n const title = `<div${titleAttr} style=\"${titleStyle}\">${caret}${label}: ${q.length}${drawn}</div>`;\n\n if (!q.cards.length) {\n return title + `<div style=\"margin:1px 0 6px 6px;opacity:.5\">empty</div>`;\n }\n\n // Always list up to INLINE_THRESHOLD cards; the remainder hides behind an\n // expand toggle so long queues never blow out the overlay but stay inspectable.\n const shown = isOpen ? q.cards : q.cards.slice(0, INLINE_THRESHOLD);\n const hiddenCount = q.length - shown.length;\n const listMarginBottom = collapsible ? 2 : 6;\n\n let body =\n `<ol style=\"margin:2px 0 ${listMarginBottom}px 0;padding-left:20px\">` +\n shown.map((c) => `<li style=\"white-space:nowrap\">${queueItemHtml(c)}</li>`).join('') +\n `</ol>`;\n\n if (collapsible) {\n const footer = isOpen ? '▾ show less' : `… +${hiddenCount} more`;\n body += `<div data-q=\"${key}\" style=\"cursor:pointer;margin:0 0 6px 20px;opacity:.6\">${footer}</div>`;\n }\n\n return title + body;\n}\n\n/** Compact, colour-coded per-card glyph: ✓ correct, ✗ wrong, · info-only. */\nfunction outcomeGlyph(correct: boolean | null): string {\n if (correct === true) return `<span style=\"color:#86efac\">✓</span>`;\n if (correct === false) return `<span style=\"color:#fca5a5\">✗</span>`;\n return `<span style=\"opacity:.5\">·</span>`;\n}\n\n/**\n * Expandable list of every card the learner has interacted with this session.\n * Mirrors `queueHtml`'s collapse behaviour but renders richer per-card detail\n * (status, outcome, attempt count) since this is the audit trail, not a queue.\n */\nfunction drawnHtml(key: string, drawn: SessionDrawnCardDebug[]): string {\n const collapsible = drawn.length > INLINE_THRESHOLD;\n const isOpen = collapsible && expanded[key];\n const caret = collapsible ? (expanded[key] ? '▾ ' : '▸ ') : '';\n const titleStyle = collapsible ? 'cursor:pointer;color:#c4b5fd' : 'color:#c4b5fd';\n const titleAttr = collapsible ? ` data-q=\"${key}\"` : '';\n const title = `<div${titleAttr} style=\"${titleStyle}\">${caret}drawn: ${drawn.length}</div>`;\n\n if (!drawn.length) {\n return title + `<div style=\"margin:1px 0 6px 6px;opacity:.5\">none yet</div>`;\n }\n\n const shown = isOpen ? drawn : drawn.slice(0, INLINE_THRESHOLD);\n const hiddenCount = drawn.length - shown.length;\n const listMarginBottom = collapsible ? 2 : 6;\n\n const rows = shown\n .map((d) => {\n const retries = d.attempts > 1 ? `<span style=\"opacity:.5\"> ×${d.attempts}</span>` : '';\n const time = `<span style=\"opacity:.45\"> ${Math.round(d.timeSpentMs / 100) / 10}s</span>`;\n return (\n `<li style=\"white-space:nowrap\">${outcomeGlyph(d.correct)} ${esc(d.cardID)}` +\n `<span style=\"opacity:.5\"> [${esc(d.status)}]</span>${retries}${time}</li>`\n );\n })\n .join('');\n\n let body = `<ol style=\"margin:2px 0 ${listMarginBottom}px 0;padding-left:20px\">${rows}</ol>`;\n\n if (collapsible) {\n const footer = isOpen ? '▾ show less' : `… +${hiddenCount} more`;\n body += `<div data-q=\"${key}\" style=\"cursor:pointer;margin:0 0 6px 20px;opacity:.6\">${footer}</div>`;\n }\n\n return title + body;\n}\n\n/**\n * Plain-text rendering of a snapshot for the clipboard. Mirrors the on-screen\n * sections (without truncation) so a copied dump is a complete, paste-able\n * picture of session state at the moment of the click.\n */\nfunction snapshotToText(s: SessionDebugSnapshot | null): string {\n if (!s) return 'SessionController — no active session.';\n\n const lines: string[] = [];\n lines.push('=== SessionController ===');\n lines.push(`time ${formatTime(s.secondsRemaining)}`);\n if (s.hasCardGuarantee) lines.push(`guarantee: ${s.minCardsGuarantee}`);\n lines.push(`well-indicated left: ${s.wellIndicatedRemaining}`);\n lines.push(`current: ${s.currentCard ?? '—'}`);\n lines.push(\n s.replanActive ? `replan: ACTIVE [${s.replanLabel ?? '(auto)'}]` : 'replan: idle'\n );\n\n lines.push('');\n lines.push('sessionHints:');\n const h = s.sessionHints;\n const hintParts: string[] = [];\n if (h) {\n if (h.boostTags && Object.keys(h.boostTags).length)\n hintParts.push(` boost: ${Object.entries(h.boostTags).map(([k, v]) => `${k}×${v}`).join(', ')}`);\n if (h.boostCards && Object.keys(h.boostCards).length)\n hintParts.push(` boostCards: ${Object.entries(h.boostCards).map(([k, v]) => `${k}×${v}`).join(', ')}`);\n if (h.requireCards?.length) hintParts.push(` require: ${h.requireCards.join(', ')}`);\n if (h.requireTags?.length) hintParts.push(` requireTags: ${h.requireTags.join(', ')}`);\n if (h.excludeTags?.length) hintParts.push(` exclude: ${h.excludeTags.join(', ')}`);\n if (h.excludeCards?.length) hintParts.push(` excludeCards: ${h.excludeCards.join(', ')}`);\n }\n lines.push(hintParts.length ? hintParts.join('\\n') : ' none');\n\n if (s.reviewBacklog.length) {\n lines.push('');\n lines.push('review backpressure:');\n for (const b of s.reviewBacklog) {\n const headroom = b.backlogMultiplier > 1 ? 'climbing' : 'healthy';\n const top = b.topReviewScore !== null ? b.topReviewScore.toFixed(2) : '—';\n const next = b.nextDueIn ? `, next due ${b.nextDueIn}` : '';\n const mass = b.reviewMass !== null ? `, mass ${b.reviewMass.toFixed(1)}` : '';\n lines.push(\n ` ${b.courseId.slice(0, 8)}: due ${b.dueNow}/${b.scheduledTotal}${mass} ` +\n `(healthy mass ${b.healthyBacklog})${next}; pressure ×${b.backlogMultiplier.toFixed(2)} ` +\n `${headroom}; top review ${top}`\n );\n }\n }\n\n if (s.strategyPressure.length) {\n lines.push('');\n lines.push('strategy backpressure:');\n for (const sp of s.strategyPressure) {\n const top = sp.topScore !== null && sp.topScore !== undefined ? sp.topScore.toFixed(2) : '—';\n lines.push(` ${sp.source} (${sp.courseId.slice(0, 8)}): top score ${top}`);\n for (const g of sp.gauges) {\n const cap = g.max !== undefined ? `/${g.max}` : '';\n lines.push(\n ` ${g.label} ×${g.multiplier.toFixed(2)}${cap}${g.detail ? ` — ${g.detail}` : ''}`\n );\n for (const it of g.items ?? []) {\n lines.push(` ${it.label}${it.value ? ` (${it.value})` : ''}`);\n }\n }\n if (sp.hintsLabel) lines.push(` hints: ${sp.hintsLabel}`);\n }\n }\n\n const queueText = (label: string, q: SessionQueueDebug) => {\n lines.push('');\n lines.push(`${label}: ${q.length} (drawn ${q.dequeueCount})`);\n q.cards.forEach((c, i) => {\n const score = fmtScore(c.score);\n const tag = `${c.origin === 'review' ? 'r' : 'n'}${score ? ' ' + score : ''}`;\n lines.push(` ${i + 1}. ${c.cardID} [${tag}]`);\n });\n };\n queueText('supplyQ', s.supplyQ);\n queueText('failedQ', s.failedQ);\n\n lines.push('');\n lines.push(`drawn: ${s.drawnCards.length}`);\n s.drawnCards.forEach((d, i) => {\n const mark = d.correct === true ? '✓' : d.correct === false ? '✗' : '·';\n const time = `${Math.round(d.timeSpentMs / 100) / 10}s`;\n lines.push(` ${i + 1}. ${mark} ${d.cardID} [${d.status}] ×${d.attempts} ${time}`);\n });\n\n return lines.join('\\n');\n}\n\nfunction formatTime(totalSeconds: number): string {\n const s = Math.max(0, Math.round(totalSeconds));\n const m = Math.floor(s / 60);\n const r = s % 60;\n return `${m}:${r.toString().padStart(2, '0')}`;\n}\n\nfunction esc(value: string): string {\n return value\n .replace(/&/g, '&amp;')\n .replace(/</g, '&lt;')\n .replace(/>/g, '&gt;');\n}\n"],"mappings":"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"}
@@ -0,0 +1,45 @@
1
+ import "../_virtual/_rolldown/runtime.mjs";
2
+ //#region src/study/SourceMixer.ts
3
+ /**
4
+ * Quota-based mixer with interleaved output.
5
+ *
6
+ * Allocates equal representation to each source (top-N by score), then
7
+ * interleaves the results by dealing from a randomly-shuffled source order.
8
+ * Within each source, cards are dealt in score-descending order.
9
+ *
10
+ * This ensures that cards from different courses are spread throughout the
11
+ * queue rather than clustered by score bands, which matters because
12
+ * SessionController consumes queues front-to-back and sessions often end
13
+ * before reaching the tail.
14
+ */
15
+ var QuotaRoundRobinMixer = class {
16
+ mix(batches, limit) {
17
+ if (batches.length === 0) return [];
18
+ const quotaPerSource = Math.ceil(limit / batches.length);
19
+ const sourceStacks = batches.map((batch) => {
20
+ return [...batch.weighted].sort((a, b) => b.score - a.score).slice(0, quotaPerSource);
21
+ });
22
+ for (let i = sourceStacks.length - 1; i > 0; i--) {
23
+ const j = Math.floor(Math.random() * (i + 1));
24
+ [sourceStacks[i], sourceStacks[j]] = [sourceStacks[j], sourceStacks[i]];
25
+ }
26
+ const result = [];
27
+ let exhausted = 0;
28
+ const cursors = new Array(sourceStacks.length).fill(0);
29
+ while (result.length < limit && exhausted < sourceStacks.length) {
30
+ exhausted = 0;
31
+ for (let s = 0; s < sourceStacks.length; s++) {
32
+ if (result.length >= limit) break;
33
+ if (cursors[s] < sourceStacks[s].length) {
34
+ result.push(sourceStacks[s][cursors[s]]);
35
+ cursors[s]++;
36
+ } else exhausted++;
37
+ }
38
+ }
39
+ return result;
40
+ }
41
+ };
42
+ //#endregion
43
+ export { QuotaRoundRobinMixer };
44
+
45
+ //# sourceMappingURL=SourceMixer.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"SourceMixer.mjs","names":[],"sources":["../../src/study/SourceMixer.ts"],"sourcesContent":["import { WeightedCard } from '@db/core/navigators';\n\n/**\n * Represents a batch of content fetched from a single StudyContentSource.\n */\nexport interface SourceBatch {\n sourceIndex: number;\n weighted: WeightedCard[];\n}\n\n/**\n * Strategy interface for mixing content from multiple sources into a unified\n * set of weighted candidates.\n *\n * Different implementations can provide different balancing strategies:\n * - QuotaRoundRobinMixer: Equal representation per source\n * - MinMaxNormalizingMixer: Score normalization then global sort\n * - PercentileBucketMixer: Bucketed round-robin\n * etc.\n */\nexport interface SourceMixer {\n /**\n * Mix weighted cards from multiple sources into a unified, ordered list.\n *\n * @param batches - Content batches from each source\n * @param limit - Target number of cards to return\n * @returns Mixed and ordered weighted cards\n */\n mix(batches: SourceBatch[], limit: number): WeightedCard[];\n}\n\n/**\n * Quota-based mixer with interleaved output.\n *\n * Allocates equal representation to each source (top-N by score), then\n * interleaves the results by dealing from a randomly-shuffled source order.\n * Within each source, cards are dealt in score-descending order.\n *\n * This ensures that cards from different courses are spread throughout the\n * queue rather than clustered by score bands, which matters because\n * SessionController consumes queues front-to-back and sessions often end\n * before reaching the tail.\n */\nexport class QuotaRoundRobinMixer implements SourceMixer {\n mix(batches: SourceBatch[], limit: number): WeightedCard[] {\n if (batches.length === 0) {\n return [];\n }\n\n const quotaPerSource = Math.ceil(limit / batches.length);\n\n // Build per-source stacks sorted by score descending, capped at quota\n const sourceStacks: WeightedCard[][] = batches.map((batch) => {\n return [...batch.weighted].sort((a, b) => b.score - a.score).slice(0, quotaPerSource);\n });\n\n // Shuffle the source ordering so no course is systematically first\n for (let i = sourceStacks.length - 1; i > 0; i--) {\n const j = Math.floor(Math.random() * (i + 1));\n [sourceStacks[i], sourceStacks[j]] = [sourceStacks[j], sourceStacks[i]];\n }\n\n // Interleave: deal one card from each source in rotation\n const result: WeightedCard[] = [];\n let exhausted = 0;\n const cursors = new Array(sourceStacks.length).fill(0);\n\n while (result.length < limit && exhausted < sourceStacks.length) {\n exhausted = 0;\n for (let s = 0; s < sourceStacks.length; s++) {\n if (result.length >= limit) break;\n\n if (cursors[s] < sourceStacks[s].length) {\n result.push(sourceStacks[s][cursors[s]]);\n cursors[s]++;\n } else {\n exhausted++;\n }\n }\n }\n\n return result;\n }\n}\n"],"mappings":";;;;;;;;;;;;;;AA2CA,IAAa,uBAAb,MAAyD;CACvD,IAAI,SAAwB,OAA+B;AACzD,MAAI,QAAQ,WAAW,EACrB,QAAO,EAAE;EAGX,MAAM,iBAAiB,KAAK,KAAK,QAAQ,QAAQ,OAAO;EAGxD,MAAM,eAAiC,QAAQ,KAAK,UAAU;AAC5D,UAAO,CAAC,GAAG,MAAM,SAAS,CAAC,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,GAAG,eAAe;IACrF;AAGF,OAAK,IAAI,IAAI,aAAa,SAAS,GAAG,IAAI,GAAG,KAAK;GAChD,MAAM,IAAI,KAAK,MAAM,KAAK,QAAQ,IAAI,IAAI,GAAG;AAC7C,IAAC,aAAa,IAAI,aAAa,MAAM,CAAC,aAAa,IAAI,aAAa,GAAG;;EAIzE,MAAM,SAAyB,EAAE;EACjC,IAAI,YAAY;EAChB,MAAM,UAAU,IAAI,MAAM,aAAa,OAAO,CAAC,KAAK,EAAE;AAEtD,SAAO,OAAO,SAAS,SAAS,YAAY,aAAa,QAAQ;AAC/D,eAAY;AACZ,QAAK,IAAI,IAAI,GAAG,IAAI,aAAa,QAAQ,KAAK;AAC5C,QAAI,OAAO,UAAU,MAAO;AAE5B,QAAI,QAAQ,KAAK,aAAa,GAAG,QAAQ;AACvC,YAAO,KAAK,aAAa,GAAG,QAAQ,IAAI;AACxC,aAAQ;UAER;;;AAKN,SAAO"}