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.