node-switchbot 4.0.0-beta.0 → 4.0.0-beta.10

package/todo/PYSWITCHBOT_COMPARISON.md

@@ -0,0 +1,484 @@
+# pySwitchBot Comparison - Implementation Roadmap
+
+Comprehensive comparison between pySwitchBot (Python) and node-switchbot (TypeScript/Node.js) based on repository analysis performed on March 7, 2026.
+
+## 🔍 Discovery & Advertisement Parsing
+
+### Current Gap
+- **pySwitchBot**: 50+ dedicated device parsers extracting detailed status from advertisements without connection
+- **node-switchbot**: Basic model identification, requires connection for detailed status
+
+### Implementation Tasks
+
+#### High Priority
+- [ ] **Task 1.1**: Create dedicated advertisement parser per device type in `src/devices/`
+  - Bot: Extract `switchMode`, `isOn`, `battery` from advertisements
+  - Curtain: Extract `calibration`, `inMotion`, `position`, `lightLevel`, `deviceChain`
+  - Lock: Extract `sequence_number`, `status`, `door_open`, alarms, `night_latch`
+  - Meter: Extract temperature, humidity, battery
+  - Relay Switch: Extract `sequence_number`, `isOn`, `channel2_isOn`
+
+- [ ] **Task 1.2**: Implement manufacturer data extraction priority
+  - Check service data first (UUID `fd3d`)
+  - Fall back to manufacturer data (IDs: 2409, 741, 89)
+  - Merge data from both sources
+
+- [ ] **Task 1.3**: Add model-to-MAC caching system
+  - Cache discovered device models
+  - Speed up subsequent scans
+  - Store in DeviceManager
+
+#### Medium Priority
+- [ ] **Task 1.4**: Enhance advertisement data structure
+  - Add `rawAdvData` field
+  - Add `isEncrypted` flag
+  - Add `modelFriendlyName` field
+  
+- [ ] **Task 1.5**: Add advertisement data merging
+  - Preserve old values when new data is None
+  - Recursive dict merging for nested structures
+  - Implement `_merge_data()` helper
+
+## 🎮 Control Commands Enhancement
+
+### Bot (WoHand) Commands
+
+#### High Priority
+- [ ] **Task 2.1**: Add `setMode(mode: 'switch' | 'press')` command
+  - Switch mode: Toggle on/off
+  - Press mode: Momentary press
+  - Command: `0x57 0x0F 0x47 0x01 MODE` (MODE: 0x00=press, 0x01=switch)
+
+- [ ] **Task 2.2**: Add `setLongPress(duration: number)` command
+  - Configure press duration (1-255 deciseconds)
+  - Command: `0x57 0x0F 0x47 0x03 DURATION`
+  
+- [ ] **Task 2.3**: Add direct arm control
+  - `handUp()` - Raise arm
+  - `handDown()` - Lower arm
+  - More precise than toggle
+
+### Curtain Commands
+
+#### High Priority
+- [ ] **Task 3.1**: Add speed parameter to movement commands
+  - `open(speed?: number)` - Speed 1-255 (default: 255)
+  - `close(speed?: number)` - Speed 1-255
+  - `setPosition(position: number, speed?: number)` - Position with speed
+  - Command: `0x57 0x0F 0x45 0x01 0x05 MODE SPEED POSITION`
+
+- [ ] **Task 3.2**: Add Curtain 3 specific commands
+  - Support Curtain 3 model detection
+  - Implement multi-command sequences
+  - Add extended info retrieval
+
+#### Medium Priority
+- [ ] **Task 3.3**: Add `getExtendedInfo()` command
+  - Returns device chain information
+  - Grouped curtain status
+  - Command: `0x57 0x0F 0x46 0x01`
+
+### Lock Commands
+
+#### High Priority
+- [ ] **Task 4.1**: Add `unlockWithoutUnlatch()` command
+  - EU firmware feature
+  - Unlocks without unlatching door
+  - Command: Different from standard unlock
+
+- [ ] **Task 4.2**: Implement notification handling
+  - Subscribe to lock notifications
+  - Real-time status updates
+  - Handle unsolicited notifications
+
+- [ ] **Task 4.3**: Add smart lock state detection
+  - Check current state before sending command
+  - Avoid unnecessary unlock/lock commands
+  - Return early if already in target state
+
+#### Medium Priority
+- [ ] **Task 4.4**: Add `getLockInfo()` command
+  - Get detailed lock configuration
+  - Battery, firmware, settings
+  - Command: `0x57 0x02`
+
+### Relay Switch (1PM/2PM) Commands
+
+#### High Priority
+- [ ] **Task 5.1**: Add `toggle()` command
+  - Toggle current state
+  - Command: `0x57 0x0F 0x50 0x01 0x01 0x02`
+
+- [ ] **Task 5.2**: Implement power monitoring
+  - `getBasicInfo()` - Returns voltage, current, power, energy
+  - Parse response: 11 bytes with power data at specific offsets
+  - Command: `0x57 0x02`
+
+- [ ] **Task 5.3**: Add channel-specific control (2PM model)
+  - `setChannel1(state: boolean)`
+  - `setChannel2(state: boolean)`
+  - Detect 2PM vs 1PM model
+
+#### Medium Priority
+- [ ] **Task 5.4**: Add time/energy tracking
+  - `getCurrentTimeAndStartTime()` - For energy calculations
+  - Command: `0x57 0x0F 0x51 0x01 0x05 0x01 0x00 0x00 0x00`
+
+- [ ] **Task 5.5**: Add garage door opener support
+  - Variant of relay switch
+  - Specific command sequences
+  - Model: SwitchBot Relay Switch (garage mode)
+
+### Light (Bulb/Strip) Commands
+
+#### High Priority
+- [ ] **Task 6.1**: Add effect presets (20+ effects)
+  - Christmas, Halloween, Sunset, Rainbow, etc.
+  - Command: `0x57 0x0F 0x47 0x01 EFFECT_ID 0xFF SPEED 0x00 0x00 0x00`
+  - Effect IDs: 0x00-0x13 (20 effects)
+  - Speed: 0x01 (slow) to 0x64 (fast)
+
+- [ ] **Task 6.2**: Add RGBIC segmented control
+  - Control individual LED segments
+  - RGBIC-specific effects
+  - Multi-zone color control
+
+#### Medium Priority
+- [ ] **Task 6.3**: Add color temperature with min/max
+  - `setColorTemp(minTemp: number, maxTemp: number, temp: number)`
+  - Command: `0x57 0x0F 0x47 0x01 0x17 BRIGHTNESS MIN_KEL MAX_KEL TEMP`
+
+- [ ] **Task 6.4**: Implement multi-command sequences
+  - Send multiple commands in series
+  - Used for complex light patterns
+  - Support for Strip Light 3
+
+### Humidifier Commands
+
+#### High Priority
+- [ ] **Task 7.1**: Add humidity level control
+  - `setLevel(level: number)` - Set target humidity (1-100)
+  - Command: `0x57 0x0F 0xXX 0x01 LEVEL` (XX varies by model)
+
+- [ ] **Task 7.2**: Add mode control
+  - `setAuto()` - Automatic mode
+  - `setManual()` - Manual mode
+  - Get target humidity level
+
+### Air Purifier Commands
+
+#### High Priority
+- [ ] **Task 8.1**: Add preset modes
+  - Modes: `level_1`, `level_2`, `level_3`, `auto`, `sleep`, `pet`
+  - `setPresetMode(mode: string)`
+  - Command: `0x57 0x0F 0x4E 0x01 MODE_ID`
+
+- [ ] **Task 8.2**: Add status with AQI/PM2.5
+  - Parse air quality index from response
+  - PM2.5 levels
+  - Fan speed and mode
+
+### Vacuum Commands
+
+#### High Priority
+- [ ] **Task 9.1**: Implement vacuum device classes
+  - K10+, K10+ Pro, K10+ Pro Combo
+  - K11+, K20
+  - S10, S20
+
+- [ ] **Task 9.2**: Add basic vacuum commands
+  - `cleanUp(protocolVersion: number)` - Start cleaning
+  - `returnToDock(protocolVersion: number)` - Return to base
+  - Support protocol versions 1 and 2
+
+- [ ] **Task 9.3**: Add vacuum status getters
+  - Battery level
+  - Work status (cleaning, returning, docked, etc.)
+  - Dustbin status
+  - Network status
+
+## 📊 Status & Response Parsing
+
+### Advertisement-Based Status (No Connection Required)
+
+#### High Priority
+- [ ] **Task 10.1**: Implement passive status from advertisements
+  - Parse device state from BLE advertisements
+  - No connection needed for basic status
+  - Cache last known state
+
+- [ ] **Task 10.2**: Add sequence number tracking
+  - Monitor `sequence_number` in advertisements
+  - Auto-trigger status update when sequence changes
+  - Implement for: locks, relay switches, vacuums, air purifiers
+
+#### Medium Priority
+- [ ] **Task 10.3**: Add calibration status tracking
+  - Parse calibration bit from advertisements
+  - Track for: curtains, blind tilts
+  - Warn if device not calibrated
+
+- [ ] **Task 10.4**: Add direction detection for covers
+  - Track `_is_opening` / `_is_closing` states
+  - Update based on position changes
+  - Help UI show proper icons
+
+### Response Validation
+
+#### High Priority
+- [ ] **Task 11.1**: Add byte-by-byte response validation
+  - Check response length
+  - Validate specific byte positions
+  - Compare against expected value sets: `{1}`, `{1, 5}`, `{1, 6}`
+
+- [ ] **Task 11.2**: Implement password detection
+  - Check for `0x07` (password required)
+  - Check for `0x09` (password incorrect)
+  - Throw specific authentication errors
+
+## 🆕 New Device Types to Add
+
+### High Priority Devices
+
+#### Vacuum Cleaners
+- [ ] **Task 12.1**: K10+ Vacuum
+- [ ] **Task 12.2**: K10+ Pro Vacuum
+- [ ] **Task 12.3**: K10+ Pro Combo Vacuum
+- [ ] **Task 12.4**: K11+ Vacuum
+- [ ] **Task 12.5**: K20 Vacuum
+- [ ] **Task 12.6**: S10 Vacuum
+- [ ] **Task 12.7**: S20 Vacuum
+
+#### Lock Variants
+- [ ] **Task 13.1**: Lock Lite
+- [ ] **Task 13.2**: Lock Vision
+- [ ] **Task 13.3**: Lock Vision Pro
+- [ ] **Task 13.4**: Lock Pro WiFi
+
+#### Relay Switches
+- [ ] **Task 14.1**: Relay Switch 2PM
+- [ ] **Task 14.2**: Garage Door Opener (relay variant)
+
+### Medium Priority Devices
+
+#### Climate Control
+- [ ] **Task 15.1**: Evaporative Humidifier (WoHumi2) - Already exists, enhance
+- [ ] **Task 15.2**: Circulator Fan (Battery/USB)
+- [ ] **Task 15.3**: Smart Thermostat Radiator
+- [ ] **Task 15.4**: Climate Panel
+
+#### Lighting
+- [ ] **Task 16.1**: Strip Light 3
+- [ ] **Task 16.2**: Floor Lamp
+- [ ] **Task 16.3**: RGBICWW Strip Light
+- [ ] **Task 16.4**: RGBICWW Floor Lamp
+- [ ] **Task 16.5**: Art Frame
+
+#### Other
+- [ ] **Task 17.1**: Plug Mini EU - Already exists, verify
+- [ ] **Task 17.2**: Roller Shade
+- [ ] **Task 17.3**: Keypad Vision
+- [ ] **Task 17.4**: Keypad Vision Pro
+- [ ] **Task 17.5**: Hub3 - Already exists, enhance
+- [ ] **Task 17.6**: HubMini Matter
+
+**Total New Devices:** ~30+ device types/variants to add or enhance
+
+## 🔐 Encryption & Security
+
+### High Priority
+
+- [ ] **Task 18.1**: Implement GCM encryption mode
+  - AES128-GCM cipher support
+  - 12-byte IV for GCM (vs 16-byte for CTR)
+  - Include 2-byte authentication tag
+  - Skip auth verification (firmware returns partial tag)
+
+- [ ] **Task 18.2**: Add automatic encryption mode detection
+  - Detect CTR vs GCM from device response
+  - Command: `0x57 0x0F 0x21 0x03 KEY_ID` to get IV
+  - Parse response to determine mode
+
+- [ ] **Task 18.3**: Implement IV increment for GCM
+  - Increment IV after each encrypted command
+  - Reset IV on reconnection
+  - Track current IV state
+
+- [ ] **Task 18.4**: Add encryption for relay switches
+  - Newer relay switches require encryption
+  - Same key retrieval process as locks
+
+- [ ] **Task 18.5**: Add encryption for air purifiers
+  - Newer air purifiers require encryption
+  - Command encryption for all control commands
+
+- [ ] **Task 18.6**: Add encryption for light strips
+  - Newer light strips require encryption
+  - Effect commands need encryption
+
+### Medium Priority
+
+- [ ] **Task 18.7**: Add encryption state reset on disconnect
+  - Clear IV, cipher, encryption mode
+  - Re-initialize on next connection
+  - Handle firmware updates that change encryption
+
+- [ ] **Task 18.8**: Implement key verification
+  - `verifyEncryptionKey()` - Test key validity
+  - Try commands with key before assuming valid
+  - Better error messages for invalid keys
+
+## ⚠️ Error Handling
+
+### High Priority
+
+- [ ] **Task 19.1**: Add specific BLE exceptions
+  - `SwitchbotOperationError` - Operation failures
+  - `SwitchbotAuthenticationError` - Auth failures
+  - `CharacteristicMissingError` - BLE characteristic missing
+
+- [ ] **Task 19.2**: Implement command result verification
+  - `checkCommandResult()` validates response bytes
+  - Expected value sets: `{1}`, `{1, 5}`, `{1, 6}`
+  - Throw errors with hex result, index, expected values, RSSI
+
+- [ ] **Task 19.3**: Add password verification responses
+  - Check for `0x07` byte (password required)
+  - Check for `0x09` byte (password incorrect)
+  - Throw `SwitchbotAuthenticationError` with context
+
+### Medium Priority
+
+- [ ] **Task 19.4**: Enhance retry logic
+  - DBus error backoff (0.25s)
+  - `BLEAK_RETRY_EXCEPTIONS` handling
+  - Better context in retry errors
+
+- [ ] **Task 19.5**: Add response length validation
+  - Check minimum expected length
+  - Throw errors for truncated responses
+  - Include actual vs expected length in error
+
+## 🔗 Connection Management
+
+### High Priority
+
+- [ ] **Task 20.1**: Implement persistent connection with timer
+  - Keep connection open for 8.5 seconds after last command
+  - Reset timer on each command
+  - Allows command batching without reconnecting
+
+- [ ] **Task 20.2**: Add operation lock
+  - Prevent concurrent BLE operations
+  - `_operation_lock` async lock
+  - Wait for operations to complete before disconnecting
+
+- [ ] **Task 20.3**: Implement command batching
+  - Queue multiple commands
+  - Send in sequence on single connection
+  - Share connection overhead
+
+### Medium Priority
+
+- [ ] **Task 20.4**: Add expected disconnect tracking
+  - `_expected_disconnect` flag
+  - Differentiate expected vs unexpected disconnects
+  - Better error handling for unexpected disconnects
+
+- [ ] **Task 20.5**: Implement notification handling
+  - Per-command notification futures
+  - Timeout handling (5s default)
+  - Log unsolicited notifications
+
+- [ ] **Task 20.6**: Add characteristic caching
+  - Cache read/write characteristics
+  - Clear cache on characteristic missing error
+  - Avoid repeated characteristic discovery
+
+## ✨ Advanced Features
+
+### High Priority
+
+- [ ] **Task 21.1**: Implement sequence device pattern
+  - `SequenceDevice` base class
+  - Monitor `sequence_number` from advertisements
+  - Auto-trigger `update()` when sequence changes
+  - Use for: locks, relay switches, vacuums, air purifiers
+
+- [ ] **Task 21.2**: Add override state during connection pattern
+  - `DeviceOverrideStateDuringConnection` base class
+  - Ignore advertisement data while connected
+  - Prevents stale data issues
+  - Use for: bot, plugs
+
+### Medium Priority
+
+- [ ] **Task 21.3**: Add multi-command support
+  - `sendMultipleCommands()` - Send series, return if any succeed
+  - `sendCommandSequence()` - Send series, must all succeed
+  - Used for Curtain 3 and newer devices
+
+- [ ] **Task 21.4**: Implement basic settings command
+  - `getBasicInfo()` - Universal settings retrieval
+  - Returns: battery, firmware, device-specific settings
+  - Command: `0x57 0x02`
+
+- [ ] **Task 21.5**: Add mode setting commands
+  - Universal mode setting command: `0x57 0x03`
+  - Extended settings command
+  - Per-device mode enums
+
+### Low Priority
+
+- [ ] **Task 21.6**: Add passive polling
+  - `PASSIVE_POLL_INTERVAL = 60 * 60 * 24` (24 hours)
+  - `pollNeeded()` method
+  - Auto-poll inactive devices periodically
+
+- [ ] **Task 21.7**: Implement cloud device fetching
+  - `getDevices()` - Fetch devices from SwitchBot account
+  - Auto-populate model cache from cloud
+  - Handle regional APIs (US/CN/EU)
+
+## 📋 Implementation Priority Guide
+
+### Phase 1: Critical Functionality (Q1 2026)
+1. Curtain speed control (Task 3.1)
+2. Advertisement-based status (Task 10.1, 10.2)
+3. Encryption GCM mode (Task 18.1-18.3)
+4. Command result verification (Task 19.2, 19.3)
+5. Persistent connections (Task 20.1, 20.2)
+
+### Phase 2: Command Enhancement (Q2 2026)
+1. Bot mode/settings (Task 2.1, 2.2)
+2. Lock advanced features (Task 4.1-4.3)
+3. Light effects (Task 6.1)
+4. Relay switch power monitoring (Task 5.1, 5.2)
+5. Sequence device pattern (Task 21.1)
+
+### Phase 3: New Devices (Q3 2026)
+1. Vacuum cleaners (Task 12.1-12.7)
+2. Lock variants (Task 13.1-13.4)
+3. Climate control (Task 15.1-15.4)
+4. Lighting variants (Task 16.1-16.5)
+
+### Phase 4: Advanced Features (Q4 2026)
+1. Multi-command sequences (Task 21.3)
+2. Override state pattern (Task 21.2)
+3. Passive polling (Task 21.6)
+4. Cloud device fetching (Task 21.7)
+
+## 🎯 Success Metrics
+
+- **Feature Parity**: 90%+ of pySwitchBot commands implemented
+- **Device Coverage**: 95%+ of SwitchBot device types supported
+- **Status Accuracy**: Advertisement-based status for all devices
+- **Connection Efficiency**: 50% reduction in connection overhead via batching
+- **Error Clarity**: Specific error types for all failure modes
+
+## 📚 References
+
+- **pySwitchBot Repository**: https://github.com/Danielhiversen/pySwitchbot
+- **SwitchBot BLE API**: https://github.com/OpenWonderLabs/SwitchBotAPI-BLE
+- **Current node-switchbot**: v4.0.0 with macOS BLE compatibility
+- **Analysis Date**: March 7, 2026

package/todo/README.md

@@ -0,0 +1,68 @@
+# TODO Management
+
+This folder tracks the implementation roadmap for achieving feature parity with pySwitchBot.
+
+## Files
+
+- **[todo.md](./todo.md)** - All pending implementation tasks organized by phase and priority
+- **[completed.md](./completed.md)** - Completed tasks with dates and notes
+- **[../PYSWITCHBOT_COMPARISON.md](../PYSWITCHBOT_COMPARISON.md)** - Full comparison analysis and detailed task specifications
+
+## Workflow
+
+### When Starting a Task
+1. Pick a task from `todo.md` (preferably in priority order)
+2. Create a branch for the task if needed
+3. Implement the feature following the specifications in PYSWITCHBOT_COMPARISON.md
+
+### When Completing a Task
+1. Check the box in `todo.md`: `- [ ]` → `- [x]`
+2. Cut the completed task from `todo.md`
+3. Paste it into `completed.md` under the appropriate phase
+4. Add completion date: `(Completed: YYYY-MM-DD)`
+5. Add implementation notes if there were deviations or interesting details
+6. Update "Last Updated" timestamp in both files
+7. Commit both files together
+
+### Example Completion Entry
+
+```markdown
+- [x] **Task 3.1**: Add speed parameter to curtain movement commands (Completed: 2026-03-15)
+  - Implemented in `src/devices/wo-curtain.ts`
+  - Added validation for speed range 1-255
+  - Updated tests to cover speed parameter
+  - PR: #123
+```
+
+## Task Organization
+
+Tasks are organized by:
+
+### Phase
+- **Phase 1**: Critical Functionality (Q1 2026) - Core features needed immediately
+- **Phase 2**: Command Enhancement (Q2 2026) - Additional commands and features
+- **Phase 3**: New Devices (Q3 2026) - Support for new device types
+- **Phase 4**: Advanced Features (Q4 2026) - Nice-to-have optimizations
+
+### Priority
+- **High Priority**: User-facing functionality, critical gaps
+- **Medium Priority**: Enhancements, optimizations
+- **Low Priority**: Nice-to-have features
+
+## Current Status
+
+Track overall progress:
+
+- **Phase 0**: ✅ Complete (BLE infrastructure hardening)
+- **Phase 1**: 🟡 In Progress
+- **Phase 2**: ⏳ Not Started
+- **Phase 3**: ⏳ Not Started
+- **Phase 4**: ⏳ Not Started
+
+## Quick Links
+
+- [View Pending Tasks](./todo.md)
+- [View Completed Tasks](./completed.md)
+- [Full Comparison Document](../PYSWITCHBOT_COMPARISON.md)
+- [pySwitchBot Repository](https://github.com/Danielhiversen/pySwitchbot)
+- [SwitchBot BLE API](https://github.com/OpenWonderLabs/SwitchBotAPI-BLE)

package/todo/completed.md

@@ -0,0 +1,134 @@
+# Completed Tasks
+
+Track completed implementation tasks from the pySwitchBot comparison roadmap.
+
+Last Updated: March 7, 2026
+
+---
+
+## Phase 0: Foundation & Preparation ✅
+
+### BLE Infrastructure Hardening (Completed March 6, 2026)
+- [x] Add enumerable device properties for Homebridge compatibility
+- [x] Implement ID-based BLE lookups for macOS (empty MAC address support)
+- [x] Add manufacturer data MAC extraction fallback
+- [x] Broaden discovery filters for legacy UUIDs (000d)
+- [x] Add peripheral validation (connectable flag, RSSI bounds)
+- [x] Implement BLE event listener cleanup
+- [x] Add connection error cleanup (characteristics discovery failure)
+- [x] Create BLE lifecycle regression tests
+- [x] Fix resource leaks (event listeners, connection maps)
+
+### Testing & Validation (Completed March 6-7, 2026)
+- [x] 124 unit tests passing
+- [x] BLE scanner lifecycle tests
+- [x] BLE connection cleanup tests
+- [x] macOS compatibility validation (45 real devices)
+
+---
+
+## Phase 1: Core Parity Sprint ✅
+
+### Completed March 7, 2026
+- [x] Advertisement status parsing and model cache support
+	- Added richer advertisement parsing for Bot, Curtain/Curtain3, Lock/Lock Pro, and Relay Switch models
+	- Added per-discovery model cache in `BLEScanner`
+	- Stored parsed BLE service data on device info for status fallback
+
+- [x] Curtain speed control
+	- Added optional speed to `open`, `close`, and `setPosition` commands
+	- Updated BLE payload and OpenAPI `setPosition` parameter construction
+
+- [x] GCM/CTR BLE encryption plumbing
+	- Added encryption mode (`auto`/`ctr`/`gcm`) support in `BLEConnection`
+	- Added IV length validation, auto mode resolution, and GCM IV increment behavior
+
+- [x] BLE command result and password response validation
+	- Added command response checks for ack bytes (`0x01`, `0x05`, `0x06`)
+	- Added password-required (`0x07`) and password-incorrect (`0x09`) detection
+
+- [x] Persistent BLE connections + operation locking
+	- Added per-device operation lock queue in `BLEConnection`
+	- Added configurable persistent connection timer with auto-disconnect
+	- Added device-level BLE command serialization in base device class
+
+---
+
+## Phase 2: Command Enhancement (Wave 1) ✅
+
+### Completed March 7, 2026
+- [x] Bot mode configuration
+	- Implemented `setMode('press'|'switch')`, `setLongPress(duration)`, `handUp()`, and `handDown()` on `WoHand`
+
+- [x] Lock advanced features
+	- Implemented `unlockWithoutUnlatch()` on `WoSmartLockPro`
+	- Added smart pre-checks to skip lock/unlock when already in target state
+	- Added `getLockInfo()` helper on lock devices
+	- Added BLE notification subscription hooks for lock updates
+
+- [x] Light effect presets
+	- Added 20 preset effects with `setEffect(effectName, speed)` on `WoBulb`/`WoStrip`
+
+- [x] Relay power monitoring
+	- Added relay basic-info parsing for voltage/current/energy from BLE response payload
+	- Integrated parsed metrics into relay BLE status response
+
+- [x] Phase 2 regression coverage
+	- Added `test/phase2-features.test.ts` covering Bot mode config, lock smart detection, light effects, and relay metrics parsing
+
+---
+
+## Phase 2: Command Enhancement (Wave 2) ✅
+
+### Completed March 7, 2026
+- [x] Relay 2PM channel-specific control (Task 5.3)
+	- Created `WoRelaySwitch2PM` class extending `WoRelaySwitch1`
+	- Implemented `setChannel1(state: boolean)` and `setChannel2(state: boolean)` methods
+	- Added channel-specific command constants (CHANNEL1_ON/OFF, CHANNEL2_ON/OFF) to DEVICE_COMMANDS.RELAY
+
+- [x] Bulb color temperature with min/max bounds (Task 6.3)
+	- Added `setColorTemp(minTemp, maxTemp, temp)` method to `WoBulb` class
+	- Command format: `0x57 0x0F 0x47 0x01 0x17 BRIGHTNESS MIN_KEL MAX_KEL TEMP`
+	- Validates and clamps temperatures, ensures current temp within min/max bounds
+	- Auto-corrects reversed min/max values
+
+- [x] RGBIC bulb segmented control (Task 6.2)
+	- Created `WoRGBICBulb` class extending `WoBulb`
+	- Implemented `setSegmentColor(segmentId, r, g, b)` for individual LED segment color control
+	- Implemented `setSegmentEffect(segmentId, effectName, speed)` for segment-specific effects
+	- Added 25 RGBIC effects including segment_cycle, segment_wave, segment_chase, segment_strobe, segment_twinkle
+	- Inherits all standard bulb features from WoBulb (standard effects, color temperature bounds)
+
+- [x] Phase 2 Wave 2 regression coverage
+	- Added `test/phase2-remaining.test.ts` with 21 tests covering Relay 2PM channels, color temperature bounds, and RGBIC segmented control
+
+---
+
+## Phase 2: Advanced Features ✅
+
+### Completed March 7, 2026
+- [x] Sequence device pattern (Task 21.1)
+	- Added `SequenceDevice` base class
+	- Tracks advertisement `sequenceNumber` changes and emits `sequence-changed`
+	- Auto-triggers `update()` on sequence changes with in-flight suppression
+	- Applied to lock, relay switch, and air purifier device families
+	- Added regression coverage in `test/sequence-device.test.ts`
+
+- [x] Override state during connection pattern (Task 21.2)
+	- Added `DeviceOverrideStateDuringConnection` base class
+	- Ignores advertisement state (`bleServiceData`, battery, RSSI) while BLE connection is active
+	- Prevents stale advertisement fallback state during live connections
+	- Applied to bot and plug device families
+	- Added regression coverage in `test/device-override-state-during-connection.test.ts`
+
+---
+
+## Notes
+
+When moving a task from todo.md to this file:
+1. Add the completion date
+2. Note any implementation details or deviations
+3. Link to relevant PRs or commits if applicable
+4. Update "Last Updated" timestamp
+
+Format: `- [x] **Task X.Y**: Description (Completed: YYYY-MM-DD)`