# AGENT E3: SQLX Offline Mode - Quick Fix Guide

## ⚡ Quick Fix (< 1 minute)

Run these commands once all cargo builds complete:

```bash
# Navigate to workspace root
cd /home/jgrusewski/Work/foxhunt

# Check database is running
docker-compose ps | grep postgres
# Should show: foxhunt-postgres ... Up (healthy)

# Set DATABASE_URL
export DATABASE_URL="postgresql://foxhunt:foxhunt_dev_password@localhost:5432/foxhunt"

# Generate offline query metadata
cargo sqlx prepare --workspace

# Verify .sqlx/ directory is populated
ls -lh .sqlx/
# Should now see query-*.json files (not just . and ..)

# Test offline mode works
export SQLX_OFFLINE=true
cargo test -p common --test wave_d_regime_tracking_tests --no-run
```

## 🔍 Check if Fix is Needed

```bash
# Count files in workspace .sqlx/ directory
ls /home/jgrusewski/Work/foxhunt/.sqlx/ | wc -l

# If output is 2 (just . and ..), fix is needed
# If output is > 2, offline cache already exists
```

## 📊 Current Status (as of 2025-10-18 09:37)

**Problem**: Workspace `.sqlx/` directory exists but is **empty** (only `.` and `..`)

**Impact**: 10 Wave D tests cannot compile without `DATABASE_URL` set

**Blocking**: 14 cargo processes currently running, holding file lock

**Solution**: Run `cargo sqlx prepare --workspace` when builds finish

## ✅ Success Criteria

After running the fix:

```bash
# 1. .sqlx/ directory should have query files
ls .sqlx/ | grep -c "^query-"
# Should be > 0

# 2. Tests should compile with SQLX_OFFLINE=true
export SQLX_OFFLINE=true
cargo test -p common --test wave_d_regime_tracking_tests --no-run
# Should show: "Compiling" or "Finished"

# 3. No DATABASE_URL errors
cargo check -p common 2>&1 | grep -i "DATABASE_URL"
# Should have no output
```

## 🚨 If Builds Take Too Long

Monitor cargo processes:
```bash
# Count running cargo processes
watch -n 5 'ps aux | grep -E "cargo test|cargo bench|cargo check" | grep -v grep | wc -l'

# When count drops to 0 or stabilizes, run the fix
```

## 📁 Directory Structure (Expected After Fix)

```
/home/jgrusewski/Work/foxhunt/
├── .sqlx/                          # ✅ Will contain query-*.json files
│   ├── query-abc123...json
│   ├── query-def456...json
│   └── ...
├── common/
│   └── .sqlx/                      # ❌ Currently empty (may stay empty with workspace approach)
└── services/
    ├── trading_service/
    │   └── .sqlx/                  # ✅ Already has 17+ files
    └── ...
```

## 🔗 Related Files

- Full analysis: `AGENT_E3_SQLX_OFFLINE_FIX_REPORT.md`
- Tests affected:
  - `common/tests/wave_d_regime_tracking_tests.rs`
  - `services/trading_service/tests/wave_d_paper_trading_test.rs`
  - `services/backtesting_service/tests/wave_d_regime_backtest_test.rs`

---

**Last Updated**: 2025-10-18T09:37:00Z