v0.15.7

docs/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.1.0",
   "info": {
     "title": "GREE Controller API",
-    "version": "0.15.6",
+    "version": "0.15.7",
     "summary": "Local HTTP/WebSocket API for GREE Controller",
     "description": "Local API used by the GREE Controller Web UI and Home Assistant integration.",
     "license": {
@@ -204,7 +204,7 @@
           "Devices"
         ],
         "summary": "Scan for local GREE devices",
-        "description": "Broadcasts GREE discovery and returns local device candidates without persisting or binding them. protocol_version=1 or 2 strictly accepts only that protocol; protocol_version=0 accepts both.",
+        "description": "Broadcasts GREE discovery and returns local device candidates without persisting or binding them. The scan envelope is not treated as the device protocol: Auto decodes replies, uses inner ver metadata as a V1/V2 hint and keeps unresolved candidates as protocol 0. Explicit protocol_version=1 or 2 returns only candidates whose resolved hint matches the selected generation.",
         "operationId": "scanDiscoveredDevices",
         "requestBody": {
           "required": true,
@@ -262,7 +262,7 @@
           "Devices"
         ],
         "summary": "Add selected discovered devices",
-        "description": "Persists and binds only the local discovery candidates selected by the caller. Each selected unit is bound strictly with the protocol version detected during the scan.",
+        "description": "Persists and binds only the local discovery candidates selected by the caller. Auto-discovered candidates use their protocol hint as the preferred bind order, fall back to the other generation, and persist the protocol that actually succeeds. Candidates from explicit V1/V2 discovery are bound strictly.",
         "operationId": "addDiscoveredDevices",
         "requestBody": {
           "required": true,
@@ -281,7 +281,8 @@
                     "protocol_version": 1,
                     "model": "GREE",
                     "firmware": "",
-                    "already_added": false
+                    "already_added": false,
+                    "protocol_locked": false
                   }
                 ]
               }
@@ -5966,7 +5967,7 @@
           },
           "version": {
             "type": "string",
-            "example": "0.15.6"
+            "example": "0.15.7"
           },
           "uptime_seconds": {
             "type": "integer",
@@ -6685,7 +6686,7 @@
           },
           "protocol_version": {
             "type": "integer",
-            "description": "0=auto/both, 1=AES-ECB, 2=AES-GCM",
+            "description": "0=auto/both with protocol hint + bind verification, 1=AES-ECB only, 2=AES-GCM only",
             "minimum": 0,
             "maximum": 2,
             "example": 0
@@ -9663,10 +9664,16 @@
           "protocol_version": {
             "type": "integer",
             "enum": [
+              0,
               1,
               2
             ],
-            "description": "Detected protocol generation"
+            "description": "Discovery protocol hint: 0=unknown/auto, 1=legacy AES-ECB, 2=AES-GCM"
+          },
+          "protocol_locked": {
+            "type": "boolean",
+            "default": false,
+            "description": "True when discovery explicitly selected V1 or V2; false for Auto so binding may verify/fallback"
           },
           "model": {
             "type": "string",