errors

Documentation

Overview

Package errors provides the central CLI error handler that emits a structured JSON/YAML envelope to stderr when --output=json|yaml, and falls back to the existing plain-text logger for text/TUI mode.

Index

• func ExitFunc(code int)
• func HandleFatal(ctx *context.Context, cmd *cobra.Command, err error)
• func HandleUsage(ctx *context.Context, cmd *cobra.Command, format string, args ...any)

Functions

func ExitFunc

func ExitFunc(code int)

func HandleFatal

func HandleFatal(ctx *context.Context, cmd *cobra.Command, err error)

HandleFatal classifies err, emits a structured envelope to stderr when the active --output mode is json or yaml, and terminates the process.

func HandleUsage

func HandleUsage(ctx *context.Context, cmd *cobra.Command, format string, args ...any)

HandleUsage is a convenience wrapper for invalid flag/argument conditions. It formats the message as a UsageError and routes it through HandleFatal.