@ngxtm/devkit 3.11.0 → 3.12.0

package/templates/dotnet/rules/dotnet/tooling/SKILL.md

@@ -0,0 +1,92 @@
+---
+name: .NET Tooling
+description: Essential tooling for .NET development and CI/CD.
+metadata:
+  labels: [dotnet, tooling, testing, build, nuget]
+  triggers:
+    files: ['**/*.csproj', '**/*.sln', '.editorconfig', 'Directory.Build.props']
+    keywords: [PackageReference, dotnet, test, build, publish]
+---
+
+# .NET Tooling
+
+## **Priority: P1 (OPERATIONAL)**
+
+Essential tooling for .NET development, testing, and CI/CD.
+
+## Implementation Guidelines
+
+- **Project Files**: SDK-style `.csproj`. Use `Directory.Build.props` for shared settings.
+- **Central Package Management**: `Directory.Packages.props` for version consistency.
+- **Testing**: xUnit or NUnit. FluentAssertions for readable assertions. Moq for mocking.
+- **Code Analysis**: Enable built-in analyzers. Consider StyleCop, SonarQube.
+- **Build**: `dotnet build`, `dotnet publish`. Use Release config for production.
+- **EditorConfig**: Consistent code style across team.
+- **CI/CD**: GitHub Actions, Azure DevOps, or GitLab CI.
+
+## Anti-Patterns
+
+- **No `packages.config`**: Migrate to `PackageReference`.
+- **No skipping tests in CI**: Tests must pass before merge.
+- **No ignoring warnings**: Fix or suppress with documented justification.
+- **No floating versions**: Pin versions (`8.0.0`, not `8.*`).
+
+## Code
+
+```xml
+<!-- Directory.Build.props (shared across all projects) -->
+<Project>
+  <PropertyGroup>
+    <TargetFramework>net8.0</TargetFramework>
+    <Nullable>enable</Nullable>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <TreatWarningsAsErrors>true</TreatWarningsAsErrors>
+    <AnalysisLevel>latest-recommended</AnalysisLevel>
+  </PropertyGroup>
+</Project>
+
+<!-- Directory.Packages.props (Central Package Management) -->
+<Project>
+  <PropertyGroup>
+    <ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>
+  </PropertyGroup>
+  <ItemGroup>
+    <PackageVersion Include="Microsoft.EntityFrameworkCore" Version="8.0.0" />
+    <PackageVersion Include="FluentValidation" Version="11.9.0" />
+    <PackageVersion Include="xunit" Version="2.6.6" />
+  </ItemGroup>
+</Project>
+```
+
+```csharp
+// xUnit test with FluentAssertions
+public class UserServiceTests
+{
+    [Fact]
+    public async Task GetUser_WithValidId_ReturnsUser()
+    {
+        // Arrange
+        var mockRepo = new Mock<IUserRepository>();
+        mockRepo.Setup(r => r.GetByIdAsync(1, default))
+            .ReturnsAsync(new User { Id = 1, Name = "Test" });
+        var sut = new UserService(mockRepo.Object);
+
+        // Act
+        var result = await sut.GetUserAsync(1);
+
+        // Assert
+        result.Should().NotBeNull();
+        result!.Name.Should().Be("Test");
+        mockRepo.Verify(r => r.GetByIdAsync(1, default), Times.Once);
+    }
+}
+```
+
+## Reference & Examples
+
+For CI/CD configuration and Docker setup:
+See [references/REFERENCE.md](references/REFERENCE.md).
+
+## Related Topics
+
+language | best-practices | security

package/templates/dotnet/rules/dotnet/tooling/references/REFERENCE.md

@@ -0,0 +1,300 @@
+# .NET Tooling Reference
+
+Testing, CI/CD, and build configuration patterns.
+
+## References
+
+- [**Testing Setup**](testing-setup.md) - xUnit, NUnit, integration tests.
+- [**CI/CD**](ci-cd.md) - GitHub Actions, Azure DevOps pipelines.
+- [**Docker**](docker.md) - Multi-stage builds for .NET.
+
+## Project File (.csproj) Reference
+
+```xml
+<Project Sdk="Microsoft.NET.Sdk.Web">
+  <PropertyGroup>
+    <TargetFramework>net8.0</TargetFramework>
+    <Nullable>enable</Nullable>
+    <ImplicitUsings>enable</ImplicitUsings>
+
+    <!-- Code analysis -->
+    <AnalysisLevel>latest-recommended</AnalysisLevel>
+    <TreatWarningsAsErrors>true</TreatWarningsAsErrors>
+    <EnforceCodeStyleInBuild>true</EnforceCodeStyleInBuild>
+
+    <!-- Assembly info -->
+    <Version>1.0.0</Version>
+    <Authors>Your Name</Authors>
+
+    <!-- Build optimization -->
+    <PublishTrimmed>true</PublishTrimmed>
+    <PublishSingleFile>true</PublishSingleFile>
+    <SelfContained>true</SelfContained>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <!-- Package references (versions from Directory.Packages.props) -->
+    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" />
+    <PackageReference Include="Serilog.AspNetCore" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <!-- Project references -->
+    <ProjectReference Include="..\Domain\Domain.csproj" />
+    <ProjectReference Include="..\Infrastructure\Infrastructure.csproj" />
+  </ItemGroup>
+</Project>
+```
+
+## GitHub Actions CI/CD
+
+```yaml
+# .github/workflows/ci.yml
+name: CI/CD
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main]
+
+env:
+  DOTNET_VERSION: '8.0.x'
+
+jobs:
+  build-and-test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: ${{ env.DOTNET_VERSION }}
+
+      - name: Restore dependencies
+        run: dotnet restore
+
+      - name: Build
+        run: dotnet build --no-restore --configuration Release
+
+      - name: Test
+        run: dotnet test --no-build --configuration Release --collect:"XPlat Code Coverage" --results-directory ./coverage
+
+      - name: Upload coverage
+        uses: codecov/codecov-action@v3
+        with:
+          directory: ./coverage
+          fail_ci_if_error: true
+
+  publish:
+    needs: build-and-test
+    if: github.ref == 'refs/heads/main'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: ${{ env.DOTNET_VERSION }}
+
+      - name: Publish
+        run: dotnet publish src/WebApi/WebApi.csproj -c Release -o ./publish
+
+      - name: Build and push Docker image
+        uses: docker/build-push-action@v5
+        with:
+          context: .
+          push: true
+          tags: ghcr.io/${{ github.repository }}:latest
+```
+
+## Docker Multi-Stage Build
+
+```dockerfile
+# Dockerfile
+FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
+WORKDIR /src
+
+# Copy csproj files and restore
+COPY ["src/WebApi/WebApi.csproj", "src/WebApi/"]
+COPY ["src/Domain/Domain.csproj", "src/Domain/"]
+COPY ["src/Infrastructure/Infrastructure.csproj", "src/Infrastructure/"]
+COPY ["Directory.Build.props", "./"]
+COPY ["Directory.Packages.props", "./"]
+RUN dotnet restore "src/WebApi/WebApi.csproj"
+
+# Copy everything and build
+COPY . .
+RUN dotnet publish "src/WebApi/WebApi.csproj" -c Release -o /app/publish --no-restore
+
+# Runtime image
+FROM mcr.microsoft.com/dotnet/aspnet:8.0 AS runtime
+WORKDIR /app
+
+# Create non-root user
+RUN adduser --disabled-password --gecos "" appuser
+USER appuser
+
+COPY --from=build /app/publish .
+
+ENV ASPNETCORE_URLS=http://+:8080
+EXPOSE 8080
+
+ENTRYPOINT ["dotnet", "WebApi.dll"]
+```
+
+## Integration Testing with WebApplicationFactory
+
+```csharp
+// CustomWebApplicationFactory.cs
+public class CustomWebApplicationFactory<TProgram> : WebApplicationFactory<TProgram>
+    where TProgram : class
+{
+    protected override void ConfigureWebHost(IWebHostBuilder builder)
+    {
+        builder.ConfigureServices(services =>
+        {
+            // Replace real database with in-memory
+            var descriptor = services.SingleOrDefault(
+                d => d.ServiceType == typeof(DbContextOptions<AppDbContext>));
+
+            if (descriptor != null)
+                services.Remove(descriptor);
+
+            services.AddDbContext<AppDbContext>(options =>
+                options.UseInMemoryDatabase("TestDb"));
+
+            // Replace external services with fakes
+            services.AddScoped<IEmailService, FakeEmailService>();
+        });
+
+        builder.UseEnvironment("Testing");
+    }
+}
+
+// Integration tests
+public class UsersApiTests : IClassFixture<CustomWebApplicationFactory<Program>>
+{
+    private readonly HttpClient _client;
+    private readonly CustomWebApplicationFactory<Program> _factory;
+
+    public UsersApiTests(CustomWebApplicationFactory<Program> factory)
+    {
+        _factory = factory;
+        _client = factory.CreateClient();
+    }
+
+    [Fact]
+    public async Task GetUsers_ReturnsSuccessAndUsers()
+    {
+        // Arrange - seed data
+        using var scope = _factory.Services.CreateScope();
+        var db = scope.ServiceProvider.GetRequiredService<AppDbContext>();
+        db.Users.Add(new User { Name = "Test User", Email = "test@example.com" });
+        await db.SaveChangesAsync();
+
+        // Act
+        var response = await _client.GetAsync("/api/users");
+
+        // Assert
+        response.StatusCode.Should().Be(HttpStatusCode.OK);
+        var users = await response.Content.ReadFromJsonAsync<List<UserDto>>();
+        users.Should().ContainSingle(u => u.Email == "test@example.com");
+    }
+
+    [Fact]
+    public async Task CreateUser_WithValidData_ReturnsCreated()
+    {
+        // Arrange
+        var newUser = new CreateUserDto { Name = "New User", Email = "new@example.com" };
+
+        // Act
+        var response = await _client.PostAsJsonAsync("/api/users", newUser);
+
+        // Assert
+        response.StatusCode.Should().Be(HttpStatusCode.Created);
+        response.Headers.Location.Should().NotBeNull();
+    }
+}
+```
+
+## EditorConfig
+
+```ini
+# .editorconfig
+root = true
+
+[*]
+indent_style = space
+indent_size = 4
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.cs]
+# Naming conventions
+dotnet_naming_rule.private_fields_should_be_camel_case.severity = error
+dotnet_naming_rule.private_fields_should_be_camel_case.symbols = private_fields
+dotnet_naming_rule.private_fields_should_be_camel_case.style = camel_case_underscore
+
+dotnet_naming_symbols.private_fields.applicable_kinds = field
+dotnet_naming_symbols.private_fields.applicable_accessibilities = private
+
+dotnet_naming_style.camel_case_underscore.required_prefix = _
+dotnet_naming_style.camel_case_underscore.capitalization = camel_case
+
+# Code style
+csharp_style_var_for_built_in_types = false:suggestion
+csharp_style_var_when_type_is_apparent = true:suggestion
+csharp_style_expression_bodied_methods = when_on_single_line:suggestion
+csharp_prefer_braces = true:warning
+
+# Formatting
+csharp_new_line_before_open_brace = all
+csharp_new_line_before_else = true
+csharp_new_line_before_catch = true
+csharp_new_line_before_finally = true
+
+[*.{json,yml,yaml}]
+indent_size = 2
+```
+
+## Benchmark.NET Setup
+
+```csharp
+// Install: dotnet add package BenchmarkDotNet
+
+[MemoryDiagnoser]
+[SimpleJob(RuntimeMoniker.Net80)]
+public class StringConcatBenchmarks
+{
+    private readonly string[] _strings = Enumerable.Range(0, 100)
+        .Select(i => $"String{i}").ToArray();
+
+    [Benchmark(Baseline = true)]
+    public string ConcatWithPlus()
+    {
+        string result = "";
+        foreach (var s in _strings)
+            result += s;
+        return result;
+    }
+
+    [Benchmark]
+    public string ConcatWithStringBuilder()
+    {
+        var sb = new StringBuilder();
+        foreach (var s in _strings)
+            sb.Append(s);
+        return sb.ToString();
+    }
+
+    [Benchmark]
+    public string ConcatWithJoin() => string.Join("", _strings);
+}
+
+// Run: dotnet run -c Release
+```

package/merged-commands/scout/ext.md

@@ -1,35 +0,0 @@
----
-description: ⚡ Use external agentic tools to scout given directories
-argument-hint: [user-prompt] [scale]
----
-
-## Purpose
-
-Utilize external agentic tools to scout given directories or explore the codebase for files needed to complete the task using a fast, token efficient agent.
-
-## Variables
-
-USER_PROMPT: $1
-SCALE: $2 (defaults to 3)
-RELEVANT_FILE_OUTPUT_DIR: Use `Report:` from `## Naming` section
-
-## Workflow:
-- Write a prompt for 'SCALE' number of agents to the `Task` tool that will immediately call the `Bash` tool to run these commands to kick off your agents to conduct the search:
-  - `gemini -p "[prompt]" --model gemini-2.5-flash-preview-09-2025` (if count <= 3)
-  - `opencode run "[prompt]" --model opencode/grok-code` (if count > 3 and count < 6)
-  - if count >= 6, spawn `Explore` subagents to search the codebase in parallel
-
-**Why use external agentic tools?**
-- External agentic tools are faster and more efficient when using LLMs with large context windows (1M+ tokens).
-
-**How to prompt the agents:**
-- If `gemini` or `opencode` is not available, ask the user if they want to install it:
-  - If **yes**, install it (if there are permission issues, instruct the user to install it manually, including authentication steps)
-  - If **no**, use the default `Explore` subagents.
-- IMPORTANT: Kick these agents off in parallel using the `Task` tool, analyze and divide folders for each agent to scout intelligently and quickly.
-- IMPORTANT: These agents are calling OTHER agentic coding tools to search the codebase. DO NOT call any search tools yourself.
-- IMPORTANT: That means with the `Task` tool, you'll immediately call the Bash tool to run the respective agentic coding tool (gemini, opencode, claude, etc.)
-- IMPORTANT: Instruct the agents to quickly search the codebase for files needed to complete the task. This isn't about a full blown search, just a quick search to find the files needed to complete the task.
-- Instruct the subagent to use a timeout of 3 minutes for each agent's bash call. Skip any agents that don't return within the timeout, don't restart them.
-- **IMPORTANT:** Sacrifice grammar for the sake of concision when writing reports.
-- **IMPORTANT:** In reports, list any unresolved questions at the end, if any.

package/merged-commands/scout.md

@@ -1,28 +0,0 @@
----
-description: ⚡⚡ Scout given directories to respond to the user's requests
-argument-hint: [user-prompt] [scale]
----
-
-## Purpose
-
-Search the codebase for files needed to complete the task using a fast, token efficient agent.
-
-## Variables
-
-USER_PROMPT: $1
-SCALE: $2 (defaults to 3)
-REPORT_OUTPUT_DIR: Use `Report:` from `## Naming` section
-
-## Workflow:
-
-- Write a prompt for 'SCALE' number of agents to the `Task` tool that will immediately call the `Bash` tool to run these commands to kick off your agents to conduct the search: spawn many `Explore` subagents to search the codebase in parallel based on the user's prompt.
-
-**How to prompt the agents:**
-- IMPORTANT: Kick these agents off in parallel using the `Task` tool, analyze and divide folders for each agent to scout intelligently and quickly.
-- IMPORTANT: Instruct the agents to quickly search the codebase for files needed to complete the task. This isn't about a full blown search, just a quick search to find the files needed to complete the task.
-- Instruct the subagent to use a timeout of 3 minutes for each agent's bash call. Skip any agents that don't return within the timeout, don't restart them.
-
-**How to write reports:**
-
-- **IMPORTANT:** Sacrifice grammar for the sake of concision when writing reports.
-- **IMPORTANT:** In reports, list any unresolved questions at the end, if any.