vcs

type Refs interface {
	// CompareFunc compares two tags or commits, falling back to compareTag when
	// the references cannot be prepared or resolved.
	CompareFunc(a, b string, compareTag func(a, b string) int) int
}

type Repo interface {
	// Tags returns all tags from the repository.
	Tags(ctx context.Context) ([]Tag, error)
	// Latest returns the latest commit hash on the default branch.
	Latest(ctx context.Context) (string, error)
	// Refs returns the repository references used for version comparison.
	Refs() Refs
	// At returns a filesystem view of the repository at the specified ref.
	// The returned fs.FS also implements fs.ReadFileFS and fs.ReadDirFS.
	At(ref, localDir string) fs.FS
	// Sync downloads the specified path to localDir.
	Sync(ctx context.Context, ref, path, localDir string) error
}

type Tag struct {
	Name string
	Hash string
}