@shaxpir/duiduidui-models 1.9.21 → 1.9.22

package/dist/models/Collection.d.ts

@@ -3,7 +3,7 @@ import { CompactDateTime } from "@shaxpir/shaxpir-common";
 import { ShareSync } from '../repo';
 import { Conditions } from './Condition';
 import { Content, ContentBody, ContentId, ContentMeta } from "./Content";
-import { UncertainValue } from './Progress';
+import { SkillLevel } from './SkillLevel';
 /**
  * Display metadata for a Collection, used in the UI.
  */
@@ -23,7 +23,7 @@ export interface CollectionPayload {
     collection_key: string;
     conditions: Conditions;
     display: CollectionDisplay;
-    proficiency: UncertainValue;
+    proficiency: SkillLevel;
     term_scores: {
         [termKey: string]: number;
     };
@@ -77,10 +77,9 @@ export declare class Collection extends Content {
     get description(): string;
     get icon(): string | undefined;
     get sortOrder(): number;
-    get proficiency(): UncertainValue;
-    get proficiencyRating(): number;
-    get proficiencyRatingDeviation(): number;
-    get proficiencyVolatility(): number;
+    get proficiency(): SkillLevel;
+    get proficiencyMu(): number;
+    get proficiencySigma(): number;
     get termScores(): {
         [termKey: string]: number;
     };
@@ -125,9 +124,9 @@ export declare class Collection extends Content {
         F: number;
     };
     /**
-     * Update the Glicko-2 proficiency rating.
+     * Update the IRT proficiency rating.
      */
-    setProficiency(value: UncertainValue): void;
+    setProficiency(value: SkillLevel): void;
     /**
      * Update or add a term score in the collection.
      */

package/dist/models/Collection.js

@@ -7,6 +7,7 @@ const SenseRankEncoder_1 = require("../util/SenseRankEncoder");
 const Content_1 = require("./Content");
 const ContentKind_1 = require("./ContentKind");
 const Operation_1 = require("./Operation");
+const SkillLevel_1 = require("./SkillLevel");
 class Collection extends Content_1.Content {
     /**
      * Generate a deterministic Collection ID from userId and collectionKey.
@@ -50,12 +51,8 @@ class Collection extends Content_1.Content {
                 collection_key: params.collectionKey,
                 conditions: params.conditions,
                 display: params.display,
-                // Initial Glicko-2 proficiency - high uncertainty, no data yet
-                proficiency: {
-                    rating: 0, // Start at zero (no demonstrated skill)
-                    rating_deviation: 50, // High initial uncertainty
-                    volatility: 0.06 // Moderate initial volatility
-                },
+                // Initial IRT proficiency - high uncertainty, no data yet
+                proficiency: SkillLevel_1.SkillLevelModel.createDefault(),
                 // Empty term scores map - populated as user reviews cards
                 term_scores: {},
                 // Progress starts at zero
@@ -118,17 +115,13 @@ class Collection extends Content_1.Content {
         this.checkDisposed("Collection.proficiency");
         return shaxpir_common_1.Struct.clone(this.payload.proficiency);
     }
-    get proficiencyRating() {
-        this.checkDisposed("Collection.proficiencyRating");
-        return this.payload.proficiency.rating;
+    get proficiencyMu() {
+        this.checkDisposed("Collection.proficiencyMu");
+        return this.payload.proficiency.mu;
     }
-    get proficiencyRatingDeviation() {
-        this.checkDisposed("Collection.proficiencyRatingDeviation");
-        return this.payload.proficiency.rating_deviation;
-    }
-    get proficiencyVolatility() {
-        this.checkDisposed("Collection.proficiencyVolatility");
-        return this.payload.proficiency.volatility;
+    get proficiencySigma() {
+        this.checkDisposed("Collection.proficiencySigma");
+        return this.payload.proficiency.sigma;
     }
     // ============================================================
     // Term scores getters
@@ -232,15 +225,14 @@ class Collection extends Content_1.Content {
     // Mutators
     // ============================================================
     /**
-     * Update the Glicko-2 proficiency rating.
+     * Update the IRT proficiency rating.
      */
     setProficiency(value) {
         this.checkDisposed("Collection.setProficiency");
         if (!shaxpir_common_1.Struct.equals(this.payload.proficiency, value)) {
             const batch = new Operation_1.BatchOperation(this);
-            batch.setPathValue(['payload', 'proficiency', 'rating'], value.rating);
-            batch.setPathValue(['payload', 'proficiency', 'rating_deviation'], value.rating_deviation);
-            batch.setPathValue(['payload', 'proficiency', 'volatility'], value.volatility);
+            batch.setPathValue(['payload', 'proficiency', 'mu'], value.mu);
+            batch.setPathValue(['payload', 'proficiency', 'sigma'], value.sigma);
             batch.commit();
         }
     }

package/dist/models/Progress.d.ts

@@ -2,11 +2,7 @@ import { Doc } from '@shaxpir/sharedb/lib/client';
 import { CompactDate } from "@shaxpir/shaxpir-common";
 import { ShareSync } from '../repo';
 import { Content, ContentBody, ContentId, ContentMeta } from "./Content";
-export interface UncertainValue {
-    rating: number;
-    rating_deviation: number;
-    volatility: number;
-}
+import { SkillLevel } from './SkillLevel';
 export interface StreakData {
     daily: {
         current: number;
@@ -26,7 +22,7 @@ export interface StreakData {
     total_days: number;
 }
 export interface ProgressPayload {
-    skill_level: UncertainValue;
+    skill_level: SkillLevel;
     cognitive_load: number;
     streaks?: StreakData;
     total_review_count: number;
@@ -40,18 +36,16 @@ export declare class Progress extends Content {
     static create(userId: ContentId): Progress;
     constructor(doc: Doc, shouldAcquire: boolean, shareSync: ShareSync);
     get payload(): ProgressPayload;
-    getSkillLevel(): UncertainValue;
-    getSkillLevelValue(): number;
-    getSkillLevelRatingDeviation(): number;
-    getSkillLevelVolatility(): number;
+    getSkillLevel(): SkillLevel;
+    getSkillLevelMu(): number;
+    getSkillLevelSigma(): number;
     getSkillLevelLowerBound(): number;
     getSkillLevelUpperBound(): number;
     needsCalibration(): boolean;
     getCognitiveLoad(): number;
-    setSkillLevel(uncertainValue: UncertainValue): void;
-    setSkillLevelValue(value: number): void;
-    setSkillLevelRatingDeviation(ratingDeviation: number): void;
-    setSkillLevelVolatility(volatility: number): void;
+    setSkillLevel(skillLevel: SkillLevel): void;
+    setSkillLevelMu(mu: number): void;
+    setSkillLevelSigma(sigma: number): void;
     setCognitiveLoad(value: number): void;
     getStreaks(): StreakData | undefined;
     setStreaks(streaks: StreakData): void;

package/dist/models/Progress.js

@@ -6,6 +6,7 @@ const repo_1 = require("../repo");
 const Content_1 = require("./Content");
 const ContentKind_1 = require("./ContentKind");
 const Operation_1 = require("./Operation");
+const SkillLevel_1 = require("./SkillLevel");
 class Progress extends Content_1.Content {
     static makeProgressId(userId) {
         return shaxpir_common_1.CachingHasher.makeMd5Base62Hash(userId + "-" + ContentKind_1.ContentKind.PROGRESS);
@@ -23,13 +24,9 @@ class Progress extends Content_1.Content {
                 updated_at: now
             },
             payload: {
-                skill_level: {
-                    rating: 0, // Start at absolute beginner (knows ~0 characters)
-                    rating_deviation: 50, // Initial uncertainty (±100 chars at 95% CI)
-                    volatility: 0.06 // Moderate initial volatility
-                },
+                skill_level: SkillLevel_1.SkillLevelModel.createDefault(),
                 cognitive_load: 0,
-                total_review_count: 0 // Start with zero lifetime reviews
+                total_review_count: 0
             }
         });
     }
@@ -44,71 +41,56 @@ class Progress extends Content_1.Content {
         this.checkDisposed("Progress.getSkillLevel");
         return shaxpir_common_1.Struct.clone(this.payload.skill_level);
     }
-    getSkillLevelValue() {
-        this.checkDisposed("Progress.getSkillLevelValue");
-        return this.payload.skill_level.rating;
+    getSkillLevelMu() {
+        this.checkDisposed("Progress.getSkillLevelMu");
+        return this.payload.skill_level.mu;
     }
-    getSkillLevelRatingDeviation() {
-        this.checkDisposed("Progress.getSkillLevelRatingDeviation");
-        return this.payload.skill_level.rating_deviation;
-    }
-    getSkillLevelVolatility() {
-        this.checkDisposed("Progress.getSkillLevelVolatility");
-        return this.payload.skill_level.volatility;
+    getSkillLevelSigma() {
+        this.checkDisposed("Progress.getSkillLevelSigma");
+        return this.payload.skill_level.sigma;
     }
     getSkillLevelLowerBound() {
         this.checkDisposed("Progress.getSkillLevelLowerBound");
-        const { SkillLevelModel } = require('./SkillLevel');
-        const bounds = SkillLevelModel.calculateBounds(this.payload.skill_level.rating, this.payload.skill_level.rating_deviation);
+        const bounds = SkillLevel_1.SkillLevelModel.calculateBounds(this.payload.skill_level.mu, this.payload.skill_level.sigma);
         return bounds.lower;
     }
     getSkillLevelUpperBound() {
         this.checkDisposed("Progress.getSkillLevelUpperBound");
-        const { SkillLevelModel } = require('./SkillLevel');
-        const bounds = SkillLevelModel.calculateBounds(this.payload.skill_level.rating, this.payload.skill_level.rating_deviation);
+        const bounds = SkillLevel_1.SkillLevelModel.calculateBounds(this.payload.skill_level.mu, this.payload.skill_level.sigma);
         return bounds.upper;
     }
     needsCalibration() {
         this.checkDisposed("Progress.needsCalibration");
-        // High rating deviation means we need more data to calibrate user level
-        // rating_deviation > 30 means confidence bounds are still quite wide (±60 chars at 95% CI)
-        return this.payload.skill_level.rating_deviation > 30;
+        // High sigma means we need more data to calibrate user level
+        // sigma > 30 means confidence bounds are still quite wide (±60 chars at 95% CI)
+        return this.payload.skill_level.sigma > 30;
     }
     getCognitiveLoad() {
         this.checkDisposed("Progress.getCognitiveLoad");
         return this.payload.cognitive_load;
     }
-    setSkillLevel(uncertainValue) {
+    setSkillLevel(skillLevel) {
         this.checkDisposed("Progress.setSkillLevel");
-        if (!shaxpir_common_1.Struct.equals(this.payload.skill_level, uncertainValue)) {
-            const batch = new Operation_1.BatchOperation(this);
-            batch.setPathValue(['payload', 'skill_level', 'rating'], uncertainValue.rating);
-            batch.setPathValue(['payload', 'skill_level', 'rating_deviation'], uncertainValue.rating_deviation);
-            batch.setPathValue(['payload', 'skill_level', 'volatility'], uncertainValue.volatility);
-            batch.commit();
-        }
-    }
-    setSkillLevelValue(value) {
-        this.checkDisposed("Progress.setSkillLevelValue");
-        if (this.payload.skill_level.rating !== value) {
+        if (!shaxpir_common_1.Struct.equals(this.payload.skill_level, skillLevel)) {
             const batch = new Operation_1.BatchOperation(this);
-            batch.setPathValue(['payload', 'skill_level', 'rating'], value);
+            batch.setPathValue(['payload', 'skill_level', 'mu'], skillLevel.mu);
+            batch.setPathValue(['payload', 'skill_level', 'sigma'], skillLevel.sigma);
             batch.commit();
         }
     }
-    setSkillLevelRatingDeviation(ratingDeviation) {
-        this.checkDisposed("Progress.setSkillLevelRatingDeviation");
-        if (this.payload.skill_level.rating_deviation !== ratingDeviation) {
+    setSkillLevelMu(mu) {
+        this.checkDisposed("Progress.setSkillLevelMu");
+        if (this.payload.skill_level.mu !== mu) {
             const batch = new Operation_1.BatchOperation(this);
-            batch.setPathValue(['payload', 'skill_level', 'rating_deviation'], ratingDeviation);
+            batch.setPathValue(['payload', 'skill_level', 'mu'], mu);
             batch.commit();
         }
     }
-    setSkillLevelVolatility(volatility) {
-        this.checkDisposed("Progress.setSkillLevelVolatility");
-        if (this.payload.skill_level.volatility !== volatility) {
+    setSkillLevelSigma(sigma) {
+        this.checkDisposed("Progress.setSkillLevelSigma");
+        if (this.payload.skill_level.sigma !== sigma) {
             const batch = new Operation_1.BatchOperation(this);
-            batch.setPathValue(['payload', 'skill_level', 'volatility'], volatility);
+            batch.setPathValue(['payload', 'skill_level', 'sigma'], sigma);
             batch.commit();
         }
     }

package/dist/models/Session.d.ts

@@ -4,7 +4,7 @@ import { ShareSync } from '../repo';
 import { Conditions } from './Condition';
 import { Content, ContentBody, ContentId, ContentMeta, ContentRef } from "./Content";
 import { Review } from './Review';
-import { UncertainValue } from './Progress';
+import { SkillLevel } from './SkillLevel';
 /**
  * How aggressively the card selection algorithm stretches the user
  * beyond their current skill level.
@@ -29,7 +29,7 @@ export interface SessionConfig {
     };
 }
 export interface SessionStats {
-    skill_level: UncertainValue;
+    skill_level: SkillLevel;
     cognitive_load: number;
     theta_distribution: {
         A: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shaxpir/duiduidui-models",
-  "version": "1.9.21",
+  "version": "1.9.22",
   "repository": {
     "type": "git",
     "url": "https://github.com/shaxpir/duiduidui-models"