context

type AuthorJSON struct {
	Name    string `json:"name"`
	Commits int    `json:"commits"`
}

type AuthorStats struct {
	Name    string
	Commits int
}

type BuildCmdJSON struct {
	Name    string `json:"name"`
	Command string `json:"command"`
	Source  string `json:"source,omitempty"`
}

type CommitSummary struct {
	Hash    string
	Message string
	Author  string
	Date    time.Time
	Files   int    // number of files changed
	IsMerge bool   // true if commit has 2+ parents
	Tag     string // non-empty if commit has a semver tag
}

type ContextJSON struct {
	Name      string              `json:"name"`
	Language  string              `json:"language"`
	TechStack []TechComponentJSON `json:"tech_stack"`
	BuildCmds []BuildCmdJSON      `json:"build_commands"`
	Patterns  []PatternJSON       `json:"patterns"`
	History   *HistoryJSON        `json:"history,omitempty"`
	TechDebt  *TechDebtJSON       `json:"tech_debt,omitempty"`
}

type GitHistory struct {
	RecentWeeks  []WeekActivity
	TopAuthors   []AuthorStats
	TotalCommits int
	Milestones   []TagInfo // all version tags, newest first, max 10
}

type HistoryJSON struct {
	TotalCommits int             `json:"total_commits"`
	TopAuthors   []AuthorJSON    `json:"top_authors"`
	Milestones   []MilestoneJSON `json:"milestones,omitempty"`
	RecentWeeks  []WeekJSON      `json:"recent_weeks,omitempty"`
}

type MilestoneJSON struct {
	Name string `json:"name"`
	Hash string `json:"hash"`
	Date string `json:"date"`
}

type PatternJSON struct {
	Name        string `json:"name"`
	Description string `json:"description"`
}

type TagInfo struct {
	Name string    // e.g. "v1.2.0"
	Hash string    // 8-char short hash
	Date time.Time // commit date
}

type TechComponentJSON struct {
	Name    string `json:"name"`
	Version string `json:"version,omitempty"`
	Source  string `json:"source,omitempty"`
}

type TechDebtJSON struct {
	SignalCount int            `json:"signal_count"`
	ByKind      map[string]int `json:"by_kind"`
}

type WeekActivity struct {
	WeekStart time.Time
	Commits   []CommitSummary
	Tags      []TagInfo // version tags that landed in this week
}

type WeekJSON struct {
	WeekStart string   `json:"week_start"`
	Commits   int      `json:"commits"`
	Tags      []string `json:"tags,omitempty"`
}