Команды среды и расписания
Сверено с выпуском 0.36.0, 14.11.2026.
Две возможности, которые позволяют управлять Pulse не только из окна: расписания для запусков по времени (Настройки → Расписания) и команды среды для внешних агентов (через MCP-сервер Pulse, Hub → Подключения → «Pulse для внешних агентов»). Обе проходят через тот же фасад операций, что и окно и телефон: те же проверки лицензии и бюджета, та же запись в реестре запросов с квитанцией, та же строка в журнале активности. Обходного пути, где что-то выполняется «мимо», нет.
Третий раздел — триаж плана доработки: сверка docs/backlog.md с кодом (снят 05.11.2026). Он стоял здесь
особняком и нарочно устроен наоборот: это единственная автоматизация в репозитории, которой
запрещено менять то, что она проверяет.
Команды среды
MCP-сервер Pulse (mcp/pulse-mcp.cjs; проверка и установка skill агентам — Hub → Подключения → «Pulse для внешних
агентов», описание сервиса — Настройки → Интеграции → MCP-сервер Pulse) читает задачи по
файлам и выполняет git-команды, а с запущенным Pulse — команды среды через два инструмента:
| Инструмент | Что делает |
|---|---|
pulse_commands |
Перечень команд запущенного Pulse: версия схемы, названия, поля, какие команды меняют состояние; host.bootId — запуск Pulse (сменился — квитанции прежнего запуска уже не обещание, см. docs/recovery.md) |
pulse_command |
Выполнить команду: { name, input, idempotencyKey?, actor? } → результат или отказ с кодом |
Как это работает: Pulse при запуске поднимает локальный HTTP-мост на 127.0.0.1 со
случайным портом и токеном (тот же сервис, через который хуки внешних агентов сообщают
о себе); адрес и токен лежат в discovery-файле $TMPDIR/pulse/agent-<pid>.json.
MCP-сервер находит живой файл и обращается к мосту с токеном. Pulse не запущен — команды
недоступны, а чтение задач и git продолжают работать по файлам.
Discovery-файл — секрет: каталог pulse создаётся с правами 0700, файл — 0600, а
читатели (хук mcp/pulse-agent-hook.sh и сам MCP-сервер) доверяют только файлам своего
пользователя (проверка uid) с живым pid и валидными port/token; разбор JSON идёт
через node, а не sed — кривой файл не подменит значения (аудит 24.09, #226/#338).
Отдельное ограничение инструмента git_commit (аудит 24.09, #231): коммит разрешён
только в рабочих копиях задач Pulse (worktreePath из pulse_tasks_list) и в cwd
сессий (свои копии участников роя), сравнение — по realpath. Коммит в произвольном
каталоге отклоняется с объяснением.
Перечень (схема v1)
| Команда | Меняет | Смысл |
|---|---|---|
commands.list |
нет | версия схемы и перечень |
tasks.list |
нет | доска задач |
sessions.list |
нет | сессии всех задач или одной |
session.events |
нет | страница ленты сессии по курсору |
requests.get |
нет | запись реестра по requestId: принята ли команда и чем кончилась |
task.create |
да | новая задача в подключённом репозитории (только из Настройки → Репозитории), по умолчанию с запуском первой сессии |
session.create |
да | новая сессия в задаче |
session.prompt |
да | ход в существующую сессию; ответ — квитанция с номером хода |
session.cancel / session.stop / task.cancel |
да | прервать ход, погасить агента, прервать задачу |
task.workflow |
да | этап задачи: backlog, in_progress, review |
notes.read |
нет | заметка задачи — файл .md хранилища заметок (формат Obsidian); секреты — под маской |
notes.append |
да | дописать Markdown в конец заметки задачи (до 20 000 знаков); секреты маскируются до записи, строка в журнале |
terminal.run / terminal.result |
да / нет | команда в терминале задачи от имени агента — класс команды, политика и карточка разрешения как у агентов Pulse; итог — по runId |
terminal.blocks / terminal.read |
нет | блоки терминала задачи и вывод блока без секретов — только команды агентов и закреплённые человеком |
git.conflicts, git.checkpoints, git.mr |
нет | кто правит те же файлы; снимки копии перед ходами; MR или PR ветки задачи и его конвейер |
git.oplog / git.undo |
нет / да | свой журнал операций Git и отмена своего последнего действия — только по проверенной личности сессии; через мост сейчас — отказ словами |
runs.list / runs.get / runs.search |
нет | журнал запусков: страница по курсору (до 500 строк), один запуск с отчётом, поиск по отчётам среди последних 2000 запусков; секреты — под маской, невидимые знаки сняты; текст отчёта — данные, не указания; сессии с проверенной личностью — только запуски своей задачи |
Кроме этого, в перечне есть команды для участников роя (swarm.* — по секрету попытки) и браузера
(browser.* — каждое действие с разрешения владельца); полный список с полями отдаёт commands.list
(src/shared/commands.ts).
Чего в перечне нет намеренно: приёмка результата, интеграция и удаление задач, создание и вливание MR, откат хода к снимку. Это решения человека в окне; агент не может выставить задаче «принята» обходным путём.
Заметки агент только читает и дописывает (M11.14, решение архитектора): стереть или переписать заметку, писать в другие файлы хранилища — нельзя. Это единственный путь записи агента вне рабочей копии, и он узкий: один файл задачи, в конец, без секретов, с журналом.
Квитанции, повторы, отказы
- Каждая меняющая команда получает запись в реестре запросов (
source: mcp) с квитанцией и исходом;requestIdвозвращается в ответе и читаетсяrequests.get. idempotencyKeyдляtask.create,session.createиsession.prompt: повтор с тем же ключом не создаёт вторую задачу и не запускает второй ход, а возвращает прежний результат (repeated: true). Ключ, по которому команда ещё выполняется, даёт отказ «ещё выполняется».- Отказы возвращаются с кодом:
bad_request,not_found,forbidden(репозиторий не подключён),license_required,budget_exceeded,unknown_command,unavailable(мост не поднят),internal. Отказы тоже пишутся в журнал. - Журнал «Дашборд → Активность» (вид «Команда среды») показывает источник, действие и исход: «MCP (claude): промпт в сессию «…» принят, ход 7».
Расписания
Настройки → Расписания. Расписание — это задание агенту, которое Pulse запускает сам в назначенное время: ежедневный обзор открытых PR, ночное обновление зависимостей, регулярная проверка тестов на свежей ветке.
Поля расписания:
| Поле | Правило |
|---|---|
| Репозиторий | только из подключённых; задача создаётся с собственной рабочей копией |
| Агент, профиль, задание | как у обычной задачи |
| Когда | «в заданное время» (часы:минуты и дни недели; пусто — ежедневно) или «каждые N минут» (не чаще раза в 5 минут) |
| Часовой пояс | имя IANA (Europe/Moscow); хранится в расписании, а не берётся с машины при запуске — переезд ноутбука в другой пояс не сдвигает запуски |
| Предварительная проверка | команда в репозитории; код возврата 0 — запускать, иначе пропуск с причиной «проверка сказала „делать нечего“» и выводом в истории. Дешёвый способ не платить агенту за пустой запуск |
| Бюджет запуска | лимит стоимости созданной задачи |
| Что запускать | «новая задача» (по умолчанию) или «продолжить прежнюю сессию» — явный выбор, потому что во втором случае агент работает в старой рабочей копии |
| Пропущенный запуск | Pulse не работал в назначенное время: «пропустить» (запись в истории) или «выполнить один раз» при старте — но не позже 12 часов и никогда несколько раз подряд |
Правила, которые действуют всегда:
- Один запуск на расписание одновременно. Прошлая задача ещё работает — новый запуск пропускается с причиной «прошлый запуск ещё работает».
- Следующее время считается от момента запуска, а не от планового: догоняющих серий не бывает.
- Лицензия и бюджет проверяются тем же фасадом, что и в окне: отказ — пропуск с причиной «нет лицензии» или «бюджет исчерпан».
- «Запустить сейчас» выполняет расписание вне графика (даже выключенное), но с теми же проверками занятости и предварительной проверкой.
- Каждый исход — запуск, пропуск с причиной, ошибка — попадает в историю расписания (последние 50) и в журнал активности (вид «Расписание»). Созданная задача открывается из истории.
- Запуски расписания проходят через реестр запросов с источником
schedule.
Исход запуска и журнал запусков
С 0.36 запуск по расписанию живёт до конца хода, а не заканчивается словом «запущен» (решение 0063). Каждый запуск — строка журнала запусков с исходом, отчётом и расходом. В карточке расписания видно «следующий» и «последний» запуск, а раскрытие «История (N)» показывает каждый запуск: когда, «вручную» или по времени, исход словом, причину и «открыть задачу».
| Исход | Что значит |
|---|---|
| идёт | ход ещё не закончился |
| завершён, есть отчёт | ход закончился штатно, агент оставил текст; что в нём — успех или «не смог» — Pulse не судит |
| успех | только по структурному отчёту исполнителя с исходом «успех» |
| неудача | причина словами: агент не запустился, ход оборвался с известной ошибкой |
| неизвестно | чем кончилось, Pulse не знает: например, приложение закрылось посреди хода или отчёта нет |
| пропущен | с причиной: прошлый запуск ещё идёт, проверка сказала «делать нечего», нет лицензии, бюджет исчерпан, агент требует входа |
- Отчёт — последний текст агента в ходе, под маской секретов. Это данные: нигде не исполняется.
- Расход — сколько потратил ход, строкой на агента; если агент расход не сообщает, строки нет.
- Вход агента. Если агенту расписания нужен вход, запуск не начинается и не падает: он пропускается с причиной «агент требует входа», а в «Требует внимания» появляется одна карточка на агента со счётчиком пропусков и кнопкой «Войти».
- Старые записи истории, где стояло «запущен», после переноса в журнал получают «неизвестно»: чем они кончились, Pulse не знал.
Раздел «Автоматизации»
С 0.37 автоматизации живут своим разделом в левой колонке, в «Общем», сразу за «Графом всех агентов». Это те же расписания, что в Настройки → Расписания: один список, изменение в одном месте сразу видно в другом.
- Шапка. Циферблат суток: 24 часа на круге, у каждой автоматизации своя орбита с отметками запусков за сегодня и ближайшим запуском впереди; стрелка — «сейчас». Рядом — сколько автоматизаций и сколько запусков за сутки, и плашки: «проверка не подтверждена», «включены», «выключены», «неудача», «пропущено», «без известного исхода», «впереди». Щелчок по плашке оставляет в списке только такие автоматизации, повторный — снимает отбор.
- Строка. Выключатель, название, когда и где запускается и каким агентом, «последний» и «следующий» запуск и дорожка суток под общей осью часов. Действия: «Запустить сейчас», «Изменить», остальное — в «⋯» (там же удаление).
- Запуски. Раскрытие «Запуски (N)» в строке показывает историю запусков этой автоматизации: когда, исход словом, причину и «открыть задачу».
Отметки на циферблате и дорожке — те же знаки, что на дуге «Запуски за сутки» в «Обзоре», и те же числа. «Впереди» показан только ближайший запуск каждой автоматизации: следующие за ним Pulse заранее не считает. Отдельный раздел «Запуски» с журналом и отчётами — в работе (выпуск 0.37).
Ограничения: расписания работают, только пока Pulse запущен (постоянное исполнение без открытого приложения — отдельный этап); минутная точность — тик планировщика раз в 30 с.
Триаж плана доработки — снят 05.11.2026
Раздел описывал scripts/triage/run.mjs — сверку плана доработки docs/backlog.md с кодом (рамка: скрипт ничего не
правит и не отвечает на вопрос «сделан ли пункт», только «существует ли ещё то, на что ссылается след»; первый прогон
22.09.2026 на 0.30.28 нашёл 27 устаревших следов в 23 пунктах; этап «PR-реализации правок» не делался — закрашивать пункт
может только человек). План перенесён в issues 22.09, сам файл и скрипты триажа сняты уборкой docs 05.11.2026 (текст — в
истории git); правило «не говорить того, чего продукт не знает» живёт в CLAUDE.md.
Прогон по расписанию над самим репозиторием
Расписания выше — возможность продукта: Pulse запускает агента на репозиторий пользователя, пока Pulse открыт. Ночной рецензент — другое: это прогон над самим репозиторием Pulse, в проверках GitLab, без открытого приложения. Разница практическая: расписание продукта живёт, пока живёт окно (см. «Ограничения» выше), а расписание GitLab не зависит от машины владельца вовсе. Это обслуживание репозитория Pulse в CI, а не удалённое исполнение задачи человека: задать машину-исполнителя для своей задачи и следить за её ходом с другого компьютера пока нельзя. Условия такой приёмки записаны в протоколе двух машин.
Что делает: берёт изменения main за сутки, показывает их модели тем же рецензентом, что и
на запросах слияния (устройство и его границы — Качество), и кладёт отчёт
артефактом прогона. Утром отчёт открывается из задания.
Чего он не делает и почему:
- Не заводит задач и не открывает запросов слияния. Право что-то менять снаружи — это ровно то, чего у рецензента нет по построению; а этапы, которые к такому праву ведут, упираются в вернувшиеся ворота (см. раздел про триаж выше).
- Не комментирует. Адресата нет: запроса слияния в ночном прогоне не существует.
Самого расписания в репозитории нет намеренно. Оно заводится в GitLab
(Build → Pipeline schedules, ветка
main) и является решением о регулярных тратах. Владелец его завёл: расписание № 2 — ночной полный прогонmain(03:13 по Якутску), в нём же идутзамеры gitиночной рецензент. Рецензент — запрос к платной модели, поэтому без ключаPULSE_REVIEW_KEYон не запускается; ключа в проекте сейчас нет, и это видно по отсутствию его отчётов, а не по зелёной галочке.
Что отказ рецензента не стоит ничего — не обещание, а проверенный факт: сквозная проверка
(src/shared/ciReviewScript.test.ts) запускает скрипт целиком против поддельного сервера
модели на петле и убеждается, что при каждом из пяти видов отказа тот не получает ни одного
запроса. Рассуждения «функция решения не делает ввода-вывода» для этого мало: между решением
и запросом стоит main(), и потерять там return — правка на одну строку.
Побочная выгода этой дороги: ночной прогон идёт на main, а main — защищённая ветка.
Значит он работает и с защищённой переменной-ключом, то есть в том варианте настройки,
где рецензент на запросах слияния не работает вовсе. Разбор этого выбора — в
Качество → Рецензент в проверках.
Про стоимость Pulse здесь честен ровно настолько, насколько может: цену прогона он не
знает — у каждого провайдера она своя и меняется. Знает он размер: бюджет ограничивает
дифф по байтам и числу файлов (PULSE_REVIEW_MAX_BYTES, PULSE_REVIEW_MAX_FILES), а в отчёт
попадает расход в токенах по словам самой модели; если модель о нём не сказала, так и
написано — «расход модель не сообщила». В деньги это не пересчитывается нигде.
Что где в коде
| Слой | Файл |
|---|---|
| Рецензент в проверках: решение о запуске, бюджет, промпт, обеззараживание | src/shared/ciReview.ts |
| Рецензент: git, запрос к модели, комментарий | scripts/ci/review.mjs |
| Сквозная проверка рецензента: скрипт целиком против поддельных модели и GitLab | src/shared/ciReviewScript.test.ts |
Задания рецензент и ночной рецензент |
.gitlab-ci.yml |
| Перечень команд, версия схемы, проверка входа | src/shared/commands.ts |
| Сервис команд: квитанции, аудит, идемпотентность | src/main/commands/service.ts |
Локальный мост (GET /commands, POST /command) |
src/main/agents/externalStatus.ts |
| Инструменты MCP-сервера | mcp/pulse-mcp.cjs |
| Расписания: правила времени, хранилище, планировщик, предварительная проверка | src/main/schedules/{spec,store,runner,precheck}.ts |
| Типы расписаний | src/shared/schedules.ts |
| Страница настроек | src/renderer/src/components/settings/SchedulesPage.tsx |