Пакет компании

Роли, сценарии и навыки агента переносятся файлом: из одной организации в другую, в git на ревью, в резерв перед большой правкой. Формат файла — holycode.company-package/v1.

Из панелей — одним файлом

• Роли и сценарии. Раздел Персонал → карточка сценариев: «Скачать пакет компании» и «Загрузить пакет…».
• Навыки. Панель агента → Навыки: «Скачать пакетом» и «Загрузить пакет…».

Файл один и тот же: персонал берёт из него роли и сценарии, агент — навыки, остальное каждая сторона пропускает и говорит об этом.

Из консоли — папкой файлов

Утилита company-package раскладывает пакет в папку, удобную для git:

Путь	Что там
holycode-package.json	версия формата, когда выгружено, какие навыки включены
roles/<role_id>@<версия>.json	роль: название, описание, документ роли
pipelines/<pipeline_id>@<версия>.json	сценарий: исходник hpl/v1
skills/<имя>/SKILL.md	навык в обычном формате SKILL.md

Повторная выгрузка в ту же папку заменяет роли, сценарии и навыки целиком — удалённое в организации исчезнет и из папки, и git покажет разницу. В чужую непустую папку без holycode-package.json утилита не пишет.

Что происходит при загрузке

• Выгружается текущая версия каждой роли и сценария (старшая выпущенная, а если выпущенной нет — старшая) и все версии ролей, на которые ссылаются выгруженные сценарии.
• Всё новое ложится черновиками, навыки — выключенными. Агенты продолжают получать то, что было выпущено.
• Номера версий у каждой организации свои. Сценарий ссылается на роль по номеру версии, поэтому при загрузке ссылки переписываются на номера, под которыми роли легли здесь. Поправили роль в файле — появится новая версия роли и новые версии сценариев, которые на неё ссылаются.
• Одинаковое не плодится. Роль, сценарий или навык с тем же содержимым — «уже есть»; повторная загрузка того же пакета ничего не меняет.
• Выпустить сразу (в панели — второй вопрос, в консоли — --publish): выпускается только то, что выпущено в источнике, роли раньше сценариев. Сценарий, чья роль здесь не выпущена, остаётся черновиком — это не ошибка. Навыки включаются так же (--enable) — только включённые в источнике.
• Навык с тем же именем из папки агента не перезаписывается: такие навыки правят в их папке.

Для выгрузки хватает ключа доступа read, для загрузки нужен read, write.