Skip to content

Issue Reporting

Issue Reporting lets members submit bug reports and feature requests from Discord, then routes approved reports to GitHub.

Scope

  • Submission is Discord client-only through slash commands.
  • There is no dashboard module for Issues.
  • Reviews are handled in a private Discord review channel.
  • Approve/reject actions are currently restricted to the configured bot owner account.

Command Surface

  • /issue bug
  • /issue feature

Both commands open a modal to collect details.

Workflow

  1. A member submits /issue bug or /issue feature.
  2. The report is saved with pending status.
  3. A review message is posted in the configured review channel.
  4. Authorized reviewer clicks Approve or Reject.
  5. Approved reports create GitHub issues with category labels.
  6. User is notified by DM when possible.

Safeguards and Limits

  • Submissions are rate-limited per user to prevent abuse.
  • Title and content are validated/sanitized before storage.
  • Pending review views are restored automatically after bot restarts.

Operational Requirements

The issue reporter cog only loads when both are configured:

  • GITHUB_PAT
  • GITHUB_REVIEW_CHANNEL_ID

If either is missing, issue commands are not registered.