> ## Documentation Index
> Fetch the complete documentation index at: https://getpullrequest.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Task states

> Canonical task status, phase, and checkpoint values.

Canonical names are snake\_case on the wire. The app shows friendly labels.

## Status

| Canonical | Friendly | Meaning |
| - | - | - |
| `backlog` | Backlog | Queued / resumable |
| `awaiting_user` | Needs your input | Waiting on your answers |
| `waiting_for_agent` | Waiting for machine | Daemon offline |
| `in_progress` | In progress | Pipeline executing |
| `interrupted` | Interrupted | You stopped the run; checkpoint kept |
| `in_review` | In review | PR open; waiting on merge |
| `completed` | Done | Terminal success |
| `errored` | Failed | Terminal failure; rerun to leave |

## Phase

| Canonical | Friendly |
| - | - |
| `idle` | Idle |
| `planning` | Planning |
| `implementing` | Implementing |
| `testing` | Testing |
| `opening_pr` | Opening pull request |
| `done` | Done |

## Checkpoint

Ordered resume barriers:

```text theme={null}
none
plans_complete
generation_complete
verification_complete
reviews_addressed
summary_complete
pr_complete
notified
```

| Checkpoint | Resting phase |
| - | - |
| `none` | `idle` |
| `plans_complete` | `planning` |
| `generation_complete` | `implementing` |
| `verification_complete` | `testing` |
| `reviews_addressed` | `testing` |
| `summary_complete` | `opening_pr` |
| `pr_complete` | `opening_pr` |
| `notified` | `done` |

## Important transitions

| Event | Result |
| - | - |
| `CLAIM` | → `in_progress` |
| `PLAN_NEEDS_INPUT` | → `awaiting_user` |
| `PR_OPENED` | → `in_review` + `pr_complete` |
| `PR_MERGED` / `NOTIFIED` | → `completed` |
| `HOST_OFFLINE` | → `waiting_for_agent` |
| `USER_INTERRUPTED` | → `interrupted` |
| `FAILED` / verification exhausted | → `errored` |
| `RERUN_REQUESTED` | → `backlog` + checkpoint `none` |

## Invariants

* `completed` means checkpoint `notified` and phase `done`.
* `in_review` means checkpoint `pr_complete`.
* Parked statuses rest at phase `idle`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.