# CODE-REVIEW-400-r3 Issue: #400 · заход r3 · блокирующих циклов израсходовано 2 из 4 HEAD ревью: `6a0bb985e78b622833e6b5c01b0f0b5453aa9314` Верхний коммит с продуктовым кодом: `d153b20a` («fix: make the handle paint order a named decision and mutate it»), пересборка `bd6722cc`. ## Скоуп раунда Единственный открытый вопрос, унаследованный из r2: Medium **M1** («мутационный гейт `furniture-edge-handles-steal-the-corner` правит текст JS-комментария, а не порядок отрисовки, и потому не воспроизводит регрессию AC1»). r2 закрыл диапазон `73ecfbd1..HEAD`, но `HEAD` на момент того прогона фактически останавливался на `f07e3c54` («docs: review document for #400», коммит r1) — коммит с самой правкой, `d153b20a`, лёгший на ветку позже по UTC-времени (`d153b20a` закоммичен `2026-08-31T05:14:55Z`, `f07e3c54` — `2026-08-31T05:06:43Z`, а следующий за ним доковый коммит r2, `6a0bb985`, — `2026-08-31T05:22:03Z`). Иными словами, дерево, на котором физически считался диапазон r2, не содержало правки, хотя она уже существовала на ветке к моменту публикации вердикта r2. Автор указал на это в issue и попросил перезапуск на текущей вершине — это и есть предмет r3. **Дельта r3 = `git diff f07e3c54..HEAD`** (не `73ecfbd1..HEAD`, как в r2 — `73ecfbd1` уже входит в f07e3c54 без изменений кода между ними): ``` demo/smoke_furniture.mjs | 13 +++++++++---- scripts/mutation-gate.mjs | 7 +++++-- src/houseplan-card.ts | 45 +++++++++++++++++++-------------- + докатка dist/, custom_components/houseplan/frontend/, demo/srv/assets (class D) + docs/images/*.png, docs/images/screenshots.json (пересъёмка скриншотов, class D) + docs/reviews/CODE-REVIEW-400-r2.md (публикация прошлого документа, class C) ``` Только три файла несут смысл; остальное — сгенерированное (D) или опубликованный артефакт прошлого раунда (C). Продуктовый код в этой дельте касается исключительно порядка отрисовки ручек ресайза мебели и тестовой инфраструктуры вокруг него — той же точки, что и M1. AC1/AC2 (приоритет угла), AC3/AC6 (решение по help-строкам) и AC4/AC5 (источник в `alignGuides`) дельта не трогает содержательно: help-строки и `alignGuides` в диапазоне не изменились вовсе. ## Как проверялось Дешёвые гейты (зелёного Validate на `6a0bb985` нет — прогнал сам): | Гейт | Команда | Результат | |---|---|---| | Типы | `npx tsc --noEmit` | чисто, без вывода | | Юниты | `npm test` | **1667/0** (1 skipped), совпадает с числом, заявленным автором | | Сборка | `npm run build` | ok, 15.6 с | | Сверка трёх копий бандла | `npm run bundle:sync` | без диффа в рабочем дереве после — три копии совпадают с закоммиченными байт-в-байт | | Бюджет | `npm run bundle:budget` | initial View **285 471 / 300 000** B gzip, headroom 14 529 B | | Докскрин-отпечаток | `node scripts/check-docs.mjs --external` | «Documentation checks passed (7 files, 10 external links)» | `src/**` в дельте тронут (`src/houseplan-card.ts`), поэтому `check-docs` обязателен — прогнан, зелёный. Геометрия комнат/толщины/`layout`/`marker.space`/`open_spans` дельтой не затронута (ручки ресайза мебели — не структура помещений), `npm run invariants` не требуется и не запускался. Мутационные гейты, привязанные к предмету M1 — прогнаны штатным раннером, не руками: ``` $ node scripts/mutation-gate.mjs --id=furniture-edge-handles-steal-the-corner ok чистый прогон: node demo/smoke_furniture_polish.mjs ok furniture-edge-handles-steal-the-corner: тест покраснел, как обязан поймано 1 из 1 $ node scripts/mutation-gate.mjs --id=align-guides-exclude-dead-source ok чистый прогон: node demo/smoke_align_guides.mjs ok align-guides-exclude-dead-source: тест покраснел, как обязан поймано 1 из 1 ``` Браузерные смоки — выбор через инструмент плюс собственное суждение: ``` $ node scripts/smoke-select.mjs --base f07e3c54 --head HEAD Изменено файлов src/**: 1 · символов проекта на изменённых строках: 2 НЕОПРЕДЕЛЁННОСТЬ: дифф исполняемый, но ни один смок не связан доказуемо. Символы, которых нет ни в одном смоке: HANDLE_PAINT_ORDER, _dtStart ``` Инструмент даёт «неопределённость» (новый идентификатор `HANDLE_PAINT_ORDER` инструменту не известен), но связь доказана иначе — тем же мутационным гейтом, который бьёт ровно по этой константе, и смоками, которые он вызывает как предусловие. Прогнал их напрямую: ``` $ node demo/smoke_furniture.mjs → OK (includes reworked SE-handle selector) $ node demo/smoke_furniture_polish.mjs → OK, smallFurnitureCornerWinsTheHit: true, largeFurnitureKeepsBothHandles: true $ node demo/smoke_align_guides.mjs → OK, devGuideComesFromAnotherMarker: true ``` `golden:verify` не запускал: правка `d153b20a` не меняет итоговый визуальный порядок отрисовки — он был установлен ещё в `fe3b85c0` (`corners` после `sides`) и остаётся тем же после переноса в `HANDLE_PAINT_ORDER = ['edges', 'corners']`; меняется только то, как порядок выражен в коде и как его ловит мутатор. Пиксельного риска в дельте нет. `pytest tests_backend` не запускал: `custom_components/**/*.py` дельта не трогает. Performance-профили не запускал: не названы в AC, дельта не касается путей, чувствительных к перфу (мебель рендерится тем же числом фигур, порядок в разметке не влияет на стоимость кадра). ## Разбор находки M1 по коду `src/houseplan-card.ts:825`: ```ts const HANDLE_PAINT_ORDER = ['edges', 'corners'] as const; ``` и рендер (`:8480-8492`) вместо инлайновых `sides.map(...)` + `corners.map(...)` в фиксированном порядке теперь итерирует `HANDLE_PAINT_ORDER`, диспетчеризуя на `role === 'edges'`. Порядок для реального рендера не изменился (`edges` перед `corners` — corners по-прежнему красятся последними и выигрывают хит), но теперь это значение переменной, а не расположение блоков в шаблоне — то, что и требовал вердикт r1. `scripts/mutation-gate.mjs` (мутант `furniture-edge-handles-steal-the-corner`) теперь патчит саму константу: ```diff - find: ' ${/* #400: corners LAST.', - replace: ' ${/* mutant: corners no longer last.', + find: "const HANDLE_PAINT_ORDER = ['edges', 'corners'] as const;", + replace: "const HANDLE_PAINT_ORDER = ['corners', 'edges'] as const;", ``` Прежний патч менял текст внутри JS-комментария — компилируемый код не менялся, поэтому регрессия не воспроизводилась (`поймано 0 из 1`, найдено в r1, подтверждено ещё раз в r2 независимо). Новый патч меняет порядок ролей на `['corners', 'edges']`, отчего `edges` красятся последними и перехватывают хит на мелкой мебели — именно то поведение, которое AC1 запрещает. Живой прогон подтверждает: `поймано 1 из 1`, а смок-предусловие (`smoke_furniture_polish`) на немутированном коде зелёное. `demo/smoke_furniture.mjs` больше не берёт юго-восточную ручку по индексу `handles[3]` (зависел от порядка отрисовки, что и уронило шард 3 CI на `d153b20a`), а фильтрует по роли (`!dtrot && !dtedge`) и берёт третий элемент массива `corners`. В исходнике `corners = [[-1,-1,'nwse'], [1,-1,'nesw'], [1,1,'nwse'], [-1,1,'nesw']]` (:8466-8468) — индекс 2 действительно юго-восточный угол (`sx>0, sy>0`). Комментарий смока («SE — второй `nwse`») и код согласуются. **M1 закрыта фактически, не только по утверждению автора.** ## Закрытие раунда r2 | Находка r2 | Чем закрыта | Где это видно | |---|---|---| | M1: мутант правит комментарий, регрессия AC1 не воспроизводится (`поймано 0 из 1`) | Порядок вынесен в `HANDLE_PAINT_ORDER`, мутант теперь патчит саму константу | `src/houseplan-card.ts:825,8480-8492`; `scripts/mutation-gate.mjs:757-762`; живой прогон → «поймано 1 из 1» (выше) | | Побочный эффект: `smoke_furniture.mjs` ловил SE-ручку по индексу `handles[3]`, что зависело от порядка отрисовки | Выбор ручки переведён на роль + позицию в массиве `corners` | `demo/smoke_furniture.mjs:357-363,405-413`; `node demo/smoke_furniture.mjs` → OK | | Мета-находка r2: заявленные автором детали правки не находились ни в одном коммите ни одной ветки на момент прогона r2 | Правка физически существует на ветке начиная с `d153b20a` (создан раньше публикации вердикта r2, но диапазон r2 его не захватил из-за момента снятия дерева) | `git log`, время коммитов см. раздел «Скоуп раунда»; `git grep -c HANDLE_PAINT_ORDER` / `git grep -c cornerHandles` на `origin/issue/400-beta-polish` (оба autor приводил в issue, подтверждено независимо чтением файлов выше) | ## Унаследовано из r1/r2 (без повторной проверки в этом раунде) Дельта `f07e3c54..HEAD` не касается кода этих пунктов, поэтому доказательства r1 остаются в силе без повторного исполнения: - **AC1/AC2** (приоритет угловой ручки на мелкой мебели) — функционально не менялись в этой дельте (визуальный порядок тот же), но я всё же перепрогнал `smoke_furniture_polish.mjs` как побочный эффект проверки мутанта: `smallFurnitureCornerWinsTheHit: true`, `largeFurnitureKeepsBothHandles: true`. Документ: CODE-REVIEW-400-r1, SHA `73ecfbd1`. - **AC4/AC5** (`_alignCandidates` использует актуальный источник перетаскивания вместо мёртвого `_drag?.id`) — код `src/logic.ts` в дельте не тронут; повторно прогнал `smoke_align_guides.mjs` только как предусловие второго мутанта: `devGuideComesFromAnotherMarker: true`. Документ: CODE-REVIEW-400-r1, SHA `73ecfbd1`. - **AC3/AC6** (help-строки #86 остаются в initial-чанке — зафиксированное решение в `docs/ARCHITECTURE.md`, бюджет в пределах потолка) — файлы решения дельтой не тронуты. Число бюджета пересчитано в этом раунде (см. ниже) и остаётся в пределах потолка. Документ: CODE-REVIEW-400-r1, SHA `73ecfbd1`. - Две Low-находки из r1 (AC4 доказан e2e-смоком вместо юнита; вес 38 help-строк не перемерян отдельно) — сняты ревьюером r1 с записью, дельта их не затрагивает. Документ: CODE-REVIEW-400-r1, SHA `73ecfbd1`. ## Проверено и корректно (новое в этой дельте) - `HANDLE_PAINT_ORDER` — именованная константа, используется в единственном месте рендера, тип `readonly ['edges','corners']` через `as const`, `tsc` чист. - Мутационный гейт `furniture-edge-handles-steal-the-corner` теперь бьёт по контракту, а не по комментарию — подтверждено живым запуском, «умеет падать» и падает. - Мутационный гейт `align-guides-exclude-dead-source` не задет дельтой, перепрогнан для контроля регрессии — без изменений, 1 из 1. - `smoke_furniture.mjs`: выбор SE-ручки по роли согласован с индексами массива `corners` в источнике. - Три копии бандла синхронны после пересборки, бюджет не превышен. ## Чего не проверял и почему - **Полная матрица смоков (209 файлов)** — задача не задевает ничего за пределами мебельных ручек и направляющих; `smoke-select.mjs` подтверждает узкий диапазон (`src/** изменено файлов: 1`). Полный прогон — предрелизная обязанность. - **`golden:verify`** — итоговый визуальный порядок отрисовки не изменился этой дельтой (см. обоснование выше); риск пикселей не вижу. - **`npm run invariants`** — дельта не касается геометрии комнат/толщины/ `layout`/`marker.space`/`open_spans`. - **`pytest tests_backend`** — `custom_components/**/*.py` не тронут. - **Performance-профили** — не названы в AC, путь не чувствителен к перфу. - **Разница бюджета (+46 Б: 285 425 → 285 471)** — не проверял отдельно происхождение (лишний байт от структуры `HANDLE_PAINT_ORDER.map` против инлайновых `.map`), потому что рост укладывается в потолок с запасом и не меняет вывод AC3/AC6; предупреждение скрипта про запас <15000 Б — известная, не новая для этого раунда ситуация (#367), не следствие правок r3. ## Вердикт M1 — единственная блокирующая находка, унаследованная из r1/r2 — закрыта по существу и подтверждена исполнением, а не только заявлением автора. Новых находок в дельте `f07e3c54..HEAD` нет. Зелёный.