claude-ai-office 0.25.1 → 0.25.6

package/bin/ai-office.js

@@ -17,6 +17,7 @@ const os = require('os');
 const net = require('net');
 const { spawn, execFileSync } = require('child_process');
 const { readHookPort } = require('../lib/hookport');
+const { isVersionedNodePath } = require('../lib/nodepath');
 const crypto = require('crypto');
 
 const SRC = path.join(__dirname, '..');
@@ -65,6 +66,11 @@ function fingerprint(dir) {
 const runningFromSource = () => path.resolve(SRC) !== path.resolve(APP) && fs.existsSync(path.join(SRC, '.git'));
 function install({ force = false } = {}) {
   if (path.resolve(SRC) === path.resolve(APP)) return APP; // 이미 설치 경로에서 실행 중
+  // 데스크톱 앱이 관리하는 설치본(.app-version 스탬프)은 덮어쓰지 않는다. 덮으면 다음 앱 실행 때 앱 버전으로 되돌아가 서로 덮어쓴다
+  if (!force && fs.existsSync(path.join(APP, '.app-version'))) {
+    log(`AI Office 앱이 ${APP} 를 관리하고 있어 그대로 둡니다 (앱 ${fs.readFileSync(path.join(APP, '.app-version'), 'utf8').trim()}, 덮어쓰려면 --force)`);
+    return APP;
+  }
   const have = installedVersion();
   const fp = fingerprint(SRC);
   let installedFp = null;
@@ -125,7 +131,7 @@ async function doctor() {
   log(`node      ${process.version} ${major >= 18 ? '✓' : '✗ 18 이상 필요'}  (${process.execPath})`);
   log(`platform  ${process.platform} ${os.release()}`);
   const settings = process.env.CLAUDE_SETTINGS || path.join(os.homedir(), '.claude', 'settings.json');
-  let hooks = 0, stale = 0;
+  let hooks = 0, stale = 0, versioned = 0;
   try {
     const h = JSON.parse(fs.readFileSync(settings, 'utf8')).hooks || {};
     for (const ev of Object.values(h)) for (const g of ev) for (const x of g.hooks || []) {
@@ -135,9 +141,11 @@ async function doctor() {
         if (m && !fs.existsSync(m[1])) stale++;
         const n = /^"([^"]+)"/.exec(x.command); // 앞의 node 경로(앱이 등록한 내장 node 등)도 있어야 한다
         if (n && n[1] !== 'node' && !fs.existsSync(n[1])) stale++;
+        if (n && isVersionedNodePath(n[1])) versioned++;
       }
     }
     log(`settings  ${settings} ✓  훅 ${hooks}개 등록${stale ? `, ${stale}개는 node 또는 emit.js 파일 없음 → ai-office install-hooks` : ''}`);
+    if (versioned) log(`          ⚠ 훅 ${versioned}개가 Node 버전 폴더 경로라 brew upgrade 뒤 깨질 수 있음 → ai-office install-hooks`);
   } catch { log(`settings  ${settings} ✗ 읽을 수 없음`); }
   log(`app       ${installedVersion() ? `${installedVersion()} @ ${APP} ✓` : '미설치 (ai-office install)'}`);
   log(`port      ${PORT} ${(await portInUse(PORT)) ? '사용 중 (서버 떠 있음)' : '비어 있음'}`);

package/lib/nodepath.js

@@ -0,0 +1,34 @@
+'use strict';
+// 훅 명령에 넣을 Node 경로 (BE-18). Node 를 업그레이드해도 깨지지 않는 경로를 고른다.
+//   1) ~/.ai-office/node(.exe): 데스크톱 앱이 복사해 둔 Node. 앱과 CLI 가 같은 훅 명령을 쓰게 된다
+//   2) Homebrew 의 버전 폴더(/opt/homebrew/Cellar/node/26.12.0/bin/node) → 버전 없는 opt 링크(/opt/homebrew/opt/node/bin/node)
+//   3) 그 밖에는 실행 중인 Node 그대로
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const CELLAR = /^(.*)[\\/]Cellar[\\/](node(?:@\d+)?)[\\/][^\\/]+[\\/]bin[\\/]node$/;
+
+function isFile(p, fsImpl) { try { return fsImpl.statSync(p).isFile(); } catch { return false; } }
+
+/** Homebrew Cellar 의 버전 폴더 경로인가 (업그레이드·cleanup 때 사라진다) */
+function isVersionedNodePath(p) { return CELLAR.test(String(p || '')); }
+
+function stableNodePath({
+  execPath = process.execPath,
+  home = process.env.AI_OFFICE_HOME || path.join(os.homedir(), '.ai-office'),
+  platform = process.platform,
+  fsImpl = fs,
+} = {}) {
+  const appNode = path.join(home, platform === 'win32' ? 'node.exe' : 'node');
+  if (isFile(appNode, fsImpl)) return appNode;
+  const m = CELLAR.exec(execPath);
+  if (m) {
+    const sep = execPath.includes('\\') && !execPath.includes('/') ? '\\' : '/'; // Homebrew 경로는 POSIX, 그 구분자를 그대로 쓴다 (Windows 의 path.join 은 \\ 를 쓴다)
+    const opt = [m[1], 'opt', m[2], 'bin', 'node'].join(sep);
+    if (isFile(opt, fsImpl)) return opt;
+  }
+  return execPath;
+}
+
+module.exports = { stableNodePath, isVersionedNodePath };

package/lib/state.js

@@ -40,7 +40,50 @@ function defaultStat(file) {
   try { return { mtimeMs: fs.statSync(file).mtimeMs }; } catch { return null; }
 }
 
-function createState({ me = 'me', statFile = defaultStat, styleFile = null } = {}) {
+const FIRST_PROMPT_HEAD_BYTES = 1024 * 1024;
+/** transcript 앞부분에서 첫 사용자 메시지(실제 요청)를 읽는다. 이미지가 붙은 첫 줄은 수백 KB 라 잘려도 텍스트만 뽑는다. 없으면 null */
+function defaultFirstPrompt(file) {
+  let fd;
+  try {
+    fd = fs.openSync(file, 'r');
+    const buf = Buffer.alloc(FIRST_PROMPT_HEAD_BYTES);
+    const n = fs.readSync(fd, buf, 0, buf.length, 0);
+    for (const line of buf.subarray(0, n).toString('utf8').split('\n')) {
+      if (!line.includes('"type":"user"') || line.includes('"isMeta":true')) continue;
+      let text = null;
+      try {
+        const c = JSON.parse(line).message?.content;
+        text = typeof c === 'string' ? c : Array.isArray(c) ? (c.find((x) => x && x.type === 'text') || {}).text : null;
+      } catch { // 잘린 줄: 첫 "text" 값만 꺼낸다
+        const m = /"content":"((?:[^"\\]|\\.)*)"|"type":"text","text":"((?:[^"\\]|\\.)*)"/.exec(line);
+        if (m) try { text = JSON.parse(`"${m[1] ?? m[2]}"`); } catch {}
+      }
+      if (text && text.trim() && !/^\s*</.test(text)) return text.trim();
+    }
+    return null;
+  } catch { return null; } finally { if (fd !== undefined) try { fs.closeSync(fd); } catch {} }
+}
+
+const TITLE_TAIL_BYTES = 64 * 1024;
+/** transcript 끝부분에서 마지막 세션 제목(custom-title 기록)을 읽는다. 없거나 못 읽으면 null */
+function defaultTitle(file) {
+  let fd;
+  try {
+    fd = fs.openSync(file, 'r');
+    const size = fs.fstatSync(fd).size;
+    const len = Math.min(size, TITLE_TAIL_BYTES);
+    const buf = Buffer.alloc(len);
+    fs.readSync(fd, buf, 0, len, size - len);
+    const lines = buf.toString('utf8').split('\n');
+    for (let i = lines.length - 1; i >= 0; i--) {
+      if (!lines[i].includes('"custom-title"')) continue;
+      try { const j = JSON.parse(lines[i]); if (j.type === 'custom-title' && typeof j.customTitle === 'string' && j.customTitle.trim()) return j.customTitle.trim(); } catch {}
+    }
+    return null;
+  } catch { return null; } finally { if (fd !== undefined) try { fs.closeSync(fd); } catch {} }
+}
+
+function createState({ me = 'me', statFile = defaultStat, titleOf = defaultTitle, firstPromptOf = defaultFirstPrompt, styleFile = null } = {}) {
   const emitter = new EventEmitter();
   const floors = new Map();   // cwd → Floor
   const sessions = new Map(); // session_id → Session
@@ -115,13 +158,14 @@ function createState({ me = 'me', statFile = defaultStat, styleFile = null } = {
       s = {
         id: ev.sessionId, floorId: floor.id, title: ev.sessionTitle, status: 'idle',
         startedAt: now, lastActivity: now, agents: {}, pendingSubagents: [], ended: false, firstPrompt: '', lastPrompt: '',
-        transcriptPath: ev.transcriptPath, lastStatAt: 0,
+        transcriptPath: ev.transcriptPath, lastStatAt: 0, titleMtime: 0, firstPromptChecked: false, hookTitle: '', fileTitle: '',
         cwd: ev.cwd || '', branch: proj ? proj.branch : '', worktree: proj && proj.worktree ? path.basename(proj.worktreeDir) : '',
       };
       sessions.set(s.id, s);
       floor.sessions.add(s.id);
     }
-    if (ev.sessionTitle && !s.title) s.title = ev.sessionTitle;
+    // 제목: 훅의 session_title 이 바뀔 때마다 따른다 (분리된 세션은 부모 제목으로 시작했다가 이름이 바뀐다)
+    if (ev.sessionTitle && ev.sessionTitle !== s.hookTitle) { s.hookTitle = ev.sessionTitle; retitle(s, floor, ev.sessionTitle, now); }
     if (ev.transcriptPath) s.transcriptPath = ev.transcriptPath;
     s.lastActivity = now;
     floor.lastActivity = now;
@@ -183,6 +227,15 @@ function createState({ me = 'me', statFile = defaultStat, styleFile = null } = {
 
   function schedule(at, fn) { timers.push({ at, fn }); }
 
+  /** 세션 제목 변경. 이전 제목이 있었으면 로그 한 줄 + update 를 보낸다. 바뀌었으면 true */
+  function retitle(s, floor, title, now) {
+    if (!title || title === s.title) return false;
+    const had = !!s.title;
+    s.title = title;
+    if (had && floor) emitUpdate(s, floor, pushLog(now, floor, s, s.agents.main || null, '🏷️', `제목: ${cut(title, 60)}`));
+    return true;
+  }
+
   // ---------- 전이 ----------
   function apply(payload, now = Date.now()) {
     if (!payload || typeof payload !== 'object') return;
@@ -354,12 +407,27 @@ function createState({ me = 'me', statFile = defaultStat, styleFile = null } = {
       if (s.ended) continue;
       const idle = now - s.lastActivity;
       if (idle >= SESSION_TTL_MS) { endSilently(s, now, '2시간 무활동'); continue; }
-      // transcript 가 더 이상 갱신되지 않으면 터미널이 닫힌 것으로 본다
-      if (idle >= GONE_CHECK_MS && s.transcriptPath && now - s.lastStatAt >= STAT_INTERVAL_MS) {
+      // transcript 확인은 세션당 1분에 한 번 (stat 한 번을 제목 · 퇴근 감지가 같이 쓴다)
+      if (s.transcriptPath && (!s.lastStatAt || now - s.lastStatAt >= STAT_INTERVAL_MS)) {
         s.lastStatAt = now;
         const st = statFile(s.transcriptPath);
-        if (!st) { endSilently(s, now, 'transcript 없음'); continue; }
-        if (st.mtimeMs <= s.lastActivity && idle >= GONE_MS) { endSilently(s, now, '터미널 종료 추정'); continue; }
+        // 첫 요청: 저널은 최근 2시간만 재생하므로 오래된 세션은 첫 요청 자리에 최근 프롬프트가 들어간다 → transcript 에서 한 번 복원
+        if (st && !s.firstPromptChecked) {
+          s.firstPromptChecked = true;
+          const fp = firstPromptOf(s.transcriptPath);
+          if (fp) s.firstPrompt = cut(fp, 120);
+        }
+        // 제목: 훅 없이 이름만 바뀐 경우 transcript 의 마지막 custom-title 로 따라간다 (파일이 바뀌었을 때만 읽음)
+        if (st && st.mtimeMs !== s.titleMtime) {
+          s.titleMtime = st.mtimeMs;
+          const t = titleOf(s.transcriptPath);
+          if (t && t !== s.fileTitle) { s.fileTitle = t; retitle(s, floors.get(s.floorId), t, now); }
+        }
+        // transcript 가 더 이상 갱신되지 않으면 터미널이 닫힌 것으로 본다
+        if (idle >= GONE_CHECK_MS) {
+          if (!st) { endSilently(s, now, 'transcript 없음'); continue; }
+          if (st.mtimeMs <= s.lastActivity && idle >= GONE_MS) { endSilently(s, now, '터미널 종료 추정'); continue; }
+        }
       }
       if (idle >= AWAY_MS && s.status !== 'away') {
         s.status = 'away';
@@ -390,4 +458,4 @@ function createState({ me = 'me', statFile = defaultStat, styleFile = null } = {
   return { apply, remove, removeDemo, sweep, snapshot, setFloorStyle, on: emitter.on.bind(emitter), get: (id) => sessions.get(id) };
 }
 
-module.exports = { createState, restRoomFor, REST_ROOMS, REST_BUBBLE, REST_ICON, LOG_LIMIT, SESSION_TTL_MS, SUBAGENT_LEAVE_MS, SESSION_LEAVE_MS, AWAY_MS, GONE_CHECK_MS, GONE_MS, STAT_INTERVAL_MS };
+module.exports = { defaultTitle, defaultFirstPrompt, createState, restRoomFor, REST_ROOMS, REST_BUBBLE, REST_ICON, LOG_LIMIT, SESSION_TTL_MS, SUBAGENT_LEAVE_MS, SESSION_LEAVE_MS, AWAY_MS, GONE_CHECK_MS, GONE_MS, STAT_INTERVAL_MS };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-ai-office",
-  "version": "0.25.1",
+  "version": "0.25.6",
   "description": "Claude Code 세션 활동을 아이소메트릭 사무실로 실시간 시각화",
   "keywords": [
     "claude",

package/public/js/i18n.js

@@ -4,8 +4,16 @@
 // 서버가 보내는 말풍선·로그도 한국어라 같은 규칙으로 번역한다.
 const KEY = 'aiOffice.lang';
 export const LANGS = [['ko', '한국어'], ['en', 'English']];
+/** 브라우저면 localStorage, Node(테스트)면 테스트가 직접 넣은 것만 쓴다 — Node 25+ 의 실험용 localStorage getter 는 접근만 해도 경고를 찍는다 */
+function storage() {
+  try {
+    if (typeof window !== 'undefined') return window.localStorage;
+    const d = Object.getOwnPropertyDescriptor(globalThis, 'localStorage');
+    return d && 'value' in d ? d.value : null;
+  } catch { return null; }
+}
 let lang = (() => {
-  try { const v = localStorage.getItem(KEY); if (v === 'ko' || v === 'en') return v; } catch {}
+  try { const v = storage()?.getItem(KEY); if (v === 'ko' || v === 'en') return v; } catch {}
   return (typeof navigator !== 'undefined' && /^ko/i.test(navigator.language || '')) ? 'ko' : 'en';
 })();
 export function getLang() { return lang; }
@@ -85,6 +93,7 @@ const RULES = [
   [/^(.+) 사용 중$/, (m) => `using ${m[1]}`],
   [/^(.+) 실패: (.+)$/, (m) => `${m[1]} failed: ${m[2]}`],
   [/^허락 요청: (.+)$/, (m) => `permission request: ${m[1]}`],
+  [/^제목: (.+)$/, (m) => `title: ${m[1]}`],
   [/^완료: (.+)$/, (m) => `done: ${m[1]}`],
   [/^알림 수신 \((.+)\)$/, (m) => `notification (${m[1]})`],
   [/^세션 종료 \((.+)\)$/, (m) => `session ended (${m[1]})`],
@@ -193,7 +202,7 @@ export function setLang(v) {
   if (v !== 'ko' && v !== 'en') return;
   if (v === lang) return;
   lang = v;
-  try { localStorage.setItem(KEY, v); } catch {}
+  try { storage()?.setItem(KEY, v); } catch {}
   cache.clear();
   if (typeof document !== 'undefined') { document.documentElement.lang = v; walk(document.body); }
   for (const fn of listeners) fn(v);

package/scripts/install-hooks.js

@@ -6,6 +6,7 @@
 const fs = require('fs');
 const path = require('path');
 const os = require('os');
+const { stableNodePath } = require('../lib/nodepath');
 
 const EVENTS = [
   'SessionStart', 'SessionEnd', 'UserPromptSubmit', 'PreToolUse', 'PostToolUse',
@@ -21,7 +22,8 @@ const argNode = (() => { const i = process.argv.indexOf('--node'); return i >= 0
 
 // Windows/macOS/Linux 공통: "<node 절대경로>" "<app>/hooks/emit.js"  (공백·역슬래시 경로 대비 따옴표)
 const q = (s) => `"${s}"`;
-const COMMAND = buildCommand(argNode || process.execPath, path.join(APP_DIR, 'hooks', 'emit.js'), argPort);
+// --node 가 없으면 업그레이드에 안 깨지는 경로 (앱이 복사한 ~/.ai-office/node > Homebrew opt 링크 > 실행 중인 Node)
+const COMMAND = buildCommand(argNode || stableNodePath(), path.join(APP_DIR, 'hooks', 'emit.js'), argPort);
 function buildCommand(nodePath, emitPath, port) { return `${q(nodePath)} ${q(emitPath)}${port && port !== 4777 ? ` --port ${port}` : ''}`; }
 
 function isOurs(h) {