coxpit 3.2.0 → 3.2.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "coxpit",
-  "version": "3.2.0",
+  "version": "3.2.2",
   "description": "Self-hosted cockpit for running a fleet of AI coding agents across your own machines — parallel worktree runs, live board, compare & merge, web terminal, design capture.",
   "type": "module",
   "license": "MIT",
@@ -44,9 +44,9 @@
   "dependencies": {
     "@fastify/websocket": "^11",
     "@libsql/client": "^0.14",
-    "@xterm/addon-fit": "^0.11.0",
-    "@xterm/addon-unicode11": "^0.9.0",
-    "@xterm/xterm": "^6.0.0",
+    "@xterm/addon-fit": "^0.10.0",
+    "@xterm/addon-unicode11": "^0.8.0",
+    "@xterm/xterm": "^5.5.0",
     "dotenv": "^16",
     "drizzle-orm": "^0.38",
     "fastify": "^5",

package/src/config.ts

@@ -14,8 +14,20 @@ import 'dotenv/config';
   process.env.PATH = cur.join(':');
 }
 
+// launchd/systemd 데몬은 LANG 미설정(C 로케일)로 뜬다 — 그 상태로 tmux 에 attach 하면
+// tmux 가 클라이언트를 UTF-8 불가로 판단해 CJK(한글 등)를 '_'/8진수로 뭉갠다.
+// UTF-8 로케일을 부팅 시 1회 보장한다 (COXPIT_LANG 으로 재정의 가능).
+{
+  const want = process.env.COXPIT_LANG
+    ?? (/utf-?8/i.test(process.env.LANG ?? '') ? process.env.LANG! : 'en_US.UTF-8');
+  process.env.LANG = want;
+  if (process.env.LC_ALL && !/utf-?8/i.test(process.env.LC_ALL)) delete process.env.LC_ALL;
+}
+
 /** 런타임 설정. 시크릿은 전부 env 주입(번들 0). */
 export const config = {
+  // UTF-8 보장된 로케일 — PTY/원격 셸에 명시 전달용
+  lang: process.env.LANG!,
   host: process.env.COXPIT_HOST ?? '127.0.0.1',
   port: Number(process.env.COXPIT_PORT ?? 8210),
   dbPath: process.env.COXPIT_DB ?? './coxpit.db',

package/src/index.ts

@@ -1,6 +1,7 @@
 import { config } from './config';
 import { db, ensureSchema } from './db';
 import { machines } from './db/schema';
+import { reconcileOrphanRuns } from './orchestrator';
 import { buildServer } from './server';
 
 await ensureSchema();
@@ -10,5 +11,9 @@ if ((await db.select().from(machines)).length === 0) {
   await db.insert(machines).values({ slug: 'local', name: 'This machine', kind: 'local', online: true });
 }
 
+// 재시작으로 고아가 된 running run 정산(카드가 영원히 '진행 중'으로 남는 것 방지).
+const orphans = await reconcileOrphanRuns();
+if (orphans > 0) console.log(`[coxpit] settled ${orphans} orphaned run(s) from a previous daemon instance`);
+
 const app = await buildServer();
 await app.listen({ host: config.host, port: config.port });

package/src/orchestrator.ts

@@ -122,9 +122,10 @@ export async function launchRun(runId: number, real?: boolean): Promise<void> {
       return;
     }
 
-    // 2) tmux 창(사람이 attach 해 개입할 수 있게) — best-effort. 동명 잔재는 선제 정리('=' 정확 일치)
+    // 2) tmux 창(사람이 attach 해 개입할 수 있게) — best-effort. 동명 잔재는 선제 정리('=' 정확 일치).
+    // export LANG: 이 명령이 tmux 서버를 처음 띄우는 경우(특히 원격) C 로케일로 뜨면 CJK 가 깨진다.
     await runShellOn(ctx.machine,
-      `tmux kill-session -t ${shq('=' + session)} 2>/dev/null; tmux new-session -d -s ${shq(session)} -c ${shq(wtPath)} 2>/dev/null || true`, 8000);
+      `export LANG=${shq(config.lang)}; tmux kill-session -t ${shq('=' + session)} 2>/dev/null; tmux new-session -d -s ${shq(session)} -c ${shq(wtPath)} 2>/dev/null || true`, 8000);
 
     await setRun(runId, { status: 'running' });
     await recordEvent(runId, 'meta', JSON.stringify({ branch, worktree: wtPath, real: useReal }));
@@ -294,7 +295,17 @@ export async function getRunTermInfo(runId: number): Promise<{ machine: MachineT
  */
 export async function stopRun(runId: number): Promise<{ ok: boolean; detail: string }> {
   const child = liveChildren.get(runId);
-  if (!child) return { ok: false, detail: 'not running' };
+  if (!child) {
+    // 데몬 재시작 등으로 고아가 된 좀비 run — 프로세스는 없는데 DB 만 running.
+    // stop 요청을 정산으로 처리해 카드가 영원히 '진행 중'으로 남지 않게 한다.
+    const zr = (await db.select().from(agentRuns).where(eq(agentRuns.id, runId)).limit(1))[0];
+    if (zr && (zr.status === 'running' || zr.status === 'starting')) {
+      await setRun(runId, { status: 'stopped', endedAt: new Date(), exitSummary: 'orphaned (daemon restarted) — settled by stop' });
+      await recordEvent(runId, 'meta', JSON.stringify({ orphanSettled: true }));
+      return { ok: true, detail: 'no live process — settled as stopped' };
+    }
+    return { ok: false, detail: 'not running' };
+  }
   stoppedRuns.add(runId);
 
   // 원격이면 먼저 원격 프로세스를 pid 파일로 죽인다(ssh 채널만 끊으면 잔존 가능).
@@ -444,8 +455,9 @@ export async function openWorkbench(repoId: number, title: string): Promise<{
 
   const prep = await runShellOn(
     machine,
-    // 동명 세션 잔재(DB 리셋 등으로 run id 재사용) 선제 정리 — '=' 정확 일치만
-    `mkdir -p ${shq(wtParent)} && git -C ${shq(repo.path)} worktree add -b ${shq(branch)} ${shq(wtPath)} ${shq(repo.defaultBranch)}` +
+    // 동명 세션 잔재(DB 리셋 등으로 run id 재사용) 선제 정리 — '=' 정확 일치만.
+    // export LANG: tmux 서버 첫 기동이 C 로케일이면 세션 셸의 CJK 입력·표시가 깨진다.
+    `export LANG=${shq(config.lang)}; mkdir -p ${shq(wtParent)} && git -C ${shq(repo.path)} worktree add -b ${shq(branch)} ${shq(wtPath)} ${shq(repo.defaultBranch)}` +
     ` && { tmux kill-session -t ${shq('=' + session)} 2>/dev/null || true; }` +
     ` && tmux new-session -d -s ${shq(session)} -c ${shq(wtPath)}`,
     20000,
@@ -717,6 +729,21 @@ export async function prRun(runId: number): Promise<{ ok: boolean; detail: strin
 /**
  * worktree/브랜치/tmux 정리(태스크 종료·run 폐기 시).
  */
+/**
+ * 부팅 정산 — 데몬 재시작 후 살아있는 자식이 있을 수 없는데 DB 가 running/starting 인
+ * run(고아)을 failed 로 정리한다. workbench('open')는 에이전트가 없으므로 대상 아님.
+ */
+export async function reconcileOrphanRuns(): Promise<number> {
+  const stale = (await db.select().from(agentRuns)).filter(
+    (r) => r.status === 'running' || r.status === 'starting',
+  );
+  for (const r of stale) {
+    await setRun(r.id, { status: 'failed', endedAt: new Date(), exitSummary: 'orphaned by daemon restart' });
+    await recordEvent(r.id, 'error', 'daemon restarted while this run was live — settled as failed (worktree/branch preserved; diff still reviewable)');
+  }
+  return stale.length;
+}
+
 export async function cleanupRun(runId: number): Promise<{ ok: boolean; detail: string }> {
   const ctx = await loadContext(runId);
   const rr = await db.select().from(agentRuns).where(eq(agentRuns.id, runId)).limit(1);

package/src/server.ts

@@ -33,7 +33,7 @@ export async function buildServer(): Promise<FastifyInstance> {
   app.addHook('onRequest', authGate);
 
   // 무인증 헬스(외부 감시용)
-  app.get('/api/health', async () => ({ ok: true, name: 'coxpit', version: '3.2.0' }));
+  app.get('/api/health', async () => ({ ok: true, name: 'coxpit', version: '3.2.2' }));
 
   // 플릿 보드(단일 페이지). 인증 게이트 적용됨.
   app.get('/', async (_req, reply) => reply.type('text/html').send(BOARD_HTML));
@@ -502,7 +502,7 @@ export async function buildServer(): Promise<FastifyInstance> {
   // 라이브 스트림 좌석 — 오케스트레이터가 run/event 를 여기로 broadcast.
   app.get('/ws', { websocket: true }, (socket) => {
     addSink(socket);
-    socket.send(JSON.stringify({ type: 'hello', name: 'coxpit-fleet', version: '3.2.0' }));
+    socket.send(JSON.stringify({ type: 'hello', name: 'coxpit-fleet', version: '3.2.2' }));
     socket.on('close', () => removeSink(socket));
   });
 
@@ -536,7 +536,7 @@ export async function buildServer(): Promise<FastifyInstance> {
       const rr = await db.select().from(agentRuns).where(eq(agentRuns.id, id)).limit(1);
       const wt = rr[0]?.worktreePath ?? '';
       const revive = wt
-        ? await runShellOn(info.machine, `test -d ${shq(wt)} && tmux new-session -d -s ${shq(info.session)} -c ${shq(wt)}`, 10000)
+        ? await runShellOn(info.machine, `export LANG=${shq(config.lang)}; test -d ${shq(wt)} && tmux new-session -d -s ${shq(info.session)} -c ${shq(wt)}`, 10000)
         : { ok: false } as { ok: boolean };
       if (!revive.ok) {
         socket.send(JSON.stringify({ t: 'err', d: `tmux session '${info.session}' gone and could not be revived (worktree missing?)` }));

package/src/term.ts

@@ -41,7 +41,8 @@ export function openTerm(m: MachineTarget, session: string, cols: number, rows:
     name: 'xterm-256color',
     cols: Math.max(20, Math.min(500, cols || 80)),
     rows: Math.max(5, Math.min(200, rows || 24)),
-    env: { ...process.env, TERM: 'xterm-256color' } as Record<string, string>,
+    // LANG: C 로케일 클라이언트로 attach 하면 tmux 가 CJK 를 '_' 로 뭉갠다 (config 에서 UTF-8 보장)
+    env: { ...process.env, TERM: 'xterm-256color', LANG: config.lang } as Record<string, string>,
   };
   if (isLocal(m)) {
     return pty().spawn('tmux', ['attach-session', '-t', '=' + session], opts);
@@ -55,6 +56,7 @@ export function openTerm(m: MachineTarget, session: string, cols: number, rows:
   if (config.sshKey) args.push('-i', config.sshKey);
   const target = m.sshUser ? `${m.sshUser}@${m.address}` : m.address;
   // 세션명은 우리가 만든 coxpit-rN 형식이라 셸 주입 여지 없음 — 그래도 인용.
-  args.push(target, `tmux attach-session -t '=${session.replace(/'/g, "'\\''")}'`);
+  // 원격도 UTF-8 로케일 명시 (비대화 ssh 는 LANG 미설정이 보통)
+  args.push(target, `export LANG='${config.lang.replace(/'/g, '')}'; tmux attach-session -t '=${session.replace(/'/g, "'\\''")}'`);
   return pty().spawn('ssh', args, opts);
 }