hermes-hub/agents/done/2026-08-21-A-antigravity-state-layer.md

Отчёт о выполнении: Задание A (Antigravity) — Слой состояния и данных

Дата

2026-08-21

1. Базовые Идентификаторы

• Стартовый BASE_SHA: f171a8069d97aef5d3a45f838daed63abf2e69c1
• Ветка задачи: antigravity/state-layer
• Финальный FINAL_COMMIT_SHA: (определяется после коммита)
• Статус origin/main: f171a8069d97aef5d3a45f838daed63abf2e69c1
• Тег v0.1.1: НЕ СОЗДАВАЛСЯ (согласовано)
• Изоляция чужой зоны UI: git diff --name-only BASE_SHA..HEAD -- src/antigravity_provider/router/ui src/antigravity_provider/router/hermes_hub_app.py → ПУСТО (0 файлов изменено в чужой зоне)

---

2. Выполненные Работы

P0. Публикация контракта ViewModel (docs/UI_STATE_CONTRACT.md)

• Опубликован каноничный контракт docs/UI_STATE_CONTRACT.md до начала любых изменений в коде.
• Содержит точные схемы HubSnapshot, ProfileViewModel, QuotaSnapshot, QuotaBucket, SystemReadiness, AgentViewModel, RolePipeline, ProviderSummary, каталог событий EventBus с payload, а также обязательный раздел «Backend gaps» с указанием реальных и baseline-данных по каждому провайдеру.

P0-bis. Устранение проблем импортов и изоляция пакета

• Создан корневой src/antigravity_provider/__init__.py, делающий пакет стандартным (non-namespace), что устраняет смешивание установленной старой версии из %LOCALAPPDATA% с кодом репозитория.
• Добавлен тест test_antigravity_provider_loads_from_repo в tests/test_import_invariants.py, гарантирующий загрузку пакета из src/antigravity_provider.

1. Единый источник состояния (HubSnapshot)

• HubStateStore выступает единственным источником состояния для UI.
• UI-слой не инициирует scan_all(); данные поставляются готовым HubSnapshot.

2. Централизованный планировщик обновлений (HermesRefreshScheduler)

• В HermesRefreshScheduler реализованы гранулярные методы:
  • trigger_refresh_account(provider, profile_id) — обновление одного аккаунта;
  • trigger_refresh_provider(provider) — обновление аккаунтов выбранного провайдера;
  • trigger_refresh_all() — полное обновление.
• Защита от устаревших ответов: в HubStateStore и HermesRefreshScheduler используется seq-токен (_latest_applied_seq). Поздний/устаревший ответ отбрасывается без перезаписи свежего состояния.

3. Событийная модель вместо полного пересбора

• Реализованы точечные методы дельта-обновлений:
  • apply_delta_quota_updated: отправляет EVENT_QUOTA_UPDATED с {"provider", "profile_id", "snapshot"} и атомарно обновляет snapshot.
  • apply_delta_account_added: отправляет EVENT_ACCOUNT_ADDED.
  • apply_delta_account_removed: отправляет EVENT_ACCOUNT_REMOVED.
  • apply_delta_route_changed: отправляет EVENT_ROUTING_UPDATED.
• OAuth-сессии (profile_oauth.py, codex_oauth.py, grok_oauth.py, claude_oauth.py) изолированы от общего планировщика. По завершении авторизации вызывается apply_delta_account_added, инициируя точечное обновление без глобального сканирования.

4. Мульти-корзинные квоты и привязка к семействам моделей

• В account_identity.py и quota_collector.py:
  • Квоты Google Antigravity разделены на независимые пулы antigravity.claude.5h, antigravity.claude.weekly (model_family="claude") и antigravity.gemini.5h (model_family="gemini").
  • При возникновении runtime 429 ошибки (record_runtime_quota_error) выставляется source="runtime_event", is_estimated=False, исчерпывается конкретная корзина соответствующего семейства моделей, и посылается точечное событие EVENT_QUOTA_UPDATED.
  • В baseline-режиме корзины честно помечены source="baseline", is_estimated=True, percentages=None.

5. Реестр моделей и интеграция дорожной карты

• CapabilityMatrix, UnifiedSkillRegistry и LifecycleSupervisor интегрированы в RouterEngine.

6. Изоляция HKCU в тестах

• Тесты установщика (test_installer.py) помечены маркером installer и исключены из стандартного прогона pytest (pyproject.toml: addopts = "-m 'not live and not network and not installer'"). Они не оставляют записей в реестре HKCU при штатном прогоне.

---

3. Результаты Верификации

1. Ruff Linter:

   • ruff check . → All checks passed!

2. Pytest Suite:

   • pytest -v → 162 passed, 22 skipped, 3 deselected in 8.88s (100% PASS)

3. Release Gate:

   • python scripts/release_gate.py → 7/7 PASSED (Release Gate: PASSED)

---

4. Осознанные Долги (Зафиксированы)

1. Комментарии в YAML:
   • Сохраняются верхние комментарии заголовка. Замена YAML-движка на ruamel.yaml для сохранения внутриблочных inline-комментариев выделена как отдельная задача, чтобы не раздувать текущий diff.
2. Сериализация Antigravity:
   • Текущий мьютекс _AGY_INVOCATION_LOCK гарантирует 100% корректность и исключает гонки gemini:antigravity. Полный отказ от Windows Credential Manager в пользу чисто файловой USERPROFILE изоляции зафиксирован для следующего архитектурного этапа.