Skip to content

feat(archivist): answer when addressed by name - #162

Merged
arthware-dev merged 3 commits into
mainfrom
fix/archivist-ask-by-mention
Sep 26, 2026
Merged

arthware-dev merged 3 commits into
mainfrom
fix/archivist-ask-by-mention

Conversation

@arthware-dev

@arthware-dev arthware-dev commented Sep 26, 2026 •

Copy link
Copy Markdown
Contributor

Summary

  • The archivist answers when addressed by name on the main timeline: "Archivist, when does the insurance renew?", "hey archivist ...", "..., Archivist?". The address is dropped from the question; a name in the middle of a sentence does not count. In a thread or a reply only a picked mention counts, so a message there stays a correction.
  • The rule is the agent's, moved to lib/stack/name_trigger.py and shared: the bot-runner imports it, the agent container mounts that one file.
  • The welcome texts (topic, personal, capture; English and German) and the user guide say to start with the archivist's name instead of the ? prefix, which was never routed.

Checked on the test Mac: a plain "Archivist, what should we bring to the picnic?" in a topic room is answered from that topic only; "I asked the archivist yesterday ..." gets no reply; a named message in the Memories room gets none either.

  • docs/design/brain/who-answers.md maps when the archivist answers as a decision tree (text, file, reaction), read from the code.

Rebase merge: three commits, each its own changelog line.

Closes: #151

@arthware-dev arthware-dev added this to the v0.4.0-rc.1 milestone Sep 26, 2026
@arthware-dev
arthware-dev force-pushed the fix/archivist-ask-by-mention branch from 21ef4e2 to d4bf86e Compare September 26, 2026 18:16
@arthware-dev arthware-dev changed the title fix(archivist): explain asking by @-mention instead of a ? prefix feat(archivist): answer when addressed by name Sep 26, 2026
@arthware-dev
arthware-dev force-pushed the fix/archivist-ask-by-mention branch from bf23cf6 to 816c8cf Compare September 26, 2026 18:25
People in a family room write "Archivist, when does the insurance
renew?" rather than picking the bot from a list. Only a picked mention
counted, so that question went unanswered.

A message on the main timeline that addresses a bot by its name, at the
start ("Archivist, ...", "hey archivist ...") or at the end
("..., Archivist?"), now counts as a mention, and the address is dropped
from the question. A name in the middle of a sentence does not count.
In a thread or a reply only a picked mention counts, so a message there
keeps its meaning: for the archivist, a correction of the filing.

The rule is the one the agent already used. It moves to
`lib/stack/name_trigger.py`; the agent container mounts that one file,
so both agree on what counts as being addressed.
The archivist's welcome in topic, personal and capture rooms told the
family to start a message with `?` to search. Nothing ever handled that
prefix, so such a question got no answer at all, not even "nothing
found".

The welcome texts (English and German) and the user guide now say to
start with the archivist's name, which searches and answers, limited
to the topic's folder in a topic room.

Closes: #151
The archivist decides what to do with a message through a dozen gates
and a command ladder spread over `_on_text`, `_on_file`,
`_on_reaction` and `MicroBot`. The rules existed only in the code.

The design note on who answers now has the tree for a text message, a
file and a reaction, first match wins, read from the code: the Memories
room, handoffs, room modes, thread ownership, corrections, and what
counts as addressing the archivist.
@arthware-dev
arthware-dev force-pushed the fix/archivist-ask-by-mention branch from 816c8cf to b4a02f2 Compare September 26, 2026 18:28
@arthware-dev
arthware-dev merged commit 086568c into main Sep 26, 2026
1 check passed
@arthware-dev
arthware-dev deleted the fix/archivist-ask-by-mention branch October 7, 2026 11:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

A question starting with ? in a topic room gets no answer

1 participant