resource

type AnalysisResult struct {
	ResourceUID string
	Tags        map[RevisionID][]ChangeTag
	LoopInfo    LoopInfo
}

type BurstGroup struct {
	Entries []TimelineEntry
}

type ChangeTag string

type CompareItem struct {
	Resource Resource
	Revision Revision
}

type CompareSelection struct {
	Left  *CompareItem
	Right *CompareItem
}

type Data struct {
	Resource  Resource
	Revisions []Revision // sorted oldest-first (index 0 = oldest)
}

type EventType string

type Kind struct {
	Kind       string // e.g., "Pod", "Deployment", "Secret"
	APIVersion string // e.g., "v1", "apps/v1"
	Resource   string // plural resource name, e.g., "pods", "deployments"
	Namespaced bool   // whether instances live in a namespace
}

type KindGroup struct {
	Kind      string
	Resources []*Data
	Expanded  bool
}

type LoopInfo struct {
	IsLoop bool

	// DistinctStates is the number of unique object states in the loop (e.g., 2 for A<->B).
	DistinctStates int
	// Cycles counts complete oscillation cycles. For A->B->A->B->A, there are 2 full cycles.
	Cycles int
	// Period is the average duration of one full cycle.
	Period    time.Duration
	FirstSeen time.Time

	// LoopRevisions maps revision IDs to their state group label ("A", "B", ...).
	LoopRevisions map[RevisionID]string

	// PatternSample is a short pre-built sample of the oscillation pattern
	// from the tail of the window, e.g., "A->B->A->B". At most 6 labels.
	PatternSample string
}

type Resource struct {
	UID       string
	Kind      string
	Name      string
	Namespace string
	Starred   bool
}

type Revision struct {
	ID         RevisionID
	PreviousID RevisionID
	EventType  EventType
	Time       time.Time
	Object     map[string]any // full state at this revision
	Patch      map[string]any // diff from previous (nil for ADD/snapshots)
	// ResourceVersion is the Kubernetes metadata.resourceVersion parsed as a
	// uint64, or 0 if absent/unparseable. On etcd-backed clusters it is a
	// global, monotonically increasing revision, so it orders changes across
	// different resources by true causal order - unlike Time, which is only
	// loog's observation time and can invert for near-simultaneous events on
	// separate watch streams.
	ResourceVersion uint64
}

type RevisionID = store.RevisionID

type TimelineEntry struct {
	Resource Resource
	Revision Revision
}

type WindowMode int