@cocorograph/hub-agent 0.7.12 → 0.7.13

package/package.json

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

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)",