@cocorograph/hub-agent 0.6.0 → 0.6.2

package/package.json

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

package/src/claude-history.mjs

@@ -0,0 +1,169 @@
+/**
+ * Claude Code のローカル会話履歴 (`~/.claude/projects/<cwd-encoded>/<session-id>.jsonl`)
+ * を読んで browser に返すモジュール (Sprint G hotfix 0.6.1)。
+ *
+ * 用途: Cockpit ChatView が re-mount された時に、SDK の `--resume <session_id>` で
+ * モデル側の文脈は復元されるが UI 側 messages は空のままという違和感を解消するため、
+ * 同じ jsonl ファイルを直読みして過去メッセージを UI に hydrate する。
+ *
+ * 設計:
+ * - cwd エンコード規則: `/`, `.`, `_` などの非英数字を `-` 置換 (Claude CLI と同じ)
+ * - 1 行 = 1 JSON。`type` が 'user' / 'assistant' / 'system' / 'result' のものだけ抽出
+ *   (内部 type 'attachment' / 'last-prompt' / 'permission-mode' 等は UI 表示対象外)
+ * - 上限 MAX_HISTORY_LINES (デフォルト 500) で末尾から切る
+ * - ファイル不在 (新規セッション) なら空配列を返す (エラーにしない)
+ */
+import { readFile, readdir, stat } from "node:fs/promises"
+import os from "node:os"
+import path from "node:path"
+
+export const MAX_HISTORY_LINES = 500
+
+/** UI 表示対象の SDK message type (それ以外は jsonl 内部メタなので除外)。 */
+const DISPLAY_TYPES = new Set(["user", "assistant", "system", "result"])
+
+/**
+ * cwd 文字列を Claude Code の project dir 名に変換する。
+ * 例: `/Users/kaz/hub/projects/D00585_partition-lab`
+ *  → `-Users-kaz-hub-projects-D00585-partition-lab`
+ *
+ * Claude CLI のエンコード規則は「英数字とハイフン以外を `-` 置換」。連続する非英数字は
+ * そのまま連続ハイフンになる (例: `/.claude/` → `--claude-`)。
+ *
+ * @param {string} cwd
+ * @returns {string}
+ */
+export function encodeCwdToDirName(cwd) {
+  if (!cwd) return ""
+  return cwd.replace(/[^A-Za-z0-9-]/g, "-")
+}
+
+/** `~/.claude/projects/<encoded>/<session_id>.jsonl` の絶対パス。 */
+export function jsonlPath({ cwd, session_id, projectsRoot }) {
+  const root = projectsRoot || path.join(os.homedir(), ".claude", "projects")
+  return path.join(root, encodeCwdToDirName(cwd), `${session_id}.jsonl`)
+}
+
+/**
+ * jsonl 1 ファイルを読んで UI 表示用イベント配列を返す。
+ *
+ * 末尾 maxLines 行に絞ってから JSON.parse + DISPLAY_TYPES でフィルタ。
+ * 大きいファイルでも先頭から全行 parse する必要はないが、line buffer を最小化
+ * するため簡易実装で全文 readFile → split → 末尾 slice する (典型 1MB 未満想定)。
+ *
+ * @param {string} filePath
+ * @param {{maxLines?: number, logger?: import('pino').Logger}} [opts]
+ * @returns {Promise<{events: object[], total_lines: number, truncated: boolean}>}
+ */
+export async function readSessionHistory(filePath, { maxLines = MAX_HISTORY_LINES, logger } = {}) {
+  let text
+  try {
+    text = await readFile(filePath, "utf-8")
+  } catch (err) {
+    if (err.code === "ENOENT") {
+      return { events: [], total_lines: 0, truncated: false }
+    }
+    logger?.warn({ err: err.message, filePath }, "claude history read failed")
+    throw err
+  }
+  // 末尾 newline は捨てる
+  const lines = text.split("\n").filter((l) => l.length > 0)
+  const total_lines = lines.length
+  const truncated = total_lines > maxLines
+  const slice = truncated ? lines.slice(-maxLines) : lines
+
+  const events = []
+  for (const line of slice) {
+    let obj
+    try {
+      obj = JSON.parse(line)
+    } catch {
+      continue
+    }
+    if (!obj || typeof obj !== "object") continue
+    if (!DISPLAY_TYPES.has(obj.type)) continue
+    // SDK message と同じ shape にする (余分な meta は落とす)
+    const event = { type: obj.type }
+    if (obj.message !== undefined) event.message = obj.message
+    if (obj.subtype !== undefined) event.subtype = obj.subtype
+    if (obj.session_id !== undefined) event.session_id = obj.session_id
+    else if (obj.sessionId !== undefined) event.session_id = obj.sessionId
+    if (obj.model !== undefined) event.model = obj.model
+    if (obj.cwd !== undefined) event.cwd = obj.cwd
+    if (obj.tools !== undefined) event.tools = obj.tools
+    if (obj.permissionMode !== undefined) event.permissionMode = obj.permissionMode
+    if (obj.total_cost_usd !== undefined) event.total_cost_usd = obj.total_cost_usd
+    if (obj.duration_ms !== undefined) event.duration_ms = obj.duration_ms
+    if (obj.num_turns !== undefined) event.num_turns = obj.num_turns
+    if (obj.usage !== undefined) event.usage = obj.usage
+    events.push(event)
+  }
+  return { events, total_lines, truncated }
+}
+
+/**
+ * cwd + session_id から jsonl を読み、Browser が `claude.history.response` として
+ * 受け取れる shape で返す。
+ *
+ * @param {{cwd: string, session_id: string, maxLines?: number, projectsRoot?: string, logger?: import('pino').Logger}} args
+ */
+export async function fetchSessionHistory({ cwd, session_id, maxLines, projectsRoot, logger }) {
+  if (!cwd || !session_id) {
+    return { events: [], total_lines: 0, truncated: false, error: "missing_cwd_or_session_id" }
+  }
+  const filePath = jsonlPath({ cwd, session_id, projectsRoot })
+  try {
+    const result = await readSessionHistory(filePath, { maxLines, logger })
+    return { ...result, file_path: filePath }
+  } catch (err) {
+    return {
+      events: [],
+      total_lines: 0,
+      truncated: false,
+      error: err.message || String(err),
+      file_path: filePath,
+    }
+  }
+}
+
+/**
+ * cwd 配下の全 jsonl ファイルから session 一覧を返す (Phase 2 用、現状未使用)。
+ * 各ファイルから session_id / 最終更新時刻 / 最初の user message の冒頭を抽出。
+ *
+ * @param {{cwd: string, projectsRoot?: string, logger?: import('pino').Logger}} args
+ */
+export async function listSessions({ cwd, projectsRoot, logger }) {
+  if (!cwd) return { sessions: [] }
+  const dir = path.join(
+    projectsRoot || path.join(os.homedir(), ".claude", "projects"),
+    encodeCwdToDirName(cwd),
+  )
+  let files
+  try {
+    files = await readdir(dir)
+  } catch (err) {
+    if (err.code === "ENOENT") return { sessions: [] }
+    logger?.warn({ err: err.message, dir }, "claude history list failed")
+    return { sessions: [], error: err.message }
+  }
+  const sessions = []
+  for (const f of files) {
+    if (!f.endsWith(".jsonl")) continue
+    const session_id = f.slice(0, -".jsonl".length)
+    const filePath = path.join(dir, f)
+    try {
+      const st = await stat(filePath)
+      sessions.push({
+        session_id,
+        file_path: filePath,
+        mtime: st.mtimeMs,
+        size_bytes: st.size,
+      })
+    } catch {
+      // ignore individual file stat errors
+    }
+  }
+  // 最新順
+  sessions.sort((a, b) => b.mtime - a.mtime)
+  return { sessions }
+}

package/src/main.mjs

@@ -22,6 +22,7 @@ import { loadPlugins, runHookBroadcast, runHookChain } from "./plugin-loader.mjs
 import { WsClient } from "./ws-client.mjs"
 import { PtyBridge } from "./pty-bridge.mjs"
 import { ClaudeStreamBridge } from "./claude-stream-bridge.mjs"
+import { fetchSessionHistory } from "./claude-history.mjs"
 import { listAgents } from "./agents.mjs"
 import { listSkills } from "./skills.mjs"
 import { listSessionStates } from "./state.mjs"
@@ -229,6 +230,16 @@ export async function startDaemon({ version, ptyModule, claudeSdk } = {}) {
 
   client.connect()
 
+  // 0.6.2 fix: event loop を ref されたまま生かしておく watchdog。
+  // hub-agent の他の background task (heartbeat / reconnect / state loop / fs.watch)
+  // は全て .unref() / persistent:false なので、長時間アイドル + WS 切断 + pty 全 GC
+  // が同時発生すると Node が「やることなし」と判断して exit(0) で silent 終了する
+  // 既存バグがあった。watchdog を 1 つ ref のまま持つことで exit を防ぐ。
+  // shutdown 時に clearInterval して正常終了を許可する。
+  const keepaliveTimer = setInterval(() => {
+    // no-op. ref されていることだけが重要。
+  }, 60_000)
+
   // 5s 周期で全 tmux session の状態を捕捉し、変化したものだけ session.state を push。
   // browser がフォーカスしていない session でも常時更新するためのバックグラウンド職人。
   const stateLoop = startStateLoop({ client, plugins, logger, intervalMs: 5_000 })
@@ -245,11 +256,30 @@ export async function startDaemon({ version, ptyModule, claudeSdk } = {}) {
     ptyBridge.shutdown()
     claudeBridge?.shutdown?.()
     client.stop()
+    // 0.6.2 fix: watchdog を解放して event loop を抜けられるようにする
+    clearInterval(keepaliveTimer)
     process.exit(0)
   }
   process.on("SIGINT", () => shutdown("SIGINT"))
   process.on("SIGTERM", () => shutdown("SIGTERM"))
 
+  // 0.6.2 fix: 例外で silent 終了しないよう最後のセーフティネット。
+  // Node 24 で unhandledRejection は default で process を kill する仕様のため、
+  // warn ログだけ出して継続させる (本来の原因は別途修正必要だが、agent が落ちて
+  // ユーザー作業が止まる方が痛い)。
+  process.on("unhandledRejection", (reason, promise) => {
+    logger.error(
+      { reason: String(reason), stack: reason?.stack },
+      "unhandledRejection (agent kept alive by watchdog)",
+    )
+  })
+  process.on("uncaughtException", (err) => {
+    logger.error(
+      { err: err?.message, stack: err?.stack },
+      "uncaughtException (agent kept alive by watchdog)",
+    )
+  })
+
   return { client, plugins, ptyBridge, claudeBridge }
 }
 
@@ -631,6 +661,31 @@ async function dispatch(msg, ctx) {
         if (!ctx.claudeBridge) return
         ctx.claudeBridge.detach({ stream_id: msg.stream_id })
         return
+      case "claude.history.request": {
+        // Sprint G 0.6.1: ~/.claude/projects/<cwd-encoded>/<session_id>.jsonl を読んで
+        // 過去メッセージを返す。ChatView の re-mount 時の UI 復元用。
+        // stream_id は per-stream routing のため必須 (browser 側 stream に紐付ける)。
+        const stream_id = msg.stream_id
+        const cwd = msg.cwd || ""
+        const session_id = msg.session_id || ""
+        const maxLines = typeof msg.max_lines === "number" ? msg.max_lines : undefined
+        const result = await fetchSessionHistory({
+          cwd,
+          session_id,
+          maxLines,
+          logger: ctx.logger,
+        })
+        ctx.client.send({
+          type: "claude.history.response",
+          stream_id,
+          session_id,
+          events: result.events,
+          total_lines: result.total_lines,
+          truncated: result.truncated,
+          error: result.error,
+        })
+        return
+      }
       case "tmux.exec": {
         const args = Array.isArray(msg.args) ? msg.args : []
         const hookResult = await runHookChain(ctx.plugins, "interceptTmuxExec", {

package/templates/co.cocorograph.hub-agent.plist

@@ -15,13 +15,20 @@
   <key>RunAtLoad</key>
   <true/>
 
+  <!--
+    KeepAlive を無条件 true に変更 (0.6.2 fix)。
+    旧設定 `SuccessfulExit=false` は「正常終了 (exit 0) なら再起動しない」だが、
+    hub-agent の全 background task (heartbeat / reconnect / state loop / fs.watch) が
+    .unref() されているため、長時間アイドル + WS 切断 + pty GC kill で全 ref が
+    0 になり Node が exit(0) で「正常終了」する事象が頻発していた。launchctl が
+    「正常終了だから restart 不要」と判断し、agent が静かに停止 → ユーザーは
+    「offline」表示で気づく。本修正で「どんな exit code でも再起動」に変更し
+    ThrottleInterval=10s で spawn loop も防ぐ。
+    main.mjs 側にも watchdog setInterval を追加して exit 自体を起こさない設計に
+    したが、plist 側の defense in depth として KeepAlive も無条件化する。
+  -->
   <key>KeepAlive</key>
-  <dict>
-    <key>SuccessfulExit</key>
-    <false/>
-    <key>NetworkState</key>
-    <true/>
-  </dict>
+  <true/>
 
   <key>StandardOutPath</key>
   <string>__HOME__/.hub/agent.log</string>