analytics

type Dashboard struct {
	FactCount     int64
	Generation    int64
	InputRevision int64
	Pending       int64
	Unresolved    int64
	Quality       string
	Revision      int64
	DatabaseID    string
	DatasetID     string
	Rows          []Row
	Chart         []Row
	RowCount      int
	Page          int
	PageSize      int
	Summary       querymodel.ViewerSummaryRow
	LastSynced    int64
	Range         string
}

type Facets struct {
	Providers, Models, Harnesses, Sessions []string
	Repositories, Directories              []querymodel.LocationOption
	Revision, Generation, InputRevision    int64
	DatabaseID, DatasetID                  string
}

type ProcessingStatus struct {
	Metadata        dataengine.Metadata
	Pending         int64
	Failed          int64 // Pending scopes with a durable error; completed scopes are excluded.
	FailedRetryAtMs int64 // Earliest retry time among failed pending scopes.
	Hostname        string
}

type Query struct {
	Quality        string
	Selection      viewer.Selection
	Tab            string
	LocationGroup  querymodel.RepoGroup
	RepositoryKeys []string
	DirectoryKeys  []string
	Sort           string
	Direction      string
	Page           int
	PageSize       int
}

type Repository interface {
	// Dashboard clamps page after counting; rows, summary and revisions agree.
	Dashboard(context.Context, Query, time.Time) (Dashboard, error)
	// AllDashboard returns complete sorted rows or an error when the limit is
	// exceeded, never a successful truncation or separately snapshotted pages.
	AllDashboard(context.Context, Query, time.Time, int) (Dashboard, error)
	// Each call owns its snapshot; separate calls may observe newer revisions.
	Facets(context.Context, Query, string, time.Time) (Facets, error)
	// Status distinguishes accepted inputs, published revision and rebuild target.
	Status(context.Context) (ProcessingStatus, error)
}

type Row struct {
	Key                 string
	Name                string
	Harness             string
	Provider            string
	Model               string
	Date                int64
	Sessions            int64
	Input               int64
	Output              int64
	Reasoning           int64
	CacheRead           int64
	CacheWrite          int64
	Total               int64
	Context             int64
	AverageContext      int64
	MedianContext       int64
	MaxContext          int64
	LocationKey         string
	LocationName        string
	DirectoryNames      []string
	HasUnknownDirectory bool
	RepositoryKey       string
	RepositoryName      string
}