RED · how I did it- Advancing an open task closes it and moves the workflow to the next step.
- Passing a task directly in the queue closes the queue item without moving the workflow.
- GONE Trying to advance or pause a workflow step whose queue item is already closed fails.
- GONE Repeating the exact same advance command on an advanced step is safely absorbed.
GREEN · how I do it now- Advancing an open task closes it and moves the workflow to the next step.
- Passing a task directly in the queue closes the queue item without moving the workflow.
- NEW Advancing or pausing a step with a closed queue item moves the workflow without rewriting the queue.
- NEW Repeating the exact same advance or pause command is safely absorbed without duplicate work.
WHERE In the OpenRig command-line tool when running `rig workflow project` after a manual `rig queue handoff`.
SCENE You are an operator managing a team of automated agents. You already handed off a task in the queue directly, and now you tell the workflow engine to finish that step and advance to the next one.
- Step open
- Both the workflow step and its queue item are open and active.
- Queue closed
- The queue item was handed off directly, but the workflow is still on this step.
- Moved on
- The step exit is recorded and the workflow has moved to the next step.
- Waiting
- The workflow is paused on this step waiting for an external blocker.
- Failed
- The step failed and recorded an exception for an operator to handle.
- Rejected
- The command was rejected because the queue item was already closed or moved.
- What can happen
- Queue pass · Advance · Mark waiting · Mark failed · Change exit