codehava-agent-kit 1.0.1 → 3.0.0

package/templates/.agent/skills/azure-mgmt-mongodbatlas-dotnet/SKILL.md

@@ -0,0 +1,359 @@
+---
+name: azure-mgmt-mongodbatlas-dotnet
+description: "Manage MongoDB Atlas Organizations as Azure ARM resources with unified billing through Azure Marketplace."
+risk: unknown
+source: community
+date_added: "2026-02-27"
+---
+
+# Azure.ResourceManager.MongoDBAtlas SDK
+
+Manage MongoDB Atlas Organizations as Azure ARM resources with unified billing through Azure Marketplace.
+
+## Package Information
+
+| Property | Value |
+|----------|-------|
+| Package | `Azure.ResourceManager.MongoDBAtlas` |
+| Version | 1.0.0 (GA) |
+| API Version | 2025-06-01 |
+| Resource Type | `MongoDB.Atlas/organizations` |
+| NuGet | [Azure.ResourceManager.MongoDBAtlas](https://www.nuget.org/packages/Azure.ResourceManager.MongoDBAtlas) |
+
+## Installation
+
+```bash
+dotnet add package Azure.ResourceManager.MongoDBAtlas
+dotnet add package Azure.Identity
+dotnet add package Azure.ResourceManager
+```
+
+## Important Scope Limitation
+
+This SDK manages **MongoDB Atlas Organizations as Azure ARM resources** for marketplace integration. It does NOT directly manage:
+- Atlas clusters
+- Databases
+- Collections
+- Users/roles
+
+For cluster management, use the MongoDB Atlas API directly after creating the organization.
+
+## Authentication
+
+```csharp
+using Azure.Identity;
+using Azure.ResourceManager;
+using Azure.ResourceManager.MongoDBAtlas;
+using Azure.ResourceManager.MongoDBAtlas.Models;
+
+// Create ARM client with DefaultAzureCredential
+var credential = new DefaultAzureCredential();
+var armClient = new ArmClient(credential);
+```
+
+## Core Types
+
+| Type | Purpose |
+|------|---------|
+| `MongoDBAtlasOrganizationResource` | ARM resource representing an Atlas organization |
+| `MongoDBAtlasOrganizationCollection` | Collection of organizations in a resource group |
+| `MongoDBAtlasOrganizationData` | Data model for organization resource |
+| `MongoDBAtlasOrganizationProperties` | Organization-specific properties |
+| `MongoDBAtlasMarketplaceDetails` | Azure Marketplace subscription details |
+| `MongoDBAtlasOfferDetails` | Marketplace offer configuration |
+| `MongoDBAtlasUserDetails` | User information for the organization |
+| `MongoDBAtlasPartnerProperties` | MongoDB-specific properties (org name, ID) |
+
+## Workflows
+
+### Get Organization Collection
+
+```csharp
+// Get resource group
+var subscription = await armClient.GetDefaultSubscriptionAsync();
+var resourceGroup = await subscription.GetResourceGroupAsync("my-resource-group");
+
+// Get organizations collection
+MongoDBAtlasOrganizationCollection organizations = 
+    resourceGroup.Value.GetMongoDBAtlasOrganizations();
+```
+
+### Create Organization
+
+```csharp
+var organizationName = "my-atlas-org";
+var location = AzureLocation.EastUS2;
+
+// Build organization data
+var organizationData = new MongoDBAtlasOrganizationData(location)
+{
+    Properties = new MongoDBAtlasOrganizationProperties(
+        marketplace: new MongoDBAtlasMarketplaceDetails(
+            subscriptionId: "your-azure-subscription-id",
+            offerDetails: new MongoDBAtlasOfferDetails(
+                publisherId: "mongodb",
+                offerId: "mongodb_atlas_azure_native_prod",
+                planId: "private_plan",
+                planName: "Pay as You Go (Free) (Private)",
+                termUnit: "P1M",
+                termId: "gmz7xq9ge3py"
+            )
+        ),
+        user: new MongoDBAtlasUserDetails(
+            emailAddress: "admin@example.com",
+            upn: "admin@example.com"
+        )
+        {
+            FirstName = "Admin",
+            LastName = "User"
+        }
+    )
+    {
+        PartnerProperties = new MongoDBAtlasPartnerProperties
+        {
+            OrganizationName = organizationName
+        }
+    },
+    Tags = { ["Environment"] = "Production" }
+};
+
+// Create the organization (long-running operation)
+var operation = await organizations.CreateOrUpdateAsync(
+    WaitUntil.Completed,
+    organizationName,
+    organizationData
+);
+
+MongoDBAtlasOrganizationResource organization = operation.Value;
+Console.WriteLine($"Created: {organization.Id}");
+```
+
+### Get Existing Organization
+
+```csharp
+// Option 1: From collection
+MongoDBAtlasOrganizationResource org = 
+    await organizations.GetAsync("my-atlas-org");
+
+// Option 2: From resource identifier
+var resourceId = MongoDBAtlasOrganizationResource.CreateResourceIdentifier(
+    subscriptionId: "subscription-id",
+    resourceGroupName: "my-resource-group",
+    organizationName: "my-atlas-org"
+);
+MongoDBAtlasOrganizationResource org2 = 
+    armClient.GetMongoDBAtlasOrganizationResource(resourceId);
+await org2.GetAsync(); // Fetch data
+```
+
+### List Organizations
+
+```csharp
+// List in resource group
+await foreach (var org in organizations.GetAllAsync())
+{
+    Console.WriteLine($"Org: {org.Data.Name}");
+    Console.WriteLine($"  Location: {org.Data.Location}");
+    Console.WriteLine($"  State: {org.Data.Properties?.ProvisioningState}");
+}
+
+// List across subscription
+await foreach (var org in subscription.GetMongoDBAtlasOrganizationsAsync())
+{
+    Console.WriteLine($"Org: {org.Data.Name} in {org.Data.Id}");
+}
+```
+
+### Update Tags
+
+```csharp
+// Add a single tag
+await organization.AddTagAsync("CostCenter", "12345");
+
+// Replace all tags
+await organization.SetTagsAsync(new Dictionary<string, string>
+{
+    ["Environment"] = "Production",
+    ["Team"] = "Platform"
+});
+
+// Remove a tag
+await organization.RemoveTagAsync("OldTag");
+```
+
+### Update Organization Properties
+
+```csharp
+var patch = new MongoDBAtlasOrganizationPatch
+{
+    Tags = { ["UpdatedAt"] = DateTime.UtcNow.ToString("o") },
+    Properties = new MongoDBAtlasOrganizationUpdateProperties
+    {
+        // Update user details if needed
+        User = new MongoDBAtlasUserDetails(
+            emailAddress: "newadmin@example.com",
+            upn: "newadmin@example.com"
+        )
+    }
+};
+
+var updateOperation = await organization.UpdateAsync(
+    WaitUntil.Completed,
+    patch
+);
+```
+
+### Delete Organization
+
+```csharp
+// Delete (long-running operation)
+await organization.DeleteAsync(WaitUntil.Completed);
+```
+
+## Model Properties Reference
+
+### MongoDBAtlasOrganizationProperties
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `Marketplace` | `MongoDBAtlasMarketplaceDetails` | Required. Marketplace subscription details |
+| `User` | `MongoDBAtlasUserDetails` | Required. Organization admin user |
+| `PartnerProperties` | `MongoDBAtlasPartnerProperties` | MongoDB-specific properties |
+| `ProvisioningState` | `MongoDBAtlasResourceProvisioningState` | Read-only. Current provisioning state |
+
+### MongoDBAtlasMarketplaceDetails
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `SubscriptionId` | `string` | Required. Azure subscription ID for billing |
+| `OfferDetails` | `MongoDBAtlasOfferDetails` | Required. Marketplace offer configuration |
+| `SubscriptionStatus` | `MarketplaceSubscriptionStatus` | Read-only. Subscription status |
+
+### MongoDBAtlasOfferDetails
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `PublisherId` | `string` | Required. Publisher ID (typically "mongodb") |
+| `OfferId` | `string` | Required. Offer ID |
+| `PlanId` | `string` | Required. Plan ID |
+| `PlanName` | `string` | Required. Display name of the plan |
+| `TermUnit` | `string` | Required. Billing term unit (e.g., "P1M") |
+| `TermId` | `string` | Required. Term identifier |
+
+### MongoDBAtlasUserDetails
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `EmailAddress` | `string` | Required. User email address |
+| `Upn` | `string` | Required. User principal name |
+| `FirstName` | `string` | Optional. User first name |
+| `LastName` | `string` | Optional. User last name |
+
+### MongoDBAtlasPartnerProperties
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `OrganizationName` | `string` | Name of the MongoDB Atlas organization |
+| `OrganizationId` | `string` | Read-only. MongoDB Atlas organization ID |
+
+## Provisioning States
+
+| State | Description |
+|-------|-------------|
+| `Succeeded` | Resource provisioned successfully |
+| `Failed` | Provisioning failed |
+| `Canceled` | Provisioning was canceled |
+| `Provisioning` | Resource is being provisioned |
+| `Updating` | Resource is being updated |
+| `Deleting` | Resource is being deleted |
+| `Accepted` | Request accepted, provisioning starting |
+
+## Marketplace Subscription Status
+
+| Status | Description |
+|--------|-------------|
+| `PendingFulfillmentStart` | Subscription pending activation |
+| `Subscribed` | Active subscription |
+| `Suspended` | Subscription suspended |
+| `Unsubscribed` | Subscription canceled |
+
+## Best Practices
+
+### Use Async Methods
+
+```csharp
+// Prefer async for all operations
+var org = await organizations.GetAsync("my-org");
+await org.Value.AddTagAsync("key", "value");
+```
+
+### Handle Long-Running Operations
+
+```csharp
+// Wait for completion
+var operation = await organizations.CreateOrUpdateAsync(
+    WaitUntil.Completed,  // Blocks until done
+    name,
+    data
+);
+
+// Or start and poll later
+var operation = await organizations.CreateOrUpdateAsync(
+    WaitUntil.Started,  // Returns immediately
+    name,
+    data
+);
+
+// Poll for completion
+while (!operation.HasCompleted)
+{
+    await Task.Delay(TimeSpan.FromSeconds(5));
+    await operation.UpdateStatusAsync();
+}
+```
+
+### Check Provisioning State
+
+```csharp
+var org = await organizations.GetAsync("my-org");
+if (org.Value.Data.Properties?.ProvisioningState == 
+    MongoDBAtlasResourceProvisioningState.Succeeded)
+{
+    Console.WriteLine("Organization is ready");
+}
+```
+
+### Use Resource Identifiers
+
+```csharp
+// Create identifier without API call
+var resourceId = MongoDBAtlasOrganizationResource.CreateResourceIdentifier(
+    subscriptionId,
+    resourceGroupName,
+    organizationName
+);
+
+// Get resource handle (no data yet)
+var orgResource = armClient.GetMongoDBAtlasOrganizationResource(resourceId);
+
+// Fetch data when needed
+var response = await orgResource.GetAsync();
+```
+
+## Common Errors
+
+| Error | Cause | Solution |
+|-------|-------|----------|
+| `ResourceNotFound` | Organization doesn't exist | Verify name and resource group |
+| `AuthorizationFailed` | Insufficient permissions | Check RBAC roles on resource group |
+| `InvalidParameter` | Missing required properties | Ensure all required fields are set |
+| `MarketplaceError` | Marketplace subscription issue | Verify offer details and subscription |
+
+## Related Resources
+
+- [Microsoft Learn: MongoDB Atlas on Azure](https://learn.microsoft.com/en-us/azure/partner-solutions/mongodb-atlas/)
+- [API Reference](https://learn.microsoft.com/en-us/dotnet/api/azure.resourcemanager.mongodbatlas)
+- [Azure SDK for .NET](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/mongodbatlas)
+
+## When to Use
+This skill is applicable to execute the workflow or actions described in the overview.

package/templates/.agent/skills/azure-microsoft-playwright-testing-ts/SKILL.md

@@ -0,0 +1,307 @@
+---
+name: azure-microsoft-playwright-testing-ts
+description: "Run Playwright tests at scale with cloud-hosted browsers and integrated Azure portal reporting."
+risk: unknown
+source: community
+date_added: "2026-02-27"
+---
+
+# Azure Playwright Workspaces SDK for TypeScript
+
+Run Playwright tests at scale with cloud-hosted browsers and integrated Azure portal reporting.
+
+> **Migration Notice:** `@azure/microsoft-playwright-testing` is retired on **March 8, 2026**. Use `@azure/playwright` instead. See [migration guide](https://aka.ms/mpt/migration-guidance).
+
+## Installation
+
+```bash
+# Recommended: Auto-generates config
+npm init @azure/playwright@latest
+
+# Manual installation
+npm install @azure/playwright --save-dev
+npm install @playwright/test@^1.47 --save-dev
+npm install @azure/identity --save-dev
+```
+
+**Requirements:**
+- Playwright version 1.47+ (basic usage)
+- Playwright version 1.57+ (Azure reporter features)
+
+## Environment Variables
+
+```bash
+PLAYWRIGHT_SERVICE_URL=wss://eastus.api.playwright.microsoft.com/playwrightworkspaces/{workspace-id}/browsers
+```
+
+## Authentication
+
+### Microsoft Entra ID (Recommended)
+
+```bash
+# Sign in with Azure CLI
+az login
+```
+
+```typescript
+// playwright.service.config.ts
+import { defineConfig } from "@playwright/test";
+import { createAzurePlaywrightConfig, ServiceOS } from "@azure/playwright";
+import { DefaultAzureCredential } from "@azure/identity";
+import config from "./playwright.config";
+
+export default defineConfig(
+  config,
+  createAzurePlaywrightConfig(config, {
+    os: ServiceOS.LINUX,
+    credential: new DefaultAzureCredential(),
+  })
+);
+```
+
+### Custom Credential
+
+```typescript
+import { ManagedIdentityCredential } from "@azure/identity";
+import { createAzurePlaywrightConfig } from "@azure/playwright";
+
+export default defineConfig(
+  config,
+  createAzurePlaywrightConfig(config, {
+    credential: new ManagedIdentityCredential(),
+  })
+);
+```
+
+## Core Workflow
+
+### Service Configuration
+
+```typescript
+// playwright.service.config.ts
+import { defineConfig } from "@playwright/test";
+import { createAzurePlaywrightConfig, ServiceOS } from "@azure/playwright";
+import { DefaultAzureCredential } from "@azure/identity";
+import config from "./playwright.config";
+
+export default defineConfig(
+  config,
+  createAzurePlaywrightConfig(config, {
+    os: ServiceOS.LINUX,
+    connectTimeout: 30000,
+    exposeNetwork: "<loopback>",
+    credential: new DefaultAzureCredential(),
+  })
+);
+```
+
+### Run Tests
+
+```bash
+npx playwright test --config=playwright.service.config.ts --workers=20
+```
+
+### With Azure Reporter
+
+```typescript
+import { defineConfig } from "@playwright/test";
+import { createAzurePlaywrightConfig, ServiceOS } from "@azure/playwright";
+import { DefaultAzureCredential } from "@azure/identity";
+import config from "./playwright.config";
+
+export default defineConfig(
+  config,
+  createAzurePlaywrightConfig(config, {
+    os: ServiceOS.LINUX,
+    credential: new DefaultAzureCredential(),
+  }),
+  {
+    reporter: [
+      ["html", { open: "never" }],
+      ["@azure/playwright/reporter"],
+    ],
+  }
+);
+```
+
+### Manual Browser Connection
+
+```typescript
+import playwright, { test, expect, BrowserType } from "@playwright/test";
+import { getConnectOptions } from "@azure/playwright";
+
+test("manual connection", async ({ browserName }) => {
+  const { wsEndpoint, options } = await getConnectOptions();
+  const browser = await (playwright[browserName] as BrowserType).connect(wsEndpoint, options);
+  const context = await browser.newContext();
+  const page = await context.newPage();
+
+  await page.goto("https://example.com");
+  await expect(page).toHaveTitle(/Example/);
+
+  await browser.close();
+});
+```
+
+## Configuration Options
+
+```typescript
+type PlaywrightServiceAdditionalOptions = {
+  serviceAuthType?: "ENTRA_ID" | "ACCESS_TOKEN";  // Default: ENTRA_ID
+  os?: "linux" | "windows";                        // Default: linux
+  runName?: string;                                // Custom run name for portal
+  connectTimeout?: number;                         // Default: 30000ms
+  exposeNetwork?: string;                          // Default: <loopback>
+  credential?: TokenCredential;                    // REQUIRED for Entra ID
+};
+```
+
+### ServiceOS Enum
+
+```typescript
+import { ServiceOS } from "@azure/playwright";
+
+// Available values
+ServiceOS.LINUX   // "linux" - default
+ServiceOS.WINDOWS // "windows"
+```
+
+### ServiceAuth Enum
+
+```typescript
+import { ServiceAuth } from "@azure/playwright";
+
+// Available values
+ServiceAuth.ENTRA_ID      // Recommended - uses credential
+ServiceAuth.ACCESS_TOKEN  // Use PLAYWRIGHT_SERVICE_ACCESS_TOKEN env var
+```
+
+## CI/CD Integration
+
+### GitHub Actions
+
+```yaml
+name: playwright-ts
+on: [push, pull_request]
+
+permissions:
+  id-token: write
+  contents: read
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Azure Login
+        uses: azure/login@v2
+        with:
+          client-id: ${{ secrets.AZURE_CLIENT_ID }}
+          tenant-id: ${{ secrets.AZURE_TENANT_ID }}
+          subscription-id: ${{ secrets.AZURE_SUBSCRIPTION_ID }}
+
+      - run: npm ci
+      
+      - name: Run Tests
+        env:
+          PLAYWRIGHT_SERVICE_URL: ${{ secrets.PLAYWRIGHT_SERVICE_URL }}
+        run: npx playwright test -c playwright.service.config.ts --workers=20
+```
+
+### Azure Pipelines
+
+```yaml
+- task: AzureCLI@2
+  displayName: Run Playwright Tests
+  env:
+    PLAYWRIGHT_SERVICE_URL: $(PLAYWRIGHT_SERVICE_URL)
+  inputs:
+    azureSubscription: My_Service_Connection
+    scriptType: pscore
+    inlineScript: |
+      npx playwright test -c playwright.service.config.ts --workers=20
+    addSpnToEnvironment: true
+```
+
+## Key Types
+
+```typescript
+import {
+  createAzurePlaywrightConfig,
+  getConnectOptions,
+  ServiceOS,
+  ServiceAuth,
+  ServiceEnvironmentVariable,
+} from "@azure/playwright";
+
+import type {
+  OsType,
+  AuthenticationType,
+  BrowserConnectOptions,
+  PlaywrightServiceAdditionalOptions,
+} from "@azure/playwright";
+```
+
+## Migration from Old Package
+
+| Old (`@azure/microsoft-playwright-testing`) | New (`@azure/playwright`) |
+|---------------------------------------------|---------------------------|
+| `getServiceConfig()` | `createAzurePlaywrightConfig()` |
+| `timeout` option | `connectTimeout` option |
+| `runId` option | `runName` option |
+| `useCloudHostedBrowsers` option | Removed (always enabled) |
+| `@azure/microsoft-playwright-testing/reporter` | `@azure/playwright/reporter` |
+| Implicit credential | Explicit `credential` parameter |
+
+### Before (Old)
+
+```typescript
+import { getServiceConfig, ServiceOS } from "@azure/microsoft-playwright-testing";
+
+export default defineConfig(
+  config,
+  getServiceConfig(config, {
+    os: ServiceOS.LINUX,
+    timeout: 30000,
+    useCloudHostedBrowsers: true,
+  }),
+  {
+    reporter: [["@azure/microsoft-playwright-testing/reporter"]],
+  }
+);
+```
+
+### After (New)
+
+```typescript
+import { createAzurePlaywrightConfig, ServiceOS } from "@azure/playwright";
+import { DefaultAzureCredential } from "@azure/identity";
+
+export default defineConfig(
+  config,
+  createAzurePlaywrightConfig(config, {
+    os: ServiceOS.LINUX,
+    connectTimeout: 30000,
+    credential: new DefaultAzureCredential(),
+  }),
+  {
+    reporter: [
+      ["html", { open: "never" }],
+      ["@azure/playwright/reporter"],
+    ],
+  }
+);
+```
+
+## Best Practices
+
+1. **Use Entra ID auth** — More secure than access tokens
+2. **Provide explicit credential** — Always pass `credential: new DefaultAzureCredential()`
+3. **Enable artifacts** — Set `trace: "on-first-retry"`, `video: "retain-on-failure"` in config
+4. **Scale workers** — Use `--workers=20` or higher for parallel execution
+5. **Region selection** — Choose region closest to your test targets
+6. **HTML reporter first** — When using Azure reporter, list HTML reporter before Azure reporter
+
+## When to Use
+This skill is applicable to execute the workflow or actions described in the overview.