@taskless-app/swarm 0.3.0 → 0.4.0

package/README.md

@@ -71,6 +71,52 @@ Taskless-аккаунт** и логиньте под ним. Один и тот
 делит один кап и один счётчик дронов (они реально соревнуются за слоты); разные
 аккаунты — полностью независимые капы, без единой правки конфига.
 
+## Несколько машин: закрепить прогон
+
+Один аккаунт может держать демона на нескольких машинах (ноутбук + рабочая станция).
+Очередь у них общая: свободный прогон берёт тот демон, у которого репозиторий прогона
+есть локально. Когда работа обязана идти именно на конкретной машине — закрепите
+прогон за ней:
+
+```bash
+swarm hosts                                  # какие машины есть: имя, пульс, id
+swarm spawn PRJ-42 --host Hunt-gaming-laptop # закрепить прогон за машиной (имя или id)
+```
+
+Закреплённый прогон возьмёт **только** демон этой машины — остальные его не видят.
+Если машина не на связи, прогон её ждёт и на другую **не уезжает**: это осознанный
+выбор оператора, а не сбой (в дашборде `/swarm` видно, какую машину он ждёт и что
+она молчит). Снять закрепление — выбрать «Любая машина» в модалке прогона или
+`swarm_run_upsert{runId, hostId:null}`.
+
+Без `--host` всё работает как раньше: прогон свободен, а машина, которая его взяла и
+потом замолчала на 15 минут, отпускает его обратно в очередь.
+
+## Логи с удалённой машины
+
+Когда дрон спотыкается, нужен сырой лог — а он лежит файлом на машине демона
+(`~/.taskless-swarm/run-logs/<id>/`). Просить владельца машины показать хвост больше
+не нужно: **MCP-тулы отдают его сами**, независимо от того, где выполнялся прогон.
+
+```
+swarm_run_log(runId, lines)      # хвост лога прогона (stdout + stderr дрона)
+swarm_daemon_log(hostId, lines)  # хвост лога самого демона — когда дрон не стартовал вовсе
+```
+
+Прод к демону за домашним роутером не стучится, поэтому запрос уезжает **командой в
+ответе на пульс** — ответ приходит со следующим пульсом (~15с), тул ждёт его сам.
+Отдаётся только ХВОСТ (потолок и по строкам, и по байтам) и только транзитом: в базе
+трекера лог не оседает, строка обмена умирает на чтении. Чужие логи недоступны —
+и запрос, и доставка скоупятся владельцем машины.
+
+Лог самого демона демон не заводит (пишет в stdout) — заведите его перенаправлением
+или укажите свой путь:
+
+```bash
+swarm start --repo <путь> >> ~/.taskless-swarm/overmind.log 2>&1   # путь по умолчанию
+SWARM_DAEMON_LOG=/var/log/overmind.log swarm start --repo <путь>   # свой путь
+```
+
 ## Правообладатель и лицензия
 
 © 2026 Ilya Smurov. Проприетарное коммерческое ПО — см. [LICENSE](./LICENSE).