aggregate

type CategoryCount struct {
	Category string `json:"category"`
	Count    int    `json:"count"`
}

type DailyCount struct {
	Date  string `json:"date"`  // YYYY-MM-DD
	Count int    `json:"count"` // Total activity
}

type DashboardExport struct {
	// Summary metrics widget data
	Summary SummaryData `json:"summary"`

	// Heatmap data: [[date, count], ...]
	HeatmapData [][]any `json:"heatmapData"`

	// Time series for charts
	ReleaseTrend  []map[string]any `json:"releaseTrend"`
	CategoryTrend []map[string]any `json:"categoryTrend"`

	// Project breakdown table
	ProjectTable []map[string]any `json:"projectTable"`
}

type DashboardOptions struct {
	Template    string // velocity, summary, heatmap
	Title       string
	Theme       string // light, dark, auto
	DateRange   string // last-12-months, last-6-months, ytd, all
	ShowFilters bool
}

type DateRange struct {
	Start string `json:"start"` // YYYY-MM-DD
	End   string `json:"end"`   // YYYY-MM-DD
}

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

type DiscoveryOptions struct {
	IncludeArchived bool
	IncludeForks    bool
	MaxReposPerOrg  int // 0 = unlimited
}

type DiscoveryResult struct {
	Projects   []ProjectRef   `json:"projects"`
	Statistics DiscoveryStats `json:"statistics"`
}

type DiscoveryStats struct {
	SourcesScanned     int `json:"sourcesScanned"`
	ReposScanned       int `json:"reposScanned"`
	ReposWithChangelog int `json:"reposWithChangelog"`
	ChangelogsFound    int `json:"changelogsFound"`
}

type Manifest struct {
	Name        string       `json:"name"`
	Description string       `json:"description,omitempty"`
	Sources     []Source     `json:"sources,omitempty"`
	Projects    []ProjectRef `json:"projects"`
	Generated   *time.Time   `json:"generated,omitempty"`
}

type MetricsOptions struct {
	Granularity    string    // day, week, month
	Since          time.Time // Filter start
	Until          time.Time // Filter end
	IncludeRollups bool      // Include rolled-up counts
}

type MetricsReport struct {
	Portfolio   string    `json:"portfolio"`
	DateRange   DateRange `json:"dateRange"`
	Granularity string    `json:"granularity"` // day, week, month

	// Summary totals
	TotalReleases int `json:"totalReleases"`
	TotalEntries  int `json:"totalEntries"`

	// Raw category counts (all categories)
	ByCategory map[string]int `json:"byCategory"`

	// Rolled-up counts
	ByRollup map[string]int `json:"byRollup,omitempty"`

	// Per-project breakdown
	ByProject map[string]ProjectMetrics `json:"byProject"`

	// Time series (for line/bar charts)
	TimeSeries []TimePoint `json:"timeSeries"`

	// Daily activity (for heatmap)
	DailyActivity []DailyCount `json:"dailyActivity"`
}

type Portfolio struct {
	Name        string        `json:"name"`
	Description string        `json:"description,omitempty"`
	Projects    []ProjectData `json:"projects"`
	DateRange   DateRange     `json:"dateRange"`
	GeneratedAt time.Time     `json:"generatedAt"`
}

type PortfolioSummary struct {
	ProjectCount int            `json:"projectCount"`
	ReleaseCount int            `json:"releaseCount"`
	EntryCount   int            `json:"entryCount"`
	ByCategory   map[string]int `json:"byCategory"`
	DateRange    DateRange      `json:"dateRange"`
}

type ProjectCount struct {
	Path     string `json:"path"`
	Releases int    `json:"releases"`
	Entries  int    `json:"entries"`
}

type ProjectData struct {
	Path      string               `json:"path"`
	Name      string               `json:"name"`
	Changelog *changelog.Changelog `json:"changelog"`
}

type ProjectMetrics struct {
	Releases   int            `json:"releases"`
	Entries    int            `json:"entries"`
	ByCategory map[string]int `json:"byCategory"`
}

type ProjectRef struct {
	Path       string `json:"path"`                 // github.com/org/repo or github.com/org/repo/subdir
	LocalPath  string `json:"localPath,omitempty"`  // Override local resolution
	Discovered bool   `json:"discovered,omitempty"` // Auto-discovered vs manually added
}

type ReleaseWithProject struct {
	ProjectPath string             `json:"projectPath"`
	ProjectName string             `json:"projectName"`
	Release     *changelog.Release `json:"release"`
}

type ResolutionSummary struct {
	TotalCount     int      `json:"totalCount"`
	LocalCount     int      `json:"localCount"`
	RemoteCount    int      `json:"remoteCount"`
	LocalProjects  []string `json:"localProjects,omitempty"`
	RemoteProjects []string `json:"remoteProjects,omitempty"`
}

type ResolvedProject struct {
	Ref           ProjectRef // Original project reference
	LocalPath     string     // Absolute path to project directory (empty if not found)
	ChangelogPath string     // Full path to CHANGELOG.json (empty if not found)
	IsLocal       bool       // true if found locally
	NeedsApproval bool       // true if remote fetch required
}

type Resolver struct {
	SearchPaths []string // Directories to search (e.g., ~/go/src)
}

type RollupRules struct {
	Version string              `json:"version"`
	Rollups map[string][]string `json:"rollups"` // RollupName -> []CategoryNames
}

type Source struct {
	Type string `json:"type"` // "org" or "user"
	Name string `json:"name"` // GitHub org or username
}

type SummaryData struct {
	TotalReleases int            `json:"totalReleases"`
	TotalEntries  int            `json:"totalEntries"`
	ProjectCount  int            `json:"projectCount"`
	DateRange     DateRange      `json:"dateRange"`
	ByRollup      map[string]int `json:"byRollup,omitempty"`
}

type TimePoint struct {
	Date       string         `json:"date"` // YYYY-MM-DD, YYYY-MM, or YYYY-Www
	Releases   int            `json:"releases"`
	Entries    int            `json:"entries"`
	ByCategory map[string]int `json:"byCategory,omitempty"`
	ByRollup   map[string]int `json:"byRollup,omitempty"`
}

type ValidationError struct {
	Field   string `json:"field"`
	Message string `json:"message"`
}

type ValidationResult struct {
	Valid  bool              `json:"valid"`
	Errors []ValidationError `json:"errors,omitempty"`
}