talk/internal/queue/doc.go

// Package queue is the daemon's announcement queue: serialized playback (one
// announcement at a time), priorities (high > normal > low, FIFO per level),
// now items that jump ahead, plus the persistent mute state (file "mute" in
// the config directory). The anti-spam laws (rate.go, quiet.go) sit on top:
// a rate limit where every started announcement books the window (low over
// budget is discarded, normal parks until the slot, high may break it with
// burst rights), quiet hours that discard silently or toast instead, a text
// length cap and a maximum queue age. now:true deliberately breaks out of
// all of them.
package queue