agent-control-plane 0.1.0

package/tools/tests/test-heartbeat-safe-auto-stale-shared-loop-pid-does-not-skip.sh

@@ -0,0 +1,140 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+FLOW_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+SOURCE_SCRIPT="${FLOW_ROOT}/tools/bin/heartbeat-safe-auto.sh"
+FLOW_CONFIG_LIB="${FLOW_ROOT}/tools/bin/flow-config-lib.sh"
+FLOW_LIB="${FLOW_ROOT}/tools/bin/flow-shell-lib.sh"
+
+tmpdir="$(mktemp -d)"
+stale_pid=""
+cleanup() {
+  if [[ -n "${stale_pid}" ]]; then
+    kill "${stale_pid}" >/dev/null 2>&1 || true
+    wait "${stale_pid}" >/dev/null 2>&1 || true
+  fi
+  rm -rf "$tmpdir"
+}
+trap cleanup EXIT
+
+shared_home="$tmpdir/shared-home"
+flow_root="$shared_home/skills/openclaw/agent-control-plane"
+bin_dir="$tmpdir/bin"
+agent_root="$tmpdir/project"
+memory_dir="$tmpdir/memory"
+log_file="$tmpdir/heartbeat.log"
+profile_home="$tmpdir/profiles"
+
+mkdir -p \
+  "$flow_root/tools/bin" \
+  "$flow_root/hooks" \
+  "$shared_home/skills/openclaw/codex-quota-manager/scripts" \
+  "$bin_dir" \
+  "$agent_root/runs" \
+  "$agent_root/state/heartbeat-loop.lock" \
+  "$memory_dir" \
+  "$profile_home"
+
+cp "$SOURCE_SCRIPT" "$flow_root/tools/bin/heartbeat-safe-auto.sh"
+cp "$FLOW_CONFIG_LIB" "$flow_root/tools/bin/flow-config-lib.sh"
+cp "$FLOW_LIB" "$flow_root/tools/bin/flow-shell-lib.sh"
+
+cat >"$flow_root/tools/bin/audit-retained-worktrees.sh" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+printf 'LEGACY_RETAINED_WORKTREE_COUNT=0\n'
+printf 'LEGACY_RETAINED_WORKTREE_CLEANED=0\n'
+EOF
+
+cat >"$flow_root/tools/bin/audit-agent-worktrees.sh" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+printf 'LEGACY_AGENT_WORKTREE_COUNT=0\n'
+printf 'LEGACY_AGENT_WORKTREE_CLEANED=0\n'
+EOF
+
+cat >"$flow_root/tools/bin/agent-project-heartbeat-loop" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+printf 'heartbeat-loop-ran\n'
+EOF
+
+cat >"$flow_root/tools/bin/agent-project-catch-up-merged-prs" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+printf 'catchup-ran\n'
+EOF
+
+cat >"$flow_root/hooks/heartbeat-hooks.sh" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+EOF
+
+cat >"$shared_home/skills/openclaw/codex-quota-manager/scripts/auto-switch.sh" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+printf 'quota-switch-should-not-run\n'
+EOF
+
+cat >"$bin_dir/tmux" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+if [[ "${1:-}" == "list-sessions" ]]; then
+  exit 1
+fi
+if [[ "${1:-}" == "has-session" ]]; then
+  exit 1
+fi
+exit 0
+EOF
+
+cat >"$bin_dir/ps" <<EOF
+#!/usr/bin/env bash
+set -euo pipefail
+if [[ "\${1:-}" == "-p" && "\${3:-}" == "-o" && "\${4:-}" == "command=" ]]; then
+  printf 'sleep 60\n'
+  exit 0
+fi
+if [[ "\${1:-}" == "-p" && "\${3:-}" == "-o" && "\${4:-}" == "ppid=" ]]; then
+  printf '2\n'
+  exit 0
+fi
+exit 0
+EOF
+
+chmod +x \
+  "$flow_root/tools/bin/flow-shell-lib.sh" \
+  "$flow_root/tools/bin/flow-config-lib.sh" \
+  "$flow_root/tools/bin/heartbeat-safe-auto.sh" \
+  "$flow_root/tools/bin/audit-retained-worktrees.sh" \
+  "$flow_root/tools/bin/audit-agent-worktrees.sh" \
+  "$flow_root/tools/bin/agent-project-heartbeat-loop" \
+  "$flow_root/tools/bin/agent-project-catch-up-merged-prs" \
+  "$flow_root/hooks/heartbeat-hooks.sh" \
+  "$shared_home/skills/openclaw/codex-quota-manager/scripts/auto-switch.sh" \
+  "$bin_dir/tmux" \
+  "$bin_dir/ps"
+
+sleep 60 >/dev/null 2>&1 &
+stale_pid="$!"
+printf '%s\n' "$stale_pid" >"$agent_root/state/shared-heartbeat-loop.pid"
+
+PATH="$bin_dir:/opt/homebrew/bin:/usr/bin:/bin:/usr/sbin:/sbin" \
+SHARED_AGENT_HOME="$shared_home" \
+ACP_PROFILE_REGISTRY_ROOT="$profile_home" \
+F_LOSNING_AGENT_ROOT="$agent_root" \
+F_LOSNING_RUNS_ROOT="$agent_root/runs" \
+F_LOSNING_STATE_ROOT="$agent_root/state" \
+F_LOSNING_MEMORY_DIR="$memory_dir" \
+F_LOSNING_HEARTBEAT_LOOP_TIMEOUT_SECONDS=10 \
+F_LOSNING_CATCHUP_TIMEOUT_SECONDS=10 \
+bash "$flow_root/tools/bin/heartbeat-safe-auto.sh" >"$log_file"
+
+if grep -q '^HEARTBEAT_SKIPPED=shared-loop-active$' "$log_file"; then
+  echo "stale shared loop pid unexpectedly blocked heartbeat" >&2
+  exit 1
+fi
+grep -q 'heartbeat-loop-ran' "$log_file"
+test ! -f "$agent_root/state/shared-heartbeat-loop.pid"
+
+echo "heartbeat-safe-auto stale shared loop pid test passed"

package/tools/tests/test-heartbeat-safe-auto-static-capacity-without-quota-cache.sh

@@ -0,0 +1,142 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+FLOW_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+SOURCE_SCRIPT="${FLOW_ROOT}/tools/bin/heartbeat-safe-auto.sh"
+FLOW_CONFIG_LIB="${FLOW_ROOT}/tools/bin/flow-config-lib.sh"
+FLOW_LIB="${FLOW_ROOT}/tools/bin/flow-shell-lib.sh"
+
+tmpdir="$(mktemp -d)"
+trap 'rm -rf "$tmpdir"' EXIT
+
+shared_home="$tmpdir/shared-home"
+flow_root="$shared_home/skills/openclaw/agent-control-plane"
+bin_dir="$tmpdir/bin"
+agent_root="$tmpdir/project"
+memory_dir="$tmpdir/memory"
+log_file="$tmpdir/heartbeat.log"
+profile_home="$tmpdir/profiles"
+cache_home="$tmpdir/cache-home"
+
+mkdir -p \
+  "$flow_root/tools/bin" \
+  "$flow_root/hooks" \
+  "$shared_home/skills/openclaw/codex-quota-manager/scripts" \
+  "$bin_dir" \
+  "$agent_root/runs" \
+  "$agent_root/state" \
+  "$memory_dir" \
+  "$profile_home" \
+  "$cache_home"
+
+cp "$SOURCE_SCRIPT" "$flow_root/tools/bin/heartbeat-safe-auto.sh"
+cp "$FLOW_CONFIG_LIB" "$flow_root/tools/bin/flow-config-lib.sh"
+cp "$FLOW_LIB" "$flow_root/tools/bin/flow-shell-lib.sh"
+
+cat >"$flow_root/tools/bin/audit-retained-worktrees.sh" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+printf 'LEGACY_RETAINED_WORKTREE_COUNT=0\n'
+printf 'LEGACY_RETAINED_WORKTREE_CLEANED=0\n'
+EOF
+
+cat >"$flow_root/tools/bin/audit-agent-worktrees.sh" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+printf 'LEGACY_AGENT_WORKTREE_COUNT=0\n'
+printf 'LEGACY_AGENT_WORKTREE_CLEANED=0\n'
+EOF
+
+cat >"$flow_root/tools/bin/agent-project-heartbeat-loop" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+printf 'heartbeat-loop-args=%s\n' "$*"
+EOF
+
+cat >"$flow_root/tools/bin/agent-project-catch-up-merged-prs" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+printf 'catchup-ran\n'
+EOF
+
+cat >"$flow_root/hooks/heartbeat-hooks.sh" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+EOF
+
+cat >"$shared_home/skills/openclaw/codex-quota-manager/scripts/auto-switch.sh" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+printf 'quota-switch-should-not-run\n'
+EOF
+
+cat >"$bin_dir/tmux" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+if [[ "${1:-}" == "list-sessions" ]]; then
+  exit 1
+fi
+if [[ "${1:-}" == "has-session" ]]; then
+  exit 1
+fi
+exit 0
+EOF
+
+cat >"$bin_dir/ps" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+exit 0
+EOF
+
+cat >"$bin_dir/codex-quota" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+printf 'codex-quota-should-not-run\n'
+exit 1
+EOF
+
+chmod +x \
+  "$flow_root/tools/bin/flow-shell-lib.sh" \
+  "$flow_root/tools/bin/flow-config-lib.sh" \
+  "$flow_root/tools/bin/heartbeat-safe-auto.sh" \
+  "$flow_root/tools/bin/audit-retained-worktrees.sh" \
+  "$flow_root/tools/bin/audit-agent-worktrees.sh" \
+  "$flow_root/tools/bin/agent-project-heartbeat-loop" \
+  "$flow_root/tools/bin/agent-project-catch-up-merged-prs" \
+  "$flow_root/hooks/heartbeat-hooks.sh" \
+  "$shared_home/skills/openclaw/codex-quota-manager/scripts/auto-switch.sh" \
+  "$bin_dir/tmux" \
+  "$bin_dir/ps" \
+  "$bin_dir/codex-quota"
+
+PATH="$bin_dir:/opt/homebrew/bin:/usr/bin:/bin:/usr/sbin:/sbin" \
+SHARED_AGENT_HOME="$shared_home" \
+ACP_PROFILE_REGISTRY_ROOT="$profile_home" \
+XDG_CACHE_HOME="$cache_home" \
+F_LOSNING_AGENT_ROOT="$agent_root" \
+F_LOSNING_RUNS_ROOT="$agent_root/runs" \
+F_LOSNING_STATE_ROOT="$agent_root/state" \
+F_LOSNING_MEMORY_DIR="$memory_dir" \
+F_LOSNING_MAX_CONCURRENT_WORKERS=9 \
+F_LOSNING_MAX_CONCURRENT_PR_WORKERS=4 \
+F_LOSNING_MAX_RECURRING_ISSUE_WORKERS=3 \
+F_LOSNING_HEARTBEAT_LOOP_TIMEOUT_SECONDS=10 \
+F_LOSNING_CATCHUP_TIMEOUT_SECONDS=10 \
+bash "$flow_root/tools/bin/heartbeat-safe-auto.sh" >"$log_file"
+
+grep -q '^DYNAMIC_CONCURRENCY_QUOTA_MODE=failure-driven-static$' "$log_file"
+grep -q '^EFFECTIVE_MAX_CONCURRENT_WORKERS=9$' "$log_file"
+grep -q '^EFFECTIVE_MAX_CONCURRENT_PR_WORKERS=4$' "$log_file"
+grep -q '^EFFECTIVE_MAX_RECURRING_ISSUE_WORKERS=3$' "$log_file"
+grep -q -- '--max-concurrent-workers 9' "$log_file"
+grep -q -- '--max-concurrent-pr-workers 4' "$log_file"
+if grep -q 'quota-switch-should-not-run' "$log_file"; then
+  echo "quota switch script unexpectedly executed" >&2
+  exit 1
+fi
+if grep -q 'codex-quota-should-not-run' "$log_file"; then
+  echo "codex-quota unexpectedly executed" >&2
+  exit 1
+fi
+
+echo "heartbeat-safe-auto static capacity without quota cache test passed"

package/tools/tests/test-heartbeat-safe-auto-zero-healthy-pools.sh

@@ -0,0 +1,141 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+FLOW_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+SOURCE_SCRIPT="${FLOW_ROOT}/tools/bin/heartbeat-safe-auto.sh"
+FLOW_CONFIG_LIB="${FLOW_ROOT}/tools/bin/flow-config-lib.sh"
+FLOW_LIB="${FLOW_ROOT}/tools/bin/flow-shell-lib.sh"
+
+tmpdir="$(mktemp -d)"
+trap 'rm -rf "$tmpdir"' EXIT
+
+shared_home="$tmpdir/shared-home"
+flow_root="$shared_home/skills/openclaw/agent-control-plane"
+bin_dir="$tmpdir/bin"
+agent_root="$tmpdir/project"
+memory_dir="$tmpdir/memory"
+cache_dir="$tmpdir/cache"
+log_file="$tmpdir/heartbeat.log"
+quota_cache="$cache_dir/codex-full-quota.json"
+profile_home="$tmpdir/profiles"
+
+mkdir -p \
+  "$flow_root/tools/bin" \
+  "$flow_root/hooks" \
+  "$shared_home/skills/openclaw/codex-quota-manager/scripts" \
+  "$bin_dir" \
+  "$agent_root/runs" \
+  "$agent_root/state" \
+  "$memory_dir" \
+  "$cache_dir" \
+  "$profile_home"
+
+cp "$SOURCE_SCRIPT" "$flow_root/tools/bin/heartbeat-safe-auto.sh"
+cp "$FLOW_CONFIG_LIB" "$flow_root/tools/bin/flow-config-lib.sh"
+cp "$FLOW_LIB" "$flow_root/tools/bin/flow-shell-lib.sh"
+
+cat >"$quota_cache" <<'EOF'
+[
+  {
+    "accountId": "acct-1",
+    "planType": "plus",
+    "usage": {
+      "rate_limit": {
+        "limit_reached": true,
+        "primary_window": { "used_percent": 100 },
+        "secondary_window": { "used_percent": 100 }
+      }
+    }
+  }
+]
+EOF
+
+cat >"$flow_root/tools/bin/audit-retained-worktrees.sh" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+printf 'LEGACY_RETAINED_WORKTREE_COUNT=0\n'
+printf 'LEGACY_RETAINED_WORKTREE_CLEANED=0\n'
+EOF
+
+cat >"$flow_root/tools/bin/audit-agent-worktrees.sh" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+printf 'LEGACY_AGENT_WORKTREE_COUNT=0\n'
+printf 'LEGACY_AGENT_WORKTREE_CLEANED=0\n'
+EOF
+
+cat >"$flow_root/tools/bin/agent-project-heartbeat-loop" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+printf 'heartbeat-loop-args=%s\n' "$*"
+EOF
+
+cat >"$flow_root/tools/bin/agent-project-catch-up-merged-prs" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+printf 'catchup-ran\n'
+EOF
+
+cat >"$flow_root/hooks/heartbeat-hooks.sh" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+EOF
+
+cat >"$shared_home/skills/openclaw/codex-quota-manager/scripts/auto-switch.sh" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+printf 'quota-switch-check-ok\n'
+EOF
+
+cat >"$bin_dir/tmux" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+if [[ "${1:-}" == "list-sessions" ]]; then
+  exit 1
+fi
+if [[ "${1:-}" == "has-session" ]]; then
+  exit 1
+fi
+exit 0
+EOF
+
+cat >"$bin_dir/codex-quota" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+exit 0
+EOF
+
+chmod +x \
+  "$flow_root/tools/bin/flow-shell-lib.sh" \
+  "$flow_root/tools/bin/flow-config-lib.sh" \
+  "$flow_root/tools/bin/heartbeat-safe-auto.sh" \
+  "$flow_root/tools/bin/audit-retained-worktrees.sh" \
+  "$flow_root/tools/bin/audit-agent-worktrees.sh" \
+  "$flow_root/tools/bin/agent-project-heartbeat-loop" \
+  "$flow_root/tools/bin/agent-project-catch-up-merged-prs" \
+  "$flow_root/hooks/heartbeat-hooks.sh" \
+  "$shared_home/skills/openclaw/codex-quota-manager/scripts/auto-switch.sh" \
+  "$bin_dir/tmux" \
+  "$bin_dir/codex-quota"
+
+PATH="$bin_dir:/opt/homebrew/bin:/usr/bin:/bin:/usr/sbin:/sbin" \
+SHARED_AGENT_HOME="$shared_home" \
+ACP_PROFILE_REGISTRY_ROOT="$profile_home" \
+F_LOSNING_AGENT_ROOT="$agent_root" \
+F_LOSNING_RUNS_ROOT="$agent_root/runs" \
+F_LOSNING_STATE_ROOT="$agent_root/state" \
+F_LOSNING_MEMORY_DIR="$memory_dir" \
+F_LOSNING_HEARTBEAT_LOOP_TIMEOUT_SECONDS=10 \
+F_LOSNING_CATCHUP_TIMEOUT_SECONDS=10 \
+CODEX_QUOTA_MANAGER_FULL_CACHE_FILE="$quota_cache" \
+bash "$flow_root/tools/bin/heartbeat-safe-auto.sh" >"$log_file"
+
+grep -q 'HEALTHY_QUOTA_POOLS=0' "$log_file"
+grep -q 'EFFECTIVE_QUOTA_POOLS=0' "$log_file"
+grep -q 'EFFECTIVE_MAX_CONCURRENT_WORKERS=0' "$log_file"
+grep -q 'EFFECTIVE_MAX_CONCURRENT_PR_WORKERS=0' "$log_file"
+grep -q 'EFFECTIVE_MAX_RECURRING_ISSUE_WORKERS=0' "$log_file"
+grep -q -- '--max-concurrent-workers 0' "$log_file"
+grep -q -- '--max-concurrent-pr-workers 0' "$log_file"
+
+echo "heartbeat-safe-auto zero healthy pools test passed"

package/tools/tests/test-heartbeat-sync-issue-labels-empty-schedule.sh

@@ -0,0 +1,65 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+FLOW_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+HOOKS_FILE="${FLOW_ROOT}/hooks/heartbeat-hooks.sh"
+
+tmpdir="$(mktemp -d)"
+trap 'rm -rf "$tmpdir"' EXIT
+
+node_bin_dir="$(dirname "$(command -v node)")"
+bin_dir="$tmpdir/bin"
+tools_dir="$tmpdir/tools/bin"
+labels_log="$tmpdir/labels.log"
+
+mkdir -p "$bin_dir" "$tools_dir"
+
+cat >"$bin_dir/gh" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+
+if [[ "${1:-}" == "issue" && "${2:-}" == "view" ]]; then
+  cat <<'JSON'
+{"body":"No recurring schedule here.","labels":[{"name":"agent-running"},{"name":"agent-schedule-10m"}]}
+JSON
+  exit 0
+fi
+
+if [[ "${1:-}" == "label" && "${2:-}" == "create" ]]; then
+  exit 0
+fi
+
+echo "unexpected gh args: $*" >&2
+exit 1
+EOF
+
+cat >"$tools_dir/agent-github-update-labels" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+printf '%s\n' "$*" >"${TEST_LABELS_LOG:?}"
+EOF
+
+chmod +x "$bin_dir/gh" "$tools_dir/agent-github-update-labels"
+
+export PATH="$bin_dir:$node_bin_dir:/opt/homebrew/bin:/usr/bin:/bin:/usr/sbin:/sbin"
+export TEST_LABELS_LOG="$labels_log"
+export F_LOSNING_REPO_SLUG="example/repo"
+
+# shellcheck source=/dev/null
+source "$HOOKS_FILE"
+FLOW_TOOLS_DIR="$tools_dir"
+REPO_SLUG="example/repo"
+
+heartbeat_sync_issue_labels 123
+
+grep -q -- '--repo-slug example/repo --number 123' "$labels_log"
+grep -q -- '--remove agent-schedule-10m' "$labels_log"
+grep -q -- '--remove agent-running' "$labels_log"
+grep -q -- '--remove agent-blocked' "$labels_log"
+grep -q -- '--remove agent-scheduled' "$labels_log"
+if grep -q -- '--add agent-scheduled' "$labels_log"; then
+  echo "unexpected scheduled add args in label update command" >&2
+  exit 1
+fi
+
+echo "heartbeat sync issue labels empty-schedule test passed"

package/tools/tests/test-heartbeat-sync-open-agent-prs-terminal-clears-running.sh

@@ -0,0 +1,179 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+FLOW_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+SOURCE_SCRIPT="${FLOW_ROOT}/tools/bin/agent-project-heartbeat-loop"
+
+tmpdir="$(mktemp -d)"
+trap 'rm -rf "$tmpdir"' EXIT
+
+shared_home="$tmpdir/shared-home"
+hook_file="$tmpdir/heartbeat-hooks.sh"
+bin_dir="$tmpdir/bin"
+runs_root="$tmpdir/runs"
+state_root="$tmpdir/state"
+memory_dir="$tmpdir/memory"
+events_log="$tmpdir/events.log"
+
+mkdir -p \
+  "$shared_home/tools/bin" \
+  "$bin_dir" \
+  "$runs_root" \
+  "$state_root" \
+  "$memory_dir"
+
+cat >"$hook_file" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+
+heartbeat_list_ready_issue_ids() { :; }
+heartbeat_list_blocked_recovery_issue_ids() { :; }
+heartbeat_list_open_agent_pr_ids() { printf '101\n102\n103\n104\n'; }
+heartbeat_list_running_issue_ids() { :; }
+heartbeat_list_exclusive_issue_ids() { :; }
+heartbeat_list_exclusive_pr_ids() { :; }
+
+heartbeat_issue_is_heavy() { printf 'no\n'; }
+heartbeat_issue_is_recurring() { printf 'no\n'; }
+heartbeat_issue_schedule_interval_seconds() { printf '0\n'; }
+heartbeat_issue_is_scheduled() { printf 'no\n'; }
+heartbeat_issue_is_exclusive() { printf 'no\n'; }
+heartbeat_pr_is_exclusive() { printf 'no\n'; }
+heartbeat_pr_risk_json() { printf '{"agentLane":"ignore"}\n'; }
+heartbeat_sync_issue_labels() { :; }
+
+heartbeat_mark_issue_running() { :; }
+heartbeat_issue_launch_failed() { :; }
+heartbeat_mark_pr_running() { :; }
+heartbeat_clear_pr_running() {
+  local pr_number="${1:?pr number required}"
+  printf 'CLEAR:%s\n' "$pr_number" >>"${TEST_EVENTS_LOG:?}"
+}
+heartbeat_sync_pr_labels() {
+  local pr_number="${1:?pr number required}"
+  printf 'SYNC:%s\n' "$pr_number" >>"${TEST_EVENTS_LOG:?}"
+}
+
+heartbeat_start_issue_worker() { :; }
+heartbeat_start_pr_review_worker() { :; }
+heartbeat_start_pr_merge_repair_worker() { :; }
+heartbeat_start_pr_fix_worker() { :; }
+heartbeat_start_pr_ci_refresh() { :; }
+heartbeat_reconcile_issue() { :; }
+heartbeat_reconcile_pr() { :; }
+EOF
+
+cat >"$shared_home/tools/bin/agent-project-retry-state" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+cat <<OUT
+READY=no
+LAST_REASON=
+OUT
+EOF
+
+cat >"$shared_home/tools/bin/agent-project-worker-status" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+session=""
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --session) session="${2:-}"; shift 2 ;;
+    --runs-root) shift 2 ;;
+    *) shift ;;
+  esac
+done
+
+printf 'SESSION=%s\n' "$session"
+case "$session" in
+  fl-pr-101)
+    printf 'STATUS=SUCCEEDED\n'
+    ;;
+  fl-pr-102)
+    printf 'STATUS=FAILED\n'
+    ;;
+  fl-pr-103)
+    printf 'STATUS=RUNNING\n'
+    ;;
+  fl-pr-104)
+    printf 'STATUS=UNKNOWN\n'
+    ;;
+  *)
+    printf 'STATUS=UNKNOWN\n'
+    ;;
+esac
+EOF
+
+cat >"$shared_home/tools/bin/agent-project-cleanup-session" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+exit 0
+EOF
+
+cat >"$bin_dir/tmux" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+
+if [[ "${1:-}" == "list-sessions" ]]; then
+  printf 'fl-pr-103\n'
+  exit 0
+fi
+
+if [[ "${1:-}" == "has-session" ]]; then
+  if [[ "${2:-}" == "-t" && "${3:-}" == "fl-pr-103" ]]; then
+    exit 0
+  fi
+  exit 1
+fi
+
+exit 0
+EOF
+
+chmod +x \
+  "$hook_file" \
+  "$shared_home/tools/bin/agent-project-retry-state" \
+  "$shared_home/tools/bin/agent-project-worker-status" \
+  "$shared_home/tools/bin/agent-project-cleanup-session" \
+  "$bin_dir/tmux"
+
+export PATH="$bin_dir:/opt/homebrew/bin:/usr/bin:/bin:/usr/sbin:/sbin"
+export TEST_EVENTS_LOG="$events_log"
+
+SHARED_AGENT_HOME="$shared_home" \
+bash "$SOURCE_SCRIPT" \
+  --repo-slug "example/repo" \
+  --runs-root "$runs_root" \
+  --state-root "$state_root" \
+  --memory-dir "$memory_dir" \
+  --issue-prefix "fl-issue-" \
+  --pr-prefix "fl-pr-" \
+  --hook-file "$hook_file" \
+  --max-concurrent-workers 0 \
+  --max-concurrent-heavy-workers 0 \
+  --max-concurrent-pr-workers 0 \
+  --max-recurring-issue-workers 0 \
+  --max-concurrent-scheduled-issue-workers 0 \
+  --max-concurrent-scheduled-heavy-workers 0 \
+  --max-concurrent-blocked-recovery-issue-workers 0 \
+  --blocked-recovery-cooldown-seconds 900 \
+  --max-open-agent-prs-for-recurring 0 \
+  --max-launches-per-pass 0 \
+  >/dev/null
+
+grep -q '^CLEAR:101$' "$events_log"
+grep -q '^CLEAR:102$' "$events_log"
+grep -q '^CLEAR:104$' "$events_log"
+if grep -q '^CLEAR:103$' "$events_log"; then
+  echo "running PR unexpectedly had agent-running cleared" >&2
+  exit 1
+fi
+
+grep -q '^SYNC:101$' "$events_log"
+grep -q '^SYNC:102$' "$events_log"
+grep -q '^SYNC:104$' "$events_log"
+if grep -q '^SYNC:103$' "$events_log"; then
+  echo "running PR unexpectedly triggered label sync" >&2
+  exit 1
+fi
+
+echo "heartbeat sync open agent PRs terminal clears running test passed"