feat(gates): measure capture drift between runs and anchor reachability (#422)

User-Visible: no
Issue: #422

.github/workflows/docs-screenshots.yml

@@ -77,8 +77,17 @@ jobs:
             "oxipng-${OXIPNG_VERSION}-x86_64-unknown-linux-gnu/oxipng"
           echo "$HOME/.local/bin" >> "$GITHUB_PATH"
           "$HOME/.local/bin/oxipng" --version
-      - name: Capture
-        run: node demo/docs/capture.mjs
+      # Съёмка идёт дважды и сравнивается по хешам (#422). Прежний замер
+      # (`--stability`) отвечает на вопрос «плавает ли кадр от времени внутри
+      # страницы» и остаётся ниже; дефект #410 был по другой оси — обрезка
+      # плавала МЕЖДУ прогонами, и три снимка внутри одного процесса совпали бы
+      # всегда. Проверка, объявленная гарантией воспроизводимости, на
+      # собственном инциденте промолчала бы.
+      #
+      # Второй прогон заодно оставляет в `docs/images` кадры, которые и уедут в
+      # артефакт: сравнивать хеши и публиковать разные файлы было бы странно.
+      - name: "Съёмка воспроизводима между прогонами (#410, #422)"
+        run: node scripts/capture-determinism.mjs
       # Вердикт до всякой приёмки. Само число изменившихся файлов ничего не
       # говорит: набор, снятый другим браузером, меняет их все, и это нормально
       # ровно один раз — при переходе на канонический прогон. Сравнивать надо
@@ -94,8 +103,9 @@ jobs:
       # правки состояния между ними, обязаны совпасть побайтово. Шаг падает,
       # если кадр снова начнёт зависеть от времени.
       #
-      # Проверка стоит ПЕРЕД съёмкой набора: смысла публиковать артефакт,
-      # снятый недетерминированной съёмкой, нет.
+      # Шаг стоит ПОСЛЕ съёмки и до вердикта: публикацию артефакта он всё равно
+      # блокирует падением job'а, а снимать набор третий раз ради порядка строк
+      # в логе незачем.
       - name: "Кадр не плавает внутри одного состояния (#410)"
         run: node demo/docs/capture.mjs --stability=3
       - name: Хеши кадров