feat(issue-33): the job budget travels and the two clocks carry different labels

- wrapper: TIMEOUT falls back to MAM_JOB_TIMEOUT_S (--timeout > env > 3600);
  an invalid value warns and keeps 3600.
- loop: --job-timeout <sec> (run_loop.sh passes it on; refused in the legacy
  shell loop). The runner always hands the wrapper --timeout, so the budget
  the wrapper registers is the one its wait caps come from.
- runner: wait_for_job and the MAM_CHILD_WAIT_S default are budget + 300 s
  (MAM_WAIT_GRACE_S), today's 3900 with no option; an explicit
  MAM_CHILD_WAIT_S still wins.
- subscriber: the wall-clock budget returns 4 (RC_WALL_CLOCK), silence keeps
  2 (RC_NO_EVENT). The wrapper maps both to caller rc 2 and labels the close
  from the rc: wall_clock_timeout vs deadline_timeout; the disk-heartbeat
  grace that ends on the deadline is the wall clock too.
- registry close accepts wall_clock_timeout (engine: -> error); the remote
  runner's deadline and command-timeout details lead with wall_clock_timeout;
  the sub-job table files it CLOSED-UNCONFIRMED (first token, colon stripped).

Test expectations changed only where the contract changed: the loop's
contract_args now starts with --timeout, the subscriber's exit-code docstring
names rc 2/4, and the registry --help capture lists the new close kind.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

.agents/skills/lib_py/delegation/job_subscriber.py

@@ -19,7 +19,9 @@ stdout = event lines only. Diagnostics go to stderr via logging.
 Exit codes:
   0  all watched jobs reached ``completed``
   1  any watched job reached ``error``
-  2  timed out (wall-clock or idle) before all jobs finished
+  2  no event for the idle window (K x N) - the wrapper labels it deadline_timeout
+  3  broker unreachable
+  4  the wall-clock budget (--timeout) ran out - the wrapper labels it wall_clock_timeout
 """
 from __future__ import annotations
 
@@ -47,6 +49,12 @@ logger = logging.getLogger("delegate_job.job_subscriber")
 TERMINAL_EVENTS = ("completed", "error")
 TERMINAL_STATUSES = ("completed", "error", "cancelled")
 STATE_EVENT = "state"
+# Issue #33: which clock ended the wait. The wrapper maps both to a timeout
+# (caller rc 2) and labels the close from them: rc 2 -> deadline_timeout
+# (no event for the idle window, K x N), rc 4 -> wall_clock_timeout (the job
+# budget, --timeout, ran out while events may still have been arriving).
+RC_NO_EVENT = 2
+RC_WALL_CLOCK = 4
 
 
 def _format_line(topic: str, payload: Dict[str, Any]) -> str:
@@ -473,7 +481,7 @@ def _run_subscriber(args) -> int:
                     break
                 logger.error("wall-clock timeout (%.0fs); still pending: %s",
                              wall_timeout, ", ".join(sorted(pending)))
-                return 2
+                return RC_WALL_CLOCK
             if not subscribed:
                 last_event = now
             idle_left = (idle_timeout if first_event_seen else idle_timeout + ack_timeout) - (now - last_event)
@@ -483,7 +491,7 @@ def _run_subscriber(args) -> int:
                     break
                 logger.error("idle timeout (%.0fs, no events); still pending: %s",
                              idle_timeout, ", ".join(sorted(pending)))
-                return 2
+                return RC_NO_EVENT
             wait = min(wall_deadline - now, idle_left, 1.0)
             try:
                 topic, payload = watcher.events.get(timeout=wait)