Diagnostics - Test Suite Runner
When the user requests "diagnostics" or uses Star Trek terminology like "run level 1 diagnostics", they want you to run the test suite.
Quick Reference
| Diagnostic Level | Command | Description |
|---|---|---|
| Level 1 (Full) | ./test_headless.sh |
Complete test suite (unit + integration) |
| Parser Check | godot --headless --check-only |
Syntax/type validation only |
| Unit Tests Only | godot --headless res://tests/test_runner_scene.tscn |
Unit tests without integration |
Primary Command
./test_headless.sh
This runs the comprehensive automated test suite including:
- Unit tests for all core systems
- Integration tests for battle flow, AI, cinematics
- Resource validation tests
Timeout
Tests should complete within 2-3 minutes. Use a timeout if needed:
timeout 180 ./test_headless.sh
Interpreting Results
- PASSED: All tests passed
- FAILED: Check output for specific test failures
- TIMEOUT: Tests hung - may indicate infinite loop or async issue
- CRASHED: Check for null references or scene loading errors
Common Issues
- Missing Godot binary: Ensure
godotis in PATH or setGODOT_BIN - Display errors: Tests run headless, no display server needed
- Import errors: Run
godot --headless --importfirst if resources changed
After Diagnostics
Report:
- Total tests run
- Pass/fail count
- Any specific failures with file:line references
- Recommended fixes if failures found
Converted and distributed by TomeVault — claim your Tome and manage your conversions.