feat(jobs/runners): job_reaper (lease timeout) + job_purge (retention)

internal/jobs/runners/job_purge.go

@@ -0,0 +1,40 @@
+package runners
+
+import (
+	"context"
+	"log/slog"
+	"time"
+)
+
+// JobsPurgeRepo is the minimal repo surface for purge.
+type JobsPurgeRepo interface {
+	PurgeCompleted(ctx context.Context, completedBefore time.Time) (int64, error)
+}
+
+// JobPurge deletes completed/dead jobs older than retention. Periodic; idempotent.
+type JobPurge struct {
+	repo      JobsPurgeRepo
+	retention time.Duration
+	log       *slog.Logger
+}
+
+// NewJobPurge builds the purger.
+func NewJobPurge(repo JobsPurgeRepo, retention time.Duration, log *slog.Logger) *JobPurge {
+	if log == nil {
+		log = slog.Default()
+	}
+	return &JobPurge{repo: repo, retention: retention, log: log}
+}
+
+// Run purges once.
+func (p *JobPurge) Run(ctx context.Context) {
+	cutoff := time.Now().Add(-p.retention)
+	rows, err := p.repo.PurgeCompleted(ctx, cutoff)
+	if err != nil {
+		p.log.Error("job_purge.purge", "err", err.Error())
+		return
+	}
+	if rows > 0 {
+		p.log.Info("job_purge.purged", "count", rows)
+	}
+}