claude-autopm 2.8.2 → 2.8.3

package/packages/plugin-testing/commands/test-setup.md

@@ -0,0 +1,414 @@
+# Testing Framework Setup Command
+
+**Command**: `/test:setup`
+**Category**: Testing & QA
+**Priority**: Medium
+
+## Description
+
+Setup comprehensive testing framework with Jest/Vitest, Testing Library, and coverage reporting. This command configures a complete testing environment following Context7-verified best practices for frontend, backend, and E2E testing.
+
+## Required Documentation Access
+
+**MANDATORY:** Before setting up testing framework, query Context7 for best practices:
+
+**Documentation Queries:**
+- `mcp://context7/testing/vitest` - Vitest configuration and setup patterns
+- `mcp://context7/testing/jest` - Jest configuration for JavaScript testing
+- `mcp://context7/testing/testing-library` - Testing Library setup and patterns
+- `mcp://context7/testing/coverage` - Coverage reporting best practices
+
+**Why This is Required:**
+- Ensures configuration follows latest testing framework patterns
+- Applies proven testing methodologies and setup strategies
+- Validates test runner configuration against current standards
+- Prevents outdated testing patterns and anti-patterns
+
+## Usage
+
+```bash
+# Interactive setup (prompts for framework choice)
+/test:setup
+
+# Setup with specific framework
+/test:setup --framework=vitest
+
+# Setup with coverage configuration
+/test:setup --framework=jest --coverage
+
+# Setup for specific project type
+/test:setup --type=react --framework=vitest
+```
+
+## Parameters
+
+```yaml
+framework:
+  type: string
+  enum: [vitest, jest]
+  default: vitest
+  description: "Testing framework to configure"
+
+type:
+  type: string
+  enum: [react, vue, angular, node, vanilla]
+  default: react
+  description: "Project type for testing setup"
+
+coverage:
+  type: boolean
+  default: true
+  description: "Enable coverage reporting"
+
+e2e:
+  type: boolean
+  default: false
+  description: "Include E2E testing setup (Playwright/Cypress)"
+
+ci:
+  type: boolean
+  default: true
+  description: "Configure for CI/CD integration"
+```
+
+## Implementation Steps
+
+### 1. Framework Detection
+
+```javascript
+// Detect existing project structure
+const packageJson = await readPackageJson();
+const hasReact = packageJson.dependencies?.react;
+const hasVue = packageJson.dependencies?.vue;
+const hasAngular = packageJson.dependencies?.['@angular/core'];
+
+// Recommend appropriate testing framework
+const framework = detectFramework({ hasReact, hasVue, hasAngular });
+```
+
+### 2. Install Dependencies
+
+**Vitest Setup (Recommended for Modern Projects)**:
+```bash
+npm install -D vitest @vitest/ui @vitest/coverage-v8
+npm install -D @testing-library/react @testing-library/user-event
+npm install -D @testing-library/jest-dom jsdom
+```
+
+**Jest Setup (Traditional Projects)**:
+```bash
+npm install -D jest @types/jest
+npm install -D @testing-library/react @testing-library/user-event
+npm install -D @testing-library/jest-dom jest-environment-jsdom
+```
+
+### 3. Create Configuration Files
+
+**Vitest Configuration** (`vitest.config.js`):
+```javascript
+import { defineConfig } from 'vitest/config';
+import react from '@vitejs/plugin-react';
+
+export default defineConfig({
+  plugins: [react()],
+  test: {
+    globals: true,
+    environment: 'jsdom',
+    setupFiles: './test/setup.js',
+
+    // Context7-verified coverage configuration
+    coverage: {
+      provider: 'v8',
+      reporter: ['text', 'json', 'html', 'lcov'],
+
+      // Realistic thresholds based on project size
+      thresholds: {
+        lines: 80,
+        functions: 80,
+        branches: 75,
+        statements: 80
+      },
+
+      // Include only source files
+      include: ['src/**/*.{js,jsx,ts,tsx}'],
+
+      // Exclude non-testable code
+      exclude: [
+        'node_modules/',
+        'test/',
+        '**/*.config.js',
+        '**/*.spec.js',
+        '**/*.test.js',
+        'src/main.js',
+        'src/**/*.d.ts'
+      ],
+
+      clean: true,
+      all: true
+    },
+
+    // Test sharding configuration
+    pool: 'threads',
+    poolOptions: {
+      threads: {
+        singleThread: false,
+        isolate: true
+      }
+    }
+  }
+});
+```
+
+**Jest Configuration** (`jest.config.js`):
+```javascript
+module.exports = {
+  testEnvironment: 'jsdom',
+  setupFilesAfterEnv: ['<rootDir>/test/setup.js'],
+
+  moduleNameMapper: {
+    '\\.(css|less|scss|sass)$': 'identity-obj-proxy',
+    '^@/(.*)$': '<rootDir>/src/$1'
+  },
+
+  collectCoverageFrom: [
+    'src/**/*.{js,jsx,ts,tsx}',
+    '!src/index.js',
+    '!src/**/*.d.ts'
+  ],
+
+  coverageThreshold: {
+    global: {
+      branches: 80,
+      functions: 80,
+      lines: 80,
+      statements: 80
+    }
+  },
+
+  coverageReporters: ['text', 'lcov', 'json', 'html']
+};
+```
+
+### 4. Create Test Setup File
+
+**Test Setup** (`test/setup.js`):
+```javascript
+import '@testing-library/jest-dom';
+import { cleanup } from '@testing-library/react';
+import { afterEach } from 'vitest';
+
+// Cleanup after each test
+afterEach(() => {
+  cleanup();
+});
+
+// Mock window.matchMedia
+Object.defineProperty(window, 'matchMedia', {
+  writable: true,
+  value: vi.fn().mockImplementation(query => ({
+    matches: false,
+    media: query,
+    onchange: null,
+    addListener: vi.fn(),
+    removeListener: vi.fn(),
+    addEventListener: vi.fn(),
+    removeEventListener: vi.fn(),
+    dispatchEvent: vi.fn(),
+  })),
+});
+
+// Mock IntersectionObserver
+global.IntersectionObserver = class IntersectionObserver {
+  constructor() {}
+  disconnect() {}
+  observe() {}
+  takeRecords() {
+    return [];
+  }
+  unobserve() {}
+};
+```
+
+### 5. Update package.json Scripts
+
+```json
+{
+  "scripts": {
+    "test": "vitest",
+    "test:ui": "vitest --ui",
+    "test:run": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "test:watch": "vitest watch",
+    "test:shard": "vitest --shard=%SHARD%/%TOTAL_SHARDS%"
+  }
+}
+```
+
+### 6. Create Example Test
+
+**Example Component Test** (`src/components/__tests__/Button.test.jsx`):
+```javascript
+import { describe, it, expect, vi } from 'vitest';
+import { render, screen } from '@testing-library/react';
+import userEvent from '@testing-library/user-event';
+import { Button } from '../Button';
+
+describe('Button Component', () => {
+  it('renders with correct text', () => {
+    render(<Button>Click me</Button>);
+
+    // Context7-verified query: Use getByRole for accessibility
+    expect(screen.getByRole('button', { name: 'Click me' })).toBeInTheDocument();
+  });
+
+  it('calls onClick handler when clicked', async () => {
+    const user = userEvent.setup();
+    const handleClick = vi.fn();
+
+    render(<Button onClick={handleClick}>Click me</Button>);
+
+    await user.click(screen.getByRole('button'));
+
+    expect(handleClick).toHaveBeenCalledTimes(1);
+  });
+
+  it('is disabled when disabled prop is true', () => {
+    render(<Button disabled>Cannot click</Button>);
+
+    expect(screen.getByRole('button')).toBeDisabled();
+  });
+});
+```
+
+### 7. CI/CD Integration (GitHub Actions)
+
+**GitHub Actions Workflow** (`.github/workflows/test.yml`):
+```yaml
+name: Tests
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        shard: [1, 2, 3]
+
+    steps:
+      - uses: actions/checkout@v3
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v3
+        with:
+          node-version: '18'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run tests (shard ${{ matrix.shard }}/3)
+        run: npm run test:run -- --shard=${{ matrix.shard }}/3
+
+      - name: Generate coverage
+        run: npm run test:coverage
+
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@v3
+        with:
+          files: ./coverage/lcov.info
+```
+
+## Output Format
+
+```
+🧪 TESTING FRAMEWORK SETUP
+==========================
+
+✅ Framework Detection:
+   - Project type: React
+   - Recommended: Vitest
+   - Testing Library: @testing-library/react
+
+📦 Dependencies Installed:
+   - vitest@latest
+   - @vitest/ui@latest
+   - @vitest/coverage-v8@latest
+   - @testing-library/react@latest
+   - @testing-library/user-event@latest
+   - @testing-library/jest-dom@latest
+
+⚙️  Configuration Created:
+   - vitest.config.js ✓
+   - test/setup.js ✓
+   - .github/workflows/test.yml ✓
+
+📋 Scripts Added:
+   - npm test (run tests in watch mode)
+   - npm run test:run (run tests once)
+   - npm run test:coverage (generate coverage report)
+   - npm run test:ui (interactive test UI)
+
+📚 Documentation:
+   - Example test created: src/components/__tests__/Button.test.jsx
+   - Testing guide: docs/TESTING.md
+
+🎯 Next Steps:
+   1. Write tests for existing components
+   2. Run tests: npm test
+   3. Check coverage: npm run test:coverage
+   4. Integrate with CI/CD pipeline
+```
+
+## Context7-Verified Patterns Applied
+
+Based on Context7 documentation from `/vitest-dev/vitest` and `/testing-library/testing-library-docs`:
+
+1. **Query Priority**: Setup uses semantic queries (getByRole, getByLabelText)
+2. **Coverage Configuration**: Realistic thresholds with proper exclusions
+3. **Test Isolation**: beforeEach/afterEach cleanup configured
+4. **Sharding Support**: Multi-process test execution enabled
+5. **Browser Testing**: jsdom environment configured for component testing
+6. **CI Integration**: GitHub Actions with test sharding
+
+## Validation Checklist
+
+Before completing setup, verify:
+- [ ] Testing framework installed and configured
+- [ ] Coverage reporting enabled with appropriate thresholds
+- [ ] Test setup file created with necessary mocks
+- [ ] Example test created and passing
+- [ ] package.json scripts updated
+- [ ] CI/CD workflow configured
+- [ ] Documentation created for team
+
+## Related Commands
+
+- `/test:coverage` - Generate and analyze coverage reports
+- `/e2e:setup` - Setup E2E testing with Playwright
+- `/lint:setup` - Configure linting for test files
+
+## Troubleshooting
+
+### Common Issues
+
+**Issue**: `ReferenceError: describe is not defined`
+**Solution**: Add `globals: true` to vitest.config.js
+
+**Issue**: `Cannot find module '@testing-library/jest-dom'`
+**Solution**: Ensure setupFiles path is correct in config
+
+**Issue**: Coverage thresholds not met
+**Solution**: Review uncovered code, write additional tests, or adjust thresholds
+
+## Support
+
+For issues or questions:
+- Review official documentation via Context7 MCP server
+- Check example tests in `test/examples/`
+- Consult frontend-testing-engineer agent

package/packages/plugin-testing/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@claudeautopm/plugin-testing",
+  "version": "2.0.0",
+  "description": "Testing frameworks, E2E testing, and quality assurance specialists",
+  "keywords": [
+    "claudeautopm",
+    "plugin",
+    "testing"
+  ],
+  "author": {
+    "name": "ClaudeAutoPM Team",
+    "email": "autopm@example.com"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rafeekpro/ClaudeAutoPM.git",
+    "directory": "packages/plugin-testing"
+  },
+  "homepage": "https://github.com/rafeekpro/ClaudeAutoPM/tree/main/packages/plugin-testing#readme",
+  "bugs": {
+    "url": "https://github.com/rafeekpro/ClaudeAutoPM/issues"
+  },
+  "engines": {
+    "node": ">=16.0.0",
+    "npm": ">=8.0.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "files": [
+    "agents/",
+    "plugin.json",
+    "README.md"
+  ],
+  "peerDependencies": {
+    "claude-autopm": ">=2.8.0"
+  }
+}

package/packages/plugin-testing/plugin.json

@@ -0,0 +1,197 @@
+{
+  "name": "@claudeautopm/plugin-testing",
+  "version": "2.0.0",
+  "schemaVersion": "2.0",
+  "displayName": "Testing & QA",
+  "description": "Complete testing plugin with Jest, Vitest, Testing Library, and comprehensive test strategies for frontend, backend, and E2E testing",
+  "category": "testing",
+  "metadata": {
+    "category": "Testing & QA",
+    "author": "ClaudeAutoPM Team",
+    "license": "MIT",
+    "homepage": "https://github.com/rafeekpro/ClaudeAutoPM",
+    "repository": {
+      "type": "git",
+      "url": "git+https://github.com/rafeekpro/ClaudeAutoPM.git",
+      "directory": "packages/plugin-testing"
+    },
+    "size": "~12 KB (gzipped)",
+    "required": false,
+    "tags": ["testing", "qa", "jest", "vitest", "testing-library", "unit-testing", "integration-testing"]
+  },
+  "agents": [
+    {
+      "name": "frontend-testing-engineer",
+      "file": "agents/frontend-testing-engineer.md",
+      "category": "testing",
+      "description": "Frontend unit and integration testing with Jest, Vitest, Testing Library for React, Vue, Angular",
+      "version": "2.0.0",
+      "tags": ["frontend", "testing", "jest", "vitest", "react-testing-library", "vue", "angular"],
+      "mcp": [],
+      "context7": [
+        "/vitest-dev/vitest",
+        "/testing-library/testing-library-docs",
+        "/testing-library/react-testing-library"
+      ]
+    }
+  ],
+  "commands": [
+    {
+      "name": "test-setup",
+      "file": "commands/test-setup.md",
+      "category": "testing",
+      "priority": "medium",
+      "description": "Setup comprehensive testing framework with Jest/Vitest, Testing Library, and coverage reporting",
+      "tags": ["testing", "setup", "jest", "vitest", "configuration"],
+      "mcpTools": ["context7"]
+    },
+    {
+      "name": "test-coverage",
+      "file": "commands/test-coverage.md",
+      "category": "testing",
+      "priority": "medium",
+      "description": "Generate and analyze test coverage reports with actionable improvements",
+      "tags": ["coverage", "reporting", "quality", "metrics"],
+      "mcpTools": []
+    },
+    {
+      "name": "jest-optimize",
+      "file": "commands/jest-optimize.md",
+      "description": "Optimize Jest test performance with parallel execution, sharding, and database optimization",
+      "category": "optimization",
+      "tags": ["jest", "performance", "parallel", "sharding", "database", "optimization"],
+      "requiredAgents": ["frontend-testing-engineer"],
+      "context7": [
+        "/goldbergyoni/nodejs-testing-best-practices",
+        "/websites/jestjs_io_next"
+      ]
+    },
+    {
+      "name": "playwright-optimize",
+      "file": "commands/playwright-optimize.md",
+      "description": "Optimize Playwright E2E tests with fully parallel execution, sharding, and browser optimization",
+      "category": "optimization",
+      "tags": ["playwright", "e2e", "parallel", "sharding", "performance", "optimization"],
+      "requiredAgents": ["e2e-test-engineer"],
+      "context7": [
+        "/microsoft/playwright"
+      ]
+    },
+    {
+      "name": "test-performance",
+      "file": "commands/test-performance.md",
+      "description": "Comprehensive testing performance optimization across Jest, Playwright, Vitest with CI/CD pipeline optimization",
+      "category": "optimization",
+      "tags": ["performance", "optimization", "jest", "playwright", "vitest", "ci-cd", "testing"],
+      "requiredAgents": ["frontend-testing-engineer", "e2e-test-engineer"],
+      "context7": [
+        "/goldbergyoni/nodejs-testing-best-practices",
+        "/microsoft/playwright",
+        "/vitest-dev/vitest"
+      ]
+    }
+  ],
+  "rules": [
+    {
+      "name": "testing-standards",
+      "file": "rules/testing-standards.md",
+      "priority": "high",
+      "description": "Comprehensive testing standards with Context7-verified best practices for unit, integration, and E2E tests",
+      "tags": ["testing", "standards", "best-practices", "quality"],
+      "appliesTo": ["commands", "agents"],
+      "enforcesOn": ["frontend-testing-engineer"]
+    },
+    {
+      "name": "test-coverage-requirements",
+      "file": "rules/test-coverage-requirements.md",
+      "priority": "high",
+      "description": "Test coverage thresholds and quality metrics enforcement",
+      "tags": ["coverage", "quality", "metrics", "enforcement"],
+      "appliesTo": ["commands", "agents"],
+      "enforcesOn": ["frontend-testing-engineer"]
+    }
+  ],
+  "scripts": [
+    {
+      "name": "vitest-config-example",
+      "file": "scripts/examples/vitest-config-example.js",
+      "description": "Vitest configuration example with coverage, sharding, and performance profiling",
+      "type": "example",
+      "executable": true,
+      "category": "vitest",
+      "tags": ["vitest", "config", "testing", "context7"]
+    },
+    {
+      "name": "react-testing-example",
+      "file": "scripts/examples/react-testing-example.test.jsx",
+      "description": "React Testing Library example with Context7-verified patterns and best practices",
+      "type": "example",
+      "executable": true,
+      "category": "react",
+      "tags": ["react", "testing-library", "vitest", "context7"]
+    },
+    {
+      "name": "vue-testing-example",
+      "file": "scripts/examples/vue-testing-example.test.js",
+      "description": "Vue Test Utils + Vitest example with Context7-verified patterns",
+      "type": "example",
+      "executable": true,
+      "category": "vue",
+      "tags": ["vue", "vitest", "testing", "context7"]
+    }
+  ],
+  "features": {
+    "unit_testing": {
+      "enabled": true,
+      "description": "Jest and Vitest for comprehensive unit testing"
+    },
+    "integration_testing": {
+      "enabled": true,
+      "description": "Integration testing strategies and patterns"
+    },
+    "component_testing": {
+      "enabled": true,
+      "description": "React Testing Library, Vue Test Utils, Angular Testing"
+    },
+    "coverage_reporting": {
+      "enabled": true,
+      "description": "Coverage analysis and reporting with Istanbul/c8"
+    },
+    "test_sharding": {
+      "enabled": true,
+      "description": "Parallel test execution and sharding for performance"
+    },
+    "snapshot_testing": {
+      "enabled": true,
+      "description": "Snapshot testing for UI components"
+    }
+  },
+  "dependencies": [],
+  "peerPlugins": [
+    "@claudeautopm/plugin-core"
+  ],
+  "mcpServers": {
+    "recommended": [
+      "context7"
+    ],
+    "optional": []
+  },
+  "keywords": [
+    "claudeautopm",
+    "plugin",
+    "testing",
+    "qa",
+    "jest",
+    "vitest",
+    "testing-library",
+    "react-testing-library",
+    "vue-test-utils",
+    "unit-testing",
+    "integration-testing",
+    "e2e-testing",
+    "coverage",
+    "tdd",
+    "bdd"
+  ],
+  "compatibleWith": ">=3.0.0"
+}