devskill 2.0.7 → 2.0.8

package/skills/aspire/references/testing.md

@@ -0,0 +1,281 @@
+# Testing — Complete Reference
+
+Aspire provides `Aspire.Hosting.Testing` for running integration tests against your full AppHost. Tests spin up the entire distributed application (or a subset) and run assertions against real services.
+
+---
+
+## Package
+
+```xml
+<PackageReference Include="Aspire.Hosting.Testing" Version="*" />
+```
+
+---
+
+## Core pattern: DistributedApplicationTestingBuilder
+
+```csharp
+// 1. Create a testing builder from your AppHost
+var builder = await DistributedApplicationTestingBuilder
+    .CreateAsync<Projects.MyAppHost>();
+
+// 2. (Optional) Override resources for testing
+// ... see customization section below
+
+// 3. Build and start the application
+await using var app = await builder.BuildAsync();
+await app.StartAsync();
+
+// 4. Create HTTP clients for your services
+var client = app.CreateHttpClient("api");
+
+// 5. Run assertions
+var response = await client.GetAsync("/health");
+Assert.Equal(HttpStatusCode.OK, response.StatusCode);
+```
+
+---
+
+## xUnit examples
+
+### Basic health check test
+
+```csharp
+public class HealthTests(ITestOutputHelper output)
+{
+    [Fact]
+    public async Task AllServicesAreHealthy()
+    {
+        var builder = await DistributedApplicationTestingBuilder
+            .CreateAsync<Projects.AppHost>();
+
+        await using var app = await builder.BuildAsync();
+        await app.StartAsync();
+
+        // Test each service's health endpoint
+        var apiClient = app.CreateHttpClient("api");
+        var apiHealth = await apiClient.GetAsync("/health");
+        Assert.Equal(HttpStatusCode.OK, apiHealth.StatusCode);
+
+        var workerClient = app.CreateHttpClient("worker");
+        var workerHealth = await workerClient.GetAsync("/health");
+        Assert.Equal(HttpStatusCode.OK, workerHealth.StatusCode);
+    }
+}
+```
+
+### API integration test
+
+```csharp
+public class ApiTests(ITestOutputHelper output)
+{
+    [Fact]
+    public async Task CreateOrder_ReturnsCreated()
+    {
+        var builder = await DistributedApplicationTestingBuilder
+            .CreateAsync<Projects.AppHost>();
+
+        await using var app = await builder.BuildAsync();
+        await app.StartAsync();
+
+        var client = app.CreateHttpClient("api");
+
+        var order = new { ProductId = 1, Quantity = 2 };
+        var response = await client.PostAsJsonAsync("/orders", order);
+
+        Assert.Equal(HttpStatusCode.Created, response.StatusCode);
+
+        var created = await response.Content.ReadFromJsonAsync<Order>();
+        Assert.NotNull(created);
+        Assert.Equal(1, created.ProductId);
+    }
+}
+```
+
+### Testing with wait for readiness
+
+```csharp
+[Fact]
+public async Task DatabaseIsSeeded()
+{
+    var builder = await DistributedApplicationTestingBuilder
+        .CreateAsync<Projects.AppHost>();
+
+    await using var app = await builder.BuildAsync();
+    await app.StartAsync();
+
+    // Wait for the API to be fully ready (all dependencies healthy)
+    await app.WaitForResourceReadyAsync("api");
+
+    var client = app.CreateHttpClient("api");
+    var response = await client.GetAsync("/products");
+
+    Assert.Equal(HttpStatusCode.OK, response.StatusCode);
+    var products = await response.Content.ReadFromJsonAsync<List<Product>>();
+    Assert.NotEmpty(products);
+}
+```
+
+---
+
+## MSTest examples
+
+```csharp
+[TestClass]
+public class IntegrationTests
+{
+    [TestMethod]
+    public async Task ApiReturnsProducts()
+    {
+        var builder = await DistributedApplicationTestingBuilder
+            .CreateAsync<Projects.AppHost>();
+
+        await using var app = await builder.BuildAsync();
+        await app.StartAsync();
+
+        var client = app.CreateHttpClient("api");
+        var response = await client.GetAsync("/products");
+
+        Assert.AreEqual(HttpStatusCode.OK, response.StatusCode);
+    }
+}
+```
+
+---
+
+## NUnit examples
+
+```csharp
+[TestFixture]
+public class IntegrationTests
+{
+    [Test]
+    public async Task ApiReturnsProducts()
+    {
+        var builder = await DistributedApplicationTestingBuilder
+            .CreateAsync<Projects.AppHost>();
+
+        await using var app = await builder.BuildAsync();
+        await app.StartAsync();
+
+        var client = app.CreateHttpClient("api");
+        var response = await client.GetAsync("/products");
+
+        Assert.That(response.StatusCode, Is.EqualTo(HttpStatusCode.OK));
+    }
+}
+```
+
+---
+
+## Customizing the test AppHost
+
+### Override resources
+
+```csharp
+var builder = await DistributedApplicationTestingBuilder
+    .CreateAsync<Projects.AppHost>();
+
+// Replace a real database with a test container
+builder.Services.ConfigureHttpClientDefaults(http =>
+{
+    http.AddStandardResilienceHandler();
+});
+
+// Add test-specific configuration
+builder.Configuration["TestMode"] = "true";
+
+await using var app = await builder.BuildAsync();
+await app.StartAsync();
+```
+
+### Exclude resources
+
+```csharp
+var builder = await DistributedApplicationTestingBuilder
+    .CreateAsync<Projects.AppHost>(args =>
+    {
+        // Don't start the worker for API-only tests
+        args.Args = ["--exclude-resource", "worker"];
+    });
+```
+
+### Test with specific environment
+
+```csharp
+var builder = await DistributedApplicationTestingBuilder
+    .CreateAsync<Projects.AppHost>(args =>
+    {
+        args.Args = ["--environment", "Testing"];
+    });
+```
+
+---
+
+## Connection string access
+
+```csharp
+// Get the connection string for a resource in tests
+var connectionString = await app.GetConnectionStringAsync("db");
+
+// Use it to query the database directly in tests
+using var conn = new NpgsqlConnection(connectionString);
+await conn.OpenAsync();
+var count = await conn.ExecuteScalarAsync<int>("SELECT COUNT(*) FROM products");
+Assert.True(count > 0);
+```
+
+---
+
+## Best practices
+
+1. **Use `WaitForResourceReadyAsync`** before making requests — ensures all dependencies are healthy
+2. **Each test should be independent** — don't rely on state from previous tests
+3. **Use `await using`** for the app — ensures cleanup even on test failure
+4. **Test real infrastructure** — Aspire spins up real containers (Redis, PostgreSQL, etc.), giving you high-fidelity integration tests
+5. **Keep test AppHost lean** — exclude resources you don't need for specific test scenarios
+6. **Use test-specific configuration** — override settings for test isolation
+7. **Timeout protection** — set reasonable test timeouts since containers take time to start:
+
+```csharp
+[Fact(Timeout = 120_000)]  // 2 minutes
+public async Task SlowIntegrationTest() { ... }
+```
+
+---
+
+## Project structure
+
+```
+MyApp/
+├── src/
+│   ├── MyApp.AppHost/           # AppHost project
+│   ├── MyApp.Api/               # API service
+│   ├── MyApp.Worker/            # Worker service
+│   └── MyApp.ServiceDefaults/   # Shared defaults
+└── tests/
+    └── MyApp.Tests/             # Integration tests
+        ├── MyApp.Tests.csproj   # References AppHost + Testing package
+        └── ApiTests.cs          # Test classes
+```
+
+```xml
+<!-- MyApp.Tests.csproj -->
+<Project Sdk="Microsoft.NET.Sdk">
+  <PropertyGroup>
+    <TargetFramework>net10.0</TargetFramework>
+    <IsAspireTestProject>true</IsAspireTestProject>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Aspire.Hosting.Testing" Version="*" />
+    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="*" />
+    <PackageReference Include="xunit" Version="*" />
+    <PackageReference Include="xunit.runner.visualstudio" Version="*" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\..\src\MyApp.AppHost\MyApp.AppHost.csproj" />
+  </ItemGroup>
+</Project>
+```

package/skills/aspire/references/troubleshooting.md

@@ -0,0 +1,194 @@
+# Troubleshooting — Diagnostics & Common Issues
+
+---
+
+## Diagnostic Codes
+
+Aspire emits diagnostic codes for common issues. These appear in build warnings/errors and IDE diagnostics.
+
+### Standard diagnostics
+
+| Code          | Severity | Description                                                |
+| ------------- | -------- | ---------------------------------------------------------- |
+| **ASPIRE001** | Warning  | Resource name contains invalid characters                  |
+| **ASPIRE002** | Warning  | Duplicate resource name detected                           |
+| **ASPIRE003** | Error    | Missing required package reference                         |
+| **ASPIRE004** | Warning  | Deprecated API usage                                       |
+| **ASPIRE005** | Error    | Invalid endpoint configuration                             |
+| **ASPIRE006** | Warning  | Health check not configured for resource with `.WaitFor()` |
+| **ASPIRE007** | Warning  | Container image tag not specified (using `latest`)         |
+| **ASPIRE008** | Error    | Circular dependency detected in resource graph             |
+
+### Experimental diagnostics (ASPIREHOSTINGX\*)
+
+These codes indicate usage of experimental/preview APIs. They may require `#pragma warning disable` or `<NoWarn>` if you intentionally use experimental features:
+
+| Code                      | Area                             |
+| ------------------------- | -------------------------------- |
+| ASPIRE_HOSTINGX_0001–0005 | Experimental hosting APIs        |
+| ASPIRE_HOSTINGX_0006–0010 | Experimental integration APIs    |
+| ASPIRE_HOSTINGX_0011–0015 | Experimental deployment APIs     |
+| ASPIRE_HOSTINGX_0016–0022 | Experimental resource model APIs |
+
+To suppress experimental warnings:
+
+```xml
+<!-- In .csproj -->
+<PropertyGroup>
+  <NoWarn>$(NoWarn);ASPIRE_HOSTINGX_0001</NoWarn>
+</PropertyGroup>
+```
+
+Or per-line:
+
+```csharp
+#pragma warning disable ASPIRE_HOSTINGX_0001
+var resource = builder.AddExperimentalResource("test");
+#pragma warning restore ASPIRE_HOSTINGX_0001
+```
+
+---
+
+## Common Issues & Solutions
+
+### Container runtime
+
+| Problem                           | Solution                                                                                               |
+| --------------------------------- | ------------------------------------------------------------------------------------------------------ |
+| "Cannot connect to Docker daemon" | Start Docker Desktop / Podman / Rancher Desktop                                                        |
+| Container fails to start          | Check `docker ps -a` for exit codes; check dashboard console logs                                      |
+| Port already in use               | Another process is using the port; Aspire auto-assigns, but `targetPort` must be free on the container |
+| Container image pull fails        | Check network connectivity; verify image name and tag                                                  |
+| "Permission denied" on Linux      | Add user to `docker` group: `sudo usermod -aG docker $USER`                                            |
+
+### Service discovery
+
+| Problem                       | Solution                                                                     |
+| ----------------------------- | ---------------------------------------------------------------------------- |
+| Service can't find dependency | Verify `.WithReference()` in AppHost; check env vars in dashboard            |
+| Connection string is null     | The reference resource name doesn't match; check `ConnectionStrings__<name>` |
+| Wrong port in service URL     | Check `targetPort` vs actual service listen port                             |
+| Env var not set               | Rebuild AppHost; verify resource name matches exactly                        |
+
+### Python workloads
+
+| Problem                           | Solution                                                        |
+| --------------------------------- | --------------------------------------------------------------- |
+| "Python not found"                | Ensure Python is on PATH; specify full path in `AddPythonApp()` |
+| venv not found                    | Use `.WithVirtualEnvironment()` or create venv manually         |
+| pip packages fail to install      | Use `.WithPipPackages()` or install in venv before `aspire run` |
+| ModuleNotFoundError               | venv isn't activated; `.WithVirtualEnvironment()` handles this  |
+| "Port already in use" for Uvicorn | Check `targetPort` — another instance may be running            |
+
+### JavaScript / TypeScript workloads
+
+| Problem                       | Solution                                                         |
+| ----------------------------- | ---------------------------------------------------------------- |
+| "node_modules not found"      | Use `.WithNpmPackageInstallation()` to auto-install              |
+| npm install fails             | Check `package.json` is valid; check npm registry connectivity   |
+| Vite dev server won't start   | Verify `vite` is in devDependencies; check Vite config           |
+| Port mismatch                 | Ensure `targetPort` matches the port in your JS framework config |
+| TypeScript compilation errors | These happen in the service, not Aspire — check service logs     |
+
+### Go workloads
+
+| Problem                    | Solution                                                   |
+| -------------------------- | ---------------------------------------------------------- |
+| "go not found"             | Ensure Go is installed and on PATH                         |
+| Build fails                | Check `go.mod` exists in working directory                 |
+| "no Go files in directory" | Verify `workingDir` points to the directory with `main.go` |
+
+### Java workloads
+
+| Problem                  | Solution                                                |
+| ------------------------ | ------------------------------------------------------- |
+| "java not found"         | Ensure JDK is installed and `JAVA_HOME` is set          |
+| Maven/Gradle build fails | Verify build files exist; check build tool installation |
+| Spring Boot won't start  | Check `application.properties`; verify main class       |
+
+### Rust workloads
+
+| Problem              | Solution                                                             |
+| -------------------- | -------------------------------------------------------------------- |
+| "cargo not found"    | Install Rust via rustup                                              |
+| Build takes too long | Rust compile times are normal; use `.WithCargoBuild()` for pre-build |
+
+### Health checks & startup
+
+| Problem                      | Solution                                                                       |
+| ---------------------------- | ------------------------------------------------------------------------------ |
+| Resource stuck in "Starting" | Health check endpoint not responding; check service logs                       |
+| `.WaitFor()` timeout         | Increase timeout or fix health endpoint; default is 30 seconds                 |
+| Health check always fails    | Verify endpoint path (default: `/health`); check service binds to correct port |
+| Cascading startup failures   | A dependency failed; check the root resource first                             |
+
+### Dashboard
+
+| Problem                               | Solution                                                                  |
+| ------------------------------------- | ------------------------------------------------------------------------- |
+| Dashboard doesn't open                | Check terminal for URL; use `--dashboard-port` for fixed port             |
+| No logs appearing                     | Service may not be writing to stdout/stderr; check console output         |
+| No traces for non-.NET services       | Configure OpenTelemetry SDK in the service; see [Dashboard](dashboard.md) |
+| Traces don't show cross-service calls | Propagate trace context headers (`traceparent`, `tracestate`)             |
+
+### Build & configuration
+
+| Problem                                   | Solution                                                            |
+| ----------------------------------------- | ------------------------------------------------------------------- |
+| "Project not found" for `AddProject<T>()` | Ensure `.csproj` is in the solution and referenced by AppHost       |
+| Package version conflicts                 | Pin all Aspire packages to the same version                         |
+| AppHost won't build                       | Check `Aspire.AppHost.Sdk` is in the project; run `dotnet restore`  |
+| `aspire run` build error                  | Fix the build error first; `aspire run` requires a successful build |
+
+### Deployment
+
+| Problem                                  | Solution                                                             |
+| ---------------------------------------- | -------------------------------------------------------------------- |
+| `aspire publish` fails                   | Check publisher package is installed (e.g., `Aspire.Hosting.Docker`) |
+| Generated Bicep has errors               | Check for unsupported resource configurations                        |
+| Container image push fails               | Verify registry credentials and permissions                          |
+| Missing connection strings in deployment | Check generated ConfigMaps/Secrets match resource names              |
+
+---
+
+## Debugging strategies
+
+### 1. Check the dashboard first
+
+The dashboard shows resource state, logs, traces, and metrics. Start here for any issue.
+
+### 2. Check environment variables
+
+In the dashboard, click a resource to see all injected environment variables. Verify connection strings and service URLs are correct.
+
+### 3. Read console logs
+
+Dashboard → Console Logs → filter by the failing resource. Raw stdout/stderr often contains the root cause.
+
+### 4. Check the DAG
+
+If services fail to start, check the dependency order. A failed dependency blocks all downstream resources.
+
+### 5. Use MCP for AI-assisted debugging
+
+If MCP is configured (see [MCP Server](mcp-server.md)), ask your AI assistant:
+
+- "What resources are failing?"
+- "Show me the logs for [service]"
+- "What traces show errors?"
+
+### 6. Isolate the problem
+
+Run just the failing resource by commenting out others in the AppHost. This narrows whether the issue is the resource itself or a dependency.
+
+---
+
+## Getting help
+
+| Channel                 | URL                                            |
+| ----------------------- | ---------------------------------------------- |
+| GitHub Issues (runtime) | https://github.com/dotnet/aspire/issues        |
+| GitHub Issues (docs)    | https://github.com/microsoft/aspire.dev/issues |
+| Discord                 | https://aka.ms/aspire/discord                  |
+| Stack Overflow          | Tag: `dotnet-aspire`                           |
+| Reddit                  | https://www.reddit.com/r/aspiredotdev/         |

package/skills/aspnet-minimal-api-openapi/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright GitHub, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/skills/aspnet-minimal-api-openapi/SKILL.md

@@ -0,0 +1,41 @@
+---
+name: aspnet-minimal-api-openapi
+description: 'Create ASP.NET Minimal API endpoints with proper OpenAPI documentation'
+---
+
+# ASP.NET Minimal API with OpenAPI
+
+Your goal is to help me create well-structured ASP.NET Minimal API endpoints with correct types and comprehensive OpenAPI/Swagger documentation.
+
+## API Organization
+
+- Group related endpoints using `MapGroup()` extension
+- Use endpoint filters for cross-cutting concerns
+- Structure larger APIs with separate endpoint classes
+- Consider using a feature-based folder structure for complex APIs
+
+## Request and Response Types
+
+- Define explicit request and response DTOs/models
+- Create clear model classes with proper validation attributes
+- Use record types for immutable request/response objects
+- Use meaningful property names that align with API design standards
+- Apply `[Required]` and other validation attributes to enforce constraints
+- Use the ProblemDetailsService and StatusCodePages to get standard error responses
+
+## Type Handling
+
+- Use strongly-typed route parameters with explicit type binding
+- Use `Results<T1, T2>` to represent multiple response types
+- Return `TypedResults` instead of `Results` for strongly-typed responses
+- Leverage C# 10+ features like nullable annotations and init-only properties
+
+## OpenAPI Documentation
+
+- Use the built-in OpenAPI document support added in .NET 9
+- Define operation summary and description
+- Add operationIds using the `WithName` extension method
+- Add descriptions to properties and parameters with `[Description()]`
+- Set proper content types for requests and responses
+- Use document transformers to add elements like servers, tags, and security schemes
+- Use schema transformers to apply customizations to OpenAPI schemas

package/skills/aspnet-minimal-api-openapi/SYNC.md

@@ -0,0 +1,5 @@
+# Sync Info
+
+- **Source:** `vendor/awesome-copilot/skills/aspnet-minimal-api-openapi`
+- **Git SHA:** `23fb7006c132a0bba75b0e5af7a35cab11272812`
+- **Synced:** 2026-03-24

package/skills/automate-this/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright GitHub, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.