tmuxclihook 0.5.13 → 0.5.15

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tmuxclihook",
-  "version": "0.5.13",
+  "version": "0.5.15",
   "description": "交互式 TUI 安装器：环境侦测、AI CLI 侦测、tmux-ai-status hooks 装/卸/修、TPM 软链校验",
   "type": "module",
   "bin": {

package/scripts/adapters/codex.sh

@@ -219,7 +219,8 @@ adapter_uninstall_hooks() {
         local stripped
         stripped=$(_codex_read_existing | _codex_strip_managed)
         if [ "$(printf '%s' "$stripped" | jq -c .)" = "{}" ]; then
-            rm -f "$ADAPTER_HOOKS_FILE"
+            # 符号链接（cc-switch 实例共享真源）只删真实目标，保留链接
+            _install_remove_target "$ADAPTER_HOOKS_FILE"
             echo "Codex hooks uninstalled (removed empty $ADAPTER_HOOKS_FILE)"
         else
             _install_atomic_write "$stripped" "$ADAPTER_HOOKS_FILE"

package/scripts/adapters/opencode.sh

@@ -225,7 +225,8 @@ adapter_install_hooks() {
 adapter_uninstall_hooks() {
     if [ -f "$ADAPTER_HOOKS_FILE" ]; then
         if grep -q "$_OPENCODE_MARKER" "$ADAPTER_HOOKS_FILE" 2>/dev/null; then
-            rm -f "$ADAPTER_HOOKS_FILE"
+            # 符号链接只删真实目标，保留链接（与原子写一致）
+            _install_remove_target "$ADAPTER_HOOKS_FILE"
             echo "opencode plugin uninstalled (removed $ADAPTER_HOOKS_FILE)"
         else
             echo "opencode plugin: $ADAPTER_HOOKS_FILE 非本插件生成，跳过删除"

package/scripts/install-claude-hooks.sh

@@ -45,6 +45,9 @@ esac
 case "${1:-install}" in
     uninstall)
         adapter_uninstall_hooks
+        # 先清安装意图再写卸载意图：suppress 写失败时 errexit 会退出，此顺序
+        # 保证 installed 不残留（残留会让 _refresh 把刚卸载的 hooks 装回来）。
+        _hooks_installed_clear claude || true
         _hooks_suppress_write claude
         ;;
     check)
@@ -66,15 +69,18 @@ case "${1:-install}" in
         # install 收敛。结构漂移（async/matcher 被外部改）不在判定内，auto 跳过
         # 不修复，显式 install 仍强收敛。
         if adapter_check_converged; then
+            _hooks_installed_ensure claude || true
             echo "claude hooks already converged (skip install)"
             exit 0
         fi
         adapter_install_hooks
         _hooks_suppress_clear claude || true
+        _hooks_installed_ensure claude || true
         ;;
     install)
         adapter_install_hooks
         _hooks_suppress_clear claude || true
+        _hooks_installed_ensure claude || true
         ;;
     *)
         echo "Usage: $0 [install|uninstall|check [--json]|auto]" >&2

package/scripts/install-codex-hooks.sh

@@ -40,6 +40,8 @@ esac
 case "${1:-install}" in
     uninstall)
         adapter_uninstall_hooks
+        # 先清安装意图再写卸载意图（理由同 claude wrapper）
+        _hooks_installed_clear codex || true
         _hooks_suppress_write codex
         ;;
     check)
@@ -55,6 +57,7 @@ case "${1:-install}" in
     install)
         adapter_install_hooks
         _hooks_suppress_clear codex || true
+        _hooks_installed_ensure codex || true
         ;;
     *)
         echo "Usage: $0 [install|uninstall|check [--json]]" >&2

package/scripts/install-opencode-hooks.sh

@@ -40,6 +40,8 @@ esac
 case "${1:-install}" in
     uninstall)
         adapter_uninstall_hooks
+        # 先清安装意图再写卸载意图（理由同 claude wrapper）
+        _hooks_installed_clear opencode || true
         _hooks_suppress_write opencode
         ;;
     check)
@@ -55,6 +57,7 @@ case "${1:-install}" in
     install)
         adapter_install_hooks
         _hooks_suppress_clear opencode || true
+        _hooks_installed_ensure opencode || true
         ;;
     *)
         echo "Usage: $0 [install|uninstall|check [--json]]" >&2

package/scripts/lib-install-hooks.sh

@@ -15,14 +15,45 @@ _install_require_jq() {
     fi
 }
 
-# 原子写入：mktemp 与目标同目录 → 同文件系统 → mv 原子。
+# 解析符号链接到最终真实路径（不要求目标存在——悬空链接同样要解析）。
+# 相对链接基于链接所在目录解析；循环/超深链（>40 层）返回 1，调用方回退原路径。
+# 用途：cc-switch 为每个 codex provider 建独立 CODEX_HOME，并把 hooks.json 做成
+# 指向 ~/.codex/hooks.json 的符号链接（所有实例共享同一真源）。mv 作用于链接路径
+# 时只替换链接本身，因此写入必须解析到真实目标，否则实例与共享真源分叉。
+_install_real_target() {  # $1=路径 → stdout 最终路径
+    local p="$1" link n=0
+    while [ -L "$p" ]; do
+        n=$((n + 1))
+        [ "$n" -le 40 ] || return 1
+        link=$(readlink "$p" 2>/dev/null) || return 1
+        [ -n "$link" ] || return 1
+        case "$link" in
+            /*) p="$link" ;;
+            *)  p="$(dirname "$p")/$link" ;;
+        esac
+    done
+    printf '%s\n' "$p"
+}
+
+# 原子写入：mktemp 与真实目标同目录 → 同文件系统 → mv 原子。
 # 避免与 AI CLI 并发写产生竞态导致 hooks 字段丢失。
+# 符号链接先解析：临时文件建在真实目标目录，mv 写穿链接（保留链接本身）。
 _install_atomic_write() {
-    local content="$1" target="$2" tmp
-    mkdir -p "$(dirname "$target")" 2>/dev/null || true
-    tmp=$(mktemp "$(dirname "$target")/.hooks.XXXXXX")
+    local content="$1" target="$2" tmp real
+    real=$(_install_real_target "$target") || real="$target"
+    mkdir -p "$(dirname "$real")" 2>/dev/null || true
+    tmp=$(mktemp "$(dirname "$real")/.hooks.XXXXXX")
     printf '%s\n' "$content" > "$tmp"
-    mv -f "$tmp" "$target"
+    mv -f "$tmp" "$real"
+}
+
+# 删除写入目标（uninstall 清空时用）：符号链接解析后只删真实目标，保留链接
+# （指向悬空，下次 install 写穿即恢复共享）。直接 rm 链接会删掉链接本身，把
+# 共享真源留在原地——其他实例仍被注册，语义与「卸载」矛盾。
+_install_remove_target() {  # $1=路径
+    local target="$1" real
+    real=$(_install_real_target "$target") || real="$target"
+    rm -f "$real"
 }
 
 # --- 卸载意图标记（suppression marker）---
@@ -55,6 +86,32 @@ _hooks_suppress_clear() {
     fi
 }
 
+# --- 安装意图标记（installed marker）---
+# 显式 install / claude auto（含已收敛跳过）→ 写；显式 uninstall → 删。
+# 语义 = 用户装过该工具；跨工具自修复（_maybe_repair_other_tools）据此决定
+# hooks 丢失时是否允许自动重装。无标记 + check 失败时绝不安装——尊重
+# 「codex/opencode 非人人安装」的现状。
+# ⚠️ 与 suppressed 同属 _SUPPRESS_DIR 两处同步约束（另一处见 lib-tmux-ai-status.sh）。
+_hooks_installed_file() { printf '%s/installed-%s' "$_SUPPRESS_DIR" "$1"; }
+_hooks_installed_write() {
+    if ! mkdir -p "$_SUPPRESS_DIR" 2>/dev/null \
+       || ! date +%s > "$(_hooks_installed_file "$1")" 2>/dev/null; then
+        echo "WARN: 安装意图标记写入失败——该工具 hooks 丢失后不会自动修复；" \
+             "请检查 $_SUPPRESS_DIR 可写性" >&2
+        return 1
+    fi
+}
+_hooks_installed_clear() {
+    if [ -e "$(_hooks_installed_file "$1")" ] \
+       && ! rm -f "$(_hooks_installed_file "$1")" 2>/dev/null; then
+        echo "WARN: 安装意图标记删除失败（卸载仍由 suppressed 标记兜底）" >&2
+        return 1
+    fi
+}
+_hooks_installed_ensure() {  # 已登记则不动，避免 mtime 抖动
+    [ -e "$(_hooks_installed_file "$1")" ] || _hooks_installed_write "$1"
+}
+
 # --- 安装/卸载读-改-写互斥锁 ---
 # 写路径的并发方：TUI 显式装 / tmux 入口 auto / SessionStart 自修复 / _maybe_repair_hooks /
 # drift 收敛——五方都经 wrapper dispatch，锁在此层一处覆盖三 adapter。

package/scripts/lib-tmux-ai-status.sh

@@ -10,6 +10,17 @@ _STATUS_DIR="${TMUX_AI_STATUS_DIR:-/tmp/ai-status}"
 _SUPPRESS_DIR="${TMUX_AI_SUPPRESS_DIR:-${XDG_CONFIG_HOME:-${HOME}/.config}/tmuxclihook}"
 STATUS_COLOR="#F1FA8C"
 
+# 安装意图标记路径（与 lib-install-hooks.sh 的 _hooks_installed_file 同构）。
+# 事件路径不 source 安装库，故此处独立实现；目录定义同 suppressed 两处同步。
+# 语义：用户显式装过该工具 → 跨工具自修复允许在其 hooks 丢失时自动重装。
+_installed_marker_path() { printf '%s/installed-%s' "$_SUPPRESS_DIR" "$1"; }
+_installed_marker_write() {
+    local f
+    f=$(_installed_marker_path "$1") || return 1
+    mkdir -p "$_SUPPRESS_DIR" 2>/dev/null || return 1
+    date +%s > "$f" 2>/dev/null
+}
+
 # --- 日志模块 ---
 source "${_LIB_DIR}/lib-tmux-ai-log.sh"
 
@@ -907,7 +918,15 @@ _cleanup_stale_panes() {
     local ps_snap
     ps_snap=$(_ps_process_snapshot)
 
-    while IFS='|' read -r pane_id pane_status; do
+    # 动态追加 monitor seen 字段（与 build_all_status 同一组名字，复用其收集器）。
+    # launcher/daemon 场景工具进程可能脱离 pane 进程树，进程树 BFS 看不到；
+    # seen=1 是 monitor 用 launcher 进程树探测得出的「工具确实存活」信号。
+    local seen_fmt="" _seen_name
+    for _seen_name in $(_collect_ai_process_names); do
+        seen_fmt="${seen_fmt}|#{@ai_monitor_seen_${_seen_name}}"
+    done
+
+    while IFS='|' read -r pane_id pane_status _seen_flags; do
         case "$pane_status" in
             "!"|"?"|">")
                 local sanitized="${pane_id//[^a-zA-Z0-9]/_}"
@@ -923,13 +942,20 @@ _cleanup_stale_panes() {
                 fi
                 ;;
             "✓"|"-")
-                if ! _pane_has_ai_process "$pane_id" "$ps_snap"; then
-                    _ai_log "STALE: clearing terminal state '$pane_status' on $pane_id (no ai process)"
-                    tmux set-option -pt "$pane_id" @ai_pane_status "" 2>/dev/null || true
-                fi
+                # 终态只认「进程存活」证据：seen=1 时保留（launcher/daemon 场景
+                # 进程树不可见）；活跃态 !/?/> 的判据是归属证据，不使用 seen。
+                case "$_seen_flags" in
+                    *1*) ;;
+                    *)
+                        if ! _pane_has_ai_process "$pane_id" "$ps_snap"; then
+                            _ai_log "STALE: clearing terminal state '$pane_status' on $pane_id (no ai process)"
+                            tmux set-option -pt "$pane_id" @ai_pane_status "" 2>/dev/null || true
+                        fi
+                        ;;
+                esac
                 ;;
         esac
-    done < <(tmux list-panes -a -F "#{pane_id}|#{@ai_pane_status}" 2>/dev/null)
+    done < <(tmux list-panes -a -F "#{pane_id}|#{@ai_pane_status}${seen_fmt}" 2>/dev/null)
 
     # 清理孤儿目录：目录存在但对应 pane 已不在 tmux 中
     local all_pane_ids
@@ -1039,3 +1065,47 @@ _maybe_repair_hooks() {
         fi
     fi
 }
+
+# 跨工具自修复：tmux 入口所有 _refresh/_session-switched 固定传 TOOL_ID=claude，
+# codex/opencode 只有自身 SessionStart 能触发修复；hooks 文件被整体覆盖/删除后
+# 再无事件 → 永不自愈。本函数由 _run_refresh 调用，遍历其余 adapter，对
+# 「用户显式装过」（installed-<tool> 标记）的工具做 check → 缺失则 install。
+#
+# 不 source adapter：ADAPTER_* 与 adapter_* 会覆盖当前已加载的 adapter（TOOL_ID
+# 污染），一律子进程 exec wrapper（wrapper 自带 _LIB_DIR 与 adapter 加载）。
+# 未登记的工具只做「既存安装登记」：check 通过才补写标记，绝不自动安装——
+# 尊重 codex/opencode 非人人安装的现状。
+# 成本：每工具每 60s 至多 1 次 check；installed 存在且缺失时再加 1 次 install。
+_maybe_repair_other_tools() {
+    local current="${TOOL_ID:-claude}"
+    local f tool installer marker now last
+    for f in "${_ADAPTER_DIR}"/*.sh; do
+        [ -f "$f" ] || continue
+        tool=$(basename "$f" .sh)
+        [ "$tool" = "$current" ] && continue
+        [ -f "${_SUPPRESS_DIR}/suppressed-${tool}" ] && continue
+        installer="${_LIB_DIR}/install-${tool}-hooks.sh"
+        [ -x "$installer" ] || continue
+        marker="${_STATUS_DIR}/.hooks-repair-${tool}-ts"
+        now=$(date +%s)
+        [ -d "$_STATUS_DIR" ] || mkdir -p "$_STATUS_DIR" 2>/dev/null
+        if [ -f "$marker" ]; then
+            last=$(cat "$marker" 2>/dev/null)
+            [ $((now - ${last:-0})) -lt 60 ] && continue
+        fi
+        echo "$now" > "$marker" 2>/dev/null || true
+        if [ -f "$(_installed_marker_path "$tool")" ]; then
+            "$installer" check >/dev/null 2>&1 && continue
+            _ai_log "REPAIR: ${tool} hooks missing, reinstalling (cross-tool)"
+            if "$installer" >/dev/null 2>&1; then
+                tmux display-message "✓ ${tool} hooks 已自动修复（检测到缺失）" 2>/dev/null || true
+            else
+                tmux display-message "⚠ ${tool} hooks 自动修复失败，请运行 tmuxclihook 检查" 2>/dev/null || true
+            fi
+        elif "$installer" check >/dev/null 2>&1; then
+            # 未登记但健康：登记既存安装（老用户升级迁移），绝不安装
+            _installed_marker_write "$tool" 2>/dev/null || true
+            _ai_log "REPAIR: ${tool} hooks healthy, registered installed marker"
+        fi
+    done
+}

package/scripts/tmux-ai-status

@@ -108,6 +108,9 @@ _notification_implicit_status() {
 # 重建聚合状态（_refresh / _entered 共用）
 _run_refresh() {
     _maybe_repair_hooks
+    # 跨工具修复：_refresh 固定以 claude 身份运行，codex/opencode 的整体丢失
+    # 只能靠这里兜底（仅对 installed-<tool> 已登记的工具）。
+    _maybe_repair_other_tools
     # 节流版清理（60s）：tmux 生命周期 hook（pane-focus-in 等）高频触发，
     # 全价 _cleanup_stale_panes 实测 ~455ms；卡死状态清理有 :37 的事件路径
     # 节流兜底，此处无需每次全价。Stop/SessionEnd fallback 仍走全价精准清理。

package/tmux-ai-hooks-status.tmux

@@ -85,7 +85,8 @@ tmux bind-key r run-shell "'${CURRENT_DIR}/scripts/tmux-ai-reload'" 2>/dev/null
 # #{hook_client_name} 这个 format 变量——误用它恒展开为空，handler 的
 # [ -n "$3" ] 守卫静默跳过，entered_time 从不写入，排序退化为 created 序。
 tmux set-hook -g client-session-changed "run-shell '${CURRENT_DIR}/scripts/tmux-ai-status claude _session-switched #{hook_client}'" 2>/dev/null || true
-# 注：_refresh 与 TOOL_ID 无关（仅重建聚合 + 自修复 claude hooks），统一传 claude。
+# 注：_refresh 与 TOOL_ID 无关（重建聚合 + 自修复当前工具 hooks + 跨工具修复
+# 已显式安装的 codex/opencode），统一传 claude。
 tmux set-hook -g session-closed    "run-shell '${CURRENT_DIR}/scripts/tmux-ai-status claude _refresh'"
 tmux set-hook -g client-detached   "run-shell '${CURRENT_DIR}/scripts/tmux-ai-status claude _refresh'"
 # （client-attached 不再注册：attach 场景由 client-session-changed 覆盖）