@taskless-app/swarm 0.4.1 → 0.4.3

package/README.md

@@ -28,12 +28,51 @@ npx @taskless-app/swarm start --repo <путь к репо>      # поднят
 ```bash
 npm i -g @taskless-app/swarm
 swarm login --workspace <slug>
-swarm start --repo <путь к репо>   # держит процесс живым — разбирает очередь, спавнит/будит дронов
+swarm start --repo <путь к репо>   # поднять рой: уходит в фон, терминал остаётся вам
 swarm --help                       # список остальных команд (spawn/ls/questions/answer/…)
 ```
 
+**Демон открепляется от терминала.** `swarm start` не занимает окно: процесс уходит
+в фон, а весь вывод пишется в `~/.taskless-swarm/overmind.log` — тот самый файл, из
+которого агент читает хвост лога удалённо. Посмотреть: `swarm logs -f`. Нужен вывод
+прямо в терминале (отладка, systemd, docker, где фоном занимается супервизор) —
+`swarm start --foreground` (он же `-f`, `--attach`).
+
+Команда не отчитывается о запуске раньше времени: она ждёт, пока демон реально
+поднимется, и только тогда говорит «поднят». Не поднялся — покажет хвост лога с
+настоящей причиной (занятый порт, отсутствующий токен) и завершится с ошибкой.
+
 Полный гайд по настройке и запуску роя — на [taskless.ru](https://taskless.ru).
 
+## Остановить, приостановить, отключить машину
+
+Гасить демона по имени процесса (`pkill -f overmind`) не нужно — есть штатные команды:
+
+```bash
+swarm status               # жив ли демон, на паузе ли рой, сколько дронов в работе
+swarm pause «причина»      # не брать НОВУЮ работу; живые дроны доработают
+swarm resume               # снова брать работу
+swarm stop                 # погасить демона на этой машине
+swarm remove --yes         # отключить машину от роя целиком
+```
+
+**`swarm stop` по умолчанию не обрывает дронов.** Есть живые сессии — команда
+покажет, кто работает, и не станет их убивать: незапушенная работа дрона умирает
+вместе с ним. Дальше выбираете сами: `swarm stop --wait` (дождаться, новую работу
+рой в это время не берёт) или `swarm stop --force` (погасить сейчас, оборвав их).
+
+**Пауза переживает перезапуск.** Она лежит файлом `~/.taskless-swarm/pause.json`,
+поэтому перезагрузка машины не возвращает рой к работе молча. Поставить её можно и
+при лежащем демоне — тогда следующий `swarm start` поднимется уже на паузе. Пауза,
+поставленная из интерфейса Taskless, снимается командой на машине и наоборот:
+состояние одно, и оно же видно в парке машин («на паузе» — не то же самое, что
+«молчит» или «нет работы»).
+
+**`swarm remove` ≠ `swarm logout`.** `logout` забывает токены на этой машине
+(перелогиниться); `remove` выводит машину из роя: гасит демона, убирает её из парка
+машин (её незавершённые прогоны освобождаются и уедут на другие машины) и стирает
+токены. Вернуть — `swarm login && swarm start`.
+
 ## Windows
 
 Рой работает на Windows, но **рекомендуемый способ — WSL2**: там он ведёт себя ровно
@@ -109,14 +148,19 @@ swarm_daemon_log(hostId, lines)  # хвост лога самого демона
 трекера лог не оседает, строка обмена умирает на чтении. Чужие логи недоступны —
 и запрос, и доставка скоупятся владельцем машины.
 
-Лог самого демона демон не заводит (пишет в stdout) — заведите его перенаправлением
-или укажите свой путь:
+Лог самого демона заводится сам: фоновый `swarm start` пишет в
+`~/.taskless-swarm/overmind.log` и ротирует его при старте (прошлый — `.1`). Свой
+путь — `SWARM_DAEMON_LOG`. Смотреть на месте:
 
 ```bash
-swarm start --repo <путь> >> ~/.taskless-swarm/overmind.log 2>&1   # путь по умолчанию
-SWARM_DAEMON_LOG=/var/log/overmind.log swarm start --repo <путь>   # свой путь
+swarm logs            # хвост лога демона (по умолчанию 200 строк)
+swarm logs -n 50 -f   # следить за новыми строками
+swarm log <runId>     # это ДРУГОЕ: лог конкретного прогона
 ```
 
+Запустили с `--foreground` — вывод идёт в терминал, и файла не будет: тогда за него
+отвечает тот, кто перенаправил (systemd, docker, `tee`).
+
 ## Правообладатель и лицензия
 
 © 2026 Ilya Smurov. Проприетарное коммерческое ПО — см. [LICENSE](./LICENSE).