watchdog

SpecSwarm Watchdog Daemon

Background bash process that polls the project's git + verify-queue state and pings Marty when something needs attention. Completes v7.4.0's verification loop by surviving session restarts — when a Claude session ends with pending verifications, the watchdog notices and surfaces them.

Per-project: each project has its own watchdog (state lives in .specswarm/watchdog.{pid,log,state}). Stop one before starting another in the same project.

Subcommand dispatch

PLUGIN_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
# shellcheck disable=SC1091
source "${PLUGIN_DIR}/lib/watchdog/state.sh"

# Parse args
SUBCOMMAND="status"
INTERVAL=30
WITH_VERIFY=false
TAIL_LINES=40

while [ $# -gt 0 ]; do
  case "$1" in
    --interval)    INTERVAL="$2";    shift 2 ;;
    --with-verify) WITH_VERIFY=true; shift ;;
    --tail)        TAIL_LINES="$2";  shift 2 ;;
    -h|--help)
      cat <<EOF
Usage: /ss:watchdog [SUBCOMMAND] [options]

Subcommands:
  start    Launch daemon in background (nohup + setsid)
  stop     Send SIGTERM to running daemon; clean up PID file
  status   Show PID, uptime, last check, queue state (default)
  logs     Tail the watchdog log file
  once     Run a single check cycle in the foreground (debugging)

Options:
  --interval N      Polling interval in seconds (default 30; min 5)
  --with-verify     EXPERIMENTAL — dispatch headless \`claude --print\` on
                    pending verifications. Burns tokens; off by default.
  --tail N          Lines to tail with the logs subcommand (default 40)

State lives at: .specswarm/watchdog.{pid,log,state}

Examples:
  /ss:watchdog start
  /ss:watchdog start --interval 60
  /ss:watchdog start --with-verify
  /ss:watchdog status
  /ss:watchdog logs --tail 100
  /ss:watchdog once   # foreground test
  /ss:watchdog stop
EOF
      exit 0
      ;;
    start|stop|status|logs|once)
      SUBCOMMAND="$1"
      shift
      ;;
    *)
      echo "❌ Unknown argument: $1 (try /ss:watchdog --help)" >&2
      exit 2
      ;;
  esac
done

# Enforce minimum interval
if [ "$INTERVAL" -lt 5 ]; then
  echo "❌ --interval must be ≥5 seconds (got $INTERVAL)" >&2
  exit 2
fi

PID_FILE=$(ss_watchdog_pid_file)
LOG_FILE=$(ss_watchdog_log_file)
STATE_FILE=$(ss_watchdog_state_file)
RUN_SCRIPT="${PLUGIN_DIR}/lib/watchdog/run.sh"
CHECK_SCRIPT="${PLUGIN_DIR}/lib/watchdog/check-cycle.sh"