triflux 3.2.0-dev.7 → 3.2.0-dev.9

package/hub/team/dashboard.mjs

@@ -6,15 +6,7 @@
 //   node hub/team/dashboard.mjs --session <세션이름> [--interval 2]
 //   node hub/team/dashboard.mjs --team <팀이름> [--interval 2]
 import { get } from "node:http";
-
-// ── 색상 ──
-const AMBER = "\x1b[38;5;214m";
-const GREEN = "\x1b[38;5;82m";
-const RED = "\x1b[38;5;196m";
-const GRAY = "\x1b[38;5;245m";
-const DIM = "\x1b[2m";
-const BOLD = "\x1b[1m";
-const RESET = "\x1b[0m";
+import { AMBER, GREEN, RED, GRAY, DIM, BOLD, RESET } from "./shared.mjs";
 
 /**
  * HTTP GET JSON

package/hub/team/native.mjs

@@ -8,81 +8,6 @@
 
 const ROUTE_SCRIPT = "~/.claude/scripts/tfx-route.sh";
 
-/**
- * CLI 타입별 teammate 프롬프트 생성
- * @param {'codex'|'gemini'|'claude'} cli — CLI 타입
- * @param {object} opts
- * @param {string} opts.subtask — 서브태스크 설명
- * @param {string} [opts.role] — 역할 (executor, designer, reviewer 등)
- * @param {string} [opts.teamName] — 팀 이름
- * @returns {string} teammate 프롬프트
- */
-export function buildTeammatePrompt(cli, opts = {}) {
-  const { subtask, role = "executor", teamName = "tfx-team" } = opts;
-
-  if (cli === "claude") {
-    return `너는 ${teamName}의 Claude 워커이다.
-
-[작업] ${subtask}
-
-[실행]
-1. TaskList에서 pending 작업을 확인하고 claim (TaskUpdate: in_progress)
-2. Glob, Grep, Read, Bash 등 도구로 직접 수행
-3. 완료 시 TaskUpdate(status: completed) + SendMessage로 리드에게 보고
-4. 추가 작업이 있으면 반복
-
-에러 시 TaskUpdate(status: failed) + SendMessage로 보고.`;
-  }
-
-  const label = cli === "codex" ? "Codex" : "Gemini";
-  const escaped = subtask.replace(/'/g, "'\\''");
-
-  return `너는 ${teamName}의 ${label} 워커이다.
-
-[작업] ${subtask}
-
-[실행]
-1. TaskList에서 pending 작업을 확인하고 claim (TaskUpdate: in_progress)
-2. Bash("bash ${ROUTE_SCRIPT} ${role} '${escaped}' auto")로 실행
-3. 결과 확인 후 TaskUpdate(status: completed) + SendMessage로 리드에게 보고
-4. 추가 pending 작업이 있으면 반복
-
-[규칙]
-- 실제 구현은 ${label} CLI가 수행 — 너는 실행+보고 역할
-- 에러 시 TaskUpdate(status: failed) + SendMessage로 보고`;
-}
-
-/**
- * teammate 이름 생성
- * @param {'codex'|'gemini'|'claude'} cli
- * @param {number} index — 0-based
- * @returns {string}
- */
-export function buildTeammateName(cli, index) {
-  return `${cli}-worker-${index + 1}`;
-}
-
-/**
- * 트리아지 결과에서 팀 멤버 설정 생성
- * @param {string} teamName — 팀 이름
- * @param {Array<{cli: string, subtask: string, role?: string}>} assignments
- * @returns {{ name: string, members: Array<{name: string, cli: string, prompt: string}> }}
- */
-export function buildTeamConfig(teamName, assignments) {
-  return {
-    name: teamName,
-    members: assignments.map((a, i) => ({
-      name: buildTeammateName(a.cli, i),
-      cli: a.cli,
-      prompt: buildTeammatePrompt(a.cli, {
-        subtask: a.subtask,
-        role: a.role || "executor",
-        teamName,
-      }),
-    })),
-  };
-}
-
 /**
  * v2.2 슬림 래퍼 프롬프트 생성
  * Agent spawn으로 네비게이션에 등록하되, 실제 작업은 tfx-route.sh가 수행.
@@ -113,12 +38,17 @@ export function buildSlimWrapperPrompt(cli, opts = {}) {
   // 셸 이스케이프
   const escaped = subtask.replace(/'/g, "'\\''");
 
-  return `Bash 1회 실행 후 종료.
+  return `Bash 1회 실행 후 반드시 종료하라. 어떤 경우에도 hang하지 마라.
+gemini/codex를 직접 호출하지 마라. 반드시 tfx-route.sh를 거쳐야 한다.
+프롬프트를 파일로 저장하지 마라. tfx-route.sh가 인자로 받는다.
+
+TFX_TEAM_NAME="${teamName}" TFX_TEAM_TASK_ID="${taskId}" TFX_TEAM_AGENT_NAME="${agentName}" TFX_TEAM_LEAD_NAME="${leadName}" bash ${ROUTE_SCRIPT} "${role}" '${escaped}' ${mcp_profile}
 
-TFX_TEAM_NAME=${teamName} TFX_TEAM_TASK_ID=${taskId} TFX_TEAM_AGENT_NAME=${agentName} TFX_TEAM_LEAD_NAME=${leadName} bash ${ROUTE_SCRIPT} ${role} '${escaped}' ${mcp_profile}
+성공 → TaskUpdate(status: completed, metadata: {result: "success"}) + SendMessage(to: ${leadName}).
+실패 → TaskUpdate(status: completed, metadata: {result: "failed", error: "에러 요약"}) + SendMessage(to: ${leadName}).
 
-완료 → TaskUpdate(status: completed) + SendMessage(to: ${leadName}).
-실패 → TaskUpdate(status: failed) + SendMessage(to: ${leadName}).`;
+중요: TaskUpdate의 status는 "completed"만 사용. "failed"는 API 미지원.
+실패 여부는 metadata.result로 구분. Bash 실패 시에도 반드시 TaskUpdate + SendMessage 후 종료.`;
 }
 
 /**
@@ -126,5 +56,7 @@ TFX_TEAM_NAME=${teamName} TFX_TEAM_TASK_ID=${taskId} TFX_TEAM_AGENT_NAME=${agent
  * @returns {string}
  */
 export function generateTeamName() {
-  return `tfx-${Date.now().toString(36).slice(-6)}`;
+  const ts = Date.now().toString(36).slice(-4);
+  const rand = Math.random().toString(36).slice(2, 6);
+  return `tfx-${ts}${rand}`;
 }

package/hub/team/nativeProxy.mjs

@@ -22,6 +22,14 @@ const CLAUDE_HOME = join(homedir(), '.claude');
 const TEAMS_ROOT = join(CLAUDE_HOME, 'teams');
 const TASKS_ROOT = join(CLAUDE_HOME, 'tasks');
 
+// ── 인메모리 캐시 (디렉토리 mtime 기반 무효화) ──
+const _dirCache = new Map(); // tasksDir → { mtimeMs, files: string[] }
+const _taskIdIndex = new Map(); // taskId → filePath
+
+function _invalidateCache(tasksDir) {
+  _dirCache.delete(tasksDir);
+}
+
 function err(code, message, extra = {}) {
   return { ok: false, error: { code, message, ...extra } };
 }
@@ -44,13 +52,24 @@ function atomicWriteJson(path, value) {
   mkdirSync(dirname(path), { recursive: true });
   const tmp = `${path}.tmp-${process.pid}-${Date.now()}`;
   writeFileSync(tmp, `${JSON.stringify(value, null, 2)}\n`, 'utf8');
-  renameSync(tmp, path);
+  try {
+    renameSync(tmp, path);
+  } catch (e) {
+    // Windows NTFS: 대상 파일 존재 시 rename 실패 가능 → 삭제 후 재시도
+    if (process.platform === 'win32' && (e.code === 'EPERM' || e.code === 'EEXIST')) {
+      try { unlinkSync(path); } catch {}
+      renameSync(tmp, path);
+    } else {
+      try { unlinkSync(tmp); } catch {}
+      throw e;
+    }
+  }
 }
 
-function sleepMs(ms) {
-  // busy-wait를 피하고 Atomics.wait로 동기 대기 (CPU 점유 최소화)
-  Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
-}
+function sleepMs(ms) {
+  // busy-wait를 피하고 Atomics.wait로 동기 대기 (CPU 점유 최소화)
+  Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
+}
 
 function withFileLock(lockPath, fn, retries = 20, delayMs = 25) {
   let fd = null;
@@ -114,22 +133,46 @@ export function resolveTeamPaths(teamName) {
 
 function collectTaskFiles(tasksDir) {
   if (!existsSync(tasksDir)) return [];
-  return readdirSync(tasksDir)
+
+  // 디렉토리 mtime 기반 캐시 — O(N) I/O를 반복 호출 시 O(1)로 축소
+  let dirMtime;
+  try { dirMtime = statSync(tasksDir).mtimeMs; } catch { return []; }
+
+  const cached = _dirCache.get(tasksDir);
+  if (cached && cached.mtimeMs === dirMtime) {
+    return cached.files;
+  }
+
+  const files = readdirSync(tasksDir)
     .filter((name) => name.endsWith('.json'))
     .filter((name) => !name.endsWith('.lock'))
     .filter((name) => name !== '.highwatermark')
     .map((name) => join(tasksDir, name));
+
+  _dirCache.set(tasksDir, { mtimeMs: dirMtime, files });
+  return files;
 }
 
 function locateTaskFile(tasksDir, taskId) {
   const direct = join(tasksDir, `${taskId}.json`);
   if (existsSync(direct)) return direct;
 
+  // ID→파일 인덱스 캐시
+  const indexed = _taskIdIndex.get(taskId);
+  if (indexed && existsSync(indexed)) return indexed;
+
+  // 캐시된 collectTaskFiles로 풀 스캔
   const files = collectTaskFiles(tasksDir);
   for (const file of files) {
-    if (basename(file, '.json') === taskId) return file;
+    if (basename(file, '.json') === taskId) {
+      _taskIdIndex.set(taskId, file);
+      return file;
+    }
     const json = readJsonSafe(file);
-    if (json && String(json.id || '') === taskId) return file;
+    if (json && String(json.id || '') === taskId) {
+      _taskIdIndex.set(taskId, file);
+      return file;
+    }
   }
   return null;
 }
@@ -242,7 +285,21 @@ export function teamTaskList(args = {}) {
   };
 }
 
+// status 화이트리스트 (Claude Code API 호환)
+const VALID_STATUSES = new Set(['pending', 'in_progress', 'completed', 'deleted']);
+
 export function teamTaskUpdate(args = {}) {
+  // "failed" → "completed" + metadata.result 자동 매핑
+  if (String(args.status || '') === 'failed') {
+    args = {
+      ...args,
+      status: 'completed',
+      metadata_patch: { ...(args.metadata_patch || {}), result: 'failed' },
+    };
+  } else if (args.status != null && !VALID_STATUSES.has(String(args.status))) {
+    return err('INVALID_STATUS', `유효하지 않은 status: ${args.status}. 허용: ${[...VALID_STATUSES].join(', ')}`);
+  }
+
   const {
     team_name,
     task_id,
@@ -369,6 +426,7 @@ export function teamTaskUpdate(args = {}) {
 
       if (updated) {
         atomicWriteJson(taskFile, after);
+        _invalidateCache(dirname(taskFile));
       }
 
       let afterMtime = beforeMtime;
@@ -419,42 +477,58 @@ export function teamSendMessage(args = {}) {
     return err('TEAM_NOT_FOUND', `팀 디렉토리가 없습니다: ${paths.team_dir}`);
   }
 
-  const recipient = sanitizeRecipientName(to);
-  const inboxFile = join(paths.inboxes_dir, `${recipient}.json`);
-  const lockFile = `${inboxFile}.lock`;
-  let message;
-
-  try {
-    const unreadCount = withFileLock(lockFile, () => {
-      const queue = readJsonSafe(inboxFile);
-      const list = Array.isArray(queue) ? queue : [];
-
-      message = {
-        id: randomUUID(),
-        from: String(from),
-        text: String(text),
-        ...(summary ? { summary: String(summary) } : {}),
-        timestamp: new Date().toISOString(),
-        color: String(color || 'blue'),
-        read: false,
-      };
-      list.push(message);
-      atomicWriteJson(inboxFile, list);
-
-      return list.filter((m) => m?.read !== true).length;
-    });
-
-    return {
-      ok: true,
-      data: {
-        message_id: message.id,
-        recipient,
-        inbox_file: inboxFile,
-        queued_at: message.timestamp,
-        unread_count: unreadCount,
-      },
-    };
-  } catch (e) {
-    return err('SEND_MESSAGE_FAILED', e.message);
-  }
-}
+  const recipient = sanitizeRecipientName(to);
+  const inboxFile = join(paths.inboxes_dir, `${recipient}.json`);
+  const lockFile = `${inboxFile}.lock`;
+  let message;
+
+  try {
+    const unreadCount = withFileLock(lockFile, () => {
+      const queue = readJsonSafe(inboxFile);
+      const list = Array.isArray(queue) ? queue : [];
+
+      message = {
+        id: randomUUID(),
+        from: String(from),
+        text: String(text),
+        ...(summary ? { summary: String(summary) } : {}),
+        timestamp: new Date().toISOString(),
+        color: String(color || 'blue'),
+        read: false,
+      };
+      list.push(message);
+
+      // inbox 정리: 최대 200개 유지, read + 1시간 경과 메시지 제거
+      const MAX_INBOX = 200;
+      if (list.length > MAX_INBOX) {
+        const ONE_HOUR_MS = 3600000;
+        const cutoff = Date.now() - ONE_HOUR_MS;
+        const pruned = list.filter((m) =>
+          m?.read !== true || !m?.timestamp || new Date(m.timestamp).getTime() > cutoff
+        );
+        list.length = 0;
+        list.push(...pruned);
+        if (list.length > MAX_INBOX) {
+          list.splice(0, list.length - MAX_INBOX);
+        }
+      }
+
+      atomicWriteJson(inboxFile, list);
+
+      return list.filter((m) => m?.read !== true).length;
+    });
+
+    return {
+      ok: true,
+      data: {
+        message_id: message.id,
+        recipient,
+        inbox_file: inboxFile,
+        queued_at: message.timestamp,
+        unread_count: unreadCount,
+      },
+    };
+  } catch (e) {
+    return err('SEND_MESSAGE_FAILED', e.message);
+  }
+}

package/hub/team/pane.mjs

@@ -1,21 +1,34 @@
 // hub/team/pane.mjs — pane별 CLI 실행 + stdin 주입
 // 의존성: child_process, fs, os, path (Node.js 내장)만 사용
-import { writeFileSync, unlinkSync, mkdirSync } from "node:fs";
-import { join } from "node:path";
-import { tmpdir } from "node:os";
-import { detectMultiplexer, tmuxExec } from "./session.mjs";
-
-/** Windows 경로를 MSYS2/Git Bash tmux용 POSIX 경로로 변환 */
-function toTmuxPath(p) {
+import { writeFileSync, unlinkSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { detectMultiplexer, tmuxExec } from "./session.mjs";
+import { psmuxExec } from "./psmux.mjs";
+
+function quoteArg(value) {
+  return `"${String(value).replace(/"/g, '\\"')}"`;
+}
+
+function getPsmuxSessionName(target) {
+  return String(target).split(":")[0]?.trim() || "";
+}
+
+/** Windows 경로를 멀티플렉서용 경로로 변환 */
+function toMuxPath(p) {
   if (process.platform !== "win32") return p;
 
+  const mux = detectMultiplexer();
+
+  // psmux는 Windows 네이티브 경로 그대로 사용
+  if (mux === "psmux") return p;
+
   const normalized = p.replace(/\\/g, "/");
   const m = normalized.match(/^([A-Za-z]):\/(.*)$/);
   if (!m) return normalized;
 
   const drive = m[1].toLowerCase();
   const rest = m[2];
-  const mux = detectMultiplexer();
 
   // wsl tmux는 /mnt/c/... 경로를 사용
   if (mux === "wsl-tmux") {
@@ -26,12 +39,13 @@ function toTmuxPath(p) {
   return `/${drive}/${rest}`;
 }
 
-/** tmux 커맨드 실행 (session.mjs와 동일 패턴) */
-function tmux(args, opts = {}) {
-  return tmuxExec(args, {
-    encoding: "utf8",
-    timeout: 10000,
-    stdio: ["pipe", "pipe", "pipe"],
+/** 멀티플렉서 커맨드 실행 (session.mjs와 동일 패턴) */
+function muxExec(args, opts = {}) {
+  const exec = detectMultiplexer() === "psmux" ? psmuxExec : tmuxExec;
+  return exec(args, {
+    encoding: "utf8",
+    timeout: 10000,
+    stdio: ["pipe", "pipe", "pipe"],
     ...opts,
   });
 }
@@ -39,18 +53,18 @@ function tmux(args, opts = {}) {
 /**
  * CLI 에이전트 시작 커맨드 생성
  * @param {'codex'|'gemini'|'claude'} cli
- * @param {{ trustMode?: boolean }} [options]
- * @returns {string} 실행할 셸 커맨드
- */
-export function buildCliCommand(cli, options = {}) {
-  const { trustMode = false } = options;
-
-  switch (cli) {
-    case "codex":
-      // trust 모드에서는 승인/샌드박스 우회 + alt-screen 비활성화
-      return trustMode
-        ? "codex --dangerously-bypass-approvals-and-sandbox --no-alt-screen"
-        : "codex";
+ * @param {{ trustMode?: boolean }} [options]
+ * @returns {string} 실행할 셸 커맨드
+ */
+export function buildCliCommand(cli, options = {}) {
+  const { trustMode = false } = options;
+
+  switch (cli) {
+    case "codex":
+      // trust 모드에서는 승인/샌드박스 우회 + alt-screen 비활성화
+      return trustMode
+        ? "codex --dangerously-bypass-approvals-and-sandbox --no-alt-screen"
+        : "codex";
     case "gemini":
       // interactive 모드 — MCP는 ~/.gemini/settings.json에 사전 등록
       return "gemini";
@@ -63,15 +77,14 @@ export function buildCliCommand(cli, options = {}) {
 }
 
 /**
- * tmux pane에 CLI 시작
+ * pane에 CLI 시작
  * @param {string} target — 예: tfx-team-abc:0.1
  * @param {string} command — 실행할 커맨드
  */
-export function startCliInPane(target, command) {
-  // 특수문자 이스케이프: 작은따옴표 내부에서 안전하도록
-  const escaped = command.replace(/'/g, "'\\''");
-  tmux(`send-keys -t ${target} '${escaped}' Enter`);
-}
+export function startCliInPane(target, command) {
+  // CLI 시작도 buffer paste를 재사용해 셸/플랫폼별 quoting 차이를 제거한다.
+  injectPrompt(target, command);
+}
 
 /**
  * pane에 프롬프트 주입 (load-buffer + paste-buffer 방식)
@@ -88,14 +101,24 @@ export function injectPrompt(target, prompt) {
   const safeTarget = target.replace(/[:.]/g, "-");
   const tmpFile = join(tmpDir, `prompt-${safeTarget}-${Date.now()}.txt`);
 
-  try {
-    writeFileSync(tmpFile, prompt, "utf8");
-
-    // tmux load-buffer → paste-buffer → Enter (Windows 경로 변환 필요)
-    tmux(`load-buffer ${toTmuxPath(tmpFile)}`);
-    tmux(`paste-buffer -t ${target}`);
-    tmux(`send-keys -t ${target} Enter`);
-  } finally {
+  try {
+    writeFileSync(tmpFile, prompt, "utf8");
+
+    // psmux는 buffer 명령에 세션 컨텍스트가 필요하다.
+    if (detectMultiplexer() === "psmux") {
+      const sessionName = getPsmuxSessionName(target);
+      psmuxExec(["load-buffer", "-t", sessionName, toMuxPath(tmpFile)]);
+      psmuxExec(["select-pane", "-t", target]);
+      psmuxExec(["paste-buffer", "-t", target]);
+      psmuxExec(["send-keys", "-t", target, "Enter"]);
+      return;
+    }
+
+    // tmux load-buffer → paste-buffer → Enter
+    muxExec(`load-buffer ${quoteArg(toMuxPath(tmpFile))}`);
+    muxExec(`paste-buffer -t ${target}`);
+    muxExec(`send-keys -t ${target} Enter`);
+  } finally {
     // 임시 파일 정리
     try {
       unlinkSync(tmpFile);
@@ -110,6 +133,6 @@ export function injectPrompt(target, prompt) {
  * @param {string} target — 예: tfx-team-abc:0.1
  * @param {string} keys — tmux 키 표현 (예: 'C-c', 'Enter')
  */
-export function sendKeys(target, keys) {
-  tmux(`send-keys -t ${target} ${keys}`);
-}
+export function sendKeys(target, keys) {
+  muxExec(`send-keys -t ${target} ${keys}`);
+}