@cocorograph/hub-agent 0.8.18 → 0.8.20

package/src/claude-md.mjs

@@ -21,8 +21,7 @@ import os from "node:os"
 import path from "node:path"
 import {
   sha256,
-  writeMeta,
-  writeBaseBody,
+  writeSyncState,
   nowIso,
 } from "./claude-md-sync.mjs"
 
@@ -381,13 +380,18 @@ export async function ensureClaudeMd({
     const hubInitialized = !!hub?.claude_md_updated_at
     if (hubInitialized && hubBody) {
       await fs.writeFile(configMdPath, hubBody, "utf-8")
-      await writeMeta(targetDir, {
-        lastSyncedHubUpdatedAt: hub.claude_md_updated_at,
-        lastSyncedHash: hub.claude_md_hash || sha256(hubBody),
-        lastSyncedAt: nowIso(),
-      }, configFilename)
       // 初回 pull 直後は base = Hub 本文。以降の session-end 3-way merge の入力。
-      await writeBaseBody(targetDir, hubBody, configFilename)
+      // ⚠️ base → meta の順で書くこと（writeSyncState に集約）。meta は「判定の
+      // commit marker」なので先に進めると、base の書込が失敗しても「同期済み」と
+      // 見なされ、以降の sync が通常 noop に入って base が壊れたまま固定される。
+      await writeSyncState(targetDir, {
+        body: hubBody,
+        meta: {
+          lastSyncedHubUpdatedAt: hub.claude_md_updated_at,
+          lastSyncedHash: hub.claude_md_hash || sha256(hubBody),
+          lastSyncedAt: nowIso(),
+        },
+      }, configFilename)
       logger?.info?.(
         { dirName, configMdPath },
         "wrote project instruction file from Hub project claude_md (initial sync)",

package/src/main.mjs

@@ -62,9 +62,6 @@ import { listAgents } from "./agents.mjs"
 import { listSkills } from "./skills.mjs"
 import { readSidebarMessageSnapshot } from "./sidebar-message-snapshot.mjs"
 import {
-  capturePane,
-  detectPermissionModeFromText,
-  detectSessionState,
   invalidateSessionCache,
   listSessionStates,
   StallTracker,
@@ -111,6 +108,7 @@ import {
 } from "./tmux.mjs"
 import { SiblingInjectBridge } from "./sibling-inject.mjs"
 import { isSessionWarm } from "./live-sessions.mjs"
+import { applyPointerContexts, resolvePointerContexts } from "./pointer-context.mjs"
 import {
   boundSessionId,
   codexContextPercentFromTokenUsage,
@@ -236,6 +234,10 @@ export async function restartAllTmuxSessionsForProfileSwitch(ctx) {
     }
     try {
       await createTmuxSession(s.name, s.cwd, {
+        // cliKind はセッション名 (`<dir>__codex` か否か) だけで決まる。渡し忘れると
+        // createSession が既定の claude として扱い、codex セッションの再生成でも
+        // AGENTS.md ではなく CLAUDE.md を同期対象にしてしまう。
+        cliKind: cliKindForSessionName(s.name),
         claudeCmd: claudeCmdFromAgentConfig(ctx.config),
         logger: ctx.logger,
       })
@@ -2167,7 +2169,6 @@ export async function pushImmediateChatState({
         session_name: s.session_name,
         status: "waiting",
         context_pct: typeof contextPct === "number" ? contextPct : 0,
-        permission_mode: s.permission_mode ?? null,
         stable: true,
         proc_busy: false,
         child_busy: false,
@@ -2311,9 +2312,6 @@ export function startStateLoop({ client, plugins, logger, intervalMs, claudeBrid
         // (`<dir>` = claude / `<dir>__codex` = codex)。chat 信号の読み出し・turn_active の
         // 判定源・session.state に載せる cli_kind はすべてこの 1 値から導く (正本一本化)。
         const sessionCliKind = cliKindForSessionName(s.session_name)
-        // 対話 TUI のペインから読んだ権限モード (素のシェル / SDK チャットでは null)。
-        // tmux 上で直接 shift+tab した変更もここで拾い、全ブラウザへ追従させる。
-        const permissionMode = s.permission_mode ?? null
         // チャットモード補完: tmux ペインのスクレイプは TUI 前提で効かないため、
         // session の cwd に一致する新鮮なチャット信号があれば status/context% を
         // 上書きする (Hub ホスト型 Cockpit のステータスドット/各行ドーナツ用)。
@@ -2533,7 +2531,6 @@ export function startStateLoop({ client, plugins, logger, intervalMs, claudeBrid
           !prev ||
           prev.status !== status ||
           prev.context_pct !== contextPct ||
-          prev.permission_mode !== permissionMode ||
           prev.stable !== stable ||
           prev.proc_busy !== procBusy ||
           prev.child_busy !== childBusy ||
@@ -2545,7 +2542,6 @@ export function startStateLoop({ client, plugins, logger, intervalMs, claudeBrid
           lastByName.set(s.session_name, {
             status,
             context_pct: contextPct,
-            permission_mode: permissionMode,
             stable,
             proc_busy: procBusy,
             child_busy: childBusy,
@@ -2586,7 +2582,6 @@ export function startStateLoop({ client, plugins, logger, intervalMs, claudeBrid
             session_name: s.session_name,
             status,
             context_pct: contextPct,
-            permission_mode: permissionMode,
             stable,
             proc_busy: procBusy,
             // child_busy: outputActive を含まない真の子プロセス busy。frontend の shouldQueue が
@@ -5073,10 +5068,32 @@ async function dispatch(msg, ctx) {
             }
             return { sessions: enriched, worktree_stubs: worktreeStubs }
           })
+          // 行ごとの「次に開く会話」の context% (任意)。宛先 (context_targets) は要求ごとに
+          // 違うため、共有される snapshot キャッシュの**外**で解決し、触る行だけ複製して
+          // 載せる (他クライアントの応答を汚さない)。context_targets が無ければ従来どおりの
+          // 応答 (後方互換)。
+          let sessions = snapshot.sessions
+          if (Array.isArray(msg.context_targets) && msg.context_targets.length > 0) {
+            try {
+              const pointerByName = await resolvePointerContexts(
+                msg.context_targets,
+                sessions,
+                { logger: ctx.logger },
+              )
+              sessions = applyPointerContexts(sessions, pointerByName)
+            } catch (err) {
+              // pointer context はあくまで付加情報。失敗してもセッション一覧は返す。
+              ctx.logger?.warn?.(
+                { err: err?.message },
+                "resolvePointerContexts failed",
+              )
+            }
+          }
           ctx.client.send({
             type: "tmux.sessions",
             request_id: msg.request_id,
             ...snapshot,
+            sessions,
           })
         } catch (err) {
           ctx.client.send({

package/src/pane-cli-flag.mjs

@@ -0,0 +1,30 @@
+/**
+ * 「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/pointer-context.mjs

@@ -0,0 +1,196 @@
+/**
+ * 「その行が次に開く会話」の context% (= pointer context) を解決する。
+ *
+ * ## 背景 (WHY)
+ * Cockpit のサイドバーは、コンテキスト使用率を **その行が次に開く会話に帰属させて**表示する
+ * ように直した (Hub 側 PR #4534)。しかし供給側 (agent) は「いま動いている会話」の値しか
+ * 出しておらず、一度も開いていない行・閉じた行では使用率が出ない。
+ *
+ * 従来は「その cwd で mtime が一番新しい jsonl」に落として埋めていたが、それが
+ * **サブエージェント / headless `claude -p` / 過去セッションの数字が混ざる**原因だったので
+ * 撤去した (cross-activity contamination)。よってここでは **frontend が行ごとに指定した
+ * 会話 ID (`session_id`) でしか値を引かない**。ID が無い行は推測せず null を返す。
+ *
+ * ## 不変条件 (ここを崩すと汚染が戻る)
+ *   1. `session_id` が渡されていない行では `contextForCwd` を **呼ばない** (mtime 最新への
+ *      フォールバックが走るため)。
+ *   2. `session_id` が渡された行でも、戻り値の `uuid` が要求 ID と**一致するときだけ**採用する。
+ *      `jsonlContextForCwd` は「その ID の jsonl が存在しない」とき mtime 最新へフォールバック
+ *      する仕様のため、件数ではなく**実体 (uuid) の同一性**で確認する。
+ *   3. 鮮度 (mtime) による足切りをしない。止まっている会話の使用率は古くならない
+ *      (次に開けばその値から再開する) ので、statusLine 経路の `SESSION_STALE_MS` は適用しない。
+ *
+ * ## N+1 対策
+ * サイドバーは 8 秒周期でポーリングし、複数タブが位相をずらして同時に叩く。行数分の jsonl
+ * 読み取りをそのまま毎回走らせないよう、`(cwd, session_id)` をキーにした短期 TTL +
+ * single-flight キャッシュを噛ませる (同時要求は 1 本の I/O に畳む)。
+ */
+
+import { cliKindForSessionName } from "./session-names.mjs"
+import { jsonlContextForCwd } from "./usage.mjs"
+
+/** pointer context のキャッシュ TTL (ms)。tmux スナップショットキャッシュと同じ 5 秒。 */
+const POINTER_CONTEXT_TTL_MS = Number(
+  process.env.HUB_AGENT_POINTER_CONTEXT_TTL_MS ?? 5_000,
+)
+
+/** キャッシュ保持数の上限 (会話 ID は増え続けるため LRU で頭打ちにする)。 */
+const POINTER_CONTEXT_MAX_ENTRIES = 512
+
+/**
+ * キー付きの短期 TTL + single-flight キャッシュ。
+ *
+ * `AsyncTtlCache` (単一値版) と役割は同じだが、こちらは `(cwd, session_id)` ごとに独立した
+ * エントリを持つ。build 失敗はキャッシュしない (次の要求で再試行できる)。
+ */
+export class KeyedAsyncTtlCache {
+  constructor({ ttlMs, now = () => Date.now(), maxEntries = POINTER_CONTEXT_MAX_ENTRIES } = {}) {
+    this.ttlMs = Math.max(0, Number(ttlMs) || 0)
+    this.now = now
+    this.maxEntries = Math.max(1, Number(maxEntries) || 1)
+    this.entries = new Map() // key → {value, expiresAt, inFlight}
+  }
+
+  async get(key, build) {
+    const hit = this.entries.get(key)
+    if (hit) {
+      if (hit.inFlight) return hit.inFlight // 同時要求は 1 本の I/O に畳む
+      if (this.now() < hit.expiresAt) return hit.value
+    }
+    const pending = Promise.resolve().then(build)
+    const entry = { value: undefined, expiresAt: 0, inFlight: pending }
+    // delete → set で挿入順 = 最近使った順にし、prune を LRU として使えるようにする。
+    this.entries.delete(key)
+    this.entries.set(key, entry)
+    try {
+      const value = await pending
+      entry.value = value
+      entry.expiresAt = this.now() + this.ttlMs
+      entry.inFlight = null
+      this.prune()
+      return value
+    } catch (err) {
+      if (this.entries.get(key) === entry) this.entries.delete(key)
+      throw err
+    }
+  }
+
+  /** 期限切れエントリを落とし、上限を超えていれば古い順に捨てる。 */
+  prune() {
+    const now = this.now()
+    for (const [key, e] of this.entries) {
+      if (!e.inFlight && now >= e.expiresAt) this.entries.delete(key)
+    }
+    while (this.entries.size > this.maxEntries) {
+      const oldest = this.entries.keys().next()
+      if (oldest.done) break
+      this.entries.delete(oldest.value)
+    }
+  }
+
+  clear() {
+    this.entries.clear()
+  }
+}
+
+/** 既定のプロセス共有キャッシュ (tmux.list_sessions ハンドラ用)。 */
+const defaultPointerContextCache = new KeyedAsyncTtlCache({ ttlMs: POINTER_CONTEXT_TTL_MS })
+
+/** テスト用: 既定キャッシュを空にする。 */
+export function _resetPointerContextCache() {
+  defaultPointerContextCache.clear()
+}
+
+/** cwd と会話 ID の連結。区切りは両者に現れ得ない制御文字 (エスケープ表記で書く)。 */
+function cacheKey(cwd, sessionId) {
+  return `${cwd}\u0000${sessionId}`
+}
+
+/**
+ * `context_targets` (行ごとの「次に開く会話」) を解決し、`session_name → context% | null` の
+ * Map を返す。
+ *
+ * 値が確定しなかった行にも **null を明示的に入れる** (「見に行った上で不明」を表す)。
+ * `context_targets` に含まれない行は Map に載らない = 応答にフィールドを付けない。
+ *
+ * @param {Array<{session_name?: string, session_id?: string|null}>|undefined} targets
+ * @param {Array<{name?: string, cwd?: string|null}>} rows tmux.list_sessions の行 (cwd 解決用)
+ * @param {{contextForCwd?: Function, cache?: KeyedAsyncTtlCache, logger?: object}} [opts]
+ * @returns {Promise<Map<string, number|null>>}
+ */
+export async function resolvePointerContexts(targets, rows, opts = {}) {
+  const {
+    contextForCwd = jsonlContextForCwd,
+    cache = defaultPointerContextCache,
+    logger,
+  } = opts
+  const out = new Map()
+  if (!Array.isArray(targets) || targets.length === 0) return out
+
+  const cwdByName = new Map()
+  for (const row of Array.isArray(rows) ? rows : []) {
+    if (row && typeof row.name === "string") cwdByName.set(row.name, row.cwd || null)
+  }
+
+  const jobs = []
+  for (const target of targets) {
+    const name = typeof target?.session_name === "string" ? target.session_name : ""
+    if (!name || out.has(name)) continue // 同名の重複指定は先勝ち
+    out.set(name, null)
+
+    const sessionId = typeof target?.session_id === "string" ? target.session_id.trim() : ""
+    // 不変条件 1: ID が無ければ読みに行かない (mtime 最新フォールバックを踏まない)。
+    if (!sessionId) continue
+    const cwd = cwdByName.get(name)
+    if (!cwd) continue
+    // codex 行は claude の jsonl を持たない。読んでも uuid 不一致で null になるだけなので、
+    // 無駄な readdir/stat を避けるためここで落とす (結果は同じ)。
+    if (cliKindForSessionName(name) !== "claude") continue
+    jobs.push({ name, cwd, sessionId })
+  }
+
+  await Promise.all(
+    jobs.map(async ({ name, cwd, sessionId }) => {
+      try {
+        const pct = await cache.get(cacheKey(cwd, sessionId), async () => {
+          const res = await contextForCwd(cwd, sessionId)
+          // 不変条件 2: 実体 (uuid) が一致したときだけ採用する。
+          if (!res || res.uuid !== sessionId) return null
+          return typeof res.percent === "number" ? res.percent : null
+        })
+        if (typeof pct === "number") out.set(name, pct)
+      } catch (err) {
+        logger?.warn?.(
+          { err: err?.message, session: name },
+          "pointer context resolve failed",
+        )
+      }
+    }),
+  )
+  return out
+}
+
+/**
+ * 解決済みの pointer context を session 行へ載せる (元配列・元オブジェクトは変更しない)。
+ *
+ * `tmux.list_sessions` の応答行は TTL スナップショットキャッシュで**複数の要求に共有される**
+ * ため、要求ごとに違う値を直接書き込むと他クライアントの応答を汚す。触る行だけ複製する。
+ *
+ * 既存の `context_pct` (いま動いている会話の値) とは**別フィールド**にする。混ぜると
+ * 「どちらの会話の値か」が曖昧になるため。
+ *
+ * @param {Array<object>} sessions
+ * @param {Map<string, number|null>} pointerByName
+ * @returns {Array<object>}
+ */
+export function applyPointerContexts(sessions, pointerByName) {
+  if (!Array.isArray(sessions)) return []
+  if (!(pointerByName instanceof Map) || pointerByName.size === 0) return sessions
+  return sessions.map((s) =>
+    s && pointerByName.has(s.name)
+      ? { ...s, pointer_context_pct: pointerByName.get(s.name) }
+      : s,
+  )
+}
+
+export default { KeyedAsyncTtlCache, resolvePointerContexts, applyPointerContexts }

package/src/state.mjs

@@ -8,6 +8,11 @@
  *   等のパターンを拾う (見つからなければ 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)
  */
@@ -15,6 +20,7 @@ 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)
 
@@ -282,29 +288,6 @@ export function detectStatusFromText(text) {
   return "idle"
 }
 
-/**
- * 【問題1 根治 2026-06-22】bind 時の即時ステータススナップショットで配る status を、
- * プロセス実体の busy を権威として解決する。capture (SPINNER_LINE_RE) の偽陽性に勝たせる。
- *
- * - busy=true (isArmed or pane_pid 子孫数 > baseline = ターン進行中): capture gap で
- *   capturedStatus が waiting に化けても processing を強制 (症状C=再マウントで生成中の三点
- *   リーダーが消える偽陰性の masking)。
- * - busy=false (プロセス実体 idle): capturedStatus が processing でも、それは静的完了行の
- *   SPINNER_LINE_RE 偽陽性であって生成中ではないので processing を配らない (= waiting へ降格)。
- *   bind は noCache 単発読みで freeze 履歴が無く偽陽性を弾けないため、ここで busy を権威にする。
- *   万一 no-hook セッションの無音生成中だった場合も、次の state loop tick(≤5s)が outputActive で
- *   processing に復帰させるので実害は限定的。
- *
- * @param {boolean} busy プロセス実体の busy (isArmed or 子孫数>baseline)
- * @param {string} capturedStatus detectSessionState の status
- * @returns {string}
- */
-export function resolveBindSnapshotStatus(busy, capturedStatus) {
-  if (busy) return "processing"
-  if (capturedStatus === "processing") return "waiting"
-  return capturedStatus
-}
-
 export function detectContextPctFromText(text) {
   for (const re of CONTEXT_PATTERNS) {
     const m = text.match(re)
@@ -326,177 +309,6 @@ export function detectContextPctFromText(text) {
   return null
 }
 
-// 対話 claude TUI のフッターに出る権限モードバナー (claude v2.1 系で実機確認)。
-// shift+tab で循環: default(バナー無し) → accept edits → plan → auto → …
-const PERMISSION_BANNERS = [
-  [/⏵⏵\s*accept edits on/i, "acceptEdits"],
-  [/⏸\s*plan mode on/i, "plan"],
-  [/⏵⏵\s*auto mode on/i, "auto"],
-  [/bypass permissions on/i, "bypassPermissions"],
-]
-
-/**
- * 対話 claude TUI のペインテキストから現在の権限モードを判定する。
- *
- * 全端末で「実際に動いているターミナルの権限状態」を同期するための正本。
- * jsonl の permissionMode は送信ターン毎にしか記録されないため、shift+tab した
- * だけ (未送信) の変更や tmux 上で直接切り替えた変更は jsonl に出ない。ペインの
- * フッターバナーは shift+tab 直後に即更新されるので、これを正本にする。
- *
- * - 明示バナー (accept edits / plan / auto / bypass) があればそのモード。
- * - バナーが無い場合、claude TUI のフッターが見えている時だけ "default" と判定する
- *   (素のシェルを default と誤検出しないためのガード)。
- * - claude TUI と判別できなければ null (= 不明、呼び出し側は据え置き)。
- *
- * @param {string} text capturePane の結果 (ANSI 除去済み)
- * @returns {string|null}
- */
-export function detectPermissionModeFromText(text) {
-  if (!text) return null
-  for (const [re, mode] of PERMISSION_BANNERS) {
-    if (re.test(text)) return mode
-  }
-  // バナー無し = default。ただし claude TUI のフッターが見えている時だけ assert する。
-  if (/← for agents|for shortcuts|shift\+tab to cycle/i.test(text)) {
-    return "default"
-  }
-  return null
-}
-
-/**
- * 対話 claude TUI のペインテキストから「入力欄内の本文」を取り出す。
- *
- * 中断キャンセル後の入力欄復旧 (claude.tui.recoverInput) の読込側。claude は
- * 「送信直後の Esc」で直前メッセージの本文を入力欄へ戻すため、これを実測して
- * クリアしないと、次の bracketed paste が後ろへ連結されてメッセージが合体する。
- *
- * 2 形式に対応する (claude v2.1.16x 実機確認 2026-06-08):
- * - **現行 (ルール区切り)**: `───…` / `❯ 本文` (折り返しは 2 スペース字下げで続行) /
- *   `───…` / フッター。入力プロンプト `❯` は列 0 から始まる (選択ダイアログのカーソル
- *   ` ❯ 1. …` は字下げされるため誤検出しない)。
- * - **旧 (罫線ボックス)**: `╭─…─╮ / │ > 本文 │ / ╰─…─╯`。末尾から最も近い枠の先頭行が
- *   プロンプト (`>` / `❯`) で始まる時だけ採用する。
- *
- * 空入力時のプレースホルダ等も文字列として返り得るので、呼び出し側は「期待する本文と
- * 一致するか」で判定すること (本関数は在中テキストの抽出のみを担う)。
- *
- * @param {string} text capturePane の結果 (ANSI 除去済み)
- * @returns {string|null} 入力欄内の本文 (入力欄が見つからない / 空なら null)
- */
-/**
- * 現行形式 (ルール区切り) の入力ボックス本文を「上下ボーダー間」から抽出する。
- *
- * 末尾から `❯` を逆走する旧方式は、ユーザー評価プロンプト ("How is Claude doing?") や
- * 選択ダイアログの選択肢行 (`❯ Very good` 等) の ❯ に誤マッチし得た。評価プロンプトは
- * 入力欄の「上」に出るため入力欄自体の上下ボーダーはズレない、という知見に基づき、
- * 下ボーダー (ペイン末尾近傍の ────) → 直上の上ボーダー → 間の ❯ プロンプト行、という
- * 範囲ベースで確定する。誤認防止ガード: 下ボーダーはペイン末尾から MAX_FOOTER_LINES 行
- * 以内、上下ボーダー間は 2〜MAX_BOX_LINES 行、間に列 0 の ❯ が在ること。
- * 見つからなければ null を返し、呼び出し側は旧アンカー方式へフォールバックする。
- *
- * @param {string} text capturePane の結果 (ANSI 除去済み)
- * @returns {string|null}
- */
-function _inputTextFromRuleBox(text) {
-  if (!text) return null
-  const lines = text.split("\n")
-  const isRule = (s) => /^\s*─{4,}\s*$/.test(s)
-  const MAX_FOOTER_LINES = 6 // 入力欄の下に出るヒント/ナビ行の想定上限
-  const MAX_BOX_LINES = 50 // 上下ボーダー間の許容行数 (折り返し長文入力の上限)
-  // 下ボーダー: ペイン末尾近傍 (下に出るヒント行のすぐ上) の ──── を末尾から探す。
-  let bottom = -1
-  for (let i = lines.length - 1; i >= 0; i--) {
-    if (lines.length - 1 - i > MAX_FOOTER_LINES) break
-    if (isRule(lines[i])) {
-      bottom = i
-      break
-    }
-  }
-  if (bottom < 0) return null
-  // 上ボーダー: 下ボーダーの直上にある ──── 。
-  let top = -1
-  for (let i = bottom - 1; i >= 0 && bottom - i <= MAX_BOX_LINES; i--) {
-    if (isRule(lines[i])) {
-      top = i
-      break
-    }
-  }
-  if (top < 0 || bottom - top < 2) return null
-  // ボーダー間に列 0 の ❯ プロンプト行が在ること (選択ダイアログの字下げ ❯ は対象外)。
-  const inner = lines.slice(top + 1, bottom)
-  const promptIdx = inner.findIndex((ln) => /^❯/.test(ln))
-  if (promptIdx < 0) return null
-  const parts = [inner[promptIdx].replace(/^❯\s?/, "").replace(/\s+$/, "")]
-  for (let i = promptIdx + 1; i < inner.length; i++) {
-    parts.push(inner[i].replace(/\s+$/, ""))
-  }
-  const joined = parts.join("\n").trim()
-  return joined || null
-}
-
-export function detectInputBoxText(text) {
-  // 第一候補: 上下ボーダー間抽出 (評価プロンプト/選択ダイアログの ❯ 誤マッチに強い)。
-  const ruled = _inputTextFromRuleBox(text)
-  if (ruled !== null) return ruled
-  // フォールバック: 旧 ❯ アンカー / 罫線ボックス方式 (ボーダー未描画版・レイアウト差用)。
-  return _inputTextFromPromptAnchor(text)
-}
-
-function _inputTextFromPromptAnchor(text) {
-  if (!text) return null
-  const lines = text.split("\n")
-
-  // ── 現行形式: 列 0 の `❯` プロンプト行 + 下側ルールまでの続行行 ──
-  let promptIdx = -1
-  for (let i = lines.length - 1; i >= 0; i--) {
-    if (/^❯/.test(lines[i])) {
-      promptIdx = i
-      break
-    }
-  }
-  if (promptIdx >= 0) {
-    const parts = [lines[promptIdx].replace(/^❯\s?/, "").replace(/\s+$/, "")]
-    for (let i = promptIdx + 1; i < lines.length; i++) {
-      const ln = lines[i]
-      if (/^\s*─{4,}\s*$/.test(ln)) break // 下側ルールで入力欄が終わる
-      parts.push(ln.replace(/\s+$/, ""))
-    }
-    const joined = parts.join("\n").trim()
-    return joined || null
-  }
-
-  // ── 旧形式: 罫線ボックス ──
-  let bottom = -1
-  for (let i = lines.length - 1; i >= 0; i--) {
-    if (/^\s*╰/.test(lines[i])) {
-      bottom = i
-      break
-    }
-  }
-  if (bottom < 0) return null
-  let top = -1
-  for (let i = bottom - 1; i >= 0; i--) {
-    if (/^\s*╭/.test(lines[i])) {
-      top = i
-      break
-    }
-  }
-  if (top < 0 || bottom - top < 2) return null
-  const inner = lines.slice(top + 1, bottom)
-  const first = inner[0].match(/^\s*│\s*[>❯]\s?(.*)$/)
-  if (!first) return null
-  // 右罫線と行末空白を落とす (折り返し行は左罫線 + 字下げで続く)。
-  const strip = (s) => s.replace(/\s*│\s*$/, "").replace(/\s+$/, "")
-  const parts = [strip(first[1])]
-  for (let i = 1; i < inner.length; i++) {
-    const m = inner[i].match(/^\s*│\s?(.*)$/)
-    if (!m) break
-    parts.push(strip(m[1]))
-  }
-  const joined = parts.join("\n").trim()
-  return joined || null
-}
-
 export async function listSessionNames(opts = {}) {
   const tmuxBin = opts.tmuxBin || "tmux"
   try {
@@ -622,7 +434,36 @@ function _computeStable(sessionName, status, text) {
   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 異常終了/ハング)
@@ -637,7 +478,10 @@ export async function detectSessionState(sessionName, opts = {}) {
       /❯\s/.test(text) || /^>\s/m.test(text) ? "waiting" : "idle"
   }
   const defaultContextPct = detectContextPctFromText(text)
-  const defaultPermissionMode = detectPermissionModeFromText(text)
+  // permission_mode はペインのフッターバナーから読んでいたが、消費者がゼロ (frontend の
+  // SessionStateRow に該当フィールドが無い) なので判定ごと撤去した。返り値のキーだけは
+  // plugin hook (transformStatusDetection) が差し替えられる契約として残す。
+  const defaultPermissionMode = null
   // スピナー行 (ライブ or 凍結) が画面に在るか。frozen 降格で status が waiting に落ちても、
   // スピナーが画面に残っている = ターンはクリーンに終わっていない (ハング候補)。StallTracker が
   // 「クリーン idle (スピナー無し) でターンを閉じる」判定に使い、frozen スピナーのハングを拾う。