Это **опциональный вход**. Ты не обязан соглашаться. Найденное несогласие с любым пунктом ниже — самый ценный результат твоей работы, если оно обосновано.
Всё, что помечено «ИЗМЕРЕНО», получено чтением нашего дерева. Всё остальное — из веб-исследования с дословными цитатами; ты веб не видишь, поэтому проверить эти пункты не можешь и **не должен делать вид, что можешь**.
vibevm публикует **каталог пакетов**: набор JSON-файлов в git-репозитории, который читают ЧУЖИЕ инструменты. Данные В ПОКОЕ, не сетевой протокол. Внешних потребителей **пока ноль** — значит ломающее изменение сейчас бесплатно и потом никогда не будет.
Владелец решил: описать формат схемами и генерировать код из них. Замер перед постройкой нашёл, что цена другая, чем в таблице, по которой решали.
**Новое (важно):** владелец хочет применить те же выводы к парсеру **`vibe.toml`** — манифеста, который пишут РУКАМИ и который едет внутри каждого опубликованного пакета.
Три долговечных формата, и ни один не решён одинаково:
| версия в данных | кто-то ветвится по ней | незнакомый ключ | заповедник для чужих ключей | |
| `vibe.lock` | есть (5) | **да, отвергает** | отвергается | нет |
| каталог индекса | есть (1) | **нет, никто** | отвергается | нет |
| `vibe.toml` | **НЕТ ВОВСЕ** | — | отвергается | нет |
Каталог, детально (`crates/vibe-index/`):
**PyPI, авария PEP 714 — прямое попадание в нашу форму.** Поле, которое бывает «либо булево, либо словарь» — то есть объединение без тега. `pip` падал с `AttributeError: 'dict' object has no attribute 'partition'`. Баг прожил 8 месяцев, попал в дистрибутивы и образы. Ключевое:
«сломанная таким образом версия pip не может установить с PyPI вообще ничего — включая новую, починенную версию pip»
Починка уничтожила бы путь к починке. Пришлось менять спецификацию и переименовывать поле. Оценка альтернативы «подождать, пока вымоется» — **5+ лет**.
**«Поле, которое ты отдаёшь восемь месяцев, ты отдаёшь навсегда.»** PyPI до сих пор, три года спустя, отдаёт опечатанное имя ключа. Переименование обошлось дёшево ровно потому, что читателей было **трое и их можно было обзвонить**.
**Контракт версии (PEP 629), нормативный:**
**Решение из их спора:** поднимать младшую версию имеет смысл, **только если поля, которые она вводит, обязательны на этой версии**. Иначе клиенту незачем её проверять.
**Терпимость нормативна и асимметрична:** писателю «можно добавлять», читателю «**ОБЯЗАН** игнорировать незнакомые ключи». Режима отказа нет вообще.
**Три состояния различены намеренно:** «если ключа нет — файл метаданных может существовать, а может и нет; если значение истинно — существует; если ложно — нет». Отсутствие = НЕИЗВЕСТНО, присутствующее ложное = известно-что-нет.
**Пустая коллекция пишется, а не опускается:** словарь хэшей «ОБЯЗАН присутствовать, даже если хэшей нет».
**Ломающее изменение — новый ПУТЬ, а не новая старшая версия в том же документе.** К этому независимо пришли PyPI и NuGet.
**Заповедник для чужих ключей:** ключи с подчёркиванием зарезервированы, «ни один будущий стандарт не назначит им смысла».
**NuGet — двухуровневый словарь:** документированные ресурсы вечны, недокументированные удаляются по желанию, и это **написано**. Плюс их собственный диагноз: версионирование внутри строки-тега выглядит как развязка сервера и клиента, а на деле связывает их сильнее.
**NuGet — тихий отказ на шесть лет:** фильтр по типу пакета «молча игнорировался всеми совместимыми источниками столько, сколько это свойство существует публично», и починка 2026 года сама стала ломающей.
**Homebrew — как не надо:** схемы нет, версии в данных нет, обещание стабильности — одна фраза в чужом документе, две попытки завести проверку схемы в сборке закрыты нереализованными.
**У протокол-буферов две кодировки, и политика противоположна.** Двоичная терпима и сохраняет незнакомое. JSON-овая: «разборщик должен по умолчанию отвергать незнакомые поля». На жалобы ответ: «используйте двоичную». **Мы наследуем весь набор проблем их JSON-кодировки и не имеем их выхода.**
**Развороты, оплаченные чужой болью:**
**Avro — другая модель:** кладёт **схему писателя вместе с данными**, читатель согласует свою схему с писательской. В сети это дорого; **в git-репозитории это стоит указателя, и история схемы лежит в той же истории, что и данные.**
**Словарь совместимости (его половина индустрии путает):**
Наш случай — **строго FORWARD**. Добавление поля безопасно назад и враждебно вперёд; удаление зеркально. **Терпимый читатель — то, что превращает каждое в полную совместимость.**
**Принятая по умолчанию проверка совместимости НЕтранзитивна**, потому что предполагает, что старые сообщения вымываются. **Для репозитория это ложно.**
**RFC 9413 (2023) отзывает принцип «будь либерален»:** терпимость «входит в патологический цикл обратной связи», «дефект закрепляется как стандарт де-факто». **Оговорка, которую теряют почти все цитирующие:** он бьёт по терпимости к НЕСООТВЕТСТВУЮЩЕМУ входу, а не к ОБЪЯВЛЕННЫМ точкам расширения.
**Критерий переносимости:** практика переносится тогда и только тогда, когда она — свойство **артефакта** или **твоей собственной дисциплины**. Всё, что свойство **отношений** (переговоры, наблюдение, принуждение, трансляция), умирает при соприкосновении с файлом в git.
**НЕ переносится, и это самая часто ошибочно переносимая практика:** «бесверсионная аддитивная эволюция». Ей нужен запрос. **Файл — это ответ, у которого не было вопроса.**
**Когда эти компании сталкиваются с потребителями, которых не контролируют, они версионируют.** Meta держит бесверсионный внутренний интерфейс и явно версионированный внешний с двухлетним сроком. LinkedIn сделал так же и опубликовал, что бесверсионная публичная модель провалилась.
**Про словари консенсуса НЕТ.** Google: добавление значения — не ломающее. Kubernetes (вышел из Google): добавление значения — **не** совместимое. LinkedIn: считайте обратно-несовместимым. Четыре организации независимо изобрели **третью категорию** — «опасное изменение».
**Механическая причина, по которой чинить надо заранее:** незнакомое ПОЛЕ можно пропустить, у него есть адрес. Незнакомое ЗНАЧЕНИЕ словаря обязано быть положено в типизированную ячейку, перечисляющую только известное. Любая починка расширяет ячейку **заранее**. **Ни одну нельзя внедрить в читателей, которые уже разошлись.**
**Все распространённые разборщики по умолчанию бросают исключение.** Две терпимые по умолчанию библиотеки — оба случая, когда издатель схемы сам писал генератор кода читателя.
**Единственный опубликованный рецепт для НЕКОНТРОЛИРУЕМЫХ потребителей** (LinkedIn): не расширять словарь, а **добавить новое необязательное поле с новым перечислением** и поддерживать старых клиентов со старыми символами **бессрочно**. И отдельно: этот приём «не работает для данных, сохранённых в Avro» — то есть в покое становится хуже.
**Разбор аварии Cloudflare (ноябрь 2025) — ближайший аналог нашего случая.** Безобидное изменение прав добавило строк в **сгенерированный файл конфигурации**, файл вырос вдвое, у развёрнутых потребителей был зашит предел → глобальная авария. **Версионный перекос изменил вид отказа:** новые прокси возвращали ошибки, а **старые ошибок не видели и считали неверно** — «всему трафику выставлялся ботовый балл ноль». Старый читатель работал молча, неправильно и уверенно. Их вывод в починку: **ужесточить приём собственных сгенерированных файлов так же, как для пользовательского ввода.**
**Переносится (внедрять первым):** статическая проверка совместимости в сборке — ей не нужен ни сервер, ни телеметрия.
**Аргумент за ОБЯЗАТЕЛЬНУЮ версию:** у Discord бесверсионный маршрут по умолчанию годами заморожен на устаревшей версии — они навсегда пожертвовали возможностью сдвинуть собственное умолчание. **Бесверсионный формат не эволюционирует, он только нарастает.**
**Защита Google — не правило, а БЮДЖЕТ:** «перечисления должны получать новые значения нечасто… не чаще раза в год. Для часто меняющихся использовать строку».