docs(readme): update feature structure and technical specifications

- **Feature Details**:
    - Add readme translation support with `TranslationRepository` and new UI components (`LanguagePicker`, `TranslationControls`).
    - Expand domain models for translation and download management (downgrade warnings, asset selection).
    - Update `DetailsScreen` route to include `isComingFromUpdate` flag.
    - Add Shizuku-based silent installation support for Android.
- **Core Improvements**:
    - Rename `settings` module to `profile` and add `SponsorScreen`.
    - Enhance `core/domain` and `core/data` with `ProxyRepository`, `RateLimitRepository`, and comprehensive Shizuku integration.
    - Update localization to support 11 languages.
- **Maintenance**:
    - Bump version to 1.6.2 (Target SDK 36).
    - Upgrade dependencies: Kotlin (2.3.10), Compose Multiplatform (1.10.1), Ktor (3.4.0), Room (2.8.4), Koin (4.1.1).
    - Add WorkManager, Shizuku API, and Kotlinx Datetime dependencies.

Author: rainxchzed

CLAUDE.md

@@ -4,7 +4,7 @@
 
 GitHub Store is a cross-platform app store for GitHub releases, built with **Kotlin Multiplatform (KMP)** and **Compose Multiplatform**. Targets **Android** (min API 26) and **Desktop** (Windows, macOS, Linux via JVM).
 
-Package: `zed.rainxch.githubstore`
+Package: `zed.rainxch.githubstore` | Version: 1.6.2 (code 13) | Target SDK: 36
 
 ## Build & Run Commands
 
@@ -45,8 +45,8 @@ feature/
   dev-profile/                       # Developer/user profile display
   favourites/                        # Saved favorite repositories (presentation-only)
   home/                              # Main discovery screen (trending, hot, popular)
+  profile/                           # User profile, settings, appearance, proxy, Shizuku installer
   search/                            # Repository search with filters
-  settings/                          # App settings (theme, account, appearance)
   starred/                           # Starred repositories (presentation-only)
 build-logic/convention/              # Custom Gradle convention plugins
 ```
@@ -86,9 +86,9 @@ class XViewModel : ViewModel() {
 Type-safe navigation using `@Serializable` sealed interface `GithubStoreGraph`:
 
 ```
-HomeScreen, SearchScreen, AuthenticationScreen, SettingsScreen,
-FavouritesScreen, StarredReposScreen, AppsScreen
-DetailsScreen(repositoryId, owner, repo)
+HomeScreen, SearchScreen, AuthenticationScreen, ProfileScreen,
+FavouritesScreen, StarredReposScreen, AppsScreen, SponsorScreen
+DetailsScreen(repositoryId, owner, repo, isComingFromUpdate)
 DeveloperProfileScreen(username)
 ```
 
@@ -102,26 +102,29 @@ Routes defined in `composeApp/.../app/navigation/GithubStoreGraph.kt`, wired in
 
 | Module | Purpose | Key Contents |
 |--------|---------|--------------|
-| `core/domain` | Shared contracts | Repository interfaces (`FavouritesRepository`, `StarredRepository`, `InstalledAppsRepository`, `ThemesRepository`), models (`GithubRepoSummary`, `GithubRelease`, `InstalledApp`, `ProxyConfig`), system interfaces (`Downloader`, `Installer`, `PackageMonitor`) |
-| `core/data` | Shared implementations | `HttpClientFactory` (Ktor + interceptors), `AppDatabase` (Room), `ProxyManager`, `TokenStore`, `LocalizationManager`, platform-specific clients (OkHttp for Android, CIO for Desktop) |
-| `core/presentation` | Shared UI | `GithubStoreTheme` (Material 3), reusable components (`RepositoryCard`, `GithubStoreButton`), formatting utils |
+| `core/domain` | Shared contracts | Repository interfaces (`FavouritesRepository`, `StarredRepository`, `InstalledAppsRepository`, `ThemesRepository`, `ProxyRepository`, `RateLimitRepository`), models (`GithubRepoSummary`, `GithubRelease`, `InstalledApp`, `ProxyConfig`, `InstallerType`, `ShizukuAvailability`), system interfaces (`Installer`, `InstallerInfoExtractor`, `InstallerStatusProvider`, `PackageMonitor`) |
+| `core/data` | Shared implementations | `HttpClientFactory` (Ktor + interceptors), `AppDatabase` (Room), `ProxyManager`, `TokenStore`, `LocalizationManager`, platform-specific clients (OkHttp for Android, CIO for Desktop), Shizuku integration (Android: `ShizukuServiceManager`, `ShizukuInstallerWrapper`, `ShizukuInstallerServiceImpl`, `AndroidInstallerStatusProvider`; Desktop: `DesktopInstallerStatusProvider`) |
+| `core/presentation` | Shared UI | `GithubStoreTheme` (Material 3), reusable components (`RepositoryCard`, `GithubStoreButton`), formatting utils, localized strings (11 languages) |
 
 ## Tech Stack
 
 | Area | Library | Version |
 |------|---------|---------|
-| Language | Kotlin | 2.3.0 |
-| UI | Compose Multiplatform | 1.9.0-beta01 |
-| HTTP | Ktor | 3.2.3 |
-| Database | Room | 2.7.2 |
-| DI | Koin | 4.1.0 |
-| Serialization | Kotlinx Serialization | 1.9.0 |
-| Preferences | DataStore | 1.1.7 |
-| Image Loading | Landscapist (Coil3) | 2.9.1 |
+| Language | Kotlin | 2.3.10 |
+| UI | Compose Multiplatform | 1.10.1 |
+| HTTP | Ktor | 3.4.0 |
+| Database | Room | 2.8.4 |
+| DI | Koin | 4.1.1 |
+| Serialization | Kotlinx Serialization | 1.10.0 |
+| Preferences | DataStore | 1.2.0 |
+| Image Loading | Landscapist (Coil3) | 2.9.5 |
 | Logging | Kermit | 2.0.8 |
-| Permissions | MOKO Permissions | 0.19.1 |
-| Navigation | Navigation Compose | 2.9.1 |
-| Markdown | Multiplatform Markdown Renderer | 0.39.1 |
+| Permissions | MOKO Permissions | 0.20.1 |
+| Navigation | Navigation Compose | 2.9.2 |
+| Markdown | Multiplatform Markdown Renderer | 0.39.2 |
+| Shizuku | Shizuku API | 13.1.5 |
+| Background Work | WorkManager | 2.11.1 |
+| Date/Time | Kotlinx Datetime | 0.7.1 |
 
 All versions managed in `gradle/libs.versions.toml` (Version Catalog).
 
@@ -151,7 +154,8 @@ Custom Gradle plugins in `build-logic/convention/` standardize module setup:
 
 ## Key Configuration
 
-- **GitHub OAuth:** Set `GITHUB_CLIENT_ID` in `local.properties`. Callback URL: `githubstore://callback`
+- **GitHub OAuth:** Set `GITHUB_CLIENT_ID` in `local.properties`. Callback URL: `githubstore://callback`. Deep link: `githubstore://repo`
+- **Shizuku (Android):** Optional silent install via `ShizukuProvider` (registered in AndroidManifest). Requires Shizuku app running with ADB or root. AIDL service passes APK via `ParcelFileDescriptor` to `pm install -S`. Falls back to standard installer on failure.
 - **Gradle properties:** Config cache enabled, build cache enabled, 4GB Gradle heap, 3GB Kotlin daemon heap
 - **Code style:** Official Kotlin style (`kotlin.code.style=official`)
 

feature/details/CLAUDE.md

@@ -2,7 +2,7 @@
 
 ## Purpose
 
-Repository detail screen. Displays full info for a GitHub repository including owner profile, stats, releases with download links, readme rendering, and installation/update flow. This is the most complex feature module (~27 presentation files).
+Repository detail screen. Displays full info for a GitHub repository including owner profile, stats, releases with download links, readme rendering (with translation support), and installation/update flow. This is the most complex feature module.
 
 ## Module Structure
 
@@ -11,14 +11,21 @@ feature/details/
 ├── domain/
 │   ├── model/
 │   │   ├── ReleaseCategory.kt        # Release filtering categories
-│   │   └── RepoStats.kt              # Stars, forks, open issues
-│   └── repository/DetailsRepository.kt  # Repo, releases, readme, stats, user profile
+│   │   ├── RepoStats.kt              # Stars, forks, open issues
+│   │   ├── SupportedLanguage.kt      # Languages for readme translation
+│   │   └── TranslationResult.kt      # Translation response model
+│   └── repository/
+│       ├── DetailsRepository.kt      # Repo, releases, readme, stats, user profile
+│       └── TranslationRepository.kt  # Readme translation
 ├── data/
 │   ├── di/SharedModule.kt            # Koin: detailsModule
-│   ├── repository/DetailsRepositoryImpl.kt  # API calls + readme localization
-│   ├── readme/ReadmeLocalizationHelper.kt   # Find readme in user's language
-│   ├── dto/                           # Network DTOs
-│   └── mappers/                       # DTO → domain model mappers
+│   ├── repository/
+│   │   ├── DetailsRepositoryImpl.kt  # API calls + readme localization
+│   │   └── TranslationRepositoryImpl.kt  # Translation API integration
+│   ├── model/ReadmeAttempt.kt        # Readme fetch attempt tracking
+│   └── utils/
+│       ├── ReadmeLocalizationHelper.kt   # Find readme in user's language
+│       └── preprocessMarkdown.kt     # Markdown preprocessing
 └── presentation/
     ├── DetailsViewModel.kt            # State management for detail screen
     ├── DetailsState.kt                # Repo, releases, readme, download progress, etc.
@@ -28,17 +35,26 @@ feature/details/
     ├── model/
     │   ├── DownloadStage.kt           # Download progress tracking
     │   ├── InstallLogItem.kt          # Installation log entries
-    │   └── LogResult.kt               # Log result types
+    │   ├── LogResult.kt               # Log result types
+    │   ├── ShowDowngradeWarning.kt    # Downgrade confirmation model
+    │   ├── SupportedLanguages.kt      # UI language list
+    │   ├── TranslationState.kt        # Translation UI state
+    │   └── TranslationTarget.kt       # Translation target selection
     ├── components/
     │   ├── AppHeader.kt               # App icon, name, developer
+    │   ├── LanguagePicker.kt          # Readme translation language selector
+    │   ├── ReleaseAssetsPicker.kt     # Asset selection for download
     │   ├── SmartInstallButton.kt      # Context-aware install/update/open button
     │   ├── StatItem.kt                # Individual stat display
+    │   ├── TranslationControls.kt     # Translation UI controls
     │   ├── VersionPicker.kt           # Release version selector
+    │   ├── VersionTypePicker.kt       # Stable/pre-release filter
     │   └── sections/
     │       ├── About.kt               # Description & topics
     │       ├── Header.kt              # Top header section
     │       ├── Logs.kt                # Installation/download logs
     │       ├── Owner.kt               # Repository owner info
+    │       ├── ReportIssue.kt         # Issue reporting section
     │       ├── Stats.kt               # Stars, forks, issues
     │       └── WhatsNew.kt            # Release changelog
     ├── states/ErrorState.kt           # Error display composable
@@ -47,8 +63,7 @@ feature/details/
         ├── LogResultAsText.kt         # Log result formatting
         ├── MarkdownImageTransformer.kt  # Transform relative image URLs
         ├── MarkdownUtils.kt           # Markdown preprocessing
-        ├── SystemArchitecture.kt      # Platform architecture detection
-        └── isLiquidFrostAvailable.kt
+        └── SystemArchitecture.kt      # Platform architecture detection
 ```
 
 ## Key Interfaces
@@ -63,20 +78,28 @@ interface DetailsRepository {
     suspend fun getRepoStats(owner: String, repo: String): RepoStats
     suspend fun getUserProfile(username: String): GithubUserProfile
 }
+
+interface TranslationRepository {
+    suspend fun translate(text: String, targetLanguage: SupportedLanguage): TranslationResult
+}
 ```
 
 ## Navigation
 
-Route: `GithubStoreGraph.DetailsScreen(repositoryId: Long, owner: String, repo: String)`
+Route: `GithubStoreGraph.DetailsScreen(repositoryId: Long, owner: String, repo: String, isComingFromUpdate: Boolean)`
 
-Can be reached via repo ID or owner+name (for deep links). Falls back to owner+name lookup if `repositoryId == -1`.
+Can be reached via repo ID or owner+name (for deep links). Falls back to owner+name lookup if `repositoryId == -1`. `isComingFromUpdate` flag indicates navigation from an update notification.
 
 ## Implementation Notes
 
 - Readme supports localization: `ReadmeLocalizationHelper` tries to find readme in user's language first
+- Readme translation: `TranslationRepository` translates readme content to user's chosen language via `LanguagePicker`
 - Markdown rendering uses `multiplatform-markdown-renderer` with custom `MarkdownImageTransformer` for relative URLs
 - Download flow tracks stages via `DownloadStage` (idle → downloading → installing → done)
 - `SmartInstallButton` changes behavior based on installed/update-available/not-installed state
+- `ReleaseAssetsPicker` allows selecting specific assets; `VersionTypePicker` filters stable vs pre-release
 - Version picker allows selecting specific releases for download
+- Downgrade warning shown when installing an older version than currently installed
 - Integrates with `FavouritesRepository`, `StarredRepository`, `InstalledAppsRepository` from core
 - Uses `Downloader` and `Installer` interfaces from core/domain for platform-specific download/install
+- On Android, install may use Shizuku (silent) or standard system installer depending on user preference in profile settings