@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.
Files changed (51) hide show
  1. package/dist/{contentSource-B6FrSihy.d.cts → contentSource-CTQ4kWhR.d.cts} +41 -4
  2. package/dist/{contentSource-CqJmbOZN.d.ts → contentSource-JmWYu8IK.d.ts} +41 -4
  3. package/dist/core/index.d.cts +3 -3
  4. package/dist/core/index.d.ts +3 -3
  5. package/dist/core/index.js +138 -79
  6. package/dist/core/index.js.map +1 -1
  7. package/dist/core/index.mjs +90 -30
  8. package/dist/core/index.mjs.map +1 -1
  9. package/dist/{dataLayerProvider-DUxDqMtZ.d.cts → dataLayerProvider-DfI_KYAe.d.cts} +1 -1
  10. package/dist/{dataLayerProvider-B9_UCvkR.d.ts → dataLayerProvider-rlLE2Mf-.d.ts} +1 -1
  11. package/dist/diagnostics/index.d.cts +18 -3
  12. package/dist/diagnostics/index.d.ts +18 -3
  13. package/dist/diagnostics/index.js +171 -135
  14. package/dist/diagnostics/index.js.map +1 -1
  15. package/dist/diagnostics/index.mjs +168 -135
  16. package/dist/diagnostics/index.mjs.map +1 -1
  17. package/dist/impl/couch/index.d.cts +8 -2
  18. package/dist/impl/couch/index.d.ts +8 -2
  19. package/dist/impl/couch/index.js +142 -83
  20. package/dist/impl/couch/index.js.map +1 -1
  21. package/dist/impl/couch/index.mjs +90 -30
  22. package/dist/impl/couch/index.mjs.map +1 -1
  23. package/dist/impl/static/index.d.cts +2 -2
  24. package/dist/impl/static/index.d.ts +2 -2
  25. package/dist/impl/static/index.js +129 -70
  26. package/dist/impl/static/index.js.map +1 -1
  27. package/dist/impl/static/index.mjs +90 -30
  28. package/dist/impl/static/index.mjs.map +1 -1
  29. package/dist/index.d.cts +5 -3
  30. package/dist/index.d.ts +5 -3
  31. package/dist/index.js +204 -114
  32. package/dist/index.js.map +1 -1
  33. package/dist/index.mjs +128 -37
  34. package/dist/index.mjs.map +1 -1
  35. package/package.json +3 -3
  36. package/src/core/navigators/Pipeline.ts +13 -2
  37. package/src/core/navigators/PipelineAssembler.ts +2 -0
  38. package/src/core/navigators/PipelineDebugger.ts +54 -23
  39. package/src/core/navigators/defaults.ts +4 -1
  40. package/src/core/navigators/filters/eloDistance.ts +7 -8
  41. package/src/core/navigators/generators/elo.ts +8 -2
  42. package/src/core/navigators/generators/prescribed.ts +7 -5
  43. package/src/core/types/studySession.ts +23 -2
  44. package/src/core/versionStamps.ts +66 -0
  45. package/src/diagnostics/derive.ts +5 -2
  46. package/src/diagnostics/pipeline.ts +28 -0
  47. package/src/diagnostics/text.ts +24 -4
  48. package/src/factory.ts +6 -0
  49. package/src/study/SessionController.ts +6 -1
  50. package/src/study/services/EloService.ts +33 -6
  51. package/tsup.config.ts +5 -0
@@ -481,13 +481,12 @@ function clearRunHistory() {
481
481
  _pendingRuns = [];
482
482
  }
483
483
  function getOrigin(card) {
484
- const firstEntry = card.provenance[0];
485
- if (!firstEntry) return "unknown";
486
- const reason = firstEntry.reason?.toLowerCase() || "";
487
- const strategy = firstEntry.strategy?.toLowerCase() || "";
488
- if (reason.includes("new card") || strategy.includes("elo")) return "new";
489
- if (reason.includes("review") || strategy.includes("srs")) return "review";
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
- cardId: card.cardId,
516
- courseId: card.courseId,
517
- origin: getOrigin(card),
518
- generator: card.provenance[0]?.strategyName || card.provenance[0]?.strategy,
519
- finalScore: card.score,
520
- cardElo: card.cardElo ?? parseCardElo(card.provenance),
521
- provenance: card.provenance,
522
- tags: card.tags,
523
- selected: selectedIds.has(card.cardId)
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 this.user.getActiveCards();
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) => !activeCards.some((ac) => c.cardID === ac.cardID)
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.startsWith("gpc:expose:")));
1759
+ const exposeTags = new Set(tags.filter((tag) => tagRole(tag) === "expose"));
1750
1760
  for (const tag of tags) {
1751
- if (!tag.startsWith("gpc:intro:")) continue;
1752
- const suffix = tag.slice("gpc:intro:".length);
1753
- if (suffix) exposeTags.add(`gpc:expose:${suffix}`);
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 === COUNT_ONLY_SENTINEL || user.count < minTagCount) continue;
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, COUNT_ONLY_SENTINEL, DEFAULT_CARD_ELO, MULTI_DIM_ELO_KEY, multiDimElo, EloDistanceFilter;
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 courseName = await this.course?.getCourseConfig().then((c) => c.name).catch(() => void 0);
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
- captureRun(report);
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
- return new Pipeline(compositeGenerator, [eloDistanceFilter], user, course);
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,