v1

type ClusterGPUInventory struct {
	// LastUpdated is when this cluster's inventory was last refreshed. A stale
	// timestamp means the cluster was unreachable on recent polls.
	// +optional
	LastUpdated metav1.Time `json:"lastUpdated,omitempty"`
	// Offerings are the distinct GPU kinds available on the cluster.
	// +optional
	Offerings []GPUOffering `json:"offerings,omitempty"`
}

type Colony struct {
	metav1.TypeMeta   `json:",inline"`
	metav1.ObjectMeta `json:"metadata,omitempty"`

	Spec   ColonySpec   `json:"spec,omitempty"`
	Status ColonyStatus `json:"status,omitempty"`
}

type ColonyCluster struct {
	// Name is the name of the cluster.
	ClusterName string `json:"clusterName"`
	// ClusterDeployment is the specification for the cluster deployment.
	// This is stored as RawExtension to avoid CRD validation issues with k0rdent types
	ClusterDeploymentSpec *runtime.RawExtension `json:"clusterDeploymentSpec,omitempty"`
	// ClusterLabels are the labels to be applied to the ClusterDeployment resource
	ClusterLabels map[string]string `json:"clusterLabels,omitempty"`
	// ClusterAnnotations are the annotations to be applied to the ClusterDeployment resource
	ClusterAnnotations map[string]string `json:"clusterAnnotations,omitempty"`
}

type ColonyList struct {
	metav1.TypeMeta `json:",inline"`
	metav1.ListMeta `json:"metadata,omitempty"`
	Items           []Colony `json:"items"`
}

type ColonySpec struct {
	// ColonyClusters is the list of clusters to create.
	ColonyClusters []ColonyCluster `json:"colonyClusters,omitempty"`
}

type ColonyStatus struct {
	Phase                 string                    `json:"phase,omitempty"`
	Conditions            []metav1.Condition        `json:"conditions,omitempty"`
	ClusterDeploymentRefs []*corev1.ObjectReference `json:"clusterDeploymentRefs,omitempty"`
	TotalClusters         int32                     `json:"totalClusters,omitempty"`
	ReadyClusters         int32                     `json:"readyClusters,omitempty"`

	// GPUInventory maps each child cluster (keyed by ClusterDeployment name) to
	// the GPU Offerings discovered on it (ADR-0002). Populated best-effort on a
	// periodic poll for API discovery ("what GPUs can I pick on this cluster?").
	// It records totals only — never live free capacity, which the workspace
	// gate computes live against the cluster at deploy time.
	// +optional
	GPUInventory map[string]ClusterGPUInventory `json:"gpuInventory,omitempty"`
}

type GPUOffering struct {
	// Model is the canonical short model name (e.g. "H100", "A100-80GB"), taken
	// from the provisioning-set GPU model node label.
	Model string `json:"model"`
	// Vendor is the GPU vendor (e.g. NVIDIA, AMD).
	// +optional
	Vendor string `json:"vendor,omitempty"`
	// ResourceName is the extended resource a pod requests for this offering
	// (e.g. nvidia.com/gpu, amd.com/gpu).
	// +optional
	ResourceName string `json:"resourceName,omitempty"`
	// Total is the total number of GPUs of this offering across the cluster.
	// +optional
	Total int64 `json:"total,omitempty"`
	// Nodes is the number of nodes carrying this offering.
	// +optional
	Nodes int32 `json:"nodes,omitempty"`
	// Labels are the raw GFD/AMD/vendor node labels defining this offering,
	// retained for display and advanced selection (data retention, not identity).
	// +optional
	Labels map[string]string `json:"labels,omitempty"`
}