Команды среды и расписания

Сверено с выпуском 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