feat(afk.py): add detailed logging for AFK entries to aid in debugging

Add loguru logger to provide detailed debug information about AFK
entries in a guild. This includes total entries and specifics of each
entry, such as member ID, expiration status, and enforcement status.
This change helps in diagnosing issues related to AFK entries.

perf(afk.py): reduce AFK expiration check interval to 30 seconds

Decrease the interval for the AFK expiration handler from 120 seconds
to 30 seconds. This change ensures that expired AFK entries are
processed more frequently, improving the responsiveness of the system
to changes in AFK status.

Author: kzndotsh

src/tux/database/controllers/afk.py

@@ -10,6 +10,8 @@
 from datetime import UTC, datetime
 from typing import TYPE_CHECKING, Any
 
+from loguru import logger
+
 from tux.database.controllers.base import BaseController
 from tux.database.models import AFK
 
@@ -279,11 +281,26 @@ async def get_expired_afk_members(self, guild_id: int) -> list[AFK]:
         """
         # Database stores naive UTC datetimes, use naive for comparison
         now = datetime.now(UTC).replace(tzinfo=None)
-        return await self.find_all(
+
+        # First, get ALL AFK entries for this guild to debug
+        all_entries = await self.find_all(filters=AFK.guild_id == guild_id)
+        logger.debug(
+            f"Total AFK entries in guild {guild_id}: {len(all_entries)}",
+        )
+        for entry in all_entries:
+            logger.debug(
+                f"AFK entry: member={entry.member_id}, until={entry.until}, "
+                f"perm_afk={entry.perm_afk}, enforced={entry.enforced}, "
+                f"expired={entry.until < now if entry.until else 'N/A'}",
+            )
+
+        expired = await self.find_all(
             filters=(
                 (AFK.guild_id == guild_id)
                 & (AFK.perm_afk == False)  # noqa: E712 - Temporary AFK only
                 & (AFK.until.is_not(None))  # type: ignore[attr-defined]
                 & (AFK.until < now)  # type: ignore[arg-type]
             ),
         )
+        logger.debug(f"Expired AFK entries found: {len(expired)}")
+        return expired

src/tux/modules/utility/afk.py

@@ -415,7 +415,7 @@ async def check_afk(self, message: discord.Message) -> None:
                 f"Error in check_afk listener for message {message.id}: {e}",
             )
 
-    @tasks.loop(seconds=120, name="afk_expiration_handler")
+    @tasks.loop(seconds=30, name="afk_expiration_handler")
     async def handle_afk_expiration(self) -> None:
         """Check AFK database at a regular interval, remove AFK from users with an entry that has expired."""
         # Skip AFK expiration processing during maintenance mode
@@ -474,7 +474,7 @@ async def handle_afk_expiration(self) -> None:
     async def before_handle_afk_expiration(self) -> None:
         """Wait until the bot is ready."""
         await self.bot.wait_until_ready()
-        logger.info("AFK expiration handler started (runs every 120 seconds)")
+        logger.info("AFK expiration handler started (runs every 30 seconds)")
 
     @handle_afk_expiration.error
     async def on_handle_afk_expiration_error(self, error: BaseException) -> None: