gpu

type Offering struct {
	// --- identity ---
	Vendor       workspacesv1.GPUVendor
	Model        string // best-effort short name: canonical model label, else a vendor product label, else empty
	Profile      string // partition/MIG profile; empty for whole GPUs (reserved for later phases)
	ResourceName string // extended resource a pod must request (e.g. nvidia.com/gpu)

	// --- attributes ---
	Total int64 // total GPUs of this offering across the cluster
	Nodes int32 // number of nodes carrying it
	// Selector is the exact node-label requirement that reproduces this
	// offering — the GPU Selector a workspace uses to pick it, and the one the
	// gate validates (ADR-0002: "passing the gate implies placeable"). It is
	// {canonical-label: model} when provisioning labelled the node, else
	// {product-label: value} when derived from a vendor label, else nil when the
	// node carried no usable GPU label (callers then compose one from Labels).
	Selector map[string]string
	Labels   map[string]string // representative raw vendor labels (data retention)
}

type Options struct {
	ModelLabel  string
	VendorLabel string
	// ProductLabels overrides the per-vendor fallback model labels. Zero value
	// uses defaultProductLabels.
	ProductLabels map[workspacesv1.GPUVendor][]string
}

type SelectorAvailability struct {
	// Found is true when at least one schedulable node matches the selector and
	// advertises a GPU resource.
	Found bool
	// Free is the number of GPUs free to schedule across matching nodes
	// (allocatable minus pod requests).
	Free int64
	// ResourceName is the GPU extended resource on the matching nodes.
	ResourceName string
	// Vendor is the GPU vendor of the matching nodes.
	Vendor workspacesv1.GPUVendor
}