Summary
Add a /help command listing all available bot commands, categorized, before the command surface grows past the point where users can guess what exists.
Background
Today the bot has zero interactive commands (only the passive new_chat_members handler). Issue #4 ("Add /pr and /repo on-demand Telegram commands") is the first to introduce commands at all, and this batch adds several more (/ping, /uptime, /claim, /unclaim, /goodfirstissue, /stats, /license, /coc, /feedback, /botbug). Without a /help command, none of these are discoverable — a new group member has no way to know they exist.
Proposed Solution
A bot.command("help", ...) handler that returns a static, categorized list of available commands and their descriptions, maintained alongside command registration (either a manually-updated list or generated from a shared command registry if one gets introduced).
Technical Scope
src/telegram/client.ts — new bot.command("help", ...) handler
- Depends on the other command-adding issues in this batch for the actual content of the menu; can ship with whatever commands already exist and be extended incrementally
- Tests: help output includes all currently-registered commands
Acceptance Criteria
Edge Cases
- Command list grows long enough to approach Telegram's 4096-character message limit — consider pagination or category-specific
/help <category> if so
- New commands added without updating
/help — flag this risk explicitly rather than silently allowing drift
Risks
- If the command list isn't generated from a single source of truth, it will drift from reality as commands are added/removed over time — worth deciding up front whether to accept manual maintenance or invest in a registry
Deliverables
- Feature implementation
- Unit tests
Labels
enhancement, backend, good first issue
Priority
Medium — becomes necessary as soon as more than one or two commands exist; sequence after the first commands land.
Estimated Completion: 96 hours
Telegram: https://t.me/txioCommunity
Summary
Add a
/helpcommand listing all available bot commands, categorized, before the command surface grows past the point where users can guess what exists.Background
Today the bot has zero interactive commands (only the passive
new_chat_membershandler). Issue #4 ("Add /pr and /repo on-demand Telegram commands") is the first to introduce commands at all, and this batch adds several more (/ping,/uptime,/claim,/unclaim,/goodfirstissue,/stats,/license,/coc,/feedback,/botbug). Without a/helpcommand, none of these are discoverable — a new group member has no way to know they exist.Proposed Solution
A
bot.command("help", ...)handler that returns a static, categorized list of available commands and their descriptions, maintained alongside command registration (either a manually-updated list or generated from a shared command registry if one gets introduced).Technical Scope
src/telegram/client.ts— newbot.command("help", ...)handlerAcceptance Criteria
/helplists every registered command with a one-line descriptionEdge Cases
/help <category>if so/help— flag this risk explicitly rather than silently allowing driftRisks
Deliverables
Labels
enhancement, backend, good first issue
Priority
Medium — becomes necessary as soon as more than one or two commands exist; sequence after the first commands land.
Estimated Completion: 96 hours
Telegram: https://t.me/txioCommunity