profile

type ActivityTimeline struct {
	Username string
	From     time.Time
	To       time.Time
	Months   []MonthlyActivity
}

type AggregateStats struct {
	Commits              int `json:"commits"`
	Issues               int `json:"issues"`
	PRs                  int `json:"prs"`
	Reviews              int `json:"reviews"`
	Releases             int `json:"releases"`
	Additions            int `json:"additions"`
	Deletions            int `json:"deletions"`
	NetAdditions         int `json:"netAdditions"`
	RepoCountContributed int `json:"repoCountContributed"`
	RepoCountCreated     int `json:"repoCountCreated"`
}

type CalendarDay struct {
	Date              time.Time
	Weekday           time.Weekday
	ContributionCount int
	Level             ContributionLevel // Intensity level for coloring (0-4)
}

type CalendarWeek struct {
	StartDate time.Time      // Sunday of this week
	Days      [7]CalendarDay // Sunday (0) through Saturday (6)
}

type ContributionCalendar struct {
	TotalContributions int
	Weeks              []CalendarWeek
}

type ContributionLevel int

type DateRange struct {
	From string `json:"from"` // YYYY-MM-DD
	To   string `json:"to"`   // YYYY-MM-DD
}

type MonthStats struct {
	Year      int            `json:"year"`
	Month     int            `json:"month"`
	MonthName string         `json:"monthName"`
	Stats     AggregateStats `json:"stats"`
}

type MonthlyActivity struct {
	Year  int
	Month time.Month

	// Contribution counts
	Commits  int
	Issues   int
	PRs      int
	Reviews  int
	Releases int // Releases published in contributed repos this month

	// Commit details
	Additions int
	Deletions int

	// Repository breakdown for commits
	CommitsByRepo map[string]int // "owner/repo" -> commit count

	// Repos where user opened issues/PRs this month
	IssueRepos []string
	PRRepos    []string

	// New repos created this month
	ReposCreated []string
}

type MonthlyOutputFile struct {
	Metadata  QueryMetadata `json:"metadata"`
	Username  string        `json:"username"`
	Year      int           `json:"year"`
	Month     int           `json:"month"`
	MonthName string        `json:"monthName"`
	Stats     MonthlyStats  `json:"stats"`
}

type MonthlyOutputMulti struct {
	Metadata QueryMetadata  `json:"metadata"`
	Username string         `json:"username"`
	Months   []MonthlyStats `json:"months"`
}

type MonthlyStats struct {
	Year      int    `json:"year"`
	Month     int    `json:"month"`
	MonthName string `json:"monthName"`

	// Contribution counts
	Commits  int `json:"commits"`
	Issues   int `json:"issues"`
	PRs      int `json:"prs"`
	Reviews  int `json:"reviews"`
	Releases int `json:"releases"`

	// Code changes
	Additions    int `json:"additions"`
	Deletions    int `json:"deletions"`
	NetAdditions int `json:"netAdditions"`

	// Repository counts
	RepoCountContributed int `json:"repoCountContributed"`
	RepoCountCreated     int `json:"repoCountCreated"`
}

type Options struct {
	// Visibility filters which repositories to include.
	// Default is VisibilityAll.
	Visibility graphql.Visibility

	// IncludeReleases fetches release counts for each contributed repository.
	// This requires additional API calls and may be slow for users with many repos.
	IncludeReleases bool

	// MaxReleaseFetchRepos limits how many repos to fetch releases for.
	// 0 means no limit. Only used if IncludeReleases is true.
	MaxReleaseFetchRepos int

	// ReleaseOrgs filters which organizations/owners to count releases for.
	// If empty, counts releases from all repos. If set, only repos owned by
	// these orgs/users are counted (e.g., ["grokify", "plexusone"]).
	ReleaseOrgs []string

	// Progress is called to report progress during fetching.
	// If nil, no progress is reported.
	Progress ProgressFunc
}

type ProgressFunc func(info ProgressInfo)

type ProgressInfo struct {
	Stage       int    // Current stage number (1-based)
	TotalStages int    // Total number of stages
	Description string // What's happening in this stage
	Current     int    // Current item within stage (0 if not applicable)
	Total       int    // Total items in stage (0 if not applicable)
	Done        bool   // True if this stage is complete
}

type QuarterStats struct {
	Quarter int            `json:"quarter"` // 1-4
	Year    int            `json:"year"`
	Label   string         `json:"label"` // e.g., "Q1 2026"
	Stats   AggregateStats `json:"stats"`
	Months  []MonthStats   `json:"months"`
}

type QueryMetadata struct {
	// Query parameters
	Username    string   `json:"username"`
	From        string   `json:"from"`                  // YYYY-MM-DD format
	To          string   `json:"to"`                    // YYYY-MM-DD format
	Visibility  string   `json:"visibility"`            // all, public, private
	ReleaseOrgs []string `json:"releaseOrgs,omitempty"` // orgs to filter releases

	// Feature flags
	IncludeReleases bool `json:"includeReleases"`

	// Generation info
	GeneratedAt time.Time `json:"generatedAt"`
	Command     string    `json:"command,omitempty"` // CLI command used (optional)
}

type RenderFormat string

type RenderOptions struct {
	Format           RenderFormat
	Title            string
	ShowMonthDetails bool
	ShowDataSource   bool
	DataSourceURL    string
	RawDataFiles     []string
	RegenerateCmd    string
}

type RepoCommitCount struct {
	Repo    string
	Commits int
}

type RepoContribution struct {
	Owner     string
	Name      string
	FullName  string // "owner/repo"
	IsPrivate bool
	Commits   int
	Additions int
	Deletions int
	Releases  int // Number of releases (optional, may be 0 if not fetched)
}

type ReportMetadata struct {
	Username    string    `json:"username"`
	Visibility  string    `json:"visibility"`
	GeneratedAt time.Time `json:"generatedAt"`
	DataRange   DateRange `json:"dataRange"`
}

type StatsReport struct {
	Metadata ReportMetadata `json:"metadata"`
	Years    []YearStats    `json:"years"`
}

type UserProfile struct {
	Username string
	From     time.Time
	To       time.Time

	// Summary counts (from GitHub's contribution collection)
	// TotalCommits is the official GitHub count shown on the profile page.
	TotalCommits      int
	TotalIssues       int
	TotalPRs          int
	TotalReviews      int
	TotalReposCreated int

	// Private contributions (requires authentication as the user)
	RestrictedContributions int

	// Detailed commit stats from traversing default branch history.
	// CommitsDefaultBranch may differ from TotalCommits because it only
	// counts commits on default branches, missing feature branches,
	// squash-merged commits, and inaccessible repositories.
	CommitsDefaultBranch int
	TotalAdditions       int
	TotalDeletions       int

	// Repository data
	ReposContributedTo int
	RepoStats          []RepoContribution

	// Time-series data
	Calendar *ContributionCalendar
	Activity *ActivityTimeline
}

type YearStats struct {
	Year     int            `json:"year"`
	Stats    AggregateStats `json:"stats"`
	Quarters []QuarterStats `json:"quarters"`
}