fingerprint

type Dimension struct {
	// Value is the resolved dimension value, normalized to the
	// matching recipe.Criteria enum where applicable (e.g. "eks",
	// "h100", "ubuntu"). Empty string means the dimension was not
	// captured.
	Value string `json:"value" yaml:"value"`

	// Source names the collector signal that produced Value, for
	// audit and debugging (e.g. "k8s.node.provider"). Empty when the
	// dimension was not captured.
	Source string `json:"source,omitempty" yaml:"source,omitempty"`

	// Note carries a short audit hint when Value is empty for a
	// reason other than missing data — e.g. "multi-region" for a
	// region dimension that detected disagreeing labels across
	// nodes. The verifier surfaces this in its Markdown rendering so
	// "value not captured" and "value deliberately not collapsed"
	// stay distinguishable.
	Note string `json:"note,omitempty" yaml:"note,omitempty"`
}

type DimensionDiff struct {
	// Dimension is the typed dimension name (service, accelerator,
	// etc.). Lets consumers filter or look up by name without magic
	// strings.
	Dimension DimensionName `json:"dimension" yaml:"dimension"`

	// RecipeRequires is the criteria value the recipe declares, or
	// empty / "any" when the recipe is generic in this dimension.
	RecipeRequires string `json:"recipeRequires,omitempty" yaml:"recipeRequires,omitempty"`

	// FingerprintProvides is the value the fingerprint resolved for
	// this dimension. Empty when the dimension was not captured.
	FingerprintProvides string `json:"fingerprintProvides,omitempty" yaml:"fingerprintProvides,omitempty"`

	// Match is the three-way outcome.
	Match DimensionMatch `json:"match" yaml:"match"`
}

type DimensionMatch string

type DimensionName string

type Fingerprint struct {
	// Service is the Kubernetes service / cloud platform
	// (eks, gke, aks, oke, kind, lke). Sourced from
	// k8s.node.provider (parsed from spec.providerID).
	Service Dimension `json:"service" yaml:"service"`

	// Accelerator is the GPU SKU (h100, gb200, b200, a100, l40,
	// rtx-pro-6000). Parsed from gpu.smi.gpu.model.
	Accelerator Dimension `json:"accelerator" yaml:"accelerator"`

	// OS is the worker node operating system, with the raw
	// VERSION_ID retained for audit. Sourced from
	// os.release.{ID,VERSION_ID}.
	OS OSDimension `json:"os" yaml:"os"`

	// K8sVersion is the Kubernetes server version with the leading
	// "v" stripped (e.g., "1.33.4"). Sourced from k8s.server.version.
	K8sVersion Dimension `json:"k8sVersion" yaml:"k8sVersion"`

	// Region is the cluster region (e.g., "us-west-2"). Sourced from
	// the topology.kubernetes.io/region node label aggregated by the
	// topology collector. Omitted when the cluster has no consistent
	// region label or spans multiple regions.
	Region Dimension `json:"region,omitempty" yaml:"region,omitempty"`

	// NodeCount is the total number of cluster nodes including
	// control-plane and worker nodes. Sourced from
	// nodeTopology.summary.node-count. For "how many GPU workers"
	// see GPUNodeCount.
	NodeCount IntDimension `json:"nodeCount" yaml:"nodeCount"`

	// GPUNodeCount is the number of nodes carrying the GPU operator's
	// nvidia.com/gpu.product label (the canonical "this node has a
	// GPU" signal). Zero on clusters without the GPU operator
	// installed. Sourced from the topology label subtype.
	GPUNodeCount IntDimension `json:"gpuNodeCount" yaml:"gpuNodeCount"`
}

type IntDimension struct {
	// Value is the resolved integer value. Zero indicates the
	// dimension was not captured.
	Value int `json:"value" yaml:"value"`

	// Source names the collector signal that produced Value.
	Source string `json:"source,omitempty" yaml:"source,omitempty"`
}

type MatchResult struct {
	Matched      bool            `json:"matched" yaml:"matched"`
	PerDimension []DimensionDiff `json:"perDimension" yaml:"perDimension"`
}

type OSDimension struct {
	Value   string `json:"value" yaml:"value"`
	Version string `json:"version,omitempty" yaml:"version,omitempty"`
	Source  string `json:"source,omitempty" yaml:"source,omitempty"`
}