v1alpha1

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

	Spec   CDOperatorConfigSpec   `json:"spec,omitempty"`
	Status CDOperatorConfigStatus `json:"status,omitempty"`
}

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

type CDOperatorConfigSpec struct {
	// GitHubToken is the GitHub authentication token for API access
	GitHubToken string `json:"githubToken"`

	// GitHubOrg is the GitHub organization name to monitor
	GitHubOrg string `json:"githubOrg"`

	// ReconcileInterval is the interval between reconciliation loops
	ReconcileInterval metav1.Duration `json:"reconcileInterval"`

	// WorkerPoolSize is the number of concurrent workers for processing
	WorkerPoolSize int `json:"workerPoolSize"`

	// MetricsEnabled indicates whether Prometheus metrics are enabled
	MetricsEnabled bool `json:"metricsEnabled"`

	// MetricsPort is the port for exposing Prometheus metrics
	MetricsPort int `json:"metricsPort"`

	// TracingEnabled indicates whether OpenTelemetry tracing is enabled
	TracingEnabled bool `json:"tracingEnabled"`

	// LogLevel is the logging level (debug, info, warn, error)
	LogLevel string `json:"logLevel"`
}

type CDOperatorConfigStatus struct {
	// ObservedGeneration reflects the generation of the most recently observed CDOperatorConfig
	ObservedGeneration int64 `json:"observedGeneration,omitempty"`
}

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

	Spec   ClusterConfigSpec   `json:"spec,omitempty"`
	Status ClusterConfigStatus `json:"status,omitempty"`
}

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

type ClusterConfigSpec struct {
	// ClusterName is the unique identifier for this cluster
	ClusterName string `json:"clusterName"`

	// ArgoCDMode determines how to connect to ArgoCD (internal or external)
	// +kubebuilder:validation:Enum=internal;external
	ArgoCDMode string `json:"argocdMode"`

	// ArgoCDEndpoint is the ArgoCD API endpoint URL (required for external mode)
	ArgoCDEndpoint string `json:"argocdEndpoint,omitempty"`

	// ArgoCDToken is the ArgoCD authentication token (required for external mode)
	ArgoCDToken string `json:"argocdToken,omitempty"`
}

type ClusterConfigStatus struct {
	// Healthy indicates if the cluster connection is healthy
	Healthy bool `json:"healthy"`

	// LastChecked is the timestamp of the last health check
	LastChecked metav1.Time `json:"lastChecked,omitempty"`

	// Message contains additional status information
	Message string `json:"message,omitempty"`
}

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

	Spec   DriftMonitorSpec   `json:"spec,omitempty"`
	Status DriftMonitorStatus `json:"status,omitempty"`
}

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

type DriftMonitorSpec struct {
	// TrackerRef references the associated PullRequestTracker
	TrackerRef corev1.ObjectReference `json:"trackerRef"`

	// Cluster is the target cluster name to monitor
	Cluster string `json:"cluster"`
}

type DriftMonitorStatus struct {
	// Synced indicates if the deployment is synced with the merged PR
	Synced bool `json:"synced"`

	// LastCheck is the timestamp of the last drift check
	LastCheck metav1.Time `json:"lastCheck,omitempty"`

	// Message contains additional status information
	Message string `json:"message,omitempty"`

	// ObservedGeneration reflects the generation most recently observed by the controller
	// +optional
	ObservedGeneration int64 `json:"observedGeneration,omitempty"`

	// DeployedSHA is the commit SHA currently deployed in the cluster
	// +optional
	DeployedSHA string `json:"deployedSHA,omitempty"`

	// ExpectedSHA is the expected commit SHA from the merged PR
	// +optional
	ExpectedSHA string `json:"expectedSHA,omitempty"`

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

type ExternalTestSpec struct {
	// Name is a unique identifier for this test within the policy
	// +kubebuilder:validation:Required
	// +kubebuilder:validation:MinLength=1
	Name string `json:"name"`

	// Provider identifies the CI system (jenkins, github-actions, gitlab)
	// +kubebuilder:validation:Required
	// +kubebuilder:validation:Enum=jenkins;github-actions;gitlab
	Provider string `json:"provider"`

	// JobName is the test job/workflow/pipeline name in the CI system.
	// Format is provider-specific:
	//   - Jenkins: "folder/job-name"
	//   - GitHub Actions: "workflow.yml" or workflow ID
	//   - GitLab: project ID or URL-encoded path
	// +kubebuilder:validation:Required
	// +kubebuilder:validation:MinLength=1
	JobName string `json:"jobName"`

	// Parameters are passed to the test job as variables/inputs.
	// Supports variable substitution: ${pr.number}, ${pr.head.sha}, ${cd.version}, etc.
	// +optional
	Parameters map[string]string `json:"parameters,omitempty"`

	// Timeout is the maximum duration for this specific test to complete.
	// If not specified, uses the policy-level timeout.
	// +optional
	Timeout metav1.Duration `json:"timeout,omitempty"`

	// Required indicates if this test must pass for promotion to proceed.
	// If false, test failure is logged but doesn't block promotion (warning only).
	// +optional
	// +kubebuilder:default=true
	Required bool `json:"required"`
}

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

	Spec   PromotionPolicySpec   `json:"spec,omitempty"`
	Status PromotionPolicyStatus `json:"status,omitempty"`
}

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

type PromotionPolicySpec struct {
	// SourceEnvironment is the environment to promote from (e.g., "dev", "staging")
	// +kubebuilder:validation:Required
	// +kubebuilder:validation:MinLength=1
	SourceEnvironment string `json:"sourceEnvironment"`

	// TargetEnvironment is the environment to promote to (e.g., "staging", "prod")
	// +kubebuilder:validation:Required
	// +kubebuilder:validation:MinLength=1
	TargetEnvironment string `json:"targetEnvironment"`

	// ExternalTests defines tests that must pass before promotion can proceed.
	// Tests are executed in parallel. If any required test fails, promotion is blocked.
	// +optional
	ExternalTests []ExternalTestSpec `json:"externalTests,omitempty"`

	// AutoPromote controls whether promotion happens automatically when all tests pass.
	// If false, promotion requires manual approval (e.g., adding a promotion label).
	// +optional
	// +kubebuilder:default=true
	AutoPromote bool `json:"autoPromote"`

	// Timeout is the maximum duration to wait for all tests to complete.
	// If tests don't complete within this time, they are marked as timed out.
	// +optional
	// +kubebuilder:default="45m"
	Timeout metav1.Duration `json:"timeout,omitempty"`
}

type PromotionPolicyStatus struct {
	// Conditions track the policy's operational status
	// +optional
	// +listType=map
	// +listMapKey=type
	Conditions []metav1.Condition `json:"conditions,omitempty"`

	// LastApplied is the timestamp when this policy was last used for promotion
	// +optional
	LastApplied metav1.Time `json:"lastApplied,omitempty"`

	// TotalPromotions tracks how many times this policy has been successfully applied
	// +optional
	TotalPromotions int64 `json:"totalPromotions,omitempty"`

	// LastTestResults contains the results from the most recent test execution
	// +optional
	LastTestResults []TestResult `json:"lastTestResults,omitempty"`
}

type PromotionRecord struct {
	// FromEnvironment is the source environment
	FromEnvironment string `json:"fromEnvironment"`

	// ToEnvironment is the target environment
	ToEnvironment string `json:"toEnvironment"`

	// PromotedAt is the timestamp of the promotion
	PromotedAt metav1.Time `json:"promotedAt"`

	// PromotedBy indicates who/what triggered the promotion (cd-operator, manual, etc.)
	PromotedBy string `json:"promotedBy"`

	// TestResults contains the test outcomes that gated this promotion
	// +optional
	TestResults []TestRun `json:"testResults,omitempty"`

	// PolicyName is the name of the PromotionPolicy that governed this promotion
	// +optional
	PolicyName string `json:"policyName,omitempty"`
}

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

	Spec   PullRequestTrackerSpec   `json:"spec,omitempty"`
	Status PullRequestTrackerStatus `json:"status,omitempty"`
}

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

type PullRequestTrackerSpec struct {
	// RepoOwner is the GitHub repository owner
	RepoOwner string `json:"repoOwner"`

	// RepoName is the GitHub repository name
	RepoName string `json:"repoName"`

	// PRNumber is the pull request number
	PRNumber int `json:"prNumber"`
}

type PullRequestTrackerStatus struct {
	// State represents the current state of the PR (discovered|qualified|merged|failed)
	State string `json:"state,omitempty"`

	// LastUpdate is the timestamp of the last status update
	LastUpdate metav1.Time `json:"lastUpdate,omitempty"`

	// ObservedGeneration reflects the generation most recently observed by the controller
	// +optional
	ObservedGeneration int64 `json:"observedGeneration,omitempty"`

	// HeadSHA is the commit SHA at the head of the PR branch
	// +optional
	HeadSHA string `json:"headSHA,omitempty"`

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

	// LastProcessedAt is the timestamp when this PR was last processed by webhook or polling
	// Used for deduplication to prevent webhook/poll conflicts in hybrid mode
	// +optional
	LastProcessedAt metav1.Time `json:"lastProcessedAt,omitempty"`

	// LastProcessedBy indicates the source that last processed this PR (webhook|polling)
	// +optional
	LastProcessedBy string `json:"lastProcessedBy,omitempty"`

	// ExtractedMetadata contains metadata extracted during qualification
	// +optional
	ExtractedMetadata map[string]string `json:"extractedMetadata,omitempty"`

	// GeneratedLabels contains labels generated from extracted metadata
	// +optional
	GeneratedLabels map[string]string `json:"generatedLabels,omitempty"`

	// CurrentEnvironment tracks the environment where the PR is currently deployed
	// Used for promotion flow to determine source environment for test triggers
	// +optional
	CurrentEnvironment string `json:"currentEnvironment,omitempty"`

	// TestRuns tracks external test executions triggered for promotion gates
	// +optional
	TestRuns []TestRun `json:"testRuns,omitempty"`

	// PromotionHistory tracks all environment promotions for this PR
	// +optional
	PromotionHistory []PromotionRecord `json:"promotionHistory,omitempty"`
}

type TestResult struct {
	// Name of the test (matches ExternalTestSpec.Name)
	Name string `json:"name"`

	// Status of the test (success, failure, timeout, etc.)
	Status string `json:"status"`

	// StartedAt is when the test was triggered
	StartedAt metav1.Time `json:"startedAt"`

	// CompletedAt is when the test finished
	// +optional
	CompletedAt metav1.Time `json:"completedAt,omitempty"`

	// Message contains additional context (error message, summary, etc.)
	// +optional
	Message string `json:"message,omitempty"`

	// URL is the web link to view the test run
	// +optional
	URL string `json:"url,omitempty"`
}

type TestRun struct {
	// ID is the unique identifier for this test run in the CI system
	ID string `json:"id"`

	// Provider identifies the CI system (jenkins, github-actions, gitlab)
	Provider string `json:"provider"`

	// JobName is the test job/workflow/pipeline name that was triggered
	JobName string `json:"jobName"`

	// Status is the current test status (pending, running, success, failure, timeout)
	Status string `json:"status"`

	// URL is the web link to view the test run in the CI system
	// +optional
	URL string `json:"url,omitempty"`

	// TriggeredAt is when the test was triggered
	TriggeredAt metav1.Time `json:"triggeredAt"`

	// CompletedAt is when the test finished (if completed)
	// +optional
	CompletedAt metav1.Time `json:"completedAt,omitempty"`

	// Duration is the total test execution time
	// +optional
	Duration metav1.Duration `json:"duration,omitempty"`

	// Message contains additional context about the test run (errors, summary, etc.)
	// +optional
	Message string `json:"message,omitempty"`
}