fix(gates): съёмка кадров в чужой среде отказывается заранее

Вопрос владельца: зачем агенты снимают PNG на Windows, если кадры мы всё
равно не принимаем, тем более что WSL есть на обеих машинах. Ответ по
коду: этому ничто не мешало. Ни один из шести скриптов съёмки и приёмки
не знал, на какой он ОС — ни `process.platform`, ни win32, ни WSL не
упоминались нигде. Съёмка отрабатывала штатно, а стена появлялась на
приёмке, и текст стены говорил «сцен-свидетелей 0 из 10», то есть
подсказывал неверный вывод «надо объявить больше сцен» — от которого до
`--expect-change` на всю матрицу одна команда.

Причина запрета не политика, а физика: Windows растеризует текст через
DirectWrite, с другим субпиксельным сглаживанием и DPI, поэтому
байтового совпадения с принятым эталоном не даёт никогда, свидетелей
среды быть не может, и приёмка откажет всё равно. Флаги детерминизма из
#410 убирают разброс внутри среды, а не между ОС.

Что сделано:

- `golden:capture` отказывается до запуска браузера, в тексте отказа
  готовая команда для WSL;
- `golden:verify` остаётся законным в любой среде: он ничего не
  принимает, а как грубая проверка полезен;
- обе приёмки (golden и документации) отказываются в чужой среде;
- к отказу свидетелей приписывается фраза про расхождение среды — та
  самая, которой не хватало, чтобы отказ не читался как «объяви больше
  сцен»;
- платформа уезжает в манифесты рядом с версией Chromium: у кадров
  появился провенанс среды;
- осознанный обход есть и требует причину: HP_ALLOW_FOREIGN_CAPTURE.

Главный урок задачи — про цену правки файла, у которого записан хеш.
Первая редакция встроила проверку в `demo/docs/capture.mjs`, и гейт
документации сразу покраснел: его sha записан в индексе скриншотов, и
`scripts/check-docs.mjs` их сверяет. То есть проверка, которая ничего не
рисует, стоила бы пересъёмки всех картинок документации и визуальной
приёмки владельца. Поэтому для документации отказ живёт шагом раньше —
`npm run docs:capture` вызывает `scripts/assert-capture-env.mjs` — и
шагом позже, на приёмке. По той же причине гейт golden стоит в
`demo/golden/policy.mjs`, а не в `run.mjs`: последний входит в корпус
sourceFingerprint. Тест закрепляет обе границы: гейт обязан быть в
policy.mjs и в npm-скрипте и обязан отсутствовать в двух
фингерпринтуемых файлах.

Платформа в юнитах — параметр, а не `process.platform`: иначе тест был
бы зелёным на Linux и красным на машине владельца, то есть тестом про
хост, а не про правило.

AGENTS.md приведён к состоянию после #401 (принимается любая среда,
доказавшая себя байтовым совпадением непринятых кадров) и разводит
проверку и съёмку — прежний текст сливал их в «advisory» и утверждал
«accepted only on a complete Linux CI artefact».

Свидетели, все проверены отрицательным прогоном: снятый гейт съёмки,
гейт, отказывающий и на verify, обход без причины, отказ без команды,
убранная приписка про среду, отцепленные гейты обеих приёмок,
переставшая бросать обёртка, npm-скрипт без проверки и возврат гейта в
каждый из двух фингерпринтуемых файлов. Проверка подключения сначала
смотрела только на импорт модуля и молча проходила, когда отказ
заменяли на `void` — теперь она проверяет вызов бросающей обёртки.

Гейты: npm test 1918 tests, 1917 pass, 0 fail; typecheck зелёный;
check-docs зелёный (индекс скриншотов не задет); pytest без HA 378
passed, 3 skipped.

Issue: #455
User-Visible: no

scripts/assert-capture-env.mjs

@@ -0,0 +1,31 @@
+#!/usr/bin/env node
+/**
+ * Отказ до съёмки — для тех точек, где гейт нельзя встроить в сам скрипт (#455).
+ *
+ * `demo/docs/capture.mjs` править нельзя дёшево: его sha записан в индексе
+ * скриншотов документации, и `scripts/check-docs.mjs` сверяет их. Любая правка
+ * объявляет закоммиченный индекс устаревшим — то есть стоит пересъёмки всех
+ * картинок и визуальной приёмки владельца за проверку, которая ничего не
+ * рисует. Поэтому проверка живёт шагом раньше, в npm-скрипте:
+ *
+ *   "docs:capture": "node scripts/assert-capture-env.mjs docs && npm run build && node demo/docs/capture.mjs"
+ *
+ * У golden такой проблемы нет: там гейт стоит в `demo/golden/policy.mjs`,
+ * который исключён из корпуса отпечатка и уже вызывается из `run.mjs`.
+ *
+ *   node scripts/assert-capture-env.mjs <golden|docs> [--stage=capture|accept]
+ */
+import { assertCaptureEnvironment } from './capture-environment.mjs';
+
+const [kindArg] = process.argv.slice(2).filter((arg) => !arg.startsWith('--'));
+const stageArg = process.argv.find((arg) => arg.startsWith('--stage='));
+const kind = kindArg === 'docs' ? 'docs' : 'golden';
+const stage = stageArg?.slice('--stage='.length) === 'accept' ? 'accept' : 'capture';
+
+try {
+  const allowance = assertCaptureEnvironment({ kind, stage });
+  if (allowance) console.log(`Чужая среда разрешена осознанно: ${allowance}`);
+} catch (error) {
+  console.error(error.message);
+  process.exit(1);
+}