health_result.hpp File Reference

#include <array>
#include <cstdint>
#include <optional>
#include <string>
#include <string_view>
#include <vector>

Go to the source code of this file.

Classes
struct	pulp::tooling::gpu_health::AdapterIdentity
	Native adapter identity. Missing optional fields represent absent evidence. More...
struct	pulp::tooling::gpu_health::ProbeMeasurements
	Optional measurements produced by one probe. More...
struct	pulp::tooling::gpu_health::EvidenceEvent
	One globally ordered stage observation with a registered diagnostic code. More...
struct	pulp::tooling::gpu_health::ProbeEvidence
	Evidence and aggregate verdict for one independently executed probe. More...
struct	pulp::tooling::gpu_health::HealthResult
	Closed versioned aggregate returned by the GPU health diagnostic. More...

Namespaces
namespace	pulp::tooling::gpu_health
	Bounded, typed evidence returned by Pulp GPU health diagnostics.
namespace	pulp
namespace	pulp::tooling

Enumerations
enum class	pulp::tooling::gpu_health::Verdict { pulp::tooling::gpu_health::pass , pulp::tooling::gpu_health::fail , pulp::tooling::gpu_health::unavailable , pulp::tooling::gpu_health::unverified }
	Four-state outcome that keeps missing or inconclusive evidence out of pass. More...
enum class	pulp::tooling::gpu_health::Stage {   pulp::tooling::gpu_health::configuration , pulp::tooling::gpu_health::adapter , pulp::tooling::gpu_health::shader_compile , pulp::tooling::gpu_health::pipeline_create ,   pulp::tooling::gpu_health::render , pulp::tooling::gpu_health::submit , pulp::tooling::gpu_health::readback , pulp::tooling::gpu_health::content ,   pulp::tooling::gpu_health::compute , pulp::tooling::gpu_health::device_state }
	Ordered semantic stage described by one EvidenceEvent. More...
enum class	pulp::tooling::gpu_health::AdapterClass { pulp::tooling::gpu_health::hardware , pulp::tooling::gpu_health::software , pulp::tooling::gpu_health::null_adapter , pulp::tooling::gpu_health::unknown }
	Adapter class proven by native identity, never inferred from backend alone. More...
enum class	pulp::tooling::gpu_health::HealthState {   pulp::tooling::gpu_health::healthy , pulp::tooling::gpu_health::failed , pulp::tooling::gpu_health::unavailable , pulp::tooling::gpu_health::unverified ,   pulp::tooling::gpu_health::lost }
	Aggregate device state derived from required probe evidence. More...
enum class	pulp::tooling::gpu_health::IdentityStatus { pulp::tooling::gpu_health::authentic , pulp::tooling::gpu_health::unverified , pulp::tooling::gpu_health::unavailable }
	Authenticity state for the optional native adapter identity fields. More...

Functions
constexpr bool	pulp::tooling::gpu_health::is_known_evidence_code (std::string_view code)
std::string_view	pulp::tooling::gpu_health::to_string (Verdict value)
	Return the canonical lowercase schema spelling from static storage.
std::string_view	pulp::tooling::gpu_health::to_string (Stage value)
std::string_view	pulp::tooling::gpu_health::to_string (AdapterClass value)
std::string_view	pulp::tooling::gpu_health::to_string (HealthState value)
std::string_view	pulp::tooling::gpu_health::to_string (IdentityStatus value)
std::optional< Verdict >	pulp::tooling::gpu_health::verdict_from_string (std::string_view value)
	Parse an exact canonical enum spelling; unknown text returns std::nullopt.
std::optional< Stage >	pulp::tooling::gpu_health::stage_from_string (std::string_view value)
std::optional< AdapterClass >	pulp::tooling::gpu_health::adapter_class_from_string (std::string_view value)
std::optional< HealthState >	pulp::tooling::gpu_health::health_state_from_string (std::string_view value)
std::optional< IdentityStatus >	pulp::tooling::gpu_health::identity_status_from_string (std::string_view value)
bool	pulp::tooling::gpu_health::validate (const HealthResult &result, std::string *error=nullptr)
	Validate bounds and cross-field relationships that JSON Schema cannot express.
std::string	pulp::tooling::gpu_health::to_json (const HealthResult &result, bool pretty=false)
	Serialize one validated or diagnostic result to the closed v1 JSON shape.
std::optional< HealthResult >	pulp::tooling::gpu_health::from_json (std::string_view json, std::string *error=nullptr)
	Parse only the v1 closed shape and apply validate() before returning a value.

Variables
constexpr std::string_view	pulp::tooling::gpu_health::kSchemaV1 = "pulp.gpu-health-result.v1"
	Historical closed schema identity accepted when parsing stored v1 results.
constexpr std::uint32_t	pulp::tooling::gpu_health::kVersionV1 = 1
constexpr std::string_view	pulp::tooling::gpu_health::kSchema = "pulp.gpu-health-result.v2"
	Active schema identity emitted by new GPU-health runs.
constexpr std::uint32_t	pulp::tooling::gpu_health::kVersion = 2
constexpr std::array	pulp::tooling::gpu_health::kEvidenceCodes
	Canonical diagnostic-code registry shared by result v1/v2, CLI, MCP, and agents.