hermes-hub/docs/web-api
Hermes Team 7ae4a28a80 docs(web): контракт веб-интерфейса и эталонная фикстура снапшота
Переход на веб-интерфейс. Контракт вынесен отдельным документом, потому
что серверная и клиентская стороны делаются параллельно и до слияния
друг друга не видят: в прошлом раунде расхождение в одном имени модуля
молча оставило выбор моделей пустым навсегда.

Зафиксировано: стек (FastAPI + uvicorn, уже объявлены в pyproject;
клиент — обычный JS без сборки), требования безопасности (127.0.0.1 по
умолчанию, токен для внешнего адреса, тест на отсутствие секретов в
ответе), два эндпоинта поверх готового снапшота и семнадцати действий
_handle_action, правило игнорировать ответы с устаревшим seq.

snapshot.example.json снят с живой машины владельца: 63 профиля,
187 КБ. Почты замаскированы, токенов, ключей и JWT нет — проверено.
Клиентская сторона разрабатывается против этого файла и не блокируется
готовностью сервера.

Отдельно зафиксировано ограничение headless: Codex и Grok работают по
device-code, Antigravity и Claude используют redirect на localhost и на
сервере без экрана не заработают.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-23 19:01:15 +07:00
..
CONTRACT.md docs(web): контракт веб-интерфейса и эталонная фикстура снапшота 2026-08-23 19:01:15 +07:00
snapshot.example.json docs(web): контракт веб-интерфейса и эталонная фикстура снапшота 2026-08-23 19:01:15 +07:00