SomnoTrace v4.0.0-beta3

The SomnoBridge release. 🌉 SomnoTrace now pairs, provisions, time-syncs
and pulls therapy data through the Wi-Fi↔BLE bridge — the AirSense's SD
card never has to leave the machine.

beta3 rounds out the release with portal polish from real-world reports:
the SomnoBridge card-provisioning dialog now verifies joins honestly,
and a dashboard stall plus ambiguous "upload" wording that sent a user
on an 18-hour wild goose chase (#345) are fixed.

✨ New since v4.0.0-beta1

💾 SomnoBridge "Configure" dialog — smarter Save & Test

• Join is now verified, not assumed — after saving a custom card
  password, the dialog polls the bridge's real link state
  (GET_STATUS.sta_connected, 1 s × 12) instead of running a redundant
  probe-join. Success shows "Bridge joined the card"; a typo'd password
  gets a clear red error instead of a false "good".
• Security probe only when it matters — the factory-password check
  now runs only when the saved password is 88888888 or the card is
  open. Custom passwords skip it entirely.
• Dialog closes itself on success — the button flips to OK and the
  window auto-dismisses; nothing left to configure means nothing left
  on screen. It stays open on any failure.
• GET_STATUS added to the /api/sb/op proxy whitelist;
  EZSHARE_CHECK timeout raised 25 s → 32 s.

✍️ Portal wording — data-source direction made explicit (#345)

• Pairing card renamed "ResMed Series 11 / SomnoBridge" — covers
  AirSense 11 and AirCurve 11 plus the bridge path (was "ResMed
  AirSense 11 CPAP" even though it pairs a SomnoBridge too).
• Scan button renamed "Scan for ResMed / SomnoBridge".
• Upload Window now states the direction: "days recorded on this
  device are uploaded from SomnoTrace to the destinations above" —
  plus a note that SomnoTrace records live over Bluetooth and cannot
  import history stored on the SD card inside your CPAP machine.
• Reset Upload State description and confirm dialog say the same,
  and now correctly state the upload-window cap instead of "all days".
• Maintenance section says "the SomnoTrace SD card" — no more
  ambiguity about which card an action touches.

🐛 Fixes

• 📊 Dashboard could shimmer forever — with no sessions recorded,
  the "Connecting & loading sessions…" progress bar was never
  dismissed; "No sessions recorded yet" appeared only as a small muted
  line. This is what looked like an 18-hour hang in #345. The dashboard
  now stops loading and explains the empty state in one line.

Everything in v4.0.0-beta1

✨ Highlights

• 🌉 SomnoBridge integration — a complete BLE client (sb_ble,
  ~1.5k LoC): discovery, passkey pairing, bonded GATT ops over the
  framed protocol, streaming file pulls, and a /api/sb/op HTTP proxy
  that drives every bridge op from the portal.
• 🕐 Authoritative UTC & drift correction — SomnoTrace anchors its
  NTP time on the bridge's monotonic clock with periodic exchanges,
  reads back the fitted drift on every sync pass, and applies the
  estimate when importing sessions — AS11 clock wander is corrected
  instead of silently skewing therapy data.
• ⚙️ "Configure SomnoBridge" dialog — card network picker (scrollable
  AP list, OPEN/SECURED badges, saved network), AS10/AS11 machine cards
  with the AS11 GMT-offset picker, an X close button, and an
  insecure-card flow: factory 88888888 and open cards are detected by
  a real probe-join, flagged with a warning, and can be re-secured
  in-place via EZSHARE_ADMIN — the bridge changes the card's own Wi-Fi
  password through its admin form and rejoins automatically.
• 📊 Bridge status in the portal — pairing state, card Wi-Fi,
  therapy-active and transfer-allowed indicators, last sync, and sync
  progress straight from the bridge.
• 📥 Session augmentation — late-recovered stream files now merge
  into already-committed sessions instead of being discarded as
  duplicates; coverage is verified against the manifest and annotations
  are regenerated byte-identically.

🐛 Fixes

• 🗂️ Duplicate recording folders — oximetry day labels are now a pure
  function of the recording's civil digits (ESP-local noon rule) and an
  existing recording_id under any day folder wins — DST/offset changes
  can no longer file one recording under two days.
• 🔁 Uploader fingerprint ping-pong — duplicate recording_ids across
  day folders are deduplicated in reconcile (newest day wins) so two
  files can never take turns invalidating each other's uploads.
• 🛑 Retry storms — any unit that fails 5 uploads is parked and
  retried at most once a day, reviving automatically when its content
  changes. A local anomaly can never again become hours of HTTP 429s.
• 📱 Logs tab scroll — narrow screens no longer open the log view at
  the oldest line of a page-long scrollback.

🏗️ Under the hood

• sb_proto request/response framing with reassembly; BLE ops run off
  the NimBLE host task so provisioning never starves indications.
• Transfer ledger coordination keeps already-downloaded card files from
  re-pulling — zero redundant transfers across reconnects.
• edf_import events rendering extracted behind a byte-identical
  emit-to-file / emit-to-set abstraction for coverage checks.
• AS11 BLE: connection handling improvements alongside the bridge path.

✅ Testing

• New sb_ble_test host suite: 153 checks covering pairing state
  machine, framing, reassembly and op dispatch.
• somno_ml_worker survivor tests: guards, deadlines, SST checks,
  fragment grouping.
• Full host suite: 31 targets, 0 failures, sanitizer-clean.

📚 Docs

• Windows 10/11 SMB share setup guide with screenshots (contributed).