run

type AutoMerger interface {
	EnableAutoMerge(ctx context.Context, pullRequestID string) error
}

type Branches interface {
	// Dir is the directory holding the package, which the paths of what it holds are
	// under.
	Dir(pkgName string) (string, bool)
	HeadBranch(pkgName string) (string, bool)
	VersionHeadBranch(pkgName, version string) (string, bool)
	IsVersionHeadBranch(pkgName, branch string) bool
	WaitingHeadBranch(pkgName string) (string, bool)
}

type Candidate struct {
	Name    string
	Package *state.Package
}

type Contents interface {
	Definitions
	Branches
	Versions(ctx context.Context, logger *slog.Logger, pkgName string) (map[string]struct{}, error)
	// VersionsOnRef reads a branch other than the default one, which is where a version
	// waiting for a definition lives.
	VersionsOnRef(ctx context.Context, logger *slog.Logger, ref, pkgName string) (map[string]struct{}, error)
	Version(ctx context.Context, pkgName, version string) (*aquag2.Registry, error)
	BranchSHA(ctx context.Context, branch string) (string, error)
	PackageBase(ctx context.Context, pkgName string) (string, error)
	// File is the bytes a ref holds at a path, or "" when it holds nothing there.
	// A regeneration compares what it would commit against them.
	File(ctx context.Context, ref, path string) (string, error)
	CommitPackage(ctx context.Context, logger *slog.Logger, pkgName, branch, parent, message string, files []*g2.File) error
	// CommitVersions is the commit of a version's pull request, or of the versions waiting
	// for a definition, which leaves the list of versions alone.
	CommitVersions(ctx context.Context, pkgName, branch, parent, message string, files []*g2.File) error
}

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

type Definitions interface {
	Config(ctx context.Context, pkgName string) (*aquag2.Config, error)
	ConfigOnRef(ctx context.Context, ref, pkgName string) (*aquag2.Config, error)
	RegistryConfig(ctx context.Context, ref string) (*g2.RegistryConfig, error)
}

type GraphQL interface {
	EnableAutoMerge(ctx context.Context, pullRequestID string) error
	GetStars(ctx context.Context, repos []github.Repo) (map[string]int, map[string]string, error)
	FillForbiddenStars(ctx context.Context, stars map[string]int, reasons map[string]string)
	// Versions and Tags are the sweep: they say what each package's newest
	// versions are, fifty packages to a request.
	Versions(ctx context.Context, repos []github.Repo) (*github.Sweep, error)
	Tags(ctx context.Context, repos []github.Repo) (*github.Sweep, error)
}

type Input struct {
	// Packages are the packages to work through instead of the order. Empty is the
	// order itself, which is what a scheduled run does.
	//
	// Nothing else changes: a named package is taken over, generated and put to a pull
	// request the way the order would have, whenever its turn came.
	Packages []string
	// Limit bounds how many package versions are generated in one run.
	Limit int
	// OutputDir is where registry.json files are written. When it is empty the
	// result goes into a pull request instead.
	OutputDir string
	// SkipPR writes the files out without creating a branch, a commit, or a pull
	// request.
	SkipPR bool
	// Verify extracts every asset to check files[].src against the archive.
	Verify bool
	// State is the state to read the order from and record progress into.
	State *state.State
	// PkgInfos are aqua-registry's definitions, keyed by package name.
	PkgInfos map[string]*aquaregistry.PackageInfo
	// RegistryRef is the aqua-registry ref the definitions were read from. A
	// package's aqua gr configuration is read from the same ref, so that the two
	// halves of a definition come from one state of that repository.
	RegistryRef string
	// BaseBranch is aqua-registry-g2's default branch, where the registry's own
	// configuration is.
	BaseBranch string
}

type Issues interface {
	ListByRepo(ctx context.Context, owner, repo string, opts *gogithub.IssueListByRepoOptions) ([]*gogithub.Issue, *gogithub.Response, error)
	Create(ctx context.Context, owner, repo string, issue gogithub.CreateIssueRequest) (*gogithub.Issue, *gogithub.Response, error)
	CreateComment(ctx context.Context, owner, repo string, number int, comment gogithub.IssueCommentRequest) (*gogithub.IssueComment, *gogithub.Response, error)
}

type PullRequests interface {
	PackagesInFlight(ctx context.Context) (map[string]struct{}, error)
	// WaitingPullRequest is the package's open pull request of versions waiting for a
	// definition, which is what a regeneration of something unmerged works on.
	WaitingPullRequest(ctx context.Context, pkgName string) (*gogithub.PullRequest, error)
	CreatePullRequest(ctx context.Context, logger *slog.Logger, pkgName, title, body string) (*gogithub.PullRequest, error)
	// CreatePullRequestFrom opens one from a branch of its own, which is what the versions
	// waiting for a definition are on.
	CreatePullRequestFrom(ctx context.Context, logger *slog.Logger, head, base, title, body string) (*gogithub.PullRequest, error)
	// Label is how the pull requests waiting for a definition are found together.
	Label(ctx context.Context, logger *slog.Logger, number int, name string)
}

type RegenerateInput struct {
	PkgName string
	// Versions are the versions to generate again. Empty is every version the
	// registry holds for the package.
	Versions []string
	// Verify extracts every asset to check files[].src against the archive.
	Verify bool
	// Base is aqua-registry's definition of the package, which supplies what a
	// release can't express.
	Base *aquaregistry.PackageInfo
	// RegistryRef is the aqua-registry ref Base was read from.
	RegistryRef string
	// DryRun says which versions would change and commits nothing.
	DryRun bool
	// Pending regenerates what is on the package's open pull request of versions waiting
	// for a definition, from the definition that pull request carries, rather than what
	// the registry holds.
	Pending bool
}

type Registry interface {
	Contents
	PullRequests
}

type Renamer interface {
	Rename(ctx context.Context, logger *slog.Logger, from, to string) error
}