| name | running-tests |
|---|---|
| description | Test runner checkpoint for conductor gates. Detects test framework (jest, pytest, cargo test, go test, etc.), runs tests, and captures output. Returns structured result with pass/fail status and failed test details. Use when: 'run tests', 'test runner', 'check tests pass'. |
| user-invocable | True |
Test Runner Checkpoint
Auto-detects test framework and runs tests, writing results to .checkpoints/test-runner.json.
Workflow
Progress:
- [ ] Step 1: Detect test framework
- [ ] Step 2: Run tests with timeout
- [ ] Step 3: Write checkpoint result
Step 1: Detect Test Framework
| Indicator | Command |
|---|---|
package.json with test script |
npm test -- --run (preferred), fallback npm test |
pytest.ini or conftest.py |
pytest --tb=short |
Cargo.toml |
cargo test |
go.mod |
go test ./... |
Makefile with test target |
make test |
Step 2: Run Tests
timeout 300 <test-command> 2>&1 | tee /tmp/test-output.txt
TEST_EXIT_CODE=${PIPESTATUS[0]}
Step 3: Write Checkpoint Result
mkdir -p .checkpoints
cat > .checkpoints/test-runner.json << 'EOF'
{
"checkpoint": "test-runner",
"timestamp": "...",
"passed": true,
"framework": "vitest",
"command": "npm test -- --run",
"exit_code": 0,
"stats": {"total": 17, "passed": 17, "failed": 0},
"failed_tests": [],
"summary": "All 17 tests passed"
}
EOF
Decision Criteria
Pass: Exit code 0, no test failures
Fail: Any test fails, tests error out, or timeout (300s default)
No tests found: Pass with "framework": "none"
JSON Output Flags (optional)
For complex parsing, use framework JSON output:
- Jest: npx jest --json --outputFile=/tmp/results.json
- Pytest: pytest --json-report (requires plugin)
- Go: go test -json ./...