@cocorograph/hub-agent 0.6.19 → 0.6.20

package/package.json

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

package/src/claude-stream-bridge.mjs

@@ -389,12 +389,17 @@ class ClaudeStreamSession {
       // 走行中ターンは完走を待ち TTL 後に再チェック (走行中は絶対に撤去しない)
       if (this._busy) {
         this._idleTimer = setTimeout(tick, ttlMs)
+        // idle TTL は最大 7 日。タイマー単独でイベントループを生かさない (unref)。
+        // 本番デーモンは WS 接続等で常駐するので reap は問題なく発火し、テスト/CLI
+        // など他に handle が無いプロセスは即座に終了できる。
+        this._idleTimer.unref?.()
         return
       }
       this._idleTimer = null
       onTimeout?.()
     }
     this._idleTimer = setTimeout(tick, ttlMs)
+    this._idleTimer.unref?.()
   }
 
   /**

package/src/service-install.mjs

@@ -128,6 +128,67 @@ function run(cmd, args, opts = {}) {
   }
 }
 
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms))
+
+/**
+ * macOS の `launchctl bootout` は非同期で、graceful shutdown を持つ hub-agent は
+ * 実際に launchd の登録から消えるまでに時間がかかる。直後に `bootstrap` を叩くと
+ * 旧サービスがまだ抜け切っておらず `Bootstrap failed: 5: Input/output error` 等で
+ * 失敗し、plist はディスクにあるのにロードされない (= KeepAlive 不発 → offline)
+ * 状態に陥る。本関数は対象 service が launchd の登録から消えるまで polling して待つ。
+ * (2026-05-30: install-service の bootout→bootstrap レースで offline 化する事故の修正)
+ *
+ * @param {number} uid
+ * @param {{ timeoutMs?: number, intervalMs?: number }} [opts]
+ * @returns {Promise<boolean>} 消えたら true / timeout なら false
+ */
+async function waitUntilBootedOut(uid, opts = {}) {
+  const timeoutMs = opts.timeoutMs ?? 5000
+  const intervalMs = opts.intervalMs ?? 200
+  const spawn = opts.spawn ?? spawnSync
+  const sleepFn = opts.sleep ?? sleep
+  const now = opts.now ?? (() => Date.now())
+  const deadline = now() + timeoutMs
+  while (now() < deadline) {
+    const r = spawn("launchctl", ["print", `gui/${uid}/${PLIST_LABEL}`], {
+      stdio: "ignore",
+    })
+    // 非 0 = 登録に存在しない = bootout 完了
+    if (r.status !== 0) return true
+    await sleepFn(intervalMs)
+  }
+  return false
+}
+
+/**
+ * bootout 後の bootstrap を、過渡的失敗 (旧サービスの抜け残り等) に対して
+ * リトライする。`run` と違い最終的に失敗したときだけ throw する。
+ *
+ * @param {number} uid
+ * @param {string} dest plist パス
+ * @param {{ attempts?: number, intervalMs?: number }} [opts]
+ */
+async function bootstrapWithRetry(uid, dest, opts = {}) {
+  const attempts = opts.attempts ?? 4
+  const intervalMs = opts.intervalMs ?? 400
+  const spawn = opts.spawn ?? spawnSync
+  const sleepFn = opts.sleep ?? sleep
+  let lastStatus = null
+  for (let i = 0; i < attempts; i++) {
+    const r = spawn("launchctl", ["bootstrap", `gui/${uid}`, dest], {
+      stdio: "inherit",
+    })
+    if (r.status === 0) return
+    // 既にロード済み (status 37 / "service already loaded") は成功とみなす
+    if (r.status === 37) return
+    lastStatus = r.status
+    await sleepFn(intervalMs)
+  }
+  throw new Error(
+    `launchctl bootstrap gui/${uid} ${dest} failed after ${attempts} attempts (last exit ${lastStatus})`
+  )
+}
+
 /**
  * `which hub-agent` の結果を、launchd / systemd から長期間 exec 可能な
  * 安定パスに正規化する。pure 関数。`opts` で fs を差し替えてテスト可能。
@@ -200,10 +261,17 @@ export async function installService({ bin } = {}) {
     await fs.writeFile(dest, expanded, { mode: 0o644 })
 
     const uid = ensureUnixUid()
-    // 既存ロード解除 → bootstrap → kickstart
+    // 既存ロード解除 → (登録が消えるまで待機) → bootstrap (リトライ) → kickstart。
+    // bootout は非同期なので待たずに bootstrap するとレースで失敗し offline 化する
+    // (2026-05-30 の事故)。waitUntilBootedOut で確実に抜けてから bootstrap する。
     spawnSync("launchctl", ["bootout", `gui/${uid}`, dest], { stdio: "ignore" })
-    run("launchctl", ["bootstrap", `gui/${uid}`, dest])
-    run("launchctl", ["kickstart", "-k", `gui/${uid}/${PLIST_LABEL}`])
+    await waitUntilBootedOut(uid)
+    await bootstrapWithRetry(uid, dest)
+    // kickstart は「既に走っている daemon を再起動」する用途。bootstrap + RunAtLoad で
+    // 既に起動済みのことがあり、その場合 kickstart 失敗は致命的でないので throw しない。
+    spawnSync("launchctl", ["kickstart", "-k", `gui/${uid}/${PLIST_LABEL}`], {
+      stdio: "ignore",
+    })
     return { platform: "darwin", path: dest, label: PLIST_LABEL, bin: hubAgentBin }
   }
 
@@ -300,4 +368,6 @@ export const _internal = {
   macPlistPath,
   linuxUnitPath,
   repoTemplatesDir,
+  waitUntilBootedOut,
+  bootstrapWithRetry,
 }