github

Documentation

Overview

Package github interacts with the GitHub API to search and fetch repositories.

Index

• Constants
• func GetAPIBaseURL(repo config.Repo) string
• func GetTokenForRepo(repo config.Repo) string
• func ParseBrowserURL(url string) (repoURL, branch, subDir, skillName string, ok bool)
• func ParseRepoURL(url string) (owner, repo string, err error)
• type Client
  • func NewClient() *Client
  • func (c *Client) GetRepoInfo(owner, repo string) (*RepoInfo, error)
• type Content
• type RepoInfo
• type Repository
  • func FetchRepoDetails(owner, repo string) (*Repository, error)
  • func SearchDir(owner, repo, path string) ([]Repository, error)
  • func SearchTopic(topic, keyword string) ([]Repository, error)
• type SearchResult

Constants

const (
	// SkillTopic is the default topic to search for agent skills
	SkillTopic = "agent-skill"
	// APIURL is the GitHub API endpoint for searching repositories
	APIURL = "https://api.github.com/search/repositories"
)

Functions

func GetAPIBaseURL

func GetAPIBaseURL(repo config.Repo) string

GetAPIBaseURL returns the API base URL for a repo. Defaults to "https://api.github.com" if not specified.

func GetTokenForRepo

func GetTokenForRepo(repo config.Repo) string

GetTokenForRepo returns the best available token for a given repo config. Priority: per-repo token → environment variable → empty string.

func ParseBrowserURL

func ParseBrowserURL(url string) (repoURL, branch, subDir, skillName string, ok bool)

ParseBrowserURL parses a GitHub browser URL and extracts components Input: https://github.com/owner/repo/tree/branch/path/to/skill Returns: repoURL, branch, subDir, skillName, ok

func ParseRepoURL

func ParseRepoURL(url string) (owner, repo string, err error)

ParseRepoURL parses a GitHub repository URL to extract owner and repo name Supports formats: - owner/repo - https://github.com/owner/repo - https://github.com/owner/repo.git - git@github.com:owner/repo.git

Types

type Client

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

Client provides GitHub API access

func NewClient

func NewClient() *Client

NewClient creates a new GitHub API client

func (*Client) GetRepoInfo

func (c *Client) GetRepoInfo(owner, repo string) (*RepoInfo, error)

GetRepoInfo fetches enriched repository metadata for trust scoring

type Content

type Content struct {
	Name    string `json:"name"`
	Type    string `json:"type"`
	HTMLURL string `json:"html_url"`
}

Content represents a file or directory in a GitHub repository

type RepoInfo

type RepoInfo struct {
	Stars      int
	Forks      int
	IsOrg      bool
	HasLicense bool
	OwnerAge   int // years since account creation
}

RepoInfo holds enriched repository metadata for scoring

type Repository

type Repository struct {
	Name            string    `json:"name"`
	FullName        string    `json:"full_name"`
	Description     string    `json:"description"`
	HTMLURL         string    `json:"html_url"`
	StargazersCount int       `json:"stargazers_count"`
	CloneURL        string    `json:"clone_url"`
	UpdatedAt       time.Time `json:"updated_at"`
	Source          string    `json:"-"` // Source name (e.g., "community", "anthropics")
	Owner           struct {
		Login string `json:"login"`
	} `json:"owner"`
}

Repository represents a GitHub repository structure

func FetchRepoDetails

func FetchRepoDetails(owner, repo string) (*Repository, error)

FetchRepoDetails fetches details of a GitHub repository including star count

func SearchDir

func SearchDir(owner, repo, path string) ([]Repository, error)

SearchDir searches a specific directory in a GitHub repository for subdirectories (skills)

func SearchTopic

func SearchTopic(topic, keyword string) ([]Repository, error)

SearchTopic searches GitHub for repositories with a specific topic and keyword

type SearchResult

type SearchResult struct {
	TotalCount int          `json:"total_count"`
	Items      []Repository `json:"items"`
}

SearchResult represents the response from GitHub search API