supervisor

type ExitStatus int

type FatalErr struct {
	Err    error
	Status ExitStatus
}

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

type Metric struct {
	Name             string        `json:"name"`               // 服务名称
	Status           ServiceStatus `json:"status"`             // 当前状态
	StartCount       uint32        `json:"start_count"`        // 启动次数
	ErrorCount       uint32        `json:"error_count"`        // 错误次数
	SuccessCount     uint32        `json:"success_count"`      // 成功退出次数
	ConsecFailures   uint32        `json:"consec_failures"`    // 连续失败次数
	LastError        string        `json:"last_error"`         // 最后一次错误信息
	LastErrorTime    time.Time     `json:"last_error_time"`    // 最后一次错误时间
	LastStartTime    time.Time     `json:"last_start_time"`    // 最后一次启动时间
	LastStopTime     time.Time     `json:"last_stop_time"`     // 最后一次停止时间
	CurrentUptime    time.Duration `json:"current_uptime"`     // 当前运行时长
	TotalUptime      time.Duration `json:"total_uptime"`       // 总运行时长
	AverageUptime    time.Duration `json:"average_uptime"`     // 平均运行时长
	CreatedAt        time.Time     `json:"created_at"`         // 服务创建时间
	CurrentDelay     time.Duration `json:"current_delay"`      // 当前重启延迟
	RestartsInWindow uint32        `json:"restarts_in_window"` // 窗口期内重启次数
}

type Option func(*ServiceConfig)

type RestartPolicy int

type Service interface {
	Name() string
	Error() error
	String() string
	Serve(ctx context.Context) error
	Metric() *Metric
}

type ServiceConfig struct {
	// RestartPolicy 重启策略
	RestartPolicy RestartPolicy
	// MaxRestarts 最大重启次数，0 表示无限制
	MaxRestarts int
	// RestartDelay 初始重启延迟
	RestartDelay time.Duration
	// MaxRestartDelay 最大重启延迟（用于指数退避）
	MaxRestartDelay time.Duration
	// RestartWindow 重启计数窗口期，在此期间内的重启会被计数
	// 如果服务运行超过此时间后崩溃，重启计数会重置
	RestartWindow time.Duration
	// MaxRestartsInWindow 窗口期内最大重启次数，超过则标记为 failed
	MaxRestartsInWindow int
	// BackoffMultiplier 退避乘数，默认 2.0
	BackoffMultiplier float64
	// AutoStart 是否自动启动，默认 true
	AutoStart bool
}

type ServiceInfo struct {
	*Metric
	Stopped          bool          `json:"stopped"`
	Failed           bool          `json:"failed"`
	RestartCount     int           `json:"restart_count"`
	ConsecFailures   int           `json:"consec_failures"`
	WindowRestarts   int           `json:"window_restarts"`
	CurrentDelay     time.Duration `json:"current_delay_ns"`
	CurrentDelayStr  string        `json:"current_delay"`
	WindowStart      time.Time     `json:"window_start"`
	LastServiceStart time.Time     `json:"last_service_start"`
}

type ServiceStatus string