agent hubПУТЕВОДИТЕЛЬ Начать

Документация

Подготовка бета-релиза

Версия кандидата — 0.1.0-beta.1. Первый выпуск распространяется как ZIP исходников и самостоятельный npm tarball. Значение private: true защищает от случайной публикации в реестре, но не мешает установке проверенного локального архива. Имя пакета в npm и публикация в реестре отложены. Команды подготовки не выполняют push, не создают тег или GitHub Release и ничего не деплоят.

Установка кандидата

Нужны Node.js 22.13+ и npm. Распакуйте ZIP исходников, перейдите в его каталог и выполните:

npm ci
npm run install:global
ahub --version
ahub quick

Другой вариант — установить готовый tarball того же кандидата:

npm install --global ./agent-hub-0.1.0-beta.1.tgz
ahub --version

Команда должна показать 0.1.0-beta.1. Оба способа установки могут скачивать зафиксированные зависимости из npm; это не автономный комплект для работы без сети. Используйте npm prefix с правом записи для своего пользователя. Для обновления установите выбранного кандидата заново; сохраняйте стабильные пути Node и установленного приложения, проверяйте новые планы и перезапускайте затронутых клиентов. Удаление пакета не восстанавливает настройки клиентов: если нужно вернуть их, сначала примените проверенный сценарий восстановления.

Проверка точных исходников

Используйте чистую копию с зафиксированным коммитом и зависимостями. Личный Hub, настройки клиентов, .env, логи, локальное состояние передачи контекста и частные исследования не должны попадать в выпуск или его Git-историю. Корневые локальные файлы AGENTS/CLAUDE, .agents/ и docs/research/ игнорируются; общие правила участия находятся в CONTRIBUTING.md. Перед изменением исключений проверьте игнорируемые файлы.

npm ci
npm run check
npm run test:coverage
npm run package:check
npm run install:check
npm audit --omit=dev --audit-level=moderate
npm audit
npm run release:prepare

Для истории используйте Gitleaks 8.24.3 с командой gitleaks git . --config .gitleaks.toml --redact --log-opts=--all. Конфигурация расширяет стандартные правила и разрешает только документированный вымышленный QA-токен в его fixture-файле.

Полный аудит включает инструменты разработки; его результаты рассматриваются отдельно от production-аудита. Не понижайте зависимости до несовместимых версий и не скрывайте результаты. Проверьте всю достижимую Git-историю и окончательное рабочее дерево сканером фиксированной версии, скрывайте значения в отчётах и разбирайте находки. Чистый отчёт не доказывает отсутствие всех секретов и личных данных. Не переписывайте общую историю автоматически; если найден настоящий секрет, его смена и согласованная очистка — отдельные действия сопровождающего.

Команда release:prepare отказывается работать с изменённой копией, собирает CLI, упаковывает runtime и UI и архивирует отслеживаемые исходники из HEAD. В .tmp/release/0.1.0-beta.1/ появятся устанавливаемый .tgz, исходный .zip, файл SHA256SUMS и манифест release.json с версией, точным коммитом, требованием к Node и хешами файлов. После копирования проверьте контрольные суммы. GitHub Actions проверяет macOS/Linux с Node 22.13 и 24; шаг артефактов готовит те же файлы без публикации релиза. Локальный прогон не доказывает успех удалённого CI.

Условия публичного выпуска

Эти условия остаются открытыми до записи подтверждений. Подготовка не означает одобрение публикации. Если файлы меняются, нужен новый коммит, повтор затронутых проверок, пересборка артефактов и обновление ссылок сайта до публикации.

Workflow релиза на GitHub

Workflow запускается при push тега версии или вручную с существующим тегом. Он проверяет совпадение тега с версией пакета и точным коммитом, сканирует полную историю и запускает все проверки, покрытие, production-аудит и настоящий установщик на macOS/Linux с Node 22.13 и 24. Только после успеха всех заданий создаётся черновик GitHub Release с заметками из changelog, архивами пакета и исходников, контрольными суммами и манифестом точного коммита. Бета-версии помечаются как prerelease. Публикация в npm и деплой сайта не выполняются.

Выполняйте следующие команды только из проверенного репозитория публикации с очищенной историей, когда будете готовы создать черновик на GitHub. Remote должен указывать на нужный GitHub-репозиторий, а коммит тега уже должен быть доступен там:

git tag -a v0.1.0-beta.1 -m "Agent Hub 0.1.0-beta.1"
git push origin v0.1.0-beta.1

Для повтора откройте Actions → Prepare GitHub release → Run workflow и укажите существующий тег версии. Повторный запуск может обновить файлы и заметки черновика; опубликованный релиз он менять откажется. Перед загрузкой проверяются контрольные суммы скачанных артефактов, а коммит их манифеста ещё раз сравнивается с тегом. Локальная подготовка не создаёт тег или релиз.

После рабочего испытания клиентов и визуальной проверки просмотрите черновик и опубликуйте его вручную в GitHub. Сайт ведёт в GitHub-репозиторий и раздел Releases; собственной копии ZIP на сайте нет. Видимость GitHub, приватные сообщения об уязвимостях и первый push исходников остаются отдельными действиями сопровождающего.