ha(H1): pyfglair — cffi-ядро (очередь событий), wheel, CLI discover/monitor

- CMake: shared-таргет fgl-aircon-shared (FGL_BUILD_SHARED, PIC, SOVERSION)
- C-API: fgl_prop_raw_range + кольцевые очереди событий/логов
  (fgl_session_poll/wait_events, fgl_log_poll/wait_events): прямые колбэки
  из потоков ядра со стеком 8 КБ небезопасны для интерпретатора Python
- pyfglair: _corebuild (cmake->wheel), _cffi (ABI), Session (reader-поток ->
  loop.call_soon_threadsafe), templates (интроспекция C-таблиц), provision
  (aiohttp), CLI discover/monitor + esphome-secrets
- setup.py/pyproject: платформенный wheel py3-none-linux_x86_64 с .so
- tests/pyfglair: templates, provision (мок-облако), session + CLI против
  mock_ac.py; scripts/py-ci.sh; ci.sh запускает python-часть

README.md

@@ -13,9 +13,10 @@ See [`docs/PROTOCOL.md`](docs/PROTOCOL.md) for the protocol reference and
 include/fgl-aircon/   public API (types, templates, session, C API for cffi)
 src/ayla/             Ayla LAN protocol: crypto, envelope, HTTP, session loop
 src/aircon/           property templates A/B/F, conversions, API implementation
+pyfglair/            Python bindings (cffi) for Home Assistant (docs/PLAN_HOME_ASSISTANT.md)
 components/          ESPHome external component      (planned, docs/PLAN_ESPHOME.md)
 custom_components/   Home Assistant custom component (planned, docs/PLAN_HOME_ASSISTANT.md)
-tests/               ayla (protocol), aircon (conversions), tools
+tests/               ayla (protocol), aircon (conversions), pyfglair, tools
 examples/cli/        fglctl — sample CLI
 tools/               fglair-discover, protocol probes
 ```
@@ -78,6 +79,20 @@ session scenarios against a Python mock of the module).
 `tests/aircon` covers template tables and conversions.
 No hardware needed.
 
+## pyfglair (Home Assistant)
+
+`pyfglair/` — python-пакет (cffi, ABI-режим) поверх того же C-ядра: сессия с
+доставкой событий в asyncio, интроспекция шаблонов и облачный discovery.
+
+```sh
+pip install .                # wheel: cmake собирает libfgl-aircon.so
+python -m pyfglair discover --region eu --email you@example.com
+python -m pyfglair monitor --config config_home.json --duration 60
+```
+
+Тесты (без железа: mock-модуль + мок-облако):
+`scripts/py-ci.sh --setup && scripts/py-ci.sh` (или `pytest tests/pyfglair`).
+
 ## Getting the key (`lanip_key`)
 
 The key is static (baked into the AC module; only served by the Ayla cloud):