tmuxclihook 0.5.16 → 0.5.17

package/bin/cli.js

@@ -14,7 +14,7 @@ import { checkEnv, detectClis, interactiveShell } from '../src/detect.js';
 import { planBrewRemediation, runBrewAction } from '../src/env.js';
 import { installHooks, uninstallHooks, repairHooks } from '../src/hooks.js';
 import { checkSymlink, checkTmuxConf } from '../src/symlink.js';
-import { checkToolDetail, renderToolDetail, summarizeDetails } from '../src/check-detail.js';
+import { checkToolDetail, renderToolDetail, summarizeDetails, findDuplicateEvents } from '../src/check-detail.js';
 import { ensureTmuxIntegration, reloadTmux } from '../src/tmuxconf.js';
 import { stopMonitor, clearAggregateStatus, removeSymlinks } from '../src/purge.js';
 import {
@@ -165,26 +165,41 @@ async function detectCliMenu() {
   await offerDriftConvergence(details);
 }
 
-// 漂移收敛入口：检测（check --json 的 drift 字段 + .tmux.conf 的 pointsToCurrent）
-// 与收敛分离。收敛策略不对称——claude 无代价直接收敛；codex 重写即 trusted_hash
-// 失效，必须显式确认；opencode 重写无信任代价，确认一次即可。
+// 漂移/重复收敛入口：检测（check --json 的 drift 字段 + .tmux.conf 的 pointsToCurrent
+// + codex 的 registered>1）与收敛分离。收敛策略不对称——claude 无代价直接收敛；
+// codex 重写即 trusted_hash 失效，必须显式确认；opencode 重写无信任代价，确认一次即可。
 async function offerDriftConvergence(details) {
-  const driftTools = details.filter((d) => d.status !== 'unknown' && d.drift?.drifted);
+  const candidates = details.filter((d) => {
+    if (d.status === 'unknown') return false;
+    if (d.drift?.drifted) return true;
+    // codex 重复注册：drift 检测不到（同路径），但 force install 可收敛
+    return d.tool === 'codex' && findDuplicateEvents(d).length > 0;
+  });
   const conf = checkTmuxConf();
   const confStale = conf.exists && conf.referenced && !conf.pointsToCurrent;
 
-  const options = driftTools.map((d) => ({
-    value: `tool:${d.tool}`,
-    label: `${d.label} hooks 收敛到当前 source`,
-    hint: `旧路径 ${(d.drift.stale || []).join(', ')}`,
-  }));
+  const options = candidates.map((d) => {
+    const hints = [];
+    if (d.drift?.drifted) hints.push(`旧路径 ${(d.drift.stale || []).join(', ')}`);
+    if (d.tool === 'codex') {
+      const dups = findDuplicateEvents(d);
+      if (dups.length > 0) {
+        hints.push(`重复：${dups.map((x) => `${x.event}×${x.registered}`).join('、')}`);
+      }
+    }
+    return {
+      value: `tool:${d.tool}`,
+      label: `${d.label} hooks 收敛到当前 source`,
+      hint: hints.join('；'),
+    };
+  });
   if (confStale) {
     options.push({ value: 'tmuxconf', label: '.tmux.conf 加载声明更新为当前 source' });
   }
   if (options.length === 0) return;
 
   options.push({ value: '__skip__', label: '← 暂不处理' });
-  p.log.warn('检测到部分配置指向其他安装源（漂移）。功能仍可用，但新安装/自修复只会收敛当前 source。');
+  p.log.warn('检测到配置漂移或 codex hooks 重复注册。功能仍可用，但收敛会重写 hooks（codex 需重新 Trust）。');
   const sel = await p.select({
     message: '选择要收敛的项（Esc 跳过）',
     options,

package/package.json

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

package/scripts/adapters/codex.sh

@@ -36,12 +36,17 @@ ADAPTER_PERMISSION_PRE_TOOL_NAMES="request_permissions"
 # 自修复/TUI 调用的安装脚本
 ADAPTER_INSTALLER="${_LIB_DIR}/install-codex-hooks.sh"
 
-# 完整性计数：6 个事件中注册了含 tmux-ai-status codex 的 command 的事件数（按事件，
+# 本插件条目的唯一 marker（归属判定路径无关：contains 子串匹配）。
+# 统一用于 count/integrity/detail/strip——避免历史实现里 strip 用宽串
+# `tmux-ai-status`、check 用 `tmux-ai-status codex` 的发散。
+_CODEX_MARKER="tmux-ai-status codex"
+
+# 完整性计数：6 个事件中注册了含 _CODEX_MARKER 的 command 的事件数（按事件，
 # 非扁平总数——重复+缺失的组合在扁平计数下会假阳性）。
 _CODEX_JQ_COUNT='
     .hooks as $h |
     ["SessionStart","UserPromptSubmit","PreToolUse","PermissionRequest","PostToolUse","Stop"]
-    | map(select([$h[.][]?.hooks[]?.command // empty] | any(contains("tmux-ai-status codex"))))
+    | map(select([$h[.][]?.hooks[]?.command // empty] | any(contains($marker))))
     | length
 '
 
@@ -51,17 +56,17 @@ _CODEX_JQ_COUNT='
 adapter_check_integrity() {
     [ -f "$ADAPTER_HOOKS_FILE" ] || return 1
     local n ev p ok_events=""
-    n=$(jq "$_CODEX_JQ_COUNT" "$ADAPTER_HOOKS_FILE" 2>/dev/null)
+    n=$(jq --arg marker "$_CODEX_MARKER" "$_CODEX_JQ_COUNT" "$ADAPTER_HOOKS_FILE" 2>/dev/null)
     [ "${n:-0}" -ge 6 ] || return 1
     while IFS=$'\t' read -r ev p; do
         if [ -n "$ev" ] && [ -x "$p" ]; then
             case ",$ok_events," in *",$ev,"*) ;; *) ok_events="$ok_events,$ev" ;; esac
         fi
-    done < <(jq -r '.hooks as $h |
+    done < <(jq -r --arg marker "$_CODEX_MARKER" '.hooks as $h |
         ["SessionStart","UserPromptSubmit","PreToolUse","PermissionRequest","PostToolUse","Stop"] as $events |
         $events[] as $e |
         [$h[$e][]?.hooks[]?.command // empty
-         | select(contains("tmux-ai-status codex")) | split(" ")[0]] as $scripts |
+         | select(contains($marker)) | split(" ")[0]] as $scripts |
         select(($scripts | length) > 0) |
         $scripts[] | "\($e)\t\(.)"' "$ADAPTER_HOOKS_FILE" 2>/dev/null)
     for ev in SessionStart UserPromptSubmit PreToolUse PermissionRequest PostToolUse Stop; do
@@ -135,11 +140,11 @@ adapter_check_detail() {
         printf '{"mode":"file","events":{},"plugin":null,"registeredPaths":[],"trust":%s}\n' "$trust_json"
         return 0
     fi
-    pairs=$(jq -r '.hooks as $h |
+    pairs=$(jq -r --arg marker "$_CODEX_MARKER" '.hooks as $h |
         ["SessionStart","UserPromptSubmit","PreToolUse","PermissionRequest","PostToolUse","Stop"] as $events |
         $events[] as $e |
         $h[$e][]?.hooks[]?.command // empty |
-        select(contains("tmux-ai-status codex")) | split(" ")[0] | "\($e)\t\(.)"' "$src" 2>/dev/null)
+        select(contains($marker)) | split(" ")[0] | "\($e)\t\(.)"' "$src" 2>/dev/null)
     rows=""
     while IFS= read -r line; do
         [ -n "$line" ] || continue
@@ -208,17 +213,22 @@ EOF
     printf '%s\n' "${out# }" | tr ' ' '\n'
 }
 
-# 从每个事件数组剔除本插件 group（command 含 tmux-ai-status），事件/hooks 清空后删键。
+# 命令级剥离：逐 hook 删除含 _CODEX_MARKER 的 command（不看 type，缺 type 的
+# 本插件条目同样清除）；group 仍有剩余 hook 则保留，空 group/事件删除。
+# 与 claude 的 _CLAUDE_JQ_STRIP 同构；防御缺 hooks 键 / null / 非数组的 group。
 _codex_strip_managed() {
-    jq '
-      def clean_event:
-        map(select(
-          (.hooks // []) | any(.type == "command" and (.command // "" | contains("tmux-ai-status"))) | not
-        ));
-      if .hooks then
-        .hooks |= (with_entries(.value |= clean_event) | with_entries(select(.value | length > 0)))
+    jq --arg marker "$_CODEX_MARKER" '
+      def trim_group:
+        if (.hooks | type) == "array" then
+          .hooks |= [ .[] | select(((.command // "") | tostring | contains($marker)) | not) ]
+          | select((.hooks | length) > 0)
+        else . end;
+      def trim_event:
+        if type == "array" then [ .[] | trim_group ] else . end;
+      if (.hooks | type) == "object" then
+        .hooks |= (with_entries(.value |= trim_event) | with_entries(select((.value | length) > 0)))
       else . end
-      | if (.hooks // {}) == {} then del(.hooks) else . end
+      | if (.hooks | type) == "object" and ((.hooks | length) == 0) then del(.hooks) else . end
     '
 }
 

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

@@ -479,17 +479,23 @@ build_all_status() {
 }
 
 # --- Pending 集合管理（PreToolUse / PermissionRequest 配对）---
-# 状态判定基于两个 per-pane 集合:
-#   pending-pre   : 已 PreToolUse 未 PostToolUse 的 tool_use_id
-#   pending-perm  : 已 PermissionRequest 未配对的 tool_use_id (含 ! 或 ?)
+# 状态判定基于两个 per-pane 集合（另有一个乱序辅助集合）:
+#   pending-pre   : 已 PreToolUse 未 PostToolUse 的 tool_use_id（行 "id tool ts"）
+#   pending-perm  : 已 PermissionRequest 未配对的 tool_use_id（行 "id mark tool ts"）
+#   recent-post   : 已 PostToolUse 完成的 tool_use_id（行 "id ts"）
+#                   Post 先于 Pre 到达时，迟到的 Pre 据此跳过写入，避免状态卡 ">"
 # 派生规则:
 #   perm 含 "!"   → STATUS=!
 #   perm 含 "?"   → STATUS=?
 #   pre 非空      → STATUS=>
 #   都空          → STATUS=""（事件自行决定）
 
+_PENDING_DONE_WINDOW=60    # 迟到 Pre 的拦截窗口（tool_use_id 单次唯一，10x 余量）
+_PENDING_DONE_RETAIN=300   # recent-post 保留时长（写时修剪）
+
 _pending_pre_path()  { echo "$(_pane_dir)/pending-pre"; }
 _pending_perm_path() { echo "$(_pane_dir)/pending-perm"; }
+_pending_done_path() { echo "$(_pane_dir)/recent-post"; }
 _lock_dir()          { echo "$(_pane_dir)/.lock"; }
 _event_lock_dir()    { echo "$(_pane_dir)/.event-lock"; }
 
@@ -586,17 +592,73 @@ _release_lock() {
     rmdir "$(_lock_dir)" 2>/dev/null
 }
 
+# --- recent-post（已完成 id 的 tombstone）---
+# 调用方必须持 .lock。只读：id 是否在窗口内已完成。
+_recent_done_has() {  # $1=id
+    local id="$1" f now
+    [ -n "$id" ] || return 1
+    f=$(_pending_done_path)
+    [ -s "$f" ] || return 1
+    now=$(date +%s)
+    awk -v id="$id" -v now="$now" -v max="$_PENDING_DONE_WINDOW" '
+        $1 == id && $2 ~ /^[0-9]+$/ && now - $2 <= max { found = 1; exit }
+        END { exit !found }' "$f" 2>/dev/null
+}
+
+# 调用方必须持 .lock。一次 awk 同时完成「同 id 去重 + 过期修剪 + 追加」。
+_record_pending_done() {  # $1=id
+    local id="$1" f now tmp
+    [ -n "$id" ] || return 0
+    f=$(_pending_done_path)
+    now=$(date +%s)
+    tmp="${f}.tmp.$$"
+    if [ -f "$f" ]; then
+        awk -v id="$id" -v cutoff="$((now - _PENDING_DONE_RETAIN))" '
+            $1 != id && $2 ~ /^[0-9]+$/ && $2 >= cutoff { print }' "$f" > "$tmp" 2>/dev/null
+    else
+        : > "$tmp"
+    fi
+    printf '%s %s\n' "$id" "$now" >> "$tmp"
+    mv -f "$tmp" "$f" 2>/dev/null || rm -f "$tmp"
+}
+
+# 调用方必须持 .lock。按首列精确比较（id 可能含 . [ 等 BRE 元字符）。
+_remove_pending_id_locked() {  # $1=id
+    local id="$1" pre perm
+    [ -n "$id" ] || return 0
+    pre=$(_pending_pre_path)
+    perm=$(_pending_perm_path)
+    if [ -f "$pre" ]; then
+        awk -v id="$id" '$1 != id' "$pre" > "${pre}.tmp" 2>/dev/null
+        mv -f "${pre}.tmp" "$pre" 2>/dev/null || rm -f "${pre}.tmp"
+    fi
+    if [ -f "$perm" ]; then
+        awk -v id="$id" '$1 != id' "$perm" > "${perm}.tmp" 2>/dev/null
+        mv -f "${perm}.tmp" "$perm" 2>/dev/null || rm -f "${perm}.tmp"
+    fi
+}
+
 # 在锁内追加一行到 pending-pre。$1=tool_use_id $2=tool_name
+# Post 已先到达的同 id（recent-post 窗口内）→ 跳过并置 _pending_pre_skipped=1，
+# 调用方据此保持已完成状态（不能把迟到的 Pre 重新抬成处理中/审批态）。
+_pending_pre_skipped=0
 _add_pending_pre() {
-    local id="$1" tool="$2"
-    [ -z "$id" ] && return
-    _acquire_lock || return
-    local f; f=$(_pending_pre_path)
-    # 已存在则不重复
-    if ! grep -q "^${id} " "$f" 2>/dev/null; then
-        echo "${id} ${tool:-?} $(date +%s)" >> "$f"
+    local id="$1" tool="$2" pre
+    _pending_pre_skipped=0
+    [ -z "$id" ] && return 0
+    _acquire_lock || return 0
+    pre=$(_pending_pre_path)
+    if _recent_done_has "$id"; then
+        _pending_pre_skipped=1
+        # 防御：Post 的清理曾因 IO/锁失败残留同 id 时，顺手清掉
+        _remove_pending_id_locked "$id"
+    elif ! awk -v id="$id" '$1 == id { found = 1; exit } END { exit !found }' "$pre" 2>/dev/null; then
+        printf '%s %s %s\n' "$id" "${tool:-?}" "$(date +%s)" >> "$pre"
     fi
     _release_lock
+    if [ "$_pending_pre_skipped" = "1" ]; then
+        _ai_log "PENDING: SKIP stale Pre id=${id} tool=${tool:-?} (completed within ${_PENDING_DONE_WINDOW}s)"
+    fi
 }
 
 # 在锁内追加一行到 pending-perm。$1=tool_use_id $2=! 或 ? $3=tool_name
@@ -605,8 +667,9 @@ _add_pending_perm() {
     [ -z "$id" ] && return
     _acquire_lock || return
     local f; f=$(_pending_perm_path)
-    if ! grep -q "^${id} " "$f" 2>/dev/null; then
-        echo "${id} ${mark} ${tool:-?} $(date +%s)" >> "$f"
+    # 首列精确比较（id 可能含 BRE 元字符）
+    if ! awk -v id="$id" '$1 == id { found = 1; exit } END { exit !found }' "$f" 2>/dev/null; then
+        printf '%s %s %s %s\n' "$id" "$mark" "${tool:-?}" "$(date +%s)" >> "$f"
     fi
     _release_lock
 }
@@ -636,40 +699,36 @@ _bind_pending_perm_to_pre() {
     [ -n "$BOUND_PERMISSION_ID" ]
 }
 
-# 从 pending-pre 和 pending-perm 同时移除 id（配对清除）
+# 从 pending-pre 和 pending-perm 同时移除 id（配对清除）。
+# 无论 pending 文件是否存在都记录 tombstone：Post 先于 Pre 到达时，后者是唯一
+# 能拦住迟到 Pre 的证据（见 _add_pending_pre）。
 _remove_pending_id() {
     local id="$1"
-    [ -z "$id" ] && return
-    _acquire_lock || return
-    local pre; pre=$(_pending_pre_path)
-    local perm; perm=$(_pending_perm_path)
-    # 注意: grep -v 无匹配行时退出 1,不能用 && 串接 mv;改用无条件 mv
-    if [ -f "$pre" ]; then
-        grep -v "^${id} " "$pre" > "${pre}.tmp" 2>/dev/null
-        mv "${pre}.tmp" "$pre" 2>/dev/null || rm -f "${pre}.tmp"
-    fi
-    if [ -f "$perm" ]; then
-        grep -v "^${id} " "$perm" > "${perm}.tmp" 2>/dev/null
-        mv "${perm}.tmp" "$perm" 2>/dev/null || rm -f "${perm}.tmp"
-    fi
+    [ -z "$id" ] && return 0
+    _acquire_lock || return 0
+    _record_pending_done "$id"
+    _remove_pending_id_locked "$id"
     _release_lock
 }
 
 # 仅移除已回复的权限请求。OpenCode 的 request ID 与 tool call ID 独立，不能同时清
 # pending-pre；后续 PostToolUse 会用 call ID 清理工具执行项。
+# 不记 tombstone：request id 与 callID 命名空间不同，记了也拦不到迟到的 Pre。
 _remove_pending_perm_id() {
     local id="$1"
     [ -z "$id" ] && return
     _acquire_lock || return
     local perm; perm=$(_pending_perm_path)
     if [ -f "$perm" ]; then
-        grep -v "^${id} " "$perm" > "${perm}.tmp" 2>/dev/null
-        mv "${perm}.tmp" "$perm" 2>/dev/null || rm -f "${perm}.tmp"
+        awk -v id="$id" '$1 != id' "$perm" > "${perm}.tmp" 2>/dev/null
+        mv -f "${perm}.tmp" "$perm" 2>/dev/null || rm -f "${perm}.tmp"
     fi
     _release_lock
 }
 
-# 清空两个 pending 文件（Stop/SessionStart/SessionEnd/UserPromptSubmit/Esc 用）
+# 清空两个 pending 文件（Stop/SessionStart/SessionEnd/UserPromptSubmit/Esc 用）。
+# recent-post 刻意不清：turn/session 边界之后仍可能收到同 turn 迟到的 Pre，
+# 删掉 tombstone 会在边界重新引入残留；其生命周期由 300s 修剪与 pane 目录销毁负责。
 _clear_pending() {
     [ -n "$TMUX_PANE" ] || return
     _acquire_lock || return
@@ -677,16 +736,18 @@ _clear_pending() {
     _release_lock
 }
 
-# pending 集合中是否有 N 秒内的条目（每行 "id tool ts"）。用于区分「工具确实在
-# 跑」与「泄漏/中断残留的旧条目」——并发 hook 抢锁超时会让 _remove_pending_id
-# 静默放弃，集合可能长期残留陈旧 id（实测存在），不能只按非空判定活跃。
+# pending 集合中是否有 N 秒内的条目。用于区分「工具确实在跑」与「泄漏/中断残留
+# 的旧条目」——并发 hook 抢锁超时会让 _remove_pending_id 静默放弃，集合可能长期
+# 残留陈旧 id（实测存在），不能只按非空判定活跃。
+# 时间戳取末列：pending-pre 是 "id tool ts"（3 列），pending-perm 是
+# "id mark tool ts"（4 列）——固定 $3 对 perm 永远不命中（历史 bug）。
 _pending_recent() {  # $1=秒数 → 0=有新鲜条目
     local max="${1:-10}" now f
     now=$(date +%s)
     for f in "$(_pending_pre_path)" "$(_pending_perm_path)"; do
         [ -s "$f" ] || continue
         if awk -v now="$now" -v max="$max" '
-            $3 ~ /^[0-9]+$/ && now - $3 <= max { found = 1; exit }
+            $NF ~ /^[0-9]+$/ && now - $NF <= max { found = 1; exit }
             END { exit !found }' "$f" 2>/dev/null; then
             return 0
         fi

package/scripts/tmux-ai-status

@@ -192,27 +192,34 @@ case "$EVENT" in
     IFS=$'\t' read -r TOOL TOOL_USE_ID <<< "$_tool_fields"
     INPUT_DIGEST=$(printf '%s' "$INPUT" | jq -c '{tool_name, tool_input}' 2>/dev/null)
     _add_pending_pre "$TOOL_USE_ID" "$TOOL"
-    _permission_pre_tool=0
-    for _permission_tool in ${ADAPTER_PERMISSION_PRE_TOOL_NAMES:-}; do
-        [ "$TOOL" = "$_permission_tool" ] && { _permission_pre_tool=1; break; }
-    done
-    if [ "$_permission_pre_tool" = "1" ]; then
-        STATUS="!"
-        _add_pending_perm "$TOOL_USE_ID" "$STATUS" "$TOOL"
+    if [ "$_pending_pre_skipped" = "1" ]; then
+        # Post/PostToolUseFailure 已处理同 id（乱序到达）：不重建 pending、不进入
+        # 审批态（尤其 codex request_permissions 不得复活 !），保持已完成状态。
+        STATUS="$PREV_STATUS"
+        _log_flags="STALE_PRE=skip"
     else
-        # 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
+        _permission_pre_tool=0
+        for _permission_tool in ${ADAPTER_PERMISSION_PRE_TOOL_NAMES:-}; do
+            [ "$TOOL" = "$_permission_tool" ] && { _permission_pre_tool=1; break; }
+        done
+        if [ "$_permission_pre_tool" = "1" ]; then
+            STATUS="!"
+            _add_pending_perm "$TOOL_USE_ID" "$STATUS" "$TOOL"
+        else
+            # 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
+        fi
     fi
     ;;
   PostToolUse|PostToolUseFailure)

package/src/check-detail.js

@@ -95,6 +95,14 @@ export async function checkToolDetail(tool, { run } = {}) {
   };
 }
 
+// 重复注册检测：同事件下 registered > 1 表示有多条本插件 command（跨 group 或多 group）。
+// 只用于提示——codex 重写 hooks.json 会使 trusted_hash 失效，因此不自动收敛。
+export function findDuplicateEvents(detail) {
+  return Object.entries(detail?.events || {})
+    .filter(([, e]) => Number(e?.registered) > 1)
+    .map(([event, e]) => ({ event, registered: Number(e.registered) }));
+}
+
 // 渲染单工具明细为人类可读行。drift 行用 ⚠ 前缀（脚本仍可用，功能未坏，
 // 但指向的安装源不是当前 source——收敛入口在 TUI 侧）。
 export function renderToolDetail(detail) {
@@ -108,6 +116,17 @@ export function renderToolDetail(detail) {
     lines.push(`  ${NO} 无法判定：${detail.error || '未知错误'}`);
   }
 
+  // codex 重复注册：功能性提示（status 仍 ok、exit code 不变），收敛需显式操作
+  if (detail.tool === 'codex') {
+    const dups = findDuplicateEvents(detail);
+    if (dups.length > 0) {
+      const list = dups.map((d) => `${d.event}×${d.registered}`).join('、');
+      lines.push(
+        `  ${WARN} codex hooks 重复注册：${list}——codex 不会自动收敛（重写 hooks.json 会使 trusted_hash 失效，需要重新 Trust all）；可用 TMUX_AI_FORCE_INSTALL=1 重跑 install-codex-hooks.sh，或使用 TUI 收敛入口（会先确认 re-trust 代价）`
+      );
+    }
+  }
+
   if (detail.suppress) {
     lines.push(`  ${WARN} 存在卸载意图标记（suppressed-${detail.tool}）：自动修复已被抑制`);
   }