Force single-threaded for race conditions

cargo test test_name -- --test-threads=1


### Step 3: Diagnose Root Cause

| Pattern | Symptom | Fix |
|---------|---------|-----|
| Async/Await | "future cannot be sent" | Add `.await`, use Arc<Mutex> |
| Database | "connection refused" | Check env vars, use test DB |
| Race | Intermittent assertion failure | Add Mutex, sequential execution |
| Type | "expected X, found Y" | Update signatures, add conversions |
| Lifetime | "borrowed value" | Clone data, adjust lifetimes |

### Step 4: Verify Fix
```bash
# Run multiple times
for i in {1..10}; do cargo test test_name -- --exact || break; done

# Run full suite
cargo test --all

Step 5: Regression Prevention

Add test for the specific bug that was fixed.

Debugging Checklist

Tools

# Debug logging
RUST_LOG=debug cargo test

# Full backtrace
RUST_BACKTRACE=full cargo test

# Specific module
RUST_LOG=memory_core=debug cargo test

When to Skip vs Fix

Skip (temporarily):

External service down
Platform-specific issue
Known upstream bug

Fix immediately:

Logic error
Incorrect assertion
Missing error handling

test-fix

Test Fix

Process

Step 1: Identify Failing Tests

Step 2: Reproduce Locally