vcs

type CommitTagPushOptions struct {
	ChangelogPath string
	ModuleName    string
	Version       string // bare semver
	Actor         string
	Token         string // pushed via basic auth
}

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

type Repo interface {
	// AllChangelogPaths returns every CHANGELOG.md file in HEAD's tree.
	AllChangelogPaths(ctx context.Context) ([]string, error)

	// ReachableTags returns all tags whose commits are reachable from the
	// configured release branch.
	ReachableTags(ctx context.Context) ([]TagInfo, error)

	// IsChangelogModifiedSinceTag reports whether the file at changelogPath
	// has been modified between the commit pointed at by tagName and HEAD.
	// When tagName is empty (no prior tag) the function returns true.
	IsChangelogModifiedSinceTag(ctx context.Context, changelogPath, tagName string) (bool, error)

	// CommitTagAndPush stages the changelog file, commits it with a
	// "[skip ci]" message, pushes the commit, creates an annotated tag for
	// the release name, and pushes the tag. It is intentionally a single
	// operation so the implementation can attempt cleanup on failure.
	CommitTagAndPush(ctx context.Context, opts CommitTagPushOptions) error
}

type TagInfo struct {
	Name       string        // e.g. "v1.2.3" or "module/v1.2.3"
	ModuleName string        // empty for root tags
	Date       int64         // unix seconds (commit or tagger date)
	Hash       plumbing.Hash // the commit the tag points at
}