Настроить рабочее пространство

Что происходит

03Агент добавляет в корневой манифест таблицу [workspace] с путями участников и пишет vibe.toml каждого участника руками, с таблицей [package]: участник — обычная папка пакета, а vibe init package размечает другую раскладку, слот в дереве, который описывают страницы для авторов. Членство явное: папка с манифестом, которой нет в списке, участником не считается. Затем он выполняет vibe install в корне: vibe обнаруживает рабочее пространство (workspace), разрешает требования всех участников одним общим разрешением и пишет один лок-файл в корне.

05Одно дерево исходников и один лок-файл в его корне: участники — это папки, разбиение на пакеты логическое, а публикация копирует папку участника в его собственный репозиторий. Команда, запущенная внутри участника, поднимается до корня и работает с корневым локом, так что разработчик может работать внутри подпроекта, не замечая рабочего пространства вокруг.

Руками

091. В корневом vibe.toml объявите участников; глобы разрешены:

cat vibe.toml

[project]
name = "work"
version = "0.0.1"
authors = ["vibevm docs fixtures"]

[workspace]
members = ["packages/*"]

112. Дайте каждому участнику свой vibe.toml с таблицей [package]: те же поля, что пишет vibe init package, с тем видом, который вы имеете в виду:

cat packages/notes-flow/vibe.toml

[package]
group = "org.acme"
name = "notes-flow"
kind = "flow"
version = "0.1.0"
epoch = 1
authors = ["vibevm docs fixtures"]
license = "UPL-1.0"
description = ""
format = "normal"

133. Установите из корня или из любого места внутри рабочего пространства; команда находит корень и разрешает всё дерево:

vibe install --assume-yes --quiet

vibe install: vibe.lock unchanged — nothing to re-resolve (3 nodes up to date)

Один манифест, три роли

15У каждого узла есть файл с именем vibe.toml, и содержимое файла решает, что это за узел. Таблица [package] делает его публикуемым пакетом; таблица [project] — потребителем, который никогда не публикуется; таблица [workspace] — корнем, который называет участников. Узел не может быть одновременно пакетом и проектом, а корень рабочего пространства может быть любым из двух или ни тем, ни другим.

Участники ссылаются друг на друга

17Участник требует соседа по пути, а не через реестр: источником path в своих требованиях. Лок-файл записывает такую зависимость с видом источника path и папкой участника относительно корня, так что лок остаётся переносимым между машинами. Когда рабочее пространство публикуется, путь становится обычной координатой в каждой опубликованной копии.

19Путь — третий источник пакетов рядом с реестрами и git. Участник требует другого по пути во время разработки и по версии после публикации, одной строкой из двух половин: { path = "../flow-wal", version = "^0.1" }. Опубликованная копия называет версию в реестре, которую сможет разрешить внешний потребитель, а путь никогда не покидает рабочего пространства. Плейсхолдер версии, объявленный один раз в корне, заменяет номер, который повторяется у участников.

23Каждый публикуемый участник объявляет свою позицию полем publish в [package]. vibe workspace publish обходит участников от зависимостей к зависимым, пропускает publish = false и останавливается на первой неудаче с отчётом, что опубликовано и что осталось; отката нет, потому что честный частичный отчёт лучше притворной транзакции.

Особые случаи и правила

27Рабочие пространства вкладываются: участник может сам нести таблицу [workspace]. Вложенность группирует участников; отдельных областей разрешения она не создаёт, и единственный лок-файл остаётся в самом верхнем корне.

29vibe install -p <member> сужает то, о чём сообщается, а не то, что разрешается: лок-файл и дерево зависимостей всегда общие для всего рабочего пространства.

31Дерево зависимостей живёт один раз, в корне; участники не получают собственных копий общих пакетов.