agent-control-plane 0.3.0 → 0.6.0

package/tools/bin/new-pr-worktree.sh

@@ -1,50 +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"
-
-FLOW_SKILL_DIR="$(resolve_flow_skill_dir "${BASH_SOURCE[0]}")"
-if ! flow_require_explicit_profile_selection "${FLOW_SKILL_DIR}" "new-pr-worktree.sh"; then
-  exit 64
-fi
-FLOW_TOOLS_DIR="${FLOW_SKILL_DIR}/tools/bin"
-flow_export_project_env_aliases
-CONFIG_YAML="$(resolve_flow_config_yaml "${BASH_SOURCE[0]}")"
-AGENT_REPO_ROOT="$(flow_resolve_agent_repo_root "${CONFIG_YAML}")"
-AUTOMATION_REPO_ROOT="$(flow_resolve_repo_root "${CONFIG_YAML}")"
-WORKTREE_ROOT="$(flow_resolve_worktree_root "${CONFIG_YAML}")"
-RETAINED_REPO_ROOT="$(flow_resolve_retained_repo_root "${CONFIG_YAML}")"
-VSCODE_WORKSPACE_FILE="$(flow_resolve_vscode_workspace_file "${CONFIG_YAML}")"
-PR_WORKTREE_BRANCH_PREFIX="$(flow_resolve_pr_worktree_branch_prefix "${CONFIG_YAML}")"
-
-PR_NUMBER="${1:?usage: new-pr-worktree.sh PR_NUMBER HEAD_REF}"
-HEAD_REF="${2:?usage: new-pr-worktree.sh PR_NUMBER HEAD_REF}"
-
-ACP_AGENT_REPO_ROOT="$AGENT_REPO_ROOT" \
-F_LOSNING_AGENT_REPO_ROOT="$AGENT_REPO_ROOT" \
-  "${SCRIPT_DIR}/sync-agent-repo.sh" >/dev/null
-
-export ACP_REPO_ROOT="$AUTOMATION_REPO_ROOT"
-export F_LOSNING_REPO_ROOT="$AUTOMATION_REPO_ROOT"
-
-WORKTREE_OUT="$(
-  bash "${FLOW_TOOLS_DIR}/agent-project-open-pr-worktree" \
-    --repo-root "$AGENT_REPO_ROOT" \
-    --worktree-root "$WORKTREE_ROOT" \
-    --pr-number "$PR_NUMBER" \
-    --head-ref "$HEAD_REF" \
-    --local-branch-prefix "$PR_WORKTREE_BRANCH_PREFIX" \
-    --prepare-script "${SCRIPT_DIR}/prepare-worktree.sh"
-)"
-
-ACP_AGENT_REPO_ROOT="$AGENT_REPO_ROOT" \
-ACP_RETAINED_REPO_ROOT="$RETAINED_REPO_ROOT" \
-ACP_VSCODE_WORKSPACE_FILE="$VSCODE_WORKSPACE_FILE" \
-F_LOSNING_AGENT_REPO_ROOT="$AGENT_REPO_ROOT" \
-F_LOSNING_RETAINED_REPO_ROOT="$RETAINED_REPO_ROOT" \
-F_LOSNING_VSCODE_WORKSPACE_FILE="$VSCODE_WORKSPACE_FILE" \
-  "${SCRIPT_DIR}/sync-vscode-workspace.sh" >/dev/null 2>&1 || true
-
-printf '%s\n' "$WORKTREE_OUT"

package/tools/bin/new-worktree.sh

@@ -1,49 +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"
-
-FLOW_SKILL_DIR="$(resolve_flow_skill_dir "${BASH_SOURCE[0]}")"
-if ! flow_require_explicit_profile_selection "${FLOW_SKILL_DIR}" "new-worktree.sh"; then
-  exit 64
-fi
-CONFIG_YAML="$(resolve_flow_config_yaml "${BASH_SOURCE[0]}")"
-AGENT_REPO_ROOT="$(flow_resolve_agent_repo_root "${CONFIG_YAML}")"
-AUTOMATION_REPO_ROOT="$(flow_resolve_repo_root "${CONFIG_YAML}")"
-WORKTREE_ROOT="$(flow_resolve_worktree_root "${CONFIG_YAML}")"
-RETAINED_REPO_ROOT="$(flow_resolve_retained_repo_root "${CONFIG_YAML}")"
-VSCODE_WORKSPACE_FILE="$(flow_resolve_vscode_workspace_file "${CONFIG_YAML}")"
-FLOW_TOOLS_DIR="${FLOW_SKILL_DIR}/tools/bin"
-ISSUE_BRANCH_PREFIX="$(flow_resolve_issue_branch_prefix "${CONFIG_YAML}")"
-
-ISSUE_ID="${1:?usage: new-worktree.sh ISSUE_ID [SLUG]}"
-SLUG_INPUT="${2:-task}"
-
-ACP_AGENT_REPO_ROOT="$AGENT_REPO_ROOT" \
-F_LOSNING_AGENT_REPO_ROOT="$AGENT_REPO_ROOT" \
-  "${SCRIPT_DIR}/sync-agent-repo.sh" >/dev/null
-
-export ACP_REPO_ROOT="$AUTOMATION_REPO_ROOT"
-export F_LOSNING_REPO_ROOT="$AUTOMATION_REPO_ROOT"
-
-WORKTREE_OUT="$(
-  bash "${FLOW_TOOLS_DIR}/agent-project-open-issue-worktree" \
-    --repo-root "$AGENT_REPO_ROOT" \
-    --worktree-root "$WORKTREE_ROOT" \
-    --issue-id "$ISSUE_ID" \
-    --slug "$SLUG_INPUT" \
-    --branch-prefix "$ISSUE_BRANCH_PREFIX" \
-    --prepare-script "${SCRIPT_DIR}/prepare-worktree.sh"
-)"
-
-ACP_AGENT_REPO_ROOT="$AGENT_REPO_ROOT" \
-ACP_RETAINED_REPO_ROOT="$RETAINED_REPO_ROOT" \
-ACP_VSCODE_WORKSPACE_FILE="$VSCODE_WORKSPACE_FILE" \
-F_LOSNING_AGENT_REPO_ROOT="$AGENT_REPO_ROOT" \
-F_LOSNING_RETAINED_REPO_ROOT="$RETAINED_REPO_ROOT" \
-F_LOSNING_VSCODE_WORKSPACE_FILE="$VSCODE_WORKSPACE_FILE" \
-  "${SCRIPT_DIR}/sync-vscode-workspace.sh" >/dev/null 2>&1 || true
-
-printf '%s\n' "$WORKTREE_OUT"

package/tools/bin/pr-risk.sh

@@ -1,12 +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"
-
-PR_NUMBER="${1:?usage: pr-risk.sh PR_NUMBER}"
-FLOW_SKILL_DIR="$(resolve_flow_skill_dir "${BASH_SOURCE[0]}")"
-ADAPTER_BIN_DIR="${FLOW_SKILL_DIR}/bin"
-
-"${ADAPTER_BIN_DIR}/pr-risk.sh" "$PR_NUMBER"

package/tools/bin/prepare-worktree.sh

@@ -1,142 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-# shellcheck source=/dev/null
-source "${SCRIPT_DIR}/flow-config-lib.sh"
-
-CONFIG_YAML="$(resolve_flow_config_yaml "${BASH_SOURCE[0]}")"
-AGENT_REPO_ROOT="$(flow_resolve_agent_repo_root "${CONFIG_YAML}")"
-CANONICAL_REPO_ROOT="$(flow_resolve_repo_root "${CONFIG_YAML}")"
-DEFAULT_DEPENDENCY_SOURCE_ROOT="$CANONICAL_REPO_ROOT"
-DEPENDENCY_SOURCE_ROOT="${ACP_DEPENDENCY_SOURCE_ROOT:-$DEFAULT_DEPENDENCY_SOURCE_ROOT}"
-SYNC_DEPENDENCY_BASELINE_SCRIPT="${ACP_SYNC_DEPENDENCY_BASELINE_SCRIPT:-${SCRIPT_DIR}/sync-dependency-baseline.sh}"
-PACKAGE_MANAGER_BIN="${ACP_PACKAGE_MANAGER_BIN:-pnpm}"
-LOCAL_WORKSPACE_INSTALL="${ACP_WORKTREE_LOCAL_INSTALL:-false}"
-WORKTREE="${1:?usage: prepare-worktree.sh WORKTREE}"
-
-realpath_safe() {
-  local path="${1:-}"
-  [[ -n "$path" ]] || return 1
-  if command -v python3 >/dev/null 2>&1; then
-    python3 - "$path" <<'PY'
-import os
-import sys
-print(os.path.realpath(sys.argv[1]))
-PY
-    return
-  fi
-  cd "$path" 2>/dev/null && pwd -P
-}
-
-link_shared_path() {
-  local source_path="${1:?source path required}"
-  local target_path="${2:?target path required}"
-
-  [[ -e "$source_path" ]] || return 0
-  if [[ -L "$target_path" ]]; then
-    return 0
-  fi
-  if [[ -e "$target_path" ]]; then
-    return 0
-  fi
-
-  mkdir -p "$(dirname "$target_path")"
-  ln -s "$source_path" "$target_path"
-}
-
-dependency_source_ready() {
-  local repo_root="${1:?repo root required}"
-  local workspace_dir=""
-
-  [[ -e "$repo_root/node_modules" ]] || return 1
-
-  while IFS= read -r workspace_dir; do
-    [[ -n "$workspace_dir" ]] || continue
-    [[ -d "$workspace_dir" ]] || continue
-    [[ -e "$workspace_dir/node_modules" ]] || return 1
-  done < <(
-    find "$repo_root/apps" -mindepth 1 -maxdepth 1 -type d 2>/dev/null || true
-    find "$repo_root/packages" -mindepth 1 -maxdepth 1 -type d 2>/dev/null || true
-  )
-}
-
-link_workspace_node_modules() {
-  local dependency_root="${1:?dependency root required}"
-  local worktree_root="${2:?worktree root required}"
-  local workspace_dir=""
-  local relative_path=""
-
-  while IFS= read -r workspace_dir; do
-    [[ -n "$workspace_dir" ]] || continue
-    [[ -d "$workspace_dir/node_modules" ]] || continue
-    relative_path="${workspace_dir#${dependency_root}/}"
-    link_shared_path "$workspace_dir/node_modules" "$worktree_root/$relative_path/node_modules"
-  done < <(
-    find "$dependency_root/apps" -mindepth 1 -maxdepth 1 -type d 2>/dev/null || true
-    find "$dependency_root/packages" -mindepth 1 -maxdepth 1 -type d 2>/dev/null || true
-  )
-}
-
-configure_worktree_excludes() {
-  local worktree="${1:?worktree required}"
-  local exclude_file="${worktree}/.openclaw-artifacts/git-exclude"
-
-  cat >"$exclude_file" <<'EOF'
-node_modules
-apps/*/node_modules
-packages/*/node_modules
-.openclaw-artifacts
-.openclaw
-SOUL.md
-TOOLS.md
-IDENTITY.md
-USER.md
-HEARTBEAT.md
-BOOTSTRAP.md
-.agent-session.env
-EOF
-
-  git -C "$worktree" config extensions.worktreeConfig true >/dev/null 2>&1 || true
-  git -C "$worktree" config --worktree core.excludesFile "$exclude_file"
-}
-
-WORKTREE_REAL="$(realpath_safe "$WORKTREE")"
-CANONICAL_REAL="$(realpath_safe "$CANONICAL_REPO_ROOT")"
-DEPENDENCY_REAL="$(realpath_safe "$DEPENDENCY_SOURCE_ROOT")"
-
-if [[ -n "$CANONICAL_REAL" && "$WORKTREE_REAL" == "$CANONICAL_REAL" ]]; then
-  echo "refusing to prepare canonical checkout as worker worktree: $WORKTREE" >&2
-  exit 1
-fi
-
-if [[ -n "$DEPENDENCY_REAL" && "$WORKTREE_REAL" == "$DEPENDENCY_REAL" ]]; then
-  echo "refusing to prepare retained checkout as worker worktree: $WORKTREE" >&2
-  exit 1
-fi
-
-mkdir -p "$WORKTREE/.openclaw-artifacts"
-configure_worktree_excludes "$WORKTREE"
-
-if [[ -x "$SYNC_DEPENDENCY_BASELINE_SCRIPT" && "$DEPENDENCY_REAL" == "$CANONICAL_REAL" ]]; then
-  # Sync dependency baseline is non-fatal — worker can function without it
-  # (especially for repos with zero dependencies or external volume issues)
-  "$SYNC_DEPENDENCY_BASELINE_SCRIPT" >/dev/null 2>&1 || true
-fi
-
-if [[ "$LOCAL_WORKSPACE_INSTALL" == "true" ]]; then
-  (
-    cd "$WORKTREE"
-    CI=1 "$PACKAGE_MANAGER_BIN" install --frozen-lockfile --prefer-offline
-  )
-else
-  if ! dependency_source_ready "$DEPENDENCY_SOURCE_ROOT"; then
-    echo "dependency source is missing required node_modules or built workspace artifacts: $DEPENDENCY_SOURCE_ROOT" >&2
-    exit 1
-  fi
-  link_shared_path "$DEPENDENCY_SOURCE_ROOT/node_modules" "$WORKTREE/node_modules"
-  link_workspace_node_modules "$DEPENDENCY_SOURCE_ROOT" "$WORKTREE"
-fi
-
-printf 'WORKTREE=%s\n' "$WORKTREE"
-printf 'SANDBOX_ARTIFACT_DIR=%s\n' "$WORKTREE/.openclaw-artifacts"

package/tools/bin/provider-cooldown-state.sh

@@ -1,204 +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"
-
-usage() {
-  cat <<'EOF'
-Usage:
-  provider-cooldown-state.sh [backend] [model] get|schedule|clear [reason]
-
-Examples:
-  provider-cooldown-state.sh get
-  provider-cooldown-state.sh openclaw openrouter/qwen/qwen3.6-plus-preview:free schedule provider-quota-limit
-EOF
-}
-
-backend=""
-model=""
-action=""
-reason=""
-label=""
-
-case "$#" in
-  1)
-    action="${1:-}"
-    ;;
-  2)
-    action="${1:-}"
-    reason="${2:-}"
-    ;;
-  3)
-    backend="${1:-}"
-    model="${2:-}"
-    action="${3:-}"
-    ;;
-  4)
-    backend="${1:-}"
-    model="${2:-}"
-    action="${3:-}"
-    reason="${4:-}"
-    ;;
-  *)
-    usage >&2
-    exit 1
-    ;;
-esac
-
-CONFIG_YAML="$(resolve_flow_config_yaml "${BASH_SOURCE[0]}")"
-flow_export_execution_env "${CONFIG_YAML}"
-STATE_ROOT="$(flow_resolve_state_root "${CONFIG_YAML}")"
-COOLDOWNS="$(flow_resolve_provider_quota_cooldowns "${CONFIG_YAML}")"
-
-resolve_backend() {
-  local raw_backend="${1:-}"
-
-  if [[ -n "${raw_backend}" ]]; then
-    printf '%s\n' "${raw_backend}"
-    return 0
-  fi
-
-  if [[ -n "${CODING_WORKER:-}" ]]; then
-    printf '%s\n' "${CODING_WORKER}"
-    return 0
-  fi
-
-  if [[ -n "${ACP_ACTIVE_PROVIDER_BACKEND:-}" ]]; then
-    printf '%s\n' "${ACP_ACTIVE_PROVIDER_BACKEND:-}"
-    return 0
-  fi
-
-  if [[ -n "${ACP_CODING_WORKER:-}" ]]; then
-    printf '%s\n' "${ACP_CODING_WORKER:-}"
-    return 0
-  fi
-
-  flow_config_get "${CONFIG_YAML}" "execution.coding_worker"
-}
-
-resolve_codex_label() {
-  local configured_label="${ACP_ACTIVE_PROVIDER_LABEL:-}"
-  local codex_quota_bin=""
-  local active_label=""
-
-  if [[ -n "${configured_label}" ]]; then
-    printf '%s\n' "${configured_label}"
-    return 0
-  fi
-
-  if [[ -n "${ACP_CODEX_QUOTA_LABEL:-}" ]]; then
-    printf '%s\n' "${ACP_CODEX_QUOTA_LABEL:-}"
-    return 0
-  fi
-
-  codex_quota_bin="$(flow_resolve_codex_quota_bin "${SCRIPT_DIR}")"
-  if [[ -n "${codex_quota_bin}" && -x "${codex_quota_bin}" ]]; then
-    active_label="$("${codex_quota_bin}" codex list --json 2>/dev/null | jq -r '.activeInfo.trackedLabel // .activeInfo.activeLabel // empty' 2>/dev/null || true)"
-    if [[ -n "${active_label}" ]]; then
-      printf '%s\n' "${active_label}"
-      return 0
-    fi
-  fi
-
-  return 1
-}
-
-resolve_model() {
-  local resolved_backend="${1:?backend required}"
-  local raw_model="${2:-}"
-  local active_provider_model="${ACP_ACTIVE_PROVIDER_MODEL:-}"
-
-  if [[ -n "${raw_model}" ]]; then
-    printf '%s\n' "${raw_model}"
-    return 0
-  fi
-
-  case "${resolved_backend}" in
-    openclaw)
-      if [[ -n "${OPENCLAW_MODEL:-}" ]]; then
-        printf '%s\n' "${OPENCLAW_MODEL}"
-      elif [[ -n "${active_provider_model}" ]]; then
-        printf '%s\n' "${active_provider_model}"
-      elif [[ -n "${ACP_OPENCLAW_MODEL:-}" ]]; then
-        printf '%s\n' "${ACP_OPENCLAW_MODEL:-}"
-      else
-        flow_config_get "${CONFIG_YAML}" "execution.openclaw.model"
-      fi
-      ;;
-    claude)
-      if [[ -n "${CLAUDE_MODEL:-}" ]]; then
-        printf '%s\n' "${CLAUDE_MODEL}"
-      elif [[ -n "${active_provider_model}" ]]; then
-        printf '%s\n' "${active_provider_model}"
-      elif [[ -n "${ACP_CLAUDE_MODEL:-}" ]]; then
-        printf '%s\n' "${ACP_CLAUDE_MODEL:-}"
-      else
-        flow_config_get "${CONFIG_YAML}" "execution.claude.model"
-      fi
-      ;;
-    codex)
-      if [[ -n "${CODEX_PROFILE_SAFE:-}" ]]; then
-        printf '%s\n' "${CODEX_PROFILE_SAFE}"
-      elif [[ -n "${active_provider_model}" ]]; then
-        printf '%s\n' "${active_provider_model}"
-      elif [[ -n "${ACP_CODEX_PROFILE_SAFE:-}" ]]; then
-        printf '%s\n' "${ACP_CODEX_PROFILE_SAFE:-}"
-      else
-        flow_config_get "${CONFIG_YAML}" "execution.safe_profile"
-      fi
-      ;;
-    *)
-      printf '\n'
-      ;;
-  esac
-}
-
-backend="$(resolve_backend "${backend}")"
-if [[ -z "${backend}" ]]; then
-  echo "provider backend is required" >&2
-  exit 1
-fi
-
-model="$(resolve_model "${backend}" "${model}")"
-if [[ -z "${model}" ]]; then
-  echo "provider model/profile is required for backend ${backend}" >&2
-  exit 1
-fi
-
-case "${action}" in
-  get|schedule|clear) ;;
-  *)
-    usage >&2
-    exit 1
-    ;;
-esac
-
-if [[ "${backend}" == "codex" ]]; then
-  label="$(resolve_codex_label || true)"
-fi
-
-provider_key_source="${backend}-${model}"
-if [[ "${backend}" == "codex" && -n "${label}" ]]; then
-  provider_key_source="${provider_key_source}-${label}"
-fi
-
-provider_key="$(flow_sanitize_provider_key "${provider_key_source}")"
-out="$(
-  ACP_STATE_ROOT="${STATE_ROOT}" \
-  ACP_PROVIDER_QUOTA_COOLDOWNS="${COOLDOWNS}" \
-  bash "${SCRIPT_DIR}/agent-project-retry-state" \
-    --state-root "${STATE_ROOT}" \
-    --kind provider \
-    --item-id "${provider_key}" \
-    --action "${action}" \
-    --reason "${reason}" \
-    --cooldowns "${COOLDOWNS}"
-)"
-
-printf 'BACKEND=%s\n' "${backend}"
-printf 'MODEL=%s\n' "${model}"
-printf 'LABEL=%s\n' "${label}"
-printf 'PROVIDER_KEY=%s\n' "${provider_key}"
-printf '%s\n' "${out}"

package/tools/bin/publish-issue-worker.sh

@@ -1,31 +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"
-
-SESSION="${1:?usage: publish-issue-worker.sh SESSION [--dry-run]}"
-DRY_RUN="${2:-}"
-FLOW_SKILL_DIR="$(resolve_flow_skill_dir "${BASH_SOURCE[0]}")"
-FLOW_TOOLS_DIR="${FLOW_SKILL_DIR}/tools/bin"
-CONFIG_YAML="$(resolve_flow_config_yaml "${BASH_SOURCE[0]}")"
-AGENT_ROOT="$(flow_resolve_agent_root "${CONFIG_YAML}")"
-RUNS_ROOT="$(flow_resolve_runs_root "${CONFIG_YAML}")"
-HISTORY_ROOT="$(flow_resolve_history_root "${CONFIG_YAML}")"
-REPO_SLUG="$(flow_resolve_repo_slug "${CONFIG_YAML}")"
-BASE_BRANCH="$(flow_resolve_default_branch "${CONFIG_YAML}")"
-
-ARGS=(
-  --repo-slug "$REPO_SLUG"
-  --runs-root "$RUNS_ROOT"
-  --history-root "$HISTORY_ROOT"
-  --session "$SESSION"
-  --base-branch "$BASE_BRANCH"
-  --remote "origin"
-)
-if [[ "$DRY_RUN" == "--dry-run" ]]; then
-  ARGS+=(--dry-run)
-fi
-
-bash "${FLOW_TOOLS_DIR}/agent-project-publish-issue-pr" "${ARGS[@]}"

package/tools/bin/reconcile-bootstrap-lib.sh

@@ -1,113 +0,0 @@
-#!/usr/bin/env bash
-# reconcile-bootstrap-lib.sh — shared bootstrap helpers for reconcile scripts.
-# Sourced by both agent-project-reconcile-pr-session and
-# agent-project-reconcile-issue-session to avoid duplicating the bootstrap
-# preamble.
-
-bootstrap_flow_shell_lib() {
-  local candidate=""
-  local skill_name=""
-
-  for candidate in \
-    "${SCRIPT_DIR}/flow-shell-lib.sh" \
-    "${AGENT_CONTROL_PLANE_ROOT:-}/tools/bin/flow-shell-lib.sh" \
-    "${ACP_ROOT:-}/tools/bin/flow-shell-lib.sh" \
-    "${F_LOSNING_FLOW_ROOT:-}/tools/bin/flow-shell-lib.sh" \
-    "${AGENT_FLOW_SKILL_ROOT:-}/tools/bin/flow-shell-lib.sh" \
-    "${SHARED_AGENT_HOME:-}/tools/bin/flow-shell-lib.sh" \
-    "$(pwd)/tools/bin/flow-shell-lib.sh"; do
-    if [[ -n "${candidate}" && -f "${candidate}" ]]; then
-      printf '%s\n' "${candidate}"
-      return 0
-    fi
-  done
-
-  if [[ -n "${SHARED_AGENT_HOME:-}" ]]; then
-    for skill_name in "${AGENT_CONTROL_PLANE_SKILL_NAME:-agent-control-plane}" "${AGENT_CONTROL_PLANE_COMPAT_ALIAS:-}"; do
-      [[ -n "${skill_name}" ]] || continue
-      candidate="${SHARED_AGENT_HOME}/skills/openclaw/${skill_name}/tools/bin/flow-shell-lib.sh"
-      if [[ -f "${candidate}" ]]; then
-        printf '%s\n' "${candidate}"
-        return 0
-      fi
-    done
-  fi
-
-  echo "unable to locate flow-shell-lib.sh for reconcile bootstrap" >&2
-  return 1
-}
-
-FLOW_SHELL_LIB_PATH="$(bootstrap_flow_shell_lib)"
-BOOTSTRAP_TOOLS_DIR="$(cd "$(dirname "${FLOW_SHELL_LIB_PATH}")" && pwd)"
-# shellcheck source=/dev/null
-source "${FLOW_SHELL_LIB_PATH}"
-
-resolve_reconcile_tools_dir() {
-  local candidate_root=""
-  local skill_name=""
-
-  for candidate_root in \
-    "${AGENT_CONTROL_PLANE_ROOT:-}" \
-    "${ACP_ROOT:-}" \
-    "${F_LOSNING_FLOW_ROOT:-}" \
-    "${AGENT_FLOW_SKILL_ROOT:-}"; do
-    if [[ -n "${candidate_root}" && -d "${candidate_root}/tools/bin" ]]; then
-      printf '%s/tools/bin\n' "${candidate_root}"
-      return 0
-    fi
-  done
-
-  if [[ -n "${SHARED_AGENT_HOME:-}" ]]; then
-    if [[ -d "${SHARED_AGENT_HOME}/tools/bin" ]]; then
-      printf '%s/tools/bin\n' "${SHARED_AGENT_HOME}"
-      return 0
-    fi
-    for skill_name in "${AGENT_CONTROL_PLANE_SKILL_NAME:-agent-control-plane}" "${AGENT_CONTROL_PLANE_COMPAT_ALIAS:-}"; do
-      [[ -n "${skill_name}" ]] || continue
-      candidate_root="${SHARED_AGENT_HOME}/skills/openclaw/${skill_name}"
-      if [[ -d "${candidate_root}/tools/bin" ]]; then
-        printf '%s/tools/bin\n' "${candidate_root}"
-        return 0
-      fi
-    done
-  fi
-
-  if [[ -d "${SCRIPT_DIR}" ]]; then
-    printf '%s\n' "${SCRIPT_DIR}"
-    return 0
-  fi
-
-  printf '%s\n' "${BOOTSTRAP_TOOLS_DIR}"
-}
-
-shared_tools_dir="$(resolve_reconcile_tools_dir)"
-resolve_reconcile_helper_path() {
-  local helper_name="${1:?helper name required}"
-  local candidate=""
-
-  for candidate in \
-    "${SCRIPT_DIR}/${helper_name}" \
-    "${BOOTSTRAP_TOOLS_DIR}/${helper_name}" \
-    "${shared_tools_dir}/${helper_name}"; do
-    if [[ -n "${candidate}" && -f "${candidate}" ]]; then
-      printf '%s\n' "${candidate}"
-      return 0
-    fi
-  done
-
-  echo "unable to locate ${helper_name} for reconcile bootstrap" >&2
-  return 1
-}
-
-FLOW_CONFIG_LIB_PATH="$(resolve_reconcile_helper_path "flow-config-lib.sh")"
-# shellcheck source=/dev/null
-source "${FLOW_CONFIG_LIB_PATH}"
-
-require_transition() {
-  local step="${1:?step required}"
-  shift
-  if ! "$@"; then
-    echo "reconcile transition failed: ${step}" >&2
-    exit 1
-  fi
-}

package/tools/bin/reconcile-issue-worker.sh

@@ -1,34 +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"
-# shellcheck source=/dev/null
-source "${SCRIPT_DIR}/flow-config-lib.sh"
-
-SESSION="${1:?usage: reconcile-issue-worker.sh SESSION}"
-WORKSPACE_DIR="$(cd "$(dirname "$0")/.." && pwd)"
-CONFIG_YAML="$(resolve_flow_config_yaml "${BASH_SOURCE[0]}")"
-AGENT_ROOT="$(flow_resolve_agent_root "${CONFIG_YAML}")"
-RUNS_ROOT="$(flow_resolve_runs_root "${CONFIG_YAML}")"
-HISTORY_ROOT="$(flow_resolve_history_root "${CONFIG_YAML}")"
-REPO_SLUG="$(flow_resolve_repo_slug "${CONFIG_YAML}")"
-AGENT_REPO_ROOT="$(flow_resolve_agent_repo_root "${CONFIG_YAML}")"
-FLOW_SKILL_DIR="$(resolve_flow_skill_dir "${BASH_SOURCE[0]}")"
-FLOW_TOOLS_DIR="${FLOW_SKILL_DIR}/tools/bin"
-HOOK_FILE="${FLOW_SKILL_DIR}/hooks/issue-reconcile-hooks.sh"
-
-ACP_AGENT_ROOT="$AGENT_ROOT" \
-ACP_RUNS_ROOT="$RUNS_ROOT" \
-ACP_HISTORY_ROOT="$HISTORY_ROOT" \
-ACP_REPO_SLUG="$REPO_SLUG" \
-ACP_AGENT_REPO_ROOT="$AGENT_REPO_ROOT" \
-F_LOSNING_RUNS_ROOT="$RUNS_ROOT" \
-  bash "${FLOW_TOOLS_DIR}/agent-project-reconcile-issue-session" \
-    --session "$SESSION" \
-    --repo-slug "$REPO_SLUG" \
-    --repo-root "$AGENT_REPO_ROOT" \
-    --runs-root "$RUNS_ROOT" \
-    --history-root "$HISTORY_ROOT" \
-    --hook-file "$HOOK_FILE"

package/tools/bin/reconcile-pr-worker.sh

@@ -1,34 +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"
-# shellcheck source=/dev/null
-source "${SCRIPT_DIR}/flow-config-lib.sh"
-
-SESSION="${1:?usage: reconcile-pr-worker.sh SESSION}"
-WORKSPACE_DIR="$(cd "$(dirname "$0")/.." && pwd)"
-CONFIG_YAML="$(resolve_flow_config_yaml "${BASH_SOURCE[0]}")"
-AGENT_ROOT="$(flow_resolve_agent_root "${CONFIG_YAML}")"
-RUNS_ROOT="$(flow_resolve_runs_root "${CONFIG_YAML}")"
-HISTORY_ROOT="$(flow_resolve_history_root "${CONFIG_YAML}")"
-REPO_SLUG="$(flow_resolve_repo_slug "${CONFIG_YAML}")"
-AGENT_REPO_ROOT="$(flow_resolve_agent_repo_root "${CONFIG_YAML}")"
-FLOW_SKILL_DIR="$(resolve_flow_skill_dir "${BASH_SOURCE[0]}")"
-FLOW_TOOLS_DIR="${FLOW_SKILL_DIR}/tools/bin"
-HOOK_FILE="${FLOW_SKILL_DIR}/hooks/pr-reconcile-hooks.sh"
-
-ACP_AGENT_ROOT="$AGENT_ROOT" \
-ACP_RUNS_ROOT="$RUNS_ROOT" \
-ACP_HISTORY_ROOT="$HISTORY_ROOT" \
-ACP_REPO_SLUG="$REPO_SLUG" \
-ACP_AGENT_REPO_ROOT="$AGENT_REPO_ROOT" \
-F_LOSNING_RUNS_ROOT="$RUNS_ROOT" \
-  bash "${FLOW_TOOLS_DIR}/agent-project-reconcile-pr-session" \
-    --session "$SESSION" \
-    --repo-slug "$REPO_SLUG" \
-    --repo-root "$AGENT_REPO_ROOT" \
-    --runs-root "$RUNS_ROOT" \
-    --history-root "$HISTORY_ROOT" \
-    --hook-file "$HOOK_FILE"