overnight

SpecSwarm Overnight Autonomous Execution

Marty's most ambitious automation. Pre-batch decisions before bed, schedule this command to run between 10pm-6am, wake to a green PR or a phone notification flagging exactly what needs attention.

This is the most invasive command in v7.x — it spawns a long-running headless Claude session that costs real tokens and lands real commits. Conservative defaults: --check mode validates readiness without executing. --exec is the explicit opt-in.

Architectural reality check: The /schedule plugin runs scheduled agents in Anthropic's remote infrastructure — they cannot touch a local filesystem. The right scheduler for "run /ss:implement on my local repo overnight" is the LOCAL OS scheduler: cron (Linux/macOS), systemd timer (Linux), launchd (macOS). /ss:overnight --schedule prints copy-paste snippets for all three.

Subcommand dispatch

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

# Parse args
SUBCOMMAND="check"
FEATURE_NUM=""
TIMEOUT=28800
ALLOW_DIRTY=false
TAIL_LINES=60

while [ $# -gt 0 ]; do
  case "$1" in
    --timeout)     TIMEOUT="$2";     shift 2 ;;
    --allow-dirty) ALLOW_DIRTY=true; shift ;;
    --tail)        TAIL_LINES="$2";  shift 2 ;;
    check|status|logs|exec|abort|schedule)
      SUBCOMMAND="$1"; shift ;;
    -h|--help)
      cat <<EOF
Usage: /ss:overnight [SUBCOMMAND] [FEATURE_NUM] [options]

Subcommands:
  check     (default) Validate readiness without executing
  status              Show last/current overnight run state
  logs                Tail .specswarm/overnight.log
  exec                EXEC: dispatch headless claude --print (costs tokens)
  abort               Send SIGTERM to a running overnight run
  schedule            Print cron/systemd/launchd snippets

Options:
  --timeout N       Wall-clock cap in seconds (default 28800 = 8h)
  --allow-dirty     Permit uncommitted working tree changes
  --tail N          Lines for logs subcommand (default 60)

State lives at: .specswarm/overnight.{pid,log,state}
Output log:     <feature_dir>/overnight.output.log

Examples:
  /ss:overnight                       # check readiness for current feature
  /ss:overnight check 003
  /ss:overnight schedule              # show cron/systemd/launchd snippets
  /ss:overnight exec --timeout 14400  # run NOW with 4h cap
  /ss:overnight status
  /ss:overnight logs --tail 200
  /ss:overnight abort
EOF
      exit 0
      ;;
    *)
      [ -z "$FEATURE_NUM" ] && FEATURE_NUM="$1"
      shift
      ;;
  esac
done

REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || pwd)

# Resolve feature unless we're in a mode that doesn't need it
case "$SUBCOMMAND" in
  status|logs|abort|schedule)
    : ;;
  *)
    if [ -z "$FEATURE_NUM" ]; then
      BRANCH=$(git rev-parse --abbrev-ref HEAD 2>/dev/null || echo "")
      FEATURE_NUM=$(echo "$BRANCH" | grep -oE '^[0-9]{3}' || echo "")
    fi
    if [ -z "$FEATURE_NUM" ]; then
      get_features_dir "$REPO_ROOT"
      FEATURE_NUM=$(find "$FEATURES_DIR" -maxdepth 1 -type d -name '[0-9][0-9][0-9]-*' 2>/dev/null \
        | sort | tail -1 | xargs -n1 basename 2>/dev/null \
        | grep -oE '^[0-9]{3}' || echo "")
    fi
    if [ -z "$FEATURE_NUM" ]; then
      echo "❌ No feature number provided and no feature dirs found." >&2
      exit 2
    fi
    if ! find_feature_dir "$FEATURE_NUM" "$REPO_ROOT"; then
      echo "❌ Feature $FEATURE_NUM not found." >&2
      exit 2
    fi
    ;;
esac