german/houseplan-card
1
0
Fork 0
mirror of https://github.com/Matysh/houseplan-card synced 2026-09-29 03:09:36 +00:00
Code Issues Actions 6 Packages Projects Releases Wiki Activity
Files
cff83e43eccd27c7f0ff0c5ca1c104f42fdf2023
houseplan-card/docs/reviews/CODE-REVIEW-657-r2.md
T
claude[bot] 563fbe0759 docs: review document for #657 
Issue: #657
User-Visible: no
2026-09-26 07:28:24 +00:00

17 KiB
Raw Blame History

CODE-REVIEW-657-r2

  • Issue: https://github.com/Matysh/houseplan-card/issues/657
  • Материал: git diff origin/dev...HEAD на 55af28ffb291155c6fff31368fa35b5d0a6bde3b (ветка issue/657-generated-at-merge, HEAD detached), 38 файлов, +1371/−142. Якоря совпадают: head=55af28ff, tree=9e320186 (git rev-parse HEAD^{tree} подтверждает), base=9287f798 (git rev-parse origin/dev подтверждает).
  • Класс: B (scripts/**, test/**) + C (PROCESS.md, docs/reviews/**) — класса A нет.
  • Этап: код-ревью (PROCESS.md §2.7), заход r2, блокирующих циклов израсходовано 1/4 (потрачено раундом r1, красным).
  • Вердикт: зелёный.

Скоуп

Задача — та же, что в r1: конвейер ревью (инфраструктура, обслуживает Core user jobs SCOPE опосредованно, через скорость доставки, не напрямую). Раунд r2 — точечное закрытие находки H1 из CODE-REVIEW-657-r1.md: между r1 и r2 ветка была приведена к ушедшему вперёд dev (scripts/rebase-on-dev.mjs, конфликт только в INDEX.md, решён пересборкой — commit 9287f798, включает слитый #654 f5c6d70b), затем добавлен коммит 55af28ff, закрывающий H1.

Дельта не в буквальном смысле локальна на уровне git diff (ребейз на ушедший вперёд dev подтягивает файлы #654 — src/iso-first-frame.ts, бандл, скриншоты и т.п., если сравнивать с осиротевшим 339379f5 напрямую), но эта часть дельты — механический побочный эффект ребейза, не работа этой задачи: она уже прошла ревью в CODE-REVIEW-654-r1.md и не входит в git diff origin/dev...HEAD (актуальный origin/dev = 9287f798, тот же SHA, что в материале r2 как база). Проверено явно:

git diff origin/dev...HEAD --stat -- 'src/**' 'custom_components/**/*.py'   → пусто
git rev-parse origin/dev                                                    → 9287f798…

Значит предмет этого раунда — ровно то, что видно в origin/dev...HEAD (38 файлов), а из них к r1→r2 дельте относятся только:

Файл Что изменилось
scripts/merge-candidate.mjs новый ops.freshIndex(tip) + вызов в ветке !devMoved — сам фикс H1
test/merge-candidate.test.mjs +2 теста: мок (fakeOps) и реальный git-сценарий, доказывающие фикс
scripts/mutation-registry.mjs мутант merge-ff-skips-review-index (среди прочих, унаследованных из r1)
PROCESS.md абзац «Индекс документов ревью» уточнён: назван и fast-forward путь
docs/reviews/CODE-REVIEW-657-r1.md, docs/reviews/INDEX.md публикация документа r1 + пересборка индекса
scripts/monolith-baseline.json убран из диффа задачи (был в r1, вреден после роста бандла в #654)

Разбор ниже полный по этой дельте (проверка H1 — чтением, мутацией и реальным исполнением) и опирается на r1 для остального (раздел «Унаследовано»).

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

Зелёный Validate на материале 55af28ff подтверждён дважды (страж слияния использует именно этот SHA):

Дешёвые гейты (typecheck, npm test, npm run build + bundle-policy --verify) не перегонял — покрыты этими прогонами (#343).

Прогнал сам, поверх дешёвых гейтов (нужно для проверки самой находки H1, не входит в стандартный набор для B/C):

Гейт Команда Результат
Мутант H1 живой, тест зелёный на текущем коде node --test --test-name-pattern="#657 r1 H1" test/merge-candidate.test.mjs 2/2 pass
Тест умеет падать (мутация в лоб: const target = ops.freshIndex(tip); → const target = tip;, ровно патч merge-ff-skips-review-index) тот же файл, тот же паттерн, после ручной правки scripts/merge-candidate.mjs 2/2 fail — expected r.candidate === 'idx-mat' и документ раунда виден через индекс оба красные; файл восстановлен из бэкапа сразу после
Индекс на текущем HEAD свеж (последствие делает --check, независимая проверка) node scripts/reviews-index.mjs --dir=docs/reviews --check «docs/reviews/INDEX.md свеж», exit 0
Диф не трогает src/**/Python — гейты smoke/pytest/invariants/golden не применимы git diff origin/dev...HEAD --stat -- 'src/**' 'custom_components/**/*.py' → пусто; node scripts/smoke-select.mjs --base origin/dev --head HEAD «Исполняемого frontend-диффа нет… смоки не выбираются» (тронуто файлов: 38)
monolith-baseline.json действительно вне диффа задачи (проверка утверждения автора о его удалении) git diff origin/dev...HEAD --stat -- scripts/monolith-baseline.json пусто

Не прогонял: golden, pytest tests_backend, performance, check-docs.mjs — диф не трогает demo/** (визуал), custom_components/**/*.py или профили, и не трогает src/**; AC их не называет. process-gate --issues — недоступен без gh-контекста конвейера в песочнице (то же ограничение, что у автора).

Находки

Нет.

H1 из r1 — проверка закрытия

AC: «После слияния без движения dev индекс на голове dev свеж».

Фикс. scripts/merge-candidate.mjs: новый ops.freshIndex(tip) — checkout -B merge-into-dev <tip> → reviews-index --commit-if-stale → rev-parse HEAD; в ветке !devMoved вызывается перед pushWithLease, и именно его результат (target, не голый tip) идёт и в push, и в candidate итогового ответа. Реализация — прямая копия уже существующего паттерна rebaseOnto (тот же merge-into-dev, тот же вызов скрипта индекса), не новая архитектура: читается за секунды, согласована со стилем файла.

Прочитан весь путь: при devMoved === false tip — потомок devNow (поскольку materialBase === devNow и tip происходит от material), а target — потомок tip; значит push target в dev остаётся fast-forward'ом, как и заявлено в комментарии к коду и в PROCESS.md. Если индекс уже свеж (commit-if-stale — no-op), target === tip: лишний коммит не создаётся, поведение не меняется относительно варианта без находки.

Доказательство исполнением, не только чтением:

  • node --test --test-name-pattern="#657 r1 H1" test/merge-candidate.test.mjs → 2/2 pass на неизменённом коде: мок-тест (индекс пересобран до push, pushWithLease получает idx-mat, не mat) и тест на настоящем git (документ код-ревью коммитится в ветку без индекса — ровно как теперь делает конвейер после 1б — git merge --ff-only в dev, затем настоящий node scripts/reviews-index.mjs --check, без моков, exit 0).
  • Мутация в лоб (тот же патч, что зарегистрирован как merge-ff-skips-review-index в mutation-registry.mjs): const target = ops.freshIndex(tip); → const target = tip; — оба теста краснеют. Тест умеет падать; правило #435 (пустой третий столбец — Medium) выполнено, столбец не пуст и проверен, а не просто заявлен.
  • Отдельно вручную: реальный dev, после ребейза, INDEX.md уже свеж (reviews-index --check — «свеж»), т.е. на этом конкретном материале инвариант держится и до предстоящего слияния конвейером.

Вывод: H1 закрыт. AC доказан тестом, который умеет падать на реальной мутации, воспроизводящей именно то поведение, что было найдено в r1 (fast-forward без пересборки индекса).

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

Находка (r1) Чем закрыта Где это видно
H1 (High): fast-forward без движения dev уносил устаревший INDEX.md, красил reviews_index на голове dev ops.freshIndex(tip) в scripts/merge-candidate.mjs:167-177, вызов в ветке !devMoved (scripts/merge-candidate.mjs:262-266) + абзац PROCESS.md про оба пути пересборки scripts/merge-candidate.mjs (диф origin/dev...HEAD), test/merge-candidate.test.mjs (2 новых теста), мутант merge-ff-skips-review-index в scripts/mutation-registry.mjs; проверено выше исполнением, не только заявлением автора

Дополнительно (не было находкой, но отмечено автором и проверено): коммит «lower monolith bundleBytes base» из ветки убран после ребейза — подтверждено (monolith-baseline.json вне диффа задачи), это верно защищает от того, что опущенная база начала бы красить рост бандла после слияния #654.

Унаследовано из r1 (без повторной проверки)

Из docs/reviews/CODE-REVIEW-657-r1.md (материал 339379f504f7, тело issue e15e73b2…), без находок, дельта r1→r2 их не задевает (см. таблицу дельты выше — ни один из этих файлов не менялся):

  • Бандл-политика (2б) — scripts/bundle-policy.mjs, правило коммита, --verify/сверка копий только на кандидате, assertCommittedBundleFresh, bundle-sync --release/bundle:clean.
  • rebase-on-dev.mjs — конфликт по бандлу берёт версию dev без пересборки/amend, GENERATED_ROOTS из bundle-policy.BUNDLE_ROOTS.
  • dev-build.mjs/стенд — коммит без родителя, публикация только головы, validate.yml job dev_build (continue-on-error, вне needs job proof).
  • Переключение публикации документа ревью на target=dev — _process.yml, мутант process-index-on-task-branch.
  • Трейлеры, число job-загрузок артефакта card-bundle — сверено вручную в r1, не меняется в r2.

Эти пункты не перепроверялись заново в r2: они не входят в дельту r1→r2, разбор r1 остаётся в силе (полный текст — в CODE-REVIEW-657-r1.md).

Что проверено и корректно (r2, сверх наследия)

  • Трейлеры всех трёх коммитов диапазона (f958305c, cc56ecff, 55af28ff) — Issue: #657, User-Visible: no на каждом; корректно (класса A нет, видимого пользователю поведения нет, changelog не требуется).
  • docs/reviews/INDEX.md на текущем HEAD свеж (--check → exit 0) — подтверждает, что ребейз/публикация r1-документа не оставили его в устаревшем состоянии в самой ветке задачи (что отдельно от предмета H1, который про поведение dev после будущего слияния).
  • Материал ревью для r1 (339379f504f7…), формально осиротевший после ребейза, разрешился без проблем: git fetch origin 339379f504f7ab5c9142bbca887c363fc0645f1e вытянул объект с сервера (правило #2.10 «SHA не резолвится — не находка, если объект достижим»).

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

  • Golden (npm run golden:verify), pytest tests_backend, performance — диф не трогает визуал/Python/профили, AC их не называет.
  • check-docs.mjs — не обязателен (диф не по src/**).
  • Живой прогон merge-candidate.mjs против настоящего GitHub API (gh, реальный push/lease) — не запускал, недоступно из песочницы; H1 доказан на уровне git-логики и файлового инварианта, что для этого класса дефекта достаточно.
  • Остальные шесть строк AC-таблицы хендоффа r1 (бандл-политика, стенд dev, bundle-sync, release-prerelease) — не перепроверялись в r2, см. «Унаследовано из r1».

Итог

Находка H1 из r1 закрыта: ops.freshIndex(tip) пересобирает индекс на tip перед push, когда dev не двигался, слияние остаётся fast-forward, и это доказано тестом на настоящем git (не только моком), который подтверждён падающим на прямой мутации логики фикса. Дельта r1→r2 сверх этого — техническая (публикация документа r1, ребейз на ушедший вперёд dev, удаление ставшей вредной правки базы монолита) и не создаёт новых находок. Остальная часть задачи (2б, стенд dev, переключение публикации) наследуется из r1 без повторной проверки, так как дельта её не задевает.

Вердикт: зелёный · заход r2 · блокирующих циклов 1/4 · High: 0 · Medium: 0 → в задаче · Документ: docs/reviews/CODE-REVIEW-657-r2.md

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

  • Ветка: issue/657-generated-at-merge, коммит 55af28ffb291 — ребейз его осиротит, и это нормально: ниже якоря, которые ребейз не меняет.
  • Дерево материала: 9e320186847332b0f3dac4a53886c79df1205ff4 
    git log --all --format='%H %T' | grep 9e3201868473
  • Тело issue: e15e73b22b32d0524d13035dc170c366dd9aa8a038a6ebb5dab193b2868f5043
  • Вердикт конвейера: green · High 0
Reference in New Issue View Git Blame Copy Permalink