termdock 1.0.1 → 1.0.3

package/dist/server/utils/bootCheck.js

@@ -0,0 +1,299 @@
+/**
+ * Termdock 启动自检 — 确保原生模块和系统依赖在启动时可用
+ *
+ * 设计目标：覆盖 npm 全局安装不跑 postinstall 的缺口。
+ * 每次 CLI 启动时检查，通过后写 marker 避免重复检查。
+ *
+ * 检查项目：
+ *   1. node-pty : 实际 spawn 测试 → 失败则从源码重编译
+ *   2. tmux     : 检测是否安装 → 缺失则尝试自动安装
+ *
+ * —— 如何新增检查项 ——
+ *   在 BootChecks 接口加字段，在 runBootChecks() 加 step，
+ *   在 formatBootCheckReport() 加对应的输出行。
+ */
+import { execSync, spawnSync } from 'child_process';
+import fs from 'fs';
+import os from 'os';
+import path from 'path';
+import { createRequire } from 'module';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+const MARKER_FILE = path.join(os.homedir(), '.termdock', '.boot-check-ok');
+function which(bin) {
+    // 先查 PATH
+    try {
+        const result = execSync(`command -v ${bin} 2>/dev/null`, { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
+        if (result)
+            return result;
+    }
+    catch { /* not in PATH */ }
+    // macOS non-interactive SSH 的 PATH 不包含 Homebrew 路径，手动检查
+    const extraPaths = [
+        '/opt/homebrew/bin',
+        '/usr/local/bin',
+        '/opt/local/bin', // MacPorts
+    ];
+    for (const dir of extraPaths) {
+        const fullPath = path.join(dir, bin);
+        try {
+            fs.accessSync(fullPath, fs.constants.X_OK);
+            return fullPath;
+        }
+        catch { /* not here */ }
+    }
+    return null;
+}
+function runQuiet(cmd, timeoutMs = 30_000) {
+    try {
+        const r = spawnSync(cmd, [], {
+            shell: true,
+            timeout: timeoutMs,
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        return { ok: r.status === 0, stdout: r.stdout, stderr: r.stderr };
+    }
+    catch {
+        return { ok: false, stdout: '', stderr: '' };
+    }
+}
+// ---------------------------------------------------------------------------
+// 1. node-pty 验证 + 重建
+// ---------------------------------------------------------------------------
+function checkNodePty() {
+    const result = { ok: false, rebuilt: false };
+    try {
+        const require_ = createRequire(import.meta.url);
+        let ptyPath;
+        try {
+            ptyPath = require_.resolve('node-pty/package.json').replace('/package.json', '');
+        }
+        catch {
+            result.error = 'node-pty not found in module resolution path';
+            return result;
+        }
+        const pty = require_(ptyPath);
+        // 实际 spawn 测试（不仅仅是 require，macOS ARM 预编译包可能 require 成功但 spawn 失败）
+        const proc = pty.spawn(process.env.SHELL || '/bin/bash', [], { name: 'xterm', cols: 80, rows: 24 });
+        proc.kill();
+        result.ok = true;
+        return result;
+    }
+    catch (e) {
+        // require 失败或 spawn 失败 → 尝试重编译
+    }
+    try {
+        const require_ = createRequire(import.meta.url);
+        let ptyPath;
+        try {
+            ptyPath = require_.resolve('node-pty/package.json').replace('/package.json', '');
+        }
+        catch {
+            result.error = 'node-pty not found in module resolution path';
+            return result;
+        }
+        // 清除预编译二进制缓存
+        const prebuildsDir = path.join(ptyPath, 'prebuilds');
+        if (fs.existsSync(prebuildsDir)) {
+            fs.rmSync(prebuildsDir, { recursive: true, force: true });
+        }
+        const rebuild = runQuiet(`cd ${ptyPath} && npx --yes node-gyp rebuild`, 120_000);
+        if (rebuild.ok) {
+            // 重试 spawn
+            try {
+                const pty = require_(ptyPath);
+                const proc = pty.spawn(process.env.SHELL || '/bin/bash', [], { name: 'xterm', cols: 80, rows: 24 });
+                proc.kill();
+                result.ok = true;
+                result.rebuilt = true;
+                return result;
+            }
+            catch {
+                result.error = 'node-pty 重编译成功但 spawn 仍然失败';
+                return result;
+            }
+        }
+        result.error = `node-pty 重编译失败: ${rebuild.stderr.slice(0, 200)}`;
+        return result;
+    }
+    catch (e) {
+        result.error = `node-pty 未找到或无法初始化: ${String(e).slice(0, 200)}`;
+        return result;
+    }
+}
+// ---------------------------------------------------------------------------
+// 2. tmux 检测 + 自动安装
+// ---------------------------------------------------------------------------
+function checkTmux() {
+    const result = { ok: false, installed: false };
+    // 先检查是否已安装
+    const tmuxPath = which('tmux');
+    if (tmuxPath) {
+        try {
+            result.version = execSync('tmux -V', { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
+        }
+        catch { /* ignore */ }
+        result.ok = true;
+        result.installed = false; // 没有新安装
+        return result;
+    }
+    // —— 尝试自动安装 ——
+    const platform = process.platform;
+    if (platform === 'darwin') {
+        // macOS: 尝试多个包管理器
+        const brew = which('brew');
+        if (brew) {
+            const r = runQuiet(`${brew} install tmux 2>&1`, 120_000);
+            if (r.ok || which('tmux')) {
+                try {
+                    result.version = execSync('tmux -V', { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
+                }
+                catch { /* ignore */ }
+                result.ok = true;
+                result.installed = true;
+                return result;
+            }
+        }
+        const port = which('port'); // MacPorts
+        if (port) {
+            const r = runQuiet(`${port} install tmux 2>&1`, 120_000);
+            if (r.ok || which('tmux')) {
+                try {
+                    result.version = execSync('tmux -V', { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
+                }
+                catch { /* ignore */ }
+                result.ok = true;
+                result.installed = true;
+                return result;
+            }
+        }
+        const nixEnv = which('nix-env');
+        if (nixEnv) {
+            const r = runQuiet(`${nixEnv} -iA nixpkgs.tmux 2>&1`, 120_000);
+            if (r.ok || which('tmux')) {
+                try {
+                    result.version = execSync('tmux -V', { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
+                }
+                catch { /* ignore */ }
+                result.ok = true;
+                result.installed = true;
+                return result;
+            }
+        }
+        result.error = 'tmux 未安装且未找到包管理器 (brew/port/nix)。请安装 Homebrew: https://brew.sh';
+        return result;
+    }
+    if (platform === 'linux') {
+        // 尝试多种 Linux 包管理器
+        const managers = [
+            { bin: 'apt-get', cmd: 'apt-get install -y tmux' },
+            { bin: 'dnf', cmd: 'dnf install -y tmux' },
+            { bin: 'yum', cmd: 'yum install -y tmux' },
+            { bin: 'apk', cmd: 'apk add tmux' },
+            { bin: 'pacman', cmd: 'pacman -S --noconfirm tmux' },
+            { bin: 'zypper', cmd: 'zypper install -y tmux' },
+        ];
+        for (const m of managers) {
+            if (!which(m.bin))
+                continue;
+            // 需要 root 权限
+            const r = runQuiet(`sudo ${m.cmd} 2>&1`, 120_000);
+            if (r.ok || which('tmux')) {
+                try {
+                    result.version = execSync('tmux -V', { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
+                }
+                catch { /* ignore */ }
+                result.ok = true;
+                result.installed = true;
+                return result;
+            }
+            // 也试一下不用 sudo
+            const r2 = runQuiet(`${m.cmd} 2>&1`, 120_000);
+            if (r2.ok || which('tmux')) {
+                try {
+                    result.version = execSync('tmux -V', { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
+                }
+                catch { /* ignore */ }
+                result.ok = true;
+                result.installed = true;
+                return result;
+            }
+        }
+        result.error = 'tmux 未安装。请用系统包管理器安装，例如: sudo apt install tmux';
+        return result;
+    }
+    // 其他平台
+    result.error = `不支持在 ${platform} 上自动安装 tmux。请手动安装。`;
+    return result;
+}
+// ---------------------------------------------------------------------------
+// 主入口
+// ---------------------------------------------------------------------------
+let _cachedResult = null;
+export function runBootChecks() {
+    if (_cachedResult)
+        return _cachedResult;
+    // 如果 marker 存在且有效，读取缓存的检查结果
+    if (fs.existsSync(MARKER_FILE)) {
+        try {
+            const cached = JSON.parse(fs.readFileSync(MARKER_FILE, 'utf-8'));
+            if (cached.nodePty?.ok && cached.tmux?.ok) {
+                _cachedResult = {
+                    nodePty: cached.nodePty,
+                    tmux: cached.tmux,
+                };
+                return _cachedResult;
+            }
+            // marker 存在但状态不完整（例如 postinstall 部分失败）→ 重新检查
+        }
+        catch { /* marker 损坏 → 重新检查 */ }
+    }
+    const nodePty = checkNodePty();
+    const tmux = checkTmux();
+    _cachedResult = { nodePty, tmux };
+    // 全部通过则写 marker
+    if (nodePty.ok && tmux.ok) {
+        try {
+            fs.mkdirSync(path.dirname(MARKER_FILE), { recursive: true });
+            fs.writeFileSync(MARKER_FILE, JSON.stringify({ checkedAt: new Date().toISOString(), nodePty, tmux }), 'utf-8');
+        }
+        catch { /* 非关键 */ }
+    }
+    return _cachedResult;
+}
+export function getBootChecks() {
+    return _cachedResult ?? runBootChecks();
+}
+/**
+ * 格式化启动检查报告，用于 CLI 启动时显示给用户。
+ */
+export function formatBootCheckReport(checks, enableColor) {
+    const lines = [];
+    const g = (s) => enableColor ? `\x1b[32m${s}\x1b[0m` : s;
+    const y = (s) => enableColor ? `\x1b[33m${s}\x1b[0m` : s;
+    const r = (s) => enableColor ? `\x1b[31m${s}\x1b[0m` : s;
+    const dim = (s) => enableColor ? `\x1b[2m${s}\x1b[0m` : s;
+    // node-pty
+    if (checks.nodePty.ok) {
+        const tag = checks.nodePty.rebuilt ? ' (rebuilt)' : '';
+        lines.push(`  ${g('✓')} node-pty${dim(tag)}`);
+    }
+    else {
+        lines.push(`  ${r('✗')} node-pty — ${checks.nodePty.error || 'unknown'}`);
+    }
+    // tmux
+    if (checks.tmux.ok) {
+        const detail = checks.tmux.installed
+            ? ' (just installed)'
+            : checks.tmux.version
+                ? ` ${dim(checks.tmux.version)}`
+                : '';
+        lines.push(`  ${g('✓')} tmux${detail}`);
+    }
+    else {
+        lines.push(`  ${y('!')} tmux — ${checks.tmux.error || 'not found'} (shell mode will be used)`);
+    }
+    return lines;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "termdock",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "A complete web-based terminal application with modern UI",
   "type": "module",
   "bin": {
@@ -13,7 +13,8 @@
   "files": [
     "dist",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "scripts"
   ],
   "scripts": {
     "clean": "rimraf dist",
@@ -31,7 +32,8 @@
     "trace:fsio": "node scripts/inspect-fs-io.mjs",
     "test": "vitest --passWithNoTests",
     "test:ui": "vitest --ui",
-    "prepublishOnly": "npm run build"
+    "prepublishOnly": "npm run build",
+    "postinstall": "node scripts/postinstall.mjs"
   },
   "dependencies": {
     "@dnd-kit/core": "^6.3.1",

package/scripts/inspect-diff-trace.mjs

@@ -0,0 +1,148 @@
+#!/usr/bin/env node
+import fs from 'fs';
+import os from 'os';
+import path from 'path';
+
+const logPath = path.join(os.homedir(), '.termdock', 'diff-trace.log');
+const args = process.argv.slice(2);
+const query = args.find((arg) => !arg.startsWith('--')) ?? '';
+const sinceMinutesArg = args.find((arg) => arg.startsWith('--since-min='));
+const sinceMinutes = sinceMinutesArg ? Number(sinceMinutesArg.split('=')[1]) : 30;
+const sinceTs = Number.isFinite(sinceMinutes) && sinceMinutes > 0
+  ? Date.now() - sinceMinutes * 60_000
+  : 0;
+
+if (!fs.existsSync(logPath)) {
+  console.error(`No diff trace log found at ${logPath}`);
+  process.exit(0);
+}
+
+const rawLines = fs.readFileSync(logPath, 'utf8').trimEnd().split('\n').filter(Boolean);
+const records = [];
+for (const line of rawLines) {
+  try {
+    const item = JSON.parse(line);
+    const ts = Date.parse(item.ts);
+    if (sinceTs && Number.isFinite(ts) && ts < sinceTs) continue;
+    const haystack = [
+      item.traceId,
+      item.interactionId,
+      item.filePath,
+      item.requestPath,
+      item.cwd,
+      item.gitRoot,
+      item.requestSlotId,
+      item.previousRequestId,
+      item.code,
+      item.error,
+      item.event,
+      item.source,
+      JSON.stringify(item.data ?? {}),
+    ].filter(Boolean).join(' ');
+    if (query && !haystack.includes(query)) continue;
+    records.push({ ...item, _time: Number.isFinite(ts) ? ts : 0 });
+  } catch {
+    // Ignore malformed old lines.
+  }
+}
+
+if (records.length === 0) {
+  console.log(`No diff trace records matched "${query}" in the last ${sinceMinutes} minute(s).`);
+  process.exit(0);
+}
+
+records.sort((a, b) => a._time - b._time);
+
+const groups = new Map();
+for (const record of records) {
+  const key = record.interactionId || record.traceId || `unlinked:${record.filePath ?? record.requestPath ?? 'unknown'}`;
+  const group = groups.get(key) ?? [];
+  group.push(record);
+  groups.set(key, group);
+}
+
+const expectedOrder = [
+  'global_change_row_event',
+  'change_row_pointer_down',
+  'change_row_click_handler_enter',
+  'change_row_click',
+  'select_diff_file',
+  'select_diff_file_after',
+  'selected_file_state',
+  'start',
+  'effect_start',
+  'visible_start',
+  'request_start',
+  'slot-cancel-previous',
+  'request-start',
+  'git-root-resolved',
+  'response-ok',
+  'response-exception',
+  'response_headers',
+  'response_body_start',
+  'response_body',
+  'visible_result',
+  'state_set_result',
+  'end',
+  'load_text_finally',
+  'parse_done',
+  'tokenize_done',
+];
+
+function hasEvent(group, event) {
+  return group.some((item) => item.event === event);
+}
+
+function isCancelledByNewerRequest(group) {
+  return group.some((item) => (
+    item.code === 'GIT_DIFF_CANCELLED'
+    || item.data?.code === 'GIT_DIFF_CANCELLED'
+    || item.error === 'Git diff request was cancelled because a newer file was selected.'
+  ));
+}
+
+function inferStatus(group) {
+  const last = group[group.length - 1];
+  if (hasEvent(group, 'state_set_result') && hasEvent(group, 'end')) return 'OK';
+  if (isCancelledByNewerRequest(group)) return 'CANCELLED_BY_NEWER_REQUEST';
+  if (hasEvent(group, 'client_watchdog_timeout')) return 'CLIENT_WATCHDOG_TIMEOUT';
+  if (hasEvent(group, 'response_body_timeout')) return 'BODY_TIMEOUT';
+  if (hasEvent(group, 'response-exception') || hasEvent(group, 'response-error')) return 'SERVER_ERROR';
+  if (hasEvent(group, 'response-ok') && !hasEvent(group, 'response_headers')) return 'CLIENT_DID_NOT_OBSERVE_RESPONSE';
+  if (hasEvent(group, 'response_headers') && !hasEvent(group, 'response_body')) return 'CLIENT_BODY_NOT_FINISHED';
+  if (hasEvent(group, 'request_start') && !hasEvent(group, 'request-start')) return 'REQUEST_NOT_REACHED_SERVER';
+  if (hasEvent(group, 'select_diff_file') && !hasEvent(group, 'effect_start')) return 'VIEWER_NOT_STARTED';
+  return `INCOMPLETE_AFTER_${last?.source ?? 'unknown'}:${last?.event ?? 'unknown'}`;
+}
+
+function shortPath(item) {
+  const value = item.filePath ?? item.requestPath ?? item.data?.filePath ?? item.data?.requestedPath ?? '';
+  if (!value || typeof value !== 'string') return '';
+  const parts = value.split('/');
+  return parts.length > 4 ? `.../${parts.slice(-4).join('/')}` : value;
+}
+
+for (const [key, group] of groups) {
+  const first = group[0];
+  const last = group[group.length - 1];
+  const status = inferStatus(group);
+  console.log(`\n=== ${status} ${key} ===`);
+  console.log(`time: ${first.ts} -> ${last.ts}`);
+  console.log(`file: ${shortPath(group.find((item) => item.filePath || item.requestPath) ?? first)}`);
+  const present = expectedOrder.filter((event) => hasEvent(group, event));
+  const missingAfterFirstGap = expectedOrder.filter((event) => !hasEvent(group, event));
+  console.log(`seen: ${present.join(' -> ') || '(none)'}`);
+  if (status !== 'OK' && status !== 'CANCELLED_BY_NEWER_REQUEST') console.log(`missing: ${missingAfterFirstGap.slice(0, 8).join(', ')}`);
+  for (const item of group) {
+    const rel = `${String(item.source ?? '').padEnd(20)} ${String(item.event ?? '').padEnd(26)}`;
+    const duration = item.durationMs !== undefined ? ` duration=${item.durationMs}ms` : '';
+    const bytes = item.bytes !== undefined ? ` bytes=${item.bytes}` : '';
+    const trace = item.traceId ? ` trace=${item.traceId}` : '';
+    const interaction = item.interactionId ? ` interaction=${item.interactionId}` : '';
+    const slot = item.requestSlotId ? ` slot=${item.requestSlotId}` : '';
+    const previous = item.previousRequestId !== undefined ? ` previous=${item.previousRequestId}` : '';
+    const code = item.code ? ` code=${item.code}` : '';
+    const err = item.error ? ` error=${JSON.stringify(item.error)}` : '';
+    console.log(`  ${item.ts} ${rel}${duration}${bytes}${trace}${interaction}${slot}${previous}${code}${err}`);
+  }
+}

package/scripts/inspect-fs-io.mjs

@@ -0,0 +1,107 @@
+#!/usr/bin/env node
+import fs from 'fs';
+import os from 'os';
+import path from 'path';
+
+const logPath = path.join(os.homedir(), '.termdock', 'fs-io.log');
+const args = process.argv.slice(2);
+const query = args.find((arg) => !arg.startsWith('--')) ?? '';
+const sinceMinutesArg = args.find((arg) => arg.startsWith('--since-min='));
+const slowMsArg = args.find((arg) => arg.startsWith('--slow-ms='));
+const sinceMinutes = sinceMinutesArg ? Number(sinceMinutesArg.split('=')[1]) : 30;
+const slowMs = slowMsArg ? Number(slowMsArg.split('=')[1]) : 500;
+const sinceTs = Number.isFinite(sinceMinutes) && sinceMinutes > 0
+  ? Date.now() - sinceMinutes * 60_000
+  : 0;
+
+if (!fs.existsSync(logPath)) {
+  console.error(`No fs-io log found at ${logPath}`);
+  process.exit(0);
+}
+
+const records = [];
+for (const line of fs.readFileSync(logPath, 'utf8').trimEnd().split('\n').filter(Boolean)) {
+  try {
+    const item = JSON.parse(line);
+    const ts = Date.parse(item.ts);
+    if (sinceTs && Number.isFinite(ts) && ts < sinceTs) continue;
+    const haystack = [
+      item.op,
+      item.action,
+      item.event,
+      item.status,
+      item.path,
+      item.cwd,
+      item.repoRoot,
+      item.code,
+      item.error,
+      item.requestSlotId,
+      item.previousRequestId,
+    ].filter(Boolean).join(' ');
+    if (query && !haystack.includes(query)) continue;
+    records.push({ ...item, _time: Number.isFinite(ts) ? ts : 0 });
+  } catch {
+    // Ignore malformed lines.
+  }
+}
+
+if (records.length === 0) {
+  console.log(`No fs-io records matched "${query}" in the last ${sinceMinutes} minute(s).`);
+  process.exit(0);
+}
+
+records.sort((a, b) => a._time - b._time);
+
+function short(value) {
+  if (!value || typeof value !== 'string') return '';
+  const home = os.homedir();
+  const normalized = value.startsWith(home) ? `~${value.slice(home.length)}` : value;
+  return normalized.length > 120 ? `...${normalized.slice(-117)}` : normalized;
+}
+
+function important(item) {
+  const duration = typeof item.durationMs === 'number' ? item.durationMs : 0;
+  return (
+    item.event === 'slot-cancel-previous'
+    || item.event === 'git-child-abort-kill'
+    || item.event === 'git-child-timeout-kill'
+    || item.event === 'git-child-byte-limit-kill'
+    || item.status === 'error'
+    || item.code
+    || item.error
+    || duration >= slowMs
+  );
+}
+
+const byOp = new Map();
+for (const item of records) {
+  if (!item.op || item.event) continue;
+  const stat = byOp.get(item.op) ?? { count: 0, errors: 0, slow: 0, maxMs: 0 };
+  stat.count += 1;
+  if (item.status === 'error' || item.code || item.error) stat.errors += 1;
+  if ((item.durationMs ?? 0) >= slowMs) stat.slow += 1;
+  stat.maxMs = Math.max(stat.maxMs, item.durationMs ?? 0);
+  byOp.set(item.op, stat);
+}
+
+console.log(`fs-io records: ${records.length}; since=${sinceMinutes}m; slow>=${slowMs}ms`);
+if (byOp.size > 0) {
+  console.log('\nSummary by op:');
+  for (const [op, stat] of [...byOp.entries()].sort((a, b) => b[1].maxMs - a[1].maxMs)) {
+    console.log(`  ${op.padEnd(14)} count=${String(stat.count).padStart(3)} slow=${String(stat.slow).padStart(3)} errors=${String(stat.errors).padStart(3)} max=${Math.round(stat.maxMs)}ms`);
+  }
+}
+
+const notable = records.filter(important);
+console.log(`\nNotable events: ${notable.length}`);
+for (const item of notable.slice(-200)) {
+  const duration = item.durationMs !== undefined ? ` duration=${Math.round(item.durationMs)}ms` : '';
+  const count = item.count !== undefined ? ` count=${item.count}` : '';
+  const total = item.total !== undefined ? ` total=${item.total}` : '';
+  const slot = item.requestSlotId ? ` slot=${item.requestSlotId}` : '';
+  const previous = item.previousRequestId !== undefined ? ` previous=${item.previousRequestId}` : '';
+  const code = item.code ? ` code=${item.code}` : '';
+  const error = item.error ? ` error=${JSON.stringify(item.error)}` : '';
+  const target = item.path ? ` path=${short(item.path)}` : item.cwd ? ` cwd=${short(item.cwd)}` : '';
+  console.log(`${item.ts} ${String(item.op ?? '').padEnd(14)} ${String(item.event ?? item.status ?? '').padEnd(24)}${duration}${count}${total}${slot}${previous}${code}${error}${target}`);
+}