@cocorograph/hub-agent 0.5.21 → 0.5.24

package/package.json

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

package/scripts/install.sh

@@ -21,7 +21,17 @@
 
 set -euo pipefail
 
-NODE_MIN_MAJOR=20
+# Node.js のサポート範囲ポリシー（Active LTS のみ）。
+# - 既存 node のメジャーが [MIN, MAX] に収まっていれば現状維持
+# - 範囲外なら NODE_DEFAULT_BREW_FORMULA (最新 Active LTS) にアップ / ダウングレード
+# 2026-05 時点の LTS スケジュール:
+#   - node 22: Active LTS → 2027/04 EoL
+#   - node 24: Active LTS → 2028/04 EoL（最新、サポート期間最長）
+#   - node 26: current（LTS ではない、SSL/CA 周りの問題報告あり）
+NODE_MIN_MAJOR=22
+NODE_MAX_MAJOR=24
+NODE_DEFAULT_BREW_FORMULA="node@24"
+
 PACKAGE_NAME="@cocorograph/hub-agent"
 CLAUDE_CODE_PACKAGE="@anthropic-ai/claude-code"
 
@@ -225,23 +235,55 @@ ensure_pkg() {
   fi
 }
 
+# macOS で brew 経由で Active LTS の node (NODE_DEFAULT_BREW_FORMULA) を導入/切替する。
+# 既存の無印 node が link されていれば unlink してから新 formula を link --overwrite --force。
+_install_node_lts_brew() {
+  local formula="$NODE_DEFAULT_BREW_FORMULA"
+  color_step "$formula (Active LTS) を install"
+  brew install "$formula"
+  # 既存無印 node が link されていれば外す（v26 current 等を退かす）
+  if brew list node >/dev/null 2>&1; then
+    color_step "既存 'node' formula を unlink ($formula を優先するため)"
+    brew unlink node 2>/dev/null || true
+  fi
+  color_step "$formula を link --overwrite --force"
+  brew link --overwrite --force "$formula"
+  hash -r 2>/dev/null || true
+}
+
+# Node.js のサポート範囲ポリシー判定。
+# - 未インストール → LTS を install
+# - [MIN, MAX] 範囲内 → 現状維持（ユーザーの環境を尊重）
+# - 範囲未満 → LTS にアップグレード
+# - 範囲超過（current 系等） → LTS にダウングレード
 ensure_node_version() {
   local v
   v=$(node --version 2>/dev/null | sed 's/^v//' | cut -d. -f1)
   if [[ -z "$v" ]]; then
-    ensure_pkg node node nodejs
-    return
-  fi
-  if (( v < NODE_MIN_MAJOR )); then
-    color_warn "node $v は古いです (>=${NODE_MIN_MAJOR} 必須)。brew で更新を試みます"
+    color_step "node が未インストール → $NODE_DEFAULT_BREW_FORMULA (Active LTS) を install"
     if [[ "$(uname)" == "Darwin" ]]; then
-      brew upgrade node || brew install node
+      _install_node_lts_brew
     else
-      color_err "Node ${NODE_MIN_MAJOR}+ を手動で install してください (nvm 推奨)"
-      exit 1
+      ensure_pkg node node nodejs
     fi
+    return
+  fi
+
+  if (( v >= NODE_MIN_MAJOR && v <= NODE_MAX_MAJOR )); then
+    color_ok "node v$v は動作保証範囲 (${NODE_MIN_MAJOR} ≤ v ≤ ${NODE_MAX_MAJOR}) 内。現状維持"
+    return
+  fi
+
+  if (( v < NODE_MIN_MAJOR )); then
+    color_warn "node v$v は古い (>=${NODE_MIN_MAJOR} 必須) → $NODE_DEFAULT_BREW_FORMULA にアップグレード"
   else
-    color_ok "node $v"
+    color_warn "node v$v は新しすぎ (current 系) → 安定動作のため $NODE_DEFAULT_BREW_FORMULA (LTS) にダウングレード"
+  fi
+  if [[ "$(uname)" == "Darwin" ]]; then
+    _install_node_lts_brew
+  else
+    color_err "Node $NODE_MIN_MAJOR〜$NODE_MAX_MAJOR の LTS を手動で install してください (nvm 推奨)"
+    exit 1
   fi
 }
 
@@ -300,15 +342,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 コマンドを組み立てる。
  *