Consolidated community contributions: AI architecture overhaul, tablet optimization, localization (ja/ar/pt-BR/fr), customizable library tabs, playlist concurrency fix, UI improvements, security hardening, and code quality pass

.github/workflows/codeql.yml

@@ -21,7 +21,7 @@ jobs:
 
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
 
       - name: Set up JDK 21
         uses: actions/setup-java@v5
@@ -47,9 +47,10 @@ jobs:
         with:
           languages: java-kotlin
           build-mode: manual
+          cache: true
 
       - name: Build with Gradle
-        run: ${{ github.workspace }}/gradlew :app:assembleDebug :wear:assembleDebug --no-daemon
+        run: ${{ github.workspace }}/gradlew :app:assembleDebug :wear:assembleDebug --no-daemon --no-build-cache
 
       - name: Perform CodeQL Analysis
         uses: github/codeql-action/analyze@v4

.github/workflows/nightly-apk.yml

@@ -85,7 +85,7 @@ jobs:
 
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
 
       - name: Set up JDK 21
         uses: actions/setup-java@v5

.github/workflows/phone-debug.yml

@@ -18,7 +18,7 @@ jobs:
 
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
 
       - name: Set up JDK 21
         uses: actions/setup-java@v5

.github/workflows/phone-release.yml

@@ -18,7 +18,7 @@ jobs:
 
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
 
       - name: Set up JDK 21
         uses: actions/setup-java@v5

.github/workflows/wearos-apk.yml

@@ -18,7 +18,7 @@ jobs:
 
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
 
       - name: Set up JDK 21
         uses: actions/setup-java@v5

app/build.gradle.kts

@@ -247,6 +247,8 @@ dependencies {
     implementation(libs.androidx.media3.exoplayer.ffmpeg)
     implementation(libs.androidx.media3.exoplayer.midi)
     implementation(libs.androidx.media3.transformer)
+    implementation(libs.androidx.media3.common)
+    implementation(libs.androidx.media3.common.ktx)
     implementation(libs.androidx.mediarouter)
     implementation(libs.androidx.media)
     implementation(libs.coil.compose)
@@ -298,6 +300,8 @@ dependencies {
         exclude(group = "androidx.compose.runtime")
         exclude(group = "androidx.compose.ui")
     }
+    implementation(libs.haze)
+    implementation(libs.haze.materials)
 
     // Projects
     implementation(project(":shared"))

app/src/main/java/com/theveloper/pixelplay/data/backup/BackupManager.kt

@@ -3,6 +3,7 @@ package com.theveloper.pixelplay.data.backup
 import android.content.Context
 import android.net.Uri
 import android.os.Build
+import timber.log.Timber
 import com.theveloper.pixelplay.data.backup.format.BackupReader
 import com.theveloper.pixelplay.data.backup.format.BackupWriter
 import com.theveloper.pixelplay.data.backup.history.BackupHistoryRepository
@@ -66,7 +67,7 @@ class BackupManager @Inject constructor(
             // Build manifest
             val packageInfo = try {
                 context.packageManager.getPackageInfo(context.packageName, 0)
-            } catch (_: Exception) { null }
+            } catch (e: Exception) { Timber.w(e, "Failed to get package info"); null }
 
             val manifest = BackupManifest(
                 schemaVersion = BackupManifest.CURRENT_SCHEMA_VERSION,
@@ -183,8 +184,8 @@ class BackupManager @Inject constructor(
                         appVersion = plan.manifest.appVersion
                     )
                 )
-            } catch (_: Exception) {
-                // Non-critical; don't fail restore because of history persistence
+            } catch (e: Exception) {
+                Timber.w(e, "Failed to persist restore history entry")
             }
         }
 

app/src/main/java/com/theveloper/pixelplay/data/backup/format/BackupWriter.kt

@@ -5,6 +5,7 @@ import android.net.Uri
 import com.google.gson.Gson
 import com.theveloper.pixelplay.data.backup.model.BackupManifest
 import com.theveloper.pixelplay.data.backup.model.BackupModuleInfo
+import timber.log.Timber
 import com.theveloper.pixelplay.di.BackupGson
 import dagger.hilt.android.qualifiers.ApplicationContext
 import kotlinx.coroutines.Dispatchers
@@ -85,7 +86,8 @@ class BackupWriter @Inject constructor(
             } else {
                 1
             }
-        } catch (_: Exception) {
+        } catch (e: Exception) {
+            Timber.w(e, "Failed to count items in backup module JSON")
             0
         }
     }

app/src/main/java/com/theveloper/pixelplay/data/backup/format/LegacyPayloadAdapter.kt

@@ -4,6 +4,7 @@ import com.google.gson.Gson
 import com.google.gson.JsonArray
 import com.google.gson.JsonObject
 import com.google.gson.JsonParser
+import timber.log.Timber
 import com.theveloper.pixelplay.data.backup.model.BackupManifest
 import com.theveloper.pixelplay.data.backup.model.BackupModuleInfo
 import com.theveloper.pixelplay.data.backup.model.DeviceInfo
@@ -120,7 +121,7 @@ class LegacyPayloadAdapter @Inject constructor() {
             } else {
                 1
             }
-        } catch (_: Exception) { 0 }
+        } catch (e: Exception) { Timber.w(e, "Failed to count legacy backup entries"); 0 }
     }
 
     private fun sha256(data: ByteArray): String {

app/src/main/java/com/theveloper/pixelplay/data/backup/history/BackupHistoryRepository.kt

@@ -8,6 +8,7 @@ import com.google.gson.Gson
 import com.google.gson.reflect.TypeToken
 import com.theveloper.pixelplay.data.backup.model.BackupHistoryEntry
 import com.theveloper.pixelplay.di.BackupGson
+import timber.log.Timber
 import kotlinx.coroutines.flow.Flow
 import kotlinx.coroutines.flow.map
 import javax.inject.Inject
@@ -30,7 +31,8 @@ class BackupHistoryRepository @Inject constructor(
         if (json != null) {
             try {
                 gson.fromJson<List<BackupHistoryEntry>>(json, listType)
-            } catch (_: Exception) {
+            } catch (e: Exception) {
+                Timber.w(e, "Failed to parse backup history")
                 emptyList()
             }
         } else {
@@ -68,7 +70,8 @@ class BackupHistoryRepository @Inject constructor(
         val json = preferences[BACKUP_HISTORY_KEY] ?: return emptyList()
         return try {
             gson.fromJson(json, listType)
-        } catch (_: Exception) {
+        } catch (e: Exception) {
+            Timber.w(e, "Failed to read backup history")
             emptyList()
         }
     }

app/src/main/java/com/theveloper/pixelplay/data/database/PixelPlayDatabase.kt

@@ -3,6 +3,7 @@ package com.theveloper.pixelplay.data.database
 import androidx.room.Database
 import androidx.room.RoomDatabase
 import androidx.room.migration.Migration
+import timber.log.Timber
 import androidx.sqlite.db.SupportSQLiteDatabase
 
 @Database(
@@ -759,9 +760,8 @@ abstract class PixelPlayDatabase : RoomDatabase() {
 
             try {
                 db.execSQL("ALTER TABLE songs ADD COLUMN date_added INTEGER NOT NULL DEFAULT 0")
-            } catch (_: Exception) {
-                // Some restored databases report the right version but still carry
-                // a drifted songs table. If ALTER TABLE did not stick, rebuild it.
+            } catch (e: Exception) {
+                Timber.w(e, "ALTER TABLE songs ADD date_added failed; will recreate table")
             }
 
             if ("date_added" !in getTableColumns(db, "songs")) {
@@ -1133,8 +1133,8 @@ abstract class PixelPlayDatabase : RoomDatabase() {
             if ("disc_number" !in columns) {
                 try {
                     db.execSQL("ALTER TABLE songs ADD COLUMN disc_number INTEGER DEFAULT null")
-                } catch (_: Exception) {
-                    // Restored/drifted databases may already contain a partially applied column.
+                } catch (e: Exception) {
+                    Timber.w(e, "ALTER TABLE songs ADD disc_number failed; may already exist")
                 }
             }
 

app/src/main/java/com/theveloper/pixelplay/data/database/SongEntity.kt

@@ -3,6 +3,7 @@ package com.theveloper.pixelplay.data.database
 import androidx.room.ColumnInfo
 import androidx.room.Entity
 import androidx.room.ForeignKey
+import timber.log.Timber
 import androidx.room.Index
 import androidx.room.PrimaryKey
 import com.theveloper.pixelplay.data.model.ArtistRef
@@ -57,15 +58,13 @@ object SourceType {
             entity = AlbumEntity::class,
             parentColumns = ["id"],
             childColumns = ["album_id"],
-            onDelete = ForeignKey.CASCADE // Si un álbum se borra, sus canciones también
+            onDelete = ForeignKey.CASCADE // Deleting an album cascades to its songs
         ),
         ForeignKey(
             entity = ArtistEntity::class,
             parentColumns = ["id"],
             childColumns = ["artist_id"],
-            onDelete = ForeignKey.SET_NULL // Si un artista se borra, el artist_id de la canción se pone a null
-                                          // o podrías elegir CASCADE si las canciones no deben existir sin artista.
-                                          // SET_NULL es más flexible si las canciones pueden ser de "Artista Desconocido".
+            onDelete = ForeignKey.SET_NULL // Nullify artist_id when artist is deleted (keeps song as "Unknown Artist")
         )
     ]
 )
@@ -76,7 +75,7 @@ data class SongEntity(
     @ColumnInfo(name = "artist_id") val artistId: Long, // Primary artist ID for backward compatibility
     @ColumnInfo(name = "album_artist") val albumArtist: String? = null, // Album artist from metadata
     @ColumnInfo(name = "album_name") val albumName: String,
-    @ColumnInfo(name = "album_id") val albumId: Long, // index = true eliminado
+    @ColumnInfo(name = "album_id") val albumId: Long,
     @ColumnInfo(name = "content_uri_string") val contentUriString: String,
     @ColumnInfo(name = "album_art_uri_string") val albumArtUriString: String?,
     @ColumnInfo(name = "duration") val duration: Long,
@@ -171,7 +170,8 @@ private fun parseArtistsJson(json: String?): List<ArtistRef> {
                 isPrimary = obj.optBoolean("primary", false)
             )
         }
-    } catch (_: Exception) {
+    } catch (e: Exception) {
+        Timber.w(e, "Failed to parse artist refs JSON")
         emptyList()
     }
 }
@@ -212,9 +212,8 @@ fun List<SongEntity>.toSongs(): List<Song> {
     return this.map { it.toSong() }
 }
 
-// El modelo Song usa id como String, pero la entidad lo necesita como Long (de MediaStore)
-// El modelo Song no tiene filePath, así que no se puede mapear desde ahí directamente.
-// filePath y parentDirectoryPath se poblarán desde MediaStore en el SyncWorker.
+// Song model uses String id but the entity needs Long (from MediaStore).
+// filePath and parentDirectoryPath are populated from MediaStore in SyncWorker.
 fun Song.toEntity(filePathFromMediaStore: String, parentDirFromMediaStore: String): SongEntity {
     return SongEntity(
         id = this.id.toLong(),
@@ -252,8 +251,7 @@ data class SongSummary(
     val duration: Long
 )
 
-// Sobrecarga o alternativa si los paths no están disponibles o no son necesarios al convertir de Modelo a Entidad
-// (menos probable que se use si la entidad siempre requiere los paths)
+// Fallback when file paths are unavailable during Song-to-Entity conversion.
 fun Song.toEntityWithoutPaths(): SongEntity {
     return SongEntity(
         id = this.id.toLong(),