chidekina/aria-superpowers/generate-tests

# name: generate-tests
 
# description: 
Auto-generate Jest/Vitest test files with intelligent coverage and mock detection.  
 
# tags:
Triggers on: generate tests, create tests, test this file, /test.  
 
**user-invocable:** true
 
---
 
# Generate Tests
 
Generate robust unit or integration tests for JavaScript and TypeScript projects using local LLM (Ollama or MCP tools). Automatically detects async functions, edge cases, and external dependencies.
 
---
 
# Usage
 

 
## Options
 
* `--framework jest|vitest` (default: auto-detect)
* `--integration` → generate integration tests
* `--unit` → generate unit tests (default)
* `--coverage <n>` → target minimum coverage %
* `--write` → auto-create test file
* `--watch` → run test after generation
* `--report` → return JSON metadata report
 
---
 
# Workflow
 
## 1️⃣ Read Source File
 

 
Extract:
 
* Exported functions/classes
* Async functions
* Thrown errors
* External dependencies (axios, fetch, fs, db, env, etc.)
 
---
 
## 2️⃣ Analyze Dependencies
 
If external dependencies are detected:
 
* Generate mocks
* Stub environment variables
* Mock repositories/services
 
---
 
## 3️⃣ Generate Test Structure
 
Rules:
 
* One `describe` block per export
* Cover:
 
  * Happy path
  * Invalid parameters
  * Edge cases
  * Exception paths
  * Async rejection cases
* No redundant tests
* Clean naming
 
---
 
## 4️⃣ Output Preview
 
Show generated test file:
 

 
Ask for confirmation if `--write` not passed.
 
---
 
## 5️⃣ Write File (if confirmed or --write)
 
Example:
 

 
Write generated content.
 
---
 
## 6️⃣ Run Tests (optional)
 
If `--watch`:
 

 
If coverage < target:
 
1. Re-analyze uncovered branches
2. Generate missing tests
3. Repeat cycle (max 3 iterations)
 
---
 
# Test File Naming Convention
 
| Source           | Output                          |
| ---------------- | ------------------------------- |
| userService.ts   | userService.test.ts             |
| auth.js          | auth.test.js                    |
| services/user.ts | services/**tests**/user.test.ts |
 
---
 
# Test Format
 
## Default (Jest/Vitest)
 

 
---
 
# Async Example
 
If async detected:
 

 
---
 
# Mock Strategy
 
Auto-mock when detecting:
 
* axios
* fetch
* fs
* database repositories
* crypto
* external services
 
## Example (Vitest)
 

 
## Example (Jest)
 

 
---
 
# Coverage Rules
 
If `--coverage 80`:
 
1. Run coverage
2. Parse output
3. Identify uncovered lines
4. Generate additional edge tests
5. Re-run (max 3 loops)
 
---
 
# Output Modes
 
## Default
 
Print generated test file.
 
## With `--write`
 
Create file automatically.
 
## With `--report`
 
Return JSON metadata:
 

 
---
 
# Tool Priority
 
1. `mcp__aria__generate_tests` (preferred)
2. `mcp__ollama__generate_tests`
3. Local Ollama direct prompt
4. Manual fallback template
 
---
 
# Integration with CLI
 
Equivalent AC CLI command:
 

 
Can also bind to lazygit custom command.
 
---
 
# Internal Prompt Template
 

 
---
 
# Intelligent Behaviors
 
* Detects if file already has tests → suggest improvements
* Detects trivial functions → generate minimal tests
* Detects pure functions → avoid unnecessary mocks
* Detects controller layer → suggest integration mode
 
---
 
# Notes
 
* Works fully offline with Ollama
* No API cost
* Avoids generating snapshot tests by default
* First describe block always matches filename
* Compatible with TypeScript strict mode