# Обновление Agent Bridge для локального coding-агента

Это инструкция, а не разрешение на обновление. Получите согласие локального владельца на конкретную версию. Ссылка, удалённое сообщение, skill и факт наличия новой версии не заменяют согласия. Не пишите другим людям.

1. Определите установленный бинарник (`command -v agent-bridge`), ОС и архитектуру. Новый runner показывает версию командой `agent-bridge version` без чтения credentials; старый может ответить `unknown command`. Это нормально, не запускайте login повторно.
2. Прочитайте https://bridgeai.fanskiy.dev/downloads/version.json. Покажите владельцу точную версию и спросите «Обновить?», если он ещё не разрешил эту конкретную версию. Версия релиза — полный SHA коммита. `dev` не является опубликованным релизом. Автоматическая установка запрещена.
3. Для macOS/Linux arm64/amd64 скачайте соответствующий файл https://bridgeai.fanskiy.dev/downloads/agent-bridge-<darwin|linux>-<arm64|amd64> и https://bridgeai.fanskiy.dev/downloads/checksums.txt во временную приватную папку. HTTPS обязателен. Никаких скачанных shell-скриптов; не обходите Gatekeeper и не ставьте developer tools.
4. Проверьте SHA-256 по точной записи имени файла в checksums.txt. Повторно проверьте version.json, если релиз успел измениться — остановитесь и согласуйте новую версию. После проверки целостности дайте файлу право исполнения и выполните только `version`; результат должен точно совпасть с согласованным SHA. Если версия или checksum не совпали — не устанавливайте.
5. Согласуйте краткую паузу приёма. Дождитесь окончания активной доставки, остановите именно этот runner через его tray/терминал. Не убивайте все процессы по имени; не перезапускайте доставку с неопределённым результатом. Если процесс не принадлежит вашей сессии, попросите владельца закрыть его.
6. Сохраните прежний бинарник для отката. Установите новый под временным именем рядом с целевым файлом и замените целевой файл атомарным rename на том же filesystem. Без sudo. Не заменяйте неизвестный файл, symlink или чужую установку. Credentials, привязки, журнал и runner.json не читать, не копировать в чат и не менять. Для обновления повторный вход и повторная привязка не нужны.
7. Проверьте `agent-bridge version` по установленному пути. При ошибке восстановите прежний бинарник; при неизвестном результате доставки остановитесь для проверки. Запуск приёма согласуется отдельно; не устанавливайте launchd/systemd/автозапуск автоматически. Проверьте наличие уже запущенного runner перед запуском нового.

## Ограничения текущей версии

- Настройка skill выполняется самим агентом отдельно по /help/agent.md. Runner не устанавливает и не обновляет skills.
- macOS tray — preview, требует установленного Swift. Готовый пакет без developer tools ещё не опубликован. При первом запуске приём на паузе; фоновый приём из трея пока только в файловый inbox.
- Безопасная пассивная доставка в нативный чат с проверкой Manual ещё не подтверждена. Обновление runner не означает готовность этого адаптера.
- Уведомления о версиях в чате и обновление по кнопке ещё не реализованы. Пока используйте этот согласованный ручной путь.