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

# SPEC-REVIEW-294-r2

- **Issue:** https://github.com/Matysh/houseplan-card/issues/294
- **Этап:** ревью ТЗ (PROCESS.md §2.4)
- **Заход:** r2 · блокирующих циклов израсходовано 1/4 (зелёный вердикт цикла не тратит, #227)
- **Ревьюер:** Claude (роль «ревьюер ТЗ», сессия отдельна от автора ТЗ)
- **Предыдущий раунд:** [SPEC-REVIEW-294-r1](SPEC-REVIEW-294-r1.md), вердикт жёлтый,
  на SHA `8e86b0a5` (ветка `issue/294-wall-esc-detach`). SHA в вердикте r1 назван
  явно (в шапке документа r1), это не находка.
- **Предмет ревью:** `docs/specs/294-wall-esc-detach.md` на SHA `6b857087`
  (текущий `HEAD` ветки) и комментарий автора «Правки ТЗ после SPEC-REVIEW r1».

## Разбор по дельте (PROCESS.md §2.9/§2.10, issue #214)

Дельта объявлена: `git diff 8e86b0a5..HEAD` — два файла:
`docs/reviews/SPEC-REVIEW-294-r1.md` (публикация документа предыдущего раунда,
не предмет разбора) и `docs/specs/294-wall-esc-detach.md`, **+43/-7 строк**,
только раздел 5 («Подсказки и документация») и AC7 в разделе 7. Правки в
`docs/specs/README.md` и создание самого файла спецификации относятся к
исходному коммиту `8e86b0a5`, уже разобранному в r1, и в дельту r2 не входят.

Дельта **локальна**: правит формулировку одного раздела и одного AC того же
файла, не меняет продуктовый контракт Esc (разделы 1–4), не задевает новую
подсистему, не связана с ребейзом (branch содержит весь `origin/dev`, что
подтверждает пустой diff `docs/specs/README.md` кроме одной добавленной
строки реестра). Объём разбора сокращён до дельты; заново проверены только
AC7 и раздел 5, а также согласованность новой формулировки с разделами 1–4,
6, 8, 9, которые эту дельту упоминают (раздел 6 «Не входит» и раздел 9
«Документация врёт после изменения»).

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

| Находка r1 | Чем закрыта | Где это видно |
|---|---|---|
| Medium: AC7 формулировкой («старое утверждение… отсутствует в затронутых Walls-разделах») не покрывает четыре конкретных места старого контракта вне «Walls»-раздела (`USER-GUIDE.ru.md:223`, `:241`, `USER-GUIDE.md:207`, `:216-217`), и EN «Create a room» не решён на паритет с RU | Раздел 5 переписан: перечисляет **шесть** именованных поверхностей (RU: строка «Рисование и точный drag», таблица «Клавиши отмены» с явным разделением Draw/Split, «Комнаты и стены»; EN: строка “Draw or precise drag”, “Cancel and undo”, “Create a room” — последняя явно получает паритет с RU). AC7 дублирует тот же список пронумерованными пунктами 1–6, каждый — проверяемое утверждение по конкретному месту, а не общая цитата | `docs/specs/294-wall-esc-detach.md:109-127` (раздел 5) и `:190-208` (AC7), коммит `6b857087` |

Проверка не ограничилась заявлением автора: каждая из шести строк раздела 5 и
AC7 сверена построчно с текущим содержимым `docs/USER-GUIDE.ru.md` и
`docs/USER-GUIDE.md` на `HEAD` дерева (не на ветке спецификации, а в самом
репозитории, поскольку изменение поведения ещё не реализовано и тексты
руководств пока старые):

- `docs/USER-GUIDE.ru.md:223` — строка «Рисование и точный drag»: `` `Shift`
  меняет магнит/угол; `Esc` отменяет операцию `` — совпадает с описанием в §5
  п.1/AC7 п.1, требующим разделения;
- `docs/USER-GUIDE.ru.md:241` — таблица «Клавиши отмены», строка
  «Незавершённый Draw/Split»: «Убирает последнюю точку или выходит из
  инструмента» — совпадает с §5 п.2/AC7 п.2;
- `docs/USER-GUIDE.ru.md:412` — «Комнаты и стены»: «Esc/Ctrl+Z удаляет
  последнюю точку» — совпадает с §5 п.3/AC7 п.3;
- `docs/USER-GUIDE.md:207` — строка “Draw or precise drag”: “`Esc` cancels
  the operation” — совпадает с §5 п.4/AC7 п.4;
- `docs/USER-GUIDE.md:216-217` — “Cancel and undo”: “`Esc` cancels an
  unfinished path… without undoing an already committed action” — совпадает
  с §5 п.5/AC7 п.5;
- `docs/USER-GUIDE.md:294-299` — “Create a room”: раздел сегодня **не
  содержит** упоминания Esc/Ctrl+Z вовсе (в отличие от RU-версии, `:412`) —
  совпадает с тем, что §5 п.6/AC7 п.6 явно требуют добавить паритет, а не
  оставляют вопрос открытым.

Все шесть мест реальны, названы верно и покрывают в точности исходные четыре
цитаты r1 плюс оба открытых вопроса того раунда (RU «Комнаты и стены» и EN
паритет). Разбор по коду/докам, не по заявлению автора.

Отдельно проверено, что деление таблицы «Клавиши отмены» на Walls/Split не
является новой догадкой: `split` — существующий отдельный `MarkupTool` в
`src/houseplan-card.ts` (`type MarkupTool = … | 'draw' | … | 'split' | …`,
собственная кнопка активации, собственная обработка курсора/preview), то есть
разнесение «Draw (Walls)» и «Split» в разных строках описывает два реально
разных инструмента, а не искусственное разделение одного.

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

Без повторной проверки принято из [SPEC-REVIEW-294-r1](SPEC-REVIEW-294-r1.md)
на SHA `8e86b0a5`, поскольку дельта r2 их не затрагивает:

- продуктовая рамка и персона (Home admin, Plan editor, десктоп) — раздел
  «Что проверено и корректно», п.1 документа r1;
- отсутствие догадок, выданных за факт, в разделах 1–4 (контракт Esc) —
  сверено с `_onKey`, `_finishWallChain`, `_undoPoint`, `_undoActiveDraftPoint`,
  `_resumeLastDraft`, `_resumeDraftBySpace` на той же ветке в r1;
- однозначность и проверяемость AC1–AC6, AC8 — не изменились байт в байт
  между `8e86b0a5` и `HEAD` (единственная правка дельты — AC7 и раздел 5,
  подтверждено `git diff` выше);
- полнота раздела 6 «Не входит», разделов 8–13 (совместимость/touch/security/
  performance, риски, откат, ожидаемые файлы, release, принятые предположения)
  — не затронуты дельтой;
- корректность трейлеров коммита спецификации (`Issue: #294`,
  `User-Visible: no`) и трек (обычный, не `small`).

## Гейты

Класс изменённых файлов в дельте — только C (`docs/specs/**`). Продуктовый код
(класс A/B) на ветке отсутствует: `git diff origin/dev...HEAD --stat` даёt
только `docs/reviews/**`, `docs/specs/294-wall-esc-detach.md`,
`docs/specs/README.md`. `typecheck`/`test`/`build`/`check-docs` неприменимы к
этапу ТЗ (то же решение, что в r1) — ничего не проверяют для файла
спецификации и не запускались сознательно, а не по умолчанию.

## Находки

Нет. High: 0, Medium: 0, Low: 0.

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

- Единственная находка r1 (Medium) закрыта по существу, а не переформулирована
  так, чтобы формально пройти проверку: новая формулировка AC7 привязана к
  шести конкретным, поимённо названным местам в обоих руководствах, включая
  оба места, которые r1 привёл цитатами, и оба открытых вопроса r1 (RU
  «Комнаты и стены», EN «Create a room» паритет).
- Новая формулировка не вводит непомеченных догадок: разделение таблицы
  «Клавиши отмены» на Walls/Split опирается на существующий отдельный
  инструмент `split` в коде, а не является произвольным решением автора.
- Раздел 6 «Не входит» синхронизирован с расширенным разделом 5: пункт «переработка
  всех общих текстов про Escape вне затронутого Walls-контекста» по-прежнему
  верно ограничивает работу — новый список из шести мест целиком относится к
  контракту wall chain, ничего избыточного не добавлено.
- Продуктовый вопрос владельцу не появился: оба уточнения из r1 (нужно ли
  разносить Draw/Split, нужен ли EN-паритет) решены автором технически, без
  эскалации, что соответствует PROCESS.md §7.1 («всё, чего пользователь не
  наблюдает, агенты решают сами»); паритет текста руководств — не продуктовое
  поведение, а формулировка документации одного и того же уже согласованного
  контракта.

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

- Гейты `typecheck`/`test`/`build`/`check-docs`/смоки — не запускались:
  дельта правит только `docs/specs/**`, продуктового кода нет, issue не в
  `S5-ready`. То же решение объёма, что в r1.
- Реализуемость AC7 на уровне будущего диффа кода/документации — предмет
  код-ревью после реализации, не ТЗ-ревью.
- Разделы 1–4, 6, 8–13 не перечитывались построчно заново — они наследуются
  из r1 согласно разделу «Унаследовано из r1» выше, дельта их не касается.

## Вердикт

Зелёный: находка r1 закрыта по существу и проверена по коду/докам, а не по
заявлению автора; новых находок нет. Продуктовых вопросов владельцу нет.