@taskless-app/swarm 0.5.0 → 0.6.1

package/README.md

@@ -152,6 +152,65 @@ swarm remove --yes         # отключить машину от роя цел
 машин (её незавершённые прогоны освобождаются и уедут на другие машины) и стирает
 токены. Вернуть — `swarm login && swarm start`.
 
+## Перелогин — одна команда
+
+Токен машины отзывается сам собой: вошли на второй машине, нажали «сбросить токен
+роя», выключили рой тумблером. Демон при этом жив и тикает, но работу не берёт, а в
+логе повторяет одну строку — «токен роя отозван … Почини одной командой: swarm login».
+
+```bash
+swarm login                # и всё: без stop, без start, без чтения логов
+```
+
+Команда сама разруливает демона: увидела поднятого — **гасит его аккуратно** (как
+`swarm stop --wait`: живые дроны доигрывают, новую работу рой в это время не берёт),
+поднимает страницу входа и **поднимает демона обратно** — уже с новым токеном.
+Перезапуск обязателен: токен читается один раз при старте процесса, иначе демон
+продолжил бы стучаться старым.
+
+Ждать нечего — `swarm stop --force` в другом терминале оборвёт дронов и вход пойдёт
+сразу. Демон был погашен до команды — обратно она его не поднимает: было выключено,
+выключенным и останется. Вход не удался или вкладку закрыли — демон возвращается в то
+состояние, в котором был.
+
+## Кем исполнять дрона
+
+Рою всё равно, какой агент внутри: всё, что знает про конкретный харнесс (как
+запустить, как передать задачу, как забрать результат, как понять, что прогон
+умер), спрятано за адаптером в `src/executors/`. Наружу торчит одинаковый прогон.
+
+```bash
+SWARM_EXECUTOR=claude-code swarm start   # по умолчанию: Claude Code (`claude`)
+SWARM_EXECUTOR=codex       swarm start   # Codex CLI (`codex exec`)
+```
+
+Смена исполнителя — это настройка, а не правка демона: очередь, worktree, ревью,
+учёт стоимости, watchdog и воскрешение после обрыва работают одинаково. Что
+различается — прячет адаптер:
+
+| | `claude-code` | `codex` |
+|---|---|---|
+| запуск | `claude -p <промпт>` | `codex exec <промпт>` |
+| продолжить оборванное | `--continue` | `exec resume --last` |
+| MCP-сервер роя | файл `.swarm-mcp.json` + `--mcp-config` | `-c mcp_servers.overmind={…}` |
+| результат прогона | один JSON в конце stdout | поток событий JSONL |
+| сессии (живость дрона) | `~/.claude/projects/<worktree>` | `~/.taskless-swarm/executor-state/codex/<worktree>` |
+| скиллы роли | `--plugin-dir` | текстом в промпте (флага нет) |
+
+Путь к исполняемому файлу, если он не в `PATH`: `SWARM_CLAUDE_BIN` /
+`SWARM_CODEX_BIN`. Неизвестное значение `SWARM_EXECUTOR` — ошибка на старте, а не
+тихий откат на дефолт: «думал, поехали на другом» узнаётся иначе только из счёта.
+
+Оговорки по `codex`: прайсинг его моделей пока пуст, поэтому стоимость таких
+прогонов считается нулём (лучше честный ноль, чем выдуманный тариф), а
+deny-правил на файловые тулы у него нет — дрона прикрывает только теневой HOME.
+Состояние сессий он держит вне git-worktree (иначе дерево было бы вечно грязным
+для `git status`) и, как и транскрипты Claude Code, само оно не подчищается.
+
+Третий харнесс = файл рядом с этими двумя плюс строка в реестре
+(`src/executors/index.ts`). Если для него пришлось тронуть общий код — значит,
+чинить надо интерфейс, а не общий код; на это и стоит `contract.test.ts`.
+
 ## Windows
 
 Рой работает на Windows, но **рекомендуемый способ — WSL2**: там он ведёт себя ровно