v4.6.0: Latency sparkline, source stats, search history, query type chart

SysAdminDoc · SysAdminDoc · commit c1ad2aa71c13 · 2026-03-20T19:55:48.000-04:00
- Home: DNS latency sparkline (live mini-graph of last 20 response times)
- Home: Average latency display next to query rate (e.g. "42 ms")
- Home: Search history chips (last 6 recent searches from DataStore)
- Sources: Summary stats row (total domains, total size, unhealthy count)
- Stats: Query type distribution chart with color-coded bars
- AppPreferences: search history (10 entries, DataStore-persisted)
- DAO: getQueryTypeDistribution + QueryTypeStat projection
diff --git a/CLAUDE.md b/CLAUDE.md
@@ -1,7 +1,7 @@
 # HostShield
 
 ## Overview
-Modern, AMOLED-dark hosts-based ad blocker app for Android. Inspired by AdAway. v4.5.0.
+Modern, AMOLED-dark hosts-based ad blocker app for Android. Inspired by AdAway. v4.6.0.
 
 ## Tech Stack
 - Kotlin, Jetpack Compose, Material 3
@@ -70,6 +70,7 @@ cd app
 - Secrets configured: `KEYSTORE_BASE64`, `KEY_ALIAS`, `KEY_PASSWORD`, `STORE_PASSWORD`
 
 ## Version History
+- v4.6.0: DNS latency sparkline on Home (live response time mini-graph), source summary stats on Sources screen (total domains, size, unhealthy count), search history persistence (DataStore, 10 recent, chip display), search history chips on Home
 - v4.5.0: Query type distribution chart in Stats (A/AAAA/CNAME/MX bar chart), per-app DNS log drill-down (AppLogsScreen with domains + timeline tabs), permanent block/allow buttons in log detail sheet, log cleanup worker improved (6h interval, battery-not-low constraint)
 - v4.4.0: Connection log interface labels (rmnet0=Mobile, wlan0=WiFi, etc), DNS cache management in Settings (clear cache button + live stats), expanded notification (Pause 5m / Pause 30m / Stop), top querying apps mini-card on Home dashboard
 - v4.3.2: UI fixes — FlowRow wrapping for category chips (was smushed in single Row), larger text fields (search bar, custom DNS), FlowRow for DoH provider selector and feature pills, removed fixed heights that clipped text
diff --git a/app/app/build.gradle.kts b/app/app/build.gradle.kts
@@ -1,4 +1,4 @@
-// HostShield v4.5.0
+// HostShield v4.6.0
 plugins {
     id("com.android.application")
     id("org.jetbrains.kotlin.android")
@@ -15,8 +15,8 @@ android {
         applicationId = "com.hostshield"
         minSdk = 26
         targetSdk = 35
-        versionCode = 47
-        versionName = "4.5.0"
+        versionCode = 48
+        versionName = "4.6.0"
 
         testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
 
diff --git a/app/app/src/main/java/com/hostshield/data/preferences/AppPreferences.kt b/app/app/src/main/java/com/hostshield/data/preferences/AppPreferences.kt
@@ -241,4 +241,25 @@ class AppPreferences @Inject constructor(
         return if (raw.isBlank()) emptyList()
         else raw.split(",").map { it.trim() }.filter { it.startsWith("http") }
     }
+
+    // ── Search History ────────────────────────────────────────
+    private object SearchKeys {
+        val SEARCH_HISTORY = stringPreferencesKey("search_history")
+    }
+
+    val searchHistory: Flow<List<String>> = ds.data.map {
+        (it[SearchKeys.SEARCH_HISTORY] ?: "").split("\n").filter { s -> s.isNotBlank() }
+    }
+
+    suspend fun addSearchQuery(query: String) {
+        val trimmed = query.trim().lowercase()
+        if (trimmed.length < 2) return
+        ds.edit {
+            val current = (it[SearchKeys.SEARCH_HISTORY] ?: "").split("\n").filter { s -> s.isNotBlank() }
+            val updated = (listOf(trimmed) + current.filter { s -> s != trimmed }).take(10)
+            it[SearchKeys.SEARCH_HISTORY] = updated.joinToString("\n")
+        }
+    }
+
+    suspend fun clearSearchHistory() = ds.edit { it[SearchKeys.SEARCH_HISTORY] = "" }
 }
diff --git a/app/app/src/main/java/com/hostshield/ui/screens/home/HomeScreen.kt b/app/app/src/main/java/com/hostshield/ui/screens/home/HomeScreen.kt
@@ -115,6 +115,26 @@ fun HomeScreen(
                 cursorColor = Teal, focusedTextColor = TextPrimary, unfocusedTextColor = TextPrimary
             )
         )
+        // Search history chips when field is focused but empty
+        val searchHistory by viewModel.searchHistory.collectAsStateWithLifecycle()
+        if (searchQuery.isBlank() && searchHistory.isNotEmpty()) {
+            androidx.compose.foundation.layout.FlowRow(
+                modifier = Modifier.fillMaxWidth().padding(horizontal = 20.dp, vertical = 4.dp),
+                horizontalArrangement = Arrangement.spacedBy(6.dp),
+                verticalArrangement = Arrangement.spacedBy(4.dp)
+            ) {
+                searchHistory.take(6).forEach { term ->
+                    Surface(
+                        onClick = { searchQuery = term; searchExpanded = true; viewModel.saveSearch(term) },
+                        shape = RoundedCornerShape(16.dp),
+                        color = Surface2
+                    ) {
+                        Text(term, modifier = Modifier.padding(horizontal = 10.dp, vertical = 4.dp),
+                            color = TextDim, fontSize = 11.sp)
+                    }
+                }
+            }
+        }
         AnimatedVisibility(visible = searchExpanded && searchQuery.length >= 2) {
             Column(modifier = Modifier.padding(horizontal = 20.dp, vertical = 4.dp)) {
                 Surface(
@@ -406,7 +426,7 @@ fun HomeScreen(
             }
         }
 
-        // Live query rate
+        // Live query rate + latency sparkline
         if (state.isEnabled && (state.queriesPerMinute > 0 || state.blocksPerMinute > 0)) {
             Spacer(Modifier.height(8.dp))
             Row(
@@ -419,6 +439,36 @@ fun HomeScreen(
                 Spacer(Modifier.width(16.dp))
                 Text("${state.blocksPerMinute}", color = Red, fontSize = 14.sp, fontWeight = FontWeight.Bold)
                 Text(" blk/min", color = TextDim, fontSize = 10.sp)
+                if (state.avgLatencyMs > 0) {
+                    Spacer(Modifier.width(16.dp))
+                    Text("${state.avgLatencyMs}", color = Peach, fontSize = 14.sp, fontWeight = FontWeight.Bold)
+                    Text(" ms", color = TextDim, fontSize = 10.sp)
+                }
+            }
+            // Latency sparkline
+            if (state.latencySparkline.size >= 3) {
+                Spacer(Modifier.height(6.dp))
+                Canvas(
+                    modifier = Modifier.fillMaxWidth().padding(horizontal = 40.dp).height(24.dp)
+                ) {
+                    val points = state.latencySparkline
+                    val maxVal = points.max().toFloat().coerceAtLeast(1f)
+                    val stepX = size.width / (points.size - 1).coerceAtLeast(1)
+                    val path = androidx.compose.ui.graphics.Path()
+                    points.forEachIndexed { i, v ->
+                        val x = i * stepX
+                        val y = size.height - (v / maxVal * size.height * 0.9f)
+                        if (i == 0) path.moveTo(x, y) else path.lineTo(x, y)
+                    }
+                    drawPath(
+                        path = path,
+                        color = Peach.copy(alpha = 0.6f),
+                        style = androidx.compose.ui.graphics.drawscope.Stroke(
+                            width = 2f,
+                            cap = androidx.compose.ui.graphics.StrokeCap.Round
+                        )
+                    )
+                }
             }
         }
 
diff --git a/app/app/src/main/java/com/hostshield/ui/screens/home/HomeViewModel.kt b/app/app/src/main/java/com/hostshield/ui/screens/home/HomeViewModel.kt
@@ -85,7 +85,11 @@ data class HomeUiState(
     /** Dropped queries from buffer overflow. */
     val droppedQueries: Int = 0,
     /** Top querying apps (up to 3). */
-    val topApps: List<Triple<String, String, Int>> = emptyList() // (package, label, count)
+    val topApps: List<Triple<String, String, Int>> = emptyList(), // (package, label, count)
+    /** Recent DNS latencies for sparkline (last 20 values). */
+    val latencySparkline: List<Int> = emptyList(),
+    /** Average latency from sparkline. */
+    val avgLatencyMs: Int = 0
 )
 
 @HiltViewModel
@@ -201,12 +205,19 @@ class HomeViewModel @Inject constructor(
                 val cacheStats = DnsVpnService.currentCacheStats
                 val dropped = DnsVpnService.currentDroppedQueries
 
+                // Build latency sparkline from recent entries with response times
+                val latencies = recent.filter { it.responseTimeMs > 0 && !it.blocked }
+                    .take(20).map { it.responseTimeMs }
+                val avgLatency = if (latencies.isNotEmpty()) latencies.average().toInt() else 0
+
                 _uiState.update { it.copy(
                     queriesPerMinute = recentQueries,
                     blocksPerMinute = recentBlocks,
                     queryAnomalyWarning = anomalyWarning,
                     cacheHitRate = cacheStats?.hitRate ?: 0f,
-                    droppedQueries = dropped
+                    droppedQueries = dropped,
+                    latencySparkline = latencies.reversed(), // oldest first for left-to-right
+                    avgLatencyMs = avgLatency
                 ) }
             }
         }
@@ -735,6 +746,10 @@ class HomeViewModel @Inject constructor(
 
     // -- Helpers -------------------------------------------------------
 
+    // Search history
+    val searchHistory = prefs.searchHistory.stateIn(viewModelScope, SharingStarted.WhileSubscribed(5000), emptyList())
+    fun saveSearch(query: String) { viewModelScope.launch { prefs.addSearchQuery(query) } }
+
     fun dismissError() { _uiState.update { it.copy(errorMessage = null) } }
     fun dismissSnackbar() { _uiState.update { it.copy(snackbarMessage = null) } }
     fun dismissPrivateDnsWarning() { _uiState.update { it.copy(privateDnsWarning = null) } }
diff --git a/app/app/src/main/java/com/hostshield/ui/screens/sources/SourcesScreen.kt b/app/app/src/main/java/com/hostshield/ui/screens/sources/SourcesScreen.kt
@@ -135,7 +135,40 @@ fun SourcesScreen(
                     Spacer(Modifier.height(4.dp))
                     Text(msg, color = TextDim, fontSize = 11.sp)
                 }
-                Spacer(Modifier.height(12.dp))
+                Spacer(Modifier.height(8.dp))
+
+                // Summary stats
+                val totalDomains = sources.filter { it.enabled }.sumOf { it.entryCount }
+                val totalSize = sources.filter { it.enabled }.sumOf { it.sizeBytes }
+                val unhealthy = sources.count { it.health == SourceHealth.ERROR || it.health == SourceHealth.DEAD }
+                Row(
+                    modifier = Modifier.fillMaxWidth(),
+                    horizontalArrangement = Arrangement.spacedBy(8.dp)
+                ) {
+                    Surface(shape = RoundedCornerShape(8.dp), color = Surface2, modifier = Modifier.weight(1f)) {
+                        Column(modifier = Modifier.padding(10.dp), horizontalAlignment = Alignment.CenterHorizontally) {
+                            Text(NumberFormat.getNumberInstance().format(totalDomains), color = Teal, fontWeight = FontWeight.Bold, fontSize = 14.sp)
+                            Text("Domains", color = TextDim, fontSize = 9.sp)
+                        }
+                    }
+                    Surface(shape = RoundedCornerShape(8.dp), color = Surface2, modifier = Modifier.weight(1f)) {
+                        Column(modifier = Modifier.padding(10.dp), horizontalAlignment = Alignment.CenterHorizontally) {
+                            val sizeLabel = if (totalSize > 1_000_000) "${"%.1f".format(totalSize / 1_000_000f)} MB"
+                                else if (totalSize > 1000) "${totalSize / 1000} KB" else "$totalSize B"
+                            Text(sizeLabel, color = Blue, fontWeight = FontWeight.Bold, fontSize = 14.sp)
+                            Text("Total Size", color = TextDim, fontSize = 9.sp)
+                        }
+                    }
+                    if (unhealthy > 0) {
+                        Surface(shape = RoundedCornerShape(8.dp), color = Red.copy(alpha = 0.08f), modifier = Modifier.weight(1f)) {
+                            Column(modifier = Modifier.padding(10.dp), horizontalAlignment = Alignment.CenterHorizontally) {
+                                Text("$unhealthy", color = Red, fontWeight = FontWeight.Bold, fontSize = 14.sp)
+                                Text("Unhealthy", color = Red.copy(alpha = 0.7f), fontSize = 9.sp)
+                            }
+                        }
+                    }
+                }
+                Spacer(Modifier.height(8.dp))
             }
 
             val grouped = sources.groupBy { it.category }
