controller

const (
	// ReasonNotApplicable is the default condition reason for inactive conditions.
	ReasonNotApplicable = "NotApplicable"

	// ReasonNICResourceDetection is shared by the Certification and WorkloadRun
	// tiers: both emit a Normal event under it when NIC resource auto-detection
	// ran (on-prem GB200/GB300 target with nicResourceName unset) and found
	// zero or multiple qualifying candidates, so nothing was injected.
	ReasonNICResourceDetection = "NICResourceDetection"
)

const (
	// ReasonWaitingForNodes marks a Certification that found no schedulable nodes
	// and is retrying. Without it the wait is invisible: the retry only logged, so
	// the CR carried no conditions at all for up to nodeDiscoveryTimeout and an
	// operator had nothing to explain why nothing was happening.
	ReasonWaitingForNodes          = "WaitingForNodes"
	ReasonWorkflowCreated          = "WorkflowCreated"
	ReasonWorkflowRunning          = "WorkflowRunning"
	ReasonAllWorkflowsSucceeded    = "AllWorkflowsSucceeded"
	ReasonWorkflowFailed           = "WorkflowFailed"
	ReasonWorkflowValidationFailed = "WorkflowValidationFailed"
	ReasonCategoryNotFound         = "CategoryNotFound"
	ReasonBuildFailed              = "BuildFailed"
	ReasonWorkflowDeleted          = "WorkflowDeleted"
	ReasonWorkflowSucceeded        = "WorkflowSucceeded"
	ReasonThresholdViolation       = "ThresholdViolation"

	// ReasonWorkflowNameCollision marks a Certification whose generated child
	// Workflow name is already taken by a Workflow this Certification does not
	// own. The foreign object is neither adopted nor recorded for cleanup.
	ReasonWorkflowNameCollision = "WorkflowNameCollision"

	// ReasonWorkflowCreationError indicates a child Workflow could not be
	// created. Emitted as a Warning event at the failed Create call by the
	// Certification and WorkloadRun reconcilers, which both create Workflows,
	// so the API server's rejection is visible on the parent object rather
	// than only in the controller log. Mirrors ReasonJobCreationError
	// (Workflow tier) and ReasonWorkloadCreationError (Job tier).
	ReasonWorkflowCreationError = "WorkflowCreationError"
)

const (
	ReasonJobCreated          = "JobCreated"
	ReasonJobRunning          = "JobRunning"
	ReasonJobCompleted        = "JobCompleted"
	ReasonJobFailed           = "JobFailed"
	ReasonJobHardwareFailed   = "JobHardwareFailed"
	ReasonJobCreationError    = "JobCreationError"
	ReasonJobValidationFailed = "JobValidationFailed"

	// ReasonJobTimedOut marks a Job's Failed condition set by the Workflow when
	// the Job exceeded timeoutPerJob. Timed-out jobs are never retried.
	ReasonJobTimedOut = "JobTimedOut"

	ReasonGroupsPartitioned  = "GroupsPartitioned"
	ReasonIterationCompleted = "IterationCompleted"
	ReasonIterationsFailed   = "IterationsFailed"

	ReasonDependencyCreationError = "DependencyCreationError"
	ReasonNodeDiscoveryError      = "NodeDiscoveryError"
	ReasonPartitionError          = "PartitionError"

	// ReasonHeterogeneousPlatformStatusUpdateFailed reports inconsistent node
	// platforms when recording the Workflow's Failed condition also fails.
	// This action-failure Warning does not claim a persisted Failed phase.
	ReasonHeterogeneousPlatformStatusUpdateFailed = "HeterogeneousPlatformStatusUpdateFailed"

	// ReasonOverrideErrorStatusUpdateFailed reports an override application
	// error when recording the Workflow's Failed condition also fails. Both
	// override guards use this action-failure Warning, not a phase notification.
	ReasonOverrideErrorStatusUpdateFailed = "OverrideErrorStatusUpdateFailed"

	// ReasonJobNameCollision marks a Workflow whose generated Job name is
	// already taken by a Job this Workflow does not control. The foreign
	// object is neither adopted nor recorded for cleanup.
	ReasonJobNameCollision = "JobNameCollision"
	// ReasonDependencyNameCollision marks a Workflow whose dependency resource
	// name is already taken by an object this Workflow did not create. The
	// foreign object is neither adopted nor recorded for cleanup.
	ReasonDependencyNameCollision = "DependencyNameCollision"
	// ReasonGangSchedulingConflict marks a Workflow whose resolved Job template
	// is invalid after overrides. This includes workload metadata that fails
	// label validation even when no gang scheduler is configured, as well as a
	// template that no longer agrees with the gang-scheduling intent its owner
	// persisted. The invalid result is reported rather than repaired.
	ReasonGangSchedulingConflict = "GangSchedulingConflict"
)

const (
	ReasonWorkloadCreated = "WorkloadCreated"
	// ReasonWorkloadAdopted indicates the Job found the workload it had
	// already created still on the API server, because the write that records
	// status.WorkloadRef was lost after the Create succeeded, and took the
	// reference back rather than treating the name as taken.
	ReasonWorkloadAdopted = "WorkloadAdopted"
	// ReasonWorkloadPending indicates the workload exists but has not started
	// running — e.g. a TrainJob suspended by Kueue while it waits for quota.
	// The Job stays InProgress; pending time is not counted against
	// timeoutPerJob or stall detection.
	ReasonWorkloadPending       = "WorkloadPending"
	ReasonWorkloadRunning       = "WorkloadRunning"
	ReasonWorkloadCompleted     = "WorkloadCompleted"
	ReasonWorkloadFailed        = "WorkloadFailed"
	ReasonWorkloadCreationError = "WorkloadCreationError"
	ReasonWorkloadStalled       = "WorkloadStalled"

	// ReasonMeasurementCreationError indicates a GoodputMeasurement or
	// BandwidthMeasurement child resource could not be created. Handling is
	// non-fatal, so this event is the operator-visible signal; a threshold that
	// depends on the missing measurement still fails closed via
	// ReasonMeasurementTimeout.
	ReasonMeasurementCreationError = "MeasurementCreationError"

	ReasonHardwareFailureDetected = "HardwareFailureDetected"
)

const (
	FrameworkTorch = "torch"
	FrameworkMPI   = "mpi"
	FrameworkExec  = "exec"
)

const GPUNodeLabel = "nvidia.com/gpu.present"

const (
	// ReasonBuildFailedStatusUpdateFailed reports a WorkloadRun build error
	// when recording its Failed condition also fails. This action-failure
	// Warning does not claim that the Failed phase was persisted.
	ReasonBuildFailedStatusUpdateFailed = "BuildFailedStatusUpdateFailed"
)