forge

type AppAuthConfig struct {
	// AppID is the numeric GitHub App ID (e.g. 3613880).
	AppID int64
	// InstallationID is the numeric installation ID for the target account.
	InstallationID int64
	// PrivateKeyPEM is the PEM-encoded RSA private key generated in App settings.
	PrivateKeyPEM []byte
}

type AppConfig struct {
	AppID          int64
	InstallationID int64
	// KeyPEM is the PEM-encoded RSA private key. Empty means App auth disabled.
	KeyPEM []byte
}

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

type CodeResult struct {
	Name    string
	Path    string
	URL     string
	Repo    string
	Content string // joined text-match fragments
}

type CodeSearchResult struct {
	Results    []CodeResult
	Total      int
	Query      string
	Incomplete bool
}

type Forge interface {
	// Kind returns the ForgeKind for this implementation.
	Kind() ForgeKind

	// FetchRepoMeta returns metadata for the repository identified by slug
	// ("owner/repo" or a full URL).
	FetchRepoMeta(ctx context.Context, slug string) (*RepoMeta, error)

	// FetchREADME returns the raw README content for the repository.
	// Implementations should return an empty string (not an error) when no
	// README exists.
	FetchREADME(ctx context.Context, slug string) (string, error)

	// SearchCode searches for code matching query, optionally restricted to
	// the given repos ("owner/repo" slugs).
	SearchCode(ctx context.Context, query string, repos []string, opts ...SearchCodeOptions) (CodeSearchResult, error)

	// SearchIssues searches issues and pull requests matching query.
	SearchIssues(ctx context.Context, query string) ([]IssueItem, error)

	// SearchRepos searches for repositories matching query.
	// sort may be forge-specific (e.g. "stars", "forks", "updated") or empty
	// for relevance ordering.
	SearchRepos(ctx context.Context, query, sort string) ([]RepoSearchResult, error)
}

type ForgeKind int

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

type GitHubForgeOption func(*GitHubForge)

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

type InlineComment struct {
	Path string // repo-relative
	Line int    // 1-based, on the diff's new side
	Body string
}

type IssueItem struct {
	Number    int
	Title     string
	URL       string
	State     string
	Author    string
	Labels    []string
	Body      string
	Comments  int
	CreatedAt string
	MergedAt  string
	Repo      string
}

type Poster interface {
	PostReview(ctx context.Context, slug string, pr int, p ReviewPayload) (htmlURL string, err error)
	PostIssueComment(ctx context.Context, slug string, number int, body string) (htmlURL string, err error)
	PostCommitComment(ctx context.Context, slug, sha, body string) (htmlURL string, err error)
}

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

type RepoMeta struct {
	// FullName is the "owner/repo" slug.
	FullName string `json:"full_name"`

	// Description is the repository description.
	Description string `json:"description"`

	// DefaultBranch is the default branch name.
	DefaultBranch string `json:"default_branch"`

	// Language is the primary programming language.
	Language string `json:"language"`

	// Stars is the stargazer count.
	Stars int `json:"stargazers_count"`

	// Forks is the fork count.
	Forks int `json:"forks_count"`

	// CloneURL is the HTTPS clone URL.
	CloneURL string `json:"clone_url"`

	// Private indicates whether the repository is private.
	Private bool `json:"private"`

	// Size is the approximate disk size in kilobytes.
	Size int `json:"size"`
}

type RepoSearchResult struct {
	FullName    string
	Description string
	Stars       int
	Language    string
	Topics      []string
	LastPush    string
	Archived    bool
	HTMLURL     string
}

type RetryConfig struct {
	MaxRetries  int
	InitialWait time.Duration
	MaxWait     time.Duration
	Multiplier  float64
}

type ReviewPayload struct {
	Body     string          // summary markdown
	Event    string          // "COMMENT", "REQUEST_CHANGES", "APPROVE"
	Comments []InlineComment // inline findings
}

type SearchCodeOptions struct {
	ExcludeRepos   []string
	FileExtensions []string
	Language       string
	Sort           string
	Order          string
	MinStars       int
	MaxResults     int
	PerPage        int
	Page           int
	// MaxFragmentChars limits each text-match fragment. 0 means no limit.
	MaxFragmentChars int
	// MaxTotalChars limits the total joined content per result. 0 means no limit.
	MaxTotalChars int
}