jira

type ByJiraEscalationName []Escalation

type Escalation struct {
	// Name is the unique identifier for this escalation level
	Name string `json:"name,omitempty" yaml:"name,omitempty"`

	// Failures is the number of failures required to trigger this escalation
	// When used alone, this counts consecutive failures
	// When combined with OverLastRuns, this counts total failures in the window
	Failures int `json:"failures,omitempty" yaml:"failures,omitempty"`

	// OverLastRuns defines the window of recent runs to consider
	// If omitted when Failures is set, defaults to Failures (consecutive mode)
	// Can be combined with Failures, PassPercentage, or OverPeriod
	// +kubebuilder:validation:Minimum=1
	OverLastRuns *int `json:"overLastRuns,omitempty" yaml:"overLastRuns,omitempty"`

	// PassPercentage defines the minimum pass rate required (0-100)
	// Escalates when the pass rate falls below this threshold
	// Must be used with OverLastRuns to define the evaluation window
	// +kubebuilder:validation:Minimum=0
	// +kubebuilder:validation:Maximum=100
	PassPercentage *int `json:"passPercentage,omitempty" yaml:"passPercentage,omitempty"`

	// OverPeriod defines a time window for considering runs (e.g., "2d" for 2 days)
	// Used with OverLastRuns to expand the sample set: whichever provides more runs is used
	// Format examples: "1h", "24h", "2d", "1w"
	// +kubebuilder:validation:Pattern=`^[1-9]\d*(h|d|w)$`
	OverPeriod string `json:"overPeriod,omitempty" yaml:"overPeriod,omitempty"`

	// Priority is the Jira priority level for tickets created at this escalation
	Priority string `json:"priority,omitempty" yaml:"priority,omitempty"`

	// Mentions is a list of users to mention in the Jira ticket
	Mentions []string `json:"mentions,omitempty" yaml:"mentions,omitempty"`

	// NeedsInfo is a list of users to add as watchers or request information from
	NeedsInfo []string `json:"needsInfo,omitempty" yaml:"needsInfo,omitempty"`
}

type Notification struct {
	// Project is the Jira project key where tickets will be created
	Project string `json:"project,omitempty" yaml:"project,omitempty"`

	// Component is the Jira component this qualifier relates to
	Component string `json:"component,omitempty" yaml:"component,omitempty"`

	// Assignee is the default assignee for tickets created by this qualifier
	Assignee string `json:"assignee,omitempty" yaml:"assignee,omitempty"`

	// Summary is the default summary text for Jira tickets
	Summary string `json:"summary,omitempty" yaml:"summary,omitempty"`

	// Description is the default description text for Jira tickets
	Description string `json:"description,omitempty" yaml:"description,omitempty"`

	// Thread identifier for separating notifications across jobs
	// When multiple jobs contribute to the same qualifier, different thread values
	// will result in separate Jira tickets being created
	Thread string `json:"thread,omitempty" yaml:"thread,omitempty"`

	// Escalations defines the escalation rules for Jira notifications
	// Each escalation specifies when and how to create tickets based on failure patterns
	Escalations []Escalation `json:"escalations,omitempty" yaml:"escalations,omitempty"`
}