@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
|
@@ -481,13 +481,12 @@ function clearRunHistory() {
|
|
|
481
481
|
_pendingRuns = [];
|
|
482
482
|
}
|
|
483
483
|
function getOrigin(card) {
|
|
484
|
-
|
|
485
|
-
|
|
486
|
-
|
|
487
|
-
|
|
488
|
-
|
|
489
|
-
|
|
490
|
-
return "unknown";
|
|
484
|
+
return card.reviewID ? "review" : "new";
|
|
485
|
+
}
|
|
486
|
+
function requiredBy(card) {
|
|
487
|
+
return card.provenance.find(
|
|
488
|
+
(p) => p.strategy === "ephemeralHint" && p.score === Number.POSITIVE_INFINITY
|
|
489
|
+
)?.strategyName;
|
|
491
490
|
}
|
|
492
491
|
function captureRun(report) {
|
|
493
492
|
const fullReport = {
|
|
@@ -511,17 +510,23 @@ function parseCardElo(provenance) {
|
|
|
511
510
|
}
|
|
512
511
|
function buildRunReport(courseId, courseName, generatorName, generators, generatedCount, filters, allCards, selectedCards, userElo, hints, scoredCards, regulators) {
|
|
513
512
|
const selectedIds = new Set(selectedCards.map((c) => c.cardId));
|
|
514
|
-
const toReport = (card) =>
|
|
515
|
-
|
|
516
|
-
|
|
517
|
-
|
|
518
|
-
|
|
519
|
-
|
|
520
|
-
|
|
521
|
-
|
|
522
|
-
|
|
523
|
-
|
|
524
|
-
|
|
513
|
+
const toReport = (card) => {
|
|
514
|
+
const required = requiredBy(card);
|
|
515
|
+
const first = card.provenance[0];
|
|
516
|
+
const generator = first && first.strategy !== "ephemeralHint" ? first.strategyName || first.strategy : void 0;
|
|
517
|
+
return {
|
|
518
|
+
cardId: card.cardId,
|
|
519
|
+
courseId: card.courseId,
|
|
520
|
+
origin: getOrigin(card),
|
|
521
|
+
...generator ? { generator } : {},
|
|
522
|
+
...required ? { required } : {},
|
|
523
|
+
finalScore: card.score,
|
|
524
|
+
cardElo: card.cardElo ?? parseCardElo(card.provenance),
|
|
525
|
+
provenance: card.provenance,
|
|
526
|
+
tags: card.tags,
|
|
527
|
+
selected: selectedIds.has(card.cardId)
|
|
528
|
+
};
|
|
529
|
+
};
|
|
525
530
|
const selectedReported = [];
|
|
526
531
|
const nearMissReported = [];
|
|
527
532
|
const discardedTailCards = [];
|
|
@@ -1650,10 +1655,14 @@ var init_elo = __esm({
|
|
|
1650
1655
|
const userElo = toCourseElo2(courseReg.elo);
|
|
1651
1656
|
userGlobalElo = userElo.global.score;
|
|
1652
1657
|
}
|
|
1653
|
-
const activeCards = await
|
|
1658
|
+
const [activeCards, seenCards] = await Promise.all([
|
|
1659
|
+
this.user.getActiveCards(),
|
|
1660
|
+
this.user.getSeenCards(this.course.getCourseID()).catch(() => [])
|
|
1661
|
+
]);
|
|
1662
|
+
const notNew = /* @__PURE__ */ new Set([...activeCards.map((ac) => ac.cardID), ...seenCards]);
|
|
1654
1663
|
const newCards = (await this.course.getCardsCenteredAtELO(
|
|
1655
1664
|
{ limit, elo: "user" },
|
|
1656
|
-
(c) => !
|
|
1665
|
+
(c) => !notNew.has(c.cardID)
|
|
1657
1666
|
)).map((c) => ({ ...c, status: "new" }));
|
|
1658
1667
|
const scored = newCards.map((c) => {
|
|
1659
1668
|
const cardElo = c.elo ?? 1e3;
|
|
@@ -1706,6 +1715,7 @@ __export(prescribed_exports, {
|
|
|
1706
1715
|
default: () => PrescribedCardsGenerator,
|
|
1707
1716
|
unmetIntroExposeTags: () => unmetIntroExposeTags
|
|
1708
1717
|
});
|
|
1718
|
+
import { tagRole, withTagRole } from "@vue-skuilder/common";
|
|
1709
1719
|
function dedupe(arr) {
|
|
1710
1720
|
return [...new Set(arr)];
|
|
1711
1721
|
}
|
|
@@ -1746,11 +1756,11 @@ function formatAge(ms) {
|
|
|
1746
1756
|
}
|
|
1747
1757
|
function unmetIntroExposeTags(tags, userTagElo, minCount) {
|
|
1748
1758
|
if (minCount <= 0) return [];
|
|
1749
|
-
const exposeTags = new Set(tags.filter((tag) => tag
|
|
1759
|
+
const exposeTags = new Set(tags.filter((tag) => tagRole(tag) === "expose"));
|
|
1750
1760
|
for (const tag of tags) {
|
|
1751
|
-
if (
|
|
1752
|
-
const
|
|
1753
|
-
if (
|
|
1761
|
+
if (tagRole(tag) !== "intro") continue;
|
|
1762
|
+
const expose = withTagRole(tag, "expose");
|
|
1763
|
+
if (expose) exposeTags.add(expose);
|
|
1754
1764
|
}
|
|
1755
1765
|
return [...exposeTags].filter((tag) => {
|
|
1756
1766
|
const tagElo = userTagElo[tag];
|
|
@@ -2952,6 +2962,7 @@ __export(eloDistance_exports, {
|
|
|
2952
2962
|
mountMultiDimEloToggle: () => mountMultiDimEloToggle,
|
|
2953
2963
|
tagAwareGap: () => tagAwareGap
|
|
2954
2964
|
});
|
|
2965
|
+
import { COUNT_ONLY_SCORE, isCountOnlyTag } from "@vue-skuilder/common";
|
|
2955
2966
|
function computeMultiplier(distance, halfLife, minMultiplier, maxMultiplier) {
|
|
2956
2967
|
const normalizedDistance = distance / halfLife;
|
|
2957
2968
|
const decay = Math.exp(-(normalizedDistance * normalizedDistance));
|
|
@@ -2994,7 +3005,9 @@ function tagAwareGap(cardTags, cardElo, userElo, minTagCount) {
|
|
|
2994
3005
|
const tags = [];
|
|
2995
3006
|
for (const tag of cardTags) {
|
|
2996
3007
|
const user = userElo.tags[tag];
|
|
2997
|
-
if (!user || user.score ===
|
|
3008
|
+
if (isCountOnlyTag(tag) || !user || user.score === COUNT_ONLY_SCORE || user.count < minTagCount) {
|
|
3009
|
+
continue;
|
|
3010
|
+
}
|
|
2998
3011
|
const card = cardElo.tags[tag]?.score ?? cardElo.global.score;
|
|
2999
3012
|
tags.push({
|
|
3000
3013
|
tag,
|
|
@@ -3066,7 +3079,7 @@ function createEloDistanceFilter(config) {
|
|
|
3066
3079
|
transform: (cards, context) => applyEloDistance(cards, context, resolved, source)
|
|
3067
3080
|
};
|
|
3068
3081
|
}
|
|
3069
|
-
var DEFAULT_ELO_DISTANCE_CONFIG, TAG_CONFIDENCE_HALF,
|
|
3082
|
+
var DEFAULT_ELO_DISTANCE_CONFIG, TAG_CONFIDENCE_HALF, DEFAULT_CARD_ELO, MULTI_DIM_ELO_KEY, multiDimElo, EloDistanceFilter;
|
|
3070
3083
|
var init_eloDistance = __esm({
|
|
3071
3084
|
"src/core/navigators/filters/eloDistance.ts"() {
|
|
3072
3085
|
"use strict";
|
|
@@ -3080,7 +3093,6 @@ var init_eloDistance = __esm({
|
|
|
3080
3093
|
minTagCount: 3
|
|
3081
3094
|
};
|
|
3082
3095
|
TAG_CONFIDENCE_HALF = 10;
|
|
3083
|
-
COUNT_ONLY_SENTINEL = -1;
|
|
3084
3096
|
DEFAULT_CARD_ELO = 1e3;
|
|
3085
3097
|
MULTI_DIM_ELO_KEY = "skuilder:multiDimElo";
|
|
3086
3098
|
multiDimElo = readMultiDimElo();
|
|
@@ -4209,6 +4221,11 @@ var init_Pipeline = __esm({
|
|
|
4209
4221
|
* This eliminates a remote getCourseConfig() round trip per pipeline run.
|
|
4210
4222
|
*/
|
|
4211
4223
|
_cachedOrchestration = null;
|
|
4224
|
+
/**
|
|
4225
|
+
* Hash of the strategy docs this pipeline was assembled from (see
|
|
4226
|
+
* versionStamps.ts), set by whoever builds it. Stamped on every run.
|
|
4227
|
+
*/
|
|
4228
|
+
strategyHash;
|
|
4212
4229
|
/**
|
|
4213
4230
|
* Persistent tag cache. Maps cardId → tag names.
|
|
4214
4231
|
*
|
|
@@ -4402,7 +4419,8 @@ var init_Pipeline = __esm({
|
|
|
4402
4419
|
logResultCards(result);
|
|
4403
4420
|
logCardProvenance(result, 3);
|
|
4404
4421
|
try {
|
|
4405
|
-
const
|
|
4422
|
+
const courseConfig = await this.course?.getCourseConfig().catch(() => void 0);
|
|
4423
|
+
const courseName = courseConfig?.name;
|
|
4406
4424
|
const report = buildRunReport(
|
|
4407
4425
|
this.course?.getCourseID() || "unknown",
|
|
4408
4426
|
courseName,
|
|
@@ -4417,7 +4435,11 @@ var init_Pipeline = __esm({
|
|
|
4417
4435
|
scoredCards,
|
|
4418
4436
|
regulators
|
|
4419
4437
|
);
|
|
4420
|
-
|
|
4438
|
+
const versions = {
|
|
4439
|
+
...this.strategyHash ? { strategies: this.strategyHash } : {},
|
|
4440
|
+
...courseConfig?.contentVersion ? { content: courseConfig.contentVersion } : {}
|
|
4441
|
+
};
|
|
4442
|
+
captureRun({ ...report, ...Object.keys(versions).length ? { versions } : {} });
|
|
4421
4443
|
} catch (e) {
|
|
4422
4444
|
logger.debug(`[Pipeline] Failed to capture debug run: ${e}`);
|
|
4423
4445
|
}
|
|
@@ -4914,6 +4936,36 @@ var init_Pipeline = __esm({
|
|
|
4914
4936
|
}
|
|
4915
4937
|
});
|
|
4916
4938
|
|
|
4939
|
+
// src/core/versionStamps.ts
|
|
4940
|
+
function stableStringify(value) {
|
|
4941
|
+
if (Array.isArray(value)) return `[${value.map(stableStringify).join(",")}]`;
|
|
4942
|
+
if (value && typeof value === "object") {
|
|
4943
|
+
const entries = Object.entries(value).filter(([, v]) => v !== void 0).sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0);
|
|
4944
|
+
return `{${entries.map(([k, v]) => `${JSON.stringify(k)}:${stableStringify(v)}`).join(",")}}`;
|
|
4945
|
+
}
|
|
4946
|
+
return JSON.stringify(value);
|
|
4947
|
+
}
|
|
4948
|
+
function strategyHash(strategies) {
|
|
4949
|
+
if (strategies.length === 0) return DEFAULT_STRATEGY_HASH;
|
|
4950
|
+
const text = strategies.map((s) => {
|
|
4951
|
+
const { _rev: _ignored, ...rest } = s;
|
|
4952
|
+
return stableStringify(rest);
|
|
4953
|
+
}).sort().join("\n");
|
|
4954
|
+
let h = 2166136261;
|
|
4955
|
+
for (let i = 0; i < text.length; i++) {
|
|
4956
|
+
h ^= text.charCodeAt(i);
|
|
4957
|
+
h = Math.imul(h, 16777619);
|
|
4958
|
+
}
|
|
4959
|
+
return (h >>> 0).toString(16).padStart(8, "0");
|
|
4960
|
+
}
|
|
4961
|
+
var DEFAULT_STRATEGY_HASH;
|
|
4962
|
+
var init_versionStamps = __esm({
|
|
4963
|
+
"src/core/versionStamps.ts"() {
|
|
4964
|
+
"use strict";
|
|
4965
|
+
DEFAULT_STRATEGY_HASH = "default";
|
|
4966
|
+
}
|
|
4967
|
+
});
|
|
4968
|
+
|
|
4917
4969
|
// src/core/navigators/defaults.ts
|
|
4918
4970
|
var defaults_exports = {};
|
|
4919
4971
|
__export(defaults_exports, {
|
|
@@ -4966,7 +5018,9 @@ function createDefaultPipeline(user, course) {
|
|
|
4966
5018
|
course,
|
|
4967
5019
|
createDefaultEloDistanceStrategy(courseId)
|
|
4968
5020
|
);
|
|
4969
|
-
|
|
5021
|
+
const pipeline = new Pipeline(compositeGenerator, [eloDistanceFilter], user, course);
|
|
5022
|
+
pipeline.strategyHash = DEFAULT_STRATEGY_HASH;
|
|
5023
|
+
return pipeline;
|
|
4970
5024
|
}
|
|
4971
5025
|
var init_defaults = __esm({
|
|
4972
5026
|
"src/core/navigators/defaults.ts"() {
|
|
@@ -4978,6 +5032,7 @@ var init_defaults = __esm({
|
|
|
4978
5032
|
init_srs();
|
|
4979
5033
|
init_eloDistance();
|
|
4980
5034
|
init_types_legacy();
|
|
5035
|
+
init_versionStamps();
|
|
4981
5036
|
}
|
|
4982
5037
|
});
|
|
4983
5038
|
|
|
@@ -5121,6 +5176,7 @@ var init_PipelineAssembler = __esm({
|
|
|
5121
5176
|
init_logger();
|
|
5122
5177
|
init_CompositeGenerator();
|
|
5123
5178
|
init_pipelinePlan();
|
|
5179
|
+
init_versionStamps();
|
|
5124
5180
|
PipelineAssembler = class {
|
|
5125
5181
|
/**
|
|
5126
5182
|
* Assembles a navigation pipeline from strategy documents.
|
|
@@ -5202,6 +5258,7 @@ var init_PipelineAssembler = __esm({
|
|
|
5202
5258
|
}
|
|
5203
5259
|
}
|
|
5204
5260
|
const pipeline = new Pipeline(generator, filters, user, course);
|
|
5261
|
+
pipeline.strategyHash = strategyHash(strategies);
|
|
5205
5262
|
logger.debug(
|
|
5206
5263
|
`[PipelineAssembler] Assembled pipeline with ${generatorStrategies.length} generator(s) and ${filters.length} filter(s)`
|
|
5207
5264
|
);
|
|
@@ -5752,6 +5809,7 @@ var init_tagRecent = __esm({
|
|
|
5752
5809
|
import {
|
|
5753
5810
|
adjustCourseScores,
|
|
5754
5811
|
adjustCourseScoresPerTag,
|
|
5812
|
+
isCountOnlyTag as isCountOnlyTag2,
|
|
5755
5813
|
toCourseElo as toCourseElo7
|
|
5756
5814
|
} from "@vue-skuilder/common";
|
|
5757
5815
|
var init_EloService = __esm({
|
|
@@ -7703,6 +7761,7 @@ var init_SessionController = __esm({
|
|
|
7703
7761
|
init_util2();
|
|
7704
7762
|
init_navigators();
|
|
7705
7763
|
init_Pipeline();
|
|
7764
|
+
init_versionStamps();
|
|
7706
7765
|
init_SourceMixer();
|
|
7707
7766
|
init_MixerDebugger();
|
|
7708
7767
|
init_SessionDebugger();
|
|
@@ -9184,6 +9243,7 @@ var init_factory = __esm({
|
|
|
9184
9243
|
init_common();
|
|
9185
9244
|
init_logger();
|
|
9186
9245
|
init_navigators();
|
|
9246
|
+
init_versionStamps();
|
|
9187
9247
|
NOT_SET = "NOT_SET";
|
|
9188
9248
|
ENV = {
|
|
9189
9249
|
COUCHDB_SERVER_PROTOCOL: NOT_SET,
|