Pull request lifecycle states
Each queue item in DraftView has a lifecycle state.
State reference
| State label | System state | Meaning | Typical next action |
|---|---|---|---|
| New | ingested | DraftView ingested the PR | Open and start review |
| In review | in_review | A reviewer is actively reviewing | Comment, edit, submit |
| Changes requested | changes_requested | Review feedback is recorded | Wait for author or agent update |
| Waiting on AI | waiting_on_ai | Team expects an AI follow-up | Monitor for revision |
| Addressed | addressed | New commit touched feedback region | Verify and continue review |
| Stalled | stalled | No response in expected window | Nudge or reassign |
| Signed off | signed_off | Maintainer or admin approved | Wait for CI or merge gate |
| Ready to merge | ready_to_merge | Signed off with green CI | Merge in GitHub |
| Merged | merged | PR merged in GitHub | Done |
Key behavior notes
- DraftView can move any non-merged state to Merged when GitHub merge is detected.
- Addressed is region-based, not commit-message based.
- Signed off does not merge the PR automatically.