@cocorograph/hub-agent 0.5.21 → 0.5.23

package/package.json

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

package/scripts/install.sh

@@ -300,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 コマンドを組み立てる。
  *