2.6 KiB
Design
Context
Связанный change arm-core — use-installed-statements-library; обновление аннотаций общей схемы одобрено пользователем 23.10.2026. Файл схемы в docs — источник истины для побайтовых копий сервисов.
Goals / Non-Goals
Goals: согласовать descriptions и явно подтвердить отсутствие изменений валидируемой структуры.
Non-Goals: изменение версии/ограничений контракта, правка docs/source, запуск миграций, обновление runtime других сервисов.
Decisions
Обновить только корневой description и description поля service.statements_version по согласованному тексту arm-core. Проверить глубокое равенство JSON до/после без этих двух аннотаций и точное совпадение файлов docs/arm-core. Использовать существующий валидатор примеров и тест сверки копий. Отдельные дельты требований не нужны (skip_specs: true), поскольку нормативный формат не меняется.
Контекст получает короткие заметки о переходе arm-core; они не объявляют переход остальных сервисов завершённым.
Decisions made without discussion
23.10.2026: сохранить schema_version 2.0 при изменении только descriptions. Обоснование — множество валидных входов и структура результата неизменны. Цена ошибки — неверная маркировка релиза; проверяется сравнением JSON без двух изменённых аннотаций. Обновление общей схемы вместо отката локальной копии выбрано пользователем.
Risks / Trade-offs
[Другие копии схем ещё содержат прежний текст] → перечислить производителей и потребителя в proposal; их копии могут быть синхронизированы отдельными изменениями. [Контекст по другим сервисам не проверялся] → заметки ограничены arm-core.