fix(rc5): harden frontend runtime and diagnostics

fix(installer): harden admin smoke and rollback cleanup
2026-09-08 05:22:06 +05:00 · 2026-09-07 22:39:30 +05:00
38 changed files with 1802 additions and 430 deletions
@@ -8,6 +8,39 @@

 ## [Unreleased]

+Runtime-разбор RC4 закрыл три дефекта панели и один связанный риск
+сопровождения. Набор знаков имени пира больше не хранится как сырой `@` внутри
+message format: общий frontend-контракт передаёт его в RU/EN-подсказку через
+named interpolation и сверяется с Go-константами. Builder после frozen install
+компилирует реальным `vue-i18n` каждую строку обоих словарей, перехватывая как
+исключения, так и compiler diagnostics в `console.error`; удалить этот gate и
+при этом получить `tests_gate=true` нельзя. Сам `vue-i18n` переведён с
+неподдерживаемой ветки 9.14.5 на поддерживаемую 11.4.10.
+
+Попутный аудит package manager устранил ложную декларацию security overrides:
+pnpm предупреждал, что больше не читает настройки из поля `pnpm` в
+`package.json`. Правила перенесены в `apps/frontend/pnpm-workspace.yaml`, то
+есть теперь не только сохранены в старом lock-файле, но и действительно
+участвуют в следующем разрешении графа.
+
+Dashboard использует `value` у `el-radio-button` вместо deprecated-семантики
+«`label` как значение», а общий frontend-контракт запрещает вернуть старый API
+в любом Vue-компоненте. ENV-redaction теперь имеет одно точное исключение для
+диагностического boolean `HY2XS_FORCE_PASSWORD_CHANGE`: корректное значение
+`true`/`false` видно в bundle, но другое значение либо совпадение по
+префиксу/суффиксу исключения не даёт, и пароли, токены, секреты Hysteria и
+credentials продолжают заменяться на `<redacted>`.
+
+По результатам runtime-проверки RC3 login smoke приведён к реальному HTTP
+контуру панели: positive и negative пробы используют один helper с wire-полем
+`pass`, явным `HY2XS-Installer/1.0` User-Agent и строгим разбором JSON envelope.
+Тесты теперь проходят через scanner middleware и отдельно доказывают отказ
+стандартного curl UA, успешный bootstrap-вход и `invalid_credentials` для
+случайного пароля. Rollback cleanup проверяет `ActiveState` после
+`reset-failed`: уже выгруженный юнит больше не создаёт ложное предупреждение о
+ручном восстановлении, а недоступный systemd и сохранившийся `failed` остаются
+ошибкой.
+
 Diagnostics больше не пишет root-артефакты в `/var/log/hy2xs`, которым владеет
 `hy2xs-admin`. Staging и архив перенесены в проверяемый через `lstat` каталог
 `/var/lib/hy2xs/diagnostics` (`root:root 0700`), имена создаются эксклюзивно,
@@ -771,6 +771,11 @@ hy2xs-orchestrator diagnostics collect \
 декодируется с заменой и не попадает в архив; вместо него записывается
 безопасная причина пропуска.

+`HY2XS_FORCE_PASSWORD_CHANGE` — диагностический boolean, поэтому его значение
+`true`/`false` сохраняется. Исключение точное и не распространяется на другие
+ключи с `PASSWORD`: начальный пароль администратора, `ADMIN_CON_PASS`, пароль
+obfs и остальные секреты по-прежнему заменяются на `<redacted>`.
+
 Архив создаётся в `/var/lib/hy2xs/diagnostics` с режимом `0600`. Этот каталог
 принадлежит `root:root`, имеет режим `0700` и отделён от
 `HY2XS_LOG_DIR`, которым владеет сервисный пользователь `hy2xs-admin`.
@@ -1008,17 +1013,18 @@ export GITHUB_TOKEN=<token>

 1. проверяет контракт `versions.env` (`verify_versions_contract`);
 2. прогоняет тесты и типы оркестратора (`bun test`, `tsc --noEmit`);
-3. прогоняет контрактные тесты панели (спрайт иконок, словари локализации, коды ошибок, атрибуция);
+3. прогоняет dependency-free контракты панели (спрайт иконок, совпадение словарей, коды ошибок, атрибуция и frontend/Go-контракты);
 4. определяет последнюю стабильную версию Hysteria, берёт ожидаемый SHA‑256 из upstream `hashes.txt` и сверяет с ним скачанный артефакт;
 5. проходит compatibility gate: реальный бинарник Hysteria должен принять канонический конфиг HY2XS для Gecko и для Salamander;
-6. собирает orchestrator, frontend и backend, проставляя версию админки из контракта;
-7. прогоняет `go vet` и `go test` для HY2XS admin;
-8. проверяет граф зависимостей на известные уязвимости (`govulncheck ./...` и `pnpm audit` по всему lock‑графу);
-9. формирует архив и прогоняет acceptance‑проверки.
+6. собирает standalone-бинарник orchestrator;
+7. устанавливает frontend lock-граф, runtime-компилирует каждое сообщение RU/EN реальным `vue-i18n`, затем проверяет типы и собирает frontend и backend, проставляя версию админки из контракта;
+8. прогоняет `go vet` и `go test` для HY2XS admin;
+9. проверяет граф зависимостей на известные уязвимости (`govulncheck ./...` и `pnpm audit` по всему lock‑графу);
+10. формирует архив и прогоняет acceptance‑проверки.

-Любой сбой на шагах 1–8 останавливает сборку до создания пакета.
+Любой сбой на шагах 1–9 останавливает сборку до создания пакета.

-Тесты и типы (шаги 2, 3 и 7) — такой же обязательный гейт, как проверка
+Тесты и типы (шаги 2, 3, 7 и 8) — такой же обязательный гейт, как проверка
 зависимостей: переменной, которая их отключает, не существует. Готовый пакет
 объявляет об этом полем `tests_gate=true` в `metadata/package.env`, и это
 утверждение опирается на фактический прогон, а не на намерение.
@@ -1028,6 +1034,14 @@ export GITHUB_TOKEN=<token>
 `bun test tools/test/frontend-sprite.test.ts tools/test/frontend-contract.test.ts`
 запускаются напрямую и tarball не создают.

+Runtime-проверка словарей требует установленного frontend lock-графа:
+
+```bash
+cd apps/frontend
+pnpm install --frozen-lockfile
+bun test test/i18n-runtime.test.ts
+```
+
 Переменные, управляющие выбором версии Hysteria:

 | Переменная | По умолчанию | Назначение |
@@ -18,6 +18,7 @@ import (
 	"github.com/gin-gonic/gin"
 	"hy2xs-admin/credential"
 	"hy2xs-admin/dao"
+	"hy2xs-admin/middleware"
 	"hy2xs-admin/model/constant"
 	"hy2xs-admin/model/dto"
 	"hy2xs-admin/model/entity"
@@ -460,6 +461,96 @@ func postLogin(t *testing.T, body any) (int, apiResult) {
 	return postLoginRaw(t, payload, false)
 }

+// postLoginThroughFilter воспроизводит реальную внешнюю дверь login API:
+// scanner filter выполняется раньше DTO и контроллера. Именно этой связки не
+// было в тестах до RC3, поэтому backend и smoke были зелёными по отдельности,
+// а настоящий installer получал 403 на стандартный curl User-Agent.
+func postLoginThroughFilter(t *testing.T, body any, userAgent string) (int, apiResult) {
+	t.Helper()
+	payload, err := json.Marshal(body)
+	if err != nil {
+		t.Fatalf("не удалось собрать тело запроса: %v", err)
+	}
+
+	gin.SetMode(gin.TestMode)
+	engine := gin.New()
+	engine.Use(gin.Recovery(), middleware.FilterHandler())
+	engine.POST("/api/auth/login", Login)
+
+	request := httptest.NewRequest(http.MethodPost, "/api/auth/login", bytes.NewReader(payload))
+	request.Header.Set("Content-Type", "application/json")
+	request.Header.Set("User-Agent", userAgent)
+	recorder := httptest.NewRecorder()
+	engine.ServeHTTP(recorder, request)
+
+	var result apiResult
+	if recorder.Body.Len() > 0 {
+		if err := json.Unmarshal(recorder.Body.Bytes(), &result); err != nil {
+			t.Fatalf("middleware вернул не JSON: %s", recorder.Body.String())
+		}
+	}
+	return recorder.Code, result
+}
+
+// Полный wire-path RC3: стандартный UA curl действительно блокируется, а
+// выделенный UA установщика проходит тот же middleware до authentication logic.
+func TestLoginWirePathRespectsScannerFilterAndInstallerUserAgent(t *testing.T) {
+	newAuthTestDB(t, "hy2xsadmin", "bootstrap-password")
+
+	status, blocked := postLoginThroughFilter(t, map[string]any{
+		"username": "hy2xsadmin",
+		"pass":     "bootstrap-password",
+	}, "curl/8.10.1")
+	if status != http.StatusForbidden || blocked.Code != http.StatusForbidden {
+		t.Fatalf("scanner-like curl не заблокирован: HTTP %d, ответ %+v", status, blocked)
+	}
+
+	status, accepted := postLoginThroughFilter(t, map[string]any{
+		"username": "hy2xsadmin",
+		"pass":     "bootstrap-password",
+	}, "HY2XS-Installer/1.0")
+	if status != http.StatusOK || accepted.Code != constant.CodeSuccess {
+		t.Fatalf("UA установщика не дошёл до успешного входа: HTTP %d, ответ %+v", status, accepted)
+	}
+	var issued struct {
+		AccessToken string `json:"accessToken"`
+	}
+	if err := json.Unmarshal(accepted.Data, &issued); err != nil || issued.AccessToken == "" {
+		t.Fatalf("успешная wire-проба не выдала токен: %s", string(accepted.Data))
+	}
+
+	_, rejected := postLoginThroughFilter(t, map[string]any{
+		"username": "hy2xsadmin",
+		"pass":     "wrong-password",
+	}, "HY2XS-Installer/1.0")
+	var invalidCredentials bool
+	for _, reason := range rejected.Errors {
+		invalidCredentials = invalidCredentials || reason.Code == constant.ErrCodeInvalidCredentials
+	}
+	if rejected.Code != constant.CodeSysError || !invalidCredentials {
+		t.Fatalf("negative wire-проба не дошла до auth logic: %+v", rejected)
+	}
+}
+
+// `password` не является скрытым alias: иначе orchestrator и frontend могли бы
+// незаметно разойтись по двум разным HTTP-контрактам.
+func TestLoginWirePathRejectsPasswordAlias(t *testing.T) {
+	newAuthTestDB(t, "hy2xsadmin", "bootstrap-password")
+
+	_, result := postLoginThroughFilter(t, map[string]any{
+		"username": "hy2xsadmin",
+		"password": "bootstrap-password",
+	}, "HY2XS-Installer/1.0")
+
+	var passRequired bool
+	for _, reason := range result.Errors {
+		passRequired = passRequired || (reason.Field == "pass" && reason.Code == constant.ErrCodeRequired)
+	}
+	if result.Code != constant.CodeInvalidError || !passRequired {
+		t.Fatalf("alias password не отклонён как отсутствие wire-поля pass: %+v", result)
+	}
+}
+
 // Регрессия RC2 целиком: вход bootstrap-учёткой обязан выдать токен.
 func TestLoginEndpointIssuesTokenForValidCredentials(t *testing.T) {
 	newAuthTestDB(t, "hy2xsadmin", "bootstrap-password")
@@ -19,5 +19,11 @@ Frontend собирается production builder'ом из [`tools/build`](../..

 ```sh
 pnpm install --frozen-lockfile
-pnpm run build:prod
+bun test test/i18n-runtime.test.ts
+pnpm run verify
 ```
+
+Runtime-тест обходит все строковые сообщения русского и английского словарей
+через установленный `vue-i18n`. Он проверяет не только исключения, но и
+compiler diagnostics в `console.error`: некоторые версии компилятора сообщают
+ошибку формата без исключения из `t()`.
@@ -28,7 +28,7 @@
    "qrcode.vue": "3.4.1",
    "vue": "^3.5.42",
    "vue-echarts": "^8.1.0",
-    "vue-i18n": "^9.14.5",
+    "vue-i18n": "^11.4.10",
    "vue-router": "^4.6.4"
  },
  "devDependencies": {
@@ -65,17 +65,6 @@
    "vue-eslint-parser": "10.4.1",
    "vue-tsc": "^3.3.11"
  },
-  "pnpm": {
-    "overrides": {
-      "lodash": ">=4.18.1",
-      "lodash-es": ">=4.18.1",
-      "brace-expansion": ">=1.1.18",
-      "picomatch": ">=2.3.2",
-      "js-yaml": ">=4.3.1",
-      "table>ajv": ">=8.18.0",
-      "browserslist": "4.28.7"
-    }
-  },
  "engines": {
    "node": "^20.19.0 || >=22.12.0"
  }
@@ -4,15 +4,6 @@ settings:
  autoInstallPeers: true
  excludeLinksFromLockfile: false

-overrides:
-  lodash: '>=4.18.1'
-  lodash-es: '>=4.18.1'
-  brace-expansion: '>=1.1.18'
-  picomatch: '>=2.3.2'
-  js-yaml: '>=4.3.1'
-  table>ajv: '>=8.18.0'
-  browserslist: 4.28.7
-
 importers:

  .:
@@ -54,8 +45,8 @@ importers:
        specifier: ^8.1.0
        version: 8.1.0(echarts@6.1.0)(vue@3.5.42(typescript@5.9.3))
      vue-i18n:
-        specifier: ^9.14.5
-        version: 9.14.5(vue@3.5.42(typescript@5.9.3))
+        specifier: ^11.4.10
+        version: 11.4.10(vue@3.5.42(typescript@5.9.3))
      vue-router:
        specifier: ^4.6.4
        version: 4.6.4(vue@3.5.42(typescript@5.9.3))
@@ -492,17 +483,21 @@ packages:
  '@iconify/utils@3.1.4':
    resolution: {integrity: sha512-b1S7B1k9ohZ+iNTi2ATxbRYG9fTrJmUT0rc46bvVnNxqNRGW7dyo/vRREwyniI5IRN2RSJHDcm+s3BjWrSAjHw==}

-  '@intlify/core-base@9.14.5':
-    resolution: {integrity: sha512-5ah5FqZG4pOoHjkvs8mjtv+gPKYU0zCISaYNjBNNqYiaITxW8ZtVih3GS/oTOqN8d9/mDLyrjD46GBApNxmlsA==}
-    engines: {node: '>= 16'}
+  '@intlify/core-base@11.4.10':
+    resolution: {integrity: sha512-+yJ74JRWVJokdgG9zYNMyTSzeNV3O9T4vVxk8PvLFHmI+R/BYA//cITh7vhRK37hWLZ4/kTcKcUz1dlWOpypIg==}
+    engines: {node: '>= 22'}

-  '@intlify/message-compiler@9.14.5':
-    resolution: {integrity: sha512-IHzgEu61/YIpQV5Pc3aRWScDcnFKWvQA9kigcINcCBXN8mbW+vk9SK+lDxA6STzKQsVJxUPg9ACC52pKKo3SVQ==}
-    engines: {node: '>= 16'}
+  '@intlify/devtools-types@11.4.10':
+    resolution: {integrity: sha512-xZxzZsAuu6/0zoLRVQWdpXWe5Kjl0LnWpjlQA3r9u9FbLYMhapqt7IwkgQyn0Tm2GUNAqhj9eZiUmYOrB024BQ==}
+    engines: {node: '>= 22'}

-  '@intlify/shared@9.14.5':
-    resolution: {integrity: sha512-9gB+E53BYuAEMhbCAxVgG38EZrk59sxBtv3jSizNL2hEWlgjBjAw1AwpLHtNaeda12pe6W20OGEa0TwuMSRbyQ==}
-    engines: {node: '>= 16'}
+  '@intlify/message-compiler@11.4.10':
+    resolution: {integrity: sha512-oUB/scz2EJENXDiUJ7JjZffOrH8UIZ1BuZeHvonbi5fWLavLt04aivuk2OIByOZA0tsci1bkeeQRmwhb5M8Imw==}
+    engines: {node: '>= 22'}
+
+  '@intlify/shared@11.4.10':
+    resolution: {integrity: sha512-FeImVdPeoSHTm3NBFFZHv0eRP9gQ3F4lj2puDBX5Kw7iiM1uJW6JTf39ian0K/17pbXCI3ef5i9RVsRrALqI6Q==}
+    engines: {node: '>= 22'}

  '@jridgewell/gen-mapping@0.3.13':
    resolution: {integrity: sha512-2kkt/7niJ6MgEPxF0bYdQ6etZaA+fQvDcLKckhy1yIQOzaoKjBBjSj63/aLVjYE3qhRt5dvM+uUyfCg6UKCBbA==}
@@ -1525,7 +1520,7 @@ packages:
    resolution: {integrity: sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==}
    engines: {node: '>=12.0.0'}
    peerDependencies:
-      picomatch: '>=2.3.2'
+      picomatch: ^3 || ^4
    peerDependenciesMeta:
      picomatch:
        optional: true
@@ -1789,8 +1784,8 @@ packages:
    resolution: {integrity: sha512-WK9qSozxXOD7ZJQlpSqOT+om2ZfcT4yO+03FuzAHD0wF6S0l0090LRPDx3vhTTLZ8cFKpBn+IOcVXK6qOcIlfQ==}
    peerDependencies:
      '@types/lodash-es': '*'
-      lodash: '>=4.18.1'
-      lodash-es: '>=4.18.1'
+      lodash: '*'
+      lodash-es: '*'

  lodash.truncate@4.4.2:
    resolution: {integrity: sha512-jttmRe7bRse52OsWIMDLaXxWqRAmtIUccAQ3garviCqJjafXOfNMO0yMfNpdD6zbGaTU0P5Nz7e7gAT6cKmJRw==}
@@ -1957,6 +1952,10 @@ packages:
  picocolors@1.1.1:
    resolution: {integrity: sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==}

+  picomatch@2.3.2:
+    resolution: {integrity: sha512-V7+vQEJ06Z+c5tSye8S+nHUfI51xoXIXjHQ99cQtKUkQqqO1kO/KCJUfZXuB47h/YBlDhah2H3hdUGXn8ie0oA==}
+    engines: {node: '>=8.6'}
+
  picomatch@4.0.7:
    resolution: {integrity: sha512-qcJu88Q2IWqJsDD529JKMdwGm/dvInW4HvQnRwiH9JtihJvzGOscDtHE3x1pBKeUOTysQ8kVmLnJ2kJu7yhcGA==}
    engines: {node: '>=12'}
@@ -2406,7 +2405,7 @@ packages:
    resolution: {integrity: sha512-UQ+MSxlhRm1bzjhU+DcuXfjFO1FzNtqhK5+9Yvlp90ItDLk5vT932A0rFu619nf7RVS+Y/VeaUW1jaRDqZ8VJw==}
    hasBin: true
    peerDependencies:
-      browserslist: 4.28.7
+      browserslist: '>= 4.21.0'

  uri-js@4.4.1:
    resolution: {integrity: sha512-7rKUyy33Q1yc98pQ1DAmLtwX109F7TIfWlW1Ydo8Wl1ii1SeHieeh0HHfPeL2fMXK6z0s8ecKs9frCuLJvndBg==}
@@ -2483,10 +2482,9 @@ packages:
    peerDependencies:
      eslint: ^8.57.0 || ^9.0.0 || ^10.0.0

-  vue-i18n@9.14.5:
-    resolution: {integrity: sha512-0jQ9Em3ymWngyiIkj0+c/k7WgaPO+TNzjKSNq9BvBQaKJECqn9cd9fL4tkDhB5G1QBskGl9YxxbDAhgbFtpe2g==}
-    engines: {node: '>= 16'}
-    deprecated: v9 and v10 no longer supported. please migrate to v11. about maintenance status, see https://vue-i18n.intlify.dev/guide/maintenance.html
+  vue-i18n@11.4.10:
+    resolution: {integrity: sha512-Lp+BjOxqzOY87DS6Z8KrQrpiTr9IN/Lt4kZEilwyXG2Wrx+AcU6IVsAW92HNXtVcn1HFFPV6ty41p9e/qDpyvg==}
+    engines: {node: '>= 22'}
    peerDependencies:
      vue: ^3.0.0

@@ -2782,17 +2780,23 @@ snapshots:
      '@iconify/types': 2.0.0
      import-meta-resolve: 4.2.0

-  '@intlify/core-base@9.14.5':
+  '@intlify/core-base@11.4.10':
    dependencies:
-      '@intlify/message-compiler': 9.14.5
-      '@intlify/shared': 9.14.5
+      '@intlify/devtools-types': 11.4.10
+      '@intlify/message-compiler': 11.4.10
+      '@intlify/shared': 11.4.10

-  '@intlify/message-compiler@9.14.5':
+  '@intlify/devtools-types@11.4.10':
    dependencies:
-      '@intlify/shared': 9.14.5
+      '@intlify/core-base': 11.4.10
+      '@intlify/shared': 11.4.10
+
+  '@intlify/message-compiler@11.4.10':
+    dependencies:
+      '@intlify/shared': 11.4.10
      source-map-js: 1.2.1

-  '@intlify/shared@9.14.5': {}
+  '@intlify/shared@11.4.10': {}

  '@jridgewell/gen-mapping@0.3.13':
    dependencies:
@@ -4113,7 +4117,7 @@ snapshots:
  micromatch@4.0.8:
    dependencies:
      braces: 3.0.3
-      picomatch: 4.0.7
+      picomatch: 2.3.2

  mime-db@1.52.0: {}

@@ -4245,6 +4249,8 @@ snapshots:

  picocolors@1.1.1: {}

+  picomatch@2.3.2: {}
+
  picomatch@4.0.7: {}

  pinia@2.3.1(typescript@5.9.3)(vue@3.5.42(typescript@5.9.3)):
@@ -4798,10 +4804,11 @@ snapshots:
    transitivePeerDependencies:
      - supports-color

-  vue-i18n@9.14.5(vue@3.5.42(typescript@5.9.3)):
+  vue-i18n@11.4.10(vue@3.5.42(typescript@5.9.3)):
    dependencies:
-      '@intlify/core-base': 9.14.5
-      '@intlify/shared': 9.14.5
+      '@intlify/core-base': 11.4.10
+      '@intlify/devtools-types': 11.4.10
+      '@intlify/shared': 11.4.10
      '@vue/devtools-api': 6.6.4
      vue: 3.5.42(typescript@5.9.3)

@@ -0,0 +1,13 @@
+# Настройки resolution принадлежат pnpm, а не npm package manifest.
+# Единственный workspace-проект — сам frontend.
+packages:
+  - "."
+
+overrides:
+  lodash: ">=4.18.1"
+  lodash-es: ">=4.18.1"
+  brace-expansion: ">=1.1.18"
+  picomatch: ">=2.3.2"
+  js-yaml: ">=4.3.1"
+  "table>ajv": ">=8.18.0"
+  browserslist: "4.28.7"
@@ -0,0 +1,29 @@
+/**
+ * Контракт имени пира на стороне панели.
+ *
+ * Сервер остаётся конечным авторитетом: эти значения зеркалят константы из
+ * apps/service/peer_import.go и сверяются с ними release-тестом. Общий модуль
+ * не даёт форме, сообщению об ошибке и подсказке завести разные копии правила.
+ */
+
+export const PEER_NAME_MIN_LENGTH = 6;
+export const PEER_NAME_MAX_LENGTH = 32;
+
+/** Набор знаков без букв и цифр — передаётся в i18n как значение. */
+export const PEER_NAME_PUNCTUATION = "!@#$%^&*()_+-=";
+
+/** Полный набор в том виде, в каком его показывают оператору. */
+export const PEER_NAME_CHARSET = `a-z A-Z 0-9 ${PEER_NAME_PUNCTUATION}`;
+
+/**
+ * Набор символов в записи регулярного выражения.
+ *
+ * Дефис экранирован намеренно: неэкранированное `+-=` становится диапазоном и
+ * принимает лишние знаки. Числовые границы берутся из тех же констант, что и
+ * тексты формы.
+ */
+const PEER_NAME_CHARACTER_CLASS = "a-zA-Z0-9!@#$%^&*()_+\\-=";
+
+export const PEER_NAME_PATTERN = new RegExp(
+  `^[${PEER_NAME_CHARACTER_CLASS}]{${PEER_NAME_MIN_LENGTH},${PEER_NAME_MAX_LENGTH}}$`
+);
@@ -60,7 +60,8 @@ export default {
    trafficApiUnreachable: "Unreachable",
    security: {
      hysteriaStopped: "Hysteria2 is stopped",
-      hysteriaStateUnknown: "Hysteria2 service state is unknown: systemd did not answer",
+      hysteriaStateUnknown:
+        "Hysteria2 service state is unknown: systemd did not answer",
      trafficApiUnavailable: "Traffic API is unavailable",
    },
    error: {
@@ -217,7 +218,7 @@ export default {
      // The character set is stated as service.IsValidPeerName accepts it. The
      // previous wording described the rule that was in force before EX-03.
      nameHint:
-        "Peer identifier: 6 to 32 characters — latin letters, digits and !@#$%^&*()_+-=. The name becomes part of the auto-generated secret and is shown to the client as the profile name.",
+        "Peer identifier: {min} to {max} characters — latin letters, digits and {punctuation}. The name becomes part of the auto-generated secret and is shown to the client as the profile name.",
      remarkPlaceholder: "laptop",
      remarkHint: "Optional operator note. It is never shown to the client.",
      secretPlaceholder: "leave empty to generate one",
@@ -240,7 +240,7 @@ export default {
      // действовавшего до EX-03: подсказка обещала более узкий набор, чем
      // сервер принимает, и оператор не имел причин пробовать остальные.
      nameHint:
-        "Идентификатор пира: от 6 до 32 символов — латиница, цифры и знаки !@#$%^&*()_+-=. Имя попадает в автогенерируемый секрет и показывается клиенту как название профиля.",
+        "Идентификатор пира: от {min} до {max} символов — латиница, цифры и знаки {punctuation}. Имя попадает в автогенерируемый секрет и показывается клиенту как название профиля.",
      remarkPlaceholder: "ноутбук",
      remarkHint: "Необязательная пометка для оператора. Клиент её не видит.",
      secretPlaceholder: "оставьте пустым — сгенерируем",
@@ -98,7 +98,9 @@
      <el-col :xs="24" :sm="12" :lg="6"
        ><el-card shadow="never"
          >{{ $t("dashboard.onlinePeers") }}:
-          {{ summary.hysteria.apiReachable ? summary.peers.onlinePeers : "?" }}</el-card
+          {{
+            summary.hysteria.apiReachable ? summary.peers.onlinePeers : "?"
+          }}</el-card
        ></el-col
      >
      <el-col :xs="24" :sm="12" :lg="6"
@@ -128,9 +130,9 @@
        <div class="chart-header">
          <span>{{ $t("dashboard.trafficChart") }}</span>
          <el-radio-group v-model="range" size="small" @change="loadDashboard">
-            <el-radio-button label="1h">1h</el-radio-button>
-            <el-radio-button label="24h">24h</el-radio-button>
-            <el-radio-button label="7d">7d</el-radio-button>
+            <el-radio-button value="1h">1h</el-radio-button>
+            <el-radio-button value="24h">24h</el-radio-button>
+            <el-radio-button value="7d">7d</el-radio-button>
          </el-radio-group>
        </div>
      </template>
@@ -247,7 +247,15 @@
            v-model="dataForm.name"
            :placeholder="$t('peer.form.namePlaceholder')"
          />
-          <div class="form-hint">{{ $t("peer.form.nameHint") }}</div>
+          <div class="form-hint">
+            {{
+              $t("peer.form.nameHint", {
+                min: PEER_NAME_MIN_LENGTH,
+                max: PEER_NAME_MAX_LENGTH,
+                punctuation: PEER_NAME_PUNCTUATION,
+              })
+            }}
+          </div>
        </el-form-item>
        <el-form-item :label="$t('peer.remark')" :error="serverErrors.remark">
          <el-input
@@ -445,6 +453,13 @@ import { UploadFile, UploadRawFile, UploadRequestOptions } from "element-plus";
 import { ERR_CODE, isApiError } from "@/utils/api-error";
 import { describeApiError, fieldErrorMap } from "@/utils/api-message";
 import { saveResponseAsFile } from "@/utils/download";
+import {
+  PEER_NAME_CHARSET,
+  PEER_NAME_MAX_LENGTH,
+  PEER_NAME_MIN_LENGTH,
+  PEER_NAME_PATTERN,
+  PEER_NAME_PUNCTUATION,
+} from "@/constants/peer";

 /**
 * Ограничение ширины всплывающих подсказок.
@@ -582,10 +597,6 @@ watch(
  }
 );

-// Зеркало серверного контракта, а не второй его экземпляр: границы и набор
-// символов заданы в service.IsValidPeerName и dto.PeerSaveDto, и расхождение
-// здесь приводит лишь к лишнему запросу, а не к принятому некорректному пиру.
-const PEER_NAME_PATTERN = /^[a-zA-Z0-9!@#$%^&*()_+\-=]{6,32}$/;
 const SECRET_MIN_LENGTH = 6;
 const SECRET_MAX_LENGTH = 128;

@@ -600,9 +611,9 @@ const rules = {
      pattern: PEER_NAME_PATTERN,
      message: t("error.code.peer_name", {
        field: t("error.field.name"),
-        min: 6,
-        max: 32,
-        charset: "a-z A-Z 0-9 !@#$%^&*()_+-=",
+        min: PEER_NAME_MIN_LENGTH,
+        max: PEER_NAME_MAX_LENGTH,
+        charset: PEER_NAME_CHARSET,
      }),
      trigger: ["change", "blur"],
    },
@@ -0,0 +1,109 @@
+import { describe, expect, test } from "bun:test";
+import { createI18n } from "vue-i18n";
+
+import {
+  PEER_NAME_MAX_LENGTH,
+  PEER_NAME_MIN_LENGTH,
+  PEER_NAME_PUNCTUATION,
+} from "../src/constants/peer";
+import en from "../src/lang/package/en";
+import ru from "../src/lang/package/ru";
+
+type Dictionary = Record<string, unknown>;
+
+function leafMessages(
+  value: unknown,
+  prefix = ""
+): Array<[key: string, message: string]> {
+  if (typeof value === "string") {
+    return [[prefix, value]];
+  }
+  if (!value || typeof value !== "object") {
+    return [];
+  }
+  return Object.entries(value as Dictionary).flatMap(([key, child]) =>
+    leafMessages(child, prefix ? `${prefix}.${key}` : key)
+  );
+}
+
+function interpolationValues(message: string): Record<string, string | number> {
+  const values: Record<string, string | number> = {
+    count: 2,
+    n: 2,
+    min: PEER_NAME_MIN_LENGTH,
+    max: PEER_NAME_MAX_LENGTH,
+    punctuation: PEER_NAME_PUNCTUATION,
+  };
+  for (const match of message.matchAll(/\{([A-Za-z_][A-Za-z0-9_$-]*)\}/g)) {
+    values[match[1]] ??= match[1];
+  }
+  return values;
+}
+
+for (const [locale, dictionary] of Object.entries({ ru, en }) as Array<
+  ["ru" | "en", Dictionary]
+>) {
+  describe(`runtime-компиляция локализации ${locale}`, () => {
+    test("каждое строковое сообщение компилируется без diagnostics", () => {
+      const compilerDiagnostics: string[] = [];
+      const thrown: string[] = [];
+      const originalConsoleError = console.error;
+
+      console.error = (...args: unknown[]) => {
+        compilerDiagnostics.push(args.map(String).join(" "));
+      };
+
+      try {
+        const i18n = createI18n({
+          legacy: false,
+          locale,
+          fallbackLocale: false,
+          missingWarn: false,
+          fallbackWarn: false,
+          messages: { [locale]: dictionary },
+        });
+
+        for (const [key, message] of leafMessages(dictionary)) {
+          try {
+            const translated = i18n.global.t(key, interpolationValues(message));
+            if (typeof translated !== "string") {
+              thrown.push(`${key}: результат не является строкой`);
+            }
+          } catch (error) {
+            thrown.push(
+              `${key}: ${error instanceof Error ? error.message : String(error)}`
+            );
+          }
+        }
+      } finally {
+        console.error = originalConsoleError;
+      }
+
+      expect(thrown).toEqual([]);
+      expect(compilerDiagnostics).toEqual([]);
+    });
+
+    test("набор знаков имени пира проходит интерполяцию как данные", () => {
+      const i18n = createI18n({
+        legacy: false,
+        locale,
+        fallbackLocale: false,
+        messages: { [locale]: dictionary },
+      });
+
+      const template = (dictionary as any).peer.form.nameHint as string;
+      expect(
+        i18n.global.t("peer.form.nameHint", {
+          min: PEER_NAME_MIN_LENGTH,
+          max: PEER_NAME_MAX_LENGTH,
+          punctuation: PEER_NAME_PUNCTUATION,
+        })
+      ).toBe(
+        template
+          .replace("{min}", String(PEER_NAME_MIN_LENGTH))
+          .replace("{max}", String(PEER_NAME_MAX_LENGTH))
+          .replace("{punctuation}", PEER_NAME_PUNCTUATION)
+      );
+    });
+  });
+}
@@ -0,0 +1,50 @@
+# Результаты runtime-проверки v1.0.0-rc3
+
+Дата проверки: 2026-09-07.
+
+RC3 проверялся на чистом Debian после успешной проверки целостности
+опубликованного артефакта. Hysteria, ACME, firewall, диагностика и основной
+authentication backend отработали штатно. Кандидат отклонён из-за несовместимости
+installer smoke с HTTP middleware и ложного отчёта rollback cleanup.
+
+## Сводка
+
+| ID              | Наблюдение                                                                                     | Итог                                                    |
+| --------------- | ---------------------------------------------------------------------------------------------- | ------------------------------------------------------- |
+| RC3-LOGIN-01    | стандартный `curl/<version>` получает HTTP 403 от scanner middleware                           | исправлено для RC4 явным UA установщика                 |
+| RC3-LOGIN-02    | запрос с полем `password` не проходит DTO: требуется `pass`                                    | ожидаемое поведение wire-контракта, добавлена регрессия |
+| RC3-LOGIN-03    | `{username, pass}` с неверным паролем доходит до auth logic и возвращает `invalid_credentials` | backend исправен                                        |
+| RC3-LOGIN-04    | positive и negative smoke имели две независимые curl-команды                                   | исправлено общим request helper'ом                      |
+| RC3-ROLLBACK-01 | `reset-failed` для уже выгруженного юнита создавал ложное `manual recovery may be required`    | исправлено проверкой postcondition                      |
+
+## Что доказала диагностика login
+
+Последовательность запросов отделила middleware, DTO и authentication logic:
+
+| Запрос                                   | Результат                                                |
+| ---------------------------------------- | -------------------------------------------------------- |
+| стандартный curl UA + `password`         | HTTP 403 до разбора тела                                 |
+| допустимый UA + `password`               | validation envelope: требуется поле `pass`               |
+| допустимый UA + `pass` и неверный пароль | operation envelope с `errors[].code=invalid_credentials` |
+
+Следовательно, паника старого `validateStr` не вернулась. Дефект RC3 находился
+между smoke-клиентом и scanner middleware, а не в проверке пароля.
+
+## Контракт RC4
+
+- positive и negative login используют один helper;
+- helper отправляет JSON `{username, pass}` и `User-Agent: HY2XS-Installer/1.0`;
+- success требует `code=20000` и непустой `data.accessToken`;
+- rejection требует `code=50000`, причину `invalid_credentials` внутри
+  `errors[]` и отсутствие выданного токена;
+- envelope разбирается как JSON, поэтому совпадение текста внутри `message` не
+  считается доказательством;
+- стандартный curl UA продолжает получать 403: scanner middleware в RC4 не
+  удаляется;
+- уже выгруженный systemd-юнит считается успешным конечным состоянием cleanup
+  только после наблюдения `LoadState` и `ActiveState`;
+- недоступный systemd или сохранившийся `ActiveState=failed` остаются настоящим
+  rollback failure.
+
+Пересмотр необходимости scanner middleware для loopback-only панели остаётся
+отдельной задачей после v1.0.0 и не расширяет change surface RC4.
@@ -26,6 +26,7 @@
 | --- | --- | --- | --- | --- |
 | 2026-09-01 | `1.0.0-rc1` | `a1f0db22` | build + host acceptance, Debian 13 | [RC ACCEPTED WITH RELEASE-REQUIRED UX FIXES](2026-09-01-v1.0.0-rc1-host-acceptance.md) |
 | 2026-09-04 | `1.0.0-rc2` | `82e5ca40` | clean install + runtime, Debian 13 | [RUNTIME REJECTED — вход в панель недоступен](2026-09-04-v1.0.0-rc2-runtime-findings.md) |
+| 2026-09-07 | `1.0.0-rc3` | `bf10810c` | clean install + failure rollback, Debian 13 | [RUNTIME REJECTED — installer smoke блокируется middleware](2026-09-07-v1.0.0-rc3-runtime-findings.md) |

 ## Открытые дефекты приёмки

@@ -33,6 +34,7 @@
 | --- | --- |
 | 2026-09-01, `1.0.0-rc1` | [UX-01…UX-05 и найденное сверх отчёта](2026-09-01-v1.0.0-rc1-ux-findings.md) |
 | 2026-09-04, `1.0.0-rc2` | [LOGIN-01…LOGIN-08](2026-09-04-v1.0.0-rc2-runtime-findings.md) — все закрыты |
+| 2026-09-07, `1.0.0-rc3` | [RC3-LOGIN-01…04, RC3-ROLLBACK-01](2026-09-07-v1.0.0-rc3-runtime-findings.md) — исправления подготовлены для RC4 |

 ## Разборы кода между прогонами

@@ -85,6 +85,12 @@
 сборку — vue-i18n молча отдаёт сам ключ, и оператор видит `error.code.min_length`
 вместо фразы.

+Совпадения ключей недостаточно: строки компилируются как Vue I18n message
+format только при переводе. Специальные символы (`@`, `$`, `{}`, `|`) нельзя
+вставлять в текст как произвольные данные. Динамический набор знаков передаётся
+через named interpolation, а builder переводит каждую leaf-строку RU/EN и
+считает ошибкой как исключение, так и compiler diagnostics в `console.error`.
+
 **Состояние сессии** сообщается кодами `unauthorized`, `session_expired`,
 `token_invalid`, `account_disabled` при `code = 50401`. Панель по ним
 показывает диалог и возвращает на форму входа.
@@ -132,6 +138,11 @@
 продукт: в таблицу пиров ведут две двери, и они не имеют права требовать
 разного.

+Frontend-зеркало границ, regex и человекочитаемого набора находится в одном
+модуле `constants/peer.ts` и сверяется с Go-контрактом тестом. Пунктуация
+`!@#$%^&*()_+-=` попадает в подсказку как значение `{punctuation}`, а не как
+часть синтаксиса message format.
+
 ---

 ## 4. Таблицы журнала
@@ -136,7 +136,7 @@ Bun обновляется отдельно от остальных: оркес
 полного прохода `bun test → tsc → compile → приёмка на Debian`, а не строки в
 общем патче.

-### Проверка типов frontend — обязательный шаг релиза
+### Runtime-компиляция локализации и типы frontend — обязательные шаги релиза

 ```text
 pnpm run typecheck   → vue-tsc --noEmit   → ОБЯЗАН пройти
@@ -144,9 +144,13 @@ pnpm run build:prod  → vite build
 pnpm run verify      → typecheck, затем build
 ```

-`bundle_ui()` запускает `typecheck` **до** сборки bundle: собирать production
-bundle из кода, который не проходит проверку типов, незачем. Порядок и сам факт
-наличия шага проверяются приёмкой.
+После `pnpm install --frozen-lockfile` функция `bundle_ui()` сначала запускает
+`bun test test/i18n-runtime.test.ts`, затем `typecheck` и только потом сборку
+bundle. Словари заданы TypeScript-объектами, поэтому Vite и `vue-tsc` не
+компилируют message format и не ловят специальные символы `@`, `$`, `{}`, `|`.
+Runtime-gate использует реальный `vue-i18n` из lock-графа, обходит все строки
+RU/EN и перехватывает также `console.error`: один лишь `try/catch` недостаточен,
+поскольку компилятор может сообщить об ошибке без исключения из `t()`.

 До v1 этой гарантии не было. `build:prod` означал `vite build && vue-tsc
 --noEmit`, но `vue-tsc` был версии `0.35.0` (2022 год) и шаблоны Vue
@@ -222,7 +226,9 @@ bundle из кода, который не проходит проверку ти

 Уязвимость обычно приходит не из прямой зависимости, а из чужого поддерева, и
 поднимать ради неё весь frontend-граф не нужно. Такие случаи закрываются
-списком `pnpm.overrides` в `apps/frontend/package.json`:
+списком `overrides` в `apps/frontend/pnpm-workspace.yaml`. Настройки pnpm не
+хранятся в поле `pnpm` package manifest: современные версии его игнорируют, и
+правило осталось бы только случайно замороженным в старом lock-файле.

 | override | зачем |
 | --- | --- |
@@ -253,14 +259,15 @@ bundle из кода, который не проходит проверку ти
 | Шаг сборки | Что запускается |
 | --- | --- |
 | `run_orchestrator_tests` | `bun x tsc --noEmit`, `bun test` |
-| `bundle_ui` | `pnpm run typecheck` (`vue-tsc --noEmit`) до сборки bundle |
+| `run_frontend_tests` | dependency-free контракты панели |
+| `bundle_ui` | frozen install → runtime-компиляция всех RU/EN-сообщений → `pnpm run typecheck` → production bundle |
 | `run_admin_tests` | `go vet ./...`, `go test ./...` |

 Готовый пакет объявляет об этом полем `tests_gate=true` в
 `metadata/package.env` — так же, как `dependency_security_gate` и
 `hysteria_compat_gate`. Значение у поля ровно одно, потому что не бывает
-пакета, собранного с пропущенными тестами: обе функции прогона выставляют свой
-флаг **после** успешного завершения, а `write_metadata` отказывается писать
+пакета, собранного с пропущенными тестами: функции прогона выставляют свои
+флаги **после** успешного завершения, а `write_metadata` отказывается писать
 метаданные, если хотя бы один из них не выставлен. То есть поле остаётся
 утверждением о результате, а не переключателем.

@@ -75,11 +75,12 @@ sudo -u hy2xs-admin test ! -r /etc/hy2xs/hy2xs.env
 одной из своих стадий. Поэтому в журнале нужно читать две разные вещи:

 | Строка в журнале                                                                          | Что она означает                                                                                                        |
-| --- | --- |
+| ----------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
 | `failed to persist failure state, continuing with the mandatory rollback`                 | маркер не обновился (обычно заполненный диск), но восстановление выполнено; после освобождения места запустить `doctor` |
 | `rollback stage "<имя>" failed, continuing with the remaining stages`                     | конкретная половина восстановления не отработала; остальные выполнены                                                   |
 | `rollback finished with N failed stage(s); manual recovery may be required`               | итог: перечисленные стадии требуют ручной проверки                                                                      |
 | `rollback completed: N stage(s) succeeded`                                                | восстановление отработало полностью                                                                                     |
+| `systemctl reset-failed <unit> exited with …, but the cleanup postcondition is satisfied` | юнит уже выгружен или не находится в `failed`; это допустимый идемпотентный cleanup, ручное восстановление не требуется |
 | `manual recovery data preserved at /run/hy2xs/rollback/<op>`                              | firewall восстановлен не полностью; прежние `nftables.conf` и `hy2xs.nft` лежат по этому пути                           |
 | `firewall rollback guard armed: … fires in 45s (timer accuracy 1s)`                       | guard взведён; с этого момента операция обязана снять его до фиксации успеха                                            |
 | `firewall rollback guard disarmed and proven inactive`                                    | guard снят, и это подтверждено состоянием юнитов и отсутствием маркера срабатывания                                     |
@@ -336,6 +337,7 @@ hy2xs-orchestrator redact-config --config /etc/hysteria/config.yaml --out /root/
 ```

 Инварианты:
+
 - команда не выводит исходные секреты в stdout;
 - требуется выбрать ровно один режим: `--in-place` или `--out <path>`;
 - `--format auto` пытается определить формат по имени файла, при неоднозначности используйте `--format env|yaml`;
@@ -344,6 +346,8 @@ hy2xs-orchestrator redact-config --config /etc/hysteria/config.yaml --out /root/
  редакцию, а результат остаётся валидным YAML;
 - в env-файлах секрет вырезается и из URL-значения, даже если имя ключа
  несекретное — например, `HY2_AUTH_URL` в `post-install.env`.
+- `HY2XS_FORCE_PASSWORD_CHANGE=true|false` сохраняется как диагностический
+  boolean; это точное исключение, остальные ключи с `PASSWORD` редактируются.

 Та же редакция применяется к diagnostics-бандлу
 (`hy2xs-orchestrator diagnostics collect`), который собирается автоматически при
@@ -357,4 +361,3 @@ hy2xs-orchestrator redact-config --config /etc/hysteria/config.yaml --out /root/
 При отказе **до** начала применения изменений (`fatal_pre_apply`) бандл не
 собирается: его сбор сам создал бы каталог в `/var/lib/hy2xs/diagnostics` на сервере,
 который мы обещали не трогать.
-
@@ -7,11 +7,13 @@
 ## Технологический стек оркестратора

 Оркестратор фиксируется как:
+
 - **Bun + TypeScript** по исходникам
 - локальная сборка builder layer'ом
 - поставка на target в виде **готового install-артефакта**

 Это означает:
+
 - на target нет `npm`, `pnpm`, `yarn` или `bun install`
 - на target нет transpile/build step
 - shell на target допустим только как thin wrapper entrypoint
@@ -19,6 +21,7 @@
 ## Главная роль оркестратора

 Оркестратор работает **только на target machine** и умеет:
+
 - выполнить read-only проверку чистоты хоста (`preflight-install`)
 - выполнить первичную установку (`install`)
 - выполнить явную реконфигурацию (`reconfigure --dry-run|--apply`)
@@ -42,6 +45,7 @@
 ## Предусловия

 Оркестратор рассчитан только на:
+
 - чистый Debian 13
 - root/sudo install context
 - один сервер
@@ -128,7 +132,7 @@ Guard умеет останавливать только то, что через
 универсального раннера в `lib/process.ts` нет — есть два явных набора:

 | Набор                                                                      | Guard                 | Назначение                                                            |
-| --- | --- | --- |
+| -------------------------------------------------------------------------- | --------------------- | --------------------------------------------------------------------- |
 | `runReadOnly`, `runReadOnlySecret`                                         | не трогает            | наблюдение за системой: `ss`, `systemctl is-active`, `curl`, `getent` |
 | `runMutating`, `runMutatingVisible`, `runMutatingHidden`, `runMutatingRaw` | спрашивает разрешение | всё, что может изменить хост                                          |

@@ -278,8 +282,8 @@ preflight-ошибка со словом `nftables` приводила к отк
 Второй инвариант — **стадии отката независимы**:

 | Команда       | Стадии                                                                                                    |
-| --- | --- |
-| `install` | firewall → stop services → disable services → reset failed services |
+| ------------- | --------------------------------------------------------------------------------------------------------- |
+| `install`     | firewall → stop services → disable services → reset failed `hysteria-server` → reset failed `hy2xs-admin` |
 | `reconfigure` | firewall → restore configuration                                                                          |

 Каждая стадия — это `systemctl`, `cp`, `rm -rf` или `nft`, то есть каждая умеет
@@ -294,6 +298,14 @@ preflight-ошибка со словом `nftables` приводила к отк
 ошибка операции: проблема внутри отката — это дополнительная информация о том,
 что осталось не восстановленным, а не замена диагноза.

+`reset-failed` для каждого сервиса является отдельной стадией и завершается
+проверкой `LoadState`/`ActiveState`. Ненулевой код команды допустим, если юнит
+уже выгружен (`not-found` + `inactive`): failed-состояния у него больше нет, а
+значит cleanup завершён. Текст `Unit … not loaded` намеренно не разбирается — он
+зависит от версии и локали systemd. Ошибка чтения состояния или сохранившийся
+`ActiveState=failed` остаются настоящим отказом и попадают в manual-recovery
+сводку.
+
 Команды внутри стадий **не глушат собственные ошибки**. Это правило обратно
 тому, что действовало раньше. Пока непрерывность держалась на `|| true` в каждой
 команде, стадия физически не могла сообщить, что восстановление не выполнилось:
@@ -368,7 +380,11 @@ reconfigure B → создание копии упало, ошибка скры
  "version": 1,
  "opId": "2026-08-30T10-00-00.000Z",
  "entries": [
-    { "path": "/etc/hysteria/config.yaml", "present": true, "stored": "etc_hysteria_config.yaml" },
+    {
+      "path": "/etc/hysteria/config.yaml",
+      "present": true,
+      "stored": "etc_hysteria_config.yaml"
+    },
    { "path": "/etc/nftables.d/hy2xs.nft", "present": false, "stored": null }
  ]
 }
@@ -424,7 +440,7 @@ preflight общий для `install`, `reconfigure` и `doctor`, инвариа
 Строгость управляется `HY2XS_PUBLIC_ENDPOINT_POLICY`:

 | Значение                | Поведение                                        |
-| --- | --- |
+| ----------------------- | ------------------------------------------------ |
 | `strict` (по умолчанию) | расхождение останавливает операцию               |
 | `warn`                  | печатается предупреждение, операция продолжается |
 | `off`                   | сравнение не выполняется                         |
@@ -436,6 +452,7 @@ preflight общий для `install`, `reconfigure` и `doctor`, инвариа
 ## Что приходит на target

 На target должен попадать уже готовый package, содержащий:
+
 - thin install entrypoint
 - compiled orchestrator artifact
 - bundled HY2XS admin
@@ -447,6 +464,7 @@ preflight общий для `install`, `reconfigure` и `doctor`, инвариа
 ## Логическая модульность

 Даже если на target приезжает один собранный артефакт, внутри исходников оркестратор должен быть разложен по шагам:
+
 - preflight
 - deps
 - filesystem
@@ -474,17 +492,20 @@ preflight общий для `install`, `reconfigure` и `doctor`, инвариа
 ## Модель поставки

 Рекомендуемая baseline-модель:
+
 - исходники оркестратора хранятся в `orchestrator/`
 - builder выполняет локальную сборку через Bun
 - в install package кладётся готовый артефакт, который запускается thin wrapper'ом

 Например:
+
 - `package/install.sh` — проверка контекста и вызов оркестратора
 - `package/orchestrator/hy2xs-orchestrator` — собранный артефакт

 ## Логирование и коды возврата

 Оркестратор должен:
+
 - печатать понятные step-based сообщения
 - завершаться ненулевым кодом при ошибке
 - не скрывать первичный источник падения
@@ -500,6 +521,7 @@ preflight общий для `install`, `reconfigure` и `doctor`, инвариа
 ## CLI baseline

 Команды:
+
 - `preflight-install --package-dir <path> [--config <source-env>]`
 - `install --package-dir <path> [--config <source-env>]`
 - `reconfigure --package-dir <path> --config /etc/hy2xs/hy2xs.env --dry-run`
@@ -513,6 +535,7 @@ PHASE 0 ничего не меняет.
 `--allow-partial-state` допустим только для `repair`.

 Инварианты:
+
 - только IPv4 bind/listen;
 - TLS modes: `acme | file | self_signed_dev`;
 - `trafficStats.secret` отдельный от `JWT_SECRET`;
@@ -646,7 +669,7 @@ EnvironmentFile дополнительно запрещает U+FEFF. Реали
 Поэтому smoke выполняет **настоящий вход** на `POST /api/auth/login`:

 | Проба                                                | Когда            | Что требуется                                                           |
-| --- | --- | --- |
+| ---------------------------------------------------- | ---------------- | ----------------------------------------------------------------------- |
 | настоящий логин + СЛУЧАЙНЫЙ пароль                   | всегда           | `code: 50000`, причина `invalid_credentials`, `accessToken` отсутствует |
 | bootstrap-учётные данные из `bootstrap-admin.secret` | только `install` | `code: 20000` и непустой `accessToken`                                  |

@@ -661,6 +684,16 @@ EnvironmentFile дополнительно запрещает U+FEFF. Реали
  `50000` (отказ операции, а не успех и не отказ валидации, который означал бы
  негодный запрос), доменная причина `invalid_credentials` и ОТСУТСТВИЕ
  `accessToken`;
+- **конверт разбирается как JSON**, а не ищется регулярным выражением в сыром
+  тексте. Подстрока `invalid_credentials` внутри `message` или сломанный JSON не
+  имеют права превратить неизвестный ответ в успешную проверку;
+- **обе пробы используют один request helper.** Wire-поле называется `pass`, а
+  не `password`; `Content-Type`, User-Agent и настройки curl не дублируются и не
+  могут разойтись между positive и negative ветками;
+- **smoke отправляет явный `HY2XS-Installer/1.0` User-Agent.** Стандартный
+  `curl/<version>` отклоняется действующим scanner middleware раньше DTO. UA
+  установщика называется своим именем, не имитирует браузер и при этом проходит
+  существующий фильтр;
 - **пароль отрицательной пробы генерируется**, а не записан литералом. Записанное
  в исходнике значение теоретически может оказаться настоящим паролем — и тогда
  проверка «неверные данные отвергаются» отчиталась бы об успешном входе. На
@@ -672,10 +705,10 @@ EnvironmentFile дополнительно запрещает U+FEFF. Реали
  объявила бы рабочую установку сломанной;
 - **токен требуется отдельно.** `code: 20000` без `accessToken` означал бы
  панель, которая пускает и не выдаёт сессию;
- **тело собирается `JSON.stringify`**, а не интерполяцией в строку: пароль
+- **тело общего helper'а собирается `JSON.stringify`**, а не интерполяцией в строку: пароль
  задаёт оператор, и кавычка в нём сломала бы сам запрос, а не панель — проверка
  объявила бы рабочую установку сломанной;
- **обе команды идут через `runReadOnlySecret`**: он не кладёт команду в текст
+- **общий helper идёт через `runReadOnlySecret`**: он не кладёт команду в текст
  ошибки, а команда несёт пароль администратора. Наружу отдаётся только код
  ответа: тело успешного входа содержит токен доступа, а текст ошибки уезжает в
  журнал установки и в diagnostics-бандл;
@@ -712,6 +745,7 @@ service-writable `HY2XS_LOG_DIR`. Родитель проверяется чер
 дерево.

 Редактируются:
+
 - поля с секретоподобным именем (`password`, `secret`, `token`, `apiKey`,
  `privateKey`, `authorization`, `cookie`, `bearer`, `signature`, …);
 - карты, где секретны все значения (`auth.userpass`, `acme.dns.config`);
@@ -144,6 +144,13 @@ anycast. Отсутствие A-записи фатально при любом
 - `HY2XS_FORCE_PASSWORD_CHANGE` в production baseline установлен в `false` (forced UX-flow пока не реализован);
 - после первичного seed перезапуски `hy2xs-admin` не должны переопределять пароль admin и `con_pass`.

+В санитизированной диагностике корректное значение `true`/`false` у
+`HY2XS_FORCE_PASSWORD_CHANGE` остаётся видимым: это boolean состояния, а не
+пароль. Исключение применяется только к точному имени ключа и допустимому
+boolean; неизвестное значение скрывается fail-closed.
+`HY2XS_ADMIN_INITIAL_PASSWORD`, `HY2XS_ADMIN_CON_PASS`, пароль obfs,
+traffic-stats secret и похожие ключи продолжают редактироваться.
+
 ### Учётные данные администратора проверяются при разборе окружения

 `HY2XS_ADMIN_USER` и `HY2XS_ADMIN_INITIAL_PASSWORD` — это значения, которые
@@ -18,9 +18,12 @@ cd apps && go vet ./... && go test ./...
 # Проверка типов и сборка frontend
 cd apps/frontend && pnpm install --frozen-lockfile && pnpm run verify

-# Контракты панели: спрайт иконок, словари локализации, коды ошибок, атрибуция
+# Dependency-free контракты панели
 bun test tools/test/frontend-sprite.test.ts tools/test/frontend-contract.test.ts

+# Runtime-компиляция всех RU/EN-сообщений реальным vue-i18n
+cd apps/frontend && bun test test/i18n-runtime.test.ts
+
 # Сверка среды разработки с versions.env (ничего не меняет)
 ./tools/dev/doctor.sh

@@ -36,9 +39,12 @@ HYSTERIA_BIN=/usr/local/bin/hysteria ./tools/test/e2e-hysteria.sh

 ## Почему контракты панели проверяет Bun, а не vitest

-Проверяемые модули (`SvgIcon/symbol.ts`, `constants/branding.ts`, словари
-локализации) намеренно чистые: ни Vite, ни DOM в них нет, поэтому их можно
-выполнить вне браузера уже закреплённым в `versions.env` Bun.
+Dependency-free модули (`SvgIcon/symbol.ts`, frontend constants и словари
+локализации) намеренно чистые: ни Vite, ни DOM в них нет. Отдельный
+`i18n-runtime.test.ts` запускается после `pnpm install`, потому что обязан
+использовать именно `vue-i18n` из frozen lock-графа. Он обходит каждую строку
+обоих словарей и считает отказом и исключение, и compiler diagnostics в
+`console.error`.

 Vitest с jsdom не вычисляет `currentColor` и визуальной корректности всё равно
 не доказал бы, зато привёл бы в граф `pnpm audit` — а его порог считается по
@@ -918,7 +918,8 @@ build tooling исполняется на build-машине и порождае
 | Шаг сборки | Что запускается |
 | --- | --- |
 | `run_orchestrator_tests` | `bun x tsc --noEmit`, `bun test` |
-| `bundle_ui` | `pnpm run typecheck` до сборки bundle |
+| `run_frontend_tests` | dependency-free контракты панели |
+| `bundle_ui` | после frozen install: `bun test test/i18n-runtime.test.ts`, затем `pnpm run typecheck` и bundle |
 | `run_admin_tests` | `go vet ./...`, `go test ./...` |

 Приёмка проверяет:
@@ -926,9 +927,13 @@ build tooling исполняется на build-машине и порождае
 - отключающей тесты переменной нет ни в одном модуле сборки, ни в README/docs
  (место для истории — `CHANGELOG.md`);
 - `metadata/package.env` содержит `tests_gate=true`;
+- общий frontend-флаг выставляется только после ранних контрактов и
+  runtime-компиляции всех сообщений RU/EN;
+- runtime-gate стоит между frozen install и typecheck/build, использует
+  `vue-i18n` из lock-графа и считает ошибкой compiler diagnostics;
 - утверждение о прогоне выставляется **после** самого прогона, а не до него;
- `write_metadata` отказывается писать метаданные, если хотя бы один из двух
-  прогонов не подтверждён.
+- `write_metadata` отказывается писать метаданные, если хотя бы одна из
+  обязательных групп проверок не подтверждена.

 ## A12. Приёмка проверяет код, а не упоминания

@@ -5,6 +5,7 @@
 ## B. Target install tests

 ### На чистом Debian 13 проверяем
+
 1. пакет запускается без ручной сборки на сервере
 2. Hysteria2 скачивается с official upstream
 3. bundled HY2XS admin раскладывается локально из пакета
@@ -55,8 +56,8 @@
 35. **оператор входит в панель**: `POST /api/auth/login` с bootstrap-учётными данными из `/etc/hy2xs/bootstrap-admin.secret` отвечает `code: 20000` и непустым `accessToken`. Заведомо неверные учётные данные (со СЛУЧАЙНЫМ паролем, а не с литералом) дают HTTP 200 с конвертом отказа: `code: 50000`, причина `invalid_credentials` и отсутствие `accessToken`
 36. пароль предельной длины, назначенный формой смены пароля, принимается формой входа: границы обеих форм совпадают с серверными. Границ **две** — 6-64 символа Unicode и не более 72 байт в UTF-8 (предел bcrypt): пароль из 36 кириллических букв (72 байта) принимается, из 37 (74 байта) — отвергается конвертом валидации, а не системной ошибкой
 37. `HY2XS_ADMIN_INITIAL_PASSWORD` с пробелом по краям доезжает до учётной записи неизменным: значение записано в `hy2xs.env` в двойных кавычках, и вход выполняется ровно им, а не обрезанным
-37a. `HY2XS_ADMIN_INITIAL_PASSWORD` со значением вне документированного домена systemd (`U+FEFF`, `U+FDD0`, `U+FFFF`) или файл с байтами `0xFF`, оборванной `0xC3`, `ED A0 80` **роняет `preflight-install`** — отказ приходит до первой мутации хоста; сервер остаётся нетронутым
-37b. API входа и импорта отвергает повреждённый UTF-8 и непарные UTF-16 surrogate escape до `encoding/json`; настоящий U+FFFD работает как обычный символ
+    37a. `HY2XS_ADMIN_INITIAL_PASSWORD` со значением вне документированного домена systemd (`U+FEFF`, `U+FDD0`, `U+FFFF`) или файл с байтами `0xFF`, оборванной `0xC3`, `ED A0 80` **роняет `preflight-install`** — отказ приходит до первой мутации хоста; сервер остаётся нетронутым
+    37b. API входа и импорта отвергает повреждённый UTF-8 и непарные UTF-16 surrogate escape до `encoding/json`; настоящий U+FFFD работает как обычный символ
 38. `last_login_at` администратора обновляется после успешного входа и не меняется после неудачной попытки

 ## C0. Панель обязана впускать, а не слушать порт
@@ -93,6 +94,7 @@ BOOTSTRAP_PASS="$(read_bootstrap_field ADMIN_INITIAL_PASSWORD)"

 # Положительная проба: конверт успеха и выданный токен.
 curl -sS --max-time 5 -X POST \
+  --user-agent 'HY2XS-Installer/1.0' \
  -H 'Content-Type: application/json' \
  --data "$(jq -nc --arg u "$BOOTSTRAP_USER" --arg p "$BOOTSTRAP_PASS" '{username:$u,pass:$p}')" \
  http://127.0.0.1:8080/api/auth/login | jq '.code, (.data.accessToken | length)'
@@ -100,6 +102,7 @@ curl -sS --max-time 5 -X POST \
 # Отрицательная проба: пароль СЛУЧАЙНЫЙ, а проверяется конверт отказа целиком.
 # HTTP 200 сам по себе ничего не доказывает — админка отвечает 200 и на успех.
 curl -sS --max-time 5 -X POST \
+  --user-agent 'HY2XS-Installer/1.0' \
  -H 'Content-Type: application/json' \
  --data "$(jq -nc --arg u "$BOOTSTRAP_USER" --arg p "$(head -c 18 /dev/urandom | base64)" '{username:$u,pass:$p}')" \
  http://127.0.0.1:8080/api/auth/login \
@@ -110,7 +113,9 @@ unset BOOTSTRAP_PASS
 ```

 Ожидается `20000` и ненулевая длина токена. Сам токен не печатается: это
-действующая сессия администратора.
+действующая сессия администратора. Явный User-Agent обязателен: стандартный
+`curl/<version>` осознанно отклоняется scanner middleware с HTTP 403 ещё до
+разбора JSON. Значение совпадает с production smoke и не маскируется под браузер.

 ## C1. Семантический smoke конфига

@@ -1,17 +1,22 @@
 import type { InstallContext, InstallOptions } from "../types/context";
 import { fileExists, readText, writeTextAtomic } from "../lib/fs";
 import { runMutatingVisible } from "../lib/process";
+import { resetFailedUnit } from "../lib/systemd";
 import { info, setOperationContext, step, stepDone } from "../lib/log";
 import { readPackageValue } from "../lib/packageMeta";
 import { REPAIR_HINT, buildInstallStateRecord } from "../lib/installState";
 import { persistInstallState } from "../lib/installStateWriter";
-import { persistFailureState, runRollbackStages, type RollbackStage } from "../lib/rollback";
+import {
+  persistFailureState,
+  runRollbackStages,
+  type RollbackStage,
+} from "../lib/rollback";
 import { parseRuntimeEnv, renderRuntimeEnv } from "../config/env";
 import {
  ORCHESTRATOR_INSTALL_DIR,
  ORCHESTRATOR_INSTALL_PATH,
  ORCHESTRATOR_SYMLINK_PATH,
-  RUNTIME_PACKAGE_DIR
+  RUNTIME_PACKAGE_DIR,
 } from "../config/profile";
 import { preflight } from "../steps/preflight";
 import { bootstrapRuntime } from "../steps/bootstrap";
@@ -27,7 +32,7 @@ import {
  cleanupFirewallRollback,
  disarmFirewallRollback,
  operationKeyFor,
-  rollbackFirewallNow
+  rollbackFirewallNow,
 } from "../steps/firewall";
 import { ensureBootstrapAdminSecret, writePostInstallEnv } from "../steps/env";
 import { smoke } from "../steps/smoke";
@@ -125,7 +130,7 @@ function newOwnership(): OperationOwnership {
    firewallTouched: false,
    postInstallTouched: false,
    bootstrapSecretTouched: false,
-    servicesStarted: false
+    servicesStarted: false,
  };
 }

@@ -146,14 +151,14 @@ function installOwnedPaths(context: InstallContext): string[] {
    ORCHESTRATOR_INSTALL_DIR,
    ORCHESTRATOR_INSTALL_PATH,
    ORCHESTRATOR_SYMLINK_PATH,
-    RUNTIME_PACKAGE_DIR
+    RUNTIME_PACKAGE_DIR,
  ];
 }

 async function writeInstallState(
  context: InstallContext,
  phase: InstallPhase,
-  lastError: string
+  lastError: string,
 ): Promise<void> {
  const record = buildInstallStateRecord({
    productVersion: context.packageVersion,
@@ -168,7 +173,7 @@ async function writeInstallState(
    installed: phase === "installed",
    ownedPaths: installOwnedPaths(context),
    lastError,
-    repairHint: phase === "installed" ? undefined : REPAIR_HINT
+    repairHint: phase === "installed" ? undefined : REPAIR_HINT,
  });

  await persistInstallState(record);
@@ -178,7 +183,7 @@ async function advanceInstallState(
  context: InstallContext,
  ownership: OperationOwnership,
  phase: InstallPhase,
-  lastError = ""
+  lastError = "",
 ): Promise<void> {
  // Флаг взводится ПЕРЕД записью, а не после неё: см. комментарий к
  // stateTouched. Частично выполненная запись маркера — это уже изменение
@@ -211,7 +216,7 @@ async function advanceInstallState(
 export function classifyFailure(
  ownership: OperationOwnership,
  phase: InstallPhase,
-  error?: unknown
+  error?: unknown,
 ): FailureKind {
  if (error instanceof FirewallGuardFiredError) {
    return "firewall_guard_fired";
@@ -256,10 +261,12 @@ export function classifyFailure(
 async function rollbackFailedInstall(
  context: InstallContext,
  ownership: OperationOwnership,
-  failureKind: FailureKind
+  failureKind: FailureKind,
 ): Promise<void> {
  if (failureKind === "fatal_pre_apply") {
-    info("pre-apply failure: nothing was applied, system rollback is not required");
+    info(
+      "pre-apply failure: nothing was applied, system rollback is not required",
+    );
    return;
  }

@@ -275,7 +282,7 @@ async function rollbackFailedInstall(
      name: "firewall",
      run: async () => {
        await rollbackFirewallNow(context);
-      }
+      },
    });
  }

@@ -295,23 +302,31 @@ async function rollbackFailedInstall(
        name: "stop services",
        run: async () => {
          await runMutatingVisible`systemctl stop hysteria-server hy2xs-admin`;
-        }
+        },
      },
      {
        name: "disable services",
        run: async () => {
          await runMutatingVisible`systemctl disable hysteria-server hy2xs-admin`;
-        }
+        },
      },
      {
-        name: "reset failed services",
+        name: "reset failed hysteria-server",
        run: async () => {
-          await runMutatingVisible`systemctl reset-failed hysteria-server hy2xs-admin`;
-        }
-      }
+          await resetFailedUnit("hysteria-server");
+        },
+      },
+      {
+        name: "reset failed hy2xs-admin",
+        run: async () => {
+          await resetFailedUnit("hy2xs-admin");
+        },
+      },
    );
  } else {
-    info("rollback: systemd units were not deployed by this operation, leaving services untouched");
+    info(
+      "rollback: systemd units were not deployed by this operation, leaving services untouched",
+    );
  }

  await runRollbackStages(stages);
@@ -319,11 +334,15 @@ async function rollbackFailedInstall(

 export async function install(options: InstallOptions): Promise<void> {
  setOperationContext(`install-${Date.now().toString(36)}`);
-  const hasSourceConfig = options.sourceConfigPath ? await fileExists(options.sourceConfigPath) : false;
+  const hasSourceConfig = options.sourceConfigPath
+    ? await fileExists(options.sourceConfigPath)
+    : false;
  if (options.sourceConfigPath && !hasSourceConfig) {
    throw new Error(`config source not found: ${options.sourceConfigPath}`);
  }
-  const sourceConfigPath = hasSourceConfig ? options.sourceConfigPath : `${options.packageDir}/config/hy2xs.env`;
+  const sourceConfigPath = hasSourceConfig
+    ? options.sourceConfigPath
+    : `${options.packageDir}/config/hy2xs.env`;
  const sourceConfigRaw = await readText(sourceConfigPath);
  const config = parseRuntimeEnv(sourceConfigRaw);

@@ -331,18 +350,48 @@ export async function install(options: InstallOptions): Promise<void> {
    mode: "install",
    options,
    config,
-    packageVersion: await readPackageValue(options.packageDir, "package.version", "unknown"),
-    packageBuildId: await readPackageValue(options.packageDir, "package.build_id", "unknown"),
+    packageVersion: await readPackageValue(
+      options.packageDir,
+      "package.version",
+      "unknown",
+    ),
+    packageBuildId: await readPackageValue(
+      options.packageDir,
+      "package.build_id",
+      "unknown",
+    ),
    installDate: new Date().toISOString(),
    hysteriaVersion: "unknown",
-    hysteriaResolution: await readPackageValue(options.packageDir, "hysteria.resolution", "unknown"),
-    hysteriaTargetVersion: await readPackageValue(options.packageDir, "hysteria.version", ""),
-    hysteriaArtifactUrl: await readPackageValue(options.packageDir, "hysteria.url", ""),
-    hysteriaArtifactSha256: await readPackageValue(options.packageDir, "hysteria.sha256", "")
+    hysteriaResolution: await readPackageValue(
+      options.packageDir,
+      "hysteria.resolution",
+      "unknown",
+    ),
+    hysteriaTargetVersion: await readPackageValue(
+      options.packageDir,
+      "hysteria.version",
+      "",
+    ),
+    hysteriaArtifactUrl: await readPackageValue(
+      options.packageDir,
+      "hysteria.url",
+      "",
+    ),
+    hysteriaArtifactSha256: await readPackageValue(
+      options.packageDir,
+      "hysteria.sha256",
+      "",
+    ),
  };

-  if (!context.hysteriaTargetVersion || !context.hysteriaArtifactUrl || !context.hysteriaArtifactSha256) {
-    throw new Error("missing Hysteria lock metadata in package: hysteria.version/hysteria.url/hysteria.sha256");
+  if (
+    !context.hysteriaTargetVersion ||
+    !context.hysteriaArtifactUrl ||
+    !context.hysteriaArtifactSha256
+  ) {
+    throw new Error(
+      "missing Hysteria lock metadata in package: hysteria.version/hysteria.url/hysteria.sha256",
+    );
  }

  const ownership = newOwnership();
@@ -356,7 +405,10 @@ export async function install(options: InstallOptions): Promise<void> {
    // Всё, что дальше, уже создаёт наши собственные пути, и повторная проверка
    // опознала бы их как чужую установку.
    step("preflight");
-    await preflight(context, { requireCapabilities: false, checkCleanHost: true });
+    await preflight(context, {
+      requireCapabilities: false,
+      checkCleanHost: true,
+    });
    stepDone("preflight");

    await advanceInstallState(context, ownership, "preflight_ok");
@@ -372,7 +424,10 @@ export async function install(options: InstallOptions): Promise<void> {
    await installDeps(context);
    stepDone("system dependencies");
    step("preflight capabilities");
-    await preflight(context, { requireCapabilities: true, checkCleanHost: false });
+    await preflight(context, {
+      requireCapabilities: true,
+      checkCleanHost: false,
+    });
    stepDone("preflight capabilities");
    await advanceInstallState(context, ownership, "deps_ok");
    phase = "deps_ok";
@@ -387,7 +442,7 @@ export async function install(options: InstallOptions): Promise<void> {
    await writeTextAtomic(options.runtimeConfigPath, renderRuntimeEnv(config), {
      mode: 0o600,
      owner: "root",
-      group: "root"
+      group: "root",
    });
    stepDone("write runtime env");
    await advanceInstallState(context, ownership, "runtime_env_written");
@@ -468,8 +523,13 @@ export async function install(options: InstallOptions): Promise<void> {
    try {
      await cleanupFirewallRollback(context);
    } catch (cleanupError) {
-      const cleanupMessage = cleanupError instanceof Error ? cleanupError.message : String(cleanupError);
-      info(`firewall rollback data cleanup failed after a successful install: ${cleanupMessage}`);
+      const cleanupMessage =
+        cleanupError instanceof Error
+          ? cleanupError.message
+          : String(cleanupError);
+      info(
+        `firewall rollback data cleanup failed after a successful install: ${cleanupMessage}`,
+      );
    }
  } catch (error) {
    const message = error instanceof Error ? error.message : String(error);
@@ -498,7 +558,12 @@ export async function install(options: InstallOptions): Promise<void> {
          : "failed";

    await persistFailureState(() =>
-      advanceInstallState(context, ownership, failurePhase, `${failureKind}: ${message}`)
+      advanceInstallState(
+        context,
+        ownership,
+        failurePhase,
+        `${failureKind}: ${message}`,
+      ),
    );

    // Диагностика — best effort, откат — обязателен.
@@ -512,8 +577,12 @@ export async function install(options: InstallOptions): Promise<void> {
      await diagnosticsCollect(options);
    } catch (diagnosticsError) {
      const diagnosticsMessage =
-        diagnosticsError instanceof Error ? diagnosticsError.message : String(diagnosticsError);
-      info(`diagnostics collection failed, continuing with rollback: ${diagnosticsMessage}`);
+        diagnosticsError instanceof Error
+          ? diagnosticsError.message
+          : String(diagnosticsError);
+      info(
+        `diagnostics collection failed, continuing with rollback: ${diagnosticsMessage}`,
+      );
    }

    await rollbackFailedInstall(context, ownership, failureKind);
@@ -12,6 +12,17 @@

 export const REDACTED = "<redacted>";

+/**
+ * ENV-флаги, чьи имена похожи на секрет, но значения являются диагностически
+ * полезным публичным состоянием. Исключения здесь только точные: общий
+ * детектор секретов нельзя ослаблять совпадением по префиксу или суффиксу.
+ */
+const NON_SECRET_ENV_KEYS = new Set(["HY2XS_FORCE_PASSWORD_CHANGE"]);
+
+/** Сохранённый контракт прежнего ENV-детектора, но применённый после разбора key. */
+const ENV_SECRET_KEY_PATTERN =
+  /(PASSWORD|PASSWD|PASSPHRASE|PASS|SECRET|TOKEN|CREDENTIAL|APIKEY|AUTHORIZATION|COOKIE|BEARER|SIGNATURE)/;
+
 /**
 * Маркеры имён полей. Список покрывает известные секреты HY2XS/Hysteria и
 * типовые имена, под которыми секрет может появиться в будущем upstream-поле.
@@ -36,11 +47,14 @@ export const SECRET_KEY_MARKERS: readonly string[] = [
  "authorization",
  "cookie",
  "bearer",
-  "signature"
+  "signature",
 ];

 /** Узлы, где секретом являются все значения карты, а не имя ключа. */
-const SECRET_MAP_PATHS: readonly string[] = ["auth.userpass", "acme.dns.config"];
+const SECRET_MAP_PATHS: readonly string[] = [
+  "auth.userpass",
+  "acme.dns.config",
+];

 export function isSecretKey(key: string): boolean {
  const lowered = key.toLowerCase();
@@ -92,7 +106,9 @@ function redactValueDeep(value: unknown): unknown {
  }
  if (value && typeof value === "object") {
    const out: Record<string, unknown> = {};
-    for (const [key, child] of Object.entries(value as Record<string, unknown>)) {
+    for (const [key, child] of Object.entries(
+      value as Record<string, unknown>
+    )) {
      out[key] = redactValueDeep(child);
    }
    return out;
@@ -138,8 +154,15 @@ function redactNode(value: unknown, path: readonly string[]): unknown {

 export function redactKeyValueSecrets(content: string): string {
  return content.replace(
-    /^([A-Z0-9_]*(PASSWORD|PASSWD|PASSPHRASE|PASS|SECRET|TOKEN|CREDENTIAL|APIKEY|AUTHORIZATION|COOKIE|BEARER|SIGNATURE)[A-Z0-9_]*=).*$/gm,
-    `$1${REDACTED}`
+    /^([A-Z0-9_]+)=(.*?)(\r?)$/gm,
+    (line, key: string, value: string, eol: string) => {
+      const isKnownBoolean =
+        NON_SECRET_ENV_KEYS.has(key) && /^(?:true|false)$/.test(value);
+      if (isKnownBoolean || !ENV_SECRET_KEY_PATTERN.test(key)) {
+        return line;
+      }
+      return `${key}=${REDACTED}${eol}`;
+    }
  );
 }

@@ -207,7 +230,10 @@ export function redactLogText(content: string): string {
    LOG_SECRET_ASSIGNMENT_PATTERN,
    (match, key: string, separator: string, rawValue: string) => {
      const [value, trailing] = splitTrailingPunctuation(rawValue);
-      if (value === REDACTED || value.toLowerCase() === ENCODED_REDACTED.toLowerCase()) {
+      if (
+        value === REDACTED ||
+        value.toLowerCase() === ENCODED_REDACTED.toLowerCase()
+      ) {
        return match;
      }
      const rendered = separator === ":" ? ": " : "=";
@@ -0,0 +1,89 @@
+import { info } from "./log";
+import {
+  runMutatingStatus,
+  runReadOnlyArgvStatus,
+  type MutationResult,
+} from "./process";
+
+export type ResetFailedDependencies = {
+  reset: (unit: string) => Promise<MutationResult>;
+  inspect: (unit: string) => Promise<MutationResult>;
+};
+
+const productionDependencies: ResetFailedDependencies = {
+  reset: async (unit) => runMutatingStatus`systemctl reset-failed ${unit}`,
+  inspect: async (unit) =>
+    runReadOnlyArgvStatus([
+      "systemctl",
+      "show",
+      unit,
+      "--property=LoadState",
+      "--property=ActiveState",
+      "--no-pager",
+    ]),
+};
+
+function propertiesOf(output: string): Map<string, string> {
+  const properties = new Map<string, string>();
+  for (const line of output.split(/\r?\n/)) {
+    const separator = line.indexOf("=");
+    if (separator <= 0) {
+      continue;
+    }
+    properties.set(line.slice(0, separator), line.slice(separator + 1));
+  }
+  return properties;
+}
+
+function commandFailure(result: MutationResult): string {
+  return (
+    result.stderr.trim() || result.stdout.trim() || `exit ${result.exitCode}`
+  );
+}
+
+/**
+ * Сбрасывает failed-состояние юнита и доказывает postcondition наблюдением.
+ *
+ * `systemctl reset-failed` возвращает ненулевой код и для уже выгруженного
+ * юнита. Это не отказ уборки: у такого юнита физически нет failed-состояния,
+ * которое нужно было бы сбрасывать. Разбирать английское `Unit ... not loaded`
+ * нельзя — текст зависит от версии и локали systemd. Поэтому код команды
+ * сохраняется для диагностики, а решение принимается по ActiveState.
+ *
+ * Ошибка чтения состояния не маскируется. Если systemd недоступен либо юнит всё
+ * ещё `failed`, rollback обязан оставить оператору настоящее предупреждение.
+ */
+export async function resetFailedUnit(
+  unit: string,
+  dependencies: ResetFailedDependencies = productionDependencies,
+): Promise<void> {
+  const reset = await dependencies.reset(unit);
+  const observed = await dependencies.inspect(unit);
+  if (observed.exitCode !== 0) {
+    throw new Error(
+      `cannot verify systemd state for ${unit} after reset-failed: ${commandFailure(observed)}`,
+    );
+  }
+
+  const properties = propertiesOf(observed.stdout);
+  const loadState = properties.get("LoadState");
+  const activeState = properties.get("ActiveState");
+  if (!loadState || !activeState) {
+    throw new Error(
+      `systemctl show ${unit} did not return LoadState and ActiveState after reset-failed`,
+    );
+  }
+  if (activeState === "failed") {
+    throw new Error(
+      `systemd unit ${unit} remains failed after reset-failed (load state: ${loadState}; ` +
+        `command: ${commandFailure(reset)})`,
+    );
+  }
+
+  if (reset.exitCode !== 0) {
+    info(
+      `systemctl reset-failed ${unit} exited with ${reset.exitCode}, but the cleanup ` +
+        `postcondition is satisfied: LoadState=${loadState}, ActiveState=${activeState}`,
+    );
+  }
+}
@@ -3,8 +3,16 @@ import type { RuntimeContext } from "../types/context";
 import { info } from "../lib/log";
 import { readText } from "../lib/fs";
 import { parseEnvFile } from "../lib/envFile";
-import { runReadOnly, runReadOnlySecret, runMutatingVisible } from "../lib/process";
-import { ADMIN_LOGIN_PATH, HYSTERIA_MACHINE_AUTH_PATH, hysteriaMachineAuthUrl } from "../config/profile";
+import {
+  runReadOnly,
+  runReadOnlySecret,
+  runMutatingVisible,
+} from "../lib/process";
+import {
+  ADMIN_LOGIN_PATH,
+  HYSTERIA_MACHINE_AUTH_PATH,
+  hysteriaMachineAuthUrl,
+} from "../config/profile";
 import { assertHysteriaConfigMatchesProfile } from "./configAssertions";
 import { assertEffectiveFirewallIsOurs } from "./firewall";

@@ -82,7 +90,8 @@ export async function smoke(context: RuntimeContext): Promise<void> {
    1000,
    async () => runReadOnlySecret`systemctl is-active hysteria-server || true`,
    (state) => state.trim() === "active",
-    (state, error) => new Error(`hysteria-server is not active: ${state ?? String(error)}`),
+    (state, error) =>
+      new Error(`hysteria-server is not active: ${state ?? String(error)}`),
  );
  await retry(
    "systemd hy2xs-admin active",
@@ -90,7 +99,8 @@ export async function smoke(context: RuntimeContext): Promise<void> {
    1000,
    async () => runReadOnlySecret`systemctl is-active hy2xs-admin || true`,
    (state) => state.trim() === "active",
-    (state, error) => new Error(`hy2xs-admin is not active: ${state ?? String(error)}`),
+    (state, error) =>
+      new Error(`hy2xs-admin is not active: ${state ?? String(error)}`),
  );

  if (context.options.skipSmoke) {
@@ -103,24 +113,38 @@ export async function smoke(context: RuntimeContext): Promise<void> {
    15,
    1000,
    async () => runReadOnlySecret`ss -H -ltn`,
-    (lines) => hasTcpListener(lines, context.config.uiBindHost, context.config.uiPort),
-    (lines, error) => new Error(`ui listener not ready on ${context.config.uiBindHost}:${context.config.uiPort}: ${lines ?? String(error)}`),
+    (lines) =>
+      hasTcpListener(lines, context.config.uiBindHost, context.config.uiPort),
+    (lines, error) =>
+      new Error(
+        `ui listener not ready on ${context.config.uiBindHost}:${context.config.uiPort}: ${lines ?? String(error)}`,
+      ),
  );
  await retry(
    "hysteria udp listener readiness",
    15,
    1000,
    async () => runReadOnlySecret`ss -H -lun`,
-    (lines) => hasUdpListener(lines, context.config.hysteriaBindHost, context.config.hysteriaPort),
-    (lines, error) => new Error(`hysteria udp listener not ready on 0.0.0.0:${context.config.hysteriaPort}: ${lines ?? String(error)}`),
+    (lines) =>
+      hasUdpListener(
+        lines,
+        context.config.hysteriaBindHost,
+        context.config.hysteriaPort,
+      ),
+    (lines, error) =>
+      new Error(
+        `hysteria udp listener not ready on 0.0.0.0:${context.config.hysteriaPort}: ${lines ?? String(error)}`,
+      ),
  );
  await retry(
    "admin healthz readiness",
    15,
    1000,
-    async () => runReadOnlySecret`curl -sS --max-time 5 http://127.0.0.1:${context.config.uiPort}/healthz`,
+    async () =>
+      runReadOnlySecret`curl -sS --max-time 5 http://127.0.0.1:${context.config.uiPort}/healthz`,
    (response) => /"ok"\s*:\s*true/.test(response),
-    (response, error) => new Error(`admin healthz is not ready: ${response ?? String(error)}`),
+    (response, error) =>
+      new Error(`admin healthz is not ready: ${response ?? String(error)}`),
  );

  // Всё, что ниже, — НАБЛЮДЕНИЕ, и оно выполняется read-only раннерами.
@@ -131,7 +155,9 @@ export async function smoke(context: RuntimeContext): Promise<void> {
  // не меняет диагностируемую систему» невозможно было включить guard'ом — он
  // отказал бы на первой же читающей команде. Классификация здесь — часть
  // контракта, а не стиль.
-  info(`installed Hysteria: ${await runReadOnly`/usr/local/bin/hysteria version`}`);
+  info(
+    `installed Hysteria: ${await runReadOnly`/usr/local/bin/hysteria version`}`,
+  );
  await runReadOnly`test -s /etc/hysteria/config.yaml`;
  await runReadOnly`test -s /etc/hy2xs/hy2xs.env`;
  await runReadOnly`test -s /etc/hysteria/post-install.env`;
@@ -156,7 +182,9 @@ export async function smoke(context: RuntimeContext): Promise<void> {
  if (context.config.uiBindHost === "127.0.0.1") {
    const tcp = await runReadOnlySecret`ss -H -ltn`;
    if (hasTcpListener(tcp, "0.0.0.0", context.config.uiPort)) {
-      throw new Error(`ui listener must not be public on 0.0.0.0:${context.config.uiPort}`);
+      throw new Error(
+        `ui listener must not be public on 0.0.0.0:${context.config.uiPort}`,
+      );
    }
  }
  await runReadOnly`! ss -H -ltn | grep -q '\[::\]:${context.config.uiPort} '`;
@@ -167,47 +195,67 @@ export async function smoke(context: RuntimeContext): Promise<void> {
  const machineAuthUrlNoToken = `http://127.0.0.1:${context.config.uiPort}${HYSTERIA_MACHINE_AUTH_PATH}`;
  const machineAuthUrl = hysteriaMachineAuthUrl(
    context.config.uiPort,
-    context.config.hysteriaTrafficStatsSecret
+    context.config.hysteriaTrafficStatsSecret,
  );

-  const missingTokenAuthCode = await runReadOnlySecret`curl -sS --max-time 5 -o /dev/null -w '%{http_code}' -X POST -H 'Content-Type: application/json' --data '{"addr":"127.0.0.1:12345","auth":"invalid","tx":0}' ${machineAuthUrlNoToken}`;
+  const missingTokenAuthCode =
+    await runReadOnlySecret`curl -sS --max-time 5 -o /dev/null -w '%{http_code}' -X POST -H 'Content-Type: application/json' --data '{"addr":"127.0.0.1:12345","auth":"invalid","tx":0}' ${machineAuthUrlNoToken}`;
  if (missingTokenAuthCode.trim() !== "403") {
-    throw new Error(`unexpected auth status without machine token: ${missingTokenAuthCode}`);
+    throw new Error(
+      `unexpected auth status without machine token: ${missingTokenAuthCode}`,
+    );
  }
  const invalidAuthResponse = await retry(
    "auth invalid credentials",
    5,
    1000,
-    async () => runReadOnlySecret`curl -sS --max-time 5 -X POST -H 'Content-Type: application/json' --data '{"addr":"127.0.0.1:12345","auth":"invalid","tx":0}' ${machineAuthUrl}`,
+    async () =>
+      runReadOnlySecret`curl -sS --max-time 5 -X POST -H 'Content-Type: application/json' --data '{"addr":"127.0.0.1:12345","auth":"invalid","tx":0}' ${machineAuthUrl}`,
    (response) => /"ok"\s*:\s*false/.test(response),
-    (response, error) => new Error(`unexpected auth response for invalid credentials: ${response ?? String(error)}`),
+    (response, error) =>
+      new Error(
+        `unexpected auth response for invalid credentials: ${response ?? String(error)}`,
+      ),
  );

  for (let i = 0; i < 10; i += 1) {
-    const response = await runReadOnlySecret`curl -sS --max-time 5 -X POST -H 'Content-Type: application/json' --data '{"addr":"127.0.0.1:12345","auth":"invalid","tx":0}' ${machineAuthUrl}`;
+    const response =
+      await runReadOnlySecret`curl -sS --max-time 5 -X POST -H 'Content-Type: application/json' --data '{"addr":"127.0.0.1:12345","auth":"invalid","tx":0}' ${machineAuthUrl}`;
    if (!/"ok"\s*:\s*false/.test(response)) {
-      throw new Error(`unexpected auth response during rate-limit smoke: ${response}`);
+      throw new Error(
+        `unexpected auth response during rate-limit smoke: ${response}`,
+      );
    }
  }

-  const invalidTypeAuthCode = await runReadOnlySecret`curl -sS --max-time 5 -o /dev/null -w '%{http_code}' -X POST -H 'Content-Type: application/json' --data '{"addr":"127.0.0.1:12345","auth":"invalid","tx":"0"}' ${machineAuthUrl}`;
+  const invalidTypeAuthCode =
+    await runReadOnlySecret`curl -sS --max-time 5 -o /dev/null -w '%{http_code}' -X POST -H 'Content-Type: application/json' --data '{"addr":"127.0.0.1:12345","auth":"invalid","tx":"0"}' ${machineAuthUrl}`;
  if (invalidTypeAuthCode.trim() !== "400") {
-    throw new Error(`unexpected auth status for tx as string: ${invalidTypeAuthCode}`);
+    throw new Error(
+      `unexpected auth status for tx as string: ${invalidTypeAuthCode}`,
+    );
  }

  if (context.mode === "install") {
-    const adminConPass = (await readBootstrapAdminSecret(context)).ADMIN_CON_PASS ?? "";
+    const adminConPass =
+      (await readBootstrapAdminSecret(context)).ADMIN_CON_PASS ?? "";
    if (!adminConPass) {
-      throw new Error("admin connection password is empty in bootstrap secret file");
+      throw new Error(
+        "admin connection password is empty in bootstrap secret file",
+      );
    }

    await retry(
      "auth valid credentials",
      10,
      1000,
-      async () => runReadOnlySecret`curl -sS --max-time 5 -X POST -H 'Content-Type: application/json' --data '{"addr":"127.0.0.1:12345","auth":"${adminConPass}","tx":0}' ${machineAuthUrl}`,
+      async () =>
+        runReadOnlySecret`curl -sS --max-time 5 -X POST -H 'Content-Type: application/json' --data '{"addr":"127.0.0.1:12345","auth":"${adminConPass}","tx":0}' ${machineAuthUrl}`,
      (response) => /"ok"\s*:\s*true/.test(response),
-      (response, error) => new Error(`unexpected auth response for valid credentials: ${response ?? String(error)}`),
+      (response, error) =>
+        new Error(
+          `unexpected auth response for valid credentials: ${response ?? String(error)}`,
+        ),
    );
  }

@@ -217,13 +265,20 @@ export async function smoke(context: RuntimeContext): Promise<void> {
    "trafficStats valid secret",
    10,
    1000,
-    async () => runReadOnlySecret`curl -sS --max-time 5 -o /dev/null -w '%{http_code}' -H 'Authorization: ${context.config.hysteriaTrafficStatsSecret}' http://127.0.0.1:${context.config.hysteriaTrafficStatsPort}/online`,
+    async () =>
+      runReadOnlySecret`curl -sS --max-time 5 -o /dev/null -w '%{http_code}' -H 'Authorization: ${context.config.hysteriaTrafficStatsSecret}' http://127.0.0.1:${context.config.hysteriaTrafficStatsPort}/online`,
    (code) => /^2\d\d$/.test(code.trim()),
-    (code, error) => new Error(`unexpected trafficStats status for valid secret: ${code ?? String(error)}`),
+    (code, error) =>
+      new Error(
+        `unexpected trafficStats status for valid secret: ${code ?? String(error)}`,
+      ),
  );
-  const deniedCode = await runReadOnlySecret`curl -sS --max-time 5 -o /dev/null -w '%{http_code}' -H 'Authorization: invalid-hy2xs-secret' http://127.0.0.1:${context.config.hysteriaTrafficStatsPort}/online`;
+  const deniedCode =
+    await runReadOnlySecret`curl -sS --max-time 5 -o /dev/null -w '%{http_code}' -H 'Authorization: invalid-hy2xs-secret' http://127.0.0.1:${context.config.hysteriaTrafficStatsPort}/online`;
  if (!/(401|403)/.test(deniedCode)) {
-    throw new Error(`unexpected trafficStats status for invalid secret: ${deniedCode}`);
+    throw new Error(
+      `unexpected trafficStats status for invalid secret: ${deniedCode}`,
+    );
  }

  // `nft -c` только разбирает файл и правил не применяет — это проверка
@@ -237,13 +292,18 @@ export async function smoke(context: RuntimeContext): Promise<void> {
  // синтаксически валидный — ruleset, проверка проходила зелёной, и операция
  // объявляла успешной установку, работающую на firewall, который она же
  // только что заменила.
-  info("verifying that the effective firewall is the one generated for this configuration");
+  info(
+    "verifying that the effective firewall is the one generated for this configuration",
+  );
  await assertEffectiveFirewallIsOurs(context);

  // Семантическая проверка установленного конфига: разбираем YAML и сверяем
  // с production-профилем, а не ищем подстроки.
  info("verifying effective Hysteria config against HY2XS production profile");
-  assertHysteriaConfigMatchesProfile(await readText("/etc/hysteria/config.yaml"), context.config);
+  assertHysteriaConfigMatchesProfile(
+    await readText("/etc/hysteria/config.yaml"),
+    context.config,
+  );

  await assertEffectiveHysteriaVersion(context);
 }
@@ -296,25 +356,23 @@ async function assertAdminLoginWorks(context: RuntimeContext): Promise<void> {
  // доступа. Логин берётся настоящий — тот же, что у администратора, — чтобы
  // запрос шёл тем же путём, что и реальный вход, и доходил до проверки пароля.
  const rejectedPassword = randomBytes(24).toString("base64url");
-  const rejectedPayload = JSON.stringify({
-    username: context.config.adminUser,
-    pass: rejectedPassword
-  });
  const rejectedBody = await retry(
    "admin login rejects wrong credentials",
    10,
    1000,
    async () =>
-      runReadOnlySecret`curl -sS --max-time 5 -X POST -H 'Content-Type: application/json' --data ${rejectedPayload} ${loginUrl}`,
+      requestAdminLogin(loginUrl, context.config.adminUser, rejectedPassword),
    (body) => isRejectedLogin(body),
    (body, error) =>
      new Error(
        `admin login did not reject invalid credentials: ${describeRejectionFailure(body, error)}\n` +
          `Панель обязана отвечать конвертом отказа с причиной ${INVALID_CREDENTIALS_CODE}. ` +
-          `Отсутствие такого конверта означает, что запрос не доживает до проверки учётных данных.`
-      )
+          `Отсутствие такого конверта означает, что запрос не доживает до проверки учётных данных.`,
+      ),
+  );
+  info(
+    `admin login rejects wrong credentials: ${describeRejection(rejectedBody)}`,
  );
-  info(`admin login rejects wrong credentials: ${describeRejection(rejectedBody)}`);

  if (context.mode !== "install") {
    return;
@@ -341,27 +399,107 @@ async function assertAdminLoginWorks(context: RuntimeContext): Promise<void> {
  // пароля с настоящим невероятно, но проверить это здесь можно точно, и тогда
  // «отвергнуто» гарантированно означает «отвергнуто», а не «не совпало».
  if (rejectedPassword === adminPassword) {
-    throw new Error("negative login probe accidentally used the real admin password");
+    throw new Error(
+      "negative login probe accidentally used the real admin password",
+    );
  }

-  const payload = JSON.stringify({ username: adminUser, pass: adminPassword });
  const response = await retry(
    "admin login with bootstrap credentials",
    10,
    1000,
-    async () =>
-      runReadOnlySecret`curl -sS --max-time 5 -X POST -H 'Content-Type: application/json' --data ${payload} ${loginUrl}`,
+    async () => requestAdminLogin(loginUrl, adminUser, adminPassword),
    (body) => isSuccessfulLogin(body),
    (body, error) =>
      new Error(
        `admin panel refused the bootstrap login it created itself: ${describeLoginFailure(body, error)}\n` +
-          `Порт открыт и /healthz отвечает, но войти в панель нельзя — установка не считается выполненной.`
-      )
+          `Порт открыт и /healthz отвечает, но войти в панель нельзя — установка не считается выполненной.`,
+      ),
  );

  info(`admin login accepted: ${describeIssuedToken(response)}`);
 }

+/**
+ * UA login-smoke называется своим именем и не маскируется под браузер.
+ *
+ * curl по умолчанию отправляет `curl/<version>`, а production middleware
+ * осознанно отклоняет scanner-like UA до разбора DTO. Без явного значения
+ * установщик проверял не вход, а собственную несовместимость с middleware.
+ */
+export const ADMIN_LOGIN_SMOKE_USER_AGENT = "HY2XS-Installer/1.0";
+
+export type AdminLoginRequest = {
+  contentType: "application/json";
+  userAgent: string;
+  body: string;
+};
+
+/** Единственный wire-контракт обеих login-проб. */
+export function buildAdminLoginRequest(
+  username: string,
+  pass: string,
+): AdminLoginRequest {
+  return {
+    contentType: "application/json",
+    userAgent: ADMIN_LOGIN_SMOKE_USER_AGENT,
+    body: JSON.stringify({ username, pass }),
+  };
+}
+
+/**
+ * Отправляет login-пробу без утечки тела в текст ошибки.
+ *
+ * Positive и negative smoke намеренно проходят через одну функцию: заголовки,
+ * имя wire-поля и настройки транспорта не могут разойтись между пробами.
+ */
+async function requestAdminLogin(
+  loginUrl: string,
+  username: string,
+  pass: string,
+): Promise<string> {
+  const request = buildAdminLoginRequest(username, pass);
+  return runReadOnlySecret`curl -sS --max-time 5 --request POST --header ${`Content-Type: ${request.contentType}`} --user-agent ${request.userAgent} --data ${request.body} ${loginUrl}`;
+}
+
+type JsonObject = Record<string, unknown>;
+
+function objectOrNull(value: unknown): JsonObject | null {
+  return typeof value === "object" && value !== null && !Array.isArray(value)
+    ? (value as JsonObject)
+    : null;
+}
+
+function parseLoginEnvelope(body: string): JsonObject | null {
+  try {
+    return objectOrNull(JSON.parse(body));
+  } catch {
+    return null;
+  }
+}
+
+function accessTokenOf(envelope: JsonObject | null): string | null {
+  const data = objectOrNull(envelope?.data);
+  return typeof data?.accessToken === "string" && data.accessToken.length > 0
+    ? data.accessToken
+    : null;
+}
+
+function carriesAccessToken(envelope: JsonObject | null): boolean {
+  const data = objectOrNull(envelope?.data);
+  return data !== null && Object.hasOwn(data, "accessToken") && data.accessToken !== null;
+}
+
+function rejectionCodesOf(envelope: JsonObject | null): string[] {
+  if (!Array.isArray(envelope?.errors)) {
+    return [];
+  }
+  return envelope.errors.flatMap((error) => {
+    const item = objectOrNull(error);
+    return typeof item?.code === "string" ? [item.code] : [];
+  });
+}
+
 /**
 * Успех определяется по КОНВЕРТУ, а не по коду HTTP.
 *
@@ -372,8 +510,9 @@ async function assertAdminLoginWorks(context: RuntimeContext): Promise<void> {
 * Выданный токен требуется отдельно: `code: 20000` без `accessToken` означал бы
 * панель, которая пускает и не выдаёт сессию.
 */
-function isSuccessfulLogin(body: string): boolean {
-  return /"code"\s*:\s*20000/.test(body) && /"accessToken"\s*:\s*"[^"]+"/.test(body);
+export function isSuccessfulLogin(body: string): boolean {
+  const envelope = parseLoginEnvelope(body);
+  return envelope?.code === 20000 && accessTokenOf(envelope) !== null;
 }

 /**
@@ -398,11 +537,12 @@ const INVALID_CREDENTIALS_CODE = "invalid_credentials";
 *                             скажем, по недоступной базе;
 *   отсутствие accessToken  — панель не выдала сессию.
 */
-function isRejectedLogin(body: string): boolean {
+export function isRejectedLogin(body: string): boolean {
+  const envelope = parseLoginEnvelope(body);
  return (
-    /"code"\s*:\s*50000/.test(body) &&
-    new RegExp(`"code"\\s*:\\s*"${INVALID_CREDENTIALS_CODE}"`).test(body) &&
-    !/"accessToken"\s*:\s*"[^"]+"/.test(body)
+    envelope?.code === 50000 &&
+    rejectionCodesOf(envelope).includes(INVALID_CREDENTIALS_CODE) &&
+    !carriesAccessToken(envelope)
  );
 }

@@ -414,11 +554,14 @@ function isRejectedLogin(body: string): boolean {
 * если панель по недоразумению впустила, в ответе лежит токен доступа, а этот
 * текст уезжает в журнал установки и в diagnostics-бандл.
 */
-function describeRejectionFailure(body: string | undefined, error: unknown): string {
+function describeRejectionFailure(
+  body: string | undefined,
+  error: unknown,
+): string {
  if (body === undefined) {
    return `запрос не выполнен: ${String(error)}`;
  }
-  if (/"accessToken"\s*:\s*"[^"]+"/.test(body)) {
+  if (carriesAccessToken(parseLoginEnvelope(body))) {
    return "панель ВЫДАЛА токен доступа на заведомо неверные учётные данные";
  }
  return describeRejection(body);
@@ -426,9 +569,9 @@ function describeRejectionFailure(body: string | undefined, error: unknown): str

 /** Как выглядит отказ: код конверта и код причины, без тела. */
 function describeRejection(body: string): string {
-  const envelope = body.match(/"code"\s*:\s*(\d+)/);
-  const reason = body.match(/"code"\s*:\s*"([a-z_]+)"/);
-  return `code=${envelope ? envelope[1] : "нет"}, причина=${reason ? reason[1] : "нет"}, токен не выдан`;
+  const envelope = parseLoginEnvelope(body);
+  const reason = rejectionCodesOf(envelope)[0];
+  return `code=${typeof envelope?.code === "number" ? envelope.code : "нет"}, причина=${reason ?? "нет"}, токен не выдан`;
 }

 // Читает /etc/hy2xs/bootstrap-admin.secret тем же парсером, которым он написан.
@@ -441,7 +584,9 @@ function describeRejection(body: string): string {
 // Комментарий записан строчными `//`, а не блоком: скан релизных гейтов
 // отбрасывает только их, и объяснение, называющее убранную конструкцию по
 // имени, иначе роняет проверку «этой конструкции здесь больше нет».
-async function readBootstrapAdminSecret(context: RuntimeContext): Promise<Record<string, string>> {
+async function readBootstrapAdminSecret(
+  context: RuntimeContext,
+): Promise<Record<string, string>> {
  return parseEnvFile(await readText(context.config.bootstrapAdminSecretPath));
 }

@@ -452,21 +597,26 @@ async function readBootstrapAdminSecret(context: RuntimeContext): Promise<Record
 * текст этой ошибки уезжает в журнал установки и в diagnostics-бандл, который
 * операторы пересылают в переписке. Поэтому наружу выдаётся только код ответа.
 */
-function describeLoginFailure(body: string | undefined, error: unknown): string {
+function describeLoginFailure(
+  body: string | undefined,
+  error: unknown,
+): string {
  if (body === undefined) {
    return `запрос не выполнен: ${String(error)}`;
  }
-  const code = body.match(/"code"\s*:\s*(\d+)/);
-  if (code) {
-    return `ответ с code=${code[1]} и без токена доступа`;
+  const envelope = parseLoginEnvelope(body);
+  if (typeof envelope?.code === "number") {
+    return `ответ с code=${envelope.code} и без токена доступа`;
  }
  return "ответ не является конвертом API админки";
 }

 /** Подтверждение выдачи токена без самого токена. */
 function describeIssuedToken(body: string): string {
-  const tokenType = body.match(/"tokenType"\s*:\s*"([^"]*)"/);
-  return tokenType ? `выдан токен типа ${tokenType[1]}` : "выдан токен доступа";
+  const data = objectOrNull(parseLoginEnvelope(body)?.data);
+  return typeof data?.tokenType === "string" && data.tokenType.length > 0
+    ? `выдан токен типа ${data.tokenType}`
+    : "выдан токен доступа";
 }

 /**
@@ -474,7 +624,9 @@ function describeIssuedToken(body: string): string {
 * пакета. На reconfigure metadata может относиться к другому пакету, поэтому
 * расхождение там — предупреждение, а не отказ.
 */
-async function assertEffectiveHysteriaVersion(context: RuntimeContext): Promise<void> {
+async function assertEffectiveHysteriaVersion(
+  context: RuntimeContext,
+): Promise<void> {
  const packagedVersion = context.hysteriaVersion.trim();
  if (!packagedVersion || packagedVersion === "unknown") {
    return;
@@ -12,8 +12,14 @@ import {
  ADMIN_USERNAME_MAX_LENGTH,
  ADMIN_USERNAME_MIN_LENGTH,
  ADMIN_USERNAME_PATTERN,
-  isValidAdminPassword
+  isValidAdminPassword,
 } from "../src/config/profile";
+import {
+  ADMIN_LOGIN_SMOKE_USER_AGENT,
+  buildAdminLoginRequest,
+  isRejectedLogin,
+  isSuccessfulLogin,
+} from "../src/steps/smoke";
 import { baselineConfig, envText } from "./fixtures";

 /**
@@ -31,7 +37,7 @@ const REPO_ROOT = path.resolve(import.meta.dir, "..", "..");
 function goContract(): string {
  return fs.readFileSync(
    path.join(REPO_ROOT, "apps", "credential", "admin.go"),
-    "utf8"
+    "utf8",
  );
 }

@@ -41,7 +47,9 @@ function goConst(name: string): string {
  if (numeric) {
    return numeric[1];
  }
-  const backticked = source.match(new RegExp(`\\b${name}\\s*=\\s*\`([^\`]*)\``));
+  const backticked = source.match(
+    new RegExp(`\\b${name}\\s*=\\s*\`([^\`]*)\``),
+  );
  if (backticked) {
    return backticked[1];
  }
@@ -68,14 +76,24 @@ describe("контракт учётных данных совпадает с а
  // Go-бинарника и импортировать его константы не может. Проверяется поэтому
  // не отсутствие копии, а её совпадение с оригиналом — сверкой по исходнику.
  test("границы совпадают с credential.Admin*", () => {
-    expect(String(ADMIN_USERNAME_MIN_LENGTH)).toBe(goConst("AdminUsernameMinLength"));
-    expect(String(ADMIN_USERNAME_MAX_LENGTH)).toBe(goConst("AdminUsernameMaxLength"));
-    expect(String(ADMIN_PASSWORD_MIN_LENGTH)).toBe(goConst("AdminPasswordMinLength"));
-    expect(String(ADMIN_PASSWORD_MAX_LENGTH)).toBe(goConst("AdminPasswordMaxLength"));
+    expect(String(ADMIN_USERNAME_MIN_LENGTH)).toBe(
+      goConst("AdminUsernameMinLength"),
+    );
+    expect(String(ADMIN_USERNAME_MAX_LENGTH)).toBe(
+      goConst("AdminUsernameMaxLength"),
+    );
+    expect(String(ADMIN_PASSWORD_MIN_LENGTH)).toBe(
+      goConst("AdminPasswordMinLength"),
+    );
+    expect(String(ADMIN_PASSWORD_MAX_LENGTH)).toBe(
+      goConst("AdminPasswordMaxLength"),
+    );
    // Предел bcrypt — ОТДЕЛЬНАЯ константа и отдельная сверка: пока его тут не
    // было, оркестратор пропускал в hy2xs.env пароль, который админка не могла
    // захешировать, и установка заканчивалась сервером без администратора.
-    expect(String(ADMIN_PASSWORD_MAX_BYTES)).toBe(goConst("AdminPasswordMaxBytes"));
+    expect(String(ADMIN_PASSWORD_MAX_BYTES)).toBe(
+      goConst("AdminPasswordMaxBytes"),
+    );
  });

  test("набор символов логина совпадает с классом из Go", () => {
@@ -83,8 +101,11 @@ describe("контракт учётных данных совпадает с а
    // raw-строке, в TypeScript — в обычной, где обратный слеш удваивается.
    const declared = goConst("adminUsernameCharacterClass");
    const mirrored = ADMIN_USERNAME_PATTERN.source.replace(
-      new RegExp(`^\\^\\[|\\]\\{${ADMIN_USERNAME_MIN_LENGTH},${ADMIN_USERNAME_MAX_LENGTH}\\}\\$$`, "g"),
-      ""
+      new RegExp(
+        `^\\^\\[|\\]\\{${ADMIN_USERNAME_MIN_LENGTH},${ADMIN_USERNAME_MAX_LENGTH}\\}\\$$`,
+        "g",
+      ),
+      "",
    );
    expect(mirrored).toBe(declared);
  });
@@ -105,7 +126,10 @@ describe("контракт учётных данных совпадает с а
  test("путь формы входа собран из базового пространства имён API", () => {
    expect(ADMIN_LOGIN_PATH).toBe("/api/auth/login");

-    const router = fs.readFileSync(path.join(REPO_ROOT, "apps", "router", "auth.go"), "utf8");
+    const router = fs.readFileSync(
+      path.join(REPO_ROOT, "apps", "router", "auth.go"),
+      "utf8",
+    );
    expect(router).toContain('auth.POST("/login"');
    expect(router).toContain('authApi.Group("/auth")');
  });
@@ -122,66 +146,81 @@ describe("HY2XS_ADMIN_USER проверяется при разборе окру
  // шесть. Установка проходила целиком, а панель не впускала никого.
  test("значение по умолчанию не короче минимума", () => {
    const config = parseRuntimeEnv(envText({ HY2XS_ADMIN_USER: null }));
-    expect(config.adminUser.length).toBeGreaterThanOrEqual(ADMIN_USERNAME_MIN_LENGTH);
+    expect(config.adminUser.length).toBeGreaterThanOrEqual(
+      ADMIN_USERNAME_MIN_LENGTH,
+    );
  });

  // Умолчание обязано совпадать с запасным значением админки: иначе установка
  // без явного HY2XS_ADMIN_USER создаёт одну учётную запись, а админка при
  // повреждённом окружении ищет другую.
  test("умолчание совпадает с запасным значением админки и с packaged env", () => {
-    const dao = fs.readFileSync(path.join(REPO_ROOT, "apps", "dao", "sqlite.go"), "utf8");
+    const dao = fs.readFileSync(
+      path.join(REPO_ROOT, "apps", "dao", "sqlite.go"),
+      "utf8",
+    );
    expect(dao).toContain('adminUser = "hy2xsadmin"');

    const packaged = fs.readFileSync(
      path.join(REPO_ROOT, "package", "config", "hy2xs.env"),
-      "utf8"
+      "utf8",
    );
    expect(packaged).toContain("HY2XS_ADMIN_USER=hy2xsadmin");
  });

  test("слишком короткий логин роняет установку", () => {
    expect(() => baselineConfig({ HY2XS_ADMIN_USER: "admin" })).toThrow(
-      /invalid HY2XS_ADMIN_USER/
+      /invalid HY2XS_ADMIN_USER/,
    );
  });

  test("слишком длинный логин роняет установку", () => {
    expect(() =>
-      baselineConfig({ HY2XS_ADMIN_USER: "a".repeat(ADMIN_USERNAME_MAX_LENGTH + 1) })
+      baselineConfig({
+        HY2XS_ADMIN_USER: "a".repeat(ADMIN_USERNAME_MAX_LENGTH + 1),
+      }),
    ).toThrow(/invalid HY2XS_ADMIN_USER/);
  });

  test("логин с пробелом, кириллицей или переводом строки роняет установку", () => {
    for (const rejected of ["hy2xs admin", "админ12", "hy2xs\tadmin"]) {
      expect(() => baselineConfig({ HY2XS_ADMIN_USER: rejected })).toThrow(
-        /invalid HY2XS_ADMIN_USER/
+        /invalid HY2XS_ADMIN_USER/,
      );
    }
  });

  test("отказ называет и границы, и набор символов", () => {
    expect(() => baselineConfig({ HY2XS_ADMIN_USER: "admin" })).toThrow(
-      new RegExp(`${ADMIN_USERNAME_MIN_LENGTH}.*${ADMIN_USERNAME_MAX_LENGTH}`)
+      new RegExp(`${ADMIN_USERNAME_MIN_LENGTH}.*${ADMIN_USERNAME_MAX_LENGTH}`),
+    );
+    expect(() => baselineConfig({ HY2XS_ADMIN_USER: "admin" })).toThrow(
+      /a-z A-Z 0-9/,
    );
-    expect(() => baselineConfig({ HY2XS_ADMIN_USER: "admin" })).toThrow(/a-z A-Z 0-9/);
  });

  // Значение уезжает в hy2xs.env и оттуда в базу. Пробел по краям превращался
  // бы в часть имени учётной записи, и вход отказывал бы «неверным логином» —
  // отказом, который невозможно связать с причиной.
  test("окружающие пробелы снимаются, а не уезжают в имя учётной записи", () => {
-    expect(baselineConfig({ HY2XS_ADMIN_USER: "  hy2xsadmin  " }).adminUser).toBe("hy2xsadmin");
+    expect(
+      baselineConfig({ HY2XS_ADMIN_USER: "  hy2xsadmin  " }).adminUser,
+    ).toBe("hy2xsadmin");
  });

  test("точка в логине принимается: набор не сужается задним числом", () => {
-    expect(baselineConfig({ HY2XS_ADMIN_USER: "admin.ops" }).adminUser).toBe("admin.ops");
+    expect(baselineConfig({ HY2XS_ADMIN_USER: "admin.ops" }).adminUser).toBe(
+      "admin.ops",
+    );
  });
 });

 describe("HY2XS_ADMIN_INITIAL_PASSWORD проверяется при разборе окружения", () => {
  test("сгенерированный пароль проходит контракт панели", () => {
    for (const raw of ["", "__GENERATE__"]) {
-      const config = parseRuntimeEnv(envText({ HY2XS_ADMIN_INITIAL_PASSWORD: raw }));
+      const config = parseRuntimeEnv(
+        envText({ HY2XS_ADMIN_INITIAL_PASSWORD: raw }),
+      );
      const length = [...config.adminInitialPassword].length;
      expect(length).toBeGreaterThanOrEqual(ADMIN_PASSWORD_MIN_LENGTH);
      expect(length).toBeLessThanOrEqual(ADMIN_PASSWORD_MAX_LENGTH);
@@ -189,26 +228,31 @@ describe("HY2XS_ADMIN_INITIAL_PASSWORD проверяется при разбо
  });

  test("слишком короткий пароль роняет установку", () => {
-    expect(() => baselineConfig({ HY2XS_ADMIN_INITIAL_PASSWORD: "12345" })).toThrow(
-      /invalid HY2XS_ADMIN_INITIAL_PASSWORD/
-    );
+    expect(() =>
+      baselineConfig({ HY2XS_ADMIN_INITIAL_PASSWORD: "12345" }),
+    ).toThrow(/invalid HY2XS_ADMIN_INITIAL_PASSWORD/);
  });

  test("слишком длинный пароль роняет установку", () => {
    expect(() =>
      baselineConfig({
-        HY2XS_ADMIN_INITIAL_PASSWORD: "a".repeat(ADMIN_PASSWORD_MAX_LENGTH + 1)
-      })
+        HY2XS_ADMIN_INITIAL_PASSWORD: "a".repeat(ADMIN_PASSWORD_MAX_LENGTH + 1),
+      }),
    ).toThrow(/invalid HY2XS_ADMIN_INITIAL_PASSWORD/);
  });

  // Набор символов пароля сервером не ограничивается, и оркестратор не имеет
  // права быть строже: отвергнутый здесь пароль сервер принял бы.
  test("пароль из произвольных символов принимается", () => {
-    for (const password of ["p@ssw0rd?!", "пароль-администратора", "a b c d e f"]) {
-      expect(baselineConfig({ HY2XS_ADMIN_INITIAL_PASSWORD: password }).adminInitialPassword).toBe(
-        password
-      );
+    for (const password of [
+      "p@ssw0rd?!",
+      "пароль-администратора",
+      "a b c d e f",
+    ]) {
+      expect(
+        baselineConfig({ HY2XS_ADMIN_INITIAL_PASSWORD: password })
+          .adminInitialPassword,
+      ).toBe(password);
    }
  });

@@ -226,8 +270,12 @@ describe("HY2XS_ADMIN_INITIAL_PASSWORD проверяется при разбо
  test("границы пароля проверяются и в символах, и в байтах", () => {
    // Проверка самой таблицы: если «я» перестанет быть двухбайтовой, случаи
    // ниже проверяли бы не то, что написано.
-    expect(Buffer.byteLength("я".repeat(36), "utf8")).toBe(ADMIN_PASSWORD_MAX_BYTES);
-    expect(Buffer.byteLength("😀".repeat(18), "utf8")).toBe(ADMIN_PASSWORD_MAX_BYTES);
+    expect(Buffer.byteLength("я".repeat(36), "utf8")).toBe(
+      ADMIN_PASSWORD_MAX_BYTES,
+    );
+    expect(Buffer.byteLength("😀".repeat(18), "utf8")).toBe(
+      ADMIN_PASSWORD_MAX_BYTES,
+    );

    const accepted = [
      "a".repeat(ADMIN_PASSWORD_MIN_LENGTH),
@@ -235,13 +283,14 @@ describe("HY2XS_ADMIN_INITIAL_PASSWORD проверяется при разбо
      "я".repeat(36),
      "😀".repeat(18),
      "abcde ",
-      " ".repeat(ADMIN_PASSWORD_MIN_LENGTH)
+      " ".repeat(ADMIN_PASSWORD_MIN_LENGTH),
    ];
    for (const password of accepted) {
      expect(isValidAdminPassword(password)).toBe(true);
-      expect(baselineConfig({ HY2XS_ADMIN_INITIAL_PASSWORD: `"${password}"` }).adminInitialPassword).toBe(
-        password
-      );
+      expect(
+        baselineConfig({ HY2XS_ADMIN_INITIAL_PASSWORD: `"${password}"` })
+          .adminInitialPassword,
+      ).toBe(password);
    }

    const rejected = [
@@ -249,13 +298,13 @@ describe("HY2XS_ADMIN_INITIAL_PASSWORD проверяется при разбо
      "a".repeat(ADMIN_PASSWORD_MAX_LENGTH + 1),
      "я".repeat(37),
      "😀".repeat(19),
-      "я".repeat(ADMIN_PASSWORD_MAX_LENGTH)
+      "я".repeat(ADMIN_PASSWORD_MAX_LENGTH),
    ];
    for (const password of rejected) {
      expect(isValidAdminPassword(password)).toBe(false);
-      expect(() => baselineConfig({ HY2XS_ADMIN_INITIAL_PASSWORD: `"${password}"` })).toThrow(
-        /invalid HY2XS_ADMIN_INITIAL_PASSWORD/
-      );
+      expect(() =>
+        baselineConfig({ HY2XS_ADMIN_INITIAL_PASSWORD: `"${password}"` }),
+      ).toThrow(/invalid HY2XS_ADMIN_INITIAL_PASSWORD/);
    }
  });

@@ -264,11 +313,13 @@ describe("HY2XS_ADMIN_INITIAL_PASSWORD проверяется при разбо
  // отправило бы оператора сокращать пароль, отвергнутый не за это.
  test("отказ называет и символы, и байты", () => {
    const tooManyBytes = `"${"я".repeat(ADMIN_PASSWORD_MAX_LENGTH)}"`;
-    expect(() => baselineConfig({ HY2XS_ADMIN_INITIAL_PASSWORD: tooManyBytes })).toThrow(
-      new RegExp(`${ADMIN_PASSWORD_MAX_BYTES} байт`)
-    );
-    expect(() => baselineConfig({ HY2XS_ADMIN_INITIAL_PASSWORD: tooManyBytes })).toThrow(
-      new RegExp(`${ADMIN_PASSWORD_MIN_LENGTH}.*${ADMIN_PASSWORD_MAX_LENGTH}`)
+    expect(() =>
+      baselineConfig({ HY2XS_ADMIN_INITIAL_PASSWORD: tooManyBytes }),
+    ).toThrow(new RegExp(`${ADMIN_PASSWORD_MAX_BYTES} байт`));
+    expect(() =>
+      baselineConfig({ HY2XS_ADMIN_INITIAL_PASSWORD: tooManyBytes }),
+    ).toThrow(
+      new RegExp(`${ADMIN_PASSWORD_MIN_LENGTH}.*${ADMIN_PASSWORD_MAX_LENGTH}`),
    );
  });

@@ -282,7 +333,9 @@ describe("HY2XS_ADMIN_INITIAL_PASSWORD проверяется при разбо
  // генератор — такой же источник значения, как и оператор.
  test("сгенерированный пароль проходит контракт целиком", () => {
    for (let i = 0; i < 50; i += 1) {
-      const config = parseRuntimeEnv(envText({ HY2XS_ADMIN_INITIAL_PASSWORD: "__GENERATE__" }));
+      const config = parseRuntimeEnv(
+        envText({ HY2XS_ADMIN_INITIAL_PASSWORD: "__GENERATE__" }),
+      );
      expect(isValidAdminPassword(config.adminInitialPassword)).toBe(true);
    }
  });
@@ -290,7 +343,10 @@ describe("HY2XS_ADMIN_INITIAL_PASSWORD проверяется при разбо

 describe("smoke выполняет настоящий вход в панель", () => {
  const smoke = () =>
-    fs.readFileSync(path.join(REPO_ROOT, "orchestrator", "src", "steps", "smoke.ts"), "utf8");
+    fs.readFileSync(
+      path.join(REPO_ROOT, "orchestrator", "src", "steps", "smoke.ts"),
+      "utf8",
+    );

  // Главный барьер этого релиза. Пока установка отвечала на вопрос «работает ли
  // панель» только фактом LISTEN и ответом /healthz, RC2 объявлял успешной
@@ -303,23 +359,38 @@ describe("smoke выполняет настоящий вход в панель",
  });

  test("успех определяется конвертом ответа и выданным токеном", () => {
-    // Админка отвечает HTTP 200 и на отказ: проверка по коду HTTP приняла бы за
-    // успешный вход любой отказ.
-    const source = smoke();
-    expect(source).toMatch(/"code"\\s\*:\\s\*20000/);
-    expect(source).toMatch(/accessToken/);
+    expect(
+      isSuccessfulLogin(
+        JSON.stringify({
+          code: 20000,
+          type: "ok",
+          data: { accessToken: "jwt", tokenType: "Bearer" },
+        }),
+      ),
+    ).toBe(true);
+    expect(
+      isSuccessfulLogin(
+        JSON.stringify({ code: 50000, data: { accessToken: "jwt" } }),
+      ),
+    ).toBe(false);
+    expect(
+      isSuccessfulLogin(
+        JSON.stringify({ code: 20000, data: { accessToken: "" } }),
+      ),
+    ).toBe(false);
+    expect(isSuccessfulLogin("not json")).toBe(false);
  });

  test("учётные данные не попадают ни в команду ошибки, ни в сообщение", () => {
    const source = smoke();
    const start = source.indexOf("async function assertAdminLoginWorks");
    expect(start).toBeGreaterThan(-1);
-    const body = source.slice(start, source.indexOf("\nfunction isSuccessfulLogin"));
+    const body = source.slice(start, source.indexOf("\ntype JsonObject"));

    // runReadOnly (без Secret) кладёт команду в текст ошибки, а команда несёт
    // пароль администратора.
    expect(body).not.toMatch(/(?<!Secret)runReadOnly`/);
-    expect(body).toMatch(/runReadOnlySecret`/);
+    expect(body.match(/runReadOnlySecret`/g)).toHaveLength(1);

    // Подстановка в tagged template — это НЕ утечка: значения там проходят
    // через shellQuote и в текст ошибки не попадают. Утечкой была бы подстановка
@@ -327,12 +398,17 @@ describe("smoke выполняет настоящий вход в панель",
    // в журнал установки и в diagnostics-бандл.
    const messages = [
      ...body.matchAll(/\binfo\(([\s\S]*?)\);/g),
-      ...body.matchAll(/new Error\(([\s\S]*?)\);/g)
+      ...body.matchAll(/new Error\(([\s\S]*?)\);/g),
    ].map((match) => match[1]);
    expect(messages.length).toBeGreaterThan(0);

    for (const message of messages) {
-      for (const secret of ["adminPassword", "payload", "response", "body}"]) {
+      for (const secret of [
+        "adminPassword",
+        "request.body",
+        "response",
+        "body}",
+      ]) {
        expect(message).not.toContain(`\${${secret}`);
      }
    }
@@ -343,11 +419,42 @@ describe("smoke выполняет настоящий вход в панель",
    expect(body).toContain("describeIssuedToken(response)");
  });

-  test("тело запроса собирается JSON.stringify, а не интерполяцией", () => {
-    // Пароль задаёт оператор: кавычка или обратный слеш в нём сломали бы сам
-    // запрос, и проверка объявила бы рабочую установку сломанной.
-    const body = smoke();
-    expect(body).toContain("JSON.stringify({ username: adminUser, pass: adminPassword })");
+  test("обе пробы используют один wire-helper", () => {
+    const source = codeOf(smoke());
+    expect(source.match(/requestAdminLogin\(/g)).toHaveLength(3); // два вызова и определение
+    const helperStart = source.indexOf("async function requestAdminLogin");
+    const helper = source.slice(
+      helperStart,
+      source.indexOf("type JsonObject", helperStart),
+    );
+    expect(helperStart).toBeGreaterThan(-1);
+    expect(helper.match(/runReadOnlySecret`curl/g)).toHaveLength(1);
+  });
+
+  test("wire-тело содержит pass, а не несовместимый alias password", () => {
+    const request = buildAdminLoginRequest('admin"name', "pass\\word ");
+    expect(JSON.parse(request.body)).toEqual({
+      username: 'admin"name',
+      pass: "pass\\word ",
+    });
+    expect(request.body).not.toContain('"password"');
+    expect(request.contentType).toBe("application/json");
+  });
+
+  test("UA smoke проходит действующее scanner-правило", () => {
+    const filter = fs.readFileSync(
+      path.join(REPO_ROOT, "apps", "middleware", "filter.go"),
+      "utf8",
+    );
+    const declared = filter.match(/regexp\.MatchString\(`\(\?i\)([^`]+)`/);
+    expect(declared).not.toBeNull();
+    const scannerPattern = new RegExp(declared![1], "i");
+
+    expect(scannerPattern.test("curl/8.10.1")).toBe(true);
+    expect(scannerPattern.test(ADMIN_LOGIN_SMOKE_USER_AGENT)).toBe(false);
+    expect(buildAdminLoginRequest("hy2xsadmin", "secret1").userAgent).toBe(
+      ADMIN_LOGIN_SMOKE_USER_AGENT,
+    );
  });

  test("отрицательная проба не зависит от режима операции", () => {
@@ -357,7 +464,10 @@ describe("smoke выполняет настоящий вход в панель",
    // дефект RC2.
    const source = smoke();
    const start = source.indexOf("async function assertAdminLoginWorks");
-    const body = source.slice(start, source.indexOf("\nfunction isSuccessfulLogin"));
+    const body = source.slice(
+      start,
+      source.indexOf("\nfunction isSuccessfulLogin"),
+    );

    const rejected = body.indexOf("admin login rejects wrong credentials");
    const modeGate = body.indexOf('context.mode !== "install"');
@@ -371,26 +481,53 @@ describe("smoke выполняет настоящий вход в панель",
  // закончился пятисоткой. Админка отвечает HTTP 200 и на успешный вход тоже,
  // поэтому «неверные учётные данные отвергнуты» этой проверкой не следовало.
  test("отрицательная проба сверяет конверт отказа, а не код HTTP", () => {
-    const source = smoke();
-
-    expect(source).toContain("isRejectedLogin");
-    // Код конверта отказа, доменная причина и ОТСУТСТВИЕ токена — три признака,
-    // и каждый закрывает свой способ ошибиться.
-    expect(source).toMatch(/"code"\\s\*:\\s\*50000/);
-    expect(source).toContain('INVALID_CREDENTIALS_CODE = "invalid_credentials"');
-
-    const start = source.indexOf("function isRejectedLogin");
-    const body = source.slice(start, source.indexOf("\n/**", start));
-    expect(body).toContain("!/\"accessToken\"");
+    const rejected = {
+      code: 50000,
+      type: "no",
+      errors: [{ code: "invalid_credentials", message: "wrong password" }],
+      data: null,
+    };
+    expect(isRejectedLogin(JSON.stringify(rejected))).toBe(true);
+    expect(isRejectedLogin(JSON.stringify({ ...rejected, code: 50001 }))).toBe(
+      false,
+    );
+    expect(
+      isRejectedLogin(
+        JSON.stringify({ ...rejected, errors: [{ code: "required" }] }),
+      ),
+    ).toBe(false);
+    expect(
+      isRejectedLogin(
+        JSON.stringify({
+          ...rejected,
+          data: { accessToken: "unexpected-token" },
+        }),
+      ),
+    ).toBe(false);
+    expect(isRejectedLogin(JSON.stringify({ ...rejected, data: { accessToken: "" } }))).toBe(
+      false,
+    );
+    expect(
+      isRejectedLogin(
+        JSON.stringify({
+          code: 50000,
+          message: 'fake {"code":"invalid_credentials"}',
+          data: null,
+        }),
+      ),
+    ).toBe(false);
+    expect(isRejectedLogin("not json")).toBe(false);
  });

  // Доменный код обязан совпадать с тем, который объявляет админка.
  test("код причины отказа совпадает с constant.ErrCodeInvalidCredentials", () => {
    const goErrors = fs.readFileSync(
      path.join(REPO_ROOT, "apps", "model", "constant", "error.go"),
-      "utf8"
+      "utf8",
+    );
+    const declared = goErrors.match(
+      /ErrCodeInvalidCredentials\s+string\s*=\s*"([^"]+)"/,
    );
-    const declared = goErrors.match(/ErrCodeInvalidCredentials\s+string\s*=\s*"([^"]+)"/);
    expect(declared).not.toBeNull();
    expect(smoke()).toContain(`INVALID_CREDENTIALS_CODE = "${declared![1]}"`);
  });
@@ -406,7 +543,9 @@ describe("smoke выполняет настоящий вход в панель",
    // acceptance.sh и в codeOf во frontend-contract.test.ts.
    expect(codeOf(source)).not.toContain("definitely-not-the-admin-password");
    expect(source).toContain('randomBytes(24).toString("base64url")');
-    expect(source).toContain("negative login probe accidentally used the real admin password");
+    expect(source).toContain(
+      "negative login probe accidentally used the real admin password",
+    );
  });

  // Bootstrap-секрет читается ПАРСЕРОМ того же формата, которым он написан.
@@ -419,7 +558,9 @@ describe("smoke выполняет настоящий вход в панель",
    const source = smoke();

    expect(source).toContain("readBootstrapAdminSecret");
-    expect(source).toContain("parseEnvFile(await readText(context.config.bootstrapAdminSecretPath))");
+    expect(source).toContain(
+      "parseEnvFile(await readText(context.config.bootstrapAdminSecretPath))",
+    );

    // Извлечения значения шеллом не остаётся ни одного. Проверки НАЛИЧИЯ
    // ключей (`grep -q '^ADMIN_USER='`) при этом законны и остаются: они
@@ -9,7 +9,11 @@ import { redactEnv } from "../src/lib/redaction";
 const directories: string[] = [];

 afterEach(async () => {
-  await Promise.all(directories.splice(0).map((directory) => rm(directory, { recursive: true, force: true })));
+  await Promise.all(
+    directories
+      .splice(0)
+      .map((directory) => rm(directory, { recursive: true, force: true }))
+  );
 });

 async function source(bytes: Uint8Array): Promise<string> {
@@ -22,14 +26,31 @@ async function source(bytes: Uint8Array): Promise<string> {

 describe("безопасная подготовка diagnostics", () => {
  test("секрет редактируется до выдачи текста на запись", async () => {
-    const path = await source(new TextEncoder().encode("HY2XS_ADMIN_CON_PASS=top-secret\n"));
+    const path = await source(
+      new TextEncoder().encode("HY2XS_ADMIN_CON_PASS=top-secret\n")
+    );
    const prepared = await prepareDiagnosticFile(path, redactEnv);
    expect(prepared).toContain("<redacted>");
    expect(prepared).not.toContain("top-secret");
  });

+  test("диагностический boolean виден, а соседний пароль скрыт", async () => {
+    const path = await source(
+      new TextEncoder().encode(
+        "HY2XS_FORCE_PASSWORD_CHANGE=false\nHY2XS_ADMIN_INITIAL_PASSWORD=top-secret\n"
+      )
+    );
+    const prepared = await prepareDiagnosticFile(path, redactEnv);
+
+    expect(prepared).toContain("HY2XS_FORCE_PASSWORD_CHANGE=false");
+    expect(prepared).toContain("HY2XS_ADMIN_INITIAL_PASSWORD=<redacted>");
+    expect(prepared).not.toContain("top-secret");
+  });
+
  test("повреждённый UTF-8 заменяется безопасной причиной, а не U+FFFD", async () => {
-    const path = await source(new Uint8Array([0x53, 0x45, 0x43, 0x52, 0x45, 0x54, 0x3d, 0xff]));
+    const path = await source(
+      new Uint8Array([0x53, 0x45, 0x43, 0x52, 0x45, 0x54, 0x3d, 0xff])
+    );
    const prepared = await prepareDiagnosticFile(path, redactEnv);
    expect(prepared).toContain("некорректный UTF-8");
    expect(prepared).not.toContain("SECRET=");
@@ -6,7 +6,7 @@ import {
  redactLogText,
  redactYaml,
  redactYamlFallback,
-  sanitizeUrlValue
+  sanitizeUrlValue,
 } from "../src/lib/redaction";

 const MACHINE_TOKEN = "hy2xs-machine-token-must-not-leak";
@@ -58,7 +58,10 @@ describe("редакция серверного конфига", () => {
  });

  test("результат остаётся валидным YAML", () => {
-    const parsed = Bun.YAML.parse(redactYaml(SERVER_CONFIG)) as Record<string, unknown>;
+    const parsed = Bun.YAML.parse(redactYaml(SERVER_CONFIG)) as Record<
+      string,
+      unknown
+    >;
    expect(parsed.listen).toBe("0.0.0.0:443");
    const auth = parsed.auth as Record<string, unknown>;
    const http = auth.http as Record<string, unknown>;
@@ -69,7 +72,10 @@ describe("редакция серверного конфига", () => {
  });

  test("несекретные поля сохраняются: диагностика должна оставаться полезной", () => {
-    const parsed = Bun.YAML.parse(redactYaml(SERVER_CONFIG)) as Record<string, unknown>;
+    const parsed = Bun.YAML.parse(redactYaml(SERVER_CONFIG)) as Record<
+      string,
+      unknown
+    >;
    const acme = parsed.acme as Record<string, unknown>;
    expect(acme.email).toBe("admin@example.com");
    expect(acme.ca).toBe("letsencrypt");
@@ -92,7 +98,10 @@ describe("редакция серверного конфига", () => {
  test("вложенное дерево под секретным ключом вырезается целиком", () => {
    const yaml = `acme:\n  dns:\n    name: cloudflare\n    config:\n      api_token: leak-me\n      zone: example.com\n`;
    const parsed = Bun.YAML.parse(redactYaml(yaml)) as Record<string, unknown>;
-    const dns = (parsed.acme as Record<string, unknown>).dns as Record<string, unknown>;
+    const dns = (parsed.acme as Record<string, unknown>).dns as Record<
+      string,
+      unknown
+    >;
    const cfg = dns.config as Record<string, unknown>;
    expect(cfg.api_token).toBe(REDACTED);
    // acme.dns.config — карта, где секретны все значения, а не только ключ.
@@ -158,7 +167,7 @@ describe("редакция env-артефактов", () => {
    "HY2_AUTH_MODE=http",
    `HY2_AUTH_URL=http://127.0.0.1:8080/internal/hysteria/auth?access_token=${MACHINE_TOKEN}`,
    `HY2_OBFS_PASSWORD=${OBFS_PASSWORD}`,
-    "HY2_PORT=443"
+    "HY2_PORT=443",
  ].join("\n");

  // Регрессия: HY2_AUTH_URL не подходит ни под один key-маркер, но несёт
@@ -166,7 +175,9 @@ describe("редакция env-артефактов", () => {
  test("секрет внутри URL-значения вырезается, даже если имя ключа несекретное", () => {
    const redacted = redactEnv(POST_INSTALL);
    expect(redacted).not.toContain(MACHINE_TOKEN);
-    expect(redacted).toContain("HY2_AUTH_URL=http://127.0.0.1:8080/internal/hysteria/auth");
+    expect(redacted).toContain(
+      "HY2_AUTH_URL=http://127.0.0.1:8080/internal/hysteria/auth"
+    );
  });

  test("ключи-секреты вырезаются по имени", () => {
@@ -180,13 +191,40 @@ describe("редакция env-артефактов", () => {
    expect(redacted).toContain("HY2_PORT=443");
  });

+  test("boolean-флаг принудительной смены пароля остаётся диагностируемым", () => {
+    const flags = [
+      "HY2XS_FORCE_PASSWORD_CHANGE=false",
+      "HY2XS_FORCE_PASSWORD_CHANGE=true",
+    ].join("\n");
+
+    expect(redactEnv(flags)).toBe(flags);
+  });
+
+  test("исключение для boolean-флага точное и не ослабляет защиту", () => {
+    const input = [
+      "HY2XS_FORCE_PASSWORD_CHANGE_SUFFIX=must-hide",
+      "HY2XS_FORCE_PASSWORD_CHANGE=malformed-secret",
+      "HY2XS_ADMIN_INITIAL_PASSWORD=initial-password",
+      "HY2XS_ADMIN_CON_PASS=connection-password",
+      `HY2XS_HYSTERIA_OBFS_PASSWORD=${OBFS_PASSWORD}`,
+    ].join("\n");
+    const redacted = redactEnv(input);
+
+    expect(redacted).not.toContain("must-hide");
+    expect(redacted).not.toContain("initial-password");
+    expect(redacted).not.toContain("connection-password");
+    expect(redacted).not.toContain(OBFS_PASSWORD);
+    expect(redacted.match(/<redacted>/g)).toHaveLength(5);
+  });
+
  test("runtime-конфиг теряет все секреты", () => {
    const runtime = [
      "HY2XS_CONFIG_SCHEMA_VERSION=2",
+      "HY2XS_FORCE_PASSWORD_CHANGE=false",
      `HY2XS_HYSTERIA_TRAFFIC_STATS_SECRET=${MACHINE_TOKEN}`,
      `HY2XS_HYSTERIA_OBFS_PASSWORD=${OBFS_PASSWORD}`,
      "HY2XS_ADMIN_CON_PASS=connection-password",
-      "HY2XS_ADMIN_INITIAL_PASSWORD=initial-password"
+      "HY2XS_ADMIN_INITIAL_PASSWORD=initial-password",
    ].join("\n");

    const redacted = redactEnv(runtime);
@@ -195,16 +233,21 @@ describe("редакция env-артефактов", () => {
    expect(redacted).not.toContain("connection-password");
    expect(redacted).not.toContain("initial-password");
    expect(redacted).toContain("HY2XS_CONFIG_SCHEMA_VERSION=2");
+    expect(redacted).toContain("HY2XS_FORCE_PASSWORD_CHANGE=false");
  });
 });

 describe("санитизация URL", () => {
  test("креденшелы в URL вырезаются", () => {
-    expect(sanitizeUrlValue("https://user:hunter2@example.com/x")).not.toContain("hunter2");
+    expect(
+      sanitizeUrlValue("https://user:hunter2@example.com/x")
+    ).not.toContain("hunter2");
  });

  test("секретные query-параметры вырезаются, остальные сохраняются", () => {
-    const out = sanitizeUrlValue("https://example.com/x?access_token=abc&page=2");
+    const out = sanitizeUrlValue(
+      "https://example.com/x?access_token=abc&page=2"
+    );
    expect(out).not.toContain("abc");
    expect(out).toContain("page=2");
  });
@@ -245,7 +288,7 @@ describe("редакция журналов в diagnostics-бандле", () =>
    for (const line of [
      `starting with access_token=${MACHINE_TOKEN}`,
      `trafficStats secret=${MACHINE_TOKEN} rejected`,
-      `obfs password: ${OBFS_PASSWORD}`
+      `obfs password: ${OBFS_PASSWORD}`,
    ]) {
      const out = redactLogText(line);
      expect(out).not.toContain(MACHINE_TOKEN);
@@ -288,14 +331,22 @@ describe("маркеры секретных имён", () => {
      "cookie",
      "bearer",
      "signature",
-      "passphrase"
+      "passphrase",
    ]) {
      expect(isSecretKey(key)).toBe(true);
    }
  });

  test("не задевают обычные поля", () => {
-    for (const key of ["listen", "type", "domains", "minPacketSize", "email", "ca", "dir"]) {
+    for (const key of [
+      "listen",
+      "type",
+      "domains",
+      "minPacketSize",
+      "email",
+      "ca",
+      "dir",
+    ]) {
      expect(isSecretKey(key)).toBe(false);
    }
  });
@@ -5,7 +5,7 @@ import {
  HYSTERIA_HASHES_ASSET,
  HYSTERIA_LINUX_AMD64_ASSET,
  selectLatestStableRelease,
-  type GithubRelease
+  type GithubRelease,
 } from "../src/build/hysteriaRelease";

 function assetUrl(tag: string, name: string): string {
@@ -21,13 +21,13 @@ function release(tag: string): GithubRelease {
    assets: [
      {
        name: HYSTERIA_LINUX_AMD64_ASSET,
-        browser_download_url: assetUrl(tag, HYSTERIA_LINUX_AMD64_ASSET)
+        browser_download_url: assetUrl(tag, HYSTERIA_LINUX_AMD64_ASSET),
      },
      {
        name: HYSTERIA_HASHES_ASSET,
-        browser_download_url: assetUrl(tag, HYSTERIA_HASHES_ASSET)
-      }
-    ]
+        browser_download_url: assetUrl(tag, HYSTERIA_HASHES_ASSET),
+      },
+    ],
  };
 }

@@ -63,7 +63,7 @@ describe("install-time никогда не резолвит latest", () => {
    ["commands", "install.ts"],
    ["steps", "hysteria.ts"],
    ["lib", "packageMeta.ts"],
-    ["commands", "reconfigure.ts"]
+    ["commands", "reconfigure.ts"],
  ];

  test("install-time код не импортирует build-time резолвер", () => {
@@ -83,13 +83,19 @@ describe("install-time никогда не резолвит latest", () => {

  test("установка берёт версию, url и sha256 только из metadata пакета", () => {
    const install = srcFile("commands", "install.ts");
-    expect(install).toContain('readPackageValue(options.packageDir, "hysteria.version"');
-    expect(install).toContain('readPackageValue(options.packageDir, "hysteria.url"');
-    expect(install).toContain('readPackageValue(options.packageDir, "hysteria.sha256"');
+    for (const key of ["hysteria.version", "hysteria.url", "hysteria.sha256"]) {
+      expect(install).toMatch(
+        new RegExp(
+          `readPackageValue\\(\\s*options\\.packageDir,\\s*"${key.replace(".", "\\.")}"`,
+        ),
+      );
+    }
  });

  test("отсутствие любой части lock-метаданных прерывает установку", () => {
-    expect(srcFile("commands", "install.ts")).toContain("missing Hysteria lock metadata in package");
+    expect(srcFile("commands", "install.ts")).toContain(
+      "missing Hysteria lock metadata in package",
+    );
  });

  test("установленный бинарник сверяется с закреплённой версией", () => {
@@ -25,7 +25,10 @@ import { persistFailureState, runRollbackStages } from "../src/lib/rollback";
 // Пути считаются от файла теста, а не от cwd: `bun test` запускается и из корня
 // репозитория (сборка), и из orchestrator/ (разработчик).
 function source(relativeToSrc: string): string {
-  return readFileSync(join(import.meta.dir, "..", "src", relativeToSrc), "utf8");
+  return readFileSync(
+    join(import.meta.dir, "..", "src", relativeToSrc),
+    "utf8",
+  );
 }

 describe("стадии отката независимы", () => {
@@ -33,7 +36,7 @@ describe("стадии отката независимы", () => {
    const executed: string[] = [];
    const failures = await runRollbackStages([
      { name: "firewall", run: async () => void executed.push("firewall") },
-      { name: "services", run: async () => void executed.push("services") }
+      { name: "services", run: async () => void executed.push("services") },
    ]);

    expect(executed).toEqual(["firewall", "services"]);
@@ -49,10 +52,13 @@ describe("стадии отката независимы", () => {
        run: async () => {
          executed.push("firewall");
          throw new Error("nft: command failed");
-        }
        },
-      { name: "restore configuration", run: async () => void executed.push("restore") },
-      { name: "stop services", run: async () => void executed.push("stop") }
+      },
+      {
+        name: "restore configuration",
+        run: async () => void executed.push("restore"),
+      },
+      { name: "stop services", run: async () => void executed.push("stop") },
    ]);

    expect(executed).toEqual(["firewall", "restore", "stop"]);
@@ -67,15 +73,15 @@ describe("стадии отката независимы", () => {
        name: "firewall",
        run: async () => {
          throw new Error("first");
-        }
+        },
      },
      { name: "healthy", run: async () => undefined },
      {
        name: "restore configuration",
        run: async () => {
          throw new Error("second");
-        }
-      }
+        },
+      },
    ]);

    expect(failures).toHaveLength(2);
@@ -91,14 +97,14 @@ describe("стадии отката независимы", () => {
        name: "a",
        run: async () => {
          throw new Error("boom");
-        }
+        },
      },
      {
        name: "b",
        run: async () => {
          throw new Error("boom");
-        }
-      }
+        },
+      },
    ]);
    expect(failures).toHaveLength(2);
  });
@@ -109,8 +115,8 @@ describe("стадии отката независимы", () => {
        name: "weird",
        run: async () => {
          throw "строковая ошибка";
-        }
-      }
+        },
+      },
    ]);
    expect(failures[0]).toContain("строковая ошибка");
  });
@@ -135,7 +141,7 @@ describe("состояние отказа пишется best effort", () => {
    await expect(
      persistFailureState(async () => {
        throw new Error("ENOSPC: no space left on device");
-      })
+      }),
    ).resolves.toBeUndefined();
  });
 });
@@ -173,7 +179,10 @@ describe("install: откат обязателен после операцион
    // Прямых await-вызовов отката в теле rollbackFailedInstall быть не должно:
    // именно они и образовывали отменяемую цепочку.
    const start = installSource.indexOf("async function rollbackFailedInstall");
-    const body = installSource.slice(start, installSource.indexOf("export async function install"));
+    const body = installSource.slice(
+      start,
+      installSource.indexOf("export async function install"),
+    );
    expect(body).toContain("await rollbackFirewallNow(context)");
    // Вызов существует только внутри стадии.
    const firewallAt = body.indexOf("await rollbackFirewallNow(context)");
@@ -182,14 +191,19 @@ describe("install: откат обязателен после операцион
  });

  test("остановка сервисов остаётся отдельными стадиями", () => {
-    for (const stage of ["stop services", "disable services", "reset failed services"]) {
+    for (const stage of [
+      "stop services",
+      "disable services",
+      "reset failed hysteria-server",
+      "reset failed hy2xs-admin",
+    ]) {
      expect(installSource).toContain(`name: "${stage}"`);
    }
  });

  test("чужие сервисы по-прежнему не трогаются", () => {
    expect(installSource).toContain(
-      "systemd units were not deployed by this operation, leaving services untouched"
+      "systemd units were not deployed by this operation, leaving services untouched",
    );
  });
 });
@@ -202,7 +216,7 @@ describe("reconfigure: откат обязателен после операци
    // выполняться ВНУТРИ persistFailureState, в какую бы строку его ни перенёс
    // редактор.
    const wrapped = reconfigureSource.match(
-      /await persistFailureState\(\(\) =>\s*markPhase\(context,\s*classifyReconfigureFailure\(ownership, error\), message\)\s*\)/
+      /await persistFailureState\(\(\) =>\s*markPhase\(context,\s*classifyReconfigureFailure\(ownership, error\), message\)\s*\)/,
    );
    expect(wrapped).not.toBeNull();
  });
@@ -222,8 +236,12 @@ describe("reconfigure: откат обязателен после операци

  // Регрессия: отказ rollbackFirewallNow отменял rollbackCurrentState целиком.
  test("порядок сохранён: сначала firewall, затем конфиги", () => {
-    const firewall = reconfigureSource.indexOf("await rollbackFirewallNow(context)");
-    const restore = reconfigureSource.indexOf("await rollbackCurrentState(context)");
+    const firewall = reconfigureSource.indexOf(
+      "await rollbackFirewallNow(context)",
+    );
+    const restore = reconfigureSource.indexOf(
+      "await rollbackCurrentState(context)",
+    );
    const stages = reconfigureSource.indexOf("await runRollbackStages(stages)");
    expect(firewall).toBeGreaterThan(-1);
    expect(firewall).toBeLessThan(restore);
@@ -242,14 +260,19 @@ describe("reconfigure: откат обязателен после операци
    const start = reconfigureSource.indexOf("function restoreStages(");
    const body = reconfigureSource.slice(
      start,
-      reconfigureSource.indexOf("async function rollbackCurrentState")
+      reconfigureSource.indexOf("async function rollbackCurrentState"),
    );
    const muted = body
      .split(/\r?\n/)
      .filter((line) => line.includes("runMutatingVisible`"))
-      .filter((line) => line.includes("|| true") || line.includes("2>/dev/null"));
+      .filter(
+        (line) => line.includes("|| true") || line.includes("2>/dev/null"),
+      );

-    expect(muted, `восстановление снова скрывает ошибки: ${muted.join("; ")}`).toEqual([]);
+    expect(
+      muted,
+      `восстановление снова скрывает ошибки: ${muted.join("; ")}`,
+    ).toEqual([]);
  });

  test("восстановление разбито на независимые стадии", () => {
@@ -260,7 +283,7 @@ describe("reconfigure: откат обязателен после операци
      "restore nftables files",
      "apply restored ruleset",
      "reload systemd units",
-      "restart services"
+      "restart services",
    ]) {
      expect(reconfigureSource).toContain(`"${stage}"`);
    }
@@ -269,7 +292,9 @@ describe("reconfigure: откат обязателен после операци
  // Неполное восстановление обязано доходить до итоговой сводки как отказ.
  test("частичное восстановление не выдаётся за успешное", () => {
    expect(reconfigureSource).toContain("restoreFailures.length > 0");
-    expect(reconfigureSource).toContain("восстановление состояния выполнено не полностью");
+    expect(reconfigureSource).toContain(
+      "восстановление состояния выполнено не полностью",
+    );
  });
 });

@@ -282,12 +307,18 @@ describe("install: команды отката не глушат собстве
  // них не выполнялось никогда.
  test("стадии остановки сервисов не подавляют код возврата", () => {
    const start = installSource.indexOf("async function rollbackFailedInstall");
-    const body = installSource.slice(start, installSource.indexOf("export async function install"));
+    const body = installSource.slice(
+      start,
+      installSource.indexOf("export async function install"),
+    );
    const muted = body
      .split(/\r?\n/)
      .filter((line) => line.includes("runMutatingVisible`"))
      .filter((line) => line.includes("|| true"));

-    expect(muted, `стадии отката снова скрывают ошибки: ${muted.join("; ")}`).toEqual([]);
+    expect(
+      muted,
+      `стадии отката снова скрывают ошибки: ${muted.join("; ")}`,
+    ).toEqual([]);
  });
 });
@@ -0,0 +1,116 @@
+import { describe, expect, test } from "bun:test";
+import {
+  resetFailedUnit,
+  type ResetFailedDependencies,
+} from "../src/lib/systemd";
+import type { MutationResult } from "../src/lib/process";
+import { runRollbackStages } from "../src/lib/rollback";
+
+function result(exitCode: number, stdout = "", stderr = ""): MutationResult {
+  return { exitCode, stdout, stderr };
+}
+
+function dependencies(
+  reset: MutationResult,
+  inspect: MutationResult,
+  calls: string[] = [],
+): ResetFailedDependencies {
+  return {
+    reset: async (unit) => {
+      calls.push(`reset:${unit}`);
+      return reset;
+    },
+    inspect: async (unit) => {
+      calls.push(`inspect:${unit}`);
+      return inspect;
+    },
+  };
+}
+
+describe("systemd rollback cleanup", () => {
+  test("успешный reset-failed подтверждается наблюдением", async () => {
+    const calls: string[] = [];
+    await expect(
+      resetFailedUnit(
+        "hy2xs-admin",
+        dependencies(
+          result(0),
+          result(0, "LoadState=loaded\nActiveState=inactive\n"),
+          calls,
+        ),
+      ),
+    ).resolves.toBeUndefined();
+    expect(calls).toEqual(["reset:hy2xs-admin", "inspect:hy2xs-admin"]);
+  });
+
+  test("уже выгруженный юнит является успешным конечным состоянием", async () => {
+    await expect(
+      resetFailedUnit(
+        "hy2xs-admin",
+        dependencies(
+          result(5, "", "Unit hy2xs-admin.service not loaded."),
+          result(0, "LoadState=not-found\nActiveState=inactive\n"),
+        ),
+      ),
+    ).resolves.toBeUndefined();
+  });
+
+  test("уже выгруженный юнит не создаёт manual-recovery failure", async () => {
+    const failures = await runRollbackStages([
+      {
+        name: "reset failed hy2xs-admin",
+        run: async () =>
+          resetFailedUnit(
+            "hy2xs-admin",
+            dependencies(
+              result(5, "", "Unit hy2xs-admin.service not loaded."),
+              result(0, "LoadState=not-found\nActiveState=inactive\n"),
+            ),
+          ),
+      },
+    ]);
+    expect(failures).toEqual([]);
+  });
+
+  test("решение не зависит от английского текста stderr", async () => {
+    await expect(
+      resetFailedUnit(
+        "hysteria-server",
+        dependencies(
+          result(5, "", "модуль не загружен"),
+          result(0, "LoadState=not-found\nActiveState=inactive\n"),
+        ),
+      ),
+    ).resolves.toBeUndefined();
+  });
+
+  test("сохранившееся failed-состояние остаётся настоящим отказом", async () => {
+    await expect(
+      resetFailedUnit(
+        "hysteria-server",
+        dependencies(
+          result(1, "", "access denied"),
+          result(0, "LoadState=loaded\nActiveState=failed\n"),
+        ),
+      ),
+    ).rejects.toThrow("remains failed");
+  });
+
+  test("ошибка наблюдения не выдаётся за успешную уборку", async () => {
+    await expect(
+      resetFailedUnit(
+        "hysteria-server",
+        dependencies(result(1), result(1, "", "Failed to connect to bus")),
+      ),
+    ).rejects.toThrow("cannot verify systemd state");
+  });
+
+  test("неполный ответ systemctl show отклоняется fail-closed", async () => {
+    await expect(
+      resetFailedUnit(
+        "hysteria-server",
+        dependencies(result(0), result(0, "LoadState=loaded\n")),
+      ),
+    ).rejects.toThrow("did not return LoadState and ActiveState");
+  });
+});
@@ -63,15 +63,16 @@ Windows и macOS можно использовать для редактиров
   и сверяет каждый архив с контрольной суммой из `versions.env`.
 6. Выполняет `verify_versions_contract`: рассинхрон версий роняет сборку до создания tarball.
 7. Прогоняет тесты и типы оркестратора (`bun test`, `tsc --noEmit`).
-8. Разрешает upstream-версию Hysteria, берёт ожидаемый SHA-256 из upstream `hashes.txt` и сверяет с ним скачанный артефакт.
-9. Проходит compatibility gate: реальный бинарник Hysteria должен принять канонический конфиг HY2XS.
-10. Копирует package skeleton.
-11. Собирает install-only orchestrator в standalone binary.
-12. Собирает frontend и backend HY2XS admin в Linux amd64 binary, проставляя версию админки через ldflags.
-13. Прогоняет `go vet` и `go test` для HY2XS admin (после сборки frontend, потому что `go:embed all:dist` требует готовых ассетов).
-14. Записывает metadata и checksums.
-15. Создаёт `dist/hy2xs-install-<version>.tar.gz`.
-16. Проверяет архив и прогоняет acceptance-проверки.
+8. Рано прогоняет dependency-free контракты панели.
+9. Разрешает upstream-версию Hysteria, берёт ожидаемый SHA-256 из upstream `hashes.txt` и сверяет с ним скачанный артефакт.
+10. Проходит compatibility gate: реальный бинарник Hysteria должен принять канонический конфиг HY2XS.
+11. Копирует package skeleton и собирает install-only orchestrator.
+12. Устанавливает frozen frontend lock-граф, runtime-компилирует все сообщения RU/EN реальным `vue-i18n`, проверяет типы и собирает production bundle.
+13. Собирает backend HY2XS admin в Linux amd64 binary, проставляя версию через ldflags.
+14. Прогоняет `go vet` и `go test` для HY2XS admin (после сборки frontend, потому что `go:embed all:dist` требует готовых ассетов).
+15. Проверяет зависимости через `govulncheck ./...` и `pnpm audit` по всему lock-графу.
+16. Записывает metadata и checksums.
+17. Создаёт архив и прогоняет его acceptance-проверки.

 ## Контракт версий

@@ -99,6 +100,10 @@ Go-коде больше нет: она уже успела разъехатьс
 только политика `HYSTERIA_CHANNEL`, результат резолва — в
 [`hysteria-lock.env`](hysteria-lock.env)).

+Security overrides frontend находятся в `apps/frontend/pnpm-workspace.yaml`:
+это канонический файл настроек pnpm. Поле `pnpm` в `package.json` для этой цели
+не используется, потому что новые версии package manager его игнорируют.
+
 ## Версия Hysteria: разрешение и compatibility gate

 Builder не хранит версию Hysteria вручную. По умолчанию он определяет последнюю стабильную версию сам и замораживает её в пакете.
@@ -43,9 +43,9 @@ main() {
  log_step "Checking orchestrator contracts"
  run_orchestrator_tests

-  # Контракты панели проверяются рано: они не требуют ни собранного bundle, ни
-  # установленных зависимостей, и падать на них после резолва Hysteria и сборки
-  # артефактов означало бы платить минутами за ошибку, видимую сразу.
+  # Dependency-free контракты панели проверяются рано. Runtime-компиляция
+  # словарей запускается внутри bundle_ui сразу после frozen install, потому
+  # что ей нужен реальный vue-i18n из frontend lock-графа.
  log_step "Checking HY2XS admin frontend contracts"
  run_frontend_tests

@@ -1059,24 +1059,48 @@ EOF
    || fail "acceptance: smoke больше не выполняет настоящий вход в панель"
  code_has orchestrator/src/steps/smoke.ts -F -- 'ADMIN_LOGIN_PATH' \
    || fail "acceptance: адрес формы входа перестал браться из профиля"
-  # Успех определяется КОНВЕРТОМ: админка отвечает 200 OK и на отказ тоже.
-  code_has orchestrator/src/steps/smoke.ts -F -- '"code"\s*:\s*20000' \
+  # Успех определяется разобранным КОНВЕРТОМ: админка отвечает 200 OK и на
+  # отказ тоже, а regex по сырому тексту способен принять подстроку в message.
+  code_has orchestrator/src/steps/smoke.ts -F -- 'envelope?.code === 20000' \
    || fail "acceptance: успех входа снова определяется кодом HTTP, а не конвертом ответа"
-  # Команда несёт пароль администратора и не имеет права попасть в текст ошибки:
-  # runReadOnly (без Secret) кладёт её туда, а текст уезжает в журнал установки
-  # и в diagnostics-бандл. Проверяется ТЕЛО функции, а не файл: остальной smoke
-  # законно пользуется обоими раннерами.
-  local login_body
+  # Positive и negative probe обязаны пользоваться одной транспортной функцией:
+  # две независимые curl-команды и разошлись в RC3 с production middleware.
+  local login_body login_request_body
  login_body="$(sed -n '/^async function assertAdminLoginWorks/,/^}/p' orchestrator/src/steps/smoke.ts)" \
    || fail "acceptance: не удалось прочитать проверку входа в панель"
  [ -n "$login_body" ] \
    || fail "acceptance: функция проверки входа в панель не найдена"
-  grep -q 'runReadOnlySecret`curl' <<<"$login_body" \
+  [ "$(grep -c 'requestAdminLogin(' <<<"$login_body")" -eq 2 ] \
+    || fail "acceptance: positive и negative login probe не используют один request helper"
+  ! grep -q 'curl ' <<<"$login_body" \
+    || fail "acceptance: assertAdminLoginWorks снова содержит отдельную curl-команду"
+
+  login_request_body="$(sed -n '/^async function requestAdminLogin/,/^}/p' orchestrator/src/steps/smoke.ts)" \
+    || fail "acceptance: не удалось прочитать transport helper входа"
+  [ -n "$login_request_body" ] \
+    || fail "acceptance: общий transport helper входа не найден"
+  grep -q 'runReadOnlySecret`curl' <<<"$login_request_body" \
    || fail "acceptance: запрос входа не выполняется секретным раннером"
  # `runReadOnly`curl` совпадает только с ГОЛОЙ формой: у секретной после
  # `runReadOnly` идёт `Secret`, а не обратная кавычка.
-  ! grep -q 'runReadOnly`curl' <<<"$login_body" \
+  ! grep -q 'runReadOnly`curl' <<<"$login_request_body" \
    || fail "acceptance: запрос входа выполняется раннером, кладущим команду в текст ошибки"
+  grep -q -- '--user-agent' <<<"$login_request_body" \
+    || fail "acceptance: login smoke снова наследует блокируемый curl User-Agent"
+
+  # Wire-contract проверяется значением, а не поиском форматирования в исходнике.
+  "$BUN_BIN" -e '
+    const smoke = await import("./orchestrator/src/steps/smoke.ts");
+    const request = smoke.buildAdminLoginRequest("hy2xsadmin", "quote\" slash\\ tail ");
+    const body = JSON.parse(request.body);
+    if (body.username !== "hy2xsadmin" || body.pass !== "quote\" slash\\ tail ") {
+      throw new Error("login helper искажает username/pass");
+    }
+    if (Object.hasOwn(body, "password")) throw new Error("login helper отправляет alias password");
+    if (!request.userAgent || /fofa|shodan|curl|wget/i.test(request.userAgent)) {
+      throw new Error("login helper отправляет scanner-like User-Agent");
+    }
+  ' || fail "acceptance: общий login helper нарушает wire-контракт или scanner middleware"

  log_step "Acceptance: the negative login probe proves a rejection"
  # Проверка `code.trim() === "200"` доказывала ровно одно: что запрос не
@@ -1084,6 +1108,8 @@ EOF
  # поэтому «неверные учётные данные отвергнуты» из неё не следовало.
  code_has orchestrator/src/steps/smoke.ts -F -- 'isRejectedLogin' \
    || fail "acceptance: отрицательная проба снова определяет отказ по коду HTTP"
+  code_has orchestrator/src/steps/smoke.ts -F -- 'JSON.parse(body)' \
+    || fail "acceptance: login envelope снова проверяется regex по сырому тексту"
  code_has orchestrator/src/steps/smoke.ts -F -- 'INVALID_CREDENTIALS_CODE = "invalid_credentials"' \
    || fail "acceptance: отрицательная проба не сверяет доменный код отказа"
  # Литерал в исходнике теоретически может оказаться настоящим паролем — тогда
@@ -1319,14 +1345,20 @@ $piped_matcher"
    || fail "acceptance: прогон тестов оркестратора не фиксируется результатом"
  grep -q 'ADMIN_TESTS_PASSED' tools/build/lib/package.sh \
    || fail "acceptance: прогон тестов админки не фиксируется результатом"
+  grep -q 'FRONTEND_CONTRACT_TESTS_PASSED' tools/build/lib/package.sh \
+    || fail "acceptance: ранние контракты панели не фиксируются результатом"
+  grep -q 'FRONTEND_RUNTIME_TESTS_PASSED' tools/build/lib/package.sh \
+    || fail "acceptance: runtime-компиляция локализации не фиксируется результатом"
  grep -q 'FRONTEND_TESTS_PASSED' tools/build/lib/package.sh \
-    || fail "acceptance: прогон контрактных тестов панели не фиксируется результатом"
+    || fail "acceptance: общий результат тестов панели не фиксируется"
  "$BUN_BIN" -e '
    const source = require("node:fs").readFileSync("tools/build/lib/package.sh", "utf8");
    for (const [fn, flag] of [
      ["run_orchestrator_tests()", "ORCHESTRATOR_TESTS_PASSED=\"true\""],
      ["run_admin_tests()", "ADMIN_TESTS_PASSED=\"true\""],
-      ["run_frontend_tests()", "FRONTEND_TESTS_PASSED=\"true\""]
+      ["run_frontend_tests()", "FRONTEND_CONTRACT_TESTS_PASSED=\"true\""],
+      ["bundle_ui()", "FRONTEND_RUNTIME_TESTS_PASSED=\"true\""],
+      ["bundle_ui()", "FRONTEND_TESTS_PASSED=\"true\""]
    ]) {
      const start = source.indexOf(fn);
      if (start < 0) throw new Error("не найдена функция " + fn);
@@ -1340,6 +1372,19 @@ $piped_matcher"
      if (set < 0) throw new Error(fn + ": результат прогона не фиксируется");
      if (set < run) throw new Error(fn + ": результат объявляется раньше, чем получен");
    }
+
+    const bundleStart = source.indexOf("bundle_ui()");
+    const bundleRest = source.slice(bundleStart);
+    const bundleEnd = bundleRest.search(/\n\}[\r\n]/);
+    const bundle = bundleEnd < 0 ? bundleRest : bundleRest.slice(0, bundleEnd);
+    const install = bundle.indexOf("install --frozen-lockfile");
+    const runtime = bundle.indexOf("test test/i18n-runtime.test.ts");
+    const typecheck = bundle.indexOf("run typecheck");
+    const build = bundle.indexOf("run build:prod");
+    if (install < 0 || runtime < 0) throw new Error("runtime i18n gate не найден в bundle_ui");
+    if (!(install < runtime && runtime < typecheck && typecheck < build)) {
+      throw new Error("порядок frontend gate обязан быть install -> i18n runtime -> typecheck -> build");
+    }
  ' || fail "acceptance: утверждение о пройденных тестах обязано следовать за прогоном"

  # Детектор гонок — часть прогона админки, а не пожелание.
@@ -1579,6 +1624,17 @@ run_single_owner_acceptance() {
    grep -q 'persistFailureState(' "$rollback_command" \
      || fail "acceptance: запись состояния отказа в $rollback_command не помечена как best effort"
  done
+  # reset-failed — cleanup с допустимым исходом «юнит уже выгружен». Ненулевой
+  # код нельзя ни превращать в ложный manual-recovery warning, ни глушить:
+  # решение принимается после наблюдения ActiveState каждого юнита.
+  grep -q 'resetFailedUnit("hysteria-server")' orchestrator/src/commands/install.ts \
+    || fail "acceptance: rollback install не проверяет postcondition reset-failed для hysteria-server"
+  grep -q 'resetFailedUnit("hy2xs-admin")' orchestrator/src/commands/install.ts \
+    || fail "acceptance: rollback install не проверяет postcondition reset-failed для hy2xs-admin"
+  code_has orchestrator/src/lib/systemd.ts -F -- 'runMutatingStatus`systemctl reset-failed' \
+    || fail "acceptance: reset-failed снова бросает до проверки допустимого not-loaded состояния"
+  code_has orchestrator/src/lib/systemd.ts -F -- 'properties.get("ActiveState")' \
+    || fail "acceptance: успех reset-failed не доказывается наблюдаемым ActiveState"
  "$BUN_BIN" -e '
    const fs = require("node:fs");
    for (const [file, write] of [
@@ -64,7 +64,7 @@ run_orchestrator_tests() {
 }

 run_frontend_tests() {
-  # Контракты панели, которые не проверяются ни типами, ни сборкой bundle:
+  # Ранние контракты панели, которые не требуют установленных зависимостей:
  # цвет иконок в спрайте, совпадение словарей локализации, соответствие кодов
  # ошибок серверным константам, единственность адреса атрибуции.
  #
@@ -80,8 +80,8 @@ run_frontend_tests() {
  "$BUN_BIN" test tools/test/frontend-sprite.test.ts tools/test/frontend-contract.test.ts \
    || fail "HY2XS admin frontend contract tests failed"

-  FRONTEND_TESTS_PASSED="true"
-  export FRONTEND_TESTS_PASSED
+  FRONTEND_CONTRACT_TESTS_PASSED="true"
+  export FRONTEND_CONTRACT_TESTS_PASSED
 }

 run_admin_tests() {
@@ -146,6 +146,9 @@ build_orchestrator() {
 bundle_ui() {
  local ui_src="${UI_SRC:-apps}"

+  [ "${FRONTEND_CONTRACT_TESTS_PASSED:-false}" = "true" ] \
+    || fail "bundle_ui: ранние контракты панели не проверялись"
+
  rm -rf "$ADMIN_BUILD_DIR"
  mkdir -p "$ADMIN_BUILD_DIR"

@@ -164,6 +167,12 @@ bundle_ui() {

    "$PNPM_BIN" install --frozen-lockfile

+    # Словари являются JavaScript-объектами и компилируются vue-i18n только
+    # при вызове t(). Поэтому ни vue-tsc, ни Vite не видят синтаксическую
+    # ошибку сообщения. Gate использует тот же установленный runtime, обходит
+    # все строки обоих языков и выполняется до typecheck и production bundle.
+    "$BUN_BIN" test test/i18n-runtime.test.ts
+
    # Проверка типов идёт ПЕРЕД сборкой bundle, и это обязательный шаг релиза.
    #
    # Раньше её здесь не было вовсе: `build:prod` означал
@@ -176,7 +185,7 @@ bundle_ui() {
    # кода, который не проходит проверку типов, нет.
    "$PNPM_BIN" run typecheck
    "$PNPM_BIN" run build:prod
-  )
+  ) || fail "HY2XS admin frontend runtime tests or bundle failed"

  # Версия админки приходит из versions.env через ldflags: один и тот же
  # исполняемый файл обязан знать версию пакета, из которого он собран.
@@ -196,6 +205,12 @@ bundle_ui() {
    mkdir -p "$STAGE_DIR/ui/hy2xs-admin/docs/sql"
    install -m 0644 "$ui_src/docs/sql/schema.sql" "$STAGE_DIR/ui/hy2xs-admin/docs/sql/schema.sql"
  fi
+
+  # Оба утверждения выставляются только после dependency-free контрактов,
+  # runtime-компиляции словарей и успешной сборки production bundle.
+  FRONTEND_RUNTIME_TESTS_PASSED="true"
+  FRONTEND_TESTS_PASSED="true"
+  export FRONTEND_RUNTIME_TESTS_PASSED FRONTEND_TESTS_PASSED
 }

 write_metadata() {
@@ -17,6 +17,13 @@ import {
  ADMIN_USERNAME_PATTERN,
  isValidAdminPassword,
 } from "../../apps/frontend/src/constants/credentials";
+import {
+  PEER_NAME_CHARSET,
+  PEER_NAME_MAX_LENGTH,
+  PEER_NAME_MIN_LENGTH,
+  PEER_NAME_PATTERN,
+  PEER_NAME_PUNCTUATION,
+} from "../../apps/frontend/src/constants/peer";
 import ru from "../../apps/frontend/src/lang/package/ru";
 import en from "../../apps/frontend/src/lang/package/en";

@@ -310,9 +317,9 @@ describe("страницы журнала", () => {

    // Без width/min-width Element Plus делит ширину практически поровну, и
    // сообщение — единственное содержимое журнала — получает треть строки.
-    const columns = [...viewer.matchAll(/<el-table-column[\s\S]*?(?:\/>|>)/g)].map(
-      (match) => match[0]
-    );
+    const columns = [
+      ...viewer.matchAll(/<el-table-column[\s\S]*?(?:\/>|>)/g),
+    ].map((match) => match[0]);
    expect(columns.length).toBeGreaterThanOrEqual(3);
    for (const column of columns) {
      expect(column).toMatch(/\b(width|min-width)=/);
@@ -408,7 +415,9 @@ describe("действия над пиром", () => {
    // вызов здесь больше не стоит, обязан называть его по имени — иначе он
    // бесполезен. Это тот же урок, что записан в code_without_comments в
    // acceptance.sh, и он повторился прямо на этой проверке.
-    const confirms = [...codeOf(peerList()).matchAll(/ElMessageBox\.confirm\(/g)];
+    const confirms = [
+      ...codeOf(peerList()).matchAll(/ElMessageBox\.confirm\(/g),
+    ];
    // Единственный вызов — внутри confirmAction, который переводит отмену в
    // обычное `false`.
    expect(confirms.length).toBe(1);
@@ -523,7 +532,9 @@ describe("страница конфигурации Hysteria", () => {
    // Сам модуль view-модели удалён вместе с дефолтами: пока он существует,
    // его легко подключить обратно.
    expect(
-      fs.existsSync(path.join(FRONTEND_SRC, "api", "config", "hysteriaViewModel.ts"))
+      fs.existsSync(
+        path.join(FRONTEND_SRC, "api", "config", "hysteriaViewModel.ts")
+      )
    ).toBe(false);
  });

@@ -532,7 +543,12 @@ describe("страница конфигурации Hysteria", () => {
  test("страница не изображает редактируемую форму", () => {
    const source = vueCodeOf(configPage());

-    for (const editable of ["<el-input", "<el-switch", "<el-select", "v-model"]) {
+    for (const editable of [
+      "<el-input",
+      "<el-switch",
+      "<el-select",
+      "v-model",
+    ]) {
      expect(source).not.toContain(editable);
    }
  });
@@ -606,7 +622,15 @@ describe("страница конфигурации Hysteria", () => {
    expect(types).not.toMatch(/\bsecret\s*[?]?:/);
    // Секции, которых production-профиль не описывает, в модели ответа не
    // объявляются вовсе: они попадают в `drift` списком имён.
-    for (const section of ["outbounds", "masquerade", "resolver", "sniff", "acl", "mimic", "realm"]) {
+    for (const section of [
+      "outbounds",
+      "masquerade",
+      "resolver",
+      "sniff",
+      "acl",
+      "mimic",
+      "realm",
+    ]) {
      expect(types).not.toContain(`${section}:`);
    }
  });
@@ -651,10 +675,14 @@ describe("страница конфигурации Hysteria", () => {
  // существуют, «универсальный редактор Hysteria» отрастает заново.
  test("компоненты генерического редактора удалены", () => {
    for (const component of ["MapAdd", "ImputMultiple", "UnitSelect"]) {
-      expect(fs.existsSync(path.join(FRONTEND_SRC, "components", component))).toBe(false);
+      expect(
+        fs.existsSync(path.join(FRONTEND_SRC, "components", component))
+      ).toBe(false);
    }
    expect(
-      fs.existsSync(path.join(FRONTEND_SRC, "views", "hysteria", "list", "components"))
+      fs.existsSync(
+        path.join(FRONTEND_SRC, "views", "hysteria", "list", "components")
+      )
    ).toBe(false);
  });
 });
@@ -701,7 +729,9 @@ describe("контракт учётных данных администрато
    if (numeric) {
      return numeric[1];
    }
-    const backticked = source.match(new RegExp(`\\b${name}\\s*=\\s*\`([^\`]*)\``));
+    const backticked = source.match(
+      new RegExp(`\\b${name}\\s*=\\s*\`([^\`]*)\``)
+    );
    if (backticked) {
      return backticked[1];
    }
@@ -716,22 +746,37 @@ describe("контракт учётных данных администрато
  // принял бы, и оператор остаётся снаружи с паролем, который на самом деле
  // подходит.
  test("границы и набор символов совпадают с Go-контрактом", () => {
-    expect(String(ADMIN_USERNAME_MIN_LENGTH)).toBe(goConst("AdminUsernameMinLength"));
-    expect(String(ADMIN_USERNAME_MAX_LENGTH)).toBe(goConst("AdminUsernameMaxLength"));
-    expect(String(ADMIN_PASSWORD_MIN_LENGTH)).toBe(goConst("AdminPasswordMinLength"));
-    expect(String(ADMIN_PASSWORD_MAX_LENGTH)).toBe(goConst("AdminPasswordMaxLength"));
+    expect(String(ADMIN_USERNAME_MIN_LENGTH)).toBe(
+      goConst("AdminUsernameMinLength")
+    );
+    expect(String(ADMIN_USERNAME_MAX_LENGTH)).toBe(
+      goConst("AdminUsernameMaxLength")
+    );
+    expect(String(ADMIN_PASSWORD_MIN_LENGTH)).toBe(
+      goConst("AdminPasswordMinLength")
+    );
+    expect(String(ADMIN_PASSWORD_MAX_LENGTH)).toBe(
+      goConst("AdminPasswordMaxLength")
+    );
    // Предел bcrypt — отдельная константа и отдельная сверка. Пока панель знала
    // только границу в символах, она предлагала оператору назначить пароль из
    // 64 кириллических букв (128 байт), сервер его принимал всеми проверками, а
    // хеширование отказывало — и оператор получал системную ошибку на штатной
    // смене пароля.
-    expect(String(ADMIN_PASSWORD_MAX_BYTES)).toBe(goConst("AdminPasswordMaxBytes"));
+    expect(String(ADMIN_PASSWORD_MAX_BYTES)).toBe(
+      goConst("AdminPasswordMaxBytes")
+    );
    expect(ADMIN_USERNAME_CHARSET).toBe(goConst("AdminUsernameCharset"));

    const declared = goConst("adminUsernameCharacterClass");
    const mirrored = ADMIN_USERNAME_PATTERN.source
      .replace(/^\^\[/, "")
-      .replace(new RegExp(`\\]\\{${ADMIN_USERNAME_MIN_LENGTH},${ADMIN_USERNAME_MAX_LENGTH}\\}\\$$`), "");
+      .replace(
+        new RegExp(
+          `\\]\\{${ADMIN_USERNAME_MIN_LENGTH},${ADMIN_USERNAME_MAX_LENGTH}\\}\\$$`
+        ),
+        ""
+      );
    expect(mirrored).toBe(declared);
  });

@@ -781,9 +826,8 @@ describe("контракт учётных данных администрато
  // Встроенных границ на пароле поэтому быть не должно вовсе: длина
  // принадлежит правилу, а не соседям по объекту.
  test("на пароле нет встроенных min/max от async-validator", async () => {
-    const { adminPasswordFormRule } = await import(
-      "../../apps/frontend/src/constants/credentials"
-    );
+    const { adminPasswordFormRule } =
+      await import("../../apps/frontend/src/constants/credentials");

    // Правило одно на обе формы, и границ как СВОЙСТВ правила у него нет: длина
    // живёт внутри валидатора, где её можно посчитать правильно.
@@ -810,8 +854,12 @@ describe("контракт учётных данных администрато
  test("правило пароля считает code points и байты, а не UTF-16", () => {
    // Проверка самой таблицы: если «я» перестанет быть двухбайтовой, случаи
    // ниже проверяли бы не то, что написано.
-    expect(new TextEncoder().encode("я".repeat(36)).length).toBe(ADMIN_PASSWORD_MAX_BYTES);
-    expect(new TextEncoder().encode("😀".repeat(18)).length).toBe(ADMIN_PASSWORD_MAX_BYTES);
+    expect(new TextEncoder().encode("я".repeat(36)).length).toBe(
+      ADMIN_PASSWORD_MAX_BYTES
+    );
+    expect(new TextEncoder().encode("😀".repeat(18)).length).toBe(
+      ADMIN_PASSWORD_MAX_BYTES
+    );

    for (const accepted of [
      "a".repeat(ADMIN_PASSWORD_MIN_LENGTH),
@@ -854,7 +902,9 @@ describe("контракт учётных данных администрато
    // Соседи запрещённых диапазонов обязаны проходить: правило описывает ровно
    // множество systemd, а не окрестность подозрительных значений.
    for (const accepted of [0xfdcf, 0xfdf0, 0xfffd, 0x10fffd]) {
-      expect(isValidAdminPassword(`abcde${String.fromCodePoint(accepted)}`)).toBe(true);
+      expect(
+        isValidAdminPassword(`abcde${String.fromCodePoint(accepted)}`)
+      ).toBe(true);
    }

    // Именно тот случай, ради которого встроенные min/max убраны: три эмодзи —
@@ -868,9 +918,8 @@ describe("контракт учётных данных администрато
  // обязательно». Сервер ведёт себя так же (DTO приводит пустой пароль к «не
  // задано» до проверки правил).
  test("пустой пароль остаётся на правиле required", async () => {
-    const { adminPasswordFormRule } = await import(
-      "../../apps/frontend/src/constants/credentials"
-    );
+    const { adminPasswordFormRule } =
+      await import("../../apps/frontend/src/constants/credentials");
    const rule = adminPasswordFormRule("format");

    const errors: (Error | undefined)[] = [];
@@ -886,11 +935,15 @@ describe("контракт учётных данных администрато
  test("на пароль не навешен набор символов", () => {
    for (const form of [loginForm(), changePasswordForm()]) {
      const code = vueCodeOf(form);
-      expect(code).not.toContain("ADMIN_USERNAME_PATTERN,\n      message: t(\"credentials.passwordFormat\"");
+      expect(code).not.toContain(
+        'ADMIN_USERNAME_PATTERN,\n      message: t("credentials.passwordFormat"'
+      );
      expect(code).not.toMatch(/passwordPattern/);
    }
    // Правило логина — единственное место, где вообще упоминается набор.
-    expect(vueCodeOf(changePasswordForm())).not.toContain("ADMIN_USERNAME_PATTERN");
+    expect(vueCodeOf(changePasswordForm())).not.toContain(
+      "ADMIN_USERNAME_PATTERN"
+    );
  });

  // Требование НАЗЫВАЕТСЯ, а не сообщается фактом нарушения: набор символов
@@ -917,7 +970,8 @@ describe("контракт учётных данных администрато
      for (const placeholder of ["{min}", "{max}", "{charset}"]) {
        expect(reason).toContain(placeholder);
      }
-      const passwordReason = (dictionary as any).error?.code?.admin_password_format ?? "";
+      const passwordReason =
+        (dictionary as any).error?.code?.admin_password_format ?? "";
      for (const placeholder of ["{min}", "{max}", "{maxBytes}"]) {
        expect(passwordReason).toContain(placeholder);
      }
@@ -944,11 +998,15 @@ describe("индикация ошибки на форме входа", () => {
    const styles = loginForm();

    // Индикация переехала на элемент, который оператор и видит полем.
-    expect(styles).toMatch(/&\.is-error\s*\{[\s\S]*?border-color:\s*var\(--el-color-danger\)/);
+    expect(styles).toMatch(
+      /&\.is-error\s*\{[\s\S]*?border-color:\s*var\(--el-color-danger\)/
+    );

    // Штатная тень враппера гасится селектором, который повторяет чужой и
    // добавляет атрибут scoped-стиля, — то есть выигрывает по специфичности.
-    expect(styles).toContain(":deep(.el-form-item__content .el-input__wrapper)");
+    expect(styles).toContain(
+      ":deep(.el-form-item__content .el-input__wrapper)"
+    );

    // Победа специфичностью, а не силой: `!important` перекрыл бы и те
    // состояния, о которых правило ничего не знает.
@@ -966,27 +1024,128 @@ describe("индикация ошибки на форме входа", () => {
 });

 describe("подсказки формы пира", () => {
+  const peerContract = () =>
+    fs.readFileSync(
+      path.join(REPO_ROOT, "apps", "service", "peer_import.go"),
+      "utf8"
+    );
+
+  function peerGoConst(name: string): string {
+    const source = peerContract();
+    const numeric = source.match(new RegExp(`\\b${name}\\s*=\\s*(\\d+)`));
+    if (numeric) {
+      return numeric[1];
+    }
+    const backticked = source.match(
+      new RegExp(`\\b${name}\\s*=\\s*\`([^\`]*)\``)
+    );
+    if (backticked) {
+      return backticked[1];
+    }
+    throw new Error(
+      `константа ${name} не найдена в apps/service/peer_import.go`
+    );
+  }
+
+  test("frontend-контракт совпадает с серверным", () => {
+    expect(String(PEER_NAME_MIN_LENGTH)).toBe(peerGoConst("PeerNameMinLength"));
+    expect(String(PEER_NAME_MAX_LENGTH)).toBe(peerGoConst("PeerNameMaxLength"));
+    expect(PEER_NAME_CHARSET).toBe(peerGoConst("PeerNameCharset"));
+    expect(PEER_NAME_CHARSET.split(/\s+/).at(-1)).toBe(PEER_NAME_PUNCTUATION);
+
+    const declaredPattern = peerContract().match(
+      /peerNamePattern\s*=\s*regexp\.MustCompile\(`([^`]+)`\)/
+    );
+    expect(declaredPattern).not.toBeNull();
+    expect(PEER_NAME_PATTERN.source).toBe(declaredPattern![1]);
+  });
+
+  test("форма использует общий контракт без собственных копий", () => {
+    const form = readSource("views", "peer", "list", "index.vue");
+    expect(form).toContain("@/constants/peer");
+    expect(form).toContain("pattern: PEER_NAME_PATTERN");
+    expect(form).toContain("min: PEER_NAME_MIN_LENGTH");
+    expect(form).toContain("max: PEER_NAME_MAX_LENGTH");
+    expect(form).toContain("charset: PEER_NAME_CHARSET");
+    expect(form).toContain("punctuation: PEER_NAME_PUNCTUATION");
+    expect(form).not.toMatch(/const\s+PEER_NAME_PATTERN\s*=/);
+    expect(form).not.toContain('charset: "a-z A-Z 0-9');
+  });
+
  // Подсказка обещала более узкий набор символов, чем принимает сервер: она
  // осталась от правила, действовавшего до EX-03. Оператор не имел причин
  // пробовать разрешённые символы.
  test("подсказка имени описывает действующий набор символов", () => {
    // Набор символов объявлен на сервере ровно один раз; подсказка обязана
    // описывать именно его, а не набор из предыдущего поколения правила.
-    const rule = fs.readFileSync(
-      path.join(REPO_ROOT, "apps", "service", "peer_import.go"),
-      "utf8"
-    );
-    const declared = rule.match(/PeerNameCharset\s*=\s*`([^`]+)`/);
-    expect(declared).not.toBeNull();
-
-    // «a-z A-Z 0-9 !@#$%^&*()_+-=» -> «!@#$%^&*()_+-=»
-    const punctuation = declared![1].split(/\s+/).at(-1)!;
-    expect(punctuation).toContain("!@#");
+    expect(PEER_NAME_PUNCTUATION).toContain("!@#");

    for (const dictionary of [ru, en] as const) {
      const hint = (dictionary as any).peer?.form?.nameHint ?? "";
-      expect(hint).toContain(punctuation);
-      expect(hint).toContain("32");
+      expect(hint).toContain("{punctuation}");
+      expect(hint).toContain("{min}");
+      expect(hint).toContain("{max}");
+      expect(hint).not.toContain(PEER_NAME_PUNCTUATION);
+      expect(hint).not.toContain(
+        `${PEER_NAME_MIN_LENGTH} to ${PEER_NAME_MAX_LENGTH}`
+      );
+      expect(hint).not.toContain(
+        `от ${PEER_NAME_MIN_LENGTH} до ${PEER_NAME_MAX_LENGTH}`
+      );
+    }
+  });
+});
+
+describe("контракт Element Plus", () => {
+  test("radio-компоненты не используют label как value", () => {
+    const deprecated: string[] = [];
+
+    for (const file of sourceFiles(FRONTEND_SRC).filter((candidate) =>
+      candidate.endsWith(".vue")
+    )) {
+      const source = fs.readFileSync(file, "utf8");
+      for (const match of source.matchAll(
+        /<el-radio(?:-button)?\b[\s\S]*?>/g
+      )) {
+        const tag = match[0];
+        if (/\blabel\s*=/.test(tag) && !/\bvalue\s*=/.test(tag)) {
+          deprecated.push(`${path.relative(REPO_ROOT, file)}: ${tag}`);
+        }
+      }
+    }
+
+    expect(deprecated).toEqual([]);
+  });
+});
+
+describe("политика frontend-зависимостей", () => {
+  test("security overrides находятся в читаемой pnpm конфигурации", () => {
+    const manifest = JSON.parse(
+      fs.readFileSync(
+        path.join(REPO_ROOT, "apps", "frontend", "package.json"),
+        "utf8"
+      )
+    ) as Record<string, unknown>;
+    expect(manifest.pnpm).toBeUndefined();
+
+    const workspace = fs.readFileSync(
+      path.join(REPO_ROOT, "apps", "frontend", "pnpm-workspace.yaml"),
+      "utf8"
+    );
+    expect(workspace).toMatch(/^overrides:/m);
+    for (const [dependency, resolution] of Object.entries({
+      lodash: ">=4.18.1",
+      "lodash-es": ">=4.18.1",
+      "brace-expansion": ">=1.1.18",
+      picomatch: ">=2.3.2",
+      "js-yaml": ">=4.3.1",
+      "table>ajv": ">=8.18.0",
+      browserslist: "4.28.7",
+    })) {
+      const dependencyKey = dependency.includes(">")
+        ? `"${dependency}"`
+        : dependency;
+      expect(workspace).toContain(`${dependencyKey}: "${resolution}"`);
    }
  });
 });
Author	SHA1	Message	Date
Crimson	b7e478f014	fix(rc5): harden frontend runtime and diagnostics	2026-09-08 05:22:06 +05:00
Crimson	079094591b	fix(installer): harden admin smoke and rollback cleanup	2026-09-07 22:39:30 +05:00