@cocorograph/hub-agent 0.8.21 → 0.8.22

package/package.json

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

package/src/claude-md-render.mjs

@@ -0,0 +1,222 @@
+/**
+ * CLAUDE.md / AGENTS.md の **自動生成本文のレンダラ**（director 版 / placeholder 版）。
+ *
+ * `src/claude-md.mjs` から物理移動した（複製ではない）。当初は
+ * `claude-md-sync.mjs` の救済判定（旧 fallback 本文を「実際に生成し直して等値比較」で
+ * 見分ける移行措置）と共有するためだったが、**その救済は廃止した**（レンダラの本文が
+ * 2026-07-22 の aa58223 で変わっており、それ以前に生成されたファイルとの等値は
+ * 原理的に成立しないため、実データで 0 件しか救済できなかった）。
+ * 現在の呼び出し元は `claude-md.mjs` だけだが、分割自体は有益なので残している
+ * （レンダラだけを差し替え・比較できる／`claude-md.mjs` の肥大を防ぐ）。
+ *
+ * ⚠️ このモジュールは何も import しない（純粋な文字列生成）。ここに I/O や Hub 取得を
+ * 足すと `claude-md.mjs` との循環を招く。
+ *
+ * ⚠️ **ここの文言はドリフトする**（実際に aa58223 で見出し行が変わった）。同期の判定に
+ * 「レンダラで再現して一致するか」を使わないこと。現在の同期は本文の中身を一切見ず、
+ * meta の有無と hash の等値だけで判定する（`claude-md-sync.mjs` 参照）。
+ */
+
+/**
+ * repo_url が GitHub の `owner/repo` slug 形式かを判定する。
+ *
+ * `://` や `@` を含むフル URL（GitLab の `git@gitlab.com:...` や
+ * `https://gitlab.com/...` 等）は false を返す。これらは `gh` ではなく
+ * 素の `git clone` でチェックアウトする。
+ */
+export function isGitHubSlug(repoUrl) {
+  if (/:\/\/|@/.test(repoUrl)) return false
+  return /^[A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+$/.test(repoUrl)
+}
+
+/**
+ * GitRepository 配列を CLAUDE.md のクローンレス作業手順セクションに描画する。
+ *
+ * リポジトリが 1 件もない場合は空文字列を返し、CLAUDE.md には何も追記しない。
+ */
+export function renderRepositorySection(repositories, dirName = "", cliKind = "claude") {
+  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("")
+
+    const githubSlug = isGitHubSlug(repoUrl)
+    lines.push("**作業手順（クローンレス）**:")
+    lines.push("")
+    lines.push("```bash")
+    lines.push("TMPDIR=$(mktemp -d)")
+    if (githubSlug) {
+      // GitHub: gh CLI で clone・PR 作成
+      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`)
+    } else {
+      // GitLab 等: 素の git clone。MR は push 後に Web/glab で作成
+      lines.push(`git clone --depth 1 --filter=blob:none --no-checkout ${repoUrl} "$TMPDIR"`)
+      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("# MR は GitLab の Web UI（push 時に表示される URL）か `glab mr create` で作成")
+    }
+    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 ~/.${cliKind === "codex" ? "codex" : "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（GitHub）/ SSH 鍵（GitLab 等）を使用します。",
+    "",
+  )
+  return lines.join("\n")
+}
+
+export function renderWithDirector(dirName, director, repositorySection = "", configFilename = "CLAUDE.md") {
+  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 = [
+    `# ${configFilename}`,
+    "",
+    `This file provides guidance to ${configFilename === "AGENTS.md" ? "Codex" : "Claude 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("")
+
+  if (repositorySection) {
+    lines.push(repositorySection)
+  }
+
+  lines.push("## 初期化")
+  lines.push("")
+  lines.push(
+    "これは hub-agent が director frontmatter から自動生成した雛形です。",
+  )
+  lines.push(
+    "開発手順・SSH 接続情報・横断ナレッジへのポインタなど、より詳細な内容は",
+  )
+  lines.push(
+    `このリポジトリで ${configFilename === "AGENTS.md" ? "`codex` を起動して `/init-Codex-md`" : "`claude` を起動して `/init-claude-md`"} スキルを実行してください。`,
+  )
+  lines.push("")
+  return lines.join("\n")
+}
+
+export function renderPlaceholder(dirName, repositorySection = "", configFilename = "CLAUDE.md") {
+  const sections = [
+    `# ${configFilename}`,
+    "",
+    `This file provides guidance to ${configFilename === "AGENTS.md" ? "Codex" : "Claude Code"} when working with code in this repository.`,
+    "",
+    "## 関連",
+    "",
+    `- **Hub Director**: \`[[${dirName}/_director]]\` — 案件の進行・意思決定・直近ログ (未作成)`,
+    "",
+  ]
+  if (repositorySection) {
+    sections.push(repositorySection)
+  }
+  sections.push(
+    "## 初期化",
+    "",
+    "これは hub-agent の自動生成プレースホルダです。Hub director も未作成です。",
+    `詳細を生成するには、このリポジトリで ${configFilename === "AGENTS.md" ? "`codex` を起動して `/init-Codex-md`" : "`claude` を起動して `/init-claude-md`"} スキルを実行してください。`,
+    "",
+  )
+  return sections.join("\n")
+}