@cocorograph/hub-agent 0.5.11 → 0.5.12

package/package.json

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

package/src/claude-md.mjs

@@ -0,0 +1,189 @@
+/**
+ * 新規 workspace ディレクトリ初期化時の CLAUDE.md 生成。
+ *
+ * ~/hub/bin/generate-claude-md (Python) と同等の仕様を Node 側に持つ。
+ * - `<dirName>/_director` slug で Hub director を引き当て、見つかれば
+ *   frontmatter (client / domain / industry / service / tech_stack /
+ *   google_drive) を反映した構造化 CLAUDE.md を書き出す
+ * - 認証トークン (`~/.claude/.hub_token.json`) が無い / API 失敗 / director
+ *   未登録ならプレースホルダ CLAUDE.md を書き出す
+ *
+ * CLAUDE.md が既存ならそのまま (上書きしない)。
+ */
+import fs from "node:fs/promises"
+import os from "node:os"
+import path from "node:path"
+
+const DEFAULT_HUB_API = "https://api.hub.cocorograph.com"
+const TOKEN_PATH = path.join(os.homedir(), ".claude", ".hub_token.json")
+
+async function readJsonOrNull(p) {
+  try {
+    const text = await fs.readFile(p, "utf-8")
+    return JSON.parse(text)
+  } catch {
+    return null
+  }
+}
+
+async function loadAccessToken() {
+  const data = await readJsonOrNull(TOKEN_PATH)
+  return (data && typeof data.access === "string" && data.access) || null
+}
+
+async function fetchDirector({ hubUrl, accessToken, dirName, fetchImpl }) {
+  const f = fetchImpl || globalThis.fetch
+  if (!f) return null
+  const slug = `${dirName}/_director`
+  const url =
+    `${hubUrl.replace(/\/+$/, "")}/api/knowledge-pages/` +
+    `?slug=${encodeURIComponent(slug)}&doc_type=director`
+  try {
+    const res = await f(url, {
+      headers: { Authorization: `Bearer ${accessToken}` },
+    })
+    if (!res.ok) return null
+    const payload = await res.json()
+    const items = payload?.results || []
+    return items[0] || null
+  } catch {
+    return null
+  }
+}
+
+function renderWithDirector(dirName, director) {
+  const fm = director?.frontmatter || {}
+  const client = (fm.client || "").trim()
+  const domain = (fm.domain || "").trim()
+  const industry = (fm.industry || "").trim()
+  const service = (fm.service || "").trim()
+  const techStack = Array.isArray(fm.tech_stack) ? fm.tech_stack : []
+  const googleDrive = (fm.google_drive || "").trim()
+
+  const lines = [
+    "# CLAUDE.md",
+    "",
+    "This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.",
+    "",
+    "## プロジェクト概要",
+    "",
+  ]
+  if (client) lines.push(`- **クライアント**: ${client}`)
+  if (domain) lines.push(`- **ドメイン**: ${domain}`)
+  if (industry) lines.push(`- **業種**: ${industry}`)
+  if (service) lines.push(`- **サービス**: ${service}`)
+  if (!(client || domain || industry || service)) {
+    lines.push("- (director frontmatter に該当情報なし)")
+  }
+  lines.push("")
+
+  if (techStack.length > 0) {
+    lines.push("## 技術スタック")
+    lines.push("")
+    for (const t of techStack) lines.push(`- ${t}`)
+    lines.push("")
+  }
+
+  lines.push("## 関連")
+  lines.push("")
+  lines.push(
+    `- **Hub Director**: \`[[${dirName}/_director]]\` — 案件の進行・意思決定・直近ログ`,
+  )
+  if (googleDrive) {
+    lines.push(`- **Google Drive**: \`$GDRIVE/${googleDrive}/\` — 成果物・素材`)
+  }
+  lines.push("")
+
+  lines.push("## 初期化")
+  lines.push("")
+  lines.push(
+    "これは hub-agent が director frontmatter から自動生成した雛形です。",
+  )
+  lines.push(
+    "開発手順・SSH 接続情報・横断ナレッジへのポインタなど、より詳細な内容は",
+  )
+  lines.push(
+    "このリポジトリで `claude` を起動して `/init-claude-md` スキルを実行してください。",
+  )
+  lines.push("")
+  return lines.join("\n")
+}
+
+function renderPlaceholder(dirName) {
+  return [
+    "# CLAUDE.md",
+    "",
+    "This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.",
+    "",
+    "## 関連",
+    "",
+    `- **Hub Director**: \`[[${dirName}/_director]]\` — 案件の進行・意思決定・直近ログ (未作成)`,
+    "",
+    "## 初期化",
+    "",
+    "これは hub-agent の自動生成プレースホルダです。Hub director も未作成です。",
+    "詳細を生成するには、このリポジトリで `claude` を起動して `/init-claude-md` スキルを実行してください。",
+    "",
+  ].join("\n")
+}
+
+/**
+ * `<targetDir>/CLAUDE.md` を必要に応じて生成する。
+ *
+ * - CLAUDE.md が既存なら何もしない (上書きしない)
+ * - Hub director が見つかれば frontmatter 連動の構造化 CLAUDE.md を生成
+ * - 見つからない / 認証なし / API 失敗ならプレースホルダを生成
+ *
+ * @param {object} args
+ * @param {string} args.targetDir       絶対パス
+ * @param {string} args.dirName         director slug 解決用のディレクトリ名 (例: D00611_at-pocket.com)
+ * @param {string} [args.hubUrl]        Hub API base (default: https://api.hub.cocorograph.com)
+ * @param {string} [args.accessToken]   省略時は `~/.claude/.hub_token.json` から読む
+ * @param {object} [args.logger]
+ * @param {Function} [args.fetchImpl]   テスト注入用
+ * @returns {Promise<{ written: boolean, source: 'existing' | 'director' | 'placeholder' }>}
+ */
+export async function ensureClaudeMd({
+  targetDir,
+  dirName,
+  hubUrl,
+  accessToken,
+  logger,
+  fetchImpl,
+} = {}) {
+  if (!targetDir) throw new Error("ensureClaudeMd requires targetDir")
+  if (!dirName) throw new Error("ensureClaudeMd requires dirName")
+  const claudeMdPath = path.join(targetDir, "CLAUDE.md")
+  try {
+    await fs.access(claudeMdPath)
+    return { written: false, source: "existing" }
+  } catch {
+    /* not found → continue */
+  }
+
+  // accessToken は明示 null (テスト用) で「token を読まない」を選べるようにする。
+  // undefined のときだけ ~/.claude/.hub_token.json にフォールバックする。
+  const token =
+    accessToken === undefined ? await loadAccessToken() : accessToken || null
+  const url = hubUrl || DEFAULT_HUB_API
+  const director = token
+    ? await fetchDirector({
+        hubUrl: url,
+        accessToken: token,
+        dirName,
+        fetchImpl,
+      })
+    : null
+
+  const body = director
+    ? renderWithDirector(dirName, director)
+    : renderPlaceholder(dirName)
+  const source = director ? "director" : "placeholder"
+
+  await fs.writeFile(claudeMdPath, body, "utf-8")
+  logger?.info?.(
+    { dirName, claudeMdPath, source },
+    "wrote CLAUDE.md for new workspace dir",
+  )
+  return { written: true, source }
+}

package/src/tmux.mjs

@@ -19,6 +19,7 @@ import os from "node:os"
 import path from "node:path"
 import { promisify } from "node:util"
 
+import { ensureClaudeMd } from "./claude-md.mjs"
 import { detectSessionState } from "./state.mjs"
 import { getSessionUsages } from "./usage.mjs"
 
@@ -26,8 +27,12 @@ const execFileP = promisify(execFile)
 
 const DEFAULT_TMUX_BIN = "tmux"
 
-const HUB_PROJECTS_BASE =
-  process.env.HUB_PROJECTS_BASE || path.join(os.homedir(), "hub", "projects")
+// HUB_PROJECTS_BASE は実行時に解決する。テストや起動環境で
+// `process.env.HUB_PROJECTS_BASE` を上書きできるよう、import 時に
+// const として固定しない (tests/tmux.test.mjs が動的に差し替えるため)。
+function hubProjectsBase() {
+  return process.env.HUB_PROJECTS_BASE || path.join(os.homedir(), "hub", "projects")
+}
 
 function sanitizeTmuxName(s) {
   return s.replace(/[.:]/g, "-")
@@ -47,6 +52,24 @@ export function expandTilde(p) {
   return p
 }
 
+/**
+ * 絶対パス `p` が HUB_PROJECTS_BASE 配下かを判定する。
+ *
+ * `createSession` の cwd 自動作成判定で使う。base そのもの (`~/hub/projects`)
+ * は対象外とし、配下のサブディレクトリのみ true を返す。`path.relative` で
+ * `..` を含まないかチェックすることで `/Users/.../hub/projects-backup` のような
+ * 接頭辞一致のみの誤検知を排除する。
+ */
+export function isUnderHubProjectsBase(p) {
+  if (typeof p !== "string" || p.length === 0) return false
+  const abs = path.resolve(p)
+  const base = path.resolve(hubProjectsBase())
+  if (abs === base) return false
+  const rel = path.relative(base, abs)
+  if (!rel || rel.startsWith("..") || path.isAbsolute(rel)) return false
+  return true
+}
+
 /**
  * git branch 名から worktree dir 名 (= tmux session 名) を導出する。
  * 例: "feature/multi-area" -> "feature-multi-area"
@@ -87,8 +110,9 @@ export async function createWorktreeDir(parentDir, branch) {
   // parentDir に `~/...` 形式が来ても受け付けられるよう先に展開する。
   // 展開後が絶対パスなら path.resolve は HUB_PROJECTS_BASE を無視して
   // そのまま使う (Node の path.resolve 仕様)。
-  const repoDir = path.resolve(HUB_PROJECTS_BASE, expandTilde(parentDir))
-  if (repoDir !== HUB_PROJECTS_BASE && !repoDir.startsWith(HUB_PROJECTS_BASE + path.sep)) {
+  const projectsBase = hubProjectsBase()
+  const repoDir = path.resolve(projectsBase, expandTilde(parentDir))
+  if (repoDir !== projectsBase && !repoDir.startsWith(projectsBase + path.sep)) {
     throw new Error("dir outside projects base")
   }
   // .git の存在チェック (file or dir)
@@ -127,15 +151,16 @@ export async function createWorktreeDir(parentDir, branch) {
  */
 async function buildWorktreeParentMap() {
   const out = new Map()
+  const projectsBase = hubProjectsBase()
   let projects
   try {
-    projects = await fs.readdir(HUB_PROJECTS_BASE, { withFileTypes: true })
+    projects = await fs.readdir(projectsBase, { withFileTypes: true })
   } catch {
     return out
   }
   for (const p of projects) {
     if (!p.isDirectory() || p.name.startsWith(".")) continue
-    const wtBase = path.join(HUB_PROJECTS_BASE, p.name, ".claude", "worktrees")
+    const wtBase = path.join(projectsBase, p.name, ".claude", "worktrees")
     let wts
     try {
       wts = await fs.readdir(wtBase, { withFileTypes: true })
@@ -348,13 +373,56 @@ export async function createSession(name, cwd, opts = {}) {
   // cwd 存在チェック (旧 Cockpit 単体実装と同等の防御)
   // 無いまま tmux に渡すと pane の current_path が HOME など別ディレクトリに
   // fallback して、SessionStart hook が project を解決できなくなる。
+  //
+  // 例外: 解決後のパスが HUB_PROJECTS_BASE 配下 (= 案件 workspace ディレクトリ)
+  // なら、未 clone のメンバー Mac でも cockpit から起動できるよう mkdir -p で
+  // 自動生成する。任意の絶対パス (leader cwd 等) や HUB_PROJECTS_BASE 外は
+  // 引き続き `cwd not found` を返し、誤った workspace 起動を防ぐ。
   try {
     const st = await fs.stat(resolvedCwd)
     if (!st.isDirectory()) throw new Error("cwd not a directory")
   } catch (err) {
-    if (err?.code === "ENOENT") throw new Error(`cwd not found: ${resolvedCwd}`)
-    if (err?.message === "cwd not a directory") throw err
-    throw new Error(`cwd stat failed: ${err?.message || String(err)}`)
+    if (err?.code === "ENOENT") {
+      if (isUnderHubProjectsBase(resolvedCwd)) {
+        try {
+          await fs.mkdir(resolvedCwd, { recursive: true })
+          opts.logger?.info?.(
+            { session: name, cwd: resolvedCwd },
+            "auto-created workspace dir before tmux new-session",
+          )
+        } catch (mkdirErr) {
+          throw new Error(
+            `cwd mkdir failed: ${mkdirErr?.message || String(mkdirErr)}`,
+          )
+        }
+      } else {
+        throw new Error(`cwd not found: ${resolvedCwd}`)
+      }
+    } else if (err?.message === "cwd not a directory") {
+      throw err
+    } else {
+      throw new Error(`cwd stat failed: ${err?.message || String(err)}`)
+    }
+  }
+  // HUB_PROJECTS_BASE 配下の workspace の場合は CLAUDE.md を必要なら生成する。
+  // Hub director があれば frontmatter 連動の構造化版、無ければ最小プレースホルダ。
+  // 既存 CLAUDE.md は触らない。失敗しても session 起動自体は止めない (warn のみ)。
+  if (isUnderHubProjectsBase(resolvedCwd)) {
+    try {
+      await ensureClaudeMd({
+        targetDir: resolvedCwd,
+        dirName: path.basename(resolvedCwd),
+        hubUrl: opts.hubUrl,
+        accessToken: opts.hubAccessToken,
+        logger: opts.logger,
+        fetchImpl: opts.fetchImpl,
+      })
+    } catch (err) {
+      opts.logger?.warn?.(
+        { session: name, cwd: resolvedCwd, err: err?.message || String(err) },
+        "ensureClaudeMd failed (workspace dir is usable, but no CLAUDE.md)",
+      )
+    }
   }
   // 既存チェック
   try {