agent-control-plane 0.1.0

package/tools/tests/test-heartbeat-loop-provider-cooldown-suppresses-launches.sh

@@ -0,0 +1,157 @@
+#!/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() { printf '101\n'; }
+heartbeat_list_blocked_recovery_issue_ids() { :; }
+heartbeat_list_open_agent_pr_ids() { :; }
+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_sync_pr_labels() { :; }
+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() { :; }
+
+heartbeat_start_issue_worker() {
+  local issue_id="${1:?issue id required}"
+  printf 'ISSUE:%s\n' "$issue_id" >>"${TEST_EVENTS_LOG:?}"
+}
+heartbeat_start_pr_merge_repair_worker() { :; }
+heartbeat_start_pr_review_worker() { printf 'PR:%s\n' "${1:-}" >>"${TEST_EVENTS_LOG:?}"; }
+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=yes
+LAST_REASON=
+OUT
+EOF
+
+cat >"$shared_home/tools/bin/provider-cooldown-state.sh" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+cat <<OUT
+BACKEND=openclaw
+MODEL=openrouter/stepfun/step-3.5-flash:free
+PROVIDER_KEY=openclaw-openrouter-stepfun-step-3.5-flash-free
+KIND=provider
+ITEM_ID=openclaw-openrouter-stepfun-step-3.5-flash-free
+ATTEMPTS=2
+NEXT_ATTEMPT_EPOCH=9999999999
+NEXT_ATTEMPT_AT=2286-11-20T17:46:39Z
+READY=no
+LAST_REASON=provider-quota-limit
+UPDATED_AT=2026-03-26T12:00:00Z
+OUT
+EOF
+
+cat >"$shared_home/tools/bin/agent-project-worker-status" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+printf 'STATUS=UNKNOWN\n'
+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
+  exit 1
+fi
+if [[ "${1:-}" == "has-session" ]]; then
+  exit 1
+fi
+exit 0
+EOF
+
+chmod +x \
+  "$hook_file" \
+  "$shared_home/tools/bin/agent-project-retry-state" \
+  "$shared_home/tools/bin/provider-cooldown-state.sh" \
+  "$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"
+
+output="$(
+  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 2 \
+    --max-concurrent-heavy-workers 1 \
+    --max-concurrent-pr-workers 1 \
+    --max-recurring-issue-workers 1 \
+    --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 2
+)"
+
+test ! -f "$events_log" || test ! -s "$events_log"
+grep -q '^PROVIDER_COOLDOWN$' <<<"$output"
+grep -q '^BACKEND=openclaw$' <<<"$output"
+grep -q '^MODEL=openrouter/stepfun/step-3.5-flash:free$' <<<"$output"
+grep -q '^LAST_REASON=provider-quota-limit$' <<<"$output"
+if grep -q '^LAUNCHED_' <<<"$output"; then
+  echo "heartbeat launched work while provider cooldown was active" >&2
+  exit 1
+fi
+
+echo "heartbeat loop provider cooldown suppression test passed"

package/tools/tests/test-heartbeat-loop-reaps-stale-resident-controller.sh

@@ -0,0 +1,181 @@
+#!/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)"
+cleanup() {
+  rm -rf "$tmpdir"
+}
+trap cleanup 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"
+profile_registry_root="$tmpdir/profiles"
+profile_dir="$profile_registry_root/demo"
+
+mkdir -p \
+  "$shared_home/tools/bin" \
+  "$shared_home/skills/openclaw/agent-control-plane/tools/bin" \
+  "$bin_dir" \
+  "$runs_root" \
+  "$state_root/pending-launches" \
+  "$state_root/resident-workers/issues/101" \
+  "$memory_dir" \
+  "$profile_dir"
+
+cp "$FLOW_ROOT/tools/bin/flow-config-lib.sh" "$shared_home/skills/openclaw/agent-control-plane/tools/bin/flow-config-lib.sh"
+cp "$FLOW_ROOT/tools/bin/flow-shell-lib.sh" "$shared_home/skills/openclaw/agent-control-plane/tools/bin/flow-shell-lib.sh"
+cp "$FLOW_ROOT/tools/bin/flow-resident-worker-lib.sh" "$shared_home/skills/openclaw/agent-control-plane/tools/bin/flow-resident-worker-lib.sh"
+
+cat >"$hook_file" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+
+heartbeat_list_ready_issue_ids() { printf '101\n'; }
+heartbeat_list_blocked_recovery_issue_ids() { :; }
+heartbeat_list_open_agent_pr_ids() { :; }
+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 'yes\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 '{"number":0,"agentLane":"ignore"}\n'; }
+heartbeat_sync_issue_labels() { :; }
+heartbeat_sync_pr_labels() { :; }
+
+heartbeat_mark_issue_running() { :; }
+heartbeat_issue_launch_failed() { :; }
+heartbeat_mark_pr_running() { :; }
+heartbeat_clear_pr_running() { :; }
+
+heartbeat_start_issue_worker() {
+  local issue_id="${1:?issue id required}"
+  printf 'LAUNCH:%s\n' "$issue_id" >>"${TEST_EVENTS_LOG:?}"
+  printf 'LAUNCH_MODE=detached\n'
+}
+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=yes
+LAST_REASON=
+OUT
+EOF
+
+cat >"$shared_home/tools/bin/agent-project-worker-status" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+printf 'STATUS=UNKNOWN\n'
+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
+  exit 0
+fi
+if [[ "${1:-}" == "has-session" ]]; then
+  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" \
+  "$shared_home/skills/openclaw/agent-control-plane/tools/bin/flow-shell-lib.sh" \
+  "$shared_home/skills/openclaw/agent-control-plane/tools/bin/flow-config-lib.sh" \
+  "$shared_home/skills/openclaw/agent-control-plane/tools/bin/flow-resident-worker-lib.sh" \
+  "$bin_dir/tmux"
+
+cat >"$profile_dir/control-plane.yaml" <<EOF
+schema_version: "1"
+id: "demo"
+repo:
+  slug: "example/repo"
+  root: "$tmpdir/repo"
+  default_branch: "main"
+runtime:
+  orchestrator_agent_root: "$tmpdir/runtime/demo"
+  worktree_root: "$tmpdir/worktrees"
+  agent_repo_root: "$tmpdir/repo"
+  runs_root: "$runs_root"
+  state_root: "$state_root"
+  history_root: "$tmpdir/runtime/demo/history"
+  retained_repo_root: "$tmpdir/repo"
+  vscode_workspace_file: "$tmpdir/demo.code-workspace"
+execution:
+  coding_worker: "openclaw"
+  openclaw:
+    model: "primary/model"
+    thinking: "adaptive"
+    timeout_seconds: 900
+EOF
+
+printf '%s\n' "$$" >"$state_root/pending-launches/issue-101.pid"
+cat >"$state_root/resident-workers/issues/101/controller.env" <<EOF
+ISSUE_ID=101
+CONTROLLER_PID=$$
+CONTROLLER_STATE=waiting-due
+ACTIVE_RESIDENT_WORKER_KEY=issue-lane-recurring-general-openclaw-safe
+EOF
+
+export PATH="$bin_dir:/opt/homebrew/bin:/usr/bin:/bin:/usr/sbin:/sbin"
+export TEST_EVENTS_LOG="$events_log"
+
+SHARED_AGENT_HOME="$shared_home" \
+ACP_PROFILE_REGISTRY_ROOT="$profile_registry_root" \
+ACP_PROJECT_ID=demo \
+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 1 \
+  --max-concurrent-heavy-workers 0 \
+  --max-concurrent-pr-workers 0 \
+  --max-recurring-issue-workers 1 \
+  --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 1 \
+  >/dev/null
+
+grep -q '^LAUNCH:101$' "$events_log"
+test ! -f "$state_root/resident-workers/issues/101/controller.env"
+test ! -f "$state_root/pending-launches/issue-101.pid"
+
+echo "heartbeat loop reaps stale resident controller test passed"

package/tools/tests/test-heartbeat-loop-waiting-provider-resident-controller-does-not-block-launches.sh

@@ -0,0 +1,160 @@
+#!/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)"
+cleanup() {
+  if [[ -n "${controller_pid:-}" ]]; then
+    kill "${controller_pid}" >/dev/null 2>&1 || true
+    wait "${controller_pid}" >/dev/null 2>&1 || true
+  fi
+  rm -rf "$tmpdir"
+}
+trap cleanup 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/pending-launches" \
+  "$state_root/resident-workers/issues/101" \
+  "$memory_dir"
+
+cat >"$hook_file" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+
+heartbeat_list_ready_issue_ids() { printf '101\n102\n'; }
+heartbeat_list_blocked_recovery_issue_ids() { :; }
+heartbeat_list_open_agent_pr_ids() { :; }
+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() {
+  if [[ "${1:-}" == "101" ]]; then
+    printf 'yes\n'
+  else
+    printf 'no\n'
+  fi
+}
+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 '{"number":0,"agentLane":"ignore"}\n'; }
+heartbeat_sync_issue_labels() { :; }
+heartbeat_sync_pr_labels() { :; }
+
+heartbeat_mark_issue_running() { :; }
+heartbeat_issue_launch_failed() { :; }
+heartbeat_mark_pr_running() { :; }
+heartbeat_clear_pr_running() { :; }
+
+heartbeat_start_issue_worker() {
+  local issue_id="${1:?issue id required}"
+  printf 'LAUNCH:%s\n' "$issue_id" >>"${TEST_EVENTS_LOG:?}"
+  printf 'LAUNCH_MODE=detached\n'
+}
+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=yes
+LAST_REASON=
+OUT
+EOF
+
+cat >"$shared_home/tools/bin/agent-project-worker-status" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+printf 'STATUS=UNKNOWN\n'
+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
+  exit 0
+fi
+
+if [[ "${1:-}" == "has-session" ]]; then
+  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"
+
+(sleep 30) &
+controller_pid="$!"
+printf '%s\n' "${controller_pid}" >"$state_root/pending-launches/issue-101.pid"
+cat >"$state_root/resident-workers/issues/101/controller.env" <<EOF
+ISSUE_ID=101
+CONTROLLER_PID=${controller_pid}
+CONTROLLER_STATE=waiting-provider
+EOF
+
+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 1 \
+  --max-concurrent-heavy-workers 0 \
+  --max-concurrent-pr-workers 0 \
+  --max-recurring-issue-workers 1 \
+  --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 1 \
+  >/dev/null
+
+grep -q '^LAUNCH:102$' "$events_log"
+if grep -q '^LAUNCH:101$' "$events_log"; then
+  echo "waiting-provider resident controller issue unexpectedly relaunched" >&2
+  exit 1
+fi
+
+echo "heartbeat loop waiting-provider resident controller does not block launches test passed"

package/tools/tests/test-heartbeat-ready-issues-blocked-recovery.sh

@@ -0,0 +1,134 @@
+#!/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:-}" == "pr" && "${2:-}" == "list" ]]; then
+  printf '[]\n'
+  exit 0
+fi
+
+if [[ "${1:-}" == "issue" && "${2:-}" == "list" ]]; then
+  cat <<'JSON'
+[
+  {"number":101,"createdAt":"2026-03-15T10:00:00Z","labels":[]},
+  {"number":102,"createdAt":"2026-03-15T10:01:00Z","labels":[{"name":"agent-blocked"}]},
+  {"number":103,"createdAt":"2026-03-15T10:02:00Z","labels":[{"name":"agent-blocked"}]}
+]
+JSON
+  exit 0
+fi
+
+echo "unexpected gh args: $*" >&2
+exit 1
+EOF
+
+cat >"$tools_dir/retry-state.sh" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+
+kind="${1:-}"
+item_id="${2:-}"
+action="${3:-}"
+
+if [[ "$kind" != "issue" || "$action" != "get" ]]; then
+  echo "unexpected retry-state args: $*" >&2
+  exit 1
+fi
+
+case "$item_id" in
+  102)
+    cat <<'OUT'
+KIND=issue
+ITEM_ID=102
+ATTEMPTS=0
+NEXT_ATTEMPT_EPOCH=0
+NEXT_ATTEMPT_AT=
+READY=yes
+LAST_REASON=
+UPDATED_AT=
+OUT
+    ;;
+  103)
+    cat <<'OUT'
+KIND=issue
+ITEM_ID=103
+ATTEMPTS=1
+NEXT_ATTEMPT_EPOCH=0
+NEXT_ATTEMPT_AT=
+READY=yes
+LAST_REASON=scope-guard-blocked
+UPDATED_AT=2026-03-15T10:05:00Z
+OUT
+    ;;
+  *)
+    cat <<OUT
+KIND=issue
+ITEM_ID=${item_id}
+ATTEMPTS=0
+NEXT_ATTEMPT_EPOCH=0
+NEXT_ATTEMPT_AT=
+READY=yes
+LAST_REASON=
+UPDATED_AT=
+OUT
+    ;;
+esac
+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/retry-state.sh" "$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"
+
+ready_issue_ids="$(heartbeat_list_ready_issue_ids)"
+blocked_recovery_issue_ids="$(heartbeat_list_blocked_recovery_issue_ids)"
+
+grep -q '^101$' <<<"$ready_issue_ids"
+if grep -q '^102$' <<<"$ready_issue_ids"; then
+  echo "manual blocked issue unexpectedly returned as ready" >&2
+  exit 1
+fi
+if grep -q '^103$' <<<"$ready_issue_ids"; then
+  echo "blocked recovery issue unexpectedly returned as normal ready" >&2
+  exit 1
+fi
+
+grep -q '^103$' <<<"$blocked_recovery_issue_ids"
+if grep -q '^102$' <<<"$blocked_recovery_issue_ids"; then
+  echo "manual blocked issue unexpectedly returned as blocked-recovery candidate" >&2
+  exit 1
+fi
+
+heartbeat_mark_issue_running 103 no
+grep -q -- '--remove agent-blocked' "$labels_log"
+grep -q -- '--add agent-running' "$labels_log"
+
+echo "heartbeat ready blocked-recovery issue test passed"