tmuxclihook 0.3.1 → 0.3.3

package/README.md

@@ -12,6 +12,10 @@ tmuxclihook
 # 检查 npm registry 并将全局安装更新到最新版
 tmuxclihook update
 
+# 查看版本 / 帮助（version、--version、-v 与 help、--help、-h 等价）
+tmuxclihook --version
+tmuxclihook --help
+
 # 插件已经载入 tmux 后
 prefix + I
 
@@ -28,6 +32,8 @@ hooks 安装、tmux 集成写入的路径由「source」决定：环境变量 `T
 
 `tmuxclihook update` 会显示当前版本，通过 `npm view tmuxclihook version` 查询最新版；版本不同时直接执行 `npm install -g tmuxclihook@latest`，版本相同则不做修改。网络查询或安装失败时命令以非零状态退出。
 
+安装成功后会做一次生效自检：按 PATH 解析实际会被运行的 `tmuxclihook`，读取其真实版本与最新版比对。若本机使用 volta，`npm install -g` 只会更新 node 工具链目录里的副本、不会更新 volta 的 shim 镜像（实测 volta 2.0.2：shim npm 的全局 prefix 即工具链目录），自检发现这种情况时会自动补执行 `volta install tmuxclihook@latest` 使更新生效并复检；volta 缺失或修正失败时打警告并提示手动命令。`npm install` 始终是标准安装方式，无需因 volta 改变习惯。
+
 ## 功能
 
 | 菜单项 | 说明 |

package/bin/cli.js

@@ -27,7 +27,7 @@ import {
 } from '../src/adapters-meta.js';
 import { setSource, clearSource, getPersistedSource, originLabel } from '../src/source.js';
 import { note, padDisplay } from '../src/tui.js';
-import { updatePackage } from '../src/update.js';
+import { updatePackage, CURRENT_VERSION } from '../src/update.js';
 
 const OK = '✓';
 const NO = '✗';
@@ -365,13 +365,26 @@ async function main() {
   p.outro('完成');
 }
 
-if (process.argv[2] === 'update') {
+const arg = process.argv[2];
+if (arg === 'update') {
   updatePackage().then((ok) => {
     if (!ok) process.exitCode = 1;
   }).catch((err) => {
     console.error(err);
     process.exitCode = 1;
   });
+} else if (arg === '--version' || arg === '-v' || arg === 'version') {
+  console.log(`tmuxclihook v${CURRENT_VERSION}`);
+} else if (arg === '--help' || arg === '-h' || arg === 'help') {
+  console.log(
+    'tmuxclihook — tmux-ai-status 交互式安装器\n' +
+    '\n' +
+    '用法：\n' +
+    '  tmuxclihook              打开交互式 TUI 安装器\n' +
+    '  tmuxclihook update       检查并更新到 npm 最新版本\n' +
+    '  tmuxclihook version      显示版本（--version / -v 等价）\n' +
+    '  tmuxclihook help         显示本帮助（--help / -h 等价）',
+  );
 } else {
   main().catch((err) => {
     console.error(err);

package/package.json

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

package/src/update.js

@@ -1,4 +1,5 @@
-import { readFileSync } from 'node:fs';
+import { readFileSync, accessSync, constants as fsConstants, realpathSync } from 'node:fs';
+import { delimiter, dirname, join } from 'node:path';
 import { execa } from 'execa';
 
 const PACKAGE_NAME = 'tmuxclihook';
@@ -6,10 +7,122 @@ const packageJson = JSON.parse(readFileSync(new URL('../package.json', import.me
 
 export const CURRENT_VERSION = packageJson.version;
 
+// —— 生效版本自检 ————————————————————————————————————————————————
+//
+// `npm install -g` 在版本管理器（volta 等）环境下不会更新其管理的 shim：
+// volta 的 `~/.volta/bin` shim 指向 packages/ 镜像，而 npm -g 只写 node
+// 工具链目录，两者互不感知（实测 0.3.0 → 0.3.2 升级时用户命令仍解析到
+// 旧版）。install 成功后按 PATH 解析「用户实际会运行的那份」，尽力读取
+// 真实版本并与 registry latest 比对，无法确认或版本不符时打警告。
+// 验证是尽力而为的提示，不改变 update 的返回值（install 本身已成功）。
+
+function findOnPath(name, env) {
+  for (const dir of (env.PATH || '').split(delimiter)) {
+    if (!dir) continue;
+    const candidate = join(dir, name);
+    try {
+      accessSync(candidate, fsConstants.X_OK);
+      return candidate;
+    } catch {
+      // 无此文件或不可执行，继续找下一个目录
+    }
+  }
+  return null;
+}
+
+// npm 布局下入口是 .../lib/node_modules/<pkg>/bin/cli.js（或其 symlink）：
+// realpath 后向上最多 3 层找 name 匹配的 package.json 读版本。版本管理器
+// shim 是独立二进制，向上找不到包 → 返回 null。
+function readOwnPackageVersion(entryPath) {
+  let real;
+  try {
+    real = realpathSync(entryPath);
+  } catch {
+    return null;
+  }
+  let dir = dirname(real);
+  for (let i = 0; i < 3; i += 1) {
+    try {
+      const pkg = JSON.parse(readFileSync(join(dir, 'package.json'), 'utf8'));
+      if (pkg.name === PACKAGE_NAME && typeof pkg.version === 'string') return pkg.version;
+    } catch {
+      // 该层无 package.json 或不可解析，继续向上
+    }
+    dir = dirname(dir);
+  }
+  return null;
+}
+
+// PATH 命中的是 shim 时，尝试 volta 的包镜像路径闭环确认（volta 实现细节，
+// 读不到就放弃，不崩）。VOLTA_HOME 未设时用 ~/.volta。
+function readVoltaImageVersion(env) {
+  const voltaHome = env.VOLTA_HOME || join(env.HOME || '', '.volta');
+  const pkgPath = join(
+    voltaHome, 'tools', 'image', 'packages', PACKAGE_NAME,
+    'lib', 'node_modules', PACKAGE_NAME, 'package.json',
+  );
+  try {
+    return JSON.parse(readFileSync(pkgPath, 'utf8')).version || null;
+  } catch {
+    return null;
+  }
+}
+
+export function verifyEffectiveVersion(latestVersion, env = process.env) {
+  const entry = findOnPath(PACKAGE_NAME, env);
+  if (!entry) return { status: 'unknown', path: null, version: null };
+
+  const ownVersion = readOwnPackageVersion(entry);
+  if (ownVersion) {
+    return { status: ownVersion === latestVersion ? 'ok' : 'mismatch', path: entry, version: ownVersion };
+  }
+
+  const voltaVersion = readVoltaImageVersion(env);
+  if (voltaVersion) {
+    return { status: voltaVersion === latestVersion ? 'ok' : 'mismatch', path: entry, version: voltaVersion };
+  }
+  return { status: 'unknown', path: entry, version: null };
+}
+
+function warnNotEffective(log, result) {
+  const where = result.path ? ` (${result.path})` : '';
+  log.error(
+    `Warning: the tmuxclihook command on your PATH${where} did not reflect the new version` +
+    (result.version ? ` (still v${result.version})` : '') + '.',
+  );
+  log.error(`If you use volta, run: volta install ${PACKAGE_NAME}@latest`);
+}
+
+// volta 生效修正：`npm install -g` 只写 node 工具链目录，不更新 volta 的
+// shim 镜像（实测 volta 2.0.2：shim npm 的全局 prefix 就是工具链目录），
+// 用户的命令经 ~/.volta/bin shim 解析时仍是旧版。检测到 volta 可用时自动
+// 补一次 volta install 使更新生效。npm install -g 始终是安装语义本身，
+// volta 只在自检发现未生效时被自动调用，用户无需改变安装习惯。
+export async function repairWithVolta(run, log, env = process.env) {
+  const voltaHome = env.VOLTA_HOME || join(env.HOME || '', '.volta');
+  const voltaBin = findOnPath('volta', env) || join(voltaHome, 'bin', 'volta');
+  try {
+    accessSync(voltaBin, fsConstants.X_OK);
+  } catch {
+    return false;
+  }
+  log.log('Detected volta on this machine; applying the update via volta install...');
+  try {
+    await run('volta', ['install', `${PACKAGE_NAME}@latest`], { stdio: 'inherit' });
+    return true;
+  } catch (err) {
+    log.error(`volta install failed: ${err}`);
+    return false;
+  }
+}
+
 export async function updatePackage(options = {}) {
   const run = options.run || execa;
   const log = options.log || console;
   const currentVersion = options.currentVersion || CURRENT_VERSION;
+  // 显式传 null 跳过自检/修正（测试用）；默认真实现
+  const verify = options.verify === undefined ? verifyEffectiveVersion : options.verify;
+  const repairVolta = options.repairVolta === undefined ? repairWithVolta : options.repairVolta;
 
   log.log(`Current version: v${currentVersion}`);
 
@@ -35,5 +148,22 @@ export async function updatePackage(options = {}) {
   }
 
   log.log(`Done. Updated to v${latestVersion}`);
+
+  if (verify) {
+    let result = await verify(latestVersion);
+    if (result.status !== 'ok') {
+      // PATH 命中的副本未反映新版本（典型：volta shim 镜像未更新）——
+      // 自动走 volta 完成生效步骤，然后复检。
+      if (repairVolta && await repairVolta(run, log)) {
+        result = await verify(latestVersion);
+      }
+      if (result.status === 'ok') {
+        log.log(`Verified: tmuxclihook on your PATH now resolves to v${latestVersion}.`);
+      } else {
+        warnNotEffective(log, result);
+      }
+    }
+  }
+
   return true;
 }

package/tmux-ai-hooks-status.tmux

@@ -73,10 +73,10 @@ fi
 # client-session-changed: attach 与 switch-client 的共同汇聚点 = 「进入」→ 记
 # @ai_entered_time（排序用：刚进入的 session 排最后；handler 内以 per-client
 # 上次 session 对比过滤自指 switch）+ 刷新聚合
+tmux set-hook -g client-session-changed "run-shell '${CURRENT_DIR}/scripts/tmux-ai-status claude _session-switched #{hook_client_name}'" 2>/dev/null || true
 # 注：_refresh 与 TOOL_ID 无关（仅重建聚合 + 自修复 claude hooks），统一传 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'"
-tmux set-hook -g client-session-changed "run-shell '${CURRENT_DIR}/scripts/tmux-ai-status claude _session-switched #{hook_client_name}'" 2>/dev/null || true
 # （client-attached 不再注册：attach 场景由 client-session-changed 覆盖）
 # pane-exited: 程序自然退出 → 触发孤儿清理（#{pane_id} 在此 hook 中不可靠）
 tmux set-hook -g pane-exited       "run-shell '${CURRENT_DIR}/scripts/tmux-ai-status claude _refresh'"