Function Classify

pkg/tools/lifecycle/classify.go:23–44

Classify maps a transport-level error (stdio MCP, remote MCP, LSP) to one of the typed sentinels in this package, wrapping it so errors.Is matches both the sentinel and the original error. Already-classified errors (any wrapping a sentinel via errors.Is) are returned unchanged. Unknown errors are r

(err error)

// Substring matching is used as a last resort because some upstream SDKs
// wrap their errors with %v (which drops the chain).
func Classify(err error) error {
	if err == nil {
		return nil
	}
	if isClassified(err) {
		return err
	}

	switch {
	case errors.Is(err, exec.ErrNotFound),
		errors.Is(err, os.ErrNotExist),
		errors.Is(err, io.EOF):
		return wrap(ErrServerUnavailable, err)
	}

	var netErr net.Error
	if errors.As(err, &netErr) {
		return wrap(ErrTransport, err)
	}

	return classifyByMessage(err)
}

// isClassified reports whether err already wraps one of the package
// sentinels. Used to make Classify idempotent.