hermes-hub/agents/inbox/2026-08-31-A41-clean-first-install.md

Задание A41: чистая конфигурация при первой установке

Дата поступления

2026-08-31

База

origin/main (380c218) — там уже слиты A34–A39 и правки ревьюера.

git fetch origin --prune
git checkout -b antigravity/a41-clean-first-install origin/main

В main напрямую не пушить.

Порядок исполнения

Два прохода: Flash реализует, Pro проводит аудит. Пункт P0-5 написан для аудитора.

---

Задача

Владелец: «при первой установке всё должно быть сброшено по умолчанию, и настройка идёт с нуля. Как внёс аккаунты, потом распределяешь. Чтобы не было таких ошибок».

Повод конкретный. Сегодня установка на Windows упала с кодом 12, и причина была не в новом коде, а в накопленном состоянии: конфигурация тащила роль под старым именем, роли без цепочек и два десятка пустых заготовок, переживших несколько переименований. Проверка споткнулась о наследие.

Что известно проверенно

get_default_router_config() создаёт 24 профиля:
    antigravity 10, openai-codex 3, opencode-go 3, claude 3, grok 3, local 2

из них у владельца реально подключены единицы; остальные показывались как
«Аккаунт не добавлен» и «Холодный резерв», пока A26 не убрал их с экрана

install-linux.sh: «Preserving existing user router_profiles.yaml»
учётные данные лежат ОТДЕЛЬНО, в ~/.hermes/agy_profiles/, вне каталога плагина

Последнее — ключевое для этого задания, см. P0-2.

---

P0-1. Первая установка начинается с пустого листа

Различать два случая и вести себя по-разному:

Конфигурации нет — это первая установка. Не создавать 24 заготовки. Роли из реестра объявлены, но цепочки пусты, профилей нет вовсе. Интерфейс показывает состояние «аккаунтов нет» и предлагает подключить первый.

Конфигурация есть — это обновление. Ничего не трогать, как сейчас. У владельца на трёх машинах живут настроенные цепочки, и молчаливый сброс недопустим.

Различать по наличию файла, а не по версии: версия в проекте заморожена на 0.1.1 намеренно.

P0-2. Учётные данные не трогать никогда

Отдельным пунктом, потому что цена ошибки высока.

Сброс касается только конфигурации маршрутизации: router_profiles.yaml. Каталог ~/.hermes/agy_profiles/ и содержимое hub_settings.json в части токенов не затрагиваются ни при каких условиях.

Потеря учётных данных означает повторный вход в два десятка аккаунтов, включая Antigravity, где вход идёт по ссылке с возвратом и делается вручную для каждого профиля. Это часы работы владельца.

Защита каталогов учётных данных уже реализована в A37 (security_guard.py) — использовать её, а не писать вторую.

P0-3. Профили появляются вместе с аккаунтами

Продолжение линии A26: аккаунты вместо слотов.

1. Подключение аккаунта создаёт профиль. Заранее заготовленных пустых профилей быть не должно.
2. Идентификатор выдаётся сам, как уже сделано в A26 (codex-4, codex-5 и далее). Владелец про них знать не обязан.
3. Роль получает аккаунт, когда владелец его назначил или нажал «Авто». До этого цепочка пуста, и это нормальное состояние, а не ошибка.

P0-4. Явный сброс по кнопке

В «Настройках» — «Начать настройку заново».

1. Спрашивает подтверждение и прямо перечисляет, что будет удалено, а что сохранено. Учётные данные — в списке сохраняемого.
2. Чистит цепочки ролей и профили, не трогая аккаунты.
3. Резервная копия перед сбросом, чтобы ошибочное нажатие можно было отменить. Механизм резервных копий конфигурации в проекте уже есть.
4. После сброса хаб работоспособен: интерфейс открывается, показывает пустое состояние, предлагает подключить аккаунт.

P0-5. Проверки установщика не должны зависеть от расстановки

Сегодняшняя поломка возникла именно здесь, и это надо закрыть на будущее.

scripts/verify_multi_provider_router.py уже переписан ревьюером: имя оркестрирующей роли спрашивается у реестра, пустые цепочки допустимы у ролей без аккаунтов, отказоустойчивость проверяется по механизму, а не по зашитому порядку.

Требуется убедиться, что скрипт проходит на пустой конфигурации первой установки. Сейчас он этого случая не видел: у него всегда было 24 профиля. Проверка, падающая на чистой машине, снова даст код 12 — только теперь у нового пользователя.

P0-6. Аудит вторым проходом

1. Проверить на копии конфигурации владельца, что обновление ничего не сбрасывает. Цепочки и порядок аккаунтов обязаны совпасть до и после.
2. Проверить, что учётные данные целы после сброса: файлы в agy_profiles/ на месте, аккаунты по-прежнему подключены.
3. Установить начисто в пустой HERMES_HOME и пройти путь целиком: установка, открытие интерфейса, подключение аккаунта, назначение роли.
4. Проверочный скрипт установщика прогнать и на пустой конфигурации, и на конфигурации владельца.
5. Побочные изменения объяснить.
6. Пропущенный пункт назвать пропущенным.

---

Ограничения

• Учётные данные не удалять и не переносить ни при каких условиях.
• Обновление поверх существующей установки ничего не сбрасывает.
• Версию 0.1.1 не поднимать: сборки различаются коммитом.
• Правило честности без исключений: пустое состояние показывать как пустое, а не как ошибку.

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

1. Ветка в origin, git status чист.
2. Установка в пустой HERMES_HOME даёт конфигурацию без предсозданных профилей; интерфейс показывает внятное пустое состояние.
3. Обновление поверх конфигурации владельца не меняет ни одной цепочки; проверено на копии, вывод приложен.
4. Подключение аккаунта создаёт профиль; заранее заготовленных пустых нет.
5. Кнопка сброса спрашивает подтверждение, перечисляет сохраняемое, делает резервную копию и не трогает учётные данные; проверено.
6. verify_multi_provider_router.py проходит и на пустой конфигурации, и на конфигурации владельца; оба вывода приложены.
7. Путь целиком пройден вручную на чистой установке: подключение аккаунта, назначение роли, работа маршрутизации.
8. ruff check . чисто; релизный гейт не ухудшен.
9. Отчёт: START_HEAD, FINAL_HEAD, origin/main, git status, X passed / Y skipped / Z failed. На main сейчас 486 passed.

Главное

Сегодняшняя ошибка установки возникла не из-за нового кода, а из-за состояния, накопленного за десяток версий. Чистый старт убирает целый класс таких поломок: новый пользователь получает пустую систему и заполняет её сам, а не разбирается с двумя десятками заготовок, часть из которых помнит переименования полугодовой давности.

Порядок сдачи

Передать точный FINAL_COMMIT_SHA.