bridge/CHANGELOG.md

Changelog

[2.0.1] - 2026-04-25

Fixed

• TUI quit no longer hangs on a misleading "updating DHT" screen. The 2.0.0 migration to iroh-gossip-rendezvous removed the synchronous mainline-DHT publish that the old Gossip::shutdown() performed (rendezvous entries age out instead), but the TUI flow was unchanged: pressing q drew an "updating DHT…" overlay, awaited swarm.shutdown(), and only then restored the terminal — so the user sat on the stale message for as long as endpoint.close() took to flush in-flight connections. Restore the terminal the moment q is pressed, drop the overlay, and cap the graceful-shutdown wait at 2 s so a slow endpoint close can't stall the process.

[2.0.0] - 2026-04-23

Breaking

• Partition-healing / DHT-rendezvous extracted to its own crate. The 700+ lines of gossip-partition-healing logic in src/gossip.rs are now the iroh-gossip-rendezvous crate on crates.io (pinned here at ^0.1). Any downstream code that reached into bridge::gossip::* for partition types needs to import from iroh_gossip_rendezvous::* instead. The normative protocol spec moved with the code — dht-partition-healing.md at the bridge root is now a pointer to the new crate's PROTOCOL.md.
• iroh and iroh-gossip bumped 0.97 → 0.98 (major; carries iroh's own breaking changes through to any bridge consumers that import from those crates transitively).

Changed

• Direct deps mainline, sha2, zeroize removed — all now reachable transitively via iroh-gossip-rendezvous. Closure is smaller and the rendezvous concern lives in exactly one place.
• donglora-client version spec loosened "1.0.0" → "1". Patch and minor releases of the client propagate on the next cargo build / cargo install without a bridge re-publish; already-released donglora-client 1.0.1 (CH340K USB bridge support) is picked up automatically.

[1.0.1] - 2026-04-22

Security

• Bump both pinned rand versions past RUSTSEC-2026-0097 (rand is unsound with a custom log::Log impl that calls rand::rng() at trace/warn level and hits the 64 KB reseed path):

  • rand 0.9.2 → 0.9.4 (fix >= 0.9.3).
  • rand 0.8.5 → 0.8.6 (fix >= 0.8.6).

  The advisory is only reachable under a very narrow set of conditions (custom logger invoking rand::rng() during a reseed while emitting trace-level logs, or warn-level with a failed getrandom). We are not known to do that, but shipping the upgrade is the right call.

[1.0.0] - 2026-04-22

Breaking

• Upgraded to donglora-client 1.0.0-alpha.1 (DongLoRa Protocol v2 wire protocol). Wire-incompatible with 0.x firmware. Connect/config/TX/RX all go through the new async Dongle API.
• Radio loop is now a tokio task, not a dedicated std::thread. Everything is async end-to-end.
• [radio] config schema changes:
  • tx_power renamed to tx_power_dbm and is now a plain i8 (no "max" keyword — v1.0 exposes a concrete dBm range via GET_INFO).
  • cad field removed — CAD is a per-TX flag in v1.0, not a config property. The [tx] section's skip_cad (default false) controls it.
  • Default sync_word changed 0x3444 → 0x1424 to match the SX126x register encoding of MeshCore's private sync byte (RADIOLIB_SX126X_SYNC_WORD_PRIVATE).

Added

• TX retry with backoff (new [tx] config section). Every TX now runs through Dongle::tx_with_retry, which retries TX_DONE(CHANNEL_BUSY) and ERR(EBUSY) per spec PROTOCOL.md §6.10 / §C.5.5. Defaults: 3 attempts, randomized 20–100 ms backoff, doubling up to 500 ms cap, 5 s per-attempt timeout. Configurable via [tx] keys max_attempts, backoff_min_ms, backoff_max_ms, backoff_cap_ms, backoff_multiplier, per_attempt_timeout_secs.
• TUI packet log shows retry state. In-flight retries render with a ↻ marker in yellow and an N/M attempt counter. Terminal TX failures render in red with ✗. Post-retry success shows the final attempt count (OK 2/3).
• Stats: tx_retries and tx_failures counters. Lifetime totals, surfaced in the StatsSnapshot.
• Measured airtime from TX_DONE is now reported instead of a theoretical estimate, feeding the rate limiter with the real on-air duration.

Removed

• The explicit 2-second liveness ping loop in the radio thread. The Dongle now runs a 500 ms keepalive task internally, matching spec §3.4's 1 s inactivity window with 2× margin.

[0.3.1] - 2026-04-07

Fixed

• Sticky mux reconnect. Once the bridge connects via mux, all subsequent reconnects use mux-only mode (connect_mux_auto). Previously, each reconnect re-ran the full mux→USB fallback chain, which could steal the serial port from the mux during a brief disconnect.

[0.3.0] - 2026-04-07

Changed

• Upgraded to donglora-client 0.2: all connections now auto-validate via ping-on-connect, rejecting non-DongLoRa serial devices within 200ms.
• Simplified connection logic — removed manual mux/serial fallback and manual ping; donglora_client::connect() handles the full fallback chain and validation internally.
• Config negotiation detects mux vs serial via transport type instead of string comparison.

Fixed

• Repository and homepage URLs now point to github.com/donglora/bridge (was swaits/donglora-bridge).
• README links updated to donglora GitHub org.

[0.2.2] - 2026-04-06

Fixed

• TUI now fits in 80-column terminals (was 86).

[0.2.1] - 2026-04-06

Fixed

• CI: removed stale sibling-clone step, added libudev-dev dependency, upgraded actions/checkout to v5 (Node.js 24).

[0.2.0] - 2026-04-06

Added

• Auto-detect connection mode: when no port is configured, the bridge now tries the mux daemon first and falls back to direct USB serial (find_port()) if the mux is unavailable. Previously it would retry the mux forever.

Changed

• Config negotiation on direct serial connections now pushes SetConfig with the desired radio config when it differs from the dongle's current config. On mux connections, the existing behavior (accept the mux's config) is unchanged.

[0.1.0] - 2026-04-06

Initial release.