agent-control-plane 0.1.9 → 0.1.12

package/tools/bin/audit-agent-worktrees.sh

@@ -1,310 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-# shellcheck source=/dev/null
-source "${SCRIPT_DIR}/flow-config-lib.sh"
-
-WORKER_STATUS_TOOL="${BASH_SOURCE[0]%/*}/agent-project-worker-status"
-WORKTREE_CLEANUP_TOOL="${BASH_SOURCE[0]%/*}/agent-cleanup-worktree"
-CONFIG_YAML="$(resolve_flow_config_yaml "${BASH_SOURCE[0]}")"
-AGENT_REPO_ROOT="$(flow_resolve_agent_repo_root "${CONFIG_YAML}")"
-WORKTREE_ROOT="$(flow_resolve_worktree_root "${CONFIG_YAML}")"
-AGENT_ROOT="$(flow_resolve_agent_root "${CONFIG_YAML}")"
-RUNS_ROOT="$(flow_resolve_runs_root "${CONFIG_YAML}")"
-PENDING_LAUNCH_DIR="${ACP_PENDING_LAUNCH_DIR:-${F_LOSNING_PENDING_LAUNCH_DIR:-$(flow_resolve_state_root "${CONFIG_YAML}")/pending-launches}}"
-ISSUE_SESSION_PREFIX="$(flow_resolve_issue_session_prefix "${CONFIG_YAML}")"
-PR_SESSION_PREFIX="$(flow_resolve_pr_session_prefix "${CONFIG_YAML}")"
-ISSUE_BRANCH_PREFIX="$(flow_resolve_issue_branch_prefix "${CONFIG_YAML}")"
-PR_WORKTREE_BRANCH_PREFIX="$(flow_resolve_pr_worktree_branch_prefix "${CONFIG_YAML}")"
-MANAGED_PR_BRANCH_GLOBS="$(flow_resolve_managed_pr_branch_globs "${CONFIG_YAML}")"
-ISSUE_BRANCH_PREFIX_REGEX="$(flow_escape_regex "${ISSUE_BRANCH_PREFIX}")"
-PR_WORKTREE_BRANCH_PREFIX_REGEX="$(flow_escape_regex "${PR_WORKTREE_BRANCH_PREFIX}")"
-
-cleanup="false"
-strict="false"
-
-usage() {
-  cat <<'EOF'
-Usage:
-  audit-agent-worktrees.sh [--cleanup] [--strict]
-
-Audits agent-managed worktrees attached to the anchor repo and removes stale
-ones when they no longer have a running owner and only contain generated
-artifacts such as node_modules symlinks or .openclaw-artifacts.
-
-Options:
-  --cleanup  Remove clean/orphaned agent worktrees automatically.
-  --strict   Exit non-zero when any stale agent worktree is found.
-EOF
-}
-
-while [[ $# -gt 0 ]]; do
-  case "$1" in
-    --cleanup) cleanup="true"; shift ;;
-    --strict) strict="true"; shift ;;
-    --help|-h) usage; exit 0 ;;
-    *) echo "Unknown argument: $1" >&2; usage >&2; exit 1 ;;
-  esac
-done
-
-if [[ ! -d "$AGENT_REPO_ROOT/.git" && ! -f "$AGENT_REPO_ROOT/.git" ]]; then
-  echo "agent repo root is not a Git checkout: $AGENT_REPO_ROOT" >&2
-  exit 1
-fi
-
-session_for_worktree() {
-  local worktree_path="${1:-}"
-  local branch_ref="${2:-}"
-  local base
-
-  base="$(basename "$worktree_path")"
-  if [[ "$base" =~ ^pr-([0-9]+)- ]]; then
-    printf '%s%s\n' "${PR_SESSION_PREFIX}" "${BASH_REMATCH[1]}"
-    return 0
-  fi
-  if [[ "$base" =~ ^issue-([0-9]+)- ]]; then
-    printf '%s%s\n' "${ISSUE_SESSION_PREFIX}" "${BASH_REMATCH[1]}"
-    return 0
-  fi
-  if [[ "$branch_ref" =~ ^refs/heads/${PR_WORKTREE_BRANCH_PREFIX_REGEX}-([0-9]+)- ]]; then
-    printf '%s%s\n' "${PR_SESSION_PREFIX}" "${BASH_REMATCH[1]}"
-    return 0
-  fi
-  if [[ "$branch_ref" =~ ^refs/heads/${ISSUE_BRANCH_PREFIX_REGEX}-([0-9]+)- ]]; then
-    printf '%s%s\n' "${ISSUE_SESSION_PREFIX}" "${BASH_REMATCH[1]}"
-    return 0
-  fi
-  return 1
-}
-
-branch_name_is_managed() {
-  local branch_name="${1:-}"
-  local branch_glob=""
-
-  for branch_glob in ${MANAGED_PR_BRANCH_GLOBS}; do
-    case "$branch_name" in
-      ${branch_glob}) return 0 ;;
-    esac
-  done
-
-  return 1
-}
-
-is_agent_managed_worktree() {
-  local worktree_path="${1:-}"
-  local branch_ref="${2:-}"
-  local branch_name=""
-
-  [[ "$worktree_path" == "$WORKTREE_ROOT/"* ]] || return 1
-  if [[ "$branch_ref" == refs/heads/* ]]; then
-    branch_name="${branch_ref#refs/heads/}"
-    if branch_name_is_managed "$branch_name"; then
-      return 0
-    fi
-  fi
-  case "$(basename "$worktree_path")" in
-    pr-*|issue-*|shared-*) return 0 ;;
-  esac
-  return 1
-}
-
-worktree_effectively_dirty() {
-  local worktree_path="${1:?worktree path required}"
-  local filtered=""
-
-  if ! git -C "$worktree_path" rev-parse --is-inside-work-tree >/dev/null 2>&1; then
-    return 1
-  fi
-
-  filtered="$(
-    git -C "$worktree_path" status --short --untracked-files=normal \
-      | awk '
-          /^\?\? node_modules$/ {next}
-          /^\?\? .+\/node_modules$/ {next}
-          /^\?\? \.openclaw-artifacts$/ {next}
-          /^\?\? \.openclaw-artifacts\// {next}
-          {print}
-        '
-  )"
-  [[ -n "$filtered" ]]
-}
-
-worktree_is_broken() {
-  local worktree_path="${1:?worktree path required}"
-  [[ -d "$worktree_path" ]] || return 0
-  git -C "$worktree_path" rev-parse --is-inside-work-tree >/dev/null 2>&1 && return 1
-  return 0
-}
-
-worktree_has_active_owner() {
-  local session_name="${1:-}"
-  local run_dir=""
-  local status_output=""
-  local status=""
-
-  [[ -n "$session_name" ]] || return 1
-
-  if tmux has-session -t "$session_name" 2>/dev/null; then
-    return 0
-  fi
-
-  run_dir="${RUNS_ROOT}/${session_name}"
-  if [[ ! -d "$run_dir" ]]; then
-    return 1
-  fi
-
-  # Completed workers still own their worktree until host-side reconcile
-  # archives the run or writes reconciled.ok. Otherwise audit can delete the
-  # worktree before publish/retry transitions consume it.
-  if [[ ! -f "${run_dir}/reconciled.ok" ]]; then
-    return 0
-  fi
-
-  status_output="$(
-    "$WORKER_STATUS_TOOL" \
-      --runs-root "$RUNS_ROOT" \
-      --session "$session_name" 2>/dev/null || true
-  )"
-  status="$(awk -F= '/^STATUS=/{print $2}' <<<"$status_output" | tail -n 1)"
-  [[ "$status" == "RUNNING" ]]
-}
-
-worktree_has_active_launch() {
-  local session_name="${1:-}"
-  local pending_file=""
-  local pending_pid=""
-
-  [[ -n "$session_name" ]] || return 1
-
-  case "$session_name" in
-    "${ISSUE_SESSION_PREFIX}"*)
-      pending_file="${PENDING_LAUNCH_DIR}/issue-${session_name#${ISSUE_SESSION_PREFIX}}.pid"
-      ;;
-    "${PR_SESSION_PREFIX}"*)
-      pending_file="${PENDING_LAUNCH_DIR}/pr-${session_name#${PR_SESSION_PREFIX}}.pid"
-      ;;
-    *)
-      return 1
-      ;;
-  esac
-
-  [[ -f "$pending_file" ]] || return 1
-  pending_pid="$(tr -d '[:space:]' <"$pending_file" 2>/dev/null || true)"
-  [[ -n "$pending_pid" ]] || return 1
-  kill -0 "$pending_pid" 2>/dev/null
-}
-
-remove_agent_worktree() {
-  local worktree_path="${1:-}"
-  local branch_ref="${2:-}"
-  local branch_name=""
-  local cleanup_args=()
-  local cleanup_failed="false"
-
-  if [[ "$branch_ref" == refs/heads/* ]]; then
-    branch_name="${branch_ref#refs/heads/}"
-    cleanup_args=(--branch "$branch_name" --path "$worktree_path" --allow-unmerged)
-    if [[ "$branch_name" == "${ISSUE_BRANCH_PREFIX}"-* ]]; then
-      cleanup_args+=(--keep-remote)
-    fi
-    if ! (
-      cd "$AGENT_REPO_ROOT"
-      "$WORKTREE_CLEANUP_TOOL" "${cleanup_args[@]}"
-    ) >/dev/null 2>&1; then
-      cleanup_failed="true"
-    fi
-  else
-    git -C "$AGENT_REPO_ROOT" worktree remove "$worktree_path" --force || true
-    git -C "$AGENT_REPO_ROOT" worktree prune
-    return 0
-  fi
-
-  if [[ "$cleanup_failed" == "true" ]]; then
-    rm -rf "$worktree_path"
-    if [[ -n "$branch_name" ]]; then
-      git -C "$AGENT_REPO_ROOT" branch -D "$branch_name" >/dev/null 2>&1 || true
-    fi
-  fi
-
-  git -C "$AGENT_REPO_ROOT" worktree prune >/dev/null 2>&1 || true
-}
-
-issue_count=0
-cleaned_count=0
-
-current_worktree=""
-current_branch_ref=""
-current_head=""
-
-while IFS= read -r line || [[ -n "$line" ]]; do
-  if [[ -z "$line" ]]; then
-    if [[ -n "$current_worktree" ]]; then
-      if [[ "$current_worktree" != "$AGENT_REPO_ROOT" ]] && is_agent_managed_worktree "$current_worktree" "$current_branch_ref"; then
-        session_name="$(session_for_worktree "$current_worktree" "$current_branch_ref" || true)"
-        active_owner="no"
-        if worktree_has_active_owner "$session_name"; then
-          active_owner="yes"
-        fi
-        active_launch="no"
-        if worktree_has_active_launch "$session_name"; then
-          active_launch="yes"
-        fi
-
-        if [[ "$active_owner" == "yes" || "$active_launch" == "yes" ]]; then
-          current_worktree=""
-          current_branch_ref=""
-          current_head=""
-          continue
-        fi
-
-        broken_worktree="no"
-        if worktree_is_broken "$current_worktree"; then
-          broken_worktree="yes"
-        fi
-        dirty="no"
-        if [[ "$broken_worktree" == "no" ]] && worktree_effectively_dirty "$current_worktree"; then
-          dirty="yes"
-        fi
-
-        issue_count=$((issue_count + 1))
-
-        printf 'AGENT_WORKTREE=%s\n' "$current_worktree"
-        printf 'BRANCH_REF=%s\n' "${current_branch_ref:-<detached>}"
-        printf 'HEAD=%s\n' "${current_head:-<unknown>}"
-        printf 'SESSION=%s\n' "${session_name:-<none>}"
-        printf 'BROKEN_WORKTREE=%s\n' "$broken_worktree"
-        printf 'DIRTY=%s\n' "$dirty"
-        printf 'ACTIVE_OWNER=%s\n' "$active_owner"
-        printf 'ACTIVE_LAUNCH=%s\n' "$active_launch"
-
-        if [[ "$cleanup" == "true" && "$dirty" == "no" && "$active_owner" == "no" && "$active_launch" == "no" ]]; then
-          remove_agent_worktree "$current_worktree" "$current_branch_ref"
-          cleaned_count=$((cleaned_count + 1))
-          printf 'CLEANUP=removed\n'
-        else
-          printf 'CLEANUP=skipped\n'
-        fi
-        printf '\n'
-      fi
-
-      current_worktree=""
-      current_branch_ref=""
-      current_head=""
-    fi
-    continue
-  fi
-
-  case "$line" in
-    worktree\ *) current_worktree="${line#worktree }" ;;
-    HEAD\ *) current_head="${line#HEAD }" ;;
-    branch\ *) current_branch_ref="${line#branch }" ;;
-  esac
-done < <(git -C "$AGENT_REPO_ROOT" worktree list --porcelain; printf '\n')
-
-printf 'LEGACY_AGENT_WORKTREE_COUNT=%s\n' "$issue_count"
-printf 'LEGACY_AGENT_WORKTREE_CLEANED=%s\n' "$cleaned_count"
-
-if [[ "$strict" == "true" && "$issue_count" -gt 0 ]]; then
-  exit 2
-fi

package/tools/bin/audit-issue-routing.sh

@@ -1,11 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-# shellcheck source=/dev/null
-source "${SCRIPT_DIR}/flow-shell-lib.sh"
-
-FLOW_SKILL_DIR="$(resolve_flow_skill_dir "${BASH_SOURCE[0]}")"
-ADAPTER_BIN_DIR="${FLOW_SKILL_DIR}/bin"
-
-exec "${ADAPTER_BIN_DIR}/audit-issue-routing.sh" "$@"

package/tools/bin/audit-retained-layout.sh

@@ -1,58 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-# shellcheck source=/dev/null
-source "${SCRIPT_DIR}/flow-config-lib.sh"
-
-CONFIG_YAML="$(resolve_flow_config_yaml "${BASH_SOURCE[0]}")"
-RETAINED_ROOT="$(flow_resolve_retained_repo_root "${CONFIG_YAML}")"
-ADAPTER_ID="$(flow_resolve_adapter_id "${CONFIG_YAML}")"
-
-classify_worktree() {
-  local path="${1:-}"
-  case "$path" in
-    */${ADAPTER_ID}-pr-*|*/${ADAPTER_ID}-issue-*|*/${ADAPTER_ID}-main-clean)
-      printf 'legacy-automation\n'
-      ;;
-    "$RETAINED_ROOT")
-      printf 'retained-main\n'
-      ;;
-    *)
-      printf 'retained-manual\n'
-      ;;
-  esac
-}
-
-count_dirty_paths() {
-  local path="${1:?path required}"
-  git -C "$path" status --porcelain 2>/dev/null | wc -l | tr -d ' '
-}
-
-current_branch() {
-  local path="${1:?path required}"
-  git -C "$path" rev-parse --abbrev-ref HEAD 2>/dev/null || printf 'unknown\n'
-}
-
-current_head() {
-  local path="${1:?path required}"
-  git -C "$path" rev-parse --short HEAD 2>/dev/null || printf 'unknown\n'
-}
-
-worktree_list="$(
-  git -C "$RETAINED_ROOT" worktree list --porcelain |
-    awk '/^worktree /{print substr($0,10)}'
-)"
-
-printf 'RETAINED_ROOT=%s\n' "$RETAINED_ROOT"
-printf 'RETAINED_WORKTREE_COUNT=%s\n' "$(printf '%s\n' "$worktree_list" | sed '/^$/d' | wc -l | tr -d ' ')"
-
-while IFS= read -r worktree; do
-  [[ -n "$worktree" ]] || continue
-  printf '\n[worktree]\n'
-  printf 'path=%s\n' "$worktree"
-  printf 'class=%s\n' "$(classify_worktree "$worktree")"
-  printf 'branch=%s\n' "$(current_branch "$worktree")"
-  printf 'head=%s\n' "$(current_head "$worktree")"
-  printf 'dirty_paths=%s\n' "$(count_dirty_paths "$worktree")"
-done <<<"$worktree_list"

package/tools/bin/audit-retained-overlap.sh

@@ -1,135 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-PRIMARY_ROOT=""
-SECONDARY_ROOT=""
-PRIMARY_LABEL="primary"
-SECONDARY_LABEL="secondary"
-SUMMARY_ONLY="false"
-
-usage() {
-  cat <<'EOF'
-Usage:
-  audit-retained-overlap.sh --primary <path> --secondary <path> [options]
-
-Compares uncommitted file sets between two retained human worktrees.
-
-Options:
-  --primary <path>            Primary retained worktree
-  --secondary <path>          Secondary retained worktree
-  --primary-label <label>     Label for primary output (default: primary)
-  --secondary-label <label>   Label for secondary output (default: secondary)
-  --summary-only              Print counts and grouped summaries only
-  --help                      Show this help
-EOF
-}
-
-while [[ $# -gt 0 ]]; do
-  case "$1" in
-    --primary) PRIMARY_ROOT="${2:-}"; shift 2 ;;
-    --secondary) SECONDARY_ROOT="${2:-}"; shift 2 ;;
-    --primary-label) PRIMARY_LABEL="${2:-}"; shift 2 ;;
-    --secondary-label) SECONDARY_LABEL="${2:-}"; shift 2 ;;
-    --summary-only) SUMMARY_ONLY="true"; shift ;;
-    --help|-h) usage; exit 0 ;;
-    *) echo "Unknown argument: $1" >&2; usage >&2; exit 1 ;;
-  esac
-done
-
-if [[ -z "$PRIMARY_ROOT" || -z "$SECONDARY_ROOT" ]]; then
-  usage >&2
-  exit 1
-fi
-
-for repo_root in "$PRIMARY_ROOT" "$SECONDARY_ROOT"; do
-  if [[ ! -d "$repo_root/.git" && ! -f "$repo_root/.git" ]]; then
-    echo "not a git checkout: $repo_root" >&2
-    exit 1
-  fi
-done
-
-tmp_dir="$(mktemp -d "${TMPDIR:-/tmp}/retained-overlap.XXXXXX")"
-cleanup() {
-  rm -rf "$tmp_dir"
-}
-trap cleanup EXIT
-
-collect_changed_files() {
-  local repo_root="${1:?repo root required}"
-  git -C "$repo_root" status --porcelain | sed -E 's/^...//' | sort -u
-}
-
-group_paths() {
-  awk -F/ '
-    NF == 0 { next }
-    {
-      limit = (NF < 5 ? NF : 5)
-      key = $1
-      for (i = 2; i <= limit; i++) {
-        key = key "/" $i
-      }
-      print key
-    }
-  ' | sort | uniq -c | sort -nr | sed 's/^ *//'
-}
-
-collect_changed_files "$PRIMARY_ROOT" >"${tmp_dir}/primary.txt"
-collect_changed_files "$SECONDARY_ROOT" >"${tmp_dir}/secondary.txt"
-
-comm -12 "${tmp_dir}/primary.txt" "${tmp_dir}/secondary.txt" >"${tmp_dir}/overlap.txt"
-comm -23 "${tmp_dir}/primary.txt" "${tmp_dir}/secondary.txt" >"${tmp_dir}/primary-only.txt"
-comm -13 "${tmp_dir}/primary.txt" "${tmp_dir}/secondary.txt" >"${tmp_dir}/secondary-only.txt"
-
-primary_count="$(wc -l <"${tmp_dir}/primary.txt" | tr -d ' ')"
-secondary_count="$(wc -l <"${tmp_dir}/secondary.txt" | tr -d ' ')"
-overlap_count="$(wc -l <"${tmp_dir}/overlap.txt" | tr -d ' ')"
-primary_only_count="$(wc -l <"${tmp_dir}/primary-only.txt" | tr -d ' ')"
-secondary_only_count="$(wc -l <"${tmp_dir}/secondary-only.txt" | tr -d ' ')"
-
-printf '%s_ROOT=%s\n' "$(printf '%s' "$PRIMARY_LABEL" | tr '[:lower:]-' '[:upper:]_')" "$PRIMARY_ROOT"
-printf '%s_ROOT=%s\n' "$(printf '%s' "$SECONDARY_LABEL" | tr '[:lower:]-' '[:upper:]_')" "$SECONDARY_ROOT"
-printf '%s_COUNT=%s\n' "$(printf '%s' "$PRIMARY_LABEL" | tr '[:lower:]-' '[:upper:]_')" "$primary_count"
-printf '%s_COUNT=%s\n' "$(printf '%s' "$SECONDARY_LABEL" | tr '[:lower:]-' '[:upper:]_')" "$secondary_count"
-printf 'OVERLAP_COUNT=%s\n' "$overlap_count"
-printf '%s_ONLY_COUNT=%s\n' "$(printf '%s' "$PRIMARY_LABEL" | tr '[:lower:]-' '[:upper:]_')" "$primary_only_count"
-printf '%s_ONLY_COUNT=%s\n' "$(printf '%s' "$SECONDARY_LABEL" | tr '[:lower:]-' '[:upper:]_')" "$secondary_only_count"
-printf '\n'
-
-printf '[%s-only-groups]\n' "$PRIMARY_LABEL"
-if [[ -s "${tmp_dir}/primary-only.txt" ]]; then
-  group_paths <"${tmp_dir}/primary-only.txt"
-else
-  printf 'none\n'
-fi
-printf '\n'
-
-printf '[%s-only-groups]\n' "$SECONDARY_LABEL"
-if [[ -s "${tmp_dir}/secondary-only.txt" ]]; then
-  group_paths <"${tmp_dir}/secondary-only.txt"
-else
-  printf 'none\n'
-fi
-printf '\n'
-
-printf '[overlap-groups]\n'
-if [[ -s "${tmp_dir}/overlap.txt" ]]; then
-  group_paths <"${tmp_dir}/overlap.txt"
-else
-  printf 'none\n'
-fi
-printf '\n'
-
-if [[ "$SUMMARY_ONLY" == "true" ]]; then
-  exit 0
-fi
-
-printf '[%s-only-files]\n' "$PRIMARY_LABEL"
-cat "${tmp_dir}/primary-only.txt"
-printf '\n'
-
-printf '[%s-only-files]\n' "$SECONDARY_LABEL"
-cat "${tmp_dir}/secondary-only.txt"
-printf '\n'
-
-printf '[overlap-files]\n'
-cat "${tmp_dir}/overlap.txt"