The /help text in bot.py (in handle_help) has drifted from the actual command surface. Five inaccuracies, plus one missing line:
1. /github notify [on|off] is wrong. The real form is /github notify <chat_id|reset>; the handler at _handle_github_notify accepts a chat ID (positive or negative integer) or the literal reset. [on|off] is the form used by /github reviews and /github triage, not /github notify.
2. /memory - Browse remembered facts by tag is wrong. The tag-browse axis was removed when the /memory dashboard was redesigned around a Facts/Episodes/Stats utility row. Tags now appear only as decoration on individual rows, not as a primary browse surface. Suggested wording: /memory - Browse remembered facts and episodes.
3. /memory forget <tag> is retired. The subcommand was removed; an unrecognized /memory <subcommand> falls through to the help text. The line should be deleted from /help.
4. /voice - Toggle voice on/off is misleading. The bare /voice command toggles between off and only (not off and on). Suggested wording: /voice - Toggle voice off / voice-only.
5. /voice off is missing as a separate line. The command is documented in the wiki and works at runtime; only /voice on, /voice only, and /voice <name> are listed under /voice in /help.
Suggested patch
In handle_help:
- Replace
"/github notify [on|off] - Toggle notifications\n" with "/github notify <chat_id|reset> - Route or reset notifications\n".
- Replace the
/memory block:
/memory - Browse remembered facts by tag
/memory search <q> - Semantic search over memories
/memory stats - Counts and confidence distribution
/memory forget <tag> - Delete all memories with a tag
/memory help - /memory subcommand reference
/memory - Browse remembered facts and episodes
/memory search <q> - Semantic search over memories
/memory stats - Counts and confidence distribution
/memory help - /memory subcommand reference
- Replace
"/voice - Toggle voice on/off\n" with "/voice - Toggle voice off / voice-only\n" and add "/voice off - Text only\n" so all four explicit modes are listed.
Acceptance
/help output matches the surface that the corresponding handlers actually accept.- The wiki Slash-Commands page already reflects the same forms (updated 2026-04-30); the in-bot text should agree with it.
The
/helptext inbot.py(inhandle_help) has drifted from the actual command surface. Five inaccuracies, plus one missing line:1.
/github notify [on|off]is wrong. The real form is/github notify <chat_id|reset>; the handler at_handle_github_notifyaccepts a chat ID (positive or negative integer) or the literalreset.[on|off]is the form used by/github reviewsand/github triage, not/github notify.2.
/memory - Browse remembered facts by tagis wrong. The tag-browse axis was removed when the/memorydashboard was redesigned around a Facts/Episodes/Stats utility row. Tags now appear only as decoration on individual rows, not as a primary browse surface. Suggested wording:/memory - Browse remembered facts and episodes.3.
/memory forget <tag>is retired. The subcommand was removed; an unrecognized/memory <subcommand>falls through to the help text. The line should be deleted from/help.4.
/voice - Toggle voice on/offis misleading. The bare/voicecommand toggles betweenoffandonly(notoffandon). Suggested wording:/voice - Toggle voice off / voice-only.5.
/voice offis missing as a separate line. The command is documented in the wiki and works at runtime; only/voice on,/voice only, and/voice <name>are listed under/voicein/help.Suggested patch
In
handle_help:"/github notify [on|off] - Toggle notifications\n"with"/github notify <chat_id|reset> - Route or reset notifications\n"./memoryblock:"/voice - Toggle voice on/off\n"with"/voice - Toggle voice off / voice-only\n"and add"/voice off - Text only\n"so all four explicit modes are listed.Acceptance
/helpoutput matches the surface that the corresponding handlers actually accept.