github

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

type CacheEntry struct {
	Data      interface{} `json:"data"`
	CachedAt  time.Time   `json:"cached_at"`
	ExpiresAt time.Time   `json:"expires_at"`
	Type      string      `json:"type"`
}

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

type Client interface {
	// GetStarredRepos fetches all starred repositories for the authenticated user.
	// It handles pagination automatically and respects rate limits.
	// The username parameter is currently unused but reserved for future use.
	GetStarredRepos(ctx context.Context, username string) ([]Repository, error)

	// GetRepositoryContent fetches specific file contents from a repository.
	// It accepts a list of file paths and returns the content for files that exist.
	// Missing files are silently skipped rather than causing an error.
	GetRepositoryContent(ctx context.Context, repo Repository, paths []string) ([]Content, error)

	// GetRepositoryMetadata fetches additional metadata for a repository including
	// commit count, contributors, and release information.
	// Partial failures are handled gracefully - if some metadata cannot be fetched,
	// the available data is still returned.
	GetRepositoryMetadata(ctx context.Context, repo Repository) (*Metadata, error)

	// GetContributors fetches the top N contributors for a repository.
	// Returns contributor login names and their contribution counts.
	GetContributors(ctx context.Context, fullName string, topN int) ([]Contributor, error)

	// GetTopics fetches the topics/tags associated with a repository.
	GetTopics(ctx context.Context, fullName string) ([]string, error)

	// GetLanguages fetches the programming languages used in a repository.
	// Returns a map of language names to byte counts.
	GetLanguages(ctx context.Context, fullName string) (map[string]int64, error)

	// GetCommitActivity fetches commit activity statistics for a repository.
	// Returns weekly commit counts for the last 52 weeks.
	GetCommitActivity(ctx context.Context, fullName string) (*CommitActivity, error)

	// GetPullCounts fetches pull request counts (open and total) for a repository.
	GetPullCounts(ctx context.Context, fullName string) (int, int, error)

	// GetIssueCounts fetches issue counts (open and total) for a repository.
	GetIssueCounts(ctx context.Context, fullName string) (int, int, error)

	// GetHomepageText fetches text content from an external homepage URL.
	// This is optional and used for additional context extraction.
	GetHomepageText(ctx context.Context, url string) (string, error)
}

type CommitActivity struct {
	Weeks []WeeklyCommits `json:"weeks"`
	Total int             `json:"total"`
}

type Content struct {
	Path     string `json:"path"`
	Type     string `json:"type"`
	Content  string `json:"content"`
	Size     int    `json:"size"`
	Encoding string `json:"encoding"`
	SHA      string `json:"sha"`
}

type Contributor struct {
	Login         string `json:"login"`
	Contributions int    `json:"contributions"`
	Type          string `json:"type"`
	AvatarURL     string `json:"avatar_url"`
}

type License struct {
	Key    string `json:"key"`
	Name   string `json:"name"`
	SPDXID string `json:"spdx_id"`
	URL    string `json:"url"`
}

type Metadata struct {
	CommitCount    int       `json:"commit_count"`
	Contributors   []string  `json:"contributors"`
	LastCommitDate time.Time `json:"last_commit_date"`
	ReleaseCount   int       `json:"release_count"`
	LatestRelease  *Release  `json:"latest_release"`
}

type RESTClientInterface interface {
	Get(path string, resp interface{}) error
}

type Release struct {
	TagName     string    `json:"tag_name"`
	Name        string    `json:"name"`
	PublishedAt time.Time `json:"published_at"`
	Prerelease  bool      `json:"prerelease"`
	Draft       bool      `json:"draft"`
}

type Repository struct {
	FullName        string    `json:"full_name"`
	Description     string    `json:"description"`
	Homepage        string    `json:"homepage"`
	Language        string    `json:"language"`
	StargazersCount int       `json:"stargazers_count"`
	ForksCount      int       `json:"forks_count"`
	UpdatedAt       time.Time `json:"updated_at"`
	CreatedAt       time.Time `json:"created_at"`
	Topics          []string  `json:"topics"`
	License         *License  `json:"license"`
	Size            int       `json:"size"`
	DefaultBranch   string    `json:"default_branch"`
	OpenIssuesCount int       `json:"open_issues_count"`
	HasWiki         bool      `json:"has_wiki"`
	HasPages        bool      `json:"has_pages"`
	Archived        bool      `json:"archived"`
	Disabled        bool      `json:"disabled"`
	Private         bool      `json:"private"`
	Fork            bool      `json:"fork"`
}

type RepositoryMetrics struct {
	Contributors   []Contributor
	Topics         []string
	Languages      map[string]int64
	CommitActivity *CommitActivity
	OpenPRs        int
	TotalPRs       int
	OpenIssues     int
	TotalIssues    int
}

type Result struct {
	ID    string
	Data  interface{}
	Error error
}

type SearchResult struct {
	TotalCount        int                      `json:"total_count"`
	IncompleteResults bool                     `json:"incomplete_results"`
	Items             []map[string]interface{} `json:"items"`
}

type Task struct {
	ID   string
	Func func(ctx context.Context) (interface{}, error)
}

type WeeklyCommits struct {
	Week    int64 `json:"w"` // Unix timestamp for the start of the week
	Commits int   `json:"c"` // Number of commits
	Adds    int   `json:"a"` // Lines added
	Deletes int   `json:"d"` // Lines deleted
}

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