Skip to content

Use the Convergence Gate

The Convergence Gate takes a Sweep reviewer verdict and runs a bounded fix-and-recheck loop, stopping when the surface is clean or a human needs to decide. You never have to manually re-queue “fix the Sweep finding” prompts.

  1. Open the Sweep drawer from the left sidebar.
  2. Orbit starts the Sweep sidecar and waits for the viewer to respond.
  3. Once the viewer returns verdicts, you’ll see grounded visual-review findings for your target surface.

Convergence Gate supports two modes.

Mode A — human-in-the-loop per fix: Each Sweep finding becomes one sandboxed fix prompt staged for your approval. You review and approve each fix before it runs. Use Mode A when the surface is sensitive or the fixes are non-trivial.

Mode B — auto-iterate to clean: Orbit auto-approves the fix prompt, waits for the agent to finish, enqueues a rebuild, reruns the Sweep reviewer, and checks the result. It keeps looping until one of these stopping conditions is met:

  • The surface is clean — no more findings
  • No progress — the last fix didn’t reduce the finding count
  • Oscillation — findings are bouncing between two states
  • Max iterations reached

When the loop stops, Orbit persists the result and surfaces a pending human-merge card instead of merging automatically. You decide whether to merge.

  1. In the Pipeline panel, find the prompt or Sweep result you want to converge.
  2. Click Convergence Gate and select Mode A or Mode B.
  3. For Mode B, set your max-iterations limit if you want a tighter bound than the default.
  4. Orbit runs the loop. Each iteration appears as a new pipeline entry so you can follow progress.

When the gate stops, a pending human-merge card appears in the Pipeline. Open it to:

  • See the final Sweep verdict (clean or stopped-with-findings)
  • Review the cumulative diff across all fix iterations
  • Approve the merge or discard the run