@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
package/dist/index.mjs CHANGED
@@ -784,13 +784,12 @@ function clearRunHistory() {
784
784
  _pendingRuns = [];
785
785
  }
786
786
  function getOrigin(card) {
787
- const firstEntry = card.provenance[0];
788
- if (!firstEntry) return "unknown";
789
- const reason = firstEntry.reason?.toLowerCase() || "";
790
- const strategy = firstEntry.strategy?.toLowerCase() || "";
791
- if (reason.includes("new card") || strategy.includes("elo")) return "new";
792
- if (reason.includes("review") || strategy.includes("srs")) return "review";
793
- return "unknown";
787
+ return card.reviewID ? "review" : "new";
788
+ }
789
+ function requiredBy(card) {
790
+ return card.provenance.find(
791
+ (p) => p.strategy === "ephemeralHint" && p.score === Number.POSITIVE_INFINITY
792
+ )?.strategyName;
794
793
  }
795
794
  function captureRun(report) {
796
795
  const fullReport = {
@@ -814,17 +813,23 @@ function parseCardElo(provenance) {
814
813
  }
815
814
  function buildRunReport(courseId, courseName, generatorName, generators, generatedCount, filters, allCards, selectedCards, userElo, hints, scoredCards, regulators) {
816
815
  const selectedIds = new Set(selectedCards.map((c) => c.cardId));
817
- const toReport = (card) => ({
818
- cardId: card.cardId,
819
- courseId: card.courseId,
820
- origin: getOrigin(card),
821
- generator: card.provenance[0]?.strategyName || card.provenance[0]?.strategy,
822
- finalScore: card.score,
823
- cardElo: card.cardElo ?? parseCardElo(card.provenance),
824
- provenance: card.provenance,
825
- tags: card.tags,
826
- selected: selectedIds.has(card.cardId)
827
- });
816
+ const toReport = (card) => {
817
+ const required = requiredBy(card);
818
+ const first = card.provenance[0];
819
+ const generator = first && first.strategy !== "ephemeralHint" ? first.strategyName || first.strategy : void 0;
820
+ return {
821
+ cardId: card.cardId,
822
+ courseId: card.courseId,
823
+ origin: getOrigin(card),
824
+ ...generator ? { generator } : {},
825
+ ...required ? { required } : {},
826
+ finalScore: card.score,
827
+ cardElo: card.cardElo ?? parseCardElo(card.provenance),
828
+ provenance: card.provenance,
829
+ tags: card.tags,
830
+ selected: selectedIds.has(card.cardId)
831
+ };
832
+ };
828
833
  const selectedReported = [];
829
834
  const nearMissReported = [];
830
835
  const discardedTailCards = [];
@@ -1953,10 +1958,14 @@ var init_elo = __esm({
1953
1958
  const userElo = toCourseElo2(courseReg.elo);
1954
1959
  userGlobalElo = userElo.global.score;
1955
1960
  }
1956
- const activeCards = await this.user.getActiveCards();
1961
+ const [activeCards, seenCards] = await Promise.all([
1962
+ this.user.getActiveCards(),
1963
+ this.user.getSeenCards(this.course.getCourseID()).catch(() => [])
1964
+ ]);
1965
+ const notNew = /* @__PURE__ */ new Set([...activeCards.map((ac) => ac.cardID), ...seenCards]);
1957
1966
  const newCards = (await this.course.getCardsCenteredAtELO(
1958
1967
  { limit, elo: "user" },
1959
- (c) => !activeCards.some((ac) => c.cardID === ac.cardID)
1968
+ (c) => !notNew.has(c.cardID)
1960
1969
  )).map((c) => ({ ...c, status: "new" }));
1961
1970
  const scored = newCards.map((c) => {
1962
1971
  const cardElo = c.elo ?? 1e3;
@@ -2009,6 +2018,7 @@ __export(prescribed_exports, {
2009
2018
  default: () => PrescribedCardsGenerator,
2010
2019
  unmetIntroExposeTags: () => unmetIntroExposeTags
2011
2020
  });
2021
+ import { tagRole, withTagRole } from "@vue-skuilder/common";
2012
2022
  function dedupe(arr) {
2013
2023
  return [...new Set(arr)];
2014
2024
  }
@@ -2049,11 +2059,11 @@ function formatAge(ms) {
2049
2059
  }
2050
2060
  function unmetIntroExposeTags(tags, userTagElo, minCount) {
2051
2061
  if (minCount <= 0) return [];
2052
- const exposeTags = new Set(tags.filter((tag) => tag.startsWith("gpc:expose:")));
2062
+ const exposeTags = new Set(tags.filter((tag) => tagRole(tag) === "expose"));
2053
2063
  for (const tag of tags) {
2054
- if (!tag.startsWith("gpc:intro:")) continue;
2055
- const suffix = tag.slice("gpc:intro:".length);
2056
- if (suffix) exposeTags.add(`gpc:expose:${suffix}`);
2064
+ if (tagRole(tag) !== "intro") continue;
2065
+ const expose = withTagRole(tag, "expose");
2066
+ if (expose) exposeTags.add(expose);
2057
2067
  }
2058
2068
  return [...exposeTags].filter((tag) => {
2059
2069
  const tagElo = userTagElo[tag];
@@ -3255,6 +3265,7 @@ __export(eloDistance_exports, {
3255
3265
  mountMultiDimEloToggle: () => mountMultiDimEloToggle,
3256
3266
  tagAwareGap: () => tagAwareGap
3257
3267
  });
3268
+ import { COUNT_ONLY_SCORE, isCountOnlyTag } from "@vue-skuilder/common";
3258
3269
  function computeMultiplier(distance, halfLife, minMultiplier, maxMultiplier) {
3259
3270
  const normalizedDistance = distance / halfLife;
3260
3271
  const decay = Math.exp(-(normalizedDistance * normalizedDistance));
@@ -3297,7 +3308,9 @@ function tagAwareGap(cardTags, cardElo, userElo, minTagCount) {
3297
3308
  const tags = [];
3298
3309
  for (const tag of cardTags) {
3299
3310
  const user = userElo.tags[tag];
3300
- if (!user || user.score === COUNT_ONLY_SENTINEL || user.count < minTagCount) continue;
3311
+ if (isCountOnlyTag(tag) || !user || user.score === COUNT_ONLY_SCORE || user.count < minTagCount) {
3312
+ continue;
3313
+ }
3301
3314
  const card = cardElo.tags[tag]?.score ?? cardElo.global.score;
3302
3315
  tags.push({
3303
3316
  tag,
@@ -3369,7 +3382,7 @@ function createEloDistanceFilter(config) {
3369
3382
  transform: (cards, context) => applyEloDistance(cards, context, resolved, source)
3370
3383
  };
3371
3384
  }
3372
- var DEFAULT_ELO_DISTANCE_CONFIG, TAG_CONFIDENCE_HALF, COUNT_ONLY_SENTINEL, DEFAULT_CARD_ELO, MULTI_DIM_ELO_KEY, multiDimElo, EloDistanceFilter;
3385
+ var DEFAULT_ELO_DISTANCE_CONFIG, TAG_CONFIDENCE_HALF, DEFAULT_CARD_ELO, MULTI_DIM_ELO_KEY, multiDimElo, EloDistanceFilter;
3373
3386
  var init_eloDistance = __esm({
3374
3387
  "src/core/navigators/filters/eloDistance.ts"() {
3375
3388
  "use strict";
@@ -3383,7 +3396,6 @@ var init_eloDistance = __esm({
3383
3396
  minTagCount: 3
3384
3397
  };
3385
3398
  TAG_CONFIDENCE_HALF = 10;
3386
- COUNT_ONLY_SENTINEL = -1;
3387
3399
  DEFAULT_CARD_ELO = 1e3;
3388
3400
  MULTI_DIM_ELO_KEY = "skuilder:multiDimElo";
3389
3401
  multiDimElo = readMultiDimElo();
@@ -4758,6 +4770,11 @@ var init_Pipeline = __esm({
4758
4770
  * This eliminates a remote getCourseConfig() round trip per pipeline run.
4759
4771
  */
4760
4772
  _cachedOrchestration = null;
4773
+ /**
4774
+ * Hash of the strategy docs this pipeline was assembled from (see
4775
+ * versionStamps.ts), set by whoever builds it. Stamped on every run.
4776
+ */
4777
+ strategyHash;
4761
4778
  /**
4762
4779
  * Persistent tag cache. Maps cardId → tag names.
4763
4780
  *
@@ -4951,7 +4968,8 @@ var init_Pipeline = __esm({
4951
4968
  logResultCards(result);
4952
4969
  logCardProvenance(result, 3);
4953
4970
  try {
4954
- const courseName = await this.course?.getCourseConfig().then((c) => c.name).catch(() => void 0);
4971
+ const courseConfig = await this.course?.getCourseConfig().catch(() => void 0);
4972
+ const courseName = courseConfig?.name;
4955
4973
  const report = buildRunReport(
4956
4974
  this.course?.getCourseID() || "unknown",
4957
4975
  courseName,
@@ -4966,7 +4984,11 @@ var init_Pipeline = __esm({
4966
4984
  scoredCards,
4967
4985
  regulators
4968
4986
  );
4969
- captureRun(report);
4987
+ const versions = {
4988
+ ...this.strategyHash ? { strategies: this.strategyHash } : {},
4989
+ ...courseConfig?.contentVersion ? { content: courseConfig.contentVersion } : {}
4990
+ };
4991
+ captureRun({ ...report, ...Object.keys(versions).length ? { versions } : {} });
4970
4992
  } catch (e) {
4971
4993
  logger.debug(`[Pipeline] Failed to capture debug run: ${e}`);
4972
4994
  }
@@ -5463,6 +5485,43 @@ var init_Pipeline = __esm({
5463
5485
  }
5464
5486
  });
5465
5487
 
5488
+ // src/core/versionStamps.ts
5489
+ function setAppVersion(version) {
5490
+ hostAppVersion = version;
5491
+ }
5492
+ function sessionVersions() {
5493
+ return { framework: FRAMEWORK_VERSION, ...hostAppVersion ? { app: hostAppVersion } : {} };
5494
+ }
5495
+ function stableStringify(value) {
5496
+ if (Array.isArray(value)) return `[${value.map(stableStringify).join(",")}]`;
5497
+ if (value && typeof value === "object") {
5498
+ const entries = Object.entries(value).filter(([, v]) => v !== void 0).sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0);
5499
+ return `{${entries.map(([k, v]) => `${JSON.stringify(k)}:${stableStringify(v)}`).join(",")}}`;
5500
+ }
5501
+ return JSON.stringify(value);
5502
+ }
5503
+ function strategyHash(strategies) {
5504
+ if (strategies.length === 0) return DEFAULT_STRATEGY_HASH;
5505
+ const text = strategies.map((s) => {
5506
+ const { _rev: _ignored, ...rest } = s;
5507
+ return stableStringify(rest);
5508
+ }).sort().join("\n");
5509
+ let h = 2166136261;
5510
+ for (let i = 0; i < text.length; i++) {
5511
+ h ^= text.charCodeAt(i);
5512
+ h = Math.imul(h, 16777619);
5513
+ }
5514
+ return (h >>> 0).toString(16).padStart(8, "0");
5515
+ }
5516
+ var FRAMEWORK_VERSION, hostAppVersion, DEFAULT_STRATEGY_HASH;
5517
+ var init_versionStamps = __esm({
5518
+ "src/core/versionStamps.ts"() {
5519
+ "use strict";
5520
+ FRAMEWORK_VERSION = true ? "0.2.32" : "dev";
5521
+ DEFAULT_STRATEGY_HASH = "default";
5522
+ }
5523
+ });
5524
+
5466
5525
  // src/core/navigators/defaults.ts
5467
5526
  var defaults_exports = {};
5468
5527
  __export(defaults_exports, {
@@ -5515,7 +5574,9 @@ function createDefaultPipeline(user, course) {
5515
5574
  course,
5516
5575
  createDefaultEloDistanceStrategy(courseId)
5517
5576
  );
5518
- return new Pipeline(compositeGenerator, [eloDistanceFilter], user, course);
5577
+ const pipeline = new Pipeline(compositeGenerator, [eloDistanceFilter], user, course);
5578
+ pipeline.strategyHash = DEFAULT_STRATEGY_HASH;
5579
+ return pipeline;
5519
5580
  }
5520
5581
  var init_defaults = __esm({
5521
5582
  "src/core/navigators/defaults.ts"() {
@@ -5527,6 +5588,7 @@ var init_defaults = __esm({
5527
5588
  init_srs();
5528
5589
  init_eloDistance();
5529
5590
  init_types_legacy();
5591
+ init_versionStamps();
5530
5592
  }
5531
5593
  });
5532
5594
 
@@ -5670,6 +5732,7 @@ var init_PipelineAssembler = __esm({
5670
5732
  init_logger();
5671
5733
  init_CompositeGenerator();
5672
5734
  init_pipelinePlan();
5735
+ init_versionStamps();
5673
5736
  PipelineAssembler = class {
5674
5737
  /**
5675
5738
  * Assembles a navigation pipeline from strategy documents.
@@ -5751,6 +5814,7 @@ var init_PipelineAssembler = __esm({
5751
5814
  }
5752
5815
  }
5753
5816
  const pipeline = new Pipeline(generator, filters, user, course);
5817
+ pipeline.strategyHash = strategyHash(strategies);
5754
5818
  logger.debug(
5755
5819
  `[PipelineAssembler] Assembled pipeline with ${generatorStrategies.length} generator(s) and ${filters.length} filter(s)`
5756
5820
  );
@@ -8183,8 +8247,24 @@ var init_tagRecent = __esm({
8183
8247
  import {
8184
8248
  adjustCourseScores,
8185
8249
  adjustCourseScoresPerTag,
8250
+ isCountOnlyTag as isCountOnlyTag2,
8186
8251
  toCourseElo as toCourseElo7
8187
8252
  } from "@vue-skuilder/common";
8253
+ function withCountOnlyRoles(perf, cardId) {
8254
+ const out = { ...perf };
8255
+ const counted = [];
8256
+ for (const [tag, score] of Object.entries(perf)) {
8257
+ if (tag === "_global" || score === null || !isCountOnlyTag2(tag)) continue;
8258
+ out[tag] = null;
8259
+ counted.push(tag);
8260
+ }
8261
+ if (counted.length) {
8262
+ logger.warn(
8263
+ `[EloService] ${cardId} sent scores for bookkeeping tags [${counted.join(", ")}]; counted, not graded`
8264
+ );
8265
+ }
8266
+ return out;
8267
+ }
8188
8268
  var EloService;
8189
8269
  var init_EloService = __esm({
8190
8270
  "src/study/services/EloService.ts"() {
@@ -8235,10 +8315,11 @@ var init_EloService = __esm({
8235
8315
  courseReg.elo = eloUpdate.userElo;
8236
8316
  const tags = {};
8237
8317
  for (const tag of cardTagKeys) {
8318
+ const countOnly = isCountOnlyTag2(tag);
8238
8319
  tags[tag] = {
8239
8320
  before: beforeUserTag[tag],
8240
- after: eloUpdate.userElo.tags[tag].score,
8241
- score: userScore
8321
+ after: countOnly ? beforeUserTag[tag] : eloUpdate.userElo.tags[tag].score,
8322
+ score: countOnly ? null : userScore
8242
8323
  };
8243
8324
  }
8244
8325
  const event = {
@@ -8309,11 +8390,12 @@ var init_EloService = __esm({
8309
8390
  ]);
8310
8391
  const cardElo = cardEloResults[0];
8311
8392
  const cardTags = cardTagsMap.get(card_id) ?? [];
8312
- const enriched = { ...taggedPerformance };
8393
+ const graded = withCountOnlyRoles(taggedPerformance, card_id);
8394
+ const enriched = { ...graded };
8313
8395
  const globalScore = taggedPerformance._global;
8314
8396
  for (const tag of cardTags) {
8315
8397
  if (!(tag in enriched)) {
8316
- enriched[tag] = globalScore;
8398
+ enriched[tag] = isCountOnlyTag2(tag) ? null : globalScore;
8317
8399
  }
8318
8400
  }
8319
8401
  if (cardElo && userElo) {
@@ -8328,7 +8410,7 @@ var init_EloService = __esm({
8328
8410
  const at = (/* @__PURE__ */ new Date()).toISOString();
8329
8411
  const recorded = recordTagPresentations(
8330
8412
  eloUpdate.userElo,
8331
- taggedPerformance,
8413
+ graded,
8332
8414
  currentCard.records,
8333
8415
  card_id,
8334
8416
  at
@@ -11616,7 +11698,9 @@ function toRunCard(c) {
11616
11698
  cardId: c.cardId,
11617
11699
  origin: c.origin,
11618
11700
  ...c.generator ? { generator: c.generator } : {},
11619
- score: sig4(c.finalScore),
11701
+ ...c.required ? { required: c.required } : {},
11702
+ // A required card's score is infinite, which JSON can't hold: say so with null.
11703
+ score: Number.isFinite(c.finalScore) ? sig4(c.finalScore) : null,
11620
11704
  selected: c.selected
11621
11705
  };
11622
11706
  }
@@ -11667,6 +11751,7 @@ var init_SessionController = __esm({
11667
11751
  init_util2();
11668
11752
  init_navigators();
11669
11753
  init_Pipeline();
11754
+ init_versionStamps();
11670
11755
  init_SourceMixer();
11671
11756
  init_MixerDebugger();
11672
11757
  init_SessionDebugger();
@@ -11965,7 +12050,8 @@ var init_SessionController = __esm({
11965
12050
  ...run.discardedTail ? { discardedTail: run.discardedTail } : {},
11966
12051
  cards: persistedRunCards(run),
11967
12052
  ...run.unselectedNew ? { unselectedNew: persistedUnselectedNew(run.unselectedNew) } : {},
11968
- ...run.regulators ? { regulators: run.regulators.map(persistedReading) } : {}
12053
+ ...run.regulators ? { regulators: run.regulators.map(persistedReading) } : {},
12054
+ ...run.versions ? { versions: run.versions } : {}
11969
12055
  });
11970
12056
  }
11971
12057
  }
@@ -12002,6 +12088,7 @@ var init_SessionController = __esm({
12002
12088
  sourceCount: this.sources.length,
12003
12089
  initHints: this._sessionHints
12004
12090
  },
12091
+ versions: sessionVersions(),
12005
12092
  initialQueues: { supplyQ: this.supplyQ.length, failedQ: this.failedQ.length },
12006
12093
  runs: [...this._runLog],
12007
12094
  stateAtStart: await this._captureState("start")
@@ -15708,6 +15795,9 @@ async function initializeDataLayer(config) {
15708
15795
  if (config.options.localStoragePrefix) {
15709
15796
  ENV.LOCAL_STORAGE_PREFIX = config.options.localStoragePrefix;
15710
15797
  }
15798
+ if (config.options.appVersion) {
15799
+ setAppVersion(config.options.appVersion);
15800
+ }
15711
15801
  if (config.type === "couch") {
15712
15802
  if (!config.options.COUCHDB_SERVER_URL || !config.options.COUCHDB_SERVER_PROTOCOL) {
15713
15803
  throw new Error("Missing CouchDB server URL or protocol");
@@ -15764,6 +15854,7 @@ var init_factory = __esm({
15764
15854
  init_common();
15765
15855
  init_logger();
15766
15856
  init_navigators();
15857
+ init_versionStamps();
15767
15858
  NOT_SET = "NOT_SET";
15768
15859
  ENV = {
15769
15860
  COUCHDB_SERVER_PROTOCOL: NOT_SET,