cli

type CheckResult struct {
	Category string   `json:"category"`
	Name     string   `json:"name"`
	Status   string   `json:"status"` // "pass", "fail", "skip"
	Message  string   `json:"message,omitempty"`
	Hints    []string `json:"hints,omitempty"`
}

type ComposeJobConfig struct {
	core.ComposeJob           `mapstructure:",squash"`
	middlewares.OverlapConfig `mapstructure:",squash"`
	middlewares.SlackConfig   `mapstructure:",squash"`
	middlewares.SaveConfig    `mapstructure:",squash"`
	middlewares.MailConfig    `mapstructure:",squash"`
	JobWebhookConfig          `mapstructure:",squash"`
	JobSource                 JobSource `json:"-" mapstructure:"-"`
}

type Config struct {
	Global struct {
		middlewares.SlackConfig `mapstructure:",squash"`
		middlewares.SaveConfig  `mapstructure:",squash"`
		middlewares.MailConfig  `mapstructure:",squash"`
		LogLevel                string        `gcfg:"log-level" mapstructure:"log-level" validate:"omitempty,oneof=debug info notice warning error critical"` //nolint:revive
		EnableWeb               bool          `gcfg:"enable-web" mapstructure:"enable-web" default:"false"`
		WebAddr                 string        `gcfg:"web-address" mapstructure:"web-address" default:":8081"`
		WebAuthEnabled          bool          `gcfg:"web-auth-enabled" mapstructure:"web-auth-enabled" default:"false"`
		WebUsername             string        `gcfg:"web-username" mapstructure:"web-username"`
		WebPasswordHash         string        `gcfg:"web-password-hash" mapstructure:"web-password-hash"`
		WebSecretKey            string        `gcfg:"web-secret-key" mapstructure:"web-secret-key"`
		WebTokenExpiry          int           `gcfg:"web-token-expiry" mapstructure:"web-token-expiry" validate:"gte=1,lte=8760" default:"24"`           //nolint:revive
		WebMaxLoginAttempts     int           `gcfg:"web-max-login-attempts" mapstructure:"web-max-login-attempts" validate:"gte=1,lte=100" default:"5"` //nolint:revive
		EnablePprof             bool          `gcfg:"enable-pprof" mapstructure:"enable-pprof" default:"false"`
		PprofAddr               string        `gcfg:"pprof-address" mapstructure:"pprof-address" default:"127.0.0.1:8080"`
		MaxRuntime              time.Duration `gcfg:"max-runtime" mapstructure:"max-runtime" validate:"gte=0" default:"24h"`
		AllowHostJobsFromLabels bool          `gcfg:"allow-host-jobs-from-labels" mapstructure:"allow-host-jobs-from-labels" default:"false"` //nolint:revive
		EnableStrictValidation  bool          `gcfg:"enable-strict-validation" mapstructure:"enable-strict-validation" default:"false"`
		// DefaultUser sets the default user for exec/run/service jobs when not specified per-job.
		// Set to empty string "" to use the container's default user.
		// Default: "nobody" (secure unprivileged user)
		DefaultUser string `gcfg:"default-user" mapstructure:"default-user" default:"nobody"`
		// NotificationCooldown sets the minimum time between duplicate error notifications.
		// When a job fails with the same error, notifications (Slack, email, save) will be
		// suppressed until this cooldown period expires. Set to 0 to disable deduplication.
		// Default: 0 (disabled - all notifications sent)
		NotificationCooldown time.Duration `gcfg:"notification-cooldown" mapstructure:"notification-cooldown" validate:"gte=0" default:"0"`
	}
	ExecJobs    map[string]*ExecJobConfig    `gcfg:"job-exec" mapstructure:"job-exec,squash"`
	RunJobs     map[string]*RunJobConfig     `gcfg:"job-run" mapstructure:"job-run,squash"`
	ServiceJobs map[string]*RunServiceConfig `gcfg:"job-service-run" mapstructure:"job-service-run,squash"`
	LocalJobs   map[string]*LocalJobConfig   `gcfg:"job-local" mapstructure:"job-local,squash"`
	ComposeJobs map[string]*ComposeJobConfig `gcfg:"job-compose" mapstructure:"job-compose,squash"`
	Docker      DockerConfig

	WebhookConfigs *WebhookConfigs
	// contains filtered or unexported fields
}

type ConfigShowCommand struct {
	ConfigFile string `long:"config" env:"OFELIA_CONFIG" description:"configuration file" default:"/etc/ofelia/config.ini"`
	LogLevel   string `long:"log-level" env:"OFELIA_LOG_LEVEL" description:"Set log level (overrides config)"`
	Logger     core.Logger
}

type DaemonCommand struct {
	ConfigFile          string         `long:"config" env:"OFELIA_CONFIG" default:"/etc/ofelia/config.ini"`
	DockerFilters       []string       `short:"f" long:"docker-filter" env:"OFELIA_DOCKER_FILTER"`
	DockerPollInterval  *time.Duration `long:"docker-poll-interval" env:"OFELIA_POLL_INTERVAL"`
	DockerUseEvents     *bool          `long:"docker-events" env:"OFELIA_DOCKER_EVENTS"`
	DockerNoPoll        *bool          `long:"docker-no-poll" env:"OFELIA_DOCKER_NO_POLL"`
	LogLevel            string         `long:"log-level" env:"OFELIA_LOG_LEVEL"`
	EnablePprof         bool           `long:"enable-pprof" env:"OFELIA_ENABLE_PPROF"`
	PprofAddr           string         `long:"pprof-address" env:"OFELIA_PPROF_ADDRESS" default:"127.0.0.1:8080"`
	EnableWeb           bool           `long:"enable-web" env:"OFELIA_ENABLE_WEB"`
	WebAddr             string         `long:"web-address" env:"OFELIA_WEB_ADDRESS" default:":8081"`
	WebAuthEnabled      bool           `long:"web-auth-enabled" env:"OFELIA_WEB_AUTH_ENABLED"`
	WebUsername         string         `long:"web-username" env:"OFELIA_WEB_USERNAME"`
	WebPasswordHash     string         `long:"web-password-hash" env:"OFELIA_WEB_PASSWORD_HASH"`
	WebSecretKey        string         `long:"web-secret-key" env:"OFELIA_WEB_SECRET_KEY"`
	WebTokenExpiry      int            `long:"web-token-expiry" env:"OFELIA_WEB_TOKEN_EXPIRY" default:"24"`
	WebMaxLoginAttempts int            `long:"web-max-login-attempts" env:"OFELIA_WEB_MAX_LOGIN_ATTEMPTS" default:"5"`

	Logger core.Logger
	// contains filtered or unexported fields
}

type DecodeResult struct {
	// UsedKeys contains all keys that were present in the input
	UsedKeys map[string]bool

	// UnusedKeys contains keys that were in input but not matched to struct fields
	UnusedKeys []string
}

type Deprecation struct {
	// Option is the deprecated option name (e.g., "slack-webhook", "poll-interval")
	Option string

	// Replacement describes what to use instead
	Replacement string

	// RemovalVersion is the version when this option will be removed
	RemovalVersion string

	// Message is an optional additional message with migration instructions
	Message string

	// KeyName is the configuration key name for presence-based detection.
	// When set, the deprecation is detected if the key is present in the config,
	// regardless of its value (even if set to zero/empty).
	// This is the normalized key name (lowercase, no separators).
	KeyName string

	// CheckFunc returns true if the deprecated option is in use
	// The function receives the global config and checks if the deprecated option is set
	// This is the fallback when KeyName is not set or usedKeys is not available.
	CheckFunc func(cfg *Config) bool

	// MigrateFunc applies backwards-compatible migration from deprecated to new options
	// This is called during config loading to ensure deprecated options still work
	MigrateFunc func(cfg *Config)
}

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

type DockerConfig struct {
	Filters []string `mapstructure:"filters"`

	// ConfigPollInterval controls how often to check for INI config file changes.
	// This is independent of container detection. Set to 0 to disable config file watching.
	ConfigPollInterval time.Duration `mapstructure:"config-poll-interval" validate:"gte=0" default:"10s"`

	// UseEvents enables Docker event-based container detection (recommended).
	// When enabled, Ofelia reacts immediately to container start/stop events.
	UseEvents bool `mapstructure:"events" default:"true"`

	// DockerPollInterval enables periodic polling for container changes.
	// This is a fallback for environments where Docker events don't work reliably.
	// Set to 0 (default) to disable explicit container polling.
	// WARNING: If both events and polling are enabled, this is usually wasteful.
	DockerPollInterval time.Duration `mapstructure:"docker-poll-interval" validate:"gte=0" default:"0"`

	// PollingFallback auto-enables container polling if event subscription fails.
	// This provides backwards compatibility and resilience.
	// Set to 0 to disable auto-fallback (will only log errors on event failure).
	// Default is 10s for backwards compatibility.
	PollingFallback time.Duration `mapstructure:"polling-fallback" validate:"gte=0" default:"10s"`

	// Deprecated: Use ConfigPollInterval and DockerPollInterval instead.
	// If set, this value is used for both config and container polling (BC).
	PollInterval time.Duration `mapstructure:"poll-interval" validate:"gte=0"`

	// Deprecated: Use DockerPollInterval=0 instead.
	// If true, disables container polling entirely.
	DisablePolling bool `mapstructure:"no-poll" default:"false"`
}

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

type DoctorCommand struct {
	ConfigFile string `long:"config" description:"Path to configuration file"`
	LogLevel   string `long:"log-level" env:"OFELIA_LOG_LEVEL" description:"Set log level"`
	JSON       bool   `long:"json" description:"Output results as JSON"`
	Logger     core.Logger
	// contains filtered or unexported fields
}

type DoctorReport struct {
	Healthy bool          `json:"healthy"`
	Checks  []CheckResult `json:"checks"`
}

type ExecJobConfig struct {
	core.ExecJob              `mapstructure:",squash"`
	middlewares.OverlapConfig `mapstructure:",squash"`
	middlewares.SlackConfig   `mapstructure:",squash"`
	middlewares.SaveConfig    `mapstructure:",squash"`
	middlewares.MailConfig    `mapstructure:",squash"`
	JobWebhookConfig          `mapstructure:",squash"`
	JobSource                 JobSource `json:"-" mapstructure:"-"`
}

type HashPasswordCommand struct {
	Cost     int    `long:"cost" default:"12" description:"bcrypt cost factor (10-14 recommended)"`
	LogLevel string `long:"log-level" env:"OFELIA_LOG_LEVEL" description:"Set log level"`
	Logger   core.Logger
}

type InitCommand struct {
	Output   string `long:"output" short:"o" description:"Output file path" default:"./ofelia.ini"`
	LogLevel string `long:"log-level" env:"OFELIA_LOG_LEVEL" description:"Set log level"`
	Logger   core.Logger
}

type JobSource string

type JobWebhookConfig struct {
	// Webhooks is a comma-separated list of webhook names for this job
	Webhooks string `gcfg:"webhooks" mapstructure:"webhooks"`
}

type LocalJobConfig struct {
	core.LocalJob             `mapstructure:",squash"`
	middlewares.OverlapConfig `mapstructure:",squash"`
	middlewares.SlackConfig   `mapstructure:",squash"`
	middlewares.SaveConfig    `mapstructure:",squash"`
	middlewares.MailConfig    `mapstructure:",squash"`
	JobWebhookConfig          `mapstructure:",squash"`
	JobSource                 JobSource `json:"-" mapstructure:"-"`
}

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

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

type RunJobConfig struct {
	core.RunJob               `mapstructure:",squash"`
	middlewares.OverlapConfig `mapstructure:",squash"`
	middlewares.SlackConfig   `mapstructure:",squash"`
	middlewares.SaveConfig    `mapstructure:",squash"`
	middlewares.MailConfig    `mapstructure:",squash"`
	JobWebhookConfig          `mapstructure:",squash"`
	JobSource                 JobSource `json:"-" mapstructure:"-"`
}

type RunServiceConfig struct {
	core.RunServiceJob        `mapstructure:",squash"`
	middlewares.OverlapConfig `mapstructure:",squash"`
	middlewares.SlackConfig   `mapstructure:",squash"`
	middlewares.SaveConfig    `mapstructure:",squash"`
	middlewares.MailConfig    `mapstructure:",squash"`
	JobWebhookConfig          `mapstructure:",squash"`
	JobSource                 JobSource `json:"-" mapstructure:"-"`
}

type UnknownKeyWarning struct {
	Section    string
	Key        string
	Suggestion string // "did you mean?" suggestion, if available
}

type ValidateCommand struct {
	ConfigFile string `long:"config" env:"OFELIA_CONFIG" description:"configuration file" default:"/etc/ofelia/config.ini"`
	LogLevel   string `long:"log-level" env:"OFELIA_LOG_LEVEL" description:"Set log level (overrides config)"`
	Logger     core.Logger
}

type WebhookConfigs struct {
	Global   *middlewares.WebhookGlobalConfig
	Webhooks map[string]*middlewares.WebhookConfig
	Manager  *middlewares.WebhookManager
}