pr-monitor-and-manage-wake

name	pr-monitor-and-manage-wake
description	Resume companion to /pr-monitor-and-manage. Wakes a paused PR-fleet-manager loop from its saved pause marker, tears down any auto-wake cron, and re-arms the main loop. Also serves as the lightweight --auto-check target for the hourly auto-wake cron. Triggers on "/pr-monitor-and-manage-wake", "/pmm-wake", "wake PR monitor".
triggers	["pr-monitor-and-manage-wake","pmm-wake","wake PR monitor","resume PR fleet"]
argument-hint	[--auto-check] (default: user-initiated resume; --auto-check = lightweight fleet scan from auto-wake cron)

Resume companion to /pr-monitor-and-manage. Wakes a paused PR-fleet-manager loop: reads the pause marker, deletes any auto-wake cron, clears the marker, and re-arms the main loop at base cadence.

Idempotent: running on a non-paused session is a clean no-op.

Post-merge symlink: after merge to main, symlink ~/.claude/skills/pr-monitor-and-manage-wake → ~/.claude/skills-worktree/.claude/skills/pr-monitor-and-manage-wake per skill-symlinks.md — never copy, never symlink to the root repo.

Resolve the state helper

Same three-candidate lookup as /babysit-pr-stop:

resolve_script() {
  local name="$1" candidate
  for candidate in \
    "$HOME/.claude/skills-worktree/.claude/scripts/$name" \
    "$HOME/.claude/scripts/$name" \
    ".claude/scripts/$name"; do
    if [[ -x "$candidate" ]]; then echo "$candidate"; return 0; fi
  done
  return 1
}
SESSION_STATE_SH=$(resolve_script session-state.sh) || { echo "ERROR: session-state.sh not found" >&2; exit 1; }

Step 1: Parse mode

• --auto-check — lightweight fleet scan (invoked by the hourly auto-wake CronCreate job). Compare gh pr list against .pmm.fleet_at_pause; re-launch main skill only if changed.
• No flags (default) — user-initiated resume: clear marker, delete cron, re-arm loop.

Step 2: Check pause marker

PAUSED_AT=$("$SESSION_STATE_SH" --get '.pmm.paused_at' 2>/dev/null || echo null)

• If $PAUSED_AT is null/empty → print "PMM not paused — either not started or already running." and exit 0 (idempotent no-op).
• If present → route by mode:
  • --auto-check → Step 4a (compare fleet; cron stays unless changed).
  • User-initiated (default) → Step 3 (delete cron) → Step 4b (resume).

Step 3: Delete auto-wake cron (fail-closed — user resume and auto-check-on-change only)

Do NOT run this step in --auto-check mode when the fleet is unchanged — the cron must keep firing hourly until a change is detected.

When $MODE is --auto-check, skip to Step 4a first; only call the cron-delete block below from Step 4b after a fleet change is confirmed, or when $MODE is user-initiated resume (default).

For user-initiated resume (default, no --auto-check), delete the cron before clearing the pause marker:

CRON_ID=$("$SESSION_STATE_SH" --get '.pmm.auto_wake_cron_id' 2>/dev/null || echo null)
if [[ -n "$CRON_ID" && "$CRON_ID" != "null" ]]; then
  CronDelete "$CRON_ID" || {
    echo "ERROR: CronDelete failed for $CRON_ID — NOT clearing pause marker; cron may still fire, retry /pr-monitor-and-manage-wake." >&2
    exit 1
  }
  JOBS=$("$SESSION_STATE_SH" --get '.polling_jobs' 2>/dev/null || echo '[]')
  if [[ "$JOBS" != "null" && -n "$JOBS" ]]; then
    NEW_JOBS=$(jq -c --arg id "$CRON_ID" 'map(select(.id != $id))' <<<"$JOBS")
  else
    NEW_JOBS='[]'
  fi
  "$SESSION_STATE_SH" --set ".polling_jobs=$NEW_JOBS" --set '.pmm.auto_wake_cron_id=null'
fi

Factor this block as pmm_delete_auto_wake_cron — Step 4b (auto-check detected change) and Step 0a in the main skill reuse the same fail-closed teardown. Only after successful CronDelete (or when no cron was registered) proceed to marker clear / re-arm.

Step 4a: --auto-check branch (lightweight scan)

Read saved config and fleet snapshot:

CONFIG=$("$SESSION_STATE_SH" --get '.pmm.config_at_pause' 2>/dev/null || echo '{}')
FLEET_AT_PAUSE=$("$SESSION_STATE_SH" --get '.pmm.fleet_at_pause' 2>/dev/null || echo '[]')
AUTHOR=$(jq -r '.author // empty' <<<"$CONFIG")
REPO=$(jq -r '.repo // empty' <<<"$CONFIG")
REPO_FLAG=()
[[ -n "$REPO" ]] && REPO_FLAG=(--repo "$REPO")

# Lightweight scan — gh pr list only, no full per-PR gate reads
CURRENT=$(gh pr list --state open --author "$AUTHOR" "${REPO_FLAG[@]}" \
  --json number,headRefOid,mergeStateStatus --limit 500)
CURRENT_FLEET=$(jq -c '[.[] | {pr: .number, head_sha: .headRefOid, state: .mergeStateStatus}] | sort_by(.pr)' <<<"$CURRENT")
SAVED_FLEET=$(jq -c 'sort_by(.pr)' <<<"$FLEET_AT_PAUSE")

• If $CURRENT_FLEET equals $SAVED_FLEET (count + per-PR state) → no-op. Print one line: [auto-check] Fleet unchanged — cron continues. Exit 0. Do not delete the cron or clear the pause marker.
• If changed → run pmm_delete_auto_wake_cron (Step 3), then proceed to Step 4b (full resume + re-launch main skill).

Step 4b: Resume (user wake or auto-check detected change)

Run pmm_delete_auto_wake_cron (Step 3) if not already done (user-initiated resume runs it before this step; auto-check runs it only after detecting a change).

Read config, reconstruct invocation flags, clear marker, reset idle streak, re-arm loop:

CONFIG=$("$SESSION_STATE_SH" --get '.pmm.config_at_pause' 2>/dev/null || echo '{}')
CADENCE=$(jq -r '.cadence // "5m"' <<<"$CONFIG")

# Rebuild PMM_FLAGS from saved config (must include every persisted field)
PMM_FLAGS=""
AUTHOR=$(jq -r '.author // empty' <<<"$CONFIG")
REPO=$(jq -r '.repo // empty' <<<"$CONFIG")
[ -n "$AUTHOR" ] && PMM_FLAGS="$PMM_FLAGS --author $AUTHOR"
[ -n "$REPO" ]    && PMM_FLAGS="$PMM_FLAGS --repo $REPO"
PMM_FLAGS="$PMM_FLAGS --cadence $(jq -r '.cadence // "5m"' <<<"$CONFIG")"
PMM_FLAGS="$PMM_FLAGS --max-parallel $(jq -r '.max_parallel // 3' <<<"$CONFIG")"
PMM_FLAGS="$PMM_FLAGS --idle-pause-after $(jq -r '.idle_pause_after // 3' <<<"$CONFIG")"
jq -e '.auto_wake == true' <<<"$CONFIG" >/dev/null 2>&1 && PMM_FLAGS="$PMM_FLAGS --auto-wake"
PMM_FLAGS="$PMM_FLAGS --auto-wake-cadence $(jq -r '.auto_wake_cadence // "60m"' <<<"$CONFIG")"
jq -e '.confirm_merges == true' <<<"$CONFIG" >/dev/null 2>&1 && PMM_FLAGS="$PMM_FLAGS --confirm-merges"

"$SESSION_STATE_SH" \
  --set '.pmm.paused_at=null' \
  --set '.pmm.fleet_at_pause=null' \
  --set '.pmm.config_at_pause=null' \
  --set '.pmm_idle_streak=0' \
  --set '.pmm_active=true' \
  --set '.pmm_next_expected_tick_at=null'

Re-arm at base cadence (not widened backoff):

/loop <CADENCE> /pr-monitor-and-manage <PMM_FLAGS>

The next tick runs full discovery + per-PR state read. Print:

PMM resumed — re-armed at <CADENCE>. Fleet will be rediscovered on the next tick.

For --auto-check with detected change, add: [auto-check] Fleet changed — cron deleted, main loop re-launched.

Safety

• Never clear the pause marker on resume unless the auto-wake cron is confirmed deleted (Step 3) — except --auto-check no-op exits without touching either.
• --auto-check must not run full per-PR gate reads — only gh pr list + comparison.
• Re-running /pr-monitor-and-manage-wake on a non-paused session is always a clean no-op (Step 2).