# Tests Directory

## Structure

### `ai-validation/`
Collection of AI scoring system validation tests created during development.

**Key Test Files:**
- `test-all-outputs.js` - Comprehensive test of all exercise types with both providers
- `test-variance-quick.js` - Quick variance test without cache interference
- `test-spanish-bug.js` - Specific test for translation bug that was fixed
- `test-strict-scoring.js` - Validation of strict scoring rules
- `test-final-validation.js` - Production readiness validation

**Debug Files:**
- `debug-*.js` - Various debugging utilities for AI system development
- `compare-instances.js` - Comparison between LLMValidator and direct IAEngine

**Historical Tests:**
- Tests documenting the development process and bug fixes
- Comprehensive validation achieving 100% success rate

## Running Tests

From project root:
```bash
# Run comprehensive validation
node tests/ai-validation/test-all-outputs.js

# Quick variance test
node tests/ai-validation/test-variance-quick.js

# Test specific scenarios
node tests/ai-validation/test-strict-scoring.js
```

## Notes

- All tests require proper API keys in `.env` file
- Cache is currently disabled for accurate testing
- Tests validate real AI responses (no mock/fallback)
- Achieved 100% validation success rate in December 2024