kythia-core 0.9.5-beta → 0.10.1-beta

package/src/managers/AddonManager.js

@@ -4,7 +4,7 @@
  * @file src/managers/AddonManager.js
  * @copyright © 2025 kenndeclouv
  * @assistant chaa & graa
- * @version 0.9.5-beta
+ * @version 0.10.0-beta
  *
  * @description
  * Handles all addon loading, command registration, and component management.
@@ -13,954 +13,1198 @@
  */
 
 const {
-    SlashCommandBuilder,
-    SlashCommandSubcommandBuilder,
-    SlashCommandSubcommandGroupBuilder,
-    Collection,
-    ContextMenuCommandBuilder,
-    ApplicationCommandType,
+	SlashCommandBuilder,
+	SlashCommandSubcommandBuilder,
+	SlashCommandSubcommandGroupBuilder,
+	Collection,
+	ContextMenuCommandBuilder,
+	ApplicationCommandType,
 } = require('discord.js');
-const path = require('path');
-const fs = require('fs');
+const path = require('node:path');
+const fs = require('node:fs');
 
 class AddonManager {
-    /**
-     * 🗝️ AddonManager Constructor
-     * Initializes the addon manager with necessary collections and maps.
-     * @param {Object} client - Discord client instance
-     * @param {Object} container - Dependency container
-     */
-    constructor({ client, container }) {
-        this.client = client;
-        this.container = container;
-        this.logger = this.container.logger;
-
-        this.buttonHandlers = new Map();
-        this.modalHandlers = new Map();
-        this.selectMenuHandlers = new Map();
-        this.autocompleteHandlers = new Map();
-        this.commandCategoryMap = new Map();
-        this.categoryToFeatureMap = new Map();
-        this.embedDrafts = new Collection();
-        this.eventHandlers = new Map();
-    }
-
-    /**
-     * 🔘 Register Button Handler
-     * Registers a handler function for a specific button customId.
-     * @param {string} customId - The customId of the button
-     * @param {Function} handler - The handler function to execute
-     */
-    registerButtonHandler(customId, handler) {
-        if (this.buttonHandlers.has(customId)) {
-            this.logger.warn(`[REGISTRATION] Warning: Button handler for [${customId}] already exists and will be overwritten.`);
-        }
-        this.buttonHandlers.set(customId, handler);
-    }
-    /**
-     * 🔽 Register Select Menu Handler
-     * Registers a handler function for a specific select menu customId prefix.
-     * @param {string} customIdPrefix - The prefix of the select menu customId
-     * @param {Function} handler - The handler function to execute
-     */
-    registerSelectMenuHandler(customIdPrefix, handler) {
-        if (this.selectMenuHandlers.has(customIdPrefix)) {
-            this.logger.warn(`[REGISTRATION] Warning: Select menu handler for [${customIdPrefix}] already exists and will be overwritten.`);
-        }
-        this.selectMenuHandlers.set(customIdPrefix, handler);
-    }
-
-    /**
-     * 📝 Register Modal Handler
-     * Registers a handler function for a modal, using a prefix of the customId.
-     * @param {string} customIdPrefix - The prefix of the modal customId
-     * @param {Function} handler - The handler function to execute
-     */
-    registerModalHandler(customIdPrefix, handler) {
-        if (this.modalHandlers.has(customIdPrefix)) {
-            this.logger.warn(`[REGISTRATION] Warning: Modal handler for [${customIdPrefix}] already exists and will be overwritten.`);
-        }
-        this.modalHandlers.set(customIdPrefix, handler);
-    }
-
-    /**
-     * 📋 Register Autocomplete Handler
-     * Registers a handler for autocomplete interactions for a specific command or subcommand.
-     * @param {string} commandName - The command or subcommand key
-     * @param {Function} handler - The autocomplete handler function
-     */
-    registerAutocompleteHandler(commandName, handler) {
-        if (this.autocompleteHandlers.has(commandName)) {
-            this.logger.warn(`[REGISTRATION] Warning: Autocomplete handler for [${commandName}] already exists and will be overwritten.`);
-        }
-        this.autocompleteHandlers.set(commandName, handler);
-    }
-
-    /**
-     * 🔍 Check if module is a BaseCommand class
-     * @param {any} module - The module to check
-     * @returns {boolean} True if module is a class extending BaseCommand
-     * @private
-     */
-    _isBaseCommandClass(module) {
-        if (typeof module !== 'function') return false;
-        if (!module.prototype) return false;
-
-        const hasExecute = typeof module.prototype.execute === 'function';
-        return hasExecute;
-    }
-
-    /**
-     * 🏗️ Instantiate and prepare BaseCommand class
-     * @param {Function} CommandClass - The command class to instantiate
-     * @returns {Object} Command instance with proper structure
-     * @private
-     */
-    _instantiateBaseCommand(CommandClass) {
-        try {
-            return new CommandClass(this.container);
-        } catch (error) {
-            this.logger.error(`Failed to instantiate BaseCommand class:`, error);
-            throw error;
-        }
-    }
-
-    /**
-     * INTERNAL: Creates a Builder instance (Slash, Subcommand, Group) from a module's data property.
-     * @param {Object} data - The data property (can be function, builder, or object)
-     * @param {Class} BuilderClass - The d.js class to use (SlashCommandBuilder, etc.)
-     * @returns {SlashCommandBuilder|SlashCommandSubcommandBuilder|SlashCommandSubcommandGroupBuilder}
-     * @private
-     */
-    _createBuilderFromData(data, BuilderClass) {
-        let builder = new BuilderClass();
-
-        if (typeof data === 'function') {
-            data(builder);
-        } else if (data instanceof BuilderClass) {
-            builder = data;
-        } else if (typeof data === 'object') {
-            builder.setName(data.name || 'unnamed');
-            builder.setDescription(data.description || 'No description');
-
-            if (BuilderClass === SlashCommandBuilder) {
-                builder.setDescription(data.description || 'No description');
-                if (data.permissions) {
-                    builder.setDefaultMemberPermissions(data.permissions);
-                }
-                if (data.guildOnly !== undefined) {
-                    builder.setDMPermission(!data.guildOnly);
-                }
-            } else if (BuilderClass === ContextMenuCommandBuilder) {
-                builder.setType(data.type || ApplicationCommandType.User);
-                if (data.permissions) {
-                    builder.setDefaultMemberPermissions(data.permissions);
-                }
-                if (data.guildOnly !== undefined) {
-                    builder.setDMPermission(!data.guildOnly);
-                }
-            }
-        }
-        return builder;
-    }
-
-    /**
-     * 📝 Register Command Helper
-     * Registers a single command file/module, adds it to the command collection, and prepares it for deployment.
-     * @param {Object} module - The command module
-     * @param {string} filePath - The file path of the command
-     * @param {Set} commandNamesSet - Set of already registered command names
-     * @param {Array} commandDataForDeployment - Array to collect command data for deployment
-     * @param {Object} permissionDefaults - Permission defaults for the command
-     * @param {Object} options - Additional options (e.g., folderName)
-     * @returns {Object|null} Summary object for logging, or null if not registered
-     */
-    registerCommand(module, filePath, commandNamesSet, commandDataForDeployment, permissionDefaults = {}, options = {}) {
-        if (this._isBaseCommandClass(module)) {
-            module = this._instantiateBaseCommand(module);
-        }
-
-        if (!module || !module.data) return null;
-
-        let builderClass;
-
-        if (module.data instanceof ContextMenuCommandBuilder) {
-            builderClass = ContextMenuCommandBuilder;
-        } else {
-            builderClass = SlashCommandBuilder;
-        }
-
-        let commandBuilder = this._createBuilderFromData(module.data, builderClass);
-
-        const commandName = commandBuilder.name;
-        const category = options.folderName || path.basename(path.dirname(filePath));
-
-        const categoryDefaults = permissionDefaults[category] || {};
-        const finalCommand = {
-            ...categoryDefaults,
-            ...module,
-        };
-
-        this.commandCategoryMap.set(commandName, category);
-        if (commandNamesSet.has(commandName)) {
-            throw new Error(`Duplicate command name detected: "${commandName}" in ${filePath}`);
-        }
-
-        commandNamesSet.add(commandName);
-        this.client.commands.set(commandName, finalCommand);
-        commandDataForDeployment.push(commandBuilder.toJSON());
-
-        if (typeof finalCommand.autocomplete === 'function') {
-            this.registerAutocompleteHandler(commandName, finalCommand.autocomplete);
-        }
-
-        return {
-            type: 'single',
-            name: commandName,
-            folder: category,
-        };
-    }
-
-    /**
-     * 🧩 Load Addons & Register Commands/Events
-     * Loads all addons from the addons directory, registers their commands, events, and components.
-     * @param {Object} kythiaInstance - The main Kythia instance for addon registration
-     * @returns {Promise<Array>} Array of command data for deployment
-     */
-    async loadAddons(kythiaInstance) {
-        this.logger.info('🔌 Loading & Registering Kythia Addons...');
-        const commandDataForDeployment = [];
-        const addonsDir = path.join(this.container.appRoot, 'addons');
-        if (!fs.existsSync(addonsDir)) return commandDataForDeployment;
-
-        let addonFolders = fs.readdirSync(addonsDir, { withFileTypes: true }).filter((d) => d.isDirectory() && !d.name.startsWith('_'));
-
-        let coreAddon = addonFolders.find((d) => d.name === 'core');
-        let otherAddons = addonFolders.filter((d) => d.name !== 'core');
-        if (coreAddon) {
-            addonFolders = [coreAddon, ...otherAddons];
-        }
-
-        const commandNamesSet = new Set();
-        const addonSummaries = [];
-
-        for (const addon of addonFolders) {
-            const addonDir = path.join(addonsDir, addon.name);
-            let addonVersion = 'v0.0.0-alpha';
-
-            try {
-                const addonJsonPath = path.join(addonDir, 'addon.json');
-                if (fs.existsSync(addonJsonPath)) {
-                    let addonJson;
-                    try {
-                        const addonJsonRaw = fs.readFileSync(addonJsonPath, 'utf8');
-                        addonJson = JSON.parse(addonJsonRaw);
-                    } catch (jsonErr) {
-                        this.logger.warn(`🔴 Failed to parse addon.json for ${addon.name}: ${jsonErr.message}`);
-                        continue;
-                    }
-
-                    addonVersion = addonJson.version || 'v0.0.0-alpha';
-                    if (addonJson.active === false) {
-                        this.logger.info(`🟠 Addon ${addon.name.toUpperCase()} disabled`);
-                        continue;
-                    }
-                    if (addonJson.featureFlag) {
-                        this.commandCategoryMap.set(addon.name, addon.name);
-                        this.categoryToFeatureMap.set(addon.name, addonJson.featureFlag);
-                    }
-                } else {
-                    this.logger.warn(`🔴 Addon ${addon.name.toUpperCase()} is missing addon.json. Skipping.`);
-                    continue;
-                }
-            } catch (e) {
-                this.logger.warn(`🔴 Error reading addon.json for ${addonDir}: ${e.message}`);
-                continue;
-            }
-
-            try {
-                const configAddons = this.container.kythiaConfig?.addons || {};
-                if (configAddons.all?.active === false) {
-                    this.logger.info(`🟠 Addon ${addon.name.toUpperCase()} disabled via kythia config`);
-                    continue;
-                } else if (configAddons[addon.name]?.active === false) {
-                    this.logger.info(`🟠 Addon ${addon.name.toUpperCase()} disabled via kythia config`);
-                    continue;
-                }
-            } catch (e) {
-                this.logger.warn(`🔴 Error checking config for addon ${addon.name.toUpperCase()}: ${e.message}`);
-            }
-
-            let addonPermissionDefaults = {};
-            const permissionsFilePath = path.join(addonDir, 'permissions.js');
-
-            if (fs.existsSync(permissionsFilePath)) {
-                try {
-                    addonPermissionDefaults = require(permissionsFilePath);
-                    this.logger.info(`  └─> Found and loaded permission defaults for addon '${addon.name.toUpperCase()}'`);
-                } catch (e) {
-                    this.logger.warn(`  └─> Failed to load permissions.js for addon '${addon.name.toUpperCase()}': ${e.message}`);
-                }
-            }
-
-            const loadedCommandsSummary = [];
-            const loadedEventsSummary = [];
-            const loadedRegisterSummary = [];
-
-            const commandsPath = path.join(addonDir, 'commands');
-            if (fs.existsSync(commandsPath)) {
-                try {
-                    const commandsResult = await this._loadCommandsFromPath(
-                        commandsPath,
-                        addon,
-                        addonPermissionDefaults,
-                        commandNamesSet,
-                        commandDataForDeployment
-                    );
-                    loadedCommandsSummary.push(...commandsResult);
-                } catch (error) {
-                    this.logger.error(`❌ Failed to load commands from addon "${addon.name}":`, error);
-                }
-            }
-
-            const registerPath = path.join(addonDir, 'register.js');
-            if (fs.existsSync(registerPath)) {
-                try {
-                    const registration = require(registerPath);
-                    if (typeof registration.initialize === 'function') {
-                        const registrationSummary = await registration.initialize(kythiaInstance);
-                        if (Array.isArray(registrationSummary) && registrationSummary.length > 0) {
-                            loadedRegisterSummary.push(...registrationSummary);
-                        }
-                    }
-                } catch (error) {
-                    this.logger.error(`❌ Failed to register components for [${addon.name}]:`, error);
-                }
-            }
-
-            const eventsPath = path.join(addonDir, 'events');
-            if (fs.existsSync(eventsPath)) {
-                const eventFiles = fs.readdirSync(eventsPath).filter((file) => file.endsWith('.js'));
-                for (const file of eventFiles) {
-                    const eventName = path.basename(file, '.js');
-                    try {
-                        const eventHandler = require(path.join(eventsPath, file));
-                        if (typeof eventHandler === 'function') {
-                            if (!this.eventHandlers.has(eventName)) {
-                                this.eventHandlers.set(eventName, []);
-                            }
-                            this.eventHandlers.get(eventName).push(eventHandler);
-                            loadedEventsSummary.push(eventName);
-                        }
-                    } catch (error) {
-                        this.logger.error(`❌ Failed to register event [${eventName}] for [${addon.name}]:`, error);
-                    }
-                }
-            }
-
-            addonSummaries.push({
-                name: addon.name,
-                version: addonVersion,
-                commands: loadedCommandsSummary,
-                events: loadedEventsSummary,
-                register: loadedRegisterSummary,
-            });
-        }
-
-        this._logAddonSummary(addonSummaries);
-        return commandDataForDeployment;
-    }
-
-    /**
-     * Load commands from a specific path
-     * @private
-     */
-    async _loadCommandsFromPath(commandsPath, addon, addonPermissionDefaults, commandNamesSet, commandDataForDeployment) {
-        const loadedCommandsSummary = [];
-        const isTopLevelCommandGroup = fs.existsSync(path.join(commandsPath, '_command.js'));
-
-        if (isTopLevelCommandGroup) {
-            return await this._loadTopLevelCommandGroup(
-                commandsPath,
-                addon,
-                addonPermissionDefaults,
-                commandNamesSet,
-                commandDataForDeployment
-            );
-        } else {
-            return await this._loadIndividualCommands(
-                commandsPath,
-                addon,
-                addonPermissionDefaults,
-                commandNamesSet,
-                commandDataForDeployment
-            );
-        }
-    }
-
-    /**
-     * Load top-level command group (supports BaseCommand classes)
-     * @private
-     */
-    async _loadTopLevelCommandGroup(commandsPath, addon, addonPermissionDefaults, commandNamesSet, commandDataForDeployment) {
-        const loadedCommandsSummary = [];
-        let commandDef = require(path.join(commandsPath, '_command.js'));
-
-        if (this._isBaseCommandClass(commandDef)) {
-            commandDef = this._instantiateBaseCommand(commandDef);
-        }
-
-        let mainBuilder = this._createBuilderFromData(commandDef.data, SlashCommandBuilder);
-
-        const mainCommandName = mainBuilder.name;
-
-        if (commandDef.featureFlag) {
-            this.commandCategoryMap.set(mainCommandName, addon.name);
-            this.categoryToFeatureMap.set(addon.name, commandDef.featureFlag);
-        }
-        this.commandCategoryMap.set(mainCommandName, addon.name);
-
-        if (commandNamesSet.has(mainCommandName)) throw new Error(`Duplicate command name: ${mainCommandName}`);
-        commandNamesSet.add(mainCommandName);
-
-        this.client.commands.set(mainCommandName, commandDef);
-
-        if (typeof commandDef.autocomplete === 'function') {
-            this.registerAutocompleteHandler(mainCommandName, commandDef.autocomplete);
-        }
-
-        const loadedSubcommandsSummary = [];
-        const contents = fs.readdirSync(commandsPath, { withFileTypes: true });
-
-        for (const item of contents) {
-            const itemPath = path.join(commandsPath, item.name);
-
-            if (item.isFile() && item.name.endsWith('.js') && !item.name.startsWith('_')) {
-                let subModule = require(itemPath);
-
-                const isSubcommand = subModule.subcommand === true || this._isBaseCommandClass(subModule);
-
-                if (this._isBaseCommandClass(subModule)) {
-                    subModule = this._instantiateBaseCommand(subModule);
-                }
-
-                if (!isSubcommand) continue;
-                if (!subModule.data) continue;
-
-                const subBuilder = this._createBuilderFromData(subModule.data, SlashCommandSubcommandBuilder);
-
-                mainBuilder.addSubcommand(subBuilder);
-                this.client.commands.set(`${mainCommandName} ${subBuilder.name}`, subModule);
-
-                if (typeof subModule.autocomplete === 'function') {
-                    this.registerAutocompleteHandler(`${mainCommandName} ${subBuilder.name}`, subModule.autocomplete);
-                }
-
-                loadedSubcommandsSummary.push(subBuilder.name);
-            } else if (item.isDirectory()) {
-                const groupDefPath = path.join(itemPath, '_group.js');
-
-                if (!fs.existsSync(groupDefPath)) {
-                    continue;
-                }
-
-                try {
-                    let groupModule = require(groupDefPath);
-
-                    if (this._isBaseCommandClass(groupModule)) {
-                        groupModule = this._instantiateBaseCommand(groupModule);
-                    }
-
-                    if (!groupModule.data) continue;
-
-                    const groupBuilder = this._createBuilderFromData(groupModule.data, SlashCommandSubcommandGroupBuilder);
-
-                    const subcommandsInGroupSummary = [];
-                    const subCommandFiles = fs.readdirSync(itemPath).filter((f) => f.endsWith('.js') && !f.startsWith('_'));
-
-                    for (const file of subCommandFiles) {
-                        const subCommandPath = path.join(itemPath, file);
-                        let subModule = require(subCommandPath);
-
-                        if (this._isBaseCommandClass(subModule)) {
-                            subModule = this._instantiateBaseCommand(subModule);
-                        }
-
-                        if (!subModule.data) continue;
-
-                        const subBuilder = this._createBuilderFromData(subModule.data, SlashCommandSubcommandBuilder);
-
-                        groupBuilder.addSubcommand(subBuilder);
-
-                        const commandKey = `${mainCommandName} ${groupBuilder.name} ${subBuilder.name}`;
-
-                        this.client.commands.set(commandKey, subModule);
-
-                        if (typeof subModule.autocomplete === 'function') {
-                            this.registerAutocompleteHandler(commandKey, subModule.autocomplete);
-                        }
-
-                        subcommandsInGroupSummary.push(subBuilder.name);
-                    }
-
-                    mainBuilder.addSubcommandGroup(groupBuilder);
-
-                    loadedSubcommandsSummary.push({ group: groupBuilder.name, subcommands: subcommandsInGroupSummary });
-                } catch (e) {
-                    this.logger.error(`❌ Failed to load subcommand group from ${itemPath}:`, e);
-                }
-            }
-        }
-
-        commandDataForDeployment.push(mainBuilder.toJSON());
-        loadedCommandsSummary.push({ type: 'group', name: mainCommandName, subcommands: loadedSubcommandsSummary });
-
-        return loadedCommandsSummary;
-    }
-
-    /**
-     * Load individual commands (supports BaseCommand classes)
-     * @private
-     */
-    async _loadIndividualCommands(commandsPath, addon, addonPermissionDefaults, commandNamesSet, commandDataForDeployment) {
-        const loadedCommandsSummary = [];
-        const commandItems = fs.readdirSync(commandsPath, { withFileTypes: true });
-
-        for (const item of commandItems) {
-            const itemPath = path.join(commandsPath, item.name);
-
-            if (item.isDirectory() && fs.existsSync(path.join(itemPath, '_command.js'))) {
-                let commandDef = require(path.join(itemPath, '_command.js'));
-                if (this._isBaseCommandClass(commandDef)) {
-                    commandDef = this._instantiateBaseCommand(commandDef);
-                }
-                let mainBuilder = this._createBuilderFromData(commandDef.data, SlashCommandBuilder);
-                const mainCommandName = mainBuilder.name;
-
-                if (commandDef.featureFlag) {
-                    this.commandCategoryMap.set(mainCommandName, addon.name);
-                    this.categoryToFeatureMap.set(addon.name, commandDef.featureFlag);
-                }
-                if (commandNamesSet.has(mainCommandName)) throw new Error(`Duplicate name: ${mainCommandName}`);
-                commandNamesSet.add(mainCommandName);
-                this.client.commands.set(mainCommandName, commandDef);
-                if (typeof commandDef.autocomplete === 'function') {
-                    this.registerAutocompleteHandler(mainCommandName, commandDef.autocomplete);
-                }
-
-                const subcommandsList = [];
-                const groupContents = fs.readdirSync(itemPath, { withFileTypes: true });
-
-                for (const content of groupContents) {
-                    const contentPath = path.join(itemPath, content.name);
-
-                    if (content.isFile() && content.name.endsWith('.js') && !content.name.startsWith('_')) {
-                        let subModule = require(contentPath);
-                        if (this._isBaseCommandClass(subModule)) {
-                            subModule = this._instantiateBaseCommand(subModule);
-                        }
-                        if (!subModule.data) continue;
-                        let subBuilder = this._createBuilderFromData(subModule.data, SlashCommandSubcommandBuilder);
-                        mainBuilder.addSubcommand(subBuilder);
-                        this.client.commands.set(`${mainCommandName} ${subBuilder.name}`, subModule);
-                        if (typeof subModule.autocomplete === 'function') {
-                            this.registerAutocompleteHandler(`${mainCommandName} ${subBuilder.name}`, subModule.autocomplete);
-                        }
-                        subcommandsList.push(subBuilder.name);
-                    } else if (content.isDirectory() && fs.existsSync(path.join(contentPath, '_group.js'))) {
-                        let groupDef = require(path.join(contentPath, '_group.js'));
-                        if (this._isBaseCommandClass(groupDef)) {
-                            groupDef = this._instantiateBaseCommand(groupDef);
-                        }
-                        let groupBuilder = this._createBuilderFromData(groupDef.data, SlashCommandSubcommandGroupBuilder);
-                        const subGroupList = [];
-                        const subGroupContents = fs.readdirSync(contentPath, { withFileTypes: true });
-                        for (const subSubItem of subGroupContents) {
-                            if (subSubItem.isFile() && subSubItem.name.endsWith('.js') && !subSubItem.name.startsWith('_')) {
-                                const subSubPath = path.join(contentPath, subSubItem.name);
-                                let subSubModule = require(subSubPath);
-                                if (this._isBaseCommandClass(subSubModule)) {
-                                    subSubModule = this._instantiateBaseCommand(subSubModule);
-                                }
-                                if (!subSubModule.data) continue;
-                                let subSubBuilder = this._createBuilderFromData(subSubModule.data, SlashCommandSubcommandBuilder);
-                                groupBuilder.addSubcommand(subSubBuilder);
-                                this.client.commands.set(`${mainCommandName} ${groupBuilder.name} ${subSubBuilder.name}`, subSubModule);
-                                if (typeof subSubModule.autocomplete === 'function') {
-                                    this.registerAutocompleteHandler(
-                                        `${mainCommandName} ${groupBuilder.name} ${subSubBuilder.name}`,
-                                        subSubModule.autocomplete
-                                    );
-                                }
-                                subGroupList.push(subSubBuilder.name);
-                            }
-                        }
-                        mainBuilder.addSubcommandGroup(groupBuilder);
-                        subcommandsList.push({ group: groupBuilder.name, subcommands: subGroupList });
-                    }
-                }
-                commandDataForDeployment.push(mainBuilder.toJSON());
-                loadedCommandsSummary.push({ type: 'group', name: mainCommandName, subcommands: subcommandsList });
-            } else if (item.isFile() && item.name.endsWith('.js') && !item.name.startsWith('_')) {
-                let commandModule = require(itemPath);
-                let isClass = false;
-                if (this._isBaseCommandClass(commandModule)) {
-                    commandModule = this._instantiateBaseCommand(commandModule);
-                    isClass = true;
-                }
-
-                if (!isClass && commandModule.subcommand) continue;
-
-                let summarySlash = null;
-                let summaryContext = null;
-
-                if (commandModule.slashCommand) {
-                    const builder = commandModule.slashCommand;
-                    const name = builder.name;
-                    try {
-                        const allLocales = this.container.translator.getLocales();
-                        let nameLocalizations = {};
-                        let descriptionLocalizations = {};
-                        if (typeof allLocales.entries === 'function') {
-                            for (const [lang, translations] of allLocales.entries()) {
-                                const nameKey = `command_${name}_name`;
-                                const descKey = `command_${name}_desc`;
-                                if (translations[nameKey]) nameLocalizations[lang] = translations[nameKey];
-                                if (translations[descKey]) descriptionLocalizations[lang] = translations[descKey];
-                            }
-                        } else {
-                            for (const lang in allLocales) {
-                                const translations = allLocales[lang];
-                                const nameKey = `command_${name}_name`;
-                                const descKey = `command_${name}_desc`;
-                                if (translations[nameKey]) nameLocalizations[lang] = translations[nameKey];
-                                if (translations[descKey]) descriptionLocalizations[lang] = translations[descKey];
-                            }
-                        }
-                        if (Object.keys(nameLocalizations).length > 0) {
-                            builder.setNameLocalizations(nameLocalizations);
-                        }
-                        if (Object.keys(descriptionLocalizations).length > 0) {
-                            builder.setDescriptionLocalizations(descriptionLocalizations);
-                        }
-                        this._applySubcommandLocalizations(builder, name, allLocales);
-                    } catch (e) {
-                        this.logger.warn(`Failed to load localizations for command "${name}": ${e.message}`);
-                    }
-
-                    if (commandNamesSet.has(name)) {
-                        this.logger.warn(`Duplicate command name detected: "${name}" in ${itemPath}`);
-                    } else {
-                        commandNamesSet.add(name);
-
-                        this.client.commands.set(name, commandModule);
-                    }
-                    commandDataForDeployment.push(builder.toJSON());
-                    summarySlash = { type: 'single', name: name, folder: addon.name, kind: 'slash' };
-                    if (summarySlash) loadedCommandsSummary.push(summarySlash);
-                    this.commandCategoryMap.set(name, addon.name);
-                }
-
-                if (commandModule.contextMenuCommand) {
-                    const builder = commandModule.contextMenuCommand;
-                    const name = builder.name;
-                    if (commandNamesSet.has(name) && !commandModule.slashCommand) {
-                        this.logger.warn(`Duplicate command name detected: "${name}" in ${itemPath}`);
-                    } else {
-                        if (!commandNamesSet.has(name)) commandNamesSet.add(name);
-
-                        this.client.commands.set(name, commandModule);
-                    }
-                    commandDataForDeployment.push(builder.toJSON());
-                    summaryContext = { type: 'single', name: name, folder: addon.name, kind: 'contextMenu' };
-                    if (summaryContext) loadedCommandsSummary.push(summaryContext);
-                }
-
-                if (!isClass && !commandModule.slashCommand && !commandModule.contextMenuCommand) {
-                    const summary = this.registerCommand(
-                        commandModule,
-                        itemPath,
-                        commandNamesSet,
-                        commandDataForDeployment,
-                        addonPermissionDefaults,
-                        { folderName: addon.name }
-                    );
-                    if (summary) loadedCommandsSummary.push(summary);
-                }
-            } else if (item.isDirectory() && !item.name.startsWith('_')) {
-                const files = fs.readdirSync(itemPath).filter((f) => f.endsWith('.js') && !f.startsWith('_'));
-                for (const file of files) {
-                    const filePath = path.join(itemPath, file);
-                    let commandModule = require(filePath);
-                    let isClass = false;
-                    if (this._isBaseCommandClass(commandModule)) {
-                        commandModule = this._instantiateBaseCommand(commandModule);
-                        isClass = true;
-                    }
-
-                    if (!isClass && commandModule.subcommand) continue;
-
-                    let summarySlash = null;
-                    let summaryContext = null;
-
-                    if (commandModule.slashCommand) {
-                        const builder = commandModule.slashCommand;
-                        const name = builder.name;
-                        try {
-                            const allLocales = this.container.translator.getLocales();
-                            let nameLocalizations = {};
-                            let descriptionLocalizations = {};
-                            if (typeof allLocales.entries === 'function') {
-                                for (const [lang, translations] of allLocales.entries()) {
-                                    const nameKey = `command_${name}_name`;
-                                    const descKey = `command_${name}_desc`;
-                                    if (translations[nameKey]) nameLocalizations[lang] = translations[nameKey];
-                                    if (translations[descKey]) descriptionLocalizations[lang] = translations[descKey];
-                                }
-                            } else {
-                                for (const lang in allLocales) {
-                                    const translations = allLocales[lang];
-                                    const nameKey = `command_${name}_name`;
-                                    const descKey = `command_${name}_desc`;
-                                    if (translations[nameKey]) nameLocalizations[lang] = translations[nameKey];
-                                    if (translations[descKey]) descriptionLocalizations[lang] = translations[descKey];
-                                }
-                            }
-                            if (Object.keys(nameLocalizations).length > 0) {
-                                builder.setNameLocalizations(nameLocalizations);
-                            }
-                            if (Object.keys(descriptionLocalizations).length > 0) {
-                                builder.setDescriptionLocalizations(descriptionLocalizations);
-                            }
-                            this._applySubcommandLocalizations(builder, name, allLocales);
-                        } catch (e) {
-                            this.logger.warn(`Failed to load localizations for command "${name}": ${e.message}`);
-                        }
-                        this.commandCategoryMap.set(name, item.name);
-                        if (commandNamesSet.has(name)) {
-                            this.logger.warn(`Duplicate slash command name detected: "${name}" in ${filePath}`);
-                        } else {
-                            commandNamesSet.add(name);
-                            this.client.commands.set(name, commandModule);
-                            commandDataForDeployment.push(builder.toJSON());
-                            summarySlash = { type: 'single', name: name, folder: item.name, kind: 'slash' };
-                            if (summarySlash) loadedCommandsSummary.push(summarySlash);
-                        }
-                    }
-
-                    if (commandModule.contextMenuCommand) {
-                        const builder = commandModule.contextMenuCommand;
-                        const name = builder.name;
-                        if (!this.client.commands.has(name)) {
-                            this.client.commands.set(name, commandModule);
-                        }
-                        commandDataForDeployment.push(builder.toJSON());
-                        summaryContext = { type: 'single', name: name, folder: item.name, kind: 'contextMenu' };
-                        if (summaryContext) loadedCommandsSummary.push(summaryContext);
-                    }
-
-                    if (!isClass && !commandModule.slashCommand && !commandModule.contextMenuCommand) {
-                        const summary = this.registerCommand(
-                            commandModule,
-                            filePath,
-                            commandNamesSet,
-                            commandDataForDeployment,
-                            addonPermissionDefaults,
-                            { folderName: item.name }
-                        );
-                        if (summary) loadedCommandsSummary.push(summary);
-                    }
-                }
-            }
-        }
-        return loadedCommandsSummary;
-    }
-
-    /**
-     * Apply subcommand localizations
-     * @private
-     */
-    _applySubcommandLocalizations(commandBuilder, commandName, allLocales) {
-        if (Array.isArray(commandBuilder.options)) {
-            for (const group of commandBuilder.options) {
-                if (typeof SlashCommandSubcommandGroupBuilder !== 'undefined' && group instanceof SlashCommandSubcommandGroupBuilder) {
-                    const groupName = group.name;
-
-                    let groupDescLocalizations = {};
-                    if (typeof allLocales.entries === 'function') {
-                        for (const [lang, translations] of allLocales.entries()) {
-                            const groupDescKey = `command_${commandName}_${groupName}_group_desc`;
-                            if (translations[groupDescKey]) groupDescLocalizations[lang] = translations[groupDescKey];
-                        }
-                    } else {
-                        for (const lang in allLocales) {
-                            const translations = allLocales[lang];
-                            const groupDescKey = `command_${commandName}_${groupName}_group_desc`;
-                            if (translations[groupDescKey]) groupDescLocalizations[lang] = translations[groupDescKey];
-                        }
-                    }
-                    if (Object.keys(groupDescLocalizations).length > 0 && typeof group.setDescriptionLocalizations === 'function') {
-                        group.setDescriptionLocalizations(groupDescLocalizations);
-                    }
-
-                    if (Array.isArray(group.options)) {
-                        for (const sub of group.options) {
-                            const subName = sub.name;
-
-                            let subDescLocalizations = {};
-                            if (typeof allLocales.entries === 'function') {
-                                for (const [lang, translations] of allLocales.entries()) {
-                                    const subDescKey = `command_${commandName}_${groupName}_${subName}_desc`;
-                                    if (translations[subDescKey]) subDescLocalizations[lang] = translations[subDescKey];
-                                }
-                            } else {
-                                for (const lang in allLocales) {
-                                    const translations = allLocales[lang];
-                                    const subDescKey = `command_${commandName}_${groupName}_${subName}_desc`;
-                                    if (translations[subDescKey]) subDescLocalizations[lang] = translations[subDescKey];
-                                }
-                            }
-                            if (Object.keys(subDescLocalizations).length > 0 && typeof sub.setDescriptionLocalizations === 'function') {
-                                sub.setDescriptionLocalizations(subDescLocalizations);
-                            }
-
-                            if (Array.isArray(sub.options)) {
-                                for (const opt of sub.options) {
-                                    const optName = opt.name;
-                                    let optDescLocalizations = {};
-                                    if (typeof allLocales.entries === 'function') {
-                                        for (const [lang, translations] of allLocales.entries()) {
-                                            const optDescKey = `command_${commandName}_${groupName}_${subName}_option_${optName}`;
-                                            if (translations[optDescKey]) optDescLocalizations[lang] = translations[optDescKey];
-                                        }
-                                    } else {
-                                        for (const lang in allLocales) {
-                                            const translations = allLocales[lang];
-                                            const optDescKey = `command_${commandName}_${groupName}_${subName}_option_${optName}`;
-                                            if (translations[optDescKey]) optDescLocalizations[lang] = translations[optDescKey];
-                                        }
-                                    }
-                                    if (
-                                        Object.keys(optDescLocalizations).length > 0 &&
-                                        typeof opt.setDescriptionLocalizations === 'function'
-                                    ) {
-                                        opt.setDescriptionLocalizations(optDescLocalizations);
-                                    }
-                                }
-                            }
-                        }
-                    }
-                } else if (typeof SlashCommandSubcommandBuilder !== 'undefined' && group instanceof SlashCommandSubcommandBuilder) {
-                    const subName = group.name;
-                    let subDescLocalizations = {};
-                    if (typeof allLocales.entries === 'function') {
-                        for (const [lang, translations] of allLocales.entries()) {
-                            const subDescKey = `command_${commandName}_${subName}_desc`;
-                            if (translations[subDescKey]) subDescLocalizations[lang] = translations[subDescKey];
-                        }
-                    } else {
-                        for (const lang in allLocales) {
-                            const translations = allLocales[lang];
-                            const subDescKey = `command_${commandName}_${subName}_desc`;
-                            if (translations[subDescKey]) subDescLocalizations[lang] = translations[subDescKey];
-                        }
-                    }
-                    if (Object.keys(subDescLocalizations).length > 0 && typeof group.setDescriptionLocalizations === 'function') {
-                        group.setDescriptionLocalizations(subDescLocalizations);
-                    }
-
-                    if (Array.isArray(group.options)) {
-                        for (const opt of group.options) {
-                            const optName = opt.name;
-                            let optDescLocalizations = {};
-                            if (typeof allLocales.entries === 'function') {
-                                for (const [lang, translations] of allLocales.entries()) {
-                                    const optDescKey = `command_${commandName}_${subName}_option_${optName}`;
-                                    if (translations[optDescKey]) optDescLocalizations[lang] = translations[optDescKey];
-                                }
-                            } else {
-                                for (const lang in allLocales) {
-                                    const translations = allLocales[lang];
-                                    const optDescKey = `command_${commandName}_${subName}_option_${optName}`;
-                                    if (translations[optDescKey]) optDescLocalizations[lang] = translations[optDescKey];
-                                }
-                            }
-                            if (Object.keys(optDescLocalizations).length > 0 && typeof opt.setDescriptionLocalizations === 'function') {
-                                opt.setDescriptionLocalizations(optDescLocalizations);
-                            }
-                        }
-                    }
-                }
-            }
-        }
-    }
-
-    /**
-     * Log addon summary
-     * @private
-     */
-    _logAddonSummary(addonSummaries) {
-        this.logger.info('▬▬▬▬▬▬▬▬▬▬▬▬▬[ Addon(s) Loaded ]▬▬▬▬▬▬▬▬▬▬▬▬▬');
-        for (const addon of addonSummaries) {
-            this.logger.info(`📦  ${addon.name} (v${addon.version})`);
-            this.logger.info('  ⚙️  Command(s)');
-            if (!addon.commands.length) {
-                this.logger.info('     (no commands registered)');
-            } else {
-                for (const cmd of addon.commands) {
-                    if (cmd.type === 'group') {
-                        this.logger.info(`     └─ /${cmd.name}`);
-                        for (const sub of cmd.subcommands) {
-                            if (typeof sub === 'string') {
-                                this.logger.info(`        └─ ${sub}`);
-                            } else if (typeof sub === 'object' && sub.group) {
-                                this.logger.info(`          └─ [${sub.group}]`);
-                                for (const subsub of sub.subcommands) {
-                                    this.logger.info(`             └─ ${subsub}`);
-                                }
-                            }
-                        }
-                    } else if (cmd.type === 'single') {
-                        let kindLabel = '';
-                        if (cmd.kind === 'slash') kindLabel = ' [slash]';
-                        else if (cmd.kind === 'contextMenu') kindLabel = ' [contextMenu]';
-                        if (cmd.folder) {
-                            this.logger.info(`     └─ /${cmd.name} (${cmd.folder})${kindLabel}`);
-                        } else {
-                            this.logger.info(`     └─ /${cmd.name}${kindLabel}`);
-                        }
-                    }
-                }
-            }
-            if (addon.register && addon.register.length) {
-                this.logger.info('  🧩 Component(s)');
-                for (const reg of addon.register) {
-                    this.logger.info(`   ${reg}`);
-                }
-            }
-            if (addon.events && addon.events.length) {
-                this.logger.info('  📢 Event(s)');
-                for (const ev of addon.events) {
-                    this.logger.info(`     └─ ${ev}`);
-                }
-            }
-        }
-    }
-
-    /**
-     * Get handler maps for other managers
-     */
-    getHandlers() {
-        return {
-            buttonHandlers: this.buttonHandlers,
-            modalHandlers: this.modalHandlers,
-            selectMenuHandlers: this.selectMenuHandlers,
-            autocompleteHandlers: this.autocompleteHandlers,
-            commandCategoryMap: this.commandCategoryMap,
-            categoryToFeatureMap: this.categoryToFeatureMap,
-            eventHandlers: this.eventHandlers,
-        };
-    }
+	/**
+	 * 🗝️ AddonManager Constructor
+	 * Initializes the addon manager with necessary collections and maps.
+	 * @param {Object} client - Discord client instance
+	 * @param {Object} container - Dependency container
+	 */
+	constructor({ client, container }) {
+		this.client = client;
+		this.container = container;
+		this.logger = this.container.logger;
+
+		this.buttonHandlers = new Map();
+		this.modalHandlers = new Map();
+		this.selectMenuHandlers = new Map();
+		this.autocompleteHandlers = new Map();
+		this.commandCategoryMap = new Map();
+		this.categoryToFeatureMap = new Map();
+		this.embedDrafts = new Collection();
+		this.eventHandlers = new Map();
+	}
+
+	/**
+	 * 🔘 Register Button Handler
+	 * Registers a handler function for a specific button customId.
+	 * @param {string} customId - The customId of the button
+	 * @param {Function} handler - The handler function to execute
+	 */
+	registerButtonHandler(customId, handler) {
+		if (this.buttonHandlers.has(customId)) {
+			this.logger.warn(
+				`[REGISTRATION] Warning: Button handler for [${customId}] already exists and will be overwritten.`,
+			);
+		}
+		this.buttonHandlers.set(customId, handler);
+	}
+	/**
+	 * 🔽 Register Select Menu Handler
+	 * Registers a handler function for a specific select menu customId prefix.
+	 * @param {string} customIdPrefix - The prefix of the select menu customId
+	 * @param {Function} handler - The handler function to execute
+	 */
+	registerSelectMenuHandler(customIdPrefix, handler) {
+		if (this.selectMenuHandlers.has(customIdPrefix)) {
+			this.logger.warn(
+				`[REGISTRATION] Warning: Select menu handler for [${customIdPrefix}] already exists and will be overwritten.`,
+			);
+		}
+		this.selectMenuHandlers.set(customIdPrefix, handler);
+	}
+
+	/**
+	 * 📝 Register Modal Handler
+	 * Registers a handler function for a modal, using a prefix of the customId.
+	 * @param {string} customIdPrefix - The prefix of the modal customId
+	 * @param {Function} handler - The handler function to execute
+	 */
+	registerModalHandler(customIdPrefix, handler) {
+		if (this.modalHandlers.has(customIdPrefix)) {
+			this.logger.warn(
+				`[REGISTRATION] Warning: Modal handler for [${customIdPrefix}] already exists and will be overwritten.`,
+			);
+		}
+		this.modalHandlers.set(customIdPrefix, handler);
+	}
+
+	/**
+	 * 📋 Register Autocomplete Handler
+	 * Registers a handler for autocomplete interactions for a specific command or subcommand.
+	 * @param {string} commandName - The command or subcommand key
+	 * @param {Function} handler - The autocomplete handler function
+	 */
+	registerAutocompleteHandler(commandName, handler) {
+		if (this.autocompleteHandlers.has(commandName)) {
+			this.logger.warn(
+				`[REGISTRATION] Warning: Autocomplete handler for [${commandName}] already exists and will be overwritten.`,
+			);
+		}
+		this.autocompleteHandlers.set(commandName, handler);
+	}
+
+	/**
+	 * 🔍 Check if module is a BaseCommand class
+	 * @param {any} module - The module to check
+	 * @returns {boolean} True if module is a class extending BaseCommand
+	 * @private
+	 */
+	_isBaseCommandClass(module) {
+		if (typeof module !== 'function') return false;
+		if (!module.prototype) return false;
+
+		const hasExecute = typeof module.prototype.execute === 'function';
+		return hasExecute;
+	}
+
+	/**
+	 * 🏗️ Instantiate and prepare BaseCommand class
+	 * @param {Function} CommandClass - The command class to instantiate
+	 * @returns {Object} Command instance with proper structure
+	 * @private
+	 */
+	_instantiateBaseCommand(CommandClass) {
+		try {
+			return new CommandClass(this.container);
+		} catch (error) {
+			this.logger.error(`Failed to instantiate BaseCommand class:`, error);
+			throw error;
+		}
+	}
+
+	/**
+	 * INTERNAL: Creates a Builder instance (Slash, Subcommand, Group) from a module's data property.
+	 * @param {Object} data - The data property (can be function, builder, or object)
+	 * @param {Class} BuilderClass - The d.js class to use (SlashCommandBuilder, etc.)
+	 * @returns {SlashCommandBuilder|SlashCommandSubcommandBuilder|SlashCommandSubcommandGroupBuilder}
+	 * @private
+	 */
+	_createBuilderFromData(data, BuilderClass) {
+		let builder = new BuilderClass();
+
+		if (typeof data === 'function') {
+			data(builder);
+		} else if (data instanceof BuilderClass) {
+			builder = data;
+		} else if (typeof data === 'object') {
+			builder.setName(data.name || 'unnamed');
+			builder.setDescription(data.description || 'No description');
+
+			if (BuilderClass === SlashCommandBuilder) {
+				builder.setDescription(data.description || 'No description');
+				if (data.permissions) {
+					builder.setDefaultMemberPermissions(data.permissions);
+				}
+				if (data.guildOnly !== undefined) {
+					builder.setDMPermission(!data.guildOnly);
+				}
+			} else if (BuilderClass === ContextMenuCommandBuilder) {
+				builder.setType(data.type || ApplicationCommandType.User);
+				if (data.permissions) {
+					builder.setDefaultMemberPermissions(data.permissions);
+				}
+				if (data.guildOnly !== undefined) {
+					builder.setDMPermission(!data.guildOnly);
+				}
+			}
+		}
+		return builder;
+	}
+
+	/**
+	 * 📝 Register Command Helper
+	 * Registers a single command file/module, adds it to the command collection, and prepares it for deployment.
+	 * @param {Object} module - The command module
+	 * @param {string} filePath - The file path of the command
+	 * @param {Set} commandNamesSet - Set of already registered command names
+	 * @param {Array} commandDataForDeployment - Array to collect command data for deployment
+	 * @param {Object} permissionDefaults - Permission defaults for the command
+	 * @param {Object} options - Additional options (e.g., folderName)
+	 * @returns {Object|null} Summary object for logging, or null if not registered
+	 */
+	registerCommand(
+		module,
+		filePath,
+		commandNamesSet,
+		commandDataForDeployment,
+		permissionDefaults = {},
+		options = {},
+	) {
+		if (this._isBaseCommandClass(module)) {
+			module = this._instantiateBaseCommand(module);
+		}
+
+		if (!module || !module.data) return null;
+
+		let builderClass;
+
+		if (module.data instanceof ContextMenuCommandBuilder) {
+			builderClass = ContextMenuCommandBuilder;
+		} else {
+			builderClass = SlashCommandBuilder;
+		}
+
+		const commandBuilder = this._createBuilderFromData(
+			module.data,
+			builderClass,
+		);
+
+		const commandName = commandBuilder.name;
+		const category =
+			options.folderName || path.basename(path.dirname(filePath));
+
+		const categoryDefaults = permissionDefaults[category] || {};
+		const finalCommand = {
+			...categoryDefaults,
+			...module,
+		};
+
+		this.commandCategoryMap.set(commandName, category);
+		if (commandNamesSet.has(commandName)) {
+			throw new Error(
+				`Duplicate command name detected: "${commandName}" in ${filePath}`,
+			);
+		}
+
+		commandNamesSet.add(commandName);
+		this.client.commands.set(commandName, finalCommand);
+		commandDataForDeployment.push(commandBuilder.toJSON());
+
+		if (typeof finalCommand.autocomplete === 'function') {
+			this.registerAutocompleteHandler(commandName, finalCommand.autocomplete);
+		}
+
+		return {
+			type: 'single',
+			name: commandName,
+			folder: category,
+		};
+	}
+
+	/**
+	 * 🧩 Load Addons & Register Commands/Events
+	 * Loads all addons from the addons directory, registers their commands, events, and components.
+	 * @param {Object} kythiaInstance - The main Kythia instance for addon registration
+	 * @returns {Promise<Array>} Array of command data for deployment
+	 */
+	async loadAddons(kythiaInstance) {
+		this.logger.info('🔌 Loading & Registering Kythia Addons...');
+		const commandDataForDeployment = [];
+		const addonsDir = path.join(this.container.appRoot, 'addons');
+		if (!fs.existsSync(addonsDir)) return commandDataForDeployment;
+
+		let addonFolders = fs
+			.readdirSync(addonsDir, { withFileTypes: true })
+			.filter((d) => d.isDirectory() && !d.name.startsWith('_'));
+
+		const coreAddon = addonFolders.find((d) => d.name === 'core');
+		const otherAddons = addonFolders.filter((d) => d.name !== 'core');
+		if (coreAddon) {
+			addonFolders = [coreAddon, ...otherAddons];
+		}
+
+		const commandNamesSet = new Set();
+		const addonSummaries = [];
+
+		for (const addon of addonFolders) {
+			const addonDir = path.join(addonsDir, addon.name);
+			let addonVersion = 'v0.0.0-alpha';
+
+			try {
+				const addonJsonPath = path.join(addonDir, 'addon.json');
+				if (fs.existsSync(addonJsonPath)) {
+					let addonJson;
+					try {
+						const addonJsonRaw = fs.readFileSync(addonJsonPath, 'utf8');
+						addonJson = JSON.parse(addonJsonRaw);
+					} catch (jsonErr) {
+						this.logger.warn(
+							`🔴 Failed to parse addon.json for ${addon.name}: ${jsonErr.message}`,
+						);
+						continue;
+					}
+
+					addonVersion = addonJson.version || 'v0.0.0-alpha';
+					if (addonJson.active === false) {
+						this.logger.info(`🟠 Addon ${addon.name.toUpperCase()} disabled`);
+						continue;
+					}
+					if (addonJson.featureFlag) {
+						this.commandCategoryMap.set(addon.name, addon.name);
+						this.categoryToFeatureMap.set(addon.name, addonJson.featureFlag);
+					}
+				} else {
+					this.logger.warn(
+						`🔴 Addon ${addon.name.toUpperCase()} is missing addon.json. Skipping.`,
+					);
+					continue;
+				}
+			} catch (e) {
+				this.logger.warn(
+					`🔴 Error reading addon.json for ${addonDir}: ${e.message}`,
+				);
+				continue;
+			}
+
+			try {
+				const configAddons = this.container.kythiaConfig?.addons || {};
+				if (configAddons.all?.active === false) {
+					this.logger.info(
+						`🟠 Addon ${addon.name.toUpperCase()} disabled via kythia config`,
+					);
+					continue;
+				} else if (configAddons[addon.name]?.active === false) {
+					this.logger.info(
+						`🟠 Addon ${addon.name.toUpperCase()} disabled via kythia config`,
+					);
+					continue;
+				}
+			} catch (e) {
+				this.logger.warn(
+					`🔴 Error checking config for addon ${addon.name.toUpperCase()}: ${e.message}`,
+				);
+			}
+
+			let addonPermissionDefaults = {};
+			const permissionsFilePath = path.join(addonDir, 'permissions.js');
+
+			if (fs.existsSync(permissionsFilePath)) {
+				try {
+					addonPermissionDefaults = require(permissionsFilePath);
+					this.logger.info(
+						`  └─> Found and loaded permission defaults for addon '${addon.name.toUpperCase()}'`,
+					);
+				} catch (e) {
+					this.logger.warn(
+						`  └─> Failed to load permissions.js for addon '${addon.name.toUpperCase()}': ${e.message}`,
+					);
+				}
+			}
+
+			const loadedCommandsSummary = [];
+			const loadedEventsSummary = [];
+			const loadedRegisterSummary = [];
+
+			const commandsPath = path.join(addonDir, 'commands');
+			if (fs.existsSync(commandsPath)) {
+				try {
+					const commandsResult = await this._loadCommandsFromPath(
+						commandsPath,
+						addon,
+						addonPermissionDefaults,
+						commandNamesSet,
+						commandDataForDeployment,
+					);
+					loadedCommandsSummary.push(...commandsResult);
+				} catch (error) {
+					this.logger.error(
+						`❌ Failed to load commands from addon "${addon.name}":`,
+						error,
+					);
+				}
+			}
+
+			const registerPath = path.join(addonDir, 'register.js');
+			if (fs.existsSync(registerPath)) {
+				try {
+					const registration = require(registerPath);
+					if (typeof registration.initialize === 'function') {
+						const registrationSummary =
+							await registration.initialize(kythiaInstance);
+						if (
+							Array.isArray(registrationSummary) &&
+							registrationSummary.length > 0
+						) {
+							loadedRegisterSummary.push(...registrationSummary);
+						}
+					}
+				} catch (error) {
+					this.logger.error(
+						`❌ Failed to register components for [${addon.name}]:`,
+						error,
+					);
+				}
+			}
+
+			const eventsPath = path.join(addonDir, 'events');
+			if (fs.existsSync(eventsPath)) {
+				const eventFiles = fs
+					.readdirSync(eventsPath)
+					.filter((file) => file.endsWith('.js'));
+				for (const file of eventFiles) {
+					const eventName = path.basename(file, '.js');
+					try {
+						const eventHandler = require(path.join(eventsPath, file));
+						if (typeof eventHandler === 'function') {
+							if (!this.eventHandlers.has(eventName)) {
+								this.eventHandlers.set(eventName, []);
+							}
+							this.eventHandlers.get(eventName).push(eventHandler);
+							loadedEventsSummary.push(eventName);
+						}
+					} catch (error) {
+						this.logger.error(
+							`❌ Failed to register event [${eventName}] for [${addon.name}]:`,
+							error,
+						);
+					}
+				}
+			}
+
+			addonSummaries.push({
+				name: addon.name,
+				version: addonVersion,
+				commands: loadedCommandsSummary,
+				events: loadedEventsSummary,
+				register: loadedRegisterSummary,
+			});
+		}
+
+		this._logAddonSummary(addonSummaries);
+		return commandDataForDeployment;
+	}
+
+	/**
+	 * Load commands from a specific path
+	 * @private
+	 */
+	async _loadCommandsFromPath(
+		commandsPath,
+		addon,
+		addonPermissionDefaults,
+		commandNamesSet,
+		commandDataForDeployment,
+	) {
+		const isTopLevelCommandGroup = fs.existsSync(
+			path.join(commandsPath, '_command.js'),
+		);
+
+		if (isTopLevelCommandGroup) {
+			return await this._loadTopLevelCommandGroup(
+				commandsPath,
+				addon,
+				addonPermissionDefaults,
+				commandNamesSet,
+				commandDataForDeployment,
+			);
+		} else {
+			return await this._loadIndividualCommands(
+				commandsPath,
+				addon,
+				addonPermissionDefaults,
+				commandNamesSet,
+				commandDataForDeployment,
+			);
+		}
+	}
+
+	/**
+	 * Load top-level command group (supports BaseCommand classes)
+	 * @private
+	 */
+	async _loadTopLevelCommandGroup(
+		commandsPath,
+		addon,
+		commandNamesSet,
+		commandDataForDeployment,
+	) {
+		const loadedCommandsSummary = [];
+		let commandDef = require(path.join(commandsPath, '_command.js'));
+
+		if (this._isBaseCommandClass(commandDef)) {
+			commandDef = this._instantiateBaseCommand(commandDef);
+		}
+
+		const mainBuilder = this._createBuilderFromData(
+			commandDef.data,
+			SlashCommandBuilder,
+		);
+
+		const mainCommandName = mainBuilder.name;
+
+		if (commandDef.featureFlag) {
+			this.commandCategoryMap.set(mainCommandName, addon.name);
+			this.categoryToFeatureMap.set(addon.name, commandDef.featureFlag);
+		}
+		this.commandCategoryMap.set(mainCommandName, addon.name);
+
+		if (commandNamesSet.has(mainCommandName))
+			throw new Error(`Duplicate command name: ${mainCommandName}`);
+		commandNamesSet.add(mainCommandName);
+
+		this.client.commands.set(mainCommandName, commandDef);
+
+		if (typeof commandDef.autocomplete === 'function') {
+			this.registerAutocompleteHandler(
+				mainCommandName,
+				commandDef.autocomplete,
+			);
+		}
+
+		const loadedSubcommandsSummary = [];
+		const contents = fs.readdirSync(commandsPath, { withFileTypes: true });
+
+		for (const item of contents) {
+			const itemPath = path.join(commandsPath, item.name);
+
+			if (
+				item.isFile() &&
+				item.name.endsWith('.js') &&
+				!item.name.startsWith('_')
+			) {
+				let subModule = require(itemPath);
+
+				const isSubcommand =
+					subModule.subcommand === true || this._isBaseCommandClass(subModule);
+
+				if (this._isBaseCommandClass(subModule)) {
+					subModule = this._instantiateBaseCommand(subModule);
+				}
+
+				if (!isSubcommand) continue;
+				if (!subModule.data) continue;
+
+				const subBuilder = this._createBuilderFromData(
+					subModule.data,
+					SlashCommandSubcommandBuilder,
+				);
+
+				mainBuilder.addSubcommand(subBuilder);
+				this.client.commands.set(
+					`${mainCommandName} ${subBuilder.name}`,
+					subModule,
+				);
+
+				if (typeof subModule.autocomplete === 'function') {
+					this.registerAutocompleteHandler(
+						`${mainCommandName} ${subBuilder.name}`,
+						subModule.autocomplete,
+					);
+				}
+
+				loadedSubcommandsSummary.push(subBuilder.name);
+			} else if (item.isDirectory()) {
+				const groupDefPath = path.join(itemPath, '_group.js');
+
+				if (!fs.existsSync(groupDefPath)) {
+					continue;
+				}
+
+				try {
+					let groupModule = require(groupDefPath);
+
+					if (this._isBaseCommandClass(groupModule)) {
+						groupModule = this._instantiateBaseCommand(groupModule);
+					}
+
+					if (!groupModule.data) continue;
+
+					const groupBuilder = this._createBuilderFromData(
+						groupModule.data,
+						SlashCommandSubcommandGroupBuilder,
+					);
+
+					const subcommandsInGroupSummary = [];
+					const subCommandFiles = fs
+						.readdirSync(itemPath)
+						.filter((f) => f.endsWith('.js') && !f.startsWith('_'));
+
+					for (const file of subCommandFiles) {
+						const subCommandPath = path.join(itemPath, file);
+						let subModule = require(subCommandPath);
+
+						if (this._isBaseCommandClass(subModule)) {
+							subModule = this._instantiateBaseCommand(subModule);
+						}
+
+						if (!subModule.data) continue;
+
+						const subBuilder = this._createBuilderFromData(
+							subModule.data,
+							SlashCommandSubcommandBuilder,
+						);
+
+						groupBuilder.addSubcommand(subBuilder);
+
+						const commandKey = `${mainCommandName} ${groupBuilder.name} ${subBuilder.name}`;
+
+						this.client.commands.set(commandKey, subModule);
+
+						if (typeof subModule.autocomplete === 'function') {
+							this.registerAutocompleteHandler(
+								commandKey,
+								subModule.autocomplete,
+							);
+						}
+
+						subcommandsInGroupSummary.push(subBuilder.name);
+					}
+
+					mainBuilder.addSubcommandGroup(groupBuilder);
+
+					loadedSubcommandsSummary.push({
+						group: groupBuilder.name,
+						subcommands: subcommandsInGroupSummary,
+					});
+				} catch (e) {
+					this.logger.error(
+						`❌ Failed to load subcommand group from ${itemPath}:`,
+						e,
+					);
+				}
+			}
+		}
+
+		commandDataForDeployment.push(mainBuilder.toJSON());
+		loadedCommandsSummary.push({
+			type: 'group',
+			name: mainCommandName,
+			subcommands: loadedSubcommandsSummary,
+		});
+
+		return loadedCommandsSummary;
+	}
+
+	/**
+	 * Load individual commands (supports BaseCommand classes)
+	 * @private
+	 */
+	async _loadIndividualCommands(
+		commandsPath,
+		addon,
+		addonPermissionDefaults,
+		commandNamesSet,
+		commandDataForDeployment,
+	) {
+		const loadedCommandsSummary = [];
+		const commandItems = fs.readdirSync(commandsPath, { withFileTypes: true });
+
+		for (const item of commandItems) {
+			const itemPath = path.join(commandsPath, item.name);
+
+			if (
+				item.isDirectory() &&
+				fs.existsSync(path.join(itemPath, '_command.js'))
+			) {
+				let commandDef = require(path.join(itemPath, '_command.js'));
+				if (this._isBaseCommandClass(commandDef)) {
+					commandDef = this._instantiateBaseCommand(commandDef);
+				}
+				const mainBuilder = this._createBuilderFromData(
+					commandDef.data,
+					SlashCommandBuilder,
+				);
+				const mainCommandName = mainBuilder.name;
+
+				if (commandDef.featureFlag) {
+					this.commandCategoryMap.set(mainCommandName, addon.name);
+					this.categoryToFeatureMap.set(addon.name, commandDef.featureFlag);
+				}
+				if (commandNamesSet.has(mainCommandName))
+					throw new Error(`Duplicate name: ${mainCommandName}`);
+				commandNamesSet.add(mainCommandName);
+				this.client.commands.set(mainCommandName, commandDef);
+				if (typeof commandDef.autocomplete === 'function') {
+					this.registerAutocompleteHandler(
+						mainCommandName,
+						commandDef.autocomplete,
+					);
+				}
+
+				const subcommandsList = [];
+				const groupContents = fs.readdirSync(itemPath, { withFileTypes: true });
+
+				for (const content of groupContents) {
+					const contentPath = path.join(itemPath, content.name);
+
+					if (
+						content.isFile() &&
+						content.name.endsWith('.js') &&
+						!content.name.startsWith('_')
+					) {
+						let subModule = require(contentPath);
+						if (this._isBaseCommandClass(subModule)) {
+							subModule = this._instantiateBaseCommand(subModule);
+						}
+						if (!subModule.data) continue;
+						const subBuilder = this._createBuilderFromData(
+							subModule.data,
+							SlashCommandSubcommandBuilder,
+						);
+						mainBuilder.addSubcommand(subBuilder);
+						this.client.commands.set(
+							`${mainCommandName} ${subBuilder.name}`,
+							subModule,
+						);
+						if (typeof subModule.autocomplete === 'function') {
+							this.registerAutocompleteHandler(
+								`${mainCommandName} ${subBuilder.name}`,
+								subModule.autocomplete,
+							);
+						}
+						subcommandsList.push(subBuilder.name);
+					} else if (
+						content.isDirectory() &&
+						fs.existsSync(path.join(contentPath, '_group.js'))
+					) {
+						let groupDef = require(path.join(contentPath, '_group.js'));
+						if (this._isBaseCommandClass(groupDef)) {
+							groupDef = this._instantiateBaseCommand(groupDef);
+						}
+						const groupBuilder = this._createBuilderFromData(
+							groupDef.data,
+							SlashCommandSubcommandGroupBuilder,
+						);
+						const subGroupList = [];
+						const subGroupContents = fs.readdirSync(contentPath, {
+							withFileTypes: true,
+						});
+						for (const subSubItem of subGroupContents) {
+							if (
+								subSubItem.isFile() &&
+								subSubItem.name.endsWith('.js') &&
+								!subSubItem.name.startsWith('_')
+							) {
+								const subSubPath = path.join(contentPath, subSubItem.name);
+								let subSubModule = require(subSubPath);
+								if (this._isBaseCommandClass(subSubModule)) {
+									subSubModule = this._instantiateBaseCommand(subSubModule);
+								}
+								if (!subSubModule.data) continue;
+								const subSubBuilder = this._createBuilderFromData(
+									subSubModule.data,
+									SlashCommandSubcommandBuilder,
+								);
+								groupBuilder.addSubcommand(subSubBuilder);
+								this.client.commands.set(
+									`${mainCommandName} ${groupBuilder.name} ${subSubBuilder.name}`,
+									subSubModule,
+								);
+								if (typeof subSubModule.autocomplete === 'function') {
+									this.registerAutocompleteHandler(
+										`${mainCommandName} ${groupBuilder.name} ${subSubBuilder.name}`,
+										subSubModule.autocomplete,
+									);
+								}
+								subGroupList.push(subSubBuilder.name);
+							}
+						}
+						mainBuilder.addSubcommandGroup(groupBuilder);
+						subcommandsList.push({
+							group: groupBuilder.name,
+							subcommands: subGroupList,
+						});
+					}
+				}
+				commandDataForDeployment.push(mainBuilder.toJSON());
+				loadedCommandsSummary.push({
+					type: 'group',
+					name: mainCommandName,
+					subcommands: subcommandsList,
+				});
+			} else if (
+				item.isFile() &&
+				item.name.endsWith('.js') &&
+				!item.name.startsWith('_')
+			) {
+				let commandModule = require(itemPath);
+				let isClass = false;
+				if (this._isBaseCommandClass(commandModule)) {
+					commandModule = this._instantiateBaseCommand(commandModule);
+					isClass = true;
+				}
+
+				if (!isClass && commandModule.subcommand) continue;
+
+				let summarySlash = null;
+				let summaryContext = null;
+
+				if (commandModule.slashCommand) {
+					const builder = commandModule.slashCommand;
+					const name = builder.name;
+					try {
+						const allLocales = this.container.translator.getLocales();
+						const nameLocalizations = {};
+						const descriptionLocalizations = {};
+						if (typeof allLocales.entries === 'function') {
+							for (const [lang, translations] of allLocales.entries()) {
+								const nameKey = `command_${name}_name`;
+								const descKey = `command_${name}_desc`;
+								if (translations[nameKey])
+									nameLocalizations[lang] = translations[nameKey];
+								if (translations[descKey])
+									descriptionLocalizations[lang] = translations[descKey];
+							}
+						} else {
+							for (const lang in allLocales) {
+								const translations = allLocales[lang];
+								const nameKey = `command_${name}_name`;
+								const descKey = `command_${name}_desc`;
+								if (translations[nameKey])
+									nameLocalizations[lang] = translations[nameKey];
+								if (translations[descKey])
+									descriptionLocalizations[lang] = translations[descKey];
+							}
+						}
+						if (Object.keys(nameLocalizations).length > 0) {
+							builder.setNameLocalizations(nameLocalizations);
+						}
+						if (Object.keys(descriptionLocalizations).length > 0) {
+							builder.setDescriptionLocalizations(descriptionLocalizations);
+						}
+						this._applySubcommandLocalizations(builder, name, allLocales);
+					} catch (e) {
+						this.logger.warn(
+							`Failed to load localizations for command "${name}": ${e.message}`,
+						);
+					}
+
+					if (commandNamesSet.has(name)) {
+						this.logger.warn(
+							`Duplicate command name detected: "${name}" in ${itemPath}`,
+						);
+					} else {
+						commandNamesSet.add(name);
+
+						this.client.commands.set(name, commandModule);
+					}
+					commandDataForDeployment.push(builder.toJSON());
+					summarySlash = {
+						type: 'single',
+						name: name,
+						folder: addon.name,
+						kind: 'slash',
+					};
+					if (summarySlash) loadedCommandsSummary.push(summarySlash);
+					this.commandCategoryMap.set(name, addon.name);
+				}
+
+				if (commandModule.contextMenuCommand) {
+					const builder = commandModule.contextMenuCommand;
+					const name = builder.name;
+					if (commandNamesSet.has(name) && !commandModule.slashCommand) {
+						this.logger.warn(
+							`Duplicate command name detected: "${name}" in ${itemPath}`,
+						);
+					} else {
+						if (!commandNamesSet.has(name)) commandNamesSet.add(name);
+
+						this.client.commands.set(name, commandModule);
+					}
+					commandDataForDeployment.push(builder.toJSON());
+					summaryContext = {
+						type: 'single',
+						name: name,
+						folder: addon.name,
+						kind: 'contextMenu',
+					};
+					if (summaryContext) loadedCommandsSummary.push(summaryContext);
+				}
+
+				if (
+					!isClass &&
+					!commandModule.slashCommand &&
+					!commandModule.contextMenuCommand
+				) {
+					const summary = this.registerCommand(
+						commandModule,
+						itemPath,
+						commandNamesSet,
+						commandDataForDeployment,
+						addonPermissionDefaults,
+						{ folderName: addon.name },
+					);
+					if (summary) loadedCommandsSummary.push(summary);
+				}
+			} else if (item.isDirectory() && !item.name.startsWith('_')) {
+				const files = fs
+					.readdirSync(itemPath)
+					.filter((f) => f.endsWith('.js') && !f.startsWith('_'));
+				for (const file of files) {
+					const filePath = path.join(itemPath, file);
+					let commandModule = require(filePath);
+					let isClass = false;
+					if (this._isBaseCommandClass(commandModule)) {
+						commandModule = this._instantiateBaseCommand(commandModule);
+						isClass = true;
+					}
+
+					if (!isClass && commandModule.subcommand) continue;
+
+					let summarySlash = null;
+					let summaryContext = null;
+
+					if (commandModule.slashCommand) {
+						const builder = commandModule.slashCommand;
+						const name = builder.name;
+						try {
+							const allLocales = this.container.translator.getLocales();
+							const nameLocalizations = {};
+							const descriptionLocalizations = {};
+							if (typeof allLocales.entries === 'function') {
+								for (const [lang, translations] of allLocales.entries()) {
+									const nameKey = `command_${name}_name`;
+									const descKey = `command_${name}_desc`;
+									if (translations[nameKey])
+										nameLocalizations[lang] = translations[nameKey];
+									if (translations[descKey])
+										descriptionLocalizations[lang] = translations[descKey];
+								}
+							} else {
+								for (const lang in allLocales) {
+									const translations = allLocales[lang];
+									const nameKey = `command_${name}_name`;
+									const descKey = `command_${name}_desc`;
+									if (translations[nameKey])
+										nameLocalizations[lang] = translations[nameKey];
+									if (translations[descKey])
+										descriptionLocalizations[lang] = translations[descKey];
+								}
+							}
+							if (Object.keys(nameLocalizations).length > 0) {
+								builder.setNameLocalizations(nameLocalizations);
+							}
+							if (Object.keys(descriptionLocalizations).length > 0) {
+								builder.setDescriptionLocalizations(descriptionLocalizations);
+							}
+							this._applySubcommandLocalizations(builder, name, allLocales);
+						} catch (e) {
+							this.logger.warn(
+								`Failed to load localizations for command "${name}": ${e.message}`,
+							);
+						}
+						this.commandCategoryMap.set(name, item.name);
+						if (commandNamesSet.has(name)) {
+							this.logger.warn(
+								`Duplicate slash command name detected: "${name}" in ${filePath}`,
+							);
+						} else {
+							commandNamesSet.add(name);
+							this.client.commands.set(name, commandModule);
+							commandDataForDeployment.push(builder.toJSON());
+							summarySlash = {
+								type: 'single',
+								name: name,
+								folder: item.name,
+								kind: 'slash',
+							};
+							if (summarySlash) loadedCommandsSummary.push(summarySlash);
+						}
+					}
+
+					if (commandModule.contextMenuCommand) {
+						const builder = commandModule.contextMenuCommand;
+						const name = builder.name;
+						if (!this.client.commands.has(name)) {
+							this.client.commands.set(name, commandModule);
+						}
+						commandDataForDeployment.push(builder.toJSON());
+						summaryContext = {
+							type: 'single',
+							name: name,
+							folder: item.name,
+							kind: 'contextMenu',
+						};
+						if (summaryContext) loadedCommandsSummary.push(summaryContext);
+					}
+
+					if (
+						!isClass &&
+						!commandModule.slashCommand &&
+						!commandModule.contextMenuCommand
+					) {
+						const summary = this.registerCommand(
+							commandModule,
+							filePath,
+							commandNamesSet,
+							commandDataForDeployment,
+							addonPermissionDefaults,
+							{ folderName: item.name },
+						);
+						if (summary) loadedCommandsSummary.push(summary);
+					}
+				}
+			}
+		}
+		return loadedCommandsSummary;
+	}
+
+	/**
+	 * Apply subcommand localizations
+	 * @private
+	 */
+	_applySubcommandLocalizations(commandBuilder, commandName, allLocales) {
+		if (Array.isArray(commandBuilder.options)) {
+			for (const group of commandBuilder.options) {
+				if (
+					typeof SlashCommandSubcommandGroupBuilder !== 'undefined' &&
+					group instanceof SlashCommandSubcommandGroupBuilder
+				) {
+					const groupName = group.name;
+
+					const groupDescLocalizations = {};
+					if (typeof allLocales.entries === 'function') {
+						for (const [lang, translations] of allLocales.entries()) {
+							const groupDescKey = `command_${commandName}_${groupName}_group_desc`;
+							if (translations[groupDescKey])
+								groupDescLocalizations[lang] = translations[groupDescKey];
+						}
+					} else {
+						for (const lang in allLocales) {
+							const translations = allLocales[lang];
+							const groupDescKey = `command_${commandName}_${groupName}_group_desc`;
+							if (translations[groupDescKey])
+								groupDescLocalizations[lang] = translations[groupDescKey];
+						}
+					}
+					if (
+						Object.keys(groupDescLocalizations).length > 0 &&
+						typeof group.setDescriptionLocalizations === 'function'
+					) {
+						group.setDescriptionLocalizations(groupDescLocalizations);
+					}
+
+					if (Array.isArray(group.options)) {
+						for (const sub of group.options) {
+							const subName = sub.name;
+
+							const subDescLocalizations = {};
+							if (typeof allLocales.entries === 'function') {
+								for (const [lang, translations] of allLocales.entries()) {
+									const subDescKey = `command_${commandName}_${groupName}_${subName}_desc`;
+									if (translations[subDescKey])
+										subDescLocalizations[lang] = translations[subDescKey];
+								}
+							} else {
+								for (const lang in allLocales) {
+									const translations = allLocales[lang];
+									const subDescKey = `command_${commandName}_${groupName}_${subName}_desc`;
+									if (translations[subDescKey])
+										subDescLocalizations[lang] = translations[subDescKey];
+								}
+							}
+							if (
+								Object.keys(subDescLocalizations).length > 0 &&
+								typeof sub.setDescriptionLocalizations === 'function'
+							) {
+								sub.setDescriptionLocalizations(subDescLocalizations);
+							}
+
+							if (Array.isArray(sub.options)) {
+								for (const opt of sub.options) {
+									const optName = opt.name;
+									const optDescLocalizations = {};
+									if (typeof allLocales.entries === 'function') {
+										for (const [lang, translations] of allLocales.entries()) {
+											const optDescKey = `command_${commandName}_${groupName}_${subName}_option_${optName}`;
+											if (translations[optDescKey])
+												optDescLocalizations[lang] = translations[optDescKey];
+										}
+									} else {
+										for (const lang in allLocales) {
+											const translations = allLocales[lang];
+											const optDescKey = `command_${commandName}_${groupName}_${subName}_option_${optName}`;
+											if (translations[optDescKey])
+												optDescLocalizations[lang] = translations[optDescKey];
+										}
+									}
+									if (
+										Object.keys(optDescLocalizations).length > 0 &&
+										typeof opt.setDescriptionLocalizations === 'function'
+									) {
+										opt.setDescriptionLocalizations(optDescLocalizations);
+									}
+								}
+							}
+						}
+					}
+				} else if (
+					typeof SlashCommandSubcommandBuilder !== 'undefined' &&
+					group instanceof SlashCommandSubcommandBuilder
+				) {
+					const subName = group.name;
+					const subDescLocalizations = {};
+					if (typeof allLocales.entries === 'function') {
+						for (const [lang, translations] of allLocales.entries()) {
+							const subDescKey = `command_${commandName}_${subName}_desc`;
+							if (translations[subDescKey])
+								subDescLocalizations[lang] = translations[subDescKey];
+						}
+					} else {
+						for (const lang in allLocales) {
+							const translations = allLocales[lang];
+							const subDescKey = `command_${commandName}_${subName}_desc`;
+							if (translations[subDescKey])
+								subDescLocalizations[lang] = translations[subDescKey];
+						}
+					}
+					if (
+						Object.keys(subDescLocalizations).length > 0 &&
+						typeof group.setDescriptionLocalizations === 'function'
+					) {
+						group.setDescriptionLocalizations(subDescLocalizations);
+					}
+
+					if (Array.isArray(group.options)) {
+						for (const opt of group.options) {
+							const optName = opt.name;
+							const optDescLocalizations = {};
+							if (typeof allLocales.entries === 'function') {
+								for (const [lang, translations] of allLocales.entries()) {
+									const optDescKey = `command_${commandName}_${subName}_option_${optName}`;
+									if (translations[optDescKey])
+										optDescLocalizations[lang] = translations[optDescKey];
+								}
+							} else {
+								for (const lang in allLocales) {
+									const translations = allLocales[lang];
+									const optDescKey = `command_${commandName}_${subName}_option_${optName}`;
+									if (translations[optDescKey])
+										optDescLocalizations[lang] = translations[optDescKey];
+								}
+							}
+							if (
+								Object.keys(optDescLocalizations).length > 0 &&
+								typeof opt.setDescriptionLocalizations === 'function'
+							) {
+								opt.setDescriptionLocalizations(optDescLocalizations);
+							}
+						}
+					}
+				}
+			}
+		}
+	}
+
+	/**
+	 * Log addon summary
+	 * @private
+	 */
+	_logAddonSummary(addonSummaries) {
+		this.logger.info('▬▬▬▬▬▬▬▬▬▬▬▬▬[ Addon(s) Loaded ]▬▬▬▬▬▬▬▬▬▬▬▬▬');
+		for (const addon of addonSummaries) {
+			this.logger.info(`📦  ${addon.name} (v${addon.version})`);
+			this.logger.info('  ⚙️  Command(s)');
+			if (!addon.commands.length) {
+				this.logger.info('     (no commands registered)');
+			} else {
+				for (const cmd of addon.commands) {
+					if (cmd.type === 'group') {
+						this.logger.info(`     └─ /${cmd.name}`);
+						for (const sub of cmd.subcommands) {
+							if (typeof sub === 'string') {
+								this.logger.info(`        └─ ${sub}`);
+							} else if (typeof sub === 'object' && sub.group) {
+								this.logger.info(`          └─ [${sub.group}]`);
+								for (const subsub of sub.subcommands) {
+									this.logger.info(`             └─ ${subsub}`);
+								}
+							}
+						}
+					} else if (cmd.type === 'single') {
+						let kindLabel = '';
+						if (cmd.kind === 'slash') kindLabel = ' [slash]';
+						else if (cmd.kind === 'contextMenu') kindLabel = ' [contextMenu]';
+						if (cmd.folder) {
+							this.logger.info(
+								`     └─ /${cmd.name} (${cmd.folder})${kindLabel}`,
+							);
+						} else {
+							this.logger.info(`     └─ /${cmd.name}${kindLabel}`);
+						}
+					}
+				}
+			}
+			if (addon.register?.length) {
+				this.logger.info('  🧩 Component(s)');
+				for (const reg of addon.register) {
+					this.logger.info(`   ${reg}`);
+				}
+			}
+			if (addon.events?.length) {
+				this.logger.info('  📢 Event(s)');
+				for (const ev of addon.events) {
+					this.logger.info(`     └─ ${ev}`);
+				}
+			}
+		}
+	}
+
+	/**
+	 * Get handler maps for other managers
+	 */
+	getHandlers() {
+		return {
+			buttonHandlers: this.buttonHandlers,
+			modalHandlers: this.modalHandlers,
+			selectMenuHandlers: this.selectMenuHandlers,
+			autocompleteHandlers: this.autocompleteHandlers,
+			commandCategoryMap: this.commandCategoryMap,
+			categoryToFeatureMap: this.categoryToFeatureMap,
+			eventHandlers: this.eventHandlers,
+		};
+	}
 }
 
 module.exports = AddonManager;