maintenance

type CleanupResult struct {
	Before DiskUsage
	After  DiskUsage

	// DryRun is true when this result came from a dry-run — Reclaimed lists what
	// WOULD have been removed and Bytes are estimates; nothing was actually deleted.
	DryRun bool

	// BytesReclaimed is the total size of everything actually removed (0 for a
	// dry-run's real disk impact, but Reclaimed still lists the would-be total).
	BytesReclaimed int64
	Reclaimed      []ReclaimEntry
	Skipped        []SkipEntry

	DockerPruneOut   string
	LogRotationOut   string
	JournalVacuumOut string

	Errors []error
}

type DiskCleanupOptions struct {
	// DryRun reports what would be removed and the space it would free, without
	// removing anything.
	DryRun bool
	// PressureThreshold is the disk-used percentage at/above which idle-shared
	// reclaims run even while a runner is busy. Zero means DefaultPressureThreshold.
	PressureThreshold int
	// Home overrides the home directory used to locate caches. Defaults to $HOME
	// (falling back to os.UserHomeDir()). Tests inject this to point at a fixture
	// tree instead of the real user's home.
	Home string
	// RunnerRoots overrides runner discovery. Tests inject this to point at fixture
	// runner trees instead of discovering real installs via systemd/globs.
	RunnerRoots []RunnerRoot
	// SharedCacheRoots overrides the absolute (non-home-relative) cache locations
	// considered for reclaim (default: sharedCacheRoots, e.g. "/opt/pnpm-store").
	// Tests set this to an empty (non-nil) slice to guarantee nothing outside a
	// fixture tree is ever touched; nil means "use the default list".
	SharedCacheRoots []string
	// UsageOverride, when non-nil, is used instead of calling GetDiskUsage() for the
	// "before" reading that pressure-escalation compares against threshold. Tests use
	// this for deterministic threshold behavior instead of depending on the test
	// machine's real, unpredictable disk usage.
	UsageOverride *DiskUsage
}

type DiskUsage struct {
	// UsedPercent is the percentage of the disk that is in use (0-100).
	UsedPercent int
	// TotalGB is the total disk capacity in gigabytes.
	TotalGB float64
	// UsedGB is the used disk space in gigabytes.
	UsedGB float64
	// FreeGB is the free disk space in gigabytes.
	FreeGB float64
}

type HasuraMetadataCronStatus struct {
	Enabled  bool
	Platform string
	Detail   string
}

type ReclaimEntry struct {
	Path  string
	Bytes int64
	Tier  reclaimTier
}

type RunnerRoot struct {
	// Name is the systemd unit name when discovered via systemd, or the directory
	// basename when discovered via the fallback glob list.
	Name string
	// Path is the runner's install directory (what the runner config calls "work
	// folder parent" — it contains _work, _diag, bin, etc.).
	Path string
}

type ScheduleStatus struct {
	Enabled  bool
	Platform string
	Detail   string
}

type SkipEntry struct {
	Path   string
	Reason string
}