compose

type Build struct {
	Context    string `json:"context"`
	Dockerfile string `json:"dockerfile,omitempty"`
}

type Deploy struct {
	Mode          string         `json:"mode,omitempty"`
	Replicas      int64          `json:"replicas,omitempty"`
	UpdateConfig  *UpdateConfig  `json:"update_config,omitempty"`
	RestartPolicy *RestartPolicy `json:"restart_policy,omitempty"`
	Resources     *Resources     `json:"resources,omitempty"`
	Placement     *Placement     `json:"placement,omitempty"`
}

type EnvVar struct {
	Key    string `json:"key"`
	Hash   string `json:"hash"`
	Source string `json:"source"`
}

type FieldChange struct {
	Path string `json:"path"`
	From any    `json:"from,omitempty"`
	To   any    `json:"to,omitempty"`
}

type Healthcheck struct {
	Test        []string `json:"test,omitempty"`
	Interval    string   `json:"interval,omitempty"`
	Timeout     string   `json:"timeout,omitempty"`
	Retries     uint64   `json:"retries,omitempty"`
	StartPeriod string   `json:"start_period,omitempty"`
}

type Mount struct {
	Volume   string `json:"volume"`
	Target   string `json:"target"`
	ReadOnly bool   `json:"read_only,omitempty"`
}

type Placement struct {
	Constraints []string `json:"constraints,omitempty"`
}

type Plan struct {
	// Name 是目标 Spec 的应用名（基线与目标名不一致时取目标侧）。
	Name string `json:"name,omitempty"`
	// SpecHash 是目标归一化形态哈希（= etag）。
	SpecHash string `json:"spec_hash"`
	// BaseSpecHash 是基线归一化形态哈希（空基线为空串）。
	BaseSpecHash string `json:"base_spec_hash,omitempty"`
	HasChanges   bool   `json:"has_changes"`
	// Destructive 表示变更集含破坏性操作（服务删除/卷解绑——省略=删除；
	// 卷数据不随声明删除的例外语义由执行层 T2.10 兑现，本期只解析标记）。
	Destructive bool `json:"destructive"`
	// RequiresConfirmDestructive 是执行侧 --confirm-destructive 的门控位
	// （v0.1 恒等于 Destructive；独立成字段以便引擎层引入非破坏性降级后
	// 二者分叉）。
	RequiresConfirmDestructive bool         `json:"requires_confirm_destructive"`
	Services                   ServicesPlan `json:"services"`
	Volumes                    VolumesPlan  `json:"volumes,omitempty"`
	Warnings                   []Warning    `json:"warnings,omitempty"`
}

type ResourceLimits struct {
	CPUS        float64 `json:"cpus,omitempty"`
	MemoryBytes int64   `json:"memory_bytes,omitempty"`
}

type Resources struct {
	Limits *ResourceLimits `json:"limits,omitempty"`
}

type RestartPolicy struct {
	Condition   string `json:"condition,omitempty"`
	Delay       string `json:"delay,omitempty"`
	MaxAttempts uint64 `json:"max_attempts,omitempty"`
	Window      string `json:"window,omitempty"`
}

type Service struct {
	Name string `json:"name"`
	// Build/Image 互斥或同现均可（compose 允许 image+build；构建模式裁决
	// 随构建票：无 dockerfile → Railpack，有 build.dockerfile → Dockerfile）。
	Build   *Build   `json:"build,omitempty"`
	Image   string   `json:"image,omitempty"`
	Command []string `json:"command,omitempty"`
	// Expose 保持原序（路由目标端口取首个，架构 §2.4）。
	Expose []string `json:"expose,omitempty"`
	// Domains 是 fleetly.domains label 解析后的域名列表（trim/小写/
	// IDN→punycode 归一化后排序）。有该 label 的服务即入口。
	Domains []string `json:"domains,omitempty"`
	// PlacementNode 是 fleetly.placement.node label 的字面值（放置意图；
	// 名或 n_<ULID> 的解析/绑定校验属放置层，语法校验见 validate.go）。
	PlacementNode string `json:"placement_node,omitempty"`

	Healthcheck *Healthcheck `json:"healthcheck,omitempty"`
	// Environment 是 env 合并结果（env_file < environment），按 key 排序；
	// 只含 key+hash+source，值永不进归一化形态（脱敏结构性成立）。
	Environment []EnvVar `json:"environment,omitempty"`
	Secrets     []string `json:"secrets,omitempty"`
	// Volumes 是命名卷挂载（v0.1 受控子集：仅命名卷；bind/tmpfs 拒绝），
	// 保持声明顺序（挂载点集合有语义）。
	Volumes  []Mount  `json:"volumes,omitempty"`
	Networks []string `json:"networks,omitempty"`

	Deploy          *Deploy `json:"deploy,omitempty"`
	StopSignal      string  `json:"stop_signal,omitempty"`
	StopGracePeriod string  `json:"stop_grace_period,omitempty"`
}

type ServiceUpdate struct {
	Name   string        `json:"name"`
	Fields []FieldChange `json:"fields"`
}

type ServicesPlan struct {
	Added   []string        `json:"added,omitempty"`
	Removed []string        `json:"removed,omitempty"`
	Updated []ServiceUpdate `json:"updated,omitempty"`
}

type Spec struct {
	Name     string    `json:"name,omitempty"`
	Services []Service `json:"services"`
	Volumes  []Volume  `json:"volumes,omitempty"`
	Networks []string  `json:"networks,omitempty"`
	Secrets  []string  `json:"secrets,omitempty"`
	// SpecHash 是 CanonicalJSON 的 sha256 hex（载入时填定）。
	SpecHash string `json:"spec_hash"`
}

type UpdateConfig struct {
	Order       string `json:"order,omitempty"`
	Parallelism uint64 `json:"parallelism,omitempty"`
	Delay       string `json:"delay,omitempty"`
}

type Volume struct {
	Key    string `json:"key"`
	Driver string `json:"driver,omitempty"`
}

type VolumesPlan struct {
	Added   []string `json:"added,omitempty"`
	Removed []string `json:"removed,omitempty"`
}

type Warning struct {
	Code    string `json:"code,omitempty"`
	Kind    string `json:"kind,omitempty"`
	Service string `json:"service,omitempty"`
	Message string `json:"message"`
}