feat(device-logs): add live in-app log viewer

Replaces the export-only "Export Logs" entry in Advanced Features with a
live-streaming "Device Logs" screen. Log lines are tee'd from FileTree
through a SharedFlow (post PII/RPC filtering) into a new feature module
that renders them in a monospace LazyColumn with filter, pause/resume,
clear, and share controls.

- Selectable text buffer and case-insensitive filter-match highlighting
- Auto-scroll to tail, gated by pause state
- Bounded 1000-line ring buffer at both the SharedFlow replay cache and
  the ViewModel state layers

Signed-off-by: Brandon McAnsh <git@bmcreations.dev>

Author: bmc08gt

apps/flipcash/app/build.gradle.kts

@@ -170,6 +170,7 @@ dependencies {
     implementation(project(":apps:flipcash:features:menu"))
     implementation(project(":apps:flipcash:features:lab"))
     implementation(project(":apps:flipcash:features:advanced"))
+    implementation(project(":apps:flipcash:features:device-logs"))
     implementation(project(":apps:flipcash:features:appsettings"))
     implementation(project(":apps:flipcash:features:appupdates"))
     implementation(project(":apps:flipcash:features:deposit"))

apps/flipcash/app/src/main/kotlin/com/flipcash/app/internal/ui/navigation/AppScreenContent.kt

@@ -20,6 +20,7 @@ import androidx.navigation3.scene.OverlayScene
 import androidx.navigation3.scene.SinglePaneSceneStrategy
 import com.flipcash.app.advanced.AdvancedFeaturesScreen
 import com.flipcash.app.appsettings.AppSettingsScreen
+import com.flipcash.app.devicelogs.DeviceLogsScreen
 import com.flipcash.app.backupkey.BackupKeyScreen
 import com.flipcash.app.balance.BalanceScreen
 import com.flipcash.app.cash.CashScreen
@@ -149,6 +150,7 @@ fun appEntryProvider(
     annotatedEntry<AppRoute.Menu.Deposit> { key -> DepositScreen(key.mint) }
     annotatedEntry<AppRoute.Menu.BackupKey> { BackupKeyScreen() }
     annotatedEntry<AppRoute.Menu.AdvancedFeatures> { AdvancedFeaturesScreen() }
+    annotatedEntry<AppRoute.Menu.DeviceLogs> { DeviceLogsScreen() }
 
     annotatedEntry<AppRoute.UserFlags> { UserFlagsScreen() }
     // Transfers

apps/flipcash/core/src/main/kotlin/com/flipcash/app/core/AppRoute.kt

@@ -167,6 +167,8 @@ sealed interface AppRoute : NavKey, Parcelable {
         @Serializable
         data object AdvancedFeatures : Menu
         @Serializable
+        data object DeviceLogs : Menu
+        @Serializable
         data object Lab : Menu
     }
 

apps/flipcash/core/src/main/res/values/strings.xml

@@ -364,7 +364,13 @@
     <string name="description_noTransactionHistory">Your recent activity will appear here when you send or receive money</string>
 
     <string name="title_billCustomizer">Bill Creator</string>
-    <string name="title_exportLogs">Export Logs</string>
+    <string name="title_deviceLogs">Application Logs</string>
+    <string name="action_clearLogs">Clear</string>
+    <string name="action_shareLogs">Share</string>
+    <string name="hint_filterLogs">Filter logs</string>
+    <string name="label_streamLive">Live</string>
+    <string name="label_streamPaused">Paused</string>
+    <string name="label_pausedBacklog">Paused • %1$d new</string>
 
     <string name="error_title_CashReturnedToWallet">Something Went Wrong</string>
     <string name="error_description_CashReturnedToWallet">The cash was returned to your wallet</string>

apps/flipcash/features/advanced/build.gradle.kts

@@ -7,6 +7,7 @@ android {
 }
 
 dependencies {
+    implementation(project(":apps:flipcash:features:device-logs"))
     implementation(project(":apps:flipcash:shared:bill-customization"))
     implementation(project(":apps:flipcash:shared:featureflags"))
     implementation(project(":apps:flipcash:shared:menu"))

apps/flipcash/features/advanced/src/main/kotlin/com/flipcash/app/advanced/AdvancedFeaturesScreen.kt

@@ -6,19 +6,16 @@ import androidx.compose.runtime.Composable
 import androidx.compose.runtime.LaunchedEffect
 import androidx.compose.ui.Alignment
 import androidx.compose.ui.Modifier
-import androidx.compose.ui.platform.LocalContext
 import androidx.compose.ui.res.stringResource
 import androidx.hilt.navigation.compose.hiltViewModel
 import com.flipcash.app.advanced.internal.AdvancedFeaturesScreen
 import com.flipcash.app.advanced.internal.AdvancedFeaturesScreenViewModel
 import com.flipcash.app.bill.customization.LocalBillPlaygroundController
-import com.flipcash.app.core.android.IntentUtils
 import com.flipcash.core.R
 import com.getcode.navigation.core.LocalCodeNavigator
 import com.getcode.opencode.model.financial.Token
 import com.getcode.opencode.model.financial.usdf
 import com.getcode.ui.components.AppBarWithTitle
-import com.getcode.utils.TraceManager
 import kotlinx.coroutines.flow.filterIsInstance
 import kotlinx.coroutines.flow.launchIn
 import kotlinx.coroutines.flow.onEach
@@ -28,7 +25,6 @@ fun AdvancedFeaturesScreen() {
     val navigator = LocalCodeNavigator.current
     val billPlayground = LocalBillPlaygroundController.current
     val viewModel = hiltViewModel<AdvancedFeaturesScreenViewModel>()
-    val context = LocalContext.current
 
     Column(
         modifier = Modifier.fillMaxSize(),
@@ -61,17 +57,4 @@ fun AdvancedFeaturesScreen() {
             }
             .launchIn(this)
     }
-
-    LaunchedEffect(viewModel) {
-        viewModel.eventFlow
-            .filterIsInstance<AdvancedFeaturesScreenViewModel.Event.ExportLogs>()
-            .onEach {
-                val logFile = TraceManager.getLogFile()
-                if (logFile != null) {
-                    val intent = IntentUtils.shareFile(context, logFile, "text/plain")
-                    context.startActivity(intent)
-                }
-            }
-            .launchIn(this)
-    }
 }

apps/flipcash/features/advanced/src/main/kotlin/com/flipcash/app/advanced/internal/AdvancedFeatureMenuItems.kt

@@ -1,8 +1,8 @@
 package com.flipcash.app.advanced.internal
 
 import androidx.compose.material.icons.Icons
+import androidx.compose.material.icons.outlined.Description
 import androidx.compose.material.icons.outlined.Palette
-import androidx.compose.material.icons.outlined.Share
 import androidx.compose.runtime.Composable
 import androidx.compose.ui.graphics.painter.Painter
 import androidx.compose.ui.graphics.vector.rememberVectorPainter
@@ -31,10 +31,11 @@ internal data object Deposit : FullMenuItem<AdvancedFeaturesScreenViewModel.Even
     )
 }
 
-internal data object ExportLogs : FullMenuItem<AdvancedFeaturesScreenViewModel.Event>() {
+internal data object DeviceLogs : FullMenuItem<AdvancedFeaturesScreenViewModel.Event>() {
     override val icon: Painter
-        @Composable get() = rememberVectorPainter(Icons.Outlined.Share)
+        @Composable get() = rememberVectorPainter(Icons.Outlined.Description)
     override val name: String
-        @Composable get() = stringResource(R.string.title_exportLogs)
-    override val action: AdvancedFeaturesScreenViewModel.Event = AdvancedFeaturesScreenViewModel.Event.ExportLogs
+        @Composable get() = stringResource(R.string.title_deviceLogs)
+    override val action: AdvancedFeaturesScreenViewModel.Event =
+        AdvancedFeaturesScreenViewModel.Event.OpenScreen(AppRoute.Menu.DeviceLogs)
 }

apps/flipcash/features/advanced/src/main/kotlin/com/flipcash/app/advanced/internal/AdvancedFeaturesScreenViewModel.kt

@@ -20,7 +20,7 @@ import javax.inject.Inject
 private val FullMenuList = buildList {
     add(BillCustomizer)
     add(Deposit)
-    add(ExportLogs)
+    add(DeviceLogs)
 }
 
 @HiltViewModel
@@ -45,7 +45,6 @@ internal class AdvancedFeaturesScreenViewModel @Inject constructor(
         data class OpenScreen(val screen: AppRoute) : Event
 
         data object OpenBillPlayground: Event
-        data object ExportLogs: Event
     }
 
     init {
@@ -85,7 +84,6 @@ internal class AdvancedFeaturesScreenViewModel @Inject constructor(
 
                 is Event.OpenScreen -> { state -> state }
                 is Event.OpenBillPlayground -> { state -> state }
-                is Event.ExportLogs -> { state -> state }
             }
         }
     }

apps/flipcash/features/device-logs/.gitignore

@@ -0,0 +1,2 @@
+build/
+.gradle/

apps/flipcash/features/device-logs/build.gradle.kts

@@ -0,0 +1,11 @@
+plugins {
+    alias(libs.plugins.flipcash.android.feature)
+}
+
+android {
+    namespace = "${Gradle.flipcashNamespace}.features.devicelogs"
+}
+
+dependencies {
+    implementation(project(":libs:logging"))
+}