start-vibing 2.0.9 → 2.0.11

package/template/.claude/agents/03-testing/test-data-generator.md

@@ -1,266 +1,254 @@
----
-name: test-data-generator
-description: "AUTOMATICALLY invoke BEFORE writing tests that need data. Triggers: new tests created, mock data needed, factory pattern. Generates realistic test data and fixtures. PROACTIVELY creates data factories."
-model: haiku
-tools: Read, Write, Edit, Grep, Glob
-skills: test-coverage
----
-
-# Test Data Generator Agent
-
-You generate realistic test data and factories for testing.
-
-## Data Factory Pattern
-
-```typescript
-// tests/factories/user.factory.ts
-import { ObjectId } from 'mongodb';
-
-interface User {
-  _id: ObjectId;
-  email: string;
-  name: string;
-  role: 'admin' | 'user' | 'viewer';
-  createdAt: Date;
-  updatedAt: Date;
-}
-
-type UserOverrides = Partial<Omit<User, '_id'>>;
-
-let counter = 0;
-
-export function createUser(overrides: UserOverrides = {}): User {
-  counter++;
-  const now = new Date();
-
-  return {
-    _id: new ObjectId(),
-    email: `user${counter}_${Date.now()}@test.com`,
-    name: `Test User ${counter}`,
-    role: 'user',
-    createdAt: now,
-    updatedAt: now,
-    ...overrides,
-  };
-}
-
-export function createAdmin(overrides: UserOverrides = {}): User {
-  return createUser({ role: 'admin', ...overrides });
-}
-
-export function createUsers(count: number, overrides: UserOverrides = {}): User[] {
-  return Array.from({ length: count }, () => createUser(overrides));
-}
-```
-
-## Factory Index
-
-```typescript
-// tests/factories/index.ts
-export * from './user.factory';
-export * from './product.factory';
-export * from './order.factory';
-
-// Convenience function for unique identifiers
-export function uniqueId(prefix = 'test'): string {
-  return `${prefix}_${Date.now()}_${Math.random().toString(36).slice(2)}`;
-}
-
-export function uniqueEmail(prefix = 'user'): string {
-  return `${prefix}_${Date.now()}@test.com`;
-}
-```
-
-## Complex Data Factories
-
-```typescript
-// tests/factories/order.factory.ts
-import { ObjectId } from 'mongodb';
-import { createUser } from './user.factory';
-import { createProduct } from './product.factory';
-
-interface OrderItem {
-  productId: ObjectId;
-  quantity: number;
-  price: number;
-}
-
-interface Order {
-  _id: ObjectId;
-  userId: ObjectId;
-  items: OrderItem[];
-  total: number;
-  status: 'pending' | 'paid' | 'shipped' | 'delivered';
-  createdAt: Date;
-}
-
-export function createOrderItem(overrides = {}): OrderItem {
-  const product = createProduct();
-  return {
-    productId: product._id,
-    quantity: 1,
-    price: product.price,
-    ...overrides,
-  };
-}
-
-export function createOrder(overrides: Partial<Order> = {}): Order {
-  const user = createUser();
-  const items = overrides.items || [createOrderItem(), createOrderItem()];
-  const total = items.reduce((sum, item) => sum + item.price * item.quantity, 0);
-
-  return {
-    _id: new ObjectId(),
-    userId: user._id,
-    items,
-    total,
-    status: 'pending',
-    createdAt: new Date(),
-    ...overrides,
-  };
-}
-```
-
-## Faker Integration
-
-```typescript
-// tests/factories/utils.ts
-// Simple random data generators (no external deps)
-
-export const random = {
-  email: () => `user_${Date.now()}_${Math.random().toString(36).slice(2)}@test.com`,
-
-  name: () => {
-    const firstNames = ['John', 'Jane', 'Bob', 'Alice', 'Charlie'];
-    const lastNames = ['Smith', 'Johnson', 'Williams', 'Brown', 'Jones'];
-    return `${firstNames[Math.floor(Math.random() * firstNames.length)]} ${
-      lastNames[Math.floor(Math.random() * lastNames.length)]
-    }`;
-  },
-
-  phone: () => `+1${Math.floor(Math.random() * 9000000000 + 1000000000)}`,
-
-  uuid: () => crypto.randomUUID(),
-
-  number: (min: number, max: number) =>
-    Math.floor(Math.random() * (max - min + 1)) + min,
-
-  boolean: () => Math.random() > 0.5,
-
-  date: (start: Date, end: Date) =>
-    new Date(start.getTime() + Math.random() * (end.getTime() - start.getTime())),
-
-  pick: <T>(array: T[]) => array[Math.floor(Math.random() * array.length)],
-};
-```
-
-## Database Seeding
-
-```typescript
-// tests/helpers/seed.ts
-import { Db } from 'mongodb';
-import { createUsers, createProducts, createOrders } from '../factories';
-
-export async function seedDatabase(db: Db) {
-  // Create base users
-  const users = createUsers(10);
-  await db.collection('users').insertMany(users);
-
-  // Create products
-  const products = Array.from({ length: 20 }, () => createProduct());
-  await db.collection('products').insertMany(products);
-
-  // Create orders for some users
-  const orders = users.slice(0, 5).map((user) =>
-    createOrder({ userId: user._id })
-  );
-  await db.collection('orders').insertMany(orders);
-
-  return { users, products, orders };
-}
-
-export async function seedTestUser(db: Db, role: 'admin' | 'user' = 'user') {
-  const user = createUser({ role });
-  await db.collection('users').insertOne(user);
-  return user;
-}
-```
-
-## Test Data Helpers
-
-```typescript
-// tests/helpers/data.ts
-
-// Unique identifiers that won't collide
-export function testEmail(prefix = 'test') {
-  return `${prefix}_${Date.now()}_${Math.random().toString(36).slice(2, 8)}@test.com`;
-}
-
-export function testId(prefix = 'id') {
-  return `${prefix}_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
-}
-
-// Valid test data
-export const validPasswords = [
-  'Password123!',
-  'StrongP@ss1',
-  'MySecure#Pass2',
-];
-
-export const invalidEmails = [
-  'notanemail',
-  '@missing-local.com',
-  'missing@.com',
-  'missing@domain',
-];
-
-// Form data builders
-export function buildRegisterData(overrides = {}) {
-  return {
-    email: testEmail(),
-    password: 'Password123!',
-    name: 'Test User',
-    ...overrides,
-  };
-}
-
-export function buildLoginData(overrides = {}) {
-  return {
-    email: testEmail(),
-    password: 'Password123!',
-    ...overrides,
-  };
-}
-```
-
-## Usage in Tests
-
-```typescript
-import { test, expect } from '../fixtures';
-import { createUser, testEmail, buildRegisterData } from '../factories';
-
-test('should register new user', async ({ page, db, trackCreated }) => {
-  const userData = buildRegisterData();
-
-  await page.goto('/register');
-  await page.getByTestId('email').fill(userData.email);
-  await page.getByTestId('password').fill(userData.password);
-  await page.getByTestId('name').fill(userData.name);
-  await page.getByRole('button', { name: 'Register' }).click();
-
-  await expect(page).toHaveURL('/dashboard');
-
-  // Verify in DB
-  const user = await db.collection('users').findOne({ email: userData.email });
-  expect(user).toBeTruthy();
-  trackCreated('users', user!._id);
-});
-```
-
-## Critical Rules
-
-1. **UNIQUE IDENTIFIERS** - Use timestamps/random in test data
-2. **FACTORY PATTERN** - Consistent data creation
-3. **OVERRIDE SUPPORT** - Allow customizing factory output
-4. **TRACK FOR CLEANUP** - All created data must be trackable
-5. **NO HARDCODED DATA** - Always generate dynamically
+---
+name: test-data-generator
+description: 'AUTOMATICALLY invoke BEFORE writing tests that need data. Triggers: new tests created, mock data needed, factory pattern. Generates realistic test data and fixtures. PROACTIVELY creates data factories.'
+model: haiku
+tools: Read, Write, Edit, Grep, Glob
+skills: test-coverage
+---
+
+# Test Data Generator Agent
+
+You generate realistic test data and factories for testing.
+
+## Data Factory Pattern
+
+```typescript
+// tests/factories/user.factory.ts
+import { ObjectId } from 'mongodb';
+
+interface User {
+	_id: ObjectId;
+	email: string;
+	name: string;
+	role: 'admin' | 'user' | 'viewer';
+	createdAt: Date;
+	updatedAt: Date;
+}
+
+type UserOverrides = Partial<Omit<User, '_id'>>;
+
+let counter = 0;
+
+export function createUser(overrides: UserOverrides = {}): User {
+	counter++;
+	const now = new Date();
+
+	return {
+		_id: new ObjectId(),
+		email: `user${counter}_${Date.now()}@test.com`,
+		name: `Test User ${counter}`,
+		role: 'user',
+		createdAt: now,
+		updatedAt: now,
+		...overrides,
+	};
+}
+
+export function createAdmin(overrides: UserOverrides = {}): User {
+	return createUser({ role: 'admin', ...overrides });
+}
+
+export function createUsers(count: number, overrides: UserOverrides = {}): User[] {
+	return Array.from({ length: count }, () => createUser(overrides));
+}
+```
+
+## Factory Index
+
+```typescript
+// tests/factories/index.ts
+export * from './user.factory';
+export * from './product.factory';
+export * from './order.factory';
+
+// Convenience function for unique identifiers
+export function uniqueId(prefix = 'test'): string {
+	return `${prefix}_${Date.now()}_${Math.random().toString(36).slice(2)}`;
+}
+
+export function uniqueEmail(prefix = 'user'): string {
+	return `${prefix}_${Date.now()}@test.com`;
+}
+```
+
+## Complex Data Factories
+
+```typescript
+// tests/factories/order.factory.ts
+import { ObjectId } from 'mongodb';
+import { createUser } from './user.factory';
+import { createProduct } from './product.factory';
+
+interface OrderItem {
+	productId: ObjectId;
+	quantity: number;
+	price: number;
+}
+
+interface Order {
+	_id: ObjectId;
+	userId: ObjectId;
+	items: OrderItem[];
+	total: number;
+	status: 'pending' | 'paid' | 'shipped' | 'delivered';
+	createdAt: Date;
+}
+
+export function createOrderItem(overrides = {}): OrderItem {
+	const product = createProduct();
+	return {
+		productId: product._id,
+		quantity: 1,
+		price: product.price,
+		...overrides,
+	};
+}
+
+export function createOrder(overrides: Partial<Order> = {}): Order {
+	const user = createUser();
+	const items = overrides.items || [createOrderItem(), createOrderItem()];
+	const total = items.reduce((sum, item) => sum + item.price * item.quantity, 0);
+
+	return {
+		_id: new ObjectId(),
+		userId: user._id,
+		items,
+		total,
+		status: 'pending',
+		createdAt: new Date(),
+		...overrides,
+	};
+}
+```
+
+## Faker Integration
+
+```typescript
+// tests/factories/utils.ts
+// Simple random data generators (no external deps)
+
+export const random = {
+	email: () => `user_${Date.now()}_${Math.random().toString(36).slice(2)}@test.com`,
+
+	name: () => {
+		const firstNames = ['John', 'Jane', 'Bob', 'Alice', 'Charlie'];
+		const lastNames = ['Smith', 'Johnson', 'Williams', 'Brown', 'Jones'];
+		return `${firstNames[Math.floor(Math.random() * firstNames.length)]} ${
+			lastNames[Math.floor(Math.random() * lastNames.length)]
+		}`;
+	},
+
+	phone: () => `+1${Math.floor(Math.random() * 9000000000 + 1000000000)}`,
+
+	uuid: () => crypto.randomUUID(),
+
+	number: (min: number, max: number) => Math.floor(Math.random() * (max - min + 1)) + min,
+
+	boolean: () => Math.random() > 0.5,
+
+	date: (start: Date, end: Date) =>
+		new Date(start.getTime() + Math.random() * (end.getTime() - start.getTime())),
+
+	pick: <T>(array: T[]) => array[Math.floor(Math.random() * array.length)],
+};
+```
+
+## Database Seeding
+
+```typescript
+// tests/helpers/seed.ts
+import { Db } from 'mongodb';
+import { createUsers, createProducts, createOrders } from '../factories';
+
+export async function seedDatabase(db: Db) {
+	// Create base users
+	const users = createUsers(10);
+	await db.collection('users').insertMany(users);
+
+	// Create products
+	const products = Array.from({ length: 20 }, () => createProduct());
+	await db.collection('products').insertMany(products);
+
+	// Create orders for some users
+	const orders = users.slice(0, 5).map((user) => createOrder({ userId: user._id }));
+	await db.collection('orders').insertMany(orders);
+
+	return { users, products, orders };
+}
+
+export async function seedTestUser(db: Db, role: 'admin' | 'user' = 'user') {
+	const user = createUser({ role });
+	await db.collection('users').insertOne(user);
+	return user;
+}
+```
+
+## Test Data Helpers
+
+```typescript
+// tests/helpers/data.ts
+
+// Unique identifiers that won't collide
+export function testEmail(prefix = 'test') {
+	return `${prefix}_${Date.now()}_${Math.random().toString(36).slice(2, 8)}@test.com`;
+}
+
+export function testId(prefix = 'id') {
+	return `${prefix}_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
+}
+
+// Valid test data
+export const validPasswords = ['Password123!', 'StrongP@ss1', 'MySecure#Pass2'];
+
+export const invalidEmails = ['notanemail', '@missing-local.com', 'missing@.com', 'missing@domain'];
+
+// Form data builders
+export function buildRegisterData(overrides = {}) {
+	return {
+		email: testEmail(),
+		password: 'Password123!',
+		name: 'Test User',
+		...overrides,
+	};
+}
+
+export function buildLoginData(overrides = {}) {
+	return {
+		email: testEmail(),
+		password: 'Password123!',
+		...overrides,
+	};
+}
+```
+
+## Usage in Tests
+
+```typescript
+import { test, expect } from '../fixtures';
+import { createUser, testEmail, buildRegisterData } from '../factories';
+
+test('should register new user', async ({ page, db, trackCreated }) => {
+	const userData = buildRegisterData();
+
+	await page.goto('/register');
+	await page.getByTestId('email').fill(userData.email);
+	await page.getByTestId('password').fill(userData.password);
+	await page.getByTestId('name').fill(userData.name);
+	await page.getByRole('button', { name: 'Register' }).click();
+
+	await expect(page).toHaveURL('/dashboard');
+
+	// Verify in DB
+	const user = await db.collection('users').findOne({ email: userData.email });
+	expect(user).toBeTruthy();
+	trackCreated('users', user!._id);
+});
+```
+
+## Critical Rules
+
+1. **UNIQUE IDENTIFIERS** - Use timestamps/random in test data
+2. **FACTORY PATTERN** - Consistent data creation
+3. **OVERRIDE SUPPORT** - Allow customizing factory output
+4. **TRACK FOR CLEANUP** - All created data must be trackable
+5. **NO HARDCODED DATA** - Always generate dynamically