@mu-crew/mu 3.5.0 → 3.6.0

package/dist/cli.js

@@ -7345,7 +7345,7 @@ async function waitForTasks(db, input, opts) {
   const wantAny = opts.any === true;
   const timeoutMs = opts.timeoutMs ?? 6e5;
   const pollMs = opts.pollMs ?? 1e3;
-  const stuckAfterMs = opts.stuckAfterMs ?? 3e5;
+  const stuckAfterMs = opts.stuckAfterMs ?? DEFAULT_STUCK_AFTER_MS;
   const onStall = opts.onStall ?? "warn";
   const deadline = timeoutMs > 0 ? Date.now() + timeoutMs : Number.POSITIVE_INFINITY;
   for (const ref of refs) {
@@ -7450,7 +7450,7 @@ async function waitForTasks(db, input, opts) {
     if (isDone(snap)) return snap;
   }
 }
-var currentWaitSleep, pollCount, defaultStuckWarn, currentStuckWarn;
+var currentWaitSleep, pollCount, DEFAULT_STUCK_AFTER_MS, defaultStuckWarn, currentStuckWarn;
 var init_wait = __esm({
   "src/tasks/wait.ts"() {
     "use strict";
@@ -7460,6 +7460,7 @@ var init_wait = __esm({
     init_status();
     currentWaitSleep = (ms) => new Promise((resolve9) => setTimeout(resolve9, ms));
     pollCount = 0;
+    DEFAULT_STUCK_AFTER_MS = 12e4;
     defaultStuckWarn = (msg) => {
       process.stderr.write(msg);
     };
@@ -19402,7 +19403,7 @@ async function cmdTaskWait(db, ids, opts) {
   if (ids.length === 0) {
     throw new UsageError("mu task wait: at least one task id is required");
   }
-  const onStallRaw = opts.onStall ?? "warn";
+  const onStallRaw = opts.onStall ?? "exit";
   if (onStallRaw !== "warn" && onStallRaw !== "exit") {
     throw new UsageError(`--on-stall: expected 'warn' or 'exit', got '${onStallRaw}'`);
   }
@@ -19415,7 +19416,7 @@ async function cmdTaskWait(db, ids, opts) {
   }
   const workstreamSet = new Set(refs.map((r) => r.workstreamName));
   const timeoutMs = opts.timeout !== void 0 ? opts.timeout * 1e3 : 6e5;
-  const stuckAfterMs = opts.stuckAfter !== void 0 ? opts.stuckAfter * 1e3 : 3e5;
+  const stuckAfterMs = opts.stuckAfter !== void 0 ? opts.stuckAfter * 1e3 : DEFAULT_STUCK_AFTER_MS;
   const sdkOpts = { timeoutMs, stuckAfterMs };
   if (statusOpt !== void 0) sdkOpts.status = statusOpt;
   if (wantAny) sdkOpts.any = true;
@@ -20170,7 +20171,7 @@ function wireTaskCommands(program) {
     return handle((db) => cmdTaskReparent(db, id, opts), this)();
   });
   task.command("wait <ids...>").description(
-    "Block until the listed tasks reach --status (default CLOSED). Each <id> may be bare (resolves via -w / $MU_SESSION / tmux) or qualified `<workstream>/<name>` (cross-workstream waits don't need -w). Default: every task must reach the target (--all). --any / --first exit on the first one that does; --first additionally prints the firing ref's qualified id to stdout. For unattended waits, pass --on-stall exit so a worker needing attention terminates the wait with exit 7. Exit 0 = condition met; 5 = timeout; 6 = a watched task was reaper-flipped IN_PROGRESS\u2192OPEN (target=CLOSED only); 7 = a worker needs attention (--on-stall exit)."
+    "Block until the listed tasks reach --status (default CLOSED). Each <id> may be bare (resolves via -w / $MU_SESSION / tmux) or qualified `<workstream>/<name>` (cross-workstream waits don't need -w). Default: every task must reach the target (--all). --any / --first exit on the first one that does; --first additionally prints the firing ref's qualified id to stdout. A worker needing attention terminates the wait with exit 7 (--on-stall exit, the default). Exit 0 = condition met; 5 = timeout; 6 = a watched task was reaper-flipped IN_PROGRESS\u2192OPEN (target=CLOSED only); 7 = a worker needs attention (target=CLOSED, unless --on-stall warn)."
   ).option(
     "--status <status>",
     `target status (${TASK_STATUS_LIST}, case-insensitive); default CLOSED`
@@ -20179,14 +20180,14 @@ function wireTaskCommands(program) {
     "succeed as soon as ONE listed task reaches the target (default: all must). Reports THAT one fired, not which: --json leaves `firing` null even on success, so use --first if you need to identify the ref."
   ).option(
     "--first",
-    "alias for --any that ALSO prints the firing ref's qualified id to stdout and populates `firing` in --json (which --any leaves null). Use to drive a single-shot dispatch loop: `closed=$(mu task wait a b --first --on-stall exit --json | jq -r .firing.qualifiedId)`."
+    "alias for --any that ALSO prints the firing ref's qualified id to stdout and populates `firing` in --json (which --any leaves null). Use to drive a single-shot dispatch loop: `closed=$(mu task wait a b --first --json | jq -r .firing.qualifiedId)`."
   ).option("--timeout <seconds>", "max seconds to wait (0 = forever, default 600)", parseLines).option(
     "--stuck-after <seconds>",
-    "the TRIGGER: mark an IN_PROGRESS task as needing attention when its owner has been in needs_input for >= N seconds since their last status change (0 = disable, default 300). needs_input has several causes \u2014 the worker may have finished without closing, be waiting on an answer, or be sitting at a prompt \u2014 so the warning names the observation and points at `mu agent read <owner>`, which is the next move in every case. The default ACTION is `warn` (keep polling); see --on-stall exit to terminate the wait instead.",
+    "the TRIGGER: mark an IN_PROGRESS task as needing attention when its owner has been in needs_input for >= N seconds since their last status change (0 = disable, default 120). needs_input has several causes \u2014 the worker may have finished without closing, be waiting on an answer, or be sitting at a prompt \u2014 so the warning names the observation and points at `mu agent read <owner>`, which is the next move in every case. The default ACTION is `exit` (exit 7); see --on-stall warn to keep polling instead.",
     parseLines
   ).option(
     "--on-stall <action>",
-    "the ACTION when --stuck-after fires: 'warn' (default; yellow attention warning naming the owner + age, plus a corroborating agent_logs event; wait keeps polling) or 'exit' (same emit + persist, then exit 7 = STALL_DETECTED so an unattended orchestrator can branch on the idle-vs-dead distinction). Suppressed when --status is anything other than CLOSED (mirrors exit-6's carve-out). If exit-6 (dead pane) and exit-7 (stall) would fire in the same poll, exit 6 wins (dead pane is unambiguous; stall is ambiguous)."
+    "the ACTION when --stuck-after fires: 'exit' (default; yellow attention warning naming the owner + age, plus a corroborating agent_logs event, then exit 7 = STALL_DETECTED so an orchestrator can branch on the idle-vs-dead distinction) or 'warn' (same emit + persist; wait keeps polling). Suppressed when --status is anything other than CLOSED (mirrors exit-6's carve-out). If exit-6 (dead pane) and exit-7 (stall) would fire in the same poll, exit 6 wins (dead pane is unambiguous; stall is ambiguous)."
   ).option(...WORKSTREAM_OPT).option(...JSON_OPT).action(function(ids) {
     const opts = this.opts();
     return handle((db) => cmdTaskWait(db, ids, opts), this)();