@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
package/dist/core/index.mjs
CHANGED
|
@@ -673,13 +673,12 @@ function clearRunHistory() {
|
|
|
673
673
|
_pendingRuns = [];
|
|
674
674
|
}
|
|
675
675
|
function getOrigin(card) {
|
|
676
|
-
|
|
677
|
-
|
|
678
|
-
|
|
679
|
-
|
|
680
|
-
|
|
681
|
-
|
|
682
|
-
return "unknown";
|
|
676
|
+
return card.reviewID ? "review" : "new";
|
|
677
|
+
}
|
|
678
|
+
function requiredBy(card) {
|
|
679
|
+
return card.provenance.find(
|
|
680
|
+
(p) => p.strategy === "ephemeralHint" && p.score === Number.POSITIVE_INFINITY
|
|
681
|
+
)?.strategyName;
|
|
683
682
|
}
|
|
684
683
|
function captureRun(report) {
|
|
685
684
|
const fullReport = {
|
|
@@ -703,17 +702,23 @@ function parseCardElo(provenance) {
|
|
|
703
702
|
}
|
|
704
703
|
function buildRunReport(courseId, courseName, generatorName, generators, generatedCount, filters, allCards, selectedCards, userElo, hints, scoredCards, regulators) {
|
|
705
704
|
const selectedIds = new Set(selectedCards.map((c) => c.cardId));
|
|
706
|
-
const toReport = (card) =>
|
|
707
|
-
|
|
708
|
-
|
|
709
|
-
|
|
710
|
-
|
|
711
|
-
|
|
712
|
-
|
|
713
|
-
|
|
714
|
-
|
|
715
|
-
|
|
716
|
-
|
|
705
|
+
const toReport = (card) => {
|
|
706
|
+
const required = requiredBy(card);
|
|
707
|
+
const first = card.provenance[0];
|
|
708
|
+
const generator = first && first.strategy !== "ephemeralHint" ? first.strategyName || first.strategy : void 0;
|
|
709
|
+
return {
|
|
710
|
+
cardId: card.cardId,
|
|
711
|
+
courseId: card.courseId,
|
|
712
|
+
origin: getOrigin(card),
|
|
713
|
+
...generator ? { generator } : {},
|
|
714
|
+
...required ? { required } : {},
|
|
715
|
+
finalScore: card.score,
|
|
716
|
+
cardElo: card.cardElo ?? parseCardElo(card.provenance),
|
|
717
|
+
provenance: card.provenance,
|
|
718
|
+
tags: card.tags,
|
|
719
|
+
selected: selectedIds.has(card.cardId)
|
|
720
|
+
};
|
|
721
|
+
};
|
|
717
722
|
const selectedReported = [];
|
|
718
723
|
const nearMissReported = [];
|
|
719
724
|
const discardedTailCards = [];
|
|
@@ -1842,10 +1847,14 @@ var init_elo = __esm({
|
|
|
1842
1847
|
const userElo = toCourseElo2(courseReg.elo);
|
|
1843
1848
|
userGlobalElo = userElo.global.score;
|
|
1844
1849
|
}
|
|
1845
|
-
const activeCards = await
|
|
1850
|
+
const [activeCards, seenCards] = await Promise.all([
|
|
1851
|
+
this.user.getActiveCards(),
|
|
1852
|
+
this.user.getSeenCards(this.course.getCourseID()).catch(() => [])
|
|
1853
|
+
]);
|
|
1854
|
+
const notNew = /* @__PURE__ */ new Set([...activeCards.map((ac) => ac.cardID), ...seenCards]);
|
|
1846
1855
|
const newCards = (await this.course.getCardsCenteredAtELO(
|
|
1847
1856
|
{ limit, elo: "user" },
|
|
1848
|
-
(c) => !
|
|
1857
|
+
(c) => !notNew.has(c.cardID)
|
|
1849
1858
|
)).map((c) => ({ ...c, status: "new" }));
|
|
1850
1859
|
const scored = newCards.map((c) => {
|
|
1851
1860
|
const cardElo = c.elo ?? 1e3;
|
|
@@ -1898,6 +1907,7 @@ __export(prescribed_exports, {
|
|
|
1898
1907
|
default: () => PrescribedCardsGenerator,
|
|
1899
1908
|
unmetIntroExposeTags: () => unmetIntroExposeTags
|
|
1900
1909
|
});
|
|
1910
|
+
import { tagRole, withTagRole } from "@vue-skuilder/common";
|
|
1901
1911
|
function dedupe(arr) {
|
|
1902
1912
|
return [...new Set(arr)];
|
|
1903
1913
|
}
|
|
@@ -1938,11 +1948,11 @@ function formatAge(ms) {
|
|
|
1938
1948
|
}
|
|
1939
1949
|
function unmetIntroExposeTags(tags, userTagElo, minCount) {
|
|
1940
1950
|
if (minCount <= 0) return [];
|
|
1941
|
-
const exposeTags = new Set(tags.filter((tag) => tag
|
|
1951
|
+
const exposeTags = new Set(tags.filter((tag) => tagRole(tag) === "expose"));
|
|
1942
1952
|
for (const tag of tags) {
|
|
1943
|
-
if (
|
|
1944
|
-
const
|
|
1945
|
-
if (
|
|
1953
|
+
if (tagRole(tag) !== "intro") continue;
|
|
1954
|
+
const expose = withTagRole(tag, "expose");
|
|
1955
|
+
if (expose) exposeTags.add(expose);
|
|
1946
1956
|
}
|
|
1947
1957
|
return [...exposeTags].filter((tag) => {
|
|
1948
1958
|
const tagElo = userTagElo[tag];
|
|
@@ -3144,6 +3154,7 @@ __export(eloDistance_exports, {
|
|
|
3144
3154
|
mountMultiDimEloToggle: () => mountMultiDimEloToggle,
|
|
3145
3155
|
tagAwareGap: () => tagAwareGap
|
|
3146
3156
|
});
|
|
3157
|
+
import { COUNT_ONLY_SCORE, isCountOnlyTag } from "@vue-skuilder/common";
|
|
3147
3158
|
function computeMultiplier(distance, halfLife, minMultiplier, maxMultiplier) {
|
|
3148
3159
|
const normalizedDistance = distance / halfLife;
|
|
3149
3160
|
const decay = Math.exp(-(normalizedDistance * normalizedDistance));
|
|
@@ -3186,7 +3197,9 @@ function tagAwareGap(cardTags, cardElo, userElo, minTagCount) {
|
|
|
3186
3197
|
const tags = [];
|
|
3187
3198
|
for (const tag of cardTags) {
|
|
3188
3199
|
const user = userElo.tags[tag];
|
|
3189
|
-
if (!user || user.score ===
|
|
3200
|
+
if (isCountOnlyTag(tag) || !user || user.score === COUNT_ONLY_SCORE || user.count < minTagCount) {
|
|
3201
|
+
continue;
|
|
3202
|
+
}
|
|
3190
3203
|
const card = cardElo.tags[tag]?.score ?? cardElo.global.score;
|
|
3191
3204
|
tags.push({
|
|
3192
3205
|
tag,
|
|
@@ -3258,7 +3271,7 @@ function createEloDistanceFilter(config) {
|
|
|
3258
3271
|
transform: (cards, context) => applyEloDistance(cards, context, resolved, source)
|
|
3259
3272
|
};
|
|
3260
3273
|
}
|
|
3261
|
-
var DEFAULT_ELO_DISTANCE_CONFIG, TAG_CONFIDENCE_HALF,
|
|
3274
|
+
var DEFAULT_ELO_DISTANCE_CONFIG, TAG_CONFIDENCE_HALF, DEFAULT_CARD_ELO, MULTI_DIM_ELO_KEY, multiDimElo, EloDistanceFilter;
|
|
3262
3275
|
var init_eloDistance = __esm({
|
|
3263
3276
|
"src/core/navigators/filters/eloDistance.ts"() {
|
|
3264
3277
|
"use strict";
|
|
@@ -3272,7 +3285,6 @@ var init_eloDistance = __esm({
|
|
|
3272
3285
|
minTagCount: 3
|
|
3273
3286
|
};
|
|
3274
3287
|
TAG_CONFIDENCE_HALF = 10;
|
|
3275
|
-
COUNT_ONLY_SENTINEL = -1;
|
|
3276
3288
|
DEFAULT_CARD_ELO = 1e3;
|
|
3277
3289
|
MULTI_DIM_ELO_KEY = "skuilder:multiDimElo";
|
|
3278
3290
|
multiDimElo = readMultiDimElo();
|
|
@@ -4647,6 +4659,11 @@ var init_Pipeline = __esm({
|
|
|
4647
4659
|
* This eliminates a remote getCourseConfig() round trip per pipeline run.
|
|
4648
4660
|
*/
|
|
4649
4661
|
_cachedOrchestration = null;
|
|
4662
|
+
/**
|
|
4663
|
+
* Hash of the strategy docs this pipeline was assembled from (see
|
|
4664
|
+
* versionStamps.ts), set by whoever builds it. Stamped on every run.
|
|
4665
|
+
*/
|
|
4666
|
+
strategyHash;
|
|
4650
4667
|
/**
|
|
4651
4668
|
* Persistent tag cache. Maps cardId → tag names.
|
|
4652
4669
|
*
|
|
@@ -4840,7 +4857,8 @@ var init_Pipeline = __esm({
|
|
|
4840
4857
|
logResultCards(result);
|
|
4841
4858
|
logCardProvenance(result, 3);
|
|
4842
4859
|
try {
|
|
4843
|
-
const
|
|
4860
|
+
const courseConfig = await this.course?.getCourseConfig().catch(() => void 0);
|
|
4861
|
+
const courseName = courseConfig?.name;
|
|
4844
4862
|
const report = buildRunReport(
|
|
4845
4863
|
this.course?.getCourseID() || "unknown",
|
|
4846
4864
|
courseName,
|
|
@@ -4855,7 +4873,11 @@ var init_Pipeline = __esm({
|
|
|
4855
4873
|
scoredCards,
|
|
4856
4874
|
regulators
|
|
4857
4875
|
);
|
|
4858
|
-
|
|
4876
|
+
const versions = {
|
|
4877
|
+
...this.strategyHash ? { strategies: this.strategyHash } : {},
|
|
4878
|
+
...courseConfig?.contentVersion ? { content: courseConfig.contentVersion } : {}
|
|
4879
|
+
};
|
|
4880
|
+
captureRun({ ...report, ...Object.keys(versions).length ? { versions } : {} });
|
|
4859
4881
|
} catch (e) {
|
|
4860
4882
|
logger.debug(`[Pipeline] Failed to capture debug run: ${e}`);
|
|
4861
4883
|
}
|
|
@@ -5352,6 +5374,36 @@ var init_Pipeline = __esm({
|
|
|
5352
5374
|
}
|
|
5353
5375
|
});
|
|
5354
5376
|
|
|
5377
|
+
// src/core/versionStamps.ts
|
|
5378
|
+
function stableStringify(value) {
|
|
5379
|
+
if (Array.isArray(value)) return `[${value.map(stableStringify).join(",")}]`;
|
|
5380
|
+
if (value && typeof value === "object") {
|
|
5381
|
+
const entries = Object.entries(value).filter(([, v]) => v !== void 0).sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0);
|
|
5382
|
+
return `{${entries.map(([k, v]) => `${JSON.stringify(k)}:${stableStringify(v)}`).join(",")}}`;
|
|
5383
|
+
}
|
|
5384
|
+
return JSON.stringify(value);
|
|
5385
|
+
}
|
|
5386
|
+
function strategyHash(strategies) {
|
|
5387
|
+
if (strategies.length === 0) return DEFAULT_STRATEGY_HASH;
|
|
5388
|
+
const text = strategies.map((s) => {
|
|
5389
|
+
const { _rev: _ignored, ...rest } = s;
|
|
5390
|
+
return stableStringify(rest);
|
|
5391
|
+
}).sort().join("\n");
|
|
5392
|
+
let h = 2166136261;
|
|
5393
|
+
for (let i = 0; i < text.length; i++) {
|
|
5394
|
+
h ^= text.charCodeAt(i);
|
|
5395
|
+
h = Math.imul(h, 16777619);
|
|
5396
|
+
}
|
|
5397
|
+
return (h >>> 0).toString(16).padStart(8, "0");
|
|
5398
|
+
}
|
|
5399
|
+
var DEFAULT_STRATEGY_HASH;
|
|
5400
|
+
var init_versionStamps = __esm({
|
|
5401
|
+
"src/core/versionStamps.ts"() {
|
|
5402
|
+
"use strict";
|
|
5403
|
+
DEFAULT_STRATEGY_HASH = "default";
|
|
5404
|
+
}
|
|
5405
|
+
});
|
|
5406
|
+
|
|
5355
5407
|
// src/core/navigators/defaults.ts
|
|
5356
5408
|
var defaults_exports = {};
|
|
5357
5409
|
__export(defaults_exports, {
|
|
@@ -5404,7 +5456,9 @@ function createDefaultPipeline(user, course) {
|
|
|
5404
5456
|
course,
|
|
5405
5457
|
createDefaultEloDistanceStrategy(courseId)
|
|
5406
5458
|
);
|
|
5407
|
-
|
|
5459
|
+
const pipeline = new Pipeline(compositeGenerator, [eloDistanceFilter], user, course);
|
|
5460
|
+
pipeline.strategyHash = DEFAULT_STRATEGY_HASH;
|
|
5461
|
+
return pipeline;
|
|
5408
5462
|
}
|
|
5409
5463
|
var init_defaults = __esm({
|
|
5410
5464
|
"src/core/navigators/defaults.ts"() {
|
|
@@ -5416,6 +5470,7 @@ var init_defaults = __esm({
|
|
|
5416
5470
|
init_srs();
|
|
5417
5471
|
init_eloDistance();
|
|
5418
5472
|
init_types_legacy();
|
|
5473
|
+
init_versionStamps();
|
|
5419
5474
|
}
|
|
5420
5475
|
});
|
|
5421
5476
|
|
|
@@ -5559,6 +5614,7 @@ var init_PipelineAssembler = __esm({
|
|
|
5559
5614
|
init_logger();
|
|
5560
5615
|
init_CompositeGenerator();
|
|
5561
5616
|
init_pipelinePlan();
|
|
5617
|
+
init_versionStamps();
|
|
5562
5618
|
PipelineAssembler = class {
|
|
5563
5619
|
/**
|
|
5564
5620
|
* Assembles a navigation pipeline from strategy documents.
|
|
@@ -5640,6 +5696,7 @@ var init_PipelineAssembler = __esm({
|
|
|
5640
5696
|
}
|
|
5641
5697
|
}
|
|
5642
5698
|
const pipeline = new Pipeline(generator, filters, user, course);
|
|
5699
|
+
pipeline.strategyHash = strategyHash(strategies);
|
|
5643
5700
|
logger.debug(
|
|
5644
5701
|
`[PipelineAssembler] Assembled pipeline with ${generatorStrategies.length} generator(s) and ${filters.length} filter(s)`
|
|
5645
5702
|
);
|
|
@@ -7133,6 +7190,7 @@ var init_tagRecent = __esm({
|
|
|
7133
7190
|
import {
|
|
7134
7191
|
adjustCourseScores,
|
|
7135
7192
|
adjustCourseScoresPerTag,
|
|
7193
|
+
isCountOnlyTag as isCountOnlyTag2,
|
|
7136
7194
|
toCourseElo as toCourseElo7
|
|
7137
7195
|
} from "@vue-skuilder/common";
|
|
7138
7196
|
var init_EloService = __esm({
|
|
@@ -9090,6 +9148,7 @@ var init_SessionController = __esm({
|
|
|
9090
9148
|
init_util2();
|
|
9091
9149
|
init_navigators();
|
|
9092
9150
|
init_Pipeline();
|
|
9151
|
+
init_versionStamps();
|
|
9093
9152
|
init_SourceMixer();
|
|
9094
9153
|
init_MixerDebugger();
|
|
9095
9154
|
init_SessionDebugger();
|
|
@@ -10650,6 +10709,7 @@ var init_factory = __esm({
|
|
|
10650
10709
|
init_common();
|
|
10651
10710
|
init_logger();
|
|
10652
10711
|
init_navigators();
|
|
10712
|
+
init_versionStamps();
|
|
10653
10713
|
NOT_SET = "NOT_SET";
|
|
10654
10714
|
ENV = {
|
|
10655
10715
|
COUCHDB_SERVER_PROTOCOL: NOT_SET,
|