releasecheck

type CIJob struct {
	Name       string
	Status     string
	Conclusion string
}

type CIRun struct {
	Status     string // queued, in_progress, completed, ...
	Conclusion string // success, failure, ... once completed
	Jobs       []CIJob
}

type Live struct {
	Dir    string       // the git checkout, with main fetched as origin/main
	Repo   string       // owner/name on GitHub
	Module string       // the module path, e.g. github.com/angvp/tango
	Token  string       // a GitHub token that can read Actions runs
	Client *http.Client // nil means http.DefaultClient
	API    string       // "" means https://api.github.com
	Proxy  string       // "" means https://proxy.golang.org
}

type Release struct {
	Tag       string // the pushed tag, e.g. v0.1.1
	Commit    string // the full SHA the tag points to
	Changelog []byte // CHANGELOG.md at that commit
	// Gorelease is gorelease's report comparing the tagged commit with the
	// previous release, or "" if it wasn't run.
	Gorelease string
}

type Sources interface {
	// OnMain reports whether commit is reachable from main.
	OnMain(ctx context.Context, commit string) (bool, error)
	// CIRuns returns every CI workflow run for exactly commit.
	CIRuns(ctx context.Context, commit string) ([]CIRun, error)
	// PublishedCommit returns the commit the Go module proxy already serves
	// for tag, or "" if it doesn't know the tag.
	PublishedCommit(ctx context.Context, tag string) (string, error)
}