handmux 0.14.0 → 0.16.0

package/bin/handmux.js

@@ -36,12 +36,15 @@ import { codexHooksStatus, installCodexHooks, uninstallCodexHooks } from '../src
 import { statusLineStatus, installStatusLine, uninstallStatusLine, composeHint } from '../src/cli/statusLine.js';
 import { claudeUsagePath } from '../src/usage.js';
 import { probe } from '../src/cli/probe.js';
-import { notifyUpdate, runUpdateCheck, PKG_NAME } from '../src/cli/updateCheck.js';
+import { notifyUpdate, runUpdateCheck, isBrewInstall, PKG_NAME } from '../src/cli/updateCheck.js';
 import { t, initLocale, setLocale } from '../src/cli/i18n/index.js';
 import { runPush } from '../src/cli/pushCmd.js';
 
 const HOME = homedir();
 const SELF = fileURLToPath(import.meta.url);
+// Symlink-resolved entry path — a brew (tap) install is symlinked from the prefix's bin into the Cellar,
+// so isBrewInstall() needs the real target, not the symlink, to spot the `/Cellar/` segment.
+const SELF_REAL = (() => { try { return fs.realpathSync(SELF); } catch { return SELF; } })();
 const HOOKS_SRC = path.resolve(path.dirname(SELF), '../hooks'); // server/hooks (bundled scripts)
 const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
 
@@ -162,6 +165,7 @@ function version() {
 // restart a running instance; on success we refresh the update cache so the "upgrade available" notice
 // clears, and remind them to `handmux restart` to actually run the new code.
 function updateCmd() {
+  if (isBrewInstall(SELF_REAL)) { console.log(t('update.brew')); return; }
   console.log(t('update.running'));
   const r = spawnSync('npm', ['install', '-g', `${PKG_NAME}@latest`], { stdio: 'inherit' });
   if (r.status === 0) {
@@ -176,7 +180,7 @@ function updateCmd() {
 
 // Best-effort upgrade notice from the cached "latest version" (never blocks; refreshes in the background).
 function maybeNotifyUpdate() {
-  notifyUpdate(HOME, { version: requireOpt('../package.json').version, selfPath: SELF });
+  notifyUpdate(HOME, { version: requireOpt('../package.json').version, selfPath: SELF_REAL });
 }
 
 async function start() {
@@ -267,9 +271,26 @@ async function start() {
   await waitAndPrint(true);
 }
 
+// Best-effort SIGTERM to the supervisor's recorded children. The supervisor reaps its own children on a
+// graceful SIGTERM (supervisor.js shutdown), but if it was SIGKILL'd or crashed, its server/tunnel children
+// are orphaned with no reaper — the classic "stray cloudflared after stop". Only called on the dead-
+// supervisor branch, so these pids have no live parent to clean them up.
+function reapOrphans(st) {
+  for (const pid of [st.serverPid, st.tunnelPid]) {
+    if (isAlive(pid)) { try { process.kill(pid, 'SIGTERM'); } catch { /* raced away */ } }
+  }
+}
+
 function stop() {
   const st = readState(HOME);
-  if (!st || !isAlive(st.supervisorPid)) { console.log(t('stop.notRunning')); clearState(HOME); return; }
+  if (!st || !isAlive(st.supervisorPid)) {
+    // Supervisor already gone — but a non-graceful death may have orphaned its children. Reap them before
+    // dropping the state file, or nothing ever will.
+    if (st) reapOrphans(st);
+    console.log(t('stop.notRunning'));
+    clearState(HOME);
+    return;
+  }
   try { process.kill(st.supervisorPid, 'SIGTERM'); } catch { /* race: already gone */ }
   console.log(t('stop.stopped', { pid: st.supervisorPid }));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "handmux",
-  "version": "0.14.0",
+  "version": "0.16.0",
   "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",
@@ -57,13 +57,13 @@
     "vitest": "^2.0.0"
   },
   "whatsNew": [
+    {"version":"0.16.0","date":"2026-07-15","zh":"分屏布局地图 · 手机也能建/删窗格","en":"Split-layout map · create & close panes from the phone"},
+    {"version":"0.15.0","date":"2026-07-14","zh":"键盘弹起终端自适应 · 全屏程序可上下滚动","en":"Keyboard-aware terminal · scroll inside full-screen apps"},
     {"version":"0.14.0","date":"2026-07-13","zh":"终端文字选中拷贝 · 脚本复用推送通道","en":"Terminal select & copy · scripts reuse the push channel"},
     {"version":"0.13.0","date":"2026-07-12","zh":"终端文件路径高亮可点","en":"Tappable, highlighted file paths"},
     {"version":"0.12.3","date":"2026-07-11","zh":"接管会话可自定义名称 + Homebrew 一键安装","en":"Name a takeover session · Homebrew install"},
     {"version":"0.12.2","date":"2026-07-11","zh":"修复主屏图标偏大 / 换图标后不刷新","en":"Home-screen icon: right size & always fresh"},
     {"version":"0.12.1","date":"2026-07-11","zh":"全新品牌图标与双色字标","en":"New brand icon & two-tone wordmark"},
-    {"version":"0.12.0","date":"2026-07-11","zh":"全屏程序也能滑动滚动 · 反馈入口 · 聊天草稿不丢","en":"Swipe-scroll full-screen apps · feedback channels · chat drafts kept"},
-    {"version":"0.11.1","date":"2026-07-09","zh":"修复 Node 18 下无法启动的问题","en":"Fixes startup crash on Node 18"},
-    {"version":"0.11.0","date":"2026-07-08","zh":"国内可用隧道 natapp/cpolar · 配置向导重做","en":"China-usable tunnels · setup redesigned"}
+    {"version":"0.12.0","date":"2026-07-11","zh":"全屏程序也能滑动滚动 · 反馈入口 · 聊天草稿不丢","en":"Swipe-scroll full-screen apps · feedback channels · chat drafts kept"}
   ]
 }