provider

type CommitBoundaryNotFoundError struct {
	Ref    string
	Branch string
}

type CommitEntry struct {
	Hash    string
	Message string
}

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

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

type MergeMethod = string

type MergeReleasePROptions struct {
	Force  bool
	Method MergeMethod
}

type Provider interface {
	// GetLatestVersionRef returns the preferred release/tag baseline candidate.
	GetLatestVersionRef(ctx context.Context) (string, error)
	// ListTags returns repository tags.
	ListTags(ctx context.Context) ([]string, error)
	// GetReleaseByTag returns the release for the exact tag.
	GetReleaseByTag(ctx context.Context, tag string) (*Release, error)
	// TagExists reports whether the exact tag already exists.
	TagExists(ctx context.Context, tag string) (bool, error)
	// GetCommitsSince returns commits on the given branch since the given ref (tag or SHA).
	GetCommitsSince(ctx context.Context, ref, branch string) ([]CommitEntry, error)
	// CreateReleasePR creates a release PR/MR.
	CreateReleasePR(ctx context.Context, opts ReleasePROptions) (*PullRequest, error)
	// UpdateReleasePR updates an existing release PR/MR.
	UpdateReleasePR(ctx context.Context, number int, opts ReleasePROptions) error
	// FindOpenPendingReleasePRs finds open release PRs/MRs labeled pending for the base branch.
	FindOpenPendingReleasePRs(ctx context.Context, baseBranch string) ([]*PullRequest, error)
	// FindReleasePR finds an existing open release PR/MR.
	FindReleasePR(ctx context.Context, branch string) (*PullRequest, error)
	// FindMergedReleasePR finds the latest merged release PR/MR waiting for tagging.
	FindMergedReleasePR(ctx context.Context, baseBranch string) (*PullRequest, error)
	// CreateRelease creates a release with a tag.
	CreateRelease(ctx context.Context, opts ReleaseOptions) (*Release, error)
	// MergeReleasePR merges an existing release PR/MR.
	MergeReleasePR(ctx context.Context, number int, opts MergeReleasePROptions) error
	// MarkReleasePRPending marks a release PR/MR as waiting for tagging.
	MarkReleasePRPending(ctx context.Context, number int) error
	// MarkReleasePRTagged marks a release PR/MR as tagged.
	MarkReleasePRTagged(ctx context.Context, number int) error
	// CreateBranch creates a new branch from the base branch.
	CreateBranch(ctx context.Context, name, base string) error
	// GetFile reads a file content from a branch.
	GetFile(ctx context.Context, branch, path string) (string, error)
	// UpdateFile creates or updates a file on a branch.
	UpdateFile(ctx context.Context, branch, path, content, message string) error
	// UpdateFiles force-updates a branch from base with one commit containing all file changes.
	UpdateFiles(ctx context.Context, branch, base string, files map[string]string, message string) error
	// RepoURL returns the HTTPS base URL for the repository.
	RepoURL() string
	// PathPrefix returns the path prefix for commit/compare URLs (empty for GitHub, "/-" for GitLab).
	PathPrefix() string
}

type PullRequest struct {
	Number         int
	Title          string
	Body           string
	URL            string
	Branch         string
	MergeCommitSHA string
}

type Release struct {
	TagName string
	Name    string
	Body    string
	URL     string
}

type ReleaseOptions struct {
	TagName string
	Ref     string
	Name    string
	Body    string
}

type ReleasePROptions struct {
	Title         string
	Body          string
	BaseBranch    string
	ReleaseBranch string
	Files         map[string]string
}

type RepoInfo struct {
	Owner string
	Name  string
}

type RepositoryDescriptor struct {
	Provider string
	Host     string
	Owner    string
	Repo     string
	Project  string
	Remote   string
}