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

Ревью ТЗ — issue #179, цикл r2

• Issue: https://github.com/Matysh/houseplan-card/issues/179
• ТЗ: docs/specs/179-device-icons-redesign.md (коммит 2310e6d, ветка issue/179-device-icons-redesign)
• Трек: обычный
• Вердикт: зелёный · цикл r2/4 · High: 0 · Medium: 0 · Low: 0

Скоуп ревью

Проверялась правка ТЗ, внесённая автором в ответ на SPEC-REVIEW-179-r1.md (вердикт жёлтый, 5 Medium + 2 Low, все в скоупе). Скоуп этого цикла — точечный: подтвердить, что каждая из 7 находок r1 закрыта фактически, а не текстом, и что правки не внесли новых противоречий или непроверяемых мест. Продуктовый код по-прежнему не существует (issue не дошёл до S5-ready), поэтому раздел «Гейты» PROCESS.md §8 к этому циклу неприменим — как и в r1.

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

1. Прочитаны docs/SCOPE.md, AGENTS.md, PROCESS.md (§2.4, §7.1, §7.2, §8, §12) и целиком docs/reviews/SPEC-REVIEW-179-r1.md.
2. Прочитано тело issue #179 и все комментарии (gh issue view 179 --json body,comments), включая ответ автора от 2026-08-19T19:06:37Z с перечнем исправлений.
3. Получен точный diff редакции: git diff 517a710 2310e6d -- docs/specs/ 179-device-icons-redesign.md — правка сверялась по факту изменённых строк, а не по пересказу автора в комментарии.
4. Архив дизайнера передекачан и распакован (sha256sum совпал: 63670C73E25D1E59DDAF1BE236F3D7F2FAC827B9B5D6DD4B77125EA9BC012025), чтобы независимо перепроверить факты, на которых основана правка:
   • grep -o feColorMatrix… "Light/Icon Default.svg" → значения 0.145098/0.156863/0.176471 = 37/255, 40/255, 45/255 — подтверждает цвет тени из M1;
   • diff "Dark/Icon Default.svg" "Dark/Icon Default No Blur.svg" → единственное отличие — слой foreignObject с backdrop-filter:blur(20px) и атрибут data-figma-bg-blur-radius; core/ stroke/filter-тень (filter0_ddi_104_1541) идентичны — подтверждает заявление M4/риска о сохранении геометрии;
   • diff "Light/Icon Default.svg" "Light/Icon Default No Blur.svg" → файлы побайтно идентичны, что согласуется с правилом «Light не содержит blur» и с пометкой deprecated: true, aliasOf: "Light/Icon Default.svg" для Light-варианта в manifest.json (у Dark-варианта такой пометки нет — перепроверено grep -n -i "no blur" manifest.json и чтением окружающего JSON, узел qaFallback);
   • grep -in "presence\|green" SPECIFICATION.md ACTIVE_ANIMATION_SPEC.md DEVELOPER_HANDOFF.md — подтверждает, что явного reason→color маппинга в архиве по-прежнему нет (это ожидаемо: M2 требовал не найти маппинг в архиве, а явно принять и промаркировать решение в ТЗ).
5. Сверена цитата docs/TOUCH-SUPPORT.md — таблица контракта содержит ровно | Device editor | … | Best effort | — правка M5 воспроизводит источник точно, без искажения формулировки.
6. Проверена трассируемость: docs/specs/README.md не расходится с ТЗ, коммит 2310e6d несёт корректные трейлеры Issue: #179 / User-Visible: no, изменения ограничены одним файлом ТЗ (класс C, документация, что не требует отдельного issue сверх текущего).
7. Гейты не прогонялись — на этапе ревью ТЗ продуктового кода нет, раздел неприменим (как и в r1).

Проверка находок r1 — построчно

#	Требование r1	Что внесено в 2310e6d	Проверка
M1	Заменить rgb(0 0 0 / …) на rgb(37 40 45 / …) в §7.1	Обе Light-тени переписаны на rgb(37 40 45 / 12%) / rgb(37 40 45 / 18%)	Подтверждено feColorMatrix в реальном SVG — закрыто
M2	Явно зафиксировать mapping presence→цвет или исключить Green	§10.1/§10.4 получили mapping presence→green, running/working/open/unlocked→amber, neutral→blue; §20 п.9 маркирует это как явное техническое предположение	Архив по-прежнему не даёт этого маппинга текстом (перепроверено), решение корректно оформлено как предположение автора, а не выдано за факт архива — закрыто
M3	Добавить easing в §10.2/§10.3	Обе секции получили cubic-bezier(.22,.61,.36,1)	Совпадает с @keyframes в Animated/Light(Dark)/Short Activity Animated.svg и Alert Animated.svg (сверено в r1, повторно не перекачивал анимационные SVG — не менялись) — закрыто
M4	Явное решение blur/No-Blur для Dark + запись в §17/AC13	§7.1 фиксирует production = Dark/Icon Default No Blur.svg, backdrop-filter запрещён; риск и митигация добавлены в §17; AC13 явно требует отсутствия per-marker backdrop-composite layer	diff двух SVG подтверждает: различие ровно в blur-слое, геометрия/тень сохранены — закрыто, причём риск обоснован фактом, а не на глаз
M5	Добавить тег Touch editor: …	Добавлена строка Touch editor: best effort / intentionally degraded в §11	Совпадает с канонической записью TOUCH-SUPPORT.md («Device editor … Best effort») — закрыто
L1	Отразить Light-only combo-эталоны в golden-матрице	§16.4 получил абзац: комбинации проверяются в обеих темах, Dark — по layer-contract, так как Dark combo-assets в архиве нет	Соответствует составу архива (5 Light-комбо-файлов, 0 Dark) — закрыто с явной записью
L2	Снять или обосновать оговорку про static_icon unavailable-hover	Оговорка unavailable hover запрещён удалена из §7.3	Мёртвый кейс убран — закрыто

Все 5 Medium и 2 Low из r1 закрыты точечными правками текста, без затрагивания архитектуры, AC-нумерации или скоупа задачи. Новых расхождений между текстом правки и архивом/каноническими документами не обнаружено.

Проверено и признано корректным (сверх таблицы выше)

• Diff ограничен ровно тем, что заявлено в комментарии автора; посторонних правок вне перечня r1 нет (git diff 517a710 2310e6d просмотрен целиком).
• Внутренняя согласованность новых формулировок: §7.2 (таблица цветов), §10.1 и §10.4 используют один и тот же mapping presence/running-working- open-unlocked/neutral без расхождений между разделами.
• AC8 и AC13 обновлены синхронно с текстом §10 и §7.1/§17 — доказательство (pure resolver tests + DOM/style smoke для AC8, code assertion + performance_smoke.mjs для AC13) остаётся конкретным и проверяемым после добавления новых пунктов.
• Обязательные разделы §7.1 PROCESS.md по-прежнему все на месте (правка их не затронула); статус документа обновлён («ревизия 2 после жёлтого ревью r1»).
• Трейлеры коммита 2310e6d (Issue: #179, User-Visible: no) корректны; правка не меняет продуктовое поведение, только сам ТЗ-документ (класс C).
• Открытых продуктовых вопросов владельцу по-прежнему нет; все 7 находок были техническими/точечными и решены автором без эскалации.

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

• Часть проверок из r1 не повторялась, так как соответствующий текст ТЗ не менялся в этой правке (полная геометрия 32/96 px, границы LQI, приоритет замков, i18n-паритет, разделы §1–§6, §8, §9, §12–§15, §18–§19) — доверие к r1 обосновано тем, что git diff подтверждает: эти строки не тронуты.
• Continuous/Short/Alert тайминги (кроме easing) не перепроверялись повторно по @keyframes — они не менялись в этой редакции, полная сверка уже была в r1.
• Figma-фреймы (99:1290, 104:1539) не открывались — ревью ограничено содержимым архива, как и в r1.
• Производительность не измерялась — кода нет; оценка M4/AC13 остаётся решением на уровне текста, а не измеренным фактом.
• Гейты typecheck/test/build/smoke/golden не запускались — этап ревью ТЗ, продуктового кода не существует, раздел неприменим.

Итог

Все находки r1 закрыты фактически, каждая перепроверена по первоисточнику (архив, TOUCH-SUPPORT.md, сам diff), а не принята на слово из комментария автора. Новых Medium/High находок нет. ТЗ готово к разработке.