@switchbot/homebridge-switchbot 5.0.0-beta.111 → 5.0.0-beta.113

package/todo/TODO.md

@@ -1,104 +1,118 @@
-# SwitchBot Plugin TODO List
+# SwitchBot Plugin TODO List (2026)
 
-## Active Tasks
 
-### Bug Fixes (Priority: Critical)
+#### 8. Batch Import
 
-- No active critical bug fixes right now.
+- [x] Add checkboxes to select multiple devices
+- [x] Add "Add Selected to Config" button
+- [x] Implement bulk configuration with smart defaults
+
+- [x] Show firmware update available indicators
+- [x] Show offline/unreachable warnings
+- [x] Add "Needs Attention" section at top
+- [ ] Implement battery level trending (if historical data available)
+
+#### 10. Export/Import Discovery
+
+- [ ] Add "Export Results" button (JSON format)
+- [ ] Add "Import Results" for comparison or troubleshooting
+- [ ] Share with support for debugging
+- [ ] Compare current vs previous discovery (show differences)
+- [ ] Generate discovery report (formatted summary)
 
 ---
 
-## Discovery System Enhancements
+## Bug Fixes & Technical Debt
 
-### Quick Wins (Priority: High)
+### Testing & Quality Assurance
 
-#### 1. Better Loading States
+- [ ] **Test discovery with real hardware**
+  - [ ] Test BLE discovery with nearby devices
+  - [ ] Test OpenAPI discovery with cloud-registered devices
+  - [ ] Test with mixed BLE+API devices
+  - [ ] Test connection type badge display
+  - [ ] Verify deduplication works correctly
 
-- [ ] Show progress indicator: "Scanning BLE... (5s)" → "Fetching OpenAPI..." → "Complete"
-- [ ] Add progress bar or spinner for each discovery phase
-- [ ] Display partial results as they arrive (streaming)
-- [ ] Show elapsed time for each phase
-- [ ] Add "Cancel" button to abort long scans
+- [ ] **Add error handling improvements**
+  - [ ] Better error messages for users
+  - [ ] Retry logic with exponential backoff
+  - [ ] Graceful degradation when BLE unavailable
+  - [ ] Network timeout handling
 
-### Medium Effort (Priority: Medium)
+---
 
-#### 2. Device Grouping
+## Documentation
 
-- [ ] Implement grouping by Hub (show which devices are on which hub)
-- [ ] Implement grouping by Connection Type
-- [ ] Add expandable/collapsible group headers
-- [ ] Show device count per group
-- [ ] Remember expanded/collapsed state
+- [ ] **Update README with discovery features**
+  - [ ] Document BLE vs OpenAPI discovery
+  - [ ] Add screenshots of new UI features
+  - [ ] Explain connection type badges
+  - [ ] Add troubleshooting guide for discovery issues
 
-#### 3. Connection Recommendations
+- [ ] **Create developer documentation**
+  - [ ] Document new modular structure
+  - [ ] API documentation for endpoints
+  - [ ] Contributing guidelines for UI changes
 
-- [ ] Add badge: "⚡ Recommended: BLE" for devices with strong signal (> -70 dBm)
-- [ ] Add badge: "☁️ Recommended: API" for hub-dependent devices
-- [ ] Show tooltip explaining why recommendation is made
-- [ ] Consider device type (some work better with BLE vs API)
+---
 
-#### 4. Configurable BLE Scan
+## Priority Summary
 
-- [ ] Add settings panel with scan duration options (3s/5s/10s/15s)
-- [ ] Add option to disable BLE scanning if no Bluetooth adapter
-- [ ] Add option to adjust BLE timeout
-- [ ] Remember user preferences in localStorage
-- [ ] Show system Bluetooth availability status
+### Must Do (Next Release)
 
-#### 5. Discovery History/Cache
+1. Better Loading States
 
-- [ ] Cache last discovery results for 5 minutes
-- [ ] Show "Last scanned: X minutes ago" with timestamp
-- [ ] Add "Refresh" button to re-scan
-- [ ] Show cached results immediately on page load
-- [ ] Auto-refresh option with configurable interval
+### Should Do (Soon)
 
-#### 6. Detailed Device Info Panel
+1. Connection Recommendations
+2. Device Grouping
+3. Test discovery with real hardware
+4. Update README with new features
 
-- [ ] Add click-to-expand device details panel
-- [ ] Show extended information:
-  - [ ] Battery level (if available)
-  - [ ] Firmware version
-  - [ ] Cloud service enabled/disabled status
-  - [ ] Last seen timestamp
-  - [ ] Full MAC address
-  - [ ] Device capabilities/features
-- [ ] Add "Copy ID" and "Copy MAC" buttons
+### Nice to Have (Future)
 
-### Advanced Features (Priority: Low)
+1. Configurable BLE Scan
+2. Discovery History/Cache
+3. Connection Testing
+4. Batch Import
+5. Device Health Dashboard
 
-#### 7. Real-Time BLE Scanning
+---
+
+## Notes
+
+- See [COMPLETED.md](COMPLETED.md) for all completed features
+- UI mockups available in [mockups/](mockups/) directory
+- Consider user feedback on most-wanted features
+- Test all changes with real SwitchBot devices
+- Maintain backwards compatibility with existing configs
+- Keep UI responsive and fast (< 500ms interactions)
+- Follow Homebridge UI/UX conventions
+# Integration: node-switchbot Beta Updates (March 2026)
+
+## Tasks to Integrate Latest node-switchbot Features
+
+
+## Next Features
+
+### Advanced Features (Priority: Low)
 
-- [ ] Show devices as they're discovered (streaming results)
-- [ ] Add animated "pulsing" indicator for active BLE scan
-- [ ] Update RSSI values in real-time during scan
-- [ ] Show "X devices found..." counter during scan
 
-#### 8. Connection Testing
 
-- [ ] Add "Test Connection" button per device
-- [ ] Attempt to connect and read basic device status
-- [ ] Show success/failure indicator with details
-- [ ] Display connection latency
-- [ ] Show which connection method succeeded (BLE/API)
 
-#### 9. Batch Import
+#### 8. Batch Import
 
 - [ ] Add checkboxes to select multiple devices
 - [ ] Add "Add Selected to Config" button
 - [ ] Implement bulk configuration with smart defaults
-- [ ] Show progress for batch operations
-- [ ] Allow batch enable/disable of devices
 
-#### 10. Device Health Dashboard
 
-- [ ] Show battery warnings (< 20%) with yellow/red indicators
-- [ ] Show firmware update available indicators
-- [ ] Show offline/unreachable warnings
+- [x] Show firmware update available indicators
+- [x] Show offline/unreachable warnings
 - [ ] Add "Needs Attention" section at top
 - [ ] Implement battery level trending (if historical data available)
 
-#### 11. Export/Import Discovery
+#### 10. Export/Import Discovery
 
 - [ ] Add "Export Results" button (JSON format)
 - [ ] Add "Import Results" for comparison or troubleshooting