find

type FindResult struct {
	aws.InstanceTypeResult          // Embedded full result from the AWS query
	MatchReasons           []string // Human-readable explanations of why this instance matched the query
	MatchScore             int      // Relevance score for sorting; higher means more specific match
}

type ParsedQuery struct {
	Vendors        []string // Hardware vendor filters, e.g. ["amd"], ["nvidia"]
	Processors     []string // Processor code names, e.g. ["genoa", "sapphire rapids"]
	GPUs           []string // GPU model names, e.g. ["h100", "a100"]
	Sizes          []string // Size-category filters, e.g. ["large", "xlarge"]
	MinVCPU        int      // Minimum vCPU count; 0 means unconstrained
	MinPhysCores   int      // Minimum physical core count; 0 means unconstrained
	MinMemory      float64  // Minimum memory in GiB; 0 means unconstrained
	GPUCount       int      // Minimum number of GPUs; 0 means unconstrained
	Architecture   string   // "x86_64" or "arm64"; empty means both
	MinNetworkGbps int      // Minimum network bandwidth in Gbps; 0 means unconstrained
	RequireEFA     bool     // If true, only match instance families with EFA support
	RequireNestedV bool     // If true, only match instance types supporting nested virtualization
	ExactMatch     bool     // If true, match exact vCPU and memory values instead of minimum
	RawTokens      []Token  // Parsed tokens in input order, useful for diagnostics
	Apps           []string // Application names from catalog (e.g. ["paraview"]); resolved to hardware in BuildCriteria
}

type SearchCriteria struct {
	InstanceTypePattern *regexp.Regexp    // Compiled regexp matching eligible EC2 instance type strings
	FilterOptions       aws.FilterOptions // Numeric and categorical filters passed to SearchInstanceTypes
}

type SortPreference int

type Token struct {
	Type  TokenType // Semantic classification of this token
	Value string    // Normalized canonical value, e.g. "nvidia", "128gb"
	Raw   string    // Original input text before normalization
}

type TokenType int