insights

type CrossInsightReport struct {
	Metrics         *CrossMetrics
	VelocityTrends  string
	FailurePatterns string
	ProviderPerf    string
	Recommendations string
	GeneratedAt     time.Time
}

type CrossMetrics struct {
	Projects []ProjectSnapshot

	TotalProjects     int
	ActiveProjects    int // projects with at least one task
	TotalTasksAcross  int
	TotalDoneAcross   int
	TotalFailedAcross int

	AvgCompletionRate float64 // mean completion % across projects

	TopTags            []TagCount
	TopRoles           []TagCount
	TopFailureKeywords []TagCount

	ProviderCounts map[string]int

	VelocityMin  float64
	VelocityMax  float64
	VelocityMean float64
}

type InsightReport struct {
	Metrics     *Metrics
	AIAnalysis  string
	GeneratedAt time.Time
}

type Metrics struct {
	TotalTasks      int
	DoneTasks       int
	FailedTasks     int
	SkippedTasks    int
	InProgressTasks int
	PendingTasks    int
	BlockedTasks    int // permanently blocked by failed deps

	// Velocity: tasks completed per day (based on CompletedAt timestamps)
	VelocityPerDay float64

	// AvgTaskDuration is the mean duration of completed tasks.
	AvgTaskDuration time.Duration

	// EstimatedDaysRemaining is a rough forecast based on velocity.
	// -1 means not enough data.
	EstimatedDaysRemaining float64

	// RiskScore is 0-100 (0 = low risk, 100 = critical).
	RiskScore int

	// RiskFactors lists what contributed to the risk score.
	RiskFactors []string

	// RoleBreakdown maps role name to counts {done, total}.
	RoleBreakdown map[string][2]int

	// TokenCost tracks session token usage.
	InputTokens  int
	OutputTokens int
}

type ProjectSnapshot struct {
	Name            string
	Path            string
	Goal            string
	Provider        string
	TotalTasks      int
	DoneTasks       int
	FailedTasks     int
	SkippedTasks    int
	PendingTasks    int
	CompletionPct   float64
	Tags            []string // deduplicated tags from all tasks
	Roles           []string // deduplicated roles from all tasks
	FailureReasons  []string // short failure summaries from task results
	VelocityPerDay  float64
	AvgTaskDuration time.Duration
	LastUpdated     time.Time
	Error           string // non-empty if loading failed
}

type TagCount struct {
	Label string
	Count int
}