hermes-agent/tests/scripts/install/test_install_diverged_rescue_ref.py

124 lines
4.7 KiB
Python

"""Regression: the installer's update reset must not drop local commits unanchored.
Re-running ``install.sh`` / ``install.ps1`` over an existing checkout (desktop
bootstrap and its update retry do this) falls back to
``reset --hard origin/<branch>`` when a fast-forward fails. Commits made on that
branch must survive behind a ``refs/hermes-update-backups/`` rescue ref, the same
namespace ``hermes update`` uses, and the installer must print the ref.
"""
from __future__ import annotations
import json
import os
import shutil
import subprocess
from pathlib import Path
import pytest
REPO_ROOT = Path(__file__).resolve().parent.parent.parent.parent
INSTALL_SH = REPO_ROOT / "scripts" / "install.sh"
INSTALL_PS1 = REPO_ROOT / "scripts" / "install.ps1"
POWERSHELL = next(
(candidate for candidate in ("pwsh", "powershell") if shutil.which(candidate)),
None,
)
def _git(cwd: Path, *args: str) -> str:
return subprocess.run(
["git", "-c", "user.email=t@t", "-c", "user.name=t", *args],
cwd=cwd, check=True, capture_output=True, text=True,
).stdout.strip()
def _commit(repo: Path, name: str) -> str:
(repo / name).write_text(f"{name}\n", encoding="utf-8")
_git(repo, "add", name)
_git(repo, "commit", "-q", "-m", f"add {name}")
return _git(repo, "rev-parse", "HEAD")
def _diverged_managed_checkout(tmp_path: Path) -> tuple[Path, str]:
"""A managed checkout on ``main`` with one local commit, while its origin moved on."""
upstream = tmp_path / "upstream"
upstream.mkdir()
_git(upstream, "init", "-q", "-b", "main")
_commit(upstream, "shared.txt")
managed = tmp_path / "hermes-agent"
_git(tmp_path, "clone", "-q", str(upstream), str(managed))
local_sha = _commit(managed, "local-fix.txt")
_commit(upstream, "upstream-only.txt")
return managed, local_sha
def _assert_local_commit_parked(repo: Path, local_sha: str, output: str) -> None:
assert _git(repo, "rev-parse", "HEAD") == _git(repo, "rev-parse", "origin/main")
refs = dict(
line.split()[::-1] for line in _git(
repo, "for-each-ref", "--format=%(refname) %(objectname)",
"refs/hermes-update-backups/").splitlines())
ref = refs.get(local_sha)
assert ref and ref.startswith("refs/hermes-update-backups/diverged-main-"), refs
assert ref in output, "the installer must print where the commits went"
assert _git(repo, "log", "--format=%H", f"origin/main..{ref}").split() == [local_sha]
@pytest.mark.live_system_guard_bypass
@pytest.mark.skipif(
shutil.which("git") is None or shutil.which("bash") is None,
reason="needs git and bash",
)
def test_install_sh_repository_stage_parks_local_commits_before_reset(tmp_path: Path) -> None:
managed, local_sha = _diverged_managed_checkout(tmp_path)
env = os.environ | {
"HERMES_HOME": str(tmp_path / "hermes-home"),
"HERMES_INSTALL_DIR": str(managed),
}
result = subprocess.run(
["bash", str(INSTALL_SH), "--stage", "repository", "--non-interactive"],
cwd=tmp_path, env=env, capture_output=True, text=True,
)
assert result.returncode == 0, result.stderr
_assert_local_commit_parked(managed, local_sha, result.stdout + result.stderr)
@pytest.mark.live_system_guard_bypass
@pytest.mark.skipif(
shutil.which("git") is None or POWERSHELL is None,
reason="needs git and PowerShell",
)
def test_install_ps1_repository_stage_parks_local_commits_before_reset(tmp_path: Path) -> None:
managed, local_sha = _diverged_managed_checkout(tmp_path)
env = os.environ.copy()
if os.name != "nt":
# pwsh on POSIX cannot execute the Windows-only pinned Git archive.
# Seed its exact PM store slot with the real host Git, then invoke the
# unchanged repository stage. Native Windows tests stage the actual pin.
lock = json.loads((REPO_ROOT / "pm" / "lock.json").read_text(encoding="utf-8"))
version = lock["packages"]["git"]["version"]
store = tmp_path / "tools"
cmd = store / f"git-{version}-win32-x64" / "cmd"
cmd.mkdir(parents=True)
git = shutil.which("git")
assert git is not None
(cmd / "git.exe").symlink_to(git)
(cmd / "git").symlink_to(git)
env["HERMES_RUNTIME_DIR"] = str(store)
env["PATH"] = str(cmd) + os.pathsep + env["PATH"]
result = subprocess.run(
[
POWERSHELL, "-NoProfile", "-File", str(INSTALL_PS1),
"-Stage", "repository", "-NonInteractive",
"-InstallDir", str(managed),
"-HermesHome", str(tmp_path / "hermes-home"),
],
cwd=tmp_path, env=env, capture_output=True, text=True,
)
assert result.returncode == 0, result.stdout + result.stderr
_assert_local_commit_parked(managed, local_sha, result.stdout + result.stderr)