daemon

type Channel uint16

type ExitEvent struct {
	// Event 事件类型，恒为 EventJavaExit。
	Event string `json:"event"`
	// ExitCode 进程退出码；无法获知时为 -1。
	ExitCode int `json:"exit_code"`
	// Signal 终止信号名（Unix，如 killed/terminated）；Windows / 非信号退出为空。
	Signal string `json:"signal,omitempty"`
	// DurationMs 本次运行时长（毫秒）。
	DurationMs int64 `json:"duration_ms"`
}

type Flags uint8

type Frame struct {
	Header
	Payload []byte
}

type Header struct {
	Channel Channel // 2 bytes
	Type    Type    // 1 byte
	Flags   Flags   // 1 byte
	Length  uint32  // 4 bytes
}

type InstanceState string

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

type PIDRecord struct {
	WrapperPID   int    `json:"wrapper_pid"`
	JavaPID      int    `json:"java_pid"`
	SocketAddr   string `json:"socket_addr"` // Unix Socket 路径或 Named Pipe 名称
	InstanceUUID string `json:"instance_uuid"`
	WorkDir      string `json:"work_dir"`             // 实例工作目录，供 Worker 重启恢复后做文件/配置操作
	ProbePort    int    `json:"probe_port,omitempty"` // ServerProbe /metrics 端口，供 Worker 重启恢复后心跳继续自采（FR-060）
}

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

type Type uint8

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

type WrapperConfig struct {
	InstanceUUID string `json:"instance_uuid"`
	StartCommand string `json:"start_command"`
	// StopCommand 优雅停止时写入进程 stdin 的命令（不含换行）。
	// 由 Control Plane 按实例角色派生（MC 后端用 stop，代理用 end）。
	// 为空时 wrapper 回退到 MC 的 "stop"，保证旧实例/恢复路径行为不变。
	StopCommand  string            `json:"stop_command,omitempty"`
	WorkDir      string            `json:"work_dir"`
	EnvVars      map[string]string `json:"env_vars"`
	JavaHome     string            `json:"java_home,omitempty"`
	JDKBinPath   string            `json:"jdk_bin_path,omitempty"`
	AutoRestart  bool              `json:"auto_restart"`
	PIDDir       string            `json:"pid_dir"`
	StartTimeout time.Duration     `json:"start_timeout"` // Java 启动到首字节输出的等待（0=不限）
	// ProbePort 透传到 PID 记录，使 Worker 重启恢复后心跳继续自采该实例 ServerProbe 指标（FR-060）。
	ProbePort int `json:"probe_port,omitempty"`
	// GracefulStopTimeoutSeconds 优雅停止后等待进程自行退出的上限（秒，CP 从平台设置
	// graceful_stop.timeout 取生效值后于启动时下发，FR-063）。>0 时 wrapper 用它做超时强杀兜底；
	// 0=未指定，回退环境变量/默认。值在启动时定型，故对设置变更后「新启动」的实例生效。
	GracefulStopTimeoutSeconds int `json:"graceful_stop_timeout_seconds,omitempty"`
}