fleetcontract

type Artifacts struct {
	GARMVersion          string `json:"garm_version"`
	GARMBinarySHA256     string `json:"garm_binary_sha256"`
	ProviderVersion      string `json:"provider_version"`
	ProviderCommit       string `json:"provider_commit"`
	ProviderBinarySHA256 string `json:"provider_binary_sha256"`
	ProviderInterface    string `json:"provider_interface"`
	IncusSDKVersion      string `json:"incus_sdk_version"`
}

type Blocker struct {
	Issue   int    `json:"issue" yaml:"issue"`
	Subject string `json:"subject" yaml:"subject"`
}

type Contract struct {
	SchemaVersion   int    `json:"schema_version"`
	ContractVersion int    `json:"contract_version"`
	Repository      string `json:"repository"`
	// Commit is the tree this contract describes. A consumer pins that commit;
	// anything else would be a contract about a tree nobody named.
	Commit string `json:"commit"`

	RunnerClasses     []RunnerClass     `json:"runner_classes"`
	Tenants           []TenantEntry     `json:"tenants"`
	Artifacts         Artifacts         `json:"artifacts"`
	Merge             Merge             `json:"merge"`
	Execution         Execution         `json:"execution"`
	ResourceSemantics ResourceSemantics `json:"resource_semantics"`
	Lifecycle         Lifecycle         `json:"lifecycle"`
	Observability     Observability     `json:"observability"`

	Guarantees     []Guarantee `json:"guarantees"`
	NotContractual []string    `json:"not_contractual"`
	OpenBlockers   []Blocker   `json:"open_blockers"`
}

type Declaration struct {
	SchemaVersion     int               `json:"schema_version" yaml:"schema_version"`
	ContractVersion   int               `json:"contract_version" yaml:"contract_version"`
	Execution         Execution         `json:"execution" yaml:"execution"`
	ResourceSemantics ResourceSemantics `json:"resource_semantics" yaml:"resource_semantics"`
	Lifecycle         Lifecycle         `json:"lifecycle" yaml:"lifecycle"`
	Observability     Observability     `json:"observability" yaml:"observability"`
	Guarantees        []Guarantee       `json:"guarantees" yaml:"guarantees"`
	NotContractual    []string          `json:"not_contractual" yaml:"not_contractual"`
	OpenBlockers      []Blocker         `json:"open_blockers" yaml:"open_blockers"`
}

type Execution struct {
	WorkerKind                string `json:"worker_kind" yaml:"worker_kind"`
	Ephemeral                 bool   `json:"ephemeral" yaml:"ephemeral"`
	JobsPerWorker             int    `json:"jobs_per_worker" yaml:"jobs_per_worker"`
	ExecutedWorkerDisposition string `json:"executed_worker_disposition" yaml:"executed_worker_disposition"`
	WarmWorkerReuse           string `json:"warm_worker_reuse" yaml:"warm_worker_reuse"`
}

type Guarantee struct {
	Subject string `json:"subject" yaml:"subject"`
	Promise string `json:"promise" yaml:"promise"`
}

type Lifecycle struct {
	States                      []string          `json:"states" yaml:"states"`
	PhaseSources                map[string]string `json:"phase_sources" yaml:"phase_sources"`
	AmbiguousAuthoritativeState string            `json:"ambiguous_authoritative_state" yaml:"ambiguous_authoritative_state"`
	CapacityRelease             string            `json:"capacity_release" yaml:"capacity_release"`
}

type Merge struct {
	Branch           string   `json:"branch"`
	RequiredContexts []string `json:"required_contexts"`
	Strict           bool     `json:"strict"`
	PullRequest      bool     `json:"pull_request_required"`
	EnforceAdmins    bool     `json:"enforce_admins"`
}

type Observability struct {
	PhaseCounts                 bool   `json:"phase_counts" yaml:"phase_counts"`
	PhaseOldestAge              bool   `json:"phase_oldest_age" yaml:"phase_oldest_age"`
	TransitionHistograms        bool   `json:"transition_histograms" yaml:"transition_histograms"`
	BoundedCorrelationIdentity  bool   `json:"bounded_correlation_identity" yaml:"bounded_correlation_identity"`
	ContainerAdmissionReadiness string `json:"container_admission_readiness" yaml:"container_admission_readiness"`
	VMPilotReadiness            string `json:"vm_pilot_readiness" yaml:"vm_pilot_readiness"`
}

type ResourceSemantics struct {
	MemoryCommitment                string   `json:"memory_commitment" yaml:"memory_commitment"`
	HardMemoryExcludesEmergencySwap bool     `json:"hard_memory_excludes_emergency_swap" yaml:"hard_memory_excludes_emergency_swap"`
	EmergencySwapSchedulable        bool     `json:"emergency_swap_schedulable" yaml:"emergency_swap_schedulable"`
	CPUMode                         string   `json:"cpu_mode" yaml:"cpu_mode"`
	CPUHardQuota                    bool     `json:"cpu_hard_quota" yaml:"cpu_hard_quota"`
	PressureSignals                 []string `json:"pressure_signals" yaml:"pressure_signals"`
	AdmissionHysteresisRequired     bool     `json:"admission_hysteresis_required" yaml:"admission_hysteresis_required"`
}

type Resources struct {
	// VCPU is the portable default. Deployments may tune CPU within the
	// published envelope from real workload telemetry without changing the
	// class's trust, capability, memory or storage contract.
	VCPU      int `json:"vcpu"`
	VCPUMin   int `json:"vcpu_min"`
	VCPUMax   int `json:"vcpu_max"`
	MemoryMiB int `json:"memory_mib"`
	DiskGiB   int `json:"disk_gib"`
}

type RunnerClass struct {
	Label           string `json:"label"`
	Image           string `json:"image"`
	WorkerKind      string `json:"worker_kind"`
	Ephemeral       bool   `json:"ephemeral"`
	JobsPerWorker   int    `json:"jobs_per_worker"`
	Trust           string `json:"trust"`
	Credentials     string `json:"credentials"`
	NetworkPolicy   string `json:"network_policy"`
	CacheWriteScope string `json:"cache_write_scope"`
	// Docker reports whether a job of this class can run containers and service
	// containers. It is the one capability difference a consumer chooses on.
	Docker    bool      `json:"docker"`
	Browser   bool      `json:"browser"`
	Resources Resources `json:"resources"`
	Warm      Warm      `json:"warm"`
}

type Sources struct {
	Root string
}

type TenantEntry struct {
	ID                 string `json:"id"`
	Owner              string `json:"owner"`
	Repository         string `json:"repository,omitempty"`
	ServesWholeAccount bool   `json:"serves_whole_account"`
}

type Warm struct {
	Supported   bool `json:"supported"`
	TargetReady int  `json:"target_ready"`
	MaxReady    int  `json:"max_ready"`
}