infra

type Cluster struct {
	ID           string      `json:"id"`
	Name         string      `json:"name"`
	Region       string      `json:"region"`
	Version      string      `json:"version"`
	Status       string      `json:"status"`
	NodePools    int         `json:"nodePools"`
	Pools        []NodePool  `json:"pools"`
	Nodes        int         `json:"nodes"`
	Pods         int         `json:"pods"`
	PVs          int         `json:"pvs"`
	PVCs         int         `json:"pvcs"`
	IdlePVCs     int         `json:"idlePVCs"`
	Scanned      bool        `json:"scanned"`
	ScanError    string      `json:"scanError"`
	MonthlyCents money.Cents `json:"monthlyCents"`
}

type ClusterScan struct {
	ClusterID string
	Err       error
	Nodes     []NodeState
	PVs       []PVRef
	PVCs      []PVCRef
	Pods      []PodRef
	Services  []ServiceRef
	// Usage is fill, per claim. PARTIAL BY NATURE and never an error: a claim absent here
	// was not measured, which this analysis reports as unknown rather than as zero.
	Usage []VolumeUsage
}

type CordonIn struct {
	// ID is the node's droplet id, from the path.
	ID string `json:"id"`
	// Cordon true marks the node unschedulable; false restores it.
	Cordon bool `json:"cordon"`
	// Drain additionally evicts the pods already running there.
	Drain bool `json:"drain"`
}

type Cost struct {
	DropletsMonthly      money.Cents `json:"dropletsMonthly"`
	VolumesMonthly       money.Cents `json:"volumesMonthly"`
	LoadBalancersMonthly money.Cents `json:"loadBalancersMonthly"`
	TotalMonthly         money.Cents `json:"totalMonthly"`
	ReclaimableMonthly   money.Cents `json:"reclaimableMonthly"`
	// WastedMonthly is what the fleet pays every month for provisioned-but-empty space on
	// the volumes a kubelet actually measured.
	//
	// It is NOT ReclaimableMonthly and must never be added to it. Reclaimable is money a
	// button on this board collects, by deleting volumes proven to belong to no one.
	// Wasted is money locked inside volumes that are IN USE and holding live data:
	// DigitalOcean can only ever grow a volume, so collecting it means copying a database
	// onto a smaller one. See shrinkRecipe.
	//
	// It is also a LOWER BOUND — unmeasured volumes contribute nothing.
	WastedMonthly money.Cents `json:"wastedMonthly"`
}

type DropletIn struct {
	// ID is the DO droplet id, from the path. Numeric.
	ID string `json:"id"`
	// Size is the target DigitalOcean size slug on resize, e.g. "s-4vcpu-8gb".
	Size string `json:"size"`
	// Disk requests a PERMANENT resize that grows the disk. DO can never resize such a
	// droplet down again, so it defaults false — a CPU/RAM-only change, reversible.
	Disk bool `json:"disk"`
}

type Finding struct {
	ID           string      `json:"id"`
	Severity     string      `json:"severity"`
	Kind         string      `json:"kind"`
	Title        string      `json:"title"`
	Detail       string      `json:"detail"`
	Resource     string      `json:"resource"`
	Cluster      string      `json:"cluster"`
	MonthlyCents money.Cents `json:"monthlyCents"`
}

type Inventory struct {
	Clusters      []digitalocean.Cluster
	Droplets      []digitalocean.Droplet
	Volumes       []digitalocean.Volume
	LoadBalancers []digitalocean.LoadBalancer
}

type LoadBalancer struct {
	ID           string      `json:"id"`
	Name         string      `json:"name"`
	Region       string      `json:"region"`
	Status       string      `json:"status"`
	IP           string      `json:"ip"`
	SizeUnit     int         `json:"sizeUnit"`
	MonthlyCents money.Cents `json:"monthlyCents"`
	Droplets     int         `json:"droplets"`
	Cluster      string      `json:"cluster"`
	// Service is the `namespace/name` of the live type=LoadBalancer Service that claims
	// this load balancer, proven from the cluster scan. Non-empty means IN USE.
	Service       string `json:"service"`
	Deletable     bool   `json:"deletable"`
	BlockedReason string `json:"blockedReason"`
}

type LoadBalancerIn struct {
	// ID is the DO load balancer id, from the path.
	ID string `json:"id"`
}

type MutationOut struct {
	Status string `json:"status"`
	Msg    string `json:"msg"`
	Data   any    `json:"data"`
}

type Node struct {
	ID           int         `json:"id"`
	Name         string      `json:"name"`
	Cluster      string      `json:"cluster"`
	ClusterID    string      `json:"clusterId"`
	Region       string      `json:"region"`
	Status       string      `json:"status"`
	SizeSlug     string      `json:"sizeSlug"`
	VCPUs        int         `json:"vcpus"`
	MemoryMiB    int         `json:"memoryMiB"`
	LocalDiskGiB int         `json:"localDiskGiB"`
	MonthlyCents money.Cents `json:"monthlyCents"`
	CreatedAt    string      `json:"createdAt"`
	PrivateIP    string      `json:"privateIp"`
	PublicIP     string      `json:"publicIp"`
	Tags         []string    `json:"tags"`
	Ready        bool        `json:"ready"`
	Schedulable  bool        `json:"schedulable"`
	Pods         int         `json:"pods"`
	Volumes      int         `json:"volumes"`
	// Mutable reports whether this droplet may be changed DIRECTLY — deleted or resized.
	// One predicate covers both because one fact decides both: a DOKS node belongs to a
	// node pool, and the pool is the only thing allowed to change it.
	Mutable       bool   `json:"mutable"`
	BlockedReason string `json:"blockedReason"`
}

type NodePool struct {
	ID                 string `json:"id"`
	Name               string `json:"name"`
	Size               string `json:"size"`
	Count              int    `json:"count"`
	ClusterID          string `json:"clusterId"`
	Cluster            string `json:"cluster"`
	ClusterSchedulable int    `json:"clusterSchedulable"`
	Scalable           bool   `json:"scalable"`
	BlockedReason      string `json:"blockedReason"`
}

type NodeState struct {
	Name        string
	Ready       bool
	Schedulable bool
}

type PVCRef struct {
	Namespace string
	Name      string
	Phase     string
	Volume    string
}

type PVRef struct {
	Name         string
	Phase        string
	VolumeHandle string
	ClaimNS      string
	ClaimName    string
}

type PodRef struct {
	Namespace string
	Name      string
	Phase     string
	Reason    string
	Node      string
	Claims    []string
	Images    []string
	// Controller is the controlling owner as `Kind/Name` ("StatefulSet/luxd"), or "" for
	// a bare pod. Its kind decides how this pod's volumes can be right-sized.
	Controller string
}

type ReadIn struct {
	// Refresh, when present, forces a full re-scan instead of serving the cached
	// snapshot. Every MUTATION re-scans regardless — this is only for the reader.
	Refresh string `json:"refresh"`
}

type ReadOut struct {
	Status string    `json:"status"`
	Msg    string    `json:"msg"`
	Data   *Snapshot `json:"data"`
}

type ScaleIn struct {
	// ID is the DOKS cluster id, from the path.
	ID string `json:"id"`
	// Pool is the node pool, from the path. Its DO id or its name — both are unique
	// within a cluster, and an operator reads the name off the board.
	Pool string `json:"pool"`
	// Count is the node count to set.
	Count int `json:"count"`
}

type ServiceRef struct {
	Namespace string
	Name      string
	LBID      string
	IPs       []string
}

type Snapshot struct {
	At               string              `json:"at"`
	Complete         bool                `json:"complete"`
	IncompleteReason string              `json:"incompleteReason"`
	Sources          []core.SourceStatus `json:"sources"`
	Totals           Totals              `json:"totals"`
	Cost             Cost                `json:"cost"`
	Clusters         []Cluster           `json:"clusters"`
	Nodes            []Node              `json:"nodes"`
	Volumes          []Volume            `json:"volumes"`
	LoadBalancers    []LoadBalancer      `json:"loadBalancers"`
	Findings         []Finding           `json:"findings"`
}

type Totals struct {
	Clusters            int `json:"clusters"`
	Nodes               int `json:"nodes"`
	Volumes             int `json:"volumes"`
	LoadBalancers       int `json:"loadBalancers"`
	VolumeGiB           int `json:"volumeGiB"`
	AttachedVolumes     int `json:"attachedVolumes"`
	AttachedGiB         int `json:"attachedGiB"`
	DetachedVolumes     int `json:"detachedVolumes"`
	DetachedGiB         int `json:"detachedGiB"`
	UnreferencedVolumes int `json:"unreferencedVolumes"`
	UnreferencedGiB     int `json:"unreferencedGiB"`
	IdlePVCs            int `json:"idlePVCs"`
	LocalDiskGiB        int `json:"localDiskGiB"`

	// Fill. MeasuredVolumes/UnmeasuredVolumes are the honesty denominator: UsedGiB and
	// WastedGiB describe the measured set ONLY, so a board showing waste must show how
	// much of the fleet the figure was computed from. Unmeasured capacity contributes
	// nothing to either — it is not assumed empty, and it is not assumed full.
	MeasuredVolumes   int `json:"measuredVolumes"`
	MeasuredGiB       int `json:"measuredGiB"`
	UnmeasuredVolumes int `json:"unmeasuredVolumes"`
	UnmeasuredGiB     int `json:"unmeasuredGiB"`
	UsedGiB           int `json:"usedGiB"`
	WastedGiB         int `json:"wastedGiB"`
}

type Volume struct {
	ID           string      `json:"id"`
	Name         string      `json:"name"`
	Region       string      `json:"region"`
	SizeGiB      int         `json:"sizeGiB"`
	MonthlyCents money.Cents `json:"monthlyCents"`
	State        string      `json:"state"`
	DropletIDs   []int       `json:"dropletIds"`
	NodeName     string      `json:"nodeName"`
	// Cluster/ClusterID are the PROVEN owner — resolved through a PV that names this
	// volume, never through the tag.
	Cluster   string `json:"cluster"`
	ClusterID string `json:"clusterId"`
	// TagCluster is the `k8s:<uuid>` tag. ADVISORY ONLY: it outlives the cluster that
	// set it. Shown so the operator can see tag-vs-truth disagree, never acted on.
	TagCluster   string   `json:"tagCluster"`
	PV           string   `json:"pv"`
	PVPhase      string   `json:"pvPhase"`
	PVCNamespace string   `json:"pvcNamespace"`
	PVCName      string   `json:"pvcName"`
	MountedBy    []string `json:"mountedBy"`
	Idle         bool     `json:"idle"`
	CreatedAt    string   `json:"createdAt"`
	// Controller is the workload owning the pod that mounts this volume
	// ("StatefulSet/luxd"), or "" when nothing mounts it. It names who has to act.
	Controller string `json:"controller"`

	// HasUsage reports whether a kubelet actually MEASURED this volume's filesystem.
	//
	// False means NOT MEASURED. It does NOT mean empty, and the three fields below are
	// meaningless — not zero — when it is false. A reading exists only while a running pod
	// has the volume mounted on a node that answered; a detached, idle or unreferenced
	// volume has none. Rendering an unmeasured volume as "0 used / 100% wasted" would
	// invent the single most expensive lie this board could tell, so every consumer must
	// branch on this flag and show unknown.
	HasUsage bool `json:"hasUsage"`
	// UsedBytes is the measured filesystem usage. BYTES, not GiB: the volumes this exists
	// to catch hold a fraction of a GiB in 200, and rounding that to an integer GiB would
	// print the very 0 the flag above exists to prevent.
	UsedBytes int64 `json:"usedBytes"`
	// WastedGiB is provisioned minus measured, in the unit DigitalOcean BILLS: whole GiB
	// of the volume's own size, never the filesystem's capacity — a 200 GiB volume carries
	// a 196 GiB filesystem after format overhead, and the invoice says 200.
	WastedGiB          int         `json:"wastedGiB"`
	WastedMonthlyCents money.Cents `json:"wastedMonthlyCents"`

	Deletable     bool   `json:"deletable"`
	BlockedReason string `json:"blockedReason"`
	// Expandable/ExpandBlockedReason are the GROW verdict, kept separate from Deletable
	// because the two ask opposite questions: a volume is deletable when nothing uses it,
	// and expandable when something uses it in a way this board can grow completely.
	Expandable          bool   `json:"expandable"`
	ExpandBlockedReason string `json:"expandBlockedReason"`
}

type VolumeIn struct {
	// ID is the DO volume id, from the path.
	ID string `json:"id"`
	// Snapshot is the snapshot-first switch on DELETE. Anything other than the literal
	// "false" snapshots before destroying — the snapshot IS the undo, so waiving it is
	// deliberate and explicit.
	Snapshot string `json:"snapshot"`
	// Name is the snapshot name on the snapshot action. Blank gets a deterministic
	// "<volume>-predelete-<unix>" so the undo is findable in the DO console.
	Name string `json:"name"`
	// SizeGiB is the target size on the resize action. A volume only ever grows —
	// ExpandTo is the verdict that refuses a shrink, so this is not validated here.
	SizeGiB int `json:"sizeGiB"`
}

type VolumeSnapshotOut struct {
	Status string                 `json:"status"`
	Msg    string                 `json:"msg"`
	Data   *digitalocean.Snapshot `json:"data"`
}

type VolumeUsage struct {
	Namespace string
	Name      string
	UsedBytes int64
}