agent-control-plane 0.1.0

package/tools/tests/test-run-codex-task-provider-pool-fallback-routing.sh

@@ -0,0 +1,146 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+FLOW_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+SOURCE_SCRIPT="${FLOW_ROOT}/tools/bin/run-codex-task.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
+
+workspace_root="$tmpdir/workspace/tools"
+bin_dir="$workspace_root/bin"
+shared_home="$tmpdir/shared-home"
+flow_root="$shared_home/skills/openclaw/agent-control-plane"
+flow_bin_dir="$flow_root/tools/bin"
+flow_assets_dir="$flow_root/assets"
+profile_home="$tmpdir/profiles"
+repo_root="$tmpdir/repo"
+worktree_root="$tmpdir/worktrees"
+agent_root="$tmpdir/agent-root"
+state_root="$agent_root/state"
+session="acp-issue-780"
+prompt_file="$tmpdir/prompt.md"
+capture_file="$tmpdir/capture.log"
+cooldown_file="$state_root/retries/providers/openclaw-primary-model.env"
+
+mkdir -p "$bin_dir" "$flow_bin_dir" "$flow_assets_dir" "$profile_home/demo" "$repo_root" "$worktree_root" "$(dirname "$cooldown_file")"
+printf 'skill root\n' >"$flow_root/SKILL.md"
+printf '{}\n' >"$flow_assets_dir/workflow-catalog.json"
+cp "$SOURCE_SCRIPT" "$bin_dir/run-codex-task.sh"
+cp "$FLOW_CONFIG_LIB" "$bin_dir/flow-config-lib.sh"
+cp "$FLOW_SHELL_LIB" "$bin_dir/flow-shell-lib.sh"
+
+cat >"$profile_home/demo/control-plane.yaml" <<EOF
+id: "demo"
+repo:
+  slug: "example/demo"
+  root: "${repo_root}"
+runtime:
+  orchestrator_agent_root: "${agent_root}"
+  agent_repo_root: "${repo_root}"
+  worktree_root: "${worktree_root}"
+  runs_root: "${agent_root}/runs"
+  state_root: "${state_root}"
+session_naming:
+  issue_prefix: "acp-issue-"
+  pr_prefix: "acp-pr-"
+execution:
+  coding_worker: "openclaw"
+  provider_quota:
+    cooldowns: "300,900"
+  provider_pool_order: "primary fallback"
+  provider_pools:
+    primary:
+      coding_worker: "openclaw"
+      openclaw:
+        model: "primary/model"
+        thinking: "adaptive"
+        timeout_seconds: 321
+    fallback:
+      coding_worker: "claude"
+      claude:
+        model: "fallback-sonnet"
+        permission_mode: "dontAsk"
+        effort: "high"
+        timeout_seconds: 777
+        max_attempts: 5
+        retry_backoff_seconds: 12
+EOF
+
+future_epoch=$(( $(date +%s) + 3600 ))
+cat >"$cooldown_file" <<EOF
+ATTEMPTS=1
+NEXT_ATTEMPT_EPOCH=${future_epoch}
+NEXT_ATTEMPT_AT=2099-01-01T00:00:00Z
+LAST_REASON=provider-quota-limit
+UPDATED_AT=2099-01-01T00:00:00Z
+EOF
+
+git -C "$repo_root" init -b main >/dev/null 2>&1
+git -C "$repo_root" config user.name "Test"
+git -C "$repo_root" config user.email "test@example.com"
+printf 'seed\n' >"$repo_root/README.md"
+git -C "$repo_root" add README.md
+git -C "$repo_root" commit -m "init" >/dev/null 2>&1
+worktree="$worktree_root/issue-780"
+git -C "$repo_root" worktree add -b agent/demo/issue-780 "$worktree" >/dev/null 2>&1
+
+cat >"$flow_bin_dir/agent-project-run-claude-session" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+printf 'RUNNER=claude\n' >"${TEST_CAPTURE_FILE:?}"
+printf '%s\n' "$@" >>"${TEST_CAPTURE_FILE:?}"
+EOF
+
+cat >"$flow_bin_dir/agent-project-run-codex-session" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+printf 'RUNNER=codex\n' >"${TEST_CAPTURE_FILE:?}"
+printf '%s\n' "$@" >>"${TEST_CAPTURE_FILE:?}"
+EOF
+
+cat >"$flow_bin_dir/agent-project-run-openclaw-session" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+printf 'RUNNER=openclaw\n' >"${TEST_CAPTURE_FILE:?}"
+printf '%s\n' "$@" >>"${TEST_CAPTURE_FILE:?}"
+EOF
+
+chmod +x \
+  "$bin_dir/run-codex-task.sh" \
+  "$bin_dir/flow-config-lib.sh" \
+  "$bin_dir/flow-shell-lib.sh" \
+  "$flow_bin_dir/agent-project-run-claude-session" \
+  "$flow_bin_dir/agent-project-run-codex-session" \
+  "$flow_bin_dir/agent-project-run-openclaw-session"
+
+printf 'Prompt\n' >"$prompt_file"
+
+TEST_CAPTURE_FILE="$capture_file" \
+SHARED_AGENT_HOME="$tmpdir/shared-home" \
+ACP_ROOT="$flow_root" \
+ACP_PROFILE_REGISTRY_ROOT="$profile_home" \
+ACP_PROJECT_ID="demo" \
+ACP_AGENT_ROOT="$agent_root" \
+ACP_RUNS_ROOT="$agent_root/runs" \
+ACP_STATE_ROOT="$state_root" \
+ACP_AGENT_REPO_ROOT="$repo_root" \
+ACP_REPO_ROOT="$repo_root" \
+ACP_WORKTREE_ROOT="$worktree_root" \
+ACP_RETAINED_REPO_ROOT="$tmpdir/retained" \
+ACP_ISSUE_ID="780" \
+bash "$bin_dir/run-codex-task.sh" safe "$session" "$worktree" "$prompt_file"
+
+grep -q '^RUNNER=claude$' "$capture_file"
+grep -q -- '--claude-model' "$capture_file"
+grep -q -- 'fallback-sonnet' "$capture_file"
+grep -q -- '--claude-permission-mode' "$capture_file"
+grep -q -- 'dontAsk' "$capture_file"
+grep -q -- '--claude-effort' "$capture_file"
+grep -q -- 'high' "$capture_file"
+grep -q -- '--claude-timeout-seconds' "$capture_file"
+grep -q -- '777' "$capture_file"
+
+echo "run-codex-task provider pool fallback routing test passed"

package/tools/tests/test-scaffold-profile.sh

@@ -0,0 +1,108 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+FLOW_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+SCAFFOLD_SCRIPT="${FLOW_ROOT}/tools/bin/scaffold-profile.sh"
+RENDER_SCRIPT="${FLOW_ROOT}/tools/bin/render-flow-config.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
+
+skill_root="$tmpdir/skill"
+profile_home="$tmpdir/.agent-control-plane/profiles"
+tools_bin_dir="$skill_root/tools/bin"
+templates_dir="$skill_root/tools/templates"
+assets_dir="$skill_root/assets"
+
+mkdir -p "$tools_bin_dir" "$templates_dir" "$assets_dir"
+cp "$SCAFFOLD_SCRIPT" "$tools_bin_dir/scaffold-profile.sh"
+cp "$RENDER_SCRIPT" "$tools_bin_dir/render-flow-config.sh"
+cp "$FLOW_CONFIG_LIB" "$tools_bin_dir/flow-config-lib.sh"
+cp "$FLOW_SHELL_LIB" "$tools_bin_dir/flow-shell-lib.sh"
+printf '{}\n' >"$assets_dir/workflow-catalog.json"
+cp "$FLOW_ROOT/tools/templates/issue-prompt-template.md" "$templates_dir/issue-prompt-template.md"
+cp "$FLOW_ROOT/tools/templates/scheduled-issue-prompt-template.md" "$templates_dir/scheduled-issue-prompt-template.md"
+cp "$FLOW_ROOT/tools/templates/pr-fix-template.md" "$templates_dir/pr-fix-template.md"
+cp "$FLOW_ROOT/tools/templates/pr-review-template.md" "$templates_dir/pr-review-template.md"
+cp "$FLOW_ROOT/tools/templates/pr-merge-repair-template.md" "$templates_dir/pr-merge-repair-template.md"
+
+output="$(
+  ACP_PROFILE_REGISTRY_ROOT="$profile_home" \
+  bash "$tools_bin_dir/scaffold-profile.sh" \
+    --profile-id alpha-demo \
+    --repo-slug acme/alpha-demo
+)"
+
+profile_yaml="$profile_home/alpha-demo/control-plane.yaml"
+profile_template_dir="$profile_home/alpha-demo/templates"
+profile_readme="$profile_home/alpha-demo/README.md"
+profile_home_real="$(mkdir -p "$profile_home" && cd "$profile_home" && pwd -P)"
+profile_yaml_real="$(cd "$(dirname "$profile_yaml")" && pwd -P)/$(basename "$profile_yaml")"
+profile_template_dir_real="$(cd "$profile_template_dir" && pwd -P)"
+profile_readme_real="$(cd "$(dirname "$profile_readme")" && pwd -P)/$(basename "$profile_readme")"
+
+test -f "$profile_yaml"
+test -f "$profile_template_dir/issue-prompt-template.md"
+test -f "$profile_readme"
+test -f "$profile_template_dir/pr-review-template.md"
+cmp -s "$templates_dir/issue-prompt-template.md" "$profile_template_dir/issue-prompt-template.md"
+grep -q '^PROFILE_ID=alpha-demo$' <<<"$output"
+grep -q "^PROFILE_HOME=${profile_home_real}$" <<<"$output"
+grep -q "^PROFILE_YAML=${profile_yaml_real}$" <<<"$output"
+grep -q "^PROFILE_TEMPLATE_DIR=${profile_template_dir_real}$" <<<"$output"
+grep -q "^PROFILE_README=${profile_readme_real}$" <<<"$output"
+grep -q '^REPO_SLUG=acme/alpha-demo$' <<<"$output"
+grep -q '^  slug: "acme/alpha-demo"$' "$profile_yaml"
+grep -q '^  issue_prefix: "alpha-demo-issue-"$' "$profile_yaml"
+grep -q '^  pr_prefix: "alpha-demo-pr-"$' "$profile_yaml"
+grep -q '^  issue_branch_prefix: "agent/alpha-demo/issue"$' "$profile_yaml"
+grep -q '^  pr_worktree_branch_prefix: "agent/alpha-demo/pr"$' "$profile_yaml"
+grep -q '^  coding_worker: "openclaw"$' "$profile_yaml"
+grep -q '^  provider_quota:$' "$profile_yaml"
+grep -q '^    cooldowns: "300,900,1800,3600"$' "$profile_yaml"
+grep -q '^    model: "openrouter/stepfun/step-3.5-flash:free"$' "$profile_yaml"
+grep -q '^# alpha-demo Profile Notes$' "$profile_readme"
+grep -q '^## Startup Checklist$' "$profile_readme"
+
+render_output="$(
+  ACP_PROFILE_REGISTRY_ROOT="$profile_home" \
+  ACP_PROJECT_ID="alpha-demo" \
+  bash "$tools_bin_dir/render-flow-config.sh"
+)"
+
+grep -q "^CONFIG_YAML=${profile_yaml}$" <<<"$render_output"
+grep -q '^PROFILE_ID=alpha-demo$' <<<"$render_output"
+grep -Eq '^AVAILABLE_PROFILES=alpha-demo$' <<<"$render_output"
+grep -q '^EFFECTIVE_REPO_ROOT=/tmp/agent-control-plane-alpha-demo/repo$' <<<"$render_output"
+grep -q '^EFFECTIVE_CODING_WORKER=openclaw$' <<<"$render_output"
+grep -q '^EFFECTIVE_PROVIDER_QUOTA_COOLDOWNS=300,900,1800,3600$' <<<"$render_output"
+grep -q '^EFFECTIVE_OPENCLAW_MODEL=openrouter/stepfun/step-3.5-flash:free$' <<<"$render_output"
+
+claude_output="$(
+  ACP_PROFILE_REGISTRY_ROOT="$profile_home" \
+  bash "$tools_bin_dir/scaffold-profile.sh" \
+    --profile-id claude-demo \
+    --repo-slug acme/claude-demo \
+    --coding-worker claude \
+    --claude-model opus \
+    --claude-permission-mode bypassPermissions \
+    --claude-effort max \
+    --claude-timeout-seconds 321 \
+    --claude-max-attempts 4 \
+    --claude-retry-backoff-seconds 9
+)"
+
+claude_yaml="$profile_home/claude-demo/control-plane.yaml"
+test -f "$claude_yaml"
+grep -q '^PROFILE_ID=claude-demo$' <<<"$claude_output"
+grep -q '^  coding_worker: "claude"$' "$claude_yaml"
+grep -q '^    model: "opus"$' "$claude_yaml"
+grep -q '^    permission_mode: "bypassPermissions"$' "$claude_yaml"
+grep -q '^    effort: "max"$' "$claude_yaml"
+grep -q '^    timeout_seconds: 321$' "$claude_yaml"
+grep -q '^    max_attempts: 4$' "$claude_yaml"
+grep -q '^    retry_backoff_seconds: 9$' "$claude_yaml"
+
+echo "scaffold profile test passed"

package/tools/tests/test-serve-dashboard.sh

@@ -0,0 +1,93 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+FLOW_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+SERVER_BIN="${FLOW_ROOT}/tools/bin/serve-dashboard.sh"
+
+tmpdir="$(mktemp -d)"
+server_pid=""
+cleanup() {
+  if [[ -n "${server_pid}" ]]; then
+    kill "${server_pid}" >/dev/null 2>&1 || true
+    wait "${server_pid}" >/dev/null 2>&1 || true
+  fi
+  rm -rf "$tmpdir"
+}
+trap cleanup EXIT
+
+profile_registry_root="$tmpdir/profiles"
+profile_dir="$profile_registry_root/demo"
+runs_root="$tmpdir/runtime/demo/runs"
+state_root="$tmpdir/runtime/demo/state"
+run_dir="$runs_root/demo-issue-1"
+port="18765"
+
+mkdir -p "$profile_dir" "$run_dir" "$state_root"
+
+cat >"$profile_dir/control-plane.yaml" <<EOF
+schema_version: "1"
+id: "demo"
+repo:
+  slug: "example/demo-dashboard"
+  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"
+session_naming:
+  issue_prefix: "demo-issue-"
+  pr_prefix: "demo-pr-"
+execution:
+  coding_worker: "openclaw"
+  openclaw:
+    model: "primary/model"
+    thinking: "adaptive"
+    timeout_seconds: 900
+EOF
+
+cat >"$run_dir/run.env" <<'EOF'
+TASK_KIND=issue
+TASK_ID=1
+SESSION=demo-issue-1
+MODE=safe
+STARTED_AT=2026-03-26T15:00:00Z
+CODING_WORKER=openclaw
+EOF
+
+cat >"$run_dir/runner.env" <<'EOF'
+RUNNER_STATE=succeeded
+THREAD_ID=thread-demo-1
+LAST_EXIT_CODE=0
+UPDATED_AT=2026-03-26T15:01:00Z
+EOF
+
+cat >"$run_dir/result.env" <<'EOF'
+OUTCOME=implemented
+ACTION=host-publish-issue-pr
+EOF
+
+bash "$SERVER_BIN" --host 127.0.0.1 --port "$port" --registry-root "$profile_registry_root" >"$tmpdir/server.log" 2>&1 &
+server_pid="$!"
+
+for _ in 1 2 3 4 5 6 7 8 9 10; do
+  if curl -fsS "http://127.0.0.1:${port}/api/snapshot.json" >/dev/null 2>&1; then
+    break
+  fi
+  sleep 1
+done
+
+snapshot="$(curl -fsS "http://127.0.0.1:${port}/api/snapshot.json")"
+html="$(curl -fsS "http://127.0.0.1:${port}/")"
+
+grep -q '"profile_count": 1' <<<"$snapshot"
+grep -q '"id": "demo"' <<<"$snapshot"
+grep -q 'ACP Worker Dashboard' <<<"$html"
+grep -q 'Lifecycle shows whether a worker session finished cleanly' <<<"$html"
+
+echo "serve dashboard test passed"

package/tools/tests/test-start-issue-worker-blocked-context.sh

@@ -0,0 +1,129 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+FLOW_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+REAL_WORKER="${FLOW_ROOT}/tools/bin/start-issue-worker.sh"
+REAL_POLICY_BIN="${FLOW_ROOT}/tools/bin/issue-requires-local-workspace-install.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
+
+workspace="$tmpdir/workspace"
+bin_dir="$workspace/bin"
+templates_dir="$workspace/templates"
+shim_dir="$tmpdir/shim"
+agent_root="$tmpdir/agent"
+
+mkdir -p "$bin_dir" "$templates_dir" "$shim_dir" "$agent_root"
+ln -s "$REAL_WORKER" "$bin_dir/start-issue-worker.sh"
+ln -s "$REAL_POLICY_BIN" "$bin_dir/issue-requires-local-workspace-install.sh"
+ln -s "$REAL_CONFIG_LIB" "$bin_dir/flow-config-lib.sh"
+ln -s "$REAL_SHELL_LIB" "$bin_dir/flow-shell-lib.sh"
+ln -s "$REAL_RESIDENT_LIB" "$bin_dir/flow-resident-worker-lib.sh"
+
+cat >"$templates_dir/issue-prompt-template.md" <<'EOF'
+Issue {ISSUE_ID}: {ISSUE_TITLE}
+{ISSUE_BLOCKER_CONTEXT}
+EOF
+
+cat >"$templates_dir/scheduled-issue-prompt-template.md" <<'EOF'
+Scheduled issue {ISSUE_ID}: {ISSUE_TITLE}
+{ISSUE_BLOCKER_CONTEXT}
+EOF
+
+cat >"$shim_dir/tmux" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+if [[ "${1:-}" == "has-session" ]]; then
+  exit 1
+fi
+exit 0
+EOF
+chmod +x "$shim_dir/tmux"
+
+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":"Blocked issue ${issue_id}","body":"Investigate blocked issue.","url":"https://example.test/issues/${issue_id}","labels":[{"name":"agent-blocked"}],"comments":[{"body":"Host-side publish blocked for session \`fl-issue-${issue_id}\`.\n\n\`\`\`text\nScope guard blocked issue #${issue_id} from publishing as a single PR.\n\`\`\`","createdAt":"2026-03-15T10:00:00Z"}]}
+JSON
+  exit 0
+fi
+if [[ "${1:-}" == "issue" && "${2:-}" == "comment" ]]; then
+  exit 0
+fi
+exit 64
+EOF
+chmod +x "$shim_dir/gh"
+
+cat >"$bin_dir/retry-state.sh" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+cat <<'OUT'
+KIND=issue
+ITEM_ID=555
+ATTEMPTS=3
+NEXT_ATTEMPT_EPOCH=0
+NEXT_ATTEMPT_AT=2026-03-15T11:00:00Z
+LAST_REASON=scope-guard-blocked
+UPDATED_AT=2026-03-15T10:55:00Z
+OUT
+EOF
+chmod +x "$bin_dir/retry-state.sh"
+
+cat >"$bin_dir/new-worktree.sh" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+issue_id="${1:?issue id required}"
+capture_dir="${TEST_CAPTURE_DIR:?}"
+mkdir -p "$capture_dir"
+worktree="$capture_dir/worktree-${issue_id}"
+mkdir -p "$worktree"
+if [[ ! -d "$worktree/.git" ]]; then
+  git -C "$worktree" init -b main >/dev/null 2>&1
+  git -C "$worktree" config user.name "Codex"
+  git -C "$worktree" config user.email "codex@example.com"
+  printf 'stub\n' >"$worktree/README.md"
+  git -C "$worktree" add README.md
+  git -C "$worktree" commit -m "init" >/dev/null 2>&1
+fi
+printf 'WORKTREE=%s\n' "$worktree"
+printf 'BRANCH=agent/alpha/issue-%s-test\n' "$issue_id"
+EOF
+chmod +x "$bin_dir/new-worktree.sh"
+
+cat >"$bin_dir/run-codex-safe.sh" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+exit 0
+EOF
+chmod +x "$bin_dir/run-codex-safe.sh"
+
+capture_dir="$tmpdir/case-blocked"
+mkdir -p "$capture_dir"
+
+TEST_CAPTURE_DIR="$capture_dir" \
+ACP_ROOT="$FLOW_ROOT" \
+ACP_PROJECT_ID="alpha" \
+ACP_AGENT_ROOT="$agent_root" \
+ACP_RUNS_ROOT="$agent_root/runs" \
+ACP_HISTORY_ROOT="$agent_root/history" \
+PATH="$shim_dir:$PATH" \
+bash "$bin_dir/start-issue-worker.sh" 555 >/dev/null
+
+prompt_file="$(find "$agent_root/runs" -maxdepth 2 -name prompt.md | head -n 1)"
+test -n "$prompt_file"
+
+grep -q '## Prior Blocker Context' "$prompt_file"
+grep -q 'This issue is being retried after an `agent-blocked` stop.' "$prompt_file"
+grep -q 'Scope guard blocked issue #555 from publishing as a single PR.' "$prompt_file"
+grep -q 'Last recorded blocker: `scope-guard-blocked`.' "$prompt_file"
+grep -q 'Blocked retries so far: 3.' "$prompt_file"
+grep -q 'create-follow-up-issue.sh' "$prompt_file"
+
+echo "start issue worker blocked-context test passed"

package/tools/tests/test-start-issue-worker-blocks-complete-recurring-checklist.sh

@@ -0,0 +1,189 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+FLOW_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+REAL_WORKER="${FLOW_ROOT}/tools/bin/start-issue-worker.sh"
+REAL_POLICY_BIN="${FLOW_ROOT}/tools/bin/issue-requires-local-workspace-install.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"
+templates_dir="$skill_root/tools/templates"
+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" "$templates_dir" "$assets_dir" "$profile_dir" "$shim_dir" "$agent_root" "$repo_root" "$capture_dir"
+cp "$REAL_WORKER" "$bin_dir/start-issue-worker.sh"
+cp "$REAL_POLICY_BIN" "$bin_dir/issue-requires-local-workspace-install.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 >"$templates_dir/issue-prompt-template.md" <<'EOF'
+Issue {ISSUE_ID}: {ISSUE_TITLE}
+EOF
+
+cat >"$templates_dir/scheduled-issue-prompt-template.md" <<'EOF'
+Scheduled issue {ISSUE_ID}: {ISSUE_TITLE}
+EOF
+
+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-"
+  issue_branch_prefix: "agent/demo/issue"
+  pr_worktree_branch_prefix: "agent/demo/pr"
+  managed_pr_branch_globs: "agent/demo/*"
+execution:
+  coding_worker: "codex"
+  resident_workers:
+    issue_reuse_enabled: true
+    issue_max_tasks_per_worker: 12
+    issue_max_age_seconds: 86400
+EOF
+
+git -C "$repo_root" init -b main >/dev/null 2>&1
+git -C "$repo_root" config user.name "Resident"
+git -C "$repo_root" config user.email "resident@example.com"
+printf 'seed\n' >"$repo_root/README.md"
+git -C "$repo_root" add README.md
+git -C "$repo_root" commit -m "init" >/dev/null 2>&1
+
+cat >"$shim_dir/tmux" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+if [[ "${1:-}" == "has-session" ]]; then
+  exit 1
+fi
+exit 0
+EOF
+chmod +x "$shim_dir/tmux"
+
+cat >"$shim_dir/gh" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+
+capture_dir="${TEST_CAPTURE_DIR:?}"
+
+if [[ "${1:-}" == "issue" && "${2:-}" == "view" ]]; then
+  issue_id="${3:-0}"
+  cat <<JSON
+{"number":${issue_id},"title":"Recurring issue ${issue_id}","body":"Keep it moving.\n\nChecklist:\n- [x] Ship the first improvement.\n- [x] Ship the second improvement.\n","url":"https://example.test/issues/${issue_id}","labels":[{"name":"agent-keep-open"}],"comments":[]}
+JSON
+  exit 0
+fi
+
+if [[ "${1:-}" == "api" ]]; then
+  shift
+  route="${1:-}"
+  shift || true
+  method="GET"
+  body=""
+  while [[ $# -gt 0 ]]; do
+    case "$1" in
+      --method)
+        method="${2:-GET}"
+        shift 2
+        ;;
+      -f|--field|--raw-field)
+        field="${2:-}"
+        if [[ "$field" == body=* ]]; then
+          body="${field#body=}"
+        fi
+        shift 2
+        ;;
+      *)
+        shift
+        ;;
+    esac
+  done
+
+  if [[ "$method" == "POST" && "$route" == *"/issues/"*"/comments" ]]; then
+    printf '%s' "$body" >"$capture_dir/comment.md"
+    exit 0
+  fi
+fi
+
+exit 64
+EOF
+chmod +x "$shim_dir/gh"
+
+cat >"$bin_dir/agent-github-update-labels" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+printf '%s\n' "$*" >>"${TEST_CAPTURE_DIR:?}/labels.log"
+EOF
+chmod +x "$bin_dir/agent-github-update-labels"
+
+cat >"$bin_dir/sync-recurring-issue-checklist.sh" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+printf '%s\n' "$*" >"${TEST_CAPTURE_DIR:?}/sync.log"
+cat <<OUT
+STATUS=updated
+CHECKLIST_TOTAL=2
+CHECKLIST_UNCHECKED=0
+CHECKLIST_MATCHED_PR_NUMBERS=11,12
+OUT
+EOF
+chmod +x "$bin_dir/sync-recurring-issue-checklist.sh"
+
+cat >"$bin_dir/new-worktree.sh" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+echo "new-worktree should not run" >&2
+exit 99
+EOF
+chmod +x "$bin_dir/new-worktree.sh"
+
+cat >"$bin_dir/run-codex-safe.sh" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+echo "run-codex-safe should not run" >&2
+exit 99
+EOF
+chmod +x "$bin_dir/run-codex-safe.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-issue-worker.sh" 42 >/dev/null
+
+run_dir="$agent_root/runs/demo-issue-42"
+
+test ! -d "$run_dir"
+test -f "$capture_dir/sync.log"
+grep -q -- '--repo-slug example/demo --issue-id 42' "$capture_dir/sync.log"
+test -f "$capture_dir/comment.md"
+grep -q '^# Blocker: All checklist items already completed$' "$capture_dir/comment.md"
+grep -q '^Recently matched PRs: #11, #12$' "$capture_dir/comment.md"
+grep -q -- '--repo-slug example/demo --number 42 --add agent-blocked --remove agent-running' "$capture_dir/labels.log"
+
+echo "start issue worker blocks completed recurring checklist test passed"