MeshCoreTel-firmware/release-notes.yml

schema_version: 1
tracks:
  - companion-wifi
  - repeater-mqtt
generated_from: "Adjacent git tag comparisons plus non-merge commit subjects."

releases:
  - track: companion-wifi
    version: "1.14.1"
    tag: "companion-wifi-v1.14.1"
    date: "2026-04-09"
    previous_version: null
    summary: "First EastMesh companion_wifi release with persisted Wi-Fi CLI settings and EastMesh-specific docs and release plumbing."
    changes:
      - type: added
        area: companion-wifi
        text: "Added the EastMesh companion_wifi release track for supported boards."
      - type: added
        area: wifi
        text: "Added persisted Wi-Fi CLI settings so companion Wi-Fi devices can retain configured credentials across restart."
      - type: added
        area: release
        text: "Added EastMesh release documentation, local build guidance, and CI workflows focused on the supported Wi-Fi and MQTT firmware tracks."
      - type: changed
        area: docs
        text: "Refreshed the docs site structure and theme as part of the first EastMesh release set."
    breaking_changes: []

  - track: repeater-mqtt
    version: "1.0.1"
    tag: "repeater-mqtt-eastmesh-v1.0.1"
    date: "2026-04-09"
    previous_version: null
    summary: "First EastMesh repeater_mqtt release with MQTT uplink, optional local web panel support, and EastMesh-specific release plumbing."
    changes:
      - type: added
        area: mqtt
        text: "Added the EastMesh repeater_mqtt firmware track with MQTT uplink support and EastMesh-specific firmware workflows."
      - type: added
        area: web-panel
        text: "Added the initial local HTTPS repeater web configuration panel for supported targets."
      - type: added
        area: release
        text: "Added EastMesh release documentation, local build guidance, and CI workflows focused on the supported Wi-Fi and MQTT firmware tracks."
      - type: changed
        area: build
        text: "Moved web panel certificate generation into the build flow and kept the web panel optional for tighter firmware targets."
    breaking_changes: []

  - track: repeater-mqtt
    version: "1.1.0"
    tag: "repeater-mqtt-eastmesh-v1.1.0"
    date: "2026-04-10"
    previous_version: "1.0.1"
    summary: "Expanded the repeater web panel with a fuller dashboard and MQTT settings, and stabilised HTTPS/TLS startup."
    changes:
      - type: added
        area: web-panel
        text: "Added a repeater dashboard and in-panel MQTT settings controls."
      - type: changed
        area: web-panel
        text: "Stabilised HTTPS/TLS startup behaviour for the local repeater web panel."
      - type: changed
        area: mqtt
        text: "Refactored MQTT uplink handling to support the expanded web panel controls and cleaner repeater status reporting."
      - type: docs
        area: setup
        text: "Added CLI rescue guidance for setting Wi-Fi on companion Wi-Fi builds and refreshed README/license content."
    breaking_changes: []

  - track: repeater-mqtt
    version: "1.1.1"
    tag: "repeater-mqtt-eastmesh-v1.1.1"
    date: "2026-04-10"
    previous_version: "1.1.0"
    summary: "Added mqtt.status control support and tightened the web panel and migration documentation."
    changes:
      - type: added
        area: mqtt
        text: "Added mqtt.status control/reporting support to make broker state easier to inspect from the repeater CLI."
      - type: docs
        area: migration
        text: "Expanded migration guidance and aligned the docs site with the newer EastMesh structure."
      - type: docs
        area: web-panel
        text: "Added dedicated web panel documentation and refreshed the site theme and navigation."
    breaking_changes: []

  - track: repeater-mqtt
    version: "1.1.2"
    tag: "repeater-mqtt-eastmesh-v1.1.2"
    date: "2026-04-10"
    previous_version: "1.1.1"
    summary: "Cleaned up legacy MQTT preference handling, restored status publishing, and expanded web panel controls."
    changes:
      - type: fixed
        area: mqtt
        text: "Cleared legacy MQTT preference fields so older persisted settings stopped leaking into current repeater behaviour."
      - type: fixed
        area: mqtt
        text: "Restored MQTT status publishing after the earlier control changes."
      - type: changed
        area: web-panel
        text: "Expanded the repeater web panel controls and updated the related CLI and web panel docs."
    breaking_changes: []

  - track: repeater-mqtt
    version: "1.2.0"
    tag: "repeater-mqtt-eastmesh-v1.2.0"
    date: "2026-04-11"
    previous_version: "1.1.2"
    summary: "Reduced MQTT and web-panel memory pressure, streamlined broker controls, and polished the repeater admin surface."
    changes:
      - type: changed
        area: mqtt
        text: "Reduced MQTT uplink memory pressure and improved runtime behaviour on constrained repeater targets."
      - type: changed
        area: web-panel
        text: "Streamlined broker controls in the web panel and refreshed the end-user admin flow."
      - type: fixed
        area: web-panel
        text: "Corrected the noise floor gauge colouring and exposed prv.key in the web console."
      - type: added
        area: board-support
        text: "Added a battery reporting toggle for Heltec V3 repeater builds."
      - type: docs
        area: docs
        text: "Simplified the end-user guides and aligned the web panel docs with the current UI."
    breaking_changes: []

  - track: repeater-mqtt
    version: "1.2.1"
    tag: "repeater-mqtt-eastmesh-v1.2.1"
    date: "2026-04-12"
    previous_version: "1.2.0"
    summary: "Made broker outages less disruptive and expanded the repeater web panel with radio presets and richer operational controls."
    changes:
      - type: fixed
        area: mqtt
        text: "Added graceful MQTT reconnect backoff during broker outages."
      - type: added
        area: web-panel
        text: "Added radio preset controls, repeater info cards, and clock sync controls to the repeater web panel."
      - type: docs
        area: release
        text: "Updated release guidance so the web panel can be used for common repeater setup before being disabled for maximum MQTT headroom."
    breaking_changes: []

  - track: repeater-mqtt
    version: "1.2.2"
    tag: "repeater-mqtt-eastmesh-v1.2.2"
    date: "2026-04-13"
    previous_version: "1.2.1"
    summary: "Reduced repeater web panel load pressure and improved MQTT diagnostics."
    changes:
      - type: changed
        area: web-panel
        text: "Reduced web panel runtime pressure so opening the admin UI had less impact on busy MQTT repeaters."
      - type: added
        area: mqtt
        text: "Improved MQTT diagnostics and status visibility for troubleshooting broker and uplink issues."
      - type: docs
        area: web-panel
        text: "Updated the web panel documentation to match the lighter loading behaviour and operational guidance."
    breaking_changes: []

  - track: repeater-mqtt
    version: "1.3.0"
    tag: "repeater-mqtt-eastmesh-v1.3.0"
    date: "2026-04-15"
    previous_version: "1.2.2"
    summary: "Added SD-backed stats history and split the repeater web UI into a lighter /app page and a dedicated /stats console."
    changes:
      - type: added
        area: stats
        text: "Added SD-backed stats archival and restore support for repeater history data."
      - type: added
        area: web-panel
        text: "Added a dedicated /stats web console for current status, historical trends, neighbours, and recent events."
      - type: changed
        area: web-panel
        text: "Reworked the local web UI so /app stays focused on configuration and admin controls while /stats handles visibility and history."
      - type: fixed
        area: stats
        text: "Restored /stats Wi-Fi signal quality and tuned the /stats signal, noise floor, and RSSI meters for correct LoRa-oriented ranges."
      - type: changed
        area: board-support
        text: "Removed ESP32-C3 repeater_mqtt target support and the related CI coverage."
      - type: docs
        area: docs
        text: "Expanded board comparison guidance and refreshed the published web panel screenshots and docs."
    breaking_changes:
      - "ESP32-C3 repeater_mqtt targets were removed in this release."

  - track: repeater-mqtt
    version: "1.3.1"
    tag: "repeater-mqtt-eastmesh-v1.3.1"
    date: "2026-04-16"
    previous_version: "1.3.0"
    summary: "Made web stats safer on non-PSRAM repeaters by defaulting them off, switching constrained boards to live-only history, and allocating stats buffers lazily."
    changes:
      - type: fixed
        area: web-panel
        text: "Disabled web stats by default on non-PSRAM repeater builds so the local web UI places less memory pressure on constrained boards."
      - type: changed
        area: stats
        text: "Changed non-PSRAM repeater builds to a live-only stats mode with smaller in-memory history buffers instead of archive-backed persistence."
      - type: fixed
        area: stats
        text: "Lazy-initialised web stats buffers and released idle live-only buffers so opening /stats has less impact on busy or memory-constrained repeaters."
      - type: changed
        area: web-panel
        text: "Extended the web stats status output and JSON summary payloads to report whether history is running in live-only mode."
      - type: docs
        area: web-panel
        text: "Refreshed the published web panel screenshots and docs to use separate light and dark mode captures."
    breaking_changes: []

  - track: repeater-mqtt
    version: "1.3.2"
    tag: "repeater-mqtt-eastmesh-v1.3.2"
    date: "2026-04-17"
    previous_version: "1.3.1"
    summary: "Refined the repeater /stats UX, added better early-event and noise-floor handling, and persisted the ESP32 fallback clock across reboot."
    changes:
      - type: fixed
        area: stats
        text: "Removed the misleading neighbour Route column from /stats and cleaned up the neighbour table payload to match the stored data."
      - type: changed
        area: stats
        text: "Retuned the /stats radio noise-floor meter and added a dedicated noise-floor trend with clearer ranges, colour bands, and orientation."
      - type: changed
        area: web-panel
        text: "Reordered the /stats trend cards and changed Packet Activity to a bar chart for interval-based packet counts."
      - type: fixed
        area: stats
        text: "Captured boot/session events earlier on live-only non-PSRAM repeaters so the Events panel is populated before /stats is first opened."
      - type: fixed
        area: clock
        text: "Persisted the ESP32 fallback clock in NVS with immediate saves on sync and periodic checkpoints so boards without a hardware RTC recover a recent sane epoch after reboot."
      - type: changed
        area: web-panel
        text: "Remembered whether the local web UI was last on /app or /stats and returned to that page after unlocking again."
      - type: changed
        area: mqtt
        text: "Changed the Services MQTT status to report degraded when only some enabled MQTT brokers are connected instead of treating any single connected broker as fully up."
    breaking_changes: []

  - track: repeater-mqtt
    version: "1.3.3"
    tag: "repeater-mqtt-eastmesh-v1.3.3"
    date: "2026-04-17"
    previous_version: "1.3.2"
    summary: "Improved /stats memory visibility, tightened web stats startup on 2 MB-class PSRAM boards, and polished the local repeater admin UI."
    changes:
      - type: fixed
        area: stats
        text: "Adjusted boot auto-capture for web stats to recognise 2 MB-class ESP32 PSRAM sizes instead of requiring an exact 2 MiB boundary."
      - type: changed
        area: stats
        text: "Extended `get web.stats.status` with focused startup diagnostics for PSRAM size and boot auto-capture, while trimming low-value fields so the reply fits cleanly."
      - type: changed
        area: web-panel
        text: "Updated the /stats Memory card to promote Heap Free, refine its headroom thresholds, and align the memory trend colours with the recent heap-free state."
      - type: fixed
        area: web-panel
        text: "Captured the /stats summary memory snapshot earlier in the request path so the live memory values are more consistent while the page is loading."
      - type: changed
        area: web-panel
        text: "Changed the local web panel tab title to use the repeater name when available, with a fallback to `Repeater Config`."
      - type: docs
        area: web-panel
        text: "Updated the web panel docs to describe the rough 2 MB PSRAM boot-history cutoff."
    breaking_changes: []