@cocorograph/hub-agent 0.5.18 → 0.5.20

package/package.json

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

package/scripts/install.sh

@@ -10,16 +10,20 @@
 #
 # 内容:
 #   1. macOS なら Homebrew (なければ install)
+#      - 管理者権限が無い環境では自動で $HOME/homebrew にユーザーローカル
+#        インストールに切り替わる (HUB_AGENT_USER_BREW=1 で強制も可)
 #   2. tmux + node (なければ install via brew / apt)
 #   3. npm i -g @cocorograph/hub-agent
-#   4. HUB_AGENT_TOKEN が設定されていれば hub-agent enroll を自動実行
-#   5. hub-agent install-service で OS サービス化
+#   4. npm i -g @anthropic-ai/claude-code (既存があれば upgrade のみ)
+#   5. HUB_AGENT_TOKEN が設定されていれば hub-agent enroll を自動実行
+#   6. hub-agent install-service で OS サービス化
 # =============================================================================
 
 set -euo pipefail
 
 NODE_MIN_MAJOR=20
 PACKAGE_NAME="@cocorograph/hub-agent"
+CLAUDE_CODE_PACKAGE="@anthropic-ai/claude-code"
 
 color_step() { printf "\033[1;34m==> %s\033[0m\n" "$1"; }
 color_ok()   { printf "\033[1;32m✓ %s\033[0m\n" "$1"; }
@@ -32,20 +36,39 @@ ensure_brew() {
   if [[ "$(uname)" != "Darwin" ]]; then return 0; fi
   if present brew; then
     color_ok "brew already installed"
+    persist_brew_shellenv
+    return 0
+  fi
+
+  # 管理者権限の有無を判定して user-mode に切り替える。
+  # - 環境変数 HUB_AGENT_USER_BREW=1 で明示強制
+  # - sudo がパスワードなしで通らない = 管理者ではない可能性が高いと判定
+  # user-mode では $HOME/homebrew にユーザーローカルインストール（sudo 不要）。
+  local use_user_mode=0
+  if [[ "${HUB_AGENT_USER_BREW:-0}" == "1" ]]; then
+    use_user_mode=1
+    color_step "HUB_AGENT_USER_BREW=1 → ユーザーローカル Homebrew を使用"
+  elif ! sudo -n true 2>/dev/null; then
+    color_warn "管理者権限なしと判定 → \$HOME/homebrew にユーザーローカル Homebrew をインストール"
+    use_user_mode=1
+  fi
+
+  if (( use_user_mode == 1 )); then
+    color_step "Homebrew をユーザーローカルインストール (\$HOME/homebrew)"
+    mkdir -p "$HOME/homebrew"
+    curl -L https://github.com/Homebrew/brew/tarball/master | tar xz --strip 1 -C "$HOME/homebrew"
+    export PATH="$HOME/homebrew/bin:$PATH"
+    persist_user_brew_shellenv
   else
-    color_step "Homebrew をインストール"
+    color_step "Homebrew をシステムインストール"
     /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
     # Apple Silicon の brew はデフォルト PATH に入らないので追加
     if [[ -d /opt/homebrew/bin ]]; then
       export PATH="/opt/homebrew/bin:$PATH"
     fi
-    present brew || { color_err "brew install failed"; exit 1; }
+    persist_brew_shellenv
   fi
-  # Apple Silicon Mac は `/opt/homebrew/bin` がデフォルト PATH に入らないので、
-  # `~/.zprofile` / `~/.bash_profile` に `brew shellenv` の eval を **永続化** する。
-  # これを入れないと install.sh 終了後の新規ターミナルから `npm` / `node` /
-  # `hub-agent` が `command not found` になる (葛西氏 Mac で 0.5.11 リリース直後に踏んだ)。
-  persist_brew_shellenv
+  present brew || { color_err "brew install failed"; exit 1; }
 }
 
 # Apple Silicon Mac で brew のパスを zsh / bash 永続化する。既に追記済みなら no-op。
@@ -80,6 +103,68 @@ persist_brew_shellenv() {
   done
 }
 
+# user-mode（$HOME/homebrew）用の shellenv 永続化。
+# system 版 persist_brew_shellenv と同じ仕組みだが対象 brew が $HOME 配下。
+persist_user_brew_shellenv() {
+  local brew_bin="$HOME/homebrew/bin/brew"
+  [[ -x "$brew_bin" ]] || return 0
+  local snippet="eval \"\$(${brew_bin} shellenv)\""
+  local marker="# >>> hub-agent: brew shellenv (user-local) >>>"
+  local end_marker="# <<< hub-agent: brew shellenv <<<"
+  local target
+  for target in "$HOME/.zprofile" "$HOME/.bash_profile"; do
+    if [[ -f "$target" ]] && grep -Fq "$snippet" "$target"; then
+      color_ok "user-local brew shellenv は既に $target にあります"
+      continue
+    fi
+    color_step "$target に user-local brew shellenv を追記"
+    {
+      printf '\n%s\n' "$marker"
+      printf '%s\n' "$snippet"
+      printf '%s\n' "$end_marker"
+    } >> "$target"
+    color_ok "$target に追記しました (新規シェルから有効)"
+  done
+}
+
+# user-mode の場合、npm の global prefix を $HOME/.npm-global に切り替える。
+# brew が $HOME/homebrew にいるとき、その prefix への書き込み権限はあるものの、
+# 後で system 版 node / npm に切り替わる可能性も考えて user 領域に逃がしておく。
+# system mode（/opt/homebrew 等）では何もしない（既存挙動を温存）。
+ensure_npm_user_prefix() {
+  [[ "$(uname)" != "Darwin" ]] && return 0
+  [[ -d "$HOME/homebrew" ]] || return 0  # user-mode 検知
+
+  # 既に $HOME/.npm-global が prefix なら何もしない
+  local cur_prefix
+  cur_prefix="$(npm config get prefix 2>/dev/null || echo '')"
+  if [[ "$cur_prefix" == "$HOME/.npm-global" ]]; then
+    color_ok "npm global prefix は既に $HOME/.npm-global"
+    return 0
+  fi
+
+  color_step "npm global prefix を \$HOME/.npm-global に切替 (user-mode)"
+  mkdir -p "$HOME/.npm-global"
+  npm config set prefix "$HOME/.npm-global"
+  export PATH="$HOME/.npm-global/bin:$PATH"
+
+  local snippet='export PATH="$HOME/.npm-global/bin:$PATH"'
+  local marker="# >>> hub-agent: npm-global PATH (user-mode) >>>"
+  local end_marker="# <<< hub-agent: npm-global PATH <<<"
+  local target
+  for target in "$HOME/.zprofile" "$HOME/.bash_profile"; do
+    if [[ -f "$target" ]] && grep -Fq "$snippet" "$target"; then
+      continue
+    fi
+    {
+      printf '\n%s\n' "$marker"
+      printf '%s\n' "$snippet"
+      printf '%s\n' "$end_marker"
+    } >> "$target"
+    color_ok "$target に npm-global PATH を追記"
+  done
+}
+
 ensure_pkg() {
   local cmd="$1"
   local brew_pkg="$2"
@@ -134,6 +219,26 @@ ensure_global_install() {
   color_ok "hub-agent $(hub-agent --version)"
 }
 
+# Claude Code CLI を同梱でセットアップ。Cockpit 側から claude を呼び出すので、
+# 同じ npm-global prefix に入れておくとパス解決が一貫する。
+# 既存があれば upgrade のみ（破壊しない）。
+ensure_claude_code() {
+  if present claude; then
+    local cur
+    cur=$(claude --version 2>/dev/null || echo "unknown")
+    color_step "Claude Code (現在 $cur) を最新版にアップデート"
+    npm install -g "$CLAUDE_CODE_PACKAGE" || color_warn "Claude Code upgrade に失敗 (既存版で継続)"
+  else
+    color_step "$CLAUDE_CODE_PACKAGE を install"
+    npm install -g "$CLAUDE_CODE_PACKAGE"
+  fi
+  if present claude; then
+    color_ok "claude $(claude --version 2>/dev/null || echo 'installed')"
+  else
+    color_warn "claude コマンドが PATH に見つかりません。新規シェルで再確認してください"
+  fi
+}
+
 do_enroll() {
   if [[ -z "${HUB_AGENT_TOKEN:-}" ]]; then
     color_warn "HUB_AGENT_TOKEN が未設定。enroll は skip します"
@@ -154,17 +259,34 @@ do_install_service() {
   color_ok "install-service 完了。ログ: ~/.hub/agent.log"
 }
 
+macos_perm_guidance() {
+  [[ "$(uname)" != "Darwin" ]] && return 0
+  cat <<'EOF'
+
+📣 macOS の権限ダイアログについて
+  hub-agent は tmux/pty を中継するため、初回起動時に macOS から
+  「node がローカルネットワーク上の機器を検出することを求めています」
+  「node がアクセシビリティを制御することを求めています」
+  などのダイアログが出る場合があります。すべて「許可」を選んでください。
+  許可は「システム設定 > プライバシーとセキュリティ」から後で変更できます。
+
+EOF
+}
+
 main() {
   color_step "hub-agent ワンライナーセットアップを開始"
   ensure_brew
   ensure_pkg tmux tmux tmux
   ensure_node_version
+  ensure_npm_user_prefix
   ensure_global_install
+  ensure_claude_code
   do_enroll
   do_install_service
   echo ""
   color_ok "セットアップ完了。Hub UI で online 表示を確認してください"
   echo "    https://hub.cocorograph.com/user/cockpit/agents"
+  macos_perm_guidance
 }
 
 main "$@"

package/src/main.mjs

@@ -137,8 +137,34 @@ export async function startDaemon({ version, ptyModule } = {}) {
     client.send({ type: "pty.exit", stream_id, code })
   })
 
-  client.on("message", async (msg) => {
-    await dispatch(msg, { ...ctx, client, ptyBridge })
+  // Hub からのメッセージ dispatch は **直列実行** する。
+  //
+  // `EventEmitter.emit` は async リスナーの完了を待たないため、`async (msg) =>
+  // await dispatch(msg, ...)` の形だと複数 WS メッセージが連続して届いたとき
+  // それぞれの dispatch が並列実行される。`tmux.exec` の `await execTmux`
+  // (subprocess 待ち) 中に後続 `pty.data` の同期 `ptyBridge.write` が先行する
+  // と、ブラウザ→Hub では順序が保証されていても agent 内部で逆転する。
+  //
+  // 典型的な被害: cockpit ChatInput の `await onCancelTmuxMode()` → paste
+  // の流れで、ブラウザ側が cancel の応答を待ってから paste を送っても、
+  // 別経路の `tmux.exec` (state loop の polling 等) で agent が busy だと、
+  // cancel の execTmux が完了する前に paste が ptyBridge.write される。
+  // 結果として paste が tmux 内部状態 (copy mode 等) を抜ける前に届き、
+  // claude TUI に正しく入らない事象が散発する。
+  //
+  // Promise chain で前の dispatch 完了を待ってから次を始めることで、WS
+  // 受信順 = pane 反映順を保証する。pty 出力 (agent → browser) は別経路
+  // (`ptyBridge.on("output")`) なのでこの直列化の影響を受けない。
+  let dispatchChain = Promise.resolve()
+  client.on("message", (msg) => {
+    dispatchChain = dispatchChain
+      .then(() => dispatch(msg, { ...ctx, client, ptyBridge }))
+      .catch((err) => {
+        logger.error(
+          { err: err.message, type: msg?.type },
+          "dispatch threw in serial queue",
+        )
+      })
   })
 
   client.connect()

package/src/service-install.mjs

@@ -9,7 +9,7 @@
  * テンプレ内の __HUB_AGENT_BIN__ / __HOME__ / __PATH__ を実行時に置換する。
  * 仕様書: ナレッジ/インフラ/cockpit-hub-hosted-integration-spec (id=6080)
  */
-import { promises as fs } from "node:fs"
+import { promises as fs, existsSync, realpathSync } from "node:fs"
 import os from "node:os"
 import path from "node:path"
 import { spawnSync } from "node:child_process"
@@ -63,10 +63,59 @@ function run(cmd, args, opts = {}) {
   }
 }
 
+/**
+ * `which hub-agent` の結果を、launchd / systemd から長期間 exec 可能な
+ * 安定パスに正規化する。pure 関数。`opts` で fs を差し替えてテスト可能。
+ *
+ * 背景: fnm 利用者の `which hub-agent` は現在のシェル専用の一時パス
+ * (`~/.local/state/fnm_multishells/<PID>_<ts>/bin/hub-agent`) を返す。
+ * それを plist に書き込むと、install-service を叩いたシェル終了後に
+ * symlink が消えて launchd が exec できず、agent が無音で停止する事故が
+ * 発生する (2026-05-19, シェル PID 4683 で install したまま放置されて
+ * 検知が遅れた)。
+ *
+ * 優先順:
+ *   1. fnm default alias `~/.local/share/fnm/aliases/default/bin/hub-agent`
+ *      が存在すればそれを返す (fnm 利用者にとって最も安定)
+ *   2. whichPath が `/fnm_multishells/` を含むなら realpath で
+ *      `~/.local/share/fnm/node-versions/vX.Y.Z/.../bin/hub-agent.mjs`
+ *      に展開 (node アップグレード前提でも install-service 再実行で済む)
+ *   3. それ以外 (brew / nvm / 通常 PATH) は whichPath をそのまま返す
+ */
+function normalizeBinPath(whichPath, opts = {}) {
+  const home = opts.home ?? os.homedir()
+  const fileExists = opts.fileExists ?? existsSync
+  const resolveReal = opts.realpath ?? realpathSync
+
+  const fnmDefaultBin = path.join(
+    home,
+    ".local",
+    "share",
+    "fnm",
+    "aliases",
+    "default",
+    "bin",
+    "hub-agent",
+  )
+  if (fileExists(fnmDefaultBin)) return fnmDefaultBin
+
+  if (!whichPath) return null
+  if (whichPath.includes("/fnm_multishells/")) {
+    try {
+      return resolveReal(whichPath)
+    } catch {
+      // realpath 失敗時は whichPath をそのまま返す (既存挙動の保持)
+    }
+  }
+  return whichPath
+}
+
 /** インストール先の hub-agent CLI のフルパスを返す。`hub-agent` が PATH にある前提。 */
 function detectHubAgentBin() {
   const r = spawnSync("/usr/bin/which", ["hub-agent"], { encoding: "utf-8" })
-  if (r.status === 0 && r.stdout.trim()) return r.stdout.trim()
+  const whichPath = r.status === 0 && r.stdout ? r.stdout.trim() : null
+  const normalized = normalizeBinPath(whichPath)
+  if (normalized) return normalized
   // fallback: node $repo/bin/hub-agent.mjs
   return path.join(path.dirname(fileURLToPath(import.meta.url)), "..", "bin", "hub-agent.mjs")
 }
@@ -179,6 +228,7 @@ export async function uninstallService() {
 export const _internal = {
   expandTemplate,
   detectHubAgentBin,
+  normalizeBinPath,
   macPlistPath,
   linuxUnitPath,
   repoTemplatesDir,