feat(bot): afk status with mention replies

[LucasSantana-Dev]

Summary

• Add user-initiated AFK status tracking per guild
• Slash command /afk [motivo] sets/clears status with optional reason
• Message handler auto-replies with AFK status when users are mentioned (max 3 per message)
• Auto-clears AFK status when user sends a message (replies with "welcome back")

Implementation

Prisma:

• Model AfkStatus with unique constraint on (guildId, userId)
• Migration 20260703051000_afk_status

Service:

• AfkService.ts with set/get/clear/getMany methods
• Exported from services barrel

Slash Command:

• /afk with optional motivo string argument (max 200 chars)
• Ephemeral replies only

Message Handler:

• Registered before xpHandler in pipeline
• Detects author AFK status and clears on message
• Detects mentioned user AFK statuses and replies (max 3)
• Never stops pipeline, catches all errors

Tests:

• afkHandler: 7 test cases (bot skip, author clear, mention replies, limits, errors)
• afk command: 5 test cases (set, clear, guild validation, errors)

Test Plan

• afkHandler tests: handler logic for clears and mention replies
• /afk command tests: command execution and error handling

---

Summary by cubic

Adds per-guild AFK with /afk and auto mention replies, plus opt-in starboard seeding and a one-time first-star DM. AFK clears when the user chats; replies are ephemeral and suppress mentions, and the bot’s seed reaction never counts toward starboard thresholds.

• New Features

  • AFK: /afk [motivo] sets/clears with reason (max 200). Message handler welcomes authors back, replies about mentioned users’ AFK (max 3), and never blocks the pipeline. AfkService exported from @lucky/shared/services; afkHandler registered.
  • Starboard: seedReaction auto-reacts with the guild emoji (starboard channel excluded; allowlist via seedChannelIds). firstStarDm sends an exactly-once DM per member (customizable via firstStarDmMessage). Reaction handler subtracts the bot’s seed; starboardSeedHandler registered.

• Migration

  • New: 20260703051000_afk_status adds Prisma model AfkStatus (unique (guildId, userId)), relates to Guild with FK cascade.
  • New: 20260703040000_starboard_seed_first_star_dm adds seedReaction, seedChannelIds, firstStarDm, firstStarDmMessage and starboard_dm_sents (unique (guildId, userId)). Run database migrations.

^{Written for commit 2f1b5ea. Summary will update on new commits.}

[coderabbitai]

Warning

Review limit reached

You’ve reached a temporary PR review limit under our Fair Usage Limits Policy.

Your recent review volume is higher than typical usage, so adaptive limits are currently applied.

Next review available in: 17 minutes

Your organization has reached its usage spending cap. Adjust your spending cap in the billing tab.

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 1e12e921-ae38-41be-be52-9ba8ed6b2fc8

📥 Commits

Reviewing files that changed from the base of the PR and between c54eaba and 2f1b5ea.

📒 Files selected for processing (10)

• packages/bot/src/functions/general/commands/__tests__/afk.test.ts
• packages/bot/src/functions/general/commands/afk.ts
• packages/bot/src/handlers/message/__tests__/afkHandler.test.ts
• packages/bot/src/handlers/message/afkHandler.ts
• packages/bot/src/handlers/message/index.ts
• packages/bot/src/handlers/messageHandler.ts
• packages/shared/src/services/AfkService.ts
• packages/shared/src/services/index.ts
• prisma/migrations/20260703051000_afk_status/migration.sql
• prisma/schema.prisma

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feat/afk-status

---

_{Comment @coderabbitai help to get the list of available commands.}

[cubic-dev-ai]

5 issues found across 10 files

<sub>Reply with feedback, questions, or to request a fix.

Re-trigger cubic</sub>

[cubic-dev-ai]

2 issues found across 14 files (changes from recent commits).

<sub>Reply with feedback, questions, or to request a fix.

Re-trigger cubic</sub>

[github-actions]

	Warnings
⚠️	User-facing change without a CHANGELOG.md update. Add a line under ## [Unreleased] if this should appear in release notes. (Or apply the skip-changelog label if this PR does not affect end users.)

Generated by 🚫 dangerJS against 2f1b5ea

[sonarqubecloud]

Quality Gate passed

Issues
2 New issues
0 Accepted issues

Measures
0 Security Hotspots
86.5% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud