feat: wire up event-firmware metadata API (offline-first) + post-event firmware reminder (#6162)

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>

Author: jamesarich

.github/workflows/scheduled-updates.yml

@@ -79,6 +79,35 @@ jobs:
             fi
           fi
 
+      - name: Update event firmware metadata
+        id: event_firmware
+        run: |
+          event_firmware_file_path="androidApp/src/main/assets/event_firmware.json"
+          temp_event_firmware_file="/tmp/new_event_firmware.json"
+
+          echo "Fetching latest event firmware metadata..."
+          http_code=$(curl -s --max-time 90 -o "$temp_event_firmware_file" -w '%{http_code}' https://api.meshtastic.org/resource/eventFirmware || true)
+          http_code="${http_code:-0}"
+
+          if [ "$http_code" -lt 200 ] || [ "$http_code" -ge 300 ]; then
+            echo "::warning::Event firmware API returned HTTP $http_code. Skipping event firmware update."
+            echo "status=error" >> "$GITHUB_OUTPUT"
+            echo "detail=HTTP $http_code from event firmware API" >> "$GITHUB_OUTPUT"
+          elif ! jq empty "$temp_event_firmware_file" 2>/dev/null; then
+            echo "::warning::Event firmware API returned invalid JSON data. Skipping event firmware update."
+            echo "status=error" >> "$GITHUB_OUTPUT"
+            echo "detail=Invalid JSON response from event firmware API" >> "$GITHUB_OUTPUT"
+          else
+            if [ ! -f "$event_firmware_file_path" ] || ! jq --sort-keys . "$temp_event_firmware_file" | diff -q - <(jq --sort-keys . "$event_firmware_file_path"); then
+              echo "Changes detected in event firmware metadata or local file missing. Updating $event_firmware_file_path."
+              cp "$temp_event_firmware_file" "$event_firmware_file_path"
+              echo "status=updated" >> "$GITHUB_OUTPUT"
+            else
+              echo "No changes detected in event firmware metadata."
+              echo "status=unchanged" >> "$GITHUB_OUTPUT"
+            fi
+          fi
+
       - name: Sync with Crowdin
         uses: crowdin/github-action@v2
         with:
@@ -113,11 +142,22 @@ jobs:
 
       - name: Build PR body
         id: pr_body
+        env:
+          # Hoisted into env: (not interpolated directly in the script) so no step output can inject shell — see
+          # zizmor template-injection. Values are fixed strings today, but detail may carry API text in future.
+          FIRMWARE_STATUS: ${{ steps.firmware.outputs.status }}
+          FIRMWARE_DETAIL: ${{ steps.firmware.outputs.detail }}
+          HARDWARE_STATUS: ${{ steps.hardware.outputs.status }}
+          HARDWARE_DETAIL: ${{ steps.hardware.outputs.detail }}
+          EVENT_FIRMWARE_STATUS: ${{ steps.event_firmware.outputs.status }}
+          EVENT_FIRMWARE_DETAIL: ${{ steps.event_firmware.outputs.detail }}
         run: |
-          firmware_status="${{ steps.firmware.outputs.status }}"
-          firmware_detail="${{ steps.firmware.outputs.detail }}"
-          hardware_status="${{ steps.hardware.outputs.status }}"
-          hardware_detail="${{ steps.hardware.outputs.detail }}"
+          firmware_status="$FIRMWARE_STATUS"
+          firmware_detail="$FIRMWARE_DETAIL"
+          hardware_status="$HARDWARE_STATUS"
+          hardware_detail="$HARDWARE_DETAIL"
+          event_firmware_status="$EVENT_FIRMWARE_STATUS"
+          event_firmware_detail="$EVENT_FIRMWARE_DETAIL"
 
           body="This PR includes automated updates from the scheduled workflow:"
           body+=$'\n'
@@ -138,6 +178,14 @@ jobs:
             *)         body+=$'\n'"- ❓ \`device_hardware.json\` — unknown status." ;;
           esac
 
+          # Event firmware status
+          case "$event_firmware_status" in
+            updated)   body+=$'\n'"- ✅ \`event_firmware.json\` updated from the Meshtastic API." ;;
+            unchanged) body+=$'\n'"- ✔️ \`event_firmware.json\` checked — no changes detected." ;;
+            error)     body+=$'\n'"- ⚠️ \`event_firmware.json\` skipped — ${event_firmware_detail}." ;;
+            *)         body+=$'\n'"- ❓ \`event_firmware.json\` — unknown status." ;;
+          esac
+
           # Crowdin (always attempted)
           body+=$'\n'"- Source strings were uploaded to Crowdin."
           body+=$'\n'"- Latest translations were downloaded from Crowdin (if available)."
@@ -161,6 +209,7 @@ jobs:
             Automated updates for:
             - Firmware releases list
             - Device hardware list
+            - Event firmware metadata
             - Crowdin source string uploads
             - Crowdin translation downloads
           title: 'chore: Scheduled updates (Firmware, Hardware, Translations)'
@@ -171,6 +220,7 @@ jobs:
           add-paths: |
             androidApp/src/main/assets/firmware_releases.json
             androidApp/src/main/assets/device_hardware.json
+            androidApp/src/main/assets/event_firmware.json
             fastlane/metadata/android/**
             **/strings.xml
             docs/**/*.md

.skills/compose-ui/strings-index.txt

@@ -18,6 +18,7 @@ package org.meshtastic.app.di
 
 import org.koin.core.annotation.Module
 import org.koin.core.annotation.Single
+import org.meshtastic.core.model.EventFirmwareResponse
 import org.meshtastic.core.model.NetworkDeviceHardware
 import org.meshtastic.core.model.NetworkDeviceLinksResponse
 import org.meshtastic.core.model.NetworkFirmwareReleases
@@ -42,5 +43,8 @@ class FDroidNetworkModule {
 
         override suspend fun getFirmwareReleases(): NetworkFirmwareReleases =
             throw UnsupportedOperationException("getFirmwareReleases is not supported on F-Droid builds.")
+
+        override suspend fun getEventFirmware(): EventFirmwareResponse =
+            throw UnsupportedOperationException("getEventFirmware is not supported on F-Droid builds.")
     }
 }

androidApp/src/fdroid/kotlin/org/meshtastic/app/di/FDroidNetworkModule.kt

@@ -1,63 +1,183 @@
 {
-  "version": 1,
-  "generatedAt": "2026-06-23T00:00:00Z",
+  "version": 2,
+  "generatedAt": "2026-06-30T00:00:00Z",
   "source": "bundled",
   "editions": [
     {
       "edition": "HAMVENTION",
-      "displayName": "Hamvention",
+      "displayName": "Dayton Hamvention 2026",
       "welcomeMessage": "Welcome to Hamvention! 🍖📻",
+      "tag": "Hamvention",
       "eventStart": "2026-05-15",
       "eventEnd": "2026-05-17",
       "timeZone": "America/New_York",
       "location": "Xenia, Ohio, USA",
-      "iconUrl": null,
-      "accentColor": "#005DAA",
+      "iconUrl": "https://api.meshtastic.org/resource/eventFirmware/hamvention.png",
+      "accentColor": "#BF1E2E",
+      "domain": "hamvention.meshtastic.org",
       "links": [
-        { "label": "Event Website", "url": "https://hamvention.org" }
-      ]
+        {
+          "label": "Event Website",
+          "url": "https://hamvention.org"
+        }
+      ],
+      "theme": {
+        "name": "Radio Adventure",
+        "tagline": "Exploring the many avenues amateur radio has to offer.",
+        "colors": {
+          "primary": "#BF1E2E",
+          "secondary": null,
+          "accent": null
+        },
+        "palette": [
+          "#BF1E2E"
+        ],
+        "fonts": null
+      },
+      "firmware": {
+        "slug": "dayton2026",
+        "version": "2.7.23.07741e6",
+        "id": "v2.7.23.07741e6",
+        "title": "Meshtastic Firmware 2.7.23.07741e6",
+        "zipUrl": "https://github.com/meshtastic/meshtastic.github.io/raw/master/event/dayton2026/firmware-2.7.23.07741e6.zip",
+        "releaseNotes": "## Welcome to Dayton Hamvention 2026!\n\nThis firmware has been customized for Hamvention with factory default configurations.\n\n### ⚠️ Important: Backup Before Flashing\n\nIf your device has existing settings or encryption keys, **backup your keys / configurations** before proceeding. Flashing will reset your device to factory settings for the event.\n\n### Quick Start\n\n1. Ensure a **data-capable USB cable** is connected\n2. Select your device type\n3. Choose \"Full Erase and Install\"\n4. After flashing, download the Meshtastic app and pair via Bluetooth\n5. If you updated from a previous version or installed a UF2 on an NRF52 device, you will need to perform a factory reset on the device to activate the Hamvention mode.\n\n**73 and happy meshing from Dayton!**"
+      }
     },
     {
       "edition": "OPEN_SAUCE",
-      "displayName": "Open Sauce",
+      "displayName": "Open Sauce 2026",
       "welcomeMessage": "Welcome to Open Sauce! 🔧",
-      "eventStart": "2026-07-18",
+      "tag": "Open Sauce",
+      "eventStart": "2026-07-17",
       "eventEnd": "2026-07-19",
       "timeZone": "America/Los_Angeles",
       "location": "San Mateo, California, USA",
       "iconUrl": null,
       "accentColor": "#E94F1D",
+      "domain": "opensauce.meshtastic.org",
       "links": [
-        { "label": "Event Website", "url": "https://opensauce.com" }
-      ]
+        {
+          "label": "Event Website",
+          "url": "https://opensauce.com"
+        }
+      ],
+      "theme": {
+        "name": "Makers & Mesh",
+        "tagline": "Where makers, science, and mesh collide.",
+        "colors": {
+          "primary": "#E94F1D",
+          "secondary": null,
+          "accent": null
+        },
+        "palette": [
+          "#E94F1D"
+        ],
+        "fonts": null
+      },
+      "firmware": {
+        "slug": "opensauce2026",
+        "version": "2.7.26.004b486",
+        "id": "v2.7.26.004b486",
+        "title": "Meshtastic Firmware 2.7.26.004b486",
+        "zipUrl": "https://github.com/meshtastic/meshtastic.github.io/raw/master/event/opensauce2026/firmware-2.7.26.004b486.zip",
+        "releaseNotes": "## Welcome to Open Sauce 2026! 🔧\n\nThis firmware has been customized for Open Sauce with factory default configurations.\n\n### ⚠️ Important: Backup Before Flashing\n\nIf your device has existing settings or encryption keys, **backup your keys / configurations** before proceeding. Flashing will reset your device to factory settings for the event.\n\n### Quick Start\n\n1. Ensure a **data-capable USB cable** is connected\n2. Select your device type\n3. Choose \"Full Erase and Install\"\n4. After flashing, download the Meshtastic app and pair via Bluetooth\n5. If you updated from a previous version or installed a UF2 on an NRF52 device, you will need to perform a factory reset on the device to activate the Open Sauce mode.\n\n**Happy meshing from San Mateo!**"
+      }
     },
     {
       "edition": "DEFCON",
-      "displayName": "DEFCON",
-      "welcomeMessage": "Welcome to DEFCON! 💀",
+      "displayName": "DEF CON 34",
+      "welcomeMessage": "Welcome to DEF CON 34! 💀",
+      "tag": "DEFCON",
       "eventStart": "2026-08-06",
       "eventEnd": "2026-08-09",
       "timeZone": "America/Los_Angeles",
-      "location": "Las Vegas, Nevada, USA",
+      "location": "Las Vegas Convention Center, Las Vegas, Nevada, USA",
       "iconUrl": null,
-      "accentColor": "#C0392B",
+      "accentColor": "#0D294A",
+      "domain": "defcon.meshtastic.org",
       "links": [
-        { "label": "Event Website", "url": "https://defcon.org" }
-      ]
+        {
+          "label": "Event Website",
+          "url": "https://defcon.org"
+        },
+        {
+          "label": "DEF CON 34 Theme",
+          "url": "https://defcon.org/html/defcon-34/dc-34-theme.html"
+        },
+        {
+          "label": "Mastodon",
+          "url": "https://defcon.social"
+        }
+      ],
+      "theme": {
+        "name": "Agency",
+        "tagline": "Agency is self-determination. It's about making choices that increase yours, AND helping others to control theirs.",
+        "colors": {
+          "primary": "#0D294A",
+          "secondary": "#017FA4",
+          "accent": "#E0004E"
+        },
+        "palette": [
+          "#0D294A",
+          "#017FA4",
+          "#105F66",
+          "#6CCDB8",
+          "#F1B435",
+          "#E0004E"
+        ],
+        "fonts": {
+          "heading": "Lato",
+          "body": "Atkinson Hyperlegible"
+        }
+      },
+      "firmware": {
+        "slug": "defcon2026",
+        "version": null,
+        "id": null,
+        "title": null,
+        "zipUrl": null,
+        "releaseNotes": null
+      }
     },
     {
       "edition": "BURNING_MAN",
-      "displayName": "Burning Man",
+      "displayName": "Burning Man 2026",
       "welcomeMessage": "Welcome to Burning Man! 🔥",
+      "tag": "Burning Man",
       "eventStart": "2026-08-30",
       "eventEnd": "2026-09-07",
       "timeZone": "America/Los_Angeles",
       "location": "Black Rock City, Nevada, USA",
       "iconUrl": null,
-      "accentColor": "#E8552D",
+      "accentColor": "#EC8819",
+      "domain": "burningman.meshtastic.org",
       "links": [
-        { "label": "Event Website", "url": "https://burningman.org" }
-      ]
+        {
+          "label": "Event Website",
+          "url": "https://burningman.org"
+        }
+      ],
+      "theme": {
+        "name": "Axis Mundi",
+        "tagline": "The axis of the world — a celestial column connecting earth, sky, and the realms between.",
+        "colors": {
+          "primary": "#EC8819",
+          "secondary": null,
+          "accent": null
+        },
+        "palette": [
+          "#EC8819"
+        ],
+        "fonts": null
+      },
+      "firmware": {
+        "slug": "burningman2026",
+        "version": null,
+        "id": null,
+        "title": null,
+        "zipUrl": null,
+        "releaseNotes": null
+      }
     }
   ]
 }

androidApp/src/main/assets/event_firmware.json

@@ -0,0 +1,47 @@
+/*
+ * Copyright (c) 2026 Meshtastic LLC
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package org.meshtastic.core.data.datasource
+
+import kotlinx.coroutines.withContext
+import org.koin.core.annotation.Single
+import org.meshtastic.core.database.DatabaseProvider
+import org.meshtastic.core.database.entity.EventFirmwareEditionEntity
+import org.meshtastic.core.di.CoroutineDispatchers
+
+@Single
+class EventFirmwareEditionLocalDataSource(
+    private val dbManager: DatabaseProvider,
+    private val dispatchers: CoroutineDispatchers,
+) {
+    private val dao
+        get() = dbManager.currentDb.value.eventFirmwareEditionDao()
+
+    suspend fun getByEdition(edition: String): EventFirmwareEditionEntity? =
+        withContext(dispatchers.io) { dao.getByEdition(edition) }
+
+    suspend fun upsertAll(editions: List<EventFirmwareEditionEntity>) =
+        withContext(dispatchers.io) { dao.upsertAll(editions) }
+
+    // No-op on empty: `NOT IN ()` is always true in SQLite, so forwarding an empty list would wipe the whole table.
+    // Callers only prune against a non-empty upstream payload; an empty list means "keep everything".
+    suspend fun deleteNotIn(keep: List<String>) {
+        if (keep.isEmpty()) return
+        withContext(dispatchers.io) { dao.deleteNotIn(keep) }
+    }
+
+    suspend fun count(): Int = withContext(dispatchers.io) { dao.count() }
+}