Files
hermes-agent/evals/desktop_bug_campaign/linux_launcher_probe.py
ethernet 284dbaf537 fix(pm): isolate bootstrap dependencies and unify YAML on ruamel
Activation reaches plugin discovery before the application dependencies
exist. Give PM its own locked Python project and runtime so it can install
or repair the application without importing that dependency tree.

Keep PM outside the application workspace. A shared uv workspace resolves
the application graph and cannot provide this isolation. Route mutations
through an isolated worker and preserve transaction callbacks, cancellation,
custom package registrations, and correlated receipts.

Use the same runtime builder for source installs and packaged payloads.
Keep offline wheelhouse support in that builder. Nix builds the independent
PM lock as a separate derivation. Refuse lazy-disabled bootstrap before
installing tools or dependencies.

Move first-party YAML readers and writers to ruamel. Keep the application
lock's transitive PyYAML requirements for third-party packages.

Verification:
- Focused canonical Python suite: 177 passed, 1 host-gated skip.
- Electron backend probes: 12 passed. Electron typecheck passed.
- Both uv locks, scoped lint, Bash syntax, and whitespace checks passed.
- Cold activation, corrupt-app repair, offline staging, and relocation ran.
- Built and exercised the Nix PM runtime and standalone YAML merge script.

Six broader caller test files retain the same 24 failing test IDs as an
archive of HEAD. The existing real-home guard blocks those tests before
they can exercise the affected paths. No full-suite pass is claimed.
Native Windows signing and full Bionic package execution remain unverified.
2026-09-11 12:23:51 -04:00

83 lines
4.1 KiB
Python

"""Real Linux venv/XDG I/O probe; help-launch is NOT a native UI proof."""
import argparse
import json
import os
from pathlib import Path
import shlex
import subprocess
import sys
import tempfile
import venv
def run(argv, env, cwd):
result = subprocess.run(argv, env=env, cwd=cwd, stdin=subprocess.DEVNULL,
capture_output=True, text=True, timeout=60)
return {"argv": argv, "returncode": result.returncode,
"stdout": result.stdout, "stderr": result.stderr}
def main():
parser = argparse.ArgumentParser()
parser.add_argument("repo", type=Path)
parser.add_argument("output", type=Path)
parser.add_argument("--source-sha", help="Provenance for a git-archived checkout")
args = parser.parse_args()
repo = args.repo.resolve()
args.output.mkdir(parents=True, exist_ok=True)
root = Path(tempfile.mkdtemp(prefix="linux-launcher-", dir=args.output))
env = {"PATH": "/usr/bin:/bin", "HOME": str(root / "home"),
"HERMES_HOME": str(root / "home/.hermes"),
"XDG_DATA_HOME": str(root / "xdg"), "LANG": "C.UTF-8",
"HERMES_NONINTERACTIVE": "1"}
Path(env["HERMES_HOME"]).mkdir(parents=True)
venv_dir = root / "venv"
venv.EnvBuilder(with_pip=False, symlinks=True).create(venv_dir)
python = venv_dir / "bin/python"
# Reuse dependencies read-only; put the tested checkout before its editable install.
site = next(venv_dir.glob("lib/python*/site-packages"))
dependencies = Path(sys.prefix) / f"lib/python{sys.version_info.major}.{sys.version_info.minor}/site-packages"
(site / "probe.pth").write_text(str(repo) + "\n" + str(dependencies) + "\n")
assert python.is_symlink() and python.resolve() != python
install = (
"import sys,json; from pathlib import Path; "
"from hermes_cli.linux_desktop_entry import install_desktop_entry; "
f"sys.argv[0]={str(repo / 'hermes')!r}; "
f"p=install_desktop_entry(Path({str(repo)!r})); "
"print(json.dumps({'path':str(p),'text':p.read_text(),'python':sys.executable}))"
)
rows: dict = {"source_sha": args.source_sha or subprocess.check_output(["git", "rev-parse", "HEAD"], cwd=repo, text=True).strip(),
"root": str(root), "lexical_python": str(python), "base_python": str(python.resolve())}
rows["venv_import"] = run([str(python), "-I", "-c", "import ruamel.yaml,hermes_cli.main; print(ruamel.yaml.__version__)"], env, "/")
rows["base_import_negative"] = run([str(python.resolve()), "-I", "-c", "import ruamel.yaml,hermes_cli.main"], env, "/")
rows["install"] = run([str(python), "-c", install], env, "/")
assert rows["install"]["returncode"] == 0, rows["install"]
installed = json.loads(rows["install"]["stdout"].splitlines()[-1])
entry = Path(installed["path"])
exec_line = next(x[5:] for x in installed["text"].splitlines() if x.startswith("Exec="))
argv = shlex.split(exec_line)
assert str(python.resolve()) not in argv
# Exercise the generated command's real CLI imports without invoking npm/build.
rows["generated_exec_help"] = run([*argv, "--help"], env, "/")
original = entry.read_bytes()
rows["second_install"] = run([str(python), "-c", install], env, "/")
rows["stable_rewrite"] = entry.read_bytes() == original
custom = original.replace(b"Name=Hermes\n", b"Name=Hermes custom\n").replace(b"Terminal=false", b"Terminal=true")
entry.write_bytes(custom)
config = Path(env["HERMES_HOME"]) / "config.yaml"
config.write_text("desktop:\n manage_launcher_entry: false\n")
rows["custom_install"] = run([str(python), "-c", install], env, "/")
rows["custom_preserved"] = entry.read_bytes() == custom
rows["generated_exec"] = exec_line
rows["fidelity"] = "real venv, native Linux XDG installer, real generated argv --help; NOT Electron window/menu-click proof"
(args.output / "probe.json").write_text(json.dumps(rows, indent=2))
print(json.dumps(rows, indent=2))
assert rows["venv_import"]["returncode"] == 0
assert rows["base_import_negative"]["returncode"] != 0
assert rows["generated_exec_help"]["returncode"] == 0
assert rows["stable_rewrite"]
if __name__ == "__main__":
main()