@staff0rd/assist 0.758.0 → 0.759.1

package/README.md

@@ -509,7 +509,7 @@ assist config set next.excludeTypes Epic -g --repo
 Concurrent sessions in one repo can be isolated with native git worktrees instead of keeping multiple physical clones: see [docs/parallel-work.md](docs/parallel-work.md). All of these flags **default off**:
 
 - `worktree.enabled` (parallel work) — spill concurrent sessions into adjacent `<clone>-N` worktrees. Off means every session on the repo shares its single working copy. Either way, closing the last running or waiting session in the clone (drafts aside) stops its card instead of dismissing it while the clone has uncommitted changes or unpushed commits.
-- `worktree.watcher` — starting a backlog run also ensures one starred **watcher** session in the clone itself: a claude session whose prompt is `/watch`, run with `--permission-mode auto`, so the clone keeps fast-forwarding and rebuilding while the run works in its worktree. The watcher's cwd is always the clone, never a worktree. One watcher per clone — a run (fresh or chained) that finds a live one spawns no second, and the reason lands in `daemon.log`; a watcher that has stopped or errored is replaced by the next run. Dismissing the last other session in the clone or any of its worktrees also dismisses the watcher, logged to `daemon.log`; a finished card still showing keeps it alive. Needs `worktree.enabled`, a `/watch` command in the repo, and an `auto-build` run entry in its `assist.yml` (what `assist watch wait --build` invokes).
+- `worktree.watcher` — starting a backlog run also ensures one starred **watcher** session in the clone itself: an `assist watch loop` console session (no claude process, so it costs no tokens while the branch is quiet), so the clone keeps fast-forwarding and rebuilding while the run works in its worktree. A daemon restart (e.g. after an assist rebuild) relaunches a watcher that wasn't stopped from its stored args, logged to `daemon.log`. The watcher's cwd is always the clone, never a worktree. One watcher per clone — a run (fresh or chained) that finds a live one spawns no second, and the reason lands in `daemon.log`; a watcher that has stopped or errored is replaced by the next run. Dismissing the last other session in the clone or any of its worktrees also dismisses the watcher, logged to `daemon.log`; a finished card still showing keeps it alive. Needs `worktree.enabled` and an `auto-build` run entry in its `assist.yml` (what `assist watch wait --build` invokes).
 - `worktree.trunk` (trunk-based) — on, a spilled worktree's branch tracks `origin/<trunk>` so commits land on the mainline. Off, it starts off the remote default branch with no mainline tracking, leaving the session to raise its own branch and PR.
 
   While it is on, a job that commits never runs in the clone: `backlog run <id>` (spawned fresh or chained into from a session already sitting in the clone) and PR checkouts (`review <n>`, `review-pr-comments <n>`) always allocate a `<clone>-N`, even when the clone is idle and clean. Committing there would land the work on the local mainline and leave every later worktree starting from that HEAD. Plain prompts, `spawnInTree` sessions, `draft`/`bug`/`refine` and every other command keep the normal clone-preferring placement, and a session pinned in place stays where it was launched. There is no fallback — if the worktree can't be created the spawn fails with the reason in `daemon.log` rather than dropping the job in the clone. Non-trunk repos are unaffected.