feat(migrations): enhance database migration checks and logging

- Added logic to check the current database revision before running migrations.
- Improved logging to indicate whether migrations are being run or if the database is already up to date.
- Updated the prefix management in the guild config to ensure cache is invalidated when prefixes are deleted or updated.
- Introduced a method to check if prefix override is enabled via environment variables in the settings.

Author: kzndotsh

src/tux/database/migrations/runner.py

@@ -83,10 +83,23 @@ async def upgrade_head_if_needed() -> None:
     def run_upgrade():
         """Run the upgrade in a separate thread with timeout."""
         cfg = _build_alembic_config()
-        logger.info("🔄 Running database migrations...")
+        logger.info("🔄 Checking database migrations...")
         try:
-            command.upgrade(cfg, "head")
-            logger.info("✅ Database migrations completed")
+            # Check current revision first
+            current_rev = command.current(cfg)
+            logger.debug(f"Current database revision: {current_rev}")
+
+            # Check if we need to upgrade
+            head_rev = command.heads(cfg)
+            logger.debug(f"Head revision: {head_rev}")
+
+            # Only run upgrade if we're not already at head
+            if current_rev != head_rev:
+                logger.info("🔄 Running database migrations...")
+                command.upgrade(cfg, "head")
+                logger.info("✅ Database migrations completed")
+            else:
+                logger.info("✅ Database is already up to date")
             return True
         except Exception as e:
             # Check if this is a database connection error

src/tux/modules/guild/config.py

@@ -348,6 +348,10 @@ async def config_set_prefix(
 
         await self.db_config.update_guild_prefix(interaction.guild.id, prefix)
 
+        # Update the prefix cache
+        if self.bot.prefix_manager:
+            await self.bot.prefix_manager.set_prefix(interaction.guild.id, prefix)
+
         await interaction.followup.send(
             embed=EmbedCreator.create_embed(
                 bot=self.bot,
@@ -380,6 +384,10 @@ async def config_clear_prefix(
 
         await self.db_config.delete_guild_prefix(interaction.guild.id)
 
+        # Update the prefix cache to use default prefix
+        if self.bot.prefix_manager:
+            self.bot.prefix_manager.invalidate_cache(interaction.guild.id)
+
         await interaction.followup.send(
             embed=EmbedCreator.create_embed(
                 bot=self.bot,

src/tux/shared/config/settings.py

@@ -139,6 +139,15 @@ def get_prefix(self) -> str:
         """Get command prefix for current environment."""
         return self.BOT_INFO.PREFIX
 
+    def is_prefix_override_enabled(self) -> bool:
+        """Check if prefix override is enabled by environment variable.
+
+        Returns True if BOT_INFO__PREFIX was explicitly set in environment variables,
+        indicating the user wants to override all database prefix settings.
+        """
+
+        return "BOT_INFO__PREFIX" in os.environ
+
     def is_debug_enabled(self) -> bool:
         """Check if debug mode is enabled."""
         return self.DEBUG