@cocorograph/hub-agent 0.6.88 → 0.6.89

package/package.json

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

package/src/claude-md-sync.mjs

@@ -346,6 +346,11 @@ export async function syncClaudeMdWithHub({
   return { action: "conflict" }
 }
 
+// メタ操作・ハッシュ計算は ensureClaudeMd 側 (Hub pull 初回配信) でも使うため
+// named export する。同じファイルパス・同じスキーマで管理することで、初回配信と
+// 以降の sync で食い違いを起こさない。
+export { sha256, readMeta, writeMeta, nowIso }
+
 // 内部テスト用エクスポート
 export const _internals = {
   sha256,

package/src/claude-md.mjs

@@ -2,17 +2,28 @@
  * 新規 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 が既存ならそのまま (上書きしない)。
+ * 優先順 (新規生成時のみ。既存 CLAUDE.md は触らない):
+ * 1. **Hub の Project.claude_md 正本** (Stage 3 初回配信) — 非空ならそれを書く。
+ *    同期メタ (.cockpit-sync/claude-md.json) も初期化する。以降は
+ *    syncClaudeMdWithHub が双方向同期する。
+ * 2. **Hub director frontmatter** — claude_md が空でも director があれば
+ *    client/domain/industry/service/tech_stack/google_drive で構造化版を書く。
+ * 3. **placeholder** — token なし / API 失敗 / director 未登録なら最小プレースホルダ。
+ *
+ * 1 を最優先にしたのは、新規メンバーが workspace に入ったとき、組織で固まった
+ * CLAUDE.md（Stage 1/2 で正本化したもの）が即座に引かれて作業に取り掛かれる
+ * ようにするため。動的生成は「Hub に正本がまだ無いプロジェクト」の救済として
+ * のみ機能する。
  */
 import fs from "node:fs/promises"
 import os from "node:os"
 import path from "node:path"
+import {
+  sha256,
+  writeMeta,
+  nowIso,
+} from "./claude-md-sync.mjs"
 
 const DEFAULT_HUB_API = "https://api.hub.cocorograph.com"
 const TOKEN_PATH = path.join(os.homedir(), ".claude", ".hub_token.json")
@@ -31,6 +42,34 @@ async function loadAccessToken() {
   return (data && typeof data.access === "string" && data.access) || null
 }
 
+/**
+ * Hub の Project.claude_md 正本を取得する (Stage 3 初回配信用)。
+ *
+ * - 404 (該当 Project 無し) → null
+ * - その他のエラー → null
+ * - 取得成功時は { claude_md, claude_md_hash, claude_md_updated_at } を返す
+ *
+ * 同じエンドポイントは syncClaudeMdWithHub も使うが、ensureClaudeMd は
+ * 初回生成 (メタ無し) 経路でしか呼ばれず、PUT もしないため import せず
+ * 個別実装する。
+ */
+async function fetchHubClaudeMdProject({ hubUrl, accessToken, dirName, fetchImpl }) {
+  const f = fetchImpl || globalThis.fetch
+  if (!f) return null
+  const url =
+    `${hubUrl.replace(/\/+$/, "")}/api/admin/project/claude-md-by-dir/` +
+    `?dir_name=${encodeURIComponent(dirName)}`
+  try {
+    const res = await f(url, {
+      headers: { Authorization: `Bearer ${accessToken}` },
+    })
+    if (!res.ok) return null
+    return await res.json()
+  } catch {
+    return null
+  }
+}
+
 async function fetchDirector({ hubUrl, accessToken, dirName, fetchImpl }) {
   const f = fetchImpl || globalThis.fetch
   if (!f) return null
@@ -320,7 +359,35 @@ export async function ensureClaudeMd({
   const token =
     accessToken === undefined ? await loadAccessToken() : accessToken || null
   const url = hubUrl || DEFAULT_HUB_API
-  // director と repositories は独立して取れるので並列フェッチする。
+
+  // Stage 3: Hub に正本があればそれを最優先で書き込み、メタも初期化する
+  // （以降の syncClaudeMdWithHub が双方向同期の起点として使う）。
+  // Hub 側未保存 (claude_md_updated_at が null) なら従来パスへフォールバック。
+  if (token) {
+    const hub = await fetchHubClaudeMdProject({
+      hubUrl: url,
+      accessToken: token,
+      dirName,
+      fetchImpl,
+    })
+    const hubBody = hub?.claude_md || ""
+    const hubInitialized = !!hub?.claude_md_updated_at
+    if (hubInitialized && hubBody) {
+      await fs.writeFile(claudeMdPath, hubBody, "utf-8")
+      await writeMeta(targetDir, {
+        lastSyncedHubUpdatedAt: hub.claude_md_updated_at,
+        lastSyncedHash: hub.claude_md_hash || sha256(hubBody),
+        lastSyncedAt: nowIso(),
+      })
+      logger?.info?.(
+        { dirName, claudeMdPath },
+        "wrote CLAUDE.md from Hub project claude_md (initial sync)",
+      )
+      return { written: true, source: "hub" }
+    }
+  }
+
+  // 従来パス: director と repositories は独立して取れるので並列フェッチする。
   // どちらも失敗時は null / [] にフォールバックする (token なしの場合も同様)。
   const [director, repositories] = token
     ? await Promise.all([