@cocorograph/hub-agent 0.5.20 → 0.5.23

package/package.json

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

package/scripts/install.sh

@@ -32,18 +32,40 @@ color_err()  { printf "\033[1;31m✗ %s\033[0m\n" "$1" >&2; }
 
 present() { command -v "$1" >/dev/null 2>&1; }
 
+# 現在 PATH にある brew が、このユーザーで書き込み可能か判定する。
+# 「brew はあるが Cellar が他ユーザー所有で書き込み不可」というケースを検知して
+# user-local Homebrew にフォールバックするための判定関数。
+_existing_brew_writable() {
+  local prefix
+  prefix="$(brew --prefix 2>/dev/null || echo '')"
+  [[ -z "$prefix" ]] && return 1
+  # Cellar / opt が書き込み可能か（または未作成でも prefix 自体が書き込み可能か）
+  if [[ -w "$prefix/Cellar" ]] || ( [[ ! -e "$prefix/Cellar" ]] && [[ -w "$prefix" ]] ); then
+    return 0
+  fi
+  return 1
+}
+
 ensure_brew() {
   if [[ "$(uname)" != "Darwin" ]]; then return 0; fi
+
+  # 既に brew がインストールされている場合の判定:
+  # - ユーザーが書き込み可能 → そのまま使用（system / user-local どちらでも OK）
+  # - 書き込み不可（他ユーザー所有の brew が居る）→ $HOME/homebrew に並列で user-local 化
   if present brew; then
-    color_ok "brew already installed"
-    persist_brew_shellenv
+    if _existing_brew_writable; then
+      color_ok "brew already installed and writable ($(brew --prefix))"
+      persist_brew_shellenv
+      return 0
+    fi
+    color_warn "既存 brew ($(brew --prefix 2>/dev/null)) は書き込み不可 → \$HOME/homebrew にユーザーローカル Homebrew を並列インストール"
+    _install_user_local_brew
     return 0
   fi
 
-  # 管理者権限の有無を判定して user-mode に切り替える。
+  # brew コマンドが PATH にない場合の判定:
   # - 環境変数 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
@@ -54,11 +76,7 @@ ensure_brew() {
   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
+    _install_user_local_brew
   else
     color_step "Homebrew をシステムインストール"
     /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
@@ -71,11 +89,32 @@ ensure_brew() {
   present brew || { color_err "brew install failed"; exit 1; }
 }
 
+# user-local Homebrew のインストール本体（重複排除のため関数化）。
+# 既に $HOME/homebrew が展開済みなら再展開せず PATH/shellenv だけ整える。
+_install_user_local_brew() {
+  if [[ -x "$HOME/homebrew/bin/brew" ]]; then
+    color_ok "\$HOME/homebrew は既に展開済み"
+  else
+    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"
+  fi
+  # PATH を user-local 優先で並べる（既存 /usr/local/bin/brew より先）
+  export PATH="$HOME/homebrew/bin:$PATH"
+  hash -r 2>/dev/null || true  # bash のコマンドキャッシュをクリア
+  persist_user_brew_shellenv
+}
+
 # Apple Silicon Mac で brew のパスを zsh / bash 永続化する。既に追記済みなら no-op。
 # `eval "$(/opt/homebrew/bin/brew shellenv)"` を書くことで、Homebrew が用意する
 # HOMEBREW_PREFIX / PATH / MANPATH / INFOPATH すべてを新規シェルで自動セットする。
 persist_brew_shellenv() {
   local brew_bin=""
+  # $HOME/homebrew が PATH 上で優先されているなら、user-local 側で永続化する
+  if [[ -x "$HOME/homebrew/bin/brew" ]] && [[ "$(command -v brew)" == "$HOME/homebrew/bin/brew" ]]; then
+    persist_user_brew_shellenv
+    return 0
+  fi
   if [[ -x /opt/homebrew/bin/brew ]]; then
     brew_bin="/opt/homebrew/bin/brew"
   elif [[ -x /usr/local/bin/brew ]]; then
@@ -261,15 +300,26 @@ do_install_service() {
 
 macos_perm_guidance() {
   [[ "$(uname)" != "Darwin" ]] && return 0
-  cat <<'EOF'
+  # 現在 PATH 上の node 実体パスを案内に埋め込む（フルディスクアクセス登録時に役立つ）
+  local node_path
+  node_path="$(command -v node 2>/dev/null || echo '/path/to/node')"
+  cat <<EOF
 
 📣 macOS の権限ダイアログについて
   hub-agent は tmux/pty を中継するため、初回起動時に macOS から
   「node がローカルネットワーク上の機器を検出することを求めています」
   「node がアクセシビリティを制御することを求めています」
+  「node がほかのアプリからのデータへのアクセス権を求めています」
   などのダイアログが出る場合があります。すべて「許可」を選んでください。
   許可は「システム設定 > プライバシーとセキュリティ」から後で変更できます。
 
+  ▶ ダイアログが頻繁に出る場合（特に Claude Code 経由で様々な cwd を使う場合）:
+    「フルディスクアクセス」に node 本体を追加すると静かになります。
+      システム設定 > プライバシーとセキュリティ > フルディスクアクセス
+      → ＋ ボタンで以下のパスを追加:
+        ${node_path}
+    （node バイナリパスが変わったら再登録が必要です）
+
 EOF
 }
 

package/src/main.mjs

@@ -32,6 +32,8 @@ import {
   killManySessions,
   killSession as killTmuxSession,
   listSessions as listTmuxSessions,
+  listWorktreeStubs,
+  removeWorktree as removeWorktreeDir,
 } from "./tmux.mjs"
 import { getSessionUsages, getUsage } from "./usage.mjs"
 
@@ -506,16 +508,28 @@ async function dispatch(msg, ctx) {
             ...s,
             last_event: lastEventByName.get(s.name) || null,
           }))
+          // cockpit (PR 1719) で未起動 worktree をサイドバーに可視化するために
+          // filesystem 上は存在するが tmux session が無い worktree dir のリストを
+          // 同梱する。古い cockpit は worktree_stubs を無視するので互換 OK。
+          const liveNames = new Set(enriched.map((s) => s.name))
+          let worktreeStubs = []
+          try {
+            worktreeStubs = await listWorktreeStubs(liveNames)
+          } catch (err) {
+            ctx.logger?.warn?.({ err: err?.message }, "listWorktreeStubs failed")
+          }
           ctx.client.send({
             type: "tmux.sessions",
             request_id: msg.request_id,
             sessions: enriched,
+            worktree_stubs: worktreeStubs,
           })
         } catch (err) {
           ctx.client.send({
             type: "tmux.sessions",
             request_id: msg.request_id,
             sessions: [],
+            worktree_stubs: [],
             error: err.message,
           })
         }
@@ -612,6 +626,39 @@ async function dispatch(msg, ctx) {
         }
         return
       }
+      case "worktree.remove": {
+        // body: { request_id, name }
+        // cockpit (PR 1719) のサイドバー削除ボタンから呼ばれる。
+        // git worktree remove --force を実行し、走行中 session があれば事前に kill する。
+        const name = (msg.name || "").trim()
+        if (!name) {
+          ctx.client.send({
+            type: "worktree.remove.result",
+            request_id: msg.request_id,
+            ok: false,
+            error: "name required",
+          })
+          return
+        }
+        try {
+          const { name: removedName, wt_path: wtPath } = await removeWorktreeDir(name)
+          ctx.client.send({
+            type: "worktree.remove.result",
+            request_id: msg.request_id,
+            ok: true,
+            name: removedName,
+            wt_path: wtPath,
+          })
+        } catch (err) {
+          ctx.client.send({
+            type: "worktree.remove.result",
+            request_id: msg.request_id,
+            ok: false,
+            error: err.message,
+          })
+        }
+        return
+      }
       case "tmux.kill_session": {
         const names = Array.isArray(msg.session_names)
           ? msg.session_names

package/src/tmux.mjs

@@ -142,14 +142,19 @@ export async function createWorktreeDir(parentDir, branch) {
 
 /**
  * `~/hub/projects/<project>/.claude/worktrees/<wt>` を走査し、
- * worktree_session_name → parent_session_name の Map を返す。
+ * worktree session 名 → 詳細情報の Map を返す。
  *
  * - 各 worktree dir は `.git` ファイル/ディレクトリの存在で git worktree と判定
  * - session 名はディレクトリ名を sanitize したもの (tmux session 名命名規則)
  *
+ * 戻り値は `{ parent_session_name, cwd, branch }` の dict。cockpit (cockpit
+ * worktree-discovery PR 1719) が tmux.list_sessions 応答に worktree_stubs として
+ * 同梱するために branch / cwd まで返す。`branch` は `git -C <wtPath> branch
+ * --show-current` を best-effort で取る。
+ *
  * 移植元: D00000_cockpit/webapp/lib/workspaces.ts (findWorktrees)
  */
-async function buildWorktreeParentMap() {
+async function buildWorktreeIndex() {
   const out = new Map()
   const projectsBase = hubProjectsBase()
   let projects
@@ -169,17 +174,99 @@ async function buildWorktreeParentMap() {
     }
     for (const wt of wts) {
       if (!wt.isDirectory() || wt.name.startsWith(".")) continue
+      const wtPath = path.join(wtBase, wt.name)
       try {
         // .git が存在する = 正規 git worktree
-        await fs.stat(path.join(wtBase, wt.name, ".git"))
+        await fs.stat(path.join(wtPath, ".git"))
       } catch {
         continue
       }
-      out.set(sanitizeTmuxName(wt.name), sanitizeTmuxName(p.name))
+      let branch = null
+      try {
+        const r = await execFileP("git", ["-C", wtPath, "branch", "--show-current"])
+        branch = (r.stdout || "").trim() || null
+      } catch {
+        // best-effort: detached / 取得失敗時は null のままにする
+      }
+      const sessionName = sanitizeTmuxName(wt.name)
+      out.set(sessionName, {
+        name: sessionName,
+        parent_session_name: sanitizeTmuxName(p.name),
+        cwd: wtPath,
+        branch,
+      })
     }
   }
   return out
 }
+
+/**
+ * 後方互換: 旧 `buildWorktreeParentMap` を `buildWorktreeIndex` で薄ラップ。
+ * Map<wtName, parentName> 形式を期待していた既存呼び出し (listSessions 内) 向け。
+ */
+async function buildWorktreeParentMap() {
+  const idx = await buildWorktreeIndex()
+  const out = new Map()
+  for (const [name, info] of idx) out.set(name, info.parent_session_name)
+  return out
+}
+
+/**
+ * 走行中の tmux session 名 set を受け取り、それに含まれない worktree (= 未起動 stub)
+ * のリストを返す。cockpit `tmux.sessions` 応答の `worktree_stubs` フィールドに乗せる
+ * ためのヘルパー。
+ */
+export async function listWorktreeStubs(liveSessionNames) {
+  const idx = await buildWorktreeIndex()
+  const stubs = []
+  for (const [name, info] of idx) {
+    if (liveSessionNames.has(name)) continue
+    stubs.push(info)
+  }
+  return stubs
+}
+
+/**
+ * `git worktree remove --force <wtPath>` を実行する。事前に live tmux session が
+ * あれば kill する。cockpit `worktree.remove` ハンドラから呼ばれる。
+ *
+ * - name から path を解決するには buildWorktreeIndex で fs を走査する (path 検証も兼ねる)
+ * - HUB_PROJECTS_BASE 配下に居ない path は拒否 (path traversal 防止)
+ * - 未コミットの変更等で git remove が失敗した場合はそのエラーを上位に投げる
+ */
+export async function removeWorktree(name, opts = {}) {
+  const sanitized = sanitizeTmuxName(String(name || "").trim())
+  if (!sanitized) throw new Error("worktree name required")
+  const idx = await buildWorktreeIndex()
+  const info = idx.get(sanitized)
+  if (!info) throw new Error("worktree not found")
+  const projectsBase = hubProjectsBase()
+  const resolved = path.resolve(info.cwd)
+  if (!resolved.startsWith(projectsBase + path.sep)) {
+    throw new Error("worktree path outside projects base")
+  }
+  // 走行中の 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
+    }
+  }
+  // 親 repo を解決し `git -C <parent> worktree remove --force <wtPath>` を実行
+  const wtSegment = path.join(".claude", "worktrees", path.basename(resolved))
+  const parentRepo = resolved.endsWith(wtSegment)
+    ? resolved.slice(0, -wtSegment.length - 1)
+    : path.resolve(resolved, "..", "..", "..")
+  await execFileP("git", ["-C", parentRepo, "worktree", "remove", "--force", resolved])
+  return { name: sanitized, wt_path: resolved }
+}
 /**
  * Claude CLI コマンドを組み立てる。
  *