fix(v1): разблокировать сборку, починить жизненный цикл cron и закрыть каналы утечки

Сборка не собиралась: два контракта приёмки роняли её на корректном коде.

verify_api_namespace_contract искал возвращение legacy-пространства имён
через grep по '/hui' и находил router_test.go, который ПЕРЕЧИСЛЯЕТ этот
префикс, чтобы доказать отсутствие маршрута, и сам versions.sh, где строка
стоит в тексте проверки. Падение приходило шестым шагом из четырнадцати, до
резолва Hysteria. За ним прятался второй такой же: проверка транзакционности
импорта пиров брала файл от начала applyPeerImportEntry и до конца, захватывая
объявленные ниже ExistPeerName и UpdatePeerLastConnectionAt.

Обе проверки теперь смотрят на код, а не на упоминания: добавлены помощники
code_without_comments и code_mentions_in, а отсутствие legacy-маршрута
доказывает тест на таблице маршрутов собранного роутера.

Планировщик стал собственностью процесса. InitCron вызывался из runServer и
на каждом вызове создавал новый cron.New(), не сохраняя ссылку; cron.Stop()
не вызывался нигде. Смена RESET_TRAFFIC_CRON выполняла StopServer(), точка
входа крутила for { runServer() } — и каждая правка добавляла целый
дублирующий набор джоб, а старое расписание сброса продолжало работать.
Фиксированные джобы регистрируются один раз, расписание переносится на месте
по EntryID, HTTP-сервер не трогается. Добавлено штатное завершение по SIGTERM.

Выражение проверяется до записи в базу тем же парсером (cron.ParseStandard),
которым его разбирает планировщик: раньше невалидная строка сохранялась, API
отвечал успехом, а сброс трафика молча исчезал.

updateConfigs стал атомарным: полная проверка партии, одна транзакция,
применение к рантайму. Прежний тест ставил запрещённый ключ первым и не
смотрел в базу — поймать частичное применение он был неспособен.

Удалены четыре ключа таблицы config без единого потребителя: HYSTERIA2_ENABLE,
HYSTERIA2_CONFIG (второй источник истины, читался первым), HYSTERIA2_TRAFFIC_TIME
и HYSTERIA2_CONFIG_REMARK. Имя профиля в share URI выводится из имени пира.

Безопасность:
- bootstrap-пароль администратора больше не генерируется и не пишется в журнал,
  который отдаётся кнопкой выгрузки; отсутствие env — отказ старта;
- собственный журнал админки санитизируется наравне с чужим;
- golang-jwt/jwt v3 -> v5: GO-2025-3553 не имеет исправленной версии в v3 и
  достижима с неаутентифицированного запроса; набор алгоритмов подписи
  зафиксирован через WithValidMethods;
- удалён вход по несолёному SHA-224 из предыдущего поколения;
- убран modulo bias в util.RandomString — единственном генераторе секретов;
- пир установщика защищён во всех путях записи, а не только в импорте;
- удалена латентная паника в service.GetToken и недостижимая ветка GetAdminInfo,
  проверявшая меньше, чем middleware.

Toolchain: Go 1.21.13 -> 1.26.7, Node 20.19.0 (EOL) -> 24.20.0. На прежнем
графе govulncheck находил 21 вызываемую уязвимость, 17 из них в stdlib,
попадающей в production-бинарь. Сейчас — ноль. Добавлен обязательный шаг
проверки зависимостей (govulncheck + pnpm audit) с записью результата в
metadata пакета.
This commit is contained in:
2026-08-29 21:37:38 +05:00
parent 672d455467
commit b99be7d514
50 changed files with 3907 additions and 1622 deletions
+23 -6
View File
@@ -34,6 +34,8 @@ REQUIRED_CONTRACT_VARS=(
NODE_LINUX_X64_SHA256
PNPM_VERSION
HYSTERIA_CHANNEL
GOVULNCHECK_VERSION
PNPM_AUDIT_LEVEL
)
validate_sha256_value() {
@@ -99,6 +101,7 @@ load_versions_contract() {
export NODE_VERSION NODE_LINUX_X64_SHA256 PNPM_VERSION HYSTERIA_CHANNEL
export GO_REQUIRED BUN_REQUIRED NODE_REQUIRED PNPM_REQUIRED
export GO_ARCHIVE_SHA256 NODE_ARCHIVE_SHA256
export GOVULNCHECK_VERSION PNPM_AUDIT_LEVEL
}
# Ожидаемая контрольная сумма Bun зависит от выбранного артефакта: на CPU без
@@ -217,17 +220,31 @@ verify_api_namespace_contract() {
# Историческое имя допустимо только в docs/14-legacy-cleanup.md и в
# legacy-маркерах clean-host: там это имя чужого артефакта, а не наше.
#
# Список каталогов покрывает КАЖДЫЙ слой, который может собрать URL: раньше
# в нём не было apps/middleware, apps/cmd, apps/dao и apps/util, то есть
# ровно тех мест, где живут HTTP-логгер, точка входа сервера и helpers.
# Сканируются ТОЛЬКО runtime production sources и то, что уезжает в пакет.
# Файлы, задача которых — доказать отсутствие legacy-пространства, из скана
# исключены: они обязаны называть его по имени, иначе проверять нечего.
#
# Регрессия приёмки. Раньше исключений не было, а в список каталогов входили
# tools/build и orchestrator/test. Контракт ловил сам себя: grep возвращал
# apps/router/router_test.go (регрессионный тест на отсутствие маршрута) и
# этот самый файл, где строка '/hui' стоит в тексте проверки. Сборка падала
# на шаге versions contract — то есть добавление теста, закрепляющего
# очистку, гарантированно ломало сборку.
#
# Гарантия при этом не ослабла, а переехала на слой, где она сильнее: скан
# исходников доказывает отсутствие СТРОКИ, а TestRouterHasNoLegacyNamespace
# проверяет ТАБЛИЦУ МАРШРУТОВ собранного роутера. Поэтому существование
# этого теста тоже входит в контракт и проверяется ниже.
local legacy_hits
legacy_hits="$(grep -rlF '/hui' \
legacy_hits="$(grep -rlF --exclude='*_test.go' '/hui' \
apps/model apps/router apps/controller apps/service apps/middleware \
apps/cmd apps/dao apps/util apps/frontend/src \
orchestrator/src orchestrator/test package/templates \
tools/test tools/build 2>/dev/null || true)"
orchestrator/src package/templates tools/test 2>/dev/null || true)"
[ -z "$legacy_hits" ] \
|| fail "versions contract: legacy /hui namespace came back in: $legacy_hits"
grep -q 'func TestRouterHasNoLegacyNamespace' apps/router/router_test.go \
|| fail "versions contract: the legacy-namespace route test disappeared from apps/router/router_test.go"
}
verify_go_toolchain_contract() {