deploymentgc

type ExportProgress interface {
	// LandedRevision returns the highest store revision cloud has confirmed,
	// and whether export applies to this cluster at all.
	LandedRevision() (revision int64, exporting bool)
}

type GCConfig struct {
	// CheckInterval is how often to run the GC sweep (default: 1h).
	CheckInterval time.Duration

	// RetentionPeriod keeps records newer than this regardless of count
	// (default: 30 days). Zero disables the sweep entirely, keeping every
	// record indefinitely.
	RetentionPeriod time.Duration

	// RetentionCount keeps this many most-recent records per app regardless
	// of age (default: 25).
	RetentionCount int
}

type GCController struct {
	Log    *slog.Logger
	EAC    *entityserver_v1alpha.EntityAccessClient
	Config GCConfig

	// StartGate, when set, holds the first sweep until it closes. The server
	// passes the same readiness signal that gates entity sync: the
	// deployment-attempt migration has finished repairing every record and
	// backfilling the cloud export marker. Deleting a record before then
	// would race the migration and, worse, remove a record the exporter has
	// not been told to watch, so cloud would never receive its final state.
	StartGate <-chan struct{}

	// Exports, when set, makes cloud custody a condition of deletion on a
	// registered cluster: a record is only pruned once its revision is at or
	// below the revision cloud has landed. Cloud keeps deployments as an
	// archive, so this is what lets the runtime forget a record without the
	// history losing it. The retention floor alone is not enough, because it
	// measures the deploy's age rather than how long cloud has had a chance
	// to see it: a cluster upgrading with years of never-exported history
	// would otherwise prune most of it before the first snapshot pinned its
	// head. Nil, or an unregistered cluster, prunes on retention alone.
	Exports ExportProgress
	// contains filtered or unexported fields
}

type GCResult struct {
	// DeletedRecords is the number of records hard-deleted.
	DeletedRecords int
	// FailedRecords is the number of records that failed to delete.
	FailedRecords int
	// RetainedRecords is the number of records kept by retention policy.
	RetainedRecords int
	// AwaitingExport is the number of prune candidates kept because cloud
	// has not yet confirmed it holds their final state.
	AwaitingExport int
	// TotalScanned is the number of deployment records evaluated.
	TotalScanned int
}