houseplan-card/docs/reviews/SPEC-REVIEW-396-r3.md

SPEC-REVIEW-396-r3

• Issue: https://github.com/Matysh/houseplan-card/issues/396
• ТЗ под ревью: docs/specs/396-camera-transition-fixes.md, коммит 02eff9c34b425ae053bc3dccbd24174ea8aa4017 (HEAD ветки issue/396-camera-transition-fixes, docs: #396 spec revision 3 per SPEC-REVIEW-396-r2)
• Этап: spec (PROCESS.md §2.4)
• Трек: обычный (без метки small/trivial) — лимит циклов ревью ТЗ 4
• Заход: r3 · блокирующих циклов израсходовано 2 из 4 (до этого вердикта; r1 красный = 1, r2 жёлтый = 1, итого 2)

Скоуп ревью

Раунд r2 вернул жёлтый вердикт с одной Medium-находкой и одной снятой Low:

• Medium-1: строка таблицы отмен :4188, :4216 называла несуществующую функцию _load (grep -n "\b_load\b" src/houseplan-card.ts — пусто); обе строки фактически лежат внутри _adoptStructuralResponses.
• Low-1 (waived, не блокировал): строка :1159 _onMotionChange, :2363 — имя функции названо только для первого числа, :2363 осталось без имени.

Ревизия 3 правит ровно эти два места и ничего больше — это подтверждает git diff d5fd5926faab12ec0883458b1d4a932ea9344bb3..HEAD -- docs/specs/396-camera-transition-fixes.md (SHA d5fd5926 — HEAD ветки на момент вердикта r2): три изменённые строки — строка «Ревизия» (счётчик и ссылка на раунд) и два исправления имён в таблице раздела «(1) B1». Ни один другой раздел ТЗ не тронут: git diff --stat даёт 1 file changed, 6 insertions(+), 6 deletions(-).

Это ревью — по дельте (PROCESS.md §2.10): единственный предмет разбора — две поправленные ячейки таблицы. B1/B2/M2 по существу, AC1–AC7, «Скоуп/не-скоуп», UX, модель данных, i18n, риски, откат, release-артефакты дельту не задевают и наследуются из r2 без повторной проверки (раздел ниже).

Продуктового кода в ветке по-прежнему нет: диапазон 4e0a30a7..HEAD содержит только doc-коммиты (спека и документы ревью r1/r2) плюс текущую ревизию 3; src/** не тронут ни одним коммитом ветки.

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

1. Прочитаны docs/SCOPE.md (раздел Core user jobs, J1 — «live spatial overview» покрывает камеру/зум как часть основного сценария View), AGENTS.md, PROCESS.md §1, §2.4, §2.10, §4, §7.1, §7.2 (действующая редакция).
2. Прочитано тело issue #396 целиком и все пять комментариев (аналитика, вердикт r1, ревизия 2, вердикт r2, ревизия 3).
3. Восстановлена дельта: git diff d5fd5926..02eff9c3 -- docs/specs/396-camera-transition-fixes.md — ровно 3 изменённые строки (см. выше).
4. Обе правки сверены с кодом на HEAD той же командой, что и в r1/r2:
   • grep -n "\b_load\b" src/houseplan-card.ts — пусто, подтверждает, что _load действительно не существует;
   • grep -n "private _adoptStructuralResponses" src/houseplan-card.ts → 4167; тело функции (4167–4224) прочитано целиком, обе строки 4188 и 4216 — вызовы this._cancelCameraTransition(false); внутри неё (в ветках configChanged и layoutChanged соответственно);
   • grep -n "_cancelCameraTransition(true)" src/houseplan-card.ts → строки 1159 и 2363; строка 2363 прочитана в контексте — она лежит внутри private _pageVisibility = (signal: PageVisibilitySignal): void => {…}, что в точности совпадает с новым именем в таблице.
5. Проверено, что весь остальной текст ревизии 3 идентичен ревизии 2 (diff выше — исчерпывающий список изменений, других расхождений нет).
6. Проверена внутренняя согласованность: слово _load больше нигде в файле не встречается (grep -n "_load\b" docs/specs/396-camera-transition-fixes.md — пусто), включая AC3 — вопреки формулировке в комментарии ревизии 3 («заодно поправил AC3, где было то же имя»), AC3 в обеих ревизиях (r2 и r3) не содержит и не содержало _load; это неточность комментария к коммиту, а не дефект самого ТЗ — текст документа везде корректен, лишний коммент не вводит фактическую ошибку. Не заводится находкой: не влияет ни на один AC.

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

Находка r2	Чем закрыта	Где это видно
Medium-1: :4188, :4216 приписаны несуществующей _load	Имя заменено на _adoptStructuralResponses	docs/specs/396-camera-transition-fixes.md:48 (было `:4188`, `:4216` `_load`, стало `:4188`, `:4216` `_adoptStructuralResponses`); подтверждено чтением src/houseplan-card.ts:4167-4224 — обе строки действительно внутри этой функции
Low-1 (waived): :2363 без имени функции	Имя добавлено — _pageVisibility	docs/specs/396-camera-transition-fixes.md:45 (было `:1159` `_onMotionChange`, `:2363`, стало `:1159` `_onMotionChange`, `:2363` `_pageVisibility`); подтверждено чтением src/houseplan-card.ts:2363 — строка лежит внутри private _pageVisibility = …

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

Ничего из перечисленного не задето дельтой r2→r3 (диф выше исчерпывающий), принято без повторной проверки на этом раунде, по документам: docs/reviews/SPEC-REVIEW-396-r1.md (SHA 4e0a30a78161a4ff59679454d1f8b5c471e10008) и docs/reviews/SPEC-REVIEW-396-r2.md (SHA d5fd5926faab12ec0883458b1d4a932ea9344bb3):

• контракт B1 (разделение пользовательской/структурной отмены, правка §13 спеки #82) — проверен по существу в r1, таблица мест — построчно в r2;
• контракт B2 (якорь от цели перехода вместо представленного кадра, правка §10 спеки #82) и его AC3/AC4 — проверены в r1, дельтой не тронуты;
• контракт M2 (заморозка glow-feather на признаке движения камеры) и AC5 — проверены в r1;
• раздел «Скоуп/не-скоуп» (включая добавление _stagePointerDown в r2) — проверен в r2;
• AC1, AC2 (переформулированы в r2 под таблицу одиннадцати мест) — проверены построчно в r2, включая проверку обоих вызывающих контекстов _zoomAt (:6517, :6897 — оба вызывают _saveZoom() сразу после); дельта r2→r3 эти AC не меняет;
• AC6 (правка §10/§13 082-smooth-zoom.md), AC7 (regression guard: reduced-motion, dispose, конфиг) — проверены в r1;
• план автотестов, мутанты, риски, откат, release-артефакты, UX, модель данных и миграция, i18n — проверены в r1, дельтой не тронуты;
• обязательные разделы §7.1 PROCESS.md присутствуют все — проверено в r1;
• продуктовых вопросов владельцу нет — установлено в r1 и подтверждено в r2.

Находки

Нет. Обе находки r2 (Medium-1, Low-1) закрыты точно, построчной сверкой с кодом, без побочных повреждений соседних разделов. Новых расхождений дельта не вносит.

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

• Обе исправленные ячейки таблицы теперь называют реально существующие функции на указанных строках (проверено чтением кода, не исполнением — на этом этапе продуктового кода к issue ещё нет).
• Классификация обеих строк («структурная» для :4188/:4216, «уже сохраняется через settled» для :2363) осталась прежней и по-прежнему верна: _adoptStructuralResponses меняет geometry/config baseline целиком (структурная отмена по определению контракта B1), _pageVisibility зовёт cancel(true) (коммит цели, не «зависание» кадра) — согласуется с общей строкой :1159/:2363 в таблице.
• Никакая другая часть документа (контракты, AC, скоуп, риски, автотесты) не изменилась и не пострадала от точечной правки.

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

• Существо контрактов B1/B2/M2, AC3–AC7, план автотестов, риски, откат — не проверялись заново в этом раунде: дельта их не касается, разбор наследуется из r1/r2 (раздел выше).
• Продуктовый код фичи не существует в этой ветке (только doc-коммиты) — проверять npx tsc --noEmit, npm test, npm run build на этом этапе бессмысленно: класс A ничем не тронут. Гейты — предмет код-ревью после реализации.
• Внешний файл аудита AUDIT-2026-08-31-v1700beta1.md, на который ссылается тело issue, не лежит в репозитории и не проверялся — как и в r1/r2, это вне дерева, доверие к нему устанавливалось построчной сверкой утверждений с кодом, а не чтением самого аудита.

Вердикт

Обе находки предыдущего раунда закрыты точно и без побочных эффектов; дельта чисто текстовая (три строки, две правки имён плюс счётчик ревизии) и не задевает ничего, требующего повторной проверки. Продуктовых вопросов владельцу нет.

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