@cocorograph/hub-agent 0.4.1

package/src/pty-bridge.mjs

@@ -0,0 +1,176 @@
+/**
+ * node-pty ベースの pty 多重化ブリッジ (Sprint D)。
+ *
+ * - 1 agent プロセス内で複数 stream を `Map<stream_id, PtyProcess>` で管理
+ * - `attach()` で pty を spawn (plugin `interceptPtySpawn` が override 可)
+ * - `write()` / `resize()` / `detach()` は stream_id で個別操作
+ * - pty 出力は `'output'` イベント、終了は `'exit'` イベントで EventEmitter 経由
+ *
+ * デフォルト spawn は `tmux attach -t <session_name>` (Sprint E で tmux モジュール
+ * が attach 前に session が存在することを保証する想定)。
+ *
+ * 仕様書: ナレッジ/インフラ/cockpit-hub-hosted-integration-spec (id=6080)
+ * 移植元: D00000_cockpit/webapp/server/ws-server.mjs
+ */
+import { EventEmitter } from "node:events"
+import { execFileSync } from "node:child_process"
+
+import { runHookChain } from "./plugin-loader.mjs"
+
+const DEFAULT_COLS = 120
+const DEFAULT_ROWS = 32
+
+function resolveBin(name) {
+  try {
+    return execFileSync("/usr/bin/which", [name], { encoding: "utf-8" }).trim()
+  } catch {
+    return name
+  }
+}
+
+let _tmuxBin = null
+function tmuxBin() {
+  if (_tmuxBin === null) _tmuxBin = resolveBin("tmux")
+  return _tmuxBin
+}
+
+export class PtyBridge extends EventEmitter {
+  /**
+   * @param {object} opts
+   * @param {object} opts.ptyModule - `await import('node-pty')` の結果 (テストで stub 注入可)
+   * @param {import('pino').Logger} [opts.logger]
+   * @param {Array} [opts.plugins] - plugin-loader.mjs の loadPlugins() 結果
+   * @param {(args: {sessionName: string, cols: number, rows: number, env: object}) => {command: string, args: string[], env?: object}} [opts.defaultSpawnCommand]
+   *   - plugin が null を返したときに使うデフォルト spawn 仕様。省略時は
+   *     `/bin/sh -c "exec tmux attach -t <sessionName>"`
+   */
+  constructor({ ptyModule, logger, plugins = [], defaultSpawnCommand } = {}) {
+    super()
+    if (!ptyModule || typeof ptyModule.spawn !== "function") {
+      throw new TypeError("PtyBridge requires { ptyModule: { spawn } }")
+    }
+    this.ptyModule = ptyModule
+    this.logger = logger
+    this.plugins = plugins
+    this.defaultSpawnCommand =
+      defaultSpawnCommand ||
+      (({ sessionName }) => ({
+        command: "/bin/sh",
+        args: ["-c", `exec ${tmuxBin()} attach -t ${sessionName}`],
+        env: process.env,
+      }))
+    /** @type {Map<string, import('node-pty').IPty>} */
+    this.streams = new Map()
+  }
+
+  /**
+   * 新しい pty を spawn して stream_id に紐付ける。
+   *
+   * @param {{stream_id: string, sessionName?: string, cols?: number, rows?: number, env?: object}} args
+   * @returns {Promise<{plugin: string|null, command: string, args: string[]}>}
+   */
+  async attach({ stream_id, sessionName = "", cols = DEFAULT_COLS, rows = DEFAULT_ROWS, env }) {
+    if (!stream_id) throw new TypeError("attach requires stream_id")
+    if (this.streams.has(stream_id)) {
+      throw new Error(`stream_id "${stream_id}" は既に attach 済みです`)
+    }
+    const ctx = {
+      logger: this.logger,
+      sessionName,
+      cols,
+      rows,
+      env: env || process.env,
+    }
+
+    const hookResult = await runHookChain(this.plugins, "interceptPtySpawn", ctx)
+    const spec = hookResult?.result ?? this.defaultSpawnCommand(ctx)
+
+    let pty
+    try {
+      pty = this.ptyModule.spawn(spec.command, spec.args, {
+        name: "xterm-256color",
+        cols,
+        rows,
+        cwd: spec.env?.HOME || process.env.HOME,
+        env: spec.env || process.env,
+      })
+    } catch (err) {
+      this.logger?.error(
+        { stream_id, command: spec.command, err: err.message },
+        "pty spawn failed",
+      )
+      throw err
+    }
+
+    this.streams.set(stream_id, pty)
+    this.logger?.info(
+      { stream_id, sessionName, command: spec.command, plugin: hookResult?.plugin || null },
+      "pty attached",
+    )
+
+    pty.onData((data) => {
+      this.emit("output", { stream_id, data })
+    })
+    pty.onExit(({ exitCode }) => {
+      this.streams.delete(stream_id)
+      this.emit("exit", { stream_id, code: exitCode })
+    })
+
+    return {
+      plugin: hookResult?.plugin || null,
+      command: spec.command,
+      args: spec.args,
+    }
+  }
+
+  /** ブラウザから来た入力を pty に流す。 */
+  write({ stream_id, data }) {
+    const pty = this.streams.get(stream_id)
+    if (!pty) {
+      this.logger?.warn({ stream_id }, "pty.write but stream missing")
+      return false
+    }
+    pty.write(data)
+    return true
+  }
+
+  /** ターミナルサイズ変更。 */
+  resize({ stream_id, cols, rows }) {
+    const pty = this.streams.get(stream_id)
+    if (!pty) {
+      this.logger?.warn({ stream_id }, "pty.resize but stream missing")
+      return false
+    }
+    try {
+      pty.resize(cols, rows)
+      return true
+    } catch (err) {
+      this.logger?.warn({ stream_id, err: err.message }, "pty.resize failed")
+      return false
+    }
+  }
+
+  /** pty を kill する。tmux session 自体は残る (detach 相当)。 */
+  detach({ stream_id }) {
+    const pty = this.streams.get(stream_id)
+    if (!pty) return false
+    try {
+      pty.kill()
+    } catch {
+      /* ignore — onExit で Map から消える */
+    }
+    return true
+  }
+
+  /** 全 pty を即時 kill (agent shutdown 用)。 */
+  shutdown() {
+    for (const stream_id of Array.from(this.streams.keys())) {
+      this.detach({ stream_id })
+    }
+  }
+
+  /** 現在 attach 中の stream_id 一覧 (debug 用)。 */
+  list() {
+    return Array.from(this.streams.keys())
+  }
+}

package/src/service-install.mjs

@@ -0,0 +1,144 @@
+/**
+ * `hub-agent install-service` / `uninstall-service` の実装 (Sprint J)。
+ *
+ * - macOS: ~/Library/LaunchAgents/co.cocorograph.hub-agent.plist を install
+ *   して launchctl bootstrap gui/<uid> で常駐化
+ * - Linux: ~/.config/systemd/user/hub-agent.service を install して
+ *   systemctl --user enable --now hub-agent.service
+ *
+ * テンプレ内の __HUB_AGENT_BIN__ / __HOME__ / __PATH__ を実行時に置換する。
+ * 仕様書: ナレッジ/インフラ/cockpit-hub-hosted-integration-spec (id=6080)
+ */
+import { promises as fs } from "node:fs"
+import os from "node:os"
+import path from "node:path"
+import { spawnSync } from "node:child_process"
+import { fileURLToPath } from "node:url"
+
+const PLIST_LABEL = "co.cocorograph.hub-agent"
+const SYSTEMD_UNIT_NAME = "hub-agent.service"
+
+function repoTemplatesDir() {
+  // src/service-install.mjs → ../templates
+  return path.join(path.dirname(fileURLToPath(import.meta.url)), "..", "templates")
+}
+
+function ensureUnixUid() {
+  if (process.getuid) return process.getuid()
+  return null
+}
+
+function macPlistPath() {
+  return path.join(os.homedir(), "Library", "LaunchAgents", `${PLIST_LABEL}.plist`)
+}
+
+function linuxUnitPath() {
+  return path.join(os.homedir(), ".config", "systemd", "user", SYSTEMD_UNIT_NAME)
+}
+
+async function readTemplate(name) {
+  const p = path.join(repoTemplatesDir(), name)
+  return fs.readFile(p, "utf-8")
+}
+
+function expandTemplate(text, hubAgentBin) {
+  return text
+    .replaceAll("__HUB_AGENT_BIN__", hubAgentBin)
+    .replaceAll("__HOME__", os.homedir())
+    .replaceAll("__PATH__", process.env.PATH || "/usr/local/bin:/usr/bin:/bin")
+}
+
+async function ensureDir(p) {
+  await fs.mkdir(p, { recursive: true })
+}
+
+async function ensureLogFile() {
+  await ensureDir(path.join(os.homedir(), ".hub"))
+}
+
+function run(cmd, args, opts = {}) {
+  const r = spawnSync(cmd, args, { stdio: "inherit", ...opts })
+  if (r.status !== 0) {
+    throw new Error(`${cmd} ${args.join(" ")} failed (exit ${r.status})`)
+  }
+}
+
+/** インストール先の 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()
+  // fallback: node $repo/bin/hub-agent.mjs
+  return path.join(path.dirname(fileURLToPath(import.meta.url)), "..", "bin", "hub-agent.mjs")
+}
+
+export async function installService({ bin } = {}) {
+  const hubAgentBin = bin || detectHubAgentBin()
+  await ensureLogFile()
+
+  if (process.platform === "darwin") {
+    const tpl = await readTemplate("co.cocorograph.hub-agent.plist")
+    const expanded = expandTemplate(tpl, hubAgentBin)
+    const dest = macPlistPath()
+    await ensureDir(path.dirname(dest))
+    await fs.writeFile(dest, expanded, { mode: 0o644 })
+
+    const uid = ensureUnixUid()
+    // 既存ロード解除 → bootstrap → kickstart
+    spawnSync("launchctl", ["bootout", `gui/${uid}`, dest], { stdio: "ignore" })
+    run("launchctl", ["bootstrap", `gui/${uid}`, dest])
+    run("launchctl", ["kickstart", "-k", `gui/${uid}/${PLIST_LABEL}`])
+    return { platform: "darwin", path: dest, label: PLIST_LABEL, bin: hubAgentBin }
+  }
+
+  if (process.platform === "linux") {
+    const tpl = await readTemplate("hub-agent.service")
+    const expanded = expandTemplate(tpl, hubAgentBin)
+    const dest = linuxUnitPath()
+    await ensureDir(path.dirname(dest))
+    await fs.writeFile(dest, expanded, { mode: 0o644 })
+
+    run("systemctl", ["--user", "daemon-reload"])
+    run("systemctl", ["--user", "enable", "--now", SYSTEMD_UNIT_NAME])
+    return { platform: "linux", path: dest, unit: SYSTEMD_UNIT_NAME, bin: hubAgentBin }
+  }
+
+  throw new Error(`unsupported platform: ${process.platform}`)
+}
+
+export async function uninstallService() {
+  if (process.platform === "darwin") {
+    const uid = ensureUnixUid()
+    const dest = macPlistPath()
+    spawnSync("launchctl", ["bootout", `gui/${uid}`, dest], { stdio: "ignore" })
+    try {
+      await fs.unlink(dest)
+    } catch (err) {
+      if (err.code !== "ENOENT") throw err
+    }
+    return { platform: "darwin", path: dest, removed: true }
+  }
+
+  if (process.platform === "linux") {
+    spawnSync("systemctl", ["--user", "disable", "--now", SYSTEMD_UNIT_NAME], {
+      stdio: "ignore",
+    })
+    const dest = linuxUnitPath()
+    try {
+      await fs.unlink(dest)
+    } catch (err) {
+      if (err.code !== "ENOENT") throw err
+    }
+    spawnSync("systemctl", ["--user", "daemon-reload"], { stdio: "ignore" })
+    return { platform: "linux", path: dest, removed: true }
+  }
+
+  throw new Error(`unsupported platform: ${process.platform}`)
+}
+
+export const _internal = {
+  expandTemplate,
+  detectHubAgentBin,
+  macPlistPath,
+  linuxUnitPath,
+  repoTemplatesDir,
+}

package/src/skills.mjs

@@ -0,0 +1,142 @@
+/**
+ * Claude Code の skill / slash command を集計する (Sprint H)。
+ *
+ * - `~/.claude/skills/<name>/SKILL.md` の YAML frontmatter から name/description
+ * - `~/.claude/commands/<name>.md` の YAML frontmatter から name/description
+ * - 組み込みコマンド (clear, compact, help 等) はハードコード
+ * - sessionName が project local の場合、`~/hub/projects/<sessionName>/.claude/...`
+ *   も追加で読む (Sprint H 拡張)
+ *
+ * 移植元: D00000_cockpit/webapp/lib/skills.ts
+ * 仕様書: ナレッジ/インフラ/cockpit-hub-hosted-integration-spec (id=6080)
+ */
+import { promises as fs } from "node:fs"
+import os from "node:os"
+import path from "node:path"
+
+const CLAUDE_DIR = process.env.CLAUDE_DIR || path.join(os.homedir(), ".claude")
+const GLOBAL_SKILLS_DIR = path.join(CLAUDE_DIR, "skills")
+const GLOBAL_COMMANDS_DIR = path.join(CLAUDE_DIR, "commands")
+
+// Claude Code 組み込みスラッシュコマンド (ファイルから取得できないのでハードコード)
+const BUILT_IN_COMMANDS = [
+  { name: "clear", description: "会話履歴をクリア (短期メモリのリセット)", source: "builtin" },
+  { name: "compact", description: "会話を要約して圧縮 (context 節約)", source: "builtin" },
+  { name: "help", description: "ヘルプ表示", source: "builtin" },
+  { name: "cost", description: "現セッションの API コスト表示", source: "builtin" },
+  { name: "model", description: "使用する Claude モデルを切替", source: "builtin" },
+  { name: "config", description: "Claude Code 設定を開く", source: "builtin" },
+  { name: "status", description: "セッション状態 (mode / 認証等) を表示", source: "builtin" },
+  { name: "permissions", description: "ツール許可ルールの管理", source: "builtin" },
+  { name: "agents", description: "subagent 一覧 / 管理", source: "builtin" },
+  { name: "mcp", description: "MCP サーバー状態", source: "builtin" },
+  { name: "ide", description: "IDE 統合", source: "builtin" },
+  { name: "login", description: "Claude にログイン", source: "builtin" },
+  { name: "logout", description: "ログアウト", source: "builtin" },
+  { name: "exit", description: "セッション終了", source: "builtin" },
+  { name: "release-notes", description: "Claude Code のリリースノート", source: "builtin" },
+  { name: "bug", description: "Claude Code のバグ報告を送信", source: "builtin" },
+  { name: "upgrade", description: "Claude Code を最新版にアップグレード", source: "builtin" },
+  { name: "fast", description: "Fast mode (Opus 4.6) のトグル", source: "builtin" },
+  { name: "pr-comments", description: "PR のコメントを取得", source: "builtin" },
+  { name: "install-github-app", description: "GitHub アプリのインストール", source: "builtin" },
+  { name: "migrate-installer", description: "古い installer から移行", source: "builtin" },
+]
+
+function extractFrontmatter(text) {
+  const m = text.match(/^---\s*\n([\s\S]*?)\n---/)
+  if (!m) return {}
+  const fm = m[1]
+  const out = {}
+  const nameMatch = fm.match(/^name:\s*["']?([^"'\n]+)["']?\s*$/m)
+  if (nameMatch) out.name = nameMatch[1].trim()
+  const descMatch = fm.match(/^description:\s*["']?(.*)["']?\s*$/m)
+  if (descMatch) out.description = descMatch[1].replace(/^["']|["']$/g, "").trim()
+  return out
+}
+
+async function readOrNull(p) {
+  try {
+    return await fs.readFile(p, "utf-8")
+  } catch {
+    return null
+  }
+}
+
+async function loadSkillsDir(skillsDir, source) {
+  const out = []
+  let entries
+  try {
+    entries = await fs.readdir(skillsDir, { withFileTypes: true })
+  } catch {
+    return out // dir 不在 OK
+  }
+  for (const e of entries) {
+    if (e.name.startsWith(".")) continue
+    if (!e.isDirectory()) continue
+    const text = await readOrNull(path.join(skillsDir, e.name, "SKILL.md"))
+    if (!text) continue
+    const fm = extractFrontmatter(text)
+    out.push({
+      name: fm.name || e.name,
+      description: fm.description || "",
+      source,
+    })
+  }
+  return out
+}
+
+async function loadCommandsDir(commandsDir, source) {
+  const out = []
+  let files
+  try {
+    files = await fs.readdir(commandsDir)
+  } catch {
+    return out
+  }
+  for (const f of files) {
+    if (f.startsWith(".")) continue
+    if (!f.endsWith(".md")) continue
+    const text = await readOrNull(path.join(commandsDir, f))
+    if (!text) continue
+    const fm = extractFrontmatter(text)
+    out.push({
+      name: fm.name || f.replace(/\.md$/, ""),
+      description: fm.description || "",
+      source,
+    })
+  }
+  return out
+}
+
+/**
+ * skills 全リストを返す。
+ *
+ * @param {{ sessionName?: string, projectsRoot?: string }} [opts]
+ *   - sessionName が `Dxxxxx_*` 形式なら projectsRoot 配下の同名 dir からも
+ *     `.claude/skills/` と `.claude/commands/` を追加で読む
+ */
+export async function listSkills(opts = {}) {
+  const out = []
+  out.push(...BUILT_IN_COMMANDS)
+  out.push(...(await loadSkillsDir(GLOBAL_SKILLS_DIR, "skill")))
+  out.push(...(await loadCommandsDir(GLOBAL_COMMANDS_DIR, "command")))
+
+  const sessionName = opts.sessionName
+  const projectsRoot = opts.projectsRoot || path.join(os.homedir(), "hub", "projects")
+  if (sessionName && /^D\d{5}_/.test(sessionName)) {
+    const projectDir = path.join(projectsRoot, sessionName, ".claude")
+    out.push(...(await loadSkillsDir(path.join(projectDir, "skills"), "project-skill")))
+    out.push(...(await loadCommandsDir(path.join(projectDir, "commands"), "project-command")))
+  }
+
+  // 同名は最初を採用、名前順 sort
+  const seen = new Set()
+  const deduped = out.filter((s) => {
+    if (seen.has(s.name)) return false
+    seen.add(s.name)
+    return true
+  })
+  deduped.sort((a, b) => a.name.localeCompare(b.name))
+  return deduped
+}

package/src/state.mjs

@@ -0,0 +1,125 @@
+/**
+ * tmux session の Claude Code TUI 状態を判定する (Sprint H part 2)。
+ *
+ * - listSessionNames(): `tmux list-sessions -F '#S'` で session 名一覧
+ * - detectStatus(sessionName): `tmux capture-pane -p -t name -S -30 -E -` で末尾を取得
+ *   → "esc to interrupt" → processing / "❯ " or "> " → waiting / それ以外 → idle
+ * - detectContextPct(text): pane 末尾から "X% context left" / "X% until auto-compact"
+ *   等のパターンを拾う (見つからなければ null)
+ * - plugin `transformStatusDetection` hook を chain して結果差し替え可
+ *
+ * 移植元: D00000_cockpit/webapp/lib/tmux.ts (getSessionStatus 部分)
+ * 仕様書: ナレッジ/インフラ/cockpit-hub-hosted-integration-spec (id=6080)
+ */
+import { execFile } from "node:child_process"
+import { promisify } from "node:util"
+
+import { runHookChain } from "./plugin-loader.mjs"
+
+const execFileP = promisify(execFile)
+
+const STATUSES = Object.freeze(["processing", "waiting", "idle"])
+
+const CONTEXT_PATTERNS = [
+  /(\d{1,3})\s*%\s*context\s*left/i,
+  /context\s*[:\-]?\s*(\d{1,3})\s*%/i,
+  /(\d{1,3})\s*%\s*until\s*auto[-\s]?compact/i,
+]
+
+function stripAnsi(s) {
+  // ANSI CSI / OSC / charset switch を削る
+  return s
+    .replace(/\x1b\[[0-9;?]*[a-zA-Z]/g, "")
+    .replace(/\x1b\][^\x07]*\x07/g, "")
+    .replace(/\x1b[()][AB012]/g, "")
+}
+
+export function detectStatusFromText(text) {
+  if (/esc to interrupt/i.test(text)) return "processing"
+  if (/❯\s/.test(text) || /^>\s/m.test(text)) return "waiting"
+  return "idle"
+}
+
+export function detectContextPctFromText(text) {
+  for (const re of CONTEXT_PATTERNS) {
+    const m = text.match(re)
+    if (m) {
+      const n = Number(m[1])
+      if (Number.isFinite(n) && n >= 0 && n <= 100) return n
+    }
+  }
+  return null
+}
+
+export async function listSessionNames(opts = {}) {
+  const tmuxBin = opts.tmuxBin || "tmux"
+  try {
+    const { stdout } = await execFileP(tmuxBin, ["list-sessions", "-F", "#S"])
+    return stdout
+      .split("\n")
+      .map((s) => s.trim())
+      .filter(Boolean)
+  } catch {
+    return []
+  }
+}
+
+export async function capturePane(sessionName, opts = {}) {
+  const tmuxBin = opts.tmuxBin || "tmux"
+  try {
+    const { stdout } = await execFileP(tmuxBin, [
+      "capture-pane",
+      "-p",
+      "-t",
+      sessionName,
+      "-S",
+      "-30",
+      "-E",
+      "-",
+    ])
+    return stripAnsi(stdout)
+  } catch {
+    return ""
+  }
+}
+
+/**
+ * 1 session の現在状態を取得する。plugin hook で上書き可。
+ *
+ * @returns {Promise<{status: string, context_pct: number | null}>}
+ */
+export async function detectSessionState(sessionName, opts = {}) {
+  const text = await capturePane(sessionName, opts)
+  const defaultStatus = detectStatusFromText(text)
+  const defaultContextPct = detectContextPctFromText(text)
+
+  if (opts.plugins && opts.plugins.length) {
+    const hookResult = await runHookChain(opts.plugins, "transformStatusDetection", {
+      logger: opts.logger,
+      sessionName,
+      paneText: text,
+      defaultStatus,
+    })
+    if (hookResult?.result) {
+      return {
+        status: hookResult.result.status || defaultStatus,
+        context_pct: hookResult.result.context_pct ?? defaultContextPct,
+      }
+    }
+  }
+
+  return { status: defaultStatus, context_pct: defaultContextPct }
+}
+
+/** 全 session の現在状態を取得する。 */
+export async function listSessionStates(opts = {}) {
+  const names = await listSessionNames(opts)
+  return Promise.all(
+    names.map(async (name) => ({
+      session_name: name,
+      ...(await detectSessionState(name, opts)),
+    })),
+  )
+}
+
+export { STATUSES }