agent-control-plane 0.1.0

package/tools/tests/test-agent-project-publish-issue-pr-prunes-stale-worktree-entry.sh

@@ -0,0 +1,148 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+FLOW_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+SOURCE_SCRIPT="${FLOW_ROOT}/tools/bin/agent-project-publish-issue-pr"
+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_bin_dir="$tmpdir/workspace/bin"
+shared_home="$tmpdir/shared-home"
+flow_root="$shared_home/skills/openclaw/agent-control-plane"
+flow_assets_dir="$flow_root/assets"
+profile_registry_root="$tmpdir/profile-registry"
+flow_profiles_dir="$profile_registry_root/demo"
+repo_root="$tmpdir/repo"
+origin_root="$tmpdir/origin.git"
+worktree_root="$tmpdir/worktrees"
+runs_root="$tmpdir/runs"
+history_root="$tmpdir/history"
+session="demo-issue-11"
+archive_dir="$history_root/${session}-20260326-000000"
+bin_dir="$tmpdir/bin"
+shared_bin="$tmpdir/tools/bin"
+
+mkdir -p "$workspace_bin_dir" "$flow_assets_dir" "$flow_profiles_dir" "$repo_root" "$worktree_root" "$runs_root" "$history_root" "$bin_dir" "$shared_bin" "$archive_dir"
+cp "$SOURCE_SCRIPT" "$workspace_bin_dir/agent-project-publish-issue-pr"
+cp "$FLOW_CONFIG_LIB" "$workspace_bin_dir/flow-config-lib.sh"
+cp "$FLOW_SHELL_LIB" "$workspace_bin_dir/flow-shell-lib.sh"
+printf 'skill root\n' >"$flow_root/SKILL.md"
+printf '{}\n' >"$flow_assets_dir/workflow-catalog.json"
+
+cat >"$flow_profiles_dir/control-plane.yaml" <<EOF_PROFILE
+id: "demo"
+repo:
+  slug: "example/repo"
+  root: "$repo_root"
+  default_branch: "main"
+runtime:
+  orchestrator_agent_root: "$tmpdir/agent-root"
+  agent_repo_root: "$repo_root"
+  worktree_root: "$worktree_root"
+  runs_root: "$runs_root"
+  history_root: "$history_root"
+EOF_PROFILE
+
+cat >"$shared_bin/agent-project-worker-status" <<EOF_STATUS
+#!/usr/bin/env bash
+set -euo pipefail
+printf 'SESSION=%s\n' "$session"
+printf 'STATUS=UNKNOWN\n'
+EOF_STATUS
+
+cat >"$shared_bin/issue-publish-scope-guard.sh" <<'EOF_SCOPE'
+#!/usr/bin/env bash
+set -euo pipefail
+exit 0
+EOF_SCOPE
+
+cat >"$shared_bin/branch-verification-guard.sh" <<'EOF_VERIFY'
+#!/usr/bin/env bash
+set -euo pipefail
+exit 0
+EOF_VERIFY
+
+cat >"$bin_dir/gh" <<'EOF_GH'
+#!/usr/bin/env bash
+set -euo pipefail
+
+case "${1:-}:${2:-}" in
+  issue:view)
+    printf '{"title":"Stale worktree issue","url":"https://github.com/example/repo/issues/11","labels":[]}'
+    ;;
+  pr:list)
+    printf '[]\n'
+    ;;
+  api:user)
+    printf 'tester\n'
+    ;;
+  *)
+    echo "unexpected gh invocation: $*" >&2
+    exit 1
+    ;;
+esac
+EOF_GH
+
+chmod +x \
+  "$workspace_bin_dir/agent-project-publish-issue-pr" \
+  "$workspace_bin_dir/flow-config-lib.sh" \
+  "$workspace_bin_dir/flow-shell-lib.sh" \
+  "$shared_bin/agent-project-worker-status" \
+  "$shared_bin/issue-publish-scope-guard.sh" \
+  "$shared_bin/branch-verification-guard.sh" \
+  "$bin_dir/gh"
+
+git init --bare "$origin_root" >/dev/null 2>&1
+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
+git -C "$repo_root" remote add origin "$origin_root"
+git -C "$repo_root" push -u origin main >/dev/null 2>&1
+
+branch_name="agent/demo/issue-11-stale-worktree"
+git -C "$repo_root" checkout -b "$branch_name" >/dev/null 2>&1
+printf 'stale\n' >>"$repo_root/README.md"
+git -C "$repo_root" add README.md
+git -C "$repo_root" commit -m "feat: stale worktree recovery" >/dev/null 2>&1
+final_head="$(git -C "$repo_root" rev-parse HEAD)"
+git -C "$repo_root" checkout main >/dev/null 2>&1
+
+stale_worktree="$worktree_root/stale"
+git -C "$repo_root" worktree add "$stale_worktree" "$branch_name" >/dev/null 2>&1 || true
+rm -rf "$stale_worktree"
+
+cat >"$archive_dir/run.env" <<EOF_RUN
+ISSUE_ID=11
+BRANCH=$branch_name
+WORKTREE=$stale_worktree
+FINAL_HEAD=$final_head
+EOF_RUN
+
+printf '{"status":"pass","command":"npm test"}\n' >"$archive_dir/verification.jsonl"
+
+output="$(PATH="$bin_dir:/opt/homebrew/bin:/usr/bin:/bin:/usr/sbin:/sbin" \
+  SHARED_AGENT_HOME="$shared_home" \
+  ACP_ROOT="$flow_root" \
+  ACP_PROFILE_REGISTRY_ROOT="$profile_registry_root" \
+  ACP_PROJECT_ID="demo" \
+  AGENT_PROJECT_ID="demo" \
+  AGENT_CONTROL_PLANE_CONFIG="$flow_profiles_dir/control-plane.yaml" \
+  ACP_CONFIG="$flow_profiles_dir/control-plane.yaml" \
+  bash "$workspace_bin_dir/agent-project-publish-issue-pr" \
+    --repo-slug example/repo \
+    --runs-root "$runs_root" \
+    --history-root "$history_root" \
+    --session "$session" \
+    --dry-run 2>&1)"
+
+grep -q '^PUBLISH_STATUS=would-create-pr$' <<<"$output"
+grep -q 'WORKTREE_RECOVERY=created' <<<"$output"
+grep -q '^PR_TITLE=feat: stale worktree recovery$' <<<"$output"
+
+echo "agent-project publish issue PR prunes stale worktree entry test passed"

package/tools/tests/test-agent-project-publish-issue-pr-reads-archived-session.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/agent-project-publish-issue-pr"
+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_bin_dir="$tmpdir/workspace/bin"
+shared_home="$tmpdir/shared-home"
+flow_root="$shared_home/skills/openclaw/agent-control-plane"
+flow_assets_dir="$flow_root/assets"
+profile_registry_root="$tmpdir/profile-registry"
+flow_profiles_dir="$profile_registry_root/demo"
+repo_root="$tmpdir/repo"
+origin_root="$tmpdir/origin.git"
+worktree_root="$tmpdir/worktrees"
+runs_root="$tmpdir/runs"
+history_root="$tmpdir/history"
+session="demo-issue-8"
+archive_dir="$history_root/${session}-20260326-000000"
+bin_dir="$tmpdir/bin"
+shared_bin="$tmpdir/tools/bin"
+
+mkdir -p "$workspace_bin_dir" "$flow_assets_dir" "$flow_profiles_dir" "$repo_root" "$worktree_root" "$runs_root" "$history_root" "$bin_dir" "$shared_bin" "$archive_dir"
+cp "$SOURCE_SCRIPT" "$workspace_bin_dir/agent-project-publish-issue-pr"
+cp "$FLOW_CONFIG_LIB" "$workspace_bin_dir/flow-config-lib.sh"
+cp "$FLOW_SHELL_LIB" "$workspace_bin_dir/flow-shell-lib.sh"
+printf 'skill root\n' >"$flow_root/SKILL.md"
+printf '{}\n' >"$flow_assets_dir/workflow-catalog.json"
+
+cat >"$flow_profiles_dir/control-plane.yaml" <<EOF_PROFILE
+id: "demo"
+repo:
+  slug: "example/repo"
+  root: "$repo_root"
+  default_branch: "main"
+runtime:
+  orchestrator_agent_root: "$tmpdir/agent-root"
+  agent_repo_root: "$repo_root"
+  worktree_root: "$worktree_root"
+  runs_root: "$runs_root"
+  history_root: "$history_root"
+EOF_PROFILE
+
+cat >"$shared_bin/agent-project-worker-status" <<EOF_STATUS
+#!/usr/bin/env bash
+set -euo pipefail
+printf 'SESSION=%s\n' "$session"
+printf 'STATUS=UNKNOWN\n'
+EOF_STATUS
+
+cat >"$shared_bin/issue-publish-scope-guard.sh" <<'EOF_SCOPE'
+#!/usr/bin/env bash
+set -euo pipefail
+exit 0
+EOF_SCOPE
+
+cat >"$shared_bin/branch-verification-guard.sh" <<'EOF_VERIFY'
+#!/usr/bin/env bash
+set -euo pipefail
+exit 0
+EOF_VERIFY
+
+cat >"$bin_dir/gh" <<'EOF_GH'
+#!/usr/bin/env bash
+set -euo pipefail
+
+case "${1:-}:${2:-}" in
+  issue:view)
+    printf '{"title":"Archived issue","url":"https://github.com/example/repo/issues/8","labels":[]}'
+    ;;
+  pr:list)
+    printf '[]\n'
+    ;;
+  api:user)
+    printf 'tester\n'
+    ;;
+  *)
+    echo "unexpected gh invocation: $*" >&2
+    exit 1
+    ;;
+esac
+EOF_GH
+
+chmod +x \
+  "$workspace_bin_dir/agent-project-publish-issue-pr" \
+  "$workspace_bin_dir/flow-config-lib.sh" \
+  "$workspace_bin_dir/flow-shell-lib.sh" \
+  "$shared_bin/agent-project-worker-status" \
+  "$shared_bin/issue-publish-scope-guard.sh" \
+  "$shared_bin/branch-verification-guard.sh" \
+  "$bin_dir/gh"
+
+git init --bare "$origin_root" >/dev/null 2>&1
+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
+git -C "$repo_root" remote add origin "$origin_root"
+git -C "$repo_root" push -u origin main >/dev/null 2>&1
+
+git -C "$repo_root" checkout -b temp-recovery >/dev/null 2>&1
+printf 'archived\n' >>"$repo_root/README.md"
+git -C "$repo_root" add README.md
+git -C "$repo_root" commit -m "feat: archived recovery commit" >/dev/null 2>&1
+final_head="$(git -C "$repo_root" rev-parse HEAD)"
+git -C "$repo_root" checkout main >/dev/null 2>&1
+git -C "$repo_root" branch -D temp-recovery >/dev/null 2>&1
+
+cat >"$archive_dir/run.env" <<EOF_RUN
+ISSUE_ID=8
+BRANCH=agent/demo/issue-8-archived-recovery
+WORKTREE=$tmpdir/missing-worktree
+FINAL_HEAD=$final_head
+EOF_RUN
+
+printf '{"status":"pass","command":"npm test"}\n' >"$archive_dir/verification.jsonl"
+
+output="$(PATH="$bin_dir:/opt/homebrew/bin:/usr/bin:/bin:/usr/sbin:/sbin" \
+  SHARED_AGENT_HOME="$shared_home" \
+  ACP_ROOT="$flow_root" \
+  ACP_PROFILE_REGISTRY_ROOT="$profile_registry_root" \
+  ACP_PROJECT_ID="demo" \
+  AGENT_PROJECT_ID="demo" \
+  AGENT_CONTROL_PLANE_CONFIG="$flow_profiles_dir/control-plane.yaml" \
+  ACP_CONFIG="$flow_profiles_dir/control-plane.yaml" \
+  bash "$workspace_bin_dir/agent-project-publish-issue-pr" \
+    --repo-slug example/repo \
+    --runs-root "$runs_root" \
+    --history-root "$history_root" \
+    --session "$session" \
+    --dry-run 2>&1)"
+
+grep -q '^PUBLISH_STATUS=would-create-pr$' <<<"$output"
+grep -q '^BRANCH=agent/demo/issue-8-archived-recovery$' <<<"$output"
+grep -q 'BRANCH_RECOVERY=from-final-head' <<<"$output"
+git -C "$repo_root" rev-parse --verify agent/demo/issue-8-archived-recovery >/dev/null 2>&1
+grep -q '^PR_TITLE=feat: archived recovery commit$' <<<"$output"
+
+echo "agent-project publish issue PR archived session fallback test passed"

package/tools/tests/test-agent-project-publish-issue-pr-recovers-final-head.sh

@@ -0,0 +1,145 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+FLOW_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+SOURCE_SCRIPT="${FLOW_ROOT}/tools/bin/agent-project-publish-issue-pr"
+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_bin_dir="$tmpdir/workspace/bin"
+shared_home="$tmpdir/shared-home"
+flow_root="$shared_home/skills/openclaw/agent-control-plane"
+flow_assets_dir="$flow_root/assets"
+profile_registry_root="$tmpdir/profile-registry"
+flow_profiles_dir="$profile_registry_root/demo"
+flow_tools_dir="$flow_root/tools/bin"
+repo_root="$tmpdir/repo"
+origin_root="$tmpdir/origin.git"
+worktree_root="$tmpdir/worktrees"
+runs_root="$tmpdir/runs"
+session="demo-issue-7"
+run_dir="$runs_root/$session"
+bin_dir="$tmpdir/bin"
+shared_bin="$tmpdir/tools/bin"
+
+mkdir -p "$workspace_bin_dir" "$flow_assets_dir" "$flow_profiles_dir" "$flow_tools_dir" "$repo_root" "$worktree_root" "$run_dir" "$bin_dir" "$shared_bin"
+cp "$SOURCE_SCRIPT" "$workspace_bin_dir/agent-project-publish-issue-pr"
+cp "$FLOW_CONFIG_LIB" "$workspace_bin_dir/flow-config-lib.sh"
+cp "$FLOW_SHELL_LIB" "$workspace_bin_dir/flow-shell-lib.sh"
+printf 'skill root\n' >"$flow_root/SKILL.md"
+printf '{}\n' >"$flow_assets_dir/workflow-catalog.json"
+
+cat >"$flow_profiles_dir/control-plane.yaml" <<EOF_PROFILE
+id: "demo"
+repo:
+  slug: "example/repo"
+  root: "$repo_root"
+  default_branch: "main"
+runtime:
+  orchestrator_agent_root: "$tmpdir/agent-root"
+  agent_repo_root: "$repo_root"
+  worktree_root: "$worktree_root"
+  runs_root: "$runs_root"
+EOF_PROFILE
+
+cat >"$shared_bin/agent-project-worker-status" <<EOF_STATUS
+#!/usr/bin/env bash
+set -euo pipefail
+printf 'SESSION=%s\n' "${session}"
+printf 'STATUS=SUCCEEDED\n'
+printf 'META_FILE=%s\n' "$run_dir/run.env"
+EOF_STATUS
+
+cat >"$shared_bin/issue-publish-scope-guard.sh" <<'EOF_SCOPE'
+#!/usr/bin/env bash
+set -euo pipefail
+exit 0
+EOF_SCOPE
+
+cat >"$shared_bin/branch-verification-guard.sh" <<'EOF_VERIFY'
+#!/usr/bin/env bash
+set -euo pipefail
+exit 0
+EOF_VERIFY
+
+cat >"$bin_dir/gh" <<'EOF_GH'
+#!/usr/bin/env bash
+set -euo pipefail
+
+case "${1:-}:${2:-}" in
+  issue:view)
+    printf '{"title":"Demo issue","url":"https://github.com/example/repo/issues/7","labels":[]}'
+    ;;
+  pr:list)
+    printf '[]\n'
+    ;;
+  api:user)
+    printf 'tester\n'
+    ;;
+  *)
+    echo "unexpected gh invocation: $*" >&2
+    exit 1
+    ;;
+esac
+EOF_GH
+
+chmod +x \
+  "$workspace_bin_dir/agent-project-publish-issue-pr" \
+  "$workspace_bin_dir/flow-config-lib.sh" \
+  "$workspace_bin_dir/flow-shell-lib.sh" \
+  "$shared_bin/agent-project-worker-status" \
+  "$shared_bin/issue-publish-scope-guard.sh" \
+  "$shared_bin/branch-verification-guard.sh" \
+  "$bin_dir/gh"
+
+git init --bare "$origin_root" >/dev/null 2>&1
+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
+git -C "$repo_root" remote add origin "$origin_root"
+git -C "$repo_root" push -u origin main >/dev/null 2>&1
+
+git -C "$repo_root" checkout -b temp-recovery >/dev/null 2>&1
+printf 'compact\n' >>"$repo_root/README.md"
+git -C "$repo_root" add README.md
+git -C "$repo_root" commit -m "feat: recovery commit" >/dev/null 2>&1
+final_head="$(git -C "$repo_root" rev-parse HEAD)"
+git -C "$repo_root" checkout main >/dev/null 2>&1
+git -C "$repo_root" branch -D temp-recovery >/dev/null 2>&1
+
+cat >"$run_dir/run.env" <<EOF_RUN
+ISSUE_ID=7
+BRANCH=agent/demo/issue-7-recovery
+WORKTREE=$tmpdir/missing-worktree
+FINAL_HEAD=$final_head
+EOF_RUN
+
+printf '{"status":"pass","command":"npm test"}\n' >"$run_dir/verification.jsonl"
+
+output="$(PATH="$bin_dir:/opt/homebrew/bin:/usr/bin:/bin:/usr/sbin:/sbin" \
+  SHARED_AGENT_HOME="$shared_home" \
+  ACP_ROOT="$flow_root" \
+  ACP_PROFILE_REGISTRY_ROOT="$profile_registry_root" \
+  ACP_PROJECT_ID="demo" \
+  AGENT_PROJECT_ID="demo" \
+  AGENT_CONTROL_PLANE_CONFIG="$flow_profiles_dir/control-plane.yaml" \
+  ACP_CONFIG="$flow_profiles_dir/control-plane.yaml" \
+  bash "$workspace_bin_dir/agent-project-publish-issue-pr" \
+    --repo-slug example/repo \
+    --runs-root "$runs_root" \
+    --session "$session" \
+    --dry-run 2>&1)"
+
+grep -q '^PUBLISH_STATUS=would-create-pr$' <<<"$output"
+grep -q '^BRANCH=agent/demo/issue-7-recovery$' <<<"$output"
+grep -q 'BRANCH_RECOVERY=from-final-head' <<<"$output"
+git -C "$repo_root" rev-parse --verify agent/demo/issue-7-recovery >/dev/null 2>&1
+grep -q '^PR_TITLE=feat: recovery commit$' <<<"$output"
+
+echo "agent-project publish issue PR recovers final head test passed"

package/tools/tests/test-agent-project-publish-issue-pr-reuses-existing-worktree.sh

@@ -0,0 +1,147 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+FLOW_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+SOURCE_SCRIPT="${FLOW_ROOT}/tools/bin/agent-project-publish-issue-pr"
+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_bin_dir="$tmpdir/workspace/bin"
+shared_home="$tmpdir/shared-home"
+flow_root="$shared_home/skills/openclaw/agent-control-plane"
+flow_assets_dir="$flow_root/assets"
+profile_registry_root="$tmpdir/profile-registry"
+flow_profiles_dir="$profile_registry_root/demo"
+repo_root="$tmpdir/repo"
+origin_root="$tmpdir/origin.git"
+worktree_root="$tmpdir/worktrees"
+runs_root="$tmpdir/runs"
+history_root="$tmpdir/history"
+session="demo-issue-10"
+archive_dir="$history_root/${session}-20260326-000000"
+bin_dir="$tmpdir/bin"
+shared_bin="$tmpdir/tools/bin"
+
+mkdir -p "$workspace_bin_dir" "$flow_assets_dir" "$flow_profiles_dir" "$repo_root" "$worktree_root" "$runs_root" "$history_root" "$bin_dir" "$shared_bin" "$archive_dir"
+cp "$SOURCE_SCRIPT" "$workspace_bin_dir/agent-project-publish-issue-pr"
+cp "$FLOW_CONFIG_LIB" "$workspace_bin_dir/flow-config-lib.sh"
+cp "$FLOW_SHELL_LIB" "$workspace_bin_dir/flow-shell-lib.sh"
+printf 'skill root\n' >"$flow_root/SKILL.md"
+printf '{}\n' >"$flow_assets_dir/workflow-catalog.json"
+
+cat >"$flow_profiles_dir/control-plane.yaml" <<EOF_PROFILE
+id: "demo"
+repo:
+  slug: "example/repo"
+  root: "$repo_root"
+  default_branch: "main"
+runtime:
+  orchestrator_agent_root: "$tmpdir/agent-root"
+  agent_repo_root: "$repo_root"
+  worktree_root: "$worktree_root"
+  runs_root: "$runs_root"
+  history_root: "$history_root"
+EOF_PROFILE
+
+cat >"$shared_bin/agent-project-worker-status" <<EOF_STATUS
+#!/usr/bin/env bash
+set -euo pipefail
+printf 'SESSION=%s\n' "$session"
+printf 'STATUS=UNKNOWN\n'
+EOF_STATUS
+
+cat >"$shared_bin/issue-publish-scope-guard.sh" <<'EOF_SCOPE'
+#!/usr/bin/env bash
+set -euo pipefail
+exit 0
+EOF_SCOPE
+
+cat >"$shared_bin/branch-verification-guard.sh" <<'EOF_VERIFY'
+#!/usr/bin/env bash
+set -euo pipefail
+exit 0
+EOF_VERIFY
+
+cat >"$bin_dir/gh" <<'EOF_GH'
+#!/usr/bin/env bash
+set -euo pipefail
+
+case "${1:-}:${2:-}" in
+  issue:view)
+    printf '{"title":"Existing worktree issue","url":"https://github.com/example/repo/issues/10","labels":[]}'
+    ;;
+  pr:list)
+    printf '[]\n'
+    ;;
+  api:user)
+    printf 'tester\n'
+    ;;
+  *)
+    echo "unexpected gh invocation: $*" >&2
+    exit 1
+    ;;
+esac
+EOF_GH
+
+chmod +x \
+  "$workspace_bin_dir/agent-project-publish-issue-pr" \
+  "$workspace_bin_dir/flow-config-lib.sh" \
+  "$workspace_bin_dir/flow-shell-lib.sh" \
+  "$shared_bin/agent-project-worker-status" \
+  "$shared_bin/issue-publish-scope-guard.sh" \
+  "$shared_bin/branch-verification-guard.sh" \
+  "$bin_dir/gh"
+
+git init --bare "$origin_root" >/dev/null 2>&1
+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
+git -C "$repo_root" remote add origin "$origin_root"
+git -C "$repo_root" push -u origin main >/dev/null 2>&1
+
+branch_name="agent/demo/issue-10-existing-worktree"
+git -C "$repo_root" branch "$branch_name" main
+existing_worktree="$worktree_root/existing"
+git -C "$repo_root" worktree add "$existing_worktree" "$branch_name" >/dev/null 2>&1
+printf 'existing\n' >>"$existing_worktree/README.md"
+git -C "$existing_worktree" add README.md
+git -C "$existing_worktree" commit -m "feat: existing worktree recovery" >/dev/null 2>&1
+final_head="$(git -C "$existing_worktree" rev-parse HEAD)"
+existing_worktree_canonical="$(cd "$existing_worktree" && pwd -P)"
+
+cat >"$archive_dir/run.env" <<EOF_RUN
+ISSUE_ID=10
+BRANCH=$branch_name
+WORKTREE=$tmpdir/missing-worktree
+FINAL_HEAD=$final_head
+EOF_RUN
+
+printf '{"status":"pass","command":"npm test"}\n' >"$archive_dir/verification.jsonl"
+
+output="$(PATH="$bin_dir:/opt/homebrew/bin:/usr/bin:/bin:/usr/sbin:/sbin" \
+  SHARED_AGENT_HOME="$shared_home" \
+  ACP_ROOT="$flow_root" \
+  ACP_PROFILE_REGISTRY_ROOT="$profile_registry_root" \
+  ACP_PROJECT_ID="demo" \
+  AGENT_PROJECT_ID="demo" \
+  AGENT_CONTROL_PLANE_CONFIG="$flow_profiles_dir/control-plane.yaml" \
+  ACP_CONFIG="$flow_profiles_dir/control-plane.yaml" \
+  bash "$workspace_bin_dir/agent-project-publish-issue-pr" \
+    --repo-slug example/repo \
+    --runs-root "$runs_root" \
+    --history-root "$history_root" \
+    --session "$session" \
+    --dry-run 2>&1)"
+
+grep -q '^PUBLISH_STATUS=would-create-pr$' <<<"$output"
+grep -q 'WORKTREE_RECOVERY=reused-existing' <<<"$output"
+grep -q "RECOVERY_WORKTREE=$existing_worktree_canonical" <<<"$output"
+grep -q '^PR_TITLE=feat: existing worktree recovery$' <<<"$output"
+
+echo "agent-project publish issue PR reuses existing worktree test passed"