foxhunt/AGENT_13.2.3_QUICK_REFERENCE.md

Agent 13.2.3: ML Predictions Command - Quick Reference

Status: ✅ COMPLETE | Date: 2025-10-16

---

Command Usage

# View ES.FUT predictions
tli trade ml predictions --symbol ES.FUT

# Filter by model
tli trade ml predictions --symbol ES.FUT --model MAMBA2

# Limit results
tli trade ml predictions --symbol ES.FUT --limit 5

---

Implementation Summary

File: /home/jgrusewski/Work/foxhunt/tli/src/commands/trade_ml.rs Lines: 331-455 (125 lines) Function: get_ml_predictions()

---

Key Features

✅ gRPC client connection to API Gateway ✅ GetMlPredictionsRequest proto handling ✅ JWT authentication via metadata ✅ Formatted table with color-coded output ✅ Empty state with user guidance ✅ Symbol filtering (required) ✅ Model filtering (optional) ✅ Limit parameter (optional, default: 10)

---

Output Format

ML Predictions for ES.FUT

─────────────────────────────────────────────────────────────────────────────────
Timestamp            Model      Symbol     Predicted Action Confidence   Outcome
─────────────────────────────────────────────────────────────────────────────────
2025-10-16 07:30:00  DQN        ES.FUT     BUY              87.2%        +0.5%
2025-10-16 07:25:00  MAMBA2     ES.FUT     HOLD             72.1%        N/A
─────────────────────────────────────────────────────────────────────────────────
Showing 2 predictions

---

Color Coding

Action:

• BUY → Green
• SELL → Red
• HOLD → Yellow

Confidence:

• ≥75% → Green
• ≥60% → Yellow
• <60% → Red

Outcome:

• Positive → Green
• Negative → Red
• N/A → White

---

gRPC Flow

TLI → API Gateway (GetMlPredictionsRequest) → Trading Service → PostgreSQL

Proto: GetMlPredictionsRequest

{
    symbol: String,
    model_filter: Option<String>,
    limit: Option<i32>
}

Proto: GetMlPredictionsResponse

{
    predictions: Vec<MLPrediction>
}

---

Test Coverage

✅ test_predictions_command_parses (Line 203-214)

• Verifies command parsing and execution
• Tests symbol, model, and limit parameters

---

Integration Points

Agent 8 (API Gateway): Proxy to Trading Service Agent 12 (Trading Service): Database query on ensemble_predictions table

---

Next Steps (Optional)

1. Integration testing with live services
2. Add time range filters (--start-time, --end-time)
3. Add CSV export (--export)
4. Add outcome statistics summary
5. Add real-time prediction streaming