docs(mentions): say what a mention can reach, and who decides #462

Closed
coilyco-ops wants to merge 1 commit from docs/what-a-mention-can-reach into main
Member

458 built the feature correctly and the property worth writing down is one it
does not state: the candidate set comes from member-authored payloads, and the
delivery decision does not.

Both halves matter separately. A member naming someone puts that person in the
candidate set, which is correct, because reaching the person a conversation is
about is the point. The harness still decides whether to deliver, which is what
the empty parse list has always protected. Collapsing the two into one idea is
how that guarantee would get argued away later, so they are two sections.

The four bounds are 458's decisions, transcribed from mentionroster.go rather
than restated from the pull request, so the doc describes what the code does. If
any of it is wrong, the correction belongs here.

Also recording the ambiguity rule the commit message did not mention: first
writer wins, so the oldest message in the turn keeps a contested name.

The widening note is placed where someone drawing candidates from guild members
or roles will meet it, since that is the change this property bears on.

closes #459

Co-authored-by: Kai Siren coilysiren@gmail.com
Co-authored-by: Claude noreply@anthropic.com

458 built the feature correctly and the property worth writing down is one it does not state: the candidate set comes from member-authored payloads, and the delivery decision does not. Both halves matter separately. A member naming someone puts that person in the candidate set, which is correct, because reaching the person a conversation is about is the point. The harness still decides whether to deliver, which is what the empty parse list has always protected. Collapsing the two into one idea is how that guarantee would get argued away later, so they are two sections. The four bounds are 458's decisions, transcribed from mentionroster.go rather than restated from the pull request, so the doc describes what the code does. If any of it is wrong, the correction belongs here. Also recording the ambiguity rule the commit message did not mention: first writer wins, so the oldest message in the turn keeps a contested name. The widening note is placed where someone drawing candidates from guild members or roles will meet it, since that is the change this property bears on. closes #459 Co-authored-by: Kai Siren <coilysiren@gmail.com> Co-authored-by: Claude <noreply@anthropic.com>
docs(mentions): say what a mention can reach, and who decides
All checks were successful
ci / image-build (pull_request) Successful in 18s
ci / test (pull_request) Successful in 33s
ci / publish-echo-image (pull_request) Has been skipped
ci / publish-observed (pull_request) Has been skipped
5f0e60f748
458 built the feature correctly and the property worth writing down is one it
does not state: the candidate set comes from member-authored payloads, and the
delivery decision does not.

Both halves matter separately. A member naming someone puts that person in the
candidate set, which is correct, because reaching the person a conversation is
about is the point. The harness still decides whether to deliver, which is what
the empty parse list has always protected. Collapsing the two into one idea is
how that guarantee would get argued away later, so they are two sections.

The four bounds are 458's decisions, transcribed from mentionroster.go rather
than restated from the pull request, so the doc describes what the code does. If
any of it is wrong, the correction belongs here.

Also recording the ambiguity rule the commit message did not mention: first
writer wins, so the oldest message in the turn keeps a contested name.

The widening note is placed where someone drawing candidates from guild members
or roles will meet it, since that is the change this property bears on.

closes #459

Co-authored-by: Kai Siren <coilysiren@gmail.com>
Co-authored-by: Claude <noreply@anthropic.com>
coilyco-ops 2026-08-13 13:59:16 +00:00
  • closed this pull request
  • requested review from coilysiren
All checks were successful
ci / image-build (pull_request) Successful in 18s
ci / test (pull_request) Successful in 33s
ci / publish-echo-image (pull_request) Has been skipped
ci / publish-observed (pull_request) Has been skipped

Pull request closed

Sign in to join this conversation.
No reviewers
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
coilyco-gaming/sirens-echo!462
No description provided.