v1alpha1

type ApplicationsSelected struct {
	// Namespace is the namespace of the Argo CD application.
	Namespace string `json:"namespace"`
	// Name is the name of the Argo CD application.
	Name string `json:"name"`
	// Phase is the current phase of the commit status.
	Phase CommitStatusPhase `json:"phase"`
	// Sha is the commit SHA that this status is associated with.
	Sha string `json:"sha"`
	// LastTransitionTime is the last time the phase transitioned.
	// +kubebuilder:validation:Optional
	LastTransitionTime *metav1.Time `json:"lastTransitionTime"`
	// Environment is the syncSource.targetBranch of the Argo CD application (in effect, its environment).
	// +required
	// +kubebuilder:validation:MinLength=1
	Environment string `json:"environment,omitempty"`
	// ClusterName is the name of the cluster that the application manifest is deployed to. An empty string indicates
	// the local cluster.
	ClusterName string `json:"clusterName"`
}

type ArgoCDCommitStatus struct {
	metav1.TypeMeta   `json:",inline"`
	metav1.ObjectMeta `json:"metadata,omitempty"`

	Spec   ArgoCDCommitStatusSpec   `json:"spec,omitempty"`
	Status ArgoCDCommitStatusStatus `json:"status,omitempty"`
}

type ArgoCDCommitStatusConfiguration struct {
	// WorkQueue contains the work queue configuration for the ArgoCDCommitStatus controller.
	// This includes requeue duration, maximum concurrent reconciles, and rate limiter settings.
	// +required
	WorkQueue WorkQueue `json:"workQueue"`

	// WatchLocalApplications controls whether the controller monitors Argo CD Applications
	// in the local cluster. When false, the controller will only watch Applications in remote clusters
	// configured via kubeconfig secrets. This is useful when the Argo CD Application CRD is not installed
	// in the local cluster or when all Applications are deployed to remote clusters.
	// +required
	// +kubebuilder:default=true
	WatchLocalApplications bool `json:"watchLocalApplications"`
}

type ArgoCDCommitStatusList struct {
	metav1.TypeMeta `json:",inline"`
	metav1.ListMeta `json:"metadata,omitempty"`
	Items           []ArgoCDCommitStatus `json:"items"`
}

type ArgoCDCommitStatusSpec struct {
	// PromotionStrategyRef is a reference to the promotion strategy that this commit status applies to.
	// +kubebuilder:validation:Required
	PromotionStrategyRef ObjectReference `json:"promotionStrategyRef,omitempty"`

	// ApplicationSelector is a label selector that selects the Argo CD applications to which this commit status applies.
	// +kubebuilder:validation:Required
	ApplicationSelector *metav1.LabelSelector `json:"applicationSelector,omitempty"`

	// URL generates the URL to use in the CommitStatus, for example a link to the Argo CD UI.
	// +kubebuilder:validation:Optional
	URL URLConfig `json:"url,omitempty"`
}

type ArgoCDCommitStatusStatus struct {
	// ApplicationsSelected represents the Argo CD applications that are selected by the commit status.
	// This field is sorted by environment (same order as the referenced PromotionStrategy), then namespace, then name.
	ApplicationsSelected []ApplicationsSelected `json:"applicationsSelected,omitempty"`

	// Conditions Represents the observations of the current state.
	// +patchMergeKey=type
	// +patchStrategy=merge
	// +listType=map
	// +listMapKey=type
	Conditions []metav1.Condition `json:"conditions,omitempty" patchStrategy:"merge" patchMergeKey:"type"`
}

type Bucket struct {
	// Qps (queries per second) is the rate at which tokens are added to the bucket.
	// This defines the sustained rate limit for operations. Must be non-negative.
	// +required
	// +Validation:Minimum=0
	Qps int `json:"qps"`

	// Bucket is the maximum number of tokens that can be accumulated in the bucket.
	// This defines the maximum burst size - how many operations can occur in rapid
	// succession before rate limiting takes effect. Must be non-negative.
	// +required
	// +Validation:Minimum=0
	Bucket int `json:"bucket"`
}

type ChangeRequestPolicyCommitStatusPhase struct {
	// Key staging hydrated branch
	// +kubebuilder:validation:Required
	// +kubebuilder:validation:MinLength:=1
	// +kubebuilder:validation:MaxLength:=63
	// +kubebuilder:validation:Pattern:=([A-Za-z0-9][-A-Za-z0-9_.]*)?[A-Za-z0-9]
	Key string `json:"key"`

	// Phase what phase is the status in
	// +kubebuilder:validation:Required
	// +kubebuilder:validation:Enum:=pending;success;failure
	Phase string `json:"phase"`

	// Url is the URL of the commit status
	// +kubebuilder:validation:XValidation:rule="self == ” || isURL(self)",message="must be a valid URL"
	// +kubebuilder:validation:Pattern="^(https?://.*)?$"
	Url string `json:"url,omitempty"`
}

type ChangeTransferPolicy struct {
	metav1.TypeMeta   `json:",inline"`
	metav1.ObjectMeta `json:"metadata,omitempty"`

	Spec   ChangeTransferPolicySpec   `json:"spec,omitempty"`
	Status ChangeTransferPolicyStatus `json:"status,omitempty"`
}

type ChangeTransferPolicyConfiguration struct {
	// WorkQueue contains the work queue configuration for the ChangeTransferPolicy controller.
	// This includes requeue duration, maximum concurrent reconciles, and rate limiter settings.
	// +required
	WorkQueue WorkQueue `json:"workQueue"`
}

type ChangeTransferPolicyList struct {
	metav1.TypeMeta `json:",inline"`
	metav1.ListMeta `json:"metadata,omitempty"`
	Items           []ChangeTransferPolicy `json:"items"`
}

type ChangeTransferPolicySpec struct {

	// RepositoryReference what repository to open the PR on.
	// +kubebuilder:validation:Required
	RepositoryReference ObjectReference `json:"gitRepositoryRef"`

	// ProposedBranch staging hydrated branch
	// +kubebuilder:validation:Required
	ProposedBranch string `json:"proposedBranch"`

	// ActiveBranch staging hydrated branch
	// +kubebuilder:validation:Required
	ActiveBranch string `json:"activeBranch"`

	// +kubebuilder:validation:Optional
	// +kubebuilder:default:=true
	AutoMerge *bool `json:"autoMerge,omitempty"`

	// ActiveCommitStatuses lists the statuses to be monitored on the active branch
	// +kubebuilder:validation:Optional
	// +listType:=map
	// +listMapKey=key
	ActiveCommitStatuses []CommitStatusSelector `json:"activeCommitStatuses"`

	// ProposedCommitStatuses lists the statuses to be monitored on the proposed branch
	// +kubebuilder:validation:Optional
	// +listType:=map
	// +listMapKey=key
	ProposedCommitStatuses []CommitStatusSelector `json:"proposedCommitStatuses"`
}

type ChangeTransferPolicyStatus struct {
	// Proposed is the state of the proposed branch.
	Proposed CommitBranchState `json:"proposed,omitempty"`
	// Active is the state of the active branch.
	Active CommitBranchState `json:"active,omitempty"`
	// PullRequest is the state of the pull request that was created for this ChangeTransferPolicy.
	PullRequest *PullRequestCommonStatus `json:"pullRequest,omitempty"`

	// History defines the history of promoted changes done by the ChangeTransferPolicy. You can think of
	// it as a list of PRs merged by GitOps Promoter. It will not include changes that were manually merged.
	// The history length is hard-coded to be at most 5 entries. This may change in the future.
	// History is constructed on a best-effort basis and should be used for informational purposes only.
	// History is in reverse chronological order (newest is first).
	History []History `json:"history,omitempty"`

	// Conditions Represents the observations of the current state.
	// +patchMergeKey=type
	// +patchStrategy=merge
	// +listType=map
	// +listMapKey=type
	Conditions []metav1.Condition `json:"conditions,omitempty" patchStrategy:"merge" patchMergeKey:"type"`
}

type ClusterScmProvider struct {
	metav1.TypeMeta   `json:",inline"`
	metav1.ObjectMeta `json:"metadata,omitempty"`

	Spec   ScmProviderSpec   `json:"spec,omitempty"`
	Status ScmProviderStatus `json:"status,omitempty"`
}

type ClusterScmProviderList struct {
	metav1.TypeMeta `json:",inline"`
	metav1.ListMeta `json:"metadata,omitempty"`
	Items           []ClusterScmProvider `json:"items"`
}

type CommitBranchState struct {
	// Dry is the dry state of the branch, which is the commit that is being proposed.
	Dry CommitShaState `json:"dry,omitempty"`
	// Hydrated is the hydrated state of the branch, which is the commit that is currently being worked on.
	Hydrated CommitShaState `json:"hydrated,omitempty"`
	// CommitStatuses is a list of commit statuses that are being monitored for this branch.
	// +kubebuilder:validation:Optional
	// +listType:=map
	// +listMapKey=key
	CommitStatuses []ChangeRequestPolicyCommitStatusPhase `json:"commitStatuses,omitempty"`
}

type CommitBranchStateHistoryProposed struct {
	// Hydrated is the hydrated state of the branch, which is the commit that is currently being worked on.
	Hydrated CommitShaState `json:"hydrated,omitempty"`
	// CommitStatuses is a list of commit statuses that were being monitored for this branch.
	// This contains the state frozen at the moment the PR was merged.
	CommitStatuses []ChangeRequestPolicyCommitStatusPhase `json:"commitStatuses,omitempty"`
}

type CommitConfiguration struct {
	// Message is the commit message that will be written for the commit that's made when merging the PR.
	Message string `json:"message"`
}

type CommitMetadata struct {
	// Author is the author of the commit.
	Author string `json:"author,omitempty"`
	// Date is the date of the commit, formatted as by `git show -s --format=%aI`.
	Date *metav1.Time `json:"date,omitempty"`
	// Subject is the subject line of the commit message, i.e. `git show --format=%s`.
	Subject string `json:"subject,omitempty"`
	// Body is the body of the commit message, excluding the subject line, i.e. `git show --format=%b`.
	Body string `json:"body,omitempty"`
	// Sha is the commit hash.
	Sha string `json:"sha,omitempty"`
	// RepoURL is the URL of the repository where the commit is located.
	// +kubebuilder:validation:XValidation:rule="self == ” || isURL(self)",message="must be a valid URL"
	// +kubebuilder:validation:Pattern="^(https?://.*)?$"
	RepoURL string `json:"repoURL,omitempty"`
}

type CommitShaState struct {
	// Sha is the SHA of the commit in the branch
	Sha string `json:"sha,omitempty"`
	// CommitTime is the time the commit was made
	CommitTime metav1.Time `json:"commitTime,omitempty"`
	// RepoURL is the URL of the repository where the commit is located
	// +kubebuilder:validation:XValidation:rule="self == ” || isURL(self)",message="must be a valid URL"
	// +kubebuilder:validation:Pattern="^(https?://.*)?$"
	RepoURL string `json:"repoURL,omitempty"`
	// Author is the author of the commit
	Author string `json:"author,omitempty"`
	// Subject is the subject line of the commit message
	Subject string `json:"subject,omitempty"`
	// Body is the body of the commit message without the subject line
	Body string `json:"body,omitempty"`
	// References are the references to other commits, that went into the hydration of the branch
	References []RevisionReference `json:"references,omitempty"`
}

type CommitStatus struct {
	metav1.TypeMeta   `json:",inline"`
	metav1.ObjectMeta `json:"metadata,omitempty"`

	Spec   CommitStatusSpec   `json:"spec,omitempty"`
	Status CommitStatusStatus `json:"status,omitempty"`
}

type CommitStatusConfiguration struct {
	// WorkQueue contains the work queue configuration for the CommitStatus controller.
	// This includes requeue duration, maximum concurrent reconciles, and rate limiter settings.
	// +required
	WorkQueue WorkQueue `json:"workQueue"`
}

type CommitStatusList struct {
	metav1.TypeMeta `json:",inline"`
	metav1.ListMeta `json:"metadata,omitempty"`
	Items           []CommitStatus `json:"items"`
}

type CommitStatusPhase string

type CommitStatusSelector struct {
	// +required
	// +kubebuilder:validation:MinLength:=1
	// +kubebuilder:validation:MaxLength:=63
	// +kubebuilder:validation:Pattern:=([A-Za-z0-9][-A-Za-z0-9_.]*)?[A-Za-z0-9]
	Key string `json:"key"`
}

type CommitStatusSpec struct {

	// +kubebuilder:validation:Required
	RepositoryReference ObjectReference `json:"gitRepositoryRef"`

	// +kubebuilder:validation:Required
	// +kubebuilder:validation:MinLength=1
	// +kubebuilder:validation:MaxLength=64
	// +kubebuilder:validation:Pattern=`^[a-fA-F0-9]+$`
	Sha string `json:"sha"`

	// +kubebuilder:validation:Required
	Name string `json:"name"`

	Description string `json:"description"`

	// +kubebuilder:validation:Required
	// +kubebuilder:default:=pending
	// +kubebuilder:validation:Enum:=pending;success;failure
	Phase CommitStatusPhase `json:"phase"` // pending, success, failure

	// Url is a URL that the user can follow to see more details about the status
	// +kubebuilder:validation:Optional
	// +kubebuilder:validation:XValidation:rule="self == ” || isURL(self)",message="must be a valid URL"
	// +kubebuilder:validation:Pattern="^(https?://.*)?$"
	Url string `json:"url,omitempty"`
}

type CommitStatusStatus struct {

	// Id is the unique identifier of the commit status, set by the SCM
	Id  string `json:"id"`
	Sha string `json:"sha"`
	// +kubebuilder:default:=pending
	// +kubebuilder:validation:Enum:=pending;success;failure;""
	// +kubebuilder:validation:Optional
	Phase CommitStatusPhase `json:"phase,omitempty"`

	// Conditions Represents the observations of the current state.
	// +patchMergeKey=type
	// +patchStrategy=merge
	// +listType=map
	// +listMapKey=type
	Conditions []metav1.Condition `json:"conditions,omitempty" patchStrategy:"merge" patchMergeKey:"type"`
}

type ControllerConfiguration struct {
	metav1.TypeMeta   `json:",inline"`
	metav1.ObjectMeta `json:"metadata,omitempty"`

	Spec   ControllerConfigurationSpec   `json:"spec,omitempty"`
	Status ControllerConfigurationStatus `json:"status,omitempty"`
}

type ControllerConfigurationList struct {
	metav1.TypeMeta `json:",inline"`
	metav1.ListMeta `json:"metadata,omitempty"`
	Items           []ControllerConfiguration `json:"items"`
}

type ControllerConfigurationSpec struct {
	// PromotionStrategy contains the configuration for the PromotionStrategy controller,
	// including WorkQueue settings that control reconciliation behavior.
	// +required
	PromotionStrategy PromotionStrategyConfiguration `json:"promotionStrategy"`

	// ChangeTransferPolicy contains the configuration for the ChangeTransferPolicy controller,
	// including WorkQueue settings that control reconciliation behavior.
	// +required
	ChangeTransferPolicy ChangeTransferPolicyConfiguration `json:"changeTransferPolicy"`

	// PullRequest contains the configuration for the PullRequest controller,
	// including WorkQueue settings and pull request template configuration.
	// +required
	PullRequest PullRequestConfiguration `json:"pullRequest"`

	// CommitStatus contains the configuration for the CommitStatus controller,
	// including WorkQueue settings that control reconciliation behavior.
	// +required
	CommitStatus CommitStatusConfiguration `json:"commitStatus"`

	// ArgoCDCommitStatus contains the configuration for the ArgoCDCommitStatus controller,
	// including WorkQueue settings that control reconciliation behavior.
	// +required
	ArgoCDCommitStatus ArgoCDCommitStatusConfiguration `json:"argocdCommitStatus"`

	// TimedCommitStatus contains the configuration for the TimedCommitStatus controller,
	// including WorkQueue settings that control reconciliation behavior.
	// +required
	TimedCommitStatus TimedCommitStatusConfiguration `json:"timedCommitStatus"`
}

type ControllerConfigurationStatus struct{}

type Environment struct {
	// Branch is the name of the active branch for the environment.
	// +kubebuilder:validation:Required
	Branch string `json:"branch"`
	// AutoMerge determines whether the dry commit should be automatically merged into the next branch in the sequence.
	// If false, the dry commit will be proposed but not merged.
	// +kubebuilder:validation:Optional
	// +kubebuilder:default:=true
	AutoMerge *bool `json:"autoMerge,omitempty"`
	// ActiveCommitStatuses are commit statuses describing an actively running dry commit. If an active commit status
	// is failing for an environment, subsequent environments will not deploy the failing commit.
	//
	// The commit statuses specified in this field apply to this environment only. You can also specify commit statuses
	// for all environments in the `spec.activeCommitStatuses` field.
	// +kubebuilder:validation:Optional
	// +listType:=map
	// +listMapKey=key
	ActiveCommitStatuses []CommitStatusSelector `json:"activeCommitStatuses"`
	// ProposedCommitStatuses are commit statuses describing a proposed dry commit, i.e. one that is not yet running
	// in a live environment. If a proposed commit status is failing for a given environment, the dry commit will not
	// be promoted to that environment.
	//
	// The commit statuses specified in this field apply to this environment only. You can also specify commit statuses
	// for all environments in the `spec.proposedCommitStatuses` field.
	// +kubebuilder:validation:Optional
	// +listType:=map
	// +listMapKey=key
	ProposedCommitStatuses []CommitStatusSelector `json:"proposedCommitStatuses"`
}

type EnvironmentStatus struct {
	// Branch is the name of the active branch for the environment.
	Branch string `json:"branch"`
	// Proposed is the state of the proposed branch for the environment.
	Proposed CommitBranchState `json:"proposed"`
	// Active is the state of the active branch for the environment.
	Active CommitBranchState `json:"active"`

	// PullRequest is the state of the pull request that was created for this environment.
	PullRequest *PullRequestCommonStatus `json:"pullRequest,omitempty"`

	// LastHealthyDryShas is a list of dry commits that were observed to be healthy in the environment.
	// +kubebuilder:validation:Optional
	LastHealthyDryShas []HealthyDryShas `json:"lastHealthyDryShas"`

	// History defines the history of promoted changes done by the PromotionStrategy for each environment.
	// You can think of it as a list of PRs merged by GitOps Promoter. It will not include changes that were
	// manually merged. The history length is hard-coded to be at most 5 entries. This may change in the future.
	// History is constructed on a best-effort basis and should be used for informational purposes only.
	// History is in reverse chronological order (newest is first).
	History []History `json:"history,omitempty"`
}

type ExponentialFailure struct {
	// BaseDelay is the initial delay after the first failure. Subsequent failures will exponentially
	// increase this delay (2x, 4x, 8x, etc.) until MaxDelay is reached.
	// Format follows Go's time.Duration syntax (e.g., "1s" for 1 second).
	// +required
	BaseDelay metav1.Duration `json:"baseDelay"`

	// MaxDelay is the maximum delay between retry attempts. Once the exponential backoff reaches
	// this value, all subsequent retries will use this delay.
	// Format follows Go's time.Duration syntax (e.g., "1m" for 1 minute).
	// +required
	MaxDelay metav1.Duration `json:"maxDelay"`
}

type Fake struct {
	// Domain is the domain of the fake SCM provider. This is used for testing purposes.
	Domain string `json:"domain,omitempty"`
}

type FakeRepo struct {
	// Owner is the owner of the repository.
	// +kubebuilder:validation:Required
	Owner string `json:"owner"`
	// Name is the name of the repository.
	// +kubebuilder:validation:Required
	Name string `json:"name"`
}

type FastSlow struct {
	// FastDelay is the delay used for the first MaxFastAttempts retry attempts.
	// Format follows Go's time.Duration syntax (e.g., "100ms" for 100 milliseconds).
	// +required
	FastDelay metav1.Duration `json:"fastDelay"`

	// SlowDelay is the delay used for retry attempts after MaxFastAttempts have been exhausted.
	// Format follows Go's time.Duration syntax (e.g., "10s" for 10 seconds).
	// +required
	SlowDelay metav1.Duration `json:"slowDelay"`

	// MaxFastAttempts is the number of retry attempts that use FastDelay before switching to SlowDelay.
	// Must be at least 1.
	// +required
	// +Validation:Minimum=1
	MaxFastAttempts int `json:"maxFastAttempts"`
}

type Forgejo struct {
	// Domain is the Forgejo domain, such as "codeberg.org" or "forgejo.mycompany.com".
	// There is no default domain since Forgejo is not a service like Gitlab or Github.
	// +kubebuilder:validation:Required
	Domain string `json:"domain"`
}

type ForgejoRepo struct {
	// Owner is the owner of the repository.
	// +kubebuilder:validation:Required
	Owner string `json:"owner"`
	// Name is the name of the repository.
	// +kubebuilder:validation:Required
	Name string `json:"name"`
}

type GenericScmProvider interface {
	runtime.Object
	metav1.Object
	GetSpec() *ScmProviderSpec
}

type GitHub struct {
	// Domain is the GitHub domain, such as "github.mycompany.com". If using the default GitHub domain, leave this field
	// empty.
	// +kubebuilder:validation:XValidation:rule=`self != "github.com"`, message="Instead of setting the domain to github.com, leave the field blank"
	Domain string `json:"domain,omitempty"`
	// AppID is the GitHub App ID.
	// +kubebuilder:validation:Required
	AppID int64 `json:"appID"`
	// InstallationID is the GitHub App Installation ID. If you want to use this ScmProvider for multiple
	// GitHub orgs, do not specify this field. The installation ID will be inferred from the repo owner
	// when needed.
	// +kubebuilder:validation:Optional
	// +kubebuilder:validation:Minimum=0
	InstallationID int64 `json:"installationID,omitempty"`
}

type GitHubRepo struct {

	// Owner is the owner of the repository, which can be a user or an organization.
	// +kubebuilder:validation:Required
	// +kubebuilder:validation:MaxLength=39
	// +kubebuilder:validation:Pattern=^[a-zA-Z0-9][a-zA-Z0-9\-]*$
	Owner string `json:"owner"`
	// Name is the name of the repository.
	// +kubebuilder:validation:Required
	// +kubebuilder:validation:MaxLength=100
	// +kubebuilder:validation:Pattern=^[a-zA-Z0-9_\-\.]+$
	Name string `json:"name"`
}

type GitLab struct {
	// Domain is the GitLab domain, such as "gitlab.mycompany.com". If using the default GitLab domain, leave this field
	// empty.
	Domain string `json:"domain,omitempty"`
}

type GitLabRepo struct {
	// Namespace is the user, group or group with subgroup (e.g. group/subgroup).
	// +kubebuilder:validation:Required
	// +kubebuilder:validation:Pattern=^[a-zA-Z0-9_\-\/.]+$
	Namespace string `json:"namespace"`
	// Name is the project slug of the repository.
	// +kubebuilder:validation:Required
	// +kubebuilder:validation:Pattern=^[a-zA-Z0-9_\-\/.]+$
	Name string `json:"name"`
	// ProjectID is the ID of the project in GitLab.
	// +kubebuilder:validation:Required
	ProjectID int `json:"projectId"`
}

type GitRepository struct {
	metav1.TypeMeta   `json:",inline"`
	metav1.ObjectMeta `json:"metadata,omitempty"`

	Spec   GitRepositorySpec   `json:"spec,omitempty"`
	Status GitRepositoryStatus `json:"status,omitempty"`
}

type GitRepositoryList struct {
	metav1.TypeMeta `json:",inline"`
	metav1.ListMeta `json:"metadata,omitempty"`
	Items           []GitRepository `json:"items"`
}

type GitRepositorySpec struct {
	GitHub  *GitHubRepo  `json:"github,omitempty"`
	GitLab  *GitLabRepo  `json:"gitlab,omitempty"`
	Forgejo *ForgejoRepo `json:"forgejo,omitempty"`
	Fake    *FakeRepo    `json:"fake,omitempty"`
	// +kubebuilder:validation:Required
	ScmProviderRef ScmProviderObjectReference `json:"scmProviderRef"`
}

type GitRepositoryStatus struct {

	// Conditions Represents the observations of the current state.
	// +patchMergeKey=type
	// +patchStrategy=merge
	// +listType=map
	// +listMapKey=type
	Conditions []metav1.Condition `json:"conditions,omitempty" patchStrategy:"merge" patchMergeKey:"type"`
}

type HealthyDryShas struct {
	// Sha is the commit SHA of the dry commit that was observed to be healthy.
	Sha string `json:"sha"`
	// Time is the time when the proposed commit for the given dry SHA was merged into the active branch.
	Time metav1.Time `json:"time"`
}

type History struct {
	// Proposed is the state of the proposed branch at the time the PR was merged.
	Proposed CommitBranchStateHistoryProposed `json:"proposed,omitempty"`
	// Active is the state of the active branch at the time the PR was merged.
	Active CommitBranchState `json:"active,omitempty"`
	// PullRequest is the state of the pull request that was created for this ChangeTransferPolicy.
	PullRequest *PullRequestCommonStatus `json:"pullRequest,omitempty"`
}

type ObjectReference struct {
	// Name is the name of the object to refer to.
	// +kubebuilder:validation:Required
	Name string `json:"name"`
}

type PromotionStrategy struct {
	metav1.TypeMeta   `json:",inline"`
	metav1.ObjectMeta `json:"metadata,omitempty"`

	Spec   PromotionStrategySpec   `json:"spec,omitempty"`
	Status PromotionStrategyStatus `json:"status,omitempty"`
}

type PromotionStrategyConfiguration struct {
	// WorkQueue contains the work queue configuration for the PromotionStrategy controller.
	// This includes requeue duration, maximum concurrent reconciles, and rate limiter settings.
	// +required
	WorkQueue WorkQueue `json:"workQueue"`
}

type PromotionStrategyList struct {
	metav1.TypeMeta `json:",inline"`
	metav1.ListMeta `json:"metadata,omitempty"`
	Items           []PromotionStrategy `json:"items"`
}

type PromotionStrategySpec struct {

	// RepositoryReference indicates what repository to promote commits in.
	// +kubebuilder:validation:Required
	RepositoryReference ObjectReference `json:"gitRepositoryRef"`

	// ActiveCommitStatuses are commit statuses describing an actively running dry commit. If an active commit status
	// is failing for an environment, subsequent environments will not deploy the failing commit.
	//
	// The commit statuses specified in this field apply to all environments in the promotion sequence. You can also
	// specify commit statuses for individual environments in the `environments` field.
	// +kubebuilder:validation:Optional
	// +listType:=map
	// +listMapKey=key
	ActiveCommitStatuses []CommitStatusSelector `json:"activeCommitStatuses"`

	// ProposedCommitStatuses are commit statuses describing a proposed dry commit, i.e. one that is not yet running
	// in a live environment. If a proposed commit status is failing for a given environment, the dry commit will not
	// be promoted to that environment.
	//
	// The commit statuses specified in this field apply to all environments in the promotion sequence. You can also
	// specify commit statuses for individual environments in the `environments` field.
	// +kubebuilder:validation:Optional
	// +listType:=map
	// +listMapKey=key
	ProposedCommitStatuses []CommitStatusSelector `json:"proposedCommitStatuses"`

	// Environments is the sequence of environments that a dry commit will be promoted through.
	// +kubebuilder:validation:MinItems:=1
	// +listType:=map
	// +listMapKey=branch
	Environments []Environment `json:"environments"`
}

type PromotionStrategyStatus struct {
	// Environments holds the status of each environment in the promotion sequence.
	// +listType:=map
	// +listMapKey=branch
	Environments []EnvironmentStatus `json:"environments"`

	// Conditions Represents the observations of the current state.
	// +patchMergeKey=type
	// +patchStrategy=merge
	// +listType=map
	// +listMapKey=type
	Conditions []metav1.Condition `json:"conditions,omitempty" patchStrategy:"merge" patchMergeKey:"type"`
}

type PullRequest struct {
	metav1.TypeMeta   `json:",inline"`
	metav1.ObjectMeta `json:"metadata,omitempty"`

	Spec   PullRequestSpec   `json:"spec,omitempty"`
	Status PullRequestStatus `json:"status,omitempty"`
}

type PullRequestCommonStatus struct {
	// ID is the unique identifier of the pull request, set by the SCM.
	ID string `json:"id,omitempty"`
	// State is the state of the pull request.
	// +kubebuilder:validation:Enum=closed;merged;open
	State PullRequestState `json:"state,omitempty"`
	// PRCreationTime is the time when the pull request was created.
	PRCreationTime metav1.Time `json:"prCreationTime,omitempty"`
	// PRMergeTime is the time when the pull request was merged. This time can vary slightly from the actual merge time because
	// it is the time when the ChangeTransferPolicy controller sets the pull requests spec to merge. In the future we plan on making
	// this time more accurate by fetching the actual merge time from the SCM via the webhook this would then be updated in the git note
	// for that commit.
	PRMergeTime metav1.Time `json:"prMergeTime,omitempty"`
	// Url is the URL of the pull request.
	// +kubebuilder:validation:XValidation:rule="self == ” || isURL(self)",message="must be a valid URL"
	// +kubebuilder:validation:Pattern="^(https?://.*)?$"
	Url string `json:"url,omitempty"`
}

type PullRequestConfiguration struct {
	// Template is the template configuration used to generate pull request titles and descriptions.
	// Uses Go template syntax with Sprig functions available.
	// +required
	Template PullRequestTemplate `json:"template"`

	// WorkQueue contains the work queue configuration for the PullRequest controller.
	// This includes requeue duration, maximum concurrent reconciles, and rate limiter settings.
	// +required
	WorkQueue WorkQueue `json:"workQueue"`
}

type PullRequestList struct {
	metav1.TypeMeta `json:",inline"`
	metav1.ListMeta `json:"metadata,omitempty"`
	Items           []PullRequest `json:"items"`
}

type PullRequestSpec struct {

	// RepositoryReference indicates what repository to open the PR on.
	// +kubebuilder:validation:Required
	RepositoryReference ObjectReference `json:"gitRepositoryRef"`
	// Title is the title of the pull request.
	// +kubebuilder:validation:Required
	Title string `json:"title"`
	// TargetBranch is the head the git reference we are merging from Head ---> Base
	// +kubebuilder:validation:XValidation:rule="self == oldSelf",message="Value is immutable"
	// +kubebuilder:validation:Required
	TargetBranch string `json:"targetBranch"`
	// SourceBranch is the base the git reference that we are merging into Head ---> Base
	// +kubebuilder:validation:XValidation:rule="self == oldSelf",message="Value is immutable"
	// +kubebuilder:validation:Required
	SourceBranch string `json:"sourceBranch"`
	// Description is the description body of the pull/merge request
	Description string `json:"description,omitempty"`
	// Commit contains configuration for how we will merge/squash/etc the pull request.
	Commit CommitConfiguration `json:"commit,omitempty"`
	// MergeSha is the commit SHA that the head branch must match before the PR can be merged.
	// This prevents a race condition where a PR is merged with a different commit than intended.
	// +kubebuilder:validation:Required
	// +kubebuilder:validation:MinLength=1
	// +kubebuilder:validation:MaxLength=64
	// +kubebuilder:validation:Pattern=`^[a-fA-F0-9]+$`
	MergeSha string `json:"mergeSha"`
	// State of the pull request (closed, merged, or open). Must always be "open" when creating a new pull request.
	// This value may not be changed to "closed" or "merged" unless the pull request status.id is set.
	// +kubebuilder:default:=open
	// +kubebuilder:validation:Required
	// +kubebuilder:validation:Enum=closed;merged;open
	State PullRequestState `json:"state"`
}

type PullRequestState string

type PullRequestStatus struct {

	// ID the id of the pull request
	ID string `json:"id,omitempty"`
	// State of the merge request closed/merged/open
	// +kubebuilder:validation:Enum="";closed;merged;open
	State PullRequestState `json:"state,omitempty"`
	// PRCreationTime the time the PR was created
	PRCreationTime metav1.Time `json:"prCreationTime,omitempty"`
	// Url is the URL of the pull request.
	// +kubebuilder:validation:XValidation:rule="self == ” || isURL(self)",message="must be a valid URL"
	// +kubebuilder:validation:Pattern="^(https?://.*)?$"
	Url string `json:"url,omitempty"`

	// Conditions Represents the observations of the current state.
	// +patchMergeKey=type
	// +patchStrategy=merge
	// +listType=map
	// +listMapKey=type
	Conditions []metav1.Condition `json:"conditions,omitempty" patchStrategy:"merge" patchMergeKey:"type"`
}

type PullRequestTemplate struct {
	// Title is the template used to generate the title of the pull request.
	// Uses Go template syntax with Sprig functions available for string manipulation.
	// +required
	Title string `json:"title"`

	// Description is the template used to generate the body/description of the pull request.
	// Uses Go template syntax with Sprig functions available for string manipulation.
	// +required
	Description string `json:"description"`
}

type RateLimiter struct {
	// RateLimiterTypes can be one of: FastSlow, ExponentialFailure, or Bucket.
	// +optional
	RateLimiterTypes `json:",inline"`

	// MaxOf allows combining multiple rate limiters, where the maximum delay from all
	// limiters is used. This enables sophisticated rate limiting that respects multiple
	// constraints simultaneously (e.g., both per-item exponential backoff and global rate limits).
	// +optional
	// +kubebuilder:validation:MaxItems=3
	MaxOf []RateLimiterTypes `json:"maxOf,omitempty"`
}

type RateLimiterTypes struct {
	// FastSlow rate limiter provides fast retries initially, then switches to slow retries.
	// Useful for quickly retrying transient errors while backing off for persistent failures.
	// +optional
	FastSlow *FastSlow `json:"fastSlow,omitempty"`

	// ExponentialFailure rate limiter increases delay exponentially with each failure.
	// Standard approach for backing off when operations fail repeatedly.
	// +optional
	ExponentialFailure *ExponentialFailure `json:"exponentialFailure,omitempty"`

	// Bucket rate limiter uses a token bucket algorithm to control request rate.
	// Allows bursts while maintaining an average rate limit.
	// +optional
	Bucket *Bucket `json:"bucket,omitempty"`
}

type RevertCommit struct {
	metav1.TypeMeta   `json:",inline"`
	metav1.ObjectMeta `json:"metadata,omitempty"`

	Spec   RevertCommitSpec   `json:"spec,omitempty"`
	Status RevertCommitStatus `json:"status,omitempty"`
}

type RevertCommitList struct {
	metav1.TypeMeta `json:",inline"`
	metav1.ListMeta `json:"metadata,omitempty"`
	Items           []RevertCommit `json:"items"`
}

type RevertCommitSpec struct {

	// Foo is an example field of RevertCommit. Edit revertcommit_types.go to remove/update
	Foo string `json:"foo,omitempty"`
}

type RevertCommitStatus struct {
}

type RevisionReference struct {
	// Commit contains metadata about the commit that is related in some way to another commit.
	Commit *CommitMetadata `json:"commit,omitempty"`
}

type ScmProvider struct {
	metav1.TypeMeta   `json:",inline"`
	metav1.ObjectMeta `json:"metadata,omitempty"`

	Spec   ScmProviderSpec   `json:"spec,omitempty"`
	Status ScmProviderStatus `json:"status,omitempty"`
}

type ScmProviderList struct {
	metav1.TypeMeta `json:",inline"`
	metav1.ListMeta `json:"metadata,omitempty"`
	Items           []ScmProvider `json:"items"`
}

type ScmProviderObjectReference struct {
	// Kind is the type of resource being referenced
	// +kubebuilder:validation:Required
	// +kubebuilder:default:=ScmProvider
	// +kubebuilder:validation:Enum:=ScmProvider;ClusterScmProvider
	Kind string `json:"kind"`
	// Name is the name of the resource being referenced
	// +kubebuilder:validation:Required
	Name string `json:"name"`
}

type ScmProviderSpec struct {

	// SecretRef contains the credentials required to auth to a specific provider
	SecretRef *v1.LocalObjectReference `json:"secretRef,omitempty"`

	// GitHub required configuration for GitHub as the SCM provider
	GitHub *GitHub `json:"github,omitempty"`

	// GitLab required configuration for GitLab as the SCM provider
	GitLab *GitLab `json:"gitlab,omitempty"`

	// Forgejo required configuration for Forgejo as the SCM provider
	Forgejo *Forgejo `json:"forgejo,omitempty"`

	// Fake required configuration for Fake as the SCM provider
	Fake *Fake `json:"fake,omitempty"`
}

type ScmProviderStatus struct {

	// Conditions Represents the observations of the current state.
	// +patchMergeKey=type
	// +patchStrategy=merge
	// +listType=map
	// +listMapKey=type
	Conditions []metav1.Condition `json:"conditions,omitempty" patchStrategy:"merge" patchMergeKey:"type"`
}

type TimedCommitStatus struct {
	metav1.TypeMeta `json:",inline"`

	// metadata is a standard object metadata
	// +optional
	metav1.ObjectMeta `json:"metadata,omitempty"`

	// spec defines the desired state of TimedCommitStatus
	// +required
	Spec TimedCommitStatusSpec `json:"spec"`

	// status defines the observed state of TimedCommitStatus
	// +optional
	Status TimedCommitStatusStatus `json:"status,omitempty"`
}

type TimedCommitStatusConfiguration struct {
	// WorkQueue contains the work queue configuration for the TimedCommitStatus controller.
	// This includes requeue duration, maximum concurrent reconciles, and rate limiter settings.
	// +required
	WorkQueue WorkQueue `json:"workQueue"`
}

type TimedCommitStatusEnvironments struct {
	// Branch is the name of the branch/environment you want to gate for the configured duration.
	// +required
	Branch string `json:"branch"`
	// Duration is the time duration to wait before considering the commit status as success.
	// The duration should be in a format accepted by Go's time.ParseDuration function, e.g., "5m", "1h30m".
	// +required
	Duration metav1.Duration `json:"duration"`
}

type TimedCommitStatusEnvironmentsStatus struct {
	// Branch is the name of the branch/environment.
	// +required
	Branch string `json:"branch"`

	// Sha is the commit SHA being tracked for this environment.
	// +required
	Sha string `json:"sha"`

	// CommitTime is when the commit was deployed to the active environment.
	// +required
	CommitTime metav1.Time `json:"commitTime"`

	// RequiredDuration is the duration that must elapse before promotion is allowed.
	// If this is updated in the spec with a pending time. The new duration will be calculated from the original CommitTime.
	// Allowing you to extend the duration of an already deployed commit, if the time has not yet elapsed.
	// +required
	RequiredDuration metav1.Duration `json:"requiredDuration"`

	// Phase represents the current phase of the timed gate.
	// +kubebuilder:validation:Enum=pending;success
	// +required
	Phase string `json:"phase"`

	// AtMostDurationRemaining is the maximum amount of time remaining until the gate is satisfied.
	// This is calculated at reconciliation time. When the gate is satisfied (phase=success), this will be 0.
	// +required
	AtMostDurationRemaining metav1.Duration `json:"atMostDurationRemaining"`
}

type TimedCommitStatusList struct {
	metav1.TypeMeta `json:",inline"`
	metav1.ListMeta `json:"metadata,omitempty"`
	Items           []TimedCommitStatus `json:"items"`
}

type TimedCommitStatusSpec struct {

	// PromotionStrategyRef is a reference to the promotion strategy that this timed commit status applies to.
	// +required
	PromotionStrategyRef ObjectReference `json:"promotionStrategyRef"`

	// +required
	Environments []TimedCommitStatusEnvironments `json:"environments"`
}

type TimedCommitStatusStatus struct {

	// Environments holds the status of each environment being tracked.
	// +listType=map
	// +listMapKey=branch
	// +optional
	Environments []TimedCommitStatusEnvironmentsStatus `json:"environments,omitempty"`

	// Conditions represent the latest available observations of an object's state
	// +listType=map
	// +listMapKey=type
	// +optional
	Conditions []metav1.Condition `json:"conditions,omitempty"`
}

type URLConfig struct {
	// Template is a go text template and receives .Environment and .ArgoCDCommitStatus variables. A function called urlQueryEscape
	// is available to escape url query parameters. The template can be configured with options to control the behavior
	// during execution if a variable is not present.
	//
	// Example:
	//
	//   {{- $baseURL := "https://dev.argocd.local" -}}
	//   {{- if eq .Environment "environment/development" -}}
	//   {{- $baseURL = "https://dev.argocd.local" -}}
	//   {{- else if eq .Environment "environment/staging" -}}
	//   {{- $baseURL = "https://staging.argocd.local" -}}
	//   {{- else if eq .Environment "environment/production" -}}
	//   {{- $baseURL = "https://prod.argocd.local" -}}
	//   {{- end -}}
	//   {{- $labels := "" -}}
	//   {{- range $key, $value := .ArgoCDCommitStatus.Spec.ApplicationSelector.MatchLabels -}}
	//   {{- $labels = printf "%s%s=%s," $labels $key $value -}}
	//   {{- end -}}
	//   {{ printf "%s/applications?labels=%s" $baseURL (urlQueryEscape $labels) }}
	//
	// +kubebuilder:validation:Optional
	Template string `json:"template,omitempty"`

	// Options sets options for the template. Options are described by
	// strings, either a simple string or "key=value". There can be at
	// most one equals sign in an option string. If the option string
	// is unrecognized or otherwise invalid, Option panics.
	//
	// Known options:
	//
	// missingkey: Control the behavior during execution if a map is
	// indexed with a key that is not present in the map.
	//
	//	"missingkey=default" or "missingkey=invalid"
	//		The default behavior: Do nothing and continue execution.
	//		If printed, the result of the index operation is the string
	//		"<no value>".
	//	"missingkey=zero"
	//		The operation returns the zero value for the map type's element.
	//	"missingkey=error"
	//		Execution stops immediately with an error.
	//
	// +kubebuilder:validation:Optional
	Options []string `json:"options,omitempty"`
}

type WorkQueue struct {
	// RequeueDuration specifies how frequently resources should be requeued for automatic reconciliation.
	// This creates a periodic reconciliation loop that ensures the desired state is maintained even
	// without external triggers. Format follows Go's time.Duration syntax (e.g., "5m" for 5 minutes).
	// +required
	RequeueDuration metav1.Duration `json:"requeueDuration"`

	// MaxConcurrentReconciles defines the maximum number of concurrent reconcile operations
	// that can run for this controller. Higher values increase throughput but consume more
	// resources. Must be at least 1.
	// +required
	// +Validation:Minimum=1
	MaxConcurrentReconciles int `json:"maxConcurrentReconciles"`

	// RateLimiter defines the rate limiting strategy for the controller's work queue.
	// Rate limiting controls how quickly failed reconciliations are retried and helps
	// prevent overwhelming external APIs or systems.
	// +required
	RateLimiter RateLimiter `json:"rateLimiter"`
}