houseplan-card/docs/reviews/SPEC-REVIEW-298-r2.md

SPEC-REVIEW-298-r2

• Issue: https://github.com/Matysh/houseplan-card/issues/298
• ТЗ: docs/specs/298-resize-wall-thickness-carrier.md @ commit 55db16df6e51027a81aaf56de6cd08bbf19c3b77
• Этап: ТЗ на ревью (PROCESS.md §2.4)
• Заход: r2 · блокирующих циклов израсходовано 1 из 4 (потрачено r1, жёлтый)
• Ревьюер: Claude (сессия ревью ТЗ), автор ≠ ревьюер

Скоуп ревью

Не первый заход. По PROCESS.md §2.9 / issue #214 разбор идёт по дельте:

• предыдущий вердикт — комментарий claude, 2026-08-24T19:01:20Z, в issue #298: жёлтый, r1, блокирующих циклов 0/4, High 0 / Medium 1 (в скоупе), документ docs/reviews/SPEC-REVIEW-298-r1.md, ТЗ проверялось на SHA 45066631aee4997ac1f033dbe75918b5b2d439d4 (SHA не был назван в самом вердикте — восстановлен из ссылки автора на коммит ТЗ в комментарии за 18:54:17Z, который текстуально совпадает с состоянием, разобранным в r1-документе);
• правка автора — коммит 55db16df6e51027a81aaf56de6cd08bbf19c3b77 (docs(spec): add resize user contract, единственный файл docs/specs/298-resize-wall-thickness-carrier.md, +25/-1);
• дельта строго локальна: добавлен раздел «Персона, поверхность, момент и видимый результат», добавлена подсекция «UX и i18n», добавлены две строки «Доказательство:» под AC5 и AC7. Ни один AC, ни контракт поведения (§§3–5), ни scope (§6) не менялись. Рёбейза на ушедший вперёд dev не было (родитель коммита — 8221ad9b, публикация r1-документа, что и ожидается между раундами). Подсистема не сменилась, новых открытых вопросов правка не внесла. Объём дельты (одна секция + два предложения) несопоставим с объёмом задачи → разбор сокращён до дельты, остальное наследуется из r1.

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

1. git diff 45066631..55db16df -- docs/specs/298-resize-wall-thickness-carrier.md — получен полный текст дельты, показан ниже в разделе «Закрытие раунда r1».
2. Дельта прочитана в контексте всего текущего файла (Read целиком, 377 строк), чтобы исключить рассинхронизацию новых фраз с остальным ТЗ.
3. Новый раздел 1 сверен с:
   • docs/SCOPE.md — персона «Home admin (primary) … Desktop browser», job J6 «Keep the plan true as the home evolves … drag/resize» — совпадает с «администратор дома / desktop Plan editor / инструмент Resize»;
   • комментарием-аналитикой автора (18:52:14Z), где та же персона и та же поверхность были названы изначально, но не попадали в сам документ — ровно то несоответствие, которое r1 отметил как находку.
4. Термин «ручка» и написание «Resize» сверены с docs/USER-GUIDE.ru.md (строки 441, 480–481: «Resize», «ручка объясняет…», «Ручка остаётся видимой, но приглушена») — терминология не изобретена, взята из канона.
5. Новая подсекция «UX и i18n» сверена с §6 «Не входит» («изменение eligibility, safe range, pointer UX … не входит») и §12 п.3 («Existing resize.commit_failed достаточно … пока eligibility не меняется») — утверждение «новых контролов/текстов нет» не противоречит остальному документу.
6. Новые строки «Доказательство:» под AC5/AC7 сверены с разделом 11 («Ожидаемые файлы и release artifacts»): методы («table-driven unit pure carrier preflight», «production-bundle Resize pointer smoke») там же названы как ожидаемые файлы/evidence — не расходятся.
7. Коммит 55db16df проверен git show --stat: правда только один файл, +25/-1, что совпадает с диффом, разобранным построчно (не поверено на слово автора).
8. Трейлеры коммита: Issue: #298, User-Visible: no — для docs-only spec-коммита корректно (видимого поведения нет, меняется только текст ТЗ).

Не проверялось повторно (наследуется из r1, ниже отдельным разделом): корневая причина по коду, существование фикстур/констант/связанных issue, формулировки §§3–5, §6, §7 (AC1–AC9 по содержанию), §8–§12 — дельта их не касается, к этим утверждениям автор не притрагивался.

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

Находка r1	Чем закрыта	Где это видно
Medium (в скоупе): ТЗ не содержит обязательных продуктовых разделов §7.1 — «персона/поверхность/момент» и «что человек увидит до/после» без терминов реализации; §1 и §2 были на языке реализации (rekeyWallsAfterMove, topology vertex, config write)	Добавлен раздел 1 «Персона, поверхность, момент и видимый результат»: явно назван «администратор дома», «desktop Plan editor, инструмент Resize», «обычный ресайз стены готового плана»; добавлены два предложения «До:»/«После:» без единого термина реализации (стена рисуется другой толщиной / теряет ручку → ресайз либо проходит как раньше, либо fail-closed с прежней ошибкой)	docs/specs/298-resize-wall-thickness-carrier.md, новые строки 16–26 (коммит 55db16df)
Low (снят с записью, не блокировал): AC5 и AC7 не называют явно способ доказательства	Под AC5 и AC7 добавлены явные строки «Доказательство: …»	строки 244–245 (AC5) и 272–273 (AC7)
Low (снят с записью, не блокировал): разделы «UX» и «i18n» не выделены явными заголовками	Добавлена подсекция ### UX и i18n внутри §5 с прямым утверждением «новых контролов, состояний и текстов нет»	строки 162–166

Все три пункта r1 закрыты правкой; новых расхождений между добавленным текстом и остальным документом не найдено (см. «Как проверялось», пп. 3–6).

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

Без повторной проверки в этом раунде принято по документу docs/reviews/SPEC-REVIEW-298-r1.md (ТЗ на SHA 45066631aee4997ac1f033dbe75918b5b2d439d4), поскольку дельта r1→r2 их не касается:

• корневая причина подтверждена чтением rekeyWallsAfterMove() (src/wall-thickness.ts:533, пропорциональная проекция mapPoint, строки 574–582) — совпадает с числами из issue;
• обе fixture-репродукции (real-plan-second-floor.json, real-plan-first-floor.json) существуют и соответствуют описанным в AC1/AC2 жестам;
• LATTICE_NOISE_STEPS существует (src/coordinate-canonicalization.ts:11, 1e-4), используется в инвариантах и мутационном гейте;
• все связанные issue (#253, #277, #289, #291, #293, #297, #299) существуют в заявленном состоянии (закрыты/открыт), ссылки не искажены;
• ссылки на канон (WALL-THICKNESS.md, RESIZE.md, TOUCH-SUPPORT.md) точны, не изобретены;
• AC1–AC9 по содержанию проверяемы, скоуп «не входит» корректно исключает #299 (mixed_role_record);
• §12 «Принятые технические предположения» — явные, не выданы за факт.

Находки

Нет. Единственная находка r1 (Medium, в скоупе) закрыта дельтой; новых находок дельта не создала.

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

• Дельта r1→r2 (раздел 1, подсекция UX/i18n, две строки «Доказательство:») внутренне согласована с остальным документом и с каноном (SCOPE.md, USER-GUIDE.ru.md).
• Персона/поверхность/момент и фраза «до/после» присутствуют, без терминов реализации — оба обязательных продуктовых раздела §7.1 закрыты.
• Коммит содержит ровно заявленное изменение, трейлеры корректны.

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

• Повторно не перечитывал и не оспаривал §§2–12 по содержанию — дельта их не меняла, см. «Унаследовано из r1».
• Гейты typecheck/test/build/check-docs не запускал — стадия ТЗ, кода к задаче ещё нет; это ожидается на этапе code-review.
• Не проверял снова состояние связанных issue (#253/#277/#289/#291/#293/#297/#299) — наследуется из r1, ссылки дельта не меняла.

Вердикт

Зелёный. Единственная Medium-находка r1 закрыта точечной и корректной правкой, новых находок нет.