@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.
- package/CLAUDE.md +15 -4
- package/build.entries.mjs +12 -0
- package/dist/_virtual/_rolldown/runtime.mjs +8 -0
- package/dist/{contentSource-CTQ4kWhR.d.cts → contentSource-D_E7JaxR.d.ts} +2 -2
- package/dist/core/UserDBDebugger.mjs +285 -0
- package/dist/core/UserDBDebugger.mjs.map +1 -0
- package/dist/core/bulkImport/cardProcessor.mjs +106 -0
- package/dist/core/bulkImport/cardProcessor.mjs.map +1 -0
- package/dist/core/{index.js → index.cjs} +6438 -7784
- package/dist/core/index.cjs.map +1 -0
- package/dist/core/index.d.ts +5 -5
- package/dist/core/index.mjs +20 -11368
- package/dist/core/interfaces/contentSource.mjs +20 -0
- package/dist/core/interfaces/contentSource.mjs.map +1 -0
- package/dist/core/navigators/Pipeline.mjs +723 -0
- package/dist/core/navigators/Pipeline.mjs.map +1 -0
- package/dist/core/navigators/PipelineAssembler.mjs +86 -0
- package/dist/core/navigators/PipelineAssembler.mjs.map +1 -0
- package/dist/core/navigators/PipelineDebugger.mjs +771 -0
- package/dist/core/navigators/PipelineDebugger.mjs.map +1 -0
- package/dist/core/navigators/SrsDebugger.mjs +34 -0
- package/dist/core/navigators/SrsDebugger.mjs.map +1 -0
- package/dist/core/navigators/StrategyPressureDebugger.mjs +19 -0
- package/dist/core/navigators/StrategyPressureDebugger.mjs.map +1 -0
- package/dist/core/navigators/defaults.mjs +96 -0
- package/dist/core/navigators/defaults.mjs.map +1 -0
- package/dist/core/navigators/diversityRerank.mjs +85 -0
- package/dist/core/navigators/diversityRerank.mjs.map +1 -0
- package/dist/core/navigators/filters/WeightedFilter.mjs +81 -0
- package/dist/core/navigators/filters/WeightedFilter.mjs.map +1 -0
- package/dist/core/navigators/filters/eloDistance.mjs +244 -0
- package/dist/core/navigators/filters/eloDistance.mjs.map +1 -0
- package/dist/core/navigators/filters/hierarchyDefinition.mjs +235 -0
- package/dist/core/navigators/filters/hierarchyDefinition.mjs.map +1 -0
- package/dist/core/navigators/filters/interferenceMitigator.mjs +201 -0
- package/dist/core/navigators/filters/interferenceMitigator.mjs.map +1 -0
- package/dist/core/navigators/filters/relativePriority.mjs +135 -0
- package/dist/core/navigators/filters/relativePriority.mjs.map +1 -0
- package/dist/core/navigators/filters/userTagPreference.mjs +101 -0
- package/dist/core/navigators/filters/userTagPreference.mjs.map +1 -0
- package/dist/core/navigators/generators/CompositeGenerator.mjs +203 -0
- package/dist/core/navigators/generators/CompositeGenerator.mjs.map +1 -0
- package/dist/core/navigators/generators/elo.mjs +77 -0
- package/dist/core/navigators/generators/elo.mjs.map +1 -0
- package/dist/core/navigators/generators/prescribed.mjs +676 -0
- package/dist/core/navigators/generators/prescribed.mjs.map +1 -0
- package/dist/core/navigators/generators/srs.mjs +158 -0
- package/dist/core/navigators/generators/srs.mjs.map +1 -0
- package/dist/core/navigators/index.mjs +345 -0
- package/dist/core/navigators/index.mjs.map +1 -0
- package/dist/core/navigators/pipelinePlan.mjs +109 -0
- package/dist/core/navigators/pipelinePlan.mjs.map +1 -0
- package/dist/core/navigators/regulators.mjs +128 -0
- package/dist/core/navigators/regulators.mjs.map +1 -0
- package/dist/core/orchestration/gradient.mjs +101 -0
- package/dist/core/orchestration/gradient.mjs.map +1 -0
- package/dist/core/orchestration/index.mjs +115 -0
- package/dist/core/orchestration/index.mjs.map +1 -0
- package/dist/core/orchestration/learning.mjs +140 -0
- package/dist/core/orchestration/learning.mjs.map +1 -0
- package/dist/core/orchestration/recording.mjs +64 -0
- package/dist/core/orchestration/recording.mjs.map +1 -0
- package/dist/core/orchestration/signal.mjs +40 -0
- package/dist/core/orchestration/signal.mjs.map +1 -0
- package/dist/core/types/contentNavigationStrategy.mjs +10 -0
- package/dist/core/types/contentNavigationStrategy.mjs.map +1 -0
- package/dist/core/types/hydration.mjs +13 -0
- package/dist/core/types/hydration.mjs.map +1 -0
- package/dist/core/types/strategyState.mjs +16 -0
- package/dist/core/types/strategyState.mjs.map +1 -0
- package/dist/core/types/studySession.mjs +14 -0
- package/dist/core/types/studySession.mjs.map +1 -0
- package/dist/core/types/types-legacy.mjs +44 -0
- package/dist/core/types/types-legacy.mjs.map +1 -0
- package/dist/core/util/index.mjs +31 -0
- package/dist/core/util/index.mjs.map +1 -0
- package/dist/core/versionStamps.mjs +46 -0
- package/dist/core/versionStamps.mjs.map +1 -0
- package/dist/courseConfigRegistration.mjs +306 -0
- package/dist/courseConfigRegistration.mjs.map +1 -0
- package/dist/{dataLayerProvider-rlLE2Mf-.d.ts → dataLayerProvider-BDshhSp_.d.ts} +1 -1
- package/dist/diagnostics/dataset.mjs +118 -0
- package/dist/diagnostics/dataset.mjs.map +1 -0
- package/dist/diagnostics/derive.mjs +318 -0
- package/dist/diagnostics/derive.mjs.map +1 -0
- package/dist/diagnostics/{index.js → index.cjs} +130 -1
- package/dist/diagnostics/index.cjs.map +1 -0
- package/dist/diagnostics/index.d.ts +108 -5
- package/dist/diagnostics/index.mjs +7 -914
- package/dist/diagnostics/loader.mjs +151 -0
- package/dist/diagnostics/loader.mjs.map +1 -0
- package/dist/diagnostics/pipeline.mjs +161 -0
- package/dist/diagnostics/pipeline.mjs.map +1 -0
- package/dist/diagnostics/tagElo.mjs +177 -0
- package/dist/diagnostics/tagElo.mjs.map +1 -0
- package/dist/diagnostics/text.mjs +174 -0
- package/dist/diagnostics/text.mjs.map +1 -0
- package/dist/factory.mjs +70 -0
- package/dist/factory.mjs.map +1 -0
- package/dist/impl/common/BaseUserDB.mjs +1103 -0
- package/dist/impl/common/BaseUserDB.mjs.map +1 -0
- package/dist/impl/common/userDBHelpers.mjs +49 -0
- package/dist/impl/common/userDBHelpers.mjs.map +1 -0
- package/dist/impl/common/userDBKeys.mjs +45 -0
- package/dist/impl/common/userDBKeys.mjs.map +1 -0
- package/dist/impl/couch/CouchDBSyncStrategy.mjs +272 -0
- package/dist/impl/couch/CouchDBSyncStrategy.mjs.map +1 -0
- package/dist/impl/couch/CourseSyncService.mjs +242 -0
- package/dist/impl/couch/CourseSyncService.mjs.map +1 -0
- package/dist/impl/couch/PouchDataLayerProvider.mjs +74 -0
- package/dist/impl/couch/PouchDataLayerProvider.mjs.map +1 -0
- package/dist/impl/couch/adminDB.mjs +61 -0
- package/dist/impl/couch/adminDB.mjs.map +1 -0
- package/dist/impl/couch/auth.mjs +33 -0
- package/dist/impl/couch/auth.mjs.map +1 -0
- package/dist/impl/couch/classroomDB.mjs +227 -0
- package/dist/impl/couch/classroomDB.mjs.map +1 -0
- package/dist/impl/couch/clientCache.mjs +15 -0
- package/dist/impl/couch/clientCache.mjs.map +1 -0
- package/dist/impl/couch/courseAPI.mjs +183 -0
- package/dist/impl/couch/courseAPI.mjs.map +1 -0
- package/dist/impl/couch/courseDB.mjs +729 -0
- package/dist/impl/couch/courseDB.mjs.map +1 -0
- package/dist/impl/couch/courseLookupDB.mjs +94 -0
- package/dist/impl/couch/courseLookupDB.mjs.map +1 -0
- package/dist/impl/couch/{index.js → index.cjs} +6911 -10367
- package/dist/impl/couch/index.cjs.map +1 -0
- package/dist/impl/couch/index.d.ts +12 -5
- package/dist/impl/couch/index.mjs +134 -12146
- package/dist/impl/couch/index.mjs.map +1 -1
- package/dist/impl/couch/pouchdb-setup.mjs +15 -0
- package/dist/impl/couch/pouchdb-setup.mjs.map +1 -0
- package/dist/impl/couch/updateQueue.mjs +101 -0
- package/dist/impl/couch/updateQueue.mjs.map +1 -0
- package/dist/impl/couch/user-course-relDB.mjs +55 -0
- package/dist/impl/couch/user-course-relDB.mjs.map +1 -0
- package/dist/impl/static/NoOpSyncStrategy.mjs +49 -0
- package/dist/impl/static/NoOpSyncStrategy.mjs.map +1 -0
- package/dist/impl/static/StaticDataLayerProvider.mjs +94 -0
- package/dist/impl/static/StaticDataLayerProvider.mjs.map +1 -0
- package/dist/impl/static/StaticDataUnpacker.mjs +311 -0
- package/dist/impl/static/StaticDataUnpacker.mjs.map +1 -0
- package/dist/impl/static/courseDB.mjs +368 -0
- package/dist/impl/static/courseDB.mjs.map +1 -0
- package/dist/impl/static/coursesDB.mjs +38 -0
- package/dist/impl/static/coursesDB.mjs.map +1 -0
- package/dist/impl/static/{index.js → index.cjs} +2461 -5992
- package/dist/impl/static/index.cjs.map +1 -0
- package/dist/impl/static/index.d.ts +4 -4
- package/dist/impl/static/index.mjs +6 -10741
- package/dist/{index-CVGehe_t.d.ts → index-BLDpFYG3.d.ts} +1 -1
- package/dist/{index.js → index.cjs} +14070 -14239
- package/dist/index.cjs.map +1 -0
- package/dist/index.d.ts +12 -23
- package/dist/index.mjs +38 -16937
- package/dist/pouch/{index.js → index.cjs} +5 -1
- package/dist/pouch/index.cjs.map +1 -0
- package/dist/pouch/index.mjs +2 -19
- package/dist/study/ItemQueue.mjs +95 -0
- package/dist/study/ItemQueue.mjs.map +1 -0
- package/dist/study/MixerDebugger.mjs +303 -0
- package/dist/study/MixerDebugger.mjs.map +1 -0
- package/dist/study/SessionController.mjs +1187 -0
- package/dist/study/SessionController.mjs.map +1 -0
- package/dist/study/SessionDebugger.mjs +271 -0
- package/dist/study/SessionDebugger.mjs.map +1 -0
- package/dist/study/SessionOverlay.mjs +407 -0
- package/dist/study/SessionOverlay.mjs.map +1 -0
- package/dist/study/SourceMixer.mjs +45 -0
- package/dist/study/SourceMixer.mjs.map +1 -0
- package/dist/study/SpacedRepetition.mjs +108 -0
- package/dist/study/SpacedRepetition.mjs.map +1 -0
- package/dist/study/TagFilteredContentSource.mjs +136 -0
- package/dist/study/TagFilteredContentSource.mjs.map +1 -0
- package/dist/study/services/CardHydrationService.mjs +172 -0
- package/dist/study/services/CardHydrationService.mjs.map +1 -0
- package/dist/study/services/EloService.mjs +217 -0
- package/dist/study/services/EloService.mjs.map +1 -0
- package/dist/study/services/ResponseProcessor.mjs +190 -0
- package/dist/study/services/ResponseProcessor.mjs.map +1 -0
- package/dist/study/services/SrsService.mjs +49 -0
- package/dist/study/services/SrsService.mjs.map +1 -0
- package/dist/study/services/tagRecent.mjs +65 -0
- package/dist/study/services/tagRecent.mjs.map +1 -0
- package/dist/{types-dXWfyz9B.d.ts → types-DChCz22D.d.ts} +1 -1
- package/dist/{types-legacy-BkOYOR6U.d.cts → types-legacy-fT5Y1Wuy.d.ts} +1 -1
- package/dist/userDBKeys-ne1g4Xuq.d.ts +16 -0
- package/dist/util/Loggable.mjs +14 -0
- package/dist/util/Loggable.mjs.map +1 -0
- package/dist/util/dataDirectory.mjs +47 -0
- package/dist/util/dataDirectory.mjs.map +1 -0
- package/dist/util/logger.mjs +86 -0
- package/dist/util/logger.mjs.map +1 -0
- package/dist/util/migrator/FileSystemAdapter.mjs +18 -0
- package/dist/util/migrator/FileSystemAdapter.mjs.map +1 -0
- package/dist/util/migrator/StaticToCouchDBMigrator.mjs +428 -0
- package/dist/util/migrator/StaticToCouchDBMigrator.mjs.map +1 -0
- package/dist/util/migrator/types.mjs +11 -0
- package/dist/util/migrator/types.mjs.map +1 -0
- package/dist/util/migrator/validation.mjs +334 -0
- package/dist/util/migrator/validation.mjs.map +1 -0
- package/dist/util/packer/CouchDBToStaticPacker.mjs +438 -0
- package/dist/util/packer/CouchDBToStaticPacker.mjs.map +1 -0
- package/dist/util/packer/{index.js → index.cjs} +73 -9
- package/dist/util/packer/index.cjs.map +1 -0
- package/dist/util/packer/index.d.ts +3 -3
- package/dist/util/packer/index.mjs +2 -537
- package/eslint.config.mjs +9 -1
- package/package.json +25 -13
- package/rolldown.config.mjs +44 -0
- package/src/core/UserDBDebugger.ts +47 -46
- package/src/core/navigators/Pipeline.ts +10 -10
- package/src/core/navigators/PipelineDebugger.ts +55 -55
- package/src/core/navigators/filters/eloDistance.ts +11 -1
- package/src/core/navigators/generators/elo.ts +5 -1
- package/src/core/navigators/index.ts +9 -3
- package/src/diagnostics/derive.ts +6 -0
- package/src/diagnostics/index.ts +1 -0
- package/src/diagnostics/tagElo.ts +257 -0
- package/src/factory.ts +10 -1
- package/src/impl/common/BaseUserDB.ts +1 -3
- package/src/impl/common/index.ts +2 -0
- package/src/impl/common/userDBHelpers.ts +4 -58
- package/src/impl/common/userDBKeys.ts +64 -0
- package/src/impl/couch/courseDB.ts +15 -3
- package/src/impl/couch/index.ts +2 -18
- package/src/impl/couch/pouchdb-setup.ts +8 -0
- package/src/index.ts +1 -1
- package/src/study/MixerDebugger.ts +46 -46
- package/src/study/SessionDebugger.ts +20 -20
- package/src/study/SessionOverlay.ts +4 -4
- package/src/util/logger.ts +112 -13
- package/tests/core/navigators/eloGenerator.test.ts +36 -0
- package/tsup.config.ts +24 -21
- package/dist/SyncStrategy-BXliog1m.d.cts +0 -116
- package/dist/classroomDB-DLTtLZct.d.cts +0 -86
- package/dist/contentSource-JmWYu8IK.d.ts +0 -2007
- package/dist/core/index.d.cts +0 -521
- package/dist/core/index.js.map +0 -1
- package/dist/core/index.mjs.map +0 -1
- package/dist/dataLayerProvider-DfI_KYAe.d.cts +0 -61
- package/dist/diagnostics/index.d.cts +0 -458
- package/dist/diagnostics/index.js.map +0 -1
- package/dist/diagnostics/index.mjs.map +0 -1
- package/dist/impl/couch/index.d.cts +0 -620
- package/dist/impl/couch/index.js.map +0 -1
- package/dist/impl/static/index.d.cts +0 -232
- package/dist/impl/static/index.js.map +0 -1
- package/dist/impl/static/index.mjs.map +0 -1
- package/dist/index-Ktg72jKb.d.cts +0 -137
- package/dist/index.d.cts +0 -1663
- package/dist/index.js.map +0 -1
- package/dist/index.mjs.map +0 -1
- package/dist/pouch/index.d.cts +0 -1
- package/dist/pouch/index.js.map +0 -1
- package/dist/pouch/index.mjs.map +0 -1
- package/dist/types-D0oQeJAi.d.cts +0 -58
- package/dist/types-legacy-BkOYOR6U.d.ts +0 -168
- package/dist/util/packer/index.d.cts +0 -5
- package/dist/util/packer/index.js.map +0 -1
- package/dist/util/packer/index.mjs.map +0 -1
- package/src/study/getCardDataShape.ts +0 -34
|
@@ -0,0 +1,771 @@
|
|
|
1
|
+
import "../../_virtual/_rolldown/runtime.mjs";
|
|
2
|
+
import { logger } from "../../util/logger.mjs";
|
|
3
|
+
import { NavigatorRoles, getRegisteredNavigatorNames, getRegisteredNavigatorRole, isFilter, isGenerator } from "./index.mjs";
|
|
4
|
+
//#region src/core/navigators/PipelineDebugger.ts
|
|
5
|
+
/**
|
|
6
|
+
* Captured reference to the most recently created Pipeline instance.
|
|
7
|
+
* Used by the debug API to run diagnostics against the live pipeline.
|
|
8
|
+
*/
|
|
9
|
+
let _activePipeline = null;
|
|
10
|
+
/**
|
|
11
|
+
* Register a pipeline instance for diagnostic access.
|
|
12
|
+
* Called by Pipeline constructor.
|
|
13
|
+
*/
|
|
14
|
+
function registerPipelineForDebug(pipeline) {
|
|
15
|
+
_activePipeline = pipeline;
|
|
16
|
+
}
|
|
17
|
+
/**
|
|
18
|
+
* The most recently constructed pipeline for the current session, or null if
|
|
19
|
+
* none has been built yet. This is the supported, non-debug accessor for
|
|
20
|
+
* out-of-band reads against the live pipeline (e.g. a commit-free
|
|
21
|
+
* `forecast()`), replacing reach-ins through `window.skuilder.pipeline`.
|
|
22
|
+
*/
|
|
23
|
+
function getActivePipeline() {
|
|
24
|
+
return _activePipeline;
|
|
25
|
+
}
|
|
26
|
+
/**
|
|
27
|
+
* Ring buffer for storing recent pipeline runs.
|
|
28
|
+
*/
|
|
29
|
+
const MAX_RUNS = 10;
|
|
30
|
+
const runHistory = [];
|
|
31
|
+
/**
|
|
32
|
+
* Ambient, like `registerPipelineForDebug` — a pipeline is per content-source
|
|
33
|
+
* and can outlive any one session. Set by `SessionController`.
|
|
34
|
+
*/
|
|
35
|
+
let _currentSessionId;
|
|
36
|
+
function setDebugSessionId(sessionId) {
|
|
37
|
+
_currentSessionId = sessionId;
|
|
38
|
+
}
|
|
39
|
+
/**
|
|
40
|
+
* Runs captured since the last drain. `SessionController` drains after each
|
|
41
|
+
* plan and applies its own label — one plan can be several runs (one per
|
|
42
|
+
* source), and the label is the controller's knowledge, not the pipeline's.
|
|
43
|
+
*/
|
|
44
|
+
let _pendingRuns = [];
|
|
45
|
+
/** Take and clear the runs captured since the previous call, in execution order. */
|
|
46
|
+
function drainCapturedRuns() {
|
|
47
|
+
const drained = _pendingRuns;
|
|
48
|
+
_pendingRuns = [];
|
|
49
|
+
return drained;
|
|
50
|
+
}
|
|
51
|
+
/**
|
|
52
|
+
* Runs for `sessionId`, oldest first. Bounded by {@link MAX_RUNS} — the
|
|
53
|
+
* complete record is `StudySessionDoc.runs`.
|
|
54
|
+
*/
|
|
55
|
+
function getRunsForSession(sessionId) {
|
|
56
|
+
return runHistory.filter((r) => r.sessionId === sessionId).reverse();
|
|
57
|
+
}
|
|
58
|
+
/**
|
|
59
|
+
* Cap on non-selected ("discarded") cards retained per run report.
|
|
60
|
+
*
|
|
61
|
+
* Pipeline candidate pools are typically hundreds of cards (ELO window pull
|
|
62
|
+
* + generators), but most are scored down by filters and never selected.
|
|
63
|
+
* Their provenance trails are the dominant text-memory cost in the ring
|
|
64
|
+
* buffer (each entry ~1–2 KB). Retaining only the top-N "near misses"
|
|
65
|
+
* preserves debugging value while collapsing memory roughly an order of
|
|
66
|
+
* magnitude or more.
|
|
67
|
+
*/
|
|
68
|
+
const DISCARDED_KEEP_TOP = 25;
|
|
69
|
+
/**
|
|
70
|
+
* Programmatic clear of pipeline run history.
|
|
71
|
+
*
|
|
72
|
+
* Called by session-lifecycle hooks (session end, course switch, logout)
|
|
73
|
+
* to release retained provenance/tag arrays once they're no longer useful
|
|
74
|
+
* for in-session debugging. The interactive `clear()` debug method remains
|
|
75
|
+
* for manual use.
|
|
76
|
+
*/
|
|
77
|
+
function clearRunHistory() {
|
|
78
|
+
runHistory.length = 0;
|
|
79
|
+
_pendingRuns = [];
|
|
80
|
+
}
|
|
81
|
+
/**
|
|
82
|
+
* What a card is to the learner's queue: a scheduled review (it carries a
|
|
83
|
+
* `reviewID`) or new. The same test as the generator counts and
|
|
84
|
+
* `unselectedNew`. What put it in the queue is {@link RunReportCard.generator}
|
|
85
|
+
* and {@link RunReportCard.required}.
|
|
86
|
+
*/
|
|
87
|
+
function getOrigin(card) {
|
|
88
|
+
return card.reviewID ? "review" : "new";
|
|
89
|
+
}
|
|
90
|
+
/**
|
|
91
|
+
* The hint that made a card mandatory (its provenance name), if one did.
|
|
92
|
+
* applyHints marks a requireCards/requireTags requirement with an infinite
|
|
93
|
+
* score, and nothing else scores a card infinite.
|
|
94
|
+
*/
|
|
95
|
+
function requiredBy(card) {
|
|
96
|
+
return card.provenance.find((p) => p.strategy === "ephemeralHint" && p.score === Number.POSITIVE_INFINITY)?.strategyName;
|
|
97
|
+
}
|
|
98
|
+
/**
|
|
99
|
+
* Capture a pipeline run for later inspection.
|
|
100
|
+
*/
|
|
101
|
+
function captureRun(report) {
|
|
102
|
+
const fullReport = {
|
|
103
|
+
...report,
|
|
104
|
+
runId: `run-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
|
|
105
|
+
sessionId: _currentSessionId,
|
|
106
|
+
timestamp: /* @__PURE__ */ new Date()
|
|
107
|
+
};
|
|
108
|
+
runHistory.unshift(fullReport);
|
|
109
|
+
if (runHistory.length > MAX_RUNS) runHistory.pop();
|
|
110
|
+
_pendingRuns.push(fullReport);
|
|
111
|
+
return fullReport;
|
|
112
|
+
}
|
|
113
|
+
/**
|
|
114
|
+
* Build a capture-ready report from pipeline execution data.
|
|
115
|
+
*/
|
|
116
|
+
/**
|
|
117
|
+
* Parse card ELO from the ELO generator's provenance reason string.
|
|
118
|
+
* Format: "ELO distance XX (card: YYYY, user: ZZZZ), ..."
|
|
119
|
+
*/
|
|
120
|
+
function parseCardElo(provenance) {
|
|
121
|
+
const eloEntry = provenance.find((p) => p.strategy === "elo");
|
|
122
|
+
if (!eloEntry?.reason) return void 0;
|
|
123
|
+
const match = eloEntry.reason.match(/card:\s*(\d+)/);
|
|
124
|
+
return match ? parseInt(match[1], 10) : void 0;
|
|
125
|
+
}
|
|
126
|
+
function buildRunReport(courseId, courseName, generatorName, generators, generatedCount, filters, allCards, selectedCards, userElo, hints, scoredCards, regulators) {
|
|
127
|
+
const selectedIds = new Set(selectedCards.map((c) => c.cardId));
|
|
128
|
+
const toReport = (card) => {
|
|
129
|
+
const required = requiredBy(card);
|
|
130
|
+
const first = card.provenance[0];
|
|
131
|
+
const generator = first && first.strategy !== "ephemeralHint" ? first.strategyName || first.strategy : void 0;
|
|
132
|
+
return {
|
|
133
|
+
cardId: card.cardId,
|
|
134
|
+
courseId: card.courseId,
|
|
135
|
+
origin: getOrigin(card),
|
|
136
|
+
...generator ? { generator } : {},
|
|
137
|
+
...required ? { required } : {},
|
|
138
|
+
finalScore: card.score,
|
|
139
|
+
cardElo: card.cardElo ?? parseCardElo(card.provenance),
|
|
140
|
+
provenance: card.provenance,
|
|
141
|
+
tags: card.tags,
|
|
142
|
+
selected: selectedIds.has(card.cardId)
|
|
143
|
+
};
|
|
144
|
+
};
|
|
145
|
+
const selectedReported = [];
|
|
146
|
+
const nearMissReported = [];
|
|
147
|
+
const discardedTailCards = [];
|
|
148
|
+
let nonSelectedSeen = 0;
|
|
149
|
+
for (const card of allCards) if (selectedIds.has(card.cardId)) selectedReported.push(toReport(card));
|
|
150
|
+
else if (nonSelectedSeen < DISCARDED_KEEP_TOP) {
|
|
151
|
+
nearMissReported.push(toReport(card));
|
|
152
|
+
nonSelectedSeen++;
|
|
153
|
+
} else discardedTailCards.push(card);
|
|
154
|
+
const cards = [...selectedReported, ...nearMissReported];
|
|
155
|
+
let discardedTail;
|
|
156
|
+
if (discardedTailCards.length > 0) {
|
|
157
|
+
let scoreMin = Infinity;
|
|
158
|
+
let scoreMax = -Infinity;
|
|
159
|
+
let eloMin = Infinity;
|
|
160
|
+
let eloMax = -Infinity;
|
|
161
|
+
let eloSeen = false;
|
|
162
|
+
for (const c of discardedTailCards) {
|
|
163
|
+
if (c.score < scoreMin) scoreMin = c.score;
|
|
164
|
+
if (c.score > scoreMax) scoreMax = c.score;
|
|
165
|
+
const elo = parseCardElo(c.provenance);
|
|
166
|
+
if (elo !== void 0) {
|
|
167
|
+
eloSeen = true;
|
|
168
|
+
if (elo < eloMin) eloMin = elo;
|
|
169
|
+
if (elo > eloMax) eloMax = elo;
|
|
170
|
+
}
|
|
171
|
+
}
|
|
172
|
+
const eloFragment = eloSeen ? `, ELO ${eloMin}–${eloMax}` : "";
|
|
173
|
+
discardedTail = {
|
|
174
|
+
count: discardedTailCards.length,
|
|
175
|
+
scoreRange: [scoreMin, scoreMax],
|
|
176
|
+
eloRange: eloSeen ? [eloMin, eloMax] : void 0,
|
|
177
|
+
note: `${discardedTailCards.length} additional candidate(s) scored below the top ${DISCARDED_KEEP_TOP} near-misses and were not retained (score ${scoreMin.toExponential(2)}–${scoreMax.toExponential(2)}${eloFragment}). Likely ELO-window pull remnants filtered out by hierarchy/lesson/priority gates.`
|
|
178
|
+
};
|
|
179
|
+
}
|
|
180
|
+
const isUnselectedNew = (c) => !c.reviewID && !selectedIds.has(c.cardId);
|
|
181
|
+
const generatorScore = (c) => c.provenance[0]?.score ?? 0;
|
|
182
|
+
const keptIds = new Set(allCards.map((c) => c.cardId));
|
|
183
|
+
const hintExcluded = (c) => c.score > 0 && !keptIds.has(c.cardId);
|
|
184
|
+
let nextInLine;
|
|
185
|
+
for (const c of allCards) if (isUnselectedNew(c) && (!nextInLine || c.score > nextInLine.score)) nextInLine = c;
|
|
186
|
+
let topGenerated;
|
|
187
|
+
for (const c of scoredCards ?? allCards) {
|
|
188
|
+
if (!isUnselectedNew(c) || hintExcluded(c)) continue;
|
|
189
|
+
if (!topGenerated || generatorScore(c) > generatorScore(topGenerated)) topGenerated = c;
|
|
190
|
+
}
|
|
191
|
+
const unselectedNew = nextInLine || topGenerated ? {
|
|
192
|
+
...nextInLine ? { nextInLine: toReport(nextInLine) } : {},
|
|
193
|
+
...topGenerated && topGenerated.cardId !== nextInLine?.cardId ? { topGenerated: toReport(topGenerated) } : {}
|
|
194
|
+
} : void 0;
|
|
195
|
+
const reviewsSelected = selectedCards.filter((c) => getOrigin(c) === "review").length;
|
|
196
|
+
const newSelected = selectedCards.filter((c) => getOrigin(c) === "new").length;
|
|
197
|
+
return {
|
|
198
|
+
courseId,
|
|
199
|
+
courseName,
|
|
200
|
+
userElo,
|
|
201
|
+
generatorName,
|
|
202
|
+
generators,
|
|
203
|
+
generatedCount,
|
|
204
|
+
filters,
|
|
205
|
+
hints,
|
|
206
|
+
finalCount: selectedCards.length,
|
|
207
|
+
reviewsSelected,
|
|
208
|
+
newSelected,
|
|
209
|
+
cards,
|
|
210
|
+
unselectedNew,
|
|
211
|
+
discardedTail,
|
|
212
|
+
...regulators ? { regulators } : {}
|
|
213
|
+
};
|
|
214
|
+
}
|
|
215
|
+
/**
|
|
216
|
+
* Format a provenance trail for console display.
|
|
217
|
+
*/
|
|
218
|
+
function formatProvenance(provenance) {
|
|
219
|
+
return provenance.map((p) => {
|
|
220
|
+
return ` ${p.action === "generated" ? "🎲" : p.action === "boosted" ? "⬆️" : p.action === "penalized" ? "⬇️" : "➡️"} ${p.strategyName}: ${p.score.toFixed(3)} - ${p.reason}`;
|
|
221
|
+
}).join("\n");
|
|
222
|
+
}
|
|
223
|
+
/**
|
|
224
|
+
* Print summary of a single pipeline run.
|
|
225
|
+
*/
|
|
226
|
+
function printRunSummary(run) {
|
|
227
|
+
console.group(`🔍 Pipeline Run: ${run.courseId} (${run.courseName || "unnamed"})`);
|
|
228
|
+
logger.print(`Run ID: ${run.runId}`);
|
|
229
|
+
logger.print(`Time: ${run.timestamp.toISOString()}`);
|
|
230
|
+
logger.print(`User ELO: ${run.userElo ?? "unknown"}`);
|
|
231
|
+
logger.print(`Generator: ${run.generatorName} → ${run.generatedCount} candidates`);
|
|
232
|
+
if (run.generators && run.generators.length > 0) {
|
|
233
|
+
console.group("Generator breakdown:");
|
|
234
|
+
for (const g of run.generators) logger.print(` ${g.name}: ${g.cardCount} cards (${g.newCount} new, ${g.reviewCount} reviews, top: ${g.topScore.toFixed(2)})`);
|
|
235
|
+
console.groupEnd();
|
|
236
|
+
}
|
|
237
|
+
if (run.filters.length > 0) {
|
|
238
|
+
console.group("Filter impact:");
|
|
239
|
+
for (const f of run.filters) logger.print(` ${f.name}: ↑${f.boosted} ↓${f.penalized} =${f.passed} ✕${f.removed}`);
|
|
240
|
+
console.groupEnd();
|
|
241
|
+
}
|
|
242
|
+
logger.print(`Result: ${run.finalCount} cards selected (${run.newSelected} new, ${run.reviewsSelected} reviews)`);
|
|
243
|
+
console.groupEnd();
|
|
244
|
+
}
|
|
245
|
+
let _uiContainer = null;
|
|
246
|
+
let _selectedRunIndex = null;
|
|
247
|
+
let _cardSearchQuery = "";
|
|
248
|
+
function escapeHtml(s) {
|
|
249
|
+
return s.replace(/&/g, "&").replace(/</g, "<").replace(/>/g, ">");
|
|
250
|
+
}
|
|
251
|
+
function escapeAttr(s) {
|
|
252
|
+
return escapeHtml(s).replace(/"/g, """);
|
|
253
|
+
}
|
|
254
|
+
function copyTextToClipboard(text, btn) {
|
|
255
|
+
const done = () => {
|
|
256
|
+
if (!btn) return;
|
|
257
|
+
const orig = btn.textContent ?? "Copy";
|
|
258
|
+
btn.textContent = "Copied!";
|
|
259
|
+
btn.classList.add("copied");
|
|
260
|
+
setTimeout(() => {
|
|
261
|
+
btn.textContent = orig;
|
|
262
|
+
btn.classList.remove("copied");
|
|
263
|
+
}, 1200);
|
|
264
|
+
};
|
|
265
|
+
const fallback = () => {
|
|
266
|
+
const ta = document.createElement("textarea");
|
|
267
|
+
ta.value = text;
|
|
268
|
+
ta.style.position = "fixed";
|
|
269
|
+
ta.style.opacity = "0";
|
|
270
|
+
document.body.appendChild(ta);
|
|
271
|
+
ta.select();
|
|
272
|
+
try {
|
|
273
|
+
document.execCommand("copy");
|
|
274
|
+
} catch (e) {
|
|
275
|
+
logger.warn(`[Pipeline Debug] Copy failed: ${e}`);
|
|
276
|
+
}
|
|
277
|
+
document.body.removeChild(ta);
|
|
278
|
+
done();
|
|
279
|
+
};
|
|
280
|
+
if (navigator.clipboard?.writeText) navigator.clipboard.writeText(text).then(done).catch(fallback);
|
|
281
|
+
else fallback();
|
|
282
|
+
}
|
|
283
|
+
function renderUI() {
|
|
284
|
+
if (!_uiContainer) return;
|
|
285
|
+
const runs = runHistory;
|
|
286
|
+
const selectedRun = _selectedRunIndex !== null ? runs[_selectedRunIndex] : null;
|
|
287
|
+
const styles = `
|
|
288
|
+
#sk-pipeline-debugger {
|
|
289
|
+
position: fixed;
|
|
290
|
+
top: 0;
|
|
291
|
+
left: 0;
|
|
292
|
+
width: 100vw;
|
|
293
|
+
height: 100vh;
|
|
294
|
+
background: #f8f9fa;
|
|
295
|
+
color: #212529;
|
|
296
|
+
z-index: 999999;
|
|
297
|
+
display: flex;
|
|
298
|
+
flex-direction: column;
|
|
299
|
+
font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
|
|
300
|
+
font-size: 14px;
|
|
301
|
+
}
|
|
302
|
+
#sk-pipeline-debugger header {
|
|
303
|
+
padding: 1rem;
|
|
304
|
+
background: #343a40;
|
|
305
|
+
color: white;
|
|
306
|
+
display: flex;
|
|
307
|
+
justify-content: space-between;
|
|
308
|
+
align-items: center;
|
|
309
|
+
}
|
|
310
|
+
#sk-pipeline-debugger .container {
|
|
311
|
+
display: flex;
|
|
312
|
+
flex: 1;
|
|
313
|
+
overflow: hidden;
|
|
314
|
+
}
|
|
315
|
+
#sk-pipeline-debugger .sidebar {
|
|
316
|
+
width: 300px;
|
|
317
|
+
border-right: 1px solid #dee2e6;
|
|
318
|
+
overflow-y: auto;
|
|
319
|
+
background: white;
|
|
320
|
+
}
|
|
321
|
+
#sk-pipeline-debugger .main-content {
|
|
322
|
+
flex: 1;
|
|
323
|
+
overflow-y: auto;
|
|
324
|
+
padding: 1.5rem;
|
|
325
|
+
}
|
|
326
|
+
#sk-pipeline-debugger .run-item {
|
|
327
|
+
padding: 0.75rem 1rem;
|
|
328
|
+
border-bottom: 1px solid #eee;
|
|
329
|
+
cursor: pointer;
|
|
330
|
+
}
|
|
331
|
+
#sk-pipeline-debugger .run-item:hover { background: #f1f3f5; }
|
|
332
|
+
#sk-pipeline-debugger .run-item.active { background: #e9ecef; border-left: 4px solid #007bff; }
|
|
333
|
+
#sk-pipeline-debugger h2, #sk-pipeline-debugger h3 { margin-top: 0; }
|
|
334
|
+
#sk-pipeline-debugger table { width: 100%; border-collapse: collapse; margin-bottom: 1rem; background: white; }
|
|
335
|
+
#sk-pipeline-debugger th, #sk-pipeline-debugger td { border: 1px solid #dee2e6; padding: 0.5rem; text-align: left; }
|
|
336
|
+
#sk-pipeline-debugger th { background: #f1f3f5; }
|
|
337
|
+
#sk-pipeline-debugger code { background: #f1f3f5; padding: 0.1rem 0.3rem; border-radius: 3px; font-family: monospace; }
|
|
338
|
+
#sk-pipeline-debugger .close-btn { background: #dc3545; color: white; border: none; padding: 0.5rem 1rem; border-radius: 4px; cursor: pointer; }
|
|
339
|
+
#sk-pipeline-debugger .search-box { margin-bottom: 1rem; width: 100%; padding: 0.5rem; border: 1px solid #ced4da; border-radius: 4px; }
|
|
340
|
+
#sk-pipeline-debugger .provenance { font-size: 12px; color: #666; margin-top: 0.25rem; white-space: pre-wrap; font-family: monospace; background: #f8f9fa; padding: 0.5rem; border-radius: 4px; }
|
|
341
|
+
#sk-pipeline-debugger .run-label { display: inline-block; margin-top: 0.25rem; padding: 0.1rem 0.4rem; background: #fff3cd; color: #664d03; border-radius: 3px; font-family: monospace; font-size: 11px; max-width: 100%; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; vertical-align: bottom; }
|
|
342
|
+
#sk-pipeline-debugger .label-banner { display: inline-block; padding: 0.25rem 0.6rem; background: #fff3cd; color: #664d03; border-radius: 4px; font-family: monospace; font-size: 13px; margin: 0 0 0.75rem 0; }
|
|
343
|
+
#sk-pipeline-debugger .copy-btn { background: #0d6efd; color: white; border: none; padding: 0.25rem 0.6rem; border-radius: 3px; cursor: pointer; font-size: 12px; margin-left: 0.5rem; }
|
|
344
|
+
#sk-pipeline-debugger .copy-btn:hover { background: #0b5ed7; }
|
|
345
|
+
#sk-pipeline-debugger .copy-btn.copied { background: #198754; }
|
|
346
|
+
#sk-pipeline-debugger .section-head { display: flex; align-items: center; justify-content: space-between; margin-top: 1rem; }
|
|
347
|
+
#sk-pipeline-debugger .section-head h3 { margin: 0; }
|
|
348
|
+
`;
|
|
349
|
+
const runListHtml = runs.length === 0 ? "<div style=\"padding: 1rem;\">No runs captured yet.</div>" : runs.map((r, i) => `
|
|
350
|
+
<div class="run-item ${i === _selectedRunIndex ? "active" : ""}" onclick="window.skuilder.pipeline._selectRun(${i})">
|
|
351
|
+
<strong>${r.timestamp.toLocaleTimeString()}</strong><br/>
|
|
352
|
+
<small>${r.courseName || r.courseId.slice(0, 8)}</small><br/>
|
|
353
|
+
<small>${r.finalCount} cards selected</small>
|
|
354
|
+
${r.hints?._label ? `<br/><span class="run-label" title="${escapeAttr(r.hints._label)}">${escapeHtml(r.hints._label)}</span>` : ""}
|
|
355
|
+
</div>
|
|
356
|
+
`).join("");
|
|
357
|
+
let detailsHtml = "<div style=\"color: #6c757d; text-align: center; margin-top: 5rem;\">Select a run to see details</div>";
|
|
358
|
+
if (selectedRun) {
|
|
359
|
+
const filteredCards = selectedRun.cards.filter((c) => !_cardSearchQuery || c.cardId.toLowerCase().includes(_cardSearchQuery.toLowerCase()));
|
|
360
|
+
const labelText = selectedRun.hints?._label ?? "(no label)";
|
|
361
|
+
detailsHtml = `
|
|
362
|
+
<h2>Run: ${selectedRun.runId}</h2>
|
|
363
|
+
<div class="label-banner" title="${escapeAttr(labelText)}">${escapeHtml(labelText)}</div>
|
|
364
|
+
<p>
|
|
365
|
+
<strong>Time:</strong> ${selectedRun.timestamp.toLocaleString()} |
|
|
366
|
+
<strong>Course:</strong> ${selectedRun.courseName || selectedRun.courseId} |
|
|
367
|
+
<strong>User ELO:</strong> ${selectedRun.userElo ?? "unknown"}
|
|
368
|
+
</p>
|
|
369
|
+
|
|
370
|
+
<h3>Pipeline Config</h3>
|
|
371
|
+
<table>
|
|
372
|
+
<tr><th>Generator</th><td>${selectedRun.generatorName} (${selectedRun.generatedCount} candidates)</td></tr>
|
|
373
|
+
${(selectedRun.generators || []).map((g) => `
|
|
374
|
+
<tr><td style="padding-left: 2rem;">↳ ${g.name}</td><td>${g.cardCount} cards (${g.newCount} new, ${g.reviewCount} review, top: ${g.topScore.toFixed(2)})</td></tr>
|
|
375
|
+
`).join("")}
|
|
376
|
+
</table>
|
|
377
|
+
|
|
378
|
+
${selectedRun.hints ? `
|
|
379
|
+
<div class="section-head">
|
|
380
|
+
<h3>Ephemeral Hints</h3>
|
|
381
|
+
<button class="copy-btn" onclick="window.skuilder.pipeline._copyConfig('${selectedRun.runId}', this)">Copy config</button>
|
|
382
|
+
</div>
|
|
383
|
+
<table>
|
|
384
|
+
${selectedRun.hints._label ? `<tr><th>Label</th><td>${selectedRun.hints._label}</td></tr>` : ""}
|
|
385
|
+
${selectedRun.hints.boostTags ? `<tr><th>Boost Tags</th><td><pre style="margin:0">${JSON.stringify(selectedRun.hints.boostTags, null, 2)}</pre></td></tr>` : ""}
|
|
386
|
+
${selectedRun.hints.boostCards ? `<tr><th>Boost Cards</th><td><pre style="margin:0">${JSON.stringify(selectedRun.hints.boostCards, null, 2)}</pre></td></tr>` : ""}
|
|
387
|
+
${selectedRun.hints.requireTags ? `<tr><th>Require Tags</th><td>${selectedRun.hints.requireTags.join(", ")}</td></tr>` : ""}
|
|
388
|
+
${selectedRun.hints.requireCards ? `<tr><th>Require Cards</th><td>${selectedRun.hints.requireCards.join(", ")}</td></tr>` : ""}
|
|
389
|
+
${selectedRun.hints.excludeTags ? `<tr><th>Exclude Tags</th><td>${selectedRun.hints.excludeTags.join(", ")}</td></tr>` : ""}
|
|
390
|
+
${selectedRun.hints.excludeCards ? `<tr><th>Exclude Cards</th><td>${selectedRun.hints.excludeCards.join(", ")}</td></tr>` : ""}
|
|
391
|
+
</table>
|
|
392
|
+
` : ""}
|
|
393
|
+
|
|
394
|
+
<h3>Filter Impact</h3>
|
|
395
|
+
<table>
|
|
396
|
+
<thead><tr><th>Filter</th><th>Boosted</th><th>Penalized</th><th>Passed</th><th>Removed</th></tr></thead>
|
|
397
|
+
<tbody>
|
|
398
|
+
${selectedRun.filters.map((f) => `
|
|
399
|
+
<tr><td>${f.name}</td><td>↑${f.boosted}</td><td>↓${f.penalized}</td><td>=${f.passed}</td><td>✕${f.removed}</td></tr>
|
|
400
|
+
`).join("")}
|
|
401
|
+
</tbody>
|
|
402
|
+
</table>
|
|
403
|
+
|
|
404
|
+
<div class="section-head">
|
|
405
|
+
<h3>Cards (${selectedRun.finalCount} selected / ${selectedRun.cards.length} total)</h3>
|
|
406
|
+
<button class="copy-btn" onclick="window.skuilder.pipeline._copyResults('${selectedRun.runId}', this)">Copy results</button>
|
|
407
|
+
</div>
|
|
408
|
+
<input type="text" class="search-box" placeholder="Search Card ID..." value="${_cardSearchQuery}" oninput="window.skuilder.pipeline._setSearch(this.value)">
|
|
409
|
+
|
|
410
|
+
<table>
|
|
411
|
+
<thead><tr><th>ID</th><th>Generator</th><th>Origin</th><th>Score</th><th>Selected</th></tr></thead>
|
|
412
|
+
<tbody>
|
|
413
|
+
${filteredCards.map((c) => `
|
|
414
|
+
<tr>
|
|
415
|
+
<td><code>${c.cardId}</code></td>
|
|
416
|
+
<td>${c.generator || "unknown"}</td>
|
|
417
|
+
<td>${c.origin}</td>
|
|
418
|
+
<td>${c.finalScore.toFixed(3)}</td>
|
|
419
|
+
<td>${c.selected ? "✅" : "❌"}</td>
|
|
420
|
+
</tr>
|
|
421
|
+
${c.selected || _cardSearchQuery ? `
|
|
422
|
+
<tr>
|
|
423
|
+
<td colspan="5">
|
|
424
|
+
<div class="provenance">${formatProvenance(c.provenance)}</div>
|
|
425
|
+
</td>
|
|
426
|
+
</tr>
|
|
427
|
+
` : ""}
|
|
428
|
+
`).join("")}
|
|
429
|
+
</tbody>
|
|
430
|
+
</table>
|
|
431
|
+
`;
|
|
432
|
+
}
|
|
433
|
+
_uiContainer.innerHTML = `
|
|
434
|
+
<style>${styles}</style>
|
|
435
|
+
<header>
|
|
436
|
+
<strong>Pipeline Debugger</strong>
|
|
437
|
+
<button class="close-btn" onclick="window.skuilder.pipeline.ui()">Close</button>
|
|
438
|
+
</header>
|
|
439
|
+
<div class="container">
|
|
440
|
+
<div class="sidebar">${runListHtml}</div>
|
|
441
|
+
<div class="main-content">${detailsHtml}</div>
|
|
442
|
+
</div>
|
|
443
|
+
`;
|
|
444
|
+
}
|
|
445
|
+
/**
|
|
446
|
+
* Console API object exposed on window.skuilder.pipeline
|
|
447
|
+
*/
|
|
448
|
+
const pipelineDebugAPI = {
|
|
449
|
+
get runs() {
|
|
450
|
+
return [...runHistory];
|
|
451
|
+
},
|
|
452
|
+
showRun(idOrIndex = 0) {
|
|
453
|
+
if (runHistory.length === 0) {
|
|
454
|
+
logger.print("[Pipeline Debug] No runs captured yet.");
|
|
455
|
+
return;
|
|
456
|
+
}
|
|
457
|
+
let run;
|
|
458
|
+
if (typeof idOrIndex === "number") {
|
|
459
|
+
run = runHistory[idOrIndex];
|
|
460
|
+
if (!run) {
|
|
461
|
+
logger.print(`[Pipeline Debug] No run found at index ${idOrIndex}. History length: ${runHistory.length}`);
|
|
462
|
+
return;
|
|
463
|
+
}
|
|
464
|
+
} else {
|
|
465
|
+
run = runHistory.find((r) => r.runId.endsWith(idOrIndex));
|
|
466
|
+
if (!run) {
|
|
467
|
+
logger.print(`[Pipeline Debug] No run found matching ID '${idOrIndex}'.`);
|
|
468
|
+
return;
|
|
469
|
+
}
|
|
470
|
+
}
|
|
471
|
+
printRunSummary(run);
|
|
472
|
+
},
|
|
473
|
+
showLastRun() {
|
|
474
|
+
this.showRun(0);
|
|
475
|
+
},
|
|
476
|
+
showCard(cardId) {
|
|
477
|
+
for (const run of runHistory) {
|
|
478
|
+
const card = run.cards.find((c) => c.cardId === cardId);
|
|
479
|
+
if (card) {
|
|
480
|
+
console.group(`🎴 Card: ${cardId}`);
|
|
481
|
+
logger.print(`Course: ${card.courseId}`);
|
|
482
|
+
logger.print(`Origin: ${card.origin}`);
|
|
483
|
+
logger.print(`Card ELO: ${card.cardElo ?? "unknown"} | User ELO: ${run.userElo ?? "unknown"}`);
|
|
484
|
+
logger.print(`Final score: ${card.finalScore.toFixed(3)}`);
|
|
485
|
+
logger.print(`Selected: ${card.selected ? "Yes ✅" : "No ❌"}`);
|
|
486
|
+
if (card.tags && card.tags.length > 0) logger.print(`Tags (${card.tags.length}): ${card.tags.join(", ")}`);
|
|
487
|
+
logger.print("Provenance:");
|
|
488
|
+
logger.print(formatProvenance(card.provenance));
|
|
489
|
+
console.groupEnd();
|
|
490
|
+
return;
|
|
491
|
+
}
|
|
492
|
+
}
|
|
493
|
+
const runsWithTails = runHistory.filter((r) => r.discardedTail && r.discardedTail.count > 0);
|
|
494
|
+
if (runsWithTails.length > 0) logger.print(`[Pipeline Debug] Card '${cardId}' not found in retained cards. ${runsWithTails.length} run(s) have discarded tails that were not retained — the card may have been a low-score candidate. See run.discardedTail for ranges.`);
|
|
495
|
+
else logger.print(`[Pipeline Debug] Card '${cardId}' not found in recent runs.`);
|
|
496
|
+
},
|
|
497
|
+
explainReviews() {
|
|
498
|
+
if (runHistory.length === 0) {
|
|
499
|
+
logger.print("[Pipeline Debug] No runs captured yet.");
|
|
500
|
+
return;
|
|
501
|
+
}
|
|
502
|
+
console.group("📋 Review Selection Analysis");
|
|
503
|
+
for (const run of runHistory) {
|
|
504
|
+
console.group(`Run: ${run.courseId} @ ${run.timestamp.toLocaleTimeString()}`);
|
|
505
|
+
const allReviews = run.cards.filter((c) => c.origin === "review");
|
|
506
|
+
const selectedReviews = allReviews.filter((c) => c.selected);
|
|
507
|
+
if (allReviews.length === 0) logger.print("❌ No reviews were generated. Check SRS logs for why.");
|
|
508
|
+
else if (selectedReviews.length === 0) {
|
|
509
|
+
logger.print(`⚠️ ${allReviews.length} reviews generated but none selected.`);
|
|
510
|
+
logger.print("Possible reasons:");
|
|
511
|
+
const topNewScore = Math.max(...run.cards.filter((c) => c.origin === "new" && c.selected).map((c) => c.finalScore), 0);
|
|
512
|
+
const topReviewScore = Math.max(...allReviews.map((c) => c.finalScore), 0);
|
|
513
|
+
if (topReviewScore < topNewScore) logger.print(` - New cards scored higher (top new: ${topNewScore.toFixed(2)}, top review: ${topReviewScore.toFixed(2)})`);
|
|
514
|
+
const topReview = allReviews.sort((a, b) => b.finalScore - a.finalScore)[0];
|
|
515
|
+
if (topReview) {
|
|
516
|
+
logger.print(` - Top review score: ${topReview.finalScore.toFixed(3)}`);
|
|
517
|
+
logger.print(" - Its provenance:");
|
|
518
|
+
logger.print(formatProvenance(topReview.provenance));
|
|
519
|
+
}
|
|
520
|
+
} else {
|
|
521
|
+
logger.print(`✅ ${selectedReviews.length}/${allReviews.length} reviews selected.`);
|
|
522
|
+
logger.print("Top selected review:");
|
|
523
|
+
const topSelected = selectedReviews.sort((a, b) => b.finalScore - a.finalScore)[0];
|
|
524
|
+
logger.print(formatProvenance(topSelected.provenance));
|
|
525
|
+
}
|
|
526
|
+
console.groupEnd();
|
|
527
|
+
}
|
|
528
|
+
console.groupEnd();
|
|
529
|
+
},
|
|
530
|
+
showPrescribed(groupId) {
|
|
531
|
+
if (runHistory.length === 0) {
|
|
532
|
+
logger.print("[Pipeline Debug] No runs captured yet.");
|
|
533
|
+
return;
|
|
534
|
+
}
|
|
535
|
+
const run = runHistory[0];
|
|
536
|
+
const prescribedCards = run.cards.filter((c) => c.provenance.some((p) => p.strategy === "prescribed"));
|
|
537
|
+
console.group(`🧭 Prescribed Debug (${run.courseId})`);
|
|
538
|
+
if (prescribedCards.length === 0) {
|
|
539
|
+
logger.print("No prescribed-generated cards were present in the most recent run.");
|
|
540
|
+
console.groupEnd();
|
|
541
|
+
return;
|
|
542
|
+
}
|
|
543
|
+
const rows = prescribedCards.map((card) => {
|
|
544
|
+
const reason = card.provenance.find((p) => p.strategy === "prescribed")?.reason ?? "";
|
|
545
|
+
const parsedGroup = reason.match(/group=([^;]+)/)?.[1] ?? "unknown";
|
|
546
|
+
const mode = reason.match(/mode=([^;]+)/)?.[1] ?? "unknown";
|
|
547
|
+
const blocked = reason.match(/blocked=([^;]+)/)?.[1] ?? "unknown";
|
|
548
|
+
const blockedTargets = reason.match(/blockedTargets=([^;]+)/)?.[1] ?? "none";
|
|
549
|
+
const supportCard = reason.match(/supportCard=([^;]+)/)?.[1] ?? "none";
|
|
550
|
+
const supportTags = reason.match(/supportTags=([^;]+)/)?.[1] ?? "none";
|
|
551
|
+
const multiplier = reason.match(/multiplier=([^;]+)/)?.[1] ?? "unknown";
|
|
552
|
+
return {
|
|
553
|
+
group: parsedGroup,
|
|
554
|
+
mode,
|
|
555
|
+
supportSource: mode === "discovered-support" ? "discovered" : mode === "support" ? "authored" : "n/a",
|
|
556
|
+
cardId: card.cardId,
|
|
557
|
+
selected: card.selected ? "yes" : "no",
|
|
558
|
+
finalScore: card.finalScore.toFixed(3),
|
|
559
|
+
blocked,
|
|
560
|
+
blockedTargets,
|
|
561
|
+
supportCard,
|
|
562
|
+
supportTags,
|
|
563
|
+
multiplier
|
|
564
|
+
};
|
|
565
|
+
}).filter((row) => !groupId || row.group === groupId).sort((a, b) => Number(b.finalScore) - Number(a.finalScore));
|
|
566
|
+
if (rows.length === 0) {
|
|
567
|
+
logger.print(`[Pipeline Debug] No prescribed cards matched group '${groupId}' in the most recent run.`);
|
|
568
|
+
console.groupEnd();
|
|
569
|
+
return;
|
|
570
|
+
}
|
|
571
|
+
console.table(rows);
|
|
572
|
+
const selectedRows = rows.filter((r) => r.selected === "yes");
|
|
573
|
+
const blockedTargetSet = /* @__PURE__ */ new Set();
|
|
574
|
+
const supportTagSet = /* @__PURE__ */ new Set();
|
|
575
|
+
const authoredSupportSet = /* @__PURE__ */ new Set();
|
|
576
|
+
const discoveredSupportSet = /* @__PURE__ */ new Set();
|
|
577
|
+
for (const row of rows) {
|
|
578
|
+
if (row.blockedTargets && row.blockedTargets !== "none") row.blockedTargets.split("|").filter(Boolean).forEach((t) => blockedTargetSet.add(t));
|
|
579
|
+
if (row.supportTags && row.supportTags !== "none") row.supportTags.split("|").filter(Boolean).forEach((t) => supportTagSet.add(t));
|
|
580
|
+
if (row.supportCard && row.supportCard !== "none") {
|
|
581
|
+
if (row.supportSource === "discovered") discoveredSupportSet.add(row.supportCard);
|
|
582
|
+
else if (row.supportSource === "authored") authoredSupportSet.add(row.supportCard);
|
|
583
|
+
}
|
|
584
|
+
}
|
|
585
|
+
logger.print(`Prescribed cards in run: ${rows.length}`);
|
|
586
|
+
logger.print(`Selected prescribed cards: ${selectedRows.length}`);
|
|
587
|
+
logger.print(`Blocked prescribed targets referenced: ${blockedTargetSet.size > 0 ? [...blockedTargetSet].join(", ") : "none"}`);
|
|
588
|
+
logger.print(`Resolved support tags referenced: ${supportTagSet.size > 0 ? [...supportTagSet].join(", ") : "none"}`);
|
|
589
|
+
logger.print(`Authored support cards emitted: ${authoredSupportSet.size > 0 ? [...authoredSupportSet].join(", ") : "none"}`);
|
|
590
|
+
logger.print(`Discovered support cards emitted: ${discoveredSupportSet.size > 0 ? [...discoveredSupportSet].join(", ") : "none"}`);
|
|
591
|
+
console.groupEnd();
|
|
592
|
+
},
|
|
593
|
+
listRuns() {
|
|
594
|
+
if (runHistory.length === 0) {
|
|
595
|
+
logger.print("[Pipeline Debug] No runs captured yet.");
|
|
596
|
+
return;
|
|
597
|
+
}
|
|
598
|
+
console.table(runHistory.map((r) => ({
|
|
599
|
+
id: r.runId.slice(-8),
|
|
600
|
+
time: r.timestamp.toLocaleTimeString(),
|
|
601
|
+
course: r.courseName || r.courseId.slice(0, 8),
|
|
602
|
+
generated: r.generatedCount,
|
|
603
|
+
selected: r.finalCount,
|
|
604
|
+
new: r.newSelected,
|
|
605
|
+
reviews: r.reviewsSelected
|
|
606
|
+
})));
|
|
607
|
+
},
|
|
608
|
+
export() {
|
|
609
|
+
const json = JSON.stringify(runHistory, null, 2);
|
|
610
|
+
logger.print("[Pipeline Debug] Run history exported. Copy the returned string or use:");
|
|
611
|
+
logger.print(" copy(window.skuilder.pipeline.export())");
|
|
612
|
+
return json;
|
|
613
|
+
},
|
|
614
|
+
clear() {
|
|
615
|
+
runHistory.length = 0;
|
|
616
|
+
logger.print("[Pipeline Debug] Run history cleared.");
|
|
617
|
+
},
|
|
618
|
+
showRegistry() {
|
|
619
|
+
const names = getRegisteredNavigatorNames();
|
|
620
|
+
if (names.length === 0) {
|
|
621
|
+
logger.print("[Pipeline Debug] Navigator registry is empty.");
|
|
622
|
+
return;
|
|
623
|
+
}
|
|
624
|
+
console.group("📦 Navigator Registry");
|
|
625
|
+
console.table(names.map((name) => {
|
|
626
|
+
const registryRole = getRegisteredNavigatorRole(name);
|
|
627
|
+
const builtinRole = NavigatorRoles[name];
|
|
628
|
+
return {
|
|
629
|
+
name,
|
|
630
|
+
role: builtinRole || registryRole || "⚠️ NONE",
|
|
631
|
+
source: builtinRole ? "built-in" : registryRole ? "consumer" : "unclassified",
|
|
632
|
+
isGenerator: isGenerator(name),
|
|
633
|
+
isFilter: isFilter(name)
|
|
634
|
+
};
|
|
635
|
+
}));
|
|
636
|
+
console.groupEnd();
|
|
637
|
+
},
|
|
638
|
+
showStrategies() {
|
|
639
|
+
this.showRegistry();
|
|
640
|
+
if (runHistory.length === 0) {
|
|
641
|
+
logger.print("[Pipeline Debug] No pipeline runs captured yet — cannot show strategy doc mapping.");
|
|
642
|
+
return;
|
|
643
|
+
}
|
|
644
|
+
const run = runHistory[0];
|
|
645
|
+
console.group("🔌 Pipeline Strategy Mapping (last run)");
|
|
646
|
+
logger.print(`Generator: ${run.generatorName}`);
|
|
647
|
+
if (run.generators && run.generators.length > 0) for (const g of run.generators) logger.print(` 📥 ${g.name}: ${g.cardCount} cards (${g.newCount} new, ${g.reviewCount} reviews)`);
|
|
648
|
+
if (run.filters.length > 0) {
|
|
649
|
+
logger.print("Filters:");
|
|
650
|
+
for (const f of run.filters) logger.print(` 🔸 ${f.name}: ↑${f.boosted} ↓${f.penalized} =${f.passed} ✕${f.removed}`);
|
|
651
|
+
} else logger.print("Filters: (none)");
|
|
652
|
+
console.groupEnd();
|
|
653
|
+
},
|
|
654
|
+
async diagnoseCardSpace(threshold) {
|
|
655
|
+
if (!_activePipeline) {
|
|
656
|
+
logger.print("[Pipeline Debug] No active pipeline. Run a session first.");
|
|
657
|
+
return null;
|
|
658
|
+
}
|
|
659
|
+
return _activePipeline.diagnoseCardSpace({ threshold });
|
|
660
|
+
},
|
|
661
|
+
async showTagElo(tagFilter) {
|
|
662
|
+
if (!_activePipeline) {
|
|
663
|
+
logger.print("[Pipeline Debug] No active pipeline. Run a session first.");
|
|
664
|
+
return;
|
|
665
|
+
}
|
|
666
|
+
const status = await _activePipeline.getTagEloStatus(tagFilter);
|
|
667
|
+
const entries = Object.entries(status).sort(([a], [b]) => a.localeCompare(b));
|
|
668
|
+
if (entries.length === 0) {
|
|
669
|
+
logger.print(`[Pipeline Debug] No tag ELO data found${tagFilter ? ` for pattern: ${tagFilter}` : ""}.`);
|
|
670
|
+
return;
|
|
671
|
+
}
|
|
672
|
+
console.table(Object.fromEntries(entries.map(([tag, data]) => [tag, {
|
|
673
|
+
score: Math.round(data.score),
|
|
674
|
+
count: data.count
|
|
675
|
+
}])));
|
|
676
|
+
},
|
|
677
|
+
ui() {
|
|
678
|
+
if (_uiContainer) {
|
|
679
|
+
document.body.removeChild(_uiContainer);
|
|
680
|
+
_uiContainer = null;
|
|
681
|
+
return;
|
|
682
|
+
}
|
|
683
|
+
_uiContainer = document.createElement("div");
|
|
684
|
+
_uiContainer.id = "sk-pipeline-debugger";
|
|
685
|
+
document.body.appendChild(_uiContainer);
|
|
686
|
+
if (_selectedRunIndex === null && runHistory.length > 0) _selectedRunIndex = 0;
|
|
687
|
+
renderUI();
|
|
688
|
+
},
|
|
689
|
+
_selectRun(index) {
|
|
690
|
+
_selectedRunIndex = index;
|
|
691
|
+
renderUI();
|
|
692
|
+
},
|
|
693
|
+
_setSearch(query) {
|
|
694
|
+
_cardSearchQuery = query;
|
|
695
|
+
renderUI();
|
|
696
|
+
},
|
|
697
|
+
_copyConfig(runId, btn) {
|
|
698
|
+
const run = runHistory.find((r) => r.runId === runId);
|
|
699
|
+
if (!run) return;
|
|
700
|
+
const payload = {
|
|
701
|
+
runId: run.runId,
|
|
702
|
+
timestamp: run.timestamp.toISOString(),
|
|
703
|
+
courseId: run.courseId,
|
|
704
|
+
courseName: run.courseName,
|
|
705
|
+
hints: run.hints ?? null
|
|
706
|
+
};
|
|
707
|
+
copyTextToClipboard(JSON.stringify(payload, null, 2), btn);
|
|
708
|
+
},
|
|
709
|
+
_copyResults(runId, btn) {
|
|
710
|
+
const run = runHistory.find((r) => r.runId === runId);
|
|
711
|
+
if (!run) return;
|
|
712
|
+
const selected = run.cards.filter((c) => c.selected).sort((a, b) => b.finalScore - a.finalScore).map((c) => ({
|
|
713
|
+
cardId: c.cardId,
|
|
714
|
+
generator: c.generator,
|
|
715
|
+
origin: c.origin,
|
|
716
|
+
score: Number(c.finalScore.toFixed(3)),
|
|
717
|
+
topReason: c.provenance[0]?.reason ?? ""
|
|
718
|
+
}));
|
|
719
|
+
const payload = {
|
|
720
|
+
runId: run.runId,
|
|
721
|
+
label: run.hints?._label ?? null,
|
|
722
|
+
finalCount: run.finalCount,
|
|
723
|
+
newSelected: run.newSelected,
|
|
724
|
+
reviewsSelected: run.reviewsSelected,
|
|
725
|
+
selected
|
|
726
|
+
};
|
|
727
|
+
copyTextToClipboard(JSON.stringify(payload, null, 2), btn);
|
|
728
|
+
},
|
|
729
|
+
help() {
|
|
730
|
+
logger.print(`
|
|
731
|
+
🔧 Pipeline Debug API
|
|
732
|
+
|
|
733
|
+
Commands:
|
|
734
|
+
.ui() Toggle full-screen UI debugger
|
|
735
|
+
.showLastRun() Show summary of most recent pipeline run
|
|
736
|
+
.showRun(id|index) Show summary of a specific run (by index or ID suffix)
|
|
737
|
+
.showCard(cardId) Show provenance trail for a specific card
|
|
738
|
+
.showTagElo(pattern) Show user's tag ELO data (async). E.g. 'gpc:expose:*'
|
|
739
|
+
.explainReviews() Analyze why reviews were/weren't selected
|
|
740
|
+
.diagnoseCardSpace() Scan full card space through filters (async)
|
|
741
|
+
.showRegistry() Show navigator registry (classes + roles)
|
|
742
|
+
.showStrategies() Show registry + strategy mapping from last run
|
|
743
|
+
.showPrescribed(id?) Show prescribed-generated cards and blocked/support details from last run
|
|
744
|
+
.listRuns() List all captured runs in table format
|
|
745
|
+
.export() Export run history as JSON for bug reports
|
|
746
|
+
.clear() Clear run history
|
|
747
|
+
.runs Access raw run history array
|
|
748
|
+
.help() Show this help message
|
|
749
|
+
|
|
750
|
+
Example:
|
|
751
|
+
window.skuilder.pipeline.ui()
|
|
752
|
+
window.skuilder.pipeline.showLastRun()
|
|
753
|
+
window.skuilder.pipeline.showRun(1)
|
|
754
|
+
await window.skuilder.pipeline.diagnoseCardSpace()
|
|
755
|
+
`);
|
|
756
|
+
}
|
|
757
|
+
};
|
|
758
|
+
/**
|
|
759
|
+
* Mount the debug API on window.skuilder.pipeline
|
|
760
|
+
*/
|
|
761
|
+
function mountPipelineDebugger() {
|
|
762
|
+
if (typeof window === "undefined") return;
|
|
763
|
+
const win = window;
|
|
764
|
+
win.skuilder = win.skuilder || {};
|
|
765
|
+
win.skuilder.pipeline = pipelineDebugAPI;
|
|
766
|
+
}
|
|
767
|
+
mountPipelineDebugger();
|
|
768
|
+
//#endregion
|
|
769
|
+
export { buildRunReport, captureRun, clearRunHistory, drainCapturedRuns, getActivePipeline, getRunsForSession, mountPipelineDebugger, pipelineDebugAPI, registerPipelineForDebug, setDebugSessionId };
|
|
770
|
+
|
|
771
|
+
//# sourceMappingURL=PipelineDebugger.mjs.map
|