v2.0.0 - Complete Rewrite: Dashboard-First Architecture with Modern MVVM

##  MAJOR RELEASE - AppControlX v2.0.0

This is a COMPLETE REWRITE of AppControlX from the ground up with modern architecture,
new features, and improved user experience.

###  NEW FEATURES

**Dashboard (DevCheck-style)**
- Real-time CPU usage and temperature monitoring
- Battery status with charging indicator and temperature
- RAM and Storage usage with visual indicators
- Network status (WiFi/Mobile/Ethernet)
- Display info (resolution, refresh rate)
- GPU info (requires root)
- Device info with uptime and deep sleep time
- Feature quick access cards for easy navigation

**Setup Wizard**
- Guided first-time setup experience
- Mode selection (Root/Shizuku/View-Only)
- Permission verification
- Clean onboarding flow

**Mode Loss Detection**
- Automatic detection when Root/Shizuku access is lost
- Dialog with options: Retry, Switch Mode, Continue View-Only
- Seamless recovery experience

**Display Refresh Rate Control**
- Set minimum and maximum refresh rate
- Reset to default option
- Requires Root or Shizuku mode

**Batch Progress UI**
- Visual progress during batch operations
- Per-app status indicators
- Success/failure counts
- Cancel operation support

###  ARCHITECTURE CHANGES

**New Package Structure:**
- domain/executor/ - Command execution (Root, Shizuku)
- domain/manager/ - Business logic managers
- domain/scanner/ - App scanning with dumpsys
- domain/monitor/ - System monitoring
- domain/validator/ - Safety validation
- data/model/ - Clean data classes
- ui/ - Organized UI components

**Key Components:**
- CommandExecutor interface with RootExecutor & ShizukuExecutor
- AppControlManager for freeze/unfreeze/force-stop/uninstall/clear
- BatteryManager for background restriction
- ActionLogger for history and rollback
- DisplayManager for refresh rate control
- ModeWatcher for mode loss detection
- SystemMonitor for real-time system info
- AppScanner with accurate dumpsys-based detection
- SafetyValidator with comprehensive package protection

###  SECURITY

- Command whitelist enforcement in RootExecutor
- Dangerous pattern blocking (rm -rf, reboot, format, etc.)
- Package name validation against injection attempts
- Critical system app protection (~200 packages)
- Force-stop-only packages for security apps

###  UI/UX IMPROVEMENTS

- Material 3 with Dynamic Colors support
- Bottom navigation (Dashboard, Apps, Settings)
- Modern card-based layouts
- Status badges (Running, Stopped, Frozen, Restricted)
- Dark mode support
- Accessibility improvements

###  CLEANUP

- Removed old code structure
- Deleted .old folder
- Removed unused .gitkeep files
- Updated ProGuard rules for new package structure
- Updated CHANGELOG.md

###  TECHNICAL

- Version: 2.0.0 (versionCode 4)
- Min SDK: 29 (Android 10)
- Target SDK: 34 (Android 14)
- Kotlin 1.9
- Hilt DI
- Coroutines + Flow
- libsu 5.2.2
- Shizuku-API 13.1.5
- Navigation Component
- ViewBinding

###  FILES CHANGED

- 90+ files modified/added/deleted
- Complete package restructure
- New layouts for Dashboard and cards
- Updated navigation graph
- New string resources

---

Built with  using Kiro AI Assistant
Ready for GitHub Actions build!

Author: risunCode

CHANGELOG.md

@@ -2,7 +2,47 @@
 
 All notable changes to AppControlX.
 
-## [1.1.0] - 2024-12
+## [2.0.0] - 2026-01 (v2 Rewrite)
+
+### 🎉 Complete Rewrite
+This is a complete rewrite of AppControlX with modern architecture and new features.
+
+### Added
+- **Dashboard** - System monitoring with real-time updates
+  - CPU usage and temperature
+  - Battery status and temperature
+  - RAM and Storage usage
+  - Network status
+  - Display info (resolution, refresh rate)
+  - GPU info (requires root)
+  - Device info with uptime and deep sleep time
+- **Setup Wizard** - Guided first-time setup with mode selection
+- **Mode Loss Detection** - Automatic detection when Root/Shizuku access is lost
+- **Display Refresh Rate Control** - Set min/max refresh rate (Root/Shizuku)
+- **Feature Quick Access Cards** - Navigate to features from Dashboard
+- **Batch Progress UI** - Visual progress during batch operations
+
+### Changed
+- **Architecture** - Complete rewrite with clean MVVM + Hilt DI
+- **Package Structure** - New organized structure:
+  - `domain/executor/` - Command executors
+  - `domain/manager/` - Business logic managers
+  - `domain/scanner/` - App scanning
+  - `domain/monitor/` - System monitoring
+  - `domain/validator/` - Safety validation
+  - `data/model/` - Data classes
+  - `ui/` - UI components
+- **App Detection** - More accurate using dumpsys + PackageManager
+- **Material 3** - Updated to latest Material Design 3
+- **Navigation** - Bottom navigation with Dashboard, Apps, Settings
+
+### Removed
+- Old code moved to `.old` folder (now deleted)
+- Legacy architecture patterns
+
+---
+
+## [1.1.0] - 2025-12
 
 ### Added
 - Showcase website (index.html) with responsive design, 3 themes, image gallery with lightbox
@@ -23,7 +63,7 @@ All notable changes to AppControlX.
 
 ---
 
-## [1.0.0] - 2024-12
+## [1.0.0] - 2025-12
 
 ### Added
 
@@ -131,18 +171,46 @@ All notable changes to AppControlX.
 
 ---
 
-## Architecture
+## Architecture (v2)
 
 ```
 com.appcontrolx/
-├── data/local/         # Room Database (DAO, Entity)
-├── di/                 # Hilt modules
-├── executor/           # RootExecutor, ShizukuExecutor
-├── model/              # AppInfo, ExecutionMode
-├── rollback/           # RollbackManager, ActionLog
-├── service/            # AppFetcher, BatteryPolicyManager, PermissionBridge
-├── ui/                 # Activities, Fragments, Adapters, BottomSheets
-└── utils/              # Constants, SafetyValidator
+├── App.kt                    # Application class with @HiltAndroidApp
+├── di/                       # Hilt DI modules
+│   ├── AppModule.kt
+│   └── ExecutorModule.kt
+├── domain/
+│   ├── executor/             # Command execution
+│   │   ├── CommandExecutor.kt
+│   │   ├── RootExecutor.kt
+│   │   ├── ShizukuExecutor.kt
+│   │   └── PermissionBridge.kt
+│   ├── manager/              # Business logic
+│   │   ├── AppControlManager.kt
+│   │   ├── BatteryManager.kt
+│   │   ├── ActionLogger.kt
+│   │   ├── DisplayManager.kt
+│   │   └── ModeWatcher.kt
+│   ├── scanner/              # App scanning
+│   │   └── AppScanner.kt
+│   ├── monitor/              # System monitoring
+│   │   └── SystemMonitor.kt
+│   └── validator/            # Safety validation
+│       └── SafetyValidator.kt
+├── data/
+│   └── model/                # Data classes
+│       ├── AppInfo.kt
+│       ├── ExecutionMode.kt
+│       ├── SystemInfo.kt
+│       └── ActionLog.kt
+└── ui/
+    ├── MainActivity.kt
+    ├── setup/                # Setup wizard
+    ├── dashboard/            # Dashboard with system info
+    ├── applist/              # App list and detail
+    ├── settings/             # Settings
+    ├── history/              # Action history
+    └── components/           # Reusable UI components
 ```
 
 ## Tech Stack
@@ -151,7 +219,9 @@ com.appcontrolx/
 - Min SDK 29 (Android 10)
 - Target SDK 34 (Android 14)
 - MVVM + Hilt DI
-- Material 3
+- Material 3 with Dynamic Colors
 - Coroutines + Flow
-- libsu (Root)
-- Shizuku-API
+- libsu 5.2.2 (Root)
+- Shizuku-API 13.1.5
+- Navigation Component
+- ViewBinding

app/build.gradle.kts

@@ -13,8 +13,8 @@ android {
         applicationId = "com.appcontrolx"
         minSdk = 29
         targetSdk = 34
-        versionCode = 3
-        versionName = "1.1.0"
+        versionCode = 4
+        versionName = "2.0.0"
     }
 
     signingConfigs {
@@ -92,6 +92,7 @@ dependencies {
     implementation("androidx.appcompat:appcompat:1.6.1")
     implementation("com.google.android.material:material:1.11.0")
     implementation("androidx.constraintlayout:constraintlayout:2.1.4")
+    implementation("androidx.gridlayout:gridlayout:1.0.0")
 
     // Lifecycle & ViewModel
     implementation("androidx.lifecycle:lifecycle-viewmodel-ktx:2.7.0")

app/proguard-rules.pro

@@ -20,26 +20,34 @@
 -keep class com.appcontrolx.IShellService$* { *; }
 -keep class * extends android.os.Binder { *; }
 
-# Keep Shizuku UserService
--keep class com.appcontrolx.executor.ShellService { *; }
--keep class com.appcontrolx.executor.ShizukuExecutor { *; }
--keep class com.appcontrolx.executor.ShizukuExecutor$* { *; }
-
-# Keep all executors
--keep class com.appcontrolx.executor.** { *; }
-
-# Keep MainActivity methods (What's New dialog)
--keepclassmembers class com.appcontrolx.ui.MainActivity {
-    private void showWhatsNewIfNeeded();
-    private void showWhatsNewDialog();
-}
+# Keep Shizuku UserService - NEW PACKAGE STRUCTURE
+-keep class com.appcontrolx.domain.executor.ShellService { *; }
+-keep class com.appcontrolx.domain.executor.ShizukuExecutor { *; }
+-keep class com.appcontrolx.domain.executor.ShizukuExecutor$* { *; }
+
+# Keep all executors - NEW PACKAGE STRUCTURE
+-keep class com.appcontrolx.domain.executor.** { *; }
+
+# Keep all managers
+-keep class com.appcontrolx.domain.manager.** { *; }
+
+# Keep all validators
+-keep class com.appcontrolx.domain.validator.** { *; }
 
-# Keep Models
--keep class com.appcontrolx.model.** { *; }
--keep class com.appcontrolx.data.local.entity.** { *; }
+# Keep all scanners
+-keep class com.appcontrolx.domain.scanner.** { *; }
 
-# Keep Rollback data classes (for Gson serialization)
--keep class com.appcontrolx.rollback.** { *; }
+# Keep all monitors
+-keep class com.appcontrolx.domain.monitor.** { *; }
+
+# Keep Data Models - NEW PACKAGE STRUCTURE
+-keep class com.appcontrolx.data.model.** { *; }
+-keep class com.appcontrolx.data.preferences.** { *; }
+-keep class com.appcontrolx.data.repository.** { *; }
+
+# Keep UI State classes
+-keep class com.appcontrolx.ui.applist.AppListUiState { *; }
+-keep class com.appcontrolx.ui.dashboard.DashboardUiState { *; }
 
 # Keep ViewModels
 -keep class * extends androidx.lifecycle.ViewModel {
@@ -70,12 +78,6 @@
 -keep class * implements com.google.gson.JsonSerializer
 -keep class * implements com.google.gson.JsonDeserializer
 
-# Crashlytics
--keepattributes SourceFile,LineNumberTable
--keep public class * extends java.lang.Exception
--keep class com.google.firebase.crashlytics.** { *; }
--dontwarn com.google.firebase.crashlytics.**
-
 # Coroutines
 -keepnames class kotlinx.coroutines.internal.MainDispatcherFactory {}
 -keepnames class kotlinx.coroutines.CoroutineExceptionHandler {}
@@ -89,8 +91,3 @@
     public static *** v(...);
     public static *** i(...);
 }
--assumenosideeffects class timber.log.Timber {
-    public static *** d(...);
-    public static *** v(...);
-    public static *** i(...);
-}

app/src/main/java/com/appcontrolx/App.kt

@@ -1,13 +1,25 @@
 package com.appcontrolx
 
 import android.app.Application
+import android.os.Build
 import android.util.Log
 import androidx.appcompat.app.AppCompatDelegate
 import androidx.preference.PreferenceManager
-import com.appcontrolx.utils.Constants
+import com.google.android.material.color.DynamicColors
 import com.topjohnwu.superuser.Shell
 import dagger.hilt.android.HiltAndroidApp
 
+/**
+ * Application class for AppControlX.
+ * 
+ * Handles:
+ * - Hilt dependency injection initialization
+ * - Root shell configuration via libsu
+ * - Material 3 dynamic colors support (Android 12+)
+ * - Theme (Light/Dark/System) application
+ * 
+ * Requirements: 8.7, 8.8 - Material 3 design with dynamic colors and dark mode support
+ */
 @HiltAndroidApp
 class App : Application() {
 
@@ -43,13 +55,62 @@ class App : Application() {
 
     override fun onCreate() {
         super.onCreate()
+        
+        // Apply Material 3 dynamic colors (Android 12+)
+        // This extracts colors from the user's wallpaper for a personalized theme
+        applyDynamicColors()
+        
+        // Apply user's theme preference (Light/Dark/System)
         applyTheme()
-        Log.d(TAG, "App initialized")
+        
+        Log.d(TAG, "App initialized with Material 3 theming")
+    }
+    
+    /**
+     * Apply Material 3 dynamic colors if available (Android 12+).
+     * 
+     * Dynamic colors extract the dominant colors from the user's wallpaper
+     * and apply them throughout the app for a cohesive, personalized experience.
+     * 
+     * On devices running Android 11 or below, the app falls back to the
+     * static Material 3 color scheme defined in colors.xml.
+     */
+    private fun applyDynamicColors() {
+        val prefs = PreferenceManager.getDefaultSharedPreferences(this)
+        val useDynamicColors = prefs.getBoolean(PREFS_DYNAMIC_COLORS, true)
+        
+        if (useDynamicColors && Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
+            // Apply dynamic colors to all activities
+            DynamicColors.applyToActivitiesIfAvailable(this)
+            Log.d(TAG, "Dynamic colors applied")
+        } else {
+            Log.d(TAG, "Using static Material 3 color scheme")
+        }
     }
 
+    /**
+     * Apply the user's theme preference.
+     * 
+     * Supports:
+     * - MODE_NIGHT_FOLLOW_SYSTEM: Follow system dark mode setting (default)
+     * - MODE_NIGHT_NO: Always use light theme
+     * - MODE_NIGHT_YES: Always use dark theme
+     */
     private fun applyTheme() {
         val prefs = PreferenceManager.getDefaultSharedPreferences(this)
-        val theme = prefs.getInt(Constants.PREFS_THEME, AppCompatDelegate.MODE_NIGHT_FOLLOW_SYSTEM)
+        val theme = prefs.getInt(PREFS_THEME, AppCompatDelegate.MODE_NIGHT_FOLLOW_SYSTEM)
         AppCompatDelegate.setDefaultNightMode(theme)
+        
+        val themeName = when (theme) {
+            AppCompatDelegate.MODE_NIGHT_NO -> "Light"
+            AppCompatDelegate.MODE_NIGHT_YES -> "Dark"
+            else -> "System"
+        }
+        Log.d(TAG, "Theme applied: $themeName")
+    }
+    
+    private companion object {
+        const val PREFS_THEME = "theme"
+        const val PREFS_DYNAMIC_COLORS = "dynamic_colors"
     }
 }

app/src/main/java/com/appcontrolx/data/model/ActionLog.kt

@@ -0,0 +1,49 @@
+package com.appcontrolx.data.model
+
+import java.util.UUID
+
+/**
+ * Types of actions that can be performed on apps.
+ */
+enum class AppAction {
+    FREEZE,
+    UNFREEZE,
+    FORCE_STOP,
+    UNINSTALL,
+    CLEAR_CACHE,
+    CLEAR_DATA,
+    RESTRICT_BACKGROUND,
+    ALLOW_BACKGROUND
+}
+
+/**
+ * Record of an action performed on one or more apps.
+ */
+data class ActionLog(
+    val id: String = UUID.randomUUID().toString(),
+    val action: AppAction,
+    val packages: List<String>,
+    val success: Boolean,
+    val errorMessage: String? = null,
+    val timestamp: Long = System.currentTimeMillis()
+)
+
+/**
+ * State of a single app for rollback purposes.
+ */
+data class AppState(
+    val packageName: String,
+    val isEnabled: Boolean,
+    val runInBackground: String,
+    val wakeLock: String
+)
+
+/**
+ * Snapshot of app states before a batch action.
+ * Used for rollback functionality.
+ */
+data class StateSnapshot(
+    val id: String = UUID.randomUUID().toString(),
+    val states: List<AppState>,
+    val createdAt: Long = System.currentTimeMillis()
+)