Subsystem 1a: Discord workspace provisioning & configuration

RustPlusBot.slnx

@@ -4,10 +4,12 @@
     <Project Path="src/RustPlusBot.Discord/RustPlusBot.Discord.csproj" />
     <Project Path="src/RustPlusBot.Domain/RustPlusBot.Domain.csproj" />
     <Project Path="src/RustPlusBot.Host/RustPlusBot.Host.csproj" />
+    <Project Path="src/RustPlusBot.Features.Workspace/RustPlusBot.Features.Workspace.csproj" />
     <Project Path="src/RustPlusBot.Persistence/RustPlusBot.Persistence.csproj" />
   </Folder>
   <Folder Name="/tests/">
     <Project Path="tests/RustPlusBot.Abstractions.Tests/RustPlusBot.Abstractions.Tests.csproj" />
+    <Project Path="tests/RustPlusBot.Features.Workspace.Tests/RustPlusBot.Features.Workspace.Tests.csproj" />
     <Project Path="tests/RustPlusBot.Persistence.Tests/RustPlusBot.Persistence.Tests.csproj" />
   </Folder>
 </Solution>

docs/development/running-locally.md

@@ -21,11 +21,18 @@
 
    On first run the host applies the EF Core migration and creates `rustplusbot.db` in the working directory.
 
-5. In the guild, use the slash commands:
-
-   - `/server add name:<name> ip:<host> port:<port>`
-   - `/server list`
-   - `/server remove id:<id>`
-   - `/bind feature:<Chat|Events|Devices|Cameras> channel:<#channel>`
+5. In the guild, use the slash commands per the provisioning flow below.
 
 A missing or empty `Discord:Token` makes the host fail fast at startup with a clear `OptionsValidationException`.
+
+## Provisioning the workspace
+
+1. Invite the bot with the **Manage Channels**, **Manage Roles**, **Manage Messages**, and
+   **Embed Links** permissions.
+2. In your test guild, run `/setup`. The bot creates a **RustPlusBot** category with
+   `#information`, `#setup`, and `#settings` channels and posts its anchored messages.
+3. Re-running `/setup` is safe — it reconciles and repairs without creating duplicates.
+4. Change the language from the selector in `#settings`.
+5. In Development (`Workspace:EnableDangerCommands = true`), use
+   `/workspace simulate-server name:<n> ip:<host> port:<port>` to create a server category, and
+   `/workspace reset` to delete the whole workspace.

src/RustPlusBot.Abstractions/Events/ServerRegisteredEvent.cs

@@ -0,0 +1,6 @@
+namespace RustPlusBot.Abstractions.Events;
+
+/// <summary>Published when a Rust server is registered to a guild (stub trigger in 1a; FCM pairing in 1b).</summary>
+/// <param name="GuildId">The owning guild snowflake.</param>
+/// <param name="ServerId">The registered server's id.</param>
+public sealed record ServerRegisteredEvent(ulong GuildId, Guid ServerId);

src/RustPlusBot.Discord/DiscordBotService.cs

@@ -16,6 +16,7 @@ namespace RustPlusBot.Discord;
 /// <param name="client">The Discord socket client.</param>
 /// <param name="interactions">The interaction service that dispatches slash commands.</param>
 /// <param name="services">The root service provider used to construct interaction modules.</param>
+/// <param name="moduleAssemblies">Additional assemblies to scan for interaction modules contributed by feature projects.</param>
 /// <param name="options">The Discord options carrying the bot token.</param>
 /// <param name="logger">The logger.</param>
 [SuppressMessage("Performance", "CA1873:Avoid potentially expensive logging",
@@ -25,6 +26,7 @@ public sealed class DiscordBotService(
     DiscordSocketClient client,
     InteractionService interactions,
     IServiceProvider services,
+    IEnumerable<InteractionModuleAssembly> moduleAssemblies,
     IOptions<DiscordOptions> options,
     ILogger<DiscordBotService> logger) : IHostedService
 {
@@ -41,6 +43,11 @@ public async Task StartAsync(CancellationToken cancellationToken)
         client.JoinedGuild += OnJoinedGuildAsync;
 
         await interactions.AddModulesAsync(Assembly.GetExecutingAssembly(), services).ConfigureAwait(false);
+        foreach (var moduleAssembly in moduleAssemblies)
+        {
+            await interactions.AddModulesAsync(moduleAssembly.Assembly, services).ConfigureAwait(false);
+        }
+
         await client.LoginAsync(TokenType.Bot, _options.Token).ConfigureAwait(false);
         await client.StartAsync().ConfigureAwait(false);
     }

src/RustPlusBot.Discord/InteractionModuleAssembly.cs

@@ -0,0 +1,7 @@
+using System.Reflection;
+
+namespace RustPlusBot.Discord;
+
+/// <summary>Registers an assembly whose Discord interaction modules should be loaded at startup.</summary>
+/// <param name="Assembly">The assembly to scan for interaction modules.</param>
+public sealed record InteractionModuleAssembly(Assembly Assembly);

src/RustPlusBot.Domain/Workspace/ProvisionedCategory.cs

@@ -0,0 +1,20 @@
+namespace RustPlusBot.Domain.Workspace;
+
+/// <summary>A Discord category the bot has provisioned. One per scope (global or per-server).</summary>
+public sealed class ProvisionedCategory
+{
+    /// <summary>Surrogate primary key.</summary>
+    public Guid Id { get; set; } = Guid.NewGuid();
+
+    /// <summary>The owning Discord guild snowflake.</summary>
+    public ulong GuildId { get; set; }
+
+    /// <summary>The server this category belongs to, or <c>null</c> for the global category.</summary>
+    public Guid? RustServerId { get; set; }
+
+    /// <summary>The provisioned Discord category snowflake.</summary>
+    public ulong DiscordCategoryId { get; set; }
+
+    /// <summary>When the record was first created (UTC).</summary>
+    public DateTimeOffset CreatedAt { get; set; }
+}

src/RustPlusBot.Domain/Workspace/ProvisionedChannel.cs

@@ -0,0 +1,23 @@
+namespace RustPlusBot.Domain.Workspace;
+
+/// <summary>A Discord text channel the bot has provisioned, identified by its stable spec key.</summary>
+public sealed class ProvisionedChannel
+{
+    /// <summary>Surrogate primary key.</summary>
+    public Guid Id { get; set; } = Guid.NewGuid();
+
+    /// <summary>The owning Discord guild snowflake.</summary>
+    public ulong GuildId { get; set; }
+
+    /// <summary>The server this channel belongs to, or <c>null</c> for a global channel.</summary>
+    public Guid? RustServerId { get; set; }
+
+    /// <summary>The stable spec key (e.g. "information", "setup", "settings", "info").</summary>
+    public string ChannelKey { get; set; } = string.Empty;
+
+    /// <summary>The provisioned Discord channel snowflake.</summary>
+    public ulong DiscordChannelId { get; set; }
+
+    /// <summary>When the record was first created (UTC).</summary>
+    public DateTimeOffset CreatedAt { get; set; }
+}

src/RustPlusBot.Domain/Workspace/ProvisionedMessage.cs

@@ -0,0 +1,29 @@
+namespace RustPlusBot.Domain.Workspace;
+
+/// <summary>An anchored bot message, edited in place rather than re-posted.</summary>
+public sealed class ProvisionedMessage
+{
+    /// <summary>Surrogate primary key.</summary>
+    public Guid Id { get; set; } = Guid.NewGuid();
+
+    /// <summary>The owning Discord guild snowflake.</summary>
+    public ulong GuildId { get; set; }
+
+    /// <summary>The server this message belongs to, or <c>null</c> for a global message.</summary>
+    public Guid? RustServerId { get; set; }
+
+    /// <summary>The stable spec key (e.g. "information.main", "settings.main", "server.info").</summary>
+    public string MessageKey { get; set; } = string.Empty;
+
+    /// <summary>The channel the message lives in.</summary>
+    public ulong DiscordChannelId { get; set; }
+
+    /// <summary>The anchored message snowflake.</summary>
+    public ulong DiscordMessageId { get; set; }
+
+    /// <summary>When the record was first created (UTC).</summary>
+    public DateTimeOffset CreatedAt { get; set; }
+
+    /// <summary>When the message was last edited in place (UTC).</summary>
+    public DateTimeOffset UpdatedAt { get; set; }
+}

src/RustPlusBot.Features.Workspace/AssemblyInfo.cs

@@ -0,0 +1,3 @@
+using System.Runtime.CompilerServices;
+
+[assembly: InternalsVisibleTo("RustPlusBot.Features.Workspace.Tests")]