fix(install): сделать границу «хост изменён» настоящим инвариантом

fatal_pre_apply мог означать «хост уже изменён». install-state.json пишется
сразу после успешного preflight, до установки пакетов, но классификация
отказа его не учитывала. Падение apt-get объявлялось как «на сервере ничего
не изменено»: откат и обработка состояния пропускались, а маркер оставался на
диске и ломал следующую установку по clean-host контракту.

Ownership-флаги переформулированы с «шаг успешно завершился» на «операция
могла начать менять систему» и взводятся перед мутирующим вызовом: apt-get
умеет изменить систему и упасть. fatal_pre_apply теперь недостижим ни при
одном взведённом флаге, включая stateWritten.

Read-only guard PHASE 0 можно было обойти. Guard стоял на writeText,
writeTextAtomic, runVisible, runHidden и runRawVisible, но не на универсальном
run, через который в коде проходили и наблюдение (ss, systemctl is-active), и
настоящие мутации (useradd, install -d, mkdir, cp -a, tar). Универсального
раннера больше нет: runReadOnly/runReadOnlySecret без guard'а и runMutating*
под guard'ом, выбор — явное решение на месте вызова.

clean-host не замечал часть того, что удаляет purge. /var/lib/hysteria с
ACME-состоянием Hysteria, /var/log/hy2xs, /usr/local/lib/hy2xs и
/usr/local/bin/hy2xs-orchestrator не были маркерами: сервер, где остался
только старый runtime-state Hysteria, проходил проверку и получал свежую
установку поверх чужого состояния. Пути, которые install.sh создаёт между
фазами, помечены как созданные установщиком, иначе PHASE 1 отказала бы на
собственном оркестраторе.

purge-v0.sh --keep-hysteria-binary противоречил установщику: скрипт сохранял
/usr/local/bin/hysteria и сообщал «хост чист для установки HY2XS v1», хотя
clean-host считает этот бинарник legacy-маркером. Флаг удалён.

DNS проверялся на существование A-записи, но не на то, куда она ведёт. После
принудительной смены IPv4 провайдером doctor отвечал успехом, хотя клиентская
ссылка отправляла людей на чужую машину. Проверялся при этом HY2XS_DOMAIN,
тогда как в hysteria2:// уезжает HY2XS_PUBLIC_HOST.

Добавлен инвариант публичного endpoint: A-записи обязаны принадлежать
множеству публичных IPv4, назначенных интерфейсам этого сервера. Проверка
живёт в общем preflight, поэтому действует в install, reconfigure и doctor.
Адрес определяется локально, без внешних сервисов определения IP. Строгость
управляется HY2XS_PUBLIC_ENDPOINT_POLICY (strict по умолчанию); отсутствие
A-записи фатально при любом значении.

TS-санитайзер приведён к той же формулировке, что и Go: URL-значение
определяется по самому значению, а не по имени ключа.

orchestrator/src/config/env.ts

@@ -1,5 +1,5 @@
 import { randomBytes } from "node:crypto";
-import type { FirewallMode, RuntimeConfig, TlsMode } from "../types/context";
+import type { FirewallMode, PublicEndpointPolicy, RuntimeConfig, TlsMode } from "../types/context";
 import {
   GECKO_DEFAULT_MAX_PACKET_SIZE,
   GECKO_DEFAULT_MIN_PACKET_SIZE,
@@ -142,6 +142,19 @@ function normalizeDnsAaaaPolicy(value: string | undefined): "strict" | "warn" |
   throw new Error(`invalid HY2XS_DNS_AAAA_POLICY: ${value}`);
 }
 
+/**
+ * По умолчанию strict: молча принять DNS, ведущий на чужую машину, HY2XS не
+ * имеет права. Ослабление — осознанное решение оператора для топологий вне
+ * baseline (NAT, floating IP), а не поведение по умолчанию.
+ */
+function normalizePublicEndpointPolicy(value: string | undefined): PublicEndpointPolicy {
+  const policy = value || "strict";
+  if (policy === "strict" || policy === "warn" || policy === "off") {
+    return policy;
+  }
+  throw new Error(`invalid HY2XS_PUBLIC_ENDPOINT_POLICY: ${value}`);
+}
+
 function normalizeFixedHysteriaAuthMode(value: string | undefined): "http" {
   const mode = value || "http";
   if (mode !== "http") {
@@ -227,6 +240,7 @@ export function parseRuntimeEnv(content: string): RuntimeConfig {
     configSchemaVersion: normalizeConfigSchemaVersion(env.HY2XS_CONFIG_SCHEMA_VERSION),
     domain: env.HY2XS_DOMAIN || "",
     dnsAaaaPolicy,
+    publicEndpointPolicy: normalizePublicEndpointPolicy(env.HY2XS_PUBLIC_ENDPOINT_POLICY),
     publicHost: normalizePublicHost(env.HY2XS_PUBLIC_HOST || env.HY2XS_DOMAIN || ""),
     publicPort: parsePort("HY2XS_PUBLIC_PORT", env.HY2XS_PUBLIC_PORT, hysteriaPort),
     ipv6Enabled: parseBool("HY2XS_IPV6_ENABLED", env.HY2XS_IPV6_ENABLED, false),
@@ -339,6 +353,7 @@ export function renderRuntimeEnv(config: RuntimeConfig): string {
     `HY2XS_IPV6_ENABLED=${config.ipv6Enabled}`,
     `HY2XS_DOMAIN=${config.domain}`,
     `HY2XS_DNS_AAAA_POLICY=${config.dnsAaaaPolicy}`,
+    `HY2XS_PUBLIC_ENDPOINT_POLICY=${config.publicEndpointPolicy}`,
     `HY2XS_PUBLIC_HOST=${config.publicHost}`,
     `HY2XS_PUBLIC_PORT=${config.publicPort}`,
     `HY2XS_SSH_PORT=${config.sshPort}`,

orchestrator/src/config/profile.ts

@@ -25,6 +25,27 @@ export const HY2XS_RELEASE_LINE = 1;
 export const HY2XS_TARGET_DEBIAN_VERSION = 13;
 export const HY2XS_TARGET_ARCH = "amd64";
 
+/**
+ * Пространства имён HTTP API админки.
+ *
+ * `HYSTERIA_MACHINE_AUTH_PATH` — не внутреннее имя переменной, а runtime-контракт
+ * продукта: оркестратор записывает этот путь в /etc/hysteria/config.yaml и в
+ * post-install.env, и по нему Hysteria спрашивает у админки разрешение на
+ * подключение пира. Раньше эта строка (в терминах H UI) была размазана по
+ * шаблонам, smoke, assertions, тестам, acceptance и e2e.
+ *
+ * Значения обязаны совпадать с константами админки
+ * (apps/model/constant/api.go). Сверка выполняется на сборке шагом
+ * verify_versions_contract через tools/print-contract.ts.
+ */
+export const ADMIN_API_BASE = "/api";
+export const HYSTERIA_MACHINE_AUTH_PATH = "/internal/hysteria/auth";
+
+/** Полный machine-auth URL, который видит Hysteria. */
+export function hysteriaMachineAuthUrl(uiPort: number, machineToken: string): string {
+  return `http://127.0.0.1:${uiPort}${HYSTERIA_MACHINE_AUTH_PATH}?access_token=${machineToken}`;
+}
+
 export const HYSTERIA_OBFS_TYPES: readonly HysteriaObfsType[] = ["gecko", "salamander"];
 
 /** Тип обфускации для новой установки. Salamander остаётся compatibility fallback. */