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
	// DryRun rehearses a release that cannot be real yet: the commit need
	// not be on main, and the module proxy is never asked about the tag
	// (asking would make it cache "unknown revision" and delay the real
	// release). Every other check runs. Skipped says what was not checked.
	DryRun bool
}

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)
	// CorpusRegistered reports, as of commit, whether the migration-compat
	// fixture directory dir (such as v0_3_0) exists, and whether it is
	// listed in the Generators the Generated-file contract tests read.
	CorpusRegistered(ctx context.Context, commit, dir string) (exists, registered bool, err error)
}