@cocorograph/hub-agent 0.8.83 → 0.8.84

package/src/pane-cli-flag.mjs

@@ -1,30 +0,0 @@
-/**
- * 「tmux pane に CLI (claude / codex) の TUI を起動しているか」の単一判定。
- *
- * この 1 フラグが tmux.mjs (pane で TUI を起動するか) と state.mjs (pane を
- * capture-pane で読む意味があるか) の両方の分岐条件になるため、どちらからも
- * import できる依存の無い最小モジュールに切り出してある。tmux.mjs 側に置いたまま
- * state.mjs から import すると tmux.mjs → state.mjs → tmux.mjs の循環になる。
- *
- * 後方互換のため `tmux.mjs` からも re-export している (既存の import 先を壊さない)。
- */
-
-/**
- * tmux pane で CLI (claude / codex) の TUI を起動してよいかを判定する。
- *
- * **既定は false**（pane は素のシェルのまま）。Cockpit のターミナルモードは
- * 2026-07-03 に封印済みで、通常運用は常にチャットモード (Agent SDK / codex
- * app-server) になった。それでも createSession は pane で TUI を起動し続けていたため、
- * **誰も見ていない CLI が常駐**する。実測 (2026-08-01 中村さん端末): tmux セッション
- * 33 個に対して pane の `claude` プロセス 31 個・合計 RSS 1.7 GB。
- *
- * `HUB_AGENT_TMUX_LAUNCH_CLI=1` のときだけ従来どおり起動する（デバッグ・TUI を
- * 意図的に使いたいときの逃げ道）。呼び出し元ごとに挙動を変えないため、判定は
- * この関数 1 箇所に集約し、opts では上書きさせない。
- *
- * @param {NodeJS.ProcessEnv} [env]
- * @returns {boolean}
- */
-export function shouldLaunchPaneCli(env = process.env) {
-  return env?.HUB_AGENT_TMUX_LAUNCH_CLI === "1"
-}

package/src/state.mjs

@@ -1,595 +0,0 @@
-/**
- * tmux session の Claude Code TUI 状態を判定する (Sprint H part 2)。
- *
- * - listSessionNames(): `tmux list-sessions -F '#S'` で session 名一覧
- * - detectStatus(sessionName): `tmux capture-pane -p -t name -S -30 -E -` で末尾を取得
- *   → "esc to interrupt" → processing / "❯ " or "> " → waiting / それ以外 → idle
- * - detectContextPct(text): pane 末尾から "X% context left" / "X% until auto-compact"
- *   等のパターンを拾う (見つからなければ null)
- * - plugin `transformStatusDetection` hook を chain して結果差し替え可
- *
- * ⚠️ **既定では pane を読まない** (2026-08-01)。Cockpit のターミナルモード封印に伴い
- * pane に CLI の TUI を起動しなくなった (`shouldLaunchPaneCli()` 既定 false) ため、
- * capture-pane は「素のシェルの画面」を読むだけで、判定結果は退化した定値にしかならない。
- * detectSessionState はその設定を見て capture-pane 自体をスキップする。詳細は同関数の JSDoc。
- *
- * 移植元: D00000_cockpit/webapp/lib/tmux.ts (getSessionStatus 部分)
- * 仕様書: ナレッジ/インフラ/cockpit-hub-hosted-integration-spec (id=6080)
- */
-import { execFile } from "node:child_process"
-import { promisify } from "node:util"
-
-import { runHookChain } from "./plugin-loader.mjs"
-import { shouldLaunchPaneCli } from "./pane-cli-flag.mjs"
-
-const execFileP = promisify(execFile)
-
-const STATUSES = Object.freeze(["processing", "waiting", "idle"])
-
-/**
- * P1: tmux プロセス fork 削減用の短期/長期キャッシュ。
- *
- * 5s 周期の state loop が N セッション毎に capture-pane (pane scrape) +
- * display-message (cwd) を spawn し、list_sessions も同様に二重取得していた。
- * N セッションで毎 5s に 2N+1 プロセスを fork する負荷を、以下のキャッシュで抑える:
- *   - capture-pane: 短期キャッシュ (CAPTURE_TTL_MS < state loop 周期)。state loop と
- *     近接時刻の list_sessions が同じ pane scrape を共有する (状態検出の鮮度は維持)。
- *   - getSessionCwd: cwd は変化が稀なので長期キャッシュ (CWD_TTL_MS)。毎 tick の
- *     display-message spawn を排除し fork 数を半減させる。
- * TTL は env で上書き可能 (テスト/チューニング用)。0 を渡すとキャッシュ無効。
- */
-const CAPTURE_TTL_MS = Number(process.env.HUB_AGENT_CAPTURE_TTL_MS ?? 2500)
-const CWD_TTL_MS = Number(process.env.HUB_AGENT_CWD_TTL_MS ?? 60000)
-
-/** @type {Map<string, {at: number, value: string}>} session名 → capture-pane 結果 */
-const _captureCache = new Map()
-/** @type {Map<string, {at: number, value: string|null}>} session名 → cwd */
-const _cwdCache = new Map()
-
-/** キャッシュから無効化する (session 終了時等に呼べるよう export)。 */
-export function invalidateSessionCache(sessionName) {
-  if (sessionName == null) {
-    _captureCache.clear()
-    _cwdCache.clear()
-    _statusGate.clear()
-    _spinnerFreezeByName.clear()
-    _stabilityByName.clear()
-    return
-  }
-  _captureCache.delete(sessionName)
-  _cwdCache.delete(sessionName)
-  _statusGate.delete(sessionName)
-  _spinnerFreezeByName.delete(sessionName)
-  // _stabilityByName も per-session で消す (消滅セッションの GC 漏れ=メモリリーク対策, perf監査)。
-  _stabilityByName.delete(sessionName)
-}
-
-/**
- * processing → waiting/idle の「降格」だけ独立 2 サンプルで確定するヒステリシス。
- *
- * capture-pane は claude TUI の再描画途中 (フッター消去〜再描画の間) を拾うことが
- * あり、生成中なのに一瞬 waiting/idle と誤読する。この単発の誤読が frontend の
- * ターン表示 (三点リーダー) やステータスドットを消す方向に直撃するため、降格は
- * 「同じ非 processing 値が STATUS_DOWNGRADE_CONFIRM_MS 以上あけて 2 回読めた」
- * ときだけ確定し、それまでは processing を維持する。
- *   - 昇格 (→ processing) は即時 (誤読で点く分には次サンプルで自然回復し、実害が小さい)
- *   - 確定窓は capture キャッシュ TTL (CAPTURE_TTL_MS=2.5s) より長く取り、同一
- *     キャッシュサンプルの 2 回読みで誤確定しないようにする
- *   - 実ターン終了の体感は frontend の hook 由来 session.event 'stop' が即時に担う
- *     ため、ここで数秒遅れてもサイドバードットが ~5s 遅れるだけで UX 影響は無い
- */
-const STATUS_DOWNGRADE_CONFIRM_MS = Number(
-  process.env.HUB_AGENT_STATUS_DOWNGRADE_MS ?? 3000,
-)
-/** @type {Map<string, {lastConfirmed: string|null, pending: {status: string, at: number}|null}>} */
-const _statusGate = new Map()
-
-export function debounceStatusDowngrade(sessionName, rawStatus, now = Date.now()) {
-  if (!sessionName) return rawStatus
-  const g = _statusGate.get(sessionName) || { lastConfirmed: null, pending: null }
-  // processing への昇格 / processing 以外からの遷移は即時確定。
-  if (rawStatus === "processing" || g.lastConfirmed !== "processing") {
-    g.lastConfirmed = rawStatus
-    g.pending = null
-    _statusGate.set(sessionName, g)
-    return rawStatus
-  }
-  // lastConfirmed=processing からの降格要求: 同値の 2 サンプル目 (確定窓経過後) で確定。
-  if (
-    g.pending &&
-    g.pending.status === rawStatus &&
-    now - g.pending.at >= STATUS_DOWNGRADE_CONFIRM_MS
-  ) {
-    g.lastConfirmed = rawStatus
-    g.pending = null
-    _statusGate.set(sessionName, g)
-    return rawStatus
-  }
-  if (!g.pending || g.pending.status !== rawStatus) {
-    g.pending = { status: rawStatus, at: now }
-  }
-  _statusGate.set(sessionName, g)
-  return "processing"
-}
-
-/** テスト用: 降格ヒステリシスの状態を空にする。 */
-export function _resetStatusGate() {
-  _statusGate.clear()
-}
-
-const CONTEXT_PATTERNS = [
-  /(\d{1,3})\s*%\s*context\s*left/i,
-  /context\s*[:\-]?\s*(\d{1,3})\s*%/i,
-  /(\d{1,3})\s*%\s*until\s*auto[-\s]?compact/i,
-]
-
-function stripAnsi(s) {
-  // ANSI CSI / OSC / charset switch を削る
-  return s
-    .replace(/\x1b\[[0-9;?]*[a-zA-Z]/g, "")
-    .replace(/\x1b\][^\x07]*\x07/g, "")
-    .replace(/\x1b[()][AB012]/g, "")
-}
-
-/**
- * 作業スピナー行 (ライブステータス行) の構造パターン。実機採取 (2026-06-15〜):
- *   "· Blanching… (2m 4s · ↓ 7.5k tokens)"    (出力中)
- *   "✽ Scurrying… (16m 55s · ↓ 66.8k tokens)" (出力中)
- *   "· Puzzling… (11m 12s · thinking)"         (思考中・tokens 語が無い)
- *   "✻ Thinking (3s)"                          (省略記号なし・タイマーのみ)
- *   "· Puzzling (2m · thinking)"               (省略記号なし・分のみ秒省略)
- * = 行頭グリフ (·/✻/✽/✶… 1 文字) + 語 + 〔省略記号 または 括弧ライブタイマー〕の少なくとも一方。
- *
- * 緩和の経緯 (2026-06-19): 旧版は「省略記号 **かつ** 括弧タイマー **かつ** 秒必須」を全要求して
- * いたため、claude TUI の版/フェーズで書式が少しでも変わると processing を取りこぼし、生成中なのに
- * 三点リーダーが消える主因になっていた (実機相当の "✻ Thinking…"(タイマー無) / "✻ Thinking (3s)"
- * (省略記号無) / "(2m · thinking)"(分のみ秒無) / 深いインデント が全て NOMATCH と実証)。そこで:
- *   - 省略記号 (…/...) **または** 括弧タイマーのどちらか一方で可 (両方必須をやめる)
- *   - タイマーは「分のみ」「秒のみ」「分秒」いずれも可 (秒必須をやめる)
- *   - 行頭インデント制限 (\s{0,4}) を撤廃 (背の高いペイン/折返しで字下げが深い版に備える)
- * 緩めても安全な理由: 検出は必ず capture 末尾 12 行への限定 (workingSpinnerLine) と
- * _belowIsOnlyChrome (下が入力欄チロムのみ) を通すため、本文プローズ・表セル・箇条書きへの
- * 誤点灯は下チロム判定が弾く。行頭は英数字・空白・本文記号 (-*>#|) を除く 1 文字に限定し、
- * 語は ASCII 英字に限る (日本語プローズは非マッチ)。
- * 完了サマリー "✻ Brewed for 2m 52s" は省略記号も**括弧**タイマーも持たない (タイマーが括弧外) ため
- * 引き続き一致しない。
- */
-const SPINNER_LINE_RE =
-  /^\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/字下げ継続/権限バナー)
- * のみかを判定する。ライブのスピナーはペイン最下部の入力欄直上に描かれ、下には本文行が
- * 来ない。一方、本文中に書かれた「スピナー行の引用」(解説テキスト・表セル・コードブロック等)
- * は下に列 0 の本文行が続く。これを使って「未生成なのにローダーが点灯する」誤検出を防ぐ。
- * 列 0 の本文行が下に在れば引用とみなし false。
- */
-function _belowIsOnlyChrome(lines, i) {
-  for (let j = i + 1; j < lines.length; j++) {
-    const ln = lines[j]
-    if (ln.trim() === "") continue // 空行
-    // 入力欄の罫線。純粋なダッシュ列 (────) に加え、ラベル付き罫線 (────── ultracode ─ /
-    // ──── plan mode ─ 等、effort/モード表示が入る入力欄上端) も chrome 扱いにする。末尾 $ を
-    // 外し「行頭が 3+ ボックス罫線文字」で判定する。実機 (2026-06-19): ultracode 表示で入力欄上端が
-    // "────── ultracode ─" になり純ダッシュ判定を外れ、これを本文行と誤認 → ライブスピナーを
-    // 「本文の引用」と誤判定 → 生成中なのに status=waiting に落ちる事象を確認 (三点リーダー消失の実主因)。
-    if (/^\s*─{3,}/.test(ln)) continue
-    if (/^\s*[❯>]/.test(ln)) continue // 入力プロンプト
-    if (/^\s*⎿/.test(ln)) continue // tips / ツリー装飾行
-    if (/^\s{4,}\S/.test(ln)) continue // tips 折り返し等の字下げ継続
-    if (
-      /shift\+tab|← for|for shortcuts|accept edits|plan mode|auto mode|bypass permissions|new task\?|to save|auto-compact|context left/i.test(
-        ln,
-      )
-    )
-      continue // 権限バナー / フッターのヒント
-    return false // 列 0 の本文行 = スピナー行の引用とみなす
-  }
-  return true
-}
-
-/**
- * 作業スピナーのフッター行を検出する (生成中=processing の補助シグナル)。
- *
- * 現行版は "esc to interrupt" をフッターに出さない (主シグナルが実機で死んでいる) ため、
- * これが生成中検出の実効シグナルになる。フッター領域 (末尾 12 行) を下から走査し、次の
- * いずれかに一致しかつ「下が入力欄チロムのみ (本文行の引用でない)」行があれば生成中とみなす:
- *  (a) スピナー構造行 (SPINNER_LINE_RE)。tokens の有無に依存しないので thinking も拾う。
- *  (b) "tokens" 語 + 経過秒の同一行同居 (回帰防止。"(↑ 3.4k tokens · 7s)" の語順も拾う)。
- *
- * 下チロム判定 (_belowIsOnlyChrome) が肝: スピナー行の構造は、本文に「生成中フッターは
- * … (Ns) です」と書いた引用や表セルにも現れ得る。それらは下に本文行が続くため除外し、
- * ペイン最下部の入力欄直上にあるライブのスピナーだけを生成中と判定する (誤点灯防止)。
- */
-function detectWorkingSpinner(text) {
-  return workingSpinnerLine(text) !== null
-}
-
-/**
- * 作業スピナー行そのもの (経過タイマー込み) を返す。検出ロジックは detectWorkingSpinner と
- * 同一だが、frozen 判定 (下記) でライブタイマーの変化を見るために行文字列を取り出す。
- * 見つからなければ null。
- */
-function workingSpinnerLine(text) {
-  const lines = text.split("\n")
-  const start = Math.max(0, lines.length - 12)
-  for (let i = lines.length - 1; i >= start; i--) {
-    const line = lines[i]
-    const isSpinner = SPINNER_LINE_RE.test(line)
-    const isTokenFooter =
-      /\btokens\b/i.test(line) && /(?:^|[\s(])\d+\s*s\b/.test(line)
-    if ((isSpinner || isTokenFooter) && _belowIsOnlyChrome(lines, i)) {
-      return line.trim()
-    }
-  }
-  return null
-}
-
-/**
- * 「スピナーは画面に在るが、アニメ (経過タイマー) が止まっている = 凍結」を検出する。
- *
- * claude が異常終了 / ハングするとスピナー行が経過タイマー付きで画面に残るが、タイマーは
- * 進まない。capture-pane の単フレーム判定 (detectWorkingSpinner) はこれを「生成中」と誤読し、
- * 三点リーダーが永久に消えない (ユーザー報告の主症状の一つ)。プロセス内省は claude 自体が
- * 死んでいると ready を出せない (子プロセスも無いが arm もされない) ため、この frozen 判定が
- * 画面側の最後の保険になる。
- *
- * ライブのスピナーはタイマーが毎秒進むため、state loop の各 tick (5s 間隔・capture は都度
- * 新規) では必ず行文字列が変化する。よって「同一スピナー行が SPINNER_FREEZE_CONFIRM_MS 以上
- * 不変」なら凍結とみなす。閾値は capture キャッシュ TTL (2.5s) と state loop 周期 (5s) を跨ぐ
- * 6s に取り、ライブタイマーの 1 サンプル取りこぼしでは誤判定しないようにする。
- */
-// 静的な完了行 (● Updated…/⏺ Ran tool (2s) 等、ターン終了後もアイドル画面に残る) を
-// SPINNER_LINE_RE が誤検出して processing に張り付く「無生成時の三点リーダー誤点灯」(問題1) の
-// 滞留時間を短縮するため 6000→3500 に下げた (2026-06-22)。実スピナーは経過秒 (Ns) かグリフ
-// アニメで毎秒変化するため frozen には絶対ならず、閾値短縮で偽陰性(生成中の消失)は再発しない
-// (3500ms ≫ 1s アニメ周期で十分な余裕)。env で上書き可。
-const SPINNER_FREEZE_CONFIRM_MS = Number(
-  process.env.HUB_AGENT_SPINNER_FREEZE_MS ?? 3500,
-)
-/** @type {Map<string, {line: string, at: number}>} session名 → 最初にその行を見た時刻 */
-const _spinnerFreezeByName = new Map()
-
-export function isSpinnerFrozen(sessionName, text, now = Date.now()) {
-  const line = workingSpinnerLine(text)
-  if (!line) {
-    _spinnerFreezeByName.delete(sessionName)
-    return false
-  }
-  const prev = _spinnerFreezeByName.get(sessionName)
-  if (!prev || prev.line !== line) {
-    _spinnerFreezeByName.set(sessionName, { line, at: now })
-    return false
-  }
-  return now - prev.at >= SPINNER_FREEZE_CONFIRM_MS
-}
-
-/** テスト用: 凍結判定の状態を空にする。 */
-export function _resetSpinnerFreeze() {
-  _spinnerFreezeByName.clear()
-}
-
-export function detectStatusFromText(text) {
-  // 主シグナル: 中断フッター (従来どおり全体一致。回帰防止のため範囲を狭めない)。
-  if (/esc to interrupt/i.test(text)) return "processing"
-  // 補助シグナル: 作業スピナーの「経過秒 + トークンカウンタ」(フッター領域・同一行限定)。
-  if (detectWorkingSpinner(text)) return "processing"
-  if (/❯\s/.test(text) || /^>\s/m.test(text)) return "waiting"
-  return "idle"
-}
-
-export function detectContextPctFromText(text) {
-  for (const re of CONTEXT_PATTERNS) {
-    const m = text.match(re)
-    if (m) {
-      const n = Number(m[1])
-      if (Number.isFinite(n) && n >= 0 && n <= 100) return n
-    }
-  }
-  // Claude の初回 Chrome 連携確認は、TUI セッションがまだ会話を開始していないことを
-  // 明示する画面。context 行は未描画だが使用量は実際に 0% なので、同一 cwd に残った
-  // 過去 jsonl の高使用率を採用せず 0% を返す。文言の一部だけで誤認しないよう、製品名と
-  // 選択肢を対にして判定する。
-  if (
-    /Claude in Chrome extension detected/i.test(text) &&
-    /Yes,? use my browser/i.test(text)
-  ) {
-    return 0
-  }
-  return null
-}
-
-export async function listSessionNames(opts = {}) {
-  const tmuxBin = opts.tmuxBin || "tmux"
-  try {
-    const { stdout } = await execFileP(tmuxBin, ["list-sessions", "-F", "#S"])
-    return stdout
-      .split("\n")
-      .map((s) => s.trim())
-      .filter(Boolean)
-  } catch {
-    return []
-  }
-}
-
-export async function capturePane(sessionName, opts = {}) {
-  const tmuxBin = opts.tmuxBin || "tmux"
-  // P1: 短期キャッシュ。state loop と近接時刻の list_sessions の二重 capture-pane を
-  // 同一結果で共有する。opts.noCache か TTL=0 でバイパス可能。
-  if (!opts.noCache && CAPTURE_TTL_MS > 0) {
-    const hit = _captureCache.get(sessionName)
-    if (hit && Date.now() - hit.at < CAPTURE_TTL_MS) return hit.value
-  }
-  try {
-    const { stdout } = await execFileP(tmuxBin, [
-      "capture-pane",
-      "-p",
-      "-t",
-      sessionName,
-      // 末尾 50 行を取得 (旧 30 行)。copy-mode スクロールや背の高いペインで作業/中断
-      // フッターが取得窓外に出て生成中を取りこぼす偽陰性を減らす。status 判定の作業
-      // スピナー検出はこのうち末尾 12 行 (workingSpinnerLine) に限定する。
-      "-S",
-      "-50",
-      "-E",
-      "-",
-    ])
-    const value = stripAnsi(stdout)
-    if (!opts.noCache && CAPTURE_TTL_MS > 0) {
-      _captureCache.set(sessionName, { at: Date.now(), value })
-    }
-    return value
-  } catch {
-    return ""
-  }
-}
-
-/**
- * tmux session の active pane の current_path を取得する (chat 信号との cwd 照合用)。
- * 取れなければ null。
- */
-export async function getSessionCwd(sessionName, opts = {}) {
-  const tmuxBin = opts.tmuxBin || "tmux"
-  // P1: cwd は変化が稀なので長期キャッシュ。state loop の毎 tick spawn を排除する。
-  // opts.noCache か TTL=0 でバイパス可能。cwd 変化検知は CWD_TTL_MS 経過後の再取得で吸収。
-  if (!opts.noCache && CWD_TTL_MS > 0) {
-    const hit = _cwdCache.get(sessionName)
-    if (hit && Date.now() - hit.at < CWD_TTL_MS) return hit.value
-  }
-  try {
-    const { stdout } = await execFileP(tmuxBin, [
-      "display-message",
-      "-p",
-      "-t",
-      `${sessionName}:`,
-      "-F",
-      "#{pane_current_path}",
-    ])
-    const s = stdout.trim()
-    const value = s || null
-    if (!opts.noCache && CWD_TTL_MS > 0) {
-      _cwdCache.set(sessionName, { at: Date.now(), value })
-    }
-    return value
-  } catch {
-    return null
-  }
-}
-
-/**
- * 1 session の現在状態を取得する。plugin hook で上書き可。
- *
- * @returns {Promise<{status: string, context_pct: number | null}>}
- */
-/** ペイン内容が一定時間不変なら「確実に停止 (idle/waiting)」とみなす確定窓。frontend は
- *  この stable=true を受けると 2 サンプル消灯確認 (paneOffConfirmed) を省いて即消灯できる。
- *  ローダー無しでも本文がストリーミング中 (= 出力領域が変化) なら stable にならないので、
- *  「文字出力中はローダーが出ない」ケースでも誤って停止扱いしない。 */
-const STABLE_CONFIRM_MS = Number(process.env.HUB_AGENT_STABLE_CONFIRM_MS ?? 3000)
-const _stabilityByName = new Map() // session_name → { sig, since }
-
-/** ペインの出力領域 (入力欄・揮発フッターを除いた上側) の軽量シグネチャ (FNV-1a 32bit)。
- *  末尾 8 行 (入力欄 + スピナー経過秒/ヒント等) を除くので、idle 中は連続 capture が一致する。 */
-export function _outputSignature(text) {
-  const lines = text.split("\n")
-  const body = lines.slice(0, Math.max(0, lines.length - 8)).join("\n")
-  let h = 0x811c9dc5
-  for (let i = 0; i < body.length; i++) {
-    h ^= body.charCodeAt(i)
-    h = (h + ((h << 1) + (h << 4) + (h << 7) + (h << 8) + (h << 24))) >>> 0
-  }
-  return `${body.length}:${(h >>> 0).toString(16)}`
-}
-
-/** 内容安定による「確実に停止」判定。processing (ローダー在中) は常に false で、
- *  停止後に出力領域が STABLE_CONFIRM_MS 不変であれば true。
- *
- *  多重防御 (2026-06-15): status の読み違いがあっても、ライブスピナー (経過タイマー) が
- *  ペインに在る間は「確実に停止」を絶対に返さない。frontend は stable=true を受けると
- *  2 サンプル消灯確認 (paneOffConfirmed) をバイパスして即消灯するため、将来 claude が
- *  未知のフッター形式を出して status を取りこぼしても、タイマーが画面に出ている限り
- *  即消灯の暴発を防ぐ保険にする (生成中ローダー消失の再発防止)。 */
-function _computeStable(sessionName, status, text) {
-  const now = Date.now()
-  if (status === "processing" || detectWorkingSpinner(text)) {
-    _stabilityByName.set(sessionName, { sig: _outputSignature(text), since: now })
-    return false
-  }
-  const sig = _outputSignature(text)
-  const prev = _stabilityByName.get(sessionName)
-  if (!prev || prev.sig !== sig) {
-    _stabilityByName.set(sessionName, { sig, since: now })
-    return false
-  }
-  return now - prev.since >= STABLE_CONFIRM_MS
-}
-
-/**
- * pane に CLI を起動していないときの退化後の定値。
- *
- * pane が素のシェルなら capture-pane を読んでも:
- *   status        … スピナーも "esc to interrupt" も ❯ プロンプトも出ないので常に 'idle'
- *   context_pct   … "X% context left" は TUI のフッターにしか出ないので常に null
- *   stable        … 画面が動かないので常に true
- *   spinner_present … 常に false
- *   output_sig    … 不変なので出力フロー検知の情報量がゼロ
- * にしかならない。読む価値がゼロの subprocess を全セッション × 5s 周期で fork し続ける
- * ことになるため、この場合は capture 自体を行わずこの定値を返す。
- *
- * ⚠️ output_sig は「読んでいない」を表す null。空文字の署名 (`_outputSignature("")`) を
- * 返すと main.mjs の出力フロー検知が「不変な署名を観測し続けている」と誤読するため、
- * 型で区別できる null を返して当該経路をスキップさせる。
- */
-const PANE_UNREAD_STATE = Object.freeze({
-  status: "idle",
-  context_pct: null,
-  permission_mode: null,
-  stable: true,
-  spinner_present: false,
-  output_sig: null,
-})
-
-export async function detectSessionState(sessionName, opts = {}) {
-  // ペインに CLI の TUI を起動していない構成 (既定) では、capture-pane は素のシェルの
-  // 画面を読むだけで何も供給しない。subprocess を焚く前にここで打ち切る。
-  // `HUB_AGENT_TMUX_LAUNCH_CLI=1` の逃げ道 (pane に TUI を起動する) では従来どおり読む。
-  if (!shouldLaunchPaneCli()) return { ...PANE_UNREAD_STATE }
-  const text = await capturePane(sessionName, opts)
-  let defaultStatus = detectStatusFromText(text)
-  // 凍結スピナー対策: スピナーが画面に在るが経過タイマーが進んでいない (claude 異常終了/ハング)
-  // 場合、生成中ではないので processing を取り下げる。"esc to interrupt" がある間は別のライブ
-  // シグナルなので対象外。frozen と判定したらスピナーを無視した素の判定 (❯→waiting / else idle)。
-  if (
-    defaultStatus === "processing" &&
-    !/esc to interrupt/i.test(text) &&
-    isSpinnerFrozen(sessionName, text)
-  ) {
-    defaultStatus =
-      /❯\s/.test(text) || /^>\s/m.test(text) ? "waiting" : "idle"
-  }
-  const defaultContextPct = detectContextPctFromText(text)
-  // permission_mode はペインのフッターバナーから読んでいたが、消費者がゼロ (frontend の
-  // SessionStateRow に該当フィールドが無い) なので判定ごと撤去した。返り値のキーだけは
-  // plugin hook (transformStatusDetection) が差し替えられる契約として残す。
-  const defaultPermissionMode = null
-  // スピナー行 (ライブ or 凍結) が画面に在るか。frozen 降格で status が waiting に落ちても、
-  // スピナーが画面に残っている = ターンはクリーンに終わっていない (ハング候補)。StallTracker が
-  // 「クリーン idle (スピナー無し) でターンを閉じる」判定に使い、frozen スピナーのハングを拾う。
-  const spinnerPresent = workingSpinnerLine(text) !== null
-
-  if (opts.plugins && opts.plugins.length) {
-    const hookResult = await runHookChain(opts.plugins, "transformStatusDetection", {
-      logger: opts.logger,
-      sessionName,
-      paneText: text,
-      defaultStatus,
-    })
-    if (hookResult?.result) {
-      const status = debounceStatusDowngrade(
-        sessionName,
-        hookResult.result.status || defaultStatus,
-      )
-      return {
-        status,
-        context_pct: hookResult.result.context_pct ?? defaultContextPct,
-        permission_mode:
-          hookResult.result.permission_mode ?? defaultPermissionMode,
-        stable: _computeStable(sessionName, status, text),
-        spinner_present: spinnerPresent,
-        // 出力領域 (揮発フッター除外) の署名。state loop が tick 間で比較し、純テキスト
-        // 生成 (子プロセスを spawn しないため proc 内省が busy=false と見るケース) を
-        // 「出力フロー中=busy」として検出するのに使う。
-        output_sig: _outputSignature(text),
-      }
-    }
-  }
-
-  const status = debounceStatusDowngrade(sessionName, defaultStatus)
-  return {
-    status,
-    context_pct: defaultContextPct,
-    permission_mode: defaultPermissionMode,
-    stable: _computeStable(sessionName, status, text),
-    spinner_present: spinnerPresent,
-    output_sig: _outputSignature(text),
-  }
-}
-
-/** 全 session の現在状態を取得する。cwd も含める (chat 信号照合用)。 */
-export async function listSessionStates(opts = {}) {
-  const names = await listSessionNames(opts)
-  return Promise.all(
-    names.map(async (name) => {
-      const [state, cwd] = await Promise.all([
-        detectSessionState(name, opts),
-        getSessionCwd(name, opts),
-      ])
-      return { session_name: name, cwd, ...state }
-    }),
-  )
-}
-
-/**
- * arm 非依存・cap 非依存の「応答停止 (stall)」判定ステート。
- *
- * 背景: 旧実装の stalled は (a) proc 内省の armed (= バンドルフックの prompt_submit 由来) に全依存し、
- * フック未発火/旧世代hookセッションでは永久に false、(b) readiness loop の cap(≈140s)で disarm されると
- * stalled が消える (90〜140s だけ表示で以後恒久消失)、という二重の死角があった。本トラッカーは state loop が
- * 観測する signal だけで turn の開閉と無進捗を判定し、arm にも cap にも依存しない:
- *   - turnOpen: processing/procBusy を観測したら true。クリーン idle (非progressing かつ スピナー行が画面に
- *     無く stable) で false。armed (フックが効くセッション) は OR で常に開扱い (従来挙動の上位互換)。
- *   - 進捗 (processing or procBusy) があれば lastProgressAt を更新。turn が閉じている間も更新し、次ターンの
- *     クロックを毎 tick リセットする。
- *   - stalled = turnOpen かつ 無進捗が stallWarnMs 継続。frozen スピナー (画面に在るが status は frozen 降格で
- *     waiting) は spinnerPresent=true で turnOpen を維持するため、proc 子が無く出力も止まったハングを拾える。
- *     cap に依存しないため 140s 以後も消えない。
- */
-export class StallTracker {
-  constructor({ stallWarnMs = 90_000 } = {}) {
-    this.stallWarnMs = Math.max(1000, stallWarnMs)
-    /** @type {Map<string, {turnOpen: boolean, lastProgressAt: number|null}>} */
-    this.byName = new Map()
-  }
-
-  _get(name) {
-    let s = this.byName.get(name)
-    if (!s) {
-      s = { turnOpen: false, lastProgressAt: null }
-      this.byName.set(name, s)
-    }
-    return s
-  }
-
-  /**
-   * @param {string} name
-   * @param {{armed?: boolean, processing?: boolean, procBusy?: boolean,
-   *          spinnerPresent?: boolean, stable?: boolean, now: number}} sig
-   * @returns {{stalled: boolean, turnOpen: boolean}}
-   */
-  observe(name, { armed = false, processing = false, procBusy = false, spinnerPresent = false, stable = false, now }) {
-    const s = this._get(name)
-    const progressing = processing || procBusy
-    if (progressing) {
-      s.turnOpen = true
-    } else if (!spinnerPresent && stable) {
-      // クリーン idle: 生成中でなく proc 非busy、スピナーも画面に無く出力安定 = ターン正常終了。
-      // frozen スピナー (spinnerPresent=true) や stable 未確定の間は閉じない (ハング候補を維持)。
-      s.turnOpen = false
-    }
-    const turnOpen = armed || s.turnOpen
-    if (progressing || !turnOpen) {
-      // 進捗あり、または turn が閉じている間はクロックを前進させ続ける (次ターンのクロックを毎 tick 0 に保つ)。
-      s.lastProgressAt = now
-    } else if (s.lastProgressAt == null) {
-      s.lastProgressAt = now
-    }
-    const stalled = turnOpen && now - s.lastProgressAt >= this.stallWarnMs
-    return { stalled, turnOpen }
-  }
-
-  forget(name) {
-    this.byName.delete(name)
-  }
-}
-
-export { STATUSES }