E1: external-import domain interfaces and models

.claude/settings.local.json

@@ -10,7 +10,9 @@
       "WebFetch(domain:youtrack.jetbrains.com)",
       "WebFetch(domain:raw.githubusercontent.com)",
       "WebFetch(domain:blog.jetbrains.com)",
-      "Bash(rtk grep *)"
+      "Bash(rtk grep *)",
+      "Bash(git checkout *)",
+      "Bash(rtk proxy *)"
     ]
   }
 }

.gitignore

@@ -36,4 +36,6 @@ google-services.json
 
 composeApp/release/baselineProfiles/
 
-composeApp/kotzilla.json
+composeApp/kotzilla.json
+
+roadmap/

composeApp/src/androidMain/AndroidManifest.xml

@@ -18,6 +18,21 @@
     <uses-permission android:name="android.permission.FOREGROUND_SERVICE_DATA_SYNC" />
     <uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
 
+    <!--
+        Fallback visibility for installer-source classification when
+        QUERY_ALL_PACKAGES is denied on Android 11+. We need to recognise
+        these specific packages as install sources even without blanket
+        package visibility.
+    -->
+    <queries>
+        <package android:name="dev.imranr.obtainium.app" />
+        <package android:name="dev.imranr.obtainium" />
+        <package android:name="dev.imranr.obtainium.fdroid" />
+        <package android:name="org.fdroid.fdroid" />
+        <package android:name="com.android.vending" />
+        <package android:name="com.aurora.store" />
+    </queries>
+
     <application
         android:name=".app.GithubStoreApp"
         android:allowBackup="true"

composeApp/src/androidMain/kotlin/zed/rainxch/githubstore/app/GithubStoreApp.kt

@@ -12,11 +12,13 @@ import kotlinx.coroutines.flow.first
 import kotlinx.coroutines.launch
 import org.koin.android.ext.android.get
 import org.koin.android.ext.koin.androidContext
+import zed.rainxch.core.data.local.db.dao.ExternalLinkDao
 import zed.rainxch.core.data.services.DownloadNotificationObserver
 import zed.rainxch.core.data.services.PackageEventReceiver
 import zed.rainxch.core.data.services.UpdateScheduler
 import zed.rainxch.core.domain.model.InstallSource
 import zed.rainxch.core.domain.model.InstalledApp
+import zed.rainxch.core.domain.repository.ExternalImportRepository
 import zed.rainxch.core.domain.repository.InstalledAppsRepository
 import zed.rainxch.core.domain.repository.TweaksRepository
 import zed.rainxch.core.domain.system.PackageMonitor
@@ -38,6 +40,28 @@ class GithubStoreApp : Application() {
         startDownloadNotificationObserver()
         scheduleBackgroundUpdateChecks()
         registerSelfAsInstalledApp()
+        scheduleInitialExternalScan()
+        scheduleSigningSeedSync()
+    }
+
+    private fun scheduleInitialExternalScan() {
+        appScope.launch {
+            runCatching {
+                get<ExternalImportRepository>().scheduleInitialScanIfNeeded()
+            }.onFailure {
+                Logger.w(it) { "Initial external scan scheduling failed" }
+            }
+        }
+    }
+
+    private fun scheduleSigningSeedSync() {
+        appScope.launch {
+            runCatching {
+                get<ExternalImportRepository>().syncSigningFingerprintSeed()
+            }.onFailure {
+                Logger.w(it) { "Signing seed sync failed" }
+            }
+        }
     }
 
     private fun startDownloadNotificationObserver() {
@@ -85,6 +109,9 @@ class GithubStoreApp : Application() {
             PackageEventReceiver(
                 installedAppsRepository = get<InstalledAppsRepository>(),
                 packageMonitor = get<PackageMonitor>(),
+                externalImportRepository = get<ExternalImportRepository>(),
+                externalLinkDao = get<ExternalLinkDao>(),
+                appScope = get<CoroutineScope>(),
             )
         val filter = PackageEventReceiver.createIntentFilter()
 

composeApp/src/commonMain/kotlin/zed/rainxch/githubstore/app/di/ViewModelsModule.kt

@@ -4,6 +4,7 @@ import org.koin.core.module.dsl.viewModel
 import org.koin.core.module.dsl.viewModelOf
 import org.koin.dsl.module
 import zed.rainxch.apps.presentation.AppsViewModel
+import zed.rainxch.apps.presentation.import.ExternalImportViewModel
 import zed.rainxch.auth.presentation.AuthenticationViewModel
 import zed.rainxch.details.presentation.DetailsViewModel
 import zed.rainxch.devprofile.presentation.DeveloperProfileViewModel
@@ -18,6 +19,7 @@ import zed.rainxch.tweaks.presentation.TweaksViewModel
 val viewModelsModule =
     module {
         viewModelOf(::AppsViewModel)
+        viewModelOf(::ExternalImportViewModel)
         viewModelOf(::AuthenticationViewModel)
         viewModel { params ->
             // Indexed access because `ownerParam` and `repoParam` are both
@@ -48,6 +50,7 @@ val viewModelsModule =
                 attestationVerifier = get(),
                 downloadOrchestrator = get(),
                 telemetryRepository = get(),
+                externalImportRepository = get(),
             )
         }
         viewModelOf(::DeveloperProfileViewModel)

composeApp/src/commonMain/kotlin/zed/rainxch/githubstore/app/navigation/AppNavigation.kt

@@ -8,6 +8,7 @@ import androidx.compose.foundation.layout.padding
 import androidx.compose.material3.MaterialTheme
 import androidx.compose.runtime.Composable
 import androidx.compose.runtime.CompositionLocalProvider
+import androidx.compose.runtime.LaunchedEffect
 import androidx.compose.runtime.getValue
 import androidx.compose.runtime.mutableStateOf
 import androidx.compose.runtime.remember
@@ -28,6 +29,7 @@ import org.koin.compose.viewmodel.koinViewModel
 import org.koin.core.parameter.parametersOf
 import zed.rainxch.apps.presentation.AppsRoot
 import zed.rainxch.apps.presentation.AppsViewModel
+import zed.rainxch.apps.presentation.import.ExternalImportRoot
 import zed.rainxch.auth.presentation.AuthenticationRoot
 import zed.rainxch.core.presentation.locals.LocalBottomNavigationHeight
 import zed.rainxch.core.presentation.locals.LocalBottomNavigationLiquid
@@ -43,6 +45,10 @@ import zed.rainxch.search.presentation.SearchRoot
 import zed.rainxch.starred.presentation.StarredReposRoot
 import zed.rainxch.tweaks.presentation.TweaksRoot
 
+// Cross-screen "return result" key: set by the external-import wizard's
+// "Add manually" path before navigateUp(), read once by the Apps screen.
+private const val EXTERNAL_IMPORT_OPEN_LINK_SHEET_KEY = "external_import_open_link_sheet"
+
 @Composable
 fun AppNavigation(
     navController: NavHostController,
@@ -296,7 +302,18 @@ fun AppNavigation(
                     TweaksRoot()
                 }
 
-                composable<GithubStoreGraph.AppsScreen> {
+                composable<GithubStoreGraph.AppsScreen> { backStackEntry ->
+                    // Pick up the "open link sheet" flag set by ExternalImportRoot's
+                    // "Add manually" path. We consume the flag once on entry so a
+                    // later config change or back-stack rewind doesn't reopen the sheet.
+                    LaunchedEffect(backStackEntry) {
+                        val handle = backStackEntry.savedStateHandle
+                        val openLinkSheet = handle.get<Boolean>(EXTERNAL_IMPORT_OPEN_LINK_SHEET_KEY)
+                        if (openLinkSheet == true) {
+                            handle.remove<Boolean>(EXTERNAL_IMPORT_OPEN_LINK_SHEET_KEY)
+                            appsViewModel.onAction(zed.rainxch.apps.presentation.AppsAction.OnAddByLinkClick)
+                        }
+                    }
                     AppsRoot(
                         onNavigateBack = {
                             navController.navigateUp()
@@ -309,10 +326,35 @@ fun AppNavigation(
                                 ),
                             )
                         },
+                        onNavigateToExternalImport = {
+                            navController.navigate(GithubStoreGraph.ExternalImportScreen)
+                        },
                         viewModel = appsViewModel,
                         state = appsState,
                     )
                 }
+
+                composable<GithubStoreGraph.ExternalImportScreen> {
+                    ExternalImportRoot(
+                        onNavigateBack = {
+                            navController.navigateUp()
+                        },
+                        onNavigateToDetails = { repoId ->
+                            navController.navigate(
+                                GithubStoreGraph.DetailsScreen(
+                                    repositoryId = repoId,
+                                    isComingFromUpdate = true,
+                                ),
+                            )
+                        },
+                        onAddManually = {
+                            navController.previousBackStackEntry
+                                ?.savedStateHandle
+                                ?.set(EXTERNAL_IMPORT_OPEN_LINK_SHEET_KEY, true)
+                            navController.navigateUp()
+                        },
+                    )
+                }
             }
 
             val currentScreen =
@@ -331,7 +373,13 @@ fun AppNavigation(
                             restoreState = true
                         }
                     },
-                    isUpdateAvailable = appsState.apps.any { it.installedApp.isUpdateAvailable },
+                    // Badge fires when either an update is waiting OR pending
+                    // import candidates need review. The badge is a single dot
+                    // — a union of the two conditions is honest "you have
+                    // something to look at on this tab".
+                    isUpdateAvailable =
+                        appsState.apps.any { it.installedApp.isUpdateAvailable } ||
+                            appsState.showImportProposalBanner,
                     isLiquidGlassEnabled = isLiquidGlassEnabled,
                     modifier =
                         Modifier

composeApp/src/commonMain/kotlin/zed/rainxch/githubstore/app/navigation/GithubStoreGraph.kt

@@ -46,4 +46,7 @@ sealed interface GithubStoreGraph {
 
     @Serializable
     data object SponsorScreen : GithubStoreGraph
+
+    @Serializable
+    data object ExternalImportScreen : GithubStoreGraph
 }