discover

type AnalyzeOptions struct {
	Upstream string // package name the candidates depend on
	Workdir  string // clones go under here; temp dir if empty
	Limit    int    // final number to keep after re-ranking
	Keep     bool   // leave clones for a follow-up downstream test
}

type Candidate struct {
	Name              string
	Repo              string
	Stars             int
	DependentPackages int
	DependentRepos    int
	Downloads         int64
	PushedAt          time.Time
	Language          string

	// Phase two (Analyze)
	TestFiles   int  // files under a test dir or matching a test-name pattern
	ImportFiles int  // source files whose content mentions the upstream package name
	Analyzed    bool // distinguishes "not analyzed" from "analyzed, zero"
	New         bool // appended by reconcile, not in the existing file

	// Not yet implemented; placeholder so Comment() shape is stable.
	TransitiveReach int // modules in go.sum that also depend on upstream
	CIGreen         bool
	// contains filtered or unexported fields
}

type Client struct {
	BaseURL    string
	HTTPClient *http.Client
	UserAgent  string
	MaxRetries int
	Backoff    time.Duration // initial backoff; doubles per retry
}

type Options struct {
	Ecosystem string // go, npm, rubygems, ...
	Package   string // module path or package name
	Limit     int    // final number of dependents to keep
	Pool      int    // candidates to fetch before filtering; defaults to Limit*poolMultiplier
	MaxAge    time.Duration
	Client    *Client
	Stderr    io.Writer
}

type Package struct {
	Name                   string       `json:"name"`
	Ecosystem              string       `json:"ecosystem"`
	RepositoryURL          string       `json:"repository_url"`
	DependentPackagesCount int          `json:"dependent_packages_count"`
	DependentReposCount    int          `json:"dependent_repos_count"`
	Downloads              int64        `json:"downloads"`
	LatestRelease          string       `json:"latest_release_number"`
	Status                 string       `json:"status"`
	RepoMetadata           RepoMetadata `json:"repo_metadata"`
}

type RepoMetadata struct {
	FullName        string    `json:"full_name"`
	HTMLURL         string    `json:"html_url"`
	Fork            bool      `json:"fork"`
	Archived        bool      `json:"archived"`
	StargazersCount int       `json:"stargazers_count"`
	PushedAt        time.Time `json:"pushed_at"`
	Language        string    `json:"language"`
	SourceName      string    `json:"source_name"`
}