v3.0.0

Главное в релизе — репозиторий приведён в состояние, пригодное для работы
AI-агентов. Плюс единая OpenAPI-документация для сервера и клиента.

AI-ready репозиторий

• Одна точка входа. ROOT.md (и AGENTS.md для тех, кто ищет по имени):
  навигация, что запускать перед сдачей хода, правила, которые нельзя нарушать
  молча, карта известного долга.
• Одна команда проверок. ./scripts/quality/verify.sh — 24 гейта, которые
  одинаково гоняют человек, агент и CI. Набор гейтов правится в
  .quality/quality.config.json.
• Contract-first. 6 OpenAPI-спецификаций в specs/contracts/ — источник
  правды для сервера и клиента. Серверные базы и TypeScript-клиент генерируются,
  ручная правка сгенерированного валит гейт. Контроллер мимо контракта не
  компилируется. Realtime-события SignalR описаны отдельным контрактом и тоже
  сверяются гейтом.
• Решения записаны. 13 ADR в specs/ADR/ — почему архитектура такая, а не
  другая.
• Границы слоёв проверяются тестами. Бекенд перестроен на API / прикладной
  слой / домен / инфраструктуру.
• Долг зафиксирован снимками. Ratchet-гейты не требуют идеала, но не дают
  долгу расти.

API

• Ошибки — Problem Details (RFC 9457) с application/problem+json:
  машинный код ошибки, человекочитаемый заголовок и идентификатор трассы.
  Один формат ошибки на весь контур вместо прежнего error / reason /
  error_list.
• Большие идентификаторы и счётчики передаются строкой — значения больше
  2^53−1 больше не теряют точность молча.
• Статусы, тип автора, видимость комментария и тип вложения — строки
  (backlog, open, internal, bug_step …) вместо чисел: ответ читается
  без сверки с кодом.
• Создание репорта отвечает 201 Created с адресом созданного репорта
  в заголовке Location.

v2.0.0

v2.0.0

В этом выпуске укреплена согласованность фронтенда и API, а также улучшена диагностика ошибок в интерфейсе.

Изменения

• Фронтенд использует типы, генерируемые из спецификации API; добавлены проверки, защищающие от расхождения контрактов.
• Улучшена обработка ошибок API в интерфейсе, включая ответы в формате problem+json.
• Уточнены контракты ответов для репортов и вложений: из них больше не передаются внутренние технические сведения о хранении файлов.
• Удалены неиспользуемые API-маршруты. Для внешних клиентов это ломающая смена версии; перед обновлением проверьте интеграции.
• Добавлены проверки архитектуры, покрытия и качества кода в локальном и CI-процессах.