handmux 0.29.0 → 0.29.2

package/dist/connectors/claude/index.js

@@ -4,6 +4,8 @@ import path from 'node:path';
 import { classifyClaude } from '../../src/agents/claude.js';
 import { ClaudeNativeTailReader } from '../../src/agents/claudeNativeTail.js';
 import { LocalConnectorBridgeClient } from '../bridgeClient.js';
+const DEFAULT_SPOOL_MAX_FILES = 2_000;
+const DEFAULT_SPOOL_RETENTION_MS = 24 * 60 * 60_000;
 const EVENT_ID_RE = /^[a-zA-Z0-9][a-zA-Z0-9._:-]{0,255}$/;
 function isRecord(value) {
     return value !== null && typeof value === 'object' && !Array.isArray(value);
@@ -187,6 +189,8 @@ export class ClaudeHookBridgeConnector {
     #panes;
     #process;
     #pollMs;
+    #spoolMaxFiles;
+    #spoolRetentionMs;
     #retryDelayMs;
     #maxRetryDelayMs;
     #logger;
@@ -198,11 +202,13 @@ export class ClaudeHookBridgeConnector {
     #tail = Promise.resolve();
     #started = false;
     #closed = false;
-    constructor({ nativeTail = new ClaudeNativeTailReader(), socketPath, credentialFile, stateDirectory, hookStateFile, eventDirectory, panes, process, pollMs = 250, retryDelayMs = 100, maxRetryDelayMs = 5_000, logger = () => { }, createClient = (options) => new LocalConnectorBridgeClient(options), }) {
+    constructor({ nativeTail = new ClaudeNativeTailReader(), socketPath, credentialFile, stateDirectory, hookStateFile, eventDirectory, panes, process, pollMs = 250, retryDelayMs = 100, maxRetryDelayMs = 5_000, logger = () => { }, createClient = (options) => new LocalConnectorBridgeClient(options), spoolMaxFiles = DEFAULT_SPOOL_MAX_FILES, spoolRetentionMs = DEFAULT_SPOOL_RETENTION_MS, }) {
         if (![socketPath, credentialFile, stateDirectory, hookStateFile, eventDirectory].every(path.isAbsolute)
             || !panes || !process || !Number.isSafeInteger(pollMs) || pollMs < 50
             || !Number.isSafeInteger(retryDelayMs) || retryDelayMs <= 0
-            || !Number.isSafeInteger(maxRetryDelayMs) || maxRetryDelayMs < retryDelayMs) {
+            || !Number.isSafeInteger(maxRetryDelayMs) || maxRetryDelayMs < retryDelayMs
+            || !Number.isSafeInteger(spoolMaxFiles) || spoolMaxFiles <= 0
+            || !Number.isSafeInteger(spoolRetentionMs) || spoolRetentionMs <= 0) {
             throw new TypeError('Claude Hook Bridge Connector requires private paths and Runtime identity sources');
         }
         this.#socketPath = socketPath;
@@ -216,6 +222,8 @@ export class ClaudeHookBridgeConnector {
         this.#pollMs = pollMs;
         this.#retryDelayMs = retryDelayMs;
         this.#maxRetryDelayMs = maxRetryDelayMs;
+        this.#spoolMaxFiles = spoolMaxFiles;
+        this.#spoolRetentionMs = spoolRetentionMs;
         this.#logger = logger;
         this.#createClient = createClient;
     }
@@ -276,6 +284,40 @@ export class ClaudeHookBridgeConnector {
             return [];
         }
     }
+    // Retention for Hook source files that never reach an acknowledgement: a pane that is gone, a client
+    // that never drains, or a durable publish that keeps failing leaves its file behind, and every poll
+    // re-reads it — an observed 170k files over nine days. Files are listed oldest-first, so a cap drops
+    // the stuck ones and an age window only ever expires files no one is waiting on. `gap-*` markers are
+    // not touched: they are bounded by pane/session and carry a degradation signal until confirmed.
+    #pruneSpool(files) {
+        const events = files.filter((file) => path.basename(file).startsWith('event-'));
+        if (events.length === 0)
+            return files;
+        const now = Date.now();
+        const dropped = new Set();
+        for (const [index, file] of events.entries()) {
+            const beyondCap = this.#spoolMaxFiles > 0 && index < events.length - this.#spoolMaxFiles;
+            let expired = false;
+            try {
+                expired = now - fs.statSync(file).mtimeMs > this.#spoolRetentionMs;
+            }
+            catch { /* removed */ }
+            if (beyondCap || expired)
+                dropped.add(file);
+        }
+        if (dropped.size === 0)
+            return files;
+        for (const file of dropped) {
+            try {
+                fs.unlinkSync(file);
+            }
+            catch { /* concurrently removed */ }
+        }
+        this.#logger?.('Dropped Claude Hook source files that could not be delivered', {
+            dropped: dropped.size, remaining: events.length - dropped.size,
+        });
+        return files.filter((file) => !dropped.has(file));
+    }
     async #reconcile() {
         if (this.#closed)
             return;
@@ -297,7 +339,7 @@ export class ClaudeHookBridgeConnector {
             return pending;
         };
         const events = [];
-        for (const eventFile of this.#eventFiles()) {
+        for (const eventFile of this.#pruneSpool(this.#eventFiles())) {
             let event = null;
             try {
                 const stat = fs.lstatSync(eventFile);

package/dist/hooks/handmux-notify.sh

@@ -53,8 +53,18 @@ if [ -z "$CLAUDE_PID" ]; then
   done
 fi
 if [ -n "$CLAUDE_PID" ]; then
-  # `lstart` follows the process locale on macOS; force C so standalone Node can parse it consistently.
-  CLAUDE_STARTED_AT=$(LC_ALL=C ps -p "$CLAUDE_PID" -o lstart= 2>/dev/null || printf '')
+  # Start time in the same form the server reads (processStartedAt in tmuxRuntime.ts): the raw procfs start
+  # tick where procfs exists, otherwise the `lstart` string. A wall-clock `lstart` moves whenever the host
+  # steps the guest clock (WSL2), which makes one live process look like several. The proc root is
+  # overridable so tests can supply a fixture instead of the host's live process table.
+  PROC_ROOT="${HANDMUX_PROC_ROOT:-/proc}"
+  # comm may contain spaces/parentheses: drop "pid (comm) " first, then starttime is field 20.
+  CLAUDE_STARTED_AT=$(sed 's/.*) //' "$PROC_ROOT/$CLAUDE_PID/stat" 2>/dev/null \
+    | awk '{ print $20 }' 2>/dev/null || printf '')
+  if [ -z "$CLAUDE_STARTED_AT" ]; then
+    # `lstart` follows the process locale on macOS; force C so standalone Node can parse it consistently.
+    CLAUDE_STARTED_AT=$(LC_ALL=C ps -p "$CLAUDE_PID" -o lstart= 2>/dev/null || printf '')
+  fi
   CLAUDE_TTY=$(ps -p "$CLAUDE_PID" -o tty= 2>/dev/null || printf '')
 fi
 # payload 经 stdin 原样流给 node(不在 shell 里转义,避免坏数据);pane 含 '%' 直接进 JSON 字段,

package/dist/hooks/handmux-write.cjs

@@ -27,7 +27,10 @@ if (!file || !pane || !src) process.exit(0);
 
 function processFingerprint() {
   const pid = Number(String(claudePid).trim());
-  const startedAt = Date.parse(String(claudeStartedAt).trim());
+  // The Hook reports the platform's start value (see handmux-notify.sh): a raw procfs tick on Linux, an
+  // lstart string on macOS. A digit-only value stays numeric — Date.parse would make it NaN.
+  const rawStartedAt = String(claudeStartedAt).trim();
+  const startedAt = /^\d+$/.test(rawStartedAt) ? Number(rawStartedAt) : Date.parse(rawStartedAt);
   const rawTty = String(claudeTty).trim();
   if (!Number.isSafeInteger(pid) || pid <= 0 || !Number.isFinite(startedAt)
     || !rawTty || rawTty === '?' || rawTty === '??') return undefined;

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "handmux",
-  "version": "0.29.0",
+  "version": "0.29.2",
   "description": "A mobile vibe-coding cockpit — built on tmux: drive your live session, Claude Code / Codex — anything a terminal can run — from your phone.",
   "type": "module",
   "license": "AGPL-3.0-only",
@@ -75,6 +75,18 @@
     "vitest": "^2.0.0"
   },
   "whatsNew": [
+    {
+      "version": "0.29.2",
+      "date": "2026-09-18",
+      "zh": "修复 Linux 下 Claude 事件上报的兼容问题",
+      "en": "Compatibility fix for Claude event reporting on Linux"
+    },
+    {
+      "version": "0.29.1",
+      "date": "2026-09-18",
+      "zh": "修复 Claude 对话入口丢失 · 长时间运行不再变卡",
+      "en": "Fix lost Claude chat entries · no slowdown after long runs"
+    },
     {
       "version": "0.29.0",
       "date": "2026-09-16",
@@ -110,18 +122,6 @@
       "date": "2026-09-04",
       "zh": "对话精细复制 · Pi 上下文状态",
       "en": "Precise chat copy · Pi context status"
-    },
-    {
-      "version": "0.25.2",
-      "date": "2026-09-02",
-      "zh": "修复 Agent 对话断流、排队与工具路径",
-      "en": "Fixed Agent chat streams, queues, and tool paths"
-    },
-    {
-      "version": "0.25.1",
-      "date": "2026-09-02",
-      "zh": "修复 Codex 幽灵任务与对话空白",
-      "en": "Fixed Codex ghost tasks and blank chats"
     }
   ]
 }