houseplan-card/docs/reviews/CODE-REVIEW-478-r3.md

CODE-REVIEW-478-r3

• Issue: #478 — отказ от сущности «черновик контура» (room_drafts), wall model v9 → v10
• Ветка: issue/478-remove-room-drafts
• SHA материала: 4beb5c882907d17b63a1761e6040c84f17516d13 (сверено git rev-parse HEAD непосредственно перед выводом, §2.7)
• SHA предыдущего раунда (r2): 0c670a9862ab4266a677b5553c070f2e41bab0c0 — назван явно в документе docs/reviews/CODE-REVIEW-478-r2.md (раздел «Материал раунда»: SHA материала, дерево, блоб ТЗ) и подтверждён вердиктом в issue от 2026-09-06T16:14:47Z. SHA резолвится напрямую, архаичное восстановление по дереву/блобу не потребовалось.
• Диапазон дельты: git diff 0c670a98..HEAD — 2 файла:
  • docs/CONFIG-COMPATIBILITY.md — 7 вставок / 6 удалений (продукт-документация, класс C);
  • docs/reviews/CODE-REVIEW-478-r2.md — добавлен пайплайном публикации предыдущего раунда, к предмету этого раунда не относится (это протокол r2, а не правка автора). Единственная правка автора в этом раунде — коммит 4beb5c88 («docs: describe deterministic legacy id repair», Issue: #478 · User-Visible: no).
• Заход: r3 · блокирующих циклов израсходовано 0 из 4 (значение объявлено на входе в раунд; зелёные вердикты бюджет не тратят, красный r1 и жёлтый r2 уже были учтены до этого раунда — §4, #227).

Вердикт

Зелёный. High: 0, Medium: 0, Low: 0.

Дельта r2→r3 — ровно то, что и должна была быть: закрытие единственного Medium из r2 (расхождение docs/CONFIG-COMPATIBILITY.md с фактическим поведением миграции), больше ничего не менялось. Новых находок дельта не вносит.

Скоуп

Полный повторный разбор не требуется — ни одно условие «разбор остаётся полным» не выполняется:

• dev не двигался: git merge-base origin/dev HEAD == git rev-parse origin/dev == c82ba84cc7867e0b8e20aaa39ac3270e675c341f (то же значение, что зафиксировал r2 — ребейза не было);
• контракт поведения не меняется — правка только в тексте канонического документа, ни один файл src/** или custom_components/**/*.py дельтой не тронут;
• новая подсистема не затронута;
• объём дельты (1 файл продукт-документации, 13 строк) на два порядка меньше исходной задачи (154 файла на r1) и меньше даже дельты r1→r2 (50 файлов).

Предмет раунда — единственный коммит 4beb5c88, правящий абзац «Ordinary wall chains — model v10 (#478)» в docs/CONFIG-COMPATIBILITY.md.

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

Находка r2	Чем закрыта	Где это видно
Medium-1 — docs/CONFIG-COMPATIBILITY.md:203 утверждал «an id collision fails closed», хотя фикс High-1 (r1→r2) заменил это поведение на детерминированную регенерацию id с числовым суффиксом; документ описывал состояние SHA 1cadd520, а не HEAD	Абзац переписан: «A unique existing segment id is retained; a missing, empty or colliding id is replaced deterministically from the space, draft and edge index, with a stable numeric suffix when needed. … Malformed geometry or invalid thickness fails closed» — коллизия убрана из списка отказов, взамен описано реальное поведение (регенерация + суффикс)	docs/CONFIG-COMPATIBILITY.md:198-203 (коммит 4beb5c88). Сверено с кодом обоих движков на HEAD: src/wall-segment-model.ts:779-786 (if (!id || used.has(id)) { … for (let suffix = 2; used.has(id); suffix++) id = \${base}-${suffix}`; }) и custom_components/houseplan/wall_segment_model.py:690-698(тот же алгоритм:while segment_id in used: segment_id = f"{base}-{suffix}"). Оба файла не менялись этой дельтой — код тот же, что r2 уже проверил исполнением (28/28, откат к r1 ловит duplicate-id`); проверено чтением, что новый текст документа буквально соответствует этому коду

Прочие расхождения соседних фраз не возникло: grep -n -i "collision\|fails closed" по всему файлу даёт единственное вхождение — исправленную строку 203. Остальной абзац (сохранение существующего уникального id, порядок черновика, cm, атомарное удаление carrier-записи, отказ для malformed geometry/thickness, отклонение stale v9-записи с room_drafts поверх v10) дельтой не тронут и по-прежнему соответствует коду, не изменённому с r2.

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

Без повторной проверки принято (дельта их не касается):

• обе High-находки r1 и весь список Medium/Low r1 — закрыты и подтверждены исполнением на SHA 0c670a98, из docs/reviews/CODE-REVIEW-478-r2.md, раздел «Закрытие раунда r1»;
• продуктовая рамка и соответствие docs/SCOPE.md (J6) — из docs/reviews/CODE-REVIEW-478-r1.md, SHA 1cadd520;
• полнота ТЗ и решения владельца — docs/reviews/SPEC-REVIEW-478-r1.md (зелёный, 0 циклов), из вердикта в issue от 2026-09-06T12:05:47Z, SHA ТЗ 30a16ed3;
• вся продуктовая логика миграции v9→v10, атомарность приёма комнаты (_applyWallFaceBatch, _commitRoom), fixed-point Optimize сразу после accept, session-only цепочка, golden-харнесс, мутационный свидетель room-accept-leaves-coincident-partitions, инварианты модели на мигрированной фикстуре — из docs/reviews/CODE-REVIEW-478-r2.md, разделы «Как проверялось» и «Что проверено и корректно», SHA 0c670a98. Ни один из этих файлов не входит в дельту r2→r3. AC1–AC15 — все либо доказаны исполнением в r1/r2, либо унаследованы без изменений; эта дельта не задевает ни одного доказательства.

Как проверялось (этот раунд)

Дельта не трогает src/**, custom_components/**/*.py, тесты, смоки, схему или геометрию — только текст канонического документа. Дешёвые гейты и тяжёлые гейты, специфичные для этой дельты, не требуются: изменение не могло сломать typecheck/build/tests (ни одна строка кода не менялась) и не меняет видимый пользователю результат.

Гейт	Статус	Обоснование
npx tsc --noEmit / npm test / npm run build + сверка 3 копий бандла	не перегонял	Validate зелёный на точном SHA 4beb5c88: https://github.com/Matysh/houseplan-card/actions/runs/34044883164 (указан в задаче ревью, номер run проверен)
node scripts/check-docs.mjs	не запускал	диф не трогает src/** — по правилу необязателен; автор отчитался о зелёном прогоне с --external на этом же SHA
Инварианты модели / mutation-gate / golden / smoke / backend pytest	не применимо	дельта не трогает геометрию, layout, marker.space, open_spans, рендер-путь, Python или продуктовый TS-код — только формулировку одного абзаца документации
Чтение кода против нового текста документа	выполнено	src/wall-segment-model.ts:779-786, custom_components/houseplan/wall_segment_model.py:690-698 — оба соответствуют новой формулировке дословно (см. таблицу закрытия выше)
grep -n -i "collision|fails closed" docs/CONFIG-COMPATIBILITY.md	выполнено	единственное вхождение — исправленная строка; побочных несогласованных упоминаний коллизии в файле нет
Трейлеры коммита 4beb5c88	выполнено чтением	Issue: #478, User-Visible: no — корректно: правка не меняет видимое поведение продукта, изменений changelog не требуется
git merge-base origin/dev HEAD vs origin/dev	выполнено	совпадают (c82ba84c…) — dev не двигался, ребейза нет, полный разбор не требуется

Чего не проверял и почему

• Полный набор дешёвых и тяжёлых гейтов (tsc, npm test, npm run build, golden, смоки, backend pytest, инварианты модели, mutation-gate) — не прогонял ни один: диапазон дельты не содержит ни одной строки кода, теста или фикстуры, только абзац документации, а зелёный Validate на этом точном SHA уже подтверждён. Прогон был бы тратой бюджета без предмета — сама правка физически не может их затронуть.
• Полное повторное чтение src/houseplan-editor-runtime.ts, wall-segment-model.ts/.py целиком — не требовалось: читал только два фрагмента, на которые ссылается исправленный абзац, чтобы сверить текст с кодом буквально; остальное унаследовано из r2 без изменений.

Находки

Нет.

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

• Единственный Medium из r2 закрыт точно и без побочных эффектов: новый текст документа дословно соответствует коду обоих движков (TS и Python), которые сам код в этой дельте не менял.
• Остальной текст абзаца «Ordinary wall chains — model v10 (#478)» не пострадал от правки и по-прежнему верен (сверено grep на слово «collision»/«fails closed» — расхождений нет).
• Трейлеры коммита корректны, changelog не требуется по существу изменения.
• dev не двигался, дельта локальна и мала — сокращённый разбор оправдан.

Итог

Ни одной находки любого уровня. Раунд закрывает единственный отложенный вопрос r2 (доку́мент ↔ код) и не вводит новых. Задача готова к очереди на пре-релиз.

Материал раунда

• git diff 0c670a98..HEAD (дельта r2→r3, предмет разбора)
• git diff origin/dev...HEAD (сверка, что dev не двигался — не как предмет полного разбора)
• Issue #478 и все комментарии, включая тексты docs/reviews/CODE-REVIEW-478-r1.md (SHA b754d362) и docs/reviews/CODE-REVIEW-478-r2.md (SHA c9194bfb)
• docs/specs/478-remove-room-drafts.md (не менялся с r1)
• docs/CONFIG-COMPATIBILITY.md, docs/SCOPE.md, AGENTS.md, PROCESS.md
• Ветка: issue/478-remove-room-drafts, коммит 4beb5c882907d17b63a1761e6040c84f17516d13
• Дерево материала: 32e8c1d340a8f48bfeaf10952eed0192fcb2819a

---

Материал раунда

• Ветка: issue/478-remove-room-drafts, коммит 4beb5c882907 — ребейз его осиротит, и это нормально: ниже якоря, которые ребейз не меняет.
• Дерево материала: 32e8c1d340a8f48bfeaf10952eed0192fcb2819a

  git log --all --format='%H %T' | grep 32e8c1d340a8
  

• ТЗ docs/specs/478-remove-room-drafts.md, блоб 70719ed585a993825720f90a2483fa760747bb06

  git log --all --find-object=70719ed585a993825720f90a2483fa760747bb06 -- docs/specs/478-remove-room-drafts.md