dashboard

type AgentState string

type Analytics interface {
	// Query runs f with the current database, serialized against refreshes.
	Query(f func(*sqlite3.Conn) error) error
	// Freshness is the time through which the served data is complete.
	Freshness() time.Time
}

type AttemptData struct {
	Ecosystem       string
	PackageName     string
	EncodedPackage  string
	Attempt         *RebuildView
	AttemptStrategy string
	AttemptDuration string
}

type AttemptRequest struct {
	Ecosystem string
	Package   string
	Version   string
	Artifact  string
	RunID     string `form:"runid"`
}

type BenchmarkStats struct {
	Total   int
	Success int
	Failed  int
}

type BenchmarkTarget struct {
	Ecosystem        string
	Package          string
	EncodedEcosystem string
	EncodedPackage   string
	Success          bool
	HasRun           bool
}

type Deps struct {
	Rundex        rundex.Reader
	Sessions      rundex.SessionReader
	GCSClient     *storage.Client
	LogsBucket    string
	Tracked       feed.TrackedPackageIndex
	BenchmarkName string
	SuccessRegex  *regexp.Regexp
	Analytics     Analytics           // serves the snapshot-derived trend views
	Registry      rebuild.RegistryMux // enumerates published versions for status
}

type EcoDaily struct {
	Day            string
	Attempts       int64
	Successes      int64
	SuccessPct     int64
	AttemptsBarPct int64
	BuilderMinutes float64
	Tokens         string
	VMMinutes      float64
}

type ExpensivePackage struct {
	Ecosystem      string
	Package        string
	Attempts       int64
	BuilderMinutes float64
	BarPct         int64
}

type IndexData struct {
	BenchmarkTitle   string
	BenchmarkStats   BenchmarkStats
	BenchmarkTargets []BenchmarkTarget
	RecentRebuilds   []RebuildView
	RecentSessions   []SessionView
}

type IndexRequest struct{}

type LogLine struct {
	Number int
	Text   string
}

type LogsData struct {
	Target      rebuild.Target
	RunID       string
	RedirectURL string // If populdated, render a redirection popup.
	Lines       []LogLine
}

type LogsRequest struct {
	Ecosystem string
	Package   string
	Version   string
	Artifact  string
	RunID     string
}

type PackageData struct {
	Ecosystem      string
	PackageName    string
	EncodedPackage string
	Summary        PackageSummary  // high-level per-package status shown at the top
	Versions       []VersionStatus // windowed slice of the version history shown in the strip
	Expanded       bool            // strip shown as a multi-row grid
	Offset         int             // current window offset (for building toggle links)
	HasPrev        bool            // a newer window exists (scroll toward newest)
	HasNext        bool            // an older window exists (scroll back in time)
	PrevOffset     int             // offset the newer-window link jumps to
	NextOffset     int             // offset the older-window link jumps to
	WindowFrom     int             // 1-based index of the first shown version (for the caption)
	WindowTo       int             // 1-based index of the last shown version
	Events         []PackageEvent  // rebuilds and sessions intermingled, most-recent-first
	RebuildEvents  []PackageEvent  // the same timeline restricted to rebuild attempts
	SessionEvents  []PackageEvent  // the same timeline restricted to agent sessions
	Warning        string          // set when the version lookup failed, not when the ecosystem lacks a lister
}

type PackageEvent struct {
	Created time.Time
	Rebuild *RebuildView
	Session *SessionView
}

type PackageRequest struct {
	Ecosystem string
	Package   string
	Offset    int  // render strip scroll-back into the version history, 0 = newest
	Expanded  bool // render strip as a multi-row grid rather than a single row
}

type PackageSummary struct {
	Supported      bool // whether the version history was enumerable for this ecosystem
	TotalVersions  int
	Attempted      int
	Verified       int
	Failed         int
	Running        int
	AgentRuns      int
	NeedsAttention int // regressions
	VerifiedPct    int
}

type RebuildView struct {
	rundex.Rebuild
	Encoded rebuild.EncodedTarget
}

type ResourcesData struct {
	Loaded     bool
	AsOf       string
	WindowDays int

	TotalAttempts     int64
	TotalSuccesses    int64
	TotalTokens       string
	TotalBuilderHours float64
	TotalVMHours      float64

	Ecosystems  []string // tab labels, from the window's data
	Eco         string   // selected tab; empty is the aggregate view
	Days        []EcoDaily
	TopPackages []ExpensivePackage
}

type ResourcesRequest struct {
	Eco string // ecosystem tab for the daily table; empty aggregates every ecosystem
}

type SessionView struct {
	schema.AgentSession
	Encoded    rebuild.EncodedTarget
	Iterations []schema.AgentIteration // NOTE: Only populated by pages where it's required
}

type VersionData struct {
	Ecosystem      string
	PackageName    string
	Version        string
	EncodedPackage string
	// Attempts are this version's rebuild attempts (across artifacts), newest-first.
	Attempts []RebuildView
	// Sessions are this version's agent sessions with their iterations, newest-first.
	Sessions []SessionView
}

type VersionRequest struct {
	Ecosystem string
	Package   string
	Version   string
}

type VersionState string

type VersionStatus struct {
	Version   string
	Encoded   rebuild.EncodedTarget
	State     VersionState
	Agent     AgentState
	Regressed bool // Failed while an older version is Verified.
	Attempts  int
	Sessions  int
}