@nockdev/awf 6.2.0 → 6.2.1

package/.agent/skills/cross-cutting/monorepo/data/ci-cd-strategies.yaml

@@ -0,0 +1,74 @@
+# =============================================================================
+# ci-cd-strategies.yaml — CI/CD for Monorepos
+# =============================================================================
+
+version: "1.0.0"
+
+affected_detection:
+  description: "Only build/test packages affected by changes"
+
+  nx: |
+    # GitHub Actions
+    - name: Affected Build
+      run: npx nx affected --target=build --base=origin/main
+
+  turborepo: |
+    # GitHub Actions
+    - name: Affected Build
+      run: npx turbo run build --filter='[HEAD~1]'
+
+  manual: |
+    # Using git diff
+    CHANGED=$(git diff --name-only HEAD~1)
+    if echo "$CHANGED" | grep -q "packages/ui"; then
+      npm run build --workspace=@org/ui
+    fi
+
+github_actions:
+  full_pipeline: |
+    name: CI
+    on:
+      pull_request:
+        branches: [main]
+
+    jobs:
+      build:
+        runs-on: ubuntu-latest
+        steps:
+          - uses: actions/checkout@v4
+            with:
+              fetch-depth: 0   # Full history for affected
+
+          - uses: pnpm/action-setup@v4
+
+          - uses: actions/setup-node@v4
+            with:
+              node-version: 22
+              cache: 'pnpm'
+
+          - run: pnpm install --frozen-lockfile
+
+          - name: Build affected
+            run: pnpm exec nx affected --target=build --base=origin/main
+
+          - name: Test affected
+            run: pnpm exec nx affected --target=test --base=origin/main
+
+          - name: Lint affected
+            run: pnpm exec nx affected --target=lint --base=origin/main
+
+parallelism:
+  strategies:
+    - name: "Task-level parallelism"
+      description: "Run independent tasks concurrently"
+      tool: "Nx/Turborepo built-in"
+
+    - name: "Machine-level parallelism"
+      description: "Split tasks across CI machines"
+      tool: "Nx Cloud DTE (Distributed Task Execution)"
+
+    - name: "Cache-first strategy"
+      description: "Skip tasks with cache hits"
+      tool: "Remote caching (Nx Cloud / Vercel)"
+
+# _DOMYH Awesome Code • Monorepo CI/CD_

package/.agent/skills/cross-cutting/monorepo/data/nx-patterns.yaml

@@ -0,0 +1,74 @@
+# =============================================================================
+# nx-patterns.yaml — Nx Workspace Patterns
+# =============================================================================
+
+version: "1.0.0"
+
+generators:
+  description: "Code scaffolding for consistent structure"
+  examples:
+    - command: "nx g @nx/next:app web"
+      description: "Create Next.js application"
+    - command: "nx g @nx/react:lib ui --directory=packages/ui"
+      description: "Create shared React library"
+    - command: "nx g @nx/js:lib utils --publishable --importPath=@org/utils"
+      description: "Create publishable JS library"
+
+executors:
+  description: "Task runners for build, test, lint"
+  config: |
+    // project.json
+    {
+      "targets": {
+        "build": {
+          "executor": "@nx/next:build",
+          "options": {
+            "outputPath": "dist/apps/web"
+          }
+        },
+        "test": {
+          "executor": "@nx/jest:jest",
+          "options": {
+            "jestConfig": "apps/web/jest.config.ts"
+          }
+        }
+      }
+    }
+
+task_graph:
+  description: "Nx understands project dependencies automatically"
+  commands:
+    - "nx graph"
+    - "nx affected:graph"
+    - "nx run-many --target=build --all"
+    - "nx run-many --target=test --projects=api,web"
+
+caching:
+  local: "Stored in node_modules/.cache/nx"
+  remote: |
+    # nx.json
+    {
+      "tasksRunnerOptions": {
+        "default": {
+          "runner": "nx-cloud",
+          "options": {
+            "accessToken": "YOUR_NX_CLOUD_TOKEN"
+          }
+        }
+      }
+    }
+
+plugins:
+  official:
+    - "@nx/next"
+    - "@nx/react"
+    - "@nx/node"
+    - "@nx/nest"
+    - "@nx/angular"
+    - "@nx/jest"
+    - "@nx/cypress"
+    - "@nx/storybook"
+    - "@nx/esbuild"
+    - "@nx/vite"
+
+# _DOMYH Awesome Code • Nx Patterns_

package/.agent/skills/cross-cutting/monorepo/data/turborepo-patterns.yaml

@@ -0,0 +1,84 @@
+# =============================================================================
+# turborepo-patterns.yaml — Turborepo Patterns
+# =============================================================================
+
+version: "1.0.0"
+
+pipeline:
+  description: "Define task relationships and caching"
+  config: |
+    // turbo.json
+    {
+      "$schema": "https://turbo.build/schema.json",
+      "globalDependencies": ["**/.env.*local"],
+      "pipeline": {
+        "build": {
+          "dependsOn": ["^build"],
+          "outputs": ["dist/**", ".next/**", "!.next/cache/**"]
+        },
+        "test": {
+          "dependsOn": ["build"],
+          "inputs": ["src/**/*.tsx", "src/**/*.ts", "test/**/*.ts"]
+        },
+        "lint": {
+          "outputs": []
+        },
+        "dev": {
+          "cache": false,
+          "persistent": true
+        }
+      }
+    }
+
+filtering:
+  description: "Run tasks for specific packages"
+  commands:
+    - "turbo run build --filter=@org/web"
+    - "turbo run build --filter=@org/web..."
+    - "turbo run build --filter=...@org/ui"
+    - "turbo run build --filter='./apps/*'"
+    - "turbo run build --filter='[HEAD~1]'"
+
+caching:
+  local:
+    location: "node_modules/.cache/turbo"
+    config: "Automatic based on pipeline outputs"
+
+  remote:
+    vercel: |
+      # Link to Vercel for remote cache
+      npx turbo login
+      npx turbo link
+
+    self_hosted: |
+      # turbo.json
+      {
+        "remoteCache": {
+          "signature": true,
+          "enabled": true
+        }
+      }
+
+  cache_outputs:
+    - "dist/**"
+    - ".next/**"
+    - "!.next/cache/**"
+    - "coverage/**"
+
+task_hashing:
+  description: "Turborepo hashes inputs to determine cache hits"
+  inputs:
+    - "Source files (src/**)"
+    - "Dependencies (package.json)"
+    - "Environment variables"
+    - "Global dependencies (turbo.json)"
+
+migration_from_lerna: |
+  # 1. Install turborepo
+  npm install turbo --save-dev
+
+  # 2. Create turbo.json (replaces lerna.json commands)
+  # 3. Update package.json scripts
+  # 4. Remove lerna.json
+
+# _DOMYH Awesome Code • Turborepo Patterns_

package/.agent/skills/cross-cutting/monorepo/data/versioning.yaml

@@ -0,0 +1,83 @@
+# =============================================================================
+# versioning.yaml — Monorepo Versioning Strategies
+# =============================================================================
+
+version: "1.0.0"
+
+changesets:
+  description: "Intent-based versioning for monorepos"
+  setup: |
+    npm install @changesets/cli --save-dev
+    npx changeset init
+
+  workflow: |
+    1. Developer runs: npx changeset
+    2. Select packages affected
+    3. Choose bump type (patch/minor/major)
+    4. Write change description
+    5. Commit .changeset/ file with PR
+    6. CI: npx changeset version → updates package.json + CHANGELOG
+    7. CI: npx changeset publish → publishes to npm
+
+  config: |
+    // .changeset/config.json
+    {
+      "$schema": "https://unpkg.com/@changesets/config@3.0.0/schema.json",
+      "changelog": "@changesets/cli/changelog",
+      "commit": false,
+      "fixed": [],
+      "linked": [["@org/ui", "@org/utils"]],
+      "access": "restricted",
+      "baseBranch": "main",
+      "updateInternalDependencies": "patch"
+    }
+
+conventional_commits:
+  description: "Commit-based versioning"
+  format: |
+    <type>[scope]: <description>
+
+    feat(ui): add Button component      → minor bump
+    fix(api): resolve auth error         → patch bump
+    feat(web)!: redesign checkout        → major bump (breaking)
+
+  types:
+    - feat: "New feature → minor"
+    - fix: "Bug fix → patch"
+    - docs: "Documentation only"
+    - style: "Formatting, no code change"
+    - refactor: "Code change, no feature/fix"
+    - perf: "Performance improvement"
+    - test: "Adding tests"
+    - chore: "Build/tooling changes"
+
+  tools:
+    - name: "commitlint"
+      config: "@commitlint/config-conventional"
+    - name: "semantic-release"
+      description: "Auto-version from commits"
+    - name: "standard-version"
+      description: "Generate changelogs"
+
+versioning_strategies:
+  fixed:
+    description: "All packages share same version"
+    example: "Angular, Babel"
+    pros: "Simple, consistent"
+    cons: "Bumps all packages even for single change"
+
+  independent:
+    description: "Each package has own version"
+    example: "Most open-source monorepos"
+    pros: "Accurate, minimal bumps"
+    cons: "Complex dependency tracking"
+
+  locked:
+    description: "Linked groups share version"
+    example: "@org/core and @org/cli always same version"
+    changesets_config: |
+      {
+        "linked": [["@org/core", "@org/cli"]]
+      }
+
+# _DOMYH Awesome Code • Versioning Patterns_

package/.agent/skills/cross-cutting/monorepo/data/workspace-patterns.yaml

@@ -0,0 +1,85 @@
+# =============================================================================
+# workspace-patterns.yaml — Package Manager Workspace Patterns
+# =============================================================================
+
+version: "1.0.0"
+
+pnpm:
+  config: |
+    # pnpm-workspace.yaml
+    packages:
+      - 'apps/*'
+      - 'packages/*'
+
+  commands:
+    install: "pnpm install"
+    add_dep: "pnpm add lodash --filter @org/web"
+    add_shared: "pnpm add -w typescript"
+    run_script: "pnpm --filter @org/web dev"
+    run_all: "pnpm -r run build"
+
+  advantages:
+    - "Disk-efficient (content-addressable store)"
+    - "Strict dependency isolation"
+    - "Fast installations"
+    - "Built-in workspace protocol"
+
+npm:
+  config: |
+    // package.json
+    {
+      "workspaces": ["apps/*", "packages/*"]
+    }
+
+  commands:
+    install: "npm install"
+    add_dep: "npm install lodash -w @org/web"
+    run_script: "npm run dev -w @org/web"
+    run_all: "npm run build --workspaces"
+
+yarn_berry:
+  config: |
+    // package.json
+    {
+      "workspaces": ["apps/*", "packages/*"]
+    }
+
+  commands:
+    install: "yarn install"
+    add_dep: "yarn workspace @org/web add lodash"
+    run_script: "yarn workspace @org/web dev"
+    run_all: "yarn workspaces foreach -A run build"
+
+  pnp:
+    description: "Plug'n'Play — zero-install, no node_modules"
+    enable: "yarn set version berry"
+
+internal_packages:
+  description: "Share code between workspace packages"
+  setup: |
+    // packages/ui/package.json
+    {
+      "name": "@org/ui",
+      "main": "./src/index.ts",
+      "types": "./src/index.ts"
+    }
+
+    // apps/web/package.json
+    {
+      "dependencies": {
+        "@org/ui": "workspace:*"
+      }
+    }
+
+  tsconfig: |
+    // tsconfig.json (root)
+    {
+      "compilerOptions": {
+        "paths": {
+          "@org/ui": ["./packages/ui/src"],
+          "@org/utils": ["./packages/utils/src"]
+        }
+      }
+    }
+
+# _DOMYH Awesome Code • Workspace Patterns_

package/.agent/skills/cross-cutting/playwright/ADVANCED.md

@@ -0,0 +1,289 @@
+---
+name: playwright-advanced
+version: "1.0.0"
+---
+
+# Playwright Advanced Patterns
+
+> Reference only — loaded when explicitly needed via ADVANCED.md tier.
+
+## Full 58-Checkpoint Workflow
+
+### Phase 1: Page Load Verification
+
+```typescript
+test("page load verification", async ({ page }) => {
+  const response = await page.goto("http://localhost:3000");
+  expect(response?.status()).toBe(200);
+  await page.waitForLoadState("networkidle");
+
+  // Check for console errors
+  const errors: string[] = [];
+  page.on("console", (msg) => {
+    if (msg.type() === "error") errors.push(msg.text());
+  });
+
+  // Verify no JS errors
+  expect(errors).toHaveLength(0);
+});
+```
+
+### Phase 2: Interactive Element Discovery
+
+```typescript
+// Using MCP: browser_snapshot → returns accessibility tree
+// Parse tree to find ALL interactive elements:
+// - Buttons (role=button)
+// - Links (role=link)
+// - Inputs (role=textbox, role=combobox)
+// - Selects (role=listbox)
+// - Checkboxes (role=checkbox)
+// - Dialogs (role=dialog)
+
+test("discover all interactive elements", async ({ page }) => {
+  await page.goto("/");
+  await page.waitForLoadState("networkidle");
+
+  const buttons = await page.getByRole("button").all();
+  const links = await page.getByRole("link").all();
+  const inputs = await page.getByRole("textbox").all();
+  const selects = await page.getByRole("combobox").all();
+
+  console.log(
+    `Found: ${buttons.length} buttons, ${links.length} links, ${inputs.length} inputs, ${selects.length} selects`,
+  );
+
+  // Each should be tested according to checklist
+});
+```
+
+### Phase 3: Systematic Interaction Testing
+
+#### Dropdown Complete Test
+
+```typescript
+test("dropdown comprehensive test", async ({ page }) => {
+  await page.goto("/form");
+
+  const dropdown = page.getByRole("combobox", { name: "Country" });
+
+  // DD-F01: Click opens list
+  await dropdown.click();
+  await expect(page.getByRole("listbox")).toBeVisible();
+
+  // DD-F02: All options present
+  const options = await page.getByRole("option").all();
+  expect(options.length).toBeGreaterThan(0);
+
+  // DD-F03: Select updates value
+  await page.getByRole("option", { name: "Vietnam" }).click();
+  await expect(dropdown).toHaveValue("vietnam");
+
+  // DD-K01: Tab focuses
+  await page.keyboard.press("Tab");
+  await page.keyboard.press("Shift+Tab"); // Back to dropdown
+  await expect(dropdown).toBeFocused();
+
+  // DD-K02: Enter opens
+  await page.keyboard.press("Enter");
+  await expect(page.getByRole("listbox")).toBeVisible();
+
+  // DD-K03: Arrow navigation
+  await page.keyboard.press("ArrowDown");
+  await page.keyboard.press("ArrowDown");
+
+  // DD-K05: Escape closes
+  await page.keyboard.press("Escape");
+  await expect(page.getByRole("listbox")).not.toBeVisible();
+});
+```
+
+#### Modal Complete Test
+
+```typescript
+test("modal comprehensive test", async ({ page }) => {
+  await page.goto("/");
+
+  // MD-TD01: Trigger opens modal
+  await page.getByRole("button", { name: "Open Settings" }).click();
+  const modal = page.getByRole("dialog");
+  await expect(modal).toBeVisible();
+
+  // MD-TD03: Background blocked
+  // Attempting click outside should not close (or close, depending on design)
+  const modalContent = await modal.textContent();
+  expect(modalContent).toBeTruthy();
+
+  // MD-KA01: Tab trap inside modal
+  const firstFocusable = modal.getByRole("button").first();
+  await firstFocusable.focus();
+
+  // Tab through all elements — should stay in modal
+  for (let i = 0; i < 20; i++) {
+    await page.keyboard.press("Tab");
+    const focused = await page.evaluate(() => {
+      const el = document.activeElement;
+      const dialog = document.querySelector("[role=dialog]");
+      return dialog?.contains(el);
+    });
+    expect(focused).toBeTruthy();
+  }
+
+  // MD-CB03: Escape closes
+  await page.keyboard.press("Escape");
+  await expect(modal).not.toBeVisible();
+
+  // MD-CB04: Focus returns to trigger
+  const trigger = page.getByRole("button", { name: "Open Settings" });
+  await expect(trigger).toBeFocused();
+});
+```
+
+#### Button Rage-Click Test
+
+```typescript
+test("button rage-click safety", async ({ page }) => {
+  await page.goto("/checkout");
+
+  let apiCalls = 0;
+  await page.route("**/api/submit", (route) => {
+    apiCalls++;
+    route.fulfill({ status: 200, body: JSON.stringify({ ok: true }) });
+  });
+
+  const submitBtn = page.getByRole("button", { name: "Place Order" });
+
+  // BT-F03: Rapid clicks
+  await submitBtn.click();
+  await submitBtn.click();
+  await submitBtn.click();
+
+  await page.waitForTimeout(500);
+  expect(apiCalls).toBe(1); // Only 1 API call despite 3 clicks
+});
+```
+
+## Visual Regression Testing
+
+```typescript
+test("visual regression", async ({ page }) => {
+  await page.goto("/");
+  await page.waitForLoadState("networkidle");
+
+  // Full page comparison
+  await expect(page).toHaveScreenshot("homepage.png", {
+    maxDiffPixelRatio: 0.01,
+    animations: "disabled",
+  });
+
+  // Element-specific comparison
+  const header = page.getByRole("banner");
+  await expect(header).toHaveScreenshot("header.png");
+
+  // After interaction
+  await page.getByRole("button", { name: "Toggle dark mode" }).click();
+  await expect(page).toHaveScreenshot("homepage-dark.png");
+});
+```
+
+## Network Interception
+
+```typescript
+test("API error handling", async ({ page }) => {
+  // Mock API failure
+  await page.route("**/api/users", (route) => {
+    route.fulfill({
+      status: 500,
+      body: JSON.stringify({ error: "Server error" }),
+    });
+  });
+
+  await page.goto("/users");
+
+  // Verify error UI
+  await expect(page.getByRole("alert")).toContainText("Failed to load");
+  await expect(page.getByRole("button", { name: "Retry" })).toBeVisible();
+});
+```
+
+## Authentication State Management
+
+```typescript
+// fixtures.ts — Shared auth state
+import { test as base } from "@playwright/test";
+
+export const test = base.extend({
+  authenticatedPage: async ({ browser }, use) => {
+    const context = await browser.newContext({
+      storageState: "auth-state.json", // Pre-saved auth cookies
+    });
+    const page = await context.newPage();
+    await use(page);
+    await context.close();
+  },
+});
+
+// Save auth state (run once)
+// npx playwright test --project=setup
+test("save auth state", async ({ page }) => {
+  await page.goto("/login");
+  await page.getByLabel("Email").fill("admin@test.com");
+  await page.getByLabel("Password").fill("password");
+  await page.getByRole("button", { name: "Sign in" }).click();
+  await page.waitForURL("/dashboard");
+  await page.context().storageState({ path: "auth-state.json" });
+});
+```
+
+## Cross-Browser Matrix Testing
+
+```typescript
+// playwright.config.ts — Full matrix
+export default defineConfig({
+  projects: [
+    // Desktop
+    { name: "chromium", use: { ...devices["Desktop Chrome"] } },
+    { name: "firefox", use: { ...devices["Desktop Firefox"] } },
+    { name: "webkit", use: { ...devices["Desktop Safari"] } },
+    { name: "edge", use: { ...devices["Desktop Edge"] } },
+
+    // Mobile
+    { name: "iphone", use: { ...devices["iPhone 14"] } },
+    { name: "android", use: { ...devices["Pixel 7"] } },
+
+    // Tablet
+    { name: "ipad", use: { ...devices["iPad (gen 7)"] } },
+  ],
+});
+```
+
+## Trace Viewer Debugging
+
+```typescript
+// Capture trace for debugging
+test("debug with trace", async ({ page, context }) => {
+  await context.tracing.start({ screenshots: true, snapshots: true });
+
+  await page.goto("/");
+  // ... test steps ...
+
+  // Save trace on failure
+  await context.tracing.stop({ path: "trace.zip" });
+  // View: npx playwright show-trace trace.zip
+});
+```
+
+## Checklist
+
+- [ ] 58 checkpoints applied to all interactive elements?
+- [ ] Accessibility locators used (getByRole preferred)?
+- [ ] Cross-browser tested (Chromium + Firefox + WebKit)?
+- [ ] Mobile responsive verified?
+- [ ] Console errors checked?
+- [ ] Network requests verified?
+- [ ] Visual regression baselines set?
+- [ ] Authentication state managed?
+
+---
+
+_DOMYH Awesome Code — Playwright Advanced Patterns (Reference Only)_