@cocorograph/hub-agent 0.7.61 → 0.7.63

package/bin/hub-agent.mjs

@@ -27,7 +27,7 @@ if (!process.env.LC_ALL) process.env.LC_ALL = "C.UTF-8"
 
 import { hasConfig, readConfig } from "../src/config.mjs"
 import { enroll } from "../src/enroll.mjs"
-import { syncBundle } from "../src/hub-bundle.mjs"
+import { resolveSyncTargets, syncBundle } from "../src/hub-bundle.mjs"
 import {
   installPlugin,
   listInstallableExamples,
@@ -110,28 +110,40 @@ program
         }
         targets = [opts.cliKind]
       } else {
+        // 対象決定は enroll / self-heal と共通の resolveSyncTargets に寄せる。
         const { detectAvailableClis } = await import("../src/config.mjs")
-        const detected = (await detectAvailableClis()).filter((c) => c === "claude" || c === "codex")
-        targets = detected.length > 0 ? detected : ["claude"]
+        targets = resolveSyncTargets(await detectAvailableClis())
       }
 
+      // 各 CLI を **setup 完了まで同期的に**処理し、失敗は CLI 名付きで報告して continue
+      // （一方の失敗で他方を止めない）。1 つでも失敗したら非 0 で終える。
+      const failures = []
       for (const cliKind of targets) {
-        const r = await syncBundle({
-          hubUrl: cfg.hub_url,
-          agentId: cfg.agent_id,
-          agentToken: cfg.agent_token,
-          cliKind,
-        })
-        const mcpSummary = r.mcp
-          ? ` mcp_added=${r.mcp.added.length}${r.mcp.skipped.length > 0 ? ` mcp_skipped=${r.mcp.skipped.length}` : ""}`
-          : ""
-        console.log(
-          `hub bundle synced (${cliKind}): version=${r.version} written=${r.written.length} skipped_same=${r.skipped_same.length}${mcpSummary}`,
-        )
-        if (r.mcp && r.mcp.added.length > 0) {
-          console.log(`  mcp servers added: ${r.mcp.added.join(", ")}`)
+        try {
+          const r = await syncBundle({
+            hubUrl: cfg.hub_url,
+            agentId: cfg.agent_id,
+            agentToken: cfg.agent_token,
+            cliKind,
+          })
+          const mcpSummary = r.mcp
+            ? ` mcp_added=${r.mcp.added.length}${r.mcp.skipped.length > 0 ? ` mcp_skipped=${r.mcp.skipped.length}` : ""}`
+            : ""
+          console.log(
+            `hub bundle synced (${cliKind}): version=${r.version} written=${r.written.length} skipped_same=${r.skipped_same.length}${mcpSummary}`,
+          )
+          if (r.mcp && r.mcp.added.length > 0) {
+            console.log(`  mcp servers added: ${r.mcp.added.join(", ")}`)
+          }
+        } catch (err) {
+          console.error(`sync-bundle failed (${cliKind}): ${err.message}`)
+          failures.push(cliKind)
         }
       }
+      if (failures.length > 0) {
+        console.error(`sync-bundle 失敗: ${failures.join(", ")}`)
+        process.exit(1)
+      }
     } catch (err) {
       console.error(`sync-bundle failed: ${err.message}`)
       process.exit(1)

package/package.json

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

package/scripts/install.sh

@@ -646,30 +646,57 @@ do_enroll() {
   # マーカーは通常 syncBundle の最終ステップで書かれるが、scripts/manifest.json
   # が無いと SessionStart hook / hub-helper.py が動かないため両方必須。どちらかが
   # 欠けていれば半完了状態とみなして sync-bundle を retry。
-  if _hub_bundle_incomplete; then
-    color_warn "Hub AI bundle が ~/.claude に完全展開されていない可能性。sync-bundle を再試行"
-    if ! retry 2 hub-agent sync-bundle; then
-      color_warn "hub-agent sync-bundle が継続失敗。あとで手動実行してください:"
-      color_warn "  hub-agent sync-bundle"
-    fi
-  fi
+  # 検出された Claude/Codex 双方を個別検証し、不完全な CLI だけ再同期する
+  # （2026-07-15。旧実装は ~/.claude しか見ず Codex の欠損を検出・修復できなかった）。
+  _hub_reconcile_bundles
 }
 
-# Hub AI bundle の展開状況を判定する。完全に展開されていれば 0、欠けていれば 1。
-# do_enroll の事後 verify と verify_setup の最終チェックで共通利用する。
-_hub_bundle_incomplete() {
-  if [[ ! -f "$HOME/.claude/CLAUDE.md" ]]; then
-    return 0
-  fi
-  if ! grep -q "BEGIN HUB-AI-RULES" "$HOME/.claude/CLAUDE.md" 2>/dev/null; then
-    return 0
-  fi
-  if [[ ! -f "$HOME/.claude/scripts/manifest.json" ]]; then
-    return 0
+# 検証対象の CLI を列挙する。claude は常に対象、codex は PATH にある時だけ対象。
+# 各行 "cli_kind:dir:config_md:hooks_file"（Codex 未インストール環境では codex を要求しない）。
+_hub_target_clis() {
+  echo "claude:.claude:CLAUDE.md:settings.json"
+  if present codex; then
+    echo "codex:.codex:AGENTS.md:hooks.json"
   fi
+}
+
+# 単一 CLI の bundle 完全性を判定する。完全なら 0、欠けていれば 1。
+# $1=dir(.claude/.codex) $2=config_md(CLAUDE.md/AGENTS.md) $3=hooks_file(settings.json/hooks.json)
+# 検証項目: scripts/manifest.json / CONFIG_MD の HUB-AI-RULES マーカー /
+#           hooks 設定に Hub SessionStart hook(session_start.py) / 正規 .hub_token.json
+_hub_bundle_incomplete_cli() {
+  local dir="$1" config_md="$2" hooks_file="$3"
+  local base="$HOME/$dir"
+  [[ -f "$base/scripts/manifest.json" ]] || return 0
+  [[ -f "$base/$config_md" ]] || return 0
+  grep -q "BEGIN HUB-AI-RULES" "$base/$config_md" 2>/dev/null || return 0
+  grep -q "session_start.py" "$base/$hooks_file" 2>/dev/null || return 0
+  [[ -f "$base/.hub_token.json" ]] || return 0
   return 1
 }
 
+# 後方互換: 従来 claude 前提で呼んでいた箇所向けの薄いラッパ。
+_hub_bundle_incomplete() {
+  _hub_bundle_incomplete_cli ".claude" "CLAUDE.md" "settings.json"
+}
+
+# 検出された各 CLI の bundle 完全性を検証し、**不完全な CLI だけ** を
+# `hub-agent sync-bundle --cli-kind <kind>` で再同期する（Codex 未インストールなら対象外）。
+_hub_reconcile_bundles() {
+  local line cli_kind dir config_md hooks_file
+  while IFS= read -r line; do
+    [[ -z "$line" ]] && continue
+    IFS=":" read -r cli_kind dir config_md hooks_file <<< "$line"
+    if _hub_bundle_incomplete_cli "$dir" "$config_md" "$hooks_file"; then
+      color_warn "Hub AI bundle が ~/$dir に完全展開されていない可能性 ($cli_kind)。sync-bundle を再試行"
+      if ! retry 2 hub-agent sync-bundle --cli-kind "$cli_kind"; then
+        color_warn "hub-agent sync-bundle --cli-kind $cli_kind が継続失敗。あとで手動実行してください:"
+        color_warn "  hub-agent sync-bundle --cli-kind $cli_kind"
+      fi
+    fi
+  done < <(_hub_target_clis)
+}
+
 do_install_service() {
   color_step "OS サービスとして自動起動を登録"
   # install-service は launchctl bootout/bootstrap の transient で初回失敗する
@@ -687,17 +714,26 @@ do_install_service() {
 # verify を成功させる。setup_hub_ai 不在 (bundle 同期失敗) のときは色付き
 # warn を出して継続。再実行時は step_* が冪等処理を返すだけで害なし。
 do_bootstrap_hub_ai() {
-  local setup_script="$HOME/.claude/scripts/setup_hub_ai.py"
-  if [[ ! -f "$setup_script" ]]; then
-    color_warn "setup_hub_ai.py 不在 (bundle 同期が失敗した可能性)。スキップ"
-    return 0
-  fi
-  color_step "setup_hub_ai.py --silent を実行 (~/.claude/CLAUDE.md / settings.json 初期化)"
-  if python3 "$setup_script" --silent; then
-    color_ok "Hub AI bootstrap 完了"
-  else
-    color_warn "setup_hub_ai.py --silent が exit≠0 で終了 (継続)。手動で再実行: python3 $setup_script"
-  fi
+  # 検出された各 CLI（claude 常に / codex は present 時）の setup_hub_ai.py を
+  # 同期実行する。enroll/sync 内でも setup は走るが、install.sh では verify を確実に
+  # 成功させるため各 CLI で同期実行する（一方の失敗で他方を止めない）。2026-07-15 に
+  # Claude 固定から双方へ拡張。
+  local line cli_kind dir config_md hooks_file setup_script
+  while IFS= read -r line; do
+    [[ -z "$line" ]] && continue
+    IFS=":" read -r cli_kind dir config_md hooks_file <<< "$line"
+    setup_script="$HOME/$dir/scripts/setup_hub_ai.py"
+    if [[ ! -f "$setup_script" ]]; then
+      color_warn "setup_hub_ai.py 不在 ($cli_kind, bundle 同期が失敗した可能性)。スキップ"
+      continue
+    fi
+    color_step "setup_hub_ai.py --silent を実行 ($cli_kind: ~/$dir/$config_md / $hooks_file 初期化)"
+    if python3 "$setup_script" --silent; then
+      color_ok "Hub AI bootstrap 完了 ($cli_kind)"
+    else
+      color_warn "setup_hub_ai.py --silent が exit≠0 ($cli_kind, 継続)。手動再実行: python3 $setup_script"
+    fi
+  done < <(_hub_target_clis)
 }
 
 # セットアップ最終検証。
@@ -721,22 +757,22 @@ verify_setup() {
     color_warn "Claude Code (claude) コマンドが見つかりません (cockpit から claude を呼ぶ場合は必要)"
   fi
 
-  # 3. Hub AI bundle 展開 (do_enroll と同じ 2 段チェック: CLAUDE.md マーカー +
-  #    scripts/manifest.json)。CLAUDE.md は書き込まれたが manifest.json が落ちて
-  #    いない半完了状態も検知する。
-  if ! _hub_bundle_incomplete; then
-    local mver
-    mver="$(grep -o '"version"[[:space:]]*:[[:space:]]*"[^"]*"' "$HOME/.claude/scripts/manifest.json" 2>/dev/null | head -1 | sed 's/.*"\([^"]*\)"$/\1/')"
-    color_ok "Hub AI bundle 展開済み (~/.claude/CLAUDE.md + scripts/manifest.json ${mver:+v$mver})"
-  else
-    if [[ ! -f "$HOME/.claude/CLAUDE.md" ]] || ! grep -q "BEGIN HUB-AI-RULES" "$HOME/.claude/CLAUDE.md" 2>/dev/null; then
-      color_warn "Hub AI bundle が ~/.claude に展開されていません (CLAUDE.md マーカー欠落)"
+  # 3. Hub AI bundle 展開を **CLI 別** に検証（manifest / CONFIG_MD マーカー /
+  #    hooks の Hub SessionStart hook / 正規 .hub_token.json）。Codex 未インストールなら
+  #    codex は検証しない（2026-07-15）。
+  local line cli_kind dir config_md hooks_file mver
+  while IFS= read -r line; do
+    [[ -z "$line" ]] && continue
+    IFS=":" read -r cli_kind dir config_md hooks_file <<< "$line"
+    if ! _hub_bundle_incomplete_cli "$dir" "$config_md" "$hooks_file"; then
+      mver="$(grep -o '"version"[[:space:]]*:[[:space:]]*"[^"]*"' "$HOME/$dir/scripts/manifest.json" 2>/dev/null | head -1 | sed 's/.*"\([^"]*\)"$/\1/')"
+      color_ok "Hub AI bundle 展開済み ($cli_kind: ~/$dir/$config_md + scripts/manifest.json ${mver:+v$mver})"
     else
-      color_warn "Hub AI bundle が半完了状態 (~/.claude/scripts/manifest.json 欠落)"
+      color_warn "Hub AI bundle が半完了状態 ($cli_kind: ~/$dir の manifest / $config_md マーカー / $hooks_file の SessionStart hook / .hub_token.json のいずれか欠落)"
+      color_warn "  手動再同期: hub-agent sync-bundle --cli-kind $cli_kind"
+      errors=$((errors + 1))
     fi
-    color_warn "  手動再同期: hub-agent sync-bundle"
-    errors=$((errors + 1))
-  fi
+  done < <(_hub_target_clis)
 
   # 4. OS サービス起動 (Darwin 限定の確認。Linux は systemctl --user で別途)
   if [[ "$(uname)" == "Darwin" ]]; then

package/src/enroll.mjs

@@ -82,15 +82,18 @@ export async function enroll(enrollmentToken, opts = {}) {
   // 無ければ codex のみ同期する。
   const bundleResults = {}
   if (!opts.skipBundle) {
-    const { syncBundle } = await import("./hub-bundle.mjs")
-    const { kickSetupHubAi } = await import("./main.mjs")
-    // Hub backend が cli_kind='claude'/'codex' のみ対応するため他候補は無視する。
-    // detectAvailableClis() が空を返す (PATH 検出失敗等) 場合も fail-soft で
-    // 従来どおり claude 向け同期だけは必ず試みる。
-    const detected = availableClis.filter((c) => c === "claude" || c === "codex")
-    const targets = detected.length > 0 ? detected : ["claude"]
+    const { resolveSyncTargets, syncBundle } = await import("./hub-bundle.mjs")
+    // 検出された claude/codex を対象にする（Hub backend は cli_kind='claude'/'codex'
+    // のみ対応）。未検出は fail-soft で claude フォールバック。対象決定は
+    // resolveSyncTargets() に共通化し、enroll / sync-bundle CLI / self-heal で分岐させない。
+    const targets = resolveSyncTargets(availableClis)
     for (const cliKind of targets) {
       try {
+        // syncBundle が applyBundle → post_install(setup_hub_ai.py --silent) を **同期実行**
+        // するため、ここで別途 setup を kick する必要は無い（2026-07-15 に一本化。旧実装は
+        // enroll だけ別経路で detached kickSetupHubAi を叩き、sync-bundle / self-heal と
+        // 挙動が分岐していた）。CONFIG_MD / hooks / version / 旧 JWT の正規 token 移行まで
+        // syncBundle 完了時に揃う。
         bundleResults[cliKind] = await syncBundle({
           hubUrl,
           agentId: data.agent_id,
@@ -103,22 +106,6 @@ export async function enroll(enrollmentToken, opts = {}) {
         opts.logger?.warn?.({ cliKind, err: err.message }, "hub bundle sync failed (enroll still ok)")
         bundleResults[cliKind] = { error: err.message }
       }
-
-      // bundle 同期で ~/.claude/scripts/setup_hub_ai.py (or ~/.codex/...) が
-      // 配置された直後に kick する。設計穴: 初回 enroll では誰も
-      // setup_hub_ai.py を実行しないため、`step_claude_md` が走らず
-      // CLAUDE.md/AGENTS.md がいつまでも作成されない事故があった
-      // (2026-06-17 toma 環境)。bundle 配信は scripts と
-      // claude_md_fragment.md は含むが、CLAUDE.md/AGENTS.md と
-      // settings.json/hooks.json は含まないため、誰かが setup_hub_ai を
-      // 一度叩かないと self-bootstrap しない。enroll 直後に best-effort で
-      // 1 回叩く。既存環境では step_claude_md がマーカー範囲を冪等更新
-      // するだけで害なし。
-      try {
-        kickSetupHubAi({ logger: opts.logger, cliKind })
-      } catch (err) {
-        opts.logger?.warn?.({ cliKind, err: err.message }, "kickSetupHubAi from enroll failed (ignored)")
-      }
     }
   }
 

package/src/hub-bundle.mjs

@@ -180,8 +180,24 @@ export async function applyBundle({ bundle, logger, cliKind } = {}) {
     logger?.info({ dest, mode: mode.toString(8) }, "hub-bundle wrote file")
   }
 
-  // JWT を保存 (~/.claude/scripts/.hub_jwt.json、または ~/.codex/scripts/.hub_jwt.json)
+  // token を保存する。役割分担（2026-07-15 整理、G）:
+  //  - 正規 `<cliDir>/.hub_token.json`（`{access, refresh}` のみ）= setup_hub_ai.py が
+  //    step_token で読む SoT。これを書くことで sync/enroll 経由でも setup が token を
+  //    見つけて認証をスキップでき、Codex でも setup が完走する（旧実装は下記 legacy しか
+  //    書かず、Codex では setup が token を見つけられず --silent で中断していた）。
+  //  - legacy `<cliDir>/scripts/.hub_jwt.json`（version 付き）= 後方互換で従来どおり残す。
+  //    既存端末の reader やロールバックのため削除しない。
+  // cliKind 別ディレクトリに書くため Claude/Codex の token が混在しない。
   if (bundle.token) {
+    const canonical = {}
+    if (typeof bundle.token.access === "string") canonical.access = bundle.token.access
+    if (typeof bundle.token.refresh === "string") canonical.refresh = bundle.token.refresh
+    if (canonical.access && canonical.refresh) {
+      const canonPath = path.join(resolveClaudeDir(kind), ".hub_token.json")
+      await fs.mkdir(path.dirname(canonPath), { recursive: true })
+      await fs.writeFile(canonPath, JSON.stringify(canonical), { mode: 0o600 })
+      written.push(canonPath)
+    }
     const tp = tokenPath(kind)
     await fs.mkdir(path.dirname(tp), { recursive: true })
     await fs.writeFile(
@@ -256,17 +272,44 @@ function extractMarkerBlock(text) {
  * post_install_commands を順次実行する。manifest に list で書く想定。
  * Hub backend が冪等なコマンドを記述する責任を持つ (例: chmod +x ...)。
  */
-export async function runPostInstall(bundle, { logger } = {}) {
+export async function runPostInstall(bundle, { logger, isWindows } = {}) {
+  const win = isWindows ?? process.platform === "win32"
   const cmds = Array.isArray(bundle.post_install_commands)
     ? bundle.post_install_commands
     : []
   for (const cmd of cmds) {
-    const argv = typeof cmd === "string" ? ["/bin/sh", "-c", cmd] : cmd
+    const argv = _postInstallArgv(cmd, win)
     if (!Array.isArray(argv) || argv.length === 0) continue
     await runOnce(argv, { logger })
   }
 }
 
+/**
+ * post_install エントリを実行 argv に解決する。次の 3 形式を受ける:
+ *  - 文字列: シェルコマンドとして `/bin/sh -c <str>`（Windows は `cmd /c <str>`）
+ *  - 配列: そのまま argv（`spawn(bin, args)`）
+ *  - オブジェクト `{cmd_unix, cmd_windows, description}`: OS に応じて cmd_unix /
+ *    cmd_windows を選びシェルコマンドとして実行する
+ *
+ * ⚠️ 旧実装はオブジェクト形式を `typeof==="string"` でも `Array.isArray` でもないため
+ * 黙って `continue` していた（＝ backend manifest の `{cmd_unix,...}` 形式 post_install が
+ * 一切実行されず、sync-bundle 後の setup_hub_ai.py が走らなかった。2026-07-15 修正）。
+ * cli_kind 別パス（`~/.claude` / `~/.codex`）は backend が `{{CLI_DIR_NAME}}` を解決済みで
+ * 返すため、ここでは OS 選択だけを行い、不用意な追加 shell 展開はしない。
+ */
+function _postInstallArgv(cmd, win) {
+  if (typeof cmd === "string") {
+    return win ? ["cmd", "/c", cmd] : ["/bin/sh", "-c", cmd]
+  }
+  if (Array.isArray(cmd)) return cmd
+  if (cmd && typeof cmd === "object") {
+    const line = win ? cmd.cmd_windows : cmd.cmd_unix
+    if (typeof line !== "string" || !line.trim()) return null
+    return win ? ["cmd", "/c", line] : ["/bin/sh", "-c", line]
+  }
+  return null
+}
+
 function runOnce(argv, { logger } = {}) {
   return new Promise((resolve, reject) => {
     const [bin, ...args] = argv
@@ -453,9 +496,41 @@ async function resolveCliBin(binName) {
 }
 
 /**
- * fetch + apply + post_install + MCP server 自動登録をまとめて実行。
+ * 同期対象の CLI を決定する（共通ロジック、2026-07-15）。
+ *
+ * enroll / `sync-bundle` CLI / daemon self-heal で同じ規則を使い、経路ごとの分岐を無くす:
+ *  - `detectAvailableClis()` の結果から backend 対応の `claude` / `codex` だけを採る
+ *  - 明示 cliKind 指定時はそれ 1 件だけ（呼び出し側で `[cliKind]` を渡す）
+ *  - 検出ゼロ（PATH 検出失敗等）は既存互換として `['claude']` にフォールバック
+ *
+ * @param {string[]} availableClis detectAvailableClis() の戻り
+ * @returns {Array<'claude'|'codex'>}
+ */
+export function resolveSyncTargets(availableClis) {
+  const detected = (Array.isArray(availableClis) ? availableClis : []).filter(
+    (c) => c === "claude" || c === "codex",
+  )
+  return detected.length > 0 ? detected : ["claude"]
+}
+
+/**
+ * fetch + apply + post_install(setup) + MCP server 自動登録を **同期的に** まとめて実行。
  * cliKind='codex' で Codex 向け（`~/.codex/`、`codex mcp add`）に切り替わる
  * （Stream A2、2026-07-02。既定 'claude' は完全に従来どおり）。
+ *
+ * **責務と SoT（2026-07-15、二重取得の整理）**:
+ *  - `applyBundle` = 最小ブートストラップ。files[] 配置・CONFIG_MD マーカー・token
+ *    （正規 `.hub_token.json` + legacy `.hub_jwt.json`）を置き、**setup_hub_ai.py が存在し
+ *    実行できる状態**を作る。
+ *  - `runPostInstall` は backend が cli_kind 別にレンダリングした post_install_commands
+ *    （＝ `python3 <cliDir>/scripts/setup_hub_ai.py --silent`）を **await で同期実行** する。
+ *    `setup_hub_ai.py` が **完全セットアップの SoT**：hooks の冪等マージ（settings.json /
+ *    hooks.json）・installed_version 記録・旧 JWT の正規 token 移行・CONFIG_MD 生成を担う。
+ *    その中で `step_install_files` が bundle を再取得して files を冪等に再検証する（＝ 2 回目の
+ *    fetch。SoT の自己完結検証として許容。applyBundle の配置と重複しても冪等）。
+ *  - よって **本関数が成功を返す時点で setup は完了しており、detached の待ち残りは無い**
+ *    （手動 `hub-agent sync-bundle` は setup 完了まで同期的に待つ）。CLI 別パスは backend が
+ *    `{{CLI_DIR_NAME}}` を解決して返すため、Codex 同期で `~/.claude` の setup を誤実行しない。
  */
 export async function syncBundle({ hubUrl, agentId, agentToken, logger, fetchImpl, cliKind = "claude" } = {}) {
   const bundle = await fetchBundle({ hubUrl, agentId, agentToken, fetchImpl, cliKind })
@@ -463,7 +538,7 @@ export async function syncBundle({ hubUrl, agentId, agentToken, logger, fetchImp
   try {
     await runPostInstall(bundle, { logger })
   } catch (err) {
-    logger?.warn({ err: err.message }, "post_install partially failed (continuing)")
+    logger?.warn({ cliKind, err: err.message }, "post_install/setup partially failed (continuing)")
   }
   let mcp = { added: [], skipped: [] }
   try {

package/src/main.mjs

@@ -460,6 +460,38 @@ export function kickSetupHubAi({
   }
 }
 
+/**
+ * daemon 起動時 self-heal: 検出された Claude/Codex **双方**の setup_hub_ai.py を
+ * best-effort で kick する（2026-07-15）。旧実装は `kickSetupHubAi({logger})` = Claude 固定で、
+ * Codex が入っていても hooks.json/AGENTS.md/version が修復されなかった。
+ *
+ *  - 対象決定は enroll / sync-bundle と共通の resolveSyncTargets に寄せる
+ *  - 各 CLI を detached で best-effort 実行（既に整った環境では step_* が冪等で変更ゼロ）
+ *  - kickSetupHubAi は例外を投げないため、一方の失敗で他方を止めない
+ *  - ログには必ず cliKind を含める
+ */
+export async function kickSetupHubAiForDetectedClis({
+  logger,
+  detectImpl,
+  homedir,
+  spawnImpl,
+  existsImpl,
+} = {}) {
+  let targets = ["claude"]
+  try {
+    const detect = detectImpl || detectAvailableClis
+    const { resolveSyncTargets } = await import("./hub-bundle.mjs")
+    targets = resolveSyncTargets(await detect())
+  } catch (e) {
+    logger?.warn?.({ err: e?.message }, "kickSetupHubAiForDetectedClis: CLI 検出失敗 - claude のみ")
+    targets = ["claude"]
+  }
+  for (const cliKind of targets) {
+    kickSetupHubAi({ logger, cliKind, homedir, spawnImpl, existsImpl })
+  }
+  return targets
+}
+
 export async function startDaemon({ version, ptyModule, claudeSdk } = {}) {
   const config = await readConfig()
   if (!config) {
@@ -511,7 +543,8 @@ export async function startDaemon({ version, ptyModule, claudeSdk } = {}) {
   // `hub-agent restart` だけで CLAUDE.md と hooks を自動修復できるようにする。
   // 既に整っている環境では step_* がマーカー範囲を冪等更新するだけで害なし
   // (detached + stdio ignore で daemon は妨げない)。WHY: 2026-06-17 toma 環境調査。
-  kickSetupHubAi({ logger })
+  // 2026-07-15: Claude 固定から **検出された Claude/Codex 双方** の kick へ拡張。
+  await kickSetupHubAiForDetectedClis({ logger })
 
   // node-pty (Microsoft 公式) は macOS arm64 で PTY master fd を spawn ごとに leak し
   // (kill/destroy でも解放されず)、kern.tty.ptmx_max=511 到達で「新規ターミナルが

package/src/usage.mjs

@@ -1445,15 +1445,22 @@ export async function codexUsageForThread(threadId) {
   const rateLimits = found.payload.rate_limits
 
   let contextPercent = null
-  const totalTok = info?.total_token_usage
   const windowSize = info?.model_context_window
-  if (totalTok && typeof windowSize === "number" && windowSize > 0) {
+  // context 窓の「現在の占有率」は last_token_usage（直近ターンで実際に窓へ載った
+  // トークン）で測る。total_token_usage は会話累積（キャッシュ再利用分も加算し
+  // 単調増加）なので、ターンを重ねると窓サイズを超過し Math.min(100,…) で 100% に
+  // クランプされてドーナツが固着する（2026-07-15 バグ修正: 実測で累積 1,341,719 /
+  // 窓 258,400 = 519% → 100% 張り付き。実占有は last=66,973 → 25.9%）。Codex は
+  // 自動コンパクションで実文脈を使い回すため、累積で割ると必ず張り付く。
+  // last_token_usage が無い旧 Codex 版のみ従来の total_token_usage にフォールバック。
+  const usageForContext = info?.last_token_usage ?? info?.total_token_usage
+  if (usageForContext && typeof windowSize === "number" && windowSize > 0) {
     const tokens =
-      typeof totalTok.total_tokens === "number"
-        ? totalTok.total_tokens
-        : (totalTok.input_tokens || 0) +
-          (totalTok.cached_input_tokens || 0) +
-          (totalTok.output_tokens || 0)
+      typeof usageForContext.total_tokens === "number"
+        ? usageForContext.total_tokens
+        : (usageForContext.input_tokens || 0) +
+          (usageForContext.cached_input_tokens || 0) +
+          (usageForContext.output_tokens || 0)
     contextPercent = Math.min(100, Math.round((tokens / windowSize) * 1000) / 10)
   }