feat: Capability-Based Entity Filtering (v0.5.0)

.github/agents/copilot-instructions.md

@@ -8,6 +8,8 @@ Auto-generated from all feature plans. Last updated: 2026-03-07
 - YAML (Home Assistant Lovelace dashboard format) + Home Assistant 2025.x+, HACS (optional), mushroom cards (optional), card-mod (optional) (004-lovelace-dashboard)
 - N/A — static YAML files and PNG image assets (004-lovelace-dashboard)
 - N/A — no production Python code changes; only JSON, YAML, and text files + HACS validation action (`hacs/action`), hassfest action (`home-assistant/actions/hassfest`), GitHub Actions (005-hacs-packaging)
+- Python 3.13+ (Home Assistant 2025.x minimum) + `aiohttp` (HA-bundled HTTP client), `homeassistant` core APIs (`DataUpdateCoordinator`, `Entity`, `ConfigEntry`) (006-capability-entity-filtering)
+- In-memory caching on `SmartDataCoordinator` instance; no persistent storage needed (006-capability-entity-filtering)
 
 - Python 3.13+ (matching Home Assistant Core 2025.x minimum) + `aiohttp` (via HA's `async_get_clientsession`), `homeassistant` core APIs (config_flow, DataUpdateCoordinator, entity platforms, device registry, diagnostics) (001-hello-smart-foundation)
 
@@ -27,9 +29,9 @@ cd src [ONLY COMMANDS FOR ACTIVE TECHNOLOGIES][ONLY COMMANDS FOR ACTIVE TECHNOLO
 Python 3.13+ (matching Home Assistant Core 2025.x minimum): Follow standard conventions
 
 ## Recent Changes
+- 006-capability-entity-filtering: Added Python 3.13+ (Home Assistant 2025.x minimum) + `aiohttp` (HA-bundled HTTP client), `homeassistant` core APIs (`DataUpdateCoordinator`, `Entity`, `ConfigEntry`)
 - 005-hacs-packaging: Added N/A — no production Python code changes; only JSON, YAML, and text files + HACS validation action (`hacs/action`), hassfest action (`home-assistant/actions/hassfest`), GitHub Actions
 - 004-lovelace-dashboard: Added YAML (Home Assistant Lovelace dashboard format) + Home Assistant 2025.x+, HACS (optional), mushroom cards (optional), card-mod (optional)
-- 003-api-command-controls: Added Python 3.13+ (matching Home Assistant Core 2025.x minimum) + `aiohttp` (via HA's `async_get_clientsession`), `homeassistant` core APIs (config_flow, DataUpdateCoordinator, entity platforms, device registry)
 
 
 <!-- MANUAL ADDITIONS START -->

.vscode/settings.json

@@ -9,6 +9,7 @@
     "chat.tools.terminal.autoApprove": {
         ".specify/scripts/bash/": true,
         ".specify/scripts/powershell/": true
-    }
+    },
+    "java.jdt.ls.vmargs": "-XX:+UseParallelGC -XX:GCTimeRatio=4 -XX:AdaptiveSizePolicyWeight=90 -Dsun.zip.disableMemoryMapping=true -Xmx4G -Xms100m -Xlog:disable"
 }
 

API/README.md

@@ -1,17 +1,15 @@
 # Smart Vehicle Cloud API Reference
 
-Complete documentation of all GET API endpoints consumed by the Hello Smart Home Assistant integration. These endpoints are reverse-engineered from the Smart mobile app APKs (EU and INTL variants) and validated against the live API.
-
-> **Read-only endpoints only.** POST/PUT command endpoints (lock, unlock, climate control, etc.) are not yet implemented.
+Complete documentation of all API endpoints consumed by the Hello Smart Home Assistant integration. These endpoints are reverse-engineered from the Smart mobile app APKs (EU and INTL variants) and validated against the live API.
 
 ---
 
 ## Documentation
 
 | Document | Description |
 |----------|-------------|
-| [Common Patterns](common-patterns.md) | Base URLs, request signing, response envelope, error codes, data types |
-| [Endpoint Index](index.md) | Quick-reference table for all 22 endpoints |
+| [Common Patterns](common-patterns.md) | Base URLs, request signing, response envelope, error codes, command controls |
+| [Endpoint Index](index.md) | Quick-reference table for all 22+ endpoints |
 | [Data Models](models.md) | Enumerations, dataclasses, and type definitions |
 | [Entity Mapping](entities.md) | How API data maps to Home Assistant entities |
 

API/common-patterns.md

@@ -173,3 +173,175 @@ ota.srv.smart.com
 ```
 
 Only HTTPS requests are permitted. Requests to unlisted hosts are rejected with `SmartAPIError`.
+
+---
+
+## Vehicle Commands (PUT)
+
+Vehicle control commands are sent via PUT to the telematics endpoint:
+
+```http
+PUT {base_url}/remote-control/vehicle/telematics/{vin}
+```
+
+Headers: Standard [signed headers](#required-headers) with `authorization` token. The request body must be serialised with **no spaces** (`json.dumps(payload, separators=(",",":"))`).
+
+### Command Payload Envelope
+
+```json
+{
+  "creator": "tc",
+  "command": "start",
+  "serviceId": "RDL_2",
+  "timestamp": "1706028240000",
+  "operationScheduling": {
+    "duration": 6,
+    "interval": 0,
+    "occurs": 1,
+    "recurrentOperation": false
+  },
+  "serviceParameters": [
+    {"key": "param.name", "value": "param_value"}
+  ]
+}
+```
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `creator` | string | Always `"tc"` |
+| `command` | string | `"start"` or `"stop"` |
+| `serviceId` | string | Service identifier (see table below) |
+| `timestamp` | string | Epoch milliseconds |
+| `operationScheduling.duration` | int | Command duration in minutes |
+| `operationScheduling.interval` | int | Always `0` |
+| `operationScheduling.occurs` | int | Always `1` |
+| `operationScheduling.recurrentOperation` | bool/int | `false` (or `0` for charging) |
+| `serviceParameters` | array | Key/value pairs specific to each service |
+
+> **Charging exception**: The `rcs` service uses `"timeStamp"` (camelCase) and `"recurrentOperation": 0` (integer) instead of the standard `"timestamp"` and `false`.
+
+### Service IDs & Parameters
+
+#### Door Lock / Unlock
+
+| Service ID | Command | Parameters | Description |
+|------------|---------|------------|-------------|
+| `RDL_2` | `start` | *(none)* | Lock all doors |
+| `RDU_2` | `start` | *(none)* | Unlock all doors |
+
+#### Climate Control
+
+| Service ID | Command | Parameters | Description |
+|------------|---------|------------|-------------|
+| `RCE_2` | `start` | `rce.conditioner=1`, `rce.temp={temp}` | Start HVAC at target temperature |
+| `RCE_2` | `stop` | `rce.conditioner=1` | Stop HVAC |
+
+- Temperature is in °C as a string (e.g., `"22"`)
+- Default duration is 30 minutes
+
+#### Seat Heating
+
+| Service ID | Command | Parameters | Description |
+|------------|---------|------------|-------------|
+| `RSH` | `start` | `rsh.seat={seat}`, `rsh.level={level}` | Set seat heating level |
+
+**Seat keys**: `front-left`, `front-right`, `steering_wheel`
+
+**Level values**: `0` (off), `1` (low), `2` (medium), `3` (high)
+
+#### Seat Ventilation
+
+| Service ID | Command | Parameters | Description |
+|------------|---------|------------|-------------|
+| `RSV` | `start` | `rsv.seat={seat}`, `rsv.level={level}` | Set seat ventilation level |
+
+**Seat keys**: `front-left`
+
+**Level values**: `0` (off), `1` (low), `2` (medium), `3` (high)
+
+#### Horn & Lights (Find My Car)
+
+| Service ID | Command | Parameters | Description |
+|------------|---------|------------|-------------|
+| `RHL` | `start` | `rhl.horn=1` | Sound horn |
+| `RHL` | `start` | `rhl.flash=1` | Flash lights |
+| `RHL` | `start` | `rhl.horn=1`, `rhl.flash=1` | Find my car (horn + flash) |
+
+#### Windows
+
+| Service ID | Command | Parameters | Description |
+|------------|---------|------------|-------------|
+| `RWS_2` | `start` | `rws.close=1` | Close all windows |
+
+#### Charging
+
+| Service ID | Command | Parameters | Description |
+|------------|---------|------------|-------------|
+| `rcs` | `start` | `operation=1`, `rcs.restart=1` | Start charging |
+| `rcs` | `start` | `operation=0`, `rcs.terminate=1` | Stop charging |
+
+> Note: Charging uses `command: "start"` for **both** start and stop — the `operation` parameter controls the action.
+
+#### Mini-Fridge
+
+| Service ID | Command | Parameters | Description |
+|------------|---------|------------|-------------|
+| `UFR` | `start` | `ufr.status=1` | Turn on fridge |
+| `UFR` | `stop` | `ufr.status=0` | Turn off fridge |
+
+#### Fragrance Diffuser
+
+| Service ID | Command | Parameters | Description |
+|------------|---------|------------|-------------|
+| `RFD_2` | `start` | `rfd.status=1` | Turn on fragrance |
+| `RFD_2` | `stop` | `rfd.status=0` | Turn off fragrance |
+
+#### Vehicle Tracking (VTM)
+
+| Service ID | Command | Parameters | Description |
+|------------|---------|------------|-------------|
+| `VTM` | `start` | `vtm.enabled=1` | Enable vehicle tracking |
+| `VTM` | `stop` | `vtm.enabled=0` | Disable vehicle tracking |
+
+#### Locker
+
+| Service ID | Command | Parameters | Description |
+|------------|---------|------------|-------------|
+| `RPC` | `start` | `rpc.lock=1` | Lock storage locker |
+| `RPC` | `start` | `rpc.unlock=1` | Unlock storage locker |
+
+### Command Response
+
+```json
+{
+  "code": 1000,
+  "data": { ... },
+  "success": true,
+  "message": "operation succeed"
+}
+```
+
+The integration checks top-level `success` first, then falls back to `data.success`.
+
+### Command Flow
+
+1. **Select vehicle** — `POST /device-platform/user/session/update` with the target VIN
+2. **Send command** — `PUT /remote-control/vehicle/telematics/{vin}` with the payload
+3. **Cooldown** — 5-second per-VIN cooldown between commands
+4. **Delayed refresh** — 8-second delay before polling for updated state
+
+### Charging Reservation (PUT)
+
+```http
+PUT {base_url}/remote-control/charging/reservation/{vin}
+```
+
+Updates the scheduled charging configuration. Body is the updated reservation object — see [Charging Reservation](endpoints/charging-reservation.md).
+
+### Climate Schedule (PUT)
+
+```http
+PUT {base_url}/remote-control/schedule/{vin}
+```
+
+Updates the climate pre-conditioning schedule. Body is the updated schedule object — see [Climate Schedule](endpoints/climate-schedule.md).