Troubleshoot — Deep Bot Diagnosis

Systematic investigation when the bot is misbehaving. Follows a layered approach: connectivity first, then state, then signals, then logs.

Diagnostic sequence

Layer 1: Is the bot reachable?

# Can we reach the Pi?
ping -c 1 raspberrypi.local

# Is the container running?
ssh pi@raspberrypi.local "cd /home/pi/keltner-bot && docker compose ps"

# Basic health
curl -sk https://raspberrypi.local:8080/api/health | python3 -m json.tool