`vibe.toml` — единственный файл, который вы пишете, чтобы описать проект или пакет: его имя, от чего он зависит, откуда берутся пакеты и что он доставляет. Эта страница перечисляет каждую таблицу и поле с их смыслом.
У каждого узла, будь то проект-потребитель, публикуемый пакет или корень рабочего пространства, есть файл с именем `vibe.toml`. Присутствующие таблицы решают роль: `[project]` помечает потребителя, который никогда не публикуется, `[package]` — публикуемый пакет, `[workspace]` — координатора участников; первые две исключают друг друга, третья сочетается с любой из них или ни с одной.
Неизвестные ключи отвергаются, а не игнорируются: [манифест](../glossary/index.xml#manifest), написанный для более нового vibe, чем тот, что его читает, не разбирается, и ошибка называет виновный ключ.
| Поле | Смысл |
| `name` | имя пакета, kebab-case, уникальное внутри группы |
| `group` | пространство имён издателя, перевёрнутый домен вроде `org.vibevm.world`; обязательно; `(group, name)` — идентичность |
| `kind` | один из восьми видов; метаданные, а не идентичность |
| `version` | семантическая версия этого пакета |
| `epoch`, `format` | эпоха манифеста пакета и форма его содержимого (`simple` по умолчанию, `normal` для раскладки из contract и source) |
| `authors`, `license`, `description`, `homepage`, `keywords` | карточка, которую показывает каждый реестр |
| `title`, `abstract` | человекочитаемое имя и сводка из четырёх вопросов, показываемые на полках документации; обязательны для пакетов `doc`, иначе необязательны |
| `authorship` | кто написал прозу пакета `doc`: `human`, `ai` или `mixed`; фильтр читателя, а не атрибуция коммитов |
| `describes` | Package URL исходной библиотеки, которую этот пакет документирует или оборачивает, для поиска по совпадению версий |
| `publish` | позиция участника рабочего пространства при публикации |
`[project]` несёт те же описательные поля для потребителя, без строки версии и без вида.
| Таблица | Смысл |
| `[requires.packages]` | по ключу на требуемую координату; значение — строка ограничения или инлайновая таблица с `version`, источником `git` или `path`, `link` для типа включения в старт и метками видимости `access`, `friend` и `exclude` |
| `[visibility]` | `friends`, `unfriend`, `allow-friends` и `ignore-concept-warnings` для пакета в целом; см. [Видимость зависимостей](../model/dependency-visibility.xml) |
| `[override]` (таблица) | переписывает метки видимости на рёбрах, которыми вы не владеете, ключом `"a -> b"`, или `allow-friends` провайдера, ключом по его координате |
| `[requires] capabilities` | абстрактные умения, которые может удовлетворить любой провайдер, `namespace:name@constraint` |
| `[[requires_any]]` | дизъюнкция: ровно одно из `one_of` должно быть удовлетворено |
| `[provides] capabilities` | умения, которые предлагает этот пакет |
| `[obsoletes]`, `[conflicts]` | пакеты, которые этот вытесняет, и пакеты, которые не могут сосуществовать с ним |
| `[features]` | необязательные, аддитивные наборы содержимого со списком `default`; фичи могут зависеть от фич |
| `[compatibility]` | `min_vibe_version` и `requires_kinds` |
[Фича](../glossary/index.xml#feature) добавляет содержимое и никогда ничего не убирает и не противоречит; `default` перечисляет фичи, активные, когда ничего не сказано, а `--no-default-features` их опускает. Когда два пакета требуют один пакет с разными фичами, резолвер материализует его один раз с объединением. В командной строке активацией управляют `vibe install <coordinate> --features a,b`, `--no-default-features` и `--all-features`.
| Таблица | Смысл |
| `[[registry]]` | упорядоченный список источников пакетов: `name`, `url` (корень организации), `naming`, `auth`, необязательные `index_url` и `token_env` |
| `[[mirror]]` | альтернативный адрес для одного реестра или для любого, пробуется по `priority` и проверяется по отпечатку |
| `[[override]]` | замена источника для одной координаты, в обход реестров |
| `[boot]` | настройки загрузки для всего рабочего пространства; сегодня `link` по умолчанию |
| `[i18n]` | языки `preferred` и `fallback` в проекте; `canonical` и `available` в пакете |
| `[workspace] members` | пути участников рабочего пространства, глобы разрешены |
Локализованный файл лежит рядом с каноническим, с тегом языка перед расширением, `README.ru.md` рядом с `README.md`. Каждый пакет поставляет каноническую форму каждого файла, который перечисляет, а переводы только добавляют к ней, так что проект без перевода на предпочитаемый язык ставится без ошибки. `vibe install --language ru` задаёт предпочтение на один запуск.
| Таблица | Смысл | Где законна |
| `[boot_snippet]` | `source`, файл фрагмента внутри пакета, и `category` для его места в порядке старта; необязательные `when` и предлагаемый `link` | все виды, кроме `doc` |
| `[[skill]]` | `name`, `path`, `description`, необязательные целевые `agents`: [навык](../glossary/index.xml#skill), который агент может установить | все виды |
| `[[binary]]` | `name` и `crate`: инструмент, который vibe собирает при установке и запускает через `vibe bin exec` | виды с кодом; не `doc` |
| `[[mcp_server]]` | `name`, `binary`, `args`: сервер, регистрируемый у агентов | только `mcp` |
| `[hooks]` | базовые пути скриптов `pre-install` и `post-install` | пакеты |
| `[[extension]]` | `id`, `point`, `handler`, необязательные селектор и config: вклад в жизненный цикл | пакеты и проекты |
| `[[embedded_source]]` | неизменяемый внешний источник, на который пакет ссылается, не вендоря его | пакеты-мосты |
[Навык](../glossary/index.xml#skill) — секция манифеста, а не отдельный вид. `include` сужает, какие файлы из `path` проецируются в папку навыков агента, а его отсутствие проецирует всё дерево. Навык может взять своё тело из объявленного `[[embedded_source]]` и добавить ресурсы под папкой `references/`, с тем же отбором include и теми же проверками обхода.
| Таблица | Смысл | Где законна |
| `[[documents]]` | `package` и ограничение `version`: [предмет](../glossary/index.xml#subject), который описывает эта документация; обязательно, повторяемо | `doc` |
| `[documentation]` | `primary` (не больше одной координаты) и `official` (сколько угодно): документация, которую пакет называет своей | все виды |
| `[translates]` | `package` и `version` документации, которую зеркалит этот перевод | `doc` |
| `[navigation]` | `pinned`, пути документов, которые перечисляются первыми, и строки `[[navigation.section]]` с `id` и `title` для папок дерева страниц | `doc` |
| `[media]` | `icon`, `banner`, `preview`: исходные файлы изображений в пределах ограничений карточки | все виды |
Манифест этого перевода, сгенерированный из самого пакета, показывает пакет `doc` с карточкой, [предметом](../glossary/index.xml#subject) и таблицей `[translates]`, которая называет источник.