@vue-skuilder/db 0.2.30 → 0.2.32
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/dist/{contentSource-B6FrSihy.d.cts → contentSource-CTQ4kWhR.d.cts} +41 -4
- package/dist/{contentSource-CqJmbOZN.d.ts → contentSource-JmWYu8IK.d.ts} +41 -4
- package/dist/core/index.d.cts +3 -3
- package/dist/core/index.d.ts +3 -3
- package/dist/core/index.js +138 -79
- package/dist/core/index.js.map +1 -1
- package/dist/core/index.mjs +90 -30
- package/dist/core/index.mjs.map +1 -1
- package/dist/{dataLayerProvider-DUxDqMtZ.d.cts → dataLayerProvider-DfI_KYAe.d.cts} +1 -1
- package/dist/{dataLayerProvider-B9_UCvkR.d.ts → dataLayerProvider-rlLE2Mf-.d.ts} +1 -1
- package/dist/diagnostics/index.d.cts +18 -3
- package/dist/diagnostics/index.d.ts +18 -3
- package/dist/diagnostics/index.js +171 -135
- package/dist/diagnostics/index.js.map +1 -1
- package/dist/diagnostics/index.mjs +168 -135
- package/dist/diagnostics/index.mjs.map +1 -1
- package/dist/impl/couch/index.d.cts +8 -2
- package/dist/impl/couch/index.d.ts +8 -2
- package/dist/impl/couch/index.js +142 -83
- package/dist/impl/couch/index.js.map +1 -1
- package/dist/impl/couch/index.mjs +90 -30
- package/dist/impl/couch/index.mjs.map +1 -1
- package/dist/impl/static/index.d.cts +2 -2
- package/dist/impl/static/index.d.ts +2 -2
- package/dist/impl/static/index.js +129 -70
- package/dist/impl/static/index.js.map +1 -1
- package/dist/impl/static/index.mjs +90 -30
- package/dist/impl/static/index.mjs.map +1 -1
- package/dist/index.d.cts +5 -3
- package/dist/index.d.ts +5 -3
- package/dist/index.js +204 -114
- package/dist/index.js.map +1 -1
- package/dist/index.mjs +128 -37
- package/dist/index.mjs.map +1 -1
- package/package.json +3 -3
- package/src/core/navigators/Pipeline.ts +13 -2
- package/src/core/navigators/PipelineAssembler.ts +2 -0
- package/src/core/navigators/PipelineDebugger.ts +54 -23
- package/src/core/navigators/defaults.ts +4 -1
- package/src/core/navigators/filters/eloDistance.ts +7 -8
- package/src/core/navigators/generators/elo.ts +8 -2
- package/src/core/navigators/generators/prescribed.ts +7 -5
- package/src/core/types/studySession.ts +23 -2
- package/src/core/versionStamps.ts +66 -0
- package/src/diagnostics/derive.ts +5 -2
- package/src/diagnostics/pipeline.ts +28 -0
- package/src/diagnostics/text.ts +24 -4
- package/src/factory.ts +6 -0
- package/src/study/SessionController.ts +6 -1
- package/src/study/services/EloService.ts +33 -6
- package/tsup.config.ts +5 -0
|
@@ -748,13 +748,12 @@ function clearRunHistory() {
|
|
|
748
748
|
_pendingRuns = [];
|
|
749
749
|
}
|
|
750
750
|
function getOrigin(card) {
|
|
751
|
-
|
|
752
|
-
|
|
753
|
-
|
|
754
|
-
|
|
755
|
-
|
|
756
|
-
|
|
757
|
-
return "unknown";
|
|
751
|
+
return card.reviewID ? "review" : "new";
|
|
752
|
+
}
|
|
753
|
+
function requiredBy(card) {
|
|
754
|
+
return card.provenance.find(
|
|
755
|
+
(p) => p.strategy === "ephemeralHint" && p.score === Number.POSITIVE_INFINITY
|
|
756
|
+
)?.strategyName;
|
|
758
757
|
}
|
|
759
758
|
function captureRun(report) {
|
|
760
759
|
const fullReport = {
|
|
@@ -778,17 +777,23 @@ function parseCardElo(provenance) {
|
|
|
778
777
|
}
|
|
779
778
|
function buildRunReport(courseId, courseName, generatorName, generators, generatedCount, filters, allCards, selectedCards, userElo, hints, scoredCards, regulators) {
|
|
780
779
|
const selectedIds = new Set(selectedCards.map((c) => c.cardId));
|
|
781
|
-
const toReport = (card) =>
|
|
782
|
-
|
|
783
|
-
|
|
784
|
-
|
|
785
|
-
|
|
786
|
-
|
|
787
|
-
|
|
788
|
-
|
|
789
|
-
|
|
790
|
-
|
|
791
|
-
|
|
780
|
+
const toReport = (card) => {
|
|
781
|
+
const required = requiredBy(card);
|
|
782
|
+
const first = card.provenance[0];
|
|
783
|
+
const generator = first && first.strategy !== "ephemeralHint" ? first.strategyName || first.strategy : void 0;
|
|
784
|
+
return {
|
|
785
|
+
cardId: card.cardId,
|
|
786
|
+
courseId: card.courseId,
|
|
787
|
+
origin: getOrigin(card),
|
|
788
|
+
...generator ? { generator } : {},
|
|
789
|
+
...required ? { required } : {},
|
|
790
|
+
finalScore: card.score,
|
|
791
|
+
cardElo: card.cardElo ?? parseCardElo(card.provenance),
|
|
792
|
+
provenance: card.provenance,
|
|
793
|
+
tags: card.tags,
|
|
794
|
+
selected: selectedIds.has(card.cardId)
|
|
795
|
+
};
|
|
796
|
+
};
|
|
792
797
|
const selectedReported = [];
|
|
793
798
|
const nearMissReported = [];
|
|
794
799
|
const discardedTailCards = [];
|
|
@@ -1917,10 +1922,14 @@ var init_elo = __esm({
|
|
|
1917
1922
|
const userElo = toCourseElo2(courseReg.elo);
|
|
1918
1923
|
userGlobalElo = userElo.global.score;
|
|
1919
1924
|
}
|
|
1920
|
-
const activeCards = await
|
|
1925
|
+
const [activeCards, seenCards] = await Promise.all([
|
|
1926
|
+
this.user.getActiveCards(),
|
|
1927
|
+
this.user.getSeenCards(this.course.getCourseID()).catch(() => [])
|
|
1928
|
+
]);
|
|
1929
|
+
const notNew = /* @__PURE__ */ new Set([...activeCards.map((ac) => ac.cardID), ...seenCards]);
|
|
1921
1930
|
const newCards = (await this.course.getCardsCenteredAtELO(
|
|
1922
1931
|
{ limit, elo: "user" },
|
|
1923
|
-
(c) => !
|
|
1932
|
+
(c) => !notNew.has(c.cardID)
|
|
1924
1933
|
)).map((c) => ({ ...c, status: "new" }));
|
|
1925
1934
|
const scored = newCards.map((c) => {
|
|
1926
1935
|
const cardElo = c.elo ?? 1e3;
|
|
@@ -1973,6 +1982,7 @@ __export(prescribed_exports, {
|
|
|
1973
1982
|
default: () => PrescribedCardsGenerator,
|
|
1974
1983
|
unmetIntroExposeTags: () => unmetIntroExposeTags
|
|
1975
1984
|
});
|
|
1985
|
+
import { tagRole, withTagRole } from "@vue-skuilder/common";
|
|
1976
1986
|
function dedupe(arr) {
|
|
1977
1987
|
return [...new Set(arr)];
|
|
1978
1988
|
}
|
|
@@ -2013,11 +2023,11 @@ function formatAge(ms) {
|
|
|
2013
2023
|
}
|
|
2014
2024
|
function unmetIntroExposeTags(tags, userTagElo, minCount) {
|
|
2015
2025
|
if (minCount <= 0) return [];
|
|
2016
|
-
const exposeTags = new Set(tags.filter((tag) => tag
|
|
2026
|
+
const exposeTags = new Set(tags.filter((tag) => tagRole(tag) === "expose"));
|
|
2017
2027
|
for (const tag of tags) {
|
|
2018
|
-
if (
|
|
2019
|
-
const
|
|
2020
|
-
if (
|
|
2028
|
+
if (tagRole(tag) !== "intro") continue;
|
|
2029
|
+
const expose = withTagRole(tag, "expose");
|
|
2030
|
+
if (expose) exposeTags.add(expose);
|
|
2021
2031
|
}
|
|
2022
2032
|
return [...exposeTags].filter((tag) => {
|
|
2023
2033
|
const tagElo = userTagElo[tag];
|
|
@@ -3219,6 +3229,7 @@ __export(eloDistance_exports, {
|
|
|
3219
3229
|
mountMultiDimEloToggle: () => mountMultiDimEloToggle,
|
|
3220
3230
|
tagAwareGap: () => tagAwareGap
|
|
3221
3231
|
});
|
|
3232
|
+
import { COUNT_ONLY_SCORE, isCountOnlyTag } from "@vue-skuilder/common";
|
|
3222
3233
|
function computeMultiplier(distance, halfLife, minMultiplier, maxMultiplier) {
|
|
3223
3234
|
const normalizedDistance = distance / halfLife;
|
|
3224
3235
|
const decay = Math.exp(-(normalizedDistance * normalizedDistance));
|
|
@@ -3261,7 +3272,9 @@ function tagAwareGap(cardTags, cardElo, userElo, minTagCount) {
|
|
|
3261
3272
|
const tags = [];
|
|
3262
3273
|
for (const tag of cardTags) {
|
|
3263
3274
|
const user = userElo.tags[tag];
|
|
3264
|
-
if (!user || user.score ===
|
|
3275
|
+
if (isCountOnlyTag(tag) || !user || user.score === COUNT_ONLY_SCORE || user.count < minTagCount) {
|
|
3276
|
+
continue;
|
|
3277
|
+
}
|
|
3265
3278
|
const card = cardElo.tags[tag]?.score ?? cardElo.global.score;
|
|
3266
3279
|
tags.push({
|
|
3267
3280
|
tag,
|
|
@@ -3333,7 +3346,7 @@ function createEloDistanceFilter(config) {
|
|
|
3333
3346
|
transform: (cards, context) => applyEloDistance(cards, context, resolved, source)
|
|
3334
3347
|
};
|
|
3335
3348
|
}
|
|
3336
|
-
var DEFAULT_ELO_DISTANCE_CONFIG, TAG_CONFIDENCE_HALF,
|
|
3349
|
+
var DEFAULT_ELO_DISTANCE_CONFIG, TAG_CONFIDENCE_HALF, DEFAULT_CARD_ELO, MULTI_DIM_ELO_KEY, multiDimElo, EloDistanceFilter;
|
|
3337
3350
|
var init_eloDistance = __esm({
|
|
3338
3351
|
"src/core/navigators/filters/eloDistance.ts"() {
|
|
3339
3352
|
"use strict";
|
|
@@ -3347,7 +3360,6 @@ var init_eloDistance = __esm({
|
|
|
3347
3360
|
minTagCount: 3
|
|
3348
3361
|
};
|
|
3349
3362
|
TAG_CONFIDENCE_HALF = 10;
|
|
3350
|
-
COUNT_ONLY_SENTINEL = -1;
|
|
3351
3363
|
DEFAULT_CARD_ELO = 1e3;
|
|
3352
3364
|
MULTI_DIM_ELO_KEY = "skuilder:multiDimElo";
|
|
3353
3365
|
multiDimElo = readMultiDimElo();
|
|
@@ -4476,6 +4488,11 @@ var init_Pipeline = __esm({
|
|
|
4476
4488
|
* This eliminates a remote getCourseConfig() round trip per pipeline run.
|
|
4477
4489
|
*/
|
|
4478
4490
|
_cachedOrchestration = null;
|
|
4491
|
+
/**
|
|
4492
|
+
* Hash of the strategy docs this pipeline was assembled from (see
|
|
4493
|
+
* versionStamps.ts), set by whoever builds it. Stamped on every run.
|
|
4494
|
+
*/
|
|
4495
|
+
strategyHash;
|
|
4479
4496
|
/**
|
|
4480
4497
|
* Persistent tag cache. Maps cardId → tag names.
|
|
4481
4498
|
*
|
|
@@ -4669,7 +4686,8 @@ var init_Pipeline = __esm({
|
|
|
4669
4686
|
logResultCards(result);
|
|
4670
4687
|
logCardProvenance(result, 3);
|
|
4671
4688
|
try {
|
|
4672
|
-
const
|
|
4689
|
+
const courseConfig = await this.course?.getCourseConfig().catch(() => void 0);
|
|
4690
|
+
const courseName = courseConfig?.name;
|
|
4673
4691
|
const report = buildRunReport(
|
|
4674
4692
|
this.course?.getCourseID() || "unknown",
|
|
4675
4693
|
courseName,
|
|
@@ -4684,7 +4702,11 @@ var init_Pipeline = __esm({
|
|
|
4684
4702
|
scoredCards,
|
|
4685
4703
|
regulators
|
|
4686
4704
|
);
|
|
4687
|
-
|
|
4705
|
+
const versions = {
|
|
4706
|
+
...this.strategyHash ? { strategies: this.strategyHash } : {},
|
|
4707
|
+
...courseConfig?.contentVersion ? { content: courseConfig.contentVersion } : {}
|
|
4708
|
+
};
|
|
4709
|
+
captureRun({ ...report, ...Object.keys(versions).length ? { versions } : {} });
|
|
4688
4710
|
} catch (e) {
|
|
4689
4711
|
logger.debug(`[Pipeline] Failed to capture debug run: ${e}`);
|
|
4690
4712
|
}
|
|
@@ -5181,6 +5203,36 @@ var init_Pipeline = __esm({
|
|
|
5181
5203
|
}
|
|
5182
5204
|
});
|
|
5183
5205
|
|
|
5206
|
+
// src/core/versionStamps.ts
|
|
5207
|
+
function stableStringify(value) {
|
|
5208
|
+
if (Array.isArray(value)) return `[${value.map(stableStringify).join(",")}]`;
|
|
5209
|
+
if (value && typeof value === "object") {
|
|
5210
|
+
const entries = Object.entries(value).filter(([, v]) => v !== void 0).sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0);
|
|
5211
|
+
return `{${entries.map(([k, v]) => `${JSON.stringify(k)}:${stableStringify(v)}`).join(",")}}`;
|
|
5212
|
+
}
|
|
5213
|
+
return JSON.stringify(value);
|
|
5214
|
+
}
|
|
5215
|
+
function strategyHash(strategies) {
|
|
5216
|
+
if (strategies.length === 0) return DEFAULT_STRATEGY_HASH;
|
|
5217
|
+
const text = strategies.map((s) => {
|
|
5218
|
+
const { _rev: _ignored, ...rest } = s;
|
|
5219
|
+
return stableStringify(rest);
|
|
5220
|
+
}).sort().join("\n");
|
|
5221
|
+
let h = 2166136261;
|
|
5222
|
+
for (let i = 0; i < text.length; i++) {
|
|
5223
|
+
h ^= text.charCodeAt(i);
|
|
5224
|
+
h = Math.imul(h, 16777619);
|
|
5225
|
+
}
|
|
5226
|
+
return (h >>> 0).toString(16).padStart(8, "0");
|
|
5227
|
+
}
|
|
5228
|
+
var DEFAULT_STRATEGY_HASH;
|
|
5229
|
+
var init_versionStamps = __esm({
|
|
5230
|
+
"src/core/versionStamps.ts"() {
|
|
5231
|
+
"use strict";
|
|
5232
|
+
DEFAULT_STRATEGY_HASH = "default";
|
|
5233
|
+
}
|
|
5234
|
+
});
|
|
5235
|
+
|
|
5184
5236
|
// src/core/navigators/defaults.ts
|
|
5185
5237
|
var defaults_exports = {};
|
|
5186
5238
|
__export(defaults_exports, {
|
|
@@ -5233,7 +5285,9 @@ function createDefaultPipeline(user, course) {
|
|
|
5233
5285
|
course,
|
|
5234
5286
|
createDefaultEloDistanceStrategy(courseId)
|
|
5235
5287
|
);
|
|
5236
|
-
|
|
5288
|
+
const pipeline = new Pipeline(compositeGenerator, [eloDistanceFilter], user, course);
|
|
5289
|
+
pipeline.strategyHash = DEFAULT_STRATEGY_HASH;
|
|
5290
|
+
return pipeline;
|
|
5237
5291
|
}
|
|
5238
5292
|
var init_defaults = __esm({
|
|
5239
5293
|
"src/core/navigators/defaults.ts"() {
|
|
@@ -5245,6 +5299,7 @@ var init_defaults = __esm({
|
|
|
5245
5299
|
init_srs();
|
|
5246
5300
|
init_eloDistance();
|
|
5247
5301
|
init_types_legacy();
|
|
5302
|
+
init_versionStamps();
|
|
5248
5303
|
}
|
|
5249
5304
|
});
|
|
5250
5305
|
|
|
@@ -5388,6 +5443,7 @@ var init_PipelineAssembler = __esm({
|
|
|
5388
5443
|
init_logger();
|
|
5389
5444
|
init_CompositeGenerator();
|
|
5390
5445
|
init_pipelinePlan();
|
|
5446
|
+
init_versionStamps();
|
|
5391
5447
|
PipelineAssembler = class {
|
|
5392
5448
|
/**
|
|
5393
5449
|
* Assembles a navigation pipeline from strategy documents.
|
|
@@ -5469,6 +5525,7 @@ var init_PipelineAssembler = __esm({
|
|
|
5469
5525
|
}
|
|
5470
5526
|
}
|
|
5471
5527
|
const pipeline = new Pipeline(generator, filters, user, course);
|
|
5528
|
+
pipeline.strategyHash = strategyHash(strategies);
|
|
5472
5529
|
logger.debug(
|
|
5473
5530
|
`[PipelineAssembler] Assembled pipeline with ${generatorStrategies.length} generator(s) and ${filters.length} filter(s)`
|
|
5474
5531
|
);
|
|
@@ -7799,6 +7856,7 @@ var init_tagRecent = __esm({
|
|
|
7799
7856
|
import {
|
|
7800
7857
|
adjustCourseScores,
|
|
7801
7858
|
adjustCourseScoresPerTag,
|
|
7859
|
+
isCountOnlyTag as isCountOnlyTag2,
|
|
7802
7860
|
toCourseElo as toCourseElo7
|
|
7803
7861
|
} from "@vue-skuilder/common";
|
|
7804
7862
|
var init_EloService = __esm({
|
|
@@ -9721,6 +9779,7 @@ var init_SessionController = __esm({
|
|
|
9721
9779
|
init_util2();
|
|
9722
9780
|
init_navigators();
|
|
9723
9781
|
init_Pipeline();
|
|
9782
|
+
init_versionStamps();
|
|
9724
9783
|
init_SourceMixer();
|
|
9725
9784
|
init_MixerDebugger();
|
|
9726
9785
|
init_SessionDebugger();
|
|
@@ -11123,6 +11182,7 @@ var init_factory = __esm({
|
|
|
11123
11182
|
init_common();
|
|
11124
11183
|
init_logger();
|
|
11125
11184
|
init_navigators();
|
|
11185
|
+
init_versionStamps();
|
|
11126
11186
|
NOT_SET = "NOT_SET";
|
|
11127
11187
|
ENV = {
|
|
11128
11188
|
COUCHDB_SERVER_PROTOCOL: NOT_SET,
|