@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
@@ -673,13 +673,12 @@ function clearRunHistory() {
673
673
  _pendingRuns = [];
674
674
  }
675
675
  function getOrigin(card) {
676
- const firstEntry = card.provenance[0];
677
- if (!firstEntry) return "unknown";
678
- const reason = firstEntry.reason?.toLowerCase() || "";
679
- const strategy = firstEntry.strategy?.toLowerCase() || "";
680
- if (reason.includes("new card") || strategy.includes("elo")) return "new";
681
- if (reason.includes("review") || strategy.includes("srs")) return "review";
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
- cardId: card.cardId,
708
- courseId: card.courseId,
709
- origin: getOrigin(card),
710
- generator: card.provenance[0]?.strategyName || card.provenance[0]?.strategy,
711
- finalScore: card.score,
712
- cardElo: card.cardElo ?? parseCardElo(card.provenance),
713
- provenance: card.provenance,
714
- tags: card.tags,
715
- selected: selectedIds.has(card.cardId)
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 this.user.getActiveCards();
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) => !activeCards.some((ac) => c.cardID === ac.cardID)
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.startsWith("gpc:expose:")));
1951
+ const exposeTags = new Set(tags.filter((tag) => tagRole(tag) === "expose"));
1942
1952
  for (const tag of tags) {
1943
- if (!tag.startsWith("gpc:intro:")) continue;
1944
- const suffix = tag.slice("gpc:intro:".length);
1945
- if (suffix) exposeTags.add(`gpc:expose:${suffix}`);
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 === COUNT_ONLY_SENTINEL || user.count < minTagCount) continue;
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, COUNT_ONLY_SENTINEL, DEFAULT_CARD_ELO, MULTI_DIM_ELO_KEY, multiDimElo, EloDistanceFilter;
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 courseName = await this.course?.getCourseConfig().then((c) => c.name).catch(() => void 0);
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
- captureRun(report);
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
- return new Pipeline(compositeGenerator, [eloDistanceFilter], user, course);
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,