30 lines
2.6 KiB
Markdown
30 lines
2.6 KiB
Markdown
# Proposal
|
||
|
||
## Why
|
||
|
||
Описание общей нормализации и `service.statements_version` ещё говорит о копировании исходников. После перехода arm-core на устанавливаемую библиотеку локальные описания актуализированы, но перестали побайтово совпадать с источником в docs.
|
||
|
||
## What Changes
|
||
|
||
- В `contracts/recognition-result.schema.json` актуализируются только два `description`: нормализация библиотекой `arm_statements` и источник версии (непустой VERSION, иначе метаданные дистрибутива `pylib-ai-arm-statements`).
|
||
- Текст синхронизируется с `../arm-core/api/contracts/recognition-result.schema.json`; структура, обязательность полей и ограничения JSON Schema сохраняются.
|
||
- `schema_version` остаётся 2.0: меняются только аннотации документации, а не формат, проверка данных или семантика обработки результата. Правило повышения версии контракта применяется к изменениям поведения/формата, которых здесь нет.
|
||
|
||
## Capabilities
|
||
|
||
### New Capabilities
|
||
|
||
Нет.
|
||
|
||
### Modified Capabilities
|
||
|
||
Нет изменений нормативных требований: documentation-only, `skip_specs: true`.
|
||
|
||
## Impact
|
||
|
||
Сопровождение среза 3b. Связанный дочерний change: `../arm-core/openspec/changes/use-installed-statements-library`. Читатель результата — arm-core, производители — tabular-parser и scan-gateway; runtime-код этих сервисов не меняется. Их обновление текстовых копий схем можно выполнять отдельно; этот change подтверждает совпадение docs и arm-core.
|
||
|
||
## Non-goals
|
||
|
||
Новые поля, типы, enum, изменение MAJOR/MINOR, изменение алгоритмов §7/§11, миграции БД, массовое редактирование исходников сервисов и закрытие вопросов общего выпуска библиотеки. Контекстные документы получают только точечную заметку о статусе arm-core, без объявления миграции других сервисов завершённой.
|