Manage stages

staplehire stages create <roleId> --name "Sourced" --position 0
staplehire stages list <roleId>

staplehire stages create <roleId> --name "Phone Screen" --position 1

{
  "stage": {
    "id": "stage_…",
    "role_id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Phone Screen",
    "position": 1
  }
}

ROLE_ID=$(staplehire roles create --jd "Backend engineer…" | jq -r '.role.id')
staplehire stages create "$ROLE_ID" --name "Sourced"      --position 0
staplehire stages create "$ROLE_ID" --name "Phone Screen" --position 1
staplehire stages create "$ROLE_ID" --name "Shortlist"    --position 2

staplehire stages list <roleId>

{
  "stages": [
    { "id": "stage_…", "name": "Sourced", "position": 0 },
    { "id": "stage_…", "name": "Phone Screen", "position": 1 }
  ]
}

staplehire stages list "$ROLE_ID" | jq -r '.stages[] | select(.name == "Sourced") | .id'

staplehire stages candidates <roleId> <stageId>

{ "candidates": [ { "id": "cand_…", "email": "alex@example.com", "name": "Alex Chen" } ] }

EMAIL="alex@example.com"

# Walk every stage to find the existing candidate by email
CANDIDATE_ID=$(staplehire stages list "$ROLE_ID" | jq -r '.stages[].id' | while read -r SID; do
  staplehire stages candidates "$ROLE_ID" "$SID" \
    | jq -r --arg e "$EMAIL" '.candidates[]? | select(.email == $e) | .id'
done | head -1)

staplehire candidates move "$CANDIDATE_ID" --stage-id "$SHORTLIST_STAGE_ID"