agent-control-plane 0.1.0

package/tools/tests/test-flow-github-api-repo-prefers-explicit-repository-id.sh

@@ -0,0 +1,60 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+FLOW_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+REAL_CONFIG_LIB="${FLOW_ROOT}/tools/bin/flow-config-lib.sh"
+REAL_SHELL_LIB="${FLOW_ROOT}/tools/bin/flow-shell-lib.sh"
+
+tmpdir="$(mktemp -d)"
+trap 'rm -rf "$tmpdir"' EXIT
+
+bin_dir="$tmpdir/bin"
+mkdir -p "$bin_dir"
+
+cp "$REAL_CONFIG_LIB" "$bin_dir/flow-config-lib.sh"
+cp "$REAL_SHELL_LIB" "$bin_dir/flow-shell-lib.sh"
+
+cat >"$bin_dir/gh" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+
+if [[ "${1:-}" != "api" ]]; then
+  echo "unexpected gh invocation: $*" >&2
+  exit 1
+fi
+
+route="${2:-}"
+shift 2 || true
+
+case "$route" in
+  repos/example/repo/issues/42)
+    exit 1
+    ;;
+  repositories/123/issues/42)
+    printf '{"number":42,"state":"open"}\n'
+    exit 0
+    ;;
+  user/repos*)
+    echo "unexpected repo discovery route: $route" >&2
+    exit 98
+    ;;
+  *)
+    echo "unexpected gh api route: $route" >&2
+    exit 1
+    ;;
+esac
+EOF
+
+chmod +x "$bin_dir/flow-config-lib.sh" "$bin_dir/flow-shell-lib.sh" "$bin_dir/gh"
+
+output="$(
+  PATH="$bin_dir:/usr/bin:/bin:/usr/sbin:/sbin" \
+  ACP_REPO_ID="123" \
+  ACP_REPO_SLUG="example/repo" \
+  bash -c 'source "'"$bin_dir"'/flow-config-lib.sh"; flow_github_api_repo "example/repo" "issues/42"'
+)"
+
+test "$(jq -r '.number' <<<"$output")" = "42"
+test "$(jq -r '.state' <<<"$output")" = "open"
+
+echo "flow github api repo prefers explicit repository id test passed"

package/tools/tests/test-flow-github-issue-list-falls-back-to-repository-id.sh

@@ -0,0 +1,64 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+FLOW_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+REAL_CONFIG_LIB="${FLOW_ROOT}/tools/bin/flow-config-lib.sh"
+REAL_SHELL_LIB="${FLOW_ROOT}/tools/bin/flow-shell-lib.sh"
+
+tmpdir="$(mktemp -d)"
+trap 'rm -rf "$tmpdir"' EXIT
+
+bin_dir="$tmpdir/bin"
+mkdir -p "$bin_dir"
+
+cp "$REAL_CONFIG_LIB" "$bin_dir/flow-config-lib.sh"
+cp "$REAL_SHELL_LIB" "$bin_dir/flow-shell-lib.sh"
+
+cat >"$bin_dir/gh" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+
+if [[ "${1:-}" == "issue" && "${2:-}" == "list" ]]; then
+  echo 'GraphQL: Could not resolve to a Repository with the name "example/demo".' >&2
+  exit 1
+fi
+
+if [[ "${1:-}" == "api" ]]; then
+  route="${2:-}"
+  if [[ "$route" == "repos/example/demo/issues?state=open&per_page=100" ]]; then
+    echo '{"message":"Not Found"}' >&2
+    exit 1
+  fi
+  if [[ "$route" == user/repos\?* ]]; then
+    printf '[[{"id":123,"full_name":"example/demo"}]]\n'
+    exit 0
+  fi
+  if [[ "$route" == "repositories/123/issues?state=open&per_page=100" ]]; then
+    cat <<'JSON'
+[[{"number":2,"created_at":"2026-03-27T10:00:00Z","updated_at":"2026-03-27T10:05:00Z","title":"Ready issue","html_url":"https://github.com/example/demo/issues/2","labels":[{"name":"agent-ready"}]},{"number":9,"created_at":"2026-03-27T10:01:00Z","updated_at":"2026-03-27T10:06:00Z","title":"PR mirror","html_url":"https://github.com/example/demo/pull/9","labels":[],"pull_request":{"url":"https://api.github.com/repos/example/demo/pulls/9"}}]]
+JSON
+    exit 0
+  fi
+fi
+
+echo "unexpected gh invocation: $*" >&2
+exit 1
+EOF
+chmod +x "$bin_dir/gh"
+
+output="$(
+  LIB_PATH="$bin_dir/flow-config-lib.sh" \
+  PATH="$bin_dir:/usr/bin:/bin:/usr/sbin:/sbin" \
+  bash <<'EOF'
+set -euo pipefail
+source "$LIB_PATH"
+flow_github_issue_list_json "example/demo" open 100
+EOF
+)"
+
+test "$(jq 'length' <<<"$output")" -eq 1
+test "$(jq -r '.[0].number' <<<"$output")" = "2"
+test "$(jq -r '.[0].labels[0].name' <<<"$output")" = "agent-ready"
+test "$(jq -r '.[0].createdAt' <<<"$output")" = "2026-03-27T10:00:00Z"
+
+echo "flow github issue list falls back to repository id test passed"

package/tools/tests/test-flow-github-pr-list-falls-back-to-repository-id.sh

@@ -0,0 +1,77 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+FLOW_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+REAL_CONFIG_LIB="${FLOW_ROOT}/tools/bin/flow-config-lib.sh"
+REAL_SHELL_LIB="${FLOW_ROOT}/tools/bin/flow-shell-lib.sh"
+
+tmpdir="$(mktemp -d)"
+trap 'rm -rf "$tmpdir"' EXIT
+
+bin_dir="$tmpdir/bin"
+mkdir -p "$bin_dir"
+
+cp "$REAL_CONFIG_LIB" "$bin_dir/flow-config-lib.sh"
+cp "$REAL_SHELL_LIB" "$bin_dir/flow-shell-lib.sh"
+
+cat >"$bin_dir/gh" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+
+if [[ "${1:-}" == "pr" && "${2:-}" == "list" ]]; then
+  echo 'GraphQL: Could not resolve to a Repository with the name "example/demo".' >&2
+  exit 1
+fi
+
+if [[ "${1:-}" == "api" ]]; then
+  route="${2:-}"
+  if [[ "$route" == "repos/example/demo/pulls?state=open&per_page=100" ]]; then
+    echo '{"message":"Not Found"}' >&2
+    exit 1
+  fi
+  if [[ "$route" == user/repos\?* ]]; then
+    printf '[[{"id":123,"full_name":"example/demo"}]]\n'
+    exit 0
+  fi
+  if [[ "$route" == "repositories/123/pulls?state=open&per_page=100" ]]; then
+    cat <<'JSON'
+[[{"number":8,"title":"Agent PR","body":"Closes #2","html_url":"https://github.com/example/demo/pull/8","head":{"ref":"agent/demo/issue-2-test"},"created_at":"2026-03-27T10:00:00Z","draft":false}]]
+JSON
+    exit 0
+  fi
+  if [[ "$route" == "repositories/123/issues/8" ]]; then
+    cat <<'JSON'
+{"number":8,"labels":[{"name":"agent-handoff"}]}
+JSON
+    exit 0
+  fi
+  if [[ "$route" == "repositories/123/issues/8/comments?per_page=100" ]]; then
+    cat <<'JSON'
+[[{"body":"## PR final review blocker\n\nblocked","created_at":"2026-03-27T10:02:00Z","updated_at":"2026-03-27T10:02:00Z","html_url":"https://github.com/example/demo/pull/8#issuecomment-1"}]]
+JSON
+    exit 0
+  fi
+fi
+
+echo "unexpected gh invocation: $*" >&2
+exit 1
+EOF
+chmod +x "$bin_dir/gh"
+
+output="$(
+  LIB_PATH="$bin_dir/flow-config-lib.sh" \
+  PATH="$bin_dir:/usr/bin:/bin:/usr/sbin:/sbin" \
+  bash <<'EOF'
+set -euo pipefail
+source "$LIB_PATH"
+flow_github_pr_list_json "example/demo" open 100
+EOF
+)"
+
+test "$(jq 'length' <<<"$output")" -eq 1
+test "$(jq -r '.[0].number' <<<"$output")" = "8"
+test "$(jq -r '.[0].headRefName' <<<"$output")" = "agent/demo/issue-2-test"
+test "$(jq -r '.[0].labels[0].name' <<<"$output")" = "agent-handoff"
+grep -q '## PR final review blocker' <<<"$(jq -r '.[0].comments[0].body' <<<"$output")"
+
+echo "flow github pr list falls back to repository id test passed"

package/tools/tests/test-flow-resident-can-reuse-does-not-leak-metadata.sh

@@ -0,0 +1,52 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+FLOW_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+REAL_RESIDENT_LIB="${FLOW_ROOT}/tools/bin/flow-resident-worker-lib.sh"
+REAL_CONFIG_LIB="${FLOW_ROOT}/tools/bin/flow-config-lib.sh"
+REAL_SHELL_LIB="${FLOW_ROOT}/tools/bin/flow-shell-lib.sh"
+
+tmpdir="$(mktemp -d)"
+trap 'rm -rf "$tmpdir"' EXIT
+
+bin_dir="$tmpdir/bin"
+worktree="$tmpdir/worktree"
+metadata_file="$tmpdir/metadata.env"
+
+mkdir -p "$bin_dir" "$worktree/.git"
+cp "$REAL_RESIDENT_LIB" "$bin_dir/flow-resident-worker-lib.sh"
+cp "$REAL_CONFIG_LIB" "$bin_dir/flow-config-lib.sh"
+cp "$REAL_SHELL_LIB" "$bin_dir/flow-shell-lib.sh"
+
+cat >"$metadata_file" <<EOF
+ISSUE_ID=1
+WORKTREE=$worktree
+TASK_COUNT=1
+LAST_STARTED_AT=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+EOF
+
+TEST_RESULT="$(
+  LIB_PATH="$bin_dir/flow-resident-worker-lib.sh" \
+  METADATA_FILE="$metadata_file" \
+  bash <<'EOF'
+set -euo pipefail
+source "$LIB_PATH"
+ISSUE_ID="2"
+WORKTREE="/tmp/current-worktree"
+TASK_COUNT="9"
+if flow_resident_issue_can_reuse "$METADATA_FILE" 12 86400; then
+  :
+else
+  exit 1
+fi
+printf 'ISSUE_ID=%s\n' "$ISSUE_ID"
+printf 'WORKTREE=%s\n' "$WORKTREE"
+printf 'TASK_COUNT=%s\n' "$TASK_COUNT"
+EOF
+)"
+
+grep -q '^ISSUE_ID=2$' <<<"$TEST_RESULT"
+grep -q '^WORKTREE=/tmp/current-worktree$' <<<"$TEST_RESULT"
+grep -q '^TASK_COUNT=9$' <<<"$TEST_RESULT"
+
+echo "flow resident can reuse does not leak metadata test passed"

package/tools/tests/test-flow-resident-reap-stale-controllers.sh

@@ -0,0 +1,63 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+FLOW_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+FLOW_LIB="${FLOW_ROOT}/tools/bin/flow-resident-worker-lib.sh"
+
+tmpdir="$(mktemp -d)"
+trap 'rm -rf "$tmpdir"' EXIT
+
+profile_registry_root="$tmpdir/profiles"
+profile_dir="$profile_registry_root/demo"
+state_root="$tmpdir/runtime/demo/state"
+controller_dir="$state_root/resident-workers/issues/101"
+pending_dir="$state_root/pending-launches"
+
+mkdir -p "$profile_dir" "$controller_dir" "$pending_dir"
+
+cat >"$profile_dir/control-plane.yaml" <<EOF
+schema_version: "1"
+id: "demo"
+repo:
+  slug: "example/demo"
+  root: "$tmpdir/repo"
+  default_branch: "main"
+runtime:
+  orchestrator_agent_root: "$tmpdir/runtime/demo"
+  worktree_root: "$tmpdir/worktrees"
+  agent_repo_root: "$tmpdir/repo"
+  runs_root: "$tmpdir/runtime/demo/runs"
+  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' "$$" >"$pending_dir/issue-101.pid"
+cat >"$controller_dir/controller.env" <<EOF
+ISSUE_ID=101
+CONTROLLER_PID=$$
+CONTROLLER_STATE=waiting-due
+ACTIVE_RESIDENT_WORKER_KEY=issue-lane-recurring-general-openclaw-safe
+EOF
+
+output="$(
+  ACP_PROFILE_REGISTRY_ROOT="$profile_registry_root" \
+  ACP_PROJECT_ID=demo \
+  bash -lc '
+    source "'"$FLOW_LIB"'"
+    flow_resident_issue_reap_stale_state
+  '
+)"
+
+grep -q '^1$' <<<"$output"
+test ! -f "$controller_dir/controller.env"
+test ! -f "$pending_dir/issue-101.pid"
+
+echo "flow resident reap stale controllers test passed"

package/tools/tests/test-flow-resolve-codex-quota-tools.sh

@@ -0,0 +1,104 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+FLOW_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+LIB_PATH="${FLOW_ROOT}/tools/bin/flow-config-lib.sh"
+
+tmpdir="$(mktemp -d)"
+trap 'rm -rf "$tmpdir"' EXIT
+
+flow_root="$tmpdir/flow-root"
+shared_home="$tmpdir/shared-home"
+custom_bin="$tmpdir/custom-codex-quota"
+custom_script="$tmpdir/custom-auto-switch.sh"
+
+mkdir -p \
+  "$flow_root/tools/bin" \
+  "$flow_root/tools/vendor/codex-quota-manager/scripts" \
+  "$shared_home/tools/bin" \
+  "$shared_home/tools/vendor/codex-quota-manager/scripts" \
+  "$shared_home/skills/openclaw/codex-quota-manager/scripts"
+
+cat >"$flow_root/tools/bin/codex-quota" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+exit 0
+EOF
+
+cat >"$flow_root/tools/vendor/codex-quota-manager/scripts/auto-switch.sh" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+exit 0
+EOF
+
+cat >"$shared_home/tools/bin/codex-quota" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+exit 0
+EOF
+
+cat >"$shared_home/tools/vendor/codex-quota-manager/scripts/auto-switch.sh" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+exit 0
+EOF
+
+cat >"$shared_home/skills/openclaw/codex-quota-manager/scripts/auto-switch.sh" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+exit 0
+EOF
+
+cat >"$custom_bin" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+exit 0
+EOF
+
+cat >"$custom_script" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+exit 0
+EOF
+
+chmod +x \
+  "$flow_root/tools/bin/codex-quota" \
+  "$flow_root/tools/vendor/codex-quota-manager/scripts/auto-switch.sh" \
+  "$shared_home/tools/bin/codex-quota" \
+  "$shared_home/tools/vendor/codex-quota-manager/scripts/auto-switch.sh" \
+  "$shared_home/skills/openclaw/codex-quota-manager/scripts/auto-switch.sh" \
+  "$custom_bin" \
+  "$custom_script"
+
+(
+  export ACP_ROOT="$flow_root"
+  export SHARED_AGENT_HOME="$shared_home"
+  # shellcheck source=/dev/null
+  source "$LIB_PATH"
+  test "$(flow_resolve_codex_quota_bin "$flow_root")" = "$flow_root/tools/bin/codex-quota"
+  test "$(flow_resolve_codex_quota_manager_script "$flow_root")" = "$flow_root/tools/vendor/codex-quota-manager/scripts/auto-switch.sh"
+)
+
+rm -f "$flow_root/tools/bin/codex-quota" "$flow_root/tools/vendor/codex-quota-manager/scripts/auto-switch.sh"
+
+(
+  export ACP_ROOT="$flow_root"
+  export SHARED_AGENT_HOME="$shared_home"
+  # shellcheck source=/dev/null
+  source "$LIB_PATH"
+  test "$(flow_resolve_codex_quota_bin "$flow_root")" = "$shared_home/tools/bin/codex-quota"
+  test "$(flow_resolve_codex_quota_manager_script "$flow_root")" = "$shared_home/tools/vendor/codex-quota-manager/scripts/auto-switch.sh"
+)
+
+(
+  export ACP_ROOT="$flow_root"
+  export SHARED_AGENT_HOME="$shared_home"
+  export ACP_CODEX_QUOTA_BIN="$custom_bin"
+  export ACP_CODEX_QUOTA_MANAGER_SCRIPT="$custom_script"
+  # shellcheck source=/dev/null
+  source "$LIB_PATH"
+  test "$(flow_resolve_codex_quota_bin "$flow_root")" = "$custom_bin"
+  test "$(flow_resolve_codex_quota_manager_script "$flow_root")" = "$custom_script"
+)
+
+echo "flow codex quota resolver test passed"

package/tools/tests/test-flow-runtime-doctor-profile-selection.sh

@@ -0,0 +1,27 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+FLOW_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+SCRIPT="${FLOW_ROOT}/tools/bin/flow-runtime-doctor.sh"
+SCAFFOLD_SCRIPT="${FLOW_ROOT}/tools/bin/scaffold-profile.sh"
+
+tmpdir="$(mktemp -d)"
+trap 'rm -rf "$tmpdir"' EXIT
+
+profile_home="$tmpdir/profiles"
+repo_slug="example-owner/alpha"
+
+bash "$SCAFFOLD_SCRIPT" --profile-home "$profile_home" --profile-id alpha --repo-slug "$repo_slug" >/dev/null
+bash "$SCAFFOLD_SCRIPT" --profile-home "$profile_home" --profile-id demo --repo-slug example/demo-platform >/dev/null
+profile_notes_real="$(cd "$profile_home/alpha" && pwd -P)/README.md"
+
+output="$(ACP_PROFILE_REGISTRY_ROOT="$profile_home" bash "$SCRIPT")"
+
+grep -q '^PROFILE_ID=alpha$' <<<"$output"
+grep -q '^PROFILE_SELECTION_MODE=implicit-default$' <<<"$output"
+grep -q "^PROFILE_REGISTRY_ROOT=${profile_home}$" <<<"$output"
+grep -q "^PROFILE_NOTES=${profile_notes_real}$" <<<"$output"
+grep -q '^PROFILE_NOTES_EXISTS=yes$' <<<"$output"
+grep -q '^PROFILE_SELECTION_NEXT_STEP=ACP_PROJECT_ID=<id> bash .*/tools/bin/render-flow-config.sh$' <<<"$output"
+
+echo "flow runtime doctor profile selection test passed"

package/tools/tests/test-heartbeat-codex-pr-linked-issue-exclusion.sh

@@ -0,0 +1,79 @@
+#!/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"
+
+mkdir -p "$bin_dir" "$tools_dir"
+
+cat >"$bin_dir/gh" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+
+if [[ "${1:-}" == "pr" && "${2:-}" == "list" ]]; then
+  cat <<'JSON'
+[
+  {"number":501,"createdAt":"2026-03-15T10:00:00Z","headRefName":"agent/acp/issue-501-slice","labels":[],"comments":[]}
+]
+JSON
+  exit 0
+fi
+
+if [[ "${1:-}" == "issue" && "${2:-}" == "list" ]]; then
+  cat <<'JSON'
+[
+  {"number":501,"createdAt":"2026-03-15T10:00:00Z","labels":[]},
+  {"number":502,"createdAt":"2026-03-15T10:01:00Z","labels":[]}
+]
+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
+cat <<'OUT'
+KIND=issue
+ITEM_ID=0
+ATTEMPTS=0
+NEXT_ATTEMPT_EPOCH=0
+NEXT_ATTEMPT_AT=
+READY=yes
+LAST_REASON=
+UPDATED_AT=
+OUT
+EOF
+
+chmod +x "$bin_dir/gh" "$tools_dir/retry-state.sh"
+
+export PATH="$bin_dir:$node_bin_dir:/opt/homebrew/bin:/usr/bin:/bin:/usr/sbin:/sbin"
+export F_LOSNING_REPO_SLUG="example/repo"
+export ACP_MANAGED_PR_BRANCH_GLOBS="agent/acp/* codex/* openclaw/*"
+
+# shellcheck source=/dev/null
+source "$HOOKS_FILE"
+FLOW_TOOLS_DIR="$tools_dir"
+REPO_SLUG="example/repo"
+
+open_agent_pr_issue_ids="$(heartbeat_open_agent_pr_issue_ids)"
+ready_issue_ids="$(heartbeat_list_ready_issue_ids)"
+
+grep -q '"501"' <<<"$open_agent_pr_issue_ids"
+grep -q '^502$' <<<"$ready_issue_ids"
+if grep -q '^501$' <<<"$ready_issue_ids"; then
+  echo "issue linked by codex PR branch unexpectedly remained ready" >&2
+  exit 1
+fi
+
+echo "heartbeat codex PR linked issue exclusion test passed"

package/tools/tests/test-heartbeat-hooks-enqueue-resident-issue-for-idle-controller.sh

@@ -0,0 +1,115 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+FLOW_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+REAL_HOOKS="${FLOW_ROOT}/hooks/heartbeat-hooks.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"
+hooks_dir="$skill_root/hooks"
+bin_dir="$skill_root/tools/bin"
+assets_dir="$skill_root/assets"
+profile_registry_root="$tmpdir/profile-registry"
+profile_dir="$profile_registry_root/demo"
+shim_dir="$tmpdir/shim"
+capture_file="$tmpdir/capture.log"
+state_root="$tmpdir/agent/state"
+
+mkdir -p "$hooks_dir" "$bin_dir" "$assets_dir" "$profile_dir" "$shim_dir" "$state_root/resident-workers/issues/440"
+cp "$REAL_HOOKS" "$hooks_dir/heartbeat-hooks.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: "$tmpdir/repo"
+  default_branch: "main"
+runtime:
+  orchestrator_agent_root: "$tmpdir/agent"
+  worktree_root: "$tmpdir/worktrees"
+  agent_repo_root: "$tmpdir/repo"
+  runs_root: "$tmpdir/agent/runs"
+  state_root: "$state_root"
+  retained_repo_root: "$tmpdir/repo"
+  vscode_workspace_file: "$tmpdir/demo.code-workspace"
+execution:
+  coding_worker: "openclaw"
+  resident_workers:
+    issue_reuse_enabled: true
+session_naming:
+  issue_prefix: "demo-issue-"
+  pr_prefix: "demo-pr-"
+  issue_branch_prefix: "agent/demo/issue"
+  pr_worktree_branch_prefix: "agent/demo/pr"
+EOF
+
+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},"title":"Resident issue ${issue_id}","body":"Keep going.","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 >"$bin_dir/agent-project-detached-launch" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+printf '%s\n' "$*" >"${TEST_CAPTURE_FILE:?}"
+printf 'LAUNCH_MODE=detached\n'
+EOF
+chmod +x "$bin_dir/agent-project-detached-launch"
+
+(sleep 30) &
+controller_pid="$!"
+cat >"$state_root/resident-workers/issues/440/controller.env" <<EOF
+ISSUE_ID=440
+CONTROLLER_PID=${controller_pid}
+CONTROLLER_STATE=idle
+EOF
+
+PATH="$shim_dir:$PATH" \
+ACP_PROJECT_ID="demo" \
+ACP_PROFILE_REGISTRY_ROOT="$profile_registry_root" \
+TEST_CAPTURE_FILE="$capture_file" \
+bash -c '
+  set -euo pipefail
+  source "'"$hooks_dir"'/heartbeat-hooks.sh"
+  heartbeat_start_issue_worker 441 >/dev/null
+'
+
+test ! -f "$capture_file"
+queue_file="$state_root/resident-workers/issue-queue/pending/issue-441.env"
+test -f "$queue_file"
+grep -q '^ISSUE_ID=441$' "$queue_file"
+
+echo "heartbeat hooks enqueue resident issue for idle controller test passed"