@cocorograph/hub-agent 0.7.47 → 0.7.49

package/package.json

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

package/src/claude-credentials.mjs

@@ -20,12 +20,31 @@
  * もともと config ディレクトリ単位で分離済み (profiles.mjs の hasFileCredentials を使う)。
  */
 import { promises as fs } from "node:fs"
+import os from "node:os"
+import path from "node:path"
 import { createHash } from "node:crypto"
 import { execFile } from "node:child_process"
 import { promisify } from "node:util"
 
 const execFileP = promisify(execFile)
 
+/**
+ * 既定 (プライマリ) プロファイルで CLAUDE_CONFIG_DIR が未設定のとき、Claude Code は
+ * ハッシュ無しの素のサービス名 `Claude Code-credentials` に OAuth トークンを保存する
+ * (ハッシュ付き `-<sha256>` を使うのは CLAUDE_CONFIG_DIR を明示した非既定プロファイルだけ)。
+ *
+ * ⚠️ 2026-07 実バグ: 既定プロファイル (`~/.claude`) を「ハッシュ付き名だけ」で在否
+ *    チェックしていたため、ログイン済みで実際に使用中でも常に空振りし、Cockpit の
+ *    アカウント切替 UI に「要ログイン」が出っぱなしになっていた。既定プロファイルは
+ *    素のサービス名も候補に含めて判定する。
+ */
+export const PLAIN_CREDENTIAL_SERVICE = "Claude Code-credentials"
+
+/** 既定プロファイル (CLAUDE_CONFIG_DIR 未設定時) の config ディレクトリ (`~/.claude`)。 */
+function defaultConfigDir() {
+  return path.join(os.homedir(), ".claude")
+}
+
 /** Keychain を使うプラットフォームか (認証分離が Keychain 依存なのは darwin のみ)。 */
 export function isKeychainPlatform(platform = process.platform) {
   return platform === "darwin"
@@ -76,6 +95,11 @@ export async function existsGenericPassword(service, opts = {}) {
  * symlink パスと realpath のどちらでハッシュを計算するかに依存しないよう、両方の
  * ハッシュ候補を在否チェックし、いずれか存在すればログイン済みとみなす。
  *
+ * さらに既定プロファイル (~/.claude、CLAUDE_CONFIG_DIR 未設定) のときは、Claude Code が
+ * ハッシュ無しの素の `Claude Code-credentials` に保存するため、そのサービス名も候補に
+ * 含める (PLAIN_CREDENTIAL_SERVICE のコメント参照)。含めないと既定プロファイルが常に
+ * 空振りして「要ログイン」が出っぱなしになる。
+ *
  * @param {string} configDir
  * @param {{execFileP?: Function}} [opts]
  * @returns {Promise<boolean>}
@@ -87,9 +111,28 @@ export async function profileHasKeychainCredentials(configDir, opts = {}) {
   } catch {
     /* realpath 不能 (ディレクトリ未作成等) は無視して literal パスのみ評価 */
   }
-  for (const dir of candidates) {
+
+  // チェックするサービス名を組み立てる。各 configDir 候補のハッシュ付き名に加え、
+  // 既定プロファイル (~/.claude、CLAUDE_CONFIG_DIR 未設定) のときだけ素のサービス名を足す。
+  const services = new Set()
+  for (const dir of candidates) services.add(credentialService(dir))
+
+  // 既定プロファイル判定: configDir 候補 (literal / realpath) のいずれかが
+  // ~/.claude (literal / realpath) に一致するか。iCloud 等への symlink でも拾える。
+  const defaultCandidates = new Set([defaultConfigDir()])
+  try {
+    defaultCandidates.add(await fs.realpath(defaultConfigDir()))
+  } catch {
+    /* ~/.claude 未作成なら literal のみで判定 */
+  }
+  const isDefaultProfile = [...candidates].some((dir) =>
+    defaultCandidates.has(dir),
+  )
+  if (isDefaultProfile) services.add(PLAIN_CREDENTIAL_SERVICE)
+
+  for (const service of services) {
     try {
-      if (await existsGenericPassword(credentialService(dir), opts)) return true
+      if (await existsGenericPassword(service, opts)) return true
     } catch {
       /* security 実行エラーは「不明」→ 存在しない寄せ */
     }

package/src/main.mjs

@@ -117,6 +117,7 @@ import {
   recordChatActivity,
   recordChatStreamTick,
 } from "./chat-signals.mjs"
+import { cliKindForSessionName, sessionNameFor } from "./session-names.mjs"
 import {
   ReadinessTracker,
   busyChildCount,
@@ -598,14 +599,13 @@ export async function startDaemon({ version, ptyModule, claudeSdk } = {}) {
       if (event?.type === "assistant") {
         const pct = event.message?.usage ? contextPctFromUsage(event.message.usage) : null
         try {
-          recordChatActivity(cwd, {
+          // cliKind は chat-signals のキーの一部 (T05945)。同一 cwd で走る codex の信号と
+          // 混ざらないよう、claude 由来のイベントは必ず "claude" バケットへ書く。
+          // sessionId は同一 CLI 内でのセッション乗り換え検知用 identity (S1)。
+          recordChatActivity(cwd, "claude", {
             status: "processing",
             contextPct: pct,
             inputPending: false,
-            // identity (S1): この cwd の chat 信号が「今どの CLI・どのセッションのものか」を
-            // 明示する。claude.attach で確定させた identity と一致すれば温存、別セッション/
-            // エンジンに切り替わっていれば chat-signals.mjs 側が自動でリセットする。
-            cliKind: "claude",
             sessionId: session_id || null,
           })
         } catch {
@@ -613,10 +613,9 @@ export async function startDaemon({ version, ptyModule, claudeSdk } = {}) {
         }
       } else if (event?.type === "result") {
         try {
-          recordChatActivity(cwd, {
+          recordChatActivity(cwd, "claude", {
             status: "waiting",
             inputPending: false,
-            cliKind: "claude",
             sessionId: session_id || null,
           })
         } catch {
@@ -629,7 +628,7 @@ export async function startDaemon({ version, ptyModule, claudeSdk } = {}) {
         // 純 SDK チャットで三点リーダーが消える。stream_event 受信を throttle 付き processing
         // tick として記録し statusAt を前進させる (本文は読まずタイムスタンプ前進のみ)。
         try {
-          recordChatStreamTick(cwd)
+          recordChatStreamTick(cwd, "claude")
         } catch {
           /* ignore */
         }
@@ -637,12 +636,14 @@ export async function startDaemon({ version, ptyModule, claudeSdk } = {}) {
       client.send({ type: "claude.event", stream_id, session_id, event })
     })
     claudeBridge.on("permission", ({ stream_id, session_id, cwd, request_id, tool_name, input }) => {
-      // 確認待ち信号 (2026-06-02): cwd キーで inputPending を立て、サイドバーの
+      // 確認待ち信号 (2026-06-02): (cwd, cliKind) キーで inputPending を立て、サイドバーの
       // 「確認待ち」ドット & 通知の発火源にする。次の assistant/result で落ちる。
       // これにより「裏で動いているセッションがどれか分からない」発見性の問題を解消する。
+      // T05945: 旧実装は cliKind を伝播しておらず、codex の承認カードでも claude 行の
+      // 確認待ちドットが点く (逆も然り) 交差汚染があった。CLI を明示して分離する。
       if (cwd) {
         try {
-          recordChatActivity(cwd, { inputPending: true })
+          recordChatActivity(cwd, "claude", { inputPending: true })
         } catch {
           /* ignore */
         }
@@ -667,7 +668,7 @@ export async function startDaemon({ version, ptyModule, claudeSdk } = {}) {
       // (正常完了は上の result ハンドラが既に waiting にしている)。
       if (cwd) {
         try {
-          recordChatActivity(cwd, { status: "waiting", inputPending: false })
+          recordChatActivity(cwd, "claude", { status: "waiting", inputPending: false })
         } catch {
           /* ignore */
         }
@@ -699,11 +700,10 @@ export async function startDaemon({ version, ptyModule, claudeSdk } = {}) {
             /* ignore */
           }
           try {
-            recordChatActivity(cwd, {
+            recordChatActivity(cwd, "codex", {
               status: "processing",
               contextPct,
               inputPending: false,
-              cliKind: "codex",
               sessionId: thread_id || null,
             })
           } catch {
@@ -720,11 +720,10 @@ export async function startDaemon({ version, ptyModule, claudeSdk } = {}) {
             /* ignore */
           }
           try {
-            recordChatActivity(cwd, {
+            recordChatActivity(cwd, "codex", {
               status: "waiting",
               contextPct,
               inputPending: false,
-              cliKind: "codex",
               sessionId: thread_id || null,
             })
           } catch {
@@ -737,7 +736,8 @@ export async function startDaemon({ version, ptyModule, claudeSdk } = {}) {
     codexBridge.on("permission", ({ stream_id, thread_id, cwd, request_id, method, params }) => {
       if (cwd) {
         try {
-          recordChatActivity(cwd, { inputPending: true })
+          // T05945: codex の承認待ちは codex 行にだけ立てる (claude 行へ漏らさない)。
+          recordChatActivity(cwd, "codex", { inputPending: true })
         } catch {
           /* ignore */
         }
@@ -909,7 +909,9 @@ export async function startDaemon({ version, ptyModule, claudeSdk } = {}) {
     async ({ request_id, session_id, cwd, tool_name, input, context_text }) => {
       if (cwd) {
         try {
-          recordChatActivity(cwd, { inputPending: true })
+          // TUI 権限ブリッジ (PreToolUse フック) は Claude Code TUI 専用の経路なので
+          // 常に claude バケットへ記録する (T05945)。
+          recordChatActivity(cwd, "claude", { inputPending: true })
         } catch {
           /* ignore */
         }
@@ -1524,8 +1526,13 @@ export function applyChatOverlay(paneStatus, paneContextPct, chat) {
  *
  * cwd → session_name の解決: claude.attach / codex.attach は tmux の session_name を知らない
  * (browser は cwd/stream_id しか送らない) ため、listSessionStates で全 tmux session を走査し
- * cwd が一致するものへ push する (通常は 1 cwd = 1 tmux session)。tmux 自体が無い / 一致が
- * 無ければ何もしない (安全側、次の poll 系フォールバックに委ねる)。
+ * cwd が一致するものへ push する。tmux 自体が無い / 一致が無ければ何もしない (安全側、次の
+ * poll 系フォールバックに委ねる)。
+ *
+ * ⚠️ T05945: 同一 cwd に claude 行 (`<dir>`) と codex 行 (`<dir>__codex`) が並ぶため、cwd 一致
+ * だけで push すると **attach した CLI のゼロ値/実値が反対側の CLI 行にも書き込まれる**
+ * (codex を新規 attach した瞬間に claude 行のドーナツが 0% に落ちる)。行のセッション名から
+ * 導いた cli_kind が attach 中の CLI と一致する行にだけ push する。
  *
  * `listSessionStatesFn` は単体テスト用の DI ポイント (既定は実 `listSessionStates`、tmux を
  * 起動する)。実運用では省略してよい。
@@ -1547,6 +1554,7 @@ export async function pushImmediateChatState({
     const states = await listSessionStatesFn({ plugins, logger })
     for (const s of states) {
       if (s.cwd !== cwd) continue
+      if (cliKindForSessionName(s.session_name) !== cliKind) continue
       client.send({
         type: "session.state",
         session_name: s.session_name,
@@ -1600,18 +1608,35 @@ export function resolveStateLoopBoundSessionId(boundSessions, sessionName, cwd,
  *  1. chat 信号が processing → "chat-active" (true)
  *  2. chat 信号が waiting/idle → "chat-inactive" (false)
  *  3. fresh unbound bind (adopt 前の bind プレースホルダ) → "fresh-unbound" (null=不明、安全側)
- *  4. cwd に一致するライブ codexBridge セッションがある → "codex" (rollout ベース判定)
- *  5. cwd があれば → "claude" (jsonl ベース判定、TUI/bound session フォールバック)
+ *  4. **その行が codex セッション** なら → codexThreadId があれば "codex" (rollout ベース判定)、
+ *     無ければ "none" (null=不明)
+ *  5. **その行が claude セッション** で cwd があれば → "claude" (jsonl ベース判定)
  *  6. cwd も無ければ → "none" (null=不明)
  *
- * @param {{chatStatus?: string|null, cwd?: string|null, isFreshUnbound?: boolean, codexThreadId?: string|null}} params
+ * ## sessionCliKind による分岐 (T05945, 2026-07-09)
+ * 旧実装は `codexThreadId` (= cwd に一致するライブ codex セッションの有無) だけで codex 判定を
+ * していた。同一 cwd に claude 行 (`<dir>`) と codex 行 (`<dir>__codex`) が並ぶ新運用では、
+ * codex チャットが走っているだけで **claude 行の turn_active まで codex の rollout で判定** して
+ * しまう (交差汚染)。行そのものの CLI 種別 (セッション名から構造的に導出) を第一の分岐軸にする。
+ *
+ * codex 行で codexThreadId が無い場合 (= codex TUI ペインだけがあり chat 未 attach) は "none"。
+ * 旧実装はここで "claude" に落ちて **claude の jsonl を読んでいた** ため、無関係な claude
+ * アクティビティで青ドットが点きうる欠陥があった。null=不明 に倒すのが安全側。
+ *
+ * @param {{chatStatus?: string|null, cwd?: string|null, isFreshUnbound?: boolean, codexThreadId?: string|null, sessionCliKind?: 'claude'|'codex'}} params
  * @returns {'chat-active'|'chat-inactive'|'fresh-unbound'|'codex'|'claude'|'none'}
  */
-export function decideTurnActiveSource({ chatStatus, cwd, isFreshUnbound, codexThreadId }) {
+export function decideTurnActiveSource({
+  chatStatus,
+  cwd,
+  isFreshUnbound,
+  codexThreadId,
+  sessionCliKind = "claude",
+}) {
   if (chatStatus === "processing") return "chat-active"
   if (chatStatus === "waiting" || chatStatus === "idle") return "chat-inactive"
   if (cwd && isFreshUnbound) return "fresh-unbound"
-  if (codexThreadId) return "codex"
+  if (sessionCliKind === "codex") return codexThreadId ? "codex" : "none"
   if (cwd) return "claude"
   return "none"
 }
@@ -1652,6 +1677,10 @@ export function startStateLoop({ client, plugins, logger, intervalMs, claudeBrid
       await refreshContextWindow()
       const states = await listSessionStates({ plugins, logger })
       for (const s of states) {
+        // T05945: この行がどの CLI のセッションかは **セッション名から構造的に決まる**
+        // (`<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
@@ -1666,7 +1695,9 @@ export function startStateLoop({ client, plugins, logger, intervalMs, claudeBrid
         // 返せないため、SDK チャットの補完は従来どおり効く。TUI 生成中に stale な SDK
         // status (waiting) が勝ってステータスドット/三点リーダーが消える事故の防止
         // (2026-06-12) は paneIsProcessing ガードのまま維持される。
-        const chat = s.cwd ? getChatSignal(s.cwd) : null
+        // (cwd, cliKind) キーで自 CLI のチャット信号だけを読む。同一 cwd の別 CLI 行が
+        // 立てた status/context_pct を拾わない (交差汚染の遮断)。
+        const chat = s.cwd ? getChatSignal(s.cwd, sessionCliKind) : null
         const overlay = applyChatOverlay(s.status, s.context_pct, chat)
         let status = overlay.status
         let contextPct = overlay.contextPct
@@ -1755,12 +1786,17 @@ export function startStateLoop({ client, plugins, logger, intervalMs, claudeBrid
         //    null=不明のまま、退行はしない)。
         //    分岐の優先順位は decideTurnActiveSource (純関数、単体テスト済み) が権威。
         let turnActive = null
-        const codexThreadId = s.cwd ? codexBridge?.threadIdForCwd?.(s.cwd) || null : null
+        // codex 行のときだけ rollout ベース判定の材料を引く (claude 行では常に null)。
+        const codexThreadId =
+          s.cwd && sessionCliKind === "codex"
+            ? codexBridge?.threadIdForCwd?.(s.cwd) || null
+            : null
         const turnActiveSource = decideTurnActiveSource({
           chatStatus: chat?.status,
           cwd: s.cwd,
           isFreshUnbound: isFreshUnboundBind(boundSessions?.get(s.session_name)),
           codexThreadId,
+          sessionCliKind,
         })
         switch (turnActiveSource) {
           case "chat-active":
@@ -1790,11 +1826,15 @@ export function startStateLoop({ client, plugins, logger, intervalMs, claudeBrid
             turnActive = null
         }
 
-        // S1 (2026-07): チャット信号 (getChatSignal) が identity (cliKind/sessionId) を
-        // 持っていれば、それをそのまま session.state に同梱する。frontend はこれで「今
-        // 表示中のエンジン/セッションと一致する push か」を判定し、不一致の値を適用しない
-        // (前セッションの値を上書きし続ける症状③④の frontend 側の受け口)。
-        const chatCliKind = chat?.cliKind ?? null
+        // cli_kind (T05945): **セッション名から導いた構造的な値**を常に載せる。旧実装は
+        // 「チャット信号があればその cliKind、無ければ null」だったため、TUI 専用行や
+        // チャット未接続行で null になり、frontend が行の CLI を知る術が無かった。
+        // (cwd, cliKind) キー化により「チャット信号の cliKind == 行の cliKind」が恒真に
+        // なったので、常に非 null の構造値を送る方が真に厳しい (= 情報量が多い) 上位互換。
+        //
+        // chat_session_id は「その行のチャットが今どのセッション/スレッドか」。チャット信号が
+        // 無ければ null (TUI 専用行)。
+        const chatCliKind = sessionCliKind
         const chatSessionId = chat?.sessionId ?? null
 
         const prev = lastByName.get(s.session_name)
@@ -1860,9 +1900,9 @@ export function startStateLoop({ client, plugins, logger, intervalMs, claudeBrid
             // turn_active: ステータスドット 4 状態統一の権威ソース。null は旧クライアント互換
             // (frontend は欠落時に旧 prompt_submit/stale 降格ロジックへフォールバック)。
             turn_active: turnActive,
-            // cli_kind / chat_session_id (S1, 2026-07): このセッションの現在の chat 信号が
-            // どの CLI・どのセッションのものか。チャット信号が無い (TUI 専用/未対応) 行では
-            // null (旧クライアント互換、frontend は無条件マージにフォールバック)。
+            // cli_kind (T05945): セッション名由来の構造値 ('claude' | 'codex')。frontend の
+            // 単一セレクタ (useCockpitSessionDisplay) が「この push はどの CLI 行のものか」を
+            // 判定する唯一の軸。chat_session_id はチャット信号が無ければ null。
             cli_kind: chatCliKind,
             chat_session_id: chatSessionId,
           })
@@ -2662,12 +2702,11 @@ async function dispatch(msg, ctx) {
           const resolvedCwd = cwdArg || process.env.HOME || process.cwd()
           if (resolvedCwd) {
             if (!resumeSessionId) {
-              clearChatSignal(resolvedCwd)
-              recordChatActivity(resolvedCwd, {
+              clearChatSignal(resolvedCwd, "claude")
+              recordChatActivity(resolvedCwd, "claude", {
                 status: "waiting",
                 contextPct: 0,
                 inputPending: false,
-                cliKind: "claude",
                 sessionId: null,
               })
               pushImmediateChatState({
@@ -2685,11 +2724,10 @@ async function dispatch(msg, ctx) {
                 .then((jsonlCtx) => {
                   const contextPct =
                     typeof jsonlCtx?.percent === "number" ? jsonlCtx.percent : 0
-                  recordChatActivity(resolvedCwd, {
+                  recordChatActivity(resolvedCwd, "claude", {
                     status: "waiting",
                     contextPct,
                     inputPending: false,
-                    cliKind: "claude",
                     sessionId: resumeSessionId,
                   })
                   return pushImmediateChatState({
@@ -3305,7 +3343,9 @@ async function dispatch(msg, ctx) {
           // status/context% 補完) は役目を終える。残すと TUI 権限カードの
           // inputPending 記録が stale status の鮮度を延命し、state loop が
           // ペイン実状態を waiting で上書きし続ける (2026-06-12 真因修正)。
-          if (cwd) clearChatSignal(cwd)
+          // T05945: claude バケットのみ消す。同一 cwd で走っている codex チャットの
+          // 信号まで消すと、codex 行のドット/ドーナツが巻き添えで消灯する。
+          if (cwd) clearChatSignal(cwd, "claude")
           // 3) tmux claude を起動し直す (resume or fresh)。
           //    冪等性: 同じ session を同じキーへ既に載せ替え済みなら respawn しない
           //    (TUI ビューは remount のたびに bind を送るため、毎回 respawn すると
@@ -3694,12 +3734,11 @@ async function dispatch(msg, ctx) {
           //  - resume: codexUsageForThread で実 context% を解決し即時 push (症状③)。
           if (resolvedCwd) {
             if (!resumeThreadId) {
-              clearChatSignal(resolvedCwd)
-              recordChatActivity(resolvedCwd, {
+              clearChatSignal(resolvedCwd, "codex")
+              recordChatActivity(resolvedCwd, "codex", {
                 status: "waiting",
                 contextPct: 0,
                 inputPending: false,
-                cliKind: "codex",
                 sessionId: info.threadId || null,
               })
               pushImmediateChatState({
@@ -3716,11 +3755,10 @@ async function dispatch(msg, ctx) {
                 .catch(() => null)
                 .then((usage) => {
                   const contextPct = typeof usage?.context === "number" ? usage.context : 0
-                  recordChatActivity(resolvedCwd, {
+                  recordChatActivity(resolvedCwd, "codex", {
                     status: "waiting",
                     contextPct,
                     inputPending: false,
-                    cliKind: "codex",
                     sessionId: info.threadId,
                   })
                   return pushImmediateChatState({
@@ -4362,10 +4400,14 @@ async function dispatch(msg, ctx) {
         try {
           const { wtName, wtPath, createdBranch } = await createWorktreeDir(dir, branch)
           // worktree dir で tmux session を作成。tmux.create_session と同じく cli_kind を
-          // 解釈し、codex なら codex を pane 起動する（既定 claude）。worktree は別 cwd=
-          // 別セッション名なので、メイン=claude / worktree=codex の並走が成立する。
-          await createTmuxSession(wtName, wtPath, {
-            cliKind: msg.cli_kind === "codex" ? "codex" : "claude",
+          // 解釈し、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
@@ -4391,7 +4433,11 @@ async function dispatch(msg, ctx) {
             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,

package/src/session-names.mjs

@@ -0,0 +1,86 @@
+/**
+ * tmux セッション名と CLI 種別 (cli_kind) の対応規約 — **正本 (SoT)**。
+ *
+ * ## 背景
+ * 従来は「1 tmux セッション名 = 1 ワークスペース dir」で、そのペインで claude を動かすか
+ * codex を動かすかは起動時の一過性パラメータでしかなかった。そのため同一 dir で claude と
+ * codex を独立に起動/終了できず、サイドバーのステータスドット・コンテキストドーナツ・kill は
+ * すべて「dir 単位」の粒度しか持てなかった (2026-07-09 調査)。
+ *
+ * ## 規約 (2026-07-09 確定)
+ *   claude → `<dir>`            (後方互換。既存セッションはそのまま claude として解釈される)
+ *   codex  → `<dir>__codex`     (予約サフィックス)
+ *
+ * `__codex` を予約サフィックスに選べる根拠 (Phase0 スパイク済み):
+ *   - frontend の `sanitizeSessionName` は `.` `:` のみ `-` へ置換し、`_` は保持する
+ *   - 既存のセッション命名 (workspace dir / worktree dir 由来) に `__` 区切りの使用例が無い
+ *
+ * ## 不変条件
+ *   - `sessionNameFor(baseSessionName(n), cliKindForSessionName(n)) === n`  (往復同一)
+ *   - `cliKindForSessionName` は「末尾が `__codex` か」だけで決まる純関数。tmux / 設定 /
+ *     ブリッジの状態を一切参照しない。これが「セッション行の CLI 種別を 1 箇所だけ見れば
+ *     済む」ための SoT である。
+ *
+ * frontend 側の対応実装は `frontend/lib/cockpit/sessionKey.ts` (同じ規約を TypeScript で再掲)。
+ * どちらかを変更したら必ず両方揃えること。
+ */
+
+/** codex セッションを表す予約サフィックス。 */
+export const CODEX_SESSION_SUFFIX = "__codex"
+
+/** 有効な cli_kind。 */
+const VALID_CLI_KINDS = new Set(["claude", "codex"])
+
+/**
+ * 任意の入力を cli_kind へ正規化する。未知値 / null / undefined は "claude" (既定 CLI)。
+ *
+ * 既定を claude にする理由: 本リポジトリの歴史的既定が claude であり、cli_kind を伝播し
+ * 忘れた呼び出し元があっても「codex の状態が claude 行に混ざる」より「claude 行に落ちる」
+ * 方が退行が小さい (claude が圧倒的多数のセッション)。
+ *
+ * @param {unknown} value
+ * @returns {'claude'|'codex'}
+ */
+export function normalizeCliKind(value) {
+  return VALID_CLI_KINDS.has(value) ? value : "claude"
+}
+
+/**
+ * tmux セッション名からその行の CLI 種別を導出する (構造的判定)。
+ *
+ * @param {string} sessionName
+ * @returns {'claude'|'codex'}
+ */
+export function cliKindForSessionName(sessionName) {
+  if (typeof sessionName !== "string") return "claude"
+  return sessionName.endsWith(CODEX_SESSION_SUFFIX) ? "codex" : "claude"
+}
+
+/**
+ * tmux セッション名から CLI サフィックスを剥がしてベース名 (= ワークスペース / worktree の
+ * dir 名) を返す。worktree の親子解決・stub 突合など「dir 単位」で扱いたい箇所で使う。
+ *
+ * @param {string} sessionName
+ * @returns {string}
+ */
+export function baseSessionName(sessionName) {
+  if (typeof sessionName !== "string") return ""
+  return sessionName.endsWith(CODEX_SESSION_SUFFIX)
+    ? sessionName.slice(0, -CODEX_SESSION_SUFFIX.length)
+    : sessionName
+}
+
+/**
+ * dir 名 (ベース名) と cli_kind から tmux セッション名を組み立てる。
+ *
+ * 既に `__codex` が付いたベース名を渡しても二重付与しない (冪等)。
+ *
+ * @param {string} dir
+ * @param {unknown} cliKind
+ * @returns {string}
+ */
+export function sessionNameFor(dir, cliKind) {
+  const base = baseSessionName(String(dir || ""))
+  if (!base) return ""
+  return normalizeCliKind(cliKind) === "codex" ? `${base}${CODEX_SESSION_SUFFIX}` : base
+}

package/src/tmux.mjs

@@ -28,6 +28,7 @@ import {
   detectSessionState,
   getSessionCwd,
 } from "./state.mjs"
+import { baseSessionName, sessionNameFor } from "./session-names.mjs"
 import { boundSessionId, getSessionUsages, jsonlContextForCwd } from "./usage.mjs"
 
 const execFileP = promisify(execFile)
@@ -222,12 +223,18 @@ async function buildWorktreeParentMap() {
  * 走行中の tmux session 名 set を受け取り、それに含まれない worktree (= 未起動 stub)
  * のリストを返す。cockpit `tmux.sessions` 応答の `worktree_stubs` フィールドに乗せる
  * ためのヘルパー。
+ *
+ * T05945: live 判定は **CLI サフィックスを剥がしたベース名** で行う。codex だけを起動した
+ * worktree (`<wt>__codex`) が「未起動 stub」としても同時に列挙され、サイドバーに live 行と
+ * stub 行が二重表示される事故を防ぐ。
  */
 export async function listWorktreeStubs(liveSessionNames) {
   const idx = await buildWorktreeIndex()
+  const liveBaseNames = new Set()
+  for (const n of liveSessionNames) liveBaseNames.add(baseSessionName(n))
   const stubs = []
   for (const [name, info] of idx) {
-    if (liveSessionNames.has(name)) continue
+    if (liveBaseNames.has(name)) continue
     stubs.push(info)
   }
   return stubs
@@ -295,7 +302,9 @@ async function inspectWorktreeDirty(wtPath) {
  * @returns {Promise<{ name: string, wt_path: string, dirty?: boolean, changes?: string[], unpushed_commits?: number }>}
  */
 export async function removeWorktree(name, opts = {}) {
-  const sanitized = sanitizeTmuxName(String(name || "").trim())
+  // T05945: frontend は常にベース名を送るが、万一 `<wt>__codex` が来ても worktree index を
+  // 引けるようベース名へ正規化する。
+  const sanitized = baseSessionName(sanitizeTmuxName(String(name || "").trim()))
   if (!sanitized) throw new Error("worktree name required")
   const idx = await buildWorktreeIndex()
   const info = idx.get(sanitized)
@@ -321,18 +330,25 @@ export async function removeWorktree(name, opts = {}) {
     }
   }
 
-  // 走行中の session があれば kill
-  try {
-    await execFileP(tmuxBin(opts), ["kill-session", "-t", sanitized])
-  } catch (err) {
-    const msg = err?.message || String(err)
-    // session 不在は正常 (停止済みの worktree を消すパスもある)
-    if (
-      !msg.includes("can't find session") &&
-      !msg.includes("no current session") &&
-      !msg.includes("no server running")
-    ) {
-      throw err
+  // 走行中の session があれば kill。T05945: 同一 worktree に claude (`<wt>`) と codex
+  // (`<wt>__codex`) の 2 セッションが並びうるため、両方を kill してから dir を消す
+  // (片方が残ったまま dir を消すと、生存セッションの cwd が消滅した状態になる)。
+  for (const target of [
+    sessionNameFor(sanitized, "claude"),
+    sessionNameFor(sanitized, "codex"),
+  ]) {
+    try {
+      await execFileP(tmuxBin(opts), ["kill-session", "-t", target])
+    } catch (err) {
+      const msg = err?.message || String(err)
+      // session 不在は正常 (停止済みの worktree を消すパス / 片方の CLI しか起動していない)
+      if (
+        !msg.includes("can't find session") &&
+        !msg.includes("no current session") &&
+        !msg.includes("no server running")
+      ) {
+        throw err
+      }
     }
   }
   // 親 repo を解決し `git -C <parent> worktree remove --force <wtPath>` を実行
@@ -667,7 +683,10 @@ export async function listSessions(opts = {}) {
         status: state.status,
         context_pct,
         cwd,
-        parent_session_name: wtParentMap.get(s.name) || null,
+        // T05945: worktree の親解決はベース名で行う (`<wt>__codex` も `<wt>` と同じ親配下)。
+        // これをしないと codex の worktree セッションが親を失い「その他 (workspace 未登録)」へ
+        // 落ちる。
+        parent_session_name: wtParentMap.get(baseSessionName(s.name)) || null,
       }
     }),
   )