advisor

type CacheTelemetry struct {
	Hits   uint64 `json:"hits"`
	Misses uint64 `json:"misses"`
	// Evictions counts entries removed before their TTL expired
	// (capacity pressure), e.g. memcached evictions / redis evicted_keys.
	Evictions uint64 `json:"evictions"`
}

type Check struct {
	ID             string `json:"id"`
	Title          string `json:"title"`
	Status         Status `json:"status"`
	Detail         string `json:"detail,omitempty"`
	Recommendation string `json:"recommendation,omitempty"`
}

type Evidence string

type Options struct {
	DriverName string
	DSN        string
	// DB is an open raw (unproxied) connection for MySQL variable checks.
	// The caller owns closing it.
	DB *sql.DB
	// NginxConf is the concatenated nginx configuration content.
	NginxConf []byte
	// FS is the root filesystem ("/" in production, a fixture in tests).
	FS fs.FS
	// GOMAXPROCS is runtime.GOMAXPROCS(0); 0 skips the check.
	GOMAXPROCS int
	// Protocol supplies HTTP/3/QUIC readiness evidence. Configuration content
	// is inspected locally; off-host network and edge facts must be explicit.
	Protocol ProtocolOptions
	// Cache supplies application-side cache telemetry (memcached/redis
	// stats); nil skips the check. CacheError records why it could not be
	// read.
	Cache      *CacheTelemetry
	CacheError string
}

type ProtocolOptions struct {
	ProxyKind       string
	ProxyConfig     []byte
	UDP443Reachable Evidence
	EdgeName        string
	EdgeHTTP3       Evidence
	QUIC            *QUICTelemetry
	QUICError       string
}

type ProtocolSample struct {
	Protocol string
	Count    int64
	Errors   int64
	P95      time.Duration
}

type QUICTelemetry struct {
	PacketsSent          uint64 `json:"packets_sent"`
	PacketsRetransmitted uint64 `json:"packets_retransmitted"`
	UDPDatagramsDropped  uint64 `json:"udp_datagrams_dropped"`
}

type Status string