agent-control-plane 0.1.0

package/tools/tests/test-start-resident-issue-loop-waits-for-provider.sh

@@ -0,0 +1,194 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+FLOW_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+REAL_LOOP="${FLOW_ROOT}/tools/bin/start-resident-issue-loop.sh"
+REAL_CONFIG_LIB="${FLOW_ROOT}/tools/bin/flow-config-lib.sh"
+REAL_SHELL_LIB="${FLOW_ROOT}/tools/bin/flow-shell-lib.sh"
+REAL_RESIDENT_LIB="${FLOW_ROOT}/tools/bin/flow-resident-worker-lib.sh"
+
+tmpdir="$(mktemp -d)"
+trap 'rm -rf "$tmpdir"' EXIT
+
+skill_root="$tmpdir/skill"
+bin_dir="$skill_root/tools/bin"
+hooks_dir="$skill_root/hooks"
+assets_dir="$skill_root/assets"
+profile_registry_root="$tmpdir/profile-registry"
+profile_dir="$profile_registry_root/demo"
+shim_dir="$tmpdir/shim"
+agent_root="$tmpdir/agent"
+repo_root="$tmpdir/repo"
+capture_dir="$tmpdir/capture"
+
+mkdir -p "$bin_dir" "$hooks_dir" "$assets_dir" "$profile_dir" "$shim_dir" "$agent_root" "$repo_root" "$capture_dir"
+cp "$REAL_LOOP" "$bin_dir/start-resident-issue-loop.sh"
+cp "$REAL_CONFIG_LIB" "$bin_dir/flow-config-lib.sh"
+cp "$REAL_SHELL_LIB" "$bin_dir/flow-shell-lib.sh"
+cp "$REAL_RESIDENT_LIB" "$bin_dir/flow-resident-worker-lib.sh"
+printf '{}\n' >"$assets_dir/workflow-catalog.json"
+
+cat >"$profile_dir/control-plane.yaml" <<EOF
+schema_version: "1"
+id: "demo"
+repo:
+  slug: "example/demo"
+  root: "$repo_root"
+  default_branch: "main"
+runtime:
+  orchestrator_agent_root: "$agent_root"
+  worktree_root: "$tmpdir/worktrees"
+  agent_repo_root: "$repo_root"
+  runs_root: "$agent_root/runs"
+  state_root: "$agent_root/state"
+  history_root: "$agent_root/history"
+  retained_repo_root: "$repo_root"
+  vscode_workspace_file: "$tmpdir/demo.code-workspace"
+session_naming:
+  issue_prefix: "demo-issue-"
+  pr_prefix: "demo-pr-"
+execution:
+  coding_worker: "openclaw"
+  resident_workers:
+    issue_reuse_enabled: true
+    issue_controller_max_immediate_cycles: 1
+    controller_poll_seconds: 1
+    issue_controller_idle_timeout_seconds: 1
+EOF
+
+cat >"$hooks_dir/heartbeat-hooks.sh" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+heartbeat_open_agent_pr_issue_ids() { printf '[]\n'; }
+EOF
+chmod +x "$hooks_dir/heartbeat-hooks.sh"
+
+cat >"$shim_dir/gh" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+
+if [[ "${1:-}" == "issue" && "${2:-}" == "view" ]]; then
+  issue_id="${3:-0}"
+  cat <<JSON
+{"number":${issue_id},"state":"OPEN","title":"Resident issue ${issue_id}","body":"Keep this issue moving.","url":"https://example.test/issues/${issue_id}","labels":[{"name":"agent-keep-open"}],"comments":[]}
+JSON
+  exit 0
+fi
+
+if [[ "${1:-}" == "pr" && "${2:-}" == "list" ]]; then
+  printf '[]\n'
+  exit 0
+fi
+
+exit 64
+EOF
+chmod +x "$shim_dir/gh"
+
+cat >"$shim_dir/tmux" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+
+if [[ "${1:-}" == "has-session" ]]; then
+  pid_file="${TEST_CAPTURE_DIR:?}/tmux-session.pid"
+  if [[ -f "${pid_file}" ]]; then
+    pid="$(tr -d '[:space:]' <"${pid_file}" 2>/dev/null || true)"
+    if [[ -n "${pid}" ]] && kill -0 "${pid}" 2>/dev/null; then
+      exit 0
+    fi
+    rm -f "${pid_file}"
+  fi
+  exit 1
+fi
+
+exit 1
+EOF
+chmod +x "$shim_dir/tmux"
+
+cat >"$bin_dir/provider-cooldown-state.sh" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+
+capture_dir="${TEST_CAPTURE_DIR:?}"
+count_file="${capture_dir}/provider-count.txt"
+count="0"
+if [[ -f "${count_file}" ]]; then
+  count="$(cat "${count_file}")"
+fi
+count="$((count + 1))"
+printf '%s\n' "${count}" >"${count_file}"
+
+if (( count <= 2 )); then
+  future_epoch=$(( $(date +%s) + 1 ))
+  printf 'PROVIDER:%s:no\n' "${count}" >>"${capture_dir}/events.log"
+  cat <<OUT
+BACKEND=openclaw
+MODEL=primary/model
+NEXT_ATTEMPT_EPOCH=${future_epoch}
+NEXT_ATTEMPT_AT=2099-01-01T00:00:00Z
+READY=no
+LAST_REASON=provider-quota-limit
+OUT
+else
+  printf 'PROVIDER:%s:yes\n' "${count}" >>"${capture_dir}/events.log"
+  cat <<'OUT'
+BACKEND=openclaw
+MODEL=primary/model
+NEXT_ATTEMPT_EPOCH=0
+NEXT_ATTEMPT_AT=
+READY=yes
+LAST_REASON=
+OUT
+fi
+EOF
+chmod +x "$bin_dir/provider-cooldown-state.sh"
+
+cat >"$bin_dir/start-issue-worker.sh" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+
+issue_id="${1:?issue id required}"
+capture_dir="${TEST_CAPTURE_DIR:?}"
+count_file="${capture_dir}/start-count.txt"
+count="0"
+if [[ -f "${count_file}" ]]; then
+  count="$(cat "${count_file}")"
+fi
+count="$((count + 1))"
+printf '%s\n' "${count}" >"${count_file}"
+printf 'START:%s:%s\n' "${issue_id}" "${count}" >>"${capture_dir}/events.log"
+(sleep 0.2) &
+printf '%s\n' "$!" >"${capture_dir}/tmux-session.pid"
+EOF
+chmod +x "$bin_dir/start-issue-worker.sh"
+
+cat >"$bin_dir/reconcile-issue-worker.sh" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+printf 'RECONCILE:%s\n' "${1:?session required}" >>"${TEST_CAPTURE_DIR:?}/events.log"
+EOF
+chmod +x "$bin_dir/reconcile-issue-worker.sh"
+
+PATH="$shim_dir:$PATH" \
+ACP_PROJECT_ID="demo" \
+ACP_PROFILE_REGISTRY_ROOT="$profile_registry_root" \
+TEST_CAPTURE_DIR="$capture_dir" \
+bash "$bin_dir/start-resident-issue-loop.sh" 440 >/dev/null
+
+controller_file="$agent_root/state/resident-workers/issues/440/controller.env"
+line_provider_2="$(grep -n '^PROVIDER:2:no$' "$capture_dir/events.log" | cut -d: -f1)"
+line_start_1="$(grep -n '^START:440:1$' "$capture_dir/events.log" | cut -d: -f1)"
+
+grep -q '^1$' "$capture_dir/start-count.txt"
+test -n "$line_provider_2"
+test -n "$line_start_1"
+test "$line_start_1" -gt "$line_provider_2"
+grep -q '^RECONCILE:demo-issue-440$' "$capture_dir/events.log"
+grep -q '^CONTROLLER_REASON=idle-timeout$' "$controller_file"
+grep -q '^CONTROLLER_STATE=stopped$' "$controller_file"
+grep -q '^ACTIVE_PROVIDER_BACKEND=openclaw$' "$controller_file"
+test "$(awk -F= '/^PROVIDER_WAIT_COUNT=/{print $2}' "$controller_file")" -eq 1
+test "$(awk -F= '/^PROVIDER_WAIT_TOTAL_SECONDS=/{print $2}' "$controller_file")" -ge 1
+test "$(awk -F= '/^PROVIDER_LAST_WAIT_SECONDS=/{print $2}' "$controller_file")" -ge 1
+grep -q '^PROVIDER_FAILOVER_COUNT=0$' "$controller_file"
+
+echo "start resident issue loop waits for provider test passed"

package/tools/tests/test-start-resident-issue-loop-waits-for-terminal-reconcile-status.sh

@@ -0,0 +1,198 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+FLOW_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+REAL_LOOP="${FLOW_ROOT}/tools/bin/start-resident-issue-loop.sh"
+REAL_CONFIG_LIB="${FLOW_ROOT}/tools/bin/flow-config-lib.sh"
+REAL_SHELL_LIB="${FLOW_ROOT}/tools/bin/flow-shell-lib.sh"
+REAL_RESIDENT_LIB="${FLOW_ROOT}/tools/bin/flow-resident-worker-lib.sh"
+
+tmpdir="$(mktemp -d)"
+trap 'rm -rf "$tmpdir"' EXIT
+
+skill_root="$tmpdir/skill"
+bin_dir="$skill_root/tools/bin"
+hooks_dir="$skill_root/hooks"
+assets_dir="$skill_root/assets"
+profile_registry_root="$tmpdir/profile-registry"
+profile_dir="$profile_registry_root/demo"
+shim_dir="$tmpdir/shim"
+agent_root="$tmpdir/agent"
+repo_root="$tmpdir/repo"
+capture_dir="$tmpdir/capture"
+
+mkdir -p "$bin_dir" "$hooks_dir" "$assets_dir" "$profile_dir" "$shim_dir" "$agent_root" "$repo_root" "$capture_dir"
+cp "$REAL_LOOP" "$bin_dir/start-resident-issue-loop.sh"
+cp "$REAL_CONFIG_LIB" "$bin_dir/flow-config-lib.sh"
+cp "$REAL_SHELL_LIB" "$bin_dir/flow-shell-lib.sh"
+cp "$REAL_RESIDENT_LIB" "$bin_dir/flow-resident-worker-lib.sh"
+printf '{}\n' >"$assets_dir/workflow-catalog.json"
+
+cat >"$profile_dir/control-plane.yaml" <<EOF
+schema_version: "1"
+id: "demo"
+repo:
+  slug: "example/demo"
+  root: "$repo_root"
+  default_branch: "main"
+runtime:
+  orchestrator_agent_root: "$agent_root"
+  worktree_root: "$tmpdir/worktrees"
+  agent_repo_root: "$repo_root"
+  runs_root: "$agent_root/runs"
+  state_root: "$agent_root/state"
+  history_root: "$agent_root/history"
+  retained_repo_root: "$repo_root"
+  vscode_workspace_file: "$tmpdir/demo.code-workspace"
+session_naming:
+  issue_prefix: "demo-issue-"
+  pr_prefix: "demo-pr-"
+execution:
+  coding_worker: "openclaw"
+  resident_workers:
+    issue_reuse_enabled: true
+    issue_controller_max_immediate_cycles: 1
+    controller_poll_seconds: 1
+    issue_controller_idle_timeout_seconds: 1
+EOF
+
+cat >"$hooks_dir/heartbeat-hooks.sh" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+
+heartbeat_open_agent_pr_issue_ids() {
+  local count_file="${TEST_CAPTURE_DIR:?}/start-count.txt"
+  local count="0"
+  if [[ -f "${count_file}" ]]; then
+    count="$(cat "${count_file}")"
+  fi
+  if [[ "${count}" =~ ^[1-9][0-9]*$ ]]; then
+    printf '["440"]\n'
+  else
+    printf '[]\n'
+  fi
+}
+heartbeat_list_ready_issue_ids() { printf '440\n441\n'; }
+heartbeat_issue_is_recurring() {
+  case "${1:-}" in
+    440|441) printf 'yes\n' ;;
+    *) printf 'no\n' ;;
+  esac
+}
+heartbeat_issue_is_scheduled() { printf 'no\n'; }
+heartbeat_issue_is_heavy() { printf 'no\n'; }
+heartbeat_mark_issue_running() {
+  printf 'RUNNING:%s:%s\n' "${1:?issue id required}" "${2:-no}" >>"${TEST_CAPTURE_DIR:?}/events.log"
+}
+heartbeat_issue_launch_failed() {
+  printf 'FAILED:%s\n' "${1:?issue id required}" >>"${TEST_CAPTURE_DIR:?}/events.log"
+}
+EOF
+chmod +x "$hooks_dir/heartbeat-hooks.sh"
+
+cat >"$shim_dir/gh" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+
+if [[ "${1:-}" == "issue" && "${2:-}" == "view" ]]; then
+  issue_id="${3:-0}"
+  cat <<JSON
+{"number":${issue_id},"state":"OPEN","title":"Resident issue ${issue_id}","body":"Keep this issue moving.","url":"https://example.test/issues/${issue_id}","labels":[{"name":"agent-keep-open"}],"comments":[]}
+JSON
+  exit 0
+fi
+
+if [[ "${1:-}" == "pr" && "${2:-}" == "list" ]]; then
+  printf '[]\n'
+  exit 0
+fi
+
+exit 64
+EOF
+chmod +x "$shim_dir/gh"
+
+cat >"$shim_dir/tmux" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+
+if [[ "${1:-}" == "has-session" ]]; then
+  pid_file="${TEST_CAPTURE_DIR:?}/tmux-session.pid"
+  if [[ -f "${pid_file}" ]]; then
+    pid="$(tr -d '[:space:]' <"${pid_file}" 2>/dev/null || true)"
+    if [[ -n "${pid}" ]] && kill -0 "${pid}" 2>/dev/null; then
+      exit 0
+    fi
+    rm -f "${pid_file}"
+  fi
+  exit 1
+fi
+
+exit 1
+EOF
+chmod +x "$shim_dir/tmux"
+
+cat >"$bin_dir/start-issue-worker.sh" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+
+issue_id="${1:?issue id required}"
+capture_dir="${TEST_CAPTURE_DIR:?}"
+count_file="${capture_dir}/start-count.txt"
+count="0"
+if [[ -f "${count_file}" ]]; then
+  count="$(cat "${count_file}")"
+fi
+count="$((count + 1))"
+printf '%s\n' "${count}" >"${count_file}"
+printf 'START:%s:%s\n' "${issue_id}" "${count}" >>"${capture_dir}/events.log"
+(sleep 0.2) &
+printf '%s\n' "$!" >"${capture_dir}/tmux-session.pid"
+EOF
+chmod +x "$bin_dir/start-issue-worker.sh"
+
+cat >"$bin_dir/reconcile-issue-worker.sh" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+
+session="${1:?session required}"
+capture_dir="${TEST_CAPTURE_DIR:?}"
+count_file="${capture_dir}/reconcile-${session}.count"
+count="0"
+if [[ -f "${count_file}" ]]; then
+  count="$(cat "${count_file}")"
+fi
+count="$((count + 1))"
+printf '%s\n' "${count}" >"${count_file}"
+
+if [[ "${session}" == "demo-issue-440" && "${count}" -eq 1 ]]; then
+  printf 'RECONCILE:%s:RUNNING\n' "${session}" >>"${capture_dir}/events.log"
+  printf 'STATUS=RUNNING\n'
+  exit 0
+fi
+
+printf 'RECONCILE:%s:FAILED\n' "${session}" >>"${capture_dir}/events.log"
+printf 'STATUS=FAILED\n'
+exit 0
+EOF
+chmod +x "$bin_dir/reconcile-issue-worker.sh"
+
+PATH="$shim_dir:$PATH" \
+ACP_PROJECT_ID="demo" \
+ACP_PROFILE_REGISTRY_ROOT="$profile_registry_root" \
+TEST_CAPTURE_DIR="$capture_dir" \
+bash "$bin_dir/start-resident-issue-loop.sh" 440 >/dev/null
+
+grep -q '^START:440:1$' "$capture_dir/events.log"
+grep -q '^RECONCILE:demo-issue-440:RUNNING$' "$capture_dir/events.log"
+grep -q '^RECONCILE:demo-issue-440:FAILED$' "$capture_dir/events.log"
+grep -q '^START:441:2$' "$capture_dir/events.log"
+
+running_line="$(grep -n '^RECONCILE:demo-issue-440:RUNNING$' "$capture_dir/events.log" | cut -d: -f1)"
+failed_line="$(grep -n '^RECONCILE:demo-issue-440:FAILED$' "$capture_dir/events.log" | cut -d: -f1)"
+start_441_line="$(grep -n '^START:441:2$' "$capture_dir/events.log" | cut -d: -f1)"
+
+[[ -n "${running_line}" && -n "${failed_line}" && -n "${start_441_line}" ]]
+(( running_line < failed_line ))
+(( failed_line < start_441_line ))
+
+echo "start resident issue loop waits for terminal reconcile status test passed"

package/tools/tests/test-start-resident-issue-loop-yields-to-live-lane-controller.sh

@@ -0,0 +1,145 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+FLOW_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+REAL_LOOP="${FLOW_ROOT}/tools/bin/start-resident-issue-loop.sh"
+REAL_CONFIG_LIB="${FLOW_ROOT}/tools/bin/flow-config-lib.sh"
+REAL_SHELL_LIB="${FLOW_ROOT}/tools/bin/flow-shell-lib.sh"
+REAL_RESIDENT_LIB="${FLOW_ROOT}/tools/bin/flow-resident-worker-lib.sh"
+
+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
+
+skill_root="$tmpdir/skill"
+bin_dir="$skill_root/tools/bin"
+hooks_dir="$skill_root/hooks"
+assets_dir="$skill_root/assets"
+profile_registry_root="$tmpdir/profile-registry"
+profile_dir="$profile_registry_root/demo"
+shim_dir="$tmpdir/shim"
+agent_root="$tmpdir/agent"
+repo_root="$tmpdir/repo"
+capture_dir="$tmpdir/capture"
+lane_key="issue-lane-recurring-general-openclaw-safe"
+
+mkdir -p "$bin_dir" "$hooks_dir" "$assets_dir" "$profile_dir" "$shim_dir" "$agent_root" "$repo_root" "$capture_dir"
+cp "$REAL_LOOP" "$bin_dir/start-resident-issue-loop.sh"
+cp "$REAL_CONFIG_LIB" "$bin_dir/flow-config-lib.sh"
+cp "$REAL_SHELL_LIB" "$bin_dir/flow-shell-lib.sh"
+cp "$REAL_RESIDENT_LIB" "$bin_dir/flow-resident-worker-lib.sh"
+printf '{}\n' >"$assets_dir/workflow-catalog.json"
+
+cat >"$profile_dir/control-plane.yaml" <<EOF
+schema_version: "1"
+id: "demo"
+repo:
+  slug: "example/demo"
+  root: "$repo_root"
+  default_branch: "main"
+runtime:
+  orchestrator_agent_root: "$agent_root"
+  worktree_root: "$tmpdir/worktrees"
+  agent_repo_root: "$repo_root"
+  runs_root: "$agent_root/runs"
+  state_root: "$agent_root/state"
+  history_root: "$agent_root/history"
+  retained_repo_root: "$repo_root"
+  vscode_workspace_file: "$tmpdir/demo.code-workspace"
+session_naming:
+  issue_prefix: "demo-issue-"
+  pr_prefix: "demo-pr-"
+execution:
+  coding_worker: "openclaw"
+  resident_workers:
+    issue_reuse_enabled: true
+    issue_controller_max_immediate_cycles: 2
+    controller_poll_seconds: 1
+    issue_controller_idle_timeout_seconds: 30
+EOF
+
+cat >"$hooks_dir/heartbeat-hooks.sh" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+heartbeat_open_agent_pr_issue_ids() { printf '[]\n'; }
+heartbeat_issue_is_heavy() { printf 'no\n'; }
+heartbeat_mark_issue_running() { :; }
+heartbeat_issue_launch_failed() { :; }
+EOF
+chmod +x "$hooks_dir/heartbeat-hooks.sh"
+
+cat >"$shim_dir/gh" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+
+if [[ "${1:-}" == "issue" && "${2:-}" == "view" ]]; then
+  issue_id="${3:-0}"
+  cat <<JSON
+{"number":${issue_id},"state":"OPEN","title":"Resident issue ${issue_id}","body":"Keep this issue moving.","url":"https://example.test/issues/${issue_id}","labels":[{"name":"agent-keep-open"}],"comments":[]}
+JSON
+  exit 0
+fi
+
+if [[ "${1:-}" == "pr" && "${2:-}" == "list" ]]; then
+  printf '[]\n'
+  exit 0
+fi
+
+exit 64
+EOF
+chmod +x "$shim_dir/gh"
+
+cat >"$shim_dir/tmux" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+exit 1
+EOF
+chmod +x "$shim_dir/tmux"
+
+cat >"$bin_dir/start-issue-worker.sh" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+printf 'START:%s\n' "${1:?issue id required}" >>"${TEST_CAPTURE_DIR:?}/events.log"
+exit 0
+EOF
+chmod +x "$bin_dir/start-issue-worker.sh"
+
+cat >"$bin_dir/reconcile-issue-worker.sh" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+exit 0
+EOF
+chmod +x "$bin_dir/reconcile-issue-worker.sh"
+
+mkdir -p "$agent_root/state/resident-workers/issues/440"
+(sleep 30) &
+controller_pid="$!"
+cat >"$agent_root/state/resident-workers/issues/440/controller.env" <<EOF
+ISSUE_ID=440
+CONTROLLER_PID=${controller_pid}
+CONTROLLER_STATE=waiting-worker
+ACTIVE_RESIDENT_WORKER_KEY=${lane_key}
+EOF
+
+PATH="$shim_dir:$PATH" \
+ACP_PROJECT_ID="demo" \
+ACP_PROFILE_REGISTRY_ROOT="$profile_registry_root" \
+TEST_CAPTURE_DIR="$capture_dir" \
+bash "$bin_dir/start-resident-issue-loop.sh" 441 >/dev/null
+
+test ! -f "$capture_dir/events.log"
+queue_file="$agent_root/state/resident-workers/issue-queue/pending/issue-441.env"
+controller_file="$agent_root/state/resident-workers/issues/441/controller.env"
+
+test -f "$queue_file"
+grep -q '^ISSUE_ID=441$' "$queue_file"
+grep -q '^CONTROLLER_STATE=stopped$' "$controller_file"
+grep -q '^CONTROLLER_REASON=live-lane-controller-440-waiting-worker$' "$controller_file"
+
+echo "start resident issue loop yields to live lane controller test passed"

package/tools/tests/test-sync-pr-labels-fix-lane-uses-repair-queued.sh

@@ -0,0 +1,67 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+FLOW_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+SOURCE_SCRIPT="${FLOW_ROOT}/bin/sync-pr-labels.sh"
+FLOW_CONFIG_LIB="${FLOW_ROOT}/tools/bin/flow-config-lib.sh"
+FLOW_SHELL_LIB="${FLOW_ROOT}/tools/bin/flow-shell-lib.sh"
+
+tmpdir="$(mktemp -d)"
+trap 'rm -rf "$tmpdir"' EXIT
+
+adapter_bin_dir="$tmpdir/bin"
+tools_bin_dir="$tmpdir/tools/bin"
+shim_bin_dir="$tmpdir/shims"
+calls_log="$tmpdir/label-calls.log"
+
+mkdir -p "$adapter_bin_dir" "$tools_bin_dir" "$shim_bin_dir"
+cp "$SOURCE_SCRIPT" "$adapter_bin_dir/sync-pr-labels.sh"
+cp "$FLOW_CONFIG_LIB" "$tools_bin_dir/flow-config-lib.sh"
+cp "$FLOW_SHELL_LIB" "$tools_bin_dir/flow-shell-lib.sh"
+
+cat >"$adapter_bin_dir/pr-risk.sh" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+cat <<'JSON'
+{"isManagedByAgent":true,"agentLane":"fix","linkedIssueId":null,"isBlocked":false,"hasManualFixOverride":false,"eligibleForAutoMerge":false,"riskTier":"high","checksBypassed":false}
+JSON
+EOF
+
+cat >"$tools_bin_dir/agent-github-update-labels" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+printf '%s\n' "$*" >>"${TEST_LABEL_CALLS_LOG:?}"
+EOF
+
+cat >"$shim_bin_dir/gh" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+case "${1:-}" in
+  label)
+    exit 0
+    ;;
+esac
+echo "unexpected gh args: $*" >&2
+exit 1
+EOF
+
+chmod +x \
+  "$adapter_bin_dir/pr-risk.sh" \
+  "$adapter_bin_dir/sync-pr-labels.sh" \
+  "$tools_bin_dir/flow-config-lib.sh" \
+  "$tools_bin_dir/flow-shell-lib.sh" \
+  "$tools_bin_dir/agent-github-update-labels" \
+  "$shim_bin_dir/gh"
+
+TEST_LABEL_CALLS_LOG="$calls_log" \
+PATH="$shim_bin_dir:/opt/homebrew/bin:/usr/bin:/bin:/usr/sbin:/sbin" \
+bash "$adapter_bin_dir/sync-pr-labels.sh" 601 >/dev/null
+
+grep -q -- '--add agent-repair-queued' "$calls_log"
+if grep -q -- '--add agent-fix-needed' "$calls_log"; then
+  echo "sync-pr-labels unexpectedly re-added the manual override label for fix lane" >&2
+  cat "$calls_log" >&2
+  exit 1
+fi
+
+echo "sync-pr-labels fix lane uses repair queued test passed"

package/tools/tests/test-sync-recurring-issue-checklist-backfills-workflow-complete-blocker.sh

@@ -0,0 +1,70 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+FLOW_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+SCRIPT="${FLOW_ROOT}/tools/bin/sync-recurring-issue-checklist.sh"
+
+tmpdir="$(mktemp -d)"
+trap 'rm -rf "$tmpdir"' EXIT
+
+bin_dir="$tmpdir/bin"
+mkdir -p "$bin_dir"
+
+cat >"$bin_dir/gh" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+
+capture_file="${TEST_CAPTURE_FILE:?}"
+
+if [[ "${1:-}" == "issue" && "${2:-}" == "view" ]]; then
+  cat <<'JSON'
+{"number":6,"state":"OPEN","title":"Recurring checklist demo","body":"Rolling summary metric improvements\n\nChecklist:\n- [x] Add an `overdueCount` field to the summary output.\n- [x] Add a helper that returns only tasks due within one day.\n- [ ] Expose `blockedCount` directly from the summary output.\n","url":"https://example.test/issues/6","labels":[{"name":"agent-keep-open"}],"comments":[{"body":"# Blocker: All checklist items already completed\n\nAll three checklist items for issue #6 are satisfied on the current baseline.","createdAt":"2026-03-28T17:39:37Z"}],"createdAt":"2026-03-28T10:00:00Z","updatedAt":"2026-03-28T17:39:37Z"}
+JSON
+  exit 0
+fi
+
+if [[ "${1:-}" == "pr" && "${2:-}" == "view" ]]; then
+  exit 1
+fi
+
+if [[ "${1:-}" == "api" ]]; then
+  route="${2:-}"
+  shift 2
+  if [[ "${route}" == "repos/example/demo/issues/6" ]]; then
+    input_file=""
+    while [[ $# -gt 0 ]]; do
+      case "$1" in
+        --input)
+          input_file="${2:-}"
+          shift 2
+          ;;
+        *)
+          shift
+          ;;
+      esac
+    done
+    if [[ -n "${input_file}" && -f "${input_file}" ]]; then
+      cp "${input_file}" "${capture_file}"
+    else
+      cat >"${capture_file}"
+    fi
+    exit 0
+  fi
+fi
+
+echo "unexpected gh args: $*" >&2
+exit 1
+EOF
+chmod +x "$bin_dir/gh"
+
+TEST_CAPTURE_FILE="$tmpdir/update.txt" \
+PATH="$bin_dir:$PATH" \
+bash "$SCRIPT" --repo-slug example/demo --issue-id 6 >"$tmpdir/out.txt"
+
+grep -q '^CHECKLIST_SYNC_STATUS=updated$' "$tmpdir/out.txt"
+grep -q '^CHECKLIST_TOTAL=3$' "$tmpdir/out.txt"
+grep -q '^CHECKLIST_CHECKED=3$' "$tmpdir/out.txt"
+grep -q '^CHECKLIST_UNCHECKED=0$' "$tmpdir/out.txt"
+jq -r '.body' "$tmpdir/update.txt" | grep -q -- '- \[x\] Expose `blockedCount` directly from the summary output\.'
+
+echo "sync recurring issue checklist workflow blocker backfill test passed"