# Задание A18 (Antigravity Flash): выбор модели и надёжное обнаружение

## Дата поступления
2026-08-23

## База
Проверочный HEAD на момент выдачи: **`fb23bff`**.

## Ветка
`antigravity/model-choice`

---

## Порядок работы с git

```
cd <каталог репозитория>; git fetch origin --prune; git status
git checkout main; git pull --ff-only origin main
git checkout -b antigravity/model-choice
git commit -m "..."          <- сначала коммит
git push -u origin antigravity/model-choice
```

В конце — push и проверка:

```
git status
git log --oneline -1 origin/antigravity/model-choice
```

---

## Что принято по A16

**Лучшая работа за все раунды.** Веб-клиент собран без сборки, экран «Аккаунты» показывает 22 из 22 аккаунтов с квотами, указанием пула и периода, временем сброса. Неподключённые честно помечены. Внизу индикатор источника данных — интерфейс сам сообщает, живые данные он показывает или фикстуру. Все восемь скриншотов содержательные, пустых нет. Границу зоны соблюли.

Три вещи доделал ревьюер, знать полезно:

1. **Сервер не отдавал статику вообще** — в браузере был 404. Обе стороны выполнили контракт, но он не назвал, кто монтирует `static/`. Это пропуск автора контракта, не ваш; исправлено, контракт поднят до 1.1.
2. **Квоты не подтягивались**: кэш никто не грел, а `HubStateStore.get_snapshot()` возвращает кэшированный снапшот и пересобирает его только при первом вызове. Добавлен фоновый цикл.
3. **Загрузка выглядела как отсутствие данных.** Сервер отдавал `is_loading`, клиент его игнорировал и рисовал «Н/Д» — тот же текст, что у аккаунта без лимитов. Владелец увидел это и решил, что лимиты не работают. Теперь показывается «Загрузка…».

---

## P0-1. Смены модели не существует

Владелец: **«не дает поменять модель. хочу выбрать 2 кодера гемини про, а не дает»**.

Проверено: **действия смены модели нет ни среди семнадцати, ни в веб-клиенте.** Десктоп это умеет — `_open_agent_settings_modal._save_agent` пишет `profile.preferred_models` и вызывает `save_router_config`, — но логика заперта внутри метода интерфейса и наружу не вынесена.

**Требуется:**

1. **Действие `set_model`** в `action_handler.ActionExecutor` — там, где живут остальные. Принимает профиль (или роль) и идентификатор модели, ставит её первой в `preferred_models`, сохраняет конфигурацию.
2. **Отказ, если модели нет у провайдера.** Не подставлять «похожую», не сохранять молча. У владельца в конфигурации уже стоит `gemini-3.7-flash`, которой у провайдера **не существует**, — она попала туда именно так, через литерал в коде.
3. **Выбор в веб-клиенте**: на карточке роли и в окне деталей аккаунта. После сохранения новая модель видна без перезагрузки страницы.
4. Добавить `set_model` в `docs/web-api/CONTRACT.md` — список действий там перечислен поимённо, и клиент пишется против него.

Десктопную модалку не ломать: она должна вызывать то же действие, а не свою копию. Второй реализации в проекте быть не должно — ради этого действия и выносили в общий слой.

**Тест:** смена модели сохраняется в конфигурацию и переживает перезапуск; несуществующая модель отклоняется с внятной причиной.

## P0-2. Обнаружение моделей не даёт ничего

Даже когда выбор появится, он будет пустым. Проверено:

```
antigravity   моделей в кэше: 0
opencode-go   моделей в кэше: 0
grok          моделей в кэше: 0
файла models_cache.json на диске нет
```

Причина не в вашем коде: зонд вызывает `agy models`, а эта команда нестабильна. Замерено на живой машине — **в одном прогоне отвечает за 40 секунд, в следующем висит больше двух минут и убивается по таймауту** (`rc=124`). Причём виснет она и при прямом вызове из консоли, без всякого Hub.

Когда она отвечает, список настоящий и там есть то, что просит владелец:

```
gemini-3.7-flash-high / -medium / -low
gemini-3.6-flash-high / -medium / -low
gemini-3.5-flash-high / -medium / -low
gemini-3.1-pro-high / -low          <- «Gemini Pro», которого он хочет
claude-sonnet-4-6, claude-opus-4-6-thinking, gpt-oss-120b-medium
```

**Требуется сделать обнаружение полезным вопреки нестабильности CLI:**

- результат **сохраняется на диск** и переживает перезапуск. Один удачный опрос за сутки должен закрывать вопрос;
- обновление в фоне, с таймаутом; срабатывание таймаута **не затирает прежний кэш**;
- **ручная кнопка «Обновить список моделей»** — владелец должен иметь возможность попробовать ещё раз, а не ждать интервала;
- при пустом кэше интерфейс говорит «список моделей ещё не получен» и предлагает обновить. Литеральный список **не подставлять** ни при каких условиях;
- в отчёте написать, сколько попыток из десяти `agy models` завершились успешно на вашей машине. Это цифра, которая определит, годен ли зонд вообще.

Если окажется, что команда безнадёжна — предложить альтернативу и обосновать: разбор конфигурации `agy`, отдельный эндпоинт, ручной ввод модели владельцем. Молча оставлять пустой список нельзя, это второе задание подряд с этим пунктом.

**Тест:** кэш переживает перезапуск; таймаут не затирает прежние данные; пустой кэш даёт понятное сообщение, а не пустой выпадающий список.

## P1-3. Проверить остальные экраны на данных

Экран «Команда агентов» на скриншоте владельца показывает роли `research` и `fast` с профилем `opengo-1` и моделью `deepseek-r1`. Убедиться, что после появления выбора модель на этом экране меняется вместе с конфигурацией, а не остаётся прежней до перезапуска.

---

## Ограничения

- Параллельно идут **A17** (честный статус) и **A19** (установщики). Ваши файлы: `router/web/static/**`, `model_discovery.py`, `model_discovery_service.py`, `router/ui/**`, `tests/test_ui_*.py`, `tests/test_web_client_*.py`. По `action_handler.py` — **только добавление `set_model`**, остального там не касаться: A17 работает в этом же файле.
- Контракт правьте в части списка действий, остальное — зона A17. Скажите в отчёте, что изменили.
- Не выдумывать названия моделей. Нет обнаруженного списка — пустой список и объяснение.
- Тег `v0.1.1` не создавать.

## Критерии приёмки

1. Ветка в `origin`, `git status` чист.
2. Действие `set_model` живёт в `action_handler`; десктоп и веб вызывают его, второй реализации нет.
3. Модель меняется из веб-интерфейса, сохраняется и переживает перезапуск; проверено тестом.
4. Несуществующая модель отклоняется с внятной причиной; проверено тестом.
5. Кэш моделей сохраняется на диск и переживает перезапуск; таймаут не затирает прежние данные.
6. Есть ручное обновление списка моделей.
7. Пустой кэш даёт объяснение, а не пустой список; литералов нет.
8. В отчёте: сколько попыток из десяти `agy models` завершились успехом.
9. `set_model` добавлено в контракт.
10. Прогон в обоих окружениях; `ruff check .` чисто; гейт не ухудшен.
11. **Скриншот смены модели с настоящими данными**: до, выбор, после.
12. Отчёт: `START_HEAD`, `FINAL_HEAD`, `origin/main`, `git status`, `X passed / Y skipped / Z failed`. На `main` сейчас 331 passed.

## Главное

Владелец хочет поставить двум кодерам Gemini Pro. Сейчас это невозможно тремя способами сразу: действия нет, элемента управления нет, списка моделей нет. Задание закрывает все три.

## Порядок сдачи
Передать точный `FINAL_COMMIT_SHA`. Сдано только после появления коммита в `origin`.
