output

type CommandInfo struct {
	// Name is the subcommand name
	Name string `json:"name"`

	// Description is a short description of the subcommand
	Description string `json:"description"`

	// Usage shows how to use the subcommand
	Usage string `json:"usage"`

	// HasSubcommands indicates if this command has further subcommands
	HasSubcommands bool `json:"has_subcommands,omitempty"`
}

type FlagInfo struct {
	// Name is the long flag name (e.g., "output")
	Name string `json:"name"`

	// Shorthand is the short flag (e.g., "o")
	Shorthand string `json:"shorthand,omitempty"`

	// Description describes what the flag does
	Description string `json:"description"`

	// Type is the flag type (string, bool, int, etc.)
	Type string `json:"type"`

	// Default is the default value
	Default string `json:"default,omitempty"`

	// Required indicates if the flag is required
	Required bool `json:"required,omitempty"`
}

type FormatConfig struct {
	// Format is the output format (table, json, yaml)
	Format string

	// NoColor disables ANSI color codes
	NoColor bool

	// Quiet suppresses non-essential output
	Quiet bool

	// Pretty enables human-readable formatting (indentation, etc.)
	Pretty bool
}

type HelpInfo struct {
	// Name is the command name
	Name string `json:"name"`

	// Description is a short description of the command
	Description string `json:"description"`

	// Usage shows how to use the command
	Usage string `json:"usage"`

	// Flags lists all available flags for this command
	Flags []FlagInfo `json:"flags,omitempty"`

	// Commands lists subcommands (for parent commands)
	Commands []CommandInfo `json:"commands,omitempty"`
}

type JSONFormatter struct {
	Indent bool // Whether to pretty-print with indentation
}

type OutputFormatter interface {
	// Format converts data to formatted string output.
	// data should be a struct, slice, or map that can be marshaled.
	Format(data interface{}) (string, error)

	// FormatError converts a structured error to formatted output.
	FormatError(err StructuredError) (string, error)

	// FormatTable formats tabular data with headers.
	// headers defines column names, rows contains data.
	FormatTable(headers []string, rows [][]string) (string, error)
}

type StructuredError struct {
	// Code is a machine-readable error identifier (e.g., "CONFIG_NOT_FOUND")
	Code string `json:"code" yaml:"code"`

	// Message is a human-readable error description
	Message string `json:"message" yaml:"message"`

	// Guidance provides context on why this error occurred
	Guidance string `json:"guidance,omitempty" yaml:"guidance,omitempty"`

	// RecoveryCommand suggests a command to fix the issue
	RecoveryCommand string `json:"recovery_command,omitempty" yaml:"recovery_command,omitempty"`

	// Context contains additional structured data about the error
	Context map[string]interface{} `json:"context,omitempty" yaml:"context,omitempty"`

	// RequestID is the server-generated request ID for log correlation (T023)
	RequestID string `json:"request_id,omitempty" yaml:"request_id,omitempty"`
}

type TableFormatter struct {
	NoColor   bool // Disable ANSI colors
	Unicode   bool // Use Unicode box-drawing characters
	Condensed bool // Simplified output for non-TTY
}

type YAMLFormatter struct{}