HY2XS_flamy/orchestrator/test/clean-host.test.ts

import { describe, expect, test } from "bun:test";
import {
  assertCleanHost,
  detectLegacyMarkers,
  legacyMarkersFor,
  renderLegacyFailure,
  type HostProbe
} from "../src/steps/cleanHost";
import { baselineConfig } from "./fixtures";

/**
 * Проба, которая считает «существующими» ровно переданный набор целей.
 * Это позволяет проверить контракт чистого хоста без файловой системы.
 */
function probeWith(present: readonly string[]): HostProbe {
  const set = new Set(present);
  return {
    async fileExists(path) {
      return set.has(path);
    },
    async dirExists(path) {
      return set.has(path);
    },
    async unitExists(unit) {
      return set.has(unit);
    }
  };
}

const config = baselineConfig();

describe("clean-host контракт", () => {
  test("чистый хост проходит", async () => {
    await expect(assertCleanHost(config, "bootstrap", probeWith([]))).resolves.toBeUndefined();
  });

  test("каждый маркер по отдельности останавливает установку", async () => {
    const markers = legacyMarkersFor(config, "bootstrap");
    expect(markers.length).toBeGreaterThan(10);

    for (const marker of markers) {
      const probe = probeWith([marker.target]);
      await expect(assertCleanHost(config, "bootstrap", probe)).rejects.toThrow(
        /предыдущая или посторонняя установка/
      );
    }
  });

  test("список покрывает состояние, юниты, бинарник и наследие 0.x", () => {
    const targets = legacyMarkersFor(config, "bootstrap").map((marker) => marker.target);

    for (const expected of [
      "/etc/hysteria/post-install.env",
      "/etc/hy2xs/hy2xs.env",
      "/var/lib/hy2xs/install-state.json",
      "/etc/hy2xs/bootstrap-admin.secret",
      "/usr/local/lib/hy2xs/package",
      "/usr/local/lib/hy2xs",
      "/usr/local/bin/hy2xs-orchestrator",
      "/etc/hysteria/config.yaml",
      "/usr/local/bin/hysteria",
      "/var/lib/hysteria",
      "/etc/nftables.d/hy2xs.nft",
      "hy2xs-admin.service",
      "hysteria-server.service",
      "h-ui.service",
      "/usr/local/h-ui",
      config.installDir,
      config.dataDir,
      config.logDir
    ]) {
      expect(targets).toContain(expected);
    }
  });

  /**
   * purge-v0.sh и clean-host обязаны описывать одну и ту же границу.
   *
   * Регрессия: purge удалял /var/lib/hysteria, /var/log/hy2xs,
   * /usr/local/lib/hy2xs и /usr/local/bin/hy2xs-orchestrator, а clean-host их
   * не проверял. Сервер, где остался только старый ACME-state Hysteria,
   * проходил проверку и получал свежую установку поверх чужого runtime.
   */
  test("всё, что удаляет purge-v0.sh, проверяется clean-host контрактом", () => {
    const purgedPaths = [
      "/etc/hy2xs",
      "/etc/hysteria",
      "/var/lib/hy2xs",
      "/var/lib/hy2xs-admin",
      "/var/lib/hysteria",
      "/var/log/hy2xs",
      "/opt/hy2xs-admin",
      "/usr/local/lib/hy2xs",
      "/usr/local/h-ui",
      "/usr/local/bin/hy2xs-orchestrator",
      "/usr/local/bin/hysteria",
      "/etc/nftables.d/hy2xs.nft"
    ];
    const targets = legacyMarkersFor(config, "bootstrap").map((marker) => marker.target);

    for (const purged of purgedPaths) {
      const covered = targets.some((target) => target === purged || target.startsWith(`${purged}/`));
      expect(covered, `purge удаляет ${purged}, но clean-host его не проверяет`).toBe(true);
    }
  });

  /**
   * Пути, которые install.sh законно создаёт между фазами, обязаны быть
   * маркером в PHASE 0 и перестать им быть в PHASE 1 — иначе установка
   * отказала бы на собственном, только что разложенном оркестраторе.
   */
  test("пути, созданные install.sh между фазами, не блокируют PHASE 1", async () => {
    for (const target of [
      "/usr/local/lib/hy2xs",
      "/usr/local/lib/hy2xs/package",
      "/usr/local/bin/hy2xs-orchestrator"
    ]) {
      const probe = probeWith([target]);
      await expect(assertCleanHost(config, "bootstrap", probe)).rejects.toThrow(
        /предыдущая или посторонняя установка/
      );
      await expect(assertCleanHost(config, "install", probe)).resolves.toBeUndefined();
    }
  });

  test("пути из конфигурации попадают в список, а не только дефолтные", () => {
    const custom = baselineConfig({
      HY2XS_INSTALL_DIR: "/srv/hy2xs-app",
      HY2XS_DATA_DIR: "/srv/hy2xs-data"
    });
    const targets = legacyMarkersFor(custom, "bootstrap").map((marker) => marker.target);
    expect(targets).toContain("/srv/hy2xs-app");
    expect(targets).toContain("/srv/hy2xs-data");
  });

  // install.sh раскладывает runtime-пакет между фазами, поэтому в PHASE 1
  // этот путь уже наш и маркером быть не может.
  test("runtime-пакет — маркер в PHASE 0, но не в PHASE 1", async () => {
    const probe = probeWith(["/usr/local/lib/hy2xs/package"]);
    await expect(assertCleanHost(config, "bootstrap", probe)).rejects.toThrow(/usr\/local\/lib\/hy2xs\/package/);
    await expect(assertCleanHost(config, "install", probe)).resolves.toBeUndefined();
  });

  test("остальные маркеры продолжают работать и в PHASE 1", async () => {
    const probe = probeWith(["hysteria-server.service"]);
    await expect(assertCleanHost(config, "install", probe)).rejects.toThrow(/hysteria-server\.service/);
  });

  test("сообщение перечисляет все найденные маркеры и говорит, что хост не изменён", async () => {
    const found = await detectLegacyMarkers(
      legacyMarkersFor(config, "bootstrap"),
      probeWith(["/etc/hy2xs/hy2xs.env", "hy2xs-admin.service"])
    );
    expect(found).toHaveLength(2);

    const message = renderLegacyFailure(found);
    expect(message).toContain("/etc/hy2xs/hy2xs.env");
    expect(message).toContain("hy2xs-admin.service");
    expect(message).toContain("Ни один файл на сервере не изменён");
    expect(message).toContain("docs/14-legacy-cleanup.md");
  });
});