@mentra/engine 3.1.0-dev.28 → 3.1.0-dev.33

package/src/react/MentraLiveOtaFlow.tsx

@@ -1,6 +1,15 @@
 /* eslint-disable react-native/no-raw-text -- BodyText and PercentText are local Text wrappers. */
 import React, {useMemo} from "react"
-import {ActivityIndicator, Pressable, StyleSheet, Text, View, type StyleProp, type ViewStyle} from "react-native"
+import {
+  ActivityIndicator,
+  Pressable,
+  ScrollView,
+  StyleSheet,
+  Text,
+  View,
+  type StyleProp,
+  type ViewStyle,
+} from "react-native"
 import {SafeAreaView} from "react-native-safe-area-context"
 import Svg, {Path, Rect} from "react-native-svg"
 
@@ -224,6 +233,7 @@ function OtaFlowContent({
         icon="check"
         title={translate("ota:upToDate")}>
         <BodyText colors={colors}>{translate("ota:noUpdatesAvailable")}</BodyText>
+        <ChangelogList changelogs={state.changelogs} colors={colors} />
       </FlowPage>
     )
   }
@@ -279,10 +289,10 @@ function OtaFlowContent({
       state.hotspotPhase === "downloading"
         ? "Downloading update to phone..."
         : state.hotspotPhase === "starting_hotspot"
-          ? "Starting glasses hotspot..."
-          : state.hotspotPhase === "joining_hotspot"
-            ? "Connecting phone to glasses..."
-            : "Starting update..."
+        ? "Starting glasses hotspot..."
+        : state.hotspotPhase === "joining_hotspot"
+        ? "Connecting phone to glasses..."
+        : "Starting update..."
     return (
       <FlowPage colors={colors} icon="download" title={title}>
         {state.hotspotPhase === "downloading" && state.hotspotArtifactPercent !== null ? (
@@ -334,13 +344,13 @@ function OtaFlowContent({
     const title = state.versionChangeConverged
       ? translate("ota:versionChangeComplete")
       : state.versionChange
-        ? translate("ota:versionChangeFirmwarePassComplete")
-        : "Update complete!"
+      ? translate("ota:versionChangeFirmwarePassComplete")
+      : "Update complete!"
     const message = state.versionChangeConverged
       ? translate("ota:versionChangeCompleteMessage")
       : state.versionChange
-        ? translate("ota:versionChangeFirmwarePassCompleteMessage")
-        : "Your glasses are up to date."
+      ? translate("ota:versionChangeFirmwarePassCompleteMessage")
+      : "Your glasses are up to date."
     return (
       <FlowPage
         actions={
@@ -354,6 +364,7 @@ function OtaFlowContent({
         icon="check"
         title={title}>
         <BodyText colors={colors}>{message}</BodyText>
+        <ChangelogList changelogs={state.changelogs} colors={colors} />
       </FlowPage>
     )
   }
@@ -426,6 +437,30 @@ function PercentText({colors, percent}: {colors: MentraLiveOtaFlowTheme; percent
   return <Text style={[styles.percent, {color: colors.primary}]}>{Math.round(percent)}%</Text>
 }
 
+function ChangelogList({
+  changelogs,
+  colors,
+}: {
+  changelogs: MentraLiveOtaController["state"]["changelogs"]
+  colors: MentraLiveOtaFlowTheme
+}) {
+  if (changelogs.length === 0) return null
+  return (
+    <ScrollView contentContainerStyle={styles.changelogContent} style={styles.changelogList}>
+      {changelogs.map((entry) => (
+        <View key={entry.version} style={styles.changelogEntry}>
+          <Text selectable style={[styles.changelogVersion, {color: colors.foreground}]}>
+            {entry.version}
+          </Text>
+          <Text selectable style={[styles.changelogMarkdown, {color: colors.textDim}]}>
+            {entry.markdown}
+          </Text>
+        </View>
+      ))}
+    </ScrollView>
+  )
+}
+
 function FlowButton({
   colors,
   disabled = false,
@@ -494,6 +529,11 @@ const styles = StyleSheet.create({
   percent: {fontSize: 30, fontVariant: ["tabular-nums"], fontWeight: "700"},
   progressTrack: {borderRadius: 4, height: 8, maxWidth: 420, overflow: "hidden", width: "100%"},
   progressFill: {borderRadius: 4, height: 8},
+  changelogList: {flexShrink: 1, maxHeight: 260, maxWidth: 420, width: "100%"},
+  changelogContent: {gap: 18, paddingVertical: 4},
+  changelogEntry: {gap: 8},
+  changelogVersion: {fontSize: 16, fontWeight: "600"},
+  changelogMarkdown: {fontSize: 14, lineHeight: 20},
   button: {
     alignItems: "center",
     borderRadius: 50,

package/src/react/useMentraLiveOta.ts

@@ -6,6 +6,7 @@ import {
   clearOtaAutoChainReconnectWait,
   isOtaAutoChainActive,
   otaAutoChainFingerprint,
+  otaAutoChainReleaseRange,
   otaAutoChainReconnectWaitRemaining,
   stopOtaAutoChain,
   tryAdvanceOtaAutoChain,
@@ -18,6 +19,7 @@ import {
 } from "../services/OtaErrorMapping"
 import type {OtaInstallSnapshot} from "../services/OtaInstallCoordinator"
 import type {OtaCheckCurrentGlassesResult} from "../services/OtaUpdateCheckService"
+import type {ReleaseChangelog} from "../facades/ota"
 import {useEngineSnapshot} from "./useEngineSnapshot"
 
 export type MentraLiveOtaFlowPage = "check" | "progress"
@@ -84,6 +86,8 @@ export type MentraLiveOtaState = {
   canDiscard: boolean
   canOpenWifiSetup: boolean
   continueDisabled: boolean
+  /** Release notes crossed by this update, newest first. Populated on completion. */
+  changelogs: ReleaseChangelog[]
 }
 
 export type UseMentraLiveOtaOptions = {
@@ -115,16 +119,34 @@ type CheckState = "checking" | "update_available" | "no_update" | "dev_build" |
 const AUTO_CHAIN_NETWORK_RETRY_DELAY_MS = 5000
 const AUTO_CHAIN_COMPLETE_DELAY_MS = 750
 
+function targetVersion(result: OtaCheckCurrentGlassesResult): string | null {
+  return result.updateInfo?.versionName ?? result.latestVersionInfo?.versionName ?? null
+}
+
+function releaseChangelogsForActiveChain(): ReleaseChangelog[] {
+  const range = otaAutoChainReleaseRange()
+  if (!range?.toVersion) return []
+  try {
+    return ota.getReleaseChangelogs(range.fromVersion, range.toVersion)
+  } catch {
+    try {
+      return ota.getReleaseChangelogs(null, range.toVersion)
+    } catch {
+      return []
+    }
+  }
+}
+
 function installProgress(snapshot: OtaInstallSnapshot): number | null {
   if (snapshot.displayState !== "updating") return null
   const {otaStatus} = snapshot
   const isDownload = otaStatus?.phase === "download"
   const totalSteps = otaStatus?.totalSteps ?? 1
   const rawPercent = isDownload
-    ? (otaStatus?.stepPercent ?? 0)
+    ? otaStatus?.stepPercent ?? 0
     : totalSteps >= 2
-      ? (otaStatus?.overallPercent ?? 0)
-      : (otaStatus?.stepPercent ?? 0)
+    ? otaStatus?.overallPercent ?? 0
+    : otaStatus?.stepPercent ?? 0
   return Math.min(Math.max(rawPercent, snapshot.mtkInstallStallSimulatedPercent ?? 0, 0), 100)
 }
 
@@ -169,6 +191,7 @@ export function useMentraLiveOta(options: UseMentraLiveOtaOptions = {}): MentraL
   const [isVersionChange, setIsVersionChange] = useState(false)
   const [errorKind, setErrorKind] = useState<"network" | "pin_unavailable">("network")
   const [updateFingerprint, setUpdateFingerprint] = useState<string | null>(null)
+  const [completedChangelogs, setCompletedChangelogs] = useState<ReleaseChangelog[]>([])
   const [checkGeneration, setCheckGeneration] = useState(0)
   const performCheckGenerationRef = useRef(0)
   const activeCheckKeyRef = useRef<string | null>(null)
@@ -319,7 +342,11 @@ export function useMentraLiveOta(options: UseMentraLiveOtaOptions = {}): MentraL
             if (!snapshot.wifiConnected && snapshot.hotspotOtaVersion !== 1) {
               stopOtaAutoChain()
             } else {
-              const admission = tryAdvanceOtaAutoChain(fingerprint, result.updateInfo.isDowngrade === true)
+              const admission = tryAdvanceOtaAutoChain(
+                fingerprint,
+                result.updateInfo.isDowngrade === true,
+                targetVersion(result),
+              )
               if (admission.advance) {
                 checkCompletedRef.current = true
                 ota.installSession.prepare(result)
@@ -332,6 +359,7 @@ export function useMentraLiveOta(options: UseMentraLiveOtaOptions = {}): MentraL
           setCheckState("update_available")
           return
         }
+        if (isOtaAutoChainActive()) setCompletedChangelogs(releaseChangelogsForActiveChain())
         stopOtaAutoChain()
         checkCompletedRef.current = true
         ota.clearUpdateAvailable()
@@ -397,6 +425,7 @@ export function useMentraLiveOta(options: UseMentraLiveOtaOptions = {}): MentraL
   }, [installSnapshot.connected, installSnapshot.displayState, page, returnToCheck])
 
   const check = useCallback(() => {
+    setCompletedChangelogs([])
     setPage("check")
     setCheckState("checking")
     setCheckGeneration((generation) => generation + 1)
@@ -420,7 +449,13 @@ export function useMentraLiveOta(options: UseMentraLiveOtaOptions = {}): MentraL
       return
     }
     ota.installSession.prepare(result)
-    if (updateFingerprint) beginOtaAutoChain(updateFingerprint, isVersionChange)
+    setCompletedChangelogs([])
+    if (updateFingerprint) {
+      beginOtaAutoChain(updateFingerprint, isVersionChange, {
+        fromVersion: snapshot.appVersion,
+        toVersion: targetVersion(result),
+      })
+    }
     navigateToProgress()
   }, [check, isVersionChange, navigateToProgress, page, updateFingerprint])
 
@@ -490,6 +525,7 @@ export function useMentraLiveOta(options: UseMentraLiveOtaOptions = {}): MentraL
         canDiscard: false,
         canOpenWifiSetup: false,
         continueDisabled: false,
+        changelogs: [],
       }
     }
 
@@ -499,22 +535,22 @@ export function useMentraLiveOta(options: UseMentraLiveOtaOptions = {}): MentraL
         checkState === "checking"
           ? "checking"
           : checkState === "update_available"
-            ? wifiRequired
-              ? "wifi_required"
-              : "update_available"
-            : checkState === "no_update"
-              ? "up_to_date"
-              : checkState === "dev_build"
-                ? "dev_build"
-                : errorKind === "pin_unavailable"
-                  ? "update_info_unavailable"
-                  : "check_failed"
+          ? wifiRequired
+            ? "wifi_required"
+            : "update_available"
+          : checkState === "no_update"
+          ? "up_to_date"
+          : checkState === "dev_build"
+          ? "dev_build"
+          : errorKind === "pin_unavailable"
+          ? "update_info_unavailable"
+          : "check_failed"
       const error: MentraLiveOtaError | null =
         screen === "check_failed"
           ? {code: "check_failed", message: "Couldn't check for updates. Please check your connection and try again."}
           : screen === "update_info_unavailable"
-            ? {code: "update_info_unavailable", message: "Update information for this app version is unavailable."}
-            : null
+          ? {code: "update_info_unavailable", message: "Update information for this app version is unavailable."}
+          : null
       return {
         screen,
         connected: otaSnapshot.connected,
@@ -543,6 +579,7 @@ export function useMentraLiveOta(options: UseMentraLiveOtaOptions = {}): MentraL
         canDiscard: false,
         canOpenWifiSetup: screen === "wifi_required",
         continueDisabled: false,
+        changelogs: screen === "up_to_date" ? completedChangelogs : [],
       }
     }
 
@@ -568,6 +605,7 @@ export function useMentraLiveOta(options: UseMentraLiveOtaOptions = {}): MentraL
           }
         : null
     const totalSteps = installSnapshot.otaStatus?.totalSteps ?? null
+    const changelogs = screen === "complete" ? releaseChangelogsForActiveChain() : []
     return {
       screen,
       connected: installSnapshot.connected,
@@ -599,9 +637,11 @@ export function useMentraLiveOta(options: UseMentraLiveOtaOptions = {}): MentraL
       canDiscard: screen === "disconnected",
       canOpenWifiSetup: screen === "failed" && showChangeWifi,
       continueDisabled: installSnapshot.continueButtonDisabled,
+      changelogs,
     }
   }, [
     checkState,
+    completedChangelogs,
     errorKind,
     firmwareRestarting,
     installSnapshot,

package/src/services/OtaAutoChain.ts

@@ -6,10 +6,16 @@ export const OTA_AUTO_CHAIN_RECONNECT_TIMEOUT_MS = 120_000
 type OtaAutoChainSession = {
   approvedDowngrade: boolean
   passCount: number
+  releaseRange: OtaAutoChainReleaseRange
   reconnectDeadline: number | null
   seenFingerprints: Set<string>
 }
 
+export type OtaAutoChainReleaseRange = {
+  fromVersion: string | null
+  toVersion: string | null
+}
+
 export type OtaAutoChainAdvanceResult =
   | {advance: true; passCount: number}
   | {advance: false; reason: "inactive" | "duplicate" | "max_passes" | "downgrade_not_approved"}
@@ -42,10 +48,15 @@ export function otaAutoChainFingerprint(result: OtaCheckCurrentGlassesResult): s
 }
 
 /** Start a chain after the user explicitly approves its first update pass. */
-export function beginOtaAutoChain(initialFingerprint: string, approvedDowngrade: boolean): void {
+export function beginOtaAutoChain(
+  initialFingerprint: string,
+  approvedDowngrade: boolean,
+  releaseRange: OtaAutoChainReleaseRange,
+): void {
   session = {
     approvedDowngrade,
     passCount: 1,
+    releaseRange: {...releaseRange},
     reconnectDeadline: null,
     seenFingerprints: new Set([initialFingerprint]),
   }
@@ -55,6 +66,10 @@ export function isOtaAutoChainActive(): boolean {
   return session !== null
 }
 
+export function otaAutoChainReleaseRange(): OtaAutoChainReleaseRange | null {
+  return session ? {...session.releaseRange} : null
+}
+
 /** End the current chain. Safe to call when no chain is active. */
 export function stopOtaAutoChain(): void {
   session = null
@@ -80,7 +95,11 @@ export function clearOtaAutoChainReconnectWait(): void {
  * Admit the next pass of an active chain. Repeated offers, unexpectedly
  * destructive downgrades, and runaway chains fail closed and end automation.
  */
-export function tryAdvanceOtaAutoChain(fingerprint: string, isDowngrade: boolean): OtaAutoChainAdvanceResult {
+export function tryAdvanceOtaAutoChain(
+  fingerprint: string,
+  isDowngrade: boolean,
+  targetVersion: string | null,
+): OtaAutoChainAdvanceResult {
   if (!session) {
     return {advance: false, reason: "inactive"}
   }
@@ -102,5 +121,6 @@ export function tryAdvanceOtaAutoChain(fingerprint: string, isDowngrade: boolean
 
   session.seenFingerprints.add(fingerprint)
   session.passCount += 1
+  if (targetVersion) session.releaseRange.toVersion = targetVersion
   return {advance: true, passCount: session.passCount}
 }