forge

type Fix struct {
	PR       int
	MergeSHA string // the commit the merge made on the base branch
}

type Fixes interface {
	FixFor(ctx context.Context, repo string, number int) (Fix, error)
}

type Forge interface {
	Search(ctx context.Context, query string) ([]Hit, error)
	PullRequest(ctx context.Context, repo string, number int) (*facts.PR, error)
	// FindPR returns the open pull request whose head is branch, or 0.
	FindPR(ctx context.Context, repo, branch string) (int, error)
	OpenPR(ctx context.Context, repo string, pr NewPR) (int, error)
	// Comment posts body on a pull request unless a comment containing marker exists: side
	// effects are idempotent per step (ADR-005).
	Comment(ctx context.Context, repo string, number int, marker, body string) error
	DefaultBranch(ctx context.Context, repo string) (string, error)
	// Head is the commit a branch points at, so policy is read at a resolved commit (ADR-006).
	Head(ctx context.Context, repo, branch string) (string, error)
	// File reads a file at ref; ErrNotFound if it does not exist.
	File(ctx context.Context, repo, ref, path string) ([]byte, error)
}

type GitHub struct {

	// Log receives the warning that a repository's required checks could not be read; the default
	// logger when nil.
	Log *slog.Logger
	// contains filtered or unexported fields
}

type Hit struct {
	Repo   string
	Number int
	IsPR   bool
}

type Issues interface {
	Ticket(ctx context.Context, repo string, number int) (facts.Ticket, Text, error)
	Comment(ctx context.Context, repo string, number int, marker, body string) error
	SetLabels(ctx context.Context, repo string, number int, add, remove []string) error
}

type NewPR struct {
	Head, Base, Title, Body string
	Draft                   bool
}

type Required struct {
	Checks []RequiredCheck
	// Known is false when neither source could be read. Checks is then empty, which says nothing
	// about what the branch requires.
	Known bool
	// Detail says how it was read, or why it could not be.
	Detail string
}

type RequiredCheck struct {
	Context string
	AppID   int64
}

type RequiredReader interface {
	RequiredChecks(ctx context.Context, repo, branch string) Required
}

type Text = tracker.Text

type WorkflowReader interface {
	// Workflows counts the workflow files at ref; a repository with none has zero, not an error.
	Workflows(ctx context.Context, repo, ref string) (int, error)
}