> Перевод даётся для удобства чтения. Нормативным является английский оригинал. # Версионирование **Спецификация Мета-Вселенной** **Идентификатор документа:** MU-V2-ARCH-002 **Название:** Стандарт архитектуры мета-моделей - стратегия версионирования **Класс документа:** нормативный **Версия:** 2.0 (черновик) **Статус:** рабочий черновик **Нормативные ссылки:** Конституция Мета-Вселенной (MUC), MMAS-Core **Информативные ссылки:** Naming-Conventions, MMAS-Package **Копирайт:** © Orkestron.AI **Лицензия:** Apache-2.0 --- # 1. Назначение Этот документ определяет стратегию версионирования для всех спецификаций Мета-Вселенной, Мета-Моделей и связанных смысловых артефактов. Цель в том, чтобы обеспечить непрерывное развитие, сохраняя смысловую устойчивость, совместимость и прослеживаемость. --- # 2. Область действия Эта спецификация применяется к: - стандартам Мета-Вселенной - Мета-Моделям - Бандлам - Слоям - Схемам - Объектам - Проекциям - Контрактам - Профилям федерации Каждая версия ОБЯЗАНА объявляться явно. --- # 3. Принципы версионирования Версионирование ОБЯЗАНО: - быть явным; - быть неизменяемым после публикации; - сохранять прослеживаемость; - поддерживать сосуществование нескольких версий; - отличать смысловые изменения от редакционных. Ни одна опубликованная версия НЕ ДОЛЖНА изменяться молча. --- # 4. Независимое версионирование У каждого архитектурного элемента ОБЯЗАН быть собственный жизненный цикл и собственная версия. Примеры: - Спецификация Мета-Вселенной - MUC - MMAS - MUFP - Мета-Модель - Бандл - Слой - Схема - Профиль проекции - Контракт Обновление одного элемента НЕ ДОЛЖНО требовать изменения несвязанных версий. --- # 5. Семантическое версионирование Спецификациям СЛЕДУЕТ следовать семантическому версионированию. MAJOR : Ломающие смысловые изменения. MINOR : Новые совместимые возможности. PATCH : Редакционные исправления, уточнения и несмысловые улучшения. Реализации МОГУТ принимать совместимые внутренние схемы при условии сохранения смыслового значения. --- # 6. Идентичность версии Каждый версионированный артефакт ОБЯЗАН объявлять: - идентификатор; - версию; - дату публикации; - статус; - владельца; - заявление о совместимости. --- # 7. Смысловой отпечаток Номер версии объявляет *намерение*; **смысловой отпечаток** объявляет *идентичность смысла*. Каждая опубликованная версия мета-модели ОБЯЗАНА нести смысловой отпечаток, вычисленный по **нормализованной смысловой структуре** модели - её Объектам, Свойствам, Связям, Событиям, Контрактам и Проекциям, как они определены в [MMAS-Core](MMAS-Core.md), - а НЕ по разметке Markdown, порядку файлов, пробелам или иному оформлению. Отпечатку СЛЕДУЕТ быть криптографическим дайджестом (например `sha256`) канонической детерминированно сериализованной формы смысловой структуры. Два артефакта, значащие одно и то же, ОБЯЗАНЫ давать один и тот же отпечаток, даже если их форматирование различается; любое изменение смысла ОБЯЗАНО давать другой отпечаток. Версионированному артефакту СЛЕДУЕТ объявлять свой отпечаток рядом с идентичностью версии: ```text Version 2.1.0 Semantic Fingerprint sha256: 8D4A...F27C ``` Смысловой отпечаток служит нескольким целям: - **обнаружение смысловой эквивалентности** - подтвердить, что два артефакта означают одно и то же независимо от форматирования и редакционных различий; - **обнаружение скрытой несовместимости** - выявить изменения смысла, которые номер версии не отразил (например, выпуск PATCH, у которого сменился отпечаток); - **проверка совместимости до федерации** - сравнить отпечатки до федерации и решить, нужны ли согласование или сопоставление; - **графы зависимостей и миграций** - использовать отпечатки как устойчивые узлы при построении графов зависимостей версий и миграций по всей федерации. Отпечаток ОБЯЗАН быть воспроизводимым: любая соответствующая реализация, получив ту же смысловую структуру, ОБЯЗАНА вычислить то же значение. Точная каноническая сериализация, разделение смысловых и несмысловых полей и процедура хеширования нормативно определены в [MMAS-Interchange (MUIF)](MMAS-Interchange.md), с проверенным разобранным примером и референсной реализацией. Смысловой отпечаток работает в паре с [каноническим смысловым именем](Naming-Conventions.md), идентифицируя понятие и по устойчивому имени, и по устойчивому смыслу, и является одним из полей метаданных, которые несёт [Смысловой пакет распространения](MMAS-Package.md). --- # 8. Совместимость Каждая опубликованная версия ОБЯЗАНА заявлять свою совместимость с предыдущими версиями. Совместимость СЛЕДУЕТ классифицировать как: - Полностью совместима - Обратно совместима - Вперёд совместима - Требует миграции - Ломающая --- # 9. Сосуществование Несколько версий МОГУТ существовать одновременно. Реализациям СЛЕДУЕТ поддерживать явное согласование версий всякий раз, когда федерация затрагивает разные версии. --- # 10. Устаревание Артефакты СЛЕДУЕТ объявлять устаревшими до удаления. Уведомление об устаревании ОБЯЗАНО указывать: - устаревший артефакт; - замену; - версию объявления устаревшим; - планируемую версию удаления. --- # 11. Миграция Ломающие изменения ОБЯЗАНЫ включать руководство по миграции. Документации по миграции СЛЕДУЕТ описывать: - затронутые понятия; - смысловые различия; - требуемые преобразования; - стратегию совместимости; - примеры. --- # 12. Импортированные стандарты Импортированные смысловые стандарты ОБЯЗАНЫ сохранять свои исходные идентификаторы версий. Локальные расширения ОБЯЗАНЫ поддерживать явное сопоставление между импортированными версиями и локальными расширениями. --- # 13. Сохранение истории Исторические версии ОБЯЗАНЫ оставаться распознаваемыми и воспроизводимыми. Предыдущим версиям СЛЕДУЕТ оставаться публично доступными всегда, когда это возможно. Исторические версии НЕ ДОЛЖНЫ переписываться. --- # 14. Согласование версий Федерированным вселенным СЛЕДУЕТ объявлять поддерживаемые версии при обнаружении возможностей. Если обнаружены несовместимые версии, реализациям СЛЕДУЕТ: - согласовать совместимую версию; - применить смысловые сопоставления; - запросить миграцию; - либо отказаться от федерации. --- # 15. Архитектурные инварианты Смена версии НИКОГДА не должна делать недействительными: - глобальную идентичность; - владение; - происхождение; - прослеживаемость; - соблюдение Конституции. Эти инварианты управляются MUC. --- # 16. Дальнейшие направления Смысловой отпечаток даёт взгляд на развитие через отпечатки, который будущая работа может стандартизировать как **Стандарт смысловой миграции (SMS)**. Такой стандарт рассматривал бы отпечатки как канонические узлы общефедеративного графа зависимостей версий и миграций, определял бы, как преобразования миграции привязываются к парам отпечатков, и задавал бы, как согласующиеся вселенные автоматически выбирают путь миграции. Само вычисление отпечатка тоже может заслуживать небольшого сопутствующего профиля, фиксирующего процедуру нормализации и сериализации, чтобы каждая реализация давала побайтово одинаковые дайджесты. --- # Заключение Версионирование в Мета-Вселенной существует, чтобы сохранять смысловую преемственность. Развитие приветствуется, но каждое изменение обязано оставаться явным, прослеживаемым, совместимым везде, где это практично, и понятным и людям, и ИИ-системам.