@cocorograph/hub-agent 0.7.105 → 0.8.1

package/src/usage.mjs

@@ -126,8 +126,10 @@ async function readTail(fp, maxBytes = 64 * 1024) {
     const start = size > maxBytes ? size - maxBytes : 0
     const len = size - start
     const buf = Buffer.allocUnsafe(len)
-    await fh.read(buf, 0, len, start)
-    let text = buf.toString("utf-8")
+    // ⚠️ bytesRead で切る (allocUnsafe は未初期化。並行 truncate 等で len 未満しか読めなかった
+    // とき、残りのゴミ領域を文字列化しない。cross-review minor)。
+    const { bytesRead } = await fh.read(buf, 0, len, start)
+    let text = buf.toString("utf-8", 0, bytesRead)
     // 途中から読んだ場合、先頭の不完全な行を捨てる (最初の改行まで)。
     if (start > 0) {
       const nl = text.indexOf("\n")
@@ -145,6 +147,41 @@ async function readTail(fp, maxBytes = 64 * 1024) {
   }
 }
 
+/**
+ * ファイル先頭だけを読む (head)。readTail の対称。rollout の session_meta ヘッダー行
+ * (先頭行) + 先頭近傍の最初の user_message (preview) を取り出すのに使う。maxBytes まで
+ * 読み、末尾の不完全な行を捨てる (最後の改行以降を落とす)。size <= maxBytes なら全体。失敗時 null。
+ */
+async function readHead(fp, maxBytes = 32 * 1024) {
+  let fh
+  try {
+    fh = await fs.open(fp, "r")
+    const st = await fh.stat()
+    const size = st.size
+    if (size === 0) return ""
+    const len = size > maxBytes ? maxBytes : size
+    const buf = Buffer.allocUnsafe(len)
+    // ⚠️ bytesRead で切る (allocUnsafe は未初期化。並行 truncate 等で len 未満しか読めなかった
+    // とき、残りのゴミ領域を文字列化しない。cross-review minor)。
+    const { bytesRead } = await fh.read(buf, 0, len, 0)
+    let text = buf.toString("utf-8", 0, bytesRead)
+    // EOF まで読み切っていない (maxBytes で頭だけ / 途中 truncate) 場合、末尾の不完全な行を捨てる。
+    if (bytesRead < size) {
+      const nl = text.lastIndexOf("\n")
+      text = nl >= 0 ? text.slice(0, nl) : text
+    }
+    return text
+  } catch {
+    return null
+  } finally {
+    try {
+      await fh?.close()
+    } catch {
+      /* ignore */
+    }
+  }
+}
+
 /** P5(perf): latestJsonlContext の結果を {mtimeMs,size} キーでメモ化し再パースを避ける。 */
 const _jsonlCtxMemo = new Map() // fp → { mtimeMs, size, result }
 
@@ -1299,7 +1336,15 @@ export async function getSessionUsages() {
 // ---------------------------------------------------------------------------
 
 function codexSessionsDir() {
-  return configPath("HUB_CODEX_SESSIONS_DIR", os.homedir(), ".codex", "sessions")
+  // 優先順: 明示 override (HUB_CODEX_SESSIONS_DIR。テスト/特殊配置用) → active Codex プロファイルの
+  // CODEX_HOME (profile 切替で applyActiveCodexEnv が process.env.CODEX_HOME にセット) → 既定 ~/.codex。
+  // ⚠️ 非既定プロファイルの rollout は <CODEX_HOME>/sessions に書かれる。CODEX_HOME を無視すると
+  // 別アカウントの一覧/履歴を返す (2026-07-24 cross-review blocker)。app-server 経路が env 継承で
+  // プロファイル対応だったのと挙動を揃える。findCodexRolloutFile / codexRolloutPresence /
+  // latestTokenCountFromRollout も本関数経由なので同時にプロファイル対応化される。
+  if (process.env.HUB_CODEX_SESSIONS_DIR) return process.env.HUB_CODEX_SESSIONS_DIR
+  if (process.env.CODEX_HOME) return path.join(process.env.CODEX_HOME, "sessions")
+  return path.join(os.homedir(), ".codex", "sessions")
 }
 
 // rate_limits.primary/secondary が無いときの limit は「% 表示のみ」の意味で 100 固定
@@ -1449,6 +1494,142 @@ export async function codexRolloutPresence(threadId) {
   return sawUnknownError ? "unknown" : "absent"
 }
 
+// ---------------------------------------------------------------------------
+// Phase 3 (Read-plane スライス2a): Codex セッション一覧を rollout の disk 走査で作る。
+// 従来 CodexStreamBridge.listThreads は使い捨て app-server を spawn して thread/list を
+// 叩いていた (完了基準「Codex 一覧で app-server を起動しない」に反する上、Read-plane で
+// off-queue 化しても spawn コスト自体は残る)。rollout は既にローカルにあり、一覧に必要な
+// 4 フィールド (thread_id / cwd / preview / updated_at_ms) はすべて rollout から安価に取れる:
+//   - thread_id: session_meta.session_id (無ければファイル名末尾の UUID)
+//   - cwd:       session_meta.payload.cwd (先頭行)
+//   - preview:   先頭近傍の最初の event_msg/user_message.message (clean な生プロンプト)
+//   - updated_at_ms: ファイル mtime (Claude 側 listSessions の mtime と単位を揃える)
+// ---------------------------------------------------------------------------
+
+/** rollout ファイル名末尾の thread UUID を取り出す (session_meta 欠落時の fallback)。
+ *  例: rollout-2026-07-22T20-08-05-019f8982-e8de-7f80-b304-4ad4a29ba170.jsonl */
+function threadIdFromRolloutFilename(fp) {
+  const m = /-([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})\.jsonl$/i.exec(fp)
+  return m ? m[1] : ""
+}
+
+/** rollout の先頭 (head) から一覧用メタ (thread_id / cwd / preview) を取り出す。
+ *  header (session_meta) は先頭行、preview は先頭近傍の最初の user_message。null=読めない。 */
+async function parseCodexRolloutHead(fp) {
+  const text = await readHead(fp, 32 * 1024)
+  if (text == null) return null
+  let thread_id = threadIdFromRolloutFilename(fp)
+  let cwd = ""
+  let preview = ""
+  for (const line of text.split("\n")) {
+    if (!line) continue
+    let o
+    try {
+      o = JSON.parse(line)
+    } catch {
+      continue
+    }
+    if (o.type === "session_meta" && o.payload && typeof o.payload === "object") {
+      if (typeof o.payload.cwd === "string") cwd = o.payload.cwd
+      if (typeof o.payload.session_id === "string" && o.payload.session_id) {
+        thread_id = o.payload.session_id
+      }
+    } else if (
+      !preview &&
+      o.type === "event_msg" &&
+      o.payload &&
+      o.payload.type === "user_message" &&
+      typeof o.payload.message === "string"
+    ) {
+      preview = o.payload.message.slice(0, 80)
+    }
+    if (cwd && preview) break // 両方揃ったら以降は読まない (先頭近傍で足りる)。
+  }
+  if (!thread_id) return null
+  return { thread_id, cwd, preview }
+}
+
+/**
+ * cwd 配下の Codex thread 一覧を rollout の disk 走査だけで作る (app-server を spawn しない)。
+ * 直近 lookbackDays の日付シャードから rollout-*.jsonl を集め、mtime 降順に並べ、header を
+ * 読んで cwd 一致分を limit 件まで返す。返り値の shape は旧 listThreads と同一:
+ *   {thread_id, cwd, preview, updated_at_ms}[]
+ *
+ * ⚠️ rollout は「作成日」シャードに置かれ以後追記される。作成が lookbackDays より前で今日
+ * resume された長寿命スレッドは窓外で拾えない (findCodexRolloutFile の高速パスと同じ限界)。
+ * 一覧 (picker) 用途では直近が支配的なので許容。header 読み取り件数は maxScan で上限を掛け、
+ * 打ち切ったら logger.warn で可視化する (silent truncation を避ける)。
+ *
+ * @returns {Promise<Array<{thread_id:string, cwd:string, preview:string, updated_at_ms:number}>>}
+ */
+export async function listCodexThreadsFromDisk({
+  cwd,
+  limit,
+  lookbackDays = 180,
+  maxScan = 800,
+  now = Date.now(),
+  logger,
+  sessionsDir,
+} = {}) {
+  // cwd-scoped picker 用。cwd 未指定なら「全 workspace を返す」ではなく空を返す (cross-review
+  // major3: 空 cwd で全 workspace の rollout が混入するのを防ぐ。呼び出し側 frontend は常に cwd を
+  // 送る。全件走査が必要な用途は現状無い)。
+  if (!cwd) return []
+  // sessionsDir は self-describing read (Read-plane 案C ①) で呼び出し側が
+  // 「リクエストの profile_id から解決した読み取り先」を明示注入する経路。
+  // 未指定なら従来どおり env 由来の active (codexSessionsDir) にフォールバックする。
+  const base = sessionsDir || codexSessionsDir()
+  // 1. lookback 窓内の全 rollout を stat して {fp, mtimeMs} を集める。
+  //    ⚠️ updated_at_ms (= mtime) 降順の契約を守るには「どれが更新新しいか」を知る必要があり、
+  //    それには窓内の全 stat が要る (cross-review round2: 収集を作成日 shard 順で打ち切ると、
+  //    作成が古く更新が新しい長寿命 rollout を落として mtime 降順に反する)。stat は 1 syscall で
+  //    安価かつ lookbackDays で有界。高コストな header open+read の方を maxScan で上限化する。
+  const candidates = [] // {fp, mtimeMs}
+  for (let i = 0; i < lookbackDays; i++) {
+    const d = new Date(now - i * 24 * 60 * 60 * 1000)
+    const y = String(d.getFullYear())
+    const m = String(d.getMonth() + 1).padStart(2, "0")
+    const day = String(d.getDate()).padStart(2, "0")
+    const dir = path.join(base, y, m, day)
+    const files = await fs.readdir(dir).catch(() => null)
+    if (!files) continue
+    for (const f of files) {
+      if (!f.startsWith("rollout-") || !f.endsWith(".jsonl")) continue
+      const fp = path.join(dir, f)
+      const st = await fs.stat(fp).catch(() => null)
+      if (st) candidates.push({ fp, mtimeMs: st.mtimeMs })
+    }
+  }
+  // 2. 更新が新しい順 (mtime desc)。
+  candidates.sort((a, b) => b.mtimeMs - a.mtimeMs)
+  // 3. mtime 新しい順に header を読み、cwd 一致分を limit まで集める。header 読み (open+read) は
+  //    maxScan で上限化する。上限打ち切りは mtime 新しい側から読むので、直近のスレッドが優先的に残る。
+  const out = []
+  let opened = 0
+  for (const { fp, mtimeMs } of candidates) {
+    if (limit && out.length >= limit) break
+    if (opened >= maxScan) break
+    opened++
+    const meta = await parseCodexRolloutHead(fp)
+    if (!meta) continue
+    // header の cwd が一致するものだけ (cwd 未読/不一致は除外 = 無関係スレッドの混入防止)。
+    if (meta.cwd !== cwd) continue
+    out.push({
+      thread_id: meta.thread_id,
+      cwd: meta.cwd,
+      preview: meta.preview,
+      updated_at_ms: mtimeMs,
+    })
+  }
+  if (opened >= maxScan && (!limit || out.length < limit)) {
+    logger?.warn?.(
+      { opened, total: candidates.length, cwd, matched: out.length },
+      "listCodexThreadsFromDisk: maxScan で header 走査を打ち切り (mtime が更に古い側の一部が一覧に出ない可能性)",
+    )
+  }
+  return out
+}
+
 /** P5(perf): rollout ファイルの token_count 抽出結果を mtime+size でメモ化。 */
 const _codexTokenCountMemo = new Map() // fp → { mtimeMs, size, result }
 

package/src/extract-paragraph.mjs

@@ -1,149 +0,0 @@
-/**
- * claude TUI (Claude Code 2.1.x) のペイン出力から、
- * 「直近のアシスタント説明テキスト段落」を保守的に抽出する。
- *
- * 目的: PreToolUse フック発火時点で jsonl はまだ前ターン止まりのため、フックの
- * transcript ベース context_text 抽出は前ターンの古い説明を掴む「取り違え」を起こす。
- * 一方、claude TUI のペインには「いま回答中の assistant 本文」が既に描画されている
- * ため、tmux capture-pane の結果からこれを抜き出して permission.request に同梱する
- * のが回答前に説明文をユーザーへ届ける唯一の経路。
- *
- * 出力フォーマット観察 (2026-06-24 実機 claude 2.1.x):
- *   ⏺ <本文テキスト>            ← アシスタント説明 (これを抽出したい)
- *   ⏺ Bash(<cmd>)               ← ツール呼び出し (除外したい)
- *   ⏺ Read(...)                 ← ツール呼び出し
- *     ⎿  <結果>                 ← ツール結果
- *
- * 抽出戦略: ペイン末尾から後ろ向き走査で「⏺ で始まり、続く語がツール名形式
- * (CamelCase + `(`) でない最初の行」を探し、そこから下方向に連続する「説明文の段落」
- * を取る。少しでも自信が無いケースは null 返却して呼び出し側で「説明なし」へ縮退。
- *
- * 安全方針: 抽出失敗 = null (壊さない)。誤抽出より null の方が UX 上安全。
- */
-
-const ASSIST_PREFIX = "⏺"
-
-const _MAX_CHARS = 2000
-
-const _MIN_CHARS = 6
-
-const _TOOL_CALL_RE = /^[A-Z][A-Za-z0-9_]*\s*\(/
-
-const _BOX_LINE_RE = /^[─-▟]/
-
-// 状態 / スピナー行。Claude 2.1.x は「考え中」スピナーに ✻ ✳ ✽ ✶ ✵ 等の星形グリフを
-// 循環使用する (例: "✻ Sautéed for 2s" / "✳ Frolicking… (3s · ↓ 34 tokens)")。説明段落に
-// 紛れ込ませないよう除外グリフを広く取る (旧版は ✨✹●⚫◯ のみで ✻✳✽ を取りこぼしていた)。
-const _STATUS_LINE_RE = /^[✨✹✺✻✷✸✹✳✲✱✽✶✵✴✦✧⋆●⚫◯◉]\s/
-
-const _ELLIPSIS_TAIL_RE = /\n[ \t]*…\s*\+\d+\s+lines[^\n]*$/
-
-// stop hook サマリ行。Claude 2.1.x は "Ran N stop hooks (ctrl+o to expand)" を
-// アシスタント本文と同じ ⏺ プレフィックス付きで描画するため、ツール呼び出しと同様に
-// 「説明段落の始点」候補から除外する (誤って始点にすると hook エラー出力を巻き込む)。
-const _STOP_HOOK_SUMMARY_RE = /^Ran\s+\d+\s+stop\s+hooks?\b/i
-
-// ツール結果 / フック結果の継続行 (⎿)。説明段落の途中で現れたら打ち切る。
-const _TOOL_RESULT_RE = /^\s*⎿/
-
-// 入力欄に映るユーザープロンプトのエコー (❯ + 本文)。メニュー選択肢 (❯ 1. ...) と
-// 空の入力欄 (❯ のみ) は除外する。これがある = ターン境界の目印として使う。
-const _INPUT_ECHO_RE = /^❯\s+(?!\d+\.\s)\S/
-
-/**
- * @param {string|undefined|null} paneText capturePane の出力 (ANSI 除去済み)
- * @returns {string|null} 直近のアシスタント説明 (失敗時 null)
- */
-export function extractLastAssistantText(paneText) {
-  if (typeof paneText !== "string" || !paneText) return null
-  const lines = paneText.replace(/\r/g, "").split("\n")
-
-  let startIdx = -1
-  for (let i = lines.length - 1; i >= 0; i--) {
-    const line = lines[i]
-    if (!line.startsWith(ASSIST_PREFIX + " ")) continue
-    const rest = line.slice(ASSIST_PREFIX.length + 1).trimStart()
-    if (_TOOL_CALL_RE.test(rest)) continue
-    if (_STOP_HOOK_SUMMARY_RE.test(rest)) continue
-    startIdx = i
-    break
-  }
-  if (startIdx < 0) return null
-
-  // 前ターン取り違え防止: startIdx より下 (= より新しい) に現ターンのユーザープロンプト
-  // エコーがあるなら、その ⏺ は前ターンの説明である。現ターンはツールへ直行 (説明文なし) と
-  // 判断し null へ縮退する (古い説明を出すより「説明なし」が安全。capture-pane が処理中の
-  // ノイズだらけのペインを撮ったときに前ターン本文や hook 出力を掴むのを防ぐ)。
-  for (let j = startIdx + 1; j < lines.length; j++) {
-    if (_INPUT_ECHO_RE.test(lines[j])) return null
-  }
-
-  const parts = []
-  let consecBlank = 0
-  for (let i = startIdx; i < lines.length; i++) {
-    const line = lines[i]
-    if (i > startIdx) {
-      if (line.startsWith(ASSIST_PREFIX + " ")) break
-      if (_BOX_LINE_RE.test(line)) break
-      if (_STATUS_LINE_RE.test(line.trim())) break
-      if (_TOOL_RESULT_RE.test(line)) break
-      if (_INPUT_ECHO_RE.test(line)) break
-    }
-    if (!line.trim()) {
-      consecBlank++
-      if (consecBlank >= 2) break
-      parts.push(line)
-      continue
-    }
-    consecBlank = 0
-    parts.push(line)
-  }
-
-  let text = parts.join("\n").trimEnd()
-  if (text.startsWith(ASSIST_PREFIX)) {
-    text = text.slice(ASSIST_PREFIX.length).trimStart()
-  }
-  text = text.replace(_ELLIPSIS_TAIL_RE, "").trim()
-  if (text.length < _MIN_CHARS) return null
-
-  if (text.length > _MAX_CHARS) {
-    text = "…" + text.slice(-_MAX_CHARS)
-  }
-  return text
-}
-
-/**
- * permission/質問カードに出す「直前アシスタント説明」の採用優先順位を決める純関数。
- *
- * 症状4 根治: フック (bundle) 由来の context_text は PreToolUse 発火時点で jsonl が
- * 前ターン止まり (フックがブロック中は claude が現ターンを commit しない=デッドロック)
- * のため「前ターンの古い説明」を掴む取り違えを起こす。一方 hub-agent が tmux
- * capture-pane で抜く liveContext は「いま描画中の現ターン本文」なので回答前に
- * 信頼できる唯一のソース。よって **liveContext を最優先**し、フック由来は後方互換の
- * フォールバックとしてのみ採用する (旧 bundle が context_text を送ってきても汚染しない)。
- * 両方とも空/非文字列なら null (= 説明なしで安全縮退)。
- *
- * @param {unknown} hookContextText フック (bundle) が同梱した context_text (旧経路)
- * @param {unknown} liveContext capture-pane から抽出した現ターン説明
- * @returns {string|null}
- */
-export function pickContextText(hookContextText, liveContext) {
-  const live =
-    typeof liveContext === "string" && liveContext.trim() ? liveContext : null
-  const hook =
-    typeof hookContextText === "string" && hookContextText.trim()
-      ? hookContextText
-      : null
-  return live || hook || null
-}
-
-export const __test = {
-  _MAX_CHARS,
-  _MIN_CHARS,
-  _TOOL_CALL_RE,
-  _BOX_LINE_RE,
-  _STATUS_LINE_RE,
-  _STOP_HOOK_SUMMARY_RE,
-  _TOOL_RESULT_RE,
-  _INPUT_ECHO_RE,
-}

package/src/jsonl-live-watchers.mjs

@@ -1,283 +0,0 @@
-/**
- * jsonl ライブ追従 watcher の束ね役 (T04784 逐次表示)。
- *
- * Cockpit の TUI チャットは「対話 TUI (tmux/PTY) の claude が書く jsonl」を表示源にする。
- * 従来は session.event (ターン境界) を合図に jsonl 全体を再 hydrate して「どさっと」更新
- * していたが、ターン中の途中経過は 2.5s ポーリングで拾うしかなく、逐次性が弱かった。
- *
- * 本 manager は、ブラウザが送る `claude.tui.viewing {session_id, cwd}` ハートビート
- * (= まさにその session を TUI チャットで閲覧している瞬間) を起点に、対象 session の
- * jsonl を byte offset で tail し (claude-history-watch.mjs)、追記行を 1 行ずつ
- * `claude.jsonl.event` として WS push する。これでターン中の本文・ツール結果が逐次
- * ブラウザに届き、再 hydrate / ポーリングが不要になる。
- *
- * ライフサイクルは watcher ゲートの TuiViewerRegistry と相似形:
- * - note(): 閲覧ハートビートで watcher を起動 or TTL 延長。
- * - unwatch(): claude.tui.unviewing で即停止。
- * - _sweep(): TTL 失効した watcher を掃除 (unviewing 取りこぼし対策)。
- *
- * 課金枠への影響なし: jsonl の読み取りはローカル FS の追従であり、モデル呼び出しを
- * 伴わない (SDK query を起こさない)。TUI モード = サブスク枠のまま。
- *
- * fromEnd=true で監視開始時点の既存内容はスキップする。初回履歴は claude.history.request
- * で別途 hydrate 済みのため、tail は新規分だけでよい (二重 push は frontend が uuid で排除)。
- */
-
-import { readFile } from "node:fs/promises"
-
-import { watchSessionFile } from "./claude-history-watch.mjs"
-import { jsonlPath } from "./claude-history.mjs"
-import {
-  MASK_ENABLED,
-  collectToolUseNames,
-  createEventMasker,
-} from "./tool-result-mask.mjs"
-
-/** watcher 鮮度 (ms)。ブラウザのハートビート間隔 (5s) の 3 倍を既定とする。 */
-const WATCHER_TTL_MS = Number(process.env.COCKPIT_JSONL_WATCH_TTL_MS) || 15_000
-/** TTL 失効 watcher を掃除する周期 (ms)。 */
-const SWEEP_INTERVAL_MS = 30 * 1000
-
-/**
- * session_id ごとに 1 つの jsonl tail watcher を保持し、閲覧ハートビートで延命する。
- */
-export class JsonlLiveWatchers {
-  /**
-   * @param {object} args
-   * @param {(obj: object) => unknown} args.send - WS 送信 (client.send バインド済み)
-   * @param {() => Promise<string|undefined>|string|undefined} args.getProjectsRoot
-   *   - ~/.claude/projects の実効ルート解決 (アカウント切替を反映)
-   * @param {number} [args.ttlMs]
-   * @param {(info: {session_id: string, cwd: string, toolName: string, tool_use_id: string}) => void} [args.onToolResolved]
-   *   - jsonl に tool_result が着弾し「あるツールが解決された」と検知したときのコールバック
-   *     (症状1b 根治: ターミナルのネイティブメニューで回答 / 承認された pending カードを畳む)。
-   * @param {import('pino').Logger} [args.logger]
-   */
-  constructor({
-    send,
-    getProjectsRoot,
-    ttlMs = WATCHER_TTL_MS,
-    onToolResolved,
-    logger,
-  } = {}) {
-    this.send = send
-    this.getProjectsRoot = getProjectsRoot
-    this.ttlMs = ttlMs
-    this.onToolResolved = onToolResolved
-    this.logger = logger
-    /** @type {Map<string, {watcher: {stop: () => void}, cwd: string, expiresAt: number}>} */
-    this._entries = new Map()
-    this._sweepTimer = null
-    /** 同一 session に対する note() の競合を直列化する (二重 watcher 防止)。 */
-    this._starting = new Set()
-  }
-
-  /** 周期 sweep を張る。 */
-  start() {
-    this._sweepTimer = setInterval(() => this._sweep(), SWEEP_INTERVAL_MS)
-    // 他 timer 同様 unref して agent のアイドル終了を妨げない。
-    this._sweepTimer?.unref?.()
-  }
-
-  /**
-   * 閲覧ハートビートを受けて watcher を起動 or 延命する。
-   *
-   * @param {{session_id?: string|null, cwd?: string|null}} info
-   * @returns {Promise<void>}
-   */
-  async note({ session_id, cwd } = {}) {
-    if (!session_id || !cwd) return
-    const existing = this._entries.get(session_id)
-    if (existing) {
-      // 既に追従中: TTL を延長するだけ (cwd が変わるのは想定外なので無視)。
-      existing.expiresAt = Date.now() + this.ttlMs
-      return
-    }
-    // 起動中の重複呼び出しを弾く (ハートビートが連続して来ても watcher は 1 本)。
-    if (this._starting.has(session_id)) return
-    this._starting.add(session_id)
-    try {
-      const projectsRoot = await this._resolveProjectsRoot()
-      // 起動処理中に別経路で登録済みになっていないか再チェック。
-      if (this._entries.has(session_id)) return
-      const filePath = jsonlPath({ cwd, session_id, projectsRoot })
-      // マスク (2026-06-23): TUI ライブ閲覧で逐次 push する tool_result の秘匿情報 / 非公開
-      // スキルプロンプト本文を伏せる。この経路は SDK チャットブリッジ (_emit) とは別系統で、
-      // フックを通さず jsonl を直接 tail するため、ここで独自にマスクしないと素通しになる。
-      // tail は fromEnd=true で監視開始後の追記のみを拾うので、開始前に書かれた tool_use の
-      // id→name を既存 jsonl から事前シードし、スキル tool_result の判定取りこぼしを防ぐ。
-      // tool_use(id→name) の事前シード。マスカーとネイティブ回答検知が共用する
-      // (tail は fromEnd=true で開始後の追記のみ拾うため、開始前の tool_use 名を先に流し込む)。
-      const detect = typeof this.onToolResolved === "function"
-      const seed =
-        MASK_ENABLED || detect ? await this._seedToolNames(filePath) : new Map()
-      const masker = MASK_ENABLED ? createEventMasker(seed) : null
-      // 検知用は別 Map (マスカー内部 Map と相互に汚染しないようコピー)。
-      const detectNames = detect ? new Map(seed) : null
-      const watcher = watchSessionFile({
-        filePath,
-        fromEnd: true,
-        logger: this.logger,
-        onEvent: (event) => {
-          // ネイティブ回答検知 (症状1b 根治): browser を経由せずターミナルのネイティブメニューで
-          // 回答 / 承認されたケースを jsonl の tool_result 着弾で検知する。.decision は browser
-          // 回答でしか書かれずネイティブ回答には効かないため、jsonl tool_result が唯一の権威
-          // ソース (resume が読む実体と同じ)。マスク前の素 event を見る (構造のみ参照)。
-          if (detectNames) {
-            try {
-              this._detectResolved(event, detectNames, session_id, cwd)
-            } catch (err) {
-              this.logger?.debug?.(
-                { err: err?.message },
-                "jsonl tool_result detect failed",
-              )
-            }
-          }
-          try {
-            this.send?.({
-              type: "claude.jsonl.event",
-              session_id,
-              cwd,
-              event: masker ? masker(event) : event,
-            })
-          } catch (err) {
-            this.logger?.warn(
-              { err: err?.message },
-              "jsonl live watch send failed",
-            )
-          }
-        },
-      })
-      this._entries.set(session_id, {
-        watcher,
-        cwd,
-        expiresAt: Date.now() + this.ttlMs,
-      })
-    } catch (err) {
-      this.logger?.warn(
-        { err: err?.message, session_id },
-        "jsonl live watch start failed",
-      )
-    } finally {
-      this._starting.delete(session_id)
-    }
-  }
-
-  /**
-   * 閲覧終了を受けて watcher を即停止する。
-   *
-   * @param {{session_id?: string|null}} info
-   */
-  unwatch({ session_id } = {}) {
-    if (!session_id) return
-    const entry = this._entries.get(session_id)
-    if (!entry) return
-    this._entries.delete(session_id)
-    try {
-      entry.watcher.stop()
-    } catch {
-      /* ignore */
-    }
-  }
-
-  /**
-   * 既存 jsonl を 1 度だけ読み、tool_use_id→name を集めた Map を返す (マスカーのシード用)。
-   * 読めない / 未存在なら空 Map。watcher 起動の冷経路で 1 回だけ走るので全文読みでよい。
-   * @param {string} filePath
-   * @returns {Promise<Map<string,string>>}
-   */
-  async _seedToolNames(filePath) {
-    const seed = new Map()
-    try {
-      const text = await readFile(filePath, "utf-8")
-      for (const line of text.split("\n")) {
-        if (!line || !line.includes('"tool_use"')) continue
-        try {
-          collectToolUseNames(JSON.parse(line), seed)
-        } catch {
-          /* ignore broken line */
-        }
-      }
-    } catch {
-      /* ファイル未存在等: シードなしで続行 */
-    }
-    return seed
-  }
-
-  /**
-   * 1 イベントを走査し、(1) assistant の tool_use(id→name) を蓄積、(2) user の tool_result
-   * 着弾を検知して onToolResolved を発火する。tool_use と tool_result は別イベントで届くので、
-   * id→name を貯めながら tool_use_id 一致で「そのツールが解決された」と判定する
-   * (collectToolUseNames はマスカーと共用の純関数)。
-   *
-   * @param {object} event normalizeHistoryEvent 済みイベント (type + message を持つ)
-   * @param {Map<string,string>} toolNames tool_use_id→tool_name の蓄積 Map
-   * @param {string} session_id
-   * @param {string} cwd
-   */
-  _detectResolved(event, toolNames, session_id, cwd) {
-    // 新規 tool_use(id→name) を吸収する (assistant イベントのみ反応)。
-    collectToolUseNames(event, toolNames)
-    if (event?.type !== "user" || !Array.isArray(event.message?.content)) return
-    for (const b of event.message.content) {
-      if (b && b.type === "tool_result" && typeof b.tool_use_id === "string") {
-        const toolName = toolNames.get(b.tool_use_id)
-        if (toolName) {
-          this.onToolResolved?.({
-            session_id,
-            cwd,
-            toolName,
-            tool_use_id: b.tool_use_id,
-          })
-        }
-      }
-    }
-  }
-
-  async _resolveProjectsRoot() {
-    try {
-      const r = this.getProjectsRoot?.()
-      return r && typeof r.then === "function" ? await r : r
-    } catch {
-      return undefined
-    }
-  }
-
-  /** TTL を過ぎた watcher を停止・削除する (unviewing 取りこぼし対策)。 */
-  _sweep() {
-    const now = Date.now()
-    for (const [session_id, entry] of this._entries) {
-      if (entry.expiresAt <= now) {
-        this._entries.delete(session_id)
-        try {
-          entry.watcher.stop()
-        } catch {
-          /* ignore */
-        }
-      }
-    }
-  }
-
-  /** 全 watcher と sweep timer を停止する。 */
-  stop() {
-    if (this._sweepTimer) {
-      clearInterval(this._sweepTimer)
-      this._sweepTimer = null
-    }
-    for (const entry of this._entries.values()) {
-      try {
-        entry.watcher.stop()
-      } catch {
-        /* ignore */
-      }
-    }
-    this._entries.clear()
-  }
-
-  /** テスト用: 現在追従中の session_id 数。 */
-  get size() {
-    return this._entries.size
-  }
-}
-
-export default JsonlLiveWatchers