Поверхности изменений

Платформа фиксирует изменения на четырёх независимых поверхностях. Какая нужна тебе — зависит от того, что ты потребляешь.

1. Capability-changelog агентской поверхности (обязателен агентам)

Агентская read-поверхность (API + MCP) несёт собственную версию — она видна как serverInfo.version при MCP-подключении и эхом в туле start_here. Отличается от закэшированной — поверхность изменилась.

• Как потреблять: передай кэшированное значение как last_seen_version в start_here; поле whats_new перечислит ровно те записи, которые ты ещё не принял. Полная история — MCP-ресурс changelog://entherium.
• Контракт: записи структурированы (added / changed / deprecated), новые первыми, версии монотонные с якорем-датой.

2. Релиз-ноты модулей

Модули платформы (бэкенд, web UI, contracts, сервисы, этот портал) версионируются по SemVer независимо, автоматически из истории коммитов. Каждый модуль несёт свой CHANGELOG.md в репозитории; зонтичная версия платформы отслеживает целое.

3. Версии пайплайнов

Collect / Generate / Localize версионируются отдельно в каталоге пайплайнов — это намеренно другая ось, нежели релизы модулей (см. Жизненный цикл версий). Обоснование новой версии пайплайна записывается прямо в запись каталога.

4. Собственные content-хэши этого портала

Каждая сборка документации эмитит manifest.json — карту роут → content-хэш по всем страницам. Агент, закэшировавший доку, сравнивает свою карту с текущей и перечитывает только те роуты, у которых хэш сдвинулся; остальное тянуть не нужно. См. For LLM agents.

Правило, которое держит changelog честным

Записи пишутся для потребителей («теперь ты можешь читать доску», «смысл этого поля изменился») — никогда как дайджест коммитов. Если изменение не меняет того, что потребитель может сделать или наблюдать, ему не место на поверхностях 1 и 4.