Совместная работа
Сверено с выпуском 0.36.0, 14.11.2026.
Pulse связывает локальные задачи, агентов и коллег через общий проект. Каждый человек работает со своим Git-клоном. Команда агентов внутри задачи и участники общего проекта — разные сущности.
Подключить коллегу
Что настраивают один раз — подключение, клон, участники, приглашения, что публиковать, друзья для посылок, — живёт в Настройках → «Команда». Работа с общим проектом — доска, лента, обсуждения — на вкладке «Команда» раздела «Дашборд» (она видна, когда подключён командный проект; кнопка «Открыть работу команды» ведёт туда из настроек).
- В Настройках → «Команда» выберите локальный репозиторий, введите название и создайте общий проект.
- Раскройте Участники, выберите роль и создайте приглашение. Код одноразовый, действует семь дней. Передайте его коллеге.
- Коллега входит в свой аккаунт Pulse, вводит код и связывает проект со своим клоном.
- Каждый участник раскрывает Мои локальные задачи и выбирает, какие статусы публиковать. Карточки обновляются автоматически; после отключения сети приложение повторяет синхронизацию. «Снять публикацию» работает и без сети: задача сразу перестаёт быть общей, в списке появляется пометка «снятие ожидает синхронизации», а карточка удаляется с доски при следующем подключении.
Владелец управляет участниками и приглашениями. Участник публикует только собственные задачи. Наблюдатель читает доску. Сервер проверяет права независимо от интерфейса.
Доска показывает вклад каждого участника и общий итог опубликованных задач. При удалении локальной опубликованной задачи удаление карточки ставится в очередь до подключения.
На доске публикуются снимки локальных задач настольного приложения. Отдельная очередь роя 24/7 в Postgres сюда не подключена: слияние её MR само по себе не меняет карточку и не создаёт событие в ленте. Источники и последствия описаны в границах состояний задач.
Что уходит в проект: выбор участника
Рядом со связанным клоном стоит выбор «Публикация моих задач» — три режима и два отдельных разрешения. Ниже переключателей всегда висит список того, что именно уедет при текущем выборе: его видно до нажатия «Сохранить», а не после того, как карточка появилась у коллег.
| Режим | Что уходит |
|---|---|
| Не публиковать | ничего: опубликованные карточки снимаются с доски, присутствие гаснет, новые карточки не уходят |
| Базовый | название задачи, ветка, этап, состояние агента, счётчики ходов и сессий, время агентов и человека |
| Подробный | то же плюс исходный промпт и критерии приёмки — тексты, которые вы написали сами |
Отдельно включаются стоимость ваших задач и присутствие. В режиме «Не публиковать» оба выключаются вместе с ним: выключатель, после которого что-то продолжает уезжать, врёт.
Выключение работает без сети и без отвязки клона: карточки перестают быть общими сразу, а удаление с доски уходит на сервер при следующем подключении — как и ручное «Снять публикацию». Клон остаётся связанным, память и посылки продолжают работать.
Ни в одном режиме не уходят код, диффы, ответы агентов, заметки, имена файлов и локальные пути. Привязка, сделанная до появления переключателя, продолжает работать в базовом режиме: молча перестать делать то, о чём просили, — такая же неправда, как начать делать то, о чём не спрашивали. А тексты и присутствие в ней выключены, потому что их никто не разрешал.
Подробный режим требует сервера, который принимает тексты карточек. Пока сервер о такой возможности не объявил, режим в окне недоступен и рядом написано почему: промпт не отправляется даже «на всякий случай» — сервер, который его выбросит, всё равно его увидит.
Общая доска как рабочее место
Строки доски адресные. Своя задача открывается кнопкой Открыть. У чужой задачи можно запросить передачу — владелец карточки увидит запрос в обсуждении и в списке «Требует внимания» и передаст ветку посылкой (см. ниже). Если клон ещё не связан, доска напоминает об этом.
У карточки есть ответственный и проверяющий — участники проекта. Их назначает владелец или участник; наблюдатель только читает. Назначения имеют собственную версию: если двое меняют их одновременно, второй получает отказ «Назначения уже изменены. Обновите доску», а не перезаписывает чужой выбор. Назначенному и проверяющему запись появляется в «Требует внимания» на дашборде.
Обсуждение карточки — заметки, запросы передачи и запросы ревью. Запрос закрывает владелец карточки, автор записи или владелец проекта; заметки не закрываются. Владелец карточки с назначенным проверяющим может запросить ревью одной кнопкой. Обсуждение хранится на сервере и не содержит кода.
Получение карточки не запускает чужого агента и не даёт доступа к его сессии: доска сообщает состояние, а работа продолжается в вашем клоне после передачи ветки.
Лента событий
Переключатель Лента на вкладке «Команда» дашборда отвечает на вопрос «что произошло», а доска — «что сейчас». В ленту попадают: кто присоединился и кого убрали из проекта, публикация и снятие карточки, взятие в работу, приёмка, ошибка агента, просьба передать ветку и просьба проверить, а также сборка и получение посылки по опубликованной карточке.
Записи делает сервер по тому, что видел сам. Поэтому лента начинается не с истории проекта, а с того дня, когда сервер её завёл, и хранит последние записи — старые вытесняются. Задача, которую никто не публиковал, в ленту не попадает даже названием: облако о ней не знает. Названия и ветки сервер берёт из своего снимка карточки, а не из слов приложения, поэтому подменить чужую запись нельзя.
Снятая с доски карточка исчезает с доски, но записи о ней в ленте остаются: лента — журнал того, что было, и вычищать из него случившееся значило бы врать умолчанием.
Про посылки лента говорит ровно то, что известно: «собрал посылку» — файл создан, но Pulse не доставляет его сам и не знает, кто его получил; «принял посылку от N» — имя взято из манифеста. Вывод о подписи в ленту не едет: подпись проверяет получатель у себя, и результат проверки лежит в журнале его задачи, а не на сервере.
Присутствие участников
Рядом с участником в списке видно, работает ли он сейчас, ждёт ли его агент ответа и когда приходил последний сигнал. Возраст сигнала показывается всегда: «работает» без времени читалось бы как «прямо сейчас», а известно только то, когда человек сигналил в последний раз.
Присутствие живёт полторы минуты и гаснет само: закрытое приложение, уснувший ноутбук или потерянная сеть — и строка исчезает, а не висит неправдой. Без связи с облаком присутствие не показывается вовсе и в сохранённый снимок доски не попадает. Пустая строка не означает, что человека нет за компьютером, — она означает, что мы этого не знаем.
Своё присутствие Pulse публикует только с разрешения — отдельным переключателем в блоке «Что уходит в проект». Без него ничего не отправляется, а название задачи уходит, лишь если эта задача уже опубликована в этот проект. Выключение гасит присутствие немедленно, не дожидаясь срока годности на сервере.
Без сети и старый сервер
Без связи с облаком доска показывается из последнего подтверждённого снимка с отметкой времени. Назначения и записи, сделанные без сети, попадают в очередь «Ожидают отправки» и уходят при подключении в том же порядке. Если сервер отверг действие (конфликт версии, нет прав), оно остаётся в очереди с текстом ошибки до вашего решения «Снять»; чужие изменения не перезаписываются молча.
Для назначений и обсуждения нужен сервер Pulse Cloud с миграцией 0010_team_collaboration; он объявляет свои возможности, и старый сервер показывается на странице явным сообщением, а доска и публикация при этом работают. Для самой доски нужна миграция 0009_team_projects, для ленты — 0014_project_events. Присутствие таблицы не требует: сервер держит его в памяти, и после его перезапуска присутствие у всех гаснет до первого нового сигнала. Тексты карточек (texts) сегодня не принимает ни один сервер — подробный режим публикации поэтому недоступен и говорит об этом прямо. Старый сервер без ленты, присутствия и текстов говорит об этом на вкладке, в списке участников и в блоке публикации, а не притворяется, что ему просто нечего показать. Локальный файловый обмен не требует этого API.
Передать код и контекст
В задаче нажмите Передать задачу. Введите, что сделано, как проверить и что осталось. Если авторы работали в отдельных ветках, сначала объедините их результаты с задачей во вкладке Дифф → Результат задачи.
Посылка .pulseparcel содержит Git bundle и контекст. Исходный промпт включается по вашему выбору. Несохранённые файлы можно явно закоммитить перед экспортом. Лимит bundle — 64 МБ. Если ветка уже лежит в общем удалённом репозитории, архив не собирается: в файле только паспорт посылки и контекст.
Перед сборкой Pulse проверяет изменения на секреты и файлы под LFS; при находках отправка требует явной отметки «проверил». Конверт — по выбору: без него посылку прочитает всякий, у кого она окажется; паролем (пароль вы передаёте сами, Pulse его не хранит); или на ключ отправителя, когда отвечаете на его подписанную посылку. Отчёт и название задачи остаются открытыми.
Как доставить. Файл сохраняется у вас на диске; дальше — любым способом или через облако подтверждённому другу: в поле «Кому отправить через облако» выберите контакт. Друзья заводятся в Настройках → «Команда», блок «Друзья и посылки»: заявка по почте, другой человек её принимает — и посылки разрешены в обе стороны. Облако хранит файл до 30 дней и содержимого открытой посылки от себя не прячет. Пришедшая посылка появляется во входящих того же блока: «Принять» открывает окно приёма, «Отклонить» убирает её из ящика (отправитель об этом не узнаёт). Исходящие без связи ждут в очереди («Отправить сейчас»).
Приём: три режима
Получатель выбирает Импорт посылки… (Настройки → «Команда») или «Принять» у посылки из облачного ящика, читает контекст, указывает свой клон и в блоке «Что завести у себя» решает, сколько Pulse заведёт на его стороне:
| Режим | Что появляется у получателя |
|---|---|
| Только ветка | коммиты ложатся в отдельную ветку parcel/<id> — и больше ничего: ни рабочей копии, ни карточки задачи, ни сессии. Посмотреть чужую работу и решить |
| Ветка и задача | плюс отдельная рабочая копия и карточка с отчётом отправителя. Сессии нет |
| Ветка, задача и сессия агента | плюс готовая сессия с отчётом в контексте. Умолчание — прежнее поведение приёма |
Ход агента не запускается сам ни в одном режиме. Даже в третьем сессия создаётся пустой: первый ход запускает человек, потому что тратить чужие деньги по факту открытия файла продукт не вправе.
В режиме «только ветка» карточки нет, поэтому нет и записи о приёме: хранить её негде, а заводить карточку ради записи значило бы сделать то, о чём не просили.
Проверка SHA512 выявляет повреждение содержимого. Имя отправителя подтверждается подписью манифеста: посылка подписывается ключом устройства (Ed25519), подпись проверяется до разбора содержимого, а ключ знакомого отправителя запоминается при первом получении. Дальше возможны три разных вывода, и продукт их не смешивает: подписи нет вовсе (посылка от версии без подписи — отправитель по-прежнему непроверяем, и так и написано), ключ видим впервые (подпись сошлась, но чей это ключ, Pulse не знает) и ключ знакомый. Смена ключа у знакомого имени — отказ: так выглядит и новое устройство, и подмена, различить их изнутри нельзя, поэтому прежний ключ забывается только вручную и только после сверки отпечатка с человеком. Повторный импорт той же посылки не создаёт вторую задачу; посылка с уже принятым идентификатором, но другим коммитом, не принимается вовсе. Посторонние пути и символические ссылки в контейнере не извлекаются.
Если базового коммита нет
Обычная посылка несёт только коммиты ветки поверх общей базы. Когда этого базового коммита в клоне получателя нет — обычное дело после squash-merge и в давно не обновлявшемся клоне, — разворачивать посылку не от чего. Раньше на этом разговор переходил в переписку.
Теперь приём называет недостающий коммит и предлагает сохранить файл-запрос .pulserequest: в нём задача, ветка, тот самый коммит и имя просящего. Отправитель открывает этот файл тем же «Импортом посылки…» — диалог принимает оба вида файлов. Если запрос сошёлся с посылкой, которую задача действительно отправляла, в журнал задачи и в ленту активности попадает запись «просят полную посылку», а собрать её можно одной кнопкой в панели «Посылки»: полная история ветки там уже отмечена. Повторное открытие того же файла второй просьбой не считается. В общую ленту проекта эта запись не идёт: сервер видел бы её со слов приложения, а посылками он не занимается вовсе.
Файл-запрос никем не подписан, а идентификатор задачи лежит в манифесте каждой посылки — значит, похожий файл может собрать всякий, кто хоть раз получал от вас посылку. Поэтому запрос, не сошедшийся с отправленными посылками задачи, показывается с оговоркой и в журнал не записывается: иначе чужой файл подталкивал бы выслать всю историю ветки.
Панель «Посылки»
Кнопка Посылки в шапке задачи открывает журнал: что собрано, что принято, что влито, где был конфликт, какое слияние отменено и кто просит полную посылку. У записи есть время, ветка, размер файла и имя отправителя из манифеста — с той же пометкой, что подписью оно не подтверждено. Пока запрос полной посылки не закрыт новой полной посылкой, он висит на кнопке пометкой «просят полную».
Тот же журнал уходит отдельным разделом «Посылки» в экспорт аудита — и в Markdown, и в JSON: иначе по отчёту нельзя понять, откуда в задаче взялись чужие коммиты и куда ушли свои.
У задач, живших до появления журнала, сохранились только идентификаторы посылок — ни времени, ни подробностей. Такие записи стоят в конце списка и прямо говорят «подробности не сохранились»: выбросить их значило бы показать пустой список там, где посылки были.
Чего Pulse здесь не делает
- Не возит запросы полной посылки. Облако доставляет посылки подтверждённым друзьям, но не просьбы: файл-запрос несёт человек сам.
- Не знает, открыл ли адресат посылку. Для облачной доставки известно «доставлена в облако»; взял ли её человек — нет. Файл, переданный руками, Pulse не отслеживает вовсе: в журнале и в ленте он — «посылка собрана», а не «отправлена такому-то».
- Не подтверждает имя без подписи. Имя отправителя подтверждает только подпись манифеста (см. выше). У посылки без подписи и у файла-запроса имя — строка, которую вписал сам отправитель; SHA512 говорит лишь, что файл не испорчен по дороге.
Ответ обратно
Получатель может экспортировать продолженную задачу обратно. Исходный автор выбирает Ответ в задачу, после чего результат возвращается на проверку. При конфликте слияние остаётся в рабочей копии — его либо разрешают в задаче, либо отменяют отдельной кнопкой; ветка задачи при этом не тронута. Импорт чужой ветки не означает приёмку результата.
Идентичность и память
Клоны связываются по корневым коммитам истории текущей ветки; простой переезд папки или смена адреса remote не создаёт новый проект. Репозиторий с переписанной независимой историей считается другим проектом.
Связанные локальные клоны используют одну память проекта. Прежние записи обоих клонов сохраняются при объединении. Между компьютерами переносится выбранный в посылке контекст; вся локальная память автоматически не публикуется.
Общая доска не редактирует чужие локальные файлы и не показывает фиктивное присутствие коллег: присутствие берётся только из живых сигналов и гаснет вместе с ними. Совместного редактирования текста в реальном времени нет.