ochenstarik/hermes-hub
1
0
Fork 0
Code Issues Pull requests Projects Releases 13 Packages Wiki Activity Actions
hermes-hub/agents/done/2026-08-22-A8-antigravity-deployment-doctor.md

11 KiB
Raw Blame History

Отчёт: Задание A8 — запуск, развёртывание, самопроверка

Дата: 2026-08-22

Идентификаторы и границы

  • START_HEAD (BASE_SHA): 20078f5ae2ee38525b6da383e20e54d314811a2f (origin/main)
  • Ветка: antigravity/deployment-doctor
  • origin/main: 20078f5ae2ee38525b6da383e20e54d314811a2f
  • Граница зоны Codex: ни один файл в src/antigravity_provider/router/ui/**, tests/test_ui_*.py НЕ изменялся (git diff --name-only по этим путям пуст).
  • Тег v0.1.1: НЕ создавался (в репозитории hermes-hub).

1. Самолечение и видимая диагностика сбоев при запуске (P0-1)

  • Создан модуль самовосстановления и ранней диагностики src/antigravity_provider/router/launcher_bootstrap.py:
    • check_missing_dependencies(): проверяет наличие customtkinter, PIL, psutil, yaml.
    • self_heal_dependencies(): если пакеты снесены кнопкой «Repair install» в Hermes, выполняет автоматическую тихую доустановку в активный venv (sys.executable -m pip install).
    • log_startup(): фиксирует все этапы запуска и полный трейсбек исключений в logs/startup.log до инициализации графической оболочки.
    • show_native_error(): в случае фатального падения до создания окна вызывает нативный диалог MessageBoxW с текстом ошибки и путем к логу запуска.
  • Обновлен лаунчер launcher/HermesHub.cs и скомпилирован launcher/HermesHub.exe: генерируемый входной скрипт запускает приложение через bootstrap_and_launch().
  • Оценка перехода на собственный venv:
    • Обоснование: Оставлено единое окружение Hermes venv с механизмом самолечения (launcher_bootstrap.py), так как собственный venv потребовал бы дублирования 300+ МБ рантайма Python и усложнил интеграцию с CLI Hermes. Самолечение устраняет риск сноса пакетов при пересборке venv агентом.

2. Профили Claude и Grok во встроенной конфигурации и исправление мастера (P0-2)

  • Добавлены профили Claude и Grok:
  • Исправление AutoAssigner.find_free_slot:
    • Кандидаты строго фильтруются по наличию в config.profiles.
    • Если для провайдера нет свободных/неавторизованных слотов, метод возвращает None (а не несуществующий или занятый candidates[0]).
    • AutoAssigner.recommend_assignment при отсутствии слотов корректно возвращает пустой слот со статусом «Нет свободных слотов».
    • Тест: test_auto_assigner_find_free_slot_for_all_five_providers проверяет все 5 провайдеров.

3. Блокировка интерактивного входа при нажатии «Тест» (P0-3)

  • В do_test_profile в hermes_hub_app.py: добавлена предварительная проверка status.get("expired"), которая сразу возвращает ошибку «Авторизация истекла, требуется повторный вход» без вызова адаптера.
  • В AntigravityAdapter.invoke: добавлена проверка времени жизни токена (tokens.get("expiry_date")) перед запуском подпроцесса agy. При просрочке немедленно выбрасывается AuthExpiredError.
  • В окружение agy_subprocess: добавлены флаги BROWSER=none и CI=1, исключающие интерактивный запуск браузера дочерними процессами.
  • Тесты: test_adapter_no_browser_on_expired_token и test_do_test_profile_no_browser_on_expired_token.

4. Зеркальное развёртывание инсталлятора и манифест (P0-4 & P0-4bis)

  • Различение первой установки и переустановки в мастере GUI:
    • SetupEngine.DetectHermes() определяет установленную копию по наличию HermesHub.exe или deployment_manifest.json, считывая установленную версию и дату.
    • Если Hub уже установлен (SetupEngine.IsInstalled), первый экран мастера переключается в режим переустановки:
      • Отображает текущую установленную версию (например, 0.1.0 (19.08.2026)), версию в дистрибутиве (0.1.1) и путь к каталогу программы.
      • Предлагает действия: [ Переустановить ] (запуск зеркальной установки), [ 🗑️ Удалить Hub ] (вызов деинсталлятора) и [ Отмена ].
    • При первой установке (Hub не установлен) показывается стандартный приветственный экран с проверкой Hermes Agent и переходом к параметрам компонентов.
  • Зеркалирование при переустановке:
    • MirrorDirectoryRecursive зеркалирует файлы дистрибутива в целевой каталог плагина и программы, очищая устаревшие и удаленные в новой версии модули и исключая __pycache__ и .pyc.
    • Гарантированное сохранение пользовательских данных: все пользовательские каталоги авторизации (agy_profiles, codex_profiles, opengo_profiles, claude_profiles, grok_profiles), router_profiles.yaml, hub_settings.json, логи (logs/), состояние (router_state.json) и телеметрия изолированы и остаются неизменными.
    • При установке генерируется deployment_manifest.json (version, deployed_at, git_commit).
    • Поддержан флаг командной строки /reinstall (и алиас /repair).
    • Перекомпилирован dist/HermesHubSetup.exe и обновлен dist/checksums.txt.
  • Тесты:
    1. test_mirror_deployment_removes_deleted_files: в песочнице развертывание версии A, удаление файла в источнике и переустановка версии B полностью очищает целевую папку от удаленного файла.
    2. test_reinstall_preserves_user_data_and_credentials: создание auth.json, кастомного router_profiles.yaml и hub_settings.json с последующей переустановкой подтверждает их 100% сохранность и неизменность.
    3. test_detection_of_installed_copy: корректно определяет наличие установленной копии по манифесту и возвращает точные версии.

5. Команда самопроверки hermes router diag (P0-5)

  • В src/antigravity_provider/router/cli_commands.py расширена команда print_diagnostics_cli():
    1. Проверка зависимостей venv (customtkinter, Pillow, psutil, pyyaml).
    2. Проверка свежести развёрнутого плагина против версии приложения по deployment_manifest.json.
    3. Проверка валидности router_profiles.yaml (число профилей и ролей).
    4. Диагностическая матрица по всем профилям с маскированием идентичностей и источниками квот.
    5. Реальный тестовый вызов по одному профилю на каждого авторизованного провайдера.
    6. Однострочный вердикт: [ВЕРДИКТ: ГОТОВ / ЧАСТИЧНО ГОТОВ / НЕ ГОТОВ] с явным списком причин.
    7. Все секреты маскируются (sk-...abcd, och***@domain).
  • Тест: test_print_diagnostics_cli_output проверяет структуру вывода и вердикта.

6. Статус по YAML round-trip (P1-6)

  • Статус: Частично.
  • Сохраняется: все секции roles, profiles, pricing, settings, структура словарей, списков и комментарии верхнего уровня.
  • Теряется: инлайн-комментарии внутри блоков отдельных полей профилей при сериализации через yaml.safe_dump (о чем зафиксировано в документации и контракте).

7. Результаты проверок

  • Headless pytest (Python 3.8): pytest -v → 203 passed, 27 skipped, 3 deselected in 11.16s
  • Full pytest (Python 3.12): & "C:\Users\trush\AppData\Local\Programs\Python\Python312\python.exe" -m pytest -v → 203 passed, 27 skipped, 3 deselected in 11.89s
  • Ruff linter: ruff check . → All checks passed!
  • Release Gate: python scripts/release_gate.py → 7/7 PASSED ([RELEASE GATE: PASSED] All criteria verified. Ready for Candidate v0.1.1)
  • Live Update Feed: [MANIFEST_LIVE=True, PACKAGE_LIVE=True, PACKAGE_HASH_VERIFIED=True] (sha256 b5bbdea2a7a2157a26389266aab07ab3602bb00b4612065c48defec9d6fe909c)
  • UI Zone Isolation: 0 files modified in UI area (src/antigravity_provider/router/ui/**, tests/test_ui_*.py)