houseplan-card/docs/reviews/CODE-REVIEW-369-r3.md

CODE-REVIEW #369 — заход r3

• Issue: https://github.com/Matysh/houseplan-card/issues/369
• Ветка: issue/369-audit-lows, ревью-SHA 3965475c2d9ee19a2524a03d64f6b00264827233
• Вердикт: зелёный · заход r3 · блокирующих циклов израсходовано 1 из 4 · High: 0 · Medium: 0

Скоуп разбора и почему он полный, а не по дельте

Владелец закрыл предыдущий (r2, красный, H1) вердикт коммитом 2c984d8f на SHA b5c5bff3, затем перебрал ветку набело поверх свежего dev (#366 въехал; в комментарии закрытия явно сказано «ветка пересобрана начисто поверх свежего dev»). b5c5bff3 не существует в текущей истории репозитория (git cat-file -t b5c5bff3 → Not a valid object name) — это не ошибка синхронизации, это последствие ребейза: код на новом основании технически другой (PROCESS §7.2), поэтому по правилу из инструкции этого раунда («ребейз на ушедший вперёд dev... — разбор полный») я разбираю весь диапазон origin/dev..HEAD, а не только изменения после r2, и подтверждаю закрытие r2-H1 прямым чтением кода на текущем SHA, а не диффом от отсутствующего объекта.

merge-base(origin/dev, HEAD) == origin/dev — ветка ровно на один шаг впереди dev содержательно (три коммита: 8ee1c91f, 2c984d8f, 3965475c), несмотря на то что git diff origin/dev...HEAD --stat по всему дереву показывает бандл/скриншоты — это пересборка, не чужой код (проверено: npm run build + bundle:sync воспроизводят те же байты, git status чист после пересборки).

Диапазон диффа по существу (без бандла/скриншотов): assets/furniture/**, demo/smoke_furniture_polish.mjs (новый), docs/{CHANGELOG.md,CHANGELOG.ru.md,FURNITURE.md,USER-GUIDE.md, USER-GUIDE.ru.md,VACUUM.md}, scripts/generate-furniture-assets.mjs, scripts/mutation-gate.mjs, src/{device-presentation.ts,devices.ts, houseplan-card.ts,houseplan-editor-runtime.ts,vacuum.ts}, test/{device-presentation,devices,furniture-assets,vacuum}.test.mjs. Это ровно семь пунктов ТЗ ревизии 2 (docs/specs/369-audit-lows.md) — новой подсистемы дельта не касается.

Закрытие раунда r2

r2 (красный, SHA b5c5bff3) назвал одну блокирующую находку H1 и одну Low.

Находка r2	Чем закрыта	Где это видно
H1 — Shift-слушатели превью мебели переживают Escape (_onKey закрывает палитру прямым присваиванием, минуя _furnShiftDetach)	В ветке e.key === 'Escape' добавлен вызов this._editorRuntime?._furnShiftDetach(); рядом с _clearFurniturePreview()	src/houseplan-card.ts:2807, внутри if (this._decorTool === 'furniture') блока Escape-обработчика (_onKey, decor-режим)
H1 — те же слушатели переживают disconnectedCallback (вызывался только _clearFurniturePreview())	В disconnectedCallback добавлен this._editorRuntime?._furnShiftDetach(); следом за _clearFurniturePreview()	src/houseplan-card.ts:2700, внутри disconnectedCallback() (границы метода — строки 2572–2717, проверено чтением)
Low — дублирующий idempotent-вызов _furnShiftDetach() в _furnPlace	Вызов остался в единственном экземпляре	src/houseplan-editor-runtime.ts:4757 — grep -n _furnShiftDetach по файлу показывает ровно один вызов внутри _furnPlace (было два в r2)

Дополнительное доказательство, не заявленное автором как самостоятельный пункт, но проверенное мной: новый смок получил Escape-регресс (rearmAttachesAgain, escapeClosesPalette, escapeDetachesListeners, demo/smoke_furniture_polish.mjs:146-161) — прогнан, все три ассерта зелёные (см. «Гейты» ниже), и мутант furniture-shift-listeners-not- attached по-прежнему валит именно этот файл, значит регресс способен падать.

Унаследовано из r2

Из документа r2 (не найден в docs/reviews/** — публикация ревью-дока для code-стадии #369, судя по дереву, ещё не коммитилась; текст находки и её разбор взяты из комментария ревьюера в issue от r2, SHA b5c5bff3) принимаю без повторного разбора «с нуля», но перепроверяю на текущем SHA, а не по вере:

• Пункты (а), (б), (в), (г), (ж) — r2 подтвердил их доказанными (автотестом с «умеющим падать» мутантом либо прямым чтением). Я не повторяю продуктовое рассуждение по каждому с нуля, но перечитал итоговый код каждого на 3965475c (см. «Что проверено» ниже), потому что ребейз формально меняет файл целиком и правка H1 живёт в тех же файлах (houseplan-card.ts, houseplan-editor-runtime.ts), где могла задеть соседний код.
• Low «буквально пустой repo-wide grep Matyushin недостижим» — принято ещё на спек-стадии (SPEC-REVIEW-369-r1, раздел о L1/Low), прецедент CODE-REVIEW-269-r1.md. Проверено: grep -rn Matyushin вне docs/specs/** и docs/reviews/** действительно пуст.

Как проверялось (полный разбор, не по дельте — см. выше)

Материал: git log --oneline origin/dev..HEAD, git diff origin/dev...HEAD, тело issue #369, docs/specs/369-audit-lows.md (ревизия 2), все комментарии issue (включая сорванную попытку ревью из-за конфликта слияния и оба реальных раунда). Ручного тестирования в UI не было — весь разбор через код, автотесты и браузерные смоки на реальном собранном бандле.

AC — построчно

1. (а) docs/VACUUM.md получил раздел «Deleting and restoring a vacuum marker (#369)»; docs/USER-GUIDE.md (англ., раздел про пылесосы) и docs/USER-GUIDE.ru.md получили зеркальные абзацы. Прочитано целиком — формулировки согласованы друг с другом и с реальным поведением async_purge_orphans (#335). check-docs не покраснел (структурная часть контракта).
2. (б) smoothVacPath (src/vacuum.ts:250-296) получил параметр warn (default console.warn), считает droppedSegments и вызывает warn(...) один раз на вызов, с числом сегментов, только если droppedSegments > 0. Возврат функции не изменён по структуре (тот же алгоритм отсева). Юнит test/vacuum.test.mjs:461-677 проверяет: 2 из 3 «плохих» сегментов дают ровно один warn с текстом /2 segment/ и /non-finite/; чистый путь не шумит. Мутант vac-trail-drop-warn- removed вырезает вызов warn — юнит падает (проверено запуском).
3. (в) markerClimateTarget (src/devices.ts:1406) — ===null заменено на == null. Юнит test/devices.test.mjs:617-638 проверяет три ветки: отсутствующий ключ area, явный area: null, area: 'kitchen' — все три дают ожидаемый ключ. Мутант climate-legacy- area-undefined-lost возвращает строгое равенство — юнит падает (проверено).
4. (г) controllerAvailability (src/device-presentation.ts:210-231) получил disabledRoster. Прочитал вызов d.entities до места, где он строится (src/devices.ts:1198,1210: entities: entIds, где entIds = bindingStatus.enabledEntityIds при kind==='active') — значит ownEntities.length===0 уже эквивалентно «enabledEntityIds пуст» для устройств bindingKind==='device', и добавленная проверка allEntityIds.length>0 в связке с этим и с внешним ownEntities. length===0 реализует контракт «ростер непуст, но всё отключено» корректно, а не только по счастливой случайности. Отдельно заметил избыточность: дизъюнкт d.bindingStatus?.kind === 'ha_disabled' внутри disabledRoster никогда не меняет результат, потому что итоговое && уже требует d.bindingStatus?.kind === 'active' — мёртвое (но безвредное) условие. Это тот же L1, что SPEC-REVIEW-369-r1 уже принял как Low на спек-стадии («избыточное условие в (г), не блокирует») — не завожу повторно, привожу здесь только как подтверждение, что это старая, а не новая находка. Юниты test/device-presentation.test.mjs:1192-1207 кроют все три случая ((i) истинно безростерный — available, (ii) ростер отключён пользователем — не available, (iii) ha_disabled — гасится на уровне effectiveHidden, не через эту функцию). Мутант opted-out-roster- looks-alive падает (проверено).
5. (д) _furnShiftListener/_furnShiftAttach/_furnShiftDetach (src/houseplan-editor-runtime.ts:4681-4704) — идемпотентны через флаг _furnShiftAttached. Attach — только в _furnPick (символ вооружён, превью может появиться). Detach — во всех точках снятия палитры: _furnPlace (успешная установка), все обработчики закрытия палитры/категории/бэка в _renderFurnPalette и _renderDecorBar/ _renderDecorSecondary, плюс (после r2-H1) Escape и disconnectedCallback. Проверил, что превью и клик читают один и тот же источник истины (живое состояние клавиши Shift): клик — ev.shiftKey на момент pointerdown (_furnPlace(...,ev.shiftKey,...), houseplan-editor-runtime.ts:4790), превью — _furnPreviewInput.free, обновляемый и из pointermove (ev.shiftKey), и из keydown/keyup — рассинхронизации источника нет. Смок smoke_furniture_polish.mjs покрывает связку: 14 ассертов, все зелёные при исполнении (см. «Гейты»).
6. (е) _decorPointerDown (src/houseplan-editor-runtime.ts:4076- 4082): ev.pointerType==='mouse' && ev.button!==0 && t!=='select' && t!=='erase' → return false, до всех веток инструментов (line/rect/ ellipse/text/furniture), но не для select/erase — соответствует контракту «правая кнопка не ставит объект», не трогает select/erase и не вызывает preventDefault (контекстное меню браузера не подавлено). Смок проверяет оба клика (правый — no-op с сохранением armed- палитры, левый — ставит). Мутант placement-accepts-any-mouse-button падает (проверено).
7. (ж) LICENSE.md, README.md, pack.json в assets/furniture/houseplan-0.3.0/, docs/FURNITURE.md:41 и scripts/generate-furniture-assets.mjs (provenance-проверка) все несут «Sergey Matyunin». README.md получил абзац о том, что байты архива не менялись и старая романизация может остаться внутри исходника. grep -rn Matyushin . (вне .git) даёт только docs/specs/369-audit-lows.md и docs/reviews/SPEC-REVIEW-369-r1.md — оба исторические/описательные цитаты, ожидаемо по AC7 и уже принято на спек-стадии.
8. Мутанты — все пять из ТЗ найдены в scripts/mutation-gate.mjs (vac-trail-drop-warn-removed, climate-legacy-area-undefined-lost, opted-out-roster-looks-alive, furniture-shift-listeners-not- attached, placement-accepts-any-mouse-button) и прогнаны мной по одному — 5 из 5 пойманы адресно (см. «Гейты»).

Гейты — что прогнал сам и с каким результатом

Зелёного Validate на 3965475c не найдено, поэтому прогнал сам:

• npx tsc --noEmit — чисто, без вывода.
• npm test — # tests 1538 / # pass 1537 / # fail 0 / # skipped 1 — совпадает с заявленным автором 1537/0.
• npm run build — сборка без ошибок; git status --porcelain после сборки пуст → dist/, custom_components/houseplan/frontend и demo/srv/assets (после npm run bundle:sync) байт-в-байт совпадают с закоммиченными копиями.
• node scripts/check-docs.mjs — «Documentation checks passed (7 files, 10 external links)» — обязателен, так как диапазон трогает src/**.
• node scripts/smoke-select.mjs --base origin/dev --head HEAD — 5 символов на изменённых строках, 8 «прямых совпадений»: demo/ smoke_furniture.mjs, demo/smoke_furniture_polish.mjs (по _furnPreviewInput — узкая, специфичная связь), и шесть смоков по _editorRuntime (smoke_cold_view_toggle, smoke_cold_view_vacuum, smoke_grid_scale_invariance, smoke_ha_controls, smoke_lazy_editor_chunk, smoke_partition_openings) — широкая связь (_editorRuntime встречается в 7 из 202 смоков, не редкость, но и не «40+», порог инструмента для «широкого» символа). Решение по каждому:
  • smoke_furniture_polish.mjs — прогнан (целевой смок задачи, новый). Результат: все 14 ассертов true, OK.
  • smoke_furniture.mjs — прогнан (та же подсистема — превью/палитра мебели, автор заявлял «зелёный без правок»). Результат: OK, все ассерты true (включая noSymbolNoStamp, unarmedCanvasDismiss* — смежные с (е) сценарии клика по стейджу).
  • smoke_cold_view_toggle.mjs, smoke_cold_view_vacuum.mjs — прогнаны, а не пропущены как «слабая связь»: r2-H1 был именно про disconnectedCallback, а это единственные два смока, которые реально гоняют холодный disconnect/reconnect цикл карточки — самая чувствительная часть правки. Результат: OK в обоих, noPageErrors: true, runtimeColdAfter: true.
  • smoke_grid_scale_invariance.mjs, smoke_ha_controls.mjs, smoke_lazy_editor_chunk.mjs, smoke_partition_openings.mjs — НЕ прогнаны. Связь по _editorRuntime признана случайной: ни один не трогает мебель, Shift, кнопки мыши или lifecycle отключения карточки; символ на изменённых строках — это просто this._editorRuntime?. в других, не связанных с этим диффом местах тех же двух файлов.
• Мутанты #369 (5/5) — раздел «AC» выше, каждый прогнан отдельно (node scripts/mutation-gate.mjs --id=<id>), «поймано 1 из 1» на каждом, чистый прогон перед мутацией зелёный.

Чего не проверял и почему

• npm run invariants — диапазон не трогает геометрию комнат, толщину стен, layout, marker.space (кроме чтения существующего ключа в (в), не записи) или open_spans. Правило триггера инвариантов не выполнено — не прогонял.
• npm run golden:verify — ни один пункт не меняет геометрию/стили/ слои по умолчанию: (д) требует нажатия Shift без движения мыши, (е) — правого клика, (г) — специфической комбинации bindingStatus, ни один сценарий не входит в обычный набор golden-кадров. ТЗ прямо пишет «golden/performance: не задеты (проверить прогоном обычного гейта)» — обычный гейт (build+test+check-docs) прогнан и зелёный; полный golden-прогон посчитал избыточным для этой задачи (несоразмерный объём).
• python -m pytest tests_backend — custom_components/**/*.py не тронут.
• Performance-профили — не названы в AC, чувствительные к перфу пути не тронуты (только доп. addEventListener/removeEventListener на время жизни палитры и одна проверка ev.button).
• CODE-REVIEW-369-r1/r2 как файлы в docs/reviews/ — не найдены в дереве ни на HEAD, ни в origin/dev; текст r2 восстановлен из комментария ревьюера в issue (см. выше), а не из документа. Это не блокирует мой вывод (комментарий содержит SHA и полный текст находки), но стоит того, чтобы шаг публикации ревью-документов для code-стадии проверили отдельно — по SPEC-стадии документы SPEC-REVIEW-369-r1.md коммитятся исправно, по CODE-стадии #369 — нет ни одного.
• Ручное тестирование в браузере — не проводилось; вся уверенность — через автотесты, мутанты и смоки на реальном собранном бандле (Chromium headless через demo/serve.mjs), запущенные лично в этой сессии.

Итог

Все семь пунктов ТЗ ревизии 2 реализованы и доказаны — либо автотестом с подтверждённой «умеющей падать» проверкой (5/5 мутантов адресно), либо прямым чтением кода с явной пометкой. Обе точки утечки Shift-слушателей, названные в r2 (Escape, disconnectedCallback), закрыты именно в тех строках, которые назвал ревьюер, и регресс на них теперь ловится смоком. Новых High или Medium в скоупе не найдено. Единственная сопутствующая наблюдение — мёртвый (безвредный) дизъюнкт в disabledRoster — это старый принятый Low со спек-стадии, не новая находка, фиксирую для полноты, без правки.