state

# state - PR State Management

## Purpose

An integrated skill for managing PR states. Handles queue addition, pause, resume, status check, and list view in a single skill.

---

## Required Reference Documents

**You must read `${baseDir}/references/pr-as-ssot.md` before execution.**

Sections to reference from this document:
- **Labels** → Label definitions and rules by state
- **Comments (History)** → State change record format
- **State Machine** → State transition rules
- **CLI Reference** → gh commands

---

## Label Initialization (Run before all actions)

**Before executing any action**, verify that required Labels exist in the repository and create them if they don't exist.

### Required Labels

| Label | Color | Description |
|-------|-------|-------------|
| `state:queued` | `#0E8A16` (green) | PR queued for auto-execution |
| `state:executing` | `#1D76DB` (blue) | PR currently being executed |
| `state:blocked` | `#D93F0B` (red) | PR blocked, needs human intervention |
| `auto-execute` | `#5319E7` (purple) | Opt-in for automatic execution |

### Verification and Creation Logic

```bash
# Function definition
ensure_label() {
  local name="$1"
  local color="$2"
  local desc="$3"

  if ! gh label list --json name -q '.[].name' | grep -q "^${name}$"; then
    gh label create "$name" --color "$color" --description "$desc"
  fi
}

# Verify/create all required Labels
ensure_label "state:queued" "0E8A16" "PR queued for auto-execution"
ensure_label "state:executing" "1D76DB" "PR currently being executed"
ensure_label "state:blocked" "D93F0B" "PR blocked, needs human intervention"
ensure_label "auto-execute" "5319E7" "Opt-in for automatic execution"
```

---

## Input

```
/state <action> [PR#] [options]

actions:
  queue <PR#>                  # Add to queue
  begin <PR#>                  # Start execution
  pause <PR#> <reason>         # Block
  continue <PR#> [--run]       # Resume (--run: execute immediately)
  complete <PR#>               # Execution complet