From 1d2b3beebc3ad3ed500127fc40491659418d7eb5 Mon Sep 17 00:00:00 2001
From: Sam Scholten
Date: Wed, 7 Oct 2026 15:35:13 +1000
Subject: compact-labels: rebalance negative history to the per-feed ceiling

The single documented exception to labels.jsonl's append-only rule:
trims feeds over the ceiling (keeping each one's NEWEST negatives),
positives untouched, LABELS.bak written first, idempotent, --dry-run.
Existence justified by the ceiling only bounding the future, while
pre-cap history would otherwise never age out.
---
 README.md | 1 +
 1 file changed, 1 insertion(+)

(limited to 'README.md')

diff --git a/README.md b/README.md
index 1288601..c4d4d8c 100644
--- a/README.md
+++ b/README.md
@@ -20,6 +20,7 @@ fluxrec train           labels.jsonl → model.json + report.json    (local)
 fluxrec serve           poll, score, RSS at /recommendations.xml   (server)
 fluxrec retrostar       model-ranked candidates to star by hand    (cold start)
 fluxrec feeds           per-feed volume + star stats               (pruning aid)
+fluxrec compact-labels  trim per-feed negative skew                (one-off, re-runnable)
 fluxrec score           debug: stdin titles → stdout scores
 ```
 
-- 
cgit v1.2.3