various tidyups

docs/tplink_deco_guest_wifi_recovery.txt

@@ -0,0 +1,67 @@
+TP-Link Deco Guest Wi-Fi Recovery Archive
+==========================================
+
+Version: 1.0.0
+Created: 2026-09-02
+Project: P026 Flounder downstairs guest-area controls
+
+Purpose
+-------
+
+This archive preserves the locally maintained TP-Link Deco Guest Wi-Fi
+customisation. The upstream tplink_deco integration does not provide this
+service or sensor. Reinstalling or overwriting custom_components/tplink_deco
+can remove them.
+
+Archive
+-------
+
+File: docs/tplink_deco_guest_wifi_recovery_2026-09-02.tgz
+SHA-256: 452ed7b7be5e8c469dc7740d5297959179204d24593a22c965f1915ca727c48d
+
+Contents
+--------
+
+- custom_components/tplink_deco/api.py
+- custom_components/tplink_deco/__init__.py
+- custom_components/tplink_deco/const.py
+- custom_components/tplink_deco/services.yaml
+- custom_components/tplink_deco/coordinator.py
+- custom_components/tplink_deco/binary_sensor.py
+- packages/tplink_deco_guest_wifi.yaml
+
+Behaviour Preserved
+-------------------
+
+- Service: tplink_deco.set_guest_network
+- Service field: enable (boolean)
+- Router state: binary_sensor.data_cupboard_new_sundamage_12_deco_guest_network
+- Requested state: input_boolean.wifi_guest_network
+- Flounder control: the requested-state helper; the package reconciles it to
+  the router-confirmed sensor.
+- Write protocol: read each returned wireless band, retain its host, guest and
+  backhaul settings, set only guest.enable, add radio.channel from host.channel,
+  write each band separately, then read back and verify every written band.
+- Deco firmware can return a malformed successful response containing
+  {"error_code": 0}; the integration accepts that response only for writes and
+  relies on the read-back verification as the final confirmation.
+
+Recovery Procedure
+------------------
+
+1. Stop before updating, reinstalling, or deleting custom_components/tplink_deco.
+2. Verify the archive checksum above.
+3. Extract the archive from /homeassistant, preserving the listed paths.
+4. Run Home Assistant configuration validation and Python compilation for the
+   restored integration files.
+5. Restart Home Assistant. A restart is required for custom integration code.
+6. Confirm tplink_deco.set_guest_network is registered and the Guest Network
+   binary sensor is available before operating Guest Wi-Fi.
+
+Update Policy
+-------------
+
+Do not replace custom_components/tplink_deco with an upstream or HACS update
+without first comparing it to this archive and deliberately reapplying the
+Guest Wi-Fi customisation. The archive contains no credentials, tokens, session
+cookies, or router address.