drift

type GetOptions struct {
	// ProjectName filters by project name (exact match).
	ProjectName string
	// Path filters by project path (exact match).
	Path string
	// Workspace filters by Terraform workspace (exact match).
	Workspace string
	// Ref filters by git reference (exact match). Drift records are keyed
	// by ref, so callers that want to act on a specific branch/commit
	// should set this to avoid mixing data across refs.
	Ref string
	// BaseBranch filters by the branch context used for repo-config branch
	// filters and undiverged checks.
	BaseBranch string
	// MaxAge filters out drift results older than this duration.
	// If zero, no age filtering is applied.
	MaxAge time.Duration
	// Exact treats empty project/path/workspace/ref/base_branch fields as exact
	// values instead of wildcards. This is useful for deleting a specific drift
	// record whose identity legitimately contains empty fields.
	Exact bool
}

type InMemoryRemediationService struct {
	// contains filtered or unexported fields
}

type InMemoryStorage struct {
	// contains filtered or unexported fields
}

type Parser struct{}

type RemediationExecutor interface {
	// ExecutePlan runs a plan for the given project.
	ExecutePlan(repository, ref, vcsType, projectName, path, workspace string) (output string, driftSummary *models.DriftSummary, err error)

	// ExecuteApplyProjects plans and applies the given projects as one operation.
	ExecuteApplyProjects(repository, ref, vcsType string, projects []models.ProjectDrift) ([]models.ProjectRemediationResult, error)
}

type RemediationHistory struct {
	// ID is the unique identifier for this history entry.
	ID string `json:"id"`
	// Repository is the full repository name.
	Repository string `json:"repository"`
	// RemediationID links to the remediation result.
	RemediationID string `json:"remediation_id"`
	// Action is the remediation action performed.
	Action models.RemediationAction `json:"action"`
	// Status is the final status.
	Status models.RemediationStatus `json:"status"`
	// Timestamp is when the remediation occurred.
	Timestamp time.Time `json:"timestamp"`
	// ProjectCount is the number of projects remediated.
	ProjectCount int `json:"project_count"`
	// SuccessCount is the number of successful remediations.
	SuccessCount int `json:"success_count"`
}

type RemediationService interface {
	// Remediate executes drift remediation for the given projects.
	// It returns a result ID that can be used to track the remediation status.
	Remediate(req models.RemediationRequest, executor RemediationExecutor) (*models.RemediationResult, error)

	// GetResult retrieves a remediation result by ID.
	GetResult(id string) (*models.RemediationResult, error)

	// ListResults returns all remediation results for a repository.
	ListResults(repository string, limit int) ([]*models.RemediationResult, error)
}

type Storage interface {
	// Store saves a drift result for a project.
	Store(repository string, drift models.ProjectDrift) error

	// Get retrieves drift results for a repository.
	// Optional filters can limit results by project name, path, or workspace.
	Get(repository string, opts GetOptions) ([]models.ProjectDrift, error)

	// Delete removes drift results for a repository.
	// If projectName is empty, all drift results for the repository are removed.
	Delete(repository string, projectName string) error

	// DeleteMatching removes drift results for a repository that match the given
	// filters. At least one filter must be set; use Delete(repository, "") to
	// clear an entire repository.
	DeleteMatching(repository string, opts GetOptions) error

	// GetAll retrieves all stored drift results across all repositories.
	GetAll() (map[string][]models.ProjectDrift, error)
}