Merge pull request #244 from cndgrr/build/231-labels-attention-absolute

docs(labels): the `attention` absolute stops denying the shipped reconciler
This commit is contained in:
Daniel Marin 2026-08-03 17:17:27 +01:00 committed by GitHub
commit 46329f5993
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
2 changed files with 13 additions and 2 deletions

View file

@ -171,8 +171,13 @@ The flag is additive: it composes with `ready`, `claimed`, or `blocked` and
with `needs-ruling`, and never substitutes for queue state. It pauses no with `needs-ruling`, and never substitutes for queue state. It pauses no
clock. Unlike `offsite` and `needs-ruling`, which make silence legitimate, clock. Unlike `offsite` and `needs-ruling`, which make silence legitimate,
unanswered `attention` is exactly the silence the 48-hour reclaim should unanswered `attention` is exactly the silence the 48-hour reclaim should
take. It is hand-set doctrine only: nothing in `actions/` sets, clears, take. It is hand-set: the machine never sets `attention`, never assigns
reads, or validates it, and no reconciler enforces the assignee requirement. anyone to receive one, and never decides that one has been answered — the
assignee's removal is the only ack. It writes the label in exactly one
place, the derived `claimed``post-merge` transition below, and nowhere
else; where it reads the flag it reads it to diagnose, and a diagnosis is a
comment that leaves the label alone. No reconciler enforces the assignee
requirement either: an unassigned flag may be reported, never repaired.
An `attention` issue without an assignee is therefore a board bug, not a An `attention` issue without an assignee is therefore a board bug, not a
demand; anyone may assign it or remove the flag. It never composes with demand; anyone may assign it or remove the flag. It never composes with
`post-merge`, whose released claim has no assignee to answer the demand. The `post-merge`, whose released claim has no assignee to answer the demand. The

6
changelog.d/231.md Normal file
View file

@ -0,0 +1,6 @@
### Fixed
- LABELS.md no longer claims nothing in `actions/` clears or reads
`attention`: the reconciler has done both since the derived `claimed`
`post-merge` transition shipped. The amended text keeps the hand-set rule
and admits the one clear and the diagnostic read (#231).