tradebot-ops

Purpose

Operate and monitor the trading bot safely: detect stalls, verify LIVE/halting state, validate data freshness, restart cleanly, and produce human-readable health summaries.

Use when

• Bot shows LIVE but no updates (stale heartbeat/bars)
• Chart frozen / signals file not updating
• Need to answer: “Is it running? Is it safe? Why no trades?”

Inputs

• dist/out/live_heartbeat_*.json
• dist/out/live_signals_*.csv
• dist/out/live_trades_*.csv (if present)
• UI endpoints: /api/trading/*

Outputs

• One-paragraph health summary
• If unhealthy: one action (restart/clear stale) + verification
• Audit log entry

Safety rails

• Never raise risk_pct automatically.
• Prefer restart/self-heal over loosening risk.

Checklist

1) Confirm UI server reachable /api/status.

2) Read heartbeat: mode/status/halted/in_position/last_bar_ts.

3) Freshness: _hb_age_s, _bar_age_s.

4) Confirm signals file mtime is recent.

5) If stale: stop bot PID (runtime or heartbeat pid) → apply+restart.

6) Re-check last_bar_ts advances.