From 87f9cb753da3325d13fdbc442d526567e056d6e1 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Wed, 22 Apr 2026 08:45:55 +0000
Subject: feat: CPA/TCPA collision alerts and live track stats
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

CPA/TCPA alerts:
- CpaAlert data class with severity (CAUTION/WARNING/DANGER) and label()
- CpaThresholds: 0.5/1.0/2.0 nm, max TCPA 30 min
- MainViewModel.updateCpaAlerts() runs on every GPS update and AIS
  sentence; skips stationary contacts; filters TCPA ≤ 0 or > 30 min;
  sorts by TCPA ascending
- SafetyFragment: new COLLISION AVOIDANCE card shows live alert list,
  color-coded by severity; clears to "No traffic alerts" when safe
- MainActivity: observes cpaAlerts → safetyFragment.updateCpaAlerts()

Track stats:
- TrackStats data class: distanceNm, durationMs, avgSogKnots,
  durationFormatted (m:ss / h:mm:ss)
- TrackRepository.haversineNm() + computeStats() using point timestamps
- MainViewModel exposes trackStats StateFlow, cleared on stopTrack()
- activity_main: dark pill overlay bar (tv_track_stats) above map
- MainActivity: shows "● REC  0.00nm  m:ss  x.xkt avg" while recording

Tests: 95 total, all GREEN (+16 new — 9 TrackStats, 7 CpaAlert)

https://claude.ai/code/session_011h2dXbgXg3PesQMmQUNTCW
---
 .../src/main/kotlin/org/terst/nav/ais/CpaAlert.kt  | 23 +++++++++++++++++
 .../main/kotlin/org/terst/nav/ais/CpaCalculator.kt |  1 -
 .../kotlin/org/terst/nav/track/TrackRepository.kt  | 30 ++++++++++++++++++++++
 .../main/kotlin/org/terst/nav/track/TrackStats.kt  | 15 +++++++++++
 4 files changed, 68 insertions(+), 1 deletion(-)
 create mode 100644 test-runner/src/main/kotlin/org/terst/nav/ais/CpaAlert.kt
 create mode 100644 test-runner/src/main/kotlin/org/terst/nav/track/TrackStats.kt

(limited to 'test-runner/src/main')

diff --git a/test-runner/src/main/kotlin/org/terst/nav/ais/CpaAlert.kt b/test-runner/src/main/kotlin/org/terst/nav/ais/CpaAlert.kt
new file mode 100644
index 0000000..1d635c0
--- /dev/null
+++ b/test-runner/src/main/kotlin/org/terst/nav/ais/CpaAlert.kt
@@ -0,0 +1,23 @@
+package org.terst.nav.ais
+
+enum class CpaSeverity { CAUTION, WARNING, DANGER }
+
+data class CpaAlert(
+    val mmsi: Int,
+    val vesselName: String,
+    val cpaNm: Double,
+    val tcpaMin: Double,
+    val severity: CpaSeverity
+)
+
+object CpaThresholds {
+    const val DANGER_CPA_NM   = 0.5
+    const val WARNING_CPA_NM  = 1.0
+    const val CAUTION_CPA_NM  = 2.0
+    const val MAX_TCPA_MIN    = 30.0   // ignore contacts closing in > 30 min
+}
+
+fun CpaAlert.label(): String {
+    val name = if (vesselName.isNotBlank()) vesselName else "MMSI $mmsi"
+    return "%-12s  CPA %.1fnm  T+%.0fmin".format(name.take(12), cpaNm, tcpaMin)
+}
diff --git a/test-runner/src/main/kotlin/org/terst/nav/ais/CpaCalculator.kt b/test-runner/src/main/kotlin/org/terst/nav/ais/CpaCalculator.kt
index 7e98451..298af59 100644
--- a/test-runner/src/main/kotlin/org/terst/nav/ais/CpaCalculator.kt
+++ b/test-runner/src/main/kotlin/org/terst/nav/ais/CpaCalculator.kt
@@ -2,7 +2,6 @@ package org.terst.nav.ais
 
 import kotlin.math.cos
 import kotlin.math.sqrt
-import kotlin.math.PI
 
 object CpaCalculator {
     fun compute(
diff --git a/test-runner/src/main/kotlin/org/terst/nav/track/TrackRepository.kt b/test-runner/src/main/kotlin/org/terst/nav/track/TrackRepository.kt
index 7953822..a68e315 100644
--- a/test-runner/src/main/kotlin/org/terst/nav/track/TrackRepository.kt
+++ b/test-runner/src/main/kotlin/org/terst/nav/track/TrackRepository.kt
@@ -1,5 +1,10 @@
 package org.terst.nav.track
 
+import kotlin.math.atan2
+import kotlin.math.cos
+import kotlin.math.sin
+import kotlin.math.sqrt
+
 class TrackRepository {
 
     var isRecording: Boolean = false
@@ -23,4 +28,29 @@ class TrackRepository {
     }
 
     fun getPoints(): List<TrackPoint> = points.toList()
+
+    fun computeStats(): TrackStats? {
+        if (points.size < 2) return null
+        var distNm = 0.0
+        for (i in 1 until points.size) {
+            distNm += haversineNm(points[i - 1].lat, points[i - 1].lon, points[i].lat, points[i].lon)
+        }
+        val durationMs = points.last().timestampMs - points.first().timestampMs
+        val avgSog = if (durationMs > 0) {
+            points.map { it.sogKnots }.average()
+        } else 0.0
+        return TrackStats(distNm, durationMs, avgSog)
+    }
+
+    companion object {
+        fun haversineNm(lat1: Double, lon1: Double, lat2: Double, lon2: Double): Double {
+            val r = 3440.065  // Earth radius in nautical miles
+            val dLat = Math.toRadians(lat2 - lat1)
+            val dLon = Math.toRadians(lon2 - lon1)
+            val a = sin(dLat / 2) * sin(dLat / 2) +
+                    cos(Math.toRadians(lat1)) * cos(Math.toRadians(lat2)) *
+                    sin(dLon / 2) * sin(dLon / 2)
+            return r * 2 * atan2(sqrt(a), sqrt(1 - a))
+        }
+    }
 }
diff --git a/test-runner/src/main/kotlin/org/terst/nav/track/TrackStats.kt b/test-runner/src/main/kotlin/org/terst/nav/track/TrackStats.kt
new file mode 100644
index 0000000..39153c6
--- /dev/null
+++ b/test-runner/src/main/kotlin/org/terst/nav/track/TrackStats.kt
@@ -0,0 +1,15 @@
+package org.terst.nav.track
+
+data class TrackStats(
+    val distanceNm: Double,
+    val durationMs: Long,
+    val avgSogKnots: Double
+) {
+    val durationFormatted: String get() {
+        val totalSec = durationMs / 1000
+        val h = totalSec / 3600
+        val m = (totalSec % 3600) / 60
+        val s = totalSec % 60
+        return if (h > 0) "%d:%02d:%02d".format(h, m, s) else "%d:%02d".format(m, s)
+    }
+}
-- 
cgit v1.2.3