fix(docker): B1 update shell hooks to gateway verb names

Smoke run 3 showed stop-hook.sh complaining 'Denied: you stopped
without calling a terminal tool' AFTER agents successfully called
i_am_idle() — because the hook listed 9 pre-gateway verb names
(roboco_agent_idle, roboco_task_substitute, etc.) that no longer
exist. Same staleness in bash-guard-hook.sh.

Both hooks now reference current gateway verbs only. stop-hook
branches its suggestion by ROBOCO_AGENT_ROLE so devs see
i_am_done/i_am_blocked, QAs see pass/fail, PMs see complete/escalate_up.

Spec ref: docs/superpowers/specs/2026-05-12-post-smoke-3-fixes-design.md
section B1.

docker/scripts/stop-hook.sh

@@ -1,12 +1,10 @@
 #!/usr/bin/env bash
 # Stop hook — prevent silent exits without a terminal transition.
 #
-# An agent should never "just stop" mid-task. They must call one of the
+# An agent should never "just stop" mid-task. They must call a terminal
-# terminal MCP tools first (roboco_agent_idle, roboco_task_substitute,
+# gateway verb first (i_am_idle, i_am_done, i_am_blocked, pass, fail,
-# roboco_task_escalate, roboco_task_pause, roboco_task_block, submit_qa,
+# i_documented, complete, escalate_up, unclaim) so the task is not left
-# qa_pass/fail, docs_complete, task_complete, task_cancel). Otherwise the
+# stuck in `claimed` / `in_progress` for the PM to hand-unstick.
-# task stays in `claimed` / `in_progress` forever and the PM has to hand-
-# unstick it.
 #
 # This hook blocks the Stop on the first ungraceful attempt (exit 2 with a
 # reminder). If the agent tries to Stop again anyway, SDK state shows
@@ -46,18 +44,27 @@ if (( attempts > allowance )); then
 fi
 
 # First ungraceful attempt: nudge the agent to call a terminal tool.
-cat >&2 <<EOF
+{
-Denied: you stopped without calling a terminal tool. The task is still
+  echo "Denied: you stopped without calling a terminal tool. The task is"
-assigned to you and will not be handed off.
+  echo "still assigned to you and will not be handed off. Call one of:"
-
+  case "${ROBOCO_AGENT_ROLE:-}" in
-Call one of:
+    developer|documenter)
-  - roboco_agent_idle()                       # no work remains
+      echo "  - i_am_done(task_id, notes)   # work submitted for QA"
-  - roboco_task_substitute(reason="...")      # release the task
+      echo "  - i_am_blocked(reason)        # stuck, need PM"
-  - roboco_task_escalate(reason="...")        # escalate to PM
+      echo "  - i_am_idle()                 # no work remains"
-  - roboco_task_pause(checkpoint="...")       # save progress, come back
+      ;;
-  - roboco_task_submit_qa() / qa_pass() / qa_fail() / docs_complete() / task_complete()
+    qa)
-
+      echo "  - pass(task_id, notes) / fail(task_id, issues)"
-Then stop again. If you genuinely cannot transition, a second stop will
+      echo "  - i_am_idle()"
-auto-substitute with reason="stopped_without_transition" (recorded).
+      ;;
-EOF
+    cell_pm|main_pm)
+      echo "  - complete(task_id, notes) / escalate_up(task_id, notes)"
+      echo "  - i_am_idle()"
+      ;;
+    *)
+      echo "  - i_am_idle()  # default terminal verb for any role"
+      ;;
+  esac
+  echo "Then stop again. A second ungraceful stop auto-releases the task (recorded)."
+} >&2
 exit 2

tests/integration/test_stop_hook_verb_names.sh

@@ -0,0 +1,36 @@
+#!/usr/bin/env bash
+# Smoke: stop-hook + bash-guard-hook list current gateway verbs only.
+set -e
+
+cd "$(dirname "$0")/../.."
+
+HOOKS=(docker/scripts/stop-hook.sh docker/scripts/bash-guard-hook.sh)
+
+OLD_VERBS=(
+  roboco_agent_idle
+  roboco_task_substitute
+  roboco_task_pause
+  roboco_task_submit_qa
+  roboco_task_escalate
+  qa_pass
+  qa_fail
+  docs_complete
+  task_complete
+)
+
+for hook in "${HOOKS[@]}"; do
+  for old in "${OLD_VERBS[@]}"; do
+    if grep -q "$old" "$hook"; then
+      echo "FAIL: $hook still references pre-gateway verb: $old"
+      exit 1
+    fi
+  done
+done
+
+# stop-hook must mention at least one current terminal verb
+grep -qE "i_am_idle|unclaim|i_am_blocked|i_am_done|complete|escalate_up" docker/scripts/stop-hook.sh || {
+  echo "FAIL: stop-hook.sh lists no current gateway terminal verb"
+  exit 1
+}
+
+echo "PASS"