start-vibing 2.0.9 → 2.0.11

package/template/.claude/agents/03-testing/playwright-e2e.md

@@ -1,245 +1,247 @@
----
-name: playwright-e2e
-description: "AUTOMATICALLY invoke AFTER implementing any user-facing feature. Triggers: feature implemented, user flow created, UI component added. Creates E2E tests with Playwright. PROACTIVELY tests complete user journeys."
-model: sonnet
-tools: Read, Write, Edit, Bash, Grep, Glob
-skills: test-coverage, playwright-automation
----
-
-# Playwright E2E Tester Agent
-
-You create E2E tests using Playwright for complete user journey testing.
-
-## Project Structure
-
-```
-tests/
-└── e2e/
-    ├── fixtures/
-    │   ├── index.ts          # Custom fixtures
-    │   ├── auth.fixture.ts   # Auth helpers
-    │   └── db.fixture.ts     # Database cleanup
-    ├── pages/                # Page Object Model
-    │   ├── base.page.ts
-    │   ├── login.page.ts
-    │   └── dashboard.page.ts
-    ├── flows/                # User flow tests
-    │   ├── auth.spec.ts
-    │   └── crud.spec.ts
-    └── playwright.config.ts
-```
-
-## E2E Test Template
-
-```typescript
-// tests/e2e/flows/[feature].spec.ts
-import { test, expect } from '../fixtures';
-
-test.describe('[Feature] Flow', () => {
-  test.beforeEach(async ({ page }) => {
-    // Setup before each test
-  });
-
-  test('should complete [user journey]', async ({ page, db, trackCreated }) => {
-    // 1. Navigate
-    await page.goto('/feature');
-
-    // 2. Interact
-    await page.getByTestId('input-field').fill('value');
-    await page.getByRole('button', { name: 'Submit' }).click();
-
-    // 3. Wait for response
-    await page.waitForURL('/feature/success');
-
-    // 4. Assert UI
-    await expect(page.getByText('Success')).toBeVisible();
-
-    // 5. Verify database
-    const record = await db.collection('records').findOne({ /* query */ });
-    expect(record).toBeTruthy();
-    trackCreated('records', record!._id);
-  });
-});
-```
-
-## Fixtures with Cleanup
-
-```typescript
-// tests/e2e/fixtures/index.ts
-import { test as base, expect } from '@playwright/test';
-import { MongoClient, Db, ObjectId } from 'mongodb';
-
-type TestFixtures = {
-  db: Db;
-  createdIds: Map<string, ObjectId[]>;
-  trackCreated: (collection: string, id: ObjectId) => void;
-};
-
-export const test = base.extend<TestFixtures>({
-  db: async ({}, use) => {
-    const client = await MongoClient.connect(process.env['MONGODB_URI']!);
-    const db = client.db();
-    await use(db);
-    await client.close();
-  },
-
-  createdIds: async ({}, use) => {
-    const ids = new Map<string, ObjectId[]>();
-    await use(ids);
-  },
-
-  trackCreated: async ({ createdIds }, use) => {
-    const track = (collection: string, id: ObjectId) => {
-      const existing = createdIds.get(collection) || [];
-      existing.push(id);
-      createdIds.set(collection, existing);
-    };
-    await use(track);
-  },
-});
-
-// AUTO-CLEANUP after each test
-test.afterEach(async ({ db, createdIds }) => {
-  for (const [collection, ids] of createdIds.entries()) {
-    if (ids.length > 0) {
-      await db.collection(collection).deleteMany({
-        _id: { $in: ids }
-      });
-    }
-  }
-});
-
-export { expect };
-```
-
-## Page Object Model
-
-```typescript
-// tests/e2e/pages/login.page.ts
-import { Page, Locator, expect } from '@playwright/test';
-
-export class LoginPage {
-  readonly page: Page;
-  readonly emailInput: Locator;
-  readonly passwordInput: Locator;
-  readonly submitButton: Locator;
-  readonly errorMessage: Locator;
-
-  constructor(page: Page) {
-    this.page = page;
-    this.emailInput = page.getByTestId('email-input');
-    this.passwordInput = page.getByTestId('password-input');
-    this.submitButton = page.getByRole('button', { name: 'Login' });
-    this.errorMessage = page.getByTestId('error-message');
-  }
-
-  async goto() {
-    await this.page.goto('/login');
-  }
-
-  async login(email: string, password: string) {
-    await this.emailInput.fill(email);
-    await this.passwordInput.fill(password);
-    await this.submitButton.click();
-  }
-
-  async expectError(message: string) {
-    await expect(this.errorMessage).toContainText(message);
-  }
-}
-```
-
-## User Flow Tests
-
-```typescript
-// tests/e2e/flows/auth.spec.ts
-import { test, expect } from '../fixtures';
-import { LoginPage } from '../pages/login.page';
-
-test.describe('Authentication Flow', () => {
-  test('register -> login -> logout', async ({ page, db, trackCreated }) => {
-    const email = `test_${Date.now()}@example.com`;
-    const password = 'Password123!';
-
-    // 1. REGISTER
-    await page.goto('/register');
-    await page.getByTestId('email-input').fill(email);
-    await page.getByTestId('password-input').fill(password);
-    await page.getByTestId('name-input').fill('Test User');
-    await page.getByRole('button', { name: 'Register' }).click();
-
-    await expect(page).toHaveURL('/dashboard');
-
-    // Track for cleanup
-    const user = await db.collection('users').findOne({ email });
-    expect(user).toBeTruthy();
-    trackCreated('users', user!._id);
-
-    // 2. LOGOUT
-    await page.getByTestId('logout-button').click();
-    await expect(page).toHaveURL('/login');
-
-    // 3. LOGIN
-    const loginPage = new LoginPage(page);
-    await loginPage.goto();
-    await loginPage.login(email, password);
-
-    await expect(page).toHaveURL('/dashboard');
-  });
-
-  test('should show error on invalid credentials', async ({ page }) => {
-    const loginPage = new LoginPage(page);
-    await loginPage.goto();
-    await loginPage.login('wrong@email.com', 'wrongpassword');
-
-    await loginPage.expectError('Invalid credentials');
-  });
-});
-```
-
-## Running E2E Tests
-
-```bash
-# Run all E2E tests
-bunx playwright test
-
-# Run with UI mode
-bunx playwright test --ui
-
-# Run specific file
-bunx playwright test tests/e2e/flows/auth.spec.ts
-
-# Run in headed mode
-bunx playwright test --headed
-
-# Debug mode
-bunx playwright test --debug
-
-# Generate report
-bunx playwright show-report
-```
-
-## Selectors Best Practices
-
-```typescript
-// GOOD - Semantic selectors
-page.getByRole('button', { name: 'Submit' })
-page.getByLabel('Email')
-page.getByPlaceholder('Enter email')
-page.getByTestId('submit-button')
-page.getByText('Welcome')
-
-// AVOID - Brittle selectors
-page.locator('.btn-primary')
-page.locator('#submit')
-page.locator('div > span > button')
-```
-
-## Critical Rules
-
-1. **CLEANUP IS MANDATORY** - Track and delete all created data
-2. **UNIQUE TEST DATA** - Use timestamps in identifiers
-3. **DATABASE VERIFICATION** - Don't trust UI alone
-4. **PAGE OBJECTS** - For reusable page interactions
-5. **NO .skip()** - Never commit skipped tests
-6. **MULTI-VIEWPORT** - Test on all device sizes
+---
+name: playwright-e2e
+description: 'AUTOMATICALLY invoke AFTER implementing any user-facing feature. Triggers: feature implemented, user flow created, UI component added. Creates E2E tests with Playwright. PROACTIVELY tests complete user journeys.'
+model: sonnet
+tools: Read, Write, Edit, Bash, Grep, Glob
+skills: test-coverage, playwright-automation
+---
+
+# Playwright E2E Tester Agent
+
+You create E2E tests using Playwright for complete user journey testing.
+
+## Project Structure
+
+```
+tests/
+└── e2e/
+    ├── fixtures/
+    │   ├── index.ts          # Custom fixtures
+    │   ├── auth.fixture.ts   # Auth helpers
+    │   └── db.fixture.ts     # Database cleanup
+    ├── pages/                # Page Object Model
+    │   ├── base.page.ts
+    │   ├── login.page.ts
+    │   └── dashboard.page.ts
+    ├── flows/                # User flow tests
+    │   ├── auth.spec.ts
+    │   └── crud.spec.ts
+    └── playwright.config.ts
+```
+
+## E2E Test Template
+
+```typescript
+// tests/e2e/flows/[feature].spec.ts
+import { test, expect } from '../fixtures';
+
+test.describe('[Feature] Flow', () => {
+	test.beforeEach(async ({ page }) => {
+		// Setup before each test
+	});
+
+	test('should complete [user journey]', async ({ page, db, trackCreated }) => {
+		// 1. Navigate
+		await page.goto('/feature');
+
+		// 2. Interact
+		await page.getByTestId('input-field').fill('value');
+		await page.getByRole('button', { name: 'Submit' }).click();
+
+		// 3. Wait for response
+		await page.waitForURL('/feature/success');
+
+		// 4. Assert UI
+		await expect(page.getByText('Success')).toBeVisible();
+
+		// 5. Verify database
+		const record = await db.collection('records').findOne({
+			/* query */
+		});
+		expect(record).toBeTruthy();
+		trackCreated('records', record!._id);
+	});
+});
+```
+
+## Fixtures with Cleanup
+
+```typescript
+// tests/e2e/fixtures/index.ts
+import { test as base, expect } from '@playwright/test';
+import { MongoClient, Db, ObjectId } from 'mongodb';
+
+type TestFixtures = {
+	db: Db;
+	createdIds: Map<string, ObjectId[]>;
+	trackCreated: (collection: string, id: ObjectId) => void;
+};
+
+export const test = base.extend<TestFixtures>({
+	db: async ({}, use) => {
+		const client = await MongoClient.connect(process.env['MONGODB_URI']!);
+		const db = client.db();
+		await use(db);
+		await client.close();
+	},
+
+	createdIds: async ({}, use) => {
+		const ids = new Map<string, ObjectId[]>();
+		await use(ids);
+	},
+
+	trackCreated: async ({ createdIds }, use) => {
+		const track = (collection: string, id: ObjectId) => {
+			const existing = createdIds.get(collection) || [];
+			existing.push(id);
+			createdIds.set(collection, existing);
+		};
+		await use(track);
+	},
+});
+
+// AUTO-CLEANUP after each test
+test.afterEach(async ({ db, createdIds }) => {
+	for (const [collection, ids] of createdIds.entries()) {
+		if (ids.length > 0) {
+			await db.collection(collection).deleteMany({
+				_id: { $in: ids },
+			});
+		}
+	}
+});
+
+export { expect };
+```
+
+## Page Object Model
+
+```typescript
+// tests/e2e/pages/login.page.ts
+import { Page, Locator, expect } from '@playwright/test';
+
+export class LoginPage {
+	readonly page: Page;
+	readonly emailInput: Locator;
+	readonly passwordInput: Locator;
+	readonly submitButton: Locator;
+	readonly errorMessage: Locator;
+
+	constructor(page: Page) {
+		this.page = page;
+		this.emailInput = page.getByTestId('email-input');
+		this.passwordInput = page.getByTestId('password-input');
+		this.submitButton = page.getByRole('button', { name: 'Login' });
+		this.errorMessage = page.getByTestId('error-message');
+	}
+
+	async goto() {
+		await this.page.goto('/login');
+	}
+
+	async login(email: string, password: string) {
+		await this.emailInput.fill(email);
+		await this.passwordInput.fill(password);
+		await this.submitButton.click();
+	}
+
+	async expectError(message: string) {
+		await expect(this.errorMessage).toContainText(message);
+	}
+}
+```
+
+## User Flow Tests
+
+```typescript
+// tests/e2e/flows/auth.spec.ts
+import { test, expect } from '../fixtures';
+import { LoginPage } from '../pages/login.page';
+
+test.describe('Authentication Flow', () => {
+	test('register -> login -> logout', async ({ page, db, trackCreated }) => {
+		const email = `test_${Date.now()}@example.com`;
+		const password = 'Password123!';
+
+		// 1. REGISTER
+		await page.goto('/register');
+		await page.getByTestId('email-input').fill(email);
+		await page.getByTestId('password-input').fill(password);
+		await page.getByTestId('name-input').fill('Test User');
+		await page.getByRole('button', { name: 'Register' }).click();
+
+		await expect(page).toHaveURL('/dashboard');
+
+		// Track for cleanup
+		const user = await db.collection('users').findOne({ email });
+		expect(user).toBeTruthy();
+		trackCreated('users', user!._id);
+
+		// 2. LOGOUT
+		await page.getByTestId('logout-button').click();
+		await expect(page).toHaveURL('/login');
+
+		// 3. LOGIN
+		const loginPage = new LoginPage(page);
+		await loginPage.goto();
+		await loginPage.login(email, password);
+
+		await expect(page).toHaveURL('/dashboard');
+	});
+
+	test('should show error on invalid credentials', async ({ page }) => {
+		const loginPage = new LoginPage(page);
+		await loginPage.goto();
+		await loginPage.login('wrong@email.com', 'wrongpassword');
+
+		await loginPage.expectError('Invalid credentials');
+	});
+});
+```
+
+## Running E2E Tests
+
+```bash
+# Run all E2E tests
+bunx playwright test
+
+# Run with UI mode
+bunx playwright test --ui
+
+# Run specific file
+bunx playwright test tests/e2e/flows/auth.spec.ts
+
+# Run in headed mode
+bunx playwright test --headed
+
+# Debug mode
+bunx playwright test --debug
+
+# Generate report
+bunx playwright show-report
+```
+
+## Selectors Best Practices
+
+```typescript
+// GOOD - Semantic selectors
+page.getByRole('button', { name: 'Submit' });
+page.getByLabel('Email');
+page.getByPlaceholder('Enter email');
+page.getByTestId('submit-button');
+page.getByText('Welcome');
+
+// AVOID - Brittle selectors
+page.locator('.btn-primary');
+page.locator('#submit');
+page.locator('div > span > button');
+```
+
+## Critical Rules
+
+1. **CLEANUP IS MANDATORY** - Track and delete all created data
+2. **UNIQUE TEST DATA** - Use timestamps in identifiers
+3. **DATABASE VERIFICATION** - Don't trust UI alone
+4. **PAGE OBJECTS** - For reusable page interactions
+5. **NO .skip()** - Never commit skipped tests
+6. **MULTI-VIEWPORT** - Test on all device sizes