tmuxclihook 0.1.1 → 0.2.0

package/scripts/tmux-ai-monitor

@@ -0,0 +1,190 @@
+#!/bin/bash
+# tmux-ai-monitor — tmux server 级单例监控器
+#
+# 部分 AI CLI（codex、opencode）没有 SessionEnd hook，退出无法主动清空状态；codex 的
+# SessionStart 还会延迟到首个 turn。本监控器每秒根据 pane_current_command / 进程树刷新：
+#   - 前台启动此类工具、尚无 hook 状态时，显示 idle `-`
+#   - 退出返回 shell 后，清除残留 pane 状态
+# 泛化实现：扫描 adapters/*.sh 找出 ADAPTER_HAS_SESSION_END="false" 的工具及其
+# ADAPTER_PROCESS_NAMES，逐个工具做生命周期检测——新增同类工具的 adapter 无需改本文件。
+# `/new`（codex）等同工具内会话切换不改变前台进程，因此不会改写已有 `✓`。
+
+set -u
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+_ADAPTER_DIR="${SCRIPT_DIR}/adapters"
+MODE="${1:-start}"
+MONITOR_INTERVAL="${TMUX_AI_MONITOR_INTERVAL:-1}"
+
+_tmux_server_pid() {
+    tmux display-message -p '#{pid}' 2>/dev/null
+}
+
+_pane_current_command() {
+    local pane_id="$1"
+    tmux list-panes -a -F "#{pane_id}|#{pane_current_command}" 2>/dev/null \
+        | awk -F'|' -v id="$pane_id" '$1==id{print $2; exit}'
+}
+
+# 无 SessionEnd 的工具名集合（惰性求值缓存）。扫 adapters/*.sh 提取
+# ADAPTER_HAS_SESSION_END="false" 的文件对应的 ADAPTER_PROCESS_NAMES，不 source（避免副作用）。
+_NO_SESSION_END_TOOLS=""
+_collect_no_session_end_tools() {
+    [ -n "$_NO_SESSION_END_TOOLS" ] && { echo "$_NO_SESSION_END_TOOLS"; return; }
+    local names="" f has_end names_in_f
+    for f in "${_ADAPTER_DIR}"/*.sh; do
+        [ -f "$f" ] || continue
+        has_end=$(sed -n 's/^ADAPTER_HAS_SESSION_END="\([^"]*\)".*/\1/p' "$f" 2>/dev/null)
+        [ "$has_end" = "false" ] || continue
+        names_in_f=$(sed -n 's/^ADAPTER_PROCESS_NAMES="\([^"]*\)".*/\1/p' "$f" 2>/dev/null)
+        [ -n "$names_in_f" ] && names="$names $names_in_f"
+    done
+    _NO_SESSION_END_TOOLS=$(echo "$names" | tr ' ' '\n' | grep -v '^$' | sort -u | tr '\n' ' ')
+    echo "$_NO_SESSION_END_TOOLS"
+}
+
+# $1=basename 命令 $2=工具进程名（如 codex/opencode）→ 是否前缀匹配
+_is_tool_command() {
+    local base="$1" name="$2"
+    case "$base" in
+        "$name"|"$name"-*|"$name"_*) return 0 ;;
+    esac
+    return 1
+}
+
+# 判定 pane 前台命令是否属于给定工具名
+_pane_command_is_tool() {
+    local pane_id="$1" name="$2" current_command
+    current_command=$(_pane_current_command "$pane_id")
+    [ -n "$current_command" ] || return 1
+    _is_tool_command "$(basename "$current_command" 2>/dev/null)" "$name"
+}
+
+# 判定 pane 进程树内是否仍有该工具进程（前台命令优先，再 BFS 遍历进程树）
+_pane_has_tool_process() {
+    local pane_id="$1" name="$2"
+    _pane_command_is_tool "$pane_id" "$name" && return 0
+
+    local pane_pid
+    pane_pid=$(tmux list-panes -a -F "#{pane_id} #{pane_pid}" 2>/dev/null \
+        | awk -v id="$pane_id" '$1==id{print $2; exit}')
+    [ -n "$pane_pid" ] || return 1
+
+    local pids="$pane_pid" next="" depth=0 p cmd base children
+    while [ "$depth" -lt 10 ] && [ -n "$pids" ]; do
+        for p in $pids; do
+            cmd=$(ps -o comm= -p "$p" 2>/dev/null)
+            base=$(basename "$cmd" 2>/dev/null)
+            _is_tool_command "$base" "$name" && return 0
+            children=$(pgrep -P "$p" 2>/dev/null)
+            [ -n "$children" ] && next="$next $children"
+        done
+        pids="${next# }"
+        next=""
+        depth=$((depth + 1))
+    done
+    return 1
+}
+
+# 对每个无 SessionEnd 的工具名做生命周期检测：前台命令匹配 → 标记见过；
+# 曾标记但前台已切走且进程树也无该工具 → 清空 pane 状态（该工具已退出）。
+# seen 标记按工具名区分（@ai_monitor_seen_<name>），避免多工具互相踩踏清理语义。
+_monitor_no_session_end_lifecycle() {
+    local tools name pane_id current_command sanitized pane_dir
+    tools=$(_collect_no_session_end_tools)
+    [ -n "$tools" ] || return 0
+    for name in $tools; do
+        while IFS='|' read -r pane_id current_command seen; do
+            if [ -n "$current_command" ] && _is_tool_command "$(basename "$current_command" 2>/dev/null)" "$name"; then
+                [ "$seen" = "1" ] || tmux set-option -pt "$pane_id" "@ai_monitor_seen_${name}" 1 2>/dev/null || true
+            elif [ "$seen" = "1" ] && ! _pane_has_tool_process "$pane_id" "$name"; then
+                tmux set-option -pt "$pane_id" @ai_pane_status "" 2>/dev/null || true
+                tmux set-option -pu -t "$pane_id" "@ai_monitor_seen_${name}" 2>/dev/null || true
+                sanitized="${pane_id//[^a-zA-Z0-9]/_}"
+                pane_dir="${_STATUS_DIR}/${sanitized}"
+                rm -rf "$pane_dir" 2>/dev/null
+            fi
+        done < <(tmux list-panes -a -F "#{pane_id}|#{pane_current_command}|#{@ai_monitor_seen_${name}}" 2>/dev/null)
+    done
+}
+
+_monitor_tick() {
+    _monitor_no_session_end_lifecycle
+    build_all_status
+
+    local previous
+    previous=$(tmux show-option -gv @ai_all_status 2>/dev/null || true)
+    if [ "$previous" != "$ALL" ]; then
+        tmux set-option -g @ai_all_status "$ALL" 2>/dev/null || return 1
+        tmux refresh-client -S 2>/dev/null || true
+    fi
+    return 0
+}
+
+case "$MODE" in
+    start)
+        server_pid=$(_tmux_server_pid)
+        [ -n "$server_pid" ] || exit 0
+
+        # 每次插件加载都发布新 generation。旧 monitor 看到 generation 变化后自行退出，
+        # 因而无需冒险 kill 一个可能已被系统复用的 PID，也不会长期存在重复 monitor。
+        generation="$(date +%s)-$$-${RANDOM:-0}"
+        tmux set-option -g @ai_monitor_generation "$generation" 2>/dev/null || exit 0
+
+        nohup "$0" run "$server_pid" "$generation" >/dev/null 2>&1 &
+        monitor_pid=$!
+        tmux set-option -g @ai_monitor_pid "$monitor_pid" 2>/dev/null || true
+        ;;
+
+    run)
+        expected_server_pid="${2:-}"
+        generation="${3:-}"
+        [ -n "$expected_server_pid" ] && [ -n "$generation" ] || exit 1
+
+        # monitor 自身不处理 hook，仅复用现有状态聚合函数。
+        TOOL_ID="claude"
+        EVENT="_monitor"
+        source "${SCRIPT_DIR}/lib-tmux-ai-status.sh"
+
+        cleanup_monitor_option() {
+            local registered_pid
+            registered_pid=$(tmux show-option -gv @ai_monitor_pid 2>/dev/null || true)
+            [ "$registered_pid" = "$$" ] && tmux set-option -gu @ai_monitor_pid 2>/dev/null || true
+        }
+        stop_monitor() {
+            exit 0
+        }
+        trap cleanup_monitor_option EXIT
+        trap stop_monitor INT TERM
+
+        while :; do
+            current_server_pid=$(_tmux_server_pid)
+            [ "$current_server_pid" = "$expected_server_pid" ] || break
+
+            current_generation=$(tmux show-option -gv @ai_monitor_generation 2>/dev/null || true)
+            [ "$current_generation" = "$generation" ] || break
+
+            # 单次 tmux 查询失败不应永久杀死 monitor；server/generation 检查负责终止。
+            _monitor_tick || true
+            sleep "$MONITOR_INTERVAL"
+        done
+        ;;
+
+    stop)
+        # 令当前 monitor 在下一 tick 自行退出。
+        tmux set-option -gu @ai_monitor_generation 2>/dev/null || true
+        ;;
+
+    tick)
+        # 诊断/测试用的一次性刷新。
+        TOOL_ID="claude"
+        EVENT="_monitor"
+        source "${SCRIPT_DIR}/lib-tmux-ai-status.sh"
+        _monitor_tick
+        ;;
+
+    *)
+        echo "Usage: $0 [start|run|stop|tick]" >&2
+        exit 2
+        ;;
+esac

package/scripts/tmux-ai-status

@@ -0,0 +1,256 @@
+#!/bin/bash
+# AI CLI → tmux 状态栏 hook
+# 用法: tmux-ai-status <TOOL_ID> <EVENT_TYPE>
+#   TOOL_ID: claude | codex | opencode
+# stdin: adapter 归一化后的 JSON 数据
+#
+# 状态机: per-pane 状态 + PreToolUse/PostToolUse 配对集合
+# 详见 lib-tmux-ai-status.sh 中 pending 集合管理注释
+
+TOOL_ID="$1"
+EVENT="$2"
+
+INPUT=$(cat)
+
+SESSION_ID=$(echo "$INPUT" | jq -r '.session_id // ""' 2>/dev/null)
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "${SCRIPT_DIR}/lib-tmux-ai-status.sh"
+
+resolve_tmux_pane
+# 同 pane 的并发 hooks 必须完整串行化，否则一个事件可能用过期派生结果覆盖另一个
+# PermissionRequest 已写入的审批态。
+if [ -n "$TMUX_PANE" ]; then
+    _acquire_event_lock || exit 0
+    trap '_release_event_lock' EXIT
+fi
+
+_save_pane_id
+_maybe_cleanup_stale
+
+_pane_loc=""
+if [ -n "$TMUX_PANE" ]; then
+    _pane_loc=$(tmux display-message -pt "$TMUX_PANE" -p "#{session_name}:#{window_index}.#{pane_index}" 2>/dev/null)
+fi
+
+# 读取当前 pane 状态符号（用于 Stop 时判断是否已被前置事件置为 "-"）
+_current_pane_status() {
+    [ -z "$TMUX_PANE" ] && return
+    tmux display-message -pt "$TMUX_PANE" -p "#{@ai_pane_status}" 2>/dev/null
+}
+
+# 事件块日志变量（各 case 分支按需赋值，脚本末尾统一出块）
+PREV_STATUS=$(_current_pane_status)
+TOOL=""
+TOOL_USE_ID=""
+INPUT_DIGEST=""
+
+case "$EVENT" in
+  Notification)
+    NOTIF_TYPE=$(echo "$INPUT" | jq -r '.notification_type // ""' 2>/dev/null)
+    MSG=$(echo "$INPUT" | jq -r '.message // ""' 2>/dev/null)
+    INPUT_DIGEST=$(echo "$INPUT" | jq -c '{notification_type, message}' 2>/dev/null)
+    case "$NOTIF_TYPE" in
+      idle_prompt)
+        STATUS="-"
+        ;;
+      *)
+        case "$MSG" in
+          *"waiting for your input"*)
+            STATUS="-"
+            ;;
+          *"denied"*|*"cancelled"*|*"canceled"*|*"rejected"*)
+            STATUS="-"
+            ;;
+          *)
+            STATUS="$PREV_STATUS"
+            ;;
+        esac
+        ;;
+    esac
+    ;;
+  PermissionRequest)
+    TOOL=$(echo "$INPUT" | jq -r '.tool_name // ""' 2>/dev/null)
+    TOOL_USE_ID=$(echo "$INPUT" | jq -r '.tool_use_id // ""' 2>/dev/null)
+    INPUT_DIGEST=$(echo "$INPUT" | jq -c '.' 2>/dev/null)
+    _log_full_input=1
+    if [ "$TOOL" = "AskUserQuestion" ]; then
+        STATUS="?"
+    else
+        STATUS="!"
+    fi
+    # 铁律: PermissionRequest 立即写入,优先级最高。同时记入 pending-perm,
+    # 保证后续乱序到达的 PreToolUse/PostToolUse 派生时仍守住 !/?
+    [ -n "$TMUX_PANE" ] && tmux set-option -pt "$TMUX_PANE" @ai_pane_status "$STATUS" 2>/dev/null || true
+    if [ -n "$TOOL_USE_ID" ]; then
+        _add_pending_perm "$TOOL_USE_ID" "$STATUS" "$TOOL"
+    elif [ "${ADAPTER_HOLD_UNMATCHED_PERMISSION:-false}" = "true" ]; then
+        # Codex 的 PermissionRequest 无请求 ID。sentinel 不与任何 PostToolUse ID 配对，
+        # 因而保守保持审批态，直到 turn/session 边界统一清理。
+        _add_pending_perm "__unmatched_permission__" "$STATUS" "$TOOL"
+    fi
+    ;;
+  PermissionResolved)
+    TOOL_USE_ID=$(echo "$INPUT" | jq -r '.request_id // ""' 2>/dev/null)
+    INPUT_DIGEST=$(echo "$INPUT" | jq -c '{request_id, reply}' 2>/dev/null)
+    _remove_pending_perm_id "$TOOL_USE_ID"
+    if _derive_status_from_pending; then
+        STATUS="$DERIVED"
+    else
+        STATUS=">"
+    fi
+    ;;
+  PreToolUse)
+    TOOL=$(echo "$INPUT" | jq -r '.tool_name // ""' 2>/dev/null)
+    TOOL_USE_ID=$(echo "$INPUT" | jq -r '.tool_use_id // ""' 2>/dev/null)
+    INPUT_DIGEST=$(echo "$INPUT" | jq -c '.tool_input // null' 2>/dev/null)
+    _add_pending_pre "$TOOL_USE_ID" "$TOOL"
+    # Claude 的 PermReq 不带 tool_use_id，派生看不到审批态；用 LIVE_STATUS 兜底。
+    # Codex sentinel 和 OpenCode request ID 则会直接从 pending 集合派生。
+    LIVE_STATUS=$(_current_pane_status)
+    case "$LIVE_STATUS" in
+        "!"|"?") STATUS="$LIVE_STATUS" ;;
+        *)
+            if _derive_status_from_pending; then
+                STATUS="$DERIVED"
+            else
+                STATUS=">"
+            fi
+            ;;
+    esac
+    ;;
+  PostToolUse|PostToolUseFailure)
+    TOOL=$(echo "$INPUT" | jq -r '.tool_name // ""' 2>/dev/null)
+    TOOL_USE_ID=$(echo "$INPUT" | jq -r '.tool_use_id // ""' 2>/dev/null)
+    _remove_pending_id "$TOOL_USE_ID"
+    # 只解除当前工具对应项；其他权限请求仍 pending 时必须保持 !/?。
+    if _derive_status_from_pending; then
+        STATUS="$DERIVED"
+    else
+        STATUS=">"
+    fi
+    ;;
+  UserPromptSubmit)
+    _clear_pending
+    STATUS=">"
+    ;;
+  Stop|StopFailure)
+    # 判定: pending-perm 还有项 = 用户未批准被打断 → "-"; 否则 "✓"
+    HAS_PERM=0
+    if [ -n "$TMUX_PANE" ]; then
+        PERM_FILE=$(_pending_perm_path)
+        [ -s "$PERM_FILE" ] && HAS_PERM=1
+    fi
+    _clear_pending
+    if [ "$HAS_PERM" = "1" ] || [ "$PREV_STATUS" = "!" ] || [ "$PREV_STATUS" = "?" ] || [ "$PREV_STATUS" = "-" ]; then
+        STATUS="-"
+    else
+        STATUS="✓"
+    fi
+    # fallback: TMUX_PANE 未解析时，精准清理孤儿状态（不碰其他活跃 pane）
+    if [ -n "$TMUX" ] && [ -z "$TMUX_PANE" ]; then
+        _cleanup_stale_panes
+        build_all_status
+        tmux set-option -g @ai_all_status "$ALL" 2>/dev/null || true
+        _ai_log "Stop FALLBACK: _cleanup_stale_panes ran"
+    fi
+    ;;
+  SessionStart)
+    INPUT_DIGEST=$(echo "$INPUT" | jq -c '{source, model}' 2>/dev/null)
+    STATUS="-"
+    _clear_pending
+    if ! _check_hooks_integrity; then
+        "${ADAPTER_INSTALLER}" >/dev/null 2>&1
+        tmux display-message "⚠ ${TOOL_ID} hooks 已自动修复（检测到缺失）" 2>/dev/null || true
+    fi
+    ;;
+  SessionEnd)
+    INPUT_DIGEST=$(echo "$INPUT" | jq -c '{reason}' 2>/dev/null)
+    if [ -z "$TMUX_PANE" ]; then
+        _load_pane_id
+        _ai_log "SessionEnd pane restored: TMUX_PANE=${TMUX_PANE:-?}"
+    fi
+    _clear_pending
+    _clear_pane_id
+    # /new 竞态保护：SessionEnd(async) 可能晚于 SessionStart(async) 执行，
+    # 此时不应清空状态。检查是否有新 session 已接管此 pane。
+    if _new_session_owns_pane; then
+        STATUS="-"
+    else
+        STATUS=""
+    fi
+    ;;
+  _refresh)
+    _maybe_repair_hooks
+    _cleanup_stale_panes
+    build_all_status
+    tmux set-option -g @ai_all_status "$ALL" 2>/dev/null || true
+    # 诊断日志：记录 pane 状态快照（纯文本，去掉 tmux 格式码）
+    _refresh_snapshot=$(tmux list-panes -a -F "#{session_name}:#{window_index}.#{pane_index}=#{@ai_pane_status}|#{session_attached}" 2>/dev/null \
+        | awk -F'|' '$2+0>0' | cut -d'|' -f1 | tr '\n' ' ')
+    _ai_log "REFRESH: ${_refresh_snapshot:-<empty>}"
+    exit 0
+    ;;
+  *)
+    exit 0
+    ;;
+esac
+
+tmux set-option -g @ai_status "$STATUS" 2>/dev/null || true
+
+# 构造事件块详情行：
+#   tool:  <tool_name>  id=<short tool_use_id>
+#   input: <精简 JSON，超 2000B 截断>
+_log_tool_line=""
+if [ -n "$TOOL" ] || [ -n "$TOOL_USE_ID" ]; then
+    _log_tool_line="tool: ${TOOL:-·}  id=${TOOL_USE_ID:-·}"
+fi
+_log_input_line=""
+if [ -n "$INPUT_DIGEST" ] && [ "$INPUT_DIGEST" != "null" ]; then
+    if [ "${_log_full_input:-0}" = "1" ]; then
+        _log_input_line="input: $INPUT_DIGEST"
+    else
+        _log_input_line="input: $(_ai_log_truncate_input "$INPUT_DIGEST")"
+    fi
+fi
+_ai_log_event "$PREV_STATUS" "$STATUS" "" "$_log_tool_line" "$_log_input_line"
+
+if [ -n "$TMUX_PANE" ] && { [ -n "$TMUX" ] || command -v tmux &>/dev/null; }; then
+    # 写入前重新读取 pending，避免并发事件用过期结果覆盖仍有效的审批态。
+    case "$EVENT" in
+        PreToolUse)
+            if _derive_status_from_pending; then
+                STATUS="$DERIVED"
+            else
+                # Claude PermissionRequest 没有 ID，继续用 live 状态保护串行审批窗口。
+                _live_final=$(tmux display-message -pt "$TMUX_PANE" -p '#{@ai_pane_status}' 2>/dev/null)
+                case "$_live_final" in
+                    "!"|"?") STATUS="$_live_final" ;;
+                esac
+            fi
+            ;;
+        PostToolUse|PostToolUseFailure|PermissionResolved)
+            if _derive_status_from_pending; then
+                STATUS="$DERIVED"
+            fi
+            ;;
+    esac
+    tmux set-option -pt "$TMUX_PANE" @ai_pane_status "$STATUS" 2>/dev/null || true
+    build_all_status
+    tmux set-option -g @ai_all_status "$ALL" 2>/dev/null || true
+    tmux refresh-client -S 2>/dev/null || true
+fi
+
+# Fallback: SessionEnd 仍无 TMUX_PANE 时，用 _cleanup_stale_panes 精准清理
+# （只清除孤儿 > / ! / ?，保留 - 和 ✓）
+if [ -z "$TMUX_PANE" ] && command -v tmux &>/dev/null; then
+    case "$EVENT" in
+        SessionEnd)
+            _cleanup_stale_panes
+            build_all_status
+            tmux set-option -g @ai_all_status "$ALL" 2>/dev/null || true
+            tmux refresh-client -S 2>/dev/null || true
+            _ai_log "SessionEnd FALLBACK: _cleanup_stale_panes ran"
+            ;;
+    esac
+fi

package/src/adapters-meta.js

@@ -2,64 +2,101 @@
 //
 // TUI 侧的工具清单（对应 scripts/adapters/*.sh）。新增 CLI 时在此加一条 + 加 bash adapter。
 // bin/minVersion/hooksFile 用于侦测；installer 指向瘦 wrapper（真实逻辑在 bash adapter）。
+//
+// REPO_ROOT/SCRIPTS_DIR 不再是写死的相对路径，而是委托 source.js 的三级解析
+// （env TMUXCLIHOOK_SOURCE > 持久化配置 > 包内自带 > 开发回落）。这些导出是
+// ES module 的 live binding：resolveSource()/refreshSource() 重新赋值后，
+// 所有 `import { REPO_ROOT } from './adapters-meta.js'` 的调用方会自动看到新值，
+// 无需重启进程或改动各自的 import 语句。
 
-import { fileURLToPath } from 'node:url';
-import { dirname, join, resolve } from 'node:path';
+import { join } from 'node:path';
 import { existsSync } from 'node:fs';
 import { homedir } from 'node:os';
+import { resolveSource } from './source.js';
 
-const __dirname = dirname(fileURLToPath(import.meta.url));
+const HOME = homedir();
 
-// installer/ 的上一级即仓库根
-export const REPO_ROOT = resolve(__dirname, '..', '..');
-export const SCRIPTS_DIR = join(REPO_ROOT, 'scripts');
+function buildTools(scriptsDir) {
+  return [
+    {
+      id: 'claude',
+      label: 'Claude Code',
+      bin: 'claude',
+      versionArgs: ['--version'],
+      versionRe: /(\d+\.\d+\.\d+)/,          // "2.1.210 (Claude Code)"
+      minVersion: null,                        // 无硬性最低要求
+      hooksFile: join(process.env.CLAUDE_CONFIG_DIR || join(HOME, '.claude'), 'settings.json'),
+      installer: join(scriptsDir, 'install-claude-hooks.sh'),
+      hookMarker: 'tmux-ai-status',
+      minHookCount: 10,
+    },
+    {
+      id: 'codex',
+      label: 'Codex CLI',
+      bin: 'codex',
+      versionArgs: ['--version'],
+      versionRe: /(\d+\.\d+\.\d+)/,          // "codex-cli 0.144.4"
+      minVersion: '0.144.0',                   // hooks.json + trust 起于 0.144
+      hooksFile: join(process.env.CODEX_HOME || join(HOME, '.codex'), 'hooks.json'),
+      installer: join(scriptsDir, 'install-codex-hooks.sh'),
+      hookMarker: 'tmux-ai-status codex',
+      minHookCount: 6,
+    },
+    {
+      id: 'opencode',
+      label: 'opencode',
+      bin: 'opencode',
+      versionArgs: ['--version'],
+      versionRe: /(\d+\.\d+\.\d+)/,
+      minVersion: null,                        // plugin 系统本地文件跳过版本兼容检查
+      // hooksFile 实为 JS/TS plugin 文件（非 JSON hooks 配置），install/uninstall 整文件写入/删除
+      hooksFile: join(
+        process.env.OPENCODE_CONFIG_DIR || join(process.env.XDG_CONFIG_HOME || join(HOME, '.config'), 'opencode'),
+        'plugins',
+        'tmux-ai-status.ts'
+      ),
+      installer: join(scriptsDir, 'install-opencode-hooks.sh'),
+      hookMarker: 'tmux-ai-status (managed by tmux-ai-hooks-status)',
+      minHookCount: 1,
+    },
+  ];
+}
 
-const HOME = homedir();
+function computeSource() {
+  const s = resolveSource();
+  return {
+    repoRoot: s.repoRoot,
+    scriptsDir: s.scriptsDir,
+    tmuxEntry: s.tmuxEntry,
+    origin: s.origin,
+    warnings: s.warnings,
+  };
+}
+
+let _current = computeSource();
 
-// 工具元数据表。version 解析用正则从 `<bin> --version` 输出提取。
-export const TOOLS = [
-  {
-    id: 'claude',
-    label: 'Claude Code',
-    bin: 'claude',
-    versionArgs: ['--version'],
-    versionRe: /(\d+\.\d+\.\d+)/,          // "2.1.210 (Claude Code)"
-    minVersion: null,                        // 无硬性最低要求
-    hooksFile: join(process.env.CLAUDE_CONFIG_DIR || join(HOME, '.claude'), 'settings.json'),
-    installer: join(SCRIPTS_DIR, 'install-claude-hooks.sh'),
-    hookMarker: 'tmux-ai-status',
-    minHookCount: 10,
-  },
-  {
-    id: 'codex',
-    label: 'Codex CLI',
-    bin: 'codex',
-    versionArgs: ['--version'],
-    versionRe: /(\d+\.\d+\.\d+)/,          // "codex-cli 0.144.4"
-    minVersion: '0.144.0',                   // hooks.json + trust 起于 0.144
-    hooksFile: join(process.env.CODEX_HOME || join(HOME, '.codex'), 'hooks.json'),
-    installer: join(SCRIPTS_DIR, 'install-codex-hooks.sh'),
-    hookMarker: 'tmux-ai-status codex',
-    minHookCount: 6,
-  },
-  {
-    id: 'opencode',
-    label: 'opencode',
-    bin: 'opencode',
-    versionArgs: ['--version'],
-    versionRe: /(\d+\.\d+\.\d+)/,
-    minVersion: null,                        // plugin 系统本地文件跳过版本兼容检查
-    // hooksFile 实为 JS/TS plugin 文件（非 JSON hooks 配置），install/uninstall 整文件写入/删除
-    hooksFile: join(
-      process.env.OPENCODE_CONFIG_DIR || join(process.env.XDG_CONFIG_HOME || join(HOME, '.config'), 'opencode'),
-      'plugins',
-      'tmux-ai-status.ts'
-    ),
-    installer: join(SCRIPTS_DIR, 'install-opencode-hooks.sh'),
-    hookMarker: 'tmux-ai-status (managed by tmux-ai-hooks-status)',
-    minHookCount: 1,
-  },
-];
+export let REPO_ROOT = _current.repoRoot;
+export let SCRIPTS_DIR = _current.scriptsDir;
+export let TMUX_ENTRY = _current.tmuxEntry;
+export let SOURCE_ORIGIN = _current.origin;
+export let SOURCE_WARNINGS = _current.warnings;
+export let TOOLS = buildTools(SCRIPTS_DIR);
+export let repoExists = existsSync(SCRIPTS_DIR);
+
+// 重新解析 source 并刷新以上所有导出（live binding，下游 import 自动看到新值）。
+// 在 TUI 内「source 管理」菜单执行 set/clear 之后调用，使同一进程内立即生效，
+// 不需要重启 TUI。
+export function refreshSource() {
+  _current = computeSource();
+  REPO_ROOT = _current.repoRoot;
+  SCRIPTS_DIR = _current.scriptsDir;
+  TMUX_ENTRY = _current.tmuxEntry;
+  SOURCE_ORIGIN = _current.origin;
+  SOURCE_WARNINGS = _current.warnings;
+  TOOLS = buildTools(SCRIPTS_DIR);
+  repoExists = existsSync(SCRIPTS_DIR);
+  return _current;
+}
 
 export function toolById(id) {
   return TOOLS.find((t) => t.id === id);
@@ -77,6 +114,6 @@ export function versionGte(a, b) {
   return true;
 }
 
-// TPM 软链路径（仓库目录名）
+// TPM 软链路径（仓库目录名）。已不是主加载路径（改用 .tmux.conf 直接 run-shell
+// 当前 source 的 tmux 入口），仅供「tmux 集成」检测/清理历史遗留软链时复用。
 export const PLUGIN_LINK = join(HOME, '.tmux', 'plugins', 'tmux-ai-hooks-status');
-export const repoExists = existsSync(SCRIPTS_DIR);

package/src/purge.js

@@ -1,4 +1,10 @@
-// purge.js — 完整卸载编排：monitor stop + 清聚合状态 + 删软链（不删仓库/不动 conf/不 kill-server）
+// purge.js — 完整卸载编排：monitor stop + 清聚合状态 + 清理历史遗留软链
+// （不删仓库/不动 .tmux.conf/不 kill-server）
+//
+// 主加载路径已改为 .tmux.conf 的 run-shell（见 tmuxconf.js），不再依赖软链；
+// removeSymlinks() 仅用于清理旧版本遗留在 ~/.tmux/plugins/ 下的软链
+// （canonical 名 + 历史遗留的 tmux-claude-hooks-status 旧名）。
+// 移除 .tmux.conf 里的声明属破坏性操作，与 kill-server 一样只在 TUI 打印手动指引。
 import { execa } from 'execa';
 import { rmSync, lstatSync } from 'node:fs';
 import { join, dirname } from 'node:path';