Исправления по третей ночи настоящего использования

Author: saippuakauppias

.github/workflows/ci.yml

@@ -72,8 +72,12 @@ jobs:
 
       # Corrupts one part of the blueprint at a time and asserts the suite
       # notices. A green suite that survives a mutation is a vacuous suite.
+      #
+      # One full suite run per mutation, so this is the long job: serial it is
+      # about half an hour. The mutations are independent and each xdist worker
+      # gets its own sandbox copy, so `-n auto` parallelises them safely.
       - name: Verify the suite detects a broken blueprint
-        run: pytest -v -m slow
+        run: pytest -v -m slow -n auto
 
   ruff:
     name: Python lint

CHANGELOG.md

@@ -3,13 +3,71 @@
 Формат основан на [Keep a Changelog](https://keepachangelog.com/ru/1.1.0/),
 версионирование — [семантическое](https://semver.org/lang/ru/).
 
-## Не выпущено
+## [1.4.0] — 2026-08-04
 
-Документация и инфраструктура; логика блюпринта не менялась, поэтому версия
-осталась прежней.
+Третья ночь на реальном железе. Машина зарядилась до 100 %, но полчаса в начале
+пропали впустую, а под утро регулятор гнал ток с 13 до 28 А за шесть минут.
+
+### Исправлено
+
+- **Потерянная команда включения больше не стоит полчаса.** В 23:06 команда
+  `switch.turn_on` ушла в станцию, и станция её проглотила: выключатель остался
+  `off`. Промах команды не порождает события состояния, а все триггеры блюпринта
+  были либо часами, либо изменением чужой сущности — поэтому повтор случился
+  только на очередном пересчёте в 23:30, через **24 минуты**. Добавлен триггер
+  `command_missed`: выключатель, пролежавший в `off` дольше паузы между
+  командами, поднимает прогон, и включение повторяется в следующую минуту.
+- **Потерянная запись уставки тоже больше не стоит полчаса.** Тем же способом
+  станция теряла и уставку: `11 → 12` писалось в 23:30, 00:00 и 00:30,
+  подействовала только третья запись (возраст уставки при этом рос
+  4761 → 6561 → 8361 с — она не менялась). То же с `13 → 16` в 03:00 и 03:30.
+  Добавлен триггер `setpoint_stale` на застоявшуюся уставку. Ждёт вдвое дольше
+  паузы между командами, иначе срабатывал бы на каждой нормальной записи.
+- **Обрыв связи больше не выглядит как «машина уехала».** Признак физического
+  присутствия («ток идёт — значит машина на месте») проверял выключатель
+  условием «не включён», а недоступный выключатель под это подходит. В третью
+  ночь трекер четыре часа врал `not_home` из-за дрейфа GPS — ровно тот случай,
+  ради которого признак и заведён, — и одного секундного обрыва хватило, чтобы
+  «машина уехала» стало правдой при живых 2616 Вт на сенсоре мощности. Зарядку
+  тогда спасло лишь то, что в тот же миг была недоступна и сама станция.
+  Теперь, как и в остальных местах после 1.3.0, разрушительный вывод делается
+  только по **подтверждённо выключенному** выключателю.
+- **Недодача тока больше не выдумывается на ровном месте.** Сенсор тока станции
+  обновляется с задержкой: под утро он стоял на 11.669 А целых семь минут, пока
+  мощность росла 2592 → 5683 Вт, и «недодача» насчитывалась до 16 А. Теперь
+  величина считается только на установившемся режиме — все завышенные значения
+  в трассировках пришлись ровно на свежую уставку.
+
+### Добавлено
+
+- **«Запас по току, %»** (по умолчанию 10). Станция почти всегда выдаёт меньше
+  заказанного: на уставке 11 А шло 9.9 А. Планировщик считал по уставке и весь
+  вечер отставал незаметно для себя — пока до конца окна далеко, недобор делится
+  на большой остаток времени и тонет в шаге тока. К утру остаток сжимался,
+  и тот же недобор требовал разгона до максимума за минуты. Запас поднимает ток
+  с самого начала, и к утру он плавно снижается вместо рывка. Потолок тока
+  запас не пробивает.
+
+  Реализован множителем, а не прибавкой: прибавка сравнивалась бы с уставкой
+  в зоне нечувствительности и переписывала бы её на каждом пересчёте.
+- **«Не повышать ток начиная с заряда, %»** (по умолчанию 95). На последних
+  процентах BMS сам ограничивает приём, и лишний заказанный ток уже не ускоряет
+  зарядку, а греет батарею. Выше порога уставку можно только снижать. `100` —
+  выключено. Не действует при недостоверных данных о заряде, в мороз и при
+  аварийной дозарядке — там ток нужен весь.
 
 ### Изменено
 
+- **Описание параметра «КПД зарядки» дополнено формулой расчёта.** Раньше
+  предлагались только ориентиры «зимой 80–85, летом 90–93», а подобрать своё
+  число было не из чего. Теперь описано, какие два измерения нужны и как из них
+  посчитать КПД, и явно разделено, что относится к КПД, а что — к недодаче
+  станции (для неё появился отдельный параметр).
+- **Мутационный прогон распараллелен.** Каждая мутация требует отдельного
+  запуска всего набора, поэтому семь десятков мутаций подряд занимали около
+  получаса. Мутации независимы, и каждый воркер работает в своей копии
+  репозитория, поэтому `pytest -m slow -n auto` даёт несколько минут вместо
+  получаса. Добавлена зависимость `pytest-xdist`, CI обновлён.
 - **Документация переехала на сайт** — [saippuakauppias.github.io/ha-ev-smart-charging](https://saippuakauppias.github.io/ha-ev-smart-charging/).
   README похудел с 743 строк до сотни: он остался витриной, а подробности
   разложены по разделам с поиском и навигацией. `IDEAS.md` и `docs/EXAMPLES.md`
@@ -524,6 +582,7 @@
   только когда максимум не делится на дискретность (например 28 А при шаге 5 А).
   Обнаружено мутационным тестированием.
 
+[1.4.0]: https://github.com/saippuakauppias/ha-ev-smart-charging/compare/v1.3.0...v1.4.0
 [1.3.0]: https://github.com/saippuakauppias/ha-ev-smart-charging/compare/v1.2.1...v1.3.0
 [1.2.1]: https://github.com/saippuakauppias/ha-ev-smart-charging/compare/v1.2.0...v1.2.1
 [1.2.0]: https://github.com/saippuakauppias/ha-ev-smart-charging/compare/v1.1.0...v1.2.0

CLAUDE.md

@@ -23,7 +23,7 @@
 
 ```bash
 pytest -m "not slow"     # ~20 с, обычная проверка
-pytest -m slow           # мутации, ~30 мин, перед крупными правками
+pytest -m slow -n auto   # мутации, несколько минут, перед крупными правками
 ruff check tests/ tools/
 yamllint -c .yamllint.yaml blueprints/ .github/ .yamllint.yaml mkdocs.yml
 mkdocs build --strict    # сайт; битая ссылка = падение сборки

CONTRIBUTING.md

@@ -52,7 +52,7 @@
 
 ```bash
 pytest -m "not slow"
-pytest -m slow
+pytest -m slow -n auto
 ruff check tests/ tools/
 yamllint -c .yamllint.yaml blueprints/ .github/ .yamllint.yaml
 ```

README.md

@@ -85,7 +85,7 @@ Home Assistant:
 ```bash
 pip install -r requirements-dev.txt
 pytest -m "not slow"    # весь набор кроме мутаций, около 15 секунд
-pytest -m slow          # мутационное тестирование, около 10 минут
+pytest -m slow -n auto  # мутационное тестирование, несколько минут
 ```
 
 Подробнее — [про устройство тестов](https://saippuakauppias.github.io/ha-ev-smart-charging/development/)