Say where the assignments bucket is declared why it keeps its marker age (issue 1089)

2026-10-18 02:40:10 +02:00
parent fc55785956
commit 36c4ce605e
1 changed files with 6 additions and 0 deletions
@@ -101,6 +101,12 @@ var (
 	RolloutsBucket = BucketName(ControllerSeat, ChainRollouts)
 )

+// **The assignments bucket keeps the marker age (MirrorMarkerTTL) it was made with as a mirror.** A stream that allows
+// messages an age cannot be made to disallow them (the server refuses the update: "message TTL status can not be
+// disabled", nats-server stream.go), so asserting the bucket without the age would fail the controller's start on a
+// mesh that has the bucket. The chain never purges or removes a key (ADR 0408 §4), so no marker is ever written and the
+// age ends nothing; it is kept only so the stream's configuration stays one the server accepts.
+//
 // The chain buckets' local names, as a reader names them in `reads` after `mesh-controller.`.
 const (
 	ChainBuilds   = "builds"