---

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)

Copycargo test --lib

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

Step 2: Integration Tests

Copycargo test --test '*'

• Tests database interactions
• Requires Turso/redb setup

Step 3: Full Suite

Copycargo test --all

• Complete validation before commit

Troubleshooting

Async/Await Issues

Symptom: Test hangs

Copy#[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

Copycargo test -- --test-threads=1

redb Lock Errors

Symptom: "Database is locked"

• Use separate DB per test
• Close transactions promptly

Coverage

Copycargo 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