agent-control-plane 0.1.0

package/tools/tests/test-agent-project-claude-session-wrapper-retries-transient-failures.sh

@@ -0,0 +1,90 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+FLOW_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+SESSION_SRC="${FLOW_ROOT}/tools/bin/agent-project-run-claude-session"
+
+tmpdir="$(mktemp -d)"
+trap 'rm -rf "$tmpdir"' EXIT
+
+tools_dir="$tmpdir/tools"
+bin_dir="$tmpdir/bin"
+worktree="$tmpdir/worktree"
+runs_root="$tmpdir/runs"
+prompt_file="$tmpdir/prompt.md"
+session="acp-issue-claude-retry"
+run_dir="$runs_root/$session"
+
+mkdir -p "$tools_dir" "$bin_dir" "$worktree" "$runs_root"
+cp "$SESSION_SRC" "$tools_dir/agent-project-run-claude-session"
+
+cat >"$bin_dir/claude" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+
+attempt_file="${ACP_HOST_RUN_DIR:?}/attempt-count"
+attempt="0"
+if [[ -f "$attempt_file" ]]; then
+  attempt="$(cat "$attempt_file")"
+fi
+attempt="$((attempt + 1))"
+printf '%s' "$attempt" >"$attempt_file"
+
+if [[ "$attempt" -eq 1 ]]; then
+  printf 'network error: ECONNRESET\n' >&2
+  exit 1
+fi
+
+cat >"${ACP_RESULT_FILE:?}" <<'RESULT'
+OUTCOME=blocked
+ACTION=host-comment-blocker
+RESULT
+printf 'retry success\n'
+EOF
+
+chmod +x "$tools_dir/agent-project-run-claude-session" "$bin_dir/claude"
+
+git -C "$worktree" init -b test >/dev/null 2>&1
+printf 'Prompt body\n' >"$prompt_file"
+
+PATH="$bin_dir:$PATH" \
+bash "$tools_dir/agent-project-run-claude-session" \
+  --mode safe \
+  --session "$session" \
+  --worktree "$worktree" \
+  --prompt-file "$prompt_file" \
+  --runs-root "$runs_root" \
+  --adapter-id alpha \
+  --task-kind issue \
+  --task-id 123 \
+  --claude-model sonnet \
+  --claude-permission-mode dontAsk \
+  --claude-effort medium \
+  --claude-timeout-seconds 10 \
+  --claude-max-attempts 2 \
+  --claude-retry-backoff-seconds 0 \
+  >/dev/null
+
+for _ in $(seq 1 50); do
+  if ! tmux has-session -t "$session" 2>/dev/null; then
+    break
+  fi
+  sleep 0.2
+done
+
+if tmux has-session -t "$session" 2>/dev/null; then
+  echo "tmux session did not exit" >&2
+  exit 1
+fi
+
+test -f "$run_dir/result.env"
+grep -q '^OUTCOME=blocked$' "$run_dir/result.env"
+grep -q '^ACTION=host-comment-blocker$' "$run_dir/result.env"
+grep -q '^2$' "$run_dir/attempt-count"
+grep -q '^RUNNER_STATE=completed$' "$run_dir/runner.env"
+grep -q '^ATTEMPT=2$' "$run_dir/runner.env"
+grep -q '^RESUME_COUNT=1$' "$run_dir/runner.env"
+grep -q '\[claude-retry\] reason=network-connection backoff=0s' "$run_dir/$session.log"
+grep -q '__CLAUDE_EXIT__:0' "$run_dir/$session.log"
+
+echo "agent-project claude retry wrapper test passed"

package/tools/tests/test-agent-project-claude-session-wrapper-times-out.sh

@@ -0,0 +1,73 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+FLOW_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+SESSION_SRC="${FLOW_ROOT}/tools/bin/agent-project-run-claude-session"
+
+tmpdir="$(mktemp -d)"
+trap 'rm -rf "$tmpdir"' EXIT
+
+tools_dir="$tmpdir/tools"
+bin_dir="$tmpdir/bin"
+worktree="$tmpdir/worktree"
+runs_root="$tmpdir/runs"
+prompt_file="$tmpdir/prompt.md"
+session="acp-issue-claude-timeout"
+run_dir="$runs_root/$session"
+
+mkdir -p "$tools_dir" "$bin_dir" "$worktree" "$runs_root"
+cp "$SESSION_SRC" "$tools_dir/agent-project-run-claude-session"
+
+cat >"$bin_dir/claude" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+
+sleep 2
+printf 'finished too late\n'
+EOF
+
+chmod +x "$tools_dir/agent-project-run-claude-session" "$bin_dir/claude"
+
+git -C "$worktree" init -b test >/dev/null 2>&1
+printf 'Prompt body\n' >"$prompt_file"
+
+PATH="$bin_dir:$PATH" \
+bash "$tools_dir/agent-project-run-claude-session" \
+  --mode safe \
+  --session "$session" \
+  --worktree "$worktree" \
+  --prompt-file "$prompt_file" \
+  --runs-root "$runs_root" \
+  --adapter-id alpha \
+  --task-kind issue \
+  --task-id 123 \
+  --claude-model sonnet \
+  --claude-permission-mode dontAsk \
+  --claude-effort medium \
+  --claude-timeout-seconds 1 \
+  --claude-max-attempts 1 \
+  --claude-retry-backoff-seconds 0 \
+  >/dev/null
+
+for _ in $(seq 1 50); do
+  if ! tmux has-session -t "$session" 2>/dev/null; then
+    break
+  fi
+  sleep 0.2
+done
+
+if tmux has-session -t "$session" 2>/dev/null; then
+  echo "tmux session did not exit" >&2
+  exit 1
+fi
+
+test -f "$run_dir/result.env"
+grep -q '^OUTCOME=blocked$' "$run_dir/result.env"
+grep -q '^ACTION=host-comment-blocker$' "$run_dir/result.env"
+grep -q '^DETAIL=worker-exit-124$' "$run_dir/result.env"
+grep -q '^RUNNER_STATE=failed$' "$run_dir/runner.env"
+grep -q '^LAST_EXIT_CODE=124$' "$run_dir/runner.env"
+grep -q '^LAST_FAILURE_REASON=timeout$' "$run_dir/runner.env"
+grep -q '__CLAUDE_EXIT__:124' "$run_dir/$session.log"
+
+echo "agent-project claude timeout wrapper test passed"

package/tools/tests/test-agent-project-claude-session-wrapper.sh

@@ -0,0 +1,103 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+FLOW_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+SESSION_SRC="${FLOW_ROOT}/tools/bin/agent-project-run-claude-session"
+
+tmpdir="$(mktemp -d)"
+trap 'rm -rf "$tmpdir"' EXIT
+
+tools_dir="$tmpdir/tools"
+bin_dir="$tmpdir/bin"
+worktree="$tmpdir/worktree"
+runs_root="$tmpdir/runs"
+prompt_file="$tmpdir/prompt.md"
+session="acp-issue-claude-wrapper"
+run_dir="$runs_root/$session"
+reconcile_log="$tmpdir/reconcile.log"
+
+mkdir -p "$tools_dir" "$bin_dir" "$worktree" "$runs_root"
+cp "$SESSION_SRC" "$tools_dir/agent-project-run-claude-session"
+
+cat >"$bin_dir/claude" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+
+printf '%s\n' "$@" >"${ACP_HOST_RUN_DIR:?}/claude-args.log"
+cat >"${ACP_RESULT_FILE:?}" <<'RESULT'
+OUTCOME=blocked
+ACTION=host-comment-blocker
+RESULT
+printf 'artifact-from-claude\n' >"${ACP_RUN_DIR:?}/mock.txt"
+printf 'session-env\n' >".agent-session.env"
+mkdir -p ".openclaw-artifacts"
+printf 'generated\n' >".openclaw-artifacts/generated.txt"
+printf 'mock claude finished\n'
+EOF
+
+chmod +x "$tools_dir/agent-project-run-claude-session" "$bin_dir/claude"
+
+git -C "$worktree" init -b test >/dev/null 2>&1
+printf 'Prompt body\n' >"$prompt_file"
+
+PATH="$bin_dir:$PATH" \
+bash "$tools_dir/agent-project-run-claude-session" \
+  --mode safe \
+  --session "$session" \
+  --worktree "$worktree" \
+  --prompt-file "$prompt_file" \
+  --runs-root "$runs_root" \
+  --adapter-id alpha \
+  --task-kind issue \
+  --task-id 123 \
+  --claude-model sonnet \
+  --claude-permission-mode dontAsk \
+  --claude-effort high \
+  --collect-file mock.txt \
+  --reconcile-command "printf 'reconciled\n' >> '$reconcile_log'" \
+  >/dev/null
+
+for _ in $(seq 1 50); do
+  if ! tmux has-session -t "$session" 2>/dev/null; then
+    break
+  fi
+  sleep 0.2
+done
+
+if tmux has-session -t "$session" 2>/dev/null; then
+  echo "tmux session did not exit" >&2
+  exit 1
+fi
+
+for _ in $(seq 1 25); do
+  [[ -f "$reconcile_log" ]] && break
+  sleep 0.2
+done
+
+test -f "$run_dir/result.env"
+test -f "$run_dir/mock.txt"
+grep -q '^OUTCOME=blocked$' "$run_dir/result.env"
+grep -q '^ACTION=host-comment-blocker$' "$run_dir/result.env"
+grep -q 'artifact-from-claude' "$run_dir/mock.txt"
+grep -q '__CLAUDE_EXIT__:0' "$run_dir/$session.log"
+grep -q '^reconciled$' "$reconcile_log"
+grep -q '^-p$' "$run_dir/claude-args.log"
+grep -q '^--model$' "$run_dir/claude-args.log"
+grep -q '^sonnet$' "$run_dir/claude-args.log"
+grep -q '^--permission-mode$' "$run_dir/claude-args.log"
+grep -q '^dontAsk$' "$run_dir/claude-args.log"
+grep -q '^--effort$' "$run_dir/claude-args.log"
+grep -q '^high$' "$run_dir/claude-args.log"
+grep -q '^--add-dir$' "$run_dir/claude-args.log"
+exclude_file="$(git -C "$worktree" config --worktree --get core.excludesFile)"
+test -f "$exclude_file"
+grep -qx '.openclaw-artifacts' "$exclude_file"
+grep -qx '.agent-session.env' "$exclude_file"
+hook_path="$(git -C "$worktree" rev-parse --git-path hooks/pre-commit)"
+if [[ "$hook_path" != /* ]]; then
+  hook_path="$worktree/$hook_path"
+fi
+test -x "$hook_path"
+test -z "$(git -C "$worktree" status --short)"
+
+echo "agent-project claude session wrapper test passed"

package/tools/tests/test-agent-project-cleanup-session-orphan-fallback.sh

@@ -0,0 +1,90 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+FLOW_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+SCRIPT_SRC="${FLOW_ROOT}/tools/bin/agent-project-cleanup-session"
+
+tmpdir="$(mktemp -d "${TMPDIR:-/tmp}/cleanup-session-orphan.XXXXXX")"
+cleanup() {
+  rm -rf "$tmpdir"
+}
+trap cleanup EXIT
+
+shared_bin="$tmpdir/shared/tools/bin"
+runs_root="$tmpdir/runs"
+history_root="$tmpdir/history"
+repo_root="$tmpdir/repo"
+worktree_root="$tmpdir/worktrees"
+session="fl-issue-440"
+run_dir="$runs_root/$session"
+worktree_path="$worktree_root/issue-440"
+cleanup_log="$tmpdir/cleanup.log"
+output_file="$tmpdir/output.txt"
+
+mkdir -p "$shared_bin" "$run_dir" "$history_root" "$repo_root" "$worktree_path"
+
+cp "$SCRIPT_SRC" "$shared_bin/agent-project-cleanup-session"
+chmod +x "$shared_bin/agent-project-cleanup-session"
+
+cat >"$shared_bin/agent-cleanup-worktree" <<EOF
+#!/usr/bin/env bash
+set -euo pipefail
+printf '%s\n' "\$*" >>"$cleanup_log"
+if [[ " \$* " == *" --path "* ]]; then
+  echo "[agent-cleanup] Branch agent/alpha/issue-440 is not associated with a dedicated worktree." >&2
+  echo "[agent-cleanup] Refusing to trust explicit --path '$worktree_path' without a Git-resolved branch worktree." >&2
+  exit 1
+fi
+echo "[agent-cleanup] cleanup complete"
+EOF
+chmod +x "$shared_bin/agent-cleanup-worktree"
+
+cat >"$shared_bin/agent-project-archive-run" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+session=""
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --session) session="${2:-}"; shift 2 ;;
+    *) shift ;;
+  esac
+done
+printf 'ARCHIVED_SESSION=%s\n' "$session"
+EOF
+chmod +x "$shared_bin/agent-project-archive-run"
+
+git -C "$repo_root" init >/dev/null
+git -C "$repo_root" checkout -b main >/dev/null
+
+cat >"$run_dir/run.env" <<EOF
+SESSION=$session
+BRANCH=agent/alpha/issue-440
+WORKTREE=$worktree_path
+RESULT_FILE=$run_dir/result.env
+EOF
+
+touch "$worktree_path/README.md"
+
+AGENT_PROJECT_WORKTREE_ROOT="$worktree_root" \
+SHARED_AGENT_HOME="$tmpdir/shared" \
+bash "$shared_bin/agent-project-cleanup-session" \
+  --repo-root "$repo_root" \
+  --runs-root "$runs_root" \
+  --history-root "$history_root" \
+  --session "$session" \
+  --mode issue >"$output_file"
+
+grep -q '^SESSION=fl-issue-440$' "$output_file"
+grep -q '^CLEANUP_MODE=orphan-worktree$' "$output_file"
+grep -q '^ORPHAN_FALLBACK_USED=true$' "$output_file"
+grep -q '^CLEANUP_STATUS=0$' "$output_file"
+grep -q '^ARCHIVED_SESSION=fl-issue-440$' "$output_file"
+
+test ! -d "$worktree_path"
+
+first_call="$(sed -n '1p' "$cleanup_log")"
+second_call="$(sed -n '2p' "$cleanup_log")"
+[[ "$first_call" == *"--path $worktree_path"* ]]
+[[ "$second_call" != *"--path $worktree_path"* ]]
+
+echo "test-agent-project-cleanup-session-orphan-fallback: PASS"

package/tools/tests/test-agent-project-cleanup-session-skip-worktree-cleanup.sh

@@ -0,0 +1,90 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+FLOW_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+SCRIPT_SRC="${FLOW_ROOT}/tools/bin/agent-project-cleanup-session"
+
+tmpdir="$(mktemp -d "${TMPDIR:-/tmp}/cleanup-session-skip.XXXXXX")"
+trap 'rm -rf "$tmpdir"' EXIT
+
+shared_bin="$tmpdir/shared/tools/bin"
+runs_root="$tmpdir/runs"
+history_root="$tmpdir/history"
+repo_root="$tmpdir/repo"
+worktree_path="$tmpdir/worktrees/issue-441"
+session="fl-issue-441"
+run_dir="$runs_root/$session"
+archive_dir="$history_root/${session}-archived"
+cleanup_log="$tmpdir/cleanup.log"
+
+mkdir -p "$shared_bin" "$run_dir" "$history_root" "$repo_root" "$worktree_path"
+
+cp "$SCRIPT_SRC" "$shared_bin/agent-project-cleanup-session"
+chmod +x "$shared_bin/agent-project-cleanup-session"
+
+cat >"$shared_bin/agent-cleanup-worktree" <<EOF
+#!/usr/bin/env bash
+set -euo pipefail
+printf '%s\n' "\$*" >>"$cleanup_log"
+exit 7
+EOF
+chmod +x "$shared_bin/agent-cleanup-worktree"
+
+cat >"$shared_bin/agent-project-archive-run" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+
+runs_root=""
+history_root=""
+session=""
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --runs-root) runs_root="${2:-}"; shift 2 ;;
+    --history-root) history_root="${2:-}"; shift 2 ;;
+    --session) session="${2:-}"; shift 2 ;;
+    --remove-file) shift 2 ;;
+    *) shift ;;
+  esac
+done
+
+archive_dir="${history_root}/${session}-archived"
+mv "${runs_root}/${session}" "${archive_dir}"
+printf 'ARCHIVE_DIR=%s\n' "$archive_dir"
+EOF
+chmod +x "$shared_bin/agent-project-archive-run"
+
+git -C "$repo_root" init >/dev/null
+git -C "$repo_root" checkout -b main >/dev/null
+
+cat >"$run_dir/run.env" <<EOF
+SESSION=$session
+BRANCH=agent/alpha/issue-441
+WORKTREE=$worktree_path
+RESULT_FILE=$run_dir/result.env
+EOF
+
+printf 'artifact\n' >"$run_dir/result.env"
+printf 'keep me\n' >"$worktree_path/README.md"
+
+output="$(
+  SHARED_AGENT_HOME="$tmpdir/shared" \
+  bash "$shared_bin/agent-project-cleanup-session" \
+    --repo-root "$repo_root" \
+    --runs-root "$runs_root" \
+    --history-root "$history_root" \
+    --session "$session" \
+    --mode issue \
+    --skip-worktree-cleanup
+)"
+
+grep -q '^SESSION=fl-issue-441$' <<<"$output"
+grep -q '^SKIP_WORKTREE_CLEANUP=true$' <<<"$output"
+grep -q '^CLEANUP_MODE=archived-only$' <<<"$output"
+grep -q "^ARCHIVE_DIR=$archive_dir$" <<<"$output"
+test -d "$worktree_path"
+test ! -d "$run_dir"
+test -d "$archive_dir"
+test ! -s "$cleanup_log"
+
+echo "test-agent-project-cleanup-session-skip-worktree-cleanup: PASS"

package/tools/tests/test-agent-project-codex-live-thread-persist.sh

@@ -0,0 +1,76 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+FLOW_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+RUNNER_SRC="${FLOW_ROOT}/tools/bin/agent-project-run-codex-resilient"
+
+tmpdir="$(mktemp -d "${TMPDIR:-/tmp}/codex-live-thread.XXXXXX")"
+cleanup() {
+  if [[ -n "${runner_pid:-}" ]]; then
+    kill "${runner_pid}" 2>/dev/null || true
+    wait "${runner_pid}" 2>/dev/null || true
+  fi
+  rm -rf "$tmpdir"
+}
+trap cleanup EXIT
+
+bin_dir="$tmpdir/bin"
+host_run_dir="$tmpdir/run"
+sandbox_run_dir="$tmpdir/sandbox"
+worktree_dir="$tmpdir/worktree"
+prompt_file="$tmpdir/prompt.md"
+output_file="$host_run_dir/output.log"
+runner_copy="$tmpdir/agent-project-run-codex-resilient"
+mock_codex="$bin_dir/codex"
+state_file="$host_run_dir/runner.env"
+
+mkdir -p "$bin_dir" "$host_run_dir" "$sandbox_run_dir" "$worktree_dir"
+cp "$RUNNER_SRC" "$runner_copy"
+chmod +x "$runner_copy"
+echo "resume me later" >"$prompt_file"
+
+cat >"$mock_codex" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+
+if [[ "${1:-}" == "exec" ]]; then
+  echo '{"type":"thread.started","thread_id":"thread-live-123"}'
+  sleep 2
+  echo '{"type":"turn.started"}'
+  sleep 1
+  exit 0
+fi
+
+echo "unexpected args: $*" >&2
+exit 1
+EOF
+chmod +x "$mock_codex"
+
+bash "$runner_copy" \
+  --mode safe \
+  --worktree "$worktree_dir" \
+  --prompt-file "$prompt_file" \
+  --output-file "$output_file" \
+  --host-run-dir "$host_run_dir" \
+  --sandbox-run-dir "$sandbox_run_dir" \
+  --safe-profile test-safe \
+  --bypass-profile test-bypass \
+  --codex-bin "$mock_codex" &
+runner_pid=$!
+
+for _ in $(seq 1 20); do
+  if [[ -f "$state_file" ]] && grep -q '^THREAD_ID=thread-live-123$' "$state_file"; then
+    break
+  fi
+  sleep 0.2
+done
+
+grep -q '^THREAD_ID=thread-live-123$' "$state_file"
+kill -0 "$runner_pid"
+
+wait "$runner_pid"
+
+grep -q '^RUNNER_STATE=succeeded$' "$state_file"
+grep -q '"thread_id":"thread-live-123"' "$output_file"
+
+echo "test-agent-project-codex-live-thread-persist: PASS"