datalifecycle

type Options struct {
	Layout    statepaths.Layout
	Store     Store
	Now       func() time.Time
	RemoveAll RemoveAllFunc
	Progress  ProgressReporter
}

type OrphanItem struct {
	Path  string
	Bytes int64
}

type ProgressReporter interface {
	Start(op, target string) ProgressSpan
}

type ProgressSpan interface {
	End(error)
}

type PruneOptions struct {
	OlderThan time.Duration
	KeepLast  *int
	DryRun    bool
	Retention RetentionPolicy
}

type PruneResult struct {
	DryRun         bool
	SelectedRuns   []RunItem
	DeletedRuns    []RunItem
	OrphansRemoved []OrphanItem
	Warnings       []string
}

type PurgeResult struct {
	DataRoot string
	DryRun   bool
	Removed  bool
}

type RemoveAllFunc func(string) error

type RetentionPolicy struct {
	LiveMaxAge  time.Duration
	LiveForever bool
	// DryRunMaxAge is an internal policy override for callers that own dry-run
	// lifecycle separately from profile config. The zero value uses DryRunRetention.
	DryRunMaxAge time.Duration
}

type RunItem struct {
	RunID        string
	PostMode     ledger.PostMode
	StartedAt    time.Time
	ArtifactPath string
}

type Stats struct {
	DataRoot      string
	LedgerPath    string
	RunsRoot      string
	RunCount      int
	LiveRuns      int
	DryRunRuns    int
	OutcomeCounts map[ledger.Outcome]int
	OldestStarted *time.Time
	NewestStarted *time.Time
	ArtifactBytes int64
	OrphanCount   int
	OrphanBytes   int64
}

type Store interface {
	ListRuns(context.Context) ([]ledger.Run, error)
	DeleteRun(context.Context, string) error
}