@cocorograph/hub-agent 0.6.1 → 0.6.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cocorograph/hub-agent",
-  "version": "0.6.1",
+  "version": "0.6.2",
   "description": "Hub Hosted Cockpit のローカル常駐 agent。Hub と outbound WSS で接続し、ローカルの tmux/pty を中継する。",
   "type": "module",
   "license": "UNLICENSED",

package/src/main.mjs

@@ -230,6 +230,16 @@ export async function startDaemon({ version, ptyModule, claudeSdk } = {}) {
 
   client.connect()
 
+  // 0.6.2 fix: event loop を ref されたまま生かしておく watchdog。
+  // hub-agent の他の background task (heartbeat / reconnect / state loop / fs.watch)
+  // は全て .unref() / persistent:false なので、長時間アイドル + WS 切断 + pty 全 GC
+  // が同時発生すると Node が「やることなし」と判断して exit(0) で silent 終了する
+  // 既存バグがあった。watchdog を 1 つ ref のまま持つことで exit を防ぐ。
+  // shutdown 時に clearInterval して正常終了を許可する。
+  const keepaliveTimer = setInterval(() => {
+    // no-op. ref されていることだけが重要。
+  }, 60_000)
+
   // 5s 周期で全 tmux session の状態を捕捉し、変化したものだけ session.state を push。
   // browser がフォーカスしていない session でも常時更新するためのバックグラウンド職人。
   const stateLoop = startStateLoop({ client, plugins, logger, intervalMs: 5_000 })
@@ -246,11 +256,30 @@ export async function startDaemon({ version, ptyModule, claudeSdk } = {}) {
     ptyBridge.shutdown()
     claudeBridge?.shutdown?.()
     client.stop()
+    // 0.6.2 fix: watchdog を解放して event loop を抜けられるようにする
+    clearInterval(keepaliveTimer)
     process.exit(0)
   }
   process.on("SIGINT", () => shutdown("SIGINT"))
   process.on("SIGTERM", () => shutdown("SIGTERM"))
 
+  // 0.6.2 fix: 例外で silent 終了しないよう最後のセーフティネット。
+  // Node 24 で unhandledRejection は default で process を kill する仕様のため、
+  // warn ログだけ出して継続させる (本来の原因は別途修正必要だが、agent が落ちて
+  // ユーザー作業が止まる方が痛い)。
+  process.on("unhandledRejection", (reason, promise) => {
+    logger.error(
+      { reason: String(reason), stack: reason?.stack },
+      "unhandledRejection (agent kept alive by watchdog)",
+    )
+  })
+  process.on("uncaughtException", (err) => {
+    logger.error(
+      { err: err?.message, stack: err?.stack },
+      "uncaughtException (agent kept alive by watchdog)",
+    )
+  })
+
   return { client, plugins, ptyBridge, claudeBridge }
 }
 

package/templates/co.cocorograph.hub-agent.plist

@@ -15,13 +15,20 @@
   <key>RunAtLoad</key>
   <true/>
 
+  <!--
+    KeepAlive を無条件 true に変更 (0.6.2 fix)。
+    旧設定 `SuccessfulExit=false` は「正常終了 (exit 0) なら再起動しない」だが、
+    hub-agent の全 background task (heartbeat / reconnect / state loop / fs.watch) が
+    .unref() されているため、長時間アイドル + WS 切断 + pty GC kill で全 ref が
+    0 になり Node が exit(0) で「正常終了」する事象が頻発していた。launchctl が
+    「正常終了だから restart 不要」と判断し、agent が静かに停止 → ユーザーは
+    「offline」表示で気づく。本修正で「どんな exit code でも再起動」に変更し
+    ThrottleInterval=10s で spawn loop も防ぐ。
+    main.mjs 側にも watchdog setInterval を追加して exit 自体を起こさない設計に
+    したが、plist 側の defense in depth として KeepAlive も無条件化する。
+  -->
   <key>KeepAlive</key>
-  <dict>
-    <key>SuccessfulExit</key>
-    <false/>
-    <key>NetworkState</key>
-    <true/>
-  </dict>
+  <true/>
 
   <key>StandardOutPath</key>
   <string>__HOME__/.hub/agent.log</string>