hints

type Context struct {
	Command     string            // Current command being executed
	Subcommand  string            // Subcommand if applicable
	Succeeded   bool              // Whether the operation succeeded
	ErrorType   string            // Type of error if failed
	Args        []string          // Command arguments
	Flags       map[string]string // Command flags
	UserState   UserState         // Current user state
	Environment Environment       // Runtime environment
}

type Environment struct {
	IsTerminal bool   // Whether running in a terminal
	IsCI       bool   // Whether running in CI/CD
	Shell      string // Shell type (bash, zsh, etc.)
	OS         string // Operating system
	WorkingDir string // Current working directory
	IsGitRepo  bool   // Whether in a git repository
}

type Formatter struct {
	// contains filtered or unexported fields
}

type FormatterConfig struct {
	ShowIcons  bool // Whether to show emoji icons
	MaxWidth   int  // Maximum width for text wrapping
	IndentSize int  // Indentation size for structured output
}

type Hint struct {
	Message string   // Human-readable guidance message
	Command string   // Optional specific command to run
	URL     string   // Optional documentation link
	Tags    []string // For context-aware filtering
}

type Provider interface {
	GetHints(ctx Context) []*Hint
	Name() string
}

type ProviderFunc func(Context) []*Hint

type Registry struct {
	// contains filtered or unexported fields
}

type RegistryConfig struct {
	MaxHints    int      // Maximum number of hints to return
	FilterTags  []string // Only include hints with these tags
	ExcludeTags []string // Exclude hints with these tags
	Enabled     bool     // Whether hints are enabled
}

type UserState struct {
	AuthProviders    []string // Configured authentication providers
	HasConfig        bool     // Whether user has configuration file
	IsFirstRun       bool     // Whether this is the first time running
	LastCommand      string   // Last successful command
	ConfiguredOutput string   // User's preferred output format
}