ops: show broker connection in baudbot status

Author: benvinegar

README.md

@@ -68,7 +68,7 @@ sudo baudbot deploy
 # start the service
 sudo baudbot start
 
-# check health
+# check health (includes deployed version + broker connection status)
 sudo baudbot status
 sudo baudbot doctor
 ```

bin/baudbot

@@ -103,7 +103,7 @@ usage() {
   echo "  start          Start the agent (systemd, or --direct for foreground)"
   echo "  stop           Stop the agent"
   echo "  restart        Restart the agent"
-  echo "  status         Show agent status + deployed version"
+  echo "  status         Show agent status + deployed version + broker connection"
   echo "  logs           Tail agent logs"
   echo "  attach         Attach to control-agent by default; supports --pi/--tmux"
   echo "  sessions       List agent tmux and pi sessions (name → id)"
@@ -326,6 +326,76 @@ print_deployed_version() {
   echo -e "${BOLD}deployed version:${RESET} $line"
 }
 
+is_broker_configured() {
+  local agent_user="${1:-baudbot_agent}"
+  local env_file="/home/$agent_user/.config/.env"
+  local required_key=""
+  local line=""
+  local value=""
+
+  [ -r "$env_file" ] || return 1
+
+  for required_key in \
+    SLACK_BROKER_URL \
+    SLACK_BROKER_WORKSPACE_ID \
+    SLACK_BROKER_SERVER_PRIVATE_KEY \
+    SLACK_BROKER_SERVER_PUBLIC_KEY \
+    SLACK_BROKER_SERVER_SIGNING_PRIVATE_KEY \
+    SLACK_BROKER_PUBLIC_KEY \
+    SLACK_BROKER_SIGNING_PUBLIC_KEY; do
+    line="$(grep -E "^${required_key}=" "$env_file" | tail -1 || true)"
+    [ -n "$line" ] || return 1
+
+    value="${line#*=}"
+    value="${value//[[:space:]]/}"
+    [ -n "$value" ] || return 1
+    [ "$value" != "\"\"" ] || return 1
+    [ "$value" != "''" ] || return 1
+  done
+
+  return 0
+}
+
+print_broker_connection_status() {
+  local agent_user="${BAUDBOT_AGENT_USER:-baudbot_agent}"
+  local pane=""
+  local latest_signal=""
+
+  if ! is_broker_configured "$agent_user"; then
+    echo -e "${BOLD}broker connection:${RESET} not configured"
+    return 0
+  fi
+
+  if [ "$(id -u)" -eq 0 ]; then
+    if ! sudo -u "$agent_user" tmux has-session -t slack-bridge 2>/dev/null; then
+      echo -e "${BOLD}broker connection:${RESET} disconnected (bridge tmux session not running)"
+      return 0
+    fi
+    pane="$(sudo -u "$agent_user" tmux capture-pane -p -t slack-bridge -S -400 2>/dev/null || true)"
+  elif [ "$(id -un)" = "$agent_user" ]; then
+    if ! tmux has-session -t slack-bridge 2>/dev/null; then
+      echo -e "${BOLD}broker connection:${RESET} disconnected (bridge tmux session not running)"
+      return 0
+    fi
+    pane="$(tmux capture-pane -p -t slack-bridge -S -400 2>/dev/null || true)"
+  else
+    echo -e "${BOLD}broker connection:${RESET} configured (run with sudo for runtime status)"
+    return 0
+  fi
+
+  latest_signal="$(printf '%s\n' "$pane" | grep -E 'inbox poll failed|backing off|idle|pulled [0-9]+ message\(s\)|Slack broker pull bridge is running' | tail -1 || true)"
+
+  if printf '%s\n' "$latest_signal" | grep -Eq 'inbox poll failed|backing off'; then
+    echo -e "${BOLD}broker connection:${RESET} reconnecting (recent inbox poll failure)"
+  elif printf '%s\n' "$latest_signal" | grep -Eq 'idle|pulled [0-9]+ message\(s\)'; then
+    echo -e "${BOLD}broker connection:${RESET} connected"
+  elif printf '%s\n' "$latest_signal" | grep -q 'Slack broker pull bridge is running'; then
+    echo -e "${BOLD}broker connection:${RESET} starting"
+  else
+    echo -e "${BOLD}broker connection:${RESET} unknown (bridge running, no recent poll telemetry)"
+  fi
+}
+
 pi_control_dir() {
   local agent_user="${1:-baudbot_agent}"
   echo "/home/$agent_user/.pi/session-control"
@@ -473,6 +543,7 @@ case "${1:-}" in
       systemctl status baudbot "$@" || status_rc=$?
       echo ""
       print_deployed_version
+      print_broker_connection_status
       exit "$status_rc"
     else
       # Fallback: check if baudbot_agent has pi running
@@ -484,6 +555,7 @@ case "${1:-}" in
       fi
       echo ""
       print_deployed_version
+      print_broker_connection_status
     fi
     ;;
 

docs/operations.md

@@ -10,7 +10,7 @@ sudo baudbot start
 sudo baudbot stop
 sudo baudbot restart
 
-# Status and logs
+# Status and logs (status includes deployed version + broker connection state)
 sudo baudbot status
 sudo baudbot logs