@cocorograph/hub-agent 0.6.88 → 0.6.90

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cocorograph/hub-agent",
-  "version": "0.6.88",
+  "version": "0.6.90",
   "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([

package/src/main.mjs

@@ -1051,6 +1051,11 @@ export async function maybeSyncClaudeSettings(msg, ctx) {
   }
 }
 
+// Plan ε grace guard の猶予 (ms)。backend の集計タイムアウト (_STREAMS_SYNC_TIMEOUT_S=0.5s)
+// + browser の WS 再接続 + 再 attach を十分に超える値。これ以内に touch された stream は
+// 「再 attach 中で sync に間に合わなかっただけ」とみなして誤殺しない。10min GC より十分短い。
+const STREAMS_SYNC_GRACE_MS = 45_000
+
 /**
  * Plan ε: `agent.streams.sync.response` を受けて backend ↔ agent の現存
  * stream_id を能動同期する。
@@ -1066,14 +1071,34 @@ export function handleStreamsSyncResponse(msg, ctx) {
     Array.isArray(msg?.active_stream_ids) ? msg.active_stream_ids : [],
   )
   const localIds = new Set(ctx.ptyBridge.list())
+  // churn 退化スナップショット保護 (ack_lost 根治 / 2026-06-17 根因 rank3)。
+  // backend は browser 群へ _STREAMS_SYNC_TIMEOUT_S(0.5s) だけ問い合わせて active set を
+  // 集める。再接続バースト中 (本番 ~20s 間隔・code 1006) は browser がまだ再 attach できて
+  // おらず空/部分的な set が返り、その一瞬を authoritative とみなして「ローカル全 stream が
+  // 孤児」と誤判定し、生きている PTY を皆殺しにしていた (再 attach 直後の stream を 1 秒後に
+  // 殺し、以後の入力が stream_missing → 数分単位の「送信待ち」固着。0.6.89 ログ最多 churn 源)。
+  // 空 set は信用せず kill を一切行わない (真の孤児は 10min GC + maxStreams 上限が回収する)。
+  const haveAuthoritativeActiveSet = activeIds.size > 0
   for (const sid of localIds) {
-    if (!activeIds.has(sid)) {
-      ctx.logger?.warn?.(
-        { stream_id: sid, request_id: msg?.request_id },
-        "Plan ε: orphan stream detected, detaching",
+    if (activeIds.has(sid)) continue
+    if (!haveAuthoritativeActiveSet) continue
+    // grace guard: 直近 STREAMS_SYNC_GRACE_MS 以内に touch (attach/write/resize/pty 出力) された
+    // stream は「browser が再接続中で 0.5s 集計に間に合わなかっただけ」の可能性が高い。猶予内は
+    // 殺さず延命する。真に放置された孤児は猶予超過で従来どおり detach され、10min GC も backstop。
+    const lastSeen = ctx.ptyBridge.getLastSeen?.(sid) ?? 0
+    const idleMs = Date.now() - lastSeen
+    if (lastSeen > 0 && idleMs < STREAMS_SYNC_GRACE_MS) {
+      ctx.logger?.info?.(
+        { stream_id: sid, idle_ms: idleMs, request_id: msg?.request_id },
+        "Plan ε: skip detach (within grace, browser likely re-attaching)",
       )
-      ctx.ptyBridge.detach({ stream_id: sid })
+      continue
     }
+    ctx.logger?.warn?.(
+      { stream_id: sid, request_id: msg?.request_id },
+      "Plan ε: orphan stream detected, detaching",
+    )
+    ctx.ptyBridge.detach({ stream_id: sid })
   }
   for (const sid of activeIds) {
     if (!localIds.has(sid)) {

package/src/pty-bridge.mjs

@@ -169,6 +169,17 @@ export class PtyBridge extends EventEmitter {
     this.lastSeenAt.set(stream_id, this._now())
   }
 
+  /**
+   * stream の最終 touch 時刻 (ms epoch) を返す。未登録 / 未 touch は 0。
+   * Plan ε (handleStreamsSyncResponse) の grace 判定で「直近 attach/write/resize/出力が
+   * あった stream は browser が再 attach 中なだけ」と見なして誤殺を防ぐために使う。
+   * @param {string} stream_id
+   * @returns {number}
+   */
+  getLastSeen(stream_id) {
+    return this.lastSeenAt.get(stream_id) ?? 0
+  }
+
   /**
    * `gcStaleMs` を超えて idle な stream を一括 reap する。
    *