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

SPEC-REVIEW-239-r2

• Issue: https://github.com/Matysh/houseplan-card/issues/239
• ТЗ: docs/specs/239-grid-scale-invariance.md
• Ветка / SHA: issue/239-grid-scale-invariance @ e8b3c86
• Этап: spec (PROCESS.md §2.4) · трек: обычный
• Заход: r2 · блокирующих циклов израсходовано 1/4 (r1 — жёлтый, потратил цикл; этот заход зелёный и цикла не образует, PROCESS.md §4, #227)
• Ревьюер: Claude, роль «ревьюер ТЗ»

Скоуп

Оценивалась дельта r2 — ровно один docs-коммит e8b3c86 (26 строк diff в docs/specs/239-grid-scale-invariance.md), закрывающий две находки r1 (M1, L1). Дельта локальна: правка добрасывает доказательную таблицу и i18n-текст в уже принятый по продуктовой рамке документ, не меняет ни диагноз §3, ни классификацию §6, ни контракт поверхностей §8, ни AC1–AC16 по существу. Полный повторный разбор всего документа не требуется — применяется PROCESS.md §2.9/§2.10.

Код не менялся: git diff origin/dev...HEAD --stat — три файла, все docs/** (спека, README реестра, обзорный документ r1).

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

1. Найден вердикт r1 в комментариях issue: жёлтый, заход r1, SHA 4c065f5, документ docs/reviews/SPEC-REVIEW-239-r1.md (SHA в вердикте не был назван явно текстом — восстановлен по хэндоффу автора «Коммит 4c065f5» и по git log, где 4c065f5 — последний спек-коммит перед комментарием с вердиктом).
2. Дельта объявлена и получена: git diff 4c065f5..e8b3c86 -- docs/specs/239-grid-scale-invariance.md — два блока: §10 (i18n-ключи) и новый §13.1 (матрица доказательств AC1–AC16).
3. По каждой находке r1 проверено построчно, чем именно она закрыта (см. раздел «Закрытие раунда r1» ниже) — не по заявлению автора в хэндоффе, а по самому тексту документа.
4. Перечитаны затронутые дельтой разделы в актуальном контексте всего документа: §9.2 (текст подписей), §10, §13 (AC13/AC14/AC16 целиком), §14 (план автотестов), §16 (риски), §19 (список «assumed, change freely»), чтобы убедиться в отсутствии противоречий между новым текстом и остальным ТЗ.
5. Сверены формулировки новой матрицы с существующим кодом там, где это проверяемо на этапе spec:
   • src/i18n/en.json:373-374, src/i18n/ru.json:373-374 — ключи space.scale_label / space.scale_unit и их текущий текст («cm per cell» / «см на клетку») существуют буквально так, как утверждает новый §10 — совпадение, не догадка;
   • space.scale_unit_imperial — новый ключ, кода ещё нет, что ожидаемо на этапе spec.
6. Гейты, применимые к docs-only дельте класса C: node scripts/check-docs.mjs → Documentation checks passed (7 files, 10 external links); git diff 4c065f5..e8b3c86 --check → чисто (нет whitespace-ошибок). npx tsc --noEmit / npm test / npm run build не запускались: git diff origin/dev...HEAD --stat подтверждает, что весь диапазон изменений — три файла в docs/**, класса A/B файлов нет, предмета для этих гейтов не существует.

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

Находка r1	Чем закрыта	Где это видно
M1 (Medium) — §13 не указывает способ доказательства для AC13, AC14, AC16, не восстанавливается из §14/§16	Добавлен новый раздел §13.1 «Матрица доказательств» с одной строкой на каждый AC1–AC16, включая явные записи для AC13 (code review exact scale-1 attributes + golden:verify как предрелизный, не как отдельно принимаемый baseline + docs provenance), AC14 (targeted touch/opening smoke: перечислены tap/pan/pinch/second-pointer/pointercancel/suppressed click раздельно, плюс edge hit-points из AC3) и AC16 (check-docs + code review обоих changelog/guide + screenshot provenance)	docs/specs/239-grid-scale-invariance.md:377-396, три строки таблицы для AC13/AC14/AC16
L1 (Low) — §10 не называет конкретный текст/ключ imperial-подписи внутри самого i18n-раздела, а отсылает к §9.2	§10 теперь сам перечисляет оба ключа и оба текста (space.scale_unit metric, новый space.scale_unit_imperial, space.scale_label для label), не отсылая читателя к другому разделу — соответствует конвенции остальных спеков (#157, #167, #094), на которую ссылался L1	docs/specs/239-grid-scale-invariance.md:282-284

Обе правки точечные и не задевают ничего за пределами названных находок — дельта в 26 строк ровно совпадает с объёмом, который требовали M1 и L1.

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

Всё содержательное решение ТЗ, кроме двух правок выше, принято без повторной проверки по итогам r1 (docs/reviews/SPEC-REVIEW-239-r1.md @ 4c065f5):

• продуктовая рамка §1–2, соответствие J4/J6 из docs/SCOPE.md, отсутствие продуктовых вопросов владельцу — не пересматривалось;
• диагноз §3 (построчная сверка с кодом: opening-symbol.ts, ISO_WALL_HEIGHT/ISO_FLOOR_EDGE_HEIGHT, cellCm: 5 в manual create и floors-import, HATCH_BASE_STEP_UNITS, iconUnit/iconCqw) — дельта их не касается, повторная построчная сверка не проводилась;
• классификация размеров §6 и контракт поверхностей §8 — внутренняя непротиворечивость подтверждена в r1 алгебраически (iconCqw/iconUnit), дельта их текст не меняет;
• AC1–AC12, AC15 сами по себе (формулировки) — признаны однозначными и алгебраически проверяемыми в r1, дельта их не редактировала, только добавила способ доказательства в §13.1;
• откат §18 и release-артефакты §17 — признаны полными в r1, не менялись;
• риски §16 — признаны содержательными в r1, не менялись.

Находки

Нет находок ни в дельте, ни в местах, которые дельта задевает (§9.2, §10, §13, §13.1, §14, §16, §19 перечитаны целиком на непротиворечивость с новым текстом — противоречий не найдено).

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

• Обе находки r1 закрыты по существу, а не переформулированы: M1 — таблица покрывает все 16 AC, а не только три названных, и формулировки строк буквально соответствуют тексту соответствующего AC (например, строка AC14 отдельно называет «tap остаётся действием» и отдельно — «pan/pinch/... не выполняют action», что закрывает обе половины критерия, на неполноту которых указывал r1); L1 — ключи и тексты названы в самом §10, дублирование с §9.2 не противоречиво (тексты идентичны).
• Новая матрица §13.1 согласована с остальным документом: ссылки на конкретные файлы (test/grid-scale.test.mjs, demo/smoke_grid_scale_invariance.mjs, demo/smoke_space_scale_defaults.mjs) совпадают с именами, уже введёнными в §14.1/§14.2; ссылка на mutation grid-scale-physical-double-scaled в строке AC5 совпадает со строкой таблицы §15; разделение «code review» vs «предрелизный гейт» для AC13/AC15 согласовано с §12 и §14.3.
• Новый i18n-текст §10 совпадает с уже существующим кодом для действующего ключа (space.scale_unit/space.scale_label, проверено по src/i18n/en.json/ru.json) — не введено расхождение с реальностью для той части, которая уже реализована.
• Докс-гейт зелёный: node scripts/check-docs.mjs → Documentation checks passed (7 files, 10 external links); git diff --check на дельте — чисто.

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

• Полный повторный разбор диагноза §3, классификации §6, контракта поверхностей §8 и AC1–AC12/AC15 по существу — дельта их не касается, унаследовано из r1 (см. выше), правило §2.9/§2.10.
• npx tsc --noEmit, npm test, npm run build — не запускались: диапазон диффа не содержит файлов класса A/B, гейты не имеют предмета проверки.
• Реализация helper'ов, тестов и smoke-файлов, названных в §13.1/§14 — кода нет, оценивалась только логическая полнота ссылок на этапе spec.
• Golden/browser smoke/performance — не запускались и не должны: этап spec, реализации нет, эти гейты относятся к предрелизному прогону (PROCESS.md §8).