@agentic-qe/v3 3.0.0-alpha.5 → 3.0.0-alpha.7

package/assets/skills/v3-qe-test-execution/SKILL.md

@@ -0,0 +1,182 @@
+---
+name: "V3 QE Test Execution"
+description: "Parallel test execution orchestration with intelligent scheduling, retry logic, and comprehensive result aggregation."
+---
+
+# V3 QE Test Execution
+
+## Purpose
+
+Guide the use of v3's test execution capabilities including parallel orchestration, smart test selection, flaky test handling, and distributed execution across multiple environments.
+
+## Activation
+
+- When running test suites
+- When optimizing test execution time
+- When handling flaky tests
+- When setting up CI/CD test pipelines
+- When executing tests across environments
+
+## Quick Start
+
+```bash
+# Run all tests with parallelization
+aqe-v3 test run --parallel --workers 4
+
+# Run affected tests only
+aqe-v3 test run --affected --since HEAD~1
+
+# Run with retry for flaky tests
+aqe-v3 test run --retry 3 --retry-delay 1000
+
+# Run specific test types
+aqe-v3 test run --type unit,integration --exclude e2e
+```
+
+## Agent Workflow
+
+```typescript
+// Orchestrate test execution
+Task("Execute test suite", `
+  Run the full test suite with:
+  - 4 parallel workers
+  - Retry flaky tests up to 3 times
+  - Generate JUnit report
+  - Fail fast on critical tests
+  Report results and any failures.
+`, "v3-qe-test-executor")
+
+// Smart test selection
+Task("Run affected tests", `
+  Analyze changes in PR #123 and:
+  - Identify affected test files
+  - Run only relevant tests
+  - Include integration tests for changed modules
+  - Report coverage delta
+`, "v3-qe-test-selector")
+```
+
+## Execution Strategies
+
+### 1. Parallel Execution
+
+```typescript
+await testExecutor.runParallel({
+  suites: ['unit', 'integration'],
+  workers: 4,
+  distribution: 'by-file',  // or 'by-test', 'by-duration'
+  isolation: 'process',
+  sharding: {
+    enabled: true,
+    total: 4,
+    index: process.env.SHARD_INDEX
+  }
+});
+```
+
+### 2. Smart Test Selection
+
+```typescript
+await testExecutor.runAffected({
+  changes: gitChanges,
+  selection: {
+    direct: true,      // Tests for changed files
+    transitive: true,  // Tests for dependents
+    integration: true  // Integration tests touching changed code
+  },
+  fallback: 'full-suite'  // If analysis fails
+});
+```
+
+### 3. Flaky Test Handling
+
+```typescript
+await testExecutor.handleFlaky({
+  detection: {
+    enabled: true,
+    threshold: 0.1,  // 10% flake rate
+    window: 100      // Last 100 runs
+  },
+  strategy: {
+    retry: 3,
+    quarantine: true,
+    notify: ['#flaky-tests']
+  }
+});
+```
+
+## Execution Configuration
+
+```yaml
+execution:
+  parallel:
+    workers: auto  # CPU cores - 1
+    timeout: 30000
+    bail: false
+
+  retry:
+    count: 2
+    delay: 1000
+    only_failed: true
+
+  reporting:
+    formats: [junit, json, html]
+    include_timing: true
+    include_logs: true
+
+  environments:
+    - name: node-18
+      image: node:18-alpine
+    - name: node-20
+      image: node:20-alpine
+```
+
+## CI/CD Integration
+
+```yaml
+# GitHub Actions example
+test:
+  runs-on: ubuntu-latest
+  strategy:
+    matrix:
+      shard: [1, 2, 3, 4]
+  steps:
+    - uses: actions/checkout@v4
+    - name: Run tests
+      run: |
+        aqe-v3 test run \
+          --shard ${{ matrix.shard }}/4 \
+          --parallel \
+          --report junit
+    - name: Upload results
+      uses: actions/upload-artifact@v4
+      with:
+        name: test-results-${{ matrix.shard }}
+        path: reports/
+```
+
+## Result Aggregation
+
+```typescript
+interface ExecutionResults {
+  summary: {
+    total: number;
+    passed: number;
+    failed: number;
+    skipped: number;
+    flaky: number;
+    duration: number;
+  };
+  shards: ShardResult[];
+  failures: TestFailure[];
+  flakyTests: FlakyTest[];
+  coverage: CoverageReport;
+  timing: TimingAnalysis;
+}
+```
+
+## Coordination
+
+**Primary Agents**: v3-qe-test-executor, v3-qe-test-selector, v3-qe-flaky-detector
+**Coordinator**: v3-qe-test-execution-coordinator
+**Related Skills**: v3-qe-test-generation, v3-qe-coverage-analysis

package/assets/skills/v3-qe-test-generation/SKILL.md

@@ -0,0 +1,141 @@
+---
+name: "V3 QE Test Generation"
+description: "AI-powered test generation using pattern recognition, code analysis, and intelligent test synthesis for comprehensive test coverage."
+---
+
+# V3 QE Test Generation
+
+## Purpose
+
+Guide the use of v3's AI-powered test generation capabilities including pattern-based test synthesis, multi-framework support, and intelligent test case derivation from code analysis.
+
+## Activation
+
+- When generating tests for new code
+- When improving test coverage
+- When migrating tests between frameworks
+- When applying TDD patterns
+- When generating edge case tests
+
+## Quick Start
+
+```bash
+# Generate unit tests for a file
+aqe-v3 test generate --file src/services/UserService.ts --framework jest
+
+# Generate tests with coverage target
+aqe-v3 test generate --scope src/api/ --coverage 90 --type unit
+
+# Generate integration tests
+aqe-v3 test generate --file src/controllers/AuthController.ts --type integration
+
+# Generate from patterns
+aqe-v3 test generate --pattern repository --target src/repositories/
+```
+
+## Agent Workflow
+
+```typescript
+// Spawn test generation agents
+Task("Generate unit tests", `
+  Analyze src/services/PaymentService.ts and generate comprehensive Jest tests.
+  Include:
+  - Happy path tests for all public methods
+  - Edge cases and boundary conditions
+  - Error handling scenarios
+  - Mock external dependencies
+  Output to tests/unit/services/PaymentService.test.ts
+`, "v3-qe-test-generator")
+
+// Pattern-based generation
+Task("Apply test patterns", `
+  Scan src/repositories/ and apply repository test pattern:
+  - CRUD operation tests
+  - Query builder tests
+  - Transaction tests
+  - Connection error handling
+`, "v3-qe-pattern-matcher")
+```
+
+## Test Generation Strategies
+
+### 1. Code Analysis Based
+
+```typescript
+await testGenerator.analyzeAndGenerate({
+  source: 'src/services/OrderService.ts',
+  analysis: {
+    methods: true,
+    branches: true,
+    dependencies: true,
+    errorPaths: true
+  },
+  output: {
+    framework: 'jest',
+    style: 'describe-it',
+    assertions: 'expect'
+  }
+});
+```
+
+### 2. Pattern-Based Generation
+
+```typescript
+await testGenerator.applyPattern({
+  pattern: 'service-layer',
+  targets: ['src/services/*.ts'],
+  customizations: {
+    mockStrategy: 'jest.mock',
+    asyncHandling: 'async-await',
+    errorAssertion: 'toThrow'
+  }
+});
+```
+
+### 3. Coverage-Driven Generation
+
+```typescript
+await testGenerator.fillCoverageGaps({
+  coverageReport: 'coverage/lcov.info',
+  targetCoverage: 90,
+  prioritize: ['uncovered-branches', 'error-paths'],
+  maxTests: 50
+});
+```
+
+## Framework Support
+
+| Framework | Unit | Integration | E2E | Mocking |
+|-----------|------|-------------|-----|---------|
+| Jest | ✅ | ✅ | ⚠️ | jest.mock |
+| Vitest | ✅ | ✅ | ⚠️ | vi.mock |
+| Mocha | ✅ | ✅ | ❌ | sinon |
+| Pytest | ✅ | ✅ | ❌ | pytest-mock |
+| JUnit | ✅ | ✅ | ❌ | Mockito |
+
+## Test Quality Checks
+
+```yaml
+quality_checks:
+  assertions:
+    minimum_per_test: 1
+    meaningful: true
+
+  isolation:
+    no_shared_state: true
+    proper_setup_teardown: true
+
+  naming:
+    descriptive: true
+    follows_convention: true
+
+  coverage:
+    branches: 80
+    statements: 85
+```
+
+## Coordination
+
+**Primary Agents**: v3-qe-test-generator, v3-qe-pattern-matcher, v3-qe-test-architect
+**Coordinator**: v3-qe-test-generation-coordinator
+**Related Skills**: v3-qe-coverage-analysis, v3-qe-test-execution

package/assets/skills/v3-qe-visual-accessibility/SKILL.md

@@ -0,0 +1,242 @@
+---
+name: "V3 QE Visual Accessibility"
+description: "Visual regression testing, responsive design validation, and WCAG accessibility compliance testing."
+---
+
+# V3 QE Visual Accessibility
+
+## Purpose
+
+Guide the use of v3's visual and accessibility testing capabilities including screenshot comparison, responsive design validation, and WCAG 2.2 compliance verification.
+
+## Activation
+
+- When testing visual appearance
+- When validating responsive design
+- When checking accessibility compliance
+- When detecting visual regressions
+- When testing cross-browser rendering
+
+## Quick Start
+
+```bash
+# Visual regression test
+aqe-v3 visual test --baseline production --current staging
+
+# Responsive design test
+aqe-v3 visual responsive --url https://example.com --viewports all
+
+# Accessibility audit
+aqe-v3 a11y audit --url https://example.com --standard wcag22-aa
+
+# Cross-browser test
+aqe-v3 visual cross-browser --url https://example.com --browsers chrome,firefox,safari
+```
+
+## Agent Workflow
+
+```typescript
+// Visual regression testing
+Task("Run visual regression", `
+  Compare staging against production:
+  - Capture screenshots of key pages
+  - Detect pixel differences
+  - Flag significant visual changes
+  - Generate visual diff report
+`, "v3-qe-visual-tester")
+
+// Accessibility audit
+Task("Audit accessibility", `
+  Run WCAG 2.2 AA compliance audit:
+  - Check color contrast ratios
+  - Verify keyboard navigation
+  - Test screen reader compatibility
+  - Validate ARIA labels
+  Generate compliance report with fix suggestions.
+`, "v3-qe-accessibility-agent")
+```
+
+## Visual Testing Operations
+
+### 1. Visual Regression
+
+```typescript
+await visualTester.compareScreenshots({
+  baseline: {
+    source: 'production',
+    pages: ['/', '/login', '/dashboard', '/settings']
+  },
+  current: {
+    source: 'staging',
+    pages: ['/', '/login', '/dashboard', '/settings']
+  },
+  comparison: {
+    threshold: 0.1,  // 0.1% pixel difference
+    antialiasing: true,
+    ignoreRegions: ['#dynamic-content', '.timestamp']
+  }
+});
+```
+
+### 2. Responsive Testing
+
+```typescript
+await responsiveTester.test({
+  url: 'https://example.com',
+  viewports: [
+    { name: 'mobile', width: 375, height: 667 },
+    { name: 'tablet', width: 768, height: 1024 },
+    { name: 'desktop', width: 1920, height: 1080 }
+  ],
+  checks: {
+    layoutShift: true,
+    contentOverflow: true,
+    touchTargets: true,
+    fontScaling: true
+  }
+});
+```
+
+### 3. Accessibility Audit
+
+```typescript
+await accessibilityAgent.audit({
+  url: 'https://example.com',
+  standard: 'WCAG22-AA',
+  checks: {
+    perceivable: {
+      colorContrast: true,
+      textAlternatives: true,
+      captions: true
+    },
+    operable: {
+      keyboardAccessible: true,
+      noTimingIssues: true,
+      navigable: true
+    },
+    understandable: {
+      readable: true,
+      predictable: true,
+      inputAssistance: true
+    },
+    robust: {
+      compatible: true,
+      parseErrors: true
+    }
+  }
+});
+```
+
+### 4. Cross-Browser Testing
+
+```typescript
+await visualTester.crossBrowser({
+  url: 'https://example.com',
+  browsers: ['chrome', 'firefox', 'safari', 'edge'],
+  versions: 'latest-2',
+  comparisons: {
+    betweenBrowsers: true,
+    betweenVersions: true,
+    againstBaseline: true
+  }
+});
+```
+
+## WCAG 2.2 Checklist
+
+| Level | Criteria | Auto-Testable |
+|-------|----------|---------------|
+| A | Non-text Content | ✅ |
+| A | Info and Relationships | Partial |
+| A | Color Contrast (4.5:1) | ✅ |
+| A | Keyboard Accessible | ✅ |
+| A | Focus Visible | ✅ |
+| AA | Reflow | ✅ |
+| AA | Text Spacing | ✅ |
+| AAA | Enhanced Contrast (7:1) | ✅ |
+
+## Visual Test Report
+
+```typescript
+interface VisualReport {
+  summary: {
+    pagesCompared: number;
+    differencesFound: number;
+    passRate: number;
+  };
+  comparisons: {
+    page: string;
+    viewport: string;
+    baseline: string;
+    current: string;
+    diff: string;
+    diffPercentage: number;
+    status: 'pass' | 'fail' | 'review';
+  }[];
+  accessibility: {
+    violations: A11yViolation[];
+    passes: number;
+    incomplete: number;
+    score: number;
+  };
+  responsive: {
+    viewport: string;
+    issues: ResponsiveIssue[];
+  }[];
+}
+```
+
+## Accessibility Report
+
+```typescript
+interface AccessibilityReport {
+  summary: {
+    score: number;
+    violations: number;
+    warnings: number;
+    passes: number;
+  };
+  violations: {
+    id: string;
+    impact: 'critical' | 'serious' | 'moderate' | 'minor';
+    description: string;
+    wcag: string[];
+    elements: {
+      selector: string;
+      html: string;
+      issue: string;
+      fix: string;
+    }[];
+  }[];
+  compliance: {
+    wcagLevel: 'A' | 'AA' | 'AAA';
+    criteriasMet: number;
+    criteriasTotal: number;
+  };
+}
+```
+
+## CI/CD Integration
+
+```yaml
+visual_testing:
+  on_pr:
+    - capture_screenshots
+    - compare_to_baseline
+    - run_a11y_audit
+
+  thresholds:
+    visual_diff: 0.1
+    a11y_violations: 0
+
+  artifacts:
+    - screenshots/
+    - diffs/
+    - a11y-report.html
+```
+
+## Coordination
+
+**Primary Agents**: v3-qe-visual-tester, v3-qe-accessibility-agent, v3-qe-responsive-tester
+**Coordinator**: v3-qe-visual-coordinator
+**Related Skills**: v3-qe-test-execution, v3-qe-quality-assessment