@mu-crew/mu 3.5.0 → 3.6.0

package/docs/guide/dispatch.md

@@ -114,7 +114,8 @@ mu task wait auth/build auth/docs --first --on-stall exit --json
   commits. If the worker closed without committing, it says so.
 - Exit codes: `0` met, `5` timeout, `6` the owner's pane died,
   `7` the owner sat in `needs_input` for `--stuck-after` seconds
-  (default 300).
+  (default 120). Exit 7 is the default; `--on-stall warn` keeps
+  polling instead.
 
 Exit 7 has several causes: the worker finished but did not close, it
 asked a question, or it hit a prompt. In each case, run

package/docs/guide/getting-started.md

@@ -126,10 +126,15 @@ The exit code tells you what happened:
 | `0` | the task closed | merge the work |
 | `5` | `--timeout` expired (default 600 s) | wait again |
 | `6` | the worker's pane died and the task went back to `OPEN` | spawn and claim again |
-| `7` | the worker sat in `needs_input` for 5 minutes | `mu agent read worker-1 -w auth`, then answer it |
+| `7` | the worker sat in `needs_input` for 2 minutes | `mu agent read worker-1 -w auth`, then answer it |
 
-Without `--on-stall exit`, a stalled worker only prints a warning and
-the wait keeps running.
+`--on-stall exit` is the default; it is spelled out above so older mu
+versions behave the same. With `--on-stall warn`, a stalled worker only
+prints a warning and the wait keeps running.
+
+A pi worker that ends its turn while it still owns an `IN_PROGRESS`
+task gets one reminder to close it or say why not, so exit 7 mostly
+means it is blocked or asking something.
 
 ## Merge the commit
 

package/docs/reference/env.md

@@ -68,7 +68,7 @@ pi agent's `--command`. mu never reads them back.
 | --- | --- | --- |
 | `MU_DELEGATE` | `0` hides the `mu_delegate` tool. `mu doctor` reports it. | unset: shown |
 | `MU_DELEGATE_MAX` | Most delegates one pi session runs at once. Further calls queue, up to four times this; past that `mu_delegate` refuses. A positive integer. | `16` |
-| `MU_NUDGE` | `0` turns off the keep-driving nudge: one reminder when an orchestrator ends a turn with dispatched work still IN_PROGRESS. `mu doctor` reports it. | unset: on |
+| `MU_NUDGE` | `0` turns off both nudges: the keep-driving nudge (one reminder when an orchestrator ends a turn with dispatched work still IN_PROGRESS) and the close nudge (one reminder when a mu-spawned pi worker ends a turn still owning an IN_PROGRESS task). `mu doctor` reports it. | unset: on |
 | `MU_PI_HOME` | Root under which `mu link pi` writes `.pi/` and `.agents/`. | `$HOME` |
 | `PI_CODING_AGENT_DIR` | Read only. pi's agent dir, checked for a linked murmur extension. | `~/.pi/agent` |
 | `MU_EXTENSION_ENTRY` | Test only. Built extension the `mu link pi` shim imports. | `dist/extension/mu-pi.js` |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mu-crew/mu",
-  "version": "3.5.0",
+  "version": "3.6.0",
   "description": "A persistent, observable crew of pi agents running in one tmux or herdr session per workstream, coordinated through a built-in task DAG.",
   "publishConfig": {
     "access": "public"