@cocorograph/hub-agent 0.6.95 → 0.6.97

package/package.json

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

package/src/main.mjs

@@ -890,6 +890,17 @@ async function startSessionEventWatcher({ client, logger, readinessTracker }) {
           readinessTracker.arm(sessionName)
         }
       }
+      // 計装 (2026-06-19): ターン境界イベントと arm を成功送信時に記録する。従来は session.event
+      // が WS 未接続スキップ時しかログに残らず、arm→ターン進行→ready の追跡が事後にできなかった
+      // (生成中/停止判定の障害が「ログから盲目」だった主因)。armed は prompt_submit/stop/idle_hint で立つ。
+      logger?.info(
+        {
+          session_name: sessionName,
+          event: data.event,
+          armed: readinessTracker ? readinessTracker.isArmed(sessionName) : undefined,
+        },
+        "session.event push",
+      )
       client.send({
         type: "session.event",
         session_name: sessionName,
@@ -1027,11 +1038,20 @@ function startReadinessLoop({ tracker, logger, intervalMs = 700 }) {
 // 窓経過後に false へ落ちる (ターン終了後のスピナー固着=症状A を悪化させない短さ)。
 const OUTPUT_ACTIVE_MS = Number(process.env.HUB_AGENT_OUTPUT_ACTIVE_MS ?? 8000)
 
+// 権威的な「応答停止 (ハング)」判定の無進捗しきい値。ターン進行中 (armed) なのに、実際の
+// 進捗 (子プロセス実行中 / 出力フロー / ペインのライブ processing) がこの時間継続して観測
+// されなければ stalled とする。frontend 側の jsonl 無音タイマー (長時間ツールで誤検知し、
+// 本当のハングでは turnActive クリアにより見逃す) を置き換える正本。frontend の
+// TURN_STALL_WARN_MS と揃える。
+const STALL_WARN_MS = Number(process.env.HUB_AGENT_STALL_WARN_MS ?? 90000)
+
 function startStateLoop({ client, plugins, logger, intervalMs, claudeBridge, readinessTracker }) {
   const lastByName = new Map() // session_name → {status, context_pct}
   const lastTurnAtByName = new Map() // session_name → 最後に event ファイル化した turnAt
   // (i) session_name → {sig, changedAt}: 出力領域署名の最終変化時刻 (出力フロー検知用)。
   const outputFlowByName = new Map()
+  // 権威的 stall 判定: session_name → 最後に「進捗あり」と観測した時刻 (ms)。
+  const lastProgressAtByName = new Map()
   let stopped = false
 
   // RC-8: WS 再接続のたびに差分送信の基準 (lastByName) をクリアし、次 tick で全 session.state を
@@ -1118,6 +1138,20 @@ function startStateLoop({ client, plugins, logger, intervalMs, claudeBridge, rea
           outputActive = Date.now() - changedAt < OUTPUT_ACTIVE_MS
         }
         const procBusy = childBusy || outputActive
+        // 権威的 stall 判定。armed (ターン進行中=prompt_submit 受信後 stop/ready 未) なのに
+        // 進捗 (procBusy=子プロセス/出力フロー or ペインの live processing) が STALL_WARN_MS
+        // 継続して無いとき stalled=true。armed でない / 進捗ありのときは進捗時刻を更新して
+        // 無進捗カウントをリセットする。frontend はこれを応答停止バナーの正本に使う。
+        const armed = readinessTracker
+          ? readinessTracker.isArmed(s.session_name)
+          : false
+        const nowMs = Date.now()
+        const progressing = procBusy || status === "processing"
+        if (progressing || !armed) {
+          lastProgressAtByName.set(s.session_name, nowMs)
+        }
+        const lastProgressAt = lastProgressAtByName.get(s.session_name) ?? nowMs
+        const stalled = armed && nowMs - lastProgressAt >= STALL_WARN_MS
         const prev = lastByName.get(s.session_name)
         if (
           !prev ||
@@ -1125,7 +1159,8 @@ function startStateLoop({ client, plugins, logger, intervalMs, claudeBridge, rea
           prev.context_pct !== contextPct ||
           prev.permission_mode !== permissionMode ||
           prev.stable !== stable ||
-          prev.proc_busy !== procBusy
+          prev.proc_busy !== procBusy ||
+          prev.stalled !== stalled
         ) {
           lastByName.set(s.session_name, {
             status,
@@ -1133,7 +1168,26 @@ function startStateLoop({ client, plugins, logger, intervalMs, claudeBridge, rea
             permission_mode: permissionMode,
             stable,
             proc_busy: procBusy,
+            stalled,
           })
+          // 計装 (2026-06-19): 状態の「変化時」(差分送信なので低頻度) に値を記録する。従来は
+          // session.state が WS 未接続スキップ時しかログに残らず、proc_busy/stalled/status の実値が
+          // 事後追跡できなかった (生成中/停止判定の障害がログから検証不能だった主因)。childBusy と
+          // outputActive を分けて出し、proc 内省と出力フローのどちらが busy を立てたか切り分け可能にする。
+          logger?.info(
+            {
+              session_name: s.session_name,
+              status,
+              proc_busy: procBusy,
+              child_busy: childBusy,
+              output_active: outputActive,
+              stalled,
+              armed,
+              stable,
+              context_pct: contextPct,
+            },
+            "session.state push",
+          )
           client.send({
             type: "session.state",
             session_name: s.session_name,
@@ -1142,6 +1196,7 @@ function startStateLoop({ client, plugins, logger, intervalMs, claudeBridge, rea
             permission_mode: permissionMode,
             stable,
             proc_busy: procBusy,
+            stalled,
           })
         }
       }

package/src/proc-introspect.mjs

@@ -324,6 +324,12 @@ export class ReadinessTracker {
     return this.byName.get(name)?.busy ?? false
   }
 
+  /** ターン進行中か (prompt_submit で arm 後、ready/cap で disarm するまで true)。
+   *  生成中・Stop フック中の両方を含む。state loop が権威的な stall 判定に使う。 */
+  isArmed(name) {
+    return this.byName.get(name)?.armed ?? false
+  }
+
   /** readiness loop が観測対象に含めるべきか (armed / busy / grace 中)。 */
   isActive(name) {
     const s = this.byName.get(name)

package/src/state.mjs

@@ -134,18 +134,29 @@ function footerRegion(text, lines = 8) {
 }
 
 /**
- * 作業スピナー行 (ライブステータス行) の構造パターン。実機採取 (2026-06-15):
+ * 作業スピナー行 (ライブステータス行) の構造パターン。実機採取 (2026-06-15〜):
  *   "· Blanching… (2m 4s · ↓ 7.5k tokens)"    (出力中)
  *   "✽ Scurrying… (16m 55s · ↓ 66.8k tokens)" (出力中)
  *   "· Puzzling… (11m 12s · thinking)"         (思考中・tokens 語が無い)
- * = 行頭グリフ (·/✻/✽/✶… 1 文字) + 語 + 省略記号 + 括弧で囲まれたライブ経過タイマー。
- * 語 (Blanching/Puzzling/Orbiting…) は無数にあり版で増減するため語リストにしない。行頭は
- * 英数字・空白・本文の箇条書き記号 (-*>#|) を除く 1 文字に限定し、本文プローズ (英字始まり)
- * や箇条書きへの誤マッチを防ぐ。完了サマリー "✻ Brewed for 2m 52s" は省略記号も括弧タイマー
- * も持たないので一致しない。
+ *   "✻ Thinking (3s)"                          (省略記号なし・タイマーのみ)
+ *   "· Puzzling (2m · thinking)"               (省略記号なし・分のみ秒省略)
+ * = 行頭グリフ (·/✻/✽/✶… 1 文字) + 語 + 〔省略記号 または 括弧ライブタイマー〕の少なくとも一方。
+ *
+ * 緩和の経緯 (2026-06-19): 旧版は「省略記号 **かつ** 括弧タイマー **かつ** 秒必須」を全要求して
+ * いたため、claude TUI の版/フェーズで書式が少しでも変わると processing を取りこぼし、生成中なのに
+ * 三点リーダーが消える主因になっていた (実機相当の "✻ Thinking…"(タイマー無) / "✻ Thinking (3s)"
+ * (省略記号無) / "(2m · thinking)"(分のみ秒無) / 深いインデント が全て NOMATCH と実証)。そこで:
+ *   - 省略記号 (…/...) **または** 括弧タイマーのどちらか一方で可 (両方必須をやめる)
+ *   - タイマーは「分のみ」「秒のみ」「分秒」いずれも可 (秒必須をやめる)
+ *   - 行頭インデント制限 (\s{0,4}) を撤廃 (背の高いペイン/折返しで字下げが深い版に備える)
+ * 緩めても安全な理由: 検出は必ず footerRegion + _belowIsOnlyChrome (下が入力欄チロムのみ) を
+ * 通すため、本文プローズ・表セル・箇条書きへの誤点灯は下チロム判定が弾く。行頭は英数字・空白・
+ * 本文記号 (-*>#|) を除く 1 文字に限定し、語は ASCII 英字に限る (日本語プローズは非マッチ)。
+ * 完了サマリー "✻ Brewed for 2m 52s" は省略記号も**括弧**タイマーも持たない (タイマーが括弧外) ため
+ * 引き続き一致しない。
  */
 const SPINNER_LINE_RE =
-  /^\s{0,4}[^\sA-Za-z0-9\-*>#|]\s*[A-Za-z]+(?:…|\.\.\.)\s*\(\s*(?:\d+\s*m\s*)?\d+\s*s\b/
+  /^\s*[^\sA-Za-z0-9\-*>#|]\s*[A-Za-z]+(?:\s+[A-Za-z]+)*\s*(?:(?:…|\.\.\.)|\(\s*(?:\d+\s*m(?:\s*\d+\s*s)?|\d+\s*s)\b)/
 
 /**
  * スピナー行 i の「下」が入力欄チロム (空行/罫線/❯ プロンプト/tips/字下げ継続/権限バナー)