@cocorograph/hub-agent 0.6.67 → 0.6.69

package/package.json

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

package/src/claude-md.mjs

@@ -51,7 +51,127 @@ async function fetchDirector({ hubUrl, accessToken, dirName, fetchImpl }) {
   }
 }
 
-function renderWithDirector(dirName, director) {
+/**
+ * dir 名から GitRepository 一覧を取得する。
+ *
+ * 旧 Hub backend（GitRepository モデル未導入）では 404 を返すので、
+ * その場合は空配列扱いで後方互換を維持する。
+ *
+ * @returns {Promise<Array<object>>}
+ */
+async function fetchRepositories({ hubUrl, accessToken, dirName, fetchImpl }) {
+  const f = fetchImpl || globalThis.fetch
+  if (!f) return []
+  const url =
+    `${hubUrl.replace(/\/+$/, "")}/api/git-repositories/by-dir/` +
+    `${encodeURIComponent(dirName)}/`
+  try {
+    const res = await f(url, {
+      headers: { Authorization: `Bearer ${accessToken}` },
+    })
+    if (!res.ok) return []
+    const payload = await res.json()
+    return Array.isArray(payload?.repositories) ? payload.repositories : []
+  } catch {
+    return []
+  }
+}
+
+/**
+ * GitRepository 配列を CLAUDE.md のクローンレス作業手順セクションに描画する。
+ *
+ * リポジトリが 1 件もない場合は空文字列を返し、CLAUDE.md には何も追記しない。
+ */
+function renderRepositorySection(repositories, dirName = "") {
+  if (!Array.isArray(repositories) || repositories.length === 0) return ""
+
+  const lines = ["## Cockpit クローンレス開発フロー", ""]
+  lines.push(
+    "この workspace ディレクトリには Git リポジトリを常設しません。",
+    "コードを修正するときは、毎回一時ディレクトリにチェックアウトして作業します。",
+    "",
+  )
+
+  for (const repo of repositories) {
+    const repoUrl = (repo?.repo_url || "").trim()
+    if (!repoUrl) continue
+    const branch = (repo?.default_branch || "main").trim()
+    const deployDisplay = (repo?.deploy_method_display || "").trim()
+    const deployNotes = (repo?.deploy_notes || "").trim()
+    const stagingName = (repo?.staging_server_name || "").trim()
+    const productionName = (repo?.production_server_name || "").trim()
+    const repoLabel = (repo?.name || "").trim()
+    const heading = repoLabel
+      ? `### ${repoUrl} — ${repoLabel}`
+      : `### ${repoUrl}`
+
+    lines.push(heading)
+    lines.push("")
+    lines.push(`- **デフォルトブランチ**: \`${branch}\``)
+    if (deployDisplay) lines.push(`- **デプロイ方式**: ${deployDisplay}`)
+    if (stagingName) lines.push(`- **ステージング**: ${stagingName}`)
+    if (productionName) lines.push(`- **本番**: ${productionName}`)
+    lines.push("")
+
+    lines.push("**作業手順（クローンレス）**:")
+    lines.push("")
+    lines.push("```bash")
+    lines.push("TMPDIR=$(mktemp -d)")
+    lines.push(`gh repo clone ${repoUrl} "$TMPDIR" -- --depth 1 --filter=blob:none --no-checkout`)
+    lines.push(`cd "$TMPDIR" && git fetch origin ${branch} && git checkout -b feat/<your-change> origin/${branch}`)
+    lines.push("# ファイル編集 → 動作確認")
+    lines.push('git commit -am "<message>"')
+    lines.push("git push -u origin HEAD")
+    lines.push("gh pr create --base " + branch + " --fill")
+    lines.push("# 作業終了後")
+    lines.push('cd / && rm -rf "$TMPDIR"')
+    lines.push("```")
+    lines.push("")
+
+    if (deployNotes) {
+      lines.push("**デプロイ手順メモ**:")
+      lines.push("")
+      lines.push("```")
+      lines.push(deployNotes)
+      lines.push("```")
+      lines.push("")
+    }
+
+    // デプロイ接続情報の安全な取得手順（秘匿値を会話に出さない）。
+    if (stagingName || productionName) {
+      const envExample = productionName ? "production" : "staging"
+      lines.push("**デプロイ接続情報の取得（秘匿値を会話に出さない）**:")
+      lines.push("")
+      lines.push("```bash")
+      lines.push(
+        "# 秘密鍵を ~/.ssh/hub_deploy/ に書き出し、ssh コマンドだけ受け取る",
+      )
+      lines.push(
+        `python3 ~/.claude/scripts/hub_helper.py deploy_creds ${dirName || "<dir_name>"} --env ${envExample}`,
+      )
+      lines.push("```")
+      lines.push("")
+      lines.push(
+        "返り値の `ssh_command` をそのまま使って接続します。`key_file` は",
+        "chmod 600 で書き出されます。パスワード認証のサーバーは `password_set: true`",
+        "だけ返るので、その場合は Hub の「サーバー情報」タブから人手で取得します。",
+        "",
+      )
+    }
+  }
+
+  lines.push("### デプロイ前の必須ガード", "")
+  lines.push(
+    "- **本番反映の前に必ず現状バックアップを取る**（DB ダンプ / 対象ディレクトリの退避）。",
+    "- ステージングで動作確認してから本番へ。",
+    "- 破壊的操作（`reset --hard` / `rm -rf` / DB 操作）の前に対象を確認する。",
+    "- Git 認証はローカルの `gh` CLI / SSH 鍵を使用します。",
+    "",
+  )
+  return lines.join("\n")
+}
+
+function renderWithDirector(dirName, director, repositorySection = "") {
   const fm = director?.frontmatter || {}
   const client = (fm.client || "").trim()
   const domain = (fm.domain || "").trim()
@@ -94,6 +214,10 @@ function renderWithDirector(dirName, director) {
   }
   lines.push("")
 
+  if (repositorySection) {
+    lines.push(repositorySection)
+  }
+
   lines.push("## 初期化")
   lines.push("")
   lines.push(
@@ -109,8 +233,8 @@ function renderWithDirector(dirName, director) {
   return lines.join("\n")
 }
 
-function renderPlaceholder(dirName) {
-  return [
+function renderPlaceholder(dirName, repositorySection = "") {
+  const sections = [
     "# CLAUDE.md",
     "",
     "This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.",
@@ -119,12 +243,18 @@ function renderPlaceholder(dirName) {
     "",
     `- **Hub Director**: \`[[${dirName}/_director]]\` — 案件の進行・意思決定・直近ログ (未作成)`,
     "",
+  ]
+  if (repositorySection) {
+    sections.push(repositorySection)
+  }
+  sections.push(
     "## 初期化",
     "",
     "これは hub-agent の自動生成プレースホルダです。Hub director も未作成です。",
     "詳細を生成するには、このリポジトリで `claude` を起動して `/init-claude-md` スキルを実行してください。",
     "",
-  ].join("\n")
+  )
+  return sections.join("\n")
 }
 
 /**
@@ -166,18 +296,19 @@ export async function ensureClaudeMd({
   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
+  // director と repositories は独立して取れるので並列フェッチする。
+  // どちらも失敗時は null / [] にフォールバックする (token なしの場合も同様)。
+  const [director, repositories] = token
+    ? await Promise.all([
+        fetchDirector({ hubUrl: url, accessToken: token, dirName, fetchImpl }),
+        fetchRepositories({ hubUrl: url, accessToken: token, dirName, fetchImpl }),
+      ])
+    : [null, []]
 
+  const repositorySection = renderRepositorySection(repositories, dirName)
   const body = director
-    ? renderWithDirector(dirName, director)
-    : renderPlaceholder(dirName)
+    ? renderWithDirector(dirName, director, repositorySection)
+    : renderPlaceholder(dirName, repositorySection)
   const source = director ? "director" : "placeholder"
 
   await fs.writeFile(claudeMdPath, body, "utf-8")