@playcademy/sandbox 0.5.1 → 0.5.2-beta.1

package/dist/cli.js

@@ -1078,7 +1078,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@playcademy/sandbox",
-    version: "0.5.1",
+    version: "0.5.2-beta.1",
     description: "Local development server for Playcademy game development",
     type: "module",
     exports: {
@@ -31916,6 +31916,95 @@ class TimebackCacheManager {
     this.enrollmentCache.cleanup();
   }
 }
+function computeMasteryPct(masteredUnits, masterableUnits) {
+  if (masterableUnits <= 0) {
+    return 0;
+  }
+  return masteredUnits / masterableUnits;
+}
+function clampMasteryPct(masteryPct) {
+  return Math.min(1, Math.max(0, masteryPct));
+}
+function createMasteryWriteWarning({
+  currentMasteredUnits,
+  attemptedMasteredUnits,
+  storedMasteredUnits,
+  masterableUnits,
+  effectiveDelta
+}) {
+  let message;
+  if (attemptedMasteredUnits < 0) {
+    message = `Activity saved. Mastery was capped at the configured minimum: attempted ${attemptedMasteredUnits}/${masterableUnits}, applied ${effectiveDelta} units, stored ${storedMasteredUnits}/${masterableUnits}.`;
+  } else if (storedMasteredUnits > masterableUnits) {
+    message = `Activity saved. Mastery remains above the configured maximum: attempted ${attemptedMasteredUnits}/${masterableUnits}, applied ${effectiveDelta} units, stored ${storedMasteredUnits}/${masterableUnits}.`;
+  } else {
+    message = `Activity saved. Mastery was capped at the configured maximum: attempted ${attemptedMasteredUnits}/${masterableUnits}, applied ${effectiveDelta} units, stored ${storedMasteredUnits}/${masterableUnits}.`;
+  }
+  return {
+    code: MASTERY_WRITE_CAPPED_WARNING_CODE,
+    message,
+    currentMasteredUnits,
+    attemptedMasteredUnits,
+    appliedMasteredUnits: effectiveDelta,
+    storedMasteredUnits,
+    masterableUnits
+  };
+}
+function evaluateMasteryBounds({
+  currentMasteredUnits,
+  masterableUnits,
+  masteredUnits = 0,
+  masteredUnitsAbsolute
+}) {
+  const attemptedMasteredUnits = masteredUnitsAbsolute === undefined ? currentMasteredUnits + masteredUnits : masteredUnitsAbsolute;
+  const base = {
+    currentMasteredUnits,
+    attemptedMasteredUnits,
+    masterableUnits
+  };
+  if (!Number.isFinite(currentMasteredUnits) || !Number.isFinite(masterableUnits) || !Number.isFinite(masteredUnits) || masteredUnitsAbsolute !== undefined && !Number.isFinite(masteredUnitsAbsolute) || !Number.isFinite(attemptedMasteredUnits)) {
+    throw new Error("Mastery bounds evaluation requires finite numeric values.");
+  }
+  if (attemptedMasteredUnits < 0) {
+    const storedMasteredUnits2 = 0;
+    const effectiveDelta2 = storedMasteredUnits2 - currentMasteredUnits;
+    return {
+      ...base,
+      storedMasteredUnits: storedMasteredUnits2,
+      effectiveDelta: effectiveDelta2,
+      writeWarning: createMasteryWriteWarning({
+        currentMasteredUnits,
+        attemptedMasteredUnits,
+        storedMasteredUnits: storedMasteredUnits2,
+        masterableUnits,
+        effectiveDelta: effectiveDelta2
+      })
+    };
+  }
+  if (masterableUnits > 0 && attemptedMasteredUnits > masterableUnits) {
+    const storedMasteredUnits2 = currentMasteredUnits > masterableUnits ? Math.min(currentMasteredUnits, attemptedMasteredUnits) : masterableUnits;
+    const effectiveDelta2 = storedMasteredUnits2 - currentMasteredUnits;
+    return {
+      ...base,
+      storedMasteredUnits: storedMasteredUnits2,
+      effectiveDelta: effectiveDelta2,
+      writeWarning: createMasteryWriteWarning({
+        currentMasteredUnits,
+        attemptedMasteredUnits,
+        storedMasteredUnits: storedMasteredUnits2,
+        masterableUnits,
+        effectiveDelta: effectiveDelta2
+      })
+    };
+  }
+  const storedMasteredUnits = attemptedMasteredUnits;
+  const effectiveDelta = storedMasteredUnits - currentMasteredUnits;
+  return {
+    ...base,
+    storedMasteredUnits,
+    effectiveDelta
+  };
+}
 
 class MasteryTracker {
   cacheManager;
@@ -31938,7 +32027,8 @@ class MasteryTracker {
       courseId,
       resourceId,
       additionalMasteredUnits: hasAbsolute ? 0 : masteredUnits,
-      absoluteMasteredUnits: hasAbsolute ? masteredUnitsAbsolute : undefined
+      absoluteMasteredUnits: hasAbsolute ? masteredUnitsAbsolute : undefined,
+      validateBounds: true
     });
     if (!status) {
       return;
@@ -31948,13 +32038,15 @@ class MasteryTracker {
       pctCompleteApp: status.pctCompleteApp,
       masteryAchieved: !wasComplete && status.isComplete,
       masteryRevoked: wasComplete && !status.isComplete,
-      effectiveDelta: status.effectiveDelta
+      effectiveDelta: status.effectiveDelta,
+      ...status.writeWarning ? { writeWarning: status.writeWarning } : {}
     };
   }
   async getStatus(input) {
     const status = await this.calculateStatus({
       ...input,
-      additionalMasteredUnits: 0
+      additionalMasteredUnits: 0,
+      validateBounds: false
     });
     if (!status) {
       return;
@@ -31971,7 +32063,8 @@ class MasteryTracker {
     courseId,
     resourceId,
     additionalMasteredUnits,
-    absoluteMasteredUnits
+    absoluteMasteredUnits,
+    validateBounds
   }) {
     const masterableUnits = await this.resolveMasterableUnits(resourceId);
     if (!masterableUnits || masterableUnits <= 0) {
@@ -31984,24 +32077,38 @@ class MasteryTracker {
       return;
     }
     const historicalMasteredUnits = this.sumAnalyticsMetric(facts, "masteredUnits");
-    let totalMastered;
-    let effectiveDelta;
-    if (absoluteMasteredUnits !== undefined) {
-      totalMastered = Math.max(0, absoluteMasteredUnits);
-      effectiveDelta = totalMastered - historicalMasteredUnits;
-    } else {
-      effectiveDelta = additionalMasteredUnits;
-      totalMastered = Math.max(0, historicalMasteredUnits + effectiveDelta);
+    const bounds = validateBounds ? evaluateMasteryBounds({
+      currentMasteredUnits: historicalMasteredUnits,
+      masterableUnits,
+      masteredUnits: additionalMasteredUnits,
+      masteredUnitsAbsolute: absoluteMasteredUnits
+    }) : {
+      currentMasteredUnits: historicalMasteredUnits,
+      attemptedMasteredUnits: historicalMasteredUnits,
+      storedMasteredUnits: historicalMasteredUnits,
+      masterableUnits,
+      effectiveDelta: 0
+    };
+    if (validateBounds && bounds.writeWarning) {
+      addEvent("timeback.mastery_write_capped", {
+        "app.timeback.current_mastered_units": bounds.currentMasteredUnits,
+        "app.timeback.attempted_mastered_units": bounds.attemptedMasteredUnits,
+        "app.timeback.applied_mastered_units": bounds.effectiveDelta,
+        "app.timeback.stored_mastered_units": bounds.storedMasteredUnits,
+        "app.timeback.masterable_units": bounds.masterableUnits
+      });
     }
-    const rawPct = totalMastered / masterableUnits * 100;
-    const pctCompleteApp = Math.min(100, Math.max(0, Math.round(rawPct)));
+    const masteredUnits = bounds.storedMasteredUnits;
+    const masteryPct = computeMasteryPct(masteredUnits, masterableUnits);
+    const pctCompleteApp = Math.round(clampMasteryPct(masteryPct) * 100);
     return {
-      masteredUnits: totalMastered,
+      masteredUnits,
       masterableUnits,
       pctCompleteApp,
-      isComplete: totalMastered >= masterableUnits,
+      isComplete: masteredUnits >= masterableUnits,
       historicalMasteredUnits,
-      effectiveDelta
+      effectiveDelta: bounds.effectiveDelta,
+      ...bounds.writeWarning ? { writeWarning: bounds.writeWarning } : {}
     };
   }
   async createCompletionEntry(studentId, courseId, classId, appName) {
@@ -32200,8 +32307,6 @@ class ProgressRecorder {
       xpEarned = 0,
       attemptNumber
     } = progressData;
-    const actualLineItemId = await this.resolveAssessmentLineItem(activityId, activityName, progressData.classId, ids);
-    const currentAttemptNumber = await this.resolveAttemptNumber(attemptNumber, score, studentId, actualLineItemId);
     let extensions = progressData.extensions;
     const masteryProgress = await this.masteryTracker.checkProgress({
       studentId,
@@ -32215,6 +32320,7 @@ class ProgressRecorder {
     let masteryAchieved = false;
     let scoreStatus = SCORE_STATUS.fullyGraded;
     const inProgress = "false";
+    const warnings = masteryProgress?.writeWarning ? [masteryProgress.writeWarning] : undefined;
     if (masteryProgress) {
       masteryAchieved = masteryProgress.masteryAchieved;
       pctCompleteApp = masteryProgress.pctCompleteApp;
@@ -32226,6 +32332,8 @@ class ProgressRecorder {
         scoreStatus = SCORE_STATUS.fullyGraded;
       }
     }
+    const actualLineItemId = await this.resolveAssessmentLineItem(activityId, activityName, progressData.classId, ids);
+    const currentAttemptNumber = await this.resolveAttemptNumber(attemptNumber, score, studentId, actualLineItemId);
     if (score !== undefined) {
       await this.createGradebookEntry({
         lineItemId: actualLineItemId,
@@ -32284,7 +32392,8 @@ class ProgressRecorder {
       masteredUnitsApplied: effectiveMasteredUnits,
       pctCompleteApp,
       scoreStatus,
-      inProgress
+      inProgress,
+      ...warnings ? { warnings } : {}
     };
   }
   async resolveContext(courseId, studentIdentifier, progressData) {
@@ -32970,7 +33079,7 @@ var __defProp2, __export2 = (target, all) => {
       configurable: true,
       set: (newValue) => all[name3] = () => newValue
     });
-}, __esm2 = (fn, res) => () => (fn && (res = fn(fn = 0)), res), TIMEBACK_API_URLS, QTI_API_URL = "https://qti.alpha-1edtech.ai/api", TIMEBACK_AUTH_URLS, CALIPER_API_URLS, ONEROSTER_ENDPOINTS, QTI_ENDPOINTS, CALIPER_ENDPOINTS, CALIPER_CONSTANTS, TIMEBACK_EVENT_TYPES, TIMEBACK_ACTIONS, TIMEBACK_TYPES, ACTIVITY_METRIC_TYPES, TIME_METRIC_TYPES, TIMEBACK_SUBJECTS, TIMEBACK_GRADE_LEVELS, TIMEBACK_GRADE_LEVEL_LABELS, CALIPER_SUBJECTS, ONEROSTER_STATUS, SCORE_STATUS, ENV_VARS, HTTP_DEFAULTS, AUTH_DEFAULTS, CACHE_DEFAULTS, CONFIG_DEFAULTS, PLAYCADEMY_DEFAULTS, RESOURCE_DEFAULTS, HTTP_STATUS, ERROR_NAMES, init_constants4, exports_verify, init_verify, TimebackError, TimebackApiError, TimebackAuthenticationError, StudentNotFoundError, ConfigurationError, ResourceNotFoundError, SUBJECT_VALUES, GRADE_VALUES, TimebackAuthError, UUID_PATTERN, storage, EmailSchema, StudentSourcedIdSchema, StudentIdentifierSchema;
+}, __esm2 = (fn, res) => () => (fn && (res = fn(fn = 0)), res), TIMEBACK_API_URLS, QTI_API_URL = "https://qti.alpha-1edtech.ai/api", TIMEBACK_AUTH_URLS, CALIPER_API_URLS, ONEROSTER_ENDPOINTS, QTI_ENDPOINTS, CALIPER_ENDPOINTS, CALIPER_CONSTANTS, TIMEBACK_EVENT_TYPES, TIMEBACK_ACTIONS, TIMEBACK_TYPES, ACTIVITY_METRIC_TYPES, TIME_METRIC_TYPES, TIMEBACK_SUBJECTS, TIMEBACK_GRADE_LEVELS, TIMEBACK_GRADE_LEVEL_LABELS, CALIPER_SUBJECTS, ONEROSTER_STATUS, SCORE_STATUS, ENV_VARS, HTTP_DEFAULTS, AUTH_DEFAULTS, CACHE_DEFAULTS, CONFIG_DEFAULTS, PLAYCADEMY_DEFAULTS, RESOURCE_DEFAULTS, HTTP_STATUS, ERROR_NAMES, init_constants4, exports_verify, init_verify, TimebackError, TimebackApiError, TimebackAuthenticationError, StudentNotFoundError, ConfigurationError, ResourceNotFoundError, SUBJECT_VALUES, GRADE_VALUES, TimebackAuthError, UUID_PATTERN, storage, MASTERY_WRITE_CAPPED_WARNING_CODE = "MASTERY_WRITE_CAPPED", EmailSchema, StudentSourcedIdSchema, StudentIdentifierSchema;
 var init_dist2 = __esm(() => {
   init_src();
   init_src();
@@ -34503,8 +34612,8 @@ var init_schemas4 = __esm(() => {
       inactiveSeconds: exports_external.number().nonnegative().optional()
     }).optional(),
     xpEarned: exports_external.number(),
-    masteredUnits: exports_external.number().optional(),
-    masteredUnitsAbsolute: exports_external.number().int().nonnegative().optional(),
+    masteredUnits: exports_external.number().finite().optional(),
+    masteredUnitsAbsolute: exports_external.number().finite().int().optional(),
     extensions: exports_external.record(exports_external.string(), exports_external.unknown()).optional()
   }).refine((data) => !(data.masteredUnits !== undefined && data.masteredUnitsAbsolute !== undefined), {
     message: "Cannot provide both masteredUnits and masteredUnitsAbsolute",
@@ -38605,7 +38714,8 @@ var init_timeback_service = __esm(() => {
         masteredUnits: result.masteredUnitsApplied,
         pctCompleteApp: result.pctCompleteApp,
         scoreStatus: result.scoreStatus,
-        inProgress: result.inProgress
+        inProgress: result.inProgress,
+        ...result.warnings ? { warnings: result.warnings } : {}
       };
     }
     async resolveActiveGameCourse({
@@ -98356,7 +98466,7 @@ var init_timeback7 = __esm(() => {
         const seed3 = hashCode(`${e.grade}-${e.subject}`);
         const masterableUnits = 5 + seed3 % 16;
         const masteredUnits = seed3 % (masterableUnits + 1);
-        const pctComplete = masterableUnits > 0 ? Math.round(masteredUnits / masterableUnits * 1e4) / 100 : 0;
+        const pctComplete = masterableUnits > 0 ? Math.round(masteredUnits / masterableUnits * 100) : 0;
         return {
           grade: e.grade,
           subject: e.subject,

package/dist/server.js

@@ -1077,7 +1077,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@playcademy/sandbox",
-    version: "0.5.1",
+    version: "0.5.2-beta.1",
     description: "Local development server for Playcademy game development",
     type: "module",
     exports: {
@@ -31915,6 +31915,95 @@ class TimebackCacheManager {
     this.enrollmentCache.cleanup();
   }
 }
+function computeMasteryPct(masteredUnits, masterableUnits) {
+  if (masterableUnits <= 0) {
+    return 0;
+  }
+  return masteredUnits / masterableUnits;
+}
+function clampMasteryPct(masteryPct) {
+  return Math.min(1, Math.max(0, masteryPct));
+}
+function createMasteryWriteWarning({
+  currentMasteredUnits,
+  attemptedMasteredUnits,
+  storedMasteredUnits,
+  masterableUnits,
+  effectiveDelta
+}) {
+  let message;
+  if (attemptedMasteredUnits < 0) {
+    message = `Activity saved. Mastery was capped at the configured minimum: attempted ${attemptedMasteredUnits}/${masterableUnits}, applied ${effectiveDelta} units, stored ${storedMasteredUnits}/${masterableUnits}.`;
+  } else if (storedMasteredUnits > masterableUnits) {
+    message = `Activity saved. Mastery remains above the configured maximum: attempted ${attemptedMasteredUnits}/${masterableUnits}, applied ${effectiveDelta} units, stored ${storedMasteredUnits}/${masterableUnits}.`;
+  } else {
+    message = `Activity saved. Mastery was capped at the configured maximum: attempted ${attemptedMasteredUnits}/${masterableUnits}, applied ${effectiveDelta} units, stored ${storedMasteredUnits}/${masterableUnits}.`;
+  }
+  return {
+    code: MASTERY_WRITE_CAPPED_WARNING_CODE,
+    message,
+    currentMasteredUnits,
+    attemptedMasteredUnits,
+    appliedMasteredUnits: effectiveDelta,
+    storedMasteredUnits,
+    masterableUnits
+  };
+}
+function evaluateMasteryBounds({
+  currentMasteredUnits,
+  masterableUnits,
+  masteredUnits = 0,
+  masteredUnitsAbsolute
+}) {
+  const attemptedMasteredUnits = masteredUnitsAbsolute === undefined ? currentMasteredUnits + masteredUnits : masteredUnitsAbsolute;
+  const base = {
+    currentMasteredUnits,
+    attemptedMasteredUnits,
+    masterableUnits
+  };
+  if (!Number.isFinite(currentMasteredUnits) || !Number.isFinite(masterableUnits) || !Number.isFinite(masteredUnits) || masteredUnitsAbsolute !== undefined && !Number.isFinite(masteredUnitsAbsolute) || !Number.isFinite(attemptedMasteredUnits)) {
+    throw new Error("Mastery bounds evaluation requires finite numeric values.");
+  }
+  if (attemptedMasteredUnits < 0) {
+    const storedMasteredUnits2 = 0;
+    const effectiveDelta2 = storedMasteredUnits2 - currentMasteredUnits;
+    return {
+      ...base,
+      storedMasteredUnits: storedMasteredUnits2,
+      effectiveDelta: effectiveDelta2,
+      writeWarning: createMasteryWriteWarning({
+        currentMasteredUnits,
+        attemptedMasteredUnits,
+        storedMasteredUnits: storedMasteredUnits2,
+        masterableUnits,
+        effectiveDelta: effectiveDelta2
+      })
+    };
+  }
+  if (masterableUnits > 0 && attemptedMasteredUnits > masterableUnits) {
+    const storedMasteredUnits2 = currentMasteredUnits > masterableUnits ? Math.min(currentMasteredUnits, attemptedMasteredUnits) : masterableUnits;
+    const effectiveDelta2 = storedMasteredUnits2 - currentMasteredUnits;
+    return {
+      ...base,
+      storedMasteredUnits: storedMasteredUnits2,
+      effectiveDelta: effectiveDelta2,
+      writeWarning: createMasteryWriteWarning({
+        currentMasteredUnits,
+        attemptedMasteredUnits,
+        storedMasteredUnits: storedMasteredUnits2,
+        masterableUnits,
+        effectiveDelta: effectiveDelta2
+      })
+    };
+  }
+  const storedMasteredUnits = attemptedMasteredUnits;
+  const effectiveDelta = storedMasteredUnits - currentMasteredUnits;
+  return {
+    ...base,
+    storedMasteredUnits,
+    effectiveDelta
+  };
+}
 
 class MasteryTracker {
   cacheManager;
@@ -31937,7 +32026,8 @@ class MasteryTracker {
       courseId,
       resourceId,
       additionalMasteredUnits: hasAbsolute ? 0 : masteredUnits,
-      absoluteMasteredUnits: hasAbsolute ? masteredUnitsAbsolute : undefined
+      absoluteMasteredUnits: hasAbsolute ? masteredUnitsAbsolute : undefined,
+      validateBounds: true
     });
     if (!status) {
       return;
@@ -31947,13 +32037,15 @@ class MasteryTracker {
       pctCompleteApp: status.pctCompleteApp,
       masteryAchieved: !wasComplete && status.isComplete,
       masteryRevoked: wasComplete && !status.isComplete,
-      effectiveDelta: status.effectiveDelta
+      effectiveDelta: status.effectiveDelta,
+      ...status.writeWarning ? { writeWarning: status.writeWarning } : {}
     };
   }
   async getStatus(input) {
     const status = await this.calculateStatus({
       ...input,
-      additionalMasteredUnits: 0
+      additionalMasteredUnits: 0,
+      validateBounds: false
     });
     if (!status) {
       return;
@@ -31970,7 +32062,8 @@ class MasteryTracker {
     courseId,
     resourceId,
     additionalMasteredUnits,
-    absoluteMasteredUnits
+    absoluteMasteredUnits,
+    validateBounds
   }) {
     const masterableUnits = await this.resolveMasterableUnits(resourceId);
     if (!masterableUnits || masterableUnits <= 0) {
@@ -31983,24 +32076,38 @@ class MasteryTracker {
       return;
     }
     const historicalMasteredUnits = this.sumAnalyticsMetric(facts, "masteredUnits");
-    let totalMastered;
-    let effectiveDelta;
-    if (absoluteMasteredUnits !== undefined) {
-      totalMastered = Math.max(0, absoluteMasteredUnits);
-      effectiveDelta = totalMastered - historicalMasteredUnits;
-    } else {
-      effectiveDelta = additionalMasteredUnits;
-      totalMastered = Math.max(0, historicalMasteredUnits + effectiveDelta);
+    const bounds = validateBounds ? evaluateMasteryBounds({
+      currentMasteredUnits: historicalMasteredUnits,
+      masterableUnits,
+      masteredUnits: additionalMasteredUnits,
+      masteredUnitsAbsolute: absoluteMasteredUnits
+    }) : {
+      currentMasteredUnits: historicalMasteredUnits,
+      attemptedMasteredUnits: historicalMasteredUnits,
+      storedMasteredUnits: historicalMasteredUnits,
+      masterableUnits,
+      effectiveDelta: 0
+    };
+    if (validateBounds && bounds.writeWarning) {
+      addEvent("timeback.mastery_write_capped", {
+        "app.timeback.current_mastered_units": bounds.currentMasteredUnits,
+        "app.timeback.attempted_mastered_units": bounds.attemptedMasteredUnits,
+        "app.timeback.applied_mastered_units": bounds.effectiveDelta,
+        "app.timeback.stored_mastered_units": bounds.storedMasteredUnits,
+        "app.timeback.masterable_units": bounds.masterableUnits
+      });
     }
-    const rawPct = totalMastered / masterableUnits * 100;
-    const pctCompleteApp = Math.min(100, Math.max(0, Math.round(rawPct)));
+    const masteredUnits = bounds.storedMasteredUnits;
+    const masteryPct = computeMasteryPct(masteredUnits, masterableUnits);
+    const pctCompleteApp = Math.round(clampMasteryPct(masteryPct) * 100);
     return {
-      masteredUnits: totalMastered,
+      masteredUnits,
       masterableUnits,
       pctCompleteApp,
-      isComplete: totalMastered >= masterableUnits,
+      isComplete: masteredUnits >= masterableUnits,
       historicalMasteredUnits,
-      effectiveDelta
+      effectiveDelta: bounds.effectiveDelta,
+      ...bounds.writeWarning ? { writeWarning: bounds.writeWarning } : {}
     };
   }
   async createCompletionEntry(studentId, courseId, classId, appName) {
@@ -32199,8 +32306,6 @@ class ProgressRecorder {
       xpEarned = 0,
       attemptNumber
     } = progressData;
-    const actualLineItemId = await this.resolveAssessmentLineItem(activityId, activityName, progressData.classId, ids);
-    const currentAttemptNumber = await this.resolveAttemptNumber(attemptNumber, score, studentId, actualLineItemId);
     let extensions = progressData.extensions;
     const masteryProgress = await this.masteryTracker.checkProgress({
       studentId,
@@ -32214,6 +32319,7 @@ class ProgressRecorder {
     let masteryAchieved = false;
     let scoreStatus = SCORE_STATUS.fullyGraded;
     const inProgress = "false";
+    const warnings = masteryProgress?.writeWarning ? [masteryProgress.writeWarning] : undefined;
     if (masteryProgress) {
       masteryAchieved = masteryProgress.masteryAchieved;
       pctCompleteApp = masteryProgress.pctCompleteApp;
@@ -32225,6 +32331,8 @@ class ProgressRecorder {
         scoreStatus = SCORE_STATUS.fullyGraded;
       }
     }
+    const actualLineItemId = await this.resolveAssessmentLineItem(activityId, activityName, progressData.classId, ids);
+    const currentAttemptNumber = await this.resolveAttemptNumber(attemptNumber, score, studentId, actualLineItemId);
     if (score !== undefined) {
       await this.createGradebookEntry({
         lineItemId: actualLineItemId,
@@ -32283,7 +32391,8 @@ class ProgressRecorder {
       masteredUnitsApplied: effectiveMasteredUnits,
       pctCompleteApp,
       scoreStatus,
-      inProgress
+      inProgress,
+      ...warnings ? { warnings } : {}
     };
   }
   async resolveContext(courseId, studentIdentifier, progressData) {
@@ -32969,7 +33078,7 @@ var __defProp2, __export2 = (target, all) => {
       configurable: true,
       set: (newValue) => all[name3] = () => newValue
     });
-}, __esm2 = (fn, res) => () => (fn && (res = fn(fn = 0)), res), TIMEBACK_API_URLS, QTI_API_URL = "https://qti.alpha-1edtech.ai/api", TIMEBACK_AUTH_URLS, CALIPER_API_URLS, ONEROSTER_ENDPOINTS, QTI_ENDPOINTS, CALIPER_ENDPOINTS, CALIPER_CONSTANTS, TIMEBACK_EVENT_TYPES, TIMEBACK_ACTIONS, TIMEBACK_TYPES, ACTIVITY_METRIC_TYPES, TIME_METRIC_TYPES, TIMEBACK_SUBJECTS, TIMEBACK_GRADE_LEVELS, TIMEBACK_GRADE_LEVEL_LABELS, CALIPER_SUBJECTS, ONEROSTER_STATUS, SCORE_STATUS, ENV_VARS, HTTP_DEFAULTS, AUTH_DEFAULTS, CACHE_DEFAULTS, CONFIG_DEFAULTS, PLAYCADEMY_DEFAULTS, RESOURCE_DEFAULTS, HTTP_STATUS, ERROR_NAMES, init_constants4, exports_verify, init_verify, TimebackError, TimebackApiError, TimebackAuthenticationError, StudentNotFoundError, ConfigurationError, ResourceNotFoundError, SUBJECT_VALUES, GRADE_VALUES, TimebackAuthError, UUID_PATTERN, storage, EmailSchema, StudentSourcedIdSchema, StudentIdentifierSchema;
+}, __esm2 = (fn, res) => () => (fn && (res = fn(fn = 0)), res), TIMEBACK_API_URLS, QTI_API_URL = "https://qti.alpha-1edtech.ai/api", TIMEBACK_AUTH_URLS, CALIPER_API_URLS, ONEROSTER_ENDPOINTS, QTI_ENDPOINTS, CALIPER_ENDPOINTS, CALIPER_CONSTANTS, TIMEBACK_EVENT_TYPES, TIMEBACK_ACTIONS, TIMEBACK_TYPES, ACTIVITY_METRIC_TYPES, TIME_METRIC_TYPES, TIMEBACK_SUBJECTS, TIMEBACK_GRADE_LEVELS, TIMEBACK_GRADE_LEVEL_LABELS, CALIPER_SUBJECTS, ONEROSTER_STATUS, SCORE_STATUS, ENV_VARS, HTTP_DEFAULTS, AUTH_DEFAULTS, CACHE_DEFAULTS, CONFIG_DEFAULTS, PLAYCADEMY_DEFAULTS, RESOURCE_DEFAULTS, HTTP_STATUS, ERROR_NAMES, init_constants4, exports_verify, init_verify, TimebackError, TimebackApiError, TimebackAuthenticationError, StudentNotFoundError, ConfigurationError, ResourceNotFoundError, SUBJECT_VALUES, GRADE_VALUES, TimebackAuthError, UUID_PATTERN, storage, MASTERY_WRITE_CAPPED_WARNING_CODE = "MASTERY_WRITE_CAPPED", EmailSchema, StudentSourcedIdSchema, StudentIdentifierSchema;
 var init_dist2 = __esm(() => {
   init_src();
   init_src();
@@ -34502,8 +34611,8 @@ var init_schemas4 = __esm(() => {
       inactiveSeconds: exports_external.number().nonnegative().optional()
     }).optional(),
     xpEarned: exports_external.number(),
-    masteredUnits: exports_external.number().optional(),
-    masteredUnitsAbsolute: exports_external.number().int().nonnegative().optional(),
+    masteredUnits: exports_external.number().finite().optional(),
+    masteredUnitsAbsolute: exports_external.number().finite().int().optional(),
     extensions: exports_external.record(exports_external.string(), exports_external.unknown()).optional()
   }).refine((data) => !(data.masteredUnits !== undefined && data.masteredUnitsAbsolute !== undefined), {
     message: "Cannot provide both masteredUnits and masteredUnitsAbsolute",
@@ -38604,7 +38713,8 @@ var init_timeback_service = __esm(() => {
         masteredUnits: result.masteredUnitsApplied,
         pctCompleteApp: result.pctCompleteApp,
         scoreStatus: result.scoreStatus,
-        inProgress: result.inProgress
+        inProgress: result.inProgress,
+        ...result.warnings ? { warnings: result.warnings } : {}
       };
     }
     async resolveActiveGameCourse({
@@ -98355,7 +98465,7 @@ var init_timeback7 = __esm(() => {
         const seed3 = hashCode(`${e.grade}-${e.subject}`);
         const masterableUnits = 5 + seed3 % 16;
         const masteredUnits = seed3 % (masterableUnits + 1);
-        const pctComplete = masterableUnits > 0 ? Math.round(masteredUnits / masterableUnits * 1e4) / 100 : 0;
+        const pctComplete = masterableUnits > 0 ? Math.round(masteredUnits / masterableUnits * 100) : 0;
         return {
           grade: e.grade,
           subject: e.subject,

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@playcademy/sandbox",
-    "version": "0.5.1",
+    "version": "0.5.2-beta.1",
     "description": "Local development server for Playcademy game development",
     "type": "module",
     "exports": {