scm

type AttestationPublicationIdentityReader interface {
	FindAttestationPublicationIdentity(ctx context.Context, headSHA, publicationNonce string) (CheckAttemptIdentity, bool, error)
}

type Capabilities struct {
	MergeableState  bool
	FailedCheckLogs bool
}

type Check struct {
	Name   string
	Bucket CheckBucket
	// State is the provider's own outcome string for the check (GitHub
	// conclusions such as FAILURE, TIMED_OUT, CANCELLED). Buckets collapse
	// several outcomes into one value, so callers that must tell an
	// infrastructure outcome from a real job failure read this. Empty when the
	// provider reported no state.
	State       string
	CompletedAt time.Time // zero when unknown; used to detect CI re-runs between polls
	// Link is the provider's details URL for this check. It identifies the job
	// behind the check, so a rerun can target that job instead of the whole PR.
	// Empty when the provider reported no link.
	Link string
}

type CheckAttemptIdentity struct {
	RunID            int64
	RunNumber        int64
	RunAttempt       int
	Event            string
	HeadSHA          string
	PublicationNonce string
}

type CheckAttemptIdentityReader interface {
	GetCheckAttemptIdentity(ctx context.Context, check Check) (CheckAttemptIdentity, error)
}

type CheckBucket string

type CheckRerunner interface {
	// RerunCheck asks the provider to run check again for the same commit. It
	// returns an error when the request could not be made, including when the
	// check names no job the provider can re-run.
	RerunCheck(ctx context.Context, pr *PR, check Check) error
}

type Host interface {
	Provider() Provider
	Capabilities() Capabilities

	// Available returns nil when the host is ready to use, or a descriptive
	// error explaining why it is not (missing CLI, unauthenticated, etc).
	Available(ctx context.Context) error

	// FindPR returns the open PR for the source branch, or nil if none exists.
	FindPR(ctx context.Context, branch, base string) (*PR, error)
	CreatePR(ctx context.Context, branch, base string, content PRContent) (*PR, error)
	UpdatePR(ctx context.Context, pr *PR, content PRContent) (*PR, error)

	GetPRState(ctx context.Context, pr *PR) (PRState, error)
	GetChecks(ctx context.Context, pr *PR) ([]Check, error)

	// GetMergeableState is optional; implementations without Capabilities().MergeableState
	// must return ErrUnsupported. Callers should consult Capabilities first.
	GetMergeableState(ctx context.Context, pr *PR) (MergeableState, error)

	// FetchFailedCheckLogs is optional; returns "" when no logs can be retrieved
	// and ErrUnsupported when the provider has no log-fetching support at all.
	FetchFailedCheckLogs(ctx context.Context, pr *PR, branch, headSHA string, failingNames []string) (string, error)
}

type MergeableState string

type PR struct {
	Number string
	URL    string
}

type PRContent struct {
	Title string
	Body  string
}

type PRState string

type Provider string