@playcademy/sandbox 0.3.16-beta.3 → 0.3.16-beta.4

package/dist/cli.js

@@ -1310,7 +1310,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@playcademy/sandbox",
-    version: "0.3.16-beta.3",
+    version: "0.3.16-beta.4",
     description: "Local development server for Playcademy game development",
     type: "module",
     exports: {
@@ -30207,16 +30207,7 @@ function mapAssessmentResultToRecentActivity(assessment, relevantCourseIds, cour
     return null;
   }
   if (isMasteryCompletionEntry(assessment)) {
-    const metadata3 = isRecord2(assessment.metadata) ? assessment.metadata : undefined;
-    const isResume = Boolean(metadata3?.resumedAt);
-    return {
-      id: assessment.sourcedId || `${assessment.assessmentLineItem.sourcedId}:${assessment.scoreDate}`,
-      kind: "admin-completion",
-      occurredAt: assessment.scoreDate,
-      courseId,
-      title: isResume ? "Course resumed" : "Course marked complete",
-      reason: metadata3?.adminAction ? "Admin action" : undefined
-    };
+    return null;
   }
   const metadata2 = isRecord2(assessment.metadata) ? assessment.metadata : undefined;
   const activityName = getStringValue(metadata2?.activityName);
@@ -30249,6 +30240,7 @@ function parseCaliperEventContext(event, relevantCourseIds) {
     courseId,
     occurredAt,
     eventKind: getStringValue(playcademy?.eventKind),
+    source: getStringValue(playcademy?.source),
     reason: getStringValue(playcademy?.reason),
     titleFromEvent: getStringValue(event.object.activity?.name),
     appName: getStringValue(event.object.app?.name),
@@ -30272,30 +30264,59 @@ function mapTimeSpentRemediation(event, ctx) {
   };
 }
 function mapActivityRemediation(event, ctx) {
-  let kind;
   if (ctx.eventKind === "remediation-xp") {
-    kind = "remediation-xp";
-  } else if (ctx.eventKind === "remediation-mastery") {
-    kind = "remediation-mastery";
-  } else {
-    return null;
+    return {
+      id: event.externalId,
+      kind: "remediation-xp",
+      occurredAt: ctx.occurredAt,
+      courseId: ctx.courseId,
+      title: "XP Adjustment",
+      activityId: ctx.activityId,
+      appName: ctx.appName,
+      reason: ctx.reason,
+      xpDelta: getGeneratedMetricValue(event, "xpEarned"),
+      masteredUnitsDelta: getGeneratedMetricValue(event, "masteredUnits")
+    };
   }
-  const titleMap = {
-    "remediation-xp": "XP Adjustment",
-    "remediation-mastery": "Mastery Adjustment"
-  };
-  return {
-    id: event.externalId,
-    kind,
-    occurredAt: ctx.occurredAt,
-    courseId: ctx.courseId,
-    title: titleMap[kind] || "Remediation Activity",
-    activityId: ctx.activityId,
-    appName: ctx.appName,
-    reason: ctx.reason,
-    xpDelta: getGeneratedMetricValue(event, "xpEarned"),
-    masteredUnitsDelta: getGeneratedMetricValue(event, "masteredUnits")
-  };
+  if (ctx.eventKind === "remediation-mastery") {
+    return {
+      id: event.externalId,
+      kind: "remediation-mastery",
+      occurredAt: ctx.occurredAt,
+      courseId: ctx.courseId,
+      title: "Mastery Adjustment",
+      activityId: ctx.activityId,
+      appName: ctx.appName,
+      reason: ctx.reason,
+      xpDelta: getGeneratedMetricValue(event, "xpEarned"),
+      masteredUnitsDelta: getGeneratedMetricValue(event, "masteredUnits")
+    };
+  }
+  if (ctx.eventKind === "course-completed") {
+    return {
+      id: event.externalId,
+      kind: "course-completed",
+      occurredAt: ctx.occurredAt,
+      courseId: ctx.courseId,
+      title: ctx.source === "admin" ? "Course marked complete" : "Course completed",
+      activityId: ctx.activityId,
+      appName: ctx.appName,
+      reason: ctx.reason
+    };
+  }
+  if (ctx.eventKind === "course-resumed") {
+    return {
+      id: event.externalId,
+      kind: "course-resumed",
+      occurredAt: ctx.occurredAt,
+      courseId: ctx.courseId,
+      title: "Course resumed",
+      activityId: ctx.activityId,
+      appName: ctx.appName,
+      reason: ctx.reason
+    };
+  }
+  return null;
 }
 function mapCaliperEventToRemediationActivity(event, relevantCourseIds) {
   const ctx = parseCaliperEventContext(event, relevantCourseIds);
@@ -30317,6 +30338,7 @@ var init_timeback_util = __esm(() => {
 // ../api-core/src/services/timeback-admin.service.ts
 class TimebackAdminService {
   deps;
+  static XP_PRECISION_FACTOR = 10;
   static RECENT_ACTIVITY_LIMIT = 20;
   static MAX_STUDENT_ACTIVITY_LIMIT = 200;
   static MAX_STUDENT_ACTIVITY_OFFSET = 1000;
@@ -30328,6 +30350,10 @@ class TimebackAdminService {
   constructor(deps) {
     this.deps = deps;
   }
+  static roundXpToTenths(value) {
+    const rounded = Math.round(value * TimebackAdminService.XP_PRECISION_FACTOR) / TimebackAdminService.XP_PRECISION_FACTOR;
+    return Object.is(rounded, -0) ? 0 : rounded;
+  }
   requireClient() {
     if (!this.deps.timeback) {
       logger16.error("Timeback client not available in context");
@@ -30335,6 +30361,17 @@ class TimebackAdminService {
     }
     return this.deps.timeback;
   }
+  async recordCourseCompletionHistory(client, data) {
+    await client.recordAdminCourseCompletionChange(data).catch((error) => {
+      logger16.error("Failed to record admin course completion history event", {
+        gameId: data.gameId,
+        courseId: data.courseId,
+        studentId: data.studentId,
+        action: data.action,
+        error: error instanceof Error ? error.message : String(error)
+      });
+    });
+  }
   async resolveAdminMutationContext(gameId, courseId, user, studentId) {
     const client = this.requireClient();
     await this.deps.validateDeveloperAccess(user, gameId);
@@ -30374,8 +30411,8 @@ class TimebackAdminService {
     }
     const today = formatDateYMD();
     const history = [];
-    let totalXp = 0;
-    let todayXp = 0;
+    let totalXpRaw = 0;
+    let todayXpRaw = 0;
     let activeTimeSeconds = 0;
     let masteredUnits = 0;
     for (const [date3, subjectFacts] of Object.entries(facts)) {
@@ -30392,15 +30429,16 @@ class TimebackAdminService {
           masteredUnitsForDay += masteredUnitsFromFact;
         }
       }
-      totalXp += xpForDay;
+      const roundedXpForDay = TimebackAdminService.roundXpToTenths(xpForDay);
+      totalXpRaw += xpForDay;
       activeTimeSeconds += activeSecondsForDay;
       masteredUnits += masteredUnitsForDay;
       if (date3 === today) {
-        todayXp += xpForDay;
+        todayXpRaw += xpForDay;
       }
       history.push({
         date: date3,
-        xpEarned: xpForDay,
+        xpEarned: roundedXpForDay,
         activeTimeSeconds: activeSecondsForDay,
         masteredUnits: masteredUnitsForDay
       });
@@ -30408,8 +30446,8 @@ class TimebackAdminService {
     history.sort((a, b) => a.date.localeCompare(b.date));
     return {
       analyticsAvailable: true,
-      totalXp,
-      todayXp,
+      totalXp: TimebackAdminService.roundXpToTenths(totalXpRaw),
+      todayXp: TimebackAdminService.roundXpToTenths(todayXpRaw),
       activeTimeSeconds,
       masteredUnits,
       history
@@ -30751,6 +30789,7 @@ class TimebackAdminService {
   }
   async toggleCourseCompletion(data, user) {
     const { client, sensorUrl, appName, actor } = await this.resolveAdminMutationContext(data.gameId, data.courseId, user, data.studentId);
+    const historyClient = client;
     const ids = deriveSourcedIds(data.courseId);
     const lineItemId = `${ids.course}-mastery-completion-assessment`;
     const resultId = `${lineItemId}:${data.studentId}:completion`;
@@ -30801,11 +30840,19 @@ class TimebackAdminService {
         inProgress: "false",
         metadata: {
           isMasteryCompletion: true,
-          completedAt: new Date().toISOString(),
           adminAction: true,
           appName
         }
       });
+      await this.recordCourseCompletionHistory(historyClient, {
+        gameId: data.gameId,
+        courseId: data.courseId,
+        studentId: data.studentId,
+        action: "complete",
+        actor,
+        appName,
+        sensorUrl
+      });
     } else {
       await client.oneroster.assessmentResults.upsert(resultId, {
         sourcedId: resultId,
@@ -30818,11 +30865,19 @@ class TimebackAdminService {
         inProgress: "true",
         metadata: {
           isMasteryCompletion: true,
-          resumedAt: new Date().toISOString(),
           adminAction: true,
           appName
         }
       });
+      await this.recordCourseCompletionHistory(historyClient, {
+        gameId: data.gameId,
+        courseId: data.courseId,
+        studentId: data.studentId,
+        action: "resume",
+        actor,
+        appName,
+        sensorUrl
+      });
     }
     return { status: "ok" };
   }
@@ -35089,7 +35144,8 @@ function buildAdminEventMetadata({
   return {
     playcademy: {
       eventKind,
-      reason
+      reason,
+      source: "admin"
     }
   };
 }
@@ -35205,6 +35261,30 @@ class AdminEventRecorder {
       eventExtensions: ctx.metadata
     });
   }
+  async recordCourseCompletionChange(data) {
+    const isResume = data.action === "resume";
+    const ctx = await this.prepareAdminEvent({
+      ...data,
+      defaultActivityId: isResume ? "playcademy-admin-course-resumed" : "playcademy-admin-course-completed",
+      reason: "Admin action",
+      eventKind: isResume ? "course-resumed" : "course-completed"
+    });
+    await this.caliper.emitActivityEvent({
+      studentId: ctx.student.id,
+      studentEmail: ctx.student.email,
+      activityId: ctx.activityId,
+      activityName: isResume ? "Course resumed" : "Course marked complete",
+      courseId: data.courseId,
+      courseName: ctx.courseContext.courseName,
+      subject: ctx.courseContext.subject,
+      appName: ctx.appName,
+      sensorUrl: ctx.sensorUrl,
+      process: false,
+      includeAttempt: false,
+      generatedExtensions: ctx.metadata,
+      eventExtensions: ctx.metadata
+    });
+  }
 }
 
 class TimebackCache {
@@ -35418,7 +35498,7 @@ class MasteryTracker {
     const totalMastered = historicalMasteredUnits + masteredUnits;
     const rawPct = totalMastered / masterableUnits * 100;
     const pctCompleteApp = Math.min(100, Math.max(0, Math.round(rawPct)));
-    const masteryAchieved = totalMastered >= masterableUnits;
+    const masteryAchieved = historicalMasteredUnits < masterableUnits && totalMastered >= masterableUnits;
     return { pctCompleteApp, masteryAchieved };
   }
   async createCompletionEntry(studentId, courseId, classId, appName) {
@@ -35444,7 +35524,6 @@ class MasteryTracker {
         inProgress: "false",
         metadata: {
           isMasteryCompletion: true,
-          completedAt: new Date().toISOString(),
           appName
         }
       });
@@ -35660,6 +35739,16 @@ class ProgressRecorder {
     }
     if (masteryAchieved) {
       await this.masteryTracker.createCompletionEntry(studentId, courseId, progressData.classId, progressData.appName);
+      await this.emitCourseCompletionHistoryEvent({
+        studentId,
+        studentEmail,
+        activityId,
+        courseId: ids.course,
+        courseName,
+        subject: progressData.subject,
+        appName: progressData.appName,
+        sensorUrl: progressData.sensorUrl
+      });
     }
     await this.emitCaliperEvent({
       studentId,
@@ -35834,6 +35923,38 @@ class ProgressRecorder {
       log.error("[ProgressRecorder] Failed to emit activity event", { error });
     });
   }
+  async emitCourseCompletionHistoryEvent(data) {
+    await this.caliperNamespace.emitActivityEvent({
+      studentId: data.studentId,
+      studentEmail: data.studentEmail,
+      activityId: data.activityId,
+      activityName: "Course completed",
+      courseId: data.courseId,
+      courseName: data.courseName,
+      subject: data.subject,
+      appName: data.appName,
+      sensorUrl: data.sensorUrl,
+      process: false,
+      includeAttempt: false,
+      eventExtensions: {
+        playcademy: {
+          eventKind: "course-completed",
+          source: "gameplay"
+        }
+      },
+      generatedExtensions: {
+        playcademy: {
+          eventKind: "course-completed",
+          source: "gameplay",
+          activityId: data.activityId
+        }
+      }
+    }).catch((error) => {
+      log.error("[ProgressRecorder] Failed to emit course completion history event", {
+        error
+      });
+    });
+  }
 }
 
 class SessionRecorder {
@@ -36228,6 +36349,10 @@ class TimebackClient {
     await this._ensureAuthenticated();
     return this.adminEventRecorder.recordMasteryAdjustment(data);
   }
+  async recordAdminCourseCompletionChange(data) {
+    await this._ensureAuthenticated();
+    return this.adminEventRecorder.recordCourseCompletionChange(data);
+  }
   clearCaches() {
     this.cacheManager.clearAll();
   }

package/dist/server.js

@@ -1309,7 +1309,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@playcademy/sandbox",
-    version: "0.3.16-beta.3",
+    version: "0.3.16-beta.4",
     description: "Local development server for Playcademy game development",
     type: "module",
     exports: {
@@ -30206,16 +30206,7 @@ function mapAssessmentResultToRecentActivity(assessment, relevantCourseIds, cour
     return null;
   }
   if (isMasteryCompletionEntry(assessment)) {
-    const metadata3 = isRecord2(assessment.metadata) ? assessment.metadata : undefined;
-    const isResume = Boolean(metadata3?.resumedAt);
-    return {
-      id: assessment.sourcedId || `${assessment.assessmentLineItem.sourcedId}:${assessment.scoreDate}`,
-      kind: "admin-completion",
-      occurredAt: assessment.scoreDate,
-      courseId,
-      title: isResume ? "Course resumed" : "Course marked complete",
-      reason: metadata3?.adminAction ? "Admin action" : undefined
-    };
+    return null;
   }
   const metadata2 = isRecord2(assessment.metadata) ? assessment.metadata : undefined;
   const activityName = getStringValue(metadata2?.activityName);
@@ -30248,6 +30239,7 @@ function parseCaliperEventContext(event, relevantCourseIds) {
     courseId,
     occurredAt,
     eventKind: getStringValue(playcademy?.eventKind),
+    source: getStringValue(playcademy?.source),
     reason: getStringValue(playcademy?.reason),
     titleFromEvent: getStringValue(event.object.activity?.name),
     appName: getStringValue(event.object.app?.name),
@@ -30271,30 +30263,59 @@ function mapTimeSpentRemediation(event, ctx) {
   };
 }
 function mapActivityRemediation(event, ctx) {
-  let kind;
   if (ctx.eventKind === "remediation-xp") {
-    kind = "remediation-xp";
-  } else if (ctx.eventKind === "remediation-mastery") {
-    kind = "remediation-mastery";
-  } else {
-    return null;
+    return {
+      id: event.externalId,
+      kind: "remediation-xp",
+      occurredAt: ctx.occurredAt,
+      courseId: ctx.courseId,
+      title: "XP Adjustment",
+      activityId: ctx.activityId,
+      appName: ctx.appName,
+      reason: ctx.reason,
+      xpDelta: getGeneratedMetricValue(event, "xpEarned"),
+      masteredUnitsDelta: getGeneratedMetricValue(event, "masteredUnits")
+    };
   }
-  const titleMap = {
-    "remediation-xp": "XP Adjustment",
-    "remediation-mastery": "Mastery Adjustment"
-  };
-  return {
-    id: event.externalId,
-    kind,
-    occurredAt: ctx.occurredAt,
-    courseId: ctx.courseId,
-    title: titleMap[kind] || "Remediation Activity",
-    activityId: ctx.activityId,
-    appName: ctx.appName,
-    reason: ctx.reason,
-    xpDelta: getGeneratedMetricValue(event, "xpEarned"),
-    masteredUnitsDelta: getGeneratedMetricValue(event, "masteredUnits")
-  };
+  if (ctx.eventKind === "remediation-mastery") {
+    return {
+      id: event.externalId,
+      kind: "remediation-mastery",
+      occurredAt: ctx.occurredAt,
+      courseId: ctx.courseId,
+      title: "Mastery Adjustment",
+      activityId: ctx.activityId,
+      appName: ctx.appName,
+      reason: ctx.reason,
+      xpDelta: getGeneratedMetricValue(event, "xpEarned"),
+      masteredUnitsDelta: getGeneratedMetricValue(event, "masteredUnits")
+    };
+  }
+  if (ctx.eventKind === "course-completed") {
+    return {
+      id: event.externalId,
+      kind: "course-completed",
+      occurredAt: ctx.occurredAt,
+      courseId: ctx.courseId,
+      title: ctx.source === "admin" ? "Course marked complete" : "Course completed",
+      activityId: ctx.activityId,
+      appName: ctx.appName,
+      reason: ctx.reason
+    };
+  }
+  if (ctx.eventKind === "course-resumed") {
+    return {
+      id: event.externalId,
+      kind: "course-resumed",
+      occurredAt: ctx.occurredAt,
+      courseId: ctx.courseId,
+      title: "Course resumed",
+      activityId: ctx.activityId,
+      appName: ctx.appName,
+      reason: ctx.reason
+    };
+  }
+  return null;
 }
 function mapCaliperEventToRemediationActivity(event, relevantCourseIds) {
   const ctx = parseCaliperEventContext(event, relevantCourseIds);
@@ -30316,6 +30337,7 @@ var init_timeback_util = __esm(() => {
 // ../api-core/src/services/timeback-admin.service.ts
 class TimebackAdminService {
   deps;
+  static XP_PRECISION_FACTOR = 10;
   static RECENT_ACTIVITY_LIMIT = 20;
   static MAX_STUDENT_ACTIVITY_LIMIT = 200;
   static MAX_STUDENT_ACTIVITY_OFFSET = 1000;
@@ -30327,6 +30349,10 @@ class TimebackAdminService {
   constructor(deps) {
     this.deps = deps;
   }
+  static roundXpToTenths(value) {
+    const rounded = Math.round(value * TimebackAdminService.XP_PRECISION_FACTOR) / TimebackAdminService.XP_PRECISION_FACTOR;
+    return Object.is(rounded, -0) ? 0 : rounded;
+  }
   requireClient() {
     if (!this.deps.timeback) {
       logger16.error("Timeback client not available in context");
@@ -30334,6 +30360,17 @@ class TimebackAdminService {
     }
     return this.deps.timeback;
   }
+  async recordCourseCompletionHistory(client, data) {
+    await client.recordAdminCourseCompletionChange(data).catch((error) => {
+      logger16.error("Failed to record admin course completion history event", {
+        gameId: data.gameId,
+        courseId: data.courseId,
+        studentId: data.studentId,
+        action: data.action,
+        error: error instanceof Error ? error.message : String(error)
+      });
+    });
+  }
   async resolveAdminMutationContext(gameId, courseId, user, studentId) {
     const client = this.requireClient();
     await this.deps.validateDeveloperAccess(user, gameId);
@@ -30373,8 +30410,8 @@ class TimebackAdminService {
     }
     const today = formatDateYMD();
     const history = [];
-    let totalXp = 0;
-    let todayXp = 0;
+    let totalXpRaw = 0;
+    let todayXpRaw = 0;
     let activeTimeSeconds = 0;
     let masteredUnits = 0;
     for (const [date3, subjectFacts] of Object.entries(facts)) {
@@ -30391,15 +30428,16 @@ class TimebackAdminService {
           masteredUnitsForDay += masteredUnitsFromFact;
         }
       }
-      totalXp += xpForDay;
+      const roundedXpForDay = TimebackAdminService.roundXpToTenths(xpForDay);
+      totalXpRaw += xpForDay;
       activeTimeSeconds += activeSecondsForDay;
       masteredUnits += masteredUnitsForDay;
       if (date3 === today) {
-        todayXp += xpForDay;
+        todayXpRaw += xpForDay;
       }
       history.push({
         date: date3,
-        xpEarned: xpForDay,
+        xpEarned: roundedXpForDay,
         activeTimeSeconds: activeSecondsForDay,
         masteredUnits: masteredUnitsForDay
       });
@@ -30407,8 +30445,8 @@ class TimebackAdminService {
     history.sort((a, b) => a.date.localeCompare(b.date));
     return {
       analyticsAvailable: true,
-      totalXp,
-      todayXp,
+      totalXp: TimebackAdminService.roundXpToTenths(totalXpRaw),
+      todayXp: TimebackAdminService.roundXpToTenths(todayXpRaw),
       activeTimeSeconds,
       masteredUnits,
       history
@@ -30750,6 +30788,7 @@ class TimebackAdminService {
   }
   async toggleCourseCompletion(data, user) {
     const { client, sensorUrl, appName, actor } = await this.resolveAdminMutationContext(data.gameId, data.courseId, user, data.studentId);
+    const historyClient = client;
     const ids = deriveSourcedIds(data.courseId);
     const lineItemId = `${ids.course}-mastery-completion-assessment`;
     const resultId = `${lineItemId}:${data.studentId}:completion`;
@@ -30800,11 +30839,19 @@ class TimebackAdminService {
         inProgress: "false",
         metadata: {
           isMasteryCompletion: true,
-          completedAt: new Date().toISOString(),
           adminAction: true,
           appName
         }
       });
+      await this.recordCourseCompletionHistory(historyClient, {
+        gameId: data.gameId,
+        courseId: data.courseId,
+        studentId: data.studentId,
+        action: "complete",
+        actor,
+        appName,
+        sensorUrl
+      });
     } else {
       await client.oneroster.assessmentResults.upsert(resultId, {
         sourcedId: resultId,
@@ -30817,11 +30864,19 @@ class TimebackAdminService {
         inProgress: "true",
         metadata: {
           isMasteryCompletion: true,
-          resumedAt: new Date().toISOString(),
           adminAction: true,
           appName
         }
       });
+      await this.recordCourseCompletionHistory(historyClient, {
+        gameId: data.gameId,
+        courseId: data.courseId,
+        studentId: data.studentId,
+        action: "resume",
+        actor,
+        appName,
+        sensorUrl
+      });
     }
     return { status: "ok" };
   }
@@ -35088,7 +35143,8 @@ function buildAdminEventMetadata({
   return {
     playcademy: {
       eventKind,
-      reason
+      reason,
+      source: "admin"
     }
   };
 }
@@ -35204,6 +35260,30 @@ class AdminEventRecorder {
       eventExtensions: ctx.metadata
     });
   }
+  async recordCourseCompletionChange(data) {
+    const isResume = data.action === "resume";
+    const ctx = await this.prepareAdminEvent({
+      ...data,
+      defaultActivityId: isResume ? "playcademy-admin-course-resumed" : "playcademy-admin-course-completed",
+      reason: "Admin action",
+      eventKind: isResume ? "course-resumed" : "course-completed"
+    });
+    await this.caliper.emitActivityEvent({
+      studentId: ctx.student.id,
+      studentEmail: ctx.student.email,
+      activityId: ctx.activityId,
+      activityName: isResume ? "Course resumed" : "Course marked complete",
+      courseId: data.courseId,
+      courseName: ctx.courseContext.courseName,
+      subject: ctx.courseContext.subject,
+      appName: ctx.appName,
+      sensorUrl: ctx.sensorUrl,
+      process: false,
+      includeAttempt: false,
+      generatedExtensions: ctx.metadata,
+      eventExtensions: ctx.metadata
+    });
+  }
 }
 
 class TimebackCache {
@@ -35417,7 +35497,7 @@ class MasteryTracker {
     const totalMastered = historicalMasteredUnits + masteredUnits;
     const rawPct = totalMastered / masterableUnits * 100;
     const pctCompleteApp = Math.min(100, Math.max(0, Math.round(rawPct)));
-    const masteryAchieved = totalMastered >= masterableUnits;
+    const masteryAchieved = historicalMasteredUnits < masterableUnits && totalMastered >= masterableUnits;
     return { pctCompleteApp, masteryAchieved };
   }
   async createCompletionEntry(studentId, courseId, classId, appName) {
@@ -35443,7 +35523,6 @@ class MasteryTracker {
         inProgress: "false",
         metadata: {
           isMasteryCompletion: true,
-          completedAt: new Date().toISOString(),
           appName
         }
       });
@@ -35659,6 +35738,16 @@ class ProgressRecorder {
     }
     if (masteryAchieved) {
       await this.masteryTracker.createCompletionEntry(studentId, courseId, progressData.classId, progressData.appName);
+      await this.emitCourseCompletionHistoryEvent({
+        studentId,
+        studentEmail,
+        activityId,
+        courseId: ids.course,
+        courseName,
+        subject: progressData.subject,
+        appName: progressData.appName,
+        sensorUrl: progressData.sensorUrl
+      });
     }
     await this.emitCaliperEvent({
       studentId,
@@ -35833,6 +35922,38 @@ class ProgressRecorder {
       log.error("[ProgressRecorder] Failed to emit activity event", { error });
     });
   }
+  async emitCourseCompletionHistoryEvent(data) {
+    await this.caliperNamespace.emitActivityEvent({
+      studentId: data.studentId,
+      studentEmail: data.studentEmail,
+      activityId: data.activityId,
+      activityName: "Course completed",
+      courseId: data.courseId,
+      courseName: data.courseName,
+      subject: data.subject,
+      appName: data.appName,
+      sensorUrl: data.sensorUrl,
+      process: false,
+      includeAttempt: false,
+      eventExtensions: {
+        playcademy: {
+          eventKind: "course-completed",
+          source: "gameplay"
+        }
+      },
+      generatedExtensions: {
+        playcademy: {
+          eventKind: "course-completed",
+          source: "gameplay",
+          activityId: data.activityId
+        }
+      }
+    }).catch((error) => {
+      log.error("[ProgressRecorder] Failed to emit course completion history event", {
+        error
+      });
+    });
+  }
 }
 
 class SessionRecorder {
@@ -36227,6 +36348,10 @@ class TimebackClient {
     await this._ensureAuthenticated();
     return this.adminEventRecorder.recordMasteryAdjustment(data);
   }
+  async recordAdminCourseCompletionChange(data) {
+    await this._ensureAuthenticated();
+    return this.adminEventRecorder.recordCourseCompletionChange(data);
+  }
   clearCaches() {
     this.cacheManager.clearAll();
   }

package/package.json

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