Skip to content

Feature Roadmap

Jump to bottom
Jason Tucker edited this page May 6, 2026 · 7 revisions

Feature Roadmap

A living document describing what's planned, why, and the concrete steps to ship it. Each feature also has a card on the Bot Development project board with a matching breakdown — bring those into "In Progress" when you start, and use the implementation steps below as the punch list.

Status legend

  • ✅ Shipped — running in production, documented, and wired into /help
  • 🟡 Infrastructure ready — schema and/or /sudo → Settings toggle exists, but the user-facing behavior hasn't been built
  • 🔵 Designed — concept agreed, scope written, no infrastructure yet
  • 💭 Idea — bullet on a napkin; needs more thought before estimating

✅ Recently shipped

The 0.7.x and 0.8.x lines covered most of the original Phase 5/6 backlog:

  • ✅ Auto voice channels with persistent control panel — hubs rename in place, replacement hub spawns, attached private text channel, sticky 📋 Open Panel button, reconciler on startup
  • ✅ Voice control panel buttons — Rename, Lock/Unlock, Hosts (single panel listing all members with rank emojis), Templates (Auto / Counter / Comp 5-stack / Tryhard / Chill), Claim, Delete
  • ✅ Random tech default channel names — Sloppy Ethernet style fallback when no rich-presence game is active
  • ✅ /report flow — modal → owner DM with Approve/Reject (notify or silent) → GitHub issue
  • ✅ /sudo → Settings panel — runtime config for sudo users, channels, voice cleanup delay, and the auto-thread channel list. Backed by bot_settings (key/value overrides), sudo_users (members granted sudo at runtime), and auto_thread_channels (the dynamic auto-thread list). See Slash Commands for the full sub-panel reference.
  • ✅ Auto Threads — channels added under /sudo → Settings → Auto Threads get a public thread on every non-bot message. Default thread name {author} — {first line} (100-char cap). Backed by auto_thread_channels. Requires the MessageContent privileged intent. Shipped as a single dynamic list rather than the per-channel feature flags originally drafted (clips/food were collapsed into one panel during implementation).
  • ✅ Hub Channels (dynamic) — /sudo → Settings → Hub Channels adds/removes hubs at runtime. HUB_CHANNEL_IDS env is now a one-time legacy seed list; the DB is authoritative. Reconciler-driven hub recreation, replacement-hub flow, and isHubChannel() are all cache-backed.
  • ✅ channel.auto_voice_category override — the AUTO_VOICE_CATEGORY_ID env value is now overridable from /sudo → Settings → Voice. Auto-channel creation, hub registration, and the reconciler all read via getSetting() ?? env.AUTO_VOICE_CATEGORY_ID.
  • ✅ User profile editor — sudo-side editor under /sudo → Settings → User Profiles and via right-click → Manage User → Edit Profile. Self-service via /profile. Sudo edits all fields; self mode covers display name, birthday, and opt-out toggles. Every edit logs a profile-edit line.
  • ✅ Birthday pings — daily scheduler that fires at the configured target hour (default 9). Members opt out via /profile. Idempotency via bot_settings.birthday.last_run_date. Feb 29 birthdays handled in non-leap years.

🔵 In progress / next up

Not features — operational items that unblock everything else.

  • Verify AUTO_VOICE_CATEGORY_ID and HUB_CHANNEL_IDS in .env are correct for the ITSRI guild — see issue #3
  • Enable Presence Intent in Discord Developer Portal — issue #4 (resolved)
  • GitHub Actions auto-deploy on push to main — done end-to-end

🟡 Game role + channel management — Phase 12

The largest planned feature. Three coordinated pieces: definitions, opt-in, and pings.

What it does. Members opt into game-specific Discord roles. Each game has an associated channel (or category), an optional separate "ping role" used only for LFG pings, and visibility/archive toggles. /play <game> lets opted-in members ping the ping-role for a session, with metadata like party size and time.

Infrastructure already in place.

  • games schema: name, role_id, channel_id, category_id, ping_role_id, is_archived, is_visible, sort_order, aliases
  • user_game_prefs schema: per-user opt-in for view + ping
  • /sudo → Settings → Games placeholder panel (read-only count)

Missing — implementation steps.

Step 1 — Definitions (sudo-side).

  1. Replace the Games placeholder panel with a list view + add/edit/archive flow. Adding a game: name, optional aliases, role picker (or "create new role" button), channel picker, ping-role picker (optional, defaults to view role), category picker, sort order.
  2. CRUD operations + audit log entries for adds/removes/archive.

Step 2 — Member opt-in. 3. New /games command — opens a paginated select with all is_visible=true && is_archived=false games. Per-game: a row of two buttons, "View access" and "LFG pings", that toggle user_game_prefs.view_enabled and .ping_enabled. Toggling view assigns/removes the view role on Discord; toggling ping does the same for the ping role. 4. Hide archived games from the list.

Step 3 — /play LFG pings. 5. New /play <game> command with options: party_size? (int 1–32), when? (string), platform?, rank?, message? (free text 200 chars). 6. Resolve game via name or aliases (case-insensitive). 7. Post in the game's channel; ping ping_role_id. Format: ${pingRoleMention} **LFG: ${game}** — host ${authorMention}, ${partySize} needed, ${when}\n${message}. 8. Rate limiting — store last /play time per (guild_id, user_id, game_id) in a new play_pings table; reject if < 30 minutes since last. Sudo can override. 9. Anti-abuse — never @everyone or @here regardless of options. Sanitize message to strip role/user mentions outside of the host's allowed set.

Step 4 — Polish. 10. /games list shows current member count per game (pull live from the role). 11. Sort order respected in /games list. 12. Migrating archived games — keep the role but stop showing in /games.

Step 5 — Docs + project hygiene. 13. README, /help, wiki Slash-Commands + Database-Schema, CHANGELOG. 14. Move all sub-tasks above into individual project items if scope creeps; otherwise keep under one card with checkboxes.

Acceptance criteria.

  • Sudo can add a new game in under a minute via /sudo → Settings → Games.
  • A regular member can opt into View + Pings for two games via /games and see the new roles immediately.
  • /play valorant party_size:5 when:9pm pings the right role in the right channel and is rate-limited.
  • Archived games disappear from /games but existing role memberships are preserved.

💭 Ideas backlog

Light sketches — bring one to "Designed" status before it goes on the project board.

  • Voice channel "party" / LFG mode — members in an auto-channel can mark themselves LFG; the channel name appends (LFG x/y) and a button lets others join.
  • Auto-name cycling — if the rich-presence game changes mid-session, the auto-channel name updates to match (with rate-limit guards — Discord limits channel renames to 2/10min).
  • Voice channel stats — per-channel/-hub time totals, peak concurrent counts, top creators per month. Read-only sudo dashboard.
  • OC-style stock widget for other businesses — port otterbot's oc_stock pattern if a non-MKE business in the server wants the same kind of board.
  • External webhook intake — POST /webhook/<token> endpoint that posts to a configured channel (e.g. for GitHub Actions completion notices, Grafana alerts). Would require a small HTTP server alongside the Discord client.
  • Configurable thread archive duration — extend the auto-thread feature to expose 60/1440/4320/10080 minutes per channel.

How to use this roadmap

  1. When you start working on a feature, move its project board card to In Progress.
  2. Add a corresponding ## [Unreleased] entry in CHANGELOG.md with the same name.
  3. Treat the implementation steps above as a checklist — tick them off in commit messages or PR description.
  4. When the feature ships, move the card to Done, mark the row above ✅ Shipped, and prune steps from this page (keep the headline + 1-line summary so the history is readable).

Clone this wiki locally