Release v1.3.0: OTA scheduling, MQTT Inspector, Backup, cleaner option rows

[tashda]

Summary

Closes the v1.3.0 milestone. Twelve issues:

• [Feature]: Remove inline descriptions from device state/action cards #13 Cleaner device option rows — drops the verbose Z2M schema description text under each row title in device state/action cards.
• [Feature]: Add OTA actions to device long-press menu in device list #15 OTA actions in long-press menu — Check for Update (always when OTA-supported), and when an update is available, both Update Now and Schedule Update are exposed regardless of power source. Power source informs ordering: battery devices list Schedule first as the recommended path, mains devices list Update Now first. Cancel Scheduled Update appears when the device is in the scheduled phase.
• [Feature]: Schedule OTA update for sleepy/battery devices #12 Schedule OTA for sleepy/battery devices — Z2M's schedule and unschedule topics, AppStore optimistic helpers, ViewModel methods, plus integration in three places: (1) device list long-press menu, (2) device detail (...) menu (same battery-aware ordering), (3) 'Check All for Updates' bulk action — mains devices route through the existing rate-limited check queue; battery devices fire schedule requests directly. Device row badge shows 'Scheduled' for the scheduled phase.
• [Feature]: MQTT topic explorer (Developer Mode) #21 MQTT Inspector (Developer Mode) — toggle in Settings → General. When on, exposes a Developer section with an MQTT Inspector (Subscribe + Publish tabs). Subscribe streams every inbound topic + payload with substring filter, pause, clear, 1000-message ring buffer. Publish sends arbitrary topic + JSON or string payload, with a confirm prompt for bridge/request/* destinations.
• [Feature]: Backup management — trigger and download Z2M backups #19 Backup management — Settings → Tools → Backup. Triggers bridge/request/backup, decodes the returned base64 zip, writes to a temp file, presents iOS share sheet for save / AirDrop / iCloud Drive. Persists a metadata-only history list. Restore explicitly out of scope.
• [Bug]: Harden backup pipeline — frame size, base64 strictness, integrity check #30 Harden backup pipeline — three guardrails on the backup save path so users can rely on the file: (1) raise URLSessionWebSocketTask.maximumMessageSize from the 1 MB default to 64 MB so large real-world backups don't exceed the WS frame limit and disconnect, (2) decode base64 with .ignoreUnknownCharacters to tolerate whitespace/newlines that some MQTT serializers insert, (3) post-write integrity check — verify the file is non-empty and starts with the ZIP magic bytes (50 4B 03 04), surface a failed status and delete the partial file otherwise.
• [Bug]: Connecting without a valid token to a token-required server shows empty homepage instead of failing #27 Fail connection when auth token is missing/invalid — Z2M accepts the WS HTTP 101 upgrade and only then closes with code 1008 when the token is missing/invalid. Previously we marked the session connected on didOpen and navigated to the homepage; the close arrived afterwards and was treated as a normal disconnect. Now Z2MWebSocketSessionDelegate records any close that arrives after the open, and Z2MWebSocketClient waits a 600ms settle window post-handshake to surface the rejection as a connection failure with a clear "Check the auth token." message. The user stays on the connection screen.
• [Feature]: Tighten settings labels for iOS-style consistency #28 Tighten settings labels for iOS-style consistency — sweep across every bridge-settings page to align with iOS Settings conventions while keeping Z2M vocabulary on the wire. Underlying flags (disable_automatic_update_check, force_disable_retain, disable_led) remain Z2M-canonical; only UI bindings flip.
  • Negated toggles flipped to positive labels with inverted bindings: OTA "Disable Automatic Checks" → "Enable Automatic Checks"; MQTT "Disable Message Retain" → "Retain Messages"; Adapter "Disable Adapter LED" → "Adapter LED" (default ON).
  • Truncated OTA Transfer Timing labels shortened: "Transfer Request Timeout" → "Request Timeout", "Delay Between Blocks" → "Block Delay".
  • Units inlined with the value (never parenthesised in the label): MQTT "Max Packet Size (bytes)" → InlineIntField "Max Packet Size" with unit bytes.
  • Redundant unit words dropped: "Reconnect Attempts" → "Reconnect Limit", "Concurrent Requests" → "Concurrency", "Pause After Retries" → "Pause After".
  • Section / row redundancy collapsed: "Recent Events on Home" → "Recent Events"; both Availability "Offline Timeout" rows → "Timeout"; Health section "Health Check Interval" → "Interval"; Network section "Hardware Tuning" → "Adapter Tuning"; Adapter section "Adapter" → "Connection".
  • Verb-prefix toggles → noun: HA "Use Legacy Action Sensor" → "Legacy Action Sensor", "Use Event Entities" → "Event Entities".
  • Sentence-case fixed: "Automatically share crash reports" → "Automatically Share Crash Reports".
• [Feature]: Restructure App settings — split Live Activities, slim General, rename Performance #29 Restructure App settings — split Live Activities, slim General, rename Performance — App → General had three unrelated jobs under a misleading "Connection" header with a four-line footer covering all of them.
  • New "Live Activities" subpage (AppLiveActivitiesView) under Application, owns the three LA toggles ("Connection", "OTA Updates", "Scheduled OTAs") split across two sections each with a one-line focused footer.
  • AppGeneralView slimmed to: Appearance / Home / Connection (Reconnect Limit only, one-line footer) / Diagnostics / Advanced (Developer Mode now sits under a proper section header instead of floating).
  • App → Performance renamed to "Bulk OTA" — the page only ever contained that one feature, the previous broad title overpromised. Redundant inner section header removed; Settings root link label updated to match.
• Inline writable numerics in device settings — match iOS Settings idiom #31 Inline writable numerics in fan settings — under the fan state/action card, writable numeric settings (e.g. countdown_hours, timers) used to render as a row that pushed a near-empty detail screen containing only a slider. They now render inline within the same List row — label + value on top, slider beneath — matching the iOS Settings idiom (Display & Brightness, Accessibility → Display & Text Size). The hero card and indexed-group disclosure rows are untouched; NumericDetailView is removed.
• [Feature]: Replace custom Behaviour/section card with native List (insetGrouped) on Fan screen #26 Replace custom Behaviour/section card with native List on Fan screen — subsumed by Native iOS Settings sections beneath every category card for leftover exposes #32. Fan's grouped sections (and every other category's) now render as native List Sections with system headers, dividers, dynamic-type, and VoiceOver behaviour, instead of hand-rolled VStack + secondarySystemGroupedBackground cards. The custom sectionView path on FanControlCard is retained only for snapshot contexts (LogDetailView) where there's no surrounding List.
• Native iOS Settings sections beneath every category card for leftover exposes #32 Native iOS Settings sections beneath every category card for leftover exposes — extends the fan pattern to every device category. Hero cards stay exactly as they are; anything the hero doesn't bind to a primary control drops down as native iOS Settings Sections beneath. linkquality and identify* are always hidden (already surfaced on the device card / noisy diagnostics).
  • New shared primitives: Shared/Components/SettingsFormRow.swift (Expose-driven row with inline slider for writable numerics) and Shared/Components/DeviceExtras.swift (eligibility filter with alwaysHidden list).
  • New per-category section views: LightFeatureSections, SwitchFeatureSections, ClimateFeatureSections, CoverFeatureSections. Fan's existing FanFeatureSections keeps its richer layout (indexed groups + bespoke filter card).
  • Light card: gains rendersAdvancedSheetsInline flag (default true for snapshot contexts). DeviceDetailView passes false, dropping the sunrise (Startup) and ellipsis (More) buttons from inside the card and rendering them as native sections beneath. Effects (sparkles) stays in the card — it's a real light-specific control, not configuration.
  • Switch / Climate / Cover: previously-orphaned exposes (power-on behaviour, child lock, fan mode, preset, calibration, motor speed, etc.) now appear beneath their card grouped via FeatureLayout into proper Behaviour / Indicators / Maintenance / Status / More sections — same taxonomy fan already uses, no flat "Configuration" dump.
  • DeviceDetailView reorganised around a single heroAndSettingsSections(for:state:) builder that dispatches per category — replaces the prior fan-vs-everything-else if/else.
  • Startup ordering: LightControlContext.startupFeatures now sorts so Power-On Behavior leads (Z2M's headline startup setting), followed by state_startup → current_level_startup → color_temp_startup → hue/saturation → execute_if_off. Rows get explicit display labels ("Power-On Behavior", "Startup State") instead of the prettifier's title-cased default.
  • Color-temp parity: the Startup section's "Color Temperature" row now uses the same LightTemperatureControl swatch + tinted slider as the hero card, instead of a plain numeric slider — adjusting startup temperature reads identically to adjusting the live one.
  • Indexed-group sheet (Shared/Components/FeatureGroupDetailView.swift) and section-row dispatcher (DeviceFeatureSectionRow.swift) extracted from fan into shared components so every category renders identical "N members →" disclosures for time1…time5-style indexed families.

Version bumped to 1.3.0.

Closes

• Closes [Feature]: Schedule OTA update for sleepy/battery devices #12
• Closes [Feature]: Remove inline descriptions from device state/action cards #13
• Closes [Feature]: Add OTA actions to device long-press menu in device list #15
• Closes [Feature]: Backup management — trigger and download Z2M backups #19
• Closes [Feature]: MQTT topic explorer (Developer Mode) #21
• Closes [Feature]: Replace custom Behaviour/section card with native List (insetGrouped) on Fan screen #26
• Closes [Bug]: Connecting without a valid token to a token-required server shows empty homepage instead of failing #27
• Closes [Feature]: Tighten settings labels for iOS-style consistency #28
• Closes [Feature]: Restructure App settings — split Live Activities, slim General, rename Performance #29
• Closes [Bug]: Harden backup pipeline — frame size, base64 strictness, integrity check #30
• Closes Inline writable numerics in device settings — match iOS Settings idiom #31
• Closes Native iOS Settings sections beneath every category card for leftover exposes #32

Test plan

• Fast CI passes on PR
• Long-press a battery device with an update available → Schedule Update appears first, then Update Now
• Long-press a mains device with an update available → Update Now appears first, then Schedule Update
• Long-press an OTA-supported device with no update available → only Check for Update appears
• Schedule a battery device → row shows 'Scheduled' badge; long-press menu shows Cancel Scheduled Update
• Devices screen → 'Check All for Updates' → mains devices show 'Checking', battery devices show 'Scheduled'
• Device detail (...) menu mirrors the same Schedule / Update Now / Cancel Scheduled actions
• Settings → General → toggle Developer Mode → Developer section appears
• MQTT Inspector Subscribe / Publish tabs work
• Settings → Tools → Backup → Create Backup completes and produces a valid zip via the share sheet
• Connect to mock bridge with no token (when AUTH_TOKEN is set on the bridge) → connection fails with "Check the auth token." error, user stays on connection screen
• Connect to mock bridge with wrong token → same behaviour, error surfaced
• Connect to mock bridge with correct token → connection succeeds and homepage loads with content (verifies the 600ms settle window doesn't break the happy path)
• Settings → OTA Updates: toggle reads "Enable Automatic Checks" and is on when bridge has automatic checks enabled (covered by testOTAAutomaticChecksLabelIsPositive)
• Settings → OTA Updates → Transfer Timing: "Request Timeout", "Block Delay", "Block Size" all visible without truncation (covered by testOTATransferTimingLabelsVisible)
• Settings → MQTT → Advanced: toggle reads "Retain Messages" (positive); "Max Packet Size" row shows the value with "bytes" trailing (covered by testMQTTRetainLabelIsPositive, testMQTTMaxPacketSizeLabelHasNoParenthesisedUnit)
• Settings → Adapter: toggle reads "Adapter LED" and is on by default (covered by testAdapterLEDLabelIsPositive)
• Settings → Home Assistant → Compatibility: toggles read as nouns ("Legacy Action Sensor", "Event Entities") with no "Use" prefix (covered by testHomeAssistantTogglesAreNouns)
• Settings → General + Performance: numeric labels do not duplicate their unit ("Reconnect Limit", "Concurrency"); covered by testNumericLabelsDoNotRepeatUnit
• Settings → Availability: timeout rows under each power-source section read "Timeout", not "Offline Timeout" (covered by testAvailabilityTimeoutRowsAreUnqualified)
• Settings → App → "Live Activities" link present, opens dedicated page with all three toggles (covered by testLiveActivitiesHasOwnPage)
• Settings → App → General no longer hosts the LA toggles; Reconnect Limit remains (covered by testGeneralNoLongerHostsLiveActivities)
• Settings → App → "Bulk OTA" replaces "Performance"; navigation pushes a page titled "Bulk OTA" (covered by testBulkOTAReplacesPerformance)
• Backup hardening — Z2MWebSocketClient raises maximumMessageSize to 64 MB on connect (unit test asserts task config)
• Backup hardening — saveBackup decodes base64 with embedded newlines/whitespace successfully (unit test feeds a hand-crafted base64 with \n separators)
• Backup hardening — saveBackup rejects a non-zip payload (wrong magic bytes) and surfaces failed status, partial file is deleted (unit test)
• Backup hardening — saveBackup rejects empty/zero-byte payload and surfaces failed (unit test)
• Backup hardening — happy-path manual: drive seeder to emit a >1 MB backup zip, confirm Shellbee receives it without disconnect and the saved file passes unzip -t
• Open Attic Tuya Fan detail → "Countdown Hours" row in the settings sections renders an inline slider directly beneath the label/value, without tapping; tapping the row does not push a new screen (covered by testFanWritableNumericRendersInline)
• Open Bathroom Fan detail → hero speed slider still works, settings sections (LED, Child Lock) unchanged
• NumericDetailView is gone — no dedicated "Value" page is reachable from any fan settings row
• Open Bedroom Hue → light card shows the Effects (sparkles) button but no longer the sunrise (Startup) or ellipsis (More) buttons; "Startup" and other categorised sections appear as native iOS Settings sections beneath the card (covered by testLightAdvancedFeaturesRenderAsSettingsSections)
• Open Office Inovelli Fan Switch → previously-hidden switch settings (power-on behaviour, child lock, indicator config) appear beneath the card grouped into Behaviour / Indicators / etc. via FeatureLayout
• Open a thermostat → fan_mode / preset / calibration / eco features that were previously dropped now surface in their proper FeatureLayout sections
• Open Bedroom Curtain → calibration / motor settings (when present) surface in the right FeatureLayout section
• No category surfaces "Linkquality" or "Identify" as a settings row (covered by testFeatureSectionsHideLinkqualityAndIdentify)
• Open Dining Candle Bulb → Startup section leads with Power-On Behavior (not "Color Temperature" or "Apply Settings While Off"); explicit display labels show "Power-On Behavior" / "Startup State" instead of the prettifier's default
• Open Dining Candle Bulb → Startup → Color Temperature row uses the same swatch (2.7K / 3K / 4K / 5K / 6.5K) + tinted slider as the hero light card, not a plain numeric slider

🤖 Generated with Claude Code