schema_version: 1
tracks:
  - companion-wifi
  - repeater-bridge-espnow
  - observer-eastmesh
  - observer-eastmesh-bridge-espnow
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: companion-wifi
    version: "1.15.0"
    tag: "companion-wifi-v1.15.0"
    date: "2026-04-19"
    previous_version: "1.14.1"
    summary: "Prepares the next companion_wifi release on top of upstream MeshCore firmware v1.15.0."
    changes:
      - type: changed
        area: upstream
        text: "Updated the companion_wifi firmware base to upstream MeshCore v1.15.0."
    breaking_changes: []

  - track: companion-wifi
    version: "1.16.0"
    tag: "companion-wifi-v1.16.0"
    date: "2026-06-07"
    previous_version: "1.15.0"
    summary: "Updates companion WiFi firmware to upstream MeshCore v1.16.0."
    changes:
      - type: changed
        area: upstream
        text: "Updated the companion WiFi firmware base to upstream MeshCore v1.16.0."
      - type: changed
        area: board
        text: "Included upstream board, UI, power-saving, and platform fixes from MeshCore dev."
    breaking_changes: []

  - track: repeater-bridge-espnow
    version: "1.15.0"
    tag: "repeater-bridge-espnow-v1.15.0"
    date: "2026-05-05"
    previous_version: null
    summary: "Adds a tagged release workflow for upstream-versioned repeater ESP-NOW bridge firmware artifacts."
    changes:
      - type: added
        area: release
        text: "Added the `repeater-bridge-espnow-v*` release tag format and workflow for building repeater ESP-NOW bridge firmware artifacts using the official upstream MeshCore version."
      - type: fixed
        area: build
        text: "Kept pure ESP-NOW bridge targets out of the web-panel link path so they no longer fail with unresolved web service symbols."
      - type: docs
        area: release
        text: "Updated release guidance to document the repeater ESP-NOW bridge tag format and versioning rule."
    breaking_changes: []

  - track: repeater-bridge-espnow
    version: "1.16.0"
    tag: "repeater-bridge-espnow-v1.16.0"
    date: "2026-06-07"
    previous_version: "1.15.0"
    summary: "Updates repeater ESP-NOW bridge firmware to upstream MeshCore v1.16.0."
    changes:
      - type: changed
        area: upstream
        text: "Updated the repeater ESP-NOW bridge firmware base to upstream MeshCore v1.16.0."
      - type: changed
        area: board
        text: "Included upstream board, radio, UI, and platform fixes from MeshCore dev."
    breaking_changes: []

  - track: observer-eastmesh
    version: "2026.5.1"
    tag: "observer-eastmesh-v2026.5.1"
    date: "2026-05-23"
    previous_version: "1.4.0"
    summary: "Renames the EastMesh MQTT repeater release track and PlatformIO targets to Observer naming."
    changes:
      - type: changed
        area: release
        text: "Renamed the EastMesh MQTT release tag format from `repeater-mqtt-eastmesh-v*` to `observer-eastmesh-v*`."
      - type: changed
        area: build
        text: "Renamed `*_repeater_mqtt` PlatformIO environments and release artifact prefixes to `*_repeater_observer`."
      - type: docs
        area: docs
        text: "Updated EastMesh release, local build, board, web panel, API, and CLI documentation to use Observer naming."
    breaking_changes:
      - "The EastMesh MQTT release tag format and PlatformIO target suffix changed to Observer naming."

  - track: observer-eastmesh
    version: "2026.6.0"
    tag: "observer-eastmesh-v2026.6.0"
    date: "2026-06-03"
    previous_version: "2026.5.1"
    summary: "Updates Observer firmware with the latest upstream MeshCore dev changes plus EastMesh web panel, MQTT, radio, and board support fixes."
    changes:
      - type: added
        area: mqtt
        text: "Added configurable custom MQTT broker support alongside the curated EastMesh and LetsMesh endpoints."
      - type: added
        area: build
        text: "Added Station G3 ESP32 Observer firmware targets."
      - type: added
        area: cli
        text: "Added `flood.max.unscoped` so unscoped flood packets can use a separate hop limit from scoped flood traffic."
      - type: fixed
        area: web
        text: "Preserved web panel sessions across Wi-Fi reconnects and hardened OTA startup from the local web panel."
      - type: fixed
        area: radio
        text: "Hardened LilyGo T-Beam 1W radio setup and restored the missing SX126x register patch."
      - type: changed
        area: upstream
        text: "Merged upstream MeshCore dev updates including sensor handling, RAK4631 BME680/BSEC support, documentation refreshes, and board/platform fixes."
    breaking_changes: []

  - track: observer-eastmesh
    version: "2026.6.1"
    tag: "observer-eastmesh-v2026.6.1"
    date: "2026-06-07"
    previous_version: "2026.6.0"
    summary: "Updates Observer firmware to upstream MeshCore v1.16.0 with flood-advert controls and board/platform fixes."
    changes:
      - type: added
        area: cli
        text: "Added `flood.max.advert` so flooded advert packets can use their own hop limit."
      - type: changed
        area: upstream
        text: "Merged upstream MeshCore v1.16.0 dev updates including companion UI, board, radio, power-saving, documentation, and platform fixes."
      - type: docs
        area: docs
        text: "Updated EastMesh custom CLI docs for the new `flood.max.advert` command."
    breaking_changes: []

  - track: observer-eastmesh-bridge-espnow
    version: "2026.5.1"
    tag: "observer-eastmesh-bridge-espnow-v2026.5.1"
    date: "2026-05-23"
    previous_version: "1.4.0"
    summary: "Renames the EastMesh MQTT bridge release track and PlatformIO targets to Observer ESP-NOW naming."
    changes:
      - type: changed
        area: release
        text: "Renamed the EastMesh MQTT bridge release tag format from `repeater-mqtt-bridge-eastmesh-v*` to `observer-eastmesh-bridge-espnow-v*`."
      - type: changed
        area: build
        text: "Renamed `*_repeater_mqtt_bridge` PlatformIO environments and release artifact prefixes to `*_repeater_observer_espnow`."
      - type: docs
        area: docs
        text: "Updated EastMesh release, local build, board, and CLI documentation to use Observer ESP-NOW naming."
    breaking_changes:
      - "The EastMesh MQTT bridge release tag format and PlatformIO target suffix changed to Observer ESP-NOW naming."

  - track: observer-eastmesh-bridge-espnow
    version: "2026.6.0"
    tag: "observer-eastmesh-bridge-espnow-v2026.6.0"
    date: "2026-06-03"
    previous_version: "2026.5.1"
    summary: "Updates Observer ESP-NOW bridge firmware with the latest upstream MeshCore dev changes plus EastMesh radio, web, MQTT, and board support fixes."
    changes:
      - type: added
        area: mqtt
        text: "Added configurable custom MQTT broker support alongside the curated EastMesh and LetsMesh endpoints."
      - type: added
        area: build
        text: "Added Station G3 ESP32 Observer ESP-NOW firmware targets."
      - type: added
        area: cli
        text: "Added `flood.max.unscoped` so unscoped flood packets can use a separate hop limit from scoped flood traffic."
      - type: fixed
        area: web
        text: "Preserved web panel sessions across Wi-Fi reconnects and hardened OTA startup from the local web panel."
      - type: fixed
        area: radio
        text: "Hardened LilyGo T-Beam 1W radio setup and restored the missing SX126x register patch."
      - type: changed
        area: upstream
        text: "Merged upstream MeshCore dev updates including sensor handling, RAK4631 BME680/BSEC support, documentation refreshes, and board/platform fixes."
    breaking_changes: []

  - track: observer-eastmesh-bridge-espnow
    version: "2026.6.1"
    tag: "observer-eastmesh-bridge-espnow-v2026.6.1"
    date: "2026-06-07"
    previous_version: "2026.6.0"
    summary: "Updates Observer ESP-NOW bridge firmware to upstream MeshCore v1.16.0 with flood-advert controls and board/platform fixes."
    changes:
      - type: added
        area: cli
        text: "Added `flood.max.advert` so flooded advert packets can use their own hop limit."
      - type: changed
        area: upstream
        text: "Merged upstream MeshCore v1.16.0 dev updates including companion UI, board, radio, power-saving, documentation, and platform fixes."
      - type: docs
        area: docs
        text: "Updated EastMesh custom CLI docs for the new `flood.max.advert` command."
    breaking_changes: []