status

type Accessor interface {
	// AddCheck appends one or more status checks to the cluster status report.
	// This method enables agent components to contribute health check results to the
	// comprehensive cluster status without requiring full report reconstruction.
	//
	// Common usage patterns:
	//   - Webhook services adding connectivity and certificate validation results
	//   - Metric collectors reporting Prometheus endpoint health status
	//   - Storage services contributing disk space and persistence health checks
	//   - Network services adding CloudZero API connectivity validation
	//
	// The method is thread-safe and triggers registered write callbacks to notify
	// listeners of status updates, enabling real-time monitoring and alerting.
	//
	// Multiple checks can be added atomically in a single call for efficiency.
	AddCheck(...*StatusCheck)

	// WriteToReport provides exclusive write access to the cluster status report.
	// The provided function receives a pointer to the ClusterStatus protobuf and can
	// make arbitrary modifications while holding the write lock.
	//
	// Used for:
	//   - Bulk status updates requiring consistency across multiple fields
	//   - Complex status calculations that need to read and modify multiple values
	//   - Status reset or initialization operations during agent startup
	//   - Atomic updates to prevent partial status states during report generation
	//
	// The write lock ensures no other goroutines can read or write the status
	// during the function execution, maintaining data consistency and preventing races.
	// Write callbacks are triggered after the function completes and the lock is released.
	WriteToReport(func(*ClusterStatus))

	// ReadFromReport provides shared read access to the cluster status report.
	// The provided function receives a read-only pointer to the ClusterStatus protobuf
	// while holding a read lock that allows concurrent readers but blocks writers.
	//
	// Used for:
	//   - Status report generation for HTTP endpoints and diagnostic tools
	//   - Health check aggregation across multiple agent components
	//   - Status monitoring and alerting that needs consistent snapshots
	//   - Diagnostic logging that requires stable status values during output
	//
	// Multiple goroutines can read simultaneously, but write operations are blocked
	// during read access to ensure the function receives a consistent view of the status.
	// The function should not retain references to the ClusterStatus pointer after return.
	ReadFromReport(func(*ClusterStatus))
}

type ClusterStatus struct {
	Account          string         `protobuf:"bytes,1,opt,name=account,proto3" json:"account,omitempty"`
	Region           string         `protobuf:"bytes,2,opt,name=region,proto3" json:"region,omitempty"`
	Name             string         `protobuf:"bytes,3,opt,name=name,proto3" json:"name,omitempty"`
	State            StatusType     `protobuf:"varint,4,opt,name=state,proto3,enum=status.StatusType" json:"state,omitempty"`
	ChartVersion     string         `protobuf:"bytes,5,opt,name=chart_version,json=chartVersion,proto3" json:"chart_version,omitempty"`
	AgentVersion     string         `protobuf:"bytes,6,opt,name=agent_version,json=agentVersion,proto3" json:"agent_version,omitempty"`
	ScrapeConfig     string         `protobuf:"bytes,7,opt,name=scrape_config,json=scrapeConfig,proto3" json:"scrape_config,omitempty"`
	ValidatorVersion string         `protobuf:"bytes,8,opt,name=validator_version,json=validatorVersion,proto3" json:"validator_version,omitempty"`
	K8SVersion       string         `protobuf:"bytes,9,opt,name=k8s_version,json=k8sVersion,proto3" json:"k8s_version,omitempty"`
	Checks           []*StatusCheck `protobuf:"bytes,10,rep,name=checks,proto3" json:"checks,omitempty"`
	// 05/15/25 updates
	ProviderId  string `protobuf:"bytes,11,opt,name=provider_id,json=providerId,proto3" json:"provider_id,omitempty"`
	ReleaseName string `protobuf:"bytes,12,opt,name=release_name,json=releaseName,proto3" json:"release_name,omitempty"`
	Namespace   string `protobuf:"bytes,13,opt,name=namespace,proto3" json:"namespace,omitempty"`
	// contains filtered or unexported fields
}

type StatusCheck struct {
	Name    string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	Passing bool   `protobuf:"varint,2,opt,name=passing,proto3" json:"passing,omitempty"`
	Error   string `protobuf:"bytes,3,opt,name=error,proto3" json:"error,omitempty"`
	// contains filtered or unexported fields
}

type StatusType int32