Версии

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

Оси

Ось	Где читать	Схема	Меняется, когда
Сборка платформы	version в GET /healthz и /api/status.json	SemVer, выводится из истории релизов	Выходит любой модуль — большинство сборок не трогают то, что может агент
Capability-версия агентов	Заголовок x-capability-version на каждом ответе API · serverInfo.version при MCP-подключении · capability_version в start_here	Привязана к дате, монотонна (2026-09-03.1) — работает простое строковое сравнение	Меняется читающая поверхность агентов: новые/изменённые инструменты, поля, семантика. У каждого бампа есть запись в capability-ченжлоге
API-контракт	info.version в openapi.json (заморожен вместе со сборкой портала)	SemVer	Меняются пути, схемы или объявленные ответы
Сборка портала	versions.json (version, builtAt) · manifest.json (маршрут → хэш содержимого) · бейдж под заголовком каждой страницы	SemVer	Документация переопубликована
Версии пайплайнов	Каталог пайплайнов	На пайплайн, неизменяемые каталоги	Пайплайн «вырезан» заново — см. Жизненный цикл версий

Как обнаружить изменение

• Агентам: кэшируйте capability_version; при каждом переподключении передавайте его в start_here как last_seen_version — changed: true и whats_new и есть ваш дифф. Между подключениями заголовок x-capability-version на любом ответе говорит то же самое без вызова.
• Потребителям доки: сравните сохранённый manifest.json с текущим и перечитайте только маршруты, у которых сдвинулся хэш; .md-двойники несут ETag.
• Всем: changelog.json (JSON Feed 1.1) — машинный двойник заметок о выпусках; подпишитесь на него.

Правила совместимости

1. Аддитивное — молча. Новые эндпоинты, инструменты и необязательные поля появляются без major-бампа контракта; неизвестные поля игнорируйте.
2. Переименования и удаления объявляются заранее. Они попадают в capability-ченжлог в deprecated с заменой, живут рядом минимум одну capability-версию, затем переходят в removed в заметках о выпусках.
3. Ломающие изменения контракта поднимают major контракта и capability-версию в один день; замороженный openapi.json предыдущей сборки портала остаётся доступен в истории выпусков.
4. Версии пайплайнов не мутируют. Изменение — это новый каталог версии; пин каталога решает, какая работает в проде.