fix read/star label issue

1 files changed, 4 insertions, 1 deletions

diff --git a/core/labels.go b/core/labels.go
index bdff515..de14662 100644
--- a/core/labels.go
+++ b/core/labels.go
@@ -2,7 +2,10 @@
 //
 // labels.jsonl is the canonical label store: one JSON LabelRow per line,
 // append-only. ReadLabels is strict (per-line errors with line numbers);
-// AppendLabels is the only writer — rows are never rewritten in place.
+// AppendLabels is the normal writer — rows are only rewritten in place by the
+// two commands that deliberately do so, each backing the file up first:
+// compact-labels (trimming per-feed negative skew) and export (relabeling a
+// starred entry that was stored as a negative).
 package core
 
 import (