Function computeRequiredCheckStatus

github/githubclient/client.go:786–843

computeRequiredCheckStatus determines the aggregate check status considering only the checks whose name/context appears in requiredChecks. If a required check hasn't reported yet (not present in contexts), it is treated as pending.

(contexts []checkContextNode, requiredChecks map[string]bool)

// If a required check hasn't reported yet (not present in contexts), it is
// treated as pending.
func computeRequiredCheckStatus(contexts []checkContextNode, requiredChecks map[string]bool) github.CheckStatus {
	// Track which required checks we've seen
	seen := make(map[string]bool, len(requiredChecks))
	hasPending := false
	hasFail := false

	for _, ctx := range contexts {
		name := contextName(ctx)
		if !requiredChecks[name] {
			continue
		}
		seen[name] = true

		switch ctx.TypeName {
		case "CheckRun":
			switch ctx.Status {
			case "COMPLETED":
				if ctx.Conclusion == nil {
					hasFail = true
				} else {
					switch *ctx.Conclusion {
					case "SUCCESS", "NEUTRAL", "SKIPPED":
						// pass
					default:
						hasFail = true
					}
				}
			default:
				// IN_PROGRESS, QUEUED, REQUESTED, WAITING, PENDING
				hasPending = true
			}
		case "StatusContext":
			switch ctx.State {
			case "SUCCESS":
				// pass
			case "PENDING", "EXPECTED":
				hasPending = true
			default:
				hasFail = true
			}
		}
	}

	// Any required check that hasn't reported yet is pending
	for name := range requiredChecks {
		if !seen[name] {
			hasPending = true
		}
	}

	if hasFail {
		return github.CheckStatusFail
	}
	if hasPending {
		return github.CheckStatusPending
	}
	return github.CheckStatusPass
}