86c9189edd
- Added HubStateStore targeted delta update methods (apply_delta_quota_updated, apply_delta_account_added, apply_delta_account_removed, apply_delta_route_changed) - Added seq sequence freshness tracking in HubStateStore to drop stale out-of-order responses - Added trigger_refresh_provider in HermesRefreshScheduler - Bound multi-bucket quotas to specific model families (Claude vs Gemini) with truthful is_estimated tracking - Connected OAuth completion to targeted account added events across all providers - Pinned antigravity_provider package root to repo via __init__.py and added import invariant verification - Added unit tests in tests/test_state_layer_and_event_driven_quota.py and tests/test_import_invariants.py - Zero modifications to UI zone files (views, components, theme, wizard, hermes_hub_app.py)
78 lines
6.8 KiB
Markdown
78 lines
6.8 KiB
Markdown
# Отчёт о выполнении: Задание 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` изоляции зафиксирован для следующего архитектурного этапа.
|