Function wrapLookupError

pkg/engine/lookup_classify.go:154–167

wrapLookupError enriches a raw `lookup` error with two layers of operator-facing context: 1. The wrap message names the resource kind, namespace, id, and dialed endpoints — the pre-fix chain stripped these and forced the operator to read the chart template trace to recover them. 2. An errors.WithHi

(err error, kind, namespace, docID string, endpoints []string, commandName string)

// Returns nil when err is nil so call sites can use it
// unconditionally after `helpers.ForEachResource`.
func wrapLookupError(err error, kind, namespace, docID string, endpoints []string, commandName string) error {
	if err == nil {
		return nil
	}

	enriched := errors.Wrapf(err,
		"looking up resource kind=%q namespace=%q id=%q on endpoints=%v",
		kind, namespace, docID, endpoints)

	class := classifyLookupError(err)

	//nolint:wrapcheck // WithHint annotates the already-wrapped error chain; double-wrap would obscure the chain.
	return errors.WithHint(enriched, hintForClass(class, commandName, kind, endpoints))
}

// hintForClass returns the human-facing remedy for a classified
// lookup failure. The `talm apply` branch never mentions `--offline`