feat: add Discord NetCord gateway worker

Add a separate GmRelay.DiscordBot worker using NetCord Gateway with startup token validation, PostgreSQL datasource registration, slash-command setup, component interaction service registration, and lifecycle logging.

Wire the Discord service through Aspire AppHost, Docker Compose, PR checks, deploy image build/push/scan/pull steps, README docs, and synchronized version 2.2.0.

Add TDD coverage for project isolation, token validation, startup wiring, runtime wiring, and version synchronization.

Bump version -> 2.2.0

tests/GmRelay.Bot.Tests/Discord/DiscordOptionsTests.cs

@@ -0,0 +1,28 @@
+using GmRelay.DiscordBot;
+
+namespace GmRelay.Bot.Tests.Discord;
+
+public sealed class DiscordOptionsTests
+{
+    [Theory]
+    [InlineData(null)]
+    [InlineData("")]
+    [InlineData("   ")]
+    public void Validate_ShouldRejectMissingToken(string? token)
+    {
+        var options = new DiscordOptions { Token = token };
+
+        var exception = Assert.Throws<InvalidOperationException>(options.Validate);
+
+        Assert.Contains("Discord:Token is required", exception.Message);
+        Assert.Contains("Discord__Token", exception.Message);
+    }
+
+    [Fact]
+    public void Validate_ShouldAcceptConfiguredToken()
+    {
+        var options = new DiscordOptions { Token = "configured-token" };
+
+        options.Validate();
+    }
+}

tests/GmRelay.Bot.Tests/Discord/DiscordProjectStructureTests.cs

@@ -0,0 +1,87 @@
+using System;
+using System.IO;
+
+namespace GmRelay.Bot.Tests.Discord;
+
+public sealed class DiscordProjectStructureTests
+{
+    private static string GetRepoRoot()
+    {
+        var dir = AppContext.BaseDirectory;
+        while (!string.IsNullOrEmpty(dir) && !File.Exists(Path.Combine(dir, "Directory.Build.props")))
+        {
+            dir = Directory.GetParent(dir)?.FullName;
+        }
+
+        return dir ?? throw new InvalidOperationException("Could not find repo root");
+    }
+
+    [Fact]
+    public void Solution_ShouldIncludeDiscordWorkerProject()
+    {
+        var repoRoot = GetRepoRoot();
+        var solution = File.ReadAllText(Path.Combine(repoRoot, "GM-Relay.slnx"));
+
+        Assert.Contains("src/GmRelay.DiscordBot/GmRelay.DiscordBot.csproj", solution);
+    }
+
+    [Fact]
+    public void DiscordWorkerProject_ShouldExistWithoutTelegramDependency()
+    {
+        var repoRoot = GetRepoRoot();
+        var projectPath = Path.Combine(repoRoot, "src", "GmRelay.DiscordBot", "GmRelay.DiscordBot.csproj");
+
+        Assert.True(File.Exists(projectPath), "Discord worker project should exist.");
+
+        var project = File.ReadAllText(projectPath);
+        Assert.Contains("Microsoft.NET.Sdk.Worker", project);
+        Assert.Contains("NetCord.Hosting", project);
+        Assert.Contains("GmRelay.ServiceDefaults.csproj", project);
+        Assert.Contains("GmRelay.Shared.csproj", project);
+        Assert.DoesNotContain("Telegram.Bot", project);
+        Assert.DoesNotContain("GmRelay.Bot.csproj", project);
+    }
+
+    [Fact]
+    public void TelegramWorkerProject_ShouldNotReferenceNetCord()
+    {
+        var repoRoot = GetRepoRoot();
+        var project = File.ReadAllText(Path.Combine(repoRoot, "src", "GmRelay.Bot", "GmRelay.Bot.csproj"));
+
+        Assert.DoesNotContain("NetCord", project, StringComparison.OrdinalIgnoreCase);
+    }
+
+    [Fact]
+    public void RuntimeWiring_ShouldIncludeDiscordServiceWithoutCouplingTelegram()
+    {
+        var repoRoot = GetRepoRoot();
+        var compose = File.ReadAllText(Path.Combine(repoRoot, "compose.yaml"));
+        var appHostProject = File.ReadAllText(Path.Combine(repoRoot, "src", "GmRelay.AppHost", "GmRelay.AppHost.csproj"));
+        var appHostProgram = File.ReadAllText(Path.Combine(repoRoot, "src", "GmRelay.AppHost", "Program.cs"));
+        var prChecks = File.ReadAllText(Path.Combine(repoRoot, ".gitea", "workflows", "pr-checks.yml"));
+        var deploy = File.ReadAllText(Path.Combine(repoRoot, ".gitea", "workflows", "deploy.yml"));
+
+        Assert.Contains("gmrelay-discord-bot:2.2.0", compose);
+        Assert.Contains("Discord__Token=${DISCORD_BOT_TOKEN:?Set DISCORD_BOT_TOKEN in .env}", compose);
+        Assert.Contains("src/GmRelay.DiscordBot/Dockerfile", deploy);
+        Assert.Contains("DISCORD_BOT_TOKEN", deploy);
+        Assert.Contains("dotnet build src/GmRelay.DiscordBot/GmRelay.DiscordBot.csproj --no-restore", prChecks);
+        Assert.Contains("GmRelay.DiscordBot.csproj", appHostProject);
+        Assert.Contains("Projects.GmRelay_DiscordBot", appHostProgram);
+    }
+
+    [Fact]
+    public void Version_ShouldBeSynchronizedForDiscordFeatureRelease()
+    {
+        var repoRoot = GetRepoRoot();
+
+        Assert.Contains("<Version>2.2.0</Version>", File.ReadAllText(Path.Combine(repoRoot, "Directory.Build.props")));
+        Assert.Contains("VERSION: 2.2.0", File.ReadAllText(Path.Combine(repoRoot, ".gitea", "workflows", "deploy.yml")));
+        Assert.Contains("gmrelay-bot:2.2.0", File.ReadAllText(Path.Combine(repoRoot, "compose.yaml")));
+        Assert.Contains("gmrelay-web:2.2.0", File.ReadAllText(Path.Combine(repoRoot, "compose.yaml")));
+        Assert.Contains("gmrelay-discord-bot:2.2.0", File.ReadAllText(Path.Combine(repoRoot, "compose.yaml")));
+        Assert.Contains(
+            "v2.2.0",
+            File.ReadAllText(Path.Combine(repoRoot, "src", "GmRelay.Web", "Components", "Layout", "NavMenu.razor")));
+    }
+}

tests/GmRelay.Bot.Tests/Discord/DiscordStartupTests.cs

@@ -0,0 +1,79 @@
+using System;
+using System.IO;
+
+namespace GmRelay.Bot.Tests.Discord;
+
+public sealed class DiscordStartupTests
+{
+    private static string GetRepoRoot()
+    {
+        var dir = AppContext.BaseDirectory;
+        while (!string.IsNullOrEmpty(dir) && !File.Exists(Path.Combine(dir, "Directory.Build.props")))
+        {
+            dir = Directory.GetParent(dir)?.FullName;
+        }
+
+        return dir ?? throw new InvalidOperationException("Could not find repo root");
+    }
+
+    [Fact]
+    public void Program_ShouldValidateDiscordTokenBeforeRunning()
+    {
+        var program = ReadProgram();
+
+        Assert.Contains("GetRequiredSection(\"Discord\")", program);
+        Assert.Contains("DiscordOptions", program);
+        Assert.Contains(".Validate()", program);
+    }
+
+    [Fact]
+    public void Program_ShouldRegisterServiceDefaultsAndPostgresDataSource()
+    {
+        var program = ReadProgram();
+
+        Assert.Contains("builder.AddServiceDefaults()", program);
+        Assert.Contains("ConnectionStrings:gmrelaydb is required", program);
+        Assert.Contains("NpgsqlDataSource", program);
+        Assert.Contains("SecretRedactor.RedactConnectionString", program);
+    }
+
+    [Fact]
+    public void Program_ShouldRegisterNetCordGatewayApplicationCommandsAndComponents()
+    {
+        var program = ReadProgram();
+
+        Assert.Contains(".AddDiscordGateway", program);
+        Assert.Contains(".AddApplicationCommands", program);
+        Assert.Contains(".AddComponentInteractions", program);
+        Assert.Contains(".AddGatewayHandlers", program);
+        Assert.Contains("AddSlashCommand", program);
+    }
+
+    [Fact]
+    public void LifecycleLogger_ShouldLogGatewayLifecycleEventsWithoutTokenValues()
+    {
+        var repoRoot = GetRepoRoot();
+        var loggerPath = Path.Combine(
+            repoRoot,
+            "src",
+            "GmRelay.DiscordBot",
+            "Infrastructure",
+            "Logging",
+            "DiscordGatewayLifecycleLogger.cs");
+
+        Assert.True(File.Exists(loggerPath), "Discord gateway lifecycle logger should exist.");
+
+        var logger = File.ReadAllText(loggerPath);
+        Assert.Contains("IReadyGatewayHandler", logger);
+        Assert.Contains("IDisconnectGatewayHandler", logger);
+        Assert.Contains("IResumeGatewayHandler", logger);
+        Assert.Contains("LogInformation", logger);
+        Assert.DoesNotContain("Token", logger);
+    }
+
+    private static string ReadProgram()
+    {
+        var repoRoot = GetRepoRoot();
+        return File.ReadAllText(Path.Combine(repoRoot, "src", "GmRelay.DiscordBot", "Program.cs"));
+    }
+}

tests/GmRelay.Bot.Tests/GmRelay.Bot.Tests.csproj

@@ -25,6 +25,7 @@
 
   <ItemGroup>
     <ProjectReference Include="..\..\src\GmRelay.Bot\GmRelay.Bot.csproj" />
+    <ProjectReference Include="..\..\src\GmRelay.DiscordBot\GmRelay.DiscordBot.csproj" />
     <ProjectReference Include="..\..\src\GmRelay.Web\GmRelay.Web.csproj" />
   </ItemGroup>
 

tests/GmRelay.Bot.Tests/packages.lock.json

@@ -202,6 +202,36 @@
           "Newtonsoft.Json": "13.0.3"
         }
       },
+      "NetCord": {
+        "type": "Transitive",
+        "resolved": "1.0.0-alpha.489",
+        "contentHash": "/rM73l1pwwJCWHi7YrIiSVc+GVL0lV+k+amqNJUMINjLO+c5bKWj9PoNNoMhiPZoaORO4k6Uxp8EQfoQj3AYtA=="
+      },
+      "NetCord.Hosting": {
+        "type": "Transitive",
+        "resolved": "1.0.0-alpha.489",
+        "contentHash": "yQcvgY3uu98ndoLXpiFhJ5kungoWVLd7xnO18GmukRPVsRzyOKgxe/Ycp8DLYTtiQG9Wyg1pV4Iv6rvo+zck4w==",
+        "dependencies": {
+          "NetCord": "1.0.0-alpha.489"
+        }
+      },
+      "NetCord.Hosting.Services": {
+        "type": "Transitive",
+        "resolved": "1.0.0-alpha.489",
+        "contentHash": "Md46+zLB9UWYLM7PVlATytkjAC9602wBNKO7m5eaBiDdEvZOPsUrR6NJJr2YtJoKjttbvhte5ayDXj8WGGsevQ==",
+        "dependencies": {
+          "NetCord.Hosting": "1.0.0-alpha.489",
+          "NetCord.Services": "1.0.0-alpha.489"
+        }
+      },
+      "NetCord.Services": {
+        "type": "Transitive",
+        "resolved": "1.0.0-alpha.489",
+        "contentHash": "SwG/7Khba1uRENDvG22RV/POByIwh/ZrenMrSzwoEcEYPMI5TabmEEB3ySH15XGdLcFZJEj106AlriN0kZhfFg==",
+        "dependencies": {
+          "NetCord": "1.0.0-alpha.489"
+        }
+      },
       "Newtonsoft.Json": {
         "type": "Transitive",
         "resolved": "13.0.3",
@@ -362,13 +392,24 @@
           "Aspire.Npgsql": "[13.2.2, )",
           "Dapper": "[2.1.72, )",
           "Dapper.AOT": "[1.0.48, )",
-          "GmRelay.ServiceDefaults": "[1.15.1, )",
-          "GmRelay.Shared": "[1.15.1, )",
+          "GmRelay.ServiceDefaults": "[2.1.1, )",
+          "GmRelay.Shared": "[2.1.1, )",
           "Npgsql": "[10.0.2, )",
           "Telegram.Bot": "[22.9.5.3, )",
           "dbup-postgresql": "[7.0.1, )"
         }
       },
+      "gmrelay.discordbot": {
+        "type": "Project",
+        "dependencies": {
+          "Aspire.Npgsql": "[13.2.2, )",
+          "GmRelay.ServiceDefaults": "[2.1.1, )",
+          "GmRelay.Shared": "[2.1.1, )",
+          "NetCord.Hosting": "[1.0.0-alpha.489, )",
+          "NetCord.Hosting.Services": "[1.0.0-alpha.489, )",
+          "Npgsql": "[10.0.2, )"
+        }
+      },
       "gmrelay.servicedefaults": {
         "type": "Project",
         "dependencies": {
@@ -389,8 +430,8 @@
         "dependencies": {
           "Aspire.Npgsql": "[13.2.2, )",
           "Dapper": "[2.1.72, )",
-          "GmRelay.ServiceDefaults": "[1.15.1, )",
-          "GmRelay.Shared": "[1.15.1, )",
+          "GmRelay.ServiceDefaults": "[2.1.1, )",
+          "GmRelay.Shared": "[2.1.1, )",
           "Npgsql": "[10.0.2, )",
           "Telegram.Bot": "[22.9.6.1, )"
         }