`vibe.lock` — файл, который vibe пишет, а вы коммитите: точные версии, которые получил проект. Эта страница объясняет каждое поле, чтобы вы могли прочитать его диф в пул-реквесте и понять, что изменилось.
На рабочее пространство один `vibe.lock`, в самом верхнем корне, рядом с корневым [манифестом](../glossary/index.xml#manifest); у участников своих нет никогда. `vibe install` и `vibe update` его пишут; `vibe clean` его сохраняет; руками его никто не правит. Это записанное решение; дерево зависимостей на диске лишь его следствие, и его всегда можно пересобрать из лока.
| Поле | Смысл |
| `generated_by`, `generated_at` | версия vibe и время последней записи; справочно |
| `schema_version` | схема лока; более старый vibe отказывается от более новой схемы, а не читает её неверно |
| `solver` | резолвер, который произвёл граф |
| `root_dependencies` | координаты, которые манифесты запросили напрямую; база для проверки свежести |
| `language_chain` | разрешённое предпочтение языка и его запасные варианты, чтобы переустановка на другой машине материализовала те же файлы |
`root_dependencies` копирует `[requires.packages]` манифеста, так что [лок-файл](../glossary/index.xml#lock-file) — самодостаточный снимок, для чтения которого манифест не нужен. Удаление корня через `vibe uninstall` убирает его из обоих файлов; удаление пакета, который только транзитивная зависимость, отвергается с объяснением.
| Поле | Смысл |
| `group`, `name`, `version` | координата, которая была разрешена |
| `kind` | вид пакета, для размещения и фильтров |
| `content_hash` | отпечаток поставляемого дерева пакета; идентичность; проверяется при каждом скачивании |
| `registry` | имя реестра, который ответил, из списка манифеста |
| `source_url`, `source_ref`, `resolved_commit` | откуда и на каком git-рефе байты были скачаны в этот раз; справочно, всегда канонический адрес, даже когда отдало зеркало |
| `source_kind` | `registry`, `git`, `override` или `path`: какой путь разрешения произвёл запись; для `path` поле URL держит папку участника относительно корня |
| `dependencies` | разрешённые зависимости этого пакета, точными координатами |
| `overridden` | true, когда пакет поставил `[[override]]` |
| `features`, `subskills` | активные фичи и поднавыки, записанные для пакета |
| `files_written` | файлы проекта, которые установка этого пакета записала вне его собственной папки, чтобы удаление убрало ровно их |
| `via_redirect` | адрес заглушки реестра, которая делегировала пакет в другое место, когда по ней шли; иначе отсутствует |
Изменившийся `version` с изменившимся `content_hash` — обновление. Изменившийся `content_hash` при той же версии в здоровом мире невозможен: vibe отказывает в нём при скачивании, так что если вы видите такое в дифе, кто-то правил файл. Изменившийся только `source_url` — [зеркало](../glossary/index.xml#mirror) или переезд хоста, и для проекта он ничего не значит. Новая запись с `source_kind = "override"` — патч, который кто-то применил намеренно, и в сообщении коммита должна быть причина.
Неизменённый манифест против неизменённого [лок-файла](../glossary/index.xml#lock-file) заставляет `vibe install` вовсе пропустить резолвер: лок и есть ответ.
Лок-файл не записывает ни [индекс](../glossary/index.xml#index-registry) [реестра](../glossary/index.xml#registry), ни зеркало: чтобы воспроизвести его, нужны только [координаты](../glossary/index.xml#coordinate), [отпечатки](../glossary/index.xml#fingerprint) и источник, который может их отдать.
`vibe why <coordinate>` объясняет по лок-файлу и манифестам, почему пакет в проекте или что его заблокировало.
Файл читается строго: поле, которого vibe не знает, — ошибка, а не предупреждение, так что ручная правка или поле из более нового vibe ловится сразу.