test-runner

name	test-runner
description	Run test suite and return structured pass/fail results. Supports scoped runs by directory, file, or test name pattern. Triggers on run tests, execute tests, test results, check tests, verify tests pass.

Test Runner

Run tests and return structured results.

Input

scope: string  # Optional: directory, file path, or test name pattern

Process

1. Detect framework from project files (if not provided):

   • spec/ + _spec.rb + .rspec = RSpec
   • test/ + _test.rb = Minitest
   • jest.config.js or *.test.js = Jest/Vitest
   • go.mod + _test.go = Go test
   • pytest.ini or conftest.py = pytest

2. Run tests (scoped if provided, otherwise full suite)

3. Parse output for pass/fail counts and failure details

Framework Commands

Framework	Run All	Run File	Run Single
RSpec	bundle exec rspec	bundle exec rspec path/to/spec.rb	bundle exec rspec path:LINE
Minitest	bundle exec rake test	ruby -Itest path/to/test.rb	ruby -Itest path -n test_name
Jest	npx jest	npx jest path/to/test.js	npx jest path -t "name"
pytest	pytest	pytest path/to/test.py	pytest path::test_name
Go	go test ./...	go test ./path/	go test ./path/ -run TestName

Output

status: PASS | FAIL
total: int
passed: int
failed: int
failures:        # Only if failed
  - file: string
    line: int
    name: string
    message: string

Error Handling

Scenario	Action
Test framework unclear	Ask user
Tests fail	Return FAIL with failure details
Command error	Return FAIL with stderr