agent-control-plane 0.3.0 → 0.6.0

package/tools/bin/flow-runtime-doctor-linux.sh

@@ -0,0 +1,136 @@
+#!/usr/bin/env bash
+# flow-runtime-doctor-linux.sh - Linux-specific runtime validation for ACP
+# Checks systemd services, Linux paths, and runtime health
+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]}")"
+CONTROL_PLANE_NAME="$(flow_canonical_skill_name)"
+RUNTIME_HOME="$(resolve_runtime_home)"
+
+echo "=== ACP Linux Runtime Doctor ==="
+echo ""
+
+# --- Systemd Checks ---
+echo "--- Systemd Service Status ---"
+if command -v systemctl &>/dev/null; then
+    echo "systemctl: available"
+    
+    # Check user services (systemd --user)
+    if systemctl --user is-active --quiet "${CONTROL_PLANE_NAME}.service" 2>/dev/null; then
+        echo "service ${CONTROL_PLANE_NAME}: active (user)"
+    elif systemctl --user is-enabled --quiet "${CONTROL_PLANE_NAME}.service" 2>/dev/null; then
+        echo "service ${CONTROL_PLANE_NAME}: installed but not running (user)"
+    else
+        echo "service ${CONTROL_PLANE_NAME}: not installed (user)"
+    fi
+    
+    # Check system services (if installed system-wide)
+    if systemctl is-active --quiet "${CONTROL_PLANE_NAME}.service" 2>/dev/null; then
+        echo "service ${CONTROL_PLANE_NAME}: active (system)"
+    fi
+else
+    echo "systemctl: NOT available (not a systemd-based system?)"
+fi
+echo ""
+
+# --- Linux Path Checks ---
+echo "--- Linux Path Validation ---"
+echo "RUNTIME_HOME=${RUNTIME_HOME}"
+echo "FLOW_SKILL_DIR=${FLOW_SKILL_DIR}"
+
+# Check XDG paths (Linux standard)
+XDG_CONFIG_HOME="${XDG_CONFIG_HOME:-$HOME/.config}"
+XDG_RUNTIME_DIR="${XDG_RUNTIME_DIR:-/run/user/$(id -u)}"
+
+echo "XDG_CONFIG_HOME=${XDG_CONFIG_HOME}"
+echo "XDG_RUNTIME_DIR=${XDG_RUNTIME_DIR}"
+
+if [[ -d "${XDG_RUNTIME_DIR}" ]]; then
+    echo "XDG_RUNTIME_DIR: exists"
+else
+    echo "XDG_RUNTIME_DIR: NOT FOUND (may cause issues with user services)"
+fi
+echo ""
+
+# --- Process Checks ---
+echo "--- Process Checks ---"
+if command -v pgrep &>/dev/null; then
+    AGENT_PIDS=$(pgrep -f "agent-control-plane" 2>/dev/null || true)
+    if [[ -n "${AGENT_PIDS}" ]]; then
+        echo "agent-control-plane processes running: yes (PIDs: ${AGENT_PIDS})"
+        ps -p "${AGENT_PIDS}" -o pid,ppid,cmd 2>/dev/null || true
+    else
+        echo "agent-control-plane processes running: no"
+    fi
+else
+    echo "pgrep: NOT available"
+fi
+echo ""
+
+# --- tmux Checks ---
+echo "--- tmux Session Checks ---"
+if command -v tmux &>/dev/null; then
+    echo "tmux: available ($(tmux -V))"
+    TMUX_SESSIONS=$(tmux ls 2>/dev/null | grep -c "agent-" || true)
+    echo "agent- tmux sessions: ${TMUX_SESSIONS}"
+    if [[ ${TMUX_SESSIONS} -gt 0 ]]; then
+        tmux ls 2>/dev/null | grep "agent-" || true
+    fi
+else
+    echo "tmux: NOT installed (required for ACP worker sessions)"
+fi
+echo ""
+
+# --- Socket/Port Checks ---
+echo "--- Socket/Port Checks ---"
+if command -v ss &>/dev/null; then
+    echo "Checking for dashboard port (3180)..."
+    ss -tlnp 2>/dev/null | grep ":3180 " || echo "Port 3180: not in use"
+elif command -v netstat &>/dev/null; then
+    netstat -tlnp 2>/dev/null | grep ":3180 " || echo "Port 3180: not in use"
+else
+    echo "ss/netstat: NOT available, skipping port check"
+fi
+echo ""
+
+# --- Log File Checks ---
+echo "--- Log File Checks ---"
+LOG_DIR="${RUNTIME_HOME}/logs"
+if [[ -d "${LOG_DIR}" ]]; then
+    echo "LOG_DIR=${LOG_DIR}: exists"
+    LOG_COUNT=$(find "${LOG_DIR}" -name "*.log" 2>/dev/null | wc -l)
+    echo "Log files: ${LOG_COUNT}"
+else
+    echo "LOG_DIR=${LOG_DIR}: NOT FOUND"
+fi
+echo ""
+
+# --- Run Generic Doctor ---
+echo "=== Generic Runtime Doctor ==="
+if [[ -f "${SCRIPT_DIR}/flow-runtime-doctor.sh" ]]; then
+    bash "${SCRIPT_DIR}/flow-runtime-doctor.sh"
+else
+    echo "flow-runtime-doctor.sh: NOT FOUND"
+fi
+
+echo ""
+echo "=== Linux Doctor Complete ==="
+echo ""
+echo "=== NEXT STEPS ==="
+if ! command -v systemctl &>/dev/null; then
+    echo "NOT on systemd: Use macOS launchd or manual tmux for runtime."
+elif ! systemctl --user is-active --quiet "${CONTROL_PLANE_NAME}.service" 2>/dev/null; then
+    echo "Service not running. Start with:"
+    echo "  systemctl --user start ${CONTROL_PLANE_NAME}.service"
+    echo "  systemctl --user enable ${CONTROL_PLANE_NAME}.service  # autostart"
+fi
+
+if ! command -v tmux &>/dev/null; then
+    echo "MISSING: tmux is required. Install:"
+    echo "  Ubuntu/Debian: sudo apt install tmux"
+    echo "  Alpine: apk add tmux"
+fi

package/tools/bin/flow-runtime-doctor.sh

@@ -93,5 +93,9 @@ if [[ -n "${PROFILE_SELECTION_HINT}" ]]; then
 fi
 
 if [[ "${status}" != "ok" ]]; then
-  printf 'NEXT_STEP=bash %q %q %q\n' "${SYNC_SCRIPT}" "${SHARED_AGENT_HOME}" "${RUNTIME_HOME}"
+  printf '\n=== ACTION REQUIRED ===\n'
+  printf 'Status: %s\n' "${status}"
+  printf 'Next step: Run sync to fix issues:\n'
+  printf '  bash %q %q %q\n' "${SYNC_SCRIPT}" "${SHARED_AGENT_HOME}" "${RUNTIME_HOME}"
+  printf '\nOr run: bash %s/tools/bin/setup.sh --resume\n' "${FLOW_SKILL_DIR}"
 fi

package/tools/bin/flow-shell-lib.sh

@@ -29,6 +29,38 @@ flow_resolve_python_bin() {
   return 1
 }
 
+flow_format_epoch_utc() {
+  local epoch="${1:-}"
+  local python_bin=""
+
+  if ! [[ "${epoch}" =~ ^[0-9]+$ ]] || [[ "${epoch}" == "0" ]]; then
+    return 1
+  fi
+
+  if date -u -r "${epoch}" +"%Y-%m-%dT%H:%M:%SZ" >/dev/null 2>&1; then
+    date -u -r "${epoch}" +"%Y-%m-%dT%H:%M:%SZ"
+    return 0
+  fi
+
+  if date -u -d "@${epoch}" +"%Y-%m-%dT%H:%M:%SZ" >/dev/null 2>&1; then
+    date -u -d "@${epoch}" +"%Y-%m-%dT%H:%M:%SZ"
+    return 0
+  fi
+
+  python_bin="$(flow_resolve_python_bin 2>/dev/null || true)"
+  if [[ -n "${python_bin}" ]]; then
+    "${python_bin}" - "${epoch}" <<'PY'
+import datetime
+import sys
+
+print(datetime.datetime.fromtimestamp(int(sys.argv[1]), datetime.timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ"))
+PY
+    return 0
+  fi
+
+  return 1
+}
+
 flow_compat_skill_alias() {
   printf '%s\n' "${AGENT_CONTROL_PLANE_COMPAT_ALIAS:-}"
 }

package/tools/bin/github-core-rate-limit-state.sh

@@ -0,0 +1,77 @@
+#!/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:
+  github-core-rate-limit-state.sh get
+  github-core-rate-limit-state.sh schedule [reason] [--next-at-epoch <unix-seconds>]
+  github-core-rate-limit-state.sh clear
+EOF
+}
+
+action="${1:-}"
+reason="${2:-github-api-rate-limit}"
+next_at_epoch=""
+
+if [[ $# -lt 1 ]]; then
+  usage >&2
+  exit 1
+fi
+
+shift || true
+if [[ $# -gt 0 ]]; then
+  reason="${1:-github-api-rate-limit}"
+  shift || true
+fi
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --next-at-epoch)
+      next_at_epoch="${2:-}"
+      shift 2
+      ;;
+    --help|-h)
+      usage
+      exit 0
+      ;;
+    *)
+      echo "unknown argument: $1" >&2
+      usage >&2
+      exit 1
+      ;;
+  esac
+done
+
+case "${action}" in
+  get|schedule|clear) ;;
+  *)
+    usage >&2
+    exit 1
+    ;;
+esac
+
+CONFIG_YAML="$(resolve_flow_config_yaml "${BASH_SOURCE[0]}")"
+STATE_ROOT="$(flow_resolve_state_root "${CONFIG_YAML}")"
+COOLDOWNS="$(flow_resolve_retry_cooldowns "${CONFIG_YAML}")"
+
+exec_args=(
+  --state-root "${STATE_ROOT}"
+  --kind github
+  --item-id core-api
+  --action "${action}"
+  --reason "${reason}"
+  --cooldowns "${COOLDOWNS}"
+)
+
+if [[ "${action}" == "schedule" && "${next_at_epoch}" =~ ^[0-9]+$ ]]; then
+  exec_args+=(--next-at-epoch "${next_at_epoch}")
+fi
+
+ACP_STATE_ROOT="${STATE_ROOT}" \
+ACP_RETRY_COOLDOWNS="${COOLDOWNS}" \
+exec bash "${SCRIPT_DIR}/agent-project-retry-state" "${exec_args[@]}"