@nockdev/awf 6.2.0

package/.agent/skills/cross-cutting/testing/SKILL.md

@@ -0,0 +1,263 @@
+---
+name: testing
+detect:
+  [
+    "*.test.*",
+    "*.spec.*",
+    "jest.config.*",
+    "vitest.config.*",
+    "playwright.config.*",
+  ]
+version: "6.1.2"
+---
+
+# Testing Patterns (2026)
+
+> Comprehensive testing skill with data-driven references. Check `data/` for lookup tables.
+
+## 📦 Data Files
+
+| File             | Content                                         | Records |
+| ---------------- | ----------------------------------------------- | ------- |
+| `frameworks.csv` | Testing frameworks across 12 languages          | 20      |
+| `patterns.csv`   | Testing patterns, best practices, anti-patterns | 15      |
+
+## 📦 Testing Frameworks
+
+### Unit/Integration
+
+| Framework   | Language      |
+| ----------- | ------------- |
+| **Vitest**  | TypeScript 🏆 |
+| **Jest**    | JavaScript    |
+| **Pytest**  | Python        |
+| **Go test** | Go            |
+
+### E2E
+
+| Framework      | Use Case           |
+| -------------- | ------------------ |
+| **Playwright** | Cross-browser 🏆   |
+| **Cypress**    | Developer friendly |
+
+### API
+
+- **Supertest**: Node.js API testing
+- **Httpx**: Python async
+
+## Test Structure (AAA)
+
+```typescript
+describe("UserService", () => {
+  it("should create a user", async () => {
+    // Arrange
+    const input = { email: "test@test.com", name: "Test" };
+
+    // Act
+    const user = await service.createUser(input);
+
+    // Assert
+    expect(user.email).toBe(input.email);
+    expect(user.name).toBe(input.name);
+  });
+});
+```
+
+## Vitest (2025 Standard)
+
+```typescript
+// vitest.config.ts
+import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+  test: {
+    globals: true,
+    environment: "node",
+    coverage: {
+      provider: "v8",
+      reporter: ["text", "html"],
+      thresholds: { lines: 80 },
+    },
+  },
+});
+
+// Test file
+import { describe, it, expect, vi } from "vitest";
+
+describe("UserService", () => {
+  it("should fetch user", async () => {
+    const mockRepo = {
+      findById: vi.fn().mockResolvedValue({ id: 1, name: "Test" }),
+    };
+
+    const service = new UserService(mockRepo);
+    const user = await service.getUser(1);
+
+    expect(user.name).toBe("Test");
+    expect(mockRepo.findById).toHaveBeenCalledWith(1);
+  });
+});
+```
+
+## Playwright E2E
+
+```typescript
+import { test, expect } from "@playwright/test";
+
+test("should login successfully", async ({ page }) => {
+  await page.goto("/login");
+  await page.fill('[name="email"]', "test@test.com");
+  await page.fill('[name="password"]', "password123");
+  await page.click('button[type="submit"]');
+
+  await expect(page).toHaveURL("/dashboard");
+  await expect(page.locator("h1")).toContainText("Welcome");
+});
+```
+
+## Test Types
+
+| Type        | Coverage       | Speed  |
+| ----------- | -------------- | ------ |
+| Unit        | 80%+           | Fast   |
+| Integration | 60%+           | Medium |
+| E2E         | Critical paths | Slow   |
+
+## Mocking
+
+```typescript
+// ✅ Vitest mocking
+import { vi } from "vitest";
+
+const mockFetch = vi.fn().mockResolvedValue({
+  ok: true,
+  json: () => Promise.resolve({ data: [] }),
+});
+vi.stubGlobal("fetch", mockFetch);
+
+// ✅ Module mock
+vi.mock("./api", () => ({
+  fetchUsers: vi.fn().mockResolvedValue([]),
+}));
+```
+
+## Checklist
+
+- [ ] Units test pure logic?
+- [ ] Integration tests APIs?
+- [ ] E2E tests critical flows?
+- [ ] Mocks isolated?
+- [ ] Coverage >80%?
+
+---
+
+## 🌐 Browser Testing (Playwright Advanced)
+
+> **Source**: Anthropic Webapp Testing
+> **Purpose**: Test local web applications with reconnaissance-then-action pattern
+
+### Decision Tree
+
+```
+User task → Is it static HTML?
+    ├─ Yes → Read HTML file directly to identify selectors
+    │         └─ Write Playwright script using selectors
+    │
+    └─ No (dynamic webapp) → Is the server already running?
+        ├─ No → Use helper script + write Playwright script
+        │
+        └─ Yes → Reconnaissance-then-action:
+            1. Navigate and wait for networkidle
+            2. Take screenshot or inspect DOM
+            3. Identify selectors from rendered state
+            4. Execute actions with discovered selectors
+```
+
+### Reconnaissance Pattern
+
+```typescript
+import { test, expect } from "@playwright/test";
+
+test("dynamic content test", async ({ page }) => {
+  // Always wait for networkidle on dynamic apps
+  await page.goto("http://localhost:3000");
+  await page.waitForLoadState("networkidle"); // CRITICAL
+
+  // Option 1: Screenshot for visual inspection
+  await page.screenshot({ path: "/tmp/inspect.png", fullPage: true });
+
+  // Option 2: Inspect rendered DOM
+  const content = await page.content();
+  const buttons = await page.locator("button").all();
+
+  // Then execute actions with discovered selectors
+  await page.click('button:has-text("Submit")');
+});
+```
+
+### Common Pitfalls
+
+| ❌ Don't                             | ✅ Do                                   |
+| ------------------------------------ | --------------------------------------- |
+| Inspect DOM before waiting           | Wait for `networkidle` first            |
+| Use static selectors on dynamic apps | Discover selectors from rendered state  |
+| Skip screenshot debugging            | Use screenshots for visual confirmation |
+
+### Multi-Server Testing
+
+```typescript
+// Testing with backend + frontend
+test.describe("Full stack test", () => {
+  test.beforeAll(async () => {
+    // Servers managed externally or via fixtures
+  });
+
+  test("API integration", async ({ page }) => {
+    await page.goto("http://localhost:5173");
+    await page.waitForLoadState("networkidle");
+
+    // Verify frontend connects to backend
+    await expect(page.locator('[data-testid="user-list"]')).not.toBeEmpty();
+  });
+});
+```
+
+### Best Practices
+
+- Use `sync_playwright()` for synchronous scripts
+- Always close the browser when done
+- Use descriptive selectors: `text=`, `role=`, CSS selectors, or IDs
+- Add appropriate waits: `page.wait_for_selector()` or timeouts
+- Launch chromium in headless mode: `headless=True`
+
+---
+
+## 🔌 HSA Integration
+
+This skill is powered by HSA adapter for semantic search:
+
+```python
+from .agent.scripts.hsa.adapters import (
+    search_testing_patterns,
+    get_framework_for,
+    get_testing_pyramid,
+    get_mocking_patterns,
+)
+
+# Search testing patterns
+results = search_testing_patterns("mocking", language="python")
+
+# Get recommended framework
+framework = get_framework_for("typescript", test_type="e2e")
+# → {"name": "Playwright", "type": "e2e", ...}
+
+# Test pyramid strategy
+pyramid = get_testing_pyramid()
+# → Unit 70%, Integration 20%, E2E 10%
+```
+
+**Available Functions**: `search_testing_patterns`, `get_framework_for`, `get_testing_pattern`, `get_testing_pyramid`, `get_mocking_patterns`, `get_coverage_command`
+
+---
+
+_DOMYH Awesome Code — Testing Patterns (Data-Driven + HSA)_

package/.agent/skills/cross-cutting/testing/data/frameworks.yaml

@@ -0,0 +1,300 @@
+metadata:
+  skill: testing
+  domain: frameworks
+  version: 6.2.0
+  updated: "2026-02-05"
+  migrated_from: frameworks.csv
+  patterns_count: 20
+  columns:
+    - name
+    - language
+    - type
+    - install
+    - test_command
+    - assertion_style
+    - mocking
+    - coverage
+    - docs_url
+patterns:
+  - id: item_001
+    name: Jest
+    language: javascript
+    type: unit
+    install: npm i -D jest
+    test_command: npm test
+    assertion_style: expect(x).toBe(y)
+    mocking: jest.fn(), jest.mock()
+    coverage: --coverage
+    docs_url: https://jestjs.io
+    version_info:
+      current: "29.7.0"
+      min_supported: "27.0.0"
+      breaking_changes:
+        "29.0":
+          - "Node 14 dropped, requires Node 16+"
+          - "jest.useFakeTimers() default modern"
+          - "Snapshot format changed"
+        "28.0":
+          - "jest-environment-jsdom now separate package"
+          - "Test runner config changed"
+      version_patterns:
+        ">=29.0":
+          timer: "jest.useFakeTimers() default modern"
+          env: "npm i -D jest-environment-jsdom"
+          config: "jest.config.js with transform"
+        ">=27.0,<29.0":
+          timer: "jest.useFakeTimers('modern')"
+          config: "jest.config.js"
+  - id: item_002
+    name: Vitest
+    language: typescript
+    type: unit
+    install: npm i -D vitest
+    test_command: npm test
+    assertion_style: expect(x).toBe(y)
+    mocking: vi.fn(), vi.mock()
+    coverage: --coverage
+    docs_url: https://vitest.dev
+    # v6.2.0: Version-specific info
+    version_info:
+      current: "4.0.0"
+      min_supported: "2.0.0"
+      breaking_changes:
+        "4.0":
+          - "workspace.defineConfig deprecated → defineWorkspace"
+          - "Browser mode restructured"
+          - "Pool options renamed"
+          - "Chai expect deprecated for vi.expect"
+        "3.0":
+          - "globalSetup signature changed"
+          - "ESM-first configuration"
+      version_patterns:
+        ">=4.0":
+          config: "vitest.config.ts with defineConfig"
+          workspace: "vitest.workspace.ts with defineWorkspace"
+          browser: "browser.enabled with playwright provider"
+          mocking: "vi.fn(), vi.hoisted()"
+        ">=2.0,<4.0":
+          config: "vitest.config.ts"
+          workspace: "vitest.workspaces.ts"
+          mocking: "vi.fn(), vi.mock()"
+  - id: item_003
+    name: Mocha
+    language: javascript
+    type: unit
+    install: npm i -D mocha chai
+    test_command: npm test
+    assertion_style: expect(x).to.equal(y)
+    mocking: sinon.stub()
+    coverage: nyc
+    docs_url: https://mochajs.org
+  - id: item_004
+    name: Playwright
+    language: typescript
+    type: e2e
+    install: npm i -D @playwright/test
+    test_command: npx playwright test
+    assertion_style: expect(locator).toHaveText()
+    mocking: page.route()
+    coverage: --reporter=html
+    docs_url: https://playwright.dev
+    version_info:
+      current: "1.50.0"
+      min_supported: "1.30.0"
+      breaking_changes:
+        "1.50":
+          - "Clock API stable (clock.install)"
+          - "BoxedStep annotation"
+        "1.40":
+          - "waitForTimeout deprecated for toPass"
+          - "New test.step API"
+        "1.35":
+          - "UI Mode stable"
+          - "Route.fetch changed"
+      version_patterns:
+        ">=1.40":
+          wait: "expect(cb).toPass({ timeout })"
+          retry: "test.step with retry"
+          clock: "clock.install() for time mocking"
+        ">=1.30,<1.40":
+          wait: "page.waitForTimeout()"
+          retry: "expect.poll()"
+  - id: item_005
+    name: Cypress
+    language: javascript
+    type: e2e
+    install: npm i -D cypress
+    test_command: npx cypress run
+    assertion_style: cy.get().should('have.text')
+    mocking: cy.intercept()
+    coverage: --reporter mochawesome
+    docs_url: https://cypress.io
+  - id: item_006
+    name: Testing Library
+    language: javascript
+    type: component
+    install: npm i -D @testing-library/react
+    test_command: npm test
+    assertion_style: expect(screen.getByText()).toBeInTheDocument()
+    mocking: jest.mock()
+    coverage: jest --coverage
+    docs_url: https://testing-library.com
+  - id: item_007
+    name: pytest
+    language: python
+    type: unit
+    install: pip install pytest
+    test_command: pytest
+    assertion_style: assert x == y
+    mocking: pytest-mock, monkeypatch
+    coverage: pytest --cov
+    docs_url: https://pytest.org
+    version_info:
+      current: "8.3.0"
+      min_supported: "7.0.0"
+      breaking_changes:
+        "8.0":
+          - "Python 3.8 dropped, requires 3.9+"
+          - "pytest.warns() strict mode default"
+          - "Collection order changed"
+        "7.0":
+          - "py.path deprecated for pathlib"
+          - "Improved assertion introspection"
+      version_patterns:
+        ">=8.0":
+          async: "pytest-asyncio with mode=auto"
+          fixture: "yield fixtures with async support"
+          config: "pyproject.toml [tool.pytest]"
+        ">=7.0,<8.0":
+          async: "pytest-asyncio mode=strict"
+          config: "pytest.ini or pyproject.toml"
+  - id: item_008
+    name: unittest
+    language: python
+    type: unit
+    install: builtin
+    test_command: python -m unittest
+    assertion_style: self.assertEqual(x, y)
+    mocking: unittest.mock.patch()
+    coverage: coverage run
+    docs_url: https://docs.python.org/3/library/unittest.html
+  - id: item_009
+    name: Go testing
+    language: go
+    type: unit
+    install: builtin
+    test_command: go test ./...
+    assertion_style: if got != want { t.Errorf() }
+    mocking: gomock, testify/mock
+    coverage: go test -cover
+    docs_url: https://golang.org/pkg/testing/
+  - id: item_010
+    name: testify
+    language: go
+    type: unit
+    install: go get github.com/stretchr/testify
+    test_command: go test ./...
+    assertion_style: assert.Equal(t, expected, actual)
+    mocking: testify/mock
+    coverage: go test -coverprofile
+    docs_url: https://github.com/stretchr/testify
+  - id: item_011
+    name: xUnit
+    language: csharp
+    type: unit
+    install: dotnet add package xunit
+    test_command: dotnet test
+    assertion_style: Assert.Equal(expected, actual)
+    mocking: Moq, NSubstitute
+    coverage: coverlet
+    docs_url: https://xunit.net
+  - id: item_012
+    name: NUnit
+    language: csharp
+    type: unit
+    install: dotnet add package NUnit
+    test_command: dotnet test
+    assertion_style: Assert.That(actual, Is.EqualTo(expected))
+    mocking: Moq
+    coverage: coverlet
+    docs_url: https://nunit.org
+  - id: item_013
+    name: JUnit 5
+    language: java
+    type: unit
+    install: Maven/Gradle dependency
+    test_command: mvn test
+    assertion_style: assertEquals(expected, actual)
+    mocking: Mockito
+    coverage: JaCoCo
+    docs_url: https://junit.org/junit5/
+  - id: item_014
+    name: cargo test
+    language: rust
+    type: unit
+    install: builtin
+    test_command: cargo test
+    assertion_style: assert_eq!(expected, actual)
+    mocking: mockall crate
+    coverage: cargo tarpaulin
+    docs_url: https://doc.rust-lang.org/book/ch11-00-testing.html
+  - id: item_015
+    name: RSpec
+    language: ruby
+    type: unit
+    install: gem install rspec
+    test_command: rspec
+    assertion_style: expect(x).to eq(y)
+    mocking: rspec-mocks
+    coverage: simplecov
+    docs_url: https://rspec.info
+  - id: item_016
+    name: PHPUnit
+    language: php
+    type: unit
+    install: composer require phpunit/phpunit
+    test_command: ./vendor/bin/phpunit
+    assertion_style: $this->assertEquals($expected, $actual)
+    mocking: Mockery, Prophecy
+    coverage: --coverage-html
+    docs_url: https://phpunit.de
+  - id: item_017
+    name: ExUnit
+    language: elixir
+    type: unit
+    install: builtin
+    test_command: mix test
+    assertion_style: assert x == y
+    mocking: Mox
+    coverage: mix test --cover
+    docs_url: https://hexdocs.pm/ex_unit
+  - id: item_018
+    name: Kotest
+    language: kotlin
+    type: unit
+    install: Gradle dependency
+    test_command: ./gradlew test
+    assertion_style: x shouldBe y
+    mocking: MockK
+    coverage: Kover
+    docs_url: https://kotest.io
+  - id: item_019
+    name: XCTest
+    language: swift
+    type: unit
+    install: builtin
+    test_command: swift test
+    assertion_style: XCTAssertEqual(x, y)
+    mocking: protocol-based
+    coverage: --enable-code-coverage
+    docs_url: https://developer.apple.com/documentation/xctest
+  - id: item_020
+    name: Flutter Test
+    language: dart
+    type: unit
+    install: flutter pub add test
+    test_command: flutter test
+    assertion_style: expect(x, equals(y))
+    mocking: mockito
+    coverage: flutter test --coverage
+    docs_url: https://docs.flutter.dev/testing