houseplan-card/docs/reviews/CODE-REVIEW-529-r1.md

CODE-REVIEW-529-r1

Issue: #529 — «Тупик "conflicting wall identifiers": план правится только после ручной чистки» Материал: 85e5d61fb18360a3159000a5f971f62c239d11c7 (два коммита поверх b736878c: 49912ac9 — фикс, 85e5d61f — отпечаток скриншотов) ТЗ: зелёное на r2 (docs/reviews/SPEC-REVIEW-529-r2.md), Medium r1 закрыт до кода Заход: r1 · блокирующих циклов израсходовано 0/4

Скоуп

Диапазон origin/dev..HEAD: custom_components/houseplan/wall_segment_model.py, custom_components/houseplan/validation.py, src/wall-segment-model.ts, scripts/mutation-gate.mjs (3 новых мутанта), тесты (tests_backend/test_wall_segment_model.py, tests_backend/test_ha_import_export.py, test/wall-segment-model.test.mjs), три копии бандла, оба чейнджлога, docs/CONFIG-COMPATIBILITY.md, отпечаток скриншотов документации.

Первый код-ревью-раунд по этой задаче — раздел «объём по дельте» (§2.10) не применяется, разбор полный.

Как проверялось

Гейт	Команда	Результат
Дешёвые гейты на этом SHA	ссылка на Validate	success, https://github.com/Matysh/houseplan-card/actions/runs/34578867814 (headSha = материал ревью)
typecheck + build	npm run bundle:sync (= tsc --noEmit && rollup -c + синхронизация трёх копий)	ok, git status после сборки — дерево чистое: локальная пересборка байт-в-байт совпала с закоммиченным дистом
unit	npm test	2520 passed / 0 failed / 1 skip
no-new-any	node scripts/no-new-any.mjs --base origin/dev --head HEAD	0 новых any (10 добавленных строк в 1 файле)
check-docs	node scripts/check-docs.mjs	ok (7 файлов, 12 внешних ссылок)
выбор смоков	node scripts/smoke-select.mjs --base origin/dev --head HEAD	1 прямое совпадение — demo/smoke_edit_walk.mjs (символ WallSegmentModelError)
смок	node demo/smoke_edit_walk.mjs	ok, все 6 сценариев true
мутанты (патчи применимы)	node scripts/mutation-gate.mjs --check	ok по всем, включая 3 новых
мутанты (реально красят свидетеля)	логи джобов Validate Мутанты по диффу (1/6, 5/6, 6/6) на этом же SHA	все три новых мутанта: ok … тест покраснел, как обязан (см. таблицу AC7 ниже)
бэкенд	python -m pytest tests_backend -q	не прогнан локально — в песочнице нет pytest/pytest_homeassistant_custom_component. Подтверждено джобой Validate «Бэкенд: pytest в Home Assistant: success» на этом самом SHA
golden / полные смоки / perf-смок	—	джобы skipped в Validate (не heavy-событие: обычный push, не PR/release/nightly) — ожидаемо: diff не меняет видимый рендер, AC не требует golden
model invariants на конкретном конфиге	—	не прогонялся: нет спорного экспортированного конфига пользователя; геометрические свойства (сохранение id сегмента, cm, детерминированное разрешение коллизии id) проверены AC2/AC3 напрямую, а npm test уже гоняет инварианты на всех моделях проекта
check-inputs/классификация	job Классификация изменённых файлов: success	подтверждено CI

AC — таблица доказательств

AC	Чем доказан	Чем красится (мутация/негативная проба)
AC1 (backend)	test_empty_room_drafts_on_current_model_are_dropped_silently — прогон в CI Validate (success)	косвенно AC7-мутант #1 (см. ниже)
AC2 (backend)	test_room_drafts_on_current_model_convert_exactly_like_the_first_migration — CI Validate	AC7-мутант room-drafts-refuse-instead-of-heal
AC3 (unit)	test/wall-segment-model.test.mjs, оба новых #529-теста — прогнаны локально (npx tsc -p tsconfig.test.json && node scripts/fix-test-build.mjs && node --test), 2/2 pass	AC7-мутант room-drafts-mirror-still-throws
AC4 (backend)	test_outdated_client_is_recognised_by_the_carrier_not_by_the_model_number (циклы по moduleversion 9 и 10) + неизменённый test_stale_v9_room_draft_write_over_v10_is_rejected_before_schema — CI Validate	AC7-мутант outdated-client-detected-by-model-number
AC5 (backend)	test_legacy_left_in_storage_is_not_treated_as_a_stale_writer (сторож не бросает) + правка теста инварианта схемы (пустой принимается, непустой отвергается) — CI Validate	обратная проба читается в самом тесте (pytest.raises на непустом)
AC5а (unit)	#529: пустой room_drafts снимается молча в test/wall-segment-model.test.mjs — прогнан локально, pass; прочтением подтверждено, что commitWallSegmentModel вызывается в houseplan-editor-runtime.ts:2005,2030,2247,2405 и draft-live-commit.ts:79,168 перед отправкой config/set	AC7-мутант room-drafts-mirror-still-throws
AC6 (backend)	test_export_is_not_locked_by_legacy_room_drafts — не прогнан локально (нет HA-окружения), подтверждён CI Validate («Бэкенд: pytest…: success» на этом SHA) + прочтением: _create_export (import_export.py:507-511) зовёт тот же commit_wall_segment_model, который после фикса не бросает	— (не защитный AC в терминах «отказ», а «перестал отказывать»; негативная проба избыточна)
AC7 (мутанты)	реестр scripts/mutation-gate.mjs, 3 определения	см. ниже — все три подтверждены логами CI на этом SHA
AC8 (ревью кода)	docs/CHANGELOG.md/docs/CHANGELOG.ru.md (в коммите User-Visible: yes), docs/CONFIG-COMPATIBILITY.md — читал текст, совпадает с фактическим кодом	—

AC7 — три мутанта, конкретные строки логов Validate (SHA 85e5d61f)

• room-drafts-refuse-instead-of-heal (возврат raise в питоновской миграции вместо тихого снятия/конвертации) → джоба «Мутанты по диффу (1/6)», 2026-09-11T08:26:31Z ok room-drafts-refuse-instead-of-heal: тест покраснел, как обязан.
• outdated-client-detected-by-model-number (возврат сверки по new_model < 10 вместо not stored_drafts) → джоба «(5/6)», 2026-09-11T08:26:29Z ok outdated-client-detected-by-model-number: тест покраснел, как обязан.
• room-drafts-mirror-still-throws (TS-зеркало снова бросает вместо снятия ключа) → джоба «(6/6)», 2026-09-11T08:27:49Z ok room-drafts-mirror-still-throws: тест покраснел, как обязан.

--check (дешёвая часть, патчи применимы) прогнан локально и тоже зелёный; сам факт «тест умеет падать» проверен по реальным логам прогона мутаций в CI на материале ревью, а не только по заявлению автора.

Что проверено и корректно

1. Порядок вызовов на пути config/set и Optimize. validate_wall_model_transition вызывается раньше CONFIG_SCHEMA в обоих местах (websocket_api.py:1665-1666 и :2033-2042) — риск, который сам автор попросил перепроверить («защита #478 не ослабла»), подтверждён прочтением кода.
2. Механизм самолечения хранилища (К4). commitWallSegmentModel (клиентское зеркало) действительно вызывается перед формированием кандидата config/set во всех точках структурной правки (houseplan-editor-runtime.ts:2005,2030,2247,2405, draft-live-commit.ts:79,168) — второй риск, названный автором, подтверждён прочтением.
3. Идентичность зеркал. Питоновская и TS-версии _migrate_room_drafts_to_partitions/migrateRoomDraftsToPartitions читаются построчно идентично (конверсия драфта в partition, генерация детерминированного id при коллизии, снятие ключа). Паритетная фикстура #282 не тронута и осталась зелёной (npm test).
4. Схемный инвариант (К4а). _config_wall_segment_invariants (validation.py:1923) сменил "room_drafts" in space на space.get("room_drafts") — пустой список больше не триггерит vol.Invalid, непустой по-прежнему триггерит; тест на обе ветки существует и проверен построчно.
5. i18n. Новых ключей нет: toast.wall_model_client_outdated и backup.error.wall_model_client_outdated уже существуют во всех четырёх локалях (en/ru/de/fr) — заявление ТЗ подтверждено.
6. Changelog/докс. Оба чейнджлога в одном коммите с User-Visible: yes; docs/CONFIG-COMPATIBILITY.md переписан согласованно с новым поведением (раздел «Ordinary wall chains — model v10»).
7. Трейлеры и провенанс. Issue: #529 на обоих коммитах; User-Visible: yes только там, где меняется поведение и есть оба чейнджлога; User-Visible: no на doc-коммите отпечатка скриншотов, который правит только screenshots.json (imageSha256 не изменился ни в одном кадре — «identical»-путь, не полная пересъёмка).
8. Одно число — один источник: правка не вводит новых видимых пользователю величин (тексты тостов не менялись); неприменимо.

Находки

Нет. High: 0, Medium: 0.

Одно замечание отмечаю явно, чтобы не выглядело как незамеченное, но не поднимаю до Low: питоновская _migrate_room_drafts_to_partitions использует drafts = space.get("room_drafts") or [] — истинное не-списочное значение (строка/число/словарь) не приводится к [] и не снимается молча, в отличие от TS-зеркала (Array.isArray(...) ? ... : []), что формально не полностью покрывает букву К1 («пустой список или не-список»). Прочтением подтверждено, что это недостижимо на практике: единственная схема room_drafts (validation.py:1743, vol.All([_LEGACY_ROOM_DRAFT_SCHEMA], ...)) требует список уже при записи, и все вызовы commit_wall_segment_model (import_export.py, junction_limits.py, серверный Optimize-путь websocket_api.py:2042-2050) получают конфиг, уже прошедший CONFIG_SCHEMA на предыдущей записи или в этом же вызове раньше. Мёртвый код, не находка.

Чего не проверял

• python -m pytest tests_backend -q локально — нет установленных pytest/pytest_homeassistant_custom_component в песочнице ревью; заменено ссылкой на зелёный прогон Validate на точном SHA материала плюс построчным чтением новых тестов и подтверждением по логам того же прогона, что три относящихся к этой задаче мутанта реально красят своих свидетелей.
• Полный браузерный набор смоков, golden:verify, perf-смок — не запускал: diff не меняет видимый рендер/геометрию отображения, AC их не требует; выбор smoke-select.mjs дал единственное прямое совпадение (smoke_edit_walk), оно прогнано и зелёное.
• npm run invariants -- --config <...> на конкретном экспортированном конфиге пользователя — такого конфига в материале ревью нет (issue не прикладывает файл, только синтетические конфиги автора и мои прогоны тестов); геометрические свойства миграции (сохранение id, cm, детерминированный id при коллизии) проверены напрямую через AC2/AC3 и общий прогон npm test.
• Ручного тестирования в UI не было (в процессе его нет в принципе) — вопрос «работает ли» закрыт цепочкой: клиентский юнит AC5а → серверные бэкенд-тесты AC1/AC2/AC4/AC5/AC6 → мутанты AC7, которые доказывают, что тесты способны упасть.

---

Вердикт: зелёный · заход r1 · блокирующих циклов 0/4 · High: 0 · Medium: 0

---

Материал раунда

• Ветка: issue/529-room-drafts-deadlock, коммит 85e5d61fb183 — ребейз его осиротит, и это нормально: ниже якоря, которые ребейз не меняет.
• Дерево материала: 51dee76b532b9bebeae46a0284f659aeb8be985c

  git log --all --format='%H %T' | grep 51dee76b532b
  

• Тело issue: 817b8acec5b1a72336cf4cb0ecc1c5d583d5a9d5b6fa55d2aea6be5e50190eb1
• Вердикт конвейера: green · High 0