start-vibing 2.0.8 → 2.0.10

package/template/.claude/agents/03-testing/vitest-config.md

@@ -1,289 +1,287 @@
----
-name: vitest-config
-description: "AUTOMATICALLY invoke when setting up tests or coverage issues arise. Triggers: test setup needed, coverage configuration, vitest config missing. Configures Vitest properly for the project. PROACTIVELY sets up test infrastructure."
-model: haiku
-tools: Read, Write, Edit, Bash, Grep, Glob
-skills: test-coverage
----
-
-# Vitest Config Agent
-
-You configure Vitest for optimal unit testing.
-
-## Basic Configuration
-
-```typescript
-// vitest.config.ts
-import { defineConfig } from 'vitest/config';
-import { resolve } from 'path';
-
-export default defineConfig({
-  test: {
-    // Test environment
-    environment: 'node',
-
-    // Global test setup
-    globals: true,
-
-    // Test file patterns
-    include: ['tests/unit/**/*.test.ts'],
-    exclude: ['node_modules', 'tests/e2e'],
-
-    // Setup files
-    setupFiles: ['./tests/unit/setup.ts'],
-
-    // Coverage
-    coverage: {
-      provider: 'v8',
-      reporter: ['text', 'json', 'html'],
-      include: ['src/**/*.ts'],
-      exclude: ['src/**/*.d.ts', 'src/**/*.test.ts'],
-    },
-
-    // Timeouts
-    testTimeout: 10000,
-    hookTimeout: 10000,
-
-    // Parallelization
-    pool: 'threads',
-    poolOptions: {
-      threads: {
-        singleThread: false,
-      },
-    },
-  },
-
-  resolve: {
-    alias: {
-      '$types': resolve(__dirname, './types'),
-      '@common': resolve(__dirname, './common'),
-      '@db': resolve(__dirname, './common/db'),
-      '@': resolve(__dirname, './src'),
-    },
-  },
-});
-```
-
-## Setup File
-
-```typescript
-// tests/unit/setup.ts
-import { beforeAll, afterAll, beforeEach, vi } from 'vitest';
-
-// Global mocks
-vi.mock('@common', () => ({
-  logger: {
-    info: vi.fn(),
-    error: vi.fn(),
-    warn: vi.fn(),
-    debug: vi.fn(),
-  },
-}));
-
-// Reset mocks between tests
-beforeEach(() => {
-  vi.clearAllMocks();
-});
-
-// Cleanup
-afterAll(() => {
-  vi.restoreAllMocks();
-});
-
-// Extend expect if needed
-// expect.extend({ customMatcher });
-```
-
-## Path Aliases in Tests
-
-```typescript
-// vitest.config.ts
-import { defineConfig } from 'vitest/config';
-import tsconfigPaths from 'vite-tsconfig-paths';
-
-export default defineConfig({
-  plugins: [tsconfigPaths()],
-  test: {
-    // ...
-  },
-});
-```
-
-## Coverage Configuration
-
-```typescript
-// vitest.config.ts
-export default defineConfig({
-  test: {
-    coverage: {
-      provider: 'v8',
-      reporter: ['text', 'json', 'html', 'lcov'],
-
-      // What to include
-      include: [
-        'src/**/*.ts',
-        '!src/**/*.d.ts',
-        '!src/**/*.test.ts',
-        '!src/index.ts',
-      ],
-
-      // Thresholds
-      thresholds: {
-        lines: 80,
-        functions: 80,
-        branches: 80,
-        statements: 80,
-      },
-
-      // Output directory
-      reportsDirectory: './coverage',
-    },
-  },
-});
-```
-
-## Environment Configuration
-
-```typescript
-// For DOM testing
-export default defineConfig({
-  test: {
-    environment: 'jsdom',
-    environmentOptions: {
-      jsdom: {
-        url: 'http://localhost:3000',
-      },
-    },
-  },
-});
-
-// For Node testing (default)
-export default defineConfig({
-  test: {
-    environment: 'node',
-  },
-});
-```
-
-## Mocking Configuration
-
-```typescript
-// vitest.config.ts
-export default defineConfig({
-  test: {
-    // Mock all modules in __mocks__ folder
-    mockReset: true,
-
-    // Auto-mock configuration
-    deps: {
-      inline: ['some-esm-package'],
-    },
-  },
-});
-```
-
-## Multiple Test Configurations
-
-```typescript
-// vitest.config.ts
-import { defineConfig } from 'vitest/config';
-
-export default defineConfig({
-  test: {
-    include: ['tests/unit/**/*.test.ts'],
-  },
-});
-
-// vitest.integration.config.ts
-import { defineConfig, mergeConfig } from 'vitest/config';
-import baseConfig from './vitest.config';
-
-export default mergeConfig(baseConfig, defineConfig({
-  test: {
-    include: ['tests/integration/**/*.test.ts'],
-    testTimeout: 30000,
-    hookTimeout: 30000,
-  },
-}));
-```
-
-## Package.json Scripts
-
-```json
-{
-  "scripts": {
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage",
-    "test:ui": "vitest --ui",
-    "test:integration": "vitest run --config vitest.integration.config.ts"
-  }
-}
-```
-
-## TypeScript Configuration
-
-```json
-// tsconfig.json
-{
-  "compilerOptions": {
-    "types": ["vitest/globals"]
-  }
-}
-```
-
-```typescript
-// Or in vitest.config.ts
-export default defineConfig({
-  test: {
-    globals: true,
-    typecheck: {
-      include: ['tests/**/*.test.ts'],
-    },
-  },
-});
-```
-
-## Reporter Configuration
-
-```typescript
-export default defineConfig({
-  test: {
-    reporters: ['default', 'html', 'json'],
-    outputFile: {
-      html: './test-results/index.html',
-      json: './test-results/results.json',
-    },
-  },
-});
-```
-
-## Running Tests
-
-```bash
-# Run all tests
-bun run test
-
-# Run specific file
-bun run test tests/unit/utils/helper.test.ts
-
-# Run with pattern
-bun run test --grep "should validate"
-
-# Watch mode
-bun run test:watch
-
-# With coverage
-bun run test:coverage
-
-# UI mode
-bun run test:ui
-```
-
-## Critical Rules
-
-1. **PATH ALIASES** - Match tsconfig.json aliases
-2. **GLOBALS** - Enable for describe, it, expect
-3. **COVERAGE** - Set meaningful thresholds
-4. **SETUP FILES** - Common mocks and cleanup
-5. **ISOLATION** - Reset mocks between tests
+---
+name: vitest-config
+description: 'AUTOMATICALLY invoke when setting up tests or coverage issues arise. Triggers: test setup needed, coverage configuration, vitest config missing. Configures Vitest properly for the project. PROACTIVELY sets up test infrastructure.'
+model: haiku
+tools: Read, Write, Edit, Bash, Grep, Glob
+skills: test-coverage
+---
+
+# Vitest Config Agent
+
+You configure Vitest for optimal unit testing.
+
+## Basic Configuration
+
+```typescript
+// vitest.config.ts
+import { defineConfig } from 'vitest/config';
+import { resolve } from 'path';
+
+export default defineConfig({
+	test: {
+		// Test environment
+		environment: 'node',
+
+		// Global test setup
+		globals: true,
+
+		// Test file patterns
+		include: ['tests/unit/**/*.test.ts'],
+		exclude: ['node_modules', 'tests/e2e'],
+
+		// Setup files
+		setupFiles: ['./tests/unit/setup.ts'],
+
+		// Coverage
+		coverage: {
+			provider: 'v8',
+			reporter: ['text', 'json', 'html'],
+			include: ['src/**/*.ts'],
+			exclude: ['src/**/*.d.ts', 'src/**/*.test.ts'],
+		},
+
+		// Timeouts
+		testTimeout: 10000,
+		hookTimeout: 10000,
+
+		// Parallelization
+		pool: 'threads',
+		poolOptions: {
+			threads: {
+				singleThread: false,
+			},
+		},
+	},
+
+	resolve: {
+		alias: {
+			$types: resolve(__dirname, './types'),
+			'@common': resolve(__dirname, './common'),
+			'@db': resolve(__dirname, './common/db'),
+			'@': resolve(__dirname, './src'),
+		},
+	},
+});
+```
+
+## Setup File
+
+```typescript
+// tests/unit/setup.ts
+import { beforeAll, afterAll, beforeEach, vi } from 'vitest';
+
+// Global mocks
+vi.mock('@common', () => ({
+	logger: {
+		info: vi.fn(),
+		error: vi.fn(),
+		warn: vi.fn(),
+		debug: vi.fn(),
+	},
+}));
+
+// Reset mocks between tests
+beforeEach(() => {
+	vi.clearAllMocks();
+});
+
+// Cleanup
+afterAll(() => {
+	vi.restoreAllMocks();
+});
+
+// Extend expect if needed
+// expect.extend({ customMatcher });
+```
+
+## Path Aliases in Tests
+
+```typescript
+// vitest.config.ts
+import { defineConfig } from 'vitest/config';
+import tsconfigPaths from 'vite-tsconfig-paths';
+
+export default defineConfig({
+	plugins: [tsconfigPaths()],
+	test: {
+		// ...
+	},
+});
+```
+
+## Coverage Configuration
+
+```typescript
+// vitest.config.ts
+export default defineConfig({
+	test: {
+		coverage: {
+			provider: 'v8',
+			reporter: ['text', 'json', 'html', 'lcov'],
+
+			// What to include
+			include: ['src/**/*.ts', '!src/**/*.d.ts', '!src/**/*.test.ts', '!src/index.ts'],
+
+			// Thresholds
+			thresholds: {
+				lines: 80,
+				functions: 80,
+				branches: 80,
+				statements: 80,
+			},
+
+			// Output directory
+			reportsDirectory: './coverage',
+		},
+	},
+});
+```
+
+## Environment Configuration
+
+```typescript
+// For DOM testing
+export default defineConfig({
+	test: {
+		environment: 'jsdom',
+		environmentOptions: {
+			jsdom: {
+				url: 'http://localhost:3000',
+			},
+		},
+	},
+});
+
+// For Node testing (default)
+export default defineConfig({
+	test: {
+		environment: 'node',
+	},
+});
+```
+
+## Mocking Configuration
+
+```typescript
+// vitest.config.ts
+export default defineConfig({
+	test: {
+		// Mock all modules in __mocks__ folder
+		mockReset: true,
+
+		// Auto-mock configuration
+		deps: {
+			inline: ['some-esm-package'],
+		},
+	},
+});
+```
+
+## Multiple Test Configurations
+
+```typescript
+// vitest.config.ts
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+	test: {
+		include: ['tests/unit/**/*.test.ts'],
+	},
+});
+
+// vitest.integration.config.ts
+import { defineConfig, mergeConfig } from 'vitest/config';
+import baseConfig from './vitest.config';
+
+export default mergeConfig(
+	baseConfig,
+	defineConfig({
+		test: {
+			include: ['tests/integration/**/*.test.ts'],
+			testTimeout: 30000,
+			hookTimeout: 30000,
+		},
+	})
+);
+```
+
+## Package.json Scripts
+
+```json
+{
+	"scripts": {
+		"test": "vitest run",
+		"test:watch": "vitest",
+		"test:coverage": "vitest run --coverage",
+		"test:ui": "vitest --ui",
+		"test:integration": "vitest run --config vitest.integration.config.ts"
+	}
+}
+```
+
+## TypeScript Configuration
+
+```json
+// tsconfig.json
+{
+	"compilerOptions": {
+		"types": ["vitest/globals"]
+	}
+}
+```
+
+```typescript
+// Or in vitest.config.ts
+export default defineConfig({
+	test: {
+		globals: true,
+		typecheck: {
+			include: ['tests/**/*.test.ts'],
+		},
+	},
+});
+```
+
+## Reporter Configuration
+
+```typescript
+export default defineConfig({
+	test: {
+		reporters: ['default', 'html', 'json'],
+		outputFile: {
+			html: './test-results/index.html',
+			json: './test-results/results.json',
+		},
+	},
+});
+```
+
+## Running Tests
+
+```bash
+# Run all tests
+bun run test
+
+# Run specific file
+bun run test tests/unit/utils/helper.test.ts
+
+# Run with pattern
+bun run test --grep "should validate"
+
+# Watch mode
+bun run test:watch
+
+# With coverage
+bun run test:coverage
+
+# UI mode
+bun run test:ui
+```
+
+## Critical Rules
+
+1. **PATH ALIASES** - Match tsconfig.json aliases
+2. **GLOBALS** - Enable for describe, it, expect
+3. **COVERAGE** - Set meaningful thresholds
+4. **SETUP FILES** - Common mocks and cleanup
+5. **ISOLATION** - Reset mocks between tests