# CODE-REVIEW-258-r2 Issue: #258 «На 1.67.0-beta.4 после «Оптимизировать» появились белые клинья в местах схода стен» Этап: code Заход: r2 · блокирующих циклов израсходовано 1 из 4 Ветка: `issue/258-wall-key-storage-roundtrip` HEAD ревью: `61bf537b58a2e2c0b78e6e2a55a1075f90618dbd` SHA предыдущего раунда (r1, код-ревью): `28eaf86662819651b2c75e7423280f10820a757d` Документ r1: `docs/reviews/CODE-REVIEW-258-r1.md` (закоммичен отдельным коммитом `aa85a95` поверх r1-кода — не часть проверяемого кода) ## Скоуп раунда Раунд r1 (код) дал жёлтый вердикт с единственной находкой Medium в скоупе: формулировки `docs/CHANGELOG.md`/`.ru.md` безусловно заявляли, что зарепорченные белые клинья устранены, хотя собственное измерение владельца в этом же issue (комментарий от 2026-08-23T11:15:02Z) показало: переписанные Optimize-ключи не меняют `wallEdgeBodies`/карту узлов на реальных экспортах владельца ни на бит. Реализация исправляет доказанный дефект другого класса — рассогласование структурных потребителей (`lookupWall`/`thicknessCmAt`/`cmsForPoly`) на устаревшем compatibility-key, — но changelog должен был описывать именно его, а не визуальный симптом со скриншотов. Дельта r2 — правка по этой находке: ``` git diff 28eaf86..HEAD --stat docs/CHANGELOG.md | 11 +- docs/CHANGELOG.ru.md | 12 +-- docs/reviews/CODE-REVIEW-258-r1.md | 204 ++++++++++++++++++++++++++++++ ``` `docs/reviews/CODE-REVIEW-258-r1.md` — публикация документа r1 предыдущим циклом, не код автора; предмет этого раунда — только два changelog-файла, изменённые коммитом `61bf537` («docs: correct wall-key changelog claim», `Issue: #258`, `User-Visible: no`). Дельта локальна: не рёбейз (родитель `28eaf86` — прямой предок `HEAD`, `dev` не менялся под веткой), не смена контракта поведения, не задета новая подсистема — правка чисто текстовая, в двух файлах документации одного формата. Продуктовый код (`src/**`, `test/**`, `scripts/**`, `custom_components/**`) между `28eaf86` и `HEAD` не менялся вовсе — проверено `git diff 28eaf86..HEAD --stat` (полный список выше, других файлов нет). Поэтому разбор сокращён до дельты: обзор AC не переоткрывается, потому что дельта не касается кода, от которого зависит их доказательство. ## Как проверялось 1. Восстановлен вердикт и SHA r1 из истории issue (`gh issue view 258`, комментарий `claude` от `2026-08-23T11:38:29Z`) и из `git log` — SHA в самом тексте вердикта не назван прямо, но однозначно восстанавливается по `git show --stat aa85a95` (документ r1 закоммичен поверх `28eaf86`) и по тексту комментария реализации («Коммит: `28eaf866...`»). 2. `git diff 28eaf86..HEAD` — построчно, целиком (полный текст ниже). 3. Проверено, что новая формулировка changelog не переносит старую ошибку в другую форму: сверена с AC2/AC5 спецификации (`docs/specs/258-wall-key-storage-roundtrip.md`, `git show 28eaf86:...`) и с текстом r1-вердикта — заявление ограничено «толщина стены согласована у структурных потребителей при перезаписи compatibility-key», без упоминания устранения белых клиньев с реальных скриншотов. 4. Прогнаны дешёвые гейты (см. таблицу) — не потому что дельта могла их сломать (текст в `.md` не компилируется и не тестируется), а чтобы подтвердить прямым исполнением, что дерево `src/**`/`test/**` осталось тем же деревом, на котором r1 уже получил зелёный результат, а не заявлением автора. ### Полный diff дельты r2 ```diff --- a/docs/CHANGELOG.md +++ b/docs/CHANGELOG.md @@ -2,11 +2,12 @@ ## Unreleased -- Thick-wall T-junctions no longer develop white wedges after “Optimize - plans”. Wall identity now stays stable when an exact `1/240` grid endpoint is - persisted with nine decimal places, and already affected records are read by - their exact endpoint pair without broadening legacy midpoint matching. - Optimize canonically repairs the stored key and remains a no-op after reload +- Wall thickness now stays consistent across structural consumers when + “Optimize plans” rewrites a compatibility key. Wall identity remains stable + when an exact `1/240` grid endpoint is persisted with nine decimal places, + and already affected records are read by their exact endpoint pair without + broadening legacy midpoint matching. Optimize canonically repairs the stored + key and remains a no-op after reload ([#258](https://github.com/Matysh/houseplan-card/issues/258)). --- a/docs/CHANGELOG.ru.md +++ b/docs/CHANGELOG.ru.md @@ -8,12 +8,12 @@ ## Не выпущено -- После «Оптимизировать планы» в T-образных стыках толстых стен больше не - появляются белые клинья. Идентификатор стены теперь остаётся стабильным, - когда точный узел сетки `1/240` сохраняется с девятью знаками, а уже - затронутые записи читаются по точной паре концов без расширения старого - поиска по середине. Optimize канонически исправляет сохранённый ключ и после - перезагрузки остаётся no-op +- После перезаписи compatibility-key командой «Оптимизировать планы» толщина + стены теперь остаётся согласованной у всех структурных потребителей. + Идентификатор стены стабилен, когда точный узел сетки `1/240` сохраняется с + девятью знаками, а уже затронутые записи читаются по точной паре концов без + расширения старого поиска по середине. Optimize канонически исправляет + сохранённый ключ и после перезагрузки остаётся no-op ([#258](https://github.com/Matysh/houseplan-card/issues/258)). ``` ## Закрытие раунда r1 | Находка r1 | Чем закрыта | Где это видно | |---|---|---| | Medium (в скоупе): `docs/CHANGELOG.md`/`.ru.md` безусловно заявляют устранение белых клиньев со скриншотов владельца, хотя собственное измерение владельца в issue показывает, что переписанные Optimize-ключи не меняют `wallEdgeBodies`/карту узлов на его реальных данных. | Оба changelog переформулированы на факт, доказанный AC2/AC5/мутационными тестами: согласованность толщины между структурными потребителями (`lookupWall`/`thicknessCmAt`/`cmsForPoly`) при перезаписи compatibility-key. Упоминание устранения белых клиньев убрано из обоих файлов; причина визуального симптома явно оставлена за рамками (`#261`, уже заведён автором в r1). | `docs/CHANGELOG.md:5-9`, `docs/CHANGELOG.ru.md:11-15`, коммит `61bf537` (diff — выше целиком, других изменений в коммите нет). | Находка закрыта полностью: новая формулировка не содержит утверждений вне доказанного (сверено с AC2 и подтверждённым в r1 фактом, что `thicknessCmAt` и `cmsForPoly` идут через один и тот же исправленный `lookupWall`), а строки про белые клинья/скриншоты удалены из обеих версий файла синхронно, в одном коммите с трейлером `Issue: #258`. ## Унаследовано из r1 Всё, что не относится к changelog, унаследовано без повторной проверки — делать это безопасно, потому что `git diff 28eaf86..HEAD --stat` подтверждает байт-в-байт отсутствие изменений в `src/**`, `test/**`, `scripts/**`, `custom_components/**`, `demo/**` (кроме уже упомянутых двух `.md`-файлов) — дельта в принципе не может задеть эти доказательства: - **AC1–AC3, AC5–AC8** — доказаны исполнением в r1 (unit/mutation-таблицы, targeted production-bundle smoke, golden-сценарий с semantic probes, `typecheck`/`test`/`build`/`check-docs`). Документ: `docs/reviews/CODE-REVIEW-258-r1.md`, SHA `28eaf86662819651b2c75e7423280f10820a757d`. - **AC4 (осознанное отступление)** — `checkWallKeys` диагностирует несовпадение key↔wallKey(a,b) как observation, а не violation, согласовано с `#259` (`5e95a28`); r1 признал отступление обоснованным и не смог обнаружить регрессии в этом сужении. Документ: `docs/reviews/CODE-REVIEW-258-r1.md`, SHA `28eaf86662819651b2c75e7423280f10820a757d`. - **Три копии бандла и мутационные анкеры** — синхронность `dist/houseplan-card.js` ↔ `custom_components/houseplan/frontend/houseplan-card.js` ↔ `demo/srv/assets/houseplan-card.js` и убойность мутационных анкеров подтверждены в r1 исполнением; независимо переподтверждено в этом раунде (см. таблицу гейтов) командой `cmp` после `npm run build` + `npm run bundle:sync`. - **Инварианты модели (#254) и smoke-выборка** — `smoke_wall_key_roundtrip.mjs` (24/24 assertion) и `smoke_resize_wall_thickness.mjs` прогнаны и зелёные в r1; дельта r2 не касается геометрии, `layout`, `marker.space`, `open_spans` или записей толщины — прогон не повторялся намеренно (раздел «Чего не проверял» ниже). ## Что проверено и корректно (дельта r2) - Формулировки обоих changelog теперь ограничены доказанным фактом и не заявляют устранения визуального симптома владельца — устраняет находку r1 дословно так, как она была сформулирована. - EN и RU версии согласованы по смыслу (проверено построчным сопоставлением diff выше) — не разошлись в переводе, как могло бы случиться при точечной правке одного файла. - Трейлеры коммита `61bf537`: `Issue: #258` есть; `User-Visible: no` корректен — сам код продукта не менялся, меняется только текст описания уже отгруженного (в предыдущем коммите) изменения; предыдущий коммит `28eaf86` (`User-Visible: yes`) уже включал правку обоих changelog в одном коммите с кодом — обязательное правило «правки в оба changelog в том же коммите» соблюдено на уровне исходного изменения, а не только на уровне правки формулировки. - `git diff --check 28eaf86..HEAD` — чисто, конфликтов пробелов нет. - Рабочее дерево чистое после `npm run build && npm run bundle:sync` (`git status --porcelain` — пусто), три копии бандла побайтово совпадают. ## Гейты: что прогнал и почему | Гейт | Прогнан | Результат | Почему (не) прогонял | |---|---|---|---| | `npx tsc --noEmit` | да | чисто, 4.8s | дешёвый, обязателен каждый раунд | | `npm test` | да | 1159 passed, 0 failed, 7.3s | дешёвый, обязателен каждый раунд; заодно подтверждает, что кодовое дерево не разошлось с тем, что видел r1 | | `npm run build` + сверка 3 копий бандла | да | сборка ок; `cmp dist ↔ custom_components/houseplan/frontend` и `dist ↔ demo/srv/assets` (после `npm run bundle:sync`) — побайтовое совпадение | дешёвый, обязателен каждый раунд | | `node scripts/check-docs.mjs` | нет | — | условие запуска — diff трогает `src/**`; дельта r2 — только `docs/CHANGELOG*.md`, `src/**` не тронут. Уже прогнан в r1 на коде, который не изменился (см. комментарий владельца от 2026-08-23T11:23:49Z) | | Инварианты модели (`npm run invariants`/`model-invariants.mjs`) | нет | — | дельта не трогает геометрию, `layout`, `marker.space`, `open_spans` или записи толщины — только текст changelog | | Browser smoke (`smoke_wall_key_roundtrip.mjs`, `smoke_resize_wall_thickness.mjs`) | нет | — | относились к продуктовому коду `28eaf86`, уже зелёные в r1; дельта r2 их не касается — код `src/wall-thickness.ts` не менялся между раундами | | `npm run golden:verify` | нет | — | дельта не меняет рендер/геометрию/стили/слои, только markdown | | `python -m pytest tests_backend -q` | нет | — | `custom_components/**/*.py` не тронут ни в r1, ни в дельте r2 | | performance-профили | нет | — | не названы в AC, чувствительные к перфу пути не тронуты | ## Чего не проверял - Не переисполнял golden-сценарий и mutation-анкеры r1 — дельта не может их задеть (текстовые файлы `.md` не участвуют ни в сборке, ни в рендере). - Не перепроверял продуктовый диагноз причины белых клиньев на реальных экспортах владельца — это прямо вне скоупа #258 (см. non-scope спецификации и последующий #261, уже заведённый автором в r1 для этого следа). - Не проверял #259/#261 — отдельные issue, не предмет этого ревью. ## Вывод Единственная Medium-находка r1 закрыта точно и полностью: changelog больше не заявляет ничего, что не доказано, а формулировка соответствует тому, что реально исправлено и подтверждено исполнением (согласованность толщины между структурными потребителями при перезаписи compatibility-key). Дельта нового раунда не вносит собственных находок. Новых High/Medium нет. **Вердикт: зелёный.**