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

8.1 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)

  • В installer/HermesHubSetup.cs:
    • Функция CopyDirectoryRecursive переведена на MirrorDirectoryRecursive: рекурсивно зеркалирует источник, удаляя устаревшие или мертвые файлы/каталоги в целевой папке (pluginDst), игнорируя __pycache__ и .pyc.
    • При установке создается deployment_manifest.json с полями version, deployed_at, git_commit.
    • Скомпилирован dist/HermesHubSetup.exe и обновлен dist/checksums.txt.
  • В installer/HermesHubSetup.py: также добавлено зеркальное копирование и запись deployment_manifest.json.
  • Тест: test_mirror_deployment_removes_deleted_files подтверждает удаление исчезнувших из источника файлов.

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. Результаты проверок

  • Headless pytest (Python 3.8): pytest -v → 201 passed, 27 skipped, 3 deselected in 10.70s
  • Full pytest (Python 3.12): & "C:\Users\trush\AppData\Local\Programs\Python\Python312\python.exe" -m pytest -v → 201 passed, 27 skipped, 3 deselected in 10.54s
  • 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)