@cocorograph/hub-agent 0.6.89 → 0.6.91

package/package.json

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

package/scripts/install.sh

@@ -241,6 +241,11 @@ ensure_npm_user_prefix() {
   local cur_prefix
   cur_prefix="$(npm config get prefix 2>/dev/null || echo '')"
   if [[ "$cur_prefix" == "$HOME/.npm-global" ]]; then
+    # ワンライナー (bash -c) は非ログイン非対話で profile が読まれないため、
+    # 既存 prefix の再セットアップ時に $HOME/.npm-global/bin が PATH に乗らず
+    # 後段の `hub-agent` / `claude` 呼び出しが command not found になる事故があった。
+    # 実行中シェルの PATH を毎回明示的に整える。
+    export PATH="$HOME/.npm-global/bin:$PATH"
     color_ok "npm global prefix は既に $HOME/.npm-global"
     return 0
   fi

package/src/main.mjs

@@ -1051,6 +1051,11 @@ export async function maybeSyncClaudeSettings(msg, ctx) {
   }
 }
 
+// Plan ε grace guard の猶予 (ms)。backend の集計タイムアウト (_STREAMS_SYNC_TIMEOUT_S=0.5s)
+// + browser の WS 再接続 + 再 attach を十分に超える値。これ以内に touch された stream は
+// 「再 attach 中で sync に間に合わなかっただけ」とみなして誤殺しない。10min GC より十分短い。
+const STREAMS_SYNC_GRACE_MS = 45_000
+
 /**
  * Plan ε: `agent.streams.sync.response` を受けて backend ↔ agent の現存
  * stream_id を能動同期する。
@@ -1066,14 +1071,34 @@ export function handleStreamsSyncResponse(msg, ctx) {
     Array.isArray(msg?.active_stream_ids) ? msg.active_stream_ids : [],
   )
   const localIds = new Set(ctx.ptyBridge.list())
+  // churn 退化スナップショット保護 (ack_lost 根治 / 2026-06-17 根因 rank3)。
+  // backend は browser 群へ _STREAMS_SYNC_TIMEOUT_S(0.5s) だけ問い合わせて active set を
+  // 集める。再接続バースト中 (本番 ~20s 間隔・code 1006) は browser がまだ再 attach できて
+  // おらず空/部分的な set が返り、その一瞬を authoritative とみなして「ローカル全 stream が
+  // 孤児」と誤判定し、生きている PTY を皆殺しにしていた (再 attach 直後の stream を 1 秒後に
+  // 殺し、以後の入力が stream_missing → 数分単位の「送信待ち」固着。0.6.89 ログ最多 churn 源)。
+  // 空 set は信用せず kill を一切行わない (真の孤児は 10min GC + maxStreams 上限が回収する)。
+  const haveAuthoritativeActiveSet = activeIds.size > 0
   for (const sid of localIds) {
-    if (!activeIds.has(sid)) {
-      ctx.logger?.warn?.(
-        { stream_id: sid, request_id: msg?.request_id },
-        "Plan ε: orphan stream detected, detaching",
+    if (activeIds.has(sid)) continue
+    if (!haveAuthoritativeActiveSet) continue
+    // grace guard: 直近 STREAMS_SYNC_GRACE_MS 以内に touch (attach/write/resize/pty 出力) された
+    // stream は「browser が再接続中で 0.5s 集計に間に合わなかっただけ」の可能性が高い。猶予内は
+    // 殺さず延命する。真に放置された孤児は猶予超過で従来どおり detach され、10min GC も backstop。
+    const lastSeen = ctx.ptyBridge.getLastSeen?.(sid) ?? 0
+    const idleMs = Date.now() - lastSeen
+    if (lastSeen > 0 && idleMs < STREAMS_SYNC_GRACE_MS) {
+      ctx.logger?.info?.(
+        { stream_id: sid, idle_ms: idleMs, request_id: msg?.request_id },
+        "Plan ε: skip detach (within grace, browser likely re-attaching)",
       )
-      ctx.ptyBridge.detach({ stream_id: sid })
+      continue
     }
+    ctx.logger?.warn?.(
+      { stream_id: sid, request_id: msg?.request_id },
+      "Plan ε: orphan stream detected, detaching",
+    )
+    ctx.ptyBridge.detach({ stream_id: sid })
   }
   for (const sid of activeIds) {
     if (!localIds.has(sid)) {

package/src/pty-bridge.mjs

@@ -169,6 +169,17 @@ export class PtyBridge extends EventEmitter {
     this.lastSeenAt.set(stream_id, this._now())
   }
 
+  /**
+   * stream の最終 touch 時刻 (ms epoch) を返す。未登録 / 未 touch は 0。
+   * Plan ε (handleStreamsSyncResponse) の grace 判定で「直近 attach/write/resize/出力が
+   * あった stream は browser が再 attach 中なだけ」と見なして誤殺を防ぐために使う。
+   * @param {string} stream_id
+   * @returns {number}
+   */
+  getLastSeen(stream_id) {
+    return this.lastSeenAt.get(stream_id) ?? 0
+  }
+
   /**
    * `gcStaleMs` を超えて idle な stream を一括 reap する。
    *