converge

Run a local, unattended convergence loop on the current branch: review → verify findings → fix → re-review, until the reviewer has nothing left to say at or above Medium severity, then push once. No intermediate round is ever posted to GitHub — findings live in a local scratch file under $RUN_DIR and are deleted the moment they're consumed.

Argument parsing

$ARGUMENTS carries at most one flag: --cap <N>, N in 2..6. Parse it once, up front:

CAP=4
case "$ARGUMENTS" in
  *--cap*)
    CAP=$(printf '%s\n' "$ARGUMENTS" | grep -oE -- '--cap[= ]([0-9]+)' | grep -oE '[0-9]+' | head -1)
    case "$CAP" in
      2|3|4|5|6) ;;
      *) echo "converge: --cap must be an integer in 2..6 (got: ${CAP:-<empty>})" >&2; exit 1 ;;
    esac
    ;;
esac
echo "Cap: $CAP reviews (default 4 when unset)"

CAP counts reviews, not rounds — see "Cap and the loop invariant" below.

Phase 0 — Preflight

Runtime guard, one representative script (proves the whole bin/ PATH entry is present):

command -v swe-workbench-new-run-dir >/dev/null 2>&1 || {
  echo "swe-workbench runtime commands not on PATH — reinstall or update the swe-workbench plugin." >&2
  exit 1
}

Refuse on the default branch or a detached HEAD — the loop commits, so it needs a branch to commit onto:

BRANCH=$(git rev-parse --abbrev-ref HEAD)
DEFAULT_BRANCH=$(git symbolic-ref refs/remotes/origin/HEAD 2>/dev/null | sed 's@^refs/remotes/origin/@@')
[ -n "$DEFAULT_BRANCH" ] || DEFAULT_BRANCH=main
if [ "$BRANCH" = "$DEFAULT_BRANCH" ] || [ "$BRANCH" = "HEAD" ]; then
  echo "converge: refusing to run on '$BRANCH' — check out a feature branch first." >&2
  exit 1
fi
BASE="$DEFAULT_BRANCH"
git fetch origin "$BASE" --quiet || true
if [ -z "$(git diff "origin/$BASE"...HEAD)" ]; then
  echo "converge: no diff between origin/$BASE and HEAD — nothing to converge." >&2
  exit 1
fi

Ownership gate — refuse, do not warn

The loop commits and pushes autonomously, so running it against a PR you don't own is a destructive-by-default hazard, not a style issue. This is a stronger gate than swe-workbench:workflow-address-feedback's owner check, which only shapes prompts.