@cocorograph/hub-agent 0.7.12 → 0.7.14

package/package.json

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

package/src/chat-signals.mjs

@@ -35,6 +35,17 @@ const _byCwd = new Map()
 // 一次対策で、本 TTL はその取りこぼし時のバックストップ。
 const CHAT_SIGNAL_STALE_MS = 90 * 1000
 
+// RC4 (症状④): stream_event (拡張思考の thinking_delta / 長時間ツール中の partial delta)
+// 受信を status=processing の tick として記録する際の cwd 単位スロットル間隔。stream_event は
+// トークン delta 毎に高頻度で流れるため、無制限に recordChatActivity を呼ぶと _byCwd への書き込み
+// 洪水になる。この間隔で間引いても、>90s の拡張思考バースト / 単発ツールの間 statusAt・updatedAtMs
+// を確実に前進させ、CHAT_SIGNAL_STALE_MS による idle 誤降格 (純 SDK チャットで三点リーダーが消える
+// 事故) を防げる。
+const STREAM_TICK_THROTTLE_MS = 3 * 1000
+
+// cwd → 最後に stream tick を記録した時刻 (スロットル判定用)。
+const _lastStreamTickAt = new Map()
+
 const VALID_STATUS = new Set(["processing", "waiting", "idle"])
 
 function _now() {
@@ -86,6 +97,33 @@ export function recordChatActivity(cwd, patch = {}, now = _now()) {
   _byCwd.set(cwd, next)
 }
 
+/**
+ * RC4 (症状④): stream_event (拡張思考 thinking_delta / 長時間ツール中の partial delta) 受信を
+ * status=processing の「生きている」tick として記録する。assistant / result が流れない長い無音
+ * 区間 (>90s) でも statusAt・updatedAtMs を前進させ、getChatSignal が CHAT_SIGNAL_STALE_MS で
+ * null を返して三点リーダーが消える事故を防ぐ。
+ *
+ * 設計上の注意:
+ *  - cwd 単位で STREAM_TICK_THROTTLE_MS に間引く (delta 毎の Map 書き込み洪水を回避)。
+ *  - delta 本文は一切読まない (タイムスタンプ前進のみ)。拡張思考の本文は ephemeral で、ここで
+ *    保持・転送する必要は無く、プライバシー上も読むべきでない。
+ *  - SDK のイベント順序上 stream_event はターン中の assistant ブロックに属し result より前に
+ *    流れる。abort 時は SDK query が即停止して onEvent が止まるため、result/turnsettled で
+ *    waiting に落ちた後に trailing stream_event が processing を蘇生させる経路は無い。
+ *
+ * @param {string} cwd
+ * @param {number} [now]
+ */
+export function recordChatStreamTick(cwd, now = _now()) {
+  if (!cwd || typeof cwd !== "string") return
+  // 初回 (未 tick) は必ず記録する。`|| 0` で last を 0 既定にすると「時刻 0 で tick 済み」と
+  // 区別できず、初回 tick が now < throttle のとき誤って間引かれる。has で未 tick を判定する。
+  const last = _lastStreamTickAt.get(cwd)
+  if (last !== undefined && now - last < STREAM_TICK_THROTTLE_MS) return
+  _lastStreamTickAt.set(cwd, now)
+  recordChatActivity(cwd, { status: "processing" }, now)
+}
+
 /**
  * cwd に対応する生きているチャット信号を返す。stale / 不在なら null。
  *
@@ -116,11 +154,13 @@ export function getChatSignal(cwd, now = _now()) {
 export function clearChatSignal(cwd) {
   if (!cwd || typeof cwd !== "string") return
   _byCwd.delete(cwd)
+  _lastStreamTickAt.delete(cwd)
 }
 
 /** テスト用: ストアを空にする。 */
 export function _resetChatSignals() {
   _byCwd.clear()
+  _lastStreamTickAt.clear()
 }
 
-export { CHAT_SIGNAL_STALE_MS }
+export { CHAT_SIGNAL_STALE_MS, STREAM_TICK_THROTTLE_MS }

package/src/claude-md-sync.mjs

@@ -29,6 +29,7 @@ const DEFAULT_HUB_API = "https://api.hub.cocorograph.com"
 const TOKEN_PATH = path.join(os.homedir(), ".claude", ".hub_token.json")
 const META_DIR = ".cockpit-sync"
 const META_FILE = "claude-md.json"
+const BASE_FILE = "CLAUDE.md.base"
 const BAK_KEEP = 3 // 通常 .bak と衝突 .bak それぞれ直近 3 件まで保持
 
 async function readJsonOrNull(p) {
@@ -160,6 +161,23 @@ async function writeMeta(targetDir, meta) {
   )
 }
 
+/**
+ * 同期成功時の本文を `.cockpit-sync/CLAUDE.md.base` に保存する。
+ *
+ * session-end スキル (対話中の Claude) が CLAUDE.md を Hub と 3-way merge する際の
+ * "base" 入力として使う。前回 sync 直後のローカル == Hub の本文を保持しておくことで、
+ * 「ローカル変更」と「Hub 変更」の差分を別々に抽出してから意味マージできる。
+ *
+ * meta(claude-md.json) は hash と updated_at しか持たないため、本文そのものが要る
+ * 3-way merge の用途ではこのファイルが必要。
+ */
+async function writeBaseBody(targetDir, body) {
+  if (body == null) return
+  const metaDir = path.join(targetDir, META_DIR)
+  await fs.mkdir(metaDir, { recursive: true })
+  await fs.writeFile(path.join(metaDir, BASE_FILE), body, "utf-8")
+}
+
 /**
  * 既存ローカル CLAUDE.md を .cockpit-sync/CLAUDE.md.<prefix>.<ts>.bak に退避する。
  * 同 prefix の .bak は新しい順に BAK_KEEP 件保持し、古いものから FIFO 削除する。
@@ -289,6 +307,8 @@ export async function syncClaudeMdWithHub({
       lastSyncedHash: hubHash || sha256(hubBody),
       lastSyncedAt: nowIso(),
     })
+    // 3-way merge 用 base: pull 直後はローカル == Hub なので Hub 本文を base に。
+    await writeBaseBody(targetDir, hubBody)
     logger?.info?.({ dirName }, "syncClaudeMdWithHub: pull")
     return { action: "pull" }
   }
@@ -315,6 +335,9 @@ export async function syncClaudeMdWithHub({
       lastSyncedHash: localCurrentHash,
       lastSyncedAt: nowIso(),
     })
+    // 3-way merge 用 base: push 直後は Hub の正本がローカルと一致するので、
+    // 次回の base は今 push した本文 (= localBody)。
+    await writeBaseBody(targetDir, localBody || "")
     logger?.info?.({ dirName }, "syncClaudeMdWithHub: push")
     return { action: "push" }
   }
@@ -339,6 +362,8 @@ export async function syncClaudeMdWithHub({
     lastSyncedHash: localCurrentHash,
     lastSyncedAt: nowIso(),
   })
+  // 3-way merge 用 base: conflict push 後の Hub 正本は端末側本文 (= localBody)。
+  await writeBaseBody(targetDir, localBody || "")
   logger?.warn?.(
     { dirName },
     "syncClaudeMdWithHub: conflict (terminal wins); hub body saved to .bak.conflict",
@@ -349,13 +374,15 @@ export async function syncClaudeMdWithHub({
 // メタ操作・ハッシュ計算は ensureClaudeMd 側 (Hub pull 初回配信) でも使うため
 // named export する。同じファイルパス・同じスキーマで管理することで、初回配信と
 // 以降の sync で食い違いを起こさない。
-export { sha256, readMeta, writeMeta, nowIso }
+export { sha256, readMeta, writeMeta, writeBaseBody, nowIso }
 
 // 内部テスト用エクスポート
 export const _internals = {
   sha256,
   readMeta,
   writeMeta,
+  writeBaseBody,
   backupLocalClaudeMd,
   BAK_KEEP,
+  BASE_FILE,
 }

package/src/claude-md.mjs

@@ -22,6 +22,7 @@ import path from "node:path"
 import {
   sha256,
   writeMeta,
+  writeBaseBody,
   nowIso,
 } from "./claude-md-sync.mjs"
 
@@ -379,6 +380,8 @@ export async function ensureClaudeMd({
         lastSyncedHash: hub.claude_md_hash || sha256(hubBody),
         lastSyncedAt: nowIso(),
       })
+      // 初回 pull 直後は base = Hub 本文。以降の session-end 3-way merge の入力。
+      await writeBaseBody(targetDir, hubBody)
       logger?.info?.(
         { dirName, claudeMdPath },
         "wrote CLAUDE.md from Hub project claude_md (initial sync)",

package/src/main.mjs

@@ -92,7 +92,12 @@ import {
   getUsage,
   recordChatRateLimit,
 } from "./usage.mjs"
-import { clearChatSignal, getChatSignal, recordChatActivity } from "./chat-signals.mjs"
+import {
+  clearChatSignal,
+  getChatSignal,
+  recordChatActivity,
+  recordChatStreamTick,
+} from "./chat-signals.mjs"
 import {
   ReadinessTracker,
   busyChildCount,
@@ -491,6 +496,17 @@ export async function startDaemon({ version, ptyModule, claudeSdk } = {}) {
         } catch {
           /* ignore */
         }
+      } else if (event?.type === "stream_event") {
+        // RC4 (症状④): 拡張思考 (thinking_delta) や長時間ツール中の partial delta では
+        // assistant / result が流れず statusAt / updatedAtMs が前進しないため、>90s の無音で
+        // getChatSignal が CHAT_SIGNAL_STALE_MS により null を返し、capture-pane が idle な
+        // 純 SDK チャットで三点リーダーが消える。stream_event 受信を throttle 付き processing
+        // tick として記録し statusAt を前進させる (本文は読まずタイムスタンプ前進のみ)。
+        try {
+          recordChatStreamTick(cwd)
+        } catch {
+          /* ignore */
+        }
       }
       client.send({ type: "claude.event", stream_id, session_id, event })
     })