feat: Traceroute map visualisation

app/src/main/java/com/geeksville/mesh/model/UIState.kt

@@ -52,10 +52,13 @@ import org.meshtastic.core.data.repository.PacketRepository
 import org.meshtastic.core.database.entity.MyNodeEntity
 import org.meshtastic.core.database.entity.asDeviceVersion
 import org.meshtastic.core.datastore.UiPreferencesDataSource
+import org.meshtastic.core.model.TracerouteMapAvailability
+import org.meshtastic.core.model.evaluateTracerouteMapAvailability
 import org.meshtastic.core.model.util.toChannelSet
 import org.meshtastic.core.service.IMeshService
 import org.meshtastic.core.service.MeshServiceNotifications
 import org.meshtastic.core.service.ServiceRepository
+import org.meshtastic.core.service.TracerouteResponse
 import org.meshtastic.core.strings.Res
 import org.meshtastic.core.strings.client_notification
 import org.meshtastic.core.ui.component.ScrollToTopEvent
@@ -152,6 +155,14 @@ constructor(
     private val _currentAlert: MutableStateFlow<AlertData?> = MutableStateFlow(null)
     val currentAlert = _currentAlert.asStateFlow()
 
+    fun tracerouteMapAvailability(forwardRoute: List<Int>, returnRoute: List<Int>): TracerouteMapAvailability =
+        evaluateTracerouteMapAvailability(
+            forwardRoute = forwardRoute,
+            returnRoute = returnRoute,
+            positionedNodeNums =
+            nodeDB.nodeDBbyNum.value.values.filter { it.validPosition != null }.map { it.num }.toSet(),
+        )
+
     fun showAlert(
         title: String,
         message: String? = null,
@@ -248,7 +259,7 @@ constructor(
         Timber.d("ViewModel cleared")
     }
 
-    val tracerouteResponse: LiveData<String?>
+    val tracerouteResponse: LiveData<TracerouteResponse?>
         get() = serviceRepository.tracerouteResponse.asLiveData()
 
     fun clearTracerouteResponse() {

app/src/main/java/com/geeksville/mesh/navigation/NodesNavigation.kt

@@ -67,6 +67,7 @@ import org.meshtastic.feature.node.metrics.PositionLogScreen
 import org.meshtastic.feature.node.metrics.PowerMetricsScreen
 import org.meshtastic.feature.node.metrics.SignalMetricsScreen
 import org.meshtastic.feature.node.metrics.TracerouteLogScreen
+import org.meshtastic.feature.node.metrics.TracerouteMapScreen
 import kotlin.reflect.KClass
 
 fun NavGraphBuilder.nodesGraph(navController: NavHostController, scrollToTopEvents: Flow<ScrollToTopEvent>) {
@@ -121,6 +122,54 @@ fun NavGraphBuilder.nodeDetailGraph(navController: NavHostController, scrollToTo
             NodeMapScreen(vm, onNavigateUp = navController::navigateUp)
         }
 
+        composable<NodeDetailRoutes.TracerouteLog>(
+            deepLinks =
+            listOf(
+                navDeepLink<NodeDetailRoutes.TracerouteLog>(
+                    basePath = "$DEEP_LINK_BASE_URI/node/{destNum}/traceroute",
+                ),
+                navDeepLink<NodeDetailRoutes.TracerouteLog>(basePath = "$DEEP_LINK_BASE_URI/node/traceroute"),
+            ),
+        ) { backStackEntry ->
+            val parentGraphBackStackEntry =
+                remember(backStackEntry) { navController.getBackStackEntry(NodesRoutes.NodeDetailGraph::class) }
+            val metricsViewModel = hiltViewModel<MetricsViewModel>(parentGraphBackStackEntry)
+
+            val args = backStackEntry.toRoute<NodeDetailRoutes.TracerouteLog>()
+            metricsViewModel.setNodeId(args.destNum)
+
+            TracerouteLogScreen(
+                viewModel = metricsViewModel,
+                onNavigateUp = navController::navigateUp,
+                onViewOnMap = { requestId ->
+                    navController.navigate(NodeDetailRoutes.TracerouteMap(args.destNum, requestId))
+                },
+            )
+        }
+
+        composable<NodeDetailRoutes.TracerouteMap>(
+            deepLinks =
+            listOf(
+                navDeepLink<NodeDetailRoutes.TracerouteMap>(
+                    basePath = "$DEEP_LINK_BASE_URI/node/{destNum}/traceroute_map",
+                ),
+                navDeepLink<NodeDetailRoutes.TracerouteMap>(basePath = "$DEEP_LINK_BASE_URI/node/traceroute_map"),
+            ),
+        ) { backStackEntry ->
+            val parentGraphBackStackEntry =
+                remember(backStackEntry) { navController.getBackStackEntry(NodesRoutes.NodeDetailGraph::class) }
+            val metricsViewModel = hiltViewModel<MetricsViewModel>(parentGraphBackStackEntry)
+
+            val args = backStackEntry.toRoute<NodeDetailRoutes.TracerouteMap>()
+            metricsViewModel.setNodeId(args.destNum)
+
+            TracerouteMapScreen(
+                metricsViewModel = metricsViewModel,
+                requestId = args.requestId,
+                onNavigateUp = navController::navigateUp,
+            )
+        }
+
         NodeDetailRoute.entries.forEach { entry ->
             when (entry.routeClass) {
                 NodeDetailRoutes.DeviceMetrics::class ->
@@ -163,14 +212,6 @@ fun NavGraphBuilder.nodeDetailGraph(navController: NavHostController, scrollToTo
                     ) {
                         it.destNum
                     }
-                NodeDetailRoutes.TracerouteLog::class ->
-                    addNodeDetailScreenComposable<NodeDetailRoutes.TracerouteLog>(
-                        navController,
-                        entry,
-                        entry.screenComposable,
-                    ) {
-                        it.destNum
-                    }
                 NodeDetailRoutes.HostMetricsLog::class ->
                     addNodeDetailScreenComposable<NodeDetailRoutes.HostMetricsLog>(
                         navController,

app/src/main/java/com/geeksville/mesh/service/MeshService.kt

@@ -80,6 +80,7 @@ import org.meshtastic.core.model.MessageStatus
 import org.meshtastic.core.model.MyNodeInfo
 import org.meshtastic.core.model.NodeInfo
 import org.meshtastic.core.model.Position
+import org.meshtastic.core.model.fullRouteDiscovery
 import org.meshtastic.core.model.getFullTracerouteResponse
 import org.meshtastic.core.model.util.anonymize
 import org.meshtastic.core.model.util.toOneLineString
@@ -92,6 +93,7 @@ import org.meshtastic.core.service.MeshServiceNotifications
 import org.meshtastic.core.service.SERVICE_NOTIFY_ID
 import org.meshtastic.core.service.ServiceAction
 import org.meshtastic.core.service.ServiceRepository
+import org.meshtastic.core.service.TracerouteResponse
 import org.meshtastic.core.strings.Res
 import org.meshtastic.core.strings.connected_count
 import org.meshtastic.core.strings.connecting
@@ -927,11 +929,12 @@ class MeshService : Service() {
 
                     Portnums.PortNum.TRACEROUTE_APP_VALUE -> {
                         Timber.d("Received TRACEROUTE_APP from $fromId")
+                        val routeDiscovery = packet.fullRouteDiscovery
                         val full = packet.getFullTracerouteResponse(::getUserName)
                         if (full != null) {
                             val requestId = packet.decoded.requestId
                             val start = tracerouteStartTimes.remove(requestId)
-                            val response =
+                            val responseText =
                                 if (start != null) {
                                     val elapsedMs = System.currentTimeMillis() - start
                                     val seconds = elapsedMs / 1000.0
@@ -940,7 +943,19 @@ class MeshService : Service() {
                                 } else {
                                     full
                                 }
-                            serviceRepository.setTracerouteResponse(response)
+                            val destination =
+                                routeDiscovery?.routeList?.firstOrNull()
+                                    ?: routeDiscovery?.routeBackList?.lastOrNull()
+                                    ?: 0
+                            serviceRepository.setTracerouteResponse(
+                                TracerouteResponse(
+                                    message = responseText,
+                                    destinationNodeNum = destination,
+                                    requestId = requestId,
+                                    forwardRoute = routeDiscovery?.routeList.orEmpty(),
+                                    returnRoute = routeDiscovery?.routeBackList.orEmpty(),
+                                ),
+                            )
                         }
                     }
 

app/src/main/java/com/geeksville/mesh/ui/Main.kt

@@ -106,9 +106,11 @@ import org.jetbrains.compose.resources.StringResource
 import org.jetbrains.compose.resources.getString
 import org.jetbrains.compose.resources.stringResource
 import org.meshtastic.core.model.DeviceVersion
+import org.meshtastic.core.model.toMessageRes
 import org.meshtastic.core.navigation.ConnectionsRoutes
 import org.meshtastic.core.navigation.ContactsRoutes
 import org.meshtastic.core.navigation.MapRoutes
+import org.meshtastic.core.navigation.NodeDetailRoutes
 import org.meshtastic.core.navigation.NodesRoutes
 import org.meshtastic.core.navigation.Route
 import org.meshtastic.core.navigation.SettingsRoutes
@@ -117,6 +119,7 @@ import org.meshtastic.core.strings.Res
 import org.meshtastic.core.strings.app_too_old
 import org.meshtastic.core.strings.bottom_nav_settings
 import org.meshtastic.core.strings.client_notification
+import org.meshtastic.core.strings.close
 import org.meshtastic.core.strings.compromised_keys
 import org.meshtastic.core.strings.connected
 import org.meshtastic.core.strings.connecting
@@ -133,6 +136,7 @@ import org.meshtastic.core.strings.okay
 import org.meshtastic.core.strings.should_update
 import org.meshtastic.core.strings.should_update_firmware
 import org.meshtastic.core.strings.traceroute
+import org.meshtastic.core.strings.view_on_map
 import org.meshtastic.core.ui.component.MultipleChoiceAlertDialog
 import org.meshtastic.core.ui.component.ScrollToTopEvent
 import org.meshtastic.core.ui.component.SimpleAlertDialog
@@ -239,16 +243,49 @@ fun MainScreen(uIViewModel: UIViewModel = hiltViewModel(), scanModel: BTScanMode
     }
 
     val traceRouteResponse by uIViewModel.tracerouteResponse.observeAsState()
-    traceRouteResponse?.let { response ->
+    var tracerouteMapError by remember { mutableStateOf<StringResource?>(null) }
+    var dismissedTracerouteRequestId by remember { mutableStateOf<Int?>(null) }
+    traceRouteResponse
+        ?.takeIf { it.requestId != dismissedTracerouteRequestId }
+        ?.let { response ->
+            SimpleAlertDialog(
+                title = Res.string.traceroute,
+                text = {
+                    Column(modifier = Modifier.verticalScroll(rememberScrollState())) {
+                        Text(text = annotateTraceroute(response.message))
+                    }
+                },
+                confirmText = stringResource(Res.string.view_on_map),
+                onConfirm = {
+                    val availability =
+                        uIViewModel.tracerouteMapAvailability(
+                            forwardRoute = response.forwardRoute,
+                            returnRoute = response.returnRoute,
+                        )
+                    val errorRes = availability.toMessageRes()
+                    if (errorRes == null) {
+                        dismissedTracerouteRequestId = response.requestId
+                        navController.navigate(
+                            NodeDetailRoutes.TracerouteMap(response.destinationNodeNum, response.requestId),
+                        )
+                    } else {
+                        tracerouteMapError = errorRes
+                        uIViewModel.clearTracerouteResponse()
+                    }
+                },
+                dismissText = stringResource(Res.string.okay),
+                onDismiss = {
+                    uIViewModel.clearTracerouteResponse()
+                    dismissedTracerouteRequestId = null
+                },
+            )
+        }
+    tracerouteMapError?.let { res ->
         SimpleAlertDialog(
             title = Res.string.traceroute,
-            text = {
-                Column(modifier = Modifier.verticalScroll(rememberScrollState())) {
-                    Text(text = annotateTraceroute(response))
-                }
-            },
-            dismissText = stringResource(Res.string.okay),
-            onDismiss = { uIViewModel.clearTracerouteResponse() },
+            text = { Text(text = stringResource(res)) },
+            dismissText = stringResource(Res.string.close),
+            onDismiss = { tracerouteMapError = null },
         )
     }
     val navSuiteType = NavigationSuiteScaffoldDefaults.navigationSuiteType(currentWindowAdaptiveInfo())

core/model/src/main/kotlin/org/meshtastic/core/model/RouteDiscovery.kt

@@ -17,6 +17,10 @@
 
 package org.meshtastic.core.model
 
+import org.jetbrains.compose.resources.StringResource
+import org.meshtastic.core.strings.Res
+import org.meshtastic.core.strings.traceroute_endpoint_missing
+import org.meshtastic.core.strings.traceroute_map_no_data
 import org.meshtastic.proto.MeshProtos
 import org.meshtastic.proto.MeshProtos.RouteDiscovery
 import org.meshtastic.proto.Portnums
@@ -28,11 +32,13 @@ val MeshProtos.MeshPacket.fullRouteDiscovery: RouteDiscovery?
                 runCatching { RouteDiscovery.parseFrom(payload).toBuilder() }
                     .getOrNull()
                     ?.apply {
-                        val fullRoute = listOf(to) + routeList + from
+                        val destinationId = dest.takeIf { it != 0 } ?: this@fullRouteDiscovery.to
+                        val sourceId = source.takeIf { it != 0 } ?: this@fullRouteDiscovery.from
+                        val fullRoute = listOf(destinationId) + routeList + sourceId
                         clearRoute()
                         addAllRoute(fullRoute)
 
-                        val fullRouteBack = listOf(from) + routeBackList + to
+                        val fullRouteBack = listOf(sourceId) + routeBackList + destinationId
                         clearRouteBack()
                         if (hopStart > 0 && snrBackCount > 0) { // otherwise back route is invalid
                             addAllRouteBack(fullRouteBack)
@@ -85,3 +91,35 @@ fun MeshProtos.MeshPacket.getTracerouteResponse(getUser: (nodeNum: Int) -> Strin
 fun MeshProtos.MeshPacket.getFullTracerouteResponse(getUser: (nodeNum: Int) -> String): String? = fullRouteDiscovery
     ?.takeIf { it.routeList.isNotEmpty() && it.routeBackList.isNotEmpty() }
     ?.getTracerouteResponse(getUser)
+
+enum class TracerouteMapAvailability {
+    Ok,
+    MissingEndpoints,
+    NoMappableNodes,
+}
+
+fun evaluateTracerouteMapAvailability(
+    forwardRoute: List<Int>,
+    returnRoute: List<Int>,
+    positionedNodeNums: Set<Int>,
+): TracerouteMapAvailability {
+    val endpoints =
+        listOfNotNull(
+            forwardRoute.firstOrNull(),
+            forwardRoute.lastOrNull(),
+            returnRoute.firstOrNull(),
+            returnRoute.lastOrNull(),
+        )
+            .distinct()
+    val missingEndpoint = endpoints.any { !positionedNodeNums.contains(it) }
+    if (missingEndpoint) return TracerouteMapAvailability.MissingEndpoints
+    val relatedNodeNums = (forwardRoute + returnRoute).toSet()
+    val hasAnyMappable = relatedNodeNums.any { positionedNodeNums.contains(it) }
+    return if (hasAnyMappable) TracerouteMapAvailability.Ok else TracerouteMapAvailability.NoMappableNodes
+}
+
+fun TracerouteMapAvailability.toMessageRes(): StringResource? = when (this) {
+    TracerouteMapAvailability.Ok -> null
+    TracerouteMapAvailability.MissingEndpoints -> Res.string.traceroute_endpoint_missing
+    TracerouteMapAvailability.NoMappableNodes -> Res.string.traceroute_map_no_data
+}

core/navigation/src/main/kotlin/org/meshtastic/core/navigation/Routes.kt

@@ -78,6 +78,8 @@ object NodeDetailRoutes {
 
     @Serializable data class TracerouteLog(val destNum: Int) : Route
 
+    @Serializable data class TracerouteMap(val destNum: Int, val requestId: Int) : Route
+
     @Serializable data class HostMetricsLog(val destNum: Int) : Route
 
     @Serializable data class PaxMetrics(val destNum: Int) : Route

core/service/src/main/kotlin/org/meshtastic/core/service/ServiceRepository.kt

@@ -29,6 +29,17 @@ import timber.log.Timber
 import javax.inject.Inject
 import javax.inject.Singleton
 
+data class TracerouteResponse(
+    val message: String,
+    val destinationNodeNum: Int,
+    val requestId: Int,
+    val forwardRoute: List<Int> = emptyList(),
+    val returnRoute: List<Int> = emptyList(),
+) {
+    val hasOverlay: Boolean
+        get() = forwardRoute.isNotEmpty() || returnRoute.isNotEmpty()
+}
+
 /** Repository class for managing the [IMeshService] instance and connection state */
 @Suppress("TooManyFunctions")
 @Singleton
@@ -94,11 +105,11 @@ class ServiceRepository @Inject constructor() {
         _meshPacketFlow.emit(packet)
     }
 
-    private val _tracerouteResponse = MutableStateFlow<String?>(null)
-    val tracerouteResponse: StateFlow<String?>
+    private val _tracerouteResponse = MutableStateFlow<TracerouteResponse?>(null)
+    val tracerouteResponse: StateFlow<TracerouteResponse?>
         get() = _tracerouteResponse
 
-    fun setTracerouteResponse(value: String?) {
+    fun setTracerouteResponse(value: TracerouteResponse?) {
         _tracerouteResponse.value = value
     }
 

core/strings/src/commonMain/composeResources/values/strings.xml

@@ -405,6 +405,12 @@
         <item quantity="other">%1$d hops</item>
     </plurals>
     <string name="traceroute_diff">Hops towards %1$d Hops back %2$d</string>
+    <string name="traceroute_outgoing_route">Outgoing route</string>
+    <string name="traceroute_return_route">Return route</string>
+    <string name="traceroute_endpoint_missing">Cannot show traceroute map because the start or destination node has no position information.</string>
+    <string name="view_on_map">View on map</string>
+    <string name="traceroute_map_no_data">This traceroute does not have any mappable nodes yet.</string>
+    <string name="traceroute_showing_nodes">Showing %1$d/%2$d nodes</string>
     <string name="twenty_four_hours">24H</string>
     <string name="forty_eight_hours">48H</string>
     <string name="one_week">1W</string>
@@ -1030,8 +1036,8 @@
         <item quantity="one">1 hour</item>
         <item quantity="other">%1$d hours</item>
     </plurals>
-  
-  <!-- Compass -->
+
+    <!-- Compass -->
     <string name="compass_title">Compass</string>
     <string name="open_compass">Open Compass</string>
     <string name="compass_distance">Distance: %1$s</string>

core/ui/src/main/kotlin/org/meshtastic/core/ui/theme/CustomColors.kt

@@ -27,6 +27,13 @@ val MeshtasticAlt = Color(0xFF2C2D3C)
 val HyperlinkBlue = Color(0xFF43C3B0)
 val AnnotationColor = Color(0xFF039BE5)
 
+object TracerouteColors {
+    // High-contrast pair that stays legible on light/dark tiles and for most color-blind users.
+    // Use partial alpha so polylines don’t overpower markers/tiles.
+    val OutgoingRoute = Color(0xCCE86A00) // orange @ ~80% opacity
+    val ReturnRoute = Color(0xCC0081C7) // cyan @ ~80% opacity
+}
+
 object IAQColors {
     val IAQExcellent = Color(0xFF00E400)
     val IAQGood = Color(0xFF92D050)