@cocorograph/hub-agent 0.8.17 → 0.8.19

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/live-sessions.mjs

@@ -0,0 +1,61 @@
+/**
+ * 「そのセッションに依頼を送れるか (warm)」判定の **正本 (SoT)** (2026-08-01)。
+ *
+ * ## 背景 (WHY)
+ * セッション間の依頼 (`cockpit_orch.py send`) は sibling-inject が宛先を解決するが、その
+ * 対象は **claudeBridge / codexBridge の `describeLiveSessions()` に載るセッションだけ**で
+ * ある (載らない宛先は `sendToStream` / `sendToCwd` が `not_found` を返す)。一方 Cockpit の
+ * サイドバーは「tmux のセッション行が存在するか」しか見ていないため、**依頼を送れない
+ * セッションが「起動中」と表示される**食い違いがあった。
+ *
+ * そこで `tmux.list_sessions` 応答に `warm` を載せて表示と配送の判定を揃えるが、その際に
+ * **同じ判定を別実装で書き直すと再び食い違う** (グレー表示なのに宛先一覧に出ない、等)。
+ * 判定はこのモジュール 1 箇所に集約し、sibling-inject の候補列挙 (op:list / op:list-all /
+ * 失敗時の診断) と `warm` の算出が**必ず同じ関数**を通るようにする。
+ *
+ * ## 不変条件
+ *   - `isSessionWarm(bridges, row) === true`
+ *     ⇔ `describeLiveSessionsUnion(bridges, {cwd: row.cwd, cliKind: 行の cli_kind}).length > 0`
+ *     ⇔ sibling-inject の `op:"list"` が同じ cwd / kind で 1 本以上返す
+ *   - 行の cli_kind は `session-names.mjs` の命名規約 (`<dir>` = claude /
+ *     `<dir>__codex` = codex) からのみ導く。tmux / ブリッジの状態は参照しない。
+ */
+
+import { cliKindForSessionName } from "./session-names.mjs"
+
+/**
+ * claude / codex ブリッジの live セッションを union で返す (宛先解決の候補集合)。
+ *
+ * `cwd` を渡すとその cwd のみ、`cliKind` に 'claude' / 'codex' を渡すとその CLI のみへ
+ * 絞り込む。どちらも省略すると全 cwd・両 CLI (op:"list-all" 用)。`cliKind` が既知値以外
+ * なら絞り込まない (両方返す) — 呼び出し側で既に検証済みの前提。
+ *
+ * @param {{claudeBridge?: object, codexBridge?: object}} bridges
+ * @param {{cwd?: string, cliKind?: 'claude'|'codex'}} [filter]
+ * @returns {Array<object>} describeLiveSessions の記述子配列 (claude → codex の順)
+ */
+export function describeLiveSessionsUnion(bridges, { cwd, cliKind } = {}) {
+  const { claudeBridge, codexBridge } = bridges || {}
+  const out = []
+  if (cliKind !== "codex") out.push(...(claudeBridge?.describeLiveSessions?.(cwd) ?? []))
+  if (cliKind !== "claude") out.push(...(codexBridge?.describeLiveSessions?.(cwd) ?? []))
+  return out
+}
+
+/**
+ * tmux セッション行が「依頼を受け取れる (warm)」かを判定する。
+ *
+ * 判定は上記 union に一本化する。`cwd` が取れていない行 (tmux の cwd 解決失敗など) は
+ * 宛先解決のスコープを作れないため false (fail-closed。送れないものを送れると見せない)。
+ *
+ * @param {{claudeBridge?: object, codexBridge?: object}} bridges
+ * @param {{name?: string, cwd?: string|null}} row tmux.list_sessions の session 行
+ * @returns {boolean}
+ */
+export function isSessionWarm(bridges, { name, cwd } = {}) {
+  if (!cwd) return false
+  const cliKind = cliKindForSessionName(name)
+  return describeLiveSessionsUnion(bridges, { cwd, cliKind }).length > 0
+}
+
+export default { describeLiveSessionsUnion, isSessionWarm }

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,
@@ -110,6 +107,7 @@ import {
   stopTerminalMirror,
 } from "./tmux.mjs"
 import { SiblingInjectBridge } from "./sibling-inject.mjs"
+import { isSessionWarm } from "./live-sessions.mjs"
 import {
   boundSessionId,
   codexContextPercentFromTokenUsage,
@@ -199,14 +197,17 @@ function codexDefaultsFromAgentConfig(config) {
 /**
  * プロファイル切替用: 全 tmux セッションを kill → 同名・同 cwd で再作成する。
  *
- * 再作成された pane の claude は createSession 内の injectConfigDirEnv 経由で
- * 新しい CLAUDE_CONFIG_DIR を拾うため、TUI セッションもアカウント切替に追従する。
+ * 再作成された pane は **既定では素のシェル** (createSession が CLI を起動しない)。
+ * アカウント切替は SDK チャット側の process.env と、tmux サーバーのグローバル環境
+ * (syncTmuxProfileEnv の `set-environment -g`) で追従する。
+ * `HUB_AGENT_TMUX_LAUNCH_CLI=1` で TUI を起動する運用の場合のみ、createSession 内の
+ * injectConfigDirEnv が新しい CLAUDE_CONFIG_DIR をコマンドへ焼き込む。
  * initial prompt (leader の /orchestrate 等) までは復元しない — アカウントが
  * 変わる以上、前アカウントの文脈でスキルを自動発火させない方が安全。
  * cwd が取れないセッションは kill のみ行い、再作成はスキップして failed に積む。
  * tmux サーバー未起動なら何もしない。
  */
-async function restartAllTmuxSessionsForProfileSwitch(ctx) {
+export async function restartAllTmuxSessionsForProfileSwitch(ctx) {
   const result = { killed: [], recreated: [], failed: [] }
   let sessions = []
   try {
@@ -232,6 +233,10 @@ 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,
       })
@@ -410,9 +415,11 @@ export function applyActiveProfileEnv(profile, log) {
 
 /**
  * active プロファイルの CLAUDE_CONFIG_DIR を tmux サーバーのグローバル環境にも同期する。
- * tmux pane のシェルは hub-agent の process.env を見ないため、手動 respawn や
- * ユーザーが pane 内で直接 `claude` を打つケースの保険として set-environment -g を併用する
- * (新規セッションの主経路は createSession 内の injectConfigDirEnv コマンド焼き込み)。
+ * tmux pane のシェルは hub-agent の process.env を見ないため、set-environment -g で流し込む。
+ * pane は既定で素のシェル (CLI を自動起動しない) なので、ユーザーが pane 内で直接
+ * `claude` を打つケースにはこれが主経路になる
+ * (`HUB_AGENT_TMUX_LAUNCH_CLI=1` で CLI を pane 起動するときだけ、createSession 内の
+ *  injectConfigDirEnv によるコマンド焼き込みが併用される)。
  * tmux サーバー未起動でも失敗しない。
  */
 export async function syncTmuxProfileEnv(profile, log) {
@@ -2013,17 +2020,27 @@ const STALL_WARN_MS = Number(process.env.HUB_AGENT_STALL_WARN_MS ?? 90000)
  * 純関数として export することでテスト容易性を上げる(getSessionStateSnapshot を mock で
  * 注入し、snapshot 有/無/null/欠落フィールドの各ケースで挙動を検証可能)。
  *
+ * `warm` (2026-08-01): 「このセッションに依頼 (cockpit_orch.py send) を送れるか」。frontend は
+ * 従来「tmux のセッション行が存在するか」だけで起動中を判定していたため、**依頼を送れない
+ * セッションが起動中と表示される**食い違いがあった。判定は live-sessions.mjs の
+ * `isSessionWarm` (sibling-inject の宛先候補列挙と同一関数) に一本化する。accessor 未指定
+ * (=旧呼び出し) では `warm` を付与しない(推測で false を配らない)。
+ *
  * @param {Array} sessions tmux.list_sessions が返した素の session 行
  * @param {Map<string, object>} lastEventByName session_name → 最新 hook event
  * @param {((name: string) => object | null) | undefined} getSnap state loop の getSnapshot
  *        accessor。undefined のときは 4 信号を一切付与しない(snapshot 経路 OFF と等価)
+ * @param {((row: {name: string, cwd?: string|null}) => boolean) | undefined} isWarm
+ *        warm 判定 accessor (既定は live-sessions.mjs の isSessionWarm を bind したもの)。
+ *        undefined のときは `warm` を付与しない
  */
-export function enrichTmuxSessionsForListResponse(sessions, lastEventByName, getSnap) {
+export function enrichTmuxSessionsForListResponse(sessions, lastEventByName, getSnap, isWarm) {
   return sessions.map((s) => {
     const base = {
       ...s,
       last_event: lastEventByName.get(s.name) || null,
     }
+    if (isWarm) base.warm = !!isWarm(s)
     if (!getSnap) return base
     const snap = getSnap(s.name)
     if (!snap) return base
@@ -2151,7 +2168,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,
@@ -2295,9 +2311,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 のステータスドット/各行ドーナツ用)。
@@ -2517,7 +2530,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 ||
@@ -2529,7 +2541,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,
@@ -2570,7 +2581,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 が
@@ -3542,6 +3552,157 @@ export async function handleUsageRequest(msg, ctx, deps = {}) {
   }
 }
 
+/**
+ * `tmux.create_session` ハンドラ。指定名・cwd で detached の tmux セッションを作る。
+ *
+ * ⚠️ pane に CLI (claude / codex) を起動するかは **createSession 内の
+ * shouldLaunchPaneCli() が一元判定**する (既定は起動しない)。ここで渡す cliKind /
+ * claudeCmd / codexCmd / initialPrompt 等は、`HUB_AGENT_TMUX_LAUNCH_CLI=1` で
+ * CLI を起動するときにだけ使われる。呼び出し元ごとに既定を変えないため、
+ * このハンドラ側で起動可否を判断しないこと。
+ *
+ * dispatch から切り出して export しているのは、実際に tmux へ渡る引数を
+ * テストから検査できるようにするため (test/tmux-pane-cli-launch.test.mjs)。
+ */
+export async function handleTmuxCreateSession(msg, ctx) {
+  const name = (msg.session_name || "").trim()
+  const cwd = (msg.cwd || process.env.HOME || "/").trim()
+  if (!name) {
+    ctx.client.send({
+      type: "tmux.create_session.result",
+      request_id: msg.request_id,
+      ok: false,
+      error: "session_name is required",
+    })
+    return
+  }
+  try {
+    await createTmuxSession(name, cwd, {
+      // cli_kind: 'codex' なら codex を、それ以外は claude を pane 起動する (既定 claude)。
+      cliKind: msg.cli_kind === "codex" ? "codex" : "claude",
+      claudeCmd:
+        typeof msg.claude_cmd === "string"
+          ? msg.claude_cmd
+          : claudeCmdFromAgentConfig(ctx.config),
+      codexCmd: typeof msg.codex_cmd === "string" ? msg.codex_cmd : undefined,
+      // codex 用設定 (claude 経路では claudeCmd を直接使うため無視される)。
+      model:
+        typeof msg.model === "string"
+          ? msg.model
+          : codexDefaultsFromAgentConfig(ctx.config).model,
+      sandbox: typeof msg.sandbox === "string" ? msg.sandbox : undefined,
+      approvalPolicy:
+        typeof msg.approval_policy === "string" ? msg.approval_policy : undefined,
+      effort:
+        typeof msg.effort === "string"
+          ? msg.effort
+          : codexDefaultsFromAgentConfig(ctx.config).effort,
+      initialPrompt:
+        typeof msg.initial_prompt === "string" ? msg.initial_prompt : undefined,
+      logger: ctx.logger,
+    })
+    tmuxSessionsSnapshotCache.clear()
+    ctx.client.send({
+      type: "tmux.create_session.result",
+      request_id: msg.request_id,
+      ok: true,
+      session_name: name,
+    })
+  } catch (err) {
+    ctx.client.send({
+      type: "tmux.create_session.result",
+      request_id: msg.request_id,
+      ok: false,
+      error: err.message,
+    })
+  }
+}
+
+/**
+ * `worktree.create` ハンドラ。git worktree を作ってから、その dir で tmux セッションを作る。
+ * body: { request_id, dir, branch, cli_kind?, claude_cmd?, codex_cmd?, model?, sandbox?,
+ *         approval_policy?, effort?, initial_prompt? }
+ *
+ * ⚠️ pane の CLI 起動可否は handleTmuxCreateSession と同じく createSession 側の
+ * 一元判定に従う (既定は起動しない)。
+ */
+export async function handleWorktreeCreate(msg, ctx) {
+  const dir = (msg.dir || "").trim()
+  const branch = (msg.branch || "").trim()
+  if (!dir || !branch) {
+    ctx.client.send({
+      type: "worktree.create.result",
+      request_id: msg.request_id,
+      ok: false,
+      error: "dir and branch required",
+    })
+    return
+  }
+  if (!/^[A-Za-z0-9._\-/]+$/.test(branch) || branch.startsWith("-")) {
+    ctx.client.send({
+      type: "worktree.create.result",
+      request_id: msg.request_id,
+      ok: false,
+      error: "invalid branch name",
+    })
+    return
+  }
+  try {
+    const { wtName, wtPath, createdBranch } = await createWorktreeDir(dir, branch)
+    // worktree dir で tmux session を作成。tmux.create_session と同じく cli_kind を
+    // 解釈し、codex なら codex を pane 起動する（既定 claude）。
+    // T05945: セッション名は cli_kind に応じて `<wt>` / `<wt>__codex` へ分ける。これで
+    // 同一 worktree でも claude と codex を独立に起動/終了できる (旧実装は cli_kind に
+    // 関わらず `<wt>` 固定だったため、片方しか立てられなかった)。
+    const wtCliKind = msg.cli_kind === "codex" ? "codex" : "claude"
+    const wtSessionName = sessionNameFor(wtName, wtCliKind)
+    await createTmuxSession(wtSessionName, wtPath, {
+      cliKind: wtCliKind,
+      claudeCmd:
+        typeof msg.claude_cmd === "string"
+          ? msg.claude_cmd
+          : claudeCmdFromAgentConfig(ctx.config),
+      codexCmd: typeof msg.codex_cmd === "string" ? msg.codex_cmd : undefined,
+      // codex 用設定 (claude 経路では無視される)。
+      model:
+        typeof msg.model === "string"
+          ? msg.model
+          : codexDefaultsFromAgentConfig(ctx.config).model,
+      sandbox: typeof msg.sandbox === "string" ? msg.sandbox : undefined,
+      approvalPolicy:
+        typeof msg.approval_policy === "string" ? msg.approval_policy : undefined,
+      effort:
+        typeof msg.effort === "string"
+          ? msg.effort
+          : codexDefaultsFromAgentConfig(ctx.config).effort,
+      initialPrompt:
+        typeof msg.initial_prompt === "string" ? msg.initial_prompt : undefined,
+      logger: ctx.logger,
+    })
+    tmuxSessionsSnapshotCache.clear()
+    ctx.client.send({
+      type: "worktree.create.result",
+      request_id: msg.request_id,
+      ok: true,
+      // wt_name は従来どおり **ベース名** (dir 名)。frontend のツリー構築キーに使う。
+      wt_name: wtName,
+      // session_name は実際に作った tmux セッション名 (codex なら __codex 付き)。
+      // 旧 frontend はこのフィールドを見ないため後方互換 (wt_name で選択する)。
+      session_name: wtSessionName,
+      wt_path: wtPath,
+      branch,
+      created_branch: createdBranch,
+    })
+  } catch (err) {
+    ctx.client.send({
+      type: "worktree.create.result",
+      request_id: msg.request_id,
+      ok: false,
+      error: err.message,
+    })
+  }
+}
+
 async function dispatch(msg, ctx) {
   const t = msg?.type || ""
   try {
@@ -4889,6 +5050,13 @@ async function dispatch(msg, ctx) {
               sessions,
               lastEventByName,
               ctx.getSessionStateSnapshot,
+              // warm = このセッションへ依頼 (cockpit_orch.py send) を送れるか。sibling-inject の
+              // 宛先候補列挙と同一関数 (live-sessions.mjs) を通す。
+              (row) =>
+                isSessionWarm(
+                  { claudeBridge: ctx.claudeBridge, codexBridge: ctx.codexBridge },
+                  row,
+                ),
             )
             const liveNames = new Set(enriched.map((s) => s.name))
             let worktreeStubs = []
@@ -4939,135 +5107,11 @@ async function dispatch(msg, ctx) {
         return
       }
       case "tmux.create_session": {
-        const name = (msg.session_name || "").trim()
-        const cwd = (msg.cwd || process.env.HOME || "/").trim()
-        if (!name) {
-          ctx.client.send({
-            type: "tmux.create_session.result",
-            request_id: msg.request_id,
-            ok: false,
-            error: "session_name is required",
-          })
-          return
-        }
-        try {
-          await createTmuxSession(name, cwd, {
-            // cli_kind: 'codex' なら codex を、それ以外は claude を pane 起動する (既定 claude)。
-            cliKind: msg.cli_kind === "codex" ? "codex" : "claude",
-            claudeCmd:
-              typeof msg.claude_cmd === "string"
-                ? msg.claude_cmd
-                : claudeCmdFromAgentConfig(ctx.config),
-            codexCmd: typeof msg.codex_cmd === "string" ? msg.codex_cmd : undefined,
-            // codex 用設定 (claude 経路では claudeCmd を直接使うため無視される)。
-            model:
-              typeof msg.model === "string"
-                ? msg.model
-                : codexDefaultsFromAgentConfig(ctx.config).model,
-            sandbox: typeof msg.sandbox === "string" ? msg.sandbox : undefined,
-            approvalPolicy:
-              typeof msg.approval_policy === "string" ? msg.approval_policy : undefined,
-            effort:
-              typeof msg.effort === "string"
-                ? msg.effort
-                : codexDefaultsFromAgentConfig(ctx.config).effort,
-            initialPrompt:
-              typeof msg.initial_prompt === "string" ? msg.initial_prompt : undefined,
-            logger: ctx.logger,
-          })
-          tmuxSessionsSnapshotCache.clear()
-          ctx.client.send({
-            type: "tmux.create_session.result",
-            request_id: msg.request_id,
-            ok: true,
-            session_name: name,
-          })
-        } catch (err) {
-          ctx.client.send({
-            type: "tmux.create_session.result",
-            request_id: msg.request_id,
-            ok: false,
-            error: err.message,
-          })
-        }
+        await handleTmuxCreateSession(msg, ctx)
         return
       }
       case "worktree.create": {
-        // body: { request_id, dir, branch, cli_kind?, claude_cmd?, codex_cmd?, model?, sandbox?, approval_policy?, effort?, initial_prompt? }
-        const dir = (msg.dir || "").trim()
-        const branch = (msg.branch || "").trim()
-        if (!dir || !branch) {
-          ctx.client.send({
-            type: "worktree.create.result",
-            request_id: msg.request_id,
-            ok: false,
-            error: "dir and branch required",
-          })
-          return
-        }
-        if (!/^[A-Za-z0-9._\-/]+$/.test(branch) || branch.startsWith("-")) {
-          ctx.client.send({
-            type: "worktree.create.result",
-            request_id: msg.request_id,
-            ok: false,
-            error: "invalid branch name",
-          })
-          return
-        }
-        try {
-          const { wtName, wtPath, createdBranch } = await createWorktreeDir(dir, branch)
-          // worktree dir で tmux session を作成。tmux.create_session と同じく cli_kind を
-          // 解釈し、codex なら codex を pane 起動する（既定 claude）。
-          // T05945: セッション名は cli_kind に応じて `<wt>` / `<wt>__codex` へ分ける。これで
-          // 同一 worktree でも claude と codex を独立に起動/終了できる (旧実装は cli_kind に
-          // 関わらず `<wt>` 固定だったため、片方しか立てられなかった)。
-          const wtCliKind = msg.cli_kind === "codex" ? "codex" : "claude"
-          const wtSessionName = sessionNameFor(wtName, wtCliKind)
-          await createTmuxSession(wtSessionName, wtPath, {
-            cliKind: wtCliKind,
-            claudeCmd:
-              typeof msg.claude_cmd === "string"
-                ? msg.claude_cmd
-                : claudeCmdFromAgentConfig(ctx.config),
-            codexCmd: typeof msg.codex_cmd === "string" ? msg.codex_cmd : undefined,
-            // codex 用設定 (claude 経路では無視される)。
-            model:
-              typeof msg.model === "string"
-                ? msg.model
-                : codexDefaultsFromAgentConfig(ctx.config).model,
-            sandbox: typeof msg.sandbox === "string" ? msg.sandbox : undefined,
-            approvalPolicy:
-              typeof msg.approval_policy === "string" ? msg.approval_policy : undefined,
-            effort:
-              typeof msg.effort === "string"
-                ? msg.effort
-                : codexDefaultsFromAgentConfig(ctx.config).effort,
-            initialPrompt:
-              typeof msg.initial_prompt === "string" ? msg.initial_prompt : undefined,
-            logger: ctx.logger,
-          })
-          tmuxSessionsSnapshotCache.clear()
-          ctx.client.send({
-            type: "worktree.create.result",
-            request_id: msg.request_id,
-            ok: true,
-            // wt_name は従来どおり **ベース名** (dir 名)。frontend のツリー構築キーに使う。
-            wt_name: wtName,
-            // session_name は実際に作った tmux セッション名 (codex なら __codex 付き)。
-            // 旧 frontend はこのフィールドを見ないため後方互換 (wt_name で選択する)。
-            session_name: wtSessionName,
-            wt_path: wtPath,
-            branch,
-            created_branch: createdBranch,
-          })
-        } catch (err) {
-          ctx.client.send({
-            type: "worktree.create.result",
-            request_id: msg.request_id,
-            ok: false,
-            error: err.message,
-          })
-        }
+        await handleWorktreeCreate(msg, ctx)
         return
       }
       case "worktree.list_history": {

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/sibling-inject.mjs

@@ -41,6 +41,7 @@ import { mkdir, readFile, writeFile, rename, unlink, readdir } from "node:fs/pro
 import path from "node:path"
 
 import { verifySiblingTokenAny, siblingTokenCwd } from "./sibling-token.mjs"
+import { describeLiveSessionsUnion } from "./live-sessions.mjs"
 
 export const SIBLING_REQUESTS_DIR =
   process.env.COCKPIT_SIBLING_REQUESTS_DIR || "/tmp/cockpit_sibling_requests"
@@ -69,6 +70,14 @@ export class SiblingInjectBridge {
     this._watcher = null
   }
 
+  /**
+   * live-sessions.mjs (warm 判定の正本) へ渡すブリッジ束。宛先候補の列挙は必ずここを
+   * 経由し、`tmux.list_sessions` の `warm` と同じ判定を共有する。
+   */
+  _bridges() {
+    return { claudeBridge: this.claudeBridge, codexBridge: this.codexBridge }
+  }
+
   /** 監視ディレクトリを作成し、既存要求を sweep してから fs.watch を張る。 */
   async start() {
     await mkdir(this.dir, { recursive: true })
@@ -159,13 +168,8 @@ export class SiblingInjectBridge {
         this.logger?.warn({ request_id }, "sibling-inject: invalid sibling token (list-all)")
         result = { ok: false, error: "invalid_token" }
       } else {
-        result = {
-          ok: true,
-          live_sessions: [
-            ...(this.claudeBridge?.describeLiveSessions?.() ?? []),
-            ...(this.codexBridge?.describeLiveSessions?.() ?? []),
-          ],
-        }
+        // 判定は live-sessions.mjs に一本化する (tmux.list_sessions の warm と同じ関数)。
+        result = { ok: true, live_sessions: describeLiveSessionsUnion(this._bridges()) }
       }
     } else if (!cwd || badKind || badBody) {
       result = { ok: false, error: "invalid_request" }
@@ -192,7 +196,15 @@ export class SiblingInjectBridge {
       const bridge = target_cli_kind === "codex" ? this.codexBridge : this.claudeBridge
       if (isList) {
         // 宛先候補の列挙 (cockpit_orch.py --list 用)。この cwd の同種セッションを返す。
-        result = { ok: true, live_sessions: bridge?.describeLiveSessions?.(cwd) ?? [] }
+        // ⚠️ tmux.list_sessions の `warm` と同じ関数を通す (二重定義にすると「グレー表示
+        //    なのに宛先一覧に出ない」食い違いが再発する)。
+        result = {
+          ok: true,
+          live_sessions: describeLiveSessionsUnion(this._bridges(), {
+            cwd,
+            cliKind: target_cli_kind,
+          }),
+        }
       } else if (isExplicit) {
         // 明示宛先: session_id (claude) / stream_id|thread_id (codex) で cwd 一致下に確定解決。
         // sendToStream は {status:"delivered"|"not_found"|"ambiguous"} を返す。
@@ -361,10 +373,7 @@ export class SiblingInjectBridge {
    * @param {string} targetKind
    */
   _diagnose(cwd, targetKind) {
-    const sameCwd = [
-      ...(this.claudeBridge?.describeLiveSessions?.(cwd) ?? []),
-      ...(this.codexBridge?.describeLiveSessions?.(cwd) ?? []),
-    ]
+    const sameCwd = describeLiveSessionsUnion(this._bridges(), { cwd })
     const hint = sameCwd.length
       ? `この cwd には ${sameCwd.map((s) => s.kind).join("/")} のチャットセッションはあるが ${targetKind} は無い。`
       : `この cwd には hub-agent 管理下のチャットセッションが 1 本も無い。` +