test

name	test
description	Test generation and execution with coverage analysis. Use when: "test", "write tests", "run tests", "coverage", "unit test", "test this", "add tests"
argument-hint	<file/feature|coverage|watch>
user-invocable	true
disable-model-invocation	true

/test - Test Generation and Execution

$ARGUMENTS

---

Purpose

This command generates tests, runs existing tests, or checks test coverage.

---

Sub-commands

/test                - Run all tests
/test [file/feature] - Generate tests for specific target
/test coverage       - Show test coverage report
/test watch          - Run tests in watch mode

---

Behavior

Generate Tests

When asked to test a file or feature:

1. Analyze the code

   • Identify functions and methods
   • Find edge cases
   • Detect dependencies to mock

2. Generate test cases

   • Happy path tests
   • Error cases
   • Edge cases
   • Integration tests (if needed)

3. Write tests

   • Use project's test framework (Jest, Vitest, etc.)
   • Follow existing test patterns
   • Mock external dependencies

---

Output Format

For Test Generation

## 🧪 Tests: [Target]

### Test Plan
| Test Case | Type | Coverage |
|-----------|------|----------|
| Should create user | Unit | Happy path |
| Should reject invalid email | Unit | Validation |
| Should handle db error | Unit | Error case |

### Generated Tests

`tests/[file].test.ts`

[Code block with tests]

---

Run with: `npm test`

For Test Execution

🧪 Running tests...

✅ auth.test.ts (5 passed)
✅ user.test.ts (8 passed)
❌ order.test.ts (2 passed, 1 failed)

Failed:
  ✗ should calculate total with discount
    Expected: 90
    Received: 100

Total: 15 tests (14 passed, 1 failed)

---

Examples

/test src/services/auth.service.ts
/test user registration flow
/test coverage
/test fix failed tests

---

Test Patterns

Unit Test Structure

describe('AuthService', () => {
  describe('login', () => {
    it('should return token for valid credentials', async () => {
      // Arrange
      const credentials = { email: '[e-mail]', password: 'pass123' };

      // Act
      const result = await authService.login(credentials);

      // Assert
      expect(result.token).toBeDefined();
    });

    it('should throw for invalid password', async () => {
      // Arrange
      const credentials = { email: '[e-mail]', password: 'wrong' };

      // Act & Assert
      await expect(authService.login(credentials)).rejects.toThrow('Invalid credentials');
    });
  });
});

---

Key Principles

• Test behavior not implementation
• One assertion per test (when practical)
• Descriptive test names
• Arrange-Act-Assert pattern
• Mock external dependencies