github

type AccountType string

type AuthStatus struct {
	GHInstalled bool
	LoggedIn    bool
	TokenValid  bool // false when the token is expired/revoked (401 Bad credentials)

	Account     string
	AccountType AccountType

	// GraphQL rate-limit headroom. Remaining/Limit are -1 when unknown.
	GraphQLRemaining int
	GraphQLLimit     int
	GraphQLResetAt   time.Time

	// Err holds an unexpected error encountered while probing (not auth state).
	Err error
}

type BranchFetcher func(ctx context.Context, repoDir string, branches []string) (*BranchPRs, error)

type BranchPRs struct {
	// PRs maps branch name to its PR. A branch that was asked about and is
	// absent here definitively has no PR — the query succeeded.
	PRs map[string]*PRInfo
	// RateRemaining is GraphQL budget left after the query, -1 if unknown.
	RateRemaining int
	RateResetAt   time.Time
}

type CheckState string

type CloneDestination struct {
	Path string
	// Reuse is true when Path already holds a checkout of the same repo, so
	// there's nothing to clone — the caller can adopt it as-is.
	Reuse bool
	// Renamed is true when the natural directory name was taken by something
	// else and a non-colliding one was picked instead.
	Renamed bool
}

type CloneError struct {
	Stderr string
	Err    error
}

type Cloner struct {
	// Root is where clones land. Empty means ~/Projects.
	Root string
	// RemoteURL returns dir's origin remote. Nil means ask git.
	RemoteURL func(dir string) (string, error)
	// Run performs the clone itself. Nil means run `git clone`.
	Run func(ctx context.Context, cloneURL, dest string) error
	// Command builds the git invocations. Nil means run them locally.
	Command CommandBuilder
}

type CommandBuilder func(ctx context.Context, workDir, name string, args ...string) *exec.Cmd

type Finding struct {
	Severity Severity
	Message  string
	Detail   string // optional remediation hint
}

type LatestRelease struct {
	Version string // e.g. "v0.2.0"
	URL     string // release page URL
}

type PRInfo struct {
	Number     int        `json:"number"`
	URL        string     `json:"url"`
	State      PRState    `json:"state"`
	IsDraft    bool       `json:"isDraft"`
	Title      string     `json:"title"`
	CheckState CheckState `json:"checkState"`
	Mergeable  string     `json:"mergeable"` // "MERGEABLE", "CONFLICTING", "UNKNOWN"
	// MergeStateStatus is GitHub's fuller merge verdict: CLEAN, BLOCKED, BEHIND,
	// DIRTY, UNSTABLE, HAS_HOOKS, DRAFT or UNKNOWN.
	MergeStateStatus string `json:"mergeStateStatus,omitempty"`
	// ReviewDecision is APPROVED, CHANGES_REQUESTED, REVIEW_REQUIRED or "".
	ReviewDecision string    `json:"reviewDecision,omitempty"`
	UpdatedAt      time.Time `json:"updatedAt"`
	Additions      int       `json:"additions"` // Lines added
	Deletions      int       `json:"deletions"` // Lines deleted
}

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

type PRResult struct {
	Target PRTarget
	Info   *PRInfo
}

type PRState string

type PRTarget struct {
	TaskID  int64
	RepoDir string
	Branch  string
	// Known is the last stored state, nil if none. It drives the cadence.
	Known *PRInfo
}

type RateLimitError struct {
	ResetAt time.Time
	Detail  string
}

type RepoRef struct {
	Host  string // e.g. "github.com"
	Owner string
	Name  string
	// SSH records that the user pasted an ssh URL. We clone back over ssh so
	// their key-based auth keeps working for private repos.
	SSH bool
}

type Severity string