feat: SDK cloud save bridge with Ludusavi + launch-time prompt

Adds per-container support for "Pattern B" SDK-cloud games (Dead
Cells-style) that read saves from a subdirectory of their install
directory rather than from <userdata>/<appid>/remote/. Replaces the
hardcoded one-entry registry with the Ludusavi save-path manifest
(~1944 Steam games matching Pattern B).

Container setting:
 - New sdkCloudSaveSubdir field on Container/ContainerData, persisted
   through JSON and Compose Saver. Empty = bridge disabled.
 - "Cloud Save Bridge" section in GeneralTab (visible when Launch
   Steam Client is on) with text field + Use Recommended / Detect /
   Clear buttons, confirmation dialog on first activation, and
   validation rejecting path separators, .., and drive letters.

Ludusavi integration (utils/LudusaviRegistry.kt):
 - Fetches manifest.yaml from mtkennerly/ludusavi-manifest via the
   existing OkHttp client. Streaming line-parser avoids the OOM that
   SnakeYAML's eager map load caused on the 5 MB file.
 - Filters to Steam-IDed entries with <base>/<subdir> save paths
   tagged "save" and applicable to Windows (or no OS filter).
 - Writes ~190 KB filtered JSON to filesDir/ludusavi_pattern_b.json,
   7-day TTL, falls back to stale disk cache on fetch failure.
 - Primed in background at PluviaApp.onCreate so Use Recommended and
   the launch-time prompt are instant after the first session.

Launch-time prompt:
 - preLaunchApp runs a Pattern B check (Ludusavi match AND no
   saveFilePatterns in PICS UFS) before cloud sync. Match fires an
   SDK_CLOUD_BRIDGE_SUGGESTION dialog with Enable / Skip / Don't ask
   again. Catches users who install with real-Steam default and never
   touch settings.
 - Don't-ask-again persists per-container as
   extraData.sdkCloudBridgePromptDismissed.

Runtime mirror (utils/SteamUtils.kt):
 - sdkCloudGameSaveDir now reads the user-configured subdir only; no
   implicit fallback, to avoid REPLACE_EXISTING copies into a guessed
   dir that might be wrong.
 - detectSdkCloudSaveSubdir resolves paths via the container's own
   rootDir rather than the global xuser symlink so it works even when
   a different container is activated.

Removed:
 - Bundled assets/sdk_cloud_save_bridge.json (single hardcoded entry);
   Ludusavi covers it plus ~1943 others.

Cosmetic: replaced "Pluvia" with "GameNative" in comments/strings
written on this branch. PluviaApp/PluviaTheme/PluviaPreferences class
names and storage keys left alone.

Author: TideGear

app/src/main/java/app/gamenative/PluviaApp.kt

@@ -13,6 +13,7 @@ import app.gamenative.service.DownloadService
 import app.gamenative.service.SteamService
 import app.gamenative.utils.ContainerMigrator
 import app.gamenative.utils.IntentLaunchManager
+import app.gamenative.utils.LudusaviRegistry
 import app.gamenative.utils.PlayIntegrity
 import java.io.File
 import javax.inject.Inject
@@ -87,6 +88,15 @@ class PluviaApp : SplitCompatApplication() {
             )
         }
 
+        // Prime the Ludusavi save-path registry in the background. The loader itself
+        // checks cache freshness (7-day TTL) and only hits the network when stale — so
+        // the SDK Cloud Save Bridge "Use Recommended" button and the launch-time prompt
+        // are both instant for users once the cache is populated.
+        appScope.launch {
+            runCatching { LudusaviRegistry.primeCache(applicationContext) }
+                .onFailure { Timber.w(it, "Background Ludusavi registry refresh failed") }
+        }
+
         // Clear any stale temporary config overrides from previous app sessions
         try {
             IntentLaunchManager.clearAllTemporaryOverrides()

app/src/main/java/app/gamenative/service/SteamAutoCloud.kt

@@ -125,7 +125,7 @@ object SteamAutoCloud {
 
         // Auto-Cloud games declare saveFilePatterns rooted outside SteamUserData (usually
         // GameInstall or WinAppData*). Their cloud payloads are sometimes surfaced without a
-        // prefix — either because the cloud entry was uploaded by an old Pluvia build under
+        // prefix — either because the cloud entry was uploaded by an old GameNative build under
         // SteamUserData, or because Steam's getAppFileListChange returned an empty prefix list.
         // Either way, naively writing those files to <SteamUserData>/<appid>/remote/ hides them
         // from the game, which reads from the pattern's real location. Rebase to the matching

app/src/main/java/app/gamenative/service/SteamService.kt

@@ -2217,14 +2217,14 @@ class SteamService : Service(), IChallengeUrlChanged {
             }
 
             try {
-                // Pluvia is the sole cloud client in both modes: Wine-Steam has
+                // GameNative is the sole cloud client in both modes: Wine-Steam has
                 // cloudenabled=0 written to localconfig.vdf AND sharedconfig.vdf and
                 // is launched with -no-browser so it performs no cloud I/O. Running
-                // Pluvia's AutoCloud on launch is required in real-Steam mode so users
+                // GameNative's AutoCloud on launch is required in real-Steam mode so users
                 // get fresh saves from other devices before the Wine-hosted game loads
                 // them — skipping this on launch caused Dead Cells to boot into an
                 // empty save. The original "save conflict" dialog that motivated a
-                // skip was driven by a ChangeNumber race between Wine-Steam and Pluvia
+                // skip was driven by a ChangeNumber race between Wine-Steam and GameNative
                 // both writing cloud state; with Wine-Steam's cloud fully suppressed
                 // there is no second writer to race with.
                 val maxAttempts = 3

app/src/main/java/app/gamenative/ui/PluviaMain.kt

@@ -90,6 +90,7 @@ import app.gamenative.ui.theme.PluviaTheme
 import app.gamenative.ui.util.SnackbarManager
 import app.gamenative.utils.BestConfigService
 import app.gamenative.utils.ContainerUtils
+import app.gamenative.utils.SteamUtils
 import app.gamenative.utils.PlatformAuthUtils
 import app.gamenative.utils.CustomGameScanner
 import app.gamenative.utils.ManifestInstaller
@@ -789,6 +790,61 @@ fun PluviaMain(
             }
         }
 
+        DialogType.SDK_CLOUD_BRIDGE_SUGGESTION -> {
+            val relaunch = {
+                preLaunchApp(
+                    context = context,
+                    appId = state.launchedAppId,
+                    skipBridgePrompt = true,
+                    setLoadingDialogVisible = viewModel::setLoadingDialogVisible,
+                    setLoadingProgress = viewModel::setLoadingDialogProgress,
+                    setLoadingMessage = viewModel::setLoadingDialogMessage,
+                    setMessageDialogState = setMessageDialogState,
+                    onSuccess = viewModel::launchApp,
+                    isOffline = viewModel.isOffline.value,
+                )
+            }
+            onConfirmClick = {
+                // Enable: write Ludusavi's suggested subdir, then continue the launch.
+                msgDialogState = MessageDialogState(false)
+                CoroutineScope(Dispatchers.IO).launch {
+                    val gameId = ContainerUtils.extractGameIdFromContainerId(state.launchedAppId)
+                    val rec = runCatching {
+                        SteamUtils.getRecommendedSdkCloudSaveSubdirAsync(context, gameId)
+                    }.getOrNull()
+                    if (rec != null) {
+                        runCatching {
+                            val container = ContainerUtils.getContainer(context, state.launchedAppId)
+                            container.sdkCloudSaveSubdir = rec.subdir
+                            container.saveData()
+                        }.onFailure { Timber.w(it, "Failed to persist sdkCloudSaveSubdir=${rec.subdir}") }
+                    }
+                    withContext(Dispatchers.Main) { relaunch() }
+                }
+            }
+            onDismissClick = {
+                // Skip this time — continue launch without setting the field.
+                msgDialogState = MessageDialogState(false)
+                relaunch()
+            }
+            onActionClick = {
+                // Don't ask again for this game.
+                msgDialogState = MessageDialogState(false)
+                CoroutineScope(Dispatchers.IO).launch {
+                    runCatching {
+                        val container = ContainerUtils.getContainer(context, state.launchedAppId)
+                        container.putExtra("sdkCloudBridgePromptDismissed", "1")
+                        container.saveData()
+                    }.onFailure { Timber.w(it, "Failed to persist sdkCloudBridgePromptDismissed") }
+                    withContext(Dispatchers.Main) { relaunch() }
+                }
+            }
+            onDismissRequest = {
+                msgDialogState = MessageDialogState(false)
+                relaunch()
+            }
+        }
+
         DialogType.SYNC_CONFLICT -> {
             onConfirmClick = {
                 preLaunchApp(
@@ -1519,6 +1575,7 @@ fun preLaunchApp(
     preferredSave: SaveLocation = SaveLocation.None,
     useTemporaryOverride: Boolean = false,
     skipCloudSync: Boolean = false,
+    skipBridgePrompt: Boolean = false,
     setLoadingDialogVisible: (Boolean) -> Unit,
     setLoadingProgress: (Float) -> Unit,
     setLoadingMessage: (String) -> Unit,
@@ -1550,6 +1607,41 @@ fun preLaunchApp(
         val gameSource = ContainerUtils.extractGameSourceFromContainerId(appId)
         val isLocalSavesOnly = ContainerUtils.isLocalSavesOnly(context, appId)
 
+        // First-launch suggestion for Pattern B SDK-cloud games (e.g. Dead Cells).
+        // Fires only when real-Steam is on, the subdir is blank, the user hasn't dismissed,
+        // Ludusavi knows this game, AND it has no Auto-Cloud saveFilePatterns in PICS UFS.
+        // That intersection is a reliable Pattern B signal and keeps false positives low.
+        if (!skipBridgePrompt &&
+            gameSource == GameSource.STEAM &&
+            container.isLaunchRealSteam &&
+            container.sdkCloudSaveSubdir.isBlank() &&
+            container.getExtra("sdkCloudBridgePromptDismissed", "") != "1"
+        ) {
+            val rec = runCatching {
+                SteamUtils.shouldSuggestSdkCloudBridge(context, gameId)
+            }.getOrNull()
+            if (rec != null) {
+                Timber.i("Pattern B bridge prompt for appId=$gameId (\"${rec.name}\" -> \"${rec.subdir}\")")
+                setLoadingDialogVisible(false)
+                setMessageDialogState(
+                    MessageDialogState(
+                        visible = true,
+                        type = DialogType.SDK_CLOUD_BRIDGE_SUGGESTION,
+                        title = context.getString(R.string.sdk_cloud_bridge_prompt_title),
+                        message = context.getString(
+                            R.string.sdk_cloud_bridge_prompt_message,
+                            rec.name.ifEmpty { gameId.toString() },
+                            rec.subdir,
+                        ),
+                        confirmBtnText = context.getString(R.string.sdk_cloud_bridge_prompt_enable),
+                        dismissBtnText = context.getString(R.string.sdk_cloud_bridge_prompt_skip),
+                        actionBtnText = context.getString(R.string.sdk_cloud_bridge_prompt_dont_ask),
+                    ),
+                )
+                return@launch
+            }
+        }
+
         // When "Open container" is used we boot to desktop/file manager only — skip executable check
         if (!bootToContainer) {
             // Verify we have a launch executable for all platforms before proceeding (fail fast, avoid black screen)

app/src/main/java/app/gamenative/ui/component/dialog/ContainerConfigDialog.kt

@@ -143,6 +143,7 @@ fun ContainerConfigDialog(
     default: Boolean = false,
     title: String,
     initialConfig: ContainerData = ContainerData(),
+    appId: Int? = null,
     onDismissRequest: () -> Unit,
     onSave: (ContainerData) -> Unit,
 ) {
@@ -1037,6 +1038,7 @@ fun ContainerConfigDialog(
             applyScreenSizeToConfig = applyScreenSizeToConfig,
             vkd3dForcedVersion = { vkd3dForcedVersion() },
             currentDxvkContext = { currentDxvkContext() },
+            appId = appId,
         )
 
         LoadingDialog(

app/src/main/java/app/gamenative/ui/component/dialog/ContainerConfigState.kt

@@ -135,4 +135,7 @@ class ContainerConfigState(
     val applyScreenSizeToConfig: () -> Unit,
     val vkd3dForcedVersion: () -> String,
     val currentDxvkContext: () -> ManifestComponentHelper.DxvkContext,
+    /** Steam appId for this container, or null if not a Steam container. Used by
+     *  per-game UI like the SDK-cloud save subdir detect button. */
+    val appId: Int? = null,
 )