agent-control-plane 0.1.9 → 0.1.13

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"

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

@@ -1,228 +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}")"
-WORKTREE_ROOT="$(flow_resolve_worktree_root "${CONFIG_YAML}")"
-AGENT_ROOT="$(flow_resolve_agent_root "${CONFIG_YAML}")"
-RUNS_ROOT="$(flow_resolve_runs_root "${CONFIG_YAML}")"
-ADAPTER_ID="$(flow_resolve_adapter_id "${CONFIG_YAML}")"
-ADAPTER_ID_REGEX="$(flow_escape_regex "${ADAPTER_ID}")"
-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-retained-worktrees.sh [--cleanup] [--strict]
-
-Audits the retained human checkout for legacy automation worktrees that still
-attach to the retained repo's .git/worktrees metadata.
-
-Options:
-  --cleanup  Remove clean orphaned automation worktrees automatically.
-  --strict   Exit non-zero when any legacy automation 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 "$RETAINED_ROOT/.git" && ! -f "$RETAINED_ROOT/.git" ]]; then
-  echo "retained root is not a Git checkout: $RETAINED_ROOT" >&2
-  exit 1
-fi
-
-session_for_worktree() {
-  local worktree_path="${1:-}"
-  local branch_ref="${2:-}"
-  local base
-
-  base="$(basename "$worktree_path")"
-  if [[ "$base" =~ ^${ADAPTER_ID_REGEX}-pr-([0-9]+)$ ]]; then
-    printf '%s%s\n' "${PR_SESSION_PREFIX}" "${BASH_REMATCH[1]}"
-    return 0
-  fi
-  if [[ "$base" =~ ^pr-([0-9]+)- ]]; then
-    printf '%s%s\n' "${PR_SESSION_PREFIX}" "${BASH_REMATCH[1]}"
-    return 0
-  fi
-  if [[ "$base" =~ ^${ADAPTER_ID_REGEX}-issue-([0-9]+)$ ]]; then
-    printf '%s%s\n' "${ISSUE_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_legacy_automation_worktree() {
-  local worktree_path="${1:-}"
-  local branch_ref="${2:-}"
-  local base
-
-  base="$(basename "$worktree_path")"
-  if [[ "$worktree_path" == "$WORKTREE_ROOT/"* ]]; then
-    return 0
-  fi
-  case "$base" in
-    ${ADAPTER_ID}-main-clean|${ADAPTER_ID}-pr-*|${ADAPTER_ID}-issue-*) return 0 ;;
-  esac
-  if [[ "$branch_ref" == refs/heads/* ]] && branch_name_is_managed "${branch_ref#refs/heads/}"; then
-    return 0
-  fi
-  return 1
-}
-
-worktree_dirty() {
-  local worktree_path="${1:-}"
-  [[ -n "$(git -C "$worktree_path" status --short --untracked-files=normal)" ]]
-}
-
-worktree_has_active_owner() {
-  local session_name="${1:-}"
-  local status_output=""
-  local status=""
-
-  [[ -n "$session_name" ]] || return 1
-
-  if tmux has-session -t "$session_name" 2>/dev/null; then
-    return 0
-  fi
-
-  local 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="$(
-    bash "${BASH_SOURCE[0]%/*}/agent-project-worker-status" \
-      --runs-root "$RUNS_ROOT" \
-      --session "$session_name" 2>/dev/null || true
-  )"
-  status="$(awk -F= '/^STATUS=/{print $2}' <<<"$status_output" | tail -n 1)"
-  [[ "$status" == "RUNNING" ]]
-}
-
-remove_legacy_worktree() {
-  local worktree_path="${1:-}"
-  local branch_ref="${2:-}"
-  local branch_name=""
-
-  git -C "$RETAINED_ROOT" worktree remove "$worktree_path" --force
-
-  if [[ "$branch_ref" == refs/heads/* ]]; then
-    branch_name="${branch_ref#refs/heads/}"
-    if git -C "$RETAINED_ROOT" show-ref --verify --quiet "refs/heads/${branch_name}"; then
-      git -C "$RETAINED_ROOT" branch -D "$branch_name" >/dev/null 2>&1 || true
-    fi
-  fi
-}
-
-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" != "$RETAINED_ROOT" ]] && is_legacy_automation_worktree "$current_worktree" "$current_branch_ref"; then
-        issue_count=$((issue_count + 1))
-        session_name="$(session_for_worktree "$current_worktree" "$current_branch_ref" || true)"
-        dirty="no"
-        if worktree_dirty "$current_worktree"; then
-          dirty="yes"
-        fi
-        active_owner="no"
-        if worktree_has_active_owner "$session_name"; then
-          active_owner="yes"
-        fi
-
-        printf 'RETAINED_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 'DIRTY=%s\n' "$dirty"
-        printf 'ACTIVE_OWNER=%s\n' "$active_owner"
-
-        if [[ "$cleanup" == "true" && "$dirty" == "no" && "$active_owner" == "no" ]]; then
-          remove_legacy_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 "$RETAINED_ROOT" worktree list --porcelain; printf '\n')
-
-printf 'LEGACY_RETAINED_WORKTREE_COUNT=%s\n' "$issue_count"
-printf 'LEGACY_RETAINED_WORKTREE_CLEANED=%s\n' "$cleaned_count"
-
-if [[ "$strict" == "true" && "$issue_count" -gt 0 ]]; then
-  exit 2
-fi