pi-proactive 0.0.0-stage → 0.2.0-beta.3

package/tools/daemon-uninstall.sh

@@ -0,0 +1,226 @@
+#!/usr/bin/env bash
+
+
+# pi-proactive 常驻助理：**一键卸载**（幂等 · 卸载后**零残留**）。
+#
+# 做四件事（顺序固定）：
+#   ① 停（herdr workspace / launchd / systemd；再兜底杀掉残留进程）
+#   ② 删（单元文件 / 日志 / socket / 状态目录）
+#   ③ 校验（**逐项列出证据**；有残留即非零退出 —— 不谎报「卸载成功」）
+#
+# 保留（默认不删）：`$agentDir/proactive/` 下的任务表 / 事件流 / 邮箱（**用户数据**，删不删由用户决定；
+#                `--purge-data` 才连它一起删）。
+#
+# 用法：
+#   bash pi-proactive/tools/daemon-uninstall.sh
+#   bash pi-proactive/tools/daemon-uninstall.sh --agent-dir <dir>
+#   bash pi-proactive/tools/daemon-uninstall.sh --no-start        # 只删文件，不动服务管理器（自测用）
+#   bash pi-proactive/tools/daemon-uninstall.sh --label <label>   # 指定 launchd 单元标签（必须与安装时一致）
+#   bash pi-proactive/tools/daemon-uninstall.sh --service-name <n># 指定 systemd 单元名（必须与安装时一致）
+#   bash pi-proactive/tools/daemon-uninstall.sh --purge-data      # 连用户数据一起删
+#
+# 退出码：0=卸载完成且无残留；1=有残留；2=环境不支持。
+set -uo pipefail
+
+PKG_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+LABEL="${PI_PROACTIVE_DAEMON_LABEL:-com.pi-proactive.daemon}"
+SERVICE_NAME="${PI_PROACTIVE_DAEMON_SERVICE:-pi-proactive-daemon.service}"
+WORKSPACE_LABEL="pi-proactive-daemon"
+
+AGENT_DIR="${PI_CODING_AGENT_DIR:-${HOME}/.pi/agent}"
+NO_START=0
+PURGE_DATA=0
+AGENT_ID="${PI_PROACTIVE_AGENT_ID:-}"
+while [ $# -gt 0 ]; do
+  case "$1" in
+    --agent-dir) AGENT_DIR="$2"; shift 2 ;;
+    --agent-id) AGENT_ID="$2"; shift 2 ;;
+    --label) LABEL="$2"; shift 2 ;;
+    --service-name) SERVICE_NAME="$2"; shift 2 ;;
+    # --host 只为与 cli 的参数契约一致（卸载会把所有宿主都停掉 → 不区分宿主）
+    --host) if [ $# -ge 2 ]; then shift 2; else shift; fi ;;
+    --no-start) NO_START=1; shift ;;
+    --purge-data) PURGE_DATA=1; shift ;;
+    -h|--help) sed -n '2,20p' "$0"; exit 0 ;;
+    *) echo "未知参数：$1" >&2; exit 2 ;;
+  esac
+done
+
+NODE_BIN="${NODE_BIN:-$(command -v node || true)}"
+DAEMON_DIR="${AGENT_DIR}/proactive/daemon"
+LOG_DIR="${DAEMON_DIR}"
+HOST_STATE_FILE="${DAEMON_DIR}/host.json"
+HEARTBEAT_FILE="${DAEMON_DIR}/heartbeat.json"
+RUNNER_FILE="${DAEMON_DIR}/run-daemon.sh"
+PROACTIVE_DIR="${AGENT_DIR}/proactive"
+
+# ---- 停 ----
+KIND=""
+AGENT_ID="${AGENT_ID:-}"
+if [ -f "${HOST_STATE_FILE}" ]; then
+  KIND="$(sed -n 's/.*"hostKind"[ ]*:[ ]*"\([^"]*\)".*/\1/p' "${HOST_STATE_FILE}")"
+  [ -n "${AGENT_ID}" ] || AGENT_ID="$(sed -n 's/.*"agentId"[ ]*:[ ]*"\([^"]*\)".*/\1/p' "${HOST_STATE_FILE}")"
+fi
+OLD_PID=""
+if [ -f "${HEARTBEAT_FILE}" ] && [ -n "${NODE_BIN}" ]; then
+  OLD_PID="$("$NODE_BIN" -e '
+const fs=require("fs");try{const j=JSON.parse(fs.readFileSync(process.argv[1],"utf8"));console.log(String(j.pid??""))}catch{console.log("")}' "${HEARTBEAT_FILE}")"
+fi
+
+if [ "${NO_START}" -ne 1 ]; then
+  # ---- 停（**不依赖 host.json**）----
+  # 为什么必须无条件停：host.json 可能缺失/损坏（用户手动删过状态目录、被别的工具清过）。
+  # 若「停」只按 host.json 里的 kind 走，卸载就只会删文件、**停不掉服务** →
+  # 留下「单元仍加载 + 进程还在」的孤儿，用户永远卸不干净
+  # （实测：只删 plist 后 `launchctl print` 仍成功 → 脚本自检报「残留」并 exit 1）。
+  WS_ID=""
+  case "$(uname -s)" in
+    Darwin)
+      launchctl bootout "gui/$(id -u)/${LABEL}" >/dev/null 2>&1 || true
+      launchctl unload "${HOME}/Library/LaunchAgents/${LABEL}.plist" >/dev/null 2>&1 || true
+      ;;
+    Linux)
+      if command -v systemctl >/dev/null 2>&1; then
+        systemctl --user disable --now "${SERVICE_NAME}" >/dev/null 2>&1 || true
+        systemctl --user reset-failed "${SERVICE_NAME}" >/dev/null 2>&1 || true
+      fi
+      ;;
+  esac
+  # herdr 宿主：按 label 关掉同名 workspace（纯 headless 容器，不影响用户自己的 pane）
+  if command -v herdr >/dev/null 2>&1 && [ -n "${NODE_BIN}" ]; then
+    WS_ID="$(sed -n 's/.*"workspaceId"[ ]*:[ ]*"\([^"]*\)".*/\1/p' "${HOST_STATE_FILE}" 2>/dev/null || true)"
+    if [ -z "${WS_ID}" ]; then
+      WS_ID="$(herdr workspace list 2>/dev/null | "${NODE_BIN}" -e '
+let s="";process.stdin.on("data",d=>s+=d).on("end",()=>{
+try{const j=JSON.parse(s);const ws=(j.result?.workspaces??[]).filter(w=>w.label===process.argv[1]);console.log(ws.map(w=>w.workspace_id).join(" "))}catch{console.log("")}})' "${WORKSPACE_LABEL}")"
+    fi
+    for w in ${WS_ID}; do
+      herdr workspace close "$w" >/dev/null 2>&1 || true
+    done
+  fi
+  case "${KIND}" in
+    herdr) echo "已停（herdr workspace）：${WS_ID:-无}" ;;
+    systemd) echo "已停（systemd --user）：${SERVICE_NAME}" ;;
+    launchd) echo "已停（launchd）：${LABEL}" ;;
+    *) echo "已停（按平台默认宿主；状态文件缺失 → 未能确认原宿主，仍按默认停了一遍）" ;;
+  esac
+  # ★监督器也要杀：监督器（run-daemon.sh）会**把值班进程再拉起来** →
+  #   只杀值班进程 = 没卸载干净（单元还在 → 几秒后又活了）。
+  if [ -f "${RUNNER_FILE}" ] || [ -n "${RUNNER_FILE}" ]; then
+    if pgrep -f "${RUNNER_FILE}" >/dev/null 2>&1; then
+      pkill -f "${RUNNER_FILE}" 2>/dev/null || true
+      sleep 1
+      pkill -9 -f "${RUNNER_FILE}" 2>/dev/null || true
+      echo "已结束残留监督器（${RUNNER_FILE}）"
+    fi
+  fi
+  # 兜底：进程还在就杀掉（常驻进程不该留在用户机器上）。
+  if [ -n "${OLD_PID}" ] && kill -0 "${OLD_PID}" 2>/dev/null; then
+    kill "${OLD_PID}" 2>/dev/null || true
+    sleep 1
+    kill -9 "${OLD_PID}" 2>/dev/null || true
+    echo "已结束残留进程：pid=${OLD_PID}"
+  fi
+fi
+
+# ---- 删 ----
+case "$(uname -s)" in
+Darwin)
+  rm -f "${HOME}/Library/LaunchAgents/${LABEL}.plist"
+  ;;
+Linux)
+  rm -f "${HOME}/.config/systemd/user/${SERVICE_NAME}"
+  if [ "${NO_START}" -ne 1 ] && command -v systemctl >/dev/null 2>&1; then
+    systemctl --user daemon-reload >/dev/null 2>&1 || true
+  fi
+  ;;
+esac
+
+# socket（常驻进程的端点；正常没有 → 顺手清掉）
+# socket 端点路径：模块按【运行环境】解析（产物态 build/… 优先，开发态 src/… 回落）
+SOCKET_MODULE=""
+SOCKET_CANDIDATES="src/socket.ts build/src/socket.js"
+for c in ${SOCKET_CANDIDATES}; do
+	[ -f "${PKG_ROOT}/${c}" ] && { SOCKET_MODULE="${PKG_ROOT}/${c}"; break; }
+done
+if [ -z "${SOCKET_MODULE}" ]; then
+  echo "警告：找不到 socket 模块（试过 ${SOCKET_CANDIDATES// /、}）→ socket 端点文件可能残留" >&2
+elif [ -n "${NODE_BIN}" ] && [ -n "${AGENT_ID}" ]; then
+  SOCK="$("$NODE_BIN" --experimental-strip-types -e '
+import(process.argv[1]).then(m=>{console.log(m.socketPathFor(process.argv[2], process.argv[3]))}).catch(()=>console.log(""))' "file://${SOCKET_MODULE}" "${AGENT_ID}" "${AGENT_DIR}" 2>/dev/null || true)"
+  [ -n "${SOCK}" ] && rm -f "${SOCK}"
+fi
+
+# 日志 / 状态目录（心跳 / 联系清单 / 交班摘要 / 宿主状态 / 启动器）
+rm -rf "${DAEMON_DIR}"
+
+if [ "${PURGE_DATA}" -eq 1 ]; then
+  rm -rf "${PROACTIVE_DIR}"
+  echo "已删用户数据（--purge-data）：${PROACTIVE_DIR}"
+else
+  echo "保留（未删）：${PROACTIVE_DIR} 下的任务表 / 事件流 / 邮箱（用户数据；--purge-data 才删）"
+fi
+
+# ---- 校验（逐项；有残留即非零退出）----
+RESIDUE=0
+check_gone() {
+  if [ -e "$1" ]; then
+    echo "残留：$2 仍在 $1" >&2
+    RESIDUE=1
+  else
+    echo "已清：$2"
+  fi
+}
+case "$(uname -s)" in
+Darwin) check_gone "${HOME}/Library/LaunchAgents/${LABEL}.plist" "LaunchAgent 单元" ;;
+Linux) check_gone "${HOME}/.config/systemd/user/${SERVICE_NAME}" "systemd 单元" ;;
+esac
+check_gone "${DAEMON_DIR}" "状态/日志目录"
+if pgrep -f "${RUNNER_FILE}" >/dev/null 2>&1; then
+  echo "残留：监督器进程还在（${RUNNER_FILE}）" >&2
+  RESIDUE=1
+else
+  echo "已清：监督器进程"
+fi
+if [ -n "${OLD_PID}" ] && kill -0 "${OLD_PID}" 2>/dev/null; then
+  echo "残留：进程还在（pid=${OLD_PID}）" >&2
+  RESIDUE=1
+else
+  echo "已清：进程（pid=${OLD_PID:-无}）"
+fi
+if [ "${NO_START}" -ne 1 ]; then
+  case "$(uname -s)" in
+  Darwin)
+    if launchctl print "gui/$(id -u)/${LABEL}" >/dev/null 2>&1; then
+      echo "残留：服务仍处于加载状态（launchctl print 成功）" >&2
+      RESIDUE=1
+    else
+      echo "已清：服务未加载"
+    fi
+    ;;
+  Linux)
+    if command -v systemctl >/dev/null 2>&1 && systemctl --user is-enabled "${SERVICE_NAME}" >/dev/null 2>&1; then
+      echo "残留：服务仍处于 enabled 状态" >&2
+      RESIDUE=1
+    else
+      echo "已清：服务未 enabled"
+    fi
+    ;;
+  esac
+fi
+
+if [ "${RESIDUE}" -ne 0 ]; then
+  echo "结果：存在残留（见上方）" >&2
+  echo "手工清理命令（逐条执行即可清干净）：" >&2
+  case "$(uname -s)" in
+    Darwin) echo "  launchctl bootout \"gui/$(id -u)/${LABEL}\" || true" >&2
+            echo "  rm -f \"${HOME}/Library/LaunchAgents/${LABEL}.plist\"" >&2 ;;
+    Linux)  echo "  systemctl --user disable --now \"${SERVICE_NAME}\" || true" >&2
+            echo "  rm -f \"${HOME}/.config/systemd/user/${SERVICE_NAME}\"" >&2 ;;
+  esac
+  echo "  pkill -f \"${RUNNER_FILE}\" || true" >&2
+  echo "  rm -rf \"${DAEMON_DIR}\"" >&2
+  exit 1
+fi
+echo "结果：卸载完成，无残留（exit 0）"
+exit 0