hermes-hub/src/antigravity_provider/updater/update_manager.py

801 lines
35 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

"""Hermes Hub — Auto-Update & Integrity Verification Engine.
Features:
- Release commit comparison against main repo releases (ochenstarik-ui/hermes-hub).
- SHA-256 package cryptographic hash verification.
- Staged download without touching live executable.
- Hermetic backup and automatic rollback on corrupt/failing update.
- Non-blocking execution and honest error reporting (rate limits, 404, network errors).
- Zero embedded developer PATs (safe public asset feed / signed release manifests).
"""
from __future__ import annotations
import hashlib
import json
import logging
import os
import re
import shutil
import subprocess
import threading
import sys
import time
import urllib.error
import urllib.request
from dataclasses import dataclass, field
from pathlib import Path
from typing import Any, Callable, Dict, Optional, Tuple
from antigravity_provider import paths
from antigravity_provider.version import __version__, CHANNEL, MINIMUM_HERMES_VERSION
from antigravity_provider.agy_subprocess import hidden_process_kwargs
logger = logging.getLogger("hermes.hub.updater")
DEFAULT_RELEASES_API_URL = "https://api.github.com/repos/ochenstarik-ui/hermes-hub/releases/latest"
DEFAULT_UPDATE_URL = DEFAULT_RELEASES_API_URL
ALLOWED_UPDATE_HOSTS = {
"api.github.com",
"github.com",
"raw.githubusercontent.com",
"objects.githubusercontent.com",
"github-releases.githubusercontent.com",
}
def get_installed_build_time() -> str:
"""Время установки текущей сборки из deployment_manifest.json (поле deployed_at).
Нужно, чтобы отличать более новый релиз от более старого. Сравнение
коммитов на равенство этого не умеет: любое расхождение оно объявляет
обновлением, включая коммит-предок. Владелец нажимал «Обновить» и
получал откат программы назад.
"""
for mf in (
paths.get_repo_root() / "deployment_manifest.json",
paths.get_hermes_home() / "plugins" / "antigravity-provider" / "deployment_manifest.json",
):
try:
if mf.is_file():
data = json.loads(mf.read_text(encoding="utf-8-sig"))
val = str(data.get("deployed_at") or "").strip()
if val:
return val
except Exception as exc:
logger.debug("Не удалось прочитать %s: %s", mf, exc)
return ""
def _is_release_older(published_at: str, installed_at: str) -> bool:
"""True, если релиз опубликован раньше, чем установлена текущая сборка."""
if not published_at or not installed_at:
return False
try:
from datetime import datetime
def _parse(v: str):
return datetime.fromisoformat(v.strip().replace("Z", "+00:00"))
return _parse(published_at) < _parse(installed_at)
except Exception as exc:
logger.debug("Не удалось сравнить даты %r и %r: %s", published_at, installed_at, exc)
return False
def get_installed_commit() -> str:
"""Return currently installed git commit hash, checking deployment manifest, env, and git."""
# 1. Environment variable override
env_commit = os.environ.get("HERMES_HUB_GIT_COMMIT", "").strip()
if env_commit:
return env_commit
# 2. Check deployment_manifest.json in repo root or hermes home plugin dir
manifest_candidates = [
paths.get_repo_root() / "deployment_manifest.json",
paths.get_hermes_home() / "plugins" / "antigravity-provider" / "deployment_manifest.json",
]
for mf in manifest_candidates:
if mf.is_file():
try:
data = json.loads(mf.read_text(encoding="utf-8"))
commit = (
data.get("git_commit")
or data.get("commit")
or data.get("build_commit")
or ""
).strip()
if commit:
return commit
except Exception as e:
logger.debug("Failed reading %s: %s", mf, e)
# 3. If running in a git clone, try git rev-parse HEAD
repo_root = paths.get_repo_root()
if (repo_root / ".git").exists() or shutil.which("git"):
try:
res = subprocess.run(
["git", "rev-parse", "HEAD"],
cwd=str(repo_root),
capture_output=True,
text=True,
timeout=5,
**hidden_process_kwargs(),
)
if res.returncode == 0 and res.stdout.strip():
return res.stdout.strip()
except Exception as e:
logger.debug("git rev-parse HEAD failed: %s", e)
return "unknown"
def extract_release_commit(release_data: Dict[str, Any]) -> str:
"""Extract published git commit hash from GitHub release or manifest dictionary."""
# 1. Direct field
for key in ("git_commit", "build_commit", "commit"):
val = str(release_data.get(key) or "").strip()
if val and re.fullmatch(r"[0-9a-f]{7,40}", val, re.IGNORECASE):
return val.lower()
# 2. Check target_commitish if it is a hex SHA
target_commitish = str(release_data.get("target_commitish") or "").strip()
if re.fullmatch(r"[0-9a-f]{7,40}", target_commitish, re.IGNORECASE):
return target_commitish.lower()
# 3. Look for explicit commit markers in body or name
body = str(release_data.get("body") or "")
name = str(release_data.get("name") or "")
tag = str(release_data.get("tag_name") or "")
combined_text = f"{name}\n{tag}\n{body}"
# Specific patterns like "commit: <sha>" or "сборка <sha>" or "build: <sha>"
explicit_match = re.search(
r"(?:commit|build|сборка|rev|sha)[:\s#]+([0-9a-f]{7,40})\b",
combined_text,
re.IGNORECASE,
)
if explicit_match:
return explicit_match.group(1).lower()
# Generic SHA search in tag, name, body
for part in (tag, name, body):
m = re.search(r"\b([0-9a-f]{7,40})\b", part, re.IGNORECASE)
if m:
return m.group(1).lower()
return ""
@dataclass
class UpdateManifest:
version: str
channel: str = "stable"
minimum_hermes_version: str = MINIMUM_HERMES_VERSION
published_at: str = ""
package_url: str = ""
sha256: str = ""
release_notes_url: Optional[str] = None
changelog: Optional[str] = None
git_commit: Optional[str] = None
assets: Dict[str, str] = field(default_factory=dict)
@dataclass
class UpdateCheckResult:
update_available: bool
current_version: str = __version__
latest_version: str = __version__
installed_commit: str = "unknown"
latest_commit: str = ""
release_tag: str = ""
published_at: str = ""
changelog: Optional[str] = None
release_notes: Optional[str] = None
assets: Dict[str, str] = field(default_factory=dict)
manifest: Optional[UpdateManifest] = None
error: Optional[str] = None
message: Optional[str] = None
checked_at: float = field(default_factory=time.time)
def to_dict(self) -> Dict[str, Any]:
return {
"update_available": self.update_available,
"current_version": self.current_version,
"latest_version": self.latest_version,
"installed_commit": self.installed_commit,
"latest_commit": self.latest_commit,
"release_tag": self.release_tag,
"published_at": self.published_at,
"changelog": self.changelog,
"release_notes": self.release_notes,
"assets": self.assets,
"error": self.error,
"message": self.message,
"checked_at": self.checked_at,
}
def parse_semver(v: str) -> tuple[int, int, int]:
"""Parse '0.1.1' or 'v0.1.1' into (0, 1, 1)."""
clean = v.lstrip("v").strip()
parts = clean.split(".")
try:
return int(parts[0]), int(parts[1]), int(parts[2].split("-")[0])
except Exception:
return (0, 0, 0)
def is_newer_version(current: str, candidate: str) -> bool:
"""Return True if candidate is strictly newer than current."""
return parse_semver(candidate) > parse_semver(current)
def compute_sha256(file_path: Path) -> str:
"""Compute SHA-256 hash of a file."""
h = hashlib.sha256()
with open(file_path, "rb") as f:
while chunk := f.read(65536):
h.update(chunk)
return h.hexdigest().lower()
def is_allowed_update_host(url: str, allow_dev_local: bool = False) -> bool:
"""Verify that URL points to an authorized release feed host."""
is_dev = allow_dev_local or os.environ.get("HERMES_HUB_DEV_MODE") == "1"
if url.startswith("file://"):
return is_dev
if re.match(r"^[a-zA-Z]:[/\\]", url) or url.startswith(("\\\\", "./", "../", ".\\", "..\\")):
return is_dev
if not url.startswith("http://") and not url.startswith("https://") and not url.startswith("ftp://"):
if Path(url).is_absolute() or Path(url).exists():
return is_dev
try:
from urllib.parse import urlparse
parsed = urlparse(url)
if parsed.scheme.lower() not in ("https", "http"):
return False
if parsed.hostname in ("127.0.0.1", "localhost") and is_dev:
return True
if parsed.scheme.lower() != "https":
return False
hostname = (parsed.hostname or "").lower()
return hostname in ALLOWED_UPDATE_HOSTS or any(hostname.endswith("." + h) for h in ALLOWED_UPDATE_HOSTS)
except Exception:
return False
class UpdateManager:
"""Manages update checks, package download, hash validation, and updater execution."""
_last_check_result: Optional[UpdateCheckResult] = None
_last_check_time: float = 0.0
def __init__(self, manifest_url: Optional[str] = None):
self.manifest_url = manifest_url or os.environ.get("HERMES_HUB_UPDATE_URL", DEFAULT_UPDATE_URL)
self.updates_dir = paths.get_hermes_home() / "updates"
self.staging_dir = self.updates_dir / "staging"
self.backup_dir = self.updates_dir / "backup_prev"
self.updates_dir.mkdir(parents=True, exist_ok=True)
@classmethod
def get_last_check_result(cls) -> Optional[UpdateCheckResult]:
return cls._last_check_result
def get_status_dict(self) -> Dict[str, Any]:
installed_commit = get_installed_commit()
if self._last_check_result:
d = self._last_check_result.to_dict()
d["installed_commit"] = installed_commit
return d
return {
"update_available": False,
"current_version": __version__,
"latest_version": __version__,
"installed_commit": installed_commit,
"latest_commit": "",
"release_tag": "",
"published_at": "",
"changelog": None,
"release_notes": None,
"assets": {},
"error": None,
"message": "Проверка обновлений еще не выполнялась",
"checked_at": 0.0,
}
def check_for_updates(
self,
manifest_dict: Optional[Dict[str, Any]] = None,
release_dict: Optional[Dict[str, Any]] = None,
) -> UpdateCheckResult:
"""Check for updates using either passed manifest/release (for tests/local) or remote URL."""
installed_commit = get_installed_commit()
data = release_dict if release_dict is not None else manifest_dict
if not data:
if not is_allowed_update_host(self.manifest_url, allow_dev_local=False):
res = UpdateCheckResult(
update_available=False,
current_version=__version__,
latest_version=__version__,
installed_commit=installed_commit,
error=f"Недопустимый хост источника обновлений: {self.manifest_url}",
)
UpdateManager._last_check_result = res
UpdateManager._last_check_time = time.time()
return res
req = urllib.request.Request(
self.manifest_url,
headers={
"User-Agent": f"HermesHub/{__version__}",
"Accept": "application/vnd.github.v3+json",
},
)
try:
with urllib.request.urlopen(req, timeout=15) as resp:
raw_body = resp.read().decode("utf-8-sig")
data = json.loads(raw_body)
except urllib.error.HTTPError as http_err:
if http_err.code == 403:
err_msg = "Превышен лимит запросов к GitHub API"
elif http_err.code == 404:
err_msg = "Релизы не найдены в репозитории (404 Not Found)"
else:
err_msg = f"Ошибка GitHub API (HTTP {http_err.code}): {http_err.reason}"
logger.warning("Update check HTTP error: %s", err_msg)
res = UpdateCheckResult(
update_available=False,
current_version=__version__,
latest_version=__version__,
installed_commit=installed_commit,
error=err_msg,
)
UpdateManager._last_check_result = res
UpdateManager._last_check_time = time.time()
return res
except urllib.error.URLError as url_err:
err_msg = f"Сетевая ошибка при проверке обновлений: {url_err.reason}"
logger.warning("Update check network error: %s", err_msg)
res = UpdateCheckResult(
update_available=False,
current_version=__version__,
latest_version=__version__,
installed_commit=installed_commit,
error=err_msg,
)
UpdateManager._last_check_result = res
UpdateManager._last_check_time = time.time()
return res
except Exception as exc:
err_msg = f"Ошибка проверки обновлений: {exc}"
logger.warning("Update check failed: %s", exc)
res = UpdateCheckResult(
update_available=False,
current_version=__version__,
latest_version=__version__,
installed_commit=installed_commit,
error=err_msg,
)
UpdateManager._last_check_result = res
UpdateManager._last_check_time = time.time()
return res
# Process received payload
try:
tag_name = str(data.get("tag_name") or "")
release_name = str(data.get("name") or "")
body = str(data.get("body") or data.get("changelog") or "")
published_at = str(data.get("published_at") or "")
# Extract assets mapping {name: download_url}
assets_map: Dict[str, str] = {}
raw_assets = data.get("assets", [])
if isinstance(raw_assets, list):
for asset in raw_assets:
if isinstance(asset, dict) and "name" in asset and "browser_download_url" in asset:
assets_map[asset["name"]] = asset["browser_download_url"]
elif isinstance(raw_assets, dict):
assets_map = dict(raw_assets)
latest_commit = extract_release_commit(data)
# Package URL and SHA256 from manifest or assets
package_url = data.get("package_url", "")
sha256_hash = data.get("sha256", "").lower()
version_str = str(data.get("version") or tag_name or __version__)
manifest = UpdateManifest(
version=version_str,
channel=data.get("channel", CHANNEL),
minimum_hermes_version=data.get("minimum_hermes_version", MINIMUM_HERMES_VERSION),
published_at=published_at,
package_url=package_url,
sha256=sha256_hash,
release_notes_url=data.get("html_url") or data.get("release_notes_url"),
changelog=body,
git_commit=latest_commit,
assets=assets_map,
)
# Compare commits
inst_clean = installed_commit.strip().lower()
lat_clean = latest_commit.strip().lower()
if lat_clean and inst_clean != "unknown":
if inst_clean == lat_clean or inst_clean.startswith(lat_clean) or lat_clean.startswith(inst_clean):
update_available = False
message = "Установлена последняя сборка"
elif _is_release_older(published_at, get_installed_build_time()):
# Коммиты разные, но релиз старше установленной сборки —
# это откат назад, а не обновление.
update_available = False
message = (
f"Установлена сборка новее опубликованного релиза "
f"({lat_clean[:7]} от {published_at[:10]})"
)
else:
update_available = True
message = f"Доступно обновление (сборка {lat_clean[:7]})"
elif lat_clean and inst_clean == "unknown":
update_available = True
message = f"Доступно обновление (сборка {lat_clean[:7]})"
elif not lat_clean and "version" in data and is_newer_version(__version__, data["version"]):
# Legacy semver fallback
update_available = True
message = f"Доступно обновление {data['version']}"
else:
update_available = False
message = "Установлена последняя сборка"
res = UpdateCheckResult(
update_available=update_available,
current_version=__version__,
latest_version=version_str,
installed_commit=installed_commit,
latest_commit=latest_commit,
release_tag=tag_name or release_name,
published_at=published_at,
changelog=body,
release_notes=body,
assets=assets_map,
manifest=manifest,
error=None,
message=message,
checked_at=time.time(),
)
UpdateManager._last_check_result = res
UpdateManager._last_check_time = time.time()
return res
except Exception as exc:
err_msg = f"Ошибка обработки данных обновления: {exc}"
logger.warning("Update data processing failed: %s", exc)
res = UpdateCheckResult(
update_available=False,
current_version=__version__,
latest_version=__version__,
installed_commit=installed_commit,
error=err_msg,
)
UpdateManager._last_check_result = res
UpdateManager._last_check_time = time.time()
return res
def _download_file(
self,
url: str,
dest_file: Path,
progress_cb: Optional[Callable[[float], None]] = None,
) -> None:
"""Helper to download a file with allowlist check and optional progress callback."""
if not is_allowed_update_host(url, allow_dev_local=False):
raise ValueError(f"Недопустимый хост пакета обновления: {url}")
if url.startswith("file://") or Path(url).is_file():
local_src = Path(url.replace("file://", ""))
shutil.copy2(local_src, dest_file)
if progress_cb:
progress_cb(1.0)
return
req = urllib.request.Request(
url,
headers={"User-Agent": f"HermesHub/{__version__}"},
)
with urllib.request.urlopen(req, timeout=60) as resp:
total_len = int(resp.headers.get("content-length", 0))
downloaded = 0
with open(dest_file, "wb") as out_f:
while chunk := resp.read(65536):
out_f.write(chunk)
downloaded += len(chunk)
if progress_cb and total_len > 0:
progress_cb(downloaded / total_len)
def download_and_verify(
self,
manifest: UpdateManifest,
progress_cb: Optional[Callable[[float], None]] = None,
) -> Tuple[bool, str, Optional[Path]]:
"""Download update package into staging and verify SHA-256 hash."""
self.staging_dir.mkdir(parents=True, exist_ok=True)
dest_file = self.staging_dir / f"hermes-hub-{manifest.version}.zip"
try:
self._download_file(manifest.package_url, dest_file, progress_cb)
# Cryptographic SHA-256 Verification
calc_hash = compute_sha256(dest_file)
if manifest.sha256 and calc_hash != manifest.sha256.lower():
dest_file.unlink(missing_ok=True)
return False, f"SHA-256 hash mismatch! Expected {manifest.sha256}, got {calc_hash}", None
return True, "Пакет успешно загружен и верифицирован", dest_file
except Exception as exc:
dest_file.unlink(missing_ok=True)
return False, f"Ошибка загрузки: {exc}", None
def install_latest_update(
self,
check_result: Optional[UpdateCheckResult] = None,
progress_cb: Optional[Callable[[float], None]] = None,
target_dir: Optional[Path] = None,
) -> Tuple[bool, str]:
"""Download installer or update package, verify checksums, apply and restart."""
if check_result is None:
check_result = self.check_for_updates()
if check_result.error:
return False, f"Ошибка проверки обновлений: {check_result.error}"
if not check_result.update_available:
return False, "Обновление не требуется (установлена последняя сборка)"
self.staging_dir.mkdir(parents=True, exist_ok=True)
assets = check_result.assets or {}
# 1. Download checksums.txt if present
checksums_map: Dict[str, str] = {}
if "checksums.txt" in assets:
checksums_url = assets["checksums.txt"]
try:
chk_file = self.staging_dir / "checksums.txt"
self._download_file(checksums_url, chk_file)
for line in chk_file.read_text(encoding="utf-8").splitlines():
parts = line.strip().split()
if len(parts) >= 2:
sha = parts[0].strip().lower()
fname = parts[1].lstrip("*").strip().lower()
checksums_map[fname] = sha
except Exception as e:
logger.warning("Failed to download or parse checksums.txt: %s", e)
# 2. Determine target asset to download based on platform
is_win = sys.platform == "win32"
chosen_asset_name: Optional[str] = None
chosen_url: Optional[str] = None
if is_win:
if "HermesHubSetup.exe" in assets:
chosen_asset_name = "HermesHubSetup.exe"
chosen_url = assets["HermesHubSetup.exe"]
else:
for linux_name in ("hermes-hub-setup.sh", "install-linux.sh"):
if linux_name in assets:
chosen_asset_name = linux_name
chosen_url = assets[linux_name]
break
# Fallback to any .zip package in assets or manifest package_url
if not chosen_url:
for a_name, a_url in assets.items():
if a_name.endswith(".zip"):
chosen_asset_name = a_name
chosen_url = a_url
break
if not chosen_url and check_result.manifest and check_result.manifest.package_url:
chosen_url = check_result.manifest.package_url
chosen_asset_name = Path(chosen_url).name or f"hermes-hub-{check_result.latest_version}.zip"
if not chosen_url or not chosen_asset_name:
return False, "В релизе не найден подходящий файл обновления для текущей платформы"
# 3. Download target asset into staging
dest_file = self.staging_dir / chosen_asset_name
try:
self._download_file(chosen_url, dest_file, progress_cb)
except Exception as exc:
dest_file.unlink(missing_ok=True)
return False, f"Ошибка загрузки {chosen_asset_name}: {exc}"
# 4. SHA-256 Checksum Verification
calc_sha = compute_sha256(dest_file)
expected_sha = checksums_map.get(chosen_asset_name.lower())
if not expected_sha and check_result.manifest and check_result.manifest.sha256:
expected_sha = check_result.manifest.sha256.lower()
# Отсутствие суммы — не разрешение. Раньше при недоступном checksums.txt
# expected_sha оставался пустым, проверка молча пропускалась и скачанный
# файл всё равно запускался. Здесь запускается загруженный из сети
# исполняемый код, поэтому непроверенный файл не запускаем вовсе.
if not expected_sha:
dest_file.unlink(missing_ok=True)
return (
False,
f"Не удалось получить контрольную сумму для {chosen_asset_name}: "
"в релизе нет checksums.txt или файл не скачался. "
"Установка отменена — непроверенный файл не запускается."
)
if calc_sha != expected_sha:
dest_file.unlink(missing_ok=True)
return (
False,
f"Контрольная сумма SHA-256 не совпала для {chosen_asset_name}! "
f"Ожидалось {expected_sha}, получено {calc_sha}. Установка отменена."
)
# 5. Apply update based on file type
if chosen_asset_name.endswith(".zip"):
ok, msg = self.apply_update_sync(dest_file, target_dir=target_dir)
if not ok:
return False, msg
return True, "Обновление успешно установлено"
elif chosen_asset_name == "HermesHubSetup.exe":
try:
cmd = [str(dest_file), "/silent", "/reinstall", "/restart"]
creation_flags = 0
if hasattr(subprocess, "DETACHED_PROCESS") and hasattr(subprocess, "CREATE_NEW_PROCESS_GROUP"):
creation_flags = subprocess.DETACHED_PROCESS | subprocess.CREATE_NEW_PROCESS_GROUP
proc = subprocess.Popen(cmd, creationflags=creation_flags)
try:
rc = proc.wait(timeout=600)
except subprocess.TimeoutExpired:
return False, "Установщик не завершился за 10 минут. Проверьте состояние вручную."
if rc != 0:
return False, f"Установщик завершился с кодом {rc}. Обновление не применено."
ok_r, msg_r = self.schedule_restart()
if not ok_r:
return True, f"Обновление установлено. {msg_r}"
return True, "Обновление установлено, Hermes Hub перезапускается."
except Exception as exc:
return False, f"Не удалось запустить установщик: {exc}"
elif chosen_asset_name.endswith(".sh"):
try:
os.chmod(dest_file, 0o755)
# Ждём завершения: без этого перезапуск начался бы прямо во
# время распаковки, а владелец получил бы обещание перезапуска
# при неизвестном исходе установки.
res_i = subprocess.run(
["bash", str(dest_file)],
capture_output=True, text=True, timeout=600,
)
if res_i.returncode != 0:
tail = (res_i.stderr or res_i.stdout or "").strip().splitlines()[-3:]
return False, "Установка не удалась: " + " / ".join(tail)
ok_r, msg_r = self.schedule_restart()
if not ok_r:
return True, f"Обновление установлено. {msg_r}"
return True, "Обновление установлено, Hermes Hub перезапускается."
except Exception as exc:
return False, f"Не удалось запустить скрипт установки: {exc}"
return True, "Файл обновления загружен и проверен"
def schedule_restart(self, delay_sec: float = 3.0) -> Tuple[bool, str]:
"""Перезапустить веб-хаб после установки обновления.
Ни install-linux.sh, ни виндовый установщик в тихом режиме приложение не
поднимают, а сообщение обещало перезапуск. Владелец оставался со старым
процессом, продолжавшим отдавать старый код, и делал вывод, что
обновление не сработало.
Порядок именно такой: сначала отсоединённый помощник, потом выход
текущего процесса. Лаунчер считает хаб работающим, если порт отвечает,
поэтому поднимать новый, не освободив порт, бесполезно.
"""
home = paths.get_hermes_home()
if sys.platform == "win32":
launcher = home / "HermesHubWeb.exe"
else:
launcher = Path.home() / ".local" / "bin" / "hermes-hub-web"
if not launcher.exists():
return False, f"Лаунчер не найден: {launcher}. Запустите Hermes Hub вручную."
try:
if sys.platform == "win32":
flags = 0
if hasattr(subprocess, "DETACHED_PROCESS") and hasattr(subprocess, "CREATE_NEW_PROCESS_GROUP"):
flags = subprocess.DETACHED_PROCESS | subprocess.CREATE_NEW_PROCESS_GROUP
subprocess.Popen(
["cmd", "/c", f"timeout /t {int(delay_sec)} >nul & \"{launcher}\""],
creationflags=flags,
)
else:
subprocess.Popen(
["nohup", "sh", "-c", f"sleep {delay_sec}; exec '{launcher}'"],
start_new_session=True,
stdout=subprocess.DEVNULL,
stderr=subprocess.DEVNULL,
)
except Exception as exc:
return False, f"Не удалось запланировать перезапуск: {exc}. Запустите Hermes Hub вручную."
def _exit_soon() -> None:
time.sleep(max(0.5, delay_sec - 1.5))
os._exit(0)
threading.Thread(target=_exit_soon, daemon=True, name="hub-restart").start()
return True, "Перезапуск запланирован"
def apply_update_sync(self, package_zip: Path, target_dir: Optional[Path] = None) -> Tuple[bool, str]:
"""Apply update package with automatic backup and rollback on failure."""
import zipfile
dest = target_dir or paths.get_repo_root()
backup = self.backup_dir
backup.mkdir(parents=True, exist_ok=True)
try:
# 1. Backup current installation
for item in ["src", "assets", "config", "launcher"]:
src_item = dest / item
if src_item.exists():
dst_item = backup / item
if dst_item.exists():
shutil.rmtree(dst_item, ignore_errors=True)
shutil.copytree(src_item, dst_item)
# 2. Extract update package into dest
with zipfile.ZipFile(package_zip, "r") as zf:
zf.extractall(dest)
# 3. Verify syntax and integrity of updated python files in src/
import py_compile
target_src = dest / "src"
if target_src.exists():
for py_file in target_src.rglob("*.py"):
py_compile.compile(str(py_file), doraise=True)
# Also run quick import smoke test if python executable is available
py_exec = paths.get_hermes_agent_venv() / "Scripts" / "python.exe"
if not py_exec.exists():
py_exec = Path(sys.executable)
verify_code = "import sys; sys.path.insert(0, 'src'); from antigravity_provider.version import __version__; print('OK', __version__)"
res = subprocess.run(
[str(py_exec), "-c", verify_code],
cwd=str(dest),
capture_output=True,
text=True,
timeout=15,
**hidden_process_kwargs(),
)
if res.returncode != 0 or "OK" not in res.stdout:
raise RuntimeError(f"Post-update verification failed: {res.stderr or res.stdout}")
return True, "Обновление успешно установлено"
except Exception as exc:
logger.error("Update failed, initiating automatic rollback: %s", exc)
# Rollback from backup
for item in ["src", "assets", "config", "launcher"]:
b_item = backup / item
if b_item.exists():
d_item = dest / item
if d_item.exists():
shutil.rmtree(d_item, ignore_errors=True)
shutil.copytree(b_item, d_item)
return False, f"Обновление не удалось. Выполнен автоматический откат к предыдущей версии: {exc}"