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, bcm). Sourced from
	// k8s.node.provider (parsed from spec.providerID).
	Service Dimension `json:"service" yaml:"service"`

	// Accelerator is the recipe-supported GPU SKU used for criteria
	// matching (h100, h200, gb200, b200, a100, l40, rtx-pro-6000). It is
	// intentionally limited to the pkg/recipe accelerator enum: a GPU that
	// AICR does not have recipe coverage for is left empty here (see
	// GPUModel for the descriptive identity). Sourced from the GFD
	// nvidia.com/gpu.product label or the PCI device ID.
	Accelerator Dimension `json:"accelerator" yaml:"accelerator"`

	// GPUModel is the descriptive accelerator SKU detected on the node
	// (e.g. "l40s", "t4", "a800"), independent of whether AICR supports it
	// for recipe matching. It is informational only — Match and ToCriteria
	// never read it — and exists so the snapshot records the real hardware
	// even for SKUs outside the Accelerator enum. Sourced from the PCI
	// device ID via the GPU "hardware" subtype.
	GPUModel Dimension `json:"gpuModel,omitempty" yaml:"gpuModel,omitempty"`

	// 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"`
}