feat: add /admin reset-database command

Author: HandyS11

src/RustPlusBot.Features.Commands/CommandServiceCollectionExtensions.cs

@@ -23,6 +23,7 @@ public static IServiceCollection AddCommands(this IServiceCollection services)
 
         services.AddSingleton<CommandCooldown>();
         services.AddSingleton<BotUptime>();
+        services.AddOptions<MaintenanceOptions>();
         services.AddRustPlusBotLocalization();
         services.AddItemData();
 

src/RustPlusBot.Features.Commands/MaintenanceOptions.cs

@@ -0,0 +1,11 @@
+namespace RustPlusBot.Features.Commands;
+
+/// <summary>
+/// Gates the dangerous maintenance command (/admin reset-database). Bound to the same "Workspace"
+/// config section as WorkspaceOptions, so a single EnableDangerCommands flag governs all danger commands.
+/// </summary>
+public sealed class MaintenanceOptions
+{
+    /// <summary>Enables the dangerous /admin reset-database command.</summary>
+    public bool EnableDangerCommands { get; set; }
+}

src/RustPlusBot.Features.Commands/Modules/MaintenanceModule.cs

@@ -0,0 +1,58 @@
+using Discord;
+using Discord.Interactions;
+using Microsoft.Extensions.DependencyInjection;
+using Microsoft.Extensions.Options;
+using RustPlusBot.Persistence.Maintenance;
+
+namespace RustPlusBot.Features.Commands.Modules;
+
+/// <summary>Dangerous, danger-gated bot maintenance commands.</summary>
+/// <param name="scopeFactory">Creates a short-lived DI scope per interaction.</param>
+/// <param name="options">Gates the command behind the danger flag.</param>
+[Group("admin", "Bot maintenance (dangerous)")]
+[RequireUserPermission(GuildPermission.ManageGuild)]
+public sealed class MaintenanceModule(
+    IServiceScopeFactory scopeFactory,
+    IOptions<MaintenanceOptions> options) : InteractionModuleBase<SocketInteractionContext>
+{
+    /// <summary>Wipes all bot data across all guilds after a typed confirmation.</summary>
+    /// <param name="confirm">Must equal the literal "RESET" to proceed.</param>
+    [SlashCommand("reset-database", "Wipe ALL bot data across ALL servers (dangerous)")]
+    public async Task ResetDatabaseAsync(
+        [Summary("confirm", "Type RESET to confirm")]
+        string confirm)
+    {
+        if (Context.Guild is null)
+        {
+            await RespondAsync("This command must be used in a server.", ephemeral: true).ConfigureAwait(false);
+            return;
+        }
+
+        if (!options.Value.EnableDangerCommands)
+        {
+            await RespondAsync("Developer commands are disabled.", ephemeral: true).ConfigureAwait(false);
+            return;
+        }
+
+        if (!string.Equals(confirm, "RESET", StringComparison.Ordinal))
+        {
+            await RespondAsync("Type `RESET` exactly to confirm the database wipe.", ephemeral: true)
+                .ConfigureAwait(false);
+            return;
+        }
+
+        await DeferAsync(ephemeral: true).ConfigureAwait(false);
+        var scope = scopeFactory.CreateAsyncScope();
+        try
+        {
+            var maintenance = scope.ServiceProvider.GetRequiredService<IDatabaseMaintenanceService>();
+            await maintenance.ClearAllAsync().ConfigureAwait(false);
+            await FollowupAsync("Database cleared. **Restart the bot** for a clean state.", ephemeral: true)
+                .ConfigureAwait(false);
+        }
+        finally
+        {
+            await scope.DisposeAsync().ConfigureAwait(false);
+        }
+    }
+}

src/RustPlusBot.Host/Program.cs

@@ -71,6 +71,8 @@
     .Validate(static o => o.Cooldown > TimeSpan.Zero, "Commands:Cooldown must be positive.")
     .ValidateOnStart();
 builder.Services.AddCommands();
+builder.Services.AddOptions<MaintenanceOptions>()
+    .Bind(builder.Configuration.GetSection("Workspace"));
 builder.Services.AddEvents();
 builder.Services.AddPlayers();
 builder.Services.AddOptions<MapOptions>()