name: test-runner
description: Execute and manage Rust tests including unit tests, integration tests, and doc tests. Use when running tests to ensure code quality and correctness.

Test Runner

Execute and manage Rust tests for the self-learning memory project.

Test Categories

Execution Strategy

Step 1: Quick Check (Unit Tests)

cargo test --lib

• Fast feedback (< 30s)
• Catch basic logic errors

Step 2: Integration Tests

cargo test --test '*'

• Tests database interactions
• Requires Turso/redb setup

Step 3: Full Suite

cargo test --all

• Complete validation before commit

Troubleshooting

Async/Await Issues

Symptom: Test hangs

#[tokio::test]
async fn test_async() {
    let result = async_fn().await;  // Don't forget .await
}

Database Connection

Symptom: Connection refused
- Check TURSO_URL, TURSO_TOKEN
- Use test database

Race Conditions

Symptom: Intermittent failures

cargo test -- --test-threads=1

redb Lock Errors

Symptom: "Database is locked"
- Use separate DB per test
- Close transactions promptly

Coverage

cargo install cargo-llvm-cov
cargo llvm-cov --html --output-dir coverage

Best Practices

• Isolation: Each test independent
• Cleanup: Remove test data
• Speed: < 1s per unit test
• Naming: Describe behavior