test

name	test
description	Run the test suite with coverage report. Use when tests need to be executed or verified.
user-invocable	true
argument-hint	[test_file_or_pattern]
allowed-tools	["Bash","Read","Grep"]

Run Tests

Run the project test suite using pytest.

Steps

1. Activate the venv before running any commands:

source venv/Scripts/activate

2. Run tests with coverage:

python -m pytest tests/ -v --tb=short --cov=. --cov-report=term-missing

3. If an argument is provided (e.g., test_document_processing), run only that test file:

python -m pytest tests/test_<argument>.py -v --tb=short

4. Report results to the user:
   • Number of tests passed/failed/skipped
   • Coverage percentage for key modules
   • If failures: show the failing test name and assertion error

If Tests Fail

• Read the failing test to understand what's expected
• Read the source module being tested
• Identify the root cause and suggest a fix
• Do NOT modify tests to make them pass unless the test itself is wrong