errs

package

v0.1.1 Latest Latest Go to latest Published: Aug 9, 2026 License: MIT Imports: 2 Imported by: 0

Details

This section is empty.

This section is empty.

func ExitCode(err error) int

ExitCode maps an error to a CLI exit code.

type Code int

Code identifies error categories for exit status mapping.

const (
	CodeGeneric Code = iota + 1
	CodeUsage
	CodeValidation
	CodeNotFound
	CodeConflict
	CodeInternal
)

type Error struct {
	Code    Code
	Message string
	Hint    string
	// contains filtered or unexported fields
}

Error is a user-facing ForgeKit error with optional internal cause.

func AsForge(err error) (*Error, bool)

AsForge returns a ForgeKit error if present.

func New(code Code, message string) *Error

New creates a user-facing error.

func Wrap(code Code, message string, cause error) *Error

Wrap wraps an internal cause with a user-facing message.

func (e *Error) Error() string

func (e *Error) Unwrap() error

func (e *Error) UserMessage() string

UserMessage returns a message safe to print to CLI users.