Function resolveCommitSHAWithRetries

pkg/cli/fetch.go:160–210

(ctx context.Context, owner, repo, ref, workflowPath, host string, verbose bool)

}

func resolveCommitSHAWithRetries(ctx context.Context, owner, repo, ref, workflowPath, host string, verbose bool) (string, error) {
	attempts := len(shaResolutionRetryDelays) + 1
	var lastErr error

	for attempt := 1; attempt <= attempts; attempt++ {
		commitSHA, err := resolveRefToSHAForHost(owner, repo, ref, host)
		if err == nil {
			remoteWorkflowLog.Printf("Resolved ref %s to SHA: %s", ref, commitSHA)
			return commitSHA, nil
		}

		lastErr = err
		remoteWorkflowLog.Printf("Failed to resolve ref %s to SHA (attempt %d/%d): %v", ref, attempt, attempts, err)

		if !isTransientSHAResolutionError(err) {
			retryCommand := fmt.Sprintf("gh aw add %s/%s/%s@<40-char-sha>", owner, repo, workflowPath)
			if hostHint, ok := hostResolutionHintForNotFound(owner, repo, ref, workflowPath, host, err); ok {
				return "", fmt.Errorf(
					"failed to resolve '%s' to commit SHA for '%s/%s'. Expected the GitHub API to return a commit SHA for the ref. %s: %w",
					ref, owner, repo, hostHint, err,
				)
			}
			return "", fmt.Errorf(
				"failed to resolve '%s' to commit SHA for '%s/%s'. Expected the GitHub API to return a commit SHA for the ref. Try: %s: %w",
				ref, owner, repo, retryCommand, err,
			)
		}

		if attempt < attempts {
			delay := shaResolutionRetryDelays[attempt-1]
			if verbose {
				fmt.Fprintln(os.Stderr, console.FormatWarningMessage(
					fmt.Sprintf("Transient SHA resolution failure for '%s' (attempt %d/%d). Retrying in %s...", ref, attempt, attempts, delay),
				))
			}
			if waitErr := waitBeforeSHAResolutionRetry(ctx, delay); waitErr != nil {
				retryCommand := fmt.Sprintf("gh aw add %s/%s/%s@<40-char-sha>", owner, repo, workflowPath)
				return "", fmt.Errorf(
					"failed to resolve '%s' to commit SHA because retry wait was cancelled. Expected the GitHub API to return a commit SHA for the ref. Try: %s: %w",
					ref, retryCommand, waitErr,
				)
			}
		}
	}

	retryCommand := fmt.Sprintf("gh aw add %s/%s/%s@<40-char-sha>", owner, repo, workflowPath)
	return "", fmt.Errorf(
		"failed to resolve '%s' to commit SHA after %d retries for '%s/%s'. Expected the GitHub API to return a commit SHA for the ref. Check rate limits or try: %s: %w",
		ref, len(shaResolutionRetryDelays), owner, repo, retryCommand, lastErr,
	)
}

// hostResolutionHintForNotFound returns a user-facing hint and whether it is applicable.
// hasHint is true only for 404-style resolution failures on non-github.com hosts.