feat: Doze-resistant location sharing with boot persistence

.codecov.yml

@@ -29,6 +29,8 @@ flags:
 ignore:
   - "external/**"
   - "python/test_*.py"
+  # Network-dependent Python code requires a live RNS instance, not unit tests
+  - "python/rns_api.py"
   # Service layer code requires instrumented tests, not unit tests
   - "app/src/main/java/com/lxmf/messenger/service/**"
   - "app/src/main/java/com/lxmf/messenger/reticulum/protocol/**"

.github/workflows/build-prerelease-apk.yml

@@ -26,7 +26,7 @@ jobs:
           submodules: recursive
 
       - name: Setup Gradle
-        uses: gradle/actions/setup-gradle@v5
+        uses: gradle/actions/setup-gradle@v6
         with:
           cache-read-only: false
 
@@ -36,7 +36,7 @@ jobs:
           python-version: '3.11'
 
       - name: Validate Gradle wrapper
-        uses: gradle/actions/wrapper-validation@v5
+        uses: gradle/actions/wrapper-validation@v6
         continue-on-error: true
 
       - name: Grant execute permission for gradlew

.github/workflows/ci.yml

@@ -24,7 +24,7 @@ jobs:
           fetch-depth: 1
 
       - name: Validate Gradle wrapper
-        uses: gradle/actions/wrapper-validation@v5
+        uses: gradle/actions/wrapper-validation@v6
 
   lint:
     name: Code Quality (ktlint + detekt + CPD)
@@ -40,7 +40,7 @@ jobs:
           persist-credentials: false
 
       - name: Setup Gradle
-        uses: gradle/actions/setup-gradle@v5
+        uses: gradle/actions/setup-gradle@v6
         with:
           cache-read-only: false
 
@@ -169,7 +169,7 @@ jobs:
           persist-credentials: false
 
       - name: Setup Gradle
-        uses: gradle/actions/setup-gradle@v5
+        uses: gradle/actions/setup-gradle@v6
         with:
           cache-read-only: false
 
@@ -253,7 +253,7 @@ jobs:
             --cov-report=xml:coverage-python.xml
 
       - name: Upload Python coverage to Codecov
-        uses: codecov/codecov-action@v5
+        uses: codecov/codecov-action@v6
         with:
           token: ${{ secrets.CODECOV_TOKEN }}
           files: ./python/coverage-python.xml
@@ -289,7 +289,7 @@ jobs:
           persist-credentials: false
 
       - name: Setup Gradle
-        uses: gradle/actions/setup-gradle@v5
+        uses: gradle/actions/setup-gradle@v6
         with:
           cache-read-only: false
 
@@ -373,7 +373,7 @@ jobs:
             **/build/reports/tests/
 
       - name: Upload coverage to Codecov
-        uses: codecov/codecov-action@v5
+        uses: codecov/codecov-action@v6
         with:
           token: ${{ secrets.CODECOV_TOKEN }}
           files: ./**/build/reports/jacoco/**/*.xml
@@ -406,7 +406,7 @@ jobs:
           persist-credentials: false
 
       - name: Setup Gradle
-        uses: gradle/actions/setup-gradle@v5
+        uses: gradle/actions/setup-gradle@v6
         with:
           cache-read-only: false
 
@@ -467,7 +467,7 @@ jobs:
             **/build/reports/tests/
 
       - name: Upload coverage to Codecov
-        uses: codecov/codecov-action@v5
+        uses: codecov/codecov-action@v6
         with:
           token: ${{ secrets.CODECOV_TOKEN }}
           files: ./**/build/reports/jacoco/**/*.xml
@@ -492,7 +492,7 @@ jobs:
           persist-credentials: false
 
       - name: Setup Gradle
-        uses: gradle/actions/setup-gradle@v5
+        uses: gradle/actions/setup-gradle@v6
         with:
           cache-read-only: false
 

.github/workflows/release.yml

@@ -24,7 +24,7 @@ jobs:
           python-version: '3.11'
 
       - name: Setup Gradle
-        uses: gradle/actions/setup-gradle@v5
+        uses: gradle/actions/setup-gradle@v6
         with:
           cache-read-only: false
 

README.md

@@ -1,4 +1,6 @@
-<img src="./columba-icon.svg" width="200" height="200" alt="alt text" />
+<p align="center">
+  <img src="./columba-icon.svg" width="200" height="200" alt="alt text" />
+</p>
 
 # Columba
 
@@ -40,3 +42,10 @@ Want to learn more? Visit [Reticulum's documentation](https://reticulum.network/
 ## Why "Columba"
 
 Columba, latin for "dove," is a [constellation](https://en.wikipedia.org/wiki/Columba_(constellation)) in the southern sky depicting a dove. Doves are commonly a symbol of peace and hope, and have been used as messengers throughout history. 
+
+## Stats
+
+![Total Downloads](https://img.shields.io/github/downloads/torlando-tech/columba/total?label=total%20downloads) ![Latest](https://img.shields.io/github/downloads/torlando-tech/columba/latest/total?label=latest%20downloads) ![Pre-release](https://img.shields.io/github/downloads-pre/torlando-tech/columba/latest/total?label=pre-release%20downloads)  
+
+
+[![Star History Chart](https://api.star-history.com/svg?repos=torlando-tech/columba&type=Date)](https://star-history.com/#torlando-tech/columba&Date)

app/build.gradle.kts

@@ -3,7 +3,6 @@ import java.util.Base64
 
 plugins {
     id("com.android.application")
-    kotlin("android")
     kotlin("plugin.compose")
     kotlin("plugin.serialization")
     id("com.google.devtools.ksp")
@@ -78,7 +77,7 @@ val (versionCodeValue, versionNameValue) = getVersionFromTag()
 
 android {
     namespace = "com.lxmf.messenger"
-    compileSdk = 35
+    compileSdk = 36
 
     defaultConfig {
         applicationId = "com.lxmf.messenger"
@@ -412,7 +411,7 @@ dependencies {
 
     // Crash Reporting - GlitchTip (Sentry-compatible)
     // Phase 4 Task 4.2: Production Observability
-    implementation("io.sentry:sentry-android:8.29.0")
+    implementation("io.sentry:sentry-android:8.31.0")
 
     // Performance Monitoring - JankStats for frame monitoring
     // Phase 1 Plan 01-03: Frame tracking integration with Sentry
@@ -453,7 +452,7 @@ dependencies {
     testImplementation(libs.compose.test)
     testImplementation("androidx.compose.ui:ui-test-manifest")
     testImplementation(libs.paging.testing)
-    testImplementation("androidx.test:core:1.5.0")
+    testImplementation(libs.test.core)
     testImplementation("androidx.test.ext:junit:1.1.5")
     testImplementation("org.json:json:20231013") // Real JSON implementation for unit tests
     androidTestImplementation(libs.junit.android)

app/src/main/AndroidManifest.xml

@@ -51,6 +51,7 @@
     <uses-permission android:name="android.permission.FOREGROUND_SERVICE_DATA_SYNC" />
     <uses-permission android:name="android.permission.FOREGROUND_SERVICE_CONNECTED_DEVICE" />
     <uses-permission android:name="android.permission.FOREGROUND_SERVICE_SPECIAL_USE" />
+    <uses-permission android:name="android.permission.FOREGROUND_SERVICE_LOCATION" />
 
     <!-- Notification permission (Android 13+) -->
     <uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
@@ -175,6 +176,15 @@
                 android:value="Emergency SOS gesture detection via accelerometer" />
         </service>
 
+        <!-- Location Foreground Service -->
+        <!-- Keeps the main process alive during Doze so GPS callbacks continue -->
+        <!-- Only runs when location sharing or telemetry collection is active -->
+        <service
+            android:name=".service.LocationForegroundService"
+            android:enabled="true"
+            android:exported="false"
+            android:foregroundServiceType="location" />
+
         <!-- Reticulum Background Service -->
         <!-- Runs in separate process to allow clean restarts when applying config changes -->
         <!-- BLE functionality is now integrated via KotlinBLEBridge (no separate service needed) -->

app/src/main/aidl/com/lxmf/messenger/IReticulumService.aidl

@@ -678,6 +678,18 @@ interface IReticulumService {
      */
     oneway void cancelNomadnetPageRequest();
 
+    /**
+     * Get current NomadNet file download progress.
+     * @return Float between 0.0 and 1.0 if download active, -1.0 if idle
+     */
+    float getNomadnetDownloadProgress();
+
+    /**
+     * Get current NomadNet request phase status (e.g., "Looking up path...", "Connecting (3 hops)...").
+     * @return Status string, empty if idle
+     */
+    String getNomadnetRequestStatus();
+
     /**
      * Identify ourselves on an existing NomadNet link (Strangler Fig -> rns_api.py).
      * @param destHash Destination hash bytes (16 bytes)

app/src/main/java/com/lxmf/messenger/ColumbaApplication.kt

@@ -12,6 +12,7 @@ import com.lxmf.messenger.reticulum.model.ReticulumConfig
 import com.lxmf.messenger.reticulum.protocol.ReticulumProtocol
 import com.lxmf.messenger.reticulum.protocol.ServiceReticulumProtocol
 import com.lxmf.messenger.service.IdentityResolutionManager
+import com.lxmf.messenger.service.LocationSharingManager
 import com.lxmf.messenger.service.MessageCollector
 import com.lxmf.messenger.service.PropagationNodeManager
 import com.lxmf.messenger.service.SosActiveTracker
@@ -100,6 +101,9 @@ class ColumbaApplication : Application() {
     @Inject
     lateinit var receivedLocationDao: com.lxmf.messenger.data.db.dao.ReceivedLocationDao
 
+    @Inject
+    lateinit var locationSharingManager: LocationSharingManager
+
     // Application-level coroutine scope for app-wide operations
     // Uses Dispatchers.Default for background initialization (no main-thread work needed)
     // SupervisorJob ensures failures don't crash the entire app
@@ -284,7 +288,8 @@ class ColumbaApplication : Application() {
                     // (collector address + send/request toggles) is available even if
                     // startup exits early while service is INITIALIZING/RESTARTING.
                     telemetryCollectorManager.start()
-                    android.util.Log.d("ColumbaApplication", "TelemetryCollectorManager started early after bind")
+                    locationSharingManager.restoreIfActive()
+                    android.util.Log.d("ColumbaApplication", "TelemetryCollectorManager + LocationSharingManager started early after bind")
 
                     // Check if service is already initialized (handle service process surviving app restart)
                     // Use timeout to prevent ANR if service is slow
@@ -325,6 +330,7 @@ class ColumbaApplication : Application() {
                             identityResolutionManager.start(applicationScope)
                             propagationNodeManager.start()
                             telemetryCollectorManager.start()
+                            locationSharingManager.restoreIfActive()
                             android.util.Log.d(
                                 "ColumbaApplication",
                                 "MessageCollector, AutoAnnounceManager, IdentityResolutionManager, PropagationNodeManager, TelemetryCollectorManager started",
@@ -443,6 +449,7 @@ class ColumbaApplication : Application() {
                             identityResolutionManager.start(applicationScope)
                             propagationNodeManager.start()
                             telemetryCollectorManager.start()
+                            locationSharingManager.restoreIfActive()
                             android.util.Log.d(
                                 "ColumbaApplication",
                                 "MessageCollector, AutoAnnounceManager, IdentityResolutionManager, PropagationNodeManager, TelemetryCollectorManager started",
@@ -638,6 +645,7 @@ class ColumbaApplication : Application() {
                     identityResolutionManager.start(applicationScope)
                     propagationNodeManager.start()
                     telemetryCollectorManager.start()
+                    locationSharingManager.restoreIfActive()
                     android.util.Log.d(
                         "ColumbaApplication",
                         "initializeReticulumService: MessageCollector, AutoAnnounceManager, IdentityResolutionManager, PropagationNodeManager, TelemetryCollectorManager started",

app/src/main/java/com/lxmf/messenger/repository/SettingsRepository.kt

@@ -185,6 +185,9 @@ class SettingsRepository
             // SOS audio recording
             val SOS_AUDIO_ENABLED = booleanPreferencesKey("sos_audio_enabled")
             val SOS_AUDIO_DURATION_SECONDS = intPreferencesKey("sos_audio_duration_seconds")
+
+            // Persisted location sharing sessions (JSON array, survives restart)
+            val LOCATION_SHARING_SESSIONS = stringPreferencesKey("location_sharing_sessions")
         }
 
         // Cross-process SharedPreferences for service communication
@@ -2206,4 +2209,21 @@ class SettingsRepository
                 preferences[PreferencesKeys.SOS_PILL_OFFSET_Y] = y
             }
         }
+
+        // ========== Location Sharing Session Persistence ==========
+
+        suspend fun saveLocationSharingSessions(sessionsJson: String) {
+            context.dataStore.edit { preferences ->
+                preferences[PreferencesKeys.LOCATION_SHARING_SESSIONS] = sessionsJson
+            }
+        }
+
+        suspend fun getLocationSharingSessions(): String? =
+            context.dataStore.data.first()[PreferencesKeys.LOCATION_SHARING_SESSIONS]
+
+        suspend fun clearLocationSharingSessions() {
+            context.dataStore.edit { preferences ->
+                preferences.remove(PreferencesKeys.LOCATION_SHARING_SESSIONS)
+            }
+        }
     }

app/src/main/java/com/lxmf/messenger/reticulum/protocol/ServiceReticulumProtocol.kt

@@ -2874,10 +2874,22 @@ class ServiceReticulumProtocol(
 
                 val result = org.json.JSONObject(resultJson)
                 if (result.optBoolean("success", false)) {
-                    NomadnetPageResult(
-                        content = result.getString("content"),
-                        path = result.getString("path"),
-                    )
+                    val type = result.optString("type", "page")
+                    if (type == "file") {
+                        NomadnetPageResult(
+                            content = "",
+                            path = result.getString("path"),
+                            type = "file",
+                            filePath = result.getString("file_path"),
+                            fileName = result.getString("file_name"),
+                            fileSize = result.getLong("file_size"),
+                        )
+                    } else {
+                        NomadnetPageResult(
+                            content = result.getString("content"),
+                            path = result.getString("path"),
+                        )
+                    }
                 } else {
                     throw RuntimeException(result.optString("error", "Unknown error"))
                 }
@@ -2894,6 +2906,28 @@ class ServiceReticulumProtocol(
         }
     }
 
+    suspend fun getNomadnetRequestStatus(): String =
+        kotlinx.coroutines.withContext(Dispatchers.IO) {
+            try {
+                this@ServiceReticulumProtocol.service?.nomadnetRequestStatus ?: ""
+            } catch (
+                @Suppress("SwallowedException") e: Exception,
+            ) {
+                ""
+            }
+        }
+
+    suspend fun getNomadnetDownloadProgress(): Float =
+        kotlinx.coroutines.withContext(Dispatchers.IO) {
+            try {
+                this@ServiceReticulumProtocol.service?.nomadnetDownloadProgress ?: -1f
+            } catch (
+                @Suppress("SwallowedException") e: Exception,
+            ) {
+                -1f
+            }
+        }
+
     /**
      * Identify ourselves on an existing NomadNet link.
      * @return Result<Boolean> where Boolean = alreadyIdentified
@@ -2917,6 +2951,10 @@ class ServiceReticulumProtocol(
     data class NomadnetPageResult(
         val content: String,
         val path: String,
+        val type: String = "page",
+        val filePath: String? = null,
+        val fileName: String? = null,
+        val fileSize: Long = 0L,
     )
 
     // Helper extension functions