Function FormatErrorChain

pkg/console/console.go:306–330

FormatErrorChain formats an error and its full unwrapped chain in a reading-friendly way. For wrapped errors (fmt.Errorf with %w), each level of the chain is shown on a new indented line. For errors whose message contains newlines (e.g. errors.Join), each line is indented after the first.

(err error)

// indented line. For errors whose message contains newlines (e.g. errors.Join), each
// line is indented after the first.
func FormatErrorChain(err error) string {
	if err == nil {
		return ""
	}

	chain := unwrapErrorChain(err)
	if len(chain) <= 1 {
		return formatMultilineError(err.Error())
	}

	var sb strings.Builder
	sb.WriteString(applyStyle(styles.Error, "✗ "))
	sb.WriteString(chain[0])
	for _, msg := range chain[1:] {
		// Each message in the chain may itself contain newlines (e.g. from errors.Join
		// nested inside a wrapping error); expand them all with consistent indentation.
		for line := range strings.SplitSeq(msg, "\n") {
			if line != "" {
				sb.WriteString("\n  ")
				sb.WriteString(line)
			}
		}
	}
	return sb.String()
}

// unwrapErrorChain walks the error chain via errors.Unwrap and returns a slice of
// individual message contributions, from outermost to innermost. Each entry contains