# Changelog

Все заметные изменения проекта `selectel-ml-tui`.

## [1.0.3] — 2026-08-19

Полноценный вывод данных из Gateway API ИИ-роутера (IAM).

### Добавлено
- Парсинг реальной схемы Gateway API:
  - `/overview` → потребление за месяц (сумма в нанорублях, запросы, токены
    всего, input/output/cache read/cache write), бюджет роутера (лимит/расход/
    остаток);
  - `/metrics` → метрики за 24 ч (доступность `success_rate_pct`, TTFT и
    задержка в секундах→мс, запросы, токены) и `by_model` — по моделям
    (запросы/доступность/TTFT);
  - `/keys` → лимиты и расход по API-ключам (имя, префикс, статус, лимит,
    потрачено, остаток).
- Новый экран **«API-ключи и лимиты»** (клавиша `k`) и панель бюджета на
  главном экране.
- Модели: добавлены поля `requests`, `tokens_total`, `avg_latency_ms`; новые
  модели `ApiKeyUsage`, `BudgetInfo`.

### Исправлено
- «Потрачено за месяц» берётся из Gateway Overview (совпадает с вкладкой
  «Обзор»), биллинг — фолбэк при отсутствии IAM.
- `SettingsScreen` не перезаписывает конфиг, если интервал не менялся.

## [1.0.2] — 2026-08-19

Исправление отображения данных и прав на файлы конфигурации.

### Исправлено
- **Сумма за месяц**: раньше `end` обрезался до начала текущего дня — сегодняшние
  расходы не входили в сумму. Теперь `end` = текущий момент (naive datetime),
  сумма включает текущий день.
- **История**: в историю записывалась месячная сумма как «точка дня». Теперь
  сохраняется дневная стоимость (отдельно показывается «Сегодня»).
- **Токены/модели**: при отсутствии IAM (нет сервисного пользователя) поля
  Input/Output/Cache больше не показывают вводящие в заблуждение нули — выводится
  пояснение «Токены и модели — только через IAM».

### Примечание
- Gateway API (токены по моделям, каталог моделей) требует IAM-токен сервисного
  пользователя. В аккаунте нет сервисных пользователей — необходимо создать его
  в панели (my.selectel.ru → IAM → Сервисные пользователи) и настроить через
  `selectel-ml-tui config`.
- `credentials.json`/`config.toml` должны принадлежать текущему пользователю
  (права 0600). Запуск от `root`/`sudo` создаёт файлы с владельцем root, из-за
  чего обычный запуск падает с `PermissionError` — исправляется `chown`.

## [1.0.1] — 2026-08-19

Исправление: крах при запуске, если в `config.toml` (или env
`SELCTEL_REFRESH_INTERVAL`) указан `refresh_interval < 10`.

### Исправлено
- `load_settings()` больше не бросает `ValidationError` на некорректных
  значениях: `refresh_interval` приводится к допустимому диапазону
  (минимум 10 секунд), мусорные значения — к умолчанию 60.
- Мастер `selectel-ml-tui config` отклоняет интервал < 10 (повторный запрос).

## [1.0.0] — 2026-08-19

Релиз, готовый к использованию.

### Добавлено
- TUI-дашборд (Textual): потребление за месяц, метрики за 24 часа, таблица
  «По моделям», статус `online`/`offline` в заголовке, автообновление.
- Экраны: **История** (бар-график + таблица по дням, периоды 7/30/90),
  **Детали модели** (Enter в таблице моделей), **Настройки** (интервал
  обновления, «Очистить кэш», пути, маскированный токен).
- API-клиенты: Billing Statistics (стоимость), Gateway API (токены/метрики),
  IAM (получение и кэширование токена с автообновлением).
- Модели данных (pydantic) с валидацией и форматированием чисел.
- Локальный SQLite-кэш: снимки потребления/метрик/моделей, история по дням
  (upsert), очистка старых записей (TTL 180 дней), экспорт CSV/JSON.
- CLI: `config` (интерактивный мастер), `run`, `export`, `doctor`
  (диагностика окружения); `python -m selectel_ml_tui`.
- Адаптация под Ubuntu и macOS: скрипты установки, `scripts/run.sh`,
  диагностика `TERM`/`LANG`/UTF-8, CI (GitHub Actions: ubuntu + macos).
- Упаковка: однофайловый бинарник через PyInstaller (`make build`).

### Качество
- 89 тестов, покрытие 91% (порог 80%).
- ruff (flake8/isort/format), mypy strict — без ошибок.
- Подсказка при первом запуске без токена, FAQ и troubleshooting в README.

[1.0.3]: https://github.com/selectel-ml-tui/selectel-ml-tui/releases/tag/v1.0.3
[1.0.2]: https://github.com/selectel-ml-tui/selectel-ml-tui/releases/tag/v1.0.2
[1.0.1]: https://github.com/selectel-ml-tui/selectel-ml-tui/releases/tag/v1.0.1
[1.0.0]: https://github.com/selectel-ml-tui/selectel-ml-tui/releases/tag/v1.0.0