tmuxclihook 0.1.1 → 0.2.1

package/scripts/adapters/opencode.sh

@@ -0,0 +1,169 @@
+#!/bin/bash
+# adapters/opencode.sh — opencode (sst/opencode) 工具适配器
+#
+# 由 lib-tmux-ai-status.sh 在确定 TOOL_ID=opencode 后 source。契约见 adapters/claude.sh 头注释。
+#
+# ⚠️ opencode 与 Claude/Codex 的关键差异（本 adapter 声明的语义）：
+#   - 无独立 hooks 配置文件：opencode 用 JS/TS **plugin** 模型（~/.config/opencode/plugins/），
+#     不是 Claude 的 settings.json / Codex 的 hooks.json。ADAPTER_HOOKS_FILE 指向本插件生成的
+#     单个 plugin 文件（.ts），install/uninstall 是整文件写入/删除，不做 jq 合并。
+#   - plugin 内部订阅 opencode 的命名 hook（chat.message / tool.execute.before/after）+ 通用
+#     event 流（session.created/idle、permission.*、question.*），拼成 Claude 规范 JSON 后
+#     pipe 给本仓库 tmux-ai-status，核心引擎（tmux-ai-status 的事件 case）零改动。
+#   - opencode 有两套独立「问用户」系统，均经 event 流（非命名 hook，见 issue #7006
+#     permission.ask hook 从不触发）：Permission（bash/edit 授权）发 permission.asked/replied
+#     → `!`；Question（AskUserQuestion 选项弹窗）发 question.asked/replied/rejected，adapter
+#     把 tool_name 填 "AskUserQuestion" → core 派生 `?`。两套的 request_id 用事件 .id/.requestID
+#     精确配对解除。
+#   - 无 SessionEnd：退出无 hook，由 tmux-ai-monitor 做进程检测清理（同 codex）。
+#   - SessionStart 即时：session.created 在会话建立时立即触发（不同于 codex 的 deferred）。
+
+# 6 个规范生命周期事件 + 精确解除审批态的内部 PermissionResolved 事件。
+ADAPTER_EVENTS="SessionStart UserPromptSubmit PreToolUse PermissionRequest PermissionResolved PostToolUse Stop"
+
+# 前台进程名：opencode 二进制无 arch 后缀（区别于 codex 的 codex-aarch64-* 等）
+ADAPTER_PROCESS_NAMES="opencode"
+
+# plugin 文件路径（XDG 全局目录，OPENCODE_CONFIG_DIR 可覆盖）
+ADAPTER_HOOKS_FILE="${OPENCODE_CONFIG_DIR:-${XDG_CONFIG_HOME:-$HOME/.config}/opencode}/plugins/tmux-ai-status.ts"
+
+# opencode 无 SessionEnd → 退出由 tmux-ai-monitor 做进程检测
+ADAPTER_HAS_SESSION_END="false"
+# session.created 即时触发
+ADAPTER_SESSION_START_TIMING="immediate"
+# permission.asked / question.asked 均携带请求 ID（.id），不需要无 ID sentinel。
+ADAPTER_HOLD_UNMATCHED_PERMISSION="false"
+
+# 自修复/TUI 调用的安装脚本
+ADAPTER_INSTALLER="${_LIB_DIR}/install-opencode-hooks.sh"
+
+_OPENCODE_MARKER="tmux-ai-status (managed by tmux-ai-hooks-status)"
+
+# 完整性检查：plugin 文件存在且含本插件标记 + 指向当前仓库的 hook 脚本路径。
+adapter_check_integrity() {
+    [ -f "$ADAPTER_HOOKS_FILE" ] || return 1
+    grep -q "$_OPENCODE_MARKER" "$ADAPTER_HOOKS_FILE" 2>/dev/null || return 1
+    grep -q "${_LIB_DIR}/tmux-ai-status" "$ADAPTER_HOOKS_FILE" 2>/dev/null || return 1
+    grep -q 'case "permission.asked"' "$ADAPTER_HOOKS_FILE" 2>/dev/null || return 1
+    grep -q 'case "question.asked"' "$ADAPTER_HOOKS_FILE" 2>/dev/null || return 1
+    grep -q 'case "permission.replied"' "$ADAPTER_HOOKS_FILE" 2>/dev/null || return 1
+    grep -q 'request_id: p.requestID' "$ADAPTER_HOOKS_FILE" 2>/dev/null
+}
+
+# 生成 plugin 文件内容。$1 = tmux-ai-status 绝对路径。
+_opencode_plugin_content() {
+    local hook_script="$1"
+    cat <<EOF
+// ${_OPENCODE_MARKER} — do not edit, changes will be overwritten on reinstall
+// 由 install-opencode-hooks.sh 生成。把 opencode 原生事件映射为 Claude 规范事件，
+// 拼规范 JSON 喂给 tmux-ai-status，核心引擎（tmux-ai-status 的事件 case）零改动。
+
+const HOOK_SCRIPT = "${hook_script}"
+
+export const TmuxAiStatus = async ({ \$ }) => {
+  const fire = (eventName, payload) => {
+    const json = JSON.stringify(payload || {})
+    return \$\`printf '%s' \${json} | \${HOOK_SCRIPT} opencode \${eventName}\`.quiet().nothrow()
+  }
+
+  // opencode 用「命名 hook」派发消息/工具执行点（chat.message / tool.execute.*），
+  // 权限与提问走通用 event 流（permission.* / question.*），会话生命周期也走 event 流
+  // （session.created/idle）。分开映射：
+  return {
+    // 用户提交提示词
+    "chat.message": async (input) => {
+      await fire("UserPromptSubmit", { session_id: input.sessionID || "" })
+    },
+    // 工具开始执行
+    "tool.execute.before": async (input) => {
+      await fire("PreToolUse", {
+        session_id: input.sessionID || "",
+        tool_name: input.tool || "",
+        tool_use_id: input.callID || "",
+      })
+    },
+    // 工具执行完毕
+    "tool.execute.after": async (input) => {
+      await fire("PostToolUse", {
+        session_id: input.sessionID || "",
+        tool_name: input.tool || "",
+        tool_use_id: input.callID || "",
+      })
+    },
+    // 通用事件流。opencode 有两套独立「问用户」系统，各发各的事件（均经 event 流，
+    // 不经命名 hook —— permission.ask 命名 hook 上游从不触发，见 issue #7006）：
+    //
+    //   1. Permission（bash/edit 等授权）：
+    //      permission.asked   → PermissionRequest（tool_name≠AskUserQuestion → \`!\`）
+    //        properties: {id, sessionID, permission=工具名, tool:{callID}}
+    //      permission.replied → PermissionResolved
+    //        properties: {sessionID, requestID, reply: once|always|reject}
+    //
+    //   2. Question（AskUserQuestion 选项弹窗）：
+    //      question.asked    → PermissionRequest（tool_name=AskUserQuestion → \`?\`）
+    //        properties: {id, sessionID, questions[], tool:{callID}}
+    //      question.replied  → PermissionResolved（用户作答）
+    //      question.rejected → PermissionResolved（用户 dismiss）
+    //        properties: {sessionID, requestID, ...}
+    //
+    // 两套的 request_id 均取事件的 .id（ask）/.requestID（reply），core 精确配对解除。
+    event: async ({ event }) => {
+      const p = event.properties || {}
+      switch (event.type) {
+        case "session.created":
+          return fire("SessionStart", { session_id: p.sessionID || p.id || "" })
+        case "session.idle":
+          return fire("Stop", { session_id: p.sessionID || p.id || "" })
+        case "permission.asked":
+          return fire("PermissionRequest", {
+            session_id: p.sessionID || "",
+            tool_name: p.permission || "",
+            tool_use_id: p.id || "",
+          })
+        case "question.asked":
+          return fire("PermissionRequest", {
+            session_id: p.sessionID || "",
+            tool_name: "AskUserQuestion",
+            tool_use_id: p.id || "",
+          })
+        case "permission.replied":
+        case "question.replied":
+        case "question.rejected":
+          return fire("PermissionResolved", {
+            session_id: p.sessionID || "",
+            request_id: p.requestID || "",
+            reply: p.reply || "",
+          })
+      }
+    },
+  }
+}
+EOF
+}
+
+# 安装：写出/覆盖 plugin 文件。整文件替换（非合并）——同目录下他人 plugin 文件不受影响。
+adapter_install_hooks() {
+    mkdir -p "$(dirname "$ADAPTER_HOOKS_FILE")" 2>/dev/null || true
+    local hook_script="${_LIB_DIR}/tmux-ai-status"
+    local content
+    content=$(_opencode_plugin_content "$hook_script")
+    _install_atomic_write "$content" "$ADAPTER_HOOKS_FILE"
+    echo "opencode plugin installed to $ADAPTER_HOOKS_FILE"
+    echo "Events: $ADAPTER_EVENTS"
+    echo ""
+    echo "⚠️  下次启动 opencode 会自动加载该 plugin（本地文件插件无需额外授信）。"
+}
+
+# 卸载：仅当文件由本插件生成（含 marker）时删除，避免误删用户自建同名 plugin。
+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"
+            echo "opencode plugin uninstalled (removed $ADAPTER_HOOKS_FILE)"
+        else
+            echo "opencode plugin: $ADAPTER_HOOKS_FILE 非本插件生成，跳过删除"
+        fi
+    else
+        echo "opencode plugin: nothing to uninstall ($ADAPTER_HOOKS_FILE not found)"
+    fi
+}

package/scripts/install-claude-hooks.sh

@@ -0,0 +1,19 @@
+#!/bin/bash
+# install-claude-hooks.sh — Claude Code hooks 安装/卸载 wrapper
+# 用法: install-claude-hooks.sh [uninstall]
+#
+# 薄 wrapper：source 公共骨架 + claude adapter，dispatch 到 adapter_install_hooks /
+# adapter_uninstall_hooks。实际逻辑在 scripts/adapters/claude.sh。
+
+set -o errexit
+set -o pipefail
+
+_LIB_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)"
+source "${_LIB_DIR}/lib-install-hooks.sh"
+source "${_LIB_DIR}/adapters/claude.sh"
+
+if [ "${1:-install}" = "uninstall" ]; then
+    adapter_uninstall_hooks
+else
+    adapter_install_hooks
+fi

package/scripts/install-codex-hooks.sh

@@ -0,0 +1,19 @@
+#!/bin/bash
+# install-codex-hooks.sh — Codex CLI hooks 安装/卸载 wrapper（需 codex ≥ 0.144）
+# 用法: install-codex-hooks.sh [uninstall]
+#
+# 薄 wrapper：source 公共骨架 + codex adapter，dispatch 到 adapter_install_hooks /
+# adapter_uninstall_hooks。实际逻辑在 scripts/adapters/codex.sh。
+
+set -o errexit
+set -o pipefail
+
+_LIB_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)"
+source "${_LIB_DIR}/lib-install-hooks.sh"
+source "${_LIB_DIR}/adapters/codex.sh"
+
+if [ "${1:-install}" = "uninstall" ]; then
+    adapter_uninstall_hooks
+else
+    adapter_install_hooks
+fi

package/scripts/install-opencode-hooks.sh

@@ -0,0 +1,19 @@
+#!/bin/bash
+# install-opencode-hooks.sh — opencode plugin 安装/卸载 wrapper
+# 用法: install-opencode-hooks.sh [uninstall]
+#
+# 薄 wrapper：source 公共骨架 + opencode adapter，dispatch 到 adapter_install_hooks /
+# adapter_uninstall_hooks。实际逻辑在 scripts/adapters/opencode.sh。
+
+set -o errexit
+set -o pipefail
+
+_LIB_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)"
+source "${_LIB_DIR}/lib-install-hooks.sh"
+source "${_LIB_DIR}/adapters/opencode.sh"
+
+if [ "${1:-install}" = "uninstall" ]; then
+    adapter_uninstall_hooks
+else
+    adapter_install_hooks
+fi

package/scripts/lib-install-hooks.sh

@@ -0,0 +1,26 @@
+#!/bin/bash
+# lib-install-hooks.sh — hooks 安装公共骨架
+#
+# 被 install-<tool>-hooks.sh wrapper source。提供工具无关的依赖检查与原子写；
+# 工具特定的 jq 合并逻辑在各 adapter 的 adapter_install_hooks/adapter_uninstall_hooks 中。
+#
+# 契约：wrapper source 本文件 + adapters/<tool>.sh 后，调 adapter_install_hooks 或
+# adapter_uninstall_hooks。adapter 的 install 函数用 _install_require_jq / _install_atomic_write。
+
+# 依赖检查：jq 是唯一硬依赖
+_install_require_jq() {
+    if ! command -v jq >/dev/null 2>&1; then
+        echo "ERROR: jq is required. Install with: brew install jq" >&2
+        exit 1
+    fi
+}
+
+# 原子写入：mktemp 与目标同目录 → 同文件系统 → mv 原子。
+# 避免与 AI CLI 并发写产生竞态导致 hooks 字段丢失。
+_install_atomic_write() {
+    local content="$1" target="$2" tmp
+    mkdir -p "$(dirname "$target")" 2>/dev/null || true
+    tmp=$(mktemp "$(dirname "$target")/.hooks.XXXXXX")
+    printf '%s\n' "$content" > "$tmp"
+    mv -f "$tmp" "$target"
+}

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

@@ -0,0 +1,81 @@
+#!/bin/bash
+# lib-tmux-ai-log.sh: 轻量日志模块 — 直接 O_APPEND 追加 + 原子轮转
+# 被 lib-tmux-ai-status.sh source
+# 调用方需设置: TOOL_ID ("claude")、EVENT、_pane_loc
+
+AI_LOG_FILE="/tmp/tmux-ai-status.log"
+AI_LOG_MAX_SIZE=524288   # 512KB 触发轮转
+AI_LOG_KEEP_SIZE=262144   # 轮转后保留尾部 256KB
+AI_LOG_LOCK_DIR="${AI_LOG_FILE}.lock"
+
+# 原子轮转（mkdir 作为互斥锁，多进程安全）
+_ai_log_rotate() {
+    mkdir "$AI_LOG_LOCK_DIR" 2>/dev/null || return 0
+    local cur_size
+    cur_size=$(wc -c < "$AI_LOG_FILE" 2>/dev/null || echo 0)
+    if [ "${cur_size:-0}" -gt "$AI_LOG_MAX_SIZE" ]; then
+        local tmp="${AI_LOG_FILE}.tmp.$$"
+        if tail -c "$AI_LOG_KEEP_SIZE" "$AI_LOG_FILE" > "$tmp" 2>/dev/null; then
+            cat "$tmp" > "$AI_LOG_FILE"
+        fi
+        rm -f "$tmp"
+    fi
+    rmdir "$AI_LOG_LOCK_DIR" 2>/dev/null
+}
+
+_ai_log() {
+    local msg="[$(date '+%Y-%m-%dT%H:%M:%S')] [${TOOL_ID:-?}] [${_pane_loc:-${TMUX_PANE:-?}}] [${EVENT:-?}] $*"
+
+    # 首次创建时限制权限（避免 /tmp 下日志对其它用户可读）
+    [ -f "$AI_LOG_FILE" ] || (umask 077; : >> "$AI_LOG_FILE")
+
+    # POSIX O_APPEND 对单行 ≤PIPE_BUF (≥4096B) 写入保证原子，多进程无需额外锁
+    printf '%s\n' "$msg" >> "$AI_LOG_FILE" 2>/dev/null
+
+    # 按需轮转（单次 wc -c 开销微小，hook 每次只调一次 _ai_log）
+    local fsize
+    fsize=$(wc -c < "$AI_LOG_FILE" 2>/dev/null || echo 0)
+    [ "${fsize:-0}" -gt "$AI_LOG_MAX_SIZE" ] && _ai_log_rotate
+}
+
+# 事件块日志：头行 + 缩进详情行，一次写入保证原子
+# 用法: _ai_log_event PREV_STATUS CURR_STATUS FLAGS_STR [detail_line...]
+_ai_log_event() {
+    local prev="${1:-·}" curr="${2:-·}" flags="$3"; shift 3
+    [ -z "$prev" ] && prev="·"
+    [ -z "$curr" ] && curr="·"
+    local transition
+    if [ "$prev" = "$curr" ]; then
+        transition="'${curr}'"
+    else
+        transition="'${prev}' → '${curr}'"
+    fi
+
+    local header="[$(date '+%Y-%m-%dT%H:%M:%S')] [${TOOL_ID:-?}] [${_pane_loc:-${TMUX_PANE:-?}}] [${EVENT:-?}]  ${transition}  ${flags}"
+
+    [ -f "$AI_LOG_FILE" ] || (umask 077; : >> "$AI_LOG_FILE")
+
+    # 构造整块后一次 printf 追加，≤PIPE_BUF 原子
+    local block="${header}"$'\n'
+    local line
+    for line in "$@"; do
+        [ -z "$line" ] && continue
+        block+="  ${line}"$'\n'
+    done
+    printf '%s' "$block" >> "$AI_LOG_FILE" 2>/dev/null
+
+    local fsize
+    fsize=$(wc -c < "$AI_LOG_FILE" 2>/dev/null || echo 0)
+    [ "${fsize:-0}" -gt "$AI_LOG_MAX_SIZE" ] && _ai_log_rotate
+}
+
+# input 超长截断：>2000B 保留前 2000B 加 "…+Nbytes"
+_ai_log_truncate_input() {
+    local s="$1" max=2000
+    local n=${#s}
+    if [ "$n" -gt "$max" ]; then
+        printf '%s…+%dbytes' "${s:0:$max}" "$((n - max))"
+    else
+        printf '%s' "$s"
+    fi
+}