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

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.5",
     description: "Local development server for Playcademy game development",
     type: "module",
     exports: {
@@ -26650,9 +26650,37 @@ var init_developer_service = __esm(() => {
 // ../api-core/src/services/game.service.ts
 class GameService {
   deps;
+  static MANIFEST_FETCH_TIMEOUT_MS = 5000;
+  static MAX_FETCH_ERROR_MESSAGE_LENGTH = 512;
   constructor(deps) {
     this.deps = deps;
   }
+  static getManifestHost(manifestUrl) {
+    try {
+      return new URL(manifestUrl).host;
+    } catch {
+      return manifestUrl;
+    }
+  }
+  static getFetchErrorMessage(error) {
+    let raw;
+    if (error instanceof Error) {
+      raw = error.message;
+    } else if (typeof error === "string") {
+      raw = error;
+    }
+    if (!raw) {
+      return;
+    }
+    const normalized = raw.replace(/\s+/g, " ").trim();
+    if (!normalized) {
+      return;
+    }
+    return normalized.slice(0, GameService.MAX_FETCH_ERROR_MESSAGE_LENGTH);
+  }
+  static isRetryableStatus(status) {
+    return status === 429 || status >= 500;
+  }
   async list(caller) {
     const db2 = this.deps.db;
     const isAdmin = caller?.role === "admin";
@@ -26714,6 +26742,109 @@ class GameService {
     this.enforceVisibility(game, caller, slug);
     return game;
   }
+  async getManifest(gameId, caller) {
+    const game = await this.getById(gameId, caller);
+    if (game.gameType !== "hosted" || !game.deploymentUrl) {
+      throw new BadRequestError("Game does not have a deployment manifest");
+    }
+    const deploymentUrl = game.deploymentUrl;
+    const manifestUrl = `${deploymentUrl.replace(/\/$/, "")}/playcademy.manifest.json`;
+    const manifestHost = GameService.getManifestHost(manifestUrl);
+    const startedAt = Date.now();
+    const controller = new AbortController;
+    const timeout = setTimeout(() => controller.abort(), GameService.MANIFEST_FETCH_TIMEOUT_MS);
+    function buildDetails(fetchOutcome, manifestErrorKind, extra = {}) {
+      return {
+        manifestUrl,
+        manifestHost,
+        deploymentUrl,
+        fetchOutcome,
+        retryCount: 0,
+        durationMs: Date.now() - startedAt,
+        manifestErrorKind,
+        ...extra
+      };
+    }
+    let response;
+    try {
+      response = await fetch(manifestUrl, {
+        method: "GET",
+        headers: {
+          Accept: "application/json"
+        },
+        signal: controller.signal
+      });
+    } catch (error) {
+      clearTimeout(timeout);
+      const fetchErrorMessage = GameService.getFetchErrorMessage(error);
+      const details = buildDetails("network_error", "temporary", fetchErrorMessage ? { fetchErrorMessage } : {});
+      logger5.error("Failed to fetch game manifest", {
+        gameId,
+        manifestUrl,
+        error,
+        details
+      });
+      if (error instanceof Error && error.name === "AbortError") {
+        throw new TimeoutError("Timed out loading game manifest", details);
+      }
+      throw new ServiceUnavailableError("Failed to load game manifest", details);
+    } finally {
+      clearTimeout(timeout);
+    }
+    if (!response.ok) {
+      const resolvedManifestUrl = response.url || manifestUrl;
+      const resolvedManifestHost = GameService.getManifestHost(resolvedManifestUrl);
+      const manifestErrorKind = GameService.isRetryableStatus(response.status) ? "temporary" : "permanent";
+      const details = buildDetails("bad_status", manifestErrorKind, {
+        manifestUrl: resolvedManifestUrl,
+        manifestHost: resolvedManifestHost,
+        status: response.status,
+        contentType: response.headers.get("content-type") ?? undefined,
+        cfRay: response.headers.get("cf-ray") ?? undefined,
+        redirected: response.redirected,
+        ...response.redirected ? {
+          originalManifestUrl: manifestUrl,
+          originalManifestHost: manifestHost
+        } : {}
+      });
+      const message = `Failed to fetch manifest: ${response.status} ${response.statusText}`;
+      logger5.error("Game manifest returned non-ok response", {
+        gameId,
+        manifestUrl,
+        status: response.status,
+        details
+      });
+      if (manifestErrorKind === "temporary") {
+        throw new ServiceUnavailableError(message, details);
+      }
+      throw new BadRequestError(message, details);
+    }
+    try {
+      return await response.json();
+    } catch (error) {
+      const resolvedManifestUrl = response.url || manifestUrl;
+      const resolvedManifestHost = GameService.getManifestHost(resolvedManifestUrl);
+      const details = buildDetails("invalid_body", "permanent", {
+        manifestUrl: resolvedManifestUrl,
+        manifestHost: resolvedManifestHost,
+        status: response.status,
+        contentType: response.headers.get("content-type") ?? undefined,
+        cfRay: response.headers.get("cf-ray") ?? undefined,
+        redirected: response.redirected,
+        ...response.redirected ? {
+          originalManifestUrl: manifestUrl,
+          originalManifestHost: manifestHost
+        } : {}
+      });
+      logger5.error("Failed to parse game manifest", {
+        gameId,
+        manifestUrl,
+        error,
+        details
+      });
+      throw new BadRequestError("Failed to parse game manifest", details);
+    }
+  }
   enforceVisibility(game, caller, lookupIdentifier) {
     if (game.visibility !== "internal") {
       return;
@@ -30207,16 +30338,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 +30371,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 +30395,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 +30469,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 +30481,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 +30492,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 +30542,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 +30560,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 +30577,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 +30920,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 +30971,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 +30996,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 +35275,8 @@ function buildAdminEventMetadata({
   return {
     playcademy: {
       eventKind,
-      reason
+      reason,
+      source: "admin"
     }
   };
 }
@@ -35205,6 +35392,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 +35629,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 +35655,6 @@ class MasteryTracker {
         inProgress: "false",
         metadata: {
           isMasteryCompletion: true,
-          completedAt: new Date().toISOString(),
           appName
         }
       });
@@ -35660,6 +35870,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 +36054,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 +36480,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();
   }
@@ -94053,7 +94309,7 @@ var init_domain_controller = __esm(() => {
 });
 
 // ../api-core/src/controllers/game.controller.ts
-var logger46, list3, listManageable, getSubjects, getById2, getBySlug, upsertBySlug, remove3, games2;
+var logger46, list3, listManageable, getSubjects, getById2, getBySlug, getManifest, upsertBySlug, remove3, games2;
 var init_game_controller = __esm(() => {
   init_esm();
   init_schemas_index();
@@ -94093,6 +94349,21 @@ var init_game_controller = __esm(() => {
     logger46.debug("Getting game by slug", { userId: ctx.user.id, slug: slug2, launchId: ctx.launchId });
     return ctx.services.game.getBySlug(slug2, ctx.user);
   });
+  getManifest = requireAuth(async (ctx) => {
+    const gameId = ctx.params.gameId;
+    if (!gameId) {
+      throw ApiError.badRequest("Missing game ID");
+    }
+    if (!isValidUUID(gameId)) {
+      throw ApiError.unprocessableEntity("gameId must be a valid UUID format");
+    }
+    logger46.debug("Getting game manifest by ID", {
+      userId: ctx.user.id,
+      gameId,
+      launchId: ctx.launchId
+    });
+    return ctx.services.game.getManifest(gameId, ctx.user);
+  });
   upsertBySlug = requireAuth(async (ctx) => {
     const slug2 = ctx.params.slug;
     if (!slug2) {
@@ -94129,6 +94400,7 @@ var init_game_controller = __esm(() => {
     listManageable,
     getSubjects,
     getById: getById2,
+    getManifest,
     getBySlug,
     upsertBySlug,
     remove: remove3
@@ -95956,7 +96228,8 @@ var init_crud = __esm(() => {
   init_api();
   gameCrudRouter = new Hono2;
   gameCrudRouter.get("/", handle2(games2.list));
-  gameCrudRouter.get("/:gameId{[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}}", handle2(games2.getById));
+  gameCrudRouter.get("/:gameId{[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}}/manifest", handle2(games2.getManifest));
+  gameCrudRouter.get("/:gameId{[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}}", handle2(games2.getById));
   gameCrudRouter.get("/:slug", handle2(games2.getBySlug));
   gameCrudRouter.put("/:slug", handle2(games2.upsertBySlug));
   gameCrudRouter.delete("/:gameId", handle2(games2.remove, { status: 204 }));

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.5",
     description: "Local development server for Playcademy game development",
     type: "module",
     exports: {
@@ -26649,9 +26649,37 @@ var init_developer_service = __esm(() => {
 // ../api-core/src/services/game.service.ts
 class GameService {
   deps;
+  static MANIFEST_FETCH_TIMEOUT_MS = 5000;
+  static MAX_FETCH_ERROR_MESSAGE_LENGTH = 512;
   constructor(deps) {
     this.deps = deps;
   }
+  static getManifestHost(manifestUrl) {
+    try {
+      return new URL(manifestUrl).host;
+    } catch {
+      return manifestUrl;
+    }
+  }
+  static getFetchErrorMessage(error) {
+    let raw;
+    if (error instanceof Error) {
+      raw = error.message;
+    } else if (typeof error === "string") {
+      raw = error;
+    }
+    if (!raw) {
+      return;
+    }
+    const normalized = raw.replace(/\s+/g, " ").trim();
+    if (!normalized) {
+      return;
+    }
+    return normalized.slice(0, GameService.MAX_FETCH_ERROR_MESSAGE_LENGTH);
+  }
+  static isRetryableStatus(status) {
+    return status === 429 || status >= 500;
+  }
   async list(caller) {
     const db2 = this.deps.db;
     const isAdmin = caller?.role === "admin";
@@ -26713,6 +26741,109 @@ class GameService {
     this.enforceVisibility(game, caller, slug);
     return game;
   }
+  async getManifest(gameId, caller) {
+    const game = await this.getById(gameId, caller);
+    if (game.gameType !== "hosted" || !game.deploymentUrl) {
+      throw new BadRequestError("Game does not have a deployment manifest");
+    }
+    const deploymentUrl = game.deploymentUrl;
+    const manifestUrl = `${deploymentUrl.replace(/\/$/, "")}/playcademy.manifest.json`;
+    const manifestHost = GameService.getManifestHost(manifestUrl);
+    const startedAt = Date.now();
+    const controller = new AbortController;
+    const timeout = setTimeout(() => controller.abort(), GameService.MANIFEST_FETCH_TIMEOUT_MS);
+    function buildDetails(fetchOutcome, manifestErrorKind, extra = {}) {
+      return {
+        manifestUrl,
+        manifestHost,
+        deploymentUrl,
+        fetchOutcome,
+        retryCount: 0,
+        durationMs: Date.now() - startedAt,
+        manifestErrorKind,
+        ...extra
+      };
+    }
+    let response;
+    try {
+      response = await fetch(manifestUrl, {
+        method: "GET",
+        headers: {
+          Accept: "application/json"
+        },
+        signal: controller.signal
+      });
+    } catch (error) {
+      clearTimeout(timeout);
+      const fetchErrorMessage = GameService.getFetchErrorMessage(error);
+      const details = buildDetails("network_error", "temporary", fetchErrorMessage ? { fetchErrorMessage } : {});
+      logger5.error("Failed to fetch game manifest", {
+        gameId,
+        manifestUrl,
+        error,
+        details
+      });
+      if (error instanceof Error && error.name === "AbortError") {
+        throw new TimeoutError("Timed out loading game manifest", details);
+      }
+      throw new ServiceUnavailableError("Failed to load game manifest", details);
+    } finally {
+      clearTimeout(timeout);
+    }
+    if (!response.ok) {
+      const resolvedManifestUrl = response.url || manifestUrl;
+      const resolvedManifestHost = GameService.getManifestHost(resolvedManifestUrl);
+      const manifestErrorKind = GameService.isRetryableStatus(response.status) ? "temporary" : "permanent";
+      const details = buildDetails("bad_status", manifestErrorKind, {
+        manifestUrl: resolvedManifestUrl,
+        manifestHost: resolvedManifestHost,
+        status: response.status,
+        contentType: response.headers.get("content-type") ?? undefined,
+        cfRay: response.headers.get("cf-ray") ?? undefined,
+        redirected: response.redirected,
+        ...response.redirected ? {
+          originalManifestUrl: manifestUrl,
+          originalManifestHost: manifestHost
+        } : {}
+      });
+      const message = `Failed to fetch manifest: ${response.status} ${response.statusText}`;
+      logger5.error("Game manifest returned non-ok response", {
+        gameId,
+        manifestUrl,
+        status: response.status,
+        details
+      });
+      if (manifestErrorKind === "temporary") {
+        throw new ServiceUnavailableError(message, details);
+      }
+      throw new BadRequestError(message, details);
+    }
+    try {
+      return await response.json();
+    } catch (error) {
+      const resolvedManifestUrl = response.url || manifestUrl;
+      const resolvedManifestHost = GameService.getManifestHost(resolvedManifestUrl);
+      const details = buildDetails("invalid_body", "permanent", {
+        manifestUrl: resolvedManifestUrl,
+        manifestHost: resolvedManifestHost,
+        status: response.status,
+        contentType: response.headers.get("content-type") ?? undefined,
+        cfRay: response.headers.get("cf-ray") ?? undefined,
+        redirected: response.redirected,
+        ...response.redirected ? {
+          originalManifestUrl: manifestUrl,
+          originalManifestHost: manifestHost
+        } : {}
+      });
+      logger5.error("Failed to parse game manifest", {
+        gameId,
+        manifestUrl,
+        error,
+        details
+      });
+      throw new BadRequestError("Failed to parse game manifest", details);
+    }
+  }
   enforceVisibility(game, caller, lookupIdentifier) {
     if (game.visibility !== "internal") {
       return;
@@ -30206,16 +30337,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 +30370,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 +30394,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 +30468,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 +30480,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 +30491,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 +30541,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 +30559,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 +30576,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 +30919,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 +30970,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 +30995,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 +35274,8 @@ function buildAdminEventMetadata({
   return {
     playcademy: {
       eventKind,
-      reason
+      reason,
+      source: "admin"
     }
   };
 }
@@ -35204,6 +35391,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 +35628,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 +35654,6 @@ class MasteryTracker {
         inProgress: "false",
         metadata: {
           isMasteryCompletion: true,
-          completedAt: new Date().toISOString(),
           appName
         }
       });
@@ -35659,6 +35869,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 +36053,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 +36479,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();
   }
@@ -94052,7 +94308,7 @@ var init_domain_controller = __esm(() => {
 });
 
 // ../api-core/src/controllers/game.controller.ts
-var logger46, list3, listManageable, getSubjects, getById2, getBySlug, upsertBySlug, remove3, games2;
+var logger46, list3, listManageable, getSubjects, getById2, getBySlug, getManifest, upsertBySlug, remove3, games2;
 var init_game_controller = __esm(() => {
   init_esm();
   init_schemas_index();
@@ -94092,6 +94348,21 @@ var init_game_controller = __esm(() => {
     logger46.debug("Getting game by slug", { userId: ctx.user.id, slug: slug2, launchId: ctx.launchId });
     return ctx.services.game.getBySlug(slug2, ctx.user);
   });
+  getManifest = requireAuth(async (ctx) => {
+    const gameId = ctx.params.gameId;
+    if (!gameId) {
+      throw ApiError.badRequest("Missing game ID");
+    }
+    if (!isValidUUID(gameId)) {
+      throw ApiError.unprocessableEntity("gameId must be a valid UUID format");
+    }
+    logger46.debug("Getting game manifest by ID", {
+      userId: ctx.user.id,
+      gameId,
+      launchId: ctx.launchId
+    });
+    return ctx.services.game.getManifest(gameId, ctx.user);
+  });
   upsertBySlug = requireAuth(async (ctx) => {
     const slug2 = ctx.params.slug;
     if (!slug2) {
@@ -94128,6 +94399,7 @@ var init_game_controller = __esm(() => {
     listManageable,
     getSubjects,
     getById: getById2,
+    getManifest,
     getBySlug,
     upsertBySlug,
     remove: remove3
@@ -95955,7 +96227,8 @@ var init_crud = __esm(() => {
   init_api();
   gameCrudRouter = new Hono2;
   gameCrudRouter.get("/", handle2(games2.list));
-  gameCrudRouter.get("/:gameId{[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}}", handle2(games2.getById));
+  gameCrudRouter.get("/:gameId{[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}}/manifest", handle2(games2.getManifest));
+  gameCrudRouter.get("/:gameId{[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}}", handle2(games2.getById));
   gameCrudRouter.get("/:slug", handle2(games2.getBySlug));
   gameCrudRouter.put("/:slug", handle2(games2.upsertBySlug));
   gameCrudRouter.delete("/:gameId", handle2(games2.remove, { status: 204 }));

package/package.json

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