@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
@@ -748,13 +748,12 @@ function clearRunHistory() {
748
748
  _pendingRuns = [];
749
749
  }
750
750
  function getOrigin(card) {
751
- const firstEntry = card.provenance[0];
752
- if (!firstEntry) return "unknown";
753
- const reason = firstEntry.reason?.toLowerCase() || "";
754
- const strategy = firstEntry.strategy?.toLowerCase() || "";
755
- if (reason.includes("new card") || strategy.includes("elo")) return "new";
756
- if (reason.includes("review") || strategy.includes("srs")) return "review";
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
- cardId: card.cardId,
783
- courseId: card.courseId,
784
- origin: getOrigin(card),
785
- generator: card.provenance[0]?.strategyName || card.provenance[0]?.strategy,
786
- finalScore: card.score,
787
- cardElo: card.cardElo ?? parseCardElo(card.provenance),
788
- provenance: card.provenance,
789
- tags: card.tags,
790
- selected: selectedIds.has(card.cardId)
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 this.user.getActiveCards();
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) => !activeCards.some((ac) => c.cardID === ac.cardID)
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.startsWith("gpc:expose:")));
2026
+ const exposeTags = new Set(tags.filter((tag) => tagRole(tag) === "expose"));
2017
2027
  for (const tag of tags) {
2018
- if (!tag.startsWith("gpc:intro:")) continue;
2019
- const suffix = tag.slice("gpc:intro:".length);
2020
- if (suffix) exposeTags.add(`gpc:expose:${suffix}`);
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 === COUNT_ONLY_SENTINEL || user.count < minTagCount) continue;
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, COUNT_ONLY_SENTINEL, DEFAULT_CARD_ELO, MULTI_DIM_ELO_KEY, multiDimElo, EloDistanceFilter;
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 courseName = await this.course?.getCourseConfig().then((c) => c.name).catch(() => void 0);
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
- captureRun(report);
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
- return new Pipeline(compositeGenerator, [eloDistanceFilter], user, course);
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,