From bded7d0b54a6c7872204e69c89aa4ce30de7d932 Mon Sep 17 00:00:00 2001
From: cndgrr <59120057+cndgrr@users.noreply.github.com>
Date: Mon, 3 Aug 2026 15:48:05 +0000
Subject: [PATCH] docs(labels): the attention absolute stops denying the
 shipped reconciler

LABELS.md asserted 'nothing in actions/ sets, clears, reads, or validates
it' and then documented two exceptions to itself four sentences later. The
sentence is false on two of the four verbs: issueflow-reconcile.sh clears a
carried attention on the derived claimed -> post-merge transition and reads
it to gate the post-merge-assigned diagnostic. Keep the hand-set intent,
drop the absolute (#231).
---
 LABELS.md          | 9 +++++++--
 changelog.d/231.md | 6 ++++++
 2 files changed, 13 insertions(+), 2 deletions(-)
 create mode 100644 changelog.d/231.md

diff --git a/LABELS.md b/LABELS.md
index 7402bd4..af7ccf3 100644
--- a/LABELS.md
+++ b/LABELS.md
@@ -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
 clock. Unlike `offsite` and `needs-ruling`, which make silence legitimate,
 unanswered `attention` is exactly the silence the 48-hour reclaim should
-take. It is hand-set doctrine only: nothing in `actions/` sets, clears,
-reads, or validates it, and no reconciler enforces the assignee requirement.
+take. It is hand-set: the machine never sets `attention`, never assigns
+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
 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
diff --git a/changelog.d/231.md b/changelog.d/231.md
new file mode 100644
index 0000000..df32aeb
--- /dev/null
+++ b/changelog.d/231.md
@@ -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).