@cocorograph/hub-agent 0.8.23 → 0.8.25

package/plugins/10-tailscale-remote/README.md

@@ -1,71 +0,0 @@
-# 10-tailscale-remote
-
-自宅 Mac (hub-agent host) を、Tailscale 等で繋がった会社 Mac (`remote_host`) の
-tmux に対する透過プロキシ化するサンプル plugin。
-
-## 何が起きるか
-
-| Browser action | 通常 (plugin 無し) | このプラグイン有効時 |
-|---|---|---|
-| `pty.attach` | ローカル `tmux attach -t SESSION` | `mosh remote_host -- tmux attach -t SESSION` |
-| `tmux.exec [...]` | ローカル `tmux ...` | `ssh remote_host tmux ...` |
-
-つまり、`hub.cocorograph.com/user/cockpit/terminal` から開くセッションが、
-あなたの手元 Mac ではなく `remote_host` の tmux に直接繋がります。Cockpit UI の
-`session.state` / `tmux.list_sessions` も全て `remote_host` 側の値です。
-
-## セットアップ
-
-1. ディレクトリを `~/.hub/plugins/10-tailscale-remote/` にコピー
-   ```bash
-   # CLI 経由 (推奨)
-   hub-agent plugins install 10-tailscale-remote
-
-   # 手動
-   mkdir -p ~/.hub/plugins/10-tailscale-remote
-   cp -r $(npm root -g)/@cocorograph/hub-agent/plugins/10-tailscale-remote/* \
-     ~/.hub/plugins/10-tailscale-remote/
-   ```
-
-2. `config.json` を編集
-   ```bash
-   cp ~/.hub/plugins/10-tailscale-remote/config.example.json \
-      ~/.hub/plugins/10-tailscale-remote/config.json
-   $EDITOR ~/.hub/plugins/10-tailscale-remote/config.json
-   ```
-
-   ```jsonc
-   {
-     "remote_host": "mbpm5-office",                       // ssh ホスト名
-     "ssh_key": "/Users/kaz/.ssh/mbpm5-office/id_ed25519",
-     "mosh_server": "/opt/homebrew/bin/mosh-server"       // remote_host 側のパス
-   }
-   ```
-
-3. remote 側の準備
-   - 同じユーザーで ssh 鍵ログイン可能であること
-   - `tmux` + `mosh-server` がインストール済みであること
-   - tmux session が既に走っていること (or `hub-agent` の `tmux.create_session` 経由で作る)
-
-4. hub-agent restart
-   ```bash
-   launchctl kickstart -k gui/$UID/co.cocorograph.hub-agent  # macOS
-   # or
-   systemctl --user restart hub-agent.service  # Linux
-   ```
-
-5. agent log で `tailscale-remote-ops 有効` の表示を確認
-   ```bash
-   tail -f ~/.hub/agent.log
-   ```
-
-## トラブルシューティング
-
-- `config.json` 無し → plugin は no-op で読み込まれます (`agent.log` に WARN)
-- ssh が「Host key verification failed」→ `ssh remote_host` で 1 度手動接続して known_hosts に追加
-- mosh が `Did not find mosh server startup message` → remote_host の `mosh_server` パスを確認 (`which mosh-server`)
-- Tailscale が落ちて remote_host に届かない → cockpit terminal を開くと WS 接続自体は成功するが pty が即 exit する
-
-## 仕様書
-
-[`ナレッジ/インフラ/cockpit-hub-hosted-integration-spec`](https://hub.cocorograph.com/knowledge/spec/cockpit-hub-hosted-integration-spec) (id=6080)

package/plugins/10-tailscale-remote/config.example.json

@@ -1,6 +0,0 @@
-{
-  "_comment": "このファイルを config.json にコピーしてから編集してください。",
-  "remote_host": "mbpm5-office",
-  "ssh_key": "/Users/kaz/.ssh/mbpm5-office/id_ed25519",
-  "mosh_server": "/opt/homebrew/bin/mosh-server"
-}

package/plugins/10-tailscale-remote/plugin.mjs

@@ -1,99 +0,0 @@
-/**
- * tailscale-remote: 自宅 Mac (hub-agent host) を 会社 Mac (remote_host) の
- * tmux に対する透過プロキシ化するプラグイン (Sprint K サンプル)。
- *
- * - `interceptPtySpawn`: ブラウザの attach を mosh + ssh + tmux attach に差し替え
- * - `interceptTmuxExec`: tmux.* RPC (list/create/kill 等) を ssh 越しに発行
- *
- * 使い方:
- *   1. `~/.hub/plugins/10-tailscale-remote/` にこのファイル + config.json を置く
- *      (`hub-agent plugins install 10-tailscale-remote` で自動コピー可)
- *   2. config.json の remote_host / ssh_key / mosh_server を埋める
- *   3. hub-agent restart (`hub-agent install-service` してあれば
- *      `launchctl kickstart -k gui/$UID/co.cocorograph.hub-agent`)
- *
- * 仕様書: ナレッジ/インフラ/cockpit-hub-hosted-integration-spec (id=6080)
- */
-import { readFileSync } from "node:fs"
-
-const cfgUrl = new URL("./config.json", import.meta.url)
-let cfg = { remote_host: "", ssh_key: "", mosh_server: "/opt/homebrew/bin/mosh-server" }
-try {
-  cfg = { ...cfg, ...JSON.parse(readFileSync(cfgUrl, "utf-8")) }
-} catch (err) {
-  // config.json が無い場合は plugin を no-op で読み込む (hook は何も上書きしない)
-  // user が編集してから restart する想定
-  cfg.__error = err.message
-}
-
-function isConfigured() {
-  return Boolean(cfg.remote_host && cfg.ssh_key && !cfg.__error)
-}
-
-function sshOpts() {
-  return ["-o", "IdentityAgent=none", "-i", cfg.ssh_key]
-}
-
-export default {
-  name: "tailscale-remote-ops",
-  hooks: {
-    async onAgentStart({ logger }) {
-      if (cfg.__error) {
-        logger?.warn(
-          { err: cfg.__error },
-          "tailscale-remote-ops: config.json が読めません。plugin は no-op で動作します",
-        )
-        return
-      }
-      if (!isConfigured()) {
-        logger?.warn(
-          { config: cfg },
-          "tailscale-remote-ops: remote_host / ssh_key が未設定。plugin は no-op",
-        )
-        return
-      }
-      logger?.info(
-        { remote_host: cfg.remote_host },
-        "tailscale-remote-ops 有効: pty.attach / tmux.exec を ssh 越しに発行します",
-      )
-    },
-
-    /**
-     * Browser からの attach を mosh + ssh + tmux attach に差し替える。
-     * pty bridge は通常通り node-pty で /bin/sh を spawn するが、その中身が
-     * remote_host への mosh ssh セッションになる。
-     */
-    async interceptPtySpawn({ sessionName }) {
-      if (!isConfigured()) return null
-      const sshOpt = sshOpts().join(" ")
-      const command = "/bin/sh"
-      const inner = [
-        `exec mosh`,
-        `--predict=adaptive`,
-        `--server=${cfg.mosh_server}`,
-        `--ssh="ssh ${sshOpt}"`,
-        cfg.remote_host,
-        `--`,
-        `bash -l -c "tmux attach -t ${sessionName}"`,
-      ].join(" ")
-      return {
-        command,
-        args: ["-c", inner],
-      }
-    },
-
-    /**
-     * tmux.* RPC (list-sessions / new-session / kill-session 等) を
-     * ssh 越しに remote_host で実行する。
-     */
-    async interceptTmuxExec({ args }) {
-      if (!isConfigured()) return null
-      return {
-        command: "ssh",
-        args: [...sshOpts(), cfg.remote_host, "tmux", ...args],
-      }
-    },
-  },
-}
-
-export const _internal = { cfg, isConfigured, sshOpts }

package/scripts/fix-node-pty-perms.mjs

@@ -1,89 +0,0 @@
-#!/usr/bin/env node
-// pnpm 経由インストールだと prebuilds/*/spawn-helper の実行権限が剥がれて
-// posix_spawnp が失敗する事象への workaround. postinstall で確実に +x を付与する。
-//
-// PTY backend は @lydell/node-pty (Microsoft 公式の fd-leak 修正フォーク) に移行済み。
-// prebuild は @lydell/node-pty-<platform>/prebuilds/<platform>/spawn-helper に入る
-// (npm install では +x 付きで展開されるが、pnpm 等で剥がれるケースに備えて修復する)。
-// 旧 node-pty の配置も後方互換で走査する。
-import { readdirSync, statSync, chmodSync } from "node:fs";
-import { join } from "node:path";
-
-const PNPM_GLOB = "node_modules/.pnpm";
-// prebuilds ディレクトリの候補 (node-pty 旧配置 + @lydell platform パッケージ)。
-const FALLBACK_DIRS = ["node_modules/node-pty/prebuilds"];
-
-function fixDir(dir) {
-  let count = 0;
-  for (const platform of readdirSync(dir)) {
-    const helper = join(dir, platform, "spawn-helper");
-    try {
-      const st = statSync(helper);
-      if (!(st.mode & 0o111)) {
-        chmodSync(helper, st.mode | 0o755);
-        console.log(`[fix-perms] chmod +x ${helper}`);
-        count++;
-      }
-    } catch {
-      // not present (e.g. win32 dir has no spawn-helper)
-    }
-  }
-  return count;
-}
-
-// @lydell の platform パッケージ (@lydell/node-pty-darwin-arm64 等) を走査する。
-function findLydellPrebuilds() {
-  const out = [];
-  const scopeDir = "node_modules/@lydell";
-  try {
-    for (const entry of readdirSync(scopeDir)) {
-      if (!entry.startsWith("node-pty-")) continue; // platform バイナリパッケージのみ
-      const p = join(scopeDir, entry, "prebuilds");
-      try {
-        statSync(p);
-        out.push(p);
-      } catch { /* prebuilds 無し */ }
-    }
-  } catch { /* @lydell scope 無し */ }
-  return out;
-}
-
-function findPnpmPrebuilds() {
-  const out = [];
-  try {
-    for (const entry of readdirSync(PNPM_GLOB)) {
-      let inner = null;
-      if (entry.startsWith("node-pty@")) {
-        // 旧 node-pty: node_modules/.pnpm/node-pty@x/node_modules/node-pty/prebuilds
-        inner = "node_modules/node-pty/prebuilds";
-      } else if (entry.startsWith("@lydell+node-pty-")) {
-        // @lydell platform: @lydell+node-pty-darwin-arm64@x → pkg 名 = node-pty-darwin-arm64
-        const pkg = entry.slice("@lydell+".length).split("@")[0];
-        inner = join("node_modules/@lydell", pkg, "prebuilds");
-      } else {
-        continue;
-      }
-      const p = join(PNPM_GLOB, entry, inner);
-      try {
-        statSync(p);
-        out.push(p);
-      } catch { /* skip */ }
-    }
-  } catch { /* no pnpm dir */ }
-  return out;
-}
-
-let fixed = 0;
-for (const dir of [...findPnpmPrebuilds(), ...findLydellPrebuilds()]) {
-  fixed += fixDir(dir);
-}
-for (const fallback of FALLBACK_DIRS) {
-  try {
-    statSync(fallback);
-    fixed += fixDir(fallback);
-  } catch { /* not hoisted */ }
-}
-
-if (fixed === 0) {
-  // 何も修正しなかった = 既に OK or node-pty 未インストール。サイレント終了。
-}

package/src/plugin-install.mjs

@@ -1,111 +0,0 @@
-/**
- * `hub-agent plugins install <name>` / `uninstall <name>` の実装 (Sprint K)。
- *
- * リポ同梱の `plugins/<name>/` を `~/.hub/plugins/<name>/` にコピーする。
- * uninstall は `~/.hub/plugins/<name>/` を rm -rf する。
- *
- * config.json は plugin によって user 編集が必要なため、existing なら上書き
- * しない (force オプションで強制可)。
- */
-import { promises as fs } from "node:fs"
-import path from "node:path"
-import { fileURLToPath } from "node:url"
-
-import { paths as configPaths } from "./config.mjs"
-
-function repoPluginsDir() {
-  return path.join(path.dirname(fileURLToPath(import.meta.url)), "..", "plugins")
-}
-
-export async function listInstallableExamples() {
-  const dir = repoPluginsDir()
-  let entries
-  try {
-    entries = await fs.readdir(dir, { withFileTypes: true })
-  } catch {
-    return []
-  }
-  const out = []
-  for (const e of entries) {
-    if (!e.isDirectory()) continue
-    const pluginFile = path.join(dir, e.name, "plugin.mjs")
-    try {
-      await fs.access(pluginFile)
-      out.push(e.name)
-    } catch {
-      /* plugin.mjs 無いディレクトリは skip */
-    }
-  }
-  return out
-}
-
-async function copyDir(src, dest, { skipExisting = [] } = {}) {
-  await fs.mkdir(dest, { recursive: true, mode: 0o700 })
-  const entries = await fs.readdir(src, { withFileTypes: true })
-  for (const e of entries) {
-    const s = path.join(src, e.name)
-    const d = path.join(dest, e.name)
-    if (e.isDirectory()) {
-      await copyDir(s, d, { skipExisting })
-    } else {
-      if (skipExisting.includes(e.name)) {
-        try {
-          await fs.access(d)
-          continue // 既存ならコピーしない (user 編集を尊重)
-        } catch {
-          /* fall through to copy */
-        }
-      }
-      await fs.copyFile(s, d)
-    }
-  }
-}
-
-/** @returns {Promise<{ source: string, dest: string, copied: boolean }>} */
-export async function installPlugin(name, { force = false } = {}) {
-  if (!name || typeof name !== "string") {
-    throw new Error("plugin name is required")
-  }
-  const src = path.join(repoPluginsDir(), name)
-  try {
-    const st = await fs.stat(src)
-    if (!st.isDirectory()) throw new Error("not a directory")
-  } catch {
-    const available = await listInstallableExamples()
-    const hint = available.length ? ` Available: ${available.join(", ")}` : ""
-    throw new Error(`plugin "${name}" not found in repo plugins/.${hint}`)
-  }
-  const dest = path.join(configPaths.pluginsDir, name)
-  if (!force) {
-    try {
-      await fs.access(dest)
-      throw new Error(
-        `${dest} already exists. Pass --force to overwrite (config.json は常に温存)`,
-      )
-    } catch (err) {
-      if (err.code !== "ENOENT") {
-        // dest exists かつ force でない
-        if (err.message && err.message.includes("already exists")) throw err
-        if (err.code !== undefined) throw err
-      }
-    }
-  }
-  // config.json は既存なら skip して user 編集を温存
-  await copyDir(src, dest, { skipExisting: ["config.json"] })
-  return { source: src, dest, copied: true }
-}
-
-export async function uninstallPlugin(name) {
-  if (!name || typeof name !== "string") {
-    throw new Error("plugin name is required")
-  }
-  const dest = path.join(configPaths.pluginsDir, name)
-  try {
-    await fs.rm(dest, { recursive: true, force: true })
-  } catch (err) {
-    throw new Error(`failed to remove ${dest}: ${err.message}`)
-  }
-  return { dest, removed: true }
-}
-
-export const _internal = { repoPluginsDir, copyDir }